agentic-qe 1.1.0 → 1.2.0

package/dist/core/embeddings/EmbeddingCache.d.ts

@@ -0,0 +1,134 @@
+/**
+ * Embedding Cache - LRU cache for embedding vectors
+ *
+ * Features:
+ * - LRU eviction policy
+ * - Separate namespaces for text and code
+ * - Memory-efficient storage
+ * - Cache statistics
+ *
+ * Performance:
+ * - Get: O(1)
+ * - Set: O(1)
+ * - Memory: ~4KB per 1000 cached embeddings (256D)
+ *
+ * @module EmbeddingCache
+ */
+/**
+ * Cache statistics
+ */
+export interface CacheStats {
+    /** Text embeddings cached */
+    textCount: number;
+    /** Code embeddings cached */
+    codeCount: number;
+    /** Total entries */
+    totalCount: number;
+    /** Cache hits */
+    hits: number;
+    /** Cache misses */
+    misses: number;
+    /** Hit rate percentage */
+    hitRate: number;
+    /** Memory usage in bytes */
+    memoryUsage: number;
+    /** Maximum capacity */
+    maxSize: number;
+}
+/**
+ * Embedding Cache
+ *
+ * LRU cache for storing embedding vectors with separate namespaces
+ * for text and code embeddings.
+ */
+export declare class EmbeddingCache {
+    private maxSize;
+    private textCache;
+    private codeCache;
+    private hits;
+    private misses;
+    /**
+     * Create a new embedding cache
+     *
+     * @param maxSize - Maximum number of entries per namespace (default: 10000)
+     */
+    constructor(maxSize?: number);
+    /**
+     * Get cached embedding
+     *
+     * @param key - Cache key
+     * @param type - Namespace ('text' | 'code')
+     * @returns Cached embedding or null
+     */
+    get(key: string, type?: 'text' | 'code'): number[] | null;
+    /**
+     * Set cached embedding
+     *
+     * @param key - Cache key
+     * @param embedding - Vector embedding
+     * @param type - Namespace ('text' | 'code')
+     */
+    set(key: string, embedding: number[], type?: 'text' | 'code'): void;
+    /**
+     * Check if key exists
+     *
+     * @param key - Cache key
+     * @param type - Namespace
+     * @returns True if key exists
+     */
+    has(key: string, type?: 'text' | 'code'): boolean;
+    /**
+     * Delete cached entry
+     *
+     * @param key - Cache key
+     * @param type - Namespace
+     * @returns True if deleted
+     */
+    delete(key: string, type?: 'text' | 'code'): boolean;
+    /**
+     * Clear cache
+     *
+     * @param type - Type to clear ('text' | 'code' | 'all')
+     */
+    clear(type?: 'text' | 'code' | 'all'): void;
+    /**
+     * Evict least recently used entry
+     *
+     * @param cache - Cache to evict from
+     */
+    private evictLRU;
+    /**
+     * Get cache statistics
+     *
+     * @returns Cache stats
+     */
+    getStats(): CacheStats;
+    /**
+     * Get most frequently accessed entries
+     *
+     * @param type - Namespace
+     * @param limit - Number of entries to return
+     * @returns Array of [key, accessCount] tuples
+     */
+    getMostAccessed(type?: 'text' | 'code', limit?: number): Array<[string, number]>;
+    /**
+     * Get cache size in bytes
+     *
+     * @param type - Namespace ('text' | 'code' | 'all')
+     * @returns Memory usage in bytes
+     */
+    getSize(type?: 'text' | 'code' | 'all'): number;
+    /**
+     * Optimize cache by removing least used entries
+     *
+     * @param threshold - Minimum access count to keep
+     * @param type - Namespace ('text' | 'code' | 'all')
+     * @returns Number of entries removed
+     */
+    optimize(threshold?: number, type?: 'text' | 'code' | 'all'): number;
+    /**
+     * Reset statistics
+     */
+    resetStats(): void;
+}
+//# sourceMappingURL=EmbeddingCache.d.ts.map

package/dist/core/embeddings/EmbeddingCache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EmbeddingCache.d.ts","sourceRoot":"","sources":["../../../src/core/embeddings/EmbeddingCache.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAmBH;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,6BAA6B;IAC7B,SAAS,EAAE,MAAM,CAAC;IAElB,6BAA6B;IAC7B,SAAS,EAAE,MAAM,CAAC;IAElB,oBAAoB;IACpB,UAAU,EAAE,MAAM,CAAC;IAEnB,iBAAiB;IACjB,IAAI,EAAE,MAAM,CAAC;IAEb,mBAAmB;IACnB,MAAM,EAAE,MAAM,CAAC;IAEf,0BAA0B;IAC1B,OAAO,EAAE,MAAM,CAAC;IAEhB,4BAA4B;IAC5B,WAAW,EAAE,MAAM,CAAC;IAEpB,uBAAuB;IACvB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;GAKG;AACH,qBAAa,cAAc;IAWb,OAAO,CAAC,OAAO;IAV3B,OAAO,CAAC,SAAS,CAA0B;IAC3C,OAAO,CAAC,SAAS,CAA0B;IAC3C,OAAO,CAAC,IAAI,CAAa;IACzB,OAAO,CAAC,MAAM,CAAa;IAE3B;;;;OAIG;gBACiB,OAAO,GAAE,MAAc;IAK3C;;;;;;OAMG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,GAAE,MAAM,GAAG,MAAe,GAAG,MAAM,EAAE,GAAG,IAAI;IAqBjE;;;;;;OAMG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,IAAI,GAAE,MAAM,GAAG,MAAe,GAAG,IAAI;IAoB3E;;;;;;OAMG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,GAAE,MAAM,GAAG,MAAe,GAAG,OAAO;IAKzD;;;;;;OAMG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,GAAE,MAAM,GAAG,MAAe,GAAG,OAAO;IAK5D;;;;OAIG;IACH,KAAK,CAAC,IAAI,GAAE,MAAM,GAAG,MAAM,GAAG,KAAa,GAAG,IAAI;IAalD;;;;OAIG;IACH,OAAO,CAAC,QAAQ;IAQhB;;;;OAIG;IACH,QAAQ,IAAI,UAAU;IA4BtB;;;;;;OAMG;IACH,eAAe,CAAC,IAAI,GAAE,MAAM,GAAG,MAAe,EAAE,KAAK,GAAE,MAAW,GAAG,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAU5F;;;;;OAKG;IACH,OAAO,CAAC,IAAI,GAAE,MAAM,GAAG,MAAM,GAAG,KAAa,GAAG,MAAM;IAkBtD;;;;;;OAMG;IACH,QAAQ,CAAC,SAAS,GAAE,MAAU,EAAE,IAAI,GAAE,MAAM,GAAG,MAAM,GAAG,KAAa,GAAG,MAAM;IA0B9E;;OAEG;IACH,UAAU,IAAI,IAAI;CAInB"}

package/dist/core/embeddings/EmbeddingCache.js

@@ -0,0 +1,239 @@
+"use strict";
+/**
+ * Embedding Cache - LRU cache for embedding vectors
+ *
+ * Features:
+ * - LRU eviction policy
+ * - Separate namespaces for text and code
+ * - Memory-efficient storage
+ * - Cache statistics
+ *
+ * Performance:
+ * - Get: O(1)
+ * - Set: O(1)
+ * - Memory: ~4KB per 1000 cached embeddings (256D)
+ *
+ * @module EmbeddingCache
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EmbeddingCache = void 0;
+/**
+ * Embedding Cache
+ *
+ * LRU cache for storing embedding vectors with separate namespaces
+ * for text and code embeddings.
+ */
+class EmbeddingCache {
+    /**
+     * Create a new embedding cache
+     *
+     * @param maxSize - Maximum number of entries per namespace (default: 10000)
+     */
+    constructor(maxSize = 10000) {
+        this.maxSize = maxSize;
+        this.hits = 0;
+        this.misses = 0;
+        this.textCache = new Map();
+        this.codeCache = new Map();
+    }
+    /**
+     * Get cached embedding
+     *
+     * @param key - Cache key
+     * @param type - Namespace ('text' | 'code')
+     * @returns Cached embedding or null
+     */
+    get(key, type = 'text') {
+        const cache = type === 'text' ? this.textCache : this.codeCache;
+        const entry = cache.get(key);
+        if (entry) {
+            // Update access stats
+            entry.lastAccess = Date.now();
+            entry.accessCount++;
+            // Move to end (most recently used)
+            cache.delete(key);
+            cache.set(key, entry);
+            this.hits++;
+            return entry.embedding;
+        }
+        this.misses++;
+        return null;
+    }
+    /**
+     * Set cached embedding
+     *
+     * @param key - Cache key
+     * @param embedding - Vector embedding
+     * @param type - Namespace ('text' | 'code')
+     */
+    set(key, embedding, type = 'text') {
+        const cache = type === 'text' ? this.textCache : this.codeCache;
+        // Check if we need to evict
+        if (cache.size >= this.maxSize && !cache.has(key)) {
+            this.evictLRU(cache);
+        }
+        // Calculate entry size (rough estimate)
+        const size = embedding.length * 8 + key.length * 2 + 24; // 8 bytes per number, 2 per char, 24 overhead
+        // Store entry
+        cache.set(key, {
+            embedding: [...embedding], // Clone array
+            lastAccess: Date.now(),
+            accessCount: 0,
+            size
+        });
+    }
+    /**
+     * Check if key exists
+     *
+     * @param key - Cache key
+     * @param type - Namespace
+     * @returns True if key exists
+     */
+    has(key, type = 'text') {
+        const cache = type === 'text' ? this.textCache : this.codeCache;
+        return cache.has(key);
+    }
+    /**
+     * Delete cached entry
+     *
+     * @param key - Cache key
+     * @param type - Namespace
+     * @returns True if deleted
+     */
+    delete(key, type = 'text') {
+        const cache = type === 'text' ? this.textCache : this.codeCache;
+        return cache.delete(key);
+    }
+    /**
+     * Clear cache
+     *
+     * @param type - Type to clear ('text' | 'code' | 'all')
+     */
+    clear(type = 'all') {
+        if (type === 'text' || type === 'all') {
+            this.textCache.clear();
+        }
+        if (type === 'code' || type === 'all') {
+            this.codeCache.clear();
+        }
+        if (type === 'all') {
+            this.hits = 0;
+            this.misses = 0;
+        }
+    }
+    /**
+     * Evict least recently used entry
+     *
+     * @param cache - Cache to evict from
+     */
+    evictLRU(cache) {
+        // First entry is the least recently used (Map maintains insertion order)
+        const firstKey = cache.keys().next().value;
+        if (firstKey) {
+            cache.delete(firstKey);
+        }
+    }
+    /**
+     * Get cache statistics
+     *
+     * @returns Cache stats
+     */
+    getStats() {
+        const textCount = this.textCache.size;
+        const codeCount = this.codeCache.size;
+        const totalCount = textCount + codeCount;
+        const totalRequests = this.hits + this.misses;
+        const hitRate = totalRequests > 0 ? (this.hits / totalRequests) * 100 : 0;
+        // Calculate memory usage
+        let memoryUsage = 0;
+        for (const entry of this.textCache.values()) {
+            memoryUsage += entry.size;
+        }
+        for (const entry of this.codeCache.values()) {
+            memoryUsage += entry.size;
+        }
+        return {
+            textCount,
+            codeCount,
+            totalCount,
+            hits: this.hits,
+            misses: this.misses,
+            hitRate,
+            memoryUsage,
+            maxSize: this.maxSize * 2 // Total max size (both namespaces)
+        };
+    }
+    /**
+     * Get most frequently accessed entries
+     *
+     * @param type - Namespace
+     * @param limit - Number of entries to return
+     * @returns Array of [key, accessCount] tuples
+     */
+    getMostAccessed(type = 'text', limit = 10) {
+        const cache = type === 'text' ? this.textCache : this.codeCache;
+        const entries = Array.from(cache.entries());
+        return entries
+            .sort((a, b) => b[1].accessCount - a[1].accessCount)
+            .slice(0, limit)
+            .map(([key, entry]) => [key, entry.accessCount]);
+    }
+    /**
+     * Get cache size in bytes
+     *
+     * @param type - Namespace ('text' | 'code' | 'all')
+     * @returns Memory usage in bytes
+     */
+    getSize(type = 'all') {
+        let size = 0;
+        if (type === 'text' || type === 'all') {
+            for (const entry of this.textCache.values()) {
+                size += entry.size;
+            }
+        }
+        if (type === 'code' || type === 'all') {
+            for (const entry of this.codeCache.values()) {
+                size += entry.size;
+            }
+        }
+        return size;
+    }
+    /**
+     * Optimize cache by removing least used entries
+     *
+     * @param threshold - Minimum access count to keep
+     * @param type - Namespace ('text' | 'code' | 'all')
+     * @returns Number of entries removed
+     */
+    optimize(threshold = 1, type = 'all') {
+        let removed = 0;
+        const optimizeCache = (cache) => {
+            const toRemove = [];
+            for (const [key, entry] of cache.entries()) {
+                if (entry.accessCount < threshold) {
+                    toRemove.push(key);
+                }
+            }
+            for (const key of toRemove) {
+                cache.delete(key);
+                removed++;
+            }
+        };
+        if (type === 'text' || type === 'all') {
+            optimizeCache(this.textCache);
+        }
+        if (type === 'code' || type === 'all') {
+            optimizeCache(this.codeCache);
+        }
+        return removed;
+    }
+    /**
+     * Reset statistics
+     */
+    resetStats() {
+        this.hits = 0;
+        this.misses = 0;
+    }
+}
+exports.EmbeddingCache = EmbeddingCache;
+//# sourceMappingURL=EmbeddingCache.js.map

package/dist/core/embeddings/EmbeddingCache.js.map

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

package/dist/core/embeddings/EmbeddingGenerator.d.ts

@@ -0,0 +1,224 @@
+/**
+ * Embedding Generator - Convert patterns into vector embeddings
+ *
+ * Features:
+ * - Phase 1 (Simple): Hash-based embeddings for quick start
+ * - Phase 2 (ML): Transformers.js for production embeddings
+ * - Caching for performance optimization
+ * - Batch processing support
+ * - Graceful fallback if ML models unavailable
+ *
+ * Models:
+ * - Text: "Xenova/all-MiniLM-L6-v2" (384 dimensions)
+ * - Code: "microsoft/codebert-base" (768 dimensions)
+ *
+ * Performance:
+ * - Hash-based: ~50µs per embedding
+ * - ML-based: ~5-10ms per embedding (cached)
+ * - Batch: ~2ms per embedding (10+ texts)
+ *
+ * @module EmbeddingGenerator
+ */
+/**
+ * Embedding generation options
+ */
+export interface EmbeddingOptions {
+    /** Use ML-based embeddings (default: true) */
+    useML?: boolean;
+    /** Cache embeddings for performance (default: true) */
+    useCache?: boolean;
+    /** Normalize embeddings to unit length (default: true) */
+    normalize?: boolean;
+    /** Language for code embeddings (e.g., 'typescript', 'python') */
+    language?: string;
+    /** Model to use ('text' | 'code') */
+    model?: 'text' | 'code';
+    /** Target dimension (for hash-based only) */
+    dimension?: number;
+}
+/**
+ * Embedding result
+ */
+export interface EmbeddingResult {
+    /** Vector embedding */
+    embedding: number[];
+    /** Embedding dimension */
+    dimension: number;
+    /** Method used ('hash' | 'ml') */
+    method: 'hash' | 'ml';
+    /** Generation time in milliseconds */
+    generationTime: number;
+    /** Whether result was cached */
+    cached: boolean;
+    /** Model name used */
+    model: string;
+}
+/**
+ * Batch embedding result
+ */
+export interface BatchEmbeddingResult {
+    /** Array of embeddings */
+    embeddings: number[][];
+    /** Total generation time */
+    totalTime: number;
+    /** Average time per embedding */
+    avgTime: number;
+    /** Number of cache hits */
+    cacheHits: number;
+    /** Method used */
+    method: 'hash' | 'ml';
+}
+/**
+ * Embedding Generator
+ *
+ * Provides both simple hash-based and ML-based embedding generation
+ * with intelligent fallback and caching.
+ */
+export declare class EmbeddingGenerator {
+    private cacheSize;
+    private autoInitML;
+    private cache;
+    private mlAvailable;
+    private pipeline;
+    private codePipeline;
+    private initPromise;
+    private readonly TEXT_MODEL;
+    private readonly CODE_MODEL;
+    private readonly TEXT_DIMENSION;
+    private readonly CODE_DIMENSION;
+    private readonly DEFAULT_HASH_DIMENSION;
+    /**
+     * Create a new embedding generator
+     *
+     * @param cacheSize - Maximum number of cached embeddings (default: 10000)
+     * @param autoInitML - Automatically initialize ML models (default: false)
+     */
+    constructor(cacheSize?: number, autoInitML?: boolean);
+    /**
+     * Initialize ML models
+     *
+     * Lazy-loads Transformers.js models for production embeddings.
+     * Falls back to hash-based if models unavailable.
+     */
+    initializeML(): Promise<void>;
+    /**
+     * Initialize code embedding model
+     *
+     * Separate initialization for code model to avoid loading if not needed.
+     */
+    initializeCodeModel(): Promise<void>;
+    /**
+     * Generate text embedding
+     *
+     * @param text - Text to embed
+     * @param options - Embedding options
+     * @returns Embedding result with vector and metadata
+     */
+    generateTextEmbedding(text: string, options?: EmbeddingOptions): Promise<EmbeddingResult>;
+    /**
+     * Generate code embedding
+     *
+     * @param code - Code to embed
+     * @param language - Programming language
+     * @param options - Embedding options
+     * @returns Embedding result
+     */
+    generateCodeEmbedding(code: string, language: string, options?: EmbeddingOptions): Promise<EmbeddingResult>;
+    /**
+     * Generate batch text embeddings
+     *
+     * More efficient than generating one at a time.
+     *
+     * @param texts - Array of texts to embed
+     * @param options - Embedding options
+     * @returns Batch embedding result
+     */
+    generateBatchTextEmbeddings(texts: string[], options?: EmbeddingOptions): Promise<BatchEmbeddingResult>;
+    /**
+     * Generate hash-based embedding
+     *
+     * Fast, deterministic embedding using cryptographic hashing.
+     * Suitable for testing and development.
+     *
+     * @param text - Text to embed
+     * @param dimension - Target dimension (default: 256)
+     * @param salt - Optional salt for different embeddings (default: '')
+     * @returns Vector embedding
+     */
+    generateHashEmbedding(text: string, dimension?: number, salt?: string): number[];
+    /**
+     * Generate ML-based text embedding
+     *
+     * Uses Transformers.js for production-quality embeddings.
+     *
+     * @param text - Text to embed
+     * @returns Vector embedding
+     */
+    private generateMLTextEmbedding;
+    /**
+     * Generate ML-based code embedding
+     *
+     * Uses CodeBERT for code-specific embeddings.
+     *
+     * @param code - Code to embed
+     * @param language - Programming language
+     * @returns Vector embedding
+     */
+    private generateMLCodeEmbedding;
+    /**
+     * Normalize embedding to unit length
+     *
+     * @param embedding - Vector to normalize
+     * @returns Normalized vector
+     */
+    private normalizeEmbedding;
+    /**
+     * Get cached embedding
+     *
+     * @param key - Cache key
+     * @param type - Embedding type ('text' | 'code')
+     * @returns Cached embedding or null
+     */
+    getCachedEmbedding(key: string, type?: 'text' | 'code'): number[] | null;
+    /**
+     * Cache embedding manually
+     *
+     * @param key - Cache key
+     * @param embedding - Vector embedding
+     * @param type - Embedding type
+     */
+    cacheEmbedding(key: string, embedding: number[], type?: 'text' | 'code'): void;
+    /**
+     * Clear cache
+     *
+     * @param type - Type to clear ('text' | 'code' | 'all')
+     */
+    clearCache(type?: 'text' | 'code' | 'all'): void;
+    /**
+     * Get cache statistics
+     *
+     * @returns Cache stats
+     */
+    getCacheStats(): import("./EmbeddingCache").CacheStats;
+    /**
+     * Check if ML models are available
+     *
+     * @returns True if ML models initialized
+     */
+    isMLAvailable(): boolean;
+    /**
+     * Get model information
+     *
+     * @returns Model info
+     */
+    getModelInfo(): {
+        textModel: string;
+        codeModel: string;
+        textDimension: number;
+        codeDimension: number;
+        hashDimension: number;
+        mlAvailable: boolean;
+        cacheSize: number;
+    };
+}
+//# sourceMappingURL=EmbeddingGenerator.d.ts.map

package/dist/core/embeddings/EmbeddingGenerator.d.ts.map

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