@retrivora-ai/rag-engine 2.3.2 → 2.3.4

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

@@ -2570,14 +2570,15 @@ LicenseVerifier.CACHE_TTL_MS = 60 * 1e3;
 // Cache verified license for 60 seconds
 // Retrivora's Public Key used to verify the license key signature.
 // In production, this matches the private key held by Retrivora SaaS.
+// Rotate this key only when the signing private key is replaced.
 LicenseVerifier.PUBLIC_KEY = `-----BEGIN PUBLIC KEY-----
-MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEArMieCkCBtTfByRNOserm
-XM4T0Am29JyNzB4XQPe+WJJ56CN73H1HLXx9n1ByFcxkEJ9po+SURj5DnvUXwEy+
-xstx33wDPpVmcMQe33j5CRYS0S4gICiNqIRN7XkTlJtrcXqrmh1/hdOAwfRbjO1T
-NVtORHwUwWfI/lBLyxUPGtKPed+0fQ7NtcW4o00JXxs3EjCB5BV9CbnXoTjQb/4h
-iwZof4l8rb7oaNzOsVg0RSyxsETX7Ex5sI0CjBz1p2mYp4oVhw/A/h8Ls7H0XzjC
-+Eb6BLtsytt5JHoSp0jExLlCpDmpys2L+kETcBVx+IqiXtdN1n6KbkksvEDUVzLI
-MwIDAQAB
+MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAoOQlmDSKfCZaRy06rxwa
+chuDimlF134xTCitKDTPTPizF23oSn34pGDJakm/0T09JVUX8L/cvhGPe/3lf/g9
+4Y1q+Gb2KVM17KNGeT1Aj9Ua3BKz/yao/oFhi/r3Zt3cWY13B/Rd6clqY9WshIAV
+NqZNM8ilTl777cMbyym+6D+mzGXgmnJAO5brddIAI9FPLW0T3Znt8vEqDOIljEkC
+HCGHeirKABLbjKSJ4hljCa3vVitWqndhiq8CBSJG6HatiSGYotgMWGRY+0EbdlEv
+OJP4SqafQ3aD6YnL9q1n15QKwxu/uMK+JGM2VxxuyUi9GANtMIkCYy9xya73P4Qc
+gQIDAQAB
 -----END PUBLIC KEY-----`;
 
 // src/config/constants.ts
@@ -4821,7 +4822,7 @@ var ConfigValidator = class {
 // package.json
 var package_default = {
   name: "@retrivora-ai/rag-engine",
-  version: "2.3.2",
+  version: "2.3.4",
   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",

package/dist/server.mjs

@@ -2470,14 +2470,15 @@ LicenseVerifier.CACHE_TTL_MS = 60 * 1e3;
 // Cache verified license for 60 seconds
 // Retrivora's Public Key used to verify the license key signature.
 // In production, this matches the private key held by Retrivora SaaS.
+// Rotate this key only when the signing private key is replaced.
 LicenseVerifier.PUBLIC_KEY = `-----BEGIN PUBLIC KEY-----
-MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEArMieCkCBtTfByRNOserm
-XM4T0Am29JyNzB4XQPe+WJJ56CN73H1HLXx9n1ByFcxkEJ9po+SURj5DnvUXwEy+
-xstx33wDPpVmcMQe33j5CRYS0S4gICiNqIRN7XkTlJtrcXqrmh1/hdOAwfRbjO1T
-NVtORHwUwWfI/lBLyxUPGtKPed+0fQ7NtcW4o00JXxs3EjCB5BV9CbnXoTjQb/4h
-iwZof4l8rb7oaNzOsVg0RSyxsETX7Ex5sI0CjBz1p2mYp4oVhw/A/h8Ls7H0XzjC
-+Eb6BLtsytt5JHoSp0jExLlCpDmpys2L+kETcBVx+IqiXtdN1n6KbkksvEDUVzLI
-MwIDAQAB
+MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAoOQlmDSKfCZaRy06rxwa
+chuDimlF134xTCitKDTPTPizF23oSn34pGDJakm/0T09JVUX8L/cvhGPe/3lf/g9
+4Y1q+Gb2KVM17KNGeT1Aj9Ua3BKz/yao/oFhi/r3Zt3cWY13B/Rd6clqY9WshIAV
+NqZNM8ilTl777cMbyym+6D+mzGXgmnJAO5brddIAI9FPLW0T3Znt8vEqDOIljEkC
+HCGHeirKABLbjKSJ4hljCa3vVitWqndhiq8CBSJG6HatiSGYotgMWGRY+0EbdlEv
+OJP4SqafQ3aD6YnL9q1n15QKwxu/uMK+JGM2VxxuyUi9GANtMIkCYy9xya73P4Qc
+gQIDAQAB
 -----END PUBLIC KEY-----`;
 
 // src/config/constants.ts
@@ -4721,7 +4722,7 @@ var ConfigValidator = class {
 // package.json
 var package_default = {
   name: "@retrivora-ai/rag-engine",
-  version: "2.3.2",
+  version: "2.3.4",
   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",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@retrivora-ai/rag-engine",
-  "version": "2.3.2",
+  "version": "2.3.4",
   "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",

package/src/core/LicenseVerifier.ts

@@ -49,14 +49,15 @@ export class LicenseVerifier {
 
   // Retrivora's Public Key used to verify the license key signature.
   // In production, this matches the private key held by Retrivora SaaS.
+  // Rotate this key only when the signing private key is replaced.
   private static readonly PUBLIC_KEY = `-----BEGIN PUBLIC KEY-----
-MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEArMieCkCBtTfByRNOserm
-XM4T0Am29JyNzB4XQPe+WJJ56CN73H1HLXx9n1ByFcxkEJ9po+SURj5DnvUXwEy+
-xstx33wDPpVmcMQe33j5CRYS0S4gICiNqIRN7XkTlJtrcXqrmh1/hdOAwfRbjO1T
-NVtORHwUwWfI/lBLyxUPGtKPed+0fQ7NtcW4o00JXxs3EjCB5BV9CbnXoTjQb/4h
-iwZof4l8rb7oaNzOsVg0RSyxsETX7Ex5sI0CjBz1p2mYp4oVhw/A/h8Ls7H0XzjC
-+Eb6BLtsytt5JHoSp0jExLlCpDmpys2L+kETcBVx+IqiXtdN1n6KbkksvEDUVzLI
-MwIDAQAB
+MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAoOQlmDSKfCZaRy06rxwa
+chuDimlF134xTCitKDTPTPizF23oSn34pGDJakm/0T09JVUX8L/cvhGPe/3lf/g9
+4Y1q+Gb2KVM17KNGeT1Aj9Ua3BKz/yao/oFhi/r3Zt3cWY13B/Rd6clqY9WshIAV
+NqZNM8ilTl777cMbyym+6D+mzGXgmnJAO5brddIAI9FPLW0T3Znt8vEqDOIljEkC
+HCGHeirKABLbjKSJ4hljCa3vVitWqndhiq8CBSJG6HatiSGYotgMWGRY+0EbdlEv
+OJP4SqafQ3aD6YnL9q1n15QKwxu/uMK+JGM2VxxuyUi9GANtMIkCYy9xya73P4Qc
+gQIDAQAB
 -----END PUBLIC KEY-----`;
 
   /**

package/src/index.ts

@@ -26,14 +26,9 @@ export { useRagChat } from './hooks/useRagChat';
 // ── Utils ─────────────────────────────────────────────────────
 export { addSynonyms } from './utils/synonyms';
 
-// ── Visualization Decision Engine & Rendering ──────────────────
-export {
-  VisualizationDecisionEngine,
-  decideVisualization,
-  RendererRegistry,
-  IntentClassifier,
-  RuleEngine,
-} from './rendering';
+// ── Visualization Types ────────────────────────────────────────
+// Runtime rendering utilities are exported from the server entrypoint to
+// avoid pulling the rendering engine into client bundles unnecessarily.
 export type {
   RenderDecision,
   RenderType,
@@ -42,7 +37,7 @@ export type {
   DecisionContext,
   IRenderRule,
   IRendererStrategy,
-} from './rendering';
+} from './rendering/types';
 
 // ── Types (Interfaces/Types only, no Node.js deps) ─────────────
 export type {