universal-agent-memory 0.6.3 → 0.7.0

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"}

package/dist/memory/memory-consolidator.js

@@ -0,0 +1,348 @@
+/**
+ * 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
+ */
+import { createHash } from 'crypto';
+import { existsSync } from 'fs';
+import Database from 'better-sqlite3';
+import { summarizeMemories, compressMemoryEntry } from './context-compressor.js';
+import { getEmbeddingService } from './embeddings.js';
+const DEFAULT_CONFIG = {
+    triggerThreshold: 10,
+    minImportanceForLongTerm: 7,
+    similarityThreshold: 0.92,
+    maxSummaryLength: 500,
+};
+/**
+ * Memory Consolidation Service
+ */
+export class MemoryConsolidator {
+    config;
+    db = null;
+    contentHashes = new Set();
+    lastConsolidationId = 0;
+    constructor(config = {}) {
+        this.config = { ...DEFAULT_CONFIG, ...config };
+    }
+    /**
+     * Initialize with database connection
+     */
+    initialize(dbPath) {
+        if (!existsSync(dbPath)) {
+            throw new Error(`Database not found: ${dbPath}`);
+        }
+        this.db = new Database(dbPath);
+        this.loadContentHashes();
+    }
+    /**
+     * Load existing content hashes for deduplication
+     */
+    loadContentHashes() {
+        if (!this.db)
+            return;
+        try {
+            const stmt = this.db.prepare(`
+        SELECT content FROM memories
+        UNION
+        SELECT content FROM session_memories
+      `);
+            const rows = stmt.all();
+            for (const row of rows) {
+                this.contentHashes.add(this.hashContent(row.content));
+            }
+        }
+        catch {
+            // Tables might not exist yet
+        }
+    }
+    /**
+     * Hash content for deduplication
+     */
+    hashContent(content) {
+        return createHash('md5')
+            .update(content.toLowerCase().trim())
+            .digest('hex');
+    }
+    /**
+     * Check if consolidation should run
+     */
+    shouldConsolidate() {
+        if (!this.db)
+            return false;
+        try {
+            const stmt = this.db.prepare(`
+        SELECT COUNT(*) as count, MAX(id) as maxId
+        FROM memories
+        WHERE id > ?
+      `);
+            const result = stmt.get(this.lastConsolidationId);
+            return result.count >= this.config.triggerThreshold;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Run consolidation process
+     */
+    async consolidate() {
+        if (!this.db) {
+            throw new Error('Database not initialized');
+        }
+        const result = {
+            memoriesProcessed: 0,
+            summariesCreated: 0,
+            lessonsExtracted: 0,
+            duplicatesSkipped: 0,
+            tokensReduced: 0,
+        };
+        // Get memories since last consolidation
+        const stmt = this.db.prepare(`
+      SELECT id, timestamp, type, content
+      FROM memories
+      WHERE id > ?
+      ORDER BY id ASC
+      LIMIT 100
+    `);
+        const memories = stmt.all(this.lastConsolidationId);
+        if (memories.length === 0)
+            return result;
+        result.memoriesProcessed = memories.length;
+        const originalTokens = memories.reduce((sum, m) => sum + m.content.length / 4, 0);
+        // Group by type for summarization
+        const byType = {};
+        for (const mem of memories) {
+            if (!byType[mem.type])
+                byType[mem.type] = [];
+            byType[mem.type].push(mem);
+        }
+        // Create summaries for each type
+        for (const [_type, typeMemories] of Object.entries(byType)) {
+            if (typeMemories.length >= 3) {
+                const summary = summarizeMemories(typeMemories.map(m => ({
+                    content: m.content,
+                    timestamp: m.timestamp,
+                    type: m.type,
+                })), this.config.maxSummaryLength);
+                const summaryHash = this.hashContent(summary);
+                if (!this.contentHashes.has(summaryHash)) {
+                    // Store in session_memories
+                    await this.storeSessionMemory(summary, 'summary', 6);
+                    this.contentHashes.add(summaryHash);
+                    result.summariesCreated++;
+                }
+                else {
+                    result.duplicatesSkipped++;
+                }
+            }
+        }
+        // Extract lessons from high-importance observations
+        const lessons = memories.filter(m => m.type === 'observation' &&
+            this.detectLesson(m.content));
+        for (const lesson of lessons) {
+            const compressed = compressMemoryEntry(lesson.content, { compressionLevel: 'medium' });
+            const hash = this.hashContent(compressed.compressed);
+            if (!this.contentHashes.has(hash)) {
+                // Check semantic similarity
+                const isDuplicate = await this.checkSemanticDuplicate(compressed.compressed);
+                if (!isDuplicate) {
+                    await this.storeLesson(compressed.compressed, lesson.timestamp);
+                    this.contentHashes.add(hash);
+                    result.lessonsExtracted++;
+                }
+                else {
+                    result.duplicatesSkipped++;
+                }
+            }
+            else {
+                result.duplicatesSkipped++;
+            }
+        }
+        // Calculate token reduction
+        const summaryTokens = result.summariesCreated * (this.config.maxSummaryLength / 4);
+        const lessonTokens = result.lessonsExtracted * 100; // Approximate
+        result.tokensReduced = Math.max(0, originalTokens - summaryTokens - lessonTokens);
+        // Update last consolidation pointer
+        this.lastConsolidationId = memories[memories.length - 1].id;
+        return result;
+    }
+    /**
+     * Detect if content contains a lesson/insight
+     */
+    detectLesson(content) {
+        const lessonIndicators = [
+            /learned that/i,
+            /important to/i,
+            /mistake was/i,
+            /better to/i,
+            /should always/i,
+            /should never/i,
+            /key insight/i,
+            /gotcha/i,
+            /watch out for/i,
+            /best practice/i,
+            /pattern/i,
+            /tip:/i,
+        ];
+        return lessonIndicators.some(pattern => pattern.test(content));
+    }
+    /**
+     * Check for semantic duplicates using embeddings
+     */
+    async checkSemanticDuplicate(content) {
+        if (!this.db)
+            return false;
+        try {
+            const embeddingService = getEmbeddingService();
+            const newEmbedding = await embeddingService.embed(content);
+            // Get recent session memories for comparison
+            const stmt = this.db.prepare(`
+        SELECT content FROM session_memories
+        ORDER BY id DESC
+        LIMIT 50
+      `);
+            const existing = stmt.all();
+            for (const { content: existingContent } of existing) {
+                const existingEmbedding = await embeddingService.embed(existingContent);
+                const similarity = embeddingService.cosineSimilarity(newEmbedding, existingEmbedding);
+                if (similarity > this.config.similarityThreshold) {
+                    return true;
+                }
+            }
+            return false;
+        }
+        catch {
+            // Fall back to text comparison
+            const normalizedNew = content.toLowerCase().trim();
+            const stmt = this.db.prepare(`
+        SELECT content FROM session_memories
+        WHERE LOWER(TRIM(content)) = ?
+        LIMIT 1
+      `);
+            const match = stmt.get(normalizedNew);
+            return !!match;
+        }
+    }
+    /**
+     * Store session memory
+     */
+    async storeSessionMemory(content, type, importance) {
+        if (!this.db)
+            return;
+        const stmt = this.db.prepare(`
+      INSERT OR IGNORE INTO session_memories (session_id, timestamp, type, content, importance)
+      VALUES ('consolidation', ?, ?, ?, ?)
+    `);
+        stmt.run(new Date().toISOString(), type, content, importance);
+    }
+    /**
+     * Store lesson in long-term memory
+     */
+    async storeLesson(content, timestamp) {
+        if (!this.db)
+            return;
+        const stmt = this.db.prepare(`
+      INSERT OR IGNORE INTO session_memories (session_id, timestamp, type, content, importance)
+      VALUES ('lessons', ?, 'lesson', ?, ?)
+    `);
+        stmt.run(timestamp, content, this.config.minImportanceForLongTerm);
+    }
+    /**
+     * Run decay on old memories
+     * Formula: effective_importance = importance × (0.95 ^ days_since_access)
+     */
+    async runDecay() {
+        if (!this.db)
+            return 0;
+        try {
+            // SQLite doesn't have POW, so we do this in application code
+            const stmt = this.db.prepare(`
+        SELECT id, importance, timestamp
+        FROM session_memories
+        WHERE importance > 1
+      `);
+            const rows = stmt.all();
+            let updated = 0;
+            const now = Date.now();
+            const updateStmt = this.db.prepare(`
+        UPDATE session_memories
+        SET importance = ?
+        WHERE id = ?
+      `);
+            for (const row of rows) {
+                const daysSince = (now - new Date(row.timestamp).getTime()) / (1000 * 60 * 60 * 24);
+                const decayed = Math.round(row.importance * Math.pow(0.95, daysSince));
+                if (decayed !== row.importance && decayed >= 1) {
+                    updateStmt.run(decayed, row.id);
+                    updated++;
+                }
+            }
+            return updated;
+        }
+        catch {
+            return 0;
+        }
+    }
+    /**
+     * Get consolidation stats
+     */
+    getStats() {
+        if (!this.db) {
+            return {
+                totalMemories: 0,
+                totalSessionMemories: 0,
+                totalLessons: 0,
+                lastConsolidationId: this.lastConsolidationId,
+                uniqueHashes: this.contentHashes.size,
+            };
+        }
+        try {
+            const memoriesStmt = this.db.prepare('SELECT COUNT(*) as count FROM memories');
+            const sessionStmt = this.db.prepare('SELECT COUNT(*) as count FROM session_memories');
+            const lessonsStmt = this.db.prepare(`
+        SELECT COUNT(*) as count FROM session_memories WHERE type = 'lesson'
+      `);
+            const memories = memoriesStmt.get().count;
+            const session = sessionStmt.get().count;
+            const lessons = lessonsStmt.get().count;
+            return {
+                totalMemories: memories,
+                totalSessionMemories: session,
+                totalLessons: lessons,
+                lastConsolidationId: this.lastConsolidationId,
+                uniqueHashes: this.contentHashes.size,
+            };
+        }
+        catch {
+            return {
+                totalMemories: 0,
+                totalSessionMemories: 0,
+                totalLessons: 0,
+                lastConsolidationId: this.lastConsolidationId,
+                uniqueHashes: this.contentHashes.size,
+            };
+        }
+    }
+    /**
+     * Close database connection
+     */
+    close() {
+        if (this.db) {
+            this.db.close();
+            this.db = null;
+        }
+    }
+}
+// Singleton instance
+let globalConsolidator = null;
+export function getMemoryConsolidator(config) {
+    if (!globalConsolidator) {
+        globalConsolidator = new MemoryConsolidator(config);
+    }
+    return globalConsolidator;
+}
+//# sourceMappingURL=memory-consolidator.js.map

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

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

package/dist/memory/speculative-cache.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Speculative Cache for UAM Memory System
+ *
+ * Pre-computes likely next queries based on task patterns.
+ * Reduces latency by predicting and caching memory retrievals.
+ */
+export interface CacheEntry {
+    query: string;
+    result: unknown[];
+    embedding?: number[];
+    usageCount: number;
+    lastUsed: Date;
+    createdAt: Date;
+    predictedBy?: string;
+}
+export interface CacheConfig {
+    maxEntries: number;
+    ttlMs: number;
+    preWarmEnabled: boolean;
+    predictionDepth: number;
+}
+/**
+ * Speculative Memory Cache
+ */
+export declare class SpeculativeCache {
+    private config;
+    private cache;
+    private queryHistory;
+    private taskPatterns;
+    constructor(config?: Partial<CacheConfig>);
+    /**
+     * Get from cache with automatic staleness check
+     */
+    get(query: string): CacheEntry | null;
+    /**
+     * Set cache entry
+     */
+    set(query: string, result: unknown[], predictedBy?: string): void;
+    /**
+     * Record query for pattern analysis
+     */
+    private recordQuery;
+    /**
+     * Detect task category from query
+     */
+    private detectCategory;
+    /**
+     * Get predicted queries based on current context
+     */
+    getPredictedQueries(currentQuery: string): string[];
+    /**
+     * Analyze query sequences for patterns
+     */
+    private analyzeQuerySequences;
+    /**
+     * Pre-warm cache with predicted queries
+     */
+    preWarm(currentQuery: string, fetcher: (query: string) => Promise<unknown[]>): Promise<void>;
+    /**
+     * Evict least recently used entry
+     */
+    private evictLRU;
+    /**
+     * Normalize query for cache key
+     */
+    private normalizeQuery;
+    /**
+     * Get cache statistics
+     */
+    getStats(): {
+        size: number;
+        hitRate: number;
+        avgUsage: number;
+        topPatterns: Array<{
+            category: string;
+            count: number;
+        }>;
+    };
+    /**
+     * Clear expired entries
+     */
+    cleanup(): number;
+    /**
+     * Clear all cache
+     */
+    clear(): void;
+}
+export declare function getSpeculativeCache(config?: Partial<CacheConfig>): SpeculativeCache;
+//# sourceMappingURL=speculative-cache.d.ts.map

package/dist/memory/speculative-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"speculative-cache.d.ts","sourceRoot":"","sources":["../../src/memory/speculative-cache.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,OAAO,EAAE,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,IAAI,CAAC;IACf,SAAS,EAAE,IAAI,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,EAAE,OAAO,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;CACzB;AAuCD;;GAEG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,KAAK,CAAsC;IACnD,OAAO,CAAC,YAAY,CAAgB;IACpC,OAAO,CAAC,YAAY,CAAkC;gBAE1C,MAAM,GAAE,OAAO,CAAC,WAAW,CAAM;IAI7C;;OAEG;IACH,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI;IAoBrC;;OAEG;IACH,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI;IAqBjE;;OAEG;IACH,OAAO,CAAC,WAAW;IAgBnB;;OAEG;IACH,OAAO,CAAC,cAAc;IActB;;OAEG;IACH,mBAAmB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,EAAE;IAkBnD;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAiC7B;;OAEG;IACG,OAAO,CACX,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,EAAE,CAAC,GAC7C,OAAO,CAAC,IAAI,CAAC;IAoBhB;;OAEG;IACH,OAAO,CAAC,QAAQ;IAehB;;OAEG;IACH,OAAO,CAAC,cAAc;IAItB;;OAEG;IACH,QAAQ,IAAI;QACV,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE,MAAM,CAAC;QACjB,WAAW,EAAE,KAAK,CAAC;YAAE,QAAQ,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KACzD;IAkBD;;OAEG;IACH,OAAO,IAAI,MAAM;IAejB;;OAEG;IACH,KAAK,IAAI,IAAI;CAKd;AAKD,wBAAgB,mBAAmB,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG,gBAAgB,CAKnF"}