@cocorograph/hub-agent 0.6.44 → 0.6.45

package/package.json

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

package/src/jsonl-live-watchers.mjs

@@ -0,0 +1,185 @@
+/**
+ * jsonl ライブ追従 watcher の束ね役 (T04784 逐次表示)。
+ *
+ * Cockpit の TUI チャットは「対話 TUI (tmux/PTY) の claude が書く jsonl」を表示源にする。
+ * 従来は session.event (ターン境界) を合図に jsonl 全体を再 hydrate して「どさっと」更新
+ * していたが、ターン中の途中経過は 2.5s ポーリングで拾うしかなく、逐次性が弱かった。
+ *
+ * 本 manager は、ブラウザが送る `claude.tui.viewing {session_id, cwd}` ハートビート
+ * (= まさにその session を TUI チャットで閲覧している瞬間) を起点に、対象 session の
+ * jsonl を byte offset で tail し (claude-history-watch.mjs)、追記行を 1 行ずつ
+ * `claude.jsonl.event` として WS push する。これでターン中の本文・ツール結果が逐次
+ * ブラウザに届き、再 hydrate / ポーリングが不要になる。
+ *
+ * ライフサイクルは watcher ゲートの TuiViewerRegistry と相似形:
+ * - note(): 閲覧ハートビートで watcher を起動 or TTL 延長。
+ * - unwatch(): claude.tui.unviewing で即停止。
+ * - _sweep(): TTL 失効した watcher を掃除 (unviewing 取りこぼし対策)。
+ *
+ * 課金枠への影響なし: jsonl の読み取りはローカル FS の追従であり、モデル呼び出しを
+ * 伴わない (SDK query を起こさない)。TUI モード = サブスク枠のまま。
+ *
+ * fromEnd=true で監視開始時点の既存内容はスキップする。初回履歴は claude.history.request
+ * で別途 hydrate 済みのため、tail は新規分だけでよい (二重 push は frontend が uuid で排除)。
+ */
+
+import { watchSessionFile } from "./claude-history-watch.mjs"
+import { jsonlPath } from "./claude-history.mjs"
+
+/** watcher 鮮度 (ms)。ブラウザのハートビート間隔 (5s) の 3 倍を既定とする。 */
+const WATCHER_TTL_MS = Number(process.env.COCKPIT_JSONL_WATCH_TTL_MS) || 15_000
+/** TTL 失効 watcher を掃除する周期 (ms)。 */
+const SWEEP_INTERVAL_MS = 30 * 1000
+
+/**
+ * session_id ごとに 1 つの jsonl tail watcher を保持し、閲覧ハートビートで延命する。
+ */
+export class JsonlLiveWatchers {
+  /**
+   * @param {object} args
+   * @param {(obj: object) => unknown} args.send - WS 送信 (client.send バインド済み)
+   * @param {() => Promise<string|undefined>|string|undefined} args.getProjectsRoot
+   *   - ~/.claude/projects の実効ルート解決 (アカウント切替を反映)
+   * @param {number} [args.ttlMs]
+   * @param {import('pino').Logger} [args.logger]
+   */
+  constructor({ send, getProjectsRoot, ttlMs = WATCHER_TTL_MS, logger } = {}) {
+    this.send = send
+    this.getProjectsRoot = getProjectsRoot
+    this.ttlMs = ttlMs
+    this.logger = logger
+    /** @type {Map<string, {watcher: {stop: () => void}, cwd: string, expiresAt: number}>} */
+    this._entries = new Map()
+    this._sweepTimer = null
+    /** 同一 session に対する note() の競合を直列化する (二重 watcher 防止)。 */
+    this._starting = new Set()
+  }
+
+  /** 周期 sweep を張る。 */
+  start() {
+    this._sweepTimer = setInterval(() => this._sweep(), SWEEP_INTERVAL_MS)
+    // 他 timer 同様 unref して agent のアイドル終了を妨げない。
+    this._sweepTimer?.unref?.()
+  }
+
+  /**
+   * 閲覧ハートビートを受けて watcher を起動 or 延命する。
+   *
+   * @param {{session_id?: string|null, cwd?: string|null}} info
+   * @returns {Promise<void>}
+   */
+  async note({ session_id, cwd } = {}) {
+    if (!session_id || !cwd) return
+    const existing = this._entries.get(session_id)
+    if (existing) {
+      // 既に追従中: TTL を延長するだけ (cwd が変わるのは想定外なので無視)。
+      existing.expiresAt = Date.now() + this.ttlMs
+      return
+    }
+    // 起動中の重複呼び出しを弾く (ハートビートが連続して来ても watcher は 1 本)。
+    if (this._starting.has(session_id)) return
+    this._starting.add(session_id)
+    try {
+      const projectsRoot = await this._resolveProjectsRoot()
+      // 起動処理中に別経路で登録済みになっていないか再チェック。
+      if (this._entries.has(session_id)) return
+      const filePath = jsonlPath({ cwd, session_id, projectsRoot })
+      const watcher = watchSessionFile({
+        filePath,
+        fromEnd: true,
+        logger: this.logger,
+        onEvent: (event) => {
+          try {
+            this.send?.({
+              type: "claude.jsonl.event",
+              session_id,
+              cwd,
+              event,
+            })
+          } catch (err) {
+            this.logger?.warn(
+              { err: err?.message },
+              "jsonl live watch send failed",
+            )
+          }
+        },
+      })
+      this._entries.set(session_id, {
+        watcher,
+        cwd,
+        expiresAt: Date.now() + this.ttlMs,
+      })
+    } catch (err) {
+      this.logger?.warn(
+        { err: err?.message, session_id },
+        "jsonl live watch start failed",
+      )
+    } finally {
+      this._starting.delete(session_id)
+    }
+  }
+
+  /**
+   * 閲覧終了を受けて watcher を即停止する。
+   *
+   * @param {{session_id?: string|null}} info
+   */
+  unwatch({ session_id } = {}) {
+    if (!session_id) return
+    const entry = this._entries.get(session_id)
+    if (!entry) return
+    this._entries.delete(session_id)
+    try {
+      entry.watcher.stop()
+    } catch {
+      /* ignore */
+    }
+  }
+
+  async _resolveProjectsRoot() {
+    try {
+      const r = this.getProjectsRoot?.()
+      return r && typeof r.then === "function" ? await r : r
+    } catch {
+      return undefined
+    }
+  }
+
+  /** TTL を過ぎた watcher を停止・削除する (unviewing 取りこぼし対策)。 */
+  _sweep() {
+    const now = Date.now()
+    for (const [session_id, entry] of this._entries) {
+      if (entry.expiresAt <= now) {
+        this._entries.delete(session_id)
+        try {
+          entry.watcher.stop()
+        } catch {
+          /* ignore */
+        }
+      }
+    }
+  }
+
+  /** 全 watcher と sweep timer を停止する。 */
+  stop() {
+    if (this._sweepTimer) {
+      clearInterval(this._sweepTimer)
+      this._sweepTimer = null
+    }
+    for (const entry of this._entries.values()) {
+      try {
+        entry.watcher.stop()
+      } catch {
+        /* ignore */
+      }
+    }
+    this._entries.clear()
+  }
+
+  /** テスト用: 現在追従中の session_id 数。 */
+  get size() {
+    return this._entries.size
+  }
+}
+
+export default JsonlLiveWatchers

package/src/main.mjs

@@ -51,6 +51,7 @@ import {
 } from "./tmux.mjs"
 import { TuiPermissionBridge } from "./tui-permission-bridge.mjs"
 import { TuiViewerRegistry } from "./tui-viewer-registry.mjs"
+import { JsonlLiveWatchers } from "./jsonl-live-watchers.mjs"
 import {
   contextWindowSize,
   getSessionUsages,
@@ -439,6 +440,17 @@ export async function startDaemon({ version, ptyModule, claudeSdk } = {}) {
   await tuiViewerRegistry.start()
   ctx.tuiViewerRegistry = tuiViewerRegistry
 
+  // jsonl ライブ追従 (T04784 逐次表示): TUI チャットの閲覧ハートビートを起点に対象
+  // session の jsonl を tail し、追記行を claude.jsonl.event として逐次 push する。
+  // これで session.event 合図 → 全体再 hydrate + 2.5s ポーリングの「どさっと」を廃せる。
+  const jsonlLiveWatchers = new JsonlLiveWatchers({
+    send: (obj) => client.send(obj),
+    getProjectsRoot: getActiveProjectsRoot,
+    logger,
+  })
+  jsonlLiveWatchers.start()
+  ctx.jsonlLiveWatchers = jsonlLiveWatchers
+
   const shutdown = async (signal) => {
     logger.info({ signal }, "shutting down")
     await runHookBroadcast(plugins, "onAgentStop", ctx)
@@ -446,6 +458,7 @@ export async function startDaemon({ version, ptyModule, claudeSdk } = {}) {
     sessionEventLoop?.stop?.()
     tuiPermissionBridge.stop()
     tuiViewerRegistry.stop()
+    jsonlLiveWatchers.stop()
     ptyBridge.shutdown()
     claudeBridge?.shutdown?.()
     client.stop()
@@ -1032,12 +1045,18 @@ async function dispatch(msg, ctx) {
         ctx.tuiViewerRegistry
           ?.note({ session_id: msg.session_id, cwd: msg.cwd })
           .catch(() => {})
+        // T04784 逐次表示: 閲覧中だけ jsonl を tail して claude.jsonl.event を push。
+        ctx.jsonlLiveWatchers
+          ?.note({ session_id: msg.session_id, cwd: msg.cwd })
+          .catch(() => {})
         return
       case "claude.tui.unviewing":
         // 閲覧終了。session_id マーカーを即失効させ、以降の Bash を即 ask に倒す。
         ctx.tuiViewerRegistry
           ?.unview({ session_id: msg.session_id })
           .catch(() => {})
+        // jsonl tail も即停止 (閲覧していない session を追従し続けない)。
+        ctx.jsonlLiveWatchers?.unwatch({ session_id: msg.session_id })
         return
       case "claude.mcp.status":
       case "claude.mcp.reconnect":