@next-open-ai/openclawx 0.6.6

package/dist/core/installer/skill-installer.js

@@ -0,0 +1,215 @@
+/**
+ * 核心安装模块：按 URL 或按路径安装技能到全局或工作区，不依赖 Nest。
+ * 供 install_skill 工具、Gateway、CLI 等统一使用。
+ */
+import { readFile, readdir, stat, mkdir, rm, cp, realpath } from "fs/promises";
+import { existsSync } from "fs";
+import { join, resolve, basename } from "path";
+import { tmpdir } from "os";
+import { randomUUID } from "crypto";
+import AdmZip from "adm-zip";
+import { exec } from "child_process";
+import { promisify } from "util";
+import { homedir } from "os";
+import { getOpenbotAgentDir, getOpenbotWorkspaceDir } from "../agent/agent-dir.js";
+const execAsync = promisify(exec);
+function getDesktopDir() {
+    const home = process.env.HOME || process.env.USERPROFILE || homedir();
+    return join(home, ".openbot", "desktop");
+}
+/** 解析 targetAgentId 得到安装目标：global 或 workspace + 工作区名 */
+export async function resolveInstallTarget(targetAgentId) {
+    const tid = (targetAgentId ?? "").trim().toLowerCase();
+    if (tid === "global" || tid === "all") {
+        return { scope: "global", workspace: "default" };
+    }
+    if (!tid) {
+        return { scope: "workspace", workspace: "default" };
+    }
+    const agentsPath = join(getDesktopDir(), "agents.json");
+    if (!existsSync(agentsPath)) {
+        return { scope: "workspace", workspace: tid };
+    }
+    try {
+        const raw = await readFile(agentsPath, "utf-8");
+        const data = JSON.parse(raw);
+        const agents = Array.isArray(data.agents) ? data.agents : [];
+        const agent = agents.find((a) => a.id === tid);
+        const workspace = agent?.workspace?.trim() || tid;
+        return { scope: "workspace", workspace };
+    }
+    catch {
+        return { scope: "workspace", workspace: tid };
+    }
+}
+function getGlobalSkillsDir() {
+    return join(getOpenbotAgentDir(), "skills");
+}
+function getWorkspaceSkillsDir(workspaceName) {
+    return join(getOpenbotWorkspaceDir(), workspaceName, "skills");
+}
+/**
+ * 通过 npx skills add 安装技能到指定目录（与 Nest SkillsService 逻辑一致）。
+ */
+export async function installSkillByUrl(url, options = { scope: "global", workspace: "default" }) {
+    const scope = options.scope ?? "global";
+    const workspaceName = options.workspace ?? "default";
+    const targetDir = scope === "workspace"
+        ? getWorkspaceSkillsDir(workspaceName)
+        : getGlobalSkillsDir();
+    const tempDir = join(tmpdir(), `openbot-skills-${randomUUID()}`);
+    const tempAgentsSkills = join(tempDir, ".agents", "skills");
+    const tempPiSkills = join(tempDir, ".pi", "skills");
+    let stdout = "";
+    let stderr = "";
+    try {
+        await mkdir(tempPiSkills, { recursive: true });
+        const { stdout: out, stderr: err } = await execAsync(`npx skills add "${url.trim()}" -a pi -y`, { cwd: tempDir, maxBuffer: 4 * 1024 * 1024 });
+        stdout = out || "";
+        stderr = err || "";
+        await mkdir(targetDir, { recursive: true });
+        const sourceDir = existsSync(tempAgentsSkills) ? tempAgentsSkills : tempPiSkills;
+        const entries = await readdir(sourceDir).catch(() => []);
+        for (const entry of entries) {
+            const src = join(sourceDir, entry);
+            const entryStat = await stat(src).catch(() => null);
+            if (!entryStat?.isDirectory())
+                continue;
+            const dest = join(targetDir, entry);
+            const srcResolved = await realpath(src).catch(() => src);
+            await cp(srcResolved, dest, { recursive: true });
+        }
+    }
+    finally {
+        await rm(tempDir, { recursive: true, force: true }).catch(() => { });
+    }
+    return { stdout, stderr, installDir: targetDir };
+}
+const SKILL_NAME_REGEX = /^[a-zA-Z0-9_-]+$/;
+/**
+ * 从本地目录安装技能：将指定目录复制到目标 skills 目录。
+ */
+export async function installSkillFromPath(localPath, options = { scope: "global", workspace: "default" }) {
+    const pathToUse = resolve(localPath.trim());
+    if (!existsSync(pathToUse)) {
+        throw new Error("本地路径不存在");
+    }
+    const pathStat = await stat(pathToUse);
+    if (!pathStat.isDirectory()) {
+        throw new Error("请选择技能目录");
+    }
+    const skillMdPath = join(pathToUse, "SKILL.md");
+    if (!existsSync(skillMdPath)) {
+        throw new Error("该目录下未找到 SKILL.md，不是有效的技能目录");
+    }
+    const scope = options.scope ?? "global";
+    const workspaceName = options.workspace ?? "default";
+    const targetDir = scope === "workspace"
+        ? getWorkspaceSkillsDir(workspaceName)
+        : getGlobalSkillsDir();
+    const baseName = basename(pathToUse) || "skill";
+    if (!baseName || !SKILL_NAME_REGEX.test(baseName)) {
+        throw new Error("技能目录名须为英文、数字、下划线或连字符");
+    }
+    const destPath = join(targetDir, baseName);
+    await mkdir(targetDir, { recursive: true });
+    if (existsSync(destPath)) {
+        await rm(destPath, { recursive: true });
+    }
+    const srcResolved = await realpath(pathToUse).catch(() => pathToUse);
+    await cp(srcResolved, destPath, { recursive: true });
+    return { installDir: targetDir, name: baseName };
+}
+/** 上传 zip 包最大体积（字节） */
+const MAX_UPLOAD_ZIP_BYTES = 10 * 1024 * 1024;
+/** 解压后忽略的条目（系统/打包产生的噪音） */
+const IGNORED_ZIP_ENTRIES = new Set(["__MACOSX", ".DS_Store", ".git", "Thumbs.db"]);
+function isIgnoredZipEntry(name) {
+    if (!name || name.includes(".."))
+        return true;
+    if (IGNORED_ZIP_ENTRIES.has(name))
+        return true;
+    if (name.startsWith("."))
+        return true;
+    return false;
+}
+/**
+ * 从上传的 zip 安装技能：解压到临时目录，校验为单个技能目录（含 SKILL.md），再复制到目标。
+ * 支持两种 zip 结构：① 单个顶层目录且内含 SKILL.md；② 根目录直接含 SKILL.md（将视为技能根目录）。
+ */
+export async function installSkillFromUpload(zipBuffer, options = { scope: "global", workspace: "default" }) {
+    if (zipBuffer.length > MAX_UPLOAD_ZIP_BYTES) {
+        throw new Error("zip 包不能超过 10MB");
+    }
+    const tempDir = join(tmpdir(), `openbot-upload-${randomUUID()}`);
+    try {
+        await mkdir(tempDir, { recursive: true });
+        const zip = new AdmZip(zipBuffer);
+        zip.extractAllTo(tempDir, true);
+        const allEntries = await readdir(tempDir);
+        const entries = allEntries.filter((e) => !isIgnoredZipEntry(e));
+        let skillPath;
+        if (entries.length === 0) {
+            throw new Error("zip 解压后未得到有效内容，请检查 zip 是否包含技能目录或 SKILL.md");
+        }
+        if (entries.length === 1) {
+            const singleName = entries[0];
+            const candidatePath = join(tempDir, singleName);
+            const statEntry = await stat(candidatePath);
+            if (statEntry.isDirectory()) {
+                const skillMdInDir = join(candidatePath, "SKILL.md");
+                if (existsSync(skillMdInDir)) {
+                    skillPath = candidatePath;
+                }
+                else {
+                    throw new Error("该目录下未找到 SKILL.md，请确保 zip 内技能目录根目录含有 SKILL.md 文件");
+                }
+            }
+            else {
+                if (existsSync(join(tempDir, "SKILL.md"))) {
+                    throw new Error("zip 根目录含有 SKILL.md，但根目录下还有其它文件，请将整个技能放在一个子目录内再打包");
+                }
+                throw new Error("zip 内未找到包含 SKILL.md 的技能目录，请检查打包方式");
+            }
+        }
+        else {
+            const skillMdAtRoot = existsSync(join(tempDir, "SKILL.md"));
+            const dirsWithSkillMd = [];
+            for (const e of entries) {
+                const p = join(tempDir, e);
+                const st = await stat(p).catch(() => null);
+                if (st?.isDirectory() && existsSync(join(p, "SKILL.md")))
+                    dirsWithSkillMd.push(p);
+            }
+            if (dirsWithSkillMd.length === 1) {
+                skillPath = dirsWithSkillMd[0];
+            }
+            else if (dirsWithSkillMd.length > 1) {
+                throw new Error("zip 内包含多个技能目录，请只保留一个技能目录再打包");
+            }
+            else if (skillMdAtRoot) {
+                skillPath = tempDir;
+            }
+            else {
+                throw new Error("zip 内未找到包含 SKILL.md 的技能目录；若为多文件打包，请将 SKILL.md 放在 zip 根目录或单个子目录内");
+            }
+        }
+        if (skillPath === tempDir) {
+            const baseName = "skill";
+            const wrappedDir = join(tmpdir(), `openbot-skill-wrap-${randomUUID()}`);
+            try {
+                await mkdir(wrappedDir, { recursive: true });
+                const destPath = join(wrappedDir, baseName);
+                await cp(tempDir, destPath, { recursive: true });
+                return await installSkillFromPath(destPath, options);
+            }
+            finally {
+                await rm(wrappedDir, { recursive: true, force: true }).catch(() => { });
+            }
+        }
+        return await installSkillFromPath(skillPath, options);
+    }
+    finally {
+        await rm(tempDir, { recursive: true, force: true }).catch(() => { });
+    }
+}

package/dist/core/mcp/adapter.d.ts

@@ -0,0 +1,17 @@
+/**
+ * MCP Tool 转为 pi-coding-agent ToolDefinition 的适配层。
+ */
+import type { ToolDefinition } from "@mariozechner/pi-coding-agent";
+import type { McpTool } from "./types.js";
+import type { McpClient } from "./client.js";
+/**
+ * 将单个 MCP 工具封装为 pi-coding-agent 的 ToolDefinition。
+ * @param tool MCP tools/list 返回的项
+ * @param client 已连接的 McpClient，用于 callTool
+ * @param serverId 可选前缀，用于避免多 MCP 时工具名冲突
+ */
+export declare function mcpToolToToolDefinition(tool: McpTool, client: McpClient, serverId?: string): ToolDefinition;
+/**
+ * 将某 MCP 客户端的全部工具转为 ToolDefinition 数组。
+ */
+export declare function mcpToolsToToolDefinitions(tools: McpTool[], client: McpClient, serverId?: string): ToolDefinition[];

package/dist/core/mcp/adapter.js

@@ -0,0 +1,49 @@
+/**
+ * MCP Tool 转为 pi-coding-agent ToolDefinition 的适配层。
+ */
+import { Type } from "@sinclair/typebox";
+/** 通用参数：MCP 工具接受任意 JSON 对象作为 arguments */
+const McpToolParamsSchema = Type.Record(Type.String(), Type.Any());
+/**
+ * 将单个 MCP 工具封装为 pi-coding-agent 的 ToolDefinition。
+ * @param tool MCP tools/list 返回的项
+ * @param client 已连接的 McpClient，用于 callTool
+ * @param serverId 可选前缀，用于避免多 MCP 时工具名冲突
+ */
+export function mcpToolToToolDefinition(tool, client, serverId) {
+    const name = serverId ? `${serverId}_${tool.name}` : tool.name;
+    const description = (tool.description ?? "").trim() || `MCP tool: ${tool.name}`;
+    return {
+        name,
+        label: tool.name,
+        description,
+        parameters: McpToolParamsSchema,
+        execute: async (_toolCallId, params, _signal, _onUpdate, _ctx) => {
+            const args = params && typeof params === "object" ? params : {};
+            try {
+                const result = await client.callTool(tool.name, args);
+                const text = result.content
+                    ?.filter((c) => c.type === "text")
+                    .map((c) => c.text)
+                    .join("\n") ?? (result.isError ? "MCP 调用返回错误" : "");
+                return {
+                    content: [{ type: "text", text }],
+                    details: result.isError ? { isError: true } : undefined,
+                };
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                return {
+                    content: [{ type: "text", text: `MCP 调用失败: ${msg}` }],
+                    details: undefined,
+                };
+            }
+        },
+    };
+}
+/**
+ * 将某 MCP 客户端的全部工具转为 ToolDefinition 数组。
+ */
+export function mcpToolsToToolDefinitions(tools, client, serverId) {
+    return tools.map((t) => mcpToolToToolDefinition(t, client, serverId));
+}

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

@@ -0,0 +1,24 @@
+/**
+ * MCP 客户端：连接、list_tools、call_tool、断开。
+ * 支持 stdio（本地进程）与 sse（远程 HTTP）两种传输。
+ */
+import type { McpTool, McpToolCallResult, IMcpTransport } from "./types.js";
+import type { McpServerConfig } from "./types.js";
+export interface McpClientOptions {
+    initTimeoutMs?: number;
+    requestTimeoutMs?: number;
+}
+export declare class McpClient {
+    private transport;
+    private _tools;
+    private _requestId;
+    constructor(configOrTransport: McpServerConfig | IMcpTransport, options?: McpClientOptions);
+    /** 建立连接并完成握手；成功后可使用 listTools / callTool */
+    connect(): Promise<void>;
+    /** 获取工具列表（会缓存；断开重连后需重新 list） */
+    listTools(): Promise<McpTool[]>;
+    /** 调用指定工具 */
+    callTool(name: string, args: Record<string, unknown>): Promise<McpToolCallResult>;
+    close(): Promise<void>;
+    get isConnected(): boolean;
+}

package/dist/core/mcp/client.js

@@ -0,0 +1,70 @@
+/**
+ * MCP 客户端：连接、list_tools、call_tool、断开。
+ * 支持 stdio（本地进程）与 sse（远程 HTTP）两种传输。
+ */
+import { createTransport } from "./transport/index.js";
+export class McpClient {
+    transport;
+    _tools = null;
+    _requestId = 0;
+    constructor(configOrTransport, options = {}) {
+        if (typeof configOrTransport.request === "function" &&
+            typeof configOrTransport.start === "function") {
+            this.transport = configOrTransport;
+        }
+        else {
+            this.transport = createTransport(configOrTransport, {
+                initTimeoutMs: options.initTimeoutMs,
+                requestTimeoutMs: options.requestTimeoutMs,
+            });
+        }
+    }
+    /** 建立连接并完成握手；成功后可使用 listTools / callTool */
+    async connect() {
+        await this.transport.start();
+    }
+    /** 获取工具列表（会缓存；断开重连后需重新 list） */
+    async listTools() {
+        if (this._tools !== null) {
+            return this._tools;
+        }
+        const res = await this.transport.request({
+            jsonrpc: "2.0",
+            id: ++this._requestId,
+            method: "tools/list",
+        });
+        if (res.error) {
+            throw new Error(`MCP tools/list failed: ${res.error.message}`);
+        }
+        const list = res.result?.tools;
+        this._tools = Array.isArray(list) ? list : [];
+        return this._tools;
+    }
+    /** 调用指定工具 */
+    async callTool(name, args) {
+        const res = await this.transport.request({
+            jsonrpc: "2.0",
+            id: ++this._requestId,
+            method: "tools/call",
+            params: { name, arguments: args ?? {} },
+        });
+        if (res.error) {
+            return {
+                content: [{ type: "text", text: `MCP call_tool error: ${res.error.message}` }],
+                isError: true,
+            };
+        }
+        const result = res.result;
+        if (!result || !Array.isArray(result.content)) {
+            return { content: [{ type: "text", text: "Invalid MCP tools/call result" }], isError: true };
+        }
+        return result;
+    }
+    async close() {
+        this._tools = null;
+        await this.transport.close();
+    }
+    get isConnected() {
+        return this.transport.isConnected;
+    }
+}

package/dist/core/mcp/config.d.ts

@@ -0,0 +1,22 @@
+/**
+ * MCP 配置解析与校验。
+ * 从 getOrCreateSession 的 options.mcpServers 中取出并规范化，支持 stdio 与 sse。
+ */
+import type { McpServerConfig, McpServerConfigStdio, McpServerConfigSse } from "./types.js";
+/**
+ * 从会话选项里解析出本会话启用的 MCP 服务器配置列表。
+ * 支持 stdio（本地进程）与 sse（远程 HTTP）。
+ */
+export declare function resolveMcpServersForSession(mcpServers: McpServerConfig[] | undefined): McpServerConfig[];
+/**
+ * 为 stdio 配置生成缓存键（用于 Operator 复用同一进程连接）
+ */
+export declare function stdioConfigKey(config: McpServerConfigStdio): string;
+/**
+ * 为 sse 配置生成缓存键
+ */
+export declare function sseConfigKey(config: McpServerConfigSse): string;
+/**
+ * 任意 MCP 配置的缓存键
+ */
+export declare function mcpConfigKey(config: McpServerConfig): string;

package/dist/core/mcp/config.js

@@ -0,0 +1,69 @@
+/**
+ * MCP 配置解析与校验。
+ * 从 getOrCreateSession 的 options.mcpServers 中取出并规范化，支持 stdio 与 sse。
+ */
+/**
+ * 从会话选项里解析出本会话启用的 MCP 服务器配置列表。
+ * 支持 stdio（本地进程）与 sse（远程 HTTP）。
+ */
+export function resolveMcpServersForSession(mcpServers) {
+    if (!Array.isArray(mcpServers) || mcpServers.length === 0) {
+        return [];
+    }
+    const result = [];
+    for (const s of mcpServers) {
+        if (!s || typeof s !== "object")
+            continue;
+        if (s.transport === "stdio") {
+            if (typeof s.command !== "string" || !s.command.trim()) {
+                console.warn("[mcp] 跳过无效 stdio 配置：缺少或无效 command");
+                continue;
+            }
+            result.push({
+                transport: "stdio",
+                command: s.command.trim(),
+                args: Array.isArray(s.args) ? s.args : undefined,
+                env: s.env && typeof s.env === "object" ? s.env : undefined,
+            });
+        }
+        else if (s.transport === "sse") {
+            const url = s.url?.trim();
+            if (!url) {
+                console.warn("[mcp] 跳过无效 sse 配置：缺少或无效 url");
+                continue;
+            }
+            result.push({
+                transport: "sse",
+                url,
+                headers: s.headers && typeof s.headers === "object" ? s.headers : undefined,
+            });
+        }
+        else {
+            console.warn("[mcp] 未知 transport:", s.transport);
+        }
+    }
+    return result;
+}
+/**
+ * 为 stdio 配置生成缓存键（用于 Operator 复用同一进程连接）
+ */
+export function stdioConfigKey(config) {
+    const args = (config.args ?? []).join(" ");
+    const envStr = config.env ? JSON.stringify(config.env) : "";
+    return `stdio:${config.command}\0${args}\0${envStr}`;
+}
+/**
+ * 为 sse 配置生成缓存键
+ */
+export function sseConfigKey(config) {
+    const headersStr = config.headers ? JSON.stringify(config.headers) : "";
+    return `sse:${config.url}\0${headersStr}`;
+}
+/**
+ * 任意 MCP 配置的缓存键
+ */
+export function mcpConfigKey(config) {
+    if (config.transport === "stdio")
+        return stdioConfigKey(config);
+    return sseConfigKey(config);
+}

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

@@ -0,0 +1,18 @@
+/**
+ * Core MCP 模块：为 SessionAgent 提供 MCP Tools 能力（Client 端）。
+ * 配置在创建 Session 时通过 options.mcpServers 传入，与 Skill 类似。
+ */
+import type { ToolDefinition } from "@mariozechner/pi-coding-agent";
+import type { McpServerConfig } from "./types.js";
+export type { McpServerConfig, McpServerConfigStdio, McpServerConfigSse, McpTool } from "./types.js";
+export { resolveMcpServersForSession, stdioConfigKey, sseConfigKey, mcpConfigKey } from "./config.js";
+export { McpClient } from "./client.js";
+export { getMcpToolDefinitions, shutdownMcpClients } from "./operator.js";
+export { mcpToolToToolDefinition, mcpToolsToToolDefinitions } from "./adapter.js";
+/**
+ * 根据会话选项中的 mcpServers 配置，返回该会话可用的 MCP 工具（ToolDefinition 数组）。
+ * 在 AgentManager.getOrCreateSession 中调用，并入 customTools。
+ */
+export declare function createMcpToolsForSession(options: {
+    mcpServers?: McpServerConfig[];
+}): Promise<ToolDefinition[]>;

package/dist/core/mcp/index.js

@@ -0,0 +1,20 @@
+/**
+ * Core MCP 模块：为 SessionAgent 提供 MCP Tools 能力（Client 端）。
+ * 配置在创建 Session 时通过 options.mcpServers 传入，与 Skill 类似。
+ */
+import { resolveMcpServersForSession } from "./config.js";
+import { getMcpToolDefinitions } from "./operator.js";
+export { resolveMcpServersForSession, stdioConfigKey, sseConfigKey, mcpConfigKey } from "./config.js";
+export { McpClient } from "./client.js";
+export { getMcpToolDefinitions, shutdownMcpClients } from "./operator.js";
+export { mcpToolToToolDefinition, mcpToolsToToolDefinitions } from "./adapter.js";
+/**
+ * 根据会话选项中的 mcpServers 配置，返回该会话可用的 MCP 工具（ToolDefinition 数组）。
+ * 在 AgentManager.getOrCreateSession 中调用，并入 customTools。
+ */
+export async function createMcpToolsForSession(options) {
+    const configs = resolveMcpServersForSession(options.mcpServers);
+    if (configs.length === 0)
+        return [];
+    return getMcpToolDefinitions(configs);
+}

package/dist/core/mcp/operator.d.ts

@@ -0,0 +1,15 @@
+/**
+ * MCP Operator：管理 MCP 客户端生命周期，按配置为会话提供 ToolDefinition 列表。
+ * 支持 stdio（本地）与 sse（远程）两种传输。
+ */
+import type { McpServerConfig } from "./types.js";
+import type { ToolDefinition } from "@mariozechner/pi-coding-agent";
+/**
+ * 为给定 MCP 服务器配置列表获取或创建客户端，并返回其工具对应的 ToolDefinition 数组。
+ * 连接失败或 list_tools 失败的 server 会被跳过并打日志，不阻塞整体。
+ */
+export declare function getMcpToolDefinitions(serverConfigs: McpServerConfig[]): Promise<ToolDefinition[]>;
+/**
+ * 关闭并移除所有缓存的 MCP 客户端（进程退出或显式清理时调用）。
+ */
+export declare function shutdownMcpClients(): Promise<void>;

package/dist/core/mcp/operator.js

@@ -0,0 +1,72 @@
+/**
+ * MCP Operator：管理 MCP 客户端生命周期，按配置为会话提供 ToolDefinition 列表。
+ * 支持 stdio（本地）与 sse（远程）两种传输。
+ */
+import { mcpConfigKey } from "./config.js";
+import { McpClient } from "./client.js";
+import { mcpToolsToToolDefinitions } from "./adapter.js";
+/** 按配置键缓存的客户端 */
+const clientCache = new Map();
+function configLabel(config) {
+    if (config.transport === "stdio")
+        return config.command;
+    return config.url;
+}
+/**
+ * 为给定 MCP 服务器配置列表获取或创建客户端，并返回其工具对应的 ToolDefinition 数组。
+ * 连接失败或 list_tools 失败的 server 会被跳过并打日志，不阻塞整体。
+ */
+export async function getMcpToolDefinitions(serverConfigs) {
+    const allTools = [];
+    for (let i = 0; i < serverConfigs.length; i++) {
+        const config = serverConfigs[i];
+        const key = mcpConfigKey(config);
+        let client = clientCache.get(key);
+        if (!client) {
+            client = new McpClient(config);
+            try {
+                await client.connect();
+                clientCache.set(key, client);
+            }
+            catch (err) {
+                console.warn(`[mcp] 连接失败 (${configLabel(config)}):`, err instanceof Error ? err.message : err);
+                continue;
+            }
+        }
+        if (!client.isConnected) {
+            clientCache.delete(key);
+            try {
+                await client.close();
+            }
+            catch { }
+            const newClient = new McpClient(config);
+            try {
+                await newClient.connect();
+                clientCache.set(key, newClient);
+                client = newClient;
+            }
+            catch (err) {
+                console.warn(`[mcp] 重连失败 (${configLabel(config)}):`, err instanceof Error ? err.message : err);
+                continue;
+            }
+        }
+        try {
+            const tools = await client.listTools();
+            const serverId = `mcp${i}`;
+            const definitions = mcpToolsToToolDefinitions(tools, client, serverId);
+            allTools.push(...definitions);
+        }
+        catch (err) {
+            console.warn(`[mcp] list_tools 失败 (${configLabel(config)}):`, err instanceof Error ? err.message : err);
+        }
+    }
+    return allTools;
+}
+/**
+ * 关闭并移除所有缓存的 MCP 客户端（进程退出或显式清理时调用）。
+ */
+export async function shutdownMcpClients() {
+    const closeAll = Array.from(clientCache.values()).map((c) => c.close().catch(() => { }));
+    clientCache.clear();
+    await Promise.all(closeAll);
+}

package/dist/core/mcp/transport/index.d.ts

@@ -0,0 +1,11 @@
+import type { McpServerConfig, IMcpTransport } from "../types.js";
+export interface TransportOptions {
+    initTimeoutMs?: number;
+    requestTimeoutMs?: number;
+}
+/**
+ * 根据配置创建对应的传输层实例。
+ */
+export declare function createTransport(config: McpServerConfig, options?: TransportOptions): IMcpTransport;
+export { StdioTransport } from "./stdio.js";
+export { SseTransport } from "./sse.js";

package/dist/core/mcp/transport/index.js

@@ -0,0 +1,16 @@
+import { StdioTransport } from "./stdio.js";
+import { SseTransport } from "./sse.js";
+/**
+ * 根据配置创建对应的传输层实例。
+ */
+export function createTransport(config, options) {
+    if (config.transport === "stdio") {
+        return new StdioTransport(config, options);
+    }
+    if (config.transport === "sse") {
+        return new SseTransport(config, options);
+    }
+    throw new Error(`Unsupported MCP transport: ${config.transport}`);
+}
+export { StdioTransport } from "./stdio.js";
+export { SseTransport } from "./sse.js";

package/dist/core/mcp/transport/sse.d.ts

@@ -0,0 +1,20 @@
+/**
+ * MCP SSE/HTTP 传输：通过 HTTP POST 向远程 URL 发送 JSON-RPC 请求，响应在 response body。
+ */
+import type { McpServerConfigSse } from "../types.js";
+import type { JsonRpcRequest, JsonRpcResponse } from "../types.js";
+export interface SseTransportOptions {
+    initTimeoutMs?: number;
+    requestTimeoutMs?: number;
+}
+export declare class SseTransport {
+    private config;
+    private initTimeoutMs;
+    private requestTimeoutMs;
+    private _connected;
+    constructor(config: McpServerConfigSse, options?: SseTransportOptions);
+    start(): Promise<void>;
+    request(req: JsonRpcRequest, timeoutMs?: number): Promise<JsonRpcResponse>;
+    close(): Promise<void>;
+    get isConnected(): boolean;
+}