@cocorograph/hub-agent 0.6.35 → 0.6.37

package/package.json

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

package/src/claude-history.mjs

@@ -38,6 +38,11 @@ export function normalizeHistoryEvent(obj) {
   if (obj.message !== undefined) event.message = obj.message
   if (obj.subtype !== undefined) event.subtype = obj.subtype
   if (obj.uuid !== undefined) event.uuid = obj.uuid
+  // jsonl 各行の ISO8601 タイムスタンプ。Browser 側でバブル上の時刻表示・日付区切りに
+  // 使う。履歴 hydrate と live watch の両経路がこの関数を通るため、ここ 1 箇所で拾えば
+  // 両方に時刻が乗る (純粋なライブ SDK stream には timestamp が無く、Browser が受信時刻で
+  // 補完する)。
+  if (obj.timestamp !== undefined) event.timestamp = obj.timestamp
   if (obj.session_id !== undefined) event.session_id = obj.session_id
   else if (obj.sessionId !== undefined) event.session_id = obj.sessionId
   if (obj.model !== undefined) event.model = obj.model

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」)。
@@ -1052,6 +1062,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 +1265,130 @@ 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 サーバーを再接続し、最新状態一覧を返す。 */
+  async reconnectMcp(serverName) {
+    const q = await this._ensureMcpControlQuery()
+    this._armMcpControlIdle()
+    await q.reconnectMcpServer(serverName)
+    return await q.mcpServerStatus()
+  }
+
+  /** 指定 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 +1491,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,80 @@ 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":
+              result = {
+                servers: await ctx.claudeBridge.reconnectMcp(msg.server_name),
+              }
+              break
+            case "claude.mcp.authenticate":
+              result = {
+                auth: await ctx.claudeBridge.mcpAuthenticate(
+                  msg.server_name,
+                  msg.redirect_uri,
+                ),
+              }
+              break
+            case "claude.mcp.callback":
+              result = {
+                auth: await ctx.claudeBridge.mcpSubmitOAuthCallback(
+                  msg.server_name,
+                  msg.callback_url,
+                ),
+              }
+              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