@ssmeo/mcp-local-rag 0.18.6

package/dist/vectordb/index.d.ts

@@ -0,0 +1,132 @@
+import { type AttachmentHydrationResult, type ChunkRow, type SearchOptions, type SearchResult, type VectorChunk, type VectorStoreConfig } from './types.js';
+export type { AttachmentHydrationResult, GroupingMode, HydratedChunkAttachments, SearchResult, VectorChunk, VisualAttachment, } from './types.js';
+/** Vector storage over LanceDB, including the delete-then-insert atomicity. */
+export declare class VectorStore {
+    private db;
+    private table;
+    private openingTable;
+    private readonly config;
+    private ftsEnabled;
+    constructor(config: VectorStoreConfig);
+    /**
+     * Initialize LanceDB and create table
+     */
+    initialize(): Promise<void>;
+    /** Discover a table created after this connection was initialized. */
+    private openExistingTable;
+    /** @returns the number of chunks removed; 0 when nothing matched. */
+    deleteChunks(filePath: string): Promise<number>;
+    /**
+     * Chunk rows for one file with chunkIndex in the inclusive [minIdx, maxIdx]
+     * range. The ascending sort is a contract, not incidental storage order.
+     *
+     * Feature-agnostic: before/after/isTarget semantics live in the handler.
+     */
+    getChunksByRange(filePath: string, minIdx: number, maxIdx: number): Promise<ChunkRow[]>;
+    /**
+     * Every stored chunk for a file as a full {@link VectorChunk}, embedding
+     * included, so it can be re-inserted verbatim. The ingest handler backs data
+     * up with this before a destructive re-ingest, so a failure rolls back
+     * without corrupting vectors.
+     */
+    getChunksByFilePath(filePath: string): Promise<VectorChunk[]>;
+    /**
+     * Batch insert vector chunks
+     */
+    insertChunks(chunks: VectorChunk[]): Promise<void>;
+    /**
+     * Ensure FTS index exists for hybrid search
+     * Creates ngram-based index if it doesn't exist, drops old versions
+     * @throws DatabaseError if index creation fails (Fail-Fast principle)
+     */
+    private ensureFtsIndex;
+    /**
+     * Ensure schema is up to date by adding missing columns.
+     * Uses table.addColumns() API for top-level column additions.
+     * Idempotent: checks for column existence before adding.
+     */
+    private ensureSchemaVersion;
+    /**
+     * Compact fragments, update the FTS index, and drop old versions. LanceDB OSS
+     * only updates the FTS index on an explicit call.
+     *
+     * The caller decides when — once per ingest rather than per insert, to avoid
+     * O(n^2) during bulk work.
+     */
+    optimize(): Promise<void>;
+    /**
+     * Semantic search → maxDistance/grouping filter → keyword boost → maxFiles.
+     *
+     * Prefetch-then-rerank, so the distance filters see real vector distances and
+     * keyword matching boosts rather than replaces semantic similarity.
+     */
+    /**
+     * Rerank vector hits with BM25 scores for the same files. A failure degrades
+     * this request only — FTS stays enabled, so the next query retries hybrid.
+     */
+    private boostWithKeywords;
+    search(queryVector: number[], options?: SearchOptions): Promise<SearchResult[]>;
+    /**
+     * Load and validate attachments for the ordered unique final search identities.
+     * Candidate retrieval and ranking are deliberately complete before this one
+     * projected batch query runs.
+     */
+    hydrateVisualAttachments(results: readonly {
+        id: string;
+    }[]): Promise<AttachmentHydrationResult>;
+    /**
+     * `.where()` predicate restricting `filePath` to the exact-or-descendant set
+     * of the given prefixes. The separator boundary stops `/a/b` from matching
+     * `/a/bc`. Vector branch only — FTS inherits scope via its own `IN (...)`.
+     */
+    private buildScopePredicate;
+    /** Build the exact-or-descendant predicate for a single prefix. */
+    private buildPrefixPredicate;
+    /** Escape single quotes for a SQL string literal (mirrors deleteChunks). */
+    private escapeQuotes;
+    /** Escape for a LIKE term with `ESCAPE '\'`: backslash first (else it double-escapes), then `%`, `_`, then quotes. */
+    private escapeLike;
+    /**
+     * Per-chunk `(filePath, contentHash, visualProfile)` projection used by
+     * incremental sync.
+     *
+     * One entry per row rather than per file, so a file whose rows disagree on the
+     * hash or the recorded profile is detectable as dirty. `filePath` is the
+     * verbatim stored spelling, since that is what {@link deleteChunks} matches.
+     * The empty-string placeholder the create path seeds for Arrow inference
+     * normalizes to `null`, while any other stored profile string reaches the
+     * planner unchanged so it can validate the vocabulary itself.
+     *
+     * Projects only those three columns, so a manifest load does not materialize
+     * embedding vectors or attachment payloads.
+     */
+    listSyncManifest(): Promise<{
+        filePath: string;
+        contentHash: string | null;
+        visualProfile: string | null;
+    }[]>;
+    /**
+     * Get list of ingested files
+     */
+    listFiles(): Promise<{
+        filePath: string;
+        chunkCount: number;
+        timestamp: string;
+    }[]>;
+    /**
+     * Get system status
+     */
+    getStatus(): Promise<{
+        documentCount: number;
+        chunkCount: number;
+        memoryUsage: number;
+        uptime: number;
+        ftsIndexEnabled: boolean;
+        searchMode: 'hybrid' | 'vector-only';
+    }>;
+    /**
+     * Close the database connection
+     */
+    close(): Promise<void>;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/vectordb/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/vectordb/index.ts"],"names":[],"mappings":"AAOA,OAAO,EACL,KAAK,yBAAyB,EAC9B,KAAK,QAAQ,EAQb,KAAK,aAAa,EAClB,KAAK,YAAY,EAIjB,KAAK,WAAW,EAChB,KAAK,iBAAiB,EACvB,MAAM,YAAY,CAAA;AAGnB,YAAY,EACV,yBAAyB,EACzB,YAAY,EACZ,wBAAwB,EACxB,YAAY,EACZ,WAAW,EACX,gBAAgB,GACjB,MAAM,YAAY,CAAA;AAMnB,+EAA+E;AAC/E,qBAAa,WAAW;IACtB,OAAO,CAAC,EAAE,CAA0B;IACpC,OAAO,CAAC,KAAK,CAAqB;IAClC,OAAO,CAAC,YAAY,CAA6B;IACjD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAmB;IAC1C,OAAO,CAAC,UAAU,CAAiB;IAEnC,YAAY,MAAM,EAAE,iBAAiB,EAEpC;IAED;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAehC;IAED,sEAAsE;YACxD,iBAAiB;IA6B/B,qEAAqE;IAC/D,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CA4BpD;IAED;;;;;OAKG;IACG,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,CA+B5F;IAED;;;;;OAKG;IACG,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAelE;IAED;;OAEG;IACG,YAAY,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CA8CvD;IAED;;;;OAIG;YACW,cAAc;IAyC5B;;;;OAIG;YACW,mBAAmB;IA8BjC;;;;;;OAMG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAQ9B;IAED;;;;;OAKG;IACH;;;OAGG;YACW,iBAAiB;IA8BzB,MAAM,CAAC,WAAW,EAAE,MAAM,EAAE,EAAE,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAuExF;IAED;;;;OAIG;IACG,wBAAwB,CAC5B,OAAO,EAAE,SAAS;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,EAAE,GACjC,OAAO,CAAC,yBAAyB,CAAC,CAkDpC;IAED;;;;OAIG;IACH,OAAO,CAAC,mBAAmB;IAI3B,mEAAmE;IACnE,OAAO,CAAC,oBAAoB;IAO5B,4EAA4E;IAC5E,OAAO,CAAC,YAAY;IAIpB,sHAAsH;IACtH,OAAO,CAAC,UAAU;IAQlB;;;;;;;;;;;;;OAaG;IACG,gBAAgB,IAAI,OAAO,CAC/B;QACE,QAAQ,EAAE,MAAM,CAAA;QAChB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;QAC1B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAA;KAC7B,EAAE,CACJ,CAqCA;IAED;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC,CA2CxF;IAED;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC;QACzB,aAAa,EAAE,MAAM,CAAA;QACrB,UAAU,EAAE,MAAM,CAAA;QAClB,WAAW,EAAE,MAAM,CAAA;QACnB,MAAM,EAAE,MAAM,CAAA;QACd,eAAe,EAAE,OAAO,CAAA;QACxB,UAAU,EAAE,QAAQ,GAAG,aAAa,CAAA;KACrC,CAAC,CAkDD;IAED;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAS3B;CACF"}