@cocorograph/hub-agent 0.8.11 → 0.8.13

package/bin/hub-agent.mjs

@@ -11,6 +11,12 @@
  *   - stop             : daemon 停止 (Sprint J で launchd / systemd と併用)
  *   - plugins list     : プラグイン一覧
  */
+// R3(d): libuv スレッドプールを拡張する。サイドバー snapshot の全セッション jsonl 読み込みが、
+// attach / history の fs と既定 4 スレッドのプールを奪い合って切替が体感で遅くなる。libuv は
+// プール初回利用時に UV_THREADPOOL_SIZE を読むため、いかなる fs/dns/crypto 非同期処理より前
+// (= プロセス最初期・import より前) に設定する。既に設定済みなら運用者の指定を尊重する。
+if (!process.env.UV_THREADPOOL_SIZE) process.env.UV_THREADPOOL_SIZE = "16"
+
 import { readFileSync } from "node:fs"
 import { fileURLToPath } from "node:url"
 import path from "node:path"

package/package.json

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

package/src/claude-stream-bridge.mjs

@@ -523,11 +523,12 @@ export class ClaudeStreamSession {
     this._permissionResolvers = new Map()
     /** 現在ターン実行中か (多重 query 防止) */
     this._busy = false
-    /** SDK-P0-3 (2026-07-10): 現ターンが既に終端処理済みか (idle / abort の
+    /** SDK-P0-3 (2026-07-10): 現ターンが既に終端処理済みか (result / idle / abort の
      *  いずれか 1 回だけ _busy=false + drain させるための冪等ガード)。resident query は
      *  `result` の後にもバックグラウンド処理が続き、最後に権威的な
-     *  `session_state_changed:idle` が流れる。通常完了では idle だけが settle し、
-     *  明示 interrupt だけが先行して settled を立てる。ターン開始時に false へ戻す。 */
+     *  `session_state_changed:idle` が流れることがある。実 SDK では result 後に idle が
+     *  来ないターンもあるため、result / idle の先着 1 件だけが settle し、遅延 idle は
+     *  _staleIdleExpected で次ターンから隔離する。ターン開始時に false へ戻す。 */
     this._turnSettled = false
     /** SDK-P0-3: 現ターンが 1 件でもストリームイベントを出したか。
      *  「前ターンの遅延 idle が、drain で始まったばかりの次ターンを誤終了させる」レースの
@@ -1630,10 +1631,11 @@ export class ClaudeStreamSession {
     }
   }
 
-  /** resident の権威的な「ターン終端」を 1 箇所に集約する。
-   *  通常完了は SDK の session_state_changed:idle だけが呼ぶ。result は最終結果の
-   *  flush であり、バックグラウンド処理を含むターン全体の終了境界ではない。
-   *  @param {string} reason "idle" — ログ用
+  /** resident の「ターン終端」を 1 箇所に集約する。
+   *  SDK は result 後に session_state_changed:idle を返すことがあるが、実環境では
+   *  idle が欠落するターンもある。result / idle の先着を終端とし、result で畳んだ後の
+   *  遅延 idle はガードで次ターンから隔離する。
+   *  @param {string} reason "result" | "idle" — ログ用
    *  @param {(msg: string) => void} [denyPending] 未解決 permission を閉じるクロージャ
    */
   _settleResidentTurn(reason, denyPending) {
@@ -1641,6 +1643,10 @@ export class ClaudeStreamSession {
     this._turnSettled = true
     denyPending?.("turn ended")
     this._busy = false
+    // result の後に同一ターンの idle が遅れて届く場合がある。pending drain は同期的に
+    // 次ターンの busy を立てるため、その idle を新ターンへ誤帰属させないよう先にガードする。
+    // idle 自身で畳んだ場合は既に消費済みなので張らない。
+    if (reason === "result") this._armStaleIdleGuard()
     // 改修4 (A): シリアライズした pending があれば次の 1 件を InputQueue へ流す。
     // ultracode (0.6.28): _drainResidentPending は applyFlagSettings を await するため
     // async。for await ループ内からは fire-and-forget で呼ぶ (最初の await より前に
@@ -1714,6 +1720,12 @@ export class ClaudeStreamSession {
     // 正規の中断は interrupt() だが、control request が失敗/無応答のときに generator を畳む
     // 最終手段が無いと、close()/shutdown() で CLI 子プロセスが残留する。
     this._residentAbortController = new AbortController()
+    // R1(a): この run の AbortController を捕捉する。finally で「常駐 generator が返却された理由」を
+    // 判別するのに使う。我々が意図的に畳んだ (close / interrupt フォールバックの keep-alive
+    // hard-abort) ときだけ signal.aborted=true になる。子プロセスが自然終了 (クラッシュ/異常終了)
+    // したときは我々は abort していないので false。this.* 参照だと後続 run が再代入した別
+    // controller を読んでしまうため、必ずこの run 固有のローカル参照で判定する。
+    const myAbort = this._residentAbortController
     const options = {
       cwd: this.cwd,
       env: siblingEnvFor(this.cwd),
@@ -1766,12 +1778,12 @@ export class ClaudeStreamSession {
         }
         if (msg?.type === "result") {
           if (typeof msg.session_id === "string") this.sessionId = msg.session_id
-          // result は結果 flush でありターン終了ではない。SDK の型定義が権威的な
-          // turn-over signal とする session_state_changed:idle まで busy を維持し、
-          // pending を streaming input へ流さない。
           // 現ターンの result が届いた時点で前ターンの遅延 idle は順序保証により
-          // 既に通過済みなので、interrupt 由来のガードだけ解除できる。
+          // 既に通過済み。古いガードを解除し、result 用のガードを張り直して settle する。
+          // 実 SDK では result 後に idle が来ないターンがあるため、idle 待ちだけにすると
+          // _busy が永久に true のまま固着し、以後の入力が pending から drain されない。
           this._clearStaleIdleGuard()
+          this._settleResidentTurn("result", denyPending)
         } else if (isSessionIdleEvent(msg)) {
           // SDK-P0-3 (2026-07-10): result が届かずに idle でターンが終わるケースの救済。
           // これを見ていなかったため _busy が true で固着し、以降の送信が
@@ -1876,6 +1888,40 @@ export class ClaudeStreamSession {
           next.ultracode === true,
         )
         this._emitQueueState([next.text], { startedIds: [next.id] })
+      } else if (
+        !this._closed &&
+        !this._residentSendInFlight &&
+        !myAbort?.signal?.aborted
+      ) {
+        // R1(a) 孤児根絶: detach-reap でも pending 再起動でもなく、我々の意図的 fold
+        // (close / interrupt フォールバックの keep-alive hard-abort = myAbort.signal.aborted)
+        // でもないのに常駐 generator が返却された = 子プロセスが自然終了した (クラッシュ/異常終了)。
+        // _residentSendInFlight 中 (ABA/FIFO: 起動済み query の送信が reconcile を await 中) は
+        // await 復帰後の送信が fresh-start で回復させるため除外済み。
+        if (this._detached) {
+          // browser が離れた warm セッションで子が死亡 = 真の孤児。誰も見ておらず、死んだ query は
+          // R1(b) で reattach 対象にもならないため warm 保持する意味が無い。即 close + onReap で
+          // _liveBySession から evict し browser へ exit を通知する (既存 reap 経路と同じ冪等処理)。
+          // 従来はこの経路が無く、warm 中に子が死ぬと _closed=false のまま索引に残って孤児化し、
+          // 枠を占有し続け reattach が死んだ session を引き当てていた。
+          try {
+            this.close()
+          } finally {
+            this.onReap?.({ reason: "child-exited" })
+          }
+        } else {
+          // まだ browser attach 中: 既存の「次 input で resume 付き再起動」recovery (改修4/B6) を
+          // 壊さないため evict しない (即 evict すると同一 stream への継続入力が stream_missing で
+          // 落ちる)。ただし終端シグナルが無いとサイドバーの処理中ドット / UI「停止中…」が固着する
+          // ため、abort 経路と対称に onTurnSettled を出して即時解除する。次 input が来なければ
+          // detach 時の softDetach idle-timer / warm-bounds が回収し、R1(b) が死んだ session への
+          // reattach を防ぐ。
+          try {
+            this.onTurnSettled?.()
+          } catch {
+            /* ignore */
+          }
+        }
       }
       // マスク (2026-06-23): 常駐 query 終了後 (= CLI が jsonl を掴んでいない) のこの地点で、
       // closed 済みならオンディスク jsonl をマスクする。reap 経路は close() 内で実行済み。
@@ -2043,6 +2089,18 @@ export class ClaudeStreamSession {
     return true
   }
 
+  /** R1(b): このセッションへ resume 再アタッチしてよいか。close 済み、または常駐 generator が
+   *  返却済み (_residentQueryReturned) で再走行していない (_residentQuery=null) = 子プロセスが
+   *  死亡した状態には reattach しない (attach 側が新規 spawn へフォールバックする)。R1(a) で
+   *  死亡時は同期 close されるので通常は _closed で弾かれるが、close 到達前の窓や将来経路でも
+   *  死んだ query へ再アタッチしない二重ガードとして効かせる。まだ一度も query を起動していない
+   *  idle セッション (_residentQueryReturned=false) は生存中なので reattach 可。 */
+  _isReattachable() {
+    if (this._closed) return false
+    if (this._residentQueryReturned && !this._residentQuery) return false
+    return true
+  }
+
   /** セッション終了。新規ターンを止め、実行中なら中断し、watcher も停止する。 */
   close() {
     this._closed = true
@@ -2255,7 +2313,9 @@ export class ClaudeStreamBridge extends EventEmitter {
       //    attach しても引き当たらず、越境 reattach が原理的に起きない (session_id は本来
       //    ユニークだが異常系でも cwd を跨がない)。
       const live = this._liveBySession.get(this._liveKeyFor(scwd, resumeSessionId))
-      if (live && !live._closed) {
+      // R1(b): !_closed だけでなく「常駐子プロセスが実生存しているか」も確認する。子が死んで
+      // いれば reattach せず下の新規 spawn 経路へフォールバックし、死んだ session を引き当てない。
+      if (live && live._isReattachable()) {
         // 多端末共有 (T06542 で常時): 旧 stream_id を Map から消さない。同一セッションを複数端末が
         // 購読する状態を作り、どの端末の input/permission/interrupt も解決できるようにする
         // (旧端末は reattach.streamIds に足され、backend が session group へ fan-out する)。
@@ -2282,7 +2342,12 @@ export class ClaudeStreamBridge extends EventEmitter {
           },
           "claude stream reattached to live session",
         )
-        return { stream_id, resuming: true, reattached: true }
+        return {
+          stream_id,
+          resuming: true,
+          reattached: true,
+          turn_active: live._busy === true,
+        }
       }
     }
     const session = new ClaudeStreamSession({
@@ -2355,14 +2420,15 @@ export class ClaudeStreamBridge extends EventEmitter {
           error: err?.message || String(err),
         })
       },
-      onReap: () => {
-        // ターン完走後の遅延クローズ。Map / 索引から撤去し exit を emit する。
-        // 多端末共有では複数端末キーが Map に載っているのでまとめて外す。
+      onReap: (info) => {
+        // ターン完走後の遅延クローズ、または R1(a) 子プロセス死亡時の即 evict。Map / 索引から
+        // 撤去し exit を emit する。多端末共有では複数端末キーが Map に載っているのでまとめて外す。
+        // reason は既定「detached-after-turn」。R1(a) は「child-exited」を渡して観測可能にする。
         this._dropSessionMappings(session)
         this.emit("exit", {
           stream_id: session.stream_id,
           code: 0,
-          reason: "detached-after-turn",
+          reason: info?.reason || "detached-after-turn",
           session_id: session.sessionId,
         })
       },
@@ -2395,7 +2461,11 @@ export class ClaudeStreamBridge extends EventEmitter {
     )
     // per-message モデルでは attach 時点では query() を起動しない (即 ready)。
     // 最初の input で query を起動する。
-    return { stream_id, resuming: !!resumeSessionId }
+    return {
+      stream_id,
+      resuming: !!resumeSessionId,
+      turn_active: session._busy === true,
+    }
   }
 
   /**
@@ -3237,13 +3307,32 @@ export class ClaudeStreamBridge extends EventEmitter {
     return at
   }
 
+  /** R1(c): このセッションを現在ライブに購読している端末数 (sessions Map で自分を指す stream key 数)。
+   *  正規の多端末共有 (T06542) では 1 つの session を複数 stream_id が指す。単端末なら 1、
+   *  soft-detach 済み warm なら 0。 */
+  _liveTerminalCount(session) {
+    if (!session) return 0
+    let n = 0
+    for (const sid of session.streamIds || []) {
+      if (this.sessions.get(sid) === session) n += 1
+    }
+    return n
+  }
+
   /** 子⑤ round5 Finding 2 対応: warm 境界で reap してはいけない「in-flight」セッション。
    *  走行中ターン（_busy）に加え、送信待ちの pending がある（現ターン完了時に drain される）
-   *  セッションも保護する（reap すると未処理入力が失われる）。 */
+   *  セッションも保護する（reap すると未処理入力が失われる）。
+   *  R1(c) 多ウィンドウ相互 reap 抑止: 2 端末以上が現在ライブ購読中の多端末共有セッション
+   *  (T06542) も保護する。同一 cwd で別 session_id を開いた新規 1 本を残すために、複数
+   *  ウィンドウが見ている共有セッションを per-cwd=1 / cwd-LRU が刈ってしまう事故を防ぐ
+   *  (単端末の重複セッション collapse は従来どおり働く: 単端末は count=1 で非保護)。 */
   _isSessionProtected(session) {
     if (!session) return false
     if (session._busy) return true
-    return Array.isArray(session._pendingMessages) && session._pendingMessages.length > 0
+    if (Array.isArray(session._pendingMessages) && session._pendingMessages.length > 0) {
+      return true
+    }
+    return this._liveTerminalCount(session) >= 2
   }
 
   /** 子⑤: warm 境界超過セッションを reap する（detach の softDetach onTimeout と同じ撤去処理）。 */

package/src/main.mjs

@@ -3433,6 +3433,10 @@ async function dispatch(msg, ctx) {
             type: "claude.ready",
             stream_id,
             resuming: info.resuming,
+            // 再接続時の生成状態は resident session を保持する hub-agent が正本。
+            // jsonl 履歴末尾の推測だけでは「実際は busy なのに UI は idle」となり、
+            // 送信ボタンが楽観バブルを作る一方 agent はキューへ積む二重表示が起きる。
+            turn_active: info.turn_active === true,
             history_pushed: resumeSessionId !== null,
             // id 空間統一 (2026-07-08): この agent は browser の input_id をキュー id として
             // 採用し、楽観送信待ちアイテムの確認前キャンセルに対応することを通知する capability。

package/src/sidebar-message-snapshot.mjs

@@ -182,7 +182,7 @@ async function findCodexRolloutFile(threadId, sessionsDir) {
   return null
 }
 
-async function readCached(filePath, extract, { maxAgeMs = Infinity } = {}) {
+async function readCached(filePath, extract) {
   if (!filePath) return { user: "", assistant: "" }
   let fileStat
   try {
@@ -192,11 +192,15 @@ async function readCached(filePath, extract, { maxAgeMs = Infinity } = {}) {
   }
   const version = `${fileStat.mtimeMs}:${fileStat.size}:${fileStat.ctimeMs}`
   const cached = textCache.get(filePath)
-  if (
-    cached &&
-    cached.version === version &&
-    Date.now() - cached.checkedAt < maxAgeMs
-  ) {
+  if (cached && cached.version === version) {
+    // mtime/size/ctime 未変化 = jsonl 本文不変。tail 読み + パースを丸ごとスキップし、
+    // 前回抽出済みテキストをそのまま返す (R3(a) mtime 差分キャッシュ)。stat 1 発だけで済む。
+    // 旧実装は maxAgeMs=2s の age ゲートで、8s 周期のサイドバー snapshot が毎回 (2s 超過で)
+    // 未変化ファイルまで再抽出し、attach/history の fs と libuv プールを奪い合っていた。
+    // LRU 順を保つため hot エントリを末尾へ入れ直す (最古から evict される側から救う)。
+    cached.checkedAt = Date.now()
+    textCache.delete(filePath)
+    textCache.set(filePath, cached)
     return cached.texts
   }
 
@@ -287,10 +291,8 @@ export async function readSidebarMessageSnapshot(
           session_id: target.conversationId,
           projectsRoot,
         })
-        texts = await readCached(
-          filePath,
-          (fp) => extractClaude(fp, { isInjected }),
-          { maxAgeMs: 2_000 },
+        texts = await readCached(filePath, (fp) =>
+          extractClaude(fp, { isInjected }),
         )
         return {
           session_name: target.sessionName,
@@ -309,10 +311,8 @@ export async function readSidebarMessageSnapshot(
       const { sessionsDir, profileId } = await resolveCodexRoot(target.profileId)
       if (!texts.user || !texts.assistant) {
         const filePath = await findCodexRolloutFile(target.conversationId, sessionsDir)
-        const diskTexts = await readCached(
-          filePath,
-          (fp) => extractCodex(fp, { isInjected }),
-          { maxAgeMs: 2_000 },
+        const diskTexts = await readCached(filePath, (fp) =>
+          extractCodex(fp, { isInjected }),
         )
         texts = {
           user: texts.user || diskTexts.user,