Skip to main content

FailureClass

auth_cloudflare::health

Enum FailureClass

pub enum FailureClass {
Show 26 variants    AuthMissing,
    AuthRejected,
    AccountNotFound,
    ModelUnavailable,
    UnsupportedParameter,
    ContextLimitExceeded,
    ConnectTimeout,
    ReadTimeout,
    StreamIdleTimeout,
    ConnectionReset,
    TlsFailure,
    RateLimited,
    ProviderServerError,
    CloudflareEdgeError,
    EmptyCompletion,
    TruncatedCompletion,
    InvalidJson,
    InvalidChatCompletionShape,
    InvalidSseEvent,
    MissingFinishReason,
    NoToolCall,
    InvalidToolName,
    InvalidToolArguments,
    DuplicateToolCall,
    ToolLoopDidNotConverge,
    Unknown,
}

Expand description

Typed delivery-failure taxonomy (feedback 02).

Every failure recorded for a Cloudflare Workers AI model must map to exactly one class. Unknown is the last resort for classes not yet in the taxonomy - never guess a specific class without evidence.

Variants§

AuthMissing

Credentials could not be resolved (missing env var or empty token).

AuthRejected

Cloudflare rejected the presented credentials (401).

AccountNotFound

The configured account could not be found or is out of scope.

ModelUnavailable

The requested model is not available on this account or route.

UnsupportedParameter

A request parameter is not supported by the model or endpoint.

ContextLimitExceeded

The context window was exceeded by the request.

ConnectTimeout

Connection establishment timed out.

ReadTimeout

The upstream did not respond within the read timeout.

StreamIdleTimeout

The stream produced no event within the idle timeout.

ConnectionReset

The connection was reset mid-request or mid-stream.

TlsFailure

TLS handshake or certificate failure.

RateLimited

Cloudflare rate-limited the request (429).

ProviderServerError

The provider returned a 5xx error.

CloudflareEdgeError

Cloudflare edge error envelope (cf-ray present, success: false).

EmptyCompletion

The completion was delivered with empty content.

TruncatedCompletion

The completion was cut off before a terminal state.

InvalidJson

The response body was not valid JSON.

InvalidChatCompletionShape

The JSON did not match the Chat Completions shape.

InvalidSseEvent

An SSE event was malformed.

MissingFinishReason

A terminal chunk was missing its finish reason.

NoToolCall

The model answered without issuing the required tool call.

InvalidToolName

The tool call named an unknown or disallowed tool.

InvalidToolArguments

The tool-call arguments were not valid JSON for the schema.

DuplicateToolCall

The same tool call was issued more than once.

ToolLoopDidNotConverge

The multi-turn tool loop did not converge to a final answer.

Unknown

Failure class not yet classified - never guess a specific class.

Trait Implementations§

impl Clone for FailureClass

fn clone(&self) -> FailureClass

Returns a duplicate of the value. Read more

1.0.0 (const: unstable) · Source§

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

Performs copy-assignment from source. Read more

impl Copy for FailureClass

impl Debug for FailureClass

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

Formats the value using the given formatter. Read more

impl<'de> Deserialize<'de> for FailureClass

fn deserialize<D>(deserializer: D) -> Result<Self, D::Error>
where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer. Read more

impl Eq for FailureClass

impl PartialEq for FailureClass

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

Equality operator ==. Read more

1.0.0 (const: unstable) · Source§

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

Inequality operator !=. Read more

impl Serialize for FailureClass

fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error>
where S: Serializer,

Serialize this value into the given Serde serializer. Read more

impl StructuralPartialEq for FailureClass

Auto Trait Implementations§

impl Freeze for FailureClass

impl RefUnwindSafe for FailureClass

impl Send for FailureClass

impl Sync for FailureClass

impl Unpin for FailureClass

impl UnsafeUnpin for FailureClass

impl UnwindSafe for FailureClass

Blanket Implementations§

impl<T> Any for T
where T: 'static + ?Sized,

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more

impl<T> Borrow<T> for T
where T: ?Sized,

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more

impl<T> BorrowMut<T> for T
where T: ?Sized,

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more

impl<T> CloneToUninit for T
where T: Clone,

unsafe fn clone_to_uninit(&self, dest: *mut u8)

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

Performs copy-assignment from self to dest. Read more

impl<T> DeserializeOwned for T
where T: for<'de> Deserialize<'de>,

impl<Q, K> Equivalent<K> for Q
where Q: Eq + ?Sized, K: Borrow<Q> + ?Sized,

fn equivalent(&self, key: &K) -> bool

Checks if this value is equivalent to the given key. Read more

impl<Q, K> Equivalent<K> for Q
where Q: Eq + ?Sized, K: Borrow<Q> + ?Sized,

fn equivalent(&self, key: &K) -> bool

Compare self to key and return true if they are equal.

impl<T> From<T> for T

fn from(t: T) -> T

Returns the argument unchanged.

impl<T, U> Into<U> for T
where U: From<T>,

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

impl<T> ToOwned for T
where T: Clone,

type Owned = T

The resulting type after obtaining ownership.

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more

impl<T, U> TryFrom<U> for T
where U: Into<T>,

type Error = !

The type returned in the event of a conversion error.

fn try_from(value: U) -> Result<T, !>

Performs the conversion.

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.