Enum ErrorCategory 

pub enum ErrorCategory {
    Network,
    Timeout,
    RateLimit,
    ServiceUnavailable,
    CircuitOpen,
    Authentication,
    InvalidParameters,
    ToolNotFound,
    ResourceNotFound,
    PermissionDenied,
    PolicyViolation,
    PlanModeViolation,
    SandboxFailure,
    ResourceExhausted,
    Cancelled,
    ExecutionError,
}

Canonical error category used throughout VT Code for consistent retry decisions, user-facing messages, and error handling strategies.

Variants

Network

Network connectivity issue (connection reset, DNS failure, etc.)

Timeout

Request timed out or deadline exceeded

RateLimit

Rate limit exceeded (HTTP 429, provider throttling)

ServiceUnavailable

External service temporarily unavailable (HTTP 5xx)

CircuitOpen

Circuit breaker is open for this tool/service

Authentication

Authentication or authorization failure (invalid API key, expired token)

InvalidParameters

Invalid parameters, arguments, or schema validation failure

ToolNotFound

Tool not found or unavailable

ResourceNotFound

Resource not found (file, directory, path does not exist)

PermissionDenied

OS-level permission denied (file permissions, EACCES, EPERM)

PolicyViolation

Policy violation (workspace boundary, tool deny policy, safety gate)

PlanModeViolation

Plan mode violation (mutating tool in read-only mode)

SandboxFailure

Sandbox execution failure

ResourceExhausted

Resource exhausted (quota, billing, spending limit, disk, memory)

Cancelled

User cancelled the operation

ExecutionError

General execution error (catch-all for unclassified failures)

Implementations

impl ErrorCategory

pub const fn is_retryable(&self) -> bool

Whether this error category is safe to retry.

pub const fn should_trip_circuit_breaker(&self) -> bool

Whether this category should count toward circuit breaker transitions.

pub const fn is_llm_mistake(&self) -> bool

Whether this error is an LLM argument mistake (should not count toward circuit breaker thresholds).

pub const fn is_permanent(&self) -> bool

Whether this error represents a permanent, non-recoverable condition.

pub fn retryability(&self) -> Retryability

Get the recommended retryability for this error category.

pub fn recovery_suggestions(&self) -> Vec<Cow<'static, str>>

Get recovery suggestions for this error category. Returns static strings to avoid allocation.

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

Get a concise, user-friendly label for this error category.

Trait Implementations

impl Clone for ErrorCategory

fn clone(&self) -> ErrorCategory

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for ErrorCategory

impl Debug for ErrorCategory

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ErrorCategory

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for ErrorCategory

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

Formats the value using the given formatter.

impl Eq for ErrorCategory

impl From<&LLMError> for ErrorCategory

fn from(err: &LLMError) -> Self

Converts to this type from the input type.

impl Hash for ErrorCategory

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 ErrorCategory

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

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 ErrorCategory