@juspay/neurolink 9.1.1 → 9.3.0

package/dist/rag/types.js

@@ -0,0 +1,8 @@
+/**
+ * RAG Document Processing Types
+ *
+ * Comprehensive type definitions for RAG (Retrieval-Augmented Generation)
+ * document processing, including chunking strategies, metadata extraction,
+ * vector queries, and Graph RAG support.
+ */
+export {};

package/dist/server/index.d.ts

@@ -23,22 +23,26 @@
  * ```
  */
 export { BaseServerAdapter } from "./abstract/baseServerAdapter.js";
-export { HonoServerAdapter } from "./adapters/honoAdapter.js";
 export { ExpressServerAdapter } from "./adapters/expressAdapter.js";
 export { FastifyServerAdapter } from "./adapters/fastifyAdapter.js";
+export { HonoServerAdapter } from "./adapters/honoAdapter.js";
 export { KoaServerAdapter } from "./adapters/koaAdapter.js";
+export { AlreadyRunningError, AuthenticationError, AuthorizationError, ConfigurationError, ErrorRecoveryStrategies, HandlerError, InvalidAuthenticationError, MissingDependencyError, NotRunningError, RateLimitError as ServerRateLimitError, RouteConflictError, RouteNotFoundError, ServerAdapterError, ServerStartError, ServerStopError, StreamAbortedError, StreamingError, TimeoutError, ValidationError as ServerValidationError, WebSocketConnectionError, WebSocketError, wrapError, } from "./errors.js";
 export { createServer, ServerAdapterFactory, } from "./factory/serverAdapterFactory.js";
-export { createAgentRoutes, createAllRoutes, createHealthRoutes, createMCPRoutes, createMemoryRoutes, createOpenApiRoutes, createToolRoutes, registerAllRoutes, type CreateRoutesOptions, } from "./routes/index.js";
-export { createAuthMiddleware, createRoleMiddleware, type AuthConfig, type AuthResult, } from "./middleware/auth.js";
+export { type AbortSignalMiddlewareOptions, createAbortSignalMiddleware, createExpressAbortMiddleware, } from "./middleware/abortSignal.js";
+export { type AuthConfig, type AuthResult, createAuthMiddleware, createRoleMiddleware, } from "./middleware/auth.js";
+export { type CacheConfig, type CacheEntry, type CacheStore, createCacheInvalidator, createCacheMiddleware, InMemoryCacheStore, } from "./middleware/cache.js";
+export { createCompressionMiddleware, createErrorHandlingMiddleware, createLoggingMiddleware, createRequestIdMiddleware, createSecurityHeadersMiddleware, createTimingMiddleware, } from "./middleware/common.js";
+export { createDeprecationMiddleware, type DeprecationConfig, } from "./middleware/deprecation.js";
+export { createMCPBodyAttachmentMiddleware, fastifyMCPBodyHook, } from "./middleware/mcpBodyAttachment.js";
 export { createRateLimitMiddleware, createSlidingWindowRateLimitMiddleware, InMemoryRateLimitStore, RateLimitError, type RateLimitMiddlewareConfig, type RateLimitStore, } from "./middleware/rateLimit.js";
-export { createCacheMiddleware, createCacheInvalidator, InMemoryCacheStore, type CacheConfig, type CacheEntry, type CacheStore, } from "./middleware/cache.js";
-export { createRequestValidationMiddleware, createFieldValidator, ValidationError, type ValidationConfig, type ValidationSchema, type PropertySchema, } from "./middleware/validation.js";
-export { createTimingMiddleware, createRequestIdMiddleware, createErrorHandlingMiddleware, createSecurityHeadersMiddleware, createLoggingMiddleware, createCompressionMiddleware, } from "./middleware/common.js";
-export type { AgentExecuteRequest, AgentExecuteResponse, BodyParserConfig, CORSConfig, DataStreamWriter, HealthResponse, HttpMethod, LoggingConfig, MCPServerStatusResponse, MiddlewareDefinition, MiddlewareHandler, RateLimitConfig, ReadyResponse, RequiredServerAdapterConfig, RouteDefinition, RouteGroup, RouteHandler, ServerAdapterConfig, ServerAdapterEvents, ServerAdapterFactoryOptions, ServerContext, ServerFramework, ServerResponse, ServerStatus, SSEWriteOptions, StreamingConfig, ToolExecuteRequest, ToolExecuteResponse, WebSocketConfig, WebSocketHandler, WebSocketConnection, WebSocketMessage, WebSocketMessageType, AuthenticatedUser, AuthConfig as WebSocketAuthConfig, AuthStrategy, ErrorCategoryType, ErrorSeverityType, ServerAdapterErrorCodeType, ServerAdapterErrorContext, } from "./types.js";
+export { CommonSchemas, createFieldValidator, createRequestValidationMiddleware, type PropertySchema, type ValidationConfig, ValidationError, type ValidationSchema, } from "./middleware/validation.js";
+export { AgentExecuteRequestSchema as OpenAPIAgentExecuteRequestSchema, AgentExecuteResponseSchema, AgentInputSchema, ApiKeySecurityScheme, BasicSecurityScheme, BearerSecurityScheme, CommonParameters, ConversationMessageSchema, createApiInfo, createDeleteOperation, createErrorResponse as createOpenAPIErrorResponse, createGetOperation, createHeaderParameter, createOpenAPIGenerator, createPathParameter, createPostOperation, createQueryParameter, createServer as createOpenAPIServer, createStreamingPostOperation, createStreamingResponse, createSuccessResponse, DefaultServers, ErrorResponseSchema, generateOpenAPIFromConfig, generateOpenAPISpec, HealthResponseSchema, MCPServerStatusSchema, MCPServersListResponseSchema, MCPServerToolSchema, MetricsResponseSchema, NeuroLinkApiInfo, OpenAPIGenerator, type OpenAPIGeneratorConfig, OpenAPISchemas, type OpenAPISpec, ProviderInfoSchema, ReadyResponseSchema, SessionSchema, SessionsListResponseSchema, StandardErrorResponses, StandardTags, TokenUsageSchema, ToolCallSchema, ToolDefinitionSchema, ToolExecuteRequestSchema as OpenAPIToolExecuteRequestSchema, ToolExecuteResponseSchema, ToolListResponseSchema, ToolParameterSchema, } from "./openapi/index.js";
+export { type CreateRoutesOptions, createAgentRoutes, createAllRoutes, createHealthRoutes, createMCPRoutes, createMemoryRoutes, createOpenApiRoutes, createToolRoutes, registerAllRoutes, } from "./routes/index.js";
+export { BaseDataStreamWriter, createDataStreamResponse, createDataStreamWriter, createNDJSONHeaders, createSSEHeaders, type DataEvent, type DataStreamEvent, type DataStreamEventType, DataStreamResponse, type DataStreamResponseConfig, type DataStreamWriterConfig, type ErrorEvent, type FinishEvent, formatSSEEvent, pipeAsyncIterableToDataStream, type SSEEventOptions, type TextDeltaEvent, type TextEndEvent, type TextStartEvent, type ToolCallEvent, type ToolResultEvent, WebStreamWriter, } from "./streaming/index.js";
+export type { AgentExecuteRequest, AgentExecuteResponse, AuthConfig as WebSocketAuthConfig, AuthenticatedUser, AuthStrategy, BodyParserConfig, CORSConfig, DataStreamWriter, ErrorCategoryType, ErrorSeverityType, HealthResponse, HttpMethod, LoggingConfig, MCPServerStatusResponse, MiddlewareDefinition, MiddlewareHandler, RateLimitConfig, ReadyResponse, RequiredServerAdapterConfig, RouteDefinition, RouteGroup, RouteHandler, ServerAdapterConfig, ServerAdapterErrorCodeType, ServerAdapterErrorContext, ServerAdapterEvents, ServerAdapterFactoryOptions, ServerContext, ServerFramework, ServerResponse, ServerStatus, SSEWriteOptions, StreamingConfig, ToolExecuteRequest, ToolExecuteResponse, WebSocketConfig, WebSocketConnection, WebSocketHandler, WebSocketMessage, WebSocketMessageType, } from "./types.js";
 export { ErrorCategory, ErrorSeverity, ServerAdapterErrorCode, } from "./types.js";
+export { createStreamRedactor, redactStreamChunk } from "./utils/redaction.js";
 export type { ErrorResponse, ValidationResult } from "./utils/validation.js";
 export { AgentExecuteRequestSchema, createErrorResponse, ServerNameParamSchema, SessionIdParamSchema, ToolArgumentsSchema, ToolExecuteRequestSchema, ToolNameParamSchema, ToolSearchQuerySchema, validateParams, validateQuery, validateRequest, } from "./utils/validation.js";
-export { OpenAPIGenerator, createOpenAPIGenerator, generateOpenAPISpec, generateOpenAPIFromConfig, type OpenAPIGeneratorConfig, type OpenAPISpec, ErrorResponseSchema, TokenUsageSchema, AgentInputSchema, AgentExecuteRequestSchema as OpenAPIAgentExecuteRequestSchema, AgentExecuteResponseSchema, ToolCallSchema, ProviderInfoSchema, ToolParameterSchema, ToolDefinitionSchema, ToolListResponseSchema, ToolExecuteRequestSchema as OpenAPIToolExecuteRequestSchema, ToolExecuteResponseSchema, MCPServerToolSchema, MCPServerStatusSchema, MCPServersListResponseSchema, ConversationMessageSchema, SessionSchema, SessionsListResponseSchema, HealthResponseSchema, ReadyResponseSchema, MetricsResponseSchema, OpenAPISchemas, createSuccessResponse, createErrorResponse as createOpenAPIErrorResponse, createStreamingResponse, StandardErrorResponses, createPathParameter, createQueryParameter, createHeaderParameter, CommonParameters, createGetOperation, createPostOperation, createStreamingPostOperation, createDeleteOperation, BearerSecurityScheme, ApiKeySecurityScheme, BasicSecurityScheme, StandardTags, createServer as createOpenAPIServer, DefaultServers, createApiInfo, NeuroLinkApiInfo, } from "./openapi/index.js";
-export { type DataStreamEventType, type DataStreamEvent, type TextStartEvent, type TextDeltaEvent, type TextEndEvent, type ToolCallEvent, type ToolResultEvent, type DataEvent, type ErrorEvent, type FinishEvent, type DataStreamWriterConfig, createDataStreamWriter, type DataStreamResponseConfig, DataStreamResponse, createDataStreamResponse, pipeAsyncIterableToDataStream, createSSEHeaders, createNDJSONHeaders, } from "./streaming/index.js";
-export { WebSocketConnectionManager, WebSocketMessageRouter, createAgentWebSocketHandler, } from "./websocket/index.js";
-export { ServerAdapterError, ConfigurationError, RouteConflictError, RouteNotFoundError, ValidationError as ServerValidationError, AuthenticationError, InvalidAuthenticationError, AuthorizationError, RateLimitError as ServerRateLimitError, TimeoutError, HandlerError, StreamingError, StreamAbortedError, WebSocketError, WebSocketConnectionError, ServerStartError, ServerStopError, AlreadyRunningError, NotRunningError, MissingDependencyError, ErrorRecoveryStrategies, wrapError, } from "./errors.js";
+export { createAgentWebSocketHandler, WebSocketConnectionManager, WebSocketMessageRouter, } from "./websocket/index.js";

package/dist/server/index.js

@@ -26,79 +26,83 @@
 // Abstract Base Class
 // ============================================
 export { BaseServerAdapter } from "./abstract/baseServerAdapter.js";
+export { ExpressServerAdapter } from "./adapters/expressAdapter.js";
+export { FastifyServerAdapter } from "./adapters/fastifyAdapter.js";
 // ============================================
 // Framework Adapters
 // ============================================
 export { HonoServerAdapter } from "./adapters/honoAdapter.js";
-export { ExpressServerAdapter } from "./adapters/expressAdapter.js";
-export { FastifyServerAdapter } from "./adapters/fastifyAdapter.js";
 export { KoaServerAdapter } from "./adapters/koaAdapter.js";
 // ============================================
-// Factory
+// Errors
 // ============================================
-export { createServer, ServerAdapterFactory, } from "./factory/serverAdapterFactory.js";
+export { AlreadyRunningError, 
+// Authentication/Authorization errors
+AuthenticationError, AuthorizationError, 
+// Configuration errors
+ConfigurationError, 
+// Error recovery
+ErrorRecoveryStrategies, 
+// Handler errors
+HandlerError, InvalidAuthenticationError, 
+// Dependency errors
+MissingDependencyError, NotRunningError, 
+// Rate limit errors
+RateLimitError as ServerRateLimitError, RouteConflictError, RouteNotFoundError, 
+// Base error class
+ServerAdapterError, 
+// Server lifecycle errors
+ServerStartError, ServerStopError, StreamAbortedError, 
+// Streaming errors
+StreamingError, 
+// Timeout errors
+TimeoutError, 
+// Validation errors
+ValidationError as ServerValidationError, WebSocketConnectionError, 
+// WebSocket errors
+WebSocketError, 
+// Utilities
+wrapError, } from "./errors.js";
 // ============================================
-// Routes
+// Factory
 // ============================================
-export { createAgentRoutes, createAllRoutes, createHealthRoutes, createMCPRoutes, createMemoryRoutes, createOpenApiRoutes, createToolRoutes, registerAllRoutes, } from "./routes/index.js";
+export { createServer, ServerAdapterFactory, } from "./factory/serverAdapterFactory.js";
+export { createAbortSignalMiddleware, createExpressAbortMiddleware, } from "./middleware/abortSignal.js";
 // ============================================
 // Middleware
 // ============================================
 export { createAuthMiddleware, createRoleMiddleware, } from "./middleware/auth.js";
+export { createCacheInvalidator, createCacheMiddleware, InMemoryCacheStore, } from "./middleware/cache.js";
+export { createCompressionMiddleware, createErrorHandlingMiddleware, createLoggingMiddleware, createRequestIdMiddleware, createSecurityHeadersMiddleware, createTimingMiddleware, } from "./middleware/common.js";
+export { createDeprecationMiddleware, } from "./middleware/deprecation.js";
+export { createMCPBodyAttachmentMiddleware, fastifyMCPBodyHook, } from "./middleware/mcpBodyAttachment.js";
 export { createRateLimitMiddleware, createSlidingWindowRateLimitMiddleware, InMemoryRateLimitStore, RateLimitError, } from "./middleware/rateLimit.js";
-export { createCacheMiddleware, createCacheInvalidator, InMemoryCacheStore, } from "./middleware/cache.js";
-export { createRequestValidationMiddleware, createFieldValidator, ValidationError, } from "./middleware/validation.js";
-export { createTimingMiddleware, createRequestIdMiddleware, createErrorHandlingMiddleware, createSecurityHeadersMiddleware, createLoggingMiddleware, createCompressionMiddleware, } from "./middleware/common.js";
-// Export error constants
-export { ErrorCategory, ErrorSeverity, ServerAdapterErrorCode, } from "./types.js";
-export { AgentExecuteRequestSchema, createErrorResponse, ServerNameParamSchema, SessionIdParamSchema, ToolArgumentsSchema, ToolExecuteRequestSchema, ToolNameParamSchema, ToolSearchQuerySchema, validateParams, validateQuery, validateRequest, } from "./utils/validation.js";
+export { CommonSchemas, createFieldValidator, createRequestValidationMiddleware, ValidationError, } from "./middleware/validation.js";
 // ============================================
 // OpenAPI
 // ============================================
-export { 
-// Generator
-OpenAPIGenerator, createOpenAPIGenerator, generateOpenAPISpec, generateOpenAPIFromConfig, 
-// Schemas
-ErrorResponseSchema, TokenUsageSchema, AgentInputSchema, AgentExecuteRequestSchema as OpenAPIAgentExecuteRequestSchema, AgentExecuteResponseSchema, ToolCallSchema, ProviderInfoSchema, ToolParameterSchema, ToolDefinitionSchema, ToolListResponseSchema, ToolExecuteRequestSchema as OpenAPIToolExecuteRequestSchema, ToolExecuteResponseSchema, MCPServerToolSchema, MCPServerStatusSchema, MCPServersListResponseSchema, ConversationMessageSchema, SessionSchema, SessionsListResponseSchema, HealthResponseSchema, ReadyResponseSchema, MetricsResponseSchema, OpenAPISchemas, 
+export { AgentExecuteRequestSchema as OpenAPIAgentExecuteRequestSchema, AgentExecuteResponseSchema, AgentInputSchema, ApiKeySecurityScheme, BasicSecurityScheme, BearerSecurityScheme, CommonParameters, ConversationMessageSchema, createApiInfo, createDeleteOperation, createErrorResponse as createOpenAPIErrorResponse, createGetOperation, createHeaderParameter, createOpenAPIGenerator, createPathParameter, createPostOperation, createQueryParameter, createServer as createOpenAPIServer, createStreamingPostOperation, createStreamingResponse, 
 // Templates
-createSuccessResponse, createErrorResponse as createOpenAPIErrorResponse, createStreamingResponse, StandardErrorResponses, createPathParameter, createQueryParameter, createHeaderParameter, CommonParameters, createGetOperation, createPostOperation, createStreamingPostOperation, createDeleteOperation, BearerSecurityScheme, ApiKeySecurityScheme, BasicSecurityScheme, StandardTags, createServer as createOpenAPIServer, DefaultServers, createApiInfo, NeuroLinkApiInfo, } from "./openapi/index.js";
+createSuccessResponse, DefaultServers, 
+// Schemas
+ErrorResponseSchema, generateOpenAPIFromConfig, generateOpenAPISpec, HealthResponseSchema, MCPServerStatusSchema, MCPServersListResponseSchema, MCPServerToolSchema, MetricsResponseSchema, NeuroLinkApiInfo, 
+// Generator
+OpenAPIGenerator, OpenAPISchemas, ProviderInfoSchema, ReadyResponseSchema, SessionSchema, SessionsListResponseSchema, StandardErrorResponses, StandardTags, TokenUsageSchema, ToolCallSchema, ToolDefinitionSchema, ToolExecuteRequestSchema as OpenAPIToolExecuteRequestSchema, ToolExecuteResponseSchema, ToolListResponseSchema, ToolParameterSchema, } from "./openapi/index.js";
+// ============================================
+// Routes
+// ============================================
+export { createAgentRoutes, createAllRoutes, createHealthRoutes, createMCPRoutes, createMemoryRoutes, createOpenApiRoutes, createToolRoutes, registerAllRoutes, } from "./routes/index.js";
 // ============================================
 // Streaming
 // ============================================
-export { createDataStreamWriter, DataStreamResponse, createDataStreamResponse, 
+export { BaseDataStreamWriter, createDataStreamResponse, createDataStreamWriter, createNDJSONHeaders, createSSEHeaders, DataStreamResponse, formatSSEEvent, 
 // Helpers
-pipeAsyncIterableToDataStream, createSSEHeaders, createNDJSONHeaders, } from "./streaming/index.js";
+pipeAsyncIterableToDataStream, WebStreamWriter, } from "./streaming/index.js";
+// Export error constants
+export { ErrorCategory, ErrorSeverity, ServerAdapterErrorCode, } from "./types.js";
+export { createStreamRedactor, redactStreamChunk } from "./utils/redaction.js";
+export { AgentExecuteRequestSchema, createErrorResponse, ServerNameParamSchema, SessionIdParamSchema, ToolArgumentsSchema, ToolExecuteRequestSchema, ToolNameParamSchema, ToolSearchQuerySchema, validateParams, validateQuery, validateRequest, } from "./utils/validation.js";
 // ============================================
 // WebSocket
 // ============================================
-export { WebSocketConnectionManager, WebSocketMessageRouter, createAgentWebSocketHandler, } from "./websocket/index.js";
-// ============================================
-// Errors
-// ============================================
-export { 
-// Base error class
-ServerAdapterError, 
-// Configuration errors
-ConfigurationError, RouteConflictError, RouteNotFoundError, 
-// Validation errors
-ValidationError as ServerValidationError, 
-// Authentication/Authorization errors
-AuthenticationError, InvalidAuthenticationError, AuthorizationError, 
-// Rate limit errors
-RateLimitError as ServerRateLimitError, 
-// Timeout errors
-TimeoutError, 
-// Handler errors
-HandlerError, 
-// Streaming errors
-StreamingError, StreamAbortedError, 
-// WebSocket errors
-WebSocketError, WebSocketConnectionError, 
-// Server lifecycle errors
-ServerStartError, ServerStopError, AlreadyRunningError, NotRunningError, 
-// Dependency errors
-MissingDependencyError, 
-// Error recovery
-ErrorRecoveryStrategies, 
-// Utilities
-wrapError, } from "./errors.js";
+export { createAgentWebSocketHandler, WebSocketConnectionManager, WebSocketMessageRouter, } from "./websocket/index.js";

package/dist/server/utils/validation.d.ts

@@ -38,12 +38,12 @@ export declare const AgentExecuteRequestSchema: z.ZodObject<{
     provider?: string | undefined;
     model?: string | undefined;
     userId?: string | undefined;
-    tools?: string[] | undefined;
+    stream?: boolean | undefined;
     sessionId?: string | undefined;
     temperature?: number | undefined;
     maxTokens?: number | undefined;
-    stream?: boolean | undefined;
     systemPrompt?: string | undefined;
+    tools?: string[] | undefined;
 }, {
     input: string | {
         text: string;
@@ -53,12 +53,12 @@ export declare const AgentExecuteRequestSchema: z.ZodObject<{
     provider?: string | undefined;
     model?: string | undefined;
     userId?: string | undefined;
-    tools?: string[] | undefined;
+    stream?: boolean | undefined;
     sessionId?: string | undefined;
     temperature?: number | undefined;
     maxTokens?: number | undefined;
-    stream?: boolean | undefined;
     systemPrompt?: string | undefined;
+    tools?: string[] | undefined;
 }>;
 /**
  * Tool execute request schema
@@ -148,12 +148,12 @@ export declare const SessionsListQuerySchema: z.ZodObject<{
     offset: z.ZodOptional<z.ZodPipeline<z.ZodEffects<z.ZodString, number, string>, z.ZodNumber>>;
 }, "strip", z.ZodTypeAny, {
     userId?: string | undefined;
-    limit?: number | undefined;
     offset?: number | undefined;
+    limit?: number | undefined;
 }, {
     userId?: string | undefined;
-    limit?: string | undefined;
     offset?: string | undefined;
+    limit?: string | undefined;
 }>;
 /**
  * Session messages query schema (for pagination)
@@ -162,11 +162,11 @@ export declare const SessionMessagesQuerySchema: z.ZodObject<{
     limit: z.ZodOptional<z.ZodPipeline<z.ZodEffects<z.ZodString, number, string>, z.ZodNumber>>;
     offset: z.ZodOptional<z.ZodPipeline<z.ZodEffects<z.ZodString, number, string>, z.ZodNumber>>;
 }, "strip", z.ZodTypeAny, {
-    limit?: number | undefined;
     offset?: number | undefined;
+    limit?: number | undefined;
 }, {
-    limit?: string | undefined;
     offset?: string | undefined;
+    limit?: string | undefined;
 }>;
 /**
  * Standardized error response format

package/dist/types/common.d.ts

@@ -110,7 +110,6 @@ export type NeuroLinkEvents = {
     "externalMCP:serverRemoved": unknown;
     "tools-register:start": unknown;
     "tools-register:end": unknown;
-    "conversation:titleGenerated": unknown;
     connected: unknown;
     message: unknown;
     error: unknown;

package/dist/types/fileTypes.d.ts

@@ -4,7 +4,7 @@
 /**
  * Supported file types for multimodal input
  */
-export type FileType = "csv" | "image" | "pdf" | "audio" | "text" | "docx" | "pptx" | "xlsx" | "unknown";
+export type FileType = "csv" | "image" | "pdf" | "audio" | "text" | "svg" | "docx" | "pptx" | "xlsx" | "unknown";
 /**
  * Office document types
  */

package/dist/types/generateTypes.d.ts

@@ -1,15 +1,16 @@
-import type { Tool, Schema } from "ai";
-import type { ValidationSchema, StandardRecord, ZodUnknownSchema } from "./typeAliases.js";
-import { AIProviderName } from "../constants/enums.js";
+import type { Schema, Tool } from "ai";
+import type { AIProviderName } from "../constants/enums.js";
+import type { RAGConfig } from "../rag/types.js";
 import type { AnalyticsData, TokenUsage } from "./analytics.js";
-import type { EvaluationData } from "./evaluation.js";
-import type { ChatMessage, ConversationMemoryConfig } from "./conversation.js";
-import type { MiddlewareFactoryOptions } from "./middlewareTypes.js";
 import type { JsonValue } from "./common.js";
 import type { Content, ImageWithAltText } from "./content.js";
+import type { ChatMessage, ConversationMemoryConfig } from "./conversation.js";
+import type { EvaluationData } from "./evaluation.js";
+import type { MiddlewareFactoryOptions } from "./middlewareTypes.js";
+import type { VideoGenerationResult, VideoOutputOptions } from "./multimodal.js";
+import type { PPTGenerationResult, PPTOutputOptions } from "./pptTypes.js";
 import type { TTSOptions, TTSResult } from "./ttsTypes.js";
-import type { PPTOutputOptions, PPTGenerationResult } from "./pptTypes.js";
-import type { VideoOutputOptions, VideoGenerationResult } from "./multimodal.js";
+import type { StandardRecord, ValidationSchema, ZodUnknownSchema } from "./typeAliases.js";
 /**
  * Generate function options type - Primary method for content generation
  * Supports multimodal content while maintaining backward compatibility
@@ -257,6 +258,39 @@ export type GenerateOptions = {
         enableProgress?: boolean;
         fallbackToGenerate?: boolean;
     };
+    /**
+     * RAG (Retrieval-Augmented Generation) configuration.
+     *
+     * When provided, NeuroLink automatically loads the specified files, chunks them,
+     * generates embeddings, and creates a search tool that the AI model can invoke
+     * on demand to find relevant context before answering.
+     *
+     * @example Basic RAG
+     * ```typescript
+     * const result = await neurolink.generate({
+     *   input: { text: "What is RAG?" },
+     *   provider: "vertex",
+     *   rag: {
+     *     files: ["./docs/guide.md"],
+     *   }
+     * });
+     * ```
+     *
+     * @example Advanced RAG with options
+     * ```typescript
+     * const result = await neurolink.generate({
+     *   input: { text: "Explain chunking strategies" },
+     *   provider: "vertex",
+     *   rag: {
+     *     files: ["./docs/guide.md", "./docs/api.md"],
+     *     strategy: "markdown",
+     *     chunkSize: 512,
+     *     topK: 5,
+     *   }
+     * });
+     * ```
+     */
+    rag?: RAGConfig;
 };
 /**
  * Generate function result type - Primary output format

package/dist/types/generateTypes.js

@@ -1 +1 @@
-import { AIProviderName } from "../constants/enums.js";
+export {};

package/dist/types/index.d.ts

@@ -1,34 +1,35 @@
 /**
  * Centralized type exports for NeuroLink
  */
-export * from "./common.js";
 export { AIProviderName } from "../constants/enums.js";
-export type { ZodUnknownSchema, ValidationSchema, OptionalValidationSchema, StandardRecord, OptionalStandardRecord, } from "./typeAliases.js";
-export * from "./tools.js";
-export * from "./providers.js";
 export * from "./cli.js";
+export * from "./common.js";
+export type { AnalyticsConfig, BackupInfo, BackupMetadata, CacheConfig, ConfigUpdateOptions, ConfigValidationResult, FallbackConfig, NeuroLinkConfig, PerformanceConfig, RetryConfig, ToolConfig, } from "./configTypes.js";
+export type { ExternalMCPConfigValidation, ExternalMCPManagerConfig, ExternalMCPOperationResult, ExternalMCPServerEvents, ExternalMCPServerHealth, ExternalMCPServerInstance, ExternalMCPServerStatus, ExternalMCPToolContext, ExternalMCPToolInfo, ExternalMCPToolResult, } from "./externalMcp.js";
+export type { AuthorizationUrlResult, CircuitBreakerConfig, CircuitBreakerEvents, CircuitBreakerState, CircuitBreakerStats, DiscoveredMcp, ExternalToolExecutionOptions, FlexibleValidationResult, HTTPRetryConfig, MCPClientResult, MCPConnectedServer, MCPDiscoveredServer, MCPExecutableTool, MCPOAuthConfig, MCPServerCategory, MCPServerConfig, MCPServerConnectionStatus, MCPServerMetadata, MCPServerRegistryEntry, MCPServerStatus, MCPToolInfo, MCPToolMetadata, MCPTransportType, McpMetadata, McpRegistry, NeuroLinkExecutionContext, NeuroLinkMCPServer, NeuroLinkMCPTool, OAuthClientInformation, OAuthTokens, RateLimitConfig, TokenBucketRateLimitConfig, TokenExchangeRequest, TokenStorage, ToolDiscoveryResult, ToolRegistryEvents, ToolValidationResult, } from "./mcpTypes.js";
+export type { ModelCapability, ModelFilter, ModelPricing, ModelResolutionContext, ModelStats, ModelUseCase, } from "./providers.js";
+export * from "./providers.js";
 export * from "./taskClassificationTypes.js";
-export type { NeuroLinkConfig, PerformanceConfig, CacheConfig, FallbackConfig, RetryConfig, AnalyticsConfig, ToolConfig, BackupInfo, BackupMetadata, ConfigValidationResult, ConfigUpdateOptions, } from "./configTypes.js";
-export type { MCPTransportType, MCPServerConnectionStatus, MCPServerCategory, MCPServerStatus, MCPDiscoveredServer, MCPConnectedServer, MCPToolInfo, MCPExecutableTool, MCPServerMetadata, MCPToolMetadata, MCPServerRegistryEntry, NeuroLinkMCPTool, NeuroLinkMCPServer, NeuroLinkExecutionContext, MCPServerConfig, DiscoveredMcp, McpMetadata, ToolDiscoveryResult, ExternalToolExecutionOptions, ToolValidationResult, ToolRegistryEvents, CircuitBreakerState, CircuitBreakerConfig, CircuitBreakerStats, CircuitBreakerEvents, McpRegistry, MCPClientResult, FlexibleValidationResult, OAuthTokens, TokenStorage, MCPOAuthConfig, OAuthClientInformation, AuthorizationUrlResult, TokenExchangeRequest, TokenBucketRateLimitConfig, RateLimitConfig, HTTPRetryConfig, } from "./mcpTypes.js";
-export type { ExternalMCPServerInstance, ExternalMCPServerStatus, ExternalMCPToolInfo, ExternalMCPServerHealth, ExternalMCPConfigValidation, ExternalMCPOperationResult, ExternalMCPToolContext, ExternalMCPToolResult, ExternalMCPServerEvents, ExternalMCPManagerConfig, } from "./externalMcp.js";
-export type { ModelCapability, ModelUseCase, ModelFilter, ModelResolutionContext, ModelStats, ModelPricing, } from "./providers.js";
-export type { DomainType, DomainConfig, DomainTemplate, DomainConfigOptions, DomainEvaluationCriteria, DomainValidationRule, } from "./domainTypes.js";
-export type { GenerateOptions, GenerateResult as GenerateApiResult, // Renamed to avoid conflict with cli.js GenerateResult
-UnifiedGenerationOptions, EnhancedProvider, FactoryEnhancedProvider, TextGenerationOptions, TextGenerationResult, EnhancedGenerateResult, } from "./generateTypes.js";
-export type { StreamingProgressData, StreamingMetadata, ProgressCallback, ToolCall as StreamToolCall, // Renamed to avoid conflict with tools.js ToolCall
-ToolResult as StreamToolResult, // Renamed to avoid conflict with tools.js ToolResult
-ToolCallResults, ToolCalls, StreamOptions, StreamingOptions, StreamResult, EnhancedStreamProvider, } from "./streamTypes.js";
-export type { TokenUsage, ErrorInfo as AnalyticsErrorInfo, // Renamed to avoid conflict with common.js ErrorInfo
-AnalyticsData, StreamAnalyticsData, PerformanceMetrics, } from "./analytics.js";
+export * from "./tools.js";
+export type { OptionalStandardRecord, OptionalValidationSchema, StandardRecord, ValidationSchema, ZodUnknownSchema, } from "./typeAliases.js";
+export type { BatchProcessingSummary, ExcelWorksheet, FailedFileInfo, FileInfo, FileProcessingError, FileProcessingResult as ProcessorFileResult, FileProcessorConfig, FileWarning, JsonTypeGuard, OperationResult, ProcessedConfig, ProcessedExcel, ProcessedFileBase, ProcessedFileInfo, ProcessedHtml, ProcessedJson, ProcessedMarkdown, ProcessedOpenDocument, ProcessedRtf, ProcessedSourceCode, ProcessedSvg, ProcessedText, ProcessedWord, ProcessedYaml, ProcessOptions, ProcessorInfo, ProcessorMatch, ProcessorPriorityKey, ProcessorPriorityValue, RegistryOptions, RegistryProcessResult, RetryConfig as ProcessorRetryConfig, SkippedFileInfo, UnsupportedFileError, } from "../processors/base/types.js";
+export { PROCESSOR_PRIORITIES } from "../processors/base/types.js";
+export type { ActionAWSConfig, ActionCommentResult, ActionEvaluation, ActionExecutionResult, ActionGoogleCloudConfig, ActionInputs, ActionInputValidation, ActionMultimodalInputs, ActionOutput, ActionProviderKeys, ActionThinkingConfig, ActionTokenUsage, CliAnalytics, CliEvaluation, CliResponse, CliTokenUsage, ProviderKeyMapping, } from "./actionTypes.js";
+export type { AnalyticsData, ErrorInfo as AnalyticsErrorInfo, // Renamed to avoid conflict with common.js ErrorInfo
+PerformanceMetrics, StreamAnalyticsData, TokenUsage, } from "./analytics.js";
+export * from "./content.js";
+export type { DomainConfig, DomainConfigOptions, DomainEvaluationCriteria, DomainTemplate, DomainType, DomainValidationRule, } from "./domainTypes.js";
 export * from "./evaluation.js";
-export * from "./modelTypes.js";
-export * from "./serviceTypes.js";
 export * from "./evaluationProviders.js";
-export * from "./sdkTypes.js";
-export * from "./utilities.js";
-export * from "./middlewareTypes.js";
 export * from "./fileTypes.js";
-export * from "./content.js";
-export * from "./ttsTypes.js";
+export type { EnhancedGenerateResult, EnhancedProvider, FactoryEnhancedProvider, GenerateOptions, GenerateResult as GenerateApiResult, // Renamed to avoid conflict with cli.js GenerateResult
+TextGenerationOptions, TextGenerationResult, UnifiedGenerationOptions, } from "./generateTypes.js";
 export * from "./hitlTypes.js";
-export type { ActionInputs, ActionProviderKeys, ActionAWSConfig, ActionGoogleCloudConfig, ActionThinkingConfig, ActionMultimodalInputs, ActionExecutionResult, ActionCommentResult, ActionOutput, ActionTokenUsage, ActionEvaluation, ActionInputValidation, ProviderKeyMapping, CliResponse, CliTokenUsage, CliAnalytics, CliEvaluation, } from "./actionTypes.js";
+export * from "./middlewareTypes.js";
+export * from "./modelTypes.js";
+export * from "./sdkTypes.js";
+export * from "./serviceTypes.js";
+export type { EnhancedStreamProvider, ProgressCallback, StreamingMetadata, StreamingOptions, StreamingProgressData, StreamOptions, StreamResult, ToolCall as StreamToolCall, // Renamed to avoid conflict with tools.js ToolCall
+ToolCallResults, ToolCalls, ToolResult as StreamToolResult, } from "./streamTypes.js";
+export * from "./ttsTypes.js";
+export * from "./utilities.js";

package/dist/types/index.js

@@ -1,39 +1,40 @@
 /**
  * Centralized type exports for NeuroLink
  */
-// Common utility types
-export * from "./common.js";
 // Constants and enums
 export { AIProviderName } from "../constants/enums.js";
-// Tool system types
-export * from "./tools.js";
-// Provider types
-export * from "./providers.js";
 // CLI types
 export * from "./cli.js";
+// Common utility types
+export * from "./common.js";
+// Provider types
+export * from "./providers.js";
 // Task classification types
 export * from "./taskClassificationTypes.js";
+// Tool system types
+export * from "./tools.js";
+export { PROCESSOR_PRIORITIES } from "../processors/base/types.js";
+// Content types for multimodal support (includes multimodal re-exports for backward compatibility)
+export * from "./content.js";
 // Evaluation types - NEW
 export * from "./evaluation.js";
-// Model types - NEW
-export * from "./modelTypes.js";
-// Service types - NEW
-export * from "./serviceTypes.js";
 // Evaluation provider types - NEW
 export * from "./evaluationProviders.js";
+// File detection and processing types
+export * from "./fileTypes.js";
+// HITL (Human-in-the-Loop) types
+export * from "./hitlTypes.js";
+// Middleware Types - Middleware system types
+export * from "./middlewareTypes.js";
+// Model types - NEW
+export * from "./modelTypes.js";
 // SDK Types - Core types for external developers
 // Note: sdkTypes.ts uses selective re-exports internally, so we use wildcard here
 // The conflicts were from generateTypes and analytics which are now handled above
 export * from "./sdkTypes.js";
-// Utilities Types - Utility module types (selective export to avoid conflicts)
-export * from "./utilities.js";
-// Middleware Types - Middleware system types
-export * from "./middlewareTypes.js";
-// File detection and processing types
-export * from "./fileTypes.js";
-// Content types for multimodal support (includes multimodal re-exports for backward compatibility)
-export * from "./content.js";
+// Service types - NEW
+export * from "./serviceTypes.js";
 // TTS (Text-to-Speech) types
 export * from "./ttsTypes.js";
-// HITL (Human-in-the-Loop) types
-export * from "./hitlTypes.js";
+// Utilities Types - Utility module types (selective export to avoid conflicts)
+export * from "./utilities.js";

package/dist/types/modelTypes.d.ts

@@ -88,8 +88,8 @@ export declare const ModelConfigSchema: z.ZodObject<{
     contextWindow: z.ZodNumber;
     releaseDate: z.ZodString;
 }, "strip", z.ZodTypeAny, {
-    capabilities: string[];
     id: string;
+    capabilities: string[];
     displayName: string;
     deprecated: boolean;
     pricing: {
@@ -99,8 +99,8 @@ export declare const ModelConfigSchema: z.ZodObject<{
     contextWindow: number;
     releaseDate: string;
 }, {
-    capabilities: string[];
     id: string;
+    capabilities: string[];
     displayName: string;
     deprecated: boolean;
     pricing: {
@@ -134,8 +134,8 @@ export declare const ModelRegistrySchema: z.ZodObject<{
         contextWindow: z.ZodNumber;
         releaseDate: z.ZodString;
     }, "strip", z.ZodTypeAny, {
-        capabilities: string[];
         id: string;
+        capabilities: string[];
         displayName: string;
         deprecated: boolean;
         pricing: {
@@ -145,8 +145,8 @@ export declare const ModelRegistrySchema: z.ZodObject<{
         contextWindow: number;
         releaseDate: string;
     }, {
-        capabilities: string[];
         id: string;
+        capabilities: string[];
         displayName: string;
         deprecated: boolean;
         pricing: {
@@ -159,11 +159,9 @@ export declare const ModelRegistrySchema: z.ZodObject<{
     aliases: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
     defaults: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
 }, "strip", z.ZodTypeAny, {
-    version: string;
-    lastUpdated: string;
     models: Record<string, Record<string, {
-        capabilities: string[];
         id: string;
+        capabilities: string[];
         displayName: string;
         deprecated: boolean;
         pricing: {
@@ -173,14 +171,14 @@ export declare const ModelRegistrySchema: z.ZodObject<{
         contextWindow: number;
         releaseDate: string;
     }>>;
+    version: string;
+    lastUpdated: string;
     aliases?: Record<string, string> | undefined;
     defaults?: Record<string, string> | undefined;
 }, {
-    version: string;
-    lastUpdated: string;
     models: Record<string, Record<string, {
-        capabilities: string[];
         id: string;
+        capabilities: string[];
         displayName: string;
         deprecated: boolean;
         pricing: {
@@ -190,6 +188,8 @@ export declare const ModelRegistrySchema: z.ZodObject<{
         contextWindow: number;
         releaseDate: string;
     }>>;
+    version: string;
+    lastUpdated: string;
     aliases?: Record<string, string> | undefined;
     defaults?: Record<string, string> | undefined;
 }>;

package/dist/types/pptTypes.d.ts

@@ -10,10 +10,10 @@
  * - CompleteSlide / PPTGenerationContext: Generation context types
  * - PPTError: Error handling (follows VideoError pattern)
  */
-import type { ImageWithAltText } from "./content.js";
+import type { NeuroLink } from "../neurolink.js";
 import { NeuroLinkError } from "../utils/errorHandling.js";
+import type { ImageWithAltText } from "./content.js";
 import type { AIProvider } from "./providers.js";
-import type { NeuroLink } from "../neurolink.js";
 export type ThemeOption = "modern" | "corporate" | "creative" | "minimal" | "dark";
 export type AudienceOption = "business" | "students" | "technical" | "general";
 export type ToneOption = "professional" | "casual" | "educational" | "persuasive";
@@ -681,11 +681,23 @@ export type CompleteSlide = {
     };
     generationTime: number;
 };
+/** Minimum number of slides allowed */
+export declare const MIN_SLIDES = 5;
+/** Maximum number of slides allowed */
+export declare const MAX_SLIDES = 50;
 /** Slide dimensions in inches by aspect ratio */
 export declare const SLIDE_DIMENSIONS: Record<AspectRatioOption, {
     width: number;
     height: number;
 }>;
+/**
+ * Validate a hex color string (6 hex characters, no # prefix).
+ */
+export declare function isValidHexColor(color: string): boolean;
+/**
+ * Normalize a hex color by stripping leading # if present.
+ */
+export declare function normalizeHexColor(color: string): string;
 /**
  * Text properties for addText method
  * Represents individual text items with formatting options

package/dist/types/pptTypes.js

@@ -59,8 +59,24 @@ export class PPTError extends NeuroLinkError {
 // ============================================================================
 // VALIDATION CONSTANTS
 // ============================================================================
+/** Minimum number of slides allowed */
+export const MIN_SLIDES = 5;
+/** Maximum number of slides allowed */
+export const MAX_SLIDES = 50;
 /** Slide dimensions in inches by aspect ratio */
 export const SLIDE_DIMENSIONS = {
     "16:9": { width: 10, height: 5.625 },
     "4:3": { width: 10, height: 7.5 },
 };
+/**
+ * Validate a hex color string (6 hex characters, no # prefix).
+ */
+export function isValidHexColor(color) {
+    return /^[0-9A-Fa-f]{6}$/.test(color);
+}
+/**
+ * Normalize a hex color by stripping leading # if present.
+ */
+export function normalizeHexColor(color) {
+    return color.startsWith("#") ? color.slice(1) : color;
+}