Struct ClaudeCodeDriverBuilder 

pub struct ClaudeCodeDriverBuilder { /* private fields */ }

Fluent configuration for ClaudeCodeDriver.

use cap_rs::driver::stream_json::ClaudeCodeDriver;

// Persistent multi-turn session (default).
let chat = ClaudeCodeDriver::builder("/path/to/workspace").spawn().await?;

// One-shot, with a specific model.
let oneshot = ClaudeCodeDriver::builder(".")
    .model("claude-opus-4-7")
    .replay_user_messages(false)
    .spawn()
    .await?;

// Resume an earlier session.
let resumed = ClaudeCodeDriver::builder(".")
    .resume("00000000-0000-0000-0000-deadbeefcafe")
    .spawn()
    .await?;

Implementations

impl ClaudeCodeDriverBuilder

pub fn bin(self, bin: impl Into<String>) -> Self

Override the binary used (default: claude on PATH, or $CLAUDE_BIN).

pub fn model(self, model: impl Into<String>) -> Self

Override the model (default: claude’s own default).

pub fn session_id(self, uuid: impl Into<String>) -> Self

Use a specific session UUID for this session (must be a valid UUID per claude’s --session-id requirements). If unset, claude generates one and reports it in the Ready event.

pub fn resume(self, uuid: impl Into<String>) -> Self

Resume a previously persisted conversation by session UUID. Pass the session_id you got from a prior session’s Ready event.

pub fn replay_user_messages(self, on: bool) -> Self

Whether to start in persistent session mode (default: true).

When true, claude stays alive after each turn waiting for more user messages — this is what enables real-time multi-turn conversation in a single process. When false, claude reads one prompt, responds, and exits (one-shot, lower latency to first answer but no follow-ups in the same process).

Implementation note: this maps directly to claude’s --replay-user-messages flag.

pub fn dangerously_skip_permissions(self, on: bool) -> Self

Whether to pass --dangerously-skip-permissions (default: true). When false, claude will prompt for permission on tool calls; the driver currently has no way to route those prompts back through CAP — set this to false only if you don’t care about auto-approving (or you trust the agent to deny dangerous ops).

pub async fn spawn(self) -> Result<ClaudeCodeDriver, DriverError>

Spawn the configured Claude Code session.

Trait Implementations

impl Clone for ClaudeCodeDriverBuilder

fn clone(&self) -> ClaudeCodeDriverBuilder

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ClaudeCodeDriverBuilder

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.