dsh-session-guard 3.2.3 → 4.0.0

package/src/store.js

@@ -1,77 +1,77 @@
-/**
- * dsh-session-guard — 每会话持久化状态存储（学 dsh-task-control 的独立存储模式，D4）。
- *
- * 暂停/锁定状态不写 session log（harness 持久化 reader 只认已知事件类型），
- * 改为插件自有 JSON 文件：`$DSH_HOME/.dsh/session-guard/<sessionId>.json`
- * （可用 DSH_SESSION_GUARD_STATE_DIR 覆盖根目录）。原子写：tmp + rename。
- */
-import { existsSync, mkdirSync, readFileSync, renameSync, rmSync, writeFileSync } from 'node:fs'
-import { dirname, join } from 'node:path'
-
-/** 状态根目录。 */
-export function storeRoot() {
-  return (
-    process.env.DSH_SESSION_GUARD_STATE_DIR ||
-    join(process.env.DSH_HOME || process.env.HOME || process.cwd(), '.dsh', 'session-guard')
-  )
-}
-
-/** 会话 id → 安全文件名。 */
-function encodeSessionId(id) {
-  return String(id).replace(/[^a-zA-Z0-9._-]/g, '_')
-}
-
-/** 每会话状态文件路径。 */
-export function stateFilePath(id) {
-  return join(storeRoot(), `${encodeSessionId(id)}.json`)
-}
-
-/** 未锁定基线。 */
-export function idleState(id) {
-  return { sessionId: String(id), queueLocked: false, lockReason: null, updatedAt: null }
-}
-
-/**
- * 创建存储（内存缓存 + 磁盘持久化）。
- */
-export function createStore() {
-  const cache = new Map()
-  return {
-    /** 读一会话状态；无记录返回 null（调用方自行 fallback idleState）。 */
-    get(id) {
-      if (cache.has(id)) return cache.get(id)
-      try {
-        const f = stateFilePath(id)
-        if (!existsSync(f)) return null
-        const v = JSON.parse(readFileSync(f, 'utf8'))
-        cache.set(id, v)
-        return v
-      } catch {
-        return null
-      }
-    },
-    /** 原子写。 */
-    set(id, value) {
-      cache.set(id, value)
-      try {
-        const f = stateFilePath(id)
-        mkdirSync(dirname(f), { recursive: true })
-        const tmp = `${f}.tmp`
-        writeFileSync(tmp, JSON.stringify(value, null, 2))
-        renameSync(tmp, f)
-      } catch (e) {
-        // 落盘失败仅影响重启恢复，内存态仍可用。
-        console.error(`[session-guard] store write failed: ${String(e && e.message || e)}`)
-      }
-    },
-    /** 清除（解锁时）。 */
-    clear(id) {
-      cache.delete(id)
-      try {
-        rmSync(stateFilePath(id), { force: true })
-      } catch {
-        /* ignore */
-      }
-    },
-  }
-}
+/**
+ * dsh-session-guard — 每会话持久化状态存储（学 dsh-task-control 的独立存储模式，D4）。
+ *
+ * 暂停/锁定状态不写 session log（harness 持久化 reader 只认已知事件类型），
+ * 改为插件自有 JSON 文件：`$DSH_HOME/.dsh/session-guard/<sessionId>.json`
+ * （可用 DSH_SESSION_GUARD_STATE_DIR 覆盖根目录）。原子写：tmp + rename。
+ */
+import { existsSync, mkdirSync, readFileSync, renameSync, rmSync, writeFileSync } from 'node:fs'
+import { dirname, join } from 'node:path'
+
+/** 状态根目录。 */
+export function storeRoot() {
+  return (
+    process.env.DSH_SESSION_GUARD_STATE_DIR ||
+    join(process.env.DSH_HOME || process.env.HOME || process.cwd(), '.dsh', 'session-guard')
+  )
+}
+
+/** 会话 id → 安全文件名。 */
+function encodeSessionId(id) {
+  return String(id).replace(/[^a-zA-Z0-9._-]/g, '_')
+}
+
+/** 每会话状态文件路径。 */
+export function stateFilePath(id) {
+  return join(storeRoot(), `${encodeSessionId(id)}.json`)
+}
+
+/** 未锁定基线。 */
+export function idleState(id) {
+  return { sessionId: String(id), queueLocked: false, lockReason: null, updatedAt: null }
+}
+
+/**
+ * 创建存储（内存缓存 + 磁盘持久化）。
+ */
+export function createStore() {
+  const cache = new Map()
+  return {
+    /** 读一会话状态；无记录返回 null（调用方自行 fallback idleState）。 */
+    get(id) {
+      if (cache.has(id)) return cache.get(id)
+      try {
+        const f = stateFilePath(id)
+        if (!existsSync(f)) return null
+        const v = JSON.parse(readFileSync(f, 'utf8'))
+        cache.set(id, v)
+        return v
+      } catch {
+        return null
+      }
+    },
+    /** 原子写。 */
+    set(id, value) {
+      cache.set(id, value)
+      try {
+        const f = stateFilePath(id)
+        mkdirSync(dirname(f), { recursive: true })
+        const tmp = `${f}.tmp`
+        writeFileSync(tmp, JSON.stringify(value, null, 2))
+        renameSync(tmp, f)
+      } catch (e) {
+        // 落盘失败仅影响重启恢复，内存态仍可用。
+        console.error(`[session-guard] store write failed: ${String(e && e.message || e)}`)
+      }
+    },
+    /** 清除（解锁时）。 */
+    clear(id) {
+      cache.delete(id)
+      try {
+        rmSync(stateFilePath(id), { force: true })
+      } catch {
+        /* ignore */
+      }
+    },
+  }
+}

package/src/tool-call-id.js

@@ -1,17 +1,19 @@
 /**
- * dsh-session-guard — `tool/result` 调用 id 的双形态读取（**零依赖**，可单测）。
+ * dsh-session-guard — `tool/result` 调用 id 的多形态读取（**零依赖**，可单测）。
  *
- * 为什么需要它：DSH 0.1.1-rc.2 与 0.1.2-rc.1 的 `session/event` 形状一致
- * （已逐行核对 `packages/session/session-persistence/src/coordinator.ts` 的
- * `tool/result` 分支，两版本都保留两种形态），但**同一条记录有两种历史形态**：
+ * 形状代际（2026-09-27 v4 适配订正；engines.dsh ≥0.1.7-rc.1）：
  *
- * - 现行形态：`event.data.message.content[].toolCallId`（`tool-result` 块）；
- * - 遗留形态：`event.data.message.source.callId`（旧记录经持久化协调器迁移后的
- *   形态，两版本的回放日志里都可能出现）。
+ * - **v4 native（现行，必读）**：`event.data.message` 为一等 `role:'tool'` 消息，
+ *   `toolCallId` 在 message 顶层（`ToolResultMessage`，0.1.7-rc.2 dsh-llm
+ *   message.d.ts 实证）。v4 解码 native-only，`type:'tool-result'` 块被宿主
+ *   `assertBlock` 硬拒——**本文件的第一读取顺位**。
+ * - v3 wrapper（历史兼容）：`event.data.message.content[].toolCallId`
+ *   （`tool-result` 块）。未迁移的 v3 日志读侧仍可见。
+ * - 遗留形态：`event.data.message.source.callId`（旧记录经持久化协调器迁移）。
  *
- * 读取顺序：优先块上的 `toolCallId`（更精确），缺失才回退 `source.callId`。
- * **不要改成单读**——只读块会在旧记录上丢 id（in-flight 工具无法落地），
- * 只读 `source.callId` 会在新记录上丢 id（暂停点判定失效）。
+ * 读取顺序：native 顶层 `toolCallId` → 块上 `toolCallId` → `source.callId`。
+ * **不要改成单读**——只读一层会在其它代际的记录上丢 id（in-flight 工具无法落地
+ * / 暂停点判定失效）。
  *
  * 本文件刻意不导入任何 `@deepseek-ai/*` 包，因此可在没有 DSH 运行时依赖的
  * 环境下直接单测（见 `tests/tool-call-id.test.mjs`）。
@@ -20,10 +22,12 @@
 /**
  * 读一条 `tool/result` 记录（`event.data.message`）的调用 id。
  * @param {unknown} message - `event.data.message`（可能缺失或非对象）
- * @returns {string|undefined} 调用 id；两种形态都缺时返回 undefined
+ * @returns {string|undefined} 调用 id；各形态都缺时返回 undefined
  */
 export function readToolResultCallId(message) {
   if (message === null || typeof message !== 'object') return undefined
+  // v4 native：一等 tool-role 消息，id 在顶层。
+  if (typeof message.toolCallId === 'string') return message.toolCallId
   const content = Array.isArray(message.content) ? message.content : []
   for (const block of content) {
     if (block?.type === 'tool-result' && typeof block.toolCallId === 'string') return block.toolCallId

package/src/wiring.js

@@ -197,7 +197,7 @@ export function createWiring({
         id: `session-guard-deferred-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`,
         role: 'user',
         content: [{ type: 'text', text }],
-        source: { kind: 'plugin', plugin: 'session-guard', form: 'notice' },
+        source: { kind: 'plugin:session-guard', form: 'notice' },
       })
       return true
     } catch (e) {