Struct SemanticContextWindow 

pub struct SemanticContextWindow {
    pub entries: Vec<ContextEntry>,
    pub config: WindowConfig,
    pub total_added: u64,
}

Sliding context window for session-aware semantic search personalization.

Maintains a bounded list of recent queries, search results, and user feedback. Provides a weighted context embedding that captures recency-biased user intent.

Fields

entries: Vec<ContextEntry>

Current window entries, oldest at index 0, newest at end.

config: WindowConfig

Configuration for this window.

total_added: u64

Monotonically increasing counter of all entries ever added.

Implementations

impl SemanticContextWindow

pub fn new(config: WindowConfig) -> Self

Creates a new context window with the given configuration.

pub fn add(&mut self, entry: ContextEntry)

Adds an entry to the window.

If the window is full (len > max_entries), the oldest entry is evicted.

pub fn context_embedding(&self) -> Vec<f32>

Computes a recency-weighted average context embedding.

Only ContextEntry::Query and ContextEntry::Result entries contribute embeddings. Entries with the wrong embedding dimension are skipped silently.

The weight of entry at window index i (0 = oldest) is: decay_factor ^ (window_len - 1 - i)

Returns a zero vector of length embedding_dim when no valid embeddings are present in the window.

pub fn recent_queries(&self, n: usize) -> Vec<&ContextEntry>

Returns the last n ContextEntry::Query entries, newest first.

pub fn recent_results(&self, n: usize) -> Vec<&ContextEntry>

Returns the last n ContextEntry::Result entries, newest first.

pub fn positive_docs(&self) -> Vec<u64>

Returns doc_ids with positive feedback, oldest first, deduplicated.

pub fn negative_docs(&self) -> Vec<u64>

Returns doc_ids with negative feedback, oldest first, deduplicated.

pub fn clear(&mut self)

Clears all entries from the window, preserving the configuration.

pub fn stats(&self) -> ContextStats

Returns a snapshot of current window statistics.