Struct TokenBudget 

pub struct TokenBudget {
    pub system: i32,
    pub instructions: i32,
    pub evidence: i32,
    pub memory: i32,
    pub tool_results: i32,
    pub history: i32,
    pub slack: i32,
}

Segment-based token budget allocation.

Divides the total token budget into segments for different purposes, allowing fine-grained control over context assembly.

Fields

system: i32

System prompt allocation

instructions: i32

pack instructions/persona

evidence: i32

Evidence/provenance data

memory: i32

User memory injection

tool_results: i32

Tool/LLM result history

history: i32

Conversation history

slack: i32

Safety margin (typically 5-10%)

Implementations

impl TokenBudget

pub fn total(&self) -> i32

Get the total budget across all segments.

pub fn from_total(total: i32) -> TokenBudget

Create a budget from a total with default ratios.

Default allocation:

• System: 10%
• Instructions: 15%
• Evidence: 15%
• Memory: 20%
• Tool Results: 15%
• History: 20%
• Slack: 5%

pub fn builder(total: i32) -> TokenBudgetBuilder

Create a builder for custom ratio configuration.

Example

use cellstate_core::TokenBudget;

let budget = TokenBudget::builder(8000)
    .system(0.10)
    .memory(0.25)  // Override default
    .build();

pub fn for_segment(&self, segment: ContextSegment) -> i32

Get the budget for a specific segment.

Trait Implementations

impl Clone for TokenBudget

fn clone(&self) -> TokenBudget

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TokenBudget

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

Formats the value using the given formatter.

impl Default for TokenBudget

fn default() -> TokenBudget

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for TokenBudget

fn deserialize<__D>( __deserializer: __D, ) -> Result<TokenBudget, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for TokenBudget

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for TokenBudget

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl ToSchema for TokenBudget

fn name() -> Cow<'static, str>

Return name of the schema.

fn schemas(schemas: &mut Vec<(String, RefOr<Schema>)>)

Implement reference [utoipa::openapi::schema::Schema]s for this type.

impl StructuralPartialEq for TokenBudget