Enum DaimonError 

#[non_exhaustive]
pub enum DaimonError {
    Model(String),
    ToolExecution {
        tool: String,
        message: String,
    },
    ToolNotFound(String),
    DuplicateTool(String),
    Builder(String),
    MaxIterations(usize),
    Serialization(Error),
    SchemaValidation {
        tool: String,
        errors: String,
    },
    StreamClosed,
    Timeout(Duration),
    Cancelled,
    Orchestration(String),
    Mcp(String),
    BudgetExceeded {
        spent: f64,
        limit: f64,
    },
    GuardrailBlocked(String),
    Storage {
        message: String,
        transient: bool,
    },
    Other(String),
}

The central error type for all Daimon operations.

Provider crates should map their transport-specific errors (HTTP, gRPC, SDK) to DaimonError::Model.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Model(String)

An error originating from a model provider (API error, bad response, etc.).

ToolExecution

A tool failed during execution.

Fields

tool: String

Name of the tool that failed.

message: String

Description of the failure.

ToolNotFound(String)

The requested tool was not found in the registry.

DuplicateTool(String)

Attempted to register a tool with a name that already exists.

Builder(String)

The agent builder failed validation (e.g. missing required model).

MaxIterations(usize)

The agent exceeded the configured maximum number of iterations.

Serialization(Error)

A serialization or deserialization error.

SchemaValidation

Tool input failed JSON Schema validation.

Fields

tool: String

Name of the tool whose input failed validation.

errors: String

Human-readable description of validation errors.

StreamClosed

A stream was closed before completing.

Timeout(Duration)

A request timed out.

Cancelled

The operation was cancelled via a cancellation token.

Orchestration(String)

An orchestration error (chain or graph execution failure).

Mcp(String)

An MCP protocol error.

BudgetExceeded

The agent exceeded the configured spending budget.

Fields

spent: f64

How much has been spent so far (USD).

limit: f64

The configured limit (USD).

GuardrailBlocked(String)

An input or output guardrail blocked the request.

Storage

A storage backend operation failed (checkpoint store, memory backend, broker state, or another persistence layer).

transient distinguishes failures that may succeed on retry (connection refused, timeout, I/O contention) from permanent ones (corrupt data, invalid keys, misconfiguration), so callers can decide whether retrying is worthwhile without string-matching the message.

Fields

message: String

Description of the storage failure.

transient: bool

true when retrying the operation may succeed.

Other(String)

A catch-all for other errors.

Implementations

impl DaimonError

pub fn storage(message: impl Into<String>) -> Self

Creates a permanent (non-retryable) DaimonError::Storage error, e.g. corrupt persisted data or an invalid storage key.

pub fn storage_transient(message: impl Into<String>) -> Self

Creates a transient (retryable) DaimonError::Storage error, e.g. a connection failure, timeout, or I/O error.

Trait Implementations

impl Debug for DaimonError

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

Formats the value using the given formatter.

impl Display for DaimonError

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

Formats the value using the given formatter.

impl Error for DaimonError

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<Error> for DaimonError

fn from(source: Error) -> Self

Converts to this type from the input type.