Struct Agent 

pub struct Agent { /* private fields */ }

Stable public entry point for agent execution.

Wraps an AgentRuntime and provides:

• Agent::execute() — run the agent loop on a session
• Agent::storage() — access the shared storage backend

Clone is cheap (inner is Arc).

Implementations

impl Agent

pub fn from_runtime(runtime: Arc<AgentRuntime>) -> Self

Wrap an existing AgentRuntime in an Agent.

pub fn builder() -> AgentBuilder

Return a new builder.

pub async fn execute( &self, session: &mut Session, req: ExecuteRequest, ) -> Result<()>

Execute the agent loop with the given request.

pub fn storage(&self) -> &Arc<dyn Storage>

Access the shared storage backend.

pub fn persistence(&self) -> &Arc<dyn RuntimeSessionPersistence>

Access the runtime persistence adapter for non-authoritative saves.

pub fn default_tools(&self) -> &Arc<dyn ToolExecutor>

Access the runtime’s default tool executor (the root/full tool surface assembled at build time).

Exposed so callers can compose additional one-off dispatches against the SAME executor the loop itself uses — e.g. re-executing a single previously-gated tool call after a permission approval — without forking or reaching into AgentLoopConfig (which stays unconstructible outside the engine). This is a read-only accessor alongside storage() / persistence(); it does not touch the sealed loop config.

Trait Implementations

impl Clone for Agent

fn clone(&self) -> Agent

Returns a duplicate of the value.

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

Performs copy-assignment from source.