@juspay/neurolink 7.33.1 → 7.33.3

package/dist/neurolink.js

@@ -16,6 +16,7 @@ catch {
 import { AIProviderFactory } from "./core/factory.js";
 import { mcpLogger } from "./utils/logger.js";
 import { SYSTEM_LIMITS } from "./core/constants.js";
+import { NANOSECOND_TO_MS_DIVISOR, MCP_TIMEOUTS, SERVER_CONFIG, TOOL_TIMEOUTS, RETRY_ATTEMPTS, RETRY_DELAYS, CIRCUIT_BREAKER, CIRCUIT_BREAKER_RESET_MS, MEMORY_THRESHOLDS, PROVIDER_TIMEOUTS, PERFORMANCE_THRESHOLDS, } from "./constants/index.js";
 import pLimit from "p-limit";
 import { toolRegistry } from "./mcp/toolRegistry.js";
 import { logger } from "./utils/logger.js";
@@ -164,7 +165,7 @@ export class NeuroLink {
                 elapsedMs: Date.now() - constructorStartTime,
                 elapsedNs: (process.hrtime.bigint() - constructorHrTimeStart).toString(),
                 registrySetupDurationNs: registrySetupDurationNs.toString(),
-                registrySetupDurationMs: Number(registrySetupDurationNs) / 1000000,
+                registrySetupDurationMs: Number(registrySetupDurationNs) / NANOSECOND_TO_MS_DIVISOR,
                 enableManualMCP: false,
                 message: "ProviderRegistry configured successfully with security settings",
             });
@@ -179,7 +180,7 @@ export class NeuroLink {
                 elapsedMs: Date.now() - constructorStartTime,
                 elapsedNs: (process.hrtime.bigint() - constructorHrTimeStart).toString(),
                 registrySetupDurationNs: registrySetupDurationNs.toString(),
-                registrySetupDurationMs: Number(registrySetupDurationNs) / 1000000,
+                registrySetupDurationMs: Number(registrySetupDurationNs) / NANOSECOND_TO_MS_DIVISOR,
                 error: error instanceof Error ? error.message : String(error),
                 errorName: error instanceof Error ? error.name : "UnknownError",
                 errorStack: error instanceof Error ? error.stack : undefined,
@@ -224,9 +225,9 @@ export class NeuroLink {
                     elapsedMs: Date.now() - constructorStartTime,
                     elapsedNs: (process.hrtime.bigint() - constructorHrTimeStart).toString(),
                     memoryInitDurationNs: memoryInitDurationNs.toString(),
-                    memoryInitDurationMs: Number(memoryInitDurationNs) / 1000000,
+                    memoryInitDurationMs: Number(memoryInitDurationNs) / NANOSECOND_TO_MS_DIVISOR,
                     memoryManagerCreateDurationNs: memoryManagerCreateDurationNs.toString(),
-                    memoryManagerCreateDurationMs: Number(memoryManagerCreateDurationNs) / 1000000,
+                    memoryManagerCreateDurationMs: Number(memoryManagerCreateDurationNs) / NANOSECOND_TO_MS_DIVISOR,
                     finalMemoryConfig: {
                         maxSessions: memoryConfig.maxSessions,
                         maxTurnsPerSession: memoryConfig.maxTurnsPerSession,
@@ -245,7 +246,7 @@ export class NeuroLink {
                     elapsedMs: Date.now() - constructorStartTime,
                     elapsedNs: (process.hrtime.bigint() - constructorHrTimeStart).toString(),
                     memoryInitDurationNs: memoryInitDurationNs.toString(),
-                    memoryInitDurationMs: Number(memoryInitDurationNs) / 1000000,
+                    memoryInitDurationMs: Number(memoryInitDurationNs) / NANOSECOND_TO_MS_DIVISOR,
                     error: error instanceof Error ? error.message : String(error),
                     errorName: error instanceof Error ? error.name : "UnknownError",
                     errorStack: error instanceof Error ? error.stack : undefined,
@@ -289,8 +290,8 @@ export class NeuroLink {
             elapsedNs: (process.hrtime.bigint() - constructorHrTimeStart).toString(),
             externalServerInitStartTimeNs: externalServerInitStartTime.toString(),
             serverManagerConfig: {
-                maxServers: 20,
-                defaultTimeout: 15000,
+                maxServers: SERVER_CONFIG.MAX_MCP_SERVERS,
+                defaultTimeout: MCP_TIMEOUTS.EXTERNAL_SERVER_STARTUP_MS,
                 enableAutoRestart: true,
                 enablePerformanceMonitoring: true,
             },
@@ -317,7 +318,7 @@ export class NeuroLink {
                 elapsedMs: Date.now() - constructorStartTime,
                 elapsedNs: (process.hrtime.bigint() - constructorHrTimeStart).toString(),
                 externalServerInitDurationNs: externalServerInitDurationNs.toString(),
-                externalServerInitDurationMs: Number(externalServerInitDurationNs) / 1000000,
+                externalServerInitDurationMs: Number(externalServerInitDurationNs) / NANOSECOND_TO_MS_DIVISOR,
                 hasExternalServerManager: !!this.externalServerManager,
                 message: "External server manager initialized successfully",
             });
@@ -333,7 +334,7 @@ export class NeuroLink {
                 elapsedMs: Date.now() - constructorStartTime,
                 elapsedNs: (process.hrtime.bigint() - constructorHrTimeStart).toString(),
                 externalServerInitDurationNs: externalServerInitDurationNs.toString(),
-                externalServerInitDurationMs: Number(externalServerInitDurationNs) / 1000000,
+                externalServerInitDurationMs: Number(externalServerInitDurationNs) / NANOSECOND_TO_MS_DIVISOR,
                 error: error instanceof Error ? error.message : String(error),
                 errorName: error instanceof Error ? error.name : "UnknownError",
                 errorStack: error instanceof Error ? error.stack : undefined,
@@ -418,7 +419,7 @@ export class NeuroLink {
             elapsedMs: Date.now() - constructorStartTime,
             elapsedNs: (process.hrtime.bigint() - constructorHrTimeStart).toString(),
             eventHandlerSetupDurationNs: eventHandlerSetupDurationNs.toString(),
-            eventHandlerSetupDurationMs: Number(eventHandlerSetupDurationNs) / 1000000,
+            eventHandlerSetupDurationMs: Number(eventHandlerSetupDurationNs) / NANOSECOND_TO_MS_DIVISOR,
             eventHandlersCount: 5,
             eventHandlerTypes: [
                 "connected",
@@ -441,7 +442,7 @@ export class NeuroLink {
             constructorId,
             timestamp: new Date().toISOString(),
             constructorDurationNs: constructorDurationNs.toString(),
-            constructorDurationMs: Number(constructorDurationNs) / 1000000,
+            constructorDurationMs: Number(constructorDurationNs) / NANOSECOND_TO_MS_DIVISOR,
             totalElapsedMs: Date.now() - constructorStartTime,
             finalState: {
                 hasConversationMemory: !!this.conversationMemory,
@@ -542,7 +543,7 @@ export class NeuroLink {
                 elapsedMs: Date.now() - mcpInitStartTime,
                 elapsedNs: (process.hrtime.bigint() - mcpInitHrTimeStart).toString(),
                 performanceImportDurationNs: performanceImportDurationNs.toString(),
-                performanceImportDurationMs: Number(performanceImportDurationNs) / 1000000,
+                performanceImportDurationMs: Number(performanceImportDurationNs) / NANOSECOND_TO_MS_DIVISOR,
                 hasMemoryManager: !!MemoryManager,
                 message: "MemoryManager imported successfully",
             });
@@ -558,7 +559,7 @@ export class NeuroLink {
                 elapsedMs: Date.now() - mcpInitStartTime,
                 elapsedNs: (process.hrtime.bigint() - mcpInitHrTimeStart).toString(),
                 performanceImportDurationNs: performanceImportDurationNs.toString(),
-                performanceImportDurationMs: Number(performanceImportDurationNs) / 1000000,
+                performanceImportDurationMs: Number(performanceImportDurationNs) / NANOSECOND_TO_MS_DIVISOR,
                 error: error instanceof Error ? error.message : String(error),
                 errorName: error instanceof Error ? error.name : "UnknownError",
                 message: "MemoryManager import failed - continuing without performance tracking",
@@ -590,7 +591,7 @@ export class NeuroLink {
      */
     async initializeToolRegistryInternal(mcpInitId, mcpInitStartTime, mcpInitHrTimeStart) {
         const toolRegistryStartTime = process.hrtime.bigint();
-        const initTimeout = 3000;
+        const initTimeout = MCP_TIMEOUTS.INITIALIZATION_MS;
         logger.debug(`[NeuroLink] ⏱️ LOG_POINT_M007_TOOL_REGISTRY_TIMEOUT_SETUP`, {
             logPoint: "M007_TOOL_REGISTRY_TIMEOUT_SETUP",
             mcpInitId,
@@ -616,7 +617,7 @@ export class NeuroLink {
             elapsedMs: Date.now() - mcpInitStartTime,
             elapsedNs: (process.hrtime.bigint() - mcpInitHrTimeStart).toString(),
             toolRegistryDurationNs: toolRegistryDurationNs.toString(),
-            toolRegistryDurationMs: Number(toolRegistryDurationNs) / 1000000,
+            toolRegistryDurationMs: Number(toolRegistryDurationNs) / NANOSECOND_TO_MS_DIVISOR,
             message: "Tool registry initialization completed within timeout",
         });
     }
@@ -644,7 +645,7 @@ export class NeuroLink {
             elapsedMs: Date.now() - mcpInitStartTime,
             elapsedNs: (process.hrtime.bigint() - mcpInitHrTimeStart).toString(),
             providerRegistryDurationNs: providerRegistryDurationNs.toString(),
-            providerRegistryDurationMs: Number(providerRegistryDurationNs) / 1000000,
+            providerRegistryDurationMs: Number(providerRegistryDurationNs) / NANOSECOND_TO_MS_DIVISOR,
             message: "Provider registry registration completed successfully",
         });
     }
@@ -674,7 +675,7 @@ export class NeuroLink {
                 elapsedMs: Date.now() - mcpInitStartTime,
                 elapsedNs: (process.hrtime.bigint() - mcpInitHrTimeStart).toString(),
                 directToolsDurationNs: directToolsDurationNs.toString(),
-                directToolsDurationMs: Number(directToolsDurationNs) / 1000000,
+                directToolsDurationMs: Number(directToolsDurationNs) / NANOSECOND_TO_MS_DIVISOR,
                 serverId: "neurolink-direct",
                 message: "Direct tools server registered successfully",
             });
@@ -692,7 +693,7 @@ export class NeuroLink {
                 elapsedMs: Date.now() - mcpInitStartTime,
                 elapsedNs: (process.hrtime.bigint() - mcpInitHrTimeStart).toString(),
                 directToolsDurationNs: directToolsDurationNs.toString(),
-                directToolsDurationMs: Number(directToolsDurationNs) / 1000000,
+                directToolsDurationMs: Number(directToolsDurationNs) / NANOSECOND_TO_MS_DIVISOR,
                 error: error instanceof Error ? error.message : String(error),
                 errorName: error instanceof Error ? error.name : "UnknownError",
                 errorStack: error instanceof Error ? error.stack : undefined,
@@ -705,7 +706,7 @@ export class NeuroLink {
         }
     }
     /**
-     * Load MCP configuration from .mcp-config.json
+     * Load MCP configuration from .mcp-config.json with parallel loading for improved performance
      */
     async loadMCPConfigurationInternal(mcpInitId, mcpInitStartTime, mcpInitHrTimeStart) {
         const mcpConfigStartTime = process.hrtime.bigint();
@@ -720,7 +721,8 @@ export class NeuroLink {
             message: "Starting MCP configuration loading from .mcp-config.json",
         });
         try {
-            const configResult = await this.externalServerManager.loadMCPConfiguration();
+            const configResult = await this.externalServerManager.loadMCPConfiguration(undefined, // Use default config path
+            { parallel: true });
             const mcpConfigSuccessTime = process.hrtime.bigint();
             const mcpConfigDurationNs = mcpConfigSuccessTime - mcpConfigStartTime;
             logger.debug(`[NeuroLink] ✅ LOG_POINT_M015_MCP_CONFIG_SUCCESS`, {
@@ -730,7 +732,7 @@ export class NeuroLink {
                 elapsedMs: Date.now() - mcpInitStartTime,
                 elapsedNs: (process.hrtime.bigint() - mcpInitHrTimeStart).toString(),
                 mcpConfigDurationNs: mcpConfigDurationNs.toString(),
-                mcpConfigDurationMs: Number(mcpConfigDurationNs) / 1000000,
+                mcpConfigDurationMs: Number(mcpConfigDurationNs) / NANOSECOND_TO_MS_DIVISOR,
                 serversLoaded: configResult.serversLoaded,
                 errorsCount: configResult.errors.length,
                 configResult: {
@@ -773,7 +775,7 @@ export class NeuroLink {
             initTime: `${initTime}ms`,
             memoryUsed: `${memoryDelta}MB`,
         });
-        if (memoryDelta > 30) {
+        if (memoryDelta > MEMORY_THRESHOLDS.MODERATE_USAGE_MB) {
             mcpLogger.debug("💡 Memory cleanup suggestion: MCP initialization used significant memory. Consider calling MemoryManager.forceGC() after heavy operations.");
         }
     }
@@ -1119,7 +1121,7 @@ export class NeuroLink {
                 elapsedMs: Date.now() - generateInternalStartTime,
                 elapsedNs: (process.hrtime.bigint() - generateInternalHrTimeStart).toString(),
                 conversationMemoryDurationNs: conversationMemoryDurationNs.toString(),
-                conversationMemoryDurationMs: Number(conversationMemoryDurationNs) / 1000000,
+                conversationMemoryDurationMs: Number(conversationMemoryDurationNs) / NANOSECOND_TO_MS_DIVISOR,
                 message: "Conversation memory initialization completed successfully",
             });
         }
@@ -1164,7 +1166,7 @@ export class NeuroLink {
      * Perform MCP generation with retry logic
      */
     async performMCPGenerationRetries(options, generateInternalId, generateInternalStartTime, generateInternalHrTimeStart, functionTag) {
-        const maxMcpRetries = 2;
+        const maxMcpRetries = RETRY_ATTEMPTS.QUICK;
         const mcpRetryLoopStartTime = process.hrtime.bigint();
         logger.debug(`[NeuroLink] 🔄 LOG_POINT_G006_MCP_RETRY_LOOP_START`, {
             logPoint: "G006_MCP_RETRY_LOOP_START",
@@ -1206,7 +1208,7 @@ export class NeuroLink {
                     elapsedMs: Date.now() - generateInternalStartTime,
                     elapsedNs: (process.hrtime.bigint() - generateInternalHrTimeStart).toString(),
                     mcpAttemptDurationNs: mcpAttemptDurationNs.toString(),
-                    mcpAttemptDurationMs: Number(mcpAttemptDurationNs) / 1000000,
+                    mcpAttemptDurationMs: Number(mcpAttemptDurationNs) / NANOSECOND_TO_MS_DIVISOR,
                     currentAttempt: attempt,
                     resultAnalysis: {
                         hasResult: !!mcpResult,
@@ -1325,7 +1327,7 @@ export class NeuroLink {
                 elapsedMs: Date.now() - tryMCPStartTime,
                 elapsedNs: (process.hrtime.bigint() - tryMCPHrTimeStart).toString(),
                 mcpInitCheckDurationNs: mcpInitCheckDurationNs.toString(),
-                mcpInitCheckDurationMs: Number(mcpInitCheckDurationNs) / 1000000,
+                mcpInitCheckDurationMs: Number(mcpInitCheckDurationNs) / NANOSECOND_TO_MS_DIVISOR,
                 mcpInitializedAfter: this.mcpInitialized,
                 initializationSuccessful: this.mcpInitialized,
                 message: "MCP initialization check completed",
@@ -1781,7 +1783,7 @@ export class NeuroLink {
                 elapsedMs: Date.now() - startTime,
                 elapsedNs: (process.hrtime.bigint() - hrTimeStart).toString(),
                 validationDurationNs: validationDurationNs.toString(),
-                validationDurationMs: Number(validationDurationNs) / 1000000,
+                validationDurationMs: Number(validationDurationNs) / NANOSECOND_TO_MS_DIVISOR,
                 validationError: "Stream options must include either input.text or input.audio",
                 message: "EXHAUSTIVE validation failure analysis with character-level debugging",
             });
@@ -1796,7 +1798,7 @@ export class NeuroLink {
             elapsedMs: Date.now() - startTime,
             elapsedNs: (process.hrtime.bigint() - hrTimeStart).toString(),
             validationDurationNs: validationDurationNs.toString(),
-            validationDurationMs: Number(validationDurationNs) / 1000000,
+            validationDurationMs: Number(validationDurationNs) / NANOSECOND_TO_MS_DIVISOR,
             inputTextValid: hasText,
             inputAudioPresent: hasAudio,
             inputTextLength: hasText ? options.input.text.length : 0,
@@ -2314,16 +2316,16 @@ export class NeuroLink {
         this.emitter.emit("tool:start", toolName, params);
         // Set default options
         const finalOptions = {
-            timeout: options?.timeout || 30000, // 30 second default timeout
-            maxRetries: options?.maxRetries || 2, // Default 2 retries for retriable errors
-            retryDelayMs: options?.retryDelayMs || 1000, // 1 second delay between retries
+            timeout: options?.timeout || TOOL_TIMEOUTS.EXECUTION_DEFAULT_MS, // 30 second default timeout
+            maxRetries: options?.maxRetries || RETRY_ATTEMPTS.DEFAULT, // Default 2 retries for retriable errors
+            retryDelayMs: options?.retryDelayMs || RETRY_DELAYS.BASE_MS, // 1 second delay between retries
         };
         // Track memory usage for tool execution
         const { MemoryManager } = await import("./utils/performance.js");
         const startMemory = MemoryManager.getMemoryUsageMB();
         // Get or create circuit breaker for this tool
         if (!this.toolCircuitBreakers.has(toolName)) {
-            this.toolCircuitBreakers.set(toolName, new CircuitBreaker(5, 60000)); // 5 failures, 1 minute timeout
+            this.toolCircuitBreakers.set(toolName, new CircuitBreaker(CIRCUIT_BREAKER.FAILURE_THRESHOLD, CIRCUIT_BREAKER_RESET_MS));
         }
         const circuitBreaker = this.toolCircuitBreakers.get(toolName);
         // Initialize metrics for this tool if not exists
@@ -2646,10 +2648,10 @@ export class NeuroLink {
             // Check memory usage after tool enumeration
             const endMemory = MemoryManager.getMemoryUsageMB();
             const memoryDelta = endMemory.heapUsed - startMemory.heapUsed;
-            if (memoryDelta > 10) {
+            if (memoryDelta > MEMORY_THRESHOLDS.LOW_USAGE_MB) {
                 mcpLogger.debug(`🔍 Tool listing used ${memoryDelta}MB memory (large tool registry detected)`);
                 // Optimized collection patterns should reduce memory usage significantly
-                if (uniqueTools.length > 100) {
+                if (uniqueTools.length > PERFORMANCE_THRESHOLDS.LARGE_TOOL_COLLECTION) {
                     mcpLogger.debug("💡 Tool collection optimized for large sets. Memory usage reduced through efficient object reuse.");
                 }
             }
@@ -2721,7 +2723,7 @@ export class NeuroLink {
                     try {
                         const response = await fetch("http://localhost:11434/api/tags", {
                             method: "GET",
-                            signal: AbortSignal.timeout(2000),
+                            signal: AbortSignal.timeout(PROVIDER_TIMEOUTS.AUTH_MS),
                         });
                         if (!response.ok) {
                             throw new Error("Ollama service not responding");
@@ -3098,7 +3100,7 @@ export class NeuroLink {
     resetToolCircuitBreaker(toolName) {
         if (this.toolCircuitBreakers.has(toolName)) {
             // Create a new circuit breaker (effectively resets it)
-            this.toolCircuitBreakers.set(toolName, new CircuitBreaker(5, 60000));
+            this.toolCircuitBreakers.set(toolName, new CircuitBreaker(CIRCUIT_BREAKER.FAILURE_THRESHOLD, CIRCUIT_BREAKER_RESET_MS));
             mcpLogger.info(`Circuit breaker reset for tool: ${toolName}`);
         }
     }

package/dist/providers/azureOpenai.d.ts

@@ -1,6 +1,6 @@
 import { type LanguageModelV1 } from "ai";
 import { BaseProvider } from "../core/baseProvider.js";
-import type { AIProviderName } from "../types/index.js";
+import type { AIProviderName } from "../core/types.js";
 import type { StreamOptions, StreamResult } from "../types/streamTypes.js";
 export declare class AzureOpenAIProvider extends BaseProvider {
     private apiKey;

package/dist/providers/azureOpenai.js

@@ -1,6 +1,7 @@
 import { createAzure } from "@ai-sdk/azure";
 import { streamText } from "ai";
 import { BaseProvider } from "../core/baseProvider.js";
+import { APIVersions } from "../core/types.js";
 import { validateApiKey, createAzureAPIKeyConfig, createAzureEndpointConfig, } from "../utils/providerConfig.js";
 import { logger } from "../utils/logger.js";
 import { buildMessagesArray } from "../utils/messageBuilder.js";
@@ -24,7 +25,7 @@ export class AzureOpenAIProvider extends BaseProvider {
                 process.env.AZURE_OPENAI_DEPLOYMENT ||
                 process.env.AZURE_OPENAI_DEPLOYMENT_ID ||
                 "gpt-4o";
-        this.apiVersion = process.env.AZURE_API_VERSION || "2024-10-01-preview";
+        this.apiVersion = process.env.AZURE_API_VERSION || APIVersions.AZURE_LATEST;
         // Configuration validation - now using consolidated utility
         if (!this.apiKey) {
             validateApiKey(createAzureAPIKeyConfig());

package/dist/utils/providerConfig.d.ts

@@ -15,6 +15,31 @@ export interface ProviderConfigOptions {
     instructions: string[];
     fallbackEnvVars?: string[];
 }
+/**
+ * API key format validation patterns (extracted from advanced validation system)
+ * Exported for use across the codebase to replace scattered regex patterns
+ */
+export declare const API_KEY_FORMATS: Record<string, RegExp>;
+/**
+ * API key length constants to replace scattered magic numbers
+ */
+export declare const API_KEY_LENGTHS: {
+    readonly OPENAI_MIN: 48;
+    readonly ANTHROPIC_MIN: 95;
+    readonly HUGGINGFACE_EXACT: 37;
+    readonly AZURE_MIN: 32;
+    readonly MISTRAL_EXACT: 32;
+    readonly AWS_ACCESS_KEY: 20;
+    readonly GOOGLE_AI_EXACT: 39;
+};
+/**
+ * Project ID format validation (for Google Cloud)
+ */
+export declare const PROJECT_ID_FORMAT: {
+    readonly MIN_LENGTH: 6;
+    readonly MAX_LENGTH: 30;
+    readonly PATTERN: RegExp;
+};
 /**
  * Enhanced validation result with format checking
  */

package/dist/utils/providerConfig.js

@@ -6,16 +6,37 @@
  */
 /**
  * API key format validation patterns (extracted from advanced validation system)
+ * Exported for use across the codebase to replace scattered regex patterns
  */
-const API_KEY_FORMATS = {
+export const API_KEY_FORMATS = {
     openai: /^sk-[A-Za-z0-9]{48,}$/,
     anthropic: /^sk-ant-[A-Za-z0-9\-_]{95,}$/,
     "google-ai": /^AIza[A-Za-z0-9\-_]{35}$/,
     huggingface: /^hf_[A-Za-z0-9]{37}$/,
     mistral: /^[A-Za-z0-9]{32}$/,
-    azure: /^[A-Za-z0-9]{32,}$/,
+    azure: /^[A-Za-z0-9]{32}$/,
     aws: /^[A-Z0-9]{20}$/, // Access Key ID format
-    googleVertex: /^[A-Za-z0-9\-_]{1,}$/, // Project ID format
+    bedrock: /^[A-Z0-9]{20}$/, // AWS access key ID: 20 uppercase alphanumerics
+};
+/**
+ * API key length constants to replace scattered magic numbers
+ */
+export const API_KEY_LENGTHS = {
+    OPENAI_MIN: 48, // OpenAI API keys minimum length
+    ANTHROPIC_MIN: 95, // Anthropic API keys minimum length
+    HUGGINGFACE_EXACT: 37, // HuggingFace tokens exact length
+    AZURE_MIN: 32, // Azure OpenAI API keys minimum length
+    MISTRAL_EXACT: 32, // Mistral API keys exact length
+    AWS_ACCESS_KEY: 20, // AWS access key ID exact length
+    GOOGLE_AI_EXACT: 39, // Google AI Studio keys exact length (with AIza prefix)
+};
+/**
+ * Project ID format validation (for Google Cloud)
+ */
+export const PROJECT_ID_FORMAT = {
+    MIN_LENGTH: 6, // Minimum project ID length
+    MAX_LENGTH: 30, // Maximum project ID length
+    PATTERN: /^[a-z][a-z0-9-]{4,28}[a-z0-9]$/, // Google Cloud project ID format
 };
 /**
  * Validates API key format for a specific provider

package/dist/utils/providerHealth.d.ts

@@ -2,7 +2,7 @@
  * Provider Health Checking System
  * Prevents 500 errors by validating provider availability and configuration
  */
-import { AIProviderName } from "../types/index.js";
+import { AIProviderName } from "../core/types.js";
 export interface ProviderHealthStatus {
     provider: AIProviderName;
     isHealthy: boolean;

package/dist/utils/providerHealth.js

@@ -3,7 +3,8 @@
  * Prevents 500 errors by validating provider availability and configuration
  */
 import { logger } from "./logger.js";
-import { AIProviderName } from "../types/index.js";
+import { AIProviderName, OpenAIModels, GoogleAIModels, AnthropicModels, BedrockModels, } from "../core/types.js";
+import { API_KEY_LENGTHS, PROJECT_ID_FORMAT } from "./providerConfig.js";
 import { basename } from "path";
 import { createProxyFetch } from "../proxy/proxyFetch.js";
 export class ProviderHealthChecker {
@@ -402,17 +403,19 @@ export class ProviderHealthChecker {
     static validateApiKeyFormat(providerName, apiKey) {
         switch (providerName) {
             case AIProviderName.ANTHROPIC:
-                return apiKey.startsWith("sk-ant-") && apiKey.length > 20;
+                return (apiKey.startsWith("sk-ant-") &&
+                    apiKey.length >= API_KEY_LENGTHS.ANTHROPIC_MIN);
             case AIProviderName.OPENAI:
-                return apiKey.startsWith("sk-") && apiKey.length > 20;
+                return (apiKey.startsWith("sk-") &&
+                    apiKey.length >= API_KEY_LENGTHS.OPENAI_MIN);
             case AIProviderName.GOOGLE_AI:
-                return apiKey.length > 20; // Basic length check
+                return apiKey.length >= API_KEY_LENGTHS.GOOGLE_AI_EXACT; // Basic length check
             case AIProviderName.VERTEX:
                 return apiKey.endsWith(".json") || apiKey.includes("type"); // JSON key format
             case AIProviderName.BEDROCK:
-                return apiKey.length >= 20; // AWS access key length
+                return apiKey.length >= API_KEY_LENGTHS.AWS_ACCESS_KEY; // AWS access key length
             case AIProviderName.AZURE:
-                return apiKey.length >= 32; // Azure OpenAI API key length
+                return apiKey.length >= API_KEY_LENGTHS.AZURE_MIN; // Azure OpenAI API key length
             case AIProviderName.OLLAMA:
                 return true; // Ollama usually doesn't require specific format
             default:
@@ -604,14 +607,14 @@ export class ProviderHealthChecker {
     static checkBedrockModels(healthStatus) {
         const bedrockModel = process.env.BEDROCK_MODEL || process.env.BEDROCK_MODEL_ID;
         const supportedModels = [
-            "anthropic.claude-3-sonnet-20240229-v1:0",
-            "anthropic.claude-3-haiku-20240307-v1:0",
-            "anthropic.claude-3-opus-20240229-v1:0",
+            BedrockModels.CLAUDE_3_SONNET,
+            BedrockModels.CLAUDE_3_HAIKU,
+            BedrockModels.CLAUDE_3_5_SONNET,
             "anthropic.claude-v2:1",
             "amazon.titan-text-express-v1",
         ];
         if (!bedrockModel) {
-            healthStatus.recommendations.push("Set BEDROCK_MODEL or BEDROCK_MODEL_ID for faster startup (e.g., anthropic.claude-3-sonnet-20240229-v1:0)");
+            healthStatus.recommendations.push(`Set BEDROCK_MODEL or BEDROCK_MODEL_ID for faster startup (e.g., ${BedrockModels.CLAUDE_3_SONNET})`);
         }
         else if (!supportedModels.includes(bedrockModel)) {
             healthStatus.recommendations.push(`Consider using a popular Bedrock model: ${supportedModels.slice(0, 3).join(", ")}`);
@@ -658,39 +661,44 @@ export class ProviderHealthChecker {
         switch (providerName) {
             case AIProviderName.ANTHROPIC:
                 return [
-                    "claude-3-5-sonnet-20241022",
-                    "claude-3-haiku-20240307",
-                    "claude-3-opus-20240229",
+                    AnthropicModels.CLAUDE_3_5_SONNET,
+                    AnthropicModels.CLAUDE_3_HAIKU,
+                    AnthropicModels.CLAUDE_3_OPUS,
                 ];
             case AIProviderName.OPENAI:
-                return ["gpt-4o", "gpt-4o-mini", "gpt-3.5-turbo"];
+                return [
+                    OpenAIModels.GPT_4O,
+                    OpenAIModels.GPT_4O_MINI,
+                    OpenAIModels.GPT_3_5_TURBO,
+                ];
             case AIProviderName.GOOGLE_AI:
-                return ["gemini-1.5-pro", "gemini-1.5-flash", "gemini-pro"];
+                return [
+                    GoogleAIModels.GEMINI_1_5_PRO,
+                    GoogleAIModels.GEMINI_1_5_FLASH,
+                    GoogleAIModels.GEMINI_2_5_PRO,
+                ];
             case AIProviderName.VERTEX:
                 return [
                     // Google models (via vertex provider)
-                    "gemini-2.5-pro",
-                    "gemini-2.5-flash",
-                    "gemini-2.5-flash-lite",
-                    "gemini-2.0-flash-001",
-                    "gemini-1.5-pro",
-                    "gemini-1.5-flash",
+                    GoogleAIModels.GEMINI_2_5_PRO,
+                    GoogleAIModels.GEMINI_2_5_FLASH,
+                    GoogleAIModels.GEMINI_2_5_FLASH_LITE,
+                    GoogleAIModels.GEMINI_2_0_FLASH_001,
+                    GoogleAIModels.GEMINI_1_5_PRO,
+                    GoogleAIModels.GEMINI_1_5_FLASH,
                     // Anthropic models (via vertexAnthropic provider)
                     "claude-sonnet-4@20250514",
                     "claude-opus-4@20250514",
-                    "claude-3-5-sonnet-20241022",
-                    "claude-3-5-haiku-20241022",
-                    "claude-3-sonnet-20240229",
-                    "claude-3-haiku-20240307",
-                    "claude-3-opus-20240229",
+                    AnthropicModels.CLAUDE_3_5_SONNET,
+                    AnthropicModels.CLAUDE_3_5_HAIKU,
+                    AnthropicModels.CLAUDE_3_SONNET,
+                    AnthropicModels.CLAUDE_3_HAIKU,
+                    AnthropicModels.CLAUDE_3_OPUS,
                 ];
             case AIProviderName.BEDROCK:
-                return [
-                    "anthropic.claude-3-sonnet-20240229-v1:0",
-                    "anthropic.claude-3-haiku-20240307-v1:0",
-                ];
+                return [BedrockModels.CLAUDE_3_SONNET, BedrockModels.CLAUDE_3_HAIKU];
             case AIProviderName.AZURE:
-                return ["gpt-4o", "gpt-4o-mini", "gpt-35-turbo"];
+                return [OpenAIModels.GPT_4O, OpenAIModels.GPT_4O_MINI, "gpt-35-turbo"];
             case AIProviderName.OLLAMA:
                 return ["llama3.2:latest", "llama3.1:latest", "mistral:latest"];
             default:
@@ -951,8 +959,7 @@ export class ProviderHealthChecker {
         if (projectId) {
             result.projectId = projectId;
             // Validate project ID format
-            const projectIdPattern = /^[a-z][a-z0-9-]{4,28}[a-z0-9]$/;
-            if (projectIdPattern.test(projectId)) {
+            if (PROJECT_ID_FORMAT.PATTERN.test(projectId)) {
                 result.isValid = true;
             }
             else {

package/dist/utils/providerSetupMessages.js

@@ -2,6 +2,7 @@
  * Enhanced Provider Setup Messages
  * Provides detailed setup instructions for AI providers
  */
+import { OpenAIModels, GoogleAIModels, AnthropicModels, APIVersions, } from "../core/types.js";
 /**
  * Generate enhanced error message with setup instructions
  */
@@ -12,7 +13,7 @@ export function getProviderSetupMessage(provider, missingVars) {
             envVars: [
                 'OPENAI_API_KEY="sk-proj-your-openai-api-key"',
                 "# Optional:",
-                'OPENAI_MODEL="gpt-4o"',
+                `OPENAI_MODEL="${OpenAIModels.GPT_4O}"`,
                 'OPENAI_BASE_URL="https://api.openai.com"',
             ],
         },
@@ -21,7 +22,7 @@ export function getProviderSetupMessage(provider, missingVars) {
             envVars: [
                 'ANTHROPIC_API_KEY="sk-ant-api03-your-anthropic-key"',
                 "# Optional:",
-                'ANTHROPIC_MODEL="claude-3-5-sonnet-20241022"',
+                `ANTHROPIC_MODEL="${AnthropicModels.CLAUDE_3_5_SONNET}"`,
             ],
         },
         "google-ai": {
@@ -29,7 +30,7 @@ export function getProviderSetupMessage(provider, missingVars) {
             envVars: [
                 'GOOGLE_AI_API_KEY="AIza-your-google-ai-api-key"',
                 "# Optional:",
-                'GOOGLE_AI_MODEL="gemini-2.5-pro"',
+                `GOOGLE_AI_MODEL="${GoogleAIModels.GEMINI_2_5_PRO}"`,
             ],
         },
         vertex: {
@@ -39,7 +40,7 @@ export function getProviderSetupMessage(provider, missingVars) {
                 'GOOGLE_VERTEX_PROJECT="your-gcp-project-id"',
                 'GOOGLE_VERTEX_LOCATION="us-central1"',
                 "# Optional:",
-                'VERTEX_MODEL="gemini-2.5-pro"',
+                `VERTEX_MODEL="${GoogleAIModels.GEMINI_2_5_PRO}"`,
             ],
         },
         bedrock: {
@@ -61,8 +62,8 @@ export function getProviderSetupMessage(provider, missingVars) {
                 'AZURE_OPENAI_ENDPOINT="https://your-resource.openai.azure.com/"',
                 'AZURE_OPENAI_DEPLOYMENT_ID="your-deployment-name"',
                 "# Optional:",
-                'AZURE_MODEL="gpt-4o"',
-                'AZURE_API_VERSION="2024-02-15-preview"',
+                `AZURE_MODEL="${OpenAIModels.GPT_4O}"`,
+                `AZURE_API_VERSION="${APIVersions.AZURE_STABLE}"`,
             ],
         },
         huggingface: {