@cosmocoder/mcp-web-docs 1.0.0

package/build/rag/reranker.d.ts

@@ -0,0 +1,55 @@
+import { SearchResult } from "../types.js";
+/**
+ * Reranker interface for document search improvement
+ * Responsible for reranking search results to improve relevance
+ */
+export interface Reranker {
+    /**
+     * Rerank chunks based on relevance to the query
+     * @param query - The user query
+     * @param chunks - The chunks to rerank
+     * @param options - Optional reranking settings
+     * @returns An array of relevance scores corresponding to each chunk
+     */
+    rerank(query: string, chunks: SearchResult[], options?: RerankerOptions): Promise<number[]>;
+}
+/**
+ * Options for configuring reranker behavior
+ */
+export interface RerankerOptions {
+    componentNames?: string[];
+    propNames?: string[];
+    componentBoost?: number;
+    propBoost?: number;
+    codeBoost?: number;
+    semanticWeight?: number;
+    exactMatchWeight?: number;
+}
+/**
+ * Enhanced simple reranker implementation with smarter heuristics
+ * Uses multiple relevance signals and weighted scoring
+ */
+export declare class EnhancedSimpleReranker implements Reranker {
+    readonly _apiKey: string;
+    constructor(_apiKey: string);
+    rerank(query: string, chunks: SearchResult[], options?: RerankerOptions): Promise<number[]>;
+    private extractPhrases;
+}
+/**
+ * Improved OpenAI-based reranker that uses embeddings similarity and additional relevance signals
+ */
+export declare class OpenAIReranker implements Reranker {
+    private openaiApiKey;
+    constructor(openaiApiKey: string);
+    rerank(query: string, chunks: SearchResult[], options?: RerankerOptions): Promise<number[]>;
+    private cosineSimilarity;
+}
+/**
+ * Factory for creating rerankers based on configuration
+ */
+export declare class RerankerFactory {
+    /**
+     * Create a reranker instance based on the specified model
+     */
+    static create(model: string | undefined, apiKey: string): Reranker;
+}

package/build/rag/reranker.js

@@ -0,0 +1,210 @@
+/**
+ * Enhanced simple reranker implementation with smarter heuristics
+ * Uses multiple relevance signals and weighted scoring
+ */
+export class EnhancedSimpleReranker {
+    _apiKey;
+    constructor(_apiKey) {
+        this._apiKey = _apiKey;
+        // Store API key but not used directly in this reranker
+        void this._apiKey; // No-op to avoid unused variable warning
+    }
+    async rerank(query, chunks, options = {}) {
+        console.debug(`[EnhancedSimpleReranker] Reranking ${chunks.length} chunks`);
+        // If we have fewer than 2 chunks, just return score 1 for all
+        if (!chunks || chunks.length <= 1) {
+            return chunks.map(() => 1);
+        }
+        try {
+            const scores = [];
+            const { componentNames = [], propNames = [], componentBoost = 0.2, propBoost = 0.15, codeBoost = 0.1, semanticWeight = 0.6, exactMatchWeight = 0.4 } = options;
+            // Normalize query for matching
+            const queryLower = query.toLowerCase();
+            const queryWords = new Set(queryLower.split(/\s+/).filter(w => w.length > 3));
+            // Check if query is code-related
+            const isCodeQuery = /\bcode\b|\bexample\b|\bsnippet\b|\bhow to\b|\bimplement\b/i.test(query);
+            for (const chunk of chunks) {
+                const contentLower = chunk.content.toLowerCase();
+                const contentWords = new Set(contentLower.split(/\s+/).filter(w => w.length > 3));
+                // --- Calculate base text relevance with Jaccard similarity ---
+                const intersection = new Set([...queryWords].filter(x => contentWords.has(x)));
+                const union = new Set([...queryWords, ...contentWords]);
+                let textRelevance = intersection.size / Math.max(union.size, 1);
+                // --- Calculate exact phrase matches ---
+                // Split query into 2-3 word phrases and check if they appear in content
+                const phrases = this.extractPhrases(queryLower);
+                let phraseMatches = 0;
+                for (const phrase of phrases) {
+                    if (contentLower.includes(phrase)) {
+                        phraseMatches++;
+                    }
+                }
+                const phraseScore = phrases.length > 0 ? phraseMatches / phrases.length : 0;
+                // --- Apply component name boosting ---
+                let componentScore = 0;
+                if (componentNames.length > 0) {
+                    // Check for component name matches (case sensitive as component names are usually PascalCase)
+                    for (const componentName of componentNames) {
+                        const regex = new RegExp(`\\b${componentName}\\b`, 'g');
+                        const matches = (chunk.content.match(regex) || []).length;
+                        if (matches > 0) {
+                            componentScore += (matches * componentBoost);
+                        }
+                    }
+                }
+                else {
+                    // If no specific component names, check for any PascalCase words (potential components)
+                    const pascalCaseRegex = /\b[A-Z][a-z]+[A-Z]\w*\b/g;
+                    const componentMatches = chunk.content.match(pascalCaseRegex) || [];
+                    if (componentMatches.length > 0) {
+                        componentScore = componentBoost; // Fixed boost for having any component names
+                    }
+                }
+                // --- Apply prop name boosting ---
+                let propScore = 0;
+                if (propNames.length > 0) {
+                    for (const propName of propNames) {
+                        const regex = new RegExp(`\\b${propName}\\b`, 'gi');
+                        const matches = (chunk.content.match(regex) || []).length;
+                        if (matches > 0) {
+                            propScore += (matches * propBoost);
+                        }
+                    }
+                }
+                // --- Code example boosting ---
+                let codeScore = 0;
+                if (isCodeQuery && chunk.metadata.codeBlocks && chunk.metadata.codeBlocks.length > 0) {
+                    codeScore = codeBoost * Math.min(chunk.metadata.codeBlocks.length, 3); // Cap boost for 3+ code blocks
+                }
+                // --- Metadata type relevance ---
+                let metadataScore = 0;
+                if (chunk.metadata.type === 'api' && /\bapi\b|\bprops\b|\bparameters\b|\boptions\b/i.test(query)) {
+                    metadataScore = 0.15; // Boost API docs for API-related queries
+                }
+                else if (chunk.metadata.type === 'example' && isCodeQuery) {
+                    metadataScore = 0.15; // Boost examples for code-related queries
+                }
+                // --- Combine all relevance signals with weights ---
+                // Base score is a weighted combination of text relevance and phrase matching
+                const baseScore = (textRelevance * exactMatchWeight) + (phraseScore * (1 - exactMatchWeight));
+                // Apply boosts additively to avoid score explosion
+                let finalScore = (baseScore * semanticWeight) +
+                    componentScore +
+                    propScore +
+                    codeScore +
+                    metadataScore;
+                // Ensure score is in 0-1 range, with diminishing returns for extreme boosts
+                finalScore = Math.min(1, finalScore);
+                scores.push(finalScore);
+                // Debug logging for first few chunks to help with debugging
+                if (scores.length <= 3) {
+                    console.debug(`[EnhancedSimpleReranker] Chunk ${scores.length} score:`, {
+                        finalScore,
+                        baseScore,
+                        textRelevance,
+                        phraseScore,
+                        componentScore,
+                        propScore,
+                        codeScore,
+                        metadataScore
+                    });
+                }
+            }
+            return scores;
+        }
+        catch (error) {
+            console.error('[EnhancedSimpleReranker] Error in reranking:', error);
+            // Return neutral scores if reranking fails
+            return chunks.map(() => 0.5);
+        }
+    }
+    // Extract meaningful 2-3 word phrases from query
+    extractPhrases(text) {
+        const words = text.split(/\s+/).filter(w => w.length > 2);
+        const phrases = [];
+        // Extract 3-word phrases
+        for (let i = 0; i < words.length - 2; i++) {
+            phrases.push(`${words[i]} ${words[i + 1]} ${words[i + 2]}`);
+        }
+        // Extract 2-word phrases
+        for (let i = 0; i < words.length - 1; i++) {
+            phrases.push(`${words[i]} ${words[i + 1]}`);
+        }
+        return phrases;
+    }
+}
+/**
+ * Improved OpenAI-based reranker that uses embeddings similarity and additional relevance signals
+ */
+export class OpenAIReranker {
+    openaiApiKey;
+    constructor(openaiApiKey) {
+        this.openaiApiKey = openaiApiKey;
+    }
+    async rerank(query, chunks, options = {}) {
+        console.debug(`[OpenAIReranker] Reranking ${chunks.length} chunks`);
+        // If we have fewer than 2 chunks, just return score 1 for all
+        if (!chunks || chunks.length <= 1) {
+            return chunks.map(() => 1);
+        }
+        try {
+            // Import OpenAI in the method to avoid loading it unnecessarily
+            const { default: OpenAI } = await import('openai');
+            const openai = new OpenAI({ apiKey: this.openaiApiKey });
+            // Get embeddings for the query
+            const queryEmbedding = await openai.embeddings.create({
+                model: 'text-embedding-ada-002',
+                input: query,
+            });
+            // Get embeddings for all chunks in a single batch request
+            const chunkEmbeddings = await openai.embeddings.create({
+                model: 'text-embedding-ada-002',
+                input: chunks.map(chunk => chunk.content.substring(0, 8000)),
+            });
+            // Calculate cosine similarity between query and each chunk
+            const semanticScores = chunkEmbeddings.data.map((chunkEmbed) => {
+                return this.cosineSimilarity(queryEmbedding.data[0].embedding, chunkEmbed.embedding);
+            });
+            // For enhanced scoring, also incorporate the simple reranker's heuristics
+            const simpleReranker = new EnhancedSimpleReranker(this.openaiApiKey);
+            const heuristicScores = await simpleReranker.rerank(query, chunks, options);
+            // Combine semantic and heuristic scores (weighted average)
+            const combinedScores = semanticScores.map((semanticScore, i) => {
+                const heuristicScore = heuristicScores[i];
+                // Weight semantic score more heavily (70/30 split)
+                return (semanticScore * 0.7) + (heuristicScore * 0.3);
+            });
+            return combinedScores;
+        }
+        catch (error) {
+            console.error('[OpenAIReranker] Error in OpenAI reranking:', error);
+            // Fallback to the simpler reranker if OpenAI fails
+            const simpleReranker = new EnhancedSimpleReranker(this.openaiApiKey);
+            return simpleReranker.rerank(query, chunks, options);
+        }
+    }
+    // Calculate cosine similarity between two vectors
+    cosineSimilarity(vecA, vecB) {
+        const dotProduct = vecA.reduce((sum, a, i) => sum + a * vecB[i], 0);
+        const magA = Math.sqrt(vecA.reduce((sum, a) => sum + a * a, 0));
+        const magB = Math.sqrt(vecB.reduce((sum, b) => sum + b * b, 0));
+        return dotProduct / (magA * magB);
+    }
+}
+/**
+ * Factory for creating rerankers based on configuration
+ */
+export class RerankerFactory {
+    /**
+     * Create a reranker instance based on the specified model
+     */
+    static create(model = 'openai', apiKey) {
+        if (model === 'openai') {
+            return new OpenAIReranker(apiKey);
+        }
+        else {
+            return new EnhancedSimpleReranker(apiKey);
+        }
+    }
+}
+//# sourceMappingURL=reranker.js.map

package/build/rag/reranker.js.map

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

package/build/rag/response-generator.d.ts

@@ -0,0 +1,20 @@
+import { AssembledContext } from "./context-assembler.js";
+import { QueryIntent } from "./query-processor.js";
+export interface GeneratedResponse {
+    text: string;
+    codeExamples?: string[];
+    metadata: {
+        sources: string[];
+        confidence: number;
+        generatedAt: Date;
+    };
+}
+export declare class ResponseGenerator {
+    private openai;
+    constructor(apiKey: string);
+    generateResponse(context: AssembledContext, queryIntent: QueryIntent): Promise<GeneratedResponse>;
+    private prepareContext;
+    private getSystemPrompt;
+    private isRelevantForIntent;
+    private getSources;
+}

package/build/rag/response-generator.js

@@ -0,0 +1,101 @@
+import OpenAI from "openai";
+export class ResponseGenerator {
+    openai;
+    constructor(apiKey) {
+        this.openai = new OpenAI({ apiKey });
+    }
+    async generateResponse(context, queryIntent) {
+        // Prepare context for the response
+        const contextSummary = this.prepareContext(context, queryIntent);
+        // Generate response using OpenAI
+        const completion = await this.openai.chat.completions.create({
+            model: "gpt-3.5-turbo",
+            messages: [
+                {
+                    role: "system",
+                    content: `${this.getSystemPrompt(queryIntent.intent)}
+
+          Return your response in JSON format:
+          {
+            "response": "your detailed response text",
+            "codeExamples": ["array of relevant code examples"],
+            "metadata": {
+              "relevance": "number between 0 and 1 indicating response relevance",
+              "sources": ["array of source identifiers used"]
+            }
+          }`
+                },
+                {
+                    role: "user",
+                    content: `Context:\n${contextSummary}\n\nQuery Intent: ${queryIntent.intent}\nEntities: ${queryIntent.entities.join(", ")}\n\nGenerate a comprehensive response.`
+                }
+            ],
+            temperature: 0.7,
+            max_tokens: 1000
+        });
+        const content = completion.choices[0].message.content;
+        if (!content) {
+            throw new Error("No content returned from OpenAI");
+        }
+        const result = JSON.parse(content);
+        return {
+            text: result.response,
+            codeExamples: result.codeExamples || [],
+            metadata: {
+                sources: this.getSources(context),
+                confidence: result.metadata.relevance,
+                generatedAt: new Date()
+            }
+        };
+    }
+    prepareContext(context, queryIntent) {
+        const relevantChunks = context.hierarchicalContext
+            .filter(chunk => this.isRelevantForIntent(chunk.metadata.type, queryIntent.intent))
+            .map(chunk => ({
+            content: chunk.content,
+            type: chunk.metadata.type,
+            reliability: chunk.metadata.sourceReliability
+        }))
+            .sort((a, b) => b.reliability - a.reliability);
+        return relevantChunks
+            .map(chunk => `[${chunk.type}]\n${chunk.content}`)
+            .join('\n\n');
+    }
+    getSystemPrompt(intent) {
+        const basePrompt = "You are a technical documentation assistant. Generate clear, accurate responses based on the provided context.";
+        const intentPrompts = {
+            overview: `${basePrompt}\nProvide a comprehensive overview of the topic, covering key features and concepts.`,
+            api: `${basePrompt}\nProvide detailed API documentation, including parameters, return types, and examples.`,
+            example: `${basePrompt}\nCreate practical code examples that demonstrate proper usage and common patterns.`,
+            usage: `${basePrompt}\nFocus on explaining how to use components effectively, including props, configurations, and best practices.`,
+            component_usage: `${basePrompt}\nFocus on explaining how to use components effectively, including props, configurations, and best practices.`,
+            concept: `${basePrompt}\nExplain technical concepts clearly, using analogies and examples where appropriate.`,
+            troubleshooting: `${basePrompt}\nHelp diagnose and solve problems, providing step-by-step solutions and common pitfalls to avoid.`,
+            general: basePrompt
+        };
+        return intentPrompts[intent];
+    }
+    isRelevantForIntent(chunkType, intent) {
+        const relevanceMap = {
+            overview: ['overview', 'usage', 'api'],
+            api: ['api', 'overview', 'example'],
+            example: ['example', 'usage', 'api'],
+            usage: ['usage', 'overview', 'example'],
+            component_usage: ['usage', 'overview', 'example'],
+            concept: ['overview', 'api', 'example'],
+            troubleshooting: ['example', 'usage', 'api'],
+            general: ['overview', 'usage', 'example', 'api']
+        };
+        return relevanceMap[intent].includes(chunkType);
+    }
+    getSources(context) {
+        const sources = new Set();
+        for (const chunk of context.hierarchicalContext) {
+            if (chunk.metadata.citationInfo.version) {
+                sources.add(`${chunk.metadata.citationInfo.version}`);
+            }
+        }
+        return Array.from(sources);
+    }
+}
+//# sourceMappingURL=response-generator.js.map

package/build/rag/response-generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"response-generator.js","sourceRoot":"","sources":["../../src/rag/response-generator.ts"],"names":[],"mappings":"AAEA,OAAO,MAAM,MAAM,QAAQ,CAAC;AAY5B,MAAM,OAAO,iBAAiB;IACpB,MAAM,CAAS;IAEvB,YAAY,MAAc;QACxB,IAAI,CAAC,MAAM,GAAG,IAAI,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;IACvC,CAAC;IAED,KAAK,CAAC,gBAAgB,CAAC,OAAyB,EAAE,WAAwB;QACxE,mCAAmC;QACnC,MAAM,cAAc,GAAG,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;QAEjE,iCAAiC;QACjC,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC;YAC3D,KAAK,EAAE,eAAe;YACtB,QAAQ,EAAE;gBACR;oBACE,IAAI,EAAE,QAAQ;oBACd,OAAO,EAAE,GAAG,IAAI,CAAC,eAAe,CAAC,WAAW,CAAC,MAAM,CAAC;;;;;;;;;;YAUlD;iBACH;gBACD;oBACE,IAAI,EAAE,MAAM;oBACZ,OAAO,EAAE,aAAa,cAAc,qBAAqB,WAAW,CAAC,MAAM,eAAe,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,wCAAwC;iBAClK;aACF;YACD,WAAW,EAAE,GAAG;YAChB,UAAU,EAAE,IAAI;SACjB,CAAC,CAAC;QAEH,MAAM,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC;QACtD,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;QACrD,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACnC,OAAO;YACL,IAAI,EAAE,MAAM,CAAC,QAAQ;YACrB,YAAY,EAAE,MAAM,CAAC,YAAY,IAAI,EAAE;YACvC,QAAQ,EAAE;gBACR,OAAO,EAAE,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC;gBACjC,UAAU,EAAE,MAAM,CAAC,QAAQ,CAAC,SAAS;gBACrC,WAAW,EAAE,IAAI,IAAI,EAAE;aACxB;SACF,CAAC;IACJ,CAAC;IAEO,cAAc,CAAC,OAAyB,EAAE,WAAwB;QACxE,MAAM,cAAc,GAAG,OAAO,CAAC,mBAAmB;aAC/C,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,CAAC,mBAAmB,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;aAClF,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YACb,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,IAAI,EAAE,KAAK,CAAC,QAAQ,CAAC,IAAI;YACzB,WAAW,EAAE,KAAK,CAAC,QAAQ,CAAC,iBAAiB;SAC9C,CAAC,CAAC;aACF,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,GAAG,CAAC,CAAC,WAAW,CAAC,CAAC;QAEjD,OAAO,cAAc;aAClB,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,KAAK,CAAC,IAAI,MAAM,KAAK,CAAC,OAAO,EAAE,CAAC;aACjD,IAAI,CAAC,MAAM,CAAC,CAAC;IAClB,CAAC;IAEO,eAAe,CAAC,MAAuB;QAC7C,MAAM,UAAU,GAAG,gHAAgH,CAAC;QAEpI,MAAM,aAAa,GAAoC;YACrD,QAAQ,EAAE,GAAG,UAAU,sFAAsF;YAC7G,GAAG,EAAE,GAAG,UAAU,yFAAyF;YAC3G,OAAO,EAAE,GAAG,UAAU,qFAAqF;YAC3G,KAAK,EAAE,GAAG,UAAU,+GAA+G;YACnI,eAAe,EAAE,GAAG,UAAU,+GAA+G;YAC7I,OAAO,EAAE,GAAG,UAAU,uFAAuF;YAC7G,eAAe,EAAE,GAAG,UAAU,oGAAoG;YAClI,OAAO,EAAE,UAAU;SACpB,CAAC;QAEF,OAAO,aAAa,CAAC,MAAM,CAAC,CAAC;IAC/B,CAAC;IAEO,mBAAmB,CAAC,SAAiB,EAAE,MAAuB;QACpE,MAAM,YAAY,GAAsC;YACtD,QAAQ,EAAE,CAAC,UAAU,EAAE,OAAO,EAAE,KAAK,CAAC;YACtC,GAAG,EAAE,CAAC,KAAK,EAAE,UAAU,EAAE,SAAS,CAAC;YACnC,OAAO,EAAE,CAAC,SAAS,EAAE,OAAO,EAAE,KAAK,CAAC;YACpC,KAAK,EAAE,CAAC,OAAO,EAAE,UAAU,EAAE,SAAS,CAAC;YACvC,eAAe,EAAE,CAAC,OAAO,EAAE,UAAU,EAAE,SAAS,CAAC;YACjD,OAAO,EAAE,CAAC,UAAU,EAAE,KAAK,EAAE,SAAS,CAAC;YACvC,eAAe,EAAE,CAAC,SAAS,EAAE,OAAO,EAAE,KAAK,CAAC;YAC5C,OAAO,EAAE,CAAC,UAAU,EAAE,OAAO,EAAE,SAAS,EAAE,KAAK,CAAC;SACjD,CAAC;QAEF,OAAO,YAAY,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;IAClD,CAAC;IAEO,UAAU,CAAC,OAAyB;QAC1C,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;QAClC,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,mBAAmB,EAAE,CAAC;YAChD,IAAI,KAAK,CAAC,QAAQ,CAAC,YAAY,CAAC,OAAO,EAAE,CAAC;gBACxC,OAAO,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC,YAAY,CAAC,OAAO,EAAE,CAAC,CAAC;YACxD,CAAC;QACH,CAAC;QACD,OAAO,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC7B,CAAC;CACF"}

package/build/rag/retriever.d.ts

@@ -0,0 +1,19 @@
+import { EnhancedChunk } from "../types/rag.js";
+import { EmbeddingsProvider } from "../embeddings/types.js";
+import { DocumentStore } from "../storage/storage.js";
+import { QueryIntent } from "./query-processor.js";
+export interface RetrievalResult {
+    chunks: EnhancedChunk[];
+    relevanceScores: number[];
+}
+export interface RetrievalOptions {
+    limit?: number;
+    minScore?: number;
+    filterByIntent?: boolean;
+}
+export declare class ContextRetriever {
+    private readonly store;
+    private readonly embeddings;
+    constructor(store: DocumentStore, embeddings: EmbeddingsProvider);
+    retrieveContext(queryIntent: QueryIntent, options?: RetrievalOptions): Promise<RetrievalResult>;
+}

package/build/rag/retriever.js

@@ -0,0 +1,111 @@
+import { logger } from "../util/logger.js";
+export class ContextRetriever {
+    store;
+    embeddings;
+    constructor(store, embeddings) {
+        this.store = store;
+        this.embeddings = embeddings;
+    }
+    async retrieveContext(queryIntent, options = {}) {
+        const { limit = 10, minScore = 0.7, filterByIntent = true } = options;
+        logger.debug(`[ContextRetriever] Retrieving context for intent: ${queryIntent.intent}`, {
+            embedding: {
+                length: queryIntent.embedding.length,
+                sample: queryIntent.embedding.slice(0, 5)
+            },
+            options: { limit, minScore, filterByIntent }
+        });
+        // Validate the embedding
+        if (!queryIntent.embedding || queryIntent.embedding.length === 0) {
+            logger.debug('[ContextRetriever] Empty embedding in queryIntent');
+            return { chunks: [], relevanceScores: [] };
+        }
+        // Search for relevant chunks using the original query embedding
+        logger.debug(`[ContextRetriever] Searching documents with embedding of length ${queryIntent.embedding.length}`);
+        // Cast to any to work around TypeScript errors with the StorageProvider interface
+        const searchResults = await this.store.searchDocuments(queryIntent.embedding, // Use the pre-computed query embedding
+        {
+            limit: limit * 2, // Get more results initially for filtering
+            includeVectors: true, // Need vectors for filtering
+            filterByType: filterByIntent ? queryIntent.intent : undefined
+        });
+        logger.debug(`[ContextRetriever] Search returned ${searchResults.length} results`);
+        // Filter and process results
+        const filteredResults = searchResults
+            .filter((result) => {
+            // Apply minimum relevance score threshold
+            if (result.score < minScore) {
+                logger.debug(`[ContextRetriever] Filtering out result with score ${result.score} < ${minScore}`);
+                return false;
+            }
+            if (filterByIntent) {
+                // Additional intent-based filtering logic here
+                // For example, for API queries, prioritize chunks with API documentation
+                // Map intent to metadata type
+                const typeMap = {
+                    'overview': ['overview'],
+                    'api': ['api'],
+                    'example': ['example'],
+                    'usage': ['usage', 'overview'],
+                    'component_usage': ['usage', 'overview'],
+                    'concept': ['overview'],
+                    'troubleshooting': ['example', 'usage'],
+                    'general': ['overview', 'api', 'example', 'usage']
+                };
+                const allowedTypes = typeMap[queryIntent.intent] || ['overview'];
+                const resultType = result.metadata?.type || 'overview';
+                const isAllowed = allowedTypes.includes(resultType);
+                if (!isAllowed) {
+                    logger.debug(`[ContextRetriever] Filtering out result with type ${resultType} not in allowed types:`, allowedTypes);
+                    return false;
+                }
+            }
+            return true;
+        })
+            .slice(0, limit);
+        logger.debug(`[ContextRetriever] After filtering, ${filteredResults.length} results remain`);
+        // Convert search results to EnhancedChunks
+        const chunks = filteredResults.map((result) => {
+            // Log vector information for debugging
+            logger.debug(`[ContextRetriever] Processing result:`, {
+                id: result.id,
+                score: result.score,
+                hasVector: !!result.vector,
+                vectorLength: result.vector ? result.vector.length : 'N/A'
+            });
+            // Use the vector from the search result if available, otherwise create a default vector
+            const embedding = result.vector && Array.isArray(result.vector) && result.vector.length > 0
+                ? result.vector
+                : new Array(this.embeddings.dimensions).fill(0);
+            return {
+                id: result.id,
+                content: result.content,
+                embedding,
+                metadata: {
+                    sourceReliability: 1.0, // Default reliability score
+                    lastVerified: new Date(),
+                    citationInfo: {
+                        version: "1.0", // Default version
+                    },
+                    contextualSummary: result.content.substring(0, 200), // Simple summary
+                    prerequisites: [],
+                    validationRules: {
+                        constraints: [],
+                        requirements: []
+                    },
+                    semanticTags: queryIntent.entities,
+                    complexity: 'basic', // Default complexity
+                    type: result.metadata?.type || 'overview', // Use type from search result or default to overview
+                    framework: result.metadata?.framework,
+                    language: result.metadata?.language
+                },
+                relationships: []
+            };
+        });
+        return {
+            chunks,
+            relevanceScores: filteredResults.map((r) => r.score)
+        };
+    }
+}
+//# sourceMappingURL=retriever.js.map

package/build/rag/retriever.js.map

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

package/build/rag/validator.d.ts

@@ -0,0 +1,22 @@
+import { GeneratedResponse } from "./response-generator.js";
+import { AssembledContext } from "./context-assembler.js";
+export interface ValidationResult {
+    factCheck: boolean;
+    codeCheck: boolean;
+    consistencyCheck: boolean;
+    details: {
+        factCheckDetails: string[];
+        codeCheckDetails: string[];
+        consistencyCheckDetails: string[];
+    };
+}
+export declare class ResponseValidator {
+    private openai;
+    constructor(apiKey: string);
+    validateResponse(response: GeneratedResponse, context: AssembledContext): Promise<ValidationResult>;
+    private validateFacts;
+    private validateCode;
+    private validateConsistency;
+    private formatContext;
+    private checkCommonCodeIssues;
+}