Enum BudgetDecision 

pub enum BudgetDecision {
    Allow,
    SoftLimit {
        resource: String,
        consumed: f64,
        limit: f64,
        message: Option<String>,
    },
    Deny {
        resource: String,
        reason: String,
    },
}

Outcome of a budget check.

The framework treats this purely as a decision — it never inspects the carried strings except to forward them to AgentEvents and to the eventual error.

Variants

Allow

Operation proceeds normally. No event is emitted.

SoftLimit

Operation proceeds, but the framework emits a AgentEvent::BudgetThresholdHit { kind: "soft", .. } event before continuing. In-session hooks can react (e.g. trigger auto-compact, swap to a cheaper model on next turn).

Fields

resource: String

Logical resource label (“llm_tokens”, “usd_cost”, “wall_time”, …).

consumed: f64

Current consumed amount (units depend on resource).

limit: f64

Threshold that was crossed.

message: Option<String>

Optional human-readable explanation for logs / UI.

Deny

Operation is refused. The framework returns CodeError::BudgetExhausted from the LLM / tool entry point. The session itself stays open — callers can re-try later or after the host has re-allocated budget.

Fields

resource: String

Logical resource label that exhausted.

reason: String

Human-readable reason surfaced in the error and in any emitted BudgetThresholdHit { kind: "hard", .. } event.

Trait Implementations

impl Clone for BudgetDecision

fn clone(&self) -> BudgetDecision

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for BudgetDecision

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

Formats the value using the given formatter.