Struct ContextWindow 

pub struct ContextWindow {
    pub window_id: Uuid,
    pub assembled_at: DateTime<Utc>,
    pub max_tokens: i32,
    pub used_tokens: i32,
    pub sections: Vec<ContextSection>,
    pub truncated: bool,
    pub included_sections: Vec<String>,
    pub assembly_trace: Vec<AssemblyDecision>,
    pub budget: Option<TokenBudget>,
    pub usage: SegmentUsage,
}

Assembled context window with token budget management.

Fields

window_id: Uuid

Unique identifier for this window

assembled_at: DateTime<Utc>

When this window was assembled

max_tokens: i32

Maximum token budget

used_tokens: i32

Tokens currently used

sections: Vec<ContextSection>

Sections in priority order

truncated: bool

Whether any section was truncated

included_sections: Vec<String>

Names of included sections

assembly_trace: Vec<AssemblyDecision>

Full audit trail of assembly decisions

budget: Option<TokenBudget>

Segment-based token budget allocation

usage: SegmentUsage

Per-segment usage tracking

Implementations

impl ContextWindow

pub fn new(max_tokens: i32) -> ContextWindow

Create a new empty context window with the given token budget.

pub fn with_budget(budget: TokenBudget) -> ContextWindow

Create a new context window with segment-based budget.

pub fn add_to_segment( &mut self, segment: ContextSegment, content: String, priority: i32, ) -> Result<(), SegmentBudgetError>

Add content to a specific segment.

Returns an error if the segment budget would be exceeded.

pub fn add_section_to_segment( &mut self, segment: ContextSegment, section: ContextSection, ) -> Result<(), SegmentBudgetError>

Add a pre-built section to a segment, preserving section metadata/sources.

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

Get remaining tokens for a specific segment.

pub fn remaining_tokens(&self) -> i32

Get remaining token budget.

pub fn has_room(&self) -> bool

Check if the window has room for more content.

pub fn add_section(&mut self, section: ContextSection) -> bool

Add a section to the window. Returns true if the section was added, false if it didn’t fit.

pub fn add_truncated_section(&mut self, section: ContextSection)

Add a truncated section to the window.

pub fn as_text(&self) -> String

Get the assembled content as a single string.

Trait Implementations

impl Clone for ContextWindow

fn clone(&self) -> ContextWindow

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ContextWindow

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ContextWindow

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for ContextWindow

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

Formats the value using the given formatter.

impl PartialEq for ContextWindow

fn eq(&self, other: &ContextWindow) -> 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 ContextWindow

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 ContextWindow

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 ContextWindow