How elpapi42/pi-observational-memory works
pi-observational-memory is a Pi extension that preserves useful context across long sessions. Pi session activity enters through registered lifecycle hooks: background observation captures source-linked events, reflection distills durable facts, and dropper maintenance manages observation retention. The session ledger provides memory state for compaction rendering and ID-based recall. Configuration, model resolution, and worker streaming support that workflow; status and view commands expose memory to the user. The README documents these capabilities, while several subsystem links below are supported by its statements rather than inspected implementation details.
Main entry points: consolidation-trigger.ts Background consolidation · session-ledger Session ledger · index.ts Extension registration · status.ts Status and view
Components 21
Pi integration
- Extension registration
src/index.ts - Background consolidation
src/hooks/consolidation-trigger.ts - Compaction rendering
src/hooks/compaction-hook.ts - Compaction trigger
src/hooks/compaction-trigger.ts - Compaction catch-up
src/hooks/compaction-catch-up.ts - Recall tool
src/tools/recall-observation.ts - Status and view
src/commands/status.ts
Memory processing
- Observation capture
src/agents/observer/agent.ts - Reflection distillation
src/agents/reflector/agent.ts - Observation retention
src/agents/dropper/agent.ts - Reflection coverage
src/agents/dropper/coverage.ts - Observation pool
src/agents/dropper/pool.ts
Session memory
- Session ledger
src/session-ledger - Observation recall
src/session-ledger/recall.ts - Memory summary
src/session-ledger/render-summary.ts
Runtime support
- Runtime and model resolution
src/runtime.ts - Memory configuration
src/config.ts - Source serialization
src/serialize.ts - Worker stream dispatch
src/agents/worker-stream.ts
Other components
- Pi session
- Language model
Connections 32
- Pi session → Extension registration: loads extension
src/index.ts - Extension registration → Background consolidation: registers hook
src/index.ts - Extension registration → Compaction rendering: registers hook
src/index.ts - Extension registration → Compaction trigger: registers hook
src/index.ts - Extension registration → Recall tool: registers tool
src/index.ts - Background consolidation → Observation capture: runs observer
src/hooks/consolidation-trigger.ts - Background consolidation → Reflection distillation: runs reflector
src/hooks/consolidation-trigger.ts - Background consolidation → Observation retention: runs dropper
src/hooks/consolidation-trigger.ts - Background consolidation → Session ledger: reads and records
src/hooks/consolidation-trigger.ts - Background consolidation → Source serialization: serializes source
src/hooks/consolidation-trigger.ts - Observation retention → Observation pool: uses pool
src/agents/dropper/agent.ts - Observation retention → Reflection coverage: uses coverage
src/agents/dropper/agent.ts - Reflection distillation → Reflection coverage: assesses support
src/agents/reflector/agent.ts - Observation capture → Worker stream dispatch: resolves stream
src/agents/observer/agent.ts - Reflection distillation → Worker stream dispatch: resolves stream
src/agents/reflector/agent.ts - Observation capture → Language model: requests generation
src/agents/observer/agent.ts - Reflection distillation → Language model: requests generation
src/agents/reflector/agent.ts - Observation retention → Language model: requests generation
- Compaction rendering → Session ledger: reads memory
src/hooks/compaction-hook.ts - Compaction rendering → Compaction catch-up: uses catch-up
src/hooks/compaction-hook.ts - Compaction catch-up → Observation capture: runs observer
src/hooks/compaction-catch-up.ts - Compaction catch-up → Session ledger: reads and records
src/hooks/compaction-catch-up.ts - Compaction trigger → Session ledger: checks progress
src/hooks/compaction-trigger.ts - Recall tool → Observation recall: queries records
src/tools/recall-observation.ts - Recall tool → Session ledger: reads session state
src/tools/recall-observation.ts - Status and view → Session ledger: reads memory
src/commands/status.ts - Status and view → Runtime and model resolution: reads runtime state
src/commands/status.ts - Status and view → Observation pool: reads pool metrics
src/commands/status.ts - Runtime and model resolution → Memory configuration: loads settings
src/runtime.ts - Background consolidation → Runtime and model resolution: uses runtime
src/hooks/consolidation-trigger.ts - Compaction rendering → Runtime and model resolution: uses runtime
src/hooks/compaction-hook.ts - Status and view → Memory summary: renders memory