Struct ContextAssembler 

pub struct ContextAssembler {
    config: CellstateConfig,
    segment_budget: Option<TokenBudget>,
}

Context assembler that builds context windows from packages. Adds sections by priority until budget is exhausted.

Fields

config: CellstateConfig

Configuration for assembly

segment_budget: Option<TokenBudget>

Segment-based token budget (optional)

Implementations

impl ContextAssembler

pub fn new(config: CellstateConfig) -> CellstateResult<Self>

Create a new context assembler with the given configuration.

pub fn with_segment_budget( config: CellstateConfig, budget: TokenBudget, ) -> CellstateResult<Self>

Create a context assembler with segment-based budget.

fn section_to_segment(section_type: SectionType) -> ContextSegment

Map SectionType to ContextSegment for budget tracking.

pub fn assemble(&self, pkg: ContextPackage) -> CellstateResult<ContextWindow>

Assemble context from a package with token budget management. Sections are added in priority order until budget is exhausted.

When segment budget is configured, sections are also checked against their respective segment budgets.

Arguments

• pkg - The context package to assemble

Returns

An assembled ContextWindow with sections ordered by priority

pub fn reassemble( &self, current: &ContextWindow, updated_pkg: ContextPackage, ) -> CellstateResult<(ContextWindow, ContextPageDiff)>

Re-assemble a context window mid-scope after scoring changes.

Takes the current window and an updated context package (with re-scored notes/artifacts), reassembles from scratch using the same budget rules, then diffs the old and new windows to produce a ContextPageDiff.

This is a pure function — no I/O. The diff provides the audit trail for what was evicted, promoted, or retained.

Returns

Tuple of (new window, diff describing what changed).

fn diff_windows(old: &ContextWindow, new: &ContextWindow) -> ContextPageDiff

Compare two context windows and produce a diff.

fn build_sections(&self, pkg: &ContextPackage) -> Vec<ContextSection>

Build sections from a context package.

fn format_kernel_config(&self, kernel: &KernelConfig) -> String

Format kernel config into a string.

fn format_notes(&self, notes: &[Note]) -> String

Format notes into a string.

fn format_artifacts(&self, artifacts: &[Artifact]) -> String

Format artifacts into a string.

fn format_working_set(&self, entries: &[AgentWorkingSetEntry]) -> String

Format working-set entries into a string.

fn format_graph_links(&self, links: &[GraphLink]) -> String

Format graph links into a string.

fn format_turns(&self, turns: &[Turn]) -> String

Format conversation turns into a string.

fn format_hierarchy(&self, hierarchy: &[Trajectory]) -> String

Format trajectory hierarchy into a string.

fn format_scope_summaries(&self, summaries: &[ScopeSummary]) -> String

Format scope summaries into a string.

pub fn token_budget(&self) -> i32

Get the token budget from config.

Trait Implementations

impl Clone for ContextAssembler

fn clone(&self) -> ContextAssembler

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ContextAssembler

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

Formats the value using the given formatter.