@juspay/neurolink 7.53.3 → 7.53.5

package/dist/types/tools.d.ts

@@ -4,7 +4,8 @@
  */
 import { z } from "zod";
 import type { ErrorInfo, JsonObject, JsonValue, Result, UnknownRecord } from "./common.js";
-import type { StandardRecord, ZodUnknownSchema } from "./typeAliases.js";
+import type { StandardRecord, StringArray, ZodUnknownSchema } from "./typeAliases.js";
+import type { ValidationError } from "../utils/parameterValidation.js";
 /**
  * Commonly used Zod schema type aliases for cleaner type declarations
  */
@@ -336,6 +337,20 @@ export type ToolCallResult = {
     result: ToolResult;
     formattedForAI: string;
 };
+/**
+ * Result of a validation operation
+ * Contains validation status, errors, warnings, and suggestions for improvement
+ */
+export type EnhancedValidationResult = {
+    /** Whether the validation passed without errors */
+    isValid: boolean;
+    /** Array of validation errors that must be fixed */
+    errors: ValidationError[];
+    /** Array of warning messages that should be addressed */
+    warnings: string[];
+    /** Array of suggestions to improve the validated object */
+    suggestions: StringArray;
+};
 /**
  * Type guard for tool result
  */

package/dist/types/utilities.d.ts

@@ -1,6 +1,17 @@
 /**
  * Utility module types - extracted from utils module files
  */
+import { ErrorCategory, ErrorSeverity } from "../constants/enums.js";
+import type { UnifiedGenerationOptions } from "./generateTypes.js";
+import type { ExecutionContext } from "./tools.js";
+/**
+ * Represents the available logging severity levels.
+ * - debug: Detailed information for debugging purposes
+ * - info: General information about system operation
+ * - warn: Potential issues that don't prevent operation
+ * - error: Critical issues that may cause failures
+ */
+export type LogLevel = "debug" | "info" | "warn" | "error";
 export type TimeoutConfig = {
     operation: string;
     timeout?: number | string;
@@ -40,6 +51,126 @@ export type ParsedProxyConfig = {
     };
     cleanUrl: string;
 };
+/**
+ * Represents a single log entry in the logging system.
+ * Each entry contains metadata about the log event along with the actual message.
+ */
+export type LogEntry = {
+    /** The severity level of the log entry */
+    level: LogLevel;
+    /** The text message to be logged */
+    message: string;
+    /** When the log entry was created */
+    timestamp: Date;
+    /** Optional additional data associated with the log entry (objects, arrays, etc.) */
+    data?: unknown;
+};
+export type StructuredError = {
+    code: string;
+    message: string;
+    category: ErrorCategory;
+    severity: ErrorSeverity;
+    retriable: boolean;
+    context?: Record<string, unknown>;
+    originalError?: Error;
+    timestamp: Date;
+    toolName?: string;
+    serverId?: string;
+};
+/**
+ * Enhancement types for different optimization strategies
+ */
+export type EnhancementType = "streaming-optimization" | "mcp-integration" | "legacy-migration" | "context-conversion" | "domain-configuration" | "batch-parallel-enhancement" | "batch-hybrid-enhancement" | "batch-dependency-enhancement";
+/**
+ * Enhancement options for modifying GenerateOptions
+ */
+export type EnhancementOptions = {
+    enhancementType: EnhancementType;
+    streamingOptions?: {
+        enabled?: boolean;
+        chunkSize?: number;
+        bufferSize?: number;
+        enableProgress?: boolean;
+        preferStreaming?: boolean;
+    };
+    mcpOptions?: {
+        enableToolRegistry?: boolean;
+        contextAware?: boolean;
+        executionContext?: ExecutionContext;
+    };
+    legacyMigration?: {
+        legacyContext?: Record<string, unknown>;
+        domainType?: string;
+        preserveFields?: boolean;
+    };
+    domainConfiguration?: {
+        domainType: string;
+        keyTerms?: string[];
+        failurePatterns?: string[];
+        successPatterns?: string[];
+        evaluationCriteria?: Record<string, unknown>;
+    };
+    performance?: {
+        enableAnalytics?: boolean;
+        enableEvaluation?: boolean;
+        timeout?: number;
+    };
+};
+/**
+ * Enhancement result with metadata
+ */
+export type EnhancementResult = {
+    options: UnifiedGenerationOptions;
+    metadata: {
+        enhancementApplied: boolean;
+        enhancementType: EnhancementType;
+        processingTime: number;
+        configurationUsed: Record<string, unknown>;
+        warnings: string[];
+        recommendations: string[];
+    };
+};
+/**
+ * Plugin-based conflict detection system
+ * Extensible and configurable enhancement conflict resolution
+ */
+export type ConflictDetectionPlugin = {
+    /** Plugin name for identification */
+    name: string;
+    /** Plugin version for compatibility checks */
+    version: string;
+    /** Check if two enhancement types conflict */
+    detectConflict(enhancementA: EnhancementType, enhancementB: EnhancementType, optionsA?: EnhancementOptions, optionsB?: EnhancementOptions): boolean;
+    /** Get conflict severity (low, medium, high) */
+    getConflictSeverity?(enhancementA: EnhancementType, enhancementB: EnhancementType): "low" | "medium" | "high";
+    /** Suggest resolution strategies */
+    suggestResolution?(enhancementA: EnhancementType, enhancementB: EnhancementType): string[];
+};
+export type RetryOptions = {
+    maxAttempts?: number;
+    initialDelay?: number;
+    maxDelay?: number;
+    backoffMultiplier?: number;
+    retryCondition?: (error: unknown) => boolean;
+    onRetry?: (attempt: number, error: unknown) => void;
+};
+export type PromptRedactionOptions = {
+    /** Maximum length of redacted prompt */
+    maxLength?: number;
+    /** Whether to show word count */
+    showWordCount?: boolean;
+    /** Mask character to use for redaction */
+    maskChar?: string;
+};
+/**
+ * Validation results for environment variables
+ */
+export type EnvVarValidationResult = {
+    isValid: boolean;
+    missingVars: string[];
+    invalidVars: string[];
+    warnings: string[];
+};
 /**
  * Interface for mem0 Memory instance methods based on actual mem0ai/oss API
  */

package/dist/types/utilities.js

@@ -1,4 +1,4 @@
 /**
  * Utility module types - extracted from utils module files
  */
-export {};
+import { ErrorCategory, ErrorSeverity } from "../constants/enums.js";

package/dist/utils/errorHandling.d.ts

@@ -2,34 +2,8 @@
  * Robust Error Handling Utilities for NeuroLink
  * Provides structured error management for tool execution and system operations
  */
-export declare enum ErrorCategory {
-    VALIDATION = "validation",
-    TIMEOUT = "timeout",
-    NETWORK = "network",
-    RESOURCE = "resource",
-    PERMISSION = "permission",
-    CONFIGURATION = "configuration",
-    EXECUTION = "execution",
-    SYSTEM = "system"
-}
-export declare enum ErrorSeverity {
-    LOW = "low",
-    MEDIUM = "medium",
-    HIGH = "high",
-    CRITICAL = "critical"
-}
-export type StructuredError = {
-    code: string;
-    message: string;
-    category: ErrorCategory;
-    severity: ErrorSeverity;
-    retriable: boolean;
-    context?: Record<string, unknown>;
-    originalError?: Error;
-    timestamp: Date;
-    toolName?: string;
-    serverId?: string;
-};
+import { ErrorCategory, ErrorSeverity } from "../constants/enums.js";
+import type { StructuredError } from "../types/utilities.js";
 export declare const ERROR_CODES: {
     readonly TOOL_NOT_FOUND: "TOOL_NOT_FOUND";
     readonly TOOL_EXECUTION_FAILED: "TOOL_EXECUTION_FAILED";

package/dist/utils/errorHandling.js

@@ -2,27 +2,8 @@
  * Robust Error Handling Utilities for NeuroLink
  * Provides structured error management for tool execution and system operations
  */
+import { ErrorCategory, ErrorSeverity } from "../constants/enums.js";
 import { logger } from "./logger.js";
-// Error categories for proper handling
-export var ErrorCategory;
-(function (ErrorCategory) {
-    ErrorCategory["VALIDATION"] = "validation";
-    ErrorCategory["TIMEOUT"] = "timeout";
-    ErrorCategory["NETWORK"] = "network";
-    ErrorCategory["RESOURCE"] = "resource";
-    ErrorCategory["PERMISSION"] = "permission";
-    ErrorCategory["CONFIGURATION"] = "configuration";
-    ErrorCategory["EXECUTION"] = "execution";
-    ErrorCategory["SYSTEM"] = "system";
-})(ErrorCategory || (ErrorCategory = {}));
-// Error severity levels
-export var ErrorSeverity;
-(function (ErrorSeverity) {
-    ErrorSeverity["LOW"] = "low";
-    ErrorSeverity["MEDIUM"] = "medium";
-    ErrorSeverity["HIGH"] = "high";
-    ErrorSeverity["CRITICAL"] = "critical";
-})(ErrorSeverity || (ErrorSeverity = {}));
 // Error codes for different scenarios
 export const ERROR_CODES = {
     // Tool errors

package/dist/utils/logger.d.ts

@@ -13,28 +13,7 @@
  * - Structured data support for complex objects
  * - Tabular data display
  */
-/**
- * Represents the available logging severity levels.
- * - debug: Detailed information for debugging purposes
- * - info: General information about system operation
- * - warn: Potential issues that don't prevent operation
- * - error: Critical issues that may cause failures
- */
-export type LogLevel = "debug" | "info" | "warn" | "error";
-/**
- * Represents a single log entry in the logging system.
- * Each entry contains metadata about the log event along with the actual message.
- */
-interface LogEntry {
-    /** The severity level of the log entry */
-    level: LogLevel;
-    /** The text message to be logged */
-    message: string;
-    /** When the log entry was created */
-    timestamp: Date;
-    /** Optional additional data associated with the log entry (objects, arrays, etc.) */
-    data?: unknown;
-}
+import type { LogEntry, LogLevel } from "../types/utilities.js";
 declare class NeuroLinkLogger {
     private logLevel;
     private logs;
@@ -236,4 +215,4 @@ export declare const LogLevels: {
     readonly warn: "warn";
     readonly error: "error";
 };
-export type { LogEntry };
+export {};

package/dist/utils/modelRouter.d.ts

@@ -2,23 +2,7 @@
  * Model Router for NeuroLink Orchestration
  * Routes tasks to optimal models based on classification and requirements
  */
-import type { TaskType } from "../types/taskClassificationTypes.js";
-export type ModelRoute = {
-    provider: string;
-    model: string;
-    reasoning: string;
-    confidence: number;
-};
-export type ModelRoutingOptions = {
-    /** Override the task classification */
-    forceTaskType?: TaskType;
-    /** Require specific performance characteristics */
-    requireFast?: boolean;
-    /** Require specific capability (reasoning, creativity, etc.) */
-    requireCapability?: string;
-    /** Fallback strategy if primary choice fails */
-    fallbackStrategy?: "fast" | "reasoning" | "auto";
-};
+import type { ModelRoute, ModelRoutingOptions } from "../types/modelTypes.js";
 /**
  * Model configurations for different task types and providers
  */

package/dist/utils/optionsConversion.d.ts

@@ -17,11 +17,6 @@ export declare function convertGenerateToStreamOptions(generateOptions: Generate
  * Useful for fallback scenarios and unified processing
  */
 export declare function convertStreamToGenerateOptions(streamOptions: StreamOptions): GenerateOptions;
-/**
- * Create a unified options interface that works with both methods
- * Useful for factory utilities that need to work with either type
- */
-export type UnifiedOptions = GenerateOptions & StreamOptions;
 /**
  * Check if options object has factory configuration
  * Useful for determining if enhanced processing is needed

package/dist/utils/optionsUtils.d.ts

@@ -5,60 +5,7 @@
  */
 import type { GenerateOptions, UnifiedGenerationOptions } from "../types/generateTypes.js";
 import type { StreamOptions } from "../types/streamTypes.js";
-import type { ExecutionContext } from "../types/tools.js";
-/**
- * Enhancement types for different optimization strategies
- */
-export type EnhancementType = "streaming-optimization" | "mcp-integration" | "legacy-migration" | "context-conversion" | "domain-configuration" | "batch-parallel-enhancement" | "batch-hybrid-enhancement" | "batch-dependency-enhancement";
-/**
- * Enhancement options for modifying GenerateOptions
- */
-export interface EnhancementOptions {
-    enhancementType: EnhancementType;
-    streamingOptions?: {
-        enabled?: boolean;
-        chunkSize?: number;
-        bufferSize?: number;
-        enableProgress?: boolean;
-        preferStreaming?: boolean;
-    };
-    mcpOptions?: {
-        enableToolRegistry?: boolean;
-        contextAware?: boolean;
-        executionContext?: ExecutionContext;
-    };
-    legacyMigration?: {
-        legacyContext?: Record<string, unknown>;
-        domainType?: string;
-        preserveFields?: boolean;
-    };
-    domainConfiguration?: {
-        domainType: string;
-        keyTerms?: string[];
-        failurePatterns?: string[];
-        successPatterns?: string[];
-        evaluationCriteria?: Record<string, unknown>;
-    };
-    performance?: {
-        enableAnalytics?: boolean;
-        enableEvaluation?: boolean;
-        timeout?: number;
-    };
-}
-/**
- * Enhancement result with metadata
- */
-export interface EnhancementResult {
-    options: UnifiedGenerationOptions;
-    metadata: {
-        enhancementApplied: boolean;
-        enhancementType: EnhancementType;
-        processingTime: number;
-        configurationUsed: Record<string, unknown>;
-        warnings: string[];
-        recommendations: string[];
-    };
-}
+import type { ConflictDetectionPlugin, EnhancementOptions, EnhancementResult, EnhancementType } from "../types/utilities.js";
 /**
  * Options Enhancement Utility Class
  * Main utility for enhancing GenerateOptions with factory patterns
@@ -176,22 +123,6 @@ export declare function migrateLegacyContext(options: GenerateOptions, legacyCon
  * Automatically detects independent enhancements for parallel processing
  */
 export declare function batchEnhance(options: GenerateOptions, enhancements: EnhancementOptions[]): EnhancementResult;
-/**
- * Plugin-based conflict detection system
- * Extensible and configurable enhancement conflict resolution
- */
-export interface ConflictDetectionPlugin {
-    /** Plugin name for identification */
-    name: string;
-    /** Plugin version for compatibility checks */
-    version: string;
-    /** Check if two enhancement types conflict */
-    detectConflict(enhancementA: EnhancementType, enhancementB: EnhancementType, optionsA?: EnhancementOptions, optionsB?: EnhancementOptions): boolean;
-    /** Get conflict severity (low, medium, high) */
-    getConflictSeverity?(enhancementA: EnhancementType, enhancementB: EnhancementType): "low" | "medium" | "high";
-    /** Suggest resolution strategies */
-    suggestResolution?(enhancementA: EnhancementType, enhancementB: EnhancementType): string[];
-}
 /**
  * Plugin registry for managing conflict detection plugins
  */

package/dist/utils/parameterValidation.d.ts

@@ -3,6 +3,7 @@
  * Provides consistent parameter validation across all tool interfaces
  */
 import type { ValidationSchema, StringArray } from "../types/typeAliases.js";
+import type { EnhancedValidationResult } from "../types/tools.js";
 /**
  * Custom error class for parameter validation failures
  * Provides detailed information about validation errors including field context and suggestions
@@ -20,20 +21,6 @@ export declare class ValidationError extends Error {
      */
     constructor(message: string, field?: string | undefined, code?: string | undefined, suggestions?: StringArray | undefined);
 }
-/**
- * Result of a validation operation
- * Contains validation status, errors, warnings, and suggestions for improvement
- */
-export interface ValidationResult {
-    /** Whether the validation passed without errors */
-    isValid: boolean;
-    /** Array of validation errors that must be fixed */
-    errors: ValidationError[];
-    /** Array of warning messages that should be addressed */
-    warnings: string[];
-    /** Array of suggestions to improve the validated object */
-    suggestions: StringArray;
-}
 /**
  * Validate that a string parameter is present and non-empty
  */
@@ -61,23 +48,23 @@ export declare function validateToolDescription(description: unknown): Validatio
 /**
  * Validate MCP tool structure comprehensively
  */
-export declare function validateMCPTool(tool: unknown): ValidationResult;
+export declare function validateMCPTool(tool: unknown): EnhancedValidationResult;
 /**
  * Validate text generation options
  */
-export declare function validateTextGenerationOptions(options: unknown): ValidationResult;
+export declare function validateTextGenerationOptions(options: unknown): EnhancedValidationResult;
 /**
  * Validate stream options
  */
-export declare function validateStreamOptions(options: unknown): ValidationResult;
+export declare function validateStreamOptions(options: unknown): EnhancedValidationResult;
 /**
  * Validate generate options (unified interface)
  */
-export declare function validateGenerateOptions(options: unknown): ValidationResult;
+export declare function validateGenerateOptions(options: unknown): EnhancedValidationResult;
 /**
  * Validate tool execution parameters
  */
-export declare function validateToolExecutionParams(toolName: string, params: unknown, expectedSchema?: ValidationSchema): ValidationResult;
+export declare function validateToolExecutionParams(toolName: string, params: unknown, expectedSchema?: ValidationSchema): EnhancedValidationResult;
 /**
  * Validate multiple tools at once
  */
@@ -85,13 +72,13 @@ export declare function validateToolBatch(tools: Record<string, unknown>): {
     isValid: boolean;
     validTools: string[];
     invalidTools: string[];
-    results: Record<string, ValidationResult>;
+    results: Record<string, EnhancedValidationResult>;
 };
 /**
  * Create a validation error summary for logging
  */
-export declare function createValidationSummary(result: ValidationResult): string;
+export declare function createValidationSummary(result: EnhancedValidationResult): string;
 /**
  * Check if validation result has only warnings (no errors)
  */
-export declare function hasOnlyWarnings(result: ValidationResult): boolean;
+export declare function hasOnlyWarnings(result: EnhancedValidationResult): boolean;

package/dist/utils/performance.d.ts

@@ -2,19 +2,7 @@
  * Performance measurement and memory management utilities
  * Part of Sub-phase 3.3.1-3.3.2 optimization efforts
  */
-export interface PerformanceMetrics {
-    startTime: number;
-    endTime?: number;
-    duration?: number;
-    memoryStart: NodeJS.MemoryUsage;
-    memoryEnd?: NodeJS.MemoryUsage;
-    memoryDelta?: {
-        rss: number;
-        heapTotal: number;
-        heapUsed: number;
-        external: number;
-    };
-}
+import type { PerformanceMetrics } from "../types/analytics.js";
 /**
  * Performance measurement utility for tracking operations
  */

package/dist/utils/promptRedaction.d.ts

@@ -2,14 +2,7 @@
  * Prompt redaction utilities for safe logging
  * Provides consistent prompt masking across NeuroLink components
  */
-export interface PromptRedactionOptions {
-    /** Maximum length of redacted prompt */
-    maxLength?: number;
-    /** Whether to show word count */
-    showWordCount?: boolean;
-    /** Mask character to use for redaction */
-    maskChar?: string;
-}
+import type { PromptRedactionOptions } from "../types/utilities.js";
 /**
  * Redact a prompt for safe logging
  * Truncates to maxLength and optionally shows word count

package/dist/utils/providerUtils.d.ts

@@ -1,4 +1,5 @@
-import type { ProviderError } from "../types/index.js";
+import type { ProviderError } from "../types/providers.js";
+import type { EnvVarValidationResult } from "../types/utilities.js";
 /**
  * Get the best available provider based on real-time availability checks
  * Enhanced version consolidated from providerUtils-fixed.ts
@@ -6,15 +7,6 @@ import type { ProviderError } from "../types/index.js";
  * @returns The best provider name to use
  */
 export declare function getBestProvider(requestedProvider?: string): Promise<string>;
-/**
- * Validation results for environment variables
- */
-export interface EnvVarValidationResult {
-    isValid: boolean;
-    missingVars: string[];
-    invalidVars: string[];
-    warnings: string[];
-}
 /**
  * Validate environment variable values for a provider
  * Addresses GitHub Copilot comment about adding environment variable validation

package/dist/utils/redis.d.ts

@@ -3,8 +3,8 @@
  * Helper functions for Redis storage operations
  */
 import { createClient } from "redis";
-type RedisClient = ReturnType<typeof createClient>;
 import type { RedisStorageConfig, RedisConversationObject } from "../types/conversation.js";
+type RedisClient = ReturnType<typeof createClient>;
 /**
  * Creates a Redis client with the provided configuration
  */

package/dist/utils/redis.js

@@ -4,7 +4,6 @@
  */
 import { createClient } from "redis";
 import { logger } from "./logger.js";
-// Redis client type
 /**
  * Creates a Redis client with the provided configuration
  */

package/dist/utils/retryHandler.d.ts

@@ -2,6 +2,7 @@
  * Retry and resilience utilities for NeuroLink
  * Part of Sub-phase 3.3.3 - Edge Case Handling
  */
+import type { RetryOptions } from "../types/utilities.js";
 /**
  * Calculate exponential backoff delay with jitter
  * @param attempt - Current attempt number (1-based)
@@ -12,14 +13,6 @@
  * @returns Calculated delay in milliseconds
  */
 export declare function calculateBackoffDelay(attempt: number, initialDelay?: number, multiplier?: number, maxDelay?: number, addJitter?: boolean): number;
-export interface RetryOptions {
-    maxAttempts?: number;
-    initialDelay?: number;
-    maxDelay?: number;
-    backoffMultiplier?: number;
-    retryCondition?: (error: unknown) => boolean;
-    onRetry?: (attempt: number, error: unknown) => void;
-}
 /**
  * Error types that are typically retryable
  */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@juspay/neurolink",
-  "version": "7.53.3",
+  "version": "7.53.5",
   "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",