@cocorograph/hub-agent 0.6.66 → 0.6.67

package/package.json

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

package/src/chat-signals.mjs

@@ -23,7 +23,7 @@
  * プロセス)、サイドバー行 (= tmux セッション) とは cwd で対応するため。
  */
 
-// cwd → { status, context_pct, turnAt, updatedAtMs }
+// cwd → { status, context_pct, statusAt, inputPending, turnAt, updatedAtMs }
 const _byCwd = new Map()
 
 // チャット信号を「生きている」と見なす最大経過時間 (ms)。これを過ぎたら tmux
@@ -48,23 +48,32 @@ function _now() {
  *
  * @param {string} cwd セッションの作業ディレクトリ
  * @param {{ status?: string, contextPct?: number|null, inputPending?: boolean }} patch
+ * @param {number} [now] テスト用の時刻注入 (省略時は Date.now())
  */
-export function recordChatActivity(cwd, patch = {}) {
+export function recordChatActivity(cwd, patch = {}, now = _now()) {
   if (!cwd || typeof cwd !== "string") return
-  const now = _now()
   const prev = _byCwd.get(cwd) || {
     status: null,
     context_pct: null,
+    statusAt: 0,
     inputPending: false,
     turnAt: 0,
     updatedAtMs: 0,
   }
   const next = { ...prev, turnAt: now, updatedAtMs: now }
+  // statusAt: status / context_pct を「実際に SDK イベントが更新した」時刻。
+  // inputPending だけの記録 (TUI 権限ブリッジ) では更新しない。これを分けないと、
+  // TUI モードの承認カードが届くたびに「過去の SDK チャットが残した status (多くは
+  // waiting)」の鮮度だけが蘇生され、state loop が capture-pane の実 processing を
+  // 15 分間 waiting で上書きし続ける (TUI 生成中なのにステータスドット/三点リーダーが
+  // 消える事故の真因, 2026-06-12)。
   if (typeof patch.status === "string" && VALID_STATUS.has(patch.status)) {
     next.status = patch.status
+    next.statusAt = now
   }
   if (typeof patch.contextPct === "number" && Number.isFinite(patch.contextPct)) {
     next.context_pct = Math.max(0, Math.min(100, patch.contextPct))
+    next.statusAt = now
   }
   if (typeof patch.inputPending === "boolean") {
     next.inputPending = patch.inputPending
@@ -84,9 +93,26 @@ export function getChatSignal(cwd, now = _now()) {
   const sig = _byCwd.get(cwd)
   if (!sig) return null
   if (now - sig.updatedAtMs > CHAT_SIGNAL_STALE_MS) return null
+  // status / context_pct 自体の鮮度は statusAt で判定する。inputPending だけが
+  // 信号を延命している間 (= TUI モードで承認カードだけが届く状況) は、stale な
+  // SDK 由来の status / context_pct を返さず capture-pane の実値に委ねる。
+  if (now - (sig.statusAt || 0) > CHAT_SIGNAL_STALE_MS) {
+    return { ...sig, status: null, context_pct: null }
+  }
   return sig
 }
 
+/**
+ * cwd のチャット信号を破棄する。claude.tui.bind (= SDK 停止 → TUI へ載せ替え) の
+ * 時点で呼び、以降の status / context% はペイン実状態 (capture-pane) に一本化する。
+ *
+ * @param {string} cwd
+ */
+export function clearChatSignal(cwd) {
+  if (!cwd || typeof cwd !== "string") return
+  _byCwd.delete(cwd)
+}
+
 /** テスト用: ストアを空にする。 */
 export function _resetChatSignals() {
   _byCwd.clear()

package/src/main.mjs

@@ -81,7 +81,7 @@ import {
   getUsage,
   recordChatRateLimit,
 } from "./usage.mjs"
-import { getChatSignal, recordChatActivity } from "./chat-signals.mjs"
+import { clearChatSignal, getChatSignal, recordChatActivity } from "./chat-signals.mjs"
 import { hydrateProcessEnvFromShell } from "./shell-env.mjs"
 
 const logger = pino({ name: "hub-agent" })
@@ -901,8 +901,15 @@ function startStateLoop({ client, plugins, logger, intervalMs, claudeBridge }) {
         // 上書きする (Hub ホスト型 Cockpit のステータスドット/各行ドーナツ用)。
         const chat = s.cwd ? getChatSignal(s.cwd) : null
         if (chat) {
-          if (chat.status) status = chat.status
-          if (typeof chat.context_pct === "number") contextPct = chat.context_pct
+          // capture-pane が processing (= ペインに "esc to interrupt" が実在 = 本物の
+          // TUI が生成中) のときはチャット信号で上書きしない。素のシェル (SDK チャット
+          // のペイン) は processing を返せないため、SDK チャットの補完は従来どおり効く。
+          // TUI 生成中に stale な SDK status (waiting) が勝ってステータスドット/
+          // 三点リーダーが消える事故の防止 (2026-06-12)。
+          if (chat.status && status !== "processing") status = chat.status
+          if (typeof chat.context_pct === "number" && status !== "processing") {
+            contextPct = chat.context_pct
+          }
           // チャットのターン境界 (turnAt 前進) を sort 用 session-event に橋渡し。
           // tmux ペインが動かず bundle hook が発火しないため、ここで代替発火する。
           const prevTurnAt = lastTurnAtByName.get(s.session_name) || 0
@@ -1658,6 +1665,11 @@ async function dispatch(msg, ctx) {
               session_id: targetId || undefined,
             })
           }
+          // SDK を止めて TUI へ載せ替えた時点で、cwd のチャット信号 (SDK 用の
+          // status/context% 補完) は役目を終える。残すと TUI 権限カードの
+          // inputPending 記録が stale status の鮮度を延命し、state loop が
+          // ペイン実状態を waiting で上書きし続ける (2026-06-12 真因修正)。
+          if (cwd) clearChatSignal(cwd)
           // 3) tmux claude を起動し直す (resume or fresh)。
           //    冪等性: 同じ session を同じキーへ既に載せ替え済みなら respawn しない
           //    (TUI ビューは remount のたびに bind を送るため、毎回 respawn すると

package/src/state.mjs

@@ -45,10 +45,65 @@ export function invalidateSessionCache(sessionName) {
   if (sessionName == null) {
     _captureCache.clear()
     _cwdCache.clear()
+    _statusGate.clear()
     return
   }
   _captureCache.delete(sessionName)
   _cwdCache.delete(sessionName)
+  _statusGate.delete(sessionName)
+}
+
+/**
+ * processing → waiting/idle の「降格」だけ独立 2 サンプルで確定するヒステリシス。
+ *
+ * capture-pane は claude TUI の再描画途中 (フッター消去〜再描画の間) を拾うことが
+ * あり、生成中なのに一瞬 waiting/idle と誤読する。この単発の誤読が frontend の
+ * ターン表示 (三点リーダー) やステータスドットを消す方向に直撃するため、降格は
+ * 「同じ非 processing 値が STATUS_DOWNGRADE_CONFIRM_MS 以上あけて 2 回読めた」
+ * ときだけ確定し、それまでは processing を維持する。
+ *   - 昇格 (→ processing) は即時 (誤読で点く分には次サンプルで自然回復し、実害が小さい)
+ *   - 確定窓は capture キャッシュ TTL (CAPTURE_TTL_MS=2.5s) より長く取り、同一
+ *     キャッシュサンプルの 2 回読みで誤確定しないようにする
+ *   - 実ターン終了の体感は frontend の hook 由来 session.event 'stop' が即時に担う
+ *     ため、ここで数秒遅れてもサイドバードットが ~5s 遅れるだけで UX 影響は無い
+ */
+const STATUS_DOWNGRADE_CONFIRM_MS = Number(
+  process.env.HUB_AGENT_STATUS_DOWNGRADE_MS ?? 3000,
+)
+/** @type {Map<string, {lastConfirmed: string|null, pending: {status: string, at: number}|null}>} */
+const _statusGate = new Map()
+
+export function debounceStatusDowngrade(sessionName, rawStatus, now = Date.now()) {
+  if (!sessionName) return rawStatus
+  const g = _statusGate.get(sessionName) || { lastConfirmed: null, pending: null }
+  // processing への昇格 / processing 以外からの遷移は即時確定。
+  if (rawStatus === "processing" || g.lastConfirmed !== "processing") {
+    g.lastConfirmed = rawStatus
+    g.pending = null
+    _statusGate.set(sessionName, g)
+    return rawStatus
+  }
+  // lastConfirmed=processing からの降格要求: 同値の 2 サンプル目 (確定窓経過後) で確定。
+  if (
+    g.pending &&
+    g.pending.status === rawStatus &&
+    now - g.pending.at >= STATUS_DOWNGRADE_CONFIRM_MS
+  ) {
+    g.lastConfirmed = rawStatus
+    g.pending = null
+    _statusGate.set(sessionName, g)
+    return rawStatus
+  }
+  if (!g.pending || g.pending.status !== rawStatus) {
+    g.pending = { status: rawStatus, at: now }
+  }
+  _statusGate.set(sessionName, g)
+  return "processing"
+}
+
+/** テスト用: 降格ヒステリシスの状態を空にする。 */
+export function _resetStatusGate() {
+  _statusGate.clear()
 }
 
 const CONTEXT_PATTERNS = [
@@ -288,7 +343,10 @@ export async function detectSessionState(sessionName, opts = {}) {
     })
     if (hookResult?.result) {
       return {
-        status: hookResult.result.status || defaultStatus,
+        status: debounceStatusDowngrade(
+          sessionName,
+          hookResult.result.status || defaultStatus,
+        ),
         context_pct: hookResult.result.context_pct ?? defaultContextPct,
         permission_mode:
           hookResult.result.permission_mode ?? defaultPermissionMode,
@@ -297,7 +355,7 @@ export async function detectSessionState(sessionName, opts = {}) {
   }
 
   return {
-    status: defaultStatus,
+    status: debounceStatusDowngrade(sessionName, defaultStatus),
     context_pct: defaultContextPct,
     permission_mode: defaultPermissionMode,
   }