Enum ToolErrorCategory 

#[non_exhaustive]
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 (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.

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 const fn is_retryable(self) -> bool

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

pub const 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 const 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 const fn domain(self) -> ErrorDomain

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

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

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

pub const fn phase(self) -> ToolInvocationPhase

Map to the diagnostic invocation phase per arXiv:2601.16280.

pub const 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 Copy for ToolErrorCategory

impl Debug for ToolErrorCategory

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ToolErrorCategory

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for ToolErrorCategory

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 StructuralPartialEq for ToolErrorCategory