agentic-qe 2.1.2 → 2.2.1

package/dist/telemetry/LearningTelemetry.d.ts

@@ -0,0 +1,190 @@
+/**
+ * Learning Telemetry for Agentic QE Fleet
+ *
+ * OpenTelemetry integration for tracking learning metrics, algorithm performance,
+ * and agent improvement over time using reinforcement learning.
+ *
+ * Tracks:
+ * - Learning episodes and Q-value updates
+ * - Reward distribution and convergence
+ * - Pattern discovery and matching
+ * - Algorithm performance and switches
+ * - Experience sharing metrics
+ */
+import { Meter, Counter, Histogram, UpDownCounter, ObservableGauge } from '@opentelemetry/api';
+import { MetricRecordOptions } from './types';
+import { RLAlgorithmType } from '../learning/LearningEngine';
+/**
+ * Learning metrics registry
+ */
+export interface LearningMetrics {
+    /** Total number of learning episodes recorded */
+    episodesTotal: Counter;
+    /** Total number of Q-value updates performed */
+    qValueUpdates: Counter;
+    /** Total sum of rewards received across all episodes */
+    rewardSum: Counter;
+    /** Number of algorithm switches performed */
+    algorithmSwitches: Counter;
+    /** Number of pattern cache hits */
+    patternHits: Counter;
+    /** Number of pattern cache misses */
+    patternMisses: Counter;
+    /** Distribution of episode durations in milliseconds */
+    episodeDuration: Histogram;
+    /** Distribution of reward values */
+    rewardDistribution: Histogram;
+    /** Distribution of Q-values */
+    qValueDistribution: Histogram;
+    /** Distribution of pattern confidence scores */
+    patternConfidence: Histogram;
+    /** Current learning rate */
+    learningRate: ObservableGauge;
+    /** Current exploration rate */
+    explorationRate: ObservableGauge;
+    /** Current convergence rate */
+    convergenceRate: ObservableGauge;
+    /** Size of Q-table (state-action pairs) */
+    qTableSize: ObservableGauge;
+    /** Number of experiences in replay buffer */
+    experienceBufferSize: ObservableGauge;
+    /** Pattern hit rate (cache efficiency) */
+    patternHitRate: ObservableGauge;
+    /** Number of experiences shared with peers */
+    experiencesShared: Counter;
+    /** Number of experiences received from peers */
+    experiencesReceived: Counter;
+    /** Number of active experience sharing connections */
+    activeSharingConnections: UpDownCounter;
+}
+declare const gaugeValues: {
+    learningRate: number;
+    explorationRate: number;
+    convergenceRate: number;
+    qTableSize: number;
+    experienceBufferSize: number;
+    patternHitRate: number;
+};
+/**
+ * Initialize learning metrics
+ *
+ * @param meter - OpenTelemetry Meter instance
+ * @returns Learning metrics registry
+ */
+export declare function createLearningMetrics(meter?: Meter): LearningMetrics;
+/**
+ * Get initialized learning metrics
+ *
+ * @returns Learning metrics registry
+ */
+export declare function getLearningMetrics(): LearningMetrics;
+/**
+ * Record a learning episode
+ *
+ * @param agentId - Agent identifier
+ * @param taskType - Type of task being learned
+ * @param reward - Reward received for this episode
+ * @param durationMs - Episode duration in milliseconds
+ * @param algorithm - RL algorithm used
+ * @param options - Additional recording options
+ */
+export declare function recordLearningEpisode(agentId: string, taskType: string, reward: number, durationMs: number, algorithm?: RLAlgorithmType, options?: {
+    qValueUpdate?: boolean;
+    patternDiscovered?: boolean;
+    explorationRate?: number;
+    learningRate?: number;
+}): void;
+/**
+ * Record Q-value updates
+ *
+ * @param agentId - Agent identifier
+ * @param count - Number of Q-value updates
+ * @param qValue - The Q-value (optional, for distribution tracking)
+ * @param algorithm - RL algorithm used
+ */
+export declare function recordQValueUpdate(agentId: string, count?: number, qValue?: number, algorithm?: RLAlgorithmType): void;
+/**
+ * Record pattern matching activity
+ *
+ * @param agentId - Agent identifier
+ * @param hit - Whether the pattern was found in cache
+ * @param confidence - Pattern confidence score (if hit)
+ * @param patternType - Type of pattern
+ */
+export declare function recordPatternMatch(agentId: string, hit: boolean, confidence?: number, patternType?: string): void;
+/**
+ * Record algorithm switch
+ *
+ * @param agentId - Agent identifier
+ * @param fromAlgorithm - Previous algorithm
+ * @param toAlgorithm - New algorithm
+ */
+export declare function recordAlgorithmSwitch(agentId: string, fromAlgorithm: RLAlgorithmType, toAlgorithm: RLAlgorithmType): void;
+/**
+ * Record experience sharing activity
+ *
+ * @param agentId - Agent identifier
+ * @param direction - 'shared' or 'received'
+ * @param count - Number of experiences
+ * @param priority - Experience priority (0-1)
+ */
+export declare function recordExperienceSharing(agentId: string, direction: 'shared' | 'received', count?: number, priority?: number): void;
+/**
+ * Update sharing connection count
+ *
+ * @param agentId - Agent identifier
+ * @param delta - Change in connection count (+1 for connect, -1 for disconnect)
+ */
+export declare function updateSharingConnections(agentId: string, delta: number): void;
+/**
+ * Update gauge values (for observable metrics)
+ *
+ * @param gauge - Gauge name
+ * @param value - New value
+ */
+export declare function updateGaugeValue(gauge: keyof typeof gaugeValues, value: number): void;
+/**
+ * Update multiple gauge values at once
+ *
+ * @param values - Object with gauge values to update
+ */
+export declare function updateGaugeValues(values: Partial<typeof gaugeValues>): void;
+/**
+ * Create a traced learning operation span
+ *
+ * @param operationName - Name of the learning operation
+ * @param agentId - Agent identifier
+ * @param fn - Function to execute within the span
+ * @returns Result of the function
+ */
+export declare function withLearningSpan<T>(operationName: string, agentId: string, fn: () => Promise<T>): Promise<T>;
+/**
+ * Record learning session summary
+ * Call this periodically or at session end to capture overall metrics
+ *
+ * @param agentId - Agent identifier
+ * @param stats - Learning statistics
+ */
+export declare function recordLearningSession(agentId: string, stats: {
+    algorithm: RLAlgorithmType;
+    totalEpisodes: number;
+    totalExperiences: number;
+    qTableSize: number;
+    explorationRate: number;
+    learningRate: number;
+    convergenceRate?: number;
+    avgReward?: number;
+    patternsDiscovered?: number;
+}): void;
+/**
+ * Get current pattern hit rate
+ *
+ * @returns Pattern hit rate (0-1)
+ */
+export declare function getPatternHitRate(): number;
+/**
+ * Reset pattern hit tracking (useful for testing or per-session metrics)
+ */
+export declare function resetPatternHitTracking(): void;
+export type { MetricRecordOptions };
+//# sourceMappingURL=LearningTelemetry.d.ts.map

package/dist/telemetry/LearningTelemetry.d.ts.map

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

package/dist/telemetry/LearningTelemetry.js

@@ -0,0 +1,403 @@
+"use strict";
+/**
+ * Learning Telemetry for Agentic QE Fleet
+ *
+ * OpenTelemetry integration for tracking learning metrics, algorithm performance,
+ * and agent improvement over time using reinforcement learning.
+ *
+ * Tracks:
+ * - Learning episodes and Q-value updates
+ * - Reward distribution and convergence
+ * - Pattern discovery and matching
+ * - Algorithm performance and switches
+ * - Experience sharing metrics
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createLearningMetrics = createLearningMetrics;
+exports.getLearningMetrics = getLearningMetrics;
+exports.recordLearningEpisode = recordLearningEpisode;
+exports.recordQValueUpdate = recordQValueUpdate;
+exports.recordPatternMatch = recordPatternMatch;
+exports.recordAlgorithmSwitch = recordAlgorithmSwitch;
+exports.recordExperienceSharing = recordExperienceSharing;
+exports.updateSharingConnections = updateSharingConnections;
+exports.updateGaugeValue = updateGaugeValue;
+exports.updateGaugeValues = updateGaugeValues;
+exports.withLearningSpan = withLearningSpan;
+exports.recordLearningSession = recordLearningSession;
+exports.getPatternHitRate = getPatternHitRate;
+exports.resetPatternHitTracking = resetPatternHitTracking;
+const bootstrap_1 = require("./bootstrap");
+// Singleton metrics instance
+let learningMetrics = null;
+// Storage for observable gauge values
+const gaugeValues = {
+    learningRate: 0,
+    explorationRate: 0,
+    convergenceRate: 0,
+    qTableSize: 0,
+    experienceBufferSize: 0,
+    patternHitRate: 0,
+};
+// Pattern hit tracking
+let totalPatternRequests = 0;
+let totalPatternHits = 0;
+/**
+ * Initialize learning metrics
+ *
+ * @param meter - OpenTelemetry Meter instance
+ * @returns Learning metrics registry
+ */
+function createLearningMetrics(meter) {
+    if (learningMetrics) {
+        return learningMetrics;
+    }
+    const m = meter || (0, bootstrap_1.getMeter)();
+    learningMetrics = {
+        // Counters
+        episodesTotal: m.createCounter('aqe.learning.episodes_total', {
+            description: 'Total number of learning episodes recorded',
+            unit: 'episodes',
+        }),
+        qValueUpdates: m.createCounter('aqe.learning.qvalue_updates', {
+            description: 'Total number of Q-value updates performed',
+            unit: 'updates',
+        }),
+        rewardSum: m.createCounter('aqe.learning.reward_sum', {
+            description: 'Cumulative sum of rewards received across all episodes',
+            unit: 'reward',
+        }),
+        algorithmSwitches: m.createCounter('aqe.learning.algorithm_switches', {
+            description: 'Number of RL algorithm switches performed',
+            unit: 'switches',
+        }),
+        patternHits: m.createCounter('aqe.learning.pattern_hits', {
+            description: 'Number of successful pattern cache hits',
+            unit: 'hits',
+        }),
+        patternMisses: m.createCounter('aqe.learning.pattern_misses', {
+            description: 'Number of pattern cache misses',
+            unit: 'misses',
+        }),
+        experiencesShared: m.createCounter('aqe.learning.experiences_shared', {
+            description: 'Number of experiences shared with peer agents',
+            unit: 'experiences',
+        }),
+        experiencesReceived: m.createCounter('aqe.learning.experiences_received', {
+            description: 'Number of experiences received from peer agents',
+            unit: 'experiences',
+        }),
+        // Histograms
+        episodeDuration: m.createHistogram('aqe.learning.episode_duration', {
+            description: 'Distribution of learning episode durations',
+            unit: 'ms',
+            advice: {
+                explicitBucketBoundaries: [10, 50, 100, 250, 500, 1000, 2500, 5000, 10000],
+            },
+        }),
+        rewardDistribution: m.createHistogram('aqe.learning.reward_distribution', {
+            description: 'Distribution of reward values across episodes',
+            unit: 'reward',
+            advice: {
+                explicitBucketBoundaries: [-2, -1.5, -1, -0.5, 0, 0.5, 1, 1.5, 2],
+            },
+        }),
+        qValueDistribution: m.createHistogram('aqe.learning.qvalue_distribution', {
+            description: 'Distribution of Q-values in the Q-table',
+            unit: 'qvalue',
+            advice: {
+                explicitBucketBoundaries: [-5, -2, -1, 0, 1, 2, 5, 10, 20, 50],
+            },
+        }),
+        patternConfidence: m.createHistogram('aqe.learning.pattern_confidence', {
+            description: 'Distribution of pattern confidence scores',
+            unit: 'confidence',
+            advice: {
+                explicitBucketBoundaries: [0.1, 0.2, 0.3, 0.4, 0.5, 0.6, 0.7, 0.8, 0.9, 0.95, 1.0],
+            },
+        }),
+        // Observable Gauges
+        learningRate: m.createObservableGauge('aqe.learning.learning_rate', {
+            description: 'Current learning rate (alpha)',
+            unit: 'rate',
+        }),
+        explorationRate: m.createObservableGauge('aqe.learning.exploration_rate', {
+            description: 'Current exploration rate (epsilon)',
+            unit: 'rate',
+        }),
+        convergenceRate: m.createObservableGauge('aqe.learning.convergence_rate', {
+            description: 'Learning convergence rate (improvement over time)',
+            unit: 'rate',
+        }),
+        qTableSize: m.createObservableGauge('aqe.learning.qtable_size', {
+            description: 'Number of state-action pairs in Q-table',
+            unit: 'pairs',
+        }),
+        experienceBufferSize: m.createObservableGauge('aqe.learning.experience_buffer_size', {
+            description: 'Number of experiences in replay buffer',
+            unit: 'experiences',
+        }),
+        patternHitRate: m.createObservableGauge('aqe.learning.pattern_hit_rate', {
+            description: 'Pattern cache hit rate (efficiency)',
+            unit: 'rate',
+        }),
+        activeSharingConnections: m.createUpDownCounter('aqe.learning.active_sharing_connections', {
+            description: 'Number of active experience sharing connections',
+            unit: 'connections',
+        }),
+    };
+    // Register observable callbacks
+    learningMetrics.learningRate.addCallback((observableResult) => {
+        observableResult.observe(gaugeValues.learningRate);
+    });
+    learningMetrics.explorationRate.addCallback((observableResult) => {
+        observableResult.observe(gaugeValues.explorationRate);
+    });
+    learningMetrics.convergenceRate.addCallback((observableResult) => {
+        observableResult.observe(gaugeValues.convergenceRate);
+    });
+    learningMetrics.qTableSize.addCallback((observableResult) => {
+        observableResult.observe(gaugeValues.qTableSize);
+    });
+    learningMetrics.experienceBufferSize.addCallback((observableResult) => {
+        observableResult.observe(gaugeValues.experienceBufferSize);
+    });
+    learningMetrics.patternHitRate.addCallback((observableResult) => {
+        observableResult.observe(gaugeValues.patternHitRate);
+    });
+    return learningMetrics;
+}
+/**
+ * Get initialized learning metrics
+ *
+ * @returns Learning metrics registry
+ */
+function getLearningMetrics() {
+    if (!learningMetrics) {
+        return createLearningMetrics();
+    }
+    return learningMetrics;
+}
+/**
+ * Record a learning episode
+ *
+ * @param agentId - Agent identifier
+ * @param taskType - Type of task being learned
+ * @param reward - Reward received for this episode
+ * @param durationMs - Episode duration in milliseconds
+ * @param algorithm - RL algorithm used
+ * @param options - Additional recording options
+ */
+function recordLearningEpisode(agentId, taskType, reward, durationMs, algorithm = 'q-learning', options) {
+    const metrics = getLearningMetrics();
+    const attributes = {
+        'agent.id': agentId,
+        'task.type': taskType,
+        'learning.algorithm': algorithm,
+    };
+    // Record episode
+    metrics.episodesTotal.add(1, attributes);
+    // Record episode duration
+    metrics.episodeDuration.record(durationMs, attributes);
+    // Record reward
+    metrics.rewardSum.add(reward, attributes);
+    metrics.rewardDistribution.record(reward, attributes);
+    // Record Q-value update if occurred
+    if (options?.qValueUpdate) {
+        metrics.qValueUpdates.add(1, attributes);
+    }
+    // Update gauge values if provided
+    if (options?.explorationRate !== undefined) {
+        updateGaugeValue('explorationRate', options.explorationRate);
+    }
+    if (options?.learningRate !== undefined) {
+        updateGaugeValue('learningRate', options.learningRate);
+    }
+}
+/**
+ * Record Q-value updates
+ *
+ * @param agentId - Agent identifier
+ * @param count - Number of Q-value updates
+ * @param qValue - The Q-value (optional, for distribution tracking)
+ * @param algorithm - RL algorithm used
+ */
+function recordQValueUpdate(agentId, count = 1, qValue, algorithm = 'q-learning') {
+    const metrics = getLearningMetrics();
+    const attributes = {
+        'agent.id': agentId,
+        'learning.algorithm': algorithm,
+    };
+    metrics.qValueUpdates.add(count, attributes);
+    // Record Q-value distribution if provided
+    if (qValue !== undefined) {
+        metrics.qValueDistribution.record(qValue, attributes);
+    }
+}
+/**
+ * Record pattern matching activity
+ *
+ * @param agentId - Agent identifier
+ * @param hit - Whether the pattern was found in cache
+ * @param confidence - Pattern confidence score (if hit)
+ * @param patternType - Type of pattern
+ */
+function recordPatternMatch(agentId, hit, confidence, patternType) {
+    const metrics = getLearningMetrics();
+    const attributes = {
+        'agent.id': agentId,
+    };
+    if (patternType) {
+        attributes['pattern.type'] = patternType;
+    }
+    // Track hit/miss
+    totalPatternRequests++;
+    if (hit) {
+        totalPatternHits++;
+        metrics.patternHits.add(1, attributes);
+        // Record confidence if provided
+        if (confidence !== undefined) {
+            metrics.patternConfidence.record(confidence, attributes);
+        }
+    }
+    else {
+        metrics.patternMisses.add(1, attributes);
+    }
+    // Update hit rate
+    updateGaugeValue('patternHitRate', totalPatternRequests > 0 ? totalPatternHits / totalPatternRequests : 0);
+}
+/**
+ * Record algorithm switch
+ *
+ * @param agentId - Agent identifier
+ * @param fromAlgorithm - Previous algorithm
+ * @param toAlgorithm - New algorithm
+ */
+function recordAlgorithmSwitch(agentId, fromAlgorithm, toAlgorithm) {
+    const metrics = getLearningMetrics();
+    metrics.algorithmSwitches.add(1, {
+        'agent.id': agentId,
+        'learning.algorithm.from': fromAlgorithm,
+        'learning.algorithm.to': toAlgorithm,
+    });
+}
+/**
+ * Record experience sharing activity
+ *
+ * @param agentId - Agent identifier
+ * @param direction - 'shared' or 'received'
+ * @param count - Number of experiences
+ * @param priority - Experience priority (0-1)
+ */
+function recordExperienceSharing(agentId, direction, count = 1, priority) {
+    const metrics = getLearningMetrics();
+    const attributes = {
+        'agent.id': agentId,
+    };
+    if (priority !== undefined) {
+        attributes['experience.priority'] = priority;
+    }
+    if (direction === 'shared') {
+        metrics.experiencesShared.add(count, attributes);
+    }
+    else {
+        metrics.experiencesReceived.add(count, attributes);
+    }
+}
+/**
+ * Update sharing connection count
+ *
+ * @param agentId - Agent identifier
+ * @param delta - Change in connection count (+1 for connect, -1 for disconnect)
+ */
+function updateSharingConnections(agentId, delta) {
+    const metrics = getLearningMetrics();
+    metrics.activeSharingConnections.add(delta, {
+        'agent.id': agentId,
+    });
+}
+/**
+ * Update gauge values (for observable metrics)
+ *
+ * @param gauge - Gauge name
+ * @param value - New value
+ */
+function updateGaugeValue(gauge, value) {
+    gaugeValues[gauge] = value;
+}
+/**
+ * Update multiple gauge values at once
+ *
+ * @param values - Object with gauge values to update
+ */
+function updateGaugeValues(values) {
+    Object.assign(gaugeValues, values);
+}
+/**
+ * Create a traced learning operation span
+ *
+ * @param operationName - Name of the learning operation
+ * @param agentId - Agent identifier
+ * @param fn - Function to execute within the span
+ * @returns Result of the function
+ */
+async function withLearningSpan(operationName, agentId, fn) {
+    return (0, bootstrap_1.withSpan)(`aqe.learning.${operationName}`, async () => {
+        const tracer = (0, bootstrap_1.getTracer)();
+        const currentSpan = tracer.startActiveSpan(operationName, (span) => {
+            span.setAttribute('agent.id', agentId);
+            span.setAttribute('operation.type', 'learning');
+            return span;
+        });
+        try {
+            const result = await fn();
+            return result;
+        }
+        finally {
+            currentSpan?.end();
+        }
+    });
+}
+/**
+ * Record learning session summary
+ * Call this periodically or at session end to capture overall metrics
+ *
+ * @param agentId - Agent identifier
+ * @param stats - Learning statistics
+ */
+function recordLearningSession(agentId, stats) {
+    // Update all gauge values
+    updateGaugeValues({
+        learningRate: stats.learningRate,
+        explorationRate: stats.explorationRate,
+        convergenceRate: stats.convergenceRate || 0,
+        qTableSize: stats.qTableSize,
+        experienceBufferSize: stats.totalExperiences,
+    });
+    // Record average reward if provided
+    if (stats.avgReward !== undefined) {
+        const metrics = getLearningMetrics();
+        metrics.rewardDistribution.record(stats.avgReward, {
+            'agent.id': agentId,
+            'learning.algorithm': stats.algorithm,
+            'session.type': 'summary',
+        });
+    }
+}
+/**
+ * Get current pattern hit rate
+ *
+ * @returns Pattern hit rate (0-1)
+ */
+function getPatternHitRate() {
+    return totalPatternRequests > 0 ? totalPatternHits / totalPatternRequests : 0;
+}
+/**
+ * Reset pattern hit tracking (useful for testing or per-session metrics)
+ */
+function resetPatternHitTracking() {
+    totalPatternRequests = 0;
+    totalPatternHits = 0;
+    updateGaugeValue('patternHitRate', 0);
+}
+//# sourceMappingURL=LearningTelemetry.js.map

package/dist/telemetry/LearningTelemetry.js.map

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

package/dist/telemetry/index.d.ts

@@ -6,6 +6,7 @@
 export { initTelemetry, shutdownTelemetry, getTracer, getMeter, isTelemetryInitialized, withSpan, recordSpanEvent, setSpanAttributes, defaultTelemetryConfig, } from './bootstrap';
 export { TelemetryConfig, TelemetryInitResult, TelemetryShutdownResult, AgentAttributes, TaskAttributes, QEAttributes, ModelAttributes, MetricRecordOptions, METRIC_NAMES, HISTOGRAM_BOUNDARIES, SPAN_NAMES, } from './types';
 export * from './metrics';
+export { LearningMetrics, createLearningMetrics, getLearningMetrics, recordLearningEpisode, recordQValueUpdate, recordPatternMatch, recordAlgorithmSwitch, recordExperienceSharing, updateSharingConnections, updateGaugeValue, updateGaugeValues, withLearningSpan, recordLearningSession, getPatternHitRate, resetPatternHitTracking, } from './LearningTelemetry';
 /**
  * Quick start function for initializing telemetry with defaults
  *

package/dist/telemetry/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/telemetry/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EACL,aAAa,EACb,iBAAiB,EACjB,SAAS,EACT,QAAQ,EACR,sBAAsB,EACtB,QAAQ,EACR,eAAe,EACf,iBAAiB,EACjB,sBAAsB,GACvB,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,uBAAuB,EACvB,eAAe,EACf,cAAc,EACd,YAAY,EACZ,eAAe,EACf,mBAAmB,EACnB,YAAY,EACZ,oBAAoB,EACpB,UAAU,GACX,MAAM,SAAS,CAAC;AAGjB,cAAc,WAAW,CAAC;AAE1B;;;;;GAKG;AACH,wBAAsB,mBAAmB,CAAC,WAAW,CAAC,EAAE,MAAM,kDAgB7D"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/telemetry/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EACL,aAAa,EACb,iBAAiB,EACjB,SAAS,EACT,QAAQ,EACR,sBAAsB,EACtB,QAAQ,EACR,eAAe,EACf,iBAAiB,EACjB,sBAAsB,GACvB,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,uBAAuB,EACvB,eAAe,EACf,cAAc,EACd,YAAY,EACZ,eAAe,EACf,mBAAmB,EACnB,YAAY,EACZ,oBAAoB,EACpB,UAAU,GACX,MAAM,SAAS,CAAC;AAGjB,cAAc,WAAW,CAAC;AAG1B,OAAO,EACL,eAAe,EACf,qBAAqB,EACrB,kBAAkB,EAClB,qBAAqB,EACrB,kBAAkB,EAClB,kBAAkB,EAClB,qBAAqB,EACrB,uBAAuB,EACvB,wBAAwB,EACxB,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,qBAAqB,EACrB,iBAAiB,EACjB,uBAAuB,GACxB,MAAM,qBAAqB,CAAC;AAE7B;;;;;GAKG;AACH,wBAAsB,mBAAmB,CAAC,WAAW,CAAC,EAAE,MAAM,kDAkB7D"}