Struct AgentRunner 

pub struct AgentRunner<P: LlmProvider> { /* private fields */ }

Runs an agent loop: LLM call → tool execution → repeat until done.

Implementations

impl<P: LlmProvider> AgentRunner<P>

pub fn builder(provider: Arc<P>) -> AgentRunnerBuilder<P>

Create a new AgentRunnerBuilder for an agent backed by provider.

The builder uses sensible defaults (10 turns, 4096 tokens) so the minimum required configuration is just a system prompt.

Example

use std::sync::Arc;
use heartbit_core::{AgentRunner, AnthropicProvider, BoxedProvider};

let provider = Arc::new(BoxedProvider::new(AnthropicProvider::new(
    "sk-...",
    "claude-sonnet-4-20250514",
)));
let agent = AgentRunner::builder(provider)
    .system_prompt("You are a helpful assistant.")
    .build()?;

pub fn name(&self) -> &str

Returns the agent’s name.

pub async fn execute(&self, task: &str) -> Result<AgentOutput, Error>

Run the agent on task and return the final output.

pub async fn execute_with_content( &self, content: Vec<ContentBlock>, ) -> Result<AgentOutput, Error>

Execute with pre-built multimodal content blocks (e.g., text + images).

Trait Implementations

impl<P: LlmProvider> Drop for AgentRunner<P>

fn drop(&mut self)

Executes the destructor for this type.