@retrivora-ai/rag-engine 2.3.0 → 2.3.2

package/dist/server.mjs

@@ -150,7 +150,7 @@ var init_ConfigFetcher = __esm({
        * Fetch full project configuration (vectorDb + embedding + llm) from Retrivora Control Plane.
        */
       static async fetchRemoteConfig(projectId, licenseKey) {
-        var _a2, _b, _c, _d, _e, _f, _g2, _h, _i, _j, _k;
+        var _a3, _b, _c, _d, _e, _f, _g2, _h, _i, _j, _k;
         const cacheKey = `${projectId}:${licenseKey || ""}`;
         const now = Date.now();
         const cached = this.cache.get(cacheKey);
@@ -176,7 +176,7 @@ var init_ConfigFetcher = __esm({
             });
             if (res.ok) {
               const data = await res.json();
-              if ((data == null ? void 0 : data.success) && ((_a2 = data == null ? void 0 : data.vectorDb) == null ? void 0 : _a2.apiKey)) {
+              if ((data == null ? void 0 : data.success) && ((_a3 = data == null ? void 0 : data.vectorDb) == null ? void 0 : _a3.apiKey)) {
                 const fetchedProjectId = data.projectId || projectId;
                 const config = {
                   projectId: fetchedProjectId,
@@ -212,9 +212,9 @@ var init_ConfigFetcher = __esm({
       }
       /** Convenience: fetch only vector DB config (backwards compat). */
       static async fetchRemoteVectorConfig(projectId, licenseKey) {
-        var _a2;
+        var _a3;
         const config = await this.fetchRemoteConfig(projectId, licenseKey);
-        return (_a2 = config == null ? void 0 : config.vectorDb) != null ? _a2 : null;
+        return (_a3 = config == null ? void 0 : config.vectorDb) != null ? _a3 : null;
       }
     };
     ConfigFetcher.cache = /* @__PURE__ */ new Map();
@@ -263,7 +263,7 @@ var init_PineconeProvider = __esm({
       static getHealthChecker() {
         return {
           async check(config) {
-            var _a2, _b;
+            var _a3, _b;
             const opts = config.options || {};
             const indexName = config.indexName;
             const timestamp = Date.now();
@@ -271,7 +271,7 @@ var init_PineconeProvider = __esm({
               const { Pinecone: Pinecone2 } = await import("@pinecone-database/pinecone");
               const client = new Pinecone2({ apiKey: opts.apiKey });
               const indexes = await client.listIndexes();
-              const indexNames = (_b = (_a2 = indexes.indexes) == null ? void 0 : _a2.map((i) => i.name)) != null ? _b : [];
+              const indexNames = (_b = (_a3 = indexes.indexes) == null ? void 0 : _a3.map((i) => i.name)) != null ? _b : [];
               if (!indexNames.includes(indexName)) {
                 return {
                   healthy: false,
@@ -298,7 +298,7 @@ var init_PineconeProvider = __esm({
         };
       }
       async initialize() {
-        var _a2, _b;
+        var _a3, _b;
         if (this.client) return;
         let key = this.apiKey || process.env.PINECONE_API_KEY || "";
         if (!key) {
@@ -335,7 +335,7 @@ var init_PineconeProvider = __esm({
         this.client = new Pinecone({ apiKey: key });
         try {
           const indexes = await this.client.listIndexes();
-          const names = (_b = (_a2 = indexes.indexes) == null ? void 0 : _a2.map((i) => i.name)) != null ? _b : [];
+          const names = (_b = (_a3 = indexes.indexes) == null ? void 0 : _a3.map((i) => i.name)) != null ? _b : [];
           if (!names.includes(this.indexName)) {
             console.warn(`[PineconeProvider] Target index "${this.indexName}" not listed. Proceeding with configured index name.`);
           }
@@ -354,13 +354,13 @@ var init_PineconeProvider = __esm({
         return namespace ? idx.namespace(namespace) : idx.namespace("");
       }
       async upsert(doc, namespace) {
-        var _a2;
+        var _a3;
         const targetIdx = await this.getActiveIndex(namespace);
         await targetIdx.upsert({
           records: [{
             id: String(doc.id),
             values: doc.vector,
-            metadata: __spreadValues({ content: doc.content }, (_a2 = doc.metadata) != null ? _a2 : {})
+            metadata: __spreadValues({ content: doc.content }, (_a3 = doc.metadata) != null ? _a3 : {})
           }]
         });
       }
@@ -369,18 +369,18 @@ var init_PineconeProvider = __esm({
         const BATCH = 100;
         for (let i = 0; i < docs.length; i += BATCH) {
           const records = docs.slice(i, i + BATCH).map((d) => {
-            var _a2;
+            var _a3;
             return {
               id: String(d.id),
               values: d.vector,
-              metadata: __spreadValues({ content: d.content }, (_a2 = d.metadata) != null ? _a2 : {})
+              metadata: __spreadValues({ content: d.content }, (_a3 = d.metadata) != null ? _a3 : {})
             };
           });
           await targetIdx.upsert({ records });
         }
       }
       async query(vector, topK, namespace, filter) {
-        var _a2;
+        var _a3;
         const targetIdx = await this.getActiveIndex(namespace);
         const pineconeFilter = this.sanitizeFilter(filter);
         const result = await targetIdx.query(__spreadValues({
@@ -388,11 +388,11 @@ var init_PineconeProvider = __esm({
           topK,
           includeMetadata: true
         }, Object.keys(pineconeFilter).length > 0 ? { filter: pineconeFilter } : {}));
-        return ((_a2 = result.matches) != null ? _a2 : []).map((m) => {
-          var _a3, _b;
+        return ((_a3 = result.matches) != null ? _a3 : []).map((m) => {
+          var _a4, _b;
           return {
             id: m.id,
-            score: (_a3 = m.score) != null ? _a3 : 0,
+            score: (_a4 = m.score) != null ? _a4 : 0,
             content: ((_b = m.metadata) == null ? void 0 : _b.content) || "",
             metadata: m.metadata
           };
@@ -435,13 +435,13 @@ var init_PostgreSQLProvider = __esm({
     init_BaseVectorProvider();
     PostgreSQLProvider = class extends BaseVectorProvider {
       constructor(config) {
-        var _a2;
+        var _a3;
         super(config);
         this.tableName = this.indexName.replace(/[^a-z0-9_]/gi, "_");
         const opts = config.options;
         if (!opts.connectionString) throw new Error("[PostgreSQLProvider] options.connectionString is required");
         this.connectionString = opts.connectionString;
-        this.dimensions = (_a2 = opts.dimensions) != null ? _a2 : 1536;
+        this.dimensions = (_a3 = opts.dimensions) != null ? _a3 : 1536;
       }
       static getValidator() {
         return {
@@ -522,7 +522,7 @@ var init_PostgreSQLProvider = __esm({
         }
       }
       async upsert(doc, namespace = "") {
-        var _a2;
+        var _a3;
         const vectorLiteral = `[${doc.vector.join(",")}]`;
         await this.pool.query(
           `INSERT INTO ${this.tableName} (id, namespace, content, metadata, embedding)
@@ -532,7 +532,7 @@ var init_PostgreSQLProvider = __esm({
              content   = EXCLUDED.content,
              metadata  = EXCLUDED.metadata,
              embedding = EXCLUDED.embedding`,
-          [doc.id, namespace, doc.content, JSON.stringify((_a2 = doc.metadata) != null ? _a2 : {}), vectorLiteral]
+          [doc.id, namespace, doc.content, JSON.stringify((_a3 = doc.metadata) != null ? _a3 : {}), vectorLiteral]
         );
       }
       async batchUpsert(docs, namespace = "") {
@@ -545,9 +545,9 @@ var init_PostgreSQLProvider = __esm({
             const batch = docs.slice(i, i + BATCH_SIZE);
             const values = [];
             const valuePlaceholders = batch.map((doc, idx) => {
-              var _a2;
+              var _a3;
               const offset = idx * 5;
-              values.push(doc.id, namespace, doc.content, JSON.stringify((_a2 = doc.metadata) != null ? _a2 : {}), `[${doc.vector.join(",")}]`);
+              values.push(doc.id, namespace, doc.content, JSON.stringify((_a3 = doc.metadata) != null ? _a3 : {}), `[${doc.vector.join(",")}]`);
               return `($${offset + 1}, $${offset + 2}, $${offset + 3}, $${offset + 4}, $${offset + 5}::vector)`;
             }).join(", ");
             const query = `
@@ -630,8 +630,8 @@ var init_PostgreSQLProvider = __esm({
 
 // src/utils/synonyms.ts
 function resolveMetadataValue(meta, uiKey) {
-  var _a2;
-  const synonyms = (_a2 = FIELD_SYNONYMS[uiKey]) != null ? _a2 : [];
+  var _a3;
+  const synonyms = (_a3 = FIELD_SYNONYMS[uiKey]) != null ? _a3 : [];
   const keys = Object.keys(meta);
   const systemKeys = ["namespace", "filename", "filesize", "filetype", "docid", "uploadedat", "dimension", "chunkindex"];
   let match = keys.find((k) => k.toLowerCase() === uiKey.toLowerCase());
@@ -718,14 +718,14 @@ var init_MultiTablePostgresProvider = __esm({
     init_synonyms();
     MultiTablePostgresProvider = class extends BaseVectorProvider {
       constructor(config) {
-        var _a2, _b, _c;
+        var _a3, _b, _c;
         super(config);
         const opts = config.options || {};
         if (!opts.connectionString) {
           throw new Error("[MultiTablePostgresProvider] options.connectionString is required");
         }
         this.connectionString = opts.connectionString;
-        this.dimensions = (_a2 = opts.dimensions) != null ? _a2 : 768;
+        this.dimensions = (_a3 = opts.dimensions) != null ? _a3 : 768;
         this.tables = [];
         const rawSearchFields = (_c = (_b = opts.searchFields) != null ? _b : process.env.VECTOR_DB_SEARCH_FIELDS) != null ? _c : ["name", "product_name", "productname", "title"];
         this.searchFields = typeof rawSearchFields === "string" ? rawSearchFields.split(",").map((f) => f.trim()).filter(Boolean) : rawSearchFields;
@@ -783,11 +783,11 @@ var init_MultiTablePostgresProvider = __esm({
        * Batch upsert documents by dynamically provisioning tables and columns based on CSV headers.
        */
       async batchUpsert(docs, namespace = "") {
-        var _a2;
+        var _a3;
         if (docs.length === 0) return;
         const docsByFile = {};
         for (const doc of docs) {
-          const fileName = ((_a2 = doc.metadata) == null ? void 0 : _a2.fileName) || this.uploadTable;
+          const fileName = ((_a3 = doc.metadata) == null ? void 0 : _a3.fileName) || this.uploadTable;
           if (!docsByFile[fileName]) docsByFile[fileName] = [];
           docsByFile[fileName].push(doc);
         }
@@ -840,11 +840,11 @@ var init_MultiTablePostgresProvider = __esm({
               const headerColumns = csvHeaders.map((h) => `"${h}"`).join(", ");
               const allColumns = `id, ${headerColumns ? headerColumns + ", " : ""}namespace, content, metadata, embedding`;
               const valuePlaceholders = batch.map((doc, idx) => {
-                var _a3, _b;
+                var _a4, _b;
                 const offset = idx * (5 + csvHeaders.length);
                 values.push(doc.id);
                 for (const h of csvHeaders) {
-                  values.push(String(((_a3 = doc.metadata) == null ? void 0 : _a3[h]) || ""));
+                  values.push(String(((_a4 = doc.metadata) == null ? void 0 : _a4[h]) || ""));
                 }
                 values.push(namespace, doc.content, JSON.stringify((_b = doc.metadata) != null ? _b : {}), `[${doc.vector.join(",")}]`);
                 const docPlaceholders = [];
@@ -883,7 +883,7 @@ var init_MultiTablePostgresProvider = __esm({
        * Query all configured tables and merge results, sorted by cosine similarity score.
        */
       async query(vector, topK, _namespace, _filter) {
-        var _a2;
+        var _a3;
         if (!this.pool) {
           throw new Error("[MultiTablePostgresProvider] Provider not initialized. Call initialize() first.");
         }
@@ -914,11 +914,11 @@ var init_MultiTablePostgresProvider = __esm({
             const filterParams = [];
             if (metadataFilters && Object.keys(metadataFilters).length > 0) {
               const conditions = Object.entries(metadataFilters).map(([key, val]) => {
-                var _a4;
+                var _a5;
                 filterParams.push(String(val));
                 const baseOffset = queryText && dynamicKeywordQuery ? 2 : 1;
                 const paramIdx = baseOffset + filterParams.length;
-                const synonyms = (_a4 = FIELD_SYNONYMS[key]) != null ? _a4 : [];
+                const synonyms = (_a5 = FIELD_SYNONYMS[key]) != null ? _a5 : [];
                 const keysToCheck = [key, ...synonyms];
                 const coalesceExprs = keysToCheck.flatMap((k) => [
                   `metadata->>'${k}'`,
@@ -987,7 +987,7 @@ var init_MultiTablePostgresProvider = __esm({
             }
             const tableResults = [];
             for (const row of result.rows) {
-              const _a3 = row, { hybrid_score, id } = _a3, rest = __objRest(_a3, ["hybrid_score", "id"]);
+              const _a4 = row, { hybrid_score, id } = _a4, rest = __objRest(_a4, ["hybrid_score", "id"]);
               delete rest.embedding;
               delete rest.vector_score;
               delete rest.keyword_score;
@@ -1016,10 +1016,10 @@ var init_MultiTablePostgresProvider = __esm({
         }
         allResults.sort((a, b) => b.score - a.score);
         if (allResults.length === 0) return [];
-        const bestMatchTable = (_a2 = allResults[0].metadata) == null ? void 0 : _a2.source_table;
+        const bestMatchTable = (_a3 = allResults[0].metadata) == null ? void 0 : _a3.source_table;
         const finalSorted = allResults.filter((res) => {
-          var _a3;
-          return ((_a3 = res.metadata) == null ? void 0 : _a3.source_table) === bestMatchTable;
+          var _a4;
+          return ((_a4 = res.metadata) == null ? void 0 : _a4.source_table) === bestMatchTable;
         });
         console.log(`[MultiTablePostgresProvider] --- Search Complete ---`);
         console.log(`[MultiTablePostgresProvider] Final top match from "${bestMatchTable}" with score ${finalSorted[0].score.toFixed(4)}`);
@@ -1340,7 +1340,6 @@ var init_MilvusProvider = __esm({
           metadata: res["metadata"] || {}
         }));
       }
-      // eslint-disable-next-line @typescript-eslint/no-unused-vars
       async delete(id, _namespace) {
         await this.http.post("/v1/vector/delete", {
           collectionName: this.indexName,
@@ -1424,14 +1423,14 @@ var init_QdrantProvider = __esm({
        * Samples points from the collection to discover available payload fields.
        */
       async discoverSchema() {
-        var _a2;
+        var _a3;
         try {
           const { data } = await this.http.post(`/collections/${this.indexName}/points/scroll`, {
             limit: 20,
             with_payload: true,
             with_vector: false
           });
-          const points = ((_a2 = data.result) == null ? void 0 : _a2.points) || [];
+          const points = ((_a3 = data.result) == null ? void 0 : _a3.points) || [];
           const keys = /* @__PURE__ */ new Set();
           for (const point of points) {
             const payload = point.payload || {};
@@ -1457,12 +1456,12 @@ var init_QdrantProvider = __esm({
        * Ensures the collection exists. Creates it if missing.
        */
       async ensureCollection() {
-        var _a2;
+        var _a3;
         try {
           await this.http.get(`/collections/${this.indexName}`);
           console.log(`[QdrantProvider] \u2705 Collection "${this.indexName}" already exists.`);
         } catch (err) {
-          if (axios4.isAxiosError(err) && ((_a2 = err.response) == null ? void 0 : _a2.status) === 404) {
+          if (axios4.isAxiosError(err) && ((_a3 = err.response) == null ? void 0 : _a3.status) === 404) {
             const opts = this.config.options;
             const dimensionsForCreate = opts.dimensions || 1536;
             console.log(`[QdrantProvider] \u23F3 Creating collection "${this.indexName}" (dimensions: ${dimensionsForCreate})...`);
@@ -1482,7 +1481,7 @@ var init_QdrantProvider = __esm({
        * Ensures that a payload field has an index.
        */
       async ensureIndex(fieldName, schema = "keyword") {
-        var _a2;
+        var _a3;
         let fullPath = fieldName;
         if (!this.isFlatPayload && !fieldName.includes(".") && fieldName !== "namespace" && fieldName !== this.contentField) {
           fullPath = `${this.metadataField}.${fieldName}`;
@@ -1495,7 +1494,7 @@ var init_QdrantProvider = __esm({
           console.log(`[QdrantProvider] \u2705 Ensured ${schema} index for "${fullPath}"`);
         } catch (err) {
           let status;
-          if (axios4.isAxiosError(err)) status = (_a2 = err.response) == null ? void 0 : _a2.status;
+          if (axios4.isAxiosError(err)) status = (_a3 = err.response) == null ? void 0 : _a3.status;
           if (status === 409) return;
           console.warn(`[QdrantProvider] \u26A0\uFE0F Could not ensure index for "${fullPath}":`, err instanceof Error ? err.message : String(err));
         }
@@ -1524,7 +1523,7 @@ var init_QdrantProvider = __esm({
         await this.http.put(`/collections/${this.indexName}/points`, payload);
       }
       async query(vector, topK, namespace, _filter) {
-        var _a2;
+        var _a3;
         const must = [];
         if (namespace) {
           must.push({ key: "namespace", match: { value: namespace } });
@@ -1546,7 +1545,7 @@ var init_QdrantProvider = __esm({
           limit: topK,
           with_payload: true,
           params: {
-            hnsw_ef: ((_a2 = this.config.options) == null ? void 0 : _a2.efSearch) || Math.max(topK * 20, 128),
+            hnsw_ef: ((_a3 = this.config.options) == null ? void 0 : _a3.efSearch) || Math.max(topK * 20, 128),
             exact: false
           },
           filter: must.length > 0 ? { must } : void 0
@@ -1641,13 +1640,13 @@ var init_ChromaDBProvider = __esm({
        * Get or create the ChromaDB collection.
        */
       async initialize() {
-        var _a2;
+        var _a3;
         try {
           const { data } = await this.http.get(`/api/v1/collections/${this.indexName}`);
           this.collectionId = data.id;
           console.log(`[ChromaDBProvider] \u2705 Collection "${this.indexName}" found (id: ${this.collectionId})`);
         } catch (err) {
-          if (axios5.isAxiosError(err) && ((_a2 = err.response) == null ? void 0 : _a2.status) === 404) {
+          if (axios5.isAxiosError(err) && ((_a3 = err.response) == null ? void 0 : _a3.status) === 404) {
             console.log(`[ChromaDBProvider] \u23F3 Collection "${this.indexName}" not found. Creating...`);
             const { data } = await this.http.post("/api/v1/collections", {
               name: this.indexName
@@ -1765,7 +1764,6 @@ var init_RedisProvider = __esm({
           await this.upsert(doc, namespace);
         }
       }
-      // eslint-disable-next-line @typescript-eslint/no-unused-vars
       async query(vector, topK, namespace, _filter) {
         const payload = {
           index: this.indexName,
@@ -1868,7 +1866,7 @@ var init_WeaviateProvider = __esm({
         await this.http.post("/v1/batch/objects", payload);
       }
       async query(vector, topK, namespace, _filter) {
-        var _a2, _b;
+        var _a3, _b;
         const queryText = _filter == null ? void 0 : _filter.queryText;
         const sanitizedFilter = this.sanitizeFilter(_filter);
         const searchParams = queryText ? `hybrid: { query: ${JSON.stringify(queryText)}, alpha: 0.5 }` : `nearVector: { vector: ${JSON.stringify(vector)} }`;
@@ -1894,7 +1892,7 @@ var init_WeaviateProvider = __esm({
       `
         };
         const { data } = await this.http.post("/v1/graphql", graphqlQuery);
-        const results = ((_b = (_a2 = data.data) == null ? void 0 : _a2.Get) == null ? void 0 : _b[this.indexName]) || [];
+        const results = ((_b = (_a3 = data.data) == null ? void 0 : _a3.Get) == null ? void 0 : _b[this.indexName]) || [];
         return results.map((res) => ({
           id: res["_additional"].id,
           score: 1 - res["_additional"].distance,
@@ -1902,7 +1900,6 @@ var init_WeaviateProvider = __esm({
           metadata: res["metadata"] ? JSON.parse(res["metadata"]) : {}
         }));
       }
-      // eslint-disable-next-line @typescript-eslint/no-unused-vars
       async delete(id, _namespace) {
         await this.http.delete(`/v1/objects/${this.indexName}/${id}`);
       }
@@ -1977,21 +1974,21 @@ var init_UniversalVectorProvider = __esm({
         }
       }
       async initialize() {
-        var _a2;
+        var _a3;
         this.http = axios8.create({
           baseURL: this.opts.baseUrl,
           headers: __spreadValues({
             "Content-Type": "application/json"
           }, this.opts.headers),
-          timeout: (_a2 = this.opts.timeout) != null ? _a2 : 3e4
+          timeout: (_a3 = this.opts.timeout) != null ? _a3 : 3e4
         });
         if (!await this.ping()) {
           throw new Error(`[UniversalVectorProvider] Failed to connect to ${this.opts.baseUrl}`);
         }
       }
       async upsert(doc, namespace) {
-        var _a2, _b, _c;
-        const endpoint = (_a2 = this.opts.upsertEndpoint) != null ? _a2 : "/upsert";
+        var _a3, _b, _c;
+        const endpoint = (_a3 = this.opts.upsertEndpoint) != null ? _a3 : "/upsert";
         const template = (_b = this.opts.upsertTemplate) != null ? _b : JSON.stringify({
           id: "{{id}}",
           vector: "{{vector}}",
@@ -2024,8 +2021,8 @@ var init_UniversalVectorProvider = __esm({
         }
       }
       async query(vector, topK, namespace, filter) {
-        var _a2, _b;
-        const endpoint = (_a2 = this.opts.queryEndpoint) != null ? _a2 : "/query";
+        var _a3, _b;
+        const endpoint = (_a3 = this.opts.queryEndpoint) != null ? _a3 : "/query";
         const template = (_b = this.opts.queryTemplate) != null ? _b : JSON.stringify({
           vector: "{{vector}}",
           limit: "{{topK}}",
@@ -2051,9 +2048,9 @@ var init_UniversalVectorProvider = __esm({
             );
           }
           return results.map((item) => {
-            var _a3, _b2, _c, _d, _e, _f, _g2;
+            var _a4, _b2, _c, _d, _e, _f, _g2;
             return {
-              id: item[(_a3 = this.opts.queryIdField) != null ? _a3 : "id"],
+              id: item[(_a4 = this.opts.queryIdField) != null ? _a4 : "id"],
               score: (_c = item[(_b2 = this.opts.queryScoreField) != null ? _b2 : "score"]) != null ? _c : 0,
               content: (_e = item[(_d = this.opts.queryContentField) != null ? _d : "content"]) != null ? _e : "",
               metadata: (_g2 = item[(_f = this.opts.queryMetadataField) != null ? _f : "metadata"]) != null ? _g2 : {}
@@ -2066,8 +2063,8 @@ var init_UniversalVectorProvider = __esm({
         }
       }
       async delete(id, namespace) {
-        var _a2, _b;
-        const endpoint = (_a2 = this.opts.deleteEndpoint) != null ? _a2 : "/delete";
+        var _a3, _b;
+        const endpoint = (_a3 = this.opts.deleteEndpoint) != null ? _a3 : "/delete";
         const template = (_b = this.opts.deleteTemplate) != null ? _b : JSON.stringify({
           id: "{{id}}",
           namespace: "{{namespace}}"
@@ -2085,8 +2082,8 @@ var init_UniversalVectorProvider = __esm({
         }
       }
       async deleteNamespace(namespace) {
-        var _a2;
-        const endpoint = (_a2 = this.opts.deleteNamespaceEndpoint) != null ? _a2 : "/delete-namespace";
+        var _a3;
+        const endpoint = (_a3 = this.opts.deleteNamespaceEndpoint) != null ? _a3 : "/delete-namespace";
         try {
           await this.http.post(endpoint, { namespace });
         } catch (error) {
@@ -2096,9 +2093,9 @@ var init_UniversalVectorProvider = __esm({
         }
       }
       async ping() {
-        var _a2;
+        var _a3;
         try {
-          const endpoint = (_a2 = this.opts.pingEndpoint) != null ? _a2 : "/health";
+          const endpoint = (_a3 = this.opts.pingEndpoint) != null ? _a3 : "/health";
           const response = await this.http.get(endpoint, { timeout: 5e3 });
           return response.status >= 200 && response.status < 300;
         } catch (e) {
@@ -2242,13 +2239,13 @@ var LicenseValidationError = class extends RetrivoraError {
   }
 };
 function wrapError(err, defaultCode, defaultMessage) {
-  var _a2;
+  var _a3;
   if (err instanceof RetrivoraError) {
     return err;
   }
   const error = err;
   const message = (error == null ? void 0 : error.message) || defaultMessage || String(err);
-  const status = (error == null ? void 0 : error.status) || (error == null ? void 0 : error.statusCode) || ((_a2 = error == null ? void 0 : error.response) == null ? void 0 : _a2.status);
+  const status = (error == null ? void 0 : error.status) || (error == null ? void 0 : error.statusCode) || ((_a3 = error == null ? void 0 : error.response) == null ? void 0 : _a3.status);
   const code = error == null ? void 0 : error.code;
   if (status === 429 || /rate[- ]?limit/i.test(message) || code === "RATE_LIMIT_EXCEEDED") {
     return new RateLimitException(message, err);
@@ -2530,8 +2527,8 @@ var UI_BORDER_RADIUS_OPTIONS = ["none", "sm", "md", "lg", "xl", "full"];
 
 // src/config/serverConfig.ts
 function readString(env, name) {
-  var _a2;
-  const value = (_a2 = env[name]) == null ? void 0 : _a2.trim();
+  var _a3;
+  const value = (_a3 = env[name]) == null ? void 0 : _a3.trim();
   return value ? value : void 0;
 }
 function readNumber(env, name, fallback) {
@@ -2544,8 +2541,8 @@ function readNumber(env, name, fallback) {
   return parsed;
 }
 function readEnum(env, name, fallback, allowed) {
-  var _a2;
-  const value = (_a2 = readString(env, name)) != null ? _a2 : fallback;
+  var _a3;
+  const value = (_a3 = readString(env, name)) != null ? _a3 : fallback;
   if (allowed.includes(value)) {
     return value;
   }
@@ -2555,8 +2552,8 @@ function getRagConfig(baseConfig, env = process.env) {
   return getEnvConfig(env, baseConfig);
 }
 function getEnvConfig(env = process.env, base) {
-  var _a2, _b, _c, _d, _e, _f, _g2, _h, _i, _j, _k, _l, _m, _n, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x, _y, _z, _A, _B, _C, _D, _E, _F, _G, _H, _I, _J, _K, _L, _M, _N, _O, _P, _Q, _R, _S, _T, _U, _V, _W, _X, _Y, _Z, __, _$, _aa, _ba, _ca, _da, _ea, _fa, _ga, _ha, _ia, _ja, _ka, _la, _ma, _na, _oa, _pa, _qa, _ra, _sa, _ta, _ua, _va, _wa, _xa, _ya, _za, _Aa, _Ba, _Ca, _Da, _Ea, _Fa, _Ga, _Ha, _Ia, _Ja, _Ka, _La, _Ma, _Na, _Oa, _Pa, _Qa, _Ra, _Sa, _Ta, _Ua, _Va, _Wa, _Xa, _Ya, _Za, __a, _$a, _ab, _bb, _cb, _db, _eb, _fb, _gb, _hb, _ib, _jb, _kb, _lb, _mb, _nb, _ob, _pb, _qb, _rb, _sb, _tb, _ub, _vb, _wb, _xb, _yb, _zb, _Ab, _Bb, _Cb, _Db, _Eb, _Fb, _Gb, _Hb, _Ib, _Jb, _Kb;
-  const licenseKey = (_d = (_c = (_b = (_a2 = readString(env, "RAG_LICENSE_KEY")) != null ? _a2 : readString(env, "RETRIVORA_LICENSE_KEY")) != null ? _b : readString(env, "NEXT_PUBLIC_RETRIVORA_LICENSE_KEY")) != null ? _c : readString(env, "LICENSE_KEY")) != null ? _d : base == null ? void 0 : base.licenseKey;
+  var _a3, _b, _c, _d, _e, _f, _g2, _h, _i, _j, _k, _l, _m, _n, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x, _y, _z, _A, _B, _C, _D, _E, _F, _G, _H, _I, _J, _K, _L, _M, _N, _O, _P, _Q, _R, _S, _T, _U, _V, _W, _X, _Y, _Z, __, _$, _aa, _ba, _ca, _da, _ea, _fa, _ga, _ha, _ia, _ja, _ka, _la, _ma, _na, _oa, _pa, _qa, _ra, _sa, _ta, _ua, _va, _wa, _xa, _ya, _za, _Aa, _Ba, _Ca, _Da, _Ea, _Fa, _Ga, _Ha, _Ia, _Ja, _Ka, _La, _Ma, _Na, _Oa, _Pa, _Qa, _Ra, _Sa, _Ta, _Ua, _Va, _Wa, _Xa, _Ya, _Za, __a, _$a, _ab, _bb, _cb, _db, _eb, _fb, _gb, _hb, _ib, _jb, _kb, _lb, _mb, _nb, _ob, _pb, _qb, _rb, _sb, _tb, _ub, _vb, _wb, _xb, _yb, _zb, _Ab, _Bb, _Cb, _Db, _Eb, _Fb, _Gb, _Hb, _Ib, _Jb, _Kb;
+  const licenseKey = (_d = (_c = (_b = (_a3 = readString(env, "RAG_LICENSE_KEY")) != null ? _a3 : readString(env, "RETRIVORA_LICENSE_KEY")) != null ? _b : readString(env, "NEXT_PUBLIC_RETRIVORA_LICENSE_KEY")) != null ? _c : readString(env, "LICENSE_KEY")) != null ? _d : base == null ? void 0 : base.licenseKey;
   const jwtProjectId = (() => {
     if (!licenseKey) return void 0;
     try {
@@ -2637,7 +2634,7 @@ function getEnvConfig(env = process.env, base) {
     rest: "default",
     custom: "default"
   };
-  const isFreeTier = (() => {
+  const isFreeTier2 = (() => {
     if (!licenseKey) return true;
     try {
       const payload = LicenseVerifier.verify(licenseKey, projectId);
@@ -2648,13 +2645,13 @@ function getEnvConfig(env = process.env, base) {
     }
   })();
   const defaultGatewayUrl = (_ra = (_qa = readString(env, "LITELLM_BASE_URL")) != null ? _qa : readString(env, "LLM_BASE_URL")) != null ? _ra : "https://www.retrivora.com/api/v1";
-  const defaultLlmProvider = isFreeTier ? "universal_rest" : "universal_rest";
+  const defaultLlmProvider = isFreeTier2 ? "universal_rest" : "universal_rest";
   const llmProvider = (_ua = (_ta = readEnum(env, "LLM_PROVIDER", defaultLlmProvider, LLM_PROVIDERS)) != null ? _ta : (_sa = base == null ? void 0 : base.llm) == null ? void 0 : _sa.provider) != null ? _ua : defaultLlmProvider;
   const llmBaseUrl = (_ya = (_xa = (_va = readString(env, "LITELLM_BASE_URL")) != null ? _va : readString(env, "LLM_BASE_URL")) != null ? _xa : (_wa = base == null ? void 0 : base.llm) == null ? void 0 : _wa.baseUrl) != null ? _ya : defaultGatewayUrl;
-  const llmModel = (_Ca = (_Aa = readString(env, "LLM_MODEL")) != null ? _Aa : (_za = base == null ? void 0 : base.llm) == null ? void 0 : _za.model) != null ? _Ca : isFreeTier ? "llama-3.1-8b-instant" : (_Ba = DEFAULT_MODEL_BY_PROVIDER[llmProvider]) != null ? _Ba : "gpt-4o";
+  const llmModel = (_Ca = (_Aa = readString(env, "LLM_MODEL")) != null ? _Aa : (_za = base == null ? void 0 : base.llm) == null ? void 0 : _za.model) != null ? _Ca : isFreeTier2 ? "llama-3.1-8b-instant" : (_Ba = DEFAULT_MODEL_BY_PROVIDER[llmProvider]) != null ? _Ba : "gpt-4o";
   const llmApiKey = (_Ia = (_Ha = (_Fa = (_Ea = (_Da = llmApiKeyByProvider[llmProvider]) != null ? _Da : readString(env, "LLM_API_KEY")) != null ? _Ea : readString(env, "LITELLM_MASTER_KEY")) != null ? _Fa : readString(env, "LITELLM_API_KEY")) != null ? _Ha : (_Ga = base == null ? void 0 : base.llm) == null ? void 0 : _Ga.apiKey) != null ? _Ia : licenseKey;
   const llmProfile = (_Ma = (_La = readString(env, "LLM_UNIVERSAL_PROFILE")) != null ? _La : (_Ka = (_Ja = base == null ? void 0 : base.llm) == null ? void 0 : _Ja.options) == null ? void 0 : _Ka.profile) != null ? _Ma : "litellm";
-  const defaultEmbeddingProvider = isFreeTier ? "universal_rest" : "universal_rest";
+  const defaultEmbeddingProvider = isFreeTier2 ? "universal_rest" : "universal_rest";
   const embeddingProvider = (_Pa = (_Oa = readEnum(env, "EMBEDDING_PROVIDER", defaultEmbeddingProvider, EMBEDDING_PROVIDERS)) != null ? _Oa : (_Na = base == null ? void 0 : base.embedding) == null ? void 0 : _Na.provider) != null ? _Pa : defaultEmbeddingProvider;
   const embeddingBaseUrl = (_Ua = (_Ta = (_Ra = (_Qa = readString(env, "LITELLM_BASE_URL")) != null ? _Qa : readString(env, "EMBEDDING_BASE_URL")) != null ? _Ra : readString(env, "LLM_BASE_URL")) != null ? _Ta : (_Sa = base == null ? void 0 : base.embedding) == null ? void 0 : _Sa.baseUrl) != null ? _Ua : defaultGatewayUrl;
   const embeddingModel = (_Xa = (_Wa = readString(env, "EMBEDDING_MODEL")) != null ? _Wa : (_Va = base == null ? void 0 : base.embedding) == null ? void 0 : _Va.model) != null ? _Xa : "text-embedding-004";
@@ -2744,8 +2741,8 @@ function getEnvConfig(env = process.env, base) {
     }
   } : {}), {
     mcpServers: (() => {
-      var _a3;
-      const raw = (_a3 = readString(env, "MCP_SERVERS")) != null ? _a3 : readString(env, "NEXT_PUBLIC_MCP_SERVERS");
+      var _a4;
+      const raw = (_a4 = readString(env, "MCP_SERVERS")) != null ? _a4 : readString(env, "NEXT_PUBLIC_MCP_SERVERS");
       if (!raw) return void 0;
       try {
         return JSON.parse(raw);
@@ -2790,10 +2787,10 @@ var ConfigResolver = class {
    * fallback behavior.
    */
   static resolveUniversal(hostConfig, env = process.env) {
-    var _a2;
+    var _a3;
     if (!hostConfig) return this.resolve(void 0, env);
     const normalized = __spreadProps(__spreadValues({}, hostConfig), {
-      vectorDb: (_a2 = hostConfig.vectorDb) != null ? _a2 : hostConfig.vectorDatabase,
+      vectorDb: (_a3 = hostConfig.vectorDb) != null ? _a3 : hostConfig.vectorDatabase,
       rag: this.mergeRetrievalWorkflow(hostConfig.rag, hostConfig.retrieval, hostConfig.workflow)
     });
     return this.resolve(normalized, env);
@@ -2813,11 +2810,11 @@ var ConfigResolver = class {
     }
   }
   static mergeRetrievalWorkflow(rag, retrieval, workflow) {
-    var _a2, _b, _c, _d, _e, _f;
+    var _a3, _b, _c, _d, _e, _f;
     if (!rag && !retrieval && !workflow) return void 0;
     const normalized = __spreadValues({}, rag != null ? rag : {});
     if (retrieval) {
-      normalized.topK = (_a2 = retrieval.topK) != null ? _a2 : normalized.topK;
+      normalized.topK = (_a3 = retrieval.topK) != null ? _a3 : normalized.topK;
       normalized.scoreThreshold = (_b = retrieval.scoreThreshold) != null ? _b : normalized.scoreThreshold;
       normalized.useReranking = (_c = retrieval.useReranking) != null ? _c : normalized.useReranking;
       if (retrieval.strategy === "hybrid") normalized.architecture = (_d = normalized.architecture) != null ? _d : "hybrid";
@@ -2945,8 +2942,8 @@ var OpenAIProvider = class {
     };
   }
   async chat(messages, context, options) {
-    var _a2, _b, _c, _d, _e, _f, _g2, _h, _i;
-    const basePrompt = (_b = (_a2 = options == null ? void 0 : options.systemPrompt) != null ? _a2 : this.llmConfig.systemPrompt) != null ? _b : "You are a helpful assistant. Answer questions based on the provided context.";
+    var _a3, _b, _c, _d, _e, _f, _g2, _h, _i;
+    const basePrompt = (_b = (_a3 = options == null ? void 0 : options.systemPrompt) != null ? _a3 : this.llmConfig.systemPrompt) != null ? _b : "You are a helpful assistant. Answer questions based on the provided context.";
     const systemMessage = {
       role: "system",
       content: buildSystemContent(basePrompt, context)
@@ -2970,8 +2967,8 @@ var OpenAIProvider = class {
   }
   chatStream(messages, context, options) {
     return __asyncGenerator(this, null, function* () {
-      var _a2, _b, _c, _d, _e, _f, _g2, _h;
-      const basePrompt = (_b = (_a2 = options == null ? void 0 : options.systemPrompt) != null ? _a2 : this.llmConfig.systemPrompt) != null ? _b : "You are a helpful assistant. Answer questions based on the provided context.";
+      var _a3, _b, _c, _d, _e, _f, _g2, _h;
+      const basePrompt = (_b = (_a3 = options == null ? void 0 : options.systemPrompt) != null ? _a3 : this.llmConfig.systemPrompt) != null ? _b : "You are a helpful assistant. Answer questions based on the provided context.";
       const systemMessage = {
         role: "system",
         content: buildSystemContent(basePrompt, context)
@@ -3018,8 +3015,8 @@ var OpenAIProvider = class {
     return results[0];
   }
   async batchEmbed(texts, options) {
-    var _a2, _b, _c, _d, _e;
-    const model = (_c = (_b = options == null ? void 0 : options.model) != null ? _b : (_a2 = this.embeddingConfig) == null ? void 0 : _a2.model) != null ? _c : "text-embedding-3-small";
+    var _a3, _b, _c, _d, _e;
+    const model = (_c = (_b = options == null ? void 0 : options.model) != null ? _b : (_a3 = this.embeddingConfig) == null ? void 0 : _a3.model) != null ? _c : "text-embedding-3-small";
     const apiKey = (_e = (_d = this.embeddingConfig) == null ? void 0 : _d.apiKey) != null ? _e : this.llmConfig.apiKey;
     const client = apiKey !== this.llmConfig.apiKey ? new OpenAI({ apiKey }) : this.client;
     const response = await client.embeddings.create({ model, input: texts });
@@ -3096,8 +3093,8 @@ var AnthropicProvider = class {
     };
   }
   async chat(messages, context, options) {
-    var _a2, _b, _c, _d, _e, _f, _g2, _h, _i, _j, _k;
-    const basePrompt = (_b = (_a2 = options == null ? void 0 : options.systemPrompt) != null ? _a2 : this.llmConfig.systemPrompt) != null ? _b : "You are a helpful assistant. Use the context below to answer the user's question accurately.";
+    var _a3, _b, _c, _d, _e, _f, _g2, _h, _i, _j, _k;
+    const basePrompt = (_b = (_a3 = options == null ? void 0 : options.systemPrompt) != null ? _a3 : this.llmConfig.systemPrompt) != null ? _b : "You are a helpful assistant. Use the context below to answer the user's question accurately.";
     const system = buildSystemContent(basePrompt, context);
     const anthropicMessages = messages.map((m) => ({
       role: m.role === "assistant" ? "assistant" : "user",
@@ -3135,8 +3132,8 @@ var AnthropicProvider = class {
   }
   chatStream(messages, context, options) {
     return __asyncGenerator(this, null, function* () {
-      var _a2, _b, _c, _d, _e, _f, _g2, _h, _i, _j, _k;
-      const basePrompt = (_b = (_a2 = options == null ? void 0 : options.systemPrompt) != null ? _a2 : this.llmConfig.systemPrompt) != null ? _b : "You are a helpful assistant. Use the context below to answer the user's question accurately.";
+      var _a3, _b, _c, _d, _e, _f, _g2, _h, _i, _j, _k;
+      const basePrompt = (_b = (_a3 = options == null ? void 0 : options.systemPrompt) != null ? _a3 : this.llmConfig.systemPrompt) != null ? _b : "You are a helpful assistant. Use the context below to answer the user's question accurately.";
       const system = buildSystemContent(basePrompt, context);
       const anthropicMessages = messages.map((m) => ({
         role: m.role === "assistant" ? "assistant" : "user",
@@ -3220,8 +3217,8 @@ var AnthropicProvider = class {
 import axios from "axios";
 var OllamaProvider = class {
   constructor(llmConfig, embeddingConfig) {
-    var _a2, _b, _c;
-    const rawBaseURL = ((_a2 = llmConfig.baseUrl) != null ? _a2 : "http://localhost:11434").replace(/\/+$/, "");
+    var _a3, _b, _c;
+    const rawBaseURL = ((_a3 = llmConfig.baseUrl) != null ? _a3 : "http://localhost:11434").replace(/\/+$/, "");
     const baseURL = rawBaseURL.replace(/\/(?:api\/v1|v1|api)$/i, "");
     const timeout = Number((_b = llmConfig.options) == null ? void 0 : _b.timeout) || 3e5;
     const headers = ((_c = llmConfig.options) == null ? void 0 : _c.headers) || {};
@@ -3281,8 +3278,8 @@ var OllamaProvider = class {
     };
   }
   async chat(messages, context, options) {
-    var _a2, _b, _c, _d, _e, _f;
-    const basePrompt = (_b = (_a2 = options == null ? void 0 : options.systemPrompt) != null ? _a2 : this.llmConfig.systemPrompt) != null ? _b : "You are a helpful assistant. Use the provided context to answer the user's question.";
+    var _a3, _b, _c, _d, _e, _f;
+    const basePrompt = (_b = (_a3 = options == null ? void 0 : options.systemPrompt) != null ? _a3 : this.llmConfig.systemPrompt) != null ? _b : "You are a helpful assistant. Use the provided context to answer the user's question.";
     const system = buildSystemContent(basePrompt, context);
     const { data } = await this.http.post("/api/chat", {
       model: this.llmConfig.model,
@@ -3300,8 +3297,8 @@ var OllamaProvider = class {
   }
   chatStream(messages, context, options) {
     return __asyncGenerator(this, null, function* () {
-      var _a2, _b, _c, _d, _e, _f, _g2, _h;
-      const basePrompt = (_b = (_a2 = options == null ? void 0 : options.systemPrompt) != null ? _a2 : this.llmConfig.systemPrompt) != null ? _b : "You are a helpful assistant. Use the provided context to answer the user's question.";
+      var _a3, _b, _c, _d, _e, _f, _g2, _h;
+      const basePrompt = (_b = (_a3 = options == null ? void 0 : options.systemPrompt) != null ? _a3 : this.llmConfig.systemPrompt) != null ? _b : "You are a helpful assistant. Use the provided context to answer the user's question.";
       const system = buildSystemContent(basePrompt, context);
       const response = yield new __await(this.http.post("/api/chat", {
         model: this.llmConfig.model,
@@ -3359,8 +3356,8 @@ var OllamaProvider = class {
     });
   }
   async embed(text, options) {
-    var _a2, _b, _c, _d, _e, _f, _g2, _h, _i, _j, _k;
-    const model = (_c = (_b = options == null ? void 0 : options.model) != null ? _b : (_a2 = this.embeddingConfig) == null ? void 0 : _a2.model) != null ? _c : "nomic-embed-text";
+    var _a3, _b, _c, _d, _e, _f, _g2, _h, _i, _j, _k;
+    const model = (_c = (_b = options == null ? void 0 : options.model) != null ? _b : (_a3 = this.embeddingConfig) == null ? void 0 : _a3.model) != null ? _c : "nomic-embed-text";
     const baseURL = (_f = (_e = (_d = this.embeddingConfig) == null ? void 0 : _d.baseUrl) != null ? _e : this.llmConfig.baseUrl) != null ? _f : "http://localhost:11434";
     const client = baseURL !== ((_g2 = this.llmConfig.baseUrl) != null ? _g2 : "http://localhost:11434") ? axios.create({ baseURL, timeout: 6e4 }) : this.http;
     let prompt = text;
@@ -3461,9 +3458,9 @@ var GeminiProvider = class {
   static getHealthChecker() {
     return {
       async check(config) {
-        var _a2, _b;
+        var _a3, _b;
         const timestamp = Date.now();
-        const apiKey = (_b = (_a2 = config.apiKey) != null ? _a2 : process.env.GOOGLE_GENAI_API_KEY) != null ? _b : "";
+        const apiKey = (_b = (_a3 = config.apiKey) != null ? _a3 : process.env.GOOGLE_GENAI_API_KEY) != null ? _b : "";
         const modelName = sanitizeModel(config.model);
         try {
           const { GoogleGenerativeAI: GoogleGenerativeAI2 } = await import("@google/generative-ai");
@@ -3493,16 +3490,16 @@ var GeminiProvider = class {
   /** Resolve the embedding client — uses a separate client when the embedding
    *  API key differs from the LLM API key. */
   get embeddingClient() {
-    var _a2;
-    if (((_a2 = this.embeddingConfig) == null ? void 0 : _a2.apiKey) && this.embeddingConfig.apiKey !== this.llmConfig.apiKey) {
+    var _a3;
+    if (((_a3 = this.embeddingConfig) == null ? void 0 : _a3.apiKey) && this.embeddingConfig.apiKey !== this.llmConfig.apiKey) {
       return buildClient(this.embeddingConfig.apiKey);
     }
     return this.client;
   }
   /** Resolve the embedding model to use, in order of specificity. */
   resolveEmbeddingModel(optionsModel) {
-    var _a2, _b;
-    return sanitizeModel((_b = optionsModel != null ? optionsModel : (_a2 = this.embeddingConfig) == null ? void 0 : _a2.model) != null ? _b : DEFAULT_EMBEDDING_MODEL);
+    var _a3, _b;
+    return sanitizeModel((_b = optionsModel != null ? optionsModel : (_a3 = this.embeddingConfig) == null ? void 0 : _a3.model) != null ? _b : DEFAULT_EMBEDDING_MODEL);
   }
   /**
    * Convert ChatMessage[] to the Gemini contents format.
@@ -3522,8 +3519,8 @@ var GeminiProvider = class {
   // ILLMProvider — chat
   // -------------------------------------------------------------------------
   async chat(messages, context, options) {
-    var _a2, _b, _c, _d, _e, _f;
-    const basePrompt = (_b = (_a2 = options == null ? void 0 : options.systemPrompt) != null ? _a2 : this.llmConfig.systemPrompt) != null ? _b : "You are a helpful assistant. Answer questions based on the provided context.";
+    var _a3, _b, _c, _d, _e, _f;
+    const basePrompt = (_b = (_a3 = options == null ? void 0 : options.systemPrompt) != null ? _a3 : this.llmConfig.systemPrompt) != null ? _b : "You are a helpful assistant. Answer questions based on the provided context.";
     const model = this.client.getGenerativeModel({
       model: this.llmConfig.model,
       systemInstruction: buildSystemContent(basePrompt, context)
@@ -3540,8 +3537,8 @@ var GeminiProvider = class {
   }
   chatStream(messages, context, options) {
     return __asyncGenerator(this, null, function* () {
-      var _a2, _b, _c, _d, _e, _f;
-      const basePrompt = (_b = (_a2 = options == null ? void 0 : options.systemPrompt) != null ? _a2 : this.llmConfig.systemPrompt) != null ? _b : "You are a helpful assistant. Answer questions based on the provided context.";
+      var _a3, _b, _c, _d, _e, _f;
+      const basePrompt = (_b = (_a3 = options == null ? void 0 : options.systemPrompt) != null ? _a3 : this.llmConfig.systemPrompt) != null ? _b : "You are a helpful assistant. Answer questions based on the provided context.";
       const model = this.client.getGenerativeModel({
         model: this.llmConfig.model,
         systemInstruction: buildSystemContent(basePrompt, context)
@@ -3576,11 +3573,11 @@ var GeminiProvider = class {
   // ILLMProvider — embeddings
   // -------------------------------------------------------------------------
   async embed(text, options) {
-    var _a2, _b;
+    var _a3, _b;
     const content = applyPrefix(
       text,
       options == null ? void 0 : options.taskType,
-      (_a2 = this.embeddingConfig) == null ? void 0 : _a2.queryPrefix,
+      (_a3 = this.embeddingConfig) == null ? void 0 : _a3.queryPrefix,
       (_b = this.embeddingConfig) == null ? void 0 : _b.documentPrefix
     );
     const modelName = this.resolveEmbeddingModel(options == null ? void 0 : options.model);
@@ -3597,7 +3594,7 @@ var GeminiProvider = class {
     const modelName = this.resolveEmbeddingModel(options == null ? void 0 : options.model);
     const model = this.embeddingClient.getGenerativeModel({ model: modelName });
     const requests = texts.map((text) => {
-      var _a2, _b;
+      var _a3, _b;
       return {
         content: {
           role: "user",
@@ -3605,7 +3602,7 @@ var GeminiProvider = class {
             text: applyPrefix(
               text,
               options == null ? void 0 : options.taskType,
-              (_a2 = this.embeddingConfig) == null ? void 0 : _a2.queryPrefix,
+              (_a3 = this.embeddingConfig) == null ? void 0 : _a3.queryPrefix,
               (_b = this.embeddingConfig) == null ? void 0 : _b.documentPrefix
             )
           }]
@@ -3622,8 +3619,8 @@ var GeminiProvider = class {
       throw err;
     });
     return response.embeddings.map((e) => {
-      var _a2;
-      return (_a2 = e.values) != null ? _a2 : [];
+      var _a3;
+      return (_a3 = e.values) != null ? _a3 : [];
     });
   }
   // -------------------------------------------------------------------------
@@ -3712,8 +3709,8 @@ var GroqProvider = class {
     };
   }
   async chat(messages, context, options) {
-    var _a2, _b, _c, _d, _e, _f, _g2, _h, _i;
-    const basePrompt = (_b = (_a2 = options == null ? void 0 : options.systemPrompt) != null ? _a2 : this.llmConfig.systemPrompt) != null ? _b : "You are a helpful assistant. Answer questions based on the provided context.";
+    var _a3, _b, _c, _d, _e, _f, _g2, _h, _i;
+    const basePrompt = (_b = (_a3 = options == null ? void 0 : options.systemPrompt) != null ? _a3 : this.llmConfig.systemPrompt) != null ? _b : "You are a helpful assistant. Answer questions based on the provided context.";
     const systemMessage = {
       role: "system",
       content: buildSystemContent(basePrompt, context)
@@ -3737,8 +3734,8 @@ var GroqProvider = class {
   }
   chatStream(messages, context, options) {
     return __asyncGenerator(this, null, function* () {
-      var _a2, _b, _c, _d, _e, _f, _g2, _h;
-      const basePrompt = (_b = (_a2 = options == null ? void 0 : options.systemPrompt) != null ? _a2 : this.llmConfig.systemPrompt) != null ? _b : "You are a helpful assistant. Answer questions based on the provided context.";
+      var _a3, _b, _c, _d, _e, _f, _g2, _h;
+      const basePrompt = (_b = (_a3 = options == null ? void 0 : options.systemPrompt) != null ? _a3 : this.llmConfig.systemPrompt) != null ? _b : "You are a helpful assistant. Answer questions based on the provided context.";
       const systemMessage = {
         role: "system",
         content: buildSystemContent(basePrompt, context)
@@ -3872,8 +3869,8 @@ var QwenProvider = class {
     };
   }
   async chat(messages, context, options) {
-    var _a2, _b, _c, _d, _e, _f, _g2, _h, _i;
-    const basePrompt = (_b = (_a2 = options == null ? void 0 : options.systemPrompt) != null ? _a2 : this.llmConfig.systemPrompt) != null ? _b : "You are a helpful assistant. Answer questions based on the provided context.";
+    var _a3, _b, _c, _d, _e, _f, _g2, _h, _i;
+    const basePrompt = (_b = (_a3 = options == null ? void 0 : options.systemPrompt) != null ? _a3 : this.llmConfig.systemPrompt) != null ? _b : "You are a helpful assistant. Answer questions based on the provided context.";
     const systemMessage = {
       role: "system",
       content: buildSystemContent(basePrompt, context)
@@ -3897,8 +3894,8 @@ var QwenProvider = class {
   }
   chatStream(messages, context, options) {
     return __asyncGenerator(this, null, function* () {
-      var _a2, _b, _c, _d, _e, _f, _g2, _h;
-      const basePrompt = (_b = (_a2 = options == null ? void 0 : options.systemPrompt) != null ? _a2 : this.llmConfig.systemPrompt) != null ? _b : "You are a helpful assistant. Answer questions based on the provided context.";
+      var _a3, _b, _c, _d, _e, _f, _g2, _h;
+      const basePrompt = (_b = (_a3 = options == null ? void 0 : options.systemPrompt) != null ? _a3 : this.llmConfig.systemPrompt) != null ? _b : "You are a helpful assistant. Answer questions based on the provided context.";
       const systemMessage = {
         role: "system",
         content: buildSystemContent(basePrompt, context)
@@ -3945,8 +3942,8 @@ var QwenProvider = class {
     return results[0];
   }
   async batchEmbed(texts, options) {
-    var _a2, _b, _c, _d, _e, _f;
-    const model = (_c = (_b = options == null ? void 0 : options.model) != null ? _b : (_a2 = this.embeddingConfig) == null ? void 0 : _a2.model) != null ? _c : "text-embedding-v1";
+    var _a3, _b, _c, _d, _e, _f;
+    const model = (_c = (_b = options == null ? void 0 : options.model) != null ? _b : (_a3 = this.embeddingConfig) == null ? void 0 : _a3.model) != null ? _c : "text-embedding-v1";
     const apiKey = (_e = (_d = this.embeddingConfig) == null ? void 0 : _d.apiKey) != null ? _e : this.llmConfig.apiKey;
     const client = apiKey !== this.llmConfig.apiKey ? new OpenAI3({
       apiKey,
@@ -4046,9 +4043,9 @@ var VECTOR_PROFILES = {
 
 // src/llm/providers/UniversalLLMAdapter.ts
 function extractContent(obj) {
-  var _a2, _b, _c;
+  var _a3, _b, _c;
   if (!obj || typeof obj !== "object") return void 0;
-  const choice = (_a2 = obj.choices) == null ? void 0 : _a2[0];
+  const choice = (_a3 = obj.choices) == null ? void 0 : _a3[0];
   if (!choice) return void 0;
   if (typeof ((_b = choice.message) == null ? void 0 : _b.content) === "string") return choice.message.content;
   if (typeof ((_c = choice.delta) == null ? void 0 : _c.content) === "string") return choice.delta.content;
@@ -4058,10 +4055,10 @@ function extractContent(obj) {
 }
 var UniversalLLMAdapter = class {
   constructor(config) {
-    var _a2, _b, _c, _d, _e, _f, _g2, _h;
+    var _a3, _b, _c, _d, _e, _f, _g2, _h;
     this.model = config.model;
     const llmConfig = config;
-    const options = (_a2 = llmConfig.options) != null ? _a2 : {};
+    const options = (_a3 = llmConfig.options) != null ? _a3 : {};
     let profile = {};
     if (typeof options.profile === "string") {
       profile = LLM_PROFILES[options.profile] || {};
@@ -4087,8 +4084,8 @@ var UniversalLLMAdapter = class {
     });
   }
   async chat(messages, context) {
-    var _a2, _b, _c, _d, _e;
-    const path2 = (_a2 = this.opts.chatPath) != null ? _a2 : "/chat/completions";
+    var _a3, _b, _c, _d, _e;
+    const path2 = (_a3 = this.opts.chatPath) != null ? _a3 : "/chat/completions";
     const safeMessages = (Array.isArray(messages) ? messages : []).filter((m) => Boolean(m && typeof m === "object")).map((m) => ({
       role: m.role || "user",
       content: typeof m.content === "string" ? m.content : m.content != null ? String(m.content) : ""
@@ -4154,8 +4151,8 @@ ${context != null ? context : "None"}` },
    */
   chatStream(messages, context) {
     return __asyncGenerator(this, null, function* () {
-      var _a2, _b, _c, _d, _e, _f;
-      const path2 = (_a2 = this.opts.chatPath) != null ? _a2 : "/chat/completions";
+      var _a3, _b, _c, _d, _e, _f;
+      const path2 = (_a3 = this.opts.chatPath) != null ? _a3 : "/chat/completions";
       const url = `${this.baseUrl.replace(/\/$/, "")}${path2}`;
       const extractPath = ((_b = this.opts.responseExtractPath) != null ? _b : "choices[0].message.content").replace("message.content", "delta.content");
       const safeMessages = (Array.isArray(messages) ? messages : []).filter((m) => Boolean(m && typeof m === "object")).map((m) => ({
@@ -4281,8 +4278,8 @@ ${context != null ? context : "None"}` },
     });
   }
   async embed(text) {
-    var _a2, _b, _c, _d, _e;
-    const path2 = (_a2 = this.opts.embedPath) != null ? _a2 : "/embeddings";
+    var _a3, _b, _c, _d, _e;
+    const path2 = (_a3 = this.opts.embedPath) != null ? _a3 : "/embeddings";
     const payload = this.opts.embedPayloadTemplate ? buildPayload(this.opts.embedPayloadTemplate, { input: text, model: this.model }) : { input: text, model: this.model };
     try {
       const { data: data2 } = await this.http.post(path2, payload);
@@ -4371,7 +4368,7 @@ var LLMFactory = class _LLMFactory {
     ];
   }
   static create(llmConfig, embeddingConfig) {
-    var _a2, _b, _c;
+    var _a3, _b, _c;
     switch (llmConfig.provider) {
       case "openai":
         return new OpenAIProvider(llmConfig, embeddingConfig);
@@ -4390,7 +4387,7 @@ var LLMFactory = class _LLMFactory {
       case "custom":
         return new UniversalLLMAdapter(llmConfig);
       default: {
-        const providerName = String((_a2 = llmConfig.provider) != null ? _a2 : "").toLowerCase();
+        const providerName = String((_a3 = llmConfig.provider) != null ? _a3 : "").toLowerCase();
         const customFactory = customProviders.get(providerName);
         if (customFactory) {
           return customFactory(llmConfig);
@@ -4492,7 +4489,7 @@ var ProviderRegistry = class {
     return null;
   }
   static async loadVectorProviderClass(provider) {
-    var _a2;
+    var _a3;
     if (this.vectorProviders[provider]) return this.vectorProviders[provider];
     switch (provider) {
       case "pinecone": {
@@ -4501,7 +4498,7 @@ var ProviderRegistry = class {
       }
       case "pgvector":
       case "postgresql": {
-        const postgresMode = ((_a2 = process.env.POSTGRES_MODE) != null ? _a2 : "multi").toLowerCase();
+        const postgresMode = ((_a3 = process.env.POSTGRES_MODE) != null ? _a3 : "multi").toLowerCase();
         if (postgresMode === "single") {
           const { PostgreSQLProvider: PostgreSQLProvider2 } = await Promise.resolve().then(() => (init_PostgreSQLProvider(), PostgreSQLProvider_exports));
           return PostgreSQLProvider2;
@@ -4724,7 +4721,7 @@ var ConfigValidator = class {
 // package.json
 var package_default = {
   name: "@retrivora-ai/rag-engine",
-  version: "2.3.0",
+  version: "2.3.2",
   description: "Retrivora AI is a plug-and-play AI engine for RAG chat experiences \u2014 generic vector DB + LLM provider, embeddable or standalone.",
   author: "Abhinav Alkuchi",
   license: "UNLICENSED",
@@ -4803,6 +4800,7 @@ var package_default = {
     build: "npm run build:pkg",
     "build:pkg": "npx @tailwindcss/cli -i src/tailwind.css -o src/index.css && tsup src/index.ts src/handlers/index.ts src/server.ts --format cjs,esm --dts --clean --no-splitting --tsconfig tsconfig.build.json --external react,react-dom,next,mongodb,pg,openai,@anthropic-ai/sdk,@pinecone-database/pinecone,axios,lucide-react,mammoth,pdf-parse,xlsx,react-markdown,remark-gfm,next-themes,langchain,@langchain/core,@langchain/openai,llamaindex --inject-style && npx @tailwindcss/cli -i src/tailwind.css -o dist/index.css",
     lint: "eslint",
+    typecheck: "tsc --noEmit -p tsconfig.build.json",
     clean: "rm -rf dist"
   },
   peerDependencies: {
@@ -5029,8 +5027,8 @@ var Reranker = class {
         return matches.sort((a, b) => b.score - a.score).slice(0, limit);
       }
       const scoredMatches = matches.map((match) => {
-        var _a2;
-        const contentLower = ((_a2 = match == null ? void 0 : match.content) != null ? _a2 : "").toLowerCase();
+        var _a3;
+        const contentLower = ((_a3 = match == null ? void 0 : match.content) != null ? _a3 : "").toLowerCase();
         let keywordScore = 0;
         keywords.forEach((keyword) => {
           if (contentLower.includes(keyword)) {
@@ -5052,8 +5050,8 @@ var Reranker = class {
 
 Documents:
 ${topN.map((m, i) => {
-          var _a2;
-          return `[${i}] ${((_a2 = m == null ? void 0 : m.content) != null ? _a2 : "").replace(/\n/g, " ")}`;
+          var _a3;
+          return `[${i}] ${((_a3 = m == null ? void 0 : m.content) != null ? _a3 : "").replace(/\n/g, " ")}`;
         }).join("\n")}` }],
         "",
         {
@@ -5097,11 +5095,11 @@ var LlamaIndexIngestor = class {
    * than standard character-count splitting.
    */
   async chunk(text, options = {}) {
-    var _a2, _b;
+    var _a3, _b;
     try {
       const { Document, SentenceSplitter, MetadataMode } = await import(`${"llamaindex"}`);
       const splitter = new SentenceSplitter({
-        chunkSize: (_a2 = options.chunkSize) != null ? _a2 : 1e3,
+        chunkSize: (_a3 = options.chunkSize) != null ? _a3 : 1e3,
         chunkOverlap: (_b = options.chunkOverlap) != null ? _b : 200
       });
       const doc = new Document({ text, metadata: options.metadata || {} });
@@ -5189,7 +5187,6 @@ When presenting structured data, statistics, or comparisons, decide if it is bes
         finalSystemPrompt += chartInstruction;
       }
       this.agent = createAgent({
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
         model: chatModel,
         tools: [searchTool],
         systemPrompt: finalSystemPrompt
@@ -5210,7 +5207,7 @@ ${error instanceof Error ? error.message : String(error)}`
    * The agent returns `{ messages: [...] }` — the last message is the final answer.
    */
   async run(input, chatHistory = []) {
-    var _a2, _b, _c;
+    var _a3, _b, _c;
     if (!this.agent) {
       throw new Error("[LangChainAgent] Agent not initialized. Call initialize() first.");
     }
@@ -5221,7 +5218,7 @@ ${error instanceof Error ? error.message : String(error)}`
     const response = await this.agent.invoke({
       messages: [...historyMessages, new HumanMessage(input)]
     });
-    const lastMessage = (_a2 = response == null ? void 0 : response.messages) == null ? void 0 : _a2.at(-1);
+    const lastMessage = (_a3 = response == null ? void 0 : response.messages) == null ? void 0 : _a3.at(-1);
     if (lastMessage && typeof lastMessage.content === "string") {
       return lastMessage.content;
     }
@@ -5273,7 +5270,7 @@ var MCPClient = class {
     }
   }
   async connectStdio() {
-    var _a2;
+    var _a3;
     const cmd = this.config.command;
     if (!cmd) {
       throw new Error(`[MCPClient] Command option is required for stdio transport on "${this.config.name}"`);
@@ -5288,7 +5285,7 @@ var MCPClient = class {
       this.stdioBuffer += data.toString("utf-8");
       this.processStdioLines();
     });
-    (_a2 = this.childProcess.stderr) == null ? void 0 : _a2.on("data", (data) => {
+    (_a3 = this.childProcess.stderr) == null ? void 0 : _a3.on("data", (data) => {
       console.warn(`[MCPClient] [stderr] [${this.config.name}]:`, data.toString("utf-8"));
     });
     this.childProcess.on("close", (code) => {
@@ -5363,14 +5360,14 @@ var MCPClient = class {
     }
   }
   async sendNotification(method, params) {
-    var _a2;
+    var _a3;
     const notification = {
       jsonrpc: "2.0",
       method,
       params
     };
     if (this.config.transport === "stdio") {
-      if ((_a2 = this.childProcess) == null ? void 0 : _a2.stdin) {
+      if ((_a3 = this.childProcess) == null ? void 0 : _a3.stdin) {
         this.childProcess.stdin.write(JSON.stringify(notification) + "\n", "utf-8");
       }
     } else if (this.sseUrl) {
@@ -5448,11 +5445,11 @@ var MCPRegistry = class {
 // src/core/MultiAgentCoordinator.ts
 var MultiAgentCoordinator = class {
   constructor(options) {
-    var _a2;
+    var _a3;
     this.llmProvider = options.llmProvider;
     this.mcpRegistry = options.mcpRegistry;
     this.documentSearch = options.documentSearch;
-    this.maxIterations = (_a2 = options.maxIterations) != null ? _a2 : 5;
+    this.maxIterations = (_a3 = options.maxIterations) != null ? _a3 : 5;
   }
   /**
    * Run the multi-agent coordination loop synchronously and return the final response.
@@ -5504,8 +5501,8 @@ Available Tools:
 
 ${mcpTools.length > 0 ? "MCP Server Tools:" : ""}
 ${mcpTools.map((mt) => {
-        var _a2;
-        return `- ${mt.tool.name}(${JSON.stringify(((_a2 = mt.tool.inputSchema) == null ? void 0 : _a2.properties) || {})}): ${mt.tool.description || "No description provided."}`;
+        var _a3;
+        return `- ${mt.tool.name}(${JSON.stringify(((_a3 = mt.tool.inputSchema) == null ? void 0 : _a3.properties) || {})}): ${mt.tool.description || "No description provided."}`;
       }).join("\n")}
 
 Tool Calling Protocol:
@@ -5663,6 +5660,100 @@ ${toolResultText}`
   }
 };
 
+// src/core/CircuitBreaker.ts
+var CircuitBreaker = class {
+  constructor(options = {}) {
+    this.state = "closed";
+    this.failureCount = 0;
+    this.successCount = 0;
+    this.lastFailureAt = 0;
+    this.halfOpenCalls = 0;
+    var _a3, _b, _c;
+    this.failureThreshold = (_a3 = options.failureThreshold) != null ? _a3 : 5;
+    this.resetTimeoutMs = (_b = options.resetTimeoutMs) != null ? _b : 3e4;
+    this.halfOpenMaxCalls = (_c = options.halfOpenMaxCalls) != null ? _c : 1;
+  }
+  record(success) {
+    const now = Date.now();
+    if (success) {
+      this.successCount++;
+      if (this.state === "half-open") {
+        this.state = "closed";
+        this.failureCount = 0;
+        this.halfOpenCalls = 0;
+        this.successCount = 1;
+      } else if (this.state === "closed") {
+        if (this.successCount >= this.failureThreshold) {
+          this.failureCount = Math.max(0, this.failureCount - 1);
+          this.successCount = 0;
+        }
+      }
+    } else {
+      this.failureCount++;
+      this.lastFailureAt = now;
+      this.successCount = 0;
+      if (this.state === "half-open") {
+        this.state = "open";
+        this.halfOpenCalls = 0;
+      } else if (this.state === "closed" && this.failureCount >= this.failureThreshold) {
+        this.state = "open";
+      }
+    }
+  }
+  canExecute() {
+    const now = Date.now();
+    if (this.state === "closed") {
+      return true;
+    }
+    if (this.state === "open") {
+      if (now - this.lastFailureAt >= this.resetTimeoutMs) {
+        this.state = "half-open";
+        this.halfOpenCalls = 0;
+        return true;
+      }
+      return false;
+    }
+    if (this.state === "half-open") {
+      return this.halfOpenCalls < this.halfOpenMaxCalls;
+    }
+    return true;
+  }
+  async wrap(fn) {
+    if (!this.canExecute()) {
+      const retryAfterSec = Math.ceil(
+        Math.max(0, this.resetTimeoutMs - (Date.now() - this.lastFailureAt)) / 1e3
+      );
+      throw new Error(
+        `Circuit breaker is open. Try again in ${retryAfterSec}s. Failed ${this.failureCount}/${this.failureThreshold} consecutive calls.`
+      );
+    }
+    if (this.state === "half-open") {
+      this.halfOpenCalls++;
+    }
+    try {
+      const result = await fn();
+      this.record(true);
+      return result;
+    } catch (err) {
+      this.record(false);
+      throw err;
+    }
+  }
+  getState() {
+    return this.state;
+  }
+  getFailureCount() {
+    return this.failureCount;
+  }
+  reset() {
+    this.state = "closed";
+    this.failureCount = 0;
+    this.successCount = 0;
+    this.lastFailureAt = 0;
+    this.halfOpenCalls = 0;
+  }
+};
+
 // src/core/BatchProcessor.ts
 function isTransientError(error) {
   if (!(error instanceof Error)) return false;
@@ -5686,7 +5777,34 @@ function calculateBackoffDelay(attempt, initialDelayMs, maxDelayMs, multiplier)
 function sleep(ms) {
   return new Promise((resolve) => setTimeout(resolve, ms));
 }
-var BatchProcessor = class {
+var _BatchProcessor = class _BatchProcessor {
+  /**
+   * Execute a processor call through the circuit breaker.
+   * Only transient failures count toward opening the circuit.
+   */
+  static async executeWithCircuitBreaker(processor) {
+    if (!this.cb.canExecute()) {
+      const retryAfterSec = Math.ceil(
+        Math.max(0, 3e4 - (Date.now() - this.cb.lastFailureAt || 0)) / 1e3
+      );
+      throw new Error(
+        `[BatchProcessor] Circuit breaker is open. Try again in ${retryAfterSec}s.`
+      );
+    }
+    if (this.cb.state === "half-open") {
+      this.cb.halfOpenCalls++;
+    }
+    try {
+      const result = await processor();
+      this.cb.record(true);
+      return result;
+    } catch (err) {
+      if (isTransientError(err)) {
+        this.cb.record(false);
+      }
+      throw err;
+    }
+  }
   /**
    * Processes an array of items in configurable batches with retry logic.
    *
@@ -5727,7 +5845,7 @@ var BatchProcessor = class {
       let lastError;
       for (let attempt = 0; attempt <= maxRetries; attempt++) {
         try {
-          const result = await processor(batch);
+          const result = await _BatchProcessor.executeWithCircuitBreaker(() => processor(batch));
           results.push(result);
           success = true;
           break;
@@ -5785,7 +5903,7 @@ ${errorMessages}`
       let lastError;
       for (let attempt = 0; attempt <= maxRetries; attempt++) {
         try {
-          const result = await processor(item);
+          const result = await _BatchProcessor.executeWithCircuitBreaker(() => processor(item));
           results.push(result);
           success = true;
           break;
@@ -5858,7 +5976,7 @@ ${errorMessages}`
       }));
       const chunkPromises = chunk.map(async ({ item, originalIndex }) => {
         try {
-          const result = await processor(item);
+          const result = await _BatchProcessor.executeWithCircuitBreaker(() => processor(item));
           return { success: true, result, index: originalIndex };
         } catch (err) {
           const error = err instanceof Error ? err : new Error(String(err));
@@ -5886,6 +6004,12 @@ ${errorMessages}`
     return { results, errors, totalProcessed, totalFailed };
   }
 };
+_BatchProcessor.cb = new CircuitBreaker({
+  failureThreshold: 5,
+  resetTimeoutMs: 3e4,
+  halfOpenMaxCalls: 1
+});
+var BatchProcessor = _BatchProcessor;
 
 // src/config/EmbeddingStrategy.ts
 var EmbeddingStrategy = /* @__PURE__ */ ((EmbeddingStrategy2) => {
@@ -5989,7 +6113,7 @@ var QueryProcessor = class {
    * @param validFields Optional list of known filterable fields to look for
    */
   static extractQueryFieldHints(question, validFields = []) {
-    var _a2, _b, _c, _d;
+    var _a3, _b, _c, _d;
     if (!question.trim()) return [];
     const hints = /* @__PURE__ */ new Map();
     const addHint = (value, field) => {
@@ -6069,7 +6193,7 @@ var QueryProcessor = class {
     ];
     for (const p of universalPatterns) {
       for (const match of question.matchAll(p.regex)) {
-        const val = p.group ? (_a2 = match[p.group]) != null ? _a2 : match[0] : match[0];
+        const val = p.group ? (_a3 = match[p.group]) != null ? _a3 : match[0] : match[0];
         if (!val) continue;
         if (p.field) addHint(val, p.field);
         else addHint(val);
@@ -6293,11 +6417,11 @@ var LLMRouter = class {
    *   When provided it is used directly as the 'default' role without re-constructing.
    */
   async initialize(prebuiltDefault) {
-    var _a2;
+    var _a3;
     const defaultModel = prebuiltDefault != null ? prebuiltDefault : LLMFactory.create(this.config.llm, this.config.embedding);
     this.models.set("default", defaultModel);
     const envFastModel = process.env.FAST_LLM_MODEL;
-    const providerFastDefault = (_a2 = FAST_MODEL_DEFAULTS[this.config.llm.provider]) != null ? _a2 : "";
+    const providerFastDefault = (_a3 = FAST_MODEL_DEFAULTS[this.config.llm.provider]) != null ? _a3 : "";
     const fastModelName = envFastModel || providerFastDefault;
     if (fastModelName && fastModelName !== this.config.llm.model) {
       console.log(`[LLMRouter] Fast role \u2192 provider="${this.config.llm.provider}" model="${fastModelName}"`);
@@ -6316,8 +6440,8 @@ var LLMRouter = class {
    * Falls back to 'default' if the requested role is not registered.
    */
   get(role) {
-    var _a2;
-    const provider = (_a2 = this.models.get(role)) != null ? _a2 : this.models.get("default");
+    var _a3;
+    const provider = (_a3 = this.models.get(role)) != null ? _a3 : this.models.get("default");
     if (!provider) {
       throw new Error(`[LLMRouter] No provider registered for role: "${role}". Did you call initialize()?`);
     }
@@ -6403,8 +6527,8 @@ var IntentClassifier = class {
       numericFieldCount = numericKeys.size;
       categoricalFieldCount = catKeys.size;
       if (productKeyMatches >= 2 || docs.some((d) => {
-        var _a2, _b;
-        return ((_a2 = d == null ? void 0 : d.content) != null ? _a2 : "").toLowerCase().includes("price") || ((_b = d == null ? void 0 : d.content) != null ? _b : "").toLowerCase().includes("brand");
+        var _a3, _b;
+        return ((_a3 = d == null ? void 0 : d.content) != null ? _a3 : "").toLowerCase().includes("price") || ((_b = d == null ? void 0 : d.content) != null ? _b : "").toLowerCase().includes("brand");
       })) {
         isProductLike = true;
       }
@@ -6686,8 +6810,8 @@ var TextRendererStrategy = class {
     }
     const docs = Array.isArray(data) ? data : [];
     const text = docs.map((d) => {
-      var _a2;
-      return (_a2 = d == null ? void 0 : d.content) != null ? _a2 : "";
+      var _a3;
+      return (_a3 = d == null ? void 0 : d.content) != null ? _a3 : "";
     }).join("\n\n");
     return { type: "text", title, data: { content: text || "No detailed content available." } };
   }
@@ -6830,9 +6954,9 @@ var LRUDecisionCache = class {
     this.maxSize = maxSize;
   }
   generateKey(context) {
-    var _a2, _b;
+    var _a3, _b;
     const q = (context.userQuery || "").toLowerCase().trim();
-    const docCount = (_b = (_a2 = context.retrievedDocuments) == null ? void 0 : _a2.length) != null ? _b : 0;
+    const docCount = (_b = (_a3 = context.retrievedDocuments) == null ? void 0 : _a3.length) != null ? _b : 0;
     return `${q}::docs:${docCount}`;
   }
   get(context) {
@@ -6941,7 +7065,7 @@ var UITransformer = class _UITransformer {
    * Prefer `analyzeAndDecide()` in production.
    */
   static transform(userQuery, retrievedData, config, trainedSchema, intent) {
-    var _a2, _b, _c;
+    var _a3, _b, _c;
     if (!retrievedData || retrievedData.length === 0) {
       return this.createTextResponse("No data available", "No relevant data found for your query.");
     }
@@ -6961,7 +7085,7 @@ var UITransformer = class _UITransformer {
       return this.transformToBarChart(filteredData, profile, userQuery, resolvedIntent.visualizationHint === "ranking");
     }
     if (resolvedIntent.visualizationHint === "distribution") {
-      return (_a2 = this.transformToHistogram(profile, userQuery)) != null ? _a2 : this.transformToBarChart(filteredData, profile, userQuery);
+      return (_a3 = this.transformToHistogram(profile, userQuery)) != null ? _a3 : this.transformToBarChart(filteredData, profile, userQuery);
     }
     if (resolvedIntent.visualizationHint === "correlation") {
       return (_b = this.transformToScatterPlot(profile, userQuery)) != null ? _b : this.transformToBarChart(filteredData, profile, userQuery);
@@ -7294,11 +7418,11 @@ ${schemaProfileText}` : ""}`;
     };
   }
   static transformToPieChart(data, profile, query = "") {
-    var _a2;
+    var _a3;
     const dimension = profile ? this.selectDimensionField(profile, query) : void 0;
     const categories = dimension ? Array.from(new Set(profile.records.map((record) => {
-      var _a3;
-      return String((_a3 = record.fields[dimension.key]) != null ? _a3 : "");
+      var _a4;
+      return String((_a4 = record.fields[dimension.key]) != null ? _a4 : "");
     }).filter(Boolean))) : this.detectCategories(data);
     if (categories.length === 0) return null;
     const categoryData = dimension && profile ? this.aggregateProfileByDimension(profile, dimension.key) : this.aggregateByCategory(data, categories);
@@ -7308,7 +7432,7 @@ ${schemaProfileText}` : ""}`;
     });
     return {
       type: "pie_chart",
-      title: `Distribution by ${(_a2 = dimension == null ? void 0 : dimension.label) != null ? _a2 : "Category"}`,
+      title: `Distribution by ${(_a3 = dimension == null ? void 0 : dimension.label) != null ? _a3 : "Category"}`,
       description: `Showing breakdown across ${pieData.length} categories`,
       data: pieData
     };
@@ -7318,8 +7442,8 @@ ${schemaProfileText}` : ""}`;
     const valueField = profile.numericFields[0];
     const buckets = /* @__PURE__ */ new Map();
     profile.records.forEach((record) => {
-      var _a2, _b, _c;
-      const timestamp = String((_a2 = record.fields[dateField.key]) != null ? _a2 : "");
+      var _a3, _b, _c;
+      const timestamp = String((_a3 = record.fields[dateField.key]) != null ? _a3 : "");
       const value = (_b = this.toFiniteNumber(record.fields[valueField.key])) != null ? _b : 0;
       buckets.set(timestamp, ((_c = buckets.get(timestamp)) != null ? _c : 0) + value);
     });
@@ -7332,23 +7456,23 @@ ${schemaProfileText}` : ""}`;
     };
   }
   static transformToBarChart(data, profile, query = "", horizontal = false) {
-    var _a2;
+    var _a3;
     const dimension = profile ? this.selectDimensionField(profile, query) : void 0;
     const measure = profile ? this.selectNumericField(profile, query) : void 0;
     const aggregate = dimension && profile ? this.aggregateProfileByDimension(profile, dimension.key, measure == null ? void 0 : measure.key) : this.aggregateByCategory(data, this.detectCategories(data));
     const barData = Object.entries(aggregate).map(([category, value]) => ({ category, value: Number(value) })).sort((a, b) => horizontal ? b.value - a.value : 0).slice(0, 12);
     const fallbackData = barData.length > 0 ? barData : data.slice(0, 12).map((item, index) => {
-      var _a3, _b, _c, _d, _e;
+      var _a4, _b, _c, _d, _e;
       const meta = item.metadata || {};
       const label = String(
-        (_c = (_b = (_a3 = this.getDynamicVal(meta, "name")) != null ? _a3 : meta.label) != null ? _b : meta.title) != null ? _c : `Result ${index + 1}`
+        (_c = (_b = (_a4 = this.getDynamicVal(meta, "name")) != null ? _a4 : meta.label) != null ? _b : meta.title) != null ? _c : `Result ${index + 1}`
       );
       const value = (_e = (_d = this.extractNumericValue(meta)) != null ? _d : item.score) != null ? _e : 0;
       return { category: label, value: Number(value) };
     });
     return {
       type: horizontal ? "horizontal_bar" : "bar_chart",
-      title: dimension ? `${(_a2 = measure == null ? void 0 : measure.label) != null ? _a2 : "Count"} by ${dimension.label}` : "Comparison",
+      title: dimension ? `${(_a3 = measure == null ? void 0 : measure.label) != null ? _a3 : "Count"} by ${dimension.label}` : "Comparison",
       description: `Showing ${fallbackData.length} comparable values`,
       data: fallbackData
     };
@@ -7383,11 +7507,11 @@ ${schemaProfileText}` : ""}`;
     if (fields.length < 2) return null;
     const [xField, yField] = fields;
     const points = profile.records.map((record) => {
-      var _a2;
+      var _a3;
       const x = this.toFiniteNumber(record.fields[xField.key]);
       const y = this.toFiniteNumber(record.fields[yField.key]);
       if (x === null || y === null) return null;
-      return { x, y, label: String((_a2 = this.getRecordLabel(record)) != null ? _a2 : record.id) };
+      return { x, y, label: String((_a3 = this.getRecordLabel(record)) != null ? _a3 : record.id) };
     }).filter((point) => point !== null).slice(0, 100);
     if (points.length === 0) return null;
     return {
@@ -7417,9 +7541,9 @@ ${schemaProfileText}` : ""}`;
   static transformToRadarChart(data) {
     const attributeMap = {};
     data.forEach((item) => {
-      var _a2, _b, _c;
+      var _a3, _b, _c;
       const meta = item.metadata || {};
-      const seriesName = String((_c = (_b = (_a2 = meta.name) != null ? _a2 : meta.product) != null ? _b : item.id) != null ? _c : "Item");
+      const seriesName = String((_c = (_b = (_a3 = meta.name) != null ? _a3 : meta.product) != null ? _b : item.id) != null ? _c : "Item");
       Object.entries(meta).forEach(([key, val]) => {
         if (typeof val === "number" && !["price", "id"].includes(key.toLowerCase())) {
           if (!attributeMap[key]) attributeMap[key] = {};
@@ -7435,8 +7559,8 @@ ${schemaProfileText}` : ""}`;
       title: "Product Comparison",
       description: `Comparing ${data.length} items across ${radarData.length} attributes`,
       data: radarData.length > 0 ? radarData : data.map((d) => {
-        var _a2;
-        return { attribute: ((_a2 = d == null ? void 0 : d.content) != null ? _a2 : "").substring(0, 40) };
+        var _a3;
+        return { attribute: ((_a3 = d == null ? void 0 : d.content) != null ? _a3 : "").substring(0, 40) };
       })
     };
   }
@@ -7455,8 +7579,8 @@ ${schemaProfileText}` : ""}`;
     return this.createTextResponse(
       "Retrieved Context",
       data.map((item) => {
-        var _a2;
-        return (_a2 = item == null ? void 0 : item.content) != null ? _a2 : "";
+        var _a3;
+        return (_a3 = item == null ? void 0 : item.content) != null ? _a3 : "";
       }).join("\n\n"),
       `Found ${data.length} relevant results`
     );
@@ -7507,11 +7631,11 @@ ${schemaProfileText}` : ""}`;
     return null;
   }
   static normalizeTransformation(payload) {
-    var _a2, _b, _c, _d, _e, _f, _g2, _h, _i, _j;
+    var _a3, _b, _c, _d, _e, _f, _g2, _h, _i, _j;
     if (!payload || typeof payload !== "object") return null;
     const p = payload;
     const type = this.normalizeVisualizationType(
-      String((_c = (_b = (_a2 = p.type) != null ? _a2 : p.view) != null ? _b : p.chartType) != null ? _c : "")
+      String((_c = (_b = (_a3 = p.type) != null ? _a3 : p.view) != null ? _b : p.chartType) != null ? _c : "")
     );
     if (!type) return null;
     const title = String((_e = (_d = p.title) != null ? _d : p.heading) != null ? _e : "Visualization");
@@ -7522,7 +7646,7 @@ ${schemaProfileText}` : ""}`;
     return this.validateTransformation(transformation) ? transformation : null;
   }
   static normalizeVisualizationType(type) {
-    var _a2;
+    var _a3;
     const mapping = {
       pie: "pie_chart",
       pie_chart: "pie_chart",
@@ -7550,7 +7674,7 @@ ${schemaProfileText}` : ""}`;
       product_carousel: "product_carousel",
       carousel: "carousel"
     };
-    return (_a2 = mapping[type.toLowerCase()]) != null ? _a2 : null;
+    return (_a3 = mapping[type.toLowerCase()]) != null ? _a3 : null;
   }
   static validateTransformation(t) {
     const { type, data } = t;
@@ -7666,7 +7790,7 @@ ${schemaProfileText}` : ""}`;
   }
   static profileData(data) {
     const records = (data || []).filter((item) => Boolean(item && typeof item === "object")).map((item) => {
-      var _a2, _b;
+      var _a3, _b;
       const fields2 = {};
       Object.entries(item.metadata || {}).forEach(([key, value]) => {
         const primitive = this.toPrimitive(value);
@@ -7675,7 +7799,7 @@ ${schemaProfileText}` : ""}`;
       if (!fields2.content && item.content) fields2.content = item.content.substring(0, 500);
       return {
         id: item.id,
-        content: (_a2 = item.content) != null ? _a2 : "",
+        content: (_a3 = item.content) != null ? _a3 : "",
         score: (_b = item.score) != null ? _b : 0,
         fields: fields2,
         source: item
@@ -7756,16 +7880,16 @@ ${schemaProfileText}` : ""}`;
     return null;
   }
   static selectDimensionField(profile, query) {
-    var _a2, _b;
+    var _a3, _b;
     const productCategory = profile.categoricalFields.find(
       (field) => /category|department|collection|type|group|segment|region|country|state|city/i.test(field.key)
     );
     const ranked = this.rankFieldsByQuery(profile.categoricalFields, query);
-    return (_b = (_a2 = ranked[0]) != null ? _a2 : productCategory) != null ? _b : profile.categoricalFields[0];
+    return (_b = (_a3 = ranked[0]) != null ? _a3 : productCategory) != null ? _b : profile.categoricalFields[0];
   }
   static selectNumericField(profile, query) {
-    var _a2;
-    return (_a2 = this.rankFieldsByQuery(profile.numericFields, query)[0]) != null ? _a2 : profile.numericFields[0];
+    var _a3;
+    return (_a3 = this.rankFieldsByQuery(profile.numericFields, query)[0]) != null ? _a3 : profile.numericFields[0];
   }
   static rankFieldsByQuery(fields, query) {
     const q = query.toLowerCase();
@@ -7794,8 +7918,8 @@ ${schemaProfileText}` : ""}`;
   static aggregateProfileByDimension(profile, dimensionKey, measureKey) {
     const result = {};
     profile.records.forEach((record) => {
-      var _a2, _b, _c;
-      const category = String((_a2 = record.fields[dimensionKey]) != null ? _a2 : "Other").trim() || "Other";
+      var _a3, _b, _c;
+      const category = String((_a3 = record.fields[dimensionKey]) != null ? _a3 : "Other").trim() || "Other";
       const value = measureKey ? (_b = this.toFiniteNumber(record.fields[measureKey])) != null ? _b : 0 : 1;
       result[category] = ((_c = result[category]) != null ? _c : 0) + value;
     });
@@ -7875,8 +7999,8 @@ ${schemaProfileText}` : ""}`;
   static aggregateByCategory(data, categories) {
     const result = Object.fromEntries(categories.map((c) => [c, 0]));
     data.forEach((item) => {
-      var _a2;
-      const cat = (_a2 = this.getProductCategory(item)) != null ? _a2 : "Other";
+      var _a3;
+      const cat = (_a3 = this.getProductCategory(item)) != null ? _a3 : "Other";
       if (Object.prototype.hasOwnProperty.call(result, cat)) result[cat]++;
       else result["Other"] = (result["Other"] || 0) + 1;
     });
@@ -7884,17 +8008,17 @@ ${schemaProfileText}` : ""}`;
   }
   static extractTimeSeriesData(data) {
     return data.map((item) => {
-      var _a2, _b, _c, _d, _e, _f;
+      var _a3, _b, _c, _d, _e, _f;
       const meta = item.metadata || {};
       return {
-        timestamp: (_b = (_a2 = meta.timestamp) != null ? _a2 : meta.date) != null ? _b : (/* @__PURE__ */ new Date()).toISOString(),
+        timestamp: (_b = (_a3 = meta.timestamp) != null ? _a3 : meta.date) != null ? _b : (/* @__PURE__ */ new Date()).toISOString(),
         value: (_d = (_c = meta.value) != null ? _c : item.score) != null ? _d : 0,
         label: (_f = meta.label) != null ? _f : ((_e = item == null ? void 0 : item.content) != null ? _e : "").substring(0, 50)
       };
     });
   }
   static extractNumericValue(meta) {
-    var _a2;
+    var _a3;
     const preferredKeys = [
       "value",
       "count",
@@ -7909,7 +8033,7 @@ ${schemaProfileText}` : ""}`;
       "price"
     ];
     for (const key of preferredKeys) {
-      const raw = (_a2 = resolveMetadataValue(meta, key)) != null ? _a2 : meta[key];
+      const raw = (_a3 = resolveMetadataValue(meta, key)) != null ? _a3 : meta[key];
       const value = typeof raw === "number" ? raw : Number(String(raw != null ? raw : "").replace(/[$,% ,]/g, ""));
       if (Number.isFinite(value)) return value;
     }
@@ -8004,8 +8128,8 @@ ${schemaProfileText}` : ""}`;
     }, query.includes(normalizedField) ? 3 : 0);
   }
   static resolveTableCellValue(item, column) {
-    var _a2, _b, _c;
-    if (column === "Content") return ((_a2 = item == null ? void 0 : item.content) != null ? _a2 : "").substring(0, 100);
+    var _a3, _b, _c;
+    if (column === "Content") return ((_a3 = item == null ? void 0 : item.content) != null ? _a3 : "").substring(0, 100);
     const meta = item.metadata || {};
     const normalizedColumn = this.normalizeComparableField(column);
     const exactMetadata = Object.entries(meta).find(
@@ -8057,8 +8181,8 @@ ${schemaProfileText}` : ""}`;
     let inStock = 0;
     let outOfStock = 0;
     data.forEach((d) => {
-      var _a2, _b;
-      const cat = (_a2 = this.getProductCategory(d)) != null ? _a2 : "Other";
+      var _a3, _b;
+      const cat = (_a3 = this.getProductCategory(d)) != null ? _a3 : "Other";
       if (cat === category) {
         const quantity = (_b = this.extractStockQuantity(d)) != null ? _b : 1;
         if (this.determineStockStatus(d)) inStock += quantity;
@@ -8104,9 +8228,9 @@ ${schemaProfileText}` : ""}`;
   }
   // ─── Product Extraction ───────────────────────────────────────────────────
   static getDynamicVal(meta, uiKey, config, trainedSchema) {
-    var _a2;
+    var _a3;
     if (!meta) return void 0;
-    const mapping = (_a2 = config == null ? void 0 : config.rag) == null ? void 0 : _a2.uiMapping;
+    const mapping = (_a3 = config == null ? void 0 : config.rag) == null ? void 0 : _a3.uiMapping;
     if ((mapping == null ? void 0 : mapping[uiKey]) && meta[mapping[uiKey]] !== void 0) return meta[mapping[uiKey]];
     if (trainedSchema && typeof trainedSchema === "object") {
       const trainedKey = trainedSchema[uiKey];
@@ -8115,7 +8239,7 @@ ${schemaProfileText}` : ""}`;
     return resolveMetadataValue(meta, uiKey);
   }
   static extractProductInfo(item, config, trainedSchema) {
-    var _a2, _b;
+    var _a3, _b;
     if (!item) return null;
     const meta = item.metadata || {};
     const content = item.content || "";
@@ -8123,7 +8247,7 @@ ${schemaProfileText}` : ""}`;
     const price = this.getDynamicVal(meta, "price", config, trainedSchema);
     const brand = this.getDynamicVal(meta, "brand", config, trainedSchema);
     const description = this.cleanProductDescription(
-      (_a2 = this.extractProductDescriptionFromContent(content)) != null ? _a2 : this.getProductDescriptionValue(meta, config, trainedSchema)
+      (_a3 = this.extractProductDescriptionFromContent(content)) != null ? _a3 : this.getProductDescriptionValue(meta, config, trainedSchema)
     );
     if (name || this.isProductData(item)) {
       let finalName = name ? String(name) : void 0;
@@ -8258,10 +8382,10 @@ RULES:
   }
   static buildContextSummary(sources, maxChars = 6e3) {
     const items = (sources || []).filter(Boolean).map((s, i) => {
-      var _a2, _b, _c, _d;
+      var _a3, _b, _c, _d;
       return {
         index: i + 1,
-        content: (_b = (_a2 = s == null ? void 0 : s.content) == null ? void 0 : _a2.substring(0, 400)) != null ? _b : "",
+        content: (_b = (_a3 = s == null ? void 0 : s.content) == null ? void 0 : _a3.substring(0, 400)) != null ? _b : "",
         metadata: (_c = s == null ? void 0 : s.metadata) != null ? _c : {},
         score: (_d = s == null ? void 0 : s.score) != null ? _d : 0
       };
@@ -8301,7 +8425,7 @@ var SchemaMapper = class {
     return promise;
   }
   static async _doTrain(llm, cacheKey, keys) {
-    var _a2, _b, _c, _d, _e, _f, _g2, _h, _i, _j, _k;
+    var _a3, _b, _c, _d, _e, _f, _g2, _h, _i, _j, _k;
     console.log(`[SchemaMapper] \u{1F9E0} Training on new schema keys: ${keys.join(", ")}`);
     const propertyList = Object.entries(this.TARGET_PROPERTIES).map(([prop, desc]) => `- ${prop} (${desc})`).join("\n");
     const messages = [
@@ -8317,7 +8441,7 @@ Return a JSON object like {"name":"Title","price":"Price",...}. Omit unmapped pr
       }
     ];
     try {
-      const baseUrl = (_a2 = llm == null ? void 0 : llm.baseUrl) != null ? _a2 : "";
+      const baseUrl = (_a3 = llm == null ? void 0 : llm.baseUrl) != null ? _a3 : "";
       const apiKey = (_b = llm == null ? void 0 : llm.apiKey) != null ? _b : "";
       const model = (_c = llm == null ? void 0 : llm.model) != null ? _c : "llama-3.1-8b-instant";
       let responseText;
@@ -8492,9 +8616,9 @@ var Pipeline = class {
     this.initialised = false;
     /** Namespace-specific static cold context cache for CAG */
     this.coldContexts = /* @__PURE__ */ new Map();
-    var _a2, _b, _c, _d, _e;
+    var _a3, _b, _c, _d, _e;
     this.chunker = new DocumentChunker(
-      (_b = (_a2 = config.rag) == null ? void 0 : _a2.chunkSize) != null ? _b : 1e3,
+      (_b = (_a3 = config.rag) == null ? void 0 : _a3.chunkSize) != null ? _b : 1e3,
       (_d = (_c = config.rag) == null ? void 0 : _c.chunkOverlap) != null ? _d : 200
     );
     if (((_e = config.rag) == null ? void 0 : _e.chunkingStrategy) === "llamaindex") {
@@ -8510,7 +8634,7 @@ var Pipeline = class {
     return this.initialised ? this.llmProvider : void 0;
   }
   async initialize() {
-    var _a2, _b, _c, _d;
+    var _a3, _b, _c, _d;
     if (this.initialised) return;
     const chartInstruction = `You are a helpful assistant. Use the provided context to answer questions accurately.
 
@@ -8553,7 +8677,7 @@ var Pipeline = class {
       this.entityExtractor = new EntityExtractor(this.llmProvider);
     }
     await this.vectorDB.initialize();
-    if (((_a2 = this.config.rag) == null ? void 0 : _a2.architecture) === "agentic" || ((_b = this.config.rag) == null ? void 0 : _b.architecture) === "multi-agent" || this.config.mcpServers && this.config.mcpServers.length > 0) {
+    if (((_a3 = this.config.rag) == null ? void 0 : _a3.architecture) === "agentic" || ((_b = this.config.rag) == null ? void 0 : _b.architecture) === "multi-agent" || this.config.mcpServers && this.config.mcpServers.length > 0) {
       this.mcpRegistry = new MCPRegistry(this.config.mcpServers || []);
       this.multiAgentCoordinator = new MultiAgentCoordinator({
         llmProvider: this.llmProvider,
@@ -8571,8 +8695,8 @@ var Pipeline = class {
     this.initialised = true;
   }
   async loadColdContext(ns) {
-    var _a2, _b;
-    const cagConfig = (_a2 = this.config.rag) == null ? void 0 : _a2.cag;
+    var _a3, _b;
+    const cagConfig = (_a3 = this.config.rag) == null ? void 0 : _a3.cag;
     if (!cagConfig || !cagConfig.enabled) return;
     try {
       const coldNs = cagConfig.coldNamespace || ns;
@@ -8625,12 +8749,12 @@ ${m.content}`).join("\n\n---\n\n");
   }
   /** Step 1: Chunk the document content. */
   async prepareChunks(doc) {
-    var _a2, _b;
+    var _a3, _b;
     if (this.llamaIngestor) {
       return this.llamaIngestor.chunk(doc.content, {
         docId: doc.docId,
         metadata: doc.metadata,
-        chunkSize: (_a2 = this.config.rag) == null ? void 0 : _a2.chunkSize,
+        chunkSize: (_a3 = this.config.rag) == null ? void 0 : _a3.chunkSize,
         chunkOverlap: (_b = this.config.rag) == null ? void 0 : _b.chunkOverlap
       });
     }
@@ -8728,9 +8852,9 @@ ${m.content}`).join("\n\n---\n\n");
     return { reply, sources };
   }
   async ask(question, history = [], namespace) {
-    var _a2, _b;
+    var _a3, _b;
     await this.initialize();
-    if ((((_a2 = this.config.rag) == null ? void 0 : _a2.architecture) === "agentic" || ((_b = this.config.rag) == null ? void 0 : _b.architecture) === "multi-agent" || this.config.mcpServers && this.config.mcpServers.length > 0) && this.multiAgentCoordinator) {
+    if ((((_a3 = this.config.rag) == null ? void 0 : _a3.architecture) === "agentic" || ((_b = this.config.rag) == null ? void 0 : _b.architecture) === "multi-agent" || this.config.mcpServers && this.config.mcpServers.length > 0) && this.multiAgentCoordinator) {
       return await this.multiAgentCoordinator.run(question, history);
     }
     const stream = this.askStream(question, history, namespace);
@@ -8765,9 +8889,9 @@ ${m.content}`).join("\n\n---\n\n");
   }
   askStream(_0) {
     return __asyncGenerator(this, arguments, function* (question, history = [], namespace) {
-      var _a2, _b;
+      var _a3, _b;
       yield new __await(this.initialize());
-      if ((((_a2 = this.config.rag) == null ? void 0 : _a2.architecture) === "agentic" || ((_b = this.config.rag) == null ? void 0 : _b.architecture) === "multi-agent" || this.config.mcpServers && this.config.mcpServers.length > 0) && this.multiAgentCoordinator) {
+      if ((((_a3 = this.config.rag) == null ? void 0 : _a3.architecture) === "agentic" || ((_b = this.config.rag) == null ? void 0 : _b.architecture) === "multi-agent" || this.config.mcpServers && this.config.mcpServers.length > 0) && this.multiAgentCoordinator) {
         const stream2 = this.multiAgentCoordinator.runStream(question, history);
         try {
           for (var iter = __forAwait(stream2), more, temp, error; more = !(temp = yield new __await(iter.next())).done; more = false) {
@@ -8816,10 +8940,10 @@ ${m.content}`).join("\n\n---\n\n");
    */
   askStreamInternal(_0) {
     return __asyncGenerator(this, arguments, function* (question, history = [], namespace) {
-      var _a2, _b, _c, _d, _e, _f, _g2, _h, _i, _j, _k, _l, _m, _n, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x, _y, _z, _A, _B;
+      var _a3, _b, _c, _d, _e, _f, _g2, _h, _i, _j, _k, _l, _m, _n, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x, _y, _z, _A, _B;
       yield new __await(this.initialize());
       const ns = formatNamespace(namespace != null ? namespace : this.config.projectId);
-      const topK = (_b = (_a2 = this.config.rag) == null ? void 0 : _a2.topK) != null ? _b : 5;
+      const topK = (_b = (_a3 = this.config.rag) == null ? void 0 : _a3.topK) != null ? _b : 5;
       const scoreThreshold = (_d = (_c = this.config.rag) == null ? void 0 : _c.scoreThreshold) != null ? _d : 0.3;
       const requestId = `req_${Date.now()}_${Math.random().toString(36).slice(2, 8)}`;
       const requestStart = performance.now();
@@ -8868,8 +8992,8 @@ ${m.content}`).join("\n\n---\n\n");
         const rerankStart = performance.now();
         const structuredSources = this.applyStructuredFilters(rawSources, filter).filter((s) => Boolean(s && typeof s === "object"));
         let fullSources = hasNumericPredicates ? structuredSources : structuredSources.filter((m) => {
-          var _a3;
-          return ((_a3 = m == null ? void 0 : m.score) != null ? _a3 : 0) >= scoreThreshold;
+          var _a4;
+          return ((_a4 = m == null ? void 0 : m.score) != null ? _a4 : 0) >= scoreThreshold;
         });
         const rerankLimit = Math.max(retrievalLimit, fullSources.length);
         const useReranking = arch !== "naive" && (arch === "retrieve-and-rerank" || ((_m = this.config.rag) == null ? void 0 : _m.useReranking));
@@ -8882,13 +9006,13 @@ ${m.content}`).join("\n\n---\n\n");
         let context = promptSources.length ? `[SEARCH SUMMARY: Found ${totalCount} matching record(s) out of ${rawSources.length} total resources searched in database. Context includes top ${promptSources.length} relevant records]
 
 ` + promptSources.map((m, i) => {
-          var _a3;
+          var _a4;
           return `[Source ${i + 1}]
-${(_a3 = m == null ? void 0 : m.content) != null ? _a3 : ""}`;
+${(_a4 = m == null ? void 0 : m.content) != null ? _a4 : ""}`;
         }).join("\n\n---\n\n") : "No relevant context found.";
         const sources = [...fullSources].filter((s) => Boolean(s && typeof s === "object")).sort((a, b) => {
-          var _a3, _b2;
-          return ((_a3 = b == null ? void 0 : b.score) != null ? _a3 : 0) - ((_b2 = a == null ? void 0 : a.score) != null ? _b2 : 0);
+          var _a4, _b2;
+          return ((_a4 = b == null ? void 0 : b.score) != null ? _a4 : 0) - ((_b2 = a == null ? void 0 : a.score) != null ? _b2 : 0);
         });
         if (graphData && graphData.nodes.length > 0) {
           const graphContext = graphData.nodes.map(
@@ -8916,10 +9040,10 @@ ${context}`;
         yield {
           reply: "",
           sources: (sources || []).filter((s) => Boolean(s && typeof s === "object")).map((s) => {
-            var _a3, _b2, _c2;
+            var _a4, _b2, _c2;
             return {
               id: s.id,
-              score: (_a3 = s.score) != null ? _a3 : 0,
+              score: (_a4 = s.score) != null ? _a4 : 0,
               content: (_b2 = s == null ? void 0 : s.content) != null ? _b2 : "",
               metadata: (_c2 = s == null ? void 0 : s.metadata) != null ? _c2 : {},
               namespace: ns
@@ -9112,11 +9236,11 @@ ${context}`;
           systemPrompt,
           userPrompt: question + finalRestrictionSuffix,
           chunks: (sources || []).filter(Boolean).map((s) => {
-            var _a3, _b2;
+            var _a4, _b2;
             return {
               id: s.id,
               score: s.score,
-              content: (_a3 = s == null ? void 0 : s.content) != null ? _a3 : "",
+              content: (_a4 = s == null ? void 0 : s.content) != null ? _a4 : "",
               metadata: (_b2 = s == null ? void 0 : s.metadata) != null ? _b2 : {},
               namespace: ns
             };
@@ -9135,7 +9259,7 @@ ${context}`;
           const telemetryUrl = ((_B = this.config.telemetry) == null ? void 0 : _B.url) || process.env.TELEMETRY_URL || process.env.NEXT_PUBLIC_TELEMETRY_URL || defaultUrl;
           const absoluteUrl = telemetryUrl.startsWith("http") ? telemetryUrl : "https://www.retrivora.com" + (telemetryUrl.startsWith("/") ? telemetryUrl : "/" + telemetryUrl);
           (async () => {
-            var _a3, _b2, _c2, _d2, _e2;
+            var _a4, _b2, _c2, _d2, _e2;
             try {
               let finalTrace = trace;
               if (!awaitHallucination && runHallucination) {
@@ -9144,7 +9268,7 @@ ${context}`;
                   finalTrace = buildTrace(backgroundScoreResult);
                 }
               }
-              const modelName = (finalTrace == null ? void 0 : finalTrace.model) || ((_a3 = this.config.llm) == null ? void 0 : _a3.model) || "llama-3.1-8b-instant";
+              const modelName = (finalTrace == null ? void 0 : finalTrace.model) || ((_a4 = this.config.llm) == null ? void 0 : _a4.model) || "llama-3.1-8b-instant";
               const providerName = (finalTrace == null ? void 0 : finalTrace.provider) || ((_b2 = this.config.llm) == null ? void 0 : _b2.provider) || "groq";
               const tokenCount = Number(((_c2 = finalTrace == null ? void 0 : finalTrace.tokens) == null ? void 0 : _c2.totalTokens) || 0);
               const costEst = Number(((_d2 = finalTrace == null ? void 0 : finalTrace.tokens) == null ? void 0 : _d2.estimatedCostUsd) || 0);
@@ -9198,7 +9322,7 @@ ${context}`;
    * Uses an LRU-bounded embedding cache to avoid re-embedding the same query.
    */
   async generateUiTransformation(question, sources, cachedSchema, forceDeterministic = false) {
-    var _a2;
+    var _a3;
     if (!sources || sources.length === 0) {
       return UITransformer.transform(question, sources, this.config, cachedSchema);
     }
@@ -9211,7 +9335,7 @@ ${context}`;
         { visualizationHint: "product_browse", recommendedChart: "text", filterInStockOnly: false, wantsExplicitTable: false, isTemporal: false, isComparison: false, language: "en" }
       );
     }
-    const enableLlmUiTransform = ((_a2 = this.config.llm.options) == null ? void 0 : _a2.enableLlmUiTransform) === true;
+    const enableLlmUiTransform = ((_a3 = this.config.llm.options) == null ? void 0 : _a3.enableLlmUiTransform) === true;
     if (forceDeterministic || !enableLlmUiTransform) {
       return UITransformer.transform(question, sources, this.config, cachedSchema);
     }
@@ -9229,15 +9353,15 @@ ${context}`;
       const value = this.resolveNumericPredicateValue(source, predicate);
       return value !== null && this.matchesNumericPredicate(value, predicate);
     })).sort((a, b) => {
-      var _a2, _b;
+      var _a3, _b;
       const primary = predicates[0];
-      const aValue = (_a2 = this.resolveNumericPredicateValue(a, primary)) != null ? _a2 : 0;
+      const aValue = (_a3 = this.resolveNumericPredicateValue(a, primary)) != null ? _a3 : 0;
       const bValue = (_b = this.resolveNumericPredicateValue(b, primary)) != null ? _b : 0;
       return primary.operator === "lt" || primary.operator === "lte" ? aValue - bValue : bValue - aValue;
     });
   }
   resolveNumericPredicateValue(source, predicate) {
-    var _a2;
+    var _a3;
     if (!source) return null;
     const meta = source.metadata || {};
     const field = predicate.field;
@@ -9250,7 +9374,7 @@ ${context}`;
         const value = this.toFiniteNumber(Array.isArray(fuzzy) ? fuzzy[1] : fuzzy.value);
         if (value !== null) return value;
       }
-      const contentValue = this.extractNumericValueFromContent((_a2 = source.content) != null ? _a2 : "", field);
+      const contentValue = this.extractNumericValueFromContent((_a3 = source.content) != null ? _a3 : "", field);
       if (contentValue !== null) return contentValue;
     }
     for (const [key, value] of entries) {
@@ -9306,8 +9430,8 @@ ${context}`;
     return Number.isFinite(numeric) ? numeric : null;
   }
   async retrieve(query, options) {
-    var _a2, _b, _c, _d, _e, _f, _g2;
-    const ns = formatNamespace((_a2 = options.namespace) != null ? _a2 : this.config.projectId);
+    var _a3, _b, _c, _d, _e, _f, _g2;
+    const ns = formatNamespace((_a3 = options.namespace) != null ? _a3 : this.config.projectId);
     const topK = (_b = options.topK) != null ? _b : 5;
     const cacheKey = `${ns}::${query}`;
     let queryVector = this.embeddingCache.get(cacheKey);
@@ -9352,11 +9476,11 @@ ${context}`;
       namespace: ns,
       count: resolvedSources.length,
       sample: resolvedSources.slice(0, 2).map((s) => {
-        var _a3;
+        var _a4;
         return {
           id: s == null ? void 0 : s.id,
           score: s == null ? void 0 : s.score,
-          contentSnippet: String((_a3 = s == null ? void 0 : s.content) != null ? _a3 : "").substring(0, 150),
+          contentSnippet: String((_a4 = s == null ? void 0 : s.content) != null ? _a4 : "").substring(0, 150),
           metadata: s == null ? void 0 : s.metadata
         };
       })
@@ -9370,8 +9494,8 @@ Focus on extracting the core intent and entities. Do not answer the question, ju
 
 History:
 ${(history || []).map((m) => {
-      var _a2;
-      return `${(m == null ? void 0 : m.role) || "user"}: ${(_a2 = m == null ? void 0 : m.content) != null ? _a2 : ""}`;
+      var _a3;
+      return `${(m == null ? void 0 : m.role) || "user"}: ${(_a3 = m == null ? void 0 : m.content) != null ? _a3 : ""}`;
     }).join("\n")}
 
 New Question: ${question}
@@ -9398,8 +9522,8 @@ Optimized Search Query:`;
       const { sources } = await this.retrieve(query, { namespace: ns, topK: 5 });
       if (!sources || sources.length === 0) return [];
       const context = sources.map((s) => {
-        var _a2;
-        return (_a2 = s == null ? void 0 : s.content) != null ? _a2 : "";
+        var _a3;
+        return (_a3 = s == null ? void 0 : s.content) != null ? _a3 : "";
       }).join("\n\n---\n\n");
       const prompt = `Based on the following snippets from a document, what are at least 5 short, relevant questions a user might ask? 
 Focus on questions that can be answered by the context.
@@ -9441,13 +9565,13 @@ var Retrivora = class {
     this.pipeline = new Pipeline(this.config);
   }
   async initialize() {
-    var _a2;
+    var _a3;
     try {
       await ConfigValidator.validateAndThrow(this.config);
       LicenseVerifier.verify(
         this.config.licenseKey,
         this.config.projectId,
-        (_a2 = this.config.vectorDb) == null ? void 0 : _a2.provider
+        (_a3 = this.config.vectorDb) == null ? void 0 : _a3.provider
       );
       await LicenseVerifier.verifyIP(this.config.licenseKey);
     } catch (err) {
@@ -9620,18 +9744,200 @@ var ProviderHealthCheck = class {
   }
 };
 
+// src/core/FreeTierLimitsGuard.ts
+var FREE_TIER_QUOTAS = {
+  MAX_DOCUMENTS: 25,
+  MAX_FILE_SIZE_BYTES: 20 * 1024 * 1024,
+  MAX_STORAGE_BYTES: 250 * 1024 * 1024,
+  MAX_TRIAL_REQUEST_UNITS: 500,
+  MAX_DAILY_REQUEST_UNITS: 50,
+  TRIAL_DURATION_DAYS: 14,
+  GRACE_PERIOD_DAYS: 2,
+  MAX_RPM: 10,
+  MAX_RPH: 100,
+  MAX_RPD: 500,
+  MAX_CONCURRENT_REQUESTS: 2,
+  MAX_INPUT_TOKENS: 2e4,
+  MAX_OUTPUT_TOKENS: 4e3,
+  UPGRADE_REMINDER_DAYS: [7, 12, 14],
+  MAX_USERS: 1,
+  MAX_NAMESPACES: 1,
+  MAX_PROJECTS: 1
+};
+var FreeTierLimitsGuard = class {
+  static calculateTrialTimestamps(startedAt) {
+    const startDate = startedAt ? new Date(startedAt) : /* @__PURE__ */ new Date();
+    const trialStartedAtMs = startDate.getTime();
+    const trialExpiresAtMs = trialStartedAtMs + FREE_TIER_QUOTAS.TRIAL_DURATION_DAYS * 24 * 60 * 60 * 1e3;
+    const gracePeriodExpiresAtMs = trialStartedAtMs + (FREE_TIER_QUOTAS.TRIAL_DURATION_DAYS + FREE_TIER_QUOTAS.GRACE_PERIOD_DAYS) * 24 * 60 * 60 * 1e3;
+    return {
+      trial_started_at: new Date(trialStartedAtMs).toISOString(),
+      trial_expires_at: new Date(trialExpiresAtMs).toISOString(),
+      grace_period_expires_at: new Date(gracePeriodExpiresAtMs).toISOString()
+    };
+  }
+  static calculateRequestUnits(operationType, options) {
+    var _a3;
+    const op = operationType.toLowerCase().trim();
+    if (op.includes("suggestion") || op.includes("template") || op.includes("history") || op.includes("model") || op.includes("health") || op.includes("auth") || op.includes("license") || op.includes("usage") || op.includes("feedback") || op.includes("analytic")) {
+      return 0;
+    }
+    if (op.includes("image")) {
+      return 10;
+    }
+    if (op.includes("embedding")) {
+      const chunks = (_a3 = options == null ? void 0 : options.chunkCount) != null ? _a3 : 1;
+      return Math.max(1, Math.ceil(chunks / 1e3));
+    }
+    return 1;
+  }
+  static checkTrialStatus(startedAt, totalUnitsUsed = 0, nowServerTime = /* @__PURE__ */ new Date()) {
+    const timestamps = this.calculateTrialTimestamps(startedAt);
+    const startMs = new Date(timestamps.trial_started_at).getTime();
+    const expireMs = new Date(timestamps.trial_expires_at).getTime();
+    const graceExpireMs = new Date(timestamps.grace_period_expires_at).getTime();
+    const nowMs = nowServerTime.getTime();
+    const daysElapsed = Math.floor(Math.max(0, nowMs - startMs) / (1e3 * 60 * 60 * 24));
+    const daysRemaining = Math.max(0, Math.ceil((expireMs - nowMs) / (1e3 * 60 * 60 * 24)));
+    const isConsumedUnits = totalUnitsUsed >= FREE_TIER_QUOTAS.MAX_TRIAL_REQUEST_UNITS;
+    const isExpiredTime = nowMs > expireMs;
+    const isPastGraceTime = nowMs > graceExpireMs;
+    let status = "active";
+    let reason;
+    if (isPastGraceTime || isConsumedUnits && isExpiredTime) {
+      status = "expired";
+      reason = "Trial period and grace period have expired. Upgrade your plan.";
+    } else if (isExpiredTime || isConsumedUnits) {
+      status = "grace_period";
+      reason = isConsumedUnits ? "Total trial request quota (500 units) consumed. Grace period active (dashboard access only)." : "14-day trial period expired. 2-day grace period active (dashboard access only).";
+    }
+    let upgradeReminderDue;
+    if (FREE_TIER_QUOTAS.UPGRADE_REMINDER_DAYS.includes(daysElapsed)) {
+      upgradeReminderDue = daysElapsed;
+    }
+    let usageReminderDue;
+    const usagePercent = totalUnitsUsed / FREE_TIER_QUOTAS.MAX_TRIAL_REQUEST_UNITS * 100;
+    if (usagePercent >= 100) {
+      usageReminderDue = "100%";
+    } else if (usagePercent >= 90) {
+      usageReminderDue = "90%";
+    } else if (usagePercent >= 80) {
+      usageReminderDue = "80%";
+    }
+    return {
+      status,
+      daysElapsed,
+      daysRemaining,
+      isGracePeriod: status === "grace_period",
+      isExpired: status === "expired",
+      upgradeReminderDue,
+      usageReminderDue,
+      reason
+    };
+  }
+  static checkIngestionAllowed(stats, incomingSizeBytes = 0) {
+    var _a3, _b;
+    const docs = (_a3 = stats.documentCount) != null ? _a3 : 0;
+    const storage = (_b = stats.totalStorageBytes) != null ? _b : 0;
+    if (incomingSizeBytes > FREE_TIER_QUOTAS.MAX_FILE_SIZE_BYTES) {
+      const mbSize = (incomingSizeBytes / (1024 * 1024)).toFixed(1);
+      return {
+        allowed: false,
+        reason: `[FreeTierIngestor] File size (${mbSize}MB) exceeds maximum allowed size of 20MB under Free Tier rules.`
+      };
+    }
+    if (docs >= FREE_TIER_QUOTAS.MAX_DOCUMENTS) {
+      return {
+        allowed: false,
+        reason: `Document limit reached (${docs}/${FREE_TIER_QUOTAS.MAX_DOCUMENTS}). Upgrade to Pro to ingest more documents.`
+      };
+    }
+    if (storage + incomingSizeBytes > FREE_TIER_QUOTAS.MAX_STORAGE_BYTES) {
+      const mbUsed = (storage / (1024 * 1024)).toFixed(1);
+      return {
+        allowed: false,
+        reason: `Storage quota exceeded (${mbUsed}MB / 250MB). Upgrade for unlimited storage.`
+      };
+    }
+    return { allowed: true };
+  }
+  static checkRequestAllowed(params) {
+    var _a3, _b, _c;
+    const op = (_a3 = params.operationType) != null ? _a3 : "chat";
+    const costUnits = this.calculateRequestUnits(op, { chunkCount: params.chunkCount });
+    if (costUnits === 0) {
+      return { allowed: true, costUnits: 0 };
+    }
+    if (params.inputTokens && params.inputTokens > FREE_TIER_QUOTAS.MAX_INPUT_TOKENS) {
+      return {
+        allowed: false,
+        reason: "Token limit exceeded. Upgrade your plan.",
+        costUnits
+      };
+    }
+    if (params.outputTokens && params.outputTokens > FREE_TIER_QUOTAS.MAX_OUTPUT_TOKENS) {
+      return {
+        allowed: false,
+        reason: "Token limit exceeded. Upgrade your plan.",
+        costUnits
+      };
+    }
+    if (params.concurrentRequests && params.concurrentRequests > FREE_TIER_QUOTAS.MAX_CONCURRENT_REQUESTS) {
+      return {
+        allowed: false,
+        reason: `Concurrent limit exceeded (max ${FREE_TIER_QUOTAS.MAX_CONCURRENT_REQUESTS} active requests). Please wait for active streams to finish.`,
+        costUnits
+      };
+    }
+    const totalUnits = (_b = params.totalUnitsUsed) != null ? _b : 0;
+    const trialStatus = this.checkTrialStatus(params.trialStartedAt, totalUnits, params.nowServerTime);
+    if (trialStatus.status === "expired" || trialStatus.status === "grace_period") {
+      return {
+        allowed: false,
+        reason: trialStatus.reason || "Trial limit reached. Upgrade your plan.",
+        costUnits
+      };
+    }
+    if (totalUnits + costUnits > FREE_TIER_QUOTAS.MAX_TRIAL_REQUEST_UNITS) {
+      return {
+        allowed: false,
+        reason: `Total trial request unit limit reached (${totalUnits}/${FREE_TIER_QUOTAS.MAX_TRIAL_REQUEST_UNITS}). Upgrade your plan.`,
+        costUnits
+      };
+    }
+    const dailyUnits = (_c = params.dailyUnitsUsed) != null ? _c : 0;
+    if (dailyUnits + costUnits > FREE_TIER_QUOTAS.MAX_DAILY_REQUEST_UNITS) {
+      return {
+        allowed: false,
+        reason: `Daily request quota limit reached (${dailyUnits}/${FREE_TIER_QUOTAS.MAX_DAILY_REQUEST_UNITS} units/day). Quota resets tomorrow.`,
+        costUnits
+      };
+    }
+    return { allowed: true, costUnits };
+  }
+  static checkQueryAllowed(dailyQueriesCount = 0) {
+    if (dailyQueriesCount >= FREE_TIER_QUOTAS.MAX_DAILY_REQUEST_UNITS) {
+      return {
+        allowed: false,
+        reason: `Daily query limit reached (${FREE_TIER_QUOTAS.MAX_DAILY_REQUEST_UNITS}/day). Quota resets tomorrow.`
+      };
+    }
+    return { allowed: true };
+  }
+};
+
 // src/core/VectorPlugin.ts
 var VectorPlugin = class {
   constructor(hostConfig) {
     const resolvedConfig = ConfigResolver.resolve(hostConfig);
     this.config = resolvedConfig;
     this.validationPromise = (async () => {
-      var _a2;
+      var _a3;
       await ConfigValidator.validateAndThrow(resolvedConfig);
       LicenseVerifier.verify(
         resolvedConfig.licenseKey,
         resolvedConfig.projectId,
-        (_a2 = resolvedConfig.vectorDb) == null ? void 0 : _a2.provider
+        (_a3 = resolvedConfig.vectorDb) == null ? void 0 : _a3.provider
       );
     })();
     this.validationPromise.catch(() => {
@@ -9665,16 +9971,32 @@ var VectorPlugin = class {
       this.config.embedding
     );
   }
+  estimateInputTokens(message, history = []) {
+    const allContent = message.length + history.reduce((acc, m) => {
+      var _a3, _b;
+      return acc + (((_a3 = m == null ? void 0 : m.content) == null ? void 0 : _a3.length) || ((_b = m == null ? void 0 : m.text) == null ? void 0 : _b.length) || 0);
+    }, 0);
+    return Math.ceil(allContent / 4);
+  }
   /**
    * Run a chat query.
    */
   async chat(message, history = [], namespace) {
+    var _a3;
     try {
       await this.validationPromise;
     } catch (err) {
       throw wrapError(err, "CONFIGURATION_ERROR");
     }
     try {
+      const inputTokens = this.estimateInputTokens(message, history);
+      const tokenCheck = FreeTierLimitsGuard.checkRequestAllowed({
+        operationType: "chat",
+        inputTokens
+      });
+      if (!tokenCheck.allowed && ((_a3 = tokenCheck.reason) == null ? void 0 : _a3.toLowerCase().includes("token"))) {
+        throw wrapError(new Error(tokenCheck.reason), "RATE_LIMITED");
+      }
       return await this.pipeline.ask(message, history, namespace);
     } catch (err) {
       const msg = String(err);
@@ -9682,6 +10004,9 @@ var VectorPlugin = class {
       if (msg.includes("Embed") || msg.includes("embed")) {
         defaultCode = "EMBEDDING_FAILED";
       }
+      if (msg.toLowerCase().includes("token limit")) {
+        defaultCode = "RATE_LIMITED";
+      }
       throw wrapError(err, defaultCode);
     }
   }
@@ -9690,12 +10015,21 @@ var VectorPlugin = class {
    */
   chatStream(_0) {
     return __asyncGenerator(this, arguments, function* (message, history = [], namespace) {
+      var _a3;
       try {
         yield new __await(this.validationPromise);
       } catch (err) {
         throw wrapError(err, "CONFIGURATION_ERROR");
       }
       try {
+        const inputTokens = this.estimateInputTokens(message, history);
+        const tokenCheck = FreeTierLimitsGuard.checkRequestAllowed({
+          operationType: "chat_stream",
+          inputTokens
+        });
+        if (!tokenCheck.allowed && ((_a3 = tokenCheck.reason) == null ? void 0 : _a3.toLowerCase().includes("token"))) {
+          throw wrapError(new Error(tokenCheck.reason), "RATE_LIMITED");
+        }
         const stream = this.pipeline.askStream(message, history, namespace);
         try {
           for (var iter = __forAwait(stream), more, temp, error; more = !(temp = yield new __await(iter.next())).done; more = false) {
@@ -9718,6 +10052,9 @@ var VectorPlugin = class {
         if (msg.includes("Embed") || msg.includes("embed")) {
           defaultCode = "EMBEDDING_FAILED";
         }
+        if (msg.toLowerCase().includes("token limit")) {
+          defaultCode = "RATE_LIMITED";
+        }
         throw wrapError(err, defaultCode);
       }
     });
@@ -9772,13 +10109,13 @@ var ConfigBuilder = class {
    * Configure the vector database provider
    */
   vectorDb(provider, options) {
-    var _a2;
+    var _a3;
     if (provider === "auto") {
       this._vectorDb = this._autoDetectVectorDb();
     } else {
       this._vectorDb = {
         provider,
-        indexName: (_a2 = options == null ? void 0 : options.indexName) != null ? _a2 : "default",
+        indexName: (_a3 = options == null ? void 0 : options.indexName) != null ? _a3 : "default",
         options: __spreadValues({}, options)
       };
     }
@@ -9788,7 +10125,7 @@ var ConfigBuilder = class {
    * Configure the LLM provider for chat
    */
   llm(provider, model, apiKey, options) {
-    var _a2, _b;
+    var _a3, _b;
     if (provider === "auto") {
       this._llm = this._autoDetectLLM();
     } else {
@@ -9797,7 +10134,7 @@ var ConfigBuilder = class {
         model: model != null ? model : "default-model",
         apiKey,
         systemPrompt: options == null ? void 0 : options.systemPrompt,
-        maxTokens: (_a2 = options == null ? void 0 : options.maxTokens) != null ? _a2 : 1024,
+        maxTokens: (_a3 = options == null ? void 0 : options.maxTokens) != null ? _a3 : 1024,
         temperature: (_b = options == null ? void 0 : options.temperature) != null ? _b : 0.7,
         baseUrl: options == null ? void 0 : options.baseUrl,
         options
@@ -9840,8 +10177,8 @@ var ConfigBuilder = class {
    * Set RAG-specific pipeline parameters
    */
   rag(options) {
-    var _a2;
-    this._rag = __spreadValues(__spreadValues({}, (_a2 = this._rag) != null ? _a2 : {}), options);
+    var _a3;
+    this._rag = __spreadValues(__spreadValues({}, (_a3 = this._rag) != null ? _a3 : {}), options);
     return this;
   }
   /**
@@ -9857,7 +10194,7 @@ var ConfigBuilder = class {
    * Throws if required fields (projectId, vectorDb, llm, embedding) are not set.
    */
   build() {
-    var _a2;
+    var _a3;
     const missing = [];
     if (!this._projectId) missing.push('projectId (call .projectId("my-app"))');
     if (!this._vectorDb) missing.push('vectorDb (call .vectorDb("pinecone", { ... }))');
@@ -9869,7 +10206,7 @@ var ConfigBuilder = class {
   ${missing.join("\n  ")}`
       );
     }
-    const ragConfig = (_a2 = this._rag) != null ? _a2 : { chunkSize: 1e3, chunkOverlap: 200, topK: 5 };
+    const ragConfig = (_a3 = this._rag) != null ? _a3 : { chunkSize: 1e3, chunkOverlap: 200, topK: 5 };
     if (process.env.RAG_USE_GRAPH_RETRIEVAL === "true") {
       ragConfig.useGraphRetrieval = true;
     }
@@ -9965,8 +10302,8 @@ var DocumentParser = class {
    * Extract text from a File or Buffer based on its type.
    */
   static async parse(file, fileName, mimeType) {
-    var _a2;
-    const extension = ((_a2 = fileName.split(".").pop()) == null ? void 0 : _a2.toLowerCase()) || "";
+    var _a3;
+    const extension = ((_a3 = fileName.split(".").pop()) == null ? void 0 : _a3.toLowerCase()) || "";
     if (extension === "txt" || extension === "md" || mimeType === "text/plain" || mimeType === "text/markdown") {
       return this.readAsText(file);
     }
@@ -10073,9 +10410,9 @@ var DatabaseStorage = class {
     this.fallbackDir = this.isServerless ? path.join(os.tmpdir(), ".retrivora") : path.join(process.cwd(), ".retrivora");
     this.historyFile = path.join(this.fallbackDir, "history.json");
     this.feedbackFile = path.join(this.fallbackDir, "feedback.json");
-    var _a2, _b, _c, _d, _e;
+    var _a3, _b, _c, _d, _e;
     this.config = config;
-    this.provider = ((_a2 = config.vectorDb) == null ? void 0 : _a2.provider) || "fs";
+    this.provider = ((_a3 = config.vectorDb) == null ? void 0 : _a3.provider) || "fs";
     const rawHistoryTable = ((_c = (_b = config.rag) == null ? void 0 : _b.history) == null ? void 0 : _c.tableName) || "retrivora_history";
     const rawFeedbackTable = ((_e = (_d = config.rag) == null ? void 0 : _d.feedback) == null ? void 0 : _e.tableName) || "retrivora_feedback";
     this.historyTableName = rawHistoryTable.replace(/[^a-zA-Z0-9_]/g, "_");
@@ -10110,16 +10447,16 @@ var DatabaseStorage = class {
     }
   }
   checkHistoryEnabled() {
-    var _a2, _b;
+    var _a3, _b;
     this.checkPremiumSubscription();
-    if (((_b = (_a2 = this.config.rag) == null ? void 0 : _a2.history) == null ? void 0 : _b.enabled) === false) {
+    if (((_b = (_a3 = this.config.rag) == null ? void 0 : _a3.history) == null ? void 0 : _b.enabled) === false) {
       throw new Error("[Retrivora SDK] Chat History is disabled in RagConfig.");
     }
   }
   checkFeedbackEnabled() {
-    var _a2, _b;
+    var _a3, _b;
     this.checkPremiumSubscription();
-    if (((_b = (_a2 = this.config.rag) == null ? void 0 : _a2.feedback) == null ? void 0 : _b.enabled) === false) {
+    if (((_b = (_a3 = this.config.rag) == null ? void 0 : _a3.feedback) == null ? void 0 : _b.enabled) === false) {
       throw new Error("[Retrivora SDK] User Feedback is disabled in RagConfig.");
     }
   }
@@ -10286,8 +10623,11 @@ var DatabaseStorage = class {
       this.writeLocalFile(this.historyFile, history);
     }
   }
-  async getHistory(sessionId) {
+  async getHistory(sessionId, projectIds) {
     this.checkHistoryEnabled();
+    if (projectIds && projectIds.length > 0 && !this.sessionInScope(sessionId, projectIds)) {
+      return [];
+    }
     if (this.provider === "postgresql" || this.provider === "pgvector") {
       const pool = await this.getPGPool();
       const res = await pool.query(
@@ -10317,8 +10657,11 @@ var DatabaseStorage = class {
       return history.filter((h) => h.session_id === sessionId).sort((a, b) => new Date(a.created_at).getTime() - new Date(b.created_at).getTime());
     }
   }
-  async clearHistory(sessionId) {
+  async clearHistory(sessionId, projectIds) {
     this.checkHistoryEnabled();
+    if (projectIds && projectIds.length > 0 && !this.sessionInScope(sessionId, projectIds)) {
+      return;
+    }
     if (this.provider === "postgresql" || this.provider === "pgvector") {
       const pool = await this.getPGPool();
       await pool.query(`DELETE FROM ${this.historyTableName} WHERE session_id = $1`, [sessionId]);
@@ -10337,21 +10680,36 @@ var DatabaseStorage = class {
       this.writeLocalFile(this.feedbackFile, filteredFeedback);
     }
   }
-  async listSessions() {
+  /**
+   * Return true when `sessionId` falls into the allowed `projectIds` scope.
+   * When `projectIds` is empty / undefined we allow the call (legacy behavior
+   * for non-multi-tenant consumers). Session ids typically begin with the
+   * project id they were created for, so we prefix-match as well as contains-match
+   * to catch sharded / suffix-style ids used by some integrations.
+   */
+  sessionInScope(sessionId, projectIds) {
+    if (!projectIds || projectIds.length === 0) return true;
+    return projectIds.some(
+      (pid) => pid && (sessionId === pid || sessionId.startsWith(pid) || sessionId.includes(pid))
+    );
+  }
+  async listSessions(projectIds) {
     this.checkHistoryEnabled();
+    let raw = [];
     if (this.provider === "postgresql" || this.provider === "pgvector") {
       const pool = await this.getPGPool();
       const res = await pool.query(`SELECT DISTINCT session_id FROM ${this.historyTableName}`);
-      return res.rows.map((r) => r.session_id);
+      raw = res.rows.map((r) => r.session_id);
     } else if (this.provider === "mongodb") {
       await this.getMongoClient();
       const db = this.getMongoDb();
-      return db.collection(this.historyTableName).distinct("session_id");
+      raw = await db.collection(this.historyTableName).distinct("session_id");
     } else {
       const history = this.readLocalFile(this.historyFile);
-      const sessions = new Set(history.map((h) => h.session_id));
-      return Array.from(sessions);
+      raw = Array.from(new Set(history.map((h) => h.session_id)));
     }
+    if (!projectIds || projectIds.length === 0) return raw;
+    return raw.filter((sid) => this.sessionInScope(sid, projectIds));
   }
   // ─── Feedback Operations ──────────────────────────────────────────────────
   async saveFeedback(feedback) {
@@ -10404,8 +10762,9 @@ var DatabaseStorage = class {
       this.writeLocalFile(this.feedbackFile, list);
     }
   }
-  async getFeedback(messageId) {
+  async getFeedback(messageId, projectIds) {
     this.checkFeedbackEnabled();
+    let item = null;
     if (this.provider === "postgresql" || this.provider === "pgvector") {
       const pool = await this.getPGPool();
       const res = await pool.query(
@@ -10414,28 +10773,34 @@ var DatabaseStorage = class {
          WHERE message_id = $1`,
         [messageId]
       );
-      return res.rows[0] || null;
+      item = res.rows[0] || null;
     } else if (this.provider === "mongodb") {
       await this.getMongoClient();
       const db = this.getMongoDb();
       const col = db.collection(this.feedbackTableName);
-      const item = await col.findOne({ message_id: messageId });
-      if (!item) return null;
-      return {
-        id: item.id,
-        messageId: item.message_id,
-        sessionId: item.session_id,
-        rating: item.rating,
-        comment: item.comment,
-        createdAt: item.created_at
-      };
+      const raw = await col.findOne({ message_id: messageId });
+      if (raw) {
+        item = {
+          id: raw.id,
+          messageId: raw.message_id,
+          sessionId: raw.session_id,
+          rating: raw.rating,
+          comment: raw.comment,
+          createdAt: raw.created_at
+        };
+      }
     } else {
       const list = this.readLocalFile(this.feedbackFile);
-      return list.find((f) => f.message_id === messageId) || null;
+      item = list.find((f) => f.message_id === messageId) || null;
     }
+    if (item && projectIds && projectIds.length > 0) {
+      return this.sessionInScope(item.sessionId, projectIds) ? item : null;
+    }
+    return item;
   }
-  async listFeedback() {
+  async listFeedback(projectIds) {
     this.checkFeedbackEnabled();
+    let raw = [];
     if (this.provider === "postgresql" || this.provider === "pgvector") {
       const pool = await this.getPGPool();
       const res = await pool.query(
@@ -10443,13 +10808,13 @@ var DatabaseStorage = class {
          FROM ${this.feedbackTableName} 
          ORDER BY created_at DESC`
       );
-      return res.rows;
+      raw = res.rows;
     } else if (this.provider === "mongodb") {
       await this.getMongoClient();
       const db = this.getMongoDb();
       const col = db.collection(this.feedbackTableName);
       const items = await col.find({}).sort({ created_at: -1 }).toArray();
-      return items.map((item) => ({
+      raw = items.map((item) => ({
         id: item.id,
         messageId: item.message_id,
         sessionId: item.session_id,
@@ -10459,8 +10824,10 @@ var DatabaseStorage = class {
       }));
     } else {
       const list = this.readLocalFile(this.feedbackFile);
-      return [...list].sort((a, b) => new Date(b.created_at).getTime() - new Date(a.created_at).getTime());
+      raw = [...list].sort((a, b) => new Date(b.created_at).getTime() - new Date(a.created_at).getTime());
     }
+    if (!projectIds || projectIds.length === 0) return raw;
+    return raw.filter((f) => this.sessionInScope(f.sessionId, projectIds));
   }
   async disconnect() {
     if (this.pgPool) {
@@ -10523,8 +10890,8 @@ var _g = global;
 var _a;
 var rateLimiter = (_a = _g.__retrivoraRateLimiter) != null ? _a : _g.__retrivoraRateLimiter = new RateLimiter(6e4, 30);
 function getRateLimitKey(req) {
-  var _a2, _b;
-  const ip = ((_b = (_a2 = req.headers.get("x-forwarded-for")) == null ? void 0 : _a2.split(",")[0]) == null ? void 0 : _b.trim()) || req.headers.get("x-real-ip") || "127.0.0.1";
+  var _a3, _b;
+  const ip = ((_b = (_a3 = req.headers.get("x-forwarded-for")) == null ? void 0 : _a3.split(",")[0]) == null ? void 0 : _b.trim()) || req.headers.get("x-real-ip") || "127.0.0.1";
   return `ip:${ip}`;
 }
 function checkRateLimit(req) {
@@ -10546,6 +10913,66 @@ function checkRateLimit(req) {
   }
   return null;
 }
+var FREE_TIER_NAMES = /* @__PURE__ */ new Set(["hobby", "free", "free_trial", "trial"]);
+function isFreeTier(tier) {
+  if (!tier) return true;
+  return FREE_TIER_NAMES.has(tier.toLowerCase().trim());
+}
+var _a2;
+var _freeTierGuardInstance = (_a2 = _g.__retrivoraFreeTierGuard) != null ? _a2 : _g.__retrivoraFreeTierGuard = new FreeTierLimitsGuard();
+function createPaymentRequiredResponse(reason, details) {
+  const body = __spreadProps(__spreadValues({
+    type: "https://retrivora.com/docs/errors/payment-required",
+    title: "Payment Required",
+    status: 402,
+    detail: reason,
+    code: "FREE_TIER_LIMIT_EXCEEDED",
+    instance: void 0
+  }, details != null ? details : {}), {
+    quota: {
+      maxDailyRequestUnits: FREE_TIER_QUOTAS.MAX_DAILY_REQUEST_UNITS,
+      maxTrialRequestUnits: FREE_TIER_QUOTAS.MAX_TRIAL_REQUEST_UNITS,
+      maxDocuments: FREE_TIER_QUOTAS.MAX_DOCUMENTS,
+      maxStorageBytes: FREE_TIER_QUOTAS.MAX_STORAGE_BYTES,
+      upgradeUrl: "https://retrivora.com/pricing"
+    }
+  });
+  return new Response(JSON.stringify(body), {
+    status: 402,
+    headers: {
+      "Content-Type": "application/problem+json"
+    }
+  });
+}
+function resolveLicenseKey(req, config, bodyLicenseKey) {
+  var _a3;
+  return req.headers.get("x-license-key") || bodyLicenseKey || ((_a3 = req.headers.get("authorization")) == null ? void 0 : _a3.replace(/^Bearer\s+/i, "")) || config.licenseKey || process.env.NEXT_PUBLIC_RETRIVORA_LICENSE_KEY || process.env.RETRIVORA_LICENSE_KEY || process.env.RAG_LICENSE_KEY || "";
+}
+function enforceLicense(req, config, bodyLicenseKey) {
+  const rawKey = resolveLicenseKey(req, config, bodyLicenseKey);
+  const licenseKey = (rawKey || "").trim().replace(/^["']|["']$/g, "").trim();
+  const projectId = config.projectId || "my-rag-app";
+  try {
+    const payload = LicenseVerifier.verify(licenseKey, projectId);
+    return { ok: true, payload };
+  } catch (err) {
+    const message = err instanceof Error ? err.message : "Missing or invalid RETRIVORA_LICENSE_KEY. Set NEXT_PUBLIC_RETRIVORA_LICENSE_KEY in your environment or contact your administrator.";
+    const body = {
+      error: {
+        code: "LICENSE_REVOKED",
+        message: "Your Retrivora license key has been terminated, suspended, or revoked. Access denied."
+      },
+      details: message
+    };
+    return {
+      ok: false,
+      response: new Response(JSON.stringify(body), {
+        status: 403,
+        headers: { "Content-Type": "application/json" }
+      })
+    };
+  }
+}
 var MAX_MESSAGE_LENGTH = 8e3;
 function sanitizeInput(raw) {
   const stripped = raw.replace(/[\u0000-\u0008\u000B\u000C\u000E-\u001F\u007F-\u009F]/g, "");
@@ -10567,7 +10994,7 @@ function getOrCreatePlugin(configOrPlugin) {
   return _g[cacheKey];
 }
 function reportTelemetry(req, plugin, action, status, details, trace) {
-  var _a2, _b, _c, _d, _e, _f, _g2;
+  var _a3, _b, _c, _d, _e, _f, _g2;
   try {
     const config = plugin.getConfig();
     const licenseKey = config.licenseKey || process.env.RAG_LICENSE_KEY || process.env.RETRIVORA_LICENSE_KEY || process.env.NEXT_PUBLIC_RETRIVORA_LICENSE_KEY;
@@ -10582,7 +11009,7 @@ function reportTelemetry(req, plugin, action, status, details, trace) {
       absoluteUrl = `${proto}://${host}${telemetryUrl}`;
     }
     const projectId = config.projectId || "default";
-    const model = (trace == null ? void 0 : trace.model) || ((_a2 = config.llm) == null ? void 0 : _a2.model) || ((_b = config.embedding) == null ? void 0 : _b.model) || "llama-3.1-8b-instant";
+    const model = (trace == null ? void 0 : trace.model) || ((_a3 = config.llm) == null ? void 0 : _a3.model) || ((_b = config.embedding) == null ? void 0 : _b.model) || "llama-3.1-8b-instant";
     const provider = (trace == null ? void 0 : trace.provider) || ((_c = config.llm) == null ? void 0 : _c.provider) || ((_d = config.embedding) == null ? void 0 : _d.provider) || "groq";
     const tokens = Number(((_e = trace == null ? void 0 : trace.tokens) == null ? void 0 : _e.totalTokens) || (trace == null ? void 0 : trace.totalTokens) || 0);
     const costUsd = Number(((_f = trace == null ? void 0 : trace.tokens) == null ? void 0 : _f.estimatedCostUsd) || (trace == null ? void 0 : trace.costUsd) || 0);
@@ -10606,7 +11033,6 @@ function reportTelemetry(req, plugin, action, status, details, trace) {
       timestamp: (/* @__PURE__ */ new Date()).toISOString(),
       details
     };
-    console.log(`[Retrivora SDK Telemetry] Dispatching telemetry -> Feature: "${action}", Status: "${status}", Project: "${projectId}", Latency: ${latencyMs}ms`);
     fetch(absoluteUrl, {
       method: "POST",
       headers: {
@@ -10664,14 +11090,39 @@ function createChatHandler(configOrPlugin, options) {
   const storage = new DatabaseStorage(plugin.getConfig());
   const onAuthorize = options == null ? void 0 : options.onAuthorize;
   return async function POST(req, context) {
-    var _a2, _b, _c, _d;
+    var _a3, _b, _c, _d, _e, _f;
     const authResult = await checkAuth(req, onAuthorize);
     if (authResult) return authResult;
     const rateLimited = checkRateLimit(req);
     if (rateLimited) return rateLimited;
+    const config = plugin.getConfig();
     try {
       const body = await req.json();
       const bodyObj = body != null ? body : {};
+      const licenseCheck = enforceLicense(req, config, bodyObj == null ? void 0 : bodyObj.licenseKey);
+      if (!licenseCheck.ok) return licenseCheck.response;
+      if (isFreeTier(licenseCheck.payload.tier)) {
+        const estimatedInputTokens = Math.ceil(
+          ((((_a3 = bodyObj.message) == null ? void 0 : _a3.length) || 0) + (Array.isArray(bodyObj.messages) ? bodyObj.messages.reduce((a, m) => {
+            var _a4, _b2;
+            return a + (((_a4 = m == null ? void 0 : m.content) == null ? void 0 : _a4.length) || ((_b2 = m == null ? void 0 : m.text) == null ? void 0 : _b2.length) || 0);
+          }, 0) : 0) + (((_b = bodyObj.history) == null ? void 0 : _b.reduce((a, m) => {
+            var _a4, _b2;
+            return a + (((_a4 = m == null ? void 0 : m.content) == null ? void 0 : _a4.length) || ((_b2 = m == null ? void 0 : m.text) == null ? void 0 : _b2.length) || 0);
+          }, 0)) || 0)) / 4
+        );
+        const chatCheck = FreeTierLimitsGuard.checkRequestAllowed({
+          operationType: "chat",
+          inputTokens: estimatedInputTokens,
+          projectId: licenseCheck.payload.projectId
+        });
+        if (!chatCheck.allowed) {
+          return createPaymentRequiredResponse(
+            chatCheck.reason || "Free tier quota exceeded.",
+            { tier: licenseCheck.payload.tier, projectId: licenseCheck.payload.projectId }
+          );
+        }
+      }
       let rawMessage = bodyObj.message;
       if (!rawMessage && Array.isArray(bodyObj.messages) && bodyObj.messages.length > 0) {
         const lastMsg = bodyObj.messages[bodyObj.messages.length - 1];
@@ -10703,7 +11154,7 @@ function createChatHandler(configOrPlugin, options) {
         uiTransformation: result.ui_transformation,
         trace: result.trace
       }).catch((err) => console.warn("[createChatHandler] Failed to save assistant message:", err));
-      reportTelemetry(req, plugin, "QUERY_GENERATION", "success", `Tokens: ${((_b = (_a2 = result.trace) == null ? void 0 : _a2.tokens) == null ? void 0 : _b.totalTokens) || 0}, Latency: ${((_d = (_c = result.trace) == null ? void 0 : _c.latency) == null ? void 0 : _d.totalMs) || 0}ms`, result.trace);
+      reportTelemetry(req, plugin, "QUERY_GENERATION", "success", `Tokens: ${((_d = (_c = result.trace) == null ? void 0 : _c.tokens) == null ? void 0 : _d.totalTokens) || 0}, Latency: ${((_f = (_e = result.trace) == null ? void 0 : _e.latency) == null ? void 0 : _f.totalMs) || 0}ms`, result.trace);
       return NextResponse.json(__spreadProps(__spreadValues({}, result), {
         messageId: assistantMsgId,
         userMessageId: userMsgId
@@ -10720,14 +11171,15 @@ function createStreamHandler(configOrPlugin, options) {
   const storage = new DatabaseStorage(plugin.getConfig());
   const onAuthorize = options == null ? void 0 : options.onAuthorize;
   return async function POST(req, context) {
-    var _a2;
+    var _a3, _b, _c;
     const authResult = await checkAuth(req, onAuthorize);
     if (authResult) return authResult;
     const rateLimited = checkRateLimit(req);
     if (rateLimited) return rateLimited;
+    const config = plugin.getConfig();
     let body;
     try {
-      if ((_a2 = req.headers.get("content-type")) == null ? void 0 : _a2.includes("multipart/form-data")) {
+      if ((_a3 = req.headers.get("content-type")) == null ? void 0 : _a3.includes("multipart/form-data")) {
         const uploader = createUploadHandler(plugin, { onAuthorize });
         return uploader(req);
       }
@@ -10739,6 +11191,30 @@ function createStreamHandler(configOrPlugin, options) {
       });
     }
     const bodyObj = body != null ? body : {};
+    const licenseCheck = enforceLicense(req, config, bodyObj == null ? void 0 : bodyObj.licenseKey);
+    if (!licenseCheck.ok) return licenseCheck.response;
+    if (isFreeTier(licenseCheck.payload.tier)) {
+      const estimatedInputTokens = Math.ceil(
+        ((((_b = bodyObj.message) == null ? void 0 : _b.length) || 0) + (Array.isArray(bodyObj.messages) ? bodyObj.messages.reduce((a, m) => {
+          var _a4, _b2;
+          return a + (((_a4 = m == null ? void 0 : m.content) == null ? void 0 : _a4.length) || ((_b2 = m == null ? void 0 : m.text) == null ? void 0 : _b2.length) || 0);
+        }, 0) : 0) + (((_c = bodyObj.history) == null ? void 0 : _c.reduce((a, m) => {
+          var _a4, _b2;
+          return a + (((_a4 = m == null ? void 0 : m.content) == null ? void 0 : _a4.length) || ((_b2 = m == null ? void 0 : m.text) == null ? void 0 : _b2.length) || 0);
+        }, 0)) || 0)) / 4
+      );
+      const chatCheck = FreeTierLimitsGuard.checkRequestAllowed({
+        operationType: "chat_stream",
+        inputTokens: estimatedInputTokens,
+        projectId: licenseCheck.payload.projectId
+      });
+      if (!chatCheck.allowed) {
+        return createPaymentRequiredResponse(
+          chatCheck.reason || "Free tier quota exceeded.",
+          { tier: licenseCheck.payload.tier, projectId: licenseCheck.payload.projectId }
+        );
+      }
+    }
     let rawMessage = bodyObj.message;
     if (!rawMessage && Array.isArray(bodyObj.messages) && bodyObj.messages.length > 0) {
       const lastMsg = bodyObj.messages[bodyObj.messages.length - 1];
@@ -10768,7 +11244,7 @@ function createStreamHandler(configOrPlugin, options) {
     let isActive = true;
     const stream = new ReadableStream({
       async start(controller) {
-        var _a3, _b, _c, _d, _e;
+        var _a4, _b2, _c2, _d, _e;
         const enqueue = (text) => {
           if (!isActive) return;
           try {
@@ -10801,7 +11277,7 @@ function createStreamHandler(configOrPlugin, options) {
                 let uiTransformation = responseChunk == null ? void 0 : responseChunk.ui_transformation;
                 if (sources.length > 0) {
                   try {
-                    uiTransformation = (_a3 = responseChunk == null ? void 0 : responseChunk.ui_transformation) != null ? _a3 : UITransformer.transform(message, sources, plugin.getConfig());
+                    uiTransformation = (_a4 = responseChunk == null ? void 0 : responseChunk.ui_transformation) != null ? _a4 : UITransformer.transform(message, sources, plugin.getConfig());
                     if (uiTransformation) {
                       enqueue(sseUIFrame(uiTransformation));
                     }
@@ -10825,7 +11301,7 @@ function createStreamHandler(configOrPlugin, options) {
                   uiTransformation,
                   trace: responseChunk == null ? void 0 : responseChunk.trace
                 }).catch((err) => console.warn("[createStreamHandler] Failed to save assistant message:", err));
-                reportTelemetry(req, plugin, "QUERY_GENERATION", "success", `Tokens: ${((_c = (_b = responseChunk == null ? void 0 : responseChunk.trace) == null ? void 0 : _b.tokens) == null ? void 0 : _c.totalTokens) || 0}, Latency: ${((_e = (_d = responseChunk == null ? void 0 : responseChunk.trace) == null ? void 0 : _d.latency) == null ? void 0 : _e.totalMs) || 0}ms`, responseChunk == null ? void 0 : responseChunk.trace);
+                reportTelemetry(req, plugin, "QUERY_GENERATION", "success", `Tokens: ${((_c2 = (_b2 = responseChunk == null ? void 0 : responseChunk.trace) == null ? void 0 : _b2.tokens) == null ? void 0 : _c2.totalTokens) || 0}, Latency: ${((_e = (_d = responseChunk == null ? void 0 : responseChunk.trace) == null ? void 0 : _d.latency) == null ? void 0 : _e.totalMs) || 0}ms`, responseChunk == null ? void 0 : responseChunk.trace);
               }
             }
           } catch (temp) {
@@ -10875,12 +11351,36 @@ function createIngestHandler(configOrPlugin, options) {
   return async function POST(req, context) {
     const authResult = await checkAuth(req, onAuthorize);
     if (authResult) return authResult;
+    const config = plugin.getConfig();
     try {
       const body = await req.json();
+      const licenseCheck = enforceLicense(req, config, body == null ? void 0 : body.licenseKey);
+      if (!licenseCheck.ok) return licenseCheck.response;
       const { documents, namespace } = body;
       if (!Array.isArray(documents) || documents.length === 0) {
         return NextResponse.json({ error: "documents array is required" }, { status: 400 });
       }
+      if (isFreeTier(licenseCheck.payload.tier)) {
+        const totalIncomingBytes = documents.reduce(
+          (sum, d) => sum + Buffer.byteLength(d.content || "", "utf8"),
+          0
+        );
+        const ingestCheck = FreeTierLimitsGuard.checkIngestionAllowed(
+          { documentCount: documents.length },
+          totalIncomingBytes
+        );
+        if (!ingestCheck.allowed) {
+          return createPaymentRequiredResponse(
+            ingestCheck.reason || "Free tier ingestion limit reached.",
+            {
+              tier: licenseCheck.payload.tier,
+              projectId: licenseCheck.payload.projectId,
+              documents: documents.length,
+              incomingBytes: totalIncomingBytes
+            }
+          );
+        }
+      }
       const results = await plugin.ingest(documents, namespace);
       reportTelemetry(req, plugin, "DOCUMENT_INGESTION", "success", `Ingested ${documents.length} document(s)`);
       return NextResponse.json({ results });
@@ -10917,7 +11417,7 @@ function createLicenseHandler(configOrPlugin, options) {
   const plugin = getOrCreatePlugin(configOrPlugin);
   const onAuthorize = options == null ? void 0 : options.onAuthorize;
   return async function POST(req) {
-    var _a2;
+    var _a3;
     if (req) {
       const authResult = await checkAuth(req, onAuthorize);
       if (authResult) return authResult;
@@ -10925,7 +11425,7 @@ function createLicenseHandler(configOrPlugin, options) {
     try {
       const body = await req.json().catch(() => ({}));
       const config = plugin.getConfig();
-      const rawKey = req.headers.get("x-license-key") || (body == null ? void 0 : body.licenseKey) || ((_a2 = req.headers.get("authorization")) == null ? void 0 : _a2.replace(/^Bearer\s+/i, "")) || config.licenseKey || process.env.NEXT_PUBLIC_RETRIVORA_LICENSE_KEY || process.env.RETRIVORA_LICENSE_KEY || "";
+      const rawKey = req.headers.get("x-license-key") || (body == null ? void 0 : body.licenseKey) || ((_a3 = req.headers.get("authorization")) == null ? void 0 : _a3.replace(/^Bearer\s+/i, "")) || config.licenseKey || process.env.NEXT_PUBLIC_RETRIVORA_LICENSE_KEY || process.env.RETRIVORA_LICENSE_KEY || "";
       const licenseKey = (rawKey || "").trim().replace(/^["']|["']$/g, "").trim();
       const projectId = (body == null ? void 0 : body.projectId) || config.projectId || "my-rag-app";
       const payload = LicenseVerifier.verify(licenseKey, projectId);
@@ -10960,6 +11460,9 @@ function createUploadHandler(configOrPlugin, options) {
   return async function POST(req, context) {
     const authResult = await checkAuth(req, onAuthorize);
     if (authResult) return authResult;
+    const config = plugin.getConfig();
+    const licenseCheck = enforceLicense(req, config);
+    if (!licenseCheck.ok) return licenseCheck.response;
     try {
       const formData = await req.formData();
       const files = formData.getAll("files");
@@ -10969,6 +11472,26 @@ function createUploadHandler(configOrPlugin, options) {
       if (!files || files.length === 0) {
         return NextResponse.json({ error: "No files provided" }, { status: 400 });
       }
+      if (isFreeTier(licenseCheck.payload.tier)) {
+        const totalUploadBytes = files.reduce((sum, f) => sum + (f.size || 0), 0);
+        const uploadCheck = FreeTierLimitsGuard.checkIngestionAllowed(
+          { documentCount: files.length },
+          totalUploadBytes
+        );
+        if (!uploadCheck.allowed) {
+          return createPaymentRequiredResponse(
+            uploadCheck.reason || "Free tier upload limit reached.",
+            {
+              tier: licenseCheck.payload.tier,
+              projectId: licenseCheck.payload.projectId,
+              fileCount: files.length,
+              totalUploadBytes,
+              maxFileSizeBytes: FREE_TIER_QUOTAS.MAX_FILE_SIZE_BYTES,
+              maxStorageBytes: FREE_TIER_QUOTAS.MAX_STORAGE_BYTES
+            }
+          );
+        }
+      }
       const documents = [];
       for (const file of files) {
         const isExcel = file.name.toLowerCase().endsWith(".xlsx") || file.name.toLowerCase().endsWith(".xls") || file.type.includes("spreadsheet") || file.type.includes("excel");
@@ -11078,13 +11601,22 @@ function createSuggestionsHandler(configOrPlugin, options) {
   return async function handler(req) {
     const authResult = await checkAuth(req, onAuthorize);
     if (authResult) return authResult;
+    const config = plugin.getConfig();
+    const licenseCheck = enforceLicense(req, config);
+    if (!licenseCheck.ok) return licenseCheck.response;
     try {
       let query = "";
       let namespace = void 0;
+      let bodyLicenseKey = void 0;
       if (req.method === "POST") {
         const body = await req.json().catch(() => ({}));
         query = body.query || "";
         namespace = body.namespace;
+        bodyLicenseKey = body.licenseKey;
+        if (bodyLicenseKey) {
+          const recheck = enforceLicense(req, config, bodyLicenseKey);
+          if (!recheck.ok) return recheck.response;
+        }
       } else {
         const url = new URL(req.url);
         query = url.searchParams.get("query") || "";
@@ -11107,14 +11639,16 @@ function createHistoryHandler(configOrPlugin, options) {
   const plugin = getOrCreatePlugin(configOrPlugin);
   const storage = new DatabaseStorage(plugin.getConfig());
   const onAuthorize = options == null ? void 0 : options.onAuthorize;
+  const onResolveScope = options == null ? void 0 : options.onResolveScope;
   return async function handler(req) {
     const authResult = await checkAuth(req, onAuthorize);
     if (authResult) return authResult;
+    const scope = onResolveScope ? await onResolveScope(req) : void 0;
     const url = new URL(req.url);
     const sessionId = url.searchParams.get("sessionId") || "default";
     if (req.method === "GET") {
       try {
-        const history = await storage.getHistory(sessionId);
+        const history = await storage.getHistory(sessionId, scope);
         return NextResponse.json({ history });
       } catch (err) {
         const message = err instanceof Error ? err.message : "Failed to fetch history";
@@ -11124,7 +11658,7 @@ function createHistoryHandler(configOrPlugin, options) {
       try {
         const body = await req.json().catch(() => ({}));
         const sid = body.sessionId || sessionId;
-        await storage.clearHistory(sid);
+        await storage.clearHistory(sid, scope);
         return NextResponse.json({ success: true });
       } catch (err) {
         const message = err instanceof Error ? err.message : "Failed to clear history";
@@ -11138,18 +11672,20 @@ function createFeedbackHandler(configOrPlugin, options) {
   const plugin = getOrCreatePlugin(configOrPlugin);
   const storage = new DatabaseStorage(plugin.getConfig());
   const onAuthorize = options == null ? void 0 : options.onAuthorize;
+  const onResolveScope = options == null ? void 0 : options.onResolveScope;
   return async function handler(req) {
     const authResult = await checkAuth(req, onAuthorize);
     if (authResult) return authResult;
+    const scope = onResolveScope ? await onResolveScope(req) : void 0;
     if (req.method === "GET") {
       try {
         const url = new URL(req.url);
         const messageId = url.searchParams.get("messageId");
         if (!messageId) {
-          const feedbackList = await storage.listFeedback();
+          const feedbackList = await storage.listFeedback(scope);
           return NextResponse.json({ feedback: feedbackList });
         }
-        const feedback = await storage.getFeedback(messageId);
+        const feedback = await storage.getFeedback(messageId, scope);
         return NextResponse.json({ feedback });
       } catch (err) {
         const message = err instanceof Error ? err.message : "Failed to fetch feedback";
@@ -11165,6 +11701,17 @@ function createFeedbackHandler(configOrPlugin, options) {
         if (!rating) {
           return NextResponse.json({ error: "rating is required" }, { status: 400 });
         }
+        if (scope && scope.length > 0) {
+          const matches = scope.some(
+            (pid) => pid && (sessionId === pid || sessionId.startsWith(pid) || sessionId.includes(pid))
+          );
+          if (!matches) {
+            return NextResponse.json(
+              { error: "sessionId is outside the authorized project scope" },
+              { status: 403 }
+            );
+          }
+        }
         await storage.saveFeedback({ messageId, sessionId, rating, comment });
         return NextResponse.json({ success: true });
       } catch (err) {
@@ -11179,14 +11726,15 @@ function createSessionsHandler(configOrPlugin, options) {
   const plugin = getOrCreatePlugin(configOrPlugin);
   const storage = new DatabaseStorage(plugin.getConfig());
   const onAuthorize = options == null ? void 0 : options.onAuthorize;
+  const onResolveScope = options == null ? void 0 : options.onResolveScope;
   return async function GET(req) {
     if (req) {
       const authResult = await checkAuth(req, onAuthorize);
       if (authResult) return authResult;
     }
-    void req;
     try {
-      const sessions = await storage.listSessions();
+      const scope = req && onResolveScope ? await onResolveScope(req) : void 0;
+      const sessions = await storage.listSessions(scope);
       return NextResponse.json({ sessions });
     } catch (err) {
       const message = err instanceof Error ? err.message : "Failed to list sessions";
@@ -11197,15 +11745,17 @@ function createSessionsHandler(configOrPlugin, options) {
 function createRagHandler(configOrPlugin, options) {
   const plugin = getOrCreatePlugin(configOrPlugin);
   const onAuthorize = options == null ? void 0 : options.onAuthorize;
-  const chatHandler = createChatHandler(plugin, { onAuthorize });
-  const streamHandler = createStreamHandler(plugin, { onAuthorize });
-  const uploadHandler = createUploadHandler(plugin, { onAuthorize });
-  const healthHandler = createHealthHandler(plugin, { onAuthorize });
-  const suggestionsHandler = createSuggestionsHandler(plugin, { onAuthorize });
-  const historyHandler = createHistoryHandler(plugin, { onAuthorize });
-  const feedbackHandler = createFeedbackHandler(plugin, { onAuthorize });
-  const sessionsHandler = createSessionsHandler(plugin, { onAuthorize });
-  const licenseHandler = createLicenseHandler(plugin, { onAuthorize });
+  const onResolveScope = options == null ? void 0 : options.onResolveScope;
+  const scopeableOptions = { onAuthorize, onResolveScope };
+  const chatHandler = createChatHandler(plugin, scopeableOptions);
+  const streamHandler = createStreamHandler(plugin, scopeableOptions);
+  const uploadHandler = createUploadHandler(plugin, scopeableOptions);
+  const healthHandler = createHealthHandler(plugin, scopeableOptions);
+  const suggestionsHandler = createSuggestionsHandler(plugin, scopeableOptions);
+  const historyHandler = createHistoryHandler(plugin, scopeableOptions);
+  const feedbackHandler = createFeedbackHandler(plugin, scopeableOptions);
+  const sessionsHandler = createSessionsHandler(plugin, scopeableOptions);
+  const licenseHandler = createLicenseHandler(plugin, scopeableOptions);
   async function routePostRequest(req, segment) {
     switch (segment) {
       case "chat":
@@ -11247,7 +11797,7 @@ function createRagHandler(configOrPlugin, options) {
     }
   }
   async function getSegment(req, context) {
-    var _a2, _b;
+    var _a3, _b;
     const contentType = req.headers.get("content-type") || "";
     if (contentType.includes("multipart/form-data")) {
       return "upload";
@@ -11264,7 +11814,7 @@ function createRagHandler(configOrPlugin, options) {
       if (pathname.endsWith("/history")) return "history";
     } catch (e) {
     }
-    const resolvedParams = typeof ((_a2 = context == null ? void 0 : context.params) == null ? void 0 : _a2.then) === "function" ? await context.params : context == null ? void 0 : context.params;
+    const resolvedParams = typeof ((_a3 = context == null ? void 0 : context.params) == null ? void 0 : _a3.then) === "function" ? await context.params : context == null ? void 0 : context.params;
     const segments = (resolvedParams == null ? void 0 : resolvedParams.retrivora) || ((_b = resolvedParams == null ? void 0 : resolvedParams.params) == null ? void 0 : _b.retrivora) || [];
     const joined = segments.join("/");
     return joined || "chat";
@@ -11297,6 +11847,7 @@ var _LicenseValidator = class _LicenseValidator {
   constructor() {
     this.cache = /* @__PURE__ */ new Map();
   }
+  /** @returns Singleton instance of the validator (shared cache across all consumers). */
   static getInstance() {
     if (!_LicenseValidator.instance) {
       _LicenseValidator.instance = new _LicenseValidator();
@@ -11304,7 +11855,12 @@ var _LicenseValidator = class _LicenseValidator {
     return _LicenseValidator.instance;
   }
   /**
-   * Invalidate local validation cache for a license key
+   * Purge entries from the local success cache.
+   *
+   * @param licenseKey - Optional. If provided, only that key's cache entry is
+   *                     removed. If omitted the entire cache is cleared.
+   *                     Callers use this after any 401/403 to ensure the next
+   *                     validate() call re-validates against the server.
    */
   purgeCache(licenseKey) {
     if (licenseKey) {
@@ -11314,10 +11870,20 @@ var _LicenseValidator = class _LicenseValidator {
     }
   }
   /**
-   * Validate license status and SDK version against Retrivora License Service
+   * Primary validation entry-point for UI / hook consumers.
+   *
+   * Resolves the license key, consults the local success cache, performs a
+   * server POST for authoritative status, and falls back to local RSA
+   * signature verification if the server can't be reached.
+   *
+   * @throws LicenseValidationError - When no key is provided OR both the
+   *         server call AND the local-RSA fallback report an invalid/expired key.
+   * @throws SDKVersionUnsupportedError - When server reports forceUpgrade=true.
+   * @returns A `LicenseValidationResponse` that the UI can use to enable or
+   *          lock the chat widget.
    */
   async validate(request) {
-    var _a2;
+    var _a3;
     const {
       licenseKey,
       projectId,
@@ -11335,7 +11901,7 @@ var _LicenseValidator = class _LicenseValidator {
       }
       return void 0;
     };
-    const rawKey = licenseKey || getHeader("x-license-key") || ((_a2 = getHeader("authorization")) == null ? void 0 : _a2.replace(/^Bearer\s+/i, "")) || (typeof process !== "undefined" ? process.env.NEXT_PUBLIC_RETRIVORA_LICENSE_KEY || process.env.RETRIVORA_LICENSE_KEY : "") || "";
+    const rawKey = licenseKey || getHeader("x-license-key") || ((_a3 = getHeader("authorization")) == null ? void 0 : _a3.replace(/^Bearer\s+/i, "")) || (typeof process !== "undefined" ? process.env.NEXT_PUBLIC_RETRIVORA_LICENSE_KEY || process.env.RETRIVORA_LICENSE_KEY : "") || "";
     const effectiveLicenseKey = (rawKey || "").trim().replace(/^["']|["']$/g, "").trim();
     if (!effectiveLicenseKey) {
       this.purgeCache(effectiveLicenseKey);