@mcp-monorepo/notion-query 1.1.0 → 1.3.0

package/dist/local-rag/parser.js

@@ -0,0 +1,206 @@
+import { readFile, stat } from 'node:fs/promises';
+import { extname, isAbsolute, resolve } from 'node:path';
+import mammoth from 'mammoth';
+import * as Parse from 'papaparse';
+import { PDFParse } from 'pdf-parse';
+import { FileOperationError, ValidationError } from './errors.js';
+/**
+ * Supported code file extensions mapped to a language name.
+ */
+const CODE_EXTENSIONS = {
+    '.ts': 'typescript',
+    '.tsx': 'typescript',
+    '.js': 'javascript',
+    '.jsx': 'javascript',
+    '.py': 'python',
+    '.java': 'java',
+    '.go': 'go',
+    '.rs': 'rust',
+    '.c': 'c',
+    '.cpp': 'cpp',
+    '.cc': 'cpp',
+    '.cxx': 'cpp',
+    '.h': 'c',
+    '.hpp': 'cpp',
+    '.rb': 'ruby',
+    '.php': 'php',
+    '.cs': 'csharp',
+    '.sh': 'bash',
+    '.sql': 'sql',
+    '.json': 'json',
+    '.csv': 'csv',
+};
+/**
+ * Parses text content from various file formats.
+ * Extracts basic metadata and transforms structured content for better RAG performance.
+ */
+export class DocumentParser {
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    /**
+     * Parses a file, automatically detecting its format.
+     * @param filePath - The path to the file to parse.
+     * @returns The extracted text, detected language (for code files), and file size.
+     */
+    async parseFile(filePath) {
+        this.validateFilePath(filePath);
+        const { fileSize, fileCreatedAt, fileModifiedAt } = await this.validateAndGetFileStats(filePath);
+        const baseMetadata = { fileCreatedAt, fileModifiedAt };
+        const ext = extname(filePath).toLowerCase();
+        const language = this.detectLanguage(filePath);
+        let parsedContent;
+        if (language && !['.json', '.csv'].includes(ext)) {
+            parsedContent = { text: await this.parseAsPlainText(filePath) };
+        }
+        else {
+            switch (ext) {
+                case '.pdf':
+                    parsedContent = await this.parsePdf(filePath);
+                    break;
+                case '.docx':
+                    parsedContent = await this.parseDocx(filePath);
+                    break;
+                case '.json':
+                    parsedContent = { text: await this.parseJson(filePath) };
+                    break;
+                case '.csv':
+                    parsedContent = { text: await this.parseStructuredCsv(filePath) };
+                    break;
+                case '.txt':
+                case '.md':
+                case '.markdown':
+                    parsedContent = { text: await this.parseAsPlainText(filePath) };
+                    break;
+                default:
+                    throw new ValidationError(`Unsupported file format: ${ext}`);
+            }
+        }
+        return {
+            text: parsedContent.text,
+            language,
+            fileSize,
+            metadata: { ...baseMetadata, ...parsedContent.metadata },
+        };
+    }
+    /**
+     * Returns a list of all supported file extensions.
+     * @returns An array of file extensions (e.g., ['.pdf', '.ts', '.md']).
+     */
+    getSupportedExtensions() {
+        const documentExts = ['.pdf', '.docx', '.txt', '.md', '.markdown', '.json', '.csv'];
+        const codeExts = Object.keys(CODE_EXTENSIONS);
+        return [...new Set([...documentExts, ...codeExts])];
+    }
+    /**
+     * Validates that a file path is absolute and within the configured `baseDir`.
+     * @param filePath - The absolute path to validate.
+     * @throws {ValidationError} If the path is invalid or outside the security boundary.
+     */
+    validateFilePath(filePath) {
+        if (!isAbsolute(filePath)) {
+            throw new ValidationError(`File path must be absolute. Received: ${filePath}`);
+        }
+        const baseDir = resolve(this.config.baseDir);
+        const normalizedPath = resolve(filePath);
+        if (!normalizedPath.startsWith(baseDir)) {
+            throw new ValidationError(`File path is outside the allowed base directory. Base: ${baseDir}, Path: ${filePath}`);
+        }
+    }
+    /**
+     * Validates that a file's size is within the configured limit.
+     * @param filePath - The path to the file to check.
+     * @returns The file size in bytes.
+     * @throws {ValidationError} If the file is too large.
+     * @throws {FileOperationError} If the file stats cannot be read.
+     */
+    async validateAndGetFileStats(filePath) {
+        try {
+            const stats = await stat(filePath);
+            if (stats.size > this.config.maxFileSize) {
+                throw new ValidationError(`File size ${stats.size} exceeds limit of ${this.config.maxFileSize} bytes.`);
+            }
+            return {
+                fileSize: stats.size,
+                fileCreatedAt: stats.birthtime.toISOString(),
+                fileModifiedAt: stats.mtime.toISOString(),
+            };
+        }
+        catch (error) {
+            if (error instanceof ValidationError)
+                throw error;
+            throw new FileOperationError(`Failed to get file stats: ${filePath}`, error);
+        }
+    }
+    detectLanguage(filePath) {
+        return CODE_EXTENSIONS[extname(filePath).toLowerCase()];
+    }
+    async parsePdf(filePath) {
+        try {
+            const buffer = await readFile(filePath);
+            const pdf = new PDFParse({ data: buffer });
+            const data = await pdf.getText();
+            const info = await pdf.getInfo();
+            const author = info.info.Author?.trim();
+            return { text: data.text, metadata: { author } };
+        }
+        catch (error) {
+            throw new FileOperationError(`Failed to parse PDF: ${filePath}`, error);
+        }
+    }
+    async parseDocx(filePath) {
+        try {
+            // Note: mammoth.extractRawText does not support metadata extraction (e.g., author).
+            // A more complex setup would be needed to get this information.
+            const { value } = await mammoth.extractRawText({ path: filePath });
+            return { text: value, metadata: {} };
+        }
+        catch (error) {
+            throw new FileOperationError(`Failed to parse DOCX: ${filePath}`, error);
+        }
+    }
+    async parseJson(filePath) {
+        try {
+            const content = await readFile(filePath, 'utf-8');
+            const data = JSON.parse(content);
+            // Pretty-print the JSON to make it more readable for the LLM.
+            return JSON.stringify(data, undefined, 2);
+        }
+        catch (error) {
+            throw new FileOperationError(`Failed to parse JSON: ${filePath}`, error);
+        }
+    }
+    /**
+     * Parses CSV into a text format where each row preserves the header context.
+     * This is crucial for the semantic meaning of chunks.
+     */
+    async parseStructuredCsv(filePath) {
+        try {
+            const content = await readFile(filePath, 'utf-8');
+            const result = Parse.parse(content, { header: true, skipEmptyLines: true });
+            if (result.errors.length > 0) {
+                throw new Error(`CSV parsing errors: ${result.errors.map((e) => e.message).join(', ')}`);
+            }
+            // Convert each row object into a descriptive string.
+            // E.g., { "name": "Alice", "age": 30 } becomes "name: Alice, age: 30"
+            return result.data
+                .map((row) => Object.entries(row)
+                .map(([key, value]) => `${key.trim()}: ${value?.trim() ?? ''}`)
+                .join(', '))
+                .join('\n');
+        }
+        catch (error) {
+            throw new FileOperationError(`Failed to parse CSV: ${filePath}`, error);
+        }
+    }
+    async parseAsPlainText(filePath) {
+        try {
+            return await readFile(filePath, 'utf-8');
+        }
+        catch (error) {
+            throw new FileOperationError(`Failed to read text file: ${filePath}`, error);
+        }
+    }
+}
+//# sourceMappingURL=parser.js.map

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

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

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

@@ -0,0 +1,209 @@
+/**
+ * Configuration options for the LocalRAG instance.
+ */
+export interface LocalRAGConfig {
+    /** Path to the LanceDB database directory. */
+    dbPath: string;
+    /** Path to the directory for caching embedding models. */
+    cacheDir?: string;
+    /** The root directory to which file access is restricted for security. */
+    baseDir?: string;
+    /** HuggingFace model identifier for text embeddings. */
+    modelName?: string;
+    /** Maximum file size in bytes for ingestion. Defaults to 100MB. */
+    maxFileSize?: number;
+    /** The target size of each text chunk in characters. */
+    chunkSize?: number;
+    /** The number of characters to overlap between adjacent chunks. */
+    chunkOverlap?: number;
+    /**
+     * The debounce time in milliseconds for file watcher events to avoid rapid re-indexing.
+     * @default 5000
+     */
+    debounceMs?: number;
+    /**
+     * Interval in milliseconds to automatically run the cleanup job for expired documents.
+     * If not set, cleanup must be triggered manually.
+     * @example 86400000 (for 24 hours)
+     */
+    cleanupIntervalMs?: number;
+    /**
+     * Interval in milliseconds to automatically run the database optimization job (compacts files, rebuilds indexes).
+     * Recommended for write-heavy applications.
+     * @example 3600000 (for 1 hour)
+     */
+    optimizeIntervalMs?: number;
+    /** Advanced options for tuning the retrieval process. */
+    retrievalOptions?: RetrievalOptions;
+    /** Configuration for the embedding worker pool. */
+    poolConfig?: PoolConfig;
+}
+/**
+ * Configuration options for the dynamic worker pool.
+ */
+export interface PoolConfig {
+    /**
+     * The maximum number of workers the pool can scale up to.
+     * Defaults to the number of CPU cores minus one.
+     */
+    maxWorkers?: number;
+    /**
+     * The minimum number of workers to keep alive, even if idle.
+     * @default 0
+     */
+    minWorkers?: number;
+    /**
+     * The time in milliseconds an idle worker will wait before being terminated.
+     * Set to 0 to disable automatic scaling down.
+     * @default 1800000 (30 minutes)
+     */
+    idleTimeoutMs?: number;
+}
+/**
+ * Represents a persisted watched path in the database.
+ */
+export interface WatchedPath {
+    path: string;
+    type: 'file' | 'folder';
+    recursive: boolean;
+    addedAt: string;
+}
+/**
+ * Advanced options for tuning search and retrieval.
+ */
+export interface RetrievalOptions {
+    /**
+     * The weight of keyword (BM25) search vs. semantic (vector) search in hybrid search.
+     * 0.0 = Purely semantic, 1.0 = Purely keyword.
+     * Recommended for code/technical docs: 0.6 - 0.7.
+     * @default 0.6
+     */
+    hybridWeight?: number;
+    /**
+     * Filters results by detecting relevance gaps.
+     * - 'similar': Returns only the most relevant group of results.
+     * - 'related': Returns the top two most relevant groups.
+     * - undefined: No grouping, returns all results up to the limit.
+     */
+    grouping?: GroupingMode;
+    /**
+     * An absolute distance threshold. Results with a score greater than this are discarded.
+     * For dot product, a lower score is better (0 = identical).
+     * E.g., a value of 0.5 would filter out less relevant matches.
+     */
+    maxDistance?: number;
+}
+export type GroupingMode = 'similar' | 'related';
+/**
+ * Metadata associated with an ingested document or text snippet.
+ */
+export interface DocumentMetadata {
+    fileName: string;
+    fileSize: number;
+    fileType: string;
+    language?: string;
+    tags?: string[];
+    project?: string;
+    memoryType?: 'file' | 'text' | 'url';
+    expiresAt?: string;
+    createdAt: string;
+    updatedAt: string;
+    sourceUrl?: string;
+    author?: string;
+    fileCreatedAt?: string;
+    fileModifiedAt?: string;
+}
+/**
+ * A chunk of text ready to be inserted into the vector store.
+ */
+export interface VectorChunk {
+    id: string;
+    filePath: string;
+    chunkIndex: number;
+    text: string;
+    vector: number[];
+    metadata?: DocumentMetadata;
+    timestamp: string;
+}
+export interface WatchOptions {
+    /** For folders, specifies whether to watch subdirectories. @default false */
+    recursive?: boolean;
+}
+export interface IngestFileInput {
+    filePath: string;
+    tags?: string[];
+    project?: string;
+    /** If true, the file will be monitored for changes. */
+    watch?: boolean;
+}
+export interface IngestFolderInput {
+    folderPath: string;
+    tags?: string[];
+    project?: string;
+    /** If true, the folder will be monitored for new, changed, and deleted files. */
+    watch?: boolean;
+    /** If true, subdirectories will also be processed and watched. @default false */
+    recursive?: boolean;
+}
+export interface IngestTextInupt {
+    text: string;
+    label: string;
+    language?: string;
+    tags?: string[];
+    project?: string;
+    ttl?: string;
+}
+export interface IngestUrlInput {
+    url: string;
+    tags?: string[];
+    project?: string;
+    ttl?: string;
+}
+export interface QueryInput {
+    query: string;
+    limit?: number;
+    filters?: QueryFilters;
+}
+export interface QueryFilters {
+    type?: 'file' | 'text' | 'url';
+    tags?: string[];
+    project?: string;
+    fileName?: string;
+}
+export interface QueryResult {
+    filePath: string;
+    chunkIndex: number;
+    text: string;
+    score: number;
+    metadata?: DocumentMetadata;
+}
+export interface UpdateMemoryInput {
+    label: string;
+    mode?: 'replace' | 'append' | 'prepend';
+    text?: string;
+    tags?: string[];
+    addTags?: string[];
+    removeTags?: string[];
+}
+export interface ListOptions {
+    /** The number of items to return. @default 20 */
+    limit?: number;
+    /** The number of items to skip for pagination. @default 0 */
+    offset?: number;
+    filters?: QueryFilters;
+}
+export interface ListItem {
+    filePath: string;
+    chunkCount: number;
+    timestamp: string;
+    metadata?: DocumentMetadata;
+}
+export interface StatusReport {
+    documentCount: number;
+    chunkCount: number;
+    memoryUsageMb: number;
+    uptimeSeconds: number;
+    ftsIndexEnabled: boolean;
+    searchMode: 'hybrid' | 'vector-only';
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/local-rag/types.js

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/local-rag/types.ts"],"names":[],"mappings":"AAAA,+CAA+C;AAC/C,qBAAqB;AACrB,+CAA+C"}

package/dist/local-rag/utils/pool.d.ts

@@ -0,0 +1,60 @@
+import type { PoolConfig } from '../types.js';
+export interface SerializedError {
+    name: string;
+    message: string;
+    stack?: string;
+    cause?: unknown;
+}
+export type EmbeddingTask = {
+    type: 'embed';
+    payload: {
+        text: string;
+    };
+} | {
+    type: 'embedBatch';
+    payload: {
+        texts: string[];
+    };
+};
+export type EmbeddingSuccess = {
+    taskId: number;
+    status: 'success';
+    type: 'embed';
+    result: number[];
+} | {
+    taskId: number;
+    status: 'success';
+    type: 'embedBatch';
+    result: number[][];
+};
+export type EmbeddingResult = EmbeddingSuccess | {
+    taskId: number;
+    status: 'error';
+    error: SerializedError;
+};
+export declare class WorkerPool {
+    private readonly workerPath;
+    private readonly workerData;
+    private readonly config;
+    private workers;
+    private readonly taskQueue;
+    private taskIdCounter;
+    private workerIdCounter;
+    private readonly activeTasks;
+    private idleCheckInterval;
+    constructor(workerPath: URL, workerData: object, config?: PoolConfig);
+    runTask(task: EmbeddingTask & {
+        type: 'embed';
+    }): Promise<number[]>;
+    runTask(task: EmbeddingTask & {
+        type: 'embedBatch';
+    }): Promise<number[][]>;
+    private _dispatch;
+    private _createWorker;
+    private _assignTask;
+    private _handleTaskCompletion;
+    private _handleWorkerCrash;
+    private _reapIdleWorkers;
+    destroy(): Promise<void>;
+}
+//# sourceMappingURL=pool.d.ts.map

package/dist/local-rag/utils/pool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pool.d.ts","sourceRoot":"","sources":["../../../src/local-rag/utils/pool.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAE7C,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,OAAO,CAAA;CAChB;AACD,MAAM,MAAM,aAAa,GACrB;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GAC5C;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,OAAO,EAAE;QAAE,KAAK,EAAE,MAAM,EAAE,CAAA;KAAE,CAAA;CAAE,CAAA;AAExD,MAAM,MAAM,gBAAgB,GACxB;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,SAAS,CAAC;IAAC,IAAI,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,GACtE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,SAAS,CAAC;IAAC,IAAI,EAAE,YAAY,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,EAAE,CAAA;CAAE,CAAA;AAEjF,MAAM,MAAM,eAAe,GAAG,gBAAgB,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,eAAe,CAAA;CAAE,CAAA;AAgB5G,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAK;IAChC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAQ;IACnC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAsB;IAE7C,OAAO,CAAC,OAAO,CAAsB;IACrC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAiB;IAC3C,OAAO,CAAC,aAAa,CAAI;IACzB,OAAO,CAAC,eAAe,CAAI;IAC3B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA0D;IACtF,OAAO,CAAC,iBAAiB,CAA4B;gBAEzC,UAAU,EAAE,GAAG,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,GAAE,UAAe;IAejE,OAAO,CAAC,IAAI,EAAE,aAAa,GAAG;QAAE,IAAI,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IACnE,OAAO,CAAC,IAAI,EAAE,aAAa,GAAG;QAAE,IAAI,EAAE,YAAY,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;IAUjF,OAAO,CAAC,SAAS;IA8BjB,OAAO,CAAC,aAAa;IAoBrB,OAAO,CAAC,WAAW;IAKnB,OAAO,CAAC,qBAAqB;IAoB7B,OAAO,CAAC,kBAAkB;IAmB1B,OAAO,CAAC,gBAAgB;IAoBX,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAOtC"}

package/dist/local-rag/utils/pool.js

@@ -0,0 +1,140 @@
+import { cpus } from 'node:os';
+import { Worker } from 'node:worker_threads';
+import { logger } from '@mcp-monorepo/shared';
+import { EmbeddingError } from '../errors.js';
+export class WorkerPool {
+    workerPath;
+    workerData;
+    config;
+    workers = [];
+    taskQueue = [];
+    taskIdCounter = 0;
+    workerIdCounter = 0;
+    activeTasks = new Map();
+    idleCheckInterval;
+    constructor(workerPath, workerData, config = {}) {
+        this.workerPath = workerPath;
+        this.workerData = workerData;
+        this.config = {
+            maxWorkers: config.maxWorkers ?? Math.max(1, cpus().length - 1),
+            minWorkers: config.minWorkers ?? 0,
+            idleTimeoutMs: config.idleTimeoutMs ?? 1_800_000,
+        };
+        if (this.config.idleTimeoutMs > 0) {
+            this.idleCheckInterval = setInterval(() => this._reapIdleWorkers(), this.config.idleTimeoutMs / 2);
+        }
+    }
+    runTask(task) {
+        const taskId = this.taskIdCounter++;
+        return new Promise((resolve, reject) => {
+            this.activeTasks.set(taskId, { resolve, reject });
+            this.taskQueue.push({ taskId, task, resolve, reject });
+            this._dispatch();
+        });
+    }
+    _dispatch() {
+        if (this.taskQueue.length === 0) {
+            return;
+        }
+        // 1. Prioritize using an existing idle worker
+        const availableWorker = this.workers.find((w) => w.currentTaskId === undefined);
+        if (availableWorker) {
+            const taskInfo = this.taskQueue.shift();
+            if (taskInfo) {
+                this._assignTask(availableWorker, taskInfo);
+            }
+            return;
+        }
+        // 2. If no idle worker, create a new one if we're not at the max limit
+        if (this.workers.length < this.config.maxWorkers) {
+            const taskInfo = this.taskQueue.shift();
+            if (taskInfo) {
+                logger.info(`Scaling up workers to ${this.workers.length + 1} to handle load...`);
+                const newWorker = this._createWorker();
+                this.workers.push(newWorker);
+                this._assignTask(newWorker, taskInfo);
+            }
+        }
+        // 3. If we are at the max limit and all workers are busy, the task remains queued.
+        // It will be picked up when a worker finishes its current task.
+    }
+    _createWorker() {
+        const worker = new Worker(this.workerPath, { workerData: this.workerData });
+        const trackedWorker = {
+            id: ++this.workerIdCounter,
+            worker,
+            currentTaskId: undefined,
+            lastUsed: Date.now(),
+        };
+        worker.on('message', (message) => {
+            this._handleTaskCompletion(trackedWorker, message);
+        });
+        worker.on('error', (err) => {
+            this._handleWorkerCrash(trackedWorker, err);
+        });
+        return trackedWorker;
+    }
+    _assignTask(worker, taskInfo) {
+        worker.currentTaskId = taskInfo.taskId;
+        worker.worker.postMessage({ task: taskInfo.task, taskId: taskInfo.taskId });
+    }
+    _handleTaskCompletion(worker, message) {
+        if (worker.currentTaskId === undefined)
+            return; // Should not happen
+        const taskCallbacks = this.activeTasks.get(worker.currentTaskId);
+        if (taskCallbacks) {
+            if (message.status === 'success') {
+                taskCallbacks.resolve(message.result);
+            }
+            else {
+                taskCallbacks.reject(new EmbeddingError(message.error.message, message.error));
+            }
+            this.activeTasks.delete(worker.currentTaskId);
+        }
+        worker.currentTaskId = undefined;
+        worker.lastUsed = Date.now();
+        // After finishing, check if there are more tasks to run.
+        this._dispatch();
+    }
+    _handleWorkerCrash(crashedWorker, err) {
+        logger.error(`Worker #${crashedWorker.id} crashed.`, err);
+        // Reject the task it was working on
+        if (crashedWorker.currentTaskId !== undefined) {
+            const taskCallbacks = this.activeTasks.get(crashedWorker.currentTaskId);
+            taskCallbacks?.reject(new EmbeddingError(`Worker #${crashedWorker.id} crashed while processing task.`, err));
+            this.activeTasks.delete(crashedWorker.currentTaskId);
+        }
+        // Remove the dead worker from the pool
+        const workerIndex = this.workers.findIndex((w) => w.id === crashedWorker.id);
+        if (workerIndex !== -1) {
+            this.workers.splice(workerIndex, 1);
+        }
+        // Immediately try to dispatch another task, which may create a new worker if needed
+        this._dispatch();
+    }
+    _reapIdleWorkers() {
+        const now = Date.now();
+        const idleWorkers = this.workers.filter((w) => w.currentTaskId === undefined);
+        for (const worker of idleWorkers) {
+            if (this.workers.length <= this.config.minWorkers) {
+                break; // Stop reaping if we're at the minimum
+            }
+            if (now - worker.lastUsed > this.config.idleTimeoutMs) {
+                logger.info(`Scaling down: Terminating idle worker #${worker.id}.`);
+                worker.worker.terminate();
+                const workerIndex = this.workers.findIndex((w) => w.id === worker.id);
+                if (workerIndex !== -1) {
+                    this.workers.splice(workerIndex, 1);
+                }
+            }
+        }
+    }
+    async destroy() {
+        if (this.idleCheckInterval) {
+            clearInterval(this.idleCheckInterval);
+        }
+        await Promise.all(this.workers.map((w) => w.worker.terminate()));
+        this.workers = [];
+    }
+}
+//# sourceMappingURL=pool.js.map

package/dist/local-rag/utils/pool.js.map

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