dsh-session-guard 3.2.3 → 4.0.0

package/src/client/styles.ts

@@ -1,30 +1,30 @@
-/**
- * dsh-session-guard — 客户端样式（与 composer 右侧 input-traffic 冻结按钮同一视觉语言）。
- *
- * 为什么注入 `<style>` 而不是 CSS Modules：本插件的 tsdown 配置没有 CSS Modules 管线
- * （input-traffic 有），而 settings-card 已经用 `<style data-plugin-css>` 的既有约定。
- * 这里只做一件事：把「暂停会话 / 继续会话」按钮与状态徽标对齐到同一行的其它控件
- * （高度 24px、圆角 6px、12px 字号、同样的 border / hover / pressed 令牌）。
- */
-
-/** 与 `dsh-input-traffic/src/client/freeze-button.module.css` 对齐的控件外观。 */
-export const CLIENT_CSS = `
-.sg-pause{display:inline-flex;align-items:center;gap:4px;height:24px;padding:0 8px;border:1px solid var(--dsw-alias-border-l3,rgba(0,0,0,.12));border-radius:6px;background:transparent;color:var(--dsw-alias-label-secondary,#6b7280);font-size:12px;line-height:1;cursor:pointer;white-space:nowrap;flex:none}
-.sg-pause:hover:not(:disabled){background:var(--dsw-alias-interactive-bg-hover,rgba(0,0,0,.04))}
-.sg-pause:disabled{opacity:.55;cursor:default}
-.sg-pause[aria-pressed='true']{border-color:var(--dsw-alias-state-warning-primary,#d97706);color:var(--dsw-alias-state-warning-primary,#d97706);background:color-mix(in srgb,var(--dsw-alias-state-warning-primary,#d97706) 8%,transparent)}
-.sg-status{display:inline-flex;align-items:center;height:24px;padding:0 8px;border:1px solid var(--dsw-alias-border-l3,rgba(0,0,0,.12));border-radius:6px;font-size:12px;line-height:1;color:var(--dsw-alias-label-secondary,#6b7280);white-space:nowrap;flex:none}
-.sg-status.sg-peak{border-color:var(--dsw-alias-state-warning-primary,#d97706);color:var(--dsw-alias-state-warning-primary,#d97706)}
-.sg-status.sg-weekend{border-color:var(--dsw-alias-state-success-primary,#30a46c);color:var(--dsw-alias-state-success-primary,#30a46c)}
-`
-
-/** 注入一次（幂等；无 document 时静默跳过）。 */
-export function injectClientCss(): void {
-  if (typeof document === 'undefined') return
-  if (document.querySelector('style[data-plugin-css="session-guard-client"]') !== null) return
-  const tag = document.createElement('style')
-  tag.dataset.plugin = 'dsh-session-guard'
-  tag.dataset.pluginCss = 'session-guard-client'
-  tag.textContent = CLIENT_CSS
-  document.head.appendChild(tag)
-}
+/**
+ * dsh-session-guard — 客户端样式（与 composer 右侧 input-traffic 冻结按钮同一视觉语言）。
+ *
+ * 为什么注入 `<style>` 而不是 CSS Modules：本插件的 tsdown 配置没有 CSS Modules 管线
+ * （input-traffic 有），而 settings-card 已经用 `<style data-plugin-css>` 的既有约定。
+ * 这里只做一件事：把「暂停会话 / 继续会话」按钮与状态徽标对齐到同一行的其它控件
+ * （高度 24px、圆角 6px、12px 字号、同样的 border / hover / pressed 令牌）。
+ */
+
+/** 与 `dsh-input-traffic/src/client/freeze-button.module.css` 对齐的控件外观。 */
+export const CLIENT_CSS = `
+.sg-pause{display:inline-flex;align-items:center;gap:4px;height:24px;padding:0 8px;border:1px solid var(--dsw-alias-border-l3,rgba(0,0,0,.12));border-radius:6px;background:transparent;color:var(--dsw-alias-label-secondary,#6b7280);font-size:12px;line-height:1;cursor:pointer;white-space:nowrap;flex:none}
+.sg-pause:hover:not(:disabled){background:var(--dsw-alias-interactive-bg-hover,rgba(0,0,0,.04))}
+.sg-pause:disabled{opacity:.55;cursor:default}
+.sg-pause[aria-pressed='true']{border-color:var(--dsw-alias-state-warning-primary,#d97706);color:var(--dsw-alias-state-warning-primary,#d97706);background:color-mix(in srgb,var(--dsw-alias-state-warning-primary,#d97706) 8%,transparent)}
+.sg-status{display:inline-flex;align-items:center;height:24px;padding:0 8px;border:1px solid var(--dsw-alias-border-l3,rgba(0,0,0,.12));border-radius:6px;font-size:12px;line-height:1;color:var(--dsw-alias-label-secondary,#6b7280);white-space:nowrap;flex:none}
+.sg-status.sg-peak{border-color:var(--dsw-alias-state-warning-primary,#d97706);color:var(--dsw-alias-state-warning-primary,#d97706)}
+.sg-status.sg-weekend{border-color:var(--dsw-alias-state-success-primary,#30a46c);color:var(--dsw-alias-state-success-primary,#30a46c)}
+`
+
+/** 注入一次（幂等；无 document 时静默跳过）。 */
+export function injectClientCss(): void {
+  if (typeof document === 'undefined') return
+  if (document.querySelector('style[data-plugin-css="session-guard-client"]') !== null) return
+  const tag = document.createElement('style')
+  tag.dataset.plugin = 'dsh-session-guard'
+  tag.dataset.pluginCss = 'session-guard-client'
+  tag.textContent = CLIENT_CSS
+  document.head.appendChild(tag)
+}

package/src/detect.js

@@ -1,27 +1,27 @@
-/**
- * dsh-session-guard — 自动检测（D7，诚实边界）。
- *
- * - host 可自动探测：`ctx.get('taskControl')`（会话门）、`ctx.get('sessionGuard')`。
- * - client 可自动探测：input-traffic 补的「最小桥」标记 `window.__DSH_SESSION_GUARD_BRIDGE__`
- *   （方案 A 中 input-traffic 冻结按钮触发时会调 sessionGuard.stopNextTurn）。
- *   探测不到 → 本插件客户端使用自带回退冻结（fallback），fail-open 不报错（D8）。
- */
-
-/** host：会话门（dsh-task-control）是否可用。 */
-export function detectTaskControl(ctx) {
-  return !!(ctx && typeof ctx.get === 'function' && ctx.get('taskControl'))
-}
-
-/** host：sessionGuard 服务是否已提供（其他插件探测用）。 */
-export function detectSessionGuard(ctx) {
-  return !!(ctx && typeof ctx.get === 'function' && ctx.get('sessionGuard'))
-}
-
-/**
- * client：input-traffic 最小桥是否已注册。
- * @param {object} [g] 显式传入全局对象（便于测试）；默认 globalThis
- */
-export function detectInputTrafficBridge(g) {
-  const root = g || (typeof globalThis !== 'undefined' ? globalThis : {})
-  return !!(root && root.__DSH_SESSION_GUARD_BRIDGE__ && typeof root.__DSH_SESSION_GUARD_BRIDGE__.stopNextTurn === 'function')
-}
+/**
+ * dsh-session-guard — 自动检测（D7，诚实边界）。
+ *
+ * - host 可自动探测：`ctx.get('taskControl')`（会话门）、`ctx.get('sessionGuard')`。
+ * - client 可自动探测：input-traffic 补的「最小桥」标记 `window.__DSH_SESSION_GUARD_BRIDGE__`
+ *   （方案 A 中 input-traffic 冻结按钮触发时会调 sessionGuard.stopNextTurn）。
+ *   探测不到 → 本插件客户端使用自带回退冻结（fallback），fail-open 不报错（D8）。
+ */
+
+/** host：会话门（dsh-task-control）是否可用。 */
+export function detectTaskControl(ctx) {
+  return !!(ctx && typeof ctx.get === 'function' && ctx.get('taskControl'))
+}
+
+/** host：sessionGuard 服务是否已提供（其他插件探测用）。 */
+export function detectSessionGuard(ctx) {
+  return !!(ctx && typeof ctx.get === 'function' && ctx.get('sessionGuard'))
+}
+
+/**
+ * client：input-traffic 最小桥是否已注册。
+ * @param {object} [g] 显式传入全局对象（便于测试）；默认 globalThis
+ */
+export function detectInputTrafficBridge(g) {
+  const root = g || (typeof globalThis !== 'undefined' ? globalThis : {})
+  return !!(root && root.__DSH_SESSION_GUARD_BRIDGE__ && typeof root.__DSH_SESSION_GUARD_BRIDGE__.stopNextTurn === 'function')
+}

package/src/gate.js

@@ -1,93 +1,93 @@
-/**
- * dsh-session-guard — 会话门驱动（D3/D5/D6，自研真实锁定）。
- *
- * **主路径**（替换 dsh-task-control）：经自研 `pauseGate` 真暂停 session 推进——
- * `pauseGate.pause(id,{mode,reason})` 调用 agent.cancel / goals.pause / session/event
- * 安全边界落地（见 src/pause-gate.js），不再依赖 `ctx.get('taskControl')`，也不再退化成
- * 只写 `queueLocked` 标记。
- *
- * **降级路径**（fail-open，D8）：仅当自研暂停因 agent 不可用而失败时，按 `queueFallback`
- * 回退为只锁等待队列（`queueLocked` 持久化标记，供前端/重试让路）。
- *
- * resume 对称：自研 resume（从暂停点续跑）或清 queueLock。
- */
-import { idleState } from './store.js'
-
-/**
- * @param {object} deps
- * @param {()=>object|null} deps.getCtx 取当前 host ctx（懒，便于测试）
- * @param {()=>object} deps.getSettings 读实时配置（pauseMode/pauseReason）
- * @param {ReturnType<import('./store.js').createStore>} deps.store 持久化队列锁
- * @param {ReturnType<import('./pause-gate.js').createPauseGate>} [deps.pauseGate] 自研会话门引擎
- * @param {(event:string, sessionId:string, payload?:object)=>void} [deps.emit] 状态变化通知
- */
-export function createGate({ getCtx: _getCtx, getSettings, store, pauseGate, emit }) {
-  function lockQueue(sessionId, reason) {
-    const cur = store.get(sessionId)
-    const next = { ...(cur || idleState(sessionId)), queueLocked: true, lockReason: reason, updatedAt: Date.now() }
-    store.set(sessionId, next)
-    if (emit) emit('queue-lock', sessionId, { reason })
-    return next
-  }
-
-  function unlockQueue(sessionId) {
-    const cur = store.get(sessionId)
-    const next = { ...(cur || idleState(sessionId)), queueLocked: false, lockReason: null, updatedAt: Date.now() }
-    store.set(sessionId, next)
-    if (emit) emit('queue-unlock', sessionId)
-    return next
-  }
-
-  /**
-   * 停掉 session 的下一回合（真实锁定推进）。
-   * ① 自研 pauseGate.pause（真暂停）；② 自研失败/agent 不可用 → 按 queueFallback 降级锁队列。
-   * @param {string} sessionId
-   * @param {object} [opts] { mode, reason }
-   */
-  async function stopNextTurn(sessionId, opts = {}) {
-    const cfg = getSettings()
-    if (pauseGate) {
-      try {
-        const mode = opts.mode ?? cfg.pauseMode ?? 'safe'
-        const reason = opts.reason ?? cfg.pauseReason ?? 'wait'
-        const r = pauseGate.pause(sessionId, { mode, reason })
-        if (r && r.kind === 'success') return { ok: true, via: 'pauseGate', result: r }
-        // kind === 'error'（如 no live agent）→ 落到降级，语义如实上报。
-      } catch {
-        // 自研内部异常 → fail-open 降级，绝不中断冻结动作。
-      }
-    }
-    // 无自研门或自研失败 → 回退只锁等待队列（自带实现，D5）。
-    if (cfg.queueFallback === false) {
-      return { ok: false, via: 'queueLock', error: 'queueFallback disabled' }
-    }
-    lockQueue(sessionId, 'peak')
-    return { ok: true, via: 'queueLock' }
-  }
-
-  /**
-   * 恢复 session 推进（从暂停点续跑）。
-   * ① 自研 resume（confirm + choice）；② 降级清 queueLock。
-   */
-  async function resume(sessionId, opts = {}) {
-    if (pauseGate) {
-      try {
-        const r = pauseGate.resume(sessionId, { confirm: true, choice: opts.choice ?? 'rerun' })
-        if (r && r.kind === 'success') return { ok: true, via: 'pauseGate', result: r }
-      } catch {
-        // 降级清队列锁。
-      }
-    }
-    unlockQueue(sessionId)
-    return { ok: true, via: 'queueLock' }
-  }
-
-  return {
-    stopNextTurn,
-    resume,
-    lockQueue,
-    unlockQueue,
-    /** 自研会话门是否可用（自研后恒视为可用；供 detect/UI 展示）。 */
-    taskControlAvailable: () => (pauseGate ? pauseGate.taskControlAvailable() : false),
-  }
-}
+/**
+ * dsh-session-guard — 会话门驱动（D3/D5/D6，自研真实锁定）。
+ *
+ * **主路径**（替换 dsh-task-control）：经自研 `pauseGate` 真暂停 session 推进——
+ * `pauseGate.pause(id,{mode,reason})` 调用 agent.cancel / goals.pause / session/event
+ * 安全边界落地（见 src/pause-gate.js），不再依赖 `ctx.get('taskControl')`，也不再退化成
+ * 只写 `queueLocked` 标记。
+ *
+ * **降级路径**（fail-open，D8）：仅当自研暂停因 agent 不可用而失败时，按 `queueFallback`
+ * 回退为只锁等待队列（`queueLocked` 持久化标记，供前端/重试让路）。
+ *
+ * resume 对称：自研 resume（从暂停点续跑）或清 queueLock。
+ */
+import { idleState } from './store.js'
+
+/**
+ * @param {object} deps
+ * @param {()=>object|null} deps.getCtx 取当前 host ctx（懒，便于测试）
+ * @param {()=>object} deps.getSettings 读实时配置（pauseMode/pauseReason）
+ * @param {ReturnType<import('./store.js').createStore>} deps.store 持久化队列锁
+ * @param {ReturnType<import('./pause-gate.js').createPauseGate>} [deps.pauseGate] 自研会话门引擎
+ * @param {(event:string, sessionId:string, payload?:object)=>void} [deps.emit] 状态变化通知
+ */
+export function createGate({ getCtx: _getCtx, getSettings, store, pauseGate, emit }) {
+  function lockQueue(sessionId, reason) {
+    const cur = store.get(sessionId)
+    const next = { ...(cur || idleState(sessionId)), queueLocked: true, lockReason: reason, updatedAt: Date.now() }
+    store.set(sessionId, next)
+    if (emit) emit('queue-lock', sessionId, { reason })
+    return next
+  }
+
+  function unlockQueue(sessionId) {
+    const cur = store.get(sessionId)
+    const next = { ...(cur || idleState(sessionId)), queueLocked: false, lockReason: null, updatedAt: Date.now() }
+    store.set(sessionId, next)
+    if (emit) emit('queue-unlock', sessionId)
+    return next
+  }
+
+  /**
+   * 停掉 session 的下一回合（真实锁定推进）。
+   * ① 自研 pauseGate.pause（真暂停）；② 自研失败/agent 不可用 → 按 queueFallback 降级锁队列。
+   * @param {string} sessionId
+   * @param {object} [opts] { mode, reason }
+   */
+  async function stopNextTurn(sessionId, opts = {}) {
+    const cfg = getSettings()
+    if (pauseGate) {
+      try {
+        const mode = opts.mode ?? cfg.pauseMode ?? 'safe'
+        const reason = opts.reason ?? cfg.pauseReason ?? 'wait'
+        const r = pauseGate.pause(sessionId, { mode, reason })
+        if (r && r.kind === 'success') return { ok: true, via: 'pauseGate', result: r }
+        // kind === 'error'（如 no live agent）→ 落到降级，语义如实上报。
+      } catch {
+        // 自研内部异常 → fail-open 降级，绝不中断冻结动作。
+      }
+    }
+    // 无自研门或自研失败 → 回退只锁等待队列（自带实现，D5）。
+    if (cfg.queueFallback === false) {
+      return { ok: false, via: 'queueLock', error: 'queueFallback disabled' }
+    }
+    lockQueue(sessionId, 'peak')
+    return { ok: true, via: 'queueLock' }
+  }
+
+  /**
+   * 恢复 session 推进（从暂停点续跑）。
+   * ① 自研 resume（confirm + choice）；② 降级清 queueLock。
+   */
+  async function resume(sessionId, opts = {}) {
+    if (pauseGate) {
+      try {
+        const r = pauseGate.resume(sessionId, { confirm: true, choice: opts.choice ?? 'rerun' })
+        if (r && r.kind === 'success') return { ok: true, via: 'pauseGate', result: r }
+      } catch {
+        // 降级清队列锁。
+      }
+    }
+    unlockQueue(sessionId)
+    return { ok: true, via: 'queueLock' }
+  }
+
+  return {
+    stopNextTurn,
+    resume,
+    lockQueue,
+    unlockQueue,
+    /** 自研会话门是否可用（自研后恒视为可用；供 detect/UI 展示）。 */
+    taskControlAvailable: () => (pauseGate ? pauseGate.taskControlAvailable() : false),
+  }
+}

package/src/pause-gate.js

@@ -17,9 +17,10 @@
  * 设计为目标可单测：ctx / pauseStore / makeFollowupMessage 全部依赖注入，
  * 停/续/取消判定不依赖真实 dsh runtime；`getAgent(sessionId)` 经 `ctx.agents.get` 懒取。
  *
- * DUAL-VERSION（DSH 0.1.1-rc.2 与 0.1.2-rc.1）：上述扩展点在两版本中签名一致
- * （已逐行核对 `packages/session/session-persistence/src/coordinator.ts`、
- * `packages/core/agent-loop/src/agent.ts`、`packages/goal/goal/src/index.ts`）。
+ * VERSION-LINE（2026-09-27 订正）：本仓 engines.dsh >=0.1.7-rc.1（会话格式 v4）。
+ * 下述扩展点的 0.1.1-rc.2/0.1.2-rc.1 双版本签名核对结论为历史依据，现役契约以
+ * v4 为准（署名 producer-owned kind、tool/result 为一等 role:'tool' 消息，
+ * 见 `tool-call-id.js` 头注的三形状代际表）。
  * 唯一需要双读的是 `tool/result` 记录的调用 id 形态（见 readToolResultCallId）：
  * 0.1.1 与 0.1.2 的回放日志都同时保留 `content[].toolCallId` 与 `source.callId` 两种形态。
  */
@@ -47,7 +48,7 @@ export function createPluginUserMessage({ content, source }) {
 }
 
 /**
- * 恢复消息入队（0.1.5 compat 双路径）。
+ * 恢复消息入队（双路径；双路径判定沿自 0.1.5 代的兼容实测，现役线为 v4）。
  *
  * 0.1.5 把 Inbox 从独立服务改为 agent-loop 只读投影（消息入队走 session 事件），
  * `agent.followup` 是否保留无法静态确认，因此运行时检测：
@@ -157,9 +158,10 @@ export function createPauseGate({ ctx, pauseStore, pluginId = 'session-guard', m
   }
 
   /**
-   * `tool/result` 调用 id 的双形态读取已抽到 `./tool-call-id.js`（零依赖、可单测）：
-   * 优先 `data.message.content[].toolCallId`，回退 `data.message.source.callId`。
-   * 两种形态在 DSH 0.1.1-rc.2 与 0.1.2-rc.1 的回放日志里都保留，勿改成单读。
+   * `tool/result` 调用 id 的多形态读取已抽到 `./tool-call-id.js`（零依赖、可单测），
+   * 三形状代际（详见其头注）：v4 native 顶层 `message.toolCallId` 优先 →
+   * v3 wrapper `content[].toolCallId` → 遗留 `source.callId`。勿改成单读——
+   * 任一单读都会在其它代际的记录上丢 id（in-flight 工具无法落地/暂停点判定失效）。
    */
 
   /**
@@ -189,6 +191,22 @@ export function createPauseGate({ ctx, pauseStore, pluginId = 'session-guard', m
     for (const event of events) {
       if (event.type === 'tool/result') {
         const message = event.data?.message ?? {}
+        // v4 native（≥0.1.7-rc.1）：一等 role:'tool' 消息，toolCallId/isError 在
+        // message 顶层（宿主 assertBlock 硬拒 `type:'tool-result'` 块）。native
+        // 分支是强制新增——漏掉它 isError 恒 false，恢复 followup 会把失败工具
+        // 误报为"已执行完成，不要重复执行"。
+        if (typeof message.toolCallId === 'string') {
+          if (message.toolCallId === callId) {
+            outcome = {
+              hasResult: true,
+              isError: message.isError === true,
+              abortedBeforeDispatch: event.data?.error?.code === 'ABORTED_BEFORE_DISPATCH',
+              content: Array.isArray(message.content) ? message.content : [],
+            }
+          }
+          continue
+        }
+        // v3 wrapper（未迁移日志的历史兼容）。
         const block = (Array.isArray(message.content) ? message.content : []).find((b) => b?.type === 'tool-result')
         const id = readToolResultCallId(message)
         if (id === callId) {
@@ -337,8 +355,9 @@ export function createPauseGate({ ctx, pauseStore, pluginId = 'session-guard', m
     state.pendingPause.delete(sessionId)
     const current = currentPause(sessionId)
     if (!current.paused) return { kind: 'success', text: 'no paused task to resume' }
-    // 0.1.5 compat：source 补 form: 'instructions'（0.1.5 ContextFormed 契约；旧版本忽略未知字段）
-    const followup = (blocks) => enqueueFollowup(agent, makeFollowupMessage({ content: blocks, source: { kind: 'plugin', plugin: pluginId, form: 'instructions' } }), ctx)
+    // form: 'instructions' —— 0.1.5 引入的 ContextFormed 语义字段（旧版本忽略未知字段）；
+    // 署名 kind 已按 v4（≥0.1.7-rc.1）适配为 producer-owned `plugin:${pluginId}`
+    const followup = (blocks) => enqueueFollowup(agent, makeFollowupMessage({ content: blocks, source: { kind: `plugin:${pluginId}`, form: 'instructions' } }), ctx)
 
     if (current.forced) {
       const tool = current.interruptedTool
@@ -462,7 +481,8 @@ export function createPauseGate({ ctx, pauseStore, pluginId = 'session-guard', m
       return
     }
     if (event.type === 'tool/result') {
-      // 双形态双读（见 readToolResultCallId）：块上 toolCallId 优先，旧记录回退 source.callId。
+      // 三形状双读以上（见 readToolResultCallId）：v4 native 顶层 toolCallId 优先，
+      // v3 wrapper 块上次之，旧记录再回退 source.callId。
       const callId = readToolResultCallId(event.data?.message)
       if (typeof callId === 'string') inflightOf(sessionId).delete(callId)
       tryApplyPending(sessionId)

package/src/pause-store.js

@@ -1,101 +1,101 @@
-/**
- * dsh-session-guard — 自研会话门暂停状态持久化（脱离 dsh-task-control）。
- *
- * 与 queueLock（src/store.js，队列锁）分离：这里是「真暂停」的持久化快照，
- * 仿 task-control 的状态模型，但独立子目录 /pause 避免与队列锁文件互相污染。
- *
- * 暂停/锁定状态仍**不写 session log**（harness 持久化 reader 只有已知事件集，
- * 自定义 `session-guard/*` 事件会导致重启后会话无法加载），走插件自有 JSON 文件：
- * `$DSH_HOME/.dsh/session-guard/pause/<sessionId>.json`（`DSH_SESSION_GUARD_PAUSE_DIR`
- * 可覆盖根目录）。原子写：tmp + rename。
- */
-import { existsSync, mkdirSync, readFileSync, renameSync, rmSync, writeFileSync } from 'node:fs'
-import { dirname, join } from 'node:path'
-import { storeRoot } from './store.js'
-
-/** 会话 id → 安全文件名（与队列锁同规则）。 */
-export function encodeSessionId(id) {
-  return String(id).replace(/[^a-zA-Z0-9._-]/g, '_')
-}
-
-/** 自研暂停状态根目录（独立于队列锁）。 */
-export function pauseStateRoot() {
-  return (
-    process.env.DSH_SESSION_GUARD_PAUSE_DIR ||
-    join(storeRoot(), 'pause')
-  )
-}
-
-/** 每会话暂停状态文件路径。 */
-export function pauseFilePath(id) {
-  return join(pauseStateRoot(), `${encodeSessionId(id)}.json`)
-}
-
-/** 未暂停基线快照。 */
-export function idlePauseState(id) {
-  return {
-    sessionId: String(id),
-    paused: false,
-    resumeContent: null,
-    forced: false,
-    interruptedTool: null,
-    deferredTools: null,
-    updatedAt: null,
-  }
-}
-
-/**
- * 创建暂停状态存储（内存缓存 + 磁盘持久化，原子写）。
- * 独立于队列锁 store，字段形态仿 task-control（paused/forced/interruptedTool/deferredTools）。
- */
-export function createPauseStore() {
-  const cache = new Map()
-
-  function read(id) {
-    if (cache.has(id)) return cache.get(id)
-    try {
-      const f = pauseFilePath(id)
-      if (!existsSync(f)) return null
-      const v = JSON.parse(readFileSync(f, 'utf8'))
-      cache.set(id, v)
-      return v
-    } catch {
-      return null
-    }
-  }
-
-  return {
-    /** 读一会话暂停态；无记录返回 null（调用方 fallback idlePauseState）。 */
-    get(id) {
-      return read(id)
-    },
-    /** 原子写。 */
-    set(id, value) {
-      cache.set(id, value)
-      try {
-        const f = pauseFilePath(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] pause store write failed: ${String(e && e.message || e)}`)
-      }
-    },
-    /** 清除（resume/cancel 后）。 */
-    clear(id) {
-      cache.delete(id)
-      try {
-        rmSync(pauseFilePath(id), { force: true })
-      } catch {
-        /* ignore */
-      }
-    },
-    /** 当前有效快照（无记录时 idle 基线）。 */
-    current(id) {
-      const v = read(id)
-      return v !== null && typeof v === 'object' ? v : idlePauseState(id)
-    },
-  }
-}
+/**
+ * dsh-session-guard — 自研会话门暂停状态持久化（脱离 dsh-task-control）。
+ *
+ * 与 queueLock（src/store.js，队列锁）分离：这里是「真暂停」的持久化快照，
+ * 仿 task-control 的状态模型，但独立子目录 /pause 避免与队列锁文件互相污染。
+ *
+ * 暂停/锁定状态仍**不写 session log**（harness 持久化 reader 只有已知事件集，
+ * 自定义 `session-guard/*` 事件会导致重启后会话无法加载），走插件自有 JSON 文件：
+ * `$DSH_HOME/.dsh/session-guard/pause/<sessionId>.json`（`DSH_SESSION_GUARD_PAUSE_DIR`
+ * 可覆盖根目录）。原子写：tmp + rename。
+ */
+import { existsSync, mkdirSync, readFileSync, renameSync, rmSync, writeFileSync } from 'node:fs'
+import { dirname, join } from 'node:path'
+import { storeRoot } from './store.js'
+
+/** 会话 id → 安全文件名（与队列锁同规则）。 */
+export function encodeSessionId(id) {
+  return String(id).replace(/[^a-zA-Z0-9._-]/g, '_')
+}
+
+/** 自研暂停状态根目录（独立于队列锁）。 */
+export function pauseStateRoot() {
+  return (
+    process.env.DSH_SESSION_GUARD_PAUSE_DIR ||
+    join(storeRoot(), 'pause')
+  )
+}
+
+/** 每会话暂停状态文件路径。 */
+export function pauseFilePath(id) {
+  return join(pauseStateRoot(), `${encodeSessionId(id)}.json`)
+}
+
+/** 未暂停基线快照。 */
+export function idlePauseState(id) {
+  return {
+    sessionId: String(id),
+    paused: false,
+    resumeContent: null,
+    forced: false,
+    interruptedTool: null,
+    deferredTools: null,
+    updatedAt: null,
+  }
+}
+
+/**
+ * 创建暂停状态存储（内存缓存 + 磁盘持久化，原子写）。
+ * 独立于队列锁 store，字段形态仿 task-control（paused/forced/interruptedTool/deferredTools）。
+ */
+export function createPauseStore() {
+  const cache = new Map()
+
+  function read(id) {
+    if (cache.has(id)) return cache.get(id)
+    try {
+      const f = pauseFilePath(id)
+      if (!existsSync(f)) return null
+      const v = JSON.parse(readFileSync(f, 'utf8'))
+      cache.set(id, v)
+      return v
+    } catch {
+      return null
+    }
+  }
+
+  return {
+    /** 读一会话暂停态；无记录返回 null（调用方 fallback idlePauseState）。 */
+    get(id) {
+      return read(id)
+    },
+    /** 原子写。 */
+    set(id, value) {
+      cache.set(id, value)
+      try {
+        const f = pauseFilePath(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] pause store write failed: ${String(e && e.message || e)}`)
+      }
+    },
+    /** 清除（resume/cancel 后）。 */
+    clear(id) {
+      cache.delete(id)
+      try {
+        rmSync(pauseFilePath(id), { force: true })
+      } catch {
+        /* ignore */
+      }
+    },
+    /** 当前有效快照（无记录时 idle 基线）。 */
+    current(id) {
+      const v = read(id)
+      return v !== null && typeof v === 'object' ? v : idlePauseState(id)
+    },
+  }
+}

package/src/retry.js

@@ -160,7 +160,7 @@ export function createRetry({ ctx, getSettings, isFrozen, send }) {
             id: `session-guard-retry-${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' },
           })
         }
         s.lastAttemptAt = Date.now()