@tachu/extensions 1.0.0-beta.1

package/dist/common/process.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"process.js","sourceRoot":"","sources":["../../src/common/process.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,KAAK,EACtC,MAAqD,EACrD,QAAgB,EAC+B,EAAE;IACjD,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;IACxC,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,EAAE,CAAC;IAClC,MAAM,MAAM,GAAiB,EAAE,CAAC;IAChC,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,SAAS,GAAG,KAAK,CAAC;IAEtB,OAAO,IAAI,EAAE,CAAC;QACZ,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;QAC5C,IAAI,IAAI,EAAE,CAAC;YACT,MAAM;QACR,CAAC;QACD,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,SAAS;QACX,CAAC;QACD,MAAM,IAAI,GAAG,QAAQ,GAAG,KAAK,CAAC;QAC9B,IAAI,IAAI,IAAI,CAAC,EAAE,CAAC;YACd,SAAS,GAAG,IAAI,CAAC;YACjB,MAAM;QACR,CAAC;QACD,IAAI,KAAK,CAAC,UAAU,GAAG,IAAI,EAAE,CAAC;YAC5B,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC;YACrC,KAAK,IAAI,IAAI,CAAC;YACd,SAAS,GAAG,IAAI,CAAC;YACjB,MAAM;QACR,CAAC;QACD,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACnB,KAAK,IAAI,KAAK,CAAC,UAAU,CAAC;IAC5B,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC,KAAK,CAAC,CAAC;IACrC,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,UAAU,CAAC;IAC7B,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC;AAC/D,CAAC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,KAAK,EAAE,GAAW,EAAE,OAAO,GAAG,IAAI,EAAiB,EAAE;IACnF,IAAI,CAAC;QACH,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;IAC/B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO;IACT,CAAC;IACD,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;IACnE,IAAI,CAAC;QACH,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;IAC/B,CAAC;IAAC,MAAM,CAAC;QACP,QAAQ;IACV,CAAC;AACH,CAAC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+export { OpenAIProviderAdapter, AnthropicProviderAdapter, MockProviderAdapter, } from "./providers";
+export { toolDescriptors, toolExecutors, type ToolExecutor } from "./tools";
+export { TerminalBackend, FileBackend, WebBackend } from "./backends";
+export { LocalFsVectorStore, QdrantVectorStore } from "./vector";
+export { ImageToTextTransformer, DocumentToTextTransformer } from "./transformers";
+export { McpStdioAdapter, McpSseAdapter } from "./mcp";
+export { OtelEmitter, JsonlEmitter } from "./observability";
+export { BUILTIN_RULE_DESCRIPTOR_PATHS } from "./rules";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EACrB,wBAAwB,EACxB,mBAAmB,GACpB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,KAAK,YAAY,EAAE,MAAM,SAAS,CAAC;AAC5E,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACtE,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AACjE,OAAO,EAAE,sBAAsB,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAC;AACnF,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC5D,OAAO,EAAE,6BAA6B,EAAE,MAAM,SAAS,CAAC"}

package/dist/index.js

@@ -0,0 +1,9 @@
+export { OpenAIProviderAdapter, AnthropicProviderAdapter, MockProviderAdapter, } from "./providers";
+export { toolDescriptors, toolExecutors } from "./tools";
+export { TerminalBackend, FileBackend, WebBackend } from "./backends";
+export { LocalFsVectorStore, QdrantVectorStore } from "./vector";
+export { ImageToTextTransformer, DocumentToTextTransformer } from "./transformers";
+export { McpStdioAdapter, McpSseAdapter } from "./mcp";
+export { OtelEmitter, JsonlEmitter } from "./observability";
+export { BUILTIN_RULE_DESCRIPTOR_PATHS } from "./rules";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EACrB,wBAAwB,EACxB,mBAAmB,GACpB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,eAAe,EAAE,aAAa,EAAqB,MAAM,SAAS,CAAC;AAC5E,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACtE,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AACjE,OAAO,EAAE,sBAAsB,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAC;AACnF,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC5D,OAAO,EAAE,6BAA6B,EAAE,MAAM,SAAS,CAAC"}

package/dist/mcp/index.d.ts

@@ -0,0 +1,3 @@
+export { McpStdioAdapter } from "./stdio-adapter";
+export { McpSseAdapter } from "./sse-adapter";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mcp/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC"}

package/dist/mcp/index.js

@@ -0,0 +1,3 @@
+export { McpStdioAdapter } from "./stdio-adapter";
+export { McpSseAdapter } from "./sse-adapter";
+//# sourceMappingURL=index.js.map

package/dist/mcp/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/mcp/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC"}

package/dist/mcp/sse-adapter.d.ts

@@ -0,0 +1,70 @@
+import type { McpToolAdapter, ToolDescriptor } from "@tachu/core";
+interface McpSseAdapterOptions {
+    url: string;
+    headers?: Record<string, string>;
+    serverId?: string;
+}
+/**
+ * MCP SSE 传输适配器。
+ */
+export declare class McpSseAdapter implements McpToolAdapter {
+    readonly transport: "sse";
+    private readonly options;
+    private readonly maxReconnectAttempts;
+    private client;
+    private transportImpl;
+    private reconnecting;
+    private closedManually;
+    private serverUri;
+    private readonly pendingRequests;
+    /**
+     * 创建 SSE MCP 适配器。
+     *
+     * @param options 连接配置
+     */
+    constructor(options: McpSseAdapterOptions);
+    /**
+     * 建立 SSE MCP 连接。
+     *
+     * @param serverUri 服务端地址（可覆盖构造参数）
+     */
+    connect(serverUri: string): Promise<void>;
+    /**
+     * 断开连接。
+     */
+    disconnect(): Promise<void>;
+    /**
+     * 列出远端工具并转换为 ToolDescriptor。
+     *
+     * @returns 工具描述符列表
+     */
+    listTools(): Promise<ToolDescriptor[]>;
+    /**
+     * 调用远端工具（core 协议方法）。
+     *
+     * @param name 工具名
+     * @param input 入参
+     * @returns 工具执行结果
+     */
+    executeTool(name: string, input: unknown): Promise<unknown>;
+    /**
+     * 调用远端工具（支持 AbortSignal）。
+     *
+     * @param name 工具名
+     * @param input 入参
+     * @param signal 取消信号
+     * @param requestId 请求 ID（可选；用于后续 cancel 显式取消）
+     * @returns 执行结果
+     */
+    callTool(name: string, input: unknown, signal?: AbortSignal, requestId?: string): Promise<unknown>;
+    /**
+     * 取消请求（由调用方通过 signal 传播）。
+     *
+     * @param _requestId 请求 ID
+     */
+    cancel(requestId: string): Promise<void>;
+    private connectInternal;
+    private reconnectWithBackoff;
+}
+export {};
+//# sourceMappingURL=sse-adapter.d.ts.map

package/dist/mcp/sse-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse-adapter.d.ts","sourceRoot":"","sources":["../../src/mcp/sse-adapter.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElE,UAAU,oBAAoB;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAKD;;GAEG;AACH,qBAAa,aAAc,YAAW,cAAc;IAClD,QAAQ,CAAC,SAAS,EAAG,KAAK,CAAU;IAEpC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAuB;IAC/C,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAK;IAC1C,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,aAAa,CAAmC;IACxD,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,SAAS,CAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAsC;IAEtE;;;;OAIG;gBACS,OAAO,EAAE,oBAAoB;IAIzC;;;;OAIG;IACG,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAM/C;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAWjC;;;;OAIG;IACG,SAAS,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;IAuB5C;;;;;;OAMG;IACG,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAIjE;;;;;;;;OAQG;IACG,QAAQ,CACZ,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,OAAO,EACd,MAAM,CAAC,EAAE,WAAW,EACpB,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,OAAO,CAAC;IAkCnB;;;;OAIG;IACG,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;YAQhC,eAAe;YAoBf,oBAAoB;CAoBnC"}

package/dist/mcp/sse-adapter.js

@@ -0,0 +1,176 @@
+import { Client } from "@modelcontextprotocol/sdk/client/index.js";
+import { SSEClientTransport } from "@modelcontextprotocol/sdk/client/sse.js";
+const createRequestId = () => `mcp-sse-${Date.now()}-${Math.random().toString(36).slice(2, 10)}`;
+/**
+ * MCP SSE 传输适配器。
+ */
+export class McpSseAdapter {
+    transport = "sse";
+    options;
+    maxReconnectAttempts = 3;
+    client = null;
+    transportImpl = null;
+    reconnecting = false;
+    closedManually = false;
+    serverUri = "";
+    pendingRequests = new Map();
+    /**
+     * 创建 SSE MCP 适配器。
+     *
+     * @param options 连接配置
+     */
+    constructor(options) {
+        this.options = options;
+    }
+    /**
+     * 建立 SSE MCP 连接。
+     *
+     * @param serverUri 服务端地址（可覆盖构造参数）
+     */
+    async connect(serverUri) {
+        this.serverUri = serverUri || this.options.url;
+        this.closedManually = false;
+        await this.connectInternal();
+    }
+    /**
+     * 断开连接。
+     */
+    async disconnect() {
+        this.closedManually = true;
+        for (const controller of this.pendingRequests.values()) {
+            controller.abort(new Error("MCP sse adapter disconnected"));
+        }
+        this.pendingRequests.clear();
+        await this.transportImpl?.close().catch(() => undefined);
+        this.transportImpl = null;
+        this.client = null;
+    }
+    /**
+     * 列出远端工具并转换为 ToolDescriptor。
+     *
+     * @returns 工具描述符列表
+     */
+    async listTools() {
+        if (!this.client) {
+            throw new Error("MCP sse adapter not connected");
+        }
+        const response = await this.client.listTools();
+        return response.tools.map((tool) => ({
+            kind: "tool",
+            name: tool.name,
+            description: tool.description ?? `mcp tool: ${tool.name}`,
+            sideEffect: tool.annotations?.readOnlyHint
+                ? "readonly"
+                : tool.annotations?.destructiveHint
+                    ? "irreversible"
+                    : "write",
+            idempotent: tool.annotations?.idempotentHint ?? false,
+            requiresApproval: tool.annotations?.destructiveHint ?? false,
+            timeout: 30_000,
+            inputSchema: tool.inputSchema,
+            outputSchema: tool.outputSchema,
+            execute: `mcp:${this.options.serverId ?? "sse"}:${tool.name}`,
+        }));
+    }
+    /**
+     * 调用远端工具（core 协议方法）。
+     *
+     * @param name 工具名
+     * @param input 入参
+     * @returns 工具执行结果
+     */
+    async executeTool(name, input) {
+        return this.callTool(name, input);
+    }
+    /**
+     * 调用远端工具（支持 AbortSignal）。
+     *
+     * @param name 工具名
+     * @param input 入参
+     * @param signal 取消信号
+     * @param requestId 请求 ID（可选；用于后续 cancel 显式取消）
+     * @returns 执行结果
+     */
+    async callTool(name, input, signal, requestId) {
+        if (!this.client) {
+            throw new Error("MCP sse adapter not connected");
+        }
+        const mappedRequestId = requestId?.trim() ? requestId : createRequestId();
+        if (this.pendingRequests.has(mappedRequestId)) {
+            throw new Error(`MCP sse request already in progress: ${mappedRequestId}`);
+        }
+        const controller = new AbortController();
+        const onAbort = () => {
+            controller.abort(signal?.reason ?? new Error(`MCP sse request aborted: ${mappedRequestId}`));
+        };
+        if (signal?.aborted) {
+            onAbort();
+        }
+        else {
+            signal?.addEventListener("abort", onAbort, { once: true });
+        }
+        this.pendingRequests.set(mappedRequestId, controller);
+        try {
+            const result = await this.client.callTool({ name, arguments: (input ?? {}) }, undefined, { signal: controller.signal });
+            return result;
+        }
+        finally {
+            signal?.removeEventListener("abort", onAbort);
+            this.pendingRequests.delete(mappedRequestId);
+        }
+    }
+    /**
+     * 取消请求（由调用方通过 signal 传播）。
+     *
+     * @param _requestId 请求 ID
+     */
+    async cancel(requestId) {
+        const controller = this.pendingRequests.get(requestId);
+        if (!controller) {
+            return;
+        }
+        controller.abort(new Error(`MCP sse request cancelled: ${requestId}`));
+    }
+    async connectInternal() {
+        const target = this.serverUri || this.options.url;
+        this.client = new Client({ name: "tachu-mcp-sse", version: "1.0.0" });
+        this.transportImpl = new SSEClientTransport(new URL(target), {
+            ...(this.options.headers
+                ? {
+                    requestInit: {
+                        headers: this.options.headers,
+                    },
+                }
+                : {}),
+        });
+        this.transportImpl.onclose = () => {
+            if (!this.closedManually) {
+                void this.reconnectWithBackoff();
+            }
+        };
+        await this.client.connect(this.transportImpl);
+    }
+    async reconnectWithBackoff() {
+        if (this.reconnecting || this.closedManually) {
+            return;
+        }
+        this.reconnecting = true;
+        try {
+            for (let attempt = 0; attempt < this.maxReconnectAttempts; attempt += 1) {
+                const delay = 200 * 2 ** attempt;
+                await new Promise((resolve) => setTimeout(resolve, delay));
+                try {
+                    await this.connectInternal();
+                    return;
+                }
+                catch {
+                    // retry
+                }
+            }
+        }
+        finally {
+            this.reconnecting = false;
+        }
+    }
+}
+//# sourceMappingURL=sse-adapter.js.map

package/dist/mcp/sse-adapter.js.map

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

package/dist/mcp/stdio-adapter.d.ts

@@ -0,0 +1,73 @@
+import type { McpToolAdapter, ToolDescriptor } from "@tachu/core";
+interface McpStdioAdapterOptions {
+    command: string;
+    args?: string[];
+    env?: Record<string, string>;
+    cwd?: string;
+    serverId?: string;
+}
+/**
+ * MCP stdio 传输适配器。
+ */
+export declare class McpStdioAdapter implements McpToolAdapter {
+    readonly transport: "stdio";
+    private readonly options;
+    private readonly maxReconnectAttempts;
+    private client;
+    private transportImpl;
+    private reconnecting;
+    private closedManually;
+    private connected;
+    private serverUri;
+    private readonly pendingRequests;
+    /**
+     * 创建 stdio MCP 适配器。
+     *
+     * @param options stdio 启动参数
+     */
+    constructor(options: McpStdioAdapterOptions);
+    /**
+     * 建立 MCP 连接。
+     *
+     * @param serverUri 服务端 URI（可留空）
+     */
+    connect(serverUri: string): Promise<void>;
+    /**
+     * 断开连接。
+     */
+    disconnect(): Promise<void>;
+    /**
+     * 列出远端工具并映射为引擎 ToolDescriptor。
+     *
+     * @returns 工具描述符数组
+     */
+    listTools(): Promise<ToolDescriptor[]>;
+    /**
+     * 调用远端工具（core 协议方法）。
+     *
+     * @param name 工具名
+     * @param input 入参
+     * @returns 工具执行结果
+     */
+    executeTool(name: string, input: unknown): Promise<unknown>;
+    /**
+     * 调用远端工具（支持 AbortSignal）。
+     *
+     * @param name 工具名
+     * @param input 入参
+     * @param signal 取消信号
+     * @param requestId 请求 ID（可选；用于后续 cancel 显式取消）
+     * @returns 工具执行结果
+     */
+    callTool(name: string, input: unknown, signal?: AbortSignal, requestId?: string): Promise<unknown>;
+    /**
+     * 按 requestId 取消请求（通过信号机制由调用方透传）。
+     *
+     * @param _requestId 请求 ID
+     */
+    cancel(requestId: string): Promise<void>;
+    private connectInternal;
+    private reconnectWithBackoff;
+}
+export {};
+//# sourceMappingURL=stdio-adapter.d.ts.map

package/dist/mcp/stdio-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stdio-adapter.d.ts","sourceRoot":"","sources":["../../src/mcp/stdio-adapter.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElE,UAAU,sBAAsB;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAKD;;GAEG;AACH,qBAAa,eAAgB,YAAW,cAAc;IACpD,QAAQ,CAAC,SAAS,EAAG,OAAO,CAAU;IAEtC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAyB;IACjD,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAK;IAC1C,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,aAAa,CAAqC;IAC1D,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,SAAS,CAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAsC;IAEtE;;;;OAIG;gBACS,OAAO,EAAE,sBAAsB;IAI3C;;;;OAIG;IACG,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAM/C;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAYjC;;;;OAIG;IACG,SAAS,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;IAuB5C;;;;;;OAMG;IACG,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAIjE;;;;;;;;OAQG;IACG,QAAQ,CACZ,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,OAAO,EACd,MAAM,CAAC,EAAE,WAAW,EACpB,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,OAAO,CAAC;IAkCnB;;;;OAIG;IACG,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;YAQhC,eAAe;YAqBf,oBAAoB;CAoBnC"}

package/dist/mcp/stdio-adapter.js

@@ -0,0 +1,178 @@
+import { Client } from "@modelcontextprotocol/sdk/client/index.js";
+import { StdioClientTransport, } from "@modelcontextprotocol/sdk/client/stdio.js";
+const createRequestId = () => `mcp-stdio-${Date.now()}-${Math.random().toString(36).slice(2, 10)}`;
+/**
+ * MCP stdio 传输适配器。
+ */
+export class McpStdioAdapter {
+    transport = "stdio";
+    options;
+    maxReconnectAttempts = 3;
+    client = null;
+    transportImpl = null;
+    reconnecting = false;
+    closedManually = false;
+    connected = false;
+    serverUri = "";
+    pendingRequests = new Map();
+    /**
+     * 创建 stdio MCP 适配器。
+     *
+     * @param options stdio 启动参数
+     */
+    constructor(options) {
+        this.options = options;
+    }
+    /**
+     * 建立 MCP 连接。
+     *
+     * @param serverUri 服务端 URI（可留空）
+     */
+    async connect(serverUri) {
+        this.serverUri = serverUri;
+        this.closedManually = false;
+        await this.connectInternal();
+    }
+    /**
+     * 断开连接。
+     */
+    async disconnect() {
+        this.closedManually = true;
+        this.connected = false;
+        for (const controller of this.pendingRequests.values()) {
+            controller.abort(new Error("MCP stdio adapter disconnected"));
+        }
+        this.pendingRequests.clear();
+        await this.transportImpl?.close().catch(() => undefined);
+        this.transportImpl = null;
+        this.client = null;
+    }
+    /**
+     * 列出远端工具并映射为引擎 ToolDescriptor。
+     *
+     * @returns 工具描述符数组
+     */
+    async listTools() {
+        if (!this.client) {
+            throw new Error("MCP stdio adapter not connected");
+        }
+        const response = await this.client.listTools();
+        return response.tools.map((tool) => ({
+            kind: "tool",
+            name: tool.name,
+            description: tool.description ?? `mcp tool: ${tool.name}`,
+            sideEffect: tool.annotations?.readOnlyHint
+                ? "readonly"
+                : tool.annotations?.destructiveHint
+                    ? "irreversible"
+                    : "write",
+            idempotent: tool.annotations?.idempotentHint ?? false,
+            requiresApproval: tool.annotations?.destructiveHint ?? false,
+            timeout: 30_000,
+            inputSchema: tool.inputSchema,
+            outputSchema: tool.outputSchema,
+            execute: `mcp:${this.options.serverId ?? "stdio"}:${tool.name}`,
+        }));
+    }
+    /**
+     * 调用远端工具（core 协议方法）。
+     *
+     * @param name 工具名
+     * @param input 入参
+     * @returns 工具执行结果
+     */
+    async executeTool(name, input) {
+        return this.callTool(name, input);
+    }
+    /**
+     * 调用远端工具（支持 AbortSignal）。
+     *
+     * @param name 工具名
+     * @param input 入参
+     * @param signal 取消信号
+     * @param requestId 请求 ID（可选；用于后续 cancel 显式取消）
+     * @returns 工具执行结果
+     */
+    async callTool(name, input, signal, requestId) {
+        if (!this.client) {
+            throw new Error("MCP stdio adapter not connected");
+        }
+        const mappedRequestId = requestId?.trim() ? requestId : createRequestId();
+        if (this.pendingRequests.has(mappedRequestId)) {
+            throw new Error(`MCP stdio request already in progress: ${mappedRequestId}`);
+        }
+        const controller = new AbortController();
+        const onAbort = () => {
+            controller.abort(signal?.reason ?? new Error(`MCP stdio request aborted: ${mappedRequestId}`));
+        };
+        if (signal?.aborted) {
+            onAbort();
+        }
+        else {
+            signal?.addEventListener("abort", onAbort, { once: true });
+        }
+        this.pendingRequests.set(mappedRequestId, controller);
+        try {
+            const result = await this.client.callTool({ name, arguments: (input ?? {}) }, undefined, { signal: controller.signal });
+            return result;
+        }
+        finally {
+            signal?.removeEventListener("abort", onAbort);
+            this.pendingRequests.delete(mappedRequestId);
+        }
+    }
+    /**
+     * 按 requestId 取消请求（通过信号机制由调用方透传）。
+     *
+     * @param _requestId 请求 ID
+     */
+    async cancel(requestId) {
+        const controller = this.pendingRequests.get(requestId);
+        if (!controller) {
+            return;
+        }
+        controller.abort(new Error(`MCP stdio request cancelled: ${requestId}`));
+    }
+    async connectInternal() {
+        const serverParams = {
+            command: this.options.command,
+            ...(this.options.args ? { args: this.options.args } : {}),
+            ...(this.options.env ? { env: this.options.env } : {}),
+            ...(this.options.cwd ? { cwd: this.options.cwd } : {}),
+            stderr: "pipe",
+        };
+        this.client = new Client({ name: "tachu-mcp-stdio", version: "1.0.0" });
+        this.transportImpl = new StdioClientTransport(serverParams);
+        this.transportImpl.onclose = () => {
+            this.connected = false;
+            if (!this.closedManually) {
+                void this.reconnectWithBackoff();
+            }
+        };
+        await this.client.connect(this.transportImpl);
+        this.connected = true;
+    }
+    async reconnectWithBackoff() {
+        if (this.reconnecting || this.closedManually) {
+            return;
+        }
+        this.reconnecting = true;
+        try {
+            for (let attempt = 0; attempt < this.maxReconnectAttempts; attempt += 1) {
+                const delay = 200 * 2 ** attempt;
+                await new Promise((resolve) => setTimeout(resolve, delay));
+                try {
+                    await this.connectInternal();
+                    return;
+                }
+                catch {
+                    // retry
+                }
+            }
+        }
+        finally {
+            this.reconnecting = false;
+        }
+    }
+}
+//# sourceMappingURL=stdio-adapter.js.map

package/dist/mcp/stdio-adapter.js.map

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

package/dist/observability/index.d.ts

@@ -0,0 +1,3 @@
+export { OtelEmitter } from "./otel-emitter";
+export { JsonlEmitter } from "./jsonl-emitter";
+//# sourceMappingURL=index.d.ts.map

package/dist/observability/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/observability/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/observability/index.js

@@ -0,0 +1,3 @@
+export { OtelEmitter } from "./otel-emitter";
+export { JsonlEmitter } from "./jsonl-emitter";
+//# sourceMappingURL=index.js.map

package/dist/observability/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/observability/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/observability/jsonl-emitter.d.ts

@@ -0,0 +1,58 @@
+import type { EngineEvent, ObservabilityEmitter } from "@tachu/core";
+type EventHandler = (event: EngineEvent) => void;
+interface JsonlEmitterOptions {
+    filePath: string;
+    rotateSize?: number;
+}
+/**
+ * JSON Lines 文件事件发射器。
+ */
+export declare class JsonlEmitter implements ObservabilityEmitter {
+    private readonly handlers;
+    private readonly filePath;
+    private readonly rotateSize;
+    private masker;
+    private writeQueue;
+    /**
+     * 创建 JSONL 发射器。
+     *
+     * @param options 文件配置
+     */
+    constructor(options: JsonlEmitterOptions);
+    /**
+     * 订阅事件。
+     *
+     * @param type 事件类型
+     * @param handler 处理器
+     * @returns 取消订阅函数
+     */
+    on(type: EngineEvent["type"] | "*", handler: EventHandler): () => void;
+    /**
+     * 取消订阅。
+     *
+     * @param type 事件类型
+     * @param handler 处理器
+     */
+    off(type: EngineEvent["type"] | "*", handler: EventHandler): void;
+    /**
+     * 发射并持久化事件。
+     *
+     * @param event 引擎事件
+     */
+    emit(event: EngineEvent): void;
+    /**
+     * 设置脱敏函数。
+     *
+     * @param masker 脱敏函数
+     */
+    setMasker(masker: (payload: unknown) => unknown): void;
+    /**
+     * 等待队列写入完成。
+     */
+    dispose(): Promise<void>;
+    private emitToSubscribers;
+    private append;
+    private rotateIfNeeded;
+}
+export {};
+//# sourceMappingURL=jsonl-emitter.d.ts.map

package/dist/observability/jsonl-emitter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonl-emitter.d.ts","sourceRoot":"","sources":["../../src/observability/jsonl-emitter.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAErE,KAAK,YAAY,GAAG,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAAC;AAEjD,UAAU,mBAAmB;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,qBAAa,YAAa,YAAW,oBAAoB;IACvD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA2D;IACpF,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,MAAM,CAAuD;IACrE,OAAO,CAAC,UAAU,CAAqB;IAEvC;;;;OAIG;gBACS,OAAO,EAAE,mBAAmB;IAKxC;;;;;;OAMG;IACH,EAAE,CAAC,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,GAAG,EAAE,OAAO,EAAE,YAAY,GAAG,MAAM,IAAI;IAOtE;;;;;OAKG;IACH,GAAG,CAAC,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,GAAG,EAAE,OAAO,EAAE,YAAY,GAAG,IAAI;IAQjE;;;;OAIG;IACH,IAAI,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI;IAS9B;;;;OAIG;IACH,SAAS,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,GAAG,IAAI;IAItD;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAI9B,OAAO,CAAC,iBAAiB;YASX,MAAM;YAMN,cAAc;CAQ7B"}