Enum ToolError 

pub enum ToolError {
    ToolNotFound {
        tool_name: String,
    },
    ExecutionFailed {
        tool_name: String,
        message: String,
    },
    SchemaValidationFailed {
        tool_name: String,
        message: String,
    },
}

A tool failed for reasons the model can’t fix by retrying with different arguments. Most tool failures (bad args, non-zero bash exit, file-not-found, timeouts) flow through ToolResult::Error instead; those reach the model as tool-result messages.

Variants

ToolNotFound

Registry has no tool with this name. The loop forwards the failure to the model as a tool-result error so it can pick a different tool.

Fields

tool_name: String

ExecutionFailed

The tool was invoked but its execution raised an error. Covers harness wiring gaps, persistence/IO failures, and anything else a tool returns via Err(...).

Fields

tool_name: String

message: String

SchemaValidationFailed

A schema-checked tool rejected the model’s payload. Distinct from ExecutionFailed so the loop can apply the dedicated retry budget (policies.max_schema_retries) and emit ToolFailureKind::SchemaValidationFailed.

Fields

tool_name: String

message: String

Implementations

impl ToolError

pub fn tool_name(&self) -> &str

Name of the tool that raised the error.

pub fn message(&self) -> String

Human-readable description of what went wrong, suitable for the model-visible tool-result block.

Trait Implementations

impl Debug for ToolError

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

Formats the value using the given formatter.

impl Display for ToolError

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

Formats the value using the given formatter.

impl Error for ToolError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.