@vorionsys/a3i 0.1.0

package/dist/trust/trust-calculator.d.ts

@@ -0,0 +1,111 @@
+/**
+ * TrustCalculator Class - Core trust scoring engine
+ *
+ * Provides a stateful calculator for computing and managing
+ * trust scores with proper evidence handling and decay.
+ *
+ * Uses the 16-factor trust model where each factor is scored 0.0-1.0
+ * and the composite score is the average of all factor scores x 1000.
+ */
+import type { TrustProfile, TrustFactorScores, TrustEvidence, ObservationTier, BandingConfig, EvidenceType } from '@vorionsys/contracts';
+import { HysteresisCalculator } from '../banding/hysteresis.js';
+/**
+ * Configuration for the TrustCalculator
+ */
+export interface TrustCalculatorConfig {
+    /** Banding configuration */
+    bandingConfig?: Partial<BandingConfig>;
+    /** Enable time decay */
+    enableDecay?: boolean;
+    /** Decay rate per day (0.0 to 1.0) */
+    decayRate?: number;
+    /** Maximum age of evidence in days before it's ignored */
+    maxEvidenceAgeDays?: number;
+    /**
+     * Enable evidence type weighting
+     * HITL approvals weighted 5x, examinations 3x, etc.
+     * @default true
+     */
+    enableEvidenceTypeWeighting?: boolean;
+    /**
+     * Custom evidence type multipliers
+     * Override default EVIDENCE_TYPE_MULTIPLIERS
+     */
+    evidenceTypeMultipliers?: Partial<Record<EvidenceType, number>>;
+}
+/**
+ * Options for a single calculation
+ */
+export interface CalculateOptions {
+    /** Override decay setting for this calculation */
+    applyDecay?: boolean;
+    /** Current time (for testing) */
+    now?: Date;
+}
+/**
+ * Result of evidence aggregation
+ */
+export interface AggregationResult {
+    factorScores: TrustFactorScores;
+    validEvidenceCount: number;
+    expiredEvidenceCount: number;
+    oldestEvidence: Date | null;
+    newestEvidence: Date | null;
+}
+/**
+ * TrustCalculator - Main trust scoring engine
+ */
+export declare class TrustCalculator {
+    private readonly config;
+    private readonly hysteresisCalculator;
+    private readonly evidenceMultipliers;
+    constructor(config?: TrustCalculatorConfig);
+    /**
+     * Calculate a new trust profile from evidence
+     */
+    calculate(agentId: string, observationTier: ObservationTier, evidence: TrustEvidence[], options?: CalculateOptions): TrustProfile;
+    /**
+     * Recalculate an existing profile with new evidence
+     */
+    recalculate(existingProfile: TrustProfile, newEvidence: TrustEvidence[], options?: CalculateOptions): TrustProfile;
+    /**
+     * Apply time decay to a profile without new evidence
+     */
+    applyDecay(profile: TrustProfile, options?: {
+        now?: Date;
+    }): TrustProfile;
+    /**
+     * Compute the composite score from factor scores.
+     * Composite = average of all factor scores x 1000.
+     */
+    computeCompositeScore(factorScores: TrustFactorScores): number;
+    /**
+     * Apply observation tier ceiling to a score
+     */
+    applyCeiling(score: number, tier: ObservationTier): number;
+    /**
+     * Aggregate evidence into factor scores
+     */
+    aggregateEvidence(evidence: TrustEvidence[], now?: Date, applyDecay?: boolean): AggregationResult;
+    /**
+     * Compute factor scores from impact arrays
+     */
+    private computeFactorScoresFromImpacts;
+    /**
+     * Validate factor score values
+     */
+    private validateFactorScores;
+    /**
+     * Get the calculator configuration
+     */
+    getConfig(): Readonly<Required<TrustCalculatorConfig>>;
+    /**
+     * Get the hysteresis calculator
+     */
+    getHysteresisCalculator(): HysteresisCalculator;
+}
+/**
+ * Create a TrustCalculator with default configuration
+ */
+export declare function createTrustCalculator(config?: TrustCalculatorConfig): TrustCalculator;
+//# sourceMappingURL=trust-calculator.d.ts.map

package/dist/trust/trust-calculator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trust-calculator.d.ts","sourceRoot":"","sources":["../../src/trust/trust-calculator.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EACV,YAAY,EACZ,iBAAiB,EACjB,aAAa,EACb,eAAe,EACf,aAAa,EACb,YAAY,EACb,MAAM,sBAAsB,CAAC;AAO9B,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AA8BhE;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,4BAA4B;IAC5B,aAAa,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;IACvC,wBAAwB;IACxB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,sCAAsC;IACtC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,0DAA0D;IAC1D,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B;;;;OAIG;IACH,2BAA2B,CAAC,EAAE,OAAO,CAAC;IACtC;;;OAGG;IACH,uBAAuB,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC,CAAC;CACjE;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,kDAAkD;IAClD,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,iCAAiC;IACjC,GAAG,CAAC,EAAE,IAAI,CAAC;CACZ;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,YAAY,EAAE,iBAAiB,CAAC;IAChC,kBAAkB,EAAE,MAAM,CAAC;IAC3B,oBAAoB,EAAE,MAAM,CAAC;IAC7B,cAAc,EAAE,IAAI,GAAG,IAAI,CAAC;IAC5B,cAAc,EAAE,IAAI,GAAG,IAAI,CAAC;CAC7B;AAED;;GAEG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkC;IACzD,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAuB;IAC5D,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAA+B;gBAEvD,MAAM,GAAE,qBAA0B;IAmB9C;;OAEG;IACH,SAAS,CACP,OAAO,EAAE,MAAM,EACf,eAAe,EAAE,eAAe,EAChC,QAAQ,EAAE,aAAa,EAAE,EACzB,OAAO,GAAE,gBAAqB,GAC7B,YAAY;IA+Bf;;OAEG;IACH,WAAW,CACT,eAAe,EAAE,YAAY,EAC7B,WAAW,EAAE,aAAa,EAAE,EAC5B,OAAO,GAAE,gBAAqB,GAC7B,YAAY;IAoCf;;OAEG;IACH,UAAU,CACR,OAAO,EAAE,YAAY,EACrB,OAAO,GAAE;QAAE,GAAG,CAAC,EAAE,IAAI,CAAA;KAAO,GAC3B,YAAY;IA4Bf;;;OAGG;IACH,qBAAqB,CACnB,YAAY,EAAE,iBAAiB,GAC9B,MAAM;IAaT;;OAEG;IACH,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,eAAe,GAAG,MAAM;IAK1D;;OAEG;IACH,iBAAiB,CACf,QAAQ,EAAE,aAAa,EAAE,EACzB,GAAG,GAAE,IAAiB,EACtB,UAAU,GAAE,OAAc,GACzB,iBAAiB;IAoEpB;;OAEG;IACH,OAAO,CAAC,8BAA8B;IAmBtC;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAW5B;;OAEG;IACH,SAAS,IAAI,QAAQ,CAAC,QAAQ,CAAC,qBAAqB,CAAC,CAAC;IAItD;;OAEG;IACH,uBAAuB,IAAI,oBAAoB;CAGhD;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,CAAC,EAAE,qBAAqB,GAC7B,eAAe,CAEjB"}

package/dist/trust/trust-calculator.js

@@ -0,0 +1,271 @@
+/**
+ * TrustCalculator Class - Core trust scoring engine
+ *
+ * Provides a stateful calculator for computing and managing
+ * trust scores with proper evidence handling and decay.
+ *
+ * Uses the 16-factor trust model where each factor is scored 0.0-1.0
+ * and the composite score is the average of all factor scores x 1000.
+ */
+import { v4 as uuidv4 } from 'uuid';
+import { DEFAULT_BANDING_CONFIG, OBSERVATION_CEILINGS, EVIDENCE_TYPE_MULTIPLIERS, } from '@vorionsys/contracts';
+import { getBand } from '../banding/bands.js';
+import { HysteresisCalculator } from '../banding/hysteresis.js';
+/** Default initial factor score for factors with no evidence (baseline) */
+const INITIAL_FACTOR_SCORE = 0.5;
+/** The 16 core trust factor codes */
+const TRUST_FACTOR_CODES = [
+    'CT-COMP', 'CT-REL', 'CT-OBS', 'CT-TRANS', 'CT-ACCT', 'CT-SAFE',
+    'CT-SEC', 'CT-PRIV', 'CT-ID', 'OP-HUMAN', 'OP-ALIGN', 'OP-CONTEXT',
+    'OP-STEW', 'SF-HUM', 'SF-ADAPT', 'SF-LEARN',
+];
+/**
+ * Create initial factor scores with baseline values for all 16 factors
+ */
+function createInitialFactorScores() {
+    const scores = {};
+    for (const code of TRUST_FACTOR_CODES) {
+        scores[code] = INITIAL_FACTOR_SCORE;
+    }
+    return scores;
+}
+/**
+ * Clamp a factor score to valid range [0.0, 1.0]
+ */
+function clampFactorScore(score) {
+    return Math.max(0.0, Math.min(1.0, score));
+}
+/**
+ * TrustCalculator - Main trust scoring engine
+ */
+export class TrustCalculator {
+    config;
+    hysteresisCalculator;
+    evidenceMultipliers;
+    constructor(config = {}) {
+        this.config = {
+            bandingConfig: { ...DEFAULT_BANDING_CONFIG, ...config.bandingConfig },
+            enableDecay: config.enableDecay ?? true,
+            decayRate: config.decayRate ?? DEFAULT_BANDING_CONFIG.decayRate,
+            maxEvidenceAgeDays: config.maxEvidenceAgeDays ?? 365,
+            enableEvidenceTypeWeighting: config.enableEvidenceTypeWeighting ?? true,
+            evidenceTypeMultipliers: config.evidenceTypeMultipliers ?? {},
+        };
+        // Merge custom multipliers with defaults
+        this.evidenceMultipliers = {
+            ...EVIDENCE_TYPE_MULTIPLIERS,
+            ...this.config.evidenceTypeMultipliers,
+        };
+        this.hysteresisCalculator = new HysteresisCalculator(this.config.bandingConfig);
+    }
+    /**
+     * Calculate a new trust profile from evidence
+     */
+    calculate(agentId, observationTier, evidence, options = {}) {
+        const now = options.now ?? new Date();
+        const applyDecay = options.applyDecay ?? this.config.enableDecay;
+        // Aggregate evidence into factor scores
+        const aggregation = this.aggregateEvidence(evidence, now, applyDecay);
+        const factorScores = aggregation.factorScores;
+        // Calculate composite score (average of factor scores x 1000)
+        const compositeScore = this.computeCompositeScore(factorScores);
+        // Apply observation ceiling
+        const adjustedScore = this.applyCeiling(compositeScore, observationTier);
+        // Determine trust band
+        const band = getBand(adjustedScore, this.config.bandingConfig.thresholds);
+        return {
+            profileId: uuidv4(),
+            agentId,
+            factorScores,
+            compositeScore,
+            observationTier,
+            adjustedScore,
+            band,
+            calculatedAt: now,
+            evidence,
+            version: 1,
+        };
+    }
+    /**
+     * Recalculate an existing profile with new evidence
+     */
+    recalculate(existingProfile, newEvidence, options = {}) {
+        const now = options.now ?? new Date();
+        const applyDecay = options.applyDecay ?? this.config.enableDecay;
+        // Combine all evidence
+        const allEvidence = [...existingProfile.evidence, ...newEvidence];
+        // Aggregate with decay
+        const aggregation = this.aggregateEvidence(allEvidence, now, applyDecay);
+        // Calculate new composite score
+        const compositeScore = this.computeCompositeScore(aggregation.factorScores);
+        // Apply observation ceiling
+        const adjustedScore = this.applyCeiling(compositeScore, existingProfile.observationTier);
+        // Calculate new band with hysteresis
+        const band = this.hysteresisCalculator.calculateBandWithHysteresis(existingProfile.band, adjustedScore);
+        return {
+            profileId: uuidv4(),
+            agentId: existingProfile.agentId,
+            factorScores: aggregation.factorScores,
+            compositeScore,
+            observationTier: existingProfile.observationTier,
+            adjustedScore,
+            band,
+            calculatedAt: now,
+            evidence: allEvidence,
+            version: existingProfile.version + 1,
+        };
+    }
+    /**
+     * Apply time decay to a profile without new evidence
+     */
+    applyDecay(profile, options = {}) {
+        const now = options.now ?? new Date();
+        // Re-aggregate with decay
+        const aggregation = this.aggregateEvidence(profile.evidence, now, true);
+        // Recalculate scores
+        const compositeScore = this.computeCompositeScore(aggregation.factorScores);
+        const adjustedScore = this.applyCeiling(compositeScore, profile.observationTier);
+        // Apply hysteresis for band changes
+        const band = this.hysteresisCalculator.calculateBandWithHysteresis(profile.band, adjustedScore);
+        return {
+            ...profile,
+            profileId: uuidv4(),
+            factorScores: aggregation.factorScores,
+            compositeScore,
+            adjustedScore,
+            band,
+            calculatedAt: now,
+            version: profile.version + 1,
+        };
+    }
+    /**
+     * Compute the composite score from factor scores.
+     * Composite = average of all factor scores x 1000.
+     */
+    computeCompositeScore(factorScores) {
+        // Validate factor scores
+        this.validateFactorScores(factorScores);
+        const values = Object.values(factorScores);
+        if (values.length === 0)
+            return 0;
+        const average = values.reduce((a, b) => a + b, 0) / values.length;
+        // Round to 2 decimal places
+        return Math.round(average * 1000 * 100) / 100;
+    }
+    /**
+     * Apply observation tier ceiling to a score
+     */
+    applyCeiling(score, tier) {
+        const ceiling = OBSERVATION_CEILINGS[tier];
+        return Math.min(score, ceiling);
+    }
+    /**
+     * Aggregate evidence into factor scores
+     */
+    aggregateEvidence(evidence, now = new Date(), applyDecay = true) {
+        // Collect impacts per factor code
+        const factorImpacts = {};
+        let validCount = 0;
+        let expiredCount = 0;
+        let oldestEvidence = null;
+        let newestEvidence = null;
+        const maxAge = this.config.maxEvidenceAgeDays * 24 * 60 * 60 * 1000;
+        for (const ev of evidence) {
+            // Skip expired evidence
+            if (ev.expiresAt && ev.expiresAt < now) {
+                expiredCount++;
+                continue;
+            }
+            // Skip evidence older than max age
+            const age = now.getTime() - ev.collectedAt.getTime();
+            if (age > maxAge) {
+                expiredCount++;
+                continue;
+            }
+            // Calculate impact with optional decay
+            let impact = ev.impact;
+            if (applyDecay) {
+                const daysSinceCollection = age / (1000 * 60 * 60 * 24);
+                const decayFactor = Math.pow(1 - this.config.decayRate, daysSinceCollection);
+                impact = ev.impact * decayFactor;
+            }
+            // Apply evidence type multiplier if enabled
+            // HITL approvals are weighted 5x to solve cold-start problem
+            if (this.config.enableEvidenceTypeWeighting) {
+                const evidenceType = ev.evidenceType ?? 'automated';
+                const multiplier = this.evidenceMultipliers[evidenceType] ?? 1.0;
+                impact = impact * multiplier;
+            }
+            if (!factorImpacts[ev.factorCode]) {
+                factorImpacts[ev.factorCode] = [];
+            }
+            factorImpacts[ev.factorCode].push(impact);
+            validCount++;
+            // Track date range
+            if (!oldestEvidence || ev.collectedAt < oldestEvidence) {
+                oldestEvidence = ev.collectedAt;
+            }
+            if (!newestEvidence || ev.collectedAt > newestEvidence) {
+                newestEvidence = ev.collectedAt;
+            }
+        }
+        // Calculate final factor scores from impacts
+        const factorScores = this.computeFactorScoresFromImpacts(factorImpacts);
+        return {
+            factorScores,
+            validEvidenceCount: validCount,
+            expiredEvidenceCount: expiredCount,
+            oldestEvidence,
+            newestEvidence,
+        };
+    }
+    /**
+     * Compute factor scores from impact arrays
+     */
+    computeFactorScoresFromImpacts(impacts) {
+        const factorScores = createInitialFactorScores();
+        for (const [factorCode, factorImpacts] of Object.entries(impacts)) {
+            if (factorImpacts.length > 0) {
+                // Use average of impacts
+                const avgImpact = factorImpacts.reduce((a, b) => a + b, 0) / factorImpacts.length;
+                // Impacts are on -1000 to +1000 scale; factor scores are 0.0-1.0
+                // Convert impact to factor score delta: impact / 1000
+                const baseline = factorScores[factorCode] ?? INITIAL_FACTOR_SCORE;
+                factorScores[factorCode] = clampFactorScore(baseline + avgImpact / 1000);
+            }
+        }
+        return factorScores;
+    }
+    /**
+     * Validate factor score values
+     */
+    validateFactorScores(factorScores) {
+        for (const [key, value] of Object.entries(factorScores)) {
+            if (typeof value !== 'number' || isNaN(value)) {
+                throw new Error(`Invalid factor score value for ${key}: ${value}`);
+            }
+            if (value < 0.0 || value > 1.0) {
+                throw new Error(`Factor score ${key} out of range [0.0, 1.0]: ${value}`);
+            }
+        }
+    }
+    /**
+     * Get the calculator configuration
+     */
+    getConfig() {
+        return { ...this.config };
+    }
+    /**
+     * Get the hysteresis calculator
+     */
+    getHysteresisCalculator() {
+        return this.hysteresisCalculator;
+    }
+}
+/**
+ * Create a TrustCalculator with default configuration
+ */
+export function createTrustCalculator(config) {
+    return new TrustCalculator(config);
+}
+//# sourceMappingURL=trust-calculator.js.map

package/dist/trust/trust-calculator.js.map

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

package/dist/trust/trust-dynamics.d.ts

@@ -0,0 +1,152 @@
+/**
+ * Trust Dynamics - Asymmetric trust updates per ATSF v2.0
+ *
+ * Implements:
+ * - Logarithmic gain (slow trust building)
+ * - Exponential loss (fast trust loss, 10:1 ratio)
+ * - Cooldown periods (7 days after any trust drop)
+ * - Oscillation detection (circuit breaker trigger)
+ *
+ * Key principle: "Trust is hard to gain, easy to lose"
+ */
+import { type TrustDynamicsConfig, type TrustDynamicsState, type CooldownState } from '@vorionsys/contracts';
+/**
+ * Result of a trust update operation
+ */
+export interface TrustUpdateResult {
+    /** New trust score after update */
+    newScore: number;
+    /** Delta applied (can be 0 if blocked by cooldown) */
+    delta: number;
+    /** Whether the update was blocked by cooldown */
+    blockedByCooldown: boolean;
+    /** Whether this triggered a circuit breaker */
+    circuitBreakerTripped: boolean;
+    /** Reason for circuit breaker if tripped */
+    circuitBreakerReason?: string;
+    /** Whether oscillation was detected */
+    oscillationDetected: boolean;
+    /** Updated dynamics state */
+    state: TrustDynamicsState;
+}
+/**
+ * Options for trust update
+ */
+export interface TrustUpdateOptions {
+    /** Current trust score (0-100) */
+    currentScore: number;
+    /** Whether the observation was successful */
+    success: boolean;
+    /** Trust ceiling based on observation tier (0-100) */
+    ceiling: number;
+    /** Magnitude of the outcome (for weighted updates) */
+    magnitude?: number;
+    /** Whether this is an outcome reversal (provisional success → final failure) */
+    isReversal?: boolean;
+    /** Current time (for testing) */
+    now?: Date;
+}
+/**
+ * TrustDynamicsEngine - Implements asymmetric trust scoring
+ */
+export declare class TrustDynamicsEngine {
+    private readonly config;
+    private readonly states;
+    constructor(config?: Partial<TrustDynamicsConfig>);
+    /**
+     * Get or create dynamics state for an agent
+     */
+    getState(agentId: string): TrustDynamicsState;
+    /**
+     * Create initial dynamics state for a new agent
+     */
+    private createInitialState;
+    /**
+     * Update trust score with asymmetric dynamics
+     *
+     * Gain: delta = gainRate * log(1 + (ceiling - current))
+     * Loss: delta = -lossRate * current
+     *
+     * Gain is blocked during cooldown period.
+     * Circuit breaker trips on oscillation or low trust.
+     */
+    updateTrust(agentId: string, options: TrustUpdateOptions): TrustUpdateResult;
+    /**
+     * Calculate trust gain using logarithmic formula
+     * delta = gainRate * log(1 + (ceiling - current))
+     *
+     * This creates diminishing returns as trust approaches ceiling
+     */
+    private calculateGain;
+    /**
+     * Calculate trust loss using exponential formula
+     * delta = -lossRate * current
+     *
+     * This creates proportional loss - higher trust means bigger absolute drop
+     */
+    private calculateLoss;
+    /**
+     * Update cooldown state based on current time
+     */
+    private updateCooldownState;
+    /**
+     * Start a cooldown period
+     */
+    private startCooldown;
+    /**
+     * Track direction changes for oscillation detection
+     * Returns true if oscillation threshold is exceeded
+     */
+    private trackDirectionChange;
+    /**
+     * Trip the circuit breaker
+     */
+    private tripCircuitBreaker;
+    /**
+     * Reset circuit breaker (requires admin action)
+     */
+    resetCircuitBreaker(agentId: string, adminOverride?: boolean): boolean;
+    /**
+     * Check if agent is in cooldown
+     */
+    isInCooldown(agentId: string, now?: Date): boolean;
+    /**
+     * Check if circuit breaker is tripped
+     */
+    isCircuitBreakerTripped(agentId: string): boolean;
+    /**
+     * Get cooldown info for an agent
+     */
+    getCooldownInfo(agentId: string, now?: Date): CooldownState;
+    /**
+     * Get time remaining in cooldown (in hours)
+     */
+    getCooldownRemainingHours(agentId: string, now?: Date): number;
+    /**
+     * Apply time-based decay to a trust score
+     *
+     * Decay formula: score * (1 - decayRate)^days
+     */
+    applyDecay(currentScore: number, daysSinceUpdate: number, decayRate?: number): number;
+    /**
+     * Calculate asymmetry ratio (loss rate / gain rate)
+     */
+    getAsymmetryRatio(): number;
+    /**
+     * Get the current configuration
+     */
+    getConfig(): Readonly<TrustDynamicsConfig>;
+    /**
+     * Clamp a score within bounds
+     */
+    private clampScore;
+    /**
+     * Clear all state (for testing)
+     */
+    clearAllState(): void;
+}
+/**
+ * Create a trust dynamics engine with default configuration
+ */
+export declare function createTrustDynamicsEngine(config?: Partial<TrustDynamicsConfig>): TrustDynamicsEngine;
+//# sourceMappingURL=trust-dynamics.d.ts.map

package/dist/trust/trust-dynamics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trust-dynamics.d.ts","sourceRoot":"","sources":["../../src/trust/trust-dynamics.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EACL,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,KAAK,aAAa,EAEnB,MAAM,sBAAsB,CAAC;AAE9B;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,mCAAmC;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,sDAAsD;IACtD,KAAK,EAAE,MAAM,CAAC;IACd,iDAAiD;IACjD,iBAAiB,EAAE,OAAO,CAAC;IAC3B,+CAA+C;IAC/C,qBAAqB,EAAE,OAAO,CAAC;IAC/B,4CAA4C;IAC5C,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,uCAAuC;IACvC,mBAAmB,EAAE,OAAO,CAAC;IAC7B,6BAA6B;IAC7B,KAAK,EAAE,kBAAkB,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,kCAAkC;IAClC,YAAY,EAAE,MAAM,CAAC;IACrB,6CAA6C;IAC7C,OAAO,EAAE,OAAO,CAAC;IACjB,sDAAsD;IACtD,OAAO,EAAE,MAAM,CAAC;IAChB,sDAAsD;IACtD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gFAAgF;IAChF,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,iCAAiC;IACjC,GAAG,CAAC,EAAE,IAAI,CAAC;CACZ;AAED;;GAEG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAsB;IAC7C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA8C;gBAEzD,MAAM,GAAE,OAAO,CAAC,mBAAmB,CAAM;IAIrD;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,kBAAkB;IAS7C;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAU1B;;;;;;;;OAQG;IACH,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,kBAAkB,GAAG,iBAAiB;IA4E5E;;;;;OAKG;IACH,OAAO,CAAC,aAAa;IAMrB;;;;;OAKG;IACH,OAAO,CAAC,aAAa;IAYrB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAS3B;;OAEG;IACH,OAAO,CAAC,aAAa;IAUrB;;;OAGG;IACH,OAAO,CAAC,oBAAoB;IA2B5B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAM1B;;OAEG;IACH,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,aAAa,GAAE,OAAe,GAAG,OAAO;IAuB7E;;OAEG;IACH,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,GAAE,IAAiB,GAAG,OAAO;IAQ9D;;OAEG;IACH,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAKjD;;OAEG;IACH,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,GAAE,IAAiB,GAAG,aAAa;IAQvE;;OAEG;IACH,yBAAyB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,GAAE,IAAiB,GAAG,MAAM;IAa1E;;;;OAIG;IACH,UAAU,CAAC,YAAY,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM;IAMrF;;OAEG;IACH,iBAAiB,IAAI,MAAM;IAI3B;;OAEG;IACH,SAAS,IAAI,QAAQ,CAAC,mBAAmB,CAAC;IAI1C;;OAEG;IACH,OAAO,CAAC,UAAU;IAIlB;;OAEG;IACH,aAAa,IAAI,IAAI;CAGtB;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC,GACpC,mBAAmB,CAErB"}