agentic-qe 2.5.7 → 2.5.9

package/dist/providers/RuVectorClient.js

@@ -0,0 +1,416 @@
+"use strict";
+/**
+ * RuVectorClient - TypeScript client for RuVector Docker integration
+ *
+ * Provides GNN-enhanced vector search with LoRA learning capabilities.
+ * Part of AQE LLM Independence initiative (Phase 0.5).
+ *
+ * @module providers/RuVectorClient
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RUVECTOR_CLIENT_VERSION = exports.RuVectorClient = exports.RuVectorError = void 0;
+exports.createRuVectorClient = createRuVectorClient;
+/**
+ * Custom error class for RuVector operations
+ */
+class RuVectorError extends Error {
+    constructor(message, code, statusCode, details) {
+        super(message);
+        this.code = code;
+        this.statusCode = statusCode;
+        this.details = details;
+        this.name = 'RuVectorError';
+        Object.setPrototypeOf(this, RuVectorError.prototype);
+    }
+}
+exports.RuVectorError = RuVectorError;
+/**
+ * RuVector TypeScript Client
+ *
+ * Provides integration with RuVector Docker service for GNN-enhanced
+ * vector search with LoRA learning capabilities.
+ *
+ * @example
+ * ```typescript
+ * const client = new RuVectorClient({
+ *   baseUrl: 'http://localhost:8080',
+ *   learningEnabled: true,
+ *   cacheThreshold: 0.8,
+ *   loraRank: 8,
+ *   ewcEnabled: true
+ * });
+ *
+ * // Query with automatic learning
+ * const result = await client.queryWithLearning(
+ *   'How do I test async functions?',
+ *   embedding,
+ *   async () => await llm.complete('How do I test async functions?')
+ * );
+ * ```
+ */
+class RuVectorClient {
+    /**
+     * Creates a new RuVector client instance
+     *
+     * @param config - Configuration options
+     */
+    constructor(config) {
+        this.queryCount = 0;
+        this.cacheHits = 0;
+        this.totalLatency = 0;
+        this.baseUrl = config.baseUrl.replace(/\/$/, ''); // Remove trailing slash
+        this.config = {
+            ...config,
+            timeout: config.timeout ?? 30000,
+            maxRetries: config.maxRetries ?? 3,
+            retryDelay: config.retryDelay ?? 1000,
+            debug: config.debug ?? false
+        };
+        this.log('RuVectorClient initialized', { baseUrl: this.baseUrl });
+    }
+    /**
+     * Search for similar patterns with GNN-enhanced ranking
+     *
+     * @param embedding - Query embedding vector
+     * @param k - Number of results to return (default: 10)
+     * @param options - Additional search options
+     * @returns Array of search results ranked by GNN confidence
+     *
+     * @example
+     * ```typescript
+     * const results = await client.search(embedding, 5);
+     * console.log(`Top result: ${results[0].content} (${results[0].confidence})`);
+     * ```
+     */
+    async search(embedding, k = 10, options) {
+        this.validateEmbedding(embedding);
+        const startTime = Date.now();
+        try {
+            const response = await this.fetchWithRetry(`${this.baseUrl}/v1/search`, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({
+                    embedding,
+                    k,
+                    useGNN: options?.useGNN ?? true,
+                    attentionType: options?.attentionType ?? 'multi-head',
+                    minConfidence: options?.minConfidence ?? 0.0
+                })
+            });
+            const results = await this.parseJsonResponse(response);
+            const latency = Date.now() - startTime;
+            this.log('Search completed', {
+                k,
+                resultsCount: results.length,
+                latency,
+                topConfidence: results[0]?.confidence
+            });
+            return results;
+        }
+        catch (error) {
+            throw this.handleError('search', error, { k, embeddingSize: embedding.length });
+        }
+    }
+    /**
+     * Store pattern with automatic LoRA learning
+     *
+     * @param pattern - Pattern to store
+     * @param options - Storage options
+     *
+     * @example
+     * ```typescript
+     * await client.store({
+     *   embedding: [0.1, 0.2, ...],
+     *   content: 'Use jest.fn() for mocking',
+     *   metadata: { category: 'testing', framework: 'jest' }
+     * });
+     * ```
+     */
+    async store(pattern, options) {
+        this.validateEmbedding(pattern.embedding);
+        try {
+            const response = await this.fetchWithRetry(`${this.baseUrl}/v1/store`, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({
+                    embedding: pattern.embedding,
+                    content: pattern.content,
+                    metadata: pattern.metadata,
+                    learningConfig: this.config.learningEnabled ? {
+                        loraRank: this.config.loraRank,
+                        ewcLambda: this.config.ewcEnabled ? 0.5 : 0,
+                        triggerConsolidation: options?.triggerLearning ?? false
+                    } : undefined,
+                    priority: options?.priority ?? 'normal'
+                })
+            });
+            if (!response.ok) {
+                throw new RuVectorError(`Failed to store pattern: ${response.statusText}`, 'STORE_FAILED', response.status);
+            }
+            this.log('Pattern stored successfully', {
+                contentLength: pattern.content.length,
+                metadataKeys: Object.keys(pattern.metadata).length
+            });
+        }
+        catch (error) {
+            throw this.handleError('store', error, { embeddingSize: pattern.embedding.length });
+        }
+    }
+    /**
+     * Query with automatic learning and LLM fallback
+     *
+     * Implements intelligent routing:
+     * 1. Search vector DB for similar patterns
+     * 2. If confidence > threshold, return cached result
+     * 3. Otherwise, call LLM fallback
+     * 4. Store LLM result for future learning
+     *
+     * @param query - Query string for logging
+     * @param embedding - Query embedding vector
+     * @param llmFallback - Function to call LLM if cache misses
+     * @returns Query result with source information
+     *
+     * @example
+     * ```typescript
+     * const result = await client.queryWithLearning(
+     *   'How to mock API calls?',
+     *   embedding,
+     *   async () => await anthropic.complete('How to mock API calls?')
+     * );
+     *
+     * if (result.source === 'cache') {
+     *   console.log('Served from cache, saving costs!');
+     * }
+     * ```
+     */
+    async queryWithLearning(query, embedding, llmFallback) {
+        const startTime = Date.now();
+        this.queryCount++;
+        try {
+            // Phase 1: Search for similar patterns
+            const results = await this.search(embedding, 5);
+            const topResult = results[0];
+            // Phase 2: Check confidence threshold
+            if (topResult && topResult.confidence > this.config.cacheThreshold) {
+                this.cacheHits++;
+                const latency = Date.now() - startTime;
+                this.totalLatency += latency;
+                this.log('Cache hit', {
+                    query,
+                    confidence: topResult.confidence,
+                    threshold: this.config.cacheThreshold,
+                    latency
+                });
+                return {
+                    content: topResult.content,
+                    source: 'cache',
+                    confidence: topResult.confidence,
+                    latency,
+                    metadata: topResult.metadata
+                };
+            }
+            // Phase 3: Cache miss - call LLM
+            this.log('Cache miss, calling LLM fallback', {
+                query,
+                topConfidence: topResult?.confidence ?? 0,
+                threshold: this.config.cacheThreshold
+            });
+            const llmResponse = await llmFallback();
+            const latency = Date.now() - startTime;
+            this.totalLatency += latency;
+            // Phase 4: Store for future learning
+            if (this.config.learningEnabled) {
+                await this.store({
+                    embedding,
+                    content: llmResponse,
+                    metadata: {
+                        query,
+                        timestamp: new Date().toISOString(),
+                        source: 'llm',
+                        originalConfidence: topResult?.confidence ?? 0
+                    }
+                }, { triggerLearning: true });
+            }
+            return {
+                content: llmResponse,
+                source: 'llm',
+                confidence: 1.0, // LLM responses are assumed to be high quality
+                latency,
+                metadata: {
+                    query,
+                    cachedResultConfidence: topResult?.confidence
+                }
+            };
+        }
+        catch (error) {
+            throw this.handleError('queryWithLearning', error, { query });
+        }
+    }
+    /**
+     * Get learning metrics
+     *
+     * @returns Current learning metrics
+     */
+    async getMetrics() {
+        try {
+            const response = await this.fetchWithRetry(`${this.baseUrl}/v1/metrics`);
+            const serverMetrics = await this.parseJsonResponse(response);
+            return {
+                cacheHitRate: this.queryCount > 0 ? this.cacheHits / this.queryCount : 0,
+                totalQueries: this.queryCount,
+                loraUpdates: serverMetrics.loraUpdates,
+                averageLatency: this.queryCount > 0 ? this.totalLatency / this.queryCount : 0,
+                patternCount: serverMetrics.patternCount,
+                memoryUsageMB: serverMetrics.memoryUsageMB,
+                gnnMetrics: serverMetrics.gnnMetrics
+            };
+        }
+        catch (error) {
+            throw this.handleError('getMetrics', error);
+        }
+    }
+    /**
+     * Force learning consolidation
+     *
+     * Triggers manual LoRA parameter consolidation.
+     * Use sparingly - automatic consolidation is preferred.
+     *
+     * @returns Consolidation result with updated metrics
+     */
+    async forceLearn() {
+        this.log('Forcing learning consolidation');
+        try {
+            const response = await this.fetchWithRetry(`${this.baseUrl}/v1/learn`, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({
+                    loraRank: this.config.loraRank,
+                    ewcLambda: this.config.ewcEnabled ? 0.5 : 0
+                })
+            });
+            const result = await this.parseJsonResponse(response);
+            this.log('Learning consolidation completed', result);
+            return result;
+        }
+        catch (error) {
+            throw this.handleError('forceLearn', error);
+        }
+    }
+    /**
+     * Health check
+     *
+     * @returns Health status of RuVector service
+     */
+    async healthCheck() {
+        try {
+            const response = await this.fetchWithRetry(`${this.baseUrl}/health`, {
+                method: 'GET'
+            });
+            const health = await this.parseJsonResponse(response);
+            this.log('Health check completed', {
+                status: health.status,
+                uptime: health.uptime,
+                vectorCount: health.vectorCount
+            });
+            return health;
+        }
+        catch (error) {
+            throw this.handleError('healthCheck', error);
+        }
+    }
+    /**
+     * Reset metrics
+     *
+     * Resets client-side query metrics. Does not affect server metrics.
+     */
+    resetMetrics() {
+        this.queryCount = 0;
+        this.cacheHits = 0;
+        this.totalLatency = 0;
+        this.log('Metrics reset');
+    }
+    // Private helper methods
+    validateEmbedding(embedding) {
+        if (!Array.isArray(embedding) || embedding.length === 0) {
+            throw new RuVectorError('Embedding must be a non-empty array', 'INVALID_EMBEDDING');
+        }
+        if (!embedding.every(v => typeof v === 'number' && !isNaN(v))) {
+            throw new RuVectorError('Embedding must contain only valid numbers', 'INVALID_EMBEDDING');
+        }
+    }
+    async fetchWithRetry(url, options, attempt = 1) {
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), this.config.timeout);
+        try {
+            const response = await fetch(url, {
+                ...options,
+                signal: controller.signal
+            });
+            clearTimeout(timeoutId);
+            if (!response.ok && attempt < this.config.maxRetries) {
+                const delay = this.config.retryDelay * attempt;
+                this.log(`Request failed (attempt ${attempt}), retrying in ${delay}ms`, {
+                    status: response.status,
+                    url
+                });
+                await this.sleep(delay);
+                return this.fetchWithRetry(url, options, attempt + 1);
+            }
+            return response;
+        }
+        catch (error) {
+            clearTimeout(timeoutId);
+            if (attempt < this.config.maxRetries) {
+                const delay = this.config.retryDelay * attempt;
+                this.log(`Request error (attempt ${attempt}), retrying in ${delay}ms`, {
+                    error: error instanceof Error ? error.message : String(error),
+                    url
+                });
+                await this.sleep(delay);
+                return this.fetchWithRetry(url, options, attempt + 1);
+            }
+            throw error;
+        }
+    }
+    async parseJsonResponse(response) {
+        if (!response.ok) {
+            const errorText = await response.text().catch(() => 'Unknown error');
+            throw new RuVectorError(`Request failed: ${response.statusText}`, 'REQUEST_FAILED', response.status, errorText);
+        }
+        try {
+            return await response.json();
+        }
+        catch (error) {
+            throw new RuVectorError('Failed to parse JSON response', 'PARSE_ERROR', response.status, error);
+        }
+    }
+    handleError(operation, error, context) {
+        if (error instanceof RuVectorError) {
+            return error;
+        }
+        const message = error instanceof Error ? error.message : String(error);
+        const ruVectorError = new RuVectorError(`${operation} failed: ${message}`, 'OPERATION_FAILED', undefined, { originalError: error, context });
+        this.log(`Error in ${operation}`, {
+            error: message,
+            context
+        });
+        return ruVectorError;
+    }
+    sleep(ms) {
+        return new Promise(resolve => setTimeout(resolve, ms));
+    }
+    log(message, data) {
+        if (this.config.debug) {
+            const timestamp = new Date().toISOString();
+            console.log(`[RuVectorClient] ${timestamp} - ${message}`, data || '');
+        }
+    }
+}
+exports.RuVectorClient = RuVectorClient;
+// Export default instance factory for convenience
+function createRuVectorClient(config) {
+    return new RuVectorClient(config);
+}
+// Export version for compatibility checks
+exports.RUVECTOR_CLIENT_VERSION = '1.0.0';
+//# sourceMappingURL=RuVectorClient.js.map

package/dist/providers/RuVectorClient.js.map

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

package/dist/providers/RuvllmPatternCurator.d.ts

@@ -0,0 +1,116 @@
+/**
+ * RuvllmPatternCurator - Integration layer between PatternCurator and RuvllmProvider
+ *
+ * Phase 0 M0.6: Wires manual pattern curation to RuvLLM's learning system
+ *
+ * This adapter:
+ * - Implements IPatternSource using HNSWPatternAdapter
+ * - Implements ILearningTrigger using RuvllmProvider
+ * - Enables manual curation to improve RuvLLM routing decisions
+ * - Provides 20% better routing through curated patterns
+ */
+import { EventEmitter } from 'events';
+import { StoredPattern, CuratedPattern, CuratorConfig, CurationSession, PatternAnalytics } from '../learning/PatternCurator';
+import { RuvllmProvider } from './RuvllmProvider';
+import { HNSWPatternAdapter } from '../learning/HNSWPatternAdapter';
+/**
+ * Configuration for RuvllmPatternCurator
+ */
+export interface RuvllmPatternCuratorConfig {
+    /** Pattern curation configuration */
+    curatorConfig?: Partial<CuratorConfig>;
+    /** RuvLLM provider instance */
+    ruvllmProvider: RuvllmProvider;
+    /** Optional HNSW adapter for pattern storage */
+    hnswAdapter?: HNSWPatternAdapter;
+    /** Enable embedding-based similarity search */
+    useEmbeddings?: boolean;
+}
+/**
+ * RuvllmPatternCurator - Unified pattern curation with RuvLLM integration
+ */
+export declare class RuvllmPatternCurator extends EventEmitter {
+    private readonly logger;
+    private readonly curator;
+    private readonly ruvllm;
+    private readonly patternSource;
+    private readonly learningTrigger;
+    constructor(config: RuvllmPatternCuratorConfig);
+    /**
+     * Start a curation session
+     */
+    startSession(reviewerId?: string): CurationSession;
+    /**
+     * End current curation session
+     */
+    endSession(): CurationSession | null;
+    /**
+     * Find low-confidence patterns for review
+     */
+    findLowConfidencePatterns(limit?: number): Promise<StoredPattern[]>;
+    /**
+     * Review a pattern manually
+     */
+    reviewPattern(pattern: StoredPattern, curation: CuratedPattern): Promise<void>;
+    /**
+     * Auto-curate patterns based on confidence thresholds
+     */
+    autoCurate(): Promise<{
+        autoApproved: number;
+        autoRejected: number;
+        needsReview: number;
+    }>;
+    /**
+     * Force learning consolidation
+     */
+    forceLearning(): Promise<{
+        feedbackSubmitted: number;
+        patternsConsolidated: number;
+        newWeightVersion: number;
+    }>;
+    /**
+     * Get pattern analytics
+     */
+    getAnalytics(): Promise<PatternAnalytics>;
+    /**
+     * Get routing improvement stats
+     */
+    getRoutingImprovement(): Promise<{
+        beforeCuration: {
+            avgConfidence: number;
+        };
+        afterCuration: {
+            avgConfidence: number;
+        };
+        improvement: number;
+    }>;
+    /**
+     * Get curation history
+     */
+    getCurationHistory(): CurationSession[];
+    /**
+     * Get current session
+     */
+    getCurrentSession(): CurationSession | null;
+    /**
+     * Get pending feedback count
+     */
+    getPendingFeedbackCount(): number;
+    /**
+     * Interactive curation generator
+     */
+    interactiveCuration(limit?: number): AsyncGenerator<{
+        pattern: StoredPattern;
+        submit: (curation: CuratedPattern) => Promise<void>;
+        skip: () => void;
+    }>;
+}
+/**
+ * Create a RuvllmPatternCurator with default configuration
+ */
+export declare function createRuvllmPatternCurator(ruvllmProvider: RuvllmProvider, options?: {
+    curatorConfig?: Partial<CuratorConfig>;
+    useEmbeddings?: boolean;
+    hnswConfig?: any;
+}): RuvllmPatternCurator;
+//# sourceMappingURL=RuvllmPatternCurator.d.ts.map

package/dist/providers/RuvllmPatternCurator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RuvllmPatternCurator.d.ts","sourceRoot":"","sources":["../../src/providers/RuvllmPatternCurator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,EAGL,aAAa,EACb,cAAc,EAEd,aAAa,EAGb,eAAe,EACf,gBAAgB,EACjB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAA4B,MAAM,gCAAgC,CAAC;AAI9F;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,qCAAqC;IACrC,aAAa,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;IACvC,+BAA+B;IAC/B,cAAc,EAAE,cAAc,CAAC;IAC/B,gDAAgD;IAChD,WAAW,CAAC,EAAE,kBAAkB,CAAC;IACjC,+CAA+C;IAC/C,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAsND;;GAEG;AACH,qBAAa,oBAAqB,SAAQ,YAAY;IACpD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiB;IACzC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiB;IACxC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAsB;IACpD,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAwB;gBAE5C,MAAM,EAAE,0BAA0B;IAkC9C;;OAEG;IACH,YAAY,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,eAAe;IAIlD;;OAEG;IACH,UAAU,IAAI,eAAe,GAAG,IAAI;IAIpC;;OAEG;IACG,yBAAyB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAIzE;;OAEG;IACG,aAAa,CAAC,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAIpF;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC;QAC1B,YAAY,EAAE,MAAM,CAAC;QACrB,YAAY,EAAE,MAAM,CAAC;QACrB,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;IAIF;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC;QAC7B,iBAAiB,EAAE,MAAM,CAAC;QAC1B,oBAAoB,EAAE,MAAM,CAAC;QAC7B,gBAAgB,EAAE,MAAM,CAAC;KAC1B,CAAC;IAIF;;OAEG;IACG,YAAY,IAAI,OAAO,CAAC,gBAAgB,CAAC;IAI/C;;OAEG;IACG,qBAAqB,IAAI,OAAO,CAAC;QACrC,cAAc,EAAE;YAAE,aAAa,EAAE,MAAM,CAAA;SAAE,CAAC;QAC1C,aAAa,EAAE;YAAE,aAAa,EAAE,MAAM,CAAA;SAAE,CAAC;QACzC,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;IAIF;;OAEG;IACH,kBAAkB,IAAI,eAAe,EAAE;IAIvC;;OAEG;IACH,iBAAiB,IAAI,eAAe,GAAG,IAAI;IAI3C;;OAEG;IACH,uBAAuB,IAAI,MAAM;IAIjC;;OAEG;IACI,mBAAmB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,cAAc,CAAC;QACzD,OAAO,EAAE,aAAa,CAAC;QACvB,MAAM,EAAE,CAAC,QAAQ,EAAE,cAAc,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;QACpD,IAAI,EAAE,MAAM,IAAI,CAAC;KAClB,CAAC;CAGH;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,cAAc,EAAE,cAAc,EAC9B,OAAO,CAAC,EAAE;IACR,aAAa,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;IACvC,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,UAAU,CAAC,EAAE,GAAG,CAAC;CAClB,GACA,oBAAoB,CAatB"}