Skip to main content

Module memory

Module memory 

Source
Expand description

Memory subsystem modules — extracted from oxios-kernel per RFC-018.

§Module categories

CategoryModulesDescription
TypestypesCore types (MemoryEntry, MemoryType, MemoryTier, etc.)
Textchunking, normalizerText splitting and vector math
GeometryhyperbolicPoincaré ball model embeddings
Lifecycledecay, auto_classify, auto_protect, compaction, quotaMemory lifecycle
Analysisgraph, flash_attention, embedding_cache, embedding_viz, hnswAnalysis & indexing
Indexroot_indexRoot memory index
StoragestorageStorage abstraction traits

Re-exports§

pub use embedding::EmbeddingProvider;
pub use embedding::EmbeddingVector;
pub use embedding::TfIdfEmbeddingProvider;
pub use types::content_hash;
pub use types::dedup_by_id;
pub use types::extract_keywords;
pub use types::MemoryEntry;
pub use types::MemoryTier;
pub use types::MemoryType;
pub use types::ProtectionLevel;
pub use types::TextVector;
pub use backend::MemoryBackend;
pub use chunking::chunk_fixed;
pub use chunking::chunk_paragraphs;
pub use chunking::ChunkConfig;
pub use chunking::TextChunk;
pub use hyperbolic::batch_euclidean_to_poincare;
pub use hyperbolic::euclidean_to_poincare;
pub use hyperbolic::hyperbolic_distance;
pub use hyperbolic::mobius_add;
pub use hyperbolic::mobius_scalar_mul;
pub use hyperbolic::HyperbolicConfig;
pub use hyperbolic::HyperbolicEmbedding;
pub use normalizer::cosine_similarity_f32;
pub use normalizer::dot_product_f32;
pub use normalizer::l2_norm_f32;
pub use normalizer::l2_norm_f64;
pub use normalizer::l2_normalize_f32;
pub use normalizer::l2_normalize_f64;
pub use storage::MarkdownSource;
pub use storage::MemoryGit;
pub use storage::MemoryStorage;
pub use storage::MemoryStorageExt;
pub use storage::NoteEntry;
pub use auto_classify::AutoClassifier;
pub use auto_protect::AutoProtector;
pub use compaction::CompactionTree;
pub use decay::DecayEngine;
pub use embedding_cache::CacheStats;
pub use embedding_cache::EmbeddingCache;
pub use embedding_viz::compute_pca_2d;
pub use embedding_viz::compute_top_neighbors;
pub use embedding_viz::MemoryMapEntry;
pub use embedding_viz::MemoryNeighbor;
pub use flash_attention::BenchmarkResult;
pub use flash_attention::FlashAttention;
pub use flash_attention::FlashAttentionConfig;
pub use flash_attention::MemoryEstimate;
pub use graph::MemoryGraph;
pub use hnsw::HnswIndex;
pub use hnsw_memory_index::HnswMemoryIndex;
pub use hnsw_memory_index::SemanticHit;
pub use quota::CurationCandidate;
pub use quota::CurationReport;
pub use quota::MemoryBudget;
pub use root_index::HistoricalPeriod;
pub use root_index::RootEntry;
pub use root_index::RootIndex;
pub use root_index::TopicEntry;
pub use sona::LearnedPattern;
pub use sona::SonaEngine;
pub use sona::SonaMode;
pub use sona::Trajectory;
pub use sona::TrajectoryStep;
pub use sona::Verdict;
pub use auto_bridge::AutoMemoryBridge;
pub use auto_bridge::ExportResult;
pub use auto_bridge::GuidancePattern;
pub use auto_bridge::ImportResult;
pub use auto_bridge::InsightCategory;
pub use auto_bridge::MemoryInsight;
pub use auto_bridge::SyncDirection;
pub use auto_bridge::SyncResult;
pub use dream::DreamCheckpoint;
pub use dream::DreamConfig;
pub use dream::DreamProcess;
pub use dream::DreamReport;
pub use manager::MemoryManager;
pub use proactive::ProactiveRecall;
pub use proactive::RecallTiming;

Modules§

auto_bridge
Auto-memory bridge: synchronization between external memory systems and Oxios.
auto_classify
Automatic memory type classification from content.
auto_protect
Automatic memory protection based on access patterns.
backend
Memory backend abstraction — the strategy pattern for storage.
chunking
Text chunking utilities for memory content processing.
compaction
Compaction tree — 5-level memory compression hierarchy.
decay
Ebbinghaus-inspired decay engine for memory importance scoring.
dream
Dream process — 4-phase background memory consolidation.
embedding
Embedding abstraction for semantic similarity.
embedding_cache
Embedding cache for reducing API calls.
embedding_viz
Memory embedding visualization (RFC-T1-B).
flash_attention
Flash Attention — block-wise attention for O(N) memory usage.
graph
PageRank-based importance scoring for memory entries.
hnsw
HNSW-based approximate nearest neighbor index via usearch.
hnsw_memory_index
HNSW index manager for memory entries.
hyperbolic
Hyperbolic embeddings using the Poincaré ball model.
manager
Memory manager — the central orchestrator for agent memory.
normalizer
Embedding vector normalization utilities.
proactive
Proactive recall — automatically inject relevant memories into context.
quota
Memory budget and curation types.
root_index
ROOT index — the “table of contents” for all agent knowledge.
sona
SONA — Self-Optimizing Neural Architecture (simplified).
storage
Storage abstraction for the memory subsystem.
types
Core memory types — extracted from oxios-kernel.