Struct ActiveWindow 

pub struct ActiveWindow { /* private fields */ }

Manages the short-term active window of conversation messages.

When messages are pushed and the window exceeds policy limits, the window is trimmed. Evicted messages are either demoted to long-term storage (via DemotionHook) or compacted into a summary (via Compactor) — never silently discarded.

Implementations

impl ActiveWindow

pub fn new(policy: MemoryPolicy) -> Self

Creates a new active window with the given policy.

pub fn with_demotion_hook(self, hook: Box<dyn DemotionHook>) -> Self

Sets the demotion hook.

pub fn with_compactor(self, compactor: Box<dyn Compactor>) -> Self

Sets the compactor.

pub fn push(&mut self, msg: Message) -> Vec<MemoryEvent>

Pushes a message into the active window.

Returns memory events if trimming was triggered.

pub fn messages(&self) -> &[Message]

Returns the current messages in the active window.

pub fn trim_if_needed(&mut self) -> Vec<MemoryEvent>

Trims the window if it exceeds policy limits.

Evicted messages are processed through the demotion hook and/or compactor, never silently dropped.