@router-agent/runtime 0.0.0-stage → 0.3.32

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":""}

package/dist/port.d.ts

@@ -0,0 +1,295 @@
+import type { Assignment, InputKind, Ticket } from '@router-agent/core/model.js';
+/** 工单执行上下文：Router 负责拼装，运行时只消费。 */
+export interface WorkerContext {
+    ticket: Ticket;
+    assignment: Assignment;
+    /** 预分配目录；为空表示由运行时决定。 */
+    workdir: string;
+    /** 运行时中立的工单契约；Router 正常都会提供，缺省时 adapter 可自行渲染。 */
+    brief?: WorkerBrief;
+    /** 报告文件路径；缺省时由 adapter 按 workersDir 推导。 */
+    report?: ReportPaths;
+    /** 工具策略；缺省时使用内置默认值。 */
+    tools?: ToolPolicy;
+}
+/** 运行时中立的任务契约：只讲“做什么/怎么上报”，不讲某个 CLI 的参数。 */
+export interface WorkerBrief {
+    ticketId: string;
+    title: string;
+    scope: string;
+    workBranch: string;
+    /** 已渲染的正文（工单、授权范围、交付规则、上报命令）。 */
+    contract: string;
+}
+export interface ReportPaths {
+    statePath: string;
+    eventsPath: string;
+}
+/** 中立工具策略；adapter 负责映射到各 CLI 的开关。 */
+export interface ToolPolicy {
+    fileAccess: 'read-only' | 'read-write';
+    /** deny=不给 shell；allowlist=只放行 shellAllow 中的命令前缀；allow=任意 shell。 */
+    shell: 'deny' | 'allowlist' | 'allow';
+    /** shell=allowlist 时生效，按命令前缀匹配，例如 ['ra report','ra doc','git','gh']。 */
+    shellAllow?: string[];
+    allowNetwork: boolean;
+}
+export interface InboundMessage {
+    /** 输入 id（in_xxx）；投递时原样展示给 worker，用于写进 acked_inputs。 */
+    id: string;
+    kind: InputKind;
+    text: string;
+}
+export type ContextItem = {
+    kind: 'system-prompt';
+    text: string;
+} | {
+    kind: 'file';
+    path: string;
+    content: string;
+} | {
+    kind: 'env';
+    key: string;
+    value: string;
+} | {
+    kind: 'dir';
+    path: string;
+};
+/** Router 传给运行时的引用：handle 不透明，其余字段让运行时能定位自己的 meta/会话。 */
+export interface WorkspaceRequest {
+    ticketId: string;
+    repo: string;
+    baseBranch: string;
+    workBranch: string;
+    name: string;
+    workdir?: string;
+}
+export interface Workspace {
+    workspaceRef: string;
+    workdir: string;
+    branch: string;
+    meta?: Record<string, unknown>;
+}
+/** 内部构件：工作区生命周期。Orca 等运行时可以不严格实现。 */
+export interface WorkspaceProvider {
+    readonly id: string;
+    create(req: WorkspaceRequest): Promise<Workspace>;
+    inspect(ref: string): Promise<WorkspaceInfo | null>;
+    /**
+     * 回收检出。`repo` 是源仓库绝对路径：git worktree remove 必须在 git 上下文里跑，
+     * 否则会报 `fatal: not a git repository`。
+     */
+    remove(ref: string, opts?: {
+        force?: boolean;
+        repo?: string;
+    }): Promise<void>;
+    listRepos?(): Promise<RepoDescriptor[]>;
+}
+export interface WorkerRef {
+    handle: string;
+    ticketId: string;
+    workdir?: string;
+    /** 运行时自己的会话 ID（Claude/Codex 用；Orca 可空）。 */
+    sessionId?: string;
+}
+/** 工作区引用：回收/查询时使用，不依赖 provider 私有选择器语法。 */
+export interface WorkspaceRef {
+    ticketId: string;
+    workdir: string;
+    /** provider 自己的稳定标识；为空时由 workdir 推导。 */
+    workspaceRef?: string;
+    /** 源仓库绝对路径；回收检出时用它当 git 上下文。 */
+    repo?: string;
+}
+export interface StartResult {
+    handle: string;
+    workdir: string;
+    /** 实际工作分支（可能被 provider 加后缀）；供 PR 兜底查询。 */
+    branch?: string;
+    /** 会话 ID；写入 runtime 的 meta.json，供 resume/活动定位。 */
+    sessionId?: string;
+    workspaceRef?: string;
+}
+export interface ActivityQuery {
+    ref: WorkerRef;
+    opts?: {
+        maxBytes?: number;
+        maxEvents?: number;
+    };
+}
+/** 投递回执：Router 据此决定是否重投；accepted 不等于 ack。 */
+export type DeliveryReceipt = {
+    status: 'accepted';
+    inputIds: string[];
+    /**
+     * 运行时在投递过程中切换了会话（例如 Claude 的 resume 产生副本）。
+     * Router 必须把 Assignment 的 handle 换成新值，后续 status/stop 才能命中同一会话。
+     */
+    handle?: string;
+    sessionId?: string;
+} | {
+    status: 'queued';
+    inputIds: string[];
+    reason?: string;
+} | {
+    status: 'rejected';
+    inputIds: string[];
+    reason: string;
+    retryable?: boolean;
+    retryAfterMs?: number;
+};
+export interface DeliverOptions {
+    /** 第几次投递（从 1 开始）；同一 attempt 的并发调用必须幂等。 */
+    attempt?: number;
+    /** Router 显式重投：adapter 必须允许同一 input.id 再次进入。 */
+    redeliver?: boolean;
+}
+export type AgentPhase = 'starting' | 'running' | 'blocked' | 'exited' | 'lost' | 'unknown';
+export interface AgentStatus {
+    alive: boolean;
+    phase: AgentPhase;
+    acceptingInput: boolean;
+    /** 最后一次可观测活动时间（ISO）；用于 idle / zombie 判定。 */
+    lastActivityAt?: string;
+    exitCode?: number;
+    exitSignal?: string;
+    /** provider 细节；只进日志，不进判断。 */
+    detail?: Record<string, unknown>;
+}
+export interface AgentOutput {
+    status: 'running' | 'exited' | 'unknown';
+    lines: string[];
+    source?: string;
+}
+/**
+ * 被中断的一轮执行。
+ *
+ * 运行时重启后用来回答「上一轮做到哪、是不是被中途打断的」。
+ * 只有进程会随 Router 一起死的运行时（capabilities.agent.processExit=true）
+ * 才有这个概念；常驻 worker 不会因为 Router 重启而中断，不需要实现。
+ */
+export interface InterruptedTurn {
+    /** 运行时自己的轮次 id；用于去重，保证同一轮只提醒一次。 */
+    turnId: string;
+    /** 已执行到哪一步的简要描述；用来生成有意义的恢复提示。 */
+    summary?: string;
+    /** 中断发生时间（ISO），尽力而为。 */
+    at?: string;
+}
+/** 兼容旧命名。 */
+export type TerminalOutput = AgentOutput;
+/** Agent 会话记录里的一条活动（assistant 文本或工具调用）。 */
+export interface SessionEvent {
+    at: string;
+    kind: 'text' | 'tool';
+    text: string;
+    tool?: {
+        name: string;
+        target?: string;
+    };
+}
+/** 从 Agent 自己的会话记录里读出的最近活动。 */
+export interface SessionSnapshot {
+    at: string;
+    events: SessionEvent[];
+    sessionId?: string;
+    filePath?: string;
+}
+/** 人工接管会话时可直接粘贴到终端的恢复提示。 */
+export interface ResumeHint {
+    /** 完整 shell 命令，已包含 cd 到工作目录。 */
+    command: string;
+    /** 运行时自己的会话 ID；用于展示与排障。 */
+    sessionId?: string;
+    /** 不阻断复制，但需要提示用户的注意事项。 */
+    note?: string;
+}
+export interface RuntimeCapabilities {
+    agent: {
+        liveStatus: boolean;
+        processExit: boolean;
+        output: boolean;
+        activity: boolean;
+        structuredInput: boolean;
+        nudge: boolean;
+    };
+    workspace: {
+        cleanup: boolean;
+        prLink: boolean;
+        discovery: boolean;
+    };
+}
+export interface RepoDescriptor {
+    name: string;
+    path: string;
+    kind?: string;
+}
+export interface WorkspaceInfo {
+    workdir: string;
+    branch: string;
+    dirty?: boolean;
+    linkedPr?: {
+        number: number;
+        url: string;
+        state?: 'open' | 'merged' | 'closed';
+    };
+}
+export interface DiagnosticCheck {
+    name: string;
+    status: 'ok' | 'warn' | 'fail';
+    detail: string;
+    hint?: string;
+}
+/** 运行时错误码；所有 adapter 必须抛 WorkerRuntimeError。 */
+export type WorkerErrorCode = 'workspace:create-failed' | 'workspace:missing-repo' | 'workspace:missing-branch' | 'workspace:remove-failed' | 'agent:launch-failed' | 'agent:not-accepting-input' | 'agent:gone' | 'agent:timeout' | 'runtime:unavailable' | 'runtime:unknown';
+export declare class WorkerRuntimeError extends Error {
+    readonly code: WorkerErrorCode;
+    readonly retryable: boolean;
+    readonly reason: string;
+    readonly cause?: string;
+    readonly detail?: Record<string, unknown>;
+    constructor(code: WorkerErrorCode, reason: string, opts?: {
+        retryable?: boolean;
+        cause?: string;
+        detail?: Record<string, unknown>;
+    });
+}
+/** Worker 运行时端口：换运行时只加一个 adapter，内核与 Router 不改。 */
+export interface WorkerRuntime {
+    readonly id: string;
+    readonly capabilities: RuntimeCapabilities;
+    start(ctx: WorkerContext): Promise<StartResult>;
+    deliver(ref: WorkerRef, inputs: InboundMessage[], opts?: DeliverOptions): Promise<DeliveryReceipt>;
+    stop(ref: WorkerRef, reason: string): Promise<void>;
+    /** 可选：显式唤醒/探活；只有 capabilities.agent.nudge=true 时才实现。 */
+    nudge?(ref: WorkerRef): Promise<void>;
+    /** 可选：进程重启后把仍可恢复的会话接回来；接不回返回 false，不算丢失。 */
+    reattach?(ref: WorkerRef): Promise<boolean>;
+    /**
+     * 可选：查询上一轮是否被中途打断。
+     *
+     * 只有 worker 进程会随 Router 一起死的运行时（capabilities.agent.processExit=true）
+     * 才需要实现：这类运行时重启后「上一轮」确实可能停在半路。
+     * 返回 null 表示「没有被打断的轮次」或「判断不了」，不触发任何恢复动作。
+     */
+    interruptedTurn?(ref: WorkerRef): Promise<InterruptedTurn | null>;
+    /** 可选：结构化活性；返回 null 表示「无法判断」，不是「已丢失」。 */
+    status?(ref: WorkerRef): Promise<AgentStatus | null>;
+    /** 可选：输出尾部；没有则巡检跳过这一路。 */
+    output?(ref: WorkerRef, opts?: {
+        limit?: number;
+    }): Promise<AgentOutput | null>;
+    /** 可选：结构化活动；优先于 output。 */
+    activity?(query: ActivityQuery): Promise<SessionSnapshot | null>;
+    /** 可选：工作区查询/回收；不再使用运行时私有选择器。 */
+    inspectWorkspace?(ref: WorkspaceRef): Promise<WorkspaceInfo | null>;
+    removeWorkspace?(ref: WorkspaceRef): Promise<void>;
+    /** 可选：仓库发现（doctor / init）。 */
+    listRepos?(): Promise<RepoDescriptor[]>;
+    /** 可选：把本地仓库路径解析成 GitHub owner/repo，供 PR 跟踪。 */
+    repoSlug?(ref: WorkerRef): Promise<string | null>;
+    /** 可选：启动前自检。 */
+    doctor?(): Promise<DiagnosticCheck[]>;
+    /** 兼容保留：当前 Router 未调用。 */
+    registerContext?(ref: WorkerRef, items: ContextItem[]): Promise<void>;
+}

package/dist/port.js

@@ -0,0 +1,17 @@
+export class WorkerRuntimeError extends Error {
+    code;
+    retryable;
+    reason;
+    cause;
+    detail;
+    constructor(code, reason, opts = {}) {
+        super(reason);
+        this.name = 'WorkerRuntimeError';
+        this.code = code;
+        this.reason = reason;
+        this.retryable = opts.retryable ?? false;
+        this.cause = opts.cause;
+        this.detail = opts.detail;
+    }
+}
+//# sourceMappingURL=port.js.map

package/dist/port.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"port.js","sourceRoot":"","sources":["../../../../packages/runtime/src/port.ts"],"names":[],"mappings":"AA6PA,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAClC,IAAI,CAAiB;IACrB,SAAS,CAAS;IAClB,MAAM,CAAQ;IACL,KAAK,CAAS;IACvB,MAAM,CAA0B;IAEzC,YACE,IAAqB,EACrB,MAAc,EACd,OAAkF,EAAE;QAEpF,KAAK,CAAC,MAAM,CAAC,CAAA;QACb,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAA;QAChC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;QAChB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAA;QACpB,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,KAAK,CAAA;QACxC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAA;QACvB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAA;IAC3B,CAAC;CACF"}

package/dist/registry.d.ts

@@ -0,0 +1,13 @@
+import { type WorkerRuntime } from './port.js';
+/** 按 id 持有运行时；内核只通过它取运行时，不直接 new OrcaRuntime。 */
+export declare class RuntimeRegistry {
+    private readonly runtimes;
+    private readonly defaultId;
+    constructor(runtimes: Map<string, WorkerRuntime>, defaultId: string);
+    get(id: string): WorkerRuntime;
+    has(id: string): boolean;
+    ids(): string[];
+    default(): WorkerRuntime;
+}
+/** 用插件创建好的 adapter 组装注册表；插件发现与加载由 plugins/loader 负责。 */
+export declare function createRuntimes(runtimes: Iterable<WorkerRuntime>, defaultId: string): RuntimeRegistry;