Enum ToolError 

#[non_exhaustive]
pub enum ToolError {
    InvalidParams {
        message: String,
        source: Option<Box<dyn Error + Send + Sync>>,
    },
    NotFound(String),
    Unauthorized(String),
    Forbidden(String),
    Timeout {
        timeout_ms: u64,
        message: String,
        source: Option<Box<dyn Error + Send + Sync>>,
    },
    Internal {
        message: String,
        source: Option<Box<dyn Error + Send + Sync>>,
    },
    Custom {
        code: String,
        message: String,
        source: Option<Box<dyn Error + Send + Sync>>,
    },
    Json(Error),
    Io(Error),
}

Tool execution error

Uses #[non_exhaustive] to allow future expansion without breaking changes. Supports error chaining via #[source].

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.

InvalidParams

Invalid parameters

Fields

message: String

source: Option<Box<dyn Error + Send + Sync>>

NotFound(String)

Tool not found

Unauthorized(String)

Unauthorized access

Forbidden(String)

Forbidden

Timeout

Timeout

Fields

timeout_ms: u64

message: String

source: Option<Box<dyn Error + Send + Sync>>

Internal

Internal error

Fields

message: String

source: Option<Box<dyn Error + Send + Sync>>

Custom

Custom error with code

Fields

code: String

message: String

source: Option<Box<dyn Error + Send + Sync>>

Json(Error)

JSON serialization/deserialization error

Io(Error)

IO error

Implementations

impl ToolError

pub fn invalid_params(message: impl Into<String>) -> Self

Create invalid parameters error

pub fn invalid_params_with_source( message: impl Into<String>, source: impl Error + Send + Sync + 'static, ) -> Self

Create invalid parameters error with source

pub fn not_found(name: impl Into<String>) -> Self

Create tool not found error

pub fn unauthorized(message: impl Into<String>) -> Self

Create unauthorized error

pub fn forbidden(message: impl Into<String>) -> Self

Create forbidden error

pub fn timeout(timeout_ms: u64, message: impl Into<String>) -> Self

Create timeout error

pub fn timeout_with_source( timeout_ms: u64, message: impl Into<String>, source: impl Error + Send + Sync + 'static, ) -> Self

Create timeout error with source

pub fn internal(message: impl Into<String>) -> Self

Create internal error

pub fn internal_with_source( message: impl Into<String>, source: impl Error + Send + Sync + 'static, ) -> Self

Create internal error with source

pub fn custom(code: impl Into<String>, message: impl Into<String>) -> Self

Create custom error

pub fn custom_with_source( code: impl Into<String>, message: impl Into<String>, source: impl Error + Send + Sync + 'static, ) -> Self

Create custom error with source

pub fn code(&self) -> &str

Get error code

pub fn has_source(&self) -> bool

Check if error has source

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.

impl From<&str> for ToolError

fn from(message: &str) -> Self

Converts to this type from the input type.

impl From<Error> for ToolError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for ToolError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<String> for ToolError

fn from(message: String) -> Self

Converts to this type from the input type.