Struct AgentBuilder 

pub struct AgentBuilder<M>
where
    M: ModelAdapter,
{ /* private fields */ }

Builder for constructing an Agent.

Obtained via Agent::builder. The only required field is model; all others have sensible defaults (no tools, allow-all permissions, no compaction, no observers).

Implementations

impl<M> AgentBuilder<M>

where M: ModelAdapter,

pub fn model(self, model: M) -> AgentBuilder<M>

Set the model adapter (required).

pub fn tools(self, tools: ToolRegistry) -> AgentBuilder<M>

Set the tool registry. Defaults to an empty ToolRegistry.

pub fn task_manager( self, manager: impl TaskManager + 'static, ) -> AgentBuilder<M>

Set the task manager that schedules tool-call execution.

Defaults to SimpleTaskManager, which preserves the existing sequential request/response behavior.

pub fn permissions( self, permissions: impl PermissionChecker + 'static, ) -> AgentBuilder<M>

Set the permission checker that gates tool execution.

Defaults to allowing all tool calls without prompting.

pub fn resources( self, resources: impl ToolResources + 'static, ) -> AgentBuilder<M>

Set shared resources available to tool implementations.

pub fn cancellation(self, handle: CancellationHandle) -> AgentBuilder<M>

Attach a CancellationHandle for cooperative cancellation of turns.

pub fn compaction(self, config: CompactionConfig) -> AgentBuilder<M>

Enable transcript compaction with the given configuration.

When configured, the driver checks the compaction trigger before each turn and applies the compaction strategy if the transcript is too long.

pub fn observer(self, observer: impl LoopObserver + 'static) -> AgentBuilder<M>

Register a LoopObserver that receives AgentEvents.

Multiple observers may be registered; they are called in order.

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

Consume the builder and produce an Agent.

Errors

Returns LoopError::InvalidState if no model adapter was provided.

Trait Implementations

impl<M> Default for AgentBuilder<M>

where M: ModelAdapter,

fn default() -> AgentBuilder<M>

Returns the “default value” for a type.