billion-context-dsh 0.2.18 → 0.2.19

package/README.en.md

@@ -3,7 +3,7 @@
 [English](./README.en.md) | [中文](./README.md)
 
 > **⚠️ Beta notice — not for production use**
-> This project (**v0.2.18**) 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.
+> This project (**v0.2.19**) 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 ⭐:
@@ -98,7 +98,7 @@ This only installs the package into your project/global store; it does **not** t
 **Install from the git source (`github:` spec — the form the plugin store shows).** The prebuilt `dist/` artifacts are committed to this repository, so a git-source install also works out of the box — **no build step needed**, and pnpm 11's default build-script blocking (`allowBuilds`) never applies to this package:
 
 ```bash
-dsh plugin --profile web add github:Tyan66666/billion-context-dsh#v0.2.18
+dsh plugin --profile web add github:Tyan66666/billion-context-dsh#v0.2.19
 ```
 
 Prefer a `#<tag>` ref to get artifacts identical to that npm release; without a ref you get the latest default-branch build. Only building the repo yourself (`npm run build`) requires approving build scripts. Background and trade-offs: [docs/git-source-install-design.md](docs/git-source-install-design.md) (issue #92).

package/README.md

@@ -3,7 +3,7 @@
 [中文](./README.md) | [English](./README.en.md)
 
 > **⚠️ 测试版声明——请勿用于生产环境**
-> 本项目（**v0.2.18**）仍处于开发中的测试版。[DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) 本身也处于**公开测试版**阶段。**请勿将两者用于工程化 / 生产环境**——预期会有破坏性变更与粗糙之处。
+> 本项目（**v0.2.19**）仍处于开发中的测试版。[DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) 本身也处于**公开测试版**阶段。**请勿将两者用于工程化 / 生产环境**——预期会有破坏性变更与粗糙之处。
 
 <p align="center">
 <strong>衷心感谢以下项目——请给它们一个 ⭐：</strong>
@@ -97,7 +97,7 @@ npm install billion-context-dsh
 **git 源安装（`github:` 规格，插件商店展示的形态）。** 预构建产物 `dist/` 已提交到仓库，从 git 源安装同样开箱即用——**无需任何构建步骤**，pnpm 11 默认拦截构建脚本（`allowBuilds`）的机制对这个包不构成障碍：
 
 ```bash
-dsh plugin --profile web add github:Tyan66666/billion-context-dsh#v0.2.18
+dsh plugin --profile web add github:Tyan66666/billion-context-dsh#v0.2.19
 ```
 
 建议带 `#<tag>` 安装，拿到与对应 npm 版本完全一致的产物；不带 ref 则装默认分支的最新构建。只有 clone 仓库自行从源码构建（`npm run build`）才需要放行构建。背景与方案取舍见 [docs/git-source-install-design.md](docs/git-source-install-design.md)（issue #92）。

package/dist/index.js

@@ -2881,7 +2881,7 @@ function assertNoActiveCompaction(events) {
     else if (event.type === "compaction/end") active = false;
   }
   if (active) {
-    throw new Error("billion-context-dsh: another compaction is already active for this session");
+    console.warn("billion-context-dsh: clearing stale compaction flag \u2014 found a compaction/start with no matching compaction/end");
   }
 }
 function hasPlainRef(session, seq) {
@@ -3012,31 +3012,49 @@ function runCompactionTransaction(session, input) {
   const turn = findOpenTurn(sessionEventsOf(session));
   const compactionId = CompactionId(randomUUID());
   const seqs = [];
-  seqs.push(session.append("compaction/start", { compactionId, turn }).seq);
-  seqs.push(session.append("compaction/summary", {
-    compactionId,
-    summary: input.summary,
-    shadowedRange: { start: input.start, end: input.end },
-    shadowedSeqs: [...input.shadowedSeqs],
-    shadowedTokenCount: input.shadowedTokenCount,
-    provider: input.provider,
-    model: input.model,
-    tier: input.tier ?? 1,
-    ...input.kernelBlockId === void 0 ? {} : { kernelBlockId: input.kernelBlockId },
-    ...input.topic === void 0 ? {} : { topic: input.topic },
-    ...input.parentBlockIds === void 0 || input.parentBlockIds.length === 0 ? {} : { parentBlockIds: [...input.parentBlockIds] },
-    ...input.directMessageIds === void 0 ? {} : { directMessageIds: [...input.directMessageIds] },
-    ...input.effectiveMessageIds === void 0 ? {} : { effectiveMessageIds: [...input.effectiveMessageIds] }
-  }).seq);
-  const message = createUserMessage({
-    content: input.summary,
-    source: compactCheckpointSource(compactionId)
-  });
-  seqs.push(session.append("user/message", message, {
-    surfaceOp: { op: "replace", start: input.start, end: input.end },
-    sourceEventSeqs: [...input.shadowedSeqs]
-  }).seq);
-  seqs.push(session.append("compaction/end", { compactionId, turn }).seq);
+  if (input.start > input.end) {
+    throw new Error(`billion-context-dsh: reversed range ${input.start}..${input.end}`);
+  }
+  if (eventAtOf(session, input.start) === void 0 || eventAtOf(session, input.end) === void 0) {
+    const failedEdge = eventAtOf(session, input.start) === void 0 ? input.start : input.end;
+    throw new Error(
+      `billion-context-dsh: seq ${input.start}..${input.end} not in the current surface \u2014 edge seq ${failedEdge} is not in this session's log. Surface seqs are sparse message nodes (only user/message, assistant/message, tool/result events); consult acp_status for the current surface range`
+    );
+  }
+  try {
+    seqs.push(session.append("compaction/start", { compactionId, turn }).seq);
+    seqs.push(session.append("compaction/summary", {
+      compactionId,
+      summary: input.summary,
+      shadowedRange: { start: input.start, end: input.end },
+      shadowedSeqs: [...input.shadowedSeqs],
+      shadowedTokenCount: input.shadowedTokenCount,
+      provider: input.provider,
+      model: input.model,
+      tier: input.tier ?? 1,
+      ...input.kernelBlockId === void 0 ? {} : { kernelBlockId: input.kernelBlockId },
+      ...input.topic === void 0 ? {} : { topic: input.topic },
+      ...input.parentBlockIds === void 0 || input.parentBlockIds.length === 0 ? {} : { parentBlockIds: [...input.parentBlockIds] },
+      ...input.directMessageIds === void 0 ? {} : { directMessageIds: [...input.directMessageIds] },
+      ...input.effectiveMessageIds === void 0 ? {} : { effectiveMessageIds: [...input.effectiveMessageIds] }
+    }).seq);
+    const message = createUserMessage({
+      content: input.summary,
+      source: compactCheckpointSource(compactionId)
+    });
+    seqs.push(session.append("user/message", message, {
+      surfaceOp: { op: "replace", start: input.start, end: input.end },
+      sourceEventSeqs: [...input.shadowedSeqs]
+    }).seq);
+    seqs.push(session.append("compaction/end", { compactionId, turn }).seq);
+  } catch (error) {
+    try {
+      session.append("compaction/end", { compactionId, turn });
+    } catch (compensateError) {
+      console.warn("billion-context-dsh: failed to write a compensating compaction/end", compensateError);
+    }
+    throw error;
+  }
   return { compactionId, seqs };
 }
 function summarySeqOfCompaction(events, compactionId) {