@cocorograph/hub-agent 0.7.59 → 0.7.61

package/package.json

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

package/src/codex-stream-bridge.mjs

@@ -77,6 +77,41 @@ function flattenThreadItems(thread) {
   return items
 }
 
+/**
+ * resume 応答から Codex の「権威的なターン進行状態」を取り出す。
+ *
+ * ⚠️ Codex は Claude と違い、ターンが走っているかを **明示フィールド** で持つ (公式
+ * app-server スキーマで確認):
+ *   - Thread.status.type = notLoaded | idle | systemError | active
+ *   - Turn.status        = completed | interrupted | failed | inProgress
+ * そのため「会話履歴の末尾が user か assistant か」からの推測 (Claude 由来の
+ * deriveTurnActiveFromHistory) は不要かつ有害 (ツール実行のみで終わったターンや中断
+ * ターンで末尾が user メッセージになり、生成中スピナーが永久固着する既知バグの原因)。
+ *
+ * resume 時は app-server が新プロセスで、実際に走っているターンは無いため Codex は
+ * 通常 `idle` を返す。ゆえに `threadStatus === "active"` を唯一の権威 turn-active
+ * シグナルとして採用し、フロントの hydrate 時 turnActive をこれで決めさせる。
+ *
+ * @param {object|undefined} thread thread/resume の result.thread
+ * @returns {{threadStatus: string|null, lastTurnStatus: string|null, turnActive: boolean, activeTurnId: string|null}}
+ */
+export function deriveResumeTurnState(thread) {
+  const threadStatus = typeof thread?.status?.type === "string" ? thread.status.type : null
+  const turns = Array.isArray(thread?.turns) ? thread.turns : []
+  const lastTurn = turns.length ? turns[turns.length - 1] : null
+  const lastTurnStatus = typeof lastTurn?.status === "string" ? lastTurn.status : null
+  // 権威シグナル: スレッドが active のときだけ「ターン実行中」。fresh resume は idle。
+  const turnActive = threadStatus === "active"
+  // active かつ最後のターンが inProgress のときのみ activeTurnId を復元する
+  // (input() が turn/steer へ正しく分岐できるように)。それ以外は null のまま
+  // = 次の入力は turn/start になり、固着しない。
+  const activeTurnId =
+    turnActive && lastTurnStatus === "inProgress" && typeof lastTurn?.id === "string"
+      ? lastTurn.id
+      : null
+  return { threadStatus, lastTurnStatus, turnActive, activeTurnId }
+}
+
 /**
  * 配達保証 (S2, 2026-07-05): `input()` が reject したエラーを `codex.input.nack` の
  * `reason` へ分類する。
@@ -134,7 +169,8 @@ export class CodexStreamBridge extends EventEmitter {
   }
 
   /**
-   * @returns {Promise<{resuming: boolean, threadId: string, history: object[]}>}
+   * @returns {Promise<{resuming: boolean, threadId: string, history: object[],
+   *   threadStatus: string|null, lastTurnStatus: string|null, turnActive: boolean}>}
    */
   async attach({ stream_id, cwd, model, effort, approvalPolicy, sandbox, resumeThreadId }) {
     if (this.sessions.has(stream_id)) {
@@ -173,7 +209,23 @@ export class CodexStreamBridge extends EventEmitter {
       // 新規スレッド (thread/start) は履歴が無いので空配列。resume 時のみ平坦化する
       // (thread/start のレスポンスは turns を持たない仕様のため呼んでも常に空)。
       const history = resuming ? flattenThreadItems(result?.thread) : []
-      return { resuming, threadId: session.threadId, history }
+      // 案C: 権威的なターン状態を resume 応答から取り出してフロントへ渡す。
+      // これによりフロントは会話末尾からの推測をやめ、Thread.status で turnActive を
+      // 決められる (生成中スピナー固着バグの根治)。新規スレッドは常に idle 相当。
+      const turnState = resuming
+        ? deriveResumeTurnState(result?.thread)
+        : { threadStatus: "idle", lastTurnStatus: null, turnActive: false, activeTurnId: null }
+      // Codex が「ターン実行中」と権威的に報告した場合のみ activeTurnId を復元する
+      // (通常の fresh resume では null = 次入力が turn/start になり固着しない)。
+      session.activeTurnId = turnState.activeTurnId
+      return {
+        resuming,
+        threadId: session.threadId,
+        history,
+        threadStatus: turnState.threadStatus,
+        lastTurnStatus: turnState.lastTurnStatus,
+        turnActive: turnState.turnActive,
+      }
     } catch (err) {
       this.sessions.delete(stream_id)
       client.stop()

package/src/main.mjs

@@ -3952,6 +3952,14 @@ async function dispatch(msg, ctx) {
             // consumers.py の per-stream relay は content-blind なので backend 側の
             // 変更は不要 (_AGENT_PER_STREAM_TYPES の codex.ready がそのまま運ぶ)。
             history: info.history || [],
+            // 案C (権威的ターン状態): フロントは会話末尾からの推測 (deriveTurnActive
+            // FromHistory) をやめ、Codex が明示する Thread.status で turnActive を決める。
+            // resume 後は新プロセスで実行中ターンが無く thread_status='idle' が返るため、
+            // 生成中スピナー固着 (中断/ツールのみ終了ターンで末尾が user メッセージになる
+            // ケース) が根治する。
+            turn_active: info.turnActive === true,
+            thread_status: info.threadStatus || null,
+            last_turn_status: info.lastTurnStatus || null,
           })
           // S1 (2026-07): claude.attach と対称の identity 正本化。Codex は thread/start
           // 応答時点で threadId が確定するため (Claude の fresh とは異なり)、fresh でも

package/src/usage.mjs

@@ -1284,14 +1284,67 @@ function codexSessionsDir() {
 // (Claude の readOfficial の bucketize と同じ約束事)。
 const CODEX_DEFAULT_LIMIT = 100
 
-/** threadId から rollout jsonl の絶対パスを検索する（日付シャード配下、直近 N 日のみ走査）。
- *  7d 窓 + バッファで 9 日分を既定にする（月またぎでも大抵 1〜2 ディレクトリの readdir で済む）。
+// threadId → rollout 絶対パスのメモ (2026-07-15)。rollout ファイルは threadId ごとに
+// 不変（作成日ディレクトリに置かれ、以降はそのファイルへ追記され続ける）ため、一度解決
+// できたら永続的にキャッシュしてよい。フォールバック全走査 (下記) のコストを usage.request
+// ポーリング (既定 60s) のたびに払わないための保険。存在確認 (stat) で削除検知して捨てる。
+const _codexRolloutPathMemo = new Map() // threadId → fp
+
+export function _resetCodexRolloutPathMemo() {
+  _codexRolloutPathMemo.clear()
+}
+
+/** base 配下の全 Y/M/D ディレクトリを新しい順に走査して threadId の rollout を探す。
+ *  直近 lookbackDays の高速パスから漏れた「窓外の古い（=9 日以上前に作成された）長寿命
+ *  スレッド」を拾うためのフォールバック。resume で復帰した古いスレッドが該当する。
+ *  @returns {Promise<string|null>}
+ */
+async function scanAllDatesForCodexRollout(base, threadId) {
+  const suffix = `-${threadId}.jsonl`
+  const years = await fs.readdir(base).catch(() => [])
+  // 新しい年→月→日から辿ると、resume される（=比較的最近使われた）スレッドに早く当たる。
+  for (const y of years.filter((s) => /^\d{4}$/.test(s)).sort().reverse()) {
+    const yDir = path.join(base, y)
+    const months = await fs.readdir(yDir).catch(() => [])
+    for (const m of months.sort().reverse()) {
+      const mDir = path.join(yDir, m)
+      const days = await fs.readdir(mDir).catch(() => [])
+      for (const d of days.sort().reverse()) {
+        const dDir = path.join(mDir, d)
+        const files = await fs.readdir(dDir).catch(() => [])
+        const match = files.find((f) => f.endsWith(suffix))
+        if (match) return path.join(dDir, match)
+      }
+    }
+  }
+  return null
+}
+
+/** threadId から rollout jsonl の絶対パスを検索する（日付シャード配下）。
+ *  高速パス = 直近 `lookbackDays` 日の Y/M/D を走査（月またぎでも 1〜2 readdir で済む）。
+ *  ⚠️ rollout ファイルは「スレッド作成日」のディレクトリに置かれ、以降そのファイルへ
+ *  追記され続ける。そのため 9 日以上前に作成されたスレッドを resume で復帰させると、
+ *  作成日ディレクトリが高速パスの窓外にあり見つからず、context ドーナツ・5h/7d が
+ *  表示できなくなる（2026-07-15 の resume 修正で古いスレッド復帰が正しく動くようになり
+ *  露出）。高速パスで見つからなければ全日付フォールバック走査に落とし、結果を threadId
+ *  でメモ化する。
  *  `session-mirror.mjs`（Stream C ターミナルミラー）からも再利用するため export する。
  *  @returns {Promise<string|null>}
  */
 export async function findCodexRolloutFile(threadId, { lookbackDays = 9, now = Date.now() } = {}) {
   if (!threadId) return null
+  // メモ命中: ファイルが今も存在するなら即返す（消えていれば捨てて再探索）。
+  const memoed = _codexRolloutPathMemo.get(threadId)
+  if (memoed) {
+    try {
+      await fs.stat(memoed)
+      return memoed
+    } catch {
+      _codexRolloutPathMemo.delete(threadId)
+    }
+  }
   const base = codexSessionsDir()
+  // 高速パス: 直近 lookbackDays の日付シャードのみ。
   for (let i = 0; i < lookbackDays; i++) {
     const d = new Date(now - i * 24 * 60 * 60 * 1000)
     const y = String(d.getFullYear())
@@ -1301,9 +1354,16 @@ export async function findCodexRolloutFile(threadId, { lookbackDays = 9, now = D
     const files = await fs.readdir(dir).catch(() => null)
     if (!files) continue
     const match = files.find((f) => f.endsWith(`-${threadId}.jsonl`))
-    if (match) return path.join(dir, match)
+    if (match) {
+      const fp = path.join(dir, match)
+      _codexRolloutPathMemo.set(threadId, fp)
+      return fp
+    }
   }
-  return null
+  // フォールバック: 窓外の古い（長寿命 resume）スレッドを全日付走査で拾う。
+  const scanned = await scanAllDatesForCodexRollout(base, threadId)
+  if (scanned) _codexRolloutPathMemo.set(threadId, scanned)
+  return scanned
 }
 
 /** P5(perf): rollout ファイルの token_count 抽出結果を mtime+size でメモ化。 */