dsh-retrace 0.4.7 → 0.4.9

package/lib/dynamic-host.js

@@ -187,13 +187,37 @@ return {
         return session
       }
     
-      function requireIdle(agent) {
-        if (agent && typeof agent.status === 'string' && agent.status === 'running') {
-          throw editorError(
-            'agent-busy',
-            'The agent is still responding. Stop the current reply before recalling or editing.',
-          )
+      /**
+       * 确保 agent 空闲（2026-08-30 事故闭环，用户方案落地）：agent 正在响应时，
+       * **不拒绝**——自动请求停止（`agent.cancel`）并等待其干净收尾（`whenIdle`）。
+       *
+       * 为什么必须等停止：编辑/重发发生在 agent 还开着 step 时，DSH 的 resend 机制
+       * 会把旧 step 的 assistant/chunk 全部引用进新 assistant/message 的
+       * `sourceEventSeqs`（526f1835 seq 936047：引用跨 turn 54 的 step 7/8/9），
+       * token-meter 对跨 step 引用抛 `belongs to another step`（dsh-token-meter
+       * lib/index.js:645）→ 同样刷屏压垮 host。先停止 → step 干净关闭 → 编辑在
+       * 轮次边界执行，不再触发跨 step 引用。
+       *
+       * agent 无 cancel/whenIdle（headless/测试桩）时回退为抛 agent-busy（原行为）。
+       */
+      async function ensureIdle(agent) {
+        if (!agent || typeof agent.status !== 'string' || agent.status !== 'running') return
+        if (typeof agent.cancel === 'function' && typeof agent.whenIdle === 'function') {
+          try {
+            // 官方 AgentCancelCause 类型只有 user/parent/hook/disposed 四种
+            // （dsh-commands typert.host.js:166）——用 { kind: 'user' } 与 UI 停止按钮同义，
+            // 中断的 turn/end 会按官方语义记录 reason。
+            agent.cancel({ kind: 'user' })
+            await agent.whenIdle()
+            return
+          } catch (error) {
+            throw editorError('agent-stop-failed', `Failed to stop the running reply before editing: ${String(error)}`)
+          }
         }
+        throw editorError(
+          'agent-busy',
+          'The agent is still responding. Stop the current reply before recalling or editing.',
+        )
       }
     
       /** Locate the durable seq of a user/assistant message by its stable message id. */
@@ -328,7 +352,7 @@ return {
         const sessionId = String(args?.sessionId ?? '')
         const messageId = String(args?.messageId ?? '')
         const session = requireSession(sessionId)
-        requireIdle(agents.get(sessionId))
+        await ensureIdle(agents.get(sessionId))
         const seq = findMessageSeq(session, messageId)
         if (seq === -1) throw editorError('message-not-found', 'Message not found in this session.')
         const span = roundSpanFrom(session, seq)
@@ -358,7 +382,7 @@ return {
         const fromScratch = args?.fromScratch === true
         const session = requireSession(sessionId)
         const agent = agents.get(sessionId)
-        requireIdle(agent)
+        await ensureIdle(agent)
         const seq = findMessageSeq(session, messageId)
         if (seq === -1) throw editorError('message-not-found', 'Message not found in this session.')
         const event = session.events[seq]
@@ -399,7 +423,7 @@ return {
         const messageId = String(args?.messageId ?? '')
         const session = requireSession(sessionId)
         const agent = agents.get(sessionId)
-        requireIdle(agent)
+        await ensureIdle(agent)
         const seq = findMessageSeq(session, messageId)
         if (seq === -1) throw editorError('message-not-found', 'Message not found in this session.')
         const event = session.events[seq]

package/lib/host-core.js

@@ -178,13 +178,37 @@ export function createEditorApi(ctx, sessions, agents, log = () => {}, hooks = {
     return session
   }
 
-  function requireIdle(agent) {
-    if (agent && typeof agent.status === 'string' && agent.status === 'running') {
-      throw editorError(
-        'agent-busy',
-        'The agent is still responding. Stop the current reply before recalling or editing.',
-      )
+  /**
+   * 确保 agent 空闲（2026-08-30 事故闭环，用户方案落地）：agent 正在响应时，
+   * **不拒绝**——自动请求停止（`agent.cancel`）并等待其干净收尾（`whenIdle`）。
+   *
+   * 为什么必须等停止：编辑/重发发生在 agent 还开着 step 时，DSH 的 resend 机制
+   * 会把旧 step 的 assistant/chunk 全部引用进新 assistant/message 的
+   * `sourceEventSeqs`（526f1835 seq 936047：引用跨 turn 54 的 step 7/8/9），
+   * token-meter 对跨 step 引用抛 `belongs to another step`（dsh-token-meter
+   * lib/index.js:645）→ 同样刷屏压垮 host。先停止 → step 干净关闭 → 编辑在
+   * 轮次边界执行，不再触发跨 step 引用。
+   *
+   * agent 无 cancel/whenIdle（headless/测试桩）时回退为抛 agent-busy（原行为）。
+   */
+  async function ensureIdle(agent) {
+    if (!agent || typeof agent.status !== 'string' || agent.status !== 'running') return
+    if (typeof agent.cancel === 'function' && typeof agent.whenIdle === 'function') {
+      try {
+        // 官方 AgentCancelCause 类型只有 user/parent/hook/disposed 四种
+        // （dsh-commands typert.host.js:166）——用 { kind: 'user' } 与 UI 停止按钮同义，
+        // 中断的 turn/end 会按官方语义记录 reason。
+        agent.cancel({ kind: 'user' })
+        await agent.whenIdle()
+        return
+      } catch (error) {
+        throw editorError('agent-stop-failed', `Failed to stop the running reply before editing: ${String(error)}`)
+      }
     }
+    throw editorError(
+      'agent-busy',
+      'The agent is still responding. Stop the current reply before recalling or editing.',
+    )
   }
 
   /** Locate the durable seq of a user/assistant message by its stable message id. */
@@ -319,7 +343,7 @@ export function createEditorApi(ctx, sessions, agents, log = () => {}, hooks = {
     const sessionId = String(args?.sessionId ?? '')
     const messageId = String(args?.messageId ?? '')
     const session = requireSession(sessionId)
-    requireIdle(agents.get(sessionId))
+    await ensureIdle(agents.get(sessionId))
     const seq = findMessageSeq(session, messageId)
     if (seq === -1) throw editorError('message-not-found', 'Message not found in this session.')
     const span = roundSpanFrom(session, seq)
@@ -349,7 +373,7 @@ export function createEditorApi(ctx, sessions, agents, log = () => {}, hooks = {
     const fromScratch = args?.fromScratch === true
     const session = requireSession(sessionId)
     const agent = agents.get(sessionId)
-    requireIdle(agent)
+    await ensureIdle(agent)
     const seq = findMessageSeq(session, messageId)
     if (seq === -1) throw editorError('message-not-found', 'Message not found in this session.')
     const event = session.events[seq]
@@ -390,7 +414,7 @@ export function createEditorApi(ctx, sessions, agents, log = () => {}, hooks = {
     const messageId = String(args?.messageId ?? '')
     const session = requireSession(sessionId)
     const agent = agents.get(sessionId)
-    requireIdle(agent)
+    await ensureIdle(agent)
     const seq = findMessageSeq(session, messageId)
     if (seq === -1) throw editorError('message-not-found', 'Message not found in this session.')
     const event = session.events[seq]

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-retrace",
   "description": "Retrace · 回溯 — Recall, edit-and-resend, regenerate, and conversation/artifact versioning (timeline, rollback, fork map) for DeepSeek Harness — Web and Desktop",
-  "version": "0.4.7",
+  "version": "0.4.9",
   "type": "module",
   "main": "lib/index.js",
   "types": "lib/types/index.d.ts",