afucontext 0.1.18 → 0.1.20

package/README.md

@@ -20,13 +20,13 @@ Install and sign in to your host first. You need npm, Node.js **22.19+ (22.x) or
 
 | Host | System | Install | Launch after installation | Tested version |
 | --- | --- | --- | --- | --- |
-| <a id="afu-claude"></a>Claude Code | macOS / Linux | `npx --yes --registry=https://registry.npmjs.org afucontext@0.1.18 install claude` | `claude` | 2.1.293 |
-| <a id="afu-codex"></a>Codex CLI | macOS / Linux | `npx --yes --registry=https://registry.npmjs.org afucontext@0.1.18 install codex` | `codex` | 0.153.4 |
-| <a id="afu-pi"></a>Pi | macOS / Linux | `npx --yes --registry=https://registry.npmjs.org afucontext@0.1.18 install pi` | `pi` | 0.84.4, 1.5.0 |
-| <a id="afu-dsh"></a>DSH | macOS / Linux | `npx --yes --registry=https://registry.npmjs.org afucontext@0.1.18 install dsh --profile YOUR_PROFILE` | `dsh --profile YOUR_PROFILE` | 0.2.2-rc.1 |
-| Codex CLI | Windows 10/11¹ | `npx.cmd --yes --registry=https://registry.npmjs.org "afucontext@0.1.18" install codex` | `codex` | preview, not yet tested; official in the next release |
-| Pi | Windows 10/11¹ | `npx.cmd --yes --registry=https://registry.npmjs.org "afucontext@0.1.18" install pi` | `pi` | preview, not yet tested; official in the next release |
-| DSH | Windows 10/11¹ | `npx.cmd --yes --registry=https://registry.npmjs.org "afucontext@0.1.18" install dsh --profile YOUR_PROFILE` | `dsh --profile YOUR_PROFILE` | preview, not yet tested; official in the next release |
+| <a id="afu-claude"></a>Claude Code | macOS / Linux | `npx --yes --registry=https://registry.npmjs.org afucontext@0.1.20 install claude` | `claude` | 2.1.293 |
+| <a id="afu-codex"></a>Codex CLI | macOS / Linux | `npx --yes --registry=https://registry.npmjs.org afucontext@0.1.20 install codex` | `codex` | 0.153.4 |
+| <a id="afu-pi"></a>Pi | macOS / Linux | `npx --yes --registry=https://registry.npmjs.org afucontext@0.1.20 install pi` | `pi` | 0.84.4, 1.5.0 |
+| <a id="afu-dsh"></a>DSH | macOS / Linux | `npx --yes --registry=https://registry.npmjs.org afucontext@0.1.20 install dsh --profile YOUR_PROFILE` | `dsh --profile YOUR_PROFILE` | 0.2.2-rc.1 |
+| Codex CLI | Windows 10/11¹ | `npx.cmd --yes --registry=https://registry.npmjs.org "afucontext@0.1.20" install codex` | `codex` | preview, not yet tested; official in the next release |
+| Pi | Windows 10/11¹ | `npx.cmd --yes --registry=https://registry.npmjs.org "afucontext@0.1.20" install pi` | `pi` | preview, not yet tested; official in the next release |
+| DSH | Windows 10/11¹ | `npx.cmd --yes --registry=https://registry.npmjs.org "afucontext@0.1.20" install dsh --profile YOUR_PROFILE` | `dsh --profile YOUR_PROFILE` | preview, not yet tested; official in the next release |
 
 Supported on macOS (Apple Silicon) and Linux x64. Start a new session after installing.
 
@@ -38,7 +38,7 @@ Supported on macOS (Apple Silicon) and Linux x64. Start a new session after inst
 
 ## Commands
 
-The terminal commands (`afuctx …`) are placed in `~/.local/bin` by the first install; if that folder is not on `PATH`, use `npx --yes --registry=https://registry.npmjs.org afucontext@latest` in place of `afuctx`. Install, upgrade and remove replace the runtime itself, so they always run through npx.
+The terminal commands (`afuctx …`) are placed in `~/.local/bin` by the first install of any host (the folder is created when missing). If that folder is not on `PATH`, the installer says so: add `export PATH="$HOME/.local/bin:$PATH"` to `~/.bashrc` or `~/.zshrc`, or use `npx --yes --registry=https://registry.npmjs.org afucontext@latest` in place of `afuctx`. Install, upgrade and remove replace the runtime itself, so they always run through npx.
 
 | Command | What it does |
 | --- | --- |
@@ -48,6 +48,8 @@ The terminal commands (`afuctx …`) are placed in `~/.local/bin` by the first i
 | `npx --yes --registry=https://registry.npmjs.org afucontext@latest remove HOST` | Remove; host settings return to their state before installation. For DSH, `--profile NAME` removes one profile |
 | `afuctx status` | Whether each host is connected, how far the context is from the trigger, compactions applied; `--json` for the full record |
 | `afuctx dashboard` | Open the local dashboard (same as `afuctx-admin`); `--prices FILE` estimates costs with your prices |
+| `afuctx doctor` | Checks host → AFU → model end to end, fixes what AFU can and gives exact steps for the rest; add a host name to check one |
+| `afuctx off` / `afuctx on` | Pause / resume: while paused the hosts talk to their models directly; the installation, logs and summaries stay. Add a host name for one host |
 | `afuctx repair codex --network` | Find and verify the proxy route to the model again (`repair claude` for Claude Code) |
 | `afuctx gc --dry-run` | List old runtimes and logs that can be removed; without `--dry-run` it removes them |
 | `afuctx --version` / `afuctx --help` | Version / help |
@@ -60,6 +62,19 @@ Inside a host session:
 | Codex | `$afuctx-status` | `$afuctx-dashboard` |
 | Pi / DSH | `/afuctx-status` | `/afuctx-dashboard` |
 
+## When something goes wrong
+
+| What you see | Do first |
+| --- | --- |
+| After installing, the host cannot connect or keeps reconnecting | `afuctx off`: the host talks to its model directly right away. Then `afuctx doctor` to find the cause, and `afuctx on` once fixed |
+| Status says the model service is unreachable | `afuctx doctor` (or, for the network only, `afuctx repair codex --network`) |
+| A proxy app keeps the host from reaching AFU on this machine | Add `127.0.0.1` and `localhost` to the proxy app's bypass/exception list (for example AntFamily); `afuctx doctor` checks this |
+| Settings or hooks were damaged | Run the install command again |
+| No compaction after a reboot | Open a host session once (its hook starts AFU) |
+| You no longer want AFU | `remove`: the host's settings return to how they were before install |
+
+When AFU cannot reach the model service several times in a row, it looks for another working route by itself and verifies it (only AFU's own record changes); the dashboard shows it.
+
 ## Benchmark results
 
 In a LongBench V2 replay of 39 history questions (20 agent histories and 19 dialogue histories), AFU’s asynchronous strategy answered **23 correctly** with an average context of **15.9k tokens**.
@@ -89,7 +104,7 @@ In a LongBench V2 replay of 39 history questions (20 agent histories and 19 dial
 
 - The dashboard runs in the background and does not occupy a terminal; opening it again reuses the same one, and it exits after 30 minutes without an open page.
 - It opens in the dark theme; switch to light, follow-system or English/Chinese in the top-right corner.
-- The terminal commands are placed in `~/.local/bin` by the installer (only when that folder is already on `PATH`; shell startup files are never edited and existing commands of the same name are kept) and are removed with the last integration.
+- The terminal commands are placed in `~/.local/bin` by the installer for every host, creating the folder when needed. Shell startup files are never edited (the installer prints the line to add when the folder is not on `PATH`) and an existing command of the same name is kept (the installer says so). They are removed with the last integration, whichever host that is.
 
 ### Check the current session
 
@@ -98,8 +113,8 @@ Type `/afuctx:status` in Claude Code, `$afuctx-status` in Codex, `/afuctx-status
 Without the terminal commands (for example when `~/.local/bin` is not on `PATH`), use the full npx commands. For Codex; for another host replace `codex` with `claude`, `pi` or `dsh`:
 
 ```sh
-npx --yes --registry=https://registry.npmjs.org afucontext@0.1.18 status codex --brief
-npx --yes --registry=https://registry.npmjs.org afucontext@0.1.18 ui
+npx --yes --registry=https://registry.npmjs.org afucontext@0.1.20 status codex --brief
+npx --yes --registry=https://registry.npmjs.org afucontext@0.1.20 ui
 ```
 
 ### What the dashboard shows
@@ -145,12 +160,12 @@ Run the same install command with options, then start a new session. For Codex;
 
 ```sh
 # Trigger at 30% of a manually set 200,000-token window (60,000 tokens)
-npx --yes --registry=https://registry.npmjs.org afucontext@0.1.18 install codex --context-window 200000 --ratio 0.3
+npx --yes --registry=https://registry.npmjs.org afucontext@0.1.20 install codex --context-window 200000 --ratio 0.3
 # Restore automatic settings
-npx --yes --registry=https://registry.npmjs.org afucontext@0.1.18 install codex --context-window auto --ratio auto
+npx --yes --registry=https://registry.npmjs.org afucontext@0.1.20 install codex --context-window auto --ratio auto
 ```
 
-For frequent use, run `npm install -g --registry=https://registry.npmjs.org afucontext@0.1.18` and use `afuctx` in place of the full `npx` invocation. For example, `afuctx dashboard --prices ./afu-prices.json` opens the dashboard with your price file to estimate costs.
+For frequent use, run `npm install -g --registry=https://registry.npmjs.org afucontext@0.1.20` and use `afuctx` in place of the full `npx` invocation. For example, `afuctx dashboard --prices ./afu-prices.json` opens the dashboard with your price file to estimate costs.
 
 ## Upgrade and remove
 
@@ -172,8 +187,8 @@ npx --yes --registry=https://registry.npmjs.org afucontext@latest status --brief
 To upgrade or remove one host:
 
 ```sh
-npx --yes --registry=https://registry.npmjs.org afucontext@0.1.18 upgrade codex
-npx --yes --registry=https://registry.npmjs.org afucontext@0.1.18 remove codex
+npx --yes --registry=https://registry.npmjs.org afucontext@0.1.20 upgrade codex
+npx --yes --registry=https://registry.npmjs.org afucontext@0.1.20 remove codex
 ```
 
 Use `remove pi` or `remove dsh` for those integrations. In Windows PowerShell, use `npx.cmd` and double-quote the package name.

package/README.zh-CN.md

@@ -20,13 +20,13 @@
 
 | 宿主 | 系统 | 一键安装 | 安装后启动 | 实测版本 |
 | --- | --- | --- | --- | --- |
-| <a id="afu-claude"></a>Claude Code | macOS / Linux | `npx --yes --registry=https://registry.npmjs.org afucontext@0.1.18 install claude` | `claude` | 2.1.293 |
-| <a id="afu-codex"></a>Codex CLI | macOS / Linux | `npx --yes --registry=https://registry.npmjs.org afucontext@0.1.18 install codex` | `codex` | 0.153.4 |
-| <a id="afu-pi"></a>Pi | macOS / Linux | `npx --yes --registry=https://registry.npmjs.org afucontext@0.1.18 install pi` | `pi` | 0.84.4、1.5.0 |
-| <a id="afu-dsh"></a>DSH | macOS / Linux | `npx --yes --registry=https://registry.npmjs.org afucontext@0.1.18 install dsh --profile YOUR_PROFILE` | `dsh --profile YOUR_PROFILE` | 0.2.2-rc.1 |
-| Codex CLI | Windows 10/11¹ | `npx.cmd --yes --registry=https://registry.npmjs.org "afucontext@0.1.18" install codex` | `codex` | 预览，未实测，下一版本正式提供 |
-| Pi | Windows 10/11¹ | `npx.cmd --yes --registry=https://registry.npmjs.org "afucontext@0.1.18" install pi` | `pi` | 预览，未实测，下一版本正式提供 |
-| DSH | Windows 10/11¹ | `npx.cmd --yes --registry=https://registry.npmjs.org "afucontext@0.1.18" install dsh --profile YOUR_PROFILE` | `dsh --profile YOUR_PROFILE` | 预览，未实测，下一版本正式提供 |
+| <a id="afu-claude"></a>Claude Code | macOS / Linux | `npx --yes --registry=https://registry.npmjs.org afucontext@0.1.20 install claude` | `claude` | 2.1.293 |
+| <a id="afu-codex"></a>Codex CLI | macOS / Linux | `npx --yes --registry=https://registry.npmjs.org afucontext@0.1.20 install codex` | `codex` | 0.153.4 |
+| <a id="afu-pi"></a>Pi | macOS / Linux | `npx --yes --registry=https://registry.npmjs.org afucontext@0.1.20 install pi` | `pi` | 0.84.4、1.5.0 |
+| <a id="afu-dsh"></a>DSH | macOS / Linux | `npx --yes --registry=https://registry.npmjs.org afucontext@0.1.20 install dsh --profile YOUR_PROFILE` | `dsh --profile YOUR_PROFILE` | 0.2.2-rc.1 |
+| Codex CLI | Windows 10/11¹ | `npx.cmd --yes --registry=https://registry.npmjs.org "afucontext@0.1.20" install codex` | `codex` | 预览，未实测，下一版本正式提供 |
+| Pi | Windows 10/11¹ | `npx.cmd --yes --registry=https://registry.npmjs.org "afucontext@0.1.20" install pi` | `pi` | 预览，未实测，下一版本正式提供 |
+| DSH | Windows 10/11¹ | `npx.cmd --yes --registry=https://registry.npmjs.org "afucontext@0.1.20" install dsh --profile YOUR_PROFILE` | `dsh --profile YOUR_PROFILE` | 预览，未实测，下一版本正式提供 |
 
 支持 macOS（Apple Silicon）和 x64 Linux；安装后新开会话即可。
 
@@ -38,7 +38,7 @@
 
 ## 命令一览
 
-终端命令（`afuctx …`）在首次安装后放到 `~/.local/bin`；该目录不在 `PATH` 时，把 `afuctx` 换成 `npx --yes --registry=https://registry.npmjs.org afucontext@latest`。安装、升级、移除这类会替换运行时本身的命令，始终用 npx 执行。
+终端命令（`afuctx …`）在首次安装任一宿主后放到 `~/.local/bin`，目录不存在时会自动创建。该目录不在 `PATH` 时，安装程序会提示：把 `export PATH="$HOME/.local/bin:$PATH"` 加到 `~/.bashrc` 或 `~/.zshrc`，或者把 `afuctx` 换成 `npx --yes --registry=https://registry.npmjs.org afucontext@latest`。安装、升级、移除这类会替换运行时本身的命令，始终用 npx 执行。
 
 | 命令 | 作用 |
 | --- | --- |
@@ -48,6 +48,8 @@
 | `npx --yes --registry=https://registry.npmjs.org afucontext@latest remove 宿主` | 移除，宿主配置恢复成安装前的样子；DSH 可加 `--profile 名称` 只移除一个 profile |
 | `afuctx status` | 各宿主是否接入、当前上下文离触发线多远、已压缩几次；加 `--json` 输出完整信息 |
 | `afuctx dashboard` | 打开本地面板（同 `afuctx-admin`）；`--prices 文件` 用自己的单价估算费用 |
+| `afuctx doctor` | 检查"宿主 → AFU → 模型"整条链路，能修的直接修，修不了的给出具体步骤；加宿主名只查一个 |
+| `afuctx off` / `afuctx on` | 暂停 / 恢复：暂停时宿主直连模型，AFU 的安装、日志、摘要都保留；加宿主名只作用于一个 |
 | `afuctx repair codex --network` | 重新查找并验证连到模型服务的代理（Claude Code 用 `repair claude`） |
 | `afuctx gc --dry-run` | 查看可清理的旧版本运行时和日志；去掉 `--dry-run` 才会真正清理 |
 | `afuctx --version` / `afuctx --help` | 版本号 / 帮助 |
@@ -60,6 +62,19 @@
 | Codex | `$afuctx-status` | `$afuctx-dashboard` |
 | Pi / DSH | `/afuctx-status` | `/afuctx-dashboard` |
 
+## 出问题时怎么办
+
+| 现象 | 先做 |
+| --- | --- |
+| 装了以后宿主连不上、一直重连 | `afuctx off`，宿主立即恢复直连模型；之后运行 `afuctx doctor` 查原因，修好后 `afuctx on` |
+| 状态提示连不上模型服务 | `afuctx doctor`（只查网络也可以 `afuctx repair codex --network`） |
+| 代理软件导致连不上本机 AFU | 在代理软件（如 AntFamily）的例外 / 绕过列表里加入 `127.0.0.1` 和 `localhost`；`afuctx doctor` 会检查 |
+| 配置或 hook 被改坏 | 重新执行安装命令 |
+| 重启后不压缩 | 开一次宿主会话（hook 会拉起 AFU） |
+| 彻底不用 | `remove`，宿主配置恢复成安装前的样子 |
+
+AFU 连续几次连不上模型服务时，会自动重新查找并验证一条能用的网络路线（只改 AFU 自己的记录），面板里能看到。
+
 ## 评测效果
 
 在 LongBench V2 的 39 道历史问答回放中（20 道 Agent 历史、19 道对话历史），AFU 异步压缩答对 **23 道**，平均上下文为 **15.9k tokens**。
@@ -89,7 +104,7 @@
 
 - 面板在后台运行，不占用终端；再次打开会复用同一个面板，30 分钟没有页面打开时自动退出。
 - 默认暗色主题，右上角可切换亮色、跟随系统和中英文。
-- 终端命令由安装程序放在 `~/.local/bin`（已在 `PATH` 中时才放，不改 shell 配置，不覆盖你已有的同名命令），移除最后一个接入时一并删除。
+- 终端命令由安装程序放在 `~/.local/bin`，四个宿主都会放，目录不存在时自动创建。不改 shell 配置（目录不在 `PATH` 时会提示要加的那一行），不覆盖你已有的同名命令（会提示未覆盖）。移除最后一个接入时一并删除，不论是哪个宿主。
 
 ### 查看当前会话
 
@@ -98,8 +113,8 @@ Claude Code 输入 `/afuctx:status`，Codex 输入 `$afuctx-status`，Pi 和 DSH
 没有上面的终端命令时（例如 `~/.local/bin` 不在 `PATH` 中），可以用完整的 npx 命令。以 Codex 为例，其它宿主将 `codex` 换成 `claude`、`pi` 或 `dsh`：
 
 ```sh
-npx --yes --registry=https://registry.npmjs.org afucontext@0.1.18 status codex --brief
-npx --yes --registry=https://registry.npmjs.org afucontext@0.1.18 ui
+npx --yes --registry=https://registry.npmjs.org afucontext@0.1.20 status codex --brief
+npx --yes --registry=https://registry.npmjs.org afucontext@0.1.20 ui
 ```
 
 ### 面板内容
@@ -145,12 +160,12 @@ npx --yes --registry=https://registry.npmjs.org afucontext@0.1.18 ui
 
 ```sh
 # 在 30% 触发，并手动指定 200,000 的窗口（即 60,000 触发）
-npx --yes --registry=https://registry.npmjs.org afucontext@0.1.18 install codex --context-window 200000 --ratio 0.3
+npx --yes --registry=https://registry.npmjs.org afucontext@0.1.20 install codex --context-window 200000 --ratio 0.3
 # 恢复自动设置
-npx --yes --registry=https://registry.npmjs.org afucontext@0.1.18 install codex --context-window auto --ratio auto
+npx --yes --registry=https://registry.npmjs.org afucontext@0.1.20 install codex --context-window auto --ratio auto
 ```
 
-如果经常使用 AFU，可运行 `npm install -g --registry=https://registry.npmjs.org afucontext@0.1.18`，以后用 `afuctx` 代替完整的 `npx` 命令。例如，`afuctx dashboard --prices ./afu-prices.json` 用自己的单价文件打开面板估算费用。
+如果经常使用 AFU，可运行 `npm install -g --registry=https://registry.npmjs.org afucontext@0.1.20`，以后用 `afuctx` 代替完整的 `npx` 命令。例如，`afuctx dashboard --prices ./afu-prices.json` 用自己的单价文件打开面板估算费用。
 
 ## 升级与移除
 
@@ -172,8 +187,8 @@ npx --yes --registry=https://registry.npmjs.org afucontext@latest status --brief
 只升级或移除某一个宿主：
 
 ```sh
-npx --yes --registry=https://registry.npmjs.org afucontext@0.1.18 upgrade codex
-npx --yes --registry=https://registry.npmjs.org afucontext@0.1.18 remove codex
+npx --yes --registry=https://registry.npmjs.org afucontext@0.1.20 upgrade codex
+npx --yes --registry=https://registry.npmjs.org afucontext@0.1.20 remove codex
 ```
 
 Pi 和 DSH 可分别用 `remove pi` 或 `remove dsh` 撤销。Windows PowerShell 请使用 `npx.cmd` 并将包名放在双引号中。

package/bin/afu.mjs

@@ -13,7 +13,7 @@ const root=resolve(dirname(fileURLToPath(import.meta.url)),'..');
 const manifest=JSON.parse(readFileSync(join(root,'release.json'),'utf8'));
 const env={...process.env,AFU_INSTALL_ROOT:root};
 let args=process.argv.slice(2);
-if(['install','upgrade','status','remove','gc','native','repair'].includes(args[0])){
+if(['install','upgrade','status','remove','gc','native','repair','off','on','doctor'].includes(args[0])){
  const at=args.indexOf('--state');if(at>=0&&args[at+1])env.AFU_STATE_DIR=resolve(args[at+1]);
  const inline=args.find(a=>a.startsWith('--state='));if(inline&&inline.length>8)env.AFU_STATE_DIR=resolve(inline.slice(8));
 }

package/bin/host-autoload.py

@@ -456,6 +456,8 @@ def main():
                     "autoload": registrations,
                     "plugin_runtime": plugin_runtime,
                     "removed": not registrations and not plugin_runtime,
+                    # A removed integration is not paused: a later install starts active.
+                    "paused": bool(old.get("paused")) and bool(registrations or plugin_runtime),
                 },
             )
         else:
@@ -512,6 +514,7 @@ def main():
                     "host": host,
                     "mode": "host",
                     "removed": False,
+                    "paused": bool(old.get("paused")) and not old.get("removed"),
                     "plugin_runtime": args.runtime_only or bool(old.get("plugin_runtime")),
                     **({"host_version": host_version} if host_version else {}),
                     "window": window,
@@ -521,6 +524,11 @@ def main():
                     "autoload": registrations,
                 },
             )
+    from afu_context.management import active_integrations, install_shortcut, remove_shortcut, shortcut_notes
+    if args.action == "remove":
+        shortcut, removed = None, (remove_shortcut() if not active_integrations(root) else False)
+    else:
+        shortcut, removed = install_shortcut(root), None
     print(
         json.dumps(
             {
@@ -530,9 +538,14 @@ def main():
                 "mode": "host",
                 "registrations": sorted(registrations),
                 "launch": "pi" if host == "pi" else "dsh --profile " + key,
+                **({"shortcut": shortcut} if shortcut is not None else {}),
+                **({"shortcut_removed": removed} if removed is not None else {}),
             }
         )
     )
+    if not args.json:
+        for line in shortcut_notes(shortcut):
+            print("AFU: " + line, file=sys.stderr)
 
 
 if __name__ == "__main__":

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "afucontext",
-  "version": "0.1.18",
+  "version": "0.1.20",
   "type": "module",
   "license": "Apache-2.0",
   "description": "Local asynchronous context compression and diagnostics",

package/release.json

@@ -1,7 +1,7 @@
 {
-  "version": "0.1.18",
+  "version": "0.1.20",
   "name": "afucontext",
-  "build": "238e9b3dd5de64befa91b526eb807222ca9a3d5562d66f9c2bbe750dfd5cd1e5",
-  "wheel": "afu_context_local-0.1.18-py3-none-any.whl",
+  "build": "7103b588cc60356b806eefbe524a14ee65eb28e04c9536bf6c022892af50c437",
+  "wheel": "afu_context_local-0.1.20-py3-none-any.whl",
   "prebuilt": false
 }

package/src/afu_host_integrations/dsh/dist/index.js

@@ -1,6 +1,6 @@
 import { BasicCompactionEngine as BundledBasicCompactionEngine, } from "@deepseek-ai/dsh-compaction-basic";
 import { BlockAssembler as BundledBlockAssembler, createUserMessage as bundledCreateUserMessage, } from "@deepseek-ai/dsh-llm";
-import { journal, sessionHash, afuTrigger, summaryPrefix, observationId, HostCompactPool, bindingKey, estimateContentTokens, findAppliedArtifact, normalizeContent, } from "../../shared/runtime-client/dist/index.js";
+import { journal, sessionHash, afuTrigger, afuPaused, summaryPrefix, observationId, HostCompactPool, bindingKey, estimateContentTokens, findAppliedArtifact, normalizeContent, } from "../../shared/runtime-client/dist/index.js";
 const hostModules = (globalThis.__afuDshHost) ?? {};
 const BasicCompactionEngine = typeof hostModules.BasicCompactionEngine === "function" ? hostModules.BasicCompactionEngine : BundledBasicCompactionEngine;
 const BlockAssembler = typeof hostModules.BlockAssembler === "function" ? hostModules.BlockAssembler : BundledBlockAssembler;
@@ -78,7 +78,7 @@ export class CompactDshEngine extends BasicCompactionEngine {
             ctx.logger.warn("compact idle preparation unavailable; native compaction remains active");
         });
         ctx.on("agent/status", async ({ agent, status }) => {
-            if (status !== "idle")
+            if (status !== "idle" || afuPaused("dsh"))
                 return;
             // Context size as DSH's own token meter prices it, plus the AFU trigger for the routed model.
             let tokens, window;
@@ -140,6 +140,9 @@ export class CompactDshEngine extends BasicCompactionEngine {
         return tokens === undefined ? request : { ...request, metadata: { ...request.metadata, host_context_tokens: tokens } };
     }
     async compactIfNeeded(agent, trigger, signal) {
+        // afuctx off: DSH's own compaction, unchanged.
+        if (afuPaused("dsh"))
+            return super.compactIfNeeded(agent, trigger, signal);
         const started = performance.now();
         this.handoffCommitted.delete(agent);
         try {
@@ -200,6 +203,8 @@ export class CompactDshEngine extends BasicCompactionEngine {
         }
     }
     async summarize(input, agent, signal) {
+        if (afuPaused("dsh"))
+            return super.summarize(input, agent, signal);
         let request;
         try {
             request = await this.boundRequest(agent, input.messages, "sync");
@@ -220,6 +225,12 @@ export class CompactDshEngine extends BasicCompactionEngine {
             this.handoff(agent, prepared);
             return { ...preparedSummary, provider: target.provider, model: target.model };
         }
+        if (prepared !== undefined) {
+            // Previously only slower; now visible: the advance summary did not fit.
+            const artifact = findAppliedArtifact(prepared);
+            this.log("summary_skipped", { session: sessionHash(agent.session.id), reason: "host_prepared_unused",
+                ...(observationId(prepared) ?? artifact?.artifactId ? { artifact_id: observationId(prepared) ?? artifact?.artifactId } : {}) });
+        }
         try {
             const result = await this.compactClient.compact(request, signal);
             const summary = dshSummaryFromResult(request, result);
@@ -400,22 +411,67 @@ export function dshMessagesToRequest(messages, sessionId, mode = "active") {
     };
 }
 /**
- * Resolve a prepared Artifact to the exact DSH surface span it covers.
- * Stale, reordered, or non-contiguous coverage is rejected without mutation.
+ * Where a prepared summary's coverage lies in a request, matched loosely.
+ *
+ * DSH messages have stable ids. The summary's last covered id is the anchor
+ * and must be present; the region runs from the first covered id found to the
+ * anchor. Items inside it the summary does not know (inserted by DSH or a
+ * plugin) are replaced with the rest, as long as they are few; covered ids
+ * that are gone do not matter. System items are context, never coverage.
+ */
+export function dshLooseCover(items, replacedIds) {
+    const anchor = replacedIds.at(-1);
+    let end = -1;
+    for (let k = items.length - 1; k >= 0; k--)
+        if (items[k].id === anchor) {
+            end = k;
+            break;
+        }
+    if (anchor === undefined || end < 0)
+        return { reason: "anchor_not_found" };
+    const known = new Set(replacedIds);
+    const start = items.findIndex((item) => known.has(item.id));
+    // Covered ids out of their recorded order, or after the anchor: not the
+    // history it summarized.
+    for (let k = end + 1; k < items.length; k++)
+        if (known.has(items[k].id))
+            return { reason: "anchor_not_found" };
+    const order = new Map(replacedIds.map((id, k) => [id, k]));
+    let last = -1;
+    for (let k = start; k <= end; k++) {
+        const position = order.get(items[k].id);
+        if (position === undefined)
+            continue;
+        if (position < last)
+            return { reason: "anchor_not_found" };
+        last = position;
+    }
+    let unknown = 0, found = 0;
+    for (let k = start; k <= end; k++) {
+        if (items[k].kind === "system")
+            continue;
+        if (known.has(items[k].id))
+            found++;
+        else
+            unknown++;
+    }
+    if (unknown > Math.max(3, Math.floor(0.2 * (unknown + found))) || unknown > found)
+        return { reason: "low_overlap" };
+    return { start, end, unknown };
+}
+/**
+ * Resolve a prepared Artifact to the DSH surface span it covers (loosely; see
+ * dshLooseCover). Anything that cannot be located is rejected without mutation.
  */
 export function dshPreparedRange(session, request, result) {
     const artifact = findAppliedArtifact(result);
     if (artifact === undefined)
         return undefined;
-    const requestIds = request.items.map((item) => item.id);
-    const startIndex = requestIds.indexOf(artifact.replacedItemIds[0] ?? "");
-    if (startIndex < 0)
+    const cover = dshLooseCover(request.items, artifact.replacedItemIds);
+    if ("reason" in cover)
         return undefined;
-    const coveredIds = requestIds.slice(startIndex, startIndex + artifact.replacedItemIds.length);
-    if (coveredIds.length !== artifact.replacedItemIds.length ||
-        coveredIds.some((id, index) => id !== artifact.replacedItemIds[index])) {
-        return undefined;
-    }
+    const startId = request.items[cover.start].id;
+    const endId = request.items[cover.end].id;
     const seqByMessageId = new Map();
     for (const seq of session.surface.nodes) {
         const event = session.eventAt(seq);
@@ -425,26 +481,29 @@ export function dshPreparedRange(session, request, result) {
         if (message !== null)
             seqByMessageId.set(String(message.id), seq);
     }
-    const start = seqByMessageId.get(artifact.replacedItemIds[0] ?? "");
-    const end = seqByMessageId.get(artifact.replacedItemIds.at(-1) ?? "");
+    const start = seqByMessageId.get(startId);
+    const end = seqByMessageId.get(endId);
     return start === undefined || end === undefined ? undefined : { start, end };
 }
-/** Return a DSH summary only when one Artifact covers the whole selected input. */
+/**
+ * A DSH summary when one Artifact covers the region DSH selected (loosely):
+ * its anchor must be the region's last conversation item, so nothing DSH
+ * keeps after the region is described or lost; a few unknown items inside the
+ * region are summarized away with it.
+ */
 export function dshSummaryFromResult(request, result) {
     const artifact = findAppliedArtifact(result);
     if (artifact === undefined || typeof artifact.item.content !== "string")
         return undefined;
+    const conversation = request.items.filter((item) => item.kind !== "system");
+    if (conversation.at(-1)?.id !== artifact.replacedItemIds.at(-1))
+        return undefined;
     // DSH 0.2 replays the system head in front of the region it summarizes;
-    // the summary replaces only the region, so a leading system message is
-    // context, not coverage.
-    let first = 0;
-    while (first < request.items.length && request.items[first].kind === "system" && request.items[first].id !== artifact.replacedItemIds[0])
-        first++;
-    const requestIds = request.items.slice(first).map((item) => item.id);
-    if (artifact.replacedItemIds.length !== requestIds.length ||
-        artifact.replacedItemIds.some((id, index) => id !== requestIds[index])) {
+    // the summary replaces only the region, so system messages are context.
+    const known = new Set(artifact.replacedItemIds);
+    const unknown = conversation.filter((item) => !known.has(item.id)).length;
+    if (unknown > Math.max(3, Math.floor(0.2 * conversation.length)) || unknown > conversation.length - unknown)
         return undefined;
-    }
     const summary = [{ type: "text", text: artifact.item.content }];
     return {
         summary,

package/src/afu_host_integrations/pi/dist/index.js

@@ -1,5 +1,29 @@
+import { createHash } from "node:crypto";
 import { sessionEntryToContextMessages, convertToLlm, estimateTokens, getAgentDir, SettingsManager, DEFAULT_COMPACTION_SETTINGS } from "@earendil-works/pi-coding-agent";
-import { journal, sessionHash, afuTrigger, summaryPrefix, observationId, afuStatus, afuDashboard, STATUS_COMMAND, DASHBOARD_COMMAND, CompactWorkerClient, HostCompactPool, bindingKey, findAppliedArtifact, normalizeContent, } from "../../shared/runtime-client/dist/index.js";
+import { journal, sessionHash, afuTrigger, afuPaused, summaryPrefix, observationId, afuStatus, afuDashboard, STATUS_COMMAND, DASHBOARD_COMMAND, CompactWorkerClient, HostCompactPool, bindingKey, findAppliedArtifact, normalizeContent, } from "../../shared/runtime-client/dist/index.js";
+/** Requests in a row a ready summary may fail to fit before it is dropped. */
+export const MAX_MISSES = 3;
+/**
+ * The conversation as Pi sends it to the model, entry by entry.
+ *
+ * Pi 1.5 builds requests from buildSessionProjection(): context edits applied,
+ * an older compaction kept inside the newest retained range contributes
+ * nothing, and a compaction entry contributes its system message and its
+ * summary. Pi 0.84 has no projection; its context entries map one to one.
+ */
+export function piProjectedEntries(manager) {
+    const view = manager;
+    if (typeof view.buildSessionProjection === "function") {
+        return view.buildSessionProjection().entries.map((projected) => ({ entry: projected.sourceEntry, messages: projected.messages }));
+    }
+    return project(view.buildContextEntries());
+}
+function project(entries) {
+    return entries.map((item) => isProjected(item) ? item : { entry: item, messages: sessionEntryToContextMessages(item) });
+}
+function isProjected(item) {
+    return isRecord(item) && "entry" in item && Array.isArray(item.messages);
+}
 export function createCompactPiExtension(options = {}) {
     return function compactPi(pi) {
         const injected = options.worker instanceof CompactWorkerClient ? options.worker : undefined;
@@ -17,7 +41,7 @@ export function createCompactPiExtension(options = {}) {
         let automatic;
         const fingerprint = (ctx) => bindingKey([
             ctx.sessionManager.getSessionId(), ctx.model,
-            ctx.sessionManager.buildContextEntries(),
+            piProjectedEntries(ctx.sessionManager).map((item) => [item.entry.id, item.messages]),
         ]);
         const invalidate = () => {
             epoch++;
@@ -47,6 +71,9 @@ export function createCompactPiExtension(options = {}) {
         // very next model request (as the Codex/Claude Code gateway and DSH do),
         // whether or not Pi's own compaction later accepts them.
         const ready = new Map();
+        // Consecutive requests a ready summary did not fit; after MAX_MISSES it is
+        // dropped so the next settled turn prepares one for the current history.
+        const misses = new WeakMap();
         // What the next model request carries, recorded when Pi builds it and
         // settled by the assistant message that answers it (request_receipt).
         const outgoing = new Map();
@@ -55,9 +82,27 @@ export function createCompactPiExtension(options = {}) {
         // next compaction; those requests are the ones it made smaller.
         const committed = new Map();
         pi.on("context", async (event, ctx) => {
+            // afuctx off: Pi sends its own requests unchanged.
+            if (afuPaused("pi"))
+                return undefined;
             const sid = ctx.sessionManager.getSessionId();
             const summary = ready.get(sid);
-            const messages = summary ? applyPreparedSummary(event.messages, summary) : undefined;
+            const match = summary ? matchPreparedSummary(event.messages, summary) : undefined;
+            const messages = match && "messages" in match ? match.messages : undefined;
+            if (summary && match && "reason" in match) {
+                const count = (misses.get(summary) ?? 0) + 1;
+                misses.set(summary, count);
+                // Structure only (positions, counts, a role); never message text.
+                if (count === 1)
+                    log("summary_skipped", { session: sessionHash(sid), artifact_id: summary.artifactId, reason: match.reason,
+                        ...(match.anchor !== undefined ? { anchor_position: match.anchor } : {}),
+                        ...(match.unknown !== undefined ? { unknown_messages: match.unknown } : {}),
+                        ...(match.firstUnknownRole ? { first_unknown_role: match.firstUnknownRole } : {}) });
+                if (count >= MAX_MISSES) {
+                    ready.delete(sid);
+                    log("summary_discarded", { session: sessionHash(sid), artifact_id: summary.artifactId, reason: "unmatched" });
+                }
+            }
             if (!summary || !messages) {
                 const carried = committed.get(sid);
                 const first = event.messages[0];
@@ -67,6 +112,7 @@ export function createCompactPiExtension(options = {}) {
                 return undefined;
             }
             outgoing.set(sid, { applied: true, ...(summary.artifactId ? { artifactId: summary.artifactId } : {}), removed: summary.removedTokens });
+            misses.delete(summary);
             log("summary_applied", { session: sessionHash(sid), artifact_id: summary.artifactId, phase: "host_request", removed_tokens_estimate: summary.removedTokens });
             return { messages: messages };
         });
@@ -110,6 +156,8 @@ export function createCompactPiExtension(options = {}) {
         };
         pi.on("agent_settled", async (_event, ctx) => {
             invalidate();
+            if (afuPaused("pi"))
+                return;
             const generation = epoch;
             // Context size as Pi itself measures it, for the dashboard's progress to the AFU trigger.
             let usage;
@@ -124,12 +172,12 @@ export function createCompactPiExtension(options = {}) {
                 ...(usage?.tokens == null ? {} : { estimated_input_tokens: usage.tokens }),
                 ...afuTrigger(usage?.contextWindow),
             });
-            const entries = ctx.sessionManager.buildContextEntries();
+            const entries = piProjectedEntries(ctx.sessionManager);
             const visible = modelVisibleEntries(entries);
             const latest = visible.at(-1);
             if (latest === undefined)
                 return;
-            const request = piEntriesToRequest(entries, ctx, new Set([latest.id]));
+            const request = piEntriesToRequest(entries, ctx, new Set([latest.entry.id]));
             if (request === undefined)
                 return;
             try {
@@ -189,12 +237,14 @@ export function createCompactPiExtension(options = {}) {
         });
         pi.on("session_before_compact", async (event, ctx) => {
             invalidate();
+            if (afuPaused("pi"))
+                return undefined; // Pi's own compaction, unchanged.
             const started = performance.now();
-            const entries = modelVisibleEntries(ctx.sessionManager.buildContextEntries());
+            const entries = modelVisibleEntries(piProjectedEntries(ctx.sessionManager));
             const latest = entries.at(-1);
             if (latest === undefined)
                 return;
-            const requiredIds = new Set([latest.id]);
+            const requiredIds = new Set([latest.entry.id]);
             const request = piEntriesToRequest(entries, ctx, requiredIds);
             if (request === undefined)
                 return;
@@ -287,8 +337,8 @@ export async function piHostBinding(ctx, pi) {
         contextWindow: model.contextWindow,
         current: async () => key === await identity(),
         complete: async (prompt, signal, ids) => {
-            const entries = ids?.length ? modelVisibleEntries(ctx.sessionManager.buildContextEntries()) : [];
-            const selected = summaryPrefix(entries.map(entry => ({ id: entry.id, messages: convertToLlm(sessionEntryToContextMessages(entry)) })), ids, prompt);
+            const entries = ids?.length ? modelVisibleEntries(piProjectedEntries(ctx.sessionManager)) : [];
+            const selected = summaryPrefix(entries.map(item => ({ id: item.entry.id, messages: convertToLlm(item.messages) })), ids, prompt);
             const definitions = pi?.getAllTools();
             const tools = pi?.getActiveTools().map(name => {
                 const tool = definitions?.find(t => t.name === name);
@@ -322,19 +372,23 @@ export function piEntriesToRequest(entries, ctx, requiredIds) {
     if (visible.length < 2)
         return undefined;
     const callGroups = toolCallGroups(visible);
-    const items = visible.map((entry) => {
-        const message = sessionEntryToContextMessages(entry)[0];
+    const items = visible.map((item) => {
+        const entry = item.entry;
+        // A compaction entry contributes its system message and its summary; the
+        // summary is the conversation content to carry forward.
+        const message = conversationMessage(item);
         if (message === undefined)
             throw new Error(`Pi entry ${entry.id} has no model-visible message`);
         const record = message;
         const role = typeof record.role === "string" ? record.role : "user";
         const callId = typeof record.toolCallId === "string" ? record.toolCallId : undefined;
         const atomicGroup = callId === undefined ? callGroups.entryGroups.get(entry.id) : callGroups.calls.get(callId);
+        const content = record.content ?? (typeof record.summary === "string" ? record.summary : ("summary" in entry ? entry.summary : ""));
         return {
             schema_version: "1",
             id: entry.id,
             kind: entry.type === "compaction" ? "artifact" : piKind(role),
-            content: normalizeContent(record.content ?? ("summary" in entry ? entry.summary : "")),
+            content: normalizeContent(content),
             source: { schema_version: "1", provider: "pi.session", source_id: entry.id },
             required: requiredIds.has(entry.id),
             ...(atomicGroup === undefined ? {} : { atomic_group: atomicGroup }),
@@ -373,7 +427,7 @@ export function piCompactionFromResult(entries, result, tokensBefore) {
     if (artifact === undefined || typeof artifact.item.content !== "string")
         return undefined;
     const visible = modelVisibleEntries(entries);
-    const visibleIds = visible.map((entry) => entry.id);
+    const visibleIds = visible.map((item) => item.entry.id);
     const start = coveredStart(visibleIds, artifact.replacedItemIds, visible);
     if (start < 0 || start + artifact.replacedItemIds.length >= visibleIds.length)
         return undefined;
@@ -425,70 +479,188 @@ function piKeepRecentTokens(ctx) {
  */
 export function piCanCompact(ctx, visible, keepRecent = piKeepRecentTokens(ctx)) {
     let total = 0;
-    for (const entry of visible) {
+    for (const { entry, messages } of project(visible)) {
         if (entry.type === "compaction") {
             total = 0;
             continue;
         }
-        for (const message of sessionEntryToContextMessages(entry))
+        for (const message of messages)
             total += estimateTokens(message);
     }
     return total > keepRecent;
 }
+/**
+ * A message's identity in Pi's request: role, timestamp and tool call id.
+ * Every Pi message carries a timestamp; parallel tool results can share one
+ * millisecond, and their call id tells them apart. Nothing is written into
+ * Pi's messages, which end up in the user's session file.
+ */
+export function piFingerprint(message) {
+    const m = (message ?? {});
+    return hash(JSON.stringify([m.role ?? null, m.timestamp ?? null, m.toolCallId ?? null])).slice(0, 24);
+}
+function contentHash(message) {
+    const m = (message ?? {});
+    return hash(JSON.stringify(m.content ?? m.summary ?? null)).slice(0, 16);
+}
+function hash(text) {
+    return createHash("sha256").update(text).digest("hex");
+}
 /** A ready result that replaces a leading run of the given entries. */
-export function preparedSummary(visible, result) {
+export function preparedSummary(entries, result) {
     const artifact = findAppliedArtifact(result);
     if (artifact === undefined || typeof artifact.item.content !== "string")
         return undefined;
-    const ids = visible.map((entry) => entry.id);
+    const visible = modelVisibleEntries(entries);
+    const ids = visible.map((item) => item.entry.id);
     const start = coveredStart(ids, artifact.replacedItemIds, visible);
     if (start < 0 || start + artifact.replacedItemIds.length >= ids.length)
         return undefined;
-    const head = visible.slice(0, start).flatMap((entry) => sessionEntryToContextMessages(entry));
-    const replaced = visible.slice(start, start + artifact.replacedItemIds.length).flatMap((entry) => sessionEntryToContextMessages(entry));
+    // Everything before the end of the covered range, without system messages:
+    // Pi 1.5 drops them from the `context` view, and they are kept verbatim.
+    const covered = visible.slice(0, start + artifact.replacedItemIds.length)
+        .flatMap((item) => item.messages).filter((message) => !isSystemMessage(message));
+    if (covered.length === 0)
+        return undefined;
+    const replaced = visible.slice(start, start + artifact.replacedItemIds.length).flatMap((item) => item.messages);
     const replacedChars = JSON.stringify(replaced).length;
     // Same id the summary_started/summary_ready events carry, so the dashboard links them.
     const artifactId = observationId(result) ?? artifact.artifactId;
     return {
-        head,
-        replaced,
+        fingerprints: covered.map(piFingerprint),
+        contents: covered.map(contentHash),
         summary: artifact.item.content,
         ...(artifactId === undefined ? {} : { artifactId }),
         removedTokens: Math.max(0, Math.round((replacedChars - artifact.item.content.length) / 4)),
     };
 }
 /**
- * Replace the summarized prefix of a model request with Pi's own compaction
- * summary message. Only an exact prefix match is rewritten; anything else
- * (a later Pi compaction, a branch switch, edited history) is sent unchanged.
+ * Where a ready summary goes in this request, if anywhere.
+ *
+ * The summary covers the conversation up to an anchor (its last message). The
+ * request is matched loosely: the anchor must be present and its content
+ * unchanged; messages before it the summary does not know (inserted by Pi or
+ * an extension, of a new kind) are replaced with the rest; messages it knows
+ * that are gone (omitted by a context edit) do not matter. Three cases are
+ * refused because they lose more than a few messages: the anchor is missing
+ * (another branch, rewound history), the anchor is in the current turn (the
+ * user's question would be removed), and most messages before the anchor are
+ * unknown (the anchor matched by chance). The cut never separates a tool call
+ * from its result: it moves back before the call.
+ *
+ * System messages stay where Pi expects them: those before the cut are kept,
+ * in order, ahead of the summary.
  */
-export function applyPreparedSummary(messages, ready) {
-    const head = ready.head ?? [];
-    const count = ready.replaced.length;
-    if (messages.length <= head.length + count)
-        return undefined;
-    for (let index = 0; index < head.length; index++) {
-        if (JSON.stringify(messages[index]) !== JSON.stringify(head[index]))
-            return undefined;
+export function matchPreparedSummary(messages, ready) {
+    const conversation = [];
+    messages.forEach((message, index) => { if (!isSystemMessage(message))
+        conversation.push(index); });
+    const prints = conversation.map((index) => piFingerprint(messages[index]));
+    const anchorPrint = ready.fingerprints.at(-1);
+    let anchor = -1;
+    for (let k = prints.length - 1; k >= 0; k--)
+        if (prints[k] === anchorPrint) {
+            anchor = k;
+            break;
+        }
+    if (anchor < 0)
+        return { reason: "anchor_not_found" };
+    if (contentHash(messages[conversation[anchor]]) !== ready.contents.at(-1))
+        return { reason: "content_changed", anchor };
+    // The user's current question must stay after the cut.
+    const lastUser = prints.reduce((found, _p, k) => roleOf(messages[conversation[k]]) === "user" ? k : found, -1);
+    if (anchor >= prints.length - 1 || lastUser <= anchor)
+        return { reason: "anchor_in_current_turn", anchor };
+    // Most of what lies before the anchor must be what the summary covers.
+    const known = new Map(ready.fingerprints.map((print, k) => [print, ready.contents[k]]));
+    let unknown = 0, firstUnknownRole;
+    for (let k = 0; k < anchor; k++) {
+        if (known.has(prints[k]))
+            continue;
+        unknown++;
+        firstUnknownRole ??= roleOf(messages[conversation[k]]);
+    }
+    if (unknown > Math.max(3, Math.floor(0.2 * anchor)) || unknown > anchor - unknown) {
+        return { reason: "low_overlap", anchor, unknown, ...(firstUnknownRole ? { firstUnknownRole } : {}) };
     }
-    for (let index = 0; index < count; index++) {
-        if (JSON.stringify(messages[head.length + index]) !== JSON.stringify(ready.replaced[index]))
-            return undefined;
+    // A known message whose content changed (a context edit rewrote it) is no
+    // longer what the summary describes.
+    for (let k = 0; k < anchor; k++) {
+        const expected = known.get(prints[k]);
+        if (expected !== undefined && expected !== contentHash(messages[conversation[k]]))
+            return { reason: "content_changed", anchor };
+    }
+    // Never separate a tool call from its result.
+    let cut = anchor + 1;
+    cut = toolSafeCut(messages, conversation, cut);
+    if (cut <= 0)
+        return { reason: "anchor_in_current_turn", anchor };
+    const end = conversation[cut - 1] + 1;
+    const first = messages[conversation[0]];
+    return {
+        unknown,
+        messages: [
+            ...messages.slice(0, end).filter(isSystemMessage),
+            { role: "compactionSummary", summary: ready.summary, tokensBefore: ready.removedTokens, timestamp: first?.timestamp ?? Date.now() },
+            ...messages.slice(end),
+        ],
+    };
+}
+/** Earlier cut (in conversation positions) so no tool result is kept without its call. */
+function toolSafeCut(messages, conversation, cut) {
+    const callsBefore = (limit) => {
+        const ids = new Set();
+        for (let k = 0; k < limit; k++)
+            for (const id of toolCallIds(messages[conversation[k]]))
+                ids.add(id);
+        return ids;
+    };
+    for (let guard = 0; guard < conversation.length && cut > 0; guard++) {
+        const before = callsBefore(cut);
+        // A result after the cut whose call is before it would lose its call.
+        let moved = false;
+        for (let k = cut; k < conversation.length; k++) {
+            const result = messages[conversation[k]];
+            if (result.role === "toolResult" && typeof result.toolCallId === "string" && before.has(result.toolCallId)) {
+                // Move the cut before the message that made this call.
+                let owner = cut - 1;
+                while (owner >= 0 && !toolCallIds(messages[conversation[owner]]).includes(result.toolCallId))
+                    owner--;
+                cut = Math.max(0, owner);
+                moved = true;
+                break;
+            }
+        }
+        if (!moved)
+            return cut;
     }
-    const first = messages[head.length];
-    return [
-        ...messages.slice(0, head.length),
-        { role: "compactionSummary", summary: ready.summary, tokensBefore: ready.removedTokens, timestamp: first?.timestamp ?? Date.now() },
-        ...messages.slice(head.length + count),
-    ];
+    return cut;
+}
+function toolCallIds(message) {
+    const content = message?.content;
+    if (!Array.isArray(content))
+        return [];
+    return content.flatMap((block) => isRecord(block) && block.type === "toolCall" && typeof block.id === "string" ? [block.id] : []);
+}
+function roleOf(message) {
+    const role = message?.role;
+    return typeof role === "string" ? role : "unknown";
+}
+/** The request with the summary applied, or undefined (see matchPreparedSummary). */
+export function applyPreparedSummary(messages, ready) {
+    const result = matchPreparedSummary(messages, ready);
+    return "messages" in result ? result.messages : undefined;
+}
+function isSystemMessage(message) {
+    return message?.role === "system";
 }
 /** Tokens (Pi's estimate) the entries before firstKeptEntryId cost, minus the summary replacing them. */
 function removedBy(entries, firstKeptEntryId, summary) {
     let total = 0;
-    for (const entry of entries) {
+    for (const { entry, messages } of project(entries)) {
         if (entry.id === firstKeptEntryId)
             break;
-        for (const message of sessionEntryToContextMessages(entry))
+        for (const message of messages)
             total += estimateTokens(message);
     }
     return Math.max(0, total - Math.ceil(summary.length / 4));
@@ -502,8 +674,9 @@ function removedBy(entries, firstKeptEntryId, summary) {
 export function coveredStart(visibleIds, replaced, visible) {
     if (replaced.length === 0)
         return -1;
+    const projected = project(visible);
     let start = 0;
-    while (start < visible.length && visibleIds[start] !== replaced[0] && isSystemEntry(visible[start]))
+    while (start < projected.length && visibleIds[start] !== replaced[0] && isSystemEntry(projected[start]))
         start++;
     if (visibleIds[start] !== replaced[0])
         return -1;
@@ -513,10 +686,15 @@ export function coveredStart(visibleIds, replaced, visible) {
     return start;
 }
 function isSystemEntry(entry) {
-    return sessionEntryToContextMessages(entry).every((message) => message.role === "system");
+    return entry.messages.every(isSystemMessage);
 }
+/** Entries that put at least one message into the model request. */
 function modelVisibleEntries(entries) {
-    return entries.filter((entry) => sessionEntryToContextMessages(entry).length > 0);
+    return project(entries).filter((item) => item.messages.length > 0);
+}
+/** The message an entry contributes as conversation (a compaction's summary, not its system message). */
+function conversationMessage(item) {
+    return item.messages.find((message) => !isSystemMessage(message)) ?? item.messages[0];
 }
 function piKind(role) {
     if (role === "assistant")
@@ -530,8 +708,8 @@ function piKind(role) {
 function toolCallGroups(entries) {
     const calls = new Map();
     const entryGroups = new Map();
-    for (const entry of entries) {
-        const message = sessionEntryToContextMessages(entry)[0];
+    for (const item of entries) {
+        const message = conversationMessage(item);
         if (!isRecord(message) || !Array.isArray(message.content))
             continue;
         const callIds = message.content.flatMap((block) => {
@@ -541,8 +719,8 @@ function toolCallGroups(entries) {
         });
         if (callIds.length === 0)
             continue;
-        const group = `pi-tool-batch:${entry.id}`;
-        entryGroups.set(entry.id, group);
+        const group = `pi-tool-batch:${item.entry.id}`;
+        entryGroups.set(item.entry.id, group);
         for (const callId of callIds)
             calls.set(callId, group);
     }

package/src/afu_host_integrations/shared/runtime-client/dist/index.js

@@ -237,7 +237,7 @@ function isJsonValue(value) {
     return isRecord(value) && Object.values(value).every(isJsonValue);
 }
 export { HostCompactPool, bindingKey } from "./host-worker.js";
-export { journal, sessionHash, afuTrigger } from "./telemetry.js";
+export { journal, sessionHash, afuTrigger, afuPaused } from "./telemetry.js";
 export { summaryPrefix } from "./prefix.js";
 export { afuStatus, afuDashboard, STATUS_COMMAND, DASHBOARD_COMMAND } from "./commands.js";
 //# sourceMappingURL=index.js.map

package/src/afu_host_integrations/shared/runtime-client/dist/telemetry.js

@@ -1,4 +1,5 @@
-import { appendFileSync, openSync, closeSync, mkdirSync, statSync, renameSync, constants, readFileSync } from 'node:fs';
+import { appendFileSync, openSync, closeSync, mkdirSync, statSync, renameSync, constants, readFileSync, existsSync, writeFileSync, unlinkSync } from 'node:fs';
+import { gzipSync } from 'node:zlib';
 import { join } from 'node:path';
 import { homedir } from 'node:os';
 import { randomUUID, createHash } from 'node:crypto';
@@ -36,7 +37,8 @@ export function journal(host) {
 function createJournal(host) {
     const root = join(process.env.AFU_STATE_DIR ?? join(homedir(), '.local/share/afu-context'), 'logs');
     const id = randomUUID().replaceAll('-', '');
-    const file = join(root, `events-${process.pid}-${id}.jsonl`);
+    const file = join(root, `events-${host}-adapter-${process.pid}-${id}.jsonl`);
+    let failed = 0;
     let version = '0.1.0', build = 'development';
     try {
         const m = JSON.parse(readFileSync(join(process.env.AFU_INSTALL_ROOT ?? process.cwd(), 'release.json'), 'utf8'));
@@ -51,9 +53,9 @@ function createJournal(host) {
             const row = { event, host, version, build, runtime_id: id, pid: process.pid, time: new Date().toISOString() };
             // COSEC: diagnostics never include raw model IDs, credentials, prompts or errors.
             for (const [k, v] of Object.entries(fields)) {
-                if (['session', 'artifact_id', 'phase', 'reason'].includes(k) && typeof v === 'string' && /^[A-Za-z0-9_.:+-]{1,100}$/.test(v))
+                if (['session', 'artifact_id', 'phase', 'reason', 'first_unknown_role'].includes(k) && typeof v === 'string' && /^[A-Za-z0-9_.:+-]{1,100}$/.test(v))
                     row[k] = v;
-                if (['input_tokens', 'output_tokens', 'cache_read_input_tokens', 'cache_creation_input_tokens', 'context_window', 'threshold', 'estimated_input_tokens', 'removed_tokens_estimate', 'duration_ms', 'host_compaction_ms'].includes(k) && typeof v === 'number' && Number.isFinite(v) && v >= 0)
+                if (['input_tokens', 'output_tokens', 'cache_read_input_tokens', 'cache_creation_input_tokens', 'context_window', 'threshold', 'estimated_input_tokens', 'removed_tokens_estimate', 'duration_ms', 'host_compaction_ms', 'anchor_position', 'unknown_messages'].includes(k) && typeof v === 'number' && Number.isFinite(v) && v >= 0)
                     row[k] = v;
                 if (['cache_usage_known', 'applied', 'upstream_success'].includes(k) && typeof v === 'boolean')
                     row[k] = v;
@@ -61,18 +63,57 @@ function createJournal(host) {
             mkdirSync(root, { recursive: true, mode: 0o700 });
             try {
                 if (statSync(file).size > 2 * 1024 * 1024)
-                    renameSync(file, file.replace('.jsonl', '.previous.jsonl'));
+                    rotate(file);
             }
             catch { }
+            const lines = failed ? [{ event: 'journal_write_failed', host, version, build, runtime_id: id, pid: process.pid, time: row.time, failed_writes: failed }, row] : [row];
             const fd = openSync(file, constants.O_WRONLY | constants.O_CREAT | constants.O_APPEND | (constants.O_NOFOLLOW ?? 0), 0o600);
             try {
-                appendFileSync(fd, JSON.stringify(row) + '\n');
+                appendFileSync(fd, lines.map(l => JSON.stringify(l) + '\n').join(''));
             }
             finally {
                 closeSync(fd);
             }
+            failed = 0;
         }
-        catch { } // Logging must never break a host request.
+        catch {
+            failed++;
+        } // Logging must never break a host request.
     };
 }
+/** Move a full log to the next numbered, gzip-compressed file; nothing is overwritten. */
+function rotate(file) {
+    let n = 1;
+    const stem = file.replace(/\.jsonl$/, '');
+    while (existsSync(`${stem}.${n}.jsonl`) || existsSync(`${stem}.${n}.jsonl.gz`))
+        n++;
+    const plain = `${stem}.${n}.jsonl`;
+    renameSync(file, plain);
+    try {
+        writeFileSync(plain + '.gz', gzipSync(readFileSync(plain)), { mode: 0o600 });
+        unlinkSync(plain);
+    }
+    catch { }
+}
+const pausedCache = new Map();
+/**
+ * Whether the user paused AFU for this host (afuctx off). Read from the
+ * host's record in <state>/integrations at most once a second; any read
+ * problem counts as not paused, never as a reason to block the host.
+ */
+export function afuPaused(host, now = Date.now()) {
+    const cached = pausedCache.get(host);
+    if (cached && now - cached.checked < 1000)
+        return cached.paused;
+    let paused = false;
+    try {
+        const file = join(process.env.AFU_STATE_DIR ?? join(homedir(), '.local/share/afu-context'), 'integrations', `${host}.json`);
+        paused = JSON.parse(readFileSync(file, 'utf8')).paused === true;
+    }
+    catch {
+        paused = false;
+    }
+    pausedCache.set(host, { checked: now, paused });
+    return paused;
+}
 //# sourceMappingURL=telemetry.js.map