@xioflow/kernel 0.4.0 → 0.5.1

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

package/dist/mcp/tools.js

@@ -0,0 +1,255 @@
+import crypto from 'node:crypto';
+const str = (description) => ({ type: 'string', description });
+const strArray = (description) => ({ type: 'array', items: { type: 'string' }, description });
+/** 每次工具调用一个 Run（Run = turn）：一次 indeterminate 不会让整个会话无法继续。 */
+function newRun(ctx, label) {
+    const store = ctx.domain.getStore();
+    if (!store.getTask(ctx.sessionTaskId)) {
+        store.saveTask({
+            id: ctx.sessionTaskId,
+            domainId: ctx.domain.domainId,
+            name: 'MCP session',
+            createdAt: new Date().toISOString(),
+        });
+    }
+    const runId = `${label}-${crypto.randomUUID()}`;
+    store.saveRun({
+        id: runId,
+        taskId: ctx.sessionTaskId,
+        domainId: ctx.domain.domainId,
+        owner: 'mcp',
+        status: 'running',
+        startedAt: new Date().toISOString(),
+    });
+    return runId;
+}
+function tail(text, max) {
+    return text.length <= max ? { text, omittedChars: 0 } : { text: text.slice(-max), omittedChars: text.length - max };
+}
+function summarizeProcess(ctx, opId, runId, res) {
+    const r = res;
+    const stdout = tail(r.stdout ?? '', ctx.maxOutputChars);
+    const stderr = tail(r.stderr ?? '', ctx.maxOutputChars);
+    return {
+        opId,
+        runId,
+        driver: ctx.driverName,
+        status: r.status,
+        exitCode: r.exitCode ?? null,
+        signal: r.signal ?? null,
+        replayed: r.replayed === true,
+        terminationReason: r.terminationReason,
+        reason: r.reason,
+        recoveryGuidance: r.recoveryGuidance,
+        residualProcessesReaped: r.residualProcessesReaped,
+        stdout: stdout.text,
+        stderr: stderr.text,
+        stdoutOmittedChars: stdout.omittedChars || undefined,
+        stderrOmittedChars: stderr.omittedChars || undefined,
+        stdoutRef: r.stdoutRef,
+        stderrRef: r.stderrRef,
+        durationMs: r.durationMs,
+    };
+}
+/**
+ * 在一个新 Run 中执行；正常返回时 Run 收尾为 succeeded（有 indeterminate 操作时内核判为 indeterminate），
+ * 抛错（准入拒绝、指纹冲突等）时收尾为 failed，不留下永远 running 的 Run。
+ */
+async function withRun(ctx, label, fn) {
+    const runId = newRun(ctx, label);
+    const store = ctx.domain.getStore();
+    let result;
+    try {
+        result = await fn(runId);
+    }
+    catch (err) {
+        store.reportRunFailed(runId);
+        throw err;
+    }
+    store.reportRunSucceeded(runId);
+    return result;
+}
+export const TOOLS = [
+    {
+        name: 'run_command',
+        title: 'Run a supervised command',
+        description: 'Run a command under the xioflow kernel: the intent is persisted before it starts, the whole process tree is stopped on timeout or cancel, and the result says "indeterminate" instead of guessing when the kernel cannot confirm what happened. Passing the same opId again returns the recorded result instead of running twice.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                command: str('Executable to run (resolved on PATH).'),
+                args: strArray('Arguments, passed without a shell.'),
+                cwd: str('Working directory (absolute path).'),
+                opId: str('Idempotency key. Reuse it to retry safely: a recorded operation is replayed, never re-run.'),
+                timeoutMs: { type: 'integer', minimum: 1, description: 'Stop the process tree after this many milliseconds.' },
+                resources: strArray('Exclusive resources to hold while running, e.g. "workspace:write:/repo" or "port:3000".'),
+                stdin: str('Text written to stdin, which is then closed.'),
+            },
+            required: ['command', 'cwd'],
+            additionalProperties: false,
+        },
+        annotations: { destructiveHint: true, openWorldHint: true },
+        async call(ctx, args) {
+            const opId = typeof args.opId === 'string' && args.opId ? args.opId : `mcp-${crypto.randomUUID()}`;
+            ctx.bindOperation(opId);
+            return withRun(ctx, 'mcp-run', async (runId) => {
+                const res = await ctx.supervisor.executeProcess({
+                    runId,
+                    opId,
+                    name: String(args.command),
+                    command: {
+                        execPath: String(args.command),
+                        args: Array.isArray(args.args) ? args.args.map(String) : [],
+                        cwd: String(args.cwd),
+                        stdin: typeof args.stdin === 'string' ? args.stdin : undefined,
+                    },
+                    requiredResources: Array.isArray(args.resources) ? args.resources.map(String) : [],
+                    timeoutMs: typeof args.timeoutMs === 'number' ? args.timeoutMs : undefined,
+                    onStreamChunk: ctx.onChunk,
+                });
+                return summarizeProcess(ctx, opId, res.runId ?? runId, res);
+            });
+        },
+    },
+    {
+        name: 'operation_status',
+        title: 'Look up an operation',
+        description: 'Return the recorded status and result of an operation by opId, including indeterminate operations that wait for a human decision.',
+        inputSchema: {
+            type: 'object',
+            properties: { opId: str('Operation id returned by run_command.') },
+            required: ['opId'],
+            additionalProperties: false,
+        },
+        annotations: { readOnlyHint: true, idempotentHint: true },
+        async call(ctx, args) {
+            const op = ctx.domain.getStore().getOperation(String(args.opId));
+            if (!op)
+                return { opId: args.opId, found: false };
+            const result = op.result;
+            return {
+                opId: op.id,
+                found: true,
+                kind: op.kind,
+                status: op.status,
+                resultStatus: result?.status,
+                exitCode: result?.exitCode,
+                reason: result?.reason,
+                recoveryGuidance: result?.recoveryGuidance,
+                leasesHeld: ctx.domain
+                    .getStore()
+                    .getPersistedResourceLeases(ctx.domain.domainId)
+                    .filter((l) => l.operationId === op.id)
+                    .map((l) => l.resourceId),
+            };
+        },
+    },
+    {
+        name: 'cancel_operation',
+        title: 'Stop a running operation',
+        description: 'Stop a running operation and its whole process tree. The answer is "confirmed_stopped" only when the kernel verified nothing is left running.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                opId: str('Operation id to stop.'),
+                graceMs: { type: 'integer', minimum: 0, description: 'Time between SIGINT and escalation (default 2000).' },
+            },
+            required: ['opId'],
+            additionalProperties: false,
+        },
+        annotations: { destructiveHint: true, idempotentHint: true },
+        async call(ctx, args) {
+            const res = await ctx.supervisor.cancelOperation(String(args.opId), typeof args.graceMs === 'number' ? args.graceMs : 2000);
+            return { opId: args.opId, ...res };
+        },
+    },
+    {
+        name: 'snapshot_workspace',
+        title: 'Snapshot a workspace',
+        description: 'Capture a restorable snapshot of a git working tree (tracked and untracked, ignored files excluded) without touching the index, HEAD or branches.',
+        inputSchema: {
+            type: 'object',
+            properties: { root: str('Directory inside a git working tree.') },
+            required: ['root'],
+            additionalProperties: false,
+        },
+        annotations: { readOnlyHint: false, destructiveHint: false },
+        async call(ctx, args) {
+            const res = await withRun(ctx, 'mcp-snapshot', (runId) => ctx.supervisor.captureSnapshot({ runId, opId: `snap-${crypto.randomUUID()}`, roots: [String(args.root)] }));
+            return { status: res.status, snapshotId: res.snapshot?.id, roots: res.snapshot?.roots, error: res.errorMessage };
+        },
+    },
+    {
+        name: 'rollback_workspace',
+        title: 'Roll a workspace back to a snapshot',
+        description: 'Restore the snapshot roots and verify the result. "coverage" says how much of the change the rollback can vouch for; it is "complete" only when every operation since the snapshot ran confined.',
+        inputSchema: {
+            type: 'object',
+            properties: { snapshotId: str('Snapshot id from snapshot_workspace.') },
+            required: ['snapshotId'],
+            additionalProperties: false,
+        },
+        annotations: { destructiveHint: true, idempotentHint: true },
+        async call(ctx, args) {
+            const res = await withRun(ctx, 'mcp-rollback', (runId) => ctx.supervisor.rollback({ runId, opId: `rollback-${crypto.randomUUID()}`, snapshotId: String(args.snapshotId) }));
+            return { ...res };
+        },
+    },
+    {
+        name: 'begin_transaction',
+        title: 'Start a workspace transaction',
+        description: 'Fork a git working tree for one agent. Work inside the returned forkRoot, then commit: the change lands only if no other transaction changed what this one read or wrote.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                txId: str('Transaction id (letters, digits, ".", "_", "-").'),
+                root: str('Workspace directory inside a git working tree.'),
+                forkPath: str('Where to create the fork (must not exist).'),
+            },
+            required: ['txId', 'root', 'forkPath'],
+            additionalProperties: false,
+        },
+        annotations: { destructiveHint: false },
+        async call(ctx, args) {
+            const tx = await withRun(ctx, 'mcp-tx', (runId) => ctx.supervisor.beginWorkspaceTransaction({
+                txId: String(args.txId),
+                runId,
+                root: String(args.root),
+                forkPath: String(args.forkPath),
+            }));
+            return { ...tx };
+        },
+    },
+    {
+        name: 'commit_transaction',
+        title: 'Commit a workspace transaction',
+        description: 'Validate the transaction against changes committed since it began and apply it to the workspace. On conflict nothing is applied and the conflicting paths are listed.',
+        inputSchema: {
+            type: 'object',
+            properties: { txId: str('Transaction id.') },
+            required: ['txId'],
+            additionalProperties: false,
+        },
+        annotations: { destructiveHint: true },
+        async call(ctx, args) {
+            return { ...(await ctx.supervisor.commitWorkspaceTransaction(String(args.txId))) };
+        },
+    },
+    {
+        name: 'abort_transaction',
+        title: 'Abort a workspace transaction',
+        description: 'Discard the transaction and remove its fork. The workspace is not changed.',
+        inputSchema: {
+            type: 'object',
+            properties: { txId: str('Transaction id.'), reason: str('Why it was aborted (journaled).') },
+            required: ['txId'],
+            additionalProperties: false,
+        },
+        annotations: { destructiveHint: false, idempotentHint: false },
+        async call(ctx, args) {
+            await ctx.supervisor.abortWorkspaceTransaction(String(args.txId), typeof args.reason === 'string' ? args.reason : undefined);
+            return { txId: args.txId, aborted: true };
+        },
+    },
+];
+//# sourceMappingURL=tools.js.map

package/dist/mcp/tools.js.map

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

package/dist/otel/otlp.d.ts

@@ -0,0 +1,37 @@
+import { ExecutionDomain } from '../domain.js';
+import { JournalEvent, Operation } from '../types.js';
+export interface OtlpTraces {
+    /** ExportTraceServiceRequest 的 JSON 编码，可直接 POST 到 `<endpoint>/v1/traces`。 */
+    payload: {
+        resourceSpans: unknown[];
+    };
+    spanCount: number;
+    /** 下次增量导出的游标：传回 fromSeq 即只导出之后结束的对象。 */
+    nextSeq: number;
+}
+/**
+ * 把 journal 中在 fromSeq（含）之后结束的操作与事务转换为 OTLP traces。
+ * `lookupOperation` 通常是 `store.getOperation`。
+ */
+export declare function journalToOtlpTraces(options: {
+    domainId: string;
+    events: JournalEvent[];
+    lookupOperation: (opId: string) => Operation | null | undefined;
+    fromSeq?: number;
+    serviceName?: string;
+}): OtlpTraces;
+/**
+ * 读取域 journal 并 POST 到 OTLP/HTTP 端点（`<endpoint>/v1/traces`，JSON 编码）。
+ * 非 2xx 响应抛错，游标不前进，调用方可原样重试（span id 确定，不会产生语义重复）。
+ */
+export declare function exportJournalToOtlp(domain: Pick<ExecutionDomain, 'domainId' | 'getStore'>, options: {
+    endpoint: string;
+    headers?: Record<string, string>;
+    fromSeq?: number;
+    serviceName?: string;
+    timeoutMs?: number;
+}): Promise<{
+    spanCount: number;
+    nextSeq: number;
+}>;
+//# sourceMappingURL=otlp.d.ts.map

package/dist/otel/otlp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"otlp.d.ts","sourceRoot":"","sources":["../../src/otel/otlp.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,SAAS,EAAmB,MAAM,aAAa,CAAC;AA4KvE,MAAM,WAAW,UAAU;IACzB,6EAA6E;IAC7E,OAAO,EAAE;QAAE,aAAa,EAAE,OAAO,EAAE,CAAA;KAAE,CAAC;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,wCAAwC;IACxC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE;IAC3C,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,YAAY,EAAE,CAAC;IACvB,eAAe,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,SAAS,GAAG,IAAI,GAAG,SAAS,CAAC;IAChE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,GAAG,UAAU,CA2Cb;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,IAAI,CAAC,eAAe,EAAE,UAAU,GAAG,UAAU,CAAC,EACtD,OAAO,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAC1H,OAAO,CAAC;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAuBjD"}