Struct ToolOutput 

pub struct ToolOutput {
    pub tool_name: ToolName,
    pub summary: String,
    pub blocks_executed: u32,
    pub filter_stats: Option<FilterStats>,
    pub diff: Option<DiffData>,
    pub streamed: bool,
    pub terminal_id: Option<String>,
    pub locations: Option<Vec<String>>,
    pub raw_response: Option<Value>,
    pub claim_source: Option<ClaimSource>,
}

Structured result from tool execution.

Returned by every ToolExecutor implementation on success. The agent loop uses ToolOutput::summary as the tool result text injected into the LLM context.

Example

use zeph_tools::{ToolOutput, executor::ClaimSource};
use zeph_common::ToolName;

let output = ToolOutput {
    tool_name: ToolName::new("shell"),
    summary: "hello\n".to_owned(),
    blocks_executed: 1,
    filter_stats: None,
    diff: None,
    streamed: false,
    terminal_id: None,
    locations: None,
    raw_response: None,
    claim_source: Some(ClaimSource::Shell),
};
assert_eq!(output.to_string(), "hello\n");

Fields

tool_name: ToolName

Name of the tool that produced this output (e.g. "shell", "web-scrape").

summary: String

Human-readable result text injected into the LLM context.

blocks_executed: u32

Number of code blocks processed in this invocation.

filter_stats: Option<FilterStats>

Output filter statistics when filtering was applied, None otherwise.

diff: Option<DiffData>

File diff data for TUI display when the tool modified a tracked file.

streamed: bool

Whether this tool already streamed its output via ToolEvent channel.

terminal_id: Option<String>

Terminal ID when the tool was executed via IDE terminal (ACP terminal/* protocol).

locations: Option<Vec<String>>

File paths touched by this tool call, for IDE follow-along (e.g. ToolCallLocation).

raw_response: Option<Value>

Structured tool response payload for ACP intermediate tool_call_update notifications.

claim_source: Option<ClaimSource>

Provenance of this tool result. Set by the executor at construction time. None in pass-through wrappers, mocks, and tests.

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.

impl Display for ToolOutput

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

Formats the value using the given formatter.