@retrivora-ai/rag-engine 1.2.0 → 1.2.1

package/dist/{RagConfig-FyMB_UG6.d.mts → RagConfig-BOLOz0_O.d.mts}

@@ -1,3 +1,54 @@
+interface VectorMatch {
+    id: string | number;
+    score: number;
+    content: string;
+    metadata?: Record<string, unknown>;
+}
+interface UpsertDocument {
+    id: string | number;
+    vector: number[];
+    content: string;
+    metadata?: Record<string, unknown>;
+}
+interface IngestDocument {
+    docId: string | number;
+    content: string;
+    metadata?: Record<string, unknown>;
+}
+interface ChatResponse {
+    reply: string;
+    sources: VectorMatch[];
+    graphData?: GraphSearchResult;
+}
+interface GraphNode {
+    id: string;
+    label: string;
+    properties?: Record<string, unknown>;
+}
+interface Edge {
+    source: string;
+    target: string;
+    type: string;
+    properties?: Record<string, unknown>;
+}
+interface GraphSearchResult {
+    nodes: GraphNode[];
+    edges: Edge[];
+}
+interface RetrievalResult {
+    sources: VectorMatch[];
+    graphData?: GraphSearchResult;
+}
+interface Product {
+    id: string | number;
+    name: string;
+    brand?: string;
+    price?: string | number;
+    image?: string;
+    link?: string;
+    description?: string;
+}
+
 /**
  * Generic LLM Provider interface.
  * Covers both chat completion and embedding generation so a single
@@ -55,48 +106,6 @@ interface ILLMProvider {
     ping(): Promise<boolean>;
 }
 
-interface VectorMatch {
-    id: string | number;
-    score: number;
-    content: string;
-    metadata?: Record<string, unknown>;
-}
-interface UpsertDocument {
-    id: string | number;
-    vector: number[];
-    content: string;
-    metadata?: Record<string, unknown>;
-}
-interface IngestDocument {
-    docId: string | number;
-    content: string;
-    metadata?: Record<string, unknown>;
-}
-interface ChatResponse {
-    reply: string;
-    sources: VectorMatch[];
-    graphData?: GraphSearchResult;
-}
-interface GraphNode {
-    id: string;
-    label: string;
-    properties?: Record<string, unknown>;
-}
-interface Edge {
-    source: string;
-    target: string;
-    type: string;
-    properties?: Record<string, unknown>;
-}
-interface GraphSearchResult {
-    nodes: GraphNode[];
-    edges: Edge[];
-}
-interface RetrievalResult {
-    sources: VectorMatch[];
-    graphData?: GraphSearchResult;
-}
-
 /**
  * constants.ts — Centralized definitions of acceptable configuration values.
  *
@@ -271,4 +280,4 @@ interface RagConfig {
     graphDb?: GraphDBConfig;
 }
 
-export type { ChatMessage as C, EmbedOptions as E, GraphDBConfig as G, ILLMProvider as I, LLMConfig as L, RAGConfig as R, UIConfig as U, VectorMatch as V, ChatOptions as a, ChatResponse as b, EmbeddingConfig as c, EmbeddingProvider as d, IngestDocument as e, LLMProvider as f, RagConfig as g, UpsertDocument as h, VectorDBConfig as i, VectorDBProvider as j, RetrievalResult as k, GraphNode as l, Edge as m, GraphSearchResult as n };
+export type { ChatMessage as C, EmbedOptions as E, GraphDBConfig as G, ILLMProvider as I, LLMConfig as L, Product as P, RAGConfig as R, UIConfig as U, VectorMatch as V, ChatOptions as a, ChatResponse as b, EmbeddingConfig as c, EmbeddingProvider as d, IngestDocument as e, LLMProvider as f, RagConfig as g, UpsertDocument as h, VectorDBConfig as i, VectorDBProvider as j, RetrievalResult as k, GraphNode as l, Edge as m, GraphSearchResult as n };

package/dist/{RagConfig-FyMB_UG6.d.ts → RagConfig-BOLOz0_O.d.ts}

@@ -1,3 +1,54 @@
+interface VectorMatch {
+    id: string | number;
+    score: number;
+    content: string;
+    metadata?: Record<string, unknown>;
+}
+interface UpsertDocument {
+    id: string | number;
+    vector: number[];
+    content: string;
+    metadata?: Record<string, unknown>;
+}
+interface IngestDocument {
+    docId: string | number;
+    content: string;
+    metadata?: Record<string, unknown>;
+}
+interface ChatResponse {
+    reply: string;
+    sources: VectorMatch[];
+    graphData?: GraphSearchResult;
+}
+interface GraphNode {
+    id: string;
+    label: string;
+    properties?: Record<string, unknown>;
+}
+interface Edge {
+    source: string;
+    target: string;
+    type: string;
+    properties?: Record<string, unknown>;
+}
+interface GraphSearchResult {
+    nodes: GraphNode[];
+    edges: Edge[];
+}
+interface RetrievalResult {
+    sources: VectorMatch[];
+    graphData?: GraphSearchResult;
+}
+interface Product {
+    id: string | number;
+    name: string;
+    brand?: string;
+    price?: string | number;
+    image?: string;
+    link?: string;
+    description?: string;
+}
+
 /**
  * Generic LLM Provider interface.
  * Covers both chat completion and embedding generation so a single
@@ -55,48 +106,6 @@ interface ILLMProvider {
     ping(): Promise<boolean>;
 }
 
-interface VectorMatch {
-    id: string | number;
-    score: number;
-    content: string;
-    metadata?: Record<string, unknown>;
-}
-interface UpsertDocument {
-    id: string | number;
-    vector: number[];
-    content: string;
-    metadata?: Record<string, unknown>;
-}
-interface IngestDocument {
-    docId: string | number;
-    content: string;
-    metadata?: Record<string, unknown>;
-}
-interface ChatResponse {
-    reply: string;
-    sources: VectorMatch[];
-    graphData?: GraphSearchResult;
-}
-interface GraphNode {
-    id: string;
-    label: string;
-    properties?: Record<string, unknown>;
-}
-interface Edge {
-    source: string;
-    target: string;
-    type: string;
-    properties?: Record<string, unknown>;
-}
-interface GraphSearchResult {
-    nodes: GraphNode[];
-    edges: Edge[];
-}
-interface RetrievalResult {
-    sources: VectorMatch[];
-    graphData?: GraphSearchResult;
-}
-
 /**
  * constants.ts — Centralized definitions of acceptable configuration values.
  *
@@ -271,4 +280,4 @@ interface RagConfig {
     graphDb?: GraphDBConfig;
 }
 
-export type { ChatMessage as C, EmbedOptions as E, GraphDBConfig as G, ILLMProvider as I, LLMConfig as L, RAGConfig as R, UIConfig as U, VectorMatch as V, ChatOptions as a, ChatResponse as b, EmbeddingConfig as c, EmbeddingProvider as d, IngestDocument as e, LLMProvider as f, RagConfig as g, UpsertDocument as h, VectorDBConfig as i, VectorDBProvider as j, RetrievalResult as k, GraphNode as l, Edge as m, GraphSearchResult as n };
+export type { ChatMessage as C, EmbedOptions as E, GraphDBConfig as G, ILLMProvider as I, LLMConfig as L, Product as P, RAGConfig as R, UIConfig as U, VectorMatch as V, ChatOptions as a, ChatResponse as b, EmbeddingConfig as c, EmbeddingProvider as d, IngestDocument as e, LLMProvider as f, RagConfig as g, UpsertDocument as h, VectorDBConfig as i, VectorDBProvider as j, RetrievalResult as k, GraphNode as l, Edge as m, GraphSearchResult as n };

package/dist/{chunk-OCDCJUNE.mjs → chunk-GCPPRD2G.mjs}

@@ -2523,6 +2523,50 @@ Optimized Search Query:`;
     );
     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
@@ -2677,6 +2721,13 @@ var VectorPlugin = class {
     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/utils/DocumentParser.ts
@@ -2906,6 +2957,23 @@ function createUploadHandler(configOrPlugin) {
     }
   };
 }
+function createSuggestionsHandler(configOrPlugin) {
+  const plugin = configOrPlugin instanceof VectorPlugin ? configOrPlugin : new VectorPlugin(configOrPlugin);
+  return async function POST(req) {
+    try {
+      const body = await req.json();
+      const { query, namespace } = body;
+      if (typeof query !== "string") {
+        return NextResponse.json({ error: "query is required" }, { status: 400 });
+      }
+      const suggestions = await plugin.getSuggestions(query, namespace);
+      return NextResponse.json({ suggestions });
+    } catch (err) {
+      const message = err instanceof Error ? err.message : "Internal server error";
+      return NextResponse.json({ error: message }, { status: 500 });
+    }
+  };
+}
 
 export {
   getRagConfig,
@@ -2935,5 +3003,6 @@ export {
   createStreamHandler,
   createIngestHandler,
   createHealthHandler,
-  createUploadHandler
+  createUploadHandler,
+  createSuggestionsHandler
 };

package/dist/handlers/index.d.mts

@@ -1,3 +1,3 @@
-import '../RagConfig-FyMB_UG6.mjs';
-export { c as createChatHandler, d as createHealthHandler, e as createIngestHandler, f as createStreamHandler, g as createUploadHandler, s as sseErrorFrame, h as sseFrame, i as sseMetaFrame, j as sseTextFrame } from '../index-D-lfcqlL.mjs';
+import '../RagConfig-BOLOz0_O.mjs';
+export { c as createChatHandler, d as createHealthHandler, e as createIngestHandler, f as createStreamHandler, k as createSuggestionsHandler, g as createUploadHandler, s as sseErrorFrame, h as sseFrame, i as sseMetaFrame, j as sseTextFrame } from '../index-64BDupW3.mjs';
 import 'next/server';

package/dist/handlers/index.d.ts

@@ -1,3 +1,3 @@
-import '../RagConfig-FyMB_UG6.js';
-export { c as createChatHandler, d as createHealthHandler, e as createIngestHandler, f as createStreamHandler, g as createUploadHandler, s as sseErrorFrame, h as sseFrame, i as sseMetaFrame, j as sseTextFrame } from '../index-CYgr00ot.js';
+import '../RagConfig-BOLOz0_O.js';
+export { c as createChatHandler, d as createHealthHandler, e as createIngestHandler, f as createStreamHandler, k as createSuggestionsHandler, g as createUploadHandler, s as sseErrorFrame, h as sseFrame, i as sseMetaFrame, j as sseTextFrame } from '../index-DbtE8wLM.js';
 import 'next/server';

package/dist/handlers/index.js

@@ -1612,6 +1612,7 @@ __export(handlers_exports, {
   createHealthHandler: () => createHealthHandler,
   createIngestHandler: () => createIngestHandler,
   createStreamHandler: () => createStreamHandler,
+  createSuggestionsHandler: () => createSuggestionsHandler,
   createUploadHandler: () => createUploadHandler,
   sseErrorFrame: () => sseErrorFrame,
   sseFrame: () => sseFrame,
@@ -4085,6 +4086,50 @@ Optimized Search Query:`;
     );
     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
@@ -4239,6 +4284,13 @@ var VectorPlugin = class {
     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/utils/DocumentParser.ts
@@ -4468,12 +4520,30 @@ function createUploadHandler(configOrPlugin) {
     }
   };
 }
+function createSuggestionsHandler(configOrPlugin) {
+  const plugin = configOrPlugin instanceof VectorPlugin ? configOrPlugin : new VectorPlugin(configOrPlugin);
+  return async function POST(req) {
+    try {
+      const body = await req.json();
+      const { query, namespace } = body;
+      if (typeof query !== "string") {
+        return import_server.NextResponse.json({ error: "query is required" }, { status: 400 });
+      }
+      const suggestions = await plugin.getSuggestions(query, namespace);
+      return import_server.NextResponse.json({ suggestions });
+    } catch (err) {
+      const message = err instanceof Error ? err.message : "Internal server error";
+      return import_server.NextResponse.json({ error: message }, { status: 500 });
+    }
+  };
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   createChatHandler,
   createHealthHandler,
   createIngestHandler,
   createStreamHandler,
+  createSuggestionsHandler,
   createUploadHandler,
   sseErrorFrame,
   sseFrame,

package/dist/handlers/index.mjs

@@ -3,12 +3,13 @@ import {
   createHealthHandler,
   createIngestHandler,
   createStreamHandler,
+  createSuggestionsHandler,
   createUploadHandler,
   sseErrorFrame,
   sseFrame,
   sseMetaFrame,
   sseTextFrame
-} from "../chunk-OCDCJUNE.mjs";
+} from "../chunk-GCPPRD2G.mjs";
 import "../chunk-YLTMFW4M.mjs";
 import "../chunk-X4TOT24V.mjs";
 export {
@@ -16,6 +17,7 @@ export {
   createHealthHandler,
   createIngestHandler,
   createStreamHandler,
+  createSuggestionsHandler,
   createUploadHandler,
   sseErrorFrame,
   sseFrame,

package/dist/{index-CYgr00ot.d.ts → index-64BDupW3.d.mts}

@@ -1,4 +1,4 @@
-import { g as RagConfig, C as ChatMessage, b as ChatResponse, e as IngestDocument } from './RagConfig-FyMB_UG6.js';
+import { g as RagConfig, C as ChatMessage, b as ChatResponse, e as IngestDocument } from './RagConfig-BOLOz0_O.mjs';
 import { NextRequest, NextResponse } from 'next/server';
 
 interface ValidationError {
@@ -112,6 +112,10 @@ declare class VectorPlugin {
         docId: string | number;
         chunksIngested: number;
     }>>;
+    /**
+     * Get auto-suggestions based on a query prefix.
+     */
+    getSuggestions(query: string, namespace?: string): Promise<string[]>;
 }
 
 /**
@@ -202,5 +206,13 @@ declare function createUploadHandler(configOrPlugin?: Partial<RagConfig> | Vecto
         chunksIngested: number;
     }[];
 }>>;
+/**
+ * createSuggestionsHandler — factory for the auto-suggestions endpoint.
+ */
+declare function createSuggestionsHandler(configOrPlugin?: Partial<RagConfig> | VectorPlugin): (req: NextRequest) => Promise<NextResponse<{
+    error: string;
+}> | NextResponse<{
+    suggestions: string[];
+}>>;
 
-export { ConfigValidator as C, type HealthCheckResult as H, type IProviderValidator as I, type ValidationError as V, type IProviderHealthChecker as a, VectorPlugin as b, createChatHandler as c, createHealthHandler as d, createIngestHandler as e, createStreamHandler as f, createUploadHandler as g, sseFrame as h, sseMetaFrame as i, sseTextFrame as j, sseErrorFrame as s };
+export { ConfigValidator as C, type HealthCheckResult as H, type IProviderValidator as I, type ValidationError as V, type IProviderHealthChecker as a, VectorPlugin as b, createChatHandler as c, createHealthHandler as d, createIngestHandler as e, createStreamHandler as f, createUploadHandler as g, sseFrame as h, sseMetaFrame as i, sseTextFrame as j, createSuggestionsHandler as k, sseErrorFrame as s };

package/dist/{index-D-lfcqlL.d.mts → index-DbtE8wLM.d.ts}

@@ -1,4 +1,4 @@
-import { g as RagConfig, C as ChatMessage, b as ChatResponse, e as IngestDocument } from './RagConfig-FyMB_UG6.mjs';
+import { g as RagConfig, C as ChatMessage, b as ChatResponse, e as IngestDocument } from './RagConfig-BOLOz0_O.js';
 import { NextRequest, NextResponse } from 'next/server';
 
 interface ValidationError {
@@ -112,6 +112,10 @@ declare class VectorPlugin {
         docId: string | number;
         chunksIngested: number;
     }>>;
+    /**
+     * Get auto-suggestions based on a query prefix.
+     */
+    getSuggestions(query: string, namespace?: string): Promise<string[]>;
 }
 
 /**
@@ -202,5 +206,13 @@ declare function createUploadHandler(configOrPlugin?: Partial<RagConfig> | Vecto
         chunksIngested: number;
     }[];
 }>>;
+/**
+ * createSuggestionsHandler — factory for the auto-suggestions endpoint.
+ */
+declare function createSuggestionsHandler(configOrPlugin?: Partial<RagConfig> | VectorPlugin): (req: NextRequest) => Promise<NextResponse<{
+    error: string;
+}> | NextResponse<{
+    suggestions: string[];
+}>>;
 
-export { ConfigValidator as C, type HealthCheckResult as H, type IProviderValidator as I, type ValidationError as V, type IProviderHealthChecker as a, VectorPlugin as b, createChatHandler as c, createHealthHandler as d, createIngestHandler as e, createStreamHandler as f, createUploadHandler as g, sseFrame as h, sseMetaFrame as i, sseTextFrame as j, sseErrorFrame as s };
+export { ConfigValidator as C, type HealthCheckResult as H, type IProviderValidator as I, type ValidationError as V, type IProviderHealthChecker as a, VectorPlugin as b, createChatHandler as c, createHealthHandler as d, createIngestHandler as e, createStreamHandler as f, createUploadHandler as g, sseFrame as h, sseMetaFrame as i, sseTextFrame as j, createSuggestionsHandler as k, sseErrorFrame as s };

package/dist/index.d.mts

@@ -1,13 +1,13 @@
 import React$1, { ReactNode } from 'react';
-import { C as ChatMessage, V as VectorMatch, U as UIConfig } from './RagConfig-FyMB_UG6.mjs';
-export { a as ChatOptions, b as ChatResponse, E as EmbedOptions, c as EmbeddingConfig, d as EmbeddingProvider, I as ILLMProvider, e as IngestDocument, L as LLMConfig, f as LLMProvider, R as RAGConfig, g as RagConfig, h as UpsertDocument, i as VectorDBConfig, j as VectorDBProvider } from './RagConfig-FyMB_UG6.mjs';
+import { P as Product, C as ChatMessage, V as VectorMatch, U as UIConfig } from './RagConfig-BOLOz0_O.mjs';
+export { a as ChatOptions, b as ChatResponse, E as EmbedOptions, c as EmbeddingConfig, d as EmbeddingProvider, I as ILLMProvider, e as IngestDocument, L as LLMConfig, f as LLMProvider, R as RAGConfig, g as RagConfig, h as UpsertDocument, i as VectorDBConfig, j as VectorDBProvider } from './RagConfig-BOLOz0_O.mjs';
 export { C as Chunk, a as ChunkOptions } from './DocumentChunker-Dh9TvmGG.mjs';
 
 interface ChatWidgetProps {
     /** Position of the floating button. Defaults to bottom-right. */
     position?: 'bottom-right' | 'bottom-left';
     /** Called when the user clicks 'Add to Cart' on a product */
-    onAddToCart?: (product: any) => void;
+    onAddToCart?: (product: Product) => void;
 }
 declare function ChatWidget({ position, onAddToCart }: ChatWidgetProps): React$1.JSX.Element | null;
 
@@ -31,7 +31,7 @@ interface ChatWindowProps {
     /** Whether the window is currently maximized */
     isMaximized?: boolean;
     /** Called when the user clicks 'Add to Cart' on a product */
-    onAddToCart?: (product: any) => void;
+    onAddToCart?: (product: Product) => void;
 }
 declare function ChatWindow({ className, style, onClose, showClose, onResizeStart, onResetResize, isResized, onMaximize, isMaximized, onAddToCart }: ChatWindowProps): React$1.JSX.Element;
 
@@ -45,16 +45,6 @@ interface DocumentUploadProps {
 }
 declare function DocumentUpload({ namespace, onUploadComplete, className }: DocumentUploadProps): React$1.JSX.Element;
 
-interface Product {
-    id: string | number;
-    name: string;
-    brand?: string;
-    price?: string | number;
-    image?: string;
-    link?: string;
-    description?: string;
-}
-
 interface MessageBubbleProps {
     message: ChatMessage;
     sources?: VectorMatch[];

package/dist/index.d.ts

@@ -1,13 +1,13 @@
 import React$1, { ReactNode } from 'react';
-import { C as ChatMessage, V as VectorMatch, U as UIConfig } from './RagConfig-FyMB_UG6.js';
-export { a as ChatOptions, b as ChatResponse, E as EmbedOptions, c as EmbeddingConfig, d as EmbeddingProvider, I as ILLMProvider, e as IngestDocument, L as LLMConfig, f as LLMProvider, R as RAGConfig, g as RagConfig, h as UpsertDocument, i as VectorDBConfig, j as VectorDBProvider } from './RagConfig-FyMB_UG6.js';
+import { P as Product, C as ChatMessage, V as VectorMatch, U as UIConfig } from './RagConfig-BOLOz0_O.js';
+export { a as ChatOptions, b as ChatResponse, E as EmbedOptions, c as EmbeddingConfig, d as EmbeddingProvider, I as ILLMProvider, e as IngestDocument, L as LLMConfig, f as LLMProvider, R as RAGConfig, g as RagConfig, h as UpsertDocument, i as VectorDBConfig, j as VectorDBProvider } from './RagConfig-BOLOz0_O.js';
 export { C as Chunk, a as ChunkOptions } from './DocumentChunker-Dh9TvmGG.js';
 
 interface ChatWidgetProps {
     /** Position of the floating button. Defaults to bottom-right. */
     position?: 'bottom-right' | 'bottom-left';
     /** Called when the user clicks 'Add to Cart' on a product */
-    onAddToCart?: (product: any) => void;
+    onAddToCart?: (product: Product) => void;
 }
 declare function ChatWidget({ position, onAddToCart }: ChatWidgetProps): React$1.JSX.Element | null;
 
@@ -31,7 +31,7 @@ interface ChatWindowProps {
     /** Whether the window is currently maximized */
     isMaximized?: boolean;
     /** Called when the user clicks 'Add to Cart' on a product */
-    onAddToCart?: (product: any) => void;
+    onAddToCart?: (product: Product) => void;
 }
 declare function ChatWindow({ className, style, onClose, showClose, onResizeStart, onResetResize, isResized, onMaximize, isMaximized, onAddToCart }: ChatWindowProps): React$1.JSX.Element;
 
@@ -45,16 +45,6 @@ interface DocumentUploadProps {
 }
 declare function DocumentUpload({ namespace, onUploadComplete, className }: DocumentUploadProps): React$1.JSX.Element;
 
-interface Product {
-    id: string | number;
-    name: string;
-    brand?: string;
-    price?: string | number;
-    image?: string;
-    link?: string;
-    description?: string;
-}
-
 interface MessageBubbleProps {
     message: ChatMessage;
     sources?: VectorMatch[];

package/dist/index.js

@@ -631,6 +631,32 @@ function ChatWindow({
   const isEmpty = messages.length === 0;
   const currentRadius = BORDER_RADIUS_MAP[ui.borderRadius || "xl"];
   const isGlass = ui.visualStyle !== "solid";
+  const [suggestions, setSuggestions] = (0, import_react7.useState)([]);
+  const [isSuggesting, setIsSuggesting] = (0, import_react7.useState)(false);
+  (0, import_react7.useEffect)(() => {
+    if (input.trim().length < 3) {
+      return;
+    }
+    const timer = setTimeout(async () => {
+      setIsSuggesting(true);
+      try {
+        const response = await fetch("/api/suggestions", {
+          method: "POST",
+          headers: { "Content-Type": "application/json" },
+          body: JSON.stringify({ query: input, namespace: projectId })
+        });
+        const data = await response.json();
+        if (data.suggestions) {
+          setSuggestions(data.suggestions);
+        }
+      } catch (err) {
+        console.error("Failed to fetch suggestions:", err);
+      } finally {
+        setIsSuggesting(false);
+      }
+    }, 800);
+    return () => clearTimeout(timer);
+  }, [input, projectId]);
   return /* @__PURE__ */ import_react7.default.createElement(
     "div",
     {
@@ -742,12 +768,32 @@ function ChatWindow({
         onAddToCart
       }
     ), error && /* @__PURE__ */ import_react7.default.createElement("div", { className: "flex items-center gap-2 text-rose-500 dark:text-rose-400 text-sm bg-rose-50 dark:bg-rose-400/10 border border-rose-200 dark:border-rose-400/20 rounded-xl px-4 py-3" }, /* @__PURE__ */ import_react7.default.createElement(import_lucide_react5.TriangleAlert, { className: "w-4 h-4 flex-shrink-0" }), /* @__PURE__ */ import_react7.default.createElement("span", null, error)), /* @__PURE__ */ import_react7.default.createElement("div", { ref: bottomRef })),
-    /* @__PURE__ */ import_react7.default.createElement("div", { className: `px-4 pb-4 pt-2 border-t border-slate-200 dark:border-white/10 ${isGlass ? "bg-transparent" : "bg-white dark:bg-[#0f0f1a]"}` }, /* @__PURE__ */ import_react7.default.createElement("div", { className: `flex items-end gap-2 bg-slate-50 dark:bg-white/5 border border-slate-200 dark:border-white/10 p-2 focus-within:border-slate-300 dark:focus-within:border-white/20 transition-all ${ui.borderRadius === "full" ? "rounded-3xl" : "rounded-2xl"}` }, /* @__PURE__ */ import_react7.default.createElement(
+    /* @__PURE__ */ import_react7.default.createElement("div", { className: `px-4 pb-4 pt-2 border-t border-slate-200 dark:border-white/10 ${isGlass ? "bg-transparent" : "bg-white dark:bg-[#0f0f1a]"}` }, (suggestions.length > 0 || isSuggesting) && !isLoading && /* @__PURE__ */ import_react7.default.createElement("div", { className: "mb-3 flex flex-wrap gap-2 animate-in fade-in slide-in-from-bottom-2 duration-300" }, suggestions.map((suggestion) => /* @__PURE__ */ import_react7.default.createElement(
+      "button",
+      {
+        key: suggestion,
+        onClick: () => {
+          var _a2;
+          setInput(suggestion);
+          setSuggestions([]);
+          (_a2 = inputRef.current) == null ? void 0 : _a2.focus();
+        },
+        className: "flex items-center gap-1.5 px-3 py-1.5 rounded-xl text-[11px] font-medium bg-white dark:bg-white/5 border border-slate-200 dark:border-white/10 text-slate-600 dark:text-white/60 hover:text-slate-900 dark:hover:text-white/90 hover:border-slate-300 dark:hover:border-white/20 transition-all shadow-sm cursor-pointer group"
+      },
+      /* @__PURE__ */ import_react7.default.createElement(import_lucide_react5.Sparkles, { className: "w-3 h-3 text-amber-400" }),
+      suggestion
+    )), isSuggesting && suggestions.length === 0 && /* @__PURE__ */ import_react7.default.createElement("div", { className: "flex items-center gap-1.5 px-3 py-1.5 rounded-xl text-[11px] font-medium text-slate-400 dark:text-white/30 animate-pulse" }, /* @__PURE__ */ import_react7.default.createElement(import_lucide_react5.Sparkles, { className: "w-3 h-3" }), "Thinking...")), /* @__PURE__ */ import_react7.default.createElement("div", { className: `flex items-end gap-2 bg-slate-50 dark:bg-white/5 border border-slate-200 dark:border-white/10 p-2 focus-within:border-slate-300 dark:focus-within:border-white/20 transition-all ${ui.borderRadius === "full" ? "rounded-3xl" : "rounded-2xl"}` }, /* @__PURE__ */ import_react7.default.createElement(
       "textarea",
       {
         ref: inputRef,
         value: input,
-        onChange: (e) => setInput(e.target.value),
+        onChange: (e) => {
+          const val = e.target.value;
+          setInput(val);
+          if (val.trim().length < 3) {
+            setSuggestions([]);
+          }
+        },
         onKeyDown: handleKeyDown,
         placeholder: ui.placeholder,
         rows: 1,

package/dist/index.mjs

@@ -573,6 +573,32 @@ function ChatWindow({
   const isEmpty = messages.length === 0;
   const currentRadius = BORDER_RADIUS_MAP[ui.borderRadius || "xl"];
   const isGlass = ui.visualStyle !== "solid";
+  const [suggestions, setSuggestions] = useState4([]);
+  const [isSuggesting, setIsSuggesting] = useState4(false);
+  useEffect4(() => {
+    if (input.trim().length < 3) {
+      return;
+    }
+    const timer = setTimeout(async () => {
+      setIsSuggesting(true);
+      try {
+        const response = await fetch("/api/suggestions", {
+          method: "POST",
+          headers: { "Content-Type": "application/json" },
+          body: JSON.stringify({ query: input, namespace: projectId })
+        });
+        const data = await response.json();
+        if (data.suggestions) {
+          setSuggestions(data.suggestions);
+        }
+      } catch (err) {
+        console.error("Failed to fetch suggestions:", err);
+      } finally {
+        setIsSuggesting(false);
+      }
+    }, 800);
+    return () => clearTimeout(timer);
+  }, [input, projectId]);
   return /* @__PURE__ */ React7.createElement(
     "div",
     {
@@ -684,12 +710,32 @@ function ChatWindow({
         onAddToCart
       }
     ), error && /* @__PURE__ */ React7.createElement("div", { className: "flex items-center gap-2 text-rose-500 dark:text-rose-400 text-sm bg-rose-50 dark:bg-rose-400/10 border border-rose-200 dark:border-rose-400/20 rounded-xl px-4 py-3" }, /* @__PURE__ */ React7.createElement(TriangleAlert, { className: "w-4 h-4 flex-shrink-0" }), /* @__PURE__ */ React7.createElement("span", null, error)), /* @__PURE__ */ React7.createElement("div", { ref: bottomRef })),
-    /* @__PURE__ */ React7.createElement("div", { className: `px-4 pb-4 pt-2 border-t border-slate-200 dark:border-white/10 ${isGlass ? "bg-transparent" : "bg-white dark:bg-[#0f0f1a]"}` }, /* @__PURE__ */ React7.createElement("div", { className: `flex items-end gap-2 bg-slate-50 dark:bg-white/5 border border-slate-200 dark:border-white/10 p-2 focus-within:border-slate-300 dark:focus-within:border-white/20 transition-all ${ui.borderRadius === "full" ? "rounded-3xl" : "rounded-2xl"}` }, /* @__PURE__ */ React7.createElement(
+    /* @__PURE__ */ React7.createElement("div", { className: `px-4 pb-4 pt-2 border-t border-slate-200 dark:border-white/10 ${isGlass ? "bg-transparent" : "bg-white dark:bg-[#0f0f1a]"}` }, (suggestions.length > 0 || isSuggesting) && !isLoading && /* @__PURE__ */ React7.createElement("div", { className: "mb-3 flex flex-wrap gap-2 animate-in fade-in slide-in-from-bottom-2 duration-300" }, suggestions.map((suggestion) => /* @__PURE__ */ React7.createElement(
+      "button",
+      {
+        key: suggestion,
+        onClick: () => {
+          var _a2;
+          setInput(suggestion);
+          setSuggestions([]);
+          (_a2 = inputRef.current) == null ? void 0 : _a2.focus();
+        },
+        className: "flex items-center gap-1.5 px-3 py-1.5 rounded-xl text-[11px] font-medium bg-white dark:bg-white/5 border border-slate-200 dark:border-white/10 text-slate-600 dark:text-white/60 hover:text-slate-900 dark:hover:text-white/90 hover:border-slate-300 dark:hover:border-white/20 transition-all shadow-sm cursor-pointer group"
+      },
+      /* @__PURE__ */ React7.createElement(Sparkles, { className: "w-3 h-3 text-amber-400" }),
+      suggestion
+    )), isSuggesting && suggestions.length === 0 && /* @__PURE__ */ React7.createElement("div", { className: "flex items-center gap-1.5 px-3 py-1.5 rounded-xl text-[11px] font-medium text-slate-400 dark:text-white/30 animate-pulse" }, /* @__PURE__ */ React7.createElement(Sparkles, { className: "w-3 h-3" }), "Thinking...")), /* @__PURE__ */ React7.createElement("div", { className: `flex items-end gap-2 bg-slate-50 dark:bg-white/5 border border-slate-200 dark:border-white/10 p-2 focus-within:border-slate-300 dark:focus-within:border-white/20 transition-all ${ui.borderRadius === "full" ? "rounded-3xl" : "rounded-2xl"}` }, /* @__PURE__ */ React7.createElement(
       "textarea",
       {
         ref: inputRef,
         value: input,
-        onChange: (e) => setInput(e.target.value),
+        onChange: (e) => {
+          const val = e.target.value;
+          setInput(val);
+          if (val.trim().length < 3) {
+            setSuggestions([]);
+          }
+        },
         onKeyDown: handleKeyDown,
         placeholder: ui.placeholder,
         rows: 1,

package/dist/server.d.mts

@@ -1,7 +1,7 @@
-import { i as VectorDBConfig, L as LLMConfig, c as EmbeddingConfig, g as RagConfig, e as IngestDocument, C as ChatMessage, b as ChatResponse, k as RetrievalResult, h as UpsertDocument, V as VectorMatch, G as GraphDBConfig, l as GraphNode, m as Edge, n as GraphSearchResult, I as ILLMProvider, j as VectorDBProvider, f as LLMProvider, d as EmbeddingProvider, R as RAGConfig, U as UIConfig, a as ChatOptions, E as EmbedOptions } from './RagConfig-FyMB_UG6.mjs';
+import { i as VectorDBConfig, L as LLMConfig, c as EmbeddingConfig, g as RagConfig, e as IngestDocument, C as ChatMessage, b as ChatResponse, k as RetrievalResult, h as UpsertDocument, V as VectorMatch, G as GraphDBConfig, l as GraphNode, m as Edge, n as GraphSearchResult, I as ILLMProvider, j as VectorDBProvider, f as LLMProvider, d as EmbeddingProvider, R as RAGConfig, U as UIConfig, a as ChatOptions, E as EmbedOptions } from './RagConfig-BOLOz0_O.mjs';
 export { C as Chunk, a as ChunkOptions, D as DocumentChunker } from './DocumentChunker-Dh9TvmGG.mjs';
-import { H as HealthCheckResult, I as IProviderValidator, a as IProviderHealthChecker } from './index-D-lfcqlL.mjs';
-export { C as ConfigValidator, V as ValidationError, b as VectorPlugin, c as createChatHandler, d as createHealthHandler, e as createIngestHandler, f as createStreamHandler, g as createUploadHandler, s as sseErrorFrame, h as sseFrame, i as sseMetaFrame, j as sseTextFrame } from './index-D-lfcqlL.mjs';
+import { H as HealthCheckResult, I as IProviderValidator, a as IProviderHealthChecker } from './index-64BDupW3.mjs';
+export { C as ConfigValidator, V as ValidationError, b as VectorPlugin, c as createChatHandler, d as createHealthHandler, e as createIngestHandler, f as createStreamHandler, g as createUploadHandler, s as sseErrorFrame, h as sseFrame, i as sseMetaFrame, j as sseTextFrame } from './index-64BDupW3.mjs';
 import 'next/server';
 
 /**
@@ -166,6 +166,10 @@ declare class Pipeline {
      * Rewrite the user query for better retrieval performance.
      */
     private rewriteQuery;
+    /**
+     * Generate 3-5 short, relevant questions based on the vector database content.
+     */
+    getSuggestions(query: string, namespace?: string): Promise<string[]>;
 }
 
 /**

package/dist/server.d.ts

@@ -1,7 +1,7 @@
-import { i as VectorDBConfig, L as LLMConfig, c as EmbeddingConfig, g as RagConfig, e as IngestDocument, C as ChatMessage, b as ChatResponse, k as RetrievalResult, h as UpsertDocument, V as VectorMatch, G as GraphDBConfig, l as GraphNode, m as Edge, n as GraphSearchResult, I as ILLMProvider, j as VectorDBProvider, f as LLMProvider, d as EmbeddingProvider, R as RAGConfig, U as UIConfig, a as ChatOptions, E as EmbedOptions } from './RagConfig-FyMB_UG6.js';
+import { i as VectorDBConfig, L as LLMConfig, c as EmbeddingConfig, g as RagConfig, e as IngestDocument, C as ChatMessage, b as ChatResponse, k as RetrievalResult, h as UpsertDocument, V as VectorMatch, G as GraphDBConfig, l as GraphNode, m as Edge, n as GraphSearchResult, I as ILLMProvider, j as VectorDBProvider, f as LLMProvider, d as EmbeddingProvider, R as RAGConfig, U as UIConfig, a as ChatOptions, E as EmbedOptions } from './RagConfig-BOLOz0_O.js';
 export { C as Chunk, a as ChunkOptions, D as DocumentChunker } from './DocumentChunker-Dh9TvmGG.js';
-import { H as HealthCheckResult, I as IProviderValidator, a as IProviderHealthChecker } from './index-CYgr00ot.js';
-export { C as ConfigValidator, V as ValidationError, b as VectorPlugin, c as createChatHandler, d as createHealthHandler, e as createIngestHandler, f as createStreamHandler, g as createUploadHandler, s as sseErrorFrame, h as sseFrame, i as sseMetaFrame, j as sseTextFrame } from './index-CYgr00ot.js';
+import { H as HealthCheckResult, I as IProviderValidator, a as IProviderHealthChecker } from './index-DbtE8wLM.js';
+export { C as ConfigValidator, V as ValidationError, b as VectorPlugin, c as createChatHandler, d as createHealthHandler, e as createIngestHandler, f as createStreamHandler, g as createUploadHandler, s as sseErrorFrame, h as sseFrame, i as sseMetaFrame, j as sseTextFrame } from './index-DbtE8wLM.js';
 import 'next/server';
 
 /**
@@ -166,6 +166,10 @@ declare class Pipeline {
      * Rewrite the user query for better retrieval performance.
      */
     private rewriteQuery;
+    /**
+     * Generate 3-5 short, relevant questions based on the vector database content.
+     */
+    getSuggestions(query: string, namespace?: string): Promise<string[]>;
 }
 
 /**

package/dist/server.js

@@ -4177,6 +4177,50 @@ Optimized Search Query:`;
     );
     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
@@ -4331,6 +4375,13 @@ var VectorPlugin = class {
     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

package/dist/server.mjs

@@ -39,7 +39,7 @@ import {
   sseFrame,
   sseMetaFrame,
   sseTextFrame
-} from "./chunk-OCDCJUNE.mjs";
+} from "./chunk-GCPPRD2G.mjs";
 import "./chunk-YLTMFW4M.mjs";
 import {
   PineconeProvider

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@retrivora-ai/rag-engine",
-  "version": "1.2.0",
+  "version": "1.2.1",
   "description": "Retrivora AI is a plug-and-play AI engine for RAG chat experiences — generic vector DB + LLM provider, embeddable or standalone.",
   "author": "Abhinav Alkuchi",
   "license": "MIT",

package/src/app/api/suggestions/route.ts

@@ -0,0 +1,4 @@
+import { createSuggestionsHandler } from '@/handlers';
+import { getRagConfig } from '@/config/serverConfig';
+
+export const POST = createSuggestionsHandler(getRagConfig());

package/src/components/ChatWidget.tsx

@@ -4,12 +4,13 @@ import React, { useState } from 'react';
 import { MessageSquare, X } from 'lucide-react';
 import { ChatWindow } from './ChatWindow';
 import { useConfig } from './ConfigProvider';
+import { Product } from '../types';
 
 interface ChatWidgetProps {
   /** Position of the floating button. Defaults to bottom-right. */
   position?: 'bottom-right' | 'bottom-left';
   /** Called when the user clicks 'Add to Cart' on a product */
-  onAddToCart?: (product: any) => void;
+  onAddToCart?: (product: Product) => void;
 }
 
 const DEFAULT_DIMENSIONS = { width: 380, height: 600 };

package/src/components/ChatWindow.tsx

@@ -16,6 +16,7 @@ import { MessageBubble } from './MessageBubble';
 import { useConfig } from './ConfigProvider';
 import { useRagChat } from '../hooks/useRagChat';
 import { BORDER_RADIUS_MAP, CHAT_SUGGESTIONS } from '../config/uiConstants';
+import { Product } from '../types';
 
 interface ChatWindowProps {
   /** Additional className for the wrapper div */
@@ -37,7 +38,7 @@ interface ChatWindowProps {
   /** Whether the window is currently maximized */
   isMaximized?: boolean;
   /** Called when the user clicks 'Add to Cart' on a product */
-  onAddToCart?: (product: any) => void;
+  onAddToCart?: (product: Product) => void;
 }
 
 export function ChatWindow({ 
@@ -97,6 +98,37 @@ export function ChatWindow({
     const currentRadius = BORDER_RADIUS_MAP[ui.borderRadius || 'xl'];
   const isGlass = ui.visualStyle !== 'solid';
 
+  const [suggestions, setSuggestions] = useState<string[]>([]);
+  const [isSuggesting, setIsSuggesting] = useState(false);
+
+  // Auto-suggestions fetcher (debounced)
+  useEffect(() => {
+    if (input.trim().length < 3) {
+      return;
+    }
+
+    const timer = setTimeout(async () => {
+      setIsSuggesting(true);
+      try {
+        const response = await fetch('/api/suggestions', {
+          method: 'POST',
+          headers: { 'Content-Type': 'application/json' },
+          body: JSON.stringify({ query: input, namespace: projectId }),
+        });
+        const data = await response.json();
+        if (data.suggestions) {
+          setSuggestions(data.suggestions);
+        }
+      } catch (err) {
+        console.error('Failed to fetch suggestions:', err);
+      } finally {
+        setIsSuggesting(false);
+      }
+    }, 800); // 800ms debounce to save costs/latency
+
+    return () => clearTimeout(timer);
+  }, [input, projectId]);
+
   return (
     <div
       className={`relative flex flex-col border border-slate-200 dark:border-white/10 shadow-2xl transition-all duration-300 ${currentRadius} ${
@@ -265,11 +297,44 @@ export function ChatWindow({
 
       {/* ── Input ── */}
       <div className={`px-4 pb-4 pt-2 border-t border-slate-200 dark:border-white/10 ${isGlass ? 'bg-transparent' : 'bg-white dark:bg-[#0f0f1a]'}`}>
+        
+        {/* Dynamic Suggestions */}
+        {(suggestions.length > 0 || isSuggesting) && !isLoading && (
+          <div className="mb-3 flex flex-wrap gap-2 animate-in fade-in slide-in-from-bottom-2 duration-300">
+            {suggestions.map((suggestion) => (
+              <button
+                key={suggestion}
+                onClick={() => {
+                  setInput(suggestion);
+                  setSuggestions([]);
+                  inputRef.current?.focus();
+                }}
+                className="flex items-center gap-1.5 px-3 py-1.5 rounded-xl text-[11px] font-medium bg-white dark:bg-white/5 border border-slate-200 dark:border-white/10 text-slate-600 dark:text-white/60 hover:text-slate-900 dark:hover:text-white/90 hover:border-slate-300 dark:hover:border-white/20 transition-all shadow-sm cursor-pointer group"
+              >
+                <Sparkles className="w-3 h-3 text-amber-400" />
+                {suggestion}
+              </button>
+            ))}
+            {isSuggesting && suggestions.length === 0 && (
+              <div className="flex items-center gap-1.5 px-3 py-1.5 rounded-xl text-[11px] font-medium text-slate-400 dark:text-white/30 animate-pulse">
+                <Sparkles className="w-3 h-3" />
+                Thinking...
+              </div>
+            )}
+          </div>
+        )}
+
         <div className={`flex items-end gap-2 bg-slate-50 dark:bg-white/5 border border-slate-200 dark:border-white/10 p-2 focus-within:border-slate-300 dark:focus-within:border-white/20 transition-all ${ui.borderRadius === 'full' ? 'rounded-3xl' : 'rounded-2xl'}`}>
           <textarea
             ref={inputRef}
             value={input}
-            onChange={(e) => setInput(e.target.value)}
+            onChange={(e) => {
+              const val = e.target.value;
+              setInput(val);
+              if (val.trim().length < 3) {
+                setSuggestions([]);
+              }
+            }}
             onKeyDown={handleKeyDown}
             placeholder={ui.placeholder}
             rows={1}

package/src/components/MessageBubble.tsx

@@ -8,7 +8,7 @@ import { ChatMessage } from '../llm/ILLMProvider';
 import { VectorMatch } from '../types';
 import { SourceCard } from './SourceCard';
 import { ProductCarousel } from './ProductCarousel';
-import { Product } from './ProductCard';
+import { Product } from '../types';
 
 interface MessageBubbleProps {
   message: ChatMessage;

package/src/components/ProductCard.tsx

@@ -4,15 +4,7 @@ import React from 'react';
 import Image from 'next/image';
 import { ShoppingCart, ExternalLink } from 'lucide-react';
 
-export interface Product {
-  id: string | number;
-  name: string;
-  brand?: string;
-  price?: string | number;
-  image?: string;
-  link?: string;
-  description?: string;
-}
+import { Product } from '../types';
 
 interface ProductCardProps {
   product: Product;

package/src/components/ProductCarousel.tsx

@@ -2,7 +2,8 @@
 
 import React, { useRef, useState, useEffect } from 'react';
 import { ChevronLeft, ChevronRight } from 'lucide-react';
-import { Product, ProductCard } from './ProductCard';
+import { ProductCard } from './ProductCard';
+import { Product } from '../types';
 
 interface ProductCarouselProps {
   products: Product[];

package/src/core/Pipeline.ts

@@ -423,4 +423,59 @@ Optimized Search Query:`;
 
     return rewrite.trim() || question;
   }
+
+  /**
+   * Generate 3-5 short, relevant questions based on the vector database content.
+   */
+  async getSuggestions(query: string, namespace?: string): Promise<string[]> {
+    if (!query || query.trim().length < 3) {
+      return [];
+    }
+
+    await this.initialize();
+    const ns = namespace ?? this.config.projectId;
+
+    try {
+      // 1. Retrieve relevant context (top 3 matches)
+      const { sources } = await this.retrieve(query, { namespace: ns, topK: 3 });
+
+      if (sources.length === 0) {
+        return [];
+      }
+
+      // 2. Generate suggestions using LLM
+      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 }
+        ],
+        ''
+      );
+
+      // Simple parsing of JSON array from LLM response
+      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 [];
+  }
 }

package/src/core/VectorPlugin.ts

@@ -81,4 +81,11 @@ export class VectorPlugin {
     return this.pipeline.ingest(documents, namespace);
   }
 
+  /**
+   * Get auto-suggestions based on a query prefix.
+   */
+  async getSuggestions(query: string, namespace?: string): Promise<string[]> {
+    await this.validationPromise;
+    return this.pipeline.getSuggestions(query, namespace);
+  }
 }

package/src/handlers/index.ts

@@ -261,5 +261,35 @@ export function createUploadHandler(configOrPlugin?: Partial<RagConfig> | Vector
   };
 }
 
+/**
+ * createSuggestionsHandler — factory for the auto-suggestions endpoint.
+ */
+export function createSuggestionsHandler(configOrPlugin?: Partial<RagConfig> | VectorPlugin) {
+  const plugin =
+    configOrPlugin instanceof VectorPlugin
+      ? configOrPlugin
+      : new VectorPlugin(configOrPlugin);
+
+  return async function POST(req: NextRequest) {
+    try {
+      const body = await req.json();
+      const { query, namespace } = body as {
+        query: string;
+        namespace?: string;
+      };
+
+      if (typeof query !== 'string') {
+        return NextResponse.json({ error: 'query is required' }, { status: 400 });
+      }
+
+      const suggestions = await plugin.getSuggestions(query, namespace);
+      return NextResponse.json({ suggestions });
+    } catch (err) {
+      const message = err instanceof Error ? err.message : 'Internal server error';
+      return NextResponse.json({ error: message }, { status: 500 });
+    }
+  };
+}
+
 // Re-export SSE helper so host apps can use it in custom handlers
 export { sseFrame, sseTextFrame, sseMetaFrame, sseErrorFrame };

package/src/types/index.ts

@@ -50,3 +50,17 @@ export interface RetrievalResult {
 export interface IRetriever {
   retrieve(query: string, options?: Record<string, unknown>): Promise<RetrievalResult>;
 }
+
+export interface SuggestionsResponse {
+  suggestions: string[];
+}
+
+export interface Product {
+  id: string | number;
+  name: string;
+  brand?: string;
+  price?: string | number;
+  image?: string;
+  link?: string;
+  description?: string;
+}