@xyagent/cli 1.0.0 → 1.1.1

package/src-ext/core/mcpRuntimeFanout.mjs

@@ -31,12 +31,16 @@ import * as claudeAdapter from "../runtime/claude/mcpConfigAdapter.mjs";
 import * as codexAdapter from "../runtime/codex/mcpConfigAdapter.mjs";
 import * as hermesAdapter from "../runtime/hermes/mcpConfigAdapter.mjs";
 import * as openclawAdapter from "../runtime/openclaw/mcpConfigAdapter.mjs";
+import * as cursorAdapter from "../runtime/cursor/mcpConfigAdapter.mjs";
+import * as opencodeAdapter from "../runtime/opencode/mcpConfigAdapter.mjs";
 
 const ADAPTERS = {
   claude: claudeAdapter,
   codex: codexAdapter,
   hermes: hermesAdapter,
   openclaw: openclawAdapter,
+  cursor: cursorAdapter,
+  opencode: opencodeAdapter,
 };
 
 const HISTORY_DIR = () => path.join(getAgentlinkDir(), "fanout-history");
@@ -195,12 +199,30 @@ export async function status(opts = {}) {
 }
 
 /**
- * 调试用:列出所有 4 个 adapter 模块。
+ * 调试用:列出所有已实现 MCP 配置适配的 runtime。
  */
 export function listAdapters() {
   return Object.keys(ADAPTERS);
 }
 
+/**
+ * 该 runtime 有没有 MCP 配置适配器 —— register/deregister 的**唯一**前置判据。
+ *
+ * 🔴 调用方不要拿「有没有 bridge 实现」当近似：两者当前恰好同集合，但语义无关。
+ * 用错概念会在下一个「先有 MCP 适配器、还没有 bridge」（或反过来）的 runtime 上
+ * 立刻错判 —— 要么静默跳过本该做的注册，要么打出 `unknown_runtime` 这种像是
+ * 出错的失败文案（其实只是这一层没实现）。判据只能来自 ADAPTERS 本身。
+ *
+ * @param {string} runtime
+ * @returns {boolean}
+ */
+export function hasMcpAdapter(runtime) {
+  return Object.prototype.hasOwnProperty.call(
+    ADAPTERS,
+    String(runtime ?? "").trim().toLowerCase(),
+  );
+}
+
 /**
  * 推断 agentlink-mcp-stdio 二进制位置。如果不在 process.argv[1] 同目录,
  * 退到 node_modules/.bin/agentlink-mcp-stdio。fanout 写入前用绝对路径,

package/src-ext/core/pairCodeClient.mjs

@@ -3,7 +3,7 @@
 // 升级后的协议(对齐服务端 internal/handler/pair_code/handler.go):
 //
 //   POST /v1/pair-codes/<code>/consume
-//   Body: {"client_user_id":"<...>", "runtime":"hermes|claude|codex|openclaw"}
+//   Body: {"client_user_id":"<...>", "runtime":"<可配对 runtime，见 runtimeRegistry>"}
 //   Response: {"status":"ok", "gw_id":"...", "bridge_token":"...", "runtime":"..."}
 //
 // session_id 现在是 gw_id —— 服务端 BridgeStore.Issue 颁发的 gateway 身份。
@@ -22,6 +22,8 @@ import os from "node:os";
 import process from "node:process";
 import relayDefaults from "../../src-shared/relay-defaults.json" with { type: "json" };
 import { CLI_STATE_DIR_NAME } from "./attachAuditLog.mjs";
+import { getOrCreateInstallationId } from "./installationIdentity.mjs";
+import { PAIRABLE_RUNTIME_KINDS, pairingCapabilitiesForRuntime } from "./runtimeRegistry.mjs";
 
 /**
  * Normalize a raw hostname for reporting to the server.
@@ -50,8 +52,17 @@ export function normalizeHostName(raw) {
 /** 默认 relay URL。 */
 export const DEFAULT_RELAY_URL = relayDefaults.defaultRelayUrl;
 
-/** 4 种合法 runtime — 与服务端 util.IsValidRuntimeKind 对齐。 */
-export const VALID_RUNTIMES = Object.freeze(["hermes", "claude", "codex", "openclaw"]);
+/**
+ * 可消费配对码的 runtime —— 从 runtimeRegistry 的「可配对集」派生，不再手抄一份。
+ *
+ * 手抄那份是握手的隐形闸门：runtime 已经在 CLI 各层放行了，consumePairCode 这里
+ * 漏加就会在客户端自校验阶段直接抛 `runtime must be one of ...`，配对根本发不出去。
+ * 改成派生后，「加 runtime」只需改 runtimeRegistry 一处。
+ *
+ * ⚠️ 服务端 `util.IsValidRuntimeKind` 是**另一仓**的白名单，与本常量各自独立：
+ * 这里放行只保证请求发得出去，服务端未同步放行时会以 4xx 如实失败（不静默降级）。
+ */
+export const VALID_RUNTIMES = PAIRABLE_RUNTIME_KINDS;
 
 /** 按优先级解析 relay url:显式 --relay > env > 默认。永远有值。 */
 export function resolveRelayUrl(optionsRelay) {
@@ -88,6 +99,10 @@ function ensureDir() {
 // ext 文件,导致 openclaw/hermes 新版 pair 后 bridge 启动报"尚未配对"。
 // 这里加一层 fallback:ext 文件不存在 / 字段不全时,从 config.json 兜底。
 function readPairStateFromConfig(runtime) {
+  // 🔴 白名单而非黑名单：config.json 里只有 openclaw / hermes 两个凭证槽位。
+  // 任何 ext-agent runtime（claude / codex / opencode）走到这里都必须返回 null ——
+  // 否则「自己的 state 缺失」会被兜底成「借用 openclaw 的网关身份」，
+  // 即历史 bug 的读方向版本。加 runtime 时**不要**顺手把它加进这个判断。
   if (runtime !== "hermes" && runtime !== "openclaw") return null;
   let parsed;
   try {
@@ -97,7 +112,10 @@ function readPairStateFromConfig(runtime) {
   const idKey = runtime === "hermes" ? "hermesRelayGatewayId" : "relayGatewayId";
   const tokKey = runtime === "hermes" ? "hermesRelayGatewayToken" : "relayGatewayToken";
   const gwId = String(parsed[idKey] || "").trim();
-  const relayUrl = String(parsed.relayUrl || "").trim();
+  // 早期 config.json 只保存 gateway 凭据，没有 relayUrl。launchd 脚本会通过
+  // AGENTLINK_RELAY_URL / --relay 提供环境；这里沿用统一解析顺序，避免升级后把
+  // 已配对的 OpenClaw / Hermes 误判成“尚未配对”。
+  const relayUrl = resolveRelayUrl(parsed.relayUrl);
   const bridgeToken = String(parsed[tokKey] || "").trim();
   if (!gwId || !relayUrl) return null;
   return {
@@ -200,10 +218,18 @@ export async function consumePairCode({ relayUrl, code, runtime, clientUserId, f
   const base = relayUrl.replace(/\/+$/, "");
 
   const hostName = normalizeHostName(os.hostname());
+  const installationId = getOrCreateInstallationId();
+  const capabilities = pairingCapabilitiesForRuntime(rt);
 
   // 1. 优先打新端点
   const v1 = `${base}/v1/pair-codes/${encodeURIComponent(code)}/consume`;
-  const v1Body = JSON.stringify({ client_user_id: cuid, runtime: rt, hostName });
+  const v1Body = JSON.stringify({
+    client_user_id: cuid,
+    runtime: rt,
+    hostName,
+    installation_id: installationId,
+    capabilities,
+  });
   const v1Res = await f(v1, {
     method: "POST",
     headers: { "Content-Type": "application/json" },
@@ -223,7 +249,13 @@ export async function consumePairCode({ relayUrl, code, runtime, clientUserId, f
   const legacyRes = await f(legacy, {
     method: "POST",
     headers: { "Content-Type": "application/json" },
-    body: JSON.stringify({ runtime: rt, client_user_id: cuid, hostName }),
+    body: JSON.stringify({
+      runtime: rt,
+      client_user_id: cuid,
+      hostName,
+      installation_id: installationId,
+      capabilities,
+    }),
   });
   const legacyText = await legacyRes.text();
   if (!legacyRes.ok) throw makeConsumeError(legacyRes.status, legacyText);
@@ -308,12 +340,20 @@ export async function resolveSession({ runtime, options, log }) {
   }
   const saved = readPairState(runtime);
   if (saved) {
+    // 显式 --relay flag 必须压过 saved.relay_url：hermes 走 config.json 兜底时
+    // relay_url 可能落到 DEFAULT_RELAY_URL（生产），launchd 脚本明明传了
+    // --relay <test>，worker 却把心跳和 long-poll 全打到生产 relay ——
+    // 测试环境永远显示离线（2026-08-12 实测根因）。
+    const effectiveRelay = typeof options.relay === "string" && options.relay.trim()
+      ? relay
+      : saved.relay_url;
     log?.info("pair.state.reuse", "reusing saved pair state", {
-      gw_id: saved.gw_id, relay: saved.relay_url, has_bridge_token: !!saved.bridge_token,
+      gw_id: saved.gw_id, relay: effectiveRelay, saved_relay: saved.relay_url,
+      has_bridge_token: !!saved.bridge_token,
     });
     const savedResult = {
       gwId: saved.gw_id,
-      relayUrl: saved.relay_url,
+      relayUrl: effectiveRelay,
       source: "saved",
       bridgeToken: saved.bridge_token || "",
     };

package/src-ext/core/pairInventory.mjs

@@ -9,11 +9,23 @@
  *   summary ok=true  && !skipped → "paired_new"
  *   summary skipped=true         → "paired_existing"
  *   summary ok=false             → "failed"
- *   未出现在 summary（未安装）     → "not_installed"
+ *   未出现在 summary + 未安装      → "not_installed"
+ *   未出现在 summary + 已安装      → "failed"（见下方分支注释）
  */
 
-/** 所有被扫描的 runtime 名（固定 4 个）。 */
-const SCANNED_RUNTIMES = ["openclaw", "hermes", "claude", "codex"];
+/**
+ * 所有被扫描的 runtime 名 = bin/agentlink 的 HOST_DETECTED_RUNTIME_KINDS。
+ *
+ * OpenCode 与 DeepAgents 都在这里：OpenCode 通过 PATH 探测；DeepAgents 通过
+ * `agentlink-deepagents`、`langgraph.json` 或本地 status endpoint 探测。两者都使用
+ * ext runtime 凭证槽，不会回落或覆盖 OpenClaw 凭证。
+ *
+ * 导出供测试断言「探测集单一真相」，加 runtime 时两边不会漂。
+ */
+export const SCANNED_RUNTIMES = Object.freeze([
+  "openclaw", "hermes", "claude", "codex", "cursor", "opencode", "deepagents",
+  "qwen", "kimi", "codebuddy",
+]);
 
 /**
  * buildPairSessionResults 从 summary + detected 构建 per-runtime outcome 列表。
@@ -21,9 +33,9 @@ const SCANNED_RUNTIMES = ["openclaw", "hermes", "claude", "codex"];
  * @param {Array<{kind: string, ok: boolean, skipped?: boolean}>} summary
  *   runPairAll 内的 summary 数组，只包含已安装的 runtime。
  * @param {Array<{kind: string, installed: boolean}>} detected
- *   detectInstalledRuntimes 的返回值，含全部 4 个 runtime。
+ *   detectInstalledRuntimes 的返回值，含全部本机探测集 runtime。
  * @returns {Array<{runtime: string, outcome: string}>}
- *   长度为 4，覆盖全部 scanned runtimes。
+ *   长度 = SCANNED_RUNTIMES.length，覆盖全部 scanned runtimes。
  */
 export function buildPairSessionResults(summary, detected) {
   // 构建 summaryMap：kind → summary entry（方便 O(1) 查找）
@@ -50,7 +62,20 @@ export function buildPairSessionResults(summary, detected) {
     } else if (!installedSet.has(rt)) {
       outcome = "not_installed";
     } else {
-      // 已安装但没有出现在 summary（理论上不应发生）→ 保守标 failed
+      // 已安装但没有出现在 summary。
+      //
+      // 历史：opencode 曾固定命中这里（当时它只入探测、没有配对实现，
+      // runPairAll 不会把它 spawn 进扇出）。自
+      // devagent-m-20260807-cli-runtime-opencode-pairable 起 opencode 已进入
+      // 扇出目标，会带着真实 outcome 出现在 summary 里 —— 本分支退回**纯防御性
+      // 兜底**：给下一个「只入探测、还没配对实现」的 runtime 用。
+      //
+      // 映射成 failed 而不是 not_installed：它确实装了，谎报未安装会让 App 把
+      // chip 显示成"未安装"，与本机事实相反。failed 的语义"没配上"是真的。
+      //
+      // 也刻意 **不** 新增 `unsupported` 之类的 outcome 值：outcome 枚举由 relay
+      // 侧持有（另一仓），本轮 relay 只放行了 `opencode` 这个 runtime 名，
+      // 单方面发新 outcome 值有被静默丢弃/报错的风险，跨仓契约未核实。
       outcome = "failed";
     }
 

package/src-ext/core/relayWorker.mjs

@@ -23,6 +23,8 @@ import {
   bridgeAuthHeaders,
   extractError,
 } from "./relayWorkerHttp.mjs";
+import { ensureDefaultWorkspace } from "./defaultWorkspace.mjs";
+import { ensureRelayDefaultWorkspace } from "./defaultWorkspaceSync.mjs";
 
 // long-poll 等待秒数(服务端上限 60s)。多数情况下队列里就有请求,空闲时占用一个连接。
 const POLL_WAIT_SECONDS = 25;
@@ -44,7 +46,8 @@ const POLL_BACKOFF_MAX_MS = 15_000;
  *   relayUrl: string,
  *   gwId: string,
  *   bridgeToken: string,
- *   runtime: "hermes"|"claude"|"codex",
+ *   runtime: string,
+ *   profileName?: string,
  *   log: any,
  * }} opts
  */
@@ -180,6 +183,23 @@ export function createRelayWorker(opts) {
     if (typeof handler !== "function") {
       throw new Error("worker.run: handler must be a function");
     }
+    // Pair 时的首次上报可能刚好撞上 relay 重启；worker 启动时补一次，失败
+    // 不阻断会话桥接，并在下一次 worker 重启时继续重试。
+    try {
+      await ensureDefaultWorkspace(opts.runtime, { profileName: opts.profileName });
+      await ensureRelayDefaultWorkspace({
+        runtime: opts.runtime,
+        relayUrl: base,
+        bridgeToken: opts.bridgeToken,
+        profileName: opts.profileName,
+      });
+      log.info("default_workspace.ready", "default workspace registered with relay", { runtime: opts.runtime });
+    } catch (err) {
+      log.warn("default_workspace.pending", "default workspace registration will retry on next worker start", {
+        runtime: opts.runtime,
+        err: err?.message || String(err),
+      });
+    }
     // sessionKey → 该会话当前尾部 promise（chat 请求按会话串行、跨会话并行）
     const sessionLanes = new Map();
     startHeartbeat();

package/src-ext/core/runtimeRegistry.mjs

@@ -0,0 +1,180 @@
+// runtimeRegistry.mjs — runtime「能力分层」的单一真相表（cli-runtime-kind-registry）。
+//
+// 为什么要单独一个模块：本仓有两处代码各自持有一份 runtime 名单 ——
+// `bin/agentlink`（native 路径 + 命令分派）与 `src-ext/**`（agentlink-agent 平行世界）。
+// 两边都硬编码时，加一个 runtime 就要满仓 grep，漏一处就退化成「静默回落 openclaw」
+// （历史 bug：非 openclaw 的配对结果被写进 openclaw 的 relayGatewayId/Token 槽位）。
+// 现在两边都 import 这里，**加 runtime = 在对应层加一行**，「这一层要不要带上它」
+// 被逼成一次显式选择。
+//
+// 🔴 分层不是同一批名字的近义词，语义严格不同，改前先读清楚：
+//
+//   PAIRABLE       真有 pair / reset 实现、配对能落凭证的 runtime。
+//   BRIDGE_CAPABLE 真有 bridge / service / MCP 适配器实现、能起进程收发消息的 runtime。
+//   PAIR_ONLY      = PAIRABLE ∖ BRIDGE_CAPABLE：配得上、但本轮还跑不起来。
+//                    这些 runtime 在 bridge/service/reload/scan/status 上必须**显式拦停**，
+//                    绝不能进 normalizeRuntimeKind(x, "openclaw") 那条回落路径。
+//   EXT_AGENT      由 `agentlink-agent` 子进程承载、凭证存
+//                    ~/.agentlink/ext-<runtime>-last.json 的 runtime。
+//                    与之相对的 openclaw/hermes 凭证存 ~/.agentlink/config.json。
+//                    ⚠️ 这一层决定「凭证写哪个槽位」，加错 = 静默错配。
+//
+// 本机探测集 / 已知枚举 / 扫码集仍留在 `bin/agentlink`（它们只有 native 侧用到，
+// 且与 t() 文案渲染耦合）；本模块只收敛 src-ext 与 bin **都**需要的能力分层。
+
+export const RUNTIME_KIND_OPENCLAW = "openclaw";
+export const RUNTIME_KIND_HERMES = "hermes";
+export const RUNTIME_KIND_CLAUDE = "claude";
+export const RUNTIME_KIND_CODEX = "codex";
+export const RUNTIME_KIND_CURSOR = "cursor";
+export const RUNTIME_KIND_OPENCODE = "opencode";
+export const RUNTIME_KIND_DEEPAGENTS = "deepagents";
+export const RUNTIME_KIND_QWEN = "qwen";
+export const RUNTIME_KIND_KIMI = "kimi";
+export const RUNTIME_KIND_CODEBUDDY = "codebuddy";
+
+export const RUNTIME_CAPABILITY_SCHEMA_VERSION = 2;
+export const MINIMUM_CAPABILITY_CLI_VERSION = "1.1.0";
+export const CURRENT_PROTOCOL_VERSION = "v1.1";
+
+const BRIDGE_MODE_AGENTLINK_CLI = "agentlink_cli";
+const BRIDGE_MODE_SIDECAR = "sidecar";
+
+const WORKSPACE_HISTORY_RUNTIMES = new Set([
+  RUNTIME_KIND_OPENCLAW,
+  RUNTIME_KIND_HERMES,
+  RUNTIME_KIND_CLAUDE,
+  RUNTIME_KIND_CODEX,
+  RUNTIME_KIND_CURSOR,
+  RUNTIME_KIND_OPENCODE,
+  RUNTIME_KIND_QWEN,
+  RUNTIME_KIND_KIMI,
+  RUNTIME_KIND_CODEBUDDY,
+]);
+
+function capabilityOf(runtime, bridgeMode = BRIDGE_MODE_AGENTLINK_CLI) {
+  const workspaceV2 = WORKSPACE_HISTORY_RUNTIMES.has(runtime);
+  return Object.freeze({
+    runtime,
+    pairable: true,
+    bridgeMode,
+    identity: true,
+    cancel: true,
+    minimumCliVersion: MINIMUM_CAPABILITY_CLI_VERSION,
+    protocolVersions: Object.freeze([CURRENT_PROTOCOL_VERSION]),
+    installationIdentityV1: workspaceV2,
+    workspaceIdentityV2: workspaceV2,
+    historyImportV2: workspaceV2,
+    workspaceCwd: workspaceV2,
+    sessionResume: workspaceV2,
+    historySource: workspaceV2,
+  });
+}
+
+/** Boolean-only capability snapshot accepted by the relay pair endpoint. */
+export function pairingCapabilitiesForRuntime(kind) {
+  const runtime = String(kind ?? "").trim().toLowerCase();
+  const capability = RUNTIME_CAPABILITIES.runtimes.find((item) => item.runtime === runtime);
+  if (!capability) return Object.freeze({});
+  return Object.freeze({
+    installation_identity_v1: capability.installationIdentityV1,
+    workspace_identity_v2: capability.workspaceIdentityV2,
+    history_import_v2: capability.historyImportV2,
+    workspace_cwd_v1: capability.workspaceCwd,
+    session_resume_v1: capability.sessionResume,
+    history_source_v1: capability.historySource,
+  });
+}
+
+/** 公开能力元数据，不读取配对凭据，也不探测或启动第三方 Agent。 */
+export const RUNTIME_CAPABILITIES = Object.freeze({
+  schemaVersion: RUNTIME_CAPABILITY_SCHEMA_VERSION,
+  runtimes: Object.freeze([
+    capabilityOf(RUNTIME_KIND_OPENCLAW),
+    capabilityOf(RUNTIME_KIND_HERMES),
+    capabilityOf(RUNTIME_KIND_CLAUDE),
+    capabilityOf(RUNTIME_KIND_CODEX),
+    capabilityOf(RUNTIME_KIND_CURSOR),
+    capabilityOf(RUNTIME_KIND_OPENCODE),
+    capabilityOf(RUNTIME_KIND_DEEPAGENTS, BRIDGE_MODE_SIDECAR),
+    capabilityOf(RUNTIME_KIND_QWEN),
+    capabilityOf(RUNTIME_KIND_KIMI),
+    capabilityOf(RUNTIME_KIND_CODEBUDDY),
+  ]),
+});
+
+/** PATH 探测入口；Kimi 保留 N-1 发行版的 kimi-cli 兼容名。 */
+export const RUNTIME_BINARY_CANDIDATES = Object.freeze({
+  [RUNTIME_KIND_HERMES]: Object.freeze(["hermes"]),
+  [RUNTIME_KIND_CLAUDE]: Object.freeze(["claude"]),
+  [RUNTIME_KIND_CODEX]: Object.freeze(["codex"]),
+  [RUNTIME_KIND_CURSOR]: Object.freeze(["cursor"]),
+  [RUNTIME_KIND_OPENCODE]: Object.freeze(["opencode"]),
+  [RUNTIME_KIND_DEEPAGENTS]: Object.freeze(["agentlink-deepagents"]),
+  [RUNTIME_KIND_QWEN]: Object.freeze(["qwen"]),
+  [RUNTIME_KIND_KIMI]: Object.freeze(["kimi", "kimi-cli"]),
+  [RUNTIME_KIND_CODEBUDDY]: Object.freeze(["codebuddy"]),
+});
+
+/**
+ * 有 bridge / service / MCP 适配器实现的 runtime。
+ * Cursor / OpenCode 使用 headless CLI bridge。
+ */
+export const BRIDGE_CAPABLE_RUNTIME_KINDS = Object.freeze([
+  RUNTIME_KIND_OPENCLAW,
+  RUNTIME_KIND_HERMES,
+  RUNTIME_KIND_CLAUDE,
+  RUNTIME_KIND_CODEX,
+  RUNTIME_KIND_CURSOR,
+  RUNTIME_KIND_OPENCODE,
+  RUNTIME_KIND_QWEN,
+  RUNTIME_KIND_KIMI,
+  RUNTIME_KIND_CODEBUDDY,
+]);
+
+/**
+ * 有 pair / reset 实现、配对能真正落凭证的 runtime。
+ * opencode 自 devagent-m-20260807-cli-runtime-opencode-pairable 起进入本集合。
+ */
+export const PAIRABLE_RUNTIME_KINDS = Object.freeze([
+  ...BRIDGE_CAPABLE_RUNTIME_KINDS,
+  RUNTIME_KIND_DEEPAGENTS,
+]);
+
+/**
+ * 配得上、但本轮没有 bridge 实现的 runtime（= PAIRABLE ∖ BRIDGE_CAPABLE）。
+ * 派生而非硬编码：BRIDGE_CAPABLE 补齐时这里自动清空，不会留下过期的拦停。
+ */
+export const PAIR_ONLY_RUNTIME_KINDS = Object.freeze(
+  PAIRABLE_RUNTIME_KINDS.filter((k) => !BRIDGE_CAPABLE_RUNTIME_KINDS.includes(k)),
+);
+
+/**
+ * 由 agentlink-agent 承载、凭证存 ext-<runtime>-last.json 的 runtime。
+ * 🔴 决定「配对凭证写哪个槽位」——openclaw/hermes 不在此列（它们写 config.json）。
+ */
+export const EXT_AGENT_RUNTIME_KINDS = Object.freeze([
+  RUNTIME_KIND_CLAUDE,
+  RUNTIME_KIND_CODEX,
+  RUNTIME_KIND_CURSOR,
+  RUNTIME_KIND_OPENCODE,
+  RUNTIME_KIND_DEEPAGENTS,
+  RUNTIME_KIND_QWEN,
+  RUNTIME_KIND_KIMI,
+  RUNTIME_KIND_CODEBUDDY,
+]);
+
+/** 该 runtime 有没有配对实现（pair / reset 能不能走）。 */
+export function isPairableRuntime(kind) {
+  return PAIRABLE_RUNTIME_KINDS.includes(String(kind ?? "").trim().toLowerCase());
+}
+
+/** 该 runtime 有没有 bridge / service 实现（bridge / service / reload 能不能走）。 */
+export function hasBridgeImplementation(kind) {
+  return BRIDGE_CAPABLE_RUNTIME_KINDS.includes(String(kind ?? "").trim().toLowerCase());
+}
+
+/** 该 runtime 的配对凭证是不是存 ext-<runtime>-last.json（而非 config.json）。 */
+export function isExtAgentRuntime(kind) {
+  return EXT_AGENT_RUNTIME_KINDS.includes(String(kind ?? "").trim().toLowerCase());
+}