Agent Providers¶

CIAB supports multiple coding agent providers through the AgentProvider trait. Each provider knows how to install, start, communicate with, and parse output from a specific coding agent.

Available Providers¶

Provider	Agent	Status
`claude-code`	Claude Code	Supported
`codex`	OpenAI Codex CLI	Supported
`gemini`	Gemini CLI	Supported
`cursor`	Cursor CLI	Supported

AgentProvider Trait¶

All providers implement this trait:

pub trait AgentProvider: Send + Sync {
    /// Provider name (e.g., "claude-code")
    fn name(&self) -> &str;

    /// Base container image
    fn base_image(&self) -> &str;

    /// Commands to install the agent in the container
    fn install_commands(&self) -> Vec<String>;

    /// Build the command to start the agent
    fn build_start_command(&self, config: &AgentConfig) -> AgentCommand;

    /// Environment variables required by this agent
    fn required_env_vars(&self) -> Vec<String>;

    /// Parse raw agent output into StreamEvents
    fn parse_output(&self, sandbox_id: &Uuid, raw: &str) -> Vec<StreamEvent>;

    /// Validate agent-specific configuration
    fn validate_config(&self, config: &AgentConfig) -> CiabResult<()>;

    /// Send a message and stream the response
    async fn send_message(
        &self,
        sandbox_id: &Uuid,
        session_id: &Uuid,
        message: &Message,
        tx: &mpsc::Sender<StreamEvent>,
    ) -> CiabResult<()>;

    /// Interrupt the agent
    async fn interrupt(&self, sandbox_id: &Uuid) -> CiabResult<()>;

    /// Check agent health
    async fn health_check(&self, sandbox_id: &Uuid) -> CiabResult<AgentHealth>;
}

How Providers Work¶

During provisioning, the pipeline calls install_commands() to install the agent in the container
After installation, build_start_command() generates the command to launch the agent process
During chat, send_message() forwards user messages and streams responses via the tx channel
The parse_output() method converts raw agent output (often JSON) into typed StreamEvents
health_check() verifies the agent process is running and responsive

Adding a Custom Provider¶

See Custom Provider for a step-by-step guide.