@1mcp/agent 0.16.0 → 0.18.0

package/build/core/capabilities/asyncLoadingOrchestrator.js

@@ -0,0 +1,256 @@
+import { EventEmitter } from 'events';
+import { CapabilityAggregator } from './capabilityAggregator.js';
+import { NotificationManager } from '../notifications/notificationManager.js';
+import { AgentConfigManager } from '../server/agentConfig.js';
+import logger from '../../logger/logger.js';
+/**
+ * Orchestrates the async loading system by coordinating CapabilityAggregator,
+ * NotificationManager, and LoadingStateTracker events.
+ *
+ * This class handles the complete flow:
+ * 1. MCP server becomes ready
+ * 2. Capability aggregation detects changes
+ * 3. Notifications are sent to clients about new capabilities
+ *
+ * @example
+ * ```typescript
+ * const orchestrator = new AsyncLoadingOrchestrator(
+ *   outboundConnections,
+ *   inboundConnection,
+ *   loadingManager
+ * );
+ * orchestrator.initialize();
+ * ```
+ */
+export class AsyncLoadingOrchestrator extends EventEmitter {
+    capabilityAggregator;
+    notificationManager = null;
+    loadingManager;
+    serverManager;
+    agentConfig;
+    isInitialized = false;
+    isShuttingDown = false;
+    constructor(outboundConnections, serverManager, loadingManager) {
+        super();
+        this.loadingManager = loadingManager;
+        this.serverManager = serverManager;
+        this.agentConfig = AgentConfigManager.getInstance();
+        // Create capability aggregator
+        this.capabilityAggregator = new CapabilityAggregator(outboundConnections);
+        this.setMaxListeners(20);
+    }
+    /**
+     * Initialize the orchestrator and wire up event handlers
+     */
+    initialize() {
+        if (this.isInitialized) {
+            logger.warn('AsyncLoadingOrchestrator already initialized');
+            return;
+        }
+        if (!this.agentConfig.isAsyncLoadingEnabled()) {
+            logger.info('Async loading disabled - AsyncLoadingOrchestrator skipping initialization');
+            return;
+        }
+        logger.info('Initializing AsyncLoadingOrchestrator...');
+        // Wire up the event chain: LoadingManager -> CapabilityAggregator
+        this.setupEventChain();
+        this.isInitialized = true;
+        logger.info('AsyncLoadingOrchestrator initialized successfully');
+        this.emit('orchestrator-ready');
+    }
+    /**
+     * Initialize notification manager when inbound connection is available
+     */
+    initializeNotifications(inboundConnection) {
+        if (this.notificationManager) {
+            logger.warn('NotificationManager already initialized');
+            return;
+        }
+        if (!this.agentConfig.isAsyncLoadingEnabled()) {
+            return;
+        }
+        // Create notification manager with config from agent settings
+        const notificationConfig = {
+            batchNotifications: this.agentConfig.isBatchNotificationsEnabled(),
+            batchDelayMs: this.agentConfig.getBatchDelayMs(),
+            notifyOnServerReady: this.agentConfig.isNotifyOnServerReadyEnabled(),
+        };
+        this.notificationManager = new NotificationManager(inboundConnection, notificationConfig);
+        // Wire up notification events
+        this.setupNotificationEvents();
+        logger.info('AsyncLoadingOrchestrator notification manager initialized');
+    }
+    /**
+     * Set up the event handling chain for capability tracking
+     */
+    setupEventChain() {
+        // 1. Listen for server readiness from LoadingManager
+        this.loadingManager.on('server-loaded', (serverName, _result) => {
+            if (this.isShuttingDown)
+                return;
+            logger.debug(`Server ${serverName} became ready, updating capabilities`);
+            this.handleServerReady(serverName);
+        });
+        // 2. Listen for capability changes from CapabilityAggregator
+        this.capabilityAggregator.on('capabilities-changed', (changes) => {
+            if (this.isShuttingDown)
+                return;
+            logger.debug('Capabilities changed, processing notifications');
+            this.handleCapabilityChanges(changes);
+        });
+        logger.debug('Event chain setup completed');
+    }
+    /**
+     * Set up notification event handlers
+     */
+    setupNotificationEvents() {
+        if (!this.notificationManager) {
+            return;
+        }
+        // 3. Listen for notification events from NotificationManager
+        this.notificationManager.on('batch-sent', (notifications, clientCount) => {
+            if (this.isShuttingDown)
+                return;
+            logger.info(`Sent listChanged notifications to ${clientCount} clients: [${notifications.join(', ')}]`);
+            this.emit('notifications-sent', notifications);
+        });
+        this.notificationManager.on('notification-failed', (type, error) => {
+            logger.error(`Failed to send ${type} listChanged notification: ${error.message}`);
+        });
+        logger.debug('Notification event handlers setup completed');
+    }
+    /**
+     * Handle a server becoming ready by updating capabilities
+     */
+    async handleServerReady(serverName) {
+        try {
+            // Update capability aggregation
+            const changes = await this.capabilityAggregator.updateCapabilities();
+            if (changes.hasChanges) {
+                logger.info(`Server ${serverName} ready: ${changes.current.tools.length} tools, ${changes.current.resources.length} resources, ${changes.current.prompts.length} prompts now available`);
+                this.emit('server-capabilities-updated', serverName, changes);
+            }
+            else {
+                logger.debug(`Server ${serverName} ready but no capability changes detected`);
+            }
+        }
+        catch (error) {
+            logger.error(`Failed to update capabilities after ${serverName} became ready: ${error}`);
+        }
+    }
+    /**
+     * Handle capability changes by sending notifications
+     */
+    handleCapabilityChanges(changes) {
+        if (!changes.hasChanges) {
+            return;
+        }
+        // Send notifications to clients if notification manager is available
+        if (this.notificationManager) {
+            this.notificationManager.handleCapabilityChanges(changes);
+        }
+        else {
+            logger.debug('Capability changes detected but no notification manager available yet');
+        }
+        // Log the changes for visibility
+        const summary = this.capabilityAggregator.getCapabilitiesSummary();
+        logger.info(`Capability update complete: ${summary}`);
+    }
+    /**
+     * Get the capability aggregator instance
+     */
+    getCapabilityAggregator() {
+        return this.capabilityAggregator;
+    }
+    /**
+     * Get the notification manager instance
+     */
+    getNotificationManager() {
+        return this.notificationManager;
+    }
+    /**
+     * Check if the orchestrator is initialized
+     */
+    isReady() {
+        return this.isInitialized;
+    }
+    /**
+     * Force refresh capabilities and send notifications if needed
+     */
+    async refreshCapabilities() {
+        if (!this.isInitialized || this.isShuttingDown) {
+            logger.warn('Cannot refresh capabilities - orchestrator not ready');
+            return;
+        }
+        try {
+            logger.info('Manually refreshing capabilities...');
+            const changes = await this.capabilityAggregator.updateCapabilities();
+            if (changes.hasChanges) {
+                this.handleCapabilityChanges(changes);
+                logger.info('Manual capability refresh completed with changes');
+            }
+            else {
+                logger.info('Manual capability refresh completed - no changes detected');
+            }
+        }
+        catch (error) {
+            logger.error(`Failed to refresh capabilities: ${error}`);
+        }
+    }
+    /**
+     * Update configuration at runtime
+     */
+    updateConfig() {
+        if (!this.isInitialized) {
+            return;
+        }
+        if (this.notificationManager) {
+            const notificationConfig = {
+                batchNotifications: this.agentConfig.isBatchNotificationsEnabled(),
+                batchDelayMs: this.agentConfig.getBatchDelayMs(),
+                notifyOnServerReady: this.agentConfig.isNotifyOnServerReadyEnabled(),
+            };
+            this.notificationManager.updateConfig(notificationConfig);
+            logger.debug('AsyncLoadingOrchestrator configuration updated');
+        }
+    }
+    /**
+     * Get status summary for monitoring
+     */
+    getStatusSummary() {
+        if (!this.isInitialized) {
+            return 'not-initialized';
+        }
+        const capabilities = this.capabilityAggregator.getCapabilitiesSummary();
+        const notifications = this.notificationManager ? this.notificationManager.getStatusSummary() : 'not-initialized';
+        return `capabilities: ${capabilities}, notifications: ${notifications}`;
+    }
+    /**
+     * Shutdown the orchestrator
+     */
+    shutdown() {
+        if (this.isShuttingDown) {
+            return;
+        }
+        this.isShuttingDown = true;
+        logger.info('Shutting down AsyncLoadingOrchestrator...');
+        try {
+            // Flush any pending notifications
+            if (this.notificationManager) {
+                this.notificationManager.flushPendingNotifications();
+                this.notificationManager.shutdown();
+            }
+            // Remove all listeners
+            this.removeAllListeners();
+            this.capabilityAggregator.removeAllListeners();
+            if (this.notificationManager) {
+                this.notificationManager.removeAllListeners();
+            }
+            logger.info('AsyncLoadingOrchestrator shutdown complete');
+        }
+        catch (error) {
+            logger.error(`Error during AsyncLoadingOrchestrator shutdown: ${error}`);
+        }
+    }
+}
+//# sourceMappingURL=asyncLoadingOrchestrator.js.map

package/build/core/capabilities/asyncLoadingOrchestrator.js.map

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

package/build/core/capabilities/capabilityAggregator.d.ts

@@ -0,0 +1,114 @@
+import { EventEmitter } from 'events';
+import { Tool, Resource, Prompt } from '@modelcontextprotocol/sdk/types.js';
+import { OutboundConnections } from '../types/index.js';
+/**
+ * Represents a snapshot of aggregated capabilities from all ready servers
+ */
+export interface AggregatedCapabilities {
+    readonly tools: Tool[];
+    readonly resources: Resource[];
+    readonly prompts: Prompt[];
+    readonly readyServers: string[];
+    readonly timestamp: Date;
+}
+/**
+ * Represents changes between two capability snapshots
+ */
+export interface CapabilityChanges {
+    readonly hasChanges: boolean;
+    readonly toolsChanged: boolean;
+    readonly resourcesChanged: boolean;
+    readonly promptsChanged: boolean;
+    readonly addedServers: string[];
+    readonly removedServers: string[];
+    readonly previous: AggregatedCapabilities;
+    readonly current: AggregatedCapabilities;
+}
+/**
+ * Events emitted by CapabilityAggregator
+ */
+export interface CapabilityAggregatorEvents {
+    'capabilities-changed': (changes: CapabilityChanges) => void;
+    'server-capabilities-ready': (serverName: string, capabilities: AggregatedCapabilities) => void;
+}
+/**
+ * Aggregates and tracks capabilities (tools, resources, prompts) from all ready MCP servers.
+ * Detects changes when servers come online or go offline and emits events for notification.
+ *
+ * @example
+ * ```typescript
+ * const aggregator = new CapabilityAggregator(outboundConnections);
+ * aggregator.on('capabilities-changed', (changes) => {
+ *   if (changes.toolsChanged) {
+ *     // Send ToolListChangedNotification to clients
+ *   }
+ * });
+ *
+ * // When server comes online
+ * aggregator.updateCapabilities();
+ * ```
+ */
+export declare class CapabilityAggregator extends EventEmitter {
+    private outboundConns;
+    private currentCapabilities;
+    private isInitialized;
+    constructor(outboundConnections: OutboundConnections);
+    /**
+     * Create an empty capabilities snapshot
+     */
+    private createEmptyCapabilities;
+    /**
+     * Get current aggregated capabilities
+     */
+    getCurrentCapabilities(): AggregatedCapabilities;
+    /**
+     * Update capabilities by querying all ready servers
+     * This should be called when server states change
+     */
+    updateCapabilities(): Promise<CapabilityChanges>;
+    /**
+     * Force refresh capabilities from all servers
+     */
+    refreshCapabilities(): Promise<AggregatedCapabilities>;
+    /**
+     * Aggregate capabilities from all ready servers
+     */
+    private aggregateFromReadyServers;
+    /**
+     * Safely list tools from a server
+     */
+    private safeListTools;
+    /**
+     * Safely list resources from a server
+     */
+    private safeListResources;
+    /**
+     * Safely list prompts from a server
+     */
+    private safeListPrompts;
+    /**
+     * Detect changes between two capability snapshots
+     */
+    private detectChanges;
+    /**
+     * Check if two arrays are equal (shallow comparison)
+     */
+    private arraysEqual;
+    /**
+     * Remove duplicate tools based on name
+     */
+    private deduplicateTools;
+    /**
+     * Remove duplicate resources based on URI
+     */
+    private deduplicateResources;
+    /**
+     * Remove duplicate prompts based on name
+     */
+    private deduplicatePrompts;
+    /**
+     * Get summary of current capabilities for logging
+     */
+    getCapabilitiesSummary(): string;
+}
+//# sourceMappingURL=capabilityAggregator.d.ts.map

package/build/core/capabilities/capabilityAggregator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capabilityAggregator.d.ts","sourceRoot":"","sources":["../../../src/core/capabilities/capabilityAggregator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,EAIL,IAAI,EACJ,QAAQ,EACR,MAAM,EACP,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,mBAAmB,EAAgB,MAAM,mBAAmB,CAAC;AAGtE;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,QAAQ,EAAE,CAAC;IAC/B,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC;IAC3B,QAAQ,CAAC,YAAY,EAAE,MAAM,EAAE,CAAC;IAChC,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC;IACnC,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IACjC,QAAQ,CAAC,YAAY,EAAE,MAAM,EAAE,CAAC;IAChC,QAAQ,CAAC,cAAc,EAAE,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,QAAQ,EAAE,sBAAsB,CAAC;IAC1C,QAAQ,CAAC,OAAO,EAAE,sBAAsB,CAAC;CAC1C;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,sBAAsB,EAAE,CAAC,OAAO,EAAE,iBAAiB,KAAK,IAAI,CAAC;IAC7D,2BAA2B,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,YAAY,EAAE,sBAAsB,KAAK,IAAI,CAAC;CACjG;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,oBAAqB,SAAQ,YAAY;IACpD,OAAO,CAAC,aAAa,CAAsB;IAC3C,OAAO,CAAC,mBAAmB,CAAyB;IACpD,OAAO,CAAC,aAAa,CAAkB;gBAE3B,mBAAmB,EAAE,mBAAmB;IAOpD;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAU/B;;OAEG;IACI,sBAAsB,IAAI,sBAAsB;IAIvD;;;OAGG;IACU,kBAAkB,IAAI,OAAO,CAAC,iBAAiB,CAAC;IAsB7D;;OAEG;IACU,mBAAmB,IAAI,OAAO,CAAC,sBAAsB,CAAC;IAKnE;;OAEG;YACW,yBAAyB;IAkDvC;;OAEG;YACW,aAAa;IAS3B;;OAEG;YACW,iBAAiB;IAS/B;;OAEG;YACW,eAAe;IAS7B;;OAEG;IACH,OAAO,CAAC,aAAa;IAkCrB;;OAEG;IACH,OAAO,CAAC,WAAW;IAInB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAYxB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAY5B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAY1B;;OAEG;IACI,sBAAsB,IAAI,MAAM;CAIxC"}

package/build/core/capabilities/capabilityAggregator.js

@@ -0,0 +1,234 @@
+import { EventEmitter } from 'events';
+import { ClientStatus } from '../types/index.js';
+import logger from '../../logger/logger.js';
+/**
+ * Aggregates and tracks capabilities (tools, resources, prompts) from all ready MCP servers.
+ * Detects changes when servers come online or go offline and emits events for notification.
+ *
+ * @example
+ * ```typescript
+ * const aggregator = new CapabilityAggregator(outboundConnections);
+ * aggregator.on('capabilities-changed', (changes) => {
+ *   if (changes.toolsChanged) {
+ *     // Send ToolListChangedNotification to clients
+ *   }
+ * });
+ *
+ * // When server comes online
+ * aggregator.updateCapabilities();
+ * ```
+ */
+export class CapabilityAggregator extends EventEmitter {
+    outboundConns;
+    currentCapabilities;
+    isInitialized = false;
+    constructor(outboundConnections) {
+        super();
+        this.outboundConns = outboundConnections;
+        this.currentCapabilities = this.createEmptyCapabilities();
+        this.setMaxListeners(50);
+    }
+    /**
+     * Create an empty capabilities snapshot
+     */
+    createEmptyCapabilities() {
+        return {
+            tools: [],
+            resources: [],
+            prompts: [],
+            readyServers: [],
+            timestamp: new Date(),
+        };
+    }
+    /**
+     * Get current aggregated capabilities
+     */
+    getCurrentCapabilities() {
+        return this.currentCapabilities;
+    }
+    /**
+     * Update capabilities by querying all ready servers
+     * This should be called when server states change
+     */
+    async updateCapabilities() {
+        const previousCapabilities = this.currentCapabilities;
+        const newCapabilities = await this.aggregateFromReadyServers();
+        const changes = this.detectChanges(previousCapabilities, newCapabilities);
+        this.currentCapabilities = newCapabilities;
+        if (!this.isInitialized) {
+            this.isInitialized = true;
+            logger.debug('CapabilityAggregator initialized with capabilities from ready servers');
+        }
+        if (changes.hasChanges) {
+            logger.info(`Capabilities changed: tools=${changes.toolsChanged}, resources=${changes.resourcesChanged}, prompts=${changes.promptsChanged}`);
+            this.emit('capabilities-changed', changes);
+        }
+        return changes;
+    }
+    /**
+     * Force refresh capabilities from all servers
+     */
+    async refreshCapabilities() {
+        const changes = await this.updateCapabilities();
+        return changes.current;
+    }
+    /**
+     * Aggregate capabilities from all ready servers
+     */
+    async aggregateFromReadyServers() {
+        const readyServers = [];
+        const allTools = [];
+        const allResources = [];
+        const allPrompts = [];
+        for (const [serverName, connection] of this.outboundConns.entries()) {
+            if (connection.status !== ClientStatus.Connected || !connection.client.transport) {
+                continue;
+            }
+            try {
+                readyServers.push(serverName);
+                // Fetch tools, resources, and prompts in parallel
+                const [toolsResult, resourcesResult, promptsResult] = await Promise.allSettled([
+                    this.safeListTools(serverName, connection.client),
+                    this.safeListResources(serverName, connection.client),
+                    this.safeListPrompts(serverName, connection.client),
+                ]);
+                // Process tools
+                if (toolsResult.status === 'fulfilled' && toolsResult.value.tools) {
+                    allTools.push(...toolsResult.value.tools);
+                }
+                // Process resources
+                if (resourcesResult.status === 'fulfilled' && resourcesResult.value.resources) {
+                    allResources.push(...resourcesResult.value.resources);
+                }
+                // Process prompts
+                if (promptsResult.status === 'fulfilled' && promptsResult.value.prompts) {
+                    allPrompts.push(...promptsResult.value.prompts);
+                }
+            }
+            catch (error) {
+                logger.warn(`Failed to aggregate capabilities from ${serverName}: ${error}`);
+                // Continue with other servers
+            }
+        }
+        return {
+            tools: this.deduplicateTools(allTools),
+            resources: this.deduplicateResources(allResources),
+            prompts: this.deduplicatePrompts(allPrompts),
+            readyServers: readyServers.sort(),
+            timestamp: new Date(),
+        };
+    }
+    /**
+     * Safely list tools from a server
+     */
+    async safeListTools(serverName, client) {
+        try {
+            return await client.listTools();
+        }
+        catch (error) {
+            logger.debug(`Failed to list tools from ${serverName}: ${error}`);
+            return { tools: [] };
+        }
+    }
+    /**
+     * Safely list resources from a server
+     */
+    async safeListResources(serverName, client) {
+        try {
+            return await client.listResources();
+        }
+        catch (error) {
+            logger.debug(`Failed to list resources from ${serverName}: ${error}`);
+            return { resources: [] };
+        }
+    }
+    /**
+     * Safely list prompts from a server
+     */
+    async safeListPrompts(serverName, client) {
+        try {
+            return await client.listPrompts();
+        }
+        catch (error) {
+            logger.debug(`Failed to list prompts from ${serverName}: ${error}`);
+            return { prompts: [] };
+        }
+    }
+    /**
+     * Detect changes between two capability snapshots
+     */
+    detectChanges(previous, current) {
+        const toolsChanged = !this.arraysEqual(previous.tools.map((t) => t.name).sort(), current.tools.map((t) => t.name).sort());
+        const resourcesChanged = !this.arraysEqual(previous.resources.map((r) => r.uri).sort(), current.resources.map((r) => r.uri).sort());
+        const promptsChanged = !this.arraysEqual(previous.prompts.map((p) => p.name).sort(), current.prompts.map((p) => p.name).sort());
+        const addedServers = current.readyServers.filter((s) => !previous.readyServers.includes(s));
+        const removedServers = previous.readyServers.filter((s) => !current.readyServers.includes(s));
+        const hasChanges = toolsChanged || resourcesChanged || promptsChanged || addedServers.length > 0 || removedServers.length > 0;
+        return {
+            hasChanges,
+            toolsChanged,
+            resourcesChanged,
+            promptsChanged,
+            addedServers,
+            removedServers,
+            previous,
+            current,
+        };
+    }
+    /**
+     * Check if two arrays are equal (shallow comparison)
+     */
+    arraysEqual(a, b) {
+        return a.length === b.length && a.every((val, index) => val === b[index]);
+    }
+    /**
+     * Remove duplicate tools based on name
+     */
+    deduplicateTools(tools) {
+        const seen = new Set();
+        return tools.filter((tool) => {
+            if (seen.has(tool.name)) {
+                logger.debug(`Duplicate tool name detected: ${tool.name}`);
+                return false;
+            }
+            seen.add(tool.name);
+            return true;
+        });
+    }
+    /**
+     * Remove duplicate resources based on URI
+     */
+    deduplicateResources(resources) {
+        const seen = new Set();
+        return resources.filter((resource) => {
+            if (seen.has(resource.uri)) {
+                logger.debug(`Duplicate resource URI detected: ${resource.uri}`);
+                return false;
+            }
+            seen.add(resource.uri);
+            return true;
+        });
+    }
+    /**
+     * Remove duplicate prompts based on name
+     */
+    deduplicatePrompts(prompts) {
+        const seen = new Set();
+        return prompts.filter((prompt) => {
+            if (seen.has(prompt.name)) {
+                logger.debug(`Duplicate prompt name detected: ${prompt.name}`);
+                return false;
+            }
+            seen.add(prompt.name);
+            return true;
+        });
+    }
+    /**
+     * Get summary of current capabilities for logging
+     */
+    getCapabilitiesSummary() {
+        const caps = this.currentCapabilities;
+        return `${caps.tools.length} tools, ${caps.resources.length} resources, ${caps.prompts.length} prompts from ${caps.readyServers.length} servers`;
+    }
+}
+//# sourceMappingURL=capabilityAggregator.js.map

package/build/core/capabilities/capabilityAggregator.js.map

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

package/build/core/client/clientManager.d.ts

@@ -45,6 +45,35 @@ export declare class ClientManager {
      * @returns Map of all outbound connections
      */
     getClients(): OutboundConnections;
+    /**
+     * Creates a single client for async loading (used by McpLoadingManager)
+     * @param name The name of the client
+     * @param transport The transport to connect to
+     * @param abortSignal Optional AbortSignal to cancel the operation
+     * @returns Promise that resolves when client is connected
+     */
+    createSingleClient(name: string, transport: AuthProviderTransport, abortSignal?: AbortSignal): Promise<void>;
+    /**
+     * Internal method to create and connect a single client
+     */
+    private createSingleClientInternal;
+    /**
+     * Initialize clients storage without connecting (for async loading)
+     * @param transports Record of transport instances
+     * @returns Empty connections map (to be populated by async loading)
+     */
+    initializeClientsAsync(transports: Record<string, AuthProviderTransport>): OutboundConnections;
+    /**
+     * Get transport by name (used by loading manager for retries)
+     * @param name The transport name
+     * @returns The transport instance or undefined
+     */
+    getTransport(name: string): AuthProviderTransport | undefined;
+    /**
+     * Get all transport names
+     * @returns Array of transport names
+     */
+    getTransportNames(): string[];
     /**
      * Executes a client operation with error handling and retry logic
      * @param clientName The name of the client to use