dsh-loop-engine 1.0.0-rc13 → 1.0.0-rc14

package/README.md

@@ -34,13 +34,10 @@ matched — a mismatch fails loudly at boot or session resume:
 
 | dsh-loop-engine | Requires harness |
 |---|---|
-| 1.0.0-rc13 | **0.1.2-rc.1** |
-| 1.0.0-rc12 | **0.1.2-rc.1** |
-| 1.0.0-rc11 | **0.1.2-rc.1** |
-| 1.0.0-rc10 | **0.1.2-rc.1** |
-| 1.0.0-rc7 | 0.1.1-rc.2 |
+| 1.0.0-rc8 and later | **0.1.2-rc.1** |
+| 1.0.0-rc7 and earlier | 0.1.1-rc.2 |
 
-- **1.0.0-rc13 (and rc12 / rc11 / rc10 / rc9 / rc8) is not compatible with harness 0.1.1-rc.2 or earlier.** It uses
+- **1.0.0-rc8 and later is not compatible with harness 0.1.1-rc.2 or earlier.** It uses
   the 0.1.2 persistence seam (`SessionPersistence.create` / `open` +
   `SessionHandle`), the `installSection` settings API, `ToolCallId`, and
   `Session.snapshotEvents()` — none of which exist in older harnesses.

package/README.zh.md

@@ -21,6 +21,19 @@ dsh plugin --profile web add dsh-loop-engine
 - 使用 Pi 引擎时需要以 `pi` 要求的方式完成认证(其自身的 `~/.pi/agent/auth.json`,或提供方的 API-key 环境变量,如 `ANTHROPIC_API_KEY`)。
 - 使用 Kimi Code 引擎时需要本机已安装并登录 `kimi` CLI(例如 `kimi login`),且在 `PATH` 上(或在组合条目里用 `kimiBin` 固定为绝对路径)。
 
+## 版本兼容
+
+`dsh-loop-engine` 与 harness **独立**版本(`1.0.0-rcN`),但通过 `peerDependencies` 绑定到特定 harness 版本;两者必须匹配——不匹配会在启动或会话恢复时响亮地失败:
+
+| dsh-loop-engine | 需要 harness |
+|---|---|
+| 1.0.0-rc8 及以后 | **0.1.2-rc.1** |
+| 1.0.0-rc7 及更早 | 0.1.1-rc.2 |
+
+- **1.0.0-rc8 及以后不兼容 harness 0.1.1-rc.2 或更早版本。** 它使用 0.1.2 的持久化 seam(`SessionPersistence.create` / `open` + `SessionHandle`)、`installSection` settings API、`ToolCallId` 与 `Session.snapshotEvents()` —— 这些在更老的 harness 里都不存在。
+- 要在更老的 harness 上使用本插件,请安装与之匹配的 loop-engine 版本(例如 harness 0.1.1-rc.2 用 `npm i dsh-loop-engine@1.0.0-rc7`)。
+- 每个 tag 的 GitHub Release 正文会写明它针对的 harness 版本。
+
 ## 使用方法
 
 1. 在 **Settings → Loop engine** 选择引擎——`in-process`(默认)、`claude-code`、`codex`、`pi` 或 `kimi`——然后重启 `dsh web`。

package/lib/index.js

@@ -1347,6 +1347,11 @@ var ClaudeCodeLoop = class extends Service {
     const handle = await persistence.create(session.header, {
       inheritedEventCount: session.inheritedEventCount,
       ...signal === void 0 ? {} : { signal }
+    }).catch((error) => {
+      if (error instanceof TypeError && error.message.includes("SessionLogOffset")) {
+        return persistence.create(session.header, session.inheritedEventCount);
+      }
+      throw error;
     });
     return { handle, storedCount: 0 };
   }
@@ -1395,26 +1400,38 @@ var ClaudeCodeLoop = class extends Service {
       let preparation;
       try {
         try {
-          handle = await raceAbortCall(
-            () => persistence.open(id, "write", { signal: fused }),
-            fused,
-            id,
-            (abandoned) => {
-              void abandoned.close();
-            }
-          );
-          const persisted = await handle.read(0, void 0, { signal: fused });
-          fused.throwIfAborted();
-          const closers = interruptedTurnClosers(persisted);
-          if (closers.length > 0) await handle.append(closers);
-          preparation = SessionPreparation.create(this.runtime.ctx.sessions.prepare(id, {
-            seed: [...persisted, ...closers],
-            meta: structuredClone(handle.header),
-            inheritedEventCount: handle.inheritedEventCount,
-            seedSource: "persistence"
-          }));
-          stored = { handle, storedCount: persisted.length + closers.length };
-          await this.appendUnstoredSuffix(stored, preparation.session);
+          if (typeof persistence.open === "function") {
+            handle = await raceAbortCall(
+              () => persistence.open(id, "write", { signal: fused }),
+              fused,
+              id,
+              (abandoned) => {
+                void abandoned.close();
+              }
+            );
+            const persisted = await handle.read(0, void 0, { signal: fused });
+            fused.throwIfAborted();
+            const closers = interruptedTurnClosers(persisted);
+            if (closers.length > 0) await handle.append(closers);
+            preparation = SessionPreparation.create(this.runtime.ctx.sessions.prepare(id, {
+              seed: [...persisted, ...closers],
+              meta: structuredClone(handle.header),
+              inheritedEventCount: handle.inheritedEventCount,
+              seedSource: "persistence"
+            }));
+            stored = { handle, storedCount: persisted.length + closers.length };
+            await this.appendUnstoredSuffix(stored, preparation.session);
+          } else {
+            const publishedApi = persistence;
+            preparation = await raceAbortCall(
+              () => publishedApi.prepare(id, fused),
+              fused,
+              id,
+              (abandoned) => {
+                abandoned?.[Symbol.dispose]?.();
+              }
+            );
+          }
         } finally {
           await unfollowOwner();
         }
@@ -2573,6 +2590,11 @@ var CodexLoop = class extends Service2 {
     const handle = await persistence.create(session.header, {
       inheritedEventCount: session.inheritedEventCount,
       ...signal === void 0 ? {} : { signal }
+    }).catch((error) => {
+      if (error instanceof TypeError && error.message.includes("SessionLogOffset")) {
+        return persistence.create(session.header, session.inheritedEventCount);
+      }
+      throw error;
     });
     return { handle, storedCount: 0 };
   }
@@ -2621,26 +2643,38 @@ var CodexLoop = class extends Service2 {
       let preparation;
       try {
         try {
-          handle = await raceAbortCall(
-            () => persistence.open(id, "write", { signal: fused }),
-            fused,
-            id,
-            (abandoned) => {
-              void abandoned.close();
-            }
-          );
-          const persisted = await handle.read(0, void 0, { signal: fused });
-          fused.throwIfAborted();
-          const closers = interruptedTurnClosers2(persisted);
-          if (closers.length > 0) await handle.append(closers);
-          preparation = SessionPreparation2.create(this.runtime.ctx.sessions.prepare(id, {
-            seed: [...persisted, ...closers],
-            meta: structuredClone(handle.header),
-            inheritedEventCount: handle.inheritedEventCount,
-            seedSource: "persistence"
-          }));
-          stored = { handle, storedCount: persisted.length + closers.length };
-          await this.appendUnstoredSuffix(stored, preparation.session);
+          if (typeof persistence.open === "function") {
+            handle = await raceAbortCall(
+              () => persistence.open(id, "write", { signal: fused }),
+              fused,
+              id,
+              (abandoned) => {
+                void abandoned.close();
+              }
+            );
+            const persisted = await handle.read(0, void 0, { signal: fused });
+            fused.throwIfAborted();
+            const closers = interruptedTurnClosers2(persisted);
+            if (closers.length > 0) await handle.append(closers);
+            preparation = SessionPreparation2.create(this.runtime.ctx.sessions.prepare(id, {
+              seed: [...persisted, ...closers],
+              meta: structuredClone(handle.header),
+              inheritedEventCount: handle.inheritedEventCount,
+              seedSource: "persistence"
+            }));
+            stored = { handle, storedCount: persisted.length + closers.length };
+            await this.appendUnstoredSuffix(stored, preparation.session);
+          } else {
+            const publishedApi = persistence;
+            preparation = await raceAbortCall(
+              () => publishedApi.prepare(id, fused),
+              fused,
+              id,
+              (abandoned) => {
+                abandoned?.[Symbol.dispose]?.();
+              }
+            );
+          }
         } finally {
           await unfollowOwner();
         }
@@ -3906,6 +3940,11 @@ var PiLoop = class extends Service3 {
     const handle = await persistence.create(session.header, {
       inheritedEventCount: session.inheritedEventCount,
       ...signal === void 0 ? {} : { signal }
+    }).catch((error) => {
+      if (error instanceof TypeError && error.message.includes("SessionLogOffset")) {
+        return persistence.create(session.header, session.inheritedEventCount);
+      }
+      throw error;
     });
     return { handle, storedCount: 0 };
   }
@@ -3954,26 +3993,38 @@ var PiLoop = class extends Service3 {
       let preparation;
       try {
         try {
-          handle = await raceAbortCall(
-            () => persistence.open(id, "write", { signal: fused }),
-            fused,
-            id,
-            (abandoned) => {
-              void abandoned.close();
-            }
-          );
-          const persisted = await handle.read(0, void 0, { signal: fused });
-          fused.throwIfAborted();
-          const closers = interruptedTurnClosers3(persisted);
-          if (closers.length > 0) await handle.append(closers);
-          preparation = SessionPreparation3.create(this.runtime.ctx.sessions.prepare(id, {
-            seed: [...persisted, ...closers],
-            meta: structuredClone(handle.header),
-            inheritedEventCount: handle.inheritedEventCount,
-            seedSource: "persistence"
-          }));
-          stored = { handle, storedCount: persisted.length + closers.length };
-          await this.appendUnstoredSuffix(stored, preparation.session);
+          if (typeof persistence.open === "function") {
+            handle = await raceAbortCall(
+              () => persistence.open(id, "write", { signal: fused }),
+              fused,
+              id,
+              (abandoned) => {
+                void abandoned.close();
+              }
+            );
+            const persisted = await handle.read(0, void 0, { signal: fused });
+            fused.throwIfAborted();
+            const closers = interruptedTurnClosers3(persisted);
+            if (closers.length > 0) await handle.append(closers);
+            preparation = SessionPreparation3.create(this.runtime.ctx.sessions.prepare(id, {
+              seed: [...persisted, ...closers],
+              meta: structuredClone(handle.header),
+              inheritedEventCount: handle.inheritedEventCount,
+              seedSource: "persistence"
+            }));
+            stored = { handle, storedCount: persisted.length + closers.length };
+            await this.appendUnstoredSuffix(stored, preparation.session);
+          } else {
+            const publishedApi = persistence;
+            preparation = await raceAbortCall(
+              () => publishedApi.prepare(id, fused),
+              fused,
+              id,
+              (abandoned) => {
+                abandoned?.[Symbol.dispose]?.();
+              }
+            );
+          }
         } finally {
           await unfollowOwner();
         }
@@ -5020,6 +5071,11 @@ var KimiLoop = class extends Service4 {
     const handle = await persistence.create(session.header, {
       inheritedEventCount: session.inheritedEventCount,
       ...signal === void 0 ? {} : { signal }
+    }).catch((error) => {
+      if (error instanceof TypeError && error.message.includes("SessionLogOffset")) {
+        return persistence.create(session.header, session.inheritedEventCount);
+      }
+      throw error;
     });
     return { handle, storedCount: 0 };
   }
@@ -5068,26 +5124,38 @@ var KimiLoop = class extends Service4 {
       let preparation;
       try {
         try {
-          handle = await raceAbortCall(
-            () => persistence.open(id, "write", { signal: fused }),
-            fused,
-            id,
-            (abandoned) => {
-              void abandoned.close();
-            }
-          );
-          const persisted = await handle.read(0, void 0, { signal: fused });
-          fused.throwIfAborted();
-          const closers = interruptedTurnClosers4(persisted);
-          if (closers.length > 0) await handle.append(closers);
-          preparation = SessionPreparation4.create(this.runtime.ctx.sessions.prepare(id, {
-            seed: [...persisted, ...closers],
-            meta: structuredClone(handle.header),
-            inheritedEventCount: handle.inheritedEventCount,
-            seedSource: "persistence"
-          }));
-          stored = { handle, storedCount: persisted.length + closers.length };
-          await this.appendUnstoredSuffix(stored, preparation.session);
+          if (typeof persistence.open === "function") {
+            handle = await raceAbortCall(
+              () => persistence.open(id, "write", { signal: fused }),
+              fused,
+              id,
+              (abandoned) => {
+                void abandoned.close();
+              }
+            );
+            const persisted = await handle.read(0, void 0, { signal: fused });
+            fused.throwIfAborted();
+            const closers = interruptedTurnClosers4(persisted);
+            if (closers.length > 0) await handle.append(closers);
+            preparation = SessionPreparation4.create(this.runtime.ctx.sessions.prepare(id, {
+              seed: [...persisted, ...closers],
+              meta: structuredClone(handle.header),
+              inheritedEventCount: handle.inheritedEventCount,
+              seedSource: "persistence"
+            }));
+            stored = { handle, storedCount: persisted.length + closers.length };
+            await this.appendUnstoredSuffix(stored, preparation.session);
+          } else {
+            const publishedApi = persistence;
+            preparation = await raceAbortCall(
+              () => publishedApi.prepare(id, fused),
+              fused,
+              id,
+              (abandoned) => {
+                abandoned?.[Symbol.dispose]?.();
+              }
+            );
+          }
         } finally {
           await unfollowOwner();
         }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-loop-engine",
   "description": "Web-switchable agent loop engine selection for the DeepSeek Harness - out-of-tree plugin (Claude Code / Codex / Pi / Kimi Code drivers) maintained by @kuun993, zero main-repo changes",
-  "version": "1.0.0-rc13",
+  "version": "1.0.0-rc14",
   "publishConfig": {
     "access": "public"
   },