@retrivora-ai/rag-engine 2.3.2 → 2.3.4

package/dist/index.mjs

@@ -3049,7 +3049,7 @@ function useRagChat(projectId, options = {}) {
 // package.json
 var package_default = {
   name: "@retrivora-ai/rag-engine",
-  version: "2.3.2",
+  version: "2.3.4",
   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",
@@ -3438,14 +3438,15 @@ LicenseVerifier.CACHE_TTL_MS = 60 * 1e3;
 // Cache verified license for 60 seconds
 // Retrivora's Public Key used to verify the license key signature.
 // In production, this matches the private key held by Retrivora SaaS.
+// Rotate this key only when the signing private key is replaced.
 LicenseVerifier.PUBLIC_KEY = `-----BEGIN PUBLIC KEY-----
-MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEArMieCkCBtTfByRNOserm
-XM4T0Am29JyNzB4XQPe+WJJ56CN73H1HLXx9n1ByFcxkEJ9po+SURj5DnvUXwEy+
-xstx33wDPpVmcMQe33j5CRYS0S4gICiNqIRN7XkTlJtrcXqrmh1/hdOAwfRbjO1T
-NVtORHwUwWfI/lBLyxUPGtKPed+0fQ7NtcW4o00JXxs3EjCB5BV9CbnXoTjQb/4h
-iwZof4l8rb7oaNzOsVg0RSyxsETX7Ex5sI0CjBz1p2mYp4oVhw/A/h8Ls7H0XzjC
-+Eb6BLtsytt5JHoSp0jExLlCpDmpys2L+kETcBVx+IqiXtdN1n6KbkksvEDUVzLI
-MwIDAQAB
+MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAoOQlmDSKfCZaRy06rxwa
+chuDimlF134xTCitKDTPTPizF23oSn34pGDJakm/0T09JVUX8L/cvhGPe/3lf/g9
+4Y1q+Gb2KVM17KNGeT1Aj9Ua3BKz/yao/oFhi/r3Zt3cWY13B/Rd6clqY9WshIAV
+NqZNM8ilTl777cMbyym+6D+mzGXgmnJAO5brddIAI9FPLW0T3Znt8vEqDOIljEkC
+HCGHeirKABLbjKSJ4hljCa3vVitWqndhiq8CBSJG6HatiSGYotgMWGRY+0EbdlEv
+OJP4SqafQ3aD6YnL9q1n15QKwxu/uMK+JGM2VxxuyUi9GANtMIkCYy9xya73P4Qc
+gQIDAQAB
 -----END PUBLIC KEY-----`;
 
 // src/core/LicenseValidator.ts
@@ -4405,1958 +4406,6 @@ function CodeViewer({ snippet }) {
   ] });
 }
 
-// src/rendering/IntentClassifier.ts
-var IntentClassifier = class {
-  /**
-   * Fast, zero-latency classifier that maps a user query and optional data context
-   * into a high-level IntentCategory.
-   */
-  static classify(context) {
-    const q = (context.userQuery || "").toLowerCase().trim();
-    const signals = this.extractDataSignals(context);
-    if (this.isInformationLookup(q)) {
-      return { intent: "information_lookup", signals };
-    }
-    if (this.isComparisonQuery(q)) {
-      return { intent: "comparison", signals };
-    }
-    if (this.isProductQuery(q) || signals.isProductLike && this.isRecommendationQuery(q)) {
-      return { intent: "product_search", signals };
-    }
-    if (this.isTrendQuery(q) || signals.hasDateFields && signals.hasNumericFields && /\b(growth|trend|over time|monthly|yearly|weekly)\b/.test(q)) {
-      return { intent: "trend_analysis", signals };
-    }
-    if (this.isRankingQuery(q)) {
-      return { intent: "ranking", signals };
-    }
-    if (this.isAnalyticsQuery(q) || signals.hasNumericFields && signals.hasCategoricalFields && /\b(sales|revenue|performance|count|total|average|breakdown|share|percentage|correlation)\b/.test(q)) {
-      return { intent: "analytics", signals };
-    }
-    if (this.isRecommendationQuery(q)) {
-      return { intent: "recommendation", signals };
-    }
-    return { intent: "information_lookup", signals };
-  }
-  /**
-   * Extract key data structure signals from retrieved documents.
-   */
-  static extractDataSignals(context) {
-    const docs = context.retrievedDocuments || [];
-    const rowCount = docs.length;
-    let hasNumericFields = false;
-    let hasDateFields = false;
-    let hasCategoricalFields = false;
-    let isProductLike = false;
-    let numericFieldCount = 0;
-    let categoricalFieldCount = 0;
-    if (docs.length > 0) {
-      const keys = /* @__PURE__ */ new Set();
-      let numericKeys = /* @__PURE__ */ new Set();
-      let dateKeys = /* @__PURE__ */ new Set();
-      let catKeys = /* @__PURE__ */ new Set();
-      let productKeyMatches = 0;
-      docs.forEach((doc) => {
-        const meta = doc.metadata || {};
-        Object.entries(meta).forEach(([key, val]) => {
-          keys.add(key);
-          const kLower = key.toLowerCase();
-          if (["price", "image", "brand", "in_stock", "rating", "sku", "product"].some((p) => kLower.includes(p))) {
-            productKeyMatches++;
-          }
-          if (typeof val === "number") {
-            numericKeys.add(key);
-          } else if (typeof val === "string") {
-            if (/^\d{4}-\d{2}-\d{2}/.test(val) || !isNaN(Date.parse(val)) && val.length > 5) {
-              dateKeys.add(key);
-            } else if (val.length < 50 && !val.includes("\n")) {
-              catKeys.add(key);
-            }
-          }
-        });
-      });
-      hasNumericFields = numericKeys.size > 0;
-      hasDateFields = dateKeys.size > 0;
-      hasCategoricalFields = catKeys.size > 0;
-      numericFieldCount = numericKeys.size;
-      categoricalFieldCount = catKeys.size;
-      if (productKeyMatches >= 2 || docs.some((d) => {
-        var _a, _b;
-        return ((_a = d == null ? void 0 : d.content) != null ? _a : "").toLowerCase().includes("price") || ((_b = d == null ? void 0 : d.content) != null ? _b : "").toLowerCase().includes("brand");
-      })) {
-        isProductLike = true;
-      }
-    }
-    return {
-      rowCount,
-      hasNumericFields,
-      hasDateFields,
-      hasCategoricalFields,
-      isProductLike,
-      numericFieldCount,
-      categoricalFieldCount
-    };
-  }
-  // ─── Intent Heuristic Checkers ─────────────────────────────────────────────
-  static isInformationLookup(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;
-      }
-    }
-    if (/^(what is the )?(price|cost|fee|rate) of\b/i.test(query)) {
-      return true;
-    }
-    return false;
-  }
-  static isComparisonQuery(query) {
-    return /\b(compare|comparison|vs\.?|versus|difference between|differ|contrast|against)\b/i.test(query);
-  }
-  static isProductQuery(query) {
-    return /\b(best|recommend|top|buy|shopping|under \$|cheap|shoes|laptops|chairs|headphones|phone|sneakers|apparel|products)\b/i.test(query) && !/\b(compare|chart|sales|revenue|trend)\b/i.test(query);
-  }
-  static isRecommendationQuery(query) {
-    return /\b(recommend|suggest|what should i (buy|get|choose)|best options|top picks)\b/i.test(query);
-  }
-  static isTrendQuery(query) {
-    return /\b(trend|trends|growth|over time|historical|timeline|monthly|yearly|weekly|daily|revenue growth|sales growth)\b/i.test(query);
-  }
-  static isRankingQuery(query) {
-    return /\b(highest|lowest|top\s*\d+|bottom\s*\d+|rank|ranking|top performing|best performing)\b/i.test(query);
-  }
-  static isAnalyticsQuery(query) {
-    return /\b(sales|revenue|analytics|insights|distribution|percentage|share|breakdown|breakup|scatter|correlation|metrics|performance|by region|by category)\b/i.test(query);
-  }
-};
-
-// src/rendering/rules/Rule1SpecificInfoRule.ts
-var Rule1SpecificInfoRule = class {
-  constructor() {
-    this.name = "Rule1SpecificInfo";
-    this.priority = 100;
-  }
-  evaluate(context, intent) {
-    const q = (context.userQuery || "").toLowerCase().trim();
-    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 {
-        renderType: "text",
-        confidence: 0.95,
-        reason: "Rule 1: Specific information request (fact, explanation, or definition) requires plain text rendering."
-      };
-    }
-    return null;
-  }
-};
-
-// src/rendering/rules/Rule2ComparisonRule.ts
-var Rule2ComparisonRule = class {
-  constructor() {
-    this.name = "Rule2Comparison";
-    this.priority = 90;
-  }
-  evaluate(context, intent) {
-    const q = (context.userQuery || "").toLowerCase().trim();
-    const isComparison = intent === "comparison" || /\b(compare|comparison|vs\.?|versus|difference between|differ|contrast|against)\b/i.test(q);
-    if (isComparison) {
-      return {
-        renderType: "table",
-        confidence: 0.9,
-        reason: "Rule 2: Comparison query contrasting multiple entities requires structured table rendering."
-      };
-    }
-    return null;
-  }
-};
-
-// src/rendering/rules/Rule3ProductDiscoveryRule.ts
-var Rule3ProductDiscoveryRule = class {
-  constructor() {
-    this.name = "Rule3ProductDiscovery";
-    this.priority = 85;
-  }
-  evaluate(context, intent) {
-    const q = (context.userQuery || "").toLowerCase().trim();
-    const isDiscovery = intent === "product_search" || intent === "recommendation" || /\b(best|recommend|top|buy|shopping|under \$|cheap|shoes|laptops|chairs|headphones|sneakers|apparel|products|show available)\b/i.test(q);
-    const isNotChart = !/\b(chart|sales|revenue|monthly|growth|trend|over time)\b/i.test(q);
-    const isAnalyticalRanking = /\b(top performing|top selling|best performing|performing|sales|revenue|ranking)\b/i.test(q);
-    if (isDiscovery && isNotChart && !isAnalyticalRanking) {
-      return {
-        renderType: "carousel",
-        confidence: 0.9,
-        reason: "Rule 3: Product discovery/recommendation query requires product carousel rendering."
-      };
-    }
-    return null;
-  }
-};
-
-// src/rendering/rules/Rule4AnalyticalRule.ts
-var Rule4AnalyticalRule = class {
-  constructor() {
-    this.name = "Rule4Analytical";
-    this.priority = 80;
-  }
-  evaluate(context, intent) {
-    const q = (context.userQuery || "").toLowerCase().trim();
-    const isAnalytical = intent === "analytics" || intent === "trend_analysis" || intent === "ranking" || /\b(monthly sales|revenue growth|top performing|population trends|sales by|growth|distribution|share|percentage|breakdown|correlation|scatter|trend)\b/i.test(q);
-    if (!isAnalytical) return null;
-    let chartType = "bar";
-    if (intent === "trend_analysis" || /\b(monthly|yearly|weekly|growth|over time|trend|timeline|historical)\b/i.test(q)) {
-      chartType = "line";
-    } else if (/\b(share|percentage|percent|breakup|breakdown|composition|pie|donut|proportion)\b/i.test(q)) {
-      chartType = "pie";
-    } else if (/\b(correlation|scatter|relationship|relation|impact of|depends on)\b/i.test(q)) {
-      chartType = "scatter";
-    } else {
-      chartType = "bar";
-    }
-    return {
-      renderType: "chart",
-      chartType,
-      confidence: 0.85,
-      reason: `Rule 4: Analytical query with numerical insights selects ${chartType} chart.`
-    };
-  }
-};
-
-// src/rendering/rules/Rule5MixedResponseRule.ts
-var Rule5MixedResponseRule = class {
-  constructor() {
-    this.name = "Rule5MixedResponse";
-    this.priority = 95;
-  }
-  evaluate(context, _intent) {
-    const q = (context.userQuery || "").toLowerCase().trim();
-    const isTopSellingThisMonth = /\btop\s*(selling|performing)?\s*products?\s*(this|last)?\s*(month|year|week)\b/i.test(q);
-    const hasMultipleSectionsRequest = /\b(summary|overview)\b/i.test(q) && /\b(carousel|products?|items?)\b/i.test(q) && /\b(chart|sales|trend|revenue)\b/i.test(q);
-    if (isTopSellingThisMonth || hasMultipleSectionsRequest) {
-      return {
-        renderType: "mixed",
-        confidence: 0.95,
-        reason: "Rule 5: Mixed response query requires multi-section composition (text, carousel, chart).",
-        sections: [
-          { type: "text", title: "Summary" },
-          { type: "carousel", title: "Top Products" },
-          { type: "chart", chartType: "bar", title: "Sales Performance" }
-        ]
-      };
-    }
-    return null;
-  }
-};
-
-// src/rendering/rules/Rule6SmallResultSetRule.ts
-var Rule6SmallResultSetRule = class {
-  constructor() {
-    this.name = "Rule6SmallResultSet";
-    this.priority = 110;
-  }
-  evaluate(context, _intent) {
-    const docs = context.retrievedDocuments || [];
-    if (docs.length > 0 && docs.length < 3) {
-      const q = (context.userQuery || "").toLowerCase().trim();
-      const isExplicitComparison = /\b(compare|versus|vs\.?)\b/i.test(q);
-      return {
-        renderType: isExplicitComparison ? "table" : "text",
-        confidence: 0.98,
-        reason: `Rule 6: Small result set (${docs.length} rows < 3). Charts avoided to prevent sparse or uninformative visualizations.`
-      };
-    }
-    return null;
-  }
-};
-
-// src/rendering/rules/Rule7LargeTableRule.ts
-var Rule7LargeTableRule = class {
-  constructor() {
-    this.name = "Rule7LargeTable";
-    this.priority = 75;
-  }
-  evaluate(context, intent) {
-    const docs = context.retrievedDocuments || [];
-    if (docs.length > 5) {
-      const q = (context.userQuery || "").toLowerCase().trim();
-      const hasNumericAgg = intent === "analytics" || intent === "ranking" || /\b(sales|revenue|growth|count|total|average)\b/i.test(q);
-      if (hasNumericAgg) {
-        return {
-          renderType: "mixed",
-          confidence: 0.88,
-          reason: `Rule 7: Large result set (${docs.length} rows > 5) with numeric aggregation rendered as Table + Chart.`,
-          sections: [
-            { type: "table", title: "Detailed Data Table" },
-            { type: "chart", chartType: "bar", title: "Numerical Breakdown" }
-          ]
-        };
-      }
-      return {
-        renderType: "table",
-        confidence: 0.85,
-        reason: `Rule 7: Large result set (${docs.length} rows > 5) rendered as structured table for readability.`
-      };
-    }
-    return null;
-  }
-};
-
-// src/rendering/RuleEngine.ts
-var RuleEngine = class {
-  constructor() {
-    this.rules = [];
-    this.registerDefaultRules();
-  }
-  /**
-   * Register standard rules in priority order.
-   */
-  registerDefaultRules() {
-    this.registerRule(new Rule6SmallResultSetRule());
-    this.registerRule(new Rule1SpecificInfoRule());
-    this.registerRule(new Rule5MixedResponseRule());
-    this.registerRule(new Rule2ComparisonRule());
-    this.registerRule(new Rule3ProductDiscoveryRule());
-    this.registerRule(new Rule4AnalyticalRule());
-    this.registerRule(new Rule7LargeTableRule());
-  }
-  /**
-   * Add or replace a rule in the engine.
-   * Automatically keeps rules sorted by descending priority.
-   */
-  registerRule(rule) {
-    this.rules = this.rules.filter((r) => r.name !== rule.name);
-    this.rules.push(rule);
-    this.rules.sort((a, b) => b.priority - a.priority);
-  }
-  /**
-   * Evaluate context against rules in descending priority order.
-   * Returns the first non-null RenderDecision.
-   */
-  evaluate(context, intent) {
-    for (const rule of this.rules) {
-      const decision = rule.evaluate(context, intent);
-      if (decision) {
-        return decision;
-      }
-    }
-    return {
-      renderType: "text",
-      confidence: 0.7,
-      reason: "Default fallback: No specific visualization rule matched context."
-    };
-  }
-  /**
-   * List all registered rules.
-   */
-  getRegisteredRules() {
-    return this.rules.map((r) => ({ name: r.name, priority: r.priority }));
-  }
-};
-
-// src/rendering/VisualizationDecisionEngine.ts
-var LRUDecisionCache = class {
-  constructor(maxSize = 200) {
-    this.cache = /* @__PURE__ */ new Map();
-    this.maxSize = maxSize;
-  }
-  generateKey(context) {
-    var _a, _b;
-    const q = (context.userQuery || "").toLowerCase().trim();
-    const docCount = (_b = (_a = context.retrievedDocuments) == null ? void 0 : _a.length) != null ? _b : 0;
-    return `${q}::docs:${docCount}`;
-  }
-  get(context) {
-    const key = this.generateKey(context);
-    const item = this.cache.get(key);
-    if (item) {
-      this.cache.delete(key);
-      this.cache.set(key, item);
-      return item.decision;
-    }
-    return void 0;
-  }
-  set(context, decision) {
-    const key = this.generateKey(context);
-    if (this.cache.has(key)) {
-      this.cache.delete(key);
-    } else if (this.cache.size >= this.maxSize) {
-      const oldest = this.cache.keys().next().value;
-      if (oldest !== void 0) this.cache.delete(oldest);
-    }
-    this.cache.set(key, { decision, timestamp: Date.now() });
-  }
-  clear() {
-    this.cache.clear();
-  }
-  get size() {
-    return this.cache.size;
-  }
-};
-var VisualizationDecisionEngine = class {
-  /**
-   * Evaluate user query, documents, and context to produce a RenderDecision.
-   * Execution time is < 1ms for cached or rule-matched queries.
-   */
-  static decideVisualization(userQuery, retrievedDocuments, llmResponse, metadata) {
-    const context = {
-      userQuery,
-      retrievedDocuments,
-      llmResponse,
-      metadata
-    };
-    const cached = this.cache.get(context);
-    if (cached) {
-      return cached;
-    }
-    const { intent } = IntentClassifier.classify(context);
-    const decision = this.ruleEngine.evaluate(context, intent);
-    this.cache.set(context, decision);
-    return decision;
-  }
-  /**
-   * Convenience helper to decide AND render the data into a UITransformationResponse.
-   */
-  static render(userQuery, retrievedDocuments, llmResponse, metadata) {
-    const decision = this.decideVisualization(userQuery, retrievedDocuments, llmResponse, metadata);
-    const strategy = RendererRegistry.getStrategy(decision.renderType);
-    return strategy.render(retrievedDocuments || [], __spreadValues({
-      query: userQuery,
-      chartType: decision.chartType,
-      sections: decision.sections
-    }, metadata));
-  }
-  /**
-   * Register a custom rule in the rule engine.
-   */
-  static registerRule(rule) {
-    this.ruleEngine.registerRule(rule);
-    this.cache.clear();
-  }
-  /**
-   * Register a custom renderer strategy.
-   */
-  static registerRendererStrategy(strategy) {
-    RendererRegistry.registerStrategy(strategy);
-  }
-  /**
-   * Clear the decision cache.
-   */
-  static clearCache() {
-    this.cache.clear();
-  }
-  /**
-   * Get size of current decision cache.
-   */
-  static getCacheSize() {
-    return this.cache.size;
-  }
-};
-VisualizationDecisionEngine.ruleEngine = new RuleEngine();
-VisualizationDecisionEngine.cache = new LRUDecisionCache(200);
-function decideVisualization(userQuery, retrievedDocuments, llmResponse, metadata) {
-  return VisualizationDecisionEngine.decideVisualization(
-    userQuery,
-    retrievedDocuments,
-    llmResponse,
-    metadata
-  );
-}
-
-// src/utils/UITransformer.ts
-var UITransformer = class _UITransformer {
-  // ─── Public Entry Points ─────────────────────────────────────────────────
-  /**
-   * Heuristic-only transform (no LLM required).
-   * Uses the lightweight heuristic intent detector as a fallback.
-   * Prefer `analyzeAndDecide()` in production.
-   */
-  static transform(userQuery, retrievedData, config, trainedSchema, intent) {
-    var _a, _b, _c;
-    if (!retrievedData || retrievedData.length === 0) {
-      return this.createTextResponse("No data available", "No relevant data found for your query.");
-    }
-    const resolvedIntent = intent != null ? intent : this.detectIntentHeuristic(userQuery);
-    const filteredData = resolvedIntent.filterInStockOnly ? retrievedData.filter((item) => this.determineStockStatus(item)) : retrievedData;
-    const profile = this.profileData(filteredData);
-    const hasProducts = filteredData.some((item) => this.isProductData(item));
-    const wantsPieLikeChart = ["pie_chart", "donut_chart"].includes(resolvedIntent.recommendedChart);
-    if (resolvedIntent.visualizationHint === "trend" && profile.dateFields.length > 0 && profile.numericFields.length > 0) {
-      return this.transformToLineChart(profile);
-    }
-    if (wantsPieLikeChart || ["composition", "category_breakdown"].includes(resolvedIntent.visualizationHint)) {
-      const pieChart = this.transformToPieChart(filteredData, profile, userQuery);
-      if (pieChart) return pieChart;
-    }
-    if (["comparison", "ranking"].includes(resolvedIntent.visualizationHint)) {
-      return this.transformToBarChart(filteredData, profile, userQuery, resolvedIntent.visualizationHint === "ranking");
-    }
-    if (resolvedIntent.visualizationHint === "distribution") {
-      return (_a = this.transformToHistogram(profile, userQuery)) != null ? _a : this.transformToBarChart(filteredData, profile, userQuery);
-    }
-    if (resolvedIntent.visualizationHint === "correlation") {
-      return (_b = this.transformToScatterPlot(profile, userQuery)) != null ? _b : this.transformToBarChart(filteredData, profile, userQuery);
-    }
-    if (resolvedIntent.visualizationHint === "geographic") {
-      return this.transformToBarChart(filteredData, profile, userQuery);
-    }
-    if (this.isStructuredListQuery(userQuery)) {
-      return this.hasMultipleFields(filteredData) ? this.transformToTable(filteredData, userQuery) : this.transformToText(filteredData);
-    }
-    if (resolvedIntent.visualizationHint === "kpi") {
-      return (_c = this.transformToMetricCard(profile, userQuery)) != null ? _c : this.transformToText(filteredData);
-    }
-    if (["tabular", "table"].includes(resolvedIntent.visualizationHint) || resolvedIntent.wantsExplicitTable) {
-      return this.hasMultipleFields(filteredData) ? this.transformToTable(filteredData, userQuery) : this.transformToText(filteredData);
-    }
-    if ((hasProducts || this.isProductQuery(userQuery)) && resolvedIntent.visualizationHint === "product_browse") {
-      if (!this.isProductQuery(userQuery)) {
-        return this.transformToText(filteredData);
-      }
-      return this.transformToProductCarousel(filteredData, config, trainedSchema);
-    }
-    const automatic = this.chooseAutomaticVisualization(filteredData, profile, userQuery);
-    if (automatic) return automatic;
-    return this.transformToText(filteredData);
-  }
-  /**
-   * LLM-driven entry point (recommended for production).
-   *
-   * Step 1 — Detect intent via a dedicated, lightweight LLM call.
-   * Step 2 — Pass the intent + data to the visualization-selection prompt.
-   * Step 3 — Fall back to the heuristic `transform()` if either LLM call fails.
-   */
-  static async analyzeAndDecide(query, sources, llm) {
-    const decision = VisualizationDecisionEngine.decideVisualization(query, sources);
-    if (decision.renderType === "text") {
-      console.debug("[UITransformer] Decision Engine selected plain text rendering \u2014 skipping visual LLM calls.");
-      return this.transformToText(sources);
-    }
-    let intent;
-    try {
-      intent = await this.detectIntent(query, llm, sources);
-      console.debug("[UITransformer] Detected intent:", intent);
-    } catch (err) {
-      console.warn("[UITransformer] Intent detection failed; using heuristic.", err);
-      intent = this.detectIntentHeuristic(query);
-    }
-    if (this.isProductQuery(query) && ["text", "product_browse"].includes(intent.visualizationHint)) {
-      return this.transform(
-        query,
-        sources,
-        void 0,
-        void 0,
-        __spreadProps(__spreadValues({}, intent), { visualizationHint: "product_browse", recommendedChart: "text" })
-      );
-    }
-    try {
-      const context = this.buildContextSummary(sources);
-      const systemPrompt = this.buildVisualizationSystemPrompt();
-      const profile = this.profileData(sources);
-      const schemaContext = `
-RETRIEVED DATA SCHEMA:
-- Numeric fields (measures): ${profile.numericFields.map((f) => `${f.key} (unique values: ${f.uniqueCount})`).join(", ") || "None"}
-- Category fields (dimensions): ${profile.categoricalFields.map((f) => `${f.key} (unique values: ${f.uniqueCount})`).join(", ") || "None"}
-- Date fields (temporal): ${profile.dateFields.map((f) => `${f.key} (unique values: ${f.uniqueCount})`).join(", ") || "None"}
-- Boolean fields: ${profile.booleanFields.map((f) => `${f.key} (unique values: ${f.uniqueCount})`).join(", ") || "None"}
-- Text/Other fields: ${profile.fields.filter((f) => f.kind === "text").map((f) => f.key).join(", ") || "None"}
-`;
-      const userPrompt = [
-        `USER QUESTION: ${query}`,
-        "",
-        `DETECTED INTENT (JSON): ${JSON.stringify(intent)}`,
-        "",
-        `RETRIEVED DATA SCHEMA:`,
-        schemaContext,
-        "",
-        "RETRIEVED DATA (JSON):",
-        context
-      ].join("\n");
-      const rawResponse = await llm.chat(
-        [{ role: "user", content: userPrompt }],
-        "",
-        { systemPrompt, temperature: 0 }
-      );
-      const parsed = this.parseTransformationResponse(rawResponse);
-      if (parsed) {
-        let isCompatible = true;
-        if (parsed.type === "line_chart" && (profile.dateFields.length === 0 || profile.numericFields.length === 0)) {
-          isCompatible = false;
-        } else if (["bar_chart", "horizontal_bar", "pie_chart", "donut_chart"].includes(parsed.type) && (profile.categoricalFields.length === 0 && profile.numericFields.length === 0)) {
-          isCompatible = false;
-        } else if (parsed.type === "scatter_plot" && profile.numericFields.length < 2) {
-          isCompatible = false;
-        } else if (parsed.type === "metric_card" && profile.numericFields.length === 0) {
-          isCompatible = false;
-        }
-        if (!isCompatible) {
-          console.warn(`[UITransformer] LLM chose incompatible visualization type "${parsed.type}" for retrieved schema. Falling back to heuristic.`);
-          return this.transform(query, sources, void 0, void 0, intent);
-        }
-        const intentAllowsTable = intent.wantsExplicitTable || ["tabular", "table", "geographic"].includes(intent.visualizationHint);
-        const intentWantsPieLikeChart = ["pie_chart", "donut_chart"].includes(intent.recommendedChart) || ["composition", "category_breakdown"].includes(intent.visualizationHint);
-        if (parsed.type === "table" && !intentAllowsTable) {
-          console.debug("[UITransformer] LLM chose table but intent says no. Falling back to text.");
-          return this.transform(query, sources, void 0, void 0, intent);
-        }
-        if (intentWantsPieLikeChart && parsed.type !== "pie_chart" && this.detectCategories(sources).length > 1) {
-          console.debug("[UITransformer] LLM ignored pie/composition intent. Using deterministic pie chart.");
-          return this.transform(query, sources, void 0, void 0, intent);
-        }
-        console.debug("[UITransformer] LLM chose visualization type:", parsed.type);
-        return parsed;
-      }
-      console.warn("[UITransformer] LLM returned unparseable response; falling back to heuristic.");
-    } catch (err) {
-      console.warn("[UITransformer] analyzeAndDecide LLM call failed; falling back to heuristic.", err);
-    }
-    return this.transform(query, sources, void 0, void 0, intent);
-  }
-  // ─── Dynamic Intent Detection ─────────────────────────────────────────────
-  /**
-   * Calls the LLM with a compact, focused prompt to extract a structured
-   * `QueryIntent` from the user's query.
-   *
-   * Keeping this as a *separate* call from visualization selection means:
-   * - The prompt is shorter and more reliable.
-   * - The intent object can be reused across both the heuristic and LLM paths.
-   * - It is easy to unit-test intent detection in isolation.
-   */
-  static async detectIntent(query, llm, sources) {
-    let schemaProfileText = "";
-    if (sources && sources.length > 0) {
-      const profile = this.profileData(sources);
-      const hasProducts = sources.some((item) => this.isProductData(item));
-      schemaProfileText = `
-RETRIEVED DATA SCHEMA:
-- Numeric fields (measures): ${profile.numericFields.map((f) => `${f.key} (unique values: ${f.uniqueCount})`).join(", ") || "None"}
-- Category fields (dimensions): ${profile.categoricalFields.map((f) => `${f.key} (unique values: ${f.uniqueCount})`).join(", ") || "None"}
-- Date fields (temporal): ${profile.dateFields.map((f) => `${f.key} (unique values: ${f.uniqueCount})`).join(", ") || "None"}
-- Boolean fields: ${profile.booleanFields.map((f) => `${f.key} (unique values: ${f.uniqueCount})`).join(", ") || "None"}
-- Text fields: ${profile.fields.filter((f) => f.kind === "text").map((f) => f.key).join(", ") || "None"}
-
-Please choose visualizationHint and recommendedChart dynamically based on the available schema.
-- Do NOT recommend "trend" or "line_chart" if there are no Date fields.
-- Do NOT recommend numeric-dependent visualizations (like bar_chart, line_chart, pie_chart, scatter_plot, histogram, metric_card) if there are no Numeric fields. Fall back to tabular/table or text.
-- If there are multiple metadata fields but no clear categories or numbers, "tabular"/"table" is a highly accurate default.
-${hasProducts ? `- Note: The retrieved data matches product/catalog structure. If the user query is looking for, exploring, searching, browsing, or listing products/items, you MUST recommend visualizationHint: "product_browse" and recommendedChart: "text".` : ""}
-`;
-    }
-    const systemPrompt = `You are an intent classifier for a product-search RAG system.
-Given a user query, return ONLY a valid JSON object with this exact shape \u2014 no prose, no markdown:
-
-{
-  "visualizationHint": "trend" | "comparison" | "distribution" | "composition" | "correlation" | "ranking" | "kpi" | "tabular" | "geographic" | "product_browse" | "table" | "text",
-  "recommendedChart": "line_chart" | "bar_chart" | "histogram" | "pie_chart" | "donut_chart" | "scatter_plot" | "horizontal_bar" | "metric_card" | "table" | "geo_map" | "text",
-  "filterInStockOnly": boolean,
-  "wantsExplicitTable": boolean,
-  "isTemporal": boolean,
-  "isComparison": boolean,
-  "language": "<BCP-47 language tag, e.g. en, de, hi, ja>",
-  "reasoning": "<one short sentence \u2014 why you chose these values>"
-}
-
-RULES:
-- visualizationHint and recommendedChart
-    "trend"        \u2192 keywords: trend, growth, over time; recommendedChart "line_chart"
-    "comparison"   \u2192 keywords: compare, versus, top; recommendedChart "bar_chart"
-    "distribution" \u2192 keywords: distribution, spread; recommendedChart "histogram"
-    "composition"  \u2192 keywords: share, percentage, breakup, breakdown; recommendedChart "pie_chart" or "donut_chart"
-    "correlation"  \u2192 keywords: relation, correlation; recommendedChart "scatter_plot"
-    "ranking"      \u2192 keywords: highest, lowest, top 10, ranking; recommendedChart "horizontal_bar"
-    "kpi"          \u2192 keywords: total, average, count; recommendedChart "metric_card"
-    "tabular"      \u2192 keywords: detailed records, table, grid, spreadsheet; recommendedChart "table"
-    "geographic"   \u2192 keywords: region, country, map; recommendedChart "geo_map"
-    "product_browse" \u2192 user is browsing, searching, describing, viewing details for, or asking about one or more products without analytical visualization intent
-    "table"        \u2192 legacy alias for "tabular"; use only if the query literally says table
-    "text"         \u2192 conversational, factual, or other intent
-- If the user explicitly asks for a chart type, honor that chart type in recommendedChart.
-- If a query says "distribution ... in a pie chart", use visualizationHint "composition" and recommendedChart "pie_chart".
-- filterInStockOnly: true only if user mentions stock, availability, in stock, etc.
-- wantsExplicitTable: true if the user asks for a table, list, grid, spreadsheet, or detailed records.
-- isTemporal: true if time words appear (trend, historical, over time, last year, monthly, etc.)
-- isComparison: true if user compares, ranks, or contrasts entities or categories.
-- language: detect from the query text itself; default "en" if uncertain.`;
-    const userPrompt = `QUERY: ${query}${schemaProfileText ? `
-
-${schemaProfileText}` : ""}`;
-    const rawResponse = await llm.chat(
-      [{ role: "user", content: userPrompt }],
-      "",
-      { systemPrompt, temperature: 0 }
-    );
-    const parsed = this.parseIntentResponse(rawResponse);
-    if (!parsed) {
-      throw new Error(`Could not parse intent JSON from LLM response: ${rawResponse}`);
-    }
-    return parsed;
-  }
-  /**
-   * Parse and validate the raw LLM response into a `QueryIntent`.
-   */
-  static parseIntentResponse(raw) {
-    const jsonStr = this.extractJsonCandidate(raw);
-    if (!jsonStr) return null;
-    try {
-      const obj = JSON.parse(jsonStr);
-      const validHints = [
-        "trend",
-        "comparison",
-        "distribution",
-        "composition",
-        "correlation",
-        "ranking",
-        "kpi",
-        "tabular",
-        "geographic",
-        "category_breakdown",
-        "product_browse",
-        "table",
-        "text"
-      ];
-      const validCharts = [
-        "line_chart",
-        "bar_chart",
-        "histogram",
-        "pie_chart",
-        "donut_chart",
-        "scatter_plot",
-        "horizontal_bar",
-        "metric_card",
-        "table",
-        "geo_map",
-        "text"
-      ];
-      const hint = obj.visualizationHint;
-      if (!hint || !validHints.includes(hint)) return null;
-      const normalizedHint = hint === "category_breakdown" ? "composition" : hint;
-      const recommendedChart = typeof obj.recommendedChart === "string" && validCharts.includes(obj.recommendedChart) ? obj.recommendedChart : this.getRecommendedChartForIntent(normalizedHint);
-      return {
-        visualizationHint: normalizedHint,
-        recommendedChart,
-        filterInStockOnly: Boolean(obj.filterInStockOnly),
-        wantsExplicitTable: Boolean(obj.wantsExplicitTable),
-        isTemporal: Boolean(obj.isTemporal),
-        isComparison: Boolean(obj.isComparison),
-        language: typeof obj.language === "string" && obj.language ? obj.language : "en",
-        reasoning: typeof obj.reasoning === "string" ? obj.reasoning : void 0
-      };
-    } catch (e) {
-      return null;
-    }
-  }
-  /**
-   * Heuristic intent detector — used when the LLM is unavailable.
-   * Intentionally minimal: it should only catch the most obvious signals.
-   * The LLM path handles everything subtle.
-   */
-  static detectIntentHeuristic(query) {
-    const q = query.toLowerCase();
-    const isTemporal = /\b(trend|trends|over time|historical|history|growth|decline|monthly|yearly|weekly|daily|last (year|month|week)|timeline|forecast)\b/.test(q);
-    const isRanking = /\b(highest|lowest|top\s*\d+|bottom\s*\d+|rank(?:ing)?|best|worst|leading)\b/.test(q);
-    const isComparison = /\b(compare|comparison|vs\.?|versus|against|differ|difference|contrast|top)\b/.test(q) || isRanking;
-    const isDistribution = /\b(distribution|spread|histogram|frequency|variance|range)\b/.test(q);
-    const wantsPieLikeChart = /\b(pie|donut|doughnut)(?:\s+chart)?\b/.test(q);
-    const isComposition = wantsPieLikeChart || /\b(share|percentage|percent|breakup|breakdown|composition|split|segmentation|by category|by type|proportion)\b/.test(q);
-    const isCorrelation = /\b(relation|relationship|correlation|correlate|scatter|association|impact of|depend(?:s|ence)? on)\b/.test(q);
-    const isKpi = /\b(total|average|avg|count|sum|median|minimum|maximum|metric|kpi|how many|number of)\b/.test(q);
-    const isGeographic = /\b(region|country|countries|state|city|location|map|geo|geographic|territory)\b/.test(q);
-    const filterInStockOnly = /\b(in[- ]?stock|available|availability|inventory|stock status)\b/.test(q);
-    const wantsExplicitTable = /\b(table|spreadsheet|grid|detailed records|record details|list all|compare all)\b/.test(q);
-    let visualizationHint = "text";
-    if (wantsExplicitTable) visualizationHint = "tabular";
-    else if (isTemporal) visualizationHint = "trend";
-    else if (wantsPieLikeChart) visualizationHint = "composition";
-    else if (isRanking) visualizationHint = "ranking";
-    else if (isComparison) visualizationHint = "comparison";
-    else if (isDistribution) visualizationHint = "distribution";
-    else if (isComposition) visualizationHint = "composition";
-    else if (isCorrelation) visualizationHint = "correlation";
-    else if (isGeographic) visualizationHint = "geographic";
-    else if (isKpi) visualizationHint = "kpi";
-    else if (this.isProductQuery(query)) visualizationHint = "product_browse";
-    return {
-      visualizationHint,
-      recommendedChart: this.getRecommendedChartForIntent(visualizationHint),
-      filterInStockOnly,
-      wantsExplicitTable,
-      isTemporal,
-      isComparison,
-      language: "en"
-      // heuristic cannot reliably detect language
-    };
-  }
-  static getRecommendedChartForIntent(intent) {
-    switch (intent) {
-      case "trend":
-        return "line_chart";
-      case "comparison":
-        return "bar_chart";
-      case "distribution":
-        return "histogram";
-      case "composition":
-      case "category_breakdown":
-        return "pie_chart";
-      case "correlation":
-        return "scatter_plot";
-      case "ranking":
-        return "horizontal_bar";
-      case "kpi":
-        return "metric_card";
-      case "tabular":
-      case "table":
-        return "table";
-      case "geographic":
-        return "geo_map";
-      case "product_browse":
-      case "text":
-      default:
-        return "text";
-    }
-  }
-  // ─── Transform Helpers ────────────────────────────────────────────────────
-  static transformToProductCarousel(data, config, trainedSchema) {
-    const products = data.map((item) => this.extractProductInfo(item, config, trainedSchema)).filter((p) => p !== null);
-    return {
-      type: "product_carousel",
-      title: "Recommended Products",
-      description: `Found ${products.length} relevant products`,
-      data: products
-    };
-  }
-  static transformToPieChart(data, profile, query = "") {
-    var _a;
-    const dimension = profile ? this.selectDimensionField(profile, query) : void 0;
-    const categories = dimension ? Array.from(new Set(profile.records.map((record) => {
-      var _a2;
-      return String((_a2 = record.fields[dimension.key]) != null ? _a2 : "");
-    }).filter(Boolean))) : this.detectCategories(data);
-    if (categories.length === 0) return null;
-    const categoryData = dimension && profile ? this.aggregateProfileByDimension(profile, dimension.key) : this.aggregateByCategory(data, categories);
-    const pieData = Object.entries(categoryData).map(([label, count]) => {
-      const { inStockCount, outOfStockCount } = this.calculateStockCounts(label, data);
-      return { label, value: count, inStockCount, outOfStockCount };
-    });
-    return {
-      type: "pie_chart",
-      title: `Distribution by ${(_a = dimension == null ? void 0 : dimension.label) != null ? _a : "Category"}`,
-      description: `Showing breakdown across ${pieData.length} categories`,
-      data: pieData
-    };
-  }
-  static transformToLineChart(profile) {
-    const dateField = profile.dateFields[0];
-    const valueField = profile.numericFields[0];
-    const buckets = /* @__PURE__ */ new Map();
-    profile.records.forEach((record) => {
-      var _a, _b, _c;
-      const timestamp = String((_a = record.fields[dateField.key]) != null ? _a : "");
-      const value = (_b = this.toFiniteNumber(record.fields[valueField.key])) != null ? _b : 0;
-      buckets.set(timestamp, ((_c = buckets.get(timestamp)) != null ? _c : 0) + value);
-    });
-    const lineData = Array.from(buckets.entries()).sort(([a], [b]) => Date.parse(a) - Date.parse(b)).slice(0, 24).map(([timestamp, value]) => ({ timestamp, value, label: timestamp }));
-    return {
-      type: "line_chart",
-      title: `${valueField.label} Over Time`,
-      description: `Showing ${lineData.length} data points`,
-      data: lineData
-    };
-  }
-  static transformToBarChart(data, profile, query = "", horizontal = false) {
-    var _a;
-    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 _a2, _b, _c, _d, _e;
-      const meta = item.metadata || {};
-      const label = String(
-        (_c = (_b = (_a2 = this.getDynamicVal(meta, "name")) != null ? _a2 : 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 ? `${(_a = measure == null ? void 0 : measure.label) != null ? _a : "Count"} by ${dimension.label}` : "Comparison",
-      description: `Showing ${fallbackData.length} comparable values`,
-      data: fallbackData
-    };
-  }
-  static transformToHistogram(profile, query = "") {
-    const field = this.selectNumericField(profile, query);
-    if (!field) return null;
-    const values = profile.records.map((record) => this.toFiniteNumber(record.fields[field.key])).filter((value) => value !== null).sort((a, b) => a - b);
-    if (values.length === 0) return null;
-    const min = values[0];
-    const max = values[values.length - 1];
-    const bucketCount = Math.min(10, Math.max(3, Math.ceil(Math.sqrt(values.length))));
-    const width = max === min ? 1 : (max - min) / bucketCount;
-    const buckets = Array.from({ length: bucketCount }, (_, index) => {
-      const start = min + index * width;
-      const end = index === bucketCount - 1 ? max : start + width;
-      return { category: `${this.formatNumber(start)}-${this.formatNumber(end)}`, value: 0 };
-    });
-    values.forEach((value) => {
-      const bucketIndex = max === min ? 0 : Math.min(bucketCount - 1, Math.floor((value - min) / width));
-      buckets[bucketIndex].value += 1;
-    });
-    return {
-      type: "histogram",
-      title: `${field.label} Distribution`,
-      description: `Showing ${values.length} values across ${bucketCount} buckets`,
-      data: buckets
-    };
-  }
-  static transformToScatterPlot(profile, query = "") {
-    const fields = this.rankFieldsByQuery(profile.numericFields, query).slice(0, 2);
-    if (fields.length < 2) return null;
-    const [xField, yField] = fields;
-    const points = profile.records.map((record) => {
-      var _a;
-      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((_a = this.getRecordLabel(record)) != null ? _a : record.id) };
-    }).filter((point) => point !== null).slice(0, 100);
-    if (points.length === 0) return null;
-    return {
-      type: "scatter_plot",
-      title: `${xField.label} vs ${yField.label}`,
-      description: `Showing ${points.length} paired values`,
-      data: points
-    };
-  }
-  static transformToMetricCard(profile, query = "") {
-    const operation = this.detectAggregationOperation(query);
-    const numericField = this.selectNumericField(profile, query);
-    const values = numericField ? profile.records.map((record) => this.toFiniteNumber(record.fields[numericField.key])).filter((value2) => value2 !== null) : [];
-    const value = operation === "count" || values.length === 0 ? profile.records.length : this.calculateAggregate(values, operation);
-    const metric = {
-      label: numericField ? `${operation} ${numericField.label}` : "Count",
-      value,
-      operation
-    };
-    return {
-      type: "metric_card",
-      title: metric.label,
-      description: `Calculated from ${profile.records.length} result${profile.records.length === 1 ? "" : "s"}`,
-      data: metric
-    };
-  }
-  static transformToRadarChart(data) {
-    const attributeMap = {};
-    data.forEach((item) => {
-      var _a, _b, _c;
-      const meta = item.metadata || {};
-      const seriesName = String((_c = (_b = (_a = meta.name) != null ? _a : 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] = {};
-          attributeMap[key][seriesName] = val;
-        }
-      });
-    });
-    const radarData = Object.entries(attributeMap).map(([attribute, series]) => __spreadValues({
-      attribute
-    }, series));
-    return {
-      type: "radar_chart",
-      title: "Product Comparison",
-      description: `Comparing ${data.length} items across ${radarData.length} attributes`,
-      data: radarData.length > 0 ? radarData : data.map((d) => {
-        var _a;
-        return { attribute: ((_a = d == null ? void 0 : d.content) != null ? _a : "").substring(0, 40) };
-      })
-    };
-  }
-  static transformToTable(data, query = "") {
-    const columns = this.extractTableColumns(data, query);
-    const rows = data.map((item) => this.extractTableRow(item, columns));
-    const tableData = { columns, rows };
-    return {
-      type: "table",
-      title: "Detailed Results",
-      description: `Showing ${data.length} results`,
-      data: tableData
-    };
-  }
-  static transformToText(data) {
-    return this.createTextResponse(
-      "Retrieved Context",
-      data.map((item) => {
-        var _a;
-        return (_a = item == null ? void 0 : item.content) != null ? _a : "";
-      }).join("\n\n"),
-      `Found ${data.length} relevant results`
-    );
-  }
-  static createTextResponse(title, content, description) {
-    return { type: "text", title, description, data: { content } };
-  }
-  // ─── LLM Response Parsing ─────────────────────────────────────────────────
-  static parseTransformationResponse(raw) {
-    const payloadText = this.extractJsonCandidate(raw);
-    if (!payloadText) return null;
-    try {
-      const parsed = JSON.parse(payloadText);
-      return this.normalizeTransformation(parsed);
-    } catch (e) {
-      return null;
-    }
-  }
-  static extractJsonCandidate(raw) {
-    if (!raw) return null;
-    const cleaned = raw.replace(/```(?:json|chart|ui)?\s*/gi, "").replace(/```/g, "").trim();
-    const start = cleaned.indexOf("{");
-    if (start === -1) return null;
-    let depth = 0;
-    let inString = false;
-    let escape = false;
-    for (let i = start; i < cleaned.length; i += 1) {
-      const char = cleaned[i];
-      if (escape) {
-        escape = false;
-        continue;
-      }
-      if (char === "\\") {
-        escape = true;
-        continue;
-      }
-      if (char === '"') {
-        inString = !inString;
-        continue;
-      }
-      if (inString) continue;
-      if (char === "{") depth += 1;
-      if (char === "}") {
-        depth -= 1;
-        if (depth === 0) return cleaned.slice(start, i + 1);
-      }
-    }
-    return null;
-  }
-  static normalizeTransformation(payload) {
-    var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j;
-    if (!payload || typeof payload !== "object") return null;
-    const p = payload;
-    const type = this.normalizeVisualizationType(
-      String((_c = (_b = (_a = p.type) != null ? _a : 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");
-    const description = p.description ? String(p.description) : void 0;
-    const rawData = (_j = (_i = (_h = (_g = (_f = p.data) != null ? _f : p.table) != null ? _g : p.rows) != null ? _h : p.items) != null ? _i : p.content) != null ? _j : null;
-    const data = type === "text" && typeof rawData === "string" ? { content: rawData } : rawData;
-    const transformation = { type, title, description, data };
-    return this.validateTransformation(transformation) ? transformation : null;
-  }
-  static normalizeVisualizationType(type) {
-    var _a;
-    const mapping = {
-      pie: "pie_chart",
-      pie_chart: "pie_chart",
-      bar: "bar_chart",
-      bar_chart: "bar_chart",
-      histogram: "histogram",
-      horizontal_bar: "horizontal_bar",
-      horizontalbar: "horizontal_bar",
-      line: "line_chart",
-      line_chart: "line_chart",
-      scatter: "scatter_plot",
-      scatter_plot: "scatter_plot",
-      scatterplot: "scatter_plot",
-      radar: "radar_chart",
-      radar_chart: "radar_chart",
-      metric: "metric_card",
-      metric_card: "metric_card",
-      card: "metric_card",
-      kpi: "metric_card",
-      geo: "geo_map",
-      geo_map: "geo_map",
-      map: "geo_map",
-      table: "table",
-      text: "text",
-      product_carousel: "product_carousel",
-      carousel: "carousel"
-    };
-    return (_a = mapping[type.toLowerCase()]) != null ? _a : null;
-  }
-  static validateTransformation(t) {
-    const { type, data } = t;
-    switch (type) {
-      case "pie_chart":
-      case "bar_chart":
-      case "histogram":
-      case "horizontal_bar":
-        return Array.isArray(data) && data.every(
-          (i) => i !== null && typeof i === "object" && (typeof i.value === "number" || !Number.isNaN(Number(i.value)))
-        );
-      case "scatter_plot":
-        return Array.isArray(data) && data.every(
-          (i) => i !== null && typeof i === "object" && (typeof i.x === "number" || !Number.isNaN(Number(i.x))) && (typeof i.y === "number" || !Number.isNaN(Number(i.y)))
-        );
-      case "line_chart":
-        return Array.isArray(data) && data.every(
-          (i) => i !== null && typeof i === "object" && "timestamp" in i && (typeof i.value === "number" || !Number.isNaN(Number(i.value)))
-        );
-      case "metric_card":
-        return typeof data === "object" && data !== null && (typeof data.value === "number" || !Number.isNaN(Number(data.value)));
-      case "geo_map":
-        return Array.isArray(data) || typeof data === "object" && data !== null;
-      case "radar_chart":
-        return Array.isArray(data) && data.every(
-          (i) => i !== null && typeof i === "object" && "attribute" in i
-        );
-      case "table":
-        return typeof data === "object" && data !== null && Array.isArray(data.columns) && Array.isArray(data.rows);
-      case "text":
-        return typeof data === "object" && data !== null && typeof data.content === "string";
-      case "product_carousel":
-      case "carousel":
-        return Array.isArray(data) && data.every(
-          (i) => i !== null && typeof i === "object" && ("id" in i || "name" in i)
-        );
-      default:
-        return false;
-    }
-  }
-  // ─── Data Inspection Helpers ──────────────────────────────────────────────
-  static isStructuredListQuery(query) {
-    const q = query.toLowerCase();
-    const asksForRecords = /\b(list|provide|show|give|get|find|which|whose|records?|details?)\b/.test(q);
-    const hasNumericPredicate = /\b(greater than|more than|above|over|less than|below|under|at least|at most|minimum|maximum|>=|<=|>|<|equals?|equal to)\b\s*\$?\d/i.test(q) || /\b\d+\b\s*(?:or more|or less|and above|and below)\b/i.test(q);
-    const hasEntityTerms = /\b(organization|organisations?|organizations?|company|companies|employee|employees|staff|headcount|workforce)\b/.test(q);
-    return asksForRecords && (hasNumericPredicate || hasEntityTerms);
-  }
-  /** @internal kept private for transform() internal logic */
-  static isProductQuery(query) {
-    return _UITransformer._productQueryTest(query);
-  }
-  /**
-   * Public entry-point for external callers (e.g. Pipeline)
-   * to check whether a query maps to product_browse without triggering an LLM call.
-   */
-  static isProductQueryPublic(query) {
-    return _UITransformer._productQueryTest(query);
-  }
-  static _productQueryTest(query) {
-    const q = query.toLowerCase();
-    const productTerms = /\b(product|products|item|items|sku|catalog|catalogue|price|prices|brand|model|stock|inventory|in stock|out of stock|buy|shop)\b/.test(q);
-    const productAction = /\b(recommend|suggest|describe|description|detail|details|about|show|find|search|browse|list|explore|exploring)\b/.test(q);
-    const nonProductEntityTerms = /\b(organization|organisations?|organizations?|company|companies|employee|employees|staff|headcount|workforce)\b/.test(q);
-    return productTerms && productAction && !nonProductEntityTerms;
-  }
-  static isProductData(item) {
-    if (!item) return false;
-    const content = (item.content || "").toLowerCase();
-    const productKeywords = [
-      "product",
-      "price",
-      "stock",
-      "sku",
-      "brand",
-      "msrp",
-      "inventory",
-      "buy",
-      "shop",
-      "beauty",
-      "cosmetic",
-      "facial",
-      "cream",
-      "serum",
-      "mask",
-      "makeup",
-      "fragrance"
-    ];
-    const hasKeywords = productKeywords.some((kw) => content.includes(kw));
-    const metadata = item.metadata || {};
-    const hasMetadataKey = Object.keys(metadata).some((k) => {
-      const val = metadata[k];
-      return ["price", "product", "sku", "brand", "cost"].includes(k.toLowerCase()) && val !== null && val !== void 0 && val !== "";
-    });
-    const hasPricePattern = /\$\s*\d+\.\d{2}/.test(content);
-    return hasKeywords || hasMetadataKey || hasPricePattern;
-  }
-  static isTimeSeriesData(item) {
-    const metadata = item.metadata || {};
-    const maybeDateKeys = Object.keys(metadata).filter(
-      (k) => ["date", "timestamp", "time", "period"].includes(k.toLowerCase())
-    );
-    return maybeDateKeys.some((key) => {
-      const value = metadata[key];
-      if (typeof value === "string") return !Number.isNaN(Date.parse(value)) && value.trim().length > 0;
-      return typeof value === "number";
-    });
-  }
-  static hasMultipleFields(data) {
-    const fieldCount = /* @__PURE__ */ new Set();
-    data.forEach((item) => Object.keys(item.metadata || {}).forEach((k) => fieldCount.add(k)));
-    return fieldCount.size > 2;
-  }
-  static profileData(data) {
-    const records = (data || []).filter((item) => Boolean(item && typeof item === "object")).map((item) => {
-      var _a, _b;
-      const fields2 = {};
-      Object.entries(item.metadata || {}).forEach(([key, value]) => {
-        const primitive = this.toPrimitive(value);
-        if (primitive !== null) fields2[key] = primitive;
-      });
-      if (!fields2.content && item.content) fields2.content = item.content.substring(0, 500);
-      return {
-        id: item.id,
-        content: (_a = item.content) != null ? _a : "",
-        score: (_b = item.score) != null ? _b : 0,
-        fields: fields2,
-        source: item
-      };
-    });
-    const keys = Array.from(new Set(records.flatMap((record) => Object.keys(record.fields))));
-    const fields = keys.map((key) => {
-      const values = records.map((record) => record.fields[key]).filter((value) => value !== void 0 && value !== null && String(value).trim() !== "");
-      const uniqueCount = new Set(values.map((value) => String(value).toLowerCase())).size;
-      return {
-        key,
-        label: this.humanizeFieldName(key),
-        kind: this.inferFieldKind(key, values, records.length, uniqueCount),
-        values,
-        uniqueCount
-      };
-    });
-    return {
-      records,
-      fields,
-      numericFields: fields.filter((field) => field.kind === "number"),
-      dateFields: fields.filter((field) => field.kind === "date"),
-      categoricalFields: fields.filter((field) => field.kind === "category"),
-      booleanFields: fields.filter((field) => field.kind === "boolean")
-    };
-  }
-  static toPrimitive(value) {
-    if (typeof value === "string" || typeof value === "number" || typeof value === "boolean") return value;
-    if (value === null || value === void 0) return null;
-    if (value instanceof Date) return value.toISOString();
-    return null;
-  }
-  static inferFieldKind(key, values, rowCount, uniqueCount) {
-    const lowerKey = key.toLowerCase();
-    if (values.length === 0) return "text";
-    if (values.every((value) => typeof value === "boolean" || /^(true|false|yes|no|in_stock|out_of_stock|available|unavailable)$/i.test(String(value)))) {
-      return "boolean";
-    }
-    if (/(date|time|timestamp|created|updated|month|year|period)/i.test(lowerKey) && values.some((value) => this.isDateLike(value))) {
-      return "date";
-    }
-    const numericCount = values.filter((value) => this.toFiniteNumber(value) !== null).length;
-    if (numericCount / values.length >= 0.85 && !/(id|sku|ean|upc|zip|postal|phone|code)/i.test(lowerKey)) {
-      return "number";
-    }
-    if (uniqueCount <= Math.max(20, Math.ceil(rowCount * 0.7)) && !/(id|sku|ean|upc|description|content|url|image|thumbnail)/i.test(lowerKey)) {
-      return "category";
-    }
-    return "text";
-  }
-  static isDateLike(value) {
-    if (typeof value === "number") return value > 1900 && value < 3e3;
-    const text = String(value).trim();
-    return text.length > 3 && !Number.isNaN(Date.parse(text));
-  }
-  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);
-    }
-    if (profile.categoricalFields.length > 0 && profile.numericFields.length > 0) {
-      return this.transformToBarChart(data, profile, query);
-    }
-    if (profile.categoricalFields.length > 0) {
-      return this.transformToPieChart(data, profile, query);
-    }
-    if (profile.numericFields.length >= 2) {
-      return this.transformToScatterPlot(profile, query);
-    }
-    if (profile.numericFields.length === 1) {
-      return this.transformToMetricCard(profile, query);
-    }
-    return null;
-  }
-  static selectDimensionField(profile, query) {
-    var _a, _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 = (_a = ranked[0]) != null ? _a : productCategory) != null ? _b : profile.categoricalFields[0];
-  }
-  static selectNumericField(profile, query) {
-    var _a;
-    return (_a = this.rankFieldsByQuery(profile.numericFields, query)[0]) != null ? _a : profile.numericFields[0];
-  }
-  static rankFieldsByQuery(fields, query) {
-    const q = query.toLowerCase();
-    return [...fields].sort((a, b) => this.fieldScore(b, q) - this.fieldScore(a, q));
-  }
-  static fieldScore(field, query) {
-    const key = field.key.toLowerCase();
-    const label = field.label.toLowerCase();
-    let score = 0;
-    if (query.includes(key)) score += 4;
-    if (query.includes(label)) score += 4;
-    key.split(/[_\s-]+/).forEach((part) => {
-      if (part && query.includes(part)) score += 1;
-    });
-    if (/category|department|collection|type|group|segment/.test(key)) score += 2;
-    if (/count|total|quantity|stock|inventory|sales|revenue|amount|price|value|score/.test(key)) score += 2;
-    if (/id|sku|ean|upc|code/.test(key)) score -= 5;
-    return score;
-  }
-  static normalizeComparableField(field) {
-    return field.toLowerCase().replace(/&/g, "and").replace(/[^a-z0-9]+/g, "").trim();
-  }
-  static fieldTokens(field) {
-    return field.toLowerCase().replace(/[_-]+/g, " ").split(/\s+/).map((token) => token.replace(/[^a-z0-9]/g, "")).filter(Boolean);
-  }
-  static aggregateProfileByDimension(profile, dimensionKey, measureKey) {
-    const result = {};
-    profile.records.forEach((record) => {
-      var _a, _b, _c;
-      const category = String((_a = record.fields[dimensionKey]) != null ? _a : "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;
-    });
-    return result;
-  }
-  static getRecordLabel(record) {
-    const labelKeys = ["name", "title", "label", "product", "item", "brand"];
-    const key = Object.keys(record.fields).find(
-      (fieldKey) => labelKeys.some((labelKey) => fieldKey.toLowerCase().includes(labelKey))
-    );
-    return key ? record.fields[key] : void 0;
-  }
-  static detectAggregationOperation(query) {
-    const q = query.toLowerCase();
-    if (/\b(avg|average|mean)\b/.test(q)) return "average";
-    if (/\b(count|how many|number of)\b/.test(q)) return "count";
-    if (/\b(min|minimum|lowest)\b/.test(q)) return "min";
-    if (/\b(max|maximum|highest)\b/.test(q)) return "max";
-    if (/\bmedian\b/.test(q)) return "median";
-    return "sum";
-  }
-  static calculateAggregate(values, operation) {
-    if (values.length === 0) return 0;
-    switch (operation) {
-      case "average":
-        return values.reduce((sum, value) => sum + value, 0) / values.length;
-      case "count":
-        return values.length;
-      case "min":
-        return Math.min(...values);
-      case "max":
-        return Math.max(...values);
-      case "median": {
-        const sorted = [...values].sort((a, b) => a - b);
-        const middle = Math.floor(sorted.length / 2);
-        return sorted.length % 2 === 0 ? (sorted[middle - 1] + sorted[middle]) / 2 : sorted[middle];
-      }
-      case "sum":
-      default:
-        return values.reduce((sum, value) => sum + value, 0);
-    }
-  }
-  static humanizeFieldName(key) {
-    return key.replace(/[_-]+/g, " ").replace(/([a-z])([A-Z])/g, "$1 $2").replace(/\s+/g, " ").trim().replace(/\b\w/g, (char) => char.toUpperCase());
-  }
-  static formatNumber(value) {
-    return Number.isInteger(value) ? String(value) : value.toFixed(1);
-  }
-  static detectCategories(data) {
-    const categories = /* @__PURE__ */ new Set();
-    data.forEach((item) => {
-      const category = this.getProductCategory(item);
-      if (category) categories.add(category);
-    });
-    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();
-    const content = item.content || "";
-    const explicitCategoryMatch = content.match(
-      /(?:^|\n)\s*(?:product\s*)?(?:category|department|collection)\s*[:\-–]\s*([^\n]+)/i
-    );
-    if (explicitCategoryMatch && this.isUsableCategory(explicitCategoryMatch[1])) {
-      return explicitCategoryMatch[1].trim();
-    }
-    return null;
-  }
-  static isUsableCategory(value) {
-    if (value === null || value === void 0) return false;
-    const category = String(value).trim();
-    if (!category) return false;
-    return !/^(category|type|tag|price|cost|stock|availability|description|product|item|name|brand|sku|id|ean|currency|color|size|index|internal id|other|\[?type\]?|\[?products?_?\d*\]?)$/i.test(category);
-  }
-  static aggregateByCategory(data, categories) {
-    const result = Object.fromEntries(categories.map((c) => [c, 0]));
-    data.forEach((item) => {
-      var _a;
-      const cat = (_a = this.getProductCategory(item)) != null ? _a : "Other";
-      if (Object.prototype.hasOwnProperty.call(result, cat)) result[cat]++;
-      else result["Other"] = (result["Other"] || 0) + 1;
-    });
-    return result;
-  }
-  static extractTimeSeriesData(data) {
-    return data.map((item) => {
-      var _a, _b, _c, _d, _e, _f;
-      const meta = item.metadata || {};
-      return {
-        timestamp: (_b = (_a = meta.timestamp) != null ? _a : 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 _a;
-    const preferredKeys = [
-      "value",
-      "count",
-      "total",
-      "average",
-      "avg",
-      "amount",
-      "sales",
-      "revenue",
-      "score",
-      "quantity",
-      "price"
-    ];
-    for (const key of preferredKeys) {
-      const raw = (_a = resolveMetadataValue(meta, key)) != null ? _a : meta[key];
-      const value = typeof raw === "number" ? raw : Number(String(raw != null ? raw : "").replace(/[$,% ,]/g, ""));
-      if (Number.isFinite(value)) return value;
-    }
-    for (const value of Object.values(meta)) {
-      const numeric = typeof value === "number" ? value : Number(String(value != null ? value : "").replace(/[$,% ,]/g, ""));
-      if (Number.isFinite(numeric)) return numeric;
-    }
-    return null;
-  }
-  static extractTableColumns(data, query = "") {
-    const q = query.toLowerCase();
-    const availableFields = this.extractAvailableTableFields(data);
-    if (/\b(organization|organisations?|organizations?|company|companies)\b/.test(q) && /\b(employee|employees|staff|headcount|workforce)\b/.test(q)) {
-      const nameField = this.pickTableField(availableFields, [
-        "company name",
-        "organization name",
-        "organisation name",
-        "name",
-        "company",
-        "organization",
-        "organisation"
-      ]);
-      const employeeField = this.pickTableField(availableFields, [
-        "number of employees",
-        "employee count",
-        "employees",
-        "employee_count",
-        "number_employees",
-        "num employees",
-        "staff count",
-        "headcount",
-        "workforce"
-      ]);
-      const columns = [nameField, employeeField].filter((field) => Boolean(field));
-      if (columns.length > 0) return columns;
-    }
-    const requestedFields = availableFields.map((field) => ({
-      field,
-      score: this.tableFieldQueryScore(field, q)
-    })).filter((item) => item.score > 0).sort((a, b) => b.score - a.score).map((item) => item.field);
-    if (requestedFields.length > 0) {
-      return requestedFields.slice(0, Math.min(6, requestedFields.length));
-    }
-    const metadataFields = Array.from(new Set(
-      data.flatMap((item) => Object.keys(item.metadata || {}).map((k) => this.humanizeFieldName(k)))
-    ));
-    return metadataFields.length > 0 ? metadataFields : ["Content"];
-  }
-  static extractTableRow(item, columns) {
-    return columns.map((col) => this.resolveTableCellValue(item, col));
-  }
-  static extractAvailableTableFields(data) {
-    const fields = /* @__PURE__ */ new Map();
-    const addField = (field) => {
-      const clean = this.humanizeFieldName(field);
-      if (!clean || /^(content|\[?type\]?)$/i.test(clean)) return;
-      const normalized = this.normalizeComparableField(clean);
-      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]);
-      }
-    });
-    return Array.from(fields.values());
-  }
-  static pickTableField(fields, aliases) {
-    const normalizedAliases = aliases.map((alias) => this.normalizeComparableField(alias));
-    for (const alias of normalizedAliases) {
-      const exact = fields.find((field) => this.normalizeComparableField(field) === alias);
-      if (exact) return exact;
-    }
-    for (const alias of normalizedAliases) {
-      const fuzzy = fields.find((field) => {
-        const normalizedField = this.normalizeComparableField(field);
-        if (/(id|code|uuid)$/.test(normalizedField) && !/(id|code|uuid)$/.test(alias)) return false;
-        return normalizedField.includes(alias) || alias.includes(normalizedField);
-      });
-      if (fuzzy) return fuzzy;
-    }
-    return void 0;
-  }
-  static tableFieldQueryScore(field, query) {
-    const normalizedField = this.normalizeComparableField(field);
-    if (!normalizedField) return 0;
-    const fieldTokens = this.fieldTokens(field);
-    return fieldTokens.reduce((score, token) => {
-      if (token.length < 3) return score;
-      return query.includes(token) ? score + 1 : score;
-    }, query.includes(normalizedField) ? 3 : 0);
-  }
-  static resolveTableCellValue(item, column) {
-    var _a, _b, _c;
-    if (column === "Content") return ((_a = item == null ? void 0 : item.content) != null ? _a : "").substring(0, 100);
-    const meta = item.metadata || {};
-    const normalizedColumn = this.normalizeComparableField(column);
-    const exactMetadata = Object.entries(meta).find(
-      ([key]) => this.normalizeComparableField(key) === normalizedColumn || this.normalizeComparableField(this.humanizeFieldName(key)) === normalizedColumn
-    );
-    if (exactMetadata && exactMetadata[1] !== void 0 && exactMetadata[1] !== null) {
-      return this.toDisplayValue(exactMetadata[1]);
-    }
-    const aliasValue = this.resolveAliasedTableCell(meta, column);
-    if (aliasValue !== void 0) return this.toDisplayValue(aliasValue);
-    const contentValue = this.extractContentFieldValue((_b = item == null ? void 0 : item.content) != null ? _b : "", column);
-    if (contentValue !== null) return contentValue;
-    const aliasContentValue = this.extractAliasedContentFieldValue((_c = item == null ? void 0 : item.content) != null ? _c : "", column);
-    return aliasContentValue != null ? aliasContentValue : "";
-  }
-  static resolveAliasedTableCell(meta, column) {
-    const normalizedColumn = this.normalizeComparableField(column);
-    const aliases = normalizedColumn.includes("employee") ? ["number of employees", "employee count", "employees", "headcount", "staff count", "workforce"] : normalizedColumn.includes("name") ? ["company name", "organization name", "organisation name", "name", "company", "organization", "organisation"] : [];
-    for (const alias of aliases) {
-      const normalizedAlias = this.normalizeComparableField(alias);
-      const match = Object.entries(meta).find(([key]) => {
-        const normalizedKey = this.normalizeComparableField(key);
-        return normalizedKey === normalizedAlias || normalizedKey.includes(normalizedAlias) || normalizedAlias.includes(normalizedKey);
-      });
-      if (match && match[1] !== void 0 && match[1] !== null) return match[1];
-    }
-    return void 0;
-  }
-  static extractContentFieldValue(content, column) {
-    const escaped = column.replace(/[.*+?^${}()|[\]\\]/g, "\\$&").replace(/\s+/g, "[\\s_ -]+");
-    const pattern = new RegExp(`(?:^|\\n)\\s*${escaped}\\s*[:\\-\u2013]\\s*([^\\n]+)`, "i");
-    const match = content.match(pattern);
-    return match ? match[1].trim() : null;
-  }
-  static extractAliasedContentFieldValue(content, column) {
-    const normalizedColumn = this.normalizeComparableField(column);
-    const aliases = normalizedColumn.includes("employee") ? ["Number Of Employees", "Number of Employees", "Employee Count", "Employees", "Headcount", "Staff Count", "Workforce"] : normalizedColumn.includes("name") ? ["Company Name", "Organization Name", "Organisation Name", "Name", "Company", "Organization", "Organisation"] : [];
-    for (const alias of aliases) {
-      const value = this.extractContentFieldValue(content, alias);
-      if (value !== null) return value;
-    }
-    return null;
-  }
-  static toDisplayValue(value) {
-    if (typeof value === "string" || typeof value === "number" || typeof value === "boolean") return value;
-    return String(value != null ? value : "");
-  }
-  static calculateStockCounts(category, data) {
-    let inStock = 0;
-    let outOfStock = 0;
-    data.forEach((d) => {
-      var _a, _b;
-      const cat = (_a = this.getProductCategory(d)) != null ? _a : "Other";
-      if (cat === category) {
-        const quantity = (_b = this.extractStockQuantity(d)) != null ? _b : 1;
-        if (this.determineStockStatus(d)) inStock += quantity;
-        else outOfStock += quantity;
-      }
-    });
-    return { inStockCount: inStock, outOfStockCount: outOfStock };
-  }
-  static determineStockStatus(item) {
-    if (!item) return true;
-    const meta = item.metadata || {};
-    const stockValue = resolveMetadataValue(meta, "stock");
-    if (stockValue !== void 0) {
-      const normalized = String(stockValue).toLowerCase();
-      if (/out[_\s-]?of[_\s-]?stock|unavailable|false|no|sold out|0/.test(normalized)) return false;
-      if (/in[_\s-]?stock|available|true|yes/.test(normalized)) return true;
-      const numeric = this.toFiniteNumber(stockValue);
-      if (numeric !== null) return numeric > 0;
-    }
-    if (meta.inStock !== void 0) return Boolean(meta.inStock);
-    if (meta.stock !== void 0) return Boolean(meta.stock);
-    if (meta.available !== void 0) return Boolean(meta.available);
-    const content = (item.content || "").toLowerCase();
-    if (/out[_\s-]?of[_\s-]?stock|unavailable|sold out/.test(content)) return false;
-    if (/in[_\s-]?stock|available/.test(content)) return true;
-    return true;
-  }
-  static extractStockQuantity(item) {
-    if (!item) return null;
-    const meta = item.metadata || {};
-    const stockValue = resolveMetadataValue(meta, "stock");
-    const numericStock = this.toFiniteNumber(stockValue);
-    if (numericStock !== null) return numericStock;
-    const content = item.content || "";
-    const stockMatch = content.match(/\b(?:stock|inventory|quantity|count)\s*[:\-–]?\s*([\d,]+)/i);
-    if (!stockMatch) return null;
-    return this.toFiniteNumber(stockMatch[1]);
-  }
-  static toFiniteNumber(value) {
-    if (typeof value === "number") return Number.isFinite(value) ? value : null;
-    const numeric = Number(String(value != null ? value : "").replace(/[$,% ,]/g, ""));
-    return Number.isFinite(numeric) ? numeric : null;
-  }
-  // ─── Product Extraction ───────────────────────────────────────────────────
-  static getDynamicVal(meta, uiKey, config, trainedSchema) {
-    var _a;
-    if (!meta) return void 0;
-    const mapping = (_a = config == null ? void 0 : config.rag) == null ? void 0 : _a.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];
-      if (trainedKey && meta[trainedKey] !== void 0) return meta[trainedKey];
-    }
-    return resolveMetadataValue(meta, uiKey);
-  }
-  static extractProductInfo(item, config, trainedSchema) {
-    var _a, _b;
-    if (!item) return null;
-    const meta = item.metadata || {};
-    const content = item.content || "";
-    const name = this.getDynamicVal(meta, "name", config, trainedSchema);
-    const price = this.getDynamicVal(meta, "price", config, trainedSchema);
-    const brand = this.getDynamicVal(meta, "brand", config, trainedSchema);
-    const description = this.cleanProductDescription(
-      (_a = this.extractProductDescriptionFromContent(content)) != null ? _a : this.getProductDescriptionValue(meta, config, trainedSchema)
-    );
-    if (name || this.isProductData(item)) {
-      let finalName = name ? String(name) : void 0;
-      if (!finalName && content) {
-        const nameMatch = content.match(/(?:Product|Item|Name):\s*([^\n]+)/i);
-        finalName = nameMatch ? nameMatch[1].trim() : (_b = content.split("\n")[0]) == null ? void 0 : _b.substring(0, 60);
-      }
-      if (!finalName) {
-        console.warn(
-          `[UITransformer] Unable to read product name from metadata or content for item ${item.id}. Defaulting to 'Unnamed Product'.`,
-          { metadataKeys: Object.keys(meta), contentLength: content.length }
-        );
-      }
-      let finalPrice = typeof price === "number" || typeof price === "string" ? price : void 0;
-      if (!finalPrice && content) {
-        const priceMatch = content.match(/(?:Price|Cost):\s*\$?([\d,.]+)/i) || content.match(/\$\s*([\d,.]+)/);
-        if (priceMatch) finalPrice = priceMatch[1].replace(/,/g, "");
-      }
-      if (finalPrice === void 0) {
-        console.warn(
-          `[UITransformer] Unable to read product price from metadata or content for item ${item.id}.`,
-          { metadataKeys: Object.keys(meta), contentSnippet: content.substring(0, 100) }
-        );
-      }
-      const imageValue = this.getDynamicVal(meta, "image", config, trainedSchema);
-      if (!imageValue) {
-        console.debug(
-          `[UITransformer] Unable to read product image URL from metadata for item ${item.id}.`
-        );
-      }
-      if (!description) {
-        console.debug(
-          `[UITransformer] Unable to read product description from metadata or content for item ${item.id}.`
-        );
-      }
-      return {
-        id: item.id,
-        name: finalName || "Unnamed Product",
-        price: finalPrice,
-        image: typeof imageValue === "string" ? imageValue : void 0,
-        brand: brand ? String(brand) : void 0,
-        description,
-        inStock: this.determineStockStatus(item)
-      };
-    } else {
-      console.warn(
-        `[UITransformer] Item ${item.id} skipped: unable to read name or identify as product data from metadata/content.`,
-        { metadataKeys: Object.keys(meta), contentSnippet: content.substring(0, 100) }
-      );
-    }
-    return null;
-  }
-  static extractProductDescriptionFromContent(content) {
-    const bodyMatch = content.match(
-      /\bBody\s*\(HTML\)\s*:\s*([\s\S]*?)(?=\s*[,.]?\s+\b(?:Handle|Title|Vendor|Type|Tags|Published|Option\d*\s+Name|Option\d*\s+Value|Option|Variant|Image|SKU|Price|Status|Category)\b\s*:|$)/i
-    );
-    if (bodyMatch == null ? void 0 : bodyMatch[1]) return bodyMatch[1];
-    const descriptionMatch = content.match(
-      /\b(?:Description|Summary|Details|Body|Content)\s*:\s*([\s\S]*?)(?=\s*[,.]?\s+\b(?:Handle|Title|Vendor|Type|Tags|Published|Option\d*\s+Name|Option\d*\s+Value|Option|Variant|Image|SKU|Price|Status|Category)\b\s*:|$)/i
-    );
-    if (descriptionMatch == null ? void 0 : descriptionMatch[1]) return descriptionMatch[1];
-    return null;
-  }
-  static getProductDescriptionValue(meta, config, trainedSchema) {
-    const mapped = this.getDynamicVal(meta, "description", config, trainedSchema);
-    if (mapped !== void 0 && mapped !== meta.content && mapped !== meta.text) return mapped;
-    const preferredKeys = [
-      "body_html",
-      "body html",
-      "bodyHtml",
-      "description",
-      "summary",
-      "details",
-      "body"
-    ];
-    for (const key of preferredKeys) {
-      const match = Object.keys(meta).find(
-        (candidate) => this.normalizeComparableField(candidate) === this.normalizeComparableField(key)
-      );
-      if (match && meta[match] !== void 0 && meta[match] !== null) return meta[match];
-    }
-    return void 0;
-  }
-  static cleanProductDescription(raw) {
-    if (raw === null || raw === void 0) return void 0;
-    const extracted = this.extractProductDescriptionFromContent(String(raw));
-    if (extracted && extracted !== String(raw)) return this.cleanProductDescription(extracted);
-    const text = String(raw).replace(/<[^>]*>/g, " ").replace(/&nbsp;/gi, " ").replace(/&amp;/gi, "&").replace(/&quot;/gi, '"').replace(/&#39;/gi, "'").replace(/\[[^\]]*TYPE[^\]]*\]/gi, " ").replace(/\b(?:Handle|Title|Vendor|Type|Tags|Published|Option\d*\s+Name|Option\d*\s+Value|Option|Variant|Image|SKU|Price|Status|Category)\s*:\s*[^,.\n:]+[,.]?/gi, " ").replace(/\bBody\s*\(HTML\)\s*:\s*/gi, " ").replace(/\b(?:Description|Summary|Details|Body|Content)\s*:\s*/gi, " ").replace(/\s+/g, " ").trim();
-    return text || void 0;
-  }
-  // ─── Visualization Prompt ─────────────────────────────────────────────────
-  static buildVisualizationSystemPrompt() {
-    return `You are a data visualization expert embedded in a RAG chat system.
-You will receive a user question, a pre-computed INTENT object, and structured data from a vector database.
-Your ONLY job is to return a single JSON object describing how to visualize the data.
-The INTENT object is authoritative \u2014 honor it. For example:
-  - If intent.wantsExplicitTable is false, never return type "table".
-  - If intent.isTemporal is true, prefer line_chart.
-  - If intent.visualizationHint is "comparison" or "ranking", prefer bar_chart.
-  - If intent.visualizationHint is "composition", prefer pie_chart.
-  - If intent.recommendedChart is unsupported by the response schema, use the nearest supported type.
-  - Always respond in the language specified by intent.language.
-
-Return ONLY a valid JSON object \u2014 no markdown fences, no prose.
-
-{
-  "type": "bar_chart" | "horizontal_bar" | "line_chart" | "pie_chart" | "histogram" | "scatter_plot" | "radar_chart" | "metric_card" | "geo_map" | "table" | "text",
-  "title": "concise descriptive title",
-  "description": "one sentence describing the visualization",
-  "data": <structured data per type below>
-}
-
-DATA SHAPES:
-- bar_chart:   [{ "category": string, "value": number }]
-- horizontal_bar: [{ "category": string, "value": number }]
-- histogram:   [{ "category": string, "value": number }]
-- line_chart:  [{ "timestamp": string, "value": number, "label": string }]
-- pie_chart:   [{ "label": string, "value": number }]
-- scatter_plot:[{ "x": number, "y": number, "label": string }]
-- radar_chart: [{ "attribute": string, "<series1>": number, "<series2>": number, ... }]
-- metric_card: { "label": string, "value": number, "operation": "sum"|"average"|"count"|"min"|"max"|"median" }
-- geo_map:     [{ "category": string, "value": number }]
-- table:       { "columns": string[], "rows": (string|number)[][] }
-- text:        { "content": "A concise plain-language answer." }
-
-RULES:
-1. Aggregate values \u2014 never pass raw nested objects in chart arrays.
-2. All "value" fields must be numbers.
-3. Cap bar/line/pie at 12 data points.
-4. Use dollar signs only for monetary prices, not for stock quantities or years.
-5. If no relevant data is found, return text: "I cannot answer this question based on the available information."`;
-  }
-  static buildContextSummary(sources, maxChars = 6e3) {
-    const items = (sources || []).filter(Boolean).map((s, i) => {
-      var _a, _b, _c, _d;
-      return {
-        index: i + 1,
-        content: (_b = (_a = s == null ? void 0 : s.content) == null ? void 0 : _a.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
-      };
-    });
-    const full = JSON.stringify(items, null, 2);
-    if (full.length <= maxChars) return full;
-    const partial = [];
-    let chars = 2;
-    for (const item of items) {
-      const chunk = JSON.stringify(item);
-      if (chars + chunk.length + 2 > maxChars) break;
-      partial.push(item);
-      chars += chunk.length + 2;
-    }
-    return JSON.stringify(partial, null, 2) + "\n// ... truncated";
-  }
-};
-
-// src/rendering/RendererRegistry.ts
-var TextRendererStrategy = class {
-  constructor() {
-    this.type = "text";
-  }
-  render(data, options) {
-    const title = (options == null ? void 0 : options.title) || "Information";
-    if (typeof data === "string") {
-      return { type: "text", title, data: { content: data } };
-    }
-    const docs = Array.isArray(data) ? data : [];
-    const text = docs.map((d) => {
-      var _a;
-      return (_a = d == null ? void 0 : d.content) != null ? _a : "";
-    }).join("\n\n");
-    return { type: "text", title, data: { content: text || "No detailed content available." } };
-  }
-};
-var TableRendererStrategy = class {
-  constructor() {
-    this.type = "table";
-  }
-  render(data, options) {
-    const docs = Array.isArray(data) ? data : [];
-    const query = (options == null ? void 0 : options.query) || "";
-    return UITransformer.transform(query, docs, void 0, void 0, {
-      visualizationHint: "table",
-      recommendedChart: "table",
-      filterInStockOnly: false,
-      wantsExplicitTable: true,
-      isTemporal: false,
-      isComparison: true,
-      language: "en"
-    });
-  }
-};
-var CarouselRendererStrategy = class {
-  constructor() {
-    this.type = "carousel";
-  }
-  render(data, options) {
-    const docs = Array.isArray(data) ? data : [];
-    const query = (options == null ? void 0 : options.query) || "";
-    return UITransformer.transform(query, docs, void 0, void 0, {
-      visualizationHint: "product_browse",
-      recommendedChart: "text",
-      filterInStockOnly: false,
-      wantsExplicitTable: false,
-      isTemporal: false,
-      isComparison: false,
-      language: "en"
-    });
-  }
-};
-var ChartRendererStrategy = class {
-  constructor() {
-    this.type = "chart";
-  }
-  render(data, options) {
-    const docs = Array.isArray(data) ? data : [];
-    const query = (options == null ? void 0 : options.query) || "";
-    const chartType = (options == null ? void 0 : options.chartType) || "bar";
-    let hint = "comparison";
-    let rec = "bar_chart";
-    if (chartType === "line") {
-      hint = "trend";
-      rec = "line_chart";
-    } else if (chartType === "pie") {
-      hint = "composition";
-      rec = "pie_chart";
-    } else if (chartType === "scatter") {
-      hint = "correlation";
-      rec = "scatter_plot";
-    }
-    return UITransformer.transform(query, docs, void 0, void 0, {
-      visualizationHint: hint,
-      recommendedChart: rec,
-      filterInStockOnly: false,
-      wantsExplicitTable: false,
-      isTemporal: chartType === "line",
-      isComparison: chartType === "bar",
-      language: "en"
-    });
-  }
-};
-var MixedRendererStrategy = class {
-  constructor() {
-    this.type = "mixed";
-  }
-  render(data, options) {
-    const docs = Array.isArray(data) ? data : [];
-    const sections = (options == null ? void 0 : options.sections) || [];
-    const sectionPayloads = sections.map((s) => {
-      const strategy = RendererRegistry.getStrategy(s.type);
-      return {
-        type: s.type,
-        title: s.title,
-        payload: strategy.render(data, __spreadProps(__spreadValues({}, options), { chartType: s.chartType, title: s.title }))
-      };
-    });
-    return {
-      type: "table",
-      // Fallback container type for compatibility
-      title: (options == null ? void 0 : options.title) || "Composite Response",
-      description: `Mixed payload containing ${sectionPayloads.length} visual sections`,
-      data: { sections: sectionPayloads }
-    };
-  }
-};
-var _RendererRegistry = class _RendererRegistry {
-  /**
-   * Register a new renderer strategy.
-   * Enables seamless addition of custom visualizers (Timeline, Maps, Flow Diagrams, etc.).
-   */
-  static registerStrategy(strategy) {
-    this.strategies.set(String(strategy.type).toLowerCase(), strategy);
-  }
-  /**
-   * Retrieve a registered renderer strategy by type string.
-   */
-  static getStrategy(type) {
-    const key = type.toLowerCase();
-    const strategy = this.strategies.get(key);
-    if (!strategy) {
-      return this.strategies.get("text");
-    }
-    return strategy;
-  }
-  /**
-   * Check if a renderer strategy is registered.
-   */
-  static hasStrategy(type) {
-    return this.strategies.has(type.toLowerCase());
-  }
-  /**
-   * List all registered strategy types.
-   */
-  static getRegisteredTypes() {
-    return Array.from(this.strategies.keys());
-  }
-};
-_RendererRegistry.strategies = /* @__PURE__ */ new Map();
-_RendererRegistry.registerStrategy(new TextRendererStrategy());
-_RendererRegistry.registerStrategy(new TableRendererStrategy());
-_RendererRegistry.registerStrategy(new CarouselRendererStrategy());
-_RendererRegistry.registerStrategy(new ChartRendererStrategy());
-_RendererRegistry.registerStrategy(new MixedRendererStrategy());
-var RendererRegistry = _RendererRegistry;
-
 // src/core/CircuitBreaker.ts
 var CircuitBreaker = class {
   constructor(options = {}) {
@@ -6718,7 +4767,6 @@ export {
   ConfigurationException,
   DocumentUpload,
   EmbeddingFailedException,
-  IntentClassifier,
   LicenseValidationError,
   LicenseValidator,
   MessageBubble,
@@ -6727,16 +4775,12 @@ export {
   ProductCarousel,
   ProviderNotFoundException,
   RateLimitException,
-  RendererRegistry,
   RetrievalException,
   RetrivoraError,
-  RuleEngine,
   SDKVersionUnsupportedError,
   SDK_VERSION,
   SourceCard,
-  VisualizationDecisionEngine,
   addSynonyms,
-  decideVisualization,
   isTransientError,
   useConfig,
   useRagChat