@juspay/neurolink 6.0.0 → 6.2.0

package/dist/providers/azure-openai.js

@@ -1,6 +1,7 @@
 import { createAzure } from "@ai-sdk/azure";
 import { streamText } from "ai";
 import { BaseProvider } from "../core/base-provider.js";
+import { validateApiKey, createAzureAPIKeyConfig, createAzureEndpointConfig, } from "../utils/providerConfig.js";
 export class AzureOpenAIProvider extends BaseProvider {
     apiKey;
     resourceName;
@@ -21,11 +22,12 @@ export class AzureOpenAIProvider extends BaseProvider {
                 process.env.AZURE_OPENAI_DEPLOYMENT_ID ||
                 "gpt-4o";
         this.apiVersion = process.env.AZURE_API_VERSION || "2024-10-01-preview";
+        // Configuration validation - now using consolidated utility
         if (!this.apiKey) {
-            throw new Error("AZURE_OPENAI_API_KEY environment variable is required");
+            validateApiKey(createAzureAPIKeyConfig());
         }
         if (!this.resourceName) {
-            throw new Error("AZURE_OPENAI_ENDPOINT environment variable is required");
+            validateApiKey(createAzureEndpointConfig());
         }
         // Create the Azure provider instance
         this.azureProvider = createAzure({

package/dist/providers/google-vertex.js

@@ -4,6 +4,7 @@ import { BaseProvider } from "../core/base-provider.js";
 import { logger } from "../utils/logger.js";
 import { createTimeoutController, TimeoutError, getDefaultTimeout, } from "../utils/timeout.js";
 import { DEFAULT_MAX_TOKENS } from "../core/constants.js";
+import { validateApiKey, createVertexProjectConfig, createGoogleAuthConfig, } from "../utils/providerConfig.js";
 // Cache for anthropic module to avoid repeated imports
 let _createVertexAnthropic = null;
 let _anthropicImportAttempted = false;
@@ -28,14 +29,9 @@ async function getCreateVertexAnthropic() {
     }
 }
 // Configuration helpers
+// Configuration helpers - now using consolidated utility
 const getVertexProjectId = () => {
-    const projectId = process.env.GOOGLE_CLOUD_PROJECT_ID ||
-        process.env.VERTEX_PROJECT_ID ||
-        process.env.GOOGLE_VERTEX_PROJECT;
-    if (!projectId) {
-        throw new Error(`❌ Google Vertex AI Provider Configuration Error\n\nMissing required environment variables: GOOGLE_CLOUD_PROJECT_ID or VERTEX_PROJECT_ID\n\n🔧 Step 1: Get Google Cloud Credentials\n1. Visit: https://console.cloud.google.com/\n2. Create or select a project\n3. Enable Vertex AI API\n4. Set up authentication\n\n🔧 Step 2: Set Environment Variables\nAdd to your .env file:\nGOOGLE_CLOUD_PROJECT_ID=your_project_id_here\nGOOGLE_APPLICATION_CREDENTIALS=/path/to/service-account.json\n\n🔧 Step 3: Restart Application\nRestart your application to load the new environment variables.`);
-    }
-    return projectId;
+    return validateApiKey(createVertexProjectConfig());
 };
 const getVertexLocation = () => {
     return (process.env.GOOGLE_CLOUD_LOCATION ||
@@ -72,9 +68,9 @@ export class GoogleVertexProvider extends BaseProvider {
     cachedAnthropicModel = null;
     constructor(modelName, sdk) {
         super(modelName, "vertex", sdk);
-        // Validate Google Cloud credentials
+        // Validate Google Cloud credentials - now using consolidated utility
         if (!hasGoogleCredentials()) {
-            throw new Error(`❌ Google Vertex AI Provider Configuration Error\n\nMissing Google Cloud authentication. One of the following is required:\n\n🔧 Option 1: Service Account Key File\nGOOGLE_APPLICATION_CREDENTIALS=/path/to/service-account.json\n\n🔧 Option 2: Service Account Key (Base64)\nGOOGLE_SERVICE_ACCOUNT_KEY=base64_encoded_key\n\n🔧 Option 3: Individual Credentials\nGOOGLE_AUTH_CLIENT_EMAIL=your-service-account@project.iam.gserviceaccount.com\nGOOGLE_AUTH_PRIVATE_KEY=-----BEGIN PRIVATE KEY-----...\n\n🔧 Step 4: Restart Application\nRestart your application to load the new environment variables.`);
+            validateApiKey(createGoogleAuthConfig());
         }
         // Initialize Google Cloud configuration
         this.projectId = getVertexProjectId();

package/dist/providers/huggingFace.js

@@ -4,20 +4,15 @@ import { BaseProvider } from "../core/base-provider.js";
 import { logger } from "../utils/logger.js";
 import { createTimeoutController, TimeoutError, getDefaultTimeout, } from "../utils/timeout.js";
 import { DEFAULT_MAX_TOKENS } from "../core/constants.js";
-// Configuration helpers
+import { validateApiKey, createHuggingFaceConfig, getProviderModel, hasHuggingFaceCredentials, } from "../utils/providerConfig.js";
+// Configuration helpers - now using consolidated utility
 const getHuggingFaceApiKey = () => {
-    const apiKey = process.env.HUGGINGFACE_API_KEY || process.env.HF_TOKEN;
-    if (!apiKey) {
-        throw new Error(`❌ HuggingFace Provider Configuration Error\n\nMissing required environment variables: HUGGINGFACE_API_KEY\n\n🔧 Step 1: Get Credentials\n1. Visit: https://huggingface.co/settings/tokens\n2. Create new API token\n3. Copy the token\n\n🔧 Step 2: Set Environment Variable\nAdd to your .env file:\nHUGGINGFACE_API_KEY=your_token_here\n\n🔧 Step 3: Restart Application\nRestart your application to load the new environment variables.`);
-    }
-    return apiKey;
+    return validateApiKey(createHuggingFaceConfig());
 };
 const getDefaultHuggingFaceModel = () => {
-    return process.env.HUGGINGFACE_MODEL || "microsoft/DialoGPT-medium";
-};
-const hasHuggingFaceCredentials = () => {
-    return !!(process.env.HUGGINGFACE_API_KEY || process.env.HF_TOKEN);
+    return getProviderModel("HUGGINGFACE_MODEL", "microsoft/DialoGPT-medium");
 };
+// Note: hasHuggingFaceCredentials now directly imported from consolidated utility
 /**
  * HuggingFace Provider - BaseProvider Implementation
  * Using AI SDK with HuggingFace's OpenAI-compatible endpoint

package/dist/providers/mistral.js

@@ -2,17 +2,14 @@ import { createMistral } from "@ai-sdk/mistral";
 import { streamText } from "ai";
 import { BaseProvider } from "../core/base-provider.js";
 import { logger } from "../utils/logger.js";
-import { createAnalytics } from "./analytics-helper.js";
-// Configuration helpers
+import { createAnalytics } from "../core/analytics.js";
+import { validateApiKey, createMistralConfig, getProviderModel, } from "../utils/providerConfig.js";
+// Configuration helpers - now using consolidated utility
 const getMistralApiKey = () => {
-    const apiKey = process.env.MISTRAL_API_KEY;
-    if (!apiKey) {
-        throw new Error("Mistral API key not found. Please set MISTRAL_API_KEY environment variable.");
-    }
-    return apiKey;
+    return validateApiKey(createMistralConfig());
 };
 const getDefaultMistralModel = () => {
-    return process.env.MISTRAL_MODEL || "mistral-large-latest";
+    return getProviderModel("MISTRAL_MODEL", "mistral-large-latest");
 };
 /**
  * Mistral AI Provider v2 - BaseProvider Implementation

package/dist/providers/openAI.js

@@ -5,16 +5,13 @@ import { BaseProvider } from "../core/base-provider.js";
 import { logger } from "../utils/logger.js";
 import { createTimeoutController, TimeoutError, getDefaultTimeout, } from "../utils/timeout.js";
 import { DEFAULT_MAX_TOKENS } from "../core/constants.js";
-// Configuration helpers
+import { validateApiKey, createOpenAIConfig, getProviderModel, } from "../utils/providerConfig.js";
+// Configuration helpers - now using consolidated utility
 const getOpenAIApiKey = () => {
-    const apiKey = process.env.OPENAI_API_KEY;
-    if (!apiKey) {
-        throw new Error(`❌ OPENAI Provider Configuration Error\n\nMissing required environment variables: OPENAI_API_KEY\n\n🔧 Step 1: Get Credentials\n1. Visit: https://platform.openai.com/api-keys\n2. Create new API key\n3. Copy the key\n\n🔧 Step 2: Set Environment Variable\nAdd to your .env file:\nOPENAI_API_KEY=your_api_key_here\n\n🔧 Step 3: Restart Application\nRestart your application to load the new environment variables.`);
-    }
-    return apiKey;
+    return validateApiKey(createOpenAIConfig());
 };
 const getOpenAIModel = () => {
-    return process.env.OPENAI_MODEL || "gpt-4o";
+    return getProviderModel("OPENAI_MODEL", "gpt-4o");
 };
 /**
  * OpenAI Provider v2 - BaseProvider Implementation

package/dist/utils/providerConfig.d.ts

@@ -0,0 +1,117 @@
+/**
+ * Provider Configuration Utility
+ * Consolidated configuration helpers for all AI providers
+ * Eliminates duplicate error messages and configuration logic
+ * Enhanced with format validation and advanced error classification
+ */
+/**
+ * Configuration options for provider validation
+ */
+export interface ProviderConfigOptions {
+    providerName: string;
+    envVarName: string;
+    setupUrl: string;
+    description: string;
+    instructions: string[];
+    fallbackEnvVars?: string[];
+}
+/**
+ * Enhanced validation result with format checking
+ */
+export interface ValidationResult {
+    isValid: boolean;
+    apiKey: string;
+    formatValid?: boolean;
+    errorType?: "missing" | "format" | "config";
+    error?: string;
+}
+/**
+ * Validates API key format for a specific provider
+ * @param providerKey Provider identifier (e.g., 'openai', 'anthropic')
+ * @param apiKey The API key to validate
+ * @returns True if format is valid
+ */
+export declare function validateApiKeyFormat(providerKey: string, apiKey: string): boolean;
+/**
+ * Enhanced validation with format checking
+ * @param config Provider configuration options
+ * @param enableFormatValidation Whether to validate API key format
+ * @returns Validation result with detailed information
+ */
+export declare function validateApiKeyEnhanced(config: ProviderConfigOptions, enableFormatValidation?: boolean): ValidationResult;
+/**
+ * Validates an API key for a provider and returns it (BACKWARD COMPATIBLE)
+ * Throws detailed error message if validation fails
+ * @param config Provider configuration options
+ * @returns The validated API key
+ */
+export declare function validateApiKey(config: ProviderConfigOptions): string;
+/**
+ * Gets a provider model with fallback to default
+ * @param envVar Environment variable name for the model
+ * @param defaultModel Default model to use if env var not set
+ * @returns The model name to use
+ */
+export declare function getProviderModel(envVar: string, defaultModel: string): string;
+/**
+ * Checks if provider credentials are available
+ * @param envVars Array of environment variable names to check
+ * @returns True if any of the credentials are available
+ */
+export declare function hasProviderCredentials(envVars: string[]): boolean;
+/**
+ * Creates Anthropic provider configuration
+ */
+export declare function createAnthropicConfig(): ProviderConfigOptions;
+/**
+ * Creates OpenAI provider configuration
+ */
+export declare function createOpenAIConfig(): ProviderConfigOptions;
+/**
+ * Creates HuggingFace provider configuration
+ */
+export declare function createHuggingFaceConfig(): ProviderConfigOptions;
+/**
+ * Creates Mistral provider configuration
+ */
+export declare function createMistralConfig(): ProviderConfigOptions;
+/**
+ * Creates AWS Access Key configuration for Bedrock
+ */
+export declare function createAWSAccessKeyConfig(): ProviderConfigOptions;
+/**
+ * Creates AWS Secret Key configuration for Bedrock
+ */
+export declare function createAWSSecretConfig(): ProviderConfigOptions;
+/**
+ * Creates Azure OpenAI API Key configuration
+ */
+export declare function createAzureAPIKeyConfig(): ProviderConfigOptions;
+/**
+ * Creates Azure OpenAI Endpoint configuration
+ */
+export declare function createAzureEndpointConfig(): ProviderConfigOptions;
+/**
+ * Creates Google Vertex Project ID configuration
+ */
+export declare function createVertexProjectConfig(): ProviderConfigOptions;
+/**
+ * Creates Google Cloud Authentication configuration
+ */
+export declare function createGoogleAuthConfig(): ProviderConfigOptions;
+/**
+ * Creates Anthropic Base Provider configuration
+ */
+export declare function createAnthropicBaseConfig(): ProviderConfigOptions;
+/**
+ * Gets AWS Region with default fallback
+ */
+export declare function getAWSRegion(): string;
+/**
+ * Gets AWS Session Token if available
+ */
+export declare function getAWSSessionToken(): string | undefined;
+/**
+ * Checks if HuggingFace credentials are available
+ */
+export declare function hasHuggingFaceCredentials(): boolean;

package/dist/utils/providerConfig.js

@@ -0,0 +1,353 @@
+/**
+ * Provider Configuration Utility
+ * Consolidated configuration helpers for all AI providers
+ * Eliminates duplicate error messages and configuration logic
+ * Enhanced with format validation and advanced error classification
+ */
+/**
+ * API key format validation patterns (extracted from advanced validation system)
+ */
+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,}$/,
+    aws: /^[A-Z0-9]{20}$/, // Access Key ID format
+    "google-vertex": /^[A-Za-z0-9\-_]{1,}$/, // Project ID format
+};
+/**
+ * Validates API key format for a specific provider
+ * @param providerKey Provider identifier (e.g., 'openai', 'anthropic')
+ * @param apiKey The API key to validate
+ * @returns True if format is valid
+ */
+export function validateApiKeyFormat(providerKey, apiKey) {
+    const format = API_KEY_FORMATS[providerKey.toLowerCase()];
+    if (!format) {
+        // No format validation available, assume valid if not empty
+        return apiKey.length > 0;
+    }
+    return format.test(apiKey);
+}
+/**
+ * Enhanced validation with format checking
+ * @param config Provider configuration options
+ * @param enableFormatValidation Whether to validate API key format
+ * @returns Validation result with detailed information
+ */
+export function validateApiKeyEnhanced(config, enableFormatValidation = false) {
+    // Check primary environment variable
+    let apiKey = process.env[config.envVarName];
+    // Check fallback environment variables if provided
+    if (!apiKey && config.fallbackEnvVars) {
+        for (const fallbackVar of config.fallbackEnvVars) {
+            apiKey = process.env[fallbackVar];
+            if (apiKey) {
+                break;
+            }
+        }
+    }
+    if (!apiKey) {
+        return {
+            isValid: false,
+            apiKey: "",
+            errorType: "missing",
+            error: createConfigErrorMessage(config),
+        };
+    }
+    // Optional format validation
+    if (enableFormatValidation) {
+        const providerKey = config.providerName.toLowerCase().replace(/\s/g, "-");
+        const formatValid = validateApiKeyFormat(providerKey, apiKey);
+        if (!formatValid) {
+            return {
+                isValid: false,
+                apiKey,
+                formatValid: false,
+                errorType: "format",
+                error: `Invalid ${config.providerName} API key format. Please check your API key.`,
+            };
+        }
+    }
+    return {
+        isValid: true,
+        apiKey,
+        formatValid: enableFormatValidation ? true : undefined,
+    };
+}
+/**
+ * Validates an API key for a provider and returns it (BACKWARD COMPATIBLE)
+ * Throws detailed error message if validation fails
+ * @param config Provider configuration options
+ * @returns The validated API key
+ */
+export function validateApiKey(config) {
+    // Check primary environment variable
+    let apiKey = process.env[config.envVarName];
+    // Check fallback environment variables if provided
+    if (!apiKey && config.fallbackEnvVars) {
+        for (const fallbackVar of config.fallbackEnvVars) {
+            apiKey = process.env[fallbackVar];
+            if (apiKey) {
+                break;
+            }
+        }
+    }
+    if (!apiKey) {
+        throw new Error(createConfigErrorMessage(config));
+    }
+    return apiKey;
+}
+/**
+ * Creates a standardized configuration error message
+ * @param config Provider configuration options
+ * @returns Formatted error message with setup instructions
+ */
+function createConfigErrorMessage(config) {
+    const envVarsList = config.fallbackEnvVars
+        ? [config.envVarName, ...config.fallbackEnvVars].join(" or ")
+        : config.envVarName;
+    return `❌ ${config.providerName} Provider Configuration Error
+
+Missing required environment variable: ${envVarsList}
+
+🔧 Step 1: Get ${config.description}
+${config.instructions.join("\n")}
+
+🔧 Step 2: Set Environment Variable
+Add to your .env file:
+${config.envVarName}=your_key_here
+
+🔧 Step 3: Restart Application
+Restart your application to load the new environment variables.`;
+}
+/**
+ * Gets a provider model with fallback to default
+ * @param envVar Environment variable name for the model
+ * @param defaultModel Default model to use if env var not set
+ * @returns The model name to use
+ */
+export function getProviderModel(envVar, defaultModel) {
+    return process.env[envVar] || defaultModel;
+}
+/**
+ * Checks if provider credentials are available
+ * @param envVars Array of environment variable names to check
+ * @returns True if any of the credentials are available
+ */
+export function hasProviderCredentials(envVars) {
+    return envVars.some((envVar) => !!process.env[envVar]);
+}
+// =============================================================================
+// PROVIDER-SPECIFIC CONFIGURATION CREATORS
+// =============================================================================
+/**
+ * Creates Anthropic provider configuration
+ */
+export function createAnthropicConfig() {
+    return {
+        providerName: "Anthropic",
+        envVarName: "ANTHROPIC_API_KEY",
+        setupUrl: "https://console.anthropic.com/",
+        description: "Anthropic API Key",
+        instructions: [
+            "1. Visit: https://console.anthropic.com/",
+            "2. Sign in or create an account",
+            "3. Go to API Keys section",
+            "4. Create a new API key",
+        ],
+    };
+}
+/**
+ * Creates OpenAI provider configuration
+ */
+export function createOpenAIConfig() {
+    return {
+        providerName: "OPENAI",
+        envVarName: "OPENAI_API_KEY",
+        setupUrl: "https://platform.openai.com/api-keys",
+        description: "Credentials",
+        instructions: [
+            "1. Visit: https://platform.openai.com/api-keys",
+            "2. Create new API key",
+            "3. Copy the key",
+        ],
+    };
+}
+/**
+ * Creates HuggingFace provider configuration
+ */
+export function createHuggingFaceConfig() {
+    return {
+        providerName: "HuggingFace",
+        envVarName: "HUGGINGFACE_API_KEY",
+        setupUrl: "https://huggingface.co/settings/tokens",
+        description: "Credentials",
+        instructions: [
+            "1. Visit: https://huggingface.co/settings/tokens",
+            "2. Create new API token",
+            "3. Copy the token",
+        ],
+        fallbackEnvVars: ["HF_TOKEN"],
+    };
+}
+/**
+ * Creates Mistral provider configuration
+ */
+export function createMistralConfig() {
+    return {
+        providerName: "Mistral",
+        envVarName: "MISTRAL_API_KEY",
+        setupUrl: "https://console.mistral.ai/",
+        description: "API key",
+        instructions: [
+            "1. Visit: https://console.mistral.ai/",
+            "2. Create or sign in to your account",
+            "3. Generate a new API key",
+        ],
+    };
+}
+/**
+ * Creates AWS Access Key configuration for Bedrock
+ */
+export function createAWSAccessKeyConfig() {
+    return {
+        providerName: "AWS Bedrock",
+        envVarName: "AWS_ACCESS_KEY_ID",
+        setupUrl: "https://console.aws.amazon.com/iam/",
+        description: "AWS Credentials",
+        instructions: [
+            "1. Visit: https://console.aws.amazon.com/iam/",
+            "2. Create IAM user with Bedrock permissions",
+            "3. Generate access key",
+        ],
+    };
+}
+/**
+ * Creates AWS Secret Key configuration for Bedrock
+ */
+export function createAWSSecretConfig() {
+    return {
+        providerName: "AWS Bedrock",
+        envVarName: "AWS_SECRET_ACCESS_KEY",
+        setupUrl: "https://console.aws.amazon.com/iam/",
+        description: "AWS Credentials",
+        instructions: [
+            "1. Visit: https://console.aws.amazon.com/iam/",
+            "2. Create IAM user with Bedrock permissions",
+            "3. Generate access key",
+        ],
+    };
+}
+/**
+ * Creates Azure OpenAI API Key configuration
+ */
+export function createAzureAPIKeyConfig() {
+    return {
+        providerName: "Azure OpenAI",
+        envVarName: "AZURE_OPENAI_API_KEY",
+        setupUrl: "https://portal.azure.com/",
+        description: "Azure OpenAI API Key",
+        instructions: [
+            "1. Visit: https://portal.azure.com/",
+            "2. Create or access Azure OpenAI resource",
+            "3. Get API key from Keys and Endpoint section",
+        ],
+    };
+}
+/**
+ * Creates Azure OpenAI Endpoint configuration
+ */
+export function createAzureEndpointConfig() {
+    return {
+        providerName: "Azure OpenAI",
+        envVarName: "AZURE_OPENAI_ENDPOINT",
+        setupUrl: "https://portal.azure.com/",
+        description: "Azure OpenAI Endpoint",
+        instructions: [
+            "1. Visit: https://portal.azure.com/",
+            "2. Access your Azure OpenAI resource",
+            "3. Copy endpoint URL from Keys and Endpoint section",
+        ],
+    };
+}
+/**
+ * Creates Google Vertex Project ID configuration
+ */
+export function createVertexProjectConfig() {
+    return {
+        providerName: "Google Vertex AI",
+        envVarName: "GOOGLE_CLOUD_PROJECT_ID",
+        setupUrl: "https://console.cloud.google.com/",
+        description: "Google Cloud Credentials",
+        instructions: [
+            "1. Visit: https://console.cloud.google.com/",
+            "2. Create or select a project",
+            "3. Enable Vertex AI API",
+            "4. Set up authentication",
+        ],
+        fallbackEnvVars: ["VERTEX_PROJECT_ID"],
+    };
+}
+/**
+ * Creates Google Cloud Authentication configuration
+ */
+export function createGoogleAuthConfig() {
+    return {
+        providerName: "Google Vertex AI",
+        envVarName: "GOOGLE_APPLICATION_CREDENTIALS",
+        setupUrl: "https://console.cloud.google.com/",
+        description: "Google Cloud authentication",
+        instructions: [
+            "🔧 Option 1: Service Account Key File",
+            "GOOGLE_APPLICATION_CREDENTIALS=/path/to/service-account.json",
+            "",
+            "🔧 Option 2: Service Account Key (Base64)",
+            "GOOGLE_SERVICE_ACCOUNT_KEY=base64_encoded_key",
+            "",
+            "🔧 Option 3: Individual Credentials",
+            "GOOGLE_AUTH_CLIENT_EMAIL=your-service-account@project.iam.gserviceaccount.com",
+            "GOOGLE_AUTH_PRIVATE_KEY=-----BEGIN PRIVATE KEY-----...",
+        ],
+        fallbackEnvVars: ["GOOGLE_SERVICE_ACCOUNT_KEY", "GOOGLE_AUTH_CLIENT_EMAIL"],
+    };
+}
+/**
+ * Creates Anthropic Base Provider configuration
+ */
+export function createAnthropicBaseConfig() {
+    return {
+        providerName: "ANTHROPIC",
+        envVarName: "ANTHROPIC_API_KEY",
+        setupUrl: "https://console.anthropic.com/",
+        description: "Credentials",
+        instructions: [
+            "Get your API key from https://console.anthropic.com/",
+            "",
+            "💡 Step 2: Add to your .env file (or export in CLI):",
+        ],
+    };
+}
+// =============================================================================
+// HELPER FUNCTIONS FOR SPECIFIC PROVIDER NEEDS
+// =============================================================================
+/**
+ * Gets AWS Region with default fallback
+ */
+export function getAWSRegion() {
+    return process.env.AWS_REGION || "us-east-1";
+}
+/**
+ * Gets AWS Session Token if available
+ */
+export function getAWSSessionToken() {
+    return process.env.AWS_SESSION_TOKEN;
+}
+/**
+ * Checks if HuggingFace credentials are available
+ */
+export function hasHuggingFaceCredentials() {
+    return hasProviderCredentials(["HUGGINGFACE_API_KEY", "HF_TOKEN"]);
+}

package/dist/utils/providerUtils.d.ts

@@ -1,5 +1,6 @@
 /**
- * Get the best available provider based on preferences and availability (async)
+ * Get the best available provider based on real-time availability checks
+ * Enhanced version consolidated from providerUtils-fixed.ts
  * @param requestedProvider - Optional preferred provider name
  * @returns The best provider name to use
  */