@cocorograph/hub-agent 0.6.36 → 0.6.38

package/package.json

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

package/src/claude-stream-bridge.mjs

@@ -55,6 +55,16 @@ const CHAT_RESIDENT_ENABLED = process.env.HUB_AGENT_CHAT_RESIDENT !== "0"
 const CHAT_RESIDENT_RESUME_ENABLED =
   process.env.HUB_AGENT_CHAT_RESIDENT_RESUME === "1"
 
+/** MCP control 専用 query のアイドル破棄時間 (2026-06-03)。MCP サーバーは Claude Code
+ *  設定 (アカウント単位) で全セッション共有のため、チャットセッションとは独立した
+ *  「control 専用 query」を 1 本だけ遅延起動して状態取得・再認証・再接続を行う。
+ *  ユーザーターンは一切送らない (resume なし・空 input のまま放置) ため、resume 経路の
+ *  自動継続バグ (上記 CHAT_RESIDENT_RESUME_ENABLED 参照) には触れない。最後のアクセスから
+ *  この時間が経過したら query を畳み、次回アクセスで再起動する。 */
+const MCP_CONTROL_IDLE_MS = Number(
+  process.env.HUB_AGENT_MCP_CONTROL_IDLE_MS || 5 * 60 * 1000,
+)
+
 /** 多端末共有セッション (2026-05-30)。同じ Claude セッション (session_id) を複数端末で
  *  同時に開いて、どの端末でもライブ表示・入力・許可応答できるようにする。env
  *  HUB_AGENT_CHAT_SHARED="1" で有効化 (デフォルト無効 = 従来の「最後の端末だけが live」)。
@@ -988,6 +998,17 @@ class ClaudeStreamSession {
     }
   }
 
+  /** このセッションの常駐 query 内で MCP サーバーを再接続する (動作中チャットへ波及)。
+   *  常駐 query が無い (per-message セッション) 場合は false。per-message は毎ターン
+   *  新プロセスで MCP を張り直すため、次メッセージで自動的に再接続される。
+   *  @returns {Promise<boolean>} 再接続を発行できたら true */
+  async reconnectMcp(serverName) {
+    const q = this._residentQuery
+    if (!q || typeof q.reconnectMcpServer !== "function") return false
+    await q.reconnectMcpServer(serverName)
+    return true
+  }
+
   /**
    * graceful detach: 実行中ターンがあれば中断せず完走を待つ (完走後に finally で
    * 自動クローズ + onReap)。アイドルなら即クローズする。
@@ -1052,6 +1073,15 @@ export class ClaudeStreamBridge extends EventEmitter {
     /** session_id → 生存セッション。再接続 (再アタッチ) で同一セッションを引く索引。
      *  browser が切れてもここに残し、走行中ターンの継続 + 再接続でのライブ追従を可能にする。 */
     this._liveBySession = new Map()
+
+    /** MCP control 専用 query (agent-global)。遅延起動・アイドル破棄。session 非依存。 */
+    this._mcpControlQuery = null
+    /** control query を生かし続ける never-ending input (close で query を畳む)。 */
+    this._mcpControlInput = null
+    /** アイドル破棄タイマー (unref 済み = プロセスを生かし続けない)。 */
+    this._mcpControlIdleTimer = null
+    /** 起動中の Promise (同時アクセスの二重起動防止)。 */
+    this._mcpControlStarting = null
   }
 
   /** 多端末共有: あるセッションに紐づく全端末 stream_id を sessions Map から外し、
@@ -1246,6 +1276,156 @@ export class ClaudeStreamBridge extends EventEmitter {
     return true
   }
 
+  // ============================================================
+  // MCP control (agent-global, session 非依存) — 2026-06-03
+  //
+  // MCP サーバーは Claude Code 設定 (アカウント単位) で全セッション共有。チャットの
+  // resident / per-message モードに依存せず MCP 状態取得・再認証・再接続を行うため、
+  // チャットセッションとは独立した「control 専用 query」を 1 本だけ遅延起動する。
+  // ユーザーターンは一切送らない (resume なし・空 input) ため、init を抜けた後は
+  // control channel (mcpServerStatus 等) のみを叩く。実機検証済み: 空 input の
+  // control-only query でも mcpServerStatus() が 17 件返ることを確認 (probe 2026-06-03)。
+  // ============================================================
+
+  /** control 専用 query を遅延起動し、起動済みハンドルを返す。二重起動は Promise で防ぐ。 */
+  async _ensureMcpControlQuery() {
+    if (this._mcpControlQuery) {
+      this._armMcpControlIdle()
+      return this._mcpControlQuery
+    }
+    if (this._mcpControlStarting) return this._mcpControlStarting
+    this._mcpControlStarting = (async () => {
+      // never-ending input: close() するまで終わらない (= query を生かし続ける)。
+      // resume を付けないので「空 input + resume」の自動継続バグ窓には入らない。
+      const input = new InputQueue()
+      const q = this.sdk.query({ prompt: input, options: {} })
+      // メッセージストリームを背景で drain する (control 専用なので捨てる)。
+      // control メソッド (mcpServerStatus 等) は別チャネル経由なので drain と独立に動く。
+      ;(async () => {
+        try {
+          for await (const _msg of q) {
+            void _msg
+          }
+        } catch (err) {
+          this.logger?.warn(
+            { err: err?.message },
+            "mcp control query stream ended",
+          )
+        } finally {
+          if (this._mcpControlQuery === q) {
+            this._mcpControlQuery = null
+            this._mcpControlInput = null
+          }
+        }
+      })()
+      this._mcpControlQuery = q
+      this._mcpControlInput = input
+      return q
+    })()
+    try {
+      return await this._mcpControlStarting
+    } finally {
+      this._mcpControlStarting = null
+      this._armMcpControlIdle()
+    }
+  }
+
+  /** アイドル破棄タイマーを張り直す。アクセスのたびに呼ぶ。 */
+  _armMcpControlIdle() {
+    if (this._mcpControlIdleTimer) clearTimeout(this._mcpControlIdleTimer)
+    this._mcpControlIdleTimer = setTimeout(() => {
+      this._teardownMcpControlQuery()
+    }, MCP_CONTROL_IDLE_MS)
+    // プロセスを生かし続けないよう unref (hub-agent の silent-exit 設計と整合)。
+    if (typeof this._mcpControlIdleTimer.unref === "function") {
+      this._mcpControlIdleTimer.unref()
+    }
+  }
+
+  /** control 専用 query を畳む (アイドル / shutdown)。 */
+  _teardownMcpControlQuery() {
+    if (this._mcpControlIdleTimer) {
+      clearTimeout(this._mcpControlIdleTimer)
+      this._mcpControlIdleTimer = null
+    }
+    const input = this._mcpControlInput
+    const q = this._mcpControlQuery
+    this._mcpControlInput = null
+    this._mcpControlQuery = null
+    try {
+      input?.close()
+    } catch {
+      /* ignore */
+    }
+    try {
+      q?.interrupt?.()
+    } catch {
+      /* ignore */
+    }
+  }
+
+  /** 接続中 MCP サーバーの状態一覧を返す (McpServerStatus[])。 */
+  async mcpStatus() {
+    const q = await this._ensureMcpControlQuery()
+    this._armMcpControlIdle()
+    return await q.mcpServerStatus()
+  }
+
+  /** 指定 MCP サーバーを control 専用 query 内で再接続し、最新状態一覧を返す。 */
+  async reconnectMcp(serverName) {
+    const q = await this._ensureMcpControlQuery()
+    this._armMcpControlIdle()
+    await q.reconnectMcpServer(serverName)
+    return await q.mcpServerStatus()
+  }
+
+  /** 指定 MCP サーバーを「動作中の全 resident セッション」+ control query で再接続する。
+   *  MCP 接続はプロセス単位のため、control query だけ張り直しても動作中チャットには
+   *  波及しない。そこで全 resident セッションの常駐 query にも reconnect を発行し、
+   *  会話中の MCP 接続を実際に張り直す。reconnect は冪等なので多重発行は無害。
+   *  @returns {Promise<{servers: object[], targeted: number}>}
+   *    servers: control query の最新状態 (popover 表示用) / targeted: 波及したセッション数 */
+  async reconnectMcpAllSessions(serverName) {
+    const seen = new Set()
+    let targeted = 0
+    for (const session of this.sessions.values()) {
+      if (seen.has(session)) continue
+      seen.add(session)
+      try {
+        if (await session.reconnectMcp(serverName)) targeted += 1
+      } catch (err) {
+        this.logger?.warn(
+          { err: err?.message, server: serverName },
+          "session mcp reconnect failed",
+        )
+      }
+    }
+    // control query も張り直して popover 表示用の最新状態を返す。
+    const servers = await this.reconnectMcp(serverName)
+    return { servers, targeted }
+  }
+
+  /** 指定 MCP サーバーの OAuth 認証を開始する。認可 URL を含む応答を返す。 */
+  async mcpAuthenticate(serverName, redirectUri) {
+    const q = await this._ensureMcpControlQuery()
+    this._armMcpControlIdle()
+    return await q.mcpAuthenticate(serverName, redirectUri)
+  }
+
+  /** ブラウザ認証後のコールバック URL を投入して OAuth を完了する。 */
+  async mcpSubmitOAuthCallback(serverName, callbackUrl) {
+    const q = await this._ensureMcpControlQuery()
+    this._armMcpControlIdle()
+    return await q.mcpSubmitOAuthCallbackUrl(serverName, callbackUrl)
+  }
+
+  /** 指定 MCP サーバーの保存済み認証情報を破棄する (期限切れトークンの掃除)。 */
+  async mcpClearAuth(serverName) {
+    const q = await this._ensureMcpControlQuery()
+    this._armMcpControlIdle()
+    return await q.mcpClearAuth(serverName)
+  }
+
   /** キャンセル機能 (0.6.26): browser → 送信待ち (pending) メッセージを id 指定で取り消す。
    *  実行中ターンには影響しない (中断は interrupt を使う)。 */
   cancelQueued({ stream_id, id }) {
@@ -1348,6 +1528,8 @@ export class ClaudeStreamBridge extends EventEmitter {
     }
     // 常駐化: 再アタッチ索引も全消去 (プロセス終了時の後始末)。
     this._liveBySession.clear()
+    // MCP control 専用 query も畳む。
+    this._teardownMcpControlQuery()
   }
 
   /** 現在 attach 中の stream_id 一覧 (debug 用)。 */

package/src/main.mjs

@@ -965,6 +965,89 @@ async function dispatch(msg, ctx) {
         if (!ctx.claudeBridge) return
         ctx.claudeBridge.interrupt({ stream_id: msg.stream_id })
         return
+      case "claude.mcp.status":
+      case "claude.mcp.reconnect":
+      case "claude.mcp.authenticate":
+      case "claude.mcp.callback":
+      case "claude.mcp.clearauth": {
+        // MCP control (agent-global, session 非依存) — 2026-06-03。
+        // MCP サーバーは Claude Code 設定 (アカウント単位) で全セッション共有のため、
+        // チャットの resident/per-message モードに依存しない control 専用 query で扱う。
+        // request_id で相関 (profile.list と同方式)。失敗しても agent は落とさない。
+        const request_id = msg.request_id
+        if (!ctx.claudeBridge) {
+          ctx.client.send({
+            type: "claude.mcp.response",
+            request_id,
+            action: msg.type,
+            error: "stream_mode_unavailable",
+          })
+          return
+        }
+        try {
+          let result
+          switch (msg.type) {
+            case "claude.mcp.status":
+              result = { servers: await ctx.claudeBridge.mcpStatus() }
+              break
+            case "claude.mcp.reconnect": {
+              // 動作中の全 resident セッション + control query を再接続 (会話中の MCP に波及)。
+              const r = await ctx.claudeBridge.reconnectMcpAllSessions(
+                msg.server_name,
+              )
+              result = { servers: r.servers, targeted: r.targeted }
+              break
+            }
+            case "claude.mcp.authenticate":
+              result = {
+                auth: await ctx.claudeBridge.mcpAuthenticate(
+                  msg.server_name,
+                  msg.redirect_uri,
+                ),
+              }
+              break
+            case "claude.mcp.callback": {
+              const auth = await ctx.claudeBridge.mcpSubmitOAuthCallback(
+                msg.server_name,
+                msg.callback_url,
+              )
+              // 再認証で得たトークンはディスクに永続するが、動作中セッションは別プロセス
+              // のため自動では拾わない。全 resident セッション + control query を再接続し、
+              // 会話中もすぐ新トークンで使えるようにする。
+              const r = await ctx.claudeBridge.reconnectMcpAllSessions(
+                msg.server_name,
+              )
+              result = { auth, servers: r.servers, targeted: r.targeted }
+              break
+            }
+            case "claude.mcp.clearauth":
+              result = {
+                cleared: await ctx.claudeBridge.mcpClearAuth(msg.server_name),
+              }
+              break
+          }
+          ctx.client.send({
+            type: "claude.mcp.response",
+            request_id,
+            action: msg.type,
+            server_name: msg.server_name,
+            ...result,
+          })
+        } catch (err) {
+          ctx.logger?.warn(
+            { err: err?.message, action: msg.type, server: msg.server_name },
+            "claude.mcp control request failed",
+          )
+          ctx.client.send({
+            type: "claude.mcp.response",
+            request_id,
+            action: msg.type,
+            server_name: msg.server_name,
+            error: err?.message || "mcp_control_failed",
+          })
+        }
+        return
+      }
       case "claude.queue.cancel":
         // 送信待ち (pending) メッセージを id 指定で取り消す (0.6.26)。
         if (!ctx.claudeBridge) return