@mcp-monorepo/notion-query 1.1.0 → 1.3.0

package/dist/local-rag/DEMO.d.ts

@@ -0,0 +1,22 @@
+/**
+ * =============================================================================
+ * LocalRAG Self-Contained Demo Script
+ * =============================================================================
+ *
+ * This script is now fully self-contained. It will create its own test data.
+ *
+ * How to Run:
+ * 1. From the root of the `packages/notion-query` directory, run:
+ *    npx ts-node-esm ./src/DEMO.ts
+ *
+ * What this script does:
+ * 1. Cleans up any previous demo database and data directory.
+ * 2. Creates the `./src/data` directory and test files (`rag-intro.txt`, `project-phoenix.md`).
+ * 3. Initializes the LocalRAG library.
+ * 4. Ingests a raw text snippet and the newly created files.
+ * 5. Lists all indexed documents.
+ * 6. Performs a natural language query and prints the results.
+ * 7. Shuts down the RAG instance gracefully.
+ */
+export {};
+//# sourceMappingURL=DEMO.d.ts.map

package/dist/local-rag/DEMO.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DEMO.d.ts","sourceRoot":"","sources":["../../src/local-rag/DEMO.ts"],"names":[],"mappings":"AACA;;;;;;;;;;;;;;;;;;;GAmBG"}

package/dist/local-rag/DEMO.js

@@ -0,0 +1,142 @@
+/* eslint-disable use-logger-not-console/replace-console-with-logger */
+/**
+ * =============================================================================
+ * LocalRAG Self-Contained Demo Script
+ * =============================================================================
+ *
+ * This script is now fully self-contained. It will create its own test data.
+ *
+ * How to Run:
+ * 1. From the root of the `packages/notion-query` directory, run:
+ *    npx ts-node-esm ./src/DEMO.ts
+ *
+ * What this script does:
+ * 1. Cleans up any previous demo database and data directory.
+ * 2. Creates the `./src/data` directory and test files (`rag-intro.txt`, `project-phoenix.md`).
+ * 3. Initializes the LocalRAG library.
+ * 4. Ingests a raw text snippet and the newly created files.
+ * 5. Lists all indexed documents.
+ * 6. Performs a natural language query and prints the results.
+ * 7. Shuts down the RAG instance gracefully.
+ */
+import { mkdir, rm, writeFile } from 'node:fs/promises';
+import { resolve } from 'node:path';
+import { logger } from '@mcp-monorepo/shared';
+import { LocalRAG } from './index.js';
+// --- Demo File Content ---
+const RAG_INTRO_CONTENT = `LocalRAG is a powerful, private, and configurable local library for Retrieval-Augmented Generation.
+This library allows developers to easily build applications that can reason about local files and data.
+Key features include file and folder ingestion, text and URL ingestion, and fast vector-based search.`;
+const HEADING_ONLY = `# Too Small`;
+const PROJECT_PHOENIX_CONTENT = `# Project Phoenix: A Next-Generation AI Assistant
+
+Project Phoenix is a new initiative focused on building an AI assistant that runs entirely on-device.
+It prioritizes user privacy and data security above all else.
+The core technology leverages small, efficient language models combined with a robust vector database for long-term memory.
+The assistant can help with tasks like summarizing documents, answering questions about your local files, and managing your schedule.`;
+/**
+ * Creates the necessary demo data directory and files.
+ * This makes the demo script fully self-contained.
+ * @param dataPath - The path to the directory where data should be created.
+ */
+async function setupDemoData(dataPath) {
+    console.log(`\n--- 2. Setting up demo data in ${dataPath} ---`);
+    try {
+        // Ensure the data directory exists
+        await mkdir(dataPath, { recursive: true });
+        const introFilePath = resolve(dataPath, 'rag-intro.txt');
+        const phoenixFilePath = resolve(dataPath, 'project-phoenix.md');
+        const smallPath = resolve(dataPath, 'small.md');
+        // Write both files asynchronously
+        await Promise.all([
+            writeFile(introFilePath, RAG_INTRO_CONTENT, 'utf-8'),
+            writeFile(phoenixFilePath, PROJECT_PHOENIX_CONTENT, 'utf-8'),
+            writeFile(smallPath, HEADING_ONLY, 'utf-8'),
+        ]);
+        console.log('  -> Created rag-intro.txt');
+        console.log('  -> Created project-phoenix.md');
+        console.log('✅ Demo data created successfully.');
+    }
+    catch (error) {
+        console.error('Failed to create demo data:', error);
+        // If data creation fails, we should stop the demo
+        throw error;
+    }
+}
+// --- Main Demo Function ---
+async function runDemo() {
+    const dbPath = resolve(process.cwd(), '.rag_db_demo');
+    const dataPath = resolve(process.cwd(), 'src', 'data');
+    let rag;
+    console.log('🚀 Starting LocalRAG Demo 🚀');
+    try {
+        // --- 1. Cleanup ---
+        console.log('\n--- 1. Cleaning up previous demo files ---');
+        await Promise.all([rm(dbPath, { recursive: true, force: true }), rm(dataPath, { recursive: true, force: true })]);
+        console.log(`Previous database and data directory removed.`);
+        // --- 2. Create Demo Data ---
+        await setupDemoData(dataPath);
+        // --- 3. Initialize RAG ---
+        console.log('\n--- 3. Initializing LocalRAG ---');
+        rag = await LocalRAG.create({ dbPath });
+        console.log('✅ LocalRAG initialized successfully.');
+        // --- 4. Ingesting Content ---
+        console.log('\n--- 4. Ingesting content ---');
+        await rag.ingestText({
+            label: 'greeting-message',
+            text: 'Hello, world! This is a raw text snippet added to the vector store.',
+            tags: ['test', 'greeting'],
+        });
+        console.log('  -> Ingested a raw text snippet.');
+        await rag.ingestFolder({
+            folderPath: dataPath,
+            project: 'demo-project',
+        });
+        console.log(`  -> Ingested all files from the '${dataPath}' folder.`);
+        console.log('✅ Ingestion complete.');
+        // --- 5. Listing Ingested Documents ---
+        console.log('\n--- 5. Listing all ingested documents ---');
+        const allItems = await rag.list();
+        console.log(`Found ${allItems.length} documents in the store:`);
+        allItems.forEach((item) => {
+            console.log(`  - [${item.metadata?.project}] ${item.filePath} (${item.chunkCount} chunks)`);
+        });
+        // --- 6. Performing a Query ---
+        console.log('\n--- 6. Performing a query ---');
+        const queryText = 'What is a local rag?';
+        console.log(`❓ Query: "${queryText}"\n`);
+        console.time('query');
+        const results = await rag.query({
+            query: queryText,
+            limit: 3,
+        });
+        console.timeEnd('query');
+        console.log('✅ Query completed. Top results:');
+        if (results.length > 0) {
+            results.forEach((result, index) => {
+                console.log(`\n--- Result ${index + 1} (Score: ${result.score.toFixed(4)}) ---`);
+                console.log(`  Source: ${result.filePath}`);
+                console.log(`  Content: "${result.text.trim().replace(/\n/g, ' ')}"`);
+                console.log(`  Metadata: ${JSON.stringify(result.metadata)}`);
+            });
+        }
+        else {
+            console.log('No relevant results found.');
+        }
+    }
+    catch (error) {
+        console.error('\n❌ An error occurred during the demo:', error);
+    }
+    finally {
+        // --- 7. Shutdown ---
+        if (rag) {
+            console.log('\n--- 7. Shutting down LocalRAG ---');
+            await rag.shutdown();
+            logger.close();
+            console.log('✅ Shutdown complete.');
+        }
+    }
+}
+// Run the demo
+runDemo();
+//# sourceMappingURL=DEMO.js.map

package/dist/local-rag/DEMO.js.map

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

package/dist/local-rag/chunker.d.ts

@@ -0,0 +1,24 @@
+export interface ChunkerConfig {
+    chunkSize: number;
+    chunkOverlap: number;
+}
+export interface TextChunk {
+    text: string;
+    index: number;
+}
+/**
+ * Splits text into overlapping chunks for embedding.
+ */
+export declare class DocumentChunker {
+    private readonly splitter;
+    constructor(config: ChunkerConfig);
+    /**
+     * Splits a given text into an array of indexed chunks with intelligent filtering.
+     * If a document is short and results in only one chunk, that chunk is always kept.
+     * For multi-chunk documents, small, noisy chunks are filtered out.
+     * @param text The input text to split.
+     * @returns A promise that resolves to an array of text chunks.
+     */
+    chunkText(text: string): Promise<TextChunk[]>;
+}
+//# sourceMappingURL=chunker.d.ts.map

package/dist/local-rag/chunker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunker.d.ts","sourceRoot":"","sources":["../../src/local-rag/chunker.ts"],"names":[],"mappings":"AAWA,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAA;IACjB,YAAY,EAAE,MAAM,CAAA;CACrB;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;CACd;AAED;;GAEG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAgC;gBAE7C,MAAM,EAAE,aAAa;IAOjC;;;;;;OAMG;IACU,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;CA+B3D"}

package/dist/local-rag/chunker.js

@@ -0,0 +1,58 @@
+import { RecursiveCharacterTextSplitter } from '@langchain/textsplitters';
+import { logger } from '@mcp-monorepo/shared';
+/**
+ * Minimum chunk length in characters.
+ * Chunks shorter than this are filtered out to reduce noise from document
+ * artifacts like page numbers or isolated headings.
+ * This rule does not apply if a document is so short that it only consists of a single chunk.
+ */
+const MIN_CHUNK_LENGTH = 50;
+/**
+ * Splits text into overlapping chunks for embedding.
+ */
+export class DocumentChunker {
+    splitter;
+    constructor(config) {
+        this.splitter = new RecursiveCharacterTextSplitter({
+            chunkSize: config.chunkSize,
+            chunkOverlap: config.chunkOverlap,
+        });
+    }
+    /**
+     * Splits a given text into an array of indexed chunks with intelligent filtering.
+     * If a document is short and results in only one chunk, that chunk is always kept.
+     * For multi-chunk documents, small, noisy chunks are filtered out.
+     * @param text The input text to split.
+     * @returns A promise that resolves to an array of text chunks.
+     */
+    async chunkText(text) {
+        if (!text?.trim()) {
+            return [];
+        }
+        try {
+            const chunks = await this.splitter.splitText(text);
+            // If the document is so short that it only produces one chunk,
+            // we keep it, as it represents the entire content.
+            if (chunks.length === 1) {
+                return [
+                    {
+                        text: chunks[0],
+                        index: 0,
+                    },
+                ];
+            }
+            // For multi-chunk documents, filter out small, noisy chunks to improve quality.
+            return chunks
+                .filter((chunk) => chunk.length >= MIN_CHUNK_LENGTH)
+                .map((chunk, index) => ({
+                text: chunk,
+                index,
+            }));
+        }
+        catch (error) {
+            logger.error('Failed to chunk text:', error);
+            throw error; // Re-throw to be handled by the caller
+        }
+    }
+}
+//# sourceMappingURL=chunker.js.map

package/dist/local-rag/chunker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunker.js","sourceRoot":"","sources":["../../src/local-rag/chunker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,8BAA8B,EAAE,MAAM,0BAA0B,CAAA;AACzE,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAA;AAE7C;;;;;GAKG;AACH,MAAM,gBAAgB,GAAG,EAAE,CAAA;AAY3B;;GAEG;AACH,MAAM,OAAO,eAAe;IACT,QAAQ,CAAgC;IAEzD,YAAY,MAAqB;QAC/B,IAAI,CAAC,QAAQ,GAAG,IAAI,8BAA8B,CAAC;YACjD,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,YAAY,EAAE,MAAM,CAAC,YAAY;SAClC,CAAC,CAAA;IACJ,CAAC;IAED;;;;;;OAMG;IACI,KAAK,CAAC,SAAS,CAAC,IAAY;QACjC,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC;YAClB,OAAO,EAAE,CAAA;QACX,CAAC;QAED,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,CAAA;YAElD,+DAA+D;YAC/D,mDAAmD;YACnD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACxB,OAAO;oBACL;wBACE,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;wBACf,KAAK,EAAE,CAAC;qBACT;iBACF,CAAA;YACH,CAAC;YAED,gFAAgF;YAChF,OAAO,MAAM;iBACV,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,IAAI,gBAAgB,CAAC;iBACnD,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;gBACtB,IAAI,EAAE,KAAK;gBACX,KAAK;aACN,CAAC,CAAC,CAAA;QACP,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,uBAAuB,EAAE,KAAK,CAAC,CAAA;YAC5C,MAAM,KAAK,CAAA,CAAC,uCAAuC;QACrD,CAAC;IACH,CAAC;CACF"}

package/dist/local-rag/embedder.d.ts

@@ -0,0 +1,43 @@
+import type { PoolConfig } from './types.js';
+export interface EmbedderConfig {
+    modelPath: string;
+    /**
+     * The number of texts to process in a single batch sent to a worker.
+     * @default 32
+     **/
+    batchSize?: number;
+    cacheDir: string;
+    poolConfig?: PoolConfig;
+}
+/**
+ * Manages the embedding process by offloading the CPU-intensive work to a pool of worker threads.
+ * This class acts as a proxy to the actual embedding logic, keeping the main thread non-blocking.
+ */
+export declare class Embedder {
+    private readonly pool;
+    private readonly batchSize;
+    private constructor();
+    /**
+     * Creates and initializes an Embedder instance.
+     * It ensures the model is downloaded and cached before creating worker threads.
+     */
+    static create(config: EmbedderConfig): Promise<Embedder>;
+    /**
+     * Generates an embedding vector for a single string of text.
+     * @param text The text to embed.
+     * @returns A promise that resolves to a numeric vector.
+     */
+    embed(text: string): Promise<number[]>;
+    /**
+     * Generates embedding vectors for an array of texts in batches using the worker pool.
+     * This is much more efficient than calling `embed` for each text individually.
+     * @param texts An array of texts to embed.
+     * @returns A promise that resolves to an array of numeric vectors.
+     */
+    embedBatch(texts: string[]): Promise<number[][]>;
+    /**
+     * Gracefully shuts down all worker threads.
+     */
+    destroy(): Promise<void>;
+}
+//# sourceMappingURL=embedder.d.ts.map

package/dist/local-rag/embedder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedder.d.ts","sourceRoot":"","sources":["../../src/local-rag/embedder.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAE5C,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAA;IACjB;;;QAGI;IACJ,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,EAAE,MAAM,CAAA;IAChB,UAAU,CAAC,EAAE,UAAU,CAAA;CACxB;AAED;;;GAGG;AACH,qBAAa,QAAQ;IACnB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAY;IACjC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAQ;IAElC,OAAO;IAKP;;;OAGG;WACiB,MAAM,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,QAAQ,CAAC;IAiBrE;;;;OAIG;IACU,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAWnD;;;;;OAKG;IACU,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;IAsB7D;;OAEG;IACU,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAGtC"}

package/dist/local-rag/embedder.js

@@ -0,0 +1,74 @@
+import { EmbeddingService } from './embedder.service.js';
+import { EmbeddingError } from './errors.js';
+import { WorkerPool } from './utils/pool.js';
+/**
+ * Manages the embedding process by offloading the CPU-intensive work to a pool of worker threads.
+ * This class acts as a proxy to the actual embedding logic, keeping the main thread non-blocking.
+ */
+export class Embedder {
+    pool;
+    batchSize;
+    constructor(config, pool) {
+        this.batchSize = config.batchSize ?? 32;
+        this.pool = pool;
+    }
+    /**
+     * Creates and initializes an Embedder instance.
+     * It ensures the model is downloaded and cached before creating worker threads.
+     */
+    static async create(config) {
+        await EmbeddingService.primeCache(config.modelPath, config.cacheDir);
+        const workerPath = new URL('./embedder.worker.js', import.meta.url);
+        const pool = new WorkerPool(workerPath, {
+            modelPath: config.modelPath,
+            cacheDir: config.cacheDir,
+        }, config.poolConfig);
+        return new Embedder(config, pool);
+    }
+    /**
+     * Generates an embedding vector for a single string of text.
+     * @param text The text to embed.
+     * @returns A promise that resolves to a numeric vector.
+     */
+    async embed(text) {
+        if (text.trim().length === 0) {
+            throw new EmbeddingError('Cannot generate embedding for empty text.');
+        }
+        const task = {
+            type: 'embed',
+            payload: { text },
+        };
+        return this.pool.runTask(task);
+    }
+    /**
+     * Generates embedding vectors for an array of texts in batches using the worker pool.
+     * This is much more efficient than calling `embed` for each text individually.
+     * @param texts An array of texts to embed.
+     * @returns A promise that resolves to an array of numeric vectors.
+     */
+    async embedBatch(texts) {
+        if (texts.length === 0) {
+            return [];
+        }
+        const batches = [];
+        for (let i = 0; i < texts.length; i += this.batchSize) {
+            batches.push(texts.slice(i, i + this.batchSize));
+        }
+        const batchPromises = batches.map((batch) => {
+            const task = {
+                type: 'embedBatch',
+                payload: { texts: batch },
+            };
+            return this.pool.runTask(task);
+        });
+        const results = await Promise.all(batchPromises);
+        return results.flat();
+    }
+    /**
+     * Gracefully shuts down all worker threads.
+     */
+    async destroy() {
+        await this.pool.destroy();
+    }
+}
+//# sourceMappingURL=embedder.js.map

package/dist/local-rag/embedder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedder.js","sourceRoot":"","sources":["../../src/local-rag/embedder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAC5C,OAAO,EAAE,UAAU,EAAsB,MAAM,iBAAiB,CAAA;AAehE;;;GAGG;AACH,MAAM,OAAO,QAAQ;IACF,IAAI,CAAY;IAChB,SAAS,CAAQ;IAElC,YAAoB,MAAsB,EAAE,IAAgB;QAC1D,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS,IAAI,EAAE,CAAA;QACvC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;IAClB,CAAC;IAED;;;OAGG;IACI,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,MAAsB;QAC/C,MAAM,gBAAgB,CAAC,UAAU,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAA;QAEpE,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,sBAAsB,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;QAEnE,MAAM,IAAI,GAAG,IAAI,UAAU,CACzB,UAAU,EACV;YACE,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,QAAQ,EAAE,MAAM,CAAC,QAAQ;SAC1B,EACD,MAAM,CAAC,UAAU,CAClB,CAAA;QAED,OAAO,IAAI,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,CAAA;IACnC,CAAC;IAED;;;;OAIG;IACI,KAAK,CAAC,KAAK,CAAC,IAAY;QAC7B,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC7B,MAAM,IAAI,cAAc,CAAC,2CAA2C,CAAC,CAAA;QACvE,CAAC;QACD,MAAM,IAAI,GAAkB;YAC1B,IAAI,EAAE,OAAO;YACb,OAAO,EAAE,EAAE,IAAI,EAAE;SAClB,CAAA;QACD,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;IAChC,CAAC;IAED;;;;;OAKG;IACI,KAAK,CAAC,UAAU,CAAC,KAAe;QACrC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,OAAO,EAAE,CAAA;QACX,CAAC;QAED,MAAM,OAAO,GAAe,EAAE,CAAA;QAC9B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACtD,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAA;QAClD,CAAC;QAED,MAAM,aAAa,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;YAC1C,MAAM,IAAI,GAAkB;gBAC1B,IAAI,EAAE,YAAY;gBAClB,OAAO,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE;aAC1B,CAAA;YACD,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAwB,CAAA;QACvD,CAAC,CAAC,CAAA;QAEF,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAA;QAChD,OAAO,OAAO,CAAC,IAAI,EAAE,CAAA;IACvB,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,OAAO;QAClB,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAA;IAC3B,CAAC;CACF"}

package/dist/local-rag/embedder.service.d.ts

@@ -0,0 +1,15 @@
+export declare class EmbeddingService {
+    private model;
+    private initPromise;
+    /**
+     * Static method to ensure the model is downloaded to the cache directory.
+     * This should be called from the main thread before any workers are created
+     * to prevent a download race condition.
+     */
+    static primeCache(modelPath: string, cacheDir: string): Promise<void>;
+    ensureInitialized(modelPath: string, cacheDir: string): Promise<void>;
+    embed(text: string): Promise<number[]>;
+    embed(text: string[]): Promise<number[][]>;
+    private static getFeatureExtractionPipeline;
+}
+//# sourceMappingURL=embedder.service.d.ts.map

package/dist/local-rag/embedder.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedder.service.d.ts","sourceRoot":"","sources":["../../src/local-rag/embedder.service.ts"],"names":[],"mappings":"AAKA,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,KAAK,CAAmD;IAChE,OAAO,CAAC,WAAW,CAAuC;IAE1D;;;;OAIG;WACiB,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAkBrE,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAerE,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IACtC,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;IAiCvD,OAAO,CAAC,MAAM,CAAC,4BAA4B,CAK1C;CACF"}

package/dist/local-rag/embedder.service.js

@@ -0,0 +1,84 @@
+import { env, pipeline } from '@huggingface/transformers';
+import { logger } from '@mcp-monorepo/shared';
+import { EmbeddingError } from './errors.js';
+export class EmbeddingService {
+    model = undefined;
+    initPromise = undefined;
+    /**
+     * Static method to ensure the model is downloaded to the cache directory.
+     * This should be called from the main thread before any workers are created
+     * to prevent a download race condition.
+     */
+    static async primeCache(modelPath, cacheDir) {
+        try {
+            env.cacheDir = cacheDir;
+            logger.info(`Main thread: Priming model cache for "${modelPath}"...`);
+            // We call pipeline() here just to trigger the download if the model is not cached.
+            // The returned pipeline instance is discarded as we don't need it in the main thread.
+            await EmbeddingService.getFeatureExtractionPipeline(modelPath, {
+                progress_callback: (info) => {
+                    if (info.status === 'progress')
+                        logger.info(`Downloading model: ${info.file} [${Math.round(info.progress)}%]`);
+                },
+            });
+            logger.info('Main thread: Model cache is ready.');
+        }
+        catch (error) {
+            throw new EmbeddingError('Main thread failed to prime the model cache.', error);
+        }
+    }
+    async ensureInitialized(modelPath, cacheDir) {
+        if (this.model)
+            return;
+        if (this.initPromise)
+            return this.initPromise;
+        this.initPromise = (async () => {
+            try {
+                env.cacheDir = cacheDir;
+                this.model = await EmbeddingService.getFeatureExtractionPipeline(modelPath);
+            }
+            catch (error) {
+                this.initPromise = undefined;
+                throw new EmbeddingError(`Worker failed to initialize embedding model.`, error);
+            }
+        })();
+        return this.initPromise;
+    }
+    async embed(text) {
+        if (!this.model) {
+            throw new EmbeddingError('Worker model not available. ensureInitialized must be called first.');
+        }
+        const texts = Array.isArray(text) ? text : [text];
+        if (texts.some((t) => t.trim().length === 0)) {
+            throw new EmbeddingError('Cannot generate embedding for empty text.');
+        }
+        try {
+            const output = await this.model(texts, { pooling: 'mean', normalize: true });
+            // The output shape depends on whether the input was a single string or an array.
+            // We normalize it to always be an array of vectors for consistency.
+            if (!Array.isArray(text)) {
+                // Input was a single string, result is a 1D tensor represented as a 2D array [1, dim]
+                return Array.from(output.data);
+            }
+            else {
+                // Input was an array, result is a 2D tensor. We need to slice it.
+                const vectors = [];
+                const vectorSize = output.dims[1];
+                if (vectorSize !== 384)
+                    throw new EmbeddingError(`Unexpected vector size. Expected 384, got ${vectorSize}.`);
+                const flatData = output.data;
+                for (let i = 0; i < output.dims[0]; i++) {
+                    vectors.push(Array.from(flatData.slice(i * vectorSize, (i + 1) * vectorSize)));
+                }
+                return vectors;
+            }
+        }
+        catch (error) {
+            throw new EmbeddingError('Worker failed to generate embedding for text.', error);
+        }
+    }
+    static getFeatureExtractionPipeline = (model, opts) => {
+        return pipeline('feature-extraction', model, opts);
+    };
+}
+//# sourceMappingURL=embedder.service.js.map

package/dist/local-rag/embedder.service.js.map

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

package/dist/local-rag/embedder.worker.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=embedder.worker.d.ts.map

package/dist/local-rag/embedder.worker.d.ts.map

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

package/dist/local-rag/embedder.worker.js

@@ -0,0 +1,34 @@
+import { parentPort, workerData } from 'node:worker_threads';
+import { EmbeddingService } from './embedder.service.js';
+if (!parentPort)
+    throw new Error('This script must be run as a worker thread.');
+const embeddingService = new EmbeddingService();
+const { modelPath, cacheDir } = workerData;
+const initPromise = embeddingService.ensureInitialized(modelPath, cacheDir);
+function serializeError(error) {
+    if (error instanceof Error) {
+        return { name: error.name, message: error.message, stack: error.stack, cause: error.cause };
+    }
+    return { name: 'UnknownError', message: String(error) };
+}
+parentPort.on('message', async (data) => {
+    const { task, taskId } = data;
+    try {
+        await initPromise;
+        if (task.type === 'embed') {
+            const vector = await embeddingService.embed(task.payload.text);
+            const result = { taskId, status: 'success', result: vector };
+            parentPort?.postMessage(result);
+        }
+        else if (task.type === 'embedBatch') {
+            const vectors = await embeddingService.embed(task.payload.texts);
+            const result = { taskId, status: 'success', result: vectors };
+            parentPort?.postMessage(result);
+        }
+    }
+    catch (e) {
+        const result = { taskId, status: 'error', error: serializeError(e) };
+        parentPort?.postMessage(result);
+    }
+});
+//# sourceMappingURL=embedder.worker.js.map

package/dist/local-rag/embedder.worker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedder.worker.js","sourceRoot":"","sources":["../../src/local-rag/embedder.worker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAA;AAE5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AAGxD,IAAI,CAAC,UAAU;IAAE,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAA;AAE/E,MAAM,gBAAgB,GAAG,IAAI,gBAAgB,EAAE,CAAA;AAC/C,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,GAAG,UAAqD,CAAA;AACrF,MAAM,WAAW,GAAG,gBAAgB,CAAC,iBAAiB,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAA;AAE3E,SAAS,cAAc,CAAC,KAAc;IACpC,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAA;IAC7F,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,CAAA;AACzD,CAAC;AAED,UAAU,CAAC,EAAE,CAAC,SAAS,EAAE,KAAK,EAAE,IAA6C,EAAE,EAAE;IAC/E,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,CAAA;IAC7B,IAAI,CAAC;QACH,MAAM,WAAW,CAAA;QACjB,IAAI,IAAI,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;YAC1B,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;YAC9D,MAAM,MAAM,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,CAAA;YAC5D,UAAU,EAAE,WAAW,CAAC,MAAM,CAAC,CAAA;QACjC,CAAC;aAAM,IAAI,IAAI,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;YACtC,MAAM,OAAO,GAAG,MAAM,gBAAgB,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;YAChE,MAAM,MAAM,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,CAAA;YAC7D,UAAU,EAAE,WAAW,CAAC,MAAM,CAAC,CAAA;QACjC,CAAC;IACH,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,MAAM,MAAM,GAAoB,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,cAAc,CAAC,CAAC,CAAC,EAAE,CAAA;QACrF,UAAU,EAAE,WAAW,CAAC,MAAM,CAAC,CAAA;IACjC,CAAC;AACH,CAAC,CAAC,CAAA"}

package/dist/local-rag/errors.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Represents an error due to invalid user input or configuration.
+ * Maps to a 400 Bad Request in a server context.
+ */
+export declare class ValidationError extends Error {
+    readonly cause?: unknown | undefined;
+    constructor(message: string, cause?: unknown | undefined);
+}
+/**
+ * Represents an error during a file system operation.
+ * Maps to a 500 Internal Server Error in a server context.
+ */
+export declare class FileOperationError extends Error {
+    readonly cause?: unknown | undefined;
+    constructor(message: string, cause?: unknown | undefined);
+}
+/**
+ * Represents an error related to the embedding model.
+ */
+export declare class EmbeddingError extends Error {
+    readonly cause?: unknown | undefined;
+    constructor(message: string, cause?: unknown | undefined);
+}
+/**
+ * Represents an error related to the vector database.
+ */
+export declare class DatabaseError extends Error {
+    readonly cause?: unknown | undefined;
+    constructor(message: string, cause?: unknown | undefined);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/local-rag/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/local-rag/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,qBAAa,eAAgB,SAAQ,KAAK;aAGtB,KAAK,CAAC,EAAE,OAAO;gBAD/B,OAAO,EAAE,MAAM,EACC,KAAK,CAAC,EAAE,OAAO,YAAA;CAKlC;AAED;;;GAGG;AACH,qBAAa,kBAAmB,SAAQ,KAAK;aAGzB,KAAK,CAAC,EAAE,OAAO;gBAD/B,OAAO,EAAE,MAAM,EACC,KAAK,CAAC,EAAE,OAAO,YAAA;CAKlC;AAED;;GAEG;AACH,qBAAa,cAAe,SAAQ,KAAK;aAGrB,KAAK,CAAC,EAAE,OAAO;gBAD/B,OAAO,EAAE,MAAM,EACC,KAAK,CAAC,EAAE,OAAO,YAAA;CAKlC;AAED;;GAEG;AACH,qBAAa,aAAc,SAAQ,KAAK;aAGpB,KAAK,CAAC,EAAE,OAAO;gBAD/B,OAAO,EAAE,MAAM,EACC,KAAK,CAAC,EAAE,OAAO,YAAA;CAKlC"}

package/dist/local-rag/errors.js

@@ -0,0 +1,47 @@
+/**
+ * Represents an error due to invalid user input or configuration.
+ * Maps to a 400 Bad Request in a server context.
+ */
+export class ValidationError extends Error {
+    cause;
+    constructor(message, cause) {
+        super(message);
+        this.cause = cause;
+        this.name = 'ValidationError';
+    }
+}
+/**
+ * Represents an error during a file system operation.
+ * Maps to a 500 Internal Server Error in a server context.
+ */
+export class FileOperationError extends Error {
+    cause;
+    constructor(message, cause) {
+        super(message);
+        this.cause = cause;
+        this.name = 'FileOperationError';
+    }
+}
+/**
+ * Represents an error related to the embedding model.
+ */
+export class EmbeddingError extends Error {
+    cause;
+    constructor(message, cause) {
+        super(message);
+        this.cause = cause;
+        this.name = 'EmbeddingError';
+    }
+}
+/**
+ * Represents an error related to the vector database.
+ */
+export class DatabaseError extends Error {
+    cause;
+    constructor(message, cause) {
+        super(message);
+        this.cause = cause;
+        this.name = 'DatabaseError';
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/local-rag/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/local-rag/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,OAAO,eAAgB,SAAQ,KAAK;IAGtB;IAFlB,YACE,OAAe,EACC,KAAe;QAE/B,KAAK,CAAC,OAAO,CAAC,CAAA;QAFE,UAAK,GAAL,KAAK,CAAU;QAG/B,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAA;IAC/B,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAGzB;IAFlB,YACE,OAAe,EACC,KAAe;QAE/B,KAAK,CAAC,OAAO,CAAC,CAAA;QAFE,UAAK,GAAL,KAAK,CAAU;QAG/B,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAA;IAClC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,cAAe,SAAQ,KAAK;IAGrB;IAFlB,YACE,OAAe,EACC,KAAe;QAE/B,KAAK,CAAC,OAAO,CAAC,CAAA;QAFE,UAAK,GAAL,KAAK,CAAU;QAG/B,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAA;IAC9B,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,aAAc,SAAQ,KAAK;IAGpB;IAFlB,YACE,OAAe,EACC,KAAe;QAE/B,KAAK,CAAC,OAAO,CAAC,CAAA;QAFE,UAAK,GAAL,KAAK,CAAU;QAG/B,IAAI,CAAC,IAAI,GAAG,eAAe,CAAA;IAC7B,CAAC;CACF"}