Struct Budget 

pub struct Budget {
    pub max_input_tokens: Option<u64>,
    pub max_output_tokens: Option<u64>,
    pub max_total_tokens: Option<u64>,
    pub max_tool_calls: Option<u32>,
    pub max_wall_time_ms: Option<u64>,
    pub max_cost_cents: Option<u64>,
}

Budget limits for a run

Fields

max_input_tokens: Option<u64>

Maximum input tokens allowed

max_output_tokens: Option<u64>

Maximum output tokens allowed

max_total_tokens: Option<u64>

Maximum total tokens (input + output)

max_tool_calls: Option<u32>

Maximum number of tool calls

max_wall_time_ms: Option<u64>

Maximum wall time in milliseconds

max_cost_cents: Option<u64>

Maximum cost in cents (USD)

Implementations

impl Budget

pub fn has_cost_headroom( &self, usage: &BudgetUsage, additional_cents: u64, ) -> bool

Whether spending additional_cents on top of the current usage would still fit under the cost cap. true when no cost cap is configured.

Used by the reversibility ladder’s R2 rung: a Costly tool call is allowed under budget while this returns true, and escalates to an approval gate once it returns false.

pub fn cost_remaining_cents(&self, usage: &BudgetUsage) -> Option<u64>

Cost headroom remaining under the cap, in cents. None when no cost cap is configured (unbounded). Saturates at 0 once the cap is met/exceeded.

Emitted as ferrumdeck.budget_remaining on the enforcement-decision GenAI span (see fd_otel::decision) so an operator can see how close a run was to the budget circuit breaker at the moment of each decision.

Trait Implementations

impl Clone for Budget

fn clone(&self) -> Budget

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Budget

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

Formats the value using the given formatter.

impl Default for Budget

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Budget

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for Budget

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.