Struct AgentBuilder 

pub struct AgentBuilder { /* private fields */ }

Builder for constructing an Agent with a fluent API.

Example

use traitclaw_core::prelude::*;
use traitclaw_core::agent_builder::AgentBuilder;

// Minimal agent (provider required):
// let agent = AgentBuilder::new()
//     .provider(my_provider)
//     .system("You are helpful")
//     .build()?;

Implementations

impl AgentBuilder

pub fn new() -> AgentBuilder

Create a new builder with default configuration.

pub fn provider(self, provider: impl Provider) -> AgentBuilder

Set the LLM provider (required).

Prefer .model() for the idiomatic fluent-API usage. Both methods are equivalent; .model() matches the agent.model() pattern described in the architecture docs.

pub fn provider_arc(self, provider: Arc<dyn Provider>) -> AgentBuilder

Set the LLM provider from a pre-wrapped Arc<dyn Provider>.

Use this when you already hold a shared provider reference (e.g., from AgentFactory).

pub fn model(self, provider: impl Provider) -> AgentBuilder

Set the LLM provider — preferred alias for .provider().

Enables the idiomatic Agent::builder().model(provider).system("...").build() pattern.

pub fn with_retry(self, config: RetryConfig) -> AgentBuilder

Wrap the configured provider with automatic retry and exponential backoff.

Must be called after .provider() or .model(). Uses RetryProvider internally.

pub fn system(self, prompt: impl Into<String>) -> AgentBuilder

Set the system prompt.

pub fn tool(self, tool: impl ErasedTool) -> AgentBuilder

Add a tool to the agent.

pub fn tool_arc(self, tool: Arc<dyn ErasedTool>) -> AgentBuilder

Add a pre-wrapped Arc<dyn ErasedTool> directly.

Use this when you already hold a shared tool instance that you want to attach to multiple agents without cloning the underlying value.

pub fn tools<I, T>(self, tools: I) -> AgentBuilder

where I: IntoIterator<Item = T>, T: ErasedTool,

Add multiple tools at once.

pub fn tools_arc<I>(self, tools: I) -> AgentBuilder

where I: IntoIterator<Item = Arc<dyn ErasedTool>>,

Add multiple pre-wrapped Arc<dyn ErasedTool> instances at once.

pub fn memory(self, memory: impl Memory) -> AgentBuilder

Set the memory backend.

pub fn guard(self, guard: impl Guard) -> AgentBuilder

Add a guard to the agent.

pub fn hint(self, hint: impl Hint) -> AgentBuilder

Add a hint to the agent.

pub fn tracker(self, tracker: impl Tracker) -> AgentBuilder

Set the tracker for runtime monitoring.

pub fn max_iterations(self, max: u32) -> AgentBuilder

Set the maximum number of tool call iterations.

pub fn max_tokens(self, max: u32) -> AgentBuilder

Set the maximum tokens for LLM responses.

pub fn temperature(self, temp: f32) -> AgentBuilder

Set the sampling temperature.

pub fn token_budget(self, budget: usize) -> AgentBuilder

Set the token budget for the entire run.

pub fn context_manager( self, manager: impl ContextManager + 'static, ) -> AgentBuilder

Set the async context window manager.

Supports LLM-powered compression and accurate token counting. Default: RuleBasedCompressor.

pub fn execution_strategy( self, strategy: impl ExecutionStrategy + 'static, ) -> AgentBuilder

Set the tool execution strategy.

Default: SequentialStrategy (one at a time). Use ParallelStrategy for concurrent execution.

pub fn output_transformer( self, transformer: impl OutputTransformer + 'static, ) -> AgentBuilder

Set the async tool output transformer.

Supports context-aware, async tool output processing. Default: BudgetAwareTruncator (10,000 chars).

pub fn tool_registry( self, registry: impl ToolRegistry + 'static, ) -> AgentBuilder

Set the dynamic tool registry (v0.3.0).

Enables runtime tool activation/deactivation. Default: SimpleRegistry wrapping configured tools.

pub fn strategy(self, strategy: impl AgentStrategy) -> AgentBuilder

Set the agent execution strategy.

Default: DefaultStrategy (preserves v0.1.0 loop behavior). Implement AgentStrategy for custom reasoning architectures.

pub fn hook(self, hook: impl AgentHook) -> AgentBuilder

Add a lifecycle hook for observability and interception.

Multiple hooks can be registered and are called sequentially.

Example

use traitclaw_core::traits::hook::LoggingHook;

// Agent::builder()
//     .model(my_provider)
//     .hook(LoggingHook::new(tracing::Level::INFO))
//     .build()

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

Build the agent. Returns an error if no provider is configured.

Errors

Returns Error::Config if no provider has been set.

Trait Implementations

impl Default for AgentBuilder

fn default() -> AgentBuilder

Returns the “default value” for a type.