Enum Error 

pub enum Error {
    Protocol(ProtocolError),
    Pipeline(PipelineError),
    Configuration {
        message: String,
        context: ErrorContext,
    },
    Validation {
        message: String,
        context: ErrorContext,
    },
    Runtime {
        message: String,
        context: ErrorContext,
    },
    Transport(TransportError),
    Io(Error),
    Serialization(Error),
    Remote {
        status: u16,
        class: String,
        message: String,
        retryable: bool,
        fallbackable: bool,
        retry_after_ms: Option<u32>,
        context: Option<ErrorContext>,
    },
    Unknown {
        message: String,
        context: ErrorContext,
    },
}

Unified error type for the AI-Protocol Runtime This aggregates all low-level errors into actionable, high-level categories

Variants

Protocol(ProtocolError)

Pipeline(PipelineError)

Configuration

Fields

message: String

context: ErrorContext

Validation

Fields

message: String

context: ErrorContext

Runtime

Fields

message: String

context: ErrorContext

Transport(TransportError)

Io(Error)

Serialization(Error)

Remote

Fields

status: u16

class: String

message: String

retryable: bool

fallbackable: bool

retry_after_ms: Option<u32>

context: Option<ErrorContext>

Unknown

Fields

message: String

context: ErrorContext

Implementations

impl Error

pub fn runtime_with_context( msg: impl Into<String>, context: ErrorContext, ) -> Self

Create a new runtime error with structured context

pub fn validation_with_context( msg: impl Into<String>, context: ErrorContext, ) -> Self

Create a new validation error with structured context

pub fn configuration_with_context( msg: impl Into<String>, context: ErrorContext, ) -> Self

Create a new configuration error with structured context

pub fn unknown_with_context( msg: impl Into<String>, context: ErrorContext, ) -> Self

Create a new unknown error with structured context

pub fn validation(msg: impl Into<String>) -> Self

Create a simple validation error

pub fn configuration(msg: impl Into<String>) -> Self

Create a simple configuration error

pub fn network_with_context( msg: impl Into<String>, context: ErrorContext, ) -> Self

Create a network error with context

pub fn api_with_context(msg: impl Into<String>, context: ErrorContext) -> Self

Create an API error with context

pub fn parsing(msg: impl Into<String>) -> Self

Create a parsing error

pub fn context(&self) -> Option<&ErrorContext>

Extract error context if available

pub fn is_retryable(&self) -> bool

Returns whether this error is retryable.

Checks Remote.retryable, context.retryable, and standard_code().retryable() in order of precedence.

pub fn retry_after(&self) -> Option<Duration>

Returns the suggested retry delay when available.

For Remote errors, converts retry_after_ms to Duration.

pub fn error_code(&self) -> Option<StandardErrorCode>

Returns the AI-Protocol V2 standard error code when available.

Alias for standard_code for convenience.

pub fn standard_code(&self) -> Option<StandardErrorCode>

Returns the AI-Protocol V2 standard error code when available.

For Remote errors, derives the code from the error class if not set in context. Other variants return the standard code from their ErrorContext when present.

pub fn with_context(self, new_ctx: ErrorContext) -> Self

Attach or update context to the error

Trait Implementations

impl Debug for Error

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

Formats the value using the given formatter.

impl Display for Error

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

Formats the value using the given formatter.

impl Error for Error

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<Error> for Error

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for Error

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<PipelineError> for Error

fn from(source: PipelineError) -> Self

Converts to this type from the input type.

impl From<ProtocolError> for Error

fn from(source: ProtocolError) -> Self

Converts to this type from the input type.

impl From<TransportError> for Error

fn from(source: TransportError) -> Self

Converts to this type from the input type.