Enum AiError 

pub enum AiError {
    Http {
        status: Option<u16>,
        message: String,
    },
    Sse {
        message: String,
    },
    Auth {
        message: String,
    },
    Abort {
        message: String,
    },
    Schema {
        message: String,
    },
    Provider {
        code: String,
        message: String,
    },
    Usage {
        message: String,
    },
}

Every failure mode the pi-ai crate can surface.

Variants

Http

HTTP transport failure (connection, DNS, TLS, non-retryable status).

Fields

status: Option<u16>

message: String

Sse

SSE parse / stream-corruption failure.

Fields

message: String

Auth

Auth failure (401/403, missing/expired key).

Fields

message: String

Abort

Operation cancelled via CancellationToken.

Fields

message: String

Schema

JSON-Schema validation of tool arguments failed (after coercion).

Fields

message: String

Provider

Provider returned a structured error body.

Fields

code: String

message: String

Usage

Usage / cost computation failed (malformed provider usage payload).

Fields

message: String

Implementations

impl AiError

pub fn is_abort(&self) -> bool

True if this error originated from cancellation (not a provider fault).

pub fn is_retryable(&self) -> bool

True if retryable under retry_provider_request — matches the TS retry predicate (408/409/429/>=500 plus transport-level Http with no status).

Trait Implementations

impl Clone for AiError

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AiError

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

Formats the value using the given formatter.

impl Display for AiError

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

Formats the value using the given formatter.

impl Error for AiError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl From<&AiError> for ProviderRequestError

fn from(err: &AiError) -> Self

Best-effort projection from an AiError. Only Http carries the status the retry predicate needs; Abort is not retryable.

impl PartialEq for AiError

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for AiError