@juspay/neurolink 9.2.0 → 9.3.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,7 @@ 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>;
+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 +263,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,6 @@ export async function generateText(options) {
     const neurolink = new NeuroLink();
     return await neurolink.generateText(options);
 }
-// ============================================================================
-// SERVER ADAPTERS - HTTP API Framework Integration
-// ============================================================================
 /**
  * Server Adapters for exposing NeuroLink as HTTP APIs
  *
@@ -304,24 +308,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,21 @@
  * 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 { 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, TextGenerationOptions, TextGenerationResult } 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
  *

package/dist/lib/neurolink.js

@@ -13,39 +13,35 @@ try {
 catch {
     // Environment variables should be set externally in production
 }
-import { AIProviderFactory } from "./core/factory.js";
-import { isNonNullObject } from "./utils/typeUtils.js";
-import { isZodSchema } from "./utils/schemaConversion.js";
-import { AIProviderName } from "./constants/enums.js";
-import { mcpLogger } from "./utils/logger.js";
-import { SYSTEM_LIMITS } from "./core/constants.js";
-import { NANOSECOND_TO_MS_DIVISOR, TOOL_TIMEOUTS, RETRY_ATTEMPTS, RETRY_DELAYS, CIRCUIT_BREAKER, CIRCUIT_BREAKER_RESET_MS, MEMORY_THRESHOLDS, PROVIDER_TIMEOUTS, PERFORMANCE_THRESHOLDS, } from "./constants/index.js";
+import { EventEmitter } from "events";
 import pLimit from "p-limit";
-import { MCPToolRegistry } from "./mcp/toolRegistry.js";
-import { logger } from "./utils/logger.js";
-import { getBestProvider } from "./utils/providerUtils.js";
+import { CIRCUIT_BREAKER, CIRCUIT_BREAKER_RESET_MS, MEMORY_THRESHOLDS, NANOSECOND_TO_MS_DIVISOR, PERFORMANCE_THRESHOLDS, PROVIDER_TIMEOUTS, RETRY_ATTEMPTS, RETRY_DELAYS, TOOL_TIMEOUTS, } from "./constants/index.js";
+import { SYSTEM_LIMITS } from "./core/constants.js";
+import { AIProviderFactory } from "./core/factory.js";
 import { ProviderRegistry } from "./factories/providerRegistry.js";
-import { createCustomToolServerInfo, detectCategory, } from "./utils/mcpDefaults.js";
-// Factory processing imports
-import { processFactoryOptions, enhanceTextGenerationOptions, validateFactoryConfig, processStreamingFactoryOptions, createCleanStreamOptions, } from "./utils/factoryProcessing.js";
-// Tool detection and execution imports
-// Transformation utilities
-import { transformToolExecutions, transformToolExecutionsForMCP, transformAvailableTools, transformToolsForMCP, transformToolsToExpectedFormat, transformToolsToDescriptions, extractToolNames, transformParamsForLogging, optimizeToolForCollection, } from "./utils/transformationUtils.js";
-// Enhanced error handling imports
-import { ErrorFactory, NeuroLinkError, withTimeout, withRetry, isRetriableError, logStructuredError, CircuitBreaker, } from "./utils/errorHandling.js";
-import { EventEmitter } from "events";
-import { ConversationMemoryManager } from "./core/conversationMemoryManager.js";
-import { RedisConversationMemoryManager } from "./core/redisConversationMemoryManager.js";
-import { getConversationMessages, storeConversationTurn, } from "./utils/conversationMemory.js";
-import { ExternalServerManager } from "./mcp/externalServerManager.js";
 import { HITLManager } from "./hitl/hitlManager.js";
+import { ExternalServerManager } from "./mcp/externalServerManager.js";
 // Import direct tools server for automatic registration
 import { directToolsServer } from "./mcp/servers/agent/directToolsServer.js";
+import { MCPToolRegistry } from "./mcp/toolRegistry.js";
+import { initializeMem0 } from "./memory/mem0Initializer.js";
+import { flushOpenTelemetry, getLangfuseHealthStatus, initializeOpenTelemetry, isOpenTelemetryInitialized, setLangfuseContext, shutdownOpenTelemetry, } from "./services/server/ai/observability/instrumentation.js";
+import { getConversationMessages, storeConversationTurn, } from "./utils/conversationMemory.js";
+// Enhanced error handling imports
+import { CircuitBreaker, ErrorFactory, isRetriableError, logStructuredError, NeuroLinkError, withRetry, withTimeout, } from "./utils/errorHandling.js";
+// Factory processing imports
+import { createCleanStreamOptions, enhanceTextGenerationOptions, processFactoryOptions, processStreamingFactoryOptions, validateFactoryConfig, } from "./utils/factoryProcessing.js";
+import { logger, mcpLogger } from "./utils/logger.js";
+import { createCustomToolServerInfo, detectCategory, } from "./utils/mcpDefaults.js";
 // Import orchestration components
 import { ModelRouter } from "./utils/modelRouter.js";
+import { getBestProvider } from "./utils/providerUtils.js";
+import { isZodSchema } from "./utils/schemaConversion.js";
 import { BinaryTaskClassifier } from "./utils/taskClassifier.js";
-import { initializeOpenTelemetry, shutdownOpenTelemetry, flushOpenTelemetry, getLangfuseHealthStatus, setLangfuseContext, isOpenTelemetryInitialized, } from "./services/server/ai/observability/instrumentation.js";
-import { initializeMem0 } from "./memory/mem0Initializer.js";
+// Tool detection and execution imports
+// Transformation utilities
+import { extractToolNames, optimizeToolForCollection, transformAvailableTools, transformParamsForLogging, transformToolExecutions, transformToolExecutionsForMCP, transformToolsForMCP, transformToolsToDescriptions, transformToolsToExpectedFormat, } from "./utils/transformationUtils.js";
+import { isNonNullObject } from "./utils/typeUtils.js";
 /**
  * NeuroLink - Universal AI Development Platform
  *
@@ -1449,6 +1445,39 @@ Current user's request: ${currentInput}`;
                     // Continue with warning rather than throwing - graceful degradation
                 }
             }
+            // RAG Integration: If rag config is provided, prepare the RAG search tool
+            if (options.rag?.files?.length) {
+                try {
+                    const { prepareRAGTool } = await import("./rag/ragIntegration.js");
+                    const ragResult = await prepareRAGTool(options.rag, options.provider);
+                    // Inject the RAG tool into the tools record
+                    if (!options.tools) {
+                        options.tools = {};
+                    }
+                    options.tools[ragResult.toolName] =
+                        ragResult.tool;
+                    // Inject RAG-aware system prompt so the AI uses the RAG tool first
+                    const ragSystemInstruction = [
+                        `\n\nIMPORTANT: You have a tool called "${ragResult.toolName}" that searches through`,
+                        `${ragResult.filesLoaded} loaded document(s) containing ${ragResult.chunksIndexed} indexed chunks.`,
+                        `ALWAYS use the "${ragResult.toolName}" tool FIRST to answer the user's question before using any other tools.`,
+                        `This tool searches your local knowledge base of pre-loaded documents and is the primary source of truth.`,
+                        `Do NOT use websearchGrounding or any web search tools when the answer can be found in the loaded documents.`,
+                    ].join(" ");
+                    options.systemPrompt =
+                        (options.systemPrompt || "") + ragSystemInstruction;
+                    logger.info("[RAG] Tool injected into generate()", {
+                        toolName: ragResult.toolName,
+                        filesLoaded: ragResult.filesLoaded,
+                        chunksIndexed: ragResult.chunksIndexed,
+                    });
+                }
+                catch (error) {
+                    logger.warn("[RAG] Failed to prepare RAG tool, continuing without RAG", {
+                        error: error instanceof Error ? error.message : String(error),
+                    });
+                }
+            }
             // 🔧 CRITICAL FIX: Convert to TextGenerationOptions while preserving the input object for multimodal support
             const baseOptions = {
                 prompt: options.input.text,
@@ -1459,6 +1488,7 @@ Current user's request: ${currentInput}`;
                 systemPrompt: options.systemPrompt,
                 schema: options.schema,
                 output: options.output,
+                tools: options.tools, // Includes RAG tools if rag config was provided
                 disableTools: options.disableTools,
                 enableAnalytics: options.enableAnalytics,
                 enableEvaluation: options.enableEvaluation,
@@ -2184,6 +2214,39 @@ Current user's request: ${currentInput}`;
                         }
                     }
                 }
+                // RAG Integration: If rag config is provided, prepare the RAG search tool (stream)
+                if (options.rag?.files?.length) {
+                    try {
+                        const { prepareRAGTool } = await import("./rag/ragIntegration.js");
+                        const ragResult = await prepareRAGTool(options.rag, options.provider);
+                        // Inject the RAG tool into the tools record
+                        if (!options.tools) {
+                            options.tools = {};
+                        }
+                        options.tools[ragResult.toolName] =
+                            ragResult.tool;
+                        // Inject RAG-aware system prompt so the AI uses the RAG tool first
+                        const ragStreamInstruction = [
+                            `\n\nIMPORTANT: You have a tool called "${ragResult.toolName}" that searches through`,
+                            `${ragResult.filesLoaded} loaded document(s) containing ${ragResult.chunksIndexed} indexed chunks.`,
+                            `ALWAYS use the "${ragResult.toolName}" tool FIRST to answer the user's question before using any other tools.`,
+                            `This tool searches your local knowledge base of pre-loaded documents and is the primary source of truth.`,
+                            `Do NOT use websearchGrounding or any web search tools when the answer can be found in the loaded documents.`,
+                        ].join(" ");
+                        options.systemPrompt =
+                            (options.systemPrompt || "") + ragStreamInstruction;
+                        logger.info("[RAG] Tool injected into stream()", {
+                            toolName: ragResult.toolName,
+                            filesLoaded: ragResult.filesLoaded,
+                            chunksIndexed: ragResult.chunksIndexed,
+                        });
+                    }
+                    catch (error) {
+                        logger.warn("[RAG] Failed to prepare RAG tool, continuing without RAG", {
+                            error: error instanceof Error ? error.message : String(error),
+                        });
+                    }
+                }
                 factoryResult = processStreamingFactoryOptions(options);
                 enhancedOptions = createCleanStreamOptions(options);
                 if (options.input?.text) {
@@ -2330,7 +2393,7 @@ Current user's request: ${currentInput}`;
                         if (self.conversationMemory && enhancedOptions.context?.sessionId) {
                             const sessionId = enhancedOptions.context?.sessionId;
                             const userId = enhancedOptions.context?.userId;
-                            let providerDetails = undefined;
+                            let providerDetails;
                             if (enhancedOptions.model) {
                                 providerDetails = {
                                     provider: providerName,
@@ -2557,7 +2620,7 @@ Current user's request: ${currentInput}`;
                     const sessionId = enhancedOptions?.context?.sessionId;
                     const userId = enhancedOptions?.context
                         ?.userId;
-                    let providerDetails = undefined;
+                    let providerDetails;
                     if (options.model) {
                         providerDetails = {
                             provider: providerName,
@@ -3907,7 +3970,10 @@ Current user's request: ${currentInput}`;
     async hasProviderEnvVars(providerName) {
         const { ProviderHealthChecker } = await import("./utils/providerHealth.js");
         try {
-            const health = await ProviderHealthChecker.checkProviderHealth(providerName, { includeConnectivityTest: false, cacheResults: false });
+            const health = await ProviderHealthChecker.checkProviderHealth(providerName, {
+                includeConnectivityTest: false,
+                cacheResults: false,
+            });
             return health.isConfigured && health.hasApiKey;
         }
         catch (error) {
@@ -4511,7 +4577,7 @@ Current user's request: ${currentInput}`;
             // Import the integration module
             const { initializeConversationMemory } = await import("./core/conversationMemoryInitializer.js");
             // Use the integration module to create the appropriate memory manager
-            const memoryManager = await initializeConversationMemory(this.conversationMemoryConfig, this.emitter);
+            const memoryManager = await initializeConversationMemory(this.conversationMemoryConfig);
             // Assign to conversationMemory with proper type to handle both memory manager types
             this.conversationMemory = memoryManager;
             // Reset the lazy init flag since we've now initialized

package/dist/lib/providers/amazonBedrock.d.ts

@@ -1,9 +1,9 @@
 import { BedrockRuntimeClient } from "@aws-sdk/client-bedrock-runtime";
+import type { AIProviderName } from "../constants/enums.js";
 import { BaseProvider } from "../core/baseProvider.js";
+import type { NeuroLink } from "../neurolink.js";
 import type { EnhancedGenerateResult, TextGenerationOptions } from "../types/index.js";
-import { AIProviderName } from "../constants/enums.js";
 import type { StreamOptions, StreamResult } from "../types/streamTypes.js";
-import type { NeuroLink } from "../neurolink.js";
 export declare class AmazonBedrockProvider extends BaseProvider {
     private bedrockClient;
     private conversationHistory;
@@ -17,6 +17,11 @@ export declare class AmazonBedrockProvider extends BaseProvider {
     getAISDKModel(): never;
     getProviderName(): AIProviderName;
     getDefaultModel(): string;
+    /**
+     * Get the default embedding model for Amazon Bedrock
+     * @returns The default Bedrock embedding model name
+     */
+    protected getDefaultEmbeddingModel(): string;
     generate(optionsOrPrompt: TextGenerationOptions | string): Promise<EnhancedGenerateResult | null>;
     private conversationLoop;
     private callBedrock;
@@ -40,4 +45,12 @@ export declare class AmazonBedrockProvider extends BaseProvider {
      */
     checkBedrockHealth(): Promise<void>;
     handleProviderError(error: unknown): Error;
+    /**
+     * Generate embeddings for text using Amazon Bedrock embedding models
+     * Uses the native AWS SDK InvokeModel command for Titan embeddings
+     * @param text - The text to embed
+     * @param modelName - The embedding model to use (default: amazon.titan-embed-text-v2:0)
+     * @returns Promise resolving to the embedding vector
+     */
+    embed(text: string, modelName?: string): Promise<number[]>;
 }