@cocorograph/hub-agent 0.6.45 → 0.6.46

package/package.json

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

package/src/claude-stream-bridge.mjs

@@ -1136,6 +1136,51 @@ export class ClaudeStreamBridge extends EventEmitter {
     }
   }
 
+  /**
+   * 指定 cwd / session_id に紐づく SDK セッションを**即停止**する (T04784 TUI bind 用)。
+   *
+   * TUI モードに切り替えた session は対話 TUI (tmux/PTY) の claude が write を担うため、
+   * SDK セッションを生かしたままだと同一 cwd の jsonl を二重ホストして競合する
+   * (DESIGN.md C7)。soft-detach (7 日 resident) では止まらないので、ここで明示 close する。
+   *
+   * @param {{cwd?: string, session_id?: string}} sel
+   * @returns {number} 停止したセッション数
+   */
+  stopSessionsFor({ cwd, session_id } = {}) {
+    const victims = new Set()
+    if (session_id) {
+      const s = this._liveBySession.get(session_id)
+      if (s) victims.add(s)
+    }
+    if (cwd) {
+      for (const s of this._liveBySession.values()) {
+        if (s.cwd === cwd) victims.add(s)
+      }
+      // session_id 未確定 (起動直後) の端末は sessions Map 側で cwd 一致を拾う。
+      for (const s of this.sessions.values()) {
+        if (s.cwd === cwd) victims.add(s)
+      }
+    }
+    let stopped = 0
+    for (const s of victims) {
+      if (s._closed) continue
+      this._dropSessionMappings(s)
+      try {
+        s.close()
+      } catch {
+        /* ignore */
+      }
+      this.emit("exit", {
+        stream_id: s.stream_id,
+        code: 0,
+        reason: "tui-bind-stop",
+        session_id: s.sessionId,
+      })
+      stopped++
+    }
+    return stopped
+  }
+
   /**
    * 新しい Claude セッションを開始する。
    *

package/src/main.mjs

@@ -47,6 +47,7 @@ import {
   listSessions as listTmuxSessions,
   listWorktreeNameHistory,
   listWorktreeStubs,
+  rebindClaudeSession,
   removeWorktree as removeWorktreeDir,
 } from "./tmux.mjs"
 import { TuiPermissionBridge } from "./tui-permission-bridge.mjs"
@@ -1058,6 +1059,70 @@ async function dispatch(msg, ctx) {
         // jsonl tail も即停止 (閲覧していない session を追従し続けない)。
         ctx.jsonlLiveWatchers?.unwatch({ session_id: msg.session_id })
         return
+      case "claude.tui.bind": {
+        // T04784 会話継続バインディング: TUI モード突入時に 1 回送られる。
+        //   1. 対象 cwd の最新 session_id を確定 (browser 指定があれば優先)。
+        //   2. その session の SDK を完全停止 (二重ホスト/枠流出を防ぐ)。
+        //   3. 裏の tmux claude を `--resume <id>` で同じ会話に載せ替える (read=write 一致)。
+        // ベストエフォート。失敗時は frontend が従来 newest 表示に degrade する。
+        const request_id = msg.request_id
+        const cwd = typeof msg.cwd === "string" ? msg.cwd : ""
+        const sessionName =
+          typeof msg.session_name === "string" ? msg.session_name : ""
+        const reply = (payload) =>
+          ctx.client.send({
+            type: "claude.tui.bind.result",
+            request_id,
+            ...payload,
+          })
+        try {
+          // 1) 載せ替え先 session_id を確定。
+          let targetId =
+            typeof msg.session_id === "string" && msg.session_id
+              ? msg.session_id
+              : null
+          if (!targetId && cwd) {
+            const projectsRoot = await getActiveProjectsRoot()
+            const { sessions } = await listSessions({
+              cwd,
+              projectsRoot,
+              limit: 1,
+              logger,
+            })
+            targetId = sessions?.[0]?.session_id || null
+          }
+          // 2) SDK を停止 (cwd 全体 + 対象 id)。
+          let stoppedSdk = 0
+          if (ctx.claudeBridge) {
+            stoppedSdk = ctx.claudeBridge.stopSessionsFor({
+              cwd,
+              session_id: targetId || undefined,
+            })
+          }
+          // 3) tmux claude を --resume で載せ替え (targetId があるときだけ)。
+          let rebind = { ok: false }
+          if (targetId && sessionName) {
+            rebind = await rebindClaudeSession(sessionName, targetId, {
+              model: ctx.config?.claude_model || "",
+              permissionMode: ctx.config?.claude_permission_mode || "",
+              logger,
+            })
+          }
+          reply({
+            session_id: targetId,
+            stopped_sdk: stoppedSdk,
+            rebound: !!rebind.ok,
+            error: rebind.ok ? undefined : rebind.error,
+          })
+        } catch (err) {
+          logger?.warn(
+            { err: err?.message, sessionName, cwd },
+            "claude.tui.bind failed",
+          )
+          reply({ session_id: null, error: err?.message || String(err) })
+        }
+        return
+      }
       case "claude.mcp.status":
       case "claude.mcp.reconnect":
       case "claude.mcp.authenticate":

package/src/tmux.mjs

@@ -679,3 +679,115 @@ export async function createSession(name, cwd, opts = {}) {
     await execFileP(tmuxBin(opts), ["send-keys", "-t", name, claudeCmd, "Enter"])
   }
 }
+
+/** session_id として安全な形だけ許可する (send-keys へ流すためコマンド注入を防ぐ)。
+ *  Claude の session_id は UUID (ASCII 英数 + ハイフン) なので、それ以外は弾く。 */
+export function isSafeSessionId(sessionId) {
+  return typeof sessionId === "string" && /^[A-Za-z0-9_-]{8,128}$/.test(sessionId)
+}
+
+/** agent 設定 (model / permissionMode) を claude のフラグ文字列に変換する ("" or "--model X ...")。 */
+export function composeClaudeFlags(opts = {}) {
+  const model = (opts.model || "").trim()
+  const mode = (opts.permissionMode || "").trim()
+  const flags = []
+  if (model) flags.push(`--model ${model}`)
+  if (mode) flags.push(`--permission-mode ${mode}`)
+  return flags.join(" ")
+}
+
+/**
+ * TUI 載せ替え用の `claude --resume <id> [flags]` コマンド文字列を組み立てる (純粋関数)。
+ * session_id を明示 resume することで、表示(read)と書込(write)の jsonl を一致させる
+ * (`--continue` は解決後 id 不明で read/write が乖離しうるため不可)。
+ *
+ * @param {string} sessionId
+ * @param {{model?:string,permissionMode?:string}} [opts]
+ * @returns {string}
+ * @throws session_id が安全形でなければ throw (コマンド注入防止)
+ */
+export function buildResumeCmd(sessionId, opts = {}) {
+  if (!isSafeSessionId(sessionId)) {
+    throw new Error(`unsafe session_id for resume: ${String(sessionId)}`)
+  }
+  const flags = composeClaudeFlags(opts)
+  return `claude --resume ${sessionId}${flags ? " " + flags : ""}`.trim()
+}
+
+const _delay = (ms) => new Promise((r) => setTimeout(r, ms))
+
+/** pane_current_command が claude でなくなる (= シェルに戻った) のを待つ。 */
+async function _waitPaneLeftClaude(name, opts = {}, timeoutMs = 4000) {
+  const bin = tmuxBin(opts)
+  const start = Date.now()
+  while (Date.now() - start < timeoutMs) {
+    try {
+      const { stdout } = await execFileP(bin, [
+        "display-message",
+        "-p",
+        "-t",
+        name,
+        "#{pane_current_command}",
+      ])
+      const cmd = (stdout || "").trim().toLowerCase()
+      if (cmd && !cmd.includes("claude")) return true
+    } catch {
+      /* ignore */
+    }
+    await _delay(200)
+  }
+  return false
+}
+
+/**
+ * tmux セッションの対話 claude を、指定 session_id に `--resume` で載せ替える
+ * (T04784 TUI resume binding)。
+ *
+ * 手順 (in-pane 再起動。PTY/attach は維持するので browser の隠し端末は繋がったまま):
+ *   1. Ctrl-C を数回送り、生成中断 → claude REPL を抜けてシェルへ戻す
+ *      (claude は空入力 Ctrl-C 2 回で exit する)。
+ *   2. pane_current_command が claude でなくなるのを待つ (最大 timeoutMs)。
+ *   3. 行頭をクリア (C-u) してから `claude --resume <id> [flags]` を送って起動。
+ *
+ * ベストエフォート。失敗しても throw せず {ok:false} を返し、上位は newest 表示に degrade する。
+ *
+ * @param {string} name tmux セッション名
+ * @param {string} sessionId 載せ替え先 Claude session_id
+ * @param {{model?:string,permissionMode?:string,logger?:object,tmuxBin?:string}} [opts]
+ * @returns {Promise<{ok:boolean, leftClaude?:boolean, cmd?:string, error?:string}>}
+ */
+export async function rebindClaudeSession(name, sessionId, opts = {}) {
+  let cmd
+  try {
+    cmd = buildResumeCmd(sessionId, opts) // session_id 検証もここで実施
+  } catch (err) {
+    return { ok: false, error: err?.message || String(err) }
+  }
+  const bin = tmuxBin(opts)
+  const send = (...keys) =>
+    execFileP(bin, ["send-keys", "-t", name, ...keys]).catch(() => {})
+  try {
+    // 1) 生成中断 + REPL 終了 (Ctrl-C 連打)。
+    for (let i = 0; i < 4; i++) {
+      await send("C-c")
+      await _delay(180)
+    }
+    // 2) シェルに戻るのを待つ。
+    const leftClaude = await _waitPaneLeftClaude(name, opts, 4000)
+    // 3) 行をクリアして resume コマンドを起動。
+    await send("C-u")
+    await _delay(80)
+    await execFileP(bin, ["send-keys", "-t", name, cmd, "Enter"])
+    opts.logger?.info(
+      { session: name, resume: sessionId, leftClaude },
+      "tui rebind: relaunched claude with --resume",
+    )
+    return { ok: true, leftClaude, cmd }
+  } catch (err) {
+    opts.logger?.warn(
+      { session: name, resume: sessionId, err: err?.message },
+      "tui rebind failed",
+    )
+    return { ok: false, error: err?.message || String(err) }
+  }
+}