@retrivora-ai/rag-engine 1.9.7 → 1.9.8

package/dist/{index-BJ4cd-t5.d.mts → index-B8PbEFSY.d.mts}

@@ -1,4 +1,4 @@
-import { k as RagConfig, I as ILLMProvider, g as IngestDocument, C as ChatMessage, d as ChatResponse, u as RetrievalResult, n as UniversalRagConfig } from './ILLMProvider-Bhk6zJOK.mjs';
+import { k as RagConfig, I as ILLMProvider, g as IngestDocument, C as ChatMessage, d as ChatResponse, u as RetrievalResult, n as UniversalRagConfig } from './ILLMProvider-B8ROITYK.mjs';
 
 /**
  * DocumentChunker — splits long text into overlapping chunks
@@ -68,9 +68,13 @@ declare class Pipeline {
     private entityExtractor?;
     private reranker;
     private agent?;
+    private mcpRegistry?;
+    private multiAgentCoordinator?;
     /** LRU-bounded cache: avoids re-embedding identical queries within the same process. */
     private embeddingCache;
     private initialised;
+    /** Namespace-specific static cold context cache for CAG */
+    private coldContexts;
     constructor(config: RagConfig);
     /**
      * Expose the underlying LLM provider (set after initialize()).
@@ -78,6 +82,7 @@ declare class Pipeline {
      */
     getLLMProvider(): ILLMProvider | undefined;
     initialize(): Promise<void>;
+    private loadColdContext;
     /**
      * Ingest documents with automatic chunking, embedding, and batch upsert.
      */
@@ -96,7 +101,12 @@ declare class Pipeline {
     private processUpserts;
     /** Step 4: Optional graph-based entity extraction and ingestion. */
     private processGraphIngestion;
+    runNormalQuery(question: string, history?: ChatMessage[], namespace?: string): Promise<{
+        reply: string;
+        sources: any[];
+    }>;
     ask(question: string, history?: ChatMessage[], namespace?: string): Promise<ChatResponse>;
+    askStream(question: string, history?: ChatMessage[], namespace?: string): AsyncIterable<string | ChatResponse>;
     /**
      * High-performance streaming RAG flow.
      * Yields text chunks first, then the retrieval metadata + observability trace at the end.
@@ -107,7 +117,7 @@ declare class Pipeline {
      * - UITransformation is computed after text streaming and emitted with metadata
      * - SchemaMapper.train runs while answer generation streams
      */
-    askStream(question: string, history?: ChatMessage[], namespace?: string): AsyncIterable<string | ChatResponse>;
+    askStreamInternal(question: string, history?: ChatMessage[], namespace?: string): AsyncIterable<string | ChatResponse>;
     /**
      * Universal retrieval method combining all enabled providers.
      * Uses an LRU-bounded embedding cache to avoid re-embedding the same query.

package/dist/{index-Bu7T6xgr.d.ts → index-BCPKUAVL.d.ts}

@@ -1,5 +1,5 @@
-import { k as RagConfig, I as ILLMProvider, C as ChatMessage, d as ChatResponse, g as IngestDocument } from './ILLMProvider-Bhk6zJOK.js';
-import { NextRequest, NextResponse } from 'next/server';
+import { NextRequest } from 'next/server';
+import { k as RagConfig, I as ILLMProvider, C as ChatMessage, d as ChatResponse, g as IngestDocument } from './ILLMProvider-B8ROITYK.js';
 
 interface ValidationError {
     field: string;
@@ -124,6 +124,9 @@ declare class VectorPlugin {
     getSuggestions(query: string, namespace?: string): Promise<string[]>;
 }
 
+interface HandlerOptions {
+    onAuthorize?: (req: NextRequest) => boolean | Promise<boolean> | Response | Promise<Response>;
+}
 /**
  * Encode a payload as a Server-Sent Events frame.
  *   data: <json>\n\n
@@ -153,9 +156,7 @@ declare function sseErrorFrame(message: string): string;
  * const plugin = new VectorPlugin(getRagConfig());
  * export const POST = createChatHandler(plugin);
  */
-declare function createChatHandler(configOrPlugin?: Partial<RagConfig> | VectorPlugin): (req: NextRequest) => Promise<NextResponse<{
-    error: string;
-}> | NextResponse<ChatResponse>>;
+declare function createChatHandler(configOrPlugin?: Partial<RagConfig> | VectorPlugin, options?: HandlerOptions): (req: NextRequest) => Promise<any>;
 /**
  * createStreamHandler — factory for a streaming SSE Next.js App Router POST handler.
  *
@@ -178,68 +179,42 @@ declare function createChatHandler(configOrPlugin?: Partial<RagConfig> | VectorP
  * //   }
  * // }
  */
-declare function createStreamHandler(configOrPlugin?: Partial<RagConfig> | VectorPlugin): (req: NextRequest) => Promise<Response>;
+declare function createStreamHandler(configOrPlugin?: Partial<RagConfig> | VectorPlugin, options?: HandlerOptions): (req: NextRequest) => Promise<any>;
 /**
  * createIngestHandler — factory for the document ingestion endpoint.
  */
-declare function createIngestHandler(configOrPlugin?: Partial<RagConfig> | VectorPlugin): (req: NextRequest) => Promise<NextResponse<{
-    error: string;
-}> | NextResponse<{
-    results: {
-        docId: string | number;
-        chunksIngested: number;
-    }[];
-}>>;
+declare function createIngestHandler(configOrPlugin?: Partial<RagConfig> | VectorPlugin, options?: HandlerOptions): (req: NextRequest) => Promise<any>;
 /**
  * createHealthHandler — factory for the health-check endpoint.
  */
-declare function createHealthHandler(configOrPlugin?: Partial<RagConfig> | VectorPlugin): () => Promise<NextResponse<{
-    timestamp: string;
-    vectorDb: HealthCheckResult;
-    llm: HealthCheckResult;
-    embedding?: HealthCheckResult;
-    allHealthy: boolean;
-    status: string;
-}> | NextResponse<{
-    status: string;
-    error: string;
-}>>;
+declare function createHealthHandler(configOrPlugin?: Partial<RagConfig> | VectorPlugin, options?: HandlerOptions): (req?: NextRequest) => Promise<any>;
 /**
  * createUploadHandler — factory for the file upload ingestion endpoint.
  */
-declare function createUploadHandler(configOrPlugin?: Partial<RagConfig> | VectorPlugin): (req: NextRequest) => Promise<NextResponse<{
-    error: string;
-}> | NextResponse<{
-    message: string;
-    results: {
-        docId: string | number;
-        chunksIngested: number;
-    }[];
-}>>;
+declare function createUploadHandler(configOrPlugin?: Partial<RagConfig> | VectorPlugin, options?: HandlerOptions): (req: NextRequest) => Promise<any>;
 /**
  * createSuggestionsHandler — factory for the auto-suggestions endpoint.
  */
-declare function createSuggestionsHandler(configOrPlugin?: Partial<RagConfig> | VectorPlugin): (req: NextRequest) => Promise<NextResponse<{
-    error: string;
-}> | NextResponse<{
-    suggestions: string[];
-}>>;
+declare function createSuggestionsHandler(configOrPlugin?: Partial<RagConfig> | VectorPlugin, options?: HandlerOptions): (req: NextRequest) => Promise<any>;
+/**
+ * createHistoryHandler — factory for GET /api/retrivora/history and POST /api/retrivora/history/clear.
+ */
+declare function createHistoryHandler(configOrPlugin?: Partial<RagConfig> | VectorPlugin, options?: HandlerOptions): (req: NextRequest) => Promise<any>;
+/**
+ * createFeedbackHandler — factory for POST /api/retrivora/feedback.
+ */
+declare function createFeedbackHandler(configOrPlugin?: Partial<RagConfig> | VectorPlugin, options?: HandlerOptions): (req: NextRequest) => Promise<any>;
+/**
+ * createSessionsHandler — factory for GET /api/retrivora/sessions.
+ */
+declare function createSessionsHandler(configOrPlugin?: Partial<RagConfig> | VectorPlugin, options?: HandlerOptions): (req?: NextRequest) => Promise<any>;
 /**
  * createRagHandler — factory that returns GET and POST handlers for a catch-all route
  * (e.g. `src/app/api/retrivora/[[...retrivora]]/route.ts`).
  */
-declare function createRagHandler(configOrPlugin?: Partial<RagConfig> | VectorPlugin): {
-    GET: (req: NextRequest, context: any) => Promise<NextResponse<{
-        timestamp: string;
-        vectorDb: HealthCheckResult;
-        llm: HealthCheckResult;
-        embedding?: HealthCheckResult;
-        allHealthy: boolean;
-        status: string;
-    }> | NextResponse<{
-        error: string;
-    }>>;
-    POST: (req: NextRequest, context: any) => Promise<Response>;
+declare function createRagHandler(configOrPlugin?: Partial<RagConfig> | VectorPlugin, options?: HandlerOptions): {
+    GET: (req: NextRequest, context: any) => Promise<any>;
+    POST: (req: NextRequest, context: any) => Promise<any>;
 };
 
-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, createRagHandler as f, createStreamHandler as g, createUploadHandler as h, sseFrame as i, sseMetaFrame as j, sseTextFrame as k, createSuggestionsHandler as l, sseObservabilityFrame as m, sseUIFrame as n, 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, createFeedbackHandler as d, createHealthHandler as e, createHistoryHandler as f, createIngestHandler as g, createRagHandler as h, createSessionsHandler as i, createStreamHandler as j, createUploadHandler as k, sseFrame as l, sseMetaFrame as m, sseTextFrame as n, type HandlerOptions as o, createSuggestionsHandler as p, sseObservabilityFrame as q, sseUIFrame as r, sseErrorFrame as s };

package/dist/{index-C3SVtPYg.d.mts → index-CrxCy36A.d.mts}

@@ -1,5 +1,5 @@
-import { k as RagConfig, I as ILLMProvider, C as ChatMessage, d as ChatResponse, g as IngestDocument } from './ILLMProvider-Bhk6zJOK.mjs';
-import { NextRequest, NextResponse } from 'next/server';
+import { NextRequest } from 'next/server';
+import { k as RagConfig, I as ILLMProvider, C as ChatMessage, d as ChatResponse, g as IngestDocument } from './ILLMProvider-B8ROITYK.mjs';
 
 interface ValidationError {
     field: string;
@@ -124,6 +124,9 @@ declare class VectorPlugin {
     getSuggestions(query: string, namespace?: string): Promise<string[]>;
 }
 
+interface HandlerOptions {
+    onAuthorize?: (req: NextRequest) => boolean | Promise<boolean> | Response | Promise<Response>;
+}
 /**
  * Encode a payload as a Server-Sent Events frame.
  *   data: <json>\n\n
@@ -153,9 +156,7 @@ declare function sseErrorFrame(message: string): string;
  * const plugin = new VectorPlugin(getRagConfig());
  * export const POST = createChatHandler(plugin);
  */
-declare function createChatHandler(configOrPlugin?: Partial<RagConfig> | VectorPlugin): (req: NextRequest) => Promise<NextResponse<{
-    error: string;
-}> | NextResponse<ChatResponse>>;
+declare function createChatHandler(configOrPlugin?: Partial<RagConfig> | VectorPlugin, options?: HandlerOptions): (req: NextRequest) => Promise<any>;
 /**
  * createStreamHandler — factory for a streaming SSE Next.js App Router POST handler.
  *
@@ -178,68 +179,42 @@ declare function createChatHandler(configOrPlugin?: Partial<RagConfig> | VectorP
  * //   }
  * // }
  */
-declare function createStreamHandler(configOrPlugin?: Partial<RagConfig> | VectorPlugin): (req: NextRequest) => Promise<Response>;
+declare function createStreamHandler(configOrPlugin?: Partial<RagConfig> | VectorPlugin, options?: HandlerOptions): (req: NextRequest) => Promise<any>;
 /**
  * createIngestHandler — factory for the document ingestion endpoint.
  */
-declare function createIngestHandler(configOrPlugin?: Partial<RagConfig> | VectorPlugin): (req: NextRequest) => Promise<NextResponse<{
-    error: string;
-}> | NextResponse<{
-    results: {
-        docId: string | number;
-        chunksIngested: number;
-    }[];
-}>>;
+declare function createIngestHandler(configOrPlugin?: Partial<RagConfig> | VectorPlugin, options?: HandlerOptions): (req: NextRequest) => Promise<any>;
 /**
  * createHealthHandler — factory for the health-check endpoint.
  */
-declare function createHealthHandler(configOrPlugin?: Partial<RagConfig> | VectorPlugin): () => Promise<NextResponse<{
-    timestamp: string;
-    vectorDb: HealthCheckResult;
-    llm: HealthCheckResult;
-    embedding?: HealthCheckResult;
-    allHealthy: boolean;
-    status: string;
-}> | NextResponse<{
-    status: string;
-    error: string;
-}>>;
+declare function createHealthHandler(configOrPlugin?: Partial<RagConfig> | VectorPlugin, options?: HandlerOptions): (req?: NextRequest) => Promise<any>;
 /**
  * createUploadHandler — factory for the file upload ingestion endpoint.
  */
-declare function createUploadHandler(configOrPlugin?: Partial<RagConfig> | VectorPlugin): (req: NextRequest) => Promise<NextResponse<{
-    error: string;
-}> | NextResponse<{
-    message: string;
-    results: {
-        docId: string | number;
-        chunksIngested: number;
-    }[];
-}>>;
+declare function createUploadHandler(configOrPlugin?: Partial<RagConfig> | VectorPlugin, options?: HandlerOptions): (req: NextRequest) => Promise<any>;
 /**
  * createSuggestionsHandler — factory for the auto-suggestions endpoint.
  */
-declare function createSuggestionsHandler(configOrPlugin?: Partial<RagConfig> | VectorPlugin): (req: NextRequest) => Promise<NextResponse<{
-    error: string;
-}> | NextResponse<{
-    suggestions: string[];
-}>>;
+declare function createSuggestionsHandler(configOrPlugin?: Partial<RagConfig> | VectorPlugin, options?: HandlerOptions): (req: NextRequest) => Promise<any>;
+/**
+ * createHistoryHandler — factory for GET /api/retrivora/history and POST /api/retrivora/history/clear.
+ */
+declare function createHistoryHandler(configOrPlugin?: Partial<RagConfig> | VectorPlugin, options?: HandlerOptions): (req: NextRequest) => Promise<any>;
+/**
+ * createFeedbackHandler — factory for POST /api/retrivora/feedback.
+ */
+declare function createFeedbackHandler(configOrPlugin?: Partial<RagConfig> | VectorPlugin, options?: HandlerOptions): (req: NextRequest) => Promise<any>;
+/**
+ * createSessionsHandler — factory for GET /api/retrivora/sessions.
+ */
+declare function createSessionsHandler(configOrPlugin?: Partial<RagConfig> | VectorPlugin, options?: HandlerOptions): (req?: NextRequest) => Promise<any>;
 /**
  * createRagHandler — factory that returns GET and POST handlers for a catch-all route
  * (e.g. `src/app/api/retrivora/[[...retrivora]]/route.ts`).
  */
-declare function createRagHandler(configOrPlugin?: Partial<RagConfig> | VectorPlugin): {
-    GET: (req: NextRequest, context: any) => Promise<NextResponse<{
-        timestamp: string;
-        vectorDb: HealthCheckResult;
-        llm: HealthCheckResult;
-        embedding?: HealthCheckResult;
-        allHealthy: boolean;
-        status: string;
-    }> | NextResponse<{
-        error: string;
-    }>>;
-    POST: (req: NextRequest, context: any) => Promise<Response>;
+declare function createRagHandler(configOrPlugin?: Partial<RagConfig> | VectorPlugin, options?: HandlerOptions): {
+    GET: (req: NextRequest, context: any) => Promise<any>;
+    POST: (req: NextRequest, context: any) => Promise<any>;
 };
 
-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, createRagHandler as f, createStreamHandler as g, createUploadHandler as h, sseFrame as i, sseMetaFrame as j, sseTextFrame as k, createSuggestionsHandler as l, sseObservabilityFrame as m, sseUIFrame as n, 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, createFeedbackHandler as d, createHealthHandler as e, createHistoryHandler as f, createIngestHandler as g, createRagHandler as h, createSessionsHandler as i, createStreamHandler as j, createUploadHandler as k, sseFrame as l, sseMetaFrame as m, sseTextFrame as n, type HandlerOptions as o, createSuggestionsHandler as p, sseObservabilityFrame as q, sseUIFrame as r, sseErrorFrame as s };

package/dist/{index-B9J_XEh0.d.ts → index-DNvoi-sV.d.ts}

@@ -1,4 +1,4 @@
-import { k as RagConfig, I as ILLMProvider, g as IngestDocument, C as ChatMessage, d as ChatResponse, u as RetrievalResult, n as UniversalRagConfig } from './ILLMProvider-Bhk6zJOK.js';
+import { k as RagConfig, I as ILLMProvider, g as IngestDocument, C as ChatMessage, d as ChatResponse, u as RetrievalResult, n as UniversalRagConfig } from './ILLMProvider-B8ROITYK.js';
 
 /**
  * DocumentChunker — splits long text into overlapping chunks
@@ -68,9 +68,13 @@ declare class Pipeline {
     private entityExtractor?;
     private reranker;
     private agent?;
+    private mcpRegistry?;
+    private multiAgentCoordinator?;
     /** LRU-bounded cache: avoids re-embedding identical queries within the same process. */
     private embeddingCache;
     private initialised;
+    /** Namespace-specific static cold context cache for CAG */
+    private coldContexts;
     constructor(config: RagConfig);
     /**
      * Expose the underlying LLM provider (set after initialize()).
@@ -78,6 +82,7 @@ declare class Pipeline {
      */
     getLLMProvider(): ILLMProvider | undefined;
     initialize(): Promise<void>;
+    private loadColdContext;
     /**
      * Ingest documents with automatic chunking, embedding, and batch upsert.
      */
@@ -96,7 +101,12 @@ declare class Pipeline {
     private processUpserts;
     /** Step 4: Optional graph-based entity extraction and ingestion. */
     private processGraphIngestion;
+    runNormalQuery(question: string, history?: ChatMessage[], namespace?: string): Promise<{
+        reply: string;
+        sources: any[];
+    }>;
     ask(question: string, history?: ChatMessage[], namespace?: string): Promise<ChatResponse>;
+    askStream(question: string, history?: ChatMessage[], namespace?: string): AsyncIterable<string | ChatResponse>;
     /**
      * High-performance streaming RAG flow.
      * Yields text chunks first, then the retrieval metadata + observability trace at the end.
@@ -107,7 +117,7 @@ declare class Pipeline {
      * - UITransformation is computed after text streaming and emitted with metadata
      * - SchemaMapper.train runs while answer generation streams
      */
-    askStream(question: string, history?: ChatMessage[], namespace?: string): AsyncIterable<string | ChatResponse>;
+    askStreamInternal(question: string, history?: ChatMessage[], namespace?: string): AsyncIterable<string | ChatResponse>;
     /**
      * Universal retrieval method combining all enabled providers.
      * Uses an LRU-bounded embedding cache to avoid re-embedding the same query.