Enum ToolErrorCategory 

pub enum ToolErrorCategory {
    Transient {
        error: String,
        retry_strategy: RetryStrategy,
    },
    InputValidation {
        error: String,
        suggestion: Option<String>,
    },
    ExternalService {
        error: String,
        service: String,
        retry_after: Option<Duration>,
    },
    Permission {
        error: String,
        required_permission: String,
    },
    Logic {
        error: String,
        context: String,
    },
    Resource {
        error: String,
        resource_type: ResourceType,
    },
    Unknown {
        error: String,
    },
}

Error taxonomy based on AgentDebug paper (arxiv:2509.25370)

Variants

Transient

Transient errors that may succeed on retry (network issues, timeouts).

Fields

error: String

Error message.

retry_strategy: RetryStrategy

Retry strategy for this error.

InputValidation

Input validation errors - need different input parameters.

Fields

error: String

Error message.

suggestion: Option<String>

Suggested fix for the input.

ExternalService

External service errors (API limits, service unavailable).

Fields

error: String

Error message.

service: String

Name of the external service.

retry_after: Option<Duration>

Suggested delay before retry.

Permission

Permission/access errors - won’t succeed without user action.

Fields

error: String

Error message.

required_permission: String

The permission required to proceed.

Logic

Logic errors - indicates model misunderstanding of tool usage.

Fields

error: String

Error message.

context: String

Context in which the logic error occurred.

Resource

Resource errors - file not found, memory, disk space.

Fields

error: String

Error message.

resource_type: ResourceType

Type of resource involved.

Unknown

Unknown/unclassified errors.

Fields

error: String

Error message.

Implementations

impl ToolErrorCategory

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

Return the category name as a static string.

pub fn error_message(&self) -> &str

Return the error message string.

pub fn is_retryable(&self) -> bool

Whether this error category is retryable.

pub fn retry_strategy(&self) -> RetryStrategy

Return the retry strategy for this error.

pub fn get_suggestion(&self) -> Option<String>

Get a suggestion for resolving this error, if available.

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