Struct ModelFailure 

pub struct ModelFailure { /* private fields */ }

Provider-neutral terminal model failure.

Implementations

impl ModelFailure

pub fn internal_adapter_failure() -> Self

Creates a fixed internal adapter failure.

pub fn new( code: ModelFailureCode, message: impl Into<String>, retry: RetryClass, ) -> Result<Self, ModelStreamValueError>

Creates a bounded technical failure without an internal source chain.

Errors

Returns an error when message is empty, exceeds 4 KiB, or contains a null character.

pub fn safe( code: ModelFailureCode, message: impl Into<String>, retry: RetryClass, ) -> Result<Self, ModelStreamValueError>

Creates a provider failure whose message was normalized for display.

The caller must have removed provider payload fields, bounded the text, and stripped terminal control characters before using this constructor.

Errors

Returns an error when the normalized message violates the model failure bounds.

pub fn with_metadata(self, metadata: ProtocolMetadata) -> Self

Adds bounded namespaced safe metadata.

pub fn with_retry_after(self, retry_after: Duration) -> Self

Adds a provider-requested delay before this failure is retried.

pub const fn code(&self) -> ModelFailureCode

Returns the stable failure code.

pub fn message(&self) -> &str

Returns the English technical message.

pub const fn retry(&self) -> RetryClass

Returns the retry classification.

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

Returns the provider-requested retry delay when one was supplied.

pub const fn metadata(&self) -> &ProtocolMetadata

Returns safe namespaced metadata.

pub const fn is_safe_diagnostic(&self) -> bool

Returns whether the message is safe to expose as provider diagnostics.

Trait Implementations

impl Clone for ModelFailure

fn clone(&self) -> ModelFailure

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ModelFailure

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

Formats the value using the given formatter.

impl PartialEq for ModelFailure

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for ModelFailure