Enum BudgetError 

#[non_exhaustive]
pub enum BudgetError {
    AgentExhausted {
        agent_id: String,
        spent: f64,
        limit: f64,
    },
    TaskExhausted {
        task_id: String,
        spent: f64,
        limit: f64,
    },
    SessionExhausted {
        session_id: String,
        spent: f64,
        limit: f64,
    },
    FleetExhausted {
        spent: f64,
        limit: f64,
    },
    KillSwitchActivated {
        agent_id: String,
        reason: String,
    },
    ModelDowngraded {
        from: ModelTier,
        to: ModelTier,
        remaining: f64,
    },
    NoFallbackAvailable {
        from: ModelTier,
    },
    AllocationFailed {
        agent_id: String,
        requested: f64,
        available: f64,
    },
    ReallocationFailed {
        from: String,
        to: String,
        amount: f64,
        available: f64,
    },
    UnknownAgent(String),
    PersistenceError(String),
    InvalidConfig(String),
    UnknownModel(String),
    RateLimited {
        retry_after_ms: u64,
    },
    Tokenizer(String),
}

Every error this crate returns.

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.

AgentExhausted

The agent has exhausted its per-agent spend limit.

Fields

agent_id: String

Agent name.

spent: f64

Spent so far, in USD.

limit: f64

The cap, in USD.

TaskExhausted

A task-scoped budget envelope has been depleted.

Fields

task_id: String

Task name.

spent: f64

Spent so far, in USD.

limit: f64

The cap, in USD.

SessionExhausted

A session-scoped budget envelope has been depleted.

Fields

session_id: String

Session name.

spent: f64

Spent so far, in USD.

limit: f64

The cap, in USD.

FleetExhausted

The fleet-wide budget cap has been reached.

Fields

spent: f64

Spent so far, in USD.

limit: f64

The cap, in USD.

KillSwitchActivated

The kill switch was triggered; execution must halt.

Fields

agent_id: String

Agent name.

reason: String

Why the switch was flipped.

ModelDowngraded

A model downgrade was required due to budget pressure.

Fields

from: ModelTier

Tier or agent moved from.

to: ModelTier

Tier or agent moved to.

remaining: f64

Budget left, in USD.

NoFallbackAvailable

No lower-cost model is available for downgrade.

Fields

from: ModelTier

Tier or agent moved from.

AllocationFailed

Budget allocation failed: requested amount exceeds available fleet budget.

Fields

agent_id: String

Agent name.

requested: f64

Amount asked for, in USD.

available: f64

Amount actually available, in USD.

ReallocationFailed

Reallocation failed because the source agent has insufficient budget.

Fields

from: String

Tier or agent moved from.

to: String

Tier or agent moved to.

amount: f64

Amount to move, in USD.

available: f64

Amount actually available, in USD.

UnknownAgent(String)

Agent ID not found in the fleet registry.

PersistenceError(String)

Persistence I/O failure.

InvalidConfig(String)

Invalid configuration (e.g. negative limit).

UnknownModel(String)

The model is not in the price table, so its cost cannot be computed.

RateLimited

A tokens-per-minute or requests-per-minute limit would be crossed (feature ratelimit).

Fields

retry_after_ms: u64

How long to wait before the call can pass, in milliseconds.

Tokenizer(String)

The tokenizer could not be loaded or used (feature tokens).

Trait Implementations

impl Clone for BudgetError

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for BudgetError

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

Formats the value using the given formatter.

impl Display for BudgetError

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

Formats the value using the given formatter.

impl Error for BudgetError

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 PartialEq for BudgetError

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for BudgetError