@1mcp/agent 0.15.0 → 0.17.0

package/build/server.js

@@ -4,30 +4,103 @@ import { createTransports } from './transport/transportFactory.js';
 import { ClientManager } from './core/client/clientManager.js';
 import { ServerManager } from './core/server/serverManager.js';
 import { McpConfigManager } from './config/mcpConfigManager.js';
+import { AgentConfigManager } from './core/server/agentConfig.js';
 import configReloadService from './services/configReloadService.js';
+import { McpLoadingManager } from './core/loading/mcpLoadingManager.js';
+import { AsyncLoadingOrchestrator } from './core/capabilities/asyncLoadingOrchestrator.js';
 /**
  * Main function to set up the MCP server
+ * Conditionally uses async or legacy loading based on configuration
  */
 async function setupServer() {
     try {
         const mcpConfig = McpConfigManager.getInstance().getTransportConfig();
+        const agentConfig = AgentConfigManager.getInstance();
+        const asyncLoadingEnabled = agentConfig.isAsyncLoadingEnabled();
         // Create transports from configuration
         const transports = createTransports(mcpConfig);
         logger.info(`Created ${Object.keys(transports).length} transports`);
-        // Create clients for each transport
-        const clientManager = ClientManager.getOrCreateInstance();
-        const clients = await clientManager.createClients(transports);
-        logger.info(`Created ${clients.size} clients`);
-        const serverManager = ServerManager.getOrCreateInstance({ name: MCP_SERVER_NAME, version: MCP_SERVER_VERSION }, { capabilities: MCP_SERVER_CAPABILITIES }, clients, transports);
-        // Initialize config reload service at server startup
-        configReloadService.initialize(transports);
-        logger.info('Server setup completed successfully');
-        return serverManager;
+        if (asyncLoadingEnabled) {
+            logger.info('Using async loading mode - HTTP server will start immediately, MCP servers load in background');
+            return setupServerAsync(transports);
+        }
+        else {
+            logger.info('Using legacy synchronous loading mode - waiting for all MCP servers before starting HTTP server');
+            return setupServerSync(transports);
+        }
     }
     catch (error) {
         logger.error(`Failed to set up server: ${error}`);
         throw error;
     }
 }
-export { setupServer };
+/**
+ * Set up server with async loading (new mode)
+ * HTTP server starts immediately, MCP servers load in background
+ */
+async function setupServerAsync(transports) {
+    // Initialize client manager without connecting (for async loading)
+    const clientManager = ClientManager.getOrCreateInstance();
+    const clients = clientManager.initializeClientsAsync(transports);
+    logger.info(`Initialized storage for ${Object.keys(transports).length} MCP servers`);
+    // Create server manager with empty clients initially
+    const serverManager = ServerManager.getOrCreateInstance({ name: MCP_SERVER_NAME, version: MCP_SERVER_VERSION }, { capabilities: MCP_SERVER_CAPABILITIES }, clients, transports);
+    // Initialize config reload service
+    configReloadService.initialize(transports);
+    // Create loading manager for async MCP server initialization
+    const loadingManager = new McpLoadingManager(clientManager);
+    // Create async loading orchestrator for capability tracking and notifications
+    const asyncOrchestrator = new AsyncLoadingOrchestrator(clients, serverManager, loadingManager);
+    asyncOrchestrator.initialize();
+    // Start async loading (non-blocking)
+    const loadingPromise = loadingManager
+        .startAsyncLoading(transports)
+        .then(() => {
+        logger.info('All MCP servers finished loading (successfully or failed)');
+    })
+        .catch((error) => {
+        logger.error('MCP loading process encountered an error:', error);
+    });
+    logger.info('Async server setup completed - HTTP server ready, MCP servers loading in background');
+    return {
+        serverManager,
+        loadingManager,
+        loadingPromise,
+        asyncOrchestrator,
+    };
+}
+/**
+ * Set up server with legacy synchronous loading
+ * Waits for all MCP servers to load before returning
+ */
+async function setupServerSync(transports) {
+    // Use the standard synchronous client creation
+    const clientManager = ClientManager.getOrCreateInstance();
+    const clients = await clientManager.createClients(transports);
+    logger.info(`Connected to ${clients.size} MCP servers synchronously`);
+    // Create server manager with connected clients
+    const serverManager = ServerManager.getOrCreateInstance({ name: MCP_SERVER_NAME, version: MCP_SERVER_VERSION }, { capabilities: MCP_SERVER_CAPABILITIES }, clients, transports);
+    // Initialize config reload service
+    configReloadService.initialize(transports);
+    // Create a dummy loading manager for compatibility
+    const loadingManager = new McpLoadingManager(clientManager);
+    const loadingPromise = Promise.resolve(); // Already loaded
+    logger.info('Synchronous server setup completed - all MCP servers connected');
+    return {
+        serverManager,
+        loadingManager,
+        loadingPromise,
+    };
+}
+/**
+ * Legacy function for backward compatibility
+ * @deprecated Use setupServer() which returns ServerSetupResult
+ */
+async function setupServerLegacy() {
+    const result = await setupServer();
+    // Wait for loading to complete for legacy behavior
+    await result.loadingPromise;
+    return result.serverManager;
+}
+export { setupServer, setupServerLegacy };
 //# sourceMappingURL=server.js.map

package/build/server.js.map

@@ -1 +1 @@
-{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAC9F,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACnE,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAC/D,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,mBAAmB,MAAM,mCAAmC,CAAC;AAEpE;;GAEG;AACH,KAAK,UAAU,WAAW;IACxB,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,gBAAgB,CAAC,WAAW,EAAE,CAAC,kBAAkB,EAAE,CAAC;QACtE,uCAAuC;QACvC,MAAM,UAAU,GAAG,gBAAgB,CAAC,SAAS,CAAC,CAAC;QAC/C,MAAM,CAAC,IAAI,CAAC,WAAW,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,MAAM,aAAa,CAAC,CAAC;QAEpE,oCAAoC;QACpC,MAAM,aAAa,GAAG,aAAa,CAAC,mBAAmB,EAAE,CAAC;QAC1D,MAAM,OAAO,GAAG,MAAM,aAAa,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC;QAC9D,MAAM,CAAC,IAAI,CAAC,WAAW,OAAO,CAAC,IAAI,UAAU,CAAC,CAAC;QAE/C,MAAM,aAAa,GAAG,aAAa,CAAC,mBAAmB,CACrD,EAAE,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,kBAAkB,EAAE,EACtD,EAAE,YAAY,EAAE,uBAAuB,EAAE,EACzC,OAAO,EACP,UAAU,CACX,CAAC;QAEF,qDAAqD;QACrD,mBAAmB,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;QAE3C,MAAM,CAAC,IAAI,CAAC,qCAAqC,CAAC,CAAC;QACnD,OAAO,aAAa,CAAC;IACvB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,KAAK,CAAC,4BAA4B,KAAK,EAAE,CAAC,CAAC;QAClD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED,OAAO,EAAE,WAAW,EAAE,CAAC"}
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}

package/build/services/healthService.d.ts

@@ -0,0 +1,107 @@
+import { ClientStatus } from '../core/types/index.js';
+/**
+ * Health status levels
+ */
+export declare enum HealthStatus {
+    HEALTHY = "healthy",
+    DEGRADED = "degraded",
+    UNHEALTHY = "unhealthy"
+}
+/**
+ * MCP server health information
+ */
+export interface McpServerHealth {
+    name: string;
+    status: ClientStatus;
+    healthy: boolean;
+    lastConnected?: Date;
+    lastError?: string;
+    tags?: string[];
+}
+/**
+ * System health metrics
+ */
+export interface SystemHealth {
+    uptime: number;
+    memory: {
+        used: number;
+        total: number;
+        percentage: number;
+    };
+    process: {
+        pid: number;
+        nodeVersion: string;
+        platform: string;
+        arch: string;
+    };
+}
+/**
+ * Complete health check response
+ */
+export interface HealthCheckResponse {
+    status: HealthStatus;
+    timestamp: string;
+    version: string;
+    system: SystemHealth;
+    servers: {
+        total: number;
+        healthy: number;
+        unhealthy: number;
+        details: McpServerHealth[];
+    };
+    configuration: {
+        loaded: boolean;
+        serverCount: number;
+        enabledCount: number;
+        disabledCount: number;
+        authEnabled: boolean;
+        transport: string;
+    };
+}
+/**
+ * Health service for monitoring system and MCP server status
+ */
+export declare class HealthService {
+    private static instance;
+    private startTime;
+    private agentConfig;
+    private constructor();
+    /**
+     * Get singleton instance
+     */
+    static getInstance(): HealthService;
+    /**
+     * Perform complete health check
+     */
+    performHealthCheck(): Promise<HealthCheckResponse>;
+    /**
+     * Sanitize health response based on security configuration
+     */
+    private sanitizeHealthResponse;
+    /**
+     * Sanitize error messages to prevent information leakage
+     */
+    private sanitizeErrorMessage;
+    /**
+     * Get system health metrics
+     */
+    private getSystemHealth;
+    /**
+     * Get MCP server health status
+     */
+    private getServerHealth;
+    /**
+     * Get configuration health status
+     */
+    private getConfigurationHealth;
+    /**
+     * Determine overall health status based on component status
+     */
+    private determineOverallHealth;
+    /**
+     * Get HTTP status code based on health status
+     */
+    getHttpStatusCode(healthStatus: HealthStatus): number;
+}
+export default HealthService;
+//# sourceMappingURL=healthService.d.ts.map

package/build/services/healthService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"healthService.d.ts","sourceRoot":"","sources":["../../src/services/healthService.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAOtD;;GAEG;AACH,oBAAY,YAAY;IACtB,OAAO,YAAY;IACnB,QAAQ,aAAa;IACrB,SAAS,cAAc;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,YAAY,CAAC;IACrB,OAAO,EAAE,OAAO,CAAC;IACjB,aAAa,CAAC,EAAE,IAAI,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE;QACN,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,OAAO,EAAE;QACP,GAAG,EAAE,MAAM,CAAC;QACZ,WAAW,EAAE,MAAM,CAAC;QACpB,QAAQ,EAAE,MAAM,CAAC;QACjB,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,YAAY,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,YAAY,CAAC;IACrB,OAAO,EAAE;QACP,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,eAAe,EAAE,CAAC;KAC5B,CAAC;IACF,aAAa,EAAE;QACb,MAAM,EAAE,OAAO,CAAC;QAChB,WAAW,EAAE,MAAM,CAAC;QACpB,YAAY,EAAE,MAAM,CAAC;QACrB,aAAa,EAAE,MAAM,CAAC;QACtB,WAAW,EAAE,OAAO,CAAC;QACrB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;CACH;AAED;;GAEG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAgB;IACvC,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,WAAW,CAAqB;IAExC,OAAO;IAKP;;OAEG;WACW,WAAW,IAAI,aAAa;IAO1C;;OAEG;IACU,kBAAkB,IAAI,OAAO,CAAC,mBAAmB,CAAC;IAyB/D;;OAEG;IACH,OAAO,CAAC,sBAAsB;IA0E9B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAc5B;;OAEG;IACH,OAAO,CAAC,eAAe;IAmBvB;;OAEG;YACW,eAAe;IAqD7B;;OAEG;IACH,OAAO,CAAC,sBAAsB;IA+B9B;;OAEG;IACH,OAAO,CAAC,sBAAsB;IA4B9B;;OAEG;IACI,iBAAiB,CAAC,YAAY,EAAE,YAAY,GAAG,MAAM;CAY7D;AAED,eAAe,aAAa,CAAC"}

package/build/services/healthService.js

@@ -0,0 +1,294 @@
+import { ClientStatus } from '../core/types/index.js';
+import { ServerManager } from '../core/server/serverManager.js';
+import { McpConfigManager } from '../config/mcpConfigManager.js';
+import { AgentConfigManager } from '../core/server/agentConfig.js';
+import { MCP_SERVER_VERSION } from '../constants.js';
+import logger from '../logger/logger.js';
+/**
+ * Health status levels
+ */
+export var HealthStatus;
+(function (HealthStatus) {
+    HealthStatus["HEALTHY"] = "healthy";
+    HealthStatus["DEGRADED"] = "degraded";
+    HealthStatus["UNHEALTHY"] = "unhealthy";
+})(HealthStatus || (HealthStatus = {}));
+/**
+ * Health service for monitoring system and MCP server status
+ */
+export class HealthService {
+    static instance;
+    startTime;
+    agentConfig;
+    constructor() {
+        this.startTime = Date.now();
+        this.agentConfig = AgentConfigManager.getInstance();
+    }
+    /**
+     * Get singleton instance
+     */
+    static getInstance() {
+        if (!HealthService.instance) {
+            HealthService.instance = new HealthService();
+        }
+        return HealthService.instance;
+    }
+    /**
+     * Perform complete health check
+     */
+    async performHealthCheck() {
+        try {
+            const systemHealth = this.getSystemHealth();
+            const serverHealth = await this.getServerHealth();
+            const configHealth = this.getConfigurationHealth();
+            const overallStatus = this.determineOverallHealth(serverHealth, configHealth);
+            const fullResponse = {
+                status: overallStatus,
+                timestamp: new Date().toISOString(),
+                version: MCP_SERVER_VERSION,
+                system: systemHealth,
+                servers: serverHealth,
+                configuration: configHealth,
+            };
+            // Apply security configuration to sanitize response
+            return this.sanitizeHealthResponse(fullResponse);
+        }
+        catch (error) {
+            logger.error('Health check failed:', error);
+            throw error;
+        }
+    }
+    /**
+     * Sanitize health response based on security configuration
+     */
+    sanitizeHealthResponse(response) {
+        const detailLevel = this.agentConfig.getHealthDetailLevel();
+        // Apply detail level restrictions
+        switch (detailLevel) {
+            case 'minimal':
+                // Minimal: Only basic status, no sensitive details
+                return {
+                    status: response.status,
+                    timestamp: response.timestamp,
+                    version: response.version,
+                    system: {
+                        uptime: response.system.uptime,
+                        memory: { used: 0, total: 0, percentage: 0 },
+                        process: { pid: 0, nodeVersion: '', platform: '', arch: '' },
+                    },
+                    servers: {
+                        total: response.servers.total,
+                        healthy: response.servers.healthy,
+                        unhealthy: response.servers.unhealthy,
+                        details: [],
+                    },
+                    configuration: {
+                        loaded: response.configuration.loaded,
+                        serverCount: 0,
+                        enabledCount: 0,
+                        disabledCount: 0,
+                        authEnabled: false,
+                        transport: 'http',
+                    },
+                };
+            case 'basic':
+                // Basic: Some server info but sanitized errors and no sensitive system details
+                return {
+                    ...response,
+                    system: {
+                        uptime: response.system.uptime,
+                        memory: {
+                            used: Math.round(response.system.memory.used),
+                            total: Math.round(response.system.memory.total),
+                            percentage: response.system.memory.percentage,
+                        },
+                        process: { pid: 0, nodeVersion: '', platform: '', arch: '' },
+                    },
+                    servers: {
+                        ...response.servers,
+                        details: response.servers.details.map((server) => ({
+                            name: server.name,
+                            status: server.status,
+                            healthy: server.healthy,
+                            lastConnected: server.lastConnected,
+                            lastError: this.sanitizeErrorMessage(server.lastError),
+                            tags: server.tags,
+                        })),
+                    },
+                };
+            case 'full':
+            default:
+                // Full: All details but with basic error sanitization
+                return {
+                    ...response,
+                    servers: {
+                        ...response.servers,
+                        details: response.servers.details.map((server) => ({
+                            ...server,
+                            lastError: this.sanitizeErrorMessage(server.lastError),
+                        })),
+                    },
+                };
+        }
+    }
+    /**
+     * Sanitize error messages to prevent information leakage
+     */
+    sanitizeErrorMessage(errorMessage) {
+        if (!errorMessage)
+            return undefined;
+        // Remove potentially sensitive information from error messages
+        return errorMessage
+            .replace(/\b(?:password|token|key|secret|auth)\s*[:=]\s*[^\s]+/gi, '[REDACTED_CREDENTIAL]') // Key-value credentials
+            .replace(/\b[\w.-]+:[\w.-]+@/gi, '[REDACTED_CREDENTIAL]') // User:password@ patterns
+            .replace(/\bhttps?:\/\/[\w.-]+(?::\d+)?(?:\/[^\s]*)?/gi, '[REDACTED_URL]') // Complete URLs
+            .replace(/(?:[A-Za-z]:)?[/\\][\w.-]+(?:[/\\][\w.-]+)*\.(?:json|js|ts|py|yml|yaml|conf|ini)\b/g, '[REDACTED_PATH]') // File paths
+            .replace(/\b\d{1,3}\.\d{1,3}\.\d{1,3}\.\d{1,3}\b/g, '[REDACTED_IP]') // IP addresses
+            .replace(/\blocalhost(?::\d+)?\b/gi, '[REDACTED_HOST]') // Localhost references
+            .substring(0, 100); // Limit error message length
+    }
+    /**
+     * Get system health metrics
+     */
+    getSystemHealth() {
+        const memUsage = process.memoryUsage();
+        return {
+            uptime: Math.floor((Date.now() - this.startTime) / 1000),
+            memory: {
+                used: Math.round((memUsage.heapUsed / 1024 / 1024) * 100) / 100, // MB
+                total: Math.round((memUsage.heapTotal / 1024 / 1024) * 100) / 100, // MB
+                percentage: Math.round((memUsage.heapUsed / memUsage.heapTotal) * 100 * 100) / 100,
+            },
+            process: {
+                pid: process.pid,
+                nodeVersion: process.version,
+                platform: process.platform,
+                arch: process.arch,
+            },
+        };
+    }
+    /**
+     * Get MCP server health status
+     */
+    async getServerHealth() {
+        try {
+            const serverManager = ServerManager.current;
+            if (!serverManager) {
+                return {
+                    total: 0,
+                    healthy: 0,
+                    unhealthy: 0,
+                    details: [],
+                };
+            }
+            const clients = serverManager.getClients();
+            const serverDetails = [];
+            let healthyCount = 0;
+            let unhealthyCount = 0;
+            for (const [name, clientInfo] of clients.entries()) {
+                const isHealthy = clientInfo.status === ClientStatus.Connected;
+                if (isHealthy) {
+                    healthyCount++;
+                }
+                else {
+                    unhealthyCount++;
+                }
+                serverDetails.push({
+                    name,
+                    status: clientInfo.status,
+                    healthy: isHealthy,
+                    lastConnected: clientInfo.lastConnected,
+                    lastError: clientInfo.lastError?.message,
+                    tags: clientInfo.transport.tags,
+                });
+            }
+            return {
+                total: clients.size,
+                healthy: healthyCount,
+                unhealthy: unhealthyCount,
+                details: serverDetails,
+            };
+        }
+        catch (error) {
+            logger.error('Error getting server health:', error);
+            return {
+                total: 0,
+                healthy: 0,
+                unhealthy: 0,
+                details: [],
+            };
+        }
+    }
+    /**
+     * Get configuration health status
+     */
+    getConfigurationHealth() {
+        try {
+            const mcpConfig = McpConfigManager.getInstance();
+            const agentConfig = AgentConfigManager.getInstance();
+            const config = mcpConfig.getTransportConfig();
+            const serverCount = Object.keys(config).length;
+            const enabledCount = Object.values(config).filter((server) => !server.disabled).length;
+            const disabledCount = serverCount - enabledCount;
+            return {
+                loaded: true,
+                serverCount,
+                enabledCount,
+                disabledCount,
+                authEnabled: agentConfig.isAuthEnabled(),
+                transport: 'http', // Since this is the HTTP transport layer
+            };
+        }
+        catch (error) {
+            logger.error('Error getting configuration health:', error);
+            return {
+                loaded: false,
+                serverCount: 0,
+                enabledCount: 0,
+                disabledCount: 0,
+                authEnabled: false,
+                transport: 'unknown',
+            };
+        }
+    }
+    /**
+     * Determine overall health status based on component status
+     */
+    determineOverallHealth(serverHealth, configHealth) {
+        // Configuration must be loaded
+        if (!configHealth.loaded) {
+            return HealthStatus.UNHEALTHY;
+        }
+        // If no servers are configured, system is healthy but degraded
+        if (serverHealth.total === 0) {
+            return HealthStatus.DEGRADED;
+        }
+        // If all servers are healthy, system is healthy
+        if (serverHealth.healthy === serverHealth.total) {
+            return HealthStatus.HEALTHY;
+        }
+        // If more than half servers are healthy, system is degraded
+        if (serverHealth.healthy > serverHealth.total / 2) {
+            return HealthStatus.DEGRADED;
+        }
+        // If less than half servers are healthy, system is unhealthy
+        return HealthStatus.UNHEALTHY;
+    }
+    /**
+     * Get HTTP status code based on health status
+     */
+    getHttpStatusCode(healthStatus) {
+        switch (healthStatus) {
+            case HealthStatus.HEALTHY:
+                return 200;
+            case HealthStatus.DEGRADED:
+                return 200; // Still operational, but with warnings
+            case HealthStatus.UNHEALTHY:
+                return 503; // Service unavailable
+            default:
+                return 500; // Internal server error
+        }
+    }
+}
+export default HealthService;
+//# sourceMappingURL=healthService.js.map

package/build/services/healthService.js.map

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

package/build/transport/http/middlewares/mcpAvailabilityMiddleware.d.ts

@@ -0,0 +1,79 @@
+import { Request, Response, NextFunction } from 'express';
+import { McpLoadingManager } from '../../../core/loading/mcpLoadingManager.js';
+/**
+ * Extended request interface to include MCP loading information
+ */
+export interface McpRequest extends Request {
+    mcpAvailability?: {
+        availableServers: string[];
+        unavailableServers: string[];
+        loadingServers: string[];
+        oauthRequiredServers: string[];
+        hasPartialAvailability: boolean;
+        allServersReady: boolean;
+        requestedTags?: string[];
+        totalServersBeforeFiltering?: number;
+    };
+}
+/**
+ * Middleware options for MCP availability checking
+ */
+export interface McpAvailabilityOptions {
+    /** Whether to allow requests when some servers are still loading */
+    allowPartialAvailability?: boolean;
+    /** Whether to include OAuth-required servers as available */
+    includeOAuthServers?: boolean;
+    /** Custom error message for unavailable servers */
+    unavailableMessage?: string;
+    /** Custom error message for loading servers */
+    loadingMessage?: string;
+}
+/**
+ * Creates middleware that checks MCP server availability before processing requests
+ *
+ * This middleware examines the loading state of MCP servers and provides different
+ * behaviors based on server availability and configuration options.
+ *
+ * @param loadingManager - The MCP loading manager instance
+ * @param options - Configuration options for availability checking
+ * @returns Express middleware function
+ *
+ * @example
+ * ```typescript
+ * const availabilityMiddleware = createMcpAvailabilityMiddleware(loadingManager, {
+ *   allowPartialAvailability: true,
+ *   includeOAuthServers: false,
+ * });
+ *
+ * router.post('/mcp', availabilityMiddleware, (req, res) => {
+ *   // Handle MCP request with availability info in req.mcpAvailability
+ * });
+ * ```
+ */
+export declare function createMcpAvailabilityMiddleware(loadingManager?: McpLoadingManager, options?: McpAvailabilityOptions): (req: McpRequest, res: Response, next: NextFunction) => void;
+/**
+ * Utility function to get MCP availability info from request
+ */
+export declare function getMcpAvailability(req: Request): {
+    availableServers: string[];
+    unavailableServers: string[];
+    loadingServers: string[];
+    oauthRequiredServers: string[];
+    hasPartialAvailability: boolean;
+    allServersReady: boolean;
+    requestedTags?: string[];
+    totalServersBeforeFiltering?: number;
+} | undefined;
+/**
+ * Utility function to check if all MCP servers are ready
+ */
+export declare function areAllMcpServersReady(req: Request): boolean;
+/**
+ * Utility function to get list of available MCP servers
+ */
+export declare function getAvailableMcpServers(req: Request): string[];
+/**
+ * Utility function to get list of loading MCP servers
+ */
+export declare function getLoadingMcpServers(req: Request): string[];
+//# sourceMappingURL=mcpAvailabilityMiddleware.d.ts.map

package/build/transport/http/middlewares/mcpAvailabilityMiddleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcpAvailabilityMiddleware.d.ts","sourceRoot":"","sources":["../../../../src/transport/http/middlewares/mcpAvailabilityMiddleware.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAE1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,4CAA4C,CAAC;AAK/E;;GAEG;AACH,MAAM,WAAW,UAAW,SAAQ,OAAO;IACzC,eAAe,CAAC,EAAE;QAChB,gBAAgB,EAAE,MAAM,EAAE,CAAC;QAC3B,kBAAkB,EAAE,MAAM,EAAE,CAAC;QAC7B,cAAc,EAAE,MAAM,EAAE,CAAC;QACzB,oBAAoB,EAAE,MAAM,EAAE,CAAC;QAC/B,sBAAsB,EAAE,OAAO,CAAC;QAChC,eAAe,EAAE,OAAO,CAAC;QACzB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;QACzB,2BAA2B,CAAC,EAAE,MAAM,CAAC;KACtC,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,oEAAoE;IACpE,wBAAwB,CAAC,EAAE,OAAO,CAAC;IACnC,6DAA6D;IAC7D,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,mDAAmD;IACnD,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,+CAA+C;IAC/C,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAYD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,+BAA+B,CAC7C,cAAc,CAAC,EAAE,iBAAiB,EAClC,OAAO,GAAE,sBAA2B,IAI5B,KAAK,UAAU,EAAE,KAAK,QAAQ,EAAE,MAAM,YAAY,UA4M3D;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,OAAO;sBAhRzB,MAAM,EAAE;wBACN,MAAM,EAAE;oBACZ,MAAM,EAAE;0BACF,MAAM,EAAE;4BACN,OAAO;qBACd,OAAO;oBACR,MAAM,EAAE;kCACM,MAAM;cA2QvC;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAG3D;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,EAAE,CAG7D;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,EAAE,CAG3D"}