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.

Examples

use zeph_common::error_taxonomy::ToolErrorCategory;

assert!(ToolErrorCategory::RateLimited.is_retryable());
assert!(!ToolErrorCategory::InvalidParameters.is_retryable());

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.

pub fn is_quality_failure(self) -> bool

Whether this error is attributable to LLM output quality.

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.

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

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

pub fn phase(self) -> ToolInvocationPhase

Map to the diagnostic invocation phase per arXiv:2601.16280.

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<(), Error>

Formats the value using the given formatter.

impl Hash for ToolErrorCategory

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

where __H: Hasher,

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 as Serializer>::Ok, <__S as Serializer>::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl ToolErrorCategoryExt for ToolErrorCategory

fn error_kind(self) -> ErrorKind

Coarse classification for backward compatibility with existing ErrorKind.

impl Copy for ToolErrorCategory

impl Eq for ToolErrorCategory

impl StructuralPartialEq for ToolErrorCategory