Enum ToolFailureKind 

#[non_exhaustive]
pub enum ToolFailureKind {
    InvalidArgs,
    Timeout,
    Cancelled,
    NotFound,
    PermissionDenied,
    RateLimited,
    Provider,
    Network,
    Other,
}

How a tool execution failed, as a closed set of standard kinds.

A hook, policy, or telemetry pipeline matches on this to make control-flow decisions (e.g. “terminate after repeated timeouts, but keep going on a 404”) without parsing the model-visible error string.

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.

InvalidArgs

The arguments could not be parsed or were rejected as invalid.

Timeout

The tool did not complete within its allotted time.

Cancelled

The tool call was cancelled (e.g. by an abort signal or a dropped future).

NotFound

The requested resource was not found (e.g. an HTTP 404).

PermissionDenied

The caller was not permitted to perform the action (e.g. an HTTP 401/403).

RateLimited

The tool was rate limited (e.g. an HTTP 429).

Provider

The upstream provider/service returned an error (e.g. an HTTP 5xx).

Network

A network/transport failure occurred before a response was received.

Other

Any failure that does not fit a more specific kind.

Implementations

impl ToolFailureKind

pub const fn as_str(self) -> &'static str

A stable, machine-friendly identifier for the kind, suitable for tracing spans, metrics labels, and structured logs.

Trait Implementations

impl Clone for ToolFailureKind

fn clone(&self) -> ToolFailureKind

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for ToolFailureKind

impl Debug for ToolFailureKind

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

Formats the value using the given formatter.

impl Display for ToolFailureKind

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

Formats the value using the given formatter.

impl Eq for ToolFailureKind

impl Hash for ToolFailureKind

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for ToolFailureKind

fn eq(&self, other: &ToolFailureKind) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for ToolFailureKind