Aether SDK Architecture
Aether SDK is a model-free Rust memory SDK for storing, indexing, and retrieving AI memory across durable record, vector, and graph stores (SQLite, Redis/Valkey, Turbopuffer, Qdrant, Chroma, pgvector, and Neo4j). Every layer is exposed as standalone composable pieces, with MemoryManager serving as an optional convenience facade.
Five Composable Levels
- Level 1 - Single Connectors (
muninn-aether-core+muninn-aether-adapters): CallRecordStore,VectorStore, orGraphStoredirectly (orInMemoryBackendfor local runs). - Level 2 - Middleware (
muninn-aether-adapters): StackBatcher,Timeout,Resilient(exponential backoff with full jitter on transient errors), andTracedaround any connector. - Level 3 - Indexing & Recall Primitives (
muninn-aether-cortex): Combinerecall::{scope_filter, vector_search, unindexed, session, graph_search, merge, rrf, in_scopes}andPersonalizedPageRank/graph_scoresalongside your own application logic. - Level 4 - Sync Engine (
muninn-aether-cortex::Indexer): Derive vector and graph indexes asynchronously or on demand from versionedRecordStorepending items and tombstones (run_pass,apply, opt-inspawn). - Level 5 - Optional Facade (
muninn-aether-sdk::MemoryManager): ConfigureMemoryManager::builder(record_store)with optional.vector(...),.graph(...),.background_indexing(...), and middleware toggles to runremember,recall,update,forget,flush, andshutdown.
Workspace Crates
muninn-aether-core: Domain contracts, validated newtypes (ProjectId,MemoryId,EntityId,UserId,SessionId), shared scoring (DistanceMetric::score) and filtering (FilterExpr::matches),IndexSpec,AetherError, and storage traits (OutboundConnector,RecordStore,VectorStore,GraphStore).muninn-aether-cortex: ComposableIndexer,PersonalizedPageRank+graph_scores, andrecallsteps.muninn-aether-adapters:InMemoryBackend(withFaultPointinjection), middleware decorators (Batcher,Timeout,Resilient,Traced), reusablecontracttest suite (contract-suitefeature), and feature-gated backend drivers (sqlite,redis,turbopuffer,qdrant,chroma,pgvector,neo4j).muninn-aether-sdk:MemoryManager/MemoryManagerBuildercomposition root and optional OpenTelemetry preset (otelfeature).muninn-aether-vault: Local Obsidian vault daemon (VaultEngine), single-file SQLite WAL + FTS5 +PersonalizedPageRank(muninn_aether_cortex) +CrossEncoderReranker, pluggableEmbedder(HashedNgramEmbedder,DenseSubwordEmbedder,LocalGpuEmbedder) withvault_metaauto-reindexing, deterministicHOTprompt prefix caching (static_prefix/dynamic_context),Aether/Inbox.mdstaging +Aether/Compiled/Approved.mdmirror, Daily Note Dream worker, loopbackControlPlaneServer, and 3-toolstdioMCP server (McpServer,aether-mcpbinary). See Vault & MCP Architecture.