Struct ProviderError 

pub struct ProviderError {
    pub kind: ProviderErrorKind,
    pub request_id: Option<String>,
}

A unified error for provider operation failures.

The top-level struct separates cross-cutting diagnostic information (e.g. request_id) from classification information (kind) to avoid duplicating request_id in every variant.

Fields

kind: ProviderErrorKind

request_id: Option<String>

The request ID returned by the server (e.g. Anthropic request-id header / OpenAI x-request-id). This is the primary signal for debugging; populate it whenever possible.

Implementations

impl ProviderError

pub fn new(kind: ProviderErrorKind) -> Self

pub fn with_request_id(self, request_id: impl Into<String>) -> Self

pub fn retry_hint(&self) -> RetryHint

Returns a retry hint for this error.

pub fn is_retryable(&self) -> bool

Convenience check: whether the agent should automatically retry.

Trait Implementations

impl Debug for ProviderError

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

Formats the value using the given formatter.

impl Display for ProviderError

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

Formats the value using the given formatter.

impl Error for ProviderError

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<ProviderError> for TurnError

fn from(source: ProviderError) -> Self

Converts to this type from the input type.