@hazeljs/rag 0.2.0-beta.1

package/dist/agentic/decorators/corrective-rag.decorator.js

@@ -0,0 +1,146 @@
+"use strict";
+/**
+ * Corrective RAG (CRAG) Decorator
+ * Self-corrects retrieval errors with fallback mechanisms
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CorrectiveRAG = CorrectiveRAG;
+exports.getCorrectiveRAGResult = getCorrectiveRAGResult;
+require("reflect-metadata");
+const CRAG_METADATA_KEY = Symbol('correctiveRAG');
+function CorrectiveRAG(config = {}) {
+    return function (target, propertyKey, descriptor) {
+        const originalMethod = descriptor.value;
+        descriptor.value = async function (...args) {
+            let results = await originalMethod.apply(this, args);
+            const query = args[0];
+            // Evaluate results
+            const evaluation = await evaluateResults(results, query, config);
+            const corrections = [];
+            let fallbackUsed = false;
+            // Apply corrections if needed
+            if (evaluation.needsCorrection) {
+                for (const issue of evaluation.issues) {
+                    corrections.push({
+                        type: issue.type,
+                        description: issue.description,
+                        action: issue.action,
+                    });
+                }
+                // Attempt to correct
+                const corrected = await correctResults(results, query, evaluation, config);
+                if (corrected) {
+                    results = corrected;
+                }
+                else if (config.fallbackToWeb) {
+                    // Fallback mechanism (placeholder)
+                    fallbackUsed = true;
+                }
+            }
+            const cragResult = {
+                results: Array.isArray(results) ? results : [results],
+                corrections,
+                fallbackUsed,
+                confidence: evaluation.confidence,
+            };
+            Reflect.defineMetadata(CRAG_METADATA_KEY, cragResult, target, propertyKey);
+            return results;
+        };
+        return descriptor;
+    };
+}
+async function evaluateResults(
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+results, query, config) {
+    const threshold = config.relevanceThreshold || 0.7;
+    const issues = [];
+    if (!results || (Array.isArray(results) && results.length === 0)) {
+        issues.push({
+            type: 'missing_info',
+            description: 'No results returned',
+            action: 'Expand query or use fallback',
+        });
+        return { needsCorrection: true, confidence: 0, issues };
+    }
+    const resultArray = Array.isArray(results) ? results : [results];
+    // Check relevance scores
+    const avgScore = resultArray.reduce((sum, r) => sum + (r.score || 0), 0) / resultArray.length;
+    if (avgScore < threshold) {
+        issues.push({
+            type: 'low_relevance',
+            description: `Average relevance score ${avgScore.toFixed(2)} below threshold ${threshold}`,
+            action: 'Rewrite query or adjust retrieval strategy',
+        });
+    }
+    // Check for contradictions
+    if (resultArray.length > 1 && config.llmProvider) {
+        const hasContradictions = await checkContradictions(resultArray, config.llmProvider);
+        if (hasContradictions) {
+            issues.push({
+                type: 'contradictory',
+                description: 'Results contain contradictory information',
+                action: 'Filter or re-rank results',
+            });
+        }
+    }
+    return {
+        needsCorrection: issues.length > 0,
+        confidence: Math.max(avgScore, 0.5),
+        issues,
+    };
+}
+async function correctResults(
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+results, query, 
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+evaluation, config
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+) {
+    if (!config.llmProvider) {
+        return null;
+    }
+    const prompt = `The following retrieval results have issues. Suggest corrections:
+
+Query: ${query}
+Issues: ${evaluation.issues.map((i) => i.description).join(', ')}
+
+Provide corrected query or strategy in JSON:
+{
+  "correctedQuery": "improved query",
+  "strategy": "new strategy",
+  "reasoning": "why this helps"
+}`;
+    try {
+        await config.llmProvider.generateStructured(prompt, {});
+        // Return null to signal re-query needed
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+async function checkContradictions(
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+results, llmProvider) {
+    if (results.length < 2)
+        return false;
+    const contents = results
+        .slice(0, 3)
+        .map((r) => r.content)
+        .join('\n\n');
+    const prompt = `Do these texts contain contradictory information? Answer yes or no.
+
+Texts:
+${contents.slice(0, 1000)}`;
+    try {
+        const response = await llmProvider.generate(prompt, { maxTokens: 10 });
+        return response.toLowerCase().includes('yes');
+    }
+    catch {
+        return false;
+    }
+}
+function getCorrectiveRAGResult(target, propertyKey) {
+    return Reflect.getMetadata(CRAG_METADATA_KEY, target, propertyKey);
+}
+//# sourceMappingURL=corrective-rag.decorator.js.map

package/dist/agentic/decorators/corrective-rag.decorator.js.map

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

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

@@ -0,0 +1,14 @@
+/**
+ * HyDE (Hypothetical Document Embeddings) Decorator
+ * Generates hypothetical documents to improve retrieval
+ */
+import 'reflect-metadata';
+import { HyDEResult, AgenticLLMProvider } from '../types';
+export interface HyDEConfig {
+    generateHypothesis?: boolean;
+    numHypotheses?: number;
+    llmProvider?: AgenticLLMProvider;
+}
+export declare function HyDE(config?: HyDEConfig): MethodDecorator;
+export declare function getHyDEResult(target: object, propertyKey: string | symbol): HyDEResult | undefined;
+//# sourceMappingURL=hyde.decorator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hyde.decorator.d.ts","sourceRoot":"","sources":["../../../src/agentic/decorators/hyde.decorator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,kBAAkB,CAAC;AAC1B,OAAO,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAE1D,MAAM,WAAW,UAAU;IACzB,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,kBAAkB,CAAC;CAClC;AAID,wBAAgB,IAAI,CAAC,MAAM,GAAE,UAAe,GAAG,eAAe,CAmD7D;AAkDD,wBAAgB,aAAa,CAC3B,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,GAAG,MAAM,GAC3B,UAAU,GAAG,SAAS,CAExB"}

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

@@ -0,0 +1,90 @@
+"use strict";
+/**
+ * HyDE (Hypothetical Document Embeddings) Decorator
+ * Generates hypothetical documents to improve retrieval
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HyDE = HyDE;
+exports.getHyDEResult = getHyDEResult;
+require("reflect-metadata");
+const HYDE_METADATA_KEY = Symbol('hyde');
+function HyDE(config = {}) {
+    return function (target, propertyKey, descriptor) {
+        const originalMethod = descriptor.value;
+        descriptor.value = async function (...args) {
+            const query = args[0];
+            if (!config.generateHypothesis || !config.llmProvider) {
+                return originalMethod.apply(this, args);
+            }
+            // Generate hypothetical documents
+            const hypotheses = await generateHypotheticalDocuments(query, config.numHypotheses || 3, config.llmProvider);
+            // Retrieve using each hypothesis
+            const allResults = [];
+            const seenIds = new Set();
+            for (const hypothesis of hypotheses) {
+                const results = await originalMethod.apply(this, [hypothesis, ...args.slice(1)]);
+                if (Array.isArray(results)) {
+                    for (const result of results) {
+                        if (result.id && !seenIds.has(result.id)) {
+                            seenIds.add(result.id);
+                            allResults.push(result);
+                        }
+                    }
+                }
+            }
+            // Re-rank by aggregated scores
+            const reranked = rerankResults(allResults, hypotheses.length);
+            const hydeResult = {
+                hypotheticalDocuments: hypotheses,
+                retrievedResults: reranked,
+                aggregatedScore: calculateAggregatedScore(reranked),
+            };
+            Reflect.defineMetadata(HYDE_METADATA_KEY, hydeResult, target, propertyKey);
+            return reranked;
+        };
+        return descriptor;
+    };
+}
+async function generateHypotheticalDocuments(query, count, llmProvider) {
+    const prompt = `Generate ${count} hypothetical documents that would perfectly answer this query.
+Each document should be detailed and comprehensive.
+
+Query: ${query}
+
+Generate ${count} hypothetical documents (one per line):`;
+    try {
+        const response = await llmProvider.generate(prompt, {
+            temperature: 0.7,
+            maxTokens: 1000,
+        });
+        const documents = response
+            .split('\n')
+            .map((line) => line.replace(/^\d+\.\s*/, '').trim())
+            .filter((line) => line.length > 50)
+            .slice(0, count);
+        return documents.length > 0 ? documents : [query];
+    }
+    catch {
+        return [query];
+    }
+}
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+function rerankResults(results, hypothesisCount) {
+    return results
+        .map((result) => ({
+        ...result,
+        score: (result.score || 0) * (1 + 0.1 * hypothesisCount),
+    }))
+        .sort((a, b) => (b.score || 0) - (a.score || 0));
+}
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+function calculateAggregatedScore(results) {
+    if (results.length === 0)
+        return 0;
+    const totalScore = results.reduce((sum, r) => sum + (r.score || 0), 0);
+    return totalScore / results.length;
+}
+function getHyDEResult(target, propertyKey) {
+    return Reflect.getMetadata(HYDE_METADATA_KEY, target, propertyKey);
+}
+//# sourceMappingURL=hyde.decorator.js.map

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

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

package/dist/agentic/decorators/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Agentic RAG Decorators
+ * Export all decorators
+ */
+export * from './query-planner.decorator';
+export * from './self-reflective.decorator';
+export * from './adaptive-retrieval.decorator';
+export * from './multi-hop.decorator';
+export * from './hyde.decorator';
+export * from './corrective-rag.decorator';
+export * from './context-aware.decorator';
+export * from './query-rewriter.decorator';
+export * from './source-verification.decorator';
+export * from './active-learning.decorator';
+export * from './cached.decorator';
+//# sourceMappingURL=index.d.ts.map

package/dist/agentic/decorators/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/agentic/decorators/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,2BAA2B,CAAC;AAC1C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,uBAAuB,CAAC;AACtC,cAAc,kBAAkB,CAAC;AACjC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,iCAAiC,CAAC;AAChD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,oBAAoB,CAAC"}

package/dist/agentic/decorators/index.js

@@ -0,0 +1,32 @@
+"use strict";
+/**
+ * Agentic RAG Decorators
+ * Export all decorators
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./query-planner.decorator"), exports);
+__exportStar(require("./self-reflective.decorator"), exports);
+__exportStar(require("./adaptive-retrieval.decorator"), exports);
+__exportStar(require("./multi-hop.decorator"), exports);
+__exportStar(require("./hyde.decorator"), exports);
+__exportStar(require("./corrective-rag.decorator"), exports);
+__exportStar(require("./context-aware.decorator"), exports);
+__exportStar(require("./query-rewriter.decorator"), exports);
+__exportStar(require("./source-verification.decorator"), exports);
+__exportStar(require("./active-learning.decorator"), exports);
+__exportStar(require("./cached.decorator"), exports);
+//# sourceMappingURL=index.js.map

package/dist/agentic/decorators/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/agentic/decorators/index.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;;;;;;;;;;;;;;AAEH,4DAA0C;AAC1C,8DAA4C;AAC5C,iEAA+C;AAC/C,wDAAsC;AACtC,mDAAiC;AACjC,6DAA2C;AAC3C,4DAA0C;AAC1C,6DAA2C;AAC3C,kEAAgD;AAChD,8DAA4C;AAC5C,qDAAmC"}

package/dist/agentic/decorators/multi-hop.decorator.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Multi-Hop Decorator
+ * Performs multi-hop reasoning across documents
+ */
+import 'reflect-metadata';
+import { ReasoningChain, AgenticLLMProvider } from '../types';
+export interface MultiHopConfig {
+    maxHops?: number;
+    strategy?: 'breadth-first' | 'depth-first' | 'adaptive';
+    llmProvider?: AgenticLLMProvider;
+}
+export declare function MultiHop(config?: MultiHopConfig): MethodDecorator;
+export declare function getReasoningChain(target: object, propertyKey: string | symbol): ReasoningChain | undefined;
+//# sourceMappingURL=multi-hop.decorator.d.ts.map

package/dist/agentic/decorators/multi-hop.decorator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"multi-hop.decorator.d.ts","sourceRoot":"","sources":["../../../src/agentic/decorators/multi-hop.decorator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,kBAAkB,CAAC;AAC1B,OAAO,EAAE,cAAc,EAAgB,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAE5E,MAAM,WAAW,cAAc;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,eAAe,GAAG,aAAa,GAAG,UAAU,CAAC;IACxD,WAAW,CAAC,EAAE,kBAAkB,CAAC;CAClC;AAID,wBAAgB,QAAQ,CAAC,MAAM,GAAE,cAAmB,GAAG,eAAe,CAuDrE;AAkFD,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,GAAG,MAAM,GAC3B,cAAc,GAAG,SAAS,CAE5B"}

package/dist/agentic/decorators/multi-hop.decorator.js

@@ -0,0 +1,120 @@
+"use strict";
+/**
+ * Multi-Hop Decorator
+ * Performs multi-hop reasoning across documents
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MultiHop = MultiHop;
+exports.getReasoningChain = getReasoningChain;
+require("reflect-metadata");
+const MULTIHOP_METADATA_KEY = Symbol('multiHop');
+function MultiHop(config = {}) {
+    return function (target, propertyKey, descriptor) {
+        const originalMethod = descriptor.value;
+        descriptor.value = async function (...args) {
+            const query = args[0];
+            const maxHops = config.maxHops || 3;
+            const chain = {
+                query,
+                hops: [],
+                finalAnswer: '',
+                confidence: 0,
+                sources: [],
+            };
+            let currentQuery = query;
+            for (let hop = 0; hop < maxHops; hop++) {
+                // Retrieve for current query
+                const results = await originalMethod.apply(this, [currentQuery, ...args.slice(1)]);
+                // Generate reasoning
+                const reasoning = await generateReasoning(currentQuery, results, config);
+                const hopResult = {
+                    hopNumber: hop + 1,
+                    query: currentQuery,
+                    results: Array.isArray(results) ? results : [results],
+                    reasoning: reasoning.reasoning,
+                    nextQuery: reasoning.nextQuery,
+                };
+                chain.hops.push(hopResult);
+                chain.sources.push(...hopResult.results);
+                // Check if we should continue
+                if (!reasoning.nextQuery || reasoning.shouldStop) {
+                    break;
+                }
+                currentQuery = reasoning.nextQuery;
+            }
+            // Generate final answer
+            chain.finalAnswer = await synthesizeFinalAnswer(chain, config);
+            chain.confidence = calculateConfidence(chain);
+            Reflect.defineMetadata(MULTIHOP_METADATA_KEY, chain, target, propertyKey);
+            return chain;
+        };
+        return descriptor;
+    };
+}
+async function generateReasoning(query, 
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+results, config) {
+    if (!config.llmProvider) {
+        return {
+            reasoning: 'Retrieved results for: ' + query,
+            shouldStop: true,
+        };
+    }
+    const resultsStr = JSON.stringify(results, null, 2).slice(0, 1500);
+    const prompt = `Analyze these search results and determine if we need more information.
+
+Query: ${query}
+Results: ${resultsStr}
+
+Provide analysis in JSON:
+{
+  "reasoning": "what we learned from these results",
+  "nextQuery": "follow-up query if needed, or null",
+  "shouldStop": true/false
+}`;
+    try {
+        return await config.llmProvider.generateStructured(prompt, {});
+    }
+    catch {
+        return {
+            reasoning: 'Retrieved results',
+            shouldStop: true,
+        };
+    }
+}
+async function synthesizeFinalAnswer(chain, config) {
+    if (!config.llmProvider) {
+        return chain.hops.map((h) => h.reasoning).join('\n\n');
+    }
+    const hopsStr = chain.hops.map((h) => `Hop ${h.hopNumber}: ${h.reasoning}`).join('\n');
+    const prompt = `Synthesize a final answer from this multi-hop reasoning chain:
+
+Original Query: ${chain.query}
+
+Reasoning Chain:
+${hopsStr}
+
+Provide a comprehensive final answer:`;
+    try {
+        return await config.llmProvider.generate(prompt);
+    }
+    catch {
+        return hopsStr;
+    }
+}
+function calculateConfidence(chain) {
+    const hopCount = chain.hops.length;
+    const sourceCount = chain.sources.length;
+    let confidence = 0.5;
+    if (sourceCount >= 5)
+        confidence += 0.2;
+    if (hopCount >= 2)
+        confidence += 0.1;
+    if (chain.finalAnswer.length > 100)
+        confidence += 0.1;
+    return Math.min(confidence, 1.0);
+}
+function getReasoningChain(target, propertyKey) {
+    return Reflect.getMetadata(MULTIHOP_METADATA_KEY, target, propertyKey);
+}
+//# sourceMappingURL=multi-hop.decorator.js.map

package/dist/agentic/decorators/multi-hop.decorator.js.map

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

package/dist/agentic/decorators/query-planner.decorator.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Query Planner Decorator
+ * Automatically decomposes complex queries into sub-queries
+ */
+import 'reflect-metadata';
+import { QueryPlan, AgenticLLMProvider } from '../types';
+export interface QueryPlannerConfig {
+    decompose?: boolean;
+    rewrite?: boolean;
+    maxSubQueries?: number;
+    parallel?: boolean;
+    llmProvider?: AgenticLLMProvider;
+}
+export declare function QueryPlanner(config?: QueryPlannerConfig): MethodDecorator;
+/**
+ * Get query plan metadata
+ */
+export declare function getQueryPlan(target: object, propertyKey: string | symbol): QueryPlan | undefined;
+//# sourceMappingURL=query-planner.decorator.d.ts.map

package/dist/agentic/decorators/query-planner.decorator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-planner.decorator.d.ts","sourceRoot":"","sources":["../../../src/agentic/decorators/query-planner.decorator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,kBAAkB,CAAC;AAC1B,OAAO,EAAE,SAAS,EAAY,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAEnE,MAAM,WAAW,kBAAkB;IACjC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,WAAW,CAAC,EAAE,kBAAkB,CAAC;CAClC;AAID,wBAAgB,YAAY,CAAC,MAAM,GAAE,kBAAuB,GAAG,eAAe,CA2B7E;AAwOD;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,CAEhG"}