Struct WireError 

pub struct WireError {
    pub kind: WireErrorKind,
    pub message: String,
    pub provider: Option<ProviderKind>,
    pub retryable: bool,
}

A serializable projection of the crate’s Error.

Error cannot cross a wire: it wraps reqwest::Error and serde_json::Error, neither of which is Serialize. WireError keeps the parts a remote client can act on — the category, a human-readable message, the provider, and whether a retry might help — and drops the rest.

The conversion is deliberately one-way. Rebuilding a reqwest::Error from JSON is not possible, so a client matches on kind rather than on the original error variant.

Examples

use rai_sdk::{Error, ProviderKind};
use rai_sdk::wire::{WireError, WireErrorKind};

let error = Error::RateLimit {
    provider: ProviderKind::OpenAI,
    message: "slow down".to_string(),
};

let wire = WireError::from(&error);
assert_eq!(wire.kind, WireErrorKind::RateLimit);
assert_eq!(wire.provider, Some(ProviderKind::OpenAI));
assert!(wire.retryable);

Fields

kind: WireErrorKind

Error category, mirroring Error::kind_str.

message: String

Human-readable description, from the original error’s Display.

provider: Option<ProviderKind>

Provider the failure came from, when the error names one.

retryable: bool

Whether retrying the request might succeed, from Error::is_retryable.

Implementations

impl WireError

pub fn new(kind: WireErrorKind, message: impl Into<String>) -> Self

Build an error of kind with message, with no provider and not retryable.

Use this for failures a proxy raises itself — a truncated upstream, a rejected protocol version — that have no Error behind them.

Trait Implementations

impl Clone for WireError

fn clone(&self) -> WireError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for WireError

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for WireError

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for WireError

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

Formats the value using the given formatter.

impl Eq for WireError

impl Error for WireError

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 WireError

fn from(error: &Error) -> Self

Converts to this type from the input type.

impl PartialEq for WireError

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for WireError

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 WireError