cursor-recursive-rag 0.2.0-alpha.1

package/dist/server/tools/ingest.js.map

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

package/dist/server/tools/list-sources.d.ts

@@ -0,0 +1,9 @@
+import type { VectorStore } from '../../adapters/vector/index.js';
+import type { Embedder } from '../../adapters/embeddings/index.js';
+import type { RAGConfig } from '../../types/index.js';
+export declare function listSourcesTool(args: Record<string, any>, deps: {
+    vectorStore: VectorStore;
+    embedder: Embedder;
+    config: RAGConfig;
+}): Promise<any>;
+//# sourceMappingURL=list-sources.d.ts.map

package/dist/server/tools/list-sources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-sources.d.ts","sourceRoot":"","sources":["../../../src/server/tools/list-sources.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAClE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oCAAoC,CAAC;AACnE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAEtD,wBAAsB,eAAe,CACnC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACzB,IAAI,EAAE;IAAE,WAAW,EAAE,WAAW,CAAC;IAAC,QAAQ,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,SAAS,CAAA;CAAE,GACxE,OAAO,CAAC,GAAG,CAAC,CAoEd"}

package/dist/server/tools/list-sources.js

@@ -0,0 +1,63 @@
+export async function listSourcesTool(args, deps) {
+    const { vectorStore, embedder } = deps;
+    try {
+        // Sample a representative query to get some results
+        // We'll use a generic query to retrieve chunks and extract unique sources
+        const sampleQuery = 'documentation guide tutorial';
+        const embedding = await embedder.embed(sampleQuery);
+        // Get a large sample to find sources (up to 1000 results)
+        const results = await vectorStore.search(embedding, { topK: 1000 });
+        // Extract unique sources from metadata
+        const sourceMap = new Map();
+        for (const result of results) {
+            const source = result.metadata?.source || result.metadata?.path || 'unknown';
+            if (!sourceMap.has(source)) {
+                sourceMap.set(source, {
+                    chunks: 0,
+                    title: result.metadata?.title
+                });
+            }
+            const sourceInfo = sourceMap.get(source);
+            sourceInfo.chunks++;
+        }
+        const sources = Array.from(sourceMap.entries()).map(([source, info]) => ({
+            id: source,
+            name: info.title || source,
+            chunks: info.chunks,
+            url: source.startsWith('http') ? source : undefined
+        }));
+        if (sources.length === 0) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: 'No sources found in the knowledge base. Ingest documents using the ingest_document or crawl_and_ingest tools.'
+                    }
+                ]
+            };
+        }
+        const sourceList = sources
+            .map(s => `- ${s.name} (${s.chunks} chunks)${s.url ? `\n  ${s.url}` : ''}`)
+            .join('\n');
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Found ${sources.length} source(s) in the knowledge base:\n\n${sourceList}\n\nNote: This is a sample-based listing. The actual count may be higher.`
+                }
+            ]
+        };
+    }
+    catch (error) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Error listing sources: ${error instanceof Error ? error.message : 'Unknown error'}`
+                }
+            ],
+            isError: true
+        };
+    }
+}
+//# sourceMappingURL=list-sources.js.map

package/dist/server/tools/list-sources.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-sources.js","sourceRoot":"","sources":["../../../src/server/tools/list-sources.ts"],"names":[],"mappings":"AAIA,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,IAAyB,EACzB,IAAyE;IAEzE,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC;IAEvC,IAAI,CAAC;QACH,oDAAoD;QACpD,0EAA0E;QAC1E,MAAM,WAAW,GAAG,8BAA8B,CAAC;QACnD,MAAM,SAAS,GAAG,MAAM,QAAQ,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;QAEpD,0DAA0D;QAC1D,MAAM,OAAO,GAAG,MAAM,WAAW,CAAC,MAAM,CAAC,SAAS,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QAEpE,uCAAuC;QACvC,MAAM,SAAS,GAAG,IAAI,GAAG,EAA8C,CAAC;QAExE,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC7B,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,EAAE,MAAM,IAAI,MAAM,CAAC,QAAQ,EAAE,IAAI,IAAI,SAAS,CAAC;YAC7E,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC3B,SAAS,CAAC,GAAG,CAAC,MAAM,EAAE;oBACpB,MAAM,EAAE,CAAC;oBACT,KAAK,EAAE,MAAM,CAAC,QAAQ,EAAE,KAAK;iBAC9B,CAAC,CAAC;YACL,CAAC;YACD,MAAM,UAAU,GAAG,SAAS,CAAC,GAAG,CAAC,MAAM,CAAE,CAAC;YAC1C,UAAU,CAAC,MAAM,EAAE,CAAC;QACtB,CAAC;QAED,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;YACvE,EAAE,EAAE,MAAM;YACV,IAAI,EAAE,IAAI,CAAC,KAAK,IAAI,MAAM;YAC1B,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS;SACpD,CAAC,CAAC,CAAC;QAEJ,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,+GAA+G;qBACtH;iBACF;aACF,CAAC;QACJ,CAAC;QAED,MAAM,UAAU,GAAG,OAAO;aACvB,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,MAAM,WAAW,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;aAC1E,IAAI,CAAC,IAAI,CAAC,CAAC;QAEd,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,SAAS,OAAO,CAAC,MAAM,wCAAwC,UAAU,2EAA2E;iBAC3J;aACF;SACF,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,0BAA0B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,EAAE;iBAC3F;aACF;YACD,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/server/tools/recursive-query.d.ts

@@ -0,0 +1,16 @@
+import type { VectorStore } from '../../adapters/vector/index.js';
+import type { Embedder } from '../../adapters/embeddings/index.js';
+import type { RAGConfig } from '../../types/index.js';
+interface RecursiveQueryArgs {
+    query: string;
+    maxIterations?: number;
+    minConfidence?: number;
+    sources?: string[];
+}
+export declare function recursiveQueryTool(args: RecursiveQueryArgs, deps: {
+    vectorStore: VectorStore;
+    embedder: Embedder;
+    config: RAGConfig;
+}): Promise<any>;
+export {};
+//# sourceMappingURL=recursive-query.d.ts.map

package/dist/server/tools/recursive-query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recursive-query.d.ts","sourceRoot":"","sources":["../../../src/server/tools/recursive-query.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAClE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oCAAoC,CAAC;AACnE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAGtD,UAAU,kBAAkB;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,kBAAkB,EACxB,IAAI,EAAE;IAAE,WAAW,EAAE,WAAW,CAAC;IAAC,QAAQ,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,SAAS,CAAA;CAAE,GACxE,OAAO,CAAC,GAAG,CAAC,CA+Ed"}

package/dist/server/tools/recursive-query.js

@@ -0,0 +1,65 @@
+import { decomposeQuery, generateFollowUps, assessConfidence } from '../../services/query-decomposer.js';
+export async function recursiveQueryTool(args, deps) {
+    const { query, maxIterations = 5, minConfidence = 0.7, sources } = args;
+    const { vectorStore, embedder } = deps;
+    // Step 1: Decompose complex query into sub-questions
+    const subQuestions = decomposeQuery(query);
+    // Step 2: Initial retrieval for each sub-question
+    const context = [];
+    for (const subQ of subQuestions) {
+        const embedding = await embedder.embed(subQ);
+        const searchOptions = { topK: 10 };
+        if (sources && sources.length > 0) {
+            searchOptions.filter = { source: { $in: sources } };
+        }
+        const chunks = await vectorStore.search(embedding, searchOptions);
+        context.push({ question: subQ, chunks, iteration: 0 });
+    }
+    // Step 3: Iterative refinement
+    for (let i = 0; i < maxIterations; i++) {
+        // Generate follow-up questions based on current context
+        const followUps = generateFollowUps(query, context, 3);
+        if (followUps.length === 0)
+            break;
+        // Retrieve for follow-ups
+        for (const followUp of followUps) {
+            const embedding = await embedder.embed(followUp.query);
+            const searchOptions = { topK: 5 };
+            if (sources && sources.length > 0) {
+                searchOptions.filter = { source: { $in: sources } };
+            }
+            const chunks = await vectorStore.search(embedding, searchOptions);
+            context.push({
+                question: followUp.query,
+                chunks,
+                iteration: i + 1
+            });
+        }
+        // Check if we have sufficient coverage
+        const confidence = assessConfidence(query, context);
+        if (confidence >= minConfidence)
+            break;
+    }
+    // Step 4: Synthesize final answer
+    // For now, return all relevant chunks with scores
+    // In a full implementation, this would use an LLM to synthesize
+    const allChunks = context.flatMap(c => c.chunks);
+    const uniqueChunks = Array.from(new Map(allChunks.map(c => [c.id, c])).values());
+    // Sort by score descending
+    uniqueChunks.sort((a, b) => (b.score || 0) - (a.score || 0));
+    // Take top chunks for answer synthesis
+    const topChunks = uniqueChunks.slice(0, 20);
+    // Simple synthesis: combine top chunks
+    const answer = topChunks
+        .map((chunk, idx) => `[${idx + 1}] ${chunk.content}`)
+        .join('\n\n');
+    return {
+        content: [
+            {
+                type: 'text',
+                text: `## Answer\n\n${answer}\n\n## Sources\n\nFound ${uniqueChunks.length} relevant chunks from ${context.length} retrieval steps.`
+            }
+        ]
+    };
+}
+//# sourceMappingURL=recursive-query.js.map

package/dist/server/tools/recursive-query.js.map

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

package/dist/server/tools/search.d.ts

@@ -0,0 +1,15 @@
+import type { VectorStore } from '../../adapters/vector/index.js';
+import type { Embedder } from '../../adapters/embeddings/index.js';
+import type { RAGConfig } from '../../types/index.js';
+interface SearchKnowledgeArgs {
+    query: string;
+    topK?: number;
+    sources?: string[];
+}
+export declare function searchKnowledgeTool(args: SearchKnowledgeArgs, deps: {
+    vectorStore: VectorStore;
+    embedder: Embedder;
+    config: RAGConfig;
+}): Promise<any>;
+export {};
+//# sourceMappingURL=search.d.ts.map

package/dist/server/tools/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../../src/server/tools/search.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAClE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oCAAoC,CAAC;AACnE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAEtD,UAAU,mBAAmB;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,mBAAmB,EACzB,IAAI,EAAE;IAAE,WAAW,EAAE,WAAW,CAAC;IAAC,QAAQ,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,SAAS,CAAA;CAAE,GACxE,OAAO,CAAC,GAAG,CAAC,CAyBd"}

package/dist/server/tools/search.js

@@ -0,0 +1,20 @@
+export async function searchKnowledgeTool(args, deps) {
+    const { query, topK = 10, sources } = args;
+    const { vectorStore, embedder } = deps;
+    const embedding = await embedder.embed(query);
+    const searchOptions = { topK };
+    if (sources && sources.length > 0) {
+        searchOptions.filter = { source: { $in: sources } };
+    }
+    const results = await vectorStore.search(embedding, searchOptions);
+    const formattedResults = results.map((result, idx) => `[${idx + 1}] Score: ${result.score.toFixed(4)}\nSource: ${result.metadata.source || 'unknown'}\n${result.content}`).join('\n\n---\n\n');
+    return {
+        content: [
+            {
+                type: 'text',
+                text: `Found ${results.length} results:\n\n${formattedResults}`
+            }
+        ]
+    };
+}
+//# sourceMappingURL=search.js.map

package/dist/server/tools/search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.js","sourceRoot":"","sources":["../../../src/server/tools/search.ts"],"names":[],"mappings":"AAUA,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,IAAyB,EACzB,IAAyE;IAEzE,MAAM,EAAE,KAAK,EAAE,IAAI,GAAG,EAAE,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAC3C,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC;IAEvC,MAAM,SAAS,GAAG,MAAM,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAE9C,MAAM,aAAa,GAAQ,EAAE,IAAI,EAAE,CAAC;IACpC,IAAI,OAAO,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAClC,aAAa,CAAC,MAAM,GAAG,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE,EAAE,CAAC;IACtD,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,WAAW,CAAC,MAAM,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;IAEnE,MAAM,gBAAgB,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,MAAW,EAAE,GAAW,EAAE,EAAE,CAChE,IAAI,GAAG,GAAG,CAAC,YAAY,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,aAAa,MAAM,CAAC,QAAQ,CAAC,MAAM,IAAI,SAAS,KAAK,MAAM,CAAC,OAAO,EAAE,CACpH,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IAEtB,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,SAAS,OAAO,CAAC,MAAM,gBAAgB,gBAAgB,EAAE;aAChE;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/server/tools/skills.d.ts

@@ -0,0 +1,30 @@
+import type { RAGConfig } from '../../types/index.js';
+import { type Skill } from '../../integrations/openskills.js';
+export declare function listOpenSkillsTool(config: RAGConfig): Promise<{
+    skills: Array<{
+        name: string;
+        description: string;
+        location: string;
+    }>;
+}>;
+export declare function readOpenSkillTool(config: RAGConfig, params: {
+    name: string;
+}): Promise<{
+    skill: Skill | null;
+    content: string;
+}>;
+export declare function ingestSkillsTool(config: RAGConfig): Promise<{
+    ingested: number;
+    skills: string[];
+}>;
+export declare function searchSkillsTool(config: RAGConfig, params: {
+    query: string;
+    topK?: number;
+}): Promise<{
+    results: Array<{
+        name: string;
+        content: string;
+        score: number;
+    }>;
+}>;
+//# sourceMappingURL=skills.d.ts.map

package/dist/server/tools/skills.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills.d.ts","sourceRoot":"","sources":["../../../src/server/tools/skills.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAA0B,KAAK,KAAK,EAAE,MAAM,kCAAkC,CAAC;AAMtF,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,SAAS,GAChB,OAAO,CAAC;IAAE,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAAC,CAerF;AAED,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GACvB,OAAO,CAAC;IAAE,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAenD;AAED,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,SAAS,GAChB,OAAO,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAwCjD;AAED,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GACvC,OAAO,CAAC;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAAC,CAwB/E"}

package/dist/server/tools/skills.js

@@ -0,0 +1,85 @@
+import { createOpenSkillsClient } from '../../integrations/openskills.js';
+import { createVectorStore } from '../../adapters/vector/index.js';
+import { createEmbedder } from '../../adapters/embeddings/index.js';
+import { chunkDocument } from '../../services/chunker.js';
+import { randomUUID } from 'crypto';
+export async function listOpenSkillsTool(config) {
+    const client = createOpenSkillsClient(config);
+    if (!client.isEnabled()) {
+        return { skills: [] };
+    }
+    const skills = await client.listSkills();
+    return {
+        skills: skills.map(s => ({
+            name: s.name,
+            description: s.description,
+            location: s.location
+        }))
+    };
+}
+export async function readOpenSkillTool(config, params) {
+    const client = createOpenSkillsClient(config);
+    if (!client.isEnabled()) {
+        throw new Error('OpenSkills integration is not enabled');
+    }
+    const skill = await client.readSkill(params.name);
+    if (!skill) {
+        return { skill: null, content: '' };
+    }
+    const content = client.getSkillContent(skill);
+    return { skill, content };
+}
+export async function ingestSkillsTool(config) {
+    const client = createOpenSkillsClient(config);
+    if (!client.isEnabled()) {
+        throw new Error('OpenSkills integration is not enabled');
+    }
+    const vectorStore = createVectorStore(config.vectorStore, config);
+    const embedder = await createEmbedder(config.embeddings, config);
+    const documents = client.skillsToDocuments();
+    const ingestedSkills = [];
+    for (const doc of documents) {
+        const chunks = chunkDocument(doc.content, {
+            chunkSize: 512,
+            chunkOverlap: 50
+        });
+        const embeddings = await embedder.embedBatch(chunks.map(c => c.text));
+        const vectorDocs = chunks.map((chunk, i) => ({
+            id: randomUUID(),
+            embedding: embeddings[i],
+            content: chunk.text,
+            metadata: {
+                ...doc.metadata,
+                chunkIndex: i,
+                totalChunks: chunks.length
+            }
+        }));
+        await vectorStore.add(vectorDocs);
+        ingestedSkills.push(doc.metadata.name);
+    }
+    return {
+        ingested: ingestedSkills.length,
+        skills: ingestedSkills
+    };
+}
+export async function searchSkillsTool(config, params) {
+    const client = createOpenSkillsClient(config);
+    if (!client.isEnabled()) {
+        return { results: [] };
+    }
+    const vectorStore = createVectorStore(config.vectorStore, config);
+    const embedder = await createEmbedder(config.embeddings, config);
+    const embedding = await embedder.embed(params.query);
+    const results = await vectorStore.search(embedding, {
+        topK: params.topK || 5,
+        filter: { type: { $in: ['skill'] } }
+    });
+    return {
+        results: results.map((r) => ({
+            name: r.metadata?.name || 'unknown',
+            content: r.content.substring(0, 500),
+            score: r.score
+        }))
+    };
+}
+//# sourceMappingURL=skills.js.map

package/dist/server/tools/skills.js.map

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

package/dist/services/chunker.d.ts

@@ -0,0 +1,3 @@
+import type { Chunk, ChunkOptions } from '../types/index.js';
+export declare function chunkDocument(text: string, options?: ChunkOptions): Chunk[];
+//# sourceMappingURL=chunker.d.ts.map

package/dist/services/chunker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunker.d.ts","sourceRoot":"","sources":["../../src/services/chunker.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AA0D7D,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,YAAiB,GAAG,KAAK,EAAE,CA+B/E"}

package/dist/services/chunker.js

@@ -0,0 +1,75 @@
+import { encoding_for_model } from 'tiktoken';
+const tokenizer = encoding_for_model('gpt-3.5-turbo');
+function tokenCount(text) {
+    return tokenizer.encode(text).length;
+}
+function splitBySemanticBoundaries(text) {
+    // Split by double newlines (paragraphs)
+    let sections = text.split(/\n\n+/);
+    // Further split long sections by headers (# ## ###)
+    const finalSections = [];
+    for (const section of sections) {
+        const headerMatches = section.match(/^(#{1,6}\s+.+)$/gm);
+        if (headerMatches && headerMatches.length > 1) {
+            // Split by headers
+            const parts = section.split(/(?=^#{1,6}\s+)/m);
+            finalSections.push(...parts.filter(p => p.trim().length > 0));
+        }
+        else {
+            finalSections.push(section);
+        }
+    }
+    return finalSections.filter(s => s.trim().length > 0);
+}
+function slidingWindowChunk(text, chunkSize, overlap) {
+    const chunks = [];
+    const words = text.split(/\s+/);
+    let currentChunk = [];
+    let currentTokens = 0;
+    for (const word of words) {
+        const wordTokens = tokenCount(word);
+        if (currentTokens + wordTokens > chunkSize && currentChunk.length > 0) {
+            // Save current chunk
+            chunks.push(currentChunk.join(' '));
+            // Start new chunk with overlap
+            const overlapSize = Math.floor(currentChunk.length * (overlap / 100));
+            currentChunk = currentChunk.slice(-overlapSize);
+            currentTokens = tokenCount(currentChunk.join(' '));
+        }
+        currentChunk.push(word);
+        currentTokens += wordTokens;
+    }
+    // Add final chunk
+    if (currentChunk.length > 0) {
+        chunks.push(currentChunk.join(' '));
+    }
+    return chunks;
+}
+export function chunkDocument(text, options = {}) {
+    const { chunkSize = 512, chunkOverlap = 50, respectBoundaries = true } = options;
+    if (respectBoundaries) {
+        // Split by semantic boundaries first
+        const sections = splitBySemanticBoundaries(text);
+        const chunks = [];
+        for (const section of sections) {
+            const tokens = tokenCount(section);
+            if (tokens <= chunkSize) {
+                chunks.push({ text: section, index: chunks.length });
+            }
+            else {
+                // Sliding window with overlap
+                const windowChunks = slidingWindowChunk(section, chunkSize, chunkOverlap);
+                windowChunks.forEach((chunkText, i) => {
+                    chunks.push({ text: chunkText, index: chunks.length });
+                });
+            }
+        }
+        return chunks;
+    }
+    else {
+        // Simple sliding window without respecting boundaries
+        const windowChunks = slidingWindowChunk(text, chunkSize, chunkOverlap);
+        return windowChunks.map((text, index) => ({ text, index }));
+    }
+}
+//# sourceMappingURL=chunker.js.map

package/dist/services/chunker.js.map

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

package/dist/services/config.d.ts

@@ -0,0 +1,8 @@
+import type { RAGConfig } from '../types/index.js';
+export declare const CONFIG_DIR: string;
+export declare const CONFIG_FILE: string;
+export declare const CURSOR_MCP_PATH: string;
+export declare function loadConfig(): RAGConfig;
+export declare function writeConfig(config: RAGConfig): void;
+export declare function registerWithCursor(): Promise<void>;
+//# sourceMappingURL=config.d.ts.map

package/dist/services/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/services/config.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAKnD,eAAO,MAAM,UAAU,QAAiC,CAAC;AACzD,eAAO,MAAM,WAAW,QAAkC,CAAC;AAC3D,eAAO,MAAM,eAAe,QAAyC,CAAC;AAEtE,wBAAgB,UAAU,IAAI,SAAS,CAOtC;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAMnD;AAyBD,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC,CA0BxD"}

package/dist/services/config.js

@@ -0,0 +1,66 @@
+import { homedir } from 'os';
+import { readFileSync, writeFileSync, existsSync, mkdirSync, realpathSync } from 'fs';
+import { join, dirname } from 'path';
+import { fileURLToPath } from 'url';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+export const CONFIG_DIR = join(homedir(), '.cursor-rag');
+export const CONFIG_FILE = join(CONFIG_DIR, 'config.json');
+export const CURSOR_MCP_PATH = join(homedir(), '.cursor', 'mcp.json');
+export function loadConfig() {
+    if (!existsSync(CONFIG_FILE)) {
+        throw new Error(`Config file not found: ${CONFIG_FILE}. Run 'cursor-rag setup' first.`);
+    }
+    const content = readFileSync(CONFIG_FILE, 'utf-8');
+    return JSON.parse(content);
+}
+export function writeConfig(config) {
+    if (!existsSync(CONFIG_DIR)) {
+        mkdirSync(CONFIG_DIR, { recursive: true });
+    }
+    writeFileSync(CONFIG_FILE, JSON.stringify(config, null, 2));
+}
+function getServerPath() {
+    // First check environment variable
+    if (process.env.CURSOR_RAG_SERVER_PATH) {
+        return process.env.CURSOR_RAG_SERVER_PATH;
+    }
+    // Resolve the actual path from the current module location
+    // __dirname is services/, so server/index.js is at ../server/index.js
+    const localServerPath = join(__dirname, '../server/index.js');
+    if (existsSync(localServerPath)) {
+        // Use realpath to resolve symlinks (for npm link scenarios)
+        try {
+            return realpathSync(localServerPath);
+        }
+        catch {
+            return localServerPath;
+        }
+    }
+    // Fallback to package name (for global npm installs)
+    return 'cursor-recursive-rag/dist/server/index.js';
+}
+export async function registerWithCursor() {
+    // Read existing mcp.json or create new
+    let mcpConfig = { mcpServers: {} };
+    if (existsSync(CURSOR_MCP_PATH)) {
+        const content = readFileSync(CURSOR_MCP_PATH, 'utf-8');
+        mcpConfig = JSON.parse(content);
+    }
+    // Ensure mcpServers exists
+    if (!mcpConfig.mcpServers) {
+        mcpConfig.mcpServers = {};
+    }
+    const serverPath = getServerPath();
+    // Add recursive-rag server
+    mcpConfig.mcpServers['recursive-rag'] = {
+        command: 'node',
+        args: [serverPath],
+        env: {
+            CURSOR_RAG_CONFIG: CONFIG_FILE
+        }
+    };
+    // Write back
+    writeFileSync(CURSOR_MCP_PATH, JSON.stringify(mcpConfig, null, 2));
+}
+//# sourceMappingURL=config.js.map

package/dist/services/config.js.map

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

package/dist/services/query-decomposer.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Query decomposition for recursive RAG
+ *
+ * This service breaks down complex queries into sub-questions
+ * and generates follow-up questions based on retrieved context.
+ */
+export interface SubQuestion {
+    question: string;
+    reasoning: string;
+}
+export interface FollowUpQuestion {
+    query: string;
+    reasoning: string;
+}
+/**
+ * Decompose a complex query into sub-questions
+ *
+ * For now, uses simple heuristics. In the future, this could use
+ * an LLM to intelligently decompose queries.
+ */
+export declare function decomposeQuery(query: string): string[];
+/**
+ * Generate follow-up questions based on retrieved context and original query
+ *
+ * This is a placeholder for a more sophisticated implementation that would:
+ * 1. Analyze gaps in the retrieved context
+ * 2. Identify entities or concepts that need more detail
+ * 3. Generate targeted follow-up queries
+ */
+export declare function generateFollowUps(originalQuery: string, context: Array<{
+    question: string;
+    chunks: any[];
+}>, maxFollowUps?: number): FollowUpQuestion[];
+/**
+ * Assess confidence that we have sufficient information to answer the query
+ *
+ * Simple heuristic based on number of chunks and their relevance scores
+ */
+export declare function assessConfidence(query: string, context: Array<{
+    question: string;
+    chunks: any[];
+    iteration?: number;
+}>): number;
+//# sourceMappingURL=query-decomposer.d.ts.map

package/dist/services/query-decomposer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-decomposer.d.ts","sourceRoot":"","sources":["../../src/services/query-decomposer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAqBtD;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,KAAK,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,GAAG,EAAE,CAAA;CAAE,CAAC,EACnD,YAAY,GAAE,MAAU,GACvB,gBAAgB,EAAE,CA0BpB;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,KAAK,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,GAAG,EAAE,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,GACtE,MAAM,CAcR"}