@vorionsys/atsf-core 0.2.4 → 0.3.1

package/dist/paramesphere/cognitive-envelope.d.ts

@@ -0,0 +1,117 @@
+/**
+ * Cognitive Envelope — Hyper-Rectangle Breach Detection
+ *
+ * Implements the patent-specified 6-dimensional cognitive envelope that
+ * monitors an AI model's characteristic vector for anomalous deviations.
+ *
+ * The envelope E is defined as the Cartesian product of per-dimension
+ * intervals [mu_d − k·sigma_d, mu_d + k·sigma_d] for d = 1..D.
+ * With k = 3 (99.7% coverage per dimension):
+ * For a single sample, the any-dimension FP rate at k=3 is
+ * 1 - (0.997)^6 ≈ 1.79%. Requiring 3 consecutive breaches gives
+ * ~(0.018)^3 ≈ 5.8e-6 effective FP rate. Per-dimension: (0.003)^3 ≈ 2.7e-8.
+ *
+ * Characteristic vector dimensions (defaults):
+ *   0 — Weight Geometry           (Frobenius norm or spectral norm)
+ *   1 — Activation Clustering     (silhouette coefficient)
+ *   2 — Embedding Drift           (cosine distance from baseline)
+ *   3 — Attention Entropy         (average attention entropy)
+ *   4 — Gradient Norm             (global gradient L2 norm)
+ *   5 — Effective Dimensionality  (participation ratio)
+ *
+ * ## Breach Counter Lifecycle
+ *
+ * The breach counter is the central state variable that drives trust
+ * multiplier decisions. Its lifecycle works as follows:
+ *
+ * 1. **Increment on breach** — Each time `checkBreach()` detects any
+ *    dimension outside the envelope bounds, the counter increments by 1.
+ *
+ * 2. **Decrement on clean check** — Each clean (no-breach) check
+ *    decrements the counter by 1, down to a floor of 0. This means
+ *    recovery is linear: an agent must pass as many clean checks as it
+ *    accumulated breaches.
+ *
+ * 3. **Clamped by `maxBreachCounter`** — The counter is clamped to
+ *    `maxBreachCounter` (default: 100) to prevent unbounded growth
+ *    during sustained attacks. Without this cap, a prolonged attack
+ *    (e.g., thousands of consecutive breaches) would require an equally
+ *    long run of clean checks to recover — effectively locking the agent
+ *    into a breached state forever. The cap ensures recovery time is
+ *    bounded: at most `maxBreachCounter` clean checks to fully recover.
+ *
+ * 4. **`reset()` as the escape valve** — In cases where an operator
+ *    determines the breach state is stale or the underlying cause has
+ *    been resolved (e.g., a model was rolled back to a known-good
+ *    checkpoint), `reset()` zeroes the counter and the rate-limit
+ *    timestamp without clearing the baseline. This allows immediate
+ *    re-evaluation against the same envelope bounds.
+ *
+ * ### Trust multiplier mapping
+ *
+ *   - `counter == 0`                        → 1.0  (normal)
+ *   - `0 < counter < breachThreshold`       → 0.9  (approaching breach)
+ *   - `counter >= breachThreshold`           → 0.7  (full breach)
+ *
+ * @packageDocumentation
+ */
+import type { EnvelopeConfig, BreachResult, EnvelopeState } from './types.js';
+export declare class CognitiveEnvelope {
+    private readonly config;
+    private mu;
+    private sigma;
+    private lowerBounds;
+    private upperBounds;
+    private baselined;
+    private breachCounter;
+    private lastCheckMs;
+    constructor(config?: Partial<EnvelopeConfig>);
+    /**
+     * Establish the envelope baseline from an observation period.
+     *
+     * @param measurements  Array of observation vectors. Each inner array has
+     *                      length equal to `config.dimensions`. At least 2
+     *                      observations are required to compute sigma.
+     */
+    baselineFromObservations(measurements: number[][]): void;
+    /**
+     * Check a current characteristic vector against the envelope.
+     *
+     * Breach counter increments on any-dimension breach and decrements
+     * (towards 0) on a clean check. Trust multiplier is determined by
+     * the counter value relative to the threshold.
+     */
+    checkBreach(currentChars: number[]): BreachResult;
+    /**
+     * Get the current internal state of the envelope.
+     */
+    getState(): EnvelopeState;
+    /**
+     * Reset the breach counter to zero without clearing the baseline.
+     *
+     * This is the manual escape valve for operators. After a sustained attack
+     * drives the breach counter to its maximum, natural recovery requires up
+     * to `maxBreachCounter` consecutive clean checks. When the root cause has
+     * been addressed (e.g., a model rollback or config correction), calling
+     * `reset()` zeroes the counter and the rate-limit timestamp so the next
+     * `checkBreach()` evaluates immediately with a clean slate.
+     *
+     * The baseline (mu, sigma, bounds) is preserved — only the breach
+     * tracking state is cleared. To fully re-baseline, use
+     * {@link clearBaseline} followed by {@link baselineFromObservations}.
+     */
+    reset(): void;
+    /**
+     * Fully clear the baseline and all state.
+     */
+    clearBaseline(): void;
+    /**
+     * Compute the trust multiplier based on breach counter.
+     *
+     * - counter == 0              → 1.0 (normal)
+     * - 0 < counter < threshold   → 0.9 (approaching breach)
+     * - counter >= threshold       → 0.7 (full breach)
+     */
+    private currentTrustMultiplier;
+}
+//# sourceMappingURL=cognitive-envelope.d.ts.map

package/dist/paramesphere/cognitive-envelope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cognitive-envelope.d.ts","sourceRoot":"","sources":["../../src/paramesphere/cognitive-envelope.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwDG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAkB9E,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiB;IAGxC,OAAO,CAAC,EAAE,CAAgB;IAC1B,OAAO,CAAC,KAAK,CAAgB;IAC7B,OAAO,CAAC,WAAW,CAAgB;IACnC,OAAO,CAAC,WAAW,CAAgB;IACnC,OAAO,CAAC,SAAS,CAAS;IAG1B,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,WAAW,CAAK;gBAEZ,MAAM,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC;IAiB5C;;;;;;OAMG;IACH,wBAAwB,CAAC,YAAY,EAAE,MAAM,EAAE,EAAE,GAAG,IAAI;IAuDxD;;;;;;OAMG;IACH,WAAW,CAAC,YAAY,EAAE,MAAM,EAAE,GAAG,YAAY;IAgEjD;;OAEG;IACH,QAAQ,IAAI,aAAa;IAYzB;;;;;;;;;;;;;OAaG;IACH,KAAK,IAAI,IAAI;IAKb;;OAEG;IACH,aAAa,IAAI,IAAI;IAcrB;;;;;;OAMG;IACH,OAAO,CAAC,sBAAsB;CAK/B"}

package/dist/paramesphere/cognitive-envelope.js

@@ -0,0 +1,220 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright 2024-2026 Vorion LLC
+// ---------------------------------------------------------------------------
+// Defaults
+// ---------------------------------------------------------------------------
+const DEFAULT_ENVELOPE_CONFIG = {
+    k: 3.0,
+    breachThreshold: 3,
+    dimensions: 6,
+    measurementIntervalMs: 300_000, // 5 minutes
+    maxBreachCounter: 100, // caps recovery cost; see module docstring § Breach Counter Lifecycle
+};
+// ---------------------------------------------------------------------------
+// CognitiveEnvelope
+// ---------------------------------------------------------------------------
+export class CognitiveEnvelope {
+    config;
+    // Baseline statistics
+    mu = [];
+    sigma = [];
+    lowerBounds = [];
+    upperBounds = [];
+    baselined = false;
+    // Breach tracking
+    breachCounter = 0;
+    lastCheckMs = 0;
+    constructor(config) {
+        this.config = { ...DEFAULT_ENVELOPE_CONFIG, ...config };
+        if (this.config.dimensions < 1) {
+            throw new Error('dimensions must be >= 1');
+        }
+        if (this.config.k <= 0) {
+            throw new Error('k must be > 0');
+        }
+        if (this.config.breachThreshold < 1) {
+            throw new Error('breachThreshold must be >= 1');
+        }
+    }
+    // -----------------------------------------------------------------------
+    // Public API
+    // -----------------------------------------------------------------------
+    /**
+     * Establish the envelope baseline from an observation period.
+     *
+     * @param measurements  Array of observation vectors. Each inner array has
+     *                      length equal to `config.dimensions`. At least 2
+     *                      observations are required to compute sigma.
+     */
+    baselineFromObservations(measurements) {
+        const D = this.config.dimensions;
+        if (measurements.length < 2) {
+            throw new Error('At least 2 observations required to establish a baseline');
+        }
+        for (const m of measurements) {
+            if (m.length !== D) {
+                throw new Error(`Measurement vector length ${m.length} does not match configured dimensions ${D}`);
+            }
+        }
+        const N = measurements.length;
+        this.mu = new Array(D).fill(0);
+        this.sigma = new Array(D).fill(0);
+        // Compute mean
+        for (const m of measurements) {
+            for (let d = 0; d < D; d++) {
+                this.mu[d] += m[d];
+            }
+        }
+        for (let d = 0; d < D; d++) {
+            this.mu[d] /= N;
+        }
+        // Compute sample standard deviation
+        for (const m of measurements) {
+            for (let d = 0; d < D; d++) {
+                const diff = m[d] - this.mu[d];
+                this.sigma[d] += diff * diff;
+            }
+        }
+        for (let d = 0; d < D; d++) {
+            this.sigma[d] = Math.sqrt(this.sigma[d] / (N - 1));
+            // Guard against zero variance: use a tiny epsilon
+            if (this.sigma[d] < 1e-15) {
+                this.sigma[d] = 1e-15;
+            }
+        }
+        // Compute bounds
+        this.lowerBounds = new Array(D);
+        this.upperBounds = new Array(D);
+        for (let d = 0; d < D; d++) {
+            this.lowerBounds[d] = this.mu[d] - this.config.k * this.sigma[d];
+            this.upperBounds[d] = this.mu[d] + this.config.k * this.sigma[d];
+        }
+        this.baselined = true;
+        this.breachCounter = 0;
+    }
+    /**
+     * Check a current characteristic vector against the envelope.
+     *
+     * Breach counter increments on any-dimension breach and decrements
+     * (towards 0) on a clean check. Trust multiplier is determined by
+     * the counter value relative to the threshold.
+     */
+    checkBreach(currentChars) {
+        if (!this.baselined) {
+            throw new Error('Envelope not baselined — call baselineFromObservations() first');
+        }
+        const D = this.config.dimensions;
+        if (currentChars.length !== D) {
+            throw new Error(`Characteristic vector length ${currentChars.length} does not match dimensions ${D}`);
+        }
+        // Rate-limit checks
+        const now = Date.now();
+        if (this.lastCheckMs > 0 && now - this.lastCheckMs < this.config.measurementIntervalMs) {
+            // Return a clean result without modifying state
+            return {
+                breached: this.breachCounter >= this.config.breachThreshold,
+                trustMultiplier: this.currentTrustMultiplier(),
+                breachCounter: this.breachCounter,
+                dimensionBreaches: new Array(D).fill(false),
+                maxDeviation: 0,
+            };
+        }
+        this.lastCheckMs = now;
+        // Per-dimension breach check
+        const dimensionBreaches = new Array(D);
+        let anyBreach = false;
+        let maxDeviation = 0;
+        for (let d = 0; d < D; d++) {
+            const deviation = Math.abs(currentChars[d] - this.mu[d]) / this.sigma[d];
+            if (deviation > maxDeviation)
+                maxDeviation = deviation;
+            const outside = currentChars[d] < this.lowerBounds[d] || currentChars[d] > this.upperBounds[d];
+            dimensionBreaches[d] = outside;
+            if (outside)
+                anyBreach = true;
+        }
+        // Update breach counter
+        if (anyBreach) {
+            this.breachCounter++;
+            // Clamp to maxBreachCounter to cap recovery cost from sustained attacks
+            if (this.breachCounter > this.config.maxBreachCounter) {
+                this.breachCounter = this.config.maxBreachCounter;
+            }
+        }
+        else {
+            // Decrement towards zero on clean check
+            if (this.breachCounter > 0)
+                this.breachCounter--;
+        }
+        const breached = this.breachCounter >= this.config.breachThreshold;
+        return {
+            breached,
+            trustMultiplier: this.currentTrustMultiplier(),
+            breachCounter: this.breachCounter,
+            dimensionBreaches,
+            maxDeviation,
+        };
+    }
+    /**
+     * Get the current internal state of the envelope.
+     */
+    getState() {
+        return {
+            baselined: this.baselined,
+            mu: [...this.mu],
+            sigma: [...this.sigma],
+            breachCounter: this.breachCounter,
+            lastCheckMs: this.lastCheckMs,
+            lowerBounds: [...this.lowerBounds],
+            upperBounds: [...this.upperBounds],
+        };
+    }
+    /**
+     * Reset the breach counter to zero without clearing the baseline.
+     *
+     * This is the manual escape valve for operators. After a sustained attack
+     * drives the breach counter to its maximum, natural recovery requires up
+     * to `maxBreachCounter` consecutive clean checks. When the root cause has
+     * been addressed (e.g., a model rollback or config correction), calling
+     * `reset()` zeroes the counter and the rate-limit timestamp so the next
+     * `checkBreach()` evaluates immediately with a clean slate.
+     *
+     * The baseline (mu, sigma, bounds) is preserved — only the breach
+     * tracking state is cleared. To fully re-baseline, use
+     * {@link clearBaseline} followed by {@link baselineFromObservations}.
+     */
+    reset() {
+        this.breachCounter = 0;
+        this.lastCheckMs = 0;
+    }
+    /**
+     * Fully clear the baseline and all state.
+     */
+    clearBaseline() {
+        this.mu = [];
+        this.sigma = [];
+        this.lowerBounds = [];
+        this.upperBounds = [];
+        this.baselined = false;
+        this.breachCounter = 0;
+        this.lastCheckMs = 0;
+    }
+    // -----------------------------------------------------------------------
+    // Internal
+    // -----------------------------------------------------------------------
+    /**
+     * Compute the trust multiplier based on breach counter.
+     *
+     * - counter == 0              → 1.0 (normal)
+     * - 0 < counter < threshold   → 0.9 (approaching breach)
+     * - counter >= threshold       → 0.7 (full breach)
+     */
+    currentTrustMultiplier() {
+        if (this.breachCounter <= 0)
+            return 1.0;
+        if (this.breachCounter < this.config.breachThreshold)
+            return 0.9;
+        return 0.7;
+    }
+}
+//# sourceMappingURL=cognitive-envelope.js.map

package/dist/paramesphere/cognitive-envelope.js.map

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

package/dist/paramesphere/envelope-integration.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Envelope Integration — Connects CognitiveEnvelope to TrustEngine.
+ *
+ * Thin adapter that periodically runs the envelope's `checkBreach()` against
+ * a caller-supplied dimension vector and, when a breach is detected, records
+ * a trust signal via `TrustEngine.recordSignal()`.
+ *
+ * The monitor runs on an interval (default 60 s) and is fully decoupled:
+ * the envelope decides whether there is a breach, and this module just
+ * translates that into trust signals. Breach history is kept for audit.
+ *
+ * @packageDocumentation
+ */
+import type { CognitiveEnvelope } from './cognitive-envelope.js';
+import type { BreachResult } from './types.js';
+import type { TrustEngine } from '../trust-engine/index.js';
+/** Configuration for the envelope-to-engine integration. */
+export interface EnvelopeIntegrationConfig {
+    /** Interval between automatic breach checks in milliseconds. Default: 60 000 (1 min). */
+    checkIntervalMs?: number;
+    /** Entity ID whose trust score will receive breach signals. */
+    entityId: string;
+    /** Function that returns the current characteristic vector (6 dimensions). */
+    getDimensions: () => number[];
+}
+/** A recorded breach event kept for audit. */
+export interface BreachHistoryEntry {
+    timestamp: string;
+    result: BreachResult;
+    signalId: string;
+}
+/** Handle returned by {@link connectEnvelopeToTrustEngine}. */
+export interface EnvelopeMonitor {
+    /** Stop the interval and release resources. */
+    stop(): void;
+    /** Read-only copy of breach history. */
+    getBreachHistory(): BreachHistoryEntry[];
+    /** Number of checks executed so far. */
+    getCheckCount(): number;
+    /** Whether the monitor interval is currently running. */
+    isRunning(): boolean;
+}
+/**
+ * Wire a CognitiveEnvelope's breach detection to a TrustEngine.
+ *
+ * Starts an interval that calls `envelope.checkBreach(getDimensions())`.
+ * When a breach is detected, a trust signal is recorded with the
+ * `trustMultiplier` as the signal value (0.7 for full breach, 0.9 for
+ * approaching) and metadata describing the breach.
+ *
+ * @returns An {@link EnvelopeMonitor} handle — call `.stop()` to tear down.
+ */
+export declare function connectEnvelopeToTrustEngine(envelope: CognitiveEnvelope, engine: TrustEngine, config: EnvelopeIntegrationConfig): EnvelopeMonitor;
+/**
+ * Stop an EnvelopeMonitor and release its interval.
+ *
+ * Convenience wrapper — equivalent to `monitor.stop()`.
+ */
+export declare function disconnectEnvelope(monitor: EnvelopeMonitor): void;
+//# sourceMappingURL=envelope-integration.d.ts.map

package/dist/paramesphere/envelope-integration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"envelope-integration.d.ts","sourceRoot":"","sources":["../../src/paramesphere/envelope-integration.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAM5D,4DAA4D;AAC5D,MAAM,WAAW,yBAAyB;IACxC,yFAAyF;IACzF,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,+DAA+D;IAC/D,QAAQ,EAAE,MAAM,CAAC;IACjB,8EAA8E;IAC9E,aAAa,EAAE,MAAM,MAAM,EAAE,CAAC;CAC/B;AAED,8CAA8C;AAC9C,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,YAAY,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,+DAA+D;AAC/D,MAAM,WAAW,eAAe;IAC9B,+CAA+C;IAC/C,IAAI,IAAI,IAAI,CAAC;IACb,wCAAwC;IACxC,gBAAgB,IAAI,kBAAkB,EAAE,CAAC;IACzC,wCAAwC;IACxC,aAAa,IAAI,MAAM,CAAC;IACxB,yDAAyD;IACzD,SAAS,IAAI,OAAO,CAAC;CACtB;AAeD;;;;;;;;;GASG;AACH,wBAAgB,4BAA4B,CAC1C,QAAQ,EAAE,iBAAiB,EAC3B,MAAM,EAAE,WAAW,EACnB,MAAM,EAAE,yBAAyB,GAChC,eAAe,CA8FjB;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI,CAEjE"}

package/dist/paramesphere/envelope-integration.js

@@ -0,0 +1,114 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright 2024-2026 Vorion LLC
+// ---------------------------------------------------------------------------
+// Defaults
+// ---------------------------------------------------------------------------
+const DEFAULT_CHECK_INTERVAL_MS = 60_000;
+const SIGNAL_SOURCE = 'cognitive-envelope';
+const SIGNAL_TYPE_BREACH = 'ENVELOPE_BREACH';
+const SIGNAL_TYPE_HEALTH = 'ENVELOPE_HEALTH';
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Wire a CognitiveEnvelope's breach detection to a TrustEngine.
+ *
+ * Starts an interval that calls `envelope.checkBreach(getDimensions())`.
+ * When a breach is detected, a trust signal is recorded with the
+ * `trustMultiplier` as the signal value (0.7 for full breach, 0.9 for
+ * approaching) and metadata describing the breach.
+ *
+ * @returns An {@link EnvelopeMonitor} handle — call `.stop()` to tear down.
+ */
+export function connectEnvelopeToTrustEngine(envelope, engine, config) {
+    if (!config.entityId) {
+        throw new Error('entityId is required');
+    }
+    if (typeof config.getDimensions !== 'function') {
+        throw new Error('getDimensions must be a function');
+    }
+    const intervalMs = config.checkIntervalMs ?? DEFAULT_CHECK_INTERVAL_MS;
+    if (intervalMs <= 0) {
+        throw new Error('checkIntervalMs must be > 0');
+    }
+    const breachHistory = [];
+    let checkCount = 0;
+    let running = true;
+    // The core check function — also exported on the monitor for manual invocation in tests.
+    function runCheck() {
+        const dims = config.getDimensions();
+        const result = envelope.checkBreach(dims);
+        checkCount++;
+        const signalId = `${SIGNAL_SOURCE}-${config.entityId}-${Date.now()}`;
+        const now = new Date().toISOString();
+        if (result.breached) {
+            // Breach: signal value is the continuous trustMultiplier (0.7 or 0.9)
+            const signal = {
+                id: signalId,
+                entityId: config.entityId,
+                type: SIGNAL_TYPE_BREACH,
+                value: result.trustMultiplier,
+                source: SIGNAL_SOURCE,
+                timestamp: now,
+                metadata: {
+                    breachCounter: result.breachCounter,
+                    maxDeviation: result.maxDeviation,
+                    dimensionBreaches: result.dimensionBreaches,
+                    trustMultiplier: result.trustMultiplier,
+                    envelopeHealth: result.trustMultiplier,
+                },
+            };
+            breachHistory.push({
+                timestamp: now,
+                result,
+                signalId,
+            });
+            void engine.recordSignal(signal);
+        }
+        else {
+            // Healthy: emit continuous health signal (value = 1.0)
+            const signal = {
+                id: signalId,
+                entityId: config.entityId,
+                type: SIGNAL_TYPE_HEALTH,
+                value: 1.0,
+                source: SIGNAL_SOURCE,
+                timestamp: now,
+                metadata: {
+                    breachCounter: result.breachCounter,
+                    maxDeviation: result.maxDeviation,
+                    envelopeHealth: 1.0,
+                },
+            };
+            void engine.recordSignal(signal);
+        }
+    }
+    const timer = setInterval(runCheck, intervalMs);
+    const monitor = {
+        stop() {
+            if (!running)
+                return;
+            clearInterval(timer);
+            running = false;
+        },
+        getBreachHistory() {
+            return [...breachHistory];
+        },
+        getCheckCount() {
+            return checkCount;
+        },
+        isRunning() {
+            return running;
+        },
+    };
+    return monitor;
+}
+/**
+ * Stop an EnvelopeMonitor and release its interval.
+ *
+ * Convenience wrapper — equivalent to `monitor.stop()`.
+ */
+export function disconnectEnvelope(monitor) {
+    monitor.stop();
+}
+//# sourceMappingURL=envelope-integration.js.map

package/dist/paramesphere/envelope-integration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"envelope-integration.js","sourceRoot":"","sources":["../../src/paramesphere/envelope-integration.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,iCAAiC;AAqDjC,8EAA8E;AAC9E,WAAW;AACX,8EAA8E;AAE9E,MAAM,yBAAyB,GAAG,MAAM,CAAC;AACzC,MAAM,aAAa,GAAG,oBAAoB,CAAC;AAC3C,MAAM,kBAAkB,GAAG,iBAAiB,CAAC;AAC7C,MAAM,kBAAkB,GAAG,iBAAiB,CAAC;AAE7C,8EAA8E;AAC9E,aAAa;AACb,8EAA8E;AAE9E;;;;;;;;;GASG;AACH,MAAM,UAAU,4BAA4B,CAC1C,QAA2B,EAC3B,MAAmB,EACnB,MAAiC;IAEjC,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;QACrB,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;IAC1C,CAAC;IACD,IAAI,OAAO,MAAM,CAAC,aAAa,KAAK,UAAU,EAAE,CAAC;QAC/C,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;IACtD,CAAC;IAED,MAAM,UAAU,GAAG,MAAM,CAAC,eAAe,IAAI,yBAAyB,CAAC;IACvE,IAAI,UAAU,IAAI,CAAC,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;IACjD,CAAC;IAED,MAAM,aAAa,GAAyB,EAAE,CAAC;IAC/C,IAAI,UAAU,GAAG,CAAC,CAAC;IACnB,IAAI,OAAO,GAAG,IAAI,CAAC;IAEnB,yFAAyF;IACzF,SAAS,QAAQ;QACf,MAAM,IAAI,GAAG,MAAM,CAAC,aAAa,EAAE,CAAC;QACpC,MAAM,MAAM,GAAG,QAAQ,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;QAC1C,UAAU,EAAE,CAAC;QAEb,MAAM,QAAQ,GAAG,GAAG,aAAa,IAAI,MAAM,CAAC,QAAQ,IAAI,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;QACrE,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAErC,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;YACpB,sEAAsE;YACtE,MAAM,MAAM,GAAG;gBACb,EAAE,EAAE,QAAQ;gBACZ,QAAQ,EAAE,MAAM,CAAC,QAAQ;gBACzB,IAAI,EAAE,kBAAkB;gBACxB,KAAK,EAAE,MAAM,CAAC,eAAe;gBAC7B,MAAM,EAAE,aAAa;gBACrB,SAAS,EAAE,GAAG;gBACd,QAAQ,EAAE;oBACR,aAAa,EAAE,MAAM,CAAC,aAAa;oBACnC,YAAY,EAAE,MAAM,CAAC,YAAY;oBACjC,iBAAiB,EAAE,MAAM,CAAC,iBAAiB;oBAC3C,eAAe,EAAE,MAAM,CAAC,eAAe;oBACvC,cAAc,EAAE,MAAM,CAAC,eAAe;iBACvC;aACF,CAAC;YAEF,aAAa,CAAC,IAAI,CAAC;gBACjB,SAAS,EAAE,GAAG;gBACd,MAAM;gBACN,QAAQ;aACT,CAAC,CAAC;YAEH,KAAK,MAAM,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;QACnC,CAAC;aAAM,CAAC;YACN,uDAAuD;YACvD,MAAM,MAAM,GAAG;gBACb,EAAE,EAAE,QAAQ;gBACZ,QAAQ,EAAE,MAAM,CAAC,QAAQ;gBACzB,IAAI,EAAE,kBAAkB;gBACxB,KAAK,EAAE,GAAG;gBACV,MAAM,EAAE,aAAa;gBACrB,SAAS,EAAE,GAAG;gBACd,QAAQ,EAAE;oBACR,aAAa,EAAE,MAAM,CAAC,aAAa;oBACnC,YAAY,EAAE,MAAM,CAAC,YAAY;oBACjC,cAAc,EAAE,GAAG;iBACpB;aACF,CAAC;YAEF,KAAK,MAAM,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;QACnC,CAAC;IACH,CAAC;IAED,MAAM,KAAK,GAAG,WAAW,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;IAEhD,MAAM,OAAO,GAAoB;QAC/B,IAAI;YACF,IAAI,CAAC,OAAO;gBAAE,OAAO;YACrB,aAAa,CAAC,KAAK,CAAC,CAAC;YACrB,OAAO,GAAG,KAAK,CAAC;QAClB,CAAC;QAED,gBAAgB;YACd,OAAO,CAAC,GAAG,aAAa,CAAC,CAAC;QAC5B,CAAC;QAED,aAAa;YACX,OAAO,UAAU,CAAC;QACpB,CAAC;QAED,SAAS;YACP,OAAO,OAAO,CAAC;QACjB,CAAC;KACF,CAAC;IAEF,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAAwB;IACzD,OAAO,CAAC,IAAI,EAAE,CAAC;AACjB,CAAC"}