@retrivora-ai/rag-engine 1.8.0 → 1.8.2

package/dist/handlers/index.mjs

@@ -8,9 +8,11 @@ import {
   sseErrorFrame,
   sseFrame,
   sseMetaFrame,
+  sseObservabilityFrame,
   sseTextFrame,
   sseUIFrame
-} from "../chunk-PV3MFHWU.mjs";
+} from "../chunk-LZVVLSDN.mjs";
+import "../chunk-ICKRMZQK.mjs";
 import "../chunk-YLTMFW4M.mjs";
 import "../chunk-X4TOT24V.mjs";
 export {
@@ -23,6 +25,7 @@ export {
   sseErrorFrame,
   sseFrame,
   sseMetaFrame,
+  sseObservabilityFrame,
   sseTextFrame,
   sseUIFrame
 };

package/dist/{index-Bb2yEopi.d.mts → index-BwpcaziY.d.ts}

@@ -1,4 +1,4 @@
-import { h as RagConfig, C as ChatMessage, d as ChatResponse, I as IngestDocument } from './index-DPsQodME.mjs';
+import { k as RagConfig, I as ILLMProvider, C as ChatMessage, d as ChatResponse, g as IngestDocument } from './ILLMProvider-BOJFz3Na.js';
 import { NextRequest, NextResponse } from 'next/server';
 
 interface ValidationError {
@@ -85,6 +85,12 @@ declare class VectorPlugin {
      * Get the current resolved configuration.
      */
     getConfig(): RagConfig;
+    /**
+     * Get the initialized LLM provider (available after the first request).
+     * Used by handlers to pass to UITransformer.analyzeAndDecide() for
+     * LLM-driven visualization decisions.
+     */
+    getLLMProvider(): ILLMProvider | undefined;
     /**
      * Perform pre-flight health checks on all configured providers.
      * Useful to verify connectivity before running operations.
@@ -129,6 +135,8 @@ declare function sseTextFrame(text: string): string;
 declare function sseMetaFrame(meta: unknown): string;
 /** Encode the UI transformation result as an SSE frame. */
 declare function sseUIFrame(uiTransformation: unknown): string;
+/** Encode the observability trace as an SSE frame. */
+declare function sseObservabilityFrame(trace: unknown): string;
 /** Encode a stream error as an SSE frame. */
 declare function sseErrorFrame(message: string): string;
 /**
@@ -217,4 +225,4 @@ declare function createSuggestionsHandler(configOrPlugin?: Partial<RagConfig> |
     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, createSuggestionsHandler as k, sseUIFrame as l, 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, sseObservabilityFrame as l, sseUIFrame as m, sseErrorFrame as s };

package/dist/{index-CkbTzj9J.d.ts → index-D3V9Et2M.d.mts}

@@ -1,4 +1,4 @@
-import { h as RagConfig, C as ChatMessage, d as ChatResponse, I as IngestDocument } from './index-DPsQodME.js';
+import { k as RagConfig, I as ILLMProvider, C as ChatMessage, d as ChatResponse, g as IngestDocument } from './ILLMProvider-BOJFz3Na.mjs';
 import { NextRequest, NextResponse } from 'next/server';
 
 interface ValidationError {
@@ -85,6 +85,12 @@ declare class VectorPlugin {
      * Get the current resolved configuration.
      */
     getConfig(): RagConfig;
+    /**
+     * Get the initialized LLM provider (available after the first request).
+     * Used by handlers to pass to UITransformer.analyzeAndDecide() for
+     * LLM-driven visualization decisions.
+     */
+    getLLMProvider(): ILLMProvider | undefined;
     /**
      * Perform pre-flight health checks on all configured providers.
      * Useful to verify connectivity before running operations.
@@ -129,6 +135,8 @@ declare function sseTextFrame(text: string): string;
 declare function sseMetaFrame(meta: unknown): string;
 /** Encode the UI transformation result as an SSE frame. */
 declare function sseUIFrame(uiTransformation: unknown): string;
+/** Encode the observability trace as an SSE frame. */
+declare function sseObservabilityFrame(trace: unknown): string;
 /** Encode a stream error as an SSE frame. */
 declare function sseErrorFrame(message: string): string;
 /**
@@ -217,4 +225,4 @@ declare function createSuggestionsHandler(configOrPlugin?: Partial<RagConfig> |
     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, createSuggestionsHandler as k, sseUIFrame as l, 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, sseObservabilityFrame as l, sseUIFrame as m, sseErrorFrame as s };

package/dist/index.d.mts

@@ -1,7 +1,7 @@
 import React, { CSSProperties, MouseEvent, ReactNode } from 'react';
-import { P as Product, U as UIConfig, R as RagMessage, V as VectorMatch, a as UseRagChatOptions, b as UseRagChatReturn } from './index-DPsQodME.mjs';
-export { C as ChatMessage, c as ChatOptions, d as ChatResponse, E as EmbeddingConfig, e as EmbeddingProvider, I as IngestDocument, L as LLMConfig, f as LLMProvider, g as RAGConfig, h as RagConfig, i as UpsertDocument, j as VectorDBConfig, k as VectorDBProvider } from './index-DPsQodME.mjs';
-export { C as Chunk, a as ChunkOptions, E as EmbedOptions, I as ILLMProvider } from './DocumentChunker-CFEiRopR.mjs';
+import { P as Product, U as UIConfig, R as RagMessage, V as VectorMatch, O as ObservabilityTrace, a as UseRagChatOptions, b as UseRagChatReturn } from './ILLMProvider-BOJFz3Na.mjs';
+export { C as ChatMessage, c as ChatOptions, d as ChatResponse, E as EmbedOptions, e as EmbeddingConfig, f as EmbeddingProvider, I as ILLMProvider, g as IngestDocument, L as LLMConfig, h as LLMProvider, i as LatencyBreakdown, j as RAGConfig, k as RagConfig, l as RetrievedChunk, T as TokenUsage, m as UpsertDocument, n as VectorDBConfig, o as VectorDBProvider } from './ILLMProvider-BOJFz3Na.mjs';
+export { C as Chunk, a as ChunkOptions } from './DocumentChunker-Dh9TvmGG.mjs';
 
 type ChatViewportSize = 'compact' | 'medium' | 'large';
 interface ChatWindowProps {
@@ -66,11 +66,19 @@ interface SourceCardProps {
 interface ClientConfig {
     projectId: string;
     ui: Required<UIConfig>;
+    embedding?: {
+        model?: string;
+        dimensions?: number;
+    };
 }
 interface ConfigProviderProps {
     config?: {
         projectId?: string;
         ui?: Partial<UIConfig>;
+        embedding?: {
+            model?: string;
+            dimensions?: number;
+        };
     };
     children: ReactNode;
 }
@@ -85,6 +93,12 @@ declare function MessageBubble({ message, sources, isStreaming, primaryColor, ac
 
 declare function SourceCard({ source, index }: SourceCardProps): React.JSX.Element;
 
+interface ObservabilityPanelProps {
+    trace: ObservabilityTrace;
+    primaryColor?: string;
+}
+declare function ObservabilityPanel({ trace, primaryColor }: ObservabilityPanelProps): React.JSX.Element;
+
 /**
  * ConfigProvider — React Context that makes RagConfig (UI subset) available
  * to all child components without prop drilling.
@@ -97,4 +111,10 @@ declare function useConfig(): ClientConfig;
 
 declare function useRagChat(projectId: string, options?: UseRagChatOptions): UseRagChatReturn;
 
-export { ChatWidget, type ChatWidgetProps, ChatWindow, type ChatWindowProps, type ClientConfig, ConfigProvider, DocumentUpload, type DocumentUploadProps, MessageBubble, type MessageBubbleProps, type ProductCardProps, type ProductCarouselProps, RagMessage, SourceCard, type SourceCardProps, UIConfig, UseRagChatOptions, UseRagChatReturn, VectorMatch, useConfig, useRagChat };
+/**
+ * Dynamically registers new synonyms into the global FIELD_SYNONYMS dictionary.
+ * You can call this during your app initialization to support custom schema fields.
+ */
+declare function addSynonyms(customSynonyms: Record<string, string[]>): void;
+
+export { ChatWidget, type ChatWidgetProps, ChatWindow, type ChatWindowProps, type ClientConfig, ConfigProvider, DocumentUpload, type DocumentUploadProps, MessageBubble, type MessageBubbleProps, ObservabilityPanel, ObservabilityTrace, type ProductCardProps, type ProductCarouselProps, RagMessage, SourceCard, type SourceCardProps, UIConfig, UseRagChatOptions, UseRagChatReturn, VectorMatch, addSynonyms, useConfig, useRagChat };

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import React, { CSSProperties, MouseEvent, ReactNode } from 'react';
-import { P as Product, U as UIConfig, R as RagMessage, V as VectorMatch, a as UseRagChatOptions, b as UseRagChatReturn } from './index-DPsQodME.js';
-export { C as ChatMessage, c as ChatOptions, d as ChatResponse, E as EmbeddingConfig, e as EmbeddingProvider, I as IngestDocument, L as LLMConfig, f as LLMProvider, g as RAGConfig, h as RagConfig, i as UpsertDocument, j as VectorDBConfig, k as VectorDBProvider } from './index-DPsQodME.js';
-export { C as Chunk, a as ChunkOptions, E as EmbedOptions, I as ILLMProvider } from './DocumentChunker-C1GEEosY.js';
+import { P as Product, U as UIConfig, R as RagMessage, V as VectorMatch, O as ObservabilityTrace, a as UseRagChatOptions, b as UseRagChatReturn } from './ILLMProvider-BOJFz3Na.js';
+export { C as ChatMessage, c as ChatOptions, d as ChatResponse, E as EmbedOptions, e as EmbeddingConfig, f as EmbeddingProvider, I as ILLMProvider, g as IngestDocument, L as LLMConfig, h as LLMProvider, i as LatencyBreakdown, j as RAGConfig, k as RagConfig, l as RetrievedChunk, T as TokenUsage, m as UpsertDocument, n as VectorDBConfig, o as VectorDBProvider } from './ILLMProvider-BOJFz3Na.js';
+export { C as Chunk, a as ChunkOptions } from './DocumentChunker-Dh9TvmGG.js';
 
 type ChatViewportSize = 'compact' | 'medium' | 'large';
 interface ChatWindowProps {
@@ -66,11 +66,19 @@ interface SourceCardProps {
 interface ClientConfig {
     projectId: string;
     ui: Required<UIConfig>;
+    embedding?: {
+        model?: string;
+        dimensions?: number;
+    };
 }
 interface ConfigProviderProps {
     config?: {
         projectId?: string;
         ui?: Partial<UIConfig>;
+        embedding?: {
+            model?: string;
+            dimensions?: number;
+        };
     };
     children: ReactNode;
 }
@@ -85,6 +93,12 @@ declare function MessageBubble({ message, sources, isStreaming, primaryColor, ac
 
 declare function SourceCard({ source, index }: SourceCardProps): React.JSX.Element;
 
+interface ObservabilityPanelProps {
+    trace: ObservabilityTrace;
+    primaryColor?: string;
+}
+declare function ObservabilityPanel({ trace, primaryColor }: ObservabilityPanelProps): React.JSX.Element;
+
 /**
  * ConfigProvider — React Context that makes RagConfig (UI subset) available
  * to all child components without prop drilling.
@@ -97,4 +111,10 @@ declare function useConfig(): ClientConfig;
 
 declare function useRagChat(projectId: string, options?: UseRagChatOptions): UseRagChatReturn;
 
-export { ChatWidget, type ChatWidgetProps, ChatWindow, type ChatWindowProps, type ClientConfig, ConfigProvider, DocumentUpload, type DocumentUploadProps, MessageBubble, type MessageBubbleProps, type ProductCardProps, type ProductCarouselProps, RagMessage, SourceCard, type SourceCardProps, UIConfig, UseRagChatOptions, UseRagChatReturn, VectorMatch, useConfig, useRagChat };
+/**
+ * Dynamically registers new synonyms into the global FIELD_SYNONYMS dictionary.
+ * You can call this during your app initialization to support custom schema fields.
+ */
+declare function addSynonyms(customSynonyms: Record<string, string[]>): void;
+
+export { ChatWidget, type ChatWidgetProps, ChatWindow, type ChatWindowProps, type ClientConfig, ConfigProvider, DocumentUpload, type DocumentUploadProps, MessageBubble, type MessageBubbleProps, ObservabilityPanel, ObservabilityTrace, type ProductCardProps, type ProductCarouselProps, RagMessage, SourceCard, type SourceCardProps, UIConfig, UseRagChatOptions, UseRagChatReturn, VectorMatch, addSynonyms, useConfig, useRagChat };