Struct Budgets 

pub struct Budgets {
    pub max_steps: Option<u64>,
    pub max_tokens: Option<u64>,
    pub max_cost_usd: Option<f64>,
    pub max_wall_time: Option<Duration>,
}

The limits an agent declares. Every dimension is optional; an absent dimension is never checked.

Fields

max_steps: Option<u64>

Maximum loop iterations, counted as completed model calls.

max_tokens: Option<u64>

Maximum total recorded tokens (input plus output) across the run.

max_cost_usd: Option<f64>

Maximum cost in US dollars, computed from recorded usage and the agent’s Pricing. Declaring this without pricing is a build-time error on the agent builder.

max_wall_time: Option<Duration>

Maximum wall time, measured between recorded ctx.now() observations, never against the ambient clock.

Implementations

impl Budgets

pub fn any_declared(&self) -> bool

Whether any dimension is declared at all.

pub fn first_crossing( &self, extensions: &BudgetExtensions, pricing: Option<&Pricing>, observations: &BudgetObservations, ) -> Option<(Budget, f64)>

The first crossing, if any, in the fixed check order (steps, tokens, cost, wall time). Returns the crossed Budget (whose limit is the effective limit: declared plus extensions) and the observed value, both exactly as they will be recorded.

Trait Implementations

impl Clone for Budgets

fn clone(&self) -> Budgets

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Budgets

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

Formats the value using the given formatter.

impl Default for Budgets

fn default() -> Budgets

Returns the “default value” for a type.

impl PartialEq for Budgets

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for Budgets