Struct Agent 

pub struct Agent { /* private fields */ }

A multi-turn agentic loop that drives an LLM provider, executes tool calls, and emits hook events at each lifecycle point.

Implementations

impl Agent

pub fn new(provider: Arc<dyn Provider>, config: AgentConfig) -> Self

Create a new agent with the given provider and configuration.

pub fn with_defaults(provider: Arc<dyn Provider>) -> Self

Create a new agent with the locked default configuration.

impl Agent

pub async fn run(&self, messages: Vec<Message>) -> AppResult<AgentResult>

Run the agent loop synchronously (all turns, no streaming).

impl Agent

pub fn stream( &self, messages: Vec<Message>, ) -> Pin<Box<dyn Stream<Item = AgentEvent> + Send + '_>>

Stream the agent loop, yielding AgentEvents for each lifecycle point.

Trait Implementations

impl Component for Agent

fn name(&self) -> &'static str

Stable identifier used in logs and health responses.

fn start<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = AppResult<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Start the component.

fn stop<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = AppResult<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Stop the component gracefully.

fn health(&self) -> Health

Return an instantaneous health snapshot.