@muyichengshayu/promptx 0.2.16 → 0.2.18

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 0.2.18
+
+- 源码浏览新增行作者提示：查看代码时默认启用 Git blame，鼠标悬停到源码行会在本行下方靠右显示最近修改作者、提交摘要、短 hash 与时间；非 Git 仓库、未跟踪文件、大文件和二进制文件会平稳降级为不可用提示。
+
+## 0.2.17
+
+- 修复 Windows 上 Codex 任务实际完成后工作台仍显示运行中、任务卡片持续转圈的问题：runner 在收到 `turn.completed` 后会进入短暂收尾等待；如果 Codex 子进程没有及时退出，会按完成状态落库并回收子进程，避免成功任务长时间卡在 `running`。
+
 ## 0.2.16
 
 - 修复中栏历史 Prompt 卡片点击“插入”时图片丢失的问题：现在会优先按结构化 `promptBlocks` 插入文本、导入块和图片，图文混合 Prompt 会完整进入右侧编辑区；仅图片的 Prompt 也会插入为图片块，不再退化成 URL 文本。

package/apps/runner/src/codex.js

@@ -21,6 +21,14 @@ const STATE_DB_PATH = path.join(CODEX_HOME, 'state_5.sqlite')
 const TMP_DIR = path.join(CODEX_HOME, 'tmp')
 const MAX_THREAD_COUNT = 120
 const MAX_OUTPUT_TAIL_LENGTH = 64 * 1024
+const CODEX_RESULT_EXIT_GRACE_MS = Math.max(
+  0,
+  Number(process.env.PROMPTX_CODEX_RESULT_EXIT_GRACE_MS) || 3000
+)
+const CODEX_RESULT_FORCE_STOP_GRACE_MS = Math.max(
+  200,
+  Number(process.env.PROMPTX_CODEX_RESULT_FORCE_STOP_GRACE_MS) || 1500
+)
 const CODEX_DEFAULT_ARGS = ['--dangerously-bypass-approvals-and-sandbox', '--skip-git-repo-check']
 const RESOLVED_CODEX_BIN = resolveCodexBinary()
 const require = createRequire(import.meta.url)
@@ -335,6 +343,25 @@ function trackThreadId(event, setThreadId) {
   }
 }
 
+function extractCodexCompletionMessage(event = {}) {
+  if (event?.type === AGENT_RUN_EVENT_TYPES.TURN_COMPLETED) {
+    return extractTextFromUnknownError(event.result)
+      || extractTextFromUnknownError(event.message)
+      || extractTextFromUnknownError(event.response)
+  }
+
+  if (
+    event?.type === AGENT_RUN_EVENT_TYPES.ITEM_COMPLETED
+    && event?.item?.type === 'agent_message'
+  ) {
+    return extractTextFromUnknownError(event.item.text)
+      || extractTextFromUnknownError(event.item.message)
+      || extractTextFromUnknownError(event.item.content)
+  }
+
+  return ''
+}
+
 function parseThreadIdFromStdout(stdout = '') {
   const lines = String(stdout || '')
     .replace(/\r\n/g, '\n')
@@ -430,6 +457,74 @@ export function streamPromptToCodexSession(sessionInput, prompt, callbacks = {})
   let stderrRaw = ''
   let finalMessage = ''
   let finalThreadId = session.codexThreadId || ''
+  let resultExitGraceTimer = null
+  let settled = false
+  let resolveResult = null
+  let rejectResult = null
+
+  const clearResultExitGraceTimer = () => {
+    if (resultExitGraceTimer) {
+      clearTimeout(resultExitGraceTimer)
+      resultExitGraceTimer = null
+    }
+  }
+
+  const readOutputFileMessage = () => {
+    if (!fs.existsSync(outputFile)) {
+      return ''
+    }
+
+    return repairPossibleMojibake(fs.readFileSync(outputFile, 'utf8').trim())
+  }
+
+  const refreshFinalMessageFromOutputFile = () => {
+    finalMessage = readOutputFileMessage() || finalMessage
+  }
+
+  const settleCompleted = (options = {}) => {
+    if (settled) {
+      return
+    }
+
+    settled = true
+    clearResultExitGraceTimer()
+    refreshFinalMessageFromOutputFile()
+    if (!finalThreadId) {
+      finalThreadId = parseThreadIdFromStdout(stdoutRaw)
+    }
+    emit(createCompletedEnvelopeEvent(finalMessage))
+    resolveResult?.({
+      sessionId: session.id,
+      message: finalMessage,
+      threadId: finalThreadId,
+    })
+
+    if (options.stopChild && child.exitCode === null && child.signalCode === null) {
+      forceStopChildProcess(child, { graceMs: CODEX_RESULT_FORCE_STOP_GRACE_MS })
+    }
+  }
+
+  const settleError = (error) => {
+    if (settled) {
+      return
+    }
+
+    settled = true
+    clearResultExitGraceTimer()
+    rejectResult?.(error)
+  }
+
+  const scheduleResultExitGrace = () => {
+    if (settled || resultExitGraceTimer || CODEX_RESULT_EXIT_GRACE_MS <= 0) {
+      return
+    }
+
+    resultExitGraceTimer = setTimeout(() => {
+      resultExitGraceTimer = null
+      settleCompleted({ stopChild: true })
+    }, CODEX_RESULT_EXIT_GRACE_MS)
+    resultExitGraceTimer.unref?.()
+  }
 
   const emit = (event) => {
     try {
@@ -471,6 +566,10 @@ export function streamPromptToCodexSession(sessionInput, prompt, callbacks = {})
       if (event) {
         trackThreadId(event, rememberThreadId)
         emit(createAgentEventEnvelopeEvent(sanitizeCodexPayload(event)))
+        finalMessage = extractCodexCompletionMessage(event) || finalMessage
+        if (event.type === AGENT_RUN_EVENT_TYPES.TURN_COMPLETED) {
+          scheduleResultExitGrace()
+        }
         continue
       }
 
@@ -494,11 +593,18 @@ export function streamPromptToCodexSession(sessionInput, prompt, callbacks = {})
   child.stdin.end()
 
   const result = new Promise((resolve, reject) => {
+    resolveResult = resolve
+    rejectResult = reject
+
     child.on('error', (error) => {
-      reject(normalizeSpawnError(error))
+      settleError(normalizeSpawnError(error))
     })
 
     child.on('close', (code) => {
+      if (settled) {
+        return
+      }
+
       const stdoutTail = flushBufferedText(stdoutBuffer)
       const stderrTail = flushBufferedText(stderrBuffer)
 
@@ -507,6 +613,10 @@ export function streamPromptToCodexSession(sessionInput, prompt, callbacks = {})
         if (event) {
           trackThreadId(event, rememberThreadId)
           emit(createAgentEventEnvelopeEvent(sanitizeCodexPayload(event)))
+          finalMessage = extractCodexCompletionMessage(event) || finalMessage
+          if (event.type === AGENT_RUN_EVENT_TYPES.TURN_COMPLETED) {
+            scheduleResultExitGrace()
+          }
         } else {
           emit(createStdoutEnvelopeEvent(repairPossibleMojibake(line)))
         }
@@ -516,26 +626,14 @@ export function streamPromptToCodexSession(sessionInput, prompt, callbacks = {})
         emit(createStderrEnvelopeEvent(repairPossibleMojibake(line)))
       })
 
-      if (fs.existsSync(outputFile)) {
-        finalMessage = repairPossibleMojibake(fs.readFileSync(outputFile, 'utf8').trim())
-      }
-
-      if (!finalThreadId) {
-        finalThreadId = parseThreadIdFromStdout(stdoutRaw)
-      }
+      refreshFinalMessageFromOutputFile()
 
       if (code !== 0) {
-        reject(new Error(repairPossibleMojibake(extractCodexError(stderrRaw, stdoutRaw))))
+        settleError(new Error(repairPossibleMojibake(extractCodexError(stderrRaw, stdoutRaw))))
         return
       }
 
-      emit(createCompletedEnvelopeEvent(finalMessage))
-
-      resolve({
-        sessionId: session.id,
-        message: finalMessage,
-        threadId: finalThreadId,
-      })
+      settleCompleted()
     })
   }).finally(() => {
     fs.rmSync(outputFile, { force: true })

package/apps/runner/src/engines/claudeCodeRunner.test.js

@@ -0,0 +1,467 @@
+import test from 'node:test'
+import assert from 'node:assert/strict'
+
+import {
+  createClaudeNormalizationState,
+  extractClaudeAssistantText,
+  extractClaudeResultText,
+  extractClaudeSessionId,
+  normalizeClaudeEvent,
+  normalizeClaudeEvents,
+} from './claudeCodeRunner.js'
+
+test('runner claudeCodeRunner maps fatal auth api_retry to error event', () => {
+  assert.deepEqual(
+    normalizeClaudeEvents({
+      type: 'system',
+      subtype: 'api_retry',
+      attempt: 1,
+      max_retries: 10,
+      error_status: 401,
+      error: 'authentication_failed',
+    }),
+    [{
+      type: 'error',
+      message: 'Claude Code 认证失败（HTTP 401 authentication_failed）。请重新登录 Claude Code，或检查当前环境中的认证令牌配置。',
+    }]
+  )
+})
+
+test('runner claudeCodeRunner maps transient api_retry to reconnecting error event', () => {
+  assert.deepEqual(
+    normalizeClaudeEvents({
+      type: 'system',
+      subtype: 'api_retry',
+      attempt: 2,
+      max_retries: 10,
+      error_status: 503,
+      error: 'overloaded',
+    }),
+    [{
+      type: 'error',
+      message: 'Reconnecting... 2/10 (HTTP 503 overloaded)',
+    }]
+  )
+})
+
+test('runner claudeCodeRunner maps Agent sub-agents into collaboration events', () => {
+  const state = createClaudeNormalizationState()
+
+  assert.deepEqual(
+    normalizeClaudeEvents({
+      type: 'assistant',
+      message: {
+        content: [
+          {
+            type: 'tool_use',
+            id: 'agent-tool-1',
+            name: 'Agent',
+            input: {
+              description: 'Analyze a.js exports',
+              subagent_type: 'general-purpose',
+              prompt: 'Analyze a.js in the current directory.',
+              model: 'sonnet',
+            },
+          },
+        ],
+      },
+    }, state),
+    [{
+      type: 'item.started',
+      item: {
+        type: 'collab_tool_call',
+        tool: 'spawn_agent',
+        receiver_thread_ids: [],
+        prompt: 'Analyze a.js in the current directory.',
+        agents_states: {},
+      },
+    }]
+  )
+
+  assert.deepEqual(
+    normalizeClaudeEvents({
+      type: 'system',
+      subtype: 'task_started',
+      tool_use_id: 'agent-tool-1',
+      task_id: 'task-a',
+      description: 'Analyze a.js exports',
+    }, state),
+    [{
+      type: 'item.completed',
+      item: {
+        type: 'collab_tool_call',
+        tool: 'spawn_agent',
+        receiver_thread_ids: ['task-a'],
+        prompt: 'Analyze a.js in the current directory.',
+        agents_states: {
+          'task-a': {
+            status: 'running',
+            message: '',
+            title: 'Analyze a.js exports',
+            role: 'general-purpose',
+            target: 'a.js',
+            model: 'sonnet',
+            task_id: 'task-a',
+          },
+        },
+      },
+    }]
+  )
+})
+
+test('runner claudeCodeRunner maps task_completed and ignores duplicate tool_result for Agent sub-agents', () => {
+  const state = createClaudeNormalizationState()
+
+  normalizeClaudeEvents({
+    type: 'assistant',
+    message: {
+      content: [
+        {
+          type: 'tool_use',
+          id: 'agent-tool-2',
+          name: 'Agent',
+          input: {
+            description: 'Analyze b.js exports',
+            subagent_type: 'general-purpose',
+            prompt: 'Analyze b.js in the current directory.',
+            model: 'sonnet',
+          },
+        },
+      ],
+    },
+  }, state)
+
+  normalizeClaudeEvents({
+    type: 'system',
+    subtype: 'task_started',
+    tool_use_id: 'agent-tool-2',
+    task_id: 'task-b',
+    description: 'Analyze b.js exports',
+  }, state)
+
+  assert.deepEqual(
+    normalizeClaudeEvents({
+      type: 'system',
+      subtype: 'task_completed',
+      task_id: 'task-b',
+      result: 'found 2 exports',
+      description: 'Analyze b.js exports',
+    }, state),
+    [{
+      type: 'item.completed',
+      item: {
+        type: 'collab_tool_call',
+        tool: 'wait',
+        receiver_thread_ids: ['task-b'],
+        prompt: 'Analyze b.js in the current directory.',
+        agents_states: {
+          'task-b': {
+            status: 'completed',
+            message: 'found 2 exports',
+            title: 'Analyze b.js exports',
+            role: 'general-purpose',
+            target: 'b.js',
+            model: 'sonnet',
+            task_id: 'task-b',
+          },
+        },
+      },
+    }]
+  )
+
+  assert.deepEqual(
+    normalizeClaudeEvents({
+      type: 'user',
+      message: {
+        content: [
+          {
+            type: 'tool_result',
+            tool_use_id: 'agent-tool-2',
+            content: 'duplicate result',
+            is_error: false,
+          },
+        ],
+      },
+    }, state),
+    []
+  )
+})
+
+test('runner claudeCodeRunner maps TodoWrite into todo_list events', () => {
+  const state = createClaudeNormalizationState()
+
+  assert.deepEqual(
+    normalizeClaudeEvents({
+      type: 'assistant',
+      message: {
+        content: [
+          {
+            type: 'tool_use',
+            id: 'todo-tool-1',
+            name: 'TodoWrite',
+            input: {
+              todos: [
+                {
+                  content: 'Inspect relevant backend and admin codepaths',
+                  activeForm: 'Inspecting relevant backend and admin codepaths',
+                  status: 'in_progress',
+                },
+                {
+                  content: 'Implement hospital database model and admin APIs',
+                  status: 'pending',
+                },
+                {
+                  content: 'Add tests',
+                  status: 'completed',
+                },
+              ],
+            },
+          },
+        ],
+      },
+    }, state),
+    [{
+      type: 'item.started',
+      item: {
+        type: 'todo_list',
+        items: [
+          {
+            text: 'Inspecting relevant backend and admin codepaths',
+            status: 'in_progress',
+            completed: false,
+          },
+          {
+            text: 'Implement hospital database model and admin APIs',
+            status: 'pending',
+            completed: false,
+          },
+          {
+            text: 'Add tests',
+            status: 'completed',
+            completed: true,
+          },
+        ],
+      },
+    }]
+  )
+
+  assert.deepEqual(
+    normalizeClaudeEvents({
+      type: 'user',
+      message: {
+        content: [
+          {
+            type: 'tool_result',
+            tool_use_id: 'todo-tool-1',
+            content: 'Todos have been modified successfully.',
+            is_error: false,
+          },
+        ],
+      },
+    }, state),
+    [{
+      type: 'item.completed',
+      item: {
+        type: 'todo_list',
+        items: [
+          {
+            text: 'Inspecting relevant backend and admin codepaths',
+            status: 'in_progress',
+            completed: false,
+          },
+          {
+            text: 'Implement hospital database model and admin APIs',
+            status: 'pending',
+            completed: false,
+          },
+          {
+            text: 'Add tests',
+            status: 'completed',
+            completed: true,
+          },
+        ],
+      },
+    }]
+  )
+})
+
+test('extractClaudeAssistantText joins nested text parts', () => {
+  const text = extractClaudeAssistantText({
+    type: 'assistant',
+    message: {
+      content: [
+        { type: 'text', text: '第一段' },
+        { type: 'text', text: '第二段' },
+      ],
+    },
+  })
+
+  assert.equal(text, '第一段\n第二段')
+})
+
+test('extractClaudeSessionId reads common session id fields', () => {
+  assert.equal(extractClaudeSessionId({ session_id: 'claude-session-1' }), 'claude-session-1')
+  assert.equal(extractClaudeSessionId({ result: { session_id: 'claude-session-2' } }), 'claude-session-2')
+})
+
+test('normalizeClaudeEvent maps assistant output to agent message', () => {
+  assert.deepEqual(
+    normalizeClaudeEvent({
+      type: 'assistant',
+      message: {
+        content: [{ type: 'text', text: '已完成修改' }],
+      },
+    }),
+    {
+      type: 'item.completed',
+      item: {
+        type: 'agent_message',
+        text: '已完成修改',
+      },
+    }
+  )
+})
+
+test('normalizeClaudeEvent maps result output to turn completion', () => {
+  assert.deepEqual(
+    normalizeClaudeEvent({
+      type: 'result',
+      result: '最终回复',
+    }),
+    {
+      type: 'turn.completed',
+      result: '最终回复',
+    }
+  )
+
+  assert.equal(extractClaudeResultText({ result: '最终回复' }), '最终回复')
+})
+
+test('normalizeClaudeEvents maps system init to thread start', () => {
+  assert.deepEqual(
+    normalizeClaudeEvents({
+      type: 'system',
+      subtype: 'init',
+      session_id: 'claude-session-init',
+    }),
+    [{
+      type: 'thread.started',
+      thread_id: 'claude-session-init',
+    }]
+  )
+})
+
+test('normalizeClaudeEvents maps thinking, tool use and text blocks', () => {
+  const state = createClaudeNormalizationState()
+
+  assert.deepEqual(
+    normalizeClaudeEvents({
+      type: 'assistant',
+      message: {
+        content: [
+          { type: 'thinking', thinking: '先看看目录结构' },
+          { type: 'tool_use', id: 'tool-1', name: 'Bash', input: { command: 'ls -1' } },
+          { type: 'text', text: '已查看完成' },
+        ],
+      },
+    }, state),
+    [
+      {
+        type: 'item.started',
+        item: {
+          type: 'reasoning',
+          text: '先看看目录结构',
+        },
+      },
+      {
+        type: 'item.started',
+        item: {
+          type: 'command_execution',
+          command: 'Bash: ls -1',
+          status: 'in_progress',
+        },
+      },
+      {
+        type: 'item.completed',
+        item: {
+          type: 'agent_message',
+          text: '已查看完成',
+        },
+      },
+    ]
+  )
+})
+
+test('normalizeClaudeEvents maps tool results back to remembered tool call', () => {
+  const state = createClaudeNormalizationState()
+  normalizeClaudeEvents({
+    type: 'assistant',
+    message: {
+      content: [
+        { type: 'tool_use', id: 'tool-2', name: 'Bash', input: { command: 'pwd' } },
+      ],
+    },
+  }, state)
+
+  assert.deepEqual(
+    normalizeClaudeEvents({
+      type: 'user',
+      message: {
+        content: [
+          { type: 'tool_result', tool_use_id: 'tool-2', content: '/tmp/demo', is_error: false },
+        ],
+      },
+    }, state),
+    [{
+      type: 'item.completed',
+      item: {
+        type: 'command_execution',
+        command: 'Bash: pwd',
+        status: 'completed',
+        exit_code: 0,
+        aggregated_output: '/tmp/demo',
+      },
+    }]
+  )
+})
+
+test('normalizeClaudeEvents stringifies structured tool results', () => {
+  const state = createClaudeNormalizationState()
+  normalizeClaudeEvents({
+    type: 'assistant',
+    message: {
+      content: [
+        { type: 'tool_use', id: 'tool-3', name: 'Read', input: { file_path: '/tmp/demo.txt' } },
+      ],
+    },
+  }, state)
+
+  assert.deepEqual(
+    normalizeClaudeEvents({
+      type: 'user',
+      message: {
+        content: [
+          {
+            type: 'tool_result',
+            tool_use_id: 'tool-3',
+            content: [
+              { type: 'text', text: '<path>/tmp/demo.txt</path>' },
+              { type: 'text', text: '<type>file</type>' },
+            ],
+          },
+        ],
+      },
+    },
+    state),
+    [{
+      type: 'item.completed',
+      item: {
+        type: 'command_execution',
+        command: 'Read: /tmp/demo.txt',
+        status: 'completed',
+        exit_code: 0,
+        aggregated_output: '<path>/tmp/demo.txt</path>\n<type>file</type>',
+      },
+    }]
+  )
+})