@retrivora-ai/rag-engine 2.3.1 → 2.3.3

package/dist/server.d.mts

@@ -1,54 +1,12 @@
-import { V as VectorDBConfig, L as LLMConfig, d as EmbeddingConfig, i as RagConfig, n as UniversalRagConfig, o as UpsertDocument, q as VectorMatch, G as GraphDBConfig, r as GraphNode, s as Edge, t as GraphSearchResult, I as ILLMProvider, p as VectorDBProvider, g as LLMProvider, e as EmbeddingProvider, R as RAGConfig, m as UIConfig, C as ChatMessage, b as ChatOptions, E as EmbedOptions } from './ILLMProvider-teTNQ1lh.mjs';
-export { B as BarChartData, u as CarouselProduct, c as ChatResponse, v as IRetriever, f as IngestDocument, h as LatencyBreakdown, w as LineChartDataPoint, M as MessageRole, x as MetricCardData, O as ObservabilityTrace, P as PieChartData, y as Product, j as RagMessage, k as RetrievalConfig, z as RetrievalResult, l as RetrievedChunk, A as RetrivoraChunkMetadata, D as RetrivoraIngestedDocument, S as ScatterPlotDataPoint, F as SuggestionsResponse, H as TableData, T as TokenUsage, J as UITransformationResponse, U as UseRagChatOptions, a as UseRagChatReturn, K as VisualizationType, W as WorkflowConfig } from './ILLMProvider-teTNQ1lh.mjs';
-import { I as IRenderRule, k as DecisionContext, m as IntentCategory, s as RenderDecision } from './BatchProcessor-7yV-UCHW.mjs';
-export { K as ArchitectureCardProps, A as AuthenticationException, B as BatchOptions, e as BatchProcessor, f as BatchResult, N as CarouselRendererStrategy, O as ChartRendererStrategy, g as ChartType, Q as ChatViewportSize, C as ChatWidgetProps, a as ChatWindowProps, h as Chunk, i as ChunkOptions, c as ClientConfig, b as ConfigProviderProps, j as ConfigurationException, T as DocumentChunker, D as DocumentUploadProps, E as EmbeddingFailedException, l as IRendererStrategy, n as IntentClassifier, L as LicenseValidationError, o as LicenseValidationRequest, p as LicenseValidationResponse, q as LicenseValidator, M as MessageBubbleProps, U as MixedRendererStrategy, W as Pipeline, X as PipelineStep, P as ProductCardProps, d as ProductCarouselProps, r as ProviderNotFoundException, Y as ProviderPill, R as RateLimitException, Z as RenderSectionDecision, t as RenderType, u as RendererRegistry, v as RetrievalException, w as Retrivora, x as RetrivoraError, y as RetrivoraErrorCode, z as RuleEngine, F as SDKVersionUnsupportedError, G as SDK_VERSION, _ as Snippet, S as SourceCardProps, $ as TableRendererStrategy, a0 as TextRendererStrategy, V as VisualizationDecisionEngine, H as decideVisualization, a1 as wrapError } from './BatchProcessor-7yV-UCHW.mjs';
-import { H as HealthCheckResult, I as IProviderValidator, a as IProviderHealthChecker } from './index-fnpaCuma.mjs';
-export { C as ConfigValidator, b as HandlerOptions, V as ValidationError, c as VectorPlugin, d as createChatHandler, e as createFeedbackHandler, f as createHealthHandler, g as createHistoryHandler, h as createIngestHandler, i as createRagHandler, j as createSessionsHandler, k as createStreamHandler, l as createUploadHandler, s as sseErrorFrame, m as sseFrame, n as sseMetaFrame, o as sseTextFrame } from './index-fnpaCuma.mjs';
+import { V as VectorDBConfig, L as LLMConfig, d as EmbeddingConfig, i as RagConfig, n as UniversalRagConfig, o as UpsertDocument, q as VectorMatch, G as GraphDBConfig, r as GraphNode, s as Edge, t as GraphSearchResult, I as ILLMProvider, p as VectorDBProvider, g as LLMProvider, e as EmbeddingProvider, R as RAGConfig, m as UIConfig, u as UITransformationResponse, C as ChatMessage, b as ChatOptions, E as EmbedOptions } from './ILLMProvider-CcJ5N6XD.mjs';
+export { B as BarChartData, v as CarouselProduct, c as ChatResponse, w as IRetriever, f as IngestDocument, h as LatencyBreakdown, x as LineChartDataPoint, M as MessageRole, y as MetricCardData, O as ObservabilityTrace, P as PieChartData, z as Product, j as RagMessage, k as RetrievalConfig, A as RetrievalResult, l as RetrievedChunk, D as RetrivoraChunkMetadata, F as RetrivoraIngestedDocument, S as ScatterPlotDataPoint, H as SuggestionsResponse, J as TableData, T as TokenUsage, U as UseRagChatOptions, a as UseRagChatReturn, K as VisualizationType, W as WorkflowConfig } from './ILLMProvider-CcJ5N6XD.mjs';
+import { k as DecisionContext, m as IntentCategory, I as IRenderRule, r as RenderDecision, l as IRendererStrategy } from './BatchProcessor-tVzb9CdE.mjs';
+export { F as ArchitectureCardProps, A as AuthenticationException, B as BatchOptions, e as BatchProcessor, f as BatchResult, g as ChartType, G as ChatViewportSize, C as ChatWidgetProps, a as ChatWindowProps, h as Chunk, i as ChunkOptions, c as ClientConfig, b as ConfigProviderProps, j as ConfigurationException, H as DocumentChunker, D as DocumentUploadProps, E as EmbeddingFailedException, L as LicenseValidationError, n as LicenseValidationRequest, o as LicenseValidationResponse, p as LicenseValidator, M as MessageBubbleProps, J as Pipeline, K as PipelineStep, P as ProductCardProps, d as ProductCarouselProps, q as ProviderNotFoundException, N as ProviderPill, R as RateLimitException, O as RenderSectionDecision, s as RenderType, t as RetrievalException, u as Retrivora, v as RetrivoraError, w as RetrivoraErrorCode, x as SDKVersionUnsupportedError, y as SDK_VERSION, Q as Snippet, S as SourceCardProps, T as wrapError } from './BatchProcessor-tVzb9CdE.mjs';
+import { H as HealthCheckResult, I as IProviderValidator, a as IProviderHealthChecker } from './index-CL-zF6bD.mjs';
+export { C as ConfigValidator, b as HandlerOptions, V as ValidationError, c as VectorPlugin, d as createChatHandler, e as createFeedbackHandler, f as createHealthHandler, g as createHistoryHandler, h as createIngestHandler, i as createRagHandler, j as createSessionsHandler, k as createStreamHandler, l as createUploadHandler, s as sseErrorFrame, m as sseFrame, n as sseMetaFrame, o as sseTextFrame } from './index-CL-zF6bD.mjs';
 import 'react';
 import 'next/server';
 
-declare class Rule1SpecificInfoRule implements IRenderRule {
-    readonly name = "Rule1SpecificInfo";
-    readonly priority = 100;
-    evaluate(context: DecisionContext, intent: IntentCategory): RenderDecision | null;
-}
-
-declare class Rule2ComparisonRule implements IRenderRule {
-    readonly name = "Rule2Comparison";
-    readonly priority = 90;
-    evaluate(context: DecisionContext, intent: IntentCategory): RenderDecision | null;
-}
-
-declare class Rule3ProductDiscoveryRule implements IRenderRule {
-    readonly name = "Rule3ProductDiscovery";
-    readonly priority = 85;
-    evaluate(context: DecisionContext, intent: IntentCategory): RenderDecision | null;
-}
-
-declare class Rule4AnalyticalRule implements IRenderRule {
-    readonly name = "Rule4Analytical";
-    readonly priority = 80;
-    evaluate(context: DecisionContext, intent: IntentCategory): RenderDecision | null;
-}
-
-declare class Rule5MixedResponseRule implements IRenderRule {
-    readonly name = "Rule5MixedResponse";
-    readonly priority = 95;
-    evaluate(context: DecisionContext, _intent: IntentCategory): RenderDecision | null;
-}
-
-declare class Rule6SmallResultSetRule implements IRenderRule {
-    readonly name = "Rule6SmallResultSet";
-    readonly priority = 110;
-    evaluate(context: DecisionContext, _intent: IntentCategory): RenderDecision | null;
-}
-
-declare class Rule7LargeTableRule implements IRenderRule {
-    readonly name = "Rule7LargeTable";
-    readonly priority = 75;
-    evaluate(context: DecisionContext, intent: IntentCategory): RenderDecision | null;
-}
-
 /**
  * Decoded payload of a Retrivora license JWT.
  *
@@ -573,6 +531,185 @@ declare class DocumentParser {
     private static readAsText;
 }
 
+interface DataSignals {
+    rowCount: number;
+    hasNumericFields: boolean;
+    hasDateFields: boolean;
+    hasCategoricalFields: boolean;
+    isProductLike: boolean;
+    numericFieldCount: number;
+    categoricalFieldCount: number;
+}
+declare class IntentClassifier {
+    /**
+     * Fast, zero-latency classifier that maps a user query and optional data context
+     * into a high-level IntentCategory.
+     */
+    static classify(context: DecisionContext): {
+        intent: IntentCategory;
+        signals: DataSignals;
+    };
+    /**
+     * Extract key data structure signals from retrieved documents.
+     */
+    static extractDataSignals(context: DecisionContext): DataSignals;
+    private static isInformationLookup;
+    private static isComparisonQuery;
+    private static isProductQuery;
+    private static isRecommendationQuery;
+    private static isTrendQuery;
+    private static isRankingQuery;
+    private static isAnalyticsQuery;
+}
+
+declare class RuleEngine {
+    private rules;
+    constructor();
+    /**
+     * Register standard rules in priority order.
+     */
+    private registerDefaultRules;
+    /**
+     * Add or replace a rule in the engine.
+     * Automatically keeps rules sorted by descending priority.
+     */
+    registerRule(rule: IRenderRule): void;
+    /**
+     * Evaluate context against rules in descending priority order.
+     * Returns the first non-null RenderDecision.
+     */
+    evaluate(context: DecisionContext, intent: IntentCategory): RenderDecision;
+    /**
+     * List all registered rules.
+     */
+    getRegisteredRules(): Array<{
+        name: string;
+        priority: number;
+    }>;
+}
+
+declare class TextRendererStrategy implements IRendererStrategy {
+    readonly type = "text";
+    render(data: unknown, options?: Record<string, unknown>): UITransformationResponse;
+}
+declare class TableRendererStrategy implements IRendererStrategy {
+    readonly type = "table";
+    render(data: unknown, options?: Record<string, unknown>): UITransformationResponse;
+}
+declare class CarouselRendererStrategy implements IRendererStrategy {
+    readonly type = "carousel";
+    render(data: unknown, options?: Record<string, unknown>): UITransformationResponse;
+}
+declare class ChartRendererStrategy implements IRendererStrategy {
+    readonly type = "chart";
+    render(data: unknown, options?: Record<string, unknown>): UITransformationResponse;
+}
+declare class MixedRendererStrategy implements IRendererStrategy {
+    readonly type = "mixed";
+    render(data: unknown, options?: Record<string, unknown>): UITransformationResponse;
+}
+declare class RendererRegistry {
+    private static strategies;
+    /**
+     * Register a new renderer strategy.
+     * Enables seamless addition of custom visualizers (Timeline, Maps, Flow Diagrams, etc.).
+     */
+    static registerStrategy(strategy: IRendererStrategy): void;
+    /**
+     * Retrieve a registered renderer strategy by type string.
+     */
+    static getStrategy(type: string): IRendererStrategy;
+    /**
+     * Check if a renderer strategy is registered.
+     */
+    static hasStrategy(type: string): boolean;
+    /**
+     * List all registered strategy types.
+     */
+    static getRegisteredTypes(): string[];
+}
+
+/**
+ * High-Performance Visualization Decision Engine.
+ * Intelligently determines whether to render text, table, carousel, chart, or mixed sections
+ * BEFORE expensive visual generation or LLM visual calls execute.
+ */
+declare class VisualizationDecisionEngine {
+    private static ruleEngine;
+    private static cache;
+    /**
+     * Evaluate user query, documents, and context to produce a RenderDecision.
+     * Execution time is < 1ms for cached or rule-matched queries.
+     */
+    static decideVisualization(userQuery: string, retrievedDocuments?: VectorMatch[], llmResponse?: string, metadata?: Record<string, unknown>): RenderDecision;
+    /**
+     * Convenience helper to decide AND render the data into a UITransformationResponse.
+     */
+    static render(userQuery: string, retrievedDocuments?: VectorMatch[], llmResponse?: string, metadata?: Record<string, unknown>): UITransformationResponse;
+    /**
+     * Register a custom rule in the rule engine.
+     */
+    static registerRule(rule: IRenderRule): void;
+    /**
+     * Register a custom renderer strategy.
+     */
+    static registerRendererStrategy(strategy: IRendererStrategy): void;
+    /**
+     * Clear the decision cache.
+     */
+    static clearCache(): void;
+    /**
+     * Get size of current decision cache.
+     */
+    static getCacheSize(): number;
+}
+/**
+ * Top-level function export matching prompt specification.
+ */
+declare function decideVisualization(userQuery: string, retrievedDocuments?: VectorMatch[], llmResponse?: string, metadata?: Record<string, unknown>): RenderDecision;
+
+declare class Rule1SpecificInfoRule implements IRenderRule {
+    readonly name = "Rule1SpecificInfo";
+    readonly priority = 100;
+    evaluate(context: DecisionContext, intent: IntentCategory): RenderDecision | null;
+}
+
+declare class Rule2ComparisonRule implements IRenderRule {
+    readonly name = "Rule2Comparison";
+    readonly priority = 90;
+    evaluate(context: DecisionContext, intent: IntentCategory): RenderDecision | null;
+}
+
+declare class Rule3ProductDiscoveryRule implements IRenderRule {
+    readonly name = "Rule3ProductDiscovery";
+    readonly priority = 85;
+    evaluate(context: DecisionContext, intent: IntentCategory): RenderDecision | null;
+}
+
+declare class Rule4AnalyticalRule implements IRenderRule {
+    readonly name = "Rule4Analytical";
+    readonly priority = 80;
+    evaluate(context: DecisionContext, intent: IntentCategory): RenderDecision | null;
+}
+
+declare class Rule5MixedResponseRule implements IRenderRule {
+    readonly name = "Rule5MixedResponse";
+    readonly priority = 95;
+    evaluate(context: DecisionContext, _intent: IntentCategory): RenderDecision | null;
+}
+
+declare class Rule6SmallResultSetRule implements IRenderRule {
+    readonly name = "Rule6SmallResultSet";
+    readonly priority = 110;
+    evaluate(context: DecisionContext, _intent: IntentCategory): RenderDecision | null;
+}
+
+declare class Rule7LargeTableRule implements IRenderRule {
+    readonly name = "Rule7LargeTable";
+    readonly priority = 75;
+    evaluate(context: DecisionContext, intent: IntentCategory): RenderDecision | null;
+}
+
 /**
  * PineconeProvider — Pinecone vector database implementation.
  */
@@ -989,4 +1126,4 @@ declare class UniversalLLMAdapter implements ILLMProvider {
     ping(): Promise<boolean>;
 }
 
-export { AnthropicProvider, BaseVectorProvider, ChatMessage, ChatOptions, ChromaDBProvider, ConfigBuilder, ConfigResolver, DecisionContext, DocumentParser, Edge, EmbedOptions, EmbeddingConfig, EmbeddingProvider, EmbeddingStrategy, EmbeddingStrategyResolver, GraphNode, GraphSearchResult, GroqProvider, HealthCheckResult, ILLMProvider, IProviderHealthChecker, IProviderValidator, IRenderRule, IntentCategory, LLMConfig, LLMFactory, LLMProvider, LLM_PROFILES, type LicensePayload, LicenseVerifier, MilvusProvider, MongoDBProvider, MultiTablePostgresProvider, OllamaProvider, OpenAIProvider, PRESETS, PineconeProvider, PostgreSQLProvider, ProviderHealthCheck, ProviderRegistry, QdrantProvider, QwenProvider, RAGConfig, RagConfig, RedisProvider, RenderDecision, Rule1SpecificInfoRule, Rule2ComparisonRule, Rule3ProductDiscoveryRule, Rule4AnalyticalRule, Rule5MixedResponseRule, Rule6SmallResultSetRule, Rule7LargeTableRule, UIConfig, UniversalLLMAdapter, UniversalRagConfig, UniversalVectorProvider, UpsertDocument, VECTOR_PROFILES, VectorDBConfig, VectorDBProvider, VectorMatch, WeaviateProvider, createFromPreset, getRagConfig };
+export { AnthropicProvider, BaseVectorProvider, CarouselRendererStrategy, ChartRendererStrategy, ChatMessage, ChatOptions, ChromaDBProvider, ConfigBuilder, ConfigResolver, DecisionContext, DocumentParser, Edge, EmbedOptions, EmbeddingConfig, EmbeddingProvider, EmbeddingStrategy, EmbeddingStrategyResolver, GraphNode, GraphSearchResult, GroqProvider, HealthCheckResult, ILLMProvider, IProviderHealthChecker, IProviderValidator, IRenderRule, IRendererStrategy, IntentCategory, IntentClassifier, LLMConfig, LLMFactory, LLMProvider, LLM_PROFILES, type LicensePayload, LicenseVerifier, MilvusProvider, MixedRendererStrategy, MongoDBProvider, MultiTablePostgresProvider, OllamaProvider, OpenAIProvider, PRESETS, PineconeProvider, PostgreSQLProvider, ProviderHealthCheck, ProviderRegistry, QdrantProvider, QwenProvider, RAGConfig, RagConfig, RedisProvider, RenderDecision, RendererRegistry, Rule1SpecificInfoRule, Rule2ComparisonRule, Rule3ProductDiscoveryRule, Rule4AnalyticalRule, Rule5MixedResponseRule, Rule6SmallResultSetRule, Rule7LargeTableRule, RuleEngine, TableRendererStrategy, TextRendererStrategy, UIConfig, UITransformationResponse, UniversalLLMAdapter, UniversalRagConfig, UniversalVectorProvider, UpsertDocument, VECTOR_PROFILES, VectorDBConfig, VectorDBProvider, VectorMatch, VisualizationDecisionEngine, WeaviateProvider, createFromPreset, decideVisualization, getRagConfig };

package/dist/server.d.ts

@@ -1,54 +1,12 @@
-import { V as VectorDBConfig, L as LLMConfig, d as EmbeddingConfig, i as RagConfig, n as UniversalRagConfig, o as UpsertDocument, q as VectorMatch, G as GraphDBConfig, r as GraphNode, s as Edge, t as GraphSearchResult, I as ILLMProvider, p as VectorDBProvider, g as LLMProvider, e as EmbeddingProvider, R as RAGConfig, m as UIConfig, C as ChatMessage, b as ChatOptions, E as EmbedOptions } from './ILLMProvider-teTNQ1lh.js';
-export { B as BarChartData, u as CarouselProduct, c as ChatResponse, v as IRetriever, f as IngestDocument, h as LatencyBreakdown, w as LineChartDataPoint, M as MessageRole, x as MetricCardData, O as ObservabilityTrace, P as PieChartData, y as Product, j as RagMessage, k as RetrievalConfig, z as RetrievalResult, l as RetrievedChunk, A as RetrivoraChunkMetadata, D as RetrivoraIngestedDocument, S as ScatterPlotDataPoint, F as SuggestionsResponse, H as TableData, T as TokenUsage, J as UITransformationResponse, U as UseRagChatOptions, a as UseRagChatReturn, K as VisualizationType, W as WorkflowConfig } from './ILLMProvider-teTNQ1lh.js';
-import { I as IRenderRule, k as DecisionContext, m as IntentCategory, s as RenderDecision } from './BatchProcessor-BfzuU4cK.js';
-export { K as ArchitectureCardProps, A as AuthenticationException, B as BatchOptions, e as BatchProcessor, f as BatchResult, N as CarouselRendererStrategy, O as ChartRendererStrategy, g as ChartType, Q as ChatViewportSize, C as ChatWidgetProps, a as ChatWindowProps, h as Chunk, i as ChunkOptions, c as ClientConfig, b as ConfigProviderProps, j as ConfigurationException, T as DocumentChunker, D as DocumentUploadProps, E as EmbeddingFailedException, l as IRendererStrategy, n as IntentClassifier, L as LicenseValidationError, o as LicenseValidationRequest, p as LicenseValidationResponse, q as LicenseValidator, M as MessageBubbleProps, U as MixedRendererStrategy, W as Pipeline, X as PipelineStep, P as ProductCardProps, d as ProductCarouselProps, r as ProviderNotFoundException, Y as ProviderPill, R as RateLimitException, Z as RenderSectionDecision, t as RenderType, u as RendererRegistry, v as RetrievalException, w as Retrivora, x as RetrivoraError, y as RetrivoraErrorCode, z as RuleEngine, F as SDKVersionUnsupportedError, G as SDK_VERSION, _ as Snippet, S as SourceCardProps, $ as TableRendererStrategy, a0 as TextRendererStrategy, V as VisualizationDecisionEngine, H as decideVisualization, a1 as wrapError } from './BatchProcessor-BfzuU4cK.js';
-import { H as HealthCheckResult, I as IProviderValidator, a as IProviderHealthChecker } from './index-DR_O_B-W.js';
-export { C as ConfigValidator, b as HandlerOptions, V as ValidationError, c as VectorPlugin, d as createChatHandler, e as createFeedbackHandler, f as createHealthHandler, g as createHistoryHandler, h as createIngestHandler, i as createRagHandler, j as createSessionsHandler, k as createStreamHandler, l as createUploadHandler, s as sseErrorFrame, m as sseFrame, n as sseMetaFrame, o as sseTextFrame } from './index-DR_O_B-W.js';
+import { V as VectorDBConfig, L as LLMConfig, d as EmbeddingConfig, i as RagConfig, n as UniversalRagConfig, o as UpsertDocument, q as VectorMatch, G as GraphDBConfig, r as GraphNode, s as Edge, t as GraphSearchResult, I as ILLMProvider, p as VectorDBProvider, g as LLMProvider, e as EmbeddingProvider, R as RAGConfig, m as UIConfig, u as UITransformationResponse, C as ChatMessage, b as ChatOptions, E as EmbedOptions } from './ILLMProvider-CcJ5N6XD.js';
+export { B as BarChartData, v as CarouselProduct, c as ChatResponse, w as IRetriever, f as IngestDocument, h as LatencyBreakdown, x as LineChartDataPoint, M as MessageRole, y as MetricCardData, O as ObservabilityTrace, P as PieChartData, z as Product, j as RagMessage, k as RetrievalConfig, A as RetrievalResult, l as RetrievedChunk, D as RetrivoraChunkMetadata, F as RetrivoraIngestedDocument, S as ScatterPlotDataPoint, H as SuggestionsResponse, J as TableData, T as TokenUsage, U as UseRagChatOptions, a as UseRagChatReturn, K as VisualizationType, W as WorkflowConfig } from './ILLMProvider-CcJ5N6XD.js';
+import { k as DecisionContext, m as IntentCategory, I as IRenderRule, r as RenderDecision, l as IRendererStrategy } from './BatchProcessor-CQDtlggz.js';
+export { F as ArchitectureCardProps, A as AuthenticationException, B as BatchOptions, e as BatchProcessor, f as BatchResult, g as ChartType, G as ChatViewportSize, C as ChatWidgetProps, a as ChatWindowProps, h as Chunk, i as ChunkOptions, c as ClientConfig, b as ConfigProviderProps, j as ConfigurationException, H as DocumentChunker, D as DocumentUploadProps, E as EmbeddingFailedException, L as LicenseValidationError, n as LicenseValidationRequest, o as LicenseValidationResponse, p as LicenseValidator, M as MessageBubbleProps, J as Pipeline, K as PipelineStep, P as ProductCardProps, d as ProductCarouselProps, q as ProviderNotFoundException, N as ProviderPill, R as RateLimitException, O as RenderSectionDecision, s as RenderType, t as RetrievalException, u as Retrivora, v as RetrivoraError, w as RetrivoraErrorCode, x as SDKVersionUnsupportedError, y as SDK_VERSION, Q as Snippet, S as SourceCardProps, T as wrapError } from './BatchProcessor-CQDtlggz.js';
+import { H as HealthCheckResult, I as IProviderValidator, a as IProviderHealthChecker } from './index-BwmyPJHp.js';
+export { C as ConfigValidator, b as HandlerOptions, V as ValidationError, c as VectorPlugin, d as createChatHandler, e as createFeedbackHandler, f as createHealthHandler, g as createHistoryHandler, h as createIngestHandler, i as createRagHandler, j as createSessionsHandler, k as createStreamHandler, l as createUploadHandler, s as sseErrorFrame, m as sseFrame, n as sseMetaFrame, o as sseTextFrame } from './index-BwmyPJHp.js';
 import 'react';
 import 'next/server';
 
-declare class Rule1SpecificInfoRule implements IRenderRule {
-    readonly name = "Rule1SpecificInfo";
-    readonly priority = 100;
-    evaluate(context: DecisionContext, intent: IntentCategory): RenderDecision | null;
-}
-
-declare class Rule2ComparisonRule implements IRenderRule {
-    readonly name = "Rule2Comparison";
-    readonly priority = 90;
-    evaluate(context: DecisionContext, intent: IntentCategory): RenderDecision | null;
-}
-
-declare class Rule3ProductDiscoveryRule implements IRenderRule {
-    readonly name = "Rule3ProductDiscovery";
-    readonly priority = 85;
-    evaluate(context: DecisionContext, intent: IntentCategory): RenderDecision | null;
-}
-
-declare class Rule4AnalyticalRule implements IRenderRule {
-    readonly name = "Rule4Analytical";
-    readonly priority = 80;
-    evaluate(context: DecisionContext, intent: IntentCategory): RenderDecision | null;
-}
-
-declare class Rule5MixedResponseRule implements IRenderRule {
-    readonly name = "Rule5MixedResponse";
-    readonly priority = 95;
-    evaluate(context: DecisionContext, _intent: IntentCategory): RenderDecision | null;
-}
-
-declare class Rule6SmallResultSetRule implements IRenderRule {
-    readonly name = "Rule6SmallResultSet";
-    readonly priority = 110;
-    evaluate(context: DecisionContext, _intent: IntentCategory): RenderDecision | null;
-}
-
-declare class Rule7LargeTableRule implements IRenderRule {
-    readonly name = "Rule7LargeTable";
-    readonly priority = 75;
-    evaluate(context: DecisionContext, intent: IntentCategory): RenderDecision | null;
-}
-
 /**
  * Decoded payload of a Retrivora license JWT.
  *
@@ -573,6 +531,185 @@ declare class DocumentParser {
     private static readAsText;
 }
 
+interface DataSignals {
+    rowCount: number;
+    hasNumericFields: boolean;
+    hasDateFields: boolean;
+    hasCategoricalFields: boolean;
+    isProductLike: boolean;
+    numericFieldCount: number;
+    categoricalFieldCount: number;
+}
+declare class IntentClassifier {
+    /**
+     * Fast, zero-latency classifier that maps a user query and optional data context
+     * into a high-level IntentCategory.
+     */
+    static classify(context: DecisionContext): {
+        intent: IntentCategory;
+        signals: DataSignals;
+    };
+    /**
+     * Extract key data structure signals from retrieved documents.
+     */
+    static extractDataSignals(context: DecisionContext): DataSignals;
+    private static isInformationLookup;
+    private static isComparisonQuery;
+    private static isProductQuery;
+    private static isRecommendationQuery;
+    private static isTrendQuery;
+    private static isRankingQuery;
+    private static isAnalyticsQuery;
+}
+
+declare class RuleEngine {
+    private rules;
+    constructor();
+    /**
+     * Register standard rules in priority order.
+     */
+    private registerDefaultRules;
+    /**
+     * Add or replace a rule in the engine.
+     * Automatically keeps rules sorted by descending priority.
+     */
+    registerRule(rule: IRenderRule): void;
+    /**
+     * Evaluate context against rules in descending priority order.
+     * Returns the first non-null RenderDecision.
+     */
+    evaluate(context: DecisionContext, intent: IntentCategory): RenderDecision;
+    /**
+     * List all registered rules.
+     */
+    getRegisteredRules(): Array<{
+        name: string;
+        priority: number;
+    }>;
+}
+
+declare class TextRendererStrategy implements IRendererStrategy {
+    readonly type = "text";
+    render(data: unknown, options?: Record<string, unknown>): UITransformationResponse;
+}
+declare class TableRendererStrategy implements IRendererStrategy {
+    readonly type = "table";
+    render(data: unknown, options?: Record<string, unknown>): UITransformationResponse;
+}
+declare class CarouselRendererStrategy implements IRendererStrategy {
+    readonly type = "carousel";
+    render(data: unknown, options?: Record<string, unknown>): UITransformationResponse;
+}
+declare class ChartRendererStrategy implements IRendererStrategy {
+    readonly type = "chart";
+    render(data: unknown, options?: Record<string, unknown>): UITransformationResponse;
+}
+declare class MixedRendererStrategy implements IRendererStrategy {
+    readonly type = "mixed";
+    render(data: unknown, options?: Record<string, unknown>): UITransformationResponse;
+}
+declare class RendererRegistry {
+    private static strategies;
+    /**
+     * Register a new renderer strategy.
+     * Enables seamless addition of custom visualizers (Timeline, Maps, Flow Diagrams, etc.).
+     */
+    static registerStrategy(strategy: IRendererStrategy): void;
+    /**
+     * Retrieve a registered renderer strategy by type string.
+     */
+    static getStrategy(type: string): IRendererStrategy;
+    /**
+     * Check if a renderer strategy is registered.
+     */
+    static hasStrategy(type: string): boolean;
+    /**
+     * List all registered strategy types.
+     */
+    static getRegisteredTypes(): string[];
+}
+
+/**
+ * High-Performance Visualization Decision Engine.
+ * Intelligently determines whether to render text, table, carousel, chart, or mixed sections
+ * BEFORE expensive visual generation or LLM visual calls execute.
+ */
+declare class VisualizationDecisionEngine {
+    private static ruleEngine;
+    private static cache;
+    /**
+     * Evaluate user query, documents, and context to produce a RenderDecision.
+     * Execution time is < 1ms for cached or rule-matched queries.
+     */
+    static decideVisualization(userQuery: string, retrievedDocuments?: VectorMatch[], llmResponse?: string, metadata?: Record<string, unknown>): RenderDecision;
+    /**
+     * Convenience helper to decide AND render the data into a UITransformationResponse.
+     */
+    static render(userQuery: string, retrievedDocuments?: VectorMatch[], llmResponse?: string, metadata?: Record<string, unknown>): UITransformationResponse;
+    /**
+     * Register a custom rule in the rule engine.
+     */
+    static registerRule(rule: IRenderRule): void;
+    /**
+     * Register a custom renderer strategy.
+     */
+    static registerRendererStrategy(strategy: IRendererStrategy): void;
+    /**
+     * Clear the decision cache.
+     */
+    static clearCache(): void;
+    /**
+     * Get size of current decision cache.
+     */
+    static getCacheSize(): number;
+}
+/**
+ * Top-level function export matching prompt specification.
+ */
+declare function decideVisualization(userQuery: string, retrievedDocuments?: VectorMatch[], llmResponse?: string, metadata?: Record<string, unknown>): RenderDecision;
+
+declare class Rule1SpecificInfoRule implements IRenderRule {
+    readonly name = "Rule1SpecificInfo";
+    readonly priority = 100;
+    evaluate(context: DecisionContext, intent: IntentCategory): RenderDecision | null;
+}
+
+declare class Rule2ComparisonRule implements IRenderRule {
+    readonly name = "Rule2Comparison";
+    readonly priority = 90;
+    evaluate(context: DecisionContext, intent: IntentCategory): RenderDecision | null;
+}
+
+declare class Rule3ProductDiscoveryRule implements IRenderRule {
+    readonly name = "Rule3ProductDiscovery";
+    readonly priority = 85;
+    evaluate(context: DecisionContext, intent: IntentCategory): RenderDecision | null;
+}
+
+declare class Rule4AnalyticalRule implements IRenderRule {
+    readonly name = "Rule4Analytical";
+    readonly priority = 80;
+    evaluate(context: DecisionContext, intent: IntentCategory): RenderDecision | null;
+}
+
+declare class Rule5MixedResponseRule implements IRenderRule {
+    readonly name = "Rule5MixedResponse";
+    readonly priority = 95;
+    evaluate(context: DecisionContext, _intent: IntentCategory): RenderDecision | null;
+}
+
+declare class Rule6SmallResultSetRule implements IRenderRule {
+    readonly name = "Rule6SmallResultSet";
+    readonly priority = 110;
+    evaluate(context: DecisionContext, _intent: IntentCategory): RenderDecision | null;
+}
+
+declare class Rule7LargeTableRule implements IRenderRule {
+    readonly name = "Rule7LargeTable";
+    readonly priority = 75;
+    evaluate(context: DecisionContext, intent: IntentCategory): RenderDecision | null;
+}
+
 /**
  * PineconeProvider — Pinecone vector database implementation.
  */
@@ -989,4 +1126,4 @@ declare class UniversalLLMAdapter implements ILLMProvider {
     ping(): Promise<boolean>;
 }
 
-export { AnthropicProvider, BaseVectorProvider, ChatMessage, ChatOptions, ChromaDBProvider, ConfigBuilder, ConfigResolver, DecisionContext, DocumentParser, Edge, EmbedOptions, EmbeddingConfig, EmbeddingProvider, EmbeddingStrategy, EmbeddingStrategyResolver, GraphNode, GraphSearchResult, GroqProvider, HealthCheckResult, ILLMProvider, IProviderHealthChecker, IProviderValidator, IRenderRule, IntentCategory, LLMConfig, LLMFactory, LLMProvider, LLM_PROFILES, type LicensePayload, LicenseVerifier, MilvusProvider, MongoDBProvider, MultiTablePostgresProvider, OllamaProvider, OpenAIProvider, PRESETS, PineconeProvider, PostgreSQLProvider, ProviderHealthCheck, ProviderRegistry, QdrantProvider, QwenProvider, RAGConfig, RagConfig, RedisProvider, RenderDecision, Rule1SpecificInfoRule, Rule2ComparisonRule, Rule3ProductDiscoveryRule, Rule4AnalyticalRule, Rule5MixedResponseRule, Rule6SmallResultSetRule, Rule7LargeTableRule, UIConfig, UniversalLLMAdapter, UniversalRagConfig, UniversalVectorProvider, UpsertDocument, VECTOR_PROFILES, VectorDBConfig, VectorDBProvider, VectorMatch, WeaviateProvider, createFromPreset, getRagConfig };
+export { AnthropicProvider, BaseVectorProvider, CarouselRendererStrategy, ChartRendererStrategy, ChatMessage, ChatOptions, ChromaDBProvider, ConfigBuilder, ConfigResolver, DecisionContext, DocumentParser, Edge, EmbedOptions, EmbeddingConfig, EmbeddingProvider, EmbeddingStrategy, EmbeddingStrategyResolver, GraphNode, GraphSearchResult, GroqProvider, HealthCheckResult, ILLMProvider, IProviderHealthChecker, IProviderValidator, IRenderRule, IRendererStrategy, IntentCategory, IntentClassifier, LLMConfig, LLMFactory, LLMProvider, LLM_PROFILES, type LicensePayload, LicenseVerifier, MilvusProvider, MixedRendererStrategy, MongoDBProvider, MultiTablePostgresProvider, OllamaProvider, OpenAIProvider, PRESETS, PineconeProvider, PostgreSQLProvider, ProviderHealthCheck, ProviderRegistry, QdrantProvider, QwenProvider, RAGConfig, RagConfig, RedisProvider, RenderDecision, RendererRegistry, Rule1SpecificInfoRule, Rule2ComparisonRule, Rule3ProductDiscoveryRule, Rule4AnalyticalRule, Rule5MixedResponseRule, Rule6SmallResultSetRule, Rule7LargeTableRule, RuleEngine, TableRendererStrategy, TextRendererStrategy, UIConfig, UITransformationResponse, UniversalLLMAdapter, UniversalRagConfig, UniversalVectorProvider, UpsertDocument, VECTOR_PROFILES, VectorDBConfig, VectorDBProvider, VectorMatch, VisualizationDecisionEngine, WeaviateProvider, createFromPreset, decideVisualization, getRagConfig };

package/dist/server.js

@@ -1355,7 +1355,6 @@ var init_MilvusProvider = __esm({
           metadata: res["metadata"] || {}
         }));
       }
-      // eslint-disable-next-line @typescript-eslint/no-unused-vars
       async delete(id, _namespace) {
         await this.http.post("/v1/vector/delete", {
           collectionName: this.indexName,
@@ -1780,7 +1779,6 @@ var init_RedisProvider = __esm({
           await this.upsert(doc, namespace);
         }
       }
-      // eslint-disable-next-line @typescript-eslint/no-unused-vars
       async query(vector, topK, namespace, _filter) {
         const payload = {
           index: this.indexName,
@@ -1917,7 +1915,6 @@ var init_WeaviateProvider = __esm({
           metadata: res["metadata"] ? JSON.parse(res["metadata"]) : {}
         }));
       }
-      // eslint-disable-next-line @typescript-eslint/no-unused-vars
       async delete(id, _namespace) {
         await this.http.delete(`/v1/objects/${this.indexName}/${id}`);
       }
@@ -4824,7 +4821,7 @@ var ConfigValidator = class {
 // package.json
 var package_default = {
   name: "@retrivora-ai/rag-engine",
-  version: "2.3.1",
+  version: "2.3.3",
   description: "Retrivora AI is a plug-and-play AI engine for RAG chat experiences \u2014 generic vector DB + LLM provider, embeddable or standalone.",
   author: "Abhinav Alkuchi",
   license: "UNLICENSED",
@@ -4903,6 +4900,7 @@ var package_default = {
     build: "npm run build:pkg",
     "build:pkg": "npx @tailwindcss/cli -i src/tailwind.css -o src/index.css && tsup src/index.ts src/handlers/index.ts src/server.ts --format cjs,esm --dts --clean --no-splitting --tsconfig tsconfig.build.json --external react,react-dom,next,mongodb,pg,openai,@anthropic-ai/sdk,@pinecone-database/pinecone,axios,lucide-react,mammoth,pdf-parse,xlsx,react-markdown,remark-gfm,next-themes,langchain,@langchain/core,@langchain/openai,llamaindex --inject-style && npx @tailwindcss/cli -i src/tailwind.css -o dist/index.css",
     lint: "eslint",
+    typecheck: "tsc --noEmit -p tsconfig.build.json",
     clean: "rm -rf dist"
   },
   peerDependencies: {
@@ -5289,7 +5287,6 @@ When presenting structured data, statistics, or comparisons, decide if it is bes
         finalSystemPrompt += chartInstruction;
       }
       this.agent = createAgent({
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
         model: chatModel,
         tools: [searchTool],
         systemPrompt: finalSystemPrompt

package/dist/server.mjs

@@ -1340,7 +1340,6 @@ var init_MilvusProvider = __esm({
           metadata: res["metadata"] || {}
         }));
       }
-      // eslint-disable-next-line @typescript-eslint/no-unused-vars
       async delete(id, _namespace) {
         await this.http.post("/v1/vector/delete", {
           collectionName: this.indexName,
@@ -1765,7 +1764,6 @@ var init_RedisProvider = __esm({
           await this.upsert(doc, namespace);
         }
       }
-      // eslint-disable-next-line @typescript-eslint/no-unused-vars
       async query(vector, topK, namespace, _filter) {
         const payload = {
           index: this.indexName,
@@ -1902,7 +1900,6 @@ var init_WeaviateProvider = __esm({
           metadata: res["metadata"] ? JSON.parse(res["metadata"]) : {}
         }));
       }
-      // eslint-disable-next-line @typescript-eslint/no-unused-vars
       async delete(id, _namespace) {
         await this.http.delete(`/v1/objects/${this.indexName}/${id}`);
       }
@@ -4724,7 +4721,7 @@ var ConfigValidator = class {
 // package.json
 var package_default = {
   name: "@retrivora-ai/rag-engine",
-  version: "2.3.1",
+  version: "2.3.3",
   description: "Retrivora AI is a plug-and-play AI engine for RAG chat experiences \u2014 generic vector DB + LLM provider, embeddable or standalone.",
   author: "Abhinav Alkuchi",
   license: "UNLICENSED",
@@ -4803,6 +4800,7 @@ var package_default = {
     build: "npm run build:pkg",
     "build:pkg": "npx @tailwindcss/cli -i src/tailwind.css -o src/index.css && tsup src/index.ts src/handlers/index.ts src/server.ts --format cjs,esm --dts --clean --no-splitting --tsconfig tsconfig.build.json --external react,react-dom,next,mongodb,pg,openai,@anthropic-ai/sdk,@pinecone-database/pinecone,axios,lucide-react,mammoth,pdf-parse,xlsx,react-markdown,remark-gfm,next-themes,langchain,@langchain/core,@langchain/openai,llamaindex --inject-style && npx @tailwindcss/cli -i src/tailwind.css -o dist/index.css",
     lint: "eslint",
+    typecheck: "tsc --noEmit -p tsconfig.build.json",
     clean: "rm -rf dist"
   },
   peerDependencies: {
@@ -5189,7 +5187,6 @@ When presenting structured data, statistics, or comparisons, decide if it is bes
         finalSystemPrompt += chartInstruction;
       }
       this.agent = createAgent({
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
         model: chatModel,
         tools: [searchTool],
         systemPrompt: finalSystemPrompt

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@retrivora-ai/rag-engine",
-  "version": "2.3.1",
+  "version": "2.3.3",
   "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": "UNLICENSED",
@@ -79,6 +79,7 @@
     "build": "npm run build:pkg",
     "build:pkg": "npx @tailwindcss/cli -i src/tailwind.css -o src/index.css && tsup src/index.ts src/handlers/index.ts src/server.ts --format cjs,esm --dts --clean --no-splitting --tsconfig tsconfig.build.json --external react,react-dom,next,mongodb,pg,openai,@anthropic-ai/sdk,@pinecone-database/pinecone,axios,lucide-react,mammoth,pdf-parse,xlsx,react-markdown,remark-gfm,next-themes,langchain,@langchain/core,@langchain/openai,llamaindex --inject-style && npx @tailwindcss/cli -i src/tailwind.css -o dist/index.css",
     "lint": "eslint",
+    "typecheck": "tsc --noEmit -p tsconfig.build.json",
     "clean": "rm -rf dist"
   },
   "peerDependencies": {
@@ -135,4 +136,4 @@
     "tsup": "^8.5.1",
     "typescript": "^5"
   }
-}
+}

package/src/components/ChatWidget.tsx

@@ -79,8 +79,6 @@ export function ChatWidget({ position = 'bottom-right', onAddToCart, apiUrl, ret
   const [isValidating, setIsValidating] = useState(false);
   const [hasMountValidationFailed, setHasMountValidationFailed] = useState(false);
 
-  if (ui.showWidget === false) return null;
-
   const positionClass =
     position === 'bottom-left'
       ? 'bottom-6 left-6'
@@ -233,6 +231,8 @@ export function ChatWidget({ position = 'bottom-right', onAddToCart, apiUrl, ret
 
   const isResized = dimensions.width !== DEFAULT_DIMENSIONS.width || dimensions.height !== DEFAULT_DIMENSIONS.height;
 
+  if (ui.showWidget === false) return null;
+
   return (
     <>
       <style dangerouslySetInnerHTML={{ __html: GEMINI_STYLES }} />