How rendevouz999/agent-core-memory works
Agent Core Memory is a standalone, file-native memory engine. Its principal workflow is to initialize a workspace-scoped service, persist canonical Markdown memories, and search them with lexical retrieval and optional semantic ranking; users can also record use and feedback, manage memory lifecycles, and transfer records. The graph includes the README’s major capabilities, while unsampled subsystem links are dashed where implementation calls could not be verified from excerpts. Paths and relationships reflect the supplied tree and source index.
Main entry points: service.ts Memory Service · store.ts File Memory Store · retrieval.ts Hybrid Retrieval · index.ts Semantic Index
Components 24
Service API
- Standalone Setup
src/standalone.ts - Memory Service
src/memory/service.ts
Records And Lifecycle
- Markdown Records
src/memory/note-format.ts - Revision History
src/memory/revisions.ts - Links And Evolution
src/memory/relations.ts - Feedback Lifecycle
src/memory/feedback.ts - Consolidation Review
src/memory/consolidation.ts - Retirement Review
src/memory/retirement.ts - Import Export
src/memory/transfer.ts
Retrieval And Indexing
- Hybrid Retrieval
src/memory/retrieval.ts - BM25 Ranking
src/memory/bm25.ts - Semantic Index
src/memory/index.ts - Cloud Embeddings
src/memory/embedder.ts - Embedding Repair
src/memory/embedding-repair.ts
Evidence And Learning
- Source Provenance
src/memory/provenance.ts - Workflow Verification
src/learning/workflow-evidence.ts - Retrieval Use Ledger
src/memory/retrieval-ledger.ts - Activity Tracking
src/tracker/activity-tracker.ts
Persistence
- File Memory Store
src/memory/store.ts - Atomic File Writes
src/persistence/atomic-file.ts - Process Locking
src/memory/lock.ts - Memory Paths
src/memory/paths.ts
Other components
- Memory User
- Workers AI
Connections 24
- Memory User → Standalone Setup: initializes
README.md - Standalone Setup → Memory Service: creates service
src/standalone.ts - Memory User → Memory Service: uses memory
README.md - Memory Service → File Memory Store: initializes store
src/memory/service.ts - File Memory Store → Markdown Records: parses records
src/memory/store.ts - File Memory Store → Revision History: tracks revisions
src/memory/store.ts - Memory Service → Hybrid Retrieval: searches records
src/memory/service.ts - Hybrid Retrieval → BM25 Ranking: ranks lexically
src/memory/retrieval.ts - Hybrid Retrieval → Semantic Index: uses semantic context
src/memory/retrieval.ts - Semantic Index → Cloud Embeddings: embeds documents
src/memory/index.ts - Semantic Index → Embedding Repair: repairs embeddings
src/memory/index.ts - Memory Service → Source Provenance: captures provenance
src/memory/service.ts - Memory Service → Workflow Verification: validates use
src/memory/service.ts - Memory Service → Retrieval Use Ledger: records use
src/memory/service.ts - Retrieval Use Ledger → Activity Tracking: correlates activity
src/memory/retrieval-ledger.ts - Memory Service → Feedback Lifecycle: manages feedback
src/memory/service.ts - Memory Service → Links And Evolution: manages links
src/memory/service.ts - Memory Service → Consolidation Review: offers review
src/memory/service.ts - Memory Service → Retirement Review: offers review
src/memory/service.ts - Memory Service → Import Export: transfers records
src/memory/service.ts - File Memory Store → Atomic File Writes: writes atomically
- File Memory Store → Process Locking: locks access
src/memory/store.ts - Memory Service → Memory Paths: resolves storage
src/memory/service.ts - Cloud Embeddings → Workers AI: requests embeddings
src/memory/embedder.ts