@1mcp/agent 0.28.0 → 0.29.0-beta1

package/build/core/server/serverManager.d.ts

@@ -1,19 +1,38 @@
 import { Transport } from '@modelcontextprotocol/sdk/shared/transport.js';
+import { ClientTemplateTracker, FilterCache, TemplateIndex } from '../../core/filtering/index.js';
 import { InstructionAggregator } from '../../core/instructions/instructionAggregator.js';
-import type { OutboundConnection } from '../../core/types/client.js';
-import { InboundConnection, InboundConnectionConfig, MCPServerParams, OperationOptions, OutboundConnections } from '../../core/types/index.js';
+import { TemplateServerManager } from '../../core/server/templateServerManager.js';
+import type { InboundConnection, InboundConnectionConfig, MCPServerParams, OperationOptions, OutboundConnection, OutboundConnections } from '../../core/types/index.js';
+import type { ContextData } from '../../types/context.js';
+/**
+ * Event data for context change events
+ */
+export interface ContextChangedEventData {
+    newContext: ContextData;
+    sessionIdChanged: boolean;
+}
+/**
+ * Refactored ServerManager that coordinates various server management components
+ *
+ * This class acts as a facade that delegates to specialized managers:
+ * - ConnectionManager: Handles transport connection lifecycle
+ * - TemplateServerManager: Manages template-based server instances
+ * - MCPServerLifecycleManager: Manages MCP server start/stop/restart operations
+ * - ConfigurationManager: Handles configuration reprocessing with circuit breaker
+ */
 export declare class ServerManager {
     private static instance;
-    private inboundConns;
     private serverConfig;
     private serverCapabilities;
     private outboundConns;
     private transports;
-    private connectionSemaphore;
-    private disconnectingIds;
+    private serverConfigData;
     private instructionAggregator?;
-    private clientManager?;
-    private mcpServers;
+    private connectionManager;
+    private templateServerManager;
+    private mcpServerLifecycleManager;
+    private templateConfigurationManager;
+    private filterCache;
     private constructor();
     static getOrCreateInstance(config: {
         name: string;
@@ -22,82 +41,63 @@ export declare class ServerManager {
         capabilities: Record<string, unknown>;
     }, outboundConns: OutboundConnections, transports: Record<string, Transport>): ServerManager;
     static get current(): ServerManager;
-    static resetInstance(): void;
+    static resetInstance(): Promise<void>;
     /**
      * Set the instruction aggregator instance
-     * @param aggregator The instruction aggregator to use
      */
     setInstructionAggregator(aggregator: InstructionAggregator): void;
+    /**
+     * Set up context change listener for dynamic template processing
+     */
+    private setupContextChangeListener;
+    /**
+     * Get current server configurations
+     */
+    private getCurrentServerConfigs;
     /**
      * Update all server instances with new aggregated instructions
      */
     private updateServerInstructions;
-    connectTransport(transport: Transport, sessionId: string, opts: InboundConnectionConfig): Promise<void>;
-    private performConnection;
-    private doConnect;
-    disconnectTransport(sessionId: string, forceClose?: boolean): void;
+    connectTransport(transport: Transport, sessionId: string, opts: InboundConnectionConfig, context?: ContextData): Promise<void>;
+    disconnectTransport(sessionId: string, forceClose?: boolean): Promise<void>;
     getTransport(sessionId: string): Transport | undefined;
     getTransports(): Map<string, Transport>;
     getClientTransports(): Record<string, Transport>;
     getClients(): OutboundConnections;
-    /**
-     * Safely get a client by name. Returns undefined if not found or not an own property.
-     * Encapsulates access to prevent prototype pollution and accidental key collisions.
-     */
     getClient(serverName: string): OutboundConnection | undefined;
     getActiveTransportsCount(): number;
     getServer(sessionId: string): InboundConnection | undefined;
     getInboundConnections(): Map<string, InboundConnection>;
+    getTemplateServerManager(): TemplateServerManager;
     updateClientsAndTransports(newClients: OutboundConnections, newTransports: Record<string, Transport>): void;
-    /**
-     * Executes a server operation with error handling and retry logic
-     * @param inboundConn The inbound connection to execute the operation on
-     * @param operation The operation to execute
-     * @param options Operation options including timeout and retry settings
-     */
     executeServerOperation<T>(inboundConn: InboundConnection, operation: (inboundConn: InboundConnection) => Promise<T>, options?: OperationOptions): Promise<T>;
-    /**
-     * Start a new MCP server instance
-     */
     startServer(serverName: string, config: MCPServerParams): Promise<void>;
-    /**
-     * Stop a server instance
-     */
     stopServer(serverName: string): Promise<void>;
-    /**
-     * Restart a server instance
-     */
     restartServer(serverName: string, config: MCPServerParams): Promise<void>;
-    /**
-     * Process server configuration to handle environment variables
-     */
-    private processServerConfig;
-    /**
-     * Create a transport for the given server configuration
-     */
-    private createServerTransport;
-    /**
-     * Connect to a server using ClientManager
-     */
-    private connectToServer;
-    /**
-     * Disconnect from a server using ClientManager
-     */
-    private disconnectFromServer;
-    /**
-     * Get the status of all managed MCP servers
-     */
     getMcpServerStatus(): Map<string, {
         running: boolean;
         config: MCPServerParams;
     }>;
-    /**
-     * Check if a specific MCP server is running
-     */
     isMcpServerRunning(serverName: string): boolean;
+    updateServerMetadata(serverName: string, newConfig: MCPServerParams): Promise<void>;
+    getFilteringStats(): {
+        tracker: ReturnType<ClientTemplateTracker['getStats']> | null;
+        cache: ReturnType<FilterCache['getStats']> | null;
+        index: ReturnType<TemplateIndex['getStats']> | null;
+        enabled: boolean;
+    };
+    getClientTemplateInfo(): ReturnType<ClientTemplateTracker['getDetailedInfo']>;
+    rebuildTemplateIndex(): void;
+    clearFilterCache(): void;
+    getIdleTemplateInstances(idleTimeoutMs?: number): Array<{
+        templateName: string;
+        instanceId: string;
+        idleTime: number;
+    }>;
+    cleanupIdleInstances(): Promise<number>;
     /**
-     * Update metadata for a running server without restarting it
+     * Clean up all resources (for shutdown)
      */
-    updateServerMetadata(serverName: string, newConfig: MCPServerParams): Promise<void>;
+    cleanup(): Promise<void>;
 }
 //# sourceMappingURL=serverManager.d.ts.map

package/build/core/server/serverManager.d.ts.map

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