universal-agent-memory 0.6.2 → 0.7.0

package/dist/memory/speculative-cache.js

@@ -0,0 +1,259 @@
+/**
+ * Speculative Cache for UAM Memory System
+ *
+ * Pre-computes likely next queries based on task patterns.
+ * Reduces latency by predicting and caching memory retrievals.
+ */
+const DEFAULT_CONFIG = {
+    maxEntries: 100,
+    ttlMs: 300000, // 5 minutes
+    preWarmEnabled: true,
+    predictionDepth: 3,
+};
+/**
+ * Query patterns for speculative prefetching
+ */
+const QUERY_PATTERNS = {
+    'sysadmin': [
+        'linux commands', 'systemd services', 'network configuration',
+        'docker containers', 'kernel modules', 'filesystem mounts',
+    ],
+    'security': [
+        'authentication patterns', 'secret management', 'vulnerability fixes',
+        'input validation', 'encryption methods', 'access control',
+    ],
+    'coding': [
+        'design patterns', 'error handling', 'async patterns',
+        'type definitions', 'refactoring', 'code review',
+    ],
+    'testing': [
+        'test patterns', 'mocking', 'assertions',
+        'coverage', 'integration tests', 'edge cases',
+    ],
+    'debugging': [
+        'error messages', 'stack traces', 'dependency conflicts',
+        'environment issues', 'git problems', 'build failures',
+    ],
+    'ml-training': [
+        'model training', 'dataset processing', 'hyperparameters',
+        'embeddings', 'evaluation metrics', 'GPU optimization',
+    ],
+};
+/**
+ * Speculative Memory Cache
+ */
+export class SpeculativeCache {
+    config;
+    cache = new Map();
+    queryHistory = [];
+    taskPatterns = new Map();
+    constructor(config = {}) {
+        this.config = { ...DEFAULT_CONFIG, ...config };
+    }
+    /**
+     * Get from cache with automatic staleness check
+     */
+    get(query) {
+        const normalizedQuery = this.normalizeQuery(query);
+        const entry = this.cache.get(normalizedQuery);
+        if (!entry)
+            return null;
+        // Check TTL
+        const age = Date.now() - entry.lastUsed.getTime();
+        if (age > this.config.ttlMs) {
+            this.cache.delete(normalizedQuery);
+            return null;
+        }
+        // Update usage stats
+        entry.usageCount++;
+        entry.lastUsed = new Date();
+        return entry;
+    }
+    /**
+     * Set cache entry
+     */
+    set(query, result, predictedBy) {
+        const normalizedQuery = this.normalizeQuery(query);
+        // Evict if at capacity
+        if (this.cache.size >= this.config.maxEntries) {
+            this.evictLRU();
+        }
+        this.cache.set(normalizedQuery, {
+            query: normalizedQuery,
+            result,
+            usageCount: 1,
+            lastUsed: new Date(),
+            createdAt: new Date(),
+            predictedBy,
+        });
+        // Track query pattern
+        this.recordQuery(query);
+    }
+    /**
+     * Record query for pattern analysis
+     */
+    recordQuery(query) {
+        this.queryHistory.push(query);
+        // Keep last 100 queries
+        if (this.queryHistory.length > 100) {
+            this.queryHistory.shift();
+        }
+        // Update task patterns
+        const category = this.detectCategory(query);
+        if (category) {
+            const count = this.taskPatterns.get(category) || 0;
+            this.taskPatterns.set(category, count + 1);
+        }
+    }
+    /**
+     * Detect task category from query
+     */
+    detectCategory(query) {
+        const queryLower = query.toLowerCase();
+        for (const [category, keywords] of Object.entries(QUERY_PATTERNS)) {
+            for (const keyword of keywords) {
+                if (queryLower.includes(keyword.toLowerCase())) {
+                    return category;
+                }
+            }
+        }
+        return null;
+    }
+    /**
+     * Get predicted queries based on current context
+     */
+    getPredictedQueries(currentQuery) {
+        const predictions = [];
+        const category = this.detectCategory(currentQuery);
+        // Add category-specific predictions
+        if (category && QUERY_PATTERNS[category]) {
+            const categoryQueries = QUERY_PATTERNS[category];
+            predictions.push(...categoryQueries.slice(0, this.config.predictionDepth));
+        }
+        // Add patterns from history
+        const recentPatterns = this.analyzeQuerySequences();
+        predictions.push(...recentPatterns);
+        // Deduplicate and limit
+        return [...new Set(predictions)].slice(0, this.config.predictionDepth * 2);
+    }
+    /**
+     * Analyze query sequences for patterns
+     */
+    analyzeQuerySequences() {
+        const patterns = [];
+        if (this.queryHistory.length < 2)
+            return patterns;
+        // Look for common follow-up queries
+        const transitions = new Map();
+        for (let i = 0; i < this.queryHistory.length - 1; i++) {
+            const from = this.normalizeQuery(this.queryHistory[i]);
+            const to = this.normalizeQuery(this.queryHistory[i + 1]);
+            if (!transitions.has(from)) {
+                transitions.set(from, new Map());
+            }
+            const toCount = transitions.get(from).get(to) || 0;
+            transitions.get(from).set(to, toCount + 1);
+        }
+        // Find most common transitions
+        if (this.queryHistory.length > 0) {
+            const lastQuery = this.normalizeQuery(this.queryHistory[this.queryHistory.length - 1]);
+            const nextQueries = transitions.get(lastQuery);
+            if (nextQueries) {
+                const sorted = [...nextQueries.entries()].sort((a, b) => b[1] - a[1]);
+                patterns.push(...sorted.slice(0, 3).map(([query]) => query));
+            }
+        }
+        return patterns;
+    }
+    /**
+     * Pre-warm cache with predicted queries
+     */
+    async preWarm(currentQuery, fetcher) {
+        if (!this.config.preWarmEnabled)
+            return;
+        const predictions = this.getPredictedQueries(currentQuery);
+        // Fetch in parallel
+        await Promise.all(predictions.map(async (query) => {
+            if (!this.cache.has(this.normalizeQuery(query))) {
+                try {
+                    const result = await fetcher(query);
+                    this.set(query, result, currentQuery);
+                }
+                catch {
+                    // Ignore prefetch failures
+                }
+            }
+        }));
+    }
+    /**
+     * Evict least recently used entry
+     */
+    evictLRU() {
+        let oldest = null;
+        for (const [key, entry] of this.cache) {
+            const time = entry.lastUsed.getTime();
+            if (!oldest || time < oldest.time) {
+                oldest = { key, time };
+            }
+        }
+        if (oldest) {
+            this.cache.delete(oldest.key);
+        }
+    }
+    /**
+     * Normalize query for cache key
+     */
+    normalizeQuery(query) {
+        return query.toLowerCase().trim().replace(/\s+/g, ' ');
+    }
+    /**
+     * Get cache statistics
+     */
+    getStats() {
+        const entries = [...this.cache.values()];
+        const totalUsage = entries.reduce((sum, e) => sum + e.usageCount, 0);
+        const hits = entries.filter(e => e.usageCount > 1).length;
+        const topPatterns = [...this.taskPatterns.entries()]
+            .sort((a, b) => b[1] - a[1])
+            .slice(0, 5)
+            .map(([category, count]) => ({ category, count }));
+        return {
+            size: this.cache.size,
+            hitRate: entries.length > 0 ? hits / entries.length : 0,
+            avgUsage: entries.length > 0 ? totalUsage / entries.length : 0,
+            topPatterns,
+        };
+    }
+    /**
+     * Clear expired entries
+     */
+    cleanup() {
+        const now = Date.now();
+        let removed = 0;
+        for (const [key, entry] of this.cache) {
+            const age = now - entry.lastUsed.getTime();
+            if (age > this.config.ttlMs) {
+                this.cache.delete(key);
+                removed++;
+            }
+        }
+        return removed;
+    }
+    /**
+     * Clear all cache
+     */
+    clear() {
+        this.cache.clear();
+        this.queryHistory = [];
+        this.taskPatterns.clear();
+    }
+}
+// Singleton instance
+let globalCache = null;
+export function getSpeculativeCache(config) {
+    if (!globalCache) {
+        globalCache = new SpeculativeCache(config);
+    }
+    return globalCache;
+}
+//# sourceMappingURL=speculative-cache.js.map

package/dist/memory/speculative-cache.js.map

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

package/dist/memory/task-classifier.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Task Classification System for UAM
+ *
+ * Classifies tasks into categories and routes to appropriate droids/memory.
+ * Based on Terminal-Bench 2.0 task categories and Droid's routing strategies.
+ */
+export type TaskCategory = 'sysadmin' | 'security' | 'ml-training' | 'debugging' | 'coding' | 'file-ops' | 'testing' | 'unknown';
+export interface TaskClassification {
+    category: TaskCategory;
+    confidence: number;
+    keywords: string[];
+    suggestedDroid: string;
+    memoryQueryHints: string[];
+    requiredCapabilities: string[];
+}
+/**
+ * Classify a task based on its instruction/prompt
+ */
+export declare function classifyTask(instruction: string): TaskClassification;
+/**
+ * Extract entities from task instruction for memory queries
+ */
+export declare function extractTaskEntities(instruction: string): {
+    technologies: string[];
+    operations: string[];
+    files: string[];
+    concepts: string[];
+};
+/**
+ * Get suggested memory queries based on task classification
+ */
+export declare function getSuggestedMemoryQueries(classification: TaskClassification): string[];
+//# sourceMappingURL=task-classifier.d.ts.map

package/dist/memory/task-classifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-classifier.d.ts","sourceRoot":"","sources":["../../src/memory/task-classifier.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,MAAM,YAAY,GACpB,UAAU,GACV,UAAU,GACV,aAAa,GACb,WAAW,GACX,QAAQ,GACR,UAAU,GACV,SAAS,GACT,SAAS,CAAC;AAEd,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,YAAY,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,oBAAoB,EAAE,MAAM,EAAE,CAAC;CAChC;AAkHD;;GAEG;AACH,wBAAgB,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,kBAAkB,CAuDpE;AAuCD;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG;IACxD,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB,CAoEA;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,cAAc,EAAE,kBAAkB,GAAG,MAAM,EAAE,CAoBtF"}

package/dist/memory/task-classifier.js

@@ -0,0 +1,277 @@
+/**
+ * Task Classification System for UAM
+ *
+ * Classifies tasks into categories and routes to appropriate droids/memory.
+ * Based on Terminal-Bench 2.0 task categories and Droid's routing strategies.
+ */
+const CATEGORY_PATTERNS = [
+    {
+        category: 'sysadmin',
+        patterns: [
+            /kernel|linux|qemu|kvm|virtualization/i,
+            /systemd|systemctl|journalctl|service/i,
+            /network|dns|firewall|iptables|nftables/i,
+            /cron|crontab|scheduling|daemon/i,
+            /mount|filesystem|partition|lvm|fdisk/i,
+            /docker|container|kubernetes|k8s/i,
+            /nginx|apache|web server|reverse proxy/i,
+            /ssh|scp|rsync|remote/i,
+        ],
+        keywords: ['kernel', 'qemu', 'systemd', 'network', 'dns', 'cron', 'docker', 'mount', 'ssh'],
+        droid: 'sysadmin-expert',
+        capabilities: ['shell', 'root', 'networking', 'services'],
+    },
+    {
+        category: 'security',
+        patterns: [
+            /cve-?\d{4}-?\d+/i,
+            /exploit|vulnerability|attack|injection/i,
+            /secret|password|credential|token|api.?key/i,
+            /hash|crack|bcrypt|sha|md5/i,
+            /ssl|tls|certificate|x509/i,
+            /encrypt|decrypt|cipher|aes/i,
+            /auth|oauth|jwt|session/i,
+            /sanitize|escape|xss|csrf|sqli/i,
+        ],
+        keywords: ['CVE', 'exploit', 'secret', 'hash', 'certificate', 'encrypt', 'authentication'],
+        droid: 'security-auditor',
+        capabilities: ['security', 'cryptography', 'vulnerability-analysis'],
+    },
+    {
+        category: 'ml-training',
+        patterns: [
+            /train|training|model|neural|deep learning/i,
+            /pytorch|tensorflow|keras|transformers/i,
+            /dataset|dataloader|batch|epoch/i,
+            /mteb|embedding|sentence.?transformer/i,
+            /classifier|classification|regression/i,
+            /reinforcement|rl|reward|agent|gym/i,
+            /gpu|cuda|nvidia|tensor/i,
+            /hugging.?face|tokenizer|bert|gpt/i,
+        ],
+        keywords: ['train', 'model', 'pytorch', 'dataset', 'embedding', 'classifier', 'GPU'],
+        droid: 'ml-training-expert',
+        capabilities: ['python', 'ml-frameworks', 'gpu', 'data-processing'],
+    },
+    {
+        category: 'debugging',
+        patterns: [
+            /debug|fix|broken|error|exception/i,
+            /conda|pip|dependency|conflict|version/i,
+            /git|merge|rebase|conflict|reflog/i,
+            /stack.?trace|traceback|crash/i,
+            /memory.?leak|segfault|core.?dump/i,
+            /log|logging|diagnose|troubleshoot/i,
+        ],
+        keywords: ['debug', 'fix', 'error', 'conda', 'pip', 'git', 'conflict', 'crash'],
+        droid: 'debug-expert',
+        capabilities: ['debugging', 'profiling', 'version-management'],
+    },
+    {
+        category: 'coding',
+        patterns: [
+            /implement|function|class|method|algorithm/i,
+            /refactor|optimize|improve|clean/i,
+            /api|endpoint|rest|graphql|server/i,
+            /typescript|javascript|python|rust|go/i,
+            /singleton|factory|strategy|pattern/i,
+            /async|await|promise|callback/i,
+        ],
+        keywords: ['implement', 'function', 'class', 'refactor', 'API', 'algorithm', 'pattern'],
+        droid: 'code-quality-guardian',
+        capabilities: ['coding', 'design-patterns', 'apis'],
+    },
+    {
+        category: 'file-ops',
+        patterns: [
+            /archive|zip|tar|extract|compress/i,
+            /download|fetch|curl|wget/i,
+            /convert|transform|parse|format/i,
+            /csv|json|xml|yaml|parquet/i,
+            /file|directory|path|copy|move/i,
+        ],
+        keywords: ['archive', 'download', 'convert', 'file', 'extract'],
+        droid: 'terminal-bench-optimizer',
+        capabilities: ['file-operations', 'data-formats'],
+    },
+    {
+        category: 'testing',
+        patterns: [
+            /test|spec|unit|integration|e2e/i,
+            /vitest|jest|pytest|mocha|cypress/i,
+            /coverage|assertion|mock|stub|spy/i,
+            /tdd|bdd|test.?driven/i,
+        ],
+        keywords: ['test', 'spec', 'coverage', 'mock', 'assertion'],
+        droid: 'code-quality-guardian',
+        capabilities: ['testing', 'test-frameworks', 'coverage'],
+    },
+];
+/**
+ * Classify a task based on its instruction/prompt
+ */
+export function classifyTask(instruction) {
+    const normalizedInstruction = instruction.toLowerCase();
+    const scores = new Map();
+    const matchedKeywords = new Map();
+    // Score each category based on pattern matches
+    for (const categoryPattern of CATEGORY_PATTERNS) {
+        let score = 0;
+        const keywords = [];
+        // Check regex patterns
+        for (const pattern of categoryPattern.patterns) {
+            if (pattern.test(instruction)) {
+                score += 2;
+            }
+        }
+        // Check keywords
+        for (const keyword of categoryPattern.keywords) {
+            if (normalizedInstruction.includes(keyword.toLowerCase())) {
+                score += 1;
+                keywords.push(keyword);
+            }
+        }
+        scores.set(categoryPattern.category, score);
+        matchedKeywords.set(categoryPattern.category, keywords);
+    }
+    // Find best match
+    let bestCategory = 'unknown';
+    let bestScore = 0;
+    for (const [category, score] of scores) {
+        if (score > bestScore) {
+            bestScore = score;
+            bestCategory = category;
+        }
+    }
+    // Calculate confidence (0-1)
+    const maxPossibleScore = 20; // Rough estimate
+    const confidence = Math.min(bestScore / maxPossibleScore, 1);
+    // Get pattern config for best category
+    const patternConfig = CATEGORY_PATTERNS.find(p => p.category === bestCategory);
+    return {
+        category: bestCategory,
+        confidence,
+        keywords: matchedKeywords.get(bestCategory) || [],
+        suggestedDroid: patternConfig?.droid || 'terminal-bench-optimizer',
+        memoryQueryHints: generateMemoryQueryHints(bestCategory, matchedKeywords.get(bestCategory) || []),
+        requiredCapabilities: patternConfig?.capabilities || [],
+    };
+}
+/**
+ * Generate memory query hints based on task classification
+ */
+function generateMemoryQueryHints(category, keywords) {
+    const hints = [];
+    // Add category-specific hints
+    switch (category) {
+        case 'sysadmin':
+            hints.push('linux administration', 'system configuration', 'service management');
+            break;
+        case 'security':
+            hints.push('security vulnerability', 'secret management', 'authentication');
+            break;
+        case 'ml-training':
+            hints.push('model training', 'dataset processing', 'machine learning');
+            break;
+        case 'debugging':
+            hints.push('error fixing', 'dependency resolution', 'debugging techniques');
+            break;
+        case 'coding':
+            hints.push('code implementation', 'design patterns', 'best practices');
+            break;
+        case 'file-ops':
+            hints.push('file operations', 'data conversion', 'archive handling');
+            break;
+        case 'testing':
+            hints.push('unit testing', 'test coverage', 'test patterns');
+            break;
+    }
+    // Add keyword-based hints
+    hints.push(...keywords.slice(0, 3));
+    return hints;
+}
+/**
+ * Extract entities from task instruction for memory queries
+ */
+export function extractTaskEntities(instruction) {
+    const technologies = [];
+    const operations = [];
+    const files = [];
+    const concepts = [];
+    // Technology patterns
+    const techPatterns = [
+        /python|typescript|javascript|rust|go|java|c\+\+/gi,
+        /pytorch|tensorflow|keras|transformers/gi,
+        /docker|kubernetes|nginx|apache/gi,
+        /postgres|mysql|mongodb|redis/gi,
+        /react|vue|angular|next\.js/gi,
+        /git|npm|pip|conda|cargo/gi,
+    ];
+    for (const pattern of techPatterns) {
+        const matches = instruction.match(pattern);
+        if (matches) {
+            technologies.push(...matches.map(m => m.toLowerCase()));
+        }
+    }
+    // Operation patterns
+    const opPatterns = [
+        /\b(create|build|implement|configure|setup|install)\b/gi,
+        /\b(fix|debug|repair|resolve|troubleshoot)\b/gi,
+        /\b(test|verify|validate|check|ensure)\b/gi,
+        /\b(deploy|publish|release|ship)\b/gi,
+        /\b(refactor|optimize|improve|clean)\b/gi,
+    ];
+    for (const pattern of opPatterns) {
+        const matches = instruction.match(pattern);
+        if (matches) {
+            operations.push(...matches.map(m => m.toLowerCase()));
+        }
+    }
+    // File path patterns
+    const filePattern = /(?:\/[\w.-]+)+(?:\.\w+)?|[\w.-]+\.(ts|js|py|json|yaml|yml|md|txt|sh)/gi;
+    const fileMatches = instruction.match(filePattern);
+    if (fileMatches) {
+        files.push(...fileMatches);
+    }
+    // Concept patterns
+    const conceptPatterns = [
+        /\b(authentication|authorization|security)\b/gi,
+        /\b(caching|performance|optimization)\b/gi,
+        /\b(api|endpoint|service|microservice)\b/gi,
+        /\b(database|storage|persistence)\b/gi,
+        /\b(testing|coverage|quality)\b/gi,
+    ];
+    for (const pattern of conceptPatterns) {
+        const matches = instruction.match(pattern);
+        if (matches) {
+            concepts.push(...matches.map(m => m.toLowerCase()));
+        }
+    }
+    return {
+        technologies: [...new Set(technologies)],
+        operations: [...new Set(operations)],
+        files: [...new Set(files)],
+        concepts: [...new Set(concepts)],
+    };
+}
+/**
+ * Get suggested memory queries based on task classification
+ */
+export function getSuggestedMemoryQueries(classification) {
+    const queries = [];
+    // Category-based queries
+    queries.push(`${classification.category} best practices`);
+    queries.push(`${classification.category} common mistakes`);
+    queries.push(`${classification.category} patterns`);
+    // Keyword-based queries
+    for (const keyword of classification.keywords.slice(0, 3)) {
+        queries.push(`${keyword} implementation`);
+        queries.push(`${keyword} gotchas`);
+    }
+    // Capability-based queries
+    for (const capability of classification.requiredCapabilities.slice(0, 2)) {
+        queries.push(`${capability} tips`);
+    }
+    return queries;
+}
+//# sourceMappingURL=task-classifier.js.map

package/dist/memory/task-classifier.js.map

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

package/dist/utils/rate-limiter.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Configuration options for the RateLimiter.
+ */
+export interface RateLimiterConfig {
+    maxRequests: number;
+    windowMs: number;
+}
+export declare class RateLimiter {
+    private static readonly configSchema;
+    private static readonly clientIdSchema;
+    private readonly maxRequests;
+    private readonly windowMs;
+    private readonly requests;
+    /**
+     * Creates a new RateLimiter instance.
+     *
+     * @param config - Configuration for request limits and window size
+     * @returns A configured RateLimiter instance
+     * @throws AppError when config is invalid
+     */
+    constructor(config: RateLimiterConfig);
+    /**
+     * Checks if a request from the given client is allowed and records it if so.
+     *
+     * @param clientId - Identifier for the calling client
+     * @returns True if the request is allowed; otherwise false
+     * @throws AppError when clientId is invalid
+     */
+    isAllowed(clientId: string): boolean;
+    /**
+     * Returns the remaining number of requests for a client in the current window.
+     *
+     * @param clientId - Identifier for the calling client
+     * @returns Remaining number of requests in the window
+     * @throws AppError when clientId is invalid
+     */
+    getRemainingRequests(clientId: string): number;
+    /**
+     * Resets rate limiting for a single client or all clients.
+     *
+     * @param clientId - Optional client identifier to reset; omit to reset all
+     * @returns Nothing
+     */
+    reset(clientId?: string): void;
+    /**
+     * Removes expired timestamps and deletes empty client entries.
+     *
+     * @param now - Current timestamp used as reference
+     * @param clientId - Optional client identifier to scope cleanup
+     * @returns Nothing
+     */
+    private cleanupExpiredEntries;
+    /**
+     * Ensures the client identifier is valid.
+     *
+     * @param clientId - Identifier to validate
+     * @returns Nothing
+     * @throws AppError when clientId is invalid
+     */
+    private ensureValidClientId;
+}
+//# sourceMappingURL=rate-limiter.d.ts.map

package/dist/utils/rate-limiter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limiter.d.ts","sourceRoot":"","sources":["../../src/utils/rate-limiter.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;CAClB;AASD,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,YAAY,CAejC;IAEH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,cAAc,CAKE;IAExC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAoC;IAE7D;;;;;;OAMG;gBACS,MAAM,EAAE,iBAAiB;IAcrC;;;;;;OAMG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAgBpC;;;;;;OAMG;IACH,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IAc9C;;;;;OAKG;IACH,KAAK,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI;IAU9B;;;;;;OAMG;IACH,OAAO,CAAC,qBAAqB;IAoC7B;;;;;;OAMG;IACH,OAAO,CAAC,mBAAmB;CAU5B"}