Struct MessageWindow 

pub struct MessageWindow { /* private fields */ }

Sliding window over LLM conversation messages.

max_turns controls how many messages are kept. When adding a new message causes overflow, the oldest is evicted first. With paired_protect = true (the default), evicting a tool_use message also evicts any tool_result messages that reference its IDs.

Implementations

impl MessageWindow

pub fn new(max_turns: usize, paired_protect: bool) -> Self

Create a new window with max_turns capacity.

paired_protect = true guards Anthropic tool-use / tool-result pairs.

pub fn try_new( max_turns: usize, paired_protect: bool, ) -> Result<Self, WindowError>

Try to create; returns Err if max_turns < 1.

pub fn max_turns(&self) -> usize

pub fn len(&self) -> usize

pub fn is_empty(&self) -> bool

pub fn evicted_count(&self) -> usize

pub fn messages(&self) -> Vec<&Value>

Ordered slice of current messages (oldest → newest).

pub fn messages_owned(&self) -> Vec<Value>

Cloned owned snapshot.

pub fn clear(&mut self)

pub fn add(&mut self, message: Value) -> Result<(), WindowError>

Append a message and evict-to-fit.

pub fn extend( &mut self, messages: impl IntoIterator<Item = Value>, ) -> Result<(), WindowError>

Add multiple messages in order.