Struct ContextAssembler 

pub struct ContextAssembler { /* private fields */ }

Context assembler — builds prompts respecting token budgets.

Implementations

impl ContextAssembler

pub fn new(budget: TokenBudget) -> Self

Create a new context assembler.

pub fn with_defaults() -> Self

Create with default budget.

pub fn budget(&self) -> TokenBudget

The active token budget — lets the pipeline plan history compaction against the same per-section allocation the assembler enforces.

pub fn with_system_prompt(self, prompt: impl Into<String>) -> Self

Set custom system prompt.

pub fn with_user_profile(self, profile: UserProfile) -> Self

Set user profile.

pub fn assemble( &self, user_message: &str, memories: &[Memory], conversation_history: &[Message], ) -> Vec<Message>

Assemble context into messages.

Takes retrieved memories and conversation history, returns messages ready for the LLM.

pub fn assemble_with_addendum( &self, user_message: &str, memories: &[Memory], conversation_history: &[Message], addendum: Option<&str>, ) -> Vec<Message>

Like [assemble], but appends addendum to the system prompt if provided. Used to switch prompt modes per-turn (e.g. onboarding) without mutating the shared assembler.

pub fn assemble_full( &self, user_message: &str, memories: &[Memory], conversation_history: &[Message], addendum: Option<&str>, capabilities: Option<&str>, attachments: &[Attachment], skipped: &[SkippedAttachment], ) -> Vec<Message>

Full assembly with path-attachment grounding. Attachments render as <ATTACHED_CONTENT> blocks in a System message positioned right before the user’s actual message — closest attention slot to “what the user just put on the table.” Skipped paths render as <SKIPPED_PATH> tags in the same block so Brain can mention them naturally.

Per-attachment content is truncated to fit budget.attachments; when total snapshot text exceeds the budget, later attachments shrink first so the first (and usually primary) reference stays intact.

capabilities is the “Your Capabilities” section of the SOUL prompt. The chat path passes a live digest rendered from the currently-wired tools and agents; every other path passes None and falls back to DEFAULT_CAPABILITIES. Either way the section is appended after the base prompt so the reasoner always sees an explicit capability manifest.

pub fn estimate_tokens(messages: &[Message]) -> usize

Quick estimate of total tokens in messages.