Struct SessionCache 

pub struct SessionCache { /* private fields */ }

In-memory file cache with RRF-based eviction, file references, and cross-file dedup.

Implementations

impl SessionCache

pub fn new() -> Self

Creates an empty session cache with default stats.

pub fn get_file_ref(&mut self, path: &str) -> String

Returns or assigns a short file reference label (F1, F2, …) for the given path.

pub fn get_file_ref_readonly(&self, path: &str) -> Option<String>

Returns the file reference label for a path without assigning a new one.

pub fn get(&self, path: &str) -> Option<&CacheEntry>

Looks up a cached entry by file path.

pub fn record_cache_hit(&mut self, path: &str) -> Option<&CacheEntry>

Records a cache hit, updates access stats, and emits a cache-hit event.

pub fn store(&mut self, path: &str, content: String) -> StoreResult

Stores file content in the cache; returns a hit if content hash matches.

pub fn total_cached_tokens(&self) -> usize

Returns the sum of original token counts across all cached entries.

pub fn evict_if_needed(&mut self, incoming_tokens: usize)

Evict lowest-scoring entries (by RRF) until cache fits within token budget.

pub fn get_all_entries(&self) -> Vec<(&String, &CacheEntry)>

Returns all cached entries as (path, entry) pairs.

pub fn get_stats(&self) -> &CacheStats

Returns a reference to the aggregated cache statistics.

pub fn file_ref_map(&self) -> &HashMap<String, String>

Returns the path-to-file-ref mapping (e.g. “/src/main.rs” → “F1”).

pub fn set_shared_blocks(&mut self, blocks: Vec<SharedBlock>)

Replaces the cross-file shared blocks used for deduplication.

pub fn get_shared_blocks(&self) -> &[SharedBlock]

Returns the current set of cross-file shared blocks.

pub fn apply_dedup(&self, path: &str, content: &str) -> Option<String>

Replace shared blocks in content with cross-file references.

pub fn invalidate(&mut self, path: &str) -> bool

Removes a file from the cache, forcing a fresh read on next access.

pub fn get_compressed(&self, path: &str, mode_key: &str) -> Option<&String>

Returns a cached compressed output for a given file and mode key.

pub fn mark_full_delivered(&mut self, path: &str)

Marks that full (uncompressed) content was delivered for this file.

pub fn set_compressed(&mut self, path: &str, mode_key: &str, output: String)

Stores a compressed output for a given file and mode key.

pub fn clear(&mut self) -> usize

Clears all cached entries, file refs, and resets stats. Returns the number of entries removed.

Trait Implementations

impl Default for SessionCache

fn default() -> Self

Returns the “default value” for a type.