@router-agent/runtime 0.0.0-stage → 0.3.31

package/dist/runtimes/acp-agents.d.ts

@@ -0,0 +1,85 @@
+/**
+ * ACP Agent 静态目录。
+ *
+ * 这里只放纯常量与纯函数，不能依赖任何 Node 内置模块 —— Web 面板会把它
+ * 一起打进前端包。探测、安装、spawn 等 Node-only 逻辑放在 detect.ts / install.ts。
+ */
+export interface AcpAgentRequirement {
+    /** 外部依赖命令，例如 codex。 */
+    command: string;
+    label: string;
+    /** 最低版本；仅作提示，真正兼容性以能力探测 / 完整握手为准。 */
+    minVersion?: string;
+    /** 能力探测参数，例如 ['app-server', '--help']；退出 0 视为具备该能力。 */
+    capabilityArgs?: readonly string[];
+    hint: string;
+}
+export interface AcpAgentMeta {
+    /** Agent 短 id，用于安装目录名（不能含冒号，Windows 文件名要合法）。 */
+    id: string;
+    /** 运行时 id，写入 runtime.default / runtime.projects / runtime.options。 */
+    runtimeId: string;
+    /** 产品名（自然大小写）；Web 面板按首字母大写展示，CLI 与文档保持原样。 */
+    name: string;
+    label: string;
+    hint: string;
+    /** PATH 上的命令名；managed 安装时也是 node_modules/.bin 下的文件名。 */
+    command: string;
+    args: readonly string[];
+    /** 可由 ra 按需安装的 npm 包；缺省表示只能由用户自行安装。 */
+    package?: {
+        name: string;
+        version: string;
+    };
+    /** npm 包（ACP 扩展）的官方页面；Web 卡片用它跳转。 */
+    packageUrl?: string;
+    /** 底层 CLI；用于 Web 区分「安装 CLI」与「安装 ACP 扩展」。 */
+    cli?: {
+        command: string;
+        label: string;
+        installUrl: string;
+    };
+    /** 工具本身支持 ACP 时的官方安装页（没有独立 ACP 扩展）。 */
+    installUrl?: string;
+    /** 版本探测参数；默认 ['--version']。 */
+    probeArgs?: readonly string[];
+    /** 外部依赖检查。 */
+    requires?: readonly AcpAgentRequirement[];
+    /** 传给 Agent 的默认环境变量。 */
+    env?: Readonly<Record<string, string>>;
+    /** 登录命令（交互式）；Web 只展示提示，不代跑。 */
+    login?: {
+        command: string;
+        args: readonly string[];
+        hint: string;
+        /** 非交互登录状态检查；退出 0 视为已登录。 */
+        check?: {
+            command: string;
+            args: readonly string[];
+        };
+    };
+    /** 无法在线安装时的提示。 */
+    installHint?: string;
+    /** 已测 / 文档声明的 session/load 能力。 */
+    loadSession?: boolean;
+    /** L0 版本探测不足以确认 ACP 模式，需要 `ra runtime check` 完整握手。 */
+    verifyRequired?: boolean;
+    /**
+     * 已有原生运行时替代品：Web 面板不再把它作为可选运行时展示，
+     * 但运行时 id、配置与已装扩展全部保留，老配置继续可用。
+     */
+    deprecated?: boolean;
+}
+export declare const ACP_AGENTS: readonly AcpAgentMeta[];
+/** 按 agent id 或 runtime id 查目录项。 */
+export declare function acpAgentOf(idOrRuntimeId: string): AcpAgentMeta | undefined;
+/** 是否是目录内的动态 ACP 运行时 id（不含旧的通用 `acp`）。 */
+export declare function isAcpRuntimeId(id: string): boolean;
+/**
+ * 是否是已有原生运行时替代品的 ACP 运行时（Claude Code / Codex）。
+ *
+ * 这类运行时 id 依旧合法、依旧能派工，只是 Web 面板不再把它们列为可选项。
+ */
+export declare function isDeprecatedAcpRuntimeId(id: string): boolean;
+/** agent id → runtime id；未知 id 返回 null。 */
+export declare function acpRuntimeIdOf(idOrRuntimeId: string): string | null;

package/dist/runtimes/acp-agents.js

@@ -0,0 +1,167 @@
+/**
+ * ACP Agent 静态目录。
+ *
+ * 这里只放纯常量与纯函数，不能依赖任何 Node 内置模块 —— Web 面板会把它
+ * 一起打进前端包。探测、安装、spawn 等 Node-only 逻辑放在 detect.ts / install.ts。
+ */
+export const ACP_AGENTS = [
+    {
+        id: 'claude',
+        runtimeId: 'acp-claude',
+        name: 'Claude Code',
+        label: 'Claude Code (ACP)',
+        hint: '通过 claude-agent-acp 接入，支持断线后 session/load 恢复',
+        command: 'claude-agent-acp',
+        args: [],
+        package: { name: '@agentclientprotocol/claude-agent-acp', version: '0.101.0' },
+        packageUrl: 'https://www.npmjs.com/package/@agentclientprotocol/claude-agent-acp',
+        cli: {
+            command: 'claude',
+            label: 'Claude Code CLI',
+            installUrl: 'https://docs.claude.com/en/docs/claude-code/setup',
+        },
+        probeArgs: ['--version'],
+        env: { CLAUDE_AGENT_ACP_PROTOCOL: 'v1' },
+        login: { command: 'claude', args: [], hint: '先完成 Claude Code 登录（claude 能正常对话）' },
+        loadSession: true,
+        // 已有 claude-code 内置运行时，Web 面板不再把它作为可选项展示。
+        deprecated: true,
+    },
+    {
+        id: 'codex',
+        runtimeId: 'acp-codex',
+        name: 'Codex',
+        label: 'Codex (ACP)',
+        hint: 'baldaworks codex-acp；依赖本机 codex CLI，不支持断线恢复',
+        command: 'codex-acp',
+        args: ['--message-streaming'],
+        package: { name: 'codex-acp', version: '1.11.0' },
+        packageUrl: 'https://www.npmjs.com/package/codex-acp',
+        cli: {
+            command: 'codex',
+            label: 'OpenAI Codex CLI',
+            installUrl: 'https://github.com/openai/codex',
+        },
+        probeArgs: ['version'],
+        requires: [
+            {
+                command: 'codex',
+                label: 'Codex CLI',
+                capabilityArgs: ['app-server', '--help'],
+                hint: '需要本机安装 codex CLI，且版本包含 app-server 子命令',
+            },
+        ],
+        login: {
+            command: 'codex-acp',
+            args: ['login'],
+            hint: '先运行 codex-acp login',
+            check: { command: 'codex', args: ['login', 'status'] },
+        },
+        loadSession: false,
+        // 已有 codex-app 内置运行时，Web 面板不再把它作为可选项展示。
+        deprecated: true,
+    },
+    {
+        id: 'opencode',
+        runtimeId: 'acp-opencode',
+        name: 'OpenCode',
+        label: 'OpenCode',
+        hint: 'opencode acp 原生 ACP 模式',
+        command: 'opencode',
+        args: ['acp'],
+        probeArgs: ['--version'],
+        installHint: 'brew install opencode（或参考 opencode 官方安装说明）',
+        installUrl: 'https://opencode.ai/docs/',
+        cli: { command: 'opencode', label: 'OpenCode CLI', installUrl: 'https://opencode.ai/docs/' },
+        verifyRequired: true,
+        loadSession: true,
+    },
+    {
+        id: 'gemini',
+        runtimeId: 'acp-gemini',
+        name: 'Gemini CLI',
+        label: 'Gemini CLI',
+        hint: 'gemini --acp 实验性 ACP 模式',
+        command: 'gemini',
+        args: ['--acp'],
+        probeArgs: ['--version'],
+        installHint: 'npm i -g @google/gemini-cli',
+        installUrl: 'https://github.com/google-gemini/gemini-cli',
+        cli: { command: 'gemini', label: 'Gemini CLI', installUrl: 'https://github.com/google-gemini/gemini-cli' },
+        verifyRequired: true,
+    },
+    {
+        id: 'copilot',
+        runtimeId: 'acp-copilot',
+        name: 'GitHub Copilot CLI',
+        label: 'GitHub Copilot CLI',
+        hint: 'copilot --acp --stdio',
+        command: 'copilot',
+        args: ['--acp', '--stdio'],
+        probeArgs: ['--version'],
+        installHint: '参考 GitHub Copilot CLI 官方安装说明',
+        installUrl: 'https://docs.github.com/en/copilot/how-tos/set-up/install-copilot-cli',
+        cli: {
+            command: 'copilot',
+            label: 'GitHub Copilot CLI',
+            installUrl: 'https://docs.github.com/en/copilot/how-tos/set-up/install-copilot-cli',
+        },
+        verifyRequired: true,
+    },
+    {
+        id: 'cursor',
+        runtimeId: 'acp-cursor',
+        name: 'Cursor CLI',
+        label: 'Cursor CLI',
+        hint: 'cursor-agent acp；旧版本可能没有 acp 子命令',
+        command: 'cursor-agent',
+        args: ['acp'],
+        probeArgs: ['--version'],
+        installHint: '升级 cursor-agent 到支持 acp 子命令的版本',
+        installUrl: 'https://cursor.com/cli',
+        cli: { command: 'cursor-agent', label: 'Cursor CLI', installUrl: 'https://cursor.com/cli' },
+        verifyRequired: true,
+    },
+    {
+        id: 'goose',
+        runtimeId: 'acp-goose',
+        name: 'Goose',
+        label: 'Goose',
+        hint: 'goose acp 原生 ACP 模式',
+        command: 'goose',
+        args: ['acp'],
+        probeArgs: ['--version'],
+        installHint: 'brew install block-goose-cli（或参考 Goose 官方安装说明）',
+        installUrl: 'https://block.github.io/goose/docs/getting-started/installation',
+        cli: {
+            command: 'goose',
+            label: 'Goose CLI',
+            installUrl: 'https://block.github.io/goose/docs/getting-started/installation',
+        },
+        verifyRequired: true,
+    },
+];
+/** 按 agent id 或 runtime id 查目录项。 */
+export function acpAgentOf(idOrRuntimeId) {
+    const value = idOrRuntimeId.trim();
+    return ACP_AGENTS.find(agent => agent.id === value || agent.runtimeId === value);
+}
+/** 是否是目录内的动态 ACP 运行时 id（不含旧的通用 `acp`）。 */
+export function isAcpRuntimeId(id) {
+    const value = id.trim();
+    return ACP_AGENTS.some(agent => agent.runtimeId === value);
+}
+/**
+ * 是否是已有原生运行时替代品的 ACP 运行时（Claude Code / Codex）。
+ *
+ * 这类运行时 id 依旧合法、依旧能派工，只是 Web 面板不再把它们列为可选项。
+ */
+export function isDeprecatedAcpRuntimeId(id) {
+    const value = id.trim();
+    return ACP_AGENTS.some(agent => agent.runtimeId === value && agent.deprecated === true);
+}
+/** agent id → runtime id；未知 id 返回 null。 */
+export function acpRuntimeIdOf(idOrRuntimeId) {
+    return acpAgentOf(idOrRuntimeId)?.runtimeId ?? null;
+}
+//# sourceMappingURL=acp-agents.js.map

package/dist/runtimes/acp-agents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"acp-agents.js","sourceRoot":"","sources":["../../../../../packages/runtime/src/runtimes/acp-agents.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAgEH,MAAM,CAAC,MAAM,UAAU,GAA4B;IACjD;QACE,EAAE,EAAE,QAAQ;QACZ,SAAS,EAAE,YAAY;QACvB,IAAI,EAAE,aAAa;QACnB,KAAK,EAAE,mBAAmB;QAC1B,IAAI,EAAE,8CAA8C;QACpD,OAAO,EAAE,kBAAkB;QAC3B,IAAI,EAAE,EAAE;QACR,OAAO,EAAE,EAAE,IAAI,EAAE,uCAAuC,EAAE,OAAO,EAAE,SAAS,EAAE;QAC9E,UAAU,EAAE,qEAAqE;QACjF,GAAG,EAAE;YACH,OAAO,EAAE,QAAQ;YACjB,KAAK,EAAE,iBAAiB;YACxB,UAAU,EAAE,mDAAmD;SAChE;QACD,SAAS,EAAE,CAAC,WAAW,CAAC;QACxB,GAAG,EAAE,EAAE,yBAAyB,EAAE,IAAI,EAAE;QACxC,KAAK,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,kCAAkC,EAAE;QAChF,WAAW,EAAE,IAAI;QACjB,0CAA0C;QAC1C,UAAU,EAAE,IAAI;KACjB;IACD;QACE,EAAE,EAAE,OAAO;QACX,SAAS,EAAE,WAAW;QACtB,IAAI,EAAE,OAAO;QACb,KAAK,EAAE,aAAa;QACpB,IAAI,EAAE,6CAA6C;QACnD,OAAO,EAAE,WAAW;QACpB,IAAI,EAAE,CAAC,qBAAqB,CAAC;QAC7B,OAAO,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,QAAQ,EAAE;QACjD,UAAU,EAAE,yCAAyC;QACrD,GAAG,EAAE;YACH,OAAO,EAAE,OAAO;YAChB,KAAK,EAAE,kBAAkB;YACzB,UAAU,EAAE,iCAAiC;SAC9C;QACD,SAAS,EAAE,CAAC,SAAS,CAAC;QACtB,QAAQ,EAAE;YACR;gBACE,OAAO,EAAE,OAAO;gBAChB,KAAK,EAAE,WAAW;gBAClB,cAAc,EAAE,CAAC,YAAY,EAAE,QAAQ,CAAC;gBACxC,IAAI,EAAE,uCAAuC;aAC9C;SACF;QACD,KAAK,EAAE;YACL,OAAO,EAAE,WAAW;YACpB,IAAI,EAAE,CAAC,OAAO,CAAC;YACf,IAAI,EAAE,qBAAqB;YAC3B,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,OAAO,EAAE,QAAQ,CAAC,EAAE;SACvD;QACD,WAAW,EAAE,KAAK;QAClB,wCAAwC;QACxC,UAAU,EAAE,IAAI;KACjB;IACD;QACE,EAAE,EAAE,UAAU;QACd,SAAS,EAAE,cAAc;QACzB,IAAI,EAAE,UAAU;QAChB,KAAK,EAAE,UAAU;QACjB,IAAI,EAAE,wBAAwB;QAC9B,OAAO,EAAE,UAAU;QACnB,IAAI,EAAE,CAAC,KAAK,CAAC;QACb,SAAS,EAAE,CAAC,WAAW,CAAC;QACxB,WAAW,EAAE,4CAA4C;QACzD,UAAU,EAAE,2BAA2B;QACvC,GAAG,EAAE,EAAE,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,2BAA2B,EAAE;QAC5F,cAAc,EAAE,IAAI;QACpB,WAAW,EAAE,IAAI;KAClB;IACD;QACE,EAAE,EAAE,QAAQ;QACZ,SAAS,EAAE,YAAY;QACvB,IAAI,EAAE,YAAY;QAClB,KAAK,EAAE,YAAY;QACnB,IAAI,EAAE,yBAAyB;QAC/B,OAAO,EAAE,QAAQ;QACjB,IAAI,EAAE,CAAC,OAAO,CAAC;QACf,SAAS,EAAE,CAAC,WAAW,CAAC;QACxB,WAAW,EAAE,6BAA6B;QAC1C,UAAU,EAAE,6CAA6C;QACzD,GAAG,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,6CAA6C,EAAE;QAC1G,cAAc,EAAE,IAAI;KACrB;IACD;QACE,EAAE,EAAE,SAAS;QACb,SAAS,EAAE,aAAa;QACxB,IAAI,EAAE,oBAAoB;QAC1B,KAAK,EAAE,oBAAoB;QAC3B,IAAI,EAAE,uBAAuB;QAC7B,OAAO,EAAE,SAAS;QAClB,IAAI,EAAE,CAAC,OAAO,EAAE,SAAS,CAAC;QAC1B,SAAS,EAAE,CAAC,WAAW,CAAC;QACxB,WAAW,EAAE,8BAA8B;QAC3C,UAAU,EAAE,uEAAuE;QACnF,GAAG,EAAE;YACH,OAAO,EAAE,SAAS;YAClB,KAAK,EAAE,oBAAoB;YAC3B,UAAU,EAAE,uEAAuE;SACpF;QACD,cAAc,EAAE,IAAI;KACrB;IACD;QACE,EAAE,EAAE,QAAQ;QACZ,SAAS,EAAE,YAAY;QACvB,IAAI,EAAE,YAAY;QAClB,KAAK,EAAE,YAAY;QACnB,IAAI,EAAE,kCAAkC;QACxC,OAAO,EAAE,cAAc;QACvB,IAAI,EAAE,CAAC,KAAK,CAAC;QACb,SAAS,EAAE,CAAC,WAAW,CAAC;QACxB,WAAW,EAAE,gCAAgC;QAC7C,UAAU,EAAE,wBAAwB;QACpC,GAAG,EAAE,EAAE,OAAO,EAAE,cAAc,EAAE,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,wBAAwB,EAAE;QAC3F,cAAc,EAAE,IAAI;KACrB;IACD;QACE,EAAE,EAAE,OAAO;QACX,SAAS,EAAE,WAAW;QACtB,IAAI,EAAE,OAAO;QACb,KAAK,EAAE,OAAO;QACd,IAAI,EAAE,qBAAqB;QAC3B,OAAO,EAAE,OAAO;QAChB,IAAI,EAAE,CAAC,KAAK,CAAC;QACb,SAAS,EAAE,CAAC,WAAW,CAAC;QACxB,WAAW,EAAE,gDAAgD;QAC7D,UAAU,EAAE,iEAAiE;QAC7E,GAAG,EAAE;YACH,OAAO,EAAE,OAAO;YAChB,KAAK,EAAE,WAAW;YAClB,UAAU,EAAE,iEAAiE;SAC9E;QACD,cAAc,EAAE,IAAI;KACrB;CACF,CAAA;AAED,oCAAoC;AACpC,MAAM,UAAU,UAAU,CAAC,aAAqB;IAC9C,MAAM,KAAK,GAAG,aAAa,CAAC,IAAI,EAAE,CAAA;IAClC,OAAO,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,KAAK,KAAK,IAAI,KAAK,CAAC,SAAS,KAAK,KAAK,CAAC,CAAA;AAClF,CAAC;AAED,0CAA0C;AAC1C,MAAM,UAAU,cAAc,CAAC,EAAU;IACvC,MAAM,KAAK,GAAG,EAAE,CAAC,IAAI,EAAE,CAAA;IACvB,OAAO,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,SAAS,KAAK,KAAK,CAAC,CAAA;AAC5D,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,wBAAwB,CAAC,EAAU;IACjD,MAAM,KAAK,GAAG,EAAE,CAAC,IAAI,EAAE,CAAA;IACvB,OAAO,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,SAAS,KAAK,KAAK,IAAI,KAAK,CAAC,UAAU,KAAK,IAAI,CAAC,CAAA;AACzF,CAAC;AAED,2CAA2C;AAC3C,MAAM,UAAU,cAAc,CAAC,aAAqB;IAClD,OAAO,UAAU,CAAC,aAAa,CAAC,EAAE,SAAS,IAAI,IAAI,CAAA;AACrD,CAAC"}

package/dist/runtimes/acp-detect-utils.d.ts

@@ -0,0 +1,4 @@
+/** 在 PATH 里解析命令；支持 Windows 的 PATHEXT。返回绝对路径。 */
+export declare function resolveExecutable(command: string, env: NodeJS.ProcessEnv): string | undefined;
+/** 从 `--version` 输出里提取 x.y.z；找不到返回 undefined。 */
+export declare function parseVersion(text: string): string | undefined;

package/dist/runtimes/acp-detect-utils.js

@@ -0,0 +1,35 @@
+/**
+ * 运行时共用的可执行文件解析与版本提取（纯函数，不 spawn）。
+ * ACP 插件与其它运行时插件都从这里取同一份语义。
+ */
+import { existsSync } from 'node:fs';
+import { delimiter, isAbsolute, join } from 'node:path';
+/** 在 PATH 里解析命令；支持 Windows 的 PATHEXT。返回绝对路径。 */
+export function resolveExecutable(command, env) {
+    const value = command.trim();
+    if (!value)
+        return undefined;
+    if (isAbsolute(value) || value.includes('/') || value.includes('\\')) {
+        return existsSync(value) ? value : undefined;
+    }
+    const pathValue = env.PATH ?? env.Path ?? '';
+    const extensions = process.platform === 'win32'
+        ? ['', '.cmd', '.exe', '.bat']
+        : [''];
+    for (const dir of pathValue.split(delimiter)) {
+        if (!dir)
+            continue;
+        for (const ext of extensions) {
+            const candidate = join(dir, `${value}${ext}`);
+            if (existsSync(candidate))
+                return candidate;
+        }
+    }
+    return undefined;
+}
+/** 从 `--version` 输出里提取 x.y.z；找不到返回 undefined。 */
+export function parseVersion(text) {
+    const match = /(\d+\.\d+\.\d+(?:[-+][\w.-]+)?)/.exec(text);
+    return match?.[1];
+}
+//# sourceMappingURL=acp-detect-utils.js.map

package/dist/runtimes/acp-detect-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"acp-detect-utils.js","sourceRoot":"","sources":["../../../../../packages/runtime/src/runtimes/acp-detect-utils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AACpC,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAEvD,gDAAgD;AAChD,MAAM,UAAU,iBAAiB,CAAC,OAAe,EAAE,GAAsB;IACvE,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,EAAE,CAAA;IAC5B,IAAI,CAAC,KAAK;QAAE,OAAO,SAAS,CAAA;IAC5B,IAAI,UAAU,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACrE,OAAO,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAA;IAC9C,CAAC;IACD,MAAM,SAAS,GAAG,GAAG,CAAC,IAAI,IAAI,GAAG,CAAC,IAAI,IAAI,EAAE,CAAA;IAC5C,MAAM,UAAU,GAAG,OAAO,CAAC,QAAQ,KAAK,OAAO;QAC7C,CAAC,CAAC,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;QAC9B,CAAC,CAAC,CAAC,EAAE,CAAC,CAAA;IACR,KAAK,MAAM,GAAG,IAAI,SAAS,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC;QAC7C,IAAI,CAAC,GAAG;YAAE,SAAQ;QAClB,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;YAC7B,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,GAAG,GAAG,EAAE,CAAC,CAAA;YAC7C,IAAI,UAAU,CAAC,SAAS,CAAC;gBAAE,OAAO,SAAS,CAAA;QAC7C,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAA;AAClB,CAAC;AAED,iDAAiD;AACjD,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,MAAM,KAAK,GAAG,iCAAiC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAC1D,OAAO,KAAK,EAAE,CAAC,CAAC,CAAC,CAAA;AACnB,CAAC"}

package/dist/runtimes/builtin-options.d.ts

@@ -0,0 +1,3 @@
+import type { RuntimeOptionSpec } from './options.js';
+export declare const ORCA_OPTION_SPEC: RuntimeOptionSpec;
+export declare const HERDR_OPTION_SPEC: RuntimeOptionSpec;

package/dist/runtimes/builtin-options.js

@@ -0,0 +1,44 @@
+export const ORCA_OPTION_SPEC = {
+    runtimeId: 'orca',
+    fields: [
+        {
+            key: 'agent',
+            label: '执行 Agent',
+            kind: 'select',
+            default: 'claude',
+            options: [
+                { value: 'claude', label: 'claude · Claude Code' },
+                { value: 'codex', label: 'codex · Codex' },
+                { value: 'opencode', label: 'opencode · OpenCode' },
+                { value: 'devin', label: 'devin · Devin' },
+                { value: 'antigravity', label: 'antigravity · Antigravity' },
+            ],
+            hint: 'Orca 在工单 worktree 里启动哪个 Agent；默认 Claude Code',
+        },
+    ],
+};
+export const HERDR_OPTION_SPEC = {
+    runtimeId: 'herdr',
+    fields: [
+        {
+            key: 'agent',
+            label: '执行 Agent',
+            kind: 'select',
+            default: 'claude',
+            options: [
+                { value: 'claude', label: 'claude · Claude Code' },
+                { value: 'codex', label: 'codex · Codex' },
+                { value: 'opencode', label: 'opencode · OpenCode' },
+            ],
+            hint: 'Herdr 在工单 worktree 里启动哪个 Agent；默认 Claude Code',
+        },
+        {
+            key: 'model',
+            label: '模型',
+            kind: 'text',
+            placeholder: '留空则用 Agent 自己的默认模型',
+            hint: '传给 Agent 的模型名；不同 Agent 的参数名由 adapter 自己映射',
+        },
+    ],
+};
+//# sourceMappingURL=builtin-options.js.map

package/dist/runtimes/builtin-options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"builtin-options.js","sourceRoot":"","sources":["../../../../../packages/runtime/src/runtimes/builtin-options.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,gBAAgB,GAAsB;IACjD,SAAS,EAAE,MAAM;IACjB,MAAM,EAAE;QACN;YACE,GAAG,EAAE,OAAO;YACZ,KAAK,EAAE,UAAU;YACjB,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE,QAAQ;YACjB,OAAO,EAAE;gBACP,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,sBAAsB,EAAE;gBAClD,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,eAAe,EAAE;gBAC1C,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,qBAAqB,EAAE;gBACnD,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,eAAe,EAAE;gBAC1C,EAAE,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,2BAA2B,EAAE;aAC7D;YACD,IAAI,EAAE,8CAA8C;SACrD;KACF;CACF,CAAA;AAED,MAAM,CAAC,MAAM,iBAAiB,GAAsB;IAClD,SAAS,EAAE,OAAO;IAClB,MAAM,EAAE;QACN;YACE,GAAG,EAAE,OAAO;YACZ,KAAK,EAAE,UAAU;YACjB,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE,QAAQ;YACjB,OAAO,EAAE;gBACP,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,sBAAsB,EAAE;gBAClD,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,eAAe,EAAE;gBAC1C,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,qBAAqB,EAAE;aACpD;YACD,IAAI,EAAE,+CAA+C;SACtD;QACD;YACE,GAAG,EAAE,OAAO;YACZ,KAAK,EAAE,IAAI;YACX,IAAI,EAAE,MAAM;YACZ,WAAW,EAAE,oBAAoB;YACjC,IAAI,EAAE,2CAA2C;SAClD;KACF;CACF,CAAA"}

package/dist/runtimes/catalog.d.ts

@@ -0,0 +1,31 @@
+export declare const ORCA_RUNTIME_ID = "orca";
+export declare const CLAUDE_CODE_RUNTIME_ID = "claude-code";
+export declare const ACP_RUNTIME_ID = "acp";
+export declare const CODEX_APP_RUNTIME_ID = "codex-app";
+export declare const HERDR_RUNTIME_ID = "herdr";
+export interface WorkerRuntimeMeta {
+    id: string;
+    /** 产品名（自然大小写）；Web 面板按首字母大写展示，CLI 与文档保持原样。 */
+    name: string;
+    label: string;
+    hint: string;
+    /** 不能由 ra 自动安装时的界面引导文案。 */
+    installHint?: string;
+    /** CLI 的官方安装/下载页；Web 卡片直接跳转，不再展示易变的安装命令。 */
+    installUrl?: string;
+}
+export declare const WORKER_RUNTIMES: readonly WorkerRuntimeMeta[];
+export declare const WORKER_RUNTIME_IDS: readonly string[];
+/** 兼容旧配置与旧工单：claude-cli 已改名为 claude-code。 */
+export declare const LEGACY_CLAUDE_CODE_RUNTIME_ID = "claude-cli";
+export declare const LEGACY_RUNTIME_IDS: Readonly<Record<string, string>>;
+/** 把历史 runtime id 归一成当前 id；未知 id 原样返回，交给注册表报错。 */
+export declare function normalizeRuntimeId(id: string): string;
+/**
+ * 是否是已知的 worker runtime id。
+ *
+ * 包含内置运行时（orca / claude-code / codex-app / acp）和 ACP 目录里的动态运行时
+ * （acp-claude / acp-codex / ...）。未知值让配置校验直接拒绝，避免拼错后
+ * 启动期才炸。
+ */
+export declare function isWorkerRuntimeId(id: string): boolean;

package/dist/runtimes/catalog.js

@@ -0,0 +1,75 @@
+/**
+ * Worker 运行时清单：配置校验、Web 面板下拉、CLI 提示共用这一份。
+ *
+ * 这里只放纯常量，不能依赖任何 Node 内置模块 —— Web 面板会把它一起打进前端包。
+ */
+import { ACP_AGENTS } from './acp-agents.js';
+export const ORCA_RUNTIME_ID = 'orca';
+export const CLAUDE_CODE_RUNTIME_ID = 'claude-code';
+export const ACP_RUNTIME_ID = 'acp';
+export const CODEX_APP_RUNTIME_ID = 'codex-app';
+export const HERDR_RUNTIME_ID = 'herdr';
+export const WORKER_RUNTIMES = [
+    {
+        id: ORCA_RUNTIME_ID,
+        name: 'Orca',
+        label: 'orca · Orca worktree + 终端',
+        hint: '通过 Orca 创建 worktree 并启动 Agent 终端（默认跟随 Orca 配置），交互与状态读取走 Orca',
+        installHint: '从 Orca 官方发布页下载安装，并确保 orca CLI 在 PATH 中',
+        installUrl: 'https://github.com/stablyai/orca/releases',
+    },
+    {
+        id: CLAUDE_CODE_RUNTIME_ID,
+        name: 'Claude Code',
+        label: 'claude-code · git worktree + claude --bg',
+        hint: '直接调用 Claude Code CLI 的后台会话；项目 repo 需要填本地仓库绝对路径',
+        installHint: '参考 Claude Code 官方安装说明',
+        installUrl: 'https://docs.claude.com/en/docs/claude-code/setup',
+    },
+    {
+        id: CODEX_APP_RUNTIME_ID,
+        name: 'Codex App',
+        label: 'codex-app · Codex App Server',
+        hint: '直连 Codex App Server；优先使用 Codex App 内置 CLI，桌面端可见同一 thread',
+        installHint: '安装 Codex App（macOS/Windows）或 Codex CLI；ra 会优先使用 Codex App 内置的版本',
+        installUrl: 'https://chatgpt.com/codex',
+    },
+    {
+        id: ACP_RUNTIME_ID,
+        name: 'ACP',
+        label: 'acp · 任意 ACP Agent',
+        hint: '通过 ACP 协议接入其它 Agent；启用前需要在 runtime.options.acp 配置 command',
+        installHint: '在 config.yaml 的 runtime.options.acp 下配置 command 与 args，然后重启服务',
+    },
+    {
+        id: HERDR_RUNTIME_ID,
+        name: 'Herdr',
+        label: 'herdr · git worktree + Herdr 终端',
+        hint: '检出由 ra 用 git worktree 建，Herdr 只开终端窗口跑 Agent；状态来自 Herdr 的 Agent 检测',
+        installHint: '从 Herdr 官方发布页下载安装，并确保 herdr CLI 在 PATH 中',
+        installUrl: 'https://github.com/herdrdev/herdr/releases',
+    },
+];
+export const WORKER_RUNTIME_IDS = WORKER_RUNTIMES.map(runtime => runtime.id);
+/** 兼容旧配置与旧工单：claude-cli 已改名为 claude-code。 */
+export const LEGACY_CLAUDE_CODE_RUNTIME_ID = 'claude-cli';
+export const LEGACY_RUNTIME_IDS = {
+    [LEGACY_CLAUDE_CODE_RUNTIME_ID]: CLAUDE_CODE_RUNTIME_ID,
+};
+/** 把历史 runtime id 归一成当前 id；未知 id 原样返回，交给注册表报错。 */
+export function normalizeRuntimeId(id) {
+    const value = id.trim();
+    return LEGACY_RUNTIME_IDS[value] ?? value;
+}
+/**
+ * 是否是已知的 worker runtime id。
+ *
+ * 包含内置运行时（orca / claude-code / codex-app / acp）和 ACP 目录里的动态运行时
+ * （acp-claude / acp-codex / ...）。未知值让配置校验直接拒绝，避免拼错后
+ * 启动期才炸。
+ */
+export function isWorkerRuntimeId(id) {
+    const value = normalizeRuntimeId(id);
+    return WORKER_RUNTIME_IDS.includes(value) || ACP_AGENTS.some(agent => agent.runtimeId === value);
+}
+//# sourceMappingURL=catalog.js.map

package/dist/runtimes/catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.js","sourceRoot":"","sources":["../../../../../packages/runtime/src/runtimes/catalog.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAE5C,MAAM,CAAC,MAAM,eAAe,GAAG,MAAM,CAAA;AACrC,MAAM,CAAC,MAAM,sBAAsB,GAAG,aAAa,CAAA;AACnD,MAAM,CAAC,MAAM,cAAc,GAAG,KAAK,CAAA;AACnC,MAAM,CAAC,MAAM,oBAAoB,GAAG,WAAW,CAAA;AAC/C,MAAM,CAAC,MAAM,gBAAgB,GAAG,OAAO,CAAA;AAcvC,MAAM,CAAC,MAAM,eAAe,GAAiC;IAC3D;QACE,EAAE,EAAE,eAAe;QACnB,IAAI,EAAE,MAAM;QACZ,KAAK,EAAE,2BAA2B;QAClC,IAAI,EAAE,8DAA8D;QACpE,WAAW,EAAE,wCAAwC;QACrD,UAAU,EAAE,2CAA2C;KACxD;IACD;QACE,EAAE,EAAE,sBAAsB;QAC1B,IAAI,EAAE,aAAa;QACnB,KAAK,EAAE,0CAA0C;QACjD,IAAI,EAAE,gDAAgD;QACtD,WAAW,EAAE,uBAAuB;QACpC,UAAU,EAAE,mDAAmD;KAChE;IACD;QACE,EAAE,EAAE,oBAAoB;QACxB,IAAI,EAAE,WAAW;QACjB,KAAK,EAAE,8BAA8B;QACrC,IAAI,EAAE,0DAA0D;QAChE,WAAW,EAAE,iEAAiE;QAC9E,UAAU,EAAE,2BAA2B;KACxC;IACD;QACE,EAAE,EAAE,cAAc;QAClB,IAAI,EAAE,KAAK;QACX,KAAK,EAAE,oBAAoB;QAC3B,IAAI,EAAE,2DAA2D;QACjE,WAAW,EAAE,+DAA+D;KAC7E;IACD;QACE,EAAE,EAAE,gBAAgB;QACpB,IAAI,EAAE,OAAO;QACb,KAAK,EAAE,iCAAiC;QACxC,IAAI,EAAE,mEAAmE;QACzE,WAAW,EAAE,0CAA0C;QACvD,UAAU,EAAE,4CAA4C;KACzD;CACF,CAAA;AAED,MAAM,CAAC,MAAM,kBAAkB,GAAsB,eAAe,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAA;AAE/F,6CAA6C;AAC7C,MAAM,CAAC,MAAM,6BAA6B,GAAG,YAAY,CAAA;AAEzD,MAAM,CAAC,MAAM,kBAAkB,GAAqC;IAClE,CAAC,6BAA6B,CAAC,EAAE,sBAAsB;CACxD,CAAA;AAED,kDAAkD;AAClD,MAAM,UAAU,kBAAkB,CAAC,EAAU;IAC3C,MAAM,KAAK,GAAG,EAAE,CAAC,IAAI,EAAE,CAAA;IACvB,OAAO,kBAAkB,CAAC,KAAK,CAAC,IAAI,KAAK,CAAA;AAC3C,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAAC,EAAU;IAC1C,MAAM,KAAK,GAAG,kBAAkB,CAAC,EAAE,CAAC,CAAA;IACpC,OAAO,kBAAkB,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,SAAS,KAAK,KAAK,CAAC,CAAA;AAClG,CAAC"}