Struct ToolResult 

pub struct ToolResult {
    pub tool_name: String,
    pub llm_content: String,
    pub ui_content: String,
    pub success: bool,
    pub error: Option<String>,
    pub metadata: ToolMetadata,
}

Result from tool execution with dual-channel output

Tools return two versions of their output:

1. llm_content - Concise summary for model context (token-optimized)
2. ui_content - Rich output for user display (full details)

This enables significant token savings while preserving user experience.

Fields

tool_name: String

Tool name that produced this result

llm_content: String

Concise summary for LLM context (token-optimized)

Example: “Found 127 matches in 15 files. Key: src/tools/grep.rs (3), src/tools/list.rs (1)” vs full output which might be 2,500 tokens

ui_content: String

Rich output for UI display (full details)

Can include ANSI codes, formatting, full listings, etc. Not sent to LLM, only displayed to user

success: bool

Whether the tool execution succeeded

error: Option<String>

Error message if execution failed

metadata: ToolMetadata

Structured metadata for both channels

Implementations

impl ToolResult

pub fn new( tool_name: impl Into<String>, llm_content: impl Into<String>, ui_content: impl Into<String>, ) -> Self

Create a new tool result with dual content

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

Create an error result

pub fn simple(tool_name: impl Into<String>, content: impl Into<String>) -> Self

Create a simple result with same content for both channels

Use this for backward compatibility or when splitting doesn’t make sense

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

Add metadata to the result

pub fn with_files(self, files: Vec<PathBuf>) -> Self

Add file references to metadata

pub fn with_data(self, key: impl Into<String>, value: Value) -> Self

Add data to metadata

pub fn savings_summary(&self) -> String

Get token savings summary for logging

pub fn has_significant_savings(&self) -> bool

Check if this result has significant savings (>50%)

Trait Implementations

impl Clone for ToolResult

fn clone(&self) -> ToolResult

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ToolResult

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ToolResult

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for ToolResult

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

where __S: Serializer,

Serialize this value into the given Serde serializer.