@1mcp/agent 0.29.2 → 0.30.0-beta1

package/build/core/capabilities/lazyLoadingOrchestrator.js

@@ -0,0 +1,515 @@
+import { EventEmitter } from 'events';
+import { MCP_URI_SEPARATOR } from '../../constants.js';
+import { ConnectionResolver } from '../../core/server/connectionResolver.js';
+import { ClientStatus } from '../../core/types/index.js';
+import logger, { debugIf, errorIf } from '../../logger/logger.js';
+import { CapabilityAggregator } from './capabilityAggregator.js';
+import { MetaToolProvider } from './metaToolProvider.js';
+import { SchemaCache } from './schemaCache.js';
+import { ToolRegistry } from './toolRegistry.js';
+/**
+ * LazyLoadingOrchestrator coordinates lazy loading of tool schemas.
+ *
+ * Uses composition pattern to combine:
+ * - ToolRegistry for lightweight tool metadata
+ * - SchemaCache for on-demand schema loading
+ * - MetaToolProvider for meta-tool exposure
+ * - CapabilityAggregator for full capabilities
+ *
+ * @example
+ * ```typescript
+ * const orchestrator = new LazyLoadingOrchestrator(
+ *   outboundConnections,
+ *   agentConfig
+ * );
+ * await orchestrator.initialize();
+ * const capabilities = await orchestrator.getCapabilities();
+ * ```
+ */
+export class LazyLoadingOrchestrator extends EventEmitter {
+    outboundConnections;
+    config;
+    toolRegistry;
+    schemaCache;
+    metaToolProvider;
+    capabilityAggregator;
+    isInitialized = false;
+    asyncOrchestrator;
+    // Session-specific filters for allowed servers (keyed by sessionId)
+    sessionAllowedServers = new Map();
+    connectionResolver;
+    constructor(outboundConnections, config, asyncOrchestrator, templateHashProvider) {
+        super();
+        this.outboundConnections = outboundConnections;
+        this.config = config;
+        this.asyncOrchestrator = asyncOrchestrator;
+        this.connectionResolver = new ConnectionResolver(outboundConnections, templateHashProvider);
+        // Get lazy loading config
+        const lazyConfig = config.get('lazyLoading');
+        // Initialize schema cache
+        const cacheConfig = {
+            maxEntries: lazyConfig.cache.maxEntries,
+            ttlMs: lazyConfig.cache.ttlMs,
+        };
+        this.schemaCache = new SchemaCache(cacheConfig);
+        // Initialize tool registry (empty initially)
+        this.toolRegistry = ToolRegistry.empty();
+        // Initialize capability aggregator (for resources/prompts and full mode)
+        this.capabilityAggregator = new CapabilityAggregator(outboundConnections);
+        // Initialize meta-tool provider if lazy loading is enabled
+        if (lazyConfig.enabled) {
+            this.metaToolProvider = new MetaToolProvider(() => this.toolRegistry, this.schemaCache, outboundConnections, this.loadSchemaFromServer.bind(this), undefined, // allowedServers - set later per session
+            templateHashProvider);
+        }
+        // Listen to server-capabilities-updated events from async orchestrator
+        if (asyncOrchestrator) {
+            asyncOrchestrator.on('server-capabilities-updated', async (serverName) => {
+                try {
+                    debugIf(() => ({ message: `Server ${serverName} capabilities updated, refreshing tool registry` }));
+                    await this.refreshCapabilities();
+                }
+                catch (error) {
+                    const errorMessage = error instanceof Error ? error.message : String(error);
+                    errorIf(() => ({
+                        message: 'Failed to refresh capabilities after server update',
+                        meta: { serverName, error: errorMessage },
+                    }));
+                }
+            });
+        }
+        this.setMaxListeners(50);
+    }
+    /**
+     * Initialize the orchestrator
+     */
+    async initialize() {
+        if (this.isInitialized) {
+            debugIf('LazyLoadingOrchestrator already initialized');
+            return;
+        }
+        const lazyConfig = this.config.get('lazyLoading');
+        // Update capabilities first
+        await this.capabilityAggregator.updateCapabilities();
+        if (lazyConfig.enabled) {
+            // Build tool registry from aggregated capabilities
+            await this.buildToolRegistry();
+            // Preload tools based on configuration
+            if (lazyConfig.preload.patterns.length > 0 || lazyConfig.preload.keywords.length > 0) {
+                await this.preloadTools();
+            }
+            logger.info(`LazyLoadingOrchestrator initialized with ${this.toolRegistry.size()} tools`);
+        }
+        else {
+            logger.info('LazyLoadingOrchestrator initialized in full mode (disabled)');
+        }
+        this.isInitialized = true;
+    }
+    /**
+     * Build tool registry from aggregated capabilities
+     */
+    async buildToolRegistry() {
+        // Build tools map for registry by fetching tools directly from each connection
+        const toolsMap = new Map();
+        const serverTags = new Map();
+        const failedServers = [];
+        for (const [serverName, connection] of this.outboundConnections.entries()) {
+            if (!connection.client || connection.status !== ClientStatus.Connected) {
+                continue;
+            }
+            try {
+                // Get tools directly from this server's client
+                const toolsResult = await connection.client.listTools();
+                const serverTools = toolsResult.tools || [];
+                if (serverTools.length > 0) {
+                    // CRITICAL: Use connection.name instead of map key for server identification
+                    // Map keys for template servers include hash suffix (e.g., "template-server:abc123")
+                    // but connection.name is the clean name (e.g., "template-server")
+                    // This ensures tool registry uses consistent server names
+                    const effectiveServerName = connection.name || serverName;
+                    toolsMap.set(effectiveServerName, serverTools);
+                    // Get tags from transport
+                    const tags = connection.transport.tags || [];
+                    serverTags.set(effectiveServerName, tags);
+                }
+            }
+            catch (error) {
+                const errorMessage = error instanceof Error ? error.message : String(error);
+                errorIf(() => ({
+                    message: 'Failed to list tools from server during registry build',
+                    meta: { serverName, error: errorMessage },
+                }));
+                failedServers.push({ server: serverName, error: errorMessage });
+            }
+        }
+        // Warn if significant failures
+        if (failedServers.length > 0) {
+            const failureRate = failedServers.length / this.outboundConnections.size;
+            if (failureRate > 0.5) {
+                errorIf(() => ({
+                    message: `Tool registry built with ${failedServers.length}/${this.outboundConnections.size} server failures`,
+                    meta: { failedServers },
+                }));
+            }
+        }
+        this.toolRegistry = ToolRegistry.fromToolsMap(toolsMap, serverTags);
+    }
+    /**
+     * Preload tools based on configuration patterns
+     */
+    async preloadTools() {
+        const lazyConfig = this.config.get('lazyLoading');
+        const preload = lazyConfig.preload;
+        if (preload.patterns.length === 0 && preload.keywords.length === 0) {
+            return;
+        }
+        // Find tools to preload
+        const toolsToPreload = [];
+        const allTools = this.toolRegistry.listTools({}).tools;
+        for (const tool of allTools) {
+            // Check server pattern match
+            const serverMatch = preload.patterns.some((pattern) => {
+                try {
+                    // Escape special regex chars and convert glob patterns: * -> .*, ? -> .
+                    const escaped = pattern
+                        .replace(/[.+^${}()|[\]\\]/g, '\\$&')
+                        .replace(/\*/g, '.*')
+                        .replace(/\?/g, '.');
+                    const regex = new RegExp(`^${escaped}$`);
+                    return regex.test(tool.server);
+                }
+                catch (error) {
+                    errorIf(() => ({
+                        message: 'Invalid pattern in preload configuration',
+                        meta: { pattern, error },
+                    }));
+                    return false;
+                }
+            });
+            // Check keyword match
+            const keywordMatch = preload.keywords.some((keyword) => tool.name.toLowerCase().includes(keyword.toLowerCase()));
+            if (serverMatch || keywordMatch) {
+                toolsToPreload.push({
+                    server: tool.server,
+                    toolName: tool.name,
+                });
+            }
+        }
+        if (toolsToPreload.length === 0) {
+            debugIf('No tools matched preload patterns');
+            return;
+        }
+        debugIf(() => ({ message: `Preloading ${toolsToPreload.length} tools` }));
+        // Preload schemas
+        await this.schemaCache.preload(toolsToPreload, async (server, toolName) => {
+            return this.loadSchemaFromServer(server, toolName);
+        });
+        logger.info(`Preloaded ${toolsToPreload.length} tool schemas`);
+    }
+    /**
+     * Load tool schema from upstream server
+     */
+    async loadSchemaFromServer(server, toolName) {
+        // Use ConnectionResolver to find the connection (handles template servers with hash-suffixed keys)
+        const result = this.connectionResolver.findByServerName(server);
+        if (!result || !result.connection.client) {
+            throw new Error(`Server not connected: ${server}`);
+        }
+        // Get the tool from server's listTools
+        const toolsResult = await result.connection.client.listTools();
+        const tool = toolsResult.tools.find((t) => t.name === toolName);
+        if (!tool) {
+            throw new Error(`Tool not found: ${server}:${toolName}`);
+        }
+        return tool;
+    }
+    /**
+     * Preload a specific list of tools (for internal management tool)
+     */
+    async preloadToolsList(tools) {
+        if (tools.length === 0) {
+            debugIf('No tools to preload');
+            return;
+        }
+        debugIf(() => ({ message: `Preloading ${tools.length} specific tools` }));
+        // Preload schemas
+        await this.schemaCache.preload(tools, async (server, toolName) => {
+            return this.loadSchemaFromServer(server, toolName);
+        });
+        logger.info(`Preloaded ${tools.length} tool schemas`);
+    }
+    /**
+     * Get aggregated capabilities based on lazy loading configuration
+     */
+    async getCapabilities() {
+        const lazyConfig = this.config.get('lazyLoading');
+        const baseCapabilities = this.capabilityAggregator.getCurrentCapabilities();
+        if (!lazyConfig.enabled) {
+            // Disabled: return all capabilities normally
+            return baseCapabilities;
+        }
+        // Meta-tool mode: only 3 meta-tools + all resources/prompts
+        const metaTools = this.metaToolProvider?.getMetaTools() || [];
+        return {
+            tools: metaTools,
+            resources: baseCapabilities.resources,
+            prompts: baseCapabilities.prompts,
+            readyServers: baseCapabilities.readyServers,
+            timestamp: new Date(),
+        };
+    }
+    /**
+     * Get aggregated capabilities for a filtered set of servers
+     *
+     * This method stores session-specific server filters that will be used by:
+     * - callMetaTool() to filter tool listings via MetaToolProvider
+     *
+     * The filter persists for the session and can be cleared by calling clearSessionFilter().
+     *
+     * @param filteredServerNames - Set of server names to include in capabilities
+     * @param sessionId - Optional session ID to associate the filter with
+     * @returns Aggregated capabilities filtered to only include specified servers
+     */
+    async getCapabilitiesForFilteredServers(filteredServerNames, sessionId) {
+        // Store the session-specific filter
+        this.sessionAllowedServers.set(sessionId, filteredServerNames);
+        // Get the base capabilities
+        const lazyConfig = this.config.get('lazyLoading');
+        const baseCapabilities = this.capabilityAggregator.getCurrentCapabilities();
+        if (!lazyConfig.enabled) {
+            // Disabled: return all capabilities normally (filtering not applied)
+            return baseCapabilities;
+        }
+        // Meta-tools are always included (they're gateway tools)
+        // The filter will be applied when tools are listed via meta-tools
+        const metaTools = this.metaToolProvider?.getMetaTools() || [];
+        // Filter resources to only include those from filtered servers
+        const filteredResources = baseCapabilities.resources.filter((resource) => {
+            const resourceName = resource.name;
+            // Resources are namespaced with server prefix (e.g., "server_1mcp_resource")
+            // Extract server name from resource URI
+            const parts = resourceName.split(MCP_URI_SEPARATOR);
+            const serverName = parts[0];
+            return filteredServerNames.has(serverName);
+        });
+        // Filter prompts to only include those from filtered servers
+        const filteredPrompts = baseCapabilities.prompts.filter((prompt) => {
+            const promptName = prompt.name;
+            // Prompts are namespaced with server prefix (e.g., "server_1mcp_prompt")
+            const parts = promptName.split(MCP_URI_SEPARATOR);
+            const serverName = parts[0];
+            return filteredServerNames.has(serverName);
+        });
+        // Filter ready servers
+        const filteredReadyServers = baseCapabilities.readyServers.filter((serverName) => filteredServerNames.has(serverName));
+        return {
+            tools: metaTools,
+            resources: filteredResources,
+            prompts: filteredPrompts,
+            readyServers: filteredReadyServers,
+            timestamp: new Date(),
+        };
+    }
+    /**
+     * Clear the session-specific filter
+     * @param sessionId - Optional session ID whose filter should be cleared
+     */
+    clearSessionFilter(sessionId) {
+        this.sessionAllowedServers.delete(sessionId);
+    }
+    /**
+     * Get the allowed servers for a specific session
+     * @param sessionId - Optional session ID
+     * @returns Set of allowed server names, or undefined if no filter is set
+     */
+    getSessionAllowedServers(sessionId) {
+        return this.sessionAllowedServers.get(sessionId);
+    }
+    /**
+     * Handle listChanged notifications based on lazy loading state
+     */
+    shouldNotifyListChanged() {
+        const lazyConfig = this.config.get('lazyLoading');
+        if (lazyConfig.enabled) {
+            // No listChanged in meta-tool mode (static tool list)
+            return false;
+        }
+        // Standard MCP behavior when disabled
+        return true;
+    }
+    /**
+     * Refresh capabilities from all servers
+     */
+    async refreshCapabilities() {
+        await this.capabilityAggregator.updateCapabilities();
+        if (this.config.get('lazyLoading').enabled) {
+            await this.buildToolRegistry();
+        }
+        return this.getCapabilities();
+    }
+    /**
+     * Get lazy loading statistics
+     */
+    getStatistics() {
+        const lazyConfig = this.config.get('lazyLoading');
+        const cacheStats = this.schemaCache.getStats();
+        const registeredCount = this.toolRegistry.size();
+        // Calculate token savings
+        const currentTokens = this.calculateCurrentTokens();
+        const fullLoadTokens = this.calculateFullLoadTokens();
+        const savedTokens = fullLoadTokens - currentTokens;
+        const savingsPercentage = fullLoadTokens > 0 ? (savedTokens / fullLoadTokens) * 100 : 0;
+        return {
+            enabled: lazyConfig.enabled,
+            registeredToolCount: registeredCount,
+            loadedToolCount: this.schemaCache.size(),
+            cachedToolCount: this.schemaCache.size(),
+            cacheHitRate: cacheStats.hitRate,
+            tokenSavings: {
+                currentTokens,
+                fullLoadTokens,
+                savedTokens,
+                savingsPercentage,
+            },
+        };
+    }
+    /**
+     * Calculate current token usage
+     */
+    calculateCurrentTokens() {
+        const lazyConfig = this.config.get('lazyLoading');
+        if (!lazyConfig.enabled) {
+            return this.calculateFullLoadTokens();
+        }
+        // Meta-tools: ~300 tokens
+        const metaToolTokens = 300;
+        // Tools in registry: names + descriptions only (~10 tokens per tool)
+        const registryTokens = this.toolRegistry.size() * 10;
+        // Resources and prompts: loaded fully
+        const capabilities = this.capabilityAggregator.getCurrentCapabilities();
+        const resourcesTokens = capabilities.resources.length * 50; // ~50 tokens per resource
+        const promptsTokens = capabilities.prompts.length * 50; // ~50 tokens per prompt
+        return metaToolTokens + registryTokens + resourcesTokens + promptsTokens;
+    }
+    /**
+     * Calculate full load token usage
+     */
+    calculateFullLoadTokens() {
+        const capabilities = this.capabilityAggregator.getCurrentCapabilities();
+        // Tools with schemas: ~300 tokens per tool (complex schemas)
+        const toolTokens = capabilities.tools.length * 300;
+        // Resources: ~50 tokens per resource
+        const resourcesTokens = capabilities.resources.length * 50;
+        // Prompts: ~50 tokens per prompt
+        const promptsTokens = capabilities.prompts.length * 50;
+        return toolTokens + resourcesTokens + promptsTokens;
+    }
+    /**
+     * Call a meta-tool if in meta-tool mode
+     * @param name - Meta-tool name
+     * @param args - Meta-tool arguments
+     * @param sessionId - Optional session ID to retrieve filter for
+     */
+    async callMetaTool(name, args, sessionId) {
+        if (!this.metaToolProvider) {
+            throw new Error('Meta-tool provider not initialized');
+        }
+        // Get the session-specific filter and apply it to the meta-tool provider
+        const allowedServers = this.sessionAllowedServers.get(sessionId);
+        if (allowedServers) {
+            this.metaToolProvider.setAllowedServers(allowedServers);
+        }
+        else {
+            this.metaToolProvider.setAllowedServers(undefined);
+        }
+        return this.metaToolProvider.callMetaTool(name, args);
+    }
+    /**
+     * Check if a tool call is a meta-tool
+     */
+    isMetaTool(name) {
+        return name === 'tool_list' || name === 'tool_schema' || name === 'tool_invoke';
+    }
+    /**
+     * Get the tool registry
+     */
+    getToolRegistry() {
+        return this.toolRegistry;
+    }
+    /**
+     * Get the schema cache
+     */
+    getSchemaCache() {
+        return this.schemaCache;
+    }
+    /**
+     * Check if lazy loading is enabled
+     */
+    isEnabled() {
+        return this.config.get('lazyLoading').enabled;
+    }
+    /**
+     * Health check for lazy loading subsystem
+     * @returns Health status with details
+     */
+    getHealthStatus() {
+        const lazyConfig = this.config.get('lazyLoading');
+        const cacheStats = this.schemaCache.getStats();
+        const cacheSize = this.schemaCache.size();
+        const issues = [];
+        // Check cache utilization (guard against division by zero)
+        const maxEntries = lazyConfig.cache.maxEntries;
+        const utilizationRate = maxEntries > 0 ? (cacheSize / maxEntries) * 100 : 0;
+        if (utilizationRate > 90) {
+            issues.push(`Cache utilization high: ${utilizationRate.toFixed(1)}%`);
+        }
+        // Check hit rate
+        const totalRequests = cacheStats.hits + cacheStats.misses;
+        const hitRate = totalRequests > 0 ? cacheStats.hitRate : 0;
+        // Only warn about low hit rate if we've had enough requests
+        if (totalRequests > 100 && hitRate < 50) {
+            issues.push(`Low cache hit rate: ${hitRate.toFixed(1)}%`);
+        }
+        // Check eviction rate
+        if (cacheStats.evictions > 100) {
+            issues.push(`High eviction count: ${cacheStats.evictions}`);
+        }
+        return {
+            healthy: issues.length === 0,
+            enabled: lazyConfig.enabled,
+            cache: {
+                size: cacheSize,
+                maxEntries: lazyConfig.cache.maxEntries,
+                utilizationRate,
+            },
+            stats: {
+                hitRate,
+                coalescedRequests: cacheStats.coalesced,
+                evictions: cacheStats.evictions,
+            },
+            issues,
+        };
+    }
+    /**
+     * Log periodic lazy loading statistics (for monitoring and observability)
+     * @param forceLog - Force logging even if debug mode is off
+     */
+    logStatistics(forceLog = false) {
+        const stats = this.getStatistics();
+        const health = this.getHealthStatus();
+        const message = `LazyLoading stats: ` +
+            `enabled=${stats.enabled}, ` +
+            `tools=${stats.registeredToolCount}, cached=${stats.cachedToolCount}, ` +
+            `tokenSavings=${stats.tokenSavings.savingsPercentage.toFixed(1)}%, ` +
+            `cacheHitRate=${stats.cacheHitRate.toFixed(1)}%, ` +
+            `coalesced=${health.stats.coalescedRequests}, ` +
+            `health=${health.healthy ? 'OK' : 'WARN'}` +
+            (health.issues.length > 0 ? ` [${health.issues.join(', ')}]` : '');
+        if (forceLog) {
+            logger.info(message);
+        }
+        else {
+            debugIf(message);
+        }
+    }
+}
+//# sourceMappingURL=lazyLoadingOrchestrator.js.map

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

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

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

@@ -0,0 +1,118 @@
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+import { TemplateHashProvider } from '../../core/server/connectionResolver.js';
+import { OutboundConnections } from '../../core/types/index.js';
+import { SchemaCache } from './schemaCache.js';
+import { ToolInvokeOutput, ToolListOutput, ToolSchemaOutput } from './schemas/metaToolSchemas.js';
+import { ToolRegistry } from './toolRegistry.js';
+/**
+ * Result types for meta-tools
+ */
+export type ListToolsResult = ToolListOutput;
+export type DescribeToolResult = ToolSchemaOutput;
+export type CallToolResult = ToolInvokeOutput;
+/**
+ * Function to load tool schema from upstream server
+ */
+export type SchemaLoader = (server: string, toolName: string) => Promise<Tool>;
+/**
+ * Arguments for tool_list
+ */
+export interface ListAvailableToolsArgs {
+    server?: string;
+    pattern?: string;
+    tag?: string;
+    limit?: number;
+    cursor?: string;
+}
+/**
+ * Arguments for tool_schema
+ */
+export interface DescribeToolArgs {
+    server: string;
+    toolName: string;
+}
+/**
+ * Arguments for tool_invoke
+ */
+export interface CallToolArgs {
+    server: string;
+    toolName: string;
+    args: unknown;
+}
+/**
+ * Function to get the current tool registry
+ * This allows the provider to always have access to the latest registry
+ */
+export type ToolRegistryProvider = () => ToolRegistry;
+/**
+ * MetaToolProvider provides meta-tools for lazy loading:
+ * 1. tool_list - List all tools (names + descriptions only)
+ * 2. tool_schema - Get full tool schema on-demand
+ * 3. tool_invoke - Invoke any tool by server and name
+ *
+ * @example
+ * ```typescript
+ * const provider = new MetaToolProvider(() => toolRegistry, schemaCache, outboundConnections, loadSchemaFn);
+ * const tools = provider.getMetaTools();
+ * const result = await provider.callMetaTool('tool_list', { server: 'filesystem' });
+ * ```
+ */
+export declare class MetaToolProvider {
+    private getToolRegistry;
+    private schemaCache;
+    private outboundConnections;
+    private loadSchema?;
+    private allowedServers?;
+    private connectionResolver;
+    constructor(getToolRegistry: ToolRegistryProvider, schemaCache: SchemaCache, outboundConnections: OutboundConnections, loadSchema?: SchemaLoader, allowedServers?: Set<string>, templateHashProvider?: TemplateHashProvider);
+    /**
+     * Resolve a clean server name to the actual connection key.
+     * Delegates to ConnectionResolver.findByServerName for unified resolution logic.
+     *
+     * @param cleanServerName - The clean server name (without hash suffix)
+     * @returns The actual connection key, or the original name if not found
+     */
+    private resolveConnectionKey;
+    /**
+     * Set the allowed servers filter
+     * @param serverNames - Set of server names to allow, or undefined to allow all
+     */
+    setAllowedServers(serverNames?: Set<string>): void;
+    /**
+     * Get the current tool registry, optionally filtered by allowed servers
+     */
+    private toolRegistry;
+    /**
+     * Get all available meta-tools (3 discovery tools)
+     */
+    getMetaTools(): Tool[];
+    /**
+     * Call a meta-tool by name
+     */
+    callMetaTool(name: string, args: unknown): Promise<ListToolsResult | DescribeToolResult | CallToolResult>;
+    /**
+     * Create the tool_list meta-tool
+     */
+    private createListToolsMetaTool;
+    /**
+     * Implement tool_list
+     */
+    private listAvailableTools;
+    /**
+     * Create the tool_schema meta-tool
+     */
+    private createDescribeToolMetaTool;
+    /**
+     * Implement tool_schema
+     */
+    private describeTool;
+    /**
+     * Create the tool_invoke meta-tool
+     */
+    private createCallToolMetaTool;
+    /**
+     * Implement tool_invoke
+     */
+    private callTool;
+}
+//# sourceMappingURL=metaToolProvider.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"metaToolProvider.d.ts","sourceRoot":"","sources":["../../../src/core/capabilities/metaToolProvider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAE1D,OAAO,EAAsB,oBAAoB,EAAE,MAAM,wCAAwC,CAAC;AAClG,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAI/D,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAEL,gBAAgB,EAGhB,cAAc,EAGd,gBAAgB,EAEjB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAgB,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAE/D;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,cAAc,CAAC;AAC7C,MAAM,MAAM,kBAAkB,GAAG,gBAAgB,CAAC;AAClD,MAAM,MAAM,cAAc,GAAG,gBAAgB,CAAC;AAE9C;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAE/E;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,OAAO,CAAC;CACf;AAED;;;GAGG;AACH,MAAM,MAAM,oBAAoB,GAAG,MAAM,YAAY,CAAC;AAEtD;;;;;;;;;;;;GAYG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,eAAe,CAAuB;IAC9C,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,mBAAmB,CAAsB;IACjD,OAAO,CAAC,UAAU,CAAC,CAAe;IAClC,OAAO,CAAC,cAAc,CAAC,CAAc;IACrC,OAAO,CAAC,kBAAkB,CAAqB;gBAG7C,eAAe,EAAE,oBAAoB,EACrC,WAAW,EAAE,WAAW,EACxB,mBAAmB,EAAE,mBAAmB,EACxC,UAAU,CAAC,EAAE,YAAY,EACzB,cAAc,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,EAC5B,oBAAoB,CAAC,EAAE,oBAAoB;IAU7C;;;;;;OAMG;IACH,OAAO,CAAC,oBAAoB;IAK5B;;;OAGG;IACI,iBAAiB,CAAC,WAAW,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,IAAI;IAIzD;;OAEG;IACH,OAAO,CAAC,YAAY;IAQpB;;OAEG;IACI,YAAY,IAAI,IAAI,EAAE;IAI7B;;OAEG;IACU,YAAY,CACvB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,OAAO,GACZ,OAAO,CAAC,eAAe,GAAG,kBAAkB,GAAG,cAAc,CAAC;IA4DjE;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAS/B;;OAEG;YACW,kBAAkB;IA8ChC;;OAEG;IACH,OAAO,CAAC,0BAA0B;IASlC;;OAEG;YACW,YAAY;IA4F1B;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAS9B;;OAEG;YACW,QAAQ;CAkFvB"}