billion-context-dsh 0.1.1 → 0.1.2

package/README.en.md

@@ -0,0 +1,179 @@
+# billion-context-dsh
+
+[English](./README.en.md) | [中文](./README.md)
+
+> **⚠️ Beta notice — not for production use**
+> This project (**v0.1.2**) is a work-in-progress beta. The [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) itself is also in **public beta**. **Do not use either in engineering / production environments** — expect breaking changes and rough edges.
+
+<p align="center">
+<strong>Built with gratitude on top of these projects</strong> — please give them a ⭐:
+<br />
+<a href="https://github.com/deepseek-ai/deepseek-harness">DeepSeek Harness</a> ·
+<a href="https://github.com/ranxianglei/billion-context-pi">billion-context-pi</a> ·
+<a href="https://github.com/ranxianglei/acp-kernel">acp-kernel</a> ·
+<a href="https://github.com/ranxianglei/opencode-acp">opencode-acp</a>
+</p>
+
+<p align="center">
+<strong>Billion-Context</strong> for <a href="https://github.com/deepseek-ai/deepseek-harness">DeepSeek Harness</a>
+<br />
+The model decides <em>when</em> and <em>what</em> to compress — not a hard limit.
+</p>
+
+---
+
+<p align="center">
+<a href="https://www.npmjs.com/package/billion-context-dsh"><img src="https://img.shields.io/npm/v/billion-context-dsh.svg?style=flat-square" alt="npm"></a>
+<a href="https://github.com/Tyan66666/billion-context-dsh/blob/main/LICENSE"><img src="https://img.shields.io/npm/l/billion-context-dsh.svg?style=flat-square" alt="license"></a>
+<a href="https://github.com/Tyan66666/billion-context-dsh"><img src="https://img.shields.io/badge/GitHub-Tyan66666%2Fbillion--context--dsh-181717?style=flat-square&logo=github" alt="GitHub"></a>
+<a href="https://github.com/topics/dsh-plugin"><img src="https://img.shields.io/badge/topic-dsh--plugin-blue?style=flat-square" alt="dsh-plugin"></a>
+</p>
+
+<p align="center">
+<code>npm install billion-context-dsh</code>
+</p>
+
+---
+
+## Why?
+
+When conversations get long, the model runs out of context. Most tools hard-truncate — silently dropping earlier messages. **billion-context-dsh** gives the model a `compress` tool: the LLM decides **when** and **what** to compress into high-fidelity summaries, preserving critical details (file paths, decisions, error strings) while reclaiming context space.
+
+Unlike DSH's built-in auto-compaction (which replaces a range with an automatically generated summary), billion-context-dsh:
+
+- **Model-driven** — the model writes the summary itself; there is no second LLM summarization call (the ACP cost win)
+- **Advisory, never imperative** — automatic policy only *nudges*; the model decides whether and when to compress
+- **Durable & recoverable** — a compressed range becomes a checkpoint node, the originals stay in the append-only session log; `decompress` restores them, `search_context` finds information inside blocks
+- **Seq-based refs** — no message tags; surface seqs are carried by the nudge's range table, with auto-balanced range edges and `#callId` tolerance
+
+This is the DeepSeek Harness port of [billion-context-pi](https://github.com/ranxianglei/billion-context-pi) (the Pi coding-agent adapter): the compression core ([acp-kernel](https://github.com/ranxianglei/acp-kernel)) is reused verbatim, and the adapter layer was rewritten against DSH's durable-surface model — see [docs](https://github.com/Tyan66666/billion-context-dsh/tree/main/docs) for the verified mapping.
+
+## Install
+
+```bash
+npm install billion-context-dsh
+```
+
+That's it. Then add a composition row where a compaction backend is expected — two scopes, pick by how wide you want it:
+
+**Global — host plane, every mode** (recommended). In your profile patch (e.g. `~/.dsh/profiles/web/cordis.patch.yml`), add:
+
+```yaml
+# ACP as the global compaction backend: four model tools + `/acp` command +
+# nudge + ACP guidance section for EVERY mode
+# (standard / code / minimal / cordis / custom presets).
+# Must also disable the host compaction-basic: two backends providing
+# `ctx.compaction` in the same realm collide.
+- id: compaction-basic
+  disabled: true
+
+- insert:
+    - id: compaction-acp
+      name: 'billion-context-dsh'
+      config:
+        modelContextLimit: 128000   # default; the pressure window
+```
+
+**Per-mode — an agent preset's `compaction` realm.** First *disable (or delete) the realm's existing `dsh-compaction-basic` row*, then mount this engine — two backends cannot coexist in the same realm:
+
+```yaml
+# First disable the realm's default backend (or just delete this row)
+- id: compaction-basic
+  disabled: true
+
+# Then mount this engine
+- id: compaction-acp
+  name: 'billion-context-dsh'
+  config:
+    modelContextLimit: 128000   # default; the pressure window
+```
+
+> **One context manager per agent.** Two backends providing `ctx.compaction` collide — never run both in the same realm. Full install & verification guide: [docs/INSTALL.md](docs/INSTALL.md).
+
+## How it works
+
+DSH derives every model request from its append-only session log (the *surface*). ACP semantics map onto that model directly:
+
+| ACP concept | DSH implementation |
+|---|---|
+| `compress` tool shadows a range | durable `surfaceOp: { op: 'replace' }` — the model-written summary becomes a checkpoint node; the originals stay in the log |
+| refs (`m00001` tags) | surface seqs, carried by the nudge's compressible-range table |
+| nudge ("consider compressing") | injected at `agent/pre-step` by the kernel's pressure decision — a short advisory, never an order |
+| `decompress` | read-only recovery of shadowed originals from the log |
+| `search_context` | scores block summaries + originals rebuilt from the log |
+| `acp_status` | block ledger + context pressure |
+| block state | in-memory kernel state + **log-rebuilt ledger** (no sidecar files) |
+
+The load-bearing compression guidance (tools, philosophy, summary rules) is registered as a one-time system-prompt section, so nudges stay short. There is deliberately **no automatic summarization**: automatic policy only nudges the model (`compactIfNeeded` returns null).
+
+## Video
+
+A walkthrough of the ACP philosophy this project inherits — how active context compression keeps a session lean at ~200K tokens (opencode-acp & billion-context-pi). *Video credit: the original author, [裘香莲](https://space.bilibili.com/) on Bilibili — not ours.*
+
+[![Watch on Bilibili](https://i1.hdslb.com/bfs/archive/083a77fede77502cbd6b2e206f8aadcc4dacc7ea.jpg)](https://www.bilibili.com/video/BV1qAMR6MEA4/)
+
+## Model-facing tools
+
+| Tool | What it does |
+| --- | --- |
+| `compress` | Replace a seq range with a dense summary you write (edges auto-balanced to tool-pair boundaries) |
+| `decompress` | Restore a previously compressed block's original content (read-only) |
+| `search_context` | Search compressed block summaries and originals by keyword |
+| `acp_status` | Context usage, compressed blocks, compressible ranges |
+| `/acp` | status / compress / decompress from the command bar |
+
+## Upstream & credits
+
+This project is a **port/derivation** and stands on the shoulders of the following upstream work — all MIT licensed. **Thank you** to [ranxianglei](https://github.com/ranxianglei) and the DeepSeek Harness team for building these projects and making them open source:
+
+| Upstream | Author | Role |
+|---|---|---|
+| **[billion-context-pi](https://github.com/ranxianglei/billion-context-pi)** | [ranxianglei](https://github.com/ranxianglei) | The Pi coding-agent adapter this project ports to DeepSeek Harness; source of the adapter design, tool semantics, and this project's default configuration |
+| **[acp-kernel](https://github.com/ranxianglei/acp-kernel)** | [ranxianglei](https://github.com/ranxianglei) | Framework-agnostic context-compression engine — reused **verbatim** (refs, blocks, tiers, nudge decisions, search, status) |
+| **[opencode-acp](https://github.com/ranxianglei/opencode-acp)** | [ranxianglei](https://github.com/ranxianglei) | Origin of the ACP ("model decides when and what to compress") design |
+| **[DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness)** | DeepSeek AI | The host platform this project extends (compaction capability seam, agent presets, durable session log) |
+
+This project reuses `acp-kernel`'s compression core and `billion-context-pi`'s default behavior unchanged; the DSH adapter layer (session-event projection, durable surface transaction, model tools, nudge, config) is original work in this repository. Upstream copyright and licenses remain with their respective authors; see [LICENSE](LICENSE) for this project's terms.
+
+## Configuration
+
+| Key | Default | Meaning |
+|---|---|---|
+| `modelContextLimit` | `128000` | Context window used for the kernel's pressure decisions |
+| `nudgeMinContextLimitPct` | kernel default `0.45` | Nudge window lower bound (usage fraction) — same default as billion-context-pi |
+| `nudgeMaxContextLimitPct` | kernel default `0.75` | Over-limit line: above this the nudge fires regardless of growth |
+| `nudgeEmergencyThresholdPct` | kernel default `0.95` | Emergency nudge (bypasses the per-turn dedup) |
+| `coreOverrides` | — | Any other acp-kernel `Config` override (billion-context-pi's `coreOverrides` escape hatch) |
+| `autoTools` | `true` | Register the four model tools on `ctx.tools` |
+| `autoCommand` | `true` | Register the `/acp` command on `ctx.commands` |
+| `autoNudge` | `true` | Inject the nudge into `agent/pre-step` |
+
+## Development
+
+```bash
+npm install
+npm run typecheck   # strict TS
+npm test            # node --import tsx --test tests/*.test.ts
+npm run build       # tsup bundle (inlines acp-kernel) + .d.ts
+```
+
+`dist/index.js` is self-contained except for the `@deepseek-ai/*` seam packages, which the hosting deployment provides.
+
+## Architecture
+
+```
+src/
+├── index.ts        # AcpCompactionEngine (CompactionEngine backend) + wiring
+├── messages.ts     # M1: session events ↔ acp-kernel CoreMessage projection
+├── state.ts        # M2: per-session kernel state
+├── region.ts       # M5: durable region transaction + log-rebuilt block ledger
+├── tools.ts        # M3: compress / decompress / search_context / acp_status
+├── nudge.ts        # M4: kernel pressure decision → injected advisory nudge
+├── system-prompt.ts# M4: one-time ACP guidance section (keeps nudges short)
+├── config.ts       # kernel config assembly (thresholds + coreOverrides)
+└── commands.ts     # M4: /acp slash command
+```
+
+## License
+
+MIT

package/README.md

@@ -1,12 +1,12 @@
 # billion-context-dsh
 
-[English](./README.md) | [中文](./README.zh-CN.md)
+[中文](./README.md) | [English](./README.en.md)
 
-> **⚠️ Beta notice — not for production use**
-> This project (**v0.1.1**) is a work-in-progress beta. The [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) itself is also in **public beta**. **Do not use either in engineering / production environments** — expect breaking changes and rough edges.
+> **⚠️ 测试版声明——请勿用于生产环境**
+> 本项目（**v0.1.2**）仍处于开发中的测试版。[DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) 本身也处于**公开测试版**阶段。**请勿将两者用于工程化 / 生产环境**——预期会有破坏性变更与粗糙之处。
 
 <p align="center">
-<strong>Built with gratitude on top of these projects</strong> — please give them a ⭐:
+<strong>衷心感谢以下项目——请给它们一个 ⭐：</strong>
 <br />
 <a href="https://github.com/deepseek-ai/deepseek-harness">DeepSeek Harness</a> ·
 <a href="https://github.com/ranxianglei/billion-context-pi">billion-context-pi</a> ·
@@ -17,7 +17,7 @@
 <p align="center">
 <strong>Billion-Context</strong> for <a href="https://github.com/deepseek-ai/deepseek-harness">DeepSeek Harness</a>
 <br />
-The model decides <em>when</em> and <em>what</em> to compress — not a hard limit.
+由模型决定<em>何时</em>压缩、<em>压缩什么</em>——而不是一个硬性上限。
 </p>
 
 ---
@@ -35,118 +35,142 @@ The model decides <em>when</em> and <em>what</em> to compress — not a hard lim
 
 ---
 
-## Why?
+## 为什么？
 
-When conversations get long, the model runs out of context. Most tools hard-truncate — silently dropping earlier messages. **billion-context-dsh** gives the model a `compress` tool: the LLM decides **when** and **what** to compress into high-fidelity summaries, preserving critical details (file paths, decisions, error strings) while reclaiming context space.
+当对话变长，模型会耗尽上下文。多数工具直接硬截断——悄悄丢弃早期消息。**billion-context-dsh** 给模型一个 `compress` 工具：由 LLM 决定**何时**、**压缩什么**，写成高保真摘要，保留关键细节（文件路径、决策、错误信息）的同时回收上下文空间。
 
-Unlike DSH's built-in auto-compaction (which replaces a range with an automatically generated summary), billion-context-dsh:
+与 DSH 内置的自动压缩（用自动生成的摘要替换一段范围）不同，billion-context-dsh：
 
-- **Model-driven** — the model writes the summary itself; there is no second LLM summarization call (the ACP cost win)
-- **Advisory, never imperative** — automatic policy only *nudges*; the model decides whether and when to compress
-- **Durable & recoverable** — a compressed range becomes a checkpoint node, the originals stay in the append-only session log; `decompress` restores them, `search_context` finds information inside blocks
-- **Seq-based refs** — no message tags; surface seqs are carried by the nudge's range table, with auto-balanced range edges and `#callId` tolerance
+- **模型驱动** —— 摘要由模型自己书写，没有第二次 LLM 摘要调用（ACP 的成本优势）
+- **只建议、不强令** —— 自动策略只 *nudge*（提醒），是否压缩、何时压缩由模型决定
+- **持久且可恢复** —— 压缩范围成为 checkpoint 节点，原文保留在 append-only 会话日志中；`decompress` 可恢复，`search_context` 可在块内查找
+- **基于 seq 引用** —— 不需要消息标签；surface seq 由 nudge 的范围表携带，范围边界自动平衡、容忍 `#callId` 片段
 
-This is the DeepSeek Harness port of [billion-context-pi](https://github.com/ranxianglei/billion-context-pi) (the Pi coding-agent adapter): the compression core ([acp-kernel](https://github.com/ranxianglei/acp-kernel)) is reused verbatim, and the adapter layer was rewritten against DSH's durable-surface model — see [docs](https://github.com/Tyan66666/billion-context-dsh/tree/main/docs) for the verified mapping.
+这是 [billion-context-pi](https://github.com/ranxianglei/billion-context-pi)（Pi 编码代理适配器）在 DeepSeek Harness 上的移植：压缩内核（[acp-kernel](https://github.com/ranxianglei/acp-kernel)）原样复用，适配层针对 DSH 的 durable-surface 模型重写——经过验证的映射关系见 [docs](https://github.com/Tyan66666/billion-context-dsh/tree/main/docs)。
 
-## Install
+## 安装
 
 ```bash
 npm install billion-context-dsh
 ```
 
-That's it. Add one composition row where a compaction backend is expected (host composition or an agent preset's `compaction` realm):
+就这样。然后在需要压缩后端的位置加组合配置——两种范围，按需选择：
+
+**全局生效（host 平面，所有模式）——推荐**。在你的 profile 补丁（如 `~/.dsh/profiles/web/cordis.patch.yml`）中追加：
+
+```yaml
+# ACP 作为全局压缩后端：四个模型工具 + `/acp` 命令 + nudge + ACP 提示词段，
+# 对所有模式（standard / code / minimal / cordis / 自定义预设）生效。
+# 必须同时禁用 host 的 compaction-basic：同一 realm 内两个后端同时
+# provide `ctx.compaction` 会冲突。
+- id: compaction-basic
+  disabled: true
+
+- insert:
+    - id: compaction-acp
+      name: 'billion-context-dsh'
+      config:
+        modelContextLimit: 128000   # 默认；压力窗口
+```
+
+**单模式生效（agent preset 的 `compaction` realm）**。先在该 realm 内*禁用（或删除）原有的 `dsh-compaction-basic` 行*，再插入本引擎——同一 realm 内两个后端不能并存：
 
 ```yaml
-- id: compaction-billion-context
+# 先禁用 realm 内默认后端（或直接删掉这一行）
+- id: compaction-basic
+  disabled: true
+
+# 再插入本引擎
+- id: compaction-acp
   name: 'billion-context-dsh'
   config:
-    modelContextLimit: 128000   # default; the pressure window
+    modelContextLimit: 128000   # 默认；压力窗口
 ```
 
-> **One context manager per agent.** The preset's `compaction` isolate realm should mount this engine *instead of* `dsh-compaction-basic` — two backends providing `ctx.compaction` would collide (see README mount examples in the [full docs](https://github.com/Tyan66666/billion-context-dsh/tree/main/docs)).
+> **每个 agent 只留一个上下文管理器。** 两个后端同时 provide `ctx.compaction` 会冲突——同一 realm 内切勿并存。完整安装与验证指南见 [docs/INSTALL.md](docs/INSTALL.md)。
 
-## How it works
+## 工作原理
 
-DSH derives every model request from its append-only session log (the *surface*). ACP semantics map onto that model directly:
+DSH 的每个模型请求都派生自其 append-only 会话日志（*surface*）。ACP 语义直接映射到这一模型：
 
-| ACP concept | DSH implementation |
+| ACP 概念 | DSH 实现 |
 |---|---|
-| `compress` tool shadows a range | durable `surfaceOp: { op: 'replace' }` — the model-written summary becomes a checkpoint node; the originals stay in the log |
-| refs (`m00001` tags) | surface seqs, carried by the nudge's compressible-range table |
-| nudge ("consider compressing") | injected at `agent/pre-step` by the kernel's pressure decision — a short advisory, never an order |
-| `decompress` | read-only recovery of shadowed originals from the log |
-| `search_context` | scores block summaries + originals rebuilt from the log |
-| `acp_status` | block ledger + context pressure |
-| block state | in-memory kernel state + **log-rebuilt ledger** (no sidecar files) |
+| `compress` 工具遮蔽一段范围 | 持久化 `surfaceOp: { op: 'replace' }`——模型书写的摘要成为 checkpoint 节点；原文保留在日志中 |
+| refs（`m00001` 标签） | surface seq，由 nudge 的可压缩范围表携带 |
+| nudge（"考虑压缩一下"） | 由内核的压力决策在 `agent/pre-step` 注入——简短建议，绝非命令 |
+| `decompress` | 从日志只读恢复被遮蔽的原文 |
+| `search_context` | 对从日志重建的块摘要与原文打分 |
+| `acp_status` | 块账本与上下文压力 |
+| 块状态 | 内存内核状态 + **日志重建账本**（无旁车文件） |
 
-The load-bearing compression guidance (tools, philosophy, summary rules) is registered as a one-time system-prompt section, so nudges stay short. There is deliberately **no automatic summarization**: automatic policy only nudges the model (`compactIfNeeded` returns null).
+承载性的压缩指引（工具、哲学、摘要规则）注册为一次性系统提示段，因此 nudge 保持简短。刻意**不做自动摘要**：自动策略只 nudge 模型（`compactIfNeeded` 返回 null）。
 
-## Video
+## 视频讲解
 
-A walkthrough of the ACP philosophy this project inherits — how active context compression keeps a session lean at ~200K tokens (opencode-acp & billion-context-pi). *Video credit: the original author, [裘香莲](https://space.bilibili.com/) on Bilibili — not ours.*
+本项目继承的 ACP 哲学讲解——主动上下文压缩如何在约 20 万 token 内保持会话精简（opencode-acp 与 billion-context-pi）。*视频原作者：[裘香莲](https://space.bilibili.com/)（B 站 UP 主），非本项目制作。*
 
-[![Watch on Bilibili](https://i1.hdslb.com/bfs/archive/083a77fede77502cbd6b2e206f8aadcc4dacc7ea.jpg)](https://www.bilibili.com/video/BV1qAMR6MEA4/)
+[![在 B 站观看](https://i1.hdslb.com/bfs/archive/083a77fede77502cbd6b2e206f8aadcc4dacc7ea.jpg)](https://www.bilibili.com/video/BV1qAMR6MEA4/)
 
-## Model-facing tools
+## 模型工具
 
-| Tool | What it does |
+| 工具 | 作用 |
 | --- | --- |
-| `compress` | Replace a seq range with a dense summary you write (edges auto-balanced to tool-pair boundaries) |
-| `decompress` | Restore a previously compressed block's original content (read-only) |
-| `search_context` | Search compressed block summaries and originals by keyword |
-| `acp_status` | Context usage, compressed blocks, compressible ranges |
-| `/acp` | status / compress / decompress from the command bar |
+| `compress` | 用你书写的紧凑摘要替换 seq 范围（边界自动平衡到 tool-call/result 配对点） |
+| `decompress` | 恢复已压缩块的原始内容（只读） |
+| `search_context` | 按关键词搜索压缩块摘要与原文 |
+| `acp_status` | 上下文占用、压缩块、可压缩范围 |
+| `/acp` | 从命令栏执行 status / compress / decompress |
 
-## Upstream & credits
+## 上游项目与致谢
 
-This project is a **port/derivation** and stands on the shoulders of the following upstream work — all MIT licensed. **Thank you** to [ranxianglei](https://github.com/ranxianglei) and the DeepSeek Harness team for building these projects and making them open source:
+本项目是一个**移植/派生项目**，站在以下上游工作的肩膀上——全部为 MIT 许可。**衷心感谢** [ranxianglei](https://github.com/ranxianglei) 和 DeepSeek Harness 团队创建并开源这些项目：
 
-| Upstream | Author | Role |
+| 上游项目 | 作者 | 角色 |
 |---|---|---|
-| **[billion-context-pi](https://github.com/ranxianglei/billion-context-pi)** | [ranxianglei](https://github.com/ranxianglei) | The Pi coding-agent adapter this project ports to DeepSeek Harness; source of the adapter design, tool semantics, and this project's default configuration |
-| **[acp-kernel](https://github.com/ranxianglei/acp-kernel)** | [ranxianglei](https://github.com/ranxianglei) | Framework-agnostic context-compression engine — reused **verbatim** (refs, blocks, tiers, nudge decisions, search, status) |
-| **[opencode-acp](https://github.com/ranxianglei/opencode-acp)** | [ranxianglei](https://github.com/ranxianglei) | Origin of the ACP ("model decides when and what to compress") design |
-| **[DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness)** | DeepSeek AI | The host platform this project extends (compaction capability seam, agent presets, durable session log) |
+| **[billion-context-pi](https://github.com/ranxianglei/billion-context-pi)** | [ranxianglei](https://github.com/ranxianglei) | 本项目移植的 Pi 编码代理适配器；适配器设计、工具语义与本项目默认配置的来源 |
+| **[acp-kernel](https://github.com/ranxianglei/acp-kernel)** | [ranxianglei](https://github.com/ranxianglei) | 框架无关的上下文压缩引擎——**原样复用**（refs、blocks、tiers、nudge 决策、search、status） |
+| **[opencode-acp](https://github.com/ranxianglei/opencode-acp)** | [ranxianglei](https://github.com/ranxianglei) | ACP（"模型决定何时压缩、压缩什么"）设计的源头 |
+| **[DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness)** | DeepSeek AI | 本项目所扩展的宿主平台（compaction 能力接缝、agent preset、持久化会话日志） |
 
-This project reuses `acp-kernel`'s compression core and `billion-context-pi`'s default behavior unchanged; the DSH adapter layer (session-event projection, durable surface transaction, model tools, nudge, config) is original work in this repository. Upstream copyright and licenses remain with their respective authors; see [LICENSE](LICENSE) for this project's terms.
+本项目原样复用 `acp-kernel` 的压缩内核与 `billion-context-pi` 的默认行为；DSH 适配层（会话事件投影、持久化表面事务、模型工具、nudge、配置）为本仓库原创。上游版权与许可归其各自作者所有；本项目的许可条款见 [LICENSE](LICENSE)。
 
-## Configuration
+## 配置
 
-| Key | Default | Meaning |
+| 键 | 默认值 | 含义 |
 |---|---|---|
-| `modelContextLimit` | `128000` | Context window used for the kernel's pressure decisions |
-| `nudgeMinContextLimitPct` | kernel default `0.45` | Nudge window lower bound (usage fraction) — same default as billion-context-pi |
-| `nudgeMaxContextLimitPct` | kernel default `0.75` | Over-limit line: above this the nudge fires regardless of growth |
-| `nudgeEmergencyThresholdPct` | kernel default `0.95` | Emergency nudge (bypasses the per-turn dedup) |
-| `coreOverrides` | — | Any other acp-kernel `Config` override (billion-context-pi's `coreOverrides` escape hatch) |
-| `autoTools` | `true` | Register the four model tools on `ctx.tools` |
-| `autoCommand` | `true` | Register the `/acp` command on `ctx.commands` |
-| `autoNudge` | `true` | Inject the nudge into `agent/pre-step` |
+| `modelContextLimit` | `128000` | 用于内核压力决策的上下文窗口 |
+| `nudgeMinContextLimitPct` | 内核默认 `0.45` | Nudge 窗口下界（用量占比）——与 billion-context-pi 相同的默认值 |
+| `nudgeMaxContextLimitPct` | 内核默认 `0.75` | 过限线：超过此值则无论增长与否都触发 nudge |
+| `nudgeEmergencyThresholdPct` | 内核默认 `0.95` | 紧急 nudge（绕过每轮去重） |
+| `coreOverrides` | — | 任何其他 acp-kernel `Config` 覆盖（billion-context-pi 的 `coreOverrides` 逃生口） |
+| `autoTools` | `true` | 在 `ctx.tools` 注册四个模型工具 |
+| `autoCommand` | `true` | 在 `ctx.commands` 注册 `/acp` 命令 |
+| `autoNudge` | `true` | 当内核建议时向 `agent/pre-step` 注入 nudge |
 
-## Development
+## 开发
 
 ```bash
 npm install
-npm run typecheck   # strict TS
+npm run typecheck   # 严格 TS
 npm test            # node --import tsx --test tests/*.test.ts
-npm run build       # tsup bundle (inlines acp-kernel) + .d.ts
+npm run build       # tsup 打包（内联 acp-kernel）+ .d.ts
 ```
 
-`dist/index.js` is self-contained except for the `@deepseek-ai/*` seam packages, which the hosting deployment provides.
+`dist/index.js` 自包含，仅外链 `@deepseek-ai/*` 接缝包（由宿主部署提供）。
 
-## Architecture
+## 架构
 
 ```
 src/
-├── index.ts        # AcpCompactionEngine (CompactionEngine backend) + wiring
-├── messages.ts     # M1: session events ↔ acp-kernel CoreMessage projection
-├── state.ts        # M2: per-session kernel state
-├── region.ts       # M5: durable region transaction + log-rebuilt block ledger
+├── index.ts        # AcpCompactionEngine（CompactionEngine 后端）+ 接线
+├── messages.ts     # M1: 会话事件 ↔ acp-kernel CoreMessage 投影
+├── state.ts        # M2: 每会话内核状态
+├── region.ts       # M5: 持久化区域事务 + 日志重建块账本
 ├── tools.ts        # M3: compress / decompress / search_context / acp_status
-├── nudge.ts        # M4: kernel pressure decision → injected advisory nudge
-├── system-prompt.ts# M4: one-time ACP guidance section (keeps nudges short)
-├── config.ts       # kernel config assembly (thresholds + coreOverrides)
-└── commands.ts     # M4: /acp slash command
+├── nudge.ts        # M4: 内核压力决策 → 注入的建议式 nudge
+├── system-prompt.ts# M4: 一次性 ACP 指引段（让 nudge 保持简短）
+├── config.ts       # 内核配置组装（阈值 + coreOverrides）
+└── commands.ts     # M4: /acp 斜杠命令
 ```
 
 ## License

package/dist/index.js

@@ -177,6 +177,25 @@ function assertNoActiveCompaction(events) {
     throw new Error("billion-context-dsh: another compaction is already active for this session");
   }
 }
+function hasPlainRef(session, seq) {
+  const event = session.events[seq];
+  if (event === void 0) return false;
+  switch (event.type) {
+    case "user/message":
+    case "tool/result":
+      return extractEventText(event).trim().length > 0;
+    case "assistant/message": {
+      const content = event.data.message?.content;
+      const calls = Array.isArray(content) ? content.filter(
+        (block) => block !== null && typeof block === "object" && block.type === "tool-call"
+      ) : [];
+      if (calls.length > 1) return false;
+      return calls.length === 1 || extractEventText(event).trim().length > 0;
+    }
+    default:
+      return false;
+  }
+}
 function resolveSurfaceRange(session, start, end) {
   const nodes = session.surface.nodes;
   const requestedStartIdx = nodes.indexOf(start);
@@ -187,12 +206,14 @@ function resolveSurfaceRange(session, start, end) {
   if (requestedStartIdx > requestedEndIdx) {
     throw new Error(`billion-context-dsh: reversed range ${start}..${end}`);
   }
+  const cleanBefore = (index) => toolPairingBalancedBefore(session, nodes[index]) && hasPlainRef(session, nodes[index]);
+  const cleanAfter = (index) => toolPairingBalancedAfter(session, nodes[index]) && hasPlainRef(session, nodes[index]);
   let startIdx = requestedStartIdx;
   let endIdx = requestedEndIdx;
-  while (startIdx <= endIdx && !toolPairingBalancedBefore(session, nodes[startIdx])) {
+  while (startIdx <= endIdx && !cleanBefore(startIdx)) {
     startIdx += 1;
   }
-  while (endIdx >= startIdx && !toolPairingBalancedAfter(session, nodes[endIdx])) {
+  while (endIdx >= startIdx && !cleanAfter(endIdx)) {
     endIdx -= 1;
   }
   if (startIdx <= endIdx) {
@@ -200,13 +221,13 @@ function resolveSurfaceRange(session, start, end) {
   }
   startIdx = requestedStartIdx;
   endIdx = requestedEndIdx;
-  while (startIdx > 0 && !toolPairingBalancedBefore(session, nodes[startIdx])) {
+  while (startIdx > 0 && !cleanBefore(startIdx)) {
     startIdx -= 1;
   }
-  while (endIdx < nodes.length - 1 && !toolPairingBalancedAfter(session, nodes[endIdx])) {
+  while (endIdx < nodes.length - 1 && !cleanAfter(endIdx)) {
     endIdx += 1;
   }
-  if (toolPairingBalancedBefore(session, nodes[startIdx]) && toolPairingBalancedAfter(session, nodes[endIdx])) {
+  if (cleanBefore(startIdx) && cleanAfter(endIdx)) {
     return { start: nodes[startIdx], end: nodes[endIdx] };
   }
   throw new Error(
@@ -384,16 +405,19 @@ async function handleCompress(env, args, exec) {
   const ranges = args.content.map((range) => {
     const startSeq = parseSeq(range.startSeq);
     const endSeq = parseSeq(range.endSeq);
-    const startRef = byRaw[String(startSeq)];
-    const endRef = byRaw[String(endSeq)];
+    const { start, end } = resolveSurfaceRange(session, startSeq, endSeq);
+    const startRef = byRaw[String(start)];
+    const endRef = byRaw[String(end)];
     if (startRef === void 0 || endRef === void 0) {
       throw new Error(
-        `billion-context-dsh: seq ${startSeq}..${endSeq} has no assigned ref \u2014 the range must be on the current surface (run acp_status for the live seq list)`
+        `billion-context-dsh: seq ${start}..${end} has no assigned ref \u2014 the range must be on the current surface (run acp_status for the live seq list)`
       );
     }
     return {
       startSeq,
       endSeq,
+      start,
+      end,
       startRef,
       endRef,
       summary: range.summary,
@@ -414,7 +438,7 @@ async function handleCompress(env, args, exec) {
   for (let index = 0; index < ranges.length; index += 1) {
     const range = ranges[index];
     const original = args.content[index];
-    const { start, end } = resolveSurfaceRange(session, range.startSeq, range.endSeq);
+    const { start, end } = range;
     const shadowed = shadowedSeqsOf(session, start, end);
     let shadowedTokens = 0;
     for (const seq of shadowed) {

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/state.ts","../src/tools.ts","../src/config.ts","../src/region.ts","../src/messages.ts","../src/commands.ts","../src/nudge.ts","../src/system-prompt.ts"],"sourcesContent":["/**\n * billion-context-dsh — Active Context Pruning (ACP) for the DeepSeek Harness,\n * delivered as a `CompactionEngine` backend.\n *\n * The model decides when and what to compress (pure ACP semantics):\n *  - the `compress` tool durably shadows a surface range with the model-written\n *    summary (no second LLM summarization call — the ACP cost win);\n *  - the original events stay in the append-only session log, so `decompress`,\n *    `search_context`, and replay always work;\n *  - refs are surface seqs carried by the injected nudge's range table (DSH\n *    has no in-memory message rewrite hook — see docs/dsh-porting-verification.md);\n *  - automatic policy never summarizes by itself: it nudges the model.\n *\n * Mount it wherever a compaction backend is expected:\n *\n * ```yaml\n * - id: compaction-billion-context\n *   name: 'billion-context-dsh'\n *   config:\n *     modelContextLimit: 128000\n * ```\n *\n * The package registers `ctx.compaction` plus the four model tools and the\n * `/acp` command when the hosting composition provides `ctx.tools` /\n * `ctx.commands`.\n * @module billion-context-dsh\n */\n\nimport type { Context } from '@deepseek-ai/cordis'\nimport {\n  CompactionEngine,\n  ManualCompactionError,\n  type CompactionAgentContext,\n  type CompactionResult,\n  type CompactionTrigger,\n  type ManualCompactAgentContext,\n} from '@deepseek-ai/dsh-compaction'\nimport { createCore, type CompressionCore } from 'acp-kernel'\nimport type {} from '@deepseek-ai/dsh-agent'\nimport { AcpStateStore } from './state.ts'\nimport { makeTools, type ToolEnvironment } from './tools.ts'\nimport { acpCommand } from './commands.ts'\nimport { buildNudge } from './nudge.ts'\nimport { ACP_SYSTEM_PROMPT, ACP_SYSTEM_PROMPT_ORDER } from './system-prompt.ts'\n\nexport { AcpStateStore } from './state.ts'\nexport { kernelConfigFor, type KernelConfigInput } from './config.ts'\nexport { ACP_SYSTEM_PROMPT, ACP_SYSTEM_PROMPT_ORDER } from './system-prompt.ts'\nexport { makeTools, type ToolEnvironment } from './tools.ts'\nexport { acpCommand } from './commands.ts'\nexport { buildNudge, type NudgeEnvironment, type NudgeOutcome } from './nudge.ts'\nexport {\n  rebuildBlockLedger,\n  resolveSurfaceRange,\n  runCompactionTransaction,\n  shadowedSeqsOf,\n  findOpenTurn,\n  assertNoActiveCompaction,\n  type AcpBlockLedgerEntry,\n  type CompactionTransactionInput,\n} from './region.ts'\nexport { eventsToCoreMessages, projectEvent, surfaceEventsOf, extractEventText } from './messages.ts'\n\nexport interface AcpConfig {\n  /** The context window used for pressure decisions. Default 128000. */\n  readonly modelContextLimit: number\n  /** Nudge window lower bound (usage fraction). Kernel default 0.45 — same as billion-context-pi. */\n  readonly nudgeMinContextLimitPct?: number\n  /** Nudge window upper bound (over-limit). Kernel default 0.75 — same as billion-context-pi. */\n  readonly nudgeMaxContextLimitPct?: number\n  /** Emergency nudge threshold (bypasses per-turn dedup). Kernel default 0.95 — same as billion-context-pi. */\n  readonly nudgeEmergencyThresholdPct?: number\n  /** Any other acp-kernel Config override (billion-context-pi's `coreOverrides` escape hatch). */\n  readonly coreOverrides?: Partial<import('acp-kernel').Config>\n  /** Register the four model tools on `ctx.tools`. Default true. */\n  readonly autoTools: boolean\n  /** Register the `/acp` command on `ctx.commands`. Default true. */\n  readonly autoCommand: boolean\n  /** Inject the nudge into `agent/pre-step` when the kernel recommends it. Default true. */\n  readonly autoNudge: boolean\n}\n\nconst DEFAULT_CONFIG: AcpConfig = {\n  modelContextLimit: 128000,\n  autoTools: true,\n  autoCommand: true,\n  autoNudge: true,\n}\n\nexport function resolveAcpConfig(config: Partial<AcpConfig> = {}): AcpConfig {\n  return { ...DEFAULT_CONFIG, ...config }\n}\n\n/**\n * The ACP compaction backend. Subclasses the seam exactly like\n * `dsh-compaction-basic`; swaps summarization-driven compaction for\n * model-driven block compression without touching the agent loop.\n */\nexport class AcpCompactionEngine extends CompactionEngine {\n  /** The framework-agnostic ACP compression core, reused verbatim. */\n  readonly kernel: CompressionCore\n  /** Per-session kernel state. */\n  readonly store: AcpStateStore\n  /** Resolved engine configuration. */\n  readonly config: AcpConfig\n\n  private readonly lastNudgeTurn = new Map<string, number>()\n\n  constructor(ctx: Context, config: Partial<AcpConfig> = {}) {\n    super(ctx)\n    this.config = resolveAcpConfig(config)\n    this.kernel = createCore({})\n    this.store = new AcpStateStore()\n\n    const env: ToolEnvironment = {\n      kernel: this.kernel,\n      store: this.store,\n      modelContextLimit: this.config.modelContextLimit,\n      nudgeMinContextLimitPct: this.config.nudgeMinContextLimitPct,\n      nudgeMaxContextLimitPct: this.config.nudgeMaxContextLimitPct,\n      nudgeEmergencyThresholdPct: this.config.nudgeEmergencyThresholdPct,\n      coreOverrides: this.config.coreOverrides,\n    }\n\n    if (this.config.autoTools) {\n      const tools = ctx.get('tools')\n      if (tools !== undefined) {\n        for (const tool of makeTools(env)) tools.register(tool)\n      }\n    }\n    if (this.config.autoCommand) {\n      const commands = ctx.get('commands')\n      if (commands !== undefined) commands.register(acpCommand(env))\n    }\n    if (this.config.autoNudge) {\n      ctx.on('agent/pre-step', async (payload, next) => {\n        const decision = await next()\n        if (decision.kind === 'reject') return decision\n        const outcome = buildNudge(payload.agent, env, this.lastNudgeTurn)\n        if (outcome === null) return decision\n        return { kind: 'enter', messages: [...decision.messages, outcome.message] }\n      })\n    }\n    // The load-bearing ACP guidance lives in the system prompt ONCE; nudges\n    // stay short and advisory (model-driven: the model decides).\n    const systemPrompt = ctx.get('systemPrompt')\n    if (systemPrompt !== undefined) {\n      systemPrompt.section({\n        name: 'billion-context-dsh',\n        order: ACP_SYSTEM_PROMPT_ORDER,\n        text: ACP_SYSTEM_PROMPT,\n      })\n    }\n  }\n\n  /** ACP is model-driven: automatic pressure policy never summarizes by itself. */\n  override async compactIfNeeded(\n    _agent: CompactionAgentContext,\n    _trigger: CompactionTrigger,\n    signal: AbortSignal,\n  ): Promise<CompactionResult | null> {\n    signal.throwIfAborted()\n    return null\n  }\n\n  /** Explicit idle-session compaction: ACP leaves the decision to the model. */\n  override async compactNow(\n    _agent: ManualCompactAgentContext,\n    signal: AbortSignal,\n  ): Promise<CompactionResult | null> {\n    signal.throwIfAborted()\n    return null\n  }\n\n  /**\n   * The model-driven path lands through the `compress` tool, which runs the\n   * full durable transaction directly. This seam method rejects with guidance:\n   * automatic summarization is exactly what ACP replaces.\n   */\n  override async compactRegion(\n    _start: number,\n    _end: number,\n    _agent: CompactionAgentContext,\n    signal?: AbortSignal,\n  ): Promise<CompactionResult> {\n    signal?.throwIfAborted()\n    throw new ManualCompactionError(\n      'summary',\n      'billion-context-dsh is model-driven: use the compress tool instead of automatic summarization',\n    )\n  }\n}\n\nexport default AcpCompactionEngine\n","/**\n * M2 — per-session ACP kernel state.\n *\n * The in-memory map holds the exact acp-kernel `CompressionState` while a\n * session is live. Durability does not rely on a sidecar file: every durable\n * compression writes a `compaction/summary` event whose shadowed range and\n * summary re-derive the block ledger (`rebuildBlockLedger` in region.ts), so a\n * restarted engine can answer decompress/search/status from the session log\n * alone — DSH's \"log is the source of truth\" model.\n * @module billion-context-dsh/state\n */\n\nimport type { Session } from '@deepseek-ai/dsh-session'\nimport { createInitialState, type CompressionState } from 'acp-kernel'\n\nexport class AcpStateStore {\n  private readonly states = new Map<string, CompressionState>()\n\n  /** Kernel state for one session, initialised on first access. */\n  stateFor(session: Session): CompressionState {\n    const id = session.id\n    const existing = this.states.get(id)\n    if (existing !== undefined) return existing\n    const state = createInitialState()\n    this.states.set(id, state)\n    return state\n  }\n\n  set(session: Session, state: CompressionState): void {\n    this.states.set(session.id, state)\n  }\n\n  delete(session: Session): void {\n    this.states.delete(session.id)\n  }\n}\n","/**\n * M3 — the four model tools: compress / decompress / search_context /\n * acp_status, registered through `ctx.tools` (defineTool).\n *\n * compress is the heart of ACP: the model writes the summary and the tool\n * lands it as a durable surface replacement (no second LLM summarization\n * call). decompress recovers shadowed content read-only from the log (DSH\n * keeps the originals — V5). search_context scores blocks rebuilt from the\n * log. acp_status reports the block ledger and pressure.\n * @module billion-context-dsh/tools\n */\n\nimport { defineTool, type ToolDefinition, type ToolRunContext } from '@deepseek-ai/dsh-tools'\nimport { defaultCountTokens, type CompressionCore } from 'acp-kernel'\nimport type { Agent } from '@deepseek-ai/dsh-agent'\nimport type { AcpStateStore } from './state.ts'\nimport { kernelConfigFor, type KernelConfigInput } from './config.ts'\nimport {\n  rebuildBlockLedger,\n  resolveSurfaceRange,\n  runCompactionTransaction,\n  shadowedSeqsOf,\n} from './region.ts'\nimport { eventsToCoreMessages, extractEventText, surfaceEventsOf } from './messages.ts'\n\nexport interface ToolEnvironment extends KernelConfigInput {\n  readonly kernel: CompressionCore\n  readonly store: AcpStateStore\n}\n\ninterface TextOutput {\n  text: string\n}\n\nfunction textOutput(): {\n  schema: { type: 'object'; properties: { text: { type: 'string' } }; additionalProperties: boolean }\n  render: (args: unknown, value: TextOutput) => import('@deepseek-ai/dsh-llm').ContentBlock[]\n} {\n  return {\n    schema: {\n      type: 'object',\n      properties: { text: { type: 'string' } },\n      additionalProperties: false,\n    },\n    render: (_args, value) => [{ type: 'text', text: value.text }],\n  }\n}\n\nfunction requireAgent(exec: ToolRunContext): Agent {\n  if (exec.agent === undefined) {\n    throw new Error('billion-context-dsh: tool requires an agent execution context')\n  }\n  return exec.agent\n}\n\nconst compressParameters = {\n  topic: { type: 'string' as const, description: 'Fallback topic for entries without their own.' },\n  content: {\n    type: 'array' as const,\n    required: true,\n    description: 'One or more ranges to compress, each with startSeq/endSeq boundaries (surface seqs) and a dense summary.',\n    items: {\n      type: 'object' as const,\n      properties: {\n        startSeq: {\n          oneOf: [\n            { type: 'integer' as const, description: 'First surface seq of the range.' },\n            { type: 'string' as const, description: 'Seq as text; a trailing #callId fragment is ignored.' },\n          ],\n        },\n        endSeq: {\n          oneOf: [\n            { type: 'integer' as const, description: 'Inclusive last surface seq of the range.' },\n            { type: 'string' as const, description: 'Seq as text; a trailing #callId fragment is ignored.' },\n          ],\n        },\n        summary: { type: 'string' as const, description: 'Complete technical summary replacing the range; keep paths, decisions, values verbatim. Minimum 50 characters.' },\n        topic: { type: 'string' as const, description: 'Short label (3-5 words) for this range.' },\n      },\n      additionalProperties: false,\n    },\n  },\n} as const\n\n/** Normalize a seq arg: number, \"295\", or \"295#call_00_xxx\" → 295. */\nfunction parseSeq(value: number | string): number {\n  const text = String(value).split('#')[0]!.trim()\n  const seq = Number(text)\n  if (!Number.isInteger(seq) || seq < 0) {\n    throw new Error(`billion-context-dsh: invalid seq \"${String(value)}\" — use a surface seq like 295`)\n  }\n  return seq\n}\n\ninterface CompressArgs {\n  topic?: string\n  content: Array<{ startSeq: number | string; endSeq: number | string; summary: string; topic?: string }>\n}\n\n/** Resolve seq → kernel ref, then applyCompression and land the transaction. */\nasync function handleCompress(env: ToolEnvironment, args: CompressArgs, exec: ToolRunContext): Promise<TextOutput> {\n  const agent = requireAgent(exec)\n  const session = agent.session\n  const state = env.store.stateFor(session)\n  const coreMessages = eventsToCoreMessages(surfaceEventsOf(session))\n  const tokenCount = coreMessages.reduce((sum, message) => sum + defaultCountTokens(message.text ?? ''), 0)\n  const config = kernelConfigFor(env)\n\n  // Assign refs / advance state exactly like a turn would.\n  const turn = env.kernel.processTurn({ messages: coreMessages, state, config, tokenCount })\n  env.store.set(session, turn.state)\n  const byRaw = turn.state.messageRefs.byRaw\n\n  const ranges = args.content.map((range) => {\n    const startSeq = parseSeq(range.startSeq)\n    const endSeq = parseSeq(range.endSeq)\n    const startRef = byRaw[String(startSeq)]\n    const endRef = byRaw[String(endSeq)]\n    if (startRef === undefined || endRef === undefined) {\n      throw new Error(\n        `billion-context-dsh: seq ${startSeq}..${endSeq} has no assigned ref — `\n        + 'the range must be on the current surface (run acp_status for the live seq list)',\n      )\n    }\n    return {\n      startSeq,\n      endSeq,\n      startRef,\n      endRef,\n      summary: range.summary,\n      ...(range.topic ?? args.topic) === undefined ? {} : { topic: range.topic ?? args.topic },\n    }\n  })\n\n  const applied = env.kernel.applyCompression({\n    ranges: ranges.map(({ startRef, endRef, summary, topic }) => ({ startRef, endRef, summary, topic })),\n    messages: coreMessages,\n    state: turn.state,\n    config,\n  })\n  if (applied.result.errors.length > 0) {\n    return { text: `compress failed: ${applied.result.errors.join('; ')}` }\n  }\n  env.store.set(session, applied.state)\n\n  const lines: string[] = []\n  for (let index = 0; index < ranges.length; index += 1) {\n    const range = ranges[index]!\n    const original = args.content[index]!\n    // The edges may have been nudged to the nearest tool-pairing-balanced cut;\n    // shadow exactly what resolveSurfaceRange approved.\n    const { start, end } = resolveSurfaceRange(session, range.startSeq, range.endSeq)\n    const shadowed = shadowedSeqsOf(session, start, end)\n    // Estimate the reclaimed tokens from the actual shadowed messages so the\n    // durable ledger (compaction/summary.shadowedTokenCount) reports a real\n    // number instead of 0.\n    let shadowedTokens = 0\n    for (const seq of shadowed) {\n      const event = session.events[seq]\n      if (event !== undefined) shadowedTokens += defaultCountTokens(extractEventText(event))\n    }\n    const { compactionId } = runCompactionTransaction(session, {\n      start,\n      end,\n      shadowedSeqs: shadowed,\n      summary: [{ type: 'text', text: original.summary }],\n      shadowedTokenCount: shadowedTokens,\n      provider: agent.options.provider ?? '',\n      model: agent.options.model ?? '',\n    })\n    const adjusted = start !== range.startSeq || end !== range.endSeq\n    lines.push(\n      `  block ${compactionId.slice(0, 8)}: seqs ${start}..${end}, ${shadowed.length} messages shadowed`\n      + (adjusted ? ` (adjusted from ${range.startSeq}..${range.endSeq} to balanced edges)` : ''),\n    )\n  }\n\n  return {\n    text: `Compressed ${applied.result.blocksCreated} block(s), ~${applied.result.tokensCompressed} tokens reclaimed.\\n${lines.join('\\n')}`,\n  }\n}\n\nconst decompressParameters = {\n  blockId: { type: 'string' as const, required: true, description: 'Block id from acp_status or search_context (the compaction id).' },\n} as const\n\ninterface DecompressArgs {\n  blockId: string\n}\n\nfunction handleDecompress(_env: ToolEnvironment, args: DecompressArgs, exec: ToolRunContext): TextOutput {\n  const session = requireAgent(exec).session\n  const ledger = rebuildBlockLedger(session.events)\n  const block = ledger.find((entry) => entry.blockId.startsWith(args.blockId))\n  if (block === undefined) {\n    return { text: `decompress: block \"${args.blockId}\" not found (see acp_status for the block list)` }\n  }\n  const parts: string[] = []\n  for (const seq of block.shadowedSeqs) {\n    const event = session.events[seq]\n    const text = event === undefined ? '' : extractEventText(event)\n    if (text.length > 0) parts.push(`[seq ${seq}] ${text}`)\n  }\n  return {\n    text: `Block ${block.blockId} — ${block.summary}\\n\\n${parts.join('\\n\\n') || '(no recoverable content)'}`,\n  }\n}\n\nconst searchParameters = {\n  query: { type: 'string' as const, required: true, description: 'Search terms to find inside compressed blocks.' },\n  limit: { type: 'integer' as const, description: 'Maximum results (default 5).' },\n} as const\n\ninterface SearchArgs {\n  query: string\n  limit?: number\n}\n\nfunction handleSearch(_env: ToolEnvironment, args: SearchArgs, exec: ToolRunContext): TextOutput {\n  const session = requireAgent(exec).session\n  const ledger = rebuildBlockLedger(session.events)\n  const terms = args.query.toLowerCase().split(/\\s+/).filter(Boolean)\n  const scored: Array<{ blockId: string; score: number; summary: string }> = []\n  for (const block of ledger) {\n    const original = block.shadowedSeqs\n      .map((seq) => extractEventText(session.events[seq]!))\n      .join('\\n')\n    const haystack = `${block.summary}\\n${original}`.toLowerCase()\n    let score = 0\n    for (const term of terms) score += haystack.split(term).length - 1\n    if (score > 0) scored.push({ blockId: block.blockId, score, summary: block.summary })\n  }\n  scored.sort((a, b) => b.score - a.score)\n  const top = scored.slice(0, args.limit ?? 5)\n  if (top.length === 0) return { text: `search_context: no matches for \"${args.query}\"` }\n  return {\n    text: `Matches for \"${args.query}\":\\n`\n      + top.map((hit) => `  - ${hit.blockId} (score ${hit.score}): ${hit.summary.slice(0, 160)}`).join('\\n')\n      + '\\n\\nDecompress with: decompress({ blockId })',\n  }\n}\n\nconst statusParameters = {} as const\n\ninterface StatusArgs {\n  [key: string]: never\n}\n\nfunction handleStatus(env: ToolEnvironment, _args: StatusArgs, exec: ToolRunContext): TextOutput {\n  const session = requireAgent(exec).session\n  const ledger = rebuildBlockLedger(session.events)\n  const totalTokens = ledger.reduce((sum, block) => sum + block.shadowedTokenCount, 0)\n  const coreMessages = eventsToCoreMessages(surfaceEventsOf(session))\n  const estimated = coreMessages.reduce((sum, message) => sum + defaultCountTokens(message.text ?? ''), 0)\n  const limit = env.modelContextLimit\n  const lines = [\n    `ACP status — session ${session.id}`,\n    `  blocks: ${ledger.length}`,\n    `  tokens compressed: ${totalTokens}`,\n    `  estimated context: ${estimated} / ${limit} (${Math.round((estimated / limit) * 100)}%)`,\n  ]\n  for (const block of ledger.slice(0, 10)) {\n    lines.push(`  - ${block.blockId.slice(0, 8)}: seqs ${block.start}..${block.end} (${block.shadowedSeqs.length} msgs) — ${block.summary.slice(0, 80)}`)\n  }\n  return { text: lines.join('\\n') }\n}\n\n/** Build the four ACP model tools bound to one engine. */\nexport function makeTools(env: ToolEnvironment): ToolDefinition[] {\n  return [\n    defineTool({\n      name: 'compress',\n      description:\n        'Replace older conversation ranges with dense summaries you write. '\n        + 'Each message seq is a surface reference. Single range: compress({ content: [{ startSeq, endSeq, summary }] }). '\n        + 'Batch multiple unrelated ranges in one call. Never compress content the current step is actively using.',\n      parameters: compressParameters,\n      output: textOutput(),\n      async execute(args, exec) {\n        return handleCompress(env, args as CompressArgs, exec)\n      },\n    }),\n    defineTool({\n      name: 'decompress',\n      description: 'Recover the original content of a compressed block by its blockId (read-only; does not unshadow the range).',\n      parameters: decompressParameters,\n      output: textOutput(),\n      execute(args, exec) {\n        return Promise.resolve(handleDecompress(env, args as DecompressArgs, exec))\n      },\n    }),\n    defineTool({\n      name: 'search_context',\n      description: 'Search inside compressed blocks (summaries and original content) for information the model no longer sees in context.',\n      parameters: searchParameters,\n      output: textOutput(),\n      execute(args, exec) {\n        return Promise.resolve(handleSearch(env, args as SearchArgs, exec))\n      },\n    }),\n    defineTool({\n      name: 'acp_status',\n      description: 'Report the ACP block ledger: compressed blocks, reclaimed tokens, and current context pressure.',\n      parameters: statusParameters,\n      output: textOutput(),\n      execute(args, exec) {\n        return Promise.resolve(handleStatus(env, args as StatusArgs, exec))\n      },\n    }),\n  ]\n}\n","/**\n * Kernel configuration assembly — the DSH counterpart of billion-context-pi's\n * `resolveConfig`: build acp-kernel's `Config` from adapter-level knobs.\n *\n * Defaults are deliberately the acp-kernel `defaultConfig` values (the same\n * defaults billion-context-pi ships: nudge window 45%–75%, emergency 95%,\n * growth ratio 5%, protected last messages 5). Every knob is optional — an\n * omitted value keeps the kernel default, so the behavior matches the Pi\n * adapter exactly unless a deployment opts out.\n * @module billion-context-dsh/config\n */\n\nimport { defaultConfig, type Config } from 'acp-kernel'\n\n/** The kernel-facing knobs shared by the nudge path and the compress tool. */\nexport interface KernelConfigInput {\n  readonly modelContextLimit: number\n  /** Nudge window lower bound (usage fraction). Kernel default: 0.45. */\n  readonly nudgeMinContextLimitPct?: number\n  /** Nudge window upper bound — over-limit. Kernel default: 0.75. */\n  readonly nudgeMaxContextLimitPct?: number\n  /** Emergency nudge threshold (bypasses per-turn dedup). Kernel default: 0.95. */\n  readonly nudgeEmergencyThresholdPct?: number\n  /** Any other acp-kernel Config override (the billion-context-pi escape hatch). */\n  readonly coreOverrides?: Partial<Config>\n}\n\n/**\n * Assemble the kernel config: `defaultConfig(limit)` merged with the optional\n * nudge thresholds (merged into the defaults, never replacing them wholesale)\n * and any additional `coreOverrides`.\n */\nexport function kernelConfigFor(input: KernelConfigInput): Config {\n  const nudgePatch: Partial<Config['nudge']> = {}\n  if (input.nudgeMinContextLimitPct !== undefined) nudgePatch.minContextLimitPct = input.nudgeMinContextLimitPct\n  if (input.nudgeMaxContextLimitPct !== undefined) nudgePatch.maxContextLimitPct = input.nudgeMaxContextLimitPct\n  if (input.nudgeEmergencyThresholdPct !== undefined) nudgePatch.emergencyThresholdPct = input.nudgeEmergencyThresholdPct\n\n  const overrides: Partial<Config> = { ...input.coreOverrides }\n  if (Object.keys(nudgePatch).length > 0) {\n    overrides.nudge = { ...defaultConfig(input.modelContextLimit).nudge, ...nudgePatch }\n  }\n  return defaultConfig(input.modelContextLimit, overrides)\n}\n","/**\n * M5 — durable region transaction and the log-rebuilt block ledger.\n *\n * Modeled on `dsh-compaction-basic/src/region.ts` (which is package-internal\n * and not exported by the seam): validate the surface range and tool-call/result\n * pairing, take the durable `compaction/start` lock, record `compaction/summary`\n * as the shadow price, land the `user/message` surface replacement carrying the\n * summary under `compactCheckpointSource`, and release the lock with\n * `compaction/end`. The original events stay in the append-only log, so\n * decompress/search/status can rebuild everything from the log.\n * @module billion-context-dsh/region\n */\n\nimport { randomUUID } from 'node:crypto'\nimport type { Session, SessionEvent } from '@deepseek-ai/dsh-session'\nimport {\n  CompactionId,\n  compactCheckpointSource,\n  toolPairingBalancedAfter,\n  toolPairingBalancedBefore,\n} from '@deepseek-ai/dsh-compaction'\nimport { createUserMessage, type ContentBlock } from '@deepseek-ai/dsh-llm'\nimport { defaultCountTokens } from 'acp-kernel'\nimport { extractEventText, extractText } from './messages.ts'\n\n/** One durable ACP block as rebuilt from the session log. */\nexport interface AcpBlockLedgerEntry {\n  /** The compaction transaction id (stable block identity). */\n  readonly blockId: string\n  readonly summary: string\n  readonly shadowedSeqs: readonly number[]\n  readonly shadowedTokenCount: number\n  readonly start: number\n  readonly end: number\n}\n\n/** The open turn number, or null when the log ends between turns. */\nexport function findOpenTurn(events: readonly SessionEvent[]): number | null {\n  let open: number | null = null\n  for (const event of events) {\n    if (event.type === 'turn/start') open = event.data.turn\n    else if (event.type === 'turn/end' && event.data.turn === open) open = null\n  }\n  return open\n}\n\n/** Reject a second concurrent compaction for the same session. */\nexport function assertNoActiveCompaction(events: readonly SessionEvent[]): void {\n  let active = false\n  for (const event of events) {\n    if (event.type === 'compaction/start') active = true\n    else if (event.type === 'compaction/end') active = false\n  }\n  if (active) {\n    throw new Error('billion-context-dsh: another compaction is already active for this session')\n  }\n}\n\n/**\n * Validate one inclusive surface span and adjust its edges to a\n * tool-pairing-balanced range. Missing or reversed ranges still throw. An\n * edge that sits inside a tool-call/result pair is first nudged inward to the\n * nearest clean cut; if that collapses the range (e.g. the model asked for a\n * SINGLE tool result, which can never be balanced alone), the range EXPANDS\n * outward to the enclosing balanced pair instead — a lone tool message is\n * almost always a \"consumed output\" the model genuinely wants to compress.\n * The returned range is what a caller should actually shadow.\n */\nexport function resolveSurfaceRange(\n  session: Session,\n  start: number,\n  end: number,\n): { start: number; end: number } {\n  const nodes = session.surface.nodes\n  const requestedStartIdx = nodes.indexOf(start)\n  const requestedEndIdx = nodes.indexOf(end)\n  if (requestedStartIdx < 0 || requestedEndIdx < 0) {\n    throw new Error(`billion-context-dsh: seq ${start}..${end} not in the current surface`)\n  }\n  if (requestedStartIdx > requestedEndIdx) {\n    throw new Error(`billion-context-dsh: reversed range ${start}..${end}`)\n  }\n  let startIdx = requestedStartIdx\n  let endIdx = requestedEndIdx\n  // First pass: nudge inward to the nearest balanced cuts.\n  while (startIdx <= endIdx && !toolPairingBalancedBefore(session, nodes[startIdx]!)) {\n    startIdx += 1\n  }\n  while (endIdx >= startIdx && !toolPairingBalancedAfter(session, nodes[endIdx]!)) {\n    endIdx -= 1\n  }\n  if (startIdx <= endIdx) {\n    return { start: nodes[startIdx]!, end: nodes[endIdx]! }\n  }\n  // Second pass: the inward pass collapsed (a lone tool message) — expand\n  // outward from the REQUESTED span to the smallest balanced enclosing pair.\n  startIdx = requestedStartIdx\n  endIdx = requestedEndIdx\n  while (startIdx > 0 && !toolPairingBalancedBefore(session, nodes[startIdx]!)) {\n    startIdx -= 1\n  }\n  while (endIdx < nodes.length - 1 && !toolPairingBalancedAfter(session, nodes[endIdx]!)) {\n    endIdx += 1\n  }\n  if (toolPairingBalancedBefore(session, nodes[startIdx]!) && toolPairingBalancedAfter(session, nodes[endIdx]!)) {\n    return { start: nodes[startIdx]!, end: nodes[endIdx]! }\n  }\n  throw new Error(\n    `billion-context-dsh: no tool-pairing-balanced range around seq ${start}..${end} — `\n    + 'narrow the range or consult acp_status for the current surface',\n  )\n}\n\n/** The surface seqs shadowed by the inclusive positional span. */\nexport function shadowedSeqsOf(session: Session, start: number, end: number): number[] {\n  const nodes = session.surface.nodes\n  const startIdx = nodes.indexOf(start)\n  const endIdx = nodes.indexOf(end)\n  return nodes.slice(startIdx, endIdx + 1)\n}\n\nexport interface CompactionTransactionInput {\n  readonly start: number\n  readonly end: number\n  readonly shadowedSeqs: readonly number[]\n  readonly summary: ContentBlock[]\n  readonly shadowedTokenCount: number\n  readonly provider: string\n  readonly model: string\n}\n\n/**\n * Run one durable compression transaction. Throws on invalid state; on success\n * the four events are in the log and the surface has one summary node.\n */\nexport function runCompactionTransaction(\n  session: Session,\n  input: CompactionTransactionInput,\n): { compactionId: string; seqs: number[] } {\n  assertNoActiveCompaction(session.events)\n  const turn = findOpenTurn(session.events)\n  const compactionId = CompactionId(randomUUID())\n  const seqs: number[] = []\n\n  seqs.push(session.append('compaction/start', { compactionId, turn }).seq)\n  seqs.push(session.append('compaction/summary', {\n    compactionId,\n    summary: input.summary,\n    shadowedRange: { start: input.start, end: input.end },\n    shadowedSeqs: [...input.shadowedSeqs],\n    shadowedTokenCount: input.shadowedTokenCount,\n    provider: input.provider,\n    model: input.model,\n  }).seq)\n\n  const message = createUserMessage({\n    content: input.summary,\n    source: compactCheckpointSource(compactionId),\n  })\n  seqs.push(session.append('user/message', message, {\n    surfaceOp: { op: 'replace', start: input.start, end: input.end },\n    sourceEventSeqs: [...input.shadowedSeqs],\n  }).seq)\n\n  seqs.push(session.append('compaction/end', { compactionId, turn }).seq)\n  return { compactionId, seqs }\n}\n\n/** Rebuild the block ledger from the durable log (no kernel state needed). */\nexport function rebuildBlockLedger(events: readonly SessionEvent[]): AcpBlockLedgerEntry[] {\n  const ledger: AcpBlockLedgerEntry[] = []\n  for (const event of events) {\n    if (event.type !== 'compaction/summary') continue\n    const data = event.data\n    // Blocks written before the token-accounting fix carry shadowedTokenCount\n    // 0; backfill from the shadowed originals still in the log so acp_status\n    // reports real reclaimed tokens.\n    let shadowedTokenCount = data.shadowedTokenCount\n    if (shadowedTokenCount === 0) {\n      shadowedTokenCount = 0\n      for (const seq of data.shadowedSeqs) {\n        const original = events[seq]\n        if (original !== undefined) shadowedTokenCount += defaultCountTokens(extractEventText(original))\n      }\n    }\n    ledger.push({\n      blockId: data.compactionId,\n      summary: extractText(data.summary),\n      shadowedSeqs: [...data.shadowedSeqs],\n      shadowedTokenCount,\n      start: data.shadowedRange.start,\n      end: data.shadowedRange.end,\n    })\n  }\n  return ledger\n}\n\n/** One self-computed compressible span of the current surface. */\nexport interface SeqCompressibleRange {\n  readonly start: number\n  readonly end: number\n  readonly count: number\n  readonly tokens: number\n}\n\n/** Whether a surface user message is a compaction checkpoint node (already compressed). */\nfunction isCheckpointNode(event: SessionEvent): boolean {\n  if (event.type !== 'user/message') return false\n  const source = (event.data as { source?: { plugin?: string } }).source\n  return source?.plugin === 'compact'\n}\n\n/**\n * Compute compressible spans directly from the surface — independent of the\n * kernel's ref map, which can drift after surface replacements in long\n * sessions and hide large tool results from the nudge range table. Skips the\n * recent protected tail, the last user message, and compaction checkpoints;\n * edges are then balanced through resolveSurfaceRange. Ranges are ordered by\n * size (largest reclaimed first).\n */\nexport function buildCompressibleSeqRanges(\n  session: Session,\n  opts: { preserveRecent?: number } = {},\n): SeqCompressibleRange[] {\n  const nodes = session.surface.nodes\n  const preserve = opts.preserveRecent ?? 5\n  const protectedSeqs = new Set<number>()\n  for (const seq of nodes.slice(-preserve)) protectedSeqs.add(seq)\n  for (let index = nodes.length - 1; index >= 0; index -= 1) {\n    const event = session.events[nodes[index]!]\n    if (event?.type === 'user/message' && !isCheckpointNode(event)) {\n      protectedSeqs.add(nodes[index]!)\n      break\n    }\n  }\n  const raw: SeqCompressibleRange[] = []\n  let cur: SeqCompressibleRange | null = null\n  const flush = (): void => {\n    if (cur !== null) raw.push(cur)\n    cur = null\n  }\n  for (const seq of nodes) {\n    const event = session.events[seq]\n    if (event === undefined || protectedSeqs.has(seq) || isCheckpointNode(event)) {\n      flush()\n      continue\n    }\n    const tokens = defaultCountTokens(extractEventText(event))\n    if (cur === null) {\n      cur = { start: seq, end: seq, count: 1, tokens }\n    } else {\n      cur = { start: cur.start, end: seq, count: cur.count + 1, tokens: cur.tokens + tokens }\n    }\n  }\n  flush()\n  const out: SeqCompressibleRange[] = []\n  for (const range of raw) {\n    try {\n      const { start, end } = resolveSurfaceRange(session, range.start, range.end)\n      const count = range.count\n      out.push({ start, end, count, tokens: range.tokens })\n    } catch {\n      // Cannot be balanced into a compressible span — skip.\n    }\n  }\n  return out.sort((a, b) => b.tokens - a.tokens)\n}\n","/**\n * M1 — session-log projection: DSH surface events → acp-kernel CoreMessage.\n *\n * The ACP kernel is message-array based; DSH is event-log based. This module\n * is the bridge in the direction the engine needs (projectEvent /\n * eventsToCoreMessages). The reverse direction (CoreMessage[] → session\n * appends) is the M5 region transaction's job.\n * Mirrors billion-context-pi's `projectMessage`/`entriesToCoreMessages`\n * against DSH event shapes (see V-verification: SurfaceEventType =\n * 'user/message' | 'assistant/message' | 'tool/result').\n * @module billion-context-pi-dsh/messages\n */\n\nimport type { CoreMessage } from 'acp-kernel'\nimport type { SessionEvent } from '@deepseek-ai/dsh-session'\n\n/**\n * Extract plain text from a DSH content block array or string.\n *\n * Recursive: a real DSH `tool-result` block is `{ type: 'tool-result',\n * toolCallId, content: ContentBlock[] }` — the inner `content` array holds\n * the actual `text` blocks, so a top-level-only walk would drop every tool\n * result from the projection (and with it the seq's ref assignment, breaking\n * compress boundary resolution). Nested arrays are flattened depth-first.\n */\nexport function extractText(content: unknown): string {\n  if (typeof content === 'string') return content\n  if (!Array.isArray(content)) return ''\n  const parts: string[] = []\n  for (const block of content) {\n    if (block === null || typeof block !== 'object') continue\n    const b = block as { type?: unknown; text?: unknown; content?: unknown }\n    if (b.type === 'text' && typeof b.text === 'string') {\n      parts.push(b.text)\n    } else if (Array.isArray(b.content)) {\n      parts.push(extractText(b.content))\n    }\n  }\n  return parts.join('\\n')\n}\n\ninterface ToolCallBlock {\n  type: 'tool-call'\n  id?: string\n  name?: string\n  arguments?: unknown\n}\n\nfunction toolCallsOf(content: unknown): ToolCallBlock[] {\n  if (!Array.isArray(content)) return []\n  return content.filter((b): b is ToolCallBlock => (b as { type?: string }).type === 'tool-call')\n}\n\nfunction stringifyArgs(args: unknown): string {\n  if (!args) return ''\n  if (typeof args === 'string') return args\n  try {\n    return JSON.stringify(args)\n  } catch {\n    return String(args)\n  }\n}\n\n/**\n * Project one surface message event into CoreMessage(s).\n *  - user/message      → user text (verbatim content)\n *  - assistant/message → assistant text, or one CoreMessage per tool-call\n *  - tool/result       → tool result (toolName/toolCallId, role 'tool')\n * Non-surface events project to nothing.\n */\nexport function projectEvent(event: SessionEvent): CoreMessage[] {\n  switch (event.type) {\n    case 'user/message': {\n      const text = extractText((event.data as { content?: unknown }).content)\n      return text.length > 0 ? [{ id: String(event.seq), role: 'user', contentType: 'text', text }] : []\n    }\n    case 'assistant/message': {\n      const content = (event.data as { message?: { content?: unknown } }).message?.content\n      const calls = toolCallsOf(content)\n      const text = extractText(content)\n      if (calls.length === 0) {\n        return text.trim().length > 0\n          ? [{ id: String(event.seq), role: 'assistant', contentType: 'text', text }]\n          : []\n      }\n      if (calls.length === 1) {\n        const call = calls[0]!\n        const argStr = stringifyArgs(call.arguments)\n        const body = argStr && text ? `${text}\\n${argStr}` : argStr || text\n        return [{\n          id: String(event.seq),\n          role: 'assistant',\n          contentType: 'tool-call',\n          toolName: call.name ?? '',\n          toolCallId: call.id ?? '',\n          text: body,\n        }]\n      }\n      return calls.map((call) => ({\n        id: `${event.seq}#${call.id ?? ''}`,\n        role: 'assistant' as const,\n        contentType: 'tool-call' as const,\n        toolName: call.name ?? '',\n        toolCallId: call.id ?? '',\n        text: stringifyArgs(call.arguments) || text,\n      }))\n    }\n    case 'tool/result': {\n      const message = (event.data as {\n        message?: { content?: unknown; toolName?: string; toolCallId?: string }\n      }).message\n      const text = extractText(message?.content)\n      if (text.length === 0) return []\n      return [{\n        id: String(event.seq),\n        role: 'tool',\n        contentType: 'tool-result',\n        toolName: message?.toolName ?? '',\n        toolCallId: message?.toolCallId ?? '',\n        text,\n      }]\n    }\n    default:\n      return []\n  }\n}\n\n/** Project a session's message events into CoreMessage[] in log order. */\nexport function eventsToCoreMessages(events: readonly SessionEvent[]): CoreMessage[] {\n  const out: CoreMessage[] = []\n  for (const event of events) out.push(...projectEvent(event))\n  return out\n}\n\n/** The surface-visible message events of a session, in model-visible order. */\nexport function surfaceEventsOf(session: import('@deepseek-ai/dsh-session').Session): SessionEvent[] {\n  return session.surface.nodes\n    .map((seq) => session.events[seq])\n    .filter((event): event is SessionEvent => event !== undefined)\n}\n\n/** Extract the model-facing text of any surface message event. */\nexport function extractEventText(event: SessionEvent): string {\n  switch (event.type) {\n    case 'user/message':\n      return extractText((event.data as { content?: unknown }).content)\n    case 'assistant/message':\n      return extractText((event.data as { message?: { content?: unknown } }).message?.content)\n    case 'tool/result':\n      return extractText((event.data as { message?: { content?: unknown } }).message?.content)\n    default:\n      return ''\n  }\n}\n","/**\n * M4 — the `/acp` slash command: a human-friendly window into the same\n * machinery the model tools expose (status, one-shot compress, decompress).\n * @module billion-context-dsh/commands\n */\n\nimport type { CommandDefinition } from '@deepseek-ai/dsh-commands'\nimport type { Agent } from '@deepseek-ai/dsh-agent'\nimport type { ToolEnvironment } from './tools.ts'\nimport {\n  rebuildBlockLedger,\n  resolveSurfaceRange,\n  runCompactionTransaction,\n  shadowedSeqsOf,\n} from './region.ts'\nimport { eventsToCoreMessages, extractEventText, surfaceEventsOf } from './messages.ts'\nimport { defaultConfig, defaultCountTokens } from 'acp-kernel'\n\nfunction statusText(env: ToolEnvironment, agent: Agent): string {\n  const session = agent.session\n  const ledger = rebuildBlockLedger(session.events)\n  const totalTokens = ledger.reduce((sum, block) => sum + block.shadowedTokenCount, 0)\n  const coreMessages = eventsToCoreMessages(surfaceEventsOf(session))\n  const estimated = coreMessages.reduce((sum, message) => sum + defaultCountTokens(message.text ?? ''), 0)\n  const limit = env.modelContextLimit\n  const lines = [\n    `ACP status — session ${session.id}`,\n    `  blocks: ${ledger.length}`,\n    `  tokens compressed: ${totalTokens}`,\n    `  estimated context: ${estimated} / ${limit} (${Math.round((estimated / limit) * 100)}%)`,\n  ]\n  for (const block of ledger.slice(0, 10)) {\n    lines.push(`  - ${block.blockId.slice(0, 8)}: seqs ${block.start}..${block.end} — ${block.summary.slice(0, 80)}`)\n  }\n  return lines.join('\\n')\n}\n\nfunction compressText(env: ToolEnvironment, agent: Agent, args: string[]): string {\n  if (args.length < 3) {\n    return '/acp compress <startSeq> <endSeq> <summary...>'\n  }\n  const startSeq = Number(args[0])\n  const endSeq = Number(args[1])\n  const summary = args.slice(2).join(' ')\n  if (!Number.isInteger(startSeq) || !Number.isInteger(endSeq)) {\n    return '/acp compress: startSeq and endSeq must be integers'\n  }\n  const session = agent.session\n  const { start, end } = resolveSurfaceRange(session, startSeq, endSeq)\n  const shadowed = shadowedSeqsOf(session, startSeq, endSeq)\n  let shadowedTokens = 0\n  for (const seq of shadowed) {\n    const event = session.events[seq]\n    if (event !== undefined) shadowedTokens += defaultCountTokens(extractEventText(event))\n  }\n  const { compactionId } = runCompactionTransaction(session, {\n    start,\n    end,\n    shadowedSeqs: shadowed,\n    summary: [{ type: 'text', text: summary }],\n    shadowedTokenCount: shadowedTokens,\n    provider: agent.options.provider ?? '',\n    model: agent.options.model ?? '',\n  })\n  return `Compressed seqs ${start}..${end} (${shadowed.length} messages) as block ${compactionId.slice(0, 8)}`\n}\n\nfunction decompressText(_env: ToolEnvironment, agent: Agent, args: string[]): string {\n  if (args.length < 1) return '/acp decompress <blockId>'\n  const session = agent.session\n  const ledger = rebuildBlockLedger(session.events)\n  const block = ledger.find((entry) => entry.blockId.startsWith(args[0]!))\n  if (block === undefined) return `block \"${args[0]}\" not found (see /acp status)`\n  const parts = block.shadowedSeqs\n    .map((seq) => extractEventText(session.events[seq]!))\n    .filter((text) => text.length > 0)\n  return `Block ${block.blockId} — ${block.summary}\\n\\n${parts.join('\\n\\n') || '(no recoverable content)'}`\n}\n\n/** Register the /acp command (idempotent per engine). */\nexport function acpCommand(env: ToolEnvironment): CommandDefinition {\n  return {\n    name: 'acp',\n    description:\n      'Active Context Pruning — model-driven context compression. '\n      + 'Usage: /acp status | /acp compress <startSeq> <endSeq> <summary> | /acp decompress <blockId>',\n    handler: async (invocation) => {\n      const raw = invocation.rawInput.trim()\n      if (raw === '' || raw === 'status') {\n        return { kind: 'success', text: statusText(env, invocation.agent) }\n      }\n      if (raw.startsWith('compress')) {\n        return { kind: 'success', text: compressText(env, invocation.agent, raw.slice('compress'.length).trim().split(/\\s+/) ) }\n      }\n      if (raw.startsWith('decompress')) {\n        return { kind: 'success', text: decompressText(env, invocation.agent, raw.slice('decompress'.length).trim().split(/\\s+/)) }\n      }\n      return { kind: 'error', text: `unknown /acp subcommand \"${raw.split(/\\s+/)[0]}\" — use status | compress | decompress` }\n    },\n  }\n}\n","/**\n * M4 — ACP nudge: the kernel's compression recommendation, rendered as an\n * injected user message with a seq-based compressible-range table (D1:\n * \"seq is the ref\" — DSH has no in-memory message rewrite hook, so the model\n * targets ranges by surface seq rather than by <acp> tags).\n * @module billion-context-dsh/nudge\n */\n\nimport {\n  defaultCountTokens,\n  type CompressionCore,\n  type CoreMessage,\n  type NudgeDecision,\n} from 'acp-kernel'\nimport { createUserMessage, type UserMessage } from '@deepseek-ai/dsh-llm'\nimport type { Agent } from '@deepseek-ai/dsh-agent'\nimport { AcpStateStore } from './state.ts'\nimport { eventsToCoreMessages, surfaceEventsOf } from './messages.ts'\nimport { buildCompressibleSeqRanges, findOpenTurn } from './region.ts'\nimport { kernelConfigFor, type KernelConfigInput } from './config.ts'\n\n/** Kernel inputs the nudge path shares with the compress tool. */\nexport interface NudgeEnvironment extends KernelConfigInput {\n  readonly kernel: CompressionCore\n  readonly store: AcpStateStore\n}\n\nexport interface NudgeOutcome {\n  readonly message: UserMessage\n  readonly emergency: boolean\n}\n\n/**\n * Render the compressible-range table as seq refs for the model.\n * Computed directly from the surface (not the kernel's ref map, which can\n * drift and hide large tool results) — see buildCompressibleSeqRanges.\n */\nexport function rangeTable(session: import('@deepseek-ai/dsh-session').Session): string {\n  const ranges = buildCompressibleSeqRanges(session).slice(0, 6)\n  if (ranges.length === 0) return ''\n  const lines = ranges.map((range) => `  - seq ${range.start}..${range.end} — ${range.count} messages, ~${range.tokens} tokens`)\n  return [\n    '',\n    'Compressible ranges (refs are surface seqs):',\n    ...lines,\n    'Compress with: compress({ content: [{ startSeq, endSeq, summary }] })',\n  ].join('\\n')\n}\n\n/**\n * The token count driving pressure decisions. Prefer the host token meter's\n * SURFACE tokens (the input-side heuristic total — matches acp_status and the\n * UI's message-token view). `totalTokens` is request-AND-RESPONSE pressure and\n * can far exceed the window in long sessions (observed 230% against a real\n * ~20% occupancy), so it is not used. Falls back to the fast heuristic when\n * the meter is absent (tests, minimal hosts).\n */\nfunction measuredTokenCount(agent: Agent, coreMessages: CoreMessage[]): number {\n  const meter = agent.ctx?.get?.('tokenMeter') as\n    | { measure?: (session: unknown) => { surfaceTokens?: number } }\n    | undefined\n  const surface = meter?.measure?.(agent.session)?.surfaceTokens\n  if (typeof surface === 'number' && surface > 0) return surface\n  return coreMessages.reduce((sum, message) => sum + defaultCountTokens(message.text ?? ''), 0)\n}\n\n/**\n * Decide and build one nudge message for the agent's next pre-step. Returns\n * null when the kernel recommends no nudge or one was already injected for the\n * current turn (emergency nudges always bypass the dedup). Also advances the\n * in-memory kernel state (ref assignment) so the compress tool can resolve\n * seq → mNNNNN refs.\n */\nexport function buildNudge(\n  agent: Agent,\n  env: NudgeEnvironment,\n  lastNudgeTurn: Map<string, number>,\n): NudgeOutcome | null {\n  const session = agent.session\n  const state = env.store.stateFor(session)\n  const coreMessages = eventsToCoreMessages(surfaceEventsOf(session))\n  const tokenCount = measuredTokenCount(agent, coreMessages)\n  const config = kernelConfigFor(env)\n  const turn = env.kernel.processTurn({ messages: coreMessages, state, config, tokenCount })\n  env.store.set(session, turn.state)\n\n  const nudge = turn.nudge\n  if (nudge === undefined || !nudge.shouldInject) return null\n  const emergency = nudge.breakdown?.emergencyOverride === 1\n\n  const turnNumber = findOpenTurn(session.events) ?? 0\n  const alreadyShown = !emergency && lastNudgeTurn.get(session.id) === turnNumber\n  if (alreadyShown) return null\n  lastNudgeTurn.set(session.id, turnNumber)\n\n  const text = buildNudgeText(nudge, emergency, session)\n  const message = createUserMessage({\n    content: [{ type: 'text', text }],\n    source: { kind: 'plugin', plugin: 'acp-nudge' },\n  })\n  return { message, emergency }\n}\n\n/**\n * A short ADVISORY nudge — ACP is model-driven, the model decides whether and\n * when to compress. Full guidance (tools, philosophy, summary rules) lives in\n * the system prompt once, not in every nudge.\n */\nfunction buildNudgeText(\n  nudge: NudgeDecision,\n  emergency: boolean,\n  session: import('@deepseek-ai/dsh-session').Session,\n): string {\n  // Cap the reported percentage at 100: a broken measurement (e.g. response\n  // pressure folded in) must never surface as an absurd \"230%\" to the model.\n  const pct = Math.round(Math.min(nudge.contextUsage, 1) * 100)\n  const frame = emergency\n    ? `⚠️ Context usage is at ${pct}% of the window — nearly full. Consider compressing consumed ranges soon so working context stays available; the choice and timing are yours.`\n    : `Context usage is at ${pct}%. This is a suggestion, not a requirement — you decide whether and when to compress.`\n  const guidance = 'Compress by need, not by percentage: replace only ranges you have genuinely consumed, with dense self-contained summaries.'\n  return [frame, '', guidance, rangeTable(session)].join('\\n')\n}\n","/**\n * M4 — the ACP system-prompt section (DSH counterpart of billion-context-pi's\n * ACP_SYSTEM_PROMPT): the load-bearing compression guidance lives here, ONCE,\n * instead of being re-sent with every nudge. The nudge itself stays a short,\n * advisory notice — ACP is model-driven, the model decides whether and when\n * to compress (never \"compress now\").\n * @module billion-context-dsh/system-prompt\n */\n\nimport { COMPRESS_PHILOSOPHY } from 'acp-kernel'\n\nexport const ACP_SYSTEM_PROMPT = `Active Context Pruning — model-driven context management\n\nYOU decide whether and when to compress context. Nothing forces you: the injected \"nudge\" is a suggestion, not an order, and you may ignore it when compression would not help. Compress only ranges you have genuinely consumed (read tool outputs, finished explorations, superseded steps) that the current work no longer needs verbatim.\n\n${COMPRESS_PHILOSOPHY}\n\nCompression tools (refs are SURFACE SEQS, not ids):\n- compress: replace a seq range with your dense self-contained summary. compress({ content: [{ startSeq, endSeq, summary }] }). Edges are auto-balanced to tool-call/result boundaries; a trailing #callId fragment in a seq is ignored. Ranges must be on the current surface — stale seqs fail with guidance.\n- decompress: recover a compressed block's original content, read-only. decompress({ blockId }).\n- search_context: find information inside compressed blocks BEFORE decompressing. search_context({ query }).\n- acp_status: current context usage and the live compressible-range list. Run it before compressing when in doubt.\n\nWhen you write a summary, it becomes the ONLY record of that range: keep file paths, signatures, exact values, decisions, and error strings verbatim so a later reader (or you, after decompress) can continue without the original. Never reuse historical seqs — the surface moves as messages land and compress; verify with acp_status.`\n\n/** System-prompt section order: tool guidance lives in 100–199. */\nexport const ACP_SYSTEM_PROMPT_ORDER = 150\n"],"mappings":";AA6BA;AAAA,EACE;AAAA,EACA;AAAA,OAKK;AACP,SAAS,kBAAwC;;;ACxBjD,SAAS,0BAAiD;AAEnD,IAAM,gBAAN,MAAoB;AAAA,EACR,SAAS,oBAAI,IAA8B;AAAA;AAAA,EAG5D,SAAS,SAAoC;AAC3C,UAAM,KAAK,QAAQ;AACnB,UAAM,WAAW,KAAK,OAAO,IAAI,EAAE;AACnC,QAAI,aAAa,OAAW,QAAO;AACnC,UAAM,QAAQ,mBAAmB;AACjC,SAAK,OAAO,IAAI,IAAI,KAAK;AACzB,WAAO;AAAA,EACT;AAAA,EAEA,IAAI,SAAkB,OAA+B;AACnD,SAAK,OAAO,IAAI,QAAQ,IAAI,KAAK;AAAA,EACnC;AAAA,EAEA,OAAO,SAAwB;AAC7B,SAAK,OAAO,OAAO,QAAQ,EAAE;AAAA,EAC/B;AACF;;;ACvBA,SAAS,kBAA4D;AACrE,SAAS,sBAAAA,2BAAgD;;;ACDzD,SAAS,qBAAkC;AAoBpC,SAAS,gBAAgB,OAAkC;AAChE,QAAM,aAAuC,CAAC;AAC9C,MAAI,MAAM,4BAA4B,OAAW,YAAW,qBAAqB,MAAM;AACvF,MAAI,MAAM,4BAA4B,OAAW,YAAW,qBAAqB,MAAM;AACvF,MAAI,MAAM,+BAA+B,OAAW,YAAW,wBAAwB,MAAM;AAE7F,QAAM,YAA6B,EAAE,GAAG,MAAM,cAAc;AAC5D,MAAI,OAAO,KAAK,UAAU,EAAE,SAAS,GAAG;AACtC,cAAU,QAAQ,EAAE,GAAG,cAAc,MAAM,iBAAiB,EAAE,OAAO,GAAG,WAAW;AAAA,EACrF;AACA,SAAO,cAAc,MAAM,mBAAmB,SAAS;AACzD;;;AC9BA,SAAS,kBAAkB;AAE3B;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP,SAAS,yBAA4C;AACrD,SAAS,0BAA0B;;;ACG5B,SAAS,YAAY,SAA0B;AACpD,MAAI,OAAO,YAAY,SAAU,QAAO;AACxC,MAAI,CAAC,MAAM,QAAQ,OAAO,EAAG,QAAO;AACpC,QAAM,QAAkB,CAAC;AACzB,aAAW,SAAS,SAAS;AAC3B,QAAI,UAAU,QAAQ,OAAO,UAAU,SAAU;AACjD,UAAM,IAAI;AACV,QAAI,EAAE,SAAS,UAAU,OAAO,EAAE,SAAS,UAAU;AACnD,YAAM,KAAK,EAAE,IAAI;AAAA,IACnB,WAAW,MAAM,QAAQ,EAAE,OAAO,GAAG;AACnC,YAAM,KAAK,YAAY,EAAE,OAAO,CAAC;AAAA,IACnC;AAAA,EACF;AACA,SAAO,MAAM,KAAK,IAAI;AACxB;AASA,SAAS,YAAY,SAAmC;AACtD,MAAI,CAAC,MAAM,QAAQ,OAAO,EAAG,QAAO,CAAC;AACrC,SAAO,QAAQ,OAAO,CAAC,MAA2B,EAAwB,SAAS,WAAW;AAChG;AAEA,SAAS,cAAc,MAAuB;AAC5C,MAAI,CAAC,KAAM,QAAO;AAClB,MAAI,OAAO,SAAS,SAAU,QAAO;AACrC,MAAI;AACF,WAAO,KAAK,UAAU,IAAI;AAAA,EAC5B,QAAQ;AACN,WAAO,OAAO,IAAI;AAAA,EACpB;AACF;AASO,SAAS,aAAa,OAAoC;AAC/D,UAAQ,MAAM,MAAM;AAAA,IAClB,KAAK,gBAAgB;AACnB,YAAM,OAAO,YAAa,MAAM,KAA+B,OAAO;AACtE,aAAO,KAAK,SAAS,IAAI,CAAC,EAAE,IAAI,OAAO,MAAM,GAAG,GAAG,MAAM,QAAQ,aAAa,QAAQ,KAAK,CAAC,IAAI,CAAC;AAAA,IACnG;AAAA,IACA,KAAK,qBAAqB;AACxB,YAAM,UAAW,MAAM,KAA6C,SAAS;AAC7E,YAAM,QAAQ,YAAY,OAAO;AACjC,YAAM,OAAO,YAAY,OAAO;AAChC,UAAI,MAAM,WAAW,GAAG;AACtB,eAAO,KAAK,KAAK,EAAE,SAAS,IACxB,CAAC,EAAE,IAAI,OAAO,MAAM,GAAG,GAAG,MAAM,aAAa,aAAa,QAAQ,KAAK,CAAC,IACxE,CAAC;AAAA,MACP;AACA,UAAI,MAAM,WAAW,GAAG;AACtB,cAAM,OAAO,MAAM,CAAC;AACpB,cAAM,SAAS,cAAc,KAAK,SAAS;AAC3C,cAAM,OAAO,UAAU,OAAO,GAAG,IAAI;AAAA,EAAK,MAAM,KAAK,UAAU;AAC/D,eAAO,CAAC;AAAA,UACN,IAAI,OAAO,MAAM,GAAG;AAAA,UACpB,MAAM;AAAA,UACN,aAAa;AAAA,UACb,UAAU,KAAK,QAAQ;AAAA,UACvB,YAAY,KAAK,MAAM;AAAA,UACvB,MAAM;AAAA,QACR,CAAC;AAAA,MACH;AACA,aAAO,MAAM,IAAI,CAAC,UAAU;AAAA,QAC1B,IAAI,GAAG,MAAM,GAAG,IAAI,KAAK,MAAM,EAAE;AAAA,QACjC,MAAM;AAAA,QACN,aAAa;AAAA,QACb,UAAU,KAAK,QAAQ;AAAA,QACvB,YAAY,KAAK,MAAM;AAAA,QACvB,MAAM,cAAc,KAAK,SAAS,KAAK;AAAA,MACzC,EAAE;AAAA,IACJ;AAAA,IACA,KAAK,eAAe;AAClB,YAAM,UAAW,MAAM,KAEpB;AACH,YAAM,OAAO,YAAY,SAAS,OAAO;AACzC,UAAI,KAAK,WAAW,EAAG,QAAO,CAAC;AAC/B,aAAO,CAAC;AAAA,QACN,IAAI,OAAO,MAAM,GAAG;AAAA,QACpB,MAAM;AAAA,QACN,aAAa;AAAA,QACb,UAAU,SAAS,YAAY;AAAA,QAC/B,YAAY,SAAS,cAAc;AAAA,QACnC;AAAA,MACF,CAAC;AAAA,IACH;AAAA,IACA;AACE,aAAO,CAAC;AAAA,EACZ;AACF;AAGO,SAAS,qBAAqB,QAAgD;AACnF,QAAM,MAAqB,CAAC;AAC5B,aAAW,SAAS,OAAQ,KAAI,KAAK,GAAG,aAAa,KAAK,CAAC;AAC3D,SAAO;AACT;AAGO,SAAS,gBAAgB,SAAqE;AACnG,SAAO,QAAQ,QAAQ,MACpB,IAAI,CAAC,QAAQ,QAAQ,OAAO,GAAG,CAAC,EAChC,OAAO,CAAC,UAAiC,UAAU,MAAS;AACjE;AAGO,SAAS,iBAAiB,OAA6B;AAC5D,UAAQ,MAAM,MAAM;AAAA,IAClB,KAAK;AACH,aAAO,YAAa,MAAM,KAA+B,OAAO;AAAA,IAClE,KAAK;AACH,aAAO,YAAa,MAAM,KAA6C,SAAS,OAAO;AAAA,IACzF,KAAK;AACH,aAAO,YAAa,MAAM,KAA6C,SAAS,OAAO;AAAA,IACzF;AACE,aAAO;AAAA,EACX;AACF;;;ADpHO,SAAS,aAAa,QAAgD;AAC3E,MAAI,OAAsB;AAC1B,aAAW,SAAS,QAAQ;AAC1B,QAAI,MAAM,SAAS,aAAc,QAAO,MAAM,KAAK;AAAA,aAC1C,MAAM,SAAS,cAAc,MAAM,KAAK,SAAS,KAAM,QAAO;AAAA,EACzE;AACA,SAAO;AACT;AAGO,SAAS,yBAAyB,QAAuC;AAC9E,MAAI,SAAS;AACb,aAAW,SAAS,QAAQ;AAC1B,QAAI,MAAM,SAAS,mBAAoB,UAAS;AAAA,aACvC,MAAM,SAAS,iBAAkB,UAAS;AAAA,EACrD;AACA,MAAI,QAAQ;AACV,UAAM,IAAI,MAAM,4EAA4E;AAAA,EAC9F;AACF;AAYO,SAAS,oBACd,SACA,OACA,KACgC;AAChC,QAAM,QAAQ,QAAQ,QAAQ;AAC9B,QAAM,oBAAoB,MAAM,QAAQ,KAAK;AAC7C,QAAM,kBAAkB,MAAM,QAAQ,GAAG;AACzC,MAAI,oBAAoB,KAAK,kBAAkB,GAAG;AAChD,UAAM,IAAI,MAAM,4BAA4B,KAAK,KAAK,GAAG,6BAA6B;AAAA,EACxF;AACA,MAAI,oBAAoB,iBAAiB;AACvC,UAAM,IAAI,MAAM,uCAAuC,KAAK,KAAK,GAAG,EAAE;AAAA,EACxE;AACA,MAAI,WAAW;AACf,MAAI,SAAS;AAEb,SAAO,YAAY,UAAU,CAAC,0BAA0B,SAAS,MAAM,QAAQ,CAAE,GAAG;AAClF,gBAAY;AAAA,EACd;AACA,SAAO,UAAU,YAAY,CAAC,yBAAyB,SAAS,MAAM,MAAM,CAAE,GAAG;AAC/E,cAAU;AAAA,EACZ;AACA,MAAI,YAAY,QAAQ;AACtB,WAAO,EAAE,OAAO,MAAM,QAAQ,GAAI,KAAK,MAAM,MAAM,EAAG;AAAA,EACxD;AAGA,aAAW;AACX,WAAS;AACT,SAAO,WAAW,KAAK,CAAC,0BAA0B,SAAS,MAAM,QAAQ,CAAE,GAAG;AAC5E,gBAAY;AAAA,EACd;AACA,SAAO,SAAS,MAAM,SAAS,KAAK,CAAC,yBAAyB,SAAS,MAAM,MAAM,CAAE,GAAG;AACtF,cAAU;AAAA,EACZ;AACA,MAAI,0BAA0B,SAAS,MAAM,QAAQ,CAAE,KAAK,yBAAyB,SAAS,MAAM,MAAM,CAAE,GAAG;AAC7G,WAAO,EAAE,OAAO,MAAM,QAAQ,GAAI,KAAK,MAAM,MAAM,EAAG;AAAA,EACxD;AACA,QAAM,IAAI;AAAA,IACR,kEAAkE,KAAK,KAAK,GAAG;AAAA,EAEjF;AACF;AAGO,SAAS,eAAe,SAAkB,OAAe,KAAuB;AACrF,QAAM,QAAQ,QAAQ,QAAQ;AAC9B,QAAM,WAAW,MAAM,QAAQ,KAAK;AACpC,QAAM,SAAS,MAAM,QAAQ,GAAG;AAChC,SAAO,MAAM,MAAM,UAAU,SAAS,CAAC;AACzC;AAgBO,SAAS,yBACd,SACA,OAC0C;AAC1C,2BAAyB,QAAQ,MAAM;AACvC,QAAM,OAAO,aAAa,QAAQ,MAAM;AACxC,QAAM,eAAe,aAAa,WAAW,CAAC;AAC9C,QAAM,OAAiB,CAAC;AAExB,OAAK,KAAK,QAAQ,OAAO,oBAAoB,EAAE,cAAc,KAAK,CAAC,EAAE,GAAG;AACxE,OAAK,KAAK,QAAQ,OAAO,sBAAsB;AAAA,IAC7C;AAAA,IACA,SAAS,MAAM;AAAA,IACf,eAAe,EAAE,OAAO,MAAM,OAAO,KAAK,MAAM,IAAI;AAAA,IACpD,cAAc,CAAC,GAAG,MAAM,YAAY;AAAA,IACpC,oBAAoB,MAAM;AAAA,IAC1B,UAAU,MAAM;AAAA,IAChB,OAAO,MAAM;AAAA,EACf,CAAC,EAAE,GAAG;AAEN,QAAM,UAAU,kBAAkB;AAAA,IAChC,SAAS,MAAM;AAAA,IACf,QAAQ,wBAAwB,YAAY;AAAA,EAC9C,CAAC;AACD,OAAK,KAAK,QAAQ,OAAO,gBAAgB,SAAS;AAAA,IAChD,WAAW,EAAE,IAAI,WAAW,OAAO,MAAM,OAAO,KAAK,MAAM,IAAI;AAAA,IAC/D,iBAAiB,CAAC,GAAG,MAAM,YAAY;AAAA,EACzC,CAAC,EAAE,GAAG;AAEN,OAAK,KAAK,QAAQ,OAAO,kBAAkB,EAAE,cAAc,KAAK,CAAC,EAAE,GAAG;AACtE,SAAO,EAAE,cAAc,KAAK;AAC9B;AAGO,SAAS,mBAAmB,QAAwD;AACzF,QAAM,SAAgC,CAAC;AACvC,aAAW,SAAS,QAAQ;AAC1B,QAAI,MAAM,SAAS,qBAAsB;AACzC,UAAM,OAAO,MAAM;AAInB,QAAI,qBAAqB,KAAK;AAC9B,QAAI,uBAAuB,GAAG;AAC5B,2BAAqB;AACrB,iBAAW,OAAO,KAAK,cAAc;AACnC,cAAM,WAAW,OAAO,GAAG;AAC3B,YAAI,aAAa,OAAW,uBAAsB,mBAAmB,iBAAiB,QAAQ,CAAC;AAAA,MACjG;AAAA,IACF;AACA,WAAO,KAAK;AAAA,MACV,SAAS,KAAK;AAAA,MACd,SAAS,YAAY,KAAK,OAAO;AAAA,MACjC,cAAc,CAAC,GAAG,KAAK,YAAY;AAAA,MACnC;AAAA,MACA,OAAO,KAAK,cAAc;AAAA,MAC1B,KAAK,KAAK,cAAc;AAAA,IAC1B,CAAC;AAAA,EACH;AACA,SAAO;AACT;AAWA,SAAS,iBAAiB,OAA8B;AACtD,MAAI,MAAM,SAAS,eAAgB,QAAO;AAC1C,QAAM,SAAU,MAAM,KAA0C;AAChE,SAAO,QAAQ,WAAW;AAC5B;AAUO,SAAS,2BACd,SACA,OAAoC,CAAC,GACb;AACxB,QAAM,QAAQ,QAAQ,QAAQ;AAC9B,QAAM,WAAW,KAAK,kBAAkB;AACxC,QAAM,gBAAgB,oBAAI,IAAY;AACtC,aAAW,OAAO,MAAM,MAAM,CAAC,QAAQ,EAAG,eAAc,IAAI,GAAG;AAC/D,WAAS,QAAQ,MAAM,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG;AACzD,UAAM,QAAQ,QAAQ,OAAO,MAAM,KAAK,CAAE;AAC1C,QAAI,OAAO,SAAS,kBAAkB,CAAC,iBAAiB,KAAK,GAAG;AAC9D,oBAAc,IAAI,MAAM,KAAK,CAAE;AAC/B;AAAA,IACF;AAAA,EACF;AACA,QAAM,MAA8B,CAAC;AACrC,MAAI,MAAmC;AACvC,QAAM,QAAQ,MAAY;AACxB,QAAI,QAAQ,KAAM,KAAI,KAAK,GAAG;AAC9B,UAAM;AAAA,EACR;AACA,aAAW,OAAO,OAAO;AACvB,UAAM,QAAQ,QAAQ,OAAO,GAAG;AAChC,QAAI,UAAU,UAAa,cAAc,IAAI,GAAG,KAAK,iBAAiB,KAAK,GAAG;AAC5E,YAAM;AACN;AAAA,IACF;AACA,UAAM,SAAS,mBAAmB,iBAAiB,KAAK,CAAC;AACzD,QAAI,QAAQ,MAAM;AAChB,YAAM,EAAE,OAAO,KAAK,KAAK,KAAK,OAAO,GAAG,OAAO;AAAA,IACjD,OAAO;AACL,YAAM,EAAE,OAAO,IAAI,OAAO,KAAK,KAAK,OAAO,IAAI,QAAQ,GAAG,QAAQ,IAAI,SAAS,OAAO;AAAA,IACxF;AAAA,EACF;AACA,QAAM;AACN,QAAM,MAA8B,CAAC;AACrC,aAAW,SAAS,KAAK;AACvB,QAAI;AACF,YAAM,EAAE,OAAO,IAAI,IAAI,oBAAoB,SAAS,MAAM,OAAO,MAAM,GAAG;AAC1E,YAAM,QAAQ,MAAM;AACpB,UAAI,KAAK,EAAE,OAAO,KAAK,OAAO,QAAQ,MAAM,OAAO,CAAC;AAAA,IACtD,QAAQ;AAAA,IAER;AAAA,EACF;AACA,SAAO,IAAI,KAAK,CAAC,GAAG,MAAM,EAAE,SAAS,EAAE,MAAM;AAC/C;;;AFxOA,SAAS,aAGP;AACA,SAAO;AAAA,IACL,QAAQ;AAAA,MACN,MAAM;AAAA,MACN,YAAY,EAAE,MAAM,EAAE,MAAM,SAAS,EAAE;AAAA,MACvC,sBAAsB;AAAA,IACxB;AAAA,IACA,QAAQ,CAAC,OAAO,UAAU,CAAC,EAAE,MAAM,QAAQ,MAAM,MAAM,KAAK,CAAC;AAAA,EAC/D;AACF;AAEA,SAAS,aAAa,MAA6B;AACjD,MAAI,KAAK,UAAU,QAAW;AAC5B,UAAM,IAAI,MAAM,+DAA+D;AAAA,EACjF;AACA,SAAO,KAAK;AACd;AAEA,IAAM,qBAAqB;AAAA,EACzB,OAAO,EAAE,MAAM,UAAmB,aAAa,gDAAgD;AAAA,EAC/F,SAAS;AAAA,IACP,MAAM;AAAA,IACN,UAAU;AAAA,IACV,aAAa;AAAA,IACb,OAAO;AAAA,MACL,MAAM;AAAA,MACN,YAAY;AAAA,QACV,UAAU;AAAA,UACR,OAAO;AAAA,YACL,EAAE,MAAM,WAAoB,aAAa,kCAAkC;AAAA,YAC3E,EAAE,MAAM,UAAmB,aAAa,uDAAuD;AAAA,UACjG;AAAA,QACF;AAAA,QACA,QAAQ;AAAA,UACN,OAAO;AAAA,YACL,EAAE,MAAM,WAAoB,aAAa,2CAA2C;AAAA,YACpF,EAAE,MAAM,UAAmB,aAAa,uDAAuD;AAAA,UACjG;AAAA,QACF;AAAA,QACA,SAAS,EAAE,MAAM,UAAmB,aAAa,iHAAiH;AAAA,QAClK,OAAO,EAAE,MAAM,UAAmB,aAAa,0CAA0C;AAAA,MAC3F;AAAA,MACA,sBAAsB;AAAA,IACxB;AAAA,EACF;AACF;AAGA,SAAS,SAAS,OAAgC;AAChD,QAAM,OAAO,OAAO,KAAK,EAAE,MAAM,GAAG,EAAE,CAAC,EAAG,KAAK;AAC/C,QAAM,MAAM,OAAO,IAAI;AACvB,MAAI,CAAC,OAAO,UAAU,GAAG,KAAK,MAAM,GAAG;AACrC,UAAM,IAAI,MAAM,qCAAqC,OAAO,KAAK,CAAC,qCAAgC;AAAA,EACpG;AACA,SAAO;AACT;AAQA,eAAe,eAAe,KAAsB,MAAoB,MAA2C;AACjH,QAAM,QAAQ,aAAa,IAAI;AAC/B,QAAM,UAAU,MAAM;AACtB,QAAM,QAAQ,IAAI,MAAM,SAAS,OAAO;AACxC,QAAM,eAAe,qBAAqB,gBAAgB,OAAO,CAAC;AAClE,QAAM,aAAa,aAAa,OAAO,CAAC,KAAK,YAAY,MAAMC,oBAAmB,QAAQ,QAAQ,EAAE,GAAG,CAAC;AACxG,QAAM,SAAS,gBAAgB,GAAG;AAGlC,QAAM,OAAO,IAAI,OAAO,YAAY,EAAE,UAAU,cAAc,OAAO,QAAQ,WAAW,CAAC;AACzF,MAAI,MAAM,IAAI,SAAS,KAAK,KAAK;AACjC,QAAM,QAAQ,KAAK,MAAM,YAAY;AAErC,QAAM,SAAS,KAAK,QAAQ,IAAI,CAAC,UAAU;AACzC,UAAM,WAAW,SAAS,MAAM,QAAQ;AACxC,UAAM,SAAS,SAAS,MAAM,MAAM;AACpC,UAAM,WAAW,MAAM,OAAO,QAAQ,CAAC;AACvC,UAAM,SAAS,MAAM,OAAO,MAAM,CAAC;AACnC,QAAI,aAAa,UAAa,WAAW,QAAW;AAClD,YAAM,IAAI;AAAA,QACR,4BAA4B,QAAQ,KAAK,MAAM;AAAA,MAEjD;AAAA,IACF;AACA,WAAO;AAAA,MACL;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA,SAAS,MAAM;AAAA,MACf,IAAI,MAAM,SAAS,KAAK,WAAW,SAAY,CAAC,IAAI,EAAE,OAAO,MAAM,SAAS,KAAK,MAAM;AAAA,IACzF;AAAA,EACF,CAAC;AAED,QAAM,UAAU,IAAI,OAAO,iBAAiB;AAAA,IAC1C,QAAQ,OAAO,IAAI,CAAC,EAAE,UAAU,QAAQ,SAAS,MAAM,OAAO,EAAE,UAAU,QAAQ,SAAS,MAAM,EAAE;AAAA,IACnG,UAAU;AAAA,IACV,OAAO,KAAK;AAAA,IACZ;AAAA,EACF,CAAC;AACD,MAAI,QAAQ,OAAO,OAAO,SAAS,GAAG;AACpC,WAAO,EAAE,MAAM,oBAAoB,QAAQ,OAAO,OAAO,KAAK,IAAI,CAAC,GAAG;AAAA,EACxE;AACA,MAAI,MAAM,IAAI,SAAS,QAAQ,KAAK;AAEpC,QAAM,QAAkB,CAAC;AACzB,WAAS,QAAQ,GAAG,QAAQ,OAAO,QAAQ,SAAS,GAAG;AACrD,UAAM,QAAQ,OAAO,KAAK;AAC1B,UAAM,WAAW,KAAK,QAAQ,KAAK;AAGnC,UAAM,EAAE,OAAO,IAAI,IAAI,oBAAoB,SAAS,MAAM,UAAU,MAAM,MAAM;AAChF,UAAM,WAAW,eAAe,SAAS,OAAO,GAAG;AAInD,QAAI,iBAAiB;AACrB,eAAW,OAAO,UAAU;AAC1B,YAAM,QAAQ,QAAQ,OAAO,GAAG;AAChC,UAAI,UAAU,OAAW,mBAAkBA,oBAAmB,iBAAiB,KAAK,CAAC;AAAA,IACvF;AACA,UAAM,EAAE,aAAa,IAAI,yBAAyB,SAAS;AAAA,MACzD;AAAA,MACA;AAAA,MACA,cAAc;AAAA,MACd,SAAS,CAAC,EAAE,MAAM,QAAQ,MAAM,SAAS,QAAQ,CAAC;AAAA,MAClD,oBAAoB;AAAA,MACpB,UAAU,MAAM,QAAQ,YAAY;AAAA,MACpC,OAAO,MAAM,QAAQ,SAAS;AAAA,IAChC,CAAC;AACD,UAAM,WAAW,UAAU,MAAM,YAAY,QAAQ,MAAM;AAC3D,UAAM;AAAA,MACJ,WAAW,aAAa,MAAM,GAAG,CAAC,CAAC,UAAU,KAAK,KAAK,GAAG,KAAK,SAAS,MAAM,wBAC3E,WAAW,mBAAmB,MAAM,QAAQ,KAAK,MAAM,MAAM,wBAAwB;AAAA,IAC1F;AAAA,EACF;AAEA,SAAO;AAAA,IACL,MAAM,cAAc,QAAQ,OAAO,aAAa,eAAe,QAAQ,OAAO,gBAAgB;AAAA,EAAuB,MAAM,KAAK,IAAI,CAAC;AAAA,EACvI;AACF;AAEA,IAAM,uBAAuB;AAAA,EAC3B,SAAS,EAAE,MAAM,UAAmB,UAAU,MAAM,aAAa,kEAAkE;AACrI;AAMA,SAAS,iBAAiB,MAAuB,MAAsB,MAAkC;AACvG,QAAM,UAAU,aAAa,IAAI,EAAE;AACnC,QAAM,SAAS,mBAAmB,QAAQ,MAAM;AAChD,QAAM,QAAQ,OAAO,KAAK,CAAC,UAAU,MAAM,QAAQ,WAAW,KAAK,OAAO,CAAC;AAC3E,MAAI,UAAU,QAAW;AACvB,WAAO,EAAE,MAAM,sBAAsB,KAAK,OAAO,kDAAkD;AAAA,EACrG;AACA,QAAM,QAAkB,CAAC;AACzB,aAAW,OAAO,MAAM,cAAc;AACpC,UAAM,QAAQ,QAAQ,OAAO,GAAG;AAChC,UAAM,OAAO,UAAU,SAAY,KAAK,iBAAiB,KAAK;AAC9D,QAAI,KAAK,SAAS,EAAG,OAAM,KAAK,QAAQ,GAAG,KAAK,IAAI,EAAE;AAAA,EACxD;AACA,SAAO;AAAA,IACL,MAAM,SAAS,MAAM,OAAO,WAAM,MAAM,OAAO;AAAA;AAAA,EAAO,MAAM,KAAK,MAAM,KAAK,0BAA0B;AAAA,EACxG;AACF;AAEA,IAAM,mBAAmB;AAAA,EACvB,OAAO,EAAE,MAAM,UAAmB,UAAU,MAAM,aAAa,iDAAiD;AAAA,EAChH,OAAO,EAAE,MAAM,WAAoB,aAAa,+BAA+B;AACjF;AAOA,SAAS,aAAa,MAAuB,MAAkB,MAAkC;AAC/F,QAAM,UAAU,aAAa,IAAI,EAAE;AACnC,QAAM,SAAS,mBAAmB,QAAQ,MAAM;AAChD,QAAM,QAAQ,KAAK,MAAM,YAAY,EAAE,MAAM,KAAK,EAAE,OAAO,OAAO;AAClE,QAAM,SAAqE,CAAC;AAC5E,aAAW,SAAS,QAAQ;AAC1B,UAAM,WAAW,MAAM,aACpB,IAAI,CAAC,QAAQ,iBAAiB,QAAQ,OAAO,GAAG,CAAE,CAAC,EACnD,KAAK,IAAI;AACZ,UAAM,WAAW,GAAG,MAAM,OAAO;AAAA,EAAK,QAAQ,GAAG,YAAY;AAC7D,QAAI,QAAQ;AACZ,eAAW,QAAQ,MAAO,UAAS,SAAS,MAAM,IAAI,EAAE,SAAS;AACjE,QAAI,QAAQ,EAAG,QAAO,KAAK,EAAE,SAAS,MAAM,SAAS,OAAO,SAAS,MAAM,QAAQ,CAAC;AAAA,EACtF;AACA,SAAO,KAAK,CAAC,GAAG,MAAM,EAAE,QAAQ,EAAE,KAAK;AACvC,QAAM,MAAM,OAAO,MAAM,GAAG,KAAK,SAAS,CAAC;AAC3C,MAAI,IAAI,WAAW,EAAG,QAAO,EAAE,MAAM,mCAAmC,KAAK,KAAK,IAAI;AACtF,SAAO;AAAA,IACL,MAAM,gBAAgB,KAAK,KAAK;AAAA,IAC5B,IAAI,IAAI,CAAC,QAAQ,OAAO,IAAI,OAAO,WAAW,IAAI,KAAK,MAAM,IAAI,QAAQ,MAAM,GAAG,GAAG,CAAC,EAAE,EAAE,KAAK,IAAI,IACnG;AAAA,EACN;AACF;AAEA,IAAM,mBAAmB,CAAC;AAM1B,SAAS,aAAa,KAAsB,OAAmB,MAAkC;AAC/F,QAAM,UAAU,aAAa,IAAI,EAAE;AACnC,QAAM,SAAS,mBAAmB,QAAQ,MAAM;AAChD,QAAM,cAAc,OAAO,OAAO,CAAC,KAAK,UAAU,MAAM,MAAM,oBAAoB,CAAC;AACnF,QAAM,eAAe,qBAAqB,gBAAgB,OAAO,CAAC;AAClE,QAAM,YAAY,aAAa,OAAO,CAAC,KAAK,YAAY,MAAMA,oBAAmB,QAAQ,QAAQ,EAAE,GAAG,CAAC;AACvG,QAAM,QAAQ,IAAI;AAClB,QAAM,QAAQ;AAAA,IACZ,6BAAwB,QAAQ,EAAE;AAAA,IAClC,aAAa,OAAO,MAAM;AAAA,IAC1B,wBAAwB,WAAW;AAAA,IACnC,wBAAwB,SAAS,MAAM,KAAK,KAAK,KAAK,MAAO,YAAY,QAAS,GAAG,CAAC;AAAA,EACxF;AACA,aAAW,SAAS,OAAO,MAAM,GAAG,EAAE,GAAG;AACvC,UAAM,KAAK,OAAO,MAAM,QAAQ,MAAM,GAAG,CAAC,CAAC,UAAU,MAAM,KAAK,KAAK,MAAM,GAAG,KAAK,MAAM,aAAa,MAAM,iBAAY,MAAM,QAAQ,MAAM,GAAG,EAAE,CAAC,EAAE;AAAA,EACtJ;AACA,SAAO,EAAE,MAAM,MAAM,KAAK,IAAI,EAAE;AAClC;AAGO,SAAS,UAAU,KAAwC;AAChE,SAAO;AAAA,IACL,WAAW;AAAA,MACT,MAAM;AAAA,MACN,aACE;AAAA,MAGF,YAAY;AAAA,MACZ,QAAQ,WAAW;AAAA,MACnB,MAAM,QAAQ,MAAM,MAAM;AACxB,eAAO,eAAe,KAAK,MAAsB,IAAI;AAAA,MACvD;AAAA,IACF,CAAC;AAAA,IACD,WAAW;AAAA,MACT,MAAM;AAAA,MACN,aAAa;AAAA,MACb,YAAY;AAAA,MACZ,QAAQ,WAAW;AAAA,MACnB,QAAQ,MAAM,MAAM;AAClB,eAAO,QAAQ,QAAQ,iBAAiB,KAAK,MAAwB,IAAI,CAAC;AAAA,MAC5E;AAAA,IACF,CAAC;AAAA,IACD,WAAW;AAAA,MACT,MAAM;AAAA,MACN,aAAa;AAAA,MACb,YAAY;AAAA,MACZ,QAAQ,WAAW;AAAA,MACnB,QAAQ,MAAM,MAAM;AAClB,eAAO,QAAQ,QAAQ,aAAa,KAAK,MAAoB,IAAI,CAAC;AAAA,MACpE;AAAA,IACF,CAAC;AAAA,IACD,WAAW;AAAA,MACT,MAAM;AAAA,MACN,aAAa;AAAA,MACb,YAAY;AAAA,MACZ,QAAQ,WAAW;AAAA,MACnB,QAAQ,MAAM,MAAM;AAClB,eAAO,QAAQ,QAAQ,aAAa,KAAK,MAAoB,IAAI,CAAC;AAAA,MACpE;AAAA,IACF,CAAC;AAAA,EACH;AACF;;;AItSA,SAAwB,sBAAAC,2BAA0B;AAElD,SAAS,WAAW,KAAsB,OAAsB;AAC9D,QAAM,UAAU,MAAM;AACtB,QAAM,SAAS,mBAAmB,QAAQ,MAAM;AAChD,QAAM,cAAc,OAAO,OAAO,CAAC,KAAK,UAAU,MAAM,MAAM,oBAAoB,CAAC;AACnF,QAAM,eAAe,qBAAqB,gBAAgB,OAAO,CAAC;AAClE,QAAM,YAAY,aAAa,OAAO,CAAC,KAAK,YAAY,MAAMA,oBAAmB,QAAQ,QAAQ,EAAE,GAAG,CAAC;AACvG,QAAM,QAAQ,IAAI;AAClB,QAAM,QAAQ;AAAA,IACZ,6BAAwB,QAAQ,EAAE;AAAA,IAClC,aAAa,OAAO,MAAM;AAAA,IAC1B,wBAAwB,WAAW;AAAA,IACnC,wBAAwB,SAAS,MAAM,KAAK,KAAK,KAAK,MAAO,YAAY,QAAS,GAAG,CAAC;AAAA,EACxF;AACA,aAAW,SAAS,OAAO,MAAM,GAAG,EAAE,GAAG;AACvC,UAAM,KAAK,OAAO,MAAM,QAAQ,MAAM,GAAG,CAAC,CAAC,UAAU,MAAM,KAAK,KAAK,MAAM,GAAG,WAAM,MAAM,QAAQ,MAAM,GAAG,EAAE,CAAC,EAAE;AAAA,EAClH;AACA,SAAO,MAAM,KAAK,IAAI;AACxB;AAEA,SAAS,aAAa,KAAsB,OAAc,MAAwB;AAChF,MAAI,KAAK,SAAS,GAAG;AACnB,WAAO;AAAA,EACT;AACA,QAAM,WAAW,OAAO,KAAK,CAAC,CAAC;AAC/B,QAAM,SAAS,OAAO,KAAK,CAAC,CAAC;AAC7B,QAAM,UAAU,KAAK,MAAM,CAAC,EAAE,KAAK,GAAG;AACtC,MAAI,CAAC,OAAO,UAAU,QAAQ,KAAK,CAAC,OAAO,UAAU,MAAM,GAAG;AAC5D,WAAO;AAAA,EACT;AACA,QAAM,UAAU,MAAM;AACtB,QAAM,EAAE,OAAO,IAAI,IAAI,oBAAoB,SAAS,UAAU,MAAM;AACpE,QAAM,WAAW,eAAe,SAAS,UAAU,MAAM;AACzD,MAAI,iBAAiB;AACrB,aAAW,OAAO,UAAU;AAC1B,UAAM,QAAQ,QAAQ,OAAO,GAAG;AAChC,QAAI,UAAU,OAAW,mBAAkBA,oBAAmB,iBAAiB,KAAK,CAAC;AAAA,EACvF;AACA,QAAM,EAAE,aAAa,IAAI,yBAAyB,SAAS;AAAA,IACzD;AAAA,IACA;AAAA,IACA,cAAc;AAAA,IACd,SAAS,CAAC,EAAE,MAAM,QAAQ,MAAM,QAAQ,CAAC;AAAA,IACzC,oBAAoB;AAAA,IACpB,UAAU,MAAM,QAAQ,YAAY;AAAA,IACpC,OAAO,MAAM,QAAQ,SAAS;AAAA,EAChC,CAAC;AACD,SAAO,mBAAmB,KAAK,KAAK,GAAG,KAAK,SAAS,MAAM,uBAAuB,aAAa,MAAM,GAAG,CAAC,CAAC;AAC5G;AAEA,SAAS,eAAe,MAAuB,OAAc,MAAwB;AACnF,MAAI,KAAK,SAAS,EAAG,QAAO;AAC5B,QAAM,UAAU,MAAM;AACtB,QAAM,SAAS,mBAAmB,QAAQ,MAAM;AAChD,QAAM,QAAQ,OAAO,KAAK,CAAC,UAAU,MAAM,QAAQ,WAAW,KAAK,CAAC,CAAE,CAAC;AACvE,MAAI,UAAU,OAAW,QAAO,UAAU,KAAK,CAAC,CAAC;AACjD,QAAM,QAAQ,MAAM,aACjB,IAAI,CAAC,QAAQ,iBAAiB,QAAQ,OAAO,GAAG,CAAE,CAAC,EACnD,OAAO,CAAC,SAAS,KAAK,SAAS,CAAC;AACnC,SAAO,SAAS,MAAM,OAAO,WAAM,MAAM,OAAO;AAAA;AAAA,EAAO,MAAM,KAAK,MAAM,KAAK,0BAA0B;AACzG;AAGO,SAAS,WAAW,KAAyC;AAClE,SAAO;AAAA,IACL,MAAM;AAAA,IACN,aACE;AAAA,IAEF,SAAS,OAAO,eAAe;AAC7B,YAAM,MAAM,WAAW,SAAS,KAAK;AACrC,UAAI,QAAQ,MAAM,QAAQ,UAAU;AAClC,eAAO,EAAE,MAAM,WAAW,MAAM,WAAW,KAAK,WAAW,KAAK,EAAE;AAAA,MACpE;AACA,UAAI,IAAI,WAAW,UAAU,GAAG;AAC9B,eAAO,EAAE,MAAM,WAAW,MAAM,aAAa,KAAK,WAAW,OAAO,IAAI,MAAM,WAAW,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,CAAE,EAAE;AAAA,MACzH;AACA,UAAI,IAAI,WAAW,YAAY,GAAG;AAChC,eAAO,EAAE,MAAM,WAAW,MAAM,eAAe,KAAK,WAAW,OAAO,IAAI,MAAM,aAAa,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,CAAC,EAAE;AAAA,MAC5H;AACA,aAAO,EAAE,MAAM,SAAS,MAAM,4BAA4B,IAAI,MAAM,KAAK,EAAE,CAAC,CAAC,8CAAyC;AAAA,IACxH;AAAA,EACF;AACF;;;AC5FA;AAAA,EACE,sBAAAC;AAAA,OAIK;AACP,SAAS,qBAAAC,0BAA2C;AAuB7C,SAAS,WAAW,SAA6D;AACtF,QAAM,SAAS,2BAA2B,OAAO,EAAE,MAAM,GAAG,CAAC;AAC7D,MAAI,OAAO,WAAW,EAAG,QAAO;AAChC,QAAM,QAAQ,OAAO,IAAI,CAAC,UAAU,WAAW,MAAM,KAAK,KAAK,MAAM,GAAG,WAAM,MAAM,KAAK,eAAe,MAAM,MAAM,SAAS;AAC7H,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA,GAAG;AAAA,IACH;AAAA,EACF,EAAE,KAAK,IAAI;AACb;AAUA,SAAS,mBAAmB,OAAc,cAAqC;AAC7E,QAAM,QAAQ,MAAM,KAAK,MAAM,YAAY;AAG3C,QAAM,UAAU,OAAO,UAAU,MAAM,OAAO,GAAG;AACjD,MAAI,OAAO,YAAY,YAAY,UAAU,EAAG,QAAO;AACvD,SAAO,aAAa,OAAO,CAAC,KAAK,YAAY,MAAMC,oBAAmB,QAAQ,QAAQ,EAAE,GAAG,CAAC;AAC9F;AASO,SAAS,WACd,OACA,KACA,eACqB;AACrB,QAAM,UAAU,MAAM;AACtB,QAAM,QAAQ,IAAI,MAAM,SAAS,OAAO;AACxC,QAAM,eAAe,qBAAqB,gBAAgB,OAAO,CAAC;AAClE,QAAM,aAAa,mBAAmB,OAAO,YAAY;AACzD,QAAM,SAAS,gBAAgB,GAAG;AAClC,QAAM,OAAO,IAAI,OAAO,YAAY,EAAE,UAAU,cAAc,OAAO,QAAQ,WAAW,CAAC;AACzF,MAAI,MAAM,IAAI,SAAS,KAAK,KAAK;AAEjC,QAAM,QAAQ,KAAK;AACnB,MAAI,UAAU,UAAa,CAAC,MAAM,aAAc,QAAO;AACvD,QAAM,YAAY,MAAM,WAAW,sBAAsB;AAEzD,QAAM,aAAa,aAAa,QAAQ,MAAM,KAAK;AACnD,QAAM,eAAe,CAAC,aAAa,cAAc,IAAI,QAAQ,EAAE,MAAM;AACrE,MAAI,aAAc,QAAO;AACzB,gBAAc,IAAI,QAAQ,IAAI,UAAU;AAExC,QAAM,OAAO,eAAe,OAAO,WAAW,OAAO;AACrD,QAAM,UAAUC,mBAAkB;AAAA,IAChC,SAAS,CAAC,EAAE,MAAM,QAAQ,KAAK,CAAC;AAAA,IAChC,QAAQ,EAAE,MAAM,UAAU,QAAQ,YAAY;AAAA,EAChD,CAAC;AACD,SAAO,EAAE,SAAS,UAAU;AAC9B;AAOA,SAAS,eACP,OACA,WACA,SACQ;AAGR,QAAM,MAAM,KAAK,MAAM,KAAK,IAAI,MAAM,cAAc,CAAC,IAAI,GAAG;AAC5D,QAAM,QAAQ,YACV,oCAA0B,GAAG,uJAC7B,uBAAuB,GAAG;AAC9B,QAAM,WAAW;AACjB,SAAO,CAAC,OAAO,IAAI,UAAU,WAAW,OAAO,CAAC,EAAE,KAAK,IAAI;AAC7D;;;AChHA,SAAS,2BAA2B;AAE7B,IAAM,oBAAoB;AAAA;AAAA;AAAA;AAAA,EAI/B,mBAAmB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAWd,IAAM,0BAA0B;;;ARwDvC,IAAM,iBAA4B;AAAA,EAChC,mBAAmB;AAAA,EACnB,WAAW;AAAA,EACX,aAAa;AAAA,EACb,WAAW;AACb;AAEO,SAAS,iBAAiB,SAA6B,CAAC,GAAc;AAC3E,SAAO,EAAE,GAAG,gBAAgB,GAAG,OAAO;AACxC;AAOO,IAAM,sBAAN,cAAkC,iBAAiB;AAAA;AAAA,EAE/C;AAAA;AAAA,EAEA;AAAA;AAAA,EAEA;AAAA,EAEQ,gBAAgB,oBAAI,IAAoB;AAAA,EAEzD,YAAY,KAAc,SAA6B,CAAC,GAAG;AACzD,UAAM,GAAG;AACT,SAAK,SAAS,iBAAiB,MAAM;AACrC,SAAK,SAAS,WAAW,CAAC,CAAC;AAC3B,SAAK,QAAQ,IAAI,cAAc;AAE/B,UAAM,MAAuB;AAAA,MAC3B,QAAQ,KAAK;AAAA,MACb,OAAO,KAAK;AAAA,MACZ,mBAAmB,KAAK,OAAO;AAAA,MAC/B,yBAAyB,KAAK,OAAO;AAAA,MACrC,yBAAyB,KAAK,OAAO;AAAA,MACrC,4BAA4B,KAAK,OAAO;AAAA,MACxC,eAAe,KAAK,OAAO;AAAA,IAC7B;AAEA,QAAI,KAAK,OAAO,WAAW;AACzB,YAAM,QAAQ,IAAI,IAAI,OAAO;AAC7B,UAAI,UAAU,QAAW;AACvB,mBAAW,QAAQ,UAAU,GAAG,EAAG,OAAM,SAAS,IAAI;AAAA,MACxD;AAAA,IACF;AACA,QAAI,KAAK,OAAO,aAAa;AAC3B,YAAM,WAAW,IAAI,IAAI,UAAU;AACnC,UAAI,aAAa,OAAW,UAAS,SAAS,WAAW,GAAG,CAAC;AAAA,IAC/D;AACA,QAAI,KAAK,OAAO,WAAW;AACzB,UAAI,GAAG,kBAAkB,OAAO,SAAS,SAAS;AAChD,cAAM,WAAW,MAAM,KAAK;AAC5B,YAAI,SAAS,SAAS,SAAU,QAAO;AACvC,cAAM,UAAU,WAAW,QAAQ,OAAO,KAAK,KAAK,aAAa;AACjE,YAAI,YAAY,KAAM,QAAO;AAC7B,eAAO,EAAE,MAAM,SAAS,UAAU,CAAC,GAAG,SAAS,UAAU,QAAQ,OAAO,EAAE;AAAA,MAC5E,CAAC;AAAA,IACH;AAGA,UAAM,eAAe,IAAI,IAAI,cAAc;AAC3C,QAAI,iBAAiB,QAAW;AAC9B,mBAAa,QAAQ;AAAA,QACnB,MAAM;AAAA,QACN,OAAO;AAAA,QACP,MAAM;AAAA,MACR,CAAC;AAAA,IACH;AAAA,EACF;AAAA;AAAA,EAGA,MAAe,gBACb,QACA,UACA,QACkC;AAClC,WAAO,eAAe;AACtB,WAAO;AAAA,EACT;AAAA;AAAA,EAGA,MAAe,WACb,QACA,QACkC;AAClC,WAAO,eAAe;AACtB,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAe,cACb,QACA,MACA,QACA,QAC2B;AAC3B,YAAQ,eAAe;AACvB,UAAM,IAAI;AAAA,MACR;AAAA,MACA;AAAA,IACF;AAAA,EACF;AACF;AAEA,IAAO,gBAAQ;","names":["defaultCountTokens","defaultCountTokens","defaultCountTokens","defaultCountTokens","createUserMessage","defaultCountTokens","createUserMessage"]}
+{"version":3,"sources":["../src/index.ts","../src/state.ts","../src/tools.ts","../src/config.ts","../src/region.ts","../src/messages.ts","../src/commands.ts","../src/nudge.ts","../src/system-prompt.ts"],"sourcesContent":["/**\n * billion-context-dsh — Active Context Pruning (ACP) for the DeepSeek Harness,\n * delivered as a `CompactionEngine` backend.\n *\n * The model decides when and what to compress (pure ACP semantics):\n *  - the `compress` tool durably shadows a surface range with the model-written\n *    summary (no second LLM summarization call — the ACP cost win);\n *  - the original events stay in the append-only session log, so `decompress`,\n *    `search_context`, and replay always work;\n *  - refs are surface seqs carried by the injected nudge's range table (DSH\n *    has no in-memory message rewrite hook — see docs/dsh-porting-verification.md);\n *  - automatic policy never summarizes by itself: it nudges the model.\n *\n * Mount it wherever a compaction backend is expected:\n *\n * ```yaml\n * - id: compaction-billion-context\n *   name: 'billion-context-dsh'\n *   config:\n *     modelContextLimit: 128000\n * ```\n *\n * The package registers `ctx.compaction` plus the four model tools and the\n * `/acp` command when the hosting composition provides `ctx.tools` /\n * `ctx.commands`.\n * @module billion-context-dsh\n */\n\nimport type { Context } from '@deepseek-ai/cordis'\nimport {\n  CompactionEngine,\n  ManualCompactionError,\n  type CompactionAgentContext,\n  type CompactionResult,\n  type CompactionTrigger,\n  type ManualCompactAgentContext,\n} from '@deepseek-ai/dsh-compaction'\nimport { createCore, type CompressionCore } from 'acp-kernel'\nimport type {} from '@deepseek-ai/dsh-agent'\nimport { AcpStateStore } from './state.ts'\nimport { makeTools, type ToolEnvironment } from './tools.ts'\nimport { acpCommand } from './commands.ts'\nimport { buildNudge } from './nudge.ts'\nimport { ACP_SYSTEM_PROMPT, ACP_SYSTEM_PROMPT_ORDER } from './system-prompt.ts'\n\nexport { AcpStateStore } from './state.ts'\nexport { kernelConfigFor, type KernelConfigInput } from './config.ts'\nexport { ACP_SYSTEM_PROMPT, ACP_SYSTEM_PROMPT_ORDER } from './system-prompt.ts'\nexport { makeTools, type ToolEnvironment } from './tools.ts'\nexport { acpCommand } from './commands.ts'\nexport { buildNudge, type NudgeEnvironment, type NudgeOutcome } from './nudge.ts'\nexport {\n  rebuildBlockLedger,\n  resolveSurfaceRange,\n  runCompactionTransaction,\n  shadowedSeqsOf,\n  findOpenTurn,\n  assertNoActiveCompaction,\n  type AcpBlockLedgerEntry,\n  type CompactionTransactionInput,\n} from './region.ts'\nexport { eventsToCoreMessages, projectEvent, surfaceEventsOf, extractEventText } from './messages.ts'\n\nexport interface AcpConfig {\n  /** The context window used for pressure decisions. Default 128000. */\n  readonly modelContextLimit: number\n  /** Nudge window lower bound (usage fraction). Kernel default 0.45 — same as billion-context-pi. */\n  readonly nudgeMinContextLimitPct?: number\n  /** Nudge window upper bound (over-limit). Kernel default 0.75 — same as billion-context-pi. */\n  readonly nudgeMaxContextLimitPct?: number\n  /** Emergency nudge threshold (bypasses per-turn dedup). Kernel default 0.95 — same as billion-context-pi. */\n  readonly nudgeEmergencyThresholdPct?: number\n  /** Any other acp-kernel Config override (billion-context-pi's `coreOverrides` escape hatch). */\n  readonly coreOverrides?: Partial<import('acp-kernel').Config>\n  /** Register the four model tools on `ctx.tools`. Default true. */\n  readonly autoTools: boolean\n  /** Register the `/acp` command on `ctx.commands`. Default true. */\n  readonly autoCommand: boolean\n  /** Inject the nudge into `agent/pre-step` when the kernel recommends it. Default true. */\n  readonly autoNudge: boolean\n}\n\nconst DEFAULT_CONFIG: AcpConfig = {\n  modelContextLimit: 128000,\n  autoTools: true,\n  autoCommand: true,\n  autoNudge: true,\n}\n\nexport function resolveAcpConfig(config: Partial<AcpConfig> = {}): AcpConfig {\n  return { ...DEFAULT_CONFIG, ...config }\n}\n\n/**\n * The ACP compaction backend. Subclasses the seam exactly like\n * `dsh-compaction-basic`; swaps summarization-driven compaction for\n * model-driven block compression without touching the agent loop.\n */\nexport class AcpCompactionEngine extends CompactionEngine {\n  /** The framework-agnostic ACP compression core, reused verbatim. */\n  readonly kernel: CompressionCore\n  /** Per-session kernel state. */\n  readonly store: AcpStateStore\n  /** Resolved engine configuration. */\n  readonly config: AcpConfig\n\n  private readonly lastNudgeTurn = new Map<string, number>()\n\n  constructor(ctx: Context, config: Partial<AcpConfig> = {}) {\n    super(ctx)\n    this.config = resolveAcpConfig(config)\n    this.kernel = createCore({})\n    this.store = new AcpStateStore()\n\n    const env: ToolEnvironment = {\n      kernel: this.kernel,\n      store: this.store,\n      modelContextLimit: this.config.modelContextLimit,\n      nudgeMinContextLimitPct: this.config.nudgeMinContextLimitPct,\n      nudgeMaxContextLimitPct: this.config.nudgeMaxContextLimitPct,\n      nudgeEmergencyThresholdPct: this.config.nudgeEmergencyThresholdPct,\n      coreOverrides: this.config.coreOverrides,\n    }\n\n    if (this.config.autoTools) {\n      const tools = ctx.get('tools')\n      if (tools !== undefined) {\n        for (const tool of makeTools(env)) tools.register(tool)\n      }\n    }\n    if (this.config.autoCommand) {\n      const commands = ctx.get('commands')\n      if (commands !== undefined) commands.register(acpCommand(env))\n    }\n    if (this.config.autoNudge) {\n      ctx.on('agent/pre-step', async (payload, next) => {\n        const decision = await next()\n        if (decision.kind === 'reject') return decision\n        const outcome = buildNudge(payload.agent, env, this.lastNudgeTurn)\n        if (outcome === null) return decision\n        return { kind: 'enter', messages: [...decision.messages, outcome.message] }\n      })\n    }\n    // The load-bearing ACP guidance lives in the system prompt ONCE; nudges\n    // stay short and advisory (model-driven: the model decides).\n    const systemPrompt = ctx.get('systemPrompt')\n    if (systemPrompt !== undefined) {\n      systemPrompt.section({\n        name: 'billion-context-dsh',\n        order: ACP_SYSTEM_PROMPT_ORDER,\n        text: ACP_SYSTEM_PROMPT,\n      })\n    }\n  }\n\n  /** ACP is model-driven: automatic pressure policy never summarizes by itself. */\n  override async compactIfNeeded(\n    _agent: CompactionAgentContext,\n    _trigger: CompactionTrigger,\n    signal: AbortSignal,\n  ): Promise<CompactionResult | null> {\n    signal.throwIfAborted()\n    return null\n  }\n\n  /** Explicit idle-session compaction: ACP leaves the decision to the model. */\n  override async compactNow(\n    _agent: ManualCompactAgentContext,\n    signal: AbortSignal,\n  ): Promise<CompactionResult | null> {\n    signal.throwIfAborted()\n    return null\n  }\n\n  /**\n   * The model-driven path lands through the `compress` tool, which runs the\n   * full durable transaction directly. This seam method rejects with guidance:\n   * automatic summarization is exactly what ACP replaces.\n   */\n  override async compactRegion(\n    _start: number,\n    _end: number,\n    _agent: CompactionAgentContext,\n    signal?: AbortSignal,\n  ): Promise<CompactionResult> {\n    signal?.throwIfAborted()\n    throw new ManualCompactionError(\n      'summary',\n      'billion-context-dsh is model-driven: use the compress tool instead of automatic summarization',\n    )\n  }\n}\n\nexport default AcpCompactionEngine\n","/**\n * M2 — per-session ACP kernel state.\n *\n * The in-memory map holds the exact acp-kernel `CompressionState` while a\n * session is live. Durability does not rely on a sidecar file: every durable\n * compression writes a `compaction/summary` event whose shadowed range and\n * summary re-derive the block ledger (`rebuildBlockLedger` in region.ts), so a\n * restarted engine can answer decompress/search/status from the session log\n * alone — DSH's \"log is the source of truth\" model.\n * @module billion-context-dsh/state\n */\n\nimport type { Session } from '@deepseek-ai/dsh-session'\nimport { createInitialState, type CompressionState } from 'acp-kernel'\n\nexport class AcpStateStore {\n  private readonly states = new Map<string, CompressionState>()\n\n  /** Kernel state for one session, initialised on first access. */\n  stateFor(session: Session): CompressionState {\n    const id = session.id\n    const existing = this.states.get(id)\n    if (existing !== undefined) return existing\n    const state = createInitialState()\n    this.states.set(id, state)\n    return state\n  }\n\n  set(session: Session, state: CompressionState): void {\n    this.states.set(session.id, state)\n  }\n\n  delete(session: Session): void {\n    this.states.delete(session.id)\n  }\n}\n","/**\n * M3 — the four model tools: compress / decompress / search_context /\n * acp_status, registered through `ctx.tools` (defineTool).\n *\n * compress is the heart of ACP: the model writes the summary and the tool\n * lands it as a durable surface replacement (no second LLM summarization\n * call). decompress recovers shadowed content read-only from the log (DSH\n * keeps the originals — V5). search_context scores blocks rebuilt from the\n * log. acp_status reports the block ledger and pressure.\n * @module billion-context-dsh/tools\n */\n\nimport { defineTool, type ToolDefinition, type ToolRunContext } from '@deepseek-ai/dsh-tools'\nimport { defaultCountTokens, type CompressionCore } from 'acp-kernel'\nimport type { Agent } from '@deepseek-ai/dsh-agent'\nimport type { AcpStateStore } from './state.ts'\nimport { kernelConfigFor, type KernelConfigInput } from './config.ts'\nimport {\n  rebuildBlockLedger,\n  resolveSurfaceRange,\n  runCompactionTransaction,\n  shadowedSeqsOf,\n} from './region.ts'\nimport { eventsToCoreMessages, extractEventText, surfaceEventsOf } from './messages.ts'\n\nexport interface ToolEnvironment extends KernelConfigInput {\n  readonly kernel: CompressionCore\n  readonly store: AcpStateStore\n}\n\ninterface TextOutput {\n  text: string\n}\n\nfunction textOutput(): {\n  schema: { type: 'object'; properties: { text: { type: 'string' } }; additionalProperties: boolean }\n  render: (args: unknown, value: TextOutput) => import('@deepseek-ai/dsh-llm').ContentBlock[]\n} {\n  return {\n    schema: {\n      type: 'object',\n      properties: { text: { type: 'string' } },\n      additionalProperties: false,\n    },\n    render: (_args, value) => [{ type: 'text', text: value.text }],\n  }\n}\n\nfunction requireAgent(exec: ToolRunContext): Agent {\n  if (exec.agent === undefined) {\n    throw new Error('billion-context-dsh: tool requires an agent execution context')\n  }\n  return exec.agent\n}\n\nconst compressParameters = {\n  topic: { type: 'string' as const, description: 'Fallback topic for entries without their own.' },\n  content: {\n    type: 'array' as const,\n    required: true,\n    description: 'One or more ranges to compress, each with startSeq/endSeq boundaries (surface seqs) and a dense summary.',\n    items: {\n      type: 'object' as const,\n      properties: {\n        startSeq: {\n          oneOf: [\n            { type: 'integer' as const, description: 'First surface seq of the range.' },\n            { type: 'string' as const, description: 'Seq as text; a trailing #callId fragment is ignored.' },\n          ],\n        },\n        endSeq: {\n          oneOf: [\n            { type: 'integer' as const, description: 'Inclusive last surface seq of the range.' },\n            { type: 'string' as const, description: 'Seq as text; a trailing #callId fragment is ignored.' },\n          ],\n        },\n        summary: { type: 'string' as const, description: 'Complete technical summary replacing the range; keep paths, decisions, values verbatim. Minimum 50 characters.' },\n        topic: { type: 'string' as const, description: 'Short label (3-5 words) for this range.' },\n      },\n      additionalProperties: false,\n    },\n  },\n} as const\n\n/** Normalize a seq arg: number, \"295\", or \"295#call_00_xxx\" → 295. */\nfunction parseSeq(value: number | string): number {\n  const text = String(value).split('#')[0]!.trim()\n  const seq = Number(text)\n  if (!Number.isInteger(seq) || seq < 0) {\n    throw new Error(`billion-context-dsh: invalid seq \"${String(value)}\" — use a surface seq like 295`)\n  }\n  return seq\n}\n\ninterface CompressArgs {\n  topic?: string\n  content: Array<{ startSeq: number | string; endSeq: number | string; summary: string; topic?: string }>\n}\n\n/** Resolve seq → kernel ref, then applyCompression and land the transaction. */\nasync function handleCompress(env: ToolEnvironment, args: CompressArgs, exec: ToolRunContext): Promise<TextOutput> {\n  const agent = requireAgent(exec)\n  const session = agent.session\n  const state = env.store.stateFor(session)\n  const coreMessages = eventsToCoreMessages(surfaceEventsOf(session))\n  const tokenCount = coreMessages.reduce((sum, message) => sum + defaultCountTokens(message.text ?? ''), 0)\n  const config = kernelConfigFor(env)\n\n  // Assign refs / advance state exactly like a turn would.\n  const turn = env.kernel.processTurn({ messages: coreMessages, state, config, tokenCount })\n  env.store.set(session, turn.state)\n  const byRaw = turn.state.messageRefs.byRaw\n\n  const ranges = args.content.map((range) => {\n    const startSeq = parseSeq(range.startSeq)\n    const endSeq = parseSeq(range.endSeq)\n    // Balance edges FIRST: the requested edges may sit on multi-tool-call\n    // assistant messages, which project to `${seq}#${callId}` CoreMessage ids\n    // and therefore have NO bare-`${seq}` ref. resolveSurfaceRange shifts them\n    // to clean tool-pairing-balanced cuts that always carry a bare ref, so the\n    // resolved refs exist and the shadowed span matches the returned range.\n    const { start, end } = resolveSurfaceRange(session, startSeq, endSeq)\n    const startRef = byRaw[String(start)]\n    const endRef = byRaw[String(end)]\n    if (startRef === undefined || endRef === undefined) {\n      throw new Error(\n        `billion-context-dsh: seq ${start}..${end} has no assigned ref — `\n        + 'the range must be on the current surface (run acp_status for the live seq list)',\n      )\n    }\n    return {\n      startSeq,\n      endSeq,\n      start,\n      end,\n      startRef,\n      endRef,\n      summary: range.summary,\n      ...(range.topic ?? args.topic) === undefined ? {} : { topic: range.topic ?? args.topic },\n    }\n  })\n\n  const applied = env.kernel.applyCompression({\n    ranges: ranges.map(({ startRef, endRef, summary, topic }) => ({ startRef, endRef, summary, topic })),\n    messages: coreMessages,\n    state: turn.state,\n    config,\n  })\n  if (applied.result.errors.length > 0) {\n    return { text: `compress failed: ${applied.result.errors.join('; ')}` }\n  }\n  env.store.set(session, applied.state)\n\n  const lines: string[] = []\n  for (let index = 0; index < ranges.length; index += 1) {\n    const range = ranges[index]!\n    const original = args.content[index]!\n    // The edges were already balanced above; shadow exactly that span.\n    const { start, end } = range\n    const shadowed = shadowedSeqsOf(session, start, end)\n    // Estimate the reclaimed tokens from the actual shadowed messages so the\n    // durable ledger (compaction/summary.shadowedTokenCount) reports a real\n    // number instead of 0.\n    let shadowedTokens = 0\n    for (const seq of shadowed) {\n      const event = session.events[seq]\n      if (event !== undefined) shadowedTokens += defaultCountTokens(extractEventText(event))\n    }\n    const { compactionId } = runCompactionTransaction(session, {\n      start,\n      end,\n      shadowedSeqs: shadowed,\n      summary: [{ type: 'text', text: original.summary }],\n      shadowedTokenCount: shadowedTokens,\n      provider: agent.options.provider ?? '',\n      model: agent.options.model ?? '',\n    })\n    const adjusted = start !== range.startSeq || end !== range.endSeq\n    lines.push(\n      `  block ${compactionId.slice(0, 8)}: seqs ${start}..${end}, ${shadowed.length} messages shadowed`\n      + (adjusted ? ` (adjusted from ${range.startSeq}..${range.endSeq} to balanced edges)` : ''),\n    )\n  }\n\n  return {\n    text: `Compressed ${applied.result.blocksCreated} block(s), ~${applied.result.tokensCompressed} tokens reclaimed.\\n${lines.join('\\n')}`,\n  }\n}\n\nconst decompressParameters = {\n  blockId: { type: 'string' as const, required: true, description: 'Block id from acp_status or search_context (the compaction id).' },\n} as const\n\ninterface DecompressArgs {\n  blockId: string\n}\n\nfunction handleDecompress(_env: ToolEnvironment, args: DecompressArgs, exec: ToolRunContext): TextOutput {\n  const session = requireAgent(exec).session\n  const ledger = rebuildBlockLedger(session.events)\n  const block = ledger.find((entry) => entry.blockId.startsWith(args.blockId))\n  if (block === undefined) {\n    return { text: `decompress: block \"${args.blockId}\" not found (see acp_status for the block list)` }\n  }\n  const parts: string[] = []\n  for (const seq of block.shadowedSeqs) {\n    const event = session.events[seq]\n    const text = event === undefined ? '' : extractEventText(event)\n    if (text.length > 0) parts.push(`[seq ${seq}] ${text}`)\n  }\n  return {\n    text: `Block ${block.blockId} — ${block.summary}\\n\\n${parts.join('\\n\\n') || '(no recoverable content)'}`,\n  }\n}\n\nconst searchParameters = {\n  query: { type: 'string' as const, required: true, description: 'Search terms to find inside compressed blocks.' },\n  limit: { type: 'integer' as const, description: 'Maximum results (default 5).' },\n} as const\n\ninterface SearchArgs {\n  query: string\n  limit?: number\n}\n\nfunction handleSearch(_env: ToolEnvironment, args: SearchArgs, exec: ToolRunContext): TextOutput {\n  const session = requireAgent(exec).session\n  const ledger = rebuildBlockLedger(session.events)\n  const terms = args.query.toLowerCase().split(/\\s+/).filter(Boolean)\n  const scored: Array<{ blockId: string; score: number; summary: string }> = []\n  for (const block of ledger) {\n    const original = block.shadowedSeqs\n      .map((seq) => extractEventText(session.events[seq]!))\n      .join('\\n')\n    const haystack = `${block.summary}\\n${original}`.toLowerCase()\n    let score = 0\n    for (const term of terms) score += haystack.split(term).length - 1\n    if (score > 0) scored.push({ blockId: block.blockId, score, summary: block.summary })\n  }\n  scored.sort((a, b) => b.score - a.score)\n  const top = scored.slice(0, args.limit ?? 5)\n  if (top.length === 0) return { text: `search_context: no matches for \"${args.query}\"` }\n  return {\n    text: `Matches for \"${args.query}\":\\n`\n      + top.map((hit) => `  - ${hit.blockId} (score ${hit.score}): ${hit.summary.slice(0, 160)}`).join('\\n')\n      + '\\n\\nDecompress with: decompress({ blockId })',\n  }\n}\n\nconst statusParameters = {} as const\n\ninterface StatusArgs {\n  [key: string]: never\n}\n\nfunction handleStatus(env: ToolEnvironment, _args: StatusArgs, exec: ToolRunContext): TextOutput {\n  const session = requireAgent(exec).session\n  const ledger = rebuildBlockLedger(session.events)\n  const totalTokens = ledger.reduce((sum, block) => sum + block.shadowedTokenCount, 0)\n  const coreMessages = eventsToCoreMessages(surfaceEventsOf(session))\n  const estimated = coreMessages.reduce((sum, message) => sum + defaultCountTokens(message.text ?? ''), 0)\n  const limit = env.modelContextLimit\n  const lines = [\n    `ACP status — session ${session.id}`,\n    `  blocks: ${ledger.length}`,\n    `  tokens compressed: ${totalTokens}`,\n    `  estimated context: ${estimated} / ${limit} (${Math.round((estimated / limit) * 100)}%)`,\n  ]\n  for (const block of ledger.slice(0, 10)) {\n    lines.push(`  - ${block.blockId.slice(0, 8)}: seqs ${block.start}..${block.end} (${block.shadowedSeqs.length} msgs) — ${block.summary.slice(0, 80)}`)\n  }\n  return { text: lines.join('\\n') }\n}\n\n/** Build the four ACP model tools bound to one engine. */\nexport function makeTools(env: ToolEnvironment): ToolDefinition[] {\n  return [\n    defineTool({\n      name: 'compress',\n      description:\n        'Replace older conversation ranges with dense summaries you write. '\n        + 'Each message seq is a surface reference. Single range: compress({ content: [{ startSeq, endSeq, summary }] }). '\n        + 'Batch multiple unrelated ranges in one call. Never compress content the current step is actively using.',\n      parameters: compressParameters,\n      output: textOutput(),\n      async execute(args, exec) {\n        return handleCompress(env, args as CompressArgs, exec)\n      },\n    }),\n    defineTool({\n      name: 'decompress',\n      description: 'Recover the original content of a compressed block by its blockId (read-only; does not unshadow the range).',\n      parameters: decompressParameters,\n      output: textOutput(),\n      execute(args, exec) {\n        return Promise.resolve(handleDecompress(env, args as DecompressArgs, exec))\n      },\n    }),\n    defineTool({\n      name: 'search_context',\n      description: 'Search inside compressed blocks (summaries and original content) for information the model no longer sees in context.',\n      parameters: searchParameters,\n      output: textOutput(),\n      execute(args, exec) {\n        return Promise.resolve(handleSearch(env, args as SearchArgs, exec))\n      },\n    }),\n    defineTool({\n      name: 'acp_status',\n      description: 'Report the ACP block ledger: compressed blocks, reclaimed tokens, and current context pressure.',\n      parameters: statusParameters,\n      output: textOutput(),\n      execute(args, exec) {\n        return Promise.resolve(handleStatus(env, args as StatusArgs, exec))\n      },\n    }),\n  ]\n}\n","/**\n * Kernel configuration assembly — the DSH counterpart of billion-context-pi's\n * `resolveConfig`: build acp-kernel's `Config` from adapter-level knobs.\n *\n * Defaults are deliberately the acp-kernel `defaultConfig` values (the same\n * defaults billion-context-pi ships: nudge window 45%–75%, emergency 95%,\n * growth ratio 5%, protected last messages 5). Every knob is optional — an\n * omitted value keeps the kernel default, so the behavior matches the Pi\n * adapter exactly unless a deployment opts out.\n * @module billion-context-dsh/config\n */\n\nimport { defaultConfig, type Config } from 'acp-kernel'\n\n/** The kernel-facing knobs shared by the nudge path and the compress tool. */\nexport interface KernelConfigInput {\n  readonly modelContextLimit: number\n  /** Nudge window lower bound (usage fraction). Kernel default: 0.45. */\n  readonly nudgeMinContextLimitPct?: number\n  /** Nudge window upper bound — over-limit. Kernel default: 0.75. */\n  readonly nudgeMaxContextLimitPct?: number\n  /** Emergency nudge threshold (bypasses per-turn dedup). Kernel default: 0.95. */\n  readonly nudgeEmergencyThresholdPct?: number\n  /** Any other acp-kernel Config override (the billion-context-pi escape hatch). */\n  readonly coreOverrides?: Partial<Config>\n}\n\n/**\n * Assemble the kernel config: `defaultConfig(limit)` merged with the optional\n * nudge thresholds (merged into the defaults, never replacing them wholesale)\n * and any additional `coreOverrides`.\n */\nexport function kernelConfigFor(input: KernelConfigInput): Config {\n  const nudgePatch: Partial<Config['nudge']> = {}\n  if (input.nudgeMinContextLimitPct !== undefined) nudgePatch.minContextLimitPct = input.nudgeMinContextLimitPct\n  if (input.nudgeMaxContextLimitPct !== undefined) nudgePatch.maxContextLimitPct = input.nudgeMaxContextLimitPct\n  if (input.nudgeEmergencyThresholdPct !== undefined) nudgePatch.emergencyThresholdPct = input.nudgeEmergencyThresholdPct\n\n  const overrides: Partial<Config> = { ...input.coreOverrides }\n  if (Object.keys(nudgePatch).length > 0) {\n    overrides.nudge = { ...defaultConfig(input.modelContextLimit).nudge, ...nudgePatch }\n  }\n  return defaultConfig(input.modelContextLimit, overrides)\n}\n","/**\n * M5 — durable region transaction and the log-rebuilt block ledger.\n *\n * Modeled on `dsh-compaction-basic/src/region.ts` (which is package-internal\n * and not exported by the seam): validate the surface range and tool-call/result\n * pairing, take the durable `compaction/start` lock, record `compaction/summary`\n * as the shadow price, land the `user/message` surface replacement carrying the\n * summary under `compactCheckpointSource`, and release the lock with\n * `compaction/end`. The original events stay in the append-only log, so\n * decompress/search/status can rebuild everything from the log.\n * @module billion-context-dsh/region\n */\n\nimport { randomUUID } from 'node:crypto'\nimport type { Session, SessionEvent } from '@deepseek-ai/dsh-session'\nimport {\n  CompactionId,\n  compactCheckpointSource,\n  toolPairingBalancedAfter,\n  toolPairingBalancedBefore,\n} from '@deepseek-ai/dsh-compaction'\nimport { createUserMessage, type ContentBlock } from '@deepseek-ai/dsh-llm'\nimport { defaultCountTokens } from 'acp-kernel'\nimport { extractEventText, extractText } from './messages.ts'\n\n/** One durable ACP block as rebuilt from the session log. */\nexport interface AcpBlockLedgerEntry {\n  /** The compaction transaction id (stable block identity). */\n  readonly blockId: string\n  readonly summary: string\n  readonly shadowedSeqs: readonly number[]\n  readonly shadowedTokenCount: number\n  readonly start: number\n  readonly end: number\n}\n\n/** The open turn number, or null when the log ends between turns. */\nexport function findOpenTurn(events: readonly SessionEvent[]): number | null {\n  let open: number | null = null\n  for (const event of events) {\n    if (event.type === 'turn/start') open = event.data.turn\n    else if (event.type === 'turn/end' && event.data.turn === open) open = null\n  }\n  return open\n}\n\n/** Reject a second concurrent compaction for the same session. */\nexport function assertNoActiveCompaction(events: readonly SessionEvent[]): void {\n  let active = false\n  for (const event of events) {\n    if (event.type === 'compaction/start') active = true\n    else if (event.type === 'compaction/end') active = false\n  }\n  if (active) {\n    throw new Error('billion-context-dsh: another compaction is already active for this session')\n  }\n}\n\n/**\n * Whether the surface node at `seq` projects to CoreMessage(s) whose ref key\n * is the bare seq — user messages, tool results, and text-only or SINGLE\n * tool-call assistant messages all do. Multi-tool-call assistant messages\n * project to `${seq}#${callId}` ids (projectEvent) and therefore carry NO\n * bare-`${seq}` ref, so compress's byRaw lookup can never resolve them as\n * range edges. resolveSurfaceRange treats such edges as unbalanced and shifts\n * them to the nearest clean cut.\n */\nfunction hasPlainRef(session: Session, seq: number): boolean {\n  const event = session.events[seq]\n  if (event === undefined) return false\n  switch (event.type) {\n    case 'user/message':\n    case 'tool/result':\n      return extractEventText(event).trim().length > 0\n    case 'assistant/message': {\n      const content = (event.data as { message?: { content?: unknown } }).message?.content\n      const calls = Array.isArray(content)\n        ? content.filter(\n            (block) => block !== null && typeof block === 'object' && (block as { type?: string }).type === 'tool-call',\n          )\n        : []\n      if (calls.length > 1) return false\n      // One tool-call: projectEvent emits a bare-seq CoreMessage unconditionally.\n      // Zero: only when the text is non-empty.\n      return calls.length === 1 || extractEventText(event).trim().length > 0\n    }\n    default:\n      return false\n  }\n}\n\n/**\n * Validate one inclusive surface span and adjust its edges to a\n * tool-pairing-balanced range whose boundaries carry a bare-seq ref. Missing\n * or reversed ranges still throw. An edge that sits inside a tool-call/result\n * pair — or on a multi-tool-call assistant message that has no bare-seq ref —\n * is first nudged inward to the nearest clean cut; if that collapses the range\n * (e.g. the model asked for a SINGLE tool result, which can never be balanced\n * alone), the range EXPANDS outward to the enclosing clean pair instead — a\n * lone tool message is almost always a \"consumed output\" the model genuinely\n * wants to compress. The returned range is what a caller should actually shadow.\n */\nexport function resolveSurfaceRange(\n  session: Session,\n  start: number,\n  end: number,\n): { start: number; end: number } {\n  const nodes = session.surface.nodes\n  const requestedStartIdx = nodes.indexOf(start)\n  const requestedEndIdx = nodes.indexOf(end)\n  if (requestedStartIdx < 0 || requestedEndIdx < 0) {\n    throw new Error(`billion-context-dsh: seq ${start}..${end} not in the current surface`)\n  }\n  if (requestedStartIdx > requestedEndIdx) {\n    throw new Error(`billion-context-dsh: reversed range ${start}..${end}`)\n  }\n  // A boundary must be BOTH tool-pairing-balanced AND carry a bare-seq ref.\n  const cleanBefore = (index: number): boolean =>\n    toolPairingBalancedBefore(session, nodes[index]!) && hasPlainRef(session, nodes[index]!)\n  const cleanAfter = (index: number): boolean =>\n    toolPairingBalancedAfter(session, nodes[index]!) && hasPlainRef(session, nodes[index]!)\n  let startIdx = requestedStartIdx\n  let endIdx = requestedEndIdx\n  // First pass: nudge inward to the nearest clean cuts.\n  while (startIdx <= endIdx && !cleanBefore(startIdx)) {\n    startIdx += 1\n  }\n  while (endIdx >= startIdx && !cleanAfter(endIdx)) {\n    endIdx -= 1\n  }\n  if (startIdx <= endIdx) {\n    return { start: nodes[startIdx]!, end: nodes[endIdx]! }\n  }\n  // Second pass: the inward pass collapsed (a lone tool message) — expand\n  // outward from the REQUESTED span to the smallest clean enclosing pair.\n  startIdx = requestedStartIdx\n  endIdx = requestedEndIdx\n  while (startIdx > 0 && !cleanBefore(startIdx)) {\n    startIdx -= 1\n  }\n  while (endIdx < nodes.length - 1 && !cleanAfter(endIdx)) {\n    endIdx += 1\n  }\n  if (cleanBefore(startIdx) && cleanAfter(endIdx)) {\n    return { start: nodes[startIdx]!, end: nodes[endIdx]! }\n  }\n  throw new Error(\n    `billion-context-dsh: no tool-pairing-balanced range around seq ${start}..${end} — `\n    + 'narrow the range or consult acp_status for the current surface',\n  )\n}\n\n/** The surface seqs shadowed by the inclusive positional span. */\nexport function shadowedSeqsOf(session: Session, start: number, end: number): number[] {\n  const nodes = session.surface.nodes\n  const startIdx = nodes.indexOf(start)\n  const endIdx = nodes.indexOf(end)\n  return nodes.slice(startIdx, endIdx + 1)\n}\n\nexport interface CompactionTransactionInput {\n  readonly start: number\n  readonly end: number\n  readonly shadowedSeqs: readonly number[]\n  readonly summary: ContentBlock[]\n  readonly shadowedTokenCount: number\n  readonly provider: string\n  readonly model: string\n}\n\n/**\n * Run one durable compression transaction. Throws on invalid state; on success\n * the four events are in the log and the surface has one summary node.\n */\nexport function runCompactionTransaction(\n  session: Session,\n  input: CompactionTransactionInput,\n): { compactionId: string; seqs: number[] } {\n  assertNoActiveCompaction(session.events)\n  const turn = findOpenTurn(session.events)\n  const compactionId = CompactionId(randomUUID())\n  const seqs: number[] = []\n\n  seqs.push(session.append('compaction/start', { compactionId, turn }).seq)\n  seqs.push(session.append('compaction/summary', {\n    compactionId,\n    summary: input.summary,\n    shadowedRange: { start: input.start, end: input.end },\n    shadowedSeqs: [...input.shadowedSeqs],\n    shadowedTokenCount: input.shadowedTokenCount,\n    provider: input.provider,\n    model: input.model,\n  }).seq)\n\n  const message = createUserMessage({\n    content: input.summary,\n    source: compactCheckpointSource(compactionId),\n  })\n  seqs.push(session.append('user/message', message, {\n    surfaceOp: { op: 'replace', start: input.start, end: input.end },\n    sourceEventSeqs: [...input.shadowedSeqs],\n  }).seq)\n\n  seqs.push(session.append('compaction/end', { compactionId, turn }).seq)\n  return { compactionId, seqs }\n}\n\n/** Rebuild the block ledger from the durable log (no kernel state needed). */\nexport function rebuildBlockLedger(events: readonly SessionEvent[]): AcpBlockLedgerEntry[] {\n  const ledger: AcpBlockLedgerEntry[] = []\n  for (const event of events) {\n    if (event.type !== 'compaction/summary') continue\n    const data = event.data\n    // Blocks written before the token-accounting fix carry shadowedTokenCount\n    // 0; backfill from the shadowed originals still in the log so acp_status\n    // reports real reclaimed tokens.\n    let shadowedTokenCount = data.shadowedTokenCount\n    if (shadowedTokenCount === 0) {\n      shadowedTokenCount = 0\n      for (const seq of data.shadowedSeqs) {\n        const original = events[seq]\n        if (original !== undefined) shadowedTokenCount += defaultCountTokens(extractEventText(original))\n      }\n    }\n    ledger.push({\n      blockId: data.compactionId,\n      summary: extractText(data.summary),\n      shadowedSeqs: [...data.shadowedSeqs],\n      shadowedTokenCount,\n      start: data.shadowedRange.start,\n      end: data.shadowedRange.end,\n    })\n  }\n  return ledger\n}\n\n/** One self-computed compressible span of the current surface. */\nexport interface SeqCompressibleRange {\n  readonly start: number\n  readonly end: number\n  readonly count: number\n  readonly tokens: number\n}\n\n/** Whether a surface user message is a compaction checkpoint node (already compressed). */\nfunction isCheckpointNode(event: SessionEvent): boolean {\n  if (event.type !== 'user/message') return false\n  const source = (event.data as { source?: { plugin?: string } }).source\n  return source?.plugin === 'compact'\n}\n\n/**\n * Compute compressible spans directly from the surface — independent of the\n * kernel's ref map, which can drift after surface replacements in long\n * sessions and hide large tool results from the nudge range table. Skips the\n * recent protected tail, the last user message, and compaction checkpoints;\n * edges are then balanced through resolveSurfaceRange. Ranges are ordered by\n * size (largest reclaimed first).\n */\nexport function buildCompressibleSeqRanges(\n  session: Session,\n  opts: { preserveRecent?: number } = {},\n): SeqCompressibleRange[] {\n  const nodes = session.surface.nodes\n  const preserve = opts.preserveRecent ?? 5\n  const protectedSeqs = new Set<number>()\n  for (const seq of nodes.slice(-preserve)) protectedSeqs.add(seq)\n  for (let index = nodes.length - 1; index >= 0; index -= 1) {\n    const event = session.events[nodes[index]!]\n    if (event?.type === 'user/message' && !isCheckpointNode(event)) {\n      protectedSeqs.add(nodes[index]!)\n      break\n    }\n  }\n  const raw: SeqCompressibleRange[] = []\n  let cur: SeqCompressibleRange | null = null\n  const flush = (): void => {\n    if (cur !== null) raw.push(cur)\n    cur = null\n  }\n  for (const seq of nodes) {\n    const event = session.events[seq]\n    if (event === undefined || protectedSeqs.has(seq) || isCheckpointNode(event)) {\n      flush()\n      continue\n    }\n    const tokens = defaultCountTokens(extractEventText(event))\n    if (cur === null) {\n      cur = { start: seq, end: seq, count: 1, tokens }\n    } else {\n      cur = { start: cur.start, end: seq, count: cur.count + 1, tokens: cur.tokens + tokens }\n    }\n  }\n  flush()\n  const out: SeqCompressibleRange[] = []\n  for (const range of raw) {\n    try {\n      const { start, end } = resolveSurfaceRange(session, range.start, range.end)\n      const count = range.count\n      out.push({ start, end, count, tokens: range.tokens })\n    } catch {\n      // Cannot be balanced into a compressible span — skip.\n    }\n  }\n  return out.sort((a, b) => b.tokens - a.tokens)\n}\n","/**\n * M1 — session-log projection: DSH surface events → acp-kernel CoreMessage.\n *\n * The ACP kernel is message-array based; DSH is event-log based. This module\n * is the bridge in the direction the engine needs (projectEvent /\n * eventsToCoreMessages). The reverse direction (CoreMessage[] → session\n * appends) is the M5 region transaction's job.\n * Mirrors billion-context-pi's `projectMessage`/`entriesToCoreMessages`\n * against DSH event shapes (see V-verification: SurfaceEventType =\n * 'user/message' | 'assistant/message' | 'tool/result').\n * @module billion-context-pi-dsh/messages\n */\n\nimport type { CoreMessage } from 'acp-kernel'\nimport type { SessionEvent } from '@deepseek-ai/dsh-session'\n\n/**\n * Extract plain text from a DSH content block array or string.\n *\n * Recursive: a real DSH `tool-result` block is `{ type: 'tool-result',\n * toolCallId, content: ContentBlock[] }` — the inner `content` array holds\n * the actual `text` blocks, so a top-level-only walk would drop every tool\n * result from the projection (and with it the seq's ref assignment, breaking\n * compress boundary resolution). Nested arrays are flattened depth-first.\n */\nexport function extractText(content: unknown): string {\n  if (typeof content === 'string') return content\n  if (!Array.isArray(content)) return ''\n  const parts: string[] = []\n  for (const block of content) {\n    if (block === null || typeof block !== 'object') continue\n    const b = block as { type?: unknown; text?: unknown; content?: unknown }\n    if (b.type === 'text' && typeof b.text === 'string') {\n      parts.push(b.text)\n    } else if (Array.isArray(b.content)) {\n      parts.push(extractText(b.content))\n    }\n  }\n  return parts.join('\\n')\n}\n\ninterface ToolCallBlock {\n  type: 'tool-call'\n  id?: string\n  name?: string\n  arguments?: unknown\n}\n\nfunction toolCallsOf(content: unknown): ToolCallBlock[] {\n  if (!Array.isArray(content)) return []\n  return content.filter((b): b is ToolCallBlock => (b as { type?: string }).type === 'tool-call')\n}\n\nfunction stringifyArgs(args: unknown): string {\n  if (!args) return ''\n  if (typeof args === 'string') return args\n  try {\n    return JSON.stringify(args)\n  } catch {\n    return String(args)\n  }\n}\n\n/**\n * Project one surface message event into CoreMessage(s).\n *  - user/message      → user text (verbatim content)\n *  - assistant/message → assistant text, or one CoreMessage per tool-call\n *  - tool/result       → tool result (toolName/toolCallId, role 'tool')\n * Non-surface events project to nothing.\n */\nexport function projectEvent(event: SessionEvent): CoreMessage[] {\n  switch (event.type) {\n    case 'user/message': {\n      const text = extractText((event.data as { content?: unknown }).content)\n      return text.length > 0 ? [{ id: String(event.seq), role: 'user', contentType: 'text', text }] : []\n    }\n    case 'assistant/message': {\n      const content = (event.data as { message?: { content?: unknown } }).message?.content\n      const calls = toolCallsOf(content)\n      const text = extractText(content)\n      if (calls.length === 0) {\n        return text.trim().length > 0\n          ? [{ id: String(event.seq), role: 'assistant', contentType: 'text', text }]\n          : []\n      }\n      if (calls.length === 1) {\n        const call = calls[0]!\n        const argStr = stringifyArgs(call.arguments)\n        const body = argStr && text ? `${text}\\n${argStr}` : argStr || text\n        return [{\n          id: String(event.seq),\n          role: 'assistant',\n          contentType: 'tool-call',\n          toolName: call.name ?? '',\n          toolCallId: call.id ?? '',\n          text: body,\n        }]\n      }\n      return calls.map((call) => ({\n        id: `${event.seq}#${call.id ?? ''}`,\n        role: 'assistant' as const,\n        contentType: 'tool-call' as const,\n        toolName: call.name ?? '',\n        toolCallId: call.id ?? '',\n        text: stringifyArgs(call.arguments) || text,\n      }))\n    }\n    case 'tool/result': {\n      const message = (event.data as {\n        message?: { content?: unknown; toolName?: string; toolCallId?: string }\n      }).message\n      const text = extractText(message?.content)\n      if (text.length === 0) return []\n      return [{\n        id: String(event.seq),\n        role: 'tool',\n        contentType: 'tool-result',\n        toolName: message?.toolName ?? '',\n        toolCallId: message?.toolCallId ?? '',\n        text,\n      }]\n    }\n    default:\n      return []\n  }\n}\n\n/** Project a session's message events into CoreMessage[] in log order. */\nexport function eventsToCoreMessages(events: readonly SessionEvent[]): CoreMessage[] {\n  const out: CoreMessage[] = []\n  for (const event of events) out.push(...projectEvent(event))\n  return out\n}\n\n/** The surface-visible message events of a session, in model-visible order. */\nexport function surfaceEventsOf(session: import('@deepseek-ai/dsh-session').Session): SessionEvent[] {\n  return session.surface.nodes\n    .map((seq) => session.events[seq])\n    .filter((event): event is SessionEvent => event !== undefined)\n}\n\n/** Extract the model-facing text of any surface message event. */\nexport function extractEventText(event: SessionEvent): string {\n  switch (event.type) {\n    case 'user/message':\n      return extractText((event.data as { content?: unknown }).content)\n    case 'assistant/message':\n      return extractText((event.data as { message?: { content?: unknown } }).message?.content)\n    case 'tool/result':\n      return extractText((event.data as { message?: { content?: unknown } }).message?.content)\n    default:\n      return ''\n  }\n}\n","/**\n * M4 — the `/acp` slash command: a human-friendly window into the same\n * machinery the model tools expose (status, one-shot compress, decompress).\n * @module billion-context-dsh/commands\n */\n\nimport type { CommandDefinition } from '@deepseek-ai/dsh-commands'\nimport type { Agent } from '@deepseek-ai/dsh-agent'\nimport type { ToolEnvironment } from './tools.ts'\nimport {\n  rebuildBlockLedger,\n  resolveSurfaceRange,\n  runCompactionTransaction,\n  shadowedSeqsOf,\n} from './region.ts'\nimport { eventsToCoreMessages, extractEventText, surfaceEventsOf } from './messages.ts'\nimport { defaultConfig, defaultCountTokens } from 'acp-kernel'\n\nfunction statusText(env: ToolEnvironment, agent: Agent): string {\n  const session = agent.session\n  const ledger = rebuildBlockLedger(session.events)\n  const totalTokens = ledger.reduce((sum, block) => sum + block.shadowedTokenCount, 0)\n  const coreMessages = eventsToCoreMessages(surfaceEventsOf(session))\n  const estimated = coreMessages.reduce((sum, message) => sum + defaultCountTokens(message.text ?? ''), 0)\n  const limit = env.modelContextLimit\n  const lines = [\n    `ACP status — session ${session.id}`,\n    `  blocks: ${ledger.length}`,\n    `  tokens compressed: ${totalTokens}`,\n    `  estimated context: ${estimated} / ${limit} (${Math.round((estimated / limit) * 100)}%)`,\n  ]\n  for (const block of ledger.slice(0, 10)) {\n    lines.push(`  - ${block.blockId.slice(0, 8)}: seqs ${block.start}..${block.end} — ${block.summary.slice(0, 80)}`)\n  }\n  return lines.join('\\n')\n}\n\nfunction compressText(env: ToolEnvironment, agent: Agent, args: string[]): string {\n  if (args.length < 3) {\n    return '/acp compress <startSeq> <endSeq> <summary...>'\n  }\n  const startSeq = Number(args[0])\n  const endSeq = Number(args[1])\n  const summary = args.slice(2).join(' ')\n  if (!Number.isInteger(startSeq) || !Number.isInteger(endSeq)) {\n    return '/acp compress: startSeq and endSeq must be integers'\n  }\n  const session = agent.session\n  const { start, end } = resolveSurfaceRange(session, startSeq, endSeq)\n  const shadowed = shadowedSeqsOf(session, startSeq, endSeq)\n  let shadowedTokens = 0\n  for (const seq of shadowed) {\n    const event = session.events[seq]\n    if (event !== undefined) shadowedTokens += defaultCountTokens(extractEventText(event))\n  }\n  const { compactionId } = runCompactionTransaction(session, {\n    start,\n    end,\n    shadowedSeqs: shadowed,\n    summary: [{ type: 'text', text: summary }],\n    shadowedTokenCount: shadowedTokens,\n    provider: agent.options.provider ?? '',\n    model: agent.options.model ?? '',\n  })\n  return `Compressed seqs ${start}..${end} (${shadowed.length} messages) as block ${compactionId.slice(0, 8)}`\n}\n\nfunction decompressText(_env: ToolEnvironment, agent: Agent, args: string[]): string {\n  if (args.length < 1) return '/acp decompress <blockId>'\n  const session = agent.session\n  const ledger = rebuildBlockLedger(session.events)\n  const block = ledger.find((entry) => entry.blockId.startsWith(args[0]!))\n  if (block === undefined) return `block \"${args[0]}\" not found (see /acp status)`\n  const parts = block.shadowedSeqs\n    .map((seq) => extractEventText(session.events[seq]!))\n    .filter((text) => text.length > 0)\n  return `Block ${block.blockId} — ${block.summary}\\n\\n${parts.join('\\n\\n') || '(no recoverable content)'}`\n}\n\n/** Register the /acp command (idempotent per engine). */\nexport function acpCommand(env: ToolEnvironment): CommandDefinition {\n  return {\n    name: 'acp',\n    description:\n      'Active Context Pruning — model-driven context compression. '\n      + 'Usage: /acp status | /acp compress <startSeq> <endSeq> <summary> | /acp decompress <blockId>',\n    handler: async (invocation) => {\n      const raw = invocation.rawInput.trim()\n      if (raw === '' || raw === 'status') {\n        return { kind: 'success', text: statusText(env, invocation.agent) }\n      }\n      if (raw.startsWith('compress')) {\n        return { kind: 'success', text: compressText(env, invocation.agent, raw.slice('compress'.length).trim().split(/\\s+/) ) }\n      }\n      if (raw.startsWith('decompress')) {\n        return { kind: 'success', text: decompressText(env, invocation.agent, raw.slice('decompress'.length).trim().split(/\\s+/)) }\n      }\n      return { kind: 'error', text: `unknown /acp subcommand \"${raw.split(/\\s+/)[0]}\" — use status | compress | decompress` }\n    },\n  }\n}\n","/**\n * M4 — ACP nudge: the kernel's compression recommendation, rendered as an\n * injected user message with a seq-based compressible-range table (D1:\n * \"seq is the ref\" — DSH has no in-memory message rewrite hook, so the model\n * targets ranges by surface seq rather than by <acp> tags).\n * @module billion-context-dsh/nudge\n */\n\nimport {\n  defaultCountTokens,\n  type CompressionCore,\n  type CoreMessage,\n  type NudgeDecision,\n} from 'acp-kernel'\nimport { createUserMessage, type UserMessage } from '@deepseek-ai/dsh-llm'\nimport type { Agent } from '@deepseek-ai/dsh-agent'\nimport { AcpStateStore } from './state.ts'\nimport { eventsToCoreMessages, surfaceEventsOf } from './messages.ts'\nimport { buildCompressibleSeqRanges, findOpenTurn } from './region.ts'\nimport { kernelConfigFor, type KernelConfigInput } from './config.ts'\n\n/** Kernel inputs the nudge path shares with the compress tool. */\nexport interface NudgeEnvironment extends KernelConfigInput {\n  readonly kernel: CompressionCore\n  readonly store: AcpStateStore\n}\n\nexport interface NudgeOutcome {\n  readonly message: UserMessage\n  readonly emergency: boolean\n}\n\n/**\n * Render the compressible-range table as seq refs for the model.\n * Computed directly from the surface (not the kernel's ref map, which can\n * drift and hide large tool results) — see buildCompressibleSeqRanges.\n */\nexport function rangeTable(session: import('@deepseek-ai/dsh-session').Session): string {\n  const ranges = buildCompressibleSeqRanges(session).slice(0, 6)\n  if (ranges.length === 0) return ''\n  const lines = ranges.map((range) => `  - seq ${range.start}..${range.end} — ${range.count} messages, ~${range.tokens} tokens`)\n  return [\n    '',\n    'Compressible ranges (refs are surface seqs):',\n    ...lines,\n    'Compress with: compress({ content: [{ startSeq, endSeq, summary }] })',\n  ].join('\\n')\n}\n\n/**\n * The token count driving pressure decisions. Prefer the host token meter's\n * SURFACE tokens (the input-side heuristic total — matches acp_status and the\n * UI's message-token view). `totalTokens` is request-AND-RESPONSE pressure and\n * can far exceed the window in long sessions (observed 230% against a real\n * ~20% occupancy), so it is not used. Falls back to the fast heuristic when\n * the meter is absent (tests, minimal hosts).\n */\nfunction measuredTokenCount(agent: Agent, coreMessages: CoreMessage[]): number {\n  const meter = agent.ctx?.get?.('tokenMeter') as\n    | { measure?: (session: unknown) => { surfaceTokens?: number } }\n    | undefined\n  const surface = meter?.measure?.(agent.session)?.surfaceTokens\n  if (typeof surface === 'number' && surface > 0) return surface\n  return coreMessages.reduce((sum, message) => sum + defaultCountTokens(message.text ?? ''), 0)\n}\n\n/**\n * Decide and build one nudge message for the agent's next pre-step. Returns\n * null when the kernel recommends no nudge or one was already injected for the\n * current turn (emergency nudges always bypass the dedup). Also advances the\n * in-memory kernel state (ref assignment) so the compress tool can resolve\n * seq → mNNNNN refs.\n */\nexport function buildNudge(\n  agent: Agent,\n  env: NudgeEnvironment,\n  lastNudgeTurn: Map<string, number>,\n): NudgeOutcome | null {\n  const session = agent.session\n  const state = env.store.stateFor(session)\n  const coreMessages = eventsToCoreMessages(surfaceEventsOf(session))\n  const tokenCount = measuredTokenCount(agent, coreMessages)\n  const config = kernelConfigFor(env)\n  const turn = env.kernel.processTurn({ messages: coreMessages, state, config, tokenCount })\n  env.store.set(session, turn.state)\n\n  const nudge = turn.nudge\n  if (nudge === undefined || !nudge.shouldInject) return null\n  const emergency = nudge.breakdown?.emergencyOverride === 1\n\n  const turnNumber = findOpenTurn(session.events) ?? 0\n  const alreadyShown = !emergency && lastNudgeTurn.get(session.id) === turnNumber\n  if (alreadyShown) return null\n  lastNudgeTurn.set(session.id, turnNumber)\n\n  const text = buildNudgeText(nudge, emergency, session)\n  const message = createUserMessage({\n    content: [{ type: 'text', text }],\n    source: { kind: 'plugin', plugin: 'acp-nudge' },\n  })\n  return { message, emergency }\n}\n\n/**\n * A short ADVISORY nudge — ACP is model-driven, the model decides whether and\n * when to compress. Full guidance (tools, philosophy, summary rules) lives in\n * the system prompt once, not in every nudge.\n */\nfunction buildNudgeText(\n  nudge: NudgeDecision,\n  emergency: boolean,\n  session: import('@deepseek-ai/dsh-session').Session,\n): string {\n  // Cap the reported percentage at 100: a broken measurement (e.g. response\n  // pressure folded in) must never surface as an absurd \"230%\" to the model.\n  const pct = Math.round(Math.min(nudge.contextUsage, 1) * 100)\n  const frame = emergency\n    ? `⚠️ Context usage is at ${pct}% of the window — nearly full. Consider compressing consumed ranges soon so working context stays available; the choice and timing are yours.`\n    : `Context usage is at ${pct}%. This is a suggestion, not a requirement — you decide whether and when to compress.`\n  const guidance = 'Compress by need, not by percentage: replace only ranges you have genuinely consumed, with dense self-contained summaries.'\n  return [frame, '', guidance, rangeTable(session)].join('\\n')\n}\n","/**\n * M4 — the ACP system-prompt section (DSH counterpart of billion-context-pi's\n * ACP_SYSTEM_PROMPT): the load-bearing compression guidance lives here, ONCE,\n * instead of being re-sent with every nudge. The nudge itself stays a short,\n * advisory notice — ACP is model-driven, the model decides whether and when\n * to compress (never \"compress now\").\n * @module billion-context-dsh/system-prompt\n */\n\nimport { COMPRESS_PHILOSOPHY } from 'acp-kernel'\n\nexport const ACP_SYSTEM_PROMPT = `Active Context Pruning — model-driven context management\n\nYOU decide whether and when to compress context. Nothing forces you: the injected \"nudge\" is a suggestion, not an order, and you may ignore it when compression would not help. Compress only ranges you have genuinely consumed (read tool outputs, finished explorations, superseded steps) that the current work no longer needs verbatim.\n\n${COMPRESS_PHILOSOPHY}\n\nCompression tools (refs are SURFACE SEQS, not ids):\n- compress: replace a seq range with your dense self-contained summary. compress({ content: [{ startSeq, endSeq, summary }] }). Edges are auto-balanced to tool-call/result boundaries; a trailing #callId fragment in a seq is ignored. Ranges must be on the current surface — stale seqs fail with guidance.\n- decompress: recover a compressed block's original content, read-only. decompress({ blockId }).\n- search_context: find information inside compressed blocks BEFORE decompressing. search_context({ query }).\n- acp_status: current context usage and the live compressible-range list. Run it before compressing when in doubt.\n\nWhen you write a summary, it becomes the ONLY record of that range: keep file paths, signatures, exact values, decisions, and error strings verbatim so a later reader (or you, after decompress) can continue without the original. Never reuse historical seqs — the surface moves as messages land and compress; verify with acp_status.`\n\n/** System-prompt section order: tool guidance lives in 100–199. */\nexport const ACP_SYSTEM_PROMPT_ORDER = 150\n"],"mappings":"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","names":["defaultCountTokens","defaultCountTokens","defaultCountTokens","defaultCountTokens","createUserMessage","defaultCountTokens","createUserMessage"]}

package/dist/region.d.ts

@@ -28,13 +28,14 @@ export declare function findOpenTurn(events: readonly SessionEvent[]): number |
 export declare function assertNoActiveCompaction(events: readonly SessionEvent[]): void;
 /**
  * Validate one inclusive surface span and adjust its edges to a
- * tool-pairing-balanced range. Missing or reversed ranges still throw. An
- * edge that sits inside a tool-call/result pair is first nudged inward to the
- * nearest clean cut; if that collapses the range (e.g. the model asked for a
- * SINGLE tool result, which can never be balanced alone), the range EXPANDS
- * outward to the enclosing balanced pair instead — a lone tool message is
- * almost always a "consumed output" the model genuinely wants to compress.
- * The returned range is what a caller should actually shadow.
+ * tool-pairing-balanced range whose boundaries carry a bare-seq ref. Missing
+ * or reversed ranges still throw. An edge that sits inside a tool-call/result
+ * pair — or on a multi-tool-call assistant message that has no bare-seq ref —
+ * is first nudged inward to the nearest clean cut; if that collapses the range
+ * (e.g. the model asked for a SINGLE tool result, which can never be balanced
+ * alone), the range EXPANDS outward to the enclosing clean pair instead — a
+ * lone tool message is almost always a "consumed output" the model genuinely
+ * wants to compress. The returned range is what a caller should actually shadow.
  */
 export declare function resolveSurfaceRange(session: Session, start: number, end: number): {
     start: number;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "billion-context-dsh",
-	"version": "0.1.1",
+	"version": "0.1.2",
 	"description": "Active Context Pruning (ACP) for the DeepSeek Harness — model-driven context management as a CompactionEngine backend.",
 	"type": "module",
 	"main": "dist/index.js",
@@ -14,7 +14,7 @@
 	"files": [
 		"dist",
 		"README.md",
-		"README.zh-CN.md",
+		"README.en.md",
 		"LICENSE"
 	],
 	"sideEffects": false,

package/README.zh-CN.md

@@ -1,154 +0,0 @@
-# billion-context-dsh
-
-[English](./README.md) | [中文](./README.zh-CN.md)
-
-> **⚠️ 测试版声明——请勿用于生产环境**
-> 本项目（**v0.1.1**）仍处于开发中的测试版。[DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) 本身也处于**公开测试版**阶段。**请勿将两者用于工程化 / 生产环境**——预期会有破坏性变更与粗糙之处。
-
-<p align="center">
-<strong>衷心感谢以下项目——请给它们一个 ⭐：</strong>
-<br />
-<a href="https://github.com/deepseek-ai/deepseek-harness">DeepSeek Harness</a> ·
-<a href="https://github.com/ranxianglei/billion-context-pi">billion-context-pi</a> ·
-<a href="https://github.com/ranxianglei/acp-kernel">acp-kernel</a> ·
-<a href="https://github.com/ranxianglei/opencode-acp">opencode-acp</a>
-</p>
-
-<p align="center">
-<strong>Billion-Context</strong> for <a href="https://github.com/deepseek-ai/deepseek-harness">DeepSeek Harness</a>
-<br />
-由模型决定<em>何时</em>压缩、<em>压缩什么</em>——而不是一个硬性上限。
-</p>
-
----
-
-<p align="center">
-<a href="https://www.npmjs.com/package/billion-context-dsh"><img src="https://img.shields.io/npm/v/billion-context-dsh.svg?style=flat-square" alt="npm"></a>
-<a href="https://github.com/Tyan66666/billion-context-dsh/blob/main/LICENSE"><img src="https://img.shields.io/npm/l/billion-context-dsh.svg?style=flat-square" alt="license"></a>
-<a href="https://github.com/Tyan66666/billion-context-dsh"><img src="https://img.shields.io/badge/GitHub-Tyan66666%2Fbillion--context--dsh-181717?style=flat-square&logo=github" alt="GitHub"></a>
-<a href="https://github.com/topics/dsh-plugin"><img src="https://img.shields.io/badge/topic-dsh--plugin-blue?style=flat-square" alt="dsh-plugin"></a>
-</p>
-
-<p align="center">
-<code>npm install billion-context-dsh</code>
-</p>
-
----
-
-## 为什么？
-
-当对话变长，模型会耗尽上下文。多数工具直接硬截断——悄悄丢弃早期消息。**billion-context-dsh** 给模型一个 `compress` 工具：由 LLM 决定**何时**、**压缩什么**，写成高保真摘要，保留关键细节（文件路径、决策、错误信息）的同时回收上下文空间。
-
-与 DSH 内置的自动压缩（用自动生成的摘要替换一段范围）不同，billion-context-dsh：
-
-- **模型驱动** —— 摘要由模型自己书写，没有第二次 LLM 摘要调用（ACP 的成本优势）
-- **只建议、不强令** —— 自动策略只 *nudge*（提醒），是否压缩、何时压缩由模型决定
-- **持久且可恢复** —— 压缩范围成为 checkpoint 节点，原文保留在 append-only 会话日志中；`decompress` 可恢复，`search_context` 可在块内查找
-- **基于 seq 引用** —— 不需要消息标签；surface seq 由 nudge 的范围表携带，范围边界自动平衡、容忍 `#callId` 片段
-
-这是 [billion-context-pi](https://github.com/ranxianglei/billion-context-pi)（Pi 编码代理适配器）在 DeepSeek Harness 上的移植：压缩内核（[acp-kernel](https://github.com/ranxianglei/acp-kernel)）原样复用，适配层针对 DSH 的 durable-surface 模型重写——经过验证的映射关系见 [docs](https://github.com/Tyan66666/billion-context-dsh/tree/main/docs)。
-
-## 安装
-
-```bash
-npm install billion-context-dsh
-```
-
-就这样。在需要压缩后端的位置加一行组合配置（宿主组合或 agent preset 的 `compaction` realm）：
-
-```yaml
-- id: compaction-billion-context
-  name: 'billion-context-dsh'
-  config:
-    modelContextLimit: 128000   # 默认；压力窗口
-```
-
-> **每个 agent 只留一个上下文管理器。** preset 的 `compaction` isolate realm 应该用本引擎*替换* `dsh-compaction-basic`——两个后端同时 provide `ctx.compaction` 会冲突（完整文档见 [docs](https://github.com/Tyan66666/billion-context-dsh/tree/main/docs)）。
-
-## 工作原理
-
-DSH 的每个模型请求都派生自其 append-only 会话日志（*surface*）。ACP 语义直接映射到这一模型：
-
-| ACP 概念 | DSH 实现 |
-|---|---|
-| `compress` 工具遮蔽一段范围 | 持久化 `surfaceOp: { op: 'replace' }`——模型书写的摘要成为 checkpoint 节点；原文保留在日志中 |
-| refs（`m00001` 标签） | surface seq，由 nudge 的可压缩范围表携带 |
-| nudge（"考虑压缩一下"） | 由内核的压力决策在 `agent/pre-step` 注入——简短建议，绝非命令 |
-| `decompress` | 从日志只读恢复被遮蔽的原文 |
-| `search_context` | 对从日志重建的块摘要与原文打分 |
-| `acp_status` | 块账本与上下文压力 |
-| 块状态 | 内存内核状态 + **日志重建账本**（无旁车文件） |
-
-承载性的压缩指引（工具、哲学、摘要规则）注册为一次性系统提示段，因此 nudge 保持简短。刻意**不做自动摘要**：自动策略只 nudge 模型（`compactIfNeeded` 返回 null）。
-
-## 视频讲解
-
-本项目继承的 ACP 哲学讲解——主动上下文压缩如何在约 20 万 token 内保持会话精简（opencode-acp 与 billion-context-pi）。*视频原作者：[裘香莲](https://space.bilibili.com/)（B 站 UP 主），非本项目制作。*
-
-[![在 B 站观看](https://i1.hdslb.com/bfs/archive/083a77fede77502cbd6b2e206f8aadcc4dacc7ea.jpg)](https://www.bilibili.com/video/BV1qAMR6MEA4/)
-
-## 模型工具
-
-| 工具 | 作用 |
-| --- | --- |
-| `compress` | 用你书写的紧凑摘要替换 seq 范围（边界自动平衡到 tool-call/result 配对点） |
-| `decompress` | 恢复已压缩块的原始内容（只读） |
-| `search_context` | 按关键词搜索压缩块摘要与原文 |
-| `acp_status` | 上下文占用、压缩块、可压缩范围 |
-| `/acp` | 从命令栏执行 status / compress / decompress |
-
-## 上游项目与致谢
-
-本项目是一个**移植/派生项目**，站在以下上游工作的肩膀上——全部为 MIT 许可。**衷心感谢** [ranxianglei](https://github.com/ranxianglei) 和 DeepSeek Harness 团队创建并开源这些项目：
-
-| 上游项目 | 作者 | 角色 |
-|---|---|---|
-| **[billion-context-pi](https://github.com/ranxianglei/billion-context-pi)** | [ranxianglei](https://github.com/ranxianglei) | 本项目移植的 Pi 编码代理适配器；适配器设计、工具语义与本项目默认配置的来源 |
-| **[acp-kernel](https://github.com/ranxianglei/acp-kernel)** | [ranxianglei](https://github.com/ranxianglei) | 框架无关的上下文压缩引擎——**原样复用**（refs、blocks、tiers、nudge 决策、search、status） |
-| **[opencode-acp](https://github.com/ranxianglei/opencode-acp)** | [ranxianglei](https://github.com/ranxianglei) | ACP（"模型决定何时压缩、压缩什么"）设计的源头 |
-| **[DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness)** | DeepSeek AI | 本项目所扩展的宿主平台（compaction 能力接缝、agent preset、持久化会话日志） |
-
-本项目原样复用 `acp-kernel` 的压缩内核与 `billion-context-pi` 的默认行为；DSH 适配层（会话事件投影、持久化表面事务、模型工具、nudge、配置）为本仓库原创。上游版权与许可归其各自作者所有；本项目的许可条款见 [LICENSE](LICENSE)。
-
-## 配置
-
-| 键 | 默认值 | 含义 |
-|---|---|---|
-| `modelContextLimit` | `128000` | 用于内核压力决策的上下文窗口 |
-| `nudgeMinContextLimitPct` | 内核默认 `0.45` | Nudge 窗口下界（用量占比）——与 billion-context-pi 相同的默认值 |
-| `nudgeMaxContextLimitPct` | 内核默认 `0.75` | 过限线：超过此值则无论增长与否都触发 nudge |
-| `nudgeEmergencyThresholdPct` | 内核默认 `0.95` | 紧急 nudge（绕过每轮去重） |
-| `coreOverrides` | — | 任何其他 acp-kernel `Config` 覆盖（billion-context-pi 的 `coreOverrides` 逃生口） |
-| `autoTools` | `true` | 在 `ctx.tools` 注册四个模型工具 |
-| `autoCommand` | `true` | 在 `ctx.commands` 注册 `/acp` 命令 |
-| `autoNudge` | `true` | 当内核建议时向 `agent/pre-step` 注入 nudge |
-
-## 开发
-
-```bash
-npm install
-npm run typecheck   # 严格 TS
-npm test            # node --import tsx --test tests/*.test.ts
-npm run build       # tsup 打包（内联 acp-kernel）+ .d.ts
-```
-
-`dist/index.js` 自包含，仅外链 `@deepseek-ai/*` 接缝包（由宿主部署提供）。
-
-## 架构
-
-```
-src/
-├── index.ts        # AcpCompactionEngine（CompactionEngine 后端）+ 接线
-├── messages.ts     # M1: 会话事件 ↔ acp-kernel CoreMessage 投影
-├── state.ts        # M2: 每会话内核状态
-├── region.ts       # M5: 持久化区域事务 + 日志重建块账本
-├── tools.ts        # M3: compress / decompress / search_context / acp_status
-├── nudge.ts        # M4: 内核压力决策 → 注入的建议式 nudge
-├── system-prompt.ts# M4: 一次性 ACP 指引段（让 nudge 保持简短）
-├── config.ts       # 内核配置组装（阈值 + coreOverrides）
-└── commands.ts     # M4: /acp 斜杠命令
-```
-
-## License
-
-MIT