756fed844c
A branch whose last entry is a snapcompact CompactionEntry billed past the compaction threshold (FRAME_TOKEN_ESTIMATE x frames) dead-ended on every resume: prepareCompaction returns undefined (nothing after the entry to summarize), and the #4786 elide/image rescue tiers only inspect "message"/"custom_message" entries, so a type:"compaction" tail escaped both and the "Compaction freed too little context" warning re-fired forever. Add a dedicated first rescue tier that rebuilds the SAME archive locally (no LLM, no network) by re-running snapcompact.compact() over the entry's carried-forward source text at a maxFrames derived from the trigger threshold's recovery band instead of the window-fit budget: planArchive truncates the oldest chars to fit, so the rebuilt entry genuinely shrinks. Persisting through appendCompaction lets the write-time superseded-compaction elision drop the stale frame payload from the JSONL, and the pass skips the misleading no-progress warning. Fixes the loop reported in https://github.com/can1357/oh-my-pi/issues/4786#issuecomment-5056055342 Claude-Session: https://claude.ai/code/session_014rh4JyWFkxgMhgFaEf8VBY
@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):
off(default) — no memory subsystem runs.local— existing rollout-summarisation pipeline; writesmemory_summary.mdand consolidated artifacts under the agent dir.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 exposesretain,recall, andreflect.
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.