@hazeljs/rag 0.2.0-beta.1

package/dist/agentic/decorators/active-learning.decorator.js

@@ -0,0 +1,98 @@
+"use strict";
+/**
+ * Active Learning Decorator
+ * Learns from user feedback to improve retrieval
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ActiveLearning = ActiveLearning;
+exports.Feedback = Feedback;
+exports.getFeedbackStats = getFeedbackStats;
+exports.clearFeedback = clearFeedback;
+require("reflect-metadata");
+const feedbackStore = new Map();
+function ActiveLearning(config = {}) {
+    return function (target, propertyKey, descriptor) {
+        const originalMethod = descriptor.value;
+        descriptor.value = async function (...args) {
+            const results = await originalMethod.apply(this, args);
+            if (!config.feedbackEnabled) {
+                return results;
+            }
+            // Apply learned adjustments
+            const adjusted = applyLearning(results, config);
+            return adjusted;
+        };
+        return descriptor;
+    };
+}
+function Feedback() {
+    return function (target, propertyKey, descriptor) {
+        const originalMethod = descriptor.value;
+        descriptor.value = async function (...args) {
+            const feedbackData = args[0];
+            // Store feedback
+            storeFeedback(feedbackData);
+            // Execute original method if any
+            if (originalMethod) {
+                return originalMethod.apply(this, args);
+            }
+        };
+        return descriptor;
+    };
+}
+function applyLearning(results, config) {
+    if (!Array.isArray(results)) {
+        return results;
+    }
+    const storageKey = config.storageKey || 'default';
+    const feedback = feedbackStore.get(storageKey) || [];
+    if (feedback.length === 0) {
+        return results;
+    }
+    // Adjust scores based on feedback
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    return results
+        .map((result) => {
+        const relevantFeedback = feedback.filter((f) => f.resultId === result.id);
+        if (relevantFeedback.length === 0) {
+            return result;
+        }
+        const avgRating = relevantFeedback.reduce((sum, f) => sum + f.rating, 0) / relevantFeedback.length;
+        const relevanceBoost = (avgRating - 3) / 5; // Normalize to -0.4 to 0.4
+        return {
+            ...result,
+            score: Math.max(0, Math.min(1, (result.score || 0.5) + relevanceBoost)),
+            feedbackCount: relevantFeedback.length,
+            avgRating,
+        };
+    })
+        .sort((a, b) => (b.score || 0) - (a.score || 0));
+}
+function storeFeedback(feedback) {
+    const storageKey = 'default';
+    const existing = feedbackStore.get(storageKey) || [];
+    existing.push(feedback);
+    // Keep only recent feedback
+    const maxFeedback = 1000;
+    if (existing.length > maxFeedback) {
+        existing.splice(0, existing.length - maxFeedback);
+    }
+    feedbackStore.set(storageKey, existing);
+}
+function getFeedbackStats(storageKey = 'default') {
+    const feedback = feedbackStore.get(storageKey) || [];
+    if (feedback.length === 0) {
+        return { totalFeedback: 0, avgRating: 0, relevantCount: 0 };
+    }
+    const avgRating = feedback.reduce((sum, f) => sum + f.rating, 0) / feedback.length;
+    const relevantCount = feedback.filter((f) => f.relevant).length;
+    return {
+        totalFeedback: feedback.length,
+        avgRating,
+        relevantCount,
+    };
+}
+function clearFeedback(storageKey = 'default') {
+    feedbackStore.delete(storageKey);
+}
+//# sourceMappingURL=active-learning.decorator.js.map

package/dist/agentic/decorators/active-learning.decorator.js.map

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

package/dist/agentic/decorators/adaptive-retrieval.decorator.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Adaptive Retrieval Decorator
+ * Automatically selects the best retrieval strategy
+ */
+import 'reflect-metadata';
+import { AdaptiveStrategyResult, AgenticLLMProvider } from '../types';
+import { RetrievalStrategy } from '../../types';
+export interface AdaptiveRetrievalConfig {
+    strategies?: RetrievalStrategy[];
+    autoSelect?: boolean;
+    contextAware?: boolean;
+    llmProvider?: AgenticLLMProvider;
+}
+export declare function AdaptiveRetrieval(config?: AdaptiveRetrievalConfig): MethodDecorator;
+export declare function getAdaptiveStrategy(target: object, propertyKey: string | symbol): AdaptiveStrategyResult | undefined;
+//# sourceMappingURL=adaptive-retrieval.decorator.d.ts.map

package/dist/agentic/decorators/adaptive-retrieval.decorator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adaptive-retrieval.decorator.d.ts","sourceRoot":"","sources":["../../../src/agentic/decorators/adaptive-retrieval.decorator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,kBAAkB,CAAC;AAC1B,OAAO,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AACtE,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEhD,MAAM,WAAW,uBAAuB;IACtC,UAAU,CAAC,EAAE,iBAAiB,EAAE,CAAC;IACjC,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,WAAW,CAAC,EAAE,kBAAkB,CAAC;CAClC;AAID,wBAAgB,iBAAiB,CAAC,MAAM,GAAE,uBAA4B,GAAG,eAAe,CA4BvF;AAwGD,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,GAAG,MAAM,GAC3B,sBAAsB,GAAG,SAAS,CAEpC"}

package/dist/agentic/decorators/adaptive-retrieval.decorator.js

@@ -0,0 +1,114 @@
+"use strict";
+/**
+ * Adaptive Retrieval Decorator
+ * Automatically selects the best retrieval strategy
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AdaptiveRetrieval = AdaptiveRetrieval;
+exports.getAdaptiveStrategy = getAdaptiveStrategy;
+require("reflect-metadata");
+const types_1 = require("../../types");
+const ADAPTIVE_METADATA_KEY = Symbol('adaptive');
+function AdaptiveRetrieval(config = {}) {
+    return function (target, propertyKey, descriptor) {
+        const originalMethod = descriptor.value;
+        descriptor.value = async function (...args) {
+            const query = args[0];
+            if (!config.autoSelect) {
+                return originalMethod.apply(this, args);
+            }
+            // Select best strategy
+            const strategyResult = await selectStrategy(query, config);
+            // Store metadata
+            Reflect.defineMetadata(ADAPTIVE_METADATA_KEY, strategyResult, target, propertyKey);
+            // Execute with selected strategy
+            const modifiedArgs = [...args];
+            if (modifiedArgs[1] && typeof modifiedArgs[1] === 'object') {
+                modifiedArgs[1] = { ...modifiedArgs[1], strategy: strategyResult.selectedStrategy };
+            }
+            return originalMethod.apply(this, modifiedArgs);
+        };
+        return descriptor;
+    };
+}
+async function selectStrategy(query, config) {
+    const strategies = config.strategies || [
+        types_1.RetrievalStrategy.SIMILARITY,
+        types_1.RetrievalStrategy.HYBRID,
+        types_1.RetrievalStrategy.MMR,
+    ];
+    if (config.llmProvider) {
+        return selectStrategyWithLLM(query, strategies, config);
+    }
+    return selectStrategyHeuristic(query, strategies);
+}
+async function selectStrategyWithLLM(query, strategies, config) {
+    const prompt = `Select the best retrieval strategy for this query:
+
+Query: ${query}
+
+Available strategies:
+- similarity: Best for semantic similarity
+- hybrid: Combines keyword and semantic search
+- mmr: Maximizes diversity while maintaining relevance
+
+Respond in JSON:
+{
+  "selectedStrategy": "similarity|hybrid|mmr",
+  "reason": "explanation",
+  "confidence": 0.0-1.0
+}`;
+    try {
+        const result = await config.llmProvider.generateStructured(prompt, {});
+        return {
+            ...result,
+            alternatives: strategies
+                .filter((s) => s !== result.selectedStrategy)
+                .map((s) => ({ strategy: s, score: 0.5 })),
+        };
+    }
+    catch {
+        return selectStrategyHeuristic(query, strategies);
+    }
+}
+function selectStrategyHeuristic(query, strategies) {
+    const lowerQuery = query.toLowerCase();
+    // Check for diversity needs
+    if (lowerQuery.includes('different') ||
+        lowerQuery.includes('various') ||
+        lowerQuery.includes('diverse')) {
+        return {
+            selectedStrategy: types_1.RetrievalStrategy.MMR,
+            reason: 'Query requires diverse results',
+            confidence: 0.8,
+            alternatives: strategies
+                .filter((s) => s !== types_1.RetrievalStrategy.MMR)
+                .map((s) => ({ strategy: s, score: 0.5 })),
+        };
+    }
+    // Check for keyword-heavy queries
+    const hasSpecificTerms = /\b(exact|specific|precise|"[^"]+")/.test(query);
+    if (hasSpecificTerms) {
+        return {
+            selectedStrategy: types_1.RetrievalStrategy.HYBRID,
+            reason: 'Query contains specific terms requiring keyword matching',
+            confidence: 0.85,
+            alternatives: strategies
+                .filter((s) => s !== types_1.RetrievalStrategy.HYBRID)
+                .map((s) => ({ strategy: s, score: 0.6 })),
+        };
+    }
+    // Default to similarity
+    return {
+        selectedStrategy: types_1.RetrievalStrategy.SIMILARITY,
+        reason: 'General semantic search',
+        confidence: 0.7,
+        alternatives: strategies
+            .filter((s) => s !== types_1.RetrievalStrategy.SIMILARITY)
+            .map((s) => ({ strategy: s, score: 0.5 })),
+    };
+}
+function getAdaptiveStrategy(target, propertyKey) {
+    return Reflect.getMetadata(ADAPTIVE_METADATA_KEY, target, propertyKey);
+}
+//# sourceMappingURL=adaptive-retrieval.decorator.js.map

package/dist/agentic/decorators/adaptive-retrieval.decorator.js.map

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

package/dist/agentic/decorators/cached.decorator.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Cached Decorator
+ * Caches retrieval results for performance
+ */
+import 'reflect-metadata';
+export interface CachedConfig {
+    ttl?: number;
+    maxSize?: number;
+    keyGenerator?: (args: unknown[]) => string;
+}
+export declare function Cached(config?: CachedConfig): MethodDecorator;
+export declare function getCacheStats(): {
+    size: number;
+    totalHits: number;
+    hitRate: number;
+};
+export declare function clearCache(): void;
+//# sourceMappingURL=cached.decorator.d.ts.map

package/dist/agentic/decorators/cached.decorator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cached.decorator.d.ts","sourceRoot":"","sources":["../../../src/agentic/decorators/cached.decorator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,kBAAkB,CAAC;AAG1B,MAAM,WAAW,YAAY;IAC3B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,MAAM,CAAC;CAC5C;AAKD,wBAAgB,MAAM,CAAC,MAAM,GAAE,YAAiB,GAAG,eAAe,CA4CjE;AAmCD,wBAAgB,aAAa,IAAI;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB,CAcA;AAED,wBAAgB,UAAU,IAAI,IAAI,CAEjC"}

package/dist/agentic/decorators/cached.decorator.js

@@ -0,0 +1,93 @@
+"use strict";
+/**
+ * Cached Decorator
+ * Caches retrieval results for performance
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Cached = Cached;
+exports.getCacheStats = getCacheStats;
+exports.clearCache = clearCache;
+require("reflect-metadata");
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+const cache = new Map();
+function Cached(config = {}) {
+    return function (target, propertyKey, descriptor) {
+        const originalMethod = descriptor.value;
+        const ttl = (config.ttl || 3600) * 1000; // Convert to ms
+        const maxSize = config.maxSize || 100;
+        descriptor.value = async function (...args) {
+            // Generate cache key
+            const key = config.keyGenerator
+                ? config.keyGenerator(args)
+                : generateCacheKey(propertyKey, args);
+            // Check cache
+            const cached = cache.get(key);
+            if (cached && !isExpired(cached)) {
+                cached.hits++;
+                return cached.value;
+            }
+            // Execute method
+            const result = await originalMethod.apply(this, args);
+            // Store in cache
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            const entry = {
+                key,
+                value: result,
+                timestamp: Date.now(),
+                ttl,
+                hits: 0,
+            };
+            cache.set(key, entry);
+            // Enforce max size
+            if (cache.size > maxSize) {
+                evictLRU();
+            }
+            return result;
+        };
+        return descriptor;
+    };
+}
+function generateCacheKey(method, args) {
+    const argsStr = JSON.stringify(args);
+    return `${String(method)}:${argsStr}`;
+}
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+function isExpired(entry) {
+    return Date.now() - entry.timestamp > entry.ttl;
+}
+function evictLRU() {
+    let oldestKey = null;
+    let oldestTime = Infinity;
+    let lowestHits = Infinity;
+    for (const [key, entry] of cache.entries()) {
+        if (isExpired(entry)) {
+            cache.delete(key);
+            continue;
+        }
+        if (entry.hits < lowestHits || (entry.hits === lowestHits && entry.timestamp < oldestTime)) {
+            oldestKey = key;
+            oldestTime = entry.timestamp;
+            lowestHits = entry.hits;
+        }
+    }
+    if (oldestKey) {
+        cache.delete(oldestKey);
+    }
+}
+function getCacheStats() {
+    let totalHits = 0;
+    let totalRequests = 0;
+    for (const entry of cache.values()) {
+        totalHits += entry.hits;
+        totalRequests += entry.hits + 1; // +1 for initial miss
+    }
+    return {
+        size: cache.size,
+        totalHits,
+        hitRate: totalRequests > 0 ? totalHits / totalRequests : 0,
+    };
+}
+function clearCache() {
+    cache.clear();
+}
+//# sourceMappingURL=cached.decorator.js.map

package/dist/agentic/decorators/cached.decorator.js.map

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

package/dist/agentic/decorators/context-aware.decorator.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Context-Aware Decorator
+ * Maintains conversation context for improved retrieval
+ */
+import 'reflect-metadata';
+import { Context } from '../types';
+export interface ContextAwareConfig {
+    windowSize?: number;
+    entityTracking?: boolean;
+    topicModeling?: boolean;
+    sessionId?: string;
+}
+export declare function ContextAware(config?: ContextAwareConfig): MethodDecorator;
+export declare function getContext(target: object, propertyKey: string | symbol): Context | undefined;
+export declare function clearContext(sessionId: string): void;
+//# sourceMappingURL=context-aware.decorator.d.ts.map

package/dist/agentic/decorators/context-aware.decorator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-aware.decorator.d.ts","sourceRoot":"","sources":["../../../src/agentic/decorators/context-aware.decorator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,kBAAkB,CAAC;AAC1B,OAAO,EAAE,OAAO,EAAiB,MAAM,UAAU,CAAC;AAElD,MAAM,WAAW,kBAAkB;IACjC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAKD,wBAAgB,YAAY,CAAC,MAAM,GAAE,kBAAuB,GAAG,eAAe,CA0E7E;AA0GD,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAE5F;AAED,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAEpD"}

package/dist/agentic/decorators/context-aware.decorator.js

@@ -0,0 +1,169 @@
+"use strict";
+/**
+ * Context-Aware Decorator
+ * Maintains conversation context for improved retrieval
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ContextAware = ContextAware;
+exports.getContext = getContext;
+exports.clearContext = clearContext;
+require("reflect-metadata");
+const CONTEXT_METADATA_KEY = Symbol('contextAware');
+const contextStore = new Map();
+function ContextAware(config = {}) {
+    return function (target, propertyKey, descriptor) {
+        const originalMethod = descriptor.value;
+        descriptor.value = async function (...args) {
+            const query = args[0];
+            const sessionId = (typeof args[1] === 'object' && args[1] !== null && 'sessionId' in args[1]
+                ? args[1].sessionId
+                : undefined) ||
+                config.sessionId ||
+                'default';
+            // Get or create context
+            let context = contextStore.get(sessionId);
+            if (!context) {
+                context = {
+                    sessionId,
+                    conversationHistory: [],
+                    entities: [],
+                    topics: [],
+                    metadata: {},
+                };
+                contextStore.set(sessionId, context);
+            }
+            // Update context with current query
+            context.conversationHistory.push({
+                role: 'user',
+                content: query,
+                timestamp: new Date(),
+            });
+            // Maintain window size
+            const windowSize = config.windowSize || 5;
+            if (context.conversationHistory.length > windowSize * 2) {
+                context.conversationHistory = context.conversationHistory.slice(-windowSize * 2);
+            }
+            // Extract entities if enabled
+            if (config.entityTracking) {
+                const entities = extractEntities(query);
+                updateEntities(context, entities);
+            }
+            // Extract topics if enabled
+            if (config.topicModeling) {
+                const topics = extractTopics(query, context);
+                updateTopics(context, topics);
+            }
+            // Enhance query with context
+            const enhancedQuery = enhanceQueryWithContext(query, context);
+            // Execute with enhanced query
+            const modifiedArgs = [enhancedQuery, ...args.slice(1)];
+            const results = await originalMethod.apply(this, modifiedArgs);
+            // Store assistant response in context
+            if (results) {
+                context.conversationHistory.push({
+                    role: 'assistant',
+                    content: JSON.stringify(results).slice(0, 500),
+                    timestamp: new Date(),
+                });
+            }
+            Reflect.defineMetadata(CONTEXT_METADATA_KEY, context, target, propertyKey);
+            return results;
+        };
+        return descriptor;
+    };
+}
+function extractEntities(text) {
+    const entities = [];
+    // Simple named entity extraction (capitalized words)
+    const words = text.split(/\s+/);
+    const capitalizedWords = words.filter((w) => /^[A-Z][a-z]+/.test(w));
+    const entityCounts = new Map();
+    capitalizedWords.forEach((word) => {
+        entityCounts.set(word, (entityCounts.get(word) || 0) + 1);
+    });
+    entityCounts.forEach((count, name) => {
+        entities.push({
+            name,
+            type: 'UNKNOWN',
+            mentions: count,
+            lastSeen: new Date(),
+            attributes: {},
+        });
+    });
+    return entities;
+}
+function updateEntities(context, newEntities) {
+    newEntities.forEach((newEntity) => {
+        const existing = context.entities.find((e) => e.name === newEntity.name);
+        if (existing) {
+            existing.mentions += newEntity.mentions;
+            existing.lastSeen = new Date();
+        }
+        else {
+            context.entities.push(newEntity);
+        }
+    });
+    // Keep only recent entities
+    context.entities = context.entities
+        .sort((a, b) => b.lastSeen.getTime() - a.lastSeen.getTime())
+        .slice(0, 20);
+}
+function extractTopics(query, _context) {
+    const topics = [];
+    // Extract keywords
+    const words = query.toLowerCase().split(/\s+/);
+    const stopWords = new Set(['the', 'a', 'an', 'and', 'or', 'but', 'in', 'on', 'at', 'to', 'for']);
+    const keywords = words.filter((w) => w.length > 3 && !stopWords.has(w));
+    // Group into topics
+    const topicMap = new Map();
+    keywords.forEach((keyword) => {
+        const topic = keyword.slice(0, 5); // Simple topic grouping
+        if (!topicMap.has(topic)) {
+            topicMap.set(topic, []);
+        }
+        topicMap.get(topic).push(keyword);
+    });
+    topicMap.forEach((keywords, name) => {
+        topics.push({
+            name,
+            relevance: keywords.length / words.length,
+            keywords,
+        });
+    });
+    return topics;
+}
+function updateTopics(context, newTopics) {
+    newTopics.forEach((newTopic) => {
+        const existing = context.topics.find((t) => t.name === newTopic.name);
+        if (existing) {
+            existing.relevance = (existing.relevance + newTopic.relevance) / 2;
+            existing.keywords = [...new Set([...existing.keywords, ...newTopic.keywords])];
+        }
+        else {
+            context.topics.push(newTopic);
+        }
+    });
+    // Keep top topics
+    context.topics = context.topics.sort((a, b) => b.relevance - a.relevance).slice(0, 10);
+}
+function enhanceQueryWithContext(query, context) {
+    const enhancements = [query];
+    // Add recent entities
+    const topEntities = context.entities.slice(0, 3).map((e) => e.name);
+    if (topEntities.length > 0) {
+        enhancements.push(`Context entities: ${topEntities.join(', ')}`);
+    }
+    // Add recent topics
+    const topTopics = context.topics.slice(0, 2).map((t) => t.keywords[0]);
+    if (topTopics.length > 0) {
+        enhancements.push(`Related topics: ${topTopics.join(', ')}`);
+    }
+    return enhancements.join(' | ');
+}
+function getContext(target, propertyKey) {
+    return Reflect.getMetadata(CONTEXT_METADATA_KEY, target, propertyKey);
+}
+function clearContext(sessionId) {
+    contextStore.delete(sessionId);
+}
+//# sourceMappingURL=context-aware.decorator.js.map

package/dist/agentic/decorators/context-aware.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-aware.decorator.js","sourceRoot":"","sources":["../../../src/agentic/decorators/context-aware.decorator.ts"],"names":[],"mappings":";AAAA;;;GAGG;;AAeH,oCA0EC;AA0GD,gCAEC;AAED,oCAEC;AAvMD,4BAA0B;AAU1B,MAAM,oBAAoB,GAAG,MAAM,CAAC,cAAc,CAAC,CAAC;AACpD,MAAM,YAAY,GAAG,IAAI,GAAG,EAAmB,CAAC;AAEhD,SAAgB,YAAY,CAAC,SAA6B,EAAE;IAC1D,OAAO,UAAU,MAAc,EAAE,WAA4B,EAAE,UAA8B;QAC3F,MAAM,cAAc,GAAG,UAAU,CAAC,KAAK,CAAC;QAExC,UAAU,CAAC,KAAK,GAAG,KAAK,WAAW,GAAG,IAAe;YACnD,MAAM,KAAK,GAAG,IAAI,CAAC,CAAC,CAAW,CAAC;YAChC,MAAM,SAAS,GACb,CAAC,OAAO,IAAI,CAAC,CAAC,CAAC,KAAK,QAAQ,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,WAAW,IAAI,IAAI,CAAC,CAAC,CAAC;gBACxE,CAAC,CAAE,IAAI,CAAC,CAAC,CAA4B,CAAC,SAAS;gBAC/C,CAAC,CAAC,SAAS,CAAC;gBACd,MAAM,CAAC,SAAS;gBAChB,SAAS,CAAC;YAEZ,wBAAwB;YACxB,IAAI,OAAO,GAAG,YAAY,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;YAC1C,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,OAAO,GAAG;oBACR,SAAS;oBACT,mBAAmB,EAAE,EAAE;oBACvB,QAAQ,EAAE,EAAE;oBACZ,MAAM,EAAE,EAAE;oBACV,QAAQ,EAAE,EAAE;iBACb,CAAC;gBACF,YAAY,CAAC,GAAG,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;YACvC,CAAC;YAED,oCAAoC;YACpC,OAAO,CAAC,mBAAmB,CAAC,IAAI,CAAC;gBAC/B,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE,KAAK;gBACd,SAAS,EAAE,IAAI,IAAI,EAAE;aACtB,CAAC,CAAC;YAEH,uBAAuB;YACvB,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,IAAI,CAAC,CAAC;YAC1C,IAAI,OAAO,CAAC,mBAAmB,CAAC,MAAM,GAAG,UAAU,GAAG,CAAC,EAAE,CAAC;gBACxD,OAAO,CAAC,mBAAmB,GAAG,OAAO,CAAC,mBAAmB,CAAC,KAAK,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC;YACnF,CAAC;YAED,8BAA8B;YAC9B,IAAI,MAAM,CAAC,cAAc,EAAE,CAAC;gBAC1B,MAAM,QAAQ,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;gBACxC,cAAc,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;YACpC,CAAC;YAED,4BAA4B;YAC5B,IAAI,MAAM,CAAC,aAAa,EAAE,CAAC;gBACzB,MAAM,MAAM,GAAG,aAAa,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;gBAC7C,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YAChC,CAAC;YAED,6BAA6B;YAC7B,MAAM,aAAa,GAAG,uBAAuB,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;YAE9D,8BAA8B;YAC9B,MAAM,YAAY,GAAG,CAAC,aAAa,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;YACvD,MAAM,OAAO,GAAG,MAAM,cAAc,CAAC,KAAK,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;YAE/D,sCAAsC;YACtC,IAAI,OAAO,EAAE,CAAC;gBACZ,OAAO,CAAC,mBAAmB,CAAC,IAAI,CAAC;oBAC/B,IAAI,EAAE,WAAW;oBACjB,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC;oBAC9C,SAAS,EAAE,IAAI,IAAI,EAAE;iBACtB,CAAC,CAAC;YACL,CAAC;YAED,OAAO,CAAC,cAAc,CAAC,oBAAoB,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;YAE3E,OAAO,OAAO,CAAC;QACjB,CAAC,CAAC;QAEF,OAAO,UAAU,CAAC;IACpB,CAAC,CAAC;AACJ,CAAC;AAED,SAAS,eAAe,CAAC,IAAY;IACnC,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,qDAAqD;IACrD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAChC,MAAM,gBAAgB,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IAErE,MAAM,YAAY,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC/C,gBAAgB,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE;QAChC,YAAY,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAC5D,CAAC,CAAC,CAAC;IAEH,YAAY,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;QACnC,QAAQ,CAAC,IAAI,CAAC;YACZ,IAAI;YACJ,IAAI,EAAE,SAAS;YACf,QAAQ,EAAE,KAAK;YACf,QAAQ,EAAE,IAAI,IAAI,EAAE;YACpB,UAAU,EAAE,EAAE;SACf,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,SAAS,cAAc,CAAC,OAAgB,EAAE,WAAqB;IAC7D,WAAW,CAAC,OAAO,CAAC,CAAC,SAAS,EAAE,EAAE;QAChC,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC,IAAI,CAAC,CAAC;QACzE,IAAI,QAAQ,EAAE,CAAC;YACb,QAAQ,CAAC,QAAQ,IAAI,SAAS,CAAC,QAAQ,CAAC;YACxC,QAAQ,CAAC,QAAQ,GAAG,IAAI,IAAI,EAAE,CAAC;QACjC,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACnC,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,4BAA4B;IAC5B,OAAO,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ;SAChC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;SAC3D,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AAClB,CAAC;AAED,SAAS,aAAa,CAAC,KAAa,EAAE,QAAiB;IACrD,MAAM,MAAM,GAAY,EAAE,CAAC;IAE3B,mBAAmB;IACnB,MAAM,KAAK,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC/C,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,CAAC,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;IACjG,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IAExE,oBAAoB;IACpB,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAoB,CAAC;IAC7C,QAAQ,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC3B,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,wBAAwB;QAC3D,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;YACzB,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QAC1B,CAAC;QACD,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAE,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,IAAI,EAAE,EAAE;QAClC,MAAM,CAAC,IAAI,CAAC;YACV,IAAI;YACJ,SAAS,EAAE,QAAQ,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM;YACzC,QAAQ;SACT,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,YAAY,CAAC,OAAgB,EAAE,SAAkB;IACxD,SAAS,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,EAAE;QAC7B,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,IAAI,CAAC,CAAC;QACtE,IAAI,QAAQ,EAAE,CAAC;YACb,QAAQ,CAAC,SAAS,GAAG,CAAC,QAAQ,CAAC,SAAS,GAAG,QAAQ,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;YACnE,QAAQ,CAAC,QAAQ,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,QAAQ,CAAC,QAAQ,EAAE,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;QACjF,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAChC,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,kBAAkB;IAClB,OAAO,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AACzF,CAAC;AAED,SAAS,uBAAuB,CAAC,KAAa,EAAE,OAAgB;IAC9D,MAAM,YAAY,GAAa,CAAC,KAAK,CAAC,CAAC;IAEvC,sBAAsB;IACtB,MAAM,WAAW,GAAG,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACpE,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC3B,YAAY,CAAC,IAAI,CAAC,qBAAqB,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACnE,CAAC;IAED,oBAAoB;IACpB,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;IACvE,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzB,YAAY,CAAC,IAAI,CAAC,mBAAmB,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC/D,CAAC;IAED,OAAO,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAClC,CAAC;AAED,SAAgB,UAAU,CAAC,MAAc,EAAE,WAA4B;IACrE,OAAO,OAAO,CAAC,WAAW,CAAC,oBAAoB,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;AACxE,CAAC;AAED,SAAgB,YAAY,CAAC,SAAiB;IAC5C,YAAY,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;AACjC,CAAC"}

package/dist/agentic/decorators/corrective-rag.decorator.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Corrective RAG (CRAG) Decorator
+ * Self-corrects retrieval errors with fallback mechanisms
+ */
+import 'reflect-metadata';
+import { CorrectiveRAGResult, AgenticLLMProvider } from '../types';
+export interface CorrectiveRAGConfig {
+    relevanceThreshold?: number;
+    fallbackToWeb?: boolean;
+    maxCorrections?: number;
+    llmProvider?: AgenticLLMProvider;
+}
+export declare function CorrectiveRAG(config?: CorrectiveRAGConfig): MethodDecorator;
+export declare function getCorrectiveRAGResult(target: object, propertyKey: string | symbol): CorrectiveRAGResult | undefined;
+//# sourceMappingURL=corrective-rag.decorator.d.ts.map

package/dist/agentic/decorators/corrective-rag.decorator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"corrective-rag.decorator.d.ts","sourceRoot":"","sources":["../../../src/agentic/decorators/corrective-rag.decorator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,kBAAkB,CAAC;AAC1B,OAAO,EAAE,mBAAmB,EAAc,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAE/E,MAAM,WAAW,mBAAmB;IAClC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,kBAAkB,CAAC;CAClC;AAID,wBAAgB,aAAa,CAAC,MAAM,GAAE,mBAAwB,GAAG,eAAe,CAgD/E;AAuHD,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,GAAG,MAAM,GAC3B,mBAAmB,GAAG,SAAS,CAEjC"}