Memory System
The Ghost's persistent mind - episodic experiences, semantic knowledge, and the consolidation process that transforms experience into wisdom.
Architecture
┌─────────────────────────────────────────────────────┐
│ MEMORY SYSTEM │
├─────────────────┬─────────────────┬─────────────────┤
│ EPISODIC STORE │ SEMANTIC STORE │ PROCEDURAL │
│ (experiences) │ (facts) │ (skills) │
├─────────────────┴─────────────────┴─────────────────┤
│ CONSOLIDATION │
│ Episodes ───> Patterns ───> Knowledge │
├─────────────────────────────────────────────────────┤
│ RETRIEVAL │
│ Query ───> Embedding ───> Ranked Results │
└─────────────────────────────────────────────────────┘
Memory Types
Episodic Memory
Specific experiences and events. "Last time we processed an invoice from Acme Corp, field X was missing."
await memory.remember({
what: 'Processed invoice from Acme Corp',
outcome: 'Success - amount $5,432',
entities: [{ type: 'company', name: 'Acme Corp' }]
});Semantic Memory
Learned facts and patterns. "Acme Corp invoices always use format X."
await memory.learn({
fact: 'Acme Corp invoices always include PO number in header',
category: 'process',
confidence: 0.95
});Procedural Memory
Learned procedures and skills. "How to process an invoice from Acme Corp."
Memory Consolidation
The system automatically consolidates episodic memories into semantic knowledge. When enough similar experiences occur, patterns are extracted and stored as facts.
API Reference
POST /api/gfs/memoryRecord or learn memories
GET /api/gfs/memorySearch and recall memories
GET /api/gfs/memory/[id]Get specific memory or associations
Key Features
Vector Search
Semantic similarity for intelligent recall
Auto-Consolidation
Episodes become knowledge automatically
Associative Links
Memories connected in a knowledge graph
Context Building
LLM-ready context from memories