Skip to main content

Module retrieval

Module retrieval 

Source
Expand description

Episodic memory retrieval with caching and hybrid search.

This module provides efficient retrieval of episodes with:

  • LRU caching and TTL for query results
  • BM25 keyword search (via CSM crate, first-tier, no API calls)
  • ConceptGraph ontology expansion (via CSM crate, synonym matching)
  • HDC hyperdimensional vectors (via CSM crate)
  • Cascading retrieval pipeline (WG-131)
  • Hierarchical/gist reranking for dense context (WG-118)
  • Reconstructive retrieval windows (WG-120, E-mem-inspired)
  • Execution-signature retrieval (WG-121, APEX-EM-inspired)
  • Scope-before-search shard routing (WG-122, ShardMemo-inspired)

Re-exports§

pub use cache::CacheKey;
pub use cache::CacheMetrics;
pub use cache::DEFAULT_CACHE_TTL;
pub use cache::DEFAULT_MAX_ENTRIES;
pub use cache::QueryCache;
pub use cascade::CascadeConfig;
pub use cascade::CascadeResult;
pub use cascade::CascadeRetriever;
pub use gist::EpisodeGist;
pub use gist::GistExtractor;
pub use gist::GistScoredItem;
pub use gist::HierarchicalReranker;
pub use gist::RerankConfig;
pub use semantic_retriever::HybridHit;
pub use semantic_retriever::ScoreComponents;
pub use semantic_retriever::SemanticRetriever;
pub use shard::EpisodeMetadata;
pub use shard::RoutingResult;
pub use shard::ScopeFilter;
pub use shard::ShardConfig;
pub use shard::ShardRouter;
pub use shard::TimeRange;
pub use signature::ExecutionSignature;
pub use signature::QuerySignature;
pub use signature::SignatureConfig;
pub use signature::SignatureMatch;
pub use signature::SignatureMatcher;
pub use signature::StepPattern;
pub use windows::ContextWindow;
pub use windows::RetrievalHit;
pub use windows::WindowConfig;
pub use windows::WindowExpander;
pub use windows::WindowExpansionResult;
pub use windows::merge_overlapping_windows;

Modules§

cache
Query Cache for Episodic Memory Retrieval
cascade
Cascading retrieval pipeline (WG-131).
gist
Hierarchical/gist reranking for dense context retrieval (WG-118).
semantic_retriever
Hybrid semantic and keyword retrieval for episodic memory.
shard
Scope-before-search shard routing (WG-122).
signature
Execution-signature retrieval (WG-121).
windows
Reconstructive retrieval windows (WG-120).