@dcyfr/ai 1.0.4 → 2.1.0

package/dist/ai/src/intelligent-cache-manager.d.ts

@@ -0,0 +1,327 @@
+/**
+ * Intelligent Cache Manager for DCYFR Integration System
+ * TLP:CLEAR
+ *
+ * High-performance caching system optimized for DCYFR integration workflows.
+ * Provides intelligent caching strategies for capability detection, agent data,
+ * MCP server configurations, and delegation contracts with automatic cache
+ * invalidation and performance optimization.
+ *
+ * @version 1.0.0
+ * @date 2026-02-15
+ * @module dcyfr-ai/intelligent-cache-manager
+ */
+import { EventEmitter } from 'events';
+import { PerformanceProfiler } from './performance-profiler.js';
+/**
+ * Cache entry metadata
+ */
+export interface CacheEntry<T = any> {
+    /**
+     * Cache key
+     */
+    key: string;
+    /**
+     * Cached value
+     */
+    value: T;
+    /**
+     * Entry creation timestamp
+     */
+    createdAt: Date;
+    /**
+     * Entry last access timestamp
+     */
+    lastAccessedAt: Date;
+    /**
+     * Entry expiration timestamp (optional)
+     */
+    expiresAt?: Date;
+    /**
+     * Access count for LRU optimization
+     */
+    accessCount: number;
+    /**
+     * Entry size in bytes (estimated)
+     */
+    estimatedSize: number;
+    /**
+     * Cache tags for selective invalidation
+     */
+    tags: Set<string>;
+    /**
+     * Entry priority (higher = more important to keep)
+     */
+    priority: number;
+    /**
+     * Function to compute cache key dependencies
+     */
+    dependencies?: string[];
+}
+/**
+ * Cache configuration
+ */
+export interface CacheConfig {
+    /**
+     * Maximum number of entries
+     */
+    maxEntries?: number;
+    /**
+     * Maximum cache size in bytes
+     */
+    maxSizeBytes?: number;
+    /**
+     * Default TTL in milliseconds
+     */
+    defaultTTL?: number;
+    /**
+     * Cache eviction strategy
+     */
+    evictionStrategy?: 'lru' | 'lfu' | 'ttl' | 'priority';
+    /**
+     * Enable performance tracking
+     */
+    enablePerformanceTracking?: boolean;
+    /**
+     * Enable automatic cleanup
+     */
+    enableAutoCleanup?: boolean;
+    /**
+     * Cleanup interval in milliseconds
+     */
+    cleanupInterval?: number;
+    /**
+     * Enable compression for large entries
+     */
+    enableCompression?: boolean;
+    /**
+     * Compression threshold in bytes
+     */
+    compressionThreshold?: number;
+}
+/**
+ * Cache statistics
+ */
+export interface CacheStats {
+    /**
+     * Total cache hits
+     */
+    hits: number;
+    /**
+     * Total cache misses
+     */
+    misses: number;
+    /**
+     * Cache hit rate (0-1)
+     */
+    hitRate: number;
+    /**
+     * Current number of entries
+     */
+    entryCount: number;
+    /**
+     * Current cache size in bytes
+     */
+    currentSize: number;
+    /**
+     * Number of evictions
+     */
+    evictions: number;
+    /**
+     * Number of expirations
+     */
+    expirations: number;
+    /**
+     * Average access time in milliseconds
+     */
+    averageAccessTime: number;
+    /**
+     * Memory utilization percentage
+     */
+    memoryUtilization: number;
+}
+/**
+ * Cache invalidation pattern
+ */
+export interface InvalidationPattern {
+    /**
+     * Pattern type
+     */
+    type: 'tag' | 'key_prefix' | 'key_regex' | 'dependency' | 'time_based';
+    /**
+     * Pattern value
+     */
+    pattern: string | RegExp | string[];
+    /**
+     * Invalidation reason
+     */
+    reason?: string;
+}
+/**
+ * Intelligent Cache Manager
+ *
+ * High-performance caching system with intelligent eviction strategies,
+ * automatic cleanup, and performance optimization for DCYFR integration workflows.
+ */
+export declare class IntelligentCacheManager extends EventEmitter {
+    private config;
+    private cache;
+    private stats;
+    private profiler?;
+    private cleanupInterval?;
+    private tagIndex;
+    private dependencyIndex;
+    constructor(config?: CacheConfig, profiler?: PerformanceProfiler);
+    /**
+     * Get value from cache
+     */
+    get<T>(key: string): T | null;
+    /**
+     * Set value in cache
+     */
+    set<T>(key: string, value: T, options?: {
+        ttl?: number;
+        tags?: string[];
+        priority?: number;
+        dependencies?: string[];
+    }): boolean;
+    /**
+     * Delete entry from cache
+     */
+    delete(key: string): boolean;
+    /**
+     * Check if key exists in cache
+     */
+    has(key: string): boolean;
+    /**
+     * Get or compute value (with caching)
+     */
+    getOrCompute<T>(key: string, computeFn: () => Promise<T> | T, options?: {
+        ttl?: number;
+        tags?: string[];
+        priority?: number;
+        dependencies?: string[];
+    }): Promise<T>;
+    /** Collect cache keys matching a given invalidation pattern */
+    private collectKeysForPattern;
+    /**
+     * Invalidate cache entries by pattern
+     */
+    invalidate(pattern: InvalidationPattern): number;
+    /**
+     * Clear entire cache
+     */
+    clear(): void;
+    /**
+     * Get cache statistics
+     */
+    getStats(): CacheStats;
+    /**
+     * Get cache configuration
+     */
+    getConfig(): CacheConfig;
+    /**
+     * Get all cache keys
+     */
+    keys(): string[];
+    /**
+     * Get cache entries for debugging
+     */
+    entries(): Array<{
+        key: string;
+        entry: CacheEntry;
+    }>;
+    /**
+     * Optimize cache performance
+     */
+    optimize(): {
+        beforeStats: CacheStats;
+        afterStats: CacheStats;
+        optimizations: string[];
+    };
+    /**
+     * Ensure cache capacity for new entry
+     */
+    private ensureCapacity;
+    /**
+     * Evict one entry based on strategy
+     */
+    private evictOne;
+    /**
+     * Find least recently used key
+     */
+    private findLRUKey;
+    /**
+     * Find least frequently used key
+     */
+    private findLFUKey;
+    /**
+     * Find earliest expiring key
+     */
+    private findEarliestExpiringKey;
+    /**
+     * Find lowest priority key
+     */
+    private findLowestPriorityKey;
+    /**
+     * Update cache indexes
+     */
+    private updateIndexes;
+    /** Remove a single key from an index map, deleting the bucket if empty */
+    private removeKeyFromIndexMap;
+    /**
+     * Remove key from all indexes
+     */
+    private removeFromIndexes;
+    /**
+     * Estimate size of value in bytes
+     */
+    private estimateSize;
+    /**
+     * Compress value (placeholder - would use actual compression)
+     */
+    private compressValue;
+    /**
+     * Remove expired entries
+     */
+    private removeExpired;
+    /**
+     * Optimize by access pattern
+     */
+    private optimizeByAccessPattern;
+    /**
+     * Compress large entries
+     */
+    private compressLargeEntries;
+    /**
+     * Evict by priority
+     */
+    private evictByPriority;
+    /**
+     * Update cache statistics
+     */
+    private updateStats;
+    /**
+     * Start automatic cleanup
+     */
+    private startAutoCleanup;
+    /**
+     * Shutdown cache manager
+     */
+    shutdown(): void;
+}
+/**
+ * Get or create global cache manager instance
+ */
+export declare function getGlobalCacheManager(config?: CacheConfig, profiler?: PerformanceProfiler): IntelligentCacheManager;
+/**
+ * Cache decorator for class methods
+ */
+export declare function cache(options?: {
+    ttl?: number;
+    keyGenerator?: (...args: any[]) => string;
+    tags?: string[];
+    priority?: number;
+}): (target: any, propertyName: string, descriptor: PropertyDescriptor) => PropertyDescriptor;
+export default IntelligentCacheManager;
+//# sourceMappingURL=intelligent-cache-manager.d.ts.map

package/dist/ai/src/intelligent-cache-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"intelligent-cache-manager.d.ts","sourceRoot":"","sources":["../../../packages/ai/src/intelligent-cache-manager.ts"],"names":[],"mappings":"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"}