@cocorograph/hub-agent 0.6.41 → 0.6.42

package/package.json

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

package/src/claude-stream-bridge.mjs

@@ -20,6 +20,9 @@
  */
 import { EventEmitter } from "node:events"
 import { randomUUID } from "node:crypto"
+import { readFileSync } from "node:fs"
+import os from "node:os"
+import path from "node:path"
 
 import { jsonlPath } from "./claude-history.mjs"
 import { watchSessionFile } from "./claude-history-watch.mjs"
@@ -65,6 +68,36 @@ const MCP_CONTROL_IDLE_MS = Number(
   process.env.HUB_AGENT_MCP_CONTROL_IDLE_MS || 5 * 60 * 1000,
 )
 
+/** claude が使う設定ディレクトリ (CLAUDE_CONFIG_DIR 優先、無ければ ~/.claude)。 */
+function claudeConfigDir() {
+  return process.env.CLAUDE_CONFIG_DIR || path.join(os.homedir(), ".claude")
+}
+
+/**
+ * claude の「要認証 (needs-auth)」キャッシュからサーバー名一覧を読む。
+ *
+ * `<configDir>/mcp-needs-auth-cache.json` は claude が「認証が必要」と判定した MCP
+ * サーバー (claude.ai リモートコネクター含む) を記録するファイルで、`{ "<server名>":
+ * { timestamp, id? }, ... }` 形式。**一度も接続したことがない** コネクターも含まれる。
+ *
+ * 長寿命プロセスの control query は claude のコネクター列挙キャッシュ挙動により、
+ * never-connected な claude.ai コネクターを `mcpServerStatus()` に列挙しそびれること
+ * があるため、このファイルを補完ソースに使う (mcpStatus でマージ)。
+ *
+ * @returns {string[]} 認証待ちサーバー名の配列 (読めない / 不正なら空配列)
+ */
+function readNeedsAuthCacheNames() {
+  try {
+    const p = path.join(claudeConfigDir(), "mcp-needs-auth-cache.json")
+    const obj = JSON.parse(readFileSync(p, "utf8"))
+    if (!obj || typeof obj !== "object") return []
+    return Object.keys(obj).filter((k) => typeof k === "string" && k.length > 0)
+  } catch {
+    // ファイル不在 / JSON 破損は無視 (補完なしで従来どおり動く)。
+    return []
+  }
+}
+
 /** 多端末共有セッション (2026-05-30)。同じ Claude セッション (session_id) を複数端末で
  *  同時に開いて、どの端末でもライブ表示・入力・許可応答できるようにする。env
  *  HUB_AGENT_CHAT_SHARED="1" で有効化 (デフォルト無効 = 従来の「最後の端末だけが live」)。
@@ -1061,13 +1094,15 @@ export class ClaudeStreamBridge extends EventEmitter {
    *   (テストでは `{ query: stubQuery }` を渡す)
    * @param {import('pino').Logger} [opts.logger]
    */
-  constructor({ sdk, logger } = {}) {
+  constructor({ sdk, logger, readNeedsAuthCacheNames: readNeedsAuth } = {}) {
     super()
     if (!sdk || typeof sdk.query !== "function") {
       throw new TypeError("ClaudeStreamBridge requires { sdk: { query } }")
     }
     this.sdk = sdk
     this.logger = logger
+    /** needs-auth キャッシュ名読み取り (テスト差し替え用。既定は実ファイル読み込み)。 */
+    this._readNeedsAuthCacheNames = readNeedsAuth || readNeedsAuthCacheNames
     /** @type {Map<string, ClaudeStreamSession>} */
     this.sessions = new Map()
     /** session_id → 生存セッション。再接続 (再アタッチ) で同一セッションを引く索引。
@@ -1377,7 +1412,49 @@ export class ClaudeStreamBridge extends EventEmitter {
     if (opts.reload) this._teardownMcpControlQuery()
     const q = await this._ensureMcpControlQuery()
     this._armMcpControlIdle()
-    return await q.mcpServerStatus()
+    const servers = await q.mcpServerStatus()
+    return this._mergeNeedsAuthCache(servers)
+  }
+
+  /**
+   * `mcpServerStatus()` の結果に、needs-auth キャッシュにあるが結果へ含まれない
+   * サーバーを `needs-auth` として補完する。
+   *
+   * 背景: 長寿命プロセスの control query は claude のコネクター列挙キャッシュ挙動に
+   * より、「一度も接続したことがない」claude.ai コネクターを `mcpServerStatus()` に
+   * 列挙しそびれることがある (新規プロセスでは列挙される)。その結果 Cockpit の一覧に
+   * 出ず、初回接続を別経路 (ターミナル / claude.ai) で済ませるまで再認証導線が出ない
+   * 問題があった。needs-auth キャッシュは never-connected も記録しているため、これを
+   * マージして「要再認証」で常に一覧へ出し、その場で再認証 → 接続できるようにする。
+   *
+   * @param {Array<{name?: string, status?: string}>} servers - SDK の状態一覧
+   * @returns {Array<{name: string, status: string}>} 補完後の一覧
+   */
+  _mergeNeedsAuthCache(servers) {
+    const list = Array.isArray(servers) ? servers.slice() : []
+    try {
+      const known = new Set(list.map((s) => s?.name).filter(Boolean))
+      let added = 0
+      for (const name of this._readNeedsAuthCacheNames()) {
+        if (!name || known.has(name)) continue
+        // SDK が列挙しなかった未接続コネクター。要再認証として補完する。
+        list.push({ name, status: "needs-auth" })
+        known.add(name)
+        added += 1
+      }
+      if (added > 0) {
+        this.logger?.info(
+          { added },
+          "mcp status: surfaced never-connected servers from needs-auth cache",
+        )
+      }
+    } catch (err) {
+      this.logger?.warn(
+        { err: err?.message },
+        "mcp needs-auth cache merge failed (ignored)",
+      )
+    }
+    return list
   }
 
   /** 指定 MCP サーバーを control 専用 query 内で再接続し、最新状態一覧を返す。 */
@@ -1385,7 +1462,8 @@ export class ClaudeStreamBridge extends EventEmitter {
     const q = await this._ensureMcpControlQuery()
     this._armMcpControlIdle()
     await q.reconnectMcpServer(serverName)
-    return await q.mcpServerStatus()
+    const servers = await q.mcpServerStatus()
+    return this._mergeNeedsAuthCache(servers)
   }
 
   /** 指定 MCP サーバーを「動作中の全 resident セッション」+ control query で再接続する。