@router-agent/runtime 0.0.0-stage → 0.3.31

package/dist/orca/report-poller.js

@@ -0,0 +1,143 @@
+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 要发给发起人的完整回复（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 = readMeta(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,
+            ...(reply ? { reply } : {}),
+            ackedInputs: data.acked_inputs,
+            updatedAt: data.updated_at,
+        },
+    };
+}
+function readMeta(workersDir, ticketId) {
+    const path = join(workersDir, ticketId, 'meta.json');
+    if (!existsSync(path))
+        return null;
+    try {
+        return JSON.parse(readFileSync(path, 'utf8'));
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * 基于 Orca 的结构化字段判定终端状态，绝不解析 TUI 屏幕文本。
+ */
+export function judgeIdle(input) {
+    const { info, turn, lastTurn, now, idleAfterMs } = input;
+    if (!info)
+        return 'unknown';
+    if (!info.connected)
+        return 'dead';
+    // 实测：CLI 创建的终端可能 orphaned=true 但依然 connected+writable，不能直接判死。
+    if (info.orphaned && !info.writable)
+        return 'orphaned';
+    const lastOutput = Date.parse(info.lastOutputAt);
+    if (Number.isFinite(lastOutput) && now - lastOutput > idleAfterMs && turn <= lastTurn)
+        return 'idle';
+    return 'active';
+}
+/** 追加一条审计事件到 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/orca/report-poller.js.map

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

package/dist/permissions/acp.d.ts

@@ -0,0 +1,21 @@
+import type { ToolPolicy } from '../port.js';
+/** ACP 的 ToolKind 取值（允许后端扩展，未知值按 other 处理）。 */
+export type AcpToolKind = 'read' | 'edit' | 'delete' | 'move' | 'search' | 'execute' | 'think' | 'fetch' | 'other';
+export interface AcpToolCallInfo {
+    toolCallId: string;
+    title?: string;
+    kind?: string;
+    rawInput?: unknown;
+    locations?: Array<{
+        path?: string;
+    }>;
+}
+export interface AcpPermissionOption {
+    optionId: string;
+    name?: string;
+    kind: string;
+}
+export declare function decidePermission(tools: ToolPolicy, toolCall: AcpToolCallInfo, options: AcpPermissionOption[]): AcpPermissionOption | null;
+export declare function isAllowed(tools: ToolPolicy, kind: AcpToolKind, toolCall: AcpToolCallInfo): boolean;
+export declare function shellAllowed(tools: ToolPolicy, command: string | null): boolean;
+export declare function commandOf(toolCall: AcpToolCallInfo): string | null;

package/dist/permissions/acp.js

@@ -0,0 +1,73 @@
+export function decidePermission(tools, toolCall, options) {
+    const kind = normalizeKind(toolCall.kind);
+    const allowed = isAllowed(tools, kind, toolCall);
+    const desired = allowed ? 'allow' : 'reject';
+    return options.find(option => option.kind.startsWith(desired)) ?? null;
+}
+export function isAllowed(tools, kind, toolCall) {
+    switch (kind) {
+        case 'read':
+        case 'search':
+        case 'think':
+            return true;
+        case 'fetch':
+            return tools.allowNetwork;
+        case 'edit':
+        case 'move':
+        case 'delete':
+            return tools.fileAccess === 'read-write';
+        case 'execute':
+            return shellAllowed(tools, commandOf(toolCall));
+        case 'other':
+        default:
+            return tools.fileAccess === 'read-write';
+    }
+}
+export function shellAllowed(tools, command) {
+    if (tools.shell === 'deny')
+        return false;
+    if (tools.shell === 'allow')
+        return true;
+    if (!command)
+        return false;
+    return (tools.shellAllow ?? []).some(prefix => {
+        const value = prefix.trim();
+        if (!value)
+            return false;
+        return command === value || command.startsWith(`${value} `);
+    });
+}
+export function commandOf(toolCall) {
+    const raw = toolCall.rawInput;
+    if (raw && typeof raw === 'object') {
+        const record = raw;
+        if (typeof record.command === 'string')
+            return record.command.trim() || null;
+        if (Array.isArray(record.command) && record.command.every(item => typeof item === 'string')) {
+            return record.command.join(' ').trim() || null;
+        }
+        const argv = record.argv ?? record.args;
+        if (Array.isArray(argv) && argv.every(item => typeof item === 'string')) {
+            return argv.join(' ').trim() || null;
+        }
+    }
+    if (typeof toolCall.title === 'string')
+        return toolCall.title.trim() || null;
+    return null;
+}
+function normalizeKind(kind) {
+    switch (kind) {
+        case 'read':
+        case 'edit':
+        case 'delete':
+        case 'move':
+        case 'search':
+        case 'execute':
+        case 'think':
+        case 'fetch':
+            return kind;
+        default:
+            return 'other';
+    }
+}
+//# sourceMappingURL=acp.js.map

package/dist/permissions/acp.js.map

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

package/dist/permissions.d.ts

@@ -0,0 +1 @@
+export * from './permissions/acp.js';

package/dist/permissions.js

@@ -0,0 +1,2 @@
+export * from './permissions/acp.js';
+//# sourceMappingURL=permissions.js.map

package/dist/permissions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"permissions.js","sourceRoot":"","sources":["../../../../packages/runtime/src/permissions.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAA"}

package/dist/plugins/loader.d.ts

@@ -0,0 +1,46 @@
+import type { RuntimeConfigView } from '@router-agent/core/config.js';
+import { type Logger } from '@router-agent/infra/logger.js';
+import type { CommandRunner } from '@router-agent/infra/process.js';
+import { type PluginFailure } from '@router-agent/infra/plugin-loader.js';
+import { RuntimeRegistry } from '../registry.js';
+import type { RuntimeOptionSpec } from '../runtimes/options.js';
+import type { PluginEntry, PluginModuleLoader } from '../plugins/types.js';
+import type { RuntimePluginMeta } from './types.js';
+export declare const DEFAULT_RUNTIME_PLUGINS: Readonly<Record<string, string>>;
+export interface RuntimePluginConfigView extends RuntimeConfigView {
+    runtime: RuntimeConfigView['runtime'] & {
+        plugins?: Record<string, PluginEntry>;
+    };
+}
+export declare function pluginEntryOf(config: RuntimePluginConfigView, kind: 'runtime', id: string): string;
+export declare function describePluginLoadError(kind: 'runtime' | 'channel', id: string, error: unknown): string;
+export interface RuntimePluginDeps {
+    home: string;
+    workersDir: string;
+    logger?: Logger;
+    env?: NodeJS.ProcessEnv;
+    runners?: {
+        orca?: CommandRunner;
+        claude?: CommandRunner;
+        git?: CommandRunner;
+        herdr?: CommandRunner;
+    };
+    claudeBin?: string;
+    claudeProjectsDir?: string;
+    loader?: PluginModuleLoader;
+    /** 测试注入：跳过内置包加载。 */
+    builtins?: readonly string[];
+}
+export interface LoadedRuntimePlugins {
+    registry: RuntimeRegistry;
+    metas: RuntimePluginMeta[];
+    specs: RuntimeOptionSpec[];
+    /** 已加载的运行时 id；未知 id 用于配置校验。 */
+    ids: string[];
+    /** 插件元数据 id → createAll() 实际注册的运行时 id；自定义多实例运行时用。 */
+    loadedIds: Record<string, string[]>;
+    /** 加载失败的插件；启动不阻塞，但面板与 doctor 要能看到。 */
+    failures: PluginFailure[];
+}
+/** 加载 runtime 插件并创建 adapter；单个插件失败只记录，不阻塞其它运行时。 */
+export declare function loadRuntimePlugins(config: RuntimePluginConfigView, deps: RuntimePluginDeps): Promise<LoadedRuntimePlugins>;

package/dist/plugins/loader.js

@@ -0,0 +1,117 @@
+import { errorMessage, noopLogger } from '@router-agent/infra/logger.js';
+import { loadPluginModules, pluginEntryTarget, pluginSpecifier, } from '@router-agent/infra/plugin-loader.js';
+import { RuntimeRegistry } from '../registry.js';
+import { RuntimePluginError } from '../errors.js';
+export const DEFAULT_RUNTIME_PLUGINS = {
+    orca: '@router-agent/runtime-orca',
+    'claude-code': '@router-agent/runtime-claude-code',
+    'codex-app': '@router-agent/runtime-codex',
+    acp: '@router-agent/runtime-acp',
+    herdr: '@router-agent/runtime-herdr',
+};
+export function pluginEntryOf(config, kind, id) {
+    const entry = config.runtime.plugins?.[id];
+    return pluginSpecifier(entry) ?? DEFAULT_RUNTIME_PLUGINS[id] ?? id;
+}
+export function describePluginLoadError(kind, id, error) {
+    return `${kind} 插件 ${id} 加载失败：${errorMessage(error)}`;
+}
+/** 加载 runtime 插件并创建 adapter；单个插件失败只记录，不阻塞其它运行时。 */
+export async function loadRuntimePlugins(config, deps) {
+    const logger = deps.logger ?? noopLogger;
+    const loader = deps.loader;
+    const entries = config.runtime.plugins;
+    const builtins = deps.builtins ?? Object.keys(DEFAULT_RUNTIME_PLUGINS);
+    const ids = [...new Set([...builtins, ...Object.keys(entries ?? {})])];
+    const loaded = await loadPluginModules({
+        kind: 'runtime',
+        home: deps.home,
+        ids,
+        ...(loader ? { loader } : {}),
+        logger,
+        specifierOf: id => specifierOf(entries, id),
+        entryOf: id => pluginEntryTarget(entries?.[id]),
+    });
+    const plugins = loaded.plugins;
+    const ctx = {
+        home: deps.home,
+        workersDir: deps.workersDir,
+        config,
+        env: deps.env ?? process.env,
+        logger,
+        runners: {
+            orca: deps.runners?.orca ?? missingRunner('orca'),
+            claude: deps.runners?.claude ?? missingRunner('claude'),
+            git: deps.runners?.git ?? missingRunner('git'),
+            herdr: deps.runners?.herdr ?? missingRunner('herdr'),
+        },
+        ...(deps.claudeBin ? { claudeBin: deps.claudeBin } : {}),
+        ...(deps.claudeProjectsDir ? { claudeProjectsDir: deps.claudeProjectsDir } : {}),
+    };
+    const runtimes = new Map();
+    const metas = [];
+    const specs = [];
+    const loadedIds = {};
+    for (const { id, plugin } of loaded.entries) {
+        try {
+            const instances = plugin.createAll ? await plugin.createAll(ctx) : [await plugin.create(ctx)];
+            const ids = [];
+            for (const runtime of instances) {
+                if (!runtime)
+                    continue;
+                runtimes.set(runtime.id, runtime);
+                ids.push(runtime.id);
+                logger.info('plugin:loaded', { kind: 'runtime', id: runtime.id });
+            }
+            if (plugin.meta) {
+                if (plugin.meta.id !== id) {
+                    logger.warn('plugin:id-mismatch', {
+                        kind: 'runtime',
+                        id,
+                        declared: plugin.meta.id,
+                        detail: '配置里的插件 id 与插件声明的 meta.id 不一致，请改成一致以便面板回链',
+                    });
+                }
+                // 以配置 id 作为面板身份，声明 id 只用于说明；实例 id 另存。
+                metas.push({ ...plugin.meta, id });
+                loadedIds[id] = ids;
+            }
+            if (plugin.options)
+                specs.push(plugin.options);
+            // createAll 没声明 meta 时也要把实例 id 记下来，否则无法按插件回推。
+            if (!plugin.meta && ids.length > 0)
+                loadedIds[id] = ids;
+        }
+        catch (error) {
+            const failureId = id || plugin.meta?.id || 'unknown';
+            logger.error('plugin:create-failed', { kind: 'runtime', id: failureId, detail: errorMessage(error) });
+            loaded.failures.push({ kind: 'runtime', id: failureId, specifier: pluginEntryOf(config, 'runtime', failureId), message: errorMessage(error) });
+        }
+    }
+    const defaultId = config.runtime.default;
+    if (runtimes.size === 0) {
+        throw new RuntimePluginError('plugin:not-found', `没有可用的 runtime 插件，无法启动 ${defaultId}`);
+    }
+    return {
+        registry: new RuntimeRegistry(runtimes, defaultId),
+        metas,
+        specs,
+        ids: [...runtimes.keys()],
+        loadedIds,
+        failures: loaded.failures,
+    };
+}
+function specifierOf(entries, id) {
+    const entry = entries?.[id];
+    if (entry !== undefined)
+        return pluginSpecifier(entry);
+    return DEFAULT_RUNTIME_PLUGINS[id] ?? id;
+}
+function missingRunner(bin) {
+    return {
+        async run() {
+            throw new Error(`runtime 插件未注入 ${bin} 运行器`);
+        },
+    };
+}
+//# sourceMappingURL=loader.js.map

package/dist/plugins/loader.js.map

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

package/dist/plugins/types.d.ts

@@ -0,0 +1,52 @@
+import type { RuntimeConfigView } from '@router-agent/core/config.js';
+import type { CommandRunner } from '@router-agent/infra/process.js';
+import type { Logger } from '@router-agent/infra/logger.js';
+import type { PluginEntry, PluginModuleLoader } from '@router-agent/infra/plugin-loader.js';
+import type { WorkerRuntime } from '../port.js';
+import type { RuntimeOptionSpec } from '../runtimes/options.js';
+export type { PluginEntry, PluginModuleLoader };
+/** 运行时插件元数据；Web 面板与配置校验共用。 */
+export interface RuntimePluginMeta {
+    id: string;
+    name: string;
+    label: string;
+    hint: string;
+    installHint?: string;
+    installUrl?: string;
+    /** 是否可由 ra 自动安装（ACP 扩展）。 */
+    installable?: boolean;
+    packageName?: string;
+    /** 已有原生运行时替代品：面板不再作为可选项展示。 */
+    deprecated?: boolean;
+    /** 是否接受非本地仓库选择器（Orca 的 name: / id:）。 */
+    repoSelector?: boolean;
+}
+/** 运行时 adapter 创建上下文；宿主只注入中立依赖。 */
+export interface RuntimePluginContext {
+    home: string;
+    workersDir: string;
+    config: RuntimeConfigView;
+    env: NodeJS.ProcessEnv;
+    logger: Logger;
+    /** 运行时可能需要的工作目录运行器；插件自行选择使用哪一个。 */
+    runners: {
+        orca: CommandRunner;
+        claude: CommandRunner;
+        git: CommandRunner;
+        herdr: CommandRunner;
+    };
+    claudeBin?: string;
+    claudeProjectsDir?: string;
+}
+/** 运行时插件：一个包可以导出多个运行时实例。 */
+export interface RuntimePlugin {
+    kind: 'runtime';
+    meta?: RuntimePluginMeta;
+    /** 声明面板可配置项；配置落点统一为 runtime.options.<id>.<key>。 */
+    options?: RuntimeOptionSpec;
+    /** 创建 adapter；返回 null 表示当前配置下不启用（例如未配置 command）。 */
+    create(ctx: RuntimePluginContext): WorkerRuntime | null | Promise<WorkerRuntime | null>;
+    /** 附加运行时；ACP 这类目录型插件用它一次注册多个 id。 */
+    createAll?(ctx: RuntimePluginContext): Array<WorkerRuntime | null> | Promise<Array<WorkerRuntime | null>>;
+}
+export type Plugin = RuntimePlugin;

package/dist/plugins/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/plugins/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../packages/runtime/src/plugins/types.ts"],"names":[],"mappings":""}