@juspay/neurolink 7.53.1 → 7.53.3

package/dist/types/providers.js

@@ -1,124 +1,7 @@
 /**
  * Provider-specific type definitions for NeuroLink
  */
-// ============================================================================
-// ENUMS
-// ============================================================================
-/**
- * Supported AI Provider Names
- */
-export var AIProviderName;
-(function (AIProviderName) {
-    AIProviderName["BEDROCK"] = "bedrock";
-    AIProviderName["OPENAI"] = "openai";
-    AIProviderName["OPENAI_COMPATIBLE"] = "openai-compatible";
-    AIProviderName["VERTEX"] = "vertex";
-    AIProviderName["ANTHROPIC"] = "anthropic";
-    AIProviderName["AZURE"] = "azure";
-    AIProviderName["GOOGLE_AI"] = "google-ai";
-    AIProviderName["HUGGINGFACE"] = "huggingface";
-    AIProviderName["OLLAMA"] = "ollama";
-    AIProviderName["MISTRAL"] = "mistral";
-    AIProviderName["LITELLM"] = "litellm";
-    AIProviderName["SAGEMAKER"] = "sagemaker";
-    AIProviderName["AUTO"] = "auto";
-})(AIProviderName || (AIProviderName = {}));
-/**
- * Supported Models for Amazon Bedrock
- */
-export var BedrockModels;
-(function (BedrockModels) {
-    BedrockModels["CLAUDE_3_SONNET"] = "anthropic.claude-3-sonnet-20240229-v1:0";
-    BedrockModels["CLAUDE_3_HAIKU"] = "anthropic.claude-3-haiku-20240307-v1:0";
-    BedrockModels["CLAUDE_3_5_SONNET"] = "anthropic.claude-3-5-sonnet-20240620-v1:0";
-    BedrockModels["CLAUDE_3_7_SONNET"] = "arn:aws:bedrock:us-east-2:225681119357:inference-profile/us.anthropic.claude-3-7-sonnet-20250219-v1:0";
-})(BedrockModels || (BedrockModels = {}));
-/**
- * Supported Models for OpenAI
- */
-export var OpenAIModels;
-(function (OpenAIModels) {
-    OpenAIModels["GPT_4"] = "gpt-4";
-    OpenAIModels["GPT_4_TURBO"] = "gpt-4-turbo";
-    OpenAIModels["GPT_4O"] = "gpt-4o";
-    OpenAIModels["GPT_4O_MINI"] = "gpt-4o-mini";
-    OpenAIModels["GPT_3_5_TURBO"] = "gpt-3.5-turbo";
-    OpenAIModels["O1_PREVIEW"] = "o1-preview";
-    OpenAIModels["O1_MINI"] = "o1-mini";
-})(OpenAIModels || (OpenAIModels = {}));
-/**
- * Supported Models for Google Vertex AI
- */
-export var VertexModels;
-(function (VertexModels) {
-    // Claude 4 Series (Latest - May 2025)
-    VertexModels["CLAUDE_4_0_SONNET"] = "claude-sonnet-4@20250514";
-    VertexModels["CLAUDE_4_0_OPUS"] = "claude-opus-4@20250514";
-    // Claude 3.5 Series (Still supported)
-    VertexModels["CLAUDE_3_5_SONNET"] = "claude-3-5-sonnet-20241022";
-    VertexModels["CLAUDE_3_5_HAIKU"] = "claude-3-5-haiku-20241022";
-    // Claude 3 Series (Legacy support)
-    VertexModels["CLAUDE_3_SONNET"] = "claude-3-sonnet-20240229";
-    VertexModels["CLAUDE_3_OPUS"] = "claude-3-opus-20240229";
-    VertexModels["CLAUDE_3_HAIKU"] = "claude-3-haiku-20240307";
-    // Gemini 2.5 Series (Latest - 2025)
-    VertexModels["GEMINI_2_5_PRO"] = "gemini-2.5-pro";
-    VertexModels["GEMINI_2_5_FLASH"] = "gemini-2.5-flash";
-    VertexModels["GEMINI_2_5_FLASH_LITE"] = "gemini-2.5-flash-lite";
-    // Gemini 2.0 Series
-    VertexModels["GEMINI_2_0_FLASH_001"] = "gemini-2.0-flash-001";
-    // Gemini 1.5 Series (Legacy support)
-    VertexModels["GEMINI_1_5_PRO"] = "gemini-1.5-pro";
-    VertexModels["GEMINI_1_5_FLASH"] = "gemini-1.5-flash";
-})(VertexModels || (VertexModels = {}));
-/**
- * Supported Models for Google AI Studio
- */
-export var GoogleAIModels;
-(function (GoogleAIModels) {
-    // Gemini 2.5 Series (Latest - 2025)
-    GoogleAIModels["GEMINI_2_5_PRO"] = "gemini-2.5-pro";
-    GoogleAIModels["GEMINI_2_5_FLASH"] = "gemini-2.5-flash";
-    GoogleAIModels["GEMINI_2_5_FLASH_LITE"] = "gemini-2.5-flash-lite";
-    // Gemini 2.0 Series
-    GoogleAIModels["GEMINI_2_0_FLASH_001"] = "gemini-2.0-flash-001";
-    // Gemini 1.5 Series (Legacy support)
-    GoogleAIModels["GEMINI_1_5_PRO"] = "gemini-1.5-pro";
-    GoogleAIModels["GEMINI_1_5_FLASH"] = "gemini-1.5-flash";
-    GoogleAIModels["GEMINI_1_5_FLASH_LITE"] = "gemini-1.5-flash-lite";
-})(GoogleAIModels || (GoogleAIModels = {}));
-/**
- * Supported Models for Anthropic (Direct API)
- */
-export var AnthropicModels;
-(function (AnthropicModels) {
-    // Claude 3.5 Series (Latest)
-    AnthropicModels["CLAUDE_3_5_SONNET"] = "claude-3-5-sonnet-20241022";
-    AnthropicModels["CLAUDE_3_5_HAIKU"] = "claude-3-5-haiku-20241022";
-    // Claude 3 Series (Legacy support)
-    AnthropicModels["CLAUDE_3_SONNET"] = "claude-3-sonnet-20240229";
-    AnthropicModels["CLAUDE_3_OPUS"] = "claude-3-opus-20240229";
-    AnthropicModels["CLAUDE_3_HAIKU"] = "claude-3-haiku-20240307";
-})(AnthropicModels || (AnthropicModels = {}));
-/**
- * API Versions for various providers
- */
-export var APIVersions;
-(function (APIVersions) {
-    // Azure OpenAI API versions
-    APIVersions["AZURE_LATEST"] = "2025-04-01-preview";
-    APIVersions["AZURE_STABLE"] = "2024-10-21";
-    APIVersions["AZURE_LEGACY"] = "2023-12-01-preview";
-    // OpenAI API versions
-    APIVersions["OPENAI_CURRENT"] = "v1";
-    APIVersions["OPENAI_BETA"] = "v1-beta";
-    // Google AI API versions
-    APIVersions["GOOGLE_AI_CURRENT"] = "v1";
-    APIVersions["GOOGLE_AI_BETA"] = "v1beta";
-    // Anthropic API versions
-    APIVersions["ANTHROPIC_CURRENT"] = "2023-06-01";
-    // Other provider versions can be added here
-})(APIVersions || (APIVersions = {}));
+import { AIProviderName, AnthropicModels, BedrockModels, GoogleAIModels, OpenAIModels, VertexModels, } from "../constants/enums.js";
 /**
  * Default model aliases for easy reference
  */

package/dist/types/sdkTypes.d.ts

@@ -11,7 +11,7 @@ ToolCallResults, ToolCalls, StreamOptions, StreamingOptions, EnhancedStreamProvi
 export type { TypedEventEmitter, NeuroLinkEvents, StreamEvent, AsyncFunction, SyncFunction, AnyFunction, } from "./common.js";
 export type { NeuroLinkConfig, ProviderConfig, PerformanceConfig, CacheConfig, FallbackConfig, RetryConfig, AnalyticsConfig, ToolConfig, BackupInfo, BackupMetadata, ConfigValidationResult, ConfigUpdateOptions, } from "./configTypes.js";
 export type { ToolArgs, ToolContext, ToolResult, ToolDefinition, SimpleTool, AvailableTool, ToolExecution, BaseToolArgs, ToolExecutionEvent, ToolExecutionSummary, ToolExecutionContext, ToolExecutionMetadata, ToolParameterSchema, ZodUnknownSchema, ZodAnySchema, ZodObjectSchema, ZodStringSchema, } from "./tools.js";
-export type { AISDKModel, ProviderError, AIModelProviderConfig, AIProviderName, ProviderName, ModelCapability, ModelUseCase, ModelFilter, ModelResolutionContext, ModelStats, ModelPricing, ProviderCapabilities, } from "./providers.js";
+export type { AISDKModel, ProviderError, AIModelProviderConfig, ProviderName, ModelCapability, ModelUseCase, ModelFilter, ModelResolutionContext, ModelStats, ModelPricing, ProviderCapabilities, } from "./providers.js";
 export type { GenerateOptions, GenerateResult, UnifiedGenerationOptions, EnhancedProvider, FactoryEnhancedProvider, TextGenerationOptions, TextGenerationResult, EnhancedGenerateResult, } from "./generateTypes.js";
 export type { TokenUsage, AnalyticsData } from "./analytics.js";
 export type { TextContent, ImageContent, Content, VisionCapability, ProviderImageFormat, ProcessedImage, MultimodalMessage, ProviderMultimodalPayload, } from "./content.js";

package/dist/types/streamTypes.d.ts

@@ -2,7 +2,8 @@ import type { Tool } from "ai";
 import type { ValidationSchema, StandardRecord } from "./typeAliases.js";
 import type { AIModelProviderConfig } from "./providers.js";
 import type { TextContent, ImageContent } from "./content.js";
-import type { AIProviderName, AnalyticsData, ToolExecutionEvent, ToolExecutionSummary } from "../types/index.js";
+import type { AnalyticsData, ToolExecutionEvent, ToolExecutionSummary } from "../types/index.js";
+import { AIProviderName } from "../constants/enums.js";
 import type { TokenUsage } from "./analytics.js";
 import type { EvaluationData } from "../index.js";
 import type { UnknownRecord, JsonValue } from "./common.js";

package/dist/types/streamTypes.js

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

package/dist/types/taskClassificationTypes.d.ts

@@ -9,29 +9,29 @@ export type TaskType = "fast" | "reasoning";
 /**
  * Result of task classification analysis
  */
-export interface TaskClassification {
+export type TaskClassification = {
     /** The classified task type */
     type: TaskType;
     /** Confidence score (0-1) in the classification */
     confidence: number;
     /** Human-readable explanation of the classification decision */
     reasoning: string;
-}
+};
 /**
  * Internal scoring data used during classification analysis
  */
-export interface ClassificationScores {
+export type ClassificationScores = {
     /** Score indicating likelihood of fast task */
     fastScore: number;
     /** Score indicating likelihood of reasoning task */
     reasoningScore: number;
     /** Array of reasons contributing to the scores */
     reasons: string[];
-}
+};
 /**
  * Statistics for batch classification analysis
  */
-export interface ClassificationStats {
+export type ClassificationStats = {
     /** Total number of prompts analyzed */
     total: number;
     /** Number of prompts classified as fast */
@@ -40,13 +40,13 @@ export interface ClassificationStats {
     reasoning: number;
     /** Average confidence across all classifications */
     averageConfidence: number;
-}
+};
 /**
  * Validation result for testing classification accuracy
  */
-export interface ClassificationValidation {
+export type ClassificationValidation = {
     /** Whether the classification matched the expected result */
     correct: boolean;
     /** The actual classification result */
     classification: TaskClassification;
-}
+};

package/dist/types/universalProviderOptions.d.ts

@@ -7,7 +7,7 @@ import type { BaseContext, ContextConfig } from "./contextTypes.js";
  * Base configuration interface for all AI providers
  * Uses Parameter Object Pattern for flexible, extensible configuration
  */
-export interface UniversalProviderOptions {
+export type UniversalProviderOptions = {
     prompt?: string;
     model?: string;
     temperature?: number;
@@ -19,7 +19,7 @@ export interface UniversalProviderOptions {
     contextConfig?: Partial<ContextConfig>;
     metadata?: Record<string, unknown>;
     extensionOptions?: Record<string, unknown>;
-}
+};
 /**
  * Generic provider options (without providerType)
  */
@@ -28,28 +28,28 @@ export type GenericProviderOptions = Omit<UniversalProviderOptions, "providerTyp
  * Provider-specific configuration extensions
  * Discriminated union pattern for type-safe provider configs
  */
-export interface OpenAIProviderOptions extends UniversalProviderOptions {
+export type OpenAIProviderOptions = UniversalProviderOptions & {
     providerType: "openai";
     organization?: string;
     seed?: number;
     topP?: number;
-}
-export interface GoogleAIProviderOptions extends UniversalProviderOptions {
+};
+export type GoogleAIProviderOptions = UniversalProviderOptions & {
     providerType: "google-ai";
     topK?: number;
     candidateCount?: number;
     stopSequences?: string[];
-}
-export interface AnthropicProviderOptions extends UniversalProviderOptions {
+};
+export type AnthropicProviderOptions = UniversalProviderOptions & {
     providerType: "anthropic";
     topK?: number;
     stopSequences?: string[];
-}
-export interface BedrockProviderOptions extends UniversalProviderOptions {
+};
+export type BedrockProviderOptions = UniversalProviderOptions & {
     providerType: "bedrock";
     inferenceProfileArn?: string;
     region?: string;
-}
+};
 /**
  * Discriminated union for type-safe provider configuration
  * Enables compile-time type checking for provider-specific options
@@ -59,12 +59,12 @@ export type ProviderSpecificOptions = OpenAIProviderOptions | GoogleAIProviderOp
  * Factory configuration interface
  * Supports both universal and provider-specific parameters
  */
-export interface ProviderFactoryConfig {
+export type ProviderFactoryConfig = {
     providerName: string;
     modelName?: string;
     options?: UniversalProviderOptions | ProviderSpecificOptions;
     enableMCP?: boolean;
-}
+};
 /**
  * Parameter normalization utilities
  * Converts between different parameter formats for backward compatibility

package/dist/types/utilities.d.ts

@@ -27,3 +27,51 @@ export type APIValidationResult = {
     errorType?: "missing" | "format" | "config";
     error?: string;
 };
+/**
+ * Parsed proxy configuration
+ */
+export type ParsedProxyConfig = {
+    protocol: string;
+    hostname: string;
+    port: number;
+    auth?: {
+        username: string;
+        password: string;
+    };
+    cleanUrl: string;
+};
+/**
+ * Interface for mem0 Memory instance methods based on actual mem0ai/oss API
+ */
+export type Mem0Memory = {
+    search(query: string, config: {
+        userId?: string;
+        limit?: number;
+    }): Promise<{
+        results: Array<{
+            memory: string;
+            id: string;
+        }>;
+    }>;
+    add(messages: string, config: {
+        userId?: string;
+        metadata?: Record<string, unknown>;
+    }): Promise<{
+        results: Array<{
+            id: string;
+            memory: string;
+        }>;
+    }>;
+    get(memoryId: string): Promise<{
+        id: string;
+        memory: string;
+    } | null>;
+    update(memoryId: string, data: string): Promise<{
+        message: string;
+    }>;
+    delete(memoryId: string): Promise<{
+        message: string;
+    }>;
+    history(memoryId: string): Promise<unknown[]>;
+    reset(): Promise<void>;
+};

package/dist/utils/errorHandling.d.ts

@@ -18,7 +18,7 @@ export declare enum ErrorSeverity {
     HIGH = "high",
     CRITICAL = "critical"
 }
-export interface StructuredError {
+export type StructuredError = {
     code: string;
     message: string;
     category: ErrorCategory;
@@ -29,7 +29,7 @@ export interface StructuredError {
     timestamp: Date;
     toolName?: string;
     serverId?: string;
-}
+};
 export declare const ERROR_CODES: {
     readonly TOOL_NOT_FOUND: "TOOL_NOT_FOUND";
     readonly TOOL_EXECUTION_FAILED: "TOOL_EXECUTION_FAILED";

package/dist/utils/modelRouter.d.ts

@@ -3,13 +3,13 @@
  * Routes tasks to optimal models based on classification and requirements
  */
 import type { TaskType } from "../types/taskClassificationTypes.js";
-export interface ModelRoute {
+export type ModelRoute = {
     provider: string;
     model: string;
     reasoning: string;
     confidence: number;
-}
-export interface ModelRoutingOptions {
+};
+export type ModelRoutingOptions = {
     /** Override the task classification */
     forceTaskType?: TaskType;
     /** Require specific performance characteristics */
@@ -18,7 +18,7 @@ export interface ModelRoutingOptions {
     requireCapability?: string;
     /** Fallback strategy if primary choice fails */
     fallbackStrategy?: "fast" | "reasoning" | "auto";
-}
+};
 /**
  * Model configurations for different task types and providers
  */

package/dist/utils/observabilityHelpers.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Utility for building observability configs from environment variables
+ */
+import type { ObservabilityConfig } from "../types/observability.js";
+/**
+ * Build observability config from environment variables
+ *
+ * Reads Langfuse configuration from environment:
+ * - LANGFUSE_ENABLED: Enable/disable Langfuse (must be "true")
+ * - LANGFUSE_PUBLIC_KEY: Your Langfuse public key (required)
+ * - LANGFUSE_SECRET_KEY: Your Langfuse secret key (required)
+ * - LANGFUSE_BASE_URL: Langfuse server URL (default: https://cloud.langfuse.com)
+ * - LANGFUSE_ENVIRONMENT: Environment name (default: dev)
+ * - PUBLIC_APP_VERSION: Release/version identifier (default: v1.0.0)
+ *
+ * @returns ObservabilityConfig if all required env vars are set, undefined otherwise
+ *
+ * @example
+ * ```typescript
+ * import { NeuroLink, buildObservabilityConfigFromEnv } from '@juspay/neurolink';
+ *
+ * const neurolink = new NeuroLink({
+ *   observability: buildObservabilityConfigFromEnv()
+ * });
+ * ```
+ */
+export declare function buildObservabilityConfigFromEnv(): ObservabilityConfig | undefined;

package/dist/utils/observabilityHelpers.js

@@ -0,0 +1,47 @@
+/**
+ * Utility for building observability configs from environment variables
+ */
+/**
+ * Build observability config from environment variables
+ *
+ * Reads Langfuse configuration from environment:
+ * - LANGFUSE_ENABLED: Enable/disable Langfuse (must be "true")
+ * - LANGFUSE_PUBLIC_KEY: Your Langfuse public key (required)
+ * - LANGFUSE_SECRET_KEY: Your Langfuse secret key (required)
+ * - LANGFUSE_BASE_URL: Langfuse server URL (default: https://cloud.langfuse.com)
+ * - LANGFUSE_ENVIRONMENT: Environment name (default: dev)
+ * - PUBLIC_APP_VERSION: Release/version identifier (default: v1.0.0)
+ *
+ * @returns ObservabilityConfig if all required env vars are set, undefined otherwise
+ *
+ * @example
+ * ```typescript
+ * import { NeuroLink, buildObservabilityConfigFromEnv } from '@juspay/neurolink';
+ *
+ * const neurolink = new NeuroLink({
+ *   observability: buildObservabilityConfigFromEnv()
+ * });
+ * ```
+ */
+export function buildObservabilityConfigFromEnv() {
+    const langfuseEnabled = process.env.LANGFUSE_ENABLED?.trim().toLowerCase() === "true";
+    const publicKey = process.env.LANGFUSE_PUBLIC_KEY?.trim();
+    const secretKey = process.env.LANGFUSE_SECRET_KEY?.trim();
+    if (!langfuseEnabled || !publicKey || !secretKey) {
+        return undefined;
+    }
+    return {
+        langfuse: {
+            enabled: langfuseEnabled,
+            publicKey,
+            secretKey,
+            baseUrl: process.env.LANGFUSE_BASE_URL?.trim() || "https://cloud.langfuse.com",
+            environment: process.env.LANGFUSE_ENVIRONMENT?.trim() ||
+                process.env.PUBLIC_APP_ENVIRONMENT?.trim() ||
+                "dev",
+            release: process.env.PUBLIC_APP_VERSION?.trim() ||
+                process.env.npm_package_version?.trim() ||
+                "v1.0.0",
+        },
+    };
+}

package/dist/utils/providerHealth.d.ts

@@ -2,26 +2,8 @@
  * Provider Health Checking System
  * Prevents 500 errors by validating provider availability and configuration
  */
-import { AIProviderName } from "../types/providers.js";
-export interface ProviderHealthStatus {
-    provider: AIProviderName;
-    isHealthy: boolean;
-    isConfigured: boolean;
-    hasApiKey: boolean;
-    lastChecked: Date;
-    error?: string;
-    warning?: string;
-    responseTime?: number;
-    configurationIssues: string[];
-    recommendations: string[];
-}
-export interface ProviderHealthCheckOptions {
-    timeout?: number;
-    includeConnectivityTest?: boolean;
-    includeModelValidation?: boolean;
-    cacheResults?: boolean;
-    maxCacheAge?: number;
-}
+import { AIProviderName } from "../constants/enums.js";
+import type { ProviderHealthCheckOptions, ProviderHealthStatusOptions } from "../types/providers.js";
 export declare class ProviderHealthChecker {
     private static healthCache;
     private static readonly DEFAULT_TIMEOUT;
@@ -35,7 +17,7 @@ export declare class ProviderHealthChecker {
     /**
      * Comprehensive health check for a provider
      */
-    static checkProviderHealth(providerName: AIProviderName, options?: ProviderHealthCheckOptions): Promise<ProviderHealthStatus>;
+    static checkProviderHealth(providerName: AIProviderName, options?: ProviderHealthCheckOptions): Promise<ProviderHealthStatusOptions>;
     /**
      * Check environment configuration for a provider
      */
@@ -196,11 +178,11 @@ export declare class ProviderHealthChecker {
     /**
      * Get health status for all registered providers
      */
-    static checkAllProvidersHealth(options?: ProviderHealthCheckOptions): Promise<ProviderHealthStatus[]>;
+    static checkAllProvidersHealth(options?: ProviderHealthCheckOptions): Promise<ProviderHealthStatusOptions[]>;
     /**
      * Get a summary of provider health
      */
-    static getHealthSummary(healthStatuses: ProviderHealthStatus[]): {
+    static getHealthSummary(healthStatuses: ProviderHealthStatusOptions[]): {
         total: number;
         healthy: number;
         configured: number;

package/dist/utils/providerHealth.js

@@ -3,7 +3,7 @@
  * Prevents 500 errors by validating provider availability and configuration
  */
 import { logger } from "./logger.js";
-import { AIProviderName, OpenAIModels, GoogleAIModels, AnthropicModels, BedrockModels, } from "../types/providers.js";
+import { AIProviderName, OpenAIModels, GoogleAIModels, AnthropicModels, BedrockModels, } from "../constants/enums.js";
 import { API_KEY_LENGTHS, PROJECT_ID_FORMAT } from "./providerConfig.js";
 import { basename } from "path";
 import { createProxyFetch } from "../proxy/proxyFetch.js";

package/dist/utils/providerSetupMessages.js

@@ -2,7 +2,7 @@
  * Enhanced Provider Setup Messages
  * Provides detailed setup instructions for AI providers
  */
-import { OpenAIModels, GoogleAIModels, AnthropicModels, APIVersions, } from "../types/providers.js";
+import { OpenAIModels, GoogleAIModels, AnthropicModels, APIVersions, } from "../constants/enums.js";
 /**
  * Generate enhanced error message with setup instructions
  */

package/dist/utils/providerUtils.js

@@ -4,6 +4,7 @@
  */
 import { AIProviderFactory } from "../core/factory.js";
 import { logger } from "./logger.js";
+import { AIProviderName } from "../constants/enums.js";
 import { ProviderHealthChecker } from "./providerHealth.js";
 import { API_KEY_FORMATS, API_KEY_LENGTHS, PROJECT_ID_FORMAT, } from "./providerConfig.js";
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@juspay/neurolink",
-  "version": "7.53.1",
+  "version": "7.53.3",
   "description": "Universal AI Development Platform with working MCP integration, multi-provider support, and professional CLI. Built-in tools operational, 58+ external MCP servers discoverable. Connect to filesystem, GitHub, database operations, and more. Build, test, and deploy AI applications with 9 major providers: OpenAI, Anthropic, Google AI, AWS Bedrock, Azure, Hugging Face, Ollama, and Mistral AI.",
   "author": {
     "name": "Juspay Technologies",