Struct SlidingWindowMemory 

pub struct SlidingWindowMemory { /* private fields */ }

Simple sliding window memory that keeps the N most recent messages.

This implementation uses a FIFO strategy where old messages are automatically removed when the window size limit is reached. It’s suitable for:

• Simple conversation contexts
• Memory-constrained environments
• Cases where only recent context matters

Examples

use mirror::memory::SlidingWindowMemory;
use mirror::chat::ChatMessage;

let mut memory = SlidingWindowMemory::new(3);

// Store messages - only the last 3 will be kept
memory.remember(&ChatMessage::user().content("Hello").build()).await?;
memory.remember(&ChatMessage::assistant().content("Hi there!").build()).await?;
memory.remember(&ChatMessage::user().content("How are you?").build()).await?;
memory.remember(&ChatMessage::assistant().content("I'm doing well!").build()).await?;

// Only the last 3 messages are kept
assert_eq!(memory.size(), 3);

Implementations

impl SlidingWindowMemory

pub fn new(window_size: usize) -> Self

Create a new sliding window memory with the specified window size.

Arguments

• window_size - Maximum number of messages to keep in memory

Panics

Panics if window_size is 0

Examples

use mirror::memory::SlidingWindowMemory;

let memory = SlidingWindowMemory::new(10);
assert_eq!(memory.window_size(), 10);
assert!(memory.is_empty());

pub fn with_strategy(window_size: usize, strategy: TrimStrategy) -> Self

Create a new sliding window memory with specified trim strategy

Arguments

• window_size - Maximum number of messages to keep in memory
• strategy - How to handle overflow when window is full

pub fn window_size(&self) -> usize

Get the configured window size.

Returns

The maximum number of messages this memory can hold

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

Get all stored messages in chronological order.

Returns

A vector containing all messages from oldest to newest

pub fn recent_messages(&self, limit: usize) -> Vec<ChatMessage>

Get the most recent N messages.

Arguments

• limit - Maximum number of recent messages to return

Returns

A vector containing the most recent messages, up to limit

pub fn needs_summary(&self) -> bool

Check if memory needs summarization

pub fn mark_for_summary(&mut self)

Mark memory as needing summarization

pub fn replace_with_summary(&mut self, summary: String)

Replace all messages with a summary

Arguments

• summary - The summary text to replace all messages with

Trait Implementations

impl Clone for SlidingWindowMemory

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SlidingWindowMemory

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

Formats the value using the given formatter.

impl MemoryProvider for SlidingWindowMemory

fn remember<'life0, 'life1, 'async_trait>( &'life0 mut self, message: &'life1 ChatMessage, ) -> Pin<Box<dyn Future<Output = Result<(), LLMError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Store a message in memory.

fn recall<'life0, 'life1, 'async_trait>( &'life0 self, _query: &'life1 str, limit: Option<usize>, ) -> Pin<Box<dyn Future<Output = Result<Vec<ChatMessage>, LLMError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Retrieve relevant messages from memory based on a query.

fn clear<'life0, 'async_trait>( &'life0 mut self, ) -> Pin<Box<dyn Future<Output = Result<(), LLMError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Clear all stored messages from memory.

fn memory_type(&self) -> MemoryType

Get the type of this memory provider.

fn size(&self) -> usize

Get the current number of stored messages.

fn needs_summary(&self) -> bool

Check if memory needs summarization

fn mark_for_summary(&mut self)

Mark memory as needing summarization

fn replace_with_summary(&mut self, summary: String)

Replace all messages with a summary

fn is_empty(&self) -> bool

Check if the memory is empty.

fn get_event_receiver(&self) -> Option<Receiver<MessageEvent>>

Get a receiver for reactive events if this memory supports them

fn remember_with_role<'life0, 'life1, 'async_trait>( &'life0 mut self, message: &'life1 ChatMessage, _role: String, ) -> Pin<Box<dyn Future<Output = Result<(), LLMError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Remember a message with a specific role for reactive memory