Enum ToolError 

#[non_exhaustive]
pub enum ToolError {
    NotFound(String),
    InvalidArgs(String),
    ExecutionFailed(String),
    PermissionDenied {
        tool: String,
        reason: String,
    },
    FileNotFound(String),
    InvalidPath(String),
    Timeout(u64),
}

Error type for tool execution.

Covers the common failure modes: unknown tool, bad arguments, runtime failures, permission issues, and timeouts.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

NotFound(String)

The requested tool was not found in the registry.

InvalidArgs(String)

The arguments provided to the tool are invalid.

ExecutionFailed(String)

The tool execution failed at runtime.

PermissionDenied

The caller lacks permission to invoke this tool.

tool is the name of the tool that was denied. reason explains why (not in allowlist, explicitly denied, insufficient level, missing custom permission).

Fields

tool: String

reason: String

FileNotFound(String)

A file or resource the tool needs was not found.

InvalidPath(String)

A filesystem path is invalid or traverses outside allowed boundaries.

Timeout(u64)

The tool execution exceeded the allowed time limit.

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.