@cocorograph/hub-agent 0.6.82 → 0.6.84

package/package.json

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

package/src/claude-history-watch.mjs

@@ -13,11 +13,18 @@
  * - ファイル不在時は出現を待つ (ディレクトリ監視はせず、ポーリングで存在チェック)
  */
 import { watch as fsWatch } from "node:fs"
-import { open, stat } from "node:fs/promises"
+import { open, realpath, stat } from "node:fs/promises"
 
 // 履歴 hydrate と live watch で jsonl→SDK message 整形を共通化 (フィールド取りこぼし防止)。
 import { DISPLAY_TYPES, normalizeHistoryEvent } from "./claude-history.mjs"
-const POLL_INTERVAL_MS = 1500
+
+// アダプティブ・ポーリング: 最後の追記から FAST_WINDOW_MS 以内は fast、以降は idle 周期。
+// ~/.claude が iCloud Drive への symlink のため fs.watch (FSEvents) が遅延/不発しやすく、
+// その場合この poll がバブル反映の律速になる。ターン進行中 (= 直近に追記がある間) だけ
+// 細かく見て体感ラグを詰め、アイドル時は従来の 1.5s に戻して stat 負荷を抑える。
+const POLL_FAST_MS = Number(process.env.HUB_AGENT_JSONL_POLL_FAST_MS ?? 400)
+const POLL_IDLE_MS = Number(process.env.HUB_AGENT_JSONL_POLL_IDLE_MS ?? 1500)
+const FAST_WINDOW_MS = Number(process.env.HUB_AGENT_JSONL_FAST_WINDOW_MS ?? 5000)
 
 /**
  * 1 つの jsonl ファイルを tail する watcher を生成する。
@@ -38,6 +45,7 @@ export function watchSessionFile({ filePath, onEvent, fromEnd = true, logger })
   let fsWatcher = null
   let pollTimer = null
   let initialized = false
+  let lastChangeAt = 0 // 最後に増分を読んだ時刻 (アダプティブ poll 周期の判定に使う)
 
   async function initOffset() {
     try {
@@ -78,6 +86,7 @@ export function watchSessionFile({ filePath, onEvent, fromEnd = true, logger })
         const buf = Buffer.alloc(len)
         await fh.read(buf, 0, len, offset)
         offset = st.size
+        lastChangeAt = Date.now() // 追記検知 → 次回 poll を fast 側へ寄せる
         const text = leftover + buf.toString("utf-8")
         const lines = text.split("\n")
         leftover = lines.pop() ?? "" // 最終要素は未完行として保持
@@ -107,21 +116,39 @@ export function watchSessionFile({ filePath, onEvent, fromEnd = true, logger })
     }
   }
 
+  function scheduleNextPoll() {
+    if (stopped) return
+    const interval =
+      Date.now() - lastChangeAt < FAST_WINDOW_MS ? POLL_FAST_MS : POLL_IDLE_MS
+    pollTimer = setTimeout(async () => {
+      await readIncrement().catch(() => {})
+      scheduleNextPoll()
+    }, interval)
+    pollTimer.unref?.()
+  }
+
   ;(async () => {
     await initOffset()
     if (stopped) return
-    // fs.watch (change で増分読み取り)
+    // fs.watch (change で増分読み取り)。~/.claude は iCloud Drive への symlink で、symlink
+    // 越しだと FSEvents が不安定なため realpath を解決して実体を watch する。失敗しても
+    // 下のアダプティブ・ポーリングが取りこぼしを拾う。
+    let watchTarget = filePath
     try {
-      fsWatcher = fsWatch(filePath, { persistent: false }, () => {
+      watchTarget = await realpath(filePath)
+    } catch {
+      /* 未存在等: そのまま filePath を試す */
+    }
+    try {
+      fsWatcher = fsWatch(watchTarget, { persistent: false }, () => {
         readIncrement().catch(() => {})
       })
       fsWatcher.on?.("error", () => {})
     } catch {
       // ファイル未存在等で watch 不可 → ポーリングに委ねる
     }
-    // 取りこぼし / ファイル出現待ち用の軽いポーリング
-    pollTimer = setInterval(() => readIncrement().catch(() => {}), POLL_INTERVAL_MS)
-    pollTimer.unref?.()
+    // 取りこぼし / ファイル出現待ち / iCloud fs.watch 不発のバックストップ (アダプティブ周期)。
+    scheduleNextPoll()
   })()
 
   return {
@@ -132,7 +159,7 @@ export function watchSessionFile({ filePath, onEvent, fromEnd = true, logger })
       } catch {
         /* ignore */
       }
-      if (pollTimer) clearInterval(pollTimer)
+      if (pollTimer) clearTimeout(pollTimer)
     },
     /**
      * offset を現在のファイル末尾に進める (= 未読分を push せず捨てる)。

package/src/main.mjs

@@ -36,6 +36,7 @@ import { listSkills } from "./skills.mjs"
 import {
   capturePane,
   detectPermissionModeFromText,
+  detectSessionState,
   listSessionStates,
 } from "./state.mjs"
 import {
@@ -952,17 +953,22 @@ function startStateLoop({ client, plugins, logger, intervalMs, claudeBridge }) {
             writeSessionEventFile(s.session_name, ev, chat.turnAt).catch(() => {})
           }
         }
+        // 内容安定で「確実に停止」と判定できたか (frontend が 2 サンプル消灯確認を省いて
+        // 即消灯するためのフラグ)。chat 信号で processing へ上書きされた場合は false。
+        const stable = status !== "processing" && s.stable === true
         const prev = lastByName.get(s.session_name)
         if (
           !prev ||
           prev.status !== status ||
           prev.context_pct !== contextPct ||
-          prev.permission_mode !== permissionMode
+          prev.permission_mode !== permissionMode ||
+          prev.stable !== stable
         ) {
           lastByName.set(s.session_name, {
             status,
             context_pct: contextPct,
             permission_mode: permissionMode,
+            stable,
           })
           client.send({
             type: "session.state",
@@ -970,6 +976,7 @@ function startStateLoop({ client, plugins, logger, intervalMs, claudeBridge }) {
             status,
             context_pct: contextPct,
             permission_mode: permissionMode,
+            stable,
           })
         }
       }
@@ -1761,6 +1768,31 @@ async function dispatch(msg, ctx) {
               })
             }
           }
+          // 即時ステータススナップショット (#2): session.state は差分送信なので、アイドル
+          // セッションへ切替えても現在値が届かず、ペイン由来の三点リーダー補正が次の poll
+          // (~8-10s) まで遅れる。bind は TUI ビューのマウントごとに来るので、ここで現在状態
+          // を 1 回 push して初回サンプルを即届け、偽点灯/消灯確定を早める (noCache で実測)。
+          if (sessionName) {
+            try {
+              const snap = await detectSessionState(sessionName, {
+                noCache: true,
+                logger,
+              })
+              ctx.client.send({
+                type: "session.state",
+                session_name: sessionName,
+                status: snap.status,
+                context_pct: snap.context_pct,
+                permission_mode: snap.permission_mode,
+                stable: snap.status !== "processing" && snap.stable === true,
+              })
+            } catch (err) {
+              logger?.warn(
+                { err: err?.message, sessionName },
+                "claude.tui.bind status snapshot failed",
+              )
+            }
+          }
         } catch (err) {
           logger?.warn(
             { err: err?.message, sessionName, cwd },

package/src/state.mjs

@@ -132,16 +132,33 @@ function footerRegion(text, lines = 8) {
 }
 
 /**
- * 作業スピナーのフッター行を検出する。claude TUI の生成中フッターは
- * "✻ Cogitating… (12s · ↑ 1.2k tokens · esc to interrupt)" のように
- * 「経過秒」と「トークンカウンタ」が同一行に同居する。idle/waiting の権限バナーや
- * 通常本文には出ないシグネチャなので、中断フッター文言 ("esc to interrupt") が
- * 未描画 (ターン序盤) / locale 差 / ツール実行中などで取りこぼされる区間でも
- * 生成中を拾える。誤検出を抑えるためフッター領域 + 同一行同居を必須にする。
+ * 作業スピナーのフッター行を検出する (生成中=processing の補助シグナル)。
+ *
+ * 現行 claude TUI の生成中フッターは語が毎ターン変わる (実機採取 2026-06-15):
+ *   "· Blanching… (2m 4s · ↓ 7.5k tokens)"    (出力中)
+ *   "✽ Scurrying… (16m 55s · ↓ 66.8k tokens)" (出力中)
+ *   "· Puzzling… (11m 12s · thinking)"         (思考中・tokens 語が無い)
+ * 語 (Blanching/Puzzling/Processing/Orbiting/Scurrying…) は無数にあり版で増減するため
+ * 語リストでは判定しない。また現行版は "esc to interrupt" をフッターに出さない (主シグナル
+ * が実機で死んでいる)。版に依存せず安定する構造は「<語>… (<ライブ経過タイマー> …)」=
+ * 任意語 + 省略記号 + 括弧で囲まれた経過時間。完了サマリー "✻ Brewed for 2m 52s" は省略
+ * 記号も括弧タイマーも持たないので拾わない。誤検出を抑えるため判定はフッター領域に限定する。
+ *
+ * 2 系統で判定する:
+ *  (a) 構造シグナル: "<語>… (<m? s>" のライブタイマー。tokens の有無に依存しないので
+ *      thinking フッターも拾う (旧実装の偽陰性の根治)。tips 行 (⎿ Tip:…) でスピナー行が
+ *      押し上げられる分を見込み少し広い領域 (12 行) を走査する。構造が限定的なので
+ *      スクロールバックの古フッター "(99s · …) old footer" 等の誤検出に強い。
+ *  (b) 旧シグナル (回帰防止): "tokens" 語 + 経過秒の同一行同居。タイマーが括弧直後でない
+ *      語順 "(↑ 3.4k tokens · 7s)" も拾う。誤検出しやすいのでフッター 8 行に限定する。
  */
 function detectWorkingSpinner(text) {
-  const footer = footerRegion(text)
-  for (const line of footer.split("\n")) {
+  // (a) 構造シグナル: 任意語 + 省略記号 + 括弧ライブタイマー (tokens 非依存・thinking も拾う)。
+  for (const line of footerRegion(text, 12).split("\n")) {
+    if (/[A-Za-z]+(?:…|\.\.\.)\s*\(\s*(?:\d+\s*m\s*)?\d+\s*s\b/.test(line)) return true
+  }
+  // (b) 旧シグナル: tokens カウンタ + 経過秒の同一行同居 (フッター 8 行限定)。
+  for (const line of footerRegion(text, 8).split("\n")) {
     if (/\btokens\b/i.test(line) && /(?:^|[\s(])\d+\s*s\b/.test(line)) return true
   }
   return false
@@ -224,7 +241,66 @@ export function detectPermissionModeFromText(text) {
  * @param {string} text capturePane の結果 (ANSI 除去済み)
  * @returns {string|null} 入力欄内の本文 (入力欄が見つからない / 空なら null)
  */
+/**
+ * 現行形式 (ルール区切り) の入力ボックス本文を「上下ボーダー間」から抽出する。
+ *
+ * 末尾から `❯` を逆走する旧方式は、ユーザー評価プロンプト ("How is Claude doing?") や
+ * 選択ダイアログの選択肢行 (`❯ Very good` 等) の ❯ に誤マッチし得た。評価プロンプトは
+ * 入力欄の「上」に出るため入力欄自体の上下ボーダーはズレない、という知見に基づき、
+ * 下ボーダー (ペイン末尾近傍の ────) → 直上の上ボーダー → 間の ❯ プロンプト行、という
+ * 範囲ベースで確定する。誤認防止ガード: 下ボーダーはペイン末尾から MAX_FOOTER_LINES 行
+ * 以内、上下ボーダー間は 2〜MAX_BOX_LINES 行、間に列 0 の ❯ が在ること。
+ * 見つからなければ null を返し、呼び出し側は旧アンカー方式へフォールバックする。
+ *
+ * @param {string} text capturePane の結果 (ANSI 除去済み)
+ * @returns {string|null}
+ */
+function _inputTextFromRuleBox(text) {
+  if (!text) return null
+  const lines = text.split("\n")
+  const isRule = (s) => /^\s*─{4,}\s*$/.test(s)
+  const MAX_FOOTER_LINES = 6 // 入力欄の下に出るヒント/ナビ行の想定上限
+  const MAX_BOX_LINES = 50 // 上下ボーダー間の許容行数 (折り返し長文入力の上限)
+  // 下ボーダー: ペイン末尾近傍 (下に出るヒント行のすぐ上) の ──── を末尾から探す。
+  let bottom = -1
+  for (let i = lines.length - 1; i >= 0; i--) {
+    if (lines.length - 1 - i > MAX_FOOTER_LINES) break
+    if (isRule(lines[i])) {
+      bottom = i
+      break
+    }
+  }
+  if (bottom < 0) return null
+  // 上ボーダー: 下ボーダーの直上にある ──── 。
+  let top = -1
+  for (let i = bottom - 1; i >= 0 && bottom - i <= MAX_BOX_LINES; i--) {
+    if (isRule(lines[i])) {
+      top = i
+      break
+    }
+  }
+  if (top < 0 || bottom - top < 2) return null
+  // ボーダー間に列 0 の ❯ プロンプト行が在ること (選択ダイアログの字下げ ❯ は対象外)。
+  const inner = lines.slice(top + 1, bottom)
+  const promptIdx = inner.findIndex((ln) => /^❯/.test(ln))
+  if (promptIdx < 0) return null
+  const parts = [inner[promptIdx].replace(/^❯\s?/, "").replace(/\s+$/, "")]
+  for (let i = promptIdx + 1; i < inner.length; i++) {
+    parts.push(inner[i].replace(/\s+$/, ""))
+  }
+  const joined = parts.join("\n").trim()
+  return joined || null
+}
+
 export function detectInputBoxText(text) {
+  // 第一候補: 上下ボーダー間抽出 (評価プロンプト/選択ダイアログの ❯ 誤マッチに強い)。
+  const ruled = _inputTextFromRuleBox(text)
+  if (ruled !== null) return ruled
+  // フォールバック: 旧 ❯ アンカー / 罫線ボックス方式 (ボーダー未描画版・レイアウト差用)。
+  return _inputTextFromPromptAnchor(text)
+}
+
+function _inputTextFromPromptAnchor(text) {
   if (!text) return null
   const lines = text.split("\n")
 
@@ -361,6 +437,49 @@ export async function getSessionCwd(sessionName, opts = {}) {
  *
  * @returns {Promise<{status: string, context_pct: number | null}>}
  */
+/** ペイン内容が一定時間不変なら「確実に停止 (idle/waiting)」とみなす確定窓。frontend は
+ *  この stable=true を受けると 2 サンプル消灯確認 (paneOffConfirmed) を省いて即消灯できる。
+ *  ローダー無しでも本文がストリーミング中 (= 出力領域が変化) なら stable にならないので、
+ *  「文字出力中はローダーが出ない」ケースでも誤って停止扱いしない。 */
+const STABLE_CONFIRM_MS = Number(process.env.HUB_AGENT_STABLE_CONFIRM_MS ?? 3000)
+const _stabilityByName = new Map() // session_name → { sig, since }
+
+/** ペインの出力領域 (入力欄・揮発フッターを除いた上側) の軽量シグネチャ (FNV-1a 32bit)。
+ *  末尾 8 行 (入力欄 + スピナー経過秒/ヒント等) を除くので、idle 中は連続 capture が一致する。 */
+function _outputSignature(text) {
+  const lines = text.split("\n")
+  const body = lines.slice(0, Math.max(0, lines.length - 8)).join("\n")
+  let h = 0x811c9dc5
+  for (let i = 0; i < body.length; i++) {
+    h ^= body.charCodeAt(i)
+    h = (h + ((h << 1) + (h << 4) + (h << 7) + (h << 8) + (h << 24))) >>> 0
+  }
+  return `${body.length}:${(h >>> 0).toString(16)}`
+}
+
+/** 内容安定による「確実に停止」判定。processing (ローダー在中) は常に false で、
+ *  停止後に出力領域が STABLE_CONFIRM_MS 不変であれば true。
+ *
+ *  多重防御 (2026-06-15): status の読み違いがあっても、ライブスピナー (経過タイマー) が
+ *  ペインに在る間は「確実に停止」を絶対に返さない。frontend は stable=true を受けると
+ *  2 サンプル消灯確認 (paneOffConfirmed) をバイパスして即消灯するため、将来 claude が
+ *  未知のフッター形式を出して status を取りこぼしても、タイマーが画面に出ている限り
+ *  即消灯の暴発を防ぐ保険にする (生成中ローダー消失の再発防止)。 */
+function _computeStable(sessionName, status, text) {
+  const now = Date.now()
+  if (status === "processing" || detectWorkingSpinner(text)) {
+    _stabilityByName.set(sessionName, { sig: _outputSignature(text), since: now })
+    return false
+  }
+  const sig = _outputSignature(text)
+  const prev = _stabilityByName.get(sessionName)
+  if (!prev || prev.sig !== sig) {
+    _stabilityByName.set(sessionName, { sig, since: now })
+    return false
+  }
+  return now - prev.since >= STABLE_CONFIRM_MS
+}
+
 export async function detectSessionState(sessionName, opts = {}) {
   const text = await capturePane(sessionName, opts)
   const defaultStatus = detectStatusFromText(text)
@@ -375,22 +494,26 @@ export async function detectSessionState(sessionName, opts = {}) {
       defaultStatus,
     })
     if (hookResult?.result) {
+      const status = debounceStatusDowngrade(
+        sessionName,
+        hookResult.result.status || defaultStatus,
+      )
       return {
-        status: debounceStatusDowngrade(
-          sessionName,
-          hookResult.result.status || defaultStatus,
-        ),
+        status,
         context_pct: hookResult.result.context_pct ?? defaultContextPct,
         permission_mode:
           hookResult.result.permission_mode ?? defaultPermissionMode,
+        stable: _computeStable(sessionName, status, text),
       }
     }
   }
 
+  const status = debounceStatusDowngrade(sessionName, defaultStatus)
   return {
-    status: debounceStatusDowngrade(sessionName, defaultStatus),
+    status,
     context_pct: defaultContextPct,
     permission_mode: defaultPermissionMode,
+    stable: _computeStable(sessionName, status, text),
   }
 }