@router-agent/runtime 0.0.0-stage → 0.3.32

package/dist/registry.js

@@ -0,0 +1,35 @@
+import { WorkerRuntimeError } from './port.js';
+import { normalizeRuntimeId } from './runtimes/catalog.js';
+/** 按 id 持有运行时；内核只通过它取运行时，不直接 new OrcaRuntime。 */
+export class RuntimeRegistry {
+    runtimes;
+    defaultId;
+    constructor(runtimes, defaultId) {
+        this.runtimes = runtimes;
+        // 默认值可能来自旧配置（claude-cli），先归一再校验。
+        this.defaultId = normalizeRuntimeId(defaultId);
+        if (!runtimes.has(this.defaultId)) {
+            throw new WorkerRuntimeError('runtime:unknown', `默认 runtime 未注册: ${this.defaultId}`);
+        }
+    }
+    get(id) {
+        const runtime = this.runtimes.get(normalizeRuntimeId(id));
+        if (!runtime)
+            throw new WorkerRuntimeError('runtime:unknown', `未知 runtime: ${id}`);
+        return runtime;
+    }
+    has(id) {
+        return this.runtimes.has(normalizeRuntimeId(id));
+    }
+    ids() {
+        return [...this.runtimes.keys()];
+    }
+    default() {
+        return this.get(this.defaultId);
+    }
+}
+/** 用插件创建好的 adapter 组装注册表；插件发现与加载由 plugins/loader 负责。 */
+export function createRuntimes(runtimes, defaultId) {
+    return new RuntimeRegistry(new Map([...runtimes].map(runtime => [runtime.id, runtime])), defaultId);
+}
+//# sourceMappingURL=registry.js.map

package/dist/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../../packages/runtime/src/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAsB,MAAM,WAAW,CAAA;AAClE,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAA;AAC1D,iDAAiD;AACjD,MAAM,OAAO,eAAe;IAIP;IAHF,SAAS,CAAQ;IAElC,YACmB,QAAoC,EACrD,SAAiB;QADA,aAAQ,GAAR,QAAQ,CAA4B;QAGrD,iCAAiC;QACjC,IAAI,CAAC,SAAS,GAAG,kBAAkB,CAAC,SAAS,CAAC,CAAA;QAC9C,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;YAClC,MAAM,IAAI,kBAAkB,CAAC,iBAAiB,EAAE,mBAAmB,IAAI,CAAC,SAAS,EAAE,CAAC,CAAA;QACtF,CAAC;IACH,CAAC;IAED,GAAG,CAAC,EAAU;QACZ,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,kBAAkB,CAAC,EAAE,CAAC,CAAC,CAAA;QACzD,IAAI,CAAC,OAAO;YAAE,MAAM,IAAI,kBAAkB,CAAC,iBAAiB,EAAE,eAAe,EAAE,EAAE,CAAC,CAAA;QAClF,OAAO,OAAO,CAAA;IAChB,CAAC;IAED,GAAG,CAAC,EAAU;QACZ,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,kBAAkB,CAAC,EAAE,CAAC,CAAC,CAAA;IAClD,CAAC;IAED,GAAG;QACD,OAAO,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAA;IAClC,CAAC;IAED,OAAO;QACL,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;IACjC,CAAC;CACF;AAED,wDAAwD;AACxD,MAAM,UAAU,cAAc,CAAC,QAAiC,EAAE,SAAiB;IACjF,OAAO,IAAI,eAAe,CAAC,IAAI,GAAG,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,SAAS,CAAC,CAAA;AACrG,CAAC"}

package/dist/report-poller.d.ts

@@ -0,0 +1,58 @@
+import type { ReportState } from '@router-agent/core/model.js';
+export interface WorkerStateFile {
+    ticketId: string;
+    assignmentId: string;
+    turn: number;
+    state: ReportState;
+    summary: string;
+    humanAction?: string;
+    prNumber: number;
+    prUrl: string;
+    /** Worker 显式声明是否改了 UI；缺省时由 Router 按改动文件推断。 */
+    uiChange?: boolean;
+    reply?: string;
+    ackedInputs: string[];
+    updatedAt: string;
+}
+export interface WorkerMeta {
+    ticketId: string;
+    assignmentId: string;
+    handle: string;
+    workdir: string;
+    /** 运行时 id；ACP / Claude Code 会写入。 */
+    runtime?: string;
+    /** 底层 Agent 的真实会话 id；用于人工恢复。 */
+    sessionId?: string;
+    repo?: string;
+    [key: string]: unknown;
+}
+export interface PolledState {
+    state: WorkerStateFile;
+    meta: WorkerMeta | null;
+    mtimeMs: number;
+}
+export interface ReportPollerOptions {
+    workersDir: string;
+    onState: (state: WorkerStateFile, meta: WorkerMeta | null, path: string) => void;
+    onError?: (ticketId: string, error: Error) => void;
+}
+/** 轮询 ~/.router-agent/workers/<ticketId>/state.json，按文件内容增量上报。 */
+export declare class ReportPoller {
+    private workersDir;
+    private onState;
+    private onError?;
+    private seen;
+    constructor(opts: ReportPollerOptions);
+    /** 扫描一轮，返回新上报数量。 */
+    scan(): number;
+    /** 清空基线，让下一轮重新上报（Router 重启对账时用）。 */
+    reset(): void;
+}
+export declare function parseStateFile(content: string, expectedTicketId?: string): {
+    ticketId: string;
+    state: WorkerStateFile;
+};
+/** 读取 worker 的 meta.json；供报告轮询与恢复命令共用。 */
+export declare function readWorkerMeta(workersDir: string, ticketId: string): WorkerMeta | null;
+/** 追加一条审计事件到 events.log。 */
+export declare function appendEvent(path: string, event: Record<string, unknown>): void;

package/dist/report-poller.js

@@ -0,0 +1,130 @@
+import { appendFileSync, existsSync, mkdirSync, readdirSync, readFileSync, statSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { z } from 'zod';
+/** 旧版 state.json 的交付物字段，仅用于向后兼容，不再参与新协议。 */
+const LegacyDeliverableSchema = z.object({
+    kind: z.string().optional(),
+    content: z.string().default(''),
+    title: z.string().optional(),
+    url: z.string().default(''),
+}).nullable().optional();
+const StateSchema = z.object({
+    ticket_id: z.string().min(1),
+    assignment_id: z.string().default(''),
+    turn: z.coerce.number().int().min(0).default(0),
+    state: z.enum(['progress', 'ready', 'blocked', 'failed', 'dropped', 'waiting']),
+    summary: z.string().min(1),
+    human_action: z.string().nullable().optional(),
+    pr_number: z.coerce.number().int().min(0).default(0),
+    pr_url: z.string().default(''),
+    /** Worker 显式声明是否改了 UI；缺省时由 Router 按改动文件推断。 */
+    ui_change: z.boolean().optional(),
+    /** Worker 要发给发起人的完整回复（Markdown）。 */
+    reply: z.string().optional().default(''),
+    /** 旧版交付物字段，读取时拼进 reply。 */
+    deliverable: LegacyDeliverableSchema,
+    acked_inputs: z.array(z.string()).default([]),
+    updated_at: z.string().default(() => new Date().toISOString()),
+});
+/** 轮询 ~/.router-agent/workers/<ticketId>/state.json，按文件内容增量上报。 */
+export class ReportPoller {
+    workersDir;
+    onState;
+    onError;
+    seen = new Map();
+    constructor(opts) {
+        this.workersDir = opts.workersDir;
+        this.onState = opts.onState;
+        this.onError = opts.onError;
+    }
+    /** 扫描一轮，返回新上报数量。 */
+    scan() {
+        if (!existsSync(this.workersDir))
+            return 0;
+        let count = 0;
+        const entries = readdirSync(this.workersDir, { withFileTypes: true });
+        for (const entry of entries) {
+            if (!entry.isDirectory())
+                continue;
+            const ticketId = entry.name;
+            const statePath = join(this.workersDir, ticketId, 'state.json');
+            if (!existsSync(statePath))
+                continue;
+            try {
+                const content = readFileSync(statePath, 'utf8');
+                const fingerprint = `${statSync(statePath).mtimeMs}:${content}`;
+                if (this.seen.get(ticketId) === fingerprint)
+                    continue;
+                const { ticketId: parsedId, state } = parseStateFile(content, ticketId);
+                this.seen.set(ticketId, fingerprint);
+                const meta = readWorkerMeta(this.workersDir, ticketId);
+                this.onState({ ...state, ticketId: parsedId }, meta, statePath);
+                count += 1;
+            }
+            catch (error) {
+                this.onError?.(ticketId, error instanceof Error ? error : new Error(String(error)));
+            }
+        }
+        return count;
+    }
+    /** 清空基线，让下一轮重新上报（Router 重启对账时用）。 */
+    reset() {
+        this.seen.clear();
+    }
+}
+export function parseStateFile(content, expectedTicketId) {
+    let json;
+    try {
+        json = JSON.parse(content);
+    }
+    catch {
+        throw new Error('state:invalid-json');
+    }
+    const parsed = StateSchema.safeParse(json);
+    if (!parsed.success)
+        throw new Error(`state:invalid: ${parsed.error.issues.map(i => i.path.join('.')).join(',')}`);
+    if (expectedTicketId && parsed.data.ticket_id !== expectedTicketId) {
+        throw new Error(`state:ticket-mismatch: 目录 ${expectedTicketId} 收到 ${parsed.data.ticket_id}`);
+    }
+    const data = parsed.data;
+    const legacy = data.deliverable;
+    // 旧版 deliverable 升级成纯回复：正文 + 链接，不再保留 kind。
+    const reply = data.reply.trim() || [legacy?.content?.trim(), legacy?.url?.trim()].filter(Boolean).join('\n\n');
+    return {
+        ticketId: data.ticket_id,
+        state: {
+            ticketId: data.ticket_id,
+            assignmentId: data.assignment_id,
+            turn: data.turn,
+            state: data.state,
+            summary: data.summary,
+            ...(data.human_action ? { humanAction: data.human_action } : {}),
+            prNumber: data.pr_number,
+            prUrl: data.pr_url,
+            ...(data.ui_change !== undefined ? { uiChange: data.ui_change } : {}),
+            ...(reply ? { reply } : {}),
+            ackedInputs: data.acked_inputs,
+            updatedAt: data.updated_at,
+        },
+    };
+}
+/** 读取 worker 的 meta.json；供报告轮询与恢复命令共用。 */
+export function readWorkerMeta(workersDir, ticketId) {
+    const path = join(workersDir, ticketId, 'meta.json');
+    if (!existsSync(path))
+        return null;
+    try {
+        return JSON.parse(readFileSync(path, 'utf8'));
+    }
+    catch {
+        return null;
+    }
+}
+/** 追加一条审计事件到 events.log。 */
+export function appendEvent(path, event) {
+    mkdirSync(join(path, '..'), { recursive: true });
+    if (!existsSync(path))
+        writeFileSync(path, '', 'utf8');
+    appendFileSync(path, `${JSON.stringify(event)}\n`, 'utf8');
+}
+//# sourceMappingURL=report-poller.js.map

package/dist/report-poller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"report-poller.js","sourceRoot":"","sources":["../../../../packages/runtime/src/report-poller.ts"],"names":[],"mappings":"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"}

package/dist/resume.d.ts

@@ -0,0 +1,52 @@
+/**
+ * 人工恢复命令的拼装与运行时映射。
+ *
+ * 恢复命令只依赖三件事：工作目录、底层 Agent 的真实 session id、该 Agent 的 CLI
+ * 语法。这里用一张静态表把这些知识集中起来，不要求每个运行时实现额外方法。
+ * 只生成 POSIX shell（sh/bash/zsh）可执行的一行命令；动态值全部单引号转义。
+ */
+import type { ResumeHint } from './port.js';
+/** 单个运行时的 CLI 恢复模板。 */
+export interface ResumeSpec {
+    /** 有真实 sessionId 时执行的命令。 */
+    command?: string;
+    /** 有真实 sessionId 时的参数模板，支持 {sessionId}。 */
+    args?: readonly string[];
+    /** 没有 sessionId、但有运行时 handle 时的备用命令；缺省复用 command。 */
+    handleCommand?: string;
+    /** 没有 sessionId、但有运行时 handle 时的备用模板，支持 {handle}。 */
+    handleArgs?: readonly string[];
+    /** handle 兜底命令是否需要在 workdir 里执行；默认 true。Orca 的终端切换与目录无关。 */
+    handleRequiresWorkdir?: boolean;
+    /** 有 sessionId 时附加的提示。 */
+    note?: string;
+    /** 走 handle 备用模板时附加的提示。 */
+    handleNote?: string;
+}
+/** 按运行时 id 取恢复模板；未知/未核实返回 null。 */
+export declare function resumeSpecOf(runtimeId: string, agentId?: string): ResumeSpec | null;
+export interface ResumeSource {
+    workdir?: string;
+    /** 底层 Agent 的真实会话 id；优先级最高。 */
+    sessionId?: string;
+    /** 运行时自己的短句柄；没有 sessionId 时用于 attach 类命令。 */
+    handle?: string;
+    /** 由外部决定用哪个 Agent 的运行时（如 Orca）需要它来选恢复命令。 */
+    agentId?: string;
+}
+/**
+ * 根据运行时与会话信息生成恢复命令。
+ *
+ * @param workdirExists 由调用方传入，保持本模块为纯函数；false 时追加工作区提示。
+ */
+export declare function buildResumeHint(runtimeId: string, source: ResumeSource, opts?: {
+    workdirExists?: boolean;
+}): ResumeHint | null;
+/** 单引号转义；内部单引号写成 '\''。 */
+export declare function shellQuote(value: string): string;
+/**
+ * 生成 `cd <workdir> && <command> <args...>`。
+ *
+ * `command` 只应来自上面的可信常量，不作为用户输入参与转义；workdir 与参数一律转义。
+ */
+export declare function resumeCommand(workdir: string, command: string, args?: readonly string[]): string;

package/dist/resume.js

@@ -0,0 +1,109 @@
+import { CLAUDE_CODE_RUNTIME_ID, ORCA_RUNTIME_ID, normalizeRuntimeId } from './runtimes/catalog.js';
+import { agentProfileOf } from './agents/registry.js';
+/**
+ * 由 Agent 档案生成恢复模板：Agent 决定「用什么命令接回去」，
+ * 运行时只补充自己的兜底（handle 接管方式）。
+ */
+function agentResumeSpec(agentId, extra = {}) {
+    const template = agentProfileOf(agentId)?.resume;
+    const note = [template?.note, extra.note].filter(Boolean).join(' ');
+    return {
+        ...(template ? { command: template.command, args: template.args } : {}),
+        ...extra,
+        ...(note ? { note } : {}),
+    };
+}
+/**
+ * runtime id → CLI 恢复模板。
+ *
+ * 只收录已核实 session id 语义和 CLI 语法的运行时；未收录的运行时不出按钮，
+ * 避免复制出打不开正确会话的命令。
+ */
+const RESUME_SPECS = {
+    [CLAUDE_CODE_RUNTIME_ID]: agentResumeSpec('claude', {
+        handleArgs: ['attach', '{handle}'],
+        handleNote: '未读到 sessionId，改用 attach 接管后台会话。',
+    }),
+    'acp-claude': agentResumeSpec('claude'),
+    'acp-codex': agentResumeSpec('codex'),
+    'codex-app': agentResumeSpec('codex', {
+        note: '也可以在 Codex 桌面端用 codex://threads/<threadId> 打开。',
+    }),
+    'acp-opencode': agentResumeSpec('opencode'),
+};
+/**
+ * Orca 的恢复模板：用哪个 Agent 由配置决定，meta 里只有终端句柄。
+ *
+ * sessionId 由 service 按 workdir 从 Agent 自己的会话记录里补；
+ * 找不到会话记录时退回 Orca 的终端切换命令，作为最后的兜底。
+ */
+function orcaResumeSpec(agentId) {
+    const base = {
+        handleCommand: 'orca',
+        handleArgs: ['terminal', 'switch', '--terminal', '{handle}'],
+        handleRequiresWorkdir: false,
+        handleNote: '未找到 Agent 会话记录，改为在 Orca 中切回原终端。',
+    };
+    if (!agentId)
+        return base;
+    return agentResumeSpec(agentId, {
+        ...base,
+        note: '按工作目录定位到的 Agent 会话恢复；接回的是普通终端会话，不再由 Orca 托管。',
+    });
+}
+/** 按运行时 id 取恢复模板；未知/未核实返回 null。 */
+export function resumeSpecOf(runtimeId, agentId) {
+    const id = normalizeRuntimeId(runtimeId.trim());
+    if (id === ORCA_RUNTIME_ID)
+        return orcaResumeSpec(agentId);
+    return RESUME_SPECS[id] ?? null;
+}
+/**
+ * 根据运行时与会话信息生成恢复命令。
+ *
+ * @param workdirExists 由调用方传入，保持本模块为纯函数；false 时追加工作区提示。
+ */
+export function buildResumeHint(runtimeId, source, opts = {}) {
+    const spec = resumeSpecOf(runtimeId, source.agentId);
+    if (!spec || !source.workdir)
+        return null;
+    const useSession = Boolean(spec.command && spec.args && source.sessionId);
+    // 没有单独的 handle 命令时，沿用 session 命令（例如 claude attach <handle>）。
+    const handleCommand = spec.handleCommand ?? spec.command;
+    const useHandle = !useSession && Boolean(handleCommand && spec.handleArgs && source.handle);
+    if (!useSession && !useHandle)
+        return null;
+    const template = (useSession ? spec.args : spec.handleArgs);
+    const args = template.map(arg => arg
+        .replaceAll('{sessionId}', source.sessionId ?? '')
+        .replaceAll('{handle}', source.handle ?? ''));
+    const command = useSession ? spec.command : handleCommand;
+    const requiresWorkdir = useSession || (spec.handleRequiresWorkdir ?? true);
+    const note = [
+        useSession ? spec.note : spec.handleNote,
+        opts.workdirExists === false ? '工作目录已不存在，请先恢复 worktree 再执行。' : undefined,
+    ].filter((item) => Boolean(item)).join(' ');
+    return {
+        command: requiresWorkdir ? resumeCommand(source.workdir, command, args) : commandLine(command, args),
+        ...(useSession && source.sessionId ? { sessionId: source.sessionId } : {}),
+        ...(note ? { note } : {}),
+    };
+}
+/** 单引号转义；内部单引号写成 '\''。 */
+export function shellQuote(value) {
+    return `'${value.replace(/'/g, "'\\''")}'`;
+}
+/**
+ * 生成 `cd <workdir> && <command> <args...>`。
+ *
+ * `command` 只应来自上面的可信常量，不作为用户输入参与转义；workdir 与参数一律转义。
+ */
+export function resumeCommand(workdir, command, args = []) {
+    return `cd ${shellQuote(workdir)} && ${commandLine(command, args)}`;
+}
+/** 不带 cd 的一行命令；参数逐个转义。 */
+function commandLine(command, args = []) {
+    const tail = args.map(shellQuote).join(' ');
+    return `${command}${tail ? ` ${tail}` : ''}`;
+}
+//# sourceMappingURL=resume.js.map

package/dist/resume.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resume.js","sourceRoot":"","sources":["../../../../packages/runtime/src/resume.ts"],"names":[],"mappings":"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"}

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