Struct Agent 

pub struct Agent { /* private fields */ }

The immutable, validated description of an agent.

Produced by AgentBuilder::build. It holds the value-first configuration and materializes independent in-process runtimes from it, one per session; the underlying runtime composition is kept in private fields.

Implementations

impl Agent

pub fn builder() -> AgentBuilder

Start describing an agent.

Example

use everruns::{Agent, Model};

let agent = Agent::builder()
    .instructions("You are concise.")
    .model(Model::simulated("Sure."))
    .name("assistant")
    .capability("test_math")
    .parallel_tool_calls(true)
    .build()?;

pub fn session(&self) -> Session

Open a new, independent multi-turn Session with this agent.

The session is lazy: the in-process runtime is assembled on the first Session::send or Session::inspect. Each session gets a fresh id and isolated history. The Agent and its clones share the private session catalog and event log so a dropped session can be resumed while the Agent’s configured persistence lifecycle remains available.

pub async fn resume( &self, session_id: SessionId, ) -> Result<Session, ResumeError>

Resume a session through this Agent’s configured session catalog.

The default catalog is Agent-lifetime memory and is shared by Agent clones. With LocalConfig, the catalog and canonical event log survive a new Agent and process. The resumed session uses this Agent’s current model, instructions, tools, hooks, and workspace configuration.

Errors

Returns ResumeError when the id is unknown, the configured catalog is unavailable, or persisted local state is corrupt.

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.

impl Debug for Agent

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.