Struct ContextWindow 

pub struct ContextWindow {
    pub regions: Vec<Region>,
    pub current_tokens: usize,
    pub max_tokens: usize,
    pub region_scripts: HashMap<String, Arc<RegionScript>>,
}

Context window component storing the agent’s memory regions.

Fields

regions: Vec<Region>

All regions in this context window

current_tokens: usize

Current total token usage

max_tokens: usize

Maximum token budget

region_scripts: HashMap<String, Arc<RegionScript>>

Compiled custom-region scripts, keyed by the script path each RegionKind::Custom carries. Populated once at spawn by the CLI (which resolves blueprint-dir-relative paths and compile-checks the files); a stage-layout swap rebuilds regions but leaves this table untouched, so per-stage custom regions keep working. Empty when no custom regions exist - every hook lookup then misses and the region renders its fallback shape.

Implementations

impl ContextWindow

pub fn new(max_tokens: usize) -> Self

Create a new context window with the specified budget.

pub fn get_region(&self, name: &str) -> Option<&Region>

Get a region by name.

pub fn get_region_mut(&mut self, name: &str) -> Option<&mut Region>

Get a mutable reference to a region by name.

pub fn add_region(&mut self, region: Region)

Add a region to this context window.

pub fn add_to_region( &mut self, region_name: &str, content: String, tokens: usize, ) -> Result<()>

Add content to a specific region.

pub fn replace_region( &mut self, region_name: &str, content: String, tokens: usize, ) -> bool

Replace a region’s entire content with a single entry (clear, then add). Returns false (no-op) if the region does not exist. Used to keep an authoritative document region (e.g. the plan) holding only its current version, so revisions build on it instead of accumulating stale copies.

pub fn add_typed_entry( &mut self, region_name: &str, kind: EntryKind, content: String, tokens: usize, ) -> Result<()>

Add a typed entry to a specific region.

Like add_to_region but the entry carries an EntryKind so message roles are determined by type, not text-prefix parsing.

pub fn calculate_tokens(&self) -> usize

Calculate current token usage across all regions.

pub fn needs_eviction(&self, threshold: f32) -> bool

Check if the context window needs eviction.

pub fn try_evict(&mut self, target_free_tokens: usize) -> Result<EvictionResult>

Execute eviction cascade to free up space.

Returns an EvictionResult with tokens freed and any regions that need LLM-based compaction. The caller is responsible for performing compaction on the listed regions (since it requires async LLM access).

pub fn assemble(&self) -> AssembledContext

Result of assembling the context window into system blocks + messages.

System-bound regions become system_blocks; the messages region becomes messages with proper typed entries (no text-prefix parsing).

Thin wrapper over assemble_with_meta with no stage metadata - custom-region scripts see empty stage fields.

pub fn assemble_with_meta(&self, meta: &AssembleMeta) -> AssembledContext

assemble with stage metadata for custom-region render(ctx) hooks (stage name, per-stage iteration count, model). The inference path (build_request) threads real values; other callers use the default.

pub fn enable_taint_tracking(&mut self)

Enable taint tracking on all regions in this context window.

pub fn add_tainted_to_region( &mut self, region_name: &str, content: String, tokens: usize, taint_level: TaintLevel, ) -> Result<()>

Add tainted content to a specific region.

pub fn add_typed_tainted_to_region( &mut self, region_name: &str, kind: EntryKind, content: String, tokens: usize, taint_level: TaintLevel, ) -> Result<()>

Add a typed entry to a region with a specific taint level.

The typed+tainted counterpart of add_typed_entry and add_tainted_to_region: the entry keeps its EntryKind (so turn-group eviction stays intact) while contributing the given taint level (so the taint gate sees sensitive tool output).

pub fn overall_taint(&self) -> Option<TaintLevel>

Get the overall taint level (max across all regions). Returns None if no region has taint tracking enabled.

pub fn taint_summary(&self) -> Vec<(String, TaintLevel)>

Get a summary of taint levels across all regions (for dashboard/audit).

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 Component for ContextWindow

where Self: Send + Sync + 'static,

const STORAGE_TYPE: StorageType = bevy_ecs::component::StorageType::Table

A constant indicating the storage type used for this component.

type Mutability = Mutable

A marker type to assist Bevy with determining if this component is mutable, or immutable. Mutable components will have Component<Mutability = Mutable>, while immutable components will instead have Component<Mutability = Immutable>.

fn register_required_components( _requiree: ComponentId, required_components: &mut RequiredComponentsRegistrator<'_, '_>, )

Registers required components.

fn clone_behavior() -> ComponentCloneBehavior

Called when registering this component, allowing to override clone function (or disable cloning altogether) for this component.

fn relationship_accessor() -> Option<ComponentRelationshipAccessor<Self>>

Returns ComponentRelationshipAccessor required for working with relationships in dynamic contexts.

fn on_add() -> Option<for<'w> fn(DeferredWorld<'w>, HookContext)>

Gets the on_add ComponentHook for this Component if one is defined.

fn on_insert() -> Option<for<'w> fn(DeferredWorld<'w>, HookContext)>

Gets the on_insert ComponentHook for this Component if one is defined.

fn on_discard() -> Option<for<'w> fn(DeferredWorld<'w>, HookContext)>

Gets the on_discard ComponentHook for this Component if one is defined.

fn on_remove() -> Option<for<'w> fn(DeferredWorld<'w>, HookContext)>

Gets the on_remove ComponentHook for this Component if one is defined.

fn on_despawn() -> Option<for<'w> fn(DeferredWorld<'w>, HookContext)>

Gets the on_despawn ComponentHook for this Component if one is defined.

fn map_entities<E>(_this: &mut Self, _mapper: &mut E)

where E: EntityMapper,

Maps the entities on this component using the given EntityMapper. This is used to remap entities in contexts like scenes and entity cloning. When deriving Component, this is populated by annotating fields containing entities with #[entities]

impl Debug for ContextWindow

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

Formats the value using the given formatter.