@retrivora-ai/rag-engine 2.0.8 → 2.1.1

package/dist/handlers/index.js

@@ -594,6 +594,7 @@ function cleanApiKeyOverride(apiKeyOverride) {
 async function dispatchChatCompletion(req, apiKeyOverride) {
   const effectiveKey = cleanApiKeyOverride(apiKeyOverride);
   const provider = resolveProvider(req.model);
+  console.log(`[LLM Gateway Router] Dispatching chat request: model=${req.model}, provider=${provider}, hasGroqKey=${Boolean(process.env.GROQ_API_KEY)}, hasGeminiKey=${Boolean(process.env.GROQ_API_KEY || process.env.GEMINI_API_KEY)}, hasHFToken=${Boolean(process.env.HF_TOKEN)}`);
   try {
     switch (provider) {
       case "groq":
@@ -612,6 +613,10 @@ async function dispatchChatCompletion(req, apiKeyOverride) {
         throw new Error(`Unsupported LLM provider for model: ${req.model}`);
     }
   } catch (error) {
+    console.error(`[LLM Gateway Router] Provider '${provider}' failed for model '${req.model}':`, {
+      message: error.message,
+      stack: error.stack
+    });
     if (/rate[- ]?limit|429|exhausted/i.test(error.message)) {
       const isGroqKey = process.env.GROQ_API_KEY || effectiveKey && effectiveKey.startsWith("gsk_");
       const reqModelLower = req.model.toLowerCase();
@@ -619,7 +624,8 @@ async function dispatchChatCompletion(req, apiKeyOverride) {
         console.warn(`[LLM Gateway] Provider ${provider} rate limited (${error.message}). Falling back to secondary Groq model (llama-3.3-70b-versatile)...`);
         try {
           return await handleGroqRequest(__spreadProps(__spreadValues({}, req), { model: "llama-3.3-70b-versatile" }), effectiveKey);
-        } catch (e) {
+        } catch (fErr) {
+          console.error("[LLM Gateway] Fallback groq/llama-3.3-70b-versatile failed:", fErr.message);
         }
       }
       const geminiKey = process.env.GEMINI_API_KEY || effectiveKey;
@@ -627,14 +633,16 @@ async function dispatchChatCompletion(req, apiKeyOverride) {
         console.warn(`[LLM Gateway] Provider ${provider} rate limited (${error.message}). Falling back to Google Gemini (gemini-2.5-flash)...`);
         try {
           return await handleGeminiRequest(__spreadProps(__spreadValues({}, req), { model: "gemini-2.5-flash" }), effectiveKey);
-        } catch (e) {
+        } catch (fErr) {
+          console.error("[LLM Gateway] Fallback gemini-2.5-flash failed:", fErr.message);
         }
       }
       if (provider !== "huggingface" && (process.env.HF_TOKEN || process.env.HUGGINGFACE_API_KEY)) {
         console.warn(`[LLM Gateway] Provider ${provider} rate limited (${error.message}). Falling back to Hugging Face (Qwen/Qwen2.5-Coder-32B-Instruct)...`);
         try {
           return await handleHuggingFaceChatRequest(__spreadProps(__spreadValues({}, req), { model: "Qwen/Qwen2.5-Coder-32B-Instruct" }), effectiveKey);
-        } catch (e) {
+        } catch (fErr) {
+          console.error("[LLM Gateway] Fallback HuggingFace Qwen failed:", fErr.message);
         }
       }
       if (provider !== "openai" && process.env.OPENAI_API_KEY) {
@@ -3428,12 +3436,13 @@ var OpenAIProvider = class {
       role: "system",
       content: buildSystemContent(basePrompt, context)
     };
+    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) : ""
+    }));
     const formattedMessages = [
       systemMessage,
-      ...messages.map((m) => ({
-        role: m.role,
-        content: m.content
-      }))
+      ...safeMessages
     ];
     const completion = await this.client.chat.completions.create({
       model: this.llmConfig.model,
@@ -3452,12 +3461,13 @@ var OpenAIProvider = class {
         role: "system",
         content: buildSystemContent(basePrompt, context)
       };
+      const safeStreamMessages = (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) : ""
+      }));
       const formattedMessages = [
         systemMessage,
-        ...messages.map((m) => ({
-          role: m.role,
-          content: m.content
-        }))
+        ...safeStreamMessages
       ];
       const stream = yield new __await(this.client.chat.completions.create({
         model: this.llmConfig.model,
@@ -3988,9 +3998,9 @@ var GeminiProvider = class {
    *   - Messages must strictly alternate between `user` and `model`.
    */
   buildGeminiContents(messages) {
-    return messages.filter((m) => m.role !== "system").map((m) => ({
+    return (messages || []).filter((m) => Boolean(m && typeof m === "object" && m.role !== "system")).map((m) => ({
       role: m.role === "assistant" ? "model" : "user",
-      parts: [{ text: m.content }]
+      parts: [{ text: typeof m.content === "string" ? m.content : m.content != null ? String(m.content) : "" }]
     }));
   }
   // -------------------------------------------------------------------------
@@ -4193,12 +4203,13 @@ var GroqProvider = class {
       role: "system",
       content: buildSystemContent(basePrompt, context)
     };
+    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) : ""
+    }));
     const formattedMessages = [
       systemMessage,
-      ...messages.map((m) => ({
-        role: m.role,
-        content: m.content
-      }))
+      ...safeMessages
     ];
     const completion = await this.client.chat.completions.create({
       model: this.llmConfig.model,
@@ -4217,12 +4228,13 @@ var GroqProvider = class {
         role: "system",
         content: buildSystemContent(basePrompt, context)
       };
+      const safeStreamMessages = (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) : ""
+      }));
       const formattedMessages = [
         systemMessage,
-        ...messages.map((m) => ({
-          role: m.role,
-          content: m.content
-        }))
+        ...safeStreamMessages
       ];
       const stream = yield new __await(this.client.chat.completions.create({
         model: this.llmConfig.model,
@@ -4351,12 +4363,13 @@ var QwenProvider = class {
       role: "system",
       content: buildSystemContent(basePrompt, context)
     };
+    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) : ""
+    }));
     const formattedMessages = [
       systemMessage,
-      ...messages.map((m) => ({
-        role: m.role,
-        content: m.content
-      }))
+      ...safeMessages
     ];
     const completion = await this.client.chat.completions.create({
       model: this.llmConfig.model,
@@ -4375,12 +4388,13 @@ var QwenProvider = class {
         role: "system",
         content: buildSystemContent(basePrompt, context)
       };
+      const safeStreamMessages = (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) : ""
+      }));
       const formattedMessages = [
         systemMessage,
-        ...messages.map((m) => ({
-          role: m.role,
-          content: m.content
-        }))
+        ...safeStreamMessages
       ];
       const stream = yield new __await(this.client.chat.completions.create({
         model: this.llmConfig.model,
@@ -4523,12 +4537,16 @@ var UniversalLLMAdapter = class {
   async chat(messages, context) {
     var _a2, _b, _c;
     const path2 = (_a2 = this.opts.chatPath) != null ? _a2 : "/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) : ""
+    }));
     const formattedMessages = [
       { role: "system", content: `${this.systemPrompt}
 
 Context:
 ${context != null ? context : "None"}` },
-      ...messages
+      ...safeMessages
     ];
     let payload;
     if (this.opts.chatPayloadTemplate) {
@@ -4600,12 +4618,16 @@ ${context != null ? context : "None"}` },
       const path2 = (_a2 = this.opts.chatPath) != null ? _a2 : "/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) => ({
+        role: m.role || "user",
+        content: typeof m.content === "string" ? m.content : m.content != null ? String(m.content) : ""
+      }));
       const formattedMessages = [
         { role: "system", content: `${this.systemPrompt}
 
 Context:
 ${context != null ? context : "None"}` },
-        ...messages
+        ...safeMessages
       ];
       let payload;
       if (this.opts.chatPayloadTemplate) {
@@ -6743,8 +6765,8 @@ var IntentClassifier = class {
   }
   // ─── Intent Heuristic Checkers ─────────────────────────────────────────────
   static isInformationLookup(query) {
-    if (/^(what|who|explain|define|where|when|why|how|how does|can|could|does|do|is|are|has|have|will|should|would|meaning of)\s+/i.test(query)) {
-      if (!/\b(compare|versus|vs\.?|trend|monthly|revenue|top selling|best)\b/i.test(query)) {
+    if (/^(what|who|explain|explore|define|where|when|why|how|how does|can|could|does|do|is|are|has|have|will|should|would|meaning of|tell me about|show details of|overview of|summarize)\s+/i.test(query)) {
+      if (!/\b(compare|versus|vs\.?|trend|monthly|revenue|top 10|top selling|best|chart|graph|plot|breakdown|analytics)\b/i.test(query)) {
         return true;
       }
     }
@@ -6781,7 +6803,7 @@ var Rule1SpecificInfoRule = class {
   }
   evaluate(context, intent) {
     const q = (context.userQuery || "").toLowerCase().trim();
-    const isFactQuery = intent === "information_lookup" || /^(what|who|explain|define|where|when|why|meaning of)\s+/i.test(q) || /^(what is the price of|price of|cost of)\b/i.test(q);
+    const isFactQuery = intent === "information_lookup" || /^(what|who|explain|explore|define|where|when|why|meaning of|tell me about|show details of|overview of|summarize)\s+/i.test(q) || /^(what is the price of|price of|cost of)\b/i.test(q);
     const isNonVisual = !/\b(compare|versus|vs\.?|trend|monthly|revenue|best|top 10|chart|table|list|grid)\b/i.test(q);
     if (isFactQuery && isNonVisual) {
       return {
@@ -8060,6 +8082,11 @@ ${schemaProfileText}` : ""}`;
   }
   static chooseAutomaticVisualization(data, profile, query) {
     if (profile.records.length === 0) return null;
+    const q = query.toLowerCase().trim();
+    const isExplicitVisualOrAnalytic = /\b(chart|graph|plot|visualize|trend|monthly|revenue|top\s*\d+|breakdown|analytics|compare|versus|vs\.?|histogram|pie|bar|line|distribution|percentage|share|summary of metrics)\b/i.test(q);
+    if (!isExplicitVisualOrAnalytic) {
+      return null;
+    }
     if (profile.dateFields.length > 0 && profile.numericFields.length > 0) {
       return this.transformToLineChart(profile);
     }
@@ -8175,6 +8202,7 @@ ${schemaProfileText}` : ""}`;
     return Array.from(categories);
   }
   static getProductCategory(item) {
+    if (!item) return null;
     const meta = item.metadata || {};
     const metadataCategory = resolveMetadataValue(meta, "category");
     if (this.isUsableCategory(metadataCategory)) return String(metadataCategory).trim();
@@ -8291,6 +8319,7 @@ ${schemaProfileText}` : ""}`;
       if (!fields.has(normalized)) fields.set(normalized, clean);
     };
     data.forEach((item) => {
+      if (!item) return;
       Object.keys(item.metadata || {}).forEach(addField);
       for (const match of (item.content || "").matchAll(/(?:^|\n)\s*([A-Za-z][A-Za-z0-9_ /-]{1,50})\s*[:\-–]\s*([^\n]+)/g)) {
         addField(match[1]);
@@ -8407,6 +8436,7 @@ ${schemaProfileText}` : ""}`;
     return true;
   }
   static extractStockQuantity(item) {
+    if (!item) return null;
     const meta = item.metadata || {};
     const stockValue = resolveMetadataValue(meta, "stock");
     const numericStock = this.toFiniteNumber(stockValue);
@@ -9667,7 +9697,10 @@ ${context}`;
 Focus on extracting the core intent and entities. Do not answer the question, just rewrite it.
 
 History:
-${history.map((m) => `${m.role}: ${m.content}`).join("\n")}
+${(history || []).map((m) => {
+      var _a2;
+      return `${(m == null ? void 0 : m.role) || "user"}: ${(_a2 = m == null ? void 0 : m.content) != null ? _a2 : ""}`;
+    }).join("\n")}
 
 New Question: ${question}
 
@@ -9691,8 +9724,11 @@ Optimized Search Query:`;
     const ns = formatNamespace(namespace != null ? namespace : this.config.projectId);
     try {
       const { sources } = await this.retrieve(query, { namespace: ns, topK: 5 });
-      if (sources.length === 0) return [];
-      const context = sources.map((s) => s.content).join("\n\n---\n\n");
+      if (!sources || sources.length === 0) return [];
+      const context = sources.map((s) => {
+        var _a2;
+        return (_a2 = s == null ? void 0 : s.content) != null ? _a2 : "";
+      }).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.
 Keep each question under 10 words and make them very specific to the content.

package/dist/handlers/index.mjs

@@ -579,6 +579,7 @@ function cleanApiKeyOverride(apiKeyOverride) {
 async function dispatchChatCompletion(req, apiKeyOverride) {
   const effectiveKey = cleanApiKeyOverride(apiKeyOverride);
   const provider = resolveProvider(req.model);
+  console.log(`[LLM Gateway Router] Dispatching chat request: model=${req.model}, provider=${provider}, hasGroqKey=${Boolean(process.env.GROQ_API_KEY)}, hasGeminiKey=${Boolean(process.env.GROQ_API_KEY || process.env.GEMINI_API_KEY)}, hasHFToken=${Boolean(process.env.HF_TOKEN)}`);
   try {
     switch (provider) {
       case "groq":
@@ -597,6 +598,10 @@ async function dispatchChatCompletion(req, apiKeyOverride) {
         throw new Error(`Unsupported LLM provider for model: ${req.model}`);
     }
   } catch (error) {
+    console.error(`[LLM Gateway Router] Provider '${provider}' failed for model '${req.model}':`, {
+      message: error.message,
+      stack: error.stack
+    });
     if (/rate[- ]?limit|429|exhausted/i.test(error.message)) {
       const isGroqKey = process.env.GROQ_API_KEY || effectiveKey && effectiveKey.startsWith("gsk_");
       const reqModelLower = req.model.toLowerCase();
@@ -604,7 +609,8 @@ async function dispatchChatCompletion(req, apiKeyOverride) {
         console.warn(`[LLM Gateway] Provider ${provider} rate limited (${error.message}). Falling back to secondary Groq model (llama-3.3-70b-versatile)...`);
         try {
           return await handleGroqRequest(__spreadProps(__spreadValues({}, req), { model: "llama-3.3-70b-versatile" }), effectiveKey);
-        } catch (e) {
+        } catch (fErr) {
+          console.error("[LLM Gateway] Fallback groq/llama-3.3-70b-versatile failed:", fErr.message);
         }
       }
       const geminiKey = process.env.GEMINI_API_KEY || effectiveKey;
@@ -612,14 +618,16 @@ async function dispatchChatCompletion(req, apiKeyOverride) {
         console.warn(`[LLM Gateway] Provider ${provider} rate limited (${error.message}). Falling back to Google Gemini (gemini-2.5-flash)...`);
         try {
           return await handleGeminiRequest(__spreadProps(__spreadValues({}, req), { model: "gemini-2.5-flash" }), effectiveKey);
-        } catch (e) {
+        } catch (fErr) {
+          console.error("[LLM Gateway] Fallback gemini-2.5-flash failed:", fErr.message);
         }
       }
       if (provider !== "huggingface" && (process.env.HF_TOKEN || process.env.HUGGINGFACE_API_KEY)) {
         console.warn(`[LLM Gateway] Provider ${provider} rate limited (${error.message}). Falling back to Hugging Face (Qwen/Qwen2.5-Coder-32B-Instruct)...`);
         try {
           return await handleHuggingFaceChatRequest(__spreadProps(__spreadValues({}, req), { model: "Qwen/Qwen2.5-Coder-32B-Instruct" }), effectiveKey);
-        } catch (e) {
+        } catch (fErr) {
+          console.error("[LLM Gateway] Fallback HuggingFace Qwen failed:", fErr.message);
         }
       }
       if (provider !== "openai" && process.env.OPENAI_API_KEY) {
@@ -3393,12 +3401,13 @@ var OpenAIProvider = class {
       role: "system",
       content: buildSystemContent(basePrompt, context)
     };
+    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) : ""
+    }));
     const formattedMessages = [
       systemMessage,
-      ...messages.map((m) => ({
-        role: m.role,
-        content: m.content
-      }))
+      ...safeMessages
     ];
     const completion = await this.client.chat.completions.create({
       model: this.llmConfig.model,
@@ -3417,12 +3426,13 @@ var OpenAIProvider = class {
         role: "system",
         content: buildSystemContent(basePrompt, context)
       };
+      const safeStreamMessages = (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) : ""
+      }));
       const formattedMessages = [
         systemMessage,
-        ...messages.map((m) => ({
-          role: m.role,
-          content: m.content
-        }))
+        ...safeStreamMessages
       ];
       const stream = yield new __await(this.client.chat.completions.create({
         model: this.llmConfig.model,
@@ -3953,9 +3963,9 @@ var GeminiProvider = class {
    *   - Messages must strictly alternate between `user` and `model`.
    */
   buildGeminiContents(messages) {
-    return messages.filter((m) => m.role !== "system").map((m) => ({
+    return (messages || []).filter((m) => Boolean(m && typeof m === "object" && m.role !== "system")).map((m) => ({
       role: m.role === "assistant" ? "model" : "user",
-      parts: [{ text: m.content }]
+      parts: [{ text: typeof m.content === "string" ? m.content : m.content != null ? String(m.content) : "" }]
     }));
   }
   // -------------------------------------------------------------------------
@@ -4158,12 +4168,13 @@ var GroqProvider = class {
       role: "system",
       content: buildSystemContent(basePrompt, context)
     };
+    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) : ""
+    }));
     const formattedMessages = [
       systemMessage,
-      ...messages.map((m) => ({
-        role: m.role,
-        content: m.content
-      }))
+      ...safeMessages
     ];
     const completion = await this.client.chat.completions.create({
       model: this.llmConfig.model,
@@ -4182,12 +4193,13 @@ var GroqProvider = class {
         role: "system",
         content: buildSystemContent(basePrompt, context)
       };
+      const safeStreamMessages = (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) : ""
+      }));
       const formattedMessages = [
         systemMessage,
-        ...messages.map((m) => ({
-          role: m.role,
-          content: m.content
-        }))
+        ...safeStreamMessages
       ];
       const stream = yield new __await(this.client.chat.completions.create({
         model: this.llmConfig.model,
@@ -4316,12 +4328,13 @@ var QwenProvider = class {
       role: "system",
       content: buildSystemContent(basePrompt, context)
     };
+    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) : ""
+    }));
     const formattedMessages = [
       systemMessage,
-      ...messages.map((m) => ({
-        role: m.role,
-        content: m.content
-      }))
+      ...safeMessages
     ];
     const completion = await this.client.chat.completions.create({
       model: this.llmConfig.model,
@@ -4340,12 +4353,13 @@ var QwenProvider = class {
         role: "system",
         content: buildSystemContent(basePrompt, context)
       };
+      const safeStreamMessages = (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) : ""
+      }));
       const formattedMessages = [
         systemMessage,
-        ...messages.map((m) => ({
-          role: m.role,
-          content: m.content
-        }))
+        ...safeStreamMessages
       ];
       const stream = yield new __await(this.client.chat.completions.create({
         model: this.llmConfig.model,
@@ -4488,12 +4502,16 @@ var UniversalLLMAdapter = class {
   async chat(messages, context) {
     var _a2, _b, _c;
     const path2 = (_a2 = this.opts.chatPath) != null ? _a2 : "/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) : ""
+    }));
     const formattedMessages = [
       { role: "system", content: `${this.systemPrompt}
 
 Context:
 ${context != null ? context : "None"}` },
-      ...messages
+      ...safeMessages
     ];
     let payload;
     if (this.opts.chatPayloadTemplate) {
@@ -4565,12 +4583,16 @@ ${context != null ? context : "None"}` },
       const path2 = (_a2 = this.opts.chatPath) != null ? _a2 : "/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) => ({
+        role: m.role || "user",
+        content: typeof m.content === "string" ? m.content : m.content != null ? String(m.content) : ""
+      }));
       const formattedMessages = [
         { role: "system", content: `${this.systemPrompt}
 
 Context:
 ${context != null ? context : "None"}` },
-        ...messages
+        ...safeMessages
       ];
       let payload;
       if (this.opts.chatPayloadTemplate) {
@@ -6708,8 +6730,8 @@ var IntentClassifier = class {
   }
   // ─── Intent Heuristic Checkers ─────────────────────────────────────────────
   static isInformationLookup(query) {
-    if (/^(what|who|explain|define|where|when|why|how|how does|can|could|does|do|is|are|has|have|will|should|would|meaning of)\s+/i.test(query)) {
-      if (!/\b(compare|versus|vs\.?|trend|monthly|revenue|top selling|best)\b/i.test(query)) {
+    if (/^(what|who|explain|explore|define|where|when|why|how|how does|can|could|does|do|is|are|has|have|will|should|would|meaning of|tell me about|show details of|overview of|summarize)\s+/i.test(query)) {
+      if (!/\b(compare|versus|vs\.?|trend|monthly|revenue|top 10|top selling|best|chart|graph|plot|breakdown|analytics)\b/i.test(query)) {
         return true;
       }
     }
@@ -6746,7 +6768,7 @@ var Rule1SpecificInfoRule = class {
   }
   evaluate(context, intent) {
     const q = (context.userQuery || "").toLowerCase().trim();
-    const isFactQuery = intent === "information_lookup" || /^(what|who|explain|define|where|when|why|meaning of)\s+/i.test(q) || /^(what is the price of|price of|cost of)\b/i.test(q);
+    const isFactQuery = intent === "information_lookup" || /^(what|who|explain|explore|define|where|when|why|meaning of|tell me about|show details of|overview of|summarize)\s+/i.test(q) || /^(what is the price of|price of|cost of)\b/i.test(q);
     const isNonVisual = !/\b(compare|versus|vs\.?|trend|monthly|revenue|best|top 10|chart|table|list|grid)\b/i.test(q);
     if (isFactQuery && isNonVisual) {
       return {
@@ -8025,6 +8047,11 @@ ${schemaProfileText}` : ""}`;
   }
   static chooseAutomaticVisualization(data, profile, query) {
     if (profile.records.length === 0) return null;
+    const q = query.toLowerCase().trim();
+    const isExplicitVisualOrAnalytic = /\b(chart|graph|plot|visualize|trend|monthly|revenue|top\s*\d+|breakdown|analytics|compare|versus|vs\.?|histogram|pie|bar|line|distribution|percentage|share|summary of metrics)\b/i.test(q);
+    if (!isExplicitVisualOrAnalytic) {
+      return null;
+    }
     if (profile.dateFields.length > 0 && profile.numericFields.length > 0) {
       return this.transformToLineChart(profile);
     }
@@ -8140,6 +8167,7 @@ ${schemaProfileText}` : ""}`;
     return Array.from(categories);
   }
   static getProductCategory(item) {
+    if (!item) return null;
     const meta = item.metadata || {};
     const metadataCategory = resolveMetadataValue(meta, "category");
     if (this.isUsableCategory(metadataCategory)) return String(metadataCategory).trim();
@@ -8256,6 +8284,7 @@ ${schemaProfileText}` : ""}`;
       if (!fields.has(normalized)) fields.set(normalized, clean);
     };
     data.forEach((item) => {
+      if (!item) return;
       Object.keys(item.metadata || {}).forEach(addField);
       for (const match of (item.content || "").matchAll(/(?:^|\n)\s*([A-Za-z][A-Za-z0-9_ /-]{1,50})\s*[:\-–]\s*([^\n]+)/g)) {
         addField(match[1]);
@@ -8372,6 +8401,7 @@ ${schemaProfileText}` : ""}`;
     return true;
   }
   static extractStockQuantity(item) {
+    if (!item) return null;
     const meta = item.metadata || {};
     const stockValue = resolveMetadataValue(meta, "stock");
     const numericStock = this.toFiniteNumber(stockValue);
@@ -9632,7 +9662,10 @@ ${context}`;
 Focus on extracting the core intent and entities. Do not answer the question, just rewrite it.
 
 History:
-${history.map((m) => `${m.role}: ${m.content}`).join("\n")}
+${(history || []).map((m) => {
+      var _a2;
+      return `${(m == null ? void 0 : m.role) || "user"}: ${(_a2 = m == null ? void 0 : m.content) != null ? _a2 : ""}`;
+    }).join("\n")}
 
 New Question: ${question}
 
@@ -9656,8 +9689,11 @@ Optimized Search Query:`;
     const ns = formatNamespace(namespace != null ? namespace : this.config.projectId);
     try {
       const { sources } = await this.retrieve(query, { namespace: ns, topK: 5 });
-      if (sources.length === 0) return [];
-      const context = sources.map((s) => s.content).join("\n\n---\n\n");
+      if (!sources || sources.length === 0) return [];
+      const context = sources.map((s) => {
+        var _a2;
+        return (_a2 = s == null ? void 0 : s.content) != null ? _a2 : "";
+      }).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.
 Keep each question under 10 words and make them very specific to the content.

package/dist/index.js

@@ -1739,32 +1739,31 @@ function isLikelyUiOnlyMessage(text) {
 }
 function extractProductsFromSources(sources, isUser) {
   if (isUser || !sources) return [];
-  return sources.filter((s) => {
-    var _a;
+  return sources.filter((s) => Boolean(s && typeof s === "object")).filter((s) => {
+    var _a, _b;
     const m = (_a = s.metadata) != null ? _a : {};
     const keys = Object.keys(m).map((k) => k.toLowerCase());
     const hasStrongProductKey = keys.some(
       (k) => ["price", "image", "img", "thumbnail", "images", "product", "sku", "cost"].includes(k)
     );
     const hasProductIdentity = keys.some((k) => ["brand", "model"].includes(k)) && keys.some((k) => ["name", "title", "product_name", "product"].includes(k));
-    const hasPricePattern = /\$\s*\d+/.test(s.content);
+    const hasPricePattern = /\$\s*\d+/.test((_b = s == null ? void 0 : s.content) != null ? _b : "");
     return hasStrongProductKey || hasProductIdentity || hasPricePattern || m.type === "product";
   }).map((s) => {
-    var _a, _b, _c;
+    var _a, _b, _c, _d;
     const m = (_a = s.metadata) != null ? _a : {};
     const name = resolveMetadataValue(m, "name");
     const brand = resolveMetadataValue(m, "brand");
     const price = resolveMetadataValue(m, "price");
     const description = resolveMetadataValue(m, "description");
     return {
-      id: s.id,
-      name: (_c = name != null ? name : ((_b = s == null ? void 0 : s.content) != null ? _b : "").split("\n")[0]) != null ? _c : "Unknown Product",
+      id: (_b = s == null ? void 0 : s.id) != null ? _b : `prod_${Math.random().toString(36).substring(2, 8)}`,
+      name: (_d = name != null ? name : ((_c = s == null ? void 0 : s.content) != null ? _c : "").split("\n")[0]) != null ? _d : "Unknown Product",
       brand,
       price,
       image: resolveImage(m),
       link: resolveMetadataValue(m, "link"),
       description: description ? description : ""
-      //description ?? s.content,
     };
   });
 }
@@ -3142,10 +3141,10 @@ function ChatWindow({
                 ] })
               ] }),
               /* @__PURE__ */ (0, import_jsx_runtime13.jsxs)("div", { className: "flex items-center gap-1.5", children: [
-                /* @__PURE__ */ (0, import_jsx_runtime13.jsxs)("span", { className: "flex items-center gap-1 text-[10px] text-emerald-500 dark:text-emerald-400 mr-2", children: [
+                /* @__PURE__ */ (0, import_jsx_runtime13.jsx)("div", { className: "flex items-center gap-1.5 mr-2", children: /* @__PURE__ */ (0, import_jsx_runtime13.jsxs)("span", { className: "flex items-center gap-1 text-[10px] text-emerald-500 dark:text-emerald-400", children: [
                   /* @__PURE__ */ (0, import_jsx_runtime13.jsx)("span", { className: "w-1.5 h-1.5 rounded-full bg-emerald-500 dark:bg-emerald-400 animate-pulse" }),
                   "Online"
-                ] }),
+                ] }) }),
                 /* @__PURE__ */ (0, import_jsx_runtime13.jsxs)("div", { className: "flex items-center bg-slate-100/50 dark:bg-white/5 rounded-lg p-0.5 border border-slate-200/50 dark:border-white/5", children: [
                   mounted && messages.length > 0 && /* @__PURE__ */ (0, import_jsx_runtime13.jsx)(
                     "button",
@@ -3673,8 +3672,8 @@ var IntentClassifier = class {
   }
   // ─── Intent Heuristic Checkers ─────────────────────────────────────────────
   static isInformationLookup(query) {
-    if (/^(what|who|explain|define|where|when|why|how|how does|can|could|does|do|is|are|has|have|will|should|would|meaning of)\s+/i.test(query)) {
-      if (!/\b(compare|versus|vs\.?|trend|monthly|revenue|top selling|best)\b/i.test(query)) {
+    if (/^(what|who|explain|explore|define|where|when|why|how|how does|can|could|does|do|is|are|has|have|will|should|would|meaning of|tell me about|show details of|overview of|summarize)\s+/i.test(query)) {
+      if (!/\b(compare|versus|vs\.?|trend|monthly|revenue|top 10|top selling|best|chart|graph|plot|breakdown|analytics)\b/i.test(query)) {
         return true;
       }
     }
@@ -3711,7 +3710,7 @@ var Rule1SpecificInfoRule = class {
   }
   evaluate(context, intent) {
     const q = (context.userQuery || "").toLowerCase().trim();
-    const isFactQuery = intent === "information_lookup" || /^(what|who|explain|define|where|when|why|meaning of)\s+/i.test(q) || /^(what is the price of|price of|cost of)\b/i.test(q);
+    const isFactQuery = intent === "information_lookup" || /^(what|who|explain|explore|define|where|when|why|meaning of|tell me about|show details of|overview of|summarize)\s+/i.test(q) || /^(what is the price of|price of|cost of)\b/i.test(q);
     const isNonVisual = !/\b(compare|versus|vs\.?|trend|monthly|revenue|best|top 10|chart|table|list|grid)\b/i.test(q);
     if (isFactQuery && isNonVisual) {
       return {
@@ -4849,6 +4848,11 @@ ${schemaProfileText}` : ""}`;
   }
   static chooseAutomaticVisualization(data, profile, query) {
     if (profile.records.length === 0) return null;
+    const q = query.toLowerCase().trim();
+    const isExplicitVisualOrAnalytic = /\b(chart|graph|plot|visualize|trend|monthly|revenue|top\s*\d+|breakdown|analytics|compare|versus|vs\.?|histogram|pie|bar|line|distribution|percentage|share|summary of metrics)\b/i.test(q);
+    if (!isExplicitVisualOrAnalytic) {
+      return null;
+    }
     if (profile.dateFields.length > 0 && profile.numericFields.length > 0) {
       return this.transformToLineChart(profile);
     }
@@ -4964,6 +4968,7 @@ ${schemaProfileText}` : ""}`;
     return Array.from(categories);
   }
   static getProductCategory(item) {
+    if (!item) return null;
     const meta = item.metadata || {};
     const metadataCategory = resolveMetadataValue(meta, "category");
     if (this.isUsableCategory(metadataCategory)) return String(metadataCategory).trim();
@@ -5080,6 +5085,7 @@ ${schemaProfileText}` : ""}`;
       if (!fields.has(normalized)) fields.set(normalized, clean);
     };
     data.forEach((item) => {
+      if (!item) return;
       Object.keys(item.metadata || {}).forEach(addField);
       for (const match of (item.content || "").matchAll(/(?:^|\n)\s*([A-Za-z][A-Za-z0-9_ /-]{1,50})\s*[:\-–]\s*([^\n]+)/g)) {
         addField(match[1]);
@@ -5196,6 +5202,7 @@ ${schemaProfileText}` : ""}`;
     return true;
   }
   static extractStockQuantity(item) {
+    if (!item) return null;
     const meta = item.metadata || {};
     const stockValue = resolveMetadataValue(meta, "stock");
     const numericStock = this.toFiniteNumber(stockValue);