@pcircle/claude-code-buddy-mcp 2.3.1

package/dist/evolution/LearningManagerConstants.d.ts

@@ -0,0 +1,55 @@
+export declare const QUALITY_THRESHOLDS: {
+    readonly HIGH: 0.8;
+    readonly LOW: 0.5;
+    readonly MIN_ACCEPTABLE: 0.7;
+};
+export declare const COST_OPTIMIZATION: {
+    readonly REDUCTION_TARGET: 0.8;
+    readonly VARIATION_PERCENT: 0.1;
+    readonly VARIATION_MIN_ABSOLUTE: 0.01;
+    readonly TARGET_REDUCTION: 0.2;
+};
+export declare const LEARNING_PARAMETERS: {
+    readonly CONFIDENCE_INCREMENT: 0.02;
+    readonly STATISTICAL_BASELINE_SAMPLES: 30;
+    readonly CONFIDENCE_PER_OBSERVATION: 0.3;
+};
+export declare const COMPLEXITY_THRESHOLDS: {
+    readonly LOW_MS: 5000;
+    readonly MEDIUM_MS: 15000;
+};
+export declare const STATISTICAL_PARAMETERS: {
+    readonly P95_MIN_SAMPLE_SIZE: 20;
+    readonly P95_PERCENTILE: 0.95;
+    readonly P95_TIMEOUT_MULTIPLIER: 1.5;
+};
+export declare const MEMORY_LIMITS: {
+    readonly MAX_SAVED_AGENTS: 100;
+    readonly MAX_PATTERNS_PER_AGENT: 100;
+    readonly MAX_FEEDBACK_PER_AGENT: 500;
+};
+export declare const PATTERN_EXTRACTION: {
+    readonly MIN_OBSERVATIONS: 10;
+    readonly MIN_CONFIDENCE: 0.7;
+    readonly SUCCESS_RATE_THRESHOLD: 0.8;
+    readonly FAILURE_RATE_THRESHOLD: 0.3;
+    readonly ANTI_PATTERN_OBSERVATION_DIVISOR: 2;
+    readonly OPTIMIZATION_OBSERVATION_DIVISOR: 2;
+};
+export declare const TEST_DEFAULTS: {
+    readonly SUCCESS_RATING: 4;
+    readonly FAILURE_RATING: 2;
+};
+export declare const PATTERN_KEYWORDS: {
+    readonly ERROR_HANDLING: readonly string[];
+    readonly VALIDATION: readonly string[];
+    readonly DOCUMENTATION: readonly string[];
+    readonly TYPE_ANNOTATIONS: readonly string[];
+};
+export declare const PATTERN_DESCRIPTIONS: {
+    readonly ERROR_HANDLING: "always add error handling to async functions";
+    readonly VALIDATION: "always include input validation";
+    readonly DOCUMENTATION: "always include comprehensive documentation";
+    readonly TYPE_ANNOTATIONS: "always add type annotations";
+};
+//# sourceMappingURL=LearningManagerConstants.d.ts.map

package/dist/evolution/LearningManagerConstants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LearningManagerConstants.d.ts","sourceRoot":"","sources":["../../src/evolution/LearningManagerConstants.ts"],"names":[],"mappings":"AAaA,eAAO,MAAM,kBAAkB;;;;CAOrB,CAAC;AAOX,eAAO,MAAM,iBAAiB;;;;;CASpB,CAAC;AAOX,eAAO,MAAM,mBAAmB;;;;CAOtB,CAAC;AAOX,eAAO,MAAM,qBAAqB;;;CAMxB,CAAC;AAOX,eAAO,MAAM,sBAAsB;;;;CAOzB,CAAC;AAOX,eAAO,MAAM,aAAa;;;;CAOhB,CAAC;AAOX,eAAO,MAAM,kBAAkB;;;;;;;CAarB,CAAC;AAOX,eAAO,MAAM,aAAa;;;CAKhB,CAAC;AAOX,eAAO,MAAM,gBAAgB;6BACwB,SAAS,MAAM,EAAE;yBAC7B,SAAS,MAAM,EAAE;4BACT,SAAS,MAAM,EAAE;+BACpB,SAAS,MAAM,EAAE;CACrD,CAAC;AAOX,eAAO,MAAM,oBAAoB;;;;;CAKvB,CAAC"}

package/dist/evolution/LearningManagerConstants.js

@@ -0,0 +1,55 @@
+export const QUALITY_THRESHOLDS = {
+    HIGH: 0.8,
+    LOW: 0.5,
+    MIN_ACCEPTABLE: 0.7,
+};
+export const COST_OPTIMIZATION = {
+    REDUCTION_TARGET: 0.8,
+    VARIATION_PERCENT: 0.1,
+    VARIATION_MIN_ABSOLUTE: 0.01,
+    TARGET_REDUCTION: 0.2,
+};
+export const LEARNING_PARAMETERS = {
+    CONFIDENCE_INCREMENT: 0.02,
+    STATISTICAL_BASELINE_SAMPLES: 30,
+    CONFIDENCE_PER_OBSERVATION: 0.3,
+};
+export const COMPLEXITY_THRESHOLDS = {
+    LOW_MS: 5000,
+    MEDIUM_MS: 15000,
+};
+export const STATISTICAL_PARAMETERS = {
+    P95_MIN_SAMPLE_SIZE: 20,
+    P95_PERCENTILE: 0.95,
+    P95_TIMEOUT_MULTIPLIER: 1.5,
+};
+export const MEMORY_LIMITS = {
+    MAX_SAVED_AGENTS: 100,
+    MAX_PATTERNS_PER_AGENT: 100,
+    MAX_FEEDBACK_PER_AGENT: 500,
+};
+export const PATTERN_EXTRACTION = {
+    MIN_OBSERVATIONS: 10,
+    MIN_CONFIDENCE: 0.7,
+    SUCCESS_RATE_THRESHOLD: 0.8,
+    FAILURE_RATE_THRESHOLD: 0.3,
+    ANTI_PATTERN_OBSERVATION_DIVISOR: 2,
+    OPTIMIZATION_OBSERVATION_DIVISOR: 2,
+};
+export const TEST_DEFAULTS = {
+    SUCCESS_RATING: 4,
+    FAILURE_RATING: 2,
+};
+export const PATTERN_KEYWORDS = {
+    ERROR_HANDLING: ['error handling', 'try-catch'],
+    VALIDATION: ['validation', 'input'],
+    DOCUMENTATION: ['documentation', 'comment'],
+    TYPE_ANNOTATIONS: ['type', 'annotation'],
+};
+export const PATTERN_DESCRIPTIONS = {
+    ERROR_HANDLING: 'always add error handling to async functions',
+    VALIDATION: 'always include input validation',
+    DOCUMENTATION: 'always include comprehensive documentation',
+    TYPE_ANNOTATIONS: 'always add type annotations',
+};
+//# sourceMappingURL=LearningManagerConstants.js.map

package/dist/evolution/LearningManagerConstants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LearningManagerConstants.js","sourceRoot":"","sources":["../../src/evolution/LearningManagerConstants.ts"],"names":[],"mappings":"AAaA,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAEhC,IAAI,EAAE,GAAG;IAET,GAAG,EAAE,GAAG;IAER,cAAc,EAAE,GAAG;CACX,CAAC;AAOX,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAE/B,gBAAgB,EAAE,GAAG;IAErB,iBAAiB,EAAE,GAAG;IAEtB,sBAAsB,EAAE,IAAI;IAE5B,gBAAgB,EAAE,GAAG;CACb,CAAC;AAOX,MAAM,CAAC,MAAM,mBAAmB,GAAG;IAEjC,oBAAoB,EAAE,IAAI;IAE1B,4BAA4B,EAAE,EAAE;IAEhC,0BAA0B,EAAE,GAAG;CACvB,CAAC;AAOX,MAAM,CAAC,MAAM,qBAAqB,GAAG;IAEnC,MAAM,EAAE,IAAI;IAEZ,SAAS,EAAE,KAAK;CAER,CAAC;AAOX,MAAM,CAAC,MAAM,sBAAsB,GAAG;IAEpC,mBAAmB,EAAE,EAAE;IAEvB,cAAc,EAAE,IAAI;IAEpB,sBAAsB,EAAE,GAAG;CACnB,CAAC;AAOX,MAAM,CAAC,MAAM,aAAa,GAAG;IAE3B,gBAAgB,EAAE,GAAG;IAErB,sBAAsB,EAAE,GAAG;IAE3B,sBAAsB,EAAE,GAAG;CACnB,CAAC;AAOX,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAEhC,gBAAgB,EAAE,EAAE;IAEpB,cAAc,EAAE,GAAG;IAEnB,sBAAsB,EAAE,GAAG;IAE3B,sBAAsB,EAAE,GAAG;IAE3B,gCAAgC,EAAE,CAAC;IAEnC,gCAAgC,EAAE,CAAC;CAC3B,CAAC;AAOX,MAAM,CAAC,MAAM,aAAa,GAAG;IAE3B,cAAc,EAAE,CAAC;IAEjB,cAAc,EAAE,CAAC;CACT,CAAC;AAOX,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,cAAc,EAAE,CAAC,gBAAgB,EAAE,WAAW,CAAsB;IACpE,UAAU,EAAE,CAAC,YAAY,EAAE,OAAO,CAAsB;IACxD,aAAa,EAAE,CAAC,eAAe,EAAE,SAAS,CAAsB;IAChE,gBAAgB,EAAE,CAAC,MAAM,EAAE,YAAY,CAAsB;CACrD,CAAC;AAOX,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,cAAc,EAAE,8CAA8C;IAC9D,UAAU,EAAE,iCAAiC;IAC7C,aAAa,EAAE,4CAA4C;IAC3D,gBAAgB,EAAE,6BAA6B;CACvC,CAAC"}

package/dist/evolution/MultiObjectiveOptimizer.d.ts

@@ -0,0 +1,9 @@
+import type { OptimizationCandidate, OptimizationObjectives } from './types.js';
+export declare class MultiObjectiveOptimizer {
+    dominates(c1: OptimizationCandidate, c2: OptimizationCandidate): boolean;
+    findParetoFront(candidates: OptimizationCandidate[]): OptimizationCandidate[];
+    selectBest(candidates: OptimizationCandidate[], weights: OptimizationObjectives): OptimizationCandidate | undefined;
+    private computeWeightedScore;
+    private getCommonObjectiveKeys;
+}
+//# sourceMappingURL=MultiObjectiveOptimizer.d.ts.map

package/dist/evolution/MultiObjectiveOptimizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MultiObjectiveOptimizer.d.ts","sourceRoot":"","sources":["../../src/evolution/MultiObjectiveOptimizer.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EACV,qBAAqB,EACrB,sBAAsB,EACvB,MAAM,YAAY,CAAC;AAEpB,qBAAa,uBAAuB;IAYlC,SAAS,CAAC,EAAE,EAAE,qBAAqB,EAAE,EAAE,EAAE,qBAAqB,GAAG,OAAO;IA+CxE,eAAe,CACb,UAAU,EAAE,qBAAqB,EAAE,GAClC,qBAAqB,EAAE;IAwC1B,UAAU,CACR,UAAU,EAAE,qBAAqB,EAAE,EACnC,OAAO,EAAE,sBAAsB,GAC9B,qBAAqB,GAAG,SAAS;IAuCpC,OAAO,CAAC,oBAAoB;IAsB5B,OAAO,CAAC,sBAAsB;CAS/B"}

package/dist/evolution/MultiObjectiveOptimizer.js

@@ -0,0 +1,92 @@
+import { logger } from '../utils/logger.js';
+export class MultiObjectiveOptimizer {
+    dominates(c1, c2) {
+        const keys = this.getCommonObjectiveKeys(c1.objectives, c2.objectives);
+        if (keys.length === 0) {
+            logger.warn('[MultiObjectiveOptimizer] No common objectives for domination check', {
+                c1Keys: Object.keys(c1.objectives),
+                c2Keys: Object.keys(c2.objectives),
+            });
+            return false;
+        }
+        let atLeastOneBetter = false;
+        for (const key of keys) {
+            const val1 = c1.objectives[key] ?? 0;
+            const val2 = c2.objectives[key] ?? 0;
+            if (!Number.isFinite(val1) || !Number.isFinite(val2)) {
+                logger.warn('[MultiObjectiveOptimizer] Non-finite objective value detected', { key, val1, val2 });
+                continue;
+            }
+            if (val1 < val2) {
+                return false;
+            }
+            if (val1 > val2) {
+                atLeastOneBetter = true;
+            }
+        }
+        return atLeastOneBetter;
+    }
+    findParetoFront(candidates) {
+        if (candidates.length === 0) {
+            return [];
+        }
+        if (candidates.length === 1) {
+            return candidates;
+        }
+        const paretoFront = [];
+        for (const candidate of candidates) {
+            let isDominated = false;
+            for (const paretoMember of paretoFront) {
+                if (this.dominates(paretoMember, candidate)) {
+                    isDominated = true;
+                    break;
+                }
+            }
+            if (!isDominated) {
+                const filtered = paretoFront.filter(member => !this.dominates(candidate, member));
+                paretoFront.length = 0;
+                paretoFront.push(...filtered, candidate);
+            }
+        }
+        return paretoFront;
+    }
+    selectBest(candidates, weights) {
+        if (candidates.length === 0) {
+            return undefined;
+        }
+        const weightValues = Object.values(weights).filter(v => v !== undefined);
+        if (weightValues.length === 0) {
+            logger.warn('[MultiObjectiveOptimizer] No valid weights provided');
+            return undefined;
+        }
+        if (weightValues.some(w => w < 0 || !Number.isFinite(w))) {
+            logger.error('[MultiObjectiveOptimizer] Invalid weights detected', { weights });
+            return undefined;
+        }
+        let bestCandidate;
+        let bestScore = -Infinity;
+        for (const candidate of candidates) {
+            const score = this.computeWeightedScore(candidate.objectives, weights);
+            if (score > bestScore) {
+                bestScore = score;
+                bestCandidate = candidate;
+            }
+        }
+        return bestCandidate;
+    }
+    computeWeightedScore(objectives, weights) {
+        let score = 0;
+        for (const key in weights) {
+            const weight = weights[key] ?? 0;
+            const value = objectives[key] ?? 0;
+            score += weight * value;
+        }
+        return score;
+    }
+    getCommonObjectiveKeys(obj1, obj2) {
+        const keys1 = Object.keys(obj1);
+        const keys2 = Object.keys(obj2);
+        return keys1.filter((key) => keys2.includes(key));
+    }
+}
+//# sourceMappingURL=MultiObjectiveOptimizer.js.map

package/dist/evolution/MultiObjectiveOptimizer.js.map

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

package/dist/evolution/PatternExplainer.d.ts

@@ -0,0 +1,14 @@
+import type { ContextualPattern, PatternExplanation } from './types.js';
+export declare class PatternExplainer {
+    private readonly CONFIDENCE_VERY_HIGH;
+    private readonly CONFIDENCE_HIGH;
+    private readonly CONFIDENCE_MODERATE;
+    explain(pattern: ContextualPattern): PatternExplanation;
+    private formatContextString;
+    private generateSummary;
+    private generateReasoning;
+    private generateRecommendation;
+    private explainConfidence;
+    private describeContext;
+}
+//# sourceMappingURL=PatternExplainer.d.ts.map

package/dist/evolution/PatternExplainer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PatternExplainer.d.ts","sourceRoot":"","sources":["../../src/evolution/PatternExplainer.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EACV,iBAAiB,EACjB,kBAAkB,EAEnB,MAAM,YAAY,CAAC;AAEpB,qBAAa,gBAAgB;IAE3B,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAO;IAC5C,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAQ;IACxC,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAO;IAS3C,OAAO,CAAC,OAAO,EAAE,iBAAiB,GAAG,kBAAkB;IAavD,OAAO,CAAC,mBAAmB;IAe3B,OAAO,CAAC,eAAe;IAwBvB,OAAO,CAAC,iBAAiB;IA0CzB,OAAO,CAAC,sBAAsB;IAwB9B,OAAO,CAAC,iBAAiB;IAsBzB,OAAO,CAAC,eAAe;CAyBxB"}

package/dist/evolution/PatternExplainer.js

@@ -0,0 +1,113 @@
+export class PatternExplainer {
+    CONFIDENCE_VERY_HIGH = 0.9;
+    CONFIDENCE_HIGH = 0.75;
+    CONFIDENCE_MODERATE = 0.6;
+    explain(pattern) {
+        return {
+            summary: this.generateSummary(pattern),
+            reasoning: this.generateReasoning(pattern),
+            recommendation: this.generateRecommendation(pattern),
+            confidence_explanation: this.explainConfidence(pattern),
+            context_description: this.describeContext(pattern.context),
+        };
+    }
+    formatContextString(context) {
+        if (context.agent_type && context.task_type) {
+            return `${context.agent_type} doing ${context.task_type}`;
+        }
+        else if (context.agent_type) {
+            return context.agent_type;
+        }
+        else if (context.task_type) {
+            return `${context.task_type} tasks`;
+        }
+        else {
+            return 'general contexts';
+        }
+    }
+    generateSummary(pattern) {
+        const contextStr = this.formatContextString(pattern.context);
+        switch (pattern.type) {
+            case 'success':
+                return `Successful pattern for ${contextStr}: ${pattern.description}`;
+            case 'optimization':
+                return `Optimization for ${contextStr}: ${pattern.description}`;
+            case 'anti-pattern':
+                return `Pattern to avoid for ${contextStr}: ${pattern.description}`;
+            case 'failure':
+                return `Failure pattern for ${contextStr}: ${pattern.description}`;
+            default:
+                return `Pattern for ${contextStr}: ${pattern.description}`;
+        }
+    }
+    generateReasoning(pattern) {
+        const reasoning = [];
+        reasoning.push(`This pattern was observed ${pattern.observations} times in similar contexts`);
+        const confidencePercent = Math.round(pattern.confidence * 100);
+        reasoning.push(`Pattern has ${confidencePercent}% confidence based on consistency across observations`);
+        if (pattern.success_rate !== undefined && pattern.success_rate > 0) {
+            const successPercent = Math.round(pattern.success_rate * 100);
+            reasoning.push(`Historical success rate: ${successPercent}% when this pattern was applied`);
+        }
+        if (pattern.avg_execution_time !== undefined && pattern.avg_execution_time > 0) {
+            reasoning.push(`Average execution time: ${pattern.avg_execution_time}ms`);
+        }
+        if (pattern.context.complexity) {
+            reasoning.push(`Most effective for ${pattern.context.complexity} complexity tasks`);
+        }
+        return reasoning;
+    }
+    generateRecommendation(pattern) {
+        const context = this.describeContext(pattern.context);
+        switch (pattern.type) {
+            case 'success':
+                return `Consider applying this pattern when ${context}. Expected benefits: improved success rate and efficiency.`;
+            case 'optimization':
+                return `Apply this optimization when ${context} to improve performance metrics.`;
+            case 'anti-pattern':
+                return `Avoid this approach when ${context}. Consider alternative strategies to prevent failures.`;
+            case 'failure':
+                return `Be aware of this failure mode when ${context}. Implement safeguards or fallback mechanisms.`;
+            default:
+                return `Monitor this pattern when ${context} and evaluate its effectiveness.`;
+        }
+    }
+    explainConfidence(pattern) {
+        const percent = Math.round(pattern.confidence * 100);
+        const observations = pattern.observations;
+        let interpretation;
+        if (pattern.confidence >= this.CONFIDENCE_VERY_HIGH) {
+            interpretation = 'Very high confidence';
+        }
+        else if (pattern.confidence >= this.CONFIDENCE_HIGH) {
+            interpretation = 'High confidence';
+        }
+        else if (pattern.confidence >= this.CONFIDENCE_MODERATE) {
+            interpretation = 'Moderate confidence';
+        }
+        else {
+            interpretation = 'Low confidence';
+        }
+        return `${interpretation} (${percent}%) based on ${observations} consistent observations`;
+    }
+    describeContext(context) {
+        const parts = [];
+        if (context.agent_type) {
+            parts.push(`agent is ${context.agent_type}`);
+        }
+        if (context.task_type) {
+            parts.push(`task is ${context.task_type}`);
+        }
+        if (context.complexity) {
+            parts.push(`complexity is ${context.complexity}`);
+        }
+        if (context.config_keys && context.config_keys.length > 0) {
+            parts.push(`using configuration: ${context.config_keys.join(', ')}`);
+        }
+        if (parts.length === 0) {
+            return 'in general contexts';
+        }
+        return parts.join(' and ');
+    }
+}
+//# sourceMappingURL=PatternExplainer.js.map

package/dist/evolution/PatternExplainer.js.map

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

package/dist/evolution/PerformanceTracker.d.ts

@@ -0,0 +1,43 @@
+import type { PerformanceMetrics, EvolutionStats } from './types.js';
+import { PerformanceMetricsRepository } from './storage/repositories/PerformanceMetricsRepository.js';
+export declare class PerformanceTracker {
+    private metrics;
+    private maxMetricsPerAgent;
+    private maxTotalMetrics;
+    private totalMetricsCount;
+    private evictionHeap;
+    private repository?;
+    constructor(config?: {
+        maxMetricsPerAgent?: number;
+        maxTotalMetrics?: number;
+        repository?: PerformanceMetricsRepository;
+    });
+    private loadFromRepository;
+    track(metrics: Omit<PerformanceMetrics, 'executionId' | 'timestamp'>): PerformanceMetrics;
+    private enforceGlobalLimit;
+    private updateHeapForAgent;
+    private rebuildHeap;
+    getMetrics(agentId: string, filter?: {
+        taskType?: string;
+        since?: Date;
+        limit?: number;
+    }): PerformanceMetrics[];
+    getEvolutionStats(agentId: string, recentWindowMs?: number): EvolutionStats;
+    getAveragePerformance(agentId: string, taskType: string): {
+        avgDuration: number;
+        avgCost: number;
+        avgQuality: number;
+        successRate: number;
+        sampleSize: number;
+    };
+    detectAnomalies(agentId: string, metric: PerformanceMetrics): {
+        isAnomaly: boolean;
+        type?: 'slow' | 'expensive' | 'low-quality' | 'failure';
+        severity: 'low' | 'medium' | 'high';
+        message: string;
+    };
+    clearMetrics(agentId: string): void;
+    getTrackedAgents(): string[];
+    getTotalTaskCount(): number;
+}
+//# sourceMappingURL=PerformanceTracker.d.ts.map

package/dist/evolution/PerformanceTracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PerformanceTracker.d.ts","sourceRoot":"","sources":["../../src/evolution/PerformanceTracker.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAGrE,OAAO,EAAE,4BAA4B,EAAE,MAAM,wDAAwD,CAAC;AAUtG,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,OAAO,CAAgD;IAC/D,OAAO,CAAC,kBAAkB,CAAgB;IAC1C,OAAO,CAAC,eAAe,CAAiB;IACxC,OAAO,CAAC,iBAAiB,CAAa;IAEtC,OAAO,CAAC,YAAY,CAAqB;IAEzC,OAAO,CAAC,UAAU,CAAC,CAA+B;gBAEtC,MAAM,CAAC,EAAE;QACnB,kBAAkB,CAAC,EAAE,MAAM,CAAC;QAC5B,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,UAAU,CAAC,EAAE,4BAA4B,CAAC;KAC3C;IAqCD,OAAO,CAAC,kBAAkB;IAoC1B,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,kBAAkB,EAAE,aAAa,GAAG,WAAW,CAAC,GAAG,kBAAkB;IA6HzF,OAAO,CAAC,kBAAkB;IA4D1B,OAAO,CAAC,kBAAkB;IAY1B,OAAO,CAAC,WAAW;IA0BnB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE;QACnC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,KAAK,CAAC,EAAE,IAAI,CAAC;QACb,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,GAAG,kBAAkB,EAAE;IAgDxB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,cAAc,GAAE,MAAgC,GAAG,cAAc;IAkGpG,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG;QACxD,WAAW,EAAE,MAAM,CAAC;QACpB,OAAO,EAAE,MAAM,CAAC;QAChB,UAAU,EAAE,MAAM,CAAC;QACnB,WAAW,EAAE,MAAM,CAAC;QACpB,UAAU,EAAE,MAAM,CAAC;KACpB;IAoDD,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,kBAAkB,GAAG;QAC5D,SAAS,EAAE,OAAO,CAAC;QACnB,IAAI,CAAC,EAAE,MAAM,GAAG,WAAW,GAAG,aAAa,GAAG,SAAS,CAAC;QACxD,QAAQ,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;QACpC,OAAO,EAAE,MAAM,CAAC;KACjB;IAyED,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IA8BnC,gBAAgB,IAAI,MAAM,EAAE;IAQ5B,iBAAiB,IAAI,MAAM;CAO5B"}