@cocorograph/hub-agent 0.7.97 → 0.7.99

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cocorograph/hub-agent",
-  "version": "0.7.97",
+  "version": "0.7.99",
   "description": "Hub Hosted Cockpit のローカル常駐 agent。Hub と outbound WSS で接続し、ローカルの tmux/pty を中継する。",
   "type": "module",
   "license": "UNLICENSED",

package/src/hub-bundle.mjs

@@ -471,7 +471,7 @@ export async function applyMcpServers(
  */
 export async function applyCodexMcpServers(
   bundle,
-  { logger, nonInteractive = false, resolveBinImpl, runImpl } = {},
+  { agentId, agentToken, logger, nonInteractive = false, resolveBinImpl, runImpl } = {},
 ) {
   const servers = Array.isArray(bundle?.mcp_servers) ? bundle.mcp_servers : []
   if (servers.length === 0) {
@@ -512,25 +512,34 @@ export async function applyCodexMcpServers(
     }
   }
 
-  // MCP 承認モードを `~/.codex/config.toml` に反映する（2026-07-15）。
+  // MCP 承認モードと Hub のホスト資格ヘッダを `~/.codex/config.toml` に反映する。
   // ⚠️ `codex mcp add` には承認モードの永続設定オプションが無いため、Bundle が宣言した
   // `default_tools_approval_mode` を config.toml の `[mcp_servers.<name>]` テーブルへ直接
-  // マージする。対話 add の成否に関わらず全 target に対して実行する（add が「already exists」で
-  // 失敗しても承認設定は更新する要件）。非対話モードでは onlyExisting=true で「既存テーブルの承認モード
-  // 補完」だけを行い、未登録 server には新規テーブルを作らず pending 報告する。I/O・ネットワーク失敗
-  // （transient）は approvalError として上位（syncBundle）へ返し、state に「再試行すべき失敗」として
-  // 記録させる。config 破壊は _atomicWriteFilePreserving が防ぐ。
+  // マージする。また Codex CLI 0.145.0 時点では `mcp add --header` が無いため、Claude と同じ
+  // `X-Cockpit-Agent` を公式設定 `http_headers` へ直接マージする。ヘッダは `hub` / `hub_staff`
+  // の両方だけに付け、外部 MCP には付けない。
+  //
+  // 対話 add の成否に関わらず全 target に対して実行する（add が「already exists」で失敗しても
+  // 設定は更新する要件）。非対話モードでは onlyExisting=true で「既存テーブルの補完」だけを行い、
+  // 未登録 server には新規テーブルを作らず pending 報告する。I/O・ネットワーク失敗（transient）は
+  // approvalError として上位（syncBundle）へ返し、state に「再試行すべき失敗」として記録させる。
+  // config 破壊は _atomicWriteFilePreserving が防ぐ。
   let approvalUpdated = []
   let approvalPending = []
   let approvalSkipped = []
   let approvalError = null
   try {
-    const res = await applyCodexMcpApprovalModes(servers, { logger, onlyExisting: nonInteractive })
+    const res = await applyCodexMcpApprovalModes(servers, {
+      agentId,
+      agentToken,
+      logger,
+      onlyExisting: nonInteractive,
+    })
     approvalUpdated = res.updated
     approvalPending = res.pending || []
     approvalSkipped = res.skipped || []
   } catch (err) {
-    logger?.warn({ err: err.message }, "codex MCP approval mode の config.toml 反映に失敗")
+    logger?.warn({ err: err.message }, "codex MCP 設定の config.toml 反映に失敗")
     approvalError = err?.message || String(err)
   }
   return { added, skipped, approvalUpdated, approvalPending, approvalSkipped, approvalError }
@@ -554,7 +563,8 @@ function resolveCodexConfigPath() {
 
 /**
  * config.toml テキストへ、`[mcp_servers.<name>]` テーブルの `url` /
- * `default_tools_approval_mode` を**テーブル単位でサージカルに** upsert して返す（純関数）。
+ * `http_headers.X-Cockpit-Agent` / `default_tools_approval_mode` を**テーブル単位で
+ * サージカルに** upsert して返す（純関数）。
  *
  * 設計（config 全体を再生成しない・既存を壊さない）:
  *  - 対象テーブルの行範囲（ヘッダ行の次〜次の `[...]` テーブルヘッダ直前）だけを編集する。
@@ -567,18 +577,24 @@ function resolveCodexConfigPath() {
  *  - 不正な approvalMode は無視（url のみ・または no-op）。改行コード（LF/CRLF）は維持する。
  *
  * @param {string} configText
- * @param {{name: string, url?: string, approvalMode?: string, onlyExisting?: boolean}} opts
+ * @param {{name: string, url?: string, approvalMode?: string, hostCredential?: string, onlyExisting?: boolean}} opts
  *   onlyExisting=true のとき、標準テーブルが**まだ無い** server には新規テーブルを追記しない
  *   （config を無変更で返す）。自動同期（非対話）で使う: 未登録 MCP に承認モードだけ書くと
  *   OAuth 未認証の「半登録テーブル」を作ってしまうため、登録は対話経路（`codex mcp add`）に
  *   限定し、自動同期は既存テーブルの承認モード補完だけを行う。
  * @returns {string}
  */
-export function upsertCodexMcpApprovalMode(configText, { name, url, approvalMode, onlyExisting = false } = {}) {
+export function upsertCodexMcpApprovalMode(
+  configText,
+  { name, url, approvalMode, hostCredential, onlyExisting = false } = {},
+) {
   if (!name) return configText
   const mode = _CODEX_MCP_APPROVAL_MODES.has(approvalMode) ? approvalMode : null
   const kv = []
   if (typeof url === "string" && url) kv.push(["url", JSON.stringify(url)])
+  if (typeof hostCredential === "string" && hostCredential) {
+    kv.push(["http_headers", `{ "X-Cockpit-Agent" = ${JSON.stringify(hostCredential)} }`])
+  }
   if (mode) kv.push(["default_tools_approval_mode", JSON.stringify(mode)])
   if (kv.length === 0) return configText
 
@@ -634,8 +650,22 @@ export function upsertCodexMcpApprovalMode(configText, { name, url, approvalMode
       }
     }
     if (found >= 0) {
-      // 値だけ差し替え、インデント・キー左辺・**行末インラインコメント**を保持する。
-      lines[found] = _replaceTomlStringValue(lines[found], key, valStr)
+      if (key === "http_headers") {
+        // `http_headers` はユーザーが別のヘッダを持ち得る。行全体を置換せず、管理対象の
+        // X-Cockpit-Agent だけを inline table へマージする。安全に解釈できない形式なら
+        // config 全体を無変更で返し、呼び出し側の検証で skipped 扱いにする。
+        const merged = _upsertTomlInlineStringMapValue(
+          lines[found],
+          "http_headers",
+          "X-Cockpit-Agent",
+          JSON.stringify(hostCredential),
+        )
+        if (merged === null) return configText
+        lines[found] = merged
+      } else {
+        // 値だけ差し替え、インデント・キー左辺・**行末インラインコメント**を保持する。
+        lines[found] = _replaceTomlStringValue(lines[found], key, valStr)
+      }
       if (key === "url") urlLineIdx = found
     } else {
       toInsert.push(`${key} = ${valStr}`)
@@ -651,8 +681,8 @@ export function upsertCodexMcpApprovalMode(configText, { name, url, approvalMode
 }
 
 /**
- * Bundle の mcp_servers のうち承認モードを宣言したものについて、`~/.codex/config.toml` の
- * 該当テーブルへ `default_tools_approval_mode`（と url）を安全マージする。
+ * Bundle の mcp_servers のうち承認モードを宣言したもの、またはホスト資格を付ける Hub MCP
+ * について、`~/.codex/config.toml` の該当テーブルへ承認モード・url・http_headers を安全マージする。
  *
  *  - 承認モードが許可値でない server はスキップ（不正値を端末設定へ流さない）。
  *  - 変更が無ければ書き込まない（完全冪等）。
@@ -660,7 +690,7 @@ export function upsertCodexMcpApprovalMode(configText, { name, url, approvalMode
  *    残さない）。rename が失敗した場合は破壊的フォールバックを行わず中止し、既存 config を無変更で維持する。
  *
  * @param {Array<{name?: string, url?: string, default_tools_approval_mode?: string}>} servers
- * @param {{configPath?: string, logger?: any, fsImpl?: any, isWindows?: boolean, onlyExisting?: boolean}} [opts]
+ * @param {{configPath?: string, logger?: any, fsImpl?: any, isWindows?: boolean, onlyExisting?: boolean, agentId?: string, agentToken?: string}} [opts]
  *   configPath 省略時は resolveCodexConfigPath()。fsImpl / isWindows はテスト用の注入点（既定は実 fs / 実 OS）。
  *   onlyExisting=true（自動同期・非対話）のとき、標準テーブルが**まだ無い** server には新規
  *   テーブルを追記せず `pending` として報告する（未登録 MCP に承認モードだけ書いて OAuth 未認証の
@@ -670,10 +700,22 @@ export function upsertCodexMcpApprovalMode(configText, { name, url, approvalMode
  */
 export async function applyCodexMcpApprovalModes(
   servers,
-  { configPath, logger, fsImpl = fs, isWindows = process.platform === "win32", onlyExisting = false } = {},
+  {
+    configPath,
+    logger,
+    fsImpl = fs,
+    isWindows = process.platform === "win32",
+    onlyExisting = false,
+    agentId,
+    agentToken,
+  } = {},
 ) {
+  const hostCredential = agentId && agentToken ? `${agentId}:${agentToken}` : null
   const targets = (Array.isArray(servers) ? servers : []).filter(
-    (s) => s?.name && _CODEX_MCP_APPROVAL_MODES.has(s?.default_tools_approval_mode),
+    (s) =>
+      s?.name &&
+      (_CODEX_MCP_APPROVAL_MODES.has(s?.default_tools_approval_mode) ||
+        (hostCredential && HUB_MCP_NAMES.has(s.name))),
   )
   if (targets.length === 0) return { updated: [], skipped: [], pending: [] }
 
@@ -696,6 +738,7 @@ export async function applyCodexMcpApprovalModes(
   const skipped = []
   const pending = []
   for (const s of targets) {
+    const serverHostCredential = hostCredential && HUB_MCP_NAMES.has(s.name) ? hostCredential : null
     // 自動同期（onlyExisting）で標準テーブルが無い server は、新規テーブルを作らない。
     // 非標準形（空白入り/ドット記法/インライン）で既に定義されていれば「安全に編集できない」
     // → skipped、真に未登録なら「登録が必要」→ pending として区別する（ブラウザは開かない）。
@@ -719,12 +762,13 @@ export async function applyCodexMcpApprovalModes(
       name: s.name,
       url: s.url,
       approvalMode: s.default_tools_approval_mode,
+      hostCredential: serverHostCredential,
       onlyExisting,
     })
     if (candidate === next) {
       // 変化なし。原因が「既に正しく反映済み（＝ no-op）」か「非標準形で upsert が編集を拒否した」
       // かを検証で区別する。標準テーブルが健全なら no-op、そうでなければ適用不能としてスキップ報告。
-      if (!_verifyCodexServerTable(next, s.name, s.default_tools_approval_mode)) {
+      if (!_verifyCodexServerTable(next, s.name, s.default_tools_approval_mode, serverHostCredential)) {
         logger?.warn(
           { name: s.name },
           "codex config.toml の該当テーブルを安全に編集できないためスキップ（既存 config は不変）",
@@ -737,7 +781,7 @@ export async function applyCodexMcpApprovalModes(
     // 期待値でちょうど 1 つ・url は高々 1 つ・他形式（空白入り/インライン）の重複定義が無い」
     // ことを検証する。素の文字列編集が非標準 config で誤動作しても、ここで弾いて **既存 config を
     // 一切書き換えない**（worst case = 承認設定が付かない＝現状維持）。
-    if (!_verifyCodexServerTable(candidate, s.name, s.default_tools_approval_mode)) {
+    if (!_verifyCodexServerTable(candidate, s.name, s.default_tools_approval_mode, serverHostCredential)) {
       logger?.warn(
         { name: s.name },
         "codex config.toml の該当テーブルを安全に編集できないためスキップ（既存 config は不変）",
@@ -752,7 +796,7 @@ export async function applyCodexMcpApprovalModes(
 
   // ⚠️ 失敗しても既存 config.toml を必ず維持する fail-safe な atomic write。
   await _atomicWriteFilePreserving(cfgPath, next, fileMode, { fsImpl, isWindows, logger })
-  logger?.info({ updated, skipped, pending }, "codex MCP approval mode を config.toml へ反映")
+  logger?.info({ updated, skipped, pending }, "codex MCP 設定を config.toml へ反映")
   return { updated, skipped, pending }
 }
 
@@ -862,6 +906,81 @@ function _replaceTomlStringValue(line, key, quotedVal) {
   return `${indent}${key} = ${quotedVal}`
 }
 
+/**
+ * TOML inline table の string entry を 1 件だけ upsert する。
+ *
+ * 例: `http_headers = { "Authorization" = "..." } # keep` に
+ * `"X-Cockpit-Agent" = "ag:token"` を追加する。既存 entry・行末コメント・他ヘッダは保持する。
+ * inline table として安全に読めない場合は null（呼び出し側は config を変更しない）。
+ */
+function _upsertTomlInlineStringMapValue(line, key, entryKey, quotedVal) {
+  const keyRe = new RegExp(`^(\\s*${_escapeRegExp(key)}\\s*=\\s*)\\{`)
+  const prefixMatch = line.match(keyRe)
+  if (!prefixMatch) return null
+
+  // `#` は TOML 文字列の外側だけコメント開始。コメント内の `}` を inline table の終端と
+  // 誤認しないよう、quote / escape を追跡してコード部分を切り出す。
+  let inDouble = false
+  let inSingle = false
+  let escaped = false
+  let commentIdx = line.length
+  for (let i = prefixMatch[0].length; i < line.length; i++) {
+    const ch = line[i]
+    if (escaped) {
+      escaped = false
+      continue
+    }
+    if (inDouble && ch === "\\") {
+      escaped = true
+      continue
+    }
+    if (!inSingle && ch === '"') inDouble = !inDouble
+    else if (!inDouble && ch === "'") inSingle = !inSingle
+    else if (!inDouble && !inSingle && ch === "#") {
+      commentIdx = i
+      break
+    }
+  }
+  if (inDouble || inSingle || escaped) return null
+
+  const code = line.slice(0, commentIdx)
+  const openIdx = prefixMatch[0].lastIndexOf("{")
+  const closeIdx = code.lastIndexOf("}")
+  if (closeIdx <= openIdx || code.slice(closeIdx + 1).trim() !== "") return null
+
+  const body = code.slice(openIdx + 1, closeIdx)
+  const entryRe = new RegExp(
+    `((?:"${_escapeRegExp(entryKey)}"|${_escapeRegExp(entryKey)})\\s*=\\s*)"(?:[^"\\\\]|\\\\.)*"`,
+  )
+  let nextBody
+  if (entryRe.test(body)) {
+    nextBody = body.replace(entryRe, (_whole, lhs) => `${lhs}${quotedVal}`)
+  } else {
+    const trailing = body.match(/\\s*$/)?.[0] || ""
+    const content = body.slice(0, body.length - trailing.length)
+    const entry = `${JSON.stringify(entryKey)} = ${quotedVal}`
+    nextBody = content.trim() ? `${content}, ${entry}${trailing}` : ` ${entry} `
+  }
+  return `${line.slice(0, openIdx + 1)}${nextBody}${line.slice(closeIdx)}`
+}
+
+/** 対象 inline table 内の string entry の raw quoted value と出現数を返す。 */
+function _readTomlInlineStringMapValue(line, key, entryKey) {
+  const keyRe = new RegExp(`^\\s*${_escapeRegExp(key)}\\s*=\\s*\\{(.*)\\}\\s*(?:#.*)?$`)
+  const m = line.match(keyRe)
+  if (!m) return { count: 0, value: null, valid: false }
+  const entryRe = new RegExp(
+    `(?:"${_escapeRegExp(entryKey)}"|${_escapeRegExp(entryKey)})\\s*=\\s*("(?:[^"\\\\]|\\\\.)*")`,
+    "g",
+  )
+  const matches = [...m[1].matchAll(entryRe)]
+  return {
+    count: matches.length,
+    value: matches.length === 1 ? matches[0][1] : null,
+    valid: true,
+  }
+}
+
 /**
  * マージ結果の config.toml テキストで、`name` の MCP サーバーテーブルが**安全に**編集された
  * 状態か検証する（書き込み前のフェイルセーフ）。以下を全て満たすときのみ true:
@@ -872,7 +991,7 @@ function _replaceTomlStringValue(line, key, quotedVal) {
  *  - `url` は高々 1 つ（重複していない）。
  * いずれか外れたら false（＝呼び出し側は書き込まず既存 config を保持する）。
  */
-function _verifyCodexServerTable(text, name, mode) {
+function _verifyCodexServerTable(text, name, mode, hostCredential = null) {
   const n = _escapeRegExp(name)
   const lines = text.split(/\r?\n/)
   const bracketRe = new RegExp(`^\\s*\\[\\s*mcp_servers\\s*\\.\\s*"?${n}"?\\s*\\]\\s*$`)
@@ -904,8 +1023,10 @@ function _verifyCodexServerTable(text, name, mode) {
   }
   let modeCount = 0
   let urlCount = 0
+  let httpHeadersCount = 0
   let modeOk = false
-  const expectedVal = JSON.stringify(mode) // 例: "approve"
+  const expectedVal = _CODEX_MCP_APPROVAL_MODES.has(mode) ? JSON.stringify(mode) : null // 例: "approve"
+  let hostHeaderOk = !hostCredential
   // 値（クォート文字列）だけを解析し、行末インラインコメント（` # ...`）は許容する。
   // 行全体の厳密一致にすると `default_tools_approval_mode = "approve" # keep` を弾いてしまい、
   // upsert が正しく更新しても書き込みがスキップされて古い値が残る（2026-07-15 レビュー指摘）。
@@ -917,8 +1038,20 @@ function _verifyCodexServerTable(text, name, mode) {
       if (m && m[1] === expectedVal) modeOk = true
     }
     if (/^\s*url\s*=/.test(lines[i])) urlCount++
+    if (/^\s*http_headers\s*=/.test(lines[i])) {
+      httpHeadersCount++
+      if (hostCredential) {
+        const parsed = _readTomlInlineStringMapValue(lines[i], "http_headers", "X-Cockpit-Agent")
+        hostHeaderOk =
+          parsed.valid && parsed.count === 1 && parsed.value === JSON.stringify(hostCredential)
+      }
+    }
   }
-  return modeCount === 1 && modeOk && urlCount <= 1
+  const modeValid = expectedVal ? modeCount === 1 && modeOk : modeCount <= 1
+  const headersValid = hostCredential
+    ? httpHeadersCount === 1 && hostHeaderOk
+    : httpHeadersCount <= 1
+  return modeValid && headersValid && urlCount <= 1
 }
 
 /**
@@ -1384,7 +1517,7 @@ async function _syncBundleLocked({ hubUrl, agentId, agentToken, logger, fetchImp
   let mcp = { added: [], skipped: [] }
   try {
     mcp = cliKind === "codex"
-      ? await applyCodexMcpServers(bundle, { logger, nonInteractive })
+      ? await applyCodexMcpServers(bundle, { agentId, agentToken, logger, nonInteractive })
       : await applyMcpServers(bundle, { agentId, agentToken, logger, nonInteractive })
   } catch (err) {
     logger?.warn({ cliKind, err: err.message }, "applyMcpServers failed (continuing)")

package/src/main.mjs

@@ -2861,9 +2861,12 @@ const STREAMS_SYNC_GRACE_MS = 45_000
  * Plan ε: `agent.streams.sync.response` を受けて backend ↔ agent の現存
  * stream_id を能動同期する。
  *
- * - local にあって backend にない → ptyBridge.detach で即時 kill (孤児)
- * - backend にあって local にない → backend に pty.error を通知 (browser に
- *   "pty 死んでます" を表示するため)
+ * - PTY: local にあって backend にない → ptyBridge.detach、逆差分 → pty.error
+ * - Claude/Codex: mode 別 snapshot から外れた古い subscriber を grace 付きで掃除
+ *
+ * active_stream_ids だけを全件 PTY とみなすと、正常な Claude/Codex に
+ * pty.error(stream_not_found_on_agent) を返して再 attach storm を誘発するため、
+ * 新 backend の active_streams を優先する。
  *
  * dispatch から呼ぶ用のヘルパーだが、テストから直接叩けるよう export している。
  */
@@ -2871,6 +2874,32 @@ export function handleStreamsSyncResponse(msg, ctx) {
   const activeIds = new Set(
     Array.isArray(msg?.active_stream_ids) ? msg.active_stream_ids : [],
   )
+  const activeByMode = { pty: new Set(), claude: new Set(), codex: new Set() }
+  const classifiedIds = new Set()
+  if (Array.isArray(msg?.active_streams)) {
+    for (const item of msg.active_streams) {
+      const streamId = item?.stream_id
+      const mode = item?.mode
+      const modeSet = activeByMode[mode]
+      if (typeof streamId !== "string" || !streamId || !(modeSet instanceof Set)) continue
+      modeSet.add(streamId)
+      classifiedIds.add(streamId)
+    }
+  }
+  // Blue-Green ローリング中に旧 BrowserConsumer の mode 無し応答が混ざった場合は
+  // typed snapshot を authoritative とみなさない。既知 chat stream だけ除外して
+  // legacy 互換を維持し、正常な Claude/Codex に ghost PTY error を返さない。
+  const haveCompleteModeSnapshot =
+    Array.isArray(msg?.active_streams)
+    && classifiedIds.size === activeIds.size
+    && Array.from(classifiedIds).every((id) => activeIds.has(id))
+  const knownChatIds = new Set([
+    ...Array.from(ctx.claudeBridge?.sessions?.keys?.() ?? []),
+    ...Array.from(ctx.codexBridge?.sessions?.keys?.() ?? []),
+  ])
+  const activePtyIds = haveCompleteModeSnapshot
+    ? activeByMode.pty
+    : new Set(Array.from(activeIds).filter((id) => !knownChatIds.has(id)))
   const localIds = new Set(ctx.ptyBridge.list())
   // churn 退化スナップショット保護 (ack_lost 根治 / 2026-06-17 根因 rank3)。
   // backend は browser 群へ _STREAMS_SYNC_TIMEOUT_S(0.5s) だけ問い合わせて active set を
@@ -2881,7 +2910,7 @@ export function handleStreamsSyncResponse(msg, ctx) {
   // 空 set は信用せず kill を一切行わない (真の孤児は 10min GC + maxStreams 上限が回収する)。
   const haveAuthoritativeActiveSet = activeIds.size > 0
   for (const sid of localIds) {
-    if (activeIds.has(sid)) continue
+    if (activePtyIds.has(sid)) continue
     if (!haveAuthoritativeActiveSet) continue
     // grace guard: 直近 STREAMS_SYNC_GRACE_MS 以内に touch (attach/write/resize/pty 出力) された
     // stream は「browser が再接続中で 0.5s 集計に間に合わなかっただけ」の可能性が高い。猶予内は
@@ -2901,7 +2930,7 @@ export function handleStreamsSyncResponse(msg, ctx) {
     )
     ctx.ptyBridge.detach({ stream_id: sid })
   }
-  for (const sid of activeIds) {
+  for (const sid of activePtyIds) {
     if (!localIds.has(sid)) {
       ctx.logger?.warn?.(
         { stream_id: sid, request_id: msg?.request_id },
@@ -2914,6 +2943,51 @@ export function handleStreamsSyncResponse(msg, ctx) {
       })
     }
   }
+
+  if (haveCompleteModeSnapshot) {
+    // reconnect 集計は browser ごとの復帰順で一時的に部分集合になり得る。
+    // 同じ mode の現役購読を1件も確認できない段階では、その mode 全体を掃除しない。
+    if (activeByMode.claude.size > 0) {
+      pruneInactiveChatSubscribers(
+        ctx.claudeBridge,
+        activeByMode.claude,
+        "claude",
+        ctx.logger,
+      )
+    }
+    if (activeByMode.codex.size > 0) {
+      pruneInactiveChatSubscribers(
+        ctx.codexBridge,
+        activeByMode.codex,
+        "codex",
+        ctx.logger,
+      )
+    }
+  }
+}
+
+/** backend の mode-aware snapshot に存在しない死 browser subscriber を除去する。
+ * 再接続が 0.5s 集計に間に合わなかった場合に備え、直近活性が grace 内の stream は保護する。 */
+export function pruneInactiveChatSubscribers(bridge, activeIds, mode, logger, now = Date.now()) {
+  if (!bridge?.sessions || typeof bridge.detach !== "function") return 0
+  let removed = 0
+  for (const session of new Set(bridge.sessions.values())) {
+    for (const streamId of Array.from(session?.streamIds ?? [])) {
+      if (activeIds.has(streamId)) continue
+      const lastSeen = session?.lastActivityByStream?.get?.(streamId) ?? 0
+      if (lastSeen > 0 && now - lastSeen < STREAMS_SYNC_GRACE_MS) continue
+      bridge.detach({ stream_id: streamId })
+      // Codex は live session の索引を最低1件残す不変条件があり、最後の1件では
+      // detachRequested を立てるだけで streamIds からは消さない。実際に消えた件だけ数える。
+      if (session.streamIds?.has?.(streamId)) continue
+      removed += 1
+      logger?.info?.(
+        { stream_id: streamId, mode, idle_ms: lastSeen > 0 ? now - lastSeen : null },
+        "inactive chat subscriber pruned after streams sync",
+      )
+    }
+  }
+  return removed
 }
 
 /**
@@ -3522,6 +3596,9 @@ async function dispatch(msg, ctx) {
         // 5s タイムアウトのような明示的な timer は持たず、再接続時に再度 request
         // が飛ぶので無害。
         handleStreamsSyncResponse(msg, ctx)
+        // buffered pty/control event は browser の購読集合が確定してから再送する。
+        // request_id は WsClient 側で現 reconnect 世代と照合され、古い応答は無視される。
+        ctx.client.completeStreamsSync?.(msg)
         return
       case "claude.attach": {
         // Sprint G: stream-json モードで Claude Code を起動。

package/src/ws-client.mjs

@@ -66,8 +66,9 @@ const PTY_BUFFER_MAX_AGE_MS = 30_000
 // `claude.jsonl.event ... "ws send skipped (not open)"` のドロップを観測)。
 //   - pty.input.ack: 喪失すると browser の pendingAcks が永久滞留し「送信待ち(未配信)」が
 //     消えない (S1/S3)。再接続 flush で遅れて届けば即解消する。
-//   - claude.jsonl.event / claude.event / session.event: 喪失すると新規セッションの
-//     楽観バブルが本物へ昇格できず「生成は始まったがバブルが出ない」(S5)。
+//   - claude/codex の event / ready / exit / error / permission / input ack,nack:
+//     喪失すると新規セッションの楽観バブルが本物へ昇格できず、再 attach も固着する。
+//   - claude.jsonl.event / session.event: TUI と一覧の確定状態を復元する。
 //   - pty.exit / pty.ready / pty.error: stream ライフサイクルの節目。落とすと browser の
 //     再 attach/復帰判断が狂う。
 // pty.data とは別バッファにするのは、高頻度な pty.data の洪水で低頻度な ack/event が
@@ -80,11 +81,29 @@ const BUFFERED_CTRL_TYPES = new Set([
   "pty.error",
   "claude.jsonl.event",
   "claude.event",
+  "claude.ready",
+  "claude.exit",
+  "claude.error",
+  "claude.permission.request",
+  "claude.permission.cancel",
+  "claude.input.ack",
+  "claude.input.nack",
+  "codex.event",
+  "codex.ready",
+  "codex.exit",
+  "codex.error",
+  "codex.permission.request",
+  "codex.input.ack",
+  "codex.input.nack",
   "session.event",
 ])
 // 制御/イベントバッファの上限。低頻度なので frames は小さめ、age は pty と揃える。
 const CTRL_BUFFER_MAX_FRAMES = 200
 const CTRL_BUFFER_MAX_AGE_MS = 30_000
+// reconnect 後の buffered event は backend が browser の active stream 集合を
+// 回収し終えるまで流さない。通常は 0.5s で応答する。旧 backend 互換のため 2s で
+// barrier を解除するが、通常時の送受信経路には一切待ちを追加しない。
+const STREAMS_SYNC_BARRIER_TIMEOUT_MS = 2_000
 
 /** SDK-P2 (2026-07-08): claude.event が「ephemeral な生成中 delta」かどうか。
  *  stream_event の content_block_delta (text_delta / thinking_delta) は高頻度で流れる
@@ -97,6 +116,12 @@ function isEphemeralDeltaEvent(obj) {
   return ev.event?.type === "content_block_delta"
 }
 
+/** Codex App Server の item/agentMessage/delta 等は再水和可能な高頻度delta。 */
+function isEphemeralCodexDeltaEvent(obj) {
+  const method = obj?.event?.method
+  return typeof method === "string" && method.toLowerCase().endsWith("/delta")
+}
+
 export class WsClient extends EventEmitter {
   /**
    * @param {{ hub_url: string, agent_id: string, agent_token: string }} config
@@ -149,6 +174,10 @@ export class WsClient extends EventEmitter {
     // 制御/イベント系 (ack / jsonl.event 等) の outbound buffer。pty.data とは別管理で、
     // 高頻度 pty.data の洪水に evict されないようにする (機構③)。entry: { obj, ts }
     this.ctrlOutboundBuffer = []
+    // reconnect 世代ごとの stream sync barrier。古い request_id の遅延応答で
+    // 現接続の buffer を flush しないよう request_id を照合する。
+    this.pendingStreamsSyncRequestId = null
+    this.streamsSyncBarrierTimer = null
     // 直前の close 原因が CF/origin の 5xx か。次回 backoff の下限を引き上げる。
     this.lastCloseWas5xx = false
     // 接続が STABLE_CONNECTION_MS 維持できたら backoff/5xx フラグをリセットする
@@ -190,6 +219,7 @@ export class WsClient extends EventEmitter {
     })
 
     ws.on("close", (code, reason) => {
+      this._clearStreamsSyncBarrier()
       this._clearStableReset()
       this._stopHeartbeat()
       this._stopBundleWatcher()
@@ -236,11 +266,8 @@ export class WsClient extends EventEmitter {
     // 1〜2 秒間隔の再接続ループに陥らない。
     this._armStableReset()
     this.logger?.info("ws open")
-    // 切断中に積んだ pty.data を flush。hello より先に送ると backend で stream
-    // 未登録のため unknown_stream error になる可能性があるが、hello の応答待ち
-    // 同期は backend が承認するため hello 送信後の同期 send_json で問題ない。
-    // ただし flush は hello 直後ではなく streams.sync.request の後に置く方が
-    // 安全 (sync 完了で stream_id がサーバに復元される想定)。
+    // 切断中に積んだ frame は hello 後も即時 flush しない。streams.sync.response で
+    // browser の購読集合が復元されたことを確認してから、現役 stream 宛だけ再送する。
     // hello 前に最新の bundle version / CLI 別ステータスを読み直す (再接続時の鮮度確保)
     this._refreshBundleVersion()
     this._refreshBundleStatus()
@@ -260,12 +287,12 @@ export class WsClient extends EventEmitter {
     // ptyBridge.list() と差分を取って kill する。request_id は uuid で
     // 重複排除。backend が古い (= Plan ε 未対応) なら "unknown_type" error が
     // 返るだけで動作には影響しない。
+    const streamsSyncRequestId = randomUUID()
     this._sendJson({
       type: "agent.streams.sync.request",
-      request_id: randomUUID(),
+      request_id: streamsSyncRequestId,
     })
-    this._flushPtyBuffer()
-    this._flushCtrlBuffer()
+    this._armStreamsSyncBarrier(streamsSyncRequestId)
     this._startHeartbeat()
     this._startBundleWatcher()
     this.emit("open")
@@ -278,8 +305,13 @@ export class WsClient extends EventEmitter {
    * buffer しない (warn のみ)。ack / event 系は 1 件ずつ意味を持つので別バッファに保持する。
    */
   send(obj) {
-    if (!this.ws || this.ws.readyState !== WebSocket.OPEN) {
-      const type = obj?.type
+    const type = obj?.type
+    const wsOpen = this.ws?.readyState === WebSocket.OPEN
+    // sync barrier 中に新しく発生した frame も同じ buffer へ積み、切断中 frame より
+    // 先に送って時系列を逆転させない。heartbeat 等の非 buffer 制御系は通常どおり送る。
+    const holdForStreamsSync = Boolean(this.pendingStreamsSyncRequestId)
+      && (type === "pty.data" || BUFFERED_CTRL_TYPES.has(type))
+    if (!wsOpen || holdForStreamsSync) {
       if (type === "pty.data") {
         this._bufferPtyData(obj)
         return false
@@ -294,11 +326,16 @@ export class WsClient extends EventEmitter {
         if (type === "claude.event" && isEphemeralDeltaEvent(obj)) {
           return false
         }
+        if (type === "codex.event" && isEphemeralCodexDeltaEvent(obj)) {
+          return false
+        }
         this._bufferCtrl(obj)
         return false
       }
-      this.logger?.warn({ type }, "ws send skipped (not open)")
-      return false
+      if (!wsOpen) {
+        this.logger?.warn({ type }, "ws send skipped (not open)")
+        return false
+      }
     }
     return this._sendJson(obj)
   }
@@ -389,9 +426,55 @@ export class WsClient extends EventEmitter {
     )
   }
 
+  /** reconnect stream sync の完了通知。現接続の request_id と一致し、browser の
+   * active stream が1件以上復元されたときだけ buffered frame を flush する。
+   * @returns {boolean} 現在の barrier を解除した場合 true。 */
+  completeStreamsSync(msg) {
+    const requestId = msg?.request_id
+    if (!requestId || requestId !== this.pendingStreamsSyncRequestId) return false
+
+    const activeIds = new Set(
+      Array.isArray(msg?.active_stream_ids)
+        ? msg.active_stream_ids.filter((id) => typeof id === "string" && id)
+        : [],
+    )
+    // backend の 0.5s 集計窓では、browser がまだ再接続しておらず空 snapshot が
+    // 返ることがある。空を authoritative として flush/drop すると live stream の
+    // frame を失うため、2s compatibility timeout まで barrier を維持する。
+    if (activeIds.size === 0) return false
+    this._clearStreamsSyncBarrier()
+    this._flushPtyBuffer()
+    this._flushCtrlBuffer()
+    return true
+  }
+
+  _armStreamsSyncBarrier(requestId) {
+    this._clearStreamsSyncBarrier()
+    this.pendingStreamsSyncRequestId = requestId
+    this.streamsSyncBarrierTimer = setTimeout(() => {
+      if (this.pendingStreamsSyncRequestId !== requestId) return
+      this.pendingStreamsSyncRequestId = null
+      this.streamsSyncBarrierTimer = null
+      this.logger?.warn?.(
+        { request_id: requestId },
+        "streams sync barrier timed out; flushing buffered frames for legacy backend",
+      )
+      this._flushPtyBuffer()
+      this._flushCtrlBuffer()
+    }, STREAMS_SYNC_BARRIER_TIMEOUT_MS)
+    this.streamsSyncBarrierTimer.unref?.()
+  }
+
+  _clearStreamsSyncBarrier() {
+    if (this.streamsSyncBarrierTimer) clearTimeout(this.streamsSyncBarrierTimer)
+    this.streamsSyncBarrierTimer = null
+    this.pendingStreamsSyncRequestId = null
+  }
+
   /** Reconnect を止めて切断する。 */
   stop() {
     this.stopped = true
+    this._clearStreamsSyncBarrier()
     this._clearStableReset()
     this._stopHeartbeat()
     this._stopBundleWatcher()