Enum ToolError 

#[non_exhaustive]
pub enum ToolError {
    InvalidInput(String),
    HostBlocked {
        host: String,
    },
    UnsupportedScheme {
        scheme: String,
    },
    MethodBlocked {
        method: String,
    },
    BodyTooLarge {
        limit_bytes: usize,
    },
    Network {
        message: String,
        source: Option<Box<dyn Error + Send + Sync + 'static>>,
    },
    Config {
        message: String,
        source: Option<Box<dyn Error + Send + Sync + 'static>>,
    },
    Calculator(String),
    Serde(Error),
}

Tool-layer failures.

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.

InvalidInput(String)

Input did not match the tool’s input_schema.

HostBlocked

Host blocked by the configured allowlist.

Fields

host: String

The rejected host.

UnsupportedScheme

URL scheme was not http or https.

Fields

scheme: String

The rejected scheme.

MethodBlocked

HTTP method blocked by the configured method allowlist.

Fields

method: String

The rejected method, uppercased.

BodyTooLarge

Response body exceeded the configured cap.

Fields

limit_bytes: usize

Configured cap.

Network

Network / HTTP failure. Carries the underlying transport error as the source so callers see the full chain via std::error::Error::source.

Fields

message: String

Human-readable summary.

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

Underlying transport error.

Config

Configuration error (malformed allowlist pattern, etc.). Carries the parse / validation source when the misconfiguration was detected via a typed error.

Fields

message: String

Human-readable summary.

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

Underlying parse / validation error.

Calculator(String)

Calculator parser rejected the input expression.

Serde(Error)

JSON encode/decode failure.

Implementations

impl ToolError

pub fn network<E>(source: E) -> Self

where E: Error + Send + Sync + 'static,

Wrap any transport error as a ToolError::Network preserving the source chain.

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

Construct a ToolError::Network from a bare message (timeout, body cap exceeded, …).

pub fn config<E>(source: E) -> Self

where E: Error + Send + Sync + 'static,

Wrap a parse/validation error as a ToolError::Config preserving the source chain.

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

Construct a ToolError::Config from a bare message.

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<Error> for ToolError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<ToolError> for Error

fn from(err: ToolError) -> Self

Converts to this type from the input type.