Struct AgentToolResult 

pub struct AgentToolResult {
    pub content: Vec<ContentBlock>,
    pub details: Value,
    pub is_error: bool,
    pub transfer_signal: Option<TransferSignal>,
}

The result of a tool execution.

Contains content blocks returned to the LLM and structured details for logging that are not sent to the model.

Fields

content: Vec<ContentBlock>

Content blocks returned to the LLM as the tool result.

details: Value

Structured data for logging and display; not sent to the LLM.

is_error: bool

Whether this result represents an error condition.

transfer_signal: Option<TransferSignal>

Optional transfer signal when this tool result requests an agent handoff.

Implementations

impl AgentToolResult

pub fn text(text: impl Into<String>) -> Self

Create a result containing a single text content block with null details.

pub fn error(message: impl Into<String>) -> Self

Create an error result containing a single text content block with null details.

Semantically identical to text but communicates intent at the call site.

pub fn transfer(signal: TransferSignal) -> Self

Create a result that signals a transfer to another agent.

The result text is a brief confirmation message; the transfer signal carries the actual handoff payload. The agent loop detects this signal and terminates the turn with StopReason::Transfer.

pub const fn is_transfer(&self) -> bool

Returns true if this result carries a transfer signal.

Trait Implementations

impl Clone for AgentToolResult

fn clone(&self) -> AgentToolResult

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AgentToolResult

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for AgentToolResult

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for AgentToolResult

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.