Enum AiError 

pub enum AiError {
    Network(String),
    Auth(String),
    Timeout(String),
    RateLimited(String),
    BudgetExceeded(String),
    ProviderError(String),
    Unavailable(String),
    InvalidResponse(String),
}

Errors produced by an AiProvider call.

The variants capture the categories the codegen pipeline distinguishes between when deciding whether to retry, fall back, or surface the failure. They are intentionally transport-agnostic — concrete HTTP status codes or SDK errors should be mapped into one of these.

Variants

Network(String)

Transport-level failure reaching the provider (DNS, connect, TLS, read/write errors). Safe to retry.

Auth(String)

Authentication failed — bad API key, missing credential, revoked token. Not retryable without re-configuring.

Timeout(String)

The request did not complete within the configured timeout.

RateLimited(String)

The provider returned a rate-limit response (HTTP 429 or equivalent). Callers may retry with backoff.

BudgetExceeded(String)

The configured cost or token budget has been exhausted. Not retryable until the budget is replenished.

ProviderError(String)

The provider returned an error response that does not fit a more specific variant (5xx, provider-side validation, model error).

Unavailable(String)

The provider is temporarily unavailable — compiler should fall back to Tier 2 rule-based generation if deterministic_fallback is set.

InvalidResponse(String)

The provider returned a response that failed structural validation — for example, a select() response whose selected_id was not in the provided option set (see [validate_select_response]).

Trait Implementations

impl Clone for AiError

fn clone(&self) -> AiError

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, __formatter: &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.