@hazeljs/rag 0.2.0-alpha.1

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

@@ -0,0 +1,109 @@
+"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 prompts_1 = require("@hazeljs/prompts");
+require("../../prompts/agentic/multi-hop.prompt");
+const multi_hop_prompt_1 = require("../../prompts/agentic/multi-hop.prompt");
+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 = prompts_1.PromptRegistry.get(multi_hop_prompt_1.MULTI_HOP_KEY).render({
+        query,
+        resultsStr,
+    });
+    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 = prompts_1.PromptRegistry.get(multi_hop_prompt_1.MULTI_HOP_SYNTHESIZE_KEY).render({ originalQuery: chain.query, hopsStr });
+    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,20 @@
+/**
+ * Query Planner Decorator
+ * Automatically decomposes complex queries into sub-queries
+ */
+import 'reflect-metadata';
+import { QueryPlan, AgenticLLMProvider } from '../types';
+import '../../prompts/agentic/query-planner.prompt';
+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,OAAO,4CAA4C,CAAC;AAGpD,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;AAuND;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,CAEhG"}

package/dist/agentic/decorators/query-planner.decorator.js

@@ -0,0 +1,213 @@
+"use strict";
+/**
+ * Query Planner Decorator
+ * Automatically decomposes complex queries into sub-queries
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.QueryPlanner = QueryPlanner;
+exports.getQueryPlan = getQueryPlan;
+require("reflect-metadata");
+const prompts_1 = require("@hazeljs/prompts");
+require("../../prompts/agentic/query-planner.prompt");
+const query_planner_prompt_1 = require("../../prompts/agentic/query-planner.prompt");
+const QUERY_PLANNER_METADATA_KEY = Symbol('queryPlanner');
+function QueryPlanner(config = {}) {
+    return function (target, propertyKey, descriptor) {
+        const originalMethod = descriptor.value;
+        descriptor.value = async function (...args) {
+            const query = args[0];
+            if (!config.decompose) {
+                return originalMethod.apply(this, args);
+            }
+            // Decompose query into sub-queries
+            const plan = await decomposeQuery(query, config);
+            // Store plan in metadata
+            Reflect.defineMetadata(QUERY_PLANNER_METADATA_KEY, plan, target, propertyKey);
+            // Execute based on strategy
+            if (plan.strategy === 'parallel' && config.parallel) {
+                return executeParallel.call(this, plan, originalMethod, args);
+            }
+            else {
+                return executeSequential.call(this, plan, originalMethod, args);
+            }
+        };
+        return descriptor;
+    };
+}
+/**
+ * Decompose query into sub-queries
+ */
+async function decomposeQuery(query, config) {
+    // Check if query is complex enough to decompose
+    const complexity = estimateComplexity(query);
+    if (complexity < 3) {
+        return {
+            originalQuery: query,
+            subQueries: [
+                {
+                    id: '1',
+                    query,
+                    type: 'factual',
+                    dependencies: [],
+                    priority: 1,
+                },
+            ],
+            strategy: 'sequential',
+            estimatedComplexity: complexity,
+        };
+    }
+    // Use LLM to decompose if available
+    if (config.llmProvider) {
+        return decomposeWithLLM(query, config);
+    }
+    // Fallback to rule-based decomposition
+    return decomposeRuleBased(query, config);
+}
+/**
+ * LLM-based query decomposition
+ */
+async function decomposeWithLLM(query, config) {
+    const prompt = prompts_1.PromptRegistry.get(query_planner_prompt_1.QUERY_PLANNER_KEY).render({ query });
+    try {
+        const result = await config.llmProvider.generateStructured(prompt, {});
+        return {
+            originalQuery: query,
+            subQueries: result.subQueries.slice(0, config.maxSubQueries || 5),
+            strategy: result.strategy,
+            estimatedComplexity: result.subQueries.length,
+        };
+    }
+    catch {
+        return decomposeRuleBased(query, config);
+    }
+}
+/**
+ * Rule-based query decomposition
+ */
+function decomposeRuleBased(query, config) {
+    const subQueries = [];
+    // Split by conjunctions
+    const parts = query.split(/\band\b|\bor\b|\bthen\b/i);
+    parts.forEach((part, index) => {
+        const trimmed = part.trim();
+        if (trimmed.length > 10) {
+            subQueries.push({
+                id: String(index + 1),
+                query: trimmed,
+                type: detectQueryType(trimmed),
+                dependencies: index > 0 ? [String(index)] : [],
+                priority: index + 1,
+            });
+        }
+    });
+    if (subQueries.length === 0) {
+        subQueries.push({
+            id: '1',
+            query,
+            type: 'factual',
+            dependencies: [],
+            priority: 1,
+        });
+    }
+    return {
+        originalQuery: query,
+        subQueries: subQueries.slice(0, config.maxSubQueries || 5),
+        strategy: subQueries.length > 1 ? 'parallel' : 'sequential',
+        estimatedComplexity: subQueries.length,
+    };
+}
+/**
+ * Detect query type
+ */
+function detectQueryType(query) {
+    const lowerQuery = query.toLowerCase();
+    if (lowerQuery.includes('compare') || lowerQuery.includes('difference')) {
+        return 'comparative';
+    }
+    if (lowerQuery.includes('when') || lowerQuery.includes('timeline')) {
+        return 'temporal';
+    }
+    if (lowerQuery.includes('why') || lowerQuery.includes('how') || lowerQuery.includes('analyze')) {
+        return 'analytical';
+    }
+    return 'factual';
+}
+/**
+ * Estimate query complexity
+ */
+function estimateComplexity(query) {
+    let score = 1;
+    // Length factor
+    if (query.length > 100)
+        score += 1;
+    if (query.length > 200)
+        score += 1;
+    // Multiple questions
+    const questionMarks = (query.match(/\?/g) || []).length;
+    score += questionMarks;
+    // Conjunctions
+    const conjunctions = (query.match(/\band\b|\bor\b|\bthen\b/gi) || []).length;
+    score += conjunctions;
+    // Complex words
+    const complexWords = ['compare', 'analyze', 'evaluate', 'synthesize'];
+    complexWords.forEach((word) => {
+        if (query.toLowerCase().includes(word))
+            score += 1;
+    });
+    return Math.min(score, 10);
+}
+/**
+ * Execute sub-queries in parallel
+ */
+async function executeParallel(plan, 
+// eslint-disable-next-line @typescript-eslint/no-unsafe-function-type
+originalMethod, args) {
+    const results = await Promise.all(plan.subQueries.map((subQuery) => originalMethod.apply(this, [subQuery.query, ...args.slice(1)])));
+    // Merge results
+    return mergeResults(results, plan);
+}
+/**
+ * Execute sub-queries sequentially
+ */
+async function executeSequential(plan, 
+// eslint-disable-next-line @typescript-eslint/no-unsafe-function-type
+originalMethod, args) {
+    const results = [];
+    for (const subQuery of plan.subQueries) {
+        const result = await originalMethod.apply(this, [subQuery.query, ...args.slice(1)]);
+        results.push(result);
+    }
+    return mergeResults(results, plan);
+}
+/**
+ * Merge results from sub-queries
+ */
+function mergeResults(results, _plan) {
+    if (!Array.isArray(results[0])) {
+        return results;
+    }
+    // Flatten and deduplicate search results
+    const allResults = results.flat();
+    const seen = new Set();
+    const merged = [];
+    for (const result of allResults) {
+        if (typeof result === 'object' &&
+            result !== null &&
+            'id' in result &&
+            typeof result.id === 'string') {
+            const id = result.id;
+            if (!seen.has(id)) {
+                seen.add(id);
+                merged.push(result);
+            }
+        }
+    }
+    return merged;
+}
+/**
+ * Get query plan metadata
+ */
+function getQueryPlan(target, propertyKey) {
+    return Reflect.getMetadata(QUERY_PLANNER_METADATA_KEY, target, propertyKey);
+}
+//# sourceMappingURL=query-planner.decorator.js.map

package/dist/agentic/decorators/query-planner.decorator.js.map

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

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

@@ -0,0 +1,16 @@
+/**
+ * Query Rewriter Decorator
+ * Rewrites and expands queries for better retrieval
+ */
+import 'reflect-metadata';
+import { AgenticLLMProvider } from '../types';
+import '../../prompts/agentic/query-rewriter.prompt';
+export interface QueryRewriterConfig {
+    techniques?: ('expansion' | 'clarification' | 'synonym' | 'decomposition')[];
+    llmBased?: boolean;
+    llmProvider?: AgenticLLMProvider;
+    maxVariations?: number;
+}
+export declare function QueryRewriter(config?: QueryRewriterConfig): MethodDecorator;
+export declare function getQueryVariations(target: object, propertyKey: string | symbol): string[];
+//# sourceMappingURL=query-rewriter.decorator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"query-rewriter.decorator.d.ts","sourceRoot":"","sources":["../../../src/agentic/decorators/query-rewriter.decorator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,kBAAkB,CAAC;AAC1B,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAE9C,OAAO,6CAA6C,CAAC;AAGrD,MAAM,WAAW,mBAAmB;IAClC,UAAU,CAAC,EAAE,CAAC,WAAW,GAAG,eAAe,GAAG,SAAS,GAAG,eAAe,CAAC,EAAE,CAAC;IAC7E,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,WAAW,CAAC,EAAE,kBAAkB,CAAC;IACjC,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAID,wBAAgB,aAAa,CAAC,MAAM,GAAE,mBAAwB,GAAG,eAAe,CAqC/E;AAiID,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,EAAE,CAEzF"}

package/dist/agentic/decorators/query-rewriter.decorator.js

@@ -0,0 +1,143 @@
+"use strict";
+/**
+ * Query Rewriter Decorator
+ * Rewrites and expands queries for better retrieval
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.QueryRewriter = QueryRewriter;
+exports.getQueryVariations = getQueryVariations;
+require("reflect-metadata");
+const prompts_1 = require("@hazeljs/prompts");
+require("../../prompts/agentic/query-rewriter.prompt");
+const query_rewriter_prompt_1 = require("../../prompts/agentic/query-rewriter.prompt");
+const REWRITER_METADATA_KEY = Symbol('queryRewriter');
+function QueryRewriter(config = {}) {
+    return function (target, propertyKey, descriptor) {
+        const originalMethod = descriptor.value;
+        descriptor.value = async function (...args) {
+            const query = args[0];
+            // Generate query variations
+            const variations = await generateQueryVariations(query, config);
+            // Execute search with all variations
+            const allResults = [];
+            const seenIds = new Set();
+            for (const variation of variations) {
+                const results = await originalMethod.apply(this, [variation, ...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 frequency across variations
+            const ranked = rerankByFrequency(allResults, variations.length);
+            Reflect.defineMetadata(REWRITER_METADATA_KEY, variations, target, propertyKey);
+            return ranked;
+        };
+        return descriptor;
+    };
+}
+async function generateQueryVariations(query, config) {
+    const variations = [query]; // Always include original
+    const techniques = config.techniques || ['expansion', 'synonym'];
+    const maxVariations = config.maxVariations || 3;
+    if (config.llmBased && config.llmProvider) {
+        return generateWithLLM(query, techniques, config.llmProvider, maxVariations);
+    }
+    // Rule-based variations
+    for (const technique of techniques) {
+        switch (technique) {
+            case 'expansion':
+                variations.push(...expandQuery(query));
+                break;
+            case 'synonym':
+                variations.push(...addSynonyms(query));
+                break;
+            case 'clarification':
+                variations.push(...clarifyQuery(query));
+                break;
+        }
+    }
+    return [...new Set(variations)].slice(0, maxVariations + 1);
+}
+async function generateWithLLM(query, techniques, llmProvider, maxVariations) {
+    const prompt = prompts_1.PromptRegistry.get(query_rewriter_prompt_1.QUERY_REWRITER_KEY).render({
+        maxVariations: String(maxVariations),
+        techniques: techniques.join(', '),
+        query,
+    });
+    try {
+        const response = await llmProvider.generate(prompt, { temperature: 0.7 });
+        const variations = response
+            .split('\n')
+            .map((line) => line.replace(/^\d+\.\s*/, '').trim())
+            .filter((line) => line.length > 5)
+            .slice(0, maxVariations);
+        return [query, ...variations];
+    }
+    catch {
+        return [query];
+    }
+}
+function expandQuery(query) {
+    const expansions = [];
+    // Add question words if not present
+    if (!query.match(/^(what|who|where|when|why|how)/i)) {
+        expansions.push(`What is ${query}?`);
+        expansions.push(`How does ${query} work?`);
+    }
+    // Add context
+    expansions.push(`${query} explanation`);
+    expansions.push(`${query} details`);
+    return expansions;
+}
+function addSynonyms(query) {
+    const synonymMap = {
+        find: ['search', 'locate', 'discover'],
+        show: ['display', 'present', 'demonstrate'],
+        explain: ['describe', 'clarify', 'elaborate'],
+        compare: ['contrast', 'differentiate', 'analyze'],
+    };
+    const variations = [];
+    const words = query.split(/\s+/);
+    words.forEach((word, index) => {
+        const lowerWord = word.toLowerCase();
+        if (synonymMap[lowerWord]) {
+            synonymMap[lowerWord].forEach((synonym) => {
+                const newWords = [...words];
+                newWords[index] = synonym;
+                variations.push(newWords.join(' '));
+            });
+        }
+    });
+    return variations;
+}
+function clarifyQuery(query) {
+    const clarifications = [];
+    // Add specificity
+    if (query.length < 50) {
+        clarifications.push(`${query} with examples`);
+        clarifications.push(`${query} in detail`);
+    }
+    return clarifications;
+}
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+function rerankByFrequency(results, variationCount) {
+    const frequency = new Map();
+    results.forEach((result) => {
+        frequency.set(result.id, (frequency.get(result.id) || 0) + 1);
+    });
+    return results
+        .map((result) => ({
+        ...result,
+        score: (result.score || 0) * (1 + (frequency.get(result.id) || 0) / variationCount),
+    }))
+        .sort((a, b) => (b.score || 0) - (a.score || 0));
+}
+function getQueryVariations(target, propertyKey) {
+    return Reflect.getMetadata(REWRITER_METADATA_KEY, target, propertyKey) || [];
+}
+//# sourceMappingURL=query-rewriter.decorator.js.map

package/dist/agentic/decorators/query-rewriter.decorator.js.map

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

package/dist/agentic/decorators/self-reflective.decorator.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Self-Reflective Decorator
+ * Evaluates and iteratively improves retrieval results
+ */
+import 'reflect-metadata';
+import { ReflectionResult, AgenticLLMProvider } from '../types';
+import '../../prompts/agentic/self-reflective.prompt';
+import '../../prompts/agentic/self-reflective-improve.prompt';
+export interface SelfReflectiveConfig {
+    maxIterations?: number;
+    qualityThreshold?: number;
+    llmProvider?: AgenticLLMProvider;
+    enableAutoImprovement?: boolean;
+}
+export declare function SelfReflective(config?: SelfReflectiveConfig): MethodDecorator;
+/**
+ * Get reflection metadata
+ */
+export declare function getReflections(target: object, propertyKey: string | symbol): ReflectionResult[];
+//# sourceMappingURL=self-reflective.decorator.d.ts.map

package/dist/agentic/decorators/self-reflective.decorator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"self-reflective.decorator.d.ts","sourceRoot":"","sources":["../../../src/agentic/decorators/self-reflective.decorator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,kBAAkB,CAAC;AAC1B,OAAO,EAAE,gBAAgB,EAAqB,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAEnF,OAAO,8CAA8C,CAAC;AACtD,OAAO,sDAAsD,CAAC;AAI9D,MAAM,WAAW,oBAAoB;IACnC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,WAAW,CAAC,EAAE,kBAAkB,CAAC;IACjC,qBAAqB,CAAC,EAAE,OAAO,CAAC;CACjC;AAID,wBAAgB,cAAc,CAAC,MAAM,GAAE,oBAAyB,GAAG,eAAe,CA8DjF;AA+JD;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,gBAAgB,EAAE,CAE/F"}