@stackmemoryai/stackmemory 0.2.8 → 0.3.0

package/dist/src/core/performance/context-cache.js

@@ -0,0 +1,280 @@
+/**
+ * High-Performance Context Cache
+ * LRU cache with TTL for frequently accessed context data
+ */
+import { EventEmitter } from 'events';
+import { logger } from '../monitoring/logger.js';
+export class ContextCache extends EventEmitter {
+    cache = new Map();
+    accessOrder = [];
+    options;
+    stats;
+    currentSize = 0;
+    constructor(options = {}) {
+        super();
+        this.options = {
+            maxSize: options.maxSize || 100 * 1024 * 1024, // 100MB default
+            maxItems: options.maxItems || 10000,
+            defaultTTL: options.defaultTTL || 3600000, // 1 hour default
+            enableStats: options.enableStats ?? true,
+            onEvict: options.onEvict || (() => { }),
+        };
+        this.stats = {
+            hits: 0,
+            misses: 0,
+            evictions: 0,
+            size: 0,
+            itemCount: 0,
+            hitRate: 0,
+            avgAccessTime: 0,
+        };
+    }
+    /**
+     * Get item from cache
+     */
+    get(key) {
+        const startTime = Date.now();
+        const entry = this.cache.get(key);
+        if (!entry) {
+            this.stats.misses++;
+            this.updateHitRate();
+            return undefined;
+        }
+        // Check TTL
+        if (entry.ttl && Date.now() - entry.createdAt > entry.ttl) {
+            this.delete(key);
+            this.stats.misses++;
+            this.updateHitRate();
+            return undefined;
+        }
+        // Update access tracking
+        entry.hits++;
+        entry.lastAccessed = Date.now();
+        this.updateAccessOrder(key);
+        this.stats.hits++;
+        this.updateHitRate();
+        this.updateAvgAccessTime(Date.now() - startTime);
+        return entry.value;
+    }
+    /**
+     * Set item in cache
+     */
+    set(key, value, options = {}) {
+        const size = options.size || this.estimateSize(value);
+        const ttl = options.ttl ?? this.options.defaultTTL;
+        // Check if we need to evict
+        if (this.cache.size >= this.options.maxItems ||
+            this.currentSize + size > this.options.maxSize) {
+            this.evict(size);
+        }
+        // Remove old entry if exists
+        if (this.cache.has(key)) {
+            this.delete(key);
+        }
+        const entry = {
+            value,
+            size,
+            hits: 0,
+            createdAt: Date.now(),
+            lastAccessed: Date.now(),
+            ttl,
+        };
+        this.cache.set(key, entry);
+        this.accessOrder.push(key);
+        this.currentSize += size;
+        this.stats.size = this.currentSize;
+        this.stats.itemCount = this.cache.size;
+        this.emit('set', key, value);
+    }
+    /**
+     * Delete item from cache
+     */
+    delete(key) {
+        const entry = this.cache.get(key);
+        if (!entry)
+            return false;
+        this.cache.delete(key);
+        this.currentSize -= entry.size;
+        this.accessOrder = this.accessOrder.filter(k => k !== key);
+        this.stats.size = this.currentSize;
+        this.stats.itemCount = this.cache.size;
+        this.emit('delete', key);
+        return true;
+    }
+    /**
+     * Clear entire cache
+     */
+    clear() {
+        const oldSize = this.cache.size;
+        this.cache.clear();
+        this.accessOrder = [];
+        this.currentSize = 0;
+        this.stats.size = 0;
+        this.stats.itemCount = 0;
+        this.stats.evictions += oldSize;
+        this.emit('clear');
+    }
+    /**
+     * Check if key exists and is valid
+     */
+    has(key) {
+        const entry = this.cache.get(key);
+        if (!entry)
+            return false;
+        // Check TTL
+        if (entry.ttl && Date.now() - entry.createdAt > entry.ttl) {
+            this.delete(key);
+            return false;
+        }
+        return true;
+    }
+    /**
+     * Get cache statistics
+     */
+    getStats() {
+        return { ...this.stats };
+    }
+    /**
+     * Get cache size info
+     */
+    getSize() {
+        return {
+            bytes: this.currentSize,
+            items: this.cache.size,
+            utilization: this.currentSize / this.options.maxSize,
+        };
+    }
+    /**
+     * Preload multiple items
+     */
+    preload(entries) {
+        const startTime = Date.now();
+        for (const entry of entries) {
+            this.set(entry.key, entry.value, {
+                ttl: entry.ttl,
+                size: entry.size,
+            });
+        }
+        logger.debug('Cache preload complete', {
+            items: entries.length,
+            duration: Date.now() - startTime,
+            cacheSize: this.currentSize,
+        });
+    }
+    /**
+     * Get multiple items efficiently
+     */
+    getMany(keys) {
+        const results = new Map();
+        for (const key of keys) {
+            const value = this.get(key);
+            if (value !== undefined) {
+                results.set(key, value);
+            }
+        }
+        return results;
+    }
+    /**
+     * Warm cache with computed values
+     */
+    async warmUp(keys, compute, options = {}) {
+        const { parallel = true } = options;
+        if (parallel) {
+            const promises = keys.map(async (key) => {
+                if (!this.has(key)) {
+                    const value = await compute(key);
+                    this.set(key, value, { ttl: options.ttl });
+                }
+            });
+            await Promise.all(promises);
+        }
+        else {
+            for (const key of keys) {
+                if (!this.has(key)) {
+                    const value = await compute(key);
+                    this.set(key, value, { ttl: options.ttl });
+                }
+            }
+        }
+    }
+    /**
+     * Get or compute value
+     */
+    async getOrCompute(key, compute, options = {}) {
+        const cached = this.get(key);
+        if (cached !== undefined) {
+            return cached;
+        }
+        const value = await compute();
+        this.set(key, value, options);
+        return value;
+    }
+    // Private methods
+    evict(requiredSize) {
+        const startEvictions = this.stats.evictions;
+        // LRU eviction
+        while ((this.cache.size >= this.options.maxItems ||
+            this.currentSize + requiredSize > this.options.maxSize) &&
+            this.accessOrder.length > 0) {
+            const keyToEvict = this.accessOrder.shift();
+            const entry = this.cache.get(keyToEvict);
+            if (entry) {
+                this.cache.delete(keyToEvict);
+                this.currentSize -= entry.size;
+                this.stats.evictions++;
+                this.options.onEvict(keyToEvict, entry);
+                this.emit('evict', keyToEvict, entry);
+            }
+        }
+        if (this.stats.evictions > startEvictions) {
+            logger.debug('Cache eviction', {
+                evicted: this.stats.evictions - startEvictions,
+                currentSize: this.currentSize,
+                requiredSize,
+            });
+        }
+    }
+    updateAccessOrder(key) {
+        const index = this.accessOrder.indexOf(key);
+        if (index > -1) {
+            this.accessOrder.splice(index, 1);
+        }
+        this.accessOrder.push(key);
+    }
+    estimateSize(value) {
+        // Simple size estimation - can be overridden for specific types
+        if (typeof value === 'string') {
+            return value.length * 2; // UTF-16
+        }
+        if (typeof value === 'object' && value !== null) {
+            return JSON.stringify(value).length * 2;
+        }
+        return 8; // Default for primitives
+    }
+    updateHitRate() {
+        const total = this.stats.hits + this.stats.misses;
+        this.stats.hitRate = total > 0 ? this.stats.hits / total : 0;
+    }
+    updateAvgAccessTime(time) {
+        const alpha = 0.1; // Exponential moving average factor
+        this.stats.avgAccessTime = this.stats.avgAccessTime * (1 - alpha) + time * alpha;
+    }
+    /**
+     * Cleanup expired entries periodically
+     */
+    startCleanup(intervalMs = 60000) {
+        return setInterval(() => {
+            let cleaned = 0;
+            for (const [key, entry] of this.cache.entries()) {
+                if (entry.ttl && Date.now() - entry.createdAt > entry.ttl) {
+                    this.delete(key);
+                    cleaned++;
+                }
+            }
+            if (cleaned > 0) {
+                logger.debug('Cache cleanup', { cleaned, remaining: this.cache.size });
+            }
+        }, intervalMs);
+    }
+}
+//# sourceMappingURL=context-cache.js.map

package/dist/src/core/performance/context-cache.js.map

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

package/dist/src/core/performance/index.d.ts

@@ -0,0 +1,3 @@
+export { PerformanceMonitor } from './monitor.js';
+export { PerformanceBenchmark } from './performance-benchmark.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/core/performance/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/performance/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/src/core/performance/index.js

@@ -0,0 +1,3 @@
+export { PerformanceMonitor } from './monitor.js';
+export { PerformanceBenchmark } from './performance-benchmark.js';
+//# sourceMappingURL=index.js.map

package/dist/src/core/performance/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/core/performance/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/src/core/performance/lazy-context-loader.d.ts

@@ -0,0 +1,93 @@
+/**
+ * Lazy Context Loader
+ * Deferred loading and progressive enhancement for context data
+ */
+import Database from 'better-sqlite3';
+import { Frame, Anchor, Event } from '../context/frame-manager.js';
+export interface LazyLoadOptions {
+    preloadDepth?: number;
+    chunkSize?: number;
+    priority?: 'recency' | 'relevance' | 'frequency';
+}
+export interface ContextChunk {
+    frames: Frame[];
+    anchors: Anchor[];
+    events: Event[];
+    metadata: {
+        chunkId: number;
+        totalChunks: number;
+        hasMore: boolean;
+        nextCursor?: string;
+    };
+}
+/**
+ * Lazy proxy for deferred data loading
+ */
+export declare class LazyProxy<T> {
+    private _value?;
+    private _promise?;
+    private _loader;
+    private _loaded;
+    constructor(loader: () => Promise<T>);
+    get(): Promise<T>;
+    isLoaded(): boolean;
+    peek(): T | undefined;
+    reset(): void;
+}
+export declare class LazyContextLoader {
+    private db;
+    private projectId;
+    private frameLoaders;
+    private anchorLoaders;
+    private eventLoaders;
+    constructor(db: Database.Database, projectId: string);
+    /**
+     * Create a lazy frame reference
+     */
+    lazyFrame(frameId: string): LazyProxy<Frame>;
+    /**
+     * Create lazy anchor references
+     */
+    lazyAnchors(frameId: string): LazyProxy<Anchor[]>;
+    /**
+     * Create lazy event references
+     */
+    lazyEvents(frameId: string, limit?: number): LazyProxy<Event[]>;
+    /**
+     * Progressive context loading with chunking
+     */
+    loadContextProgressive(frameIds: string[], options?: LazyLoadOptions): AsyncGenerator<ContextChunk, void, unknown>;
+    /**
+     * Preload context data for better performance
+     */
+    preloadContext(frameIds: string[], options?: {
+        parallel?: boolean;
+        depth?: number;
+    }): Promise<void>;
+    /**
+     * Load only frame headers (lightweight)
+     */
+    loadFrameHeaders(frameIds: string[]): Promise<Map<string, any>>;
+    /**
+     * Stream context data for memory efficiency
+     */
+    streamContext(query: string, params?: any[]): AsyncGenerator<Frame | Anchor | Event, void, unknown>;
+    /**
+     * Clear lazy loading cache
+     */
+    clearCache(): void;
+    /**
+     * Get cache statistics
+     */
+    getCacheStats(): {
+        frames: number;
+        anchors: number;
+        events: number;
+        loaded: number;
+    };
+    private loadFrame;
+    private loadAnchors;
+    private loadEvents;
+    private sortByPriority;
+}
+//# sourceMappingURL=lazy-context-loader.d.ts.map

package/dist/src/core/performance/lazy-context-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lazy-context-loader.d.ts","sourceRoot":"","sources":["../../../../src/core/performance/lazy-context-loader.ts"],"names":[],"mappings":"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"}