Struct ContextBudget 

pub struct ContextBudget {
    pub execution_id: ExecutionId,
    pub total_tokens: usize,
    pub output_reserve: usize,
    pub available_tokens: usize,
    pub used_tokens: usize,
    pub segments: Vec<SegmentBudget>,
    pub warning_threshold: u8,
    pub critical_threshold: u8,
    pub updated_at: DateTime<Utc>,
}

Token allocation across all segments

Matches contextBudgetSchema in @enact/schemas

Fields

execution_id: ExecutionId

Execution this budget belongs to

total_tokens: usize

Total context window size (model limit)

output_reserve: usize

Tokens reserved for output generation

available_tokens: usize

Available tokens for input context

used_tokens: usize

Current total usage

segments: Vec<SegmentBudget>

Per-segment budgets

warning_threshold: u8

Warning threshold (percentage, 0-100)

critical_threshold: u8

Critical threshold (percentage, 0-100)

updated_at: DateTime<Utc>

Last updated timestamp

Implementations

impl ContextBudget

pub fn new( execution_id: ExecutionId, total_tokens: usize, output_reserve: usize, ) -> Self

Create a new context budget

pub fn preset_gpt4_128k(execution_id: ExecutionId) -> Self

Create a GPT-4 128K preset

pub fn preset_gpt4_32k(execution_id: ExecutionId) -> Self

Create a GPT-4 32K preset

pub fn preset_claude_200k(execution_id: ExecutionId) -> Self

Create a Claude 200K preset

pub fn preset_default(execution_id: ExecutionId) -> Self

Create a default 8K preset

pub fn get_segment( &self, segment_type: ContextSegmentType, ) -> Option<&SegmentBudget>

Get the budget for a specific segment type

pub fn get_segment_mut( &mut self, segment_type: ContextSegmentType, ) -> Option<&mut SegmentBudget>

Get mutable budget for a specific segment type

pub fn update_segment_usage( &mut self, segment_type: ContextSegmentType, tokens: usize, )

Update token usage for a segment

pub fn add_tokens(&mut self, segment_type: ContextSegmentType, tokens: usize)

Add tokens to a segment

pub fn remove_tokens(&mut self, segment_type: ContextSegmentType, tokens: usize)

Remove tokens from a segment

pub fn remaining(&self) -> usize

Remaining tokens

pub fn usage_percent(&self) -> u8

Usage percentage (0-100)

pub fn is_warning(&self) -> bool

Whether usage is at warning level

pub fn is_critical(&self) -> bool

Whether usage is at critical level

pub fn health(&self) -> BudgetHealth

Health status

Trait Implementations

impl Clone for ContextBudget

fn clone(&self) -> ContextBudget

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ContextBudget

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ContextBudget

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for ContextBudget

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

where __S: Serializer,

Serialize this value into the given Serde serializer.