Enum ToolOutput 

pub enum ToolOutput {
    Text(String),
    Blocks {
        blocks: Vec<Value>,
        summary: String,
    },
}

Structured tool output. Text is the legacy contract (what execute returns). Blocks carries Anthropic-shaped content blocks destined for tool_result.content, plus a plain-text summary used everywhere a String is expected today: UI preview, after_tool_call hooks, trace ledger byte counts, headless logs, and providers that cannot carry the blocks. INVARIANT: blocks[0] MUST be a {"type":"text"} block whose text == summary (compaction reads blocks[0].text; non-Anthropic translators join only text sub-blocks).

Variants

Text(String)

Blocks

Fields

blocks: Vec<Value>

summary: String

Implementations

impl ToolOutput

pub fn summary(&self) -> &str

pub fn into_parts(self) -> (String, Option<Vec<Value>>)

(summary, Some(blocks)) for rich output, (text, None) for plain. This is the one choke point every rich result passes through, so the blocks[0] text-first invariant is ENFORCED here in every build: a Blocks value whose first block is not {"type":"text"} gets a text block built from summary prepended. Debug builds additionally assert that an existing leading text block matches summary.

pub fn into_summary(self) -> String

Trait Implementations

impl Clone for ToolOutput

fn clone(&self) -> ToolOutput

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ToolOutput

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

Formats the value using the given formatter.