@1mcp/agent 0.16.0 → 0.18.0

package/build/core/loading/mcpLoadingManager.d.ts

@@ -0,0 +1,156 @@
+import { EventEmitter } from 'events';
+import { OutboundConnections, AuthProviderTransport } from '../types/index.js';
+import { ClientManager } from '../client/clientManager.js';
+import { LoadingStateTracker, LoadingSummary } from './loadingStateTracker.js';
+/**
+ * Configuration options for MCP loading behavior
+ */
+export interface McpLoadingConfig {
+    /** Maximum time to wait for each server (ms) */
+    readonly serverTimeoutMs: number;
+    /** Maximum number of retry attempts per server */
+    readonly maxRetries: number;
+    /** Initial delay between retries (ms) */
+    readonly retryDelayMs: number;
+    /** Maximum number of servers to initialize concurrently */
+    readonly maxConcurrentLoads: number;
+    /** Whether to continue loading other servers if some fail */
+    readonly continueOnFailure: boolean;
+    /** Whether to enable background retry for failed servers */
+    readonly enableBackgroundRetry: boolean;
+    /** Interval for background retry attempts (ms) */
+    readonly backgroundRetryIntervalMs: number;
+}
+/**
+ * Default configuration for MCP loading
+ */
+export declare const DEFAULT_LOADING_CONFIG: McpLoadingConfig;
+/**
+ * Result of loading a specific server
+ */
+interface ServerLoadResult {
+    readonly name: string;
+    readonly success: boolean;
+    readonly error?: Error;
+    readonly duration: number;
+    readonly retryCount: number;
+}
+/**
+ * Events emitted by McpLoadingManager
+ */
+export interface McpLoadingEvents {
+    'loading-started': (serverNames: string[]) => void;
+    'server-loading': (name: string) => void;
+    'server-loaded': (name: string, result: ServerLoadResult) => void;
+    'server-failed': (name: string, result: ServerLoadResult) => void;
+    'oauth-required': (name: string, authUrl?: string) => void;
+    'loading-progress': (summary: LoadingSummary) => void;
+    'loading-complete': (summary: LoadingSummary) => void;
+    'background-retry': (name: string, attempt: number) => void;
+}
+/**
+ * Manages asynchronous loading of MCP servers without blocking HTTP server startup
+ *
+ * This manager coordinates the initialization of multiple MCP servers in parallel,
+ * provides real-time status updates, and handles retries and error recovery.
+ * The HTTP server can start immediately while this manager loads servers in the background.
+ *
+ * @example
+ * ```typescript
+ * const manager = new McpLoadingManager(clientManager, config);
+ * manager.on('loading-complete', (summary) => {
+ *   console.log(`${summary.ready}/${summary.totalServers} servers ready`);
+ * });
+ *
+ * // Start loading asynchronously
+ * const loadingPromise = manager.startAsyncLoading(transports);
+ *
+ * // HTTP server can start immediately
+ * const expressServer = new ExpressServer(serverManager);
+ * expressServer.start();
+ *
+ * // Optionally wait for loading to complete
+ * await loadingPromise;
+ * ```
+ */
+export declare class McpLoadingManager extends EventEmitter {
+    private clientManager;
+    private config;
+    private stateTracker;
+    private loadingSemaphore;
+    private backgroundRetryTimer?;
+    private isShuttingDown;
+    private abortControllers;
+    constructor(clientManager: ClientManager, config?: Partial<McpLoadingConfig>);
+    /**
+     * Start asynchronous loading of MCP servers
+     * Returns immediately, loading happens in background
+     */
+    startAsyncLoading(transports: Record<string, AuthProviderTransport>): Promise<OutboundConnections>;
+    /**
+     * Load servers with concurrency control
+     */
+    private loadServersWithConcurrency;
+    /**
+     * Load a single server with retry logic
+     */
+    private loadSingleServer;
+    /**
+     * Create client with timeout and cancellation support
+     */
+    private createClientWithTimeout;
+    /**
+     * Set up background retry for failed servers
+     */
+    private setupBackgroundRetry;
+    /**
+     * Perform background retry for failed servers
+     */
+    private performBackgroundRetry;
+    /**
+     * Get current loading state tracker
+     */
+    getStateTracker(): LoadingStateTracker;
+    /**
+     * Get current loading summary
+     */
+    getSummary(): LoadingSummary;
+    /**
+     * Check if a specific server is ready
+     */
+    isServerReady(name: string): boolean;
+    /**
+     * Get list of ready servers
+     */
+    getReadyServers(): string[];
+    /**
+     * Get list of failed servers
+     */
+    getFailedServers(): string[];
+    /**
+     * Cancel loading of a specific server
+     */
+    cancelServerLoading(serverName: string): void;
+    /**
+     * Cancel loading of multiple servers
+     */
+    cancelServersLoading(serverNames: string[]): void;
+    /**
+     * Cancel all currently loading servers
+     */
+    cancelAllLoading(): void;
+    /**
+     * Get list of servers that are currently being loaded and can be cancelled
+     */
+    getCancellableServers(): string[];
+    /**
+     * Shutdown the loading manager
+     */
+    shutdown(): void;
+    /**
+     * Utility method for sleeping
+     */
+    private sleep;
+}
+export {};
+//# sourceMappingURL=mcpLoadingManager.d.ts.map

package/build/core/loading/mcpLoadingManager.d.ts.map

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

package/build/core/loading/mcpLoadingManager.js

@@ -0,0 +1,352 @@
+import { EventEmitter } from 'events';
+import { LoadingStateTracker, LoadingState } from './loadingStateTracker.js';
+import logger from '../../logger/logger.js';
+/**
+ * Default configuration for MCP loading
+ */
+export const DEFAULT_LOADING_CONFIG = {
+    serverTimeoutMs: 30000, // 30 seconds per server
+    maxRetries: 3,
+    retryDelayMs: 2000, // 2 seconds initial delay
+    maxConcurrentLoads: 5, // Load 5 servers at once
+    continueOnFailure: true,
+    enableBackgroundRetry: true,
+    backgroundRetryIntervalMs: 60000, // Retry every minute
+};
+/**
+ * Manages asynchronous loading of MCP servers without blocking HTTP server startup
+ *
+ * This manager coordinates the initialization of multiple MCP servers in parallel,
+ * provides real-time status updates, and handles retries and error recovery.
+ * The HTTP server can start immediately while this manager loads servers in the background.
+ *
+ * @example
+ * ```typescript
+ * const manager = new McpLoadingManager(clientManager, config);
+ * manager.on('loading-complete', (summary) => {
+ *   console.log(`${summary.ready}/${summary.totalServers} servers ready`);
+ * });
+ *
+ * // Start loading asynchronously
+ * const loadingPromise = manager.startAsyncLoading(transports);
+ *
+ * // HTTP server can start immediately
+ * const expressServer = new ExpressServer(serverManager);
+ * expressServer.start();
+ *
+ * // Optionally wait for loading to complete
+ * await loadingPromise;
+ * ```
+ */
+export class McpLoadingManager extends EventEmitter {
+    clientManager;
+    config;
+    stateTracker;
+    loadingSemaphore = new Map();
+    backgroundRetryTimer;
+    isShuttingDown = false;
+    abortControllers = new Map();
+    constructor(clientManager, config = {}) {
+        super();
+        this.clientManager = clientManager;
+        this.config = { ...DEFAULT_LOADING_CONFIG, ...config };
+        this.stateTracker = new LoadingStateTracker();
+        // Forward state tracker events
+        this.stateTracker.on('server-state-changed', (name, info) => {
+            if (info.state === LoadingState.Ready) {
+                this.emit('server-loaded', name, {
+                    name,
+                    success: true,
+                    duration: info.duration || 0,
+                    retryCount: info.retryCount,
+                });
+            }
+            else if (info.state === LoadingState.Failed) {
+                this.emit('server-failed', name, {
+                    name,
+                    success: false,
+                    error: info.error,
+                    duration: info.duration || 0,
+                    retryCount: info.retryCount,
+                });
+            }
+            else if (info.state === LoadingState.AwaitingOAuth) {
+                this.emit('oauth-required', name, info.authorizationUrl);
+            }
+        });
+        this.stateTracker.on('loading-progress', (summary) => {
+            this.emit('loading-progress', summary);
+        });
+        this.stateTracker.on('loading-complete', (summary) => {
+            this.emit('loading-complete', summary);
+            this.setupBackgroundRetry();
+        });
+        this.setMaxListeners(100); // Allow many listeners
+    }
+    /**
+     * Start asynchronous loading of MCP servers
+     * Returns immediately, loading happens in background
+     */
+    async startAsyncLoading(transports) {
+        const serverNames = Object.keys(transports);
+        if (serverNames.length === 0) {
+            logger.info('No MCP servers to load');
+            return new Map();
+        }
+        logger.info(`Starting async loading of ${serverNames.length} MCP servers`);
+        this.stateTracker.startLoading(serverNames);
+        this.emit('loading-started', serverNames);
+        // Start loading servers with concurrency control
+        this.loadServersWithConcurrency(transports);
+        // Return current connections (may be empty initially)
+        return this.clientManager.getClients();
+    }
+    /**
+     * Load servers with concurrency control
+     */
+    async loadServersWithConcurrency(transports) {
+        const serverEntries = Object.entries(transports);
+        const semaphore = new Map();
+        // Process servers in batches based on maxConcurrentLoads
+        for (let i = 0; i < serverEntries.length; i += this.config.maxConcurrentLoads) {
+            const batch = serverEntries.slice(i, i + this.config.maxConcurrentLoads);
+            // Start all servers in this batch
+            const batchPromises = batch.map(([name, transport]) => {
+                const loadPromise = this.loadSingleServer(name, transport);
+                semaphore.set(name, loadPromise);
+                return loadPromise;
+            });
+            // Wait for this batch to complete before starting next batch
+            await Promise.allSettled(batchPromises);
+            // Clean up completed promises
+            for (const [name] of batch) {
+                semaphore.delete(name);
+            }
+            if (this.isShuttingDown) {
+                logger.info('Loading cancelled due to shutdown');
+                break;
+            }
+        }
+        logger.info('Initial server loading phase completed');
+    }
+    /**
+     * Load a single server with retry logic
+     */
+    async loadSingleServer(name, transport) {
+        if (this.isShuttingDown)
+            return;
+        this.emit('server-loading', name);
+        this.stateTracker.updateServerState(name, LoadingState.Loading, {
+            progress: { phase: 'initializing', message: 'Starting server connection' },
+        });
+        let lastError;
+        let retryCount = 0;
+        while (retryCount <= this.config.maxRetries && !this.isShuttingDown) {
+            try {
+                this.stateTracker.updateServerState(name, LoadingState.Loading, {
+                    progress: {
+                        phase: retryCount > 0 ? 'retrying' : 'connecting',
+                        message: retryCount > 0 ? `Retry attempt ${retryCount}` : 'Connecting to server',
+                    },
+                });
+                // Attempt to create and connect client
+                await this.createClientWithTimeout(name, transport);
+                // Success!
+                this.stateTracker.updateServerState(name, LoadingState.Ready);
+                logger.info(`Successfully loaded MCP server: ${name} (${retryCount} retries)`);
+                return;
+            }
+            catch (error) {
+                lastError = error instanceof Error ? error : new Error(String(error));
+                retryCount++;
+                this.stateTracker.incrementRetryCount(name);
+                // Handle OAuth case specially
+                if (lastError.name === 'OAuthRequiredError') {
+                    logger.info(`OAuth required for ${name}`);
+                    this.stateTracker.updateServerState(name, LoadingState.AwaitingOAuth, {
+                        error: lastError,
+                    });
+                    return; // Don't retry OAuth errors
+                }
+                // Handle other errors
+                logger.warn(`Failed to load ${name} (attempt ${retryCount}): ${lastError.message}`);
+                if (retryCount <= this.config.maxRetries && !this.isShuttingDown) {
+                    const delay = this.config.retryDelayMs * Math.pow(2, retryCount - 1); // Exponential backoff
+                    logger.info(`Retrying ${name} in ${delay}ms...`);
+                    await this.sleep(delay);
+                }
+            }
+        }
+        // All retries exhausted
+        this.stateTracker.updateServerState(name, LoadingState.Failed, {
+            error: lastError || new Error('Unknown error'),
+        });
+        if (this.config.continueOnFailure) {
+            logger.error(`Failed to load ${name} after ${this.config.maxRetries} retries, continuing with other servers`);
+        }
+        else {
+            logger.error(`Failed to load ${name}, stopping loading process`);
+            throw lastError;
+        }
+    }
+    /**
+     * Create client with timeout and cancellation support
+     */
+    async createClientWithTimeout(name, transport) {
+        // Create abort controller for this specific server loading operation
+        const abortController = new AbortController();
+        this.abortControllers.set(name, abortController);
+        try {
+            const timeoutPromise = new Promise((_, reject) => {
+                const timeoutId = setTimeout(() => {
+                    abortController.abort();
+                    reject(new Error(`Timeout loading ${name} after ${this.config.serverTimeoutMs}ms`));
+                }, this.config.serverTimeoutMs);
+                // Clear timeout if operation is aborted
+                abortController.signal.addEventListener('abort', () => {
+                    clearTimeout(timeoutId);
+                    reject(new Error(`Loading ${name} was cancelled`));
+                });
+            });
+            const loadPromise = this.clientManager.createSingleClient(name, transport, abortController.signal);
+            await Promise.race([loadPromise, timeoutPromise]);
+        }
+        finally {
+            // Clean up abort controller
+            this.abortControllers.delete(name);
+        }
+    }
+    /**
+     * Set up background retry for failed servers
+     */
+    setupBackgroundRetry() {
+        if (!this.config.enableBackgroundRetry || this.isShuttingDown) {
+            return;
+        }
+        this.backgroundRetryTimer = setInterval(() => {
+            this.performBackgroundRetry();
+        }, this.config.backgroundRetryIntervalMs);
+        logger.info('Background retry enabled for failed servers');
+    }
+    /**
+     * Perform background retry for failed servers
+     */
+    async performBackgroundRetry() {
+        if (this.isShuttingDown)
+            return;
+        const failedServers = this.stateTracker.getServersByState(LoadingState.Failed);
+        if (failedServers.length === 0) {
+            return;
+        }
+        logger.info(`Background retry for ${failedServers.length} failed servers`);
+        // Retry a subset of failed servers to avoid overwhelming the system
+        const serversToRetry = failedServers.slice(0, 3); // Retry max 3 at a time
+        for (const serverInfo of serversToRetry) {
+            if (this.isShuttingDown)
+                break;
+            const transport = this.clientManager.getTransport(serverInfo.name);
+            if (transport) {
+                this.emit('background-retry', serverInfo.name, serverInfo.retryCount + 1);
+                // Don't wait for completion, let it run in background
+                this.loadSingleServer(serverInfo.name, transport).catch((error) => {
+                    logger.debug(`Background retry failed for ${serverInfo.name}: ${error.message}`);
+                });
+            }
+        }
+    }
+    /**
+     * Get current loading state tracker
+     */
+    getStateTracker() {
+        return this.stateTracker;
+    }
+    /**
+     * Get current loading summary
+     */
+    getSummary() {
+        return this.stateTracker.getSummary();
+    }
+    /**
+     * Check if a specific server is ready
+     */
+    isServerReady(name) {
+        const state = this.stateTracker.getServerState(name);
+        return state?.state === LoadingState.Ready;
+    }
+    /**
+     * Get list of ready servers
+     */
+    getReadyServers() {
+        return this.stateTracker.getServersByState(LoadingState.Ready).map((s) => s.name);
+    }
+    /**
+     * Get list of failed servers
+     */
+    getFailedServers() {
+        return this.stateTracker.getServersByState(LoadingState.Failed).map((s) => s.name);
+    }
+    /**
+     * Cancel loading of a specific server
+     */
+    cancelServerLoading(serverName) {
+        const abortController = this.abortControllers.get(serverName);
+        if (abortController) {
+            logger.info(`Cancelling loading of server: ${serverName}`);
+            abortController.abort();
+            this.stateTracker.updateServerState(serverName, LoadingState.Cancelled);
+        }
+        else {
+            logger.warn(`No active loading operation found for server: ${serverName}`);
+        }
+    }
+    /**
+     * Cancel loading of multiple servers
+     */
+    cancelServersLoading(serverNames) {
+        for (const serverName of serverNames) {
+            this.cancelServerLoading(serverName);
+        }
+    }
+    /**
+     * Cancel all currently loading servers
+     */
+    cancelAllLoading() {
+        const loadingServers = Array.from(this.abortControllers.keys());
+        if (loadingServers.length > 0) {
+            logger.info(`Cancelling loading of ${loadingServers.length} servers`);
+            this.cancelServersLoading(loadingServers);
+        }
+    }
+    /**
+     * Get list of servers that are currently being loaded and can be cancelled
+     */
+    getCancellableServers() {
+        return Array.from(this.abortControllers.keys());
+    }
+    /**
+     * Shutdown the loading manager
+     */
+    shutdown() {
+        this.isShuttingDown = true;
+        if (this.backgroundRetryTimer) {
+            clearInterval(this.backgroundRetryTimer);
+            this.backgroundRetryTimer = undefined;
+        }
+        // Cancel any active loading operations
+        this.cancelAllLoading();
+        // Update state for any remaining pending/loading servers
+        const pendingServers = this.stateTracker.getServersByState(LoadingState.Pending);
+        const loadingServers = this.stateTracker.getServersByState(LoadingState.Loading);
+        for (const server of [...pendingServers, ...loadingServers]) {
+            this.stateTracker.updateServerState(server.name, LoadingState.Cancelled);
+        }
+        logger.info('MCP loading manager shutdown complete');
+    }
+    /**
+     * Utility method for sleeping
+     */
+    sleep(ms) {
+        return new Promise((resolve) => setTimeout(resolve, ms));
+    }
+}
+//# sourceMappingURL=mcpLoadingManager.js.map

package/build/core/loading/mcpLoadingManager.js.map

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

package/build/core/notifications/notificationManager.d.ts

@@ -0,0 +1,111 @@
+import { EventEmitter } from 'events';
+import { InboundConnection } from '../types/index.js';
+import { CapabilityChanges } from '../capabilities/capabilityAggregator.js';
+/**
+ * Configuration for notification batching and behavior
+ */
+export interface NotificationConfig {
+    /** Whether to enable notification batching */
+    readonly batchNotifications: boolean;
+    /** Delay in milliseconds before sending batched notifications */
+    readonly batchDelayMs: number;
+    /** Whether to notify on server readiness changes */
+    readonly notifyOnServerReady: boolean;
+}
+/**
+ * Default notification configuration
+ */
+export declare const DEFAULT_NOTIFICATION_CONFIG: NotificationConfig;
+/**
+ * Events emitted by NotificationManager
+ */
+export interface NotificationManagerEvents {
+    'notification-sent': (type: 'tools' | 'resources' | 'prompts', clientCount: number) => void;
+    'notification-failed': (type: 'tools' | 'resources' | 'prompts', error: Error) => void;
+    'batch-sent': (notifications: string[], clientCount: number) => void;
+}
+/**
+ * Manages sending listChanged notifications to connected clients when MCP server
+ * capabilities change during async loading.
+ *
+ * Features:
+ * - Batches multiple notification types together to reduce client spam
+ * - Handles client connection failures gracefully
+ * - Provides configurable batching delays and behavior
+ * - Tracks notification success/failure metrics
+ *
+ * @example
+ * ```typescript
+ * const manager = new NotificationManager(inboundConnection, config);
+ * manager.handleCapabilityChanges(changes);
+ * ```
+ */
+export declare class NotificationManager extends EventEmitter {
+    private inboundConn;
+    private config;
+    private pendingNotifications;
+    private batchTimer;
+    private isShuttingDown;
+    constructor(inboundConnection: InboundConnection, config?: Partial<NotificationConfig>);
+    /**
+     * Handle capability changes and send appropriate notifications
+     */
+    handleCapabilityChanges(changes: CapabilityChanges): void;
+    /**
+     * Schedule notifications to be sent in a batch after a delay
+     */
+    private scheduleBatchedNotification;
+    /**
+     * Send all pending notifications as a batch
+     */
+    private sendBatchedNotifications;
+    /**
+     * Send notifications immediately without batching
+     */
+    private sendImmediateNotifications;
+    /**
+     * Send ToolListChangedNotification to client
+     */
+    private sendToolListChangedNotification;
+    /**
+     * Send ResourceListChangedNotification to client
+     */
+    private sendResourceListChangedNotification;
+    /**
+     * Send PromptListChangedNotification to client
+     */
+    private sendPromptListChangedNotification;
+    /**
+     * Send a notification to the connected client
+     */
+    private sendNotification;
+    /**
+     * Get count of connected clients (always 1 for this proxy architecture)
+     */
+    private getClientCount;
+    /**
+     * Force send any pending notifications immediately
+     */
+    flushPendingNotifications(): void;
+    /**
+     * Update configuration at runtime
+     */
+    updateConfig(newConfig: Partial<NotificationConfig>): void;
+    /**
+     * Get current configuration
+     */
+    getConfig(): NotificationConfig;
+    /**
+     * Check if notifications are enabled
+     */
+    isEnabled(): boolean;
+    /**
+     * Get summary of notification manager state
+     */
+    getStatusSummary(): string;
+    /**
+     * Shutdown the notification manager
+     */
+    shutdown(): void;
+}
+//# sourceMappingURL=notificationManager.d.ts.map

package/build/core/notifications/notificationManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notificationManager.d.ts","sourceRoot":"","sources":["../../../src/core/notifications/notificationManager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAMtC,OAAO,EAAE,iBAAiB,EAAgB,MAAM,mBAAmB,CAAC;AACpE,OAAO,EAAE,iBAAiB,EAAE,MAAM,yCAAyC,CAAC;AAG5E;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,8CAA8C;IAC9C,QAAQ,CAAC,kBAAkB,EAAE,OAAO,CAAC;IACrC,iEAAiE;IACjE,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,oDAAoD;IACpD,QAAQ,CAAC,mBAAmB,EAAE,OAAO,CAAC;CACvC;AAED;;GAEG;AACH,eAAO,MAAM,2BAA2B,EAAE,kBAIzC,CAAC;AAYF;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,mBAAmB,EAAE,CAAC,IAAI,EAAE,OAAO,GAAG,WAAW,GAAG,SAAS,EAAE,WAAW,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5F,qBAAqB,EAAE,CAAC,IAAI,EAAE,OAAO,GAAG,WAAW,GAAG,SAAS,EAAE,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACvF,YAAY,EAAE,CAAC,aAAa,EAAE,MAAM,EAAE,EAAE,WAAW,EAAE,MAAM,KAAK,IAAI,CAAC;CACtE;AAED;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,mBAAoB,SAAQ,YAAY;IACnD,OAAO,CAAC,WAAW,CAAoB;IACvC,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,oBAAoB,CAAqC;IACjE,OAAO,CAAC,UAAU,CAA8C;IAChE,OAAO,CAAC,cAAc,CAAkB;gBAE5B,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,GAAE,OAAO,CAAC,kBAAkB,CAAM;IAO1F;;OAEG;IACI,uBAAuB,CAAC,OAAO,EAAE,iBAAiB,GAAG,IAAI;IAqBhE;;OAEG;IACH,OAAO,CAAC,2BAA2B;IA4BnC;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAgChC;;OAEG;IACH,OAAO,CAAC,0BAA0B;IAclC;;OAEG;IACH,OAAO,CAAC,+BAA+B;IAOvC;;OAEG;IACH,OAAO,CAAC,mCAAmC;IAO3C;;OAEG;IACH,OAAO,CAAC,iCAAiC;IAOzC;;OAEG;IACH,OAAO,CAAC,gBAAgB;IA4BxB;;OAEG;IACH,OAAO,CAAC,cAAc;IAItB;;OAEG;IACI,yBAAyB,IAAI,IAAI;IAOxC;;OAEG;IACI,YAAY,CAAC,SAAS,EAAE,OAAO,CAAC,kBAAkB,CAAC,GAAG,IAAI;IAKjE;;OAEG;IACI,SAAS,IAAI,kBAAkB;IAItC;;OAEG;IACI,SAAS,IAAI,OAAO;IAI3B;;OAEG;IACI,gBAAgB,IAAI,MAAM;IAOjC;;OAEG;IACI,QAAQ,IAAI,IAAI;CAQxB"}