@vorionsys/atsf-core 0.1.0 → 0.2.1

package/dist/carbon-aware/carbon-metrics.d.ts

@@ -0,0 +1,151 @@
+/**
+ * Carbon Metrics
+ *
+ * Tracks and reports carbon-related metrics including estimated CO2 per request,
+ * carbon savings from routing decisions, and regional intensity history.
+ *
+ * @packageDocumentation
+ */
+import { EventEmitter } from 'events';
+import type { CloudRegion, CarbonMetricsSnapshot, IntensityHistoryEntry, RoutingDecision, IntensityFetchedEvent, FallbackUsedEvent } from './types.js';
+/**
+ * Carbon Metrics Collector
+ *
+ * Aggregates and reports carbon-related metrics for the AI Gateway.
+ */
+export declare class CarbonMetrics extends EventEmitter {
+    private _totalRequests;
+    private _totalEstimatedCO2Grams;
+    private _totalSavingsGrams;
+    private _totalIntensitySum;
+    private _cacheHits;
+    private _cacheMisses;
+    private _fallbackCount;
+    private _totalFetches;
+    private _requestsByRegion;
+    private _requestsByProvider;
+    private _co2ByRegion;
+    private _intensityHistory;
+    private _historySize;
+    private _baselineIntensity;
+    private _periodStart;
+    constructor(config?: CarbonMetricsConfig);
+    /**
+     * Get total requests routed
+     */
+    get totalRequests(): number;
+    /**
+     * Get total estimated CO2 (grams)
+     */
+    get totalEstimatedCO2Grams(): number;
+    /**
+     * Get total CO2 savings (grams)
+     */
+    get totalSavingsGrams(): number;
+    /**
+     * Get average carbon intensity
+     */
+    get averageIntensity(): number;
+    /**
+     * Get green routing percentage
+     */
+    get greenRoutingPercentage(): number;
+    /**
+     * Get cache hit rate
+     */
+    get cacheHitRate(): number;
+    /**
+     * Get fallback rate
+     */
+    get fallbackRate(): number;
+    /**
+     * Record a routing decision
+     */
+    recordRouting(decision: RoutingDecision, estimatedTokens: number): void;
+    /**
+     * Record intensity fetch result
+     */
+    recordIntensityFetch(event: IntensityFetchedEvent): void;
+    /**
+     * Record fallback usage
+     */
+    recordFallback(event: FallbackUsedEvent): void;
+    /**
+     * Get a snapshot of all metrics
+     */
+    getSnapshot(): CarbonMetricsSnapshot;
+    /**
+     * Get intensity history for a region
+     */
+    getIntensityHistory(region?: CloudRegion): IntensityHistoryEntry[];
+    /**
+     * Get average intensity for a region over the history period
+     */
+    getAverageRegionIntensity(region: CloudRegion): number;
+    /**
+     * Get regions sorted by average intensity (greenest first)
+     */
+    getRegionsByIntensity(): Array<{
+        region: CloudRegion;
+        averageIntensity: number;
+    }>;
+    /**
+     * Get CO2 savings breakdown by region
+     */
+    getSavingsByRegion(): Map<CloudRegion, number>;
+    /**
+     * Get sustainability report
+     */
+    getSustainabilityReport(): SustainabilityReport;
+    /**
+     * Reset all metrics
+     */
+    reset(): void;
+    /**
+     * Calculate CO2 for a request
+     */
+    private calculateCO2;
+    /**
+     * Add entry to intensity history
+     */
+    private addToHistory;
+    /**
+     * Generate sustainability recommendations
+     */
+    private generateRecommendations;
+    /**
+     * Emit savings calculated event
+     */
+    private emitSavingsEvent;
+}
+/**
+ * Configuration for carbon metrics
+ */
+export interface CarbonMetricsConfig {
+    /** Maximum number of history entries to retain */
+    historySize?: number;
+    /** Baseline carbon intensity for savings calculation (gCO2eq/kWh) */
+    baselineIntensity?: number;
+}
+/**
+ * Sustainability report
+ */
+export interface SustainabilityReport extends CarbonMetricsSnapshot {
+    /** CO2 savings by region */
+    savingsByRegion: Map<CloudRegion, number>;
+    /** Equivalent number of trees (annual CO2 absorption) */
+    treesEquivalent: number;
+    /** Equivalent miles driven in an average car */
+    milesDrivenEquivalent: number;
+    /** Greenest region used */
+    greenestRegion?: CloudRegion;
+    /** Highest-carbon region used */
+    dirtiestRegion?: CloudRegion;
+    /** Recommendations for improving sustainability */
+    recommendations: string[];
+}
+/**
+ * Create a carbon metrics collector
+ */
+export declare function createCarbonMetrics(config?: CarbonMetricsConfig): CarbonMetrics;
+//# sourceMappingURL=carbon-metrics.d.ts.map

package/dist/carbon-aware/carbon-metrics.d.ts.map

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

package/dist/carbon-aware/carbon-metrics.js

@@ -0,0 +1,370 @@
+/**
+ * Carbon Metrics
+ *
+ * Tracks and reports carbon-related metrics including estimated CO2 per request,
+ * carbon savings from routing decisions, and regional intensity history.
+ *
+ * @packageDocumentation
+ */
+import { EventEmitter } from 'events';
+import { createLogger } from '../common/logger.js';
+import { ENERGY_PER_1000_TOKENS_KWH } from './types.js';
+const logger = createLogger({ component: 'carbon-metrics' });
+/**
+ * Default history retention (24 hours worth at 5-minute intervals)
+ */
+const DEFAULT_HISTORY_SIZE = 288;
+/**
+ * Default baseline carbon intensity for savings calculation (gCO2eq/kWh)
+ * Based on global average grid intensity
+ */
+const DEFAULT_BASELINE_INTENSITY = 450;
+/**
+ * Carbon Metrics Collector
+ *
+ * Aggregates and reports carbon-related metrics for the AI Gateway.
+ */
+export class CarbonMetrics extends EventEmitter {
+    _totalRequests = 0;
+    _totalEstimatedCO2Grams = 0;
+    _totalSavingsGrams = 0;
+    _totalIntensitySum = 0;
+    _cacheHits = 0;
+    _cacheMisses = 0;
+    _fallbackCount = 0;
+    _totalFetches = 0;
+    _requestsByRegion = new Map();
+    _requestsByProvider = new Map();
+    _co2ByRegion = new Map();
+    _intensityHistory = [];
+    _historySize;
+    _baselineIntensity;
+    _periodStart;
+    constructor(config = {}) {
+        super();
+        this._historySize = config.historySize ?? DEFAULT_HISTORY_SIZE;
+        this._baselineIntensity = config.baselineIntensity ?? DEFAULT_BASELINE_INTENSITY;
+        this._periodStart = new Date().toISOString();
+    }
+    /**
+     * Get total requests routed
+     */
+    get totalRequests() {
+        return this._totalRequests;
+    }
+    /**
+     * Get total estimated CO2 (grams)
+     */
+    get totalEstimatedCO2Grams() {
+        return this._totalEstimatedCO2Grams;
+    }
+    /**
+     * Get total CO2 savings (grams)
+     */
+    get totalSavingsGrams() {
+        return this._totalSavingsGrams;
+    }
+    /**
+     * Get average carbon intensity
+     */
+    get averageIntensity() {
+        return this._totalRequests > 0 ? this._totalIntensitySum / this._totalRequests : 0;
+    }
+    /**
+     * Get green routing percentage
+     */
+    get greenRoutingPercentage() {
+        if (this._totalRequests === 0)
+            return 0;
+        let greenCount = 0;
+        Array.from(this._requestsByRegion.entries()).forEach(([region, count]) => {
+            // Consider regions with intensity <= 150 as "green"
+            const avgIntensity = this.getAverageRegionIntensity(region);
+            if (avgIntensity <= 150) {
+                greenCount += count;
+            }
+        });
+        return (greenCount / this._totalRequests) * 100;
+    }
+    /**
+     * Get cache hit rate
+     */
+    get cacheHitRate() {
+        const total = this._cacheHits + this._cacheMisses;
+        return total > 0 ? this._cacheHits / total : 0;
+    }
+    /**
+     * Get fallback rate
+     */
+    get fallbackRate() {
+        return this._totalFetches > 0 ? this._fallbackCount / this._totalFetches : 0;
+    }
+    /**
+     * Record a routing decision
+     */
+    recordRouting(decision, estimatedTokens) {
+        this._totalRequests++;
+        // Calculate CO2
+        const co2Grams = this.calculateCO2(decision.carbonIntensity.intensity, estimatedTokens);
+        this._totalEstimatedCO2Grams += co2Grams;
+        this._totalIntensitySum += decision.carbonIntensity.intensity;
+        // Calculate savings vs baseline
+        const baselineCO2 = this.calculateCO2(this._baselineIntensity, estimatedTokens);
+        const savings = Math.max(0, baselineCO2 - co2Grams);
+        this._totalSavingsGrams += savings;
+        // Update region counts
+        const regionCount = this._requestsByRegion.get(decision.region) ?? 0;
+        this._requestsByRegion.set(decision.region, regionCount + 1);
+        // Update provider counts
+        const providerCount = this._requestsByProvider.get(decision.provider) ?? 0;
+        this._requestsByProvider.set(decision.provider, providerCount + 1);
+        // Update CO2 by region
+        const regionCO2 = this._co2ByRegion.get(decision.region) ?? 0;
+        this._co2ByRegion.set(decision.region, regionCO2 + co2Grams);
+        // Track intensity history for green routing percentage calculation
+        this.addToHistory({
+            region: decision.region,
+            intensity: decision.carbonIntensity.intensity,
+            timestamp: decision.decidedAt,
+            source: 'routing_decision',
+        });
+        // Emit savings event
+        this.emitSavingsEvent(decision.id, co2Grams, baselineCO2, savings);
+        logger.debug({
+            requestId: decision.id,
+            region: decision.region,
+            co2Grams,
+            savingsGrams: savings,
+            totalRequests: this._totalRequests,
+        }, 'Routing recorded');
+    }
+    /**
+     * Record intensity fetch result
+     */
+    recordIntensityFetch(event) {
+        this._totalFetches++;
+        if (event.cacheHit) {
+            this._cacheHits++;
+        }
+        else {
+            this._cacheMisses++;
+        }
+        // Add to history
+        this.addToHistory({
+            region: event.region,
+            intensity: event.intensity,
+            timestamp: event.timestamp,
+            source: event.source,
+        });
+    }
+    /**
+     * Record fallback usage
+     */
+    recordFallback(event) {
+        this._fallbackCount++;
+        logger.debug({
+            region: event.region,
+            primarySource: event.primarySource,
+            fallbackSource: event.fallbackSource,
+            reason: event.reason,
+        }, 'Fallback recorded');
+    }
+    /**
+     * Get a snapshot of all metrics
+     */
+    getSnapshot() {
+        return {
+            totalRequests: this._totalRequests,
+            totalEstimatedCO2Grams: this._totalEstimatedCO2Grams,
+            totalSavingsGrams: this._totalSavingsGrams,
+            averageIntensity: this.averageIntensity,
+            requestsByRegion: new Map(this._requestsByRegion),
+            requestsByProvider: new Map(this._requestsByProvider),
+            co2ByRegion: new Map(this._co2ByRegion),
+            greenRoutingPercentage: this.greenRoutingPercentage,
+            cacheHitRate: this.cacheHitRate,
+            fallbackRate: this.fallbackRate,
+            periodStart: this._periodStart,
+            periodEnd: new Date().toISOString(),
+        };
+    }
+    /**
+     * Get intensity history for a region
+     */
+    getIntensityHistory(region) {
+        if (region) {
+            return this._intensityHistory.filter(e => e.region === region);
+        }
+        return [...this._intensityHistory];
+    }
+    /**
+     * Get average intensity for a region over the history period
+     */
+    getAverageRegionIntensity(region) {
+        const regionHistory = this.getIntensityHistory(region);
+        if (regionHistory.length === 0)
+            return this._baselineIntensity;
+        const sum = regionHistory.reduce((acc, e) => acc + e.intensity, 0);
+        return sum / regionHistory.length;
+    }
+    /**
+     * Get regions sorted by average intensity (greenest first)
+     */
+    getRegionsByIntensity() {
+        const regions = new Set(this._intensityHistory.map(e => e.region));
+        const result = [];
+        Array.from(regions).forEach((region) => {
+            result.push({
+                region,
+                averageIntensity: this.getAverageRegionIntensity(region),
+            });
+        });
+        return result.sort((a, b) => a.averageIntensity - b.averageIntensity);
+    }
+    /**
+     * Get CO2 savings breakdown by region
+     */
+    getSavingsByRegion() {
+        const savings = new Map();
+        Array.from(this._co2ByRegion.entries()).forEach(([region, totalCO2]) => {
+            const requests = this._requestsByRegion.get(region) ?? 0;
+            if (requests > 0) {
+                // Estimate what the CO2 would have been at baseline
+                const avgCO2PerRequest = totalCO2 / requests;
+                const baselineCO2PerRequest = avgCO2PerRequest * (this._baselineIntensity / this.getAverageRegionIntensity(region));
+                const regionSavings = (baselineCO2PerRequest - avgCO2PerRequest) * requests;
+                savings.set(region, Math.max(0, regionSavings));
+            }
+        });
+        return savings;
+    }
+    /**
+     * Get sustainability report
+     */
+    getSustainabilityReport() {
+        const snapshot = this.getSnapshot();
+        const savingsByRegion = this.getSavingsByRegion();
+        const regionsByIntensity = this.getRegionsByIntensity();
+        // Calculate equivalent metrics
+        const treesEquivalent = this._totalSavingsGrams / 21000; // ~21kg CO2 per tree per year
+        const milesDrivenEquivalent = this._totalSavingsGrams / 404; // ~404g CO2 per mile
+        // Find greenest and dirtiest routes used
+        let greenestRegion;
+        let dirtiestRegion;
+        let minIntensity = Infinity;
+        let maxIntensity = 0;
+        for (const { region, averageIntensity } of regionsByIntensity) {
+            if (this._requestsByRegion.get(region)) {
+                if (averageIntensity < minIntensity) {
+                    minIntensity = averageIntensity;
+                    greenestRegion = region;
+                }
+                if (averageIntensity > maxIntensity) {
+                    maxIntensity = averageIntensity;
+                    dirtiestRegion = region;
+                }
+            }
+        }
+        return {
+            ...snapshot,
+            savingsByRegion,
+            treesEquivalent,
+            milesDrivenEquivalent,
+            greenestRegion,
+            dirtiestRegion,
+            recommendations: this.generateRecommendations(snapshot, regionsByIntensity),
+        };
+    }
+    /**
+     * Reset all metrics
+     */
+    reset() {
+        this._totalRequests = 0;
+        this._totalEstimatedCO2Grams = 0;
+        this._totalSavingsGrams = 0;
+        this._totalIntensitySum = 0;
+        this._cacheHits = 0;
+        this._cacheMisses = 0;
+        this._fallbackCount = 0;
+        this._totalFetches = 0;
+        this._requestsByRegion.clear();
+        this._requestsByProvider.clear();
+        this._co2ByRegion.clear();
+        this._intensityHistory = [];
+        this._periodStart = new Date().toISOString();
+        logger.info('Carbon metrics reset');
+    }
+    /**
+     * Calculate CO2 for a request
+     */
+    calculateCO2(intensityGCO2, tokens) {
+        const energyKWh = (tokens / 1000) * ENERGY_PER_1000_TOKENS_KWH;
+        return energyKWh * intensityGCO2;
+    }
+    /**
+     * Add entry to intensity history
+     */
+    addToHistory(entry) {
+        this._intensityHistory.push(entry);
+        // Trim if over size limit
+        if (this._intensityHistory.length > this._historySize) {
+            this._intensityHistory = this._intensityHistory.slice(-this._historySize);
+        }
+    }
+    /**
+     * Generate sustainability recommendations
+     */
+    generateRecommendations(snapshot, regionsByIntensity) {
+        const recommendations = [];
+        // Check green routing percentage
+        if (snapshot.greenRoutingPercentage < 50) {
+            recommendations.push('Consider relaxing latency constraints to allow more routing to low-carbon regions.');
+        }
+        // Check if high-carbon regions are being used frequently
+        const highCarbonRegions = regionsByIntensity.filter(r => r.averageIntensity > 300);
+        for (const { region } of highCarbonRegions) {
+            const requests = snapshot.requestsByRegion.get(region) ?? 0;
+            if (requests > snapshot.totalRequests * 0.1) {
+                recommendations.push(`Region ${region} has high carbon intensity. Consider alternative regions if latency permits.`);
+            }
+        }
+        // Check cache hit rate
+        if (snapshot.cacheHitRate < 0.5) {
+            recommendations.push('Low cache hit rate detected. Consider increasing cache TTL for carbon intensity data.');
+        }
+        // Check fallback rate
+        if (snapshot.fallbackRate > 0.1) {
+            recommendations.push('High fallback rate detected. Check primary carbon data source connectivity.');
+        }
+        // Recommend greenest regions
+        const greenestRegions = regionsByIntensity.slice(0, 3);
+        if (greenestRegions.length > 0) {
+            const regionNames = greenestRegions.map(r => r.region).join(', ');
+            recommendations.push(`Greenest available regions: ${regionNames}. Consider prioritizing these when possible.`);
+        }
+        return recommendations;
+    }
+    /**
+     * Emit savings calculated event
+     */
+    emitSavingsEvent(requestId, actualCO2Grams, baselineCO2Grams, savingsGrams) {
+        const event = {
+            type: 'carbon:savings_calculated',
+            timestamp: new Date().toISOString(),
+            requestId,
+            actualCO2Grams,
+            baselineCO2Grams,
+            savingsGrams,
+            savingsPercentage: baselineCO2Grams > 0 ? (savingsGrams / baselineCO2Grams) * 100 : 0,
+        };
+        this.emit(event.type, event);
+        this.emit('carbon:*', event);
+    }
+}
+/**
+ * Create a carbon metrics collector
+ */
+export function createCarbonMetrics(config) {
+    return new CarbonMetrics(config);
+}
+//# sourceMappingURL=carbon-metrics.js.map

package/dist/carbon-aware/carbon-metrics.js.map

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

package/dist/carbon-aware/carbon-router.d.ts

@@ -0,0 +1,101 @@
+/**
+ * Carbon-Aware Router
+ *
+ * Routes AI requests to lower-carbon regions when possible, considering
+ * provider availability, latency requirements, and cost constraints.
+ *
+ * @packageDocumentation
+ */
+import { EventEmitter } from 'events';
+import { CarbonIntensityClient } from './carbon-intensity-client.js';
+import { CarbonMetrics } from './carbon-metrics.js';
+import type { CarbonRouterConfig, RoutingRequest, RoutingDecision, CloudRegion, AIProvider, CarbonIntensity } from './types.js';
+/**
+ * Carbon-Aware Router
+ *
+ * Intelligently routes AI requests to minimize carbon footprint while
+ * respecting performance and cost constraints.
+ */
+export declare class CarbonRouter extends EventEmitter {
+    private _client;
+    private _metrics;
+    private _defaultConstraints;
+    private _providerAvailability;
+    private _regionLatencies;
+    private _costMultipliers;
+    private _enableMetrics;
+    constructor(config?: CarbonRouterConfig);
+    /**
+     * Get the carbon intensity client
+     */
+    get client(): CarbonIntensityClient;
+    /**
+     * Get the metrics collector
+     */
+    get metrics(): CarbonMetrics;
+    /**
+     * Route a request to the optimal region based on carbon intensity
+     */
+    route(request: RoutingRequest): Promise<RoutingDecision>;
+    /**
+     * Get the best provider for a specific region
+     */
+    getProviderForRegion(region: CloudRegion, preferredProviders?: AIProvider[]): Promise<AIProvider | undefined>;
+    /**
+     * Get carbon intensity for all regions
+     */
+    getRegionIntensities(): Promise<Map<CloudRegion, CarbonIntensity>>;
+    /**
+     * Get the lowest carbon regions
+     */
+    getGreenRegions(count?: number): Promise<CarbonIntensity[]>;
+    /**
+     * Check if a region meets carbon constraints
+     */
+    isGreenRegion(region: CloudRegion, maxIntensity?: number): Promise<boolean>;
+    /**
+     * Update provider availability
+     */
+    updateProviderAvailability(region: CloudRegion, provider: AIProvider, available: boolean): void;
+    /**
+     * Calculate estimated CO2 for a request
+     */
+    calculateCO2(intensityGCO2: number, tokens: number): number;
+    /**
+     * Close the router and release resources
+     */
+    close(): Promise<void>;
+    /**
+     * Route to a required region
+     */
+    private routeToRequired;
+    /**
+     * Route using fallback when no eligible routes found
+     */
+    private routeFallback;
+    /**
+     * Get eligible routes based on constraints
+     */
+    private getEligibleRoutes;
+    /**
+     * Determine routing reason
+     */
+    private determineReason;
+    /**
+     * Convert eligible route to alternative route format
+     */
+    private toAlternativeRoute;
+    /**
+     * Create default provider availability map
+     */
+    private createDefaultAvailability;
+    /**
+     * Emit request routed event
+     */
+    private emitRoutedEvent;
+}
+/**
+ * Create a carbon-aware router
+ */
+export declare function createCarbonRouter(config?: CarbonRouterConfig): CarbonRouter;
+//# sourceMappingURL=carbon-router.d.ts.map

package/dist/carbon-aware/carbon-router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"carbon-router.d.ts","sourceRoot":"","sources":["../../src/carbon-aware/carbon-router.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAEtC,OAAO,EAAE,qBAAqB,EAA+B,MAAM,8BAA8B,CAAC;AAClG,OAAO,EAAE,aAAa,EAAuB,MAAM,qBAAqB,CAAC;AACzE,OAAO,KAAK,EACV,kBAAkB,EAClB,cAAc,EACd,eAAe,EAEf,WAAW,EACX,UAAU,EACV,eAAe,EAKhB,MAAM,YAAY,CAAC;AAmBpB;;;;;GAKG;AACH,qBAAa,YAAa,SAAQ,YAAY;IAC5C,OAAO,CAAC,OAAO,CAAwB;IACvC,OAAO,CAAC,QAAQ,CAAgB;IAChC,OAAO,CAAC,mBAAmB,CAAqB;IAChD,OAAO,CAAC,qBAAqB,CAA2C;IACxE,OAAO,CAAC,gBAAgB,CAA2B;IACnD,OAAO,CAAC,gBAAgB,CAA2B;IACnD,OAAO,CAAC,cAAc,CAAU;gBAEpB,MAAM,GAAE,kBAAuB;IAsB3C;;OAEG;IACH,IAAI,MAAM,IAAI,qBAAqB,CAElC;IAED;;OAEG;IACH,IAAI,OAAO,IAAI,aAAa,CAE3B;IAED;;OAEG;IACG,KAAK,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC;IAsE9D;;OAEG;IACG,oBAAoB,CACxB,MAAM,EAAE,WAAW,EACnB,kBAAkB,CAAC,EAAE,UAAU,EAAE,GAChC,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC;IA0BlC;;OAEG;IACG,oBAAoB,IAAI,OAAO,CAAC,GAAG,CAAC,WAAW,EAAE,eAAe,CAAC,CAAC;IAIxE;;OAEG;IACG,eAAe,CAAC,KAAK,GAAE,MAAU,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAIpE;;OAEG;IACG,aAAa,CAAC,MAAM,EAAE,WAAW,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAMjF;;OAEG;IACH,0BAA0B,CAAC,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,UAAU,EAAE,SAAS,EAAE,OAAO,GAAG,IAAI;IAW/F;;OAEG;IACH,YAAY,CAAC,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM;IAO3D;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAO5B;;OAEG;YACW,eAAe;IAiC7B;;OAEG;YACW,aAAa;IAoC3B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAsEzB;;OAEG;IACH,OAAO,CAAC,eAAe;IA0BvB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAU1B;;OAEG;IACH,OAAO,CAAC,yBAAyB;IAiBjC;;OAEG;IACH,OAAO,CAAC,eAAe;CAexB;AAcD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,CAAC,EAAE,kBAAkB,GAAG,YAAY,CAE5E"}