Struct AgentBuilder 

pub struct AgentBuilder { /* private fields */ }

Implementations

impl AgentBuilder

pub fn new(client: Arc<dyn LlmProvider>) -> Self

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

pub fn enable_thought(self, enable: bool) -> Self

pub fn reasoning(self, config: ReasoningConfig) -> Self

pub fn enable_thinking(self, enable: bool) -> Self

pub fn thinking_budget(self, budget: u64) -> Self

pub fn tool_timeout(self, timeout_ms: u64) -> Self

pub fn max_tool_output_chars(self, max_chars: usize) -> Self

pub fn max_sessions(self, max: usize) -> Self

pub fn max_turns_per_session(self, max: usize) -> Self

pub fn execution_max_turns(self, max: u32) -> Self

pub fn max_message_tokens(self, max: usize) -> Self

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

pub fn register_tool_arc(self, tool: Arc<dyn Tool>) -> Self

pub fn approval_handler(self, handler: Arc<dyn ApprovalHandler>) -> Self

pub fn tool_policy(self, policy: Arc<dyn ToolPolicy>) -> Self

pub fn middleware(self, mw: impl Middleware + 'static) -> Self

pub fn guard(self, guard: impl ReactLoopGuard + 'static) -> Self

pub fn context_window(self, max_tokens: usize) -> Self

pub fn context_window_manager(self, manager: ContextWindowManager) -> Self

pub fn response_format(self, format: ResponseFormat) -> Self

pub fn llm_retry(self, retry: RetryConfig) -> Self

pub fn session_store(self, store: Arc<dyn SessionStore>) -> Self

pub fn error_recovery(self, recovery: Arc<dyn ToolErrorRecovery>) -> Self

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

pub fn language(self, language: Language) -> Self

pub fn context_compactor(self, compactor: Arc<dyn ContextCompaction>) -> Self

Set an inline context compactor for the react loop.

When set, the react loop will check token count after each tool turn and compact the session if it exceeds the configured threshold.

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

pub fn session_id_generator( self, generator: Arc<dyn SessionIdGenerator>, ) -> Self

pub fn apply_if<T>( self, value: Option<T>, f: impl FnOnce(Self, T) -> Self, ) -> Self

Conditionally apply a transformation when value is Some.

This is a convenience for option-chaining builder patterns:

builder.apply_if(args.thinking_budget, |b, budget| b.thinking_budget(budget))

pub fn agent_instructions_paths(self, paths: Vec<PathBuf>) -> Self

Set paths to agent instruction files (e.g., CLAUDE.md, INSTRUCTIONS.md).

These files are read at build time and appended to the system prompt. Supports multiple paths (user-level + project-level); later entries have higher priority and appear first in the prompt.

Example:

use std::path::PathBuf;
use agent_works::AgentBuilder;
let builder = AgentBuilder::new();
let builder = builder.agent_instructions_paths(vec![
    PathBuf::from("~/.claude/CLAUDE.md"),  // user-level
    PathBuf::from(".claude/CLAUDE.md"),     // project-level
]);

pub fn build(self) -> AgentResult<AgentRuntime>