@juspay/neurolink 9.2.0 → 9.4.0

package/dist/lib/index.d.ts

@@ -33,21 +33,23 @@
  */
 import { AIProviderFactory } from "./core/factory.js";
 export { AIProviderFactory };
-export * from "./types/index.js";
-export { validateTool } from "./sdk/toolRegistration.js";
+export { NeuroLinkConfigManager as ConfigManager } from "./config/configManager.js";
 export { AIProviderName, BedrockModels, OpenAIModels, VertexModels, } from "./constants/enums.js";
-export { getBestProvider, getAvailableProviders, isValidProvider, } from "./utils/providerUtils.js";
 export { dynamicModelProvider } from "./core/dynamicModels.js";
+export { validateTool } from "./sdk/toolRegistration.js";
+export * from "./types/index.js";
 export type { DynamicModelConfig, ModelRegistry } from "./types/modelTypes.js";
+export { getAvailableProviders, getBestProvider, isValidProvider, } from "./utils/providerUtils.js";
 import { NeuroLink } from "./neurolink.js";
 export { NeuroLink };
 export type { MCPServerInfo } from "./types/mcpTypes.js";
-export type { ObservabilityConfig, LangfuseConfig, OpenTelemetryConfig, LangfuseSpanAttributes, TraceNameFormat, } from "./types/observability.js";
+export type { LangfuseConfig, LangfuseSpanAttributes, ObservabilityConfig, OpenTelemetryConfig, TraceNameFormat, } from "./types/observability.js";
 export { buildObservabilityConfigFromEnv } from "./utils/observabilityHelpers.js";
-import { initializeOpenTelemetry, shutdownOpenTelemetry, flushOpenTelemetry, getLangfuseHealthStatus, setLangfuseContext, getLangfuseSpanProcessor, getTracerProvider, isOpenTelemetryInitialized, getSpanProcessors, createContextEnricher, isUsingExternalTracerProvider, getLangfuseContext, getTracer } from "./services/server/ai/observability/instrumentation.js";
+import { createContextEnricher, flushOpenTelemetry, getLangfuseContext, getLangfuseHealthStatus, getLangfuseSpanProcessor, getSpanProcessors, getTracer, getTracerProvider, initializeOpenTelemetry, isOpenTelemetryInitialized, isUsingExternalTracerProvider, setLangfuseContext, shutdownOpenTelemetry } from "./services/server/ai/observability/instrumentation.js";
 export { initializeOpenTelemetry, shutdownOpenTelemetry, flushOpenTelemetry, getLangfuseHealthStatus, setLangfuseContext, getLangfuseSpanProcessor, getTracerProvider, isOpenTelemetryInitialized, getSpanProcessors, createContextEnricher, isUsingExternalTracerProvider, getLangfuseContext, getTracer, };
-export type { NeuroLinkMiddleware, MiddlewareContext, MiddlewareFactoryOptions, MiddlewarePreset, MiddlewareConfig, } from "./types/middlewareTypes.js";
+export { clearAnalyticsMetrics, createAnalyticsMiddleware, getAnalyticsMetrics, } from "./middleware/builtin/analytics.js";
 export { MiddlewareFactory } from "./middleware/factory.js";
+export type { MiddlewareConfig, MiddlewareContext, MiddlewareFactoryOptions, MiddlewarePreset, NeuroLinkMiddleware, } from "./types/middlewareTypes.js";
 export declare const VERSION = "1.0.0";
 /**
  * Quick start factory function for creating AI provider instances.
@@ -184,10 +186,11 @@ export declare function createBestAIProvider(requestedProvider?: string, modelNa
  * await writeFile('output.txt', 'Hello from MCP!');
  * ```
  */
-export { initializeMCPEcosystem, listMCPs, executeMCP, getMCPStats, mcpLogger, HTTPRateLimiter, RateLimiterManager, globalRateLimiterManager, DEFAULT_RATE_LIMIT_CONFIG, DEFAULT_HTTP_RETRY_CONFIG, isRetryableStatusCode, isRetryableHTTPError, withHTTPRetry, InMemoryTokenStorage, FileTokenStorage, isTokenExpired, calculateExpiresAt, NeuroLinkOAuthProvider, createOAuthProviderFromConfig, MCPCircuitBreaker, CircuitBreakerManager, globalCircuitBreakerManager, } from "./mcp/index.js";
-export type { McpMetadata, DiscoveredMcp, RateLimitConfig, HTTPRetryConfig, OAuthTokens, TokenStorage, MCPOAuthConfig, OAuthClientInformation, AuthorizationUrlResult, TokenExchangeRequest, } from "./types/mcpTypes.js";
-export type { ExecutionContext, ToolInfo, ToolExecutionResult, } from "./types/tools.js";
+export { CircuitBreakerManager, calculateExpiresAt, createMCPServer, createOAuthProviderFromConfig, DEFAULT_HTTP_RETRY_CONFIG, DEFAULT_RATE_LIMIT_CONFIG, executeMCP, FileTokenStorage, getMCPStats, getServerInfo, globalCircuitBreakerManager, globalRateLimiterManager, HTTPRateLimiter, InMemoryTokenStorage, initializeMCPEcosystem, isRetryableHTTPError, isRetryableStatusCode, isTokenExpired, listMCPs, MCPCircuitBreaker, mcpLogger, NeuroLinkOAuthProvider, RateLimiterManager, validateServerTools, validateTool as validateMCPTool, withHTTPRetry, } from "./mcp/index.js";
+export type { AuthorizationUrlResult, DiscoveredMcp, HTTPRetryConfig, MCPOAuthConfig, McpMetadata, OAuthClientInformation, OAuthTokens, RateLimitConfig, TokenExchangeRequest, TokenStorage, } from "./types/mcpTypes.js";
+export type { ExecutionContext, ToolExecutionResult, ToolInfo, } from "./types/tools.js";
 export type { LogLevel } from "./types/utilities.js";
+export { logger } from "./utils/logger.js";
 export declare function initializeTelemetry(): Promise<boolean>;
 export declare function getTelemetryStatus(): Promise<{
     enabled: boolean;
@@ -196,7 +199,7 @@ export declare function getTelemetryStatus(): Promise<{
     service?: string;
     version?: string;
 }>;
-export type { TextGenerationOptions, TextGenerationResult, AnalyticsData, EvaluationData, } from "./types/index.js";
+export type { AnalyticsData, EvaluationData, TextGenerationOptions, TextGenerationResult, } from "./types/index.js";
 /**
  * Legacy generateText function for backward compatibility.
  *
@@ -241,6 +244,42 @@ export type { TextGenerationOptions, TextGenerationResult, AnalyticsData, Evalua
  * @since 1.0.0
  */
 export declare function generateText(options: import("./types/index.js").TextGenerationOptions): Promise<import("./types/index.js").TextGenerationResult>;
+/**
+ * Workflow Engine for multi-model ensembles with judge-based evaluation
+ *
+ * Enables sophisticated AI orchestration patterns:
+ * - Ensemble execution (parallel multi-model)
+ * - Chain execution (sequential fallback)
+ * - Adaptive execution (tier-based quality/cost optimization)
+ * - Multi-judge voting for consensus
+ *
+ * @example
+ * ```typescript
+ * import { neurolink, CONSENSUS_3_WORKFLOW } from '@juspay/neurolink';
+ *
+ * // Use workflow via generate() with workflowConfig option
+ * const result = await neurolink.generate({
+ *   input: { text: 'Explain quantum computing' },
+ *   workflowConfig: CONSENSUS_3_WORKFLOW,
+ * });
+ *
+ * console.log('Best response:', result.content);
+ * console.log('Selected model:', result.workflow?.selectedModel);
+ * console.log('Total time:', result.workflow?.metrics?.totalTime);
+ * ```
+ */
+export type { WorkflowConfig, WorkflowResult, ModelConfig, JudgeConfig, ModelGroup, EnsembleResponse, JudgeScores, MultiJudgeScores, WorkflowType, ExecutionStrategy, WorkflowValidationResult, } from "./workflow/types.js";
+export { runWorkflow } from "./workflow/core/workflowRunner.js";
+export type { RunWorkflowOptions } from "./workflow/core/workflowRunner.js";
+export { registerWorkflow, getWorkflow, listWorkflows, clearRegistry as clearWorkflowRegistry, } from "./workflow/core/workflowRegistry.js";
+export { CONSENSUS_3_WORKFLOW, CONSENSUS_3_FAST_WORKFLOW, createConsensus3WithPrompt, } from "./workflow/workflows/consensusWorkflow.js";
+export { FAST_FALLBACK_WORKFLOW, AGGRESSIVE_FALLBACK_WORKFLOW, } from "./workflow/workflows/fallbackWorkflow.js";
+export { MULTI_JUDGE_5_WORKFLOW, MULTI_JUDGE_3_WORKFLOW, createMultiJudgeWorkflow, } from "./workflow/workflows/multiJudgeWorkflow.js";
+export { QUALITY_MAX_WORKFLOW, SPEED_FIRST_WORKFLOW, BALANCED_ADAPTIVE_WORKFLOW, createAdaptiveWorkflow, } from "./workflow/workflows/adaptiveWorkflow.js";
+export { validateWorkflow } from "./workflow/utils/workflowValidation.js";
+export { calculateModelMetrics, compareWorkflows, generateSummaryStats, } from "./workflow/utils/workflowMetrics.js";
+export { WORKFLOW_ENGINE_VERSION, DEFAULT_SCORE_SCALE, } from "./workflow/index.js";
+export type { AgentExecuteRequest, AgentExecuteResponse, AuthConfig, AuthenticatedUser, AuthResult, AuthStrategy, BodyParserConfig, CacheConfig, CacheEntry, CacheStore, CORSConfig, CreateRoutesOptions, DataEvent, DataStreamEvent, DataStreamEventType, DataStreamResponseConfig, DataStreamWriter, DataStreamWriterConfig, ErrorCategoryType, ErrorEvent, ErrorResponse, ErrorSeverityType, FinishEvent, HealthResponse, HttpMethod, LoggingConfig, MCPServerStatusResponse, MiddlewareDefinition, MiddlewareHandler, OpenAPIGeneratorConfig, OpenAPISpec, PropertySchema, RateLimitConfig as ServerRateLimitConfig, RateLimitMiddlewareConfig, RateLimitStore, ReadyResponse, RequiredServerAdapterConfig, RouteDefinition, RouteGroup, RouteHandler, ServerAdapterConfig, ServerAdapterErrorCodeType, ServerAdapterErrorContext, ServerAdapterEvents, ServerAdapterFactoryOptions, ServerContext, ServerFramework, ServerResponse, ServerStatus, SSEWriteOptions, StreamingConfig, TextDeltaEvent, TextEndEvent, TextStartEvent, ToolCallEvent, ToolExecuteRequest, ToolExecuteResponse, ToolResultEvent, ValidationConfig, ValidationResult, ValidationSchema, WebSocketAuthConfig, WebSocketConfig, WebSocketConnection, WebSocketHandler, WebSocketMessage, WebSocketMessageType, } from "./server/index.js";
 /**
  * Server Adapters for exposing NeuroLink as HTTP APIs
  *
@@ -259,5 +298,35 @@ export declare function generateText(options: import("./types/index.js").TextGen
  * await server.start();
  * ```
  */
-export { createServer, ServerAdapterFactory, BaseServerAdapter, HonoServerAdapter, ExpressServerAdapter, FastifyServerAdapter, KoaServerAdapter, createAgentRoutes, createAllRoutes, createHealthRoutes, createMCPRoutes, createMemoryRoutes, createToolRoutes, registerAllRoutes, createAuthMiddleware, createRoleMiddleware, createRateLimitMiddleware, createSlidingWindowRateLimitMiddleware, InMemoryRateLimitStore, RateLimitError, createCacheMiddleware, createCacheInvalidator, InMemoryCacheStore, createRequestValidationMiddleware, createFieldValidator, ValidationError, createTimingMiddleware, createRequestIdMiddleware, createErrorHandlingMiddleware, createSecurityHeadersMiddleware, createLoggingMiddleware, createCompressionMiddleware, AgentExecuteRequestSchema, createErrorResponse, ServerNameParamSchema, SessionIdParamSchema, ToolArgumentsSchema, ToolExecuteRequestSchema, ToolNameParamSchema, ToolSearchQuerySchema, validateParams, validateQuery, validateRequest, OpenAPIGenerator, createOpenAPIGenerator, generateOpenAPISpec, generateOpenAPIFromConfig, createDataStreamWriter, DataStreamResponse, createDataStreamResponse, pipeAsyncIterableToDataStream, createSSEHeaders, createNDJSONHeaders, WebSocketConnectionManager, WebSocketMessageRouter, createAgentWebSocketHandler, ServerAdapterError, ConfigurationError, RouteConflictError, RouteNotFoundError, ServerValidationError, AuthenticationError, InvalidAuthenticationError, AuthorizationError, ServerRateLimitError, TimeoutError, HandlerError, StreamingError, StreamAbortedError, WebSocketError, WebSocketConnectionError, ServerStartError, ServerStopError, AlreadyRunningError, NotRunningError, MissingDependencyError, ErrorRecoveryStrategies, wrapError, ErrorCategory, ErrorSeverity, ServerAdapterErrorCode, } from "./server/index.js";
-export type { AgentExecuteRequest, AgentExecuteResponse, BodyParserConfig, CORSConfig, DataStreamWriter, HealthResponse, HttpMethod, LoggingConfig, MCPServerStatusResponse, MiddlewareDefinition, MiddlewareHandler, RateLimitConfig as ServerRateLimitConfig, ReadyResponse, RequiredServerAdapterConfig, RouteDefinition, RouteGroup, RouteHandler, ServerAdapterConfig, ServerAdapterEvents, ServerAdapterFactoryOptions, ServerContext, ServerFramework, ServerResponse, ServerStatus, SSEWriteOptions, StreamingConfig, ToolExecuteRequest, ToolExecuteResponse, ErrorResponse, ValidationResult, AuthConfig, AuthResult, RateLimitMiddlewareConfig, RateLimitStore, CacheConfig, CacheEntry, CacheStore, ValidationConfig, ValidationSchema, PropertySchema, OpenAPIGeneratorConfig, OpenAPISpec, DataStreamEventType, DataStreamEvent, TextStartEvent, TextDeltaEvent, TextEndEvent, ToolCallEvent, ToolResultEvent, DataEvent, ErrorEvent, FinishEvent, DataStreamWriterConfig, DataStreamResponseConfig, WebSocketConfig, WebSocketHandler, WebSocketConnection, WebSocketMessage, WebSocketMessageType, AuthenticatedUser, WebSocketAuthConfig, AuthStrategy, ErrorCategoryType, ErrorSeverityType, ServerAdapterErrorCodeType, ServerAdapterErrorContext, CreateRoutesOptions, } from "./server/index.js";
+export { AgentExecuteRequestSchema, AlreadyRunningError, AuthenticationError, AuthorizationError, BaseServerAdapter, ConfigurationError, createAgentRoutes, createAgentWebSocketHandler, createAllRoutes, createAuthMiddleware, createCacheInvalidator, createCacheMiddleware, createCompressionMiddleware, createDataStreamResponse, createDataStreamWriter, createErrorHandlingMiddleware, createErrorResponse, createFieldValidator, createHealthRoutes, createLoggingMiddleware, createMCPRoutes, createMemoryRoutes, createNDJSONHeaders, createOpenAPIGenerator, createRateLimitMiddleware, createRequestIdMiddleware, createRequestValidationMiddleware, createRoleMiddleware, createSecurityHeadersMiddleware, createServer, createSlidingWindowRateLimitMiddleware, createSSEHeaders, createTimingMiddleware, createToolRoutes, DataStreamResponse, ErrorCategory, ErrorRecoveryStrategies, ErrorSeverity, ExpressServerAdapter, FastifyServerAdapter, generateOpenAPIFromConfig, generateOpenAPISpec, HandlerError, HonoServerAdapter, InMemoryCacheStore, InMemoryRateLimitStore, InvalidAuthenticationError, KoaServerAdapter, MissingDependencyError, NotRunningError, OpenAPIGenerator, pipeAsyncIterableToDataStream, RateLimitError, RouteConflictError, RouteNotFoundError, registerAllRoutes, ServerAdapterError, ServerAdapterErrorCode, ServerAdapterFactory, ServerNameParamSchema, ServerRateLimitError, ServerStartError, ServerStopError, ServerValidationError, SessionIdParamSchema, StreamAbortedError, StreamingError, TimeoutError, ToolArgumentsSchema, ToolExecuteRequestSchema, ToolNameParamSchema, ToolSearchQuerySchema, ValidationError, validateParams, validateQuery, validateRequest, WebSocketConnectionError, WebSocketConnectionManager, WebSocketError, WebSocketMessageRouter, wrapError, } from "./server/index.js";
+export type { BaseChunkerConfig, BM25Result, CharacterChunkerConfig, Chunk, ChunkingStrategy, ChunkMetadata, ChunkParams, CitationFormat, ContextAssemblyOptions, ContextWindow, CSVLoaderOptions, DocumentType, EmbeddingModelConfig, ExtractionResult, ExtractParams, GenerationModelConfig, GraphChunk, GraphEdge, GraphEmbedding, GraphNode, GraphQueryParams, GraphRAGConfig, GraphStats, HTMLChunkerConfig, HybridSearchConfig, HybridSearchResult, IngestOptions, JSONChunkerConfig, LaTeXChunkerConfig, LoaderOptions, MarkdownChunkerConfig, MDocumentConfig, MetadataFilter, PDFLoaderOptions, PipelineStats, QueryOptions as RAGQueryOptions, RAGCommandArgs, RAGConfig, RAGPipelineConfig, RAGResponse, RankedNode, RecursiveChunkerConfig, RerankerConfig, RerankerOptions, RerankResult, SemanticChunkerConfig, SentenceChunkerConfig, TokenChunkerConfig, VectorQueryResponse, VectorQueryResult, VectorQueryToolConfig, VectorStore, WebLoaderOptions, } from "./rag/index.js";
+/**
+ * RAG (Retrieval-Augmented Generation) Document Processing
+ *
+ * Comprehensive RAG system with document loading, chunking, embedding,
+ * retrieval, and context assembly capabilities.
+ *
+ * @example
+ * ```typescript
+ * import {
+ *   MDocument,
+ *   loadDocument,
+ *   RAGPipeline,
+ *   ChunkerRegistry
+ * } from '@juspay/neurolink';
+ *
+ * // Load and process a document
+ * const doc = await loadDocument('/path/to/document.md');
+ * await doc.chunk({ strategy: 'markdown', config: { maxSize: 1000 } });
+ *
+ * // Use the full RAG pipeline
+ * const pipeline = new RAGPipeline({
+ *   embeddingModel: { provider: 'openai', modelName: 'text-embedding-3-small' },
+ *   generationModel: { provider: 'openai', modelName: 'gpt-4o-mini' }
+ * });
+ * await pipeline.ingest(['./docs/*.md']);
+ * const response = await pipeline.query('What are the key features?');
+ * console.log(response.answer);
+ * ```
+ */
+export { assembleContext, batchRerank, CharacterChunker, ChunkerRegistry, CohereRelevanceScorer, CrossEncoderReranker, CSVLoader, chunkText, createChunker, createContextWindow, createHybridSearch, createRAGPipeline, createVectorQueryTool, executeWithCircuitBreaker, extractMetadata, formatContextWithCitations, GraphRAG, getAvailableStrategies, getCircuitBreaker, getDefaultChunkerConfig, getRecommendedStrategy, HTMLChunker, HTMLLoader, InMemoryBM25Index, InMemoryVectorStore, JSONChunker as RAGJSONChunker, JSONLoader, LaTeXChunker, LLMMetadataExtractor, linearCombination, loadDocument, loadDocuments, MarkdownChunker, MarkdownLoader, MDocument, PDFLoader, prepareRAGTool, processDocument, RAGCircuitBreaker, type RAGCircuitBreakerConfig, type RAGCircuitBreakerEvents, RAGCircuitBreakerManager, type RAGCircuitBreakerStats, RAGPipeline, RAGRetryHandler, RecursiveChunker, ragCircuitBreakerManager, reciprocalRankFusion, rerank, SemanticChunker, SentenceChunker, simpleRerank, summarizeContext, TextLoader, TokenChunker, WebLoader, } from "./rag/index.js";

package/dist/lib/index.js

@@ -34,30 +34,34 @@
 // Core exports
 import { AIProviderFactory } from "./core/factory.js";
 export { AIProviderFactory };
-// Export ALL types from the centralized type barrel
-export * from "./types/index.js";
-// Tool Registration utility
-export { validateTool } from "./sdk/toolRegistration.js";
+// Config Manager export
+export { NeuroLinkConfigManager as ConfigManager } from "./config/configManager.js";
 export { AIProviderName, BedrockModels, OpenAIModels, VertexModels, } from "./constants/enums.js";
-// Utility exports
-export { getBestProvider, getAvailableProviders, isValidProvider, } from "./utils/providerUtils.js";
 // Dynamic Models exports
 export { dynamicModelProvider } from "./core/dynamicModels.js";
+// Tool Registration utility
+export { validateTool } from "./sdk/toolRegistration.js";
+// Export ALL types from the centralized type barrel
+export * from "./types/index.js";
+// Utility exports
+export { getAvailableProviders, getBestProvider, isValidProvider, } from "./utils/providerUtils.js";
 // Main NeuroLink wrapper class and diagnostic types
 import { NeuroLink } from "./neurolink.js";
 export { NeuroLink };
 export { buildObservabilityConfigFromEnv } from "./utils/observabilityHelpers.js";
-import { initializeOpenTelemetry, shutdownOpenTelemetry, flushOpenTelemetry, getLangfuseHealthStatus, setLangfuseContext, getLangfuseSpanProcessor, getTracerProvider, isOpenTelemetryInitialized, 
-// NEW EXPORTS - External TracerProvider Support
-getSpanProcessors, createContextEnricher, isUsingExternalTracerProvider, 
+import { createContextEnricher, flushOpenTelemetry, 
 // Enhanced context and tracing
-getLangfuseContext, getTracer, } from "./services/server/ai/observability/instrumentation.js";
-import { initializeTelemetry as init, getTelemetryStatus as getStatus, } from "./telemetry/index.js";
+getLangfuseContext, getLangfuseHealthStatus, getLangfuseSpanProcessor, 
+// NEW EXPORTS - External TracerProvider Support
+getSpanProcessors, getTracer, getTracerProvider, initializeOpenTelemetry, isOpenTelemetryInitialized, isUsingExternalTracerProvider, setLangfuseContext, shutdownOpenTelemetry, } from "./services/server/ai/observability/instrumentation.js";
+import { getTelemetryStatus as getStatus, initializeTelemetry as init, } from "./telemetry/index.js";
 export { initializeOpenTelemetry, shutdownOpenTelemetry, flushOpenTelemetry, getLangfuseHealthStatus, setLangfuseContext, getLangfuseSpanProcessor, getTracerProvider, isOpenTelemetryInitialized, 
 // NEW EXPORTS - External TracerProvider Support
 getSpanProcessors, createContextEnricher, isUsingExternalTracerProvider, 
 // Enhanced context and tracing
 getLangfuseContext, getTracer, };
+// Analytics Middleware exports
+export { clearAnalyticsMetrics, createAnalyticsMiddleware, getAnalyticsMetrics, } from "./middleware/builtin/analytics.js";
 export { MiddlewareFactory } from "./middleware/factory.js";
 // Version
 export const VERSION = "1.0.0";
@@ -205,16 +209,19 @@ export async function createBestAIProvider(requestedProvider, modelName) {
  * await writeFile('output.txt', 'Hello from MCP!');
  * ```
  */
-export { 
-// Core MCP ecosystem
-// Simplified MCP exports
-initializeMCPEcosystem, listMCPs, executeMCP, getMCPStats, mcpLogger, 
+export { CircuitBreakerManager, calculateExpiresAt, 
+// MCP Server Factory
+createMCPServer, createOAuthProviderFromConfig, DEFAULT_HTTP_RETRY_CONFIG, DEFAULT_RATE_LIMIT_CONFIG, executeMCP, FileTokenStorage, getMCPStats, getServerInfo, globalCircuitBreakerManager, globalRateLimiterManager, 
 // HTTP Transport utilities
-HTTPRateLimiter, RateLimiterManager, globalRateLimiterManager, DEFAULT_RATE_LIMIT_CONFIG, DEFAULT_HTTP_RETRY_CONFIG, isRetryableStatusCode, isRetryableHTTPError, withHTTPRetry, 
+HTTPRateLimiter, 
 // OAuth Authentication
-InMemoryTokenStorage, FileTokenStorage, isTokenExpired, calculateExpiresAt, NeuroLinkOAuthProvider, createOAuthProviderFromConfig, 
+InMemoryTokenStorage, 
+// Core MCP ecosystem
+// Simplified MCP exports
+initializeMCPEcosystem, isRetryableHTTPError, isRetryableStatusCode, isTokenExpired, listMCPs, 
 // Circuit Breaker
-MCPCircuitBreaker, CircuitBreakerManager, globalCircuitBreakerManager, } from "./mcp/index.js";
+MCPCircuitBreaker, mcpLogger, NeuroLinkOAuthProvider, RateLimiterManager, validateServerTools, validateTool as validateMCPTool, withHTTPRetry, } from "./mcp/index.js";
+export { logger } from "./utils/logger.js";
 // ============================================================================
 // REAL-TIME SERVICES & TELEMETRY - Enterprise Platform Features
 // ============================================================================
@@ -282,9 +289,23 @@ export async function generateText(options) {
     const neurolink = new NeuroLink();
     return await neurolink.generateText(options);
 }
-// ============================================================================
-// SERVER ADAPTERS - HTTP API Framework Integration
-// ============================================================================
+// Workflow execution
+export { runWorkflow } from "./workflow/core/workflowRunner.js";
+// Workflow registry
+export { registerWorkflow, getWorkflow, listWorkflows, clearRegistry as clearWorkflowRegistry, } from "./workflow/core/workflowRegistry.js";
+// Pre-built workflows - Consensus
+export { CONSENSUS_3_WORKFLOW, CONSENSUS_3_FAST_WORKFLOW, createConsensus3WithPrompt, } from "./workflow/workflows/consensusWorkflow.js";
+// Pre-built workflows - Fallback
+export { FAST_FALLBACK_WORKFLOW, AGGRESSIVE_FALLBACK_WORKFLOW, } from "./workflow/workflows/fallbackWorkflow.js";
+// Pre-built workflows - Multi-judge
+export { MULTI_JUDGE_5_WORKFLOW, MULTI_JUDGE_3_WORKFLOW, createMultiJudgeWorkflow, } from "./workflow/workflows/multiJudgeWorkflow.js";
+// Pre-built workflows - Adaptive
+export { QUALITY_MAX_WORKFLOW, SPEED_FIRST_WORKFLOW, BALANCED_ADAPTIVE_WORKFLOW, createAdaptiveWorkflow, } from "./workflow/workflows/adaptiveWorkflow.js";
+// Validation and metrics
+export { validateWorkflow } from "./workflow/utils/workflowValidation.js";
+export { calculateModelMetrics, compareWorkflows, generateSummaryStats, } from "./workflow/utils/workflowMetrics.js";
+// Workflow constants
+export { WORKFLOW_ENGINE_VERSION, DEFAULT_SCORE_SCALE, } from "./workflow/index.js";
 /**
  * Server Adapters for exposing NeuroLink as HTTP APIs
  *
@@ -304,24 +325,72 @@ export async function generateText(options) {
  * ```
  */
 export { 
-// Server Factory
-createServer, ServerAdapterFactory, 
+// Validation
+AgentExecuteRequestSchema, AlreadyRunningError, AuthenticationError, AuthorizationError, 
 // Framework Adapters
-BaseServerAdapter, HonoServerAdapter, ExpressServerAdapter, FastifyServerAdapter, KoaServerAdapter, 
+BaseServerAdapter, ConfigurationError, 
 // Routes
-createAgentRoutes, createAllRoutes, createHealthRoutes, createMCPRoutes, createMemoryRoutes, createToolRoutes, registerAllRoutes, 
+createAgentRoutes, createAgentWebSocketHandler, createAllRoutes, 
 // Middleware
-createAuthMiddleware, createRoleMiddleware, createRateLimitMiddleware, createSlidingWindowRateLimitMiddleware, InMemoryRateLimitStore, RateLimitError, createCacheMiddleware, createCacheInvalidator, InMemoryCacheStore, createRequestValidationMiddleware, createFieldValidator, ValidationError, createTimingMiddleware, createRequestIdMiddleware, createErrorHandlingMiddleware, createSecurityHeadersMiddleware, createLoggingMiddleware, createCompressionMiddleware, 
-// Validation
-AgentExecuteRequestSchema, createErrorResponse, ServerNameParamSchema, SessionIdParamSchema, ToolArgumentsSchema, ToolExecuteRequestSchema, ToolNameParamSchema, ToolSearchQuerySchema, validateParams, validateQuery, validateRequest, 
-// OpenAPI
-OpenAPIGenerator, createOpenAPIGenerator, generateOpenAPISpec, generateOpenAPIFromConfig, 
+createAuthMiddleware, createCacheInvalidator, createCacheMiddleware, createCompressionMiddleware, createDataStreamResponse, 
 // Streaming
-createDataStreamWriter, DataStreamResponse, createDataStreamResponse, pipeAsyncIterableToDataStream, createSSEHeaders, createNDJSONHeaders, 
-// WebSocket
-WebSocketConnectionManager, WebSocketMessageRouter, createAgentWebSocketHandler, 
-// Errors
-ServerAdapterError, ConfigurationError, RouteConflictError, RouteNotFoundError, ServerValidationError, AuthenticationError, InvalidAuthenticationError, AuthorizationError, ServerRateLimitError, TimeoutError, HandlerError, StreamingError, StreamAbortedError, WebSocketError, WebSocketConnectionError, ServerStartError, ServerStopError, AlreadyRunningError, NotRunningError, MissingDependencyError, ErrorRecoveryStrategies, wrapError, 
+createDataStreamWriter, createErrorHandlingMiddleware, createErrorResponse, createFieldValidator, createHealthRoutes, createLoggingMiddleware, createMCPRoutes, createMemoryRoutes, createNDJSONHeaders, createOpenAPIGenerator, createRateLimitMiddleware, createRequestIdMiddleware, createRequestValidationMiddleware, createRoleMiddleware, createSecurityHeadersMiddleware, 
+// Server Factory
+createServer, createSlidingWindowRateLimitMiddleware, createSSEHeaders, createTimingMiddleware, createToolRoutes, DataStreamResponse, 
 // Error Constants
-ErrorCategory, ErrorSeverity, ServerAdapterErrorCode, } from "./server/index.js";
+ErrorCategory, ErrorRecoveryStrategies, ErrorSeverity, ExpressServerAdapter, FastifyServerAdapter, generateOpenAPIFromConfig, generateOpenAPISpec, HandlerError, HonoServerAdapter, InMemoryCacheStore, InMemoryRateLimitStore, InvalidAuthenticationError, KoaServerAdapter, MissingDependencyError, NotRunningError, 
+// OpenAPI
+OpenAPIGenerator, pipeAsyncIterableToDataStream, RateLimitError, RouteConflictError, RouteNotFoundError, registerAllRoutes, 
+// Errors
+ServerAdapterError, ServerAdapterErrorCode, ServerAdapterFactory, ServerNameParamSchema, ServerRateLimitError, ServerStartError, ServerStopError, ServerValidationError, SessionIdParamSchema, StreamAbortedError, StreamingError, TimeoutError, ToolArgumentsSchema, ToolExecuteRequestSchema, ToolNameParamSchema, ToolSearchQuerySchema, ValidationError, validateParams, validateQuery, validateRequest, WebSocketConnectionError, 
+// WebSocket
+WebSocketConnectionManager, WebSocketError, WebSocketMessageRouter, wrapError, } from "./server/index.js";
+/**
+ * RAG (Retrieval-Augmented Generation) Document Processing
+ *
+ * Comprehensive RAG system with document loading, chunking, embedding,
+ * retrieval, and context assembly capabilities.
+ *
+ * @example
+ * ```typescript
+ * import {
+ *   MDocument,
+ *   loadDocument,
+ *   RAGPipeline,
+ *   ChunkerRegistry
+ * } from '@juspay/neurolink';
+ *
+ * // Load and process a document
+ * const doc = await loadDocument('/path/to/document.md');
+ * await doc.chunk({ strategy: 'markdown', config: { maxSize: 1000 } });
+ *
+ * // Use the full RAG pipeline
+ * const pipeline = new RAGPipeline({
+ *   embeddingModel: { provider: 'openai', modelName: 'text-embedding-3-small' },
+ *   generationModel: { provider: 'openai', modelName: 'gpt-4o-mini' }
+ * });
+ * await pipeline.ingest(['./docs/*.md']);
+ * const response = await pipeline.query('What are the key features?');
+ * console.log(response.answer);
+ * ```
+ */
+export { 
+// Pipeline
+assembleContext, 
+// Reranker
+batchRerank, 
+// Chunking
+CharacterChunker, ChunkerRegistry, CohereRelevanceScorer, CrossEncoderReranker, 
+// Document Processing
+CSVLoader, chunkText, createChunker, createContextWindow, 
+// Retrieval
+createHybridSearch, createRAGPipeline, createVectorQueryTool, 
+// Resilience
+executeWithCircuitBreaker, 
+// Metadata Extraction
+extractMetadata, formatContextWithCitations, 
+// Graph RAG
+GraphRAG, getAvailableStrategies, getCircuitBreaker, getDefaultChunkerConfig, getRecommendedStrategy, HTMLChunker, HTMLLoader, InMemoryBM25Index, InMemoryVectorStore, JSONChunker as RAGJSONChunker, JSONLoader, LaTeXChunker, LLMMetadataExtractor, linearCombination, loadDocument, loadDocuments, MarkdownChunker, MarkdownLoader, MDocument, PDFLoader, 
+// RAG Integration for generate/stream
+prepareRAGTool, processDocument, RAGCircuitBreaker, RAGCircuitBreakerManager, RAGPipeline, RAGRetryHandler, RecursiveChunker, ragCircuitBreakerManager, reciprocalRankFusion, rerank, SemanticChunker, SentenceChunker, simpleRerank, summarizeContext, TextLoader, TokenChunker, WebLoader, } from "./rag/index.js";
 //# sourceMappingURL=index.js.map

package/dist/lib/mcp/index.d.ts

@@ -4,12 +4,13 @@
  * Implementation based on research blueprint
  */
 import type { McpMetadata } from "../types/mcpTypes.js";
+export type { AuthorizationUrlResult, HTTPRetryConfig, MCPOAuthConfig, OAuthClientInformation, OAuthTokens, RateLimitConfig, TokenExchangeRequest, TokenStorage, } from "../types/mcpTypes.js";
 export { mcpLogger } from "../utils/logger.js";
-export type { RateLimitConfig, HTTPRetryConfig, OAuthTokens, TokenStorage, MCPOAuthConfig, OAuthClientInformation, AuthorizationUrlResult, TokenExchangeRequest, } from "../types/mcpTypes.js";
-export { HTTPRateLimiter, RateLimiterManager, globalRateLimiterManager, DEFAULT_RATE_LIMIT_CONFIG, } from "./httpRateLimiter.js";
-export { DEFAULT_HTTP_RETRY_CONFIG, isRetryableStatusCode, isRetryableHTTPError, withHTTPRetry, } from "./httpRetryHandler.js";
-export { InMemoryTokenStorage, FileTokenStorage, isTokenExpired, calculateExpiresAt, NeuroLinkOAuthProvider, createOAuthProviderFromConfig, } from "./auth/index.js";
-export { MCPCircuitBreaker, CircuitBreakerManager, globalCircuitBreakerManager, } from "./mcpCircuitBreaker.js";
+export { calculateExpiresAt, createOAuthProviderFromConfig, FileTokenStorage, InMemoryTokenStorage, isTokenExpired, NeuroLinkOAuthProvider, } from "./auth/index.js";
+export { createMCPServer, getServerInfo, validateServerTools, validateTool, } from "./factory.js";
+export { DEFAULT_RATE_LIMIT_CONFIG, globalRateLimiterManager, HTTPRateLimiter, RateLimiterManager, } from "./httpRateLimiter.js";
+export { DEFAULT_HTTP_RETRY_CONFIG, isRetryableHTTPError, isRetryableStatusCode, withHTTPRetry, } from "./httpRetryHandler.js";
+export { CircuitBreakerManager, globalCircuitBreakerManager, MCPCircuitBreaker, } from "./mcpCircuitBreaker.js";
 /**
  * Initialize the MCP ecosystem - simplified
  */

package/dist/lib/mcp/index.js

@@ -1,12 +1,14 @@
 export { mcpLogger } from "../utils/logger.js";
+// OAuth Authentication
+export { calculateExpiresAt, createOAuthProviderFromConfig, FileTokenStorage, InMemoryTokenStorage, isTokenExpired, NeuroLinkOAuthProvider, } from "./auth/index.js";
+// MCP Server Factory
+export { createMCPServer, getServerInfo, validateServerTools, validateTool, } from "./factory.js";
 // HTTP Rate Limiter
-export { HTTPRateLimiter, RateLimiterManager, globalRateLimiterManager, DEFAULT_RATE_LIMIT_CONFIG, } from "./httpRateLimiter.js";
+export { DEFAULT_RATE_LIMIT_CONFIG, globalRateLimiterManager, HTTPRateLimiter, RateLimiterManager, } from "./httpRateLimiter.js";
 // HTTP Retry Handler
-export { DEFAULT_HTTP_RETRY_CONFIG, isRetryableStatusCode, isRetryableHTTPError, withHTTPRetry, } from "./httpRetryHandler.js";
-// OAuth Authentication
-export { InMemoryTokenStorage, FileTokenStorage, isTokenExpired, calculateExpiresAt, NeuroLinkOAuthProvider, createOAuthProviderFromConfig, } from "./auth/index.js";
+export { DEFAULT_HTTP_RETRY_CONFIG, isRetryableHTTPError, isRetryableStatusCode, withHTTPRetry, } from "./httpRetryHandler.js";
 // Circuit Breaker
-export { MCPCircuitBreaker, CircuitBreakerManager, globalCircuitBreakerManager, } from "./mcpCircuitBreaker.js";
+export { CircuitBreakerManager, globalCircuitBreakerManager, MCPCircuitBreaker, } from "./mcpCircuitBreaker.js";
 /**
  * Initialize the MCP ecosystem - simplified
  */

package/dist/lib/neurolink.d.ts

@@ -5,23 +5,22 @@
  * Enhanced AI provider system with natural MCP tool access.
  * Uses real MCP infrastructure for tool discovery and execution.
  */
-import type { TextGenerationOptions, TextGenerationResult, ProviderStatus } from "./types/index.js";
+import type { TextGenerationOptions, TextGenerationResult } from "./types/index.js";
+import type { ConversationMemoryManager } from "./core/conversationMemoryManager.js";
+import type { RedisConversationMemoryManager } from "./core/redisConversationMemoryManager.js";
+import { ExternalServerManager } from "./mcp/externalServerManager.js";
 import { MCPToolRegistry } from "./mcp/toolRegistry.js";
+import type { JsonObject, NeuroLinkEvents, TypedEventEmitter } from "./types/common.js";
+import type { NeurolinkConstructorConfig } from "./types/configTypes.js";
+import type { ChatMessage } from "./types/conversation.js";
+import type { ExternalMCPOperationResult, ExternalMCPServerInstance, ExternalMCPToolInfo } from "./types/externalMcp.js";
 import type { GenerateOptions, GenerateResult } from "./types/generateTypes.js";
-import type { StreamOptions, StreamResult } from "./types/streamTypes.js";
+import type { ProviderStatus } from "./types/index.js";
 import type { MCPExecutableTool, MCPServerInfo, MCPStatus } from "./types/mcpTypes.js";
-import type { ToolInfo } from "./types/tools.js";
-import type { NeuroLinkEvents, TypedEventEmitter } from "./types/common.js";
-import type { ToolExecutionContext, ToolExecutionSummary } from "./types/tools.js";
-import type { JsonObject } from "./types/common.js";
-import type { BatchOperationResult } from "./types/typeAliases.js";
-import type { ChatMessage } from "./types/conversation.js";
-import { ConversationMemoryManager } from "./core/conversationMemoryManager.js";
-import { RedisConversationMemoryManager } from "./core/redisConversationMemoryManager.js";
-import { ExternalServerManager } from "./mcp/externalServerManager.js";
-import type { ExternalMCPServerInstance, ExternalMCPOperationResult, ExternalMCPToolInfo } from "./types/externalMcp.js";
 import type { ObservabilityConfig } from "./types/observability.js";
-import type { NeurolinkConstructorConfig } from "./types/configTypes.js";
+import type { StreamOptions, StreamResult } from "./types/streamTypes.js";
+import type { ToolExecutionContext, ToolExecutionSummary, ToolInfo } from "./types/tools.js";
+import type { BatchOperationResult } from "./types/typeAliases.js";
 /**
  * NeuroLink - Universal AI Development Platform
  *
@@ -456,6 +455,16 @@ export declare class NeuroLink {
      * @since 1.0.0
      */
     generate(optionsOrPrompt: GenerateOptions | string): Promise<GenerateResult>;
+    /**
+     * Generate with workflow engine integration
+     * Returns both original and processed responses for AB testing
+     */
+    private generateWithWorkflow;
+    /**
+     * Stream with workflow engine integration
+     * Progressive streaming: yields preliminary response (first model) then final synthesis
+     */
+    private streamWithWorkflow;
     /**
      * BACKWARD COMPATIBILITY: Legacy generateText method
      * Internally calls generate() and converts result format