cursor-recursive-rag 0.2.0-alpha.1

package/README.md

@@ -0,0 +1,354 @@
+# cursor-recursive-rag
+
+[![Version](https://img.shields.io/badge/version-0.2.0--alpha.1-blue.svg)](https://github.com/garethdaine/cursor-recursive-rag/releases)
+[![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
+[![Node](https://img.shields.io/badge/node-%3E%3D20.0.0-brightgreen.svg)](https://nodejs.org)
+
+Recursive RAG MCP server for Cursor IDE with interactive setup wizard and web dashboard. Build a knowledge base from your documentation and codebase, enabling multi-hop retrieval and iterative query refinement.
+
+> **Status:** Alpha - Core features working, API may change
+
+## Features
+
+- **Recursive Query**: Multi-hop retrieval with query decomposition and iterative refinement
+- **Configurable Vector Stores**: Redis Stack (recommended), Qdrant (local/cloud), ChromaDB, Cloudflare Vectorize
+- **Configurable Embeddings**: Local (Xenova/transformers.js), OpenAI, Ollama
+- **Web Crawling**: Firecrawl integration for documentation ingestion
+- **Rotating Proxy Support**: Optional PacketStream/SmartProxy integration for URL fetching
+- **Web Dashboard**: Real-time monitoring, search, and configuration UI (Tailwind CSS)
+- **Interactive Setup**: Guided configuration wizard
+- **MCP Integration**: Automatic registration with Cursor IDE
+- **MCP Gateway Integration**: Connect to [MCP Gateway](https://github.com/abdullah1854/MCPGateway) for 87+ aggregated tools with token optimization
+- **OpenSkills Integration**: Auto-discover and ingest skills from [OpenSkills](https://github.com/numman-ali/openskills) for semantic search
+
+## Quick Start
+
+```bash
+# Clone and install
+git clone https://github.com/garethdaine/cursor-recursive-rag.git
+cd cursor-recursive-rag
+npm install && npm run build && npm link
+
+# Run interactive setup
+cursor-rag setup
+
+# Ingest documentation (with Firecrawl)
+cursor-rag ingest https://nextjs.org/docs --crawl --max-pages 200
+
+# Ingest a local directory
+cursor-rag ingest ./docs
+
+# Check status
+cursor-rag status
+
+# Test search from CLI
+cursor-rag search "how to authenticate users"
+
+# Start the web dashboard
+cursor-rag dashboard
+```
+
+## Installation
+
+### From GitHub (recommended)
+
+```bash
+git clone https://github.com/garethdaine/cursor-recursive-rag.git
+cd cursor-recursive-rag
+npm install
+npm run build
+npm link  # Makes cursor-rag available globally
+```
+
+### From npm (coming soon)
+
+```bash
+# Not yet published
+npm install -g cursor-recursive-rag
+```
+
+## Setup Wizard
+
+Run `cursor-rag setup` to configure the system. The wizard will:
+
+1. **Select Vector Store** (Redis recommended):
+   - **Redis Stack** (default): Persistent, fast HNSW search, `docker run -p 6379:6379 redis/redis-stack-server`
+   - **Qdrant**: Persistent, local Docker or cloud, `docker run -p 6333:6333 qdrant/qdrant`
+   - **Memory**: In-process, non-persistent (testing only)
+   - **ChromaDB**: Requires separate server, `docker run -p 8000:8000 chromadb/chroma`
+   - **Cloudflare Vectorize**: Serverless (not yet implemented)
+
+2. **Select Embedding Model**:
+   - **Xenova (local)**: Free, private, ~384 dimensions
+   - **Ollama**: Local, configurable models
+   - **OpenAI**: High quality, requires API key
+
+3. **API Keys**:
+   - OpenAI API key (if using OpenAI embeddings)
+   - Firecrawl API key (for web crawling)
+   - Qdrant URL/API key (if using Qdrant)
+   - Ollama URL/model (if using Ollama)
+
+4. **Auto-register** the MCP server with Cursor IDE
+
+## CLI Commands
+
+### `cursor-rag setup`
+
+Interactive setup wizard to configure vector store, embeddings, proxy, and API keys.
+
+```bash
+cursor-rag setup
+cursor-rag setup --vector-store chroma --embeddings xenova
+```
+
+### `cursor-rag ingest`
+
+Add documents to the knowledge base.
+
+```bash
+# Crawl a website (requires Firecrawl API key)
+cursor-rag ingest https://docs.example.com --crawl --max-pages 100 --max-depth 3
+
+# Ingest a single URL
+cursor-rag ingest https://example.com/page
+
+# Ingest a local file
+cursor-rag ingest ./document.md
+
+# Ingest a directory (recursive)
+cursor-rag ingest ./docs
+```
+
+### `cursor-rag search`
+
+Test search from the command line.
+
+```bash
+cursor-rag search "how to set up authentication"
+cursor-rag search "database queries" --top-k 10
+```
+
+### `cursor-rag status`
+
+Show current configuration and knowledge base statistics.
+
+```bash
+cursor-rag status
+```
+
+### `cursor-rag dashboard`
+
+Start the web dashboard for monitoring and configuration.
+
+```bash
+cursor-rag dashboard
+cursor-rag dashboard --port 8080
+```
+
+The dashboard provides:
+- **Overview**: Total chunks, vector store stats, recent activity
+- **Search**: Test queries against your knowledge base
+- **Activity Log**: Real-time view of ingestion and search operations
+- **Settings**: Configure vector store, embeddings, and proxy settings
+
+## Usage in Cursor
+
+### Option 1: Via `@Docs` (Recommended)
+
+The dashboard serves your knowledge base as browsable documentation that Cursor can index:
+
+1. Start the dashboard: `cursor-rag dashboard`
+2. In Cursor, type `@Docs` and select **Add new doc**
+3. Enter: `http://localhost:3333/docs`
+4. Now use `@Docs cursor-recursive-rag` in your prompts!
+
+### Option 2: Via MCP Tools (Natural Language)
+
+The MCP tools are available to the AI agent in Cursor Chat. Ask questions naturally and the AI will use the appropriate tools:
+
+```
+Search my knowledge base for authentication patterns
+
+What sources are indexed in my RAG knowledge base?
+
+Crawl and ingest https://docs.example.com into my knowledge base with a max of 50 pages
+```
+
+> **Note:** MCP tools don't use `@` syntax - that's reserved for Cursor's built-in features (`@Codebase`, `@Docs`, `@Files`). MCP tools are called automatically by the AI when relevant to your request.
+
+### Available MCP Tools
+
+| Tool | Description |
+|------|-------------|
+| `recursive_query` | Multi-hop retrieval with query decomposition |
+| `search_knowledge` | Direct vector similarity search |
+| `ingest_document` | Add a single document (URL, file, or text) |
+| `crawl_and_ingest` | Crawl website with Firecrawl and index |
+| `list_sources` | List indexed document sources |
+
+## Configuration
+
+Configuration is stored in `~/.cursor-rag/config.json`:
+
+```json
+{
+  "vectorStore": "chroma",
+  "embeddings": "xenova",
+  "apiKeys": {
+    "firecrawl": "fc-..."
+  },
+  "proxy": {
+    "enabled": true,
+    "driver": "packetstream",
+    "host": "proxy.packetstream.io",
+    "port": 31112,
+    "username": "your-username",
+    "password": "your-password"
+  },
+  "dashboard": {
+    "enabled": true,
+    "port": 3333
+  }
+}
+```
+
+### Proxy Configuration
+
+The optional rotating proxy is used for direct URL fetching (not needed when using Firecrawl, which handles proxying internally). Supported providers:
+
+- **PacketStream**: Residential proxies with country targeting
+- **SmartProxy**: Datacenter and residential options
+
+### MCP Gateway Integration
+
+Connect to [MCP Gateway](https://github.com/abdullah1854/MCPGateway) to access 87+ aggregated tools with token optimization:
+
+```json
+{
+  "mcpGateway": {
+    "enabled": true,
+    "url": "http://localhost:3010",
+    "apiKey": "optional-api-key"
+  }
+}
+```
+
+**MCP Tools exposed:**
+- `gateway_search_tools` - Search available tools across all backends
+- `gateway_call_tool` - Call any gateway tool with result filtering
+- `gateway_execute_skill` - Execute gateway skills
+- `gateway_health` - Check gateway status
+
+### OpenSkills Integration
+
+Connect to [OpenSkills](https://github.com/numman-ali/openskills) for universal skills loading:
+
+```json
+{
+  "openSkills": {
+    "enabled": true,
+    "autoIngestSkills": true
+  }
+}
+```
+
+**MCP Tools exposed:**
+- `list_openskills` - List all installed skills
+- `read_openskill` - Read a specific skill's content
+- `ingest_openskills` - Ingest all skills into RAG knowledge base
+- `search_openskills` - Semantic search across ingested skills
+
+**Skill Discovery Paths (priority order):**
+1. `./.agent/skills/` (project universal)
+2. `~/.agent/skills/` (global universal)
+3. `./.claude/skills/` (project Claude)
+4. `~/.claude/skills/` (global Claude)
+
+The MCP server is registered in `~/.cursor/mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "recursive-rag": {
+      "command": "node",
+      "args": ["cursor-recursive-rag/dist/server/index.js"],
+      "env": {
+        "CURSOR_RAG_CONFIG": "/Users/you/.cursor-rag/config.json"
+      }
+    }
+  }
+}
+```
+
+## Architecture
+
+```
+cursor-recursive-rag/
+├── src/
+│   ├── cli/               # CLI commands (setup, ingest, search, status)
+│   ├── server/            # MCP server and tool handlers
+│   ├── adapters/
+│   │   ├── vector/        # Vector store adapters (Chroma, Qdrant, Vectorize)
+│   │   └── embeddings/    # Embedding adapters (Xenova, OpenAI, Ollama)
+│   ├── services/          # Chunker, query decomposer, config
+│   └── types/             # TypeScript type definitions
+├── bin/                   # CLI entry point
+├── dist/                  # Compiled JavaScript
+└── package.json
+```
+
+## Requirements
+
+- Node.js >= 20.0.0
+- Cursor IDE (for MCP integration)
+- Optional: Docker (for Qdrant local)
+- Optional: Ollama (for local embeddings)
+
+## API Keys
+
+| Service | Purpose | Get Key |
+|---------|---------|---------|
+| Firecrawl | Web crawling | https://www.firecrawl.dev |
+| OpenAI | Embeddings | https://platform.openai.com |
+| Qdrant Cloud | Vector store | https://cloud.qdrant.io |
+
+## Troubleshooting
+
+### "Config file not found"
+
+Run `cursor-rag setup` to create the configuration.
+
+### MCP server not showing in Cursor
+
+1. Check `~/.cursor/mcp.json` has the `recursive-rag` entry
+2. Restart Cursor IDE
+3. Check the server path is correct
+
+### Firecrawl errors
+
+Ensure your Firecrawl API key is valid and starts with `fc-`.
+
+### ChromaDB permission errors
+
+The local ChromaDB stores data in `~/.cursor-rag/chroma-data`. Ensure this directory is writable.
+
+## Development
+
+```bash
+# Install dependencies
+npm install
+
+# Build
+npm run build
+
+# Development mode (watch)
+npm run dev
+
+# Link for testing
+npm link
+```
+
+## License
+
+MIT

package/bin/cursor-rag.js

@@ -0,0 +1,18 @@
+#!/usr/bin/env node
+
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
+import { createRequire } from 'module';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+// Use createRequire to load the compiled CLI
+const require = createRequire(import.meta.url);
+const cliPath = join(__dirname, '../dist/cli/index.js');
+
+// Import and run the CLI
+import(cliPath).catch((error) => {
+  console.error('Failed to start CLI:', error);
+  process.exit(1);
+});

package/dist/adapters/embeddings/index.d.ts

@@ -0,0 +1,5 @@
+import type { Embedder } from './types.js';
+import type { RAGConfig } from '../../types/index.js';
+export { Embedder } from './types.js';
+export declare function createEmbedder(type: string, config: RAGConfig): Promise<Embedder>;
+//# sourceMappingURL=index.d.ts.map

package/dist/adapters/embeddings/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/adapters/embeddings/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAI3C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAEtD,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,QAAQ,CAAC,CAWvF"}

package/dist/adapters/embeddings/index.js

@@ -0,0 +1,16 @@
+import { XenovaAdapter } from './xenova.js';
+import { OpenAIAdapter } from './openai.js';
+import { OllamaAdapter } from './ollama.js';
+export async function createEmbedder(type, config) {
+    switch (type) {
+        case 'xenova':
+            return await XenovaAdapter.create(config);
+        case 'openai':
+            return new OpenAIAdapter(config);
+        case 'ollama':
+            return new OllamaAdapter(config);
+        default:
+            throw new Error(`Unknown embedder: ${type}`);
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/adapters/embeddings/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/adapters/embeddings/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAK5C,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,IAAY,EAAE,MAAiB;IAClE,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,QAAQ;YACX,OAAO,MAAM,aAAa,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAC5C,KAAK,QAAQ;YACX,OAAO,IAAI,aAAa,CAAC,MAAM,CAAC,CAAC;QACnC,KAAK,QAAQ;YACX,OAAO,IAAI,aAAa,CAAC,MAAM,CAAC,CAAC;QACnC;YACE,MAAM,IAAI,KAAK,CAAC,qBAAqB,IAAI,EAAE,CAAC,CAAC;IACjD,CAAC;AACH,CAAC"}

package/dist/adapters/embeddings/ollama.d.ts

@@ -0,0 +1,11 @@
+import type { Embedder } from './types.js';
+import type { RAGConfig } from '../../types/index.js';
+export declare class OllamaAdapter implements Embedder {
+    private client;
+    private model;
+    dimensions: number;
+    constructor(config: RAGConfig);
+    embed(text: string): Promise<number[]>;
+    embedBatch(texts: string[]): Promise<number[][]>;
+}
+//# sourceMappingURL=ollama.d.ts.map

package/dist/adapters/embeddings/ollama.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ollama.d.ts","sourceRoot":"","sources":["../../../src/adapters/embeddings/ollama.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAEtD,qBAAa,aAAc,YAAW,QAAQ;IAC5C,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,KAAK,CAAS;IACtB,UAAU,SAAO;gBAEL,MAAM,EAAE,SAAS;IASvB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAQtC,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;CASvD"}

package/dist/adapters/embeddings/ollama.js

@@ -0,0 +1,30 @@
+import { Ollama } from 'ollama';
+export class OllamaAdapter {
+    client;
+    model;
+    dimensions = 768; // nomic-embed-text default dimensions
+    constructor(config) {
+        const baseUrl = config.apiKeys?.ollama?.baseUrl || 'http://localhost:11434';
+        this.model = config.apiKeys?.ollama?.model || 'nomic-embed-text';
+        this.client = new Ollama({
+            host: baseUrl
+        });
+    }
+    async embed(text) {
+        const response = await this.client.embeddings({
+            model: this.model,
+            prompt: text
+        });
+        return response.embedding;
+    }
+    async embedBatch(texts) {
+        // Ollama doesn't support batch embeddings, so do sequentially
+        const embeddings = [];
+        for (const text of texts) {
+            const embedding = await this.embed(text);
+            embeddings.push(embedding);
+        }
+        return embeddings;
+    }
+}
+//# sourceMappingURL=ollama.js.map

package/dist/adapters/embeddings/ollama.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ollama.js","sourceRoot":"","sources":["../../../src/adapters/embeddings/ollama.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAIhC,MAAM,OAAO,aAAa;IAChB,MAAM,CAAS;IACf,KAAK,CAAS;IACtB,UAAU,GAAG,GAAG,CAAC,CAAC,sCAAsC;IAExD,YAAY,MAAiB;QAC3B,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,IAAI,wBAAwB,CAAC;QAC5E,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,IAAI,kBAAkB,CAAC;QAEjE,IAAI,CAAC,MAAM,GAAG,IAAI,MAAM,CAAC;YACvB,IAAI,EAAE,OAAO;SACd,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,IAAY;QACtB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC;YAC5C,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,MAAM,EAAE,IAAI;SACb,CAAC,CAAC;QACH,OAAO,QAAQ,CAAC,SAAS,CAAC;IAC5B,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,KAAe;QAC9B,8DAA8D;QAC9D,MAAM,UAAU,GAAe,EAAE,CAAC;QAClC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YACzC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC7B,CAAC;QACD,OAAO,UAAU,CAAC;IACpB,CAAC;CACF"}

package/dist/adapters/embeddings/openai.d.ts

@@ -0,0 +1,11 @@
+import type { Embedder } from './types.js';
+import type { RAGConfig } from '../../types/index.js';
+export declare class OpenAIAdapter implements Embedder {
+    private client;
+    private model;
+    dimensions: number;
+    constructor(config: RAGConfig);
+    embed(text: string): Promise<number[]>;
+    embedBatch(texts: string[]): Promise<number[][]>;
+}
+//# sourceMappingURL=openai.d.ts.map

package/dist/adapters/embeddings/openai.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai.d.ts","sourceRoot":"","sources":["../../../src/adapters/embeddings/openai.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAEtD,qBAAa,aAAc,YAAW,QAAQ;IAC5C,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,KAAK,CAA4B;IACzC,UAAU,SAAQ;gBAEN,MAAM,EAAE,SAAS;IASvB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAQtC,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;CAOvD"}

package/dist/adapters/embeddings/openai.js

@@ -0,0 +1,28 @@
+import OpenAI from 'openai';
+export class OpenAIAdapter {
+    client;
+    model = 'text-embedding-3-small';
+    dimensions = 1536; // text-embedding-3-small dimensions
+    constructor(config) {
+        const apiKey = config.apiKeys?.openai;
+        if (!apiKey) {
+            throw new Error('OpenAI API key is required for OpenAI embeddings');
+        }
+        this.client = new OpenAI({ apiKey });
+    }
+    async embed(text) {
+        const response = await this.client.embeddings.create({
+            model: this.model,
+            input: text
+        });
+        return response.data[0].embedding;
+    }
+    async embedBatch(texts) {
+        const response = await this.client.embeddings.create({
+            model: this.model,
+            input: texts
+        });
+        return response.data.map(item => item.embedding);
+    }
+}
+//# sourceMappingURL=openai.js.map

package/dist/adapters/embeddings/openai.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai.js","sourceRoot":"","sources":["../../../src/adapters/embeddings/openai.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,QAAQ,CAAC;AAI5B,MAAM,OAAO,aAAa;IAChB,MAAM,CAAS;IACf,KAAK,GAAG,wBAAwB,CAAC;IACzC,UAAU,GAAG,IAAI,CAAC,CAAC,oCAAoC;IAEvD,YAAY,MAAiB;QAC3B,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC;QACtC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;QACtE,CAAC;QAED,IAAI,CAAC,MAAM,GAAG,IAAI,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;IACvC,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,IAAY;QACtB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC;YACnD,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,KAAK,EAAE,IAAI;SACZ,CAAC,CAAC;QACH,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACpC,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,KAAe;QAC9B,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC;YACnD,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,KAAK,EAAE,KAAK;SACb,CAAC,CAAC;QACH,OAAO,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACnD,CAAC;CACF"}

package/dist/adapters/embeddings/types.d.ts

@@ -0,0 +1,6 @@
+export interface Embedder {
+    embed(text: string): Promise<number[]>;
+    embedBatch(texts: string[]): Promise<number[][]>;
+    dimensions: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/adapters/embeddings/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/adapters/embeddings/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,QAAQ;IACvB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACvC,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IACjD,UAAU,EAAE,MAAM,CAAC;CACpB"}

package/dist/adapters/embeddings/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/adapters/embeddings/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/adapters/embeddings/types.ts"],"names":[],"mappings":""}

package/dist/adapters/embeddings/xenova.d.ts

@@ -0,0 +1,11 @@
+import type { Embedder } from './types.js';
+import type { RAGConfig } from '../../types/index.js';
+export declare class XenovaAdapter implements Embedder {
+    private model;
+    dimensions: number;
+    private constructor();
+    static create(config: RAGConfig): Promise<XenovaAdapter>;
+    embed(text: string): Promise<number[]>;
+    embedBatch(texts: string[]): Promise<number[][]>;
+}
+//# sourceMappingURL=xenova.d.ts.map

package/dist/adapters/embeddings/xenova.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"xenova.d.ts","sourceRoot":"","sources":["../../../src/adapters/embeddings/xenova.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAEtD,qBAAa,aAAc,YAAW,QAAQ;IAC5C,OAAO,CAAC,KAAK,CAAM;IACnB,UAAU,SAAO;IAEjB,OAAO;WAIM,MAAM,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC;IASxD,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAQtC,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;CAKvD"}

package/dist/adapters/embeddings/xenova.js

@@ -0,0 +1,26 @@
+import { pipeline } from '@xenova/transformers';
+export class XenovaAdapter {
+    model;
+    dimensions = 384; // all-MiniLM-L6-v2 dimensions
+    constructor(model) {
+        this.model = model;
+    }
+    static async create(config) {
+        // Initialize the embedding model
+        const model = await pipeline('feature-extraction', 'Xenova/all-MiniLM-L6-v2');
+        return new XenovaAdapter(model);
+    }
+    async embed(text) {
+        const output = await this.model(text, {
+            pooling: 'mean',
+            normalize: true
+        });
+        return Array.from(output.data);
+    }
+    async embedBatch(texts) {
+        // Process in parallel
+        const embeddings = await Promise.all(texts.map(text => this.embed(text)));
+        return embeddings;
+    }
+}
+//# sourceMappingURL=xenova.js.map

package/dist/adapters/embeddings/xenova.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"xenova.js","sourceRoot":"","sources":["../../../src/adapters/embeddings/xenova.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAIhD,MAAM,OAAO,aAAa;IAChB,KAAK,CAAM;IACnB,UAAU,GAAG,GAAG,CAAC,CAAC,8BAA8B;IAEhD,YAAoB,KAAU;QAC5B,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,MAAiB;QACnC,iCAAiC;QACjC,MAAM,KAAK,GAAG,MAAM,QAAQ,CAC1B,oBAAoB,EACpB,yBAAyB,CAC1B,CAAC;QACF,OAAO,IAAI,aAAa,CAAC,KAAK,CAAC,CAAC;IAClC,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,IAAY;QACtB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE;YACpC,OAAO,EAAE,MAAM;YACf,SAAS,EAAE,IAAI;SAChB,CAAC,CAAC;QACH,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACjC,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,KAAe;QAC9B,sBAAsB;QACtB,MAAM,UAAU,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC1E,OAAO,UAAU,CAAC;IACpB,CAAC;CACF"}

package/dist/adapters/vector/chroma.d.ts

@@ -0,0 +1,23 @@
+import type { VectorStore, VectorDocument, SearchResult, SearchOptions } from '../../types/index.js';
+import type { RAGConfig } from '../../types/index.js';
+/**
+ * ChromaDB Adapter
+ *
+ * NOTE: ChromaDB JS client requires a running ChromaDB server.
+ * Start one with: docker run -p 8000:8000 chromadb/chroma
+ *
+ * For serverless local storage, use Qdrant instead.
+ */
+export declare class ChromaAdapter implements VectorStore {
+    private client;
+    private collection;
+    private collectionName;
+    private serverUrl;
+    constructor(config: RAGConfig);
+    initialize(): Promise<void>;
+    add(docs: VectorDocument[]): Promise<void>;
+    search(embedding: number[], options: SearchOptions): Promise<SearchResult[]>;
+    delete(ids: string[]): Promise<void>;
+    count(): Promise<number>;
+}
+//# sourceMappingURL=chroma.d.ts.map

package/dist/adapters/vector/chroma.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chroma.d.ts","sourceRoot":"","sources":["../../../src/adapters/vector/chroma.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrG,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAEtD;;;;;;;GAOG;AACH,qBAAa,aAAc,YAAW,WAAW;IAC/C,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,UAAU,CAAM;IACxB,OAAO,CAAC,cAAc,CAA+B;IACrD,OAAO,CAAC,SAAS,CAAS;gBAEd,MAAM,EAAE,SAAS;IAQvB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAqB3B,GAAG,CAAC,IAAI,EAAE,cAAc,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAgB1C,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAgC5E,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAKpC,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC;CAK/B"}