@juspay/neurolink 7.33.2 → 7.33.4

package/dist/providers/googleVertex.js

@@ -4,7 +4,7 @@ import { streamText, Output, } from "ai";
 import { BaseProvider } from "../core/baseProvider.js";
 import { logger } from "../utils/logger.js";
 import { createTimeoutController, TimeoutError } from "../utils/timeout.js";
-import { DEFAULT_MAX_TOKENS, DEFAULT_MAX_STEPS } from "../core/constants.js";
+import { DEFAULT_MAX_STEPS } from "../core/constants.js";
 import { ModelConfigurationManager } from "../core/modelConfiguration.js";
 import { validateApiKey, createVertexProjectConfig, createGoogleAuthConfig, } from "../utils/providerConfig.js";
 import fs from "fs";
@@ -945,7 +945,7 @@ export class GoogleVertexProvider extends BaseProvider {
             // This avoids hardcoded model-specific logic and repeated config lookups
             const shouldSetMaxTokens = this.shouldSetMaxTokensCached(modelName);
             const maxTokens = shouldSetMaxTokens
-                ? options.maxTokens || DEFAULT_MAX_TOKENS
+                ? options.maxTokens // No default limit
                 : undefined;
             // Build complete stream options with proper typing
             let streamOptions = {

package/dist/providers/huggingFace.js

@@ -3,7 +3,6 @@ import { streamText, } from "ai";
 import { BaseProvider } from "../core/baseProvider.js";
 import { logger } from "../utils/logger.js";
 import { createTimeoutController, TimeoutError } from "../utils/timeout.js";
-import { DEFAULT_MAX_TOKENS } from "../core/constants.js";
 import { validateApiKey, createHuggingFaceConfig, getProviderModel, } from "../utils/providerConfig.js";
 import { buildMessagesArray } from "../utils/messageBuilder.js";
 import { createProxyFetch } from "../proxy/proxyFetch.js";
@@ -120,7 +119,7 @@ export class HuggingFaceProvider extends BaseProvider {
                 model: this.model,
                 messages: messages,
                 temperature: options.temperature,
-                maxTokens: options.maxTokens || DEFAULT_MAX_TOKENS,
+                maxTokens: options.maxTokens, // No default limit - unlimited unless specified
                 tools: streamOptions.tools, // Tools format conversion handled by prepareStreamOptions
                 toolChoice: streamOptions.toolChoice, // Tool choice handled by prepareStreamOptions
                 abortSignal: timeoutController?.controller.signal,

package/dist/providers/litellm.js

@@ -3,7 +3,6 @@ import { streamText } from "ai";
 import { BaseProvider } from "../core/baseProvider.js";
 import { logger } from "../utils/logger.js";
 import { createTimeoutController, TimeoutError } from "../utils/timeout.js";
-import { DEFAULT_MAX_TOKENS } from "../core/constants.js";
 import { getProviderModel } from "../utils/providerConfig.js";
 import { streamAnalyticsCollector } from "../core/streamAnalytics.js";
 import { buildMessagesArray } from "../utils/messageBuilder.js";
@@ -127,7 +126,7 @@ export class LiteLLMProvider extends BaseProvider {
                 model: this.model,
                 messages: messages,
                 temperature: options.temperature,
-                maxTokens: options.maxTokens || DEFAULT_MAX_TOKENS,
+                maxTokens: options.maxTokens, // No default limit - unlimited unless specified
                 tools: options.tools,
                 toolChoice: "auto",
                 abortSignal: timeoutController?.controller.signal,

package/dist/providers/mistral.js

@@ -3,7 +3,7 @@ import { streamText } from "ai";
 import { BaseProvider } from "../core/baseProvider.js";
 import { logger } from "../utils/logger.js";
 import { createTimeoutController, TimeoutError } from "../utils/timeout.js";
-import { DEFAULT_MAX_TOKENS, DEFAULT_MAX_STEPS } from "../core/constants.js";
+import { DEFAULT_MAX_STEPS } from "../core/constants.js";
 import { validateApiKey, createMistralConfig, getProviderModel, } from "../utils/providerConfig.js";
 import { streamAnalyticsCollector } from "../core/streamAnalytics.js";
 import { buildMessagesArray } from "../utils/messageBuilder.js";
@@ -54,7 +54,7 @@ export class MistralProvider extends BaseProvider {
                 model: this.model,
                 messages: messages,
                 temperature: options.temperature,
-                maxTokens: options.maxTokens || DEFAULT_MAX_TOKENS,
+                maxTokens: options.maxTokens, // No default limit - unlimited unless specified
                 tools,
                 maxSteps: options.maxSteps || DEFAULT_MAX_STEPS,
                 toolChoice: shouldUseTools ? "auto" : "none",

package/dist/providers/ollama.js

@@ -1,6 +1,5 @@
 import { BaseProvider } from "../core/baseProvider.js";
 import { logger } from "../utils/logger.js";
-import { DEFAULT_MAX_TOKENS } from "../core/constants.js";
 import { modelConfig } from "../core/modelConfiguration.js";
 import { createProxyFetch } from "../proxy/proxyFetch.js";
 import { TimeoutError } from "../utils/timeout.js";
@@ -88,10 +87,10 @@ class OllamaLanguageModel {
         return {
             text: data.response,
             usage: {
-                promptTokens: data.prompt_eval_count || this.estimateTokens(prompt),
-                completionTokens: data.eval_count || this.estimateTokens(data.response),
-                totalTokens: (data.prompt_eval_count || this.estimateTokens(prompt)) +
-                    (data.eval_count || this.estimateTokens(data.response)),
+                promptTokens: data.prompt_eval_count ?? this.estimateTokens(prompt),
+                completionTokens: data.eval_count ?? this.estimateTokens(String(data.response ?? "")),
+                totalTokens: (data.prompt_eval_count ?? this.estimateTokens(prompt)) +
+                    (data.eval_count ?? this.estimateTokens(String(data.response ?? ""))),
             },
             finishReason: "stop",
             rawCall: {
@@ -271,7 +270,7 @@ export class OllamaProvider extends BaseProvider {
      * @returns true for supported models, false for unsupported models
      */
     supportsTools() {
-        const modelName = this.modelName.toLowerCase();
+        const modelName = (this.modelName ?? getDefaultOllamaModel()).toLowerCase();
         // Get tool-capable models from configuration
         const ollamaConfig = modelConfig.getProviderConfiguration("ollama");
         const toolCapableModels = ollamaConfig?.modelBehavior?.toolCapableModels || [];
@@ -340,7 +339,7 @@ export class OllamaProvider extends BaseProvider {
                 tool_choice: "auto",
                 stream: true,
                 temperature: options.temperature,
-                max_tokens: options.maxTokens || DEFAULT_MAX_TOKENS,
+                max_tokens: options.maxTokens,
             }),
             signal: createAbortSignalWithTimeout(this.timeout),
         });
@@ -381,7 +380,7 @@ export class OllamaProvider extends BaseProvider {
                 stream: true,
                 options: {
                     temperature: options.temperature,
-                    num_predict: options.maxTokens || DEFAULT_MAX_TOKENS,
+                    num_predict: options.maxTokens,
                 },
             }),
             signal: createAbortSignalWithTimeout(this.timeout),

package/dist/providers/openAI.js

@@ -5,7 +5,7 @@ import { BaseProvider } from "../core/baseProvider.js";
 import { logger } from "../utils/logger.js";
 import { createTimeoutController, TimeoutError } from "../utils/timeout.js";
 import { AuthenticationError, InvalidModelError, NetworkError, ProviderError, RateLimitError, } from "../types/errors.js";
-import { DEFAULT_MAX_TOKENS, DEFAULT_MAX_STEPS } from "../core/constants.js";
+import { DEFAULT_MAX_STEPS } from "../core/constants.js";
 import { validateApiKey, createOpenAIConfig, getProviderModel, } from "../utils/providerConfig.js";
 import { streamAnalyticsCollector } from "../core/streamAnalytics.js";
 import { buildMessagesArray } from "../utils/messageBuilder.js";
@@ -97,7 +97,7 @@ export class OpenAIProvider extends BaseProvider {
                 model: this.model,
                 messages: messages,
                 temperature: options.temperature,
-                maxTokens: options.maxTokens || DEFAULT_MAX_TOKENS,
+                maxTokens: options.maxTokens, // No default limit - unlimited unless specified
                 tools,
                 maxSteps: options.maxSteps || DEFAULT_MAX_STEPS,
                 toolChoice: shouldUseTools ? "auto" : "none",

package/dist/providers/openaiCompatible.js

@@ -3,7 +3,6 @@ import { streamText } from "ai";
 import { BaseProvider } from "../core/baseProvider.js";
 import { logger } from "../utils/logger.js";
 import { createTimeoutController, TimeoutError } from "../utils/timeout.js";
-import { DEFAULT_MAX_TOKENS } from "../core/constants.js";
 import { streamAnalyticsCollector } from "../core/streamAnalytics.js";
 import { createProxyFetch } from "../proxy/proxyFetch.js";
 // Constants
@@ -163,7 +162,7 @@ export class OpenAICompatibleProvider extends BaseProvider {
                 prompt: options.input.text,
                 system: options.systemPrompt,
                 temperature: options.temperature,
-                maxTokens: options.maxTokens || DEFAULT_MAX_TOKENS,
+                maxTokens: options.maxTokens, // No default limit - unlimited unless specified
                 tools: options.tools,
                 toolChoice: "auto",
                 abortSignal: timeoutController?.controller.signal,
@@ -207,12 +206,16 @@ export class OpenAICompatibleProvider extends BaseProvider {
             const modelsUrl = new URL("/v1/models", this.config.baseURL).toString();
             logger.debug(`Fetching available models from: ${modelsUrl}`);
             const proxyFetch = createProxyFetch();
+            const controller = new AbortController();
+            const t = setTimeout(() => controller.abort(), 5000);
             const response = await proxyFetch(modelsUrl, {
                 headers: {
                     Authorization: `Bearer ${this.config.apiKey}`,
                     "Content-Type": "application/json",
                 },
+                signal: controller.signal,
             });
+            clearTimeout(t);
             if (!response.ok) {
                 logger.warn(`Models endpoint returned ${response.status}: ${response.statusText}`);
                 return this.getFallbackModels();

package/dist/providers/sagemaker/language-model.d.ts

@@ -9,6 +9,11 @@ import type { SageMakerConfig, SageMakerModelConfig } from "./types.js";
 import type { ConnectivityResult } from "../../types/typeAliases.js";
 /**
  * SageMaker Language Model implementing LanguageModelV1 interface
+ *
+ * Token Limit Behavior:
+ * - When maxTokens is undefined, SageMaker uses the model's default token limits
+ * - When maxTokens is specified, it sets max_new_tokens parameter explicitly
+ * - This aligns with the unlimited-by-default token policy across all providers
  */
 export declare class SageMakerLanguageModel implements LanguageModelV1 {
     readonly specificationVersion = "v1";

package/dist/providers/sagemaker/language-model.js

@@ -75,6 +75,11 @@ const DEFAULT_MAX_CONCURRENCY = 10;
 const DEFAULT_MIN_CONCURRENCY = 1;
 /**
  * SageMaker Language Model implementing LanguageModelV1 interface
+ *
+ * Token Limit Behavior:
+ * - When maxTokens is undefined, SageMaker uses the model's default token limits
+ * - When maxTokens is specified, it sets max_new_tokens parameter explicitly
+ * - This aligns with the unlimited-by-default token policy across all providers
  */
 export class SageMakerLanguageModel {
     specificationVersion = "v1";
@@ -345,7 +350,10 @@ export class SageMakerLanguageModel {
         const request = {
             inputs: promptText,
             parameters: {
-                max_new_tokens: options.maxTokens || 512,
+                // Only include max_new_tokens if explicitly specified; let SageMaker use model defaults otherwise
+                ...(options.maxTokens !== undefined
+                    ? { max_new_tokens: options.maxTokens }
+                    : {}),
                 temperature: options.temperature || 0.7,
                 top_p: options.topP || 0.9,
                 stop: options.stopSequences || [],

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(", ")}`);
@@ -636,9 +639,13 @@ export class ProviderHealthChecker {
             healthStatus.configurationIssues.push("Invalid AZURE_OPENAI_ENDPOINT format");
             healthStatus.recommendations.push("Set AZURE_OPENAI_ENDPOINT to a valid URL (e.g., https://your-resource.openai.azure.com/)");
         }
-        if (!process.env.AZURE_OPENAI_DEPLOYMENT_NAME) {
-            healthStatus.configurationIssues.push("AZURE_OPENAI_DEPLOYMENT_NAME not set");
-            healthStatus.recommendations.push("Set AZURE_OPENAI_DEPLOYMENT_NAME to your deployment name");
+        // Check for deployment name using the SAME logic as the Azure provider
+        const deploymentName = process.env.AZURE_OPENAI_MODEL ||
+            process.env.AZURE_OPENAI_DEPLOYMENT ||
+            process.env.AZURE_OPENAI_DEPLOYMENT_ID;
+        if (!deploymentName) {
+            healthStatus.configurationIssues.push("No Azure deployment specified");
+            healthStatus.recommendations.push("Set one of: AZURE_OPENAI_MODEL, AZURE_OPENAI_DEPLOYMENT, or AZURE_OPENAI_DEPLOYMENT_ID");
         }
     }
     /**
@@ -658,39 +665,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 +963,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: {

package/dist/utils/providerUtils.js

@@ -5,6 +5,7 @@
 import { AIProviderFactory } from "../core/factory.js";
 import { logger } from "./logger.js";
 import { ProviderHealthChecker } from "./providerHealth.js";
+import { API_KEY_FORMATS, API_KEY_LENGTHS, PROJECT_ID_FORMAT, } from "./providerConfig.js";
 /**
  * Get the best available provider based on real-time availability checks
  * Enhanced version consolidated from providerUtils-fixed.ts
@@ -123,15 +124,6 @@ async function isProviderAvailable(providerName) {
         return false;
     }
 }
-/**
- * Google Cloud Project ID validation regex
- * Format requirements:
- * - Must start with a lowercase letter
- * - Can contain lowercase letters, numbers, and hyphens
- * - Must end with a lowercase letter or number
- * - Total length must be 6-30 characters
- */
-const GOOGLE_CLOUD_PROJECT_ID_REGEX = /^[a-z][a-z0-9-]{4,28}[a-z0-9]$/;
 /**
  * Validate environment variable values for a provider
  * Addresses GitHub Copilot comment about adding environment variable validation
@@ -166,7 +158,7 @@ export function validateProviderEnvVars(provider) {
             validateAnthropicCredentials(result);
             break;
         case "azure":
-        case "azureOpenai":
+        case "azureopenai":
             validateAzureCredentials(result);
             break;
         case "google-ai":
@@ -240,7 +232,7 @@ function validateVertexCredentials(result) {
     if (!projectId) {
         result.missingVars.push("GOOGLE_CLOUD_PROJECT_ID (or variant)");
     }
-    else if (!GOOGLE_CLOUD_PROJECT_ID_REGEX.test(projectId)) {
+    else if (!PROJECT_ID_FORMAT.PATTERN.test(projectId)) {
         result.invalidVars.push("Project ID format invalid (must be 6-30 lowercase letters, digits, hyphens)");
     }
     if (!hasCredentials) {
@@ -259,8 +251,8 @@ function validateOpenAICredentials(result) {
     if (!apiKey) {
         result.missingVars.push("OPENAI_API_KEY");
     }
-    else if (!/^sk-[A-Za-z0-9]{48,}$/.test(apiKey)) {
-        result.invalidVars.push("OPENAI_API_KEY (should start with 'sk-' followed by 48+ characters)");
+    else if (!API_KEY_FORMATS.openai.test(apiKey)) {
+        result.invalidVars.push(`OPENAI_API_KEY (should start with 'sk-' followed by ${API_KEY_LENGTHS.OPENAI_MIN}+ characters)`);
     }
 }
 /**
@@ -271,8 +263,8 @@ function validateAnthropicCredentials(result) {
     if (!apiKey) {
         result.missingVars.push("ANTHROPIC_API_KEY");
     }
-    else if (!/^sk-ant-[A-Za-z0-9-_]{95,}$/.test(apiKey)) {
-        result.invalidVars.push("ANTHROPIC_API_KEY (should start with 'sk-ant-' followed by 95+ characters)");
+    else if (!API_KEY_FORMATS.anthropic.test(apiKey)) {
+        result.invalidVars.push(`ANTHROPIC_API_KEY (should start with 'sk-ant-' followed by ${API_KEY_LENGTHS.ANTHROPIC_MIN}+ characters)`);
     }
 }
 /**
@@ -284,8 +276,8 @@ function validateAzureCredentials(result) {
     if (!apiKey) {
         result.missingVars.push("AZURE_OPENAI_API_KEY");
     }
-    else if (!/^[a-f0-9]{32}$/.test(apiKey)) {
-        result.invalidVars.push("AZURE_OPENAI_API_KEY (should be 32 hexadecimal characters)");
+    else if (!API_KEY_FORMATS.azure.test(apiKey)) {
+        result.invalidVars.push(`AZURE_OPENAI_API_KEY (should be at least ${API_KEY_LENGTHS.AZURE_MIN} alphanumeric characters)`);
     }
     if (!endpoint) {
         result.missingVars.push("AZURE_OPENAI_ENDPOINT");
@@ -302,8 +294,8 @@ function validateGoogleAICredentials(result) {
     if (!apiKey) {
         result.missingVars.push("GOOGLE_AI_API_KEY (or GOOGLE_GENERATIVE_AI_API_KEY)");
     }
-    else if (!/^[A-Za-z0-9_-]{39}$/.test(apiKey)) {
-        result.invalidVars.push("GOOGLE_AI_API_KEY (should be 39 alphanumeric characters with dashes/underscores)");
+    else if (!API_KEY_FORMATS["google-ai"].test(apiKey)) {
+        result.invalidVars.push(`GOOGLE_AI_API_KEY (should be ${API_KEY_LENGTHS.GOOGLE_AI_EXACT} alphanumeric characters with dashes/underscores)`);
     }
 }
 /**
@@ -314,8 +306,8 @@ function validateHuggingFaceCredentials(result) {
     if (!apiKey) {
         result.missingVars.push("HUGGINGFACE_API_KEY (or HF_TOKEN)");
     }
-    else if (!/^hf_[A-Za-z0-9]{37}$/.test(apiKey)) {
-        result.invalidVars.push("HUGGINGFACE_API_KEY (should start with 'hf_' followed by 37 characters)");
+    else if (!API_KEY_FORMATS.huggingface.test(apiKey)) {
+        result.invalidVars.push(`HUGGINGFACE_API_KEY (should start with 'hf_' followed by ${API_KEY_LENGTHS.HUGGINGFACE_EXACT} characters)`);
     }
 }
 /**
@@ -326,8 +318,8 @@ function validateMistralCredentials(result) {
     if (!apiKey) {
         result.missingVars.push("MISTRAL_API_KEY");
     }
-    else if (!/^[A-Za-z0-9]{32,}$/.test(apiKey)) {
-        result.invalidVars.push("MISTRAL_API_KEY (should be 32+ alphanumeric characters)");
+    else if (!API_KEY_FORMATS.mistral.test(apiKey)) {
+        result.invalidVars.push(`MISTRAL_API_KEY (should be ${API_KEY_LENGTHS.MISTRAL_EXACT} alphanumeric characters)`);
     }
 }
 /**
@@ -381,7 +373,7 @@ export function hasProviderEnvVars(provider) {
         case "claude":
             return !!process.env.ANTHROPIC_API_KEY;
         case "azure":
-        case "azureOpenai":
+        case "azureopenai":
             return !!process.env.AZURE_OPENAI_API_KEY;
         case "google-ai":
         case "google-studio":

package/dist/utils/tokenLimits.d.ts

@@ -6,13 +6,13 @@ import { PROVIDER_MAX_TOKENS } from "../core/constants.js";
 /**
  * Get the safe maximum tokens for a provider and model
  */
-export declare function getSafeMaxTokens(provider: keyof typeof PROVIDER_MAX_TOKENS | string, model?: string, requestedMaxTokens?: number): number;
+export declare function getSafeMaxTokens(provider: keyof typeof PROVIDER_MAX_TOKENS | string, model?: string, requestedMaxTokens?: number): number | undefined;
 /**
  * Validate if maxTokens is safe for a provider/model combination
  */
 export declare function validateMaxTokens(provider: keyof typeof PROVIDER_MAX_TOKENS | string, model?: string, maxTokens?: number): {
     isValid: boolean;
-    recommendedMaxTokens: number;
+    recommendedMaxTokens?: number;
     warning?: string;
 };
 /**