Enum ToolError 

pub enum ToolError {
    InvalidInput {
        tool: String,
        source: Error,
    },
    Handler {
        tool: String,
        source: HandlerError,
    },
    MissingIdempotencyKey {
        tool: String,
        path: String,
        detail: String,
    },
    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.
• ToolError::MissingIdempotencyKey means the operator declared which input field identifies this tool’s calls and the call does not carry it. The tool was not called, and it will not be called unkeyed. Like InvalidInput this is the arguments being wrong, so the loop feeds it back to the model rather than retrying it.

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.

MissingIdempotencyKey

The tool has a declared idempotency key path and this call’s input does not yield a key from it. Nothing ran.

See IdempotencyPath::derive for what counts as a key and why falling back to an unkeyed call is not an option here.

Fields

tool: String

The tool whose call was refused.

path: String

The declared path, as the operator wrote it.

detail: String

What went wrong at that path, including the keys the input carries.

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.