@amodalai/core 0.1.0

package/dist/src/knowledge/propose-kb-update.js

@@ -0,0 +1,148 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import { BaseDeclarativeTool, BaseToolInvocation, Kind } from '@google/gemini-cli-core';
+import { PROPOSE_KNOWLEDGE_TOOL_NAME } from '../tools/amodal-tool-names.js';
+import { ToolErrorType } from '@google/gemini-cli-core';
+import { getProposeKnowledgeDefinition } from '../tools/definitions/amodal-tools.js';
+class ProposeKBUpdateInvocation extends BaseToolInvocation {
+    config;
+    constructor(config, params, messageBus, _toolName, _toolDisplayName) {
+        super(params, messageBus, _toolName, _toolDisplayName);
+        this.config = config;
+    }
+    getDescription() {
+        return `propose_kb_update [${this.params.scope}]: ${this.params.title}`;
+    }
+    async getConfirmationDetails(_abortSignal) {
+        // Proposals are reviewed by admins, not user-confirmed
+        return false;
+    }
+    async execute(_signal) {
+        const platformApiUrl = this.config.getPlatformApiUrl();
+        const platformApiKey = this.config.getPlatformApiKey();
+        if (!platformApiUrl || !platformApiKey) {
+            const errorMessage = 'Platform API credentials not configured. Cannot propose knowledge base updates.';
+            return {
+                llmContent: `Error: ${errorMessage}`,
+                returnDisplay: `Error: ${errorMessage}`,
+                error: {
+                    message: errorMessage,
+                    type: ToolErrorType.INVALID_TOOL_PARAMS,
+                },
+            };
+        }
+        // Resolve scope_id from applicationId/tenantId
+        const scopeId = this.params.scope === 'application'
+            ? this.config.getApplicationId()
+            : this.config.getTenantId();
+        if (!scopeId) {
+            const errorMessage = this.params.scope === 'application'
+                ? 'Application ID not configured. Cannot propose application-level updates.'
+                : 'Tenant ID not configured. Cannot propose tenant-level updates.';
+            return {
+                llmContent: `Error: ${errorMessage}`,
+                returnDisplay: `Error: ${errorMessage}`,
+                error: {
+                    message: errorMessage,
+                    type: ToolErrorType.INVALID_TOOL_PARAMS,
+                },
+            };
+        }
+        // Validate update action requires document_id
+        if (this.params.action === 'update' && !this.params.document_id) {
+            const errorMessage = 'document_id is required for update actions.';
+            return {
+                llmContent: `Error: ${errorMessage}`,
+                returnDisplay: `Error: ${errorMessage}`,
+                error: {
+                    message: errorMessage,
+                    type: ToolErrorType.INVALID_TOOL_PARAMS,
+                },
+            };
+        }
+        // Build request body
+        const requestBody = {
+            scope_type: this.params.scope,
+            scope_id: scopeId,
+            session_id: this.config.getSessionId(),
+            proposed_title: this.params.title,
+            proposed_category: this.params.category,
+            proposed_body: this.params.body,
+            reasoning: this.params.reasoning,
+        };
+        if (this.params.document_id) {
+            requestBody['document_id'] = this.params.document_id;
+        }
+        try {
+            const response = await fetch(`${platformApiUrl}/api/proposed-updates`, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    Authorization: `Bearer ${platformApiKey}`,
+                },
+                body: JSON.stringify(requestBody),
+                signal: _signal,
+            });
+            if (!response.ok) {
+                const errorMessage = `Platform API returned ${String(response.status)}: ${response.statusText}`;
+                return {
+                    llmContent: `Error: ${errorMessage}`,
+                    returnDisplay: `Error: ${errorMessage}`,
+                    error: {
+                        message: errorMessage,
+                        type: ToolErrorType.EXECUTION_FAILED,
+                    },
+                };
+            }
+            // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion -- platform API response shape is trusted
+            const result = (await response.json());
+            // Log audit event
+            const auditLogger = this.config.getAuditLogger();
+            if (auditLogger) {
+                auditLogger.logKbProposal(this.params.scope, this.params.title, result.id);
+            }
+            const successMessage = `Knowledge base update proposed successfully.\n` +
+                `Proposal ID: ${result.id}\n` +
+                `Scope: ${this.params.scope}\n` +
+                `Title: ${this.params.title}\n` +
+                `Status: pending admin review`;
+            return {
+                llmContent: successMessage,
+                returnDisplay: successMessage,
+            };
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            const errorMessage = `Failed to submit proposal: ${message}`;
+            return {
+                llmContent: `Error: ${errorMessage}`,
+                returnDisplay: `Error: ${errorMessage}`,
+                error: {
+                    message: errorMessage,
+                    type: ToolErrorType.EXECUTION_FAILED,
+                },
+            };
+        }
+    }
+}
+/**
+ * Built-in tool for proposing knowledge base updates during conversations.
+ * Always available when platform API credentials are configured.
+ * Not subject to role filtering.
+ */
+export class ProposeKBUpdateTool extends BaseDeclarativeTool {
+    config;
+    static Name = PROPOSE_KNOWLEDGE_TOOL_NAME;
+    constructor(config, messageBus) {
+        const definition = getProposeKnowledgeDefinition();
+        super(ProposeKBUpdateTool.Name, 'Propose KB Update', definition.base.description, Kind.Other, definition.base.parametersJsonSchema, messageBus, true, false);
+        this.config = config;
+    }
+    createInvocation(params, messageBus, _toolName, _toolDisplayName) {
+        return new ProposeKBUpdateInvocation(this.config, params, messageBus, _toolName, _toolDisplayName ?? 'Propose KB Update');
+    }
+}
+//# sourceMappingURL=propose-kb-update.js.map

package/dist/src/knowledge/propose-kb-update.js.map

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

package/dist/src/knowledge/propose-knowledge.d.ts

@@ -0,0 +1,34 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import type { MessageBus } from '@google/gemini-cli-core';
+import type { ToolResult, ToolInvocation } from '@google/gemini-cli-core';
+import { BaseDeclarativeTool } from '@google/gemini-cli-core';
+import type { ToolContext } from '../tool-context.js';
+/**
+ * Parameters for the propose_knowledge tool.
+ */
+export interface ProposeKnowledgeParams {
+    action: 'create' | 'update';
+    scope: 'application' | 'tenant';
+    document_id?: string;
+    title: string;
+    category: 'system_docs' | 'methodology' | 'patterns' | 'false_positives' | 'response_procedures' | 'environment' | 'baselines' | 'team' | 'incident_history' | 'working_memory';
+    body: string;
+    reasoning: string;
+}
+/**
+ * Built-in tool for proposing knowledge base updates during conversations.
+ * Always available when platform API credentials are configured.
+ * Not subject to role filtering.
+ */
+export declare class ProposeKnowledgeTool extends BaseDeclarativeTool<ProposeKnowledgeParams, ToolResult> {
+    private config;
+    static readonly Name = "propose_knowledge";
+    constructor(config: ToolContext, messageBus: MessageBus);
+    protected createInvocation(params: ProposeKnowledgeParams, messageBus: MessageBus, _toolName?: string, _toolDisplayName?: string): ToolInvocation<ProposeKnowledgeParams, ToolResult>;
+}
+export { ProposeKnowledgeTool as ProposeKBUpdateTool };
+export type { ProposeKnowledgeParams as ProposeKBUpdateParams };

package/dist/src/knowledge/propose-knowledge.js

@@ -0,0 +1,163 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import { BaseDeclarativeTool, BaseToolInvocation, Kind } from '@google/gemini-cli-core';
+import { PROPOSE_KNOWLEDGE_TOOL_NAME } from '../tools/amodal-tool-names.js';
+import { ToolErrorType } from '@google/gemini-cli-core';
+import { getProposeKnowledgeDefinition } from '../tools/definitions/amodal-tools.js';
+class ProposeKnowledgeInvocation extends BaseToolInvocation {
+    config;
+    constructor(config, params, messageBus, _toolName, _toolDisplayName) {
+        super(params, messageBus, _toolName, _toolDisplayName);
+        this.config = config;
+    }
+    getDescription() {
+        return `propose_knowledge [${this.params.scope}]: ${this.params.title}`;
+    }
+    async getConfirmationDetails(_abortSignal) {
+        // Proposals are reviewed by admins, not user-confirmed
+        return false;
+    }
+    async execute(_signal) {
+        const platformApiUrl = this.config.getPlatformApiUrl();
+        const platformApiKey = this.config.getPlatformApiKey();
+        if (!platformApiUrl || !platformApiKey) {
+            const errorMessage = 'Platform API credentials not configured. Cannot propose knowledge base updates.';
+            return {
+                llmContent: `Error: ${errorMessage}`,
+                returnDisplay: `Error: ${errorMessage}`,
+                error: {
+                    message: errorMessage,
+                    type: ToolErrorType.INVALID_TOOL_PARAMS,
+                },
+            };
+        }
+        // Resolve scope_id from applicationId/tenantId
+        const scopeId = this.params.scope === 'application'
+            ? this.config.getApplicationId()
+            : this.config.getTenantId();
+        if (!scopeId) {
+            const errorMessage = this.params.scope === 'application'
+                ? 'Application ID not configured. Cannot propose application-level updates.'
+                : 'Tenant ID not configured. Cannot propose tenant-level updates.';
+            return {
+                llmContent: `Error: ${errorMessage}`,
+                returnDisplay: `Error: ${errorMessage}`,
+                error: {
+                    message: errorMessage,
+                    type: ToolErrorType.INVALID_TOOL_PARAMS,
+                },
+            };
+        }
+        // Validate update action requires document_id
+        if (this.params.action === 'update' && !this.params.document_id) {
+            const errorMessage = 'document_id is required for update actions.';
+            return {
+                llmContent: `Error: ${errorMessage}`,
+                returnDisplay: `Error: ${errorMessage}`,
+                error: {
+                    message: errorMessage,
+                    type: ToolErrorType.INVALID_TOOL_PARAMS,
+                },
+            };
+        }
+        // Build request body
+        const requestBody = {
+            scope_type: this.params.scope,
+            scope_id: scopeId,
+            session_id: this.config.getSessionId(),
+            proposed_title: this.params.title,
+            proposed_category: this.params.category,
+            proposed_body: this.params.body,
+            reasoning: this.params.reasoning,
+            source: 'agent:chat',
+        };
+        if (this.params.document_id) {
+            requestBody['document_id'] = this.params.document_id;
+        }
+        try {
+            const response = await fetch(`${platformApiUrl}/api/proposed-updates`, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    Authorization: `Bearer ${platformApiKey}`,
+                },
+                body: JSON.stringify(requestBody),
+                signal: _signal,
+            });
+            if (!response.ok) {
+                const errorMessage = `Platform API returned ${String(response.status)}: ${response.statusText}`;
+                return {
+                    llmContent: `Error: ${errorMessage}`,
+                    returnDisplay: `Error: ${errorMessage}`,
+                    error: {
+                        message: errorMessage,
+                        type: ToolErrorType.EXECUTION_FAILED,
+                    },
+                };
+            }
+            // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion -- platform API response shape is trusted
+            const result = (await response.json());
+            // Log audit event
+            const auditLogger = this.config.getAuditLogger();
+            if (auditLogger) {
+                auditLogger.logKbProposal(this.params.scope, this.params.title, result.id);
+            }
+            // Return different messages based on auto-approve status
+            if (result.status === 'auto_approved') {
+                const successMessage = `Knowledge update applied immediately.\n` +
+                    `Proposal ID: ${result.id}\n` +
+                    `Scope: ${this.params.scope}\n` +
+                    `Title: ${this.params.title}\n` +
+                    `Status: auto-approved and applied`;
+                return {
+                    llmContent: successMessage,
+                    returnDisplay: successMessage,
+                };
+            }
+            const successMessage = `Knowledge base update proposed successfully.\n` +
+                `Proposal ID: ${result.id}\n` +
+                `Scope: ${this.params.scope}\n` +
+                `Title: ${this.params.title}\n` +
+                `Status: pending admin review`;
+            return {
+                llmContent: successMessage,
+                returnDisplay: successMessage,
+            };
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            const errorMessage = `Failed to submit proposal: ${message}`;
+            return {
+                llmContent: `Error: ${errorMessage}`,
+                returnDisplay: `Error: ${errorMessage}`,
+                error: {
+                    message: errorMessage,
+                    type: ToolErrorType.EXECUTION_FAILED,
+                },
+            };
+        }
+    }
+}
+/**
+ * Built-in tool for proposing knowledge base updates during conversations.
+ * Always available when platform API credentials are configured.
+ * Not subject to role filtering.
+ */
+export class ProposeKnowledgeTool extends BaseDeclarativeTool {
+    config;
+    static Name = PROPOSE_KNOWLEDGE_TOOL_NAME;
+    constructor(config, messageBus) {
+        const definition = getProposeKnowledgeDefinition();
+        super(ProposeKnowledgeTool.Name, 'Propose Knowledge', definition.base.description, Kind.Other, definition.base.parametersJsonSchema, messageBus, true, false);
+        this.config = config;
+    }
+    createInvocation(params, messageBus, _toolName, _toolDisplayName) {
+        return new ProposeKnowledgeInvocation(this.config, params, messageBus, _toolName, _toolDisplayName ?? 'Propose Knowledge');
+    }
+}
+// Backward compatibility aliases
+export { ProposeKnowledgeTool as ProposeKBUpdateTool };
+//# sourceMappingURL=propose-knowledge.js.map

package/dist/src/knowledge/propose-knowledge.js.map

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

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

@@ -0,0 +1,7 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+export { McpManager } from './mcp-manager.js';
+export type { McpDiscoveredTool, McpToolResult, McpServerStatus, McpServerInfo } from './mcp-manager.js';

package/dist/src/mcp/index.js

@@ -0,0 +1,7 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+export { McpManager } from './mcp-manager.js';
+//# sourceMappingURL=index.js.map

package/dist/src/mcp/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/mcp/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAC,UAAU,EAAC,MAAM,kBAAkB,CAAC"}

package/dist/src/mcp/mcp-manager.d.ts

@@ -0,0 +1,96 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import type { RepoMcpServerConfig } from '../repo/repo-types.js';
+/**
+ * A discovered tool from an MCP server.
+ */
+export interface McpDiscoveredTool {
+    /** Namespaced tool name: serverName__toolName */
+    name: string;
+    /** Original tool name on the server */
+    originalName: string;
+    /** Server this tool belongs to */
+    serverName: string;
+    /** Tool description */
+    description: string;
+    /** JSON Schema for parameters */
+    parameters: Record<string, unknown>;
+}
+/**
+ * Result of calling an MCP tool.
+ */
+export interface McpToolResult {
+    content: Array<{
+        type: string;
+        text?: string;
+        data?: string;
+        mimeType?: string;
+    }>;
+    isError?: boolean;
+}
+/**
+ * Status of an MCP server connection.
+ */
+export type McpServerStatus = 'disconnected' | 'connecting' | 'connected' | 'error';
+/**
+ * Info about a connected MCP server.
+ */
+export interface McpServerInfo {
+    name: string;
+    status: McpServerStatus;
+    tools: string[];
+    error?: string;
+}
+/**
+ * Manages connections to multiple MCP servers.
+ * Handles lifecycle (connect/disconnect), tool discovery, and tool execution.
+ */
+export declare class McpManager {
+    private readonly clients;
+    private readonly transports;
+    private readonly serverTools;
+    private readonly serverStatuses;
+    private readonly serverErrors;
+    /**
+     * Connect to all configured MCP servers and discover their tools.
+     * Non-fatal: individual server failures don't block other servers.
+     */
+    startServers(configs: Record<string, RepoMcpServerConfig>): Promise<void>;
+    /**
+     * Connect to a single MCP server.
+     */
+    private connectServer;
+    /**
+     * Create the appropriate transport for a server config.
+     */
+    private createTransport;
+    /**
+     * Get all discovered tools across all connected servers.
+     */
+    getDiscoveredTools(): McpDiscoveredTool[];
+    /**
+     * Call a tool on an MCP server.
+     * @param qualifiedName — The namespaced tool name (serverName__toolName)
+     * @param args — Tool arguments
+     */
+    callTool(qualifiedName: string, args: Record<string, unknown>): Promise<McpToolResult>;
+    /**
+     * Check if a tool name is an MCP tool.
+     */
+    isMcpTool(name: string): boolean;
+    /**
+     * Get status info for all servers.
+     */
+    getServerInfo(): McpServerInfo[];
+    /**
+     * Disconnect from all MCP servers.
+     */
+    shutdown(): Promise<void>;
+    /**
+     * Number of connected servers.
+     */
+    get connectedCount(): number;
+}

package/dist/src/mcp/mcp-manager.js

@@ -0,0 +1,192 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import { Client } from '@modelcontextprotocol/sdk/client/index.js';
+import { StdioClientTransport } from '@modelcontextprotocol/sdk/client/stdio.js';
+import { SSEClientTransport } from '@modelcontextprotocol/sdk/client/sse.js';
+import { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js';
+// Separator for namespaced tool names
+const MCP_NAME_SEPARATOR = '__';
+/**
+ * Manages connections to multiple MCP servers.
+ * Handles lifecycle (connect/disconnect), tool discovery, and tool execution.
+ */
+export class McpManager {
+    clients = new Map();
+    transports = new Map();
+    serverTools = new Map();
+    serverStatuses = new Map();
+    serverErrors = new Map();
+    /**
+     * Connect to all configured MCP servers and discover their tools.
+     * Non-fatal: individual server failures don't block other servers.
+     */
+    async startServers(configs) {
+        const startPromises = Object.entries(configs).map(async ([name, config]) => {
+            try {
+                await this.connectServer(name, config);
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                this.serverStatuses.set(name, 'error');
+                this.serverErrors.set(name, msg);
+                process.stderr.write(`[MCP] Failed to connect to ${name}: ${msg}\n`);
+            }
+        });
+        await Promise.allSettled(startPromises);
+    }
+    /**
+     * Connect to a single MCP server.
+     */
+    async connectServer(name, config) {
+        this.serverStatuses.set(name, 'connecting');
+        const transport = this.createTransport(name, config);
+        const client = new Client({ name: `amodal-${name}`, version: '1.0.0' });
+        await client.connect(transport);
+        this.clients.set(name, client);
+        this.transports.set(name, transport);
+        this.serverStatuses.set(name, 'connected');
+        // Discover tools
+        try {
+            const toolsResult = await client.listTools();
+            this.serverTools.set(name, toolsResult.tools);
+            process.stderr.write(`[MCP] Connected to ${name}: ${toolsResult.tools.length} tools discovered\n`);
+        }
+        catch {
+            this.serverTools.set(name, []);
+            process.stderr.write(`[MCP] Connected to ${name} but tool discovery failed\n`);
+        }
+    }
+    /**
+     * Create the appropriate transport for a server config.
+     */
+    createTransport(name, config) {
+        if (config.transport === 'stdio') {
+            if (!config.command) {
+                throw new Error(`MCP server "${name}" has stdio transport but no command`);
+            }
+            // Merge config env vars with process.env, filtering out undefined values
+            let mergedEnv;
+            if (config.env) {
+                mergedEnv = {};
+                for (const [k, v] of Object.entries(process.env)) {
+                    if (v !== undefined)
+                        mergedEnv[k] = v;
+                }
+                Object.assign(mergedEnv, config.env);
+            }
+            return new StdioClientTransport({
+                command: config.command,
+                args: config.args,
+                env: mergedEnv,
+            });
+        }
+        if (config.transport === 'sse') {
+            if (!config.url) {
+                throw new Error(`MCP server "${name}" has sse transport but no url`);
+            }
+            return new SSEClientTransport(new URL(config.url));
+        }
+        if (config.transport === 'http') {
+            if (!config.url) {
+                throw new Error(`MCP server "${name}" has http transport but no url`);
+            }
+            return new StreamableHTTPClientTransport(new URL(config.url));
+        }
+        throw new Error(`Unknown MCP transport "${config.transport}" for server "${name}"`);
+    }
+    /**
+     * Get all discovered tools across all connected servers.
+     */
+    getDiscoveredTools() {
+        const tools = [];
+        for (const [serverName, serverTools] of this.serverTools) {
+            for (const tool of serverTools) {
+                tools.push({
+                    name: `${serverName}${MCP_NAME_SEPARATOR}${tool.name}`,
+                    originalName: tool.name,
+                    serverName,
+                    description: tool.description ?? `Tool from ${serverName}`,
+                    parameters: (tool.inputSchema ?? { type: 'object', properties: {} }),
+                });
+            }
+        }
+        return tools;
+    }
+    /**
+     * Call a tool on an MCP server.
+     * @param qualifiedName — The namespaced tool name (serverName__toolName)
+     * @param args — Tool arguments
+     */
+    async callTool(qualifiedName, args) {
+        const sepIdx = qualifiedName.indexOf(MCP_NAME_SEPARATOR);
+        if (sepIdx < 0) {
+            throw new Error(`Invalid MCP tool name "${qualifiedName}" — expected serverName${MCP_NAME_SEPARATOR}toolName`);
+        }
+        const serverName = qualifiedName.slice(0, sepIdx);
+        const toolName = qualifiedName.slice(sepIdx + MCP_NAME_SEPARATOR.length);
+        const client = this.clients.get(serverName);
+        if (!client) {
+            throw new Error(`MCP server "${serverName}" is not connected`);
+        }
+        const result = await client.callTool({ name: toolName, arguments: args });
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion -- MCP result shape
+        return result;
+    }
+    /**
+     * Check if a tool name is an MCP tool.
+     */
+    isMcpTool(name) {
+        return name.includes(MCP_NAME_SEPARATOR);
+    }
+    /**
+     * Get status info for all servers.
+     */
+    getServerInfo() {
+        const info = [];
+        for (const [name, status] of this.serverStatuses) {
+            const tools = this.serverTools.get(name) ?? [];
+            info.push({
+                name,
+                status,
+                tools: tools.map((t) => t.name),
+                error: this.serverErrors.get(name),
+            });
+        }
+        return info;
+    }
+    /**
+     * Disconnect from all MCP servers.
+     */
+    async shutdown() {
+        const closePromises = [...this.clients.entries()].map(async ([name, client]) => {
+            try {
+                await client.close();
+                process.stderr.write(`[MCP] Disconnected from ${name}\n`);
+            }
+            catch {
+                // Best effort
+            }
+        });
+        await Promise.allSettled(closePromises);
+        this.clients.clear();
+        this.transports.clear();
+        this.serverTools.clear();
+        this.serverStatuses.clear();
+        this.serverErrors.clear();
+    }
+    /**
+     * Number of connected servers.
+     */
+    get connectedCount() {
+        let count = 0;
+        for (const status of this.serverStatuses.values()) {
+            if (status === 'connected')
+                count++;
+        }
+        return count;
+    }
+}
+//# sourceMappingURL=mcp-manager.js.map