@retrivora-ai/rag-engine 1.1.9 → 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[];