@xioflow/kernel 0.3.0 → 0.5.0

package/dist/driver/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/driver/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/driver/types.ts"],"names":[],"mappings":"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"}

package/dist/fault/crashpoint.d.ts

@@ -0,0 +1,8 @@
+export declare const crashpointsEnabled: boolean;
+export declare function crashpoint(label: string): void;
+/**
+ * 以调用栈里开启事务的函数名作为崩溃点标签（仅在启用时解析调用栈）。
+ * 例如 `SqliteStore.recordOperationResult`、`captureSnapshot`。
+ */
+export declare function callerLabel(depth: number): string;
+//# sourceMappingURL=crashpoint.d.ts.map

package/dist/fault/crashpoint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"crashpoint.d.ts","sourceRoot":"","sources":["../../src/fault/crashpoint.ts"],"names":[],"mappings":"AAgBA,eAAO,MAAM,kBAAkB,SAA+B,CAAC;AAE/D,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAO9C;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAKjD"}

package/dist/fault/crashpoint.js

@@ -0,0 +1,37 @@
+import fs from 'node:fs';
+/**
+ * 崩溃点故障注入（测试专用）。
+ *
+ * 只在设置了以下环境变量之一时生效，否则 crashpoint() 是一次布尔判断：
+ * - XIOFLOW_TEST_CRASHPOINT_TRACE=<file>：把经过的每个崩溃点 id 逐行追加到文件（发现阶段）；
+ * - XIOFLOW_TEST_CRASHPOINT=<id>：到达该 id 时向自身发送 SIGKILL（注入阶段）。
+ *
+ * id 形如 `<label>#<第几次到达>`。SIGKILL 不执行任何 finally / exit 钩子，与真实崩溃等价；
+ * 故障注入矩阵见 tests/fault/crash-matrix.test.ts。
+ */
+const target = process.env.XIOFLOW_TEST_CRASHPOINT;
+const tracePath = process.env.XIOFLOW_TEST_CRASHPOINT_TRACE;
+const seen = new Map();
+export const crashpointsEnabled = Boolean(target || tracePath);
+export function crashpoint(label) {
+    if (!crashpointsEnabled)
+        return;
+    const n = (seen.get(label) ?? 0) + 1;
+    seen.set(label, n);
+    const id = `${label}#${n}`;
+    if (tracePath)
+        fs.appendFileSync(tracePath, `${id}\n`);
+    if (id === target)
+        process.kill(process.pid, 'SIGKILL');
+}
+/**
+ * 以调用栈里开启事务的函数名作为崩溃点标签（仅在启用时解析调用栈）。
+ * 例如 `SqliteStore.recordOperationResult`、`captureSnapshot`。
+ */
+export function callerLabel(depth) {
+    const frames = (new Error().stack ?? '').split('\n').slice(1);
+    const frame = frames[depth] ?? '';
+    const match = /at (?:async )?([^\s(]+)/.exec(frame);
+    return match ? match[1] : 'unknown';
+}
+//# sourceMappingURL=crashpoint.js.map

package/dist/fault/crashpoint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"crashpoint.js","sourceRoot":"","sources":["../../src/fault/crashpoint.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AAEzB;;;;;;;;;GASG;AACH,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC;AACnD,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,6BAA6B,CAAC;AAC5D,MAAM,IAAI,GAAG,IAAI,GAAG,EAAkB,CAAC;AAEvC,MAAM,CAAC,MAAM,kBAAkB,GAAG,OAAO,CAAC,MAAM,IAAI,SAAS,CAAC,CAAC;AAE/D,MAAM,UAAU,UAAU,CAAC,KAAa;IACtC,IAAI,CAAC,kBAAkB;QAAE,OAAO;IAChC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;IACrC,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IACnB,MAAM,EAAE,GAAG,GAAG,KAAK,IAAI,CAAC,EAAE,CAAC;IAC3B,IAAI,SAAS;QAAE,EAAE,CAAC,cAAc,CAAC,SAAS,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;IACvD,IAAI,EAAE,KAAK,MAAM;QAAE,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;AAC1D,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,KAAa;IACvC,MAAM,MAAM,GAAG,CAAC,IAAI,KAAK,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC9D,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;IAClC,MAAM,KAAK,GAAG,yBAAyB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACpD,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AACtC,CAAC"}

package/dist/index.d.ts

@@ -4,7 +4,16 @@ export * from './store/schema.js';
 export * from './store/sqlite.js';
 export * from './driver/types.js';
 export * from './driver/node-driver.js';
+export * from './driver/reaper-driver.js';
 export * from './supervisor/supervisor.js';
 export * from './recovery/engine.js';
 export * from './quick-run.js';
+export * from './snapshot/git-shadow.js';
+export type { CommitResult, TransactionConflict, TransactionEffects, WorkspaceTransaction, WriteEntry, } from './workspace/transactions.js';
+export type { ReadTracking } from './workspace/read-tracking.js';
+export * from './capability/index.js';
+export * from './confinement/index.js';
+export * from './otel/otlp.js';
+export { KernelMcpServer, SUPPORTED_PROTOCOL_VERSIONS } from './mcp/server.js';
+export type { KernelMcpServerOptions } from './mcp/server.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,yBAAyB,CAAC;AACxC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,sBAAsB,CAAC;AACrC,cAAc,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,yBAAyB,CAAC;AACxC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,sBAAsB,CAAC;AACrC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,0BAA0B,CAAC;AACzC,YAAY,EACV,YAAY,EACZ,mBAAmB,EACnB,kBAAkB,EAClB,oBAAoB,EACpB,UAAU,GACX,MAAM,6BAA6B,CAAC;AACrC,YAAY,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AACjE,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC;AACvC,cAAc,gBAAgB,CAAC;AAC/B,OAAO,EAAE,eAAe,EAAE,2BAA2B,EAAE,MAAM,iBAAiB,CAAC;AAC/E,YAAY,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/index.js

@@ -4,7 +4,13 @@ export * from './store/schema.js';
 export * from './store/sqlite.js';
 export * from './driver/types.js';
 export * from './driver/node-driver.js';
+export * from './driver/reaper-driver.js';
 export * from './supervisor/supervisor.js';
 export * from './recovery/engine.js';
 export * from './quick-run.js';
+export * from './snapshot/git-shadow.js';
+export * from './capability/index.js';
+export * from './confinement/index.js';
+export * from './otel/otlp.js';
+export { KernelMcpServer, SUPPORTED_PROTOCOL_VERSIONS } from './mcp/server.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,yBAAyB,CAAC;AACxC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,sBAAsB,CAAC;AACrC,cAAc,gBAAgB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,yBAAyB,CAAC;AACxC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,sBAAsB,CAAC;AACrC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,0BAA0B,CAAC;AASzC,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC;AACvC,cAAc,gBAAgB,CAAC;AAC/B,OAAO,EAAE,eAAe,EAAE,2BAA2B,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/mcp/server.d.ts

@@ -0,0 +1,49 @@
+/**
+ * MCP server（stdio，JSON-RPC 2.0，每行一条消息），零依赖。
+ *
+ * 启动顺序遵循「先恢复、再执行」（ARCHITECTURE §3.2）：获取域、运行恢复引擎，然后才响应请求。
+ * stdout 只写协议消息；日志写 stderr。支持 progress 通知（请求带 progressToken 时转发输出块）
+ * 与 notifications/cancelled（取消对应的 run_command 操作，走标准停止流水线）。
+ */
+export declare const SUPPORTED_PROTOCOL_VERSIONS: string[];
+export interface KernelMcpServerOptions {
+    domainPath: string;
+    domainId?: string;
+    /** 'auto'：helper 可用时用 ReaperPlatformDriver，否则 NodePlatformDriver；实际选择写进 instructions 与每个结果。 */
+    driver?: 'auto' | 'node' | 'reaper';
+    input?: NodeJS.ReadableStream;
+    output?: NodeJS.WritableStream;
+    log?: (message: string) => void;
+    /** 工具结果中保留的 stdout / stderr 尾部字符数（完整输出见 stdoutRef / stderrRef）。 */
+    maxOutputChars?: number;
+    /** 周期性把 journal 导出为 OTLP traces；失败写日志且游标不前进，下个周期重试。 */
+    otlp?: {
+        endpoint: string;
+        headers?: Record<string, string>;
+        intervalMs?: number;
+        serviceName?: string;
+    };
+}
+export declare class KernelMcpServer {
+    private readonly options;
+    private readonly log;
+    private readonly output;
+    private domain?;
+    private supervisor?;
+    private driver?;
+    private instructions;
+    private readonly sessionTaskId;
+    /** requestId → 该请求启动的操作，用于 notifications/cancelled */
+    private readonly inFlight;
+    private readonly pending;
+    constructor(options: KernelMcpServerOptions);
+    /** 获取域并完成恢复后开始服务；输入流结束时等待在途请求、关闭域后返回。 */
+    serve(): Promise<void>;
+    /** 启动周期导出，返回「停止并最后导出一次」的函数；未配置时为空操作。 */
+    private startOtlpExport;
+    private handleLine;
+    private dispatch;
+    private callTool;
+    private send;
+}
+//# sourceMappingURL=server.d.ts.map

package/dist/mcp/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":"AAcA;;;;;;GAMG;AAEH,eAAO,MAAM,2BAA2B,UAA2D,CAAC;AAEpG,MAAM,WAAW,sBAAsB;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,+FAA+F;IAC/F,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,QAAQ,CAAC;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC,cAAc,CAAC;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC,cAAc,CAAC;IAC/B,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,mEAAmE;IACnE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,uDAAuD;IACvD,IAAI,CAAC,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC1G;AAkCD,qBAAa,eAAe;IAYd,OAAO,CAAC,QAAQ,CAAC,OAAO;IAXpC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAA4B;IAChD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwB;IAC/C,OAAO,CAAC,MAAM,CAAC,CAAkB;IACjC,OAAO,CAAC,UAAU,CAAC,CAAoB;IACvC,OAAO,CAAC,MAAM,CAAC,CAAiB;IAChC,OAAO,CAAC,YAAY,CAAM;IAC1B,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAwC;IACtE,sDAAsD;IACtD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA6B;IACtD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA4B;IAEpD,YAA6B,OAAO,EAAE,sBAAsB,EAG3D;IAED,yCAAyC;IAC5B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CA2BlC;IAED,wCAAwC;IACxC,OAAO,CAAC,eAAe;YAuBT,UAAU;YA0BV,QAAQ;YAwCR,QAAQ;IA0CtB,OAAO,CAAC,IAAI;CAGb"}

package/dist/mcp/server.js

@@ -0,0 +1,233 @@
+import crypto from 'node:crypto';
+import fs from 'node:fs';
+import path from 'node:path';
+import readline from 'node:readline';
+import { fileURLToPath } from 'node:url';
+import { ExecutionDomain } from '../domain.js';
+import { NodePlatformDriver } from '../driver/node-driver.js';
+import { ReaperPlatformDriver } from '../driver/reaper-driver.js';
+import { RecoveryEngine } from '../recovery/engine.js';
+import { exportJournalToOtlp } from '../otel/otlp.js';
+import { ProcessSupervisor } from '../supervisor/supervisor.js';
+import { TOOLS } from './tools.js';
+/**
+ * MCP server（stdio，JSON-RPC 2.0，每行一条消息），零依赖。
+ *
+ * 启动顺序遵循「先恢复、再执行」（ARCHITECTURE §3.2）：获取域、运行恢复引擎，然后才响应请求。
+ * stdout 只写协议消息；日志写 stderr。支持 progress 通知（请求带 progressToken 时转发输出块）
+ * 与 notifications/cancelled（取消对应的 run_command 操作，走标准停止流水线）。
+ */
+export const SUPPORTED_PROTOCOL_VERSIONS = ['2025-11-25', '2025-06-18', '2025-03-26', '2024-11-05'];
+class RpcError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+    }
+}
+function packageVersion() {
+    try {
+        const pkg = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '../../package.json');
+        return JSON.parse(fs.readFileSync(pkg, 'utf8')).version ?? 'unknown';
+    }
+    catch {
+        return 'unknown';
+    }
+}
+function selectDriver(choice) {
+    if (choice === 'node')
+        return new NodePlatformDriver();
+    if (choice === 'reaper')
+        return new ReaperPlatformDriver();
+    return ReaperPlatformDriver.isAvailable() ? new ReaperPlatformDriver() : new NodePlatformDriver();
+}
+export class KernelMcpServer {
+    options;
+    log;
+    output;
+    domain;
+    supervisor;
+    driver;
+    instructions = '';
+    sessionTaskId = `mcp-session-${crypto.randomUUID()}`;
+    /** requestId → 该请求启动的操作，用于 notifications/cancelled */
+    inFlight = new Map();
+    pending = new Set();
+    constructor(options) {
+        this.options = options;
+        this.log = options.log ?? ((m) => process.stderr.write(`[xioflow-mcp] ${m}\n`));
+        this.output = options.output ?? process.stdout;
+    }
+    /** 获取域并完成恢复后开始服务；输入流结束时等待在途请求、关闭域后返回。 */
+    async serve() {
+        this.driver = selectDriver(this.options.driver);
+        this.domain = ExecutionDomain.acquire(this.options.domainPath, this.options.domainId ?? 'default');
+        try {
+            const report = await new RecoveryEngine(this.domain, this.driver).recover();
+            const isolated = report.recoveredOperations.filter((r) => r.action === 'isolated_indeterminate').length;
+            this.log(`domain ${this.options.domainPath} recovered ${report.recoveredOperations.length} operation(s), ${isolated} isolated as indeterminate`);
+            this.supervisor = new ProcessSupervisor(this.domain, this.driver);
+            this.instructions =
+                `xioflow kernel ${packageVersion()} with the ${this.driver.name} driver. ` +
+                    'Use run_command instead of a plain shell when you need to know for sure what happened: reuse an opId to retry without running twice, ' +
+                    'and treat "indeterminate" as "stop and ask a human", never as success or failure. ' +
+                    'Use begin_transaction / commit_transaction when several agents edit the same repository.';
+            const stopExport = this.startOtlpExport();
+            const lines = readline.createInterface({ input: this.options.input ?? process.stdin, crlfDelay: Infinity });
+            for await (const line of lines) {
+                if (!line.trim())
+                    continue;
+                const work = this.handleLine(line).catch((err) => this.log(`unhandled: ${err?.stack ?? err}`));
+                this.pending.add(work);
+                void work.finally(() => this.pending.delete(work));
+            }
+            await Promise.allSettled([...this.pending]);
+            await stopExport();
+        }
+        finally {
+            this.domain.close();
+        }
+    }
+    /** 启动周期导出，返回「停止并最后导出一次」的函数；未配置时为空操作。 */
+    startOtlpExport() {
+        const otlp = this.options.otlp;
+        if (!otlp)
+            return async () => { };
+        let fromSeq = 0;
+        let running = Promise.resolve();
+        const exportOnce = () => (running = running.then(async () => {
+            try {
+                const res = await exportJournalToOtlp(this.domain, { ...otlp, fromSeq });
+                fromSeq = res.nextSeq;
+                if (res.spanCount > 0)
+                    this.log(`exported ${res.spanCount} span(s) to ${otlp.endpoint}`);
+            }
+            catch (err) {
+                this.log(`OTLP export failed (will retry): ${err?.message ?? err}`);
+            }
+        }));
+        const timer = setInterval(exportOnce, otlp.intervalMs ?? 5000);
+        timer.unref();
+        return async () => {
+            clearInterval(timer);
+            await exportOnce();
+        };
+    }
+    async handleLine(line) {
+        let msg;
+        try {
+            msg = JSON.parse(line);
+        }
+        catch {
+            this.send({ jsonrpc: '2.0', id: null, error: { code: -32700, message: 'Parse error' } });
+            return;
+        }
+        if (typeof msg.method !== 'string') {
+            if (msg.id !== undefined)
+                this.log(`ignoring response to request ${String(msg.id)}`);
+            return;
+        }
+        const isNotification = msg.id === undefined || msg.id === null;
+        try {
+            const result = await this.dispatch(msg.method, msg.params ?? {}, msg.id ?? undefined);
+            if (!isNotification)
+                this.send({ jsonrpc: '2.0', id: msg.id, result });
+        }
+        catch (err) {
+            if (isNotification) {
+                this.log(`notification ${msg.method} failed: ${err?.message ?? err}`);
+                return;
+            }
+            const code = err instanceof RpcError ? err.code : -32603;
+            this.send({ jsonrpc: '2.0', id: msg.id, error: { code, message: err?.message ?? String(err) } });
+        }
+    }
+    async dispatch(method, params, id) {
+        switch (method) {
+            case 'initialize': {
+                const requested = typeof params.protocolVersion === 'string' ? params.protocolVersion : '';
+                return {
+                    protocolVersion: SUPPORTED_PROTOCOL_VERSIONS.includes(requested) ? requested : SUPPORTED_PROTOCOL_VERSIONS[0],
+                    capabilities: { tools: { listChanged: false } },
+                    serverInfo: { name: 'xioflow-kernel', title: 'xioflow supervised execution kernel', version: packageVersion() },
+                    instructions: this.instructions,
+                };
+            }
+            case 'notifications/initialized':
+                return undefined;
+            case 'ping':
+                return {};
+            case 'tools/list':
+                return {
+                    tools: TOOLS.map(({ name, title, description, inputSchema, annotations }) => ({
+                        name,
+                        title,
+                        description,
+                        inputSchema,
+                        annotations,
+                    })),
+                };
+            case 'tools/call':
+                return this.callTool(params, id);
+            case 'notifications/cancelled': {
+                const opId = this.inFlight.get(String(params.requestId));
+                if (opId) {
+                    this.log(`request ${params.requestId} cancelled by client (${params.reason ?? 'no reason'}), stopping ${opId}`);
+                    await this.supervisor.cancelOperation(opId).catch((err) => this.log(`cancel ${opId}: ${err.message}`));
+                }
+                return undefined;
+            }
+            default:
+                throw new RpcError(-32601, `Method not found: ${method}`);
+        }
+    }
+    async callTool(params, id) {
+        const tool = TOOLS.find((t) => t.name === params?.name);
+        if (!tool)
+            throw new RpcError(-32602, `Unknown tool: ${params?.name}`);
+        const args = params.arguments ?? {};
+        const missing = (tool.inputSchema.required ?? []).filter((k) => args[k] === undefined);
+        if (missing.length > 0)
+            throw new RpcError(-32602, `${tool.name}: missing required argument(s) ${missing.join(', ')}`);
+        const progressToken = params._meta?.progressToken;
+        let progress = 0;
+        const ctx = {
+            domain: this.domain,
+            supervisor: this.supervisor,
+            driverName: this.driver.name,
+            sessionTaskId: this.sessionTaskId,
+            maxOutputChars: this.options.maxOutputChars ?? 16_000,
+            bindOperation: (opId) => {
+                if (id !== undefined)
+                    this.inFlight.set(String(id), opId);
+            },
+            onChunk: progressToken === undefined
+                ? undefined
+                : (stream, chunk) => {
+                    progress += chunk.length;
+                    this.send({
+                        jsonrpc: '2.0',
+                        method: 'notifications/progress',
+                        params: { progressToken, progress, message: `[${stream}] ${chunk.toString('utf8').slice(0, 2000)}` },
+                    });
+                },
+        };
+        try {
+            const result = await tool.call(ctx, args);
+            return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }], structuredContent: result, isError: false };
+        }
+        catch (err) {
+            // 工具执行失败是结果的一部分（MCP 约定），让模型看到原因而不是协议错误
+            const error = { error: err?.name ?? 'Error', message: err?.message ?? String(err) };
+            return { content: [{ type: 'text', text: JSON.stringify(error, null, 2) }], structuredContent: error, isError: true };
+        }
+        finally {
+            if (id !== undefined)
+                this.inFlight.delete(String(id));
+        }
+    }
+    send(message) {
+        this.output.write(`${JSON.stringify(message)}\n`);
+    }
+}
+//# sourceMappingURL=server.js.map

package/dist/mcp/server.js.map

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

package/dist/mcp/tools.d.ts

@@ -0,0 +1,32 @@
+import { ExecutionDomain } from '../domain.js';
+import { ProcessSupervisor } from '../supervisor/supervisor.js';
+/**
+ * MCP 工具：把内核原语暴露给任意 MCP 客户端（agent 框架、IDE、CLI agent）。
+ * 刻意不暴露 adjudicate：indeterminate 的出口是人工裁决，不交给模型。
+ */
+export interface ToolContext {
+    domain: ExecutionDomain;
+    supervisor: ProcessSupervisor;
+    driverName: string;
+    sessionTaskId: string;
+    maxOutputChars: number;
+    /** 当前请求的流式输出回调（客户端带 progressToken 时才有）。 */
+    onChunk?: (stream: 'stdout' | 'stderr', chunk: Buffer) => void;
+    /** 把 opId 绑定到当前请求，使 notifications/cancelled 能取消它。 */
+    bindOperation(opId: string): void;
+}
+export interface ToolDefinition {
+    name: string;
+    title: string;
+    description: string;
+    inputSchema: Record<string, unknown>;
+    annotations: {
+        readOnlyHint?: boolean;
+        destructiveHint?: boolean;
+        idempotentHint?: boolean;
+        openWorldHint?: boolean;
+    };
+    call(ctx: ToolContext, args: Record<string, any>): Promise<Record<string, unknown>>;
+}
+export declare const TOOLS: ToolDefinition[];
+//# sourceMappingURL=tools.d.ts.map

package/dist/mcp/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/mcp/tools.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAGhE;;;GAGG;AAEH,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,eAAe,CAAC;IACxB,UAAU,EAAE,iBAAiB,CAAC;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,2CAA2C;IAC3C,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,QAAQ,GAAG,QAAQ,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/D,qDAAqD;IACrD,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CACnC;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,WAAW,EAAE;QAAE,YAAY,CAAC,EAAE,OAAO,CAAC;QAAC,eAAe,CAAC,EAAE,OAAO,CAAC;QAAC,cAAc,CAAC,EAAE,OAAO,CAAC;QAAC,aAAa,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IACtH,IAAI,CAAC,GAAG,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACrF;AA4ED,eAAO,MAAM,KAAK,EAAE,cAAc,EA4LjC,CAAC"}