Struct ToolResult 

pub struct ToolResult {
    pub tool_call_id: String,
    pub content: String,
    pub is_error: bool,
    pub error_category: Option<UserErrorCategory>,
}

Result from executing a tool, sent back to the LLM.

After executing a ToolCall, create a ToolResult to send back. The LLM will use this information to continue the conversation.

Example

use multi_llm::ToolResult;

// Successful result
let success = ToolResult {
    tool_call_id: "call_abc123".to_string(),
    content: "Weather in Paris: Sunny, 18°C".to_string(),
    is_error: false,
    error_category: None,
};

// Error result
use multi_llm::error::UserErrorCategory;
let error = ToolResult {
    tool_call_id: "call_xyz789".to_string(),
    content: "City not found".to_string(),
    is_error: true,
    error_category: Some(UserErrorCategory::NotFound),
};

Fields

tool_call_id: String

ID of the tool call this result responds to.

Must match the id from the corresponding ToolCall.

content: String

Result content from the tool execution.

For successful calls, this is the tool’s output (often a string or JSON). For errors, this should describe what went wrong.

is_error: bool

Whether the tool execution failed.

When true, the LLM knows the tool didn’t work and may try alternatives.

error_category: Option<UserErrorCategory>

Error category for structured error handling.

Only meaningful when is_error is true. Helps applications handle different error types appropriately.

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 PartialEq for ToolResult

fn eq(&self, other: &ToolResult) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

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.

impl StructuralPartialEq for ToolResult