Struct AgentRuntime 

pub struct AgentRuntime { /* private fields */ }

Shared agent state installed on AppState by the plugin.

Handlers reach it through the AgentHandle extractor; the background jobs and the heartbeat read it directly.

Implementations

impl AgentRuntime

pub fn new( config: AgentConfig, client: Arc<dyn LlmClient>, tools: Vec<Arc<dyn Tool>>, ) -> Self

Bundle a client, tools, and config into the shared runtime.

Starts with an in-memory session store, no memory, no skills, the AllowAll policy, and LogDelivery. Adjust with the with_* methods.

pub fn with_hooks(self, hooks: Vec<Arc<dyn AgentHooks>>) -> Self

Add lifecycle hooks to every agent the runtime builds.

pub fn with_policy(self, policy: Arc<dyn ToolPolicy>) -> Self

Set the tool policy for every agent the runtime builds.

pub fn with_sessions(self, sessions: Arc<dyn SessionStore>) -> Self

Replace the session store.

pub fn with_memory(self, memory: Arc<dyn MemoryStore>) -> Self

Give every agent persistent memory in this store.

pub fn with_skills(self, skills: impl Into<Arc<[Skill]>>) -> Self

Offer these skills to every agent.

pub const fn with_compaction(self, compaction: Compaction) -> Self

Compact long session transcripts.

pub fn with_delivery(self, delivery: Arc<dyn Delivery>) -> Self

Where background results go.

pub const fn with_followups(self, max_delay: Duration) -> Self

Give agents the schedule_followup tool, with this maximum delay.

pub fn agent(&self) -> Agent

Build an Agent with the runtime’s client, tools, budgets, hooks, policy, skills, and memory (scope MemoryScope::agent).

pub fn agent_for(&self, scope: MemoryScope) -> Agent

Like AgentRuntime::agent, with memory bound to scope (for example one scope per user).

pub const fn config(&self) -> &AgentConfig

The plugin configuration backing this runtime.

pub fn client(&self) -> Arc<dyn LlmClient>

The provider client this runtime runs agents with.

The health indicator uses the same client, so /actuator/health always reflects the provider the app actually talks to.

pub fn policy(&self) -> Arc<dyn ToolPolicy>

The tool policy agents run under.

pub fn sessions(&self) -> Arc<dyn SessionStore>

The session store.

pub fn memory(&self) -> Option<Arc<dyn MemoryStore>>

The memory store, when memory is on.

pub fn delivery(&self) -> Arc<dyn Delivery>

Where background results go.

pub fn tool_names(&self) -> Vec<&str>

Names of the registered tools.

Trait Implementations

impl Clone for AgentRuntime

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AgentRuntime

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

Formats the value using the given formatter.