@retrivora-ai/rag-engine 1.7.6 → 1.7.7

package/dist/server.js

@@ -3865,65 +3865,410 @@ var QueryProcessor = class {
   }
 };
 
-// src/core/Pipeline.ts
-var LRUEmbeddingCache = class {
-  constructor(maxSize = 500) {
-    this.cache = /* @__PURE__ */ new Map();
-    this.maxSize = maxSize;
-  }
-  get(key) {
-    const value = this.cache.get(key);
-    if (value !== void 0) {
-      this.cache.delete(key);
-      this.cache.set(key, value);
+// src/utils/UITransformer.ts
+var UITransformer = class {
+  /**
+   * Main transformation method
+   * Analyzes user query and retrieved data to determine the best visualization format
+   *
+   * @param userQuery - The original user question/query
+   * @param retrievedData - Vector database retrieval results
+   * @returns Structured JSON response for UI rendering
+   */
+  static transform(userQuery, retrievedData) {
+    if (!retrievedData || retrievedData.length === 0) {
+      return this.createTextResponse("No data available", "No relevant data found for your query.");
+    }
+    const analysis = this.analyzeData(userQuery, retrievedData);
+    switch (analysis.suggestedType) {
+      case "product_carousel":
+        return this.transformToProductCarousel(retrievedData);
+      case "pie_chart":
+        return this.transformToPieChart(retrievedData);
+      case "bar_chart":
+        return this.transformToBarChart(retrievedData);
+      case "line_chart":
+        return this.transformToLineChart(retrievedData);
+      case "table":
+        return this.transformToTable(retrievedData);
+      default:
+        return this.transformToText(retrievedData);
     }
-    return value;
   }
-  set(key, value) {
-    if (this.cache.has(key)) {
-      this.cache.delete(key);
-    } else if (this.cache.size >= this.maxSize) {
-      const oldestKey = this.cache.keys().next().value;
-      if (oldestKey !== void 0) this.cache.delete(oldestKey);
+  /**
+   * Analyzes the data and query to suggest the best visualization type
+   */
+  static analyzeData(query, data) {
+    const queryLower = query.toLowerCase();
+    const hasProducts = data.some(
+      (item) => this.isProductData(item)
+    );
+    const hasTimeSeries = data.some(
+      (item) => this.isTimeSeriesData(item)
+    );
+    const hasCategories = this.detectCategories(data).length > 0;
+    const isDistributionQuery = queryLower.includes("distribution") || queryLower.includes("breakdown") || queryLower.includes("percentage") || queryLower.includes("proportion");
+    const isComparisonQuery = queryLower.includes("compare") || queryLower.includes("vs") || queryLower.includes("difference");
+    const isTrendQuery = queryLower.includes("trend") || queryLower.includes("over time") || queryLower.includes("growth") || queryLower.includes("decline");
+    if (hasProducts && !hasTimeSeries && !isDistributionQuery) {
+      return { suggestedType: "product_carousel", confidence: 0.95, hasProducts, hasTimeSeries, hasCategories };
     }
-    this.cache.set(key, value);
+    if (isTrendQuery && hasTimeSeries) {
+      return { suggestedType: "line_chart", confidence: 0.9, hasProducts, hasTimeSeries, hasCategories };
+    }
+    if (isDistributionQuery && hasCategories) {
+      return { suggestedType: "pie_chart", confidence: 0.85, hasProducts, hasTimeSeries, hasCategories };
+    }
+    if (isComparisonQuery && hasCategories && data.length > 2) {
+      return { suggestedType: "bar_chart", confidence: 0.8, hasProducts, hasTimeSeries, hasCategories };
+    }
+    if (data.length > 5 && this.hasMultipleFields(data)) {
+      return { suggestedType: "table", confidence: 0.75, hasProducts, hasTimeSeries, hasCategories };
+    }
+    return { suggestedType: "text", confidence: 0.5, hasProducts, hasTimeSeries, hasCategories };
   }
-  clear() {
-    this.cache.clear();
+  /**
+   * Transform data to product carousel format
+   */
+  static transformToProductCarousel(data) {
+    const products = data.filter((item) => this.isProductData(item)).map((item) => this.extractProductInfo(item)).filter((p) => p !== null);
+    return {
+      type: "product_carousel",
+      title: "Recommended Products",
+      description: `Found ${products.length} relevant products`,
+      data: products
+    };
   }
-  get size() {
-    return this.cache.size;
+  /**
+   * Transform data to pie chart format
+   */
+  static transformToPieChart(data) {
+    const categories = this.detectCategories(data);
+    const categoryData = this.aggregateByCategory(data, categories);
+    const pieData = Object.entries(categoryData).map(([label, count]) => ({
+      label,
+      value: count,
+      inStock: this.checkStockStatus(label, data)
+    }));
+    return {
+      type: "pie_chart",
+      title: "Distribution by Category",
+      description: `Showing breakdown across ${categories.length} categories`,
+      data: pieData
+    };
   }
-};
-var Pipeline = class {
-  constructor(config) {
-    this.config = config;
-    /** LRU-bounded cache: avoids re-embedding identical queries within the same process. */
-    this.embeddingCache = new LRUEmbeddingCache(500);
-    this.initialised = false;
-    var _a, _b, _c, _d, _e;
-    this.chunker = new DocumentChunker(
-      (_b = (_a = config.rag) == null ? void 0 : _a.chunkSize) != null ? _b : 1e3,
-      (_d = (_c = config.rag) == null ? void 0 : _c.chunkOverlap) != null ? _d : 200
+  /**
+   * Transform data to bar chart format
+   */
+  static transformToBarChart(data) {
+    const categories = this.detectCategories(data);
+    const categoryData = this.aggregateByCategory(data, categories);
+    const barData = Object.entries(categoryData).map(([category, value]) => ({
+      category,
+      value,
+      inStock: this.checkStockStatus(category, data)
+    }));
+    return {
+      type: "bar_chart",
+      title: "Comparison by Category",
+      description: `Comparing ${categories.length} categories`,
+      data: barData
+    };
+  }
+  /**
+   * Transform data to line chart format
+   */
+  static transformToLineChart(data) {
+    const timePoints = this.extractTimeSeriesData(data);
+    const lineData = timePoints.map((point) => ({
+      timestamp: point.timestamp,
+      value: point.value,
+      label: point.label
+    }));
+    return {
+      type: "line_chart",
+      title: "Trend Over Time",
+      description: `Showing ${lineData.length} data points`,
+      data: lineData
+    };
+  }
+  /**
+   * Transform data to table format
+   */
+  static transformToTable(data) {
+    const columns = this.extractTableColumns(data);
+    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
+    };
+  }
+  /**
+   * Transform data to text format (fallback)
+   */
+  static transformToText(data) {
+    const textContent = data.map((item) => item.content).join("\n\n");
+    return this.createTextResponse(
+      "Search Results",
+      textContent,
+      `Found ${data.length} relevant results`
     );
-    if (((_e = config.rag) == null ? void 0 : _e.chunkingStrategy) === "llamaindex") {
-      this.llamaIngestor = new LlamaIndexIngestor();
+  }
+  /**
+   * Helper: Create text response
+   */
+  static createTextResponse(title, content, description) {
+    return {
+      type: "text",
+      title,
+      description,
+      data: { content }
+    };
+  }
+  /**
+   * Helper: Check if data item is product-related
+   */
+  static isProductData(item) {
+    const content = (item.content || "").toLowerCase();
+    const productKeywords = ["product", "price", "stock", "item", "sku", "brand", "model"];
+    return productKeywords.some((kw) => content.includes(kw)) || Object.keys(item.metadata || {}).some(
+      (k) => ["name", "price", "product", "sku"].includes(k.toLowerCase())
+    );
+  }
+  /**
+   * Helper: Check if data contains time series
+   */
+  static isTimeSeriesData(item) {
+    const content = (item.content || "").toLowerCase();
+    const timeKeywords = ["date", "time", "year", "month", "week", "day", "hour", "trend", "historical"];
+    return timeKeywords.some((kw) => content.includes(kw)) || Object.keys(item.metadata || {}).some(
+      (k) => ["date", "timestamp", "time", "period"].includes(k.toLowerCase())
+    );
+  }
+  /**
+   * Helper: Extract product information from vector match
+   */
+  static extractProductInfo(item) {
+    const meta = item.metadata || {};
+    if (meta.name || meta.product) {
+      return {
+        id: item.id,
+        name: meta.name || meta.product,
+        price: meta.price,
+        image: meta.image || meta.imageUrl,
+        brand: meta.brand,
+        description: item.content,
+        inStock: this.determineStockStatus(item)
+      };
     }
-    this.reranker = new Reranker();
+    const nameMatch = item.content.match(/(?:Product|Item|Name):\s*([^\n]+)/i);
+    const priceMatch = item.content.match(/(?:Price|Cost):\s*\$?([\d.]+)/i);
+    if (nameMatch) {
+      return {
+        id: item.id,
+        name: nameMatch[1],
+        price: priceMatch ? parseFloat(priceMatch[1]) : void 0,
+        description: item.content,
+        inStock: this.determineStockStatus(item)
+      };
+    }
+    return null;
   }
-  async initialize() {
-    var _a, _b;
-    if (this.initialised) return;
-    const CHART_MARKER = "<!-- UI_PROTOCOL_V7 -->";
-    const chartInstruction = `
-
-${CHART_MARKER}
-### UNIVERSAL UI PROTOCOL V7 (STRICT MODE)
-
-You are responsible for returning a SINGLE structured UI block when visualization is required.
-
----
-
+  /**
+   * Helper: Detect categories in data
+   */
+  static detectCategories(data) {
+    const categories = /* @__PURE__ */ new Set();
+    data.forEach((item) => {
+      const meta = item.metadata || {};
+      if (meta.category) {
+        categories.add(String(meta.category));
+      }
+      if (meta.type) {
+        categories.add(String(meta.type));
+      }
+      if (meta.tag) {
+        const tags = Array.isArray(meta.tag) ? meta.tag : [meta.tag];
+        tags.forEach((t) => categories.add(String(t)));
+      }
+      const categoryMatch = item.content.match(/(?:Category|Type|Class):\s*([^\n]+)/i);
+      if (categoryMatch) {
+        categories.add(categoryMatch[1].trim());
+      }
+    });
+    return Array.from(categories);
+  }
+  /**
+   * Helper: Aggregate data by category
+   */
+  static aggregateByCategory(data, categories) {
+    const result = {};
+    categories.forEach((cat) => {
+      result[cat] = 0;
+    });
+    data.forEach((item) => {
+      const meta = item.metadata || {};
+      const itemCategory = meta.category || meta.type || "Other";
+      if (result.hasOwnProperty(itemCategory)) {
+        result[itemCategory]++;
+      } else {
+        result["Other"] = (result["Other"] || 0) + 1;
+      }
+    });
+    return result;
+  }
+  /**
+   * Helper: Extract time series data
+   */
+  static extractTimeSeriesData(data) {
+    return data.map((item) => {
+      const meta = item.metadata || {};
+      return {
+        timestamp: meta.timestamp || meta.date || (/* @__PURE__ */ new Date()).toISOString(),
+        value: meta.value || item.score || 0,
+        label: meta.label || item.content.substring(0, 50)
+      };
+    });
+  }
+  /**
+   * Helper: Extract table columns
+   */
+  static extractTableColumns(data) {
+    const columnSet = /* @__PURE__ */ new Set();
+    columnSet.add("Content");
+    data.forEach((item) => {
+      Object.keys(item.metadata || {}).forEach((key) => {
+        columnSet.add(key.charAt(0).toUpperCase() + key.slice(1));
+      });
+    });
+    return Array.from(columnSet);
+  }
+  /**
+   * Helper: Extract table row
+   */
+  static extractTableRow(item, columns) {
+    const meta = item.metadata || {};
+    return columns.map((col) => {
+      if (col === "Content") {
+        return item.content.substring(0, 100);
+      }
+      const metaKey = col.charAt(0).toLowerCase() + col.slice(1);
+      const value = meta[metaKey];
+      return value !== void 0 ? String(value) : "";
+    });
+  }
+  /**
+   * Helper: Check stock status
+   */
+  static checkStockStatus(category, data) {
+    const item = data.find((d) => {
+      const meta = d.metadata || {};
+      return meta.category === category || meta.type === category;
+    });
+    return this.determineStockStatus(item || {});
+  }
+  /**
+   * Helper: Determine if item is in stock
+   */
+  static determineStockStatus(item) {
+    const meta = item.metadata || {};
+    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 (content.includes("out of stock") || content.includes("unavailable")) {
+      return false;
+    }
+    if (content.includes("in stock") || content.includes("available")) {
+      return true;
+    }
+    return true;
+  }
+  /**
+   * Helper: Check if data has multiple fields
+   */
+  static hasMultipleFields(data) {
+    const fieldCount = /* @__PURE__ */ new Set();
+    data.forEach((item) => {
+      Object.keys(item.metadata || {}).forEach((key) => {
+        fieldCount.add(key);
+      });
+    });
+    return fieldCount.size > 2;
+  }
+};
+
+// src/core/Pipeline.ts
+var LRUEmbeddingCache = class {
+  constructor(maxSize = 500) {
+    this.cache = /* @__PURE__ */ new Map();
+    this.maxSize = maxSize;
+  }
+  get(key) {
+    const value = this.cache.get(key);
+    if (value !== void 0) {
+      this.cache.delete(key);
+      this.cache.set(key, value);
+    }
+    return value;
+  }
+  set(key, value) {
+    if (this.cache.has(key)) {
+      this.cache.delete(key);
+    } else if (this.cache.size >= this.maxSize) {
+      const oldestKey = this.cache.keys().next().value;
+      if (oldestKey !== void 0) this.cache.delete(oldestKey);
+    }
+    this.cache.set(key, value);
+  }
+  clear() {
+    this.cache.clear();
+  }
+  get size() {
+    return this.cache.size;
+  }
+};
+var Pipeline = class {
+  constructor(config) {
+    this.config = config;
+    /** LRU-bounded cache: avoids re-embedding identical queries within the same process. */
+    this.embeddingCache = new LRUEmbeddingCache(500);
+    this.initialised = false;
+    var _a, _b, _c, _d, _e;
+    this.chunker = new DocumentChunker(
+      (_b = (_a = config.rag) == null ? void 0 : _a.chunkSize) != null ? _b : 1e3,
+      (_d = (_c = config.rag) == null ? void 0 : _c.chunkOverlap) != null ? _d : 200
+    );
+    if (((_e = config.rag) == null ? void 0 : _e.chunkingStrategy) === "llamaindex") {
+      this.llamaIngestor = new LlamaIndexIngestor();
+    }
+    this.reranker = new Reranker();
+  }
+  async initialize() {
+    var _a, _b;
+    if (this.initialised) return;
+    const CHART_MARKER = "<!-- UI_PROTOCOL_V7 -->";
+    const chartInstruction = `
+
+${CHART_MARKER}
+### UNIVERSAL UI PROTOCOL V7 (STRICT MODE)
+
+You are responsible for returning a SINGLE structured UI block when visualization is required.
+
+---
+
 ## 1. INTENT CLASSIFICATION (MANDATORY)
 
 Classify the query into ONE of the following intents:
@@ -4043,6 +4388,8 @@ Classify the query into ONE of the following intents:
 - ALWAYS return EXACTLY ONE \`\`\`ui\`\`\` block
 - JSON must be VALID
 - No explanation inside block
+- NEVER use ASCII charts, Markdown tables, or text-based drawings for data.
+- If data is tabular or statistical, ALWAYS use the \`\`\`ui\`\`\` block.
 
 ---
 
@@ -4101,1311 +4448,970 @@ User: "distribution of products across categories"
   "insights": ["Beauty dominates inventory"]
 }
 \`\`\`
-`;
-    if (!((_a = this.config.llm.systemPrompt) == null ? void 0 : _a.includes(CHART_MARKER))) {
-      let cleanPrompt = this.config.llm.systemPrompt || "";
-      cleanPrompt = cleanPrompt.replace(/\n\n### UNIVERSAL UI PROTOCOL[\s\S]*?(?=\n\n|$)/g, "");
-      cleanPrompt = cleanPrompt.replace(/<!-- UI_PROTOCOL_V\d+ -->[\s\S]*?(?=\n\n|$)/g, "");
-      this.config.llm.systemPrompt = cleanPrompt.trim() + chartInstruction;
-    }
-    console.log(`[Pipeline] Initializing with provider: ${this.config.vectorDb.provider}...`);
-    this.vectorDB = await ProviderRegistry.createVectorProvider(this.config.vectorDb);
-    const { llmProvider, embeddingProvider } = await EmbeddingStrategyResolver.resolve(
-      this.config.llm,
-      this.config.embedding
-    );
-    this.llmProvider = llmProvider;
-    this.embeddingProvider = embeddingProvider;
-    if (this.config.graphDb) {
-      this.graphDB = await ProviderRegistry.createGraphProvider(this.config.graphDb);
-      await this.graphDB.initialize();
-      this.entityExtractor = new EntityExtractor(this.llmProvider);
-    }
-    await this.vectorDB.initialize();
-    if (((_b = this.config.rag) == null ? void 0 : _b.architecture) === "agentic") {
-      this.agent = new LangChainAgent(this, this.config);
-      await this.agent.initialize(this.llmProvider);
-    }
-    this.initialised = true;
-  }
-  /**
-   * Ingest documents with automatic chunking, embedding, and batch upsert.
-   * Handles retries for transient failures.
-   */
-  async ingest(documents, namespace) {
-    await this.initialize();
-    const ns = namespace != null ? namespace : this.config.projectId;
-    const results = [];
-    for (const doc of documents) {
-      try {
-        const chunks = await this.prepareChunks(doc);
-        const vectors = await this.processEmbeddings(chunks);
-        const upsertDocs = chunks.map((chunk, i) => ({
-          id: chunk.id,
-          vector: vectors[i],
-          content: chunk.content,
-          metadata: chunk.metadata
-        }));
-        const totalProcessed = await this.processUpserts(upsertDocs, ns);
-        results.push({
-          docId: doc.docId,
-          chunksIngested: totalProcessed
-        });
-        if (this.graphDB && this.entityExtractor) {
-          await this.processGraphIngestion(doc.docId, chunks);
-        }
-      } catch (error) {
-        console.error(`[Pipeline] Failed to ingest document ${doc.docId}:`, error);
-        results.push({ docId: doc.docId, chunksIngested: 0 });
-      }
-    }
-    return results;
-  }
-  /**
-   * Step 1: Chunk the document content.
-   */
-  async prepareChunks(doc) {
-    var _a, _b;
-    if (this.llamaIngestor) {
-      return await this.llamaIngestor.chunk(doc.content, {
-        docId: doc.docId,
-        metadata: doc.metadata,
-        chunkSize: (_a = this.config.rag) == null ? void 0 : _a.chunkSize,
-        chunkOverlap: (_b = this.config.rag) == null ? void 0 : _b.chunkOverlap
-      });
-    }
-    return this.chunker.chunk(doc.content, {
-      docId: doc.docId,
-      metadata: doc.metadata
-    });
-  }
-  /**
-   * Step 2: Generate embeddings for chunks with retry logic.
-   * Uses batchEmbed when available for efficiency; falls back to sequential embedding.
-   */
-  async processEmbeddings(chunks) {
-    const embedBatchOptions = {
-      batchSize: 50,
-      maxRetries: 3,
-      initialDelayMs: 100
-    };
-    const vectors = await BatchProcessor.mapWithRetry(
-      chunks.map((c) => c.content),
-      (text) => this.embeddingProvider.embed(text, { taskType: "document" }),
-      embedBatchOptions
-    );
-    if (vectors.length !== chunks.length) {
-      throw new Error(
-        `[Pipeline] Embedding mismatch: got ${vectors.length} vectors for ${chunks.length} chunks. Check embedding provider logs for individual chunk failures.`
-      );
-    }
-    return vectors;
-  }
-  /**
-   * Step 3: Upsert chunks to vector database with retry logic.
-   */
-  async processUpserts(upsertDocs, namespace) {
-    const upsertBatchOptions = {
-      batchSize: 100,
-      maxRetries: 3,
-      initialDelayMs: 100
-    };
-    const upsertResult = await BatchProcessor.processBatch(
-      upsertDocs,
-      (batch) => this.vectorDB.batchUpsert(batch, namespace),
-      upsertBatchOptions
-    );
-    if (upsertResult.errors.length > 0) {
-      console.warn(`[Pipeline] Ingestion: ${upsertResult.errors.length} batches failed`);
-    }
-    return upsertResult.totalProcessed;
-  }
-  /**
-   * Step 4: Optional graph-based entity extraction and ingestion.
-   */
-  async processGraphIngestion(docId, chunks) {
-    console.log(`[Pipeline] Extracting entities for doc ${docId} (${chunks.length} chunks)...`);
-    const extractionOptions = {
-      batchSize: 2,
-      // Low concurrency for LLM extraction
-      maxRetries: 1,
-      initialDelayMs: 500
-    };
-    await BatchProcessor.processBatch(
-      chunks,
-      async (batch) => {
-        for (const chunk of batch) {
-          try {
-            const { nodes, edges } = await this.entityExtractor.extract(chunk.content);
-            if (nodes.length > 0) await this.graphDB.addNodes(nodes);
-            if (edges.length > 0) await this.graphDB.addEdges(edges);
-          } catch (err) {
-            console.warn(`[Pipeline] Entity extraction failed for chunk:`, err);
-          }
-        }
-      },
-      extractionOptions
-    );
-  }
-  async ask(question, history = [], namespace) {
-    var _a;
-    await this.initialize();
-    if (((_a = this.config.rag) == null ? void 0 : _a.architecture) === "agentic" && this.agent) {
-      console.log("[Pipeline] \u{1F916} Executing in Agentic Mode...");
-      const agentReply = await this.agent.run(question, history);
-      return { reply: agentReply, sources: [] };
-    }
-    const stream = this.askStream(question, history, namespace);
-    let reply = "";
-    let sources = [];
-    let graphData;
-    try {
-      for (var iter = __forAwait(stream), more, temp, error; more = !(temp = await iter.next()).done; more = false) {
-        const chunk = temp.value;
-        if (typeof chunk === "string") {
-          reply += chunk;
-        } else if ("sources" in chunk) {
-          sources = chunk.sources;
-          graphData = chunk.graphData;
-        }
-      }
-    } catch (temp) {
-      error = [temp];
-    } finally {
-      try {
-        more && (temp = iter.return) && await temp.call(iter);
-      } finally {
-        if (error)
-          throw error[0];
-      }
-    }
-    return { reply, sources, graphData };
-  }
-  /**
-   * High-performance streaming RAG flow.
-   * Yields text chunks first, then the retrieval metadata at the end.
-   */
-  askStream(_0) {
-    return __asyncGenerator(this, arguments, function* (question, history = [], namespace) {
-      var _a, _b, _c, _d, _e, _f, _g;
-      yield new __await(this.initialize());
-      const ns = namespace != null ? namespace : this.config.projectId;
-      const topK = (_b = (_a = this.config.rag) == null ? void 0 : _a.topK) != null ? _b : 5;
-      const scoreThreshold = (_d = (_c = this.config.rag) == null ? void 0 : _c.scoreThreshold) != null ? _d : 0;
-      try {
-        let searchQuery = question;
-        if ((_e = this.config.rag) == null ? void 0 : _e.useQueryTransformation) {
-          searchQuery = yield new __await(this.rewriteQuery(question, history));
-        }
-        const hints = QueryProcessor.extractQueryFieldHints(question, (_f = this.config.rag) == null ? void 0 : _f.filterableFields);
-        const filter = QueryProcessor.buildQueryFilter(question, hints);
-        console.log(`[Pipeline] \u{1F9E9} Extracted filters:`, JSON.stringify(filter));
-        const { sources: rawSources, graphData } = yield new __await(this.retrieve(searchQuery, {
-          namespace: ns,
-          topK: topK * 2,
-          filter
-        }));
-        let sources = rawSources.filter((m) => m.score >= scoreThreshold);
-        if ((_g = this.config.rag) == null ? void 0 : _g.useReranking) {
-          sources = yield new __await(this.reranker.rerank(sources, question, topK));
-        } else {
-          sources = sources.slice(0, topK);
-        }
-        let context = sources.length ? sources.map((m, i) => `[Source ${i + 1}]
-${m.content}`).join("\n\n---\n\n") : "No relevant context found.";
-        if (graphData && graphData.nodes.length > 0) {
-          const graphContext = graphData.nodes.map(
-            (n) => `Entity: ${n.label} (${n.id})${n.properties ? " - " + JSON.stringify(n.properties) : ""}`
-          ).join("\n");
-          context = `GRAPH KNOWLEDGE:
-${graphContext}
-
-VECTOR CONTEXT:
-${context}`;
-        }
-        const messages = [...history, { role: "user", content: question }];
-        if (this.llmProvider.chatStream) {
-          const stream = this.llmProvider.chatStream(messages, context);
-          if (!stream) {
-            throw new Error(`[Pipeline] ${this.config.llm.provider} chatStream returned undefined`);
-          }
-          try {
-            for (var iter = __forAwait(stream), more, temp, error; more = !(temp = yield new __await(iter.next())).done; more = false) {
-              const chunk = temp.value;
-              yield chunk;
-            }
-          } catch (temp) {
-            error = [temp];
-          } finally {
-            try {
-              more && (temp = iter.return) && (yield new __await(temp.call(iter)));
-            } finally {
-              if (error)
-                throw error[0];
-            }
-          }
-        } else {
-          const reply = yield new __await(this.llmProvider.chat(messages, context));
-          yield reply;
-        }
-        yield { reply: "", sources, graphData };
-      } catch (error2) {
-        throw new Error(`[Pipeline] Stream failed: ${error2 instanceof Error ? error2.message : String(error2)}`);
-      }
-    });
-  }
-  /**
-   * Universal retrieval method combining all enabled providers.
-   * Uses an LRU-bounded embedding cache to avoid re-embedding the same query.
-   */
-  async retrieve(query, options) {
-    var _a, _b, _c;
-    const ns = (_a = options.namespace) != null ? _a : this.config.projectId;
-    const topK = (_b = options.topK) != null ? _b : 5;
-    const cacheKey = `${ns}::${query}`;
-    let queryVector = this.embeddingCache.get(cacheKey);
-    const [retrievedVector, graphData] = await Promise.all([
-      queryVector ? Promise.resolve(queryVector) : this.embeddingProvider.embed(query, { taskType: "query" }),
-      this.graphDB && ((_c = this.config.rag) == null ? void 0 : _c.useGraphRetrieval) ? this.graphDB.query(query) : Promise.resolve(void 0)
-    ]);
-    if (!queryVector) {
-      this.embeddingCache.set(cacheKey, retrievedVector);
-      queryVector = retrievedVector;
-    }
-    const sources = await this.vectorDB.query(queryVector, topK, ns, options.filter);
-    return { sources, graphData };
-  }
-  /**
-   * Rewrite the user query for better retrieval performance.
-   */
-  async rewriteQuery(question, history) {
-    const prompt = `
-Given the following conversation history and a new question, rewrite the question to be a better search query for a vector database. 
-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")}
-
-New Question: ${question}
-
-Optimized Search Query:`;
-    const rewrite = await this.llmProvider.chat(
-      [
-        { role: "system", content: "You are an assistant that optimizes search queries for RAG systems." },
-        { role: "user", content: prompt }
-      ],
-      ""
-    );
-    return rewrite.trim() || question;
-  }
-  /**
-   * Generate 3-5 short, relevant questions based on the vector database content.
-   */
-  async getSuggestions(query, namespace) {
-    if (!query || query.trim().length < 3) {
-      return [];
-    }
-    await this.initialize();
-    const ns = namespace != null ? namespace : this.config.projectId;
-    try {
-      const { sources } = await this.retrieve(query, { namespace: ns, topK: 3 });
-      if (sources.length === 0) {
-        return [];
-      }
-      const context = sources.map((s) => s.content).join("\n\n---\n\n");
-      const prompt = `
-Based on the following snippets from a document, what are 3 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.
-Return ONLY a JSON array of strings like ["Question 1", "Question 2", "Question 3"].
-
-Context:
-${context}
-
-Suggestions:`;
-      const response = await this.llmProvider.chat(
-        [
-          { role: "system", content: "You are a helpful assistant that generates search suggestions." },
-          { role: "user", content: prompt }
-        ],
-        ""
-      );
-      const match = response.match(/\[[\s\S]*\]/);
-      if (match) {
-        const suggestions = JSON.parse(match[0]);
-        if (Array.isArray(suggestions)) {
-          return suggestions.map((s) => String(s)).slice(0, 3);
-        }
-      }
-    } catch (error) {
-      console.error("[Pipeline] Failed to generate suggestions:", error);
-    }
-    return [];
-  }
-};
-
-// src/core/ProviderHealthCheck.ts
-var ProviderHealthCheck = class {
-  /**
-   * Validates vector database configuration before initialization.
-   */
-  static async checkVectorProvider(config) {
-    const timestamp = Date.now();
-    const configErrors = await ConfigValidator.validate({
-      projectId: "health-check",
-      vectorDb: config,
-      llm: { provider: "openai", model: "gpt-4o", apiKey: "none" },
-      embedding: { provider: "openai", model: "text-embedding-3-small", apiKey: "none" }
-    });
-    const vectorDbErrors = configErrors.filter((e) => e.field.startsWith("vectorDb"));
-    if (vectorDbErrors.length > 0) {
-      return {
-        healthy: false,
-        provider: config.provider,
-        error: `Configuration validation failed: ${vectorDbErrors.map((e) => e.message).join("; ")}`,
-        timestamp
-      };
-    }
-    try {
-      const checker = await ProviderRegistry.getVectorHealthChecker(config.provider);
-      if (checker) {
-        return await checker.check(config);
-      }
-      return await this.fallbackVectorHealthCheck(config, timestamp);
-    } catch (error) {
-      return {
-        healthy: false,
-        provider: config.provider,
-        error: error instanceof Error ? error.message : String(error),
-        timestamp
-      };
-    }
-  }
-  static async fallbackVectorHealthCheck(config, timestamp) {
-    const opts = config.options || {};
-    const baseUrl = opts.baseUrl || opts.uri;
-    if (baseUrl && baseUrl.startsWith("http")) {
-      try {
-        const response = await fetch(`${baseUrl.replace(/\/$/, "")}/health`);
-        return {
-          healthy: response.ok,
-          provider: config.provider,
-          error: response.ok ? void 0 : `Health check failed: ${response.status}`,
-          timestamp
-        };
-      } catch (e) {
-        return { healthy: false, provider: config.provider, error: "Provider unreachable", timestamp };
-      }
-    }
-    return {
-      healthy: true,
-      provider: config.provider,
-      error: "Pluggable health check not implemented; basic reachability assumed.",
-      timestamp
-    };
-  }
-  /**
-   * Validates LLM provider configuration.
-   */
-  static async checkLLMProvider(config) {
-    const timestamp = Date.now();
-    try {
-      const checker = LLMFactory.getHealthChecker(config.provider);
-      if (checker) {
-        return await checker.check(config);
-      }
-      return {
-        healthy: true,
-        provider: config.provider,
-        error: "Pluggable health check not implemented; basic reachability assumed.",
-        timestamp
-      };
-    } catch (error) {
-      return {
-        healthy: false,
-        provider: config.provider,
-        error: error instanceof Error ? error.message : String(error),
-        timestamp
-      };
-    }
-  }
-  /**
-   * Runs comprehensive health checks on all configured providers in parallel.
-   */
-  static async checkAll(vectorDbConfig, llmConfig, embeddingConfig) {
-    const [vectorDb, llm, embedding] = await Promise.all([
-      this.checkVectorProvider(vectorDbConfig),
-      this.checkLLMProvider(llmConfig),
-      embeddingConfig ? this.checkLLMProvider(embeddingConfig) : Promise.resolve(void 0)
-    ]);
-    return {
-      vectorDb,
-      llm,
-      embedding,
-      allHealthy: vectorDb.healthy && llm.healthy && (!embedding || embedding.healthy)
-    };
-  }
-};
-
-// src/core/VectorPlugin.ts
-var VectorPlugin = class {
-  constructor(hostConfig) {
-    this.config = ConfigResolver.resolve(hostConfig);
-    this.validationPromise = ConfigValidator.validateAndThrow(this.config);
-    this.pipeline = new Pipeline(this.config);
-  }
-  /**
-   * Get the current resolved configuration.
-   */
-  getConfig() {
-    return this.config;
-  }
-  /**
-   * Perform pre-flight health checks on all configured providers.
-   * Useful to verify connectivity before running operations.
-   *
-   * @returns Health status for vector DB, LLM, and embedding providers
-   */
-  async checkHealth() {
-    return ProviderHealthCheck.checkAll(
-      this.config.vectorDb,
-      this.config.llm,
-      this.config.embedding
-    );
-  }
-  /**
-   * Run a chat query.
-   */
-  async chat(message, history = [], namespace) {
-    await this.validationPromise;
-    return this.pipeline.ask(message, history, namespace);
-  }
-  /**
-   * Run a streaming chat query.
-   */
-  chatStream(_0) {
-    return __asyncGenerator(this, arguments, function* (message, history = [], namespace) {
-      yield new __await(this.validationPromise);
-      yield* __yieldStar(this.pipeline.askStream(message, history, namespace));
-    });
+`;
+    if (!((_a = this.config.llm.systemPrompt) == null ? void 0 : _a.includes(CHART_MARKER))) {
+      let cleanPrompt = this.config.llm.systemPrompt || "";
+      cleanPrompt = cleanPrompt.replace(/\n\n### UNIVERSAL UI PROTOCOL[\s\S]*?(?=\n\n|$)/g, "");
+      cleanPrompt = cleanPrompt.replace(/<!-- UI_PROTOCOL_V\d+ -->[\s\S]*?(?=\n\n|$)/g, "");
+      this.config.llm.systemPrompt = cleanPrompt.trim() + chartInstruction;
+    }
+    console.log(`[Pipeline] Initializing with provider: ${this.config.vectorDb.provider}...`);
+    this.vectorDB = await ProviderRegistry.createVectorProvider(this.config.vectorDb);
+    const { llmProvider, embeddingProvider } = await EmbeddingStrategyResolver.resolve(
+      this.config.llm,
+      this.config.embedding
+    );
+    this.llmProvider = llmProvider;
+    this.embeddingProvider = embeddingProvider;
+    if (this.config.graphDb) {
+      this.graphDB = await ProviderRegistry.createGraphProvider(this.config.graphDb);
+      await this.graphDB.initialize();
+      this.entityExtractor = new EntityExtractor(this.llmProvider);
+    }
+    await this.vectorDB.initialize();
+    if (((_b = this.config.rag) == null ? void 0 : _b.architecture) === "agentic") {
+      this.agent = new LangChainAgent(this, this.config);
+      await this.agent.initialize(this.llmProvider);
+    }
+    this.initialised = true;
   }
   /**
-   * Ingest documents into the vector database.
+   * Ingest documents with automatic chunking, embedding, and batch upsert.
+   * Handles retries for transient failures.
    */
   async ingest(documents, namespace) {
-    await this.validationPromise;
-    return this.pipeline.ingest(documents, namespace);
-  }
-  /**
-   * Get auto-suggestions based on a query prefix.
-   */
-  async getSuggestions(query, namespace) {
-    await this.validationPromise;
-    return this.pipeline.getSuggestions(query, namespace);
-  }
-};
-
-// src/config/ConfigBuilder.ts
-var ConfigBuilder = class {
-  /**
-   * Set the project/application ID for namespacing
-   */
-  projectId(id) {
-    this._projectId = id;
-    return this;
-  }
-  /**
-   * Configure the vector database provider
-   */
-  vectorDb(provider, options) {
-    var _a;
-    if (provider === "auto") {
-      this._vectorDb = this._autoDetectVectorDb();
-    } else {
-      this._vectorDb = {
-        provider,
-        indexName: (_a = options == null ? void 0 : options.indexName) != null ? _a : "default",
-        options: __spreadValues({}, options)
-      };
+    await this.initialize();
+    const ns = namespace != null ? namespace : this.config.projectId;
+    const results = [];
+    for (const doc of documents) {
+      try {
+        const chunks = await this.prepareChunks(doc);
+        const vectors = await this.processEmbeddings(chunks);
+        const upsertDocs = chunks.map((chunk, i) => ({
+          id: chunk.id,
+          vector: vectors[i],
+          content: chunk.content,
+          metadata: chunk.metadata
+        }));
+        const totalProcessed = await this.processUpserts(upsertDocs, ns);
+        results.push({
+          docId: doc.docId,
+          chunksIngested: totalProcessed
+        });
+        if (this.graphDB && this.entityExtractor) {
+          await this.processGraphIngestion(doc.docId, chunks);
+        }
+      } catch (error) {
+        console.error(`[Pipeline] Failed to ingest document ${doc.docId}:`, error);
+        results.push({ docId: doc.docId, chunksIngested: 0 });
+      }
     }
-    return this;
+    return results;
   }
   /**
-   * Configure the LLM provider for chat
+   * Step 1: Chunk the document content.
    */
-  llm(provider, model, apiKey, options) {
+  async prepareChunks(doc) {
     var _a, _b;
-    if (provider === "auto") {
-      this._llm = this._autoDetectLLM();
-    } else {
-      this._llm = {
-        provider,
-        model: model != null ? model : "default-model",
-        apiKey,
-        systemPrompt: options == null ? void 0 : options.systemPrompt,
-        maxTokens: (_a = options == null ? void 0 : options.maxTokens) != null ? _a : 1024,
-        temperature: (_b = options == null ? void 0 : options.temperature) != null ? _b : 0.7,
-        baseUrl: options == null ? void 0 : options.baseUrl,
-        options
-      };
-    }
-    return this;
-  }
-  /**
-   * Configure the embedding provider
-   */
-  embedding(provider, model, apiKey, options) {
-    if (provider === "auto") {
-      this._embedding = this._autoDetectEmbedding();
-    } else {
-      this._embedding = {
-        provider,
-        model: model != null ? model : "default-embedding",
-        apiKey,
-        baseUrl: options == null ? void 0 : options.baseUrl,
-        options
-      };
+    if (this.llamaIngestor) {
+      return await this.llamaIngestor.chunk(doc.content, {
+        docId: doc.docId,
+        metadata: doc.metadata,
+        chunkSize: (_a = this.config.rag) == null ? void 0 : _a.chunkSize,
+        chunkOverlap: (_b = this.config.rag) == null ? void 0 : _b.chunkOverlap
+      });
     }
-    return this;
-  }
-  /**
-   * Set RAG-specific pipeline parameters
-   */
-  rag(options) {
-    var _a;
-    this._rag = __spreadValues(__spreadValues({}, (_a = this._rag) != null ? _a : {}), options);
-    return this;
-  }
-  /**
-   * Set UI branding and appearance options.
-   * Accepts the full UIConfig interface.
-   */
-  ui(options) {
-    this._ui = options;
-    return this;
+    return this.chunker.chunk(doc.content, {
+      docId: doc.docId,
+      metadata: doc.metadata
+    });
   }
   /**
-   * Build and return the final RagConfig.
-   * Throws if required fields (projectId, vectorDb, llm, embedding) are not set.
+   * Step 2: Generate embeddings for chunks with retry logic.
+   * Uses batchEmbed when available for efficiency; falls back to sequential embedding.
    */
-  build() {
-    var _a;
-    const missing = [];
-    if (!this._projectId) missing.push('projectId (call .projectId("my-app"))');
-    if (!this._vectorDb) missing.push('vectorDb (call .vectorDb("pinecone", { ... }))');
-    if (!this._llm) missing.push('llm (call .llm("openai", "gpt-4o", apiKey))');
-    if (!this._embedding) missing.push('embedding (call .embedding("openai", "text-embedding-3-small"))');
-    if (missing.length > 0) {
+  async processEmbeddings(chunks) {
+    const embedBatchOptions = {
+      batchSize: 50,
+      maxRetries: 3,
+      initialDelayMs: 100
+    };
+    const vectors = await BatchProcessor.mapWithRetry(
+      chunks.map((c) => c.content),
+      (text) => this.embeddingProvider.embed(text, { taskType: "document" }),
+      embedBatchOptions
+    );
+    if (vectors.length !== chunks.length) {
       throw new Error(
-        `[ConfigBuilder] Cannot build \u2014 required fields are missing:
-  ${missing.join("\n  ")}`
+        `[Pipeline] Embedding mismatch: got ${vectors.length} vectors for ${chunks.length} chunks. Check embedding provider logs for individual chunk failures.`
       );
     }
-    return __spreadValues({
-      projectId: this._projectId,
-      vectorDb: this._vectorDb,
-      llm: this._llm,
-      embedding: this._embedding,
-      ui: this._rag ? this._ui : void 0,
-      rag: (_a = this._rag) != null ? _a : { chunkSize: 1e3, chunkOverlap: 200, topK: 5 }
-    }, this._ui ? { ui: this._ui } : {});
+    return vectors;
   }
   /**
-   * Build and return as JSON for serialization
-   */
-  toJSON() {
-    return JSON.stringify(this.build());
-  }
-  // ============================================================================
-  // Private helper methods for auto-detection
-  // ============================================================================
-  _autoDetectVectorDb() {
-    if (process.env.PINECONE_API_KEY && process.env.PINECONE_INDEX) {
-      return { provider: "pinecone", indexName: process.env.PINECONE_INDEX, options: { apiKey: process.env.PINECONE_API_KEY } };
-    }
-    if (process.env.QDRANT_URL) {
-      return { provider: "qdrant", indexName: process.env.QDRANT_COLLECTION || "documents", options: { url: process.env.QDRANT_URL, apiKey: process.env.QDRANT_API_KEY } };
-    }
-    if (process.env.DATABASE_URL) {
-      return { provider: "postgresql", indexName: process.env.PG_TABLE || "documents", options: { connectionString: process.env.DATABASE_URL } };
-    }
-    if (process.env.MONGODB_URI) {
-      return { provider: "mongodb", indexName: process.env.MONGODB_COLLECTION || "documents", options: { uri: process.env.MONGODB_URI, database: process.env.MONGODB_DB || "ai_db", collection: process.env.MONGODB_COLLECTION || "documents" } };
-    }
-    if (process.env.REDIS_URL) {
-      return { provider: "redis", indexName: process.env.REDIS_INDEX || "documents", options: { url: process.env.REDIS_URL } };
-    }
-    return { provider: "qdrant", indexName: "documents", options: { url: process.env.QDRANT_URL || "http://localhost:6333" } };
-  }
-  _autoDetectLLM() {
-    if (process.env.OPENAI_API_KEY) {
-      return { provider: "openai", model: process.env.OPENAI_MODEL || "gpt-4o-mini", apiKey: process.env.OPENAI_API_KEY, maxTokens: parseInt(process.env.OPENAI_MAX_TOKENS || "1024"), temperature: parseFloat(process.env.OPENAI_TEMPERATURE || "0.7") };
-    }
-    if (process.env.ANTHROPIC_API_KEY) {
-      return { provider: "anthropic", model: process.env.ANTHROPIC_MODEL || "claude-3-haiku-20240307", apiKey: process.env.ANTHROPIC_API_KEY, maxTokens: parseInt(process.env.ANTHROPIC_MAX_TOKENS || "1024"), temperature: parseFloat(process.env.ANTHROPIC_TEMPERATURE || "0.7") };
-    }
-    if (process.env.OLLAMA_BASE_URL) {
-      return { provider: "ollama", model: process.env.OLLAMA_MODEL || "mistral", baseUrl: process.env.OLLAMA_BASE_URL, maxTokens: parseInt(process.env.OLLAMA_MAX_TOKENS || "1024"), temperature: parseFloat(process.env.OLLAMA_TEMPERATURE || "0.7") };
-    }
-    return { provider: "openai", model: "gpt-4o-mini", apiKey: process.env.OPENAI_API_KEY };
-  }
-  _autoDetectEmbedding() {
-    if (process.env.EMBEDDING_PROVIDER) {
-      return { provider: process.env.EMBEDDING_PROVIDER, model: process.env.EMBEDDING_MODEL || "default", apiKey: process.env.EMBEDDING_API_KEY, baseUrl: process.env.EMBEDDING_BASE_URL };
-    }
-    return { provider: "openai", model: "text-embedding-3-small", apiKey: process.env.OPENAI_API_KEY };
-  }
-};
-var PRESETS = {
-  /** OpenAI + Pinecone: Production-ready cloud setup */
-  "openai-pinecone": { vectorDb: "pinecone", llm: "openai", embedding: "openai" },
-  /** Claude + Qdrant: Open-source vector DB + proprietary LLM */
-  "claude-qdrant": { vectorDb: "qdrant", llm: "anthropic", embedding: "openai" },
-  /** Local development: Ollama + local Qdrant */
-  "local-dev": { vectorDb: "qdrant", llm: "ollama", embedding: "ollama" },
-  /** Fully open-source: Ollama LLM + Qdrant + Ollama embeddings */
-  "fully-open-source": { vectorDb: "qdrant", llm: "ollama", embedding: "ollama" },
-  /** PostgreSQL stack: pgvector + OpenAI */
-  "postgres-openai": { vectorDb: "postgresql", llm: "openai", embedding: "openai" },
-  /** Enterprise MongoDB: MongoDB Atlas with OpenAI */
-  "mongodb-openai": { vectorDb: "mongodb", llm: "openai", embedding: "openai" },
-  /** Redis stack for caching + search */
-  "redis-openai": { vectorDb: "redis", llm: "openai", embedding: "openai" }
-};
-function createFromPreset(presetName) {
-  const preset = PRESETS[presetName];
-  return new ConfigBuilder().vectorDb(preset.vectorDb, { apiKey: process.env[`${preset.vectorDb.toUpperCase()}_API_KEY`] }).llm(preset.llm, void 0, process.env[`${preset.llm.toUpperCase()}_API_KEY`]).embedding(preset.embedding, void 0, process.env[`${preset.embedding.toUpperCase()}_API_KEY`]);
-}
-
-// src/utils/DocumentParser.ts
-var DocumentParser = class {
+   * Step 3: Upsert chunks to vector database with retry logic.
+   */
+  async processUpserts(upsertDocs, namespace) {
+    const upsertBatchOptions = {
+      batchSize: 100,
+      maxRetries: 3,
+      initialDelayMs: 100
+    };
+    const upsertResult = await BatchProcessor.processBatch(
+      upsertDocs,
+      (batch) => this.vectorDB.batchUpsert(batch, namespace),
+      upsertBatchOptions
+    );
+    if (upsertResult.errors.length > 0) {
+      console.warn(`[Pipeline] Ingestion: ${upsertResult.errors.length} batches failed`);
+    }
+    return upsertResult.totalProcessed;
+  }
   /**
-   * Extract text from a File or Buffer based on its type.
+   * Step 4: Optional graph-based entity extraction and ingestion.
    */
-  static async parse(file, fileName, mimeType) {
+  async processGraphIngestion(docId, chunks) {
+    console.log(`[Pipeline] Extracting entities for doc ${docId} (${chunks.length} chunks)...`);
+    const extractionOptions = {
+      batchSize: 2,
+      // Low concurrency for LLM extraction
+      maxRetries: 1,
+      initialDelayMs: 500
+    };
+    await BatchProcessor.processBatch(
+      chunks,
+      async (batch) => {
+        for (const chunk of batch) {
+          try {
+            const { nodes, edges } = await this.entityExtractor.extract(chunk.content);
+            if (nodes.length > 0) await this.graphDB.addNodes(nodes);
+            if (edges.length > 0) await this.graphDB.addEdges(edges);
+          } catch (err) {
+            console.warn(`[Pipeline] Entity extraction failed for chunk:`, err);
+          }
+        }
+      },
+      extractionOptions
+    );
+  }
+  async ask(question, history = [], namespace) {
     var _a;
-    const extension = (_a = fileName.split(".").pop()) == null ? void 0 : _a.toLowerCase();
-    if (extension === "txt" || extension === "md" || mimeType === "text/plain" || mimeType === "text/markdown") {
-      return this.readAsText(file);
-    }
-    if (extension === "json" || mimeType === "application/json") {
-      const text = await this.readAsText(file);
-      try {
-        const obj = JSON.parse(text);
-        return JSON.stringify(obj, null, 2);
-      } catch (e) {
-        return text;
-      }
-    }
-    if (extension === "csv" || mimeType === "text/csv") {
-      return this.readAsText(file);
+    await this.initialize();
+    if (((_a = this.config.rag) == null ? void 0 : _a.architecture) === "agentic" && this.agent) {
+      console.log("[Pipeline] \u{1F916} Executing in Agentic Mode...");
+      const agentReply = await this.agent.run(question, history);
+      return { reply: agentReply, sources: [] };
     }
-    if (extension === "pdf" || mimeType === "application/pdf") {
-      try {
-        const pdf = await import("pdf-parse");
-        const buffer = Buffer.isBuffer(file) ? file : Buffer.from(await file.arrayBuffer());
-        const data = await pdf.default(buffer);
-        return data.text;
-      } catch (err) {
-        console.warn('[DocumentParser] PDF parsing failed. Make sure "pdf-parse" is installed.', err);
-        return `[PDF Parsing Error for ${fileName}]`;
+    const stream = this.askStream(question, history, namespace);
+    let reply = "";
+    let sources = [];
+    let graphData;
+    try {
+      for (var iter = __forAwait(stream), more, temp, error; more = !(temp = await iter.next()).done; more = false) {
+        const chunk = temp.value;
+        if (typeof chunk === "string") {
+          reply += chunk;
+        } else if ("sources" in chunk) {
+          sources = chunk.sources;
+          graphData = chunk.graphData;
+        }
       }
-    }
-    if (extension === "docx" || mimeType === "application/vnd.openxmlformats-officedocument.wordprocessingml.document") {
+    } catch (temp) {
+      error = [temp];
+    } finally {
       try {
-        const mammoth = await import("mammoth");
-        const buffer = Buffer.isBuffer(file) ? file : Buffer.from(await file.arrayBuffer());
-        const result = await mammoth.extractRawText({ buffer });
-        return result.value;
-      } catch (err) {
-        console.warn('[DocumentParser] DOCX parsing failed. Make sure "mammoth" is installed.', err);
-        return `[DOCX Parsing Error for ${fileName}]`;
+        more && (temp = iter.return) && await temp.call(iter);
+      } finally {
+        if (error)
+          throw error[0];
       }
     }
-    try {
-      return await this.readAsText(file);
-    } catch (e) {
-      throw new Error(`[DocumentParser] Unsupported file format: ${fileName} (${mimeType})`);
-    }
-  }
-  static async readAsText(file) {
-    if (Buffer.isBuffer(file)) {
-      return file.toString("utf-8");
-    }
-    return await file.text();
+    return { reply, sources, graphData };
   }
-};
-
-// src/server.ts
-init_BaseVectorProvider();
-init_PineconeProvider();
-init_PostgreSQLProvider();
+  /**
+   * High-performance streaming RAG flow.
+   * Yields text chunks first, then the retrieval metadata at the end.
+   */
+  askStream(_0) {
+    return __asyncGenerator(this, arguments, function* (question, history = [], namespace) {
+      var _a, _b, _c, _d, _e, _f, _g;
+      yield new __await(this.initialize());
+      const ns = namespace != null ? namespace : this.config.projectId;
+      const topK = (_b = (_a = this.config.rag) == null ? void 0 : _a.topK) != null ? _b : 5;
+      const scoreThreshold = (_d = (_c = this.config.rag) == null ? void 0 : _c.scoreThreshold) != null ? _d : 0;
+      try {
+        let searchQuery = question;
+        if ((_e = this.config.rag) == null ? void 0 : _e.useQueryTransformation) {
+          searchQuery = yield new __await(this.rewriteQuery(question, history));
+        }
+        const hints = QueryProcessor.extractQueryFieldHints(question, (_f = this.config.rag) == null ? void 0 : _f.filterableFields);
+        const filter = QueryProcessor.buildQueryFilter(question, hints);
+        console.log(`[Pipeline] \u{1F9E9} Extracted filters:`, JSON.stringify(filter));
+        const { sources: rawSources, graphData } = yield new __await(this.retrieve(searchQuery, {
+          namespace: ns,
+          topK: topK * 2,
+          filter
+        }));
+        let sources = rawSources.filter((m) => m.score >= scoreThreshold);
+        if ((_g = this.config.rag) == null ? void 0 : _g.useReranking) {
+          sources = yield new __await(this.reranker.rerank(sources, question, topK));
+        } else {
+          sources = sources.slice(0, topK);
+        }
+        let context = sources.length ? sources.map((m, i) => `[Source ${i + 1}]
+${m.content}`).join("\n\n---\n\n") : "No relevant context found.";
+        if (graphData && graphData.nodes.length > 0) {
+          const graphContext = graphData.nodes.map(
+            (n) => `Entity: ${n.label} (${n.id})${n.properties ? " - " + JSON.stringify(n.properties) : ""}`
+          ).join("\n");
+          context = `GRAPH KNOWLEDGE:
+${graphContext}
 
-// src/providers/vectordb/MultiTablePostgresProvider.ts
-var import_pg2 = require("pg");
-init_BaseVectorProvider();
-var MultiTablePostgresProvider = class extends BaseVectorProvider {
-  constructor(config) {
-    var _a, _b, _c, _d, _e;
-    super(config);
-    const opts = config.options || {};
-    if (!opts.connectionString) {
-      throw new Error("[MultiTablePostgresProvider] options.connectionString is required");
-    }
-    this.connectionString = opts.connectionString;
-    this.dimensions = (_a = opts.dimensions) != null ? _a : 768;
-    const rawTables = (_c = (_b = opts.tables) != null ? _b : process.env.VECTOR_DB_TABLES) != null ? _c : "";
-    this.tables = typeof rawTables === "string" ? rawTables.split(",").map((t) => t.trim()).filter(Boolean) : rawTables;
-    if (this.tables.length === 0) {
-      console.warn(
-        "[MultiTablePostgresProvider] No tables configured. Set VECTOR_DB_TABLES as a comma-separated list of table names or pass options.tables."
-      );
-    }
-    const rawSearchFields = (_e = (_d = opts.searchFields) != null ? _d : process.env.VECTOR_DB_SEARCH_FIELDS) != null ? _e : ["name", "product_name", "productname", "title"];
-    this.searchFields = typeof rawSearchFields === "string" ? rawSearchFields.split(",").map((f) => f.trim()).filter(Boolean) : rawSearchFields;
-  }
-  async initialize() {
-    this.pool = new import_pg2.Pool({ connectionString: this.connectionString });
-    const client = await this.pool.connect();
-    try {
-      const res = await client.query(`
-        SELECT table_name 
-        FROM information_schema.columns 
-        WHERE column_name = 'embedding' 
-        AND table_schema = 'public'
-      `);
-      const discoveredTables = res.rows.map((r) => r.table_name);
-      if (this.tables.length === 0) {
-        this.tables = discoveredTables;
-      } else {
-        const staticTables = [...this.tables];
-        this.tables = staticTables.filter((t) => discoveredTables.includes(t));
-        if (this.tables.length < staticTables.length) {
-          const missing = staticTables.filter((t) => !discoveredTables.includes(t));
-          console.warn(`[MultiTablePostgresProvider] Some configured tables were skipped (missing 'embedding' column): ${missing.join(", ")}`);
+VECTOR CONTEXT:
+${context}`;
         }
+        const messages = [...history, { role: "user", content: question }];
+        if (this.llmProvider.chatStream) {
+          const stream = this.llmProvider.chatStream(messages, context);
+          if (!stream) {
+            throw new Error(`[Pipeline] ${this.config.llm.provider} chatStream returned undefined`);
+          }
+          try {
+            for (var iter = __forAwait(stream), more, temp, error; more = !(temp = yield new __await(iter.next())).done; more = false) {
+              const chunk = temp.value;
+              yield chunk;
+            }
+          } catch (temp) {
+            error = [temp];
+          } finally {
+            try {
+              more && (temp = iter.return) && (yield new __await(temp.call(iter)));
+            } finally {
+              if (error)
+                throw error[0];
+            }
+          }
+        } else {
+          const reply = yield new __await(this.llmProvider.chat(messages, context));
+          yield reply;
+        }
+        const uiTransformation = UITransformer.transform(question, sources);
+        yield {
+          reply: "",
+          sources,
+          graphData,
+          ui_transformation: uiTransformation
+        };
+      } catch (error2) {
+        throw new Error(`[Pipeline] Stream failed: ${error2 instanceof Error ? error2.message : String(error2)}`);
       }
-      if (this.tables.length === 0) {
-        console.warn('[MultiTablePostgresProvider] No tables with "embedding" columns found in the database.');
-      } else {
-        console.log(
-          `[MultiTablePostgresProvider] Connected. Searching across ${this.tables.length} table(s): ${this.tables.join(", ")}`
-        );
-      }
-    } finally {
-      client.release();
+    });
+  }
+  /**
+   * Universal retrieval method combining all enabled providers.
+   * Uses an LRU-bounded embedding cache to avoid re-embedding the same query.
+   */
+  async retrieve(query, options) {
+    var _a, _b, _c;
+    const ns = (_a = options.namespace) != null ? _a : this.config.projectId;
+    const topK = (_b = options.topK) != null ? _b : 5;
+    const cacheKey = `${ns}::${query}`;
+    let queryVector = this.embeddingCache.get(cacheKey);
+    const [retrievedVector, graphData] = await Promise.all([
+      queryVector ? Promise.resolve(queryVector) : this.embeddingProvider.embed(query, { taskType: "query" }),
+      this.graphDB && ((_c = this.config.rag) == null ? void 0 : _c.useGraphRetrieval) ? this.graphDB.query(query) : Promise.resolve(void 0)
+    ]);
+    if (!queryVector) {
+      this.embeddingCache.set(cacheKey, retrievedVector);
+      queryVector = retrievedVector;
     }
+    const sources = await this.vectorDB.query(queryVector, topK, ns, options.filter);
+    return { sources, graphData };
   }
   /**
-   * Upsert is not supported for MultiTablePostgresProvider as it's designed for 
-   * searching across pre-existing tables with varying schemas.
-   */
-  async upsert(_doc, _namespace) {
-    throw new Error(
-      "[MultiTablePostgresProvider] upsert() is not supported in multi-table mode. Please use the standard PostgreSQLProvider for single-table managed indices."
-    );
-  }
-  /**
-   * Batch upsert is not supported for MultiTablePostgresProvider.
+   * Rewrite the user query for better retrieval performance.
    */
-  async batchUpsert(_docs, _namespace) {
-    throw new Error(
-      "[MultiTablePostgresProvider] batchUpsert() is not supported in multi-table mode."
+  async rewriteQuery(question, history) {
+    const prompt = `
+Given the following conversation history and a new question, rewrite the question to be a better search query for a vector database. 
+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")}
+
+New Question: ${question}
+
+Optimized Search Query:`;
+    const rewrite = await this.llmProvider.chat(
+      [
+        { role: "system", content: "You are an assistant that optimizes search queries for RAG systems." },
+        { role: "user", content: prompt }
+      ],
+      ""
     );
+    return rewrite.trim() || question;
   }
   /**
-   * Query all configured tables and merge results, sorted by cosine similarity score.
+   * Generate 3-5 short, relevant questions based on the vector database content.
    */
-  async query(vector, topK, _namespace, _filter) {
-    var _a, _b, _c;
-    if (!this.pool) {
-      throw new Error("[MultiTablePostgresProvider] Provider not initialized. Call initialize() first.");
+  async getSuggestions(query, namespace) {
+    if (!query || query.trim().length < 3) {
+      return [];
     }
-    const vectorLiteral = `[${vector.join(",")}]`;
-    const allResults = [];
-    console.log(`[MultiTablePostgresProvider] --- Starting Multi-Table Search ---`);
-    const queryText = _filter == null ? void 0 : _filter.queryText;
-    const entityHints = Array.isArray(_filter == null ? void 0 : _filter.__entityHints) ? _filter.__entityHints.filter(
-      (hint) => typeof hint === "object" && hint !== null && typeof hint.value === "string"
-    ).map((hint) => hint.value.trim().toLowerCase()).filter(Boolean) : [];
-    console.log(`[MultiTablePostgresProvider] queryText: "${queryText}"`);
-    console.log(`[MultiTablePostgresProvider] entityHints: [${entityHints.join(", ")}]`);
-    const getDynamicKeywordQuery = () => {
-      if (entityHints.length > 0) {
-        return entityHints.map((h) => h.includes(" ") ? `"${h}"` : h).join(" & ");
-      }
-      if (queryText) {
-        return queryText.toLowerCase().replace(/\b(show|me|the|product[s]?|item[s]?|card[s]?|of|category|find|list|browse|what|are|display|all|under|for|in|with|about)\b/g, "").trim().replace(/\s+/g, " & ");
+    await this.initialize();
+    const ns = namespace != null ? namespace : this.config.projectId;
+    try {
+      const { sources } = await this.retrieve(query, { namespace: ns, topK: 3 });
+      if (sources.length === 0) {
+        return [];
       }
-      return "";
-    };
-    const dynamicKeywordQuery = getDynamicKeywordQuery();
-    const queryPromises = this.tables.map(async (table) => {
-      try {
-        let sqlQuery = "";
-        let params = [];
-        if (queryText) {
-          const hasEntityHints = entityHints.length > 0;
-          const exactNameScoreExpr = hasEntityHints ? `+ (
-                 SELECT COALESCE(MAX(
-                   CASE WHEN LOWER(val) IN (${entityHints.map((h) => `'${h.replace(/'/g, "''")}'`).join(", ")})
-                   THEN 1.0 ELSE 0.0 END
-                 ), 0)
-                 FROM jsonb_each_text(to_jsonb(t)) AS kv(key, val)
-                 WHERE key IN (${this.searchFields.map((f) => `'${f}'`).join(", ")})
-               ) * 3.0` : "";
-          sqlQuery = `
-            SELECT *, 
-             (1 - (embedding <=> $1::vector)) AS vector_score,
-             COALESCE(ts_rank(to_tsvector('english', (to_jsonb(t) - 'embedding')::text), to_tsquery('english', $2)), 0) AS keyword_score,
-             ((1 - (embedding <=> $1::vector)) + (COALESCE(ts_rank(to_tsvector('english', (to_jsonb(t) - 'embedding')::text), to_tsquery('english', $2)), 0) * 2.0) ${exactNameScoreExpr}) AS hybrid_score
-            FROM "${table}" t
-            ORDER BY hybrid_score DESC
-            LIMIT 50
-          `;
-          params = [vectorLiteral, dynamicKeywordQuery];
-        } else {
-          sqlQuery = `
-            SELECT *, 
-             (1 - (embedding <=> $1::vector)) AS hybrid_score
-            FROM "${table}" t
-            ORDER BY hybrid_score DESC
-            LIMIT 50
-          `;
-          params = [vectorLiteral];
-        }
-        const result = await this.pool.query(sqlQuery, params);
-        if (result.rowCount && result.rowCount > 0) {
-          console.log(`   \u2705 Table "${table}": Found ${result.rowCount} potential matches. Top score: ${result.rows[0].hybrid_score.toFixed(4)}`);
-        } else {
-          console.log(`   \u26AA Table "${table}": No relevant matches found.`);
-        }
-        const tableResults = [];
-        for (const row of result.rows) {
-          const _a2 = row, { hybrid_score, id } = _a2, rest = __objRest(_a2, ["hybrid_score", "id"]);
-          delete rest.embedding;
-          delete rest.vector_score;
-          delete rest.keyword_score;
-          delete rest.exact_name_score;
-          const content = `[TYPE: ${table.replace(/s$/, "").toUpperCase()}]
-` + Object.entries(rest).filter(([k, v]) => v !== null && typeof v !== "object" && k !== "id").map(([k, v]) => `${k}: ${v}`).join("\n");
-          tableResults.push({
-            id: `${table}-${id}`,
-            score: parseFloat(String(hybrid_score)),
-            content,
-            metadata: __spreadProps(__spreadValues({}, rest), { source_table: table })
-          });
+      const context = sources.map((s) => s.content).join("\n\n---\n\n");
+      const prompt = `
+Based on the following snippets from a document, what are 3 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.
+Return ONLY a JSON array of strings like ["Question 1", "Question 2", "Question 3"].
+
+Context:
+${context}
+
+Suggestions:`;
+      const response = await this.llmProvider.chat(
+        [
+          { role: "system", content: "You are a helpful assistant that generates search suggestions." },
+          { role: "user", content: prompt }
+        ],
+        ""
+      );
+      const match = response.match(/\[[\s\S]*\]/);
+      if (match) {
+        const suggestions = JSON.parse(match[0]);
+        if (Array.isArray(suggestions)) {
+          return suggestions.map((s) => String(s)).slice(0, 3);
         }
-        return tableResults;
-      } catch (err) {
-        console.error(
-          `[MultiTablePostgresProvider] Error querying table "${table}":`,
-          err.message
-        );
-        return [];
       }
-    });
-    const resultsArray = await Promise.all(queryPromises);
-    for (const tableResults of resultsArray) {
-      allResults.push(...tableResults);
-    }
-    const resultsByTable = {};
-    for (const res of allResults) {
-      const table = (_a = res.metadata) == null ? void 0 : _a.source_table;
-      if (!resultsByTable[table]) resultsByTable[table] = [];
-      resultsByTable[table].push(res);
+    } catch (error) {
+      console.error("[Pipeline] Failed to generate suggestions:", error);
     }
-    const balancedResults = [];
-    const tables = Object.keys(resultsByTable);
-    for (const table of tables) {
-      balancedResults.push(...resultsByTable[table].slice(0, 3));
+    return [];
+  }
+};
+
+// src/core/ProviderHealthCheck.ts
+var ProviderHealthCheck = class {
+  /**
+   * Validates vector database configuration before initialization.
+   */
+  static async checkVectorProvider(config) {
+    const timestamp = Date.now();
+    const configErrors = await ConfigValidator.validate({
+      projectId: "health-check",
+      vectorDb: config,
+      llm: { provider: "openai", model: "gpt-4o", apiKey: "none" },
+      embedding: { provider: "openai", model: "text-embedding-3-small", apiKey: "none" }
+    });
+    const vectorDbErrors = configErrors.filter((e) => e.field.startsWith("vectorDb"));
+    if (vectorDbErrors.length > 0) {
+      return {
+        healthy: false,
+        provider: config.provider,
+        error: `Configuration validation failed: ${vectorDbErrors.map((e) => e.message).join("; ")}`,
+        timestamp
+      };
     }
-    const finalSorted = balancedResults.sort((a, b) => b.score - a.score);
-    if (finalSorted.length > 0) {
-      console.log(`[MultiTablePostgresProvider] --- Search Complete ---`);
-      console.log(`[MultiTablePostgresProvider] Final top match from "${(_c = (_b = finalSorted[0].metadata) == null ? void 0 : _b.source_table) != null ? _c : "unknown"}" with score ${finalSorted[0].score.toFixed(4)}`);
+    try {
+      const checker = await ProviderRegistry.getVectorHealthChecker(config.provider);
+      if (checker) {
+        return await checker.check(config);
+      }
+      return await this.fallbackVectorHealthCheck(config, timestamp);
+    } catch (error) {
+      return {
+        healthy: false,
+        provider: config.provider,
+        error: error instanceof Error ? error.message : String(error),
+        timestamp
+      };
     }
-    return finalSorted.slice(0, Math.max(topK, 15));
-  }
-  async delete(_id, _namespace) {
-    console.warn("[MultiTablePostgresProvider] delete() is a no-op for multi-table mode.");
   }
-  async deleteNamespace(_namespace) {
-    console.warn("[MultiTablePostgresProvider] deleteNamespace() is a no-op for multi-table mode.");
+  static async fallbackVectorHealthCheck(config, timestamp) {
+    const opts = config.options || {};
+    const baseUrl = opts.baseUrl || opts.uri;
+    if (baseUrl && baseUrl.startsWith("http")) {
+      try {
+        const response = await fetch(`${baseUrl.replace(/\/$/, "")}/health`);
+        return {
+          healthy: response.ok,
+          provider: config.provider,
+          error: response.ok ? void 0 : `Health check failed: ${response.status}`,
+          timestamp
+        };
+      } catch (e) {
+        return { healthy: false, provider: config.provider, error: "Provider unreachable", timestamp };
+      }
+    }
+    return {
+      healthy: true,
+      provider: config.provider,
+      error: "Pluggable health check not implemented; basic reachability assumed.",
+      timestamp
+    };
   }
-  async ping() {
+  /**
+   * Validates LLM provider configuration.
+   */
+  static async checkLLMProvider(config) {
+    const timestamp = Date.now();
     try {
-      await this.pool.query("SELECT 1");
-      return true;
-    } catch (e) {
-      return false;
+      const checker = LLMFactory.getHealthChecker(config.provider);
+      if (checker) {
+        return await checker.check(config);
+      }
+      return {
+        healthy: true,
+        provider: config.provider,
+        error: "Pluggable health check not implemented; basic reachability assumed.",
+        timestamp
+      };
+    } catch (error) {
+      return {
+        healthy: false,
+        provider: config.provider,
+        error: error instanceof Error ? error.message : String(error),
+        timestamp
+      };
     }
   }
-  async disconnect() {
-    if (this.pool) {
-      await this.pool.end();
-    }
+  /**
+   * Runs comprehensive health checks on all configured providers in parallel.
+   */
+  static async checkAll(vectorDbConfig, llmConfig, embeddingConfig) {
+    const [vectorDb, llm, embedding] = await Promise.all([
+      this.checkVectorProvider(vectorDbConfig),
+      this.checkLLMProvider(llmConfig),
+      embeddingConfig ? this.checkLLMProvider(embeddingConfig) : Promise.resolve(void 0)
+    ]);
+    return {
+      vectorDb,
+      llm,
+      embedding,
+      allHealthy: vectorDb.healthy && llm.healthy && (!embedding || embedding.healthy)
+    };
   }
 };
 
-// src/server.ts
-init_MongoDBProvider();
-init_MilvusProvider();
-init_QdrantProvider();
-init_ChromaDBProvider();
-init_RedisProvider();
-init_WeaviateProvider();
-init_UniversalVectorProvider();
-
-// src/handlers/index.ts
-var import_server = require("next/server");
-
-// src/utils/UITransformer.ts
-var UITransformer = class {
+// src/core/VectorPlugin.ts
+var VectorPlugin = class {
+  constructor(hostConfig) {
+    this.config = ConfigResolver.resolve(hostConfig);
+    this.validationPromise = ConfigValidator.validateAndThrow(this.config);
+    this.pipeline = new Pipeline(this.config);
+  }
   /**
-   * Main transformation method
-   * Analyzes user query and retrieved data to determine the best visualization format
-   *
-   * @param userQuery - The original user question/query
-   * @param retrievedData - Vector database retrieval results
-   * @returns Structured JSON response for UI rendering
+   * Get the current resolved configuration.
    */
-  static transform(userQuery, retrievedData) {
-    if (!retrievedData || retrievedData.length === 0) {
-      return this.createTextResponse("No data available", "No relevant data found for your query.");
-    }
-    const analysis = this.analyzeData(userQuery, retrievedData);
-    switch (analysis.suggestedType) {
-      case "product_carousel":
-        return this.transformToProductCarousel(retrievedData);
-      case "pie_chart":
-        return this.transformToPieChart(retrievedData);
-      case "bar_chart":
-        return this.transformToBarChart(retrievedData);
-      case "line_chart":
-        return this.transformToLineChart(retrievedData);
-      case "table":
-        return this.transformToTable(retrievedData);
-      default:
-        return this.transformToText(retrievedData);
-    }
+  getConfig() {
+    return this.config;
   }
   /**
-   * Analyzes the data and query to suggest the best visualization type
+   * Perform pre-flight health checks on all configured providers.
+   * Useful to verify connectivity before running operations.
+   *
+   * @returns Health status for vector DB, LLM, and embedding providers
    */
-  static analyzeData(query, data) {
-    const queryLower = query.toLowerCase();
-    const hasProducts = data.some(
-      (item) => this.isProductData(item)
-    );
-    const hasTimeSeries = data.some(
-      (item) => this.isTimeSeriesData(item)
+  async checkHealth() {
+    return ProviderHealthCheck.checkAll(
+      this.config.vectorDb,
+      this.config.llm,
+      this.config.embedding
     );
-    const hasCategories = this.detectCategories(data).length > 0;
-    const isDistributionQuery = queryLower.includes("distribution") || queryLower.includes("breakdown") || queryLower.includes("percentage") || queryLower.includes("proportion");
-    const isComparisonQuery = queryLower.includes("compare") || queryLower.includes("vs") || queryLower.includes("difference");
-    const isTrendQuery = queryLower.includes("trend") || queryLower.includes("over time") || queryLower.includes("growth") || queryLower.includes("decline");
-    if (hasProducts && !hasTimeSeries && !isDistributionQuery) {
-      return { suggestedType: "product_carousel", confidence: 0.95, hasProducts, hasTimeSeries, hasCategories };
-    }
-    if (isTrendQuery && hasTimeSeries) {
-      return { suggestedType: "line_chart", confidence: 0.9, hasProducts, hasTimeSeries, hasCategories };
-    }
-    if (isDistributionQuery && hasCategories) {
-      return { suggestedType: "pie_chart", confidence: 0.85, hasProducts, hasTimeSeries, hasCategories };
-    }
-    if (isComparisonQuery && hasCategories && data.length > 2) {
-      return { suggestedType: "bar_chart", confidence: 0.8, hasProducts, hasTimeSeries, hasCategories };
-    }
-    if (data.length > 5 && this.hasMultipleFields(data)) {
-      return { suggestedType: "table", confidence: 0.75, hasProducts, hasTimeSeries, hasCategories };
-    }
-    return { suggestedType: "text", confidence: 0.5, hasProducts, hasTimeSeries, hasCategories };
   }
   /**
-   * Transform data to product carousel format
+   * Run a chat query.
    */
-  static transformToProductCarousel(data) {
-    const products = data.filter((item) => this.isProductData(item)).map((item) => this.extractProductInfo(item)).filter((p) => p !== null);
-    return {
-      type: "product_carousel",
-      title: "Recommended Products",
-      description: `Found ${products.length} relevant products`,
-      data: products
-    };
+  async chat(message, history = [], namespace) {
+    await this.validationPromise;
+    return this.pipeline.ask(message, history, namespace);
   }
   /**
-   * Transform data to pie chart format
+   * Run a streaming chat query.
    */
-  static transformToPieChart(data) {
-    const categories = this.detectCategories(data);
-    const categoryData = this.aggregateByCategory(data, categories);
-    const pieData = Object.entries(categoryData).map(([label, count]) => ({
-      label,
-      value: count,
-      inStock: this.checkStockStatus(label, data)
-    }));
-    return {
-      type: "pie_chart",
-      title: "Distribution by Category",
-      description: `Showing breakdown across ${categories.length} categories`,
-      data: pieData
-    };
+  chatStream(_0) {
+    return __asyncGenerator(this, arguments, function* (message, history = [], namespace) {
+      yield new __await(this.validationPromise);
+      yield* __yieldStar(this.pipeline.askStream(message, history, namespace));
+    });
   }
   /**
-   * Transform data to bar chart format
+   * Ingest documents into the vector database.
    */
-  static transformToBarChart(data) {
-    const categories = this.detectCategories(data);
-    const categoryData = this.aggregateByCategory(data, categories);
-    const barData = Object.entries(categoryData).map(([category, value]) => ({
-      category,
-      value,
-      inStock: this.checkStockStatus(category, data)
-    }));
-    return {
-      type: "bar_chart",
-      title: "Comparison by Category",
-      description: `Comparing ${categories.length} categories`,
-      data: barData
-    };
+  async ingest(documents, namespace) {
+    await this.validationPromise;
+    return this.pipeline.ingest(documents, namespace);
   }
   /**
-   * Transform data to line chart format
+   * Get auto-suggestions based on a query prefix.
    */
-  static transformToLineChart(data) {
-    const timePoints = this.extractTimeSeriesData(data);
-    const lineData = timePoints.map((point) => ({
-      timestamp: point.timestamp,
-      value: point.value,
-      label: point.label
-    }));
-    return {
-      type: "line_chart",
-      title: "Trend Over Time",
-      description: `Showing ${lineData.length} data points`,
-      data: lineData
-    };
+  async getSuggestions(query, namespace) {
+    await this.validationPromise;
+    return this.pipeline.getSuggestions(query, namespace);
+  }
+};
+
+// src/config/ConfigBuilder.ts
+var ConfigBuilder = class {
+  /**
+   * Set the project/application ID for namespacing
+   */
+  projectId(id) {
+    this._projectId = id;
+    return this;
   }
   /**
-   * Transform data to table format
+   * Configure the vector database provider
    */
-  static transformToTable(data) {
-    const columns = this.extractTableColumns(data);
-    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
-    };
+  vectorDb(provider, options) {
+    var _a;
+    if (provider === "auto") {
+      this._vectorDb = this._autoDetectVectorDb();
+    } else {
+      this._vectorDb = {
+        provider,
+        indexName: (_a = options == null ? void 0 : options.indexName) != null ? _a : "default",
+        options: __spreadValues({}, options)
+      };
+    }
+    return this;
+  }
+  /**
+   * Configure the LLM provider for chat
+   */
+  llm(provider, model, apiKey, options) {
+    var _a, _b;
+    if (provider === "auto") {
+      this._llm = this._autoDetectLLM();
+    } else {
+      this._llm = {
+        provider,
+        model: model != null ? model : "default-model",
+        apiKey,
+        systemPrompt: options == null ? void 0 : options.systemPrompt,
+        maxTokens: (_a = options == null ? void 0 : options.maxTokens) != null ? _a : 1024,
+        temperature: (_b = options == null ? void 0 : options.temperature) != null ? _b : 0.7,
+        baseUrl: options == null ? void 0 : options.baseUrl,
+        options
+      };
+    }
+    return this;
+  }
+  /**
+   * Configure the embedding provider
+   */
+  embedding(provider, model, apiKey, options) {
+    if (provider === "auto") {
+      this._embedding = this._autoDetectEmbedding();
+    } else {
+      this._embedding = {
+        provider,
+        model: model != null ? model : "default-embedding",
+        apiKey,
+        baseUrl: options == null ? void 0 : options.baseUrl,
+        options
+      };
+    }
+    return this;
   }
   /**
-   * Transform data to text format (fallback)
+   * Set RAG-specific pipeline parameters
    */
-  static transformToText(data) {
-    const textContent = data.map((item) => item.content).join("\n\n");
-    return this.createTextResponse(
-      "Search Results",
-      textContent,
-      `Found ${data.length} relevant results`
-    );
+  rag(options) {
+    var _a;
+    this._rag = __spreadValues(__spreadValues({}, (_a = this._rag) != null ? _a : {}), options);
+    return this;
   }
   /**
-   * Helper: Create text response
+   * Set UI branding and appearance options.
+   * Accepts the full UIConfig interface.
    */
-  static createTextResponse(title, content, description) {
-    return {
-      type: "text",
-      title,
-      description,
-      data: { content }
-    };
+  ui(options) {
+    this._ui = options;
+    return this;
   }
   /**
-   * Helper: Check if data item is product-related
+   * Build and return the final RagConfig.
+   * Throws if required fields (projectId, vectorDb, llm, embedding) are not set.
    */
-  static isProductData(item) {
-    const content = (item.content || "").toLowerCase();
-    const productKeywords = ["product", "price", "stock", "item", "sku", "brand", "model"];
-    return productKeywords.some((kw) => content.includes(kw)) || Object.keys(item.metadata || {}).some(
-      (k) => ["name", "price", "product", "sku"].includes(k.toLowerCase())
-    );
+  build() {
+    var _a;
+    const missing = [];
+    if (!this._projectId) missing.push('projectId (call .projectId("my-app"))');
+    if (!this._vectorDb) missing.push('vectorDb (call .vectorDb("pinecone", { ... }))');
+    if (!this._llm) missing.push('llm (call .llm("openai", "gpt-4o", apiKey))');
+    if (!this._embedding) missing.push('embedding (call .embedding("openai", "text-embedding-3-small"))');
+    if (missing.length > 0) {
+      throw new Error(
+        `[ConfigBuilder] Cannot build \u2014 required fields are missing:
+  ${missing.join("\n  ")}`
+      );
+    }
+    return __spreadValues({
+      projectId: this._projectId,
+      vectorDb: this._vectorDb,
+      llm: this._llm,
+      embedding: this._embedding,
+      ui: this._rag ? this._ui : void 0,
+      rag: (_a = this._rag) != null ? _a : { chunkSize: 1e3, chunkOverlap: 200, topK: 5 }
+    }, this._ui ? { ui: this._ui } : {});
   }
   /**
-   * Helper: Check if data contains time series
+   * Build and return as JSON for serialization
    */
-  static isTimeSeriesData(item) {
-    const content = (item.content || "").toLowerCase();
-    const timeKeywords = ["date", "time", "year", "month", "week", "day", "hour", "trend", "historical"];
-    return timeKeywords.some((kw) => content.includes(kw)) || Object.keys(item.metadata || {}).some(
-      (k) => ["date", "timestamp", "time", "period"].includes(k.toLowerCase())
-    );
+  toJSON() {
+    return JSON.stringify(this.build());
   }
-  /**
-   * Helper: Extract product information from vector match
-   */
-  static extractProductInfo(item) {
-    const meta = item.metadata || {};
-    if (meta.name || meta.product) {
-      return {
-        id: item.id,
-        name: meta.name || meta.product,
-        price: meta.price,
-        image: meta.image || meta.imageUrl,
-        brand: meta.brand,
-        description: item.content,
-        inStock: this.determineStockStatus(item)
-      };
+  // ============================================================================
+  // Private helper methods for auto-detection
+  // ============================================================================
+  _autoDetectVectorDb() {
+    if (process.env.PINECONE_API_KEY && process.env.PINECONE_INDEX) {
+      return { provider: "pinecone", indexName: process.env.PINECONE_INDEX, options: { apiKey: process.env.PINECONE_API_KEY } };
     }
-    const nameMatch = item.content.match(/(?:Product|Item|Name):\s*([^\n]+)/i);
-    const priceMatch = item.content.match(/(?:Price|Cost):\s*\$?([\d.]+)/i);
-    if (nameMatch) {
-      return {
-        id: item.id,
-        name: nameMatch[1],
-        price: priceMatch ? parseFloat(priceMatch[1]) : void 0,
-        description: item.content,
-        inStock: this.determineStockStatus(item)
-      };
+    if (process.env.QDRANT_URL) {
+      return { provider: "qdrant", indexName: process.env.QDRANT_COLLECTION || "documents", options: { url: process.env.QDRANT_URL, apiKey: process.env.QDRANT_API_KEY } };
     }
-    return null;
+    if (process.env.DATABASE_URL) {
+      return { provider: "postgresql", indexName: process.env.PG_TABLE || "documents", options: { connectionString: process.env.DATABASE_URL } };
+    }
+    if (process.env.MONGODB_URI) {
+      return { provider: "mongodb", indexName: process.env.MONGODB_COLLECTION || "documents", options: { uri: process.env.MONGODB_URI, database: process.env.MONGODB_DB || "ai_db", collection: process.env.MONGODB_COLLECTION || "documents" } };
+    }
+    if (process.env.REDIS_URL) {
+      return { provider: "redis", indexName: process.env.REDIS_INDEX || "documents", options: { url: process.env.REDIS_URL } };
+    }
+    return { provider: "qdrant", indexName: "documents", options: { url: process.env.QDRANT_URL || "http://localhost:6333" } };
+  }
+  _autoDetectLLM() {
+    if (process.env.OPENAI_API_KEY) {
+      return { provider: "openai", model: process.env.OPENAI_MODEL || "gpt-4o-mini", apiKey: process.env.OPENAI_API_KEY, maxTokens: parseInt(process.env.OPENAI_MAX_TOKENS || "1024"), temperature: parseFloat(process.env.OPENAI_TEMPERATURE || "0.7") };
+    }
+    if (process.env.ANTHROPIC_API_KEY) {
+      return { provider: "anthropic", model: process.env.ANTHROPIC_MODEL || "claude-3-haiku-20240307", apiKey: process.env.ANTHROPIC_API_KEY, maxTokens: parseInt(process.env.ANTHROPIC_MAX_TOKENS || "1024"), temperature: parseFloat(process.env.ANTHROPIC_TEMPERATURE || "0.7") };
+    }
+    if (process.env.OLLAMA_BASE_URL) {
+      return { provider: "ollama", model: process.env.OLLAMA_MODEL || "mistral", baseUrl: process.env.OLLAMA_BASE_URL, maxTokens: parseInt(process.env.OLLAMA_MAX_TOKENS || "1024"), temperature: parseFloat(process.env.OLLAMA_TEMPERATURE || "0.7") };
+    }
+    return { provider: "openai", model: "gpt-4o-mini", apiKey: process.env.OPENAI_API_KEY };
+  }
+  _autoDetectEmbedding() {
+    if (process.env.EMBEDDING_PROVIDER) {
+      return { provider: process.env.EMBEDDING_PROVIDER, model: process.env.EMBEDDING_MODEL || "default", apiKey: process.env.EMBEDDING_API_KEY, baseUrl: process.env.EMBEDDING_BASE_URL };
+    }
+    return { provider: "openai", model: "text-embedding-3-small", apiKey: process.env.OPENAI_API_KEY };
   }
+};
+var PRESETS = {
+  /** OpenAI + Pinecone: Production-ready cloud setup */
+  "openai-pinecone": { vectorDb: "pinecone", llm: "openai", embedding: "openai" },
+  /** Claude + Qdrant: Open-source vector DB + proprietary LLM */
+  "claude-qdrant": { vectorDb: "qdrant", llm: "anthropic", embedding: "openai" },
+  /** Local development: Ollama + local Qdrant */
+  "local-dev": { vectorDb: "qdrant", llm: "ollama", embedding: "ollama" },
+  /** Fully open-source: Ollama LLM + Qdrant + Ollama embeddings */
+  "fully-open-source": { vectorDb: "qdrant", llm: "ollama", embedding: "ollama" },
+  /** PostgreSQL stack: pgvector + OpenAI */
+  "postgres-openai": { vectorDb: "postgresql", llm: "openai", embedding: "openai" },
+  /** Enterprise MongoDB: MongoDB Atlas with OpenAI */
+  "mongodb-openai": { vectorDb: "mongodb", llm: "openai", embedding: "openai" },
+  /** Redis stack for caching + search */
+  "redis-openai": { vectorDb: "redis", llm: "openai", embedding: "openai" }
+};
+function createFromPreset(presetName) {
+  const preset = PRESETS[presetName];
+  return new ConfigBuilder().vectorDb(preset.vectorDb, { apiKey: process.env[`${preset.vectorDb.toUpperCase()}_API_KEY`] }).llm(preset.llm, void 0, process.env[`${preset.llm.toUpperCase()}_API_KEY`]).embedding(preset.embedding, void 0, process.env[`${preset.embedding.toUpperCase()}_API_KEY`]);
+}
+
+// src/utils/DocumentParser.ts
+var DocumentParser = class {
   /**
-   * Helper: Detect categories in data
+   * Extract text from a File or Buffer based on its type.
    */
-  static detectCategories(data) {
-    const categories = /* @__PURE__ */ new Set();
-    data.forEach((item) => {
-      const meta = item.metadata || {};
-      if (meta.category) {
-        categories.add(String(meta.category));
-      }
-      if (meta.type) {
-        categories.add(String(meta.type));
+  static async parse(file, fileName, mimeType) {
+    var _a;
+    const extension = (_a = fileName.split(".").pop()) == null ? void 0 : _a.toLowerCase();
+    if (extension === "txt" || extension === "md" || mimeType === "text/plain" || mimeType === "text/markdown") {
+      return this.readAsText(file);
+    }
+    if (extension === "json" || mimeType === "application/json") {
+      const text = await this.readAsText(file);
+      try {
+        const obj = JSON.parse(text);
+        return JSON.stringify(obj, null, 2);
+      } catch (e) {
+        return text;
       }
-      if (meta.tag) {
-        const tags = Array.isArray(meta.tag) ? meta.tag : [meta.tag];
-        tags.forEach((t) => categories.add(String(t)));
+    }
+    if (extension === "csv" || mimeType === "text/csv") {
+      return this.readAsText(file);
+    }
+    if (extension === "pdf" || mimeType === "application/pdf") {
+      try {
+        const pdf = await import("pdf-parse");
+        const buffer = Buffer.isBuffer(file) ? file : Buffer.from(await file.arrayBuffer());
+        const data = await pdf.default(buffer);
+        return data.text;
+      } catch (err) {
+        console.warn('[DocumentParser] PDF parsing failed. Make sure "pdf-parse" is installed.', err);
+        return `[PDF Parsing Error for ${fileName}]`;
       }
-      const categoryMatch = item.content.match(/(?:Category|Type|Class):\s*([^\n]+)/i);
-      if (categoryMatch) {
-        categories.add(categoryMatch[1].trim());
+    }
+    if (extension === "docx" || mimeType === "application/vnd.openxmlformats-officedocument.wordprocessingml.document") {
+      try {
+        const mammoth = await import("mammoth");
+        const buffer = Buffer.isBuffer(file) ? file : Buffer.from(await file.arrayBuffer());
+        const result = await mammoth.extractRawText({ buffer });
+        return result.value;
+      } catch (err) {
+        console.warn('[DocumentParser] DOCX parsing failed. Make sure "mammoth" is installed.', err);
+        return `[DOCX Parsing Error for ${fileName}]`;
       }
-    });
-    return Array.from(categories);
+    }
+    try {
+      return await this.readAsText(file);
+    } catch (e) {
+      throw new Error(`[DocumentParser] Unsupported file format: ${fileName} (${mimeType})`);
+    }
+  }
+  static async readAsText(file) {
+    if (Buffer.isBuffer(file)) {
+      return file.toString("utf-8");
+    }
+    return await file.text();
+  }
+};
+
+// src/server.ts
+init_BaseVectorProvider();
+init_PineconeProvider();
+init_PostgreSQLProvider();
+
+// src/providers/vectordb/MultiTablePostgresProvider.ts
+var import_pg2 = require("pg");
+init_BaseVectorProvider();
+var MultiTablePostgresProvider = class extends BaseVectorProvider {
+  constructor(config) {
+    var _a, _b, _c, _d, _e;
+    super(config);
+    const opts = config.options || {};
+    if (!opts.connectionString) {
+      throw new Error("[MultiTablePostgresProvider] options.connectionString is required");
+    }
+    this.connectionString = opts.connectionString;
+    this.dimensions = (_a = opts.dimensions) != null ? _a : 768;
+    const rawTables = (_c = (_b = opts.tables) != null ? _b : process.env.VECTOR_DB_TABLES) != null ? _c : "";
+    this.tables = typeof rawTables === "string" ? rawTables.split(",").map((t) => t.trim()).filter(Boolean) : rawTables;
+    if (this.tables.length === 0) {
+      console.warn(
+        "[MultiTablePostgresProvider] No tables configured. Set VECTOR_DB_TABLES as a comma-separated list of table names or pass options.tables."
+      );
+    }
+    const rawSearchFields = (_e = (_d = opts.searchFields) != null ? _d : process.env.VECTOR_DB_SEARCH_FIELDS) != null ? _e : ["name", "product_name", "productname", "title"];
+    this.searchFields = typeof rawSearchFields === "string" ? rawSearchFields.split(",").map((f) => f.trim()).filter(Boolean) : rawSearchFields;
   }
-  /**
-   * Helper: Aggregate data by category
-   */
-  static aggregateByCategory(data, categories) {
-    const result = {};
-    categories.forEach((cat) => {
-      result[cat] = 0;
-    });
-    data.forEach((item) => {
-      const meta = item.metadata || {};
-      const itemCategory = meta.category || meta.type || "Other";
-      if (result.hasOwnProperty(itemCategory)) {
-        result[itemCategory]++;
+  async initialize() {
+    this.pool = new import_pg2.Pool({ connectionString: this.connectionString });
+    const client = await this.pool.connect();
+    try {
+      const res = await client.query(`
+        SELECT table_name 
+        FROM information_schema.columns 
+        WHERE column_name = 'embedding' 
+        AND table_schema = 'public'
+      `);
+      const discoveredTables = res.rows.map((r) => r.table_name);
+      if (this.tables.length === 0) {
+        this.tables = discoveredTables;
       } else {
-        result["Other"] = (result["Other"] || 0) + 1;
+        const staticTables = [...this.tables];
+        this.tables = staticTables.filter((t) => discoveredTables.includes(t));
+        if (this.tables.length < staticTables.length) {
+          const missing = staticTables.filter((t) => !discoveredTables.includes(t));
+          console.warn(`[MultiTablePostgresProvider] Some configured tables were skipped (missing 'embedding' column): ${missing.join(", ")}`);
+        }
       }
-    });
-    return result;
+      if (this.tables.length === 0) {
+        console.warn('[MultiTablePostgresProvider] No tables with "embedding" columns found in the database.');
+      } else {
+        console.log(
+          `[MultiTablePostgresProvider] Connected. Searching across ${this.tables.length} table(s): ${this.tables.join(", ")}`
+        );
+      }
+    } finally {
+      client.release();
+    }
   }
   /**
-   * Helper: Extract time series data
+   * Upsert is not supported for MultiTablePostgresProvider as it's designed for 
+   * searching across pre-existing tables with varying schemas.
    */
-  static extractTimeSeriesData(data) {
-    return data.map((item) => {
-      const meta = item.metadata || {};
-      return {
-        timestamp: meta.timestamp || meta.date || (/* @__PURE__ */ new Date()).toISOString(),
-        value: meta.value || item.score || 0,
-        label: meta.label || item.content.substring(0, 50)
-      };
-    });
+  async upsert(_doc, _namespace) {
+    throw new Error(
+      "[MultiTablePostgresProvider] upsert() is not supported in multi-table mode. Please use the standard PostgreSQLProvider for single-table managed indices."
+    );
   }
   /**
-   * Helper: Extract table columns
+   * Batch upsert is not supported for MultiTablePostgresProvider.
    */
-  static extractTableColumns(data) {
-    const columnSet = /* @__PURE__ */ new Set();
-    columnSet.add("Content");
-    data.forEach((item) => {
-      Object.keys(item.metadata || {}).forEach((key) => {
-        columnSet.add(key.charAt(0).toUpperCase() + key.slice(1));
-      });
-    });
-    return Array.from(columnSet);
+  async batchUpsert(_docs, _namespace) {
+    throw new Error(
+      "[MultiTablePostgresProvider] batchUpsert() is not supported in multi-table mode."
+    );
   }
   /**
-   * Helper: Extract table row
+   * Query all configured tables and merge results, sorted by cosine similarity score.
    */
-  static extractTableRow(item, columns) {
-    const meta = item.metadata || {};
-    return columns.map((col) => {
-      if (col === "Content") {
-        return item.content.substring(0, 100);
+  async query(vector, topK, _namespace, _filter) {
+    var _a, _b, _c;
+    if (!this.pool) {
+      throw new Error("[MultiTablePostgresProvider] Provider not initialized. Call initialize() first.");
+    }
+    const vectorLiteral = `[${vector.join(",")}]`;
+    const allResults = [];
+    console.log(`[MultiTablePostgresProvider] --- Starting Multi-Table Search ---`);
+    const queryText = _filter == null ? void 0 : _filter.queryText;
+    const entityHints = Array.isArray(_filter == null ? void 0 : _filter.__entityHints) ? _filter.__entityHints.filter(
+      (hint) => typeof hint === "object" && hint !== null && typeof hint.value === "string"
+    ).map((hint) => hint.value.trim().toLowerCase()).filter(Boolean) : [];
+    console.log(`[MultiTablePostgresProvider] queryText: "${queryText}"`);
+    console.log(`[MultiTablePostgresProvider] entityHints: [${entityHints.join(", ")}]`);
+    const getDynamicKeywordQuery = () => {
+      if (entityHints.length > 0) {
+        return entityHints.map((h) => h.includes(" ") ? `"${h}"` : h).join(" & ");
+      }
+      if (queryText) {
+        return queryText.toLowerCase().replace(/\b(show|me|the|product[s]?|item[s]?|card[s]?|of|category|find|list|browse|what|are|display|all|under|for|in|with|about)\b/g, "").trim().replace(/\s+/g, " & ");
+      }
+      return "";
+    };
+    const dynamicKeywordQuery = getDynamicKeywordQuery();
+    const queryPromises = this.tables.map(async (table) => {
+      try {
+        let sqlQuery = "";
+        let params = [];
+        if (queryText) {
+          const hasEntityHints = entityHints.length > 0;
+          const exactNameScoreExpr = hasEntityHints ? `+ (
+                 SELECT COALESCE(MAX(
+                   CASE WHEN LOWER(val) IN (${entityHints.map((h) => `'${h.replace(/'/g, "''")}'`).join(", ")})
+                   THEN 1.0 ELSE 0.0 END
+                 ), 0)
+                 FROM jsonb_each_text(to_jsonb(t)) AS kv(key, val)
+                 WHERE key IN (${this.searchFields.map((f) => `'${f}'`).join(", ")})
+               ) * 3.0` : "";
+          sqlQuery = `
+            SELECT *, 
+             (1 - (embedding <=> $1::vector)) AS vector_score,
+             COALESCE(ts_rank(to_tsvector('english', (to_jsonb(t) - 'embedding')::text), to_tsquery('english', $2)), 0) AS keyword_score,
+             ((1 - (embedding <=> $1::vector)) + (COALESCE(ts_rank(to_tsvector('english', (to_jsonb(t) - 'embedding')::text), to_tsquery('english', $2)), 0) * 2.0) ${exactNameScoreExpr}) AS hybrid_score
+            FROM "${table}" t
+            ORDER BY hybrid_score DESC
+            LIMIT 50
+          `;
+          params = [vectorLiteral, dynamicKeywordQuery];
+        } else {
+          sqlQuery = `
+            SELECT *, 
+             (1 - (embedding <=> $1::vector)) AS hybrid_score
+            FROM "${table}" t
+            ORDER BY hybrid_score DESC
+            LIMIT 50
+          `;
+          params = [vectorLiteral];
+        }
+        const result = await this.pool.query(sqlQuery, params);
+        if (result.rowCount && result.rowCount > 0) {
+          console.log(`   \u2705 Table "${table}": Found ${result.rowCount} potential matches. Top score: ${result.rows[0].hybrid_score.toFixed(4)}`);
+        } else {
+          console.log(`   \u26AA Table "${table}": No relevant matches found.`);
+        }
+        const tableResults = [];
+        for (const row of result.rows) {
+          const _a2 = row, { hybrid_score, id } = _a2, rest = __objRest(_a2, ["hybrid_score", "id"]);
+          delete rest.embedding;
+          delete rest.vector_score;
+          delete rest.keyword_score;
+          delete rest.exact_name_score;
+          const content = `[TYPE: ${table.replace(/s$/, "").toUpperCase()}]
+` + Object.entries(rest).filter(([k, v]) => v !== null && typeof v !== "object" && k !== "id").map(([k, v]) => `${k}: ${v}`).join("\n");
+          tableResults.push({
+            id: `${table}-${id}`,
+            score: parseFloat(String(hybrid_score)),
+            content,
+            metadata: __spreadProps(__spreadValues({}, rest), { source_table: table })
+          });
+        }
+        return tableResults;
+      } catch (err) {
+        console.error(
+          `[MultiTablePostgresProvider] Error querying table "${table}":`,
+          err.message
+        );
+        return [];
       }
-      const metaKey = col.charAt(0).toLowerCase() + col.slice(1);
-      const value = meta[metaKey];
-      return value !== void 0 ? String(value) : "";
-    });
-  }
-  /**
-   * Helper: Check stock status
-   */
-  static checkStockStatus(category, data) {
-    const item = data.find((d) => {
-      const meta = d.metadata || {};
-      return meta.category === category || meta.type === category;
     });
-    return this.determineStockStatus(item || {});
-  }
-  /**
-   * Helper: Determine if item is in stock
-   */
-  static determineStockStatus(item) {
-    const meta = item.metadata || {};
-    if (meta.inStock !== void 0) {
-      return Boolean(meta.inStock);
+    const resultsArray = await Promise.all(queryPromises);
+    for (const tableResults of resultsArray) {
+      allResults.push(...tableResults);
     }
-    if (meta.stock !== void 0) {
-      return Boolean(meta.stock);
+    const resultsByTable = {};
+    for (const res of allResults) {
+      const table = (_a = res.metadata) == null ? void 0 : _a.source_table;
+      if (!resultsByTable[table]) resultsByTable[table] = [];
+      resultsByTable[table].push(res);
     }
-    if (meta.available !== void 0) {
-      return Boolean(meta.available);
+    const balancedResults = [];
+    const tables = Object.keys(resultsByTable);
+    for (const table of tables) {
+      balancedResults.push(...resultsByTable[table].slice(0, 3));
     }
-    const content = (item.content || "").toLowerCase();
-    if (content.includes("out of stock") || content.includes("unavailable")) {
-      return false;
+    const finalSorted = balancedResults.sort((a, b) => b.score - a.score);
+    if (finalSorted.length > 0) {
+      console.log(`[MultiTablePostgresProvider] --- Search Complete ---`);
+      console.log(`[MultiTablePostgresProvider] Final top match from "${(_c = (_b = finalSorted[0].metadata) == null ? void 0 : _b.source_table) != null ? _c : "unknown"}" with score ${finalSorted[0].score.toFixed(4)}`);
     }
-    if (content.includes("in stock") || content.includes("available")) {
+    return finalSorted.slice(0, Math.max(topK, 15));
+  }
+  async delete(_id, _namespace) {
+    console.warn("[MultiTablePostgresProvider] delete() is a no-op for multi-table mode.");
+  }
+  async deleteNamespace(_namespace) {
+    console.warn("[MultiTablePostgresProvider] deleteNamespace() is a no-op for multi-table mode.");
+  }
+  async ping() {
+    try {
+      await this.pool.query("SELECT 1");
       return true;
+    } catch (e) {
+      return false;
     }
-    return true;
   }
-  /**
-   * Helper: Check if data has multiple fields
-   */
-  static hasMultipleFields(data) {
-    const fieldCount = /* @__PURE__ */ new Set();
-    data.forEach((item) => {
-      Object.keys(item.metadata || {}).forEach((key) => {
-        fieldCount.add(key);
-      });
-    });
-    return fieldCount.size > 2;
+  async disconnect() {
+    if (this.pool) {
+      await this.pool.end();
+    }
   }
 };
 
+// src/server.ts
+init_MongoDBProvider();
+init_MilvusProvider();
+init_QdrantProvider();
+init_ChromaDBProvider();
+init_RedisProvider();
+init_WeaviateProvider();
+init_UniversalVectorProvider();
+
 // src/handlers/index.ts
+var import_server = require("next/server");
 function sseFrame(payload) {
   return `data: ${JSON.stringify(payload)}