@nxuss/lemma 0.1.0 → 0.2.0

package/dist/esm/speculative/WorkerPool.d.ts

@@ -0,0 +1,109 @@
+/**
+ * Worker Pool - Speculative Execution v2.0
+ *
+ * Manages Node.js Worker Threads for parallel pre-computation of predicted requests.
+ * Each worker executes a prediction in the background without blocking the main thread.
+ *
+ * Features:
+ * - Dynamic worker allocation
+ * - Resource management
+ * - Task queuing
+ * - Graceful shutdown
+ */
+import { EventEmitter } from 'events';
+import { Prediction } from './PredictionEngine';
+export interface WorkerTask {
+    id: string;
+    prediction: Prediction;
+    agentId?: string;
+    priority: number;
+    createdAt: number;
+}
+export interface WorkerResult {
+    taskId: string;
+    prediction: Prediction;
+    result: any;
+    executionTime: number;
+    success: boolean;
+    error?: string;
+}
+export interface WorkerPoolConfig {
+    maxWorkers?: number;
+    workerScript?: string;
+    taskTimeout?: number;
+    maxQueueSize?: number;
+}
+export interface WorkerPoolMetrics {
+    activeWorkers: number;
+    idleWorkers: number;
+    queuedTasks: number;
+    completedTasks: number;
+    failedTasks: number;
+    averageExecutionTime: number;
+    cpuUsage: number;
+}
+export declare class WorkerPool extends EventEmitter {
+    private config;
+    private workers;
+    private taskQueue;
+    private nextWorkerId;
+    private metrics;
+    constructor(config?: WorkerPoolConfig);
+    /**
+     * Initialize the worker pool
+     */
+    initialize(): Promise<void>;
+    /**
+     * Submit a task for execution
+     */
+    submitTask(task: WorkerTask): Promise<void>;
+    /**
+     * Submit multiple tasks from predictions
+     */
+    submitPredictions(predictions: Prediction[]): Promise<void>;
+    /**
+     * Create a new worker
+     */
+    private createWorker;
+    /**
+     * Assign tasks to available workers
+     */
+    private assignTasks;
+    /**
+     * Assign a task to a specific worker
+     */
+    private assignTaskToWorker;
+    /**
+     * Handle message from worker
+     */
+    private handleWorkerMessage;
+    /**
+     * Handle worker error
+     */
+    private handleWorkerError;
+    /**
+     * Handle worker exit
+     */
+    private handleWorkerExit;
+    /**
+     * Handle task timeout
+     */
+    private handleTaskTimeout;
+    /**
+     * Terminate a worker
+     */
+    private terminateWorker;
+    /**
+     * Update metrics
+     */
+    private updateMetrics;
+    /**
+     * Get current metrics
+     */
+    getMetrics(): WorkerPoolMetrics;
+    /**
+     * Shutdown the worker pool
+     */
+    shutdown(): Promise<void>;
+}
+//# sourceMappingURL=WorkerPool.d.ts.map

package/dist/esm/speculative/WorkerPool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorkerPool.d.ts","sourceRoot":"","sources":["../../../src/speculative/WorkerPool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAEhD,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,UAAU,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,UAAU,CAAC;IACvB,MAAM,EAAE,GAAG,CAAC;IACZ,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC/B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,iBAAiB;IAChC,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,QAAQ,EAAE,MAAM,CAAC;CAClB;AAWD,qBAAa,UAAW,SAAQ,YAAY;IAC1C,OAAO,CAAC,MAAM,CAA6B;IAC3C,OAAO,CAAC,OAAO,CAAsC;IACrD,OAAO,CAAC,SAAS,CAAoB;IACrC,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,OAAO,CAQb;gBAEU,MAAM,GAAE,gBAAqB;IAYzC;;OAEG;IACU,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAYxC;;OAEG;IACU,UAAU,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAoBxD;;OAEG;IACU,iBAAiB,CAAC,WAAW,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAaxE;;OAEG;IACH,OAAO,CAAC,YAAY;IAwCpB;;OAEG;IACH,OAAO,CAAC,WAAW;IA2BnB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IA4B1B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAkC3B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IA0BzB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAWxB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAmBzB;;OAEG;IACH,OAAO,CAAC,eAAe;IAiBvB;;OAEG;IACH,OAAO,CAAC,aAAa;IAqBrB;;OAEG;IACI,UAAU,IAAI,iBAAiB;IAKtC;;OAEG;IACU,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CA0BvC"}

package/dist/esm/speculative/WorkerPool.js

@@ -0,0 +1,323 @@
+/**
+ * Worker Pool - Speculative Execution v2.0
+ *
+ * Manages Node.js Worker Threads for parallel pre-computation of predicted requests.
+ * Each worker executes a prediction in the background without blocking the main thread.
+ *
+ * Features:
+ * - Dynamic worker allocation
+ * - Resource management
+ * - Task queuing
+ * - Graceful shutdown
+ */
+import { Worker } from 'worker_threads';
+import { EventEmitter } from 'events';
+export class WorkerPool extends EventEmitter {
+    constructor(config = {}) {
+        super();
+        this.workers = new Map();
+        this.taskQueue = [];
+        this.nextWorkerId = 0;
+        this.metrics = {
+            activeWorkers: 0,
+            idleWorkers: 0,
+            queuedTasks: 0,
+            completedTasks: 0,
+            failedTasks: 0,
+            averageExecutionTime: 0,
+            cpuUsage: 0,
+        };
+        const cpuCount = require('os').cpus().length;
+        this.config = {
+            maxWorkers: config.maxWorkers || Math.max(1, cpuCount - 1),
+            workerScript: config.workerScript || require.resolve('./worker.js'),
+            taskTimeout: config.taskTimeout || 30000,
+            maxQueueSize: config.maxQueueSize || 100,
+        };
+    }
+    /**
+     * Initialize the worker pool
+     */
+    async initialize() {
+        // Create initial workers
+        for (let i = 0; i < Math.min(2, this.config.maxWorkers); i++) {
+            this.createWorker();
+        }
+        this.emit('initialized', {
+            maxWorkers: this.config.maxWorkers,
+            initialWorkers: this.workers.size,
+        });
+    }
+    /**
+     * Submit a task for execution
+     */
+    async submitTask(task) {
+        // Check queue size
+        if (this.taskQueue.length >= this.config.maxQueueSize) {
+            // Remove lowest priority task
+            this.taskQueue.sort((a, b) => b.priority - a.priority);
+            const removed = this.taskQueue.pop();
+            this.emit('task-dropped', removed);
+        }
+        // Add to queue
+        this.taskQueue.push(task);
+        this.metrics.queuedTasks = this.taskQueue.length;
+        // Sort by priority (confidence)
+        this.taskQueue.sort((a, b) => b.priority - a.priority);
+        // Try to assign to available worker
+        this.assignTasks();
+    }
+    /**
+     * Submit multiple tasks from predictions
+     */
+    async submitPredictions(predictions) {
+        const tasks = predictions.map((prediction) => ({
+            id: prediction.id,
+            prediction,
+            priority: prediction.confidence,
+            createdAt: Date.now(),
+        }));
+        for (const task of tasks) {
+            await this.submitTask(task);
+        }
+    }
+    /**
+     * Create a new worker
+     */
+    createWorker() {
+        const workerId = this.nextWorkerId++;
+        const worker = new Worker(this.config.workerScript, {
+            workerData: {
+                workerId,
+            },
+        });
+        const workerInfo = {
+            id: workerId,
+            worker,
+            busy: false,
+            tasksCompleted: 0,
+            totalExecutionTime: 0,
+        };
+        // Handle worker messages
+        worker.on('message', (message) => {
+            this.handleWorkerMessage(workerId, message);
+        });
+        // Handle worker errors
+        worker.on('error', (error) => {
+            this.handleWorkerError(workerId, error);
+        });
+        // Handle worker exit
+        worker.on('exit', (code) => {
+            this.handleWorkerExit(workerId, code);
+        });
+        this.workers.set(workerId, workerInfo);
+        this.updateMetrics();
+        this.emit('worker-created', { workerId });
+        return workerInfo;
+    }
+    /**
+     * Assign tasks to available workers
+     */
+    assignTasks() {
+        // Find idle workers
+        const idleWorkers = Array.from(this.workers.values()).filter((w) => !w.busy);
+        // Assign tasks to idle workers
+        while (this.taskQueue.length > 0 && idleWorkers.length > 0) {
+            const task = this.taskQueue.shift();
+            const worker = idleWorkers.shift();
+            this.assignTaskToWorker(worker, task);
+        }
+        // Create new workers if needed
+        if (this.taskQueue.length > 0 &&
+            this.workers.size < this.config.maxWorkers) {
+            const newWorker = this.createWorker();
+            if (this.taskQueue.length > 0) {
+                const task = this.taskQueue.shift();
+                this.assignTaskToWorker(newWorker, task);
+            }
+        }
+        this.updateMetrics();
+    }
+    /**
+     * Assign a task to a specific worker
+     */
+    assignTaskToWorker(workerInfo, task) {
+        workerInfo.busy = true;
+        workerInfo.currentTask = task;
+        // Send task to worker
+        workerInfo.worker.postMessage({
+            type: 'execute',
+            task: {
+                id: task.id,
+                prediction: task.prediction,
+                agentId: task.agentId,
+            },
+        });
+        // Set timeout
+        const timeout = setTimeout(() => {
+            this.handleTaskTimeout(workerInfo.id, task);
+        }, this.config.taskTimeout);
+        // Store timeout for cleanup
+        workerInfo.timeout = timeout;
+        this.emit('task-assigned', {
+            workerId: workerInfo.id,
+            taskId: task.id,
+        });
+    }
+    /**
+     * Handle message from worker
+     */
+    handleWorkerMessage(workerId, message) {
+        const workerInfo = this.workers.get(workerId);
+        if (!workerInfo)
+            return;
+        // Clear timeout
+        if (workerInfo.timeout) {
+            clearTimeout(workerInfo.timeout);
+            delete workerInfo.timeout;
+        }
+        if (message.type === 'result') {
+            const result = message.result;
+            // Update worker stats
+            workerInfo.busy = false;
+            workerInfo.tasksCompleted++;
+            workerInfo.totalExecutionTime += result.executionTime;
+            workerInfo.currentTask = undefined;
+            // Update metrics
+            if (result.success) {
+                this.metrics.completedTasks++;
+            }
+            else {
+                this.metrics.failedTasks++;
+            }
+            // Emit result
+            this.emit('task-completed', result);
+            // Assign next task
+            this.assignTasks();
+        }
+    }
+    /**
+     * Handle worker error
+     */
+    handleWorkerError(workerId, error) {
+        const workerInfo = this.workers.get(workerId);
+        if (!workerInfo)
+            return;
+        this.emit('worker-error', {
+            workerId,
+            error: error.message,
+            task: workerInfo.currentTask,
+        });
+        // Mark task as failed
+        if (workerInfo.currentTask) {
+            this.metrics.failedTasks++;
+            this.emit('task-failed', {
+                taskId: workerInfo.currentTask.id,
+                error: error.message,
+            });
+        }
+        // Terminate and recreate worker
+        this.terminateWorker(workerId);
+        if (this.workers.size < this.config.maxWorkers) {
+            this.createWorker();
+        }
+    }
+    /**
+     * Handle worker exit
+     */
+    handleWorkerExit(workerId, code) {
+        const workerInfo = this.workers.get(workerId);
+        if (!workerInfo)
+            return;
+        this.emit('worker-exited', { workerId, code });
+        // Remove worker
+        this.workers.delete(workerId);
+        this.updateMetrics();
+    }
+    /**
+     * Handle task timeout
+     */
+    handleTaskTimeout(workerId, task) {
+        const workerInfo = this.workers.get(workerId);
+        if (!workerInfo)
+            return;
+        this.emit('task-timeout', {
+            workerId,
+            taskId: task.id,
+        });
+        // Mark task as failed
+        this.metrics.failedTasks++;
+        // Terminate and recreate worker
+        this.terminateWorker(workerId);
+        if (this.workers.size < this.config.maxWorkers) {
+            this.createWorker();
+        }
+    }
+    /**
+     * Terminate a worker
+     */
+    terminateWorker(workerId) {
+        const workerInfo = this.workers.get(workerId);
+        if (!workerInfo)
+            return;
+        // Clear timeout
+        if (workerInfo.timeout) {
+            clearTimeout(workerInfo.timeout);
+        }
+        // Terminate worker
+        workerInfo.worker.terminate();
+        // Remove from map
+        this.workers.delete(workerId);
+        this.updateMetrics();
+    }
+    /**
+     * Update metrics
+     */
+    updateMetrics() {
+        const activeWorkers = Array.from(this.workers.values()).filter((w) => w.busy).length;
+        const idleWorkers = this.workers.size - activeWorkers;
+        let totalExecutionTime = 0;
+        let totalTasks = 0;
+        for (const worker of this.workers.values()) {
+            totalExecutionTime += worker.totalExecutionTime;
+            totalTasks += worker.tasksCompleted;
+        }
+        this.metrics.activeWorkers = activeWorkers;
+        this.metrics.idleWorkers = idleWorkers;
+        this.metrics.queuedTasks = this.taskQueue.length;
+        this.metrics.averageExecutionTime =
+            totalTasks > 0 ? totalExecutionTime / totalTasks : 0;
+    }
+    /**
+     * Get current metrics
+     */
+    getMetrics() {
+        this.updateMetrics();
+        return { ...this.metrics };
+    }
+    /**
+     * Shutdown the worker pool
+     */
+    async shutdown() {
+        // Clear queue
+        this.taskQueue = [];
+        // Terminate all workers
+        const terminationPromises = Array.from(this.workers.keys()).map((workerId) => {
+            return new Promise((resolve) => {
+                const workerInfo = this.workers.get(workerId);
+                if (workerInfo) {
+                    workerInfo.worker.once('exit', () => resolve());
+                    workerInfo.worker.terminate();
+                }
+                else {
+                    resolve();
+                }
+            });
+        });
+        await Promise.all(terminationPromises);
+        this.workers.clear();
+        this.updateMetrics();
+        this.emit('shutdown');
+    }
+}
+//# sourceMappingURL=WorkerPool.js.map

package/dist/esm/speculative/WorkerPool.js.map

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

package/dist/esm/speculative/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Speculative Execution Module - v2.0
+ *
+ * Exports all speculative execution components for Phase 3.
+ */
+export { PredictionEngine, PredictionRequest, Prediction, PredictionEngineConfig, PredictionMetrics } from './PredictionEngine';
+export { WorkerPool, WorkerTask, WorkerResult, WorkerPoolConfig, WorkerPoolMetrics } from './WorkerPool';
+export { SpeculativeCache, CacheEntry, SpeculativeCacheConfig, SpeculativeCacheMetrics } from './SpeculativeCache';
+export { SpeculativeEngine, SpeculativeEngineConfig, SpeculativeResult, SpeculativeMetrics } from './SpeculativeEngine';
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/speculative/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/speculative/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,UAAU,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAChI,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,YAAY,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACzG,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AACnH,OAAO,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/esm/speculative/index.js

@@ -0,0 +1,10 @@
+/**
+ * Speculative Execution Module - v2.0
+ *
+ * Exports all speculative execution components for Phase 3.
+ */
+export { PredictionEngine } from './PredictionEngine';
+export { WorkerPool } from './WorkerPool';
+export { SpeculativeCache } from './SpeculativeCache';
+export { SpeculativeEngine } from './SpeculativeEngine';
+//# sourceMappingURL=index.js.map

package/dist/esm/speculative/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/speculative/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,gBAAgB,EAA4E,MAAM,oBAAoB,CAAC;AAChI,OAAO,EAAE,UAAU,EAAiE,MAAM,cAAc,CAAC;AACzG,OAAO,EAAE,gBAAgB,EAA+D,MAAM,oBAAoB,CAAC;AACnH,OAAO,EAAE,iBAAiB,EAAkE,MAAM,qBAAqB,CAAC"}

package/dist/esm/subconscious/EmbeddingService.d.ts

@@ -0,0 +1,73 @@
+/**
+ * EmbeddingService handles communication with Ollama API for generating embeddings.
+ * Includes caching, error handling, and retry logic.
+ */
+export declare class EmbeddingService {
+    private client;
+    private model;
+    private cache;
+    private maxRetries;
+    private retryDelay;
+    constructor(ollamaUrl?: string, model?: string, maxRetries?: number, retryDelay?: number);
+    /**
+     * Generate an embedding vector for the given text.
+     * Uses cache if available, otherwise calls Ollama API.
+     *
+     * @param text - Text to generate embedding for
+     * @param useCache - Whether to use cached embeddings (default true)
+     * @returns Embedding vector as array of numbers
+     */
+    generateEmbedding(text: string, useCache?: boolean): Promise<number[]>;
+    /**
+     * Generate embeddings for multiple texts in batch.
+     *
+     * @param texts - Array of texts to generate embeddings for
+     * @param useCache - Whether to use cached embeddings (default true)
+     * @returns Array of embedding vectors
+     */
+    generateEmbeddings(texts: string[], useCache?: boolean): Promise<number[][]>;
+    /**
+     * Call Ollama API to generate embedding.
+     *
+     * @param text - Text to generate embedding for
+     * @returns Embedding vector
+     */
+    private callOllamaAPI;
+    /**
+     * Generate a cache key from text.
+     * Uses a simple hash to avoid storing full text as keys.
+     */
+    private getCacheKey;
+    /**
+     * Sleep for specified milliseconds.
+     */
+    private sleep;
+    /**
+     * Clear the embedding cache.
+     */
+    clearCache(): void;
+    /**
+     * Get cache statistics.
+     */
+    getCacheStats(): {
+        size: number;
+        maxSize: number;
+    };
+    /**
+     * Check if Ollama is available and the model is loaded.
+     */
+    healthCheck(): Promise<{
+        available: boolean;
+        model: string;
+        error?: string;
+    }>;
+    /**
+     * Calculate cosine similarity between two embedding vectors.
+     *
+     * @param vecA - First embedding vector
+     * @param vecB - Second embedding vector
+     * @returns Similarity score between 0 and 1
+     */
+    static cosineSimilarity(vecA: number[], vecB: number[]): number;
+}
+//# sourceMappingURL=EmbeddingService.d.ts.map

package/dist/esm/subconscious/EmbeddingService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EmbeddingService.d.ts","sourceRoot":"","sources":["../../../src/subconscious/EmbeddingService.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,KAAK,CAAwB;IACrC,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,UAAU,CAAS;gBAGzB,SAAS,GAAE,MAAiC,EAC5C,KAAK,GAAE,MAAiB,EACxB,UAAU,GAAE,MAAU,EACtB,UAAU,GAAE,MAAa;IAe3B;;;;;;;OAOG;IACG,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,GAAE,OAAc,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IA6ClF;;;;;;OAMG;IACG,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,QAAQ,GAAE,OAAc,GAAG,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;IAWxF;;;;;OAKG;YACW,aAAa;IAgC3B;;;OAGG;IACH,OAAO,CAAC,WAAW;IAWnB;;OAEG;IACH,OAAO,CAAC,KAAK;IAIb;;OAEG;IACH,UAAU,IAAI,IAAI;IAKlB;;OAEG;IACH,aAAa,IAAI;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE;IAOlD;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC;QAAE,SAAS,EAAE,OAAO,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAiBnF;;;;;;OAMG;IACH,MAAM,CAAC,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM;CAsBhE"}