@zmzai/agent-framework 0.1.0 → 0.2.1

package/dist/core/mcp/client.js

@@ -0,0 +1,286 @@
+import { spawn } from "node:child_process";
+/** Minimal MCP (Model Context Protocol) stdio client. Speaks newline-delimited
+ *  JSON-RPC 2.0 over the spawned server's stdin/stdout — the same framing as
+ *  the official @modelcontextprotocol/sdk stdio transport, without pulling the
+ *  SDK dependency (framework keeps zod/pi as its only runtime deps).
+ *
+ *  Scope (P0): initialize handshake + tools/list + tools/call. Server→client
+ *  requests outside the tool lifecycle are politely refused (-32601) so
+ *  compliant servers never hang waiting on sampling/roots we don't offer. */
+const PROTOCOL_VERSION = "2024-11-05";
+const MAX_FRAME_BYTES = 16 * 1024 * 1024;
+/** 单个 stdio server 累计 stdout 上限（P0 隔离）：超出视为失控/恶意，杀进程。
+ *  正常 JSON-RPC 流量远小于该值；防的是疯狂刷屏把宿主内存打爆。 */
+const MAX_STREAM_BYTES = 64 * 1024 * 1024;
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+export class McpStdioClient {
+    #spec;
+    #opts;
+    #child = null;
+    #buffer = "";
+    #nextId = 1;
+    #pending = new Map();
+    #onRequest;
+    #closed = false;
+    #stdoutBytes = 0;
+    constructor(spec, opts = {}) {
+        this.#spec = spec;
+        this.#opts = {
+            requestTimeoutMs: opts.requestTimeoutMs ?? 30_000,
+            connectTimeoutMs: opts.connectTimeoutMs ?? 15_000,
+            cwd: opts.cwd,
+            baseEnv: opts.baseEnv,
+            allowedCommands: opts.allowedCommands,
+        };
+    }
+    get connected() {
+        return this.#child !== null && !this.#closed && this.#child.exitCode === null;
+    }
+    /** 启动子进程并完成 initialize 握手。失败时保证子进程被回收后抛错。 */
+    async start() {
+        if (this.connected)
+            return;
+        // 白名单校验（P0）：basename 精确匹配，防 mcp.json 里的任意可执行路径
+        const allowed = this.#opts.allowedCommands;
+        if (allowed && allowed.length > 0) {
+            const base = this.#spec.command.split("/").pop().split("\\").pop();
+            if (!allowed.includes(base)) {
+                throw new Error(`MCP server 命令不在白名单内：${this.#spec.command}（允许：${allowed.join(", ")}）`);
+            }
+        }
+        const base = this.#opts.baseEnv ?? Object.fromEntries(Object.entries(process.env).filter((entry) => entry[1] !== undefined));
+        // Next.js 的类型增广把 ProcessEnv.NODE_ENV 声明为必填窄类型，而运行时 env 一定继承自 process.env（含 NODE_ENV），此处断言仅为消除类型误报。
+        const env = { ...base, ...this.#spec.env };
+        let child;
+        try {
+            child = spawn(this.#spec.command, this.#spec.args ?? [], {
+                cwd: this.#spec.cwd ?? this.#opts.cwd,
+                env,
+                stdio: ["pipe", "pipe", "pipe"],
+                windowsHide: true,
+                // posix 下独立进程组：dispose 时整组回收，防 server 自行 fork 的子进程泄漏
+                detached: process.platform !== "win32",
+            });
+        }
+        catch (error) {
+            throw new Error(`MCP server 进程无法启动：${error.message}`);
+        }
+        this.#child = child;
+        child.stdout.setEncoding("utf8");
+        child.stdout.on("data", (chunk) => {
+            this.#stdoutBytes += Buffer.byteLength(chunk);
+            if (this.#stdoutBytes > MAX_STREAM_BYTES) {
+                this.#disposeChild();
+                this.#failAll(new Error(`MCP server 输出超过累计上限（${Math.floor(MAX_STREAM_BYTES / 1024 / 1024)}MB），已强制终止`));
+                return;
+            }
+            this.#consume(chunk);
+        });
+        // stderr 只做环形摘要收集，便于把启动失败原因带给调用方。
+        const stderrTail = [];
+        child.stderr.setEncoding("utf8");
+        child.stderr.on("data", (chunk) => {
+            stderrTail.push(chunk);
+            if (stderrTail.length > 20)
+                stderrTail.shift();
+        });
+        this.#stderrTail = stderrTail;
+        child.on("error", (error) => {
+            this.#failAll(new Error(`MCP server 进程错误：${error.message}`));
+        });
+        child.on("close", (code, signal) => {
+            const detail = stderrTail.length ? `：${stderrTail.join("").trim().slice(-500)}` : "";
+            this.#failAll(new Error(`MCP server 已退出（code=${code ?? "null"}${signal ? ` signal=${signal}` : ""}）${detail}`));
+            this.#child = null;
+        });
+        const timeout = setTimeout(() => {
+            this.#disposeChild();
+            this.#failAll(new Error(`MCP initialize 握手超时（${this.#opts.connectTimeoutMs}ms 无响应）`));
+        }, this.#opts.connectTimeoutMs);
+        try {
+            await this.request("initialize", {
+                protocolVersion: PROTOCOL_VERSION,
+                capabilities: {},
+                clientInfo: { name: "zmzai-agent-framework", version: "0.1.0" },
+            }, timeout);
+            this.notify("notifications/initialized");
+        }
+        catch (error) {
+            this.close();
+            throw error instanceof Error ? error : new Error(String(error));
+        }
+        finally {
+            clearTimeout(timeout);
+        }
+    }
+    #stderrTail = [];
+    /** tools/list 自动翻页聚合全量工具。 */
+    async listTools() {
+        const tools = [];
+        let cursor;
+        do {
+            const result = await this.request("tools/list", cursor ? { cursor } : {});
+            if (Array.isArray(result.tools)) {
+                for (const tool of result.tools) {
+                    if (!isRecord(tool) || typeof tool.name !== "string")
+                        continue;
+                    tools.push({
+                        name: tool.name,
+                        ...(typeof tool.description === "string" ? { description: tool.description } : {}),
+                        ...(isRecord(tool.inputSchema) ? { inputSchema: tool.inputSchema } : {}),
+                    });
+                }
+            }
+            cursor = typeof result.nextCursor === "string" ? result.nextCursor : undefined;
+        } while (cursor);
+        return tools;
+    }
+    async callTool(name, args) {
+        const result = await this.request("tools/call", { name, arguments: args });
+        const isError = result.isError === true;
+        const text = Array.isArray(result.content)
+            ? result.content
+                .map((block) => (isRecord(block) && block.type === "text" && typeof block.text === "string" ? block.text : ""))
+                .filter(Boolean)
+                .join("\n")
+            : "";
+        return { text, isError };
+    }
+    request(method, params, timerOverride) {
+        if (!this.connected)
+            return Promise.reject(new Error(`MCP 连接不可用（method=${method}）`));
+        const id = this.#nextId++;
+        const timer = timerOverride ?? setTimeout(() => {
+            const pending = this.#pending.get(id);
+            if (pending) {
+                this.#pending.delete(id);
+                pending.reject(new Error(`MCP 请求超时：${method}（${this.#opts.requestTimeoutMs}ms）`));
+            }
+        }, this.#opts.requestTimeoutMs);
+        return new Promise((resolve, reject) => {
+            this.#pending.set(id, { resolve: resolve, reject, timer });
+            this.#write({ jsonrpc: "2.0", id, method, ...(params !== undefined ? { params } : {}) });
+        });
+    }
+    notify(method, params) {
+        if (!this.connected)
+            return;
+        const frame = { jsonrpc: "2.0", method, ...(params !== undefined ? { params } : {}) };
+        this.#write(frame);
+    }
+    /** 注册服务器请求回调；返回 false 表示框架不提供该能力（客户端回 -32601）。 */
+    onRequest(handler) {
+        this.#onRequest = handler;
+    }
+    close() {
+        this.#closed = true;
+        this.#disposeChild();
+        this.#failAll(new Error("MCP 连接已由宿主关闭"));
+    }
+    #write(frame) {
+        const child = this.#child;
+        if (!child || !child.stdin?.writable)
+            return;
+        child.stdin.write(JSON.stringify(frame) + "\n");
+    }
+    #consume(chunk) {
+        this.#buffer += chunk;
+        let index;
+        while ((index = this.#buffer.indexOf("\n")) >= 0) {
+            const line = this.#buffer.slice(0, index).trim();
+            this.#buffer = this.#buffer.slice(index + 1);
+            if (!line)
+                continue;
+            if (line.length > MAX_FRAME_BYTES)
+                continue;
+            let frame;
+            try {
+                frame = JSON.parse(line);
+            }
+            catch {
+                continue; // 非 JSON 行（某些 server 往 stdout 打日志）直接丢弃
+            }
+            if (!isRecord(frame) || frame.jsonrpc !== "2.0")
+                continue;
+            if (typeof frame.id === "number") {
+                const pending = this.#pending.get(frame.id);
+                if (!pending)
+                    continue;
+                this.#pending.delete(frame.id);
+                clearTimeout(pending.timer);
+                const rpcError = frame.error;
+                if (rpcError) {
+                    pending.reject(new Error(`MCP 错误 ${rpcError.code ?? "-"}: ${rpcError.message ?? "未知错误"}`));
+                }
+                else {
+                    pending.resolve(frame.result);
+                }
+                continue;
+            }
+            // 服务器通知忽略；服务器主动请求仅在宿主注册了处理器且其返回非 undefined 时给结果，否则 -32601。
+            if (typeof frame.method === "string") {
+                void this.#handleServerInitiated(frame.method, frame.params, typeof frame.id !== "undefined" && frame.id !== null ? Number(frame.id) : null);
+            }
+        }
+    }
+    async #handleServerInitiated(method, params, id) {
+        const handled = this.#onRequest ? await this.#onRequest(method, params) : undefined;
+        if (id === null)
+            return;
+        if (handled !== undefined) {
+            this.#child?.stdin?.write(JSON.stringify({ jsonrpc: "2.0", id, result: handled }) + "\n");
+        }
+        else {
+            this.#child?.stdin?.write(JSON.stringify({ jsonrpc: "2.0", id, error: { code: -32601, message: `Method not found: ${method}` } }) + "\n");
+        }
+    }
+    #disposeChild() {
+        const child = this.#child;
+        if (!child)
+            return;
+        try {
+            child.stdin?.end();
+        }
+        catch {
+            /* already gone */
+        }
+        if (child.exitCode === null) {
+            // 进程组整组回收（spawn detached 时 child.pid 即组长的 pgid）
+            const killGroup = () => {
+                try {
+                    if (process.platform !== "win32" && child.pid)
+                        process.kill(-child.pid, "SIGTERM");
+                    else
+                        child.kill("SIGTERM");
+                }
+                catch {
+                    child.kill("SIGTERM");
+                }
+            };
+            killGroup();
+            setTimeout(() => {
+                if (child.exitCode === null) {
+                    try {
+                        if (process.platform !== "win32" && child.pid)
+                            process.kill(-child.pid, "SIGKILL");
+                        else
+                            child.kill("SIGKILL");
+                    }
+                    catch {
+                        child.kill("SIGKILL");
+                    }
+                }
+            }, 2000).unref();
+        }
+    }
+    #failAll(error) {
+        for (const [, pending] of this.#pending) {
+            clearTimeout(pending.timer);
+            pending.reject(error);
+        }
+        this.#pending.clear();
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/core/mcp/client.js.map

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

package/dist/core/mcp/http-client.d.ts

@@ -0,0 +1,54 @@
+import type { PluginMcpServer } from "../agent/plugin.js";
+import type { McpCallResult, McpToolInfo } from "./client.js";
+/** MCP HTTP 双传输（P0 收尾）：
+ *  - streamable-http（现行规范）：单端点 POST，响应可为 application/json 或
+ *    text/event-stream 帧；initialize 下发的 Mcp-Session-Id 需回传；
+ *    notifications POST 期望 202。
+ *  - sse（遗留）：常开 GET 事件流承载响应；服务端以 endpoint 事件告知 POST 目标。
+ *
+ *  stdio 走既有 McpStdioClient；三者都满足下方 McpClientLike 结构。 */
+export type McpClientLike = {
+    listTools(): Promise<McpToolInfo[]>;
+    callTool(name: string, args: Record<string, unknown>): Promise<McpCallResult>;
+    close(): void;
+};
+/** 增量 SSE 帧解析：data:/event:/id: 行、空行分帧、`:` 开头为注释心跳。 */
+export declare function createSseParser(onEvent: (event: {
+    event: string | null;
+    data: string;
+}) => void): (chunk: string) => void;
+export declare class McpStreamableHttpClient implements McpClientLike {
+    #private;
+    constructor(url: string, opts?: {
+        headers?: Record<string, string>;
+        requestTimeoutMs?: number;
+    });
+    start(): Promise<void>;
+    private postJsonRpc;
+    request(method: string, params?: unknown): Promise<unknown>;
+    notify(method: string, params?: unknown): Promise<void>;
+    listTools(): Promise<McpToolInfo[]>;
+    callTool(name: string, args: Record<string, unknown>): Promise<McpCallResult>;
+    close(): void;
+}
+export declare function toolsFromResult(result: unknown): McpToolInfo[];
+export declare function callFromResult(result: unknown): McpCallResult;
+export declare class McpSseClient implements McpClientLike {
+    #private;
+    constructor(url: string, opts?: {
+        headers?: Record<string, string>;
+        requestTimeoutMs?: number;
+    });
+    start(): Promise<void>;
+    postToEndpoint(payload: Record<string, unknown>): Promise<Response>;
+    private postedRequest;
+    listTools(): Promise<McpToolInfo[]>;
+    callTool(name: string, args: Record<string, unknown>): Promise<McpCallResult>;
+    notifyInitialized(): Promise<void>;
+    close(): void;
+    get closed(): boolean;
+}
+export declare function createMcpHttpClient(spec: PluginMcpServer, opts?: {
+    requestTimeoutMs?: number;
+}): McpClientLike | null;
+//# sourceMappingURL=http-client.d.ts.map

package/dist/core/mcp/http-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-client.d.ts","sourceRoot":"","sources":["../../../src/core/mcp/http-client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE9D;;;;;;yDAMyD;AAEzD,MAAM,MAAM,aAAa,GAAG;IAC1B,SAAS,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IAC9E,KAAK,IAAI,IAAI,CAAC;CACf,CAAC;AAwBF,sDAAsD;AACtD,wBAAgB,eAAe,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE;IAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,KAAK,IAAI,GAAG,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CA8BzH;AAoDD,qBAAa,uBAAwB,YAAW,aAAa;;gBAO/C,GAAG,EAAE,MAAM,EAAE,IAAI,GAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAAC,gBAAgB,CAAC,EAAE,MAAM,CAAA;KAAO;IAM7F,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;YAKd,WAAW;IA4DnB,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAM3D,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IASvD,SAAS,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAInC,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,aAAa,CAAC;IAInF,KAAK,IAAI,IAAI;CAGd;AAKD,wBAAgB,eAAe,CAAC,MAAM,EAAE,OAAO,GAAG,WAAW,EAAE,CAa9D;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,OAAO,GAAG,aAAa,CAU7D;AAID,qBAAa,YAAa,YAAW,aAAa;;gBASpC,GAAG,EAAE,MAAM,EAAE,IAAI,GAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAAC,gBAAgB,CAAC,EAAE,MAAM,CAAA;KAAO;IAM7F,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAoFtB,cAAc,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,QAAQ,CAAC;YAU3D,aAAa;IAQrB,SAAS,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAKnC,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,aAAa,CAAC;IAO7E,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC;IAKxC,KAAK,IAAI,IAAI;IAMb,IAAI,MAAM,IAAI,OAAO,CAEpB;CACF;AAID,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,eAAe,EACrB,IAAI,GAAE;IAAE,gBAAgB,CAAC,EAAE,MAAM,CAAA;CAAO,GACvC,aAAa,GAAG,IAAI,CAStB"}