How v1b3x0r/living-memory-engine works
LME’s main workflow is an agent adding or recalling shared memory through an MCP tool: the server delegates to the memory engine, which retrieves, updates, and composes bounded context using storage and model-provider ports. The repository also contains the browser lab, which exercises the engine through chat, ambient observation, and a memory-inspection pane, plus a frozen mobile prototype. Core memory behavior is sourced from engine excerpts; hosted-world capabilities such as OAuth, handoffs, and client keys are documented but their server implementation is outside this repository.
Main entry points: src/engine.ts Memory engine · lib/engine.ts Browser engine setup · chat.ts Chat interface · debug.ts Memory inspector
Components 27
Memory engine
- Memory engine
engine/src/engine.ts - Memory lifecycle
engine/src/consolidation.ts - Semantic retrieval
engine/src/vector.ts - Memory attribution
engine/src/attribution.ts - Context injection
engine/src/inject.ts - Engine ports
engine/src/ports.ts - Provider adapters
engine/provider/adapters.ts
MCP server
- Tool server
lme-mcp/src/server.ts - Memory tools
lme-mcp/src/brain.ts - JSON snapshot
lme-mcp/src/storage.ts
Browser lab
- App bootstrap
web/src/main.ts - Chat interface
web/src/ui/chat.ts - Memory inspector
web/src/ui/debug.ts - Browser engine setup
web/src/lib/engine.ts - IndexedDB snapshots
web/src/lib/storage.ts - Ambient observer
web/src/lib/ambient.ts - Lab response
web/src/lib/labrespond.ts - World state
web/src/lib/world.ts - Personas
web/src/lib/personas.ts - Model profiles
web/src/lib/config.ts
Mobile prototype
- Mobile screens
mobile/app/index.tsx - Mobile engine setup
mobile/lib/engine.ts - SQLite snapshots
mobile/lib/storage.ts
Other components
- MCP agent
- OpenAI-compatible API
- Browser user
- Mobile user
Connections 27
- MCP agent → Tool server: calls tools
README.md - Tool server → Memory tools: dispatches tools
lme-mcp/src/server.ts - Memory tools → Memory engine: uses engine
lme-mcp/src/brain.ts - Memory tools → JSON snapshot: loads and saves
lme-mcp/src/brain.ts - Memory engine → Memory lifecycle: decays and merges
engine/src/engine.ts - Memory engine → Semantic retrieval: searches memories
engine/src/engine.ts - Memory engine → Memory attribution: places memories
engine/src/engine.ts - Memory engine → Context injection: formats context
engine/src/engine.ts - Memory engine → Engine ports: uses interfaces
engine/src/engine.ts - Provider adapters → Engine ports: implements ports
engine/provider/adapters.ts - Provider adapters → OpenAI-compatible API: calls API
- Browser user → App bootstrap: uses lab
README.md - App bootstrap → Chat interface: mounts chat
web/src/main.ts - App bootstrap → Memory inspector: mounts inspector
web/src/main.ts - Chat interface → Browser engine setup: gets engine
web/src/ui/chat.ts - Chat interface → Lab response: requests replies
web/src/ui/chat.ts - Chat interface → Personas: selects persona
web/src/ui/chat.ts - Browser engine setup → IndexedDB snapshots: creates storage
web/src/lib/engine.ts - Browser engine setup → Model profiles: configures providers
web/src/lib/engine.ts - Ambient observer → World state: updates world
web/src/lib/ambient.ts - Ambient observer → Browser engine setup: observes via engine
web/src/lib/ambient.ts - Memory inspector → Browser engine setup: inspects engine
web/src/ui/debug.ts - Memory inspector → Ambient observer: wipes world
web/src/ui/debug.ts - Memory inspector → Personas: selects persona
web/src/ui/debug.ts - Mobile user → Mobile screens: uses prototype
README.md - Mobile screens → Mobile engine setup: uses engine
- Mobile engine setup → SQLite snapshots: creates storage
mobile/lib/engine.ts