pi-blackhole 0.4.2 → 0.4.5

package/README.md

@@ -57,6 +57,21 @@ https://github.com/user-attachments/assets/a7dd804d-6aca-4bdb-8b6e-0dd779363a43
 
 
 
+---
+
+## Commands
+
+```text
+/blackhole                            Manual compact — deterministic structural summary
+/blackhole settings                   Open the configuration overlay (alias: /blackhole configure)
+/blackhole cleanup                    Remove orphaned pending files
+/blackhole om-off                     Disable observational memory
+/blackhole om-on                      Enable observational memory
+/blackhole-memory [status|view|full]  Memory pipeline status & token counters
+/blackhole-recall <query> [page:N] [scope:all] [mode:file|touched]
+                                      Search session history — also available to the agent as the `recall` tool
+```
+
 ---
 
 ## The problem it solves
@@ -263,6 +278,7 @@ Everything else has sensible defaults.
 | `compaction` | `"auto"` | When compaction triggers: `"auto"` (blackhole auto-fires), `"manual"` (only `/blackhole`), `"off"` (Pi handles auto + `/compact`, `/blackhole` still works) |
 | `compactionEngine` | `"blackhole"` | Which engine handles auto-compaction: `"blackhole"` or `"pi-default"`. Only meaningful when `compaction: "auto"` — for `"manual"`/`"off"` the hook lets Pi handle everything except `/blackhole` |
 | `tailBehavior` | `"minimal"` | How much stays visible after compaction: `"minimal"` (last user message only, default) or `"pi-default"` (gentle, ~20k tokens). Both `/blackhole` and auto-triggered default to `"minimal"`; set explicitly to opt into gentler cut |
+| `midRunCompaction` | `"off"` | `"resume"` *(experimental)* opts into transparent compaction during long tool loops without replacing the active run; `"pause"` interrupts, compacts, and stops; `"off"` only checks when the run ends. Transparent mode fails closed on unsupported Pi internals. |
 | `memory` | `true` | `false` = OM workers off + no memory injection (compaction still runs) |
 | `model` | — | Base fallback model for all workers (last resort before session model) |
 | `observerModel` / `observerFallbackModels` | — / `[]` | Primary + fallback models for observer (extracts facts) |
@@ -283,6 +299,7 @@ Everything else has sensible defaults.
 | `dropperInputMaxTokens` | `80000` | Max dropper input budget |
 | `dropperPressureThreshold` | `0.70` | Fraction of `reflectorInputMaxTokens` at which dropper runs even without new data (pressure relief valve) |
 | `agentMaxTurns` | `16` | Max agent-loop turns per worker per run |
+| `providerIdleTimeoutMs` | unset | Body-idle timeout for background provider streams (ms); `0` = disabled, unset = inherit pi's default |
 | `debug` | `false` | Pre-compaction snapshot to `/tmp/pi-blackhole-debug.json` |
 | `debugLog` | `false` | Continuous JSONL debug log to `~/.pi/agent/pi-blackhole/debug.ndjson` |