@juspay/neurolink 8.3.0 → 8.4.1

package/dist/core/baseProvider.d.ts

@@ -1,5 +1,5 @@
 import type { ValidationSchema } from "../types/typeAliases.js";
-import type { Tool, LanguageModelV1 } from "ai";
+import type { Tool, LanguageModelV1, CoreMessage } from "ai";
 import type { AIProvider, TextGenerationOptions, TextGenerationResult, EnhancedGenerateResult, AnalyticsData } from "../types/index.js";
 import { AIProviderName } from "../constants/enums.js";
 import type { EvaluationData } from "../index.js";
@@ -23,6 +23,12 @@ export declare abstract class BaseProvider implements AIProvider {
     protected sessionId?: string;
     protected userId?: string;
     protected neurolink?: NeuroLink;
+    private readonly messageBuilder;
+    private readonly streamHandler;
+    private readonly generationHandler;
+    private readonly telemetryHandler;
+    private readonly utilities;
+    private readonly toolsManager;
     constructor(modelName?: string, providerName?: AIProviderName, neurolink?: NeuroLink, middleware?: MiddlewareFactoryOptions);
     /**
      * Check if this provider supports tool/function calling
@@ -40,32 +46,40 @@ export declare abstract class BaseProvider implements AIProvider {
      */
     private prepareGenerationContext;
     /**
-     * Build messages array for generation
+     * Build messages array for generation - delegated to MessageBuilder
      */
     private buildMessages;
     /**
-     * Execute the generation with AI SDK
+     * Build messages array for streaming operations - delegated to MessageBuilder
+     * This is a protected helper method that providers can use to build messages
+     * with automatic multimodal detection, eliminating code duplication
+     *
+     * @param options - Stream options or text generation options
+     * @returns Promise resolving to CoreMessage array ready for AI SDK
+     */
+    protected buildMessagesForStream(options: StreamOptions | TextGenerationOptions): Promise<CoreMessage[]>;
+    /**
+     * Execute the generation with AI SDK - delegated to GenerationHandler
      */
     private executeGeneration;
     /**
-     * Log generation completion information
+     * Log generation completion information - delegated to GenerationHandler
      */
     private logGenerationComplete;
     /**
-     * Record performance metrics
+     * Record performance metrics - delegated to TelemetryHandler
      */
     private recordPerformanceMetrics;
     /**
-     * Extract tool information from generation result
+     * Extract tool information from generation result - delegated to GenerationHandler
      */
     private extractToolInformation;
     /**
-     * Format the enhanced result
+     * Format the enhanced result - delegated to GenerationHandler
      */
     private formatEnhancedResult;
     /**
-     * Analyze AI response structure and log detailed debugging information
-     * Extracted from generate method to reduce complexity
+     * Analyze AI response structure and log detailed debugging information - delegated to GenerationHandler
      */
     private analyzeAIResponse;
     /**
@@ -109,63 +123,35 @@ export declare abstract class BaseProvider implements AIProvider {
      */
     protected getAISDKModelWithMiddleware(options?: TextGenerationOptions | StreamOptions): Promise<LanguageModelV1>;
     /**
-     * Extract middleware options from generation options. This is the single
-     * source of truth for deciding if middleware should be applied.
+     * Extract middleware options - delegated to Utilities
      */
     private extractMiddlewareOptions;
     /**
-     * Check if a schema is a Zod schema
+     * Check if a schema is a Zod schema - delegated to Utilities
      */
     private isZodSchema;
     /**
-     * Convert tool execution result from MCP format to standard format
-     * Handles tool failures gracefully to prevent stream termination
+     * Convert tool execution result - delegated to Utilities
      */
     private convertToolResult;
     /**
-     * Create a custom tool from tool definition
-     */
-    private createCustomToolFromDefinition;
-    /**
-     * Process direct tools with event emission wrapping
-     */
-    private processDirectTools;
-    /**
-     * Process custom tools from setupToolExecutor
-     */
-    private processCustomTools;
-    /**
-     * Recursively fix JSON Schema for OpenAI strict mode compatibility
-     * OpenAI requires additionalProperties: false at ALL levels and preserves required array
+     * Fix JSON Schema for OpenAI strict mode - delegated to Utilities
      */
     private fixSchemaForOpenAIStrictMode;
     /**
-     * Create an external MCP tool
-     */
-    private createExternalMCPTool;
-    /**
-     * Process external MCP tools
-     */
-    private processExternalMCPTools;
-    /**
-     * Process MCP tools integration
-     */
-    private processMCPTools;
-    /**
-     * Get all available tools - direct tools are ALWAYS available
-     * MCP tools are added when available (without blocking)
+     * Get all available tools - delegated to ToolsManager
      */
     protected getAllTools(): Promise<Record<string, Tool>>;
     /**
-     * Calculate actual cost based on token usage and provider configuration
+     * Calculate actual cost - delegated to TelemetryHandler
      */
     private calculateActualCost;
     /**
-     * Create a permissive Zod schema that accepts all parameters as-is
+     * Create a permissive Zod schema - delegated to Utilities
      */
     private createPermissiveZodSchema;
     /**
-     * Set session context for MCP tools
+     * Set session context for MCP tools - delegated to ToolsManager
      */
     setSessionContext(sessionId?: string, userId?: string): void;
     /**
@@ -181,11 +167,11 @@ export declare abstract class BaseProvider implements AIProvider {
         operationType?: string;
     }): Promise<T>;
     /**
-     * Validate stream options - consolidates validation from 7/10 providers
+     * Validate stream options - delegated to StreamHandler
      */
     protected validateStreamOptions(options: StreamOptions): void;
     /**
-     * Create text stream transformation - consolidates identical logic from 7/10 providers
+     * Create text stream transformation - delegated to StreamHandler
      */
     protected createTextStream(result: {
         textStream: AsyncIterable<string>;
@@ -193,22 +179,21 @@ export declare abstract class BaseProvider implements AIProvider {
         content: string;
     }>;
     /**
-     * Create standardized stream result - consolidates result structure
+     * Create standardized stream result - delegated to StreamHandler
      */
     protected createStreamResult(stream: AsyncGenerator<{
         content: string;
     }>, additionalProps?: Partial<StreamResult>): StreamResult;
     /**
-     * Create stream analytics - consolidates analytics from 4/10 providers
+     * Create stream analytics - delegated to StreamHandler
      */
     protected createStreamAnalytics(result: UnknownRecord, startTime: number, options: StreamOptions): Promise<UnknownRecord | undefined>;
     /**
-     * Handle common error patterns - consolidates error handling from multiple providers
+     * Handle common error patterns - delegated to Utilities
      */
     protected handleCommonErrors(error: unknown): Error | null;
     /**
-     * Set up tool executor for a provider to enable actual tool execution
-     * Consolidates identical setupToolExecutor logic from neurolink.ts (used in 4 places)
+     * Set up tool executor - delegated to ToolsManager
      * @param sdk - The NeuroLinkSDK instance for tool execution
      * @param functionTag - Function name for logging
      */
@@ -216,18 +201,36 @@ export declare abstract class BaseProvider implements AIProvider {
         customTools: Map<string, unknown>;
         executeTool: (toolName: string, params: unknown) => Promise<unknown>;
     }, functionTag: string): void;
+    /**
+     * Normalize text generation options - delegated to Utilities
+     */
     protected normalizeTextOptions(optionsOrPrompt: TextGenerationOptions | string): TextGenerationOptions;
+    /**
+     * Normalize stream options - delegated to Utilities
+     */
     protected normalizeStreamOptions(optionsOrPrompt: StreamOptions | string): StreamOptions;
     protected enhanceResult(result: EnhancedGenerateResult, options: TextGenerationOptions, startTime: number): Promise<EnhancedGenerateResult>;
+    /**
+     * Create analytics - delegated to TelemetryHandler
+     */
     protected createAnalytics(result: EnhancedGenerateResult, responseTime: number, options: TextGenerationOptions): Promise<AnalyticsData>;
+    /**
+     * Create evaluation - delegated to TelemetryHandler
+     */
     protected createEvaluation(result: EnhancedGenerateResult, options: TextGenerationOptions): Promise<EvaluationData>;
+    /**
+     * Validate text generation options - delegated to Utilities
+     */
     protected validateOptions(options: TextGenerationOptions): void;
+    /**
+     * Get provider information - delegated to Utilities
+     */
     protected getProviderInfo(): {
         provider: string;
         model: string;
     };
     /**
-     * Get timeout value in milliseconds
+     * Get timeout value in milliseconds - delegated to Utilities
      */
     getTimeout(options: TextGenerationOptions | StreamOptions): number;
     /**