@cocorograph/hub-agent 0.7.57 → 0.7.58

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/package.json +1 -1
  2. package/src/hub-bundle.mjs +26 -8
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@cocorograph/hub-agent",
3
- "version": "0.7.57",
3
+ "version": "0.7.58",
4
4
  "description": "Hub Hosted Cockpit のローカル常駐 agent。Hub と outbound WSS で接続し、ローカルの tmux/pty を中継する。",
5
5
  "type": "module",
6
6
  "license": "UNLICENSED",
@@ -300,6 +300,15 @@ function runOnce(argv, { logger } = {}) {
300
300
  * (Cockpit 用途では install.sh が事前に claude をインストールしている
301
301
  * 想定だが、独自運用環境への配慮で fail-soft にする)
302
302
  */
303
+ /**
304
+ * ホスト資格ヘッダ(`X-Cockpit-Agent`)を付与する Hub の MCP サーバー名。
305
+ *
306
+ * Hub backend の acting tenant はこのヘッダで**ホストのテナントに固定**される。両方に
307
+ * 付けるのが正(`hub` だけだと、社内が実際に使う `hub_staff` が固定されず、フロントの
308
+ * ワークスペース切替で実行中セッションがデータを読めなくなる)。
309
+ */
310
+ export const HUB_MCP_NAMES = new Set(["hub", "hub_staff"])
311
+
303
312
  export async function applyMcpServers(bundle, { agentId, agentToken, logger } = {}) {
304
313
  const servers = Array.isArray(bundle?.mcp_servers) ? bundle.mcp_servers : []
305
314
  if (servers.length === 0) return { added: [], skipped: [] }
@@ -321,12 +330,21 @@ export async function applyMcpServers(bundle, { agentId, agentToken, logger } =
321
330
  const transport = s.transport || "http"
322
331
  const scope = s.scope || "user"
323
332
 
324
- // 越境制御 (2026-07): 一般向け `hub` MCP には、このホストの資格
325
- // `X-Cockpit-Agent: <agentId>:<agentToken>` をヘッダで付与する。Hub backend は
326
- // これを検証してホストのテナントを解決し、`hub` の acting tenant をそのテナントに
327
- // **固定**する(クライアントホストは自テナントの外を触れない)。`hub_staff`(社内
328
- // 横断)や外部 MCP には付けない。
329
- const wantHeader = s.name === "hub" && agentId && agentToken
333
+ // 越境制御 (2026-07-14 訂正): **Hub の MCP(`hub` / `hub_staff`)の両方**に、この
334
+ // ホストの資格 `X-Cockpit-Agent: <agentId>:<agentToken>` をヘッダで付与する。Hub
335
+ // backend はこれを検証してホストのテナントを解決し、acting tenant をそのテナントに
336
+ // **固定**する(フロントエンドのワークスペース切替より優先。端末とワークスペースを
337
+ // 紐づけるのが設計意図)。外部 MCP には付けない。
338
+ //
339
+ // ⚠️ かつて `hub` にしか付けていなかったが、**設計意図が未達だった**。社内の横断作業は
340
+ // decision B により `hub_staff` を使うため、**実際に使う経路が固定されず**、フロントを
341
+ // 個人WSに切り替えると実行中の Cockpit セッションがココログラフのデータを読めなくなる
342
+ // 回帰が残っていた(本番実測 2026-07-14)。
343
+ //
344
+ // `hub_staff` を固定しても社内スタッフの横断は死なない: 提供元(ココログラフ)ホストは
345
+ // ココログラフテナントに固定され、backend の `is_unrestricted` はそこで真になるため
346
+ // (固定 ≠ 横断不可。固定されたテナントが提供元かどうかで決まる)。
347
+ const wantHeader = HUB_MCP_NAMES.has(s.name) && agentId && agentToken
330
348
 
331
349
  // ⚠️ 実 CLI で確認した 2 つの罠(claude-code、モックでは絶対に出ない):
332
350
  //
@@ -357,8 +375,8 @@ export async function applyMcpServers(bundle, { agentId, agentToken, logger } =
357
375
  await runOnce(argv, { logger })
358
376
  added.push(s.name)
359
377
  } catch (err) {
360
- // `hub_staff` 等(ヘッダ不要)は既存なら "already exists" で失敗する。これは
361
- // 「既に正しく登録済み」なので実害なし。ログだけ残して継続する。
378
+ // ヘッダ不要の外部 MCP は既存なら "already exists" で失敗する。これは「既に正しく
379
+ // 登録済み」なので実害なし。ログだけ残して継続する。
362
380
  logger?.warn({ name: s.name, err: err.message }, "claude mcp add failed")
363
381
  skipped.push(s.name)
364
382
  }