@vorionsys/atsf-core 0.4.1 → 0.4.3

package/dist/paramesphere/scheduled-verifier.js

@@ -0,0 +1,338 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright 2024-2026 Vorion LLC
+/**
+ * Scheduled ParameSphere Batch Verifier
+ *
+ * Runs I(θ) verification on a configurable schedule instead of on-demand,
+ * designed for 100K-agent fleet operations where per-request SVD computation
+ * is impractical. Verifies agents in priority order (T7 first — highest
+ * blast radius if compromised) with configurable batch size and concurrency.
+ *
+ * Key design choices:
+ *   - Priority queue: T5-T7 first, then T3-T4, then T0-T2
+ *   - I(θ) result cache with configurable TTL (default: 24h)
+ *   - Bounded concurrency via semaphore pattern
+ *   - Event emission for monitoring and alerting pipelines
+ *   - Metrics: verified/sec, avg SVD latency, cache hit rate
+ *
+ * @packageDocumentation
+ */
+import { EventEmitter } from 'node:events';
+const DEFAULT_CONFIG = {
+    verificationInterval: 86_400_000,
+    batchSize: 100,
+    maxConcurrency: 4,
+    priorityTiers: [7, 6, 5, 4, 3, 2, 1, 0],
+    cacheTtlMs: 86_400_000,
+    alertThreshold: 0.7,
+};
+// ---------------------------------------------------------------------------
+// Scheduled ParameSphere Verifier
+// ---------------------------------------------------------------------------
+export class ScheduledParameSphereVerifier extends EventEmitter {
+    config;
+    verifyFn;
+    // ── Agent registry ──────────────────────────────────────────────────
+    agents = new Map();
+    // ── I(θ) cache ──────────────────────────────────────────────────────
+    cache = new Map();
+    // ── Scheduling state ────────────────────────────────────────────────
+    schedulerTimer = null;
+    running = false;
+    lastRun = null;
+    nextRun = null;
+    // ── Metrics ─────────────────────────────────────────────────────────
+    totalVerifications = 0;
+    totalCacheHits = 0;
+    totalCacheMisses = 0;
+    latencyAccumulatorMs = 0;
+    verificationStartTime = 0;
+    lastCycleDurationMs = 0;
+    constructor(verifyFn, config) {
+        super();
+        this.verifyFn = verifyFn;
+        this.config = { ...DEFAULT_CONFIG, ...config };
+    }
+    // -----------------------------------------------------------------------
+    // Agent registration
+    // -----------------------------------------------------------------------
+    /** Register an agent for scheduled verification. */
+    registerAgent(agent) {
+        this.agents.set(agent.agentId, agent);
+    }
+    /** Remove an agent from scheduled verification. */
+    unregisterAgent(agentId) {
+        this.agents.delete(agentId);
+        this.cache.delete(agentId);
+    }
+    /** Get all registered agent IDs. */
+    getRegisteredAgents() {
+        return Array.from(this.agents.keys());
+    }
+    // -----------------------------------------------------------------------
+    // Lifecycle
+    // -----------------------------------------------------------------------
+    /** Start the scheduled verification loop. */
+    start() {
+        if (this.running)
+            return;
+        this.running = true;
+        this.nextRun = new Date(Date.now() + this.config.verificationInterval);
+        this.schedulerTimer = setInterval(() => {
+            this.runFullCycle().catch((err) => {
+                this.emit('error', err);
+            });
+        }, this.config.verificationInterval);
+        // Run immediately on start
+        this.runFullCycle().catch((err) => {
+            this.emit('error', err);
+        });
+    }
+    /** Stop the verifier gracefully. */
+    stop() {
+        this.running = false;
+        if (this.schedulerTimer) {
+            clearInterval(this.schedulerTimer);
+            this.schedulerTimer = null;
+        }
+        this.nextRun = null;
+    }
+    /** Check if the verifier is running. */
+    isRunning() {
+        return this.running;
+    }
+    // -----------------------------------------------------------------------
+    // Verification
+    // -----------------------------------------------------------------------
+    /**
+     * Run a full verification cycle across all agents, ordered by priority tier.
+     */
+    async runFullCycle() {
+        this.verificationStartTime = Date.now();
+        this.emit('verification_started', {
+            totalAgents: this.agents.size,
+            timestamp: new Date(),
+        });
+        const ordered = this.getPriorityOrderedAgents();
+        const allResults = [];
+        // Process in batches
+        for (let i = 0; i < ordered.length; i += this.config.batchSize) {
+            const batch = ordered.slice(i, i + this.config.batchSize);
+            const batchIds = batch.map((a) => a.agentId);
+            const batchResults = await this.verifyBatch(batchIds);
+            allResults.push(...batchResults);
+            this.emit('batch_completed', {
+                batchIndex: Math.floor(i / this.config.batchSize),
+                batchSize: batch.length,
+                resultsCount: batchResults.length,
+            });
+        }
+        this.lastRun = new Date();
+        this.lastCycleDurationMs = Date.now() - this.verificationStartTime;
+        this.nextRun = this.running
+            ? new Date(Date.now() + this.config.verificationInterval)
+            : null;
+        this.emit('verification_completed', {
+            agentsVerified: allResults.length,
+            durationMs: this.lastCycleDurationMs,
+            timestamp: this.lastRun,
+        });
+        return allResults;
+    }
+    /**
+     * Verify a specific batch of agents by ID.
+     * Uses bounded concurrency (semaphore pattern).
+     */
+    async verifyBatch(agentIds) {
+        const results = [];
+        const now = Date.now();
+        // Filter to only agents that need verification (cache miss or expired)
+        const needsVerification = [];
+        for (const id of agentIds) {
+            const cached = this.cache.get(id);
+            if (cached && now - cached.cachedAt < this.config.cacheTtlMs) {
+                // Cache hit
+                this.totalCacheHits++;
+                results.push(cached);
+            }
+            else {
+                this.totalCacheMisses++;
+                needsVerification.push(id);
+            }
+        }
+        // Verify uncached agents with bounded concurrency
+        const pending = [];
+        let activeCount = 0;
+        let resolveSlot = null;
+        const acquireSlot = () => {
+            if (activeCount < this.config.maxConcurrency) {
+                activeCount++;
+                return Promise.resolve();
+            }
+            return new Promise((resolve) => {
+                resolveSlot = resolve;
+            });
+        };
+        const releaseSlot = () => {
+            activeCount--;
+            if (resolveSlot) {
+                const resolve = resolveSlot;
+                resolveSlot = null;
+                activeCount++;
+                resolve();
+            }
+        };
+        // Process with concurrency limit
+        const tasks = needsVerification.map(async (agentId) => {
+            await acquireSlot();
+            try {
+                return await this.verifySingleAgent(agentId);
+            }
+            finally {
+                releaseSlot();
+            }
+        });
+        const taskResults = await Promise.all(tasks);
+        for (const result of taskResults) {
+            if (result) {
+                results.push(result);
+            }
+        }
+        return results;
+    }
+    /**
+     * Get the current verification status.
+     */
+    getVerificationStatus() {
+        const verified = this.totalVerifications;
+        const pending = this.agents.size - this.cache.size;
+        return {
+            lastRun: this.lastRun,
+            nextRun: this.nextRun,
+            agentsVerified: verified,
+            agentsPending: Math.max(0, pending),
+            avgLatencyMs: this.totalVerifications > 0
+                ? this.latencyAccumulatorMs / this.totalVerifications
+                : 0,
+        };
+    }
+    /**
+     * Get metrics snapshot.
+     */
+    getMetrics() {
+        const totalRequests = this.totalCacheHits + this.totalCacheMisses;
+        const cycleDurationSec = this.lastCycleDurationMs / 1_000;
+        return {
+            agentsVerifiedPerSec: cycleDurationSec > 0
+                ? this.totalVerifications / cycleDurationSec
+                : 0,
+            avgSvdLatencyMs: this.totalVerifications > 0
+                ? this.latencyAccumulatorMs / this.totalVerifications
+                : 0,
+            cacheHitRate: totalRequests > 0 ? this.totalCacheHits / totalRequests : 0,
+            totalVerifications: this.totalVerifications,
+            totalCacheHits: this.totalCacheHits,
+            totalCacheMisses: this.totalCacheMisses,
+        };
+    }
+    /**
+     * Get a cached I(θ) result for an agent (if available and not expired).
+     */
+    getCachedResult(agentId) {
+        const cached = this.cache.get(agentId);
+        if (!cached)
+            return null;
+        const now = Date.now();
+        if (now - cached.cachedAt >= this.config.cacheTtlMs) {
+            this.cache.delete(agentId);
+            return null;
+        }
+        return cached;
+    }
+    /**
+     * Invalidate a cached result (forces re-verification on next cycle).
+     */
+    invalidateCache(agentId) {
+        this.cache.delete(agentId);
+    }
+    /**
+     * Clear the entire cache.
+     */
+    clearCache() {
+        this.cache.clear();
+    }
+    // -----------------------------------------------------------------------
+    // Internal
+    // -----------------------------------------------------------------------
+    getPriorityOrderedAgents() {
+        const agentsByTier = new Map();
+        for (const agent of this.agents.values()) {
+            const existing = agentsByTier.get(agent.tier) ?? [];
+            existing.push(agent);
+            agentsByTier.set(agent.tier, existing);
+        }
+        const ordered = [];
+        for (const tier of this.config.priorityTiers) {
+            const agents = agentsByTier.get(tier);
+            if (agents) {
+                ordered.push(...agents);
+            }
+        }
+        // Include any agents whose tier isn't in the priority list
+        for (const agent of this.agents.values()) {
+            if (!this.config.priorityTiers.includes(agent.tier)) {
+                ordered.push(agent);
+            }
+        }
+        return ordered;
+    }
+    async verifySingleAgent(agentId) {
+        const agent = this.agents.get(agentId);
+        if (!agent)
+            return null;
+        const startMs = Date.now();
+        try {
+            const weights = agent.getWeights ? await agent.getWeights() : undefined;
+            const integrity = await this.verifyFn(agentId, weights);
+            const latencyMs = Date.now() - startMs;
+            this.totalVerifications++;
+            this.latencyAccumulatorMs += latencyMs;
+            const result = {
+                agentId,
+                integrity,
+                cachedAt: Date.now(),
+                latencyMs,
+            };
+            this.cache.set(agentId, result);
+            // Emit integrity alert if below threshold
+            if (integrity.composite < this.config.alertThreshold) {
+                this.emit('integrity_alert', {
+                    agentId,
+                    integrity: integrity.composite,
+                    threshold: this.config.alertThreshold,
+                    tier: agent.tier,
+                    timestamp: new Date(),
+                });
+            }
+            return result;
+        }
+        catch (err) {
+            this.emit('error', {
+                agentId,
+                error: err instanceof Error ? err.message : String(err),
+                timestamp: new Date(),
+            });
+            return null;
+        }
+    }
+}
+// ---------------------------------------------------------------------------
+// Factory
+// ---------------------------------------------------------------------------
+/**
+ * Create a scheduled ParameSphere batch verifier.
+ */
+export function createScheduledParameSphereVerifier(verifyFn, config) {
+    return new ScheduledParameSphereVerifier(verifyFn, config);
+}
+//# sourceMappingURL=scheduled-verifier.js.map

package/dist/paramesphere/scheduled-verifier.js.map

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

package/dist/paramesphere/svd-worker-pool.d.ts

@@ -0,0 +1,37 @@
+export interface SvdWorkerPoolConfig {
+    /** Number of worker threads (default: cpus - 1, min 1) */
+    poolSize?: number;
+    /** Max pending tasks before rejecting (default: 1000) */
+    maxQueueDepth?: number;
+    /** Timeout per SVD computation in ms (default: 5000) */
+    timeoutMs?: number;
+}
+export declare class SvdWorkerPool {
+    private readonly workers;
+    private readonly idle;
+    private readonly queue;
+    private readonly pending;
+    private readonly poolSize;
+    private readonly maxQueueDepth;
+    private readonly timeoutMs;
+    private _completed;
+    private _errors;
+    private _shutdown;
+    constructor(config?: SvdWorkerPoolConfig);
+    /**
+     * Compute top-K singular values off the main thread.
+     */
+    computeTopK(matrix: number[][], k: number, maxIterations?: number): Promise<number[]>;
+    /** Pool statistics */
+    get stats(): {
+        active: number;
+        queued: number;
+        completed: number;
+        errors: number;
+    };
+    /** Shutdown all workers */
+    shutdown(): Promise<void>;
+    private dispatch;
+    private handleResult;
+}
+//# sourceMappingURL=svd-worker-pool.d.ts.map

package/dist/paramesphere/svd-worker-pool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"svd-worker-pool.d.ts","sourceRoot":"","sources":["../../src/paramesphere/svd-worker-pool.ts"],"names":[],"mappings":"AA2BA,MAAM,WAAW,mBAAmB;IAClC,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,yDAAyD;IACzD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,wDAAwD;IACxD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAsBD,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgB;IACxC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAgB;IACrC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAqB;IAC3C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAuC;IAC/D,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,OAAO,CAAK;IACpB,OAAO,CAAC,SAAS,CAAS;gBAEd,MAAM,GAAE,mBAAwB;IAsB5C;;OAEG;IACG,WAAW,CACf,MAAM,EAAE,MAAM,EAAE,EAAE,EAClB,CAAC,EAAE,MAAM,EACT,aAAa,GAAE,MAAY,GAC1B,OAAO,CAAC,MAAM,EAAE,CAAC;IA6BpB,sBAAsB;IACtB,IAAI,KAAK;;;;;MAOR;IAED,2BAA2B;IACrB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAoB/B,OAAO,CAAC,QAAQ;IAUhB,OAAO,CAAC,YAAY;CA0BrB"}

package/dist/paramesphere/svd-worker-pool.js

@@ -0,0 +1,144 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright 2024-2026 Vorion LLC
+/**
+ * SVD Worker Thread Pool
+ *
+ * Moves ParameSphere SVD computation off the Node.js event loop.
+ * At 21ms per fingerprint, 100+ T5-T7 agents would block the main
+ * thread for seconds. Worker threads eliminate this bottleneck.
+ *
+ * Usage:
+ *   const pool = new SvdWorkerPool({ poolSize: 4 });
+ *   const values = await pool.computeTopK(matrix, 8);
+ *   await pool.shutdown();
+ *
+ * @module @vorionsys/atsf-core/paramesphere
+ */
+import { Worker } from 'worker_threads';
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
+import { availableParallelism } from 'os';
+// =============================================================================
+// Worker Pool
+// =============================================================================
+let taskCounter = 0;
+export class SvdWorkerPool {
+    workers = [];
+    idle = [];
+    queue = [];
+    pending = new Map();
+    poolSize;
+    maxQueueDepth;
+    timeoutMs;
+    _completed = 0;
+    _errors = 0;
+    _shutdown = false;
+    constructor(config = {}) {
+        this.poolSize = config.poolSize ?? Math.max(1, availableParallelism() - 1);
+        this.maxQueueDepth = config.maxQueueDepth ?? 1000;
+        this.timeoutMs = config.timeoutMs ?? 5000;
+        // Resolve worker script path relative to this file
+        const workerPath = join(dirname(fileURLToPath(import.meta.url)), 'svd-worker.js');
+        for (let i = 0; i < this.poolSize; i++) {
+            const worker = new Worker(workerPath);
+            worker.on('message', (msg) => {
+                this.handleResult(msg);
+            });
+            worker.on('error', (err) => {
+                console.error('[SvdWorkerPool] Worker error:', err);
+                this._errors++;
+            });
+            this.workers.push(worker);
+            this.idle.push(worker);
+        }
+    }
+    /**
+     * Compute top-K singular values off the main thread.
+     */
+    async computeTopK(matrix, k, maxIterations = 300) {
+        if (this._shutdown) {
+            throw new Error('SvdWorkerPool is shut down');
+        }
+        if (this.queue.length >= this.maxQueueDepth) {
+            throw new Error(`SvdWorkerPool queue full (${this.maxQueueDepth})`);
+        }
+        const taskId = `svd-${++taskCounter}`;
+        return new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                this.pending.delete(taskId);
+                this._errors++;
+                reject(new Error(`SVD computation timed out after ${this.timeoutMs}ms`));
+            }, this.timeoutMs);
+            const task = { taskId, matrix, k, maxIterations, resolve, reject, timer };
+            const worker = this.idle.pop();
+            if (worker) {
+                this.dispatch(worker, task);
+            }
+            else {
+                this.queue.push(task);
+            }
+        });
+    }
+    /** Pool statistics */
+    get stats() {
+        return {
+            active: this.poolSize - this.idle.length,
+            queued: this.queue.length,
+            completed: this._completed,
+            errors: this._errors,
+        };
+    }
+    /** Shutdown all workers */
+    async shutdown() {
+        this._shutdown = true;
+        // Reject all queued tasks
+        for (const task of this.queue) {
+            clearTimeout(task.timer);
+            task.reject(new Error('SvdWorkerPool shutting down'));
+        }
+        this.queue.length = 0;
+        // Terminate all workers
+        await Promise.all(this.workers.map(w => w.terminate()));
+        this.workers.length = 0;
+        this.idle.length = 0;
+    }
+    // =========================================================================
+    // Internal
+    // =========================================================================
+    dispatch(worker, task) {
+        this.pending.set(task.taskId, task);
+        worker.postMessage({
+            taskId: task.taskId,
+            matrix: task.matrix,
+            k: task.k,
+            maxIterations: task.maxIterations,
+        });
+    }
+    handleResult(msg) {
+        const task = this.pending.get(msg.taskId);
+        if (!task)
+            return; // Timed out already
+        this.pending.delete(msg.taskId);
+        clearTimeout(task.timer);
+        if (msg.error) {
+            this._errors++;
+            task.reject(new Error(msg.error));
+        }
+        else {
+            this._completed++;
+            task.resolve(msg.result);
+        }
+        // Dispatch next queued task or return worker to idle
+        const worker = this.workers.find(w => !this.idle.includes(w));
+        if (worker) {
+            const next = this.queue.shift();
+            if (next) {
+                this.dispatch(worker, next);
+            }
+            else {
+                this.idle.push(worker);
+            }
+        }
+    }
+}
+//# sourceMappingURL=svd-worker-pool.js.map

package/dist/paramesphere/svd-worker-pool.js.map

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

package/dist/paramesphere/svd-worker.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=svd-worker.d.ts.map

package/dist/paramesphere/svd-worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"svd-worker.d.ts","sourceRoot":"","sources":["../../src/paramesphere/svd-worker.ts"],"names":[],"mappings":""}

package/dist/paramesphere/svd-worker.js

@@ -0,0 +1,103 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright 2024-2026 Vorion LLC
+/**
+ * SVD Worker Thread — runs power iteration off the main event loop.
+ *
+ * Receives: { matrix: number[][], k: number, maxIterations: number, taskId: string }
+ * Posts:    { taskId: string, result: number[] } or { taskId: string, error: string }
+ */
+import { parentPort } from 'worker_threads';
+// =============================================================================
+// SVD Power Iteration (duplicated from paramesphere-engine for isolation)
+// =============================================================================
+function matVecMul(matrix, vec) {
+    const rows = matrix.length;
+    const result = new Array(rows).fill(0);
+    for (let i = 0; i < rows; i++) {
+        const row = matrix[i];
+        let sum = 0;
+        for (let j = 0; j < vec.length; j++) {
+            sum += row[j] * vec[j];
+        }
+        result[i] = sum;
+    }
+    return result;
+}
+function matTransVecMul(matrix, vec) {
+    const cols = matrix[0].length;
+    const result = new Array(cols).fill(0);
+    for (let i = 0; i < matrix.length; i++) {
+        const row = matrix[i];
+        const vi = vec[i];
+        for (let j = 0; j < cols; j++) {
+            result[j] += row[j] * vi;
+        }
+    }
+    return result;
+}
+function vecNorm(vec) {
+    let sum = 0;
+    for (const v of vec)
+        sum += v * v;
+    return Math.sqrt(sum);
+}
+function normalize(vec) {
+    const norm = vecNorm(vec);
+    if (norm === 0)
+        return vec;
+    return vec.map(v => v / norm);
+}
+function topKSingularValues(matrix, k, maxIterations = 300, tolerance = 1e-10) {
+    const rows = matrix.length;
+    const cols = matrix[0]?.length ?? 0;
+    if (rows === 0 || cols === 0)
+        return [];
+    const actualK = Math.min(k, rows, cols);
+    const singularValues = [];
+    // Work on a copy to allow deflation
+    const work = matrix.map(row => [...row]);
+    for (let sv = 0; sv < actualK; sv++) {
+        // Random starting vector
+        let v = new Array(cols);
+        for (let i = 0; i < cols; i++)
+            v[i] = Math.random();
+        v = normalize(v);
+        let sigma = 0;
+        for (let iter = 0; iter < maxIterations; iter++) {
+            const u = normalize(matVecMul(work, v));
+            const vNew = normalize(matTransVecMul(work, u));
+            const newSigma = vecNorm(matVecMul(work, vNew));
+            if (Math.abs(newSigma - sigma) < tolerance) {
+                sigma = newSigma;
+                v = vNew;
+                break;
+            }
+            sigma = newSigma;
+            v = vNew;
+        }
+        singularValues.push(sigma);
+        // Deflate: remove this singular value's contribution
+        const u = normalize(matVecMul(work, v));
+        for (let i = 0; i < rows; i++) {
+            for (let j = 0; j < cols; j++) {
+                work[i][j] -= sigma * u[i] * v[j];
+            }
+        }
+    }
+    return singularValues;
+}
+// =============================================================================
+// Message Handler
+// =============================================================================
+if (parentPort) {
+    parentPort.on('message', (msg) => {
+        try {
+            const result = topKSingularValues(msg.matrix, msg.k, msg.maxIterations);
+            parentPort.postMessage({ taskId: msg.taskId, result });
+        }
+        catch (err) {
+            parentPort.postMessage({ taskId: msg.taskId, error: String(err) });
+        }
+    });
+}
+//# sourceMappingURL=svd-worker.js.map

package/dist/paramesphere/svd-worker.js.map

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