@muyichengshayu/promptx 0.2.0 → 0.2.1

package/CHANGELOG.md

@@ -1,5 +1,14 @@
 # Changelog
 
+## 0.2.1
+
+- 新增工作台 `shell` 命令模式：在右侧编辑区输入 `!pwd`、`!git status`、`!pnpm test` 这类纯文本命令时，PromptX 会直接按当前选中的 `Codex / Claude Code / OpenCode` 语义发起本地命令执行，并把结果继续收拢回原有的 `PromptX → Agent / Agent` 对话流，不额外引入一套独立的 Shell 卡片心智。
+- 收紧命令模式的安全边界与展示逻辑：命令意图改为由服务端重新解析，不再信任前端直传命令；shell run 固定绑定 root project session，避免污染 member session 的 thread/identity；默认仅本机可用，Relay 需在设置里显式开启“允许远程执行命令模式”后，且仅对带内部标记的 relay 转发请求放行。
+- 为远程命令模式补齐配置与回归测试：Relay 设置页新增高权限开关与明确警告，诊断信息也会带上该配置；同时新增本地允许、远程默认拒绝、仅 relay 显式开启可用、环境变量覆盖等测试，降低后续回归风险。
+- 修复 runner 大事件上报导致任务卡死的问题：内部 runner events 接口提高了 body limit，避免长过程日志或大批量事件刷新时触发 `Request body is too large`，导致一轮任务停在中间。
+- 改进代码变更审查对 Git submodule 的支持：代码变更与 diff review 现在会展开 submodule 内部的真实文件改动，而不再只显示顶层 submodule 占位项；相关任务级、轮次级与子文件明细链路都已补齐测试。
+- 补充开发环境的 `Vite allowedHosts` 配置，方便在代理、局域网或特定本地域名下更稳定地访问工作台开发服务。
+
 ## 0.2.0
 
 - 项目正式升级为多 Agent 协作模型：一个项目可同时绑定 `Codex / Claude Code / OpenCode`，右侧可直接切换本轮发送目标，中栏也支持按 Agent 过滤整轮消息流，适合同一任务里拆分“方案 / 执行 / 复核”等分工。

package/apps/runner/src/engines/index.js

@@ -7,22 +7,32 @@ import {
 import { codexRunner } from './codexRunner.js'
 import { claudeCodeRunner } from './claudeCodeRunner.js'
 import { openCodeRunner } from './openCodeRunner.js'
+import { shellRunner } from './shellRunner.js'
 
 const runnerRegistry = new Map([
   [codexRunner.engine, codexRunner],
   [claudeCodeRunner.engine, claudeCodeRunner],
   [openCodeRunner.engine, openCodeRunner],
+  [shellRunner.engine, shellRunner],
 ])
 
+function normalizeRunnerEngine(engine = AGENT_ENGINES.CODEX) {
+  const normalized = String(engine || '').trim().toLowerCase()
+  if (normalized === shellRunner.engine) {
+    return shellRunner.engine
+  }
+  return normalizeAgentEngine(normalized)
+}
+
 export function getAgentRunner(engine = AGENT_ENGINES.CODEX) {
-  return runnerRegistry.get(normalizeAgentEngine(engine)) || null
+  return runnerRegistry.get(normalizeRunnerEngine(engine)) || null
 }
 
 export function assertAgentRunner(engine = AGENT_ENGINES.CODEX) {
-  const normalized = normalizeAgentEngine(engine)
+  const normalized = normalizeRunnerEngine(engine)
   const runner = getAgentRunner(normalized)
   if (!runner) {
-    throw new Error(`当前还不支持执行引擎：${getAgentEngineLabel(normalized)}`)
+    throw new Error(`当前还不支持执行引擎：${normalized === shellRunner.engine ? shellRunner.label : getAgentEngineLabel(normalized)}`)
   }
   return runner
 }

package/apps/runner/src/engines/shellRunner.js

@@ -0,0 +1,216 @@
+import { spawn } from 'node:child_process'
+import {
+  createAgentEventEnvelopeEvent,
+  createCompletedEnvelopeEvent,
+  createStderrEnvelopeEvent,
+  createStdoutEnvelopeEvent,
+} from '../../../../packages/shared/src/agentRunEnvelopeEvents.js'
+import {
+  AGENT_RUN_EVENT_TYPES,
+  AGENT_RUN_ITEM_TYPES,
+  createItemCompletedEvent,
+  createItemStartedEvent,
+} from '../../../../packages/shared/src/agentRunEvents.js'
+import { createManagedSpawnOptions, forceStopChildProcess } from '../processControl.js'
+
+const SHELL_ENGINE = 'shell'
+const MAX_SHELL_OUTPUT_TAIL_LENGTH = Math.max(
+  16 * 1024,
+  Number(process.env.PROMPTX_SHELL_OUTPUT_TAIL_LENGTH) || 128 * 1024
+)
+
+function appendOutputTail(current = '', chunk = '', maxLength = MAX_SHELL_OUTPUT_TAIL_LENGTH) {
+  const next = `${String(current || '')}${String(chunk || '')}`
+  if (next.length <= maxLength) {
+    return next
+  }
+  return next.slice(next.length - maxLength)
+}
+
+function splitBufferedLines(buffer = '') {
+  const normalized = String(buffer || '')
+  if (!normalized) {
+    return { lines: [], rest: '' }
+  }
+
+  const parts = normalized.split(/\r?\n/g)
+  const rest = /(?:\r?\n)$/.test(normalized) ? '' : parts.pop() || ''
+  return {
+    lines: parts.filter(Boolean),
+    rest,
+  }
+}
+
+function getShellCommand(command = '') {
+  const raw = String(command || '').trim()
+  if (!raw) {
+    return {
+      executable: '',
+      args: [],
+      displayCommand: '',
+    }
+  }
+
+  if (process.platform === 'win32') {
+    const executable = process.env.ComSpec || 'cmd.exe'
+    return {
+      executable,
+      args: ['/d', '/s', '/c', raw],
+      displayCommand: `${executable} /d /s /c ${raw}`,
+    }
+  }
+
+  const executable = process.env.SHELL || '/bin/zsh'
+  return {
+    executable,
+    args: ['-lc', raw],
+    displayCommand: `${executable} -lc ${raw}`,
+  }
+}
+
+function createCommandItem(command = '', status = 'running', aggregatedOutput = '', exitCode = null) {
+  return {
+    type: AGENT_RUN_ITEM_TYPES.COMMAND_EXECUTION,
+    command: String(command || '').trim(),
+    status: String(status || '').trim() || 'running',
+    aggregated_output: String(aggregatedOutput || ''),
+    ...(typeof exitCode === 'number' ? { exit_code: exitCode } : {}),
+  }
+}
+
+export const shellRunner = {
+  engine: SHELL_ENGINE,
+  label: 'Shell',
+  supportsWorkspaceHistory: false,
+  streamSessionPrompt(session, prompt, callbacks = {}) {
+    const command = String(prompt || '').trim()
+    if (!command) {
+      throw new Error('缺少要执行的命令。')
+    }
+
+    const cwd = String(session?.cwd || '').trim()
+    const { executable, args, displayCommand } = getShellCommand(command)
+    if (!executable) {
+      throw new Error('当前环境没有可用的 shell。')
+    }
+
+    const onEvent = typeof callbacks.onEvent === 'function' ? callbacks.onEvent : () => {}
+    const child = spawn(executable, args, createManagedSpawnOptions({ cwd }))
+    let stdoutBuffer = ''
+    let stderrBuffer = ''
+    let outputTail = ''
+    let settled = false
+
+    onEvent(createAgentEventEnvelopeEvent(createItemStartedEvent(createCommandItem(displayCommand, 'running'))))
+
+    const result = new Promise((resolve, reject) => {
+      const rejectWithOutput = (message, payload = {}) => {
+        const error = new Error(String(message || '命令执行失败。'))
+        error.output = String(payload.output || outputTail || '').trim()
+        error.exitCode = typeof payload.exitCode === 'number' ? payload.exitCode : null
+        reject(error)
+      }
+
+      const flushStdout = (buffer, force = false) => {
+        const { lines, rest } = splitBufferedLines(buffer)
+        lines.forEach((line) => {
+          onEvent(createStdoutEnvelopeEvent(line))
+          outputTail = appendOutputTail(outputTail, `${line}\n`)
+        })
+        if (force && rest) {
+          onEvent(createStdoutEnvelopeEvent(rest))
+          outputTail = appendOutputTail(outputTail, `${rest}\n`)
+          return ''
+        }
+        return rest
+      }
+
+      const flushStderr = (buffer, force = false) => {
+        const { lines, rest } = splitBufferedLines(buffer)
+        lines.forEach((line) => {
+          onEvent(createStderrEnvelopeEvent(line))
+          outputTail = appendOutputTail(outputTail, `${line}\n`)
+        })
+        if (force && rest) {
+          onEvent(createStderrEnvelopeEvent(rest))
+          outputTail = appendOutputTail(outputTail, `${rest}\n`)
+          return ''
+        }
+        return rest
+      }
+
+      child.stdout?.on('data', (chunk) => {
+        stdoutBuffer += chunk.toString()
+        stdoutBuffer = flushStdout(stdoutBuffer)
+      })
+
+      child.stderr?.on('data', (chunk) => {
+        stderrBuffer += chunk.toString()
+        stderrBuffer = flushStderr(stderrBuffer)
+      })
+
+      child.once('error', (error) => {
+        if (settled) {
+          return
+        }
+        settled = true
+        stdoutBuffer = flushStdout(stdoutBuffer, true)
+        stderrBuffer = flushStderr(stderrBuffer, true)
+        const finalOutput = String(outputTail || '').trim()
+        onEvent(createAgentEventEnvelopeEvent(createItemCompletedEvent(createCommandItem(
+          displayCommand,
+          'failed',
+          finalOutput,
+          1
+        ))))
+        rejectWithOutput(error?.message || '命令启动失败。', {
+          output: finalOutput,
+          exitCode: 1,
+        })
+      })
+
+      child.once('close', (code, signal) => {
+        if (settled) {
+          return
+        }
+        settled = true
+        stdoutBuffer = flushStdout(stdoutBuffer, true)
+        stderrBuffer = flushStderr(stderrBuffer, true)
+        const exitCode = Number.isInteger(code) ? code : (signal ? 1 : 0)
+        const finalOutput = String(outputTail || '').trim()
+        const success = exitCode === 0
+
+        onEvent(createAgentEventEnvelopeEvent(createItemCompletedEvent(createCommandItem(
+          displayCommand,
+          success ? 'completed' : 'failed',
+          finalOutput,
+          exitCode
+        ))))
+
+        if (success) {
+          const message = finalOutput || `命令执行完成：${command}`
+          onEvent(createCompletedEnvelopeEvent(message))
+          resolve({
+            sessionId: String(session?.id || '').trim(),
+            threadId: '',
+            message,
+          })
+          return
+        }
+
+        rejectWithOutput(`命令执行失败(exit ${exitCode})`, {
+          output: finalOutput,
+          exitCode,
+        })
+      })
+    })
+
+    return {
+      child,
+      result,
+      cancel(options = {}) {
+        forceStopChildProcess(child, options)
+      },
+    }
+  },
+}

package/apps/runner/src/runManager.js

@@ -19,6 +19,10 @@ const QUEUED_HEARTBEAT_INTERVAL_MS = Math.max(
 const DEFAULT_STOP_TIMEOUT_MS = Math.max(1000, Number(process.env.PROMPTX_RUNNER_STOP_TIMEOUT_MS) || 10000)
 const STOP_TIMEOUT_BUFFER_MS = Math.max(500, Number(process.env.PROMPTX_RUNNER_STOP_TIMEOUT_BUFFER_MS) || 2000)
 const DEFAULT_MAX_CONCURRENT_RUNS = Math.max(1, Number(process.env.PROMPTX_RUNNER_MAX_CONCURRENT_RUNS) || 3)
+const DEFAULT_EVENT_BATCH_BYTES = Math.max(
+  64 * 1024,
+  Number(process.env.PROMPTX_RUNNER_EVENT_BATCH_BYTES) || 512 * 1024
+)
 const RUNNER_ID = String(process.env.PROMPTX_RUNNER_ID || 'local-runner').trim() || 'local-runner'
 const DISPOSE_POLL_INTERVAL_MS = Math.max(50, Number(process.env.PROMPTX_RUNNER_DISPOSE_POLL_MS) || 100)
 
@@ -26,23 +30,67 @@ function nowIso() {
   return new Date().toISOString()
 }
 
+function estimateJsonBytes(value) {
+  try {
+    return Buffer.byteLength(JSON.stringify(value), 'utf8')
+  } catch {
+    return Buffer.byteLength(String(value || ''), 'utf8')
+  }
+}
+
+function splitEventItemsIntoBatches(items = [], metadata = {}, maxBatchBytes = DEFAULT_EVENT_BATCH_BYTES) {
+  const normalizedLimit = Math.max(16 * 1024, Number(maxBatchBytes) || DEFAULT_EVENT_BATCH_BYTES)
+  const normalizedItems = Array.isArray(items) ? items.filter(Boolean) : []
+  if (!normalizedItems.length) {
+    return []
+  }
+
+  const metadataBytes = estimateJsonBytes(metadata)
+  const batches = []
+  let currentBatch = []
+  let currentBytes = metadataBytes
+
+  normalizedItems.forEach((item) => {
+    const itemBytes = estimateJsonBytes(item) + 1
+    if (currentBatch.length && currentBytes + itemBytes > normalizedLimit) {
+      batches.push(currentBatch)
+      currentBatch = [item]
+      currentBytes = metadataBytes + itemBytes
+      return
+    }
+
+    currentBatch.push(item)
+    currentBytes += itemBytes
+  })
+
+  if (currentBatch.length) {
+    batches.push(currentBatch)
+  }
+
+  return batches
+}
+
 function normalizeMaxConcurrentRuns(value, fallback = DEFAULT_MAX_CONCURRENT_RUNS) {
   const normalizedFallback = Math.max(1, Number(fallback) || DEFAULT_MAX_CONCURRENT_RUNS)
   return Math.max(1, Number(value) || normalizedFallback)
 }
 
 function normalizeSession(payload = {}) {
+  const engine = String(payload.engine || '').trim() || 'codex'
+  const isShellEngine = engine === 'shell'
   return {
     id: String(payload.sessionId || payload.id || '').trim(),
     title: String(payload.sessionTitle || payload.title || '').trim(),
-    engine: String(payload.engine || '').trim() || 'codex',
+    engine,
     cwd: String(payload.cwd || '').trim(),
-    codexThreadId: String(payload.codexThreadId || payload.engineThreadId || '').trim(),
-    engineSessionId: String(payload.engineSessionId || '').trim(),
-    engineThreadId: String(payload.engineThreadId || payload.codexThreadId || '').trim(),
-    engineMeta: payload.engineMeta && typeof payload.engineMeta === 'object' ? payload.engineMeta : {},
+    codexThreadId: isShellEngine ? '' : String(payload.codexThreadId || payload.engineThreadId || '').trim(),
+    engineSessionId: isShellEngine ? '' : String(payload.engineSessionId || '').trim(),
+    engineThreadId: isShellEngine ? '' : String(payload.engineThreadId || payload.codexThreadId || '').trim(),
+    engineMeta: isShellEngine
+      ? {}
+      : (payload.engineMeta && typeof payload.engineMeta === 'object' ? payload.engineMeta : {}),
     running: true,
-    started: Boolean(String(payload.engineThreadId || payload.codexThreadId || '').trim()),
+    started: isShellEngine ? false : Boolean(String(payload.engineThreadId || payload.codexThreadId || '').trim()),
     createdAt: String(payload.sessionCreatedAt || '').trim(),
     updatedAt: String(payload.sessionUpdatedAt || '').trim(),
   }
@@ -286,13 +334,19 @@ export function createRunManager(options = {}) {
     }
 
     const pendingItems = context.eventBuffer.splice(0, context.eventBuffer.length)
+    const batches = splitEventItemsIntoBatches(pendingItems, { runnerId: RUNNER_ID })
     context.flushing = true
 
+    let batchIndex = 0
     try {
-      await serverClient.postEvents(pendingItems, { runnerId: RUNNER_ID })
+      for (batchIndex = 0; batchIndex < batches.length; batchIndex += 1) {
+        const batch = batches[batchIndex]
+        await serverClient.postEvents(batch, { runnerId: RUNNER_ID })
+      }
       return pendingItems.length
     } catch (error) {
-      context.eventBuffer.unshift(...pendingItems)
+      const remainingItems = batches.slice(batchIndex).flat()
+      context.eventBuffer.unshift(...remainingItems)
       context.eventFlushFailureCount = Math.max(0, Number(context.eventFlushFailureCount) || 0) + 1
       context.lastEventFlushFailureAt = nowIso()
       context.lastEventFlushFailureMessage = String(error?.message || error || '').trim()
@@ -472,6 +526,11 @@ export function createRunManager(options = {}) {
   }
 
   async function handleStreamError(context, error) {
+    const errorOutput = String(error?.output || '').trim()
+    const errorMessage = [String(error?.message || '执行引擎运行失败。').trim(), errorOutput]
+      .filter(Boolean)
+      .join('\n\n')
+
     if (context.stopRequestedAt) {
       const stopReason = classifyStoppedErrorReason(context)
       await finalizeRun(context, 'stopped', {
@@ -485,7 +544,7 @@ export function createRunManager(options = {}) {
     }
 
     await finalizeRun(context, 'error', {
-      errorMessage: error?.message || '执行引擎运行失败。',
+      errorMessage,
     })
   }
 

package/apps/server/src/agents/index.js

@@ -8,14 +8,29 @@ import { codexRunner } from './codexRunner.js'
 import { claudeCodeRunner } from './claudeCodeRunner.js'
 import { openCodeRunner } from './openCodeRunner.js'
 
+const SHELL_ENGINE = 'shell'
+const shellRunner = {
+  engine: SHELL_ENGINE,
+  label: 'Shell',
+}
+
 const runnerRegistry = new Map([
   [codexRunner.engine, codexRunner],
   [claudeCodeRunner.engine, claudeCodeRunner],
   [openCodeRunner.engine, openCodeRunner],
+  [shellRunner.engine, shellRunner],
 ])
 
+function normalizeRunnerEngine(engine = AGENT_ENGINES.CODEX) {
+  const normalized = String(engine || '').trim().toLowerCase()
+  if (normalized === SHELL_ENGINE) {
+    return SHELL_ENGINE
+  }
+  return normalizeAgentEngine(normalized)
+}
+
 export function getAgentRunner(engine = AGENT_ENGINES.CODEX) {
-  return runnerRegistry.get(normalizeAgentEngine(engine)) || null
+  return runnerRegistry.get(normalizeRunnerEngine(engine)) || null
 }
 
 export function listAvailableAgentEngines() {
@@ -30,10 +45,10 @@ export function listEnabledAgentEngines() {
 }
 
 export function assertAgentRunner(engine = AGENT_ENGINES.CODEX) {
-  const normalized = normalizeAgentEngine(engine)
+  const normalized = normalizeRunnerEngine(engine)
   const runner = getAgentRunner(normalized)
   if (!runner) {
-    throw new Error(`当前还不支持执行引擎：${getAgentEngineLabel(normalized)}`)
+    throw new Error(`当前还不支持执行引擎：${normalized === SHELL_ENGINE ? shellRunner.label : getAgentEngineLabel(normalized)}`)
   }
   return runner
 }

package/apps/server/src/codexRuns.js

@@ -43,6 +43,15 @@ function parsePromptBlocks(rawValue = '[]') {
   }
 }
 
+function parseRunMeta(rawValue = '{}') {
+  try {
+    const parsed = JSON.parse(rawValue || '{}')
+    return parsed && typeof parsed === 'object' && !Array.isArray(parsed) ? parsed : {}
+  } catch {
+    return {}
+  }
+}
+
 function trimBoundaryBlankLines(value = '') {
   const lines = String(value || '').replace(/\r\n/g, '\n').split('\n')
 
@@ -112,6 +121,7 @@ function toCodexRun(row, events = null) {
     taskSlug: row.task_slug,
     sessionId: row.session_id,
     engine: String(row.engine || '').trim() || 'codex',
+    displayEngine: String(parseRunMeta(row.run_meta_json).displayEngine || '').trim(),
     prompt: row.prompt || '',
     promptBlocks: parsePromptBlocks(row.prompt_blocks_json),
     status: row.status || 'running',
@@ -177,7 +187,7 @@ function getRunRowById(runId) {
   }
 
   return get(
-    `SELECT id, task_slug, session_id, engine, prompt, prompt_blocks_json, status, response_message, error_message, created_at, updated_at, started_at, finished_at
+    `SELECT id, task_slug, session_id, engine, run_meta_json, prompt, prompt_blocks_json, status, response_message, error_message, created_at, updated_at, started_at, finished_at
      FROM codex_runs
      WHERE id = ?`,
     [targetId]
@@ -291,6 +301,7 @@ export function listTaskCodexRunsWithOptions(taskSlug, options = {}) {
        runs.task_slug,
        runs.session_id,
        runs.engine,
+       runs.run_meta_json,
        runs.prompt,
        runs.prompt_blocks_json,
        runs.status,
@@ -312,6 +323,7 @@ export function listTaskCodexRunsWithOptions(taskSlug, options = {}) {
        runs.task_slug,
        runs.session_id,
        runs.engine,
+       runs.run_meta_json,
        runs.prompt,
        runs.prompt_blocks_json,
        runs.status,
@@ -367,6 +379,8 @@ export function createCodexRun(input = {}) {
   const prompt = String(input.prompt || '').trim()
   const promptBlocks = normalizePromptBlocks(input.promptBlocks)
   const initialStatus = String(input.status || 'queued').trim() || 'queued'
+  const engine = String(input.engine || '').trim()
+  const displayEngine = String(input.displayEngine || '').trim()
 
   if (!taskSlug) {
     throw new Error('缺少任务。')
@@ -387,7 +401,8 @@ export function createCodexRun(input = {}) {
   if (!session) {
     throw new Error('没有找到对应的 PromptX 项目。')
   }
-  assertAgentRunner(session.engine)
+  const runEngine = engine || session.engine || 'codex'
+  assertAgentRunner(runEngine)
 
   const now = new Date().toISOString()
   const runId = `pxcr_${nanoid(12)}`
@@ -396,11 +411,11 @@ export function createCodexRun(input = {}) {
   transaction(() => {
     run(
       `INSERT INTO codex_runs (
-         id, task_slug, session_id, engine, prompt, prompt_blocks_json, status,
+         id, task_slug, session_id, engine, run_meta_json, prompt, prompt_blocks_json, status,
          response_message, error_message, created_at, updated_at, started_at, finished_at
        )
-       VALUES (?, ?, ?, ?, ?, ?, ?, '', '', ?, ?, ?, NULL)`,
-      [runId, task.slug, session.id, session.engine || 'codex', prompt, JSON.stringify(promptBlocks), initialStatus, now, now, startedAt]
+       VALUES (?, ?, ?, ?, ?, ?, ?, ?, '', '', ?, ?, ?, NULL)`,
+      [runId, task.slug, session.id, runEngine, JSON.stringify({ displayEngine }), prompt, JSON.stringify(promptBlocks), initialStatus, now, now, startedAt]
     )
   })
 
@@ -645,7 +660,7 @@ export function getRunningCodexRunBySessionId(sessionId) {
   const activeStatuses = [...ACTIVE_RUN_STATUSES]
   const placeholders = activeStatuses.map(() => '?').join(', ')
   const row = get(
-    `SELECT id, task_slug, session_id, engine, prompt, prompt_blocks_json, status, response_message, error_message, created_at, updated_at, started_at, finished_at
+    `SELECT id, task_slug, session_id, engine, run_meta_json, prompt, prompt_blocks_json, status, response_message, error_message, created_at, updated_at, started_at, finished_at
      FROM codex_runs
      WHERE session_id = ?
        AND status IN (${placeholders})
@@ -666,7 +681,7 @@ export function getRunningCodexRunByTaskSlug(taskSlug) {
   const activeStatuses = [...ACTIVE_RUN_STATUSES]
   const placeholders = activeStatuses.map(() => '?').join(', ')
   const row = get(
-    `SELECT id, task_slug, session_id, engine, prompt, prompt_blocks_json, status, response_message, error_message, created_at, updated_at, started_at, finished_at
+    `SELECT id, task_slug, session_id, engine, run_meta_json, prompt, prompt_blocks_json, status, response_message, error_message, created_at, updated_at, started_at, finished_at
      FROM codex_runs
      WHERE task_slug = ?
        AND status IN (${placeholders})
@@ -715,6 +730,7 @@ export function listStaleActiveCodexRuns(maxAgeMs = 20000, now = new Date()) {
        runs.task_slug,
        runs.session_id,
        runs.engine,
+       runs.run_meta_json,
        runs.prompt,
        runs.prompt_blocks_json,
        runs.status,
@@ -733,6 +749,7 @@ export function listStaleActiveCodexRuns(maxAgeMs = 20000, now = new Date()) {
        runs.task_slug,
        runs.session_id,
        runs.engine,
+       runs.run_meta_json,
        runs.prompt,
        runs.prompt_blocks_json,
        runs.status,

package/apps/server/src/db.js

@@ -231,6 +231,7 @@ function migrateToV1() {
       task_slug TEXT NOT NULL,
       session_id TEXT NOT NULL,
       engine TEXT NOT NULL DEFAULT 'codex',
+      run_meta_json TEXT NOT NULL DEFAULT '{}',
       prompt TEXT NOT NULL DEFAULT '',
       prompt_blocks_json TEXT NOT NULL DEFAULT '[]',
       status TEXT NOT NULL,
@@ -356,6 +357,7 @@ function applyAdditiveSchemaPatches() {
      WHERE COALESCE(NULLIF(engine_thread_id, ''), '') = ''`,
     `ALTER TABLE codex_runs ADD COLUMN prompt_blocks_json TEXT NOT NULL DEFAULT '[]'`,
     `ALTER TABLE codex_runs ADD COLUMN engine TEXT NOT NULL DEFAULT 'codex'`,
+    `ALTER TABLE codex_runs ADD COLUMN run_meta_json TEXT NOT NULL DEFAULT '{}'`,
     `UPDATE codex_runs
      SET engine = COALESCE(NULLIF(engine, ''), 'codex')
      WHERE COALESCE(NULLIF(engine, ''), '') = ''`,