Struct ToolExecutionOutput 

pub struct ToolExecutionOutput {
    pub result: ToolResult,
    pub next_provider_parts: Vec<ContentPart>,
}

Output of an authorized tool execution that may carry a provider-neutral continuation artifact (ADR-051).

Most tools produce only the normal ToolResult. A tool like read_image additionally returns next_provider_parts — a Vec<ContentPart> that the agent delivers to the immediately following provider request exactly once and then discards.

The continuation artifact is never persisted in the session transcript, TLOG, UI, hooks, exports, or compaction. It exists solely for the next stream_with_tools call.

Fields

result: ToolResult

The normal textual tool result (same as ToolResult).

next_provider_parts: Vec<ContentPart>

Provider-neutral content parts to carry to the next provider request. Empty for all existing tools.

Implementations

impl ToolExecutionOutput

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

Creates an output with a successful text result and no continuation parts.

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

Creates an output with an error text result and no continuation parts.

pub fn from_result(result: ToolResult) -> Self

Wraps an existing ToolResult with no continuation parts.

Trait Implementations

impl Clone for ToolExecutionOutput

fn clone(&self) -> ToolExecutionOutput

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ToolExecutionOutput

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

Formats the value using the given formatter.