@mxf-dev/core 1.0.0

package/dist/services/SurpriseCalculator.js

@@ -0,0 +1,303 @@
+/**
+ * Copyright 2024 Brad Anderson
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *
+ * @author Brad Anderson <BradA1878@pm.me>
+ * @repository https://github.com/mxf-dev/mxf
+ * @documentation https://mxf-dev.github.io/mxf/
+ */
+/**
+ * SurpriseCalculator Service
+ *
+ * Implements surprise-based memory encoding from Google's Titans architecture.
+ * Surprise is the gradient magnitude - the difference between expected and actual outcomes.
+ * Includes momentum tracking to capture contextually related information.
+ *
+ * Feature flag: MEMORY_STRATA_ENABLED
+ */
+import { Logger } from '../utils/Logger.js';
+/**
+ * SurpriseCalculator handles surprise detection with momentum
+ */
+export class SurpriseCalculator {
+    static instance;
+    logger;
+    // Prediction storage per agent
+    predictions;
+    // Surprise history per agent (for baseline calculation)
+    surpriseHistory;
+    // Momentum accumulator per agent
+    momentumAccumulators;
+    // Configuration
+    surpriseThreshold = 0.5;
+    momentumDecayRate = 0.7;
+    momentumBoostFactor = 2.0;
+    historyWindowSize = 50;
+    enabled = false;
+    constructor() {
+        this.logger = new Logger('info', 'SurpriseCalculator');
+        this.predictions = new Map();
+        this.surpriseHistory = new Map();
+        this.momentumAccumulators = new Map();
+    }
+    static getInstance() {
+        if (!SurpriseCalculator.instance) {
+            SurpriseCalculator.instance = new SurpriseCalculator();
+        }
+        return SurpriseCalculator.instance;
+    }
+    /**
+     * Initialize the SurpriseCalculator
+     */
+    initialize(config) {
+        this.enabled = config.enabled;
+        if (config.threshold !== undefined)
+            this.surpriseThreshold = config.threshold;
+        if (config.momentumDecayRate !== undefined)
+            this.momentumDecayRate = config.momentumDecayRate;
+        if (config.momentumBoostFactor !== undefined)
+            this.momentumBoostFactor = config.momentumBoostFactor;
+        if (this.enabled) {
+            this.logger.info('[SurpriseCalculator] Initialized with Titans-style surprise detection');
+        }
+    }
+    /**
+     * Check if surprise calculation is enabled
+     */
+    isEnabled() {
+        return this.enabled;
+    }
+    /**
+     * Store a prediction for future surprise calculation
+     */
+    async storePrediction(prediction) {
+        if (!this.enabled)
+            return;
+        const agentPredictions = this.predictions.get(prediction.agentId) || [];
+        agentPredictions.push(prediction);
+        // Keep only recent predictions
+        if (agentPredictions.length > this.historyWindowSize) {
+            agentPredictions.shift();
+        }
+        this.predictions.set(prediction.agentId, agentPredictions);
+        this.logger.debug(`[SurpriseCalculator] Stored prediction ${prediction.id} for agent ${prediction.agentId}`);
+    }
+    /**
+     * Calculate surprise signal with momentum
+     */
+    async calculateSurprise(outcome) {
+        if (!this.enabled) {
+            return this.createDefaultSurpriseSignal();
+        }
+        // Find matching prediction
+        const agentPredictions = this.predictions.get(outcome.agentId) || [];
+        const prediction = outcome.predictionId
+            ? agentPredictions.find(p => p.id === outcome.predictionId)
+            : this.findMatchingPrediction(agentPredictions, outcome);
+        // Calculate momentary surprise
+        const momentarySurprise = prediction
+            ? this.calculatePredictionError(prediction, outcome)
+            : this.calculateNovelty(outcome);
+        // Get or create momentum accumulator
+        const accumulator = this.getOrCreateAccumulator(outcome.agentId);
+        // Apply decay to momentum
+        this.decayMomentum(accumulator);
+        // Get past surprise from momentum
+        const pastSurprise = accumulator.value;
+        // Calculate effective surprise
+        const effectiveSurprise = Math.min(momentarySurprise + pastSurprise * 0.3, 1.0);
+        // Update momentum if surprise is significant
+        if (momentarySurprise > this.surpriseThreshold) {
+            accumulator.value = Math.min(accumulator.value + momentarySurprise * this.momentumBoostFactor, 1.0);
+            accumulator.lastUpdate = new Date();
+        }
+        // Store in history
+        this.addToHistory(outcome.agentId, effectiveSurprise);
+        // Create detection result
+        const detection = this.createSurpriseDetection(effectiveSurprise, prediction, outcome);
+        this.logger.debug(`[SurpriseCalculator] Agent ${outcome.agentId}: momentary=${momentarySurprise.toFixed(3)}, ` +
+            `past=${pastSurprise.toFixed(3)}, effective=${effectiveSurprise.toFixed(3)}`);
+        return {
+            momentarySurprise,
+            pastSurprise,
+            effectiveSurprise,
+            detection
+        };
+    }
+    /**
+     * Calculate surprise without a prior prediction (novelty-based)
+     */
+    async calculateNoveltyScore(agentId, content, context) {
+        if (!this.enabled)
+            return 0;
+        const outcome = {
+            id: `novelty-${Date.now()}`,
+            agentId,
+            content,
+            actualOutcome: context,
+            timestamp: new Date(),
+            context
+        };
+        const surpriseSignal = await this.calculateSurprise(outcome);
+        return surpriseSignal.effectiveSurprise;
+    }
+    /**
+     * Get surprise statistics for an agent
+     */
+    getStatistics(agentId) {
+        const history = this.surpriseHistory.get(agentId) || [];
+        const accumulator = this.momentumAccumulators.get(agentId);
+        const predictions = this.predictions.get(agentId) || [];
+        const avgSurprise = history.length > 0
+            ? history.reduce((sum, s) => sum + s, 0) / history.length
+            : 0;
+        const recentSurprises = history.filter(s => s > this.surpriseThreshold).length;
+        return {
+            avgSurprise,
+            recentSurprises,
+            momentum: accumulator?.value || 0,
+            predictionCount: predictions.length
+        };
+    }
+    /**
+     * Clear surprise data for an agent
+     */
+    clear(agentId) {
+        this.predictions.delete(agentId);
+        this.surpriseHistory.delete(agentId);
+        this.momentumAccumulators.delete(agentId);
+        this.logger.info(`[SurpriseCalculator] Cleared surprise data for agent ${agentId}`);
+    }
+    // Private helper methods
+    calculatePredictionError(prediction, outcome) {
+        // Calculate error based on prediction confidence and outcome match
+        const contentMatch = this.calculateContentSimilarity(prediction.content, outcome.content);
+        // Surprise is inverse of match, weighted by confidence
+        const error = (1 - contentMatch) * prediction.confidence;
+        // Normalize to 0-1
+        return Math.min(Math.max(error, 0), 1);
+    }
+    calculateNovelty(outcome) {
+        // Calculate novelty based on historical patterns
+        const history = this.surpriseHistory.get(outcome.agentId) || [];
+        if (history.length === 0) {
+            // First observation is moderately novel
+            return 0.5;
+        }
+        // Calculate variance from historical average
+        const avgSurprise = history.reduce((sum, s) => sum + s, 0) / history.length;
+        const variance = history.reduce((sum, s) => sum + Math.pow(s - avgSurprise, 2), 0) / history.length;
+        // High variance means unpredictable, so assume moderate surprise
+        const baseNovelty = Math.min(variance * 2, 0.7);
+        return baseNovelty;
+    }
+    calculateContentSimilarity(content1, content2) {
+        // Simple word-overlap similarity
+        const words1 = new Set(content1.toLowerCase().split(/\s+/));
+        const words2 = new Set(content2.toLowerCase().split(/\s+/));
+        const intersection = new Set([...words1].filter(w => words2.has(w)));
+        const union = new Set([...words1, ...words2]);
+        return union.size > 0 ? intersection.size / union.size : 0;
+    }
+    findMatchingPrediction(predictions, outcome) {
+        // Find most recent prediction within time window
+        const recentPredictions = predictions.filter(p => {
+            const timeDiff = outcome.timestamp.getTime() - p.timestamp.getTime();
+            return timeDiff > 0 && timeDiff < 60000; // Within 1 minute
+        });
+        if (recentPredictions.length === 0)
+            return undefined;
+        // Return most confident recent prediction
+        return recentPredictions.reduce((best, current) => current.confidence > best.confidence ? current : best);
+    }
+    getOrCreateAccumulator(agentId) {
+        if (!this.momentumAccumulators.has(agentId)) {
+            this.momentumAccumulators.set(agentId, {
+                value: 0,
+                lastUpdate: new Date(),
+                decayRate: this.momentumDecayRate
+            });
+        }
+        return this.momentumAccumulators.get(agentId);
+    }
+    decayMomentum(accumulator) {
+        const now = Date.now();
+        const elapsed = now - accumulator.lastUpdate.getTime();
+        const cyclesElapsed = Math.floor(elapsed / 1000); // Assume 1 second per cycle
+        if (cyclesElapsed > 0) {
+            accumulator.value *= Math.pow(accumulator.decayRate, cyclesElapsed);
+            accumulator.lastUpdate = new Date();
+        }
+    }
+    addToHistory(agentId, surprise) {
+        const history = this.surpriseHistory.get(agentId) || [];
+        history.push(surprise);
+        if (history.length > this.historyWindowSize) {
+            history.shift();
+        }
+        this.surpriseHistory.set(agentId, history);
+    }
+    createSurpriseDetection(surpriseScore, prediction, outcome) {
+        const isSurprising = surpriseScore > this.surpriseThreshold;
+        let type;
+        let explanation;
+        let expectation;
+        if (isSurprising) {
+            if (prediction) {
+                type = 'prediction_failure';
+                explanation = `Predicted outcome did not match actual outcome (confidence: ${prediction.confidence.toFixed(2)})`;
+                expectation = {
+                    expected: prediction.predictedOutcome,
+                    confidence: prediction.confidence,
+                    source: 'learning',
+                    basedOn: [prediction.id]
+                };
+            }
+            else {
+                type = 'novel_pattern';
+                explanation = 'Encountered unexpected pattern without prior prediction';
+                expectation = {
+                    expected: null,
+                    confidence: 0,
+                    source: 'prior',
+                    basedOn: []
+                };
+            }
+        }
+        return {
+            isSurprising,
+            surpriseScore,
+            type,
+            explanation,
+            expectation,
+            observation: outcome.content,
+            suggestedActions: isSurprising
+                ? ['Promote to slower memory stratum', 'Analyze pattern', 'Update expectations']
+                : undefined
+        };
+    }
+    createDefaultSurpriseSignal() {
+        return {
+            momentarySurprise: 0,
+            pastSurprise: 0,
+            effectiveSurprise: 0,
+            detection: {
+                isSurprising: false,
+                surpriseScore: 0,
+                observation: ''
+            }
+        };
+    }
+}
+//# sourceMappingURL=SurpriseCalculator.js.map

package/dist/services/SurpriseCalculator.js.map

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

package/dist/services/SystemLlmMemoryAnalyzer.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Copyright 2024 Brad Anderson
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *
+ * @author Brad Anderson <BradA1878@pm.me>
+ * @repository https://github.com/mxf-dev/mxf
+ * @documentation https://mxf-dev.github.io/mxf/
+ */
+/**
+ * SystemLLM Memory Analyzer
+ *
+ * Adapter that integrates SystemLLM service for intelligent memory content analysis.
+ * This bridges the server-side SystemLLM with the client-side AutoMemoryCreator.
+ */
+import { ISystemLlmAnalyzer, MemoryAnalysisResult } from './AutoMemoryCreator.js';
+/**
+ * SystemLLM Memory Analyzer implementation
+ *
+ * This class acts as an adapter between AutoMemoryCreator and SystemLLM service.
+ * It uses the server-side SystemLLM for intelligent content analysis.
+ */
+export declare class SystemLlmMemoryAnalyzer implements ISystemLlmAnalyzer {
+    private systemLlmService;
+    constructor(systemLlmService?: any);
+    /**
+     * Analyze memory content using SystemLLM for intelligent decision making
+     */
+    analyzeMemoryContent(content: string, context?: Record<string, any>): Promise<MemoryAnalysisResult>;
+    /**
+     * Summarize content using SystemLLM
+     */
+    summarizeContent(content: string, maxLength?: number): Promise<string>;
+    /**
+     * Extract key insights using SystemLLM
+     */
+    extractKeyInsights(content: string, context?: Record<string, any>): Promise<string[]>;
+    /**
+     * Generate tags using SystemLLM
+     */
+    generateTags(content: string, context?: Record<string, any>): Promise<string[]>;
+    /**
+     * Build comprehensive memory analysis prompt
+     */
+    private buildMemoryAnalysisPrompt;
+    /**
+     * Validate analysis result structure
+     */
+    private validateAnalysisResult;
+    /**
+     * Create fallback analysis when SystemLLM fails
+     */
+    private createFallbackAnalysis;
+    /**
+     * Fallback content summarization
+     */
+    private fallbackSummarize;
+    /**
+     * Fallback tag generation
+     */
+    private fallbackTags;
+}
+//# sourceMappingURL=SystemLlmMemoryAnalyzer.d.ts.map

package/dist/services/SystemLlmMemoryAnalyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SystemLlmMemoryAnalyzer.d.ts","sourceRoot":"","sources":["../../src/services/SystemLlmMemoryAnalyzer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH;;;;;GAKG;AAEH,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAuElF;;;;;GAKG;AACH,qBAAa,uBAAwB,YAAW,kBAAkB;IAC9D,OAAO,CAAC,gBAAgB,CAAM;gBAElB,gBAAgB,CAAC,EAAE,GAAG;IAIlC;;OAEG;IACU,oBAAoB,CAC7B,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAC9B,OAAO,CAAC,oBAAoB,CAAC;IA4ChC;;OAEG;IACU,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IA+BnF;;OAEG;IACU,kBAAkB,CAC3B,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAC9B,OAAO,CAAC,MAAM,EAAE,CAAC;IA4CpB;;OAEG;IACU,YAAY,CACrB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAC9B,OAAO,CAAC,MAAM,EAAE,CAAC;IA8CpB;;OAEG;IACH,OAAO,CAAC,yBAAyB;IAuCjC;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAqB9B;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAiB9B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAUzB;;OAEG;IACH,OAAO,CAAC,YAAY;CAqBvB"}