Struct TurnBudget 

pub struct TurnBudget {
    pub max_provider_rounds: u32,
    pub max_tool_calls: u32,
    pub max_elapsed: Option<Duration>,
    pub max_accumulated_tool_result_bytes: usize,
    pub max_context_tokens: Option<u64>,
    pub max_cost_usd: Option<f64>,
    pub max_round_renewals: u32,
}

Per-turn limits (spec §8.1).

Fields

max_provider_rounds: u32

max_tool_calls: u32

max_elapsed: Option<Duration>

Wall-clock limit for one turn. None (the default for every role) means no limit: a turn that is still making progress is never cut off for taking long. Opt in with turn_budget.<role>.max_elapsed_secs or /budget time. Rounds, tool calls and tool-result bytes stay bounded.

max_accumulated_tool_result_bytes: usize

max_context_tokens: Option<u64>

max_cost_usd: Option<f64>

max_round_renewals: u32

Bounded auto-renewals of the provider-round allowance (spec §8.1). On exhaustion the stream loop may reset the round counter this many times so a long, legitimate task continues instead of hard-failing. Round renewal never resets wall-clock (durable context successors do); a value of 0 means no graceful continuation (immediate hard stop).

Implementations

impl TurnBudget

pub fn for_role(role: TurnRole) -> TurnBudget

Compiled per-role defaults. Foreground is the most generous (a human is watching); autonomous is the tightest (nobody is); workers sit between (bounded delegation with a supervising turn).

pub fn has_time_limit(&self) -> bool

Whether a wall-clock limit can end (or checkpoint) a turn. A zero limit counts as exhausted at once and never as a time checkpoint.

pub fn max_elapsed_secs(&self) -> Option<u64>

The wall-clock limit in seconds, for diagnostics (None = no limit).

pub fn from_config(role: TurnRole, config: &TurnBudgetsConfig) -> TurnBudget

Role defaults overlaid with the typed config (unset fields keep the compiled defaults).

Trait Implementations

impl Clone for TurnBudget

fn clone(&self) -> TurnBudget

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TurnBudget

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

Formats the value using the given formatter.

impl PartialEq for TurnBudget

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for TurnBudget