@vorionsys/atsf-core 0.2.4 → 0.3.1

package/dist/paramesphere/fingerprint-monitor.d.ts

@@ -0,0 +1,143 @@
+/**
+ * FingerprintMonitor — Scheduled fingerprinting with automatic alerting.
+ *
+ * Runs fingerprint checks on a configurable interval, emits callbacks on
+ * drift detection, and produces signal-ready objects when tampering is
+ * detected.  Deliberately decoupled from the trust engine — the monitor
+ * detects and reports, it never directly modifies trust scores.
+ *
+ * Key behaviours:
+ * - First check for a given entity establishes its baseline fingerprint.
+ * - Subsequent checks compare against that baseline via
+ *   `ParameSphereEngine.checkDrift()`.
+ * - Drift exceeding `driftThreshold` triggers the `onDriftDetected` callback.
+ * - Drift exceeding `2 × driftThreshold` is classified as *tampering* and
+ *   triggers the `onTamperingDetected` callback.
+ * - When `emitTrustSignal` is true, `MonitorCheckResult` includes a
+ *   signal-ready payload (`trustSignal`) that callers can forward to a
+ *   trust engine without introducing a direct dependency.
+ *
+ * @packageDocumentation
+ */
+import type { ParameSphereFingerprint, DriftResult } from './types.js';
+import type { ParameSphereEngine } from './paramesphere-engine.js';
+/** Configuration for the FingerprintMonitor. */
+export interface FingerprintMonitorConfig {
+    /** ParameSphere engine instance used to compute and compare fingerprints. */
+    engine: ParameSphereEngine;
+    /** Interval between scheduled fingerprint checks, in milliseconds (default: 300 000 = 5 min). */
+    checkIntervalMs?: number;
+    /** Cosine-distance threshold that constitutes drift (default: 0.05). */
+    driftThreshold?: number;
+    /** Called whenever drift is detected. */
+    onDriftDetected?: (entityId: string, result: DriftResult) => void;
+    /** Called each time a fingerprint is successfully computed. */
+    onFingerprintTaken?: (entityId: string, fingerprint: ParameSphereFingerprint) => void;
+    /** Called when drift exceeds 2× threshold (severe — likely tampering). */
+    onTamperingDetected?: (entityId: string, result: DriftResult) => void;
+    /**
+     * When true, `MonitorCheckResult.trustSignal` is populated with a
+     * signal-ready object that consumers can forward to a trust engine.
+     * Default: true.
+     */
+    emitTrustSignal?: boolean;
+}
+/** Result of a single monitor check cycle. */
+export interface MonitorCheckResult {
+    entityId: string;
+    fingerprint: ParameSphereFingerprint;
+    driftDetected: boolean;
+    /** Drift exceeds 2× threshold — severe / likely tampering. */
+    tamperingDetected: boolean;
+    /** Measured cosine distance from baseline (0 on first check). */
+    driftDistance: number;
+    checkedAt: Date;
+    /**
+     * Signal-ready object suitable for forwarding to a trust engine.
+     * Present only when `emitTrustSignal` is enabled AND drift or
+     * tampering was detected.
+     */
+    trustSignal?: TrustSignalPayload;
+}
+/** Lightweight trust signal payload — decoupled from the trust engine's own type. */
+export interface TrustSignalPayload {
+    entityId: string;
+    type: string;
+    value: number;
+    source: string;
+    timestamp: string;
+    metadata: Record<string, unknown>;
+}
+/** Per-entity monitoring status. */
+export interface MonitorStatus {
+    entityId: string;
+    lastCheck: Date | null;
+    checksCompleted: number;
+    driftsDetected: number;
+    tamperingsDetected: number;
+    status: 'monitoring' | 'stopped';
+}
+export declare class FingerprintMonitor {
+    private readonly engine;
+    private readonly checkIntervalMs;
+    private readonly driftThreshold;
+    private readonly emitTrustSignal;
+    private onDriftDetected?;
+    private onFingerprintTaken?;
+    private onTamperingDetected?;
+    private envelopeHealthProvider?;
+    private readonly entities;
+    constructor(config: FingerprintMonitorConfig);
+    /**
+     * Start monitoring an entity's model weights.
+     *
+     * The first scheduled check establishes the baseline fingerprint.
+     * Subsequent checks compare against that baseline.
+     *
+     * @param entityId    Unique identifier for the monitored entity / model.
+     * @param getWeights  Callback that returns the current weight matrices.
+     */
+    startMonitoring(entityId: string, getWeights: () => Float32Array[]): void;
+    /**
+     * Stop monitoring an entity.  Clears the interval and marks status
+     * as `stopped`.  The entity remains in the map so stats are queryable.
+     */
+    stopMonitoring(entityId: string): void;
+    /**
+     * Manually trigger a fingerprint check outside the scheduled interval.
+     */
+    checkNow(entityId: string): Promise<MonitorCheckResult>;
+    /**
+     * Get monitoring status for an entity.
+     */
+    getStatus(entityId: string): MonitorStatus | undefined;
+    /**
+     * List all entity IDs currently registered (monitoring or stopped).
+     */
+    getMonitoredEntities(): string[];
+    /**
+     * Replace the drift-detected callback.  Allows integration layers to
+     * wire callbacks after construction without subclassing.
+     */
+    setOnDriftDetected(cb: ((entityId: string, result: DriftResult) => void) | undefined): void;
+    /**
+     * Replace the tampering-detected callback.
+     */
+    setOnTamperingDetected(cb: ((entityId: string, result: DriftResult) => void) | undefined): void;
+    /**
+     * Replace the fingerprint-taken callback.
+     */
+    setOnFingerprintTaken(cb: ((entityId: string, fingerprint: ParameSphereFingerprint) => void) | undefined): void;
+    /**
+     * Set a provider callback that returns the current envelope health (1.0/0.9/0.7).
+     * Used when computing I(θ) for drift-detected trust signals.
+     * If not set, defaults to 1.0 (healthy).
+     */
+    setEnvelopeHealthProvider(fn: (() => number) | undefined): void;
+    /**
+     * Stop all monitored entities and clear all state.
+     */
+    shutdown(): void;
+    private runCheck;
+}
+//# sourceMappingURL=fingerprint-monitor.d.ts.map

package/dist/paramesphere/fingerprint-monitor.d.ts.map

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

package/dist/paramesphere/fingerprint-monitor.js

@@ -0,0 +1,240 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright 2024-2026 Vorion LLC
+// ---------------------------------------------------------------------------
+// Defaults
+// ---------------------------------------------------------------------------
+const DEFAULT_CHECK_INTERVAL_MS = 300_000; // 5 minutes
+const DEFAULT_DRIFT_THRESHOLD = 0.05;
+const TAMPERING_MULTIPLIER = 2;
+// ---------------------------------------------------------------------------
+// FingerprintMonitor
+// ---------------------------------------------------------------------------
+export class FingerprintMonitor {
+    engine;
+    checkIntervalMs;
+    driftThreshold;
+    emitTrustSignal;
+    onDriftDetected;
+    onFingerprintTaken;
+    onTamperingDetected;
+    envelopeHealthProvider;
+    entities = new Map();
+    constructor(config) {
+        this.engine = config.engine;
+        this.checkIntervalMs = config.checkIntervalMs ?? DEFAULT_CHECK_INTERVAL_MS;
+        this.driftThreshold = config.driftThreshold ?? DEFAULT_DRIFT_THRESHOLD;
+        this.emitTrustSignal = config.emitTrustSignal ?? true;
+        this.onDriftDetected = config.onDriftDetected;
+        this.onFingerprintTaken = config.onFingerprintTaken;
+        this.onTamperingDetected = config.onTamperingDetected;
+    }
+    // -----------------------------------------------------------------------
+    // Public API
+    // -----------------------------------------------------------------------
+    /**
+     * Start monitoring an entity's model weights.
+     *
+     * The first scheduled check establishes the baseline fingerprint.
+     * Subsequent checks compare against that baseline.
+     *
+     * @param entityId    Unique identifier for the monitored entity / model.
+     * @param getWeights  Callback that returns the current weight matrices.
+     */
+    startMonitoring(entityId, getWeights) {
+        // If already monitoring, stop first to avoid orphaned timers
+        if (this.entities.has(entityId)) {
+            this.stopMonitoring(entityId);
+        }
+        const state = {
+            entityId,
+            getWeights,
+            baseline: null,
+            timer: null,
+            checksCompleted: 0,
+            driftsDetected: 0,
+            tamperingsDetected: 0,
+            lastCheck: null,
+            status: 'monitoring',
+        };
+        // Schedule recurring checks
+        state.timer = setInterval(() => {
+            void this.runCheck(state);
+        }, this.checkIntervalMs);
+        this.entities.set(entityId, state);
+    }
+    /**
+     * Stop monitoring an entity.  Clears the interval and marks status
+     * as `stopped`.  The entity remains in the map so stats are queryable.
+     */
+    stopMonitoring(entityId) {
+        const state = this.entities.get(entityId);
+        if (!state)
+            return;
+        if (state.timer !== null) {
+            clearInterval(state.timer);
+            state.timer = null;
+        }
+        state.status = 'stopped';
+    }
+    /**
+     * Manually trigger a fingerprint check outside the scheduled interval.
+     */
+    async checkNow(entityId) {
+        const state = this.entities.get(entityId);
+        if (!state) {
+            throw new Error(`Entity "${entityId}" is not being monitored`);
+        }
+        return this.runCheck(state);
+    }
+    /**
+     * Get monitoring status for an entity.
+     */
+    getStatus(entityId) {
+        const state = this.entities.get(entityId);
+        if (!state)
+            return undefined;
+        return {
+            entityId: state.entityId,
+            lastCheck: state.lastCheck,
+            checksCompleted: state.checksCompleted,
+            driftsDetected: state.driftsDetected,
+            tamperingsDetected: state.tamperingsDetected,
+            status: state.status,
+        };
+    }
+    /**
+     * List all entity IDs currently registered (monitoring or stopped).
+     */
+    getMonitoredEntities() {
+        return Array.from(this.entities.keys());
+    }
+    /**
+     * Replace the drift-detected callback.  Allows integration layers to
+     * wire callbacks after construction without subclassing.
+     */
+    setOnDriftDetected(cb) {
+        this.onDriftDetected = cb;
+    }
+    /**
+     * Replace the tampering-detected callback.
+     */
+    setOnTamperingDetected(cb) {
+        this.onTamperingDetected = cb;
+    }
+    /**
+     * Replace the fingerprint-taken callback.
+     */
+    setOnFingerprintTaken(cb) {
+        this.onFingerprintTaken = cb;
+    }
+    /**
+     * Set a provider callback that returns the current envelope health (1.0/0.9/0.7).
+     * Used when computing I(θ) for drift-detected trust signals.
+     * If not set, defaults to 1.0 (healthy).
+     */
+    setEnvelopeHealthProvider(fn) {
+        this.envelopeHealthProvider = fn;
+    }
+    /**
+     * Stop all monitored entities and clear all state.
+     */
+    shutdown() {
+        for (const [entityId] of this.entities) {
+            this.stopMonitoring(entityId);
+        }
+        this.entities.clear();
+    }
+    // -----------------------------------------------------------------------
+    // Internal
+    // -----------------------------------------------------------------------
+    async runCheck(state) {
+        const weights = state.getWeights();
+        const fingerprint = this.engine.computeFingerprint(weights);
+        const now = new Date();
+        // Notify fingerprint taken
+        this.onFingerprintTaken?.(state.entityId, fingerprint);
+        // First check — establish baseline
+        if (state.baseline === null) {
+            state.baseline = fingerprint;
+            this.engine.setBaseline(fingerprint);
+            state.checksCompleted++;
+            state.lastCheck = now;
+            return {
+                entityId: state.entityId,
+                fingerprint,
+                driftDetected: false,
+                tamperingDetected: false,
+                driftDistance: 0,
+                checkedAt: now,
+            };
+        }
+        // Compare against baseline
+        this.engine.setBaseline(state.baseline);
+        const driftResult = this.engine.checkDrift(fingerprint);
+        const distance = driftResult.cosineDistance;
+        const driftDetected = distance > this.driftThreshold;
+        const tamperingDetected = distance > this.driftThreshold * TAMPERING_MULTIPLIER;
+        // Update stats
+        state.checksCompleted++;
+        state.lastCheck = now;
+        if (driftDetected)
+            state.driftsDetected++;
+        if (tamperingDetected)
+            state.tamperingsDetected++;
+        // Fire callbacks
+        if (driftDetected) {
+            this.onDriftDetected?.(state.entityId, driftResult);
+        }
+        if (tamperingDetected) {
+            this.onTamperingDetected?.(state.entityId, driftResult);
+        }
+        // Build result
+        const result = {
+            entityId: state.entityId,
+            fingerprint,
+            driftDetected,
+            tamperingDetected,
+            driftDistance: distance,
+            checkedAt: now,
+        };
+        // Attach signal-ready payload if enabled and drift was detected
+        if (this.emitTrustSignal && driftDetected) {
+            let signalValue;
+            let integrityMetadata = {};
+            if (tamperingDetected) {
+                // Tampering: always zero trust
+                signalValue = 0.0;
+            }
+            else {
+                // Drift (non-tampering): compute I(θ) for continuous integrity signal
+                const envelopeHealth = this.envelopeHealthProvider ? this.envelopeHealthProvider() : 1.0;
+                const integrity = this.engine.computeIntegrityMultiplier(driftResult, envelopeHealth);
+                signalValue = integrity.composite;
+                integrityMetadata = {
+                    integrityMultiplier: integrity.composite,
+                    fingerprintComponent: integrity.fingerprintComponent,
+                    driftComponent: integrity.driftComponent,
+                    envelopeComponent: integrity.envelopeComponent,
+                };
+            }
+            result.trustSignal = {
+                entityId: state.entityId,
+                type: tamperingDetected ? 'TAMPERING_DETECTED' : 'ANOMALY_DETECTED',
+                value: signalValue,
+                source: 'paramesphere:fingerprint-monitor',
+                timestamp: now.toISOString(),
+                metadata: {
+                    cosineDistance: distance,
+                    maxSingularValueDelta: driftResult.maxSingularValueDelta,
+                    driftThreshold: this.driftThreshold,
+                    tamperingThreshold: this.driftThreshold * TAMPERING_MULTIPLIER,
+                    fingerprintSha256: fingerprint.sha256,
+                    baselineSha256: state.baseline.sha256,
+                    ...integrityMetadata,
+                },
+            };
+        }
+        return result;
+    }
+}
+//# sourceMappingURL=fingerprint-monitor.js.map

package/dist/paramesphere/fingerprint-monitor.js.map

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

package/dist/paramesphere/fingerprint-store.d.ts

@@ -0,0 +1,85 @@
+/**
+ * FingerprintStore — Persistence layer for ParameSphere fingerprints.
+ *
+ * Default: InMemoryFingerprintStore (current behavior, no external deps)
+ * Override: implement the IFingerprintStore interface for SQLite, Postgres,
+ *           Redis, or any other backend.
+ *
+ * @packageDocumentation
+ */
+/**
+ * Serialisable fingerprint record suitable for persistence.
+ *
+ * Unlike `ParameSphereFingerprint` (which carries Float64Array vectors),
+ * `StoredFingerprint` uses plain number arrays so it can be round-tripped
+ * through JSON, SQL columns, or key-value stores without special handling.
+ */
+export interface StoredFingerprint {
+    /** The entity (model / agent) this fingerprint belongs to. */
+    entityId: string;
+    /** SHA-256 hex digest of the composite fingerprint vector. */
+    hash: string;
+    /** Top-K singular values (flattened across sampled layers). */
+    singularValues: number[];
+    /** Optional per-layer activation statistics. */
+    activationStats?: {
+        mean: number;
+        stddev: number;
+        kurtosis: number;
+        skewness: number;
+    }[];
+    /** When the fingerprint was computed. */
+    createdAt: Date;
+    /** Arbitrary metadata (model version, run ID, etc.). */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Persistence interface for ParameSphere fingerprints and baselines.
+ *
+ * Implementations must be async-safe. The engine calls these methods
+ * fire-and-forget for saves and awaits on reads only when needed (e.g.
+ * loading a baseline on the first `checkDrift` call).
+ */
+export interface IFingerprintStore {
+    /** Append a fingerprint to the entity's history. */
+    saveFingerprint(entityId: string, fingerprint: StoredFingerprint): Promise<void>;
+    /** Return the most recently saved fingerprint for an entity, or undefined. */
+    getLatestFingerprint(entityId: string): Promise<StoredFingerprint | undefined>;
+    /** Return the baseline fingerprint for an entity, or undefined. */
+    getBaseline(entityId: string): Promise<StoredFingerprint | undefined>;
+    /** Set (or overwrite) the baseline fingerprint for an entity. */
+    setBaseline(entityId: string, fingerprint: StoredFingerprint): Promise<void>;
+    /** Return the last `limit` fingerprints for an entity, newest first. */
+    getHistory(entityId: string, limit?: number): Promise<StoredFingerprint[]>;
+    /** Remove all fingerprints and baseline for an entity. */
+    deleteEntity(entityId: string): Promise<void>;
+    /** List all entity IDs that have at least one stored fingerprint. */
+    listEntities(): Promise<string[]>;
+}
+/** Options for the in-memory store. */
+export interface InMemoryStoreOptions {
+    /** Maximum fingerprints to retain per entity (default: 100). */
+    maxHistoryPerEntity?: number;
+}
+/**
+ * In-memory implementation of `IFingerprintStore`.
+ *
+ * Suitable for development, testing, and short-lived server processes.
+ * Data does **not** survive a process restart — which is the exact
+ * behaviour this layer is designed to replace when a persistent backend
+ * is plugged in.
+ */
+export declare class InMemoryFingerprintStore implements IFingerprintStore {
+    private readonly maxHistory;
+    private readonly history;
+    private readonly baselines;
+    constructor(options?: InMemoryStoreOptions);
+    saveFingerprint(entityId: string, fingerprint: StoredFingerprint): Promise<void>;
+    getLatestFingerprint(entityId: string): Promise<StoredFingerprint | undefined>;
+    getBaseline(entityId: string): Promise<StoredFingerprint | undefined>;
+    setBaseline(entityId: string, fingerprint: StoredFingerprint): Promise<void>;
+    getHistory(entityId: string, limit?: number): Promise<StoredFingerprint[]>;
+    deleteEntity(entityId: string): Promise<void>;
+    listEntities(): Promise<string[]>;
+}
+//# sourceMappingURL=fingerprint-store.d.ts.map

package/dist/paramesphere/fingerprint-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fingerprint-store.d.ts","sourceRoot":"","sources":["../../src/paramesphere/fingerprint-store.ts"],"names":[],"mappings":"AAGA;;;;;;;;GAQG;AAMH;;;;;;GAMG;AACH,MAAM,WAAW,iBAAiB;IAChC,8DAA8D;IAC9D,QAAQ,EAAE,MAAM,CAAC;IACjB,8DAA8D;IAC9D,IAAI,EAAE,MAAM,CAAC;IACb,+DAA+D;IAC/D,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,gDAAgD;IAChD,eAAe,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACzF,yCAAyC;IACzC,SAAS,EAAE,IAAI,CAAC;IAChB,wDAAwD;IACxD,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAMD;;;;;;GAMG;AACH,MAAM,WAAW,iBAAiB;IAChC,oDAAoD;IACpD,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjF,8EAA8E;IAC9E,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,GAAG,SAAS,CAAC,CAAC;IAE/E,mEAAmE;IACnE,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,GAAG,SAAS,CAAC,CAAC;IAEtE,iEAAiE;IACjE,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE7E,wEAAwE;IACxE,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAAC;IAE3E,0DAA0D;IAC1D,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE9C,qEAAqE;IACrE,YAAY,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;CACnC;AAMD,uCAAuC;AACvC,MAAM,WAAW,oBAAoB;IACnC,gEAAgE;IAChE,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED;;;;;;;GAOG;AACH,qBAAa,wBAAyB,YAAW,iBAAiB;IAChE,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA0C;IAClE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAwC;gBAEtD,OAAO,CAAC,EAAE,oBAAoB;IAIpC,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAahF,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,GAAG,SAAS,CAAC;IAM9E,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,GAAG,SAAS,CAAC;IAIrE,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAI5E,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAW1E,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAK7C,YAAY,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;CAUxC"}

package/dist/paramesphere/fingerprint-store.js

@@ -0,0 +1,68 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright 2024-2026 Vorion LLC
+/**
+ * In-memory implementation of `IFingerprintStore`.
+ *
+ * Suitable for development, testing, and short-lived server processes.
+ * Data does **not** survive a process restart — which is the exact
+ * behaviour this layer is designed to replace when a persistent backend
+ * is plugged in.
+ */
+export class InMemoryFingerprintStore {
+    maxHistory;
+    history = new Map();
+    baselines = new Map();
+    constructor(options) {
+        this.maxHistory = options?.maxHistoryPerEntity ?? 100;
+    }
+    async saveFingerprint(entityId, fingerprint) {
+        let list = this.history.get(entityId);
+        if (!list) {
+            list = [];
+            this.history.set(entityId, list);
+        }
+        list.push(fingerprint);
+        // Trim oldest entries if over capacity
+        while (list.length > this.maxHistory) {
+            list.shift();
+        }
+    }
+    async getLatestFingerprint(entityId) {
+        const list = this.history.get(entityId);
+        if (!list || list.length === 0)
+            return undefined;
+        return list[list.length - 1];
+    }
+    async getBaseline(entityId) {
+        return this.baselines.get(entityId);
+    }
+    async setBaseline(entityId, fingerprint) {
+        this.baselines.set(entityId, fingerprint);
+    }
+    async getHistory(entityId, limit) {
+        const list = this.history.get(entityId);
+        if (!list || list.length === 0)
+            return [];
+        // Return newest first
+        const reversed = [...list].reverse();
+        if (limit !== undefined && limit > 0) {
+            return reversed.slice(0, limit);
+        }
+        return reversed;
+    }
+    async deleteEntity(entityId) {
+        this.history.delete(entityId);
+        this.baselines.delete(entityId);
+    }
+    async listEntities() {
+        const entities = new Set();
+        for (const key of this.history.keys()) {
+            entities.add(key);
+        }
+        for (const key of this.baselines.keys()) {
+            entities.add(key);
+        }
+        return Array.from(entities);
+    }
+}
+//# sourceMappingURL=fingerprint-store.js.map

package/dist/paramesphere/fingerprint-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fingerprint-store.js","sourceRoot":"","sources":["../../src/paramesphere/fingerprint-store.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,iCAAiC;AAkFjC;;;;;;;GAOG;AACH,MAAM,OAAO,wBAAwB;IAClB,UAAU,CAAS;IACnB,OAAO,GAAG,IAAI,GAAG,EAA+B,CAAC;IACjD,SAAS,GAAG,IAAI,GAAG,EAA6B,CAAC;IAElE,YAAY,OAA8B;QACxC,IAAI,CAAC,UAAU,GAAG,OAAO,EAAE,mBAAmB,IAAI,GAAG,CAAC;IACxD,CAAC;IAED,KAAK,CAAC,eAAe,CAAC,QAAgB,EAAE,WAA8B;QACpE,IAAI,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACtC,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,IAAI,GAAG,EAAE,CAAC;YACV,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QACnC,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACvB,uCAAuC;QACvC,OAAO,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;YACrC,IAAI,CAAC,KAAK,EAAE,CAAC;QACf,CAAC;IACH,CAAC;IAED,KAAK,CAAC,oBAAoB,CAAC,QAAgB;QACzC,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACxC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,SAAS,CAAC;QACjD,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC/B,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,QAAgB;QAChC,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACtC,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,QAAgB,EAAE,WAA8B;QAChE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;IAC5C,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,QAAgB,EAAE,KAAc;QAC/C,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACxC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QAC1C,sBAAsB;QACtB,MAAM,QAAQ,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;QACrC,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;YACrC,OAAO,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;QAClC,CAAC;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,QAAgB;QACjC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC9B,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAClC,CAAC;IAED,KAAK,CAAC,YAAY;QAChB,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAU,CAAC;QACnC,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;YACtC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACpB,CAAC;QACD,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,EAAE,CAAC;YACxC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACpB,CAAC;QACD,OAAO,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC9B,CAAC;CACF"}

package/dist/paramesphere/index.d.ts

@@ -0,0 +1,22 @@
+/**
+ * ParameSphere — SVD-Based Model Fingerprinting & Cognitive Envelope
+ *
+ * Production implementation of the patent-specified ParameSphere engine
+ * for detecting model weight drift and cognitive boundary breaches in
+ * AI agent deployments.
+ *
+ * @packageDocumentation
+ */
+export { ParameSphereEngine } from './paramesphere-engine.js';
+export { CognitiveEnvelope } from './cognitive-envelope.js';
+export { FingerprintMonitor } from './fingerprint-monitor.js';
+export { ActivationCollector } from './activation-collector.js';
+export { InMemoryFingerprintStore } from './fingerprint-store.js';
+export { connectMonitorToTrustEngine, disconnectMonitor } from './monitor-integration.js';
+export type { MonitorIntegrationConfig } from './monitor-integration.js';
+export type { ActivationCollectorConfig } from './activation-collector.js';
+export type { FingerprintMonitorConfig, MonitorCheckResult, MonitorStatus, TrustSignalPayload, } from './fingerprint-monitor.js';
+export type { IFingerprintStore, StoredFingerprint, InMemoryStoreOptions, } from './fingerprint-store.js';
+export { DEFAULT_INTEGRITY_WEIGHTS } from './types.js';
+export type { ParameSphereConfig, ParameSphereFingerprint, ActivationStats, FingerprintComparison, DriftResult, EnvelopeConfig, BreachResult, EnvelopeState, DimensionBound, IntegrityMultiplier, IntegrityMultiplierConfig, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/paramesphere/index.ts"],"names":[],"mappings":"AAGA;;;;;;;;GAQG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,EAAE,2BAA2B,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC1F,YAAY,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AACzE,YAAY,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC;AAC3E,YAAY,EACV,wBAAwB,EACxB,kBAAkB,EAClB,aAAa,EACb,kBAAkB,GACnB,MAAM,0BAA0B,CAAC;AAClC,YAAY,EACV,iBAAiB,EACjB,iBAAiB,EACjB,oBAAoB,GACrB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AACvD,YAAY,EACV,kBAAkB,EAClB,uBAAuB,EACvB,eAAe,EACf,qBAAqB,EACrB,WAAW,EACX,cAAc,EACd,YAAY,EACZ,aAAa,EACb,cAAc,EACd,mBAAmB,EACnB,yBAAyB,GAC1B,MAAM,YAAY,CAAC"}

package/dist/paramesphere/index.js

@@ -0,0 +1,19 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright 2024-2026 Vorion LLC
+/**
+ * ParameSphere — SVD-Based Model Fingerprinting & Cognitive Envelope
+ *
+ * Production implementation of the patent-specified ParameSphere engine
+ * for detecting model weight drift and cognitive boundary breaches in
+ * AI agent deployments.
+ *
+ * @packageDocumentation
+ */
+export { ParameSphereEngine } from './paramesphere-engine.js';
+export { CognitiveEnvelope } from './cognitive-envelope.js';
+export { FingerprintMonitor } from './fingerprint-monitor.js';
+export { ActivationCollector } from './activation-collector.js';
+export { InMemoryFingerprintStore } from './fingerprint-store.js';
+export { connectMonitorToTrustEngine, disconnectMonitor } from './monitor-integration.js';
+export { DEFAULT_INTEGRITY_WEIGHTS } from './types.js';
+//# sourceMappingURL=index.js.map

package/dist/paramesphere/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/paramesphere/index.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,iCAAiC;AAEjC;;;;;;;;GAQG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,EAAE,2BAA2B,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAc1F,OAAO,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC"}