@1mcp/agent 0.28.1 → 0.29.0-beta1

package/build/core/filtering/filterCache.d.ts

@@ -0,0 +1,121 @@
+import { MCPServerParams } from '../../core/types/index.js';
+import { TagExpression } from '../../domains/preset/parsers/tagQueryParser.js';
+import { TagQuery } from '../../domains/preset/types/presetTypes.js';
+/**
+ * Cache configuration
+ */
+export interface CacheConfig {
+    maxSize: number;
+    ttlMs: number;
+    enableStats: boolean;
+}
+/**
+ * Filter cache statistics
+ */
+export interface CacheStats {
+    expressions: {
+        hits: number;
+        misses: number;
+        size: number;
+    };
+    results: {
+        hits: number;
+        misses: number;
+        size: number;
+    };
+    evictions: number;
+    totalRequests: number;
+}
+/**
+ * Multi-level cache for template filtering
+ * - Level 1: Parsed expressions (avoid reparsing)
+ * - Level 2: Filter results (avoid recomputation)
+ */
+export declare class FilterCache {
+    private expressionCache;
+    private resultCache;
+    private config;
+    private stats;
+    constructor(config?: Partial<CacheConfig>);
+    /**
+     * Get or create a parsed tag expression
+     */
+    getOrParseExpression(expression: string): TagExpression | null;
+    /**
+     * Get cached filter results
+     */
+    getCachedResults(cacheKey: string): Array<[string, MCPServerParams]> | null;
+    /**
+     * Cache filter results
+     */
+    setCachedResults(cacheKey: string, results: Array<[string, MCPServerParams]>): void;
+    /**
+     * Generate cache key for filter results
+     */
+    generateCacheKey(templates: Array<[string, MCPServerParams]>, filterOptions: {
+        presetName?: string;
+        tags?: string[];
+        tagExpression?: string;
+        tagQuery?: TagQuery;
+        mode?: string;
+    }): string;
+    /**
+     * Check if a cache entry is still valid (not expired)
+     */
+    private isValid;
+    /**
+     * Ensure cache doesn't exceed max size (LRU eviction)
+     */
+    private ensureCapacity;
+    /**
+     * Set parsed expression in cache
+     */
+    private setExpression;
+    /**
+     * Ensure expression cache doesn't exceed max size (LRU eviction)
+     */
+    private ensureExpressionCapacity;
+    /**
+     * Simple hash function for cache key generation
+     * In production, might use crypto.createHash()
+     */
+    private simpleHash;
+    /**
+     * Clear expired entries
+     */
+    clearExpired(): void;
+    /**
+     * Get cache statistics
+     */
+    getStats(): CacheStats;
+    /**
+     * Get detailed cache information for debugging
+     */
+    getDetailedInfo(): {
+        config: CacheConfig;
+        expressions: Array<{
+            expression: string;
+            accessCount: number;
+            age: number;
+            lastAccessed: Date;
+        }>;
+        results: Array<{
+            cacheKey: string;
+            resultCount: number;
+            accessCount: number;
+            age: number;
+            lastAccessed: Date;
+        }>;
+    };
+    /**
+     * Clear all cache entries
+     */
+    clear(): void;
+    /**
+     * Warm up cache with common expressions
+     */
+    warmup(expressions: string[]): void;
+}
+export declare function getFilterCache(): FilterCache;
+export declare function resetFilterCache(): void;
+//# sourceMappingURL=filterCache.d.ts.map

package/build/core/filtering/filterCache.d.ts.map

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

package/build/core/filtering/filterCache.js

@@ -0,0 +1,359 @@
+import { TagQueryParser } from '../../domains/preset/parsers/tagQueryParser.js';
+import logger, { debugIf } from '../../logger/logger.js';
+/**
+ * Multi-level cache for template filtering
+ * - Level 1: Parsed expressions (avoid reparsing)
+ * - Level 2: Filter results (avoid recomputation)
+ */
+export class FilterCache {
+    expressionCache = new Map();
+    resultCache = new Map();
+    config;
+    stats;
+    constructor(config = {}) {
+        this.config = {
+            maxSize: 1000,
+            ttlMs: 5 * 60 * 1000, // 5 minutes
+            enableStats: true,
+            ...config,
+        };
+        this.stats = {
+            expressions: { hits: 0, misses: 0, size: 0 },
+            results: { hits: 0, misses: 0, size: 0 },
+            evictions: 0,
+            totalRequests: 0,
+        };
+    }
+    /**
+     * Get or create a parsed tag expression
+     */
+    getOrParseExpression(expression) {
+        this.stats.totalRequests++;
+        // Check cache first
+        const cached = this.expressionCache.get(expression);
+        if (cached && this.isValid(cached)) {
+            cached.lastAccessed = new Date();
+            cached.accessCount++;
+            this.stats.expressions.hits++;
+            debugIf(() => ({
+                message: `FilterCache.getOrParseExpression: Cache hit for expression: ${expression}`,
+                meta: {
+                    expression,
+                    accessCount: cached.accessCount,
+                },
+            }));
+            return cached.value;
+        }
+        // Parse and cache
+        try {
+            const parsed = TagQueryParser.parseAdvanced(expression);
+            this.setExpression(expression, parsed);
+            this.stats.expressions.misses++;
+            debugIf(() => ({
+                message: `FilterCache.getOrParseExpression: Parsed and cached expression: ${expression}`,
+                meta: { expression },
+            }));
+            return parsed;
+        }
+        catch (error) {
+            logger.warn(`FilterCache.getOrParseExpression: Failed to parse expression: ${expression}`, {
+                error: error instanceof Error ? error.message : 'Unknown error',
+                expression,
+            });
+            return null;
+        }
+    }
+    /**
+     * Get cached filter results
+     */
+    getCachedResults(cacheKey) {
+        this.stats.totalRequests++;
+        const cached = this.resultCache.get(cacheKey);
+        if (cached && this.isValid(cached)) {
+            cached.lastAccessed = new Date();
+            cached.accessCount++;
+            this.stats.results.hits++;
+            debugIf(() => ({
+                message: `FilterCache.getCachedResults: Cache hit for key: ${cacheKey}`,
+                meta: {
+                    cacheKey,
+                    resultCount: cached.value.length,
+                    accessCount: cached.accessCount,
+                },
+            }));
+            return cached.value;
+        }
+        this.stats.results.misses++;
+        return null;
+    }
+    /**
+     * Cache filter results
+     */
+    setCachedResults(cacheKey, results) {
+        const entry = {
+            value: results,
+            createdAt: new Date(),
+            lastAccessed: new Date(),
+            accessCount: 1,
+        };
+        this.resultCache.set(cacheKey, entry);
+        // Ensure capacity after adding the new entry
+        this.ensureCapacity();
+        this.stats.results.size = this.resultCache.size;
+        debugIf(() => ({
+            message: `FilterCache.setCachedResults: Cached results for key: ${cacheKey}`,
+            meta: {
+                cacheKey,
+                resultCount: results.length,
+                cacheSize: this.resultCache.size,
+            },
+        }));
+    }
+    /**
+     * Generate cache key for filter results
+     */
+    generateCacheKey(templates, filterOptions) {
+        // Create a deterministic key based on template hashes and filter options
+        const templateHashes = templates
+            .map(([name, config]) => {
+            // Simple hash based on template name and tags
+            const tags = (config.tags || []).sort().join(',');
+            return `${name}:${tags}`;
+        })
+            .sort()
+            .join('|');
+        const filterHash = JSON.stringify({
+            presetName: filterOptions.presetName,
+            tags: filterOptions.tags?.sort(),
+            tagExpression: filterOptions.tagExpression,
+            // Note: tagQuery is complex, so we use expression if available
+            mode: filterOptions.mode,
+        });
+        // Create a simple hash (in production, might use crypto)
+        return `${this.simpleHash(templateHashes)}_${this.simpleHash(filterHash)}`;
+    }
+    /**
+     * Check if a cache entry is still valid (not expired)
+     */
+    isValid(entry) {
+        const now = new Date();
+        const age = now.getTime() - entry.createdAt.getTime();
+        return age <= this.config.ttlMs;
+    }
+    /**
+     * Ensure cache doesn't exceed max size (LRU eviction)
+     */
+    ensureCapacity() {
+        while (this.resultCache.size > this.config.maxSize) {
+            // Find least recently used entry
+            let lruKey = null;
+            let lruTime = null; // Initialize to null
+            let lruAccessCount = Infinity;
+            // Find the entry with the earliest lastAccessed time
+            // If multiple entries have the same time, choose the one with lower access count
+            for (const [key, entry] of this.resultCache) {
+                const isLessRecent = lruTime === null || entry.lastAccessed < lruTime;
+                const isSameTime = lruTime !== null && entry.lastAccessed.getTime() === lruTime.getTime();
+                const isLessUsed = isSameTime && entry.accessCount < lruAccessCount;
+                if (isLessRecent || (isSameTime && isLessUsed)) {
+                    lruTime = entry.lastAccessed;
+                    lruKey = key;
+                    lruAccessCount = entry.accessCount;
+                }
+            }
+            if (lruKey) {
+                this.resultCache.delete(lruKey);
+                this.stats.evictions++;
+            }
+            else {
+                // No entry found to evict, break to avoid infinite loop
+                break;
+            }
+        }
+    }
+    /**
+     * Set parsed expression in cache
+     */
+    setExpression(expression, parsed) {
+        const entry = {
+            value: parsed,
+            createdAt: new Date(),
+            lastAccessed: new Date(),
+            accessCount: 1,
+        };
+        this.expressionCache.set(expression, entry);
+        // Ensure capacity for expression cache too
+        this.ensureExpressionCapacity();
+        this.stats.expressions.size = this.expressionCache.size;
+    }
+    /**
+     * Ensure expression cache doesn't exceed max size (LRU eviction)
+     */
+    ensureExpressionCapacity() {
+        while (this.expressionCache.size > this.config.maxSize) {
+            // Find least recently used entry
+            let lruKey = null;
+            let lruTime = null;
+            let lruAccessCount = Infinity;
+            for (const [key, entry] of this.expressionCache) {
+                const isLessRecent = lruTime === null || entry.lastAccessed < lruTime;
+                const isSameTime = lruTime !== null && entry.lastAccessed.getTime() === lruTime.getTime();
+                const isLessUsed = isSameTime && entry.accessCount < lruAccessCount;
+                if (isLessRecent || (isSameTime && isLessUsed)) {
+                    lruTime = entry.lastAccessed;
+                    lruKey = key;
+                    lruAccessCount = entry.accessCount;
+                }
+            }
+            if (lruKey) {
+                this.expressionCache.delete(lruKey);
+                this.stats.evictions++;
+            }
+            else {
+                // No entry found to evict, break to avoid infinite loop
+                break;
+            }
+        }
+    }
+    /**
+     * Simple hash function for cache key generation
+     * In production, might use crypto.createHash()
+     */
+    simpleHash(str) {
+        let hash = 0;
+        for (let i = 0; i < str.length; i++) {
+            const char = str.charCodeAt(i);
+            hash = (hash << 5) - hash + char;
+            hash = hash & hash; // Convert to 32-bit integer
+        }
+        return Math.abs(hash).toString(36);
+    }
+    /**
+     * Clear expired entries
+     */
+    clearExpired() {
+        const now = new Date();
+        let expiredCount = 0;
+        // Clear expired expressions
+        for (const [key, entry] of this.expressionCache) {
+            const age = now.getTime() - entry.createdAt.getTime();
+            if (age > this.config.ttlMs) {
+                this.expressionCache.delete(key);
+                expiredCount++;
+            }
+        }
+        // Clear expired results
+        for (const [key, entry] of this.resultCache) {
+            const age = now.getTime() - entry.createdAt.getTime();
+            if (age > this.config.ttlMs) {
+                this.resultCache.delete(key);
+                expiredCount++;
+            }
+        }
+        this.stats.expressions.size = this.expressionCache.size;
+        this.stats.results.size = this.resultCache.size;
+        if (expiredCount > 0) {
+            debugIf(() => ({
+                message: `FilterCache.clearExpired: Cleared ${expiredCount} expired entries`,
+                meta: {
+                    expiredCount,
+                    expressionCacheSize: this.expressionCache.size,
+                    resultCacheSize: this.resultCache.size,
+                },
+            }));
+        }
+    }
+    /**
+     * Get cache statistics
+     */
+    getStats() {
+        return { ...this.stats };
+    }
+    /**
+     * Get detailed cache information for debugging
+     */
+    getDetailedInfo() {
+        const now = new Date();
+        const expressions = Array.from(this.expressionCache.entries()).map(([expression, entry]) => ({
+            expression,
+            accessCount: entry.accessCount,
+            age: now.getTime() - entry.createdAt.getTime(),
+            lastAccessed: entry.lastAccessed,
+        }));
+        const results = Array.from(this.resultCache.entries()).map(([cacheKey, entry]) => ({
+            cacheKey,
+            resultCount: entry.value.length,
+            accessCount: entry.accessCount,
+            age: now.getTime() - entry.createdAt.getTime(),
+            lastAccessed: entry.lastAccessed,
+        }));
+        return {
+            config: this.config,
+            expressions,
+            results,
+        };
+    }
+    /**
+     * Clear all cache entries
+     */
+    clear() {
+        this.expressionCache.clear();
+        this.resultCache.clear();
+        this.stats = {
+            expressions: { hits: 0, misses: 0, size: 0 },
+            results: { hits: 0, misses: 0, size: 0 },
+            evictions: 0,
+            totalRequests: 0,
+        };
+        debugIf('FilterCache.clear: Cleared all cache entries');
+    }
+    /**
+     * Warm up cache with common expressions
+     */
+    warmup(expressions) {
+        debugIf(() => ({
+            message: `FilterCache.warmup: Warming up cache with ${expressions.length} expressions`,
+            meta: { expressionCount: expressions.length },
+        }));
+        for (const expression of expressions) {
+            this.getOrParseExpression(expression);
+        }
+        debugIf(`FilterCache.warmup: Warmup completed, ${this.expressionCache.size} expressions cached`);
+    }
+}
+/**
+ * Global filter cache instance (singleton pattern)
+ */
+let globalFilterCache = null;
+let cleanupInterval = null;
+export function getFilterCache() {
+    if (!globalFilterCache) {
+        globalFilterCache = new FilterCache({
+            maxSize: 1000,
+            ttlMs: 5 * 60 * 1000, // 5 minutes
+            enableStats: true,
+        });
+        // Set up periodic cleanup with proper cleanup tracking
+        cleanupInterval = setInterval(() => {
+            globalFilterCache?.clearExpired();
+        }, 60 * 1000); // Every minute
+        // Ensure cleanup on process exit
+        if (typeof process !== 'undefined') {
+            process.on('beforeExit', () => {
+                if (cleanupInterval) {
+                    clearInterval(cleanupInterval);
+                    cleanupInterval = null;
+                }
+            });
+        }
+    }
+    return globalFilterCache;
+}
+export function resetFilterCache() {
+    if (cleanupInterval) {
+        clearInterval(cleanupInterval);
+        cleanupInterval = null;
+    }
+    globalFilterCache = null;
+}
+//# sourceMappingURL=filterCache.js.map

package/build/core/filtering/filterCache.js.map

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

package/build/core/filtering/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Filtering module for template server optimization
+ * Provides advanced filtering, caching, indexing, and lifecycle management
+ */
+export { TemplateFilteringService } from './templateFilteringService.js';
+export type { TemplateFilterOptions, TemplateFilter } from './templateFilteringService.js';
+export { ClientTemplateTracker } from './clientTemplateTracker.js';
+export type { TemplateInstanceInfo, ClientTemplateRelationship } from './clientTemplateTracker.js';
+export { FilterCache, getFilterCache, resetFilterCache } from './filterCache.js';
+export type { CacheConfig, CacheStats } from './filterCache.js';
+export { TemplateIndex } from './templateIndex.js';
+export type { IndexStats } from './templateIndex.js';
+export { FilteringService } from './filteringService.js';
+export { filterClientsByTags, filterClientsByCapabilities, filterClients, byCapabilities, byTags, byTagExpression, } from './clientFiltering.js';
+export type { ClientFilter } from './clientFiltering.js';
+//# sourceMappingURL=index.d.ts.map

package/build/core/filtering/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/filtering/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AACzE,YAAY,EAAE,qBAAqB,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAG3F,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,YAAY,EAAE,oBAAoB,EAAE,0BAA0B,EAAE,MAAM,4BAA4B,CAAC;AAGnG,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACjF,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAGhE,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,YAAY,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAGrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EACL,mBAAmB,EACnB,2BAA2B,EAC3B,aAAa,EACb,cAAc,EACd,MAAM,EACN,eAAe,GAChB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC"}

package/build/core/filtering/index.js

@@ -0,0 +1,16 @@
+/**
+ * Filtering module for template server optimization
+ * Provides advanced filtering, caching, indexing, and lifecycle management
+ */
+// Core filtering service
+export { TemplateFilteringService } from './templateFilteringService.js';
+// Client-template lifecycle tracking
+export { ClientTemplateTracker } from './clientTemplateTracker.js';
+// Performance caching layer
+export { FilterCache, getFilterCache, resetFilterCache } from './filterCache.js';
+// High-performance template indexing
+export { TemplateIndex } from './templateIndex.js';
+// Re-export existing filtering utilities
+export { FilteringService } from './filteringService.js';
+export { filterClientsByTags, filterClientsByCapabilities, filterClients, byCapabilities, byTags, byTagExpression, } from './clientFiltering.js';
+//# sourceMappingURL=index.js.map

package/build/core/filtering/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/filtering/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,yBAAyB;AACzB,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAGzE,qCAAqC;AACrC,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAGnE,4BAA4B;AAC5B,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAGjF,qCAAqC;AACrC,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAGnD,yCAAyC;AACzC,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EACL,mBAAmB,EACnB,2BAA2B,EAC3B,aAAa,EACb,cAAc,EACd,MAAM,EACN,eAAe,GAChB,MAAM,sBAAsB,CAAC"}

package/build/core/filtering/templateFilteringService.d.ts

@@ -0,0 +1,72 @@
+import { MCPServerParams } from '../../core/types/index.js';
+import { InboundConnectionConfig } from '../../core/types/index.js';
+import { TagExpression } from '../../domains/preset/parsers/tagQueryParser.js';
+import { TagQuery } from '../../domains/preset/types/presetTypes.js';
+/**
+ * Filter options for template configurations
+ */
+export interface TemplateFilterOptions {
+    presetName?: string;
+    tags?: string[];
+    tagExpression?: TagExpression;
+    tagQuery?: TagQuery;
+    mode?: 'simple-or' | 'advanced' | 'preset' | 'none';
+}
+/**
+ * Template filter function type
+ */
+export type TemplateFilter = (templates: Array<[string, MCPServerParams]>) => Array<[string, MCPServerParams]>;
+/**
+ * Service for filtering MCP template configurations based on tags, presets, and advanced expressions
+ * This follows the same patterns as FilteringService but works with template configs instead of connections
+ */
+export declare class TemplateFilteringService {
+    /**
+     * Filter template configurations based on connection options
+     *
+     * @param templates Array of template configurations
+     * @param config Connection configuration with filter criteria
+     * @returns Filtered array of template configurations
+     */
+    static getMatchingTemplates(templates: Array<[string, MCPServerParams]>, config: InboundConnectionConfig): Array<[string, MCPServerParams]>;
+    /**
+     * Extract filter options from connection configuration
+     */
+    private static extractFilterOptions;
+    /**
+     * Create a filter function based on filter options
+     */
+    static createFilter(options: TemplateFilterOptions): TemplateFilter;
+    /**
+     * Filter templates by tags using OR logic (backward compatible)
+     */
+    static byTags(tags?: string[]): TemplateFilter;
+    /**
+     * Filter templates by preset name (exact match)
+     */
+    static byPreset(presetName: string): TemplateFilter;
+    /**
+     * Filter templates by advanced tag expression
+     */
+    static byTagExpression(expression: TagExpression | string): TemplateFilter;
+    /**
+     * Filter templates by MongoDB-style tag query
+     */
+    static byTagQuery(query: TagQuery): TemplateFilter;
+    /**
+     * Combine multiple template filters using AND logic
+     */
+    static combineFilters(...filters: TemplateFilter[]): TemplateFilter;
+    /**
+     * Get a summary of filtering results for logging and debugging
+     */
+    static getFilteringSummary(originalTemplates: Array<[string, MCPServerParams]>, filteredTemplates: Array<[string, MCPServerParams]>, options: TemplateFilterOptions): {
+        original: number;
+        filtered: number;
+        removed: number;
+        filterType: string;
+        filteredNames: string[];
+        removedNames: string[];
+    };
+}
+//# sourceMappingURL=templateFilteringService.d.ts.map

package/build/core/filtering/templateFilteringService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"templateFilteringService.d.ts","sourceRoot":"","sources":["../../../src/core/filtering/templateFilteringService.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AAEnE,OAAO,EAAE,aAAa,EAAkB,MAAM,+CAA+C,CAAC;AAC9F,OAAO,EAAE,QAAQ,EAAE,MAAM,0CAA0C,CAAC;AAIpE;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,IAAI,CAAC,EAAE,WAAW,GAAG,UAAU,GAAG,QAAQ,GAAG,MAAM,CAAC;CACrD;AAED;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC,CAAC;AAE/G;;;GAGG;AACH,qBAAa,wBAAwB;IACnC;;;;;;OAMG;WACW,oBAAoB,CAChC,SAAS,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC,EAC3C,MAAM,EAAE,uBAAuB,GAC9B,KAAK,CAAC,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IAwDnC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,oBAAoB;IAUnC;;OAEG;WACW,YAAY,CAAC,OAAO,EAAE,qBAAqB,GAAG,cAAc;IAgB1E;;OAEG;WACW,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,cAAc;IAuCrD;;OAEG;WACW,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,cAAc;IAyB1D;;OAEG;WACW,eAAe,CAAC,UAAU,EAAE,aAAa,GAAG,MAAM,GAAG,cAAc;IAwCjF;;OAEG;WACW,UAAU,CAAC,KAAK,EAAE,QAAQ,GAAG,cAAc;IAmCzD;;OAEG;WACW,cAAc,CAAC,GAAG,OAAO,EAAE,cAAc,EAAE,GAAG,cAAc;IAqC1E;;OAEG;WACW,mBAAmB,CAC/B,iBAAiB,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC,EACnD,iBAAiB,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC,EACnD,OAAO,EAAE,qBAAqB,GAC7B;QACD,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;QAChB,UAAU,EAAE,MAAM,CAAC;QACnB,aAAa,EAAE,MAAM,EAAE,CAAC;QACxB,YAAY,EAAE,MAAM,EAAE,CAAC;KACxB;CAuBF"}