Struct AgentConfig 

pub struct AgentConfig { /* private fields */ }

Dependencies and policy for one agent session.

Implementations

impl AgentConfig

pub fn new( model: Arc<ModelRouter>, sandbox: Arc<Sandbox>, checkpoints: Arc<dyn CheckpointStore>, middleware: MiddlewareStack, system_prompt: impl Into<String>, ) -> Self

Creates a complete agent configuration.

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

Sets a stable ID used to resume a checkpointed session.

pub fn session_context(self, context: SessionContext) -> Self

Attaches trusted, frontend-visible labels to this session.

pub fn context_window(self, context_window: i64) -> Self

Sets the provider’s context window for usage display and policy.

pub fn initial_replay_batches(self, max_batches: usize) -> Self

Sets the maximum durable transcript batches rendered when a session opens. Zero disables checkpoint-derived presentation replay.

pub fn max_model_steps(self, max_steps: usize) -> Self

Sets the maximum number of primary model steps in one turn.

pub fn metadata(self, metadata: BTreeMap<String, Value>) -> Self

Sets durable framework-internal metadata used by installed capabilities.

On resume, calling this replaces the saved metadata. Omitting it preserves the saved value.

pub fn usage_observer( self, observer: impl Fn(&str, &TokenUsage) -> Result<()> + Send + Sync + 'static, ) -> Self

Observes normalized token-usage increments with their selected model route.

Returning an error aborts the active turn before the increment is committed to the session checkpoint.

pub fn model_route( self, route: &str, reasoning_effort: Option<&str>, ) -> Result<Self>

Selects a registered model route and optional reasoning effort.

pub fn override_saved_model_route(self) -> Self

Makes the configured router default replace a saved route on resume.

Trait Implementations

impl Clone for AgentConfig

fn clone(&self) -> AgentConfig

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.