Enum ToolErrorCategory 

pub enum ToolErrorCategory {
    ToolNotFound,
    InvalidParameters,
    TypeMismatch,
    PolicyBlocked,
    ConfirmationRequired,
    PermanentFailure,
    Cancelled,
    RateLimited,
    ServerError,
    NetworkError,
    Timeout,
}

Fine-grained 12-category classification of tool invocation errors.

Each category determines retry eligibility, LLM parameter reformat path, quality attribution for reputation scoring, and structured feedback content.

Variants

ToolNotFound

Tool name not found in the registry (LLM requested a non-existent tool).

InvalidParameters

LLM provided invalid or missing parameters for the tool.

TypeMismatch

Parameter type mismatch (e.g., string where integer expected).

PolicyBlocked

Blocked by security policy (blocklist, sandbox, trust gate).

ConfirmationRequired

Requires user confirmation before execution.

PermanentFailure

HTTP 403/404 or equivalent permanent resource rejection.

Cancelled

Operation cancelled by the user.

RateLimited

HTTP 429 (rate limit) or resource exhaustion.

ServerError

HTTP 5xx or equivalent server-side error.

NetworkError

Network connectivity failure (DNS, connection refused, reset).

Timeout

Operation timed out.

Implementations

impl ToolErrorCategory

pub fn is_retryable(self) -> bool

Whether this error category is eligible for automatic retry with backoff.

pub fn needs_parameter_reformat(self) -> bool

Whether the LLM should be asked to reformat parameters and retry.

Only InvalidParameters and TypeMismatch trigger the reformat path. A single reformat attempt is allowed; if it fails, the error is final.

pub fn is_quality_failure(self) -> bool

Whether this error is attributable to LLM output quality.

Quality failures affect reputation scoring in triage routing and are the only category for which attempt_self_reflection should be triggered. Infrastructure errors (network, timeout, server, rate limit) are NOT the model’s fault and must never trigger self-reflection.

pub fn domain(self) -> ErrorDomain

Map to the high-level error domain for recovery dispatch.

Use the returned ErrorDomain to select a recovery strategy in the agent loop instead of checking multiple predicate methods individually.

pub fn error_kind(self) -> ErrorKind

Coarse classification for backward compatibility with existing ErrorKind.

pub fn phase(self) -> ToolInvocationPhase

Map to the diagnostic invocation phase per arXiv:2601.16280.

pub fn label(self) -> &'static str

Human-readable label for audit logs, TUI status indicators, and structured feedback.

pub fn suggestion(self) -> &'static str

Recovery suggestion for the LLM based on error category.

Trait Implementations

impl Clone for ToolErrorCategory

fn clone(&self) -> ToolErrorCategory

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ToolErrorCategory

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

Formats the value using the given formatter.

impl Hash for ToolErrorCategory

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 ToolErrorCategory

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

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Copy for ToolErrorCategory

impl Eq for ToolErrorCategory

impl StructuralPartialEq for ToolErrorCategory