@juspay/neurolink 7.53.1 → 7.53.3

package/dist/{lib/hitl/types.d.ts → types/hitlTypes.d.ts}

@@ -9,7 +9,7 @@
  * Core HITL configuration interface
  * Controls how the HITL system behaves and what tools require confirmation
  */
-export interface HITLConfig {
+export type HITLConfig = {
     /** Master enable/disable switch for HITL functionality */
     enabled: boolean;
     /** Keywords that trigger HITL confirmation (e.g., "delete", "remove", "drop") */
@@ -26,12 +26,12 @@ export interface HITLConfig {
     auditLogging?: boolean;
     /** Advanced custom rules for complex tool scenarios (default: []) */
     customRules?: HITLRule[];
-}
+};
 /**
  * Custom rule for advanced HITL scenarios
  * Allows enterprises to define complex conditions for when tools require confirmation
  */
-export interface HITLRule {
+export type HITLRule = {
     /** Human-readable name for the rule */
     name: string;
     /** Function that determines if a tool requires confirmation */
@@ -40,12 +40,12 @@ export interface HITLRule {
     requiresConfirmation: boolean;
     /** Custom message to show users when this rule is triggered */
     customMessage?: string;
-}
+};
 /**
  * Internal confirmation request tracking
  * Used by HITLManager to track pending confirmations
  */
-export interface ConfirmationRequest {
+export type ConfirmationRequest = {
     /** Unique identifier for this confirmation request */
     confirmationId: string;
     /** Name of the tool requiring confirmation */
@@ -60,12 +60,12 @@ export interface ConfirmationRequest {
     resolve: (result: ConfirmationResult) => void;
     /** Promise reject function */
     reject: (error: Error) => void;
-}
+};
 /**
  * Result of a confirmation request
  * Contains user decision and potentially modified arguments
  */
-export interface ConfirmationResult {
+export type ConfirmationResult = {
     /** Whether the user approved the tool execution */
     approved: boolean;
     /** Optional reason for rejection (if approved is false) */
@@ -74,12 +74,12 @@ export interface ConfirmationResult {
     modifiedArguments?: unknown;
     /** Time taken for user to respond in milliseconds */
     responseTime: number;
-}
+};
 /**
  * Event payload for confirmation requests
  * Sent to frontends via EventEmitter when tool needs approval
  */
-export interface ConfirmationRequestEvent {
+export type ConfirmationRequestEvent = {
     type: "hitl:confirmation-request";
     payload: {
         /** Unique ID for tracking this request */
@@ -108,12 +108,12 @@ export interface ConfirmationRequestEvent {
         /** Whether user can modify arguments */
         allowModification: boolean;
     };
-}
+};
 /**
  * Event payload for confirmation responses
  * Sent from frontends back to HITLManager with user decision
  */
-export interface ConfirmationResponseEvent {
+export type ConfirmationResponseEvent = {
     type: "hitl:confirmation-response";
     payload: {
         /** Matching confirmation ID from the request */
@@ -134,12 +134,12 @@ export interface ConfirmationResponseEvent {
             userId?: string;
         };
     };
-}
+};
 /**
  * Event payload for confirmation timeouts
  * Emitted when user doesn't respond within timeout period
  */
-export interface ConfirmationTimeoutEvent {
+export type ConfirmationTimeoutEvent = {
     type: "hitl:timeout";
     payload: {
         /** Confirmation ID that timed out */
@@ -149,12 +149,12 @@ export interface ConfirmationTimeoutEvent {
         /** Timeout duration in milliseconds */
         timeout: number;
     };
-}
+};
 /**
  * HITL audit log entry
  * Used for compliance and debugging purposes
  */
-export interface HITLAuditLog {
+export type HITLAuditLog = {
     /** ISO timestamp of the event */
     timestamp: string;
     /** Type of HITL event */
@@ -175,12 +175,12 @@ export interface HITLAuditLog {
     userAgent?: string;
     /** Response time in milliseconds (if applicable) */
     responseTime?: number;
-}
+};
 /**
  * HITL statistics interface
  * Provides metrics about HITL usage for monitoring
  */
-export interface HITLStatistics {
+export type HITLStatistics = {
     /** Total number of confirmation requests made */
     totalRequests: number;
     /** Number of pending confirmations */
@@ -193,4 +193,4 @@ export interface HITLStatistics {
     rejectedRequests: number;
     /** Number of timed out requests */
     timedOutRequests: number;
-}
+};

package/dist/types/index.d.ts

@@ -12,7 +12,7 @@ export type { ToolArgs, ToolContext, ToolResult, ToolDefinition, SimpleTool, Ava
 export type { AISDKModel, ProviderError, AIModelProviderConfig, } from "./providers.js";
 export type { BaseCommandArgs, GenerateCommandArgs, MCPCommandArgs, ModelsCommandArgs, CommandResult, GenerateResult, StreamChunk, } from "./cli.js";
 export type { TaskType, TaskClassification, ClassificationScores, ClassificationStats, ClassificationValidation, } from "./taskClassificationTypes.js";
-export type { MCPTransportType, MCPServerConnectionStatus, MCPServerCategory, MCPServerStatus, MCPDiscoveredServer, MCPConnectedServer, MCPToolInfo, MCPExecutableTool, MCPServerMetadata, MCPToolMetadata, MCPServerRegistryEntry, NeuroLinkMCPTool, NeuroLinkMCPServer, NeuroLinkExecutionContext, MCPServerConfig, DiscoveredMcp, McpMetadata, ProviderStatus, ToolDiscoveryResult, ExternalToolExecutionOptions, ToolValidationResult, ToolRegistryEvents, CircuitBreakerState, CircuitBreakerConfig, CircuitBreakerStats, CircuitBreakerEvents, McpRegistry, MCPClientResult, FlexibleValidationResult, } from "./mcpTypes.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, } 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";
@@ -26,5 +26,7 @@ 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";

package/dist/types/index.js

@@ -25,6 +25,10 @@ export * from "./serviceTypes.js";
 export * from "./evaluationProviders.js";
 // SDK Types - Core types for external developers
 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

package/dist/types/mcpTypes.d.ts

@@ -163,6 +163,22 @@ export type MCPToolMetadata = {
  * MCP Server Registry Entry - For Object.entries() usage
  */
 export type MCPServerRegistryEntry = [string, MCPServerInfo];
+export type MCPStatus = {
+    mcpInitialized: boolean;
+    totalServers: number;
+    availableServers: number;
+    autoDiscoveredCount: number;
+    totalTools: number;
+    autoDiscoveredServers: MCPServerInfo[];
+    customToolsCount: number;
+    inMemoryServersCount: number;
+    externalMCPServersCount?: number;
+    externalMCPConnectedCount?: number;
+    externalMCPFailedCount?: number;
+    externalMCPServers?: MCPServerInfo[];
+    error?: string;
+    [key: string]: unknown;
+};
 /**
  * Call record for circuit breaker statistics tracking
  * Extracted from mcpCircuitBreaker.ts for centralized type management
@@ -342,18 +358,6 @@ export type McpMetadata = {
     repository?: string;
     category?: string;
 };
-/**
- * Provider status information
- * Moved from src/lib/mcp/contracts/mcpContract.ts
- */
-export type ProviderStatus = {
-    available: boolean;
-    lastCheck: number;
-    reason?: string;
-    model?: string;
-    cost?: number;
-    latencyMs?: number;
-};
 /**
  * Tool discovery result
  * Moved from src/lib/mcp/toolDiscoveryService.ts

package/dist/types/modelTypes.d.ts

@@ -4,6 +4,7 @@
  */
 import { z } from "zod";
 import type { JsonValue } from "./common.js";
+import { AIProviderName } from "../constants/enums.js";
 /**
  * Model performance tier definition
  */
@@ -200,43 +201,130 @@ export type DynamicModelConfig = z.infer<typeof ModelConfigSchema>;
  */
 export type ModelRegistry = z.infer<typeof ModelRegistrySchema>;
 /**
- * Model name constants structure
+ * Model capabilities interface
  */
-export type ModelNameConstants = {
-    readonly [provider: string]: {
-        readonly FAST: string;
-        readonly BALANCED: string;
-        readonly QUALITY: string;
-    };
+export type ModelCapabilities = {
+    vision: boolean;
+    functionCalling: boolean;
+    codeGeneration: boolean;
+    reasoning: boolean;
+    multimodal: boolean;
+    streaming: boolean;
+    jsonMode: boolean;
 };
 /**
- * Model metadata for registry
+ * Model pricing information
  */
-export type ModelMetadata = {
-    version: string;
-    lastUpdated: string;
-    modelCount: number;
+export type ModelPricingInfo = {
+    inputCostPer1K: number;
+    outputCostPer1K: number;
+    currency: string;
+};
+/**
+ * Model performance characteristics
+ */
+export type ModelPerformance = {
+    speed: "fast" | "medium" | "slow";
+    quality: "high" | "medium" | "low";
+    accuracy: "high" | "medium" | "low";
 };
 /**
- * Model search options
+ * Model limitations and constraints
  */
-export type ModelSearchOptions = {
-    provider?: string;
-    maxPrice?: number;
-    excludeDeprecated?: boolean;
+export type ModelLimits = {
+    maxContextTokens: number;
+    maxOutputTokens: number;
+    maxRequestsPerMinute?: number;
+    maxRequestsPerDay?: number;
+};
+/**
+ * Use case suitability scores (1-10 scale)
+ */
+export type UseCaseSuitability = {
+    coding: number;
+    creative: number;
+    analysis: number;
+    conversation: number;
+    reasoning: number;
+    translation: number;
+    summarization: number;
+};
+/**
+ * Complete model information
+ */
+export type ModelInfo = {
+    id: string;
+    name: string;
+    provider: AIProviderName;
+    description: string;
+    capabilities: ModelCapabilities;
+    pricing: ModelPricingInfo;
+    performance: ModelPerformance;
+    limits: ModelLimits;
+    useCases: UseCaseSuitability;
+    aliases: string[];
+    deprecated: boolean;
+    isLocal: boolean;
+    releaseDate?: string;
+    category: "general" | "coding" | "creative" | "vision" | "reasoning";
 };
 /**
- * Model search result
+ * Model search filters
+ */
+export type ModelSearchFilters = {
+    provider?: AIProviderName | AIProviderName[];
+    capability?: keyof ModelCapabilities | (keyof ModelCapabilities)[];
+    useCase?: keyof UseCaseSuitability;
+    maxCost?: number;
+    minContextSize?: number;
+    maxContextSize?: number;
+    performance?: ModelPerformance["speed"] | ModelPerformance["quality"];
+    category?: ModelInfo["category"] | ModelInfo["category"][];
+};
+/**
+ * Model search result with ranking
  */
 export type ModelSearchResult = {
-    provider: string;
-    model: string;
-    config: DynamicModelConfig;
+    model: ModelInfo;
+    score: number;
+    matchReasons: string[];
+};
+/**
+ * Model recommendation context
+ */
+export type RecommendationContext = {
+    useCase?: keyof UseCaseSuitability;
+    maxCost?: number;
+    minQuality?: "low" | "medium" | "high";
+    requireCapabilities?: (keyof ModelCapabilities)[];
+    excludeProviders?: AIProviderName[];
+    contextSize?: number;
+    preferLocal?: boolean;
 };
 /**
- * Cost information structure
+ * Model recommendation result
  */
-export type CostInfo = {
-    input: number;
-    output: number;
+export type ModelRecommendation = {
+    model: ModelInfo;
+    score: number;
+    reasoning: string[];
+    alternatives: ModelInfo[];
+};
+/**
+ * Model comparison result
+ */
+export type ModelComparison = {
+    models: ModelInfo[];
+    comparison: {
+        capabilities: Record<keyof ModelCapabilities, ModelInfo[]>;
+        pricing: {
+            cheapest: ModelInfo;
+            mostExpensive: ModelInfo;
+        };
+        performance: Record<string, ModelInfo[]>;
+        contextSize: {
+            largest: ModelInfo;
+            smallest: ModelInfo;
+        };
+    };
 };

package/dist/types/modelTypes.js

@@ -3,6 +3,7 @@
  * Consolidates all model configuration, dynamic model, and provider model types
  */
 import { z } from "zod";
+import { AIProviderName } from "../constants/enums.js";
 /**
  * Zod schema for model configuration validation
  */

package/dist/types/observability.d.ts

@@ -6,7 +6,7 @@
 /**
  * Langfuse observability configuration
  */
-export interface LangfuseConfig {
+export type LangfuseConfig = {
     /** Whether Langfuse is enabled */
     enabled: boolean;
     /** Langfuse public key */
@@ -24,11 +24,11 @@ export interface LangfuseConfig {
     environment?: string;
     /** Release/version identifier */
     release?: string;
-}
+};
 /**
  * OpenTelemetry configuration
  */
-export interface OpenTelemetryConfig {
+export type OpenTelemetryConfig = {
     /** Whether OpenTelemetry is enabled */
     enabled: boolean;
     /** OTLP endpoint URL */
@@ -37,13 +37,13 @@ export interface OpenTelemetryConfig {
     serviceName?: string;
     /** Service version */
     serviceVersion?: string;
-}
+};
 /**
  * Complete observability configuration for Neurolink SDK
  */
-export interface ObservabilityConfig {
+export type ObservabilityConfig = {
     /** Langfuse configuration */
     langfuse?: LangfuseConfig;
     /** OpenTelemetry configuration */
     openTelemetry?: OpenTelemetryConfig;
-}
+};

package/dist/types/providers.d.ts

@@ -2,103 +2,12 @@
  * Provider-specific type definitions for NeuroLink
  */
 import type { UnknownRecord, JsonValue } from "./common.js";
+import { AIProviderName, AnthropicModels, BedrockModels, GoogleAIModels, OpenAIModels, VertexModels } from "../constants/enums.js";
 import type { Tool } from "ai";
 import type { ValidationSchema } from "./typeAliases.js";
 import type { EnhancedGenerateResult, GenerateResult, TextGenerationOptions } from "./generateTypes.js";
 import type { StreamOptions, StreamResult } from "./streamTypes.js";
 import type { ExternalMCPToolInfo } from "./externalMcp.js";
-/**
- * Supported AI Provider Names
- */
-export declare enum AIProviderName {
-    BEDROCK = "bedrock",
-    OPENAI = "openai",
-    OPENAI_COMPATIBLE = "openai-compatible",
-    VERTEX = "vertex",
-    ANTHROPIC = "anthropic",
-    AZURE = "azure",
-    GOOGLE_AI = "google-ai",
-    HUGGINGFACE = "huggingface",
-    OLLAMA = "ollama",
-    MISTRAL = "mistral",
-    LITELLM = "litellm",
-    SAGEMAKER = "sagemaker",
-    AUTO = "auto"
-}
-/**
- * Supported Models for Amazon Bedrock
- */
-export declare enum BedrockModels {
-    CLAUDE_3_SONNET = "anthropic.claude-3-sonnet-20240229-v1:0",
-    CLAUDE_3_HAIKU = "anthropic.claude-3-haiku-20240307-v1:0",
-    CLAUDE_3_5_SONNET = "anthropic.claude-3-5-sonnet-20240620-v1:0",
-    CLAUDE_3_7_SONNET = "arn:aws:bedrock:us-east-2:225681119357:inference-profile/us.anthropic.claude-3-7-sonnet-20250219-v1:0"
-}
-/**
- * Supported Models for OpenAI
- */
-export declare enum OpenAIModels {
-    GPT_4 = "gpt-4",
-    GPT_4_TURBO = "gpt-4-turbo",
-    GPT_4O = "gpt-4o",
-    GPT_4O_MINI = "gpt-4o-mini",
-    GPT_3_5_TURBO = "gpt-3.5-turbo",
-    O1_PREVIEW = "o1-preview",
-    O1_MINI = "o1-mini"
-}
-/**
- * Supported Models for Google Vertex AI
- */
-export declare enum VertexModels {
-    CLAUDE_4_0_SONNET = "claude-sonnet-4@20250514",
-    CLAUDE_4_0_OPUS = "claude-opus-4@20250514",
-    CLAUDE_3_5_SONNET = "claude-3-5-sonnet-20241022",
-    CLAUDE_3_5_HAIKU = "claude-3-5-haiku-20241022",
-    CLAUDE_3_SONNET = "claude-3-sonnet-20240229",
-    CLAUDE_3_OPUS = "claude-3-opus-20240229",
-    CLAUDE_3_HAIKU = "claude-3-haiku-20240307",
-    GEMINI_2_5_PRO = "gemini-2.5-pro",
-    GEMINI_2_5_FLASH = "gemini-2.5-flash",
-    GEMINI_2_5_FLASH_LITE = "gemini-2.5-flash-lite",
-    GEMINI_2_0_FLASH_001 = "gemini-2.0-flash-001",
-    GEMINI_1_5_PRO = "gemini-1.5-pro",
-    GEMINI_1_5_FLASH = "gemini-1.5-flash"
-}
-/**
- * Supported Models for Google AI Studio
- */
-export declare enum GoogleAIModels {
-    GEMINI_2_5_PRO = "gemini-2.5-pro",
-    GEMINI_2_5_FLASH = "gemini-2.5-flash",
-    GEMINI_2_5_FLASH_LITE = "gemini-2.5-flash-lite",
-    GEMINI_2_0_FLASH_001 = "gemini-2.0-flash-001",
-    GEMINI_1_5_PRO = "gemini-1.5-pro",
-    GEMINI_1_5_FLASH = "gemini-1.5-flash",
-    GEMINI_1_5_FLASH_LITE = "gemini-1.5-flash-lite"
-}
-/**
- * Supported Models for Anthropic (Direct API)
- */
-export declare enum AnthropicModels {
-    CLAUDE_3_5_SONNET = "claude-3-5-sonnet-20241022",
-    CLAUDE_3_5_HAIKU = "claude-3-5-haiku-20241022",
-    CLAUDE_3_SONNET = "claude-3-sonnet-20240229",
-    CLAUDE_3_OPUS = "claude-3-opus-20240229",
-    CLAUDE_3_HAIKU = "claude-3-haiku-20240307"
-}
-/**
- * API Versions for various providers
- */
-export declare enum APIVersions {
-    AZURE_LATEST = "2025-04-01-preview",
-    AZURE_STABLE = "2024-10-21",
-    AZURE_LEGACY = "2023-12-01-preview",
-    OPENAI_CURRENT = "v1",
-    OPENAI_BETA = "v1-beta",
-    GOOGLE_AI_CURRENT = "v1",
-    GOOGLE_AI_BETA = "v1beta",
-    ANTHROPIC_CURRENT = "2023-06-01"
-}
 /**
  * Generic AI SDK model interface
  */
@@ -112,7 +21,19 @@ export type SupportedModelName = BedrockModels | OpenAIModels | VertexModels | G
 /**
  * Extract provider names from enum
  */
-export type ProviderName = keyof typeof AIProviderName;
+export type ProviderName = (typeof AIProviderName)[keyof typeof AIProviderName];
+/**
+ * Provider status information
+ */
+export type ProviderStatus = {
+    provider: string;
+    status: "working" | "failed" | "not-configured";
+    configured: boolean;
+    authenticated: boolean;
+    error?: string;
+    responseTime?: number;
+    model?: string;
+};
 /**
  * Provider error information
  */
@@ -344,6 +265,16 @@ export type ProviderRegistration = {
     capabilities?: ProviderCapabilities;
     defaultConfig?: IndividualProviderConfig;
 };
+/**
+ * Configuration options for the provider registry
+ */
+export type ProviderRegistryOptions = {
+    /**
+     * Enable loading of manual MCP configurations from .mcp-config.json
+     * Should only be true for CLI mode, false for SDK mode
+     */
+    enableManualMCP?: boolean;
+};
 /**
  * Provider metadata type
  */
@@ -1060,6 +991,25 @@ export type SageMakerGenerateResult = {
     toolCalls?: SageMakerToolCall[];
     object?: unknown;
 };
+export type ProviderHealthStatusOptions = {
+    provider: AIProviderName;
+    isHealthy: boolean;
+    isConfigured: boolean;
+    hasApiKey: boolean;
+    lastChecked: Date;
+    error?: string;
+    warning?: string;
+    responseTime?: number;
+    configurationIssues: string[];
+    recommendations: string[];
+};
+export type ProviderHealthCheckOptions = {
+    timeout?: number;
+    includeConnectivityTest?: boolean;
+    includeModelValidation?: boolean;
+    cacheResults?: boolean;
+    maxCacheAge?: number;
+};
 /**
  * Amazon Bedrock specific types
  */