Struct AgentBuilder 

pub struct AgentBuilder { /* private fields */ }

Implementations

impl AgentBuilder

pub fn provider(self, p: impl Provider + 'static) -> Self

pub fn provider_boxed(self, p: Box<dyn Provider>) -> Self

Accept a pre-boxed provider. Useful when the caller already has a Box<dyn Provider> (e.g., the delegation primitive, which builds child providers via a factory closure).

pub fn tool(self, t: impl Tool + 'static) -> Self

pub fn tools(self, ts: Vec<Box<dyn Tool>>) -> Self

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

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

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

pub fn max_turns(self, n: u32) -> Self

pub fn max_tokens(self, n: u32) -> Self

pub fn temperature(self, t: f32) -> Self

pub fn thinking_budget(self, tokens: u32) -> Self

pub fn working_dir(self, p: impl Into<PathBuf>) -> Self

pub fn permission_policy(self, p: impl PermissionPolicy + 'static) -> Self

pub fn memory(self, m: impl Memory + 'static) -> Self

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

pub fn hook(self, h: impl Hook + 'static) -> Self

pub fn mcp_server(self, config: McpServerConfig) -> Self

pub fn on_event(self, f: impl Fn(&AgentEvent) + Send + Sync + 'static) -> Self

pub fn enable_broadcast(self, capacity: usize) -> Self

pub fn reporter(self, r: impl Reporter + 'static) -> Self

pub fn event_filter( self, f: impl Fn(&AgentEvent) -> bool + Send + Sync + 'static, ) -> Self

pub fn cancel_token(self, token: CancellationToken) -> Self

pub fn auto_compact(self, enabled: bool) -> Self

pub fn compact_threshold(self, threshold: f64) -> Self

pub fn tool_result_budget(self, chars: usize) -> Self

pub fn turns_elapsed_cadence(self, n: u32) -> Self

Set the tool-output compression level (default Off). Compression is applied to each tool result before the per-result cap and the overall tool-result budget run. How often HookEvent::TurnsElapsed fires (default 10). Set to 0 to disable. Used by skill-nudge hooks for agent-curated skill review.

pub fn compression_level(self, level: CompressionLevel) -> Self

pub fn with_messages(self, msgs: Vec<Message>) -> Self

Pre-populate conversation history (for provider switching mid-session).

pub fn benchmark_mode(self, enabled: bool) -> Self

Enable benchmark mode (self-verification loop for terminal-bench).

pub fn build(self) -> Result<Agent>

pub async fn run_with(self, prompt: &str) -> Result<AgentOutput>

Build + run in one shot.

Trait Implementations

impl Default for AgentBuilder

fn default() -> Self

Returns the “default value” for a type.