@cocorograph/hub-agent 0.8.113 → 0.8.115

package/src/hub-bundle.mjs

@@ -21,6 +21,8 @@ import path from "node:path"
 import os from "node:os"
 import { spawn } from "node:child_process"
 import { randomBytes, createHash } from "node:crypto"
+import { isDeepStrictEqual } from "node:util"
+import { parse } from "smol-toml"
 import { resolveCodexBinary } from "./codex-binary.mjs"
 
 const HUB_AI_RULES_BEGIN = "<!-- BEGIN HUB-AI-RULES -->"
@@ -650,11 +652,48 @@ export async function applyCodexMcpServers(
   return { added, skipped, approvalUpdated, approvalPending, approvalSkipped, approvalError }
 }
 
+/** Grok は X-Cockpit-Agent で接続するため、非対話でも Hub MCP を新規登録できる。 */
+export async function applyGrokMcpServers(
+  bundle,
+  { agentId, agentToken, logger, configPath, fsImpl = fs } = {},
+) {
+  const servers = (Array.isArray(bundle?.mcp_servers) ? bundle.mcp_servers : [])
+    .filter((s) => HUB_MCP_NAMES.has(s?.name) && s?.url)
+  if (servers.length === 0) return { updated: [], skipped: [], pending: [] }
+  const cfgPath = configPath || resolveGrokConfigPath()
+  // I/O 例外にも資格情報が含まれ得るので、Grok 経路では生の例外をログへ渡さない。
+  const safeLogger = {
+    info: (data) => logger?.info?.(data, "grok MCP config sync"),
+    warn: (data, message) => logger?.warn?.({ name: data?.name },
+      message === "TOML の解析に失敗した" ? message : "grok MCP config sync skipped or failed"),
+  }
+  try {
+    try {
+      await fsImpl.stat(path.dirname(cfgPath))
+    } catch (err) {
+      if (err.code !== "ENOENT") throw err
+      return { updated: [], skipped: servers.map((s) => s.name), pending: [], grokMissing: true }
+    }
+    return await applyCodexMcpApprovalModes(servers, {
+      agentId, agentToken, logger: safeLogger, configPath: cfgPath, fsImpl,
+      onlyExisting: false, headersKey: "headers", writeApprovalMode: false,
+      secretFileMode: 0o600,
+    })
+  } catch {
+    throw new Error("Grok MCP config sync failed")
+  }
+}
+
 // Codex の MCP サーバーごと承認モードとして `~/.codex/config.toml` へ書いてよい許可値
 // （Codex 公式値: auto / prompt / writes / approve）。Bundle backend でロール判定後に
 // フィルタ済みだが、hub-agent 側でも defense-in-depth で検証し、不正値は端末設定へ流さない。
 const _CODEX_MCP_APPROVAL_MODES = new Set(["auto", "prompt", "writes", "approve"])
 
+// Grok 本体と同じ GROK_HOME / ~/.grok を使う。
+function resolveGrokConfigPath() {
+  return path.join(process.env.GROK_HOME || path.join(os.homedir(), ".grok"), "config.toml")
+}
+
 /**
  * `~/.codex/config.toml` の絶対パスを解決する。`codex mcp add` が書く実ファイルと一致
  * させるため、codex 本体と同じく `CODEX_HOME` を最優先で見る。次に hub-agent の
@@ -682,7 +721,7 @@ function resolveCodexConfigPath() {
  *  - 不正な approvalMode は無視（url のみ・または no-op）。改行コード（LF/CRLF）は維持する。
  *
  * @param {string} configText
- * @param {{name: string, url?: string, approvalMode?: string, hostCredential?: string, onlyExisting?: boolean}} opts
+ * @param {{name: string, url?: string, approvalMode?: string, hostCredential?: string, onlyExisting?: boolean, headersKey?: string}} opts
  *   onlyExisting=true のとき、標準テーブルが**まだ無い** server には新規テーブルを追記しない
  *   （config を無変更で返す）。自動同期（非対話）で使う: 未登録 MCP に承認モードだけ書くと
  *   OAuth 未認証の「半登録テーブル」を作ってしまうため、登録は対話経路（`codex mcp add`）に
@@ -691,14 +730,15 @@ function resolveCodexConfigPath() {
  */
 export function upsertCodexMcpApprovalMode(
   configText,
-  { name, url, approvalMode, hostCredential, onlyExisting = false } = {},
+  { name, url, approvalMode, hostCredential, onlyExisting = false, headersKey = "http_headers" } = {},
 ) {
   if (!name) return configText
+  if (hostCredential && _codexHeadersAlternativelyDefined(configText, name, headersKey)) return configText
   const mode = _CODEX_MCP_APPROVAL_MODES.has(approvalMode) ? approvalMode : null
   const kv = []
   if (typeof url === "string" && url) kv.push(["url", JSON.stringify(url)])
   if (typeof hostCredential === "string" && hostCredential) {
-    kv.push(["http_headers", `{ "X-Cockpit-Agent" = ${JSON.stringify(hostCredential)} }`])
+    kv.push([headersKey, `{ "X-Cockpit-Agent" = ${JSON.stringify(hostCredential)} }`])
   }
   if (mode) kv.push(["default_tools_approval_mode", JSON.stringify(mode)])
   if (kv.length === 0) return configText
@@ -755,13 +795,13 @@ export function upsertCodexMcpApprovalMode(
       }
     }
     if (found >= 0) {
-      if (key === "http_headers") {
+      if (key === headersKey) {
         // `http_headers` はユーザーが別のヘッダを持ち得る。行全体を置換せず、管理対象の
         // X-Cockpit-Agent だけを inline table へマージする。安全に解釈できない形式なら
         // config 全体を無変更で返し、呼び出し側の検証で skipped 扱いにする。
         const merged = _upsertTomlInlineStringMapValue(
           lines[found],
-          "http_headers",
+          headersKey,
           "X-Cockpit-Agent",
           JSON.stringify(hostCredential),
         )
@@ -795,7 +835,9 @@ export function upsertCodexMcpApprovalMode(
  *    残さない）。rename が失敗した場合は破壊的フォールバックを行わず中止し、既存 config を無変更で維持する。
  *
  * @param {Array<{name?: string, url?: string, default_tools_approval_mode?: string}>} servers
- * @param {{configPath?: string, logger?: any, fsImpl?: any, isWindows?: boolean, onlyExisting?: boolean, agentId?: string, agentToken?: string}} [opts]
+ * @param {{configPath?: string, logger?: any, fsImpl?: any, isWindows?: boolean, onlyExisting?: boolean, agentId?: string, agentToken?: string, headersKey?: string, writeApprovalMode?: boolean, secretFileMode?: number}} [opts]
+ *   secretFileMode 指定時は、hostCredential を含む書き込みの作成・置換権限を固定する。
+ *   未指定時は既存権限を維持する。権限設定失敗時は原本を変更しない。
  *   configPath 省略時は resolveCodexConfigPath()。fsImpl / isWindows はテスト用の注入点（既定は実 fs / 実 OS）。
  *   onlyExisting=true（自動同期・非対話）のとき、標準テーブルが**まだ無い** server には新規
  *   テーブルを追記せず `pending` として報告する（未登録 MCP に承認モードだけ書いて OAuth 未認証の
@@ -813,13 +855,16 @@ export async function applyCodexMcpApprovalModes(
     onlyExisting = false,
     agentId,
     agentToken,
+    headersKey = "http_headers",
+    writeApprovalMode = true,
+    secretFileMode,
   } = {},
 ) {
   const hostCredential = agentId && agentToken ? `${agentId}:${agentToken}` : null
   const targets = (Array.isArray(servers) ? servers : []).filter(
     (s) =>
       s?.name &&
-      (_CODEX_MCP_APPROVAL_MODES.has(s?.default_tools_approval_mode) ||
+      ((!writeApprovalMode && s.url) || _CODEX_MCP_APPROVAL_MODES.has(s?.default_tools_approval_mode) ||
         (hostCredential && HUB_MCP_NAMES.has(s.name))),
   )
   if (targets.length === 0) return { updated: [], skipped: [], pending: [] }
@@ -838,17 +883,28 @@ export async function applyCodexMcpApprovalModes(
     text = "" // 新規環境: 空から始める（mode は 0o600 のまま）
   }
 
+  let document
+  try {
+    document = parse(text)
+  } catch {
+    // 解析器の例外は文書断片（資格情報）を含み得る。外へ渡さない。
+    for (const s of targets) logger?.warn?.({ name: s.name }, "TOML の解析に失敗した")
+    return { updated: [], skipped: targets.map((s) => s.name), pending: [] }
+  }
+
   let next = text
   const updated = []
   const skipped = []
   const pending = []
   for (const s of targets) {
+    const approvalMode = writeApprovalMode ? s.default_tools_approval_mode : undefined
     const serverHostCredential = hostCredential && HUB_MCP_NAMES.has(s.name) ? hostCredential : null
     // 自動同期（onlyExisting）で標準テーブルが無い server は、新規テーブルを作らない。
     // 非標準形（空白入り/ドット記法/インライン）で既に定義されていれば「安全に編集できない」
     // → skipped、真に未登録なら「登録が必要」→ pending として区別する（ブラウザは開かない）。
     if (onlyExisting && !_codexStandardTableExists(next, s.name)) {
-      if (_codexServerAlreadyDefined(next, s.name)) {
+      if (_codexServerAlreadyDefined(next, s.name) ||
+          (serverHostCredential && _codexHeadersAlternativelyDefined(next, s.name, headersKey))) {
         logger?.warn(
           { name: s.name },
           "codex config.toml の該当テーブルが非標準形のため自動同期では編集できずスキップ（既存 config は不変）",
@@ -866,14 +922,30 @@ export async function applyCodexMcpApprovalModes(
     const candidate = upsertCodexMcpApprovalMode(next, {
       name: s.name,
       url: s.url,
-      approvalMode: s.default_tools_approval_mode,
+      approvalMode,
+      headersKey,
       hostCredential: serverHostCredential,
       onlyExisting,
     })
+    let candidateDocument
+    try {
+      candidateDocument = parse(candidate)
+    } catch {
+      logger?.warn?.({ name: s.name }, "TOML の解析に失敗した")
+      skipped.push(s.name)
+      continue
+    }
+    if (!_verifyParsedMcpCandidate(document, candidateDocument, {
+      name: s.name, url: s.url, approvalMode, hostCredential: serverHostCredential, headersKey,
+    })) {
+      logger?.warn?.({ name: s.name }, "MCP 設定の解析結果が期待値と一致しないためスキップ")
+      skipped.push(s.name)
+      continue
+    }
     if (candidate === next) {
       // 変化なし。原因が「既に正しく反映済み（＝ no-op）」か「非標準形で upsert が編集を拒否した」
       // かを検証で区別する。標準テーブルが健全なら no-op、そうでなければ適用不能としてスキップ報告。
-      if (!_verifyCodexServerTable(next, s.name, s.default_tools_approval_mode, serverHostCredential)) {
+      if (!_verifyCodexServerTable(next, s.name, approvalMode, serverHostCredential, headersKey)) {
         logger?.warn(
           { name: s.name },
           "codex config.toml の該当テーブルを安全に編集できないためスキップ（既存 config は不変）",
@@ -886,7 +958,7 @@ export async function applyCodexMcpApprovalModes(
     // 期待値でちょうど 1 つ・url は高々 1 つ・他形式（空白入り/インライン）の重複定義が無い」
     // ことを検証する。素の文字列編集が非標準 config で誤動作しても、ここで弾いて **既存 config を
     // 一切書き換えない**（worst case = 承認設定が付かない＝現状維持）。
-    if (!_verifyCodexServerTable(candidate, s.name, s.default_tools_approval_mode, serverHostCredential)) {
+    if (!_verifyCodexServerTable(candidate, s.name, approvalMode, serverHostCredential, headersKey)) {
       logger?.warn(
         { name: s.name },
         "codex config.toml の該当テーブルを安全に編集できないためスキップ（既存 config は不変）",
@@ -895,23 +967,60 @@ export async function applyCodexMcpApprovalModes(
       continue
     }
     next = candidate
+    document = candidateDocument
     updated.push(s.name)
   }
-  if (next === text) return { updated: [], skipped, pending } // 冪等 no-op / 全スキップ
-
+  // 資格情報を含む書き込みでは、指定された権限を作成時から置換完了まで維持する。
+  const protectSecret = secretFileMode !== undefined && hostCredential && next.includes(JSON.stringify(hostCredential))
+  if (next === text) {
+    // 内容が一致していても旧版が残した緩い権限は修正する。失敗は呼び出し側へ伝える。
+    if (protectSecret && fileMode !== secretFileMode) await fsImpl.chmod(cfgPath, secretFileMode)
+    return { updated: [], skipped, pending } // updated は内容を変更した server のみ
+  }
+  if (protectSecret) fileMode = secretFileMode
   // ⚠️ 失敗しても既存 config.toml を必ず維持する fail-safe な atomic write。
-  await _atomicWriteFilePreserving(cfgPath, next, fileMode, { fsImpl, isWindows, logger })
+  await _atomicWriteFilePreserving(cfgPath, next, fileMode, {
+    fsImpl, isWindows, logger,
+    creationMode: protectSecret ? secretFileMode : 0o600,
+    requireMode: Boolean(protectSecret),
+  })
   logger?.info({ updated, skipped, pending }, "codex MCP 設定を config.toml へ反映")
   return { updated, skipped, pending }
 }
 
+/** 編集結果の意味を検証する。対象外の設定と既存の他ヘッダーは保存する。 */
+function _verifyParsedMcpCandidate(before, after, { name, url, approvalMode, hostCredential, headersKey }) {
+  const server = after.mcp_servers?.[name]
+  if (!server || typeof server !== "object" || Array.isArray(server)) return false
+  if (typeof url === "string" && url && server.url !== url) return false
+  if (_CODEX_MCP_APPROVAL_MODES.has(approvalMode) && server.default_tools_approval_mode !== approvalMode) return false
+  const without = (object, key) => Object.fromEntries(Object.entries(object ?? {}).filter(([k]) => k !== key))
+  if (hostCredential) {
+    if (server[headersKey]?.["X-Cockpit-Agent"] !== hostCredential) return false
+    if (!isDeepStrictEqual(
+      without(before.mcp_servers?.[name]?.[headersKey], "X-Cockpit-Agent"),
+      without(server[headersKey], "X-Cockpit-Agent"),
+    )) return false
+  }
+  // 対象 server の中でも、管理するキー（url・承認モード・資格ヘッダーのテーブル）以外は変わってはいけない。
+  // 文字列編集が複数行文字列の中身を書き換える等の破壊は、ここで検出する。
+  const managed = new Set()
+  if (typeof url === "string" && url) managed.add("url")
+  if (_CODEX_MCP_APPROVAL_MODES.has(approvalMode)) managed.add("default_tools_approval_mode")
+  if (hostCredential) managed.add(headersKey)
+  const unmanaged = (object) => Object.fromEntries(Object.entries(object ?? {}).filter(([k]) => !managed.has(k)))
+  if (!isDeepStrictEqual(unmanaged(before.mcp_servers?.[name]), unmanaged(server))) return false
+  return isDeepStrictEqual(without(before, "mcp_servers"), without(after, "mcp_servers")) &&
+    isDeepStrictEqual(without(before.mcp_servers, name), without(after.mcp_servers, name))
+}
+
 /**
  * 失敗しても既存ファイルを必ず維持する atomic write（同一ディレクトリ一時ファイル → rename）。
  *
  * 要件（2026-07-15 レビュー指摘対応）:
- *  - Unix では `chmod` 失敗で中止する（緩い権限 0644 の一時ファイルを本番化しない）。Windows は
+ *  - Unix または requireMode 指定時は `chmod` 失敗で中止する。通常の Windows は
  *    POSIX 権限概念が無いので chmod は best-effort（失敗無視）。
- *  - 一時ファイルは**最初から 0o600** で作成し（作成直後の 0644 露出を防ぐ）、その後に既存 mode へ合わせる。
+ *  - 一時ファイルは creationMode（既定 0o600）で作成し、その後に指定 mode へ合わせる。
  *  - 置換は全 OS で `rename`（libuv が Windows でも MOVEFILE_REPLACE_EXISTING で既存を原子置換）。
  *    rename は「完全成功」か「原本無変更」のどちらかなので、**失敗時は破壊的フォールバック（退避/削除）を
  *    一切行わず throw** し、既存 config を必ず無変更で維持する（退避方式は置換+復元の二重失敗で消失しうるため廃止）。
@@ -920,13 +1029,13 @@ export async function applyCodexMcpApprovalModes(
  * @param {string} targetPath
  * @param {string} content
  * @param {number} mode
- * @param {{fsImpl?: any, isWindows?: boolean, logger?: any}} [opts]
+ * @param {{fsImpl?: any, isWindows?: boolean, logger?: any, creationMode?: number, requireMode?: boolean}} [opts]
  */
 async function _atomicWriteFilePreserving(
   targetPath,
   content,
   mode,
-  { fsImpl = fs, isWindows = process.platform === "win32", logger } = {},
+  { fsImpl = fs, isWindows = process.platform === "win32", logger, creationMode = 0o600, requireMode = false } = {},
 ) {
   const dir = path.dirname(targetPath)
   const base = path.basename(targetPath)
@@ -934,10 +1043,10 @@ async function _atomicWriteFilePreserving(
   const tmp = path.join(dir, `.${base}.hub-tmp-${process.pid}-${rand}`)
   await fsImpl.mkdir(dir, { recursive: true })
   try {
-    // 一時ファイルは**最初から 0o600** で作成する。writeFile の mode 未指定だと作成直後は 0644 に
+    // 一時ファイルは最初から指定権限（既定 0o600）で作成する。mode 未指定だと作成直後は 0644 に
     // なり、config 内の静的ヘッダ等の秘密が一瞬でも world-readable に晒される（2026-07-15 指摘）。
-    await fsImpl.writeFile(tmp, content, { encoding: "utf-8", mode: 0o600 })
-    if (isWindows) {
+    await fsImpl.writeFile(tmp, content, { encoding: "utf-8", mode: creationMode })
+    if (isWindows && !requireMode) {
       // Windows は POSIX 権限が無い。既存 mode への合わせ込みは best-effort（失敗無視）。
       try {
         await fsImpl.chmod(tmp, mode)
@@ -945,7 +1054,7 @@ async function _atomicWriteFilePreserving(
         /* ignore on Windows */
       }
     } else {
-      // Unix: 既存ファイルの mode に合わせる。失敗したら中止（緩い権限のまま本番化しない）。
+      // 指定 mode に合わせる。失敗したら中止（緩い権限のまま本番化しない）。
       await fsImpl.chmod(tmp, mode)
     }
     // 全 OS で既存を原子置換する（libuv は Windows でも MOVEFILE_REPLACE_EXISTING で置換）。
@@ -969,6 +1078,36 @@ function _escapeRegExp(s) {
   return String(s).replace(/[.*+?^${}()|[\]\\]/g, "\\$&")
 }
 
+/** ヘッダーのサブテーブル/ドット記法は inline table と併記できないため編集しない。 */
+function _codexHeadersAlternativelyDefined(text, name, headersKey) {
+  const key = (value) => {
+    const escaped = _escapeRegExp(value)
+    return `(?:${escaped}|"${escaped}"|'${escaped}')`
+  }
+  const dot = "\\s*\\.\\s*"
+  const server = `${key("mcp_servers")}${dot}${key(name)}`
+  const headers = key(headersKey)
+  const subtable = new RegExp(`^\\s*\\[\\s*${server}${dot}${headers}\\s*(?:\\.|\\])`)
+  const parent = new RegExp(`^\\s*\\[\\s*${server}\\s*\\]\\s*(?:#.*)?$`)
+  const rootDotted = new RegExp(`^\\s*${server}${dot}${headers}\\s*(?:\\.|=)`)
+  const parentDotted = new RegExp(`^\\s*${headers}\\s*\\.`)
+  const escapedHeadersKey = _escapeRegExp(headersKey)
+  const parentQuotedDirect = new RegExp(`^\\s*(?:"${escapedHeadersKey}"|'${escapedHeadersKey}')\\s*=`)
+  let inRoot = true
+  let inParent = false
+  for (const line of text.split(/\r?\n/)) {
+    if (subtable.test(line)) return true
+    if (line.trim().startsWith("[")) {
+      inRoot = false
+      inParent = parent.test(line)
+    } else if ((inRoot && rootDotted.test(line)) ||
+        (inParent && (parentDotted.test(line) || parentQuotedDirect.test(line)))) {
+      return true
+    }
+  }
+  return false
+}
+
 /**
  * `name` の MCP サーバーが config.toml に**何らかの形で既に定義されている**かを判定する。
  * 標準形ヘッダ `[mcp_servers.<name>]`（空白/引用ゆらぎ含む）に加え、**ドット記法**
@@ -1096,7 +1235,8 @@ function _readTomlInlineStringMapValue(line, key, entryKey) {
  *  - `url` は高々 1 つ（重複していない）。
  * いずれか外れたら false（＝呼び出し側は書き込まず既存 config を保持する）。
  */
-function _verifyCodexServerTable(text, name, mode, hostCredential = null) {
+function _verifyCodexServerTable(text, name, mode, hostCredential = null, headersKey = "http_headers") {
+  if (hostCredential && _codexHeadersAlternativelyDefined(text, name, headersKey)) return false
   const n = _escapeRegExp(name)
   const lines = text.split(/\r?\n/)
   const bracketRe = new RegExp(`^\\s*\\[\\s*mcp_servers\\s*\\.\\s*"?${n}"?\\s*\\]\\s*$`)
@@ -1143,10 +1283,10 @@ function _verifyCodexServerTable(text, name, mode, hostCredential = null) {
       if (m && m[1] === expectedVal) modeOk = true
     }
     if (/^\s*url\s*=/.test(lines[i])) urlCount++
-    if (/^\s*http_headers\s*=/.test(lines[i])) {
+    if (new RegExp(`^\\s*${_escapeRegExp(headersKey)}\\s*=`).test(lines[i])) {
       httpHeadersCount++
       if (hostCredential) {
-        const parsed = _readTomlInlineStringMapValue(lines[i], "http_headers", "X-Cockpit-Agent")
+        const parsed = _readTomlInlineStringMapValue(lines[i], headersKey, "X-Cockpit-Agent")
         hostHeaderOk =
           parsed.valid && parsed.count === 1 && parsed.value === JSON.stringify(hostCredential)
       }
@@ -1627,6 +1767,23 @@ async function _syncBundleLocked({ hubUrl, agentId, agentToken, logger, fetchImp
   } catch (err) {
     logger?.warn({ cliKind, err: err.message }, "applyMcpServers failed (continuing)")
   }
+  let grokMcp
+  if (cliKind === "claude") {
+    try {
+      grokMcp = await applyGrokMcpServers(bundle, { agentId, agentToken, logger })
+      // Grok 未導入なら記録しない（後から導入したとき同じ版で同期させるため）。
+      // skip / pending は未適用なので記録せず失敗扱いにし、既存 backoff で再試行する
+      // （記録すると、利用者が設定を直しても同じ版では二度と同期されない）。
+      if (!grokMcp.grokMissing) {
+        if (grokMcp.skipped?.length || grokMcp.pending?.length) throw new Error("Grok MCP config not applied")
+        await updateHubAiState("claude", { grok_mcp_applied_version: bundle.version }, { fsImpl, logger })
+      }
+    } catch {
+      // 一時失敗は syncBundleTargets の failures 経由で既存 backoff に乗せる。
+      // 資格情報が含まれ得る元の例外は伝播しない。
+      throw new Error("Grok MCP config sync failed")
+    }
+  }
   // Codex のみ: 承認モード反映の結果を `.hub_ai_state.json` に記録する。
   // installed_version（files/hooks 済み）とは別に mcp_approval_applied_version を持つことで、
   // 「files は更新済みだが承認未反映」の状態を「完了」と誤認せず、次回の自己修復対象にできる。
@@ -1646,7 +1803,7 @@ async function _syncBundleLocked({ hubUrl, agentId, agentToken, logger, fetchImp
       approvalRetriable = true
     }
   }
-  return { version: bundle.version, ...result, mcp, approvalComplete, approvalRetriable }
+  return { version: bundle.version, ...result, mcp, ...(grokMcp ? { grokMcp } : {}), approvalComplete, approvalRetriable }
 }
 
 /**

package/src/live-sessions.mjs

@@ -24,21 +24,22 @@
 import { cliKindForSessionName } from "./session-names.mjs"
 
 /**
- * claude / codex ブリッジの live セッションを union で返す (宛先解決の候補集合)。
+ * claude / codex / grok ブリッジの live セッションを union で返す (宛先解決の候補集合)。
  *
- * `cwd` を渡すとその cwd のみ、`cliKind` に 'claude' / 'codex' を渡すとその CLI のみへ
- * 絞り込む。どちらも省略すると全 cwd・両 CLI (op:"list-all" 用)。`cliKind` が既知値以外
- * なら絞り込まない (両方返す) — 呼び出し側で既に検証済みの前提。
+ * `cwd` を渡すとその cwd のみ、`cliKind` に 'claude' / 'codex' / 'grok' を渡すとその CLI のみへ
+ * 絞り込む。どちらも省略すると全 cwd・全 CLI (op:"list-all" 用)。`cliKind` が既知値以外
+ * なら絞り込まない (全部返す) — 呼び出し側で既に検証済みの前提。
  *
- * @param {{claudeBridge?: object, codexBridge?: object}} bridges
- * @param {{cwd?: string, cliKind?: 'claude'|'codex'}} [filter]
- * @returns {Array<object>} describeLiveSessions の記述子配列 (claude → codex の順)
+ * @param {{claudeBridge?: object, codexBridge?: object, grokBridge?: object}} bridges
+ * @param {{cwd?: string, cliKind?: 'claude'|'codex'|'grok'}} [filter]
+ * @returns {Array<object>} describeLiveSessions の記述子配列 (claude → codex → grok の順)
  */
 export function describeLiveSessionsUnion(bridges, { cwd, cliKind } = {}) {
-  const { claudeBridge, codexBridge } = bridges || {}
+  const { claudeBridge, codexBridge, grokBridge } = bridges || {}
   const out = []
-  if (cliKind !== "codex") out.push(...(claudeBridge?.describeLiveSessions?.(cwd) ?? []))
-  if (cliKind !== "claude") out.push(...(codexBridge?.describeLiveSessions?.(cwd) ?? []))
+  if (cliKind !== "codex" && cliKind !== "grok") out.push(...(claudeBridge?.describeLiveSessions?.(cwd) ?? []))
+  if (cliKind !== "claude" && cliKind !== "grok") out.push(...(codexBridge?.describeLiveSessions?.(cwd) ?? []))
+  if (cliKind !== "claude" && cliKind !== "codex") out.push(...(grokBridge?.describeLiveSessions?.(cwd) ?? []))
   return out
 }
 
@@ -48,7 +49,7 @@ export function describeLiveSessionsUnion(bridges, { cwd, cliKind } = {}) {
  * 判定は上記 union に一本化する。`cwd` が取れていない行 (tmux の cwd 解決失敗など) は
  * 宛先解決のスコープを作れないため false (fail-closed。送れないものを送れると見せない)。
  *
- * @param {{claudeBridge?: object, codexBridge?: object}} bridges
+ * @param {{claudeBridge?: object, codexBridge?: object, grokBridge?: object}} bridges
  * @param {{name?: string, cwd?: string|null}} row tmux.list_sessions の session 行
  * @returns {boolean}
  */