@cocorograph/hub-agent 0.7.37 → 0.7.42

package/src/main.mjs

@@ -25,7 +25,7 @@ import { loadPlugins, runHookBroadcast, runHookChain } from "./plugin-loader.mjs
 import { WsClient } from "./ws-client.mjs"
 import { PtyBridge } from "./pty-bridge.mjs"
 import { ClaudeStreamBridge } from "./claude-stream-bridge.mjs"
-import { CodexStreamBridge } from "./codex-stream-bridge.mjs"
+import { CodexStreamBridge, classifyCodexInputError } from "./codex-stream-bridge.mjs"
 import { UploadManager } from "./claude-upload.mjs"
 import { requestSelfUninstall } from "./service-install.mjs"
 import {
@@ -93,6 +93,7 @@ import {
 import { TuiPermissionBridge } from "./tui-permission-bridge.mjs"
 import { TuiViewerRegistry } from "./tui-viewer-registry.mjs"
 import { JsonlLiveWatchers } from "./jsonl-live-watchers.mjs"
+import { SiblingInjectBridge } from "./sibling-inject.mjs"
 import {
   boundSessionId,
   codexSessionUsages,
@@ -102,6 +103,7 @@ import {
   getSessionUsages,
   getUsage,
   isFreshUnboundBind,
+  jsonlContextForCwd,
   recordChatRateLimit,
   recordChatUsageSnapshot,
   turnActiveForCwd,
@@ -546,13 +548,23 @@ export async function startDaemon({ version, ptyModule, claudeSdk } = {}) {
             status: "processing",
             contextPct: pct,
             inputPending: false,
+            // identity (S1): この cwd の chat 信号が「今どの CLI・どのセッションのものか」を
+            // 明示する。claude.attach で確定させた identity と一致すれば温存、別セッション/
+            // エンジンに切り替わっていれば chat-signals.mjs 側が自動でリセットする。
+            cliKind: "claude",
+            sessionId: session_id || null,
           })
         } catch {
           /* ignore */
         }
       } else if (event?.type === "result") {
         try {
-          recordChatActivity(cwd, { status: "waiting", inputPending: false })
+          recordChatActivity(cwd, {
+            status: "waiting",
+            inputPending: false,
+            cliKind: "claude",
+            sessionId: session_id || null,
+          })
         } catch {
           /* ignore */
         }
@@ -620,17 +632,51 @@ export async function startDaemon({ version, ptyModule, claudeSdk } = {}) {
   if (codexBridge) {
     codexBridge.on("event", ({ stream_id, thread_id, cwd, notification }) => {
       if (notification.method === "turn/started") {
-        try {
-          recordChatActivity(cwd, { status: "processing", inputPending: false })
-        } catch {
-          /* ignore */
-        }
+        // S1 (2026-07): contextPct を渡していなかったため、Codex 選択中は状態ドット
+        // (processing/waiting) こそ更新されるがコンテキスト% は claude 由来の古い値の
+        // ままだった (症状③の一因)。codexUsageForThread は rollout ファイルの I/O を
+        // 伴うため fire-and-forget (await せず、取得できた時点で反映)。
+        ;(async () => {
+          let contextPct = null
+          try {
+            const usage = await codexUsageForThread(thread_id)
+            contextPct = typeof usage?.context === "number" ? usage.context : null
+          } catch {
+            /* ignore */
+          }
+          try {
+            recordChatActivity(cwd, {
+              status: "processing",
+              contextPct,
+              inputPending: false,
+              cliKind: "codex",
+              sessionId: thread_id || null,
+            })
+          } catch {
+            /* ignore */
+          }
+        })()
       } else if (notification.method === "turn/completed") {
-        try {
-          recordChatActivity(cwd, { status: "waiting", inputPending: false })
-        } catch {
-          /* ignore */
-        }
+        ;(async () => {
+          let contextPct = null
+          try {
+            const usage = await codexUsageForThread(thread_id)
+            contextPct = typeof usage?.context === "number" ? usage.context : null
+          } catch {
+            /* ignore */
+          }
+          try {
+            recordChatActivity(cwd, {
+              status: "waiting",
+              contextPct,
+              inputPending: false,
+              cliKind: "codex",
+              sessionId: thread_id || null,
+            })
+          } catch {
+            /* ignore */
+          }
+        })()
       }
       client.send({ type: "codex.event", stream_id, thread_id, event: notification })
     })
@@ -868,6 +914,14 @@ export async function startDaemon({ version, ptyModule, claudeSdk } = {}) {
   await tuiViewerRegistry.start()
   ctx.tuiViewerRegistry = tuiViewerRegistry
 
+  // sibling-inject (ask-sibling スキル, 2026-07-04): 同一 cwd の claude⇄codex
+  // 相互依頼のためのローカル IPC 受信口。cwd スコープ capability トークン
+  // (src/sibling-token.mjs) で検証した要求のみ claudeBridge/codexBridge.sendToCwd()
+  // へ橋渡しする。
+  const siblingInjectBridge = new SiblingInjectBridge({ claudeBridge, codexBridge, logger })
+  await siblingInjectBridge.start()
+  ctx.siblingInjectBridge = siblingInjectBridge
+
   // jsonl ライブ追従 (T04784 逐次表示): TUI チャットの閲覧ハートビートを起点に対象
   // session の jsonl を tail し、追記行を claude.jsonl.event として逐次 push する。
   // これで session.event 合図 → 全体再 hydrate + 2.5s ポーリングの「どさっと」を廃せる。
@@ -926,6 +980,7 @@ export async function startDaemon({ version, ptyModule, claudeSdk } = {}) {
     tuiPermissionBridge.stop()
     tuiViewerRegistry.stop()
     jsonlLiveWatchers.stop()
+    siblingInjectBridge.stop()
     ptyBridge.shutdown()
     claudeBridge?.shutdown?.()
     codexBridge?.shutdown?.()
@@ -1405,6 +1460,59 @@ export function applyChatOverlay(paneStatus, paneContextPct, chat) {
   return { status, contextPct }
 }
 
+/**
+ * S1 (2026-07): claude.attach / codex.attach の直後に、その cwd に対応する session.state を
+ * 1 回だけ即時 push する。startStateLoop の周期 (既定 5s) を待つと、エンジン切替や新規
+ * セッション選択の直後もサイドバーのドーナツ/ステータスドットが前セッションの値のまま
+ * 数秒間残ってしまう (症状③④)。claude.tui.bind が既に持つ「即時ステータススナップショット」
+ * (main.mjs 内 detectSessionState 直後の push) と同じ発想で、チャット (SDK/app-server) 側にも
+ * 対称の即時 push を用意する。
+ *
+ * cwd → session_name の解決: claude.attach / codex.attach は tmux の session_name を知らない
+ * (browser は cwd/stream_id しか送らない) ため、listSessionStates で全 tmux session を走査し
+ * cwd が一致するものへ push する (通常は 1 cwd = 1 tmux session)。tmux 自体が無い / 一致が
+ * 無ければ何もしない (安全側、次の poll 系フォールバックに委ねる)。
+ *
+ * `listSessionStatesFn` は単体テスト用の DI ポイント (既定は実 `listSessionStates`、tmux を
+ * 起動する)。実運用では省略してよい。
+ *
+ * @param {{ client: object, plugins: object, logger?: object, cwd: string, cliKind: 'claude'|'codex', sessionId: string|null, contextPct?: number|null, listSessionStatesFn?: Function }} args
+ */
+export async function pushImmediateChatState({
+  client,
+  plugins,
+  logger,
+  cwd,
+  cliKind,
+  sessionId,
+  contextPct = 0,
+  listSessionStatesFn = listSessionStates,
+}) {
+  if (!cwd || !client) return
+  try {
+    const states = await listSessionStatesFn({ plugins, logger })
+    for (const s of states) {
+      if (s.cwd !== cwd) continue
+      client.send({
+        type: "session.state",
+        session_name: s.session_name,
+        status: "waiting",
+        context_pct: typeof contextPct === "number" ? contextPct : 0,
+        permission_mode: s.permission_mode ?? null,
+        stable: true,
+        proc_busy: false,
+        child_busy: false,
+        stalled: false,
+        turn_active: false,
+        cli_kind: cliKind,
+        chat_session_id: sessionId ?? null,
+      })
+    }
+  } catch (err) {
+    logger?.warn?.({ err: err?.message, cwd }, "pushImmediateChatState failed")
+  }
+}
+
 /**
  * turnActiveForCwd / jsonlContextForCwd に渡す bound session_id を解決する純関数。
  *
@@ -1628,6 +1736,13 @@ export function startStateLoop({ client, plugins, logger, intervalMs, claudeBrid
             turnActive = null
         }
 
+        // S1 (2026-07): チャット信号 (getChatSignal) が identity (cliKind/sessionId) を
+        // 持っていれば、それをそのまま session.state に同梱する。frontend はこれで「今
+        // 表示中のエンジン/セッションと一致する push か」を判定し、不一致の値を適用しない
+        // (前セッションの値を上書きし続ける症状③④の frontend 側の受け口)。
+        const chatCliKind = chat?.cliKind ?? null
+        const chatSessionId = chat?.sessionId ?? null
+
         const prev = lastByName.get(s.session_name)
         if (
           !prev ||
@@ -1638,7 +1753,9 @@ export function startStateLoop({ client, plugins, logger, intervalMs, claudeBrid
           prev.proc_busy !== procBusy ||
           prev.child_busy !== childBusy ||
           prev.stalled !== stalled ||
-          prev.turn_active !== turnActive
+          prev.turn_active !== turnActive ||
+          prev.cli_kind !== chatCliKind ||
+          prev.chat_session_id !== chatSessionId
         ) {
           lastByName.set(s.session_name, {
             status,
@@ -1649,6 +1766,8 @@ export function startStateLoop({ client, plugins, logger, intervalMs, claudeBrid
             child_busy: childBusy,
             stalled,
             turn_active: turnActive,
+            cli_kind: chatCliKind,
+            chat_session_id: chatSessionId,
           })
           // 計装 (2026-06-19, 既定 OFF=2026-06-20): 状態変化時に値を記録する。常時 info はログ肥大の
           // 主因のため HUB_AGENT_STATE_TRACE=1 のときだけ出す。childBusy/outputActive を分けて出し、
@@ -1666,6 +1785,8 @@ export function startStateLoop({ client, plugins, logger, intervalMs, claudeBrid
               stable,
               context_pct: contextPct,
               turn_active: turnActive,
+              cli_kind: chatCliKind,
+              chat_session_id: chatSessionId,
             },
             "session.state push",
           )
@@ -1685,6 +1806,11 @@ export function startStateLoop({ client, plugins, logger, intervalMs, claudeBrid
             // turn_active: ステータスドット 4 状態統一の権威ソース。null は旧クライアント互換
             // (frontend は欠落時に旧 prompt_submit/stale 降格ロジックへフォールバック)。
             turn_active: turnActive,
+            // cli_kind / chat_session_id (S1, 2026-07): このセッションの現在の chat 信号が
+            // どの CLI・どのセッションのものか。チャット信号が無い (TUI 専用/未対応) 行では
+            // null (旧クライアント互換、frontend は無条件マージにフォールバック)。
+            cli_kind: chatCliKind,
+            chat_session_id: chatSessionId,
           })
         }
         // 消滅セッションの GC (perf監査/メモリリーク対策): tmux から消えたセッションの状態 Map を
@@ -1906,6 +2032,31 @@ function rememberInputId(input_id) {
   }
 }
 
+/**
+ * SDK チャット配達保証 (S2, 2026-07-05) 用の冪等化レジストリ。
+ *
+ * `claude.input` / `codex.input` に browser が付与する `input_id` を記憶し、ack
+ * ウォッチドッグ再送 (browser 側が 5s 以内に ack/nack を受け取れず再送するケース) で
+ * 同じメッセージが 2 回ターン実行されないようにする。tracked pty.data
+ * (`seenInputIds` 上) と同じ設計だが、チャンネル別に Set を分ける
+ * (input_id の採番元は browser 側で共通の可能性があるが、pty と chat で
+ * 意味論が異なる衝突を避けるため)。
+ */
+function makeSeenInputIdRegistry(max = SEEN_INPUT_IDS_MAX) {
+  const seen = new Set()
+  return {
+    has: (id) => seen.has(id),
+    remember: (id) => {
+      seen.add(id)
+      while (seen.size > max) {
+        seen.delete(seen.values().next().value)
+      }
+    },
+  }
+}
+const seenClaudeChatInputIds = makeSeenInputIdRegistry()
+const seenCodexChatInputIds = makeSeenInputIdRegistry()
+
 /**
  * input_id 付き pty.data (tracked 入力) の処理。write 成功で pty.input.ack を返し、
  * stream 不在なら pty.error を返して browser の再 attach → 再送に繋げる。
@@ -1949,6 +2100,138 @@ export function handleUntrackedPtyData(msg, ctx) {
   }
 }
 
+/**
+ * SDK チャット配達保証 (S2, 2026-07-05): `claude.input` を処理し、browser が付与した
+ * `input_id` があれば `claude.input.ack` / `claude.input.nack` を返す。無ければ従来
+ * どおり無応答の fire-and-forget (旧 frontend / 内部呼び出しとの後方互換)。
+ *
+ * `ClaudeStreamBridge.input()` の戻り値 `{ ok, reason? }` は「ターン完走」ではなく
+ * 「キュー/常駐 query への投入が完了したか」を表す (ack を素早く返すため)。
+ * テストから直接呼べるよう dispatch から切り出して export する
+ * (handleTrackedPtyData と同じ設計)。
+ */
+export function handleClaudeChatInput(msg, ctx) {
+  const stream_id = msg.stream_id
+  const input_id = typeof msg.input_id === "string" && msg.input_id ? msg.input_id : null
+  if (!ctx.claudeBridge) {
+    if (input_id) {
+      ctx.client.send({
+        type: "claude.input.nack",
+        stream_id,
+        input_id,
+        reason: "stream_missing",
+      })
+    }
+    return undefined
+  }
+  if (input_id && seenClaudeChatInputIds.has(input_id)) {
+    // 再送 (ack 喪失想定)。同じターンを 2 回実行しないよう sendMessage を
+    // 呼び直さず ack のみ返す (tracked pty.data の dedup と同じ考え方)。
+    ctx.logger?.info?.({ stream_id, input_id }, "claude.input dedup (ack only)")
+    ctx.client.send({ type: "claude.input.ack", stream_id, input_id })
+    return undefined
+  }
+  return ctx.claudeBridge
+    .input({
+      stream_id,
+      message: msg.message,
+      // ultracode (0.6.28): browser がこのメッセージ単位で送るワンショット指定。
+      // true のときだけそのターンを xhigh effort + dynamic-workflow で実行する。
+      ultracode: msg.ultracode === true,
+    })
+    .then((result) => {
+      if (!input_id) return
+      if (result?.ok) {
+        seenClaudeChatInputIds.remember(input_id)
+        ctx.client.send({ type: "claude.input.ack", stream_id, input_id })
+      } else {
+        ctx.client.send({
+          type: "claude.input.nack",
+          stream_id,
+          input_id,
+          reason: result?.reason || "queue_dead",
+        })
+      }
+    })
+    .catch((err) => {
+      ctx.logger?.error?.(
+        { stream_id, err: err?.message },
+        "claude.input dispatch threw unexpectedly",
+      )
+      if (input_id) {
+        ctx.client.send({
+          type: "claude.input.nack",
+          stream_id,
+          input_id,
+          reason: "error",
+        })
+      }
+    })
+}
+
+/**
+ * SDK チャット配達保証 (S2, 2026-07-05): `codex.input` を処理し、browser が付与した
+ * `input_id` があれば `codex.input.ack` / `codex.input.nack` を返す (claude.input と
+ * 対称)。`CodexStreamBridge.input()` は `turn/start` / `turn/steer` の JSON-RPC 呼び出し
+ * そのものを await する設計のため、resolve/reject がそのまま ack/nack の判定になる。
+ * 既存の `codex.error` 通知も維持する (input_id を知らない旧 frontend や、他の消費者向け)。
+ * テストから直接呼べるよう dispatch から切り出して export する。
+ */
+export function handleCodexChatInput(msg, ctx) {
+  const stream_id = msg.stream_id
+  const input_id = typeof msg.input_id === "string" && msg.input_id ? msg.input_id : null
+  if (!ctx.codexBridge) {
+    if (input_id) {
+      ctx.client.send({
+        type: "codex.input.nack",
+        stream_id,
+        input_id,
+        reason: "stream_missing",
+      })
+    }
+    return undefined
+  }
+  if (input_id && seenCodexChatInputIds.has(input_id)) {
+    // 再送 (ack 喪失想定)。turn/start・turn/steer を再送出せず ack のみ返す
+    // (二重ターン実行を避ける。claude.input dedup と同じ考え方)。
+    ctx.logger?.info?.({ stream_id, input_id }, "codex.input dedup (ack only)")
+    ctx.client.send({ type: "codex.input.ack", stream_id, input_id })
+    return undefined
+  }
+  return ctx.codexBridge
+    .input({
+      stream_id,
+      message: msg.message,
+      model: msg.model || undefined,
+      effort: msg.effort || undefined,
+    })
+    .then(() => {
+      if (!input_id) return
+      seenCodexChatInputIds.remember(input_id)
+      ctx.client.send({ type: "codex.input.ack", stream_id, input_id })
+    })
+    .catch((err) => {
+      if (input_id) {
+        ctx.client.send({
+          type: "codex.input.nack",
+          stream_id,
+          input_id,
+          reason: classifyCodexInputError(err),
+        })
+      }
+      // 既存の error 通知も維持する (input_id を知らない旧 frontend や、
+      // input_id 以外の理由でエラー表示を必要とする他の消費者向け)。S3 Codex 堅牢化
+      // 由来の err.reason ('timeout' / 'turn_mismatch_retry_failed') があれば
+      // 引き続き codex.error にも乗せる (S2 導入前からの互換維持)。
+      ctx.client.send({
+        type: "codex.error",
+        stream_id,
+        error: err.message,
+        ...(err.reason ? { reason: err.reason } : {}),
+      })
+    })
+}
+
 /**
  * 離席中キュー投入 (claude.tui.queue.flush) の冪等化用に、処理済み flush_id を記憶する。
  * WS 再送で同じ flush が二重に届いても二重 paste しないため。上限を超えたら全消去 (best-effort)。
@@ -2280,9 +2563,11 @@ async function dispatch(msg, ctx) {
           // cwd は明示指定が無ければ agent.json の cwd → HOME の順で fallback
           // (将来 cockpit から worktree path を指定する用)。
           // model / permissionMode は agent.json の値も使えるよう fallback。
+          const cwdArg = msg.cwd || ctx.config?.claude_cwd || undefined
+          const resumeSessionId = msg.resume_session_id || null
           const info = ctx.claudeBridge.attach({
             stream_id,
-            cwd: msg.cwd || ctx.config?.claude_cwd || undefined,
+            cwd: cwdArg,
             model: msg.model || ctx.config?.claude_model || null,
             permissionMode:
               msg.permission_mode ||
@@ -2297,13 +2582,67 @@ async function dispatch(msg, ctx) {
             // effort (Opus 4.6+): browser がチャット既定 (agent 設定由来) を送る。
             // 空文字/未指定なら null (SDK / Claude Code 既定 = Opus は high)。
             effort: msg.effort || ctx.config?.claude_effort || null,
-            resumeSessionId: msg.resume_session_id || null,
+            resumeSessionId,
           })
           ctx.client.send({
             type: "claude.ready",
             stream_id,
             resuming: info.resuming,
           })
+          // S1 (2026-07): セッション状態の identity 正本化。TUI の claude.tui.bind
+          // (main.mjs 内 clearChatSignal 呼び出し箇所参照) と対称に、SDK チャットの
+          // attach 時点でも前セッションのチャット信号を引き継がない。
+          //  - fresh (resume 無し): 新規セッションで session_id はまだ確定しない
+          //    (SDK が最初の assistant イベントで通知する) ため null。前の信号を破棄し
+          //    ゼロ値を即時 push してドーナツ/ドットを即座にリセットする (症状④)。
+          //  - resume: bound session の jsonl から実 context% を解決し、cli_kind='claude' +
+          //    実 session_id で identity を確定させて即時 push する (症状③)。
+          const resolvedCwd = cwdArg || process.env.HOME || process.cwd()
+          if (resolvedCwd) {
+            if (!resumeSessionId) {
+              clearChatSignal(resolvedCwd)
+              recordChatActivity(resolvedCwd, {
+                status: "waiting",
+                contextPct: 0,
+                inputPending: false,
+                cliKind: "claude",
+                sessionId: null,
+              })
+              pushImmediateChatState({
+                client: ctx.client,
+                plugins: ctx.plugins,
+                logger: ctx.logger,
+                cwd: resolvedCwd,
+                cliKind: "claude",
+                sessionId: null,
+                contextPct: 0,
+              }).catch(() => {})
+            } else {
+              jsonlContextForCwd(resolvedCwd, resumeSessionId)
+                .catch(() => null)
+                .then((jsonlCtx) => {
+                  const contextPct =
+                    typeof jsonlCtx?.percent === "number" ? jsonlCtx.percent : 0
+                  recordChatActivity(resolvedCwd, {
+                    status: "waiting",
+                    contextPct,
+                    inputPending: false,
+                    cliKind: "claude",
+                    sessionId: resumeSessionId,
+                  })
+                  return pushImmediateChatState({
+                    client: ctx.client,
+                    plugins: ctx.plugins,
+                    logger: ctx.logger,
+                    cwd: resolvedCwd,
+                    cliKind: "claude",
+                    sessionId: resumeSessionId,
+                    contextPct,
+                  })
+                })
+                .catch(() => {})
+            }
+          }
         } catch (err) {
           ctx.client.send({
             type: "claude.error",
@@ -2315,14 +2654,7 @@ async function dispatch(msg, ctx) {
       }
       case "claude.input":
         // message: { role: 'user', content: string | Array } を期待
-        if (!ctx.claudeBridge) return
-        ctx.claudeBridge.input({
-          stream_id: msg.stream_id,
-          message: msg.message,
-          // ultracode (0.6.28): browser がこのメッセージ単位で送るワンショット指定。
-          // true のときだけそのターンを xhigh effort + dynamic-workflow で実行する。
-          ultracode: msg.ultracode === true,
-        })
+        handleClaudeChatInput(msg, ctx)
         return
       case "claude.upload": {
         // Cockpit チャットモードの添付ファイル受信 (チャンク 1 件)。全チャンク到着で
@@ -3271,14 +3603,16 @@ async function dispatch(msg, ctx) {
           return
         }
         try {
+          const resolvedCwd = msg.cwd || ctx.config?.claude_cwd || undefined
+          const resumeThreadId = msg.resume_thread_id || null
           const info = await ctx.codexBridge.attach({
             stream_id,
-            cwd: msg.cwd || ctx.config?.claude_cwd || undefined,
+            cwd: resolvedCwd,
             model: msg.model || undefined,
             effort: msg.effort || undefined,
             approvalPolicy: msg.approval_policy || undefined,
             sandbox: msg.sandbox || undefined,
-            resumeThreadId: msg.resume_thread_id || null,
+            resumeThreadId,
           })
           ctx.client.send({
             type: "codex.ready",
@@ -3290,34 +3624,130 @@ async function dispatch(msg, ctx) {
             // 変更は不要 (_AGENT_PER_STREAM_TYPES の codex.ready がそのまま運ぶ)。
             history: info.history || [],
           })
+          // S1 (2026-07): claude.attach と対称の identity 正本化。Codex は thread/start
+          // 応答時点で threadId が確定するため (Claude の fresh とは異なり)、fresh でも
+          // 既に分かっている threadId を sessionId として記録する (直後の turn/started が
+          // 同じ threadId を伴って届いても identity 一致でリセットが起きないように)。
+          //  - fresh (resume 無し): ゼロ値 + 確定済み threadId で即時 push (症状④)。
+          //  - resume: codexUsageForThread で実 context% を解決し即時 push (症状③)。
+          if (resolvedCwd) {
+            if (!resumeThreadId) {
+              clearChatSignal(resolvedCwd)
+              recordChatActivity(resolvedCwd, {
+                status: "waiting",
+                contextPct: 0,
+                inputPending: false,
+                cliKind: "codex",
+                sessionId: info.threadId || null,
+              })
+              pushImmediateChatState({
+                client: ctx.client,
+                plugins: ctx.plugins,
+                logger: ctx.logger,
+                cwd: resolvedCwd,
+                cliKind: "codex",
+                sessionId: info.threadId || null,
+                contextPct: 0,
+              }).catch(() => {})
+            } else {
+              codexUsageForThread(info.threadId)
+                .catch(() => null)
+                .then((usage) => {
+                  const contextPct = typeof usage?.context === "number" ? usage.context : 0
+                  recordChatActivity(resolvedCwd, {
+                    status: "waiting",
+                    contextPct,
+                    inputPending: false,
+                    cliKind: "codex",
+                    sessionId: info.threadId,
+                  })
+                  return pushImmediateChatState({
+                    client: ctx.client,
+                    plugins: ctx.plugins,
+                    logger: ctx.logger,
+                    cwd: resolvedCwd,
+                    cliKind: "codex",
+                    sessionId: info.threadId,
+                    contextPct,
+                  })
+                })
+                .catch(() => {})
+            }
+          }
         } catch (err) {
           ctx.client.send({
             type: "codex.error",
             stream_id,
             error: err.message,
+            // S3 Codex 堅牢化: request() タイムアウト (codex-appserver-client.mjs) は
+            // err.reason='timeout' を付与する。frontend が理由別の文言/表示を出し分け
+            // られるよう素通しする (無ければ undefined = キー自体を省略)。
+            ...(err.reason ? { reason: err.reason } : {}),
           })
         }
         return
       }
-      case "codex.input":
-        // model/effort: turn/start (非 busy 時) にのみ反映される override。turn/steer
-        // (busy 時) は公式スキーマ上 model/effort 非対応のため、その場合は
-        // codex-stream-bridge.mjs 側で無視され次の非 busy な input() から効く。
-        if (!ctx.codexBridge) return
-        ctx.codexBridge
-          .input({
+      case "codex.upload": {
+        // B4 (T05699 残タスク, 2026-07-04): Cockpit Codexチャットの添付ファイル受信
+        // (チャンク1件)。claude.upload と同じ UploadManager を再利用する (cwd ベースで
+        // CLI 非依存の実装のため無改修で流用可能)。全チャンク到着で cwd 配下の
+        // .cockpit-uploads/<日付>/ に保存し、保存パスを browser へ返す。browser は
+        // そのパスを codex.input 本文に載せ、Codex がシェル/ファイルツールで読む
+        // (Claude 版と同じ「パス参照方式」、Codex 側の model/effort 分離と同様に
+        // アカウント/プロトコルが違うだけでファイル保存の仕組みは共有する)。
+        if (!ctx.uploadManager) {
+          ctx.client.send({
+            type: "codex.upload.done",
             stream_id: msg.stream_id,
-            message: msg.message,
-            model: msg.model || undefined,
-            effort: msg.effort || undefined,
+            upload_id: msg.upload_id,
+            ok: false,
+            error: "upload_unavailable",
+          })
+          return
+        }
+        try {
+          const res = await ctx.uploadManager.addChunk({
+            upload_id: msg.upload_id,
+            filename: msg.filename,
+            media_type: msg.media_type,
+            total_size: msg.total_size,
+            total_chunks: msg.total_chunks,
+            chunk_index: msg.chunk_index,
+            data: msg.data,
+            cwd: msg.cwd || ctx.config?.claude_cwd || undefined,
           })
-          .catch((err) => {
+          if (res.done) {
             ctx.client.send({
-              type: "codex.error",
+              type: "codex.upload.done",
               stream_id: msg.stream_id,
-              error: err.message,
+              upload_id: msg.upload_id,
+              ok: true,
+              path: res.path,
+              filename: res.filename,
+              media_type: res.media_type,
+              size: res.size,
             })
+          }
+        } catch (err) {
+          ctx.client.send({
+            type: "codex.upload.done",
+            stream_id: msg.stream_id,
+            upload_id: msg.upload_id,
+            ok: false,
+            error: err?.message || String(err),
           })
+        }
+        return
+      }
+      case "codex.input":
+        // model/effort: turn/start (非 busy 時) にのみ反映される override。turn/steer
+        // (busy 時) は公式スキーマ上 model/effort 非対応のため、その場合は
+        // codex-stream-bridge.mjs 側で無視され次の非 busy な input() から効く。
+        // S2/S3 統合 (2026-07-05): S3 の自己修復 (turn/steer 失敗 → turn/start 自動
+        // リトライ) が付与する err.reason ('timeout' / 'turn_mismatch_retry_failed') を
+        // classifyCodexInputError が優先採用し、input_id 付きなら codex.input.nack の
+        // reason としてそのまま使う (handleCodexChatInput 内)。
+        handleCodexChatInput(msg, ctx)
         return
       case "codex.permission.reply":
         if (!ctx.codexBridge) return