Struct OrchestratedHandle 

pub struct OrchestratedHandle { /* private fields */ }

Handle to a spawned orchestrated agent.

Provides request/response messaging, status polling, and cancellation. Lifecycle methods (status, cancel, is_done) are delegated to a shared task core.

Implementations

impl OrchestratedHandle

pub fn name(&self) -> &str

The name of the agent this handle refers to.

pub async fn send_message( &self, text: impl Into<String>, ) -> Result<AgentResult, AgentError>

Send a text message to the running agent and await its response.

pub async fn send_messages( &self, messages: Vec<AgentMessage>, ) -> Result<AgentResult, AgentError>

Send multiple messages to the agent and await its response.

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

Consume the handle and await the agent’s final result.

Drops the request channel so the agent shuts down after processing any remaining requests.

pub fn cancel(&self)

Cancel the agent.

pub fn status(&self) -> AgentStatus

Current status of the agent.

pub fn is_done(&self) -> bool

Whether the agent has finished (completed, failed, or cancelled).

Trait Implementations

impl Debug for OrchestratedHandle

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

Formats the value using the given formatter.