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) -> Self

Set the model adapter (required).

pub fn tools(self, tools: ToolRegistry) -> Self

Set the tool registry. Defaults to an empty ToolRegistry.

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

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) -> Self

Set the permission checker that gates tool execution.

Defaults to allowing all tool calls without prompting.

pub fn resources(self, resources: impl ToolResources + 'static) -> Self

Set shared resources available to tool implementations.

pub fn cancellation(self, handle: CancellationHandle) -> Self

Attach a CancellationHandle for cooperative cancellation of turns.

pub fn compaction(self, config: CompactionConfig) -> Self

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) -> Self

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() -> Self

Returns the “default value” for a type.