Enum Error 

pub enum Error {
    Config(String),
    Provider {
        status: Option<u16>,
        message: String,
    },
    Unsupported,
    LowConfidence {
        best_guess: Value,
        confidence: f64,
    },
    Deserialization(String),
    SchemaError(String),
    ToolIterationLimit(u32),
    ToolNotFound(String),
    Timeout,
    StoreError(String),
    Sqlx(String),
}

Errors that can occur in ferro-ai operations.

Variants

Config(String)

Configuration error (missing env var or invalid value).

Provider

HTTP provider error with optional status code for retry logic.

The message field carries only provider response text. It MUST NOT contain the API key or auth header.

Fields

status: Option<u16>

HTTP status code if the failure carried one. Network errors have None.

message: String

Provider-supplied error message. Must not contain the API key or auth header.

Unsupported

This provider does not implement the requested capability.

Returned by capability methods a provider lacks (e.g. AnthropicClient::embed()). Never panics — callers check for this variant to implement fallback behavior.

LowConfidence

Classification returned confidence below the configured threshold.

Fields

best_guess: Value

The best guess returned by the provider.

confidence: f64

The confidence score (0.0–1.0).

Deserialization(String)

Failed to deserialize the provider response into the target type.

SchemaError(String)

Schema normalization failed (malformed schemars output or unexpected structure).

ToolIterationLimit(u32)

Tool dispatch loop exceeded the configured max_iterations without finishing.

ToolNotFound(String)

A tool name referenced in a provider response is not registered.

Not currently constructed by ToolRegistry::dispatch. The dispatch loop intentionally surfaces unknown tool names to the LLM as a [ToolError] message (model-recoverable, per D-13/SC#6) rather than aborting the loop. This variant is reserved for future direct-dispatch helpers (e.g. a dispatch_single that calls one tool by name and must distinguish “not registered” from handler errors). Callers pattern-matching on Error should not expect this variant to be reachable from dispatch in the current implementation.

Timeout

Request timed out after all retries were exhausted.

StoreError(String)

Confirmation store operation failed.

Sqlx(String)

sqlx database error from the pgvector store.

Only reachable when the pgvector feature is enabled and PgVectorStore::store or PgVectorStore::nearest is called. The message is sqlx::Error::to_string() — it does not contain embedding data (f32 arrays are not included in sqlx error messages).

Implementations

impl Error

pub fn is_retryable(&self) -> bool

Returns true for errors that should trigger a retry.

Permanent HTTP errors (400, 401, 403, 404, 422) are not retried. Transient errors (429, 500, 503, 529) and network errors (status: None) are retried. All non-Provider variants (including Unsupported and Timeout) return false.

Trait Implementations

impl Debug for Error

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

Formats the value using the given formatter.

impl Display for Error

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

Formats the value using the given formatter.

impl Error for Error

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.