@cocorograph/hub-agent 0.7.15 → 0.7.17

package/package.json

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

package/src/main.mjs

@@ -91,6 +91,7 @@ import {
   getSessionUsages,
   getUsage,
   recordChatRateLimit,
+  turnActiveForCwd,
 } from "./usage.mjs"
 import {
   clearChatSignal,
@@ -1298,6 +1299,21 @@ 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 モード: jsonl 末尾 assistant.stop_reason から判定 (turnActiveForCwd)
+        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)
+        }
+
         const prev = lastByName.get(s.session_name)
         if (
           !prev ||
@@ -1307,7 +1323,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 +1334,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 +1351,7 @@ function startStateLoop({ client, plugins, logger, intervalMs, claudeBridge, rea
               armed,
               stable,
               context_pct: contextPct,
+              turn_active: turnActive,
             },
             "session.state push",
           )
@@ -1349,6 +1368,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 を

package/src/tmux.mjs

@@ -27,7 +27,7 @@ import {
   detectSessionState,
   getSessionCwd,
 } from "./state.mjs"
-import { getSessionUsages } from "./usage.mjs"
+import { getSessionUsages, jsonlContextForCwd } from "./usage.mjs"
 
 const execFileP = promisify(execFile)
 
@@ -634,10 +634,23 @@ export async function listSessions(opts = {}) {
         detectSessionState(s.name, opts),
         getSessionCwd(s.name, opts),
       ])
-      // statusLine 由来 context% を最優先 (USED %), なければ pane 解析の fallback
+      // context% (USED %) は以下の順で採用する:
+      //  1. jsonl per-cwd で「`/clear` 直後 (uuid 変化) かつ新 jsonl に応答未着」
+      //     と確定したら 0% を即採用 (= リセット最速反映)。statusLine cache は
+      //     前セッションの値を抱えたまま居座り、次のプロンプトまで更新されない。
+      //  2. それ以外は statusLine cache (USED %) を最優先 (claude 公式値)。
+      //  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
       const context_pct =
-        typeof fromStatusLine === "number" ? fromStatusLine : state.context_pct
+        jsonlInfo?.isReset && typeof jsonlInfo.percent === "number"
+          ? jsonlInfo.percent
+          : typeof fromStatusLine === "number"
+            ? fromStatusLine
+            : typeof jsonlInfo?.percent === "number"
+              ? jsonlInfo.percent
+              : state.context_pct
       return {
         ...s,
         status: state.status,

package/src/usage.mjs

@@ -21,6 +21,8 @@ import { randomUUID } from "node:crypto"
 import os from "node:os"
 import path from "node:path"
 
+import { encodeCwdToDirName } from "./claude-history.mjs"
+
 function configPath(envKey, ...fallback) {
   return process.env[envKey] || path.join(...fallback)
 }
@@ -529,6 +531,268 @@ async function latestJsonlContext(now) {
   return result
 }
 
+/**
+ * cwd → 最後に観測した newest jsonl uuid。`/clear` 検知 (uuid 変化 → 新セッション)
+ * に使う。`jsonlContextForCwd` の呼び出しごとに更新される。
+ */
+const _jsonlSessionUuidByCwd = new Map()
+
+/**
+ * 指定 cwd の Claude セッション jsonl から context% (USED %) を算出する。
+ *
+ * 役割:
+ *  - `latestJsonlContext` が「直近全プロジェクト共通の最新 1 件」を返すのに対し、
+ *    こちらは「この cwd の最新セッション」を返す。tmux セッション 1 つに対する
+ *    ドーナツ表示の per-session ソースとして使う。
+ *  - `/clear` 直後は新規 jsonl ファイル (新 uuid) が作成される。assistant.usage が
+ *    まだ書かれていない瞬間は前回 uuid と異なれば「コンテキスト全消し」と確定でき、
+ *    statusLine cache が前セッションの値を抱えたまま 0% に落ちない不具合を回避する。
+ *
+ * 動作:
+ *  1. cwd → encoded dir → `*.jsonl` のうち最新 mtime を newest として選ぶ
+ *  2. newest jsonl の末尾 assistant.usage を `(input + cache_read + cache_creation
+ *     + output) / window_size` で % 化
+ *  3. 末尾に assistant.usage が無い (= 新セッション直後で 1 通も応答していない)
+ *     場合、前回観測 uuid と異なれば `{ percent: 0, isReset: true }` を返す。
+ *     同じ uuid のまま (= 初回ロード直後) なら `{ percent: null, isReset: false }`。
+ *
+ * 呼び出し側 (`tmux.mjs listSessionStates`) の優先順位:
+ *  - `isReset === true` のとき statusLine cache の前セッション値より優先 (= 0% を採用)
+ *  - そうでなければ statusLine > jsonl > pane scrape の順
+ *
+ * @param {string} cwd
+ * @returns {Promise<{ percent: number | null, uuid: string | null, isReset: boolean }>}
+ */
+export async function jsonlContextForCwd(cwd) {
+  const empty = { percent: null, uuid: null, isReset: false }
+  if (!cwd) return empty
+  const dirName = encodeCwdToDirName(cwd)
+  if (!dirName) return empty
+  const dir = path.join(projectsDir(), dirName)
+  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$/, ""),
+        }
+      }
+    }),
+  )
+  if (!newest) return empty
+
+  // 末尾 assistant.usage を探す。`_jsonlCtxMemo` は fp+mtime+size をキーにしているので
+  // 同 jsonl の連続呼び出しは I/O ゼロでヒットする。
+  const memo = _jsonlCtxMemo.get(newest.fp)
+  let percent = null
+  if (memo && memo.mtimeMs === newest.mtimeMs && memo.size === newest.size) {
+    percent = memo.result ? memo.result.percent : null
+  } else {
+    const windowSize = await contextWindowSize()
+    const scan = (text) => {
+      const lines = text.split("\n")
+      for (let i = lines.length - 1; i >= 0; i--) {
+        const line = lines[i]
+        if (!line || !line.includes('"usage"')) continue
+        let d
+        try {
+          d = JSON.parse(line)
+        } catch {
+          continue
+        }
+        if (d.type !== "assistant") continue
+        const u = d.message?.usage
+        if (!u) continue
+        const tokens =
+          (u.input_tokens || 0) +
+          (u.cache_read_input_tokens || 0) +
+          (u.cache_creation_input_tokens || 0) +
+          (u.output_tokens || 0)
+        if (tokens <= 0) continue
+        return Math.min(100, Math.round((tokens / windowSize) * 1000) / 10)
+      }
+      return null
+    }
+    const tail = await readTail(newest.fp)
+    if (tail != null) percent = scan(tail)
+    if (percent == null) {
+      const full = await readOrNull(newest.fp)
+      if (full != null) percent = scan(full)
+    }
+    const result = percent == null ? null : { percent, mtimeMs: newest.mtimeMs }
+    _jsonlCtxMemo.set(newest.fp, {
+      mtimeMs: newest.mtimeMs,
+      size: newest.size,
+      result,
+    })
+  }
+
+  const prevUuid = _jsonlSessionUuidByCwd.get(cwd)
+  _jsonlSessionUuidByCwd.set(cwd, newest.uuid)
+  const uuidChanged = prevUuid !== undefined && prevUuid !== newest.uuid
+
+  if (percent == null) {
+    // assistant.usage が見つからない = まだ 1 通も応答していない新セッション。
+    // 直前まで別 uuid を観測していたなら `/clear` 直後と確定でき 0% を返す。
+    if (uuidChanged) {
+      return { percent: 0, uuid: newest.uuid, isReset: true }
+    }
+    return { percent: null, uuid: newest.uuid, isReset: false }
+  }
+  return { percent, uuid: newest.uuid, isReset: uuidChanged }
+}
+
+/** テスト用: per-cwd uuid 観測ストアをクリアする。 */
+export function _resetJsonlSessionUuids() {
+  _jsonlSessionUuidByCwd.clear()
+}
+
+// ターン完了を示す Anthropic API `stop_reason`。これ以外 (代表的には `tool_use`)
+// は「ターン継続中 = 生成 / ツール処理中」とみなす。
+const TURN_END_STOP_REASONS = new Set([
+  "end_turn",
+  "stop_sequence",
+  "max_tokens",
+])
+
+/**
+ * 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 でフォールバックする。
+ *
+ * @param {string} text jsonl の (末尾) テキスト
+ * @returns {boolean}
+ */
+export function scanTurnActive(text) {
+  if (!text) return false
+  let active = false
+  let lastTurnEnded = true
+  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
+      } else {
+        // tool_use / pause_turn / null / 未知 → ターン継続中扱い (安全側)
+        active = true
+        lastTurnEnded = false
+      }
+    } 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 && lastTurnEnded) {
+        active = true
+        lastTurnEnded = false
+      }
+    }
+  }
+  return active
+}
+
+/** P5: turnActiveForCwd のメモ (newest fp + mtime + size をキー)。 */
+const _turnActiveMemo = new Map()
+
+/**
+ * 指定 cwd の Claude セッション jsonl から「現在ターンが進行中か」を返す。
+ *
+ * `CockpitStatusDot` の中央ドットの判定権威ソース。サイドバーのドット (非選択
+ * セッション) と送信/停止ボタン (選択セッション、`turnActive` ストリーム由来) を
+ * 同じ真実で同期させ、Esc 中断後の「青固着 60s」を解消する。
+ *
+ * 動作:
+ *  1. cwd → encoded dir → 最新 mtime の *.jsonl を選ぶ
+ *  2. 末尾 256KB を tail 読みし `scanTurnActive` でターン状態を判定
+ *  3. tail で結論が出ない巨大ツール結果ケースのみ全文 read にフォールバック
+ *
+ * @param {string} cwd
+ * @returns {Promise<boolean | null>} true=生成中 / false=待機中 / null=jsonl 不在
+ */
+export async function turnActiveForCwd(cwd) {
+  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
+
+  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 }
+      }
+    }),
+  )
+  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
  * から推定する。