@juspay/neurolink 5.0.0 → 5.2.0

package/dist/lib/core/factory.d.ts

@@ -5,7 +5,7 @@ declare const componentIdentifier = "aiProviderFactory";
  */
 export declare class AIProviderFactory {
     /**
-     * Normalize provider name to match dynamic model registry keys
+     * Normalize provider name using ProviderFactory
      */
     private static normalizeProviderName;
     /**
@@ -15,7 +15,7 @@ export declare class AIProviderFactory {
      * @param enableMCP - Optional flag to enable MCP integration (default: true)
      * @returns AIProvider instance
      */
-    static createProvider(providerName: string, modelName?: string | null, enableMCP?: boolean): Promise<AIProvider>;
+    static createProvider(providerName: string, modelName?: string | null, enableMCP?: boolean, sdk?: any): Promise<AIProvider>;
     /**
      * Create a provider instance with specific provider enum and model
      * @param provider - Provider enum value
@@ -30,7 +30,7 @@ export declare class AIProviderFactory {
      * @param enableMCP - Optional flag to enable MCP integration (default: true)
      * @returns AIProvider instance
      */
-    static createBestProvider(requestedProvider?: string, modelName?: string | null, enableMCP?: boolean): Promise<AIProvider>;
+    static createBestProvider(requestedProvider?: string, modelName?: string | null, enableMCP?: boolean, sdk?: any): Promise<AIProvider>;
     /**
      * Create primary and fallback provider instances
      * @param primaryProvider - Primary provider name

package/dist/lib/core/factory.js

@@ -1,4 +1,6 @@
-import { GoogleVertexAI, AmazonBedrock, OpenAI, AnthropicProvider, AzureOpenAIProvider, GoogleAIStudio, HuggingFace, Ollama, MistralAI, } from "../providers/index.js";
+// ✅ CIRCULAR DEPENDENCY FIX: Remove barrel export import
+// Providers are now managed via ProviderFactory instead of direct imports
+import { ProviderFactory } from "../factories/provider-factory.js";
 import { getBestProvider } from "../utils/providerUtils.js";
 import { logger } from "../utils/logger.js";
 const componentIdentifier = "aiProviderFactory";
@@ -7,45 +9,16 @@ const componentIdentifier = "aiProviderFactory";
  */
 export class AIProviderFactory {
     /**
-     * Normalize provider name to match dynamic model registry keys
+     * Normalize provider name using ProviderFactory
      */
     static normalizeProviderName(providerName) {
-        switch (providerName.toLowerCase()) {
-            case "vertex":
-            case "google":
-            case "gemini":
-                return "google";
-            case "bedrock":
-            case "amazon":
-            case "aws":
-                return "bedrock";
-            case "openai":
-            case "gpt":
-                return "openai";
-            case "anthropic":
-            case "claude":
-                return "anthropic";
-            case "azure":
-            case "azure-openai":
-                return "openai"; // Azure uses OpenAI models
-            case "google-ai":
-            case "google-studio":
-                return "google";
-            case "huggingface":
-            case "hugging-face":
-            case "hf":
-                return "huggingface";
-            case "ollama":
-            case "local":
-            case "local-ollama":
-                return "ollama";
-            case "mistral":
-            case "mistral-ai":
-            case "mistralai":
-                return "mistral";
-            default:
-                return providerName.toLowerCase();
+        // Use ProviderFactory registration - no more legacy switch statements
+        const normalized = ProviderFactory.normalizeProviderName(providerName);
+        if (normalized) {
+            return normalized;
         }
+        // If not found in factory, return as-is (will be handled by factory error handling)
+        return providerName.toLowerCase();
     }
     /**
      * Create a provider instance for the specified provider type
@@ -54,8 +27,9 @@ export class AIProviderFactory {
      * @param enableMCP - Optional flag to enable MCP integration (default: true)
      * @returns AIProvider instance
      */
-    static async createProvider(providerName, modelName, enableMCP = true) {
-        const functionTag = "AIProviderFactory.createProvider";
+    static async createProvider(providerName, modelName, enableMCP = true, sdk) {
+        const functionTag = "AIawait ProviderFactory.createProvider";
+        // Providers are registered via ProviderFactory.initialize() on first use
         logger.debug(`[${functionTag}] Provider creation started`, {
             providerName,
             modelName: modelName || "default",
@@ -114,53 +88,18 @@ export class AIProviderFactory {
             //   }
             // }
             let provider;
-            switch (providerName.toLowerCase()) {
-                case "vertex":
-                case "google":
-                case "gemini":
-                    provider = new GoogleVertexAI(resolvedModelName === "default" ? null : resolvedModelName);
-                    break;
-                case "bedrock":
-                case "amazon":
-                case "aws":
-                    provider = new AmazonBedrock(resolvedModelName === "default" ? null : resolvedModelName);
-                    break;
-                case "openai":
-                case "gpt":
-                    provider = new OpenAI(resolvedModelName === "default" ? null : resolvedModelName);
-                    break;
-                case "anthropic":
-                case "claude":
-                    provider = new AnthropicProvider();
-                    break;
-                case "azure":
-                case "azure-openai":
-                    provider = new AzureOpenAIProvider();
-                    break;
-                case "google-ai":
-                case "google-studio":
-                    provider = new GoogleAIStudio(resolvedModelName === "default" ? null : resolvedModelName);
-                    break;
-                case "huggingface":
-                case "hugging-face":
-                case "hf":
-                    provider = new HuggingFace(resolvedModelName === "default" ? null : resolvedModelName);
-                    break;
-                case "ollama":
-                case "local":
-                case "local-ollama":
-                    provider = new Ollama(resolvedModelName === "default"
-                        ? undefined
-                        : resolvedModelName || undefined);
-                    break;
-                case "mistral":
-                case "mistral-ai":
-                case "mistralai":
-                    provider = new MistralAI(resolvedModelName === "default" ? null : resolvedModelName);
-                    break;
-                default:
-                    throw new Error(`Unknown provider: ${providerName}. Supported providers: vertex, bedrock, openai, anthropic, azure, google-ai, huggingface, ollama, mistral`);
-            }
+            // PURE FACTORY PATTERN: No switch statements - use ProviderFactory exclusively
+            const normalizedName = this.normalizeProviderName(providerName);
+            const finalModelName = resolvedModelName === "default" || resolvedModelName === null
+                ? undefined
+                : resolvedModelName;
+            provider = await ProviderFactory.createProvider(normalizedName, finalModelName, sdk);
+            logger.debug(componentIdentifier, "Pure factory pattern provider created", {
+                providerName: normalizedName,
+                modelName: finalModelName,
+                factoryUsed: true,
+            });
+            // PURE FACTORY PATTERN: All providers handled by ProviderFactory - no switch statements needed
             // Wrap with MCP if enabled
             if (enableMCP) {
                 try {
@@ -182,7 +121,7 @@ export class AIProviderFactory {
             }
             logger.debug(`[${functionTag}] Provider creation succeeded`, {
                 providerName,
-                modelName: modelName || "default",
+                modelName: finalModelName || "default",
                 providerType: provider.constructor.name,
                 mcpEnabled: enableMCP,
             });
@@ -205,7 +144,7 @@ export class AIProviderFactory {
      * @returns AIProvider instance
      */
     static async createProviderWithModel(provider, model) {
-        const functionTag = "AIProviderFactory.createProviderWithModel";
+        const functionTag = "AIawait ProviderFactory.createProviderWithModel";
         logger.debug(`[${functionTag}] Provider model creation started`, {
             provider,
             model,
@@ -236,7 +175,7 @@ export class AIProviderFactory {
      * @param enableMCP - Optional flag to enable MCP integration (default: true)
      * @returns AIProvider instance
      */
-    static async createBestProvider(requestedProvider, modelName, enableMCP = true) {
+    static async createBestProvider(requestedProvider, modelName, enableMCP = true, sdk) {
         const functionTag = "AIProviderFactory.createBestProvider";
         try {
             const bestProvider = await getBestProvider(requestedProvider);
@@ -246,7 +185,7 @@ export class AIProviderFactory {
                 modelName: modelName || "default",
                 enableMCP,
             });
-            return await this.createProvider(bestProvider, modelName, enableMCP);
+            return await this.createProvider(bestProvider, modelName, enableMCP, sdk);
         }
         catch (error) {
             const errorMessage = error instanceof Error ? error.message : String(error);
@@ -266,7 +205,7 @@ export class AIProviderFactory {
      * @returns Object with primary and fallback providers
      */
     static async createProviderWithFallback(primaryProvider, fallbackProvider, modelName, enableMCP = true) {
-        const functionTag = "AIProviderFactory.createProviderWithFallback";
+        const functionTag = "AIawait ProviderFactory.createProviderWithFallback";
         logger.debug(`[${functionTag}] Fallback provider setup started`, {
             primaryProvider,
             fallbackProvider,

package/dist/lib/core/service-registry.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Service Registry for Dependency Injection
+ * Breaks circular dependencies by providing lazy loading and centralized service management
+ */
+export interface ServiceFactory<T = any> {
+    (): T | Promise<T>;
+}
+export interface ServiceRegistration {
+    factory: ServiceFactory;
+    singleton: boolean;
+    instance?: any;
+}
+export declare class ServiceRegistry {
+    private static services;
+    private static initializing;
+    /**
+     * Register a service with optional singleton behavior
+     */
+    static register<T>(name: string, factory: ServiceFactory<T>, options?: {
+        singleton?: boolean;
+    }): void;
+    /**
+     * Get a service instance with circular dependency detection
+     */
+    static get<T>(name: string): Promise<T>;
+    /**
+     * Get a service synchronously (throws if async initialization required)
+     */
+    static getSync<T>(name: string): T;
+    /**
+     * Check if a service is registered
+     */
+    static has(name: string): boolean;
+    /**
+     * Clear all services (useful for testing)
+     */
+    static clear(): void;
+    /**
+     * Get all registered service names
+     */
+    static getRegisteredServices(): string[];
+    /**
+     * Register multiple services at once
+     */
+    static registerBatch(services: Record<string, ServiceFactory>): void;
+}
+export declare const serviceRegistry: typeof ServiceRegistry;

package/dist/lib/core/service-registry.js

@@ -0,0 +1,112 @@
+/**
+ * Service Registry for Dependency Injection
+ * Breaks circular dependencies by providing lazy loading and centralized service management
+ */
+import { logger } from "../utils/logger.js";
+export class ServiceRegistry {
+    static services = new Map();
+    static initializing = new Set();
+    /**
+     * Register a service with optional singleton behavior
+     */
+    static register(name, factory, options = {}) {
+        if (this.services.has(name)) {
+            logger.warn(`Service ${name} is already registered. Overwriting.`);
+        }
+        this.services.set(name, {
+            factory,
+            singleton: options.singleton ?? true,
+            instance: undefined,
+        });
+        logger.debug(`Service registered: ${name} (singleton: ${options.singleton ?? true})`);
+    }
+    /**
+     * Get a service instance with circular dependency detection
+     */
+    static async get(name) {
+        const registration = this.services.get(name);
+        if (!registration) {
+            throw new Error(`Service ${name} not registered. Available services: ${Array.from(this.services.keys()).join(", ")}`);
+        }
+        // Check for circular dependency
+        if (this.initializing.has(name)) {
+            throw new Error(`Circular dependency detected: ${name} is already being initialized. Chain: ${Array.from(this.initializing).join(" -> ")} -> ${name}`);
+        }
+        // Return existing singleton instance if available
+        if (registration.singleton && registration.instance !== undefined) {
+            return registration.instance;
+        }
+        try {
+            // Mark as initializing to detect circular dependencies
+            this.initializing.add(name);
+            logger.debug(`Initializing service: ${name}`);
+            // Create new instance
+            const instance = await registration.factory();
+            // Store singleton instance
+            if (registration.singleton) {
+                registration.instance = instance;
+            }
+            logger.debug(`Service initialized: ${name}`);
+            return instance;
+        }
+        catch (error) {
+            logger.error(`Failed to initialize service ${name}:`, error);
+            throw error;
+        }
+        finally {
+            // Remove from initializing set
+            this.initializing.delete(name);
+        }
+    }
+    /**
+     * Get a service synchronously (throws if async initialization required)
+     */
+    static getSync(name) {
+        const registration = this.services.get(name);
+        if (!registration) {
+            throw new Error(`Service ${name} not registered`);
+        }
+        if (registration.singleton && registration.instance !== undefined) {
+            return registration.instance;
+        }
+        // Try synchronous initialization
+        const result = registration.factory();
+        if (result instanceof Promise) {
+            throw new Error(`Service ${name} requires asynchronous initialization. Use get() instead.`);
+        }
+        if (registration.singleton) {
+            registration.instance = result;
+        }
+        return result;
+    }
+    /**
+     * Check if a service is registered
+     */
+    static has(name) {
+        return this.services.has(name);
+    }
+    /**
+     * Clear all services (useful for testing)
+     */
+    static clear() {
+        this.services.clear();
+        this.initializing.clear();
+        logger.debug("Service registry cleared");
+    }
+    /**
+     * Get all registered service names
+     */
+    static getRegisteredServices() {
+        return Array.from(this.services.keys());
+    }
+    /**
+     * Register multiple services at once
+     */
+    static registerBatch(services) {
+        for (const [name, factory] of Object.entries(services)) {
+            this.register(name, factory);
+        }
+    }
+}
+// Export singleton instance for convenience
+export const serviceRegistry = ServiceRegistry;

package/dist/lib/core/types.d.ts

@@ -1,5 +1,34 @@
 import type { ZodType, ZodTypeDef } from "zod";
-import type { StreamTextResult, ToolSet, Schema, GenerateTextResult, Tool } from "ai";
+import type { Schema, Tool } from "ai";
+import type { GenerateResult } from "../types/generate-types.js";
+import type { StreamOptions, StreamResult } from "../types/stream-types.js";
+export interface TextGenerationResult {
+    content: string;
+    provider?: string;
+    model?: string;
+    usage?: {
+        promptTokens?: number;
+        completionTokens?: number;
+        totalTokens?: number;
+    };
+    responseTime?: number;
+    toolsUsed?: string[];
+    toolExecutions?: Array<{
+        toolName: string;
+        executionTime: number;
+        success: boolean;
+        serverId?: string;
+    }>;
+    enhancedWithTools?: boolean;
+    availableTools?: Array<{
+        name: string;
+        description: string;
+        server: string;
+        category?: string;
+    }>;
+    analytics?: any;
+    evaluation?: any;
+}
 /**
  * Supported AI Provider Names
  */
@@ -12,7 +41,8 @@ export declare enum AIProviderName {
     GOOGLE_AI = "google-ai",
     HUGGINGFACE = "huggingface",
     OLLAMA = "ollama",
-    MISTRAL = "mistral"
+    MISTRAL = "mistral",
+    AUTO = "auto"
 }
 /**
  * Supported Models for Amazon Bedrock
@@ -72,29 +102,11 @@ export interface StreamingOptions {
  * Text generation options interface
  */
 export interface TextGenerationOptions {
-    prompt: string;
-    model?: string;
-    temperature?: number;
-    maxTokens?: number;
-    systemPrompt?: string;
-    schema?: ZodType<unknown, ZodTypeDef, unknown> | Schema<unknown>;
-    tools?: Record<string, Tool>;
-    timeout?: number | string;
-    enableEvaluation?: boolean;
-    enableAnalytics?: boolean;
-    context?: Record<string, any>;
-    evaluationDomain?: string;
-    toolUsageContext?: string;
-    conversationHistory?: Array<{
-        role: string;
-        content: string;
-    }>;
-}
-/**
- * Stream text options interface
- */
-export interface StreamTextOptions {
-    prompt: string;
+    prompt?: string;
+    input?: {
+        text: string;
+    };
+    provider?: AIProviderName;
     model?: string;
     temperature?: number;
     maxTokens?: number;
@@ -102,6 +114,8 @@ export interface StreamTextOptions {
     schema?: ZodType<unknown, ZodTypeDef, unknown> | Schema<unknown>;
     tools?: Record<string, Tool>;
     timeout?: number | string;
+    disableTools?: boolean;
+    maxSteps?: number;
     enableEvaluation?: boolean;
     enableAnalytics?: boolean;
     context?: Record<string, any>;
@@ -133,10 +147,13 @@ export interface AnalyticsData {
  * Updated to match Lighthouse's exact evaluation interface for consistency
  */
 export interface EvaluationData {
-    relevanceScore: number;
-    accuracyScore: number;
-    completenessScore: number;
+    relevance: number;
+    accuracy: number;
+    completeness: number;
     overall: number;
+    domainAlignment?: number;
+    terminologyAccuracy?: number;
+    toolEffectiveness?: number;
     isOffTopic: boolean;
     alertSeverity: "low" | "medium" | "high" | "none";
     reasoning: string;
@@ -207,11 +224,7 @@ export interface ProviderModelConfig {
 /**
  * Enhanced result interfaces with optional analytics/evaluation
  */
-export interface EnhancedGenerateTextResult extends GenerateTextResult<ToolSet, unknown> {
-    analytics?: AnalyticsData;
-    evaluation?: EvaluationData;
-}
-export interface EnhancedStreamTextResult extends StreamTextResult<ToolSet, unknown> {
+export interface EnhancedGenerateResult extends GenerateResult {
     analytics?: AnalyticsData;
     evaluation?: EvaluationData;
 }
@@ -240,26 +253,13 @@ export interface StreamingMetadata {
     modelUsed: string;
 }
 export type ProgressCallback = (progress: StreamingProgressData) => void;
-export interface EnhancedStreamTextOptions extends StreamTextOptions {
-    enableProgressTracking?: boolean;
-    progressCallback?: ProgressCallback;
-    includeStreamingMetadata?: boolean;
-    streamingBufferSize?: number;
-    enableStreamingHeaders?: boolean;
-    customStreamingConfig?: {
-        chunkDelayMs?: number;
-        maxConcurrentChunks?: number;
-        compressionEnabled?: boolean;
-    };
-}
 /**
  * AI Provider interface with flexible parameter support
  */
 export interface AIProvider {
-    streamText(optionsOrPrompt: StreamTextOptions | string, analysisSchema?: ZodType<unknown, ZodTypeDef, unknown> | Schema<unknown>): Promise<EnhancedStreamTextResult | null>;
-    generateText(optionsOrPrompt: TextGenerationOptions | string, analysisSchema?: ZodType<unknown, ZodTypeDef, unknown> | Schema<unknown>): Promise<EnhancedGenerateTextResult | null>;
-    generate(optionsOrPrompt: TextGenerationOptions | string, analysisSchema?: ZodType<unknown, ZodTypeDef, unknown> | Schema<unknown>): Promise<EnhancedGenerateTextResult | null>;
-    gen(optionsOrPrompt: TextGenerationOptions | string, analysisSchema?: ZodType<unknown, ZodTypeDef, unknown> | Schema<unknown>): Promise<EnhancedGenerateTextResult | null>;
+    stream(optionsOrPrompt: StreamOptions | string, analysisSchema?: ZodType<unknown, ZodTypeDef, unknown> | Schema<unknown>): Promise<StreamResult>;
+    generate(optionsOrPrompt: TextGenerationOptions | string, analysisSchema?: ZodType<unknown, ZodTypeDef, unknown> | Schema<unknown>): Promise<EnhancedGenerateResult | null>;
+    gen(optionsOrPrompt: TextGenerationOptions | string, analysisSchema?: ZodType<unknown, ZodTypeDef, unknown> | Schema<unknown>): Promise<EnhancedGenerateResult | null>;
 }
 /**
  * Provider attempt result for iteration tracking

package/dist/lib/core/types.js

@@ -12,6 +12,7 @@ export var AIProviderName;
     AIProviderName["HUGGINGFACE"] = "huggingface";
     AIProviderName["OLLAMA"] = "ollama";
     AIProviderName["MISTRAL"] = "mistral";
+    AIProviderName["AUTO"] = "auto";
 })(AIProviderName || (AIProviderName = {}));
 /**
  * Supported Models for Amazon Bedrock

package/dist/lib/factories/compatibility-factory.d.ts

@@ -0,0 +1,20 @@
+import type { GenerateOptions, GenerateResult } from "../types/generate-types.js";
+import type { TextGenerationOptions } from "../core/types.js";
+/**
+ * Compatibility conversion factory for seamless migration
+ * between generateText and generate functions
+ */
+export declare class CompatibilityConversionFactory {
+    /**
+     * Convert TextGenerationOptions to GenerateOptions
+     */
+    static convertTextToGenerate(options: TextGenerationOptions): GenerateOptions;
+    /**
+     * Convert GenerateResult to legacy TextGenerationResult format
+     */
+    static convertGenerateToText(result: GenerateResult): any;
+    /**
+     * Convert GenerateOptions to TextGenerationOptions
+     */
+    static convertGenerateToText_Options(options: GenerateOptions): TextGenerationOptions;
+}

package/dist/lib/factories/compatibility-factory.js

@@ -0,0 +1,69 @@
+/**
+ * Compatibility conversion factory for seamless migration
+ * between generateText and generate functions
+ */
+export class CompatibilityConversionFactory {
+    /**
+     * Convert TextGenerationOptions to GenerateOptions
+     */
+    static convertTextToGenerate(options) {
+        const { prompt, ...rest } = options;
+        return {
+            input: { text: prompt || "" },
+            output: { format: "text" },
+            provider: rest.provider,
+            model: rest.model,
+            temperature: rest.temperature,
+            maxTokens: rest.maxTokens,
+            systemPrompt: rest.systemPrompt,
+            schema: rest.schema,
+            tools: rest.tools,
+            timeout: rest.timeout,
+            enableEvaluation: rest.enableEvaluation,
+            enableAnalytics: rest.enableAnalytics,
+            context: rest.context,
+            evaluationDomain: rest.evaluationDomain,
+            toolUsageContext: rest.toolUsageContext,
+            conversationHistory: rest.conversationHistory,
+        };
+    }
+    /**
+     * Convert GenerateResult to legacy TextGenerationResult format
+     */
+    static convertGenerateToText(result) {
+        return {
+            content: result.content,
+            provider: result.provider,
+            model: result.model,
+            usage: result.usage,
+            responseTime: result.responseTime,
+            toolsUsed: result.toolsUsed,
+            toolExecutions: result.toolExecutions,
+            enhancedWithTools: result.enhancedWithTools,
+            availableTools: result.availableTools,
+            analytics: result.analytics,
+            evaluation: result.evaluation,
+        };
+    }
+    /**
+     * Convert GenerateOptions to TextGenerationOptions
+     */
+    static convertGenerateToText_Options(options) {
+        return {
+            prompt: options.input.text,
+            model: options.model,
+            temperature: options.temperature,
+            maxTokens: options.maxTokens,
+            systemPrompt: options.systemPrompt,
+            schema: options.schema,
+            tools: options.tools,
+            timeout: options.timeout,
+            enableEvaluation: options.enableEvaluation,
+            enableAnalytics: options.enableAnalytics,
+            context: options.context,
+            evaluationDomain: options.evaluationDomain,
+            toolUsageContext: options.toolUsageContext,
+            conversationHistory: options.conversationHistory,
+        };
+    }
+}