@cocorograph/hub-agent 0.6.48 → 0.6.50

package/package.json

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

package/src/claude-history.mjs

@@ -241,3 +241,37 @@ export async function listSessions({ cwd, projectsRoot, limit = 30, logger }) {
   }
   return { sessions }
 }
+
+/**
+ * TUI チャット閲覧中に裏の対話 claude が新しい session_id へ「回転」したか
+ * (= `/clear` で新 jsonl が生まれたか) を判定する純関数。
+ *
+ * 背景: TUI チャットは bind 時に決めた session_id を固定して jsonl を読む。ユーザーが
+ * `/clear` すると裏の claude は**新しい session_id (新 jsonl)** に切り替わるが、フロントは
+ * 旧 jsonl を読み続けるため「読み出し先が切り替わらない」「生成中で固まる」「新セッションへの
+ * 送信が表示されない」という不整合が起きる (T04786 後続調査)。これを agent 側で検知して
+ * `claude.session.rotated` を push し、フロントに読み出し先の切替を促すための判定ロジック。
+ *
+ * 判定材料:
+ * - `viewingSessionId`: フロントが今表示している (閲覧ハートビートが運ぶ) session_id。
+ * - `newestSessionId`: cwd 配下で実際に最新 (mtime 降順先頭) の session_id。
+ * - `lastNotifiedNewId`: 同一 new への多重通知を防ぐため、最後に通知した new_session_id。
+ *
+ * 回転とみなす条件: 最新が存在し、閲覧中 id と異なり、かつ直近で同じ new を通知済みでない。
+ * 注意: 過去セッションを意図的に開いている (= newest 非追従) ビューでは呼び出し側が
+ * `follow_newest=false` でこの判定自体をスキップすること (ピン留め閲覧を勝手に最新へ
+ * 引きずらないため)。本関数は「追従中ビュー」前提で newest とのズレだけを見る。
+ *
+ * @param {{viewingSessionId?: string|null, newestSessionId?: string|null, lastNotifiedNewId?: string|null}} args
+ * @returns {{rotated: boolean, newSessionId?: string}}
+ */
+export function decideSessionRotation({
+  viewingSessionId,
+  newestSessionId,
+  lastNotifiedNewId,
+} = {}) {
+  if (!newestSessionId || !viewingSessionId) return { rotated: false }
+  if (newestSessionId === viewingSessionId) return { rotated: false }
+  if (newestSessionId === lastNotifiedNewId) return { rotated: false }
+  return { rotated: true, newSessionId: newestSessionId }
+}

package/src/main.mjs

@@ -24,10 +24,18 @@ import { WsClient } from "./ws-client.mjs"
 import { PtyBridge } from "./pty-bridge.mjs"
 import { ClaudeStreamBridge } from "./claude-stream-bridge.mjs"
 import { UploadManager } from "./claude-upload.mjs"
-import { fetchSessionHistory, listSessions } from "./claude-history.mjs"
+import {
+  decideSessionRotation,
+  fetchSessionHistory,
+  listSessions,
+} from "./claude-history.mjs"
 import { listAgents } from "./agents.mjs"
 import { listSkills } from "./skills.mjs"
-import { listSessionStates } from "./state.mjs"
+import {
+  capturePane,
+  detectPermissionModeFromText,
+  listSessionStates,
+} from "./state.mjs"
 import {
   DEFAULT_PROFILE_ID,
   defaultConfigDir,
@@ -41,6 +49,7 @@ import {
   buildClaudeCmd,
   createSession as createTmuxSession,
   createWorktreeDir,
+  cyclePermissionMode,
   execTmux,
   killManySessions,
   killSession as killTmuxSession,
@@ -457,6 +466,12 @@ export async function startDaemon({ version, ptyModule, claudeSdk } = {}) {
   // 同じ id への再 respawn (= claude 再起動) を抑止する。
   ctx.tuiReboundSessions = new Map()
 
+  // session 回転通知 (T04786 後続) の多重送信ガード: 回転キー (tmux 名 or cwd) →
+  // 最後に push した new_session_id。閲覧ハートビートは 5s 間隔で来るため、フロントが
+  // 切替を完了し new id でハートビートを送り直すまでの間に来る余分なハートビートで
+  // claude.session.rotated を連発しないようにする。
+  ctx.tuiRotationNotified = new Map()
+
   const shutdown = async (signal) => {
     logger.info({ signal }, "shutting down")
     await runHookBroadcast(plugins, "onAgentStop", ctx)
@@ -701,6 +716,9 @@ function startStateLoop({ client, plugins, logger, intervalMs, claudeBridge }) {
       for (const s of states) {
         let status = s.status
         let contextPct = s.context_pct
+        // 対話 TUI のペインから読んだ権限モード (素のシェル / SDK チャットでは null)。
+        // tmux 上で直接 shift+tab した変更もここで拾い、全ブラウザへ追従させる。
+        const permissionMode = s.permission_mode ?? null
         // チャットモード補完: tmux ペインのスクレイプは TUI 前提で効かないため、
         // session の cwd に一致する新鮮なチャット信号があれば status/context% を
         // 上書きする (Hub ホスト型 Cockpit のステータスドット/各行ドーナツ用)。
@@ -728,17 +746,20 @@ function startStateLoop({ client, plugins, logger, intervalMs, claudeBridge }) {
         if (
           !prev ||
           prev.status !== status ||
-          prev.context_pct !== contextPct
+          prev.context_pct !== contextPct ||
+          prev.permission_mode !== permissionMode
         ) {
           lastByName.set(s.session_name, {
             status,
             context_pct: contextPct,
+            permission_mode: permissionMode,
           })
           client.send({
             type: "session.state",
             session_name: s.session_name,
             status,
             context_pct: contextPct,
+            permission_mode: permissionMode,
           })
         }
       }
@@ -1046,7 +1067,7 @@ async function dispatch(msg, ctx) {
         if (!ctx.claudeBridge) return
         ctx.claudeBridge.interrupt({ stream_id: msg.stream_id })
         return
-      case "claude.tui.viewing":
+      case "claude.tui.viewing": {
         // T04778 watcher ゲート: browser が TUI チャットでこの session を閲覧中。
         // 閲覧マーカーを更新し、承認フックが「閲覧者あり」と判定できるようにする。
         ctx.tuiViewerRegistry
@@ -1056,7 +1077,59 @@ async function dispatch(msg, ctx) {
         ctx.jsonlLiveWatchers
           ?.note({ session_id: msg.session_id, cwd: msg.cwd })
           .catch(() => {})
+        // T04786 後続: session 回転検知 (/clear で裏 claude が新 session_id へ切替)。
+        // 追従中ビュー (follow_newest 既定 true) のときだけ、cwd の最新 session_id と
+        // 閲覧中 id を突き合わせ、ズレていれば claude.session.rotated を push してフロントに
+        // 読み出し先の切替を促す。過去セッションを意図的に開いているビュー (follow_newest=false)
+        // では検知しない (ピン留め閲覧を最新へ引きずらない)。
+        const viewSid = msg.session_id
+        const viewCwd = msg.cwd
+        const viewName =
+          typeof msg.session_name === "string" ? msg.session_name : ""
+        const followNewest = msg.follow_newest !== false
+        if (followNewest && viewSid && viewCwd) {
+          ;(async () => {
+            try {
+              const projectsRoot = await getActiveProjectsRoot()
+              const { sessions } = await listSessions({
+                cwd: viewCwd,
+                projectsRoot,
+                limit: 1,
+                logger,
+              })
+              const newestId = sessions?.[0]?.session_id || null
+              const key = viewName || viewCwd
+              const { rotated, newSessionId } = decideSessionRotation({
+                viewingSessionId: viewSid,
+                newestSessionId: newestId,
+                lastNotifiedNewId: ctx.tuiRotationNotified.get(key),
+              })
+              if (!rotated) return
+              ctx.tuiRotationNotified.set(key, newSessionId)
+              // 冪等マップも新 id へ更新し、将来の remount bind が旧 id へ
+              // respawn (claude 再起動) してしまうのを防ぐ。
+              if (viewName) ctx.tuiReboundSessions.set(viewName, newSessionId)
+              ctx.client.send({
+                type: "claude.session.rotated",
+                cwd: viewCwd,
+                session_name: viewName || undefined,
+                old_session_id: viewSid,
+                new_session_id: newSessionId,
+              })
+              logger.info(
+                { session: viewName, cwd: viewCwd, old: viewSid, new: newSessionId },
+                "tui session rotated (/clear) → notified browser",
+              )
+            } catch (err) {
+              logger.warn(
+                { err: err?.message, cwd: viewCwd },
+                "tui session rotation check failed",
+              )
+            }
+          })()
+        }
         return
+      }
       case "claude.tui.unviewing":
         // 閲覧終了。session_id マーカーを即失効させ、以降の Bash を即 ask に倒す。
         ctx.tuiViewerRegistry
@@ -1065,6 +1138,74 @@ async function dispatch(msg, ctx) {
         // jsonl tail も即停止 (閲覧していない session を追従し続けない)。
         ctx.jsonlLiveWatchers?.unwatch({ session_id: msg.session_id })
         return
+      case "claude.tui.cyclePermission": {
+        // 権限バッジ押下 → 対話 claude TUI へ shift+tab を送って権限モードを循環。
+        // 旧実装は frontend が raw pty.data (BACKTAB) を送り、各端末が楽観値を
+        // 個別に 1 段進めるだけだったため、複数端末間でズレ、かつ tmux 上で直接
+        // 切り替えた変更とも乖離した。ここで agent が実キー送出 → ペイン再読込で
+        // 実モードを確定 → 全ブラウザへ claude.tui.permission を broadcast し、
+        // 「実際に動いているターミナルの状態」を正本として全端末に同期する。
+        const cwd = typeof msg.cwd === "string" ? msg.cwd : ""
+        const sessionName =
+          typeof msg.session_name === "string" ? msg.session_name : ""
+        if (!sessionName) return
+        ;(async () => {
+          try {
+            await cyclePermissionMode(sessionName, { logger })
+            // TUI がフッターバナーを再描画するまで少し待ってから実モードを読む。
+            await new Promise((r) => setTimeout(r, 250))
+            const text = await capturePane(sessionName, { noCache: true })
+            const mode = detectPermissionModeFromText(text)
+            ctx.client.send({
+              type: "claude.tui.permission",
+              cwd: cwd || undefined,
+              session_name: sessionName,
+              permission_mode: mode,
+            })
+            logger.info(
+              { session: sessionName, cwd, mode },
+              "tui permission cycled → notified browser",
+            )
+          } catch (err) {
+            logger.warn(
+              { err: err?.message, session: sessionName },
+              "claude.tui.cyclePermission failed",
+            )
+          }
+        })()
+        return
+      }
+      case "claude.tui.probePermission": {
+        // 読み取り専用の権限モード問い合わせ (cold-load seed)。キーは送らず、ペインを
+        // 読んで現在の実モードを claude.tui.permission として broadcast するだけ。
+        // ブラウザがマウント直後に「今ターミナルが何モードか」を取得し、楽観値や
+        // 古い jsonl 値とのズレを開始時点から揃えるために使う。検出不能 (claude 起動中・
+        // 素のシェル) のときは mode=null となり、frontend 側は据え置く。
+        const cwd = typeof msg.cwd === "string" ? msg.cwd : ""
+        const sessionName =
+          typeof msg.session_name === "string" ? msg.session_name : ""
+        if (!sessionName) return
+        ;(async () => {
+          try {
+            const text = await capturePane(sessionName, { noCache: true })
+            const mode = detectPermissionModeFromText(text)
+            // 検出できた時だけ通知する (null で badge を消さない)。
+            if (!mode) return
+            ctx.client.send({
+              type: "claude.tui.permission",
+              cwd: cwd || undefined,
+              session_name: sessionName,
+              permission_mode: mode,
+            })
+          } catch (err) {
+            logger.warn(
+              { err: err?.message, session: sessionName },
+              "claude.tui.probePermission failed",
+            )
+          }
+        })()
+        return
+      }
       case "claude.tui.bind": {
         // T04784 会話継続バインディング: TUI モード突入時に 1 回送られる。
         //   1. 対象 cwd の最新 session_id を確定 (browser 指定があれば優先)。

package/src/state.mjs

@@ -82,6 +82,43 @@ export function detectContextPctFromText(text) {
   return null
 }
 
+// 対話 claude TUI のフッターに出る権限モードバナー (claude v2.1 系で実機確認)。
+// shift+tab で循環: default(バナー無し) → accept edits → plan → auto → …
+const PERMISSION_BANNERS = [
+  [/⏵⏵\s*accept edits on/i, "acceptEdits"],
+  [/⏸\s*plan mode on/i, "plan"],
+  [/⏵⏵\s*auto mode on/i, "auto"],
+  [/bypass permissions on/i, "bypassPermissions"],
+]
+
+/**
+ * 対話 claude TUI のペインテキストから現在の権限モードを判定する。
+ *
+ * 全端末で「実際に動いているターミナルの権限状態」を同期するための正本。
+ * jsonl の permissionMode は送信ターン毎にしか記録されないため、shift+tab した
+ * だけ (未送信) の変更や tmux 上で直接切り替えた変更は jsonl に出ない。ペインの
+ * フッターバナーは shift+tab 直後に即更新されるので、これを正本にする。
+ *
+ * - 明示バナー (accept edits / plan / auto / bypass) があればそのモード。
+ * - バナーが無い場合、claude TUI のフッターが見えている時だけ "default" と判定する
+ *   (素のシェルを default と誤検出しないためのガード)。
+ * - claude TUI と判別できなければ null (= 不明、呼び出し側は据え置き)。
+ *
+ * @param {string} text capturePane の結果 (ANSI 除去済み)
+ * @returns {string|null}
+ */
+export function detectPermissionModeFromText(text) {
+  if (!text) return null
+  for (const [re, mode] of PERMISSION_BANNERS) {
+    if (re.test(text)) return mode
+  }
+  // バナー無し = default。ただし claude TUI のフッターが見えている時だけ assert する。
+  if (/← for agents|for shortcuts|shift\+tab to cycle/i.test(text)) {
+    return "default"
+  }
+  return null
+}
+
 export async function listSessionNames(opts = {}) {
   const tmuxBin = opts.tmuxBin || "tmux"
   try {
@@ -165,6 +202,7 @@ export async function detectSessionState(sessionName, opts = {}) {
   const text = await capturePane(sessionName, opts)
   const defaultStatus = detectStatusFromText(text)
   const defaultContextPct = detectContextPctFromText(text)
+  const defaultPermissionMode = detectPermissionModeFromText(text)
 
   if (opts.plugins && opts.plugins.length) {
     const hookResult = await runHookChain(opts.plugins, "transformStatusDetection", {
@@ -177,11 +215,17 @@ export async function detectSessionState(sessionName, opts = {}) {
       return {
         status: hookResult.result.status || defaultStatus,
         context_pct: hookResult.result.context_pct ?? defaultContextPct,
+        permission_mode:
+          hookResult.result.permission_mode ?? defaultPermissionMode,
       }
     }
   }
 
-  return { status: defaultStatus, context_pct: defaultContextPct }
+  return {
+    status: defaultStatus,
+    context_pct: defaultContextPct,
+    permission_mode: defaultPermissionMode,
+  }
 }
 
 /** 全 session の現在状態を取得する。cwd も含める (chat 信号照合用)。 */

package/src/tmux.mjs

@@ -716,6 +716,53 @@ export function buildResumeCmd(sessionId, opts = {}) {
 
 const _delay = (ms) => new Promise((r) => setTimeout(r, ms))
 
+/**
+ * 対話 claude TUI に shift+tab (BACKTAB) を 1 回送って権限モードを循環させる。
+ *
+ * 全端末で「実際に動いているターミナルの権限状態」を同期する仕組みの書込側
+ * (読込側は state.mjs の detectPermissionModeFromText)。フロントからの権限バッジ
+ * 押下は raw pty.data ではなく `claude.tui.cyclePermission` を送り、agent 側で
+ * 本関数を実行 → ペイン再読込で実モードを確定 → 全ブラウザへ broadcast する。
+ * これにより楽観値が端末間でズレず、jsonl 未記録 (未送信) の変更も即同期される。
+ *
+ * copy-mode 等に入っているとキーが奪われるので、入っていれば先に抜ける
+ * (フロントの cancelTmuxMode 相当を agent 側でも担保)。ベストエフォート。
+ *
+ * @param {string} name tmux セッション名
+ * @param {{logger?:object,tmuxBin?:string}} [opts]
+ * @returns {Promise<{ok:boolean, error?:string}>}
+ */
+export async function cyclePermissionMode(name, opts = {}) {
+  const bin = tmuxBin(opts)
+  try {
+    // copy-mode 等に入っていると BTab が奪われるので、入っている時だけ抜ける。
+    try {
+      const { stdout } = await execFileP(bin, [
+        "display-message",
+        "-p",
+        "-t",
+        `${name}:`,
+        "-F",
+        "#{pane_in_mode}",
+      ])
+      if (stdout.trim() === "1") {
+        await execFileP(bin, ["send-keys", "-t", name, "-X", "cancel"])
+      }
+    } catch {
+      // pane_in_mode 取得失敗はベストエフォートで無視 (そのまま BTab を送る)。
+    }
+    // BTab = shift+tab。claude TUI が権限モードを 1 段循環する。
+    await execFileP(bin, ["send-keys", "-t", name, "BTab"])
+    return { ok: true }
+  } catch (err) {
+    opts.logger?.warn(
+      { session: name, err: err?.message },
+      "cyclePermissionMode failed",
+    )
+    return { ok: false, error: err?.message || String(err) }
+  }
+}
+
 /**
  * tmux セッションの対話 claude を、指定 session_id に `--resume` で載せ替える
  * (T04784 TUI resume binding)。