Enum ToolError 

pub enum ToolError {
    InvalidInput {
        tool: String,
        source: Error,
    },
    Handler {
        tool: String,
        source: HandlerError,
    },
    OutputSerialization {
        tool: String,
        source: Error,
    },
}

The error the type-erased dispatch layer (DynTool::call_json) returns.

The variants are deliberately distinct so the runtime loop can route on them:

• ToolError::InvalidInput means the JSON the model produced did not deserialize into the tool’s Input type. The handler was not called. The loop feeds this back to the model to let it fix its arguments.
• ToolError::Handler means the handler ran and returned a HandlerError. This is a real execution failure, subject to the effect’s retry policy.
• ToolError::OutputSerialization means the handler succeeded but its Output value could not be serialized to JSON. This is an internal fault in the tool definition, not the model’s doing and not a retryable failure.

Variants

InvalidInput

The model’s JSON input did not match the tool’s input schema. The handler was never invoked.

Fields

tool: String

The tool that rejected the input.

source: Error

The deserialization error describing why the input was rejected.

Handler

The handler ran and returned a failure.

Fields

tool: String

The tool that failed.

source: HandlerError

The handler’s own error.

OutputSerialization

The handler succeeded but its output could not be serialized to JSON.

Fields

tool: String

The tool whose output failed to serialize.

source: Error

The serialization error.

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, __formatter: &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.