Struct ContextBudget 

pub struct ContextBudget { /* private fields */ }

Token budget for a single agent session.

Tracks the maximum token window and divides it across context slots. Call ContextBudget::allocate or ContextBudget::allocate_with_opts to get a BudgetAllocation that can be fed to crate::assembler::ContextAssembler.

Implementations

impl ContextBudget

pub fn new(max_tokens: usize, reserve_ratio: f32) -> ContextBudget

Create a new budget with max_tokens capacity and reserve_ratio fraction reserved for the model response.

Examples

use zeph_context::budget::ContextBudget;

let budget = ContextBudget::new(128_000, 0.15);
assert_eq!(budget.max_tokens(), 128_000);

pub fn with_graph_enabled(self, enabled: bool) -> ContextBudget

Enable or disable graph fact allocation in the budget split.

When enabled, 4% of available tokens are routed to the graph_facts slot, and the summaries/semantic_recall slices are each reduced by 1%.

pub fn max_tokens(&self) -> usize

Maximum token capacity for this session.

pub fn allocate( &self, system_prompt: &str, skills_prompt: &str, tc: &TokenCounter, graph_enabled: bool, ) -> BudgetAllocation

Allocate the budget across context slots for one turn.

Equivalent to allocate_with_opts(…, 0, false).

Examples

use zeph_context::budget::ContextBudget;
use zeph_memory::TokenCounter;

let budget = ContextBudget::new(128_000, 0.15);
let tc = TokenCounter::new();
let alloc = budget.allocate("system prompt", "skills prompt", &tc, false);
assert!(alloc.recent_history > 0);

pub fn allocate_with_opts( &self, system_prompt: &str, skills_prompt: &str, tc: &TokenCounter, graph_enabled: bool, digest_tokens: usize, memory_first: bool, ) -> BudgetAllocation

Allocate context budget with optional digest pre-reservation and MemoryFirst mode.

digest_tokens — pre-counted tokens for the session digest block; deducted from available tokens BEFORE percentage splits so it does not silently crowd out other slots.

memory_first — when true, sets recent_history to 0 and redistributes those tokens across summaries, semantic_recall, and cross_session.

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<(), Error>

Formats the value using the given formatter.