@cocorograph/hub-agent 0.7.17 → 0.7.18

package/package.json

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

package/src/main.mjs

@@ -87,6 +87,7 @@ 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,
@@ -662,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 する。
@@ -1188,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}: 出力領域署名の最終変化時刻 (出力フロー検知用)。
@@ -1304,14 +1308,17 @@ function startStateLoop({ client, plugins, logger, intervalMs, claudeBridge, rea
         // CockpitStatusDot の青/赤の権威ソース。サイドバーのドットと送信/停止ボタンを同じ真実で
         // 同期させ、Esc 中断後の青固着 (PROMPT_STALE_SHORT_MS=60s) を解消する。
         //  - チャットモード: SDK の rate_limit_event/assistant が最も新鮮なので chat.status を採用
-        //  - TUI モード: jsonl 末尾 assistant.stop_reason から判定 (turnActiveForCwd)
+        //  - 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)
+          turnActive = await turnActiveForCwd(s.cwd, boundSessionId(boundSessions, s.session_name))
         }
 
         const prev = lastByName.get(s.session_name)
@@ -1387,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)
           }
         }
       }
@@ -2901,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) {
@@ -665,6 +719,38 @@ const TURN_END_STOP_REASONS = new Set([
   "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 かを返す。
  *
@@ -679,13 +765,24 @@ const TURN_END_STOP_REASONS = new Set([
  * 初期値は「ターン完了状態」(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) {
+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
@@ -700,10 +797,14 @@ export function scanTurnActive(text) {
       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 ラッパー」を区別する。
@@ -712,12 +813,38 @@ export function scanTurnActive(text) {
       // 来たら新ターン開始 → active=true。
       const content = Array.isArray(d.message?.content) ? d.message.content : []
       const isToolResult = content.some((c) => c?.type === "tool_result")
-      if (!isToolResult && lastTurnEnded) {
+      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
 }
 
@@ -732,14 +859,16 @@ const _turnActiveMemo = new Map()
  * 同じ真実で同期させ、Esc 中断後の「青固着 60s」を解消する。
  *
  * 動作:
- *  1. cwd → encoded dir → 最新 mtime の *.jsonl を選ぶ
+ *  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) {
+export async function turnActiveForCwd(cwd, sessionId = null) {
   if (!cwd) return null
   const dirName = encodeCwdToDirName(cwd)
   if (!dirName) return null
@@ -747,18 +876,8 @@ export async function turnActiveForCwd(cwd) {
   const files = await fs.readdir(dir).catch(() => null)
   if (!files) return null
 
-  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 }
-      }
-    }),
-  )
+  // bound session_id があればその jsonl を、無ければ mtime 最新を採用 (cross-activity 汚染回避)。
+  const newest = await resolveTargetJsonl(dir, files, sessionId)
   if (!newest) return null
 
   const memo = _turnActiveMemo.get(newest.fp)