ce2a109c09
- Added `memory.backend` and `hindsight.*` settings schema with migration from `memories.enabled` legacy mode. - Added Hindsight memory backend runtime modules for resolved config, client creation, bank ID derivation, and state lifecycle. - Added off/local/hindsight backends and resolver wiring across SDK, commands, and compaction context. - Added `hindsight_recall`, `hindsight_reflect`, and `hindsight_retain` tools with schema validation and backend gating. - Added Memory tab metadata and symbols to expose backend selection in the settings UI. - Added package export barrels and tests for bank ID, content formatting, and hindsight config env precedence.
@oh-my-pi/pi-coding-agent
Core implementation package for the omp coding agent in the oh-my-pi monorepo.
For installation, setup, provider configuration, model roles, slash commands, and full CLI reference, see:
Package-specific references:
Memory backends
The agent supports three mutually-exclusive memory backends, selected via the memory.backend setting (Settings → Memory tab, or ~/.omp/config.yml):
| Backend | Behaviour |
|---|---|
off |
No memory subsystem runs. |
local (default) |
Existing rollout-summarisation pipeline. Writes memory_summary.md and consolidated artifacts under the agent dir. Additionally gated by the legacy memories.enabled boolean — set it to true to actually run. |
hindsight |
Talks to a Hindsight server (Cloud or self-hosted Docker). Retains transcripts every Nth user turn, recalls memories on the first turn of a session, and exposes three tools: hindsight_retain, hindsight_recall, hindsight_reflect. |
Hindsight quickstart
- Run a Hindsight server (Cloud or
docker run -p 8888:8888 ghcr.io/vectorize-io/hindsight:latest). - Set
memory.backend = "hindsight"andhindsight.apiUrl = "http://localhost:8888"(or your Cloud URL). - Optional environment overrides (env wins over settings):
HINDSIGHT_API_URL,HINDSIGHT_API_TOKEN— connectionHINDSIGHT_BANK_ID,HINDSIGHT_DYNAMIC_BANK_ID,HINDSIGHT_AGENT_NAME— bank addressingHINDSIGHT_AUTO_RECALL,HINDSIGHT_AUTO_RETAIN,HINDSIGHT_RETAIN_MODE— lifecycleHINDSIGHT_RECALL_BUDGET,HINDSIGHT_RECALL_MAX_TOKENS— recall sizingHINDSIGHT_BANK_MISSION,HINDSIGHT_DEBUG
Switching backends mid-session is honoured on the next system-prompt rebuild and the next /memory slash command. Existing users with memories.enabled = true|false are migrated to memory.backend = "local"|"off" exactly once on first launch.