universal-agent-memory 0.6.2 → 0.7.0

package/dist/memory/hierarchical-memory.js

@@ -0,0 +1,299 @@
+/**
+ * Hierarchical Memory System for UAM
+ *
+ * Implements hot/warm/cold memory tiering with automatic promotion/demotion.
+ * Based on MemGPT and R³Mem research for efficient memory management.
+ */
+import { getEmbeddingService } from './embeddings.js';
+import { compressMemoryEntry, summarizeMemories, estimateTokens } from './context-compressor.js';
+const DEFAULT_CONFIG = {
+    hotMaxEntries: 10,
+    warmMaxEntries: 50,
+    coldMaxEntries: 500,
+    hotMaxTokens: 2000,
+    decayRate: 0.95,
+    promotionThreshold: 0.7,
+    demotionThreshold: 0.3,
+};
+/**
+ * Calculate effective importance with time decay
+ * Formula: effective_importance = importance × (decayRate ^ days_since_access)
+ */
+export function calculateEffectiveImportance(entry, decayRate = 0.95) {
+    const lastAccessed = new Date(entry.lastAccessed);
+    const now = new Date();
+    const daysSinceAccess = (now.getTime() - lastAccessed.getTime()) / (1000 * 60 * 60 * 24);
+    return entry.importance * Math.pow(decayRate, daysSinceAccess);
+}
+/**
+ * Hierarchical Memory Manager
+ */
+export class HierarchicalMemoryManager {
+    config;
+    memory;
+    accessLog = new Map();
+    constructor(config = {}) {
+        this.config = { ...DEFAULT_CONFIG, ...config };
+        this.memory = { hot: [], warm: [], cold: [] };
+    }
+    /**
+     * Add a new memory entry
+     */
+    add(entry) {
+        const now = new Date().toISOString();
+        const fullEntry = {
+            ...entry,
+            accessCount: 1,
+            lastAccessed: now,
+            tier: 'hot',
+        };
+        // Add to hot tier
+        this.memory.hot.unshift(fullEntry);
+        // Trigger rebalancing
+        this.rebalance();
+    }
+    /**
+     * Access a memory (promote if accessed frequently)
+     */
+    access(id) {
+        const entry = this.findEntry(id);
+        if (!entry)
+            return null;
+        // Update access metrics
+        entry.accessCount++;
+        entry.lastAccessed = new Date().toISOString();
+        // Log access for pattern analysis
+        const now = Date.now();
+        const accessTimes = this.accessLog.get(id) || [];
+        accessTimes.push(now);
+        this.accessLog.set(id, accessTimes.slice(-10)); // Keep last 10 access times
+        // Check for promotion
+        this.checkPromotion(entry);
+        return entry;
+    }
+    /**
+     * Query memories with automatic tier traversal
+     */
+    async query(queryText, limit = 5) {
+        const results = [];
+        const embeddingService = getEmbeddingService();
+        // First check hot tier (always include recent)
+        for (const entry of this.memory.hot) {
+            const score = this.textSimilarity(queryText, entry.content);
+            if (score > 0.3) {
+                results.push({ entry, score: score + 0.3 }); // Bonus for hot tier
+            }
+        }
+        // Check warm tier
+        for (const entry of this.memory.warm) {
+            const score = this.textSimilarity(queryText, entry.content);
+            if (score > 0.4) {
+                results.push({ entry, score: score + 0.1 }); // Small bonus for warm
+            }
+        }
+        // Semantic search in cold tier if we need more results
+        if (results.length < limit && this.memory.cold.length > 0) {
+            try {
+                const queryEmbedding = await embeddingService.embed(queryText);
+                for (const entry of this.memory.cold) {
+                    if (entry.embedding) {
+                        const score = embeddingService.cosineSimilarity(queryEmbedding, entry.embedding);
+                        if (score > 0.5) {
+                            results.push({ entry, score });
+                        }
+                    }
+                }
+            }
+            catch {
+                // Fall back to text similarity
+                for (const entry of this.memory.cold) {
+                    const score = this.textSimilarity(queryText, entry.content);
+                    if (score > 0.5) {
+                        results.push({ entry, score });
+                    }
+                }
+            }
+        }
+        // Sort by score and return top entries
+        results.sort((a, b) => b.score - a.score);
+        const topEntries = results.slice(0, limit).map(r => r.entry);
+        // Mark accessed entries
+        for (const entry of topEntries) {
+            this.access(entry.id);
+        }
+        return topEntries;
+    }
+    /**
+     * Get hot tier context (for inclusion in prompts)
+     */
+    getHotContext() {
+        let totalTokens = 0;
+        const entries = [];
+        for (const entry of this.memory.hot) {
+            const tokens = estimateTokens(entry.content);
+            if (totalTokens + tokens <= this.config.hotMaxTokens) {
+                entries.push(entry);
+                totalTokens += tokens;
+            }
+        }
+        return { entries, tokens: totalTokens };
+    }
+    /**
+     * Consolidate old memories into summaries
+     */
+    async consolidate() {
+        const now = Date.now();
+        const oneDayAgo = now - 24 * 60 * 60 * 1000;
+        // Find old warm entries to summarize
+        const oldWarm = this.memory.warm.filter(e => new Date(e.lastAccessed).getTime() < oneDayAgo);
+        if (oldWarm.length >= 10) {
+            // Create summary
+            const summary = summarizeMemories(oldWarm);
+            // Add summary as new cold entry
+            const summaryEntry = {
+                id: `summary-${Date.now()}`,
+                content: summary,
+                type: 'observation',
+                timestamp: new Date().toISOString(),
+                importance: 6,
+                accessCount: 1,
+                lastAccessed: new Date().toISOString(),
+                tier: 'cold',
+            };
+            this.memory.cold.unshift(summaryEntry);
+            // Remove summarized entries from warm
+            const oldIds = new Set(oldWarm.map(e => e.id));
+            this.memory.warm = this.memory.warm.filter(e => !oldIds.has(e.id));
+            // Limit cold tier size
+            if (this.memory.cold.length > this.config.coldMaxEntries) {
+                this.memory.cold = this.memory.cold.slice(0, this.config.coldMaxEntries);
+            }
+        }
+    }
+    /**
+     * Rebalance tiers based on importance and access patterns
+     */
+    rebalance() {
+        const { hotMaxEntries, warmMaxEntries, decayRate } = this.config;
+        // Calculate effective importance for all entries
+        const scoredHot = this.memory.hot.map(e => ({
+            entry: e,
+            score: calculateEffectiveImportance(e, decayRate),
+        }));
+        const scoredWarm = this.memory.warm.map(e => ({
+            entry: e,
+            score: calculateEffectiveImportance(e, decayRate),
+        }));
+        // Sort hot tier
+        scoredHot.sort((a, b) => b.score - a.score);
+        // Demote excess hot entries to warm
+        if (scoredHot.length > hotMaxEntries) {
+            const demoted = scoredHot.slice(hotMaxEntries);
+            for (const { entry } of demoted) {
+                entry.tier = 'warm';
+                this.memory.warm.unshift(entry);
+            }
+            this.memory.hot = scoredHot.slice(0, hotMaxEntries).map(s => s.entry);
+        }
+        // Sort warm tier
+        scoredWarm.sort((a, b) => b.score - a.score);
+        // Demote excess warm entries to cold
+        if (this.memory.warm.length > warmMaxEntries) {
+            const demoted = this.memory.warm.slice(warmMaxEntries);
+            for (const entry of demoted) {
+                entry.tier = 'cold';
+                // Compress content before moving to cold
+                const compressed = compressMemoryEntry(entry.content, { compressionLevel: 'aggressive' });
+                entry.compressed = compressed.compressed;
+                this.memory.cold.unshift(entry);
+            }
+            this.memory.warm = this.memory.warm.slice(0, warmMaxEntries);
+        }
+    }
+    /**
+     * Check and promote entry if accessed frequently
+     */
+    checkPromotion(entry) {
+        if (entry.tier === 'hot')
+            return;
+        const accessTimes = this.accessLog.get(entry.id) || [];
+        // Calculate access frequency (accesses per hour)
+        if (accessTimes.length >= 3) {
+            const timeSpan = accessTimes[accessTimes.length - 1] - accessTimes[0];
+            const hoursSpan = timeSpan / (1000 * 60 * 60) || 1;
+            const frequency = accessTimes.length / hoursSpan;
+            // Promote if accessed more than once per hour
+            if (frequency > 1 && entry.tier === 'warm') {
+                entry.tier = 'hot';
+                this.memory.warm = this.memory.warm.filter(e => e.id !== entry.id);
+                this.memory.hot.unshift(entry);
+                this.rebalance();
+            }
+            else if (frequency > 0.5 && entry.tier === 'cold') {
+                entry.tier = 'warm';
+                this.memory.cold = this.memory.cold.filter(e => e.id !== entry.id);
+                this.memory.warm.unshift(entry);
+                this.rebalance();
+            }
+        }
+    }
+    /**
+     * Find entry across all tiers
+     */
+    findEntry(id) {
+        for (const tier of ['hot', 'warm', 'cold']) {
+            const entry = this.memory[tier].find(e => e.id === id);
+            if (entry)
+                return entry;
+        }
+        return null;
+    }
+    /**
+     * Simple text similarity (Jaccard on words)
+     */
+    textSimilarity(a, b) {
+        const wordsA = new Set(a.toLowerCase().split(/\W+/).filter(w => w.length > 2));
+        const wordsB = new Set(b.toLowerCase().split(/\W+/).filter(w => w.length > 2));
+        const intersection = new Set([...wordsA].filter(x => wordsB.has(x)));
+        const union = new Set([...wordsA, ...wordsB]);
+        return intersection.size / (union.size || 1);
+    }
+    /**
+     * Get stats about memory usage
+     */
+    getStats() {
+        const hotTokens = this.memory.hot.reduce((sum, e) => sum + estimateTokens(e.content), 0);
+        const warmTokens = this.memory.warm.reduce((sum, e) => sum + estimateTokens(e.content), 0);
+        const coldTokens = this.memory.cold.reduce((sum, e) => sum + estimateTokens(e.compressed || e.content), 0);
+        return {
+            hot: { count: this.memory.hot.length, tokens: hotTokens },
+            warm: { count: this.memory.warm.length, tokens: warmTokens },
+            cold: { count: this.memory.cold.length, tokens: coldTokens },
+            total: {
+                count: this.memory.hot.length + this.memory.warm.length + this.memory.cold.length,
+                tokens: hotTokens + warmTokens + coldTokens,
+            },
+        };
+    }
+    /**
+     * Export all memories (for persistence)
+     */
+    export() {
+        return { ...this.memory };
+    }
+    /**
+     * Import memories (for initialization)
+     */
+    import(data) {
+        this.memory = { ...data };
+    }
+}
+// Singleton instance
+let globalManager = null;
+export function getHierarchicalMemoryManager(config) {
+    if (!globalManager) {
+        globalManager = new HierarchicalMemoryManager(config);
+    }
+    return globalManager;
+}
+//# sourceMappingURL=hierarchical-memory.js.map

package/dist/memory/hierarchical-memory.js.map

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

package/dist/memory/memory-consolidator.d.ts

@@ -0,0 +1,88 @@
+/**
+ * Memory Consolidation Service for UAM
+ *
+ * Implements the consolidation rules from CLAUDE.md:
+ * - Trigger: Every 10 working memory entries
+ * - Action: Summarize → session_memories, Extract lessons → semantic memory
+ * - Dedup: Skip if content_hash exists OR similarity > 0.92
+ */
+export interface ConsolidationConfig {
+    triggerThreshold: number;
+    minImportanceForLongTerm: number;
+    similarityThreshold: number;
+    maxSummaryLength: number;
+}
+export interface ConsolidationResult {
+    memoriesProcessed: number;
+    summariesCreated: number;
+    lessonsExtracted: number;
+    duplicatesSkipped: number;
+    tokensReduced: number;
+}
+/**
+ * Memory Consolidation Service
+ */
+export declare class MemoryConsolidator {
+    private config;
+    private db;
+    private contentHashes;
+    private lastConsolidationId;
+    constructor(config?: Partial<ConsolidationConfig>);
+    /**
+     * Initialize with database connection
+     */
+    initialize(dbPath: string): void;
+    /**
+     * Load existing content hashes for deduplication
+     */
+    private loadContentHashes;
+    /**
+     * Hash content for deduplication
+     */
+    private hashContent;
+    /**
+     * Check if consolidation should run
+     */
+    shouldConsolidate(): boolean;
+    /**
+     * Run consolidation process
+     */
+    consolidate(): Promise<ConsolidationResult>;
+    /**
+     * Detect if content contains a lesson/insight
+     */
+    private detectLesson;
+    /**
+     * Check for semantic duplicates using embeddings
+     */
+    private checkSemanticDuplicate;
+    /**
+     * Store session memory
+     */
+    private storeSessionMemory;
+    /**
+     * Store lesson in long-term memory
+     */
+    private storeLesson;
+    /**
+     * Run decay on old memories
+     * Formula: effective_importance = importance × (0.95 ^ days_since_access)
+     */
+    runDecay(): Promise<number>;
+    /**
+     * Get consolidation stats
+     */
+    getStats(): {
+        totalMemories: number;
+        totalSessionMemories: number;
+        totalLessons: number;
+        lastConsolidationId: number;
+        uniqueHashes: number;
+    };
+    /**
+     * Close database connection
+     */
+    close(): void;
+}
+export declare function getMemoryConsolidator(config?: Partial<ConsolidationConfig>): MemoryConsolidator;
+//# sourceMappingURL=memory-consolidator.d.ts.map

package/dist/memory/memory-consolidator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-consolidator.d.ts","sourceRoot":"","sources":["../../src/memory/memory-consolidator.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAQH,MAAM,WAAW,mBAAmB;IAClC,gBAAgB,EAAE,MAAM,CAAC;IACzB,wBAAwB,EAAE,MAAM,CAAC;IACjC,mBAAmB,EAAE,MAAM,CAAC;IAC5B,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AASD,MAAM,WAAW,mBAAmB;IAClC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,MAAM,CAAsB;IACpC,OAAO,CAAC,EAAE,CAAkC;IAC5C,OAAO,CAAC,aAAa,CAA0B;IAC/C,OAAO,CAAC,mBAAmB,CAAa;gBAE5B,MAAM,GAAE,OAAO,CAAC,mBAAmB,CAAM;IAIrD;;OAEG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAQhC;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAmBzB;;OAEG;IACH,OAAO,CAAC,WAAW;IAMnB;;OAEG;IACH,iBAAiB,IAAI,OAAO;IAiB5B;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,mBAAmB,CAAC;IAsGjD;;OAEG;IACH,OAAO,CAAC,YAAY;IAmBpB;;OAEG;YACW,sBAAsB;IAwCpC;;OAEG;YACW,kBAAkB;IAehC;;OAEG;YACW,WAAW;IAWzB;;;OAGG;IACG,QAAQ,IAAI,OAAO,CAAC,MAAM,CAAC;IAwCjC;;OAEG;IACH,QAAQ,IAAI;QACV,aAAa,EAAE,MAAM,CAAC;QACtB,oBAAoB,EAAE,MAAM,CAAC;QAC7B,YAAY,EAAE,MAAM,CAAC;QACrB,mBAAmB,EAAE,MAAM,CAAC;QAC5B,YAAY,EAAE,MAAM,CAAC;KACtB;IAwCD;;OAEG;IACH,KAAK,IAAI,IAAI;CAMd;AAKD,wBAAgB,qBAAqB,CACnC,MAAM,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC,GACpC,kBAAkB,CAKpB"}