@vorionsys/a3i 0.1.0

package/dist/orchestrator/proof-plane-adapter.js

@@ -0,0 +1,78 @@
+/**
+ * ProofPlane Adapter - Implements OrchestratorLogger for ProofPlane
+ *
+ * This adapter bridges the Orchestrator with Vorion's ProofPlane,
+ * logging all orchestration events to the immutable audit trail.
+ */
+import { createHash } from 'crypto';
+/**
+ * Hash a result for the audit trail
+ */
+function hashResult(result) {
+    const str = JSON.stringify(result ?? null);
+    return createHash('sha256').update(str).digest('hex').substring(0, 16);
+}
+/**
+ * ProofPlane adapter implementing OrchestratorLogger
+ */
+export class ProofPlaneAdapter {
+    proofPlane;
+    adapterId;
+    logIntentReceivedEnabled;
+    logDecisionMadeEnabled;
+    logExecutionEventsEnabled;
+    constructor(config) {
+        this.proofPlane = config.proofPlane;
+        this.adapterId = config.adapterId ?? 'a3i-orchestrator';
+        this.logIntentReceivedEnabled = config.logIntentReceived ?? true;
+        this.logDecisionMadeEnabled = config.logDecisionMade ?? true;
+        this.logExecutionEventsEnabled = config.logExecutionEvents ?? true;
+    }
+    /**
+     * Log intent received
+     */
+    async logIntentReceived(intent, correlationId) {
+        if (!this.logIntentReceivedEnabled)
+            return;
+        await this.proofPlane.logIntentReceived(intent, correlationId);
+    }
+    /**
+     * Log decision made
+     */
+    async logDecisionMade(decision, _intent, correlationId) {
+        if (!this.logDecisionMadeEnabled)
+            return;
+        await this.proofPlane.logDecisionMade(decision, correlationId);
+    }
+    /**
+     * Log execution started
+     */
+    async logExecutionStarted(executionId, intent, decision, correlationId) {
+        if (!this.logExecutionEventsEnabled)
+            return;
+        await this.proofPlane.logExecutionStarted(executionId, intent.intentId, decision.decisionId, this.adapterId, intent.agentId, correlationId);
+    }
+    /**
+     * Log execution completed
+     */
+    async logExecutionCompleted(executionId, intent, result, durationMs, correlationId) {
+        if (!this.logExecutionEventsEnabled)
+            return;
+        await this.proofPlane.logExecutionCompleted(executionId, intent.intentId, durationMs, hashResult(result), intent.agentId, correlationId, 'success');
+    }
+    /**
+     * Log execution failed
+     */
+    async logExecutionFailed(executionId, intent, error, durationMs, retryable, correlationId) {
+        if (!this.logExecutionEventsEnabled)
+            return;
+        await this.proofPlane.logExecutionFailed(executionId, intent.intentId, error.message, durationMs, retryable, intent.agentId, correlationId);
+    }
+}
+/**
+ * Create a ProofPlane adapter
+ */
+export function createProofPlaneAdapter(config) {
+    return new ProofPlaneAdapter(config);
+}
+//# sourceMappingURL=proof-plane-adapter.js.map

package/dist/orchestrator/proof-plane-adapter.js.map

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

package/dist/trust/calculator.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Trust Calculator - Core trust scoring engine
+ *
+ * Calculates composite trust scores from factor scores,
+ * applying observation tier ceilings and decay over time.
+ *
+ * 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 } from '@vorionsys/contracts';
+/**
+ * Options for trust calculation
+ */
+export interface CalculationOptions {
+    /** Current time (for decay calculations) */
+    now?: Date;
+    /** Apply time decay to evidence */
+    applyDecay?: boolean;
+    /** Decay rate per day (0.0 to 1.0) */
+    decayRate?: number;
+}
+/**
+ * Result of aggregating evidence into factor scores
+ */
+interface EvidenceAggregation {
+    factorScores: TrustFactorScores;
+    evidenceCount: number;
+    latestEvidence: Date | null;
+}
+/**
+ * Calculate a composite trust score from factor scores.
+ * Composite = average of all factor scores x 1000.
+ */
+export declare function calculateCompositeScore(factorScores: TrustFactorScores): number;
+/**
+ * Apply observation tier ceiling to a score
+ */
+export declare function applyObservationCeiling(score: number, tier: ObservationTier): number;
+/**
+ * Aggregate evidence into factor scores
+ */
+export declare function aggregateEvidence(evidence: TrustEvidence[], options?: CalculationOptions): EvidenceAggregation;
+/**
+ * Calculate a complete trust profile for an agent
+ */
+export declare function calculateTrustProfile(agentId: string, observationTier: ObservationTier, evidence: TrustEvidence[], options?: CalculationOptions): TrustProfile;
+/**
+ * Recalculate trust profile with additional evidence
+ */
+export declare function recalculateProfile(existingProfile: TrustProfile, newEvidence: TrustEvidence[], options?: CalculationOptions): TrustProfile;
+/**
+ * Apply time decay to a profile without adding new evidence
+ */
+export declare function applyDecay(profile: TrustProfile, options?: CalculationOptions): TrustProfile;
+/**
+ * Create evidence for a trust factor
+ */
+export declare function createEvidence(factorCode: string, impact: number, source: string, metadata?: Record<string, unknown>): TrustEvidence;
+export {};
+//# sourceMappingURL=calculator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"calculator.d.ts","sourceRoot":"","sources":["../../src/trust/calculator.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EACV,YAAY,EACZ,iBAAiB,EACjB,aAAa,EACb,eAAe,EAChB,MAAM,sBAAsB,CAAC;AAiB9B;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,4CAA4C;IAC5C,GAAG,CAAC,EAAE,IAAI,CAAC;IACX,mCAAmC;IACnC,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,sCAAsC;IACtC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,UAAU,mBAAmB;IAC3B,YAAY,EAAE,iBAAiB,CAAC;IAChC,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,IAAI,GAAG,IAAI,CAAC;CAC7B;AAoBD;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,YAAY,EAAE,iBAAiB,GAC9B,MAAM,CAOR;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,eAAe,GACpB,MAAM,CAGR;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,aAAa,EAAE,EACzB,OAAO,GAAE,kBAAuB,GAC/B,mBAAmB,CAoDrB;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,MAAM,EACf,eAAe,EAAE,eAAe,EAChC,QAAQ,EAAE,aAAa,EAAE,EACzB,OAAO,GAAE,kBAAuB,GAC/B,YAAY,CA4Bd;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,eAAe,EAAE,YAAY,EAC7B,WAAW,EAAE,aAAa,EAAE,EAC5B,OAAO,GAAE,kBAAuB,GAC/B,YAAY,CAgBd;AAED;;GAEG;AACH,wBAAgB,UAAU,CACxB,OAAO,EAAE,YAAY,EACrB,OAAO,GAAE,kBAAuB,GAC/B,YAAY,CAUd;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACjC,aAAa,CASf"}

package/dist/trust/calculator.js

@@ -0,0 +1,163 @@
+/**
+ * Trust Calculator - Core trust scoring engine
+ *
+ * Calculates composite trust scores from factor scores,
+ * applying observation tier ceilings and decay over time.
+ *
+ * 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 { OBSERVATION_CEILINGS, DEFAULT_BANDING_CONFIG, } from '@vorionsys/contracts';
+import { getBand } from '../banding/bands.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));
+}
+/**
+ * Calculate a composite trust score from factor scores.
+ * Composite = average of all factor scores x 1000.
+ */
+export function calculateCompositeScore(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
+ */
+export function applyObservationCeiling(score, tier) {
+    const ceiling = OBSERVATION_CEILINGS[tier];
+    return Math.min(score, ceiling);
+}
+/**
+ * Aggregate evidence into factor scores
+ */
+export function aggregateEvidence(evidence, options = {}) {
+    const { now = new Date(), applyDecay = true, decayRate = DEFAULT_BANDING_CONFIG.decayRate } = options;
+    // Collect impacts per factor code
+    const factorImpacts = {};
+    let latestEvidence = null;
+    for (const ev of evidence) {
+        // Skip expired evidence
+        if (ev.expiresAt && ev.expiresAt < now) {
+            continue;
+        }
+        // Calculate decay factor if enabled
+        let impact = ev.impact;
+        if (applyDecay) {
+            const daysSinceCollection = Math.max(0, (now.getTime() - ev.collectedAt.getTime()) / (1000 * 60 * 60 * 24));
+            const decayFactor = Math.pow(1 - decayRate, daysSinceCollection);
+            impact = ev.impact * decayFactor;
+        }
+        if (!factorImpacts[ev.factorCode]) {
+            factorImpacts[ev.factorCode] = [];
+        }
+        factorImpacts[ev.factorCode].push(impact);
+        if (!latestEvidence || ev.collectedAt > latestEvidence) {
+            latestEvidence = ev.collectedAt;
+        }
+    }
+    // Start with initial factor scores, then apply averaged impacts
+    const factorScores = createInitialFactorScores();
+    for (const [factorCode, impacts] of Object.entries(factorImpacts)) {
+        if (impacts.length > 0) {
+            const avgImpact = impacts.reduce((a, b) => a + b, 0) / impacts.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,
+        evidenceCount: evidence.length,
+        latestEvidence,
+    };
+}
+/**
+ * Calculate a complete trust profile for an agent
+ */
+export function calculateTrustProfile(agentId, observationTier, evidence, options = {}) {
+    const now = options.now ?? new Date();
+    // Aggregate evidence into factor scores
+    const aggregation = aggregateEvidence(evidence, options);
+    const factorScores = aggregation.factorScores;
+    // Calculate composite score (average of factor scores x 1000)
+    const compositeScore = calculateCompositeScore(factorScores);
+    // Apply observation ceiling
+    const adjustedScore = applyObservationCeiling(compositeScore, observationTier);
+    // Determine trust band
+    const band = getBand(adjustedScore);
+    return {
+        profileId: uuidv4(),
+        agentId,
+        factorScores,
+        compositeScore,
+        observationTier,
+        adjustedScore,
+        band,
+        calculatedAt: now,
+        evidence,
+        version: 1,
+    };
+}
+/**
+ * Recalculate trust profile with additional evidence
+ */
+export function recalculateProfile(existingProfile, newEvidence, options = {}) {
+    // Combine existing and new evidence
+    const allEvidence = [...existingProfile.evidence, ...newEvidence];
+    // Recalculate from scratch
+    const newProfile = calculateTrustProfile(existingProfile.agentId, existingProfile.observationTier, allEvidence, options);
+    return {
+        ...newProfile,
+        version: existingProfile.version + 1,
+    };
+}
+/**
+ * Apply time decay to a profile without adding new evidence
+ */
+export function applyDecay(profile, options = {}) {
+    return calculateTrustProfile(profile.agentId, profile.observationTier, profile.evidence, {
+        ...options,
+        applyDecay: true,
+    });
+}
+/**
+ * Create evidence for a trust factor
+ */
+export function createEvidence(factorCode, impact, source, metadata) {
+    return {
+        evidenceId: uuidv4(),
+        factorCode,
+        impact: Math.max(-1000, Math.min(1000, impact)),
+        source,
+        collectedAt: new Date(),
+        metadata,
+    };
+}
+//# sourceMappingURL=calculator.js.map

package/dist/trust/calculator.js.map

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

package/dist/trust/dimensions.d.ts

@@ -0,0 +1,133 @@
+/**
+ * Trust Factor Scores - The 16-factor trust model
+ *
+ * Replaces the legacy 5-dimension model (CT, BT, GT, XT, AC) with
+ * 16 granular trust factors scored 0.0-1.0.
+ *
+ * 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
+ *
+ * Composite score = average of all factor scores * 1000 (0-1000 scale)
+ */
+import type { TrustFactorScores } from '@vorionsys/contracts';
+/** The 16 core trust factor codes */
+export declare const TRUST_FACTOR_CODES: readonly ["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"];
+/** Initial factor scores for a new agent (neutral starting point, all 0.3) */
+export declare const INITIAL_FACTOR_SCORES: TrustFactorScores;
+/**
+ * @deprecated Use INITIAL_FACTOR_SCORES instead.
+ * Provided for backwards compatibility with code that imports INITIAL_DIMENSIONS.
+ */
+export declare const INITIAL_DIMENSIONS: TrustFactorScores;
+/** Minimum valid factor score */
+export declare const MIN_FACTOR_SCORE = 0;
+/** Maximum valid factor score */
+export declare const MAX_FACTOR_SCORE = 1;
+/**
+ * @deprecated Use MIN_FACTOR_SCORE instead.
+ */
+export declare const MIN_DIMENSION_SCORE = 0;
+/**
+ * @deprecated Use MAX_FACTOR_SCORE instead.
+ */
+export declare const MAX_DIMENSION_SCORE = 1;
+/**
+ * Create a new TrustFactorScores object with validation.
+ * Merges provided scores with initial defaults and clamps all values to [0.0, 1.0].
+ */
+export declare function createFactorScores(partial?: TrustFactorScores): TrustFactorScores;
+/**
+ * @deprecated Use createFactorScores instead.
+ * Provided for backwards compatibility with code that imports createDimensions.
+ */
+export declare const createDimensions: typeof createFactorScores;
+/**
+ * Clamp a factor score to valid range [0.0, 1.0]
+ */
+export declare function clampScore(score: number): number;
+/**
+ * Validate trust factor scores using Zod schema
+ * @throws if validation fails
+ */
+export declare function validateFactorScores(scores: unknown): TrustFactorScores;
+/**
+ * @deprecated Use validateFactorScores instead.
+ */
+export declare const validateDimensions: typeof validateFactorScores;
+/**
+ * Check if factor scores are valid without throwing
+ */
+export declare function isValidFactorScores(scores: unknown): scores is TrustFactorScores;
+/**
+ * @deprecated Use isValidFactorScores instead.
+ */
+export declare const isValidDimensions: typeof isValidFactorScores;
+/**
+ * Get the minimum factor score (weakest link)
+ */
+export declare function getMinFactor(scores: TrustFactorScores): {
+    factor: string;
+    score: number;
+};
+/**
+ * @deprecated Use getMinFactor instead.
+ */
+export declare function getMinDimension(scores: TrustFactorScores): {
+    dimension: string;
+    score: number;
+};
+/**
+ * Get the maximum factor score (strongest area)
+ */
+export declare function getMaxFactor(scores: TrustFactorScores): {
+    factor: string;
+    score: number;
+};
+/**
+ * @deprecated Use getMaxFactor instead.
+ */
+export declare function getMaxDimension(scores: TrustFactorScores): {
+    dimension: string;
+    score: number;
+};
+/**
+ * Calculate factor score delta between two profiles
+ */
+export declare function getFactorDelta(previous: TrustFactorScores, current: TrustFactorScores): TrustFactorScores;
+/**
+ * @deprecated Use getFactorDelta instead.
+ */
+export declare const getDimensionDelta: typeof getFactorDelta;
+/**
+ * Apply adjustments to factor scores
+ */
+export declare function adjustFactorScores(scores: TrustFactorScores, adjustments: Partial<TrustFactorScores>): TrustFactorScores;
+/**
+ * @deprecated Use adjustFactorScores instead.
+ */
+export declare const adjustDimensions: typeof adjustFactorScores;
+/**
+ * Compute composite trust score from factor scores.
+ * Composite = average of all factor scores * 1000 (0-1000 scale).
+ */
+export declare function computeCompositeScore(scores: TrustFactorScores): number;
+/**
+ * Factor descriptions for documentation/UI
+ */
+export declare const FACTOR_DESCRIPTIONS: Record<string, {
+    name: string;
+    code: string;
+    description: string;
+}>;
+/**
+ * @deprecated Use FACTOR_DESCRIPTIONS instead.
+ * Legacy alias for backwards compatibility.
+ */
+export declare const DIMENSION_DESCRIPTIONS: Record<string, {
+    name: string;
+    code: string;
+    description: string;
+}>;
+//# sourceMappingURL=dimensions.d.ts.map

package/dist/trust/dimensions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dimensions.d.ts","sourceRoot":"","sources":["../../src/trust/dimensions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAG9D,qCAAqC;AACrC,eAAO,MAAM,kBAAkB,6LAIrB,CAAC;AAEX,8EAA8E;AAC9E,eAAO,MAAM,qBAAqB,EAAE,iBAEnC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,kBAAkB,EAAE,iBAAyC,CAAC;AAE3E,iCAAiC;AACjC,eAAO,MAAM,gBAAgB,IAAM,CAAC;AAEpC,iCAAiC;AACjC,eAAO,MAAM,gBAAgB,IAAM,CAAC;AAEpC;;GAEG;AACH,eAAO,MAAM,mBAAmB,IAAmB,CAAC;AAEpD;;GAEG;AACH,eAAO,MAAM,mBAAmB,IAAmB,CAAC;AAEpD;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,GAAE,iBAAsB,GAC9B,iBAAiB,CAYnB;AAED;;;GAGG;AACH,eAAO,MAAM,gBAAgB,2BAAqB,CAAC;AAEnD;;GAEG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,OAAO,GAAG,iBAAiB,CAEvE;AAED;;GAEG;AACH,eAAO,MAAM,kBAAkB,6BAAuB,CAAC;AAEvD;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,OAAO,GACd,MAAM,IAAI,iBAAiB,CAE7B;AAED;;GAEG;AACH,eAAO,MAAM,iBAAiB,4BAAsB,CAAC;AAErD;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,iBAAiB,GAAG;IACvD,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf,CAUA;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,iBAAiB,GAAG;IAC1D,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;CACf,CAGA;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,iBAAiB,GAAG;IACvD,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf,CAUA;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,iBAAiB,GAAG;IAC1D,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;CACf,CAGA;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,iBAAiB,EAC3B,OAAO,EAAE,iBAAiB,GACzB,iBAAiB,CAUnB;AAED;;GAEG;AACH,eAAO,MAAM,iBAAiB,uBAAiB,CAAC;AAEhD;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,iBAAiB,EACzB,WAAW,EAAE,OAAO,CAAC,iBAAiB,CAAC,GACtC,iBAAiB,CAQnB;AAED;;GAEG;AACH,eAAO,MAAM,gBAAgB,2BAAqB,CAAC;AAEnD;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,iBAAiB,GAAG,MAAM,CAKvE;AAED;;GAEG;AACH,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE;IAC/C,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACrB,CAiFA,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,sBAAsB;UA1F3B,MAAM;UACN,MAAM;iBACC,MAAM;EAwFoC,CAAC"}