Enum AgentErrorKind 

pub enum AgentErrorKind {
    RateLimited,
    TokenExhausted,
    ApiUnavailable,
    NetworkError,
    AuthFailure,
    CommandNotFound,
    DiskFull,
    ProcessKilled,
    InvalidResponse,
    Timeout,
    ToolExecutionFailed,
    AgentSpecificQuirk,
    RetryableAgentQuirk,
    Transient,
    Permanent,
}

Error classification for agent failures.

Used to determine appropriate recovery strategy when an agent fails:

• should_retry() - Try same agent again after delay
• should_fallback() - Switch to next agent in the chain
• is_unrecoverable() - Abort the pipeline

Variants

RateLimited

API rate limit exceeded - retry after delay.

TokenExhausted

Token/context limit exceeded - may need different agent.

ApiUnavailable

API temporarily unavailable (server-side issue) - retry.

NetworkError

Network connectivity issue (client-side) - retry.

AuthFailure

Authentication failure - switch agent.

CommandNotFound

Command not found - switch agent.

DiskFull

Disk space exhausted - cannot continue.

ProcessKilled

Process killed (OOM, signal) - may retry with smaller context.

InvalidResponse

Invalid JSON response from agent - may retry.

Timeout

Request/response timeout - retry.

ToolExecutionFailed

Tool execution failed - should fallback (e.g., file write issues).

AgentSpecificQuirk

Known agent-specific behavioral quirk - should fallback with specific advice.

RetryableAgentQuirk

Agent-specific issue that may be transient - should retry before falling back.

Transient

Other transient error - retry.

Permanent

Permanent failure - do not retry.

Implementations

impl AgentErrorKind

pub const fn should_retry(self) -> bool

Determine if this error should trigger a retry.

pub const fn should_fallback(self) -> bool

Determine if this error should trigger a fallback to another agent.

pub const fn is_unrecoverable(self) -> bool

Determine if this error is unrecoverable (should abort).

pub const fn is_command_not_found(self) -> bool

Check if this is a command not found error.

pub const fn is_network_error(self) -> bool

Check if this is a network-related error.

pub const fn suggests_smaller_context(self) -> bool

Check if this error might be resolved by reducing context size.

pub const fn suggested_wait_ms(self) -> u64

Get suggested wait time in milliseconds before retry.

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

Get a user-friendly description of this error type.

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

Get recovery advice for this error type.

pub fn classify_with_agent( exit_code: i32, stderr: &str, agent_name: Option<&str>, model_flag: Option<&str>, ) -> Self

Classify an error from exit code, output, and agent name.

This variant takes the agent name into account for better classification. Some agents have known failure patterns that should trigger fallback instead of retry, even when the stderr output is generic.

Arguments

• exit_code - The process exit code
• stderr - The standard error output from the agent
• agent_name - Optional agent name for context-aware classification

Trait Implementations

impl Clone for AgentErrorKind

fn clone(&self) -> AgentErrorKind

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AgentErrorKind

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

Formats the value using the given formatter.

impl PartialEq for AgentErrorKind

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

impl Eq for AgentErrorKind

impl StructuralPartialEq for AgentErrorKind