oxios-memory 1.2.0

Tiered agent memory — extracted from oxios-kernel per RFC-018
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102

//! Memory subsystem modules — extracted from `oxios-kernel` per RFC-018.
//!
//! ## Module categories
//!
//! | Category | Modules | Description |
//! |----------|---------|-------------|
//! | **Types** | `types` | Core types (MemoryEntry, MemoryType, MemoryTier, etc.) |
//! | **Text** | `chunking`, `normalizer` | Text splitting and vector math |
//! | **Geometry** | `hyperbolic` | Poincaré ball model embeddings |
//! | **Lifecycle** | `decay`, `auto_classify`, `auto_protect`, `compaction`, `quota` | Memory lifecycle |
//! | **Analysis** | `graph`, `flash_attention`, `embedding_cache`, `embedding_viz`, `hnsw` | Analysis & indexing |
//! | **Index** | `root_index` | Root memory index |
//! | **Storage** | `storage` | Storage abstraction traits |

// ─── Embedding ────────────────────────────────────────────────────────
pub mod embedding;
pub use embedding::{EmbeddingProvider, EmbeddingVector, TfIdfEmbeddingProvider};

// ─── Core types ─────────────────────────────────────────────────────
pub mod types;
pub use types::{
    content_hash, dedup_by_id, extract_keywords, MemoryEntry, MemoryTier, MemoryType,
    ProtectionLevel, TextVector,
};

// ─── Text / math utilities ──────────────────────────────────────────
pub mod chunking;
pub mod hyperbolic;
pub mod normalizer;

// ─── Memory lifecycle ───────────────────────────────────────────────
pub mod auto_classify;
pub mod auto_protect;
pub mod compaction;
pub mod decay;
pub mod quota;

// ─── Analysis & indexing ────────────────────────────────────────────
pub mod embedding_cache;
pub mod embedding_viz;
pub mod flash_attention;
pub mod graph;
pub mod hnsw;
pub mod hnsw_memory_index;
pub mod root_index;
pub mod sona;

// ─── Storage abstraction ────────────────────────────────────────────
pub mod backend;
pub mod storage;

// ─── Test support ───────────────────────────────────────────────────
#[cfg(test)]
pub mod test_support;

// ─── Core manager ────────────────────────────────────────────────────
pub mod manager;

// ─── Processes ──────────────────────────────────────────────────────
pub mod auto_bridge;
pub mod dream;
pub mod proactive;

#[cfg(feature = "sqlite-memory")]
pub mod sqlite;

// ─── Re-exports (b.1 — chunking/normalizer/hyperbolic) ──────────────
pub use backend::MemoryBackend;
pub use chunking::{chunk_fixed, chunk_paragraphs, ChunkConfig, TextChunk};
pub use hyperbolic::{
    batch_euclidean_to_poincare, euclidean_to_poincare, hyperbolic_distance, mobius_add,
    mobius_scalar_mul, HyperbolicConfig, HyperbolicEmbedding,
};
pub use normalizer::{
    cosine_similarity_f32, dot_product_f32, l2_norm_f32, l2_norm_f64, l2_normalize_f32,
    l2_normalize_f64,
};
pub use storage::{MarkdownSource, MemoryGit, MemoryStorage, MemoryStorageExt, NoteEntry};

// ─── Re-exports (lifecycle) ─────────────────────────────────────────
pub use auto_classify::AutoClassifier;
pub use auto_protect::AutoProtector;
pub use compaction::CompactionTree;
pub use decay::DecayEngine;
pub use embedding_cache::{CacheStats, EmbeddingCache};
pub use embedding_viz::{compute_pca_2d, compute_top_neighbors, MemoryMapEntry, MemoryNeighbor};
pub use flash_attention::{BenchmarkResult, FlashAttention, FlashAttentionConfig, MemoryEstimate};
pub use graph::MemoryGraph;
pub use hnsw::HnswIndex;
pub use hnsw_memory_index::{HnswMemoryIndex, SemanticHit};
pub use quota::{CurationCandidate, CurationReport, MemoryBudget};
pub use root_index::{HistoricalPeriod, RootEntry, RootIndex, TopicEntry};
pub use sona::{LearnedPattern, SonaEngine, SonaMode, Trajectory, TrajectoryStep, Verdict};

// ─── Re-exports (core manager) ──────────────────────────────────────
pub use auto_bridge::{
    AutoMemoryBridge, ExportResult, GuidancePattern, ImportResult, InsightCategory, MemoryInsight,
    SyncDirection, SyncResult,
};
pub use dream::{DreamCheckpoint, DreamConfig, DreamProcess, DreamReport};
pub use manager::MemoryManager;
pub use proactive::{ProactiveRecall, RecallTiming};