Enum ToolError 

pub enum ToolError {
    NotFound(ToolName),
    InvalidInput(String),
    PermissionDenied(PermissionDenial),
    ExecutionFailed(String),
    AuthRequired(Box<AuthRequest>),
    Unavailable(String),
    Cancelled,
    Internal(String),
}

Errors that can occur during tool lookup, permission checking, or execution.

Returned from Tool::invoke and also used internally by BasicToolExecutor to represent lookup and permission failures.

Variants

NotFound(ToolName)

No tool with the given name exists in the registry.

InvalidInput(String)

The input JSON did not match the tool’s expected schema.

PermissionDenied(PermissionDenial)

A permission policy denied the operation.

ExecutionFailed(String)

The tool ran but encountered a runtime error.

AuthRequired(Box<AuthRequest>)

The tool needs authentication credentials to proceed.

The executor converts this into ToolInterruption::AuthRequired.

Unavailable(String)

The tool is temporarily unavailable.

Cancelled

The turn was cancelled while the tool was running.

Internal(String)

An unexpected internal error.

Implementations

impl ToolError

pub fn permission_denied(denial: PermissionDenial) -> Self

Convenience constructor for the PermissionDenied variant.

Trait Implementations

impl Clone for ToolError

fn clone(&self) -> ToolError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ToolError

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ToolError

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

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.

impl From<PermissionDenial> for ToolError

fn from(value: PermissionDenial) -> Self

Converts to this type from the input type.

impl PartialEq for ToolError

fn eq(&self, other: &ToolError) -> 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 ToolError

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 ToolError