@cocorograph/hub-agent 0.7.16 → 0.7.18

package/package.json

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

package/src/main.mjs

@@ -87,10 +87,12 @@ import { TuiPermissionBridge } from "./tui-permission-bridge.mjs"
 import { TuiViewerRegistry } from "./tui-viewer-registry.mjs"
 import { JsonlLiveWatchers } from "./jsonl-live-watchers.mjs"
 import {
+  boundSessionId,
   contextWindowSize,
   getSessionUsages,
   getUsage,
   recordChatRateLimit,
+  turnActiveForCwd,
 } from "./usage.mjs"
 import {
   clearChatSignal,
@@ -661,6 +663,9 @@ export async function startDaemon({ version, ptyModule, claudeSdk } = {}) {
     intervalMs: 5_000,
     claudeBridge,
     readinessTracker,
+    // tmux session_name → bind 中の session_id。turn_active を「そのペインが実際に走らせている
+    // セッションの jsonl」で判定するために渡す (cwd dir 内の別 jsonl 取り違え=メタ欠陥#1 の根治)。
+    boundSessions: ctx.tuiReboundSessions,
   })
   // bundle hook (cockpit_session_event_hook.py) が /tmp/cockpit_session_events/<name>.json
   // に書き出す UserPromptSubmit / Stop / ready の event を fs.watch で拾って WS push する。
@@ -1187,7 +1192,7 @@ const STATE_TRACE = process.env.HUB_AGENT_STATE_TRACE === "1"
 // TURN_STALL_WARN_MS と揃える。
 const STALL_WARN_MS = Number(process.env.HUB_AGENT_STALL_WARN_MS ?? 90000)
 
-function startStateLoop({ client, plugins, logger, intervalMs, claudeBridge, readinessTracker }) {
+function startStateLoop({ client, plugins, logger, intervalMs, claudeBridge, readinessTracker, boundSessions }) {
   const lastByName = new Map() // session_name → {status, context_pct}
   const lastTurnAtByName = new Map() // session_name → 最後に event ファイル化した turnAt
   // (i) session_name → {sig, changedAt}: 出力領域署名の最終変化時刻 (出力フロー検知用)。
@@ -1298,6 +1303,24 @@ function startStateLoop({ client, plugins, logger, intervalMs, claudeBridge, rea
           stable,
           now: nowMs,
         })
+
+        // turn_active: ターンが現在進行中か (true=生成/ツール実行中 / false=待機中 / null=不明)。
+        // CockpitStatusDot の青/赤の権威ソース。サイドバーのドットと送信/停止ボタンを同じ真実で
+        // 同期させ、Esc 中断後の青固着 (PROMPT_STALE_SHORT_MS=60s) を解消する。
+        //  - チャットモード: SDK の rate_limit_event/assistant が最も新鮮なので chat.status を採用
+        //  - TUI モード: bound session の jsonl 末尾 assistant.stop_reason から判定 (turnActiveForCwd)
+        //    bound session_id を渡すことで、同一 cwd dir 内の別セッション / サブエージェント /
+        //    headless `claude -p` / `/clear` ローテの jsonl を「最新」と取り違えて turn_active を
+        //    誤る (cross-activity contamination = メタ欠陥#1) のを防ぐ。
+        let turnActive = null
+        if (chat?.status === "processing") {
+          turnActive = true
+        } else if (chat?.status === "waiting" || chat?.status === "idle") {
+          turnActive = false
+        } else if (s.cwd) {
+          turnActive = await turnActiveForCwd(s.cwd, boundSessionId(boundSessions, s.session_name))
+        }
+
         const prev = lastByName.get(s.session_name)
         if (
           !prev ||
@@ -1307,7 +1330,8 @@ function startStateLoop({ client, plugins, logger, intervalMs, claudeBridge, rea
           prev.stable !== stable ||
           prev.proc_busy !== procBusy ||
           prev.child_busy !== childBusy ||
-          prev.stalled !== stalled
+          prev.stalled !== stalled ||
+          prev.turn_active !== turnActive
         ) {
           lastByName.set(s.session_name, {
             status,
@@ -1317,6 +1341,7 @@ function startStateLoop({ client, plugins, logger, intervalMs, claudeBridge, rea
             proc_busy: procBusy,
             child_busy: childBusy,
             stalled,
+            turn_active: turnActive,
           })
           // 計装 (2026-06-19, 既定 OFF=2026-06-20): 状態変化時に値を記録する。常時 info はログ肥大の
           // 主因のため HUB_AGENT_STATE_TRACE=1 のときだけ出す。childBusy/outputActive を分けて出し、
@@ -1333,6 +1358,7 @@ function startStateLoop({ client, plugins, logger, intervalMs, claudeBridge, rea
               armed,
               stable,
               context_pct: contextPct,
+              turn_active: turnActive,
             },
             "session.state push",
           )
@@ -1349,6 +1375,9 @@ function startStateLoop({ client, plugins, logger, intervalMs, claudeBridge, rea
             // 出力残り火 (proc_busy 残存) でアイドルなのにキューへ逃がす誤キュー (症状A) を断つために使う。
             child_busy: childBusy,
             stalled,
+            // turn_active: ステータスドット 4 状態統一の権威ソース。null は旧クライアント互換
+            // (frontend は欠落時に旧 prompt_submit/stale 降格ロジックへフォールバック)。
+            turn_active: turnActive,
           })
         }
         // 消滅セッションの GC (perf監査/メモリリーク対策): tmux から消えたセッションの状態 Map を
@@ -1365,6 +1394,8 @@ function startStateLoop({ client, plugins, logger, intervalMs, claudeBridge, rea
             lastByName.delete(name)
             outputFlowByName.delete(name)
             lastTurnAtByName.delete(name)
+            // 死んだセッションの bind 記録も掃除する (同名再作成時は claude.tui.bind が再登録)。
+            boundSessions?.delete(name)
           }
         }
       }
@@ -2879,7 +2910,13 @@ async function dispatch(msg, ctx) {
       }
       case "tmux.list_sessions": {
         try {
-          const sessions = await listTmuxSessions({ plugins: ctx.plugins, logger: ctx.logger })
+          // boundSessions: 各行の context% (ドーナツ) を bound session の jsonl から引く
+          // (cwd dir 内の別セッション jsonl を最新と取り違える=メタ欠陥#1 の根治)。
+          const sessions = await listTmuxSessions({
+            plugins: ctx.plugins,
+            logger: ctx.logger,
+            boundSessions: ctx.tuiReboundSessions,
+          })
           // 各 session の最新 hook event を /tmp/cockpit_session_events/ から読んで
           // レスポンスに含める (Phase 4: ハードリロード時の lastEvent 復元用)。
           // fs.watch 由来の session.event push は揮発性のため、frontend が新規

package/src/tmux.mjs

@@ -27,7 +27,7 @@ import {
   detectSessionState,
   getSessionCwd,
 } from "./state.mjs"
-import { getSessionUsages, jsonlContextForCwd } from "./usage.mjs"
+import { boundSessionId, getSessionUsages, jsonlContextForCwd } from "./usage.mjs"
 
 const execFileP = promisify(execFile)
 
@@ -642,7 +642,9 @@ export async function listSessions(opts = {}) {
       //  3. statusLine が無ければ jsonl per-cwd の末尾 assistant.usage 由来 %。
       //  4. それも無ければ pane scrape の正規表現フォールバック。
       const fromStatusLine = cwd ? ctxByCwd.get(cwd)?.contextPercent : null
-      const jsonlInfo = cwd ? await jsonlContextForCwd(cwd) : null
+      // bound session があればその jsonl で context% を引く (cwd dir の別セッション jsonl の取り違え回避)。
+      const boundId = boundSessionId(opts.boundSessions, s.name)
+      const jsonlInfo = cwd ? await jsonlContextForCwd(cwd, boundId) : null
       const context_pct =
         jsonlInfo?.isReset && typeof jsonlInfo.percent === "number"
           ? jsonlInfo.percent

package/src/usage.mjs

@@ -537,6 +537,72 @@ async function latestJsonlContext(now) {
  */
 const _jsonlSessionUuidByCwd = new Map()
 
+/**
+ * cwd の jsonl ディレクトリから「対象セッションの jsonl 1 本」を解決する。
+ *
+ * bound `sessionId` が与えられ、その `<sessionId>.jsonl` が実在すれば **最優先で採用**する
+ * (= その tmux ペインが実際に bind/resume して走らせているセッション)。無ければ従来どおり
+ * mtime 最新へフォールバックする。
+ *
+ * 狙い: 1 つの cwd-encode dir には過去の全セッション / サブエージェント / headless `claude -p`
+ * (記憶蒸留 Stop hook 等) / `/clear` ローテの jsonl が堆積する (実測 52〜144 本)。mtime 最新を
+ * 「そのセッション」とみなすと、別アクティビティの jsonl が最新化した瞬間に turn_active /
+ * context% を取り違える (cross-activity contamination)。bound session_id 解決でこれを断つ。
+ *
+ * @param {string} dir cwd を encode した projects 配下のディレクトリ
+ * @param {string[]} files dir 内のファイル名一覧 (呼び出し側が readdir 済み)
+ * @param {string|null} sessionId その tmux ペインが bind しているセッション id (任意)
+ * @returns {Promise<{fp:string, mtimeMs:number, size:number, uuid:string, bound:boolean}|null>}
+ */
+async function resolveTargetJsonl(dir, files, sessionId) {
+  if (typeof sessionId === "string" && sessionId) {
+    const want = `${sessionId}.jsonl`
+    if (files.includes(want)) {
+      const fp = path.join(dir, want)
+      const st = await fs.stat(fp).catch(() => null)
+      if (st) {
+        return { fp, mtimeMs: st.mtimeMs, size: st.size, uuid: sessionId, bound: true }
+      }
+    }
+  }
+  // フォールバック: bound 未指定 / その jsonl が未だ存在しない (起動直後など) → mtime 最新。
+  let newest = null
+  await Promise.all(
+    files.map(async (f) => {
+      if (!f.endsWith(".jsonl")) return
+      const fp = path.join(dir, f)
+      const st = await fs.stat(fp).catch(() => null)
+      if (!st) return
+      if (!newest || st.mtimeMs > newest.mtimeMs) {
+        newest = {
+          fp,
+          mtimeMs: st.mtimeMs,
+          size: st.size,
+          uuid: f.replace(/\.jsonl$/, ""),
+          bound: false,
+        }
+      }
+    }),
+  )
+  return newest
+}
+
+/**
+ * `tuiReboundSessions` (tmux session_name → session_id or "fresh:<req>") の値から、
+ * 実セッション id を取り出す。fresh プレースホルダ / 未 bind は null。
+ * turn_active / context% 解決の呼び出し側 (state loop / listSessions) が、cwd でなく
+ * 「そのペインが実際に走らせているセッション」で jsonl を引くために使う。
+ *
+ * @param {Map<string,string>|null|undefined} boundSessions
+ * @param {string} name tmux セッション名
+ * @returns {string|null}
+ */
+export function boundSessionId(boundSessions, name) {
+  if (!boundSessions || !name) return null
+  const v = boundSessions.get(name)
+  return typeof v === "string" && v && !v.startsWith("fresh:") ? v : null
+}
+
 /**
  * 指定 cwd の Claude セッション jsonl から context% (USED %) を算出する。
  *
@@ -563,7 +629,7 @@ const _jsonlSessionUuidByCwd = new Map()
  * @param {string} cwd
  * @returns {Promise<{ percent: number | null, uuid: string | null, isReset: boolean }>}
  */
-export async function jsonlContextForCwd(cwd) {
+export async function jsonlContextForCwd(cwd, sessionId = null) {
   const empty = { percent: null, uuid: null, isReset: false }
   if (!cwd) return empty
   const dirName = encodeCwdToDirName(cwd)
@@ -572,23 +638,8 @@ export async function jsonlContextForCwd(cwd) {
   const files = await fs.readdir(dir).catch(() => null)
   if (!files) return empty
 
-  let newest = null // { fp, mtimeMs, size, uuid }
-  await Promise.all(
-    files.map(async (f) => {
-      if (!f.endsWith(".jsonl")) return
-      const fp = path.join(dir, f)
-      const st = await fs.stat(fp).catch(() => null)
-      if (!st) return
-      if (!newest || st.mtimeMs > newest.mtimeMs) {
-        newest = {
-          fp,
-          mtimeMs: st.mtimeMs,
-          size: st.size,
-          uuid: f.replace(/\.jsonl$/, ""),
-        }
-      }
-    }),
-  )
+  // bound session_id があればその jsonl を、無ければ mtime 最新を採用 (cross-activity 汚染回避)。
+  const newest = await resolveTargetJsonl(dir, files, sessionId)
   if (!newest) return empty
 
   // 末尾 assistant.usage を探す。`_jsonlCtxMemo` は fp+mtime+size をキーにしているので
@@ -637,8 +688,11 @@ export async function jsonlContextForCwd(cwd) {
     })
   }
 
-  const prevUuid = _jsonlSessionUuidByCwd.get(cwd)
-  _jsonlSessionUuidByCwd.set(cwd, newest.uuid)
+  // isReset 検知のキーは bound session があればそれ、無ければ cwd。同一 cwd を複数の tmux
+  // セッションが共有しても、bound 時は各セッション独立に /clear (uuid 変化) を検知できる。
+  const trackKey = sessionId || cwd
+  const prevUuid = _jsonlSessionUuidByCwd.get(trackKey)
+  _jsonlSessionUuidByCwd.set(trackKey, newest.uuid)
   const uuidChanged = prevUuid !== undefined && prevUuid !== newest.uuid
 
   if (percent == null) {
@@ -657,6 +711,207 @@ export function _resetJsonlSessionUuids() {
   _jsonlSessionUuidByCwd.clear()
 }
 
+// ターン完了を示す Anthropic API `stop_reason`。これ以外 (代表的には `tool_use`)
+// は「ターン継続中 = 生成 / ツール処理中」とみなす。
+const TURN_END_STOP_REASONS = new Set([
+  "end_turn",
+  "stop_sequence",
+  "max_tokens",
+])
+
+// 末尾が実ユーザー入力 (応答未着) でも、その入力がこの時間より古ければ「中断/クラッシュ/送信
+// 直後終了で応答が来ないまま終わったセッション」とみなし active=false に倒す。frontend
+// events.ts の STALE_USER_TAIL_MS と揃える。ステータスドット 0.7.17 一本化で agent 側に
+// 移植漏れた鮮度フロアで、Esc 中断後に放置した jsonl 等が永久に turn_active=true (青) に
+// 居座り 0.7.17 の「赤=閉じろナッジ」を相殺していた問題を根治する。
+// ※ tool_use 末尾 (assistant が active を立てたケース) は floor しない (frontend と同じ。
+//    長時間ツール実行を誤って畳まない)。ツール中クラッシュは PID 生存判定が別途必要。
+const STALE_USER_TAIL_MS = 60_000
+
+/** jsonl の user 行から表示テキスト (string content / text ブロック連結) を取り出す。
+ *  コマンド echo (`<command-name>`) 判定に使う。 */
+function userEventText(d) {
+  const content = d?.message?.content
+  if (typeof content === "string") return content
+  if (Array.isArray(content)) {
+    return content
+      .map((c) => (c && c.type === "text" ? String(c.text || "") : ""))
+      .join("")
+  }
+  return ""
+}
+
+/** ISO 文字列 / 数値の timestamp を ms に。取れなければ null。 */
+function parseEntryTs(ts) {
+  if (typeof ts === "number") return Number.isFinite(ts) ? ts : null
+  if (typeof ts === "string") {
+    const n = Date.parse(ts)
+    return Number.isFinite(n) ? n : null
+  }
+  return null
+}
+
+/**
+ * jsonl の末尾を順走査してターンが現在 active かを返す。
+ *
+ * ステートマシン:
+ *  - `assistant` 行を見たら `stop_reason` でターン状態を更新する
+ *    - end_turn / stop_sequence / max_tokens → 完了 (active=false)
+ *    - tool_use (or それ以外) → 継続 (active=true)
+ *  - `user` 行を見たとき、それが「実ユーザー入力」(tool_result でない) かつ
+ *    直前ターンが完了済みだったら、新ターンが開始されたので active=true
+ *  - その他の型 (attachment / mode / hook_* / file-history-snapshot 等) は無視
+ *
+ * 初期値は「ターン完了状態」(lastTurnEnded=true)。空 jsonl や応答未着 のセッション
+ * は active=false でフォールバックする。
+ *
+ * 鮮度フロア: 最終的な active=true が「実ユーザー入力」由来 (応答未着) で、その入力が
+ * STALE_USER_TAIL_MS より古ければ false に倒す (中断/クラッシュ/放置の永久青を解消)。
+ * assistant の tool_use 由来 active は floor しない (長時間ツール実行を畳まない)。
+ * コマンド echo (`<command-name>` 注入: /clear /compact /skill 等) は LLM ターンを起こさない
+ * 行があるため、実ユーザー入力とみなさずスキップする (frontend isCommandEchoEvent skip と同等)。
+ *
+ * @param {string} text jsonl の (末尾) テキスト
+ * @param {number} [now] テスト用の現在時刻 (ms)。省略時は Date.now()
+ * @returns {boolean}
+ */
+export function scanTurnActive(text, now = Date.now()) {
+  if (!text) return false
+  let active = false
+  let lastTurnEnded = true
+  // 最終 active=true を立てた要因 ("user"=実入力 / "assistant"=tool_use) と、その入力の時刻。
+  // 鮮度フロアは "user" 由来かつ古いときだけ適用する。
+  let activeBy = null
+  let activeSinceTs = null
+  const lines = text.split("\n")
+  for (const line of lines) {
+    if (!line) continue
+    let d
+    try {
+      d = JSON.parse(line)
+    } catch {
+      continue
+    }
+    if (d.type === "assistant") {
+      const stop = d.message?.stop_reason
+      if (stop && TURN_END_STOP_REASONS.has(stop)) {
+        active = false
+        lastTurnEnded = true
+        activeBy = null
+        activeSinceTs = null
+      } else {
+        // tool_use / pause_turn / null / 未知 → ターン継続中扱い (安全側)
+        active = true
+        lastTurnEnded = false
+        activeBy = "assistant"
+        activeSinceTs = parseEntryTs(d.timestamp)
+      }
+    } else if (d.type === "user") {
+      // 「実ユーザー入力」と「tool_result の自動 user ラッパー」を区別する。
+      // tool_result が含まれる user は前ターンの一部 (claude code 内部生成) なので、
+      // ターン状態を変えない。実ユーザー入力 (text/image/document) が直前ターン完了後に
+      // 来たら新ターン開始 → active=true。
+      const content = Array.isArray(d.message?.content) ? d.message.content : []
+      const isToolResult = content.some((c) => c?.type === "tool_result")
+      if (isToolResult) continue
+      const userText = userEventText(d)
+      // 中断マーカー ([Request interrupted by user...]) = ユーザーが Esc 等でターンを止めた。
+      // 直前が tool_use (active) でも明示的に完了扱いにする (= 生成は止まっている)。これが無いと
+      // ツール実行中の中断後に放置した jsonl が永久に active=true (青) に居座る。
+      if (userText.trim().startsWith("[Request interrupted by user")) {
+        active = false
+        lastTurnEnded = true
+        activeBy = null
+        activeSinceTs = null
+        continue
+      }
+      // コマンド echo (/clear /compact /skill 等) は LLM ターンを起こさない行があるため、
+      // 「実ユーザー入力」とみなさずスキップする (直前の会話状態を保つ)。
+      if (/<command-name>/.test(userText)) continue
+      if (lastTurnEnded) {
+        active = true
+        lastTurnEnded = false
+        activeBy = "user"
+        activeSinceTs = parseEntryTs(d.timestamp)
+      }
+    }
+  }
+  // 鮮度フロア: 実ユーザー入力で active になったまま応答が来ず、その入力が古ければ idle に倒す。
+  if (
+    active &&
+    activeBy === "user" &&
+    activeSinceTs !== null &&
+    now - activeSinceTs > STALE_USER_TAIL_MS
+  ) {
+    return false
+  }
+  return active
+}
+
+/** P5: turnActiveForCwd のメモ (newest fp + mtime + size をキー)。 */
+const _turnActiveMemo = new Map()
+
+/**
+ * 指定 cwd の Claude セッション jsonl から「現在ターンが進行中か」を返す。
+ *
+ * `CockpitStatusDot` の中央ドットの判定権威ソース。サイドバーのドット (非選択
+ * セッション) と送信/停止ボタン (選択セッション、`turnActive` ストリーム由来) を
+ * 同じ真実で同期させ、Esc 中断後の「青固着 60s」を解消する。
+ *
+ * 動作:
+ *  1. cwd → encoded dir → bound `sessionId` の jsonl (あれば最優先) / 無ければ mtime 最新を選ぶ
+ *  2. 末尾 256KB を tail 読みし `scanTurnActive` でターン状態を判定
+ *  3. tail で結論が出ない巨大ツール結果ケースのみ全文 read にフォールバック
+ *
+ * @param {string} cwd
+ * @param {string|null} [sessionId] その tmux ペインが bind しているセッション id。指定時はその
+ *   jsonl を直接読み、cwd dir 内の別セッション/サブエージェント/headless jsonl の取り違えを防ぐ。
+ * @returns {Promise<boolean | null>} true=生成中 / false=待機中 / null=jsonl 不在
+ */
+export async function turnActiveForCwd(cwd, sessionId = null) {
+  if (!cwd) return null
+  const dirName = encodeCwdToDirName(cwd)
+  if (!dirName) return null
+  const dir = path.join(projectsDir(), dirName)
+  const files = await fs.readdir(dir).catch(() => null)
+  if (!files) return null
+
+  // bound session_id があればその jsonl を、無ければ mtime 最新を採用 (cross-activity 汚染回避)。
+  const newest = await resolveTargetJsonl(dir, files, sessionId)
+  if (!newest) return null
+
+  const memo = _turnActiveMemo.get(newest.fp)
+  if (memo && memo.mtimeMs === newest.mtimeMs && memo.size === newest.size) {
+    return memo.result
+  }
+
+  // 256KB tail で多くの場合は決着がつく (1 ターン分の assistant + tool_use/result サイクル) 。
+  // tail 内に assistant 行が 0 件のみのケース (= 巨大 tool_result で先頭を tail から外れた)
+  // に備え、結果が「全行で active 状態が変化しない」場合は全文読みにフォールバックする。
+  const tail = await readTail(newest.fp, 256 * 1024)
+  let active = false
+  if (tail != null) {
+    active = scanTurnActive(tail)
+  }
+  // tail で active=false の場合のみ、巨大 tool_result で先頭の assistant 行が
+  // 落ちて誤って完了扱いになっていないか全文で確認する (高コストだが必要時のみ)。
+  if (active === false) {
+    const full = await readOrNull(newest.fp)
+    if (full != null) active = scanTurnActive(full)
+  }
+  _turnActiveMemo.set(newest.fp, {
+    mtimeMs: newest.mtimeMs,
+    size: newest.size,
+    result: active,
+  })
+  return active
+}
+
+/** テスト用: turnActive メモをクリアする。 */
+export function _resetTurnActiveMemo() {
+  _turnActiveMemo.clear()
+}
+
 /**
  * 5h / 7d 集計の UsageStats を返す。statusLine が無い環境では transcript
  * から推定する。