@cocorograph/hub-agent 0.6.17 → 0.6.19

package/package.json

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

package/src/claude-stream-bridge.mjs

@@ -47,6 +47,21 @@ const CHAT_RESIDENT_ENABLED = process.env.HUB_AGENT_CHAT_RESIDENT !== "0"
 const CHAT_RESIDENT_RESUME_ENABLED =
   process.env.HUB_AGENT_CHAT_RESIDENT_RESUME !== "0"
 
+/** 多端末共有セッション (2026-05-30)。同じ Claude セッション (session_id) を複数端末で
+ *  同時に開いて、どの端末でもライブ表示・入力・許可応答できるようにする。env
+ *  HUB_AGENT_CHAT_SHARED="1" で有効化 (デフォルト無効 = 従来の「最後の端末だけが live」)。
+ *
+ *  有効時の差分:
+ *   - reattach で旧 stream_id を sessions Map から消さず、1 セッションに複数の端末
+ *     stream_id を購読登録する (this.streamIds)。これにより旧端末からの input /
+ *     permission.reply / interrupt も sessions.get(stream_id) で解決できる。
+ *   - detach は購読端末の参照カウントを下げ、最後の 1 台が外れて初めて idle softDetach
+ *     する (1 台閉じただけで走行中セッションを撤去しない)。
+ *  配信のファンアウト自体は Hub backend が session_id 単位の group broadcast で行うため、
+ *  agent 側はイベントに session_id を載せるだけでよい (既に emit 済み)。無効時は従来の
+ *  単一 stream_id 挙動と完全に一致する (this.streamIds は未使用のまま)。 */
+const CHAT_SHARED_ENABLED = process.env.HUB_AGENT_CHAT_SHARED === "1"
+
 /** 文字列を SDK streaming input の SDKUserMessage に包む。
  *  SDKUserMessage は parent_tool_use_id: string|null が必須フィールド。現行 SDK は入力側で
  *  寛容なので省略しても動くが、将来の型厳格化に備えて明示する。トップレベルのユーザー入力
@@ -133,6 +148,10 @@ class ClaudeStreamSession {
     onReap,
   }) {
     this.stream_id = stream_id
+    /** 多端末共有: このセッションを購読中の全端末 stream_id。CHAT_SHARED_ENABLED 時のみ
+     *  参照され、reattach で増え detach で減る。最後の 1 台が外れると idle softDetach に入る。
+     *  this.stream_id は「最も新しく attach した端末」= legacy emit / primary 用に残す。 */
+    this.streamIds = new Set([stream_id])
     this.cwd = cwd
     this.model = model || null
     this.permissionMode = permissionMode || null
@@ -278,6 +297,9 @@ class ClaudeStreamSession {
    *  不具合の原因)。 */
   reattach(stream_id, opts = undefined) {
     this.stream_id = stream_id
+    // 多端末共有: この端末を購読集合に追加 (無効時は未使用)。旧端末の stream_id は
+    // bridge.attach 側で sessions Map に残されるため、ここでは増やすだけでよい。
+    this.streamIds.add(stream_id)
     this._detached = false
     if (this._idleTimer) {
       clearTimeout(this._idleTimer)
@@ -779,6 +801,23 @@ export class ClaudeStreamBridge extends EventEmitter {
     this._liveBySession = new Map()
   }
 
+  /** 多端末共有: あるセッションに紐づく全端末 stream_id を sessions Map から外し、
+   *  session_id 索引も掃除する。撤去 (reap / idle / shutdown) で 1 端末分だけ消すと
+   *  他端末キーが Map に残って孤児化するため、まとめて消す。 */
+  _dropSessionMappings(session) {
+    // session.streamIds に載っている端末キーをすべて外す。
+    for (const sid of Array.from(session.streamIds || [])) {
+      if (this.sessions.get(sid) === session) this.sessions.delete(sid)
+    }
+    // 念のため primary stream_id も (streamIds に無い経路があった場合の保険)。
+    if (this.sessions.get(session.stream_id) === session) {
+      this.sessions.delete(session.stream_id)
+    }
+    if (session.sessionId && this._liveBySession.get(session.sessionId) === session) {
+      this._liveBySession.delete(session.sessionId)
+    }
+  }
+
   /**
    * 新しい Claude セッションを開始する。
    *
@@ -814,7 +853,12 @@ export class ClaudeStreamBridge extends EventEmitter {
     if (resumeSessionId) {
       const live = this._liveBySession.get(resumeSessionId)
       if (live && !live._closed) {
-        this.sessions.delete(live.stream_id)
+        // 多端末共有 (CHAT_SHARED_ENABLED): 旧 stream_id を Map から消さない。同一セッションを
+        // 複数端末が購読する状態を作り、どの端末の input/permission/interrupt も解決できるように
+        // する。無効時は従来どおり旧 stream_id を撤去し「最後の 1 端末だけ live」に戻す。
+        if (!CHAT_SHARED_ENABLED) {
+          this.sessions.delete(live.stream_id)
+        }
         // 改修5: 再アタッチ時に model/permission/maxThinkingTokens を引き継ぎ反映する。
         // browser はバッジ変更時に新しい値を載せた claude.attach を同一 resume で送る
         // ため、ここで適用すると常駐 query を維持したまま次ターンから切り替わる。
@@ -858,24 +902,27 @@ export class ClaudeStreamBridge extends EventEmitter {
         if (session.sessionId) this._liveBySession.set(session.sessionId, session)
       },
       onPermission: ({ tool_name, input, request_id }) => {
+        // 多端末共有: session_id を載せて backend が session group へ broadcast できるように
+        // する (全端末に許可ダイアログを出し、先着 1 件の reply を採用する)。
         this.emit("permission", {
           stream_id: session.stream_id,
+          session_id: session.sessionId,
           request_id,
           tool_name,
           input,
         })
       },
       onError: (err) => {
-        this.emit("error", { stream_id: session.stream_id, error: err?.message || String(err) })
+        this.emit("error", {
+          stream_id: session.stream_id,
+          session_id: session.sessionId,
+          error: err?.message || String(err),
+        })
       },
       onReap: () => {
         // ターン完走後の遅延クローズ。Map / 索引から撤去し exit を emit する。
-        if (this.sessions.get(session.stream_id) === session) {
-          this.sessions.delete(session.stream_id)
-        }
-        if (session.sessionId && this._liveBySession.get(session.sessionId) === session) {
-          this._liveBySession.delete(session.sessionId)
-        }
+        // 多端末共有では複数端末キーが Map に載っているのでまとめて外す。
+        this._dropSessionMappings(session)
         this.emit("exit", {
           stream_id: session.stream_id,
           code: 0,
@@ -941,14 +988,25 @@ export class ClaudeStreamBridge extends EventEmitter {
   detach({ stream_id }) {
     const s = this.sessions.get(stream_id)
     if (!s) return false
+    // 多端末共有: この端末分の購読だけ外す。まだ他端末が見ているならセッションは生かし、
+    // softDetach (idle 撤去タイマー) には入らない。最後の 1 台が外れたときだけ従来の
+    // idle softDetach に進む。無効時は streamIds が常に 1 要素なので即 softDetach に落ちる。
+    if (CHAT_SHARED_ENABLED) {
+      s.streamIds.delete(stream_id)
+      if (this.sessions.get(stream_id) === s) this.sessions.delete(stream_id)
+      if (s.streamIds.size > 0) {
+        // primary を生存端末へ寄せ替え (legacy emit / softDetach 撤去ログ用)。
+        if (s.stream_id === stream_id) {
+          s.stream_id = Array.from(s.streamIds)[s.streamIds.size - 1]
+        }
+        return true
+      }
+    }
     // 常駐化: browser 切断ではセッションを止めない (reap しない)。走行中ターンは完走し、
     // idle のまま IDLE_DETACH_TTL_MS 経過して初めて撤去する。TTL 内に再接続 (再アタッチ)
     // されればキャンセルされる。明示的に止めたい場合は interrupt()/明示終了を使う。
     s.softDetach(IDLE_DETACH_TTL_MS, () => {
-      if (this.sessions.get(s.stream_id) === s) this.sessions.delete(s.stream_id)
-      if (s.sessionId && this._liveBySession.get(s.sessionId) === s) {
-        this._liveBySession.delete(s.sessionId)
-      }
+      this._dropSessionMappings(s)
       s.close()
       this.emit("exit", {
         stream_id: s.stream_id,

package/src/main.mjs

@@ -190,10 +190,13 @@ export async function startDaemon({ version, ptyModule, claudeSdk } = {}) {
       }
       client.send({ type: "claude.event", stream_id, session_id, event })
     })
-    claudeBridge.on("permission", ({ stream_id, request_id, tool_name, input }) => {
+    claudeBridge.on("permission", ({ stream_id, session_id, request_id, tool_name, input }) => {
+      // 多端末共有: session_id を載せて backend が session group へ broadcast できるように
+      // する (全端末に許可ダイアログ → 先着 1 件採用)。
       client.send({
         type: "claude.permission.request",
         stream_id,
+        session_id,
         request_id,
         tool_name,
         input,
@@ -202,8 +205,8 @@ export async function startDaemon({ version, ptyModule, claudeSdk } = {}) {
     claudeBridge.on("exit", ({ stream_id, code, reason, session_id }) => {
       client.send({ type: "claude.exit", stream_id, code, reason, session_id })
     })
-    claudeBridge.on("error", ({ stream_id, error }) => {
-      client.send({ type: "claude.error", stream_id, error })
+    claudeBridge.on("error", ({ stream_id, session_id, error }) => {
+      client.send({ type: "claude.error", stream_id, session_id, error })
     })
   }
 

package/src/service-install.mjs

@@ -15,6 +15,8 @@ import path from "node:path"
 import { spawnSync } from "node:child_process"
 import { fileURLToPath } from "node:url"
 
+import { readConfig } from "./config.mjs"
+
 const PLIST_LABEL = "co.cocorograph.hub-agent"
 const SYSTEMD_UNIT_NAME = "hub-agent.service"
 
@@ -50,7 +52,7 @@ function escapeXmlText(s) {
     .replaceAll(">", ">")
 }
 
-function expandTemplate(text, hubAgentBin) {
+function expandTemplate(text, hubAgentBin, opts = {}) {
   // hub-agent デーモンの runtime 環境に必須な追加 env を、各プラットフォームの
   // 起動ファイル形式 (plist / systemd) に合わせて差し込むためのプレースホルダ展開。
   //
@@ -72,12 +74,43 @@ function expandTemplate(text, hubAgentBin) {
     // systemd 側: Environment=KEY=VALUE の 1 行。末尾 \n でテンプレ "__...__\n" を吸収。
     systemdLine = `Environment=NODE_EXTRA_CA_CERTS=${nodeExtraCa}\n`
   }
+
+  // 多端末共有チャット (HUB_AGENT_CHAT_SHARED)。NODE_EXTRA_CA_CERTS と同じ仕組みで
+  // plist / systemd の EnvironmentVariables に焼き込む。値ソースは (a) installService
+  // が agent.json.chat_shared を読んで渡す opts.chatShared、または (b) install-service
+  // 実行時の process.env.HUB_AGENT_CHAT_SHARED。これにより agent 更新で install-service
+  // が plist を再生成しても、agent.json に chat_shared=true があればフラグが維持される
+  // (旧実装は手動 plist 追記が再生成で消える事故があった。2026-05-30)。
+  const chatShared =
+    opts.chatShared === true || process.env.HUB_AGENT_CHAT_SHARED === "1"
+  let chatPlistEntry = ""
+  let chatSystemdLine = ""
+  if (chatShared) {
+    chatPlistEntry =
+      `    <key>HUB_AGENT_CHAT_SHARED</key>\n` +
+      `    <string>1</string>\n`
+    chatSystemdLine = `Environment=HUB_AGENT_CHAT_SHARED=1\n`
+  }
+
   return text
     .replaceAll("__HUB_AGENT_BIN__", hubAgentBin)
     .replaceAll("__HOME__", os.homedir())
     .replaceAll("__PATH__", process.env.PATH || "/usr/local/bin:/usr/bin:/bin")
     .replaceAll("__NODE_EXTRA_CA_CERTS_PLIST_ENTRY__", plistEntry)
     .replaceAll("__NODE_EXTRA_CA_CERTS_SYSTEMD_LINE__", systemdLine)
+    .replaceAll("__HUB_AGENT_CHAT_SHARED_PLIST_ENTRY__", chatPlistEntry)
+    .replaceAll("__HUB_AGENT_CHAT_SHARED_SYSTEMD_LINE__", chatSystemdLine)
+}
+
+/** agent.json から多端末共有フラグ (chat_shared) を読む。読めなければ false。
+ *  install-service 時に plist/systemd へ焼き込む値ソースに使う (env 併用は expandTemplate 側)。 */
+async function readChatSharedFromConfig() {
+  try {
+    const config = await readConfig()
+    return config?.chat_shared === true
+  } catch {
+    return false
+  }
 }
 
 async function ensureDir(p) {
@@ -156,9 +189,12 @@ export async function installService({ bin } = {}) {
   const hubAgentBin = bin || detectHubAgentBin()
   await ensureLogFile()
 
+  // agent.json の永続フラグを読み、テンプレ展開に渡す (再生成でも維持されるように)。
+  const chatShared = await readChatSharedFromConfig()
+
   if (process.platform === "darwin") {
     const tpl = await readTemplate("co.cocorograph.hub-agent.plist")
-    const expanded = expandTemplate(tpl, hubAgentBin)
+    const expanded = expandTemplate(tpl, hubAgentBin, { chatShared })
     const dest = macPlistPath()
     await ensureDir(path.dirname(dest))
     await fs.writeFile(dest, expanded, { mode: 0o644 })
@@ -173,7 +209,7 @@ export async function installService({ bin } = {}) {
 
   if (process.platform === "linux") {
     const tpl = await readTemplate("hub-agent.service")
-    const expanded = expandTemplate(tpl, hubAgentBin)
+    const expanded = expandTemplate(tpl, hubAgentBin, { chatShared })
     const dest = linuxUnitPath()
     await ensureDir(path.dirname(dest))
     await fs.writeFile(dest, expanded, { mode: 0o644 })

package/templates/co.cocorograph.hub-agent.plist

@@ -52,7 +52,7 @@
     <string>__PATH__</string>
     <key>HOME</key>
     <string>__HOME__</string>
-__NODE_EXTRA_CA_CERTS_PLIST_ENTRY__  </dict>
+__NODE_EXTRA_CA_CERTS_PLIST_ENTRY____HUB_AGENT_CHAT_SHARED_PLIST_ENTRY__  </dict>
 
   <!-- KeepAlive で過剰再起動した時に 10 秒スロットルする -->
   <key>ThrottleInterval</key>

package/templates/hub-agent.service

@@ -12,7 +12,7 @@ Type=simple
 # 行に、未 set なら空文字列に」展開する。
 Environment=PATH=__PATH__
 Environment=HOME=__HOME__
-__NODE_EXTRA_CA_CERTS_SYSTEMD_LINE__WorkingDirectory=__HOME__
+__NODE_EXTRA_CA_CERTS_SYSTEMD_LINE____HUB_AGENT_CHAT_SHARED_SYSTEMD_LINE__WorkingDirectory=__HOME__
 ExecStart=__HUB_AGENT_BIN__ start
 Restart=always
 RestartSec=10