@eucoder/rag 0.2.0

package/dist/ab-testing.test.js

@@ -0,0 +1,147 @@
+import { describe, it, expect, beforeEach } from "vitest";
+import { ABTestFramework } from "./ab-testing.js";
+import { InMemoryFeedbackStorage } from "./feedback.js";
+describe("ABTestFramework", () => {
+    let framework;
+    let storage;
+    beforeEach(() => {
+        storage = new InMemoryFeedbackStorage();
+        framework = new ABTestFramework(storage);
+    });
+    it("should register strategies", () => {
+        const config = {
+            name: "strategy-a",
+            type: "corrective",
+            params: { minGoodHits: 2 },
+        };
+        framework.registerStrategy(config);
+        // Strategy registered successfully
+        expect(true).toBe(true);
+    });
+    it("should select strategy randomly", () => {
+        const configA = {
+            name: "strategy-a",
+            type: "corrective",
+            params: {},
+        };
+        const configB = {
+            name: "strategy-b",
+            type: "hybrid",
+            params: {},
+        };
+        framework.registerStrategy(configA);
+        framework.registerStrategy(configB);
+        const selected = framework.selectStrategy();
+        expect(["strategy-a", "strategy-b"]).toContain(selected.name);
+    });
+    it("should throw error when no strategies registered", () => {
+        expect(() => framework.selectStrategy()).toThrow("No strategies registered");
+    });
+    it("should record feedback", async () => {
+        const config = {
+            name: "strategy-a",
+            type: "corrective",
+            params: {},
+        };
+        framework.registerStrategy(config);
+        await framework.recordFeedback("test query", { text: "test answer", citations: [], steps: [], rewrites: 0 }, 4, 0.8, 0.7, 0.9, "strategy-a");
+        const feedback = await storage.getFeedback("strategy-a");
+        expect(feedback).toHaveLength(1);
+        expect(feedback[0]?.rating).toBe(4);
+    });
+    it("should run A/B test with sufficient samples", async () => {
+        const configA = {
+            name: "strategy-a",
+            type: "corrective",
+            params: {},
+        };
+        const configB = {
+            name: "strategy-b",
+            type: "hybrid",
+            params: {},
+        };
+        framework.registerStrategy(configA);
+        framework.registerStrategy(configB);
+        // Add 30 samples for strategy A (lower quality)
+        for (let i = 0; i < 30; i++) {
+            await framework.recordFeedback(`query ${i}`, { text: `answer ${i}`, citations: [], steps: [], rewrites: 0 }, 3, 0.6, 0.5, 0.7, "strategy-a");
+        }
+        // Add 30 samples for strategy B (higher quality)
+        for (let i = 0; i < 30; i++) {
+            await framework.recordFeedback(`query ${i}`, { text: `answer ${i}`, citations: [], steps: [], rewrites: 0 }, 5, 0.9, 0.85, 0.95, "strategy-b");
+        }
+        const result = await framework.runABTest("strategy-a", "strategy-b", 20);
+        expect(result.strategyA).toBe("strategy-a");
+        expect(result.strategyB).toBe("strategy-b");
+        expect(result.winner).toBe("B");
+        expect(result.improvement).toBeGreaterThan(0);
+        expect(result.statisticalSignificance).toBeGreaterThan(0);
+        expect(result.recommendation).toContain("B");
+    });
+    it("should throw error with insufficient samples", async () => {
+        const configA = {
+            name: "strategy-a",
+            type: "corrective",
+            params: {},
+        };
+        const configB = {
+            name: "strategy-b",
+            type: "hybrid",
+            params: {},
+        };
+        framework.registerStrategy(configA);
+        framework.registerStrategy(configB);
+        // Add only 10 samples (not enough)
+        for (let i = 0; i < 10; i++) {
+            await framework.recordFeedback(`query ${i}`, { text: `answer ${i}`, citations: [], steps: [], rewrites: 0 }, 4, 0.8, 0.7, 0.9, "strategy-a");
+        }
+        await expect(framework.runABTest("strategy-a", "strategy-b", 20))
+            .rejects.toThrow("Insufficient samples");
+    });
+    it("should get strategy metrics", async () => {
+        const config = {
+            name: "strategy-a",
+            type: "corrective",
+            params: {},
+        };
+        framework.registerStrategy(config);
+        for (let i = 0; i < 5; i++) {
+            await framework.recordFeedback(`query ${i}`, { text: `answer ${i}`, citations: [], steps: [], rewrites: 0 }, 4, 0.8, 0.7, 0.9, "strategy-a");
+        }
+        const metrics = await framework.getStrategyMetrics("strategy-a");
+        expect(metrics).not.toBeNull();
+        expect(metrics?.totalQueries).toBe(5);
+        expect(metrics?.averageRating).toBe(4);
+    });
+    it("should return null for non-existent strategy metrics", async () => {
+        const metrics = await framework.getStrategyMetrics("non-existent");
+        expect(metrics).toBeNull();
+    });
+    it("should get all metrics sorted by score", async () => {
+        const configA = {
+            name: "strategy-a",
+            type: "corrective",
+            params: {},
+        };
+        const configB = {
+            name: "strategy-b",
+            type: "hybrid",
+            params: {},
+        };
+        framework.registerStrategy(configA);
+        framework.registerStrategy(configB);
+        // Strategy A: lower quality
+        for (let i = 0; i < 5; i++) {
+            await framework.recordFeedback(`query ${i}`, { text: `answer ${i}`, citations: [], steps: [], rewrites: 0 }, 3, 0.6, 0.5, 0.7, "strategy-a");
+        }
+        // Strategy B: higher quality
+        for (let i = 0; i < 5; i++) {
+            await framework.recordFeedback(`query ${i}`, { text: `answer ${i}`, citations: [], steps: [], rewrites: 0 }, 5, 0.9, 0.85, 0.95, "strategy-b");
+        }
+        const allMetrics = await framework.getAllMetrics();
+        expect(allMetrics).toHaveLength(2);
+        expect(allMetrics[0]?.strategy).toBe("strategy-b");
+        expect(allMetrics[0]?.overallScore).toBeGreaterThan(allMetrics[1]?.overallScore || 0);
+    });
+});
+//# sourceMappingURL=ab-testing.test.js.map

package/dist/ab-testing.test.js.map

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

package/dist/agentic-rag.d.ts

@@ -0,0 +1,23 @@
+import type { AgenticRagOptions, AgenticRagResult } from "./types.js";
+/**
+ * Agentic RAG con Reasoning e Self-Reflection
+ *
+ * Implementa un ciclo di ragionamento:
+ * 1. Thought: Analizza la query e pianifica l'approccio
+ * 2. Action: Esegue retrieval e grading
+ * 3. Observation: Valuta i risultati
+ * 4. Self-Reflection: Valuta la qualità della risposta
+ * 5. Itera se necessario
+ */
+export declare class AgenticRag {
+    private options;
+    constructor(options: AgenticRagOptions);
+    search(query: string): Promise<AgenticRagResult>;
+    private generateThought;
+    private gradeHits;
+    private generateObservation;
+    private selfReflect;
+    private buildAnswer;
+    private finalReflection;
+}
+//# sourceMappingURL=agentic-rag.d.ts.map

package/dist/agentic-rag.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentic-rag.d.ts","sourceRoot":"","sources":["../src/agentic-rag.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,iBAAiB,EACjB,gBAAgB,EAGjB,MAAM,YAAY,CAAC;AAEpB;;;;;;;;;GASG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,OAAO,CAA8B;gBAEjC,OAAO,EAAE,iBAAiB;IAShC,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAiFtD,OAAO,CAAC,eAAe;YAQT,SAAS;IAavB,OAAO,CAAC,mBAAmB;IAO3B,OAAO,CAAC,WAAW;IAmBnB,OAAO,CAAC,WAAW;IAoCnB,OAAO,CAAC,eAAe;CAyBxB"}

package/dist/agentic-rag.js

@@ -0,0 +1,170 @@
+/**
+ * Agentic RAG con Reasoning e Self-Reflection
+ *
+ * Implementa un ciclo di ragionamento:
+ * 1. Thought: Analizza la query e pianifica l'approccio
+ * 2. Action: Esegue retrieval e grading
+ * 3. Observation: Valuta i risultati
+ * 4. Self-Reflection: Valuta la qualità della risposta
+ * 5. Itera se necessario
+ */
+export class AgenticRag {
+    options;
+    constructor(options) {
+        this.options = {
+            maxIterations: options.maxIterations ?? 3,
+            enableSelfReflection: options.enableSelfReflection ?? true,
+            enableChainOfThought: options.enableChainOfThought ?? true,
+            ...options,
+        };
+    }
+    async search(query) {
+        const reasoningSteps = [];
+        let currentQuery = query;
+        let bestHits = [];
+        let bestScore = 0;
+        let iterations = 0;
+        // Ciclo di ragionamento
+        for (let i = 0; i < this.options.maxIterations; i++) {
+            iterations++;
+            // Step 1: Thought
+            const thought = this.generateThought(currentQuery, i);
+            // Step 2: Action - Retrieval
+            const hits = await this.options.retriever.search(currentQuery, 10);
+            // Step 3: Action - Grading
+            const gradedHits = await this.gradeHits(currentQuery, hits);
+            const avgScore = gradedHits.length > 0
+                ? gradedHits.reduce((sum, h) => sum + h.score, 0) / gradedHits.length
+                : 0;
+            // Step 4: Observation
+            const observation = this.generateObservation(gradedHits, avgScore);
+            reasoningSteps.push({
+                thought,
+                action: `Retrieved ${hits.length} hits, graded ${gradedHits.length} as relevant`,
+                observation,
+            });
+            // Aggiorna best hits se migliori
+            if (avgScore > bestScore) {
+                bestScore = avgScore;
+                bestHits = gradedHits;
+            }
+            // Step 5: Self-Reflection (se abilitato)
+            if (this.options.enableSelfReflection && i < this.options.maxIterations - 1) {
+                const reflection = this.selfReflect(currentQuery, gradedHits, avgScore);
+                if (reflection.shouldRewrite) {
+                    // Riscrivi la query
+                    currentQuery = await this.options.rewriter.rewrite(currentQuery, gradedHits.map((h) => h.text).join("\n"));
+                    continue;
+                }
+                else if (reflection.isSatisfied) {
+                    break; // Risultati soddisfacenti
+                }
+            }
+            else if (avgScore > 0.7) {
+                break; // Score足够高, termina
+            }
+        }
+        // Genera risposta finale
+        const answer = this.buildAnswer(query, bestHits, reasoningSteps);
+        const citations = bestHits.map((hit) => ({
+            path: hit.path,
+            startLine: hit.startLine,
+            endLine: hit.endLine,
+            text: hit.text,
+        }));
+        // Self-reflection finale
+        const selfReflection = this.options.enableSelfReflection
+            ? this.finalReflection(query, bestHits, bestScore, iterations)
+            : undefined;
+        return {
+            answer,
+            citations,
+            reasoningSteps,
+            selfReflection,
+            iterations,
+            confidence: bestScore,
+        };
+    }
+    generateThought(query, iteration) {
+        if (iteration === 0) {
+            return `Analizzo la query: "${query}". Cerco documenti rilevanti e valuto la loro pertinenza.`;
+        }
+        else {
+            return `Iterazione ${iteration + 1}. I risultati precedenti non erano sufficientemente pertinenti. Riscrivo la query per migliorare i risultati.`;
+        }
+    }
+    async gradeHits(query, hits) {
+        const graded = await Promise.all(hits.map(async (hit) => {
+            const result = await this.options.grader.grade(query, hit);
+            return { ...hit, score: result.score };
+        }));
+        return graded
+            .filter((h) => h.score > 0.3)
+            .sort((a, b) => b.score - a.score);
+    }
+    generateObservation(hits, avgScore) {
+        if (hits.length === 0) {
+            return "Nessun documento rilevante trovato. Score medio: 0";
+        }
+        return `Trovati ${hits.length} documenti rilevanti. Score medio: ${avgScore.toFixed(2)}. Miglior documento: ${hits[0]?.path ?? "N/A"}`;
+    }
+    selfReflect(_query, hits, avgScore) {
+        // Se score è alto, siamo soddisfatti
+        if (avgScore > 0.7 && hits.length >= 3) {
+            return { shouldRewrite: false, isSatisfied: true };
+        }
+        // Se score è molto basso, riscrivi
+        if (avgScore < 0.4 || hits.length < 2) {
+            return { shouldRewrite: true, isSatisfied: false };
+        }
+        // Score medio, continua ma non riscrivere
+        return { shouldRewrite: false, isSatisfied: false };
+    }
+    buildAnswer(_query, hits, reasoningSteps) {
+        const parts = [];
+        // Chain of Thought (se abilitato)
+        if (this.options.enableChainOfThought && reasoningSteps.length > 0) {
+            parts.push(`## Processo di Ragionamento\n`);
+            reasoningSteps.forEach((step, i) => {
+                parts.push(`### Step ${i + 1}`);
+                parts.push(`**Thought:** ${step.thought}`);
+                parts.push(`**Action:** ${step.action}`);
+                parts.push(`**Observation:** ${step.observation}\n`);
+            });
+        }
+        // Risposta finale
+        parts.push(`## Risposta\n`);
+        if (hits.length === 0) {
+            parts.push(`Non sono stati trovati documenti rilevanti per la query fornita.`);
+        }
+        else {
+            parts.push(`Basato su ${hits.length} documenti pertinenti:\n`);
+            hits.slice(0, 5).forEach((hit, i) => {
+                parts.push(`### Fonte ${i + 1}: ${hit.path}`);
+                parts.push(`Righe ${hit.startLine}-${hit.endLine} (score: ${hit.score.toFixed(2)})\n`);
+                parts.push(`\`\`\`\n${hit.text}\n\`\`\`\n`);
+            });
+        }
+        return parts.join("\n");
+    }
+    finalReflection(query, hits, avgScore, iterations) {
+        const parts = [];
+        parts.push(`**Valutazione Finale:**`);
+        parts.push(`- Query: "${query}"`);
+        parts.push(`- Iterazioni: ${iterations}`);
+        parts.push(`- Documenti trovati: ${hits.length}`);
+        parts.push(`- Score medio: ${avgScore.toFixed(2)}`);
+        parts.push(`- Confidenza: ${avgScore > 0.7 ? "Alta" : avgScore > 0.4 ? "Media" : "Bassa"}`);
+        if (avgScore > 0.7) {
+            parts.push(`\n✅ I risultati sono altamente pertinenti alla query.`);
+        }
+        else if (avgScore > 0.4) {
+            parts.push(`\n⚠️ I risultati sono parzialmente pertinenti. Potrebbe essere necessario raffinare la query.`);
+        }
+        else {
+            parts.push(`\n❌ I risultati non sono sufficientemente pertinenti. Considera di riformulare la query.`);
+        }
+        return parts.join("\n");
+    }
+}
+//# sourceMappingURL=agentic-rag.js.map

package/dist/agentic-rag.js.map

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

package/dist/agentic-rag.test.d.ts

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

package/dist/agentic-rag.test.d.ts.map

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

package/dist/agentic-rag.test.js

@@ -0,0 +1,174 @@
+import { describe, it, expect } from "vitest";
+import { AgenticRag } from "./agentic-rag.js";
+class MockRetriever {
+    callCount = 0;
+    async search(_query, topK) {
+        this.callCount++;
+        // First call returns poor results, second call returns good results
+        if (this.callCount === 1) {
+            return [
+                {
+                    id: "hit-1",
+                    path: "src/unrelated.ts",
+                    startLine: 1,
+                    endLine: 10,
+                    text: "Unrelated content",
+                    score: 0.3,
+                },
+            ].slice(0, topK);
+        }
+        return [
+            {
+                id: "hit-2",
+                path: "src/auth.ts",
+                startLine: 10,
+                endLine: 20,
+                text: "Authentication implementation",
+                score: 0.9,
+            },
+            {
+                id: "hit-3",
+                path: "src/login.ts",
+                startLine: 5,
+                endLine: 15,
+                text: "Login logic",
+                score: 0.85,
+            },
+        ].slice(0, topK);
+    }
+}
+class MockGrader {
+    async grade(_query, hit) {
+        return {
+            relevant: hit.score > 0.5,
+            score: hit.score,
+        };
+    }
+}
+class MockRewriter {
+    async rewrite(query, _context) {
+        return `${query} (improved)`;
+    }
+}
+describe("AgenticRag", () => {
+    it("should perform iterative search with reasoning", async () => {
+        const agentic = new AgenticRag({
+            retriever: new MockRetriever(),
+            grader: new MockGrader(),
+            rewriter: new MockRewriter(),
+            maxIterations: 3,
+            enableSelfReflection: true,
+            enableChainOfThought: true,
+        });
+        const result = await agentic.search("authentication");
+        expect(result.iterations).toBeGreaterThan(0);
+        expect(result.reasoningSteps.length).toBeGreaterThan(0);
+        expect(result.answer).toContain("Processo di Ragionamento");
+        expect(result.citations.length).toBeGreaterThan(0);
+    });
+    it("should stop early when results are good enough", async () => {
+        const goodRetriever = {
+            async search(_query, topK) {
+                return [
+                    {
+                        id: "hit-1",
+                        path: "src/auth.ts",
+                        startLine: 10,
+                        endLine: 20,
+                        text: "Authentication implementation",
+                        score: 0.9,
+                    },
+                    {
+                        id: "hit-2",
+                        path: "src/login.ts",
+                        startLine: 5,
+                        endLine: 15,
+                        text: "Login logic",
+                        score: 0.85,
+                    },
+                    {
+                        id: "hit-3",
+                        path: "src/session.ts",
+                        startLine: 1,
+                        endLine: 10,
+                        text: "Session management",
+                        score: 0.8,
+                    },
+                ].slice(0, topK);
+            },
+        };
+        const agentic = new AgenticRag({
+            retriever: goodRetriever,
+            grader: new MockGrader(),
+            rewriter: new MockRewriter(),
+            maxIterations: 5,
+            enableSelfReflection: true,
+        });
+        const result = await agentic.search("authentication");
+        // Should stop after 1 iteration because results are good
+        expect(result.iterations).toBe(1);
+        expect(result.confidence).toBeGreaterThan(0.7);
+    });
+    it("should rewrite query when results are poor", async () => {
+        const poorRetriever = {
+            async search(_query, topK) {
+                return [
+                    {
+                        id: "hit-1",
+                        path: "src/unrelated.ts",
+                        startLine: 1,
+                        endLine: 10,
+                        text: "Unrelated content",
+                        score: 0.2,
+                    },
+                ].slice(0, topK);
+            },
+        };
+        const agentic = new AgenticRag({
+            retriever: poorRetriever,
+            grader: new MockGrader(),
+            rewriter: new MockRewriter(),
+            maxIterations: 3,
+            enableSelfReflection: true,
+        });
+        const result = await agentic.search("authentication");
+        // Should iterate multiple times trying to improve
+        expect(result.iterations).toBeGreaterThan(1);
+        expect(result.confidence).toBeLessThan(0.5);
+    });
+    it("should include self-reflection when enabled", async () => {
+        const agentic = new AgenticRag({
+            retriever: new MockRetriever(),
+            grader: new MockGrader(),
+            rewriter: new MockRewriter(),
+            maxIterations: 2,
+            enableSelfReflection: true,
+        });
+        const result = await agentic.search("authentication");
+        expect(result.selfReflection).toBeDefined();
+        expect(result.selfReflection).toContain("Valutazione Finale");
+    });
+    it("should skip self-reflection when disabled", async () => {
+        const agentic = new AgenticRag({
+            retriever: new MockRetriever(),
+            grader: new MockGrader(),
+            rewriter: new MockRewriter(),
+            maxIterations: 2,
+            enableSelfReflection: false,
+        });
+        const result = await agentic.search("authentication");
+        expect(result.selfReflection).toBeUndefined();
+    });
+    it("should skip chain of thought when disabled", async () => {
+        const agentic = new AgenticRag({
+            retriever: new MockRetriever(),
+            grader: new MockGrader(),
+            rewriter: new MockRewriter(),
+            maxIterations: 2,
+            enableChainOfThought: false,
+        });
+        const result = await agentic.search("authentication");
+        expect(result.answer).not.toContain("Processo di Ragionamento");
+    });
+});
+//# sourceMappingURL=agentic-rag.test.js.map

package/dist/agentic-rag.test.js.map

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

package/dist/corrective-rag.d.ts

@@ -0,0 +1,16 @@
+import type { CorrectiveRagOptions, RagAnswer } from "./types.js";
+export declare class CorrectiveRag {
+    private retriever;
+    private grader;
+    private rewriter;
+    private maxRewrites;
+    private minGoodHits;
+    private minScore;
+    private webFallback?;
+    constructor(options: CorrectiveRagOptions);
+    answer(query: string): Promise<RagAnswer>;
+    private gradeHits;
+    private formatAnswer;
+}
+export declare function createCorrectiveRag(options: CorrectiveRagOptions): CorrectiveRag;
+//# sourceMappingURL=corrective-rag.d.ts.map

package/dist/corrective-rag.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"corrective-rag.d.ts","sourceRoot":"","sources":["../src/corrective-rag.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,oBAAoB,EACpB,SAAS,EAKV,MAAM,YAAY,CAAC;AAOpB,qBAAa,aAAa;IACxB,OAAO,CAAC,SAAS,CAAY;IAC7B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,QAAQ,CAAgB;IAChC,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,WAAW,CAAC,CAAoC;gBAE5C,OAAO,EAAE,oBAAoB;IAUnC,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;YAoDjC,SAAS;IAavB,OAAO,CAAC,YAAY;CAYrB;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,oBAAoB,GAAG,aAAa,CAEhF"}