vectra 0.12.3 → 0.14.0

package/lib/index.js

@@ -14,15 +14,23 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./codecs"), exports);
+__exportStar(require("./storage"), exports);
 __exportStar(require("./FileFetcher"), exports);
+__exportStar(require("./FolderWatcher"), exports);
 __exportStar(require("./GPT3Tokenizer"), exports);
 __exportStar(require("./ItemSelector"), exports);
+__exportStar(require("./LocalEmbeddings"), exports);
 __exportStar(require("./LocalIndex"), exports);
 __exportStar(require("./LocalDocument"), exports);
 __exportStar(require("./LocalDocumentIndex"), exports);
 __exportStar(require("./LocalDocumentResult"), exports);
-__exportStar(require("./OpenAIEmbeddings"), exports);
 __exportStar(require("./TextSplitter"), exports);
+__exportStar(require("./OpenAIEmbeddings"), exports);
+__exportStar(require("./TransformersEmbeddings"), exports);
+__exportStar(require("./TransformersTokenizer"), exports);
 __exportStar(require("./types"), exports);
 __exportStar(require("./WebFetcher"), exports);
+__exportStar(require("./server"), exports);
+__exportStar(require("./utils/pathUtils"), exports);
 //# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,gDAA8B;AAC9B,kDAAgC;AAChC,iDAA+B;AAC/B,+CAA6B;AAC7B,kDAAgC;AAChC,uDAAqC;AACrC,wDAAsC;AACtC,qDAAmC;AACnC,iDAA+B;AAC/B,0CAAwB;AACxB,+CAA6B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2CAAyB;AACzB,4CAA0B;AAC1B,gDAA8B;AAC9B,kDAAgC;AAChC,kDAAgC;AAChC,iDAA+B;AAC/B,oDAAkC;AAClC,+CAA6B;AAC7B,kDAAgC;AAChC,uDAAqC;AACrC,wDAAsC;AACtC,iDAA+B;AAC/B,qDAAmC;AACnC,2DAAyC;AACzC,0DAAwC;AACxC,0CAAwB;AACxB,+CAA6B;AAC7B,2CAAyB;AACzB,oDAAkC"}

package/lib/internals/Colorize.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Colorize.d.ts","sourceRoot":"","sources":["../../src/internals/Colorize.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,qBAAa,QAAQ;WACH,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;WAIjC,KAAK,CAAC,KAAK,EAAE,KAAK,GAAC,MAAM,GAAG,MAAM;WAQlC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,MAAM,GAAE,OAAe,EAAE,KAAK,GAAE,MAAW,EAAE,KAAK,GAAE,MAAW,GAAG,MAAM;WAyBxG,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;WAIjC,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;WAIhC,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;WAI5B,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,GAAE,MAAW,GAAG,MAAM;WAI5D,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;CAIjD"}
+{"version":3,"file":"Colorize.d.ts","sourceRoot":"","sources":["../../src/internals/Colorize.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,qBAAa,QAAQ;WACH,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;WAIjC,KAAK,CAAC,KAAK,EAAE,KAAK,GAAC,MAAM,GAAG,MAAM;WAQlC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,MAAM,GAAE,OAAe,EAAE,KAAK,GAAE,MAAW,EAAE,KAAK,GAAE,MAAW,GAAG,MAAM;WA4BxG,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;WAIjC,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;WAIhC,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;WAI5B,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,GAAE,MAAW,GAAG,MAAM;WAI5D,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;CAGjD"}

package/lib/internals/Colorize.js

@@ -1,7 +1,9 @@
 "use strict";
+var _a;
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Colorize = void 0;
-const colorizer = require('json-colorizer');
+const colorizerModule = require('json-colorizer');
+const colorizeFn = (_a = colorizerModule === null || colorizerModule === void 0 ? void 0 : colorizerModule.default) !== null && _a !== void 0 ? _a : colorizerModule;
 /**
  * @private
  */
@@ -22,20 +24,23 @@ class Colorize {
             return isBm25 ? `\x1b[34m${quote}${output}${quote}\x1b[0m` : `\x1b[32m${quote}${output}${quote}\x1b[0m`;
         }
         else if (typeof output === 'object' && output !== null) {
-            return colorizer(output, {
-                pretty: true,
-                colors: {
-                    BRACE: 'white',
-                    BRACKET: 'white',
-                    COLON: 'white',
-                    COMMA: 'white',
-                    STRING_KEY: 'white',
-                    STRING_LITERAL: 'green',
-                    NUMBER_LITERAL: 'blue',
-                    BOOLEAN_LITERAL: 'blue',
-                    NULL_LITERAL: 'blue'
-                }
-            });
+            if (typeof colorizeFn === 'function') {
+                return colorizeFn(output, {
+                    pretty: true,
+                    colors: {
+                        BRACE: 'white',
+                        BRACKET: 'white',
+                        COLON: 'white',
+                        COMMA: 'white',
+                        STRING_KEY: 'white',
+                        STRING_LITERAL: 'green',
+                        NUMBER_LITERAL: 'blue',
+                        BOOLEAN_LITERAL: 'blue',
+                        NULL_LITERAL: 'blue'
+                    }
+                });
+            }
+            return JSON.stringify(output, null, 2);
         }
         else if (typeof output == 'number') {
             return `\x1b[34m${output}${units}\x1b[0m`;

package/lib/internals/Colorize.js.map

@@ -1 +1 @@
-{"version":3,"file":"Colorize.js","sourceRoot":"","sources":["../../src/internals/Colorize.ts"],"names":[],"mappings":";;;AAAA,MAAM,SAAS,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;AAE5C;;GAEG;AACH,MAAa,QAAQ;IACV,MAAM,CAAC,WAAW,CAAC,IAAY;QAClC,OAAO,eAAe,GAAG,IAAI,CAAC;IAClC,CAAC;IAEM,MAAM,CAAC,KAAK,CAAC,KAAmB;QACnC,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC5B,OAAO,aAAa,KAAK,SAAS,CAAC;QACvC,CAAC;aAAM,CAAC;YACJ,OAAO,aAAa,KAAK,CAAC,OAAO,SAAS,CAAC;QAC/C,CAAC;IACL,CAAC;IAEM,MAAM,CAAC,MAAM,CAAC,MAAuB,EAAE,SAAkB,KAAK,EAAE,QAAgB,EAAE,EAAE,QAAgB,EAAE;QACzG,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;YAC7B,OAAO,MAAM,CAAC,CAAC,CAAC,WAAW,KAAK,GAAG,MAAM,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,WAAW,KAAK,GAAG,MAAM,GAAG,KAAK,SAAS,CAAC;QAC5G,CAAC;aAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;YACvD,OAAO,SAAS,CAAC,MAAM,EAAE;gBACrB,MAAM,EAAE,IAAI;gBACZ,MAAM,EAAE;oBACJ,KAAK,EAAE,OAAO;oBACd,OAAO,EAAE,OAAO;oBAChB,KAAK,EAAE,OAAO;oBACd,KAAK,EAAE,OAAO;oBACd,UAAU,EAAE,OAAO;oBACnB,cAAc,EAAE,OAAO;oBACvB,cAAc,EAAE,MAAM;oBACtB,eAAe,EAAE,MAAM;oBACvB,YAAY,EAAE,MAAM;iBACvB;aACJ,CAAC,CAAC;QACP,CAAC;aAAM,IAAI,OAAO,MAAM,IAAI,QAAQ,EAAE,CAAC;YACnC,OAAO,WAAW,MAAM,GAAG,KAAK,SAAS,CAAC;QAC9C,CAAC;aAAM,CAAC;YACJ,OAAO,WAAW,MAAM,SAAS,CAAC;QACtC,CAAC;IACL,CAAC;IAEM,MAAM,CAAC,QAAQ,CAAC,OAAe;QAClC,OAAO,OAAO,CAAC;IACnB,CAAC;IAEM,MAAM,CAAC,OAAO,CAAC,OAAe;QACjC,OAAO,aAAa,OAAO,SAAS,CAAC;IACzC,CAAC;IAEM,MAAM,CAAC,KAAK,CAAC,KAAa;QAC7B,OAAO,aAAa,KAAK,SAAS,CAAC;IACvC,CAAC;IAEM,MAAM,CAAC,KAAK,CAAC,KAAa,EAAE,KAAU,EAAE,QAAgB,EAAE;QAC7D,OAAO,GAAG,KAAK,KAAK,QAAQ,CAAC,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,CAAC,EAAE,CAAC;IACpE,CAAC;IAEM,MAAM,CAAC,OAAO,CAAC,OAAe;QACjC,OAAO,WAAW,OAAO,SAAS,CAAC;IAEvC,CAAC;CACJ;AA1DD,4BA0DC"}
+{"version":3,"file":"Colorize.js","sourceRoot":"","sources":["../../src/internals/Colorize.ts"],"names":[],"mappings":";;;;AAAA,MAAM,eAAe,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;AAClD,MAAM,UAAU,GAAG,MAAA,eAAe,aAAf,eAAe,uBAAf,eAAe,CAAE,OAAO,mCAAI,eAAe,CAAC;AAE/D;;GAEG;AACH,MAAa,QAAQ;IACV,MAAM,CAAC,WAAW,CAAC,IAAY;QAClC,OAAO,eAAe,GAAG,IAAI,CAAC;IAClC,CAAC;IAEM,MAAM,CAAC,KAAK,CAAC,KAAmB;QACnC,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC5B,OAAO,aAAa,KAAK,SAAS,CAAC;QACvC,CAAC;aAAM,CAAC;YACJ,OAAO,aAAa,KAAK,CAAC,OAAO,SAAS,CAAC;QAC/C,CAAC;IACL,CAAC;IAEM,MAAM,CAAC,MAAM,CAAC,MAAuB,EAAE,SAAkB,KAAK,EAAE,QAAgB,EAAE,EAAE,QAAgB,EAAE;QACzG,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;YAC7B,OAAO,MAAM,CAAC,CAAC,CAAC,WAAW,KAAK,GAAG,MAAM,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,WAAW,KAAK,GAAG,MAAM,GAAG,KAAK,SAAS,CAAC;QAC5G,CAAC;aAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;YACvD,IAAI,OAAO,UAAU,KAAK,UAAU,EAAE,CAAC;gBACnC,OAAO,UAAU,CAAC,MAAM,EAAE;oBACtB,MAAM,EAAE,IAAI;oBACZ,MAAM,EAAE;wBACJ,KAAK,EAAE,OAAO;wBACd,OAAO,EAAE,OAAO;wBAChB,KAAK,EAAE,OAAO;wBACd,KAAK,EAAE,OAAO;wBACd,UAAU,EAAE,OAAO;wBACnB,cAAc,EAAE,OAAO;wBACvB,cAAc,EAAE,MAAM;wBACtB,eAAe,EAAE,MAAM;wBACvB,YAAY,EAAE,MAAM;qBACvB;iBACJ,CAAC,CAAC;YACP,CAAC;YACD,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QAC3C,CAAC;aAAM,IAAI,OAAO,MAAM,IAAI,QAAQ,EAAE,CAAC;YACnC,OAAO,WAAW,MAAM,GAAG,KAAK,SAAS,CAAC;QAC9C,CAAC;aAAM,CAAC;YACJ,OAAO,WAAW,MAAM,SAAS,CAAC;QACtC,CAAC;IACL,CAAC;IAEM,MAAM,CAAC,QAAQ,CAAC,OAAe;QAClC,OAAO,OAAO,CAAC;IACnB,CAAC;IAEM,MAAM,CAAC,OAAO,CAAC,OAAe;QACjC,OAAO,aAAa,OAAO,SAAS,CAAC;IACzC,CAAC;IAEM,MAAM,CAAC,KAAK,CAAC,KAAa;QAC7B,OAAO,aAAa,KAAK,SAAS,CAAC;IACvC,CAAC;IAEM,MAAM,CAAC,KAAK,CAAC,KAAa,EAAE,KAAU,EAAE,QAAgB,EAAE;QAC7D,OAAO,GAAG,KAAK,KAAK,QAAQ,CAAC,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,CAAC,EAAE,CAAC;IACpE,CAAC;IAEM,MAAM,CAAC,OAAO,CAAC,OAAe;QACjC,OAAO,WAAW,OAAO,SAAS,CAAC;IACvC,CAAC;CACJ;AA5DD,4BA4DC"}

package/lib/server/IndexManager.d.ts

@@ -0,0 +1,78 @@
+import { LocalIndex } from '../LocalIndex';
+import { LocalDocumentIndex } from '../LocalDocumentIndex';
+import { EmbeddingsModel } from '../types';
+export interface ManagedIndex {
+    name: string;
+    index: LocalIndex | LocalDocumentIndex;
+    isDocumentIndex: boolean;
+    format: string;
+}
+export interface IndexManagerConfig {
+    /** Single index path (mutually exclusive with rootDir). */
+    indexPath?: string;
+    /** Root directory containing multiple index subdirectories. */
+    rootDir?: string;
+    /** Embeddings model for server-side embedding computation. */
+    embeddings?: EmbeddingsModel;
+    /** Polling interval in ms for auto-detecting new indexes (default: 3000). */
+    scanInterval?: number;
+}
+/**
+ * Manages loaded indexes for the gRPC server.
+ * Supports single-index and multi-index modes with auto-detection of new indexes.
+ */
+export declare class IndexManager {
+    private readonly _config;
+    private readonly _indexes;
+    private _scanTimer?;
+    private _singleMode;
+    constructor(config: IndexManagerConfig);
+    /** Returns all currently loaded indexes. */
+    get indexes(): Map<string, ManagedIndex>;
+    /** Returns true if running in single-index mode. */
+    get isSingleMode(): boolean;
+    /**
+     * Initializes the index manager: loads existing indexes and starts auto-detection.
+     */
+    initialize(): Promise<void>;
+    /**
+     * Shuts down the index manager: stops scanning and flushes all indexes.
+     */
+    shutdown(): Promise<void>;
+    /**
+     * Gets a managed index by name.
+     * In single-index mode, any name (or empty string) returns the single index.
+     */
+    getIndex(name: string): ManagedIndex | undefined;
+    /**
+     * Gets a managed index, throwing NOT_FOUND-appropriate error if missing.
+     */
+    requireIndex(name: string): ManagedIndex;
+    /**
+     * Gets a managed document index, throwing if missing or not a document index.
+     */
+    requireDocumentIndex(name: string): {
+        managed: ManagedIndex;
+        docIndex: LocalDocumentIndex;
+    };
+    /**
+     * Creates a new index on disk and loads it.
+     */
+    createIndex(name: string, format: string, isDocumentIndex: boolean, documentConfig?: {
+        version?: number;
+        chunkSize?: number;
+        chunkOverlap?: number;
+    }): Promise<ManagedIndex>;
+    /**
+     * Deletes an index from disk and unloads it.
+     */
+    deleteIndex(name: string): Promise<void>;
+    /**
+     * Lists all loaded indexes.
+     */
+    listIndexes(): ManagedIndex[];
+    private loadSingleIndex;
+    private scanRootDir;
+    private loadIndex;
+}
+//# sourceMappingURL=IndexManager.d.ts.map

package/lib/server/IndexManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IndexManager.d.ts","sourceRoot":"","sources":["../../src/server/IndexManager.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAqB,MAAM,eAAe,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAA4B,MAAM,uBAAuB,CAAC;AAGrF,OAAO,EAAE,eAAe,EAAiB,MAAM,UAAU,CAAC;AAG1D,MAAM,WAAW,YAAY;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,UAAU,GAAG,kBAAkB,CAAC;IACvC,eAAe,EAAE,OAAO,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,kBAAkB;IAC/B,2DAA2D;IAC3D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+DAA+D;IAC/D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8DAA8D;IAC9D,UAAU,CAAC,EAAE,eAAe,CAAC;IAC7B,6EAA6E;IAC7E,YAAY,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;GAGG;AACH,qBAAa,YAAY;IACrB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqB;IAC7C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAwC;IACjE,OAAO,CAAC,UAAU,CAAC,CAAiC;IACpD,OAAO,CAAC,WAAW,CAAU;gBAEjB,MAAM,EAAE,kBAAkB;IAKtC,4CAA4C;IAC5C,IAAW,OAAO,IAAI,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAE9C;IAED,oDAAoD;IACpD,IAAW,YAAY,IAAI,OAAO,CAEjC;IAED;;OAEG;IACU,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAaxC;;OAEG;IACU,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAStC;;;OAGG;IACI,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IASvD;;OAEG;IACI,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY;IAQ/C;;OAEG;IACI,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG;QAAE,OAAO,EAAE,YAAY,CAAC;QAAC,QAAQ,EAAE,kBAAkB,CAAA;KAAE;IAQlG;;OAEG;IACU,WAAW,CACpB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,eAAe,EAAE,OAAO,EACxB,cAAc,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,GACjF,OAAO,CAAC,YAAY,CAAC;IA+CxB;;OAEG;IACU,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMrD;;OAEG;IACI,WAAW,IAAI,YAAY,EAAE;YAItB,eAAe;YAKf,WAAW;YAmBX,SAAS;CAgC1B"}

package/lib/server/IndexManager.js

@@ -0,0 +1,259 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IndexManager = void 0;
+const path = __importStar(require("path"));
+const fs = __importStar(require("fs"));
+const LocalIndex_1 = require("../LocalIndex");
+const LocalDocumentIndex_1 = require("../LocalDocumentIndex");
+const LocalFileStorage_1 = require("../storage/LocalFileStorage");
+const codecs_1 = require("../codecs");
+/**
+ * Manages loaded indexes for the gRPC server.
+ * Supports single-index and multi-index modes with auto-detection of new indexes.
+ */
+class IndexManager {
+    constructor(config) {
+        this._indexes = new Map();
+        this._config = config;
+        this._singleMode = !!config.indexPath;
+    }
+    /** Returns all currently loaded indexes. */
+    get indexes() {
+        return this._indexes;
+    }
+    /** Returns true if running in single-index mode. */
+    get isSingleMode() {
+        return this._singleMode;
+    }
+    /**
+     * Initializes the index manager: loads existing indexes and starts auto-detection.
+     */
+    initialize() {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a;
+            if (this._singleMode && this._config.indexPath) {
+                yield this.loadSingleIndex(this._config.indexPath);
+            }
+            else if (this._config.rootDir) {
+                yield this.scanRootDir();
+                // Start periodic scanning for new indexes
+                const interval = (_a = this._config.scanInterval) !== null && _a !== void 0 ? _a : 3000;
+                this._scanTimer = setInterval(() => {
+                    this.scanRootDir().catch(() => { });
+                }, interval);
+            }
+        });
+    }
+    /**
+     * Shuts down the index manager: stops scanning and flushes all indexes.
+     */
+    shutdown() {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (this._scanTimer) {
+                clearInterval(this._scanTimer);
+                this._scanTimer = undefined;
+            }
+            // No special flush needed — LocalIndex writes on endUpdate()
+            this._indexes.clear();
+        });
+    }
+    /**
+     * Gets a managed index by name.
+     * In single-index mode, any name (or empty string) returns the single index.
+     */
+    getIndex(name) {
+        if (this._singleMode) {
+            // Return the single loaded index regardless of the name provided
+            const entries = Array.from(this._indexes.values());
+            return entries[0];
+        }
+        return this._indexes.get(name);
+    }
+    /**
+     * Gets a managed index, throwing NOT_FOUND-appropriate error if missing.
+     */
+    requireIndex(name) {
+        const managed = this.getIndex(name);
+        if (!managed) {
+            throw new Error(`Index not found: ${name}`);
+        }
+        return managed;
+    }
+    /**
+     * Gets a managed document index, throwing if missing or not a document index.
+     */
+    requireDocumentIndex(name) {
+        const managed = this.requireIndex(name);
+        if (!managed.isDocumentIndex) {
+            throw new Error(`Index "${name}" is not a document index`);
+        }
+        return { managed, docIndex: managed.index };
+    }
+    /**
+     * Creates a new index on disk and loads it.
+     */
+    createIndex(name, format, isDocumentIndex, documentConfig) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (this._indexes.has(name)) {
+                throw new Error(`Index already exists: ${name}`);
+            }
+            const rootDir = this._config.rootDir;
+            if (!rootDir && !this._singleMode) {
+                throw new Error('Cannot create index: no root directory configured');
+            }
+            const folderPath = rootDir ? path.join(rootDir, name) : name;
+            const storage = new LocalFileStorage_1.LocalFileStorage();
+            const codec = format === 'protobuf' ? new codecs_1.ProtobufCodec() : new codecs_1.JsonCodec();
+            let index;
+            if (isDocumentIndex) {
+                const config = {
+                    folderPath,
+                    storage,
+                    codec,
+                    embeddings: this._config.embeddings,
+                    chunkingConfig: {
+                        chunkSize: (documentConfig === null || documentConfig === void 0 ? void 0 : documentConfig.chunkSize) || 512,
+                        chunkOverlap: (documentConfig === null || documentConfig === void 0 ? void 0 : documentConfig.chunkOverlap) || 0,
+                    },
+                };
+                index = new LocalDocumentIndex_1.LocalDocumentIndex(config);
+            }
+            else {
+                index = new LocalIndex_1.LocalIndex(folderPath, undefined, storage, codec);
+            }
+            const createConfig = {
+                version: (documentConfig === null || documentConfig === void 0 ? void 0 : documentConfig.version) || 1,
+                deleteIfExists: false,
+            };
+            yield index.createIndex(createConfig);
+            const managed = {
+                name,
+                index,
+                isDocumentIndex,
+                format: format || 'json',
+            };
+            this._indexes.set(name, managed);
+            return managed;
+        });
+    }
+    /**
+     * Deletes an index from disk and unloads it.
+     */
+    deleteIndex(name) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const managed = this.requireIndex(name);
+            yield managed.index.deleteIndex();
+            this._indexes.delete(name);
+        });
+    }
+    /**
+     * Lists all loaded indexes.
+     */
+    listIndexes() {
+        return Array.from(this._indexes.values());
+    }
+    loadSingleIndex(indexPath) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const name = path.basename(indexPath);
+            yield this.loadIndex(name, indexPath);
+        });
+    }
+    scanRootDir() {
+        return __awaiter(this, void 0, void 0, function* () {
+            const rootDir = this._config.rootDir;
+            if (!fs.existsSync(rootDir))
+                return;
+            const entries = fs.readdirSync(rootDir, { withFileTypes: true });
+            for (const entry of entries) {
+                if (!entry.isDirectory())
+                    continue;
+                if (entry.name.startsWith('.'))
+                    continue;
+                if (this._indexes.has(entry.name))
+                    continue;
+                const folderPath = path.join(rootDir, entry.name);
+                try {
+                    yield this.loadIndex(entry.name, folderPath);
+                }
+                catch (_a) {
+                    // Skip directories that aren't valid indexes
+                }
+            }
+        });
+    }
+    loadIndex(name, folderPath) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const storage = new LocalFileStorage_1.LocalFileStorage();
+            // Detect codec — throws if no index file found
+            const codec = yield (0, codecs_1.detectCodec)(folderPath, storage);
+            const format = codec.extension === '.pb' ? 'protobuf' : 'json';
+            // Detect if it's a document index (has catalog file)
+            const hasCatalogJson = yield storage.pathExists(path.join(folderPath, 'catalog.json'));
+            const hasCatalogPb = yield storage.pathExists(path.join(folderPath, 'catalog.pb'));
+            const isDocumentIndex = hasCatalogJson || hasCatalogPb;
+            let index;
+            if (isDocumentIndex) {
+                index = new LocalDocumentIndex_1.LocalDocumentIndex({
+                    folderPath,
+                    storage,
+                    codec,
+                    embeddings: this._config.embeddings,
+                });
+            }
+            else {
+                index = new LocalIndex_1.LocalIndex(folderPath, undefined, storage, codec);
+            }
+            const managed = {
+                name,
+                index,
+                isDocumentIndex,
+                format,
+            };
+            this._indexes.set(name, managed);
+        });
+    }
+}
+exports.IndexManager = IndexManager;
+//# sourceMappingURL=IndexManager.js.map

package/lib/server/IndexManager.js.map

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

package/lib/server/VectraServer.d.ts

@@ -0,0 +1,40 @@
+import * as grpc from '@grpc/grpc-js';
+import { IndexManager } from './IndexManager';
+import { EmbeddingsModel } from '../types';
+export interface VectraServerConfig {
+    /** Port to bind the gRPC server on (default: 50051). */
+    port?: number;
+    /** Single index path (mutually exclusive with rootDir). */
+    indexPath?: string;
+    /** Root directory containing multiple index subdirectories. */
+    rootDir?: string;
+    /** Embeddings model for server-side embedding computation. */
+    embeddings?: EmbeddingsModel;
+    /** Polling interval in ms for auto-detecting new indexes (default: 3000). */
+    scanInterval?: number;
+}
+/**
+ * gRPC server that exposes Vectra indexes over the VectraService proto.
+ */
+export declare class VectraServer {
+    private readonly _config;
+    private readonly _indexManager;
+    private _server?;
+    private _startTime;
+    private _shutdownPromise?;
+    constructor(config: VectraServerConfig);
+    /** The underlying IndexManager. */
+    get indexManager(): IndexManager;
+    /** The underlying gRPC server instance. */
+    get server(): grpc.Server | undefined;
+    /**
+     * Starts the gRPC server and loads indexes.
+     * @returns The port the server is listening on.
+     */
+    start(): Promise<number>;
+    /**
+     * Gracefully shuts down the server with a 5s draining timeout.
+     */
+    shutdown(): Promise<void>;
+}
+//# sourceMappingURL=VectraServer.d.ts.map

package/lib/server/VectraServer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VectraServer.d.ts","sourceRoot":"","sources":["../../src/server/VectraServer.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,IAAI,MAAM,eAAe,CAAC;AAEtC,OAAO,EAAE,YAAY,EAAsB,MAAM,gBAAgB,CAAC;AAClE,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAU3C,MAAM,WAAW,kBAAkB;IAC/B,wDAAwD;IACxD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,2DAA2D;IAC3D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+DAA+D;IAC/D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8DAA8D;IAC9D,UAAU,CAAC,EAAE,eAAe,CAAC;IAC7B,6EAA6E;IAC7E,YAAY,CAAC,EAAE,MAAM,CAAC;CACzB;AAID;;GAEG;AACH,qBAAa,YAAY;IACrB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqB;IAC7C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAe;IAC7C,OAAO,CAAC,OAAO,CAAC,CAAc;IAC9B,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,gBAAgB,CAAC,CAAgB;gBAE7B,MAAM,EAAE,kBAAkB;IAWtC,mCAAmC;IACnC,IAAW,YAAY,IAAI,YAAY,CAEtC;IAED,2CAA2C;IAC3C,IAAW,MAAM,IAAI,IAAI,CAAC,MAAM,GAAG,SAAS,CAE3C;IAED;;;OAGG;IACU,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC;IA6DrC;;OAEG;IACU,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CA2BzC"}

package/lib/server/VectraServer.js

@@ -0,0 +1,151 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VectraServer = void 0;
+const path = __importStar(require("path"));
+const grpc = __importStar(require("@grpc/grpc-js"));
+const protoLoader = __importStar(require("@grpc/proto-loader"));
+const IndexManager_1 = require("./IndexManager");
+const handlers_1 = require("./handlers");
+const DRAIN_TIMEOUT_MS = 5000;
+/**
+ * gRPC server that exposes Vectra indexes over the VectraService proto.
+ */
+class VectraServer {
+    constructor(config) {
+        this._startTime = 0;
+        this._config = config;
+        const managerConfig = {
+            indexPath: config.indexPath,
+            rootDir: config.rootDir,
+            embeddings: config.embeddings,
+            scanInterval: config.scanInterval,
+        };
+        this._indexManager = new IndexManager_1.IndexManager(managerConfig);
+    }
+    /** The underlying IndexManager. */
+    get indexManager() {
+        return this._indexManager;
+    }
+    /** The underlying gRPC server instance. */
+    get server() {
+        return this._server;
+    }
+    /**
+     * Starts the gRPC server and loads indexes.
+     * @returns The port the server is listening on.
+     */
+    start() {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a;
+            this._startTime = Date.now();
+            // Load proto definition
+            const protoPath = path.resolve(__dirname, '..', '..', 'proto', 'vectra_service.proto');
+            const packageDefinition = protoLoader.loadSync(protoPath, {
+                keepCase: true,
+                longs: Number,
+                enums: String,
+                defaults: true,
+                oneofs: true,
+            });
+            const protoDescriptor = grpc.loadPackageDefinition(packageDefinition);
+            const vectraService = protoDescriptor.vectra.VectraService;
+            // Initialize index manager
+            yield this._indexManager.initialize();
+            // Create gRPC server
+            this._server = new grpc.Server();
+            // Register all handler groups
+            const indexHandlers = (0, handlers_1.createIndexHandlers)(this._indexManager);
+            const itemHandlers = (0, handlers_1.createItemHandlers)(this._indexManager, this._config.embeddings);
+            const queryHandlers = (0, handlers_1.createQueryHandlers)(this._indexManager, this._config.embeddings);
+            const documentHandlers = (0, handlers_1.createDocumentHandlers)(this._indexManager);
+            const statsHandlers = (0, handlers_1.createStatsHandlers)(this._indexManager);
+            const lifecycleHandlers = (0, handlers_1.createLifecycleHandlers)(this._indexManager, this._startTime, () => this.shutdown());
+            this._server.addService(vectraService.service, Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign({}, indexHandlers), itemHandlers), queryHandlers), documentHandlers), statsHandlers), lifecycleHandlers));
+            // Bind to localhost only
+            const port = (_a = this._config.port) !== null && _a !== void 0 ? _a : 50051;
+            const boundPort = yield new Promise((resolve, reject) => {
+                this._server.bindAsync(`127.0.0.1:${port}`, grpc.ServerCredentials.createInsecure(), (err, actualPort) => {
+                    if (err) {
+                        reject(err);
+                    }
+                    else {
+                        resolve(actualPort);
+                    }
+                });
+            });
+            return boundPort;
+        });
+    }
+    /**
+     * Gracefully shuts down the server with a 5s draining timeout.
+     */
+    shutdown() {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (this._shutdownPromise)
+                return this._shutdownPromise;
+            this._shutdownPromise = (() => __awaiter(this, void 0, void 0, function* () {
+                // Stop index manager scanning
+                yield this._indexManager.shutdown();
+                if (!this._server)
+                    return;
+                // Try graceful shutdown with timeout
+                yield new Promise((resolve) => {
+                    const timer = setTimeout(() => {
+                        this._server.forceShutdown();
+                        resolve();
+                    }, DRAIN_TIMEOUT_MS);
+                    this._server.tryShutdown((err) => {
+                        clearTimeout(timer);
+                        resolve();
+                    });
+                });
+                this._server = undefined;
+            }))();
+            return this._shutdownPromise;
+        });
+    }
+}
+exports.VectraServer = VectraServer;
+//# sourceMappingURL=VectraServer.js.map

package/lib/server/VectraServer.js.map

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

package/lib/server/VectraServer.spec.d.ts

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