@cocorograph/hub-agent 0.7.59 → 0.7.60

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cocorograph/hub-agent",
-  "version": "0.7.59",
+  "version": "0.7.60",
   "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 でも