Struct AgentToolResult 

pub struct AgentToolResult {
    pub success: bool,
    pub output: String,
    pub metadata: Option<Value>,
    pub content_blocks: Option<Vec<ContentBlock>>,
    pub terminate: bool,
    pub intent: Option<String>,
}

Result of tool execution

Fields

success: bool

pub.

output: String

pub.

metadata: Option<Value>

pub.

content_blocks: Option<Vec<ContentBlock>>

Optional content blocks (e.g., image blocks) to include in the tool result message. When present, these are used as the content of the ToolResultMessage instead of wrapping output in a Text block.

terminate: bool

When true, signals that the agent loop should terminate after this batch of tool calls completes. Defaults to false so that the loop continues unless a tool explicitly opts-in to termination.

intent: Option<String>

Intent trace — a concise description of what this specific tool call did. Set by the agent loop from the tool’s static intent() or by the tool itself for dynamic intent. Included in ToolExecutionEnd events.

Implementations

impl AgentToolResult

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

Creates a successful tool result with the given output text.

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

Creates an error tool result with the given error message.

pub fn with_metadata(self, metadata: Value) -> Self

Attaches structured metadata (JSON) to this result.

pub fn with_content_blocks(self, blocks: Vec<ContentBlock>) -> Self

Attaches rich content blocks (images, code, etc.) to this result.

pub fn with_terminate(self) -> Self

Mark this result as requesting agent-loop termination.

pub fn with_intent(self, intent: impl Into<String>) -> Self

Attach an intent trace to this result.

Trait Implementations

impl Debug for AgentToolResult

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

Formats the value using the given formatter.

impl Display for AgentToolResult

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

Formats the value using the given formatter.