billion-context-pi 0.1.71 → 0.1.72-pr.468.270

package/README.md

@@ -132,6 +132,7 @@ billion-context-pi is built for the **Pi** coding agent (`@earendil-works/pi-cod
 | `decompress` | Restore a previously compressed block's content |
 | `search_context` | Search compressed block summaries (and visible messages) by keyword |
 | `acp_status` | Show context usage, compressed blocks, compressible ranges |
+| `acp_cache` | Prompt-cache reconciliation: grand ledger (input/cached/hit rate), per-request miss attribution, per-fold economics |
 | `acp_delegate` | Spawn a clean-context sub-agent for a task (review / research / implement / plan / advise) |
 | `acp_delegate_wait` | Block until a delegate run finishes (returns its result; times out otherwise) |
 | `acp_delegate_cancel` | Cancel a running delegate by runId |
@@ -171,7 +172,7 @@ If you already run another sub-agent extension (pi-subagents, pi-lens, …), tur
 ```
 
 - Equivalent object form: `{ "delegate": { "enabled": false } }`.
-- **What it removes:** the `acp_delegate`, `acp_delegate_wait` and `acp_delegate_cancel` tools, the `ACP_DELEGATE NOTIFICATIONS` system-prompt section, and the `ctrl+alt+f` fleet shortcut (`/acp-fleet` then reports that delegate is off). Compression is unaffected — `compress`, `decompress`, `search_context` and `acp_status` stay.
+- **What it removes:** the `acp_delegate`, `acp_delegate_wait` and `acp_delegate_cancel` tools, the `ACP_DELEGATE NOTIFICATIONS` system-prompt section, and the `ctrl+alt+f` fleet shortcut (`/acp-fleet` then reports that delegate is off). Compression is unaffected — `compress`, `decompress`, `search_context`, `acp_status` and `acp_cache` stay.
 - **When it applies:** the three tools are registered at session start, so a change needs a **new session** (or a Pi restart). The system-prompt section is resolved live on every turn, so it can disappear mid-session before the tools do.
 - Want to drop only the prompt section and keep the tools? Set `{ "delegatePrompt": null }`.
 - Pi's `--exclude-tools acp_delegate,acp_delegate_wait,acp_delegate_cancel` is **not** a substitute: it hides the tools but the model still receives the `ACP_DELEGATE NOTIFICATIONS` section describing tools it cannot call. Use `delegate: false`.
@@ -220,6 +221,18 @@ billion-context-pi works out of the box with no configuration — it reads your
 
 Behavior is tuned via an optional `acp.json` config file (`~/.pi/acp.json` for global defaults, `<project>/.pi/acp.json` for per-project overrides) plus a few environment variables. For the complete reference — every key, type, default, and the precedence order — see **[CONFIGURATION.md](./CONFIGURATION.md)** ([中文](./CONFIGURATION.zh-CN.md)).
 
+### Strict JSON
+
+`acp.json` is parsed by a **strict** JSON parser. Any of these makes the whole file fail to parse, so **every setting in it is ignored** and ACP behaves as if the file were absent:
+
+- object keys must be double-quoted — `"enabled": false`, not `enabled: false`
+- no trailing commas — `{ "enabled": false }`, not `{ "enabled": false, }`
+- no comments — `//` and `/* */` are not allowed
+- no BOM — Windows Notepad saves "UTF-8 with BOM" by default, which breaks parsing; use *Save as* → encoding **UTF-8** (not "UTF-8 with BOM"), or edit in VS Code (plain UTF-8)
+- `enabled` must be a literal boolean `false`, not the string `"false"`
+
+A malformed file no longer fails silently: the failure is printed to stderr at startup, shown as a warning at session start (TUI), written to `~/.pi/acp.log`, and listed under the `acp.json` section of `/acp` with the specific reason. Note the `enabled` master switch is read once when the agent starts, so after fixing the file you must fully restart the agent.
+
 ### Logging
 
 billion-context-pi writes a structured, always-on log to `~/.pi/acp.log` (override with `ACP_LOG_FILE`). It covers the model's whole working session and is useful for diagnosing problems:

package/dist/cache-tool.d.ts

@@ -0,0 +1,10 @@
+import { Type } from "typebox";
+import type { ExtensionContext, SessionEntry, ToolDefinition } from "@earendil-works/pi-coding-agent";
+import type { AcpRuntime } from "./runtime.js";
+import { type ToolPromptOverrides } from "./surface.js";
+import { type CacheSample } from "acp-kernel";
+declare const CacheParams: Type.TObject<{}>;
+export declare function cacheSamples(entries: SessionEntry[]): CacheSample[];
+export declare function cacheReportText(runtime: AcpRuntime, ctx: ExtensionContext): Promise<string>;
+export declare function makeCacheTool(runtime: AcpRuntime, overrides?: ToolPromptOverrides): ToolDefinition<typeof CacheParams>;
+export {};