Struct AgentHandle 

pub struct AgentHandle { /* private fields */ }

A handle to a spawned agent task.

Created via AgentHandle::spawn or AgentHandle::spawn_text, which move an Agent into a background tokio task. The handle allows the caller to poll status, cancel, and retrieve the final result.

Implementations

impl AgentHandle

pub fn spawn(agent: Agent, input: Vec<AgentMessage>) -> Self

Spawn an agent task with the given input messages.

Takes ownership of the Agent and moves it into a tokio task. Returns a handle that can be used to poll status, cancel, or await the result.

pub fn spawn_text(agent: Agent, text: impl Into<String>) -> Self

Convenience wrapper that spawns an agent with a single text message.

Equivalent to calling spawn with a single UserMessage containing the given text.

pub fn status(&self) -> AgentStatus

Returns the current status of the spawned agent task.

pub fn is_done(&self) -> bool

Returns true if the agent task is no longer running.

pub fn cancel(&self)

Request cancellation of the spawned agent task.

This is non-blocking. The task will transition to Cancelled status asynchronously.

pub async fn result(self) -> Result<AgentResult, AgentError>

Consume the handle and await the final result.

If the task panicked, returns an AgentError::StreamError wrapping the panic message.

pub fn try_result(&mut self) -> Option<Result<AgentResult, AgentError>>

Check if the task is finished and, if so, return the result without blocking.

Returns None if the task is still running. Once a result is returned, subsequent calls will return None.

Trait Implementations

impl Debug for AgentHandle

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

Formats the value using the given formatter.