@retrivora-ai/rag-engine 1.9.8 → 2.0.0

package/README.md

@@ -18,34 +18,42 @@ The SDK is a unified suite designed to abstract the complexity of building produ
 
 The SDK is built with modularity, performance, and security at its core:
 
-```
-┌─────────────────────────────────────────────────────────┐
-│                      Host Client                        │
-│             (Next.js App / React Frontend)              │
-└────────────┬───────────────────────────────▲────────────┘
-             │ Ingest / Queries              │ Render UI
-┌────────────▼───────────────────────────────┴────────────┐
-│                    Retrivora Facade                     │
-│               (Config Validation & Resolver)            │
-└────────────┬────────────────────────────────────────────┘
-             │
-             ▼
-┌─────────────────────────────────────────────────────────┐
-│             LicenseVerifier (Local Cryptography)        │
-│          Verifies signed JWT with Public Key locally   │
-└────────────┬────────────────────────────────────────────┘
-             │
-             ▼
-┌─────────────────────────────────────────────────────────┐
-│                    Pipeline Engine                      │
-│        (BatchProcessor, Chunker, Router, LRU Cache)      │
-└────────────┬───────────────────────────────┬────────────┘
-             │                               │
-             ▼                               ▼
-┌─────────────────────────┐     ┌─────────────────────────┐
-│      LLM Adapters       │     │  Vector DB Providers    │
-│  (OpenAI, Gemini, etc.) │     │  (Pinecone, Mongo, SQL) │
-└─────────────────────────┘     └─────────────────────────┘
+```mermaid
+sequenceDiagram
+    autonumber
+    actor Client as Host Client (Next.js/React)
+    participant Facade as Retrivora Facade
+    participant Lic as LicenseVerifier
+    participant Pipe as Pipeline Engine
+    participant DB as Vector Database
+    participant LLM as LLM Provider
+
+    Client->>Facade: initialize(config)
+    activate Facade
+    Facade->>Lic: verify(licenseKey, projectId)
+    activate Lic
+    Note over Lic: Offline RS256 JWT Decryption
+    Lic-->>Facade: Valid Signature (Green)
+    deactivate Lic
+    Facade-->>Client: Ready
+    deactivate Facade
+
+    Client->>Facade: ask(question, history)
+    activate Facade
+    Facade->>Pipe: ask(question, history)
+    activate Pipe
+    Pipe->>DB: search(queryVector)
+    activate DB
+    DB-->>Pipe: relevant chunks & meta
+    deactivate DB
+    Pipe->>LLM: chatCompletion(context, prompt)
+    activate LLM
+    LLM-->>Pipe: generated response
+    deactivate LLM
+    Pipe-->>Facade: ChatResponse (reply + sources)
+    deactivate Pipe
+    Facade-->>Client: SSE Streaming Chunk / JSON
+    deactivate Facade
 ```
 
 ### Key Components:

package/dist/{ILLMProvider-B8ROITYK.d.mts → ILLMProvider-DMxLyTdq.d.mts}

@@ -227,7 +227,7 @@ interface RAGConfig {
     /** Characters used to split text, in order of priority */
     separators?: string[];
     /** Overall RAG architecture pattern */
-    architecture?: 'simple' | 'graph' | 'hybrid' | 'agentic';
+    architecture?: 'simple' | 'graph' | 'hybrid' | 'agentic' | 'naive' | 'retrieve-and-rerank' | 'multimodal' | 'agentic-router' | 'multi-agent';
     /** Chunking strategy to use during ingestion */
     chunkingStrategy?: 'recursive' | 'markdown' | 'semantic' | 'llamaindex';
     /** Whether to use query transformation (e.g. HyDE) */
@@ -282,7 +282,7 @@ interface RetrievalConfig {
 }
 interface WorkflowConfig {
     /** High-level workflow selector from the SDK prompt. */
-    type?: 'simple-rag' | 'rag' | 'hybrid-rag' | 'graph-rag' | 'agentic-rag' | 'agentic';
+    type?: 'simple-rag' | 'rag' | 'hybrid-rag' | 'graph-rag' | 'agentic-rag' | 'agentic' | 'naive-rag' | 'retrieve-and-rerank' | 'multimodal-rag' | 'agentic-router' | 'multi-agent-rag' | 'multi-agent';
     /** Future workflow/provider-specific options. */
     options?: Record<string, unknown>;
 }

package/dist/{ILLMProvider-B8ROITYK.d.ts → ILLMProvider-DMxLyTdq.d.ts}

@@ -227,7 +227,7 @@ interface RAGConfig {
     /** Characters used to split text, in order of priority */
     separators?: string[];
     /** Overall RAG architecture pattern */
-    architecture?: 'simple' | 'graph' | 'hybrid' | 'agentic';
+    architecture?: 'simple' | 'graph' | 'hybrid' | 'agentic' | 'naive' | 'retrieve-and-rerank' | 'multimodal' | 'agentic-router' | 'multi-agent';
     /** Chunking strategy to use during ingestion */
     chunkingStrategy?: 'recursive' | 'markdown' | 'semantic' | 'llamaindex';
     /** Whether to use query transformation (e.g. HyDE) */
@@ -282,7 +282,7 @@ interface RetrievalConfig {
 }
 interface WorkflowConfig {
     /** High-level workflow selector from the SDK prompt. */
-    type?: 'simple-rag' | 'rag' | 'hybrid-rag' | 'graph-rag' | 'agentic-rag' | 'agentic';
+    type?: 'simple-rag' | 'rag' | 'hybrid-rag' | 'graph-rag' | 'agentic-rag' | 'agentic' | 'naive-rag' | 'retrieve-and-rerank' | 'multimodal-rag' | 'agentic-router' | 'multi-agent-rag' | 'multi-agent';
     /** Future workflow/provider-specific options. */
     options?: Record<string, unknown>;
 }

package/dist/handlers/index.d.mts

@@ -1,3 +1,3 @@
 import 'next/server';
-export { o as HandlerOptions, c as createChatHandler, d as createFeedbackHandler, e as createHealthHandler, f as createHistoryHandler, g as createIngestHandler, h as createRagHandler, i as createSessionsHandler, j as createStreamHandler, p as createSuggestionsHandler, k as createUploadHandler, s as sseErrorFrame, l as sseFrame, m as sseMetaFrame, q as sseObservabilityFrame, n as sseTextFrame, r as sseUIFrame } from '../index-CrxCy36A.mjs';
-import '../ILLMProvider-B8ROITYK.mjs';
+export { o as HandlerOptions, c as createChatHandler, d as createFeedbackHandler, e as createHealthHandler, f as createHistoryHandler, g as createIngestHandler, h as createRagHandler, i as createSessionsHandler, j as createStreamHandler, p as createSuggestionsHandler, k as createUploadHandler, s as sseErrorFrame, l as sseFrame, m as sseMetaFrame, q as sseObservabilityFrame, n as sseTextFrame, r as sseUIFrame } from '../index-DHsFLJXQ.mjs';
+import '../ILLMProvider-DMxLyTdq.mjs';

package/dist/handlers/index.d.ts

@@ -1,3 +1,3 @@
 import 'next/server';
-export { o as HandlerOptions, c as createChatHandler, d as createFeedbackHandler, e as createHealthHandler, f as createHistoryHandler, g as createIngestHandler, h as createRagHandler, i as createSessionsHandler, j as createStreamHandler, p as createSuggestionsHandler, k as createUploadHandler, s as sseErrorFrame, l as sseFrame, m as sseMetaFrame, q as sseObservabilityFrame, n as sseTextFrame, r as sseUIFrame } from '../index-BCPKUAVL.js';
-import '../ILLMProvider-B8ROITYK.js';
+export { o as HandlerOptions, c as createChatHandler, d as createFeedbackHandler, e as createHealthHandler, f as createHistoryHandler, g as createIngestHandler, h as createRagHandler, i as createSessionsHandler, j as createStreamHandler, p as createSuggestionsHandler, k as createUploadHandler, s as sseErrorFrame, l as sseFrame, m as sseMetaFrame, q as sseObservabilityFrame, n as sseTextFrame, r as sseUIFrame } from '../index-tzwc7UhY.js';
+import '../ILLMProvider-DMxLyTdq.js';