@ai-zen/agents-sdk 0.2.0-alpha.2

package/dist/config/constants.js

@@ -0,0 +1,185 @@
+import { AgentNS } from "@ai-zen/agents-core";
+// ---------------------------------------------------------------------------
+// 默认 Agent
+// ---------------------------------------------------------------------------
+/** 默认 Agent ID */
+export const DEFAULT_AGENT_ID = "default";
+/** 默认 Agent 定义（不含时间戳） */
+export const DEFAULT_AGENT_DEFINITION = {
+    id: DEFAULT_AGENT_ID,
+    name: "默认助手",
+    description: "默认的 AI 助手，适用于日常问答和任务执行。",
+    messages: [
+        {
+            role: AgentNS.Role.System,
+            content: "你是一个AI助手，专门帮助用户回答问题和执行任务。请用中文回复。",
+        },
+    ],
+    permissions: {
+        tools: { allow: ["*"] },
+        skills: { allow: ["*"] },
+        mcps: { allow: ["*"] },
+        subagents: { allow: ["*"] },
+    },
+};
+// ---------------------------------------------------------------------------
+// 默认 SubAgent
+// ---------------------------------------------------------------------------
+/** 默认 SubAgent ID */
+export const DEFAULT_SUBAGENT_ID = "general-assistant";
+/** 默认 SubAgent 定义（不含时间戳） */
+export const DEFAULT_SUBAGENT_DEFINITION = {
+    id: DEFAULT_SUBAGENT_ID,
+    name: "通用助手",
+    description: "一个通用的子 Agent，擅长独立完成各类任务。",
+    messages: [
+        {
+            role: AgentNS.Role.System,
+            content: "你是一个通用助手，擅长独立完成各类任务。请根据给定的任务描述，认真分析并完成任务。完成任务后直接返回结果，不要解释你的思考过程。",
+        },
+        { role: AgentNS.Role.User, content: "{{query}}" },
+    ],
+    function: {
+        name: "general_assistant",
+        description: "通用助手，可独立完成各类任务",
+        parameters: {
+            type: "object",
+            properties: {
+                query: { type: "string", description: "任务描述" },
+            },
+            required: ["query"],
+            additionalProperties: false,
+        },
+    },
+};
+// ---------------------------------------------------------------------------
+// 默认配置（含预置厂商、模型、图片模型）
+// ---------------------------------------------------------------------------
+/** SDK 出厂默认 AppConfig。CLI/Desktop 首次初始化时使用。 */
+export const DEFAULT_APP_CONFIG = {
+    endpoints: [
+        {
+            id: "openai",
+            name: "OpenAI",
+            apiKey: "",
+            baseUrl: "https://api.openai.com/v1",
+            description: "OpenAI API 端点",
+        },
+        {
+            id: "bigmodelcn",
+            name: "BigModelCN (智谱AI)",
+            apiKey: "",
+            baseUrl: "https://open.bigmodel.cn/api/paas/v4",
+            description: "智谱AI大模型端点",
+        },
+        {
+            id: "deepseek",
+            name: "DeepSeek",
+            apiKey: "",
+            baseUrl: "https://api.deepseek.com/v1",
+            description: "DeepSeek API 端点",
+        },
+    ],
+    models: [
+        {
+            id: "gpt-5.5",
+            name: "GPT-5.5",
+            endpointId: "openai",
+            modelName: "gpt-5.5",
+            maxContextTokens: 250_000,
+            defaultParams: {},
+            description: "OpenAI 最新旗舰模型，擅长编程与代码调试、在线研究、数据分析",
+        },
+        {
+            id: "glm-5.1",
+            name: "GLM-5.1",
+            endpointId: "bigmodelcn",
+            modelName: "glm-5.1",
+            maxContextTokens: 250_000,
+            defaultParams: {},
+            description: "智谱AI 最新旗舰模型，支持8小时长程Agent任务",
+        },
+        {
+            id: "glm-5v-turbo",
+            name: "GLM-5V-Turbo",
+            endpointId: "bigmodelcn",
+            modelName: "glm-5v-turbo",
+            maxContextTokens: 250_000,
+            defaultParams: {},
+            description: "智谱AI 多模态Coding基座",
+        },
+        {
+            id: "glm-4.7-flash",
+            name: "GLM-4.7-Flash",
+            endpointId: "bigmodelcn",
+            modelName: "glm-4.7-flash",
+            maxContextTokens: 250_000,
+            defaultParams: {},
+            description: "智谱AI 免费轻量模型",
+        },
+        {
+            id: "deepseek-v4-pro",
+            name: "DeepSeek-V4-Pro",
+            endpointId: "deepseek",
+            modelName: "deepseek-v4-pro",
+            maxContextTokens: 250_000,
+            defaultParams: { thinking: { type: "disabled" } },
+            description: "DeepSeek 旗舰模型，Agentic Coding开源第一",
+        },
+        {
+            id: "deepseek-v4-flash",
+            name: "DeepSeek-V4-Flash",
+            endpointId: "deepseek",
+            modelName: "deepseek-v4-flash",
+            maxContextTokens: 250_000,
+            defaultParams: { thinking: { type: "disabled" } },
+            description: "DeepSeek 经济高效模型",
+        },
+    ],
+    imageModels: [
+        {
+            id: "cogview-4",
+            name: "CogView-4",
+            endpointId: "bigmodelcn",
+            modelName: "cogview-4",
+            defaultSize: "1024x1024",
+        },
+        {
+            id: "glm-image",
+            name: "GLM-Image",
+            endpointId: "bigmodelcn",
+            modelName: "glm-image",
+            defaultSize: "1280x1280",
+            defaultQuality: "hd",
+        },
+        {
+            id: "cogview-3-flash",
+            name: "CogView-3-Flash",
+            endpointId: "bigmodelcn",
+            modelName: "cogview-3-flash",
+            defaultSize: "1024x1024",
+        },
+    ],
+    defaultModel: "deepseek-v4-flash",
+    defaultImageModel: "cogview-4",
+    defaultAgent: "default",
+    defaultMigrationModel: "deepseek-v4-flash",
+};
+// ---------------------------------------------------------------------------
+// 目录
+// ---------------------------------------------------------------------------
+/**
+ * 标准共享子目录列表（不包含运行时目录）。
+ *
+ * 各客户端（CLI/Desktop）的运行时数据（config.json、conversations/、drafts/）
+ * 由客户端自行在各自目录下管理：
+ *   ~/.ai-zen/cli/          ← CLI 运行时
+ *   ~/.ai-zen/desktop/      ← Desktop 运行时（未来）
+ */
+export const CONFIG_SUB_DIRS = [
+    "agents",
+    "sub-agents",
+    "skills",
+    "tools",
+    "mcp-oauth",
+];

package/dist/crud/AgentRepository.d.ts

@@ -0,0 +1,9 @@
+import type { AgentDefinition } from "../types/index.js";
+import { EntityRepository } from "../shared/EntityRepository.js";
+/**
+ * Agent 仓储。
+ * 每个 Agent 一个 JSON 文件存储在 ${agentsDir}/${id}.json。
+ */
+export declare class AgentRepository extends EntityRepository<AgentDefinition> {
+    constructor(agentsDir: string);
+}

package/dist/crud/AgentRepository.js

@@ -0,0 +1,10 @@
+import { EntityRepository } from "../shared/EntityRepository.js";
+/**
+ * Agent 仓储。
+ * 每个 Agent 一个 JSON 文件存储在 ${agentsDir}/${id}.json。
+ */
+export class AgentRepository extends EntityRepository {
+    constructor(agentsDir) {
+        super(agentsDir);
+    }
+}

package/dist/crud/ConversationRepository.d.ts

@@ -0,0 +1,9 @@
+import type { Conversation } from "../types/index.js";
+import { EntityRepository } from "../shared/EntityRepository.js";
+/**
+ * Conversation 仓储。
+ * 每个 Conversation 一个 JSON 文件存储在 ${conversationsDir}/${id}.json。
+ */
+export declare class ConversationRepository extends EntityRepository<Conversation> {
+    constructor(conversationsDir: string);
+}

package/dist/crud/ConversationRepository.js

@@ -0,0 +1,10 @@
+import { EntityRepository } from "../shared/EntityRepository.js";
+/**
+ * Conversation 仓储。
+ * 每个 Conversation 一个 JSON 文件存储在 ${conversationsDir}/${id}.json。
+ */
+export class ConversationRepository extends EntityRepository {
+    constructor(conversationsDir) {
+        super(conversationsDir);
+    }
+}

package/dist/crud/DraftRepository.d.ts

@@ -0,0 +1,15 @@
+import type { Draft } from "../types/index.js";
+/**
+ * Draft 仓储。
+ * Draft 没有 id 字段，文件名基于 conversationId：
+ *   - 有 conversationId → ${conversationId}.json
+ *   - 无 conversationId → _current.json
+ */
+export declare class DraftRepository {
+    private dir;
+    constructor(dir: string);
+    private path;
+    read(conversationId?: string): Draft | null;
+    write(draft: Draft): void;
+    delete(conversationId?: string): void;
+}

package/dist/crud/DraftRepository.js

@@ -0,0 +1,41 @@
+import { readFileSync, writeFileSync, existsSync, unlinkSync, mkdirSync } from "node:fs";
+import { join } from "node:path";
+const CURRENT_DRAFT = "_current.json";
+/**
+ * Draft 仓储。
+ * Draft 没有 id 字段，文件名基于 conversationId：
+ *   - 有 conversationId → ${conversationId}.json
+ *   - 无 conversationId → _current.json
+ */
+export class DraftRepository {
+    dir;
+    constructor(dir) {
+        this.dir = dir;
+    }
+    path(conversationId) {
+        return join(this.dir, conversationId ? `${conversationId}.json` : CURRENT_DRAFT);
+    }
+    read(conversationId) {
+        const p = this.path(conversationId);
+        if (!existsSync(p))
+            return null;
+        try {
+            return JSON.parse(readFileSync(p, "utf-8"));
+        }
+        catch {
+            return null;
+        }
+    }
+    write(draft) {
+        if (!existsSync(this.dir)) {
+            mkdirSync(this.dir, { recursive: true });
+        }
+        writeFileSync(this.path(draft.conversationId), JSON.stringify(draft, null, 2), "utf-8");
+    }
+    delete(conversationId) {
+        const p = this.path(conversationId);
+        if (existsSync(p)) {
+            unlinkSync(p);
+        }
+    }
+}

package/dist/index.d.ts

@@ -0,0 +1,40 @@
+export type { PermissionPolicy, AgentPermissions, Endpoint, Model, ImageModel, AgentDefinition, Conversation, Draft, AppConfig, McpIcon, McpAnnotations, McpToolDef, McpResourceDef, McpPromptDef, McpServerManifest, McpServerConfig, McpConnectionState, } from "./types/index.js";
+export { Capabilities } from "./capabilities/Capabilities.js";
+export { PermissionEvaluator } from "./capabilities/PermissionEvaluator.js";
+export type { CandidateSets } from "./capabilities/PermissionEvaluator.js";
+export { createDisclosureParam } from "./capabilities/disclosure.js";
+export type { DisclosureParam } from "./capabilities/disclosure.js";
+export type { FilterOutput, ExcludeOptions } from "./capabilities/Capabilities.js";
+export { discoverBuiltinTools } from "./capabilities/discovery/builtin.js";
+export { discoverSubAgents } from "./capabilities/discovery/subagents.js";
+export { discoverSkills, readSkill } from "./capabilities/discovery/skills.js";
+export type { SkillInfo, Frontmatter } from "./capabilities/discovery/skills.js";
+export { discoverMcpServers } from "./capabilities/discovery/mcp.js";
+export { discoverUserTools } from "./capabilities/discovery/usertools.js";
+export { ConfigManager, DEFAULT_AGENT_ID, DEFAULT_AGENT_DEFINITION, DEFAULT_SUBAGENT_ID, DEFAULT_SUBAGENT_DEFINITION, DEFAULT_APP_CONFIG, CONFIG_SUB_DIRS, } from "./config/ConfigManager.js";
+export { EntityRepository } from "./shared/EntityRepository.js";
+export { AgentRepository } from "./crud/AgentRepository.js";
+export { ConversationRepository } from "./crud/ConversationRepository.js";
+export { DraftRepository } from "./crud/DraftRepository.js";
+export { Provider } from "./runtime/Provider.js";
+export { createModel } from "./runtime/createModel.js";
+export { SdkAgent } from "./runtime/SdkAgent.js";
+export type { AgentPlugin, SendContext } from "./runtime/SdkAgent.js";
+export { createAgent } from "./runtime/createAgent.js";
+export { McpConnectionManager } from "./runtime/McpConnectionManager.js";
+export type { McpConnectOptions } from "./runtime/McpConnectionManager.js";
+export { TaskMigrationService } from "./runtime/TaskMigrationService.js";
+export type { BuildMigrationAgentOptions } from "./runtime/TaskMigrationService.js";
+export { AutoMigratePlugin } from "./plugin/AutoMigratePlugin.js";
+export type { AutoMigrateOptions } from "./plugin/AutoMigratePlugin.js";
+export { AutoDraftPlugin } from "./plugin/AutoDraftPlugin.js";
+export type { AutoDraftOptions } from "./plugin/AutoDraftPlugin.js";
+export { AutoRefreshToolsPlugin } from "./plugin/AutoRefreshToolsPlugin.js";
+export { BUILTIN_TOOLS } from "./capabilities/implements/builtin/index.js";
+export { createGenerateImageTool } from "./capabilities/implements/builtin/generateImage.js";
+export { createLoadSkillTool, createCallSkillSubAgentTool } from "./capabilities/implements/skillTools.js";
+export { createLoadMcpTool, createCallMcpTool, createReadMcpResourceTool } from "./capabilities/implements/mcpTools.js";
+export { createSubAgentTool } from "./capabilities/implements/subAgentTools.js";
+export { createLogger } from "./shared/logger.js";
+export type { Logger, LogFunctions } from "./shared/logger.js";
+export { SdkError } from "./shared/errors.js";

package/dist/index.js

@@ -0,0 +1,37 @@
+// 能力管线
+export { Capabilities } from "./capabilities/Capabilities.js";
+export { PermissionEvaluator } from "./capabilities/PermissionEvaluator.js";
+export { createDisclosureParam } from "./capabilities/disclosure.js";
+// 发现
+export { discoverBuiltinTools } from "./capabilities/discovery/builtin.js";
+export { discoverSubAgents } from "./capabilities/discovery/subagents.js";
+export { discoverSkills, readSkill } from "./capabilities/discovery/skills.js";
+export { discoverMcpServers } from "./capabilities/discovery/mcp.js";
+export { discoverUserTools } from "./capabilities/discovery/usertools.js";
+// 配置 — ConfigManager
+export { ConfigManager, DEFAULT_AGENT_ID, DEFAULT_AGENT_DEFINITION, DEFAULT_SUBAGENT_ID, DEFAULT_SUBAGENT_DEFINITION, DEFAULT_APP_CONFIG, CONFIG_SUB_DIRS, } from "./config/ConfigManager.js";
+// CRUD — EntityRepository + 实体仓储
+export { EntityRepository } from "./shared/EntityRepository.js";
+export { AgentRepository } from "./crud/AgentRepository.js";
+export { ConversationRepository } from "./crud/ConversationRepository.js";
+export { DraftRepository } from "./crud/DraftRepository.js";
+// 运行时
+export { Provider } from "./runtime/Provider.js";
+export { createModel } from "./runtime/createModel.js";
+export { SdkAgent } from "./runtime/SdkAgent.js";
+export { createAgent } from "./runtime/createAgent.js";
+export { McpConnectionManager } from "./runtime/McpConnectionManager.js";
+export { TaskMigrationService } from "./runtime/TaskMigrationService.js";
+// 插件
+export { AutoMigratePlugin } from "./plugin/AutoMigratePlugin.js";
+export { AutoDraftPlugin } from "./plugin/AutoDraftPlugin.js";
+export { AutoRefreshToolsPlugin } from "./plugin/AutoRefreshToolsPlugin.js";
+// 工具
+export { BUILTIN_TOOLS } from "./capabilities/implements/builtin/index.js";
+export { createGenerateImageTool } from "./capabilities/implements/builtin/generateImage.js";
+export { createLoadSkillTool, createCallSkillSubAgentTool } from "./capabilities/implements/skillTools.js";
+export { createLoadMcpTool, createCallMcpTool, createReadMcpResourceTool } from "./capabilities/implements/mcpTools.js";
+export { createSubAgentTool } from "./capabilities/implements/subAgentTools.js";
+// 共享
+export { createLogger } from "./shared/logger.js";
+export { SdkError } from "./shared/errors.js";

package/dist/plugin/AutoDraftPlugin.d.ts

@@ -0,0 +1,26 @@
+import type { Draft } from "../types/index.js";
+import type { AgentPlugin, SendContext } from "../runtime/SdkAgent.js";
+export interface AutoDraftOptions {
+    draftsDir: string;
+    agentId: string;
+    modelId: string;
+    conversationId?: string;
+    cwd?: string;
+}
+/**
+ * 自动保存 Draft 插件。
+ *
+ * ```ts
+ * agent.use(new AutoDraftPlugin({
+ *   draftsDir: "/path/to/drafts",
+ *   agentId: "my-agent",
+ *   modelId: "gpt-4",
+ * }));
+ * ```
+ */
+export declare class AutoDraftPlugin implements AgentPlugin {
+    private options;
+    constructor(options: AutoDraftOptions);
+    onInnerLoopEnd(ctx: SendContext): Promise<void>;
+    static checkDraftForRestore(draftsDir: string): Draft | null;
+}

package/dist/plugin/AutoDraftPlugin.js

@@ -0,0 +1,58 @@
+import { DraftRepository } from "../crud/DraftRepository.js";
+import { createLogger } from "../shared/logger.js";
+import { existsSync } from "node:fs";
+import { join } from "node:path";
+import dayjs from "dayjs";
+const log = createLogger();
+const CURRENT_DRAFT = "_current.json";
+const EXPIRE_DAYS = 7;
+/**
+ * 自动保存 Draft 插件。
+ *
+ * ```ts
+ * agent.use(new AutoDraftPlugin({
+ *   draftsDir: "/path/to/drafts",
+ *   agentId: "my-agent",
+ *   modelId: "gpt-4",
+ * }));
+ * ```
+ */
+export class AutoDraftPlugin {
+    options;
+    constructor(options) {
+        this.options = options;
+    }
+    async onInnerLoopEnd(ctx) {
+        const { draftsDir, agentId, modelId, conversationId, cwd } = this.options;
+        try {
+            const draft = {
+                conversationId,
+                agentId,
+                modelId,
+                messages: ctx.agent.messages,
+                cwd,
+                updatedAt: new Date().toISOString(),
+            };
+            const repo = new DraftRepository(draftsDir);
+            repo.write(draft);
+        }
+        catch (err) {
+            log.error(`[autoDraft] 保存失败: ${err?.message ?? err}`);
+        }
+    }
+    static checkDraftForRestore(draftsDir) {
+        const path = join(draftsDir, CURRENT_DRAFT);
+        if (!existsSync(path))
+            return null;
+        const repo = new DraftRepository(draftsDir);
+        const draft = repo.read();
+        if (!draft)
+            return null;
+        const age = dayjs().diff(dayjs(draft.updatedAt), "day");
+        if (age > EXPIRE_DAYS) {
+            repo.delete();
+            return null;
+        }
+        return draft;
+    }
+}

package/dist/plugin/AutoMigratePlugin.d.ts

@@ -0,0 +1,25 @@
+import { SdkAgent } from "../runtime/SdkAgent.js";
+import type { AgentPlugin, SendContext } from "../runtime/SdkAgent.js";
+export interface AutoMigrateOptions {
+    maxTokens: number;
+    migrationAgent: SdkAgent;
+    onHandoff?: (handoffDoc: string, oldAgent: SdkAgent, newAgent: SdkAgent) => void;
+}
+/**
+ * 自动迁移插件。
+ *
+ * ```ts
+ * agent.use(new AutoMigratePlugin({
+ *   maxTokens: 250_000,
+ *   migrationAgent,
+ *   onHandoff: (doc, old, next) => { ... },
+ * }));
+ * ```
+ */
+export declare class AutoMigratePlugin implements AgentPlugin {
+    private options;
+    constructor(options: AutoMigrateOptions);
+    onAfterSend(ctx: SendContext): Promise<void>;
+    private serializeMessages;
+    private getLastAssistantContent;
+}

package/dist/plugin/AutoMigratePlugin.js

@@ -0,0 +1,74 @@
+import { AgentNS } from "@ai-zen/agents-core";
+import { SdkAgent } from "../runtime/SdkAgent.js";
+import { TaskMigrationService } from "../runtime/TaskMigrationService.js";
+import { createLogger } from "../shared/logger.js";
+const log = createLogger();
+/**
+ * 自动迁移插件。
+ *
+ * ```ts
+ * agent.use(new AutoMigratePlugin({
+ *   maxTokens: 250_000,
+ *   migrationAgent,
+ *   onHandoff: (doc, old, next) => { ... },
+ * }));
+ * ```
+ */
+export class AutoMigratePlugin {
+    options;
+    constructor(options) {
+        this.options = options;
+    }
+    async onAfterSend(ctx) {
+        const { agent } = ctx;
+        const { maxTokens, migrationAgent, onHandoff } = this.options;
+        const promptTokens = agent.lastUsage?.prompt_tokens;
+        if (promptTokens == null)
+            return;
+        if (!TaskMigrationService.shouldMigrate(promptTokens, maxTokens))
+            return;
+        try {
+            const historyText = this.serializeMessages(agent.messages);
+            const migrationResult = await migrationAgent.send(historyText);
+            const handoffDoc = this.getLastAssistantContent(migrationResult);
+            if (!handoffDoc)
+                return;
+            const newMessages = [
+                ...agent.definition.messages,
+                ...TaskMigrationService.createPostMessages(handoffDoc),
+            ];
+            const newAgent = new SdkAgent({ ...agent, messages: newMessages });
+            ctx.agent = newAgent;
+            if (onHandoff) {
+                try {
+                    await onHandoff(handoffDoc, agent, newAgent);
+                }
+                catch (err) {
+                    log.error(`[autoMigrate] onHandoff 回调失败: ${err?.message ?? err}`);
+                }
+            }
+        }
+        catch (err) {
+            log.error(`[autoMigrate] 迁移失败: ${err?.message ?? err}`);
+        }
+    }
+    serializeMessages(messages) {
+        return messages
+            .map((m) => {
+            const role = m.role ?? "unknown";
+            const content = typeof m.content === "string" ? m.content : JSON.stringify(m.content);
+            return `[${role}]: ${content}`;
+        })
+            .join("\n\n");
+    }
+    getLastAssistantContent(messages) {
+        for (let i = messages.length - 1; i >= 0; i--) {
+            if (messages[i].role === AgentNS.Role.Assistant && messages[i].content) {
+                return typeof messages[i].content === "string"
+                    ? messages[i].content
+                    : null;
+            }
+        }
+        return null;
+    }
+}

package/dist/plugin/AutoRefreshToolsPlugin.d.ts

@@ -0,0 +1,12 @@
+import type { AgentPlugin, SendContext } from "../runtime/SdkAgent.js";
+/**
+ * 自动刷新能力插件。
+ *
+ * ```ts
+ * agent.use(new AutoRefreshToolsPlugin());
+ * await agent.init();
+ * ```
+ */
+export declare class AutoRefreshToolsPlugin implements AgentPlugin {
+    onBeforeSend(ctx: SendContext): Promise<void>;
+}

package/dist/plugin/AutoRefreshToolsPlugin.js

@@ -0,0 +1,23 @@
+/**
+ * 自动刷新能力插件。
+ *
+ * ```ts
+ * agent.use(new AutoRefreshToolsPlugin());
+ * await agent.init();
+ * ```
+ */
+export class AutoRefreshToolsPlugin {
+    async onBeforeSend(ctx) {
+        const { agent } = ctx;
+        if (!agent.caps)
+            return;
+        agent.caps.refresh();
+        agent.tools = agent.caps.buildTools(agent.permissions ?? {}, {
+            exclude: {
+                subagents: agent.definition.function?.name
+                    ? [agent.definition.function.name]
+                    : undefined,
+            },
+        });
+    }
+}

package/dist/runtime/McpConnectionManager.d.ts

@@ -0,0 +1,42 @@
+import { Client } from "@modelcontextprotocol/sdk/client/index.js";
+import type { Transport } from "@modelcontextprotocol/sdk/shared/transport.js";
+import type { McpServerConfig, McpServerManifest, McpConnectionState } from "../types/index.js";
+export interface McpConnectOptions {
+    /** 空闲超时（毫秒），默认 stdio: 30min, http: 5min */
+    idleTimeoutMs?: number;
+    /** 失败时自动重连 */
+    autoReconnect?: boolean;
+    /** 最大重试次数，默认 3 */
+    maxRetries?: number;
+    /** 判断是否为配置错误（不重试），默认全部重试 */
+    isConfigError?: (err: unknown) => boolean;
+}
+export declare class McpConnectionManager {
+    private servers;
+    /** 可替换的 transport 工厂，用于测试注入 */
+    private _transportFactory?;
+    /** 可替换的 Client 工厂，用于测试注入 */
+    private _clientFactory?;
+    /**
+     * @param transportFactory 可选的自定义 transport 工厂（用于测试注入）
+     * @param clientFactory 可选的自定义 Client 工厂（用于测试注入）
+     */
+    constructor(transportFactory?: (config: McpServerConfig) => Transport, clientFactory?: () => Client);
+    getState(name: string): McpConnectionState;
+    getManifest(name: string): McpServerManifest | undefined;
+    getClient(name: string): Client | undefined;
+    connect(name: string, config: McpServerConfig, options?: McpConnectOptions): Promise<McpServerManifest>;
+    private connectWithRetry;
+    private doConnect;
+    /**
+     * 根据配置创建对应的 Transport 实例。
+     * 如果设置了自定义工厂（测试用），则使用自定义工厂。
+     */
+    private createTransport;
+    disconnect(name: string): Promise<void>;
+    disconnectAll(): Promise<void>;
+    touch(name: string): void;
+    private scheduleTimeout;
+    private clearTimeout;
+    private throwNotConnected;
+}