@cocorograph/hub-agent 0.7.72 → 0.7.73

package/package.json

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

package/src/codex-stream-bridge.mjs

@@ -93,15 +93,61 @@ const ABANDONED_SESSION_TTL_MS =
 
 const CLIENT_INFO = { name: "cockpit-hub-agent", title: "Cockpit", version: "1.0.0" }
 
+// T06499 (2026-07-18): 巨大スレッドの resume ガード。長期運用したスレッドの rollout は
+// 20MB 超まで肥大し得る (実測: メイン repo 540KB が正常なのに対し 20MB のスレッドあり)。
+// thread/resume 応答をそのまま平坦化して browser へ送ると、
+//   ① WS へ 20MB の JSON を積む → 転送で数秒フリーズ
+//   ② browser 側で全 item を codexHistoryToEvents → reducer merge → 数千バブル描画で
+//      メインスレッドがハング (履歴も、その裏で撃つ codex.sessions.request 由来の
+//      セッション切替バーも一切出ない = UX の断崖)
+// が起きる。thread/resume 自体はモデル側の会話コンテキスト復元のため全量が必要だが、
+// **browser へ渡す表示用履歴は末尾 N ターン分に絞る** ことで断崖を回避する。上限は
+// 「item 数」と「概算バイト数」の 2 軸で、末尾から詰めてどちらか先に達したら truncated。
+const HISTORY_MAX_ITEMS = Number(process.env.HUB_AGENT_CODEX_HISTORY_MAX_ITEMS) || 200
+const HISTORY_MAX_BYTES =
+  Number(process.env.HUB_AGENT_CODEX_HISTORY_MAX_BYTES) || 1.5 * 1024 * 1024
+
 // Slice 6: thread/resume が返す Thread.turns[].items[] を単一の時系列配列へ平坦化する。
 // turns は開始ターン順の配列、各 turn.items も時系列順のため単純結合で会話順を保てる。
-function flattenThreadItems(thread) {
+//
+// T06499: 末尾から maxItems / maxBytes の budget 内に収め、超過分は落として truncated=true を
+// 返す。末尾優先なのは「直近の会話が最も価値が高く、古い履歴は resume されたモデル側が保持して
+// いる」ため。budget を末尾から積むので、20MB スレッドでも全 item を stringify せず早期に打ち切る
+// (kept が budget に達した時点で残りの巨大な古い item には触れない)。
+// @returns {{items: object[], truncated: boolean, total: number}}
+function flattenThreadItems(thread, { maxItems = HISTORY_MAX_ITEMS, maxBytes = HISTORY_MAX_BYTES } = {}) {
   const turns = Array.isArray(thread?.turns) ? thread.turns : []
-  const items = []
+  const all = []
   for (const turn of turns) {
-    if (Array.isArray(turn?.items)) items.push(...turn.items)
+    if (Array.isArray(turn?.items)) all.push(...turn.items)
   }
-  return items
+  const total = all.length
+  const kept = []
+  let bytes = 0
+  let truncated = false
+  // 末尾 (最新) から詰める。budget 超過で打ち切り、truncated を立てる。
+  for (let i = all.length - 1; i >= 0; i--) {
+    if (kept.length >= maxItems) {
+      truncated = true
+      break
+    }
+    const item = all[i]
+    let size = 0
+    try {
+      size = JSON.stringify(item)?.length || 0
+    } catch {
+      size = 0
+    }
+    // 最低 1 件は必ず入れる (単一 item が maxBytes を超えても末尾 1 件は見せる)。
+    if (kept.length > 0 && bytes + size > maxBytes) {
+      truncated = true
+      break
+    }
+    kept.push(item)
+    bytes += size
+  }
+  kept.reverse() // 末尾から積んだので時系列順へ戻す。
+  return { items: kept, truncated, total }
 }
 
 /**
@@ -184,7 +230,15 @@ function userInputFromMessage(message) {
 }
 
 export class CodexStreamBridge extends EventEmitter {
-  constructor({ codexCmd, logger, clientFactory, detachTtlMs, rolloutPresence } = {}) {
+  constructor({
+    codexCmd,
+    logger,
+    clientFactory,
+    detachTtlMs,
+    rolloutPresence,
+    historyMaxItems,
+    historyMaxBytes,
+  } = {}) {
     super()
     this.codexCmd = codexCmd
     this.logger = logger
@@ -193,6 +247,11 @@ export class CodexStreamBridge extends EventEmitter {
     this._detachTtlMs = detachTtlMs ?? IDLE_DETACH_TTL_MS
     // #4 失敗分類の rollout 存在チェック (tri-state。テストから注入可能)。
     this._rolloutPresence = rolloutPresence || codexRolloutPresence
+    // T06499: 履歴 hydrate の上限 (テストから小さい値を注入可能)。
+    this._historyLimits = {
+      maxItems: historyMaxItems ?? HISTORY_MAX_ITEMS,
+      maxBytes: historyMaxBytes ?? HISTORY_MAX_BYTES,
+    }
     /** @type {Map<string, object>} stream_id -> session record */
     this.sessions = new Map()
   }
@@ -210,7 +269,8 @@ export class CodexStreamBridge extends EventEmitter {
    * なければ、通常の attach (thread/start | thread/resume) にフォールスルーする。
    *
    * @returns {Promise<{resuming: boolean, threadId: string, history: object[],
-   *   threadStatus: string|null, lastTurnStatus: string|null, turnActive: boolean}>}
+   *   historyTruncated: boolean, threadStatus: string|null, lastTurnStatus: string|null,
+   *   turnActive: boolean}>}
    */
   async attach({ stream_id, cwd, model, effort, approvalPolicy, sandbox, resumeThreadId, attachId }) {
     if (this.sessions.has(stream_id)) {
@@ -292,7 +352,12 @@ export class CodexStreamBridge extends EventEmitter {
       session.threadId = result?.thread?.id
       // 新規スレッド (thread/start) は履歴が無いので空配列。resume 時のみ平坦化する
       // (thread/start のレスポンスは turns を持たない仕様のため呼んでも常に空)。
-      const history = resuming ? flattenThreadItems(result?.thread) : []
+      // T06499: 巨大スレッドは末尾 N ターンに絞る (truncated=true なら browser がバナー表示)。
+      const flat = resuming
+        ? flattenThreadItems(result?.thread, this._historyLimits)
+        : { items: [], truncated: false, total: 0 }
+      const history = flat.items
+      const historyTruncated = flat.truncated
       // 案C: 権威的なターン状態を resume 応答から取り出してフロントへ渡す。
       // これによりフロントは会話末尾からの推測をやめ、Thread.status で turnActive を
       // 決められる (生成中スピナー固着バグの根治)。新規スレッドは常に idle 相当。
@@ -317,6 +382,10 @@ export class CodexStreamBridge extends EventEmitter {
           resuming,
           thread_status: turnState.threadStatus,
           live_for_cwd: this.describeLiveSessions(cwd).length,
+          // T06499: 巨大スレッド hydrate の可視化 (何件中何件を返したか)。
+          history_items: history.length,
+          history_total: flat.total,
+          history_truncated: historyTruncated,
         },
         "codex session attached",
       )
@@ -324,6 +393,7 @@ export class CodexStreamBridge extends EventEmitter {
         resuming,
         threadId: session.threadId,
         history,
+        historyTruncated,
         threadStatus: turnState.threadStatus,
         lastTurnStatus: turnState.lastTurnStatus,
         turnActive: turnState.turnActive,
@@ -389,6 +459,8 @@ export class CodexStreamBridge extends EventEmitter {
         resuming: true,
         threadId,
         history: [],
+        // reconnect の in-memory reattach は表示を保持しているので履歴を返さない = 常に非 truncated。
+        historyTruncated: false,
         threadStatus: session.activeTurnId ? "active" : "idle",
         lastTurnStatus: null,
         turnActive: !!session.activeTurnId,

package/src/main.mjs

@@ -4210,6 +4210,9 @@ async function dispatch(msg, ctx) {
             // consumers.py の per-stream relay は content-blind なので backend 側の
             // 変更は不要 (_AGENT_PER_STREAM_TYPES の codex.ready がそのまま運ぶ)。
             history: info.history || [],
+            // T06499: 巨大スレッドで末尾 N ターンに絞った場合 true。browser は
+            // 「以前の履歴は省略されています」バナーを出す (会話は resume 済みで継続可)。
+            history_truncated: info.historyTruncated === true,
             // 案C (権威的ターン状態): フロントは会話末尾からの推測 (deriveTurnActive
             // FromHistory) をやめ、Codex が明示する Thread.status で turnActive を決める。
             // resume 後は新プロセスで実行中ターンが無く thread_status='idle' が返るため、