@nxuss/lemma 0.1.1 → 0.2.1

package/dist/esm/speculative/PredictionEngine.js

@@ -0,0 +1,284 @@
+/**
+ * Prediction Engine - Speculative Execution v2.0
+ *
+ * Analyzes historical request patterns and predicts the next 3 most probable
+ * agent requests using lightweight local models (Llama 3.2 1B/3B).
+ *
+ * Features:
+ * - Pattern analysis from request history
+ * - Confidence scoring (0.0-1.0)
+ * - Lightweight model inference
+ * - Real-time prediction updates
+ */
+import { EventEmitter } from 'events';
+import axios from 'axios';
+export class PredictionEngine extends EventEmitter {
+    constructor(config = {}) {
+        super();
+        this.requestHistory = [];
+        this.activePredictions = new Map();
+        this.metrics = {
+            totalPredictions: 0,
+            accuratePredictions: 0,
+            accuracy: 0,
+            averageConfidence: 0,
+            predictionTime: 0,
+        };
+        this.config = {
+            ollamaUrl: config.ollamaUrl || 'http://localhost:11434',
+            modelName: config.modelName || 'llama3.2:1b',
+            maxPredictions: config.maxPredictions || 3,
+            minConfidence: config.minConfidence || 0.6,
+            historySize: config.historySize || 100,
+            predictionTTL: config.predictionTTL || 60000,
+        };
+    }
+    /**
+     * Record a new request in the history
+     */
+    recordRequest(request) {
+        this.requestHistory.push(request);
+        // Keep history size bounded
+        if (this.requestHistory.length > this.config.historySize) {
+            this.requestHistory.shift();
+        }
+        // Trigger new predictions after recording
+        this.generatePredictions().catch((error) => {
+            this.emit('error', error);
+        });
+    }
+    /**
+     * Generate predictions based on current history
+     */
+    async generatePredictions() {
+        if (this.requestHistory.length < 3) {
+            // Not enough history to make predictions
+            return [];
+        }
+        const startTime = Date.now();
+        try {
+            // Analyze patterns in request history
+            const patterns = this.analyzePatterns();
+            // Generate predictions using lightweight model
+            const predictions = await this.predictNextRequests(patterns);
+            // Filter by confidence threshold
+            const validPredictions = predictions.filter((p) => p.confidence >= this.config.minConfidence);
+            // Store predictions
+            validPredictions.forEach((prediction) => {
+                this.activePredictions.set(prediction.id, prediction);
+            });
+            // Update metrics
+            this.metrics.totalPredictions += validPredictions.length;
+            this.metrics.predictionTime = Date.now() - startTime;
+            this.metrics.averageConfidence =
+                validPredictions.reduce((sum, p) => sum + p.confidence, 0) /
+                    validPredictions.length;
+            // Emit predictions for worker pool
+            this.emit('predictions', validPredictions);
+            return validPredictions;
+        }
+        catch (error) {
+            this.emit('error', error);
+            return [];
+        }
+    }
+    /**
+     * Check if a request matches any active prediction
+     */
+    matchPrediction(request) {
+        const now = Date.now();
+        // Clean up expired predictions
+        for (const [id, prediction] of this.activePredictions.entries()) {
+            if (prediction.expiresAt < now) {
+                this.activePredictions.delete(id);
+            }
+        }
+        // Find best matching prediction
+        let bestMatch = null;
+        let bestScore = 0;
+        for (const prediction of this.activePredictions.values()) {
+            const score = this.calculateMatchScore(request, prediction);
+            if (score > bestScore && score > 0.8) {
+                // 80% similarity threshold
+                bestScore = score;
+                bestMatch = prediction;
+            }
+        }
+        if (bestMatch) {
+            // Update accuracy metrics
+            this.metrics.accuratePredictions++;
+            this.metrics.accuracy =
+                this.metrics.accuratePredictions / this.metrics.totalPredictions;
+            // Remove matched prediction
+            this.activePredictions.delete(bestMatch.id);
+            this.emit('prediction-hit', { request, prediction: bestMatch, score: bestScore });
+        }
+        return bestMatch;
+    }
+    /**
+     * Analyze patterns in request history
+     */
+    analyzePatterns() {
+        const taskTypeCounts = new Map();
+        const recentContexts = [];
+        const sequences = [];
+        // Count task types
+        this.requestHistory.forEach((req) => {
+            taskTypeCounts.set(req.taskType, (taskTypeCounts.get(req.taskType) || 0) + 1);
+        });
+        // Get most common task types
+        const commonTaskTypes = Array.from(taskTypeCounts.entries())
+            .sort((a, b) => b[1] - a[1])
+            .slice(0, 5)
+            .map(([type]) => type);
+        // Get recent contexts (last 10)
+        recentContexts.push(...this.requestHistory.slice(-10).map((req) => req.context));
+        // Detect sequence patterns (3-request sequences)
+        for (let i = 0; i < this.requestHistory.length - 2; i++) {
+            sequences.push([
+                this.requestHistory[i].taskType,
+                this.requestHistory[i + 1].taskType,
+                this.requestHistory[i + 2].taskType,
+            ]);
+        }
+        return { commonTaskTypes, recentContexts, sequencePatterns: sequences };
+    }
+    /**
+     * Use lightweight model to predict next requests
+     */
+    async predictNextRequests(patterns) {
+        const prompt = this.buildPredictionPrompt(patterns);
+        try {
+            const response = await axios.post(`${this.config.ollamaUrl}/api/generate`, {
+                model: this.config.modelName,
+                prompt,
+                stream: false,
+                options: {
+                    temperature: 0.7,
+                    top_p: 0.9,
+                    num_predict: 500,
+                },
+            }, {
+                timeout: 5000, // 5 second timeout
+            });
+            const predictions = this.parsePredictions(response.data.response);
+            return predictions.slice(0, this.config.maxPredictions);
+        }
+        catch (error) {
+            console.error('Prediction generation failed:', error);
+            return [];
+        }
+    }
+    /**
+     * Build prompt for prediction model
+     */
+    buildPredictionPrompt(patterns) {
+        return `You are a predictive AI analyzing agent request patterns.
+
+Recent request history:
+- Common task types: ${patterns.commonTaskTypes.join(', ')}
+- Recent contexts: ${patterns.recentContexts.slice(-3).join(' | ')}
+- Detected sequences: ${patterns.sequencePatterns.slice(-3).map((s) => s.join(' → ')).join(', ')}
+
+Based on these patterns, predict the next 3 most probable agent requests.
+
+For each prediction, provide:
+1. Task type (e.g., "research", "summarize", "analyze")
+2. Context (brief description of what the request might be about)
+3. Confidence (0.0-1.0, how confident you are)
+4. Reasoning (why you think this request is likely)
+
+Format your response as JSON array:
+[
+  {
+    "taskType": "...",
+    "context": "...",
+    "confidence": 0.0-1.0,
+    "reasoning": "..."
+  }
+]
+
+Respond with ONLY the JSON array, no other text.`;
+    }
+    /**
+     * Parse predictions from model response
+     */
+    parsePredictions(response) {
+        try {
+            // Extract JSON from response
+            const jsonMatch = response.match(/\[[\s\S]*\]/);
+            if (!jsonMatch) {
+                return [];
+            }
+            const parsed = JSON.parse(jsonMatch[0]);
+            const now = Date.now();
+            return parsed.map((p, index) => ({
+                id: `pred-${now}-${index}`,
+                taskType: p.taskType || 'unknown',
+                context: p.context || '',
+                confidence: Math.min(Math.max(p.confidence || 0, 0), 1),
+                reasoning: p.reasoning || '',
+                timestamp: now,
+                expiresAt: now + this.config.predictionTTL,
+            }));
+        }
+        catch (error) {
+            console.error('Failed to parse predictions:', error);
+            return [];
+        }
+    }
+    /**
+     * Calculate similarity score between request and prediction
+     */
+    calculateMatchScore(request, prediction) {
+        let score = 0;
+        // Task type exact match (40% weight)
+        if (request.taskType === prediction.taskType) {
+            score += 0.4;
+        }
+        // Context similarity (40% weight)
+        const contextSimilarity = this.calculateTextSimilarity(request.context, prediction.context);
+        score += contextSimilarity * 0.4;
+        // Confidence bonus (20% weight)
+        score += prediction.confidence * 0.2;
+        return score;
+    }
+    /**
+     * Simple text similarity using word overlap
+     */
+    calculateTextSimilarity(text1, text2) {
+        const words1 = new Set(text1.toLowerCase().split(/\s+/));
+        const words2 = new Set(text2.toLowerCase().split(/\s+/));
+        const intersection = new Set([...words1].filter((w) => words2.has(w)));
+        const union = new Set([...words1, ...words2]);
+        return intersection.size / union.size;
+    }
+    /**
+     * Get current metrics
+     */
+    getMetrics() {
+        return { ...this.metrics };
+    }
+    /**
+     * Get active predictions
+     */
+    getActivePredictions() {
+        const now = Date.now();
+        return Array.from(this.activePredictions.values()).filter((p) => p.expiresAt > now);
+    }
+    /**
+     * Clear all predictions and history
+     */
+    clear() {
+        this.requestHistory = [];
+        this.activePredictions.clear();
+        this.metrics = {
+            totalPredictions: 0,
+            accuratePredictions: 0,
+            accuracy: 0,
+            averageConfidence: 0,
+            predictionTime: 0,
+        };
+    }
+}
+//# sourceMappingURL=PredictionEngine.js.map

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

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

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

@@ -0,0 +1,117 @@
+/**
+ * Speculative Cache - Speculative Execution v2.0
+ *
+ * Stores pre-computed results from speculative execution with TTL-based expiration.
+ * Provides instant (<10ms) cache lookups for predicted requests.
+ *
+ * Features:
+ * - TTL-based expiration
+ * - Confidence-based prioritization
+ * - Memory-efficient storage
+ * - Automatic cleanup
+ */
+import { EventEmitter } from 'events';
+import { Prediction } from './PredictionEngine';
+import { WorkerResult } from './WorkerPool';
+export interface CacheEntry {
+    id: string;
+    prediction: Prediction;
+    result: any;
+    confidence: number;
+    createdAt: number;
+    expiresAt: number;
+    hits: number;
+    lastAccessedAt: number;
+}
+export interface SpeculativeCacheConfig {
+    maxSize?: number;
+    defaultTTL?: number;
+    cleanupInterval?: number;
+    maxMemoryMB?: number;
+}
+export interface SpeculativeCacheMetrics {
+    size: number;
+    hits: number;
+    misses: number;
+    hitRate: number;
+    averageHitLatency: number;
+    memoryUsageMB: number;
+    evictions: number;
+}
+export declare class SpeculativeCache extends EventEmitter {
+    private config;
+    private cache;
+    private cleanupTimer?;
+    private metrics;
+    private hitLatencies;
+    constructor(config?: SpeculativeCacheConfig);
+    /**
+     * Start the cache
+     */
+    start(): void;
+    /**
+     * Store a pre-computed result
+     */
+    set(result: WorkerResult): void;
+    /**
+     * Get a cached result
+     */
+    get(taskType: string, context: string): CacheEntry | null;
+    /**
+     * Find best matching entry using fuzzy matching
+     */
+    private findBestMatch;
+    /**
+     * Calculate match score between request and cached prediction
+     */
+    private calculateMatchScore;
+    /**
+     * Simple text similarity using word overlap
+     */
+    private calculateTextSimilarity;
+    /**
+     * Generate cache key from prediction
+     */
+    private generateKey;
+    /**
+     * Generate cache key from request
+     */
+    private generateKeyFromRequest;
+    /**
+     * Simple string hash function
+     */
+    private hashString;
+    /**
+     * Evict low priority entries
+     */
+    private evictLowPriority;
+    /**
+     * Cleanup expired entries
+     */
+    private cleanup;
+    /**
+     * Estimate memory usage in MB
+     */
+    private getMemoryUsageMB;
+    /**
+     * Update metrics
+     */
+    private updateMetrics;
+    /**
+     * Get current metrics
+     */
+    getMetrics(): SpeculativeCacheMetrics;
+    /**
+     * Get all entries
+     */
+    getEntries(): CacheEntry[];
+    /**
+     * Clear all entries
+     */
+    clear(): void;
+    /**
+     * Stop the cache
+     */
+    stop(): void;
+}
+//# sourceMappingURL=SpeculativeCache.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SpeculativeCache.d.ts","sourceRoot":"","sources":["../../../src/speculative/SpeculativeCache.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,UAAU,CAAC;IACvB,MAAM,EAAE,GAAG,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,sBAAsB;IACrC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,gBAAiB,SAAQ,YAAY;IAChD,OAAO,CAAC,MAAM,CAAmC;IACjD,OAAO,CAAC,KAAK,CAAsC;IACnD,OAAO,CAAC,YAAY,CAAC,CAAiB;IACtC,OAAO,CAAC,OAAO,CAQb;IACF,OAAO,CAAC,YAAY,CAAgB;gBAExB,MAAM,GAAE,sBAA2B;IAU/C;;OAEG;IACI,KAAK,IAAI,IAAI;IASpB;;OAEG;IACI,GAAG,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI;IAgCtC;;OAEG;IACI,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI;IAgDhE;;OAEG;IACH,OAAO,CAAC,aAAa;IA0BrB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAyB3B;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAU/B;;OAEG;IACH,OAAO,CAAC,WAAW;IAInB;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAI9B;;OAEG;IACH,OAAO,CAAC,UAAU;IAUlB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAqBxB;;OAEG;IACH,OAAO,CAAC,OAAO;IAiBf;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAWxB;;OAEG;IACH,OAAO,CAAC,aAAa;IAcrB;;OAEG;IACI,UAAU,IAAI,uBAAuB;IAK5C;;OAEG;IACI,UAAU,IAAI,UAAU,EAAE;IAIjC;;OAEG;IACI,KAAK,IAAI,IAAI;IAepB;;OAEG;IACI,IAAI,IAAI,IAAI;CAOpB"}