@juspay/neurolink 7.33.0 → 7.33.1

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

@@ -2,45 +2,115 @@
  * Provider-specific type definitions for NeuroLink
  */
 import type { UnknownRecord, JsonValue } from "./common.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";
 /**
  * Generic AI SDK model interface
  */
-export interface AISDKModel {
+export type AISDKModel = {
     [key: string]: unknown;
+};
+/**
+ * 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"
 }
 /**
- * Provider error information
+ * Supported Models for Amazon Bedrock
  */
-export interface ProviderError extends Error {
-    code?: string | number;
-    statusCode?: number;
-    provider?: string;
-    originalError?: unknown;
+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"
 }
 /**
- * Token usage information
+ * Supported Models for OpenAI
  */
-export interface TokenUsage {
-    input: number;
-    output: number;
-    total: number;
+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"
 }
 /**
- * Analytics data structure
+ * Supported Models for Google Vertex AI
  */
-export interface AnalyticsData {
-    provider: string;
-    model?: string;
-    tokenUsage: TokenUsage;
-    requestDuration: number;
-    timestamp: string;
-    cost?: number;
-    context?: JsonValue;
+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"
+}
+/**
+ * Union type of all supported model names
+ */
+export type SupportedModelName = BedrockModels | OpenAIModels | VertexModels | GoogleAIModels | AnthropicModels;
+/**
+ * Extract provider names from enum
+ */
+export type ProviderName = keyof typeof AIProviderName;
+/**
+ * Provider error information
+ */
+export type ProviderError = Error & {
+    code?: string | number;
+    statusCode?: number;
+    provider?: string;
+    originalError?: unknown;
+};
 /**
  * AWS Credential Configuration for Bedrock provider
  */
-export interface AWSCredentialConfig {
+export type AWSCredentialConfig = {
     region?: string;
     profile?: string;
     roleArn?: string;
@@ -53,11 +123,11 @@ export interface AWSCredentialConfig {
     enableDebugLogging?: boolean;
     /** Optional service endpoint override (e.g., VPC/Gov endpoints) */
     endpoint?: string;
-}
+};
 /**
  * AWS Credential Validation Result
  */
-export interface CredentialValidationResult {
+export type CredentialValidationResult = {
     isValid: boolean;
     credentialSource: string;
     region: string;
@@ -69,17 +139,17 @@ export interface CredentialValidationResult {
         hasSessionToken: boolean;
         providerConfig: Readonly<Required<AWSCredentialConfig>>;
     };
-}
+};
 /**
  * Service Connectivity Test Result
  */
-export interface ServiceConnectivityResult {
+export type ServiceConnectivityResult = {
     bedrockAccessible: boolean;
     availableModels: number;
     responseTimeMs: number;
     error?: string;
     sampleModels: string[];
-}
+};
 /**
  * Model Capabilities - Maximally Reusable
  */
@@ -88,10 +158,18 @@ export type ModelCapability = "text" | "vision" | "function-calling" | "embeddin
  * Model Use Cases - High Reusability
  */
 export type ModelUseCase = "chat" | "completion" | "analysis" | "coding" | "creative" | "reasoning" | "translation" | "summarization" | "classification";
+/**
+ * Provider health status
+ */
+export type ProviderHealthStatus = "healthy" | "degraded" | "unhealthy" | "unknown";
+/**
+ * Stream processing phases
+ */
+export type StreamPhase = "initializing" | "streaming" | "processing" | "complete" | "error";
 /**
  * Model Filter Configuration - High Reusability
  */
-export interface ModelFilter {
+export type ModelFilter = {
     provider?: string;
     capability?: ModelCapability;
     useCase?: ModelUseCase;
@@ -99,11 +177,11 @@ export interface ModelFilter {
     requireFunctionCalling?: boolean;
     maxTokens?: number;
     costLimit?: number;
-}
+};
 /**
  * Model Resolution Context - High Reusability
  */
-export interface ModelResolutionContext {
+export type ModelResolutionContext = {
     requireCapabilities?: ModelCapability[];
     preferredProviders?: string[];
     useCase?: ModelUseCase;
@@ -115,11 +193,11 @@ export interface ModelResolutionContext {
         maxLatency?: number;
         minQuality?: number;
     };
-}
+};
 /**
  * Model Statistics Object - High Reusability
  */
-export interface ModelStats {
+export type ModelStats = {
     name: string;
     provider: string;
     capabilities: ModelCapability[];
@@ -136,11 +214,11 @@ export interface ModelStats {
         version?: string;
         lastUpdated?: Date;
     };
-}
+};
 /**
  * Model Pricing Information - High Reusability
  */
-export interface ModelPricing {
+export type ModelPricing = {
     inputTokens?: {
         price: number;
         currency: string;
@@ -160,107 +238,67 @@ export interface ModelPricing {
     min?: number;
     max?: number;
     free?: boolean;
-}
-/**
- * Response quality evaluation scores - Comprehensive evaluation interface
- */
-export interface EvaluationData {
-    relevance: number;
-    accuracy: number;
-    completeness: number;
-    overall: number;
-    domainAlignment?: number;
-    terminologyAccuracy?: number;
-    toolEffectiveness?: number;
-    isOffTopic: boolean;
-    alertSeverity: "low" | "medium" | "high" | "none";
-    reasoning: string;
-    suggestedImprovements?: string;
-    evaluationModel: string;
-    evaluationTime: number;
-    evaluationDomain?: string;
-    evaluationProvider?: string;
-    evaluationAttempt?: number;
-    evaluationConfig?: {
-        mode: string;
-        fallbackUsed: boolean;
-        costEstimate: number;
-    };
-    domainConfig?: {
-        domainName: string;
-        domainDescription: string;
-        keyTerms: string[];
-        failurePatterns: string[];
-        successPatterns: string[];
-        evaluationCriteria?: Record<string, unknown>;
-    };
-    domainEvaluation?: {
-        domainRelevance: number;
-        terminologyAccuracy: number;
-        domainExpertise: number;
-        domainSpecificInsights: string[];
-    };
-}
-/**
- * Enhanced evaluation context for comprehensive response assessment
- */
-export interface EvaluationContext {
-    userQuery: string;
-    aiResponse: string;
-    context?: Record<string, unknown>;
-    primaryDomain?: string;
-    assistantRole?: string;
-    conversationHistory?: Array<{
-        role: "user" | "assistant";
-        content: string;
-        timestamp?: string;
-    }>;
-    toolUsage?: Array<{
-        toolName: string;
-        input: unknown;
-        output: unknown;
-        executionTime: number;
-    }>;
-    expectedOutcome?: string;
-    evaluationCriteria?: string[];
-}
-/**
- * Evaluation result interface that extends EvaluationData with additional context
- */
-export interface EvaluationResult extends EvaluationData {
-    contextUtilization?: {
-        conversationUsed: boolean;
-        toolsUsed: boolean;
-        domainKnowledgeUsed: boolean;
-    };
-    evaluationContext?: {
-        domain: string;
-        toolsEvaluated: string[];
-        conversationTurns: number;
-    };
-}
+};
 /**
  * Provider capabilities
  */
-export interface ProviderCapabilities {
+export type ProviderCapabilities = {
     supportsStreaming: boolean;
     supportsTools: boolean;
     supportsImages: boolean;
     supportsAudio: boolean;
     maxTokens?: number;
     supportedModels: string[];
-}
+};
 /**
- * Provider configuration
+ * Provider configuration specifying provider and its available models (from core types)
  */
-export interface ProviderConfig {
+export type ProviderConfig = {
+    provider: AIProviderName;
+    models: SupportedModelName[];
+};
+/**
+ * Provider configuration for individual providers
+ */
+export type IndividualProviderConfig = {
     apiKey?: string;
     baseURL?: string;
     timeout?: number;
     retries?: number;
     model?: string;
     [key: string]: unknown;
-}
+};
+/**
+ * AI Provider interface with flexible parameter support (converted from interface)
+ */
+export type AIProvider = {
+    stream(optionsOrPrompt: StreamOptions | string, analysisSchema?: ValidationSchema): Promise<StreamResult>;
+    generate(optionsOrPrompt: TextGenerationOptions | string, analysisSchema?: ValidationSchema): Promise<EnhancedGenerateResult | null>;
+    gen(optionsOrPrompt: TextGenerationOptions | string, analysisSchema?: ValidationSchema): Promise<EnhancedGenerateResult | null>;
+    setupToolExecutor(sdk: {
+        customTools: Map<string, unknown>;
+        executeTool: (toolName: string, params: unknown) => Promise<unknown>;
+    }, functionTag: string): void;
+};
+/**
+ * Provider attempt result for iteration tracking (converted from interface)
+ */
+export type ProviderAttempt = {
+    provider: AIProviderName;
+    model: SupportedModelName;
+    success: boolean;
+    error?: string;
+    stack?: string;
+};
+/**
+ * Error types for provider creation
+ */
+export type ProviderCreationError = {
+    code: "INVALID_PROVIDER" | "CONFIGURATION_ERROR" | "INSTANTIATION_ERROR";
+    message: string;
+    provider: string;
+    details?: Record<string, unknown>;
+};
 /**
  * Amazon Bedrock specific types
  */
@@ -321,23 +359,51 @@ export type ProviderFactory = (modelName?: string, providerName?: string, sdk?:
 /**
  * Provider constructor type
  */
-export interface ProviderConstructor {
+export type ProviderConstructor = {
     new (modelName?: string, providerName?: string, sdk?: unknown): unknown;
-}
+};
 /**
  * Provider registration entry
  */
-export interface ProviderRegistration {
+export type ProviderRegistration = {
     name: string;
     constructor: ProviderConstructor | ProviderFactory;
     capabilities?: ProviderCapabilities;
-    defaultConfig?: ProviderConfig;
-}
+    defaultConfig?: IndividualProviderConfig;
+};
 /**
- * Type guard for provider error
+ * Provider metadata type
  */
-export declare function isProviderError(error: unknown): error is ProviderError;
+export type ProviderMetadata = {
+    name: string;
+    version: string;
+    capabilities: ProviderCapability[];
+    models: string[];
+    healthStatus: ProviderHealthStatus;
+};
+/**
+ * Provider capability type
+ */
+export type ProviderCapability = "text-generation" | "streaming" | "tool-calling" | "image-generation" | "embeddings";
+/**
+ * Extended tool type that combines AI SDK tools with external MCP tool info
+ */
+export type ExtendedTool = Tool & Partial<ExternalMCPToolInfo>;
+/**
+ * AI SDK generate result with steps support (extends GenerateResult)
+ */
+export type AISDKGenerateResult = GenerateResult & {
+    steps?: Array<{
+        toolCalls?: Array<{
+            toolName?: string;
+            name?: string;
+            [key: string]: unknown;
+        }>;
+        [key: string]: unknown;
+    }>;
+    [key: string]: unknown;
+};
 /**
- * Type guard for token usage
+ * Default provider configurations
  */
-export declare function isTokenUsage(value: unknown): value is TokenUsage;
+export declare const DEFAULT_PROVIDER_CONFIGS: ProviderConfig[];

package/dist/lib/types/providers.js

@@ -2,21 +2,113 @@
  * Provider-specific type definitions for NeuroLink
  */
 /**
- * Type guard for provider error
- */
-export function isProviderError(error) {
-    return error instanceof Error && "provider" in error;
-}
-/**
- * Type guard for token usage
- */
-export function isTokenUsage(value) {
-    return (typeof value === "object" &&
-        value !== null &&
-        "input" in value &&
-        "output" in value &&
-        "total" in value &&
-        typeof value.input === "number" &&
-        typeof value.output === "number" &&
-        typeof value.total === "number");
-}
+ * 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 || (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 = {}));
+/**
+ * Default provider configurations
+ */
+export const DEFAULT_PROVIDER_CONFIGS = [
+    {
+        provider: AIProviderName.BEDROCK,
+        models: [BedrockModels.CLAUDE_3_7_SONNET, BedrockModels.CLAUDE_3_5_SONNET],
+    },
+    {
+        provider: AIProviderName.VERTEX,
+        models: [VertexModels.CLAUDE_4_0_SONNET, VertexModels.GEMINI_2_5_FLASH],
+    },
+    {
+        provider: AIProviderName.OPENAI,
+        models: [OpenAIModels.GPT_4O, OpenAIModels.GPT_4O_MINI],
+    },
+];

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

@@ -0,0 +1,79 @@
+/**
+ * Service-related type definitions for NeuroLink
+ * Service registry, dependency injection, and service management types
+ */
+import type { UnknownRecord } from "./common.js";
+/**
+ * Service factory function type
+ */
+export type ServiceFactory<T = unknown> = () => T | Promise<T>;
+/**
+ * Service registration configuration
+ */
+export type ServiceRegistration<T = unknown> = {
+    factory: ServiceFactory<T>;
+    singleton: boolean;
+    instance?: T;
+};
+/**
+ * Service definition with metadata and status
+ */
+export type ServiceDefinition<T = UnknownRecord> = {
+    name: string;
+    version: string;
+    instance: T;
+    metadata: ServiceMetadata;
+    status: ServiceStatus;
+};
+/**
+ * Service metadata for describing service capabilities
+ */
+export type ServiceMetadata = {
+    description: string;
+    tags: string[];
+    dependencies: string[];
+    capabilities: string[];
+};
+/**
+ * Service status enumeration
+ */
+export type ServiceStatus = "active" | "inactive" | "error" | "initializing";
+/**
+ * Service health information
+ */
+export type ServiceHealth = {
+    status: ServiceStatus;
+    lastChecked: Date;
+    uptime: number;
+    errorCount: number;
+    dependencies: ServiceDependencyHealth[];
+};
+/**
+ * Service dependency health status
+ */
+export type ServiceDependencyHealth = {
+    name: string;
+    status: ServiceStatus;
+    lastChecked: Date;
+    responseTime?: number;
+};
+/**
+ * Service configuration options
+ */
+export type ServiceConfigOptions = {
+    singleton?: boolean;
+    lazy?: boolean;
+    timeout?: number;
+    retries?: number;
+    dependencies?: string[];
+};
+/**
+ * Service registry statistics
+ */
+export type ServiceRegistryStats = {
+    totalServices: number;
+    activeServices: number;
+    failedServices: number;
+    initializingServices: number;
+    circularDependencies: string[][];
+};

package/dist/lib/types/serviceTypes.js

@@ -0,0 +1,5 @@
+/**
+ * Service-related type definitions for NeuroLink
+ * Service registry, dependency injection, and service management types
+ */
+export {};