@eucoder/rag 0.2.0

package/dist/optimizer.test.js.map

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

package/dist/self-improving.d.ts

@@ -0,0 +1,85 @@
+import type { RagAnswer } from "./types.js";
+import type { FeedbackStorage, OptimizationSuggestion } from "./feedback.js";
+import { type RagStrategyConfig } from "./ab-testing.js";
+import { type OptimizableParams } from "./optimizer.js";
+/**
+ * Configurazione per il sistema self-improving
+ */
+export interface SelfImprovingConfig {
+    minFeedbackForOptimization: number;
+    minConfidenceForSuggestion: number;
+    minSamplesForABTest: number;
+    autoApplySuggestions: boolean;
+    onOptimization?: (suggestions: OptimizationSuggestion[]) => void;
+    onABTestComplete?: (result: any) => void;
+}
+/**
+ * Sistema self-improving per RAG
+ * Integra feedback collection, A/B testing e ottimizzazione automatica
+ */
+export declare class SelfImprovingRag {
+    private storage;
+    private abFramework;
+    private optimizer;
+    private config;
+    private currentParams;
+    constructor(config?: Partial<SelfImprovingConfig>, storage?: FeedbackStorage);
+    /**
+     * Registra una strategia RAG
+     */
+    registerStrategy(config: RagStrategyConfig, params: OptimizableParams): void;
+    /**
+     * Seleziona la migliore strategia basata su metriche storiche
+     */
+    selectBestStrategy(): Promise<{
+        strategy: string;
+        params: OptimizableParams;
+    } | null>;
+    /**
+     * Registra feedback per una risposta
+     */
+    recordFeedback(query: string, answer: RagAnswer, feedback: {
+        rating: number;
+        relevance: number;
+        completeness: number;
+        citationsQuality: number;
+        comments?: string;
+    }, strategy: string): Promise<void>;
+    /**
+     * Controlla se è tempo di ottimizzare e applica suggerimenti
+     */
+    private checkAndOptimize;
+    /**
+     * Esegue A/B test tra due strategie
+     */
+    runABTest(strategyA: string, strategyB: string): Promise<any>;
+    /**
+     * Ottiene parametri correnti per una strategia
+     */
+    getParams(strategy: string): OptimizableParams | undefined;
+    /**
+     * Aggiorna parametri per una strategia
+     */
+    updateParams(strategy: string, params: OptimizableParams): void;
+    /**
+     * Ottiene metriche per una strategia
+     */
+    getMetrics(strategy: string): Promise<import("./feedback.js").RagMetrics | null>;
+    /**
+     * Ottiene tutte le metriche
+     */
+    getAllMetrics(): Promise<import("./feedback.js").RagMetrics[]>;
+    /**
+     * Genera report completo
+     */
+    generateReport(strategy: string): Promise<string>;
+    /**
+     * Ottiene suggerimenti di ottimizzazione
+     */
+    getSuggestions(strategy: string): Promise<OptimizationSuggestion[]>;
+    /**
+     * Resetta tutti i feedback (per testing)
+     */
+    reset(strategy?: string): Promise<void>;
+}
+//# sourceMappingURL=self-improving.d.ts.map

package/dist/self-improving.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"self-improving.d.ts","sourceRoot":"","sources":["../src/self-improving.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,KAAK,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAE7E,OAAO,EAAmB,KAAK,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAC1E,OAAO,EAAsB,KAAK,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAE5E;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAElC,0BAA0B,EAAE,MAAM,CAAC;IACnC,0BAA0B,EAAE,MAAM,CAAC;IAGnC,mBAAmB,EAAE,MAAM,CAAC;IAG5B,oBAAoB,EAAE,OAAO,CAAC;IAG9B,cAAc,CAAC,EAAE,CAAC,WAAW,EAAE,sBAAsB,EAAE,KAAK,IAAI,CAAC;IACjE,gBAAgB,CAAC,EAAE,CAAC,MAAM,EAAE,GAAG,KAAK,IAAI,CAAC;CAC1C;AAED;;;GAGG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,OAAO,CAAkB;IACjC,OAAO,CAAC,WAAW,CAAkB;IACrC,OAAO,CAAC,SAAS,CAAqB;IACtC,OAAO,CAAC,MAAM,CAAgC;IAC9C,OAAO,CAAC,aAAa,CAA6C;gBAEtD,MAAM,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC,EAAE,OAAO,CAAC,EAAE,eAAe;IAe5E;;OAEG;IACH,gBAAgB,CAAC,MAAM,EAAE,iBAAiB,EAAE,MAAM,EAAE,iBAAiB,GAAG,IAAI;IAK5E;;OAEG;IACG,kBAAkB,IAAI,OAAO,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,iBAAiB,CAAA;KAAE,GAAG,IAAI,CAAC;IAiC3F;;OAEG;IACG,cAAc,CAClB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,SAAS,EACjB,QAAQ,EAAE;QACR,MAAM,EAAE,MAAM,CAAC;QACf,SAAS,EAAE,MAAM,CAAC;QAClB,YAAY,EAAE,MAAM,CAAC;QACrB,gBAAgB,EAAE,MAAM,CAAC;QACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,EACD,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC;IAgBhB;;OAEG;YACW,gBAAgB;IA4B9B;;OAEG;IACG,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;IA6BnE;;OAEG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS;IAI1D;;OAEG;IACH,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,iBAAiB,GAAG,IAAI;IAI/D;;OAEG;IACG,UAAU,CAAC,QAAQ,EAAE,MAAM;IAIjC;;OAEG;IACG,aAAa;IAInB;;OAEG;IACG,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAKvD;;OAEG;IACG,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,EAAE,CAAC;IAKzE;;OAEG;IACG,KAAK,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAG9C"}

package/dist/self-improving.js

@@ -0,0 +1,163 @@
+import { InMemoryFeedbackStorage } from "./feedback.js";
+import { ABTestFramework } from "./ab-testing.js";
+import { ParameterOptimizer } from "./optimizer.js";
+/**
+ * Sistema self-improving per RAG
+ * Integra feedback collection, A/B testing e ottimizzazione automatica
+ */
+export class SelfImprovingRag {
+    storage;
+    abFramework;
+    optimizer;
+    config;
+    currentParams = new Map();
+    constructor(config, storage) {
+        this.storage = storage || new InMemoryFeedbackStorage();
+        this.abFramework = new ABTestFramework(this.storage);
+        this.optimizer = new ParameterOptimizer(this.storage);
+        this.config = {
+            minFeedbackForOptimization: config?.minFeedbackForOptimization ?? 20,
+            minConfidenceForSuggestion: config?.minConfidenceForSuggestion ?? 0.7,
+            minSamplesForABTest: config?.minSamplesForABTest ?? 30,
+            autoApplySuggestions: config?.autoApplySuggestions ?? false,
+            onOptimization: config?.onOptimization ?? (() => { }),
+            onABTestComplete: config?.onABTestComplete ?? (() => { }),
+        };
+    }
+    /**
+     * Registra una strategia RAG
+     */
+    registerStrategy(config, params) {
+        this.abFramework.registerStrategy(config);
+        this.currentParams.set(config.name, params);
+    }
+    /**
+     * Seleziona la migliore strategia basata su metriche storiche
+     */
+    async selectBestStrategy() {
+        const allMetrics = await this.abFramework.getAllMetrics();
+        if (allMetrics.length === 0) {
+            // Nessuna metrica disponibile, usa prima strategia registrata
+            const strategies = Array.from(this.currentParams.keys());
+            if (strategies.length === 0)
+                return null;
+            const strategy = strategies[0];
+            return {
+                strategy,
+                params: this.currentParams.get(strategy),
+            };
+        }
+        // Seleziona strategia con score più alto e confidence sufficiente
+        const validMetrics = allMetrics.filter(m => m.confidence >= 0.5);
+        if (validMetrics.length === 0) {
+            // Usa quella con più feedback
+            const best = allMetrics[0];
+            return {
+                strategy: best.strategy,
+                params: this.currentParams.get(best.strategy) || {},
+            };
+        }
+        const best = validMetrics[0];
+        return {
+            strategy: best.strategy,
+            params: this.currentParams.get(best.strategy) || {},
+        };
+    }
+    /**
+     * Registra feedback per una risposta
+     */
+    async recordFeedback(query, answer, feedback, strategy) {
+        await this.abFramework.recordFeedback(query, answer, feedback.rating, feedback.relevance, feedback.completeness, feedback.citationsQuality, strategy, feedback.comments);
+        // Controlla se è tempo di ottimizzare
+        await this.checkAndOptimize(strategy);
+    }
+    /**
+     * Controlla se è tempo di ottimizzare e applica suggerimenti
+     */
+    async checkAndOptimize(strategy) {
+        const feedbacks = await this.storage.getFeedback(strategy);
+        if (feedbacks.length < this.config.minFeedbackForOptimization) {
+            return; // Non abbastanza feedback
+        }
+        const currentParams = this.currentParams.get(strategy);
+        if (!currentParams)
+            return;
+        const suggestions = await this.optimizer.analyzeAndSuggest(strategy, currentParams);
+        if (suggestions.length > 0) {
+            // Notifica suggerimenti
+            this.config.onOptimization(suggestions);
+            // Auto-applica se configurato
+            if (this.config.autoApplySuggestions) {
+                const optimizedParams = this.optimizer.applySuggestions(currentParams, suggestions, this.config.minConfidenceForSuggestion);
+                this.currentParams.set(strategy, optimizedParams);
+            }
+        }
+    }
+    /**
+     * Esegue A/B test tra due strategie
+     */
+    async runABTest(strategyA, strategyB) {
+        try {
+            const result = await this.abFramework.runABTest(strategyA, strategyB, this.config.minSamplesForABTest);
+            this.config.onABTestComplete(result);
+            // Se c'è un vincitore chiaro, aggiorna parametri
+            if (result.winner !== "tie" && result.statisticalSignificance > 0.8) {
+                const winnerStrategy = result.winner === "A" ? strategyA : strategyB;
+                const winnerMetrics = result.winner === "A" ? result.metricsA : result.metricsB;
+                // Log vittoria
+                console.log(`A/B Test: ${winnerStrategy} vince con score ${winnerMetrics.overallScore.toFixed(3)} ` +
+                    `(miglioramento: ${(result.improvement * 100).toFixed(1)}%)`);
+            }
+            return result;
+        }
+        catch (error) {
+            console.warn("A/B test non può essere eseguito:", error.message);
+            return null;
+        }
+    }
+    /**
+     * Ottiene parametri correnti per una strategia
+     */
+    getParams(strategy) {
+        return this.currentParams.get(strategy);
+    }
+    /**
+     * Aggiorna parametri per una strategia
+     */
+    updateParams(strategy, params) {
+        this.currentParams.set(strategy, params);
+    }
+    /**
+     * Ottiene metriche per una strategia
+     */
+    async getMetrics(strategy) {
+        return this.abFramework.getStrategyMetrics(strategy);
+    }
+    /**
+     * Ottiene tutte le metriche
+     */
+    async getAllMetrics() {
+        return this.abFramework.getAllMetrics();
+    }
+    /**
+     * Genera report completo
+     */
+    async generateReport(strategy) {
+        const currentParams = this.currentParams.get(strategy) || {};
+        return this.optimizer.generateReport(strategy, currentParams);
+    }
+    /**
+     * Ottiene suggerimenti di ottimizzazione
+     */
+    async getSuggestions(strategy) {
+        const currentParams = this.currentParams.get(strategy) || {};
+        return this.optimizer.analyzeAndSuggest(strategy, currentParams);
+    }
+    /**
+     * Resetta tutti i feedback (per testing)
+     */
+    async reset(strategy) {
+        await this.storage.clearFeedback(strategy);
+    }
+}
+//# sourceMappingURL=self-improving.js.map

package/dist/self-improving.js.map

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

package/dist/self-improving.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=self-improving.test.d.ts.map

package/dist/self-improving.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"self-improving.test.d.ts","sourceRoot":"","sources":["../src/self-improving.test.ts"],"names":[],"mappings":""}

package/dist/self-improving.test.js

@@ -0,0 +1,234 @@
+import { describe, it, expect, beforeEach } from "vitest";
+import { SelfImprovingRag } from "./self-improving.js";
+import { InMemoryFeedbackStorage } from "./feedback.js";
+describe("SelfImprovingRag", () => {
+    let selfImproving;
+    let storage;
+    beforeEach(() => {
+        storage = new InMemoryFeedbackStorage();
+        selfImproving = new SelfImprovingRag({
+            minFeedbackForOptimization: 10,
+            minConfidenceForSuggestion: 0.7,
+            minSamplesForABTest: 15,
+            autoApplySuggestions: false,
+        }, storage);
+    });
+    it("should register strategies with parameters", () => {
+        const config = {
+            name: "strategy-a",
+            type: "corrective",
+            params: {},
+        };
+        const params = {
+            minScore: 0.5,
+            topK: 10,
+        };
+        selfImproving.registerStrategy(config, params);
+        const retrievedParams = selfImproving.getParams("strategy-a");
+        expect(retrievedParams).toEqual(params);
+    });
+    it("should select best strategy based on metrics", async () => {
+        const configA = {
+            name: "strategy-a",
+            type: "corrective",
+            params: {},
+        };
+        const configB = {
+            name: "strategy-b",
+            type: "hybrid",
+            params: {},
+        };
+        selfImproving.registerStrategy(configA, { minScore: 0.5 });
+        selfImproving.registerStrategy(configB, { semanticWeight: 0.6 });
+        // Add feedback for strategy A (lower quality)
+        for (let i = 0; i < 20; i++) {
+            await selfImproving.recordFeedback(`query ${i}`, { text: `answer ${i}`, citations: [], steps: [], rewrites: 0 }, {
+                rating: 3,
+                relevance: 0.6,
+                completeness: 0.5,
+                citationsQuality: 0.7,
+            }, "strategy-a");
+        }
+        // Add feedback for strategy B (higher quality)
+        for (let i = 0; i < 20; i++) {
+            await selfImproving.recordFeedback(`query ${i}`, { text: `answer ${i}`, citations: [], steps: [], rewrites: 0 }, {
+                rating: 5,
+                relevance: 0.9,
+                completeness: 0.85,
+                citationsQuality: 0.95,
+            }, "strategy-b");
+        }
+        const best = await selfImproving.selectBestStrategy();
+        expect(best).not.toBeNull();
+        expect(best?.strategy).toBe("strategy-b");
+    });
+    it("should record feedback and trigger optimization check", async () => {
+        const config = {
+            name: "strategy-a",
+            type: "corrective",
+            params: {},
+        };
+        selfImproving.registerStrategy(config, { minScore: 0.3 });
+        let optimizationTriggered = false;
+        selfImproving = new SelfImprovingRag({
+            minFeedbackForOptimization: 10,
+            onOptimization: () => {
+                optimizationTriggered = true;
+            },
+        }, storage);
+        selfImproving.registerStrategy(config, { minScore: 0.3 });
+        // Add 15 feedback with low relevance to trigger optimization
+        for (let i = 0; i < 15; i++) {
+            await selfImproving.recordFeedback(`query ${i}`, { text: `answer ${i}`, citations: [], steps: [], rewrites: 0 }, {
+                rating: 3,
+                relevance: 0.5,
+                completeness: 0.6,
+                citationsQuality: 0.7,
+            }, "strategy-a");
+        }
+        expect(optimizationTriggered).toBe(true);
+    });
+    it("should auto-apply suggestions when configured", async () => {
+        const config = {
+            name: "strategy-a",
+            type: "corrective",
+            params: {},
+        };
+        selfImproving = new SelfImprovingRag({
+            minFeedbackForOptimization: 10,
+            autoApplySuggestions: true,
+            minConfidenceForSuggestion: 0.7,
+        }, storage);
+        selfImproving.registerStrategy(config, { minScore: 0.3 });
+        // Add 15 feedback with low relevance
+        for (let i = 0; i < 15; i++) {
+            await selfImproving.recordFeedback(`query ${i}`, { text: `answer ${i}`, citations: [], steps: [], rewrites: 0 }, {
+                rating: 3,
+                relevance: 0.5,
+                completeness: 0.6,
+                citationsQuality: 0.7,
+            }, "strategy-a");
+        }
+        const params = selfImproving.getParams("strategy-a");
+        // Parameters should be updated if suggestions were applied
+        expect(params).toBeDefined();
+    });
+    it("should run A/B test", async () => {
+        const configA = {
+            name: "strategy-a",
+            type: "corrective",
+            params: {},
+        };
+        const configB = {
+            name: "strategy-b",
+            type: "hybrid",
+            params: {},
+        };
+        selfImproving.registerStrategy(configA, {});
+        selfImproving.registerStrategy(configB, {});
+        // Add sufficient samples
+        for (let i = 0; i < 20; i++) {
+            await selfImproving.recordFeedback(`query ${i}`, { text: `answer ${i}`, citations: [], steps: [], rewrites: 0 }, {
+                rating: 3,
+                relevance: 0.6,
+                completeness: 0.5,
+                citationsQuality: 0.7,
+            }, "strategy-a");
+            await selfImproving.recordFeedback(`query ${i}`, { text: `answer ${i}`, citations: [], steps: [], rewrites: 0 }, {
+                rating: 5,
+                relevance: 0.9,
+                completeness: 0.85,
+                citationsQuality: 0.95,
+            }, "strategy-b");
+        }
+        const result = await selfImproving.runABTest("strategy-a", "strategy-b");
+        expect(result).not.toBeNull();
+        expect(result.winner).toBe("B");
+    });
+    it("should update parameters manually", () => {
+        const config = {
+            name: "strategy-a",
+            type: "corrective",
+            params: {},
+        };
+        selfImproving.registerStrategy(config, { minScore: 0.5 });
+        selfImproving.updateParams("strategy-a", { minScore: 0.7, topK: 15 });
+        const params = selfImproving.getParams("strategy-a");
+        expect(params?.minScore).toBe(0.7);
+        expect(params?.topK).toBe(15);
+    });
+    it("should get metrics for strategy", async () => {
+        const config = {
+            name: "strategy-a",
+            type: "corrective",
+            params: {},
+        };
+        selfImproving.registerStrategy(config, {});
+        for (let i = 0; i < 5; i++) {
+            await selfImproving.recordFeedback(`query ${i}`, { text: `answer ${i}`, citations: [], steps: [], rewrites: 0 }, {
+                rating: 4,
+                relevance: 0.8,
+                completeness: 0.7,
+                citationsQuality: 0.9,
+            }, "strategy-a");
+        }
+        const metrics = await selfImproving.getMetrics("strategy-a");
+        expect(metrics).not.toBeNull();
+        expect(metrics?.totalQueries).toBe(5);
+    });
+    it("should generate report", async () => {
+        const config = {
+            name: "strategy-a",
+            type: "corrective",
+            params: {},
+        };
+        selfImproving.registerStrategy(config, { minScore: 0.5 });
+        for (let i = 0; i < 10; i++) {
+            await selfImproving.recordFeedback(`query ${i}`, { text: `answer ${i}`, citations: [], steps: [], rewrites: 0 }, {
+                rating: 4,
+                relevance: 0.7,
+                completeness: 0.6,
+                citationsQuality: 0.8,
+            }, "strategy-a");
+        }
+        const report = await selfImproving.generateReport("strategy-a");
+        expect(report).toContain("Report Ottimizzazione: strategy-a");
+        expect(report).toContain("Metriche Attuali");
+    });
+    it("should get suggestions", async () => {
+        const config = {
+            name: "strategy-a",
+            type: "corrective",
+            params: {},
+        };
+        selfImproving.registerStrategy(config, { minScore: 0.3 });
+        for (let i = 0; i < 15; i++) {
+            await selfImproving.recordFeedback(`query ${i}`, { text: `answer ${i}`, citations: [], steps: [], rewrites: 0 }, {
+                rating: 3,
+                relevance: 0.5,
+                completeness: 0.6,
+                citationsQuality: 0.7,
+            }, "strategy-a");
+        }
+        const suggestions = await selfImproving.getSuggestions("strategy-a");
+        expect(suggestions.length).toBeGreaterThan(0);
+    });
+    it("should reset feedback", async () => {
+        const config = {
+            name: "strategy-a",
+            type: "corrective",
+            params: {},
+        };
+        selfImproving.registerStrategy(config, {});
+        await selfImproving.recordFeedback("query", { text: "answer", citations: [], steps: [], rewrites: 0 }, {
+            rating: 4,
+            relevance: 0.8,
+            completeness: 0.7,
+            citationsQuality: 0.9,
+        }, "strategy-a");
+        await selfImproving.reset("strategy-a");
+        const metrics = await selfImproving.getMetrics("strategy-a");
+        expect(metrics).toBeNull();
+    });
+});
+//# sourceMappingURL=self-improving.test.js.map

package/dist/self-improving.test.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,117 @@
+import type { SearchHit } from "@eucode/indexer";
+export interface Retriever {
+    search(query: string, topK: number): Promise<SearchHit[]>;
+}
+export interface KeywordRetriever {
+    search(query: string, topK: number): Promise<SearchHit[]>;
+}
+export interface GraderResult {
+    relevant: boolean;
+    score: number;
+}
+export interface Grader {
+    grade(query: string, hit: SearchHit): Promise<GraderResult>;
+}
+export interface QueryRewriter {
+    rewrite(query: string, context: string): Promise<string>;
+}
+export interface CorrectiveRagOptions {
+    retriever: Retriever;
+    grader: Grader;
+    rewriter: QueryRewriter;
+    maxRewrites?: number;
+    minGoodHits?: number;
+    minScore?: number;
+    webFallback?: (query: string) => Promise<SearchHit[]>;
+}
+export interface RagCitation {
+    path: string;
+    startLine: number;
+    endLine: number;
+    text: string;
+}
+export interface RagAnswer {
+    text: string;
+    citations: RagCitation[];
+    steps: string[];
+    rewrites: number;
+}
+export interface HybridSearchOptions {
+    semanticRetriever: Retriever;
+    keywordRetriever: KeywordRetriever;
+    semanticWeight?: number;
+    keywordWeight?: number;
+    rrfK?: number;
+    topK?: number;
+}
+export interface HybridSearchResult {
+    hits: SearchHit[];
+    fusionMethod: "rrf" | "weighted";
+    semanticCount: number;
+    keywordCount: number;
+}
+export interface Entity {
+    id: string;
+    name: string;
+    type: string;
+    properties: Record<string, unknown>;
+}
+export interface Relation {
+    id: string;
+    source: string;
+    target: string;
+    type: string;
+    properties: Record<string, unknown>;
+}
+export interface KnowledgeGraph {
+    entities: Map<string, Entity>;
+    relations: Relation[];
+    addEntity(entity: Entity): void;
+    addRelation(relation: Relation): void;
+    getEntity(id: string): Entity | undefined;
+    getRelations(entityId: string): Relation[];
+    getConnectedEntities(entityId: string, depth?: number): Entity[];
+}
+export interface EntityExtractor {
+    extract(text: string): Promise<Entity[]>;
+}
+export interface RelationExtractor {
+    extract(text: string, entities: Entity[]): Promise<Relation[]>;
+}
+export interface KnowledgeGraphRagOptions {
+    retriever: Retriever;
+    entityExtractor: EntityExtractor;
+    relationExtractor: RelationExtractor;
+    graph: KnowledgeGraph;
+    topK?: number;
+    maxDepth?: number;
+}
+export interface KnowledgeGraphRagResult {
+    answer: string;
+    citations: RagCitation[];
+    entities: Entity[];
+    relations: Relation[];
+    graphContext: string;
+}
+export interface ReasoningStep {
+    thought: string;
+    action: string;
+    observation: string;
+}
+export interface AgenticRagOptions {
+    retriever: Retriever;
+    grader: Grader;
+    rewriter: QueryRewriter;
+    maxIterations?: number;
+    enableSelfReflection?: boolean;
+    enableChainOfThought?: boolean;
+}
+export interface AgenticRagResult {
+    answer: string;
+    citations: RagCitation[];
+    reasoningSteps: ReasoningStep[];
+    selfReflection?: string;
+    iterations: number;
+    confidence: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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