Struct SummaryIndex 

pub struct SummaryIndex { /* private fields */ }

Hierarchical summary cache over the chat transcript.

Cache hit: returns immediately via Self::get. Cache miss: Self::summary_for calls a producer, then caches.

Implementations

impl SummaryIndex

pub fn new() -> Self

Empty index.

pub fn generation(&self) -> u64

Current generation counter.

pub fn len(&self) -> usize

Number of cached summaries.

pub fn is_empty(&self) -> bool

Whether the cache is empty.

pub fn get(&self, range: SummaryRange) -> Option<&SummaryNode>

Exact range lookup.

pub fn entries(&self) -> impl Iterator<Item = (&SummaryRange, &SummaryNode)>

Iterate over (range, node) pairs in range order.

impl SummaryIndex

pub async fn summary_for<F, Fut>( &mut self, range: SummaryRange, producer: F, ) -> Result<SummaryNode>

where F: FnOnce(SummaryRange) -> Fut, Fut: Future<Output = Result<SummaryNode>>,

Main read path for derivation policies.

Cache hit: returns immediately. Cache miss: calls producer which encapsulates RLM summarisation, then caches the result.

Errors

Returns the producer’s error if the RLM call fails.

impl SummaryIndex

pub fn insert( &mut self, range: SummaryRange, node: SummaryNode, ) -> Option<SummaryNode>

Insert a node, maintaining LRU ordering and evicting if over budget.

pub fn append(&mut self, idx: usize)

Hot-path hook for Session::add_message.

Drops every cached summary whose range covers idx.

pub fn invalidate_after(&mut self, idx: usize)

Drop ranges whose end > idx (compaction/reset).

Trait Implementations

impl Clone for SummaryIndex

fn clone(&self) -> SummaryIndex

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SummaryIndex

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

Formats the value using the given formatter.

impl Default for SummaryIndex

fn default() -> SummaryIndex

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for SummaryIndex

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for SummaryIndex

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.