Enum StandardErrorCode 

pub enum StandardErrorCode {
    InvalidRequest,
    Authentication,
    PermissionDenied,
    NotFound,
    RequestTooLarge,
    RateLimited,
    QuotaExhausted,
    ServerError,
    Overloaded,
    Timeout,
    Conflict,
    Cancelled,
    Unknown,
}

Standard AI-Protocol V2 error code.

Each variant corresponds to a canonical error from the specification, with associated metadata: code string, name, retryable, and fallbackable flags.

Variants

InvalidRequest

E1001: Malformed request, invalid parameters, or missing required fields

Authentication

E1002: Invalid, expired, or missing API key

PermissionDenied

E1003: Valid credentials but insufficient permissions

NotFound

E1004: Requested model, endpoint, or resource does not exist

RequestTooLarge

E1005: Input exceeds context window or API payload size limit

RateLimited

E2001: Request rate limit exceeded

QuotaExhausted

E2002: Account usage quota or billing limit reached

ServerError

E3001: Internal server error on provider side

Overloaded

E3002: Provider service temporarily overloaded

Timeout

E3003: Request timed out before response received

Conflict

E4001: State conflict (e.g., concurrent modification)

Cancelled

E4002: Request was cancelled by the client

Unknown

E9999: Error could not be classified

Implementations

impl StandardErrorCode

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

Returns the canonical code string (e.g., "E1001").

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

Returns the standard name (e.g., "invalid_request").

pub fn retryable(&self) -> bool

Returns whether this error is retryable by default.

pub fn fallbackable(&self) -> bool

Returns whether this error should trigger a fallback to another provider.

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

Returns the category: "client", "rate", "server", "operational", or "unknown".

pub fn from_provider_code(provider_code: &str) -> Option<Self>

Maps a provider error code/type string to the corresponding StandardErrorCode.

Supports both standard names (e.g., "invalid_request") and provider-specific aliases such as "invalid_api_key", "context_length_exceeded", "overloaded_error".

pub fn from_error_class(error_class: &str) -> Self

Maps an error class name string to the corresponding StandardErrorCode.

The class name should match the standard names (e.g., "invalid_request"). Aliases such as "authorized_error" (→ authentication) are supported. Unknown class names map to StandardErrorCode::Unknown.

pub fn from_http_status(status: u16) -> Self

Maps an HTTP status code to the most likely StandardErrorCode.

Multiple status codes can map to the same error (e.g., 429 → rate_limited). Status codes without a standard mapping return StandardErrorCode::Unknown.

Trait Implementations

impl Clone for StandardErrorCode

fn clone(&self) -> StandardErrorCode

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for StandardErrorCode

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

Formats the value using the given formatter.

impl Display for StandardErrorCode

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

Formats the value using the given formatter.

impl Hash for StandardErrorCode

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 StandardErrorCode

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

impl Eq for StandardErrorCode

impl StructuralPartialEq for StandardErrorCode