@juspay/neurolink 7.24.0 → 7.24.1

package/CHANGELOG.md

@@ -1,3 +1,5 @@
+## [7.24.1](https://github.com/juspay/neurolink/compare/v7.24.0...v7.24.1) (2025-08-21)
+
 ## [7.24.0](https://github.com/juspay/neurolink/compare/v7.23.0...v7.24.0) (2025-08-20)
 
 ### Features

package/dist/cli/index.js

@@ -14,6 +14,7 @@ import { fileURLToPath } from "url";
 import { addOllamaCommands } from "./commands/ollama.js";
 import { addSageMakerCommands } from "./commands/sagemaker.js";
 import { CLICommandFactory } from "./factories/commandFactory.js";
+import { AuthenticationError, AuthorizationError, NetworkError, RateLimitError, } from "../lib/types/errors.js";
 import { logger } from "../lib/utils/logger.js";
 // Get version from package.json
 const __filename = fileURLToPath(import.meta.url);
@@ -32,69 +33,8 @@ catch (error) {
 }
 // Utility Functions (Simple, Zero Maintenance)
 function handleError(error, context) {
-    const specificErrorMessage = error.message;
-    const originalErrorMessageLowerCase = error.message
-        ? error.message.toLowerCase()
-        : "";
-    const errorStringLowerCase = String(error).toLowerCase();
-    let isAuthError = false;
-    let genericMessage = specificErrorMessage; // Initialize genericMessage with the specific one
-    if (originalErrorMessageLowerCase.includes("api_key") ||
-        originalErrorMessageLowerCase.includes("google_ai_api_key") ||
-        originalErrorMessageLowerCase.includes("aws_access_key_id") ||
-        originalErrorMessageLowerCase.includes("aws_secret_access_key") ||
-        originalErrorMessageLowerCase.includes("aws_session_token") ||
-        originalErrorMessageLowerCase.includes("google_application_credentials") ||
-        originalErrorMessageLowerCase.includes("google_service_account_key") ||
-        originalErrorMessageLowerCase.includes("google_auth_client_email") ||
-        originalErrorMessageLowerCase.includes("anthropic_api_key") ||
-        originalErrorMessageLowerCase.includes("azure_openai_api_key")) {
-        isAuthError = true;
-    }
-    else if (
-    // Fallback to checking the full stringified error if direct message didn't match
-    errorStringLowerCase.includes("api_key") ||
-        errorStringLowerCase.includes("google_ai_api_key") ||
-        errorStringLowerCase.includes("aws_access_key_id") ||
-        errorStringLowerCase.includes("aws_secret_access_key") ||
-        errorStringLowerCase.includes("aws_session_token") ||
-        errorStringLowerCase.includes("google_application_credentials") ||
-        errorStringLowerCase.includes("google_service_account_key") ||
-        errorStringLowerCase.includes("google_auth_client_email") ||
-        errorStringLowerCase.includes("anthropic_api_key") ||
-        errorStringLowerCase.includes("azure_openai_api_key")) {
-        isAuthError = true;
-    }
-    if (isAuthError) {
-        genericMessage =
-            "Authentication error: Missing or invalid API key/credentials for the selected provider.";
-    }
-    else if (originalErrorMessageLowerCase.includes("enotfound") || // Prefer direct message checks
-        originalErrorMessageLowerCase.includes("econnrefused") ||
-        originalErrorMessageLowerCase.includes("invalid-endpoint") ||
-        originalErrorMessageLowerCase.includes("network error") ||
-        originalErrorMessageLowerCase.includes("could not connect") ||
-        originalErrorMessageLowerCase.includes("timeout") ||
-        errorStringLowerCase.includes("enotfound") || // Fallback to full string
-        errorStringLowerCase.includes("econnrefused") ||
-        errorStringLowerCase.includes("invalid-endpoint") ||
-        errorStringLowerCase.includes("network error") ||
-        errorStringLowerCase.includes("could not connect") ||
-        errorStringLowerCase.includes("timeout") // General timeout
-    ) {
-        genericMessage =
-            "Network error: Could not connect to the API endpoint or the request timed out.";
-    }
-    else if (errorStringLowerCase.includes("not authorized") ||
-        errorStringLowerCase.includes("permission denied")) {
-        genericMessage =
-            "Authorization error: You are not authorized to perform this action or access this resource.";
-    }
-    // If no specific condition matched, genericMessage remains error.message
-    logger.error(chalk.red(`❌ ${context} failed: ${genericMessage}`));
-    // Smart hints for common errors (just string matching!)
-    if (genericMessage.toLowerCase().includes("api key") ||
-        genericMessage.toLowerCase().includes("credential")) {
+    logger.error(chalk.red(`❌ ${context} failed: ${error.message}`));
+    if (error instanceof AuthenticationError) {
         logger.error(chalk.yellow("💡 Set Google AI Studio API key (RECOMMENDED): export GOOGLE_AI_API_KEY=AIza-..."));
         logger.error(chalk.yellow("💡 Or set OpenAI API key: export OPENAI_API_KEY=sk-..."));
         logger.error(chalk.yellow("💡 Or set AWS Bedrock credentials: export AWS_ACCESS_KEY_ID=... AWS_SECRET_ACCESS_KEY=... AWS_REGION=us-east-1"));
@@ -102,14 +42,16 @@ function handleError(error, context) {
         logger.error(chalk.yellow("💡 Or set Anthropic API key: export ANTHROPIC_API_KEY=sk-ant-..."));
         logger.error(chalk.yellow("💡 Or set Azure OpenAI credentials: export AZURE_OPENAI_API_KEY=... AZURE_OPENAI_ENDPOINT=..."));
     }
-    if (error.message.toLowerCase().includes("rate limit")) {
+    else if (error instanceof RateLimitError) {
         logger.error(chalk.yellow("💡 Try again in a few moments or use --provider vertex"));
     }
-    if (error.message.toLowerCase().includes("not authorized") ||
-        error.message.toLowerCase().includes("permission denied")) {
+    else if (error instanceof AuthorizationError) {
         logger.error(chalk.yellow("💡 Check your account permissions for the selected model/service."));
         logger.error(chalk.yellow("💡 For AWS Bedrock, ensure you have permissions for the specific model and consider using inference profile ARNs."));
     }
+    else if (error instanceof NetworkError) {
+        logger.error(chalk.yellow("💡 Check your internet connection and the provider's status page."));
+    }
     process.exit(1);
 }
 // Manual pre-validation for unknown flags

package/dist/lib/providers/anthropic.js

@@ -3,6 +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 { AuthenticationError, NetworkError, ProviderError, RateLimitError, } from "../types/errors.js";
 import { DEFAULT_MAX_TOKENS, DEFAULT_MAX_STEPS } from "../core/constants.js";
 import { validateApiKey, createAnthropicConfig, getProviderModel, } from "../utils/providerConfig.js";
 import { buildMessagesArray } from "../utils/messageBuilder.js";
@@ -50,45 +51,36 @@ export class AnthropicProvider extends BaseProvider {
     }
     handleProviderError(error) {
         if (error instanceof TimeoutError) {
-            return new Error(`Anthropic request timed out after ${error.timeout}ms: ${error.message}`);
+            throw new NetworkError(`Request timed out after ${error.timeout}ms`, this.providerName);
         }
         const errorRecord = error;
-        // Handle API key errors
-        if ((typeof errorRecord?.message === "string" &&
-            errorRecord.message.includes("API_KEY_INVALID")) ||
-            (typeof errorRecord?.message === "string" &&
-                errorRecord.message.includes("Invalid API key"))) {
-            return new Error("Invalid Anthropic API key. Please check your ANTHROPIC_API_KEY environment variable.");
+        const message = typeof errorRecord?.message === "string"
+            ? errorRecord.message
+            : "Unknown error";
+        if (message.includes("API_KEY_INVALID") ||
+            message.includes("Invalid API key")) {
+            throw new AuthenticationError("Invalid Anthropic API key. Please check your ANTHROPIC_API_KEY environment variable.", this.providerName);
         }
-        // Handle rate limiting errors
-        if (typeof errorRecord?.message === "string" &&
-            (errorRecord.message.includes("rate limit") ||
-                errorRecord.message.includes("too_many_requests") ||
-                errorRecord.message.includes("429"))) {
-            return new Error("Anthropic rate limit exceeded. Please try again later.");
+        if (message.includes("rate limit") ||
+            message.includes("too_many_requests") ||
+            message.includes("429")) {
+            throw new RateLimitError("Anthropic rate limit exceeded. Please try again later.", this.providerName);
         }
-        // Handle connection errors
-        if (typeof errorRecord?.message === "string" &&
-            (errorRecord.message.includes("ECONNRESET") ||
-                errorRecord.message.includes("ENOTFOUND") ||
-                errorRecord.message.includes("ECONNREFUSED") ||
-                errorRecord.message.includes("network") ||
-                errorRecord.message.includes("connection"))) {
-            return new Error("Anthropic API connection error. Please check your internet connection and try again.");
+        if (message.includes("ECONNRESET") ||
+            message.includes("ENOTFOUND") ||
+            message.includes("ECONNREFUSED") ||
+            message.includes("network") ||
+            message.includes("connection")) {
+            throw new NetworkError(`Connection error: ${message}`, this.providerName);
         }
-        // Handle server errors
-        if (typeof errorRecord?.message === "string" &&
-            (errorRecord.message.includes("500") ||
-                errorRecord.message.includes("502") ||
-                errorRecord.message.includes("503") ||
-                errorRecord.message.includes("504") ||
-                errorRecord.message.includes("server error"))) {
-            return new Error("Anthropic API server error. Please try again in a few moments.");
+        if (message.includes("500") ||
+            message.includes("502") ||
+            message.includes("503") ||
+            message.includes("504") ||
+            message.includes("server error")) {
+            throw new ProviderError(`Server error: ${message}`, this.providerName);
         }
-        const message = typeof errorRecord?.message === "string"
-            ? errorRecord.message
-            : "Unknown error";
-        return new Error(`Anthropic error: ${message}`);
+        throw new ProviderError(`Anthropic error: ${message}`, this.providerName);
     }
     // executeGenerate removed - BaseProvider handles all generation with tools
     async executeStream(options, analysisSchema) {

package/dist/lib/providers/googleAiStudio.js

@@ -4,6 +4,7 @@ import { GoogleAIModels } from "../core/types.js";
 import { BaseProvider } from "../core/baseProvider.js";
 import { logger } from "../utils/logger.js";
 import { createTimeoutController, TimeoutError, } from "../utils/timeout.js";
+import { AuthenticationError, NetworkError, ProviderError, RateLimitError, } from "../types/errors.js";
 import { DEFAULT_MAX_TOKENS, DEFAULT_MAX_STEPS } from "../core/constants.js";
 import { streamAnalyticsCollector } from "../core/streamAnalytics.js";
 import { buildMessagesArray } from "../utils/messageBuilder.js";
@@ -44,21 +45,19 @@ export class GoogleAIStudioProvider extends BaseProvider {
     }
     handleProviderError(error) {
         if (error instanceof TimeoutError) {
-            return new Error(`Google AI request timed out: ${error.message}`);
+            throw new NetworkError(error.message, this.providerName);
         }
         const errorRecord = error;
-        if (typeof errorRecord?.message === "string" &&
-            errorRecord.message.includes("API_KEY_INVALID")) {
-            return new Error("Invalid Google AI API key. Please check your GOOGLE_AI_API_KEY environment variable.");
-        }
-        if (typeof errorRecord?.message === "string" &&
-            errorRecord.message.includes("RATE_LIMIT_EXCEEDED")) {
-            return new Error("Google AI rate limit exceeded. Please try again later.");
-        }
         const message = typeof errorRecord?.message === "string"
             ? errorRecord.message
             : "Unknown error";
-        return new Error(`Google AI error: ${message}`);
+        if (message.includes("API_KEY_INVALID")) {
+            throw new AuthenticationError("Invalid Google AI API key. Please check your GOOGLE_AI_API_KEY environment variable.", this.providerName);
+        }
+        if (message.includes("RATE_LIMIT_EXCEEDED")) {
+            throw new RateLimitError("Google AI rate limit exceeded. Please try again later.", this.providerName);
+        }
+        throw new ProviderError(`Google AI error: ${message}`, this.providerName);
     }
     // executeGenerate removed - BaseProvider handles all generation with tools
     async executeStream(options, analysisSchema) {
@@ -119,7 +118,7 @@ export class GoogleAIStudioProvider extends BaseProvider {
     getApiKey() {
         const apiKey = process.env.GOOGLE_AI_API_KEY || process.env.GOOGLE_GENERATIVE_AI_API_KEY;
         if (!apiKey) {
-            throw new Error("GOOGLE_AI_API_KEY or GOOGLE_GENERATIVE_AI_API_KEY environment variable is not set");
+            throw new AuthenticationError("GOOGLE_AI_API_KEY or GOOGLE_GENERATIVE_AI_API_KEY environment variable is not set", this.providerName);
         }
         return apiKey;
     }

package/dist/lib/providers/openAI.js

@@ -4,6 +4,7 @@ import { AIProviderName } from "../core/types.js";
 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 { validateApiKey, createOpenAIConfig, getProviderModel, } from "../utils/providerConfig.js";
 import { streamAnalyticsCollector } from "../core/streamAnalytics.js";
@@ -53,20 +54,28 @@ export class OpenAIProvider extends BaseProvider {
     }
     handleProviderError(error) {
         if (error instanceof TimeoutError) {
-            return new Error(`OpenAI request timed out: ${error.message}`);
+            throw new NetworkError(error.message, this.providerName);
         }
         const errorObj = error;
         const message = errorObj?.message && typeof errorObj.message === "string"
             ? errorObj.message
             : "Unknown error";
+        const errorType = errorObj?.type && typeof errorObj.type === "string"
+            ? errorObj.type
+            : undefined;
         if (message.includes("API_KEY_INVALID") ||
-            message.includes("Invalid API key")) {
-            return new Error("Invalid OpenAI API key. Please check your OPENAI_API_KEY environment variable.");
+            message.includes("Invalid API key") ||
+            errorType === "invalid_api_key") {
+            throw new AuthenticationError("Invalid OpenAI API key. Please check your OPENAI_API_KEY environment variable.", this.providerName);
         }
-        if (message.includes("rate limit")) {
-            return new Error("OpenAI rate limit exceeded. Please try again later.");
+        if (message.includes("rate limit") || errorType === "rate_limit_error") {
+            throw new RateLimitError("OpenAI rate limit exceeded. Please try again later.", this.providerName);
         }
-        return new Error(`OpenAI error: ${message}`);
+        if (message.includes("model_not_found")) {
+            throw new InvalidModelError(`Model not found: ${this.modelName}`, this.providerName);
+        }
+        // Generic provider error
+        throw new ProviderError(`OpenAI error: ${message}`, this.providerName);
     }
     /**
      * executeGenerate method removed - generation is now handled by BaseProvider.

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

@@ -0,0 +1,44 @@
+/**
+ * Base error class for all NeuroLink-specific errors.
+ * This allows for easy identification of errors thrown by the SDK.
+ */
+export declare class BaseError extends Error {
+    constructor(message: string);
+}
+/**
+ * Thrown when a provider encounters a generic error.
+ */
+export declare class ProviderError extends BaseError {
+    provider?: string | undefined;
+    constructor(message: string, provider?: string | undefined);
+}
+/**
+ * Thrown for authentication-related errors, such as invalid or missing API keys.
+ */
+export declare class AuthenticationError extends ProviderError {
+    constructor(message: string, provider?: string);
+}
+/**
+ * Thrown for authorization errors, where the user does not have permission.
+ */
+export declare class AuthorizationError extends ProviderError {
+    constructor(message: string, provider?: string);
+}
+/**
+ * Thrown for network-related issues, such as connectivity problems or timeouts.
+ */
+export declare class NetworkError extends ProviderError {
+    constructor(message: string, provider?: string);
+}
+/**
+ * Thrown when an API rate limit has been exceeded.
+ */
+export declare class RateLimitError extends ProviderError {
+    constructor(message: string, provider?: string);
+}
+/**
+ * Thrown when a specified model is not found or is invalid for the provider.
+ */
+export declare class InvalidModelError extends ProviderError {
+    constructor(message: string, provider?: string);
+}

package/dist/lib/types/errors.js

@@ -0,0 +1,60 @@
+/**
+ * Base error class for all NeuroLink-specific errors.
+ * This allows for easy identification of errors thrown by the SDK.
+ */
+export class BaseError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = this.constructor.name;
+    }
+}
+/**
+ * Thrown when a provider encounters a generic error.
+ */
+export class ProviderError extends BaseError {
+    provider;
+    constructor(message, provider) {
+        super(provider ? `[${provider}] ${message}` : message);
+        this.provider = provider;
+    }
+}
+/**
+ * Thrown for authentication-related errors, such as invalid or missing API keys.
+ */
+export class AuthenticationError extends ProviderError {
+    constructor(message, provider) {
+        super(message, provider);
+    }
+}
+/**
+ * Thrown for authorization errors, where the user does not have permission.
+ */
+export class AuthorizationError extends ProviderError {
+    constructor(message, provider) {
+        super(message, provider);
+    }
+}
+/**
+ * Thrown for network-related issues, such as connectivity problems or timeouts.
+ */
+export class NetworkError extends ProviderError {
+    constructor(message, provider) {
+        super(message, provider);
+    }
+}
+/**
+ * Thrown when an API rate limit has been exceeded.
+ */
+export class RateLimitError extends ProviderError {
+    constructor(message, provider) {
+        super(message, provider);
+    }
+}
+/**
+ * Thrown when a specified model is not found or is invalid for the provider.
+ */
+export class InvalidModelError extends ProviderError {
+    constructor(message, provider) {
+        super(message, provider);
+    }
+}

package/dist/providers/anthropic.js

@@ -3,6 +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 { AuthenticationError, NetworkError, ProviderError, RateLimitError, } from "../types/errors.js";
 import { DEFAULT_MAX_TOKENS, DEFAULT_MAX_STEPS } from "../core/constants.js";
 import { validateApiKey, createAnthropicConfig, getProviderModel, } from "../utils/providerConfig.js";
 import { buildMessagesArray } from "../utils/messageBuilder.js";
@@ -50,45 +51,36 @@ export class AnthropicProvider extends BaseProvider {
     }
     handleProviderError(error) {
         if (error instanceof TimeoutError) {
-            return new Error(`Anthropic request timed out after ${error.timeout}ms: ${error.message}`);
+            throw new NetworkError(`Request timed out after ${error.timeout}ms`, this.providerName);
         }
         const errorRecord = error;
-        // Handle API key errors
-        if ((typeof errorRecord?.message === "string" &&
-            errorRecord.message.includes("API_KEY_INVALID")) ||
-            (typeof errorRecord?.message === "string" &&
-                errorRecord.message.includes("Invalid API key"))) {
-            return new Error("Invalid Anthropic API key. Please check your ANTHROPIC_API_KEY environment variable.");
+        const message = typeof errorRecord?.message === "string"
+            ? errorRecord.message
+            : "Unknown error";
+        if (message.includes("API_KEY_INVALID") ||
+            message.includes("Invalid API key")) {
+            throw new AuthenticationError("Invalid Anthropic API key. Please check your ANTHROPIC_API_KEY environment variable.", this.providerName);
         }
-        // Handle rate limiting errors
-        if (typeof errorRecord?.message === "string" &&
-            (errorRecord.message.includes("rate limit") ||
-                errorRecord.message.includes("too_many_requests") ||
-                errorRecord.message.includes("429"))) {
-            return new Error("Anthropic rate limit exceeded. Please try again later.");
+        if (message.includes("rate limit") ||
+            message.includes("too_many_requests") ||
+            message.includes("429")) {
+            throw new RateLimitError("Anthropic rate limit exceeded. Please try again later.", this.providerName);
         }
-        // Handle connection errors
-        if (typeof errorRecord?.message === "string" &&
-            (errorRecord.message.includes("ECONNRESET") ||
-                errorRecord.message.includes("ENOTFOUND") ||
-                errorRecord.message.includes("ECONNREFUSED") ||
-                errorRecord.message.includes("network") ||
-                errorRecord.message.includes("connection"))) {
-            return new Error("Anthropic API connection error. Please check your internet connection and try again.");
+        if (message.includes("ECONNRESET") ||
+            message.includes("ENOTFOUND") ||
+            message.includes("ECONNREFUSED") ||
+            message.includes("network") ||
+            message.includes("connection")) {
+            throw new NetworkError(`Connection error: ${message}`, this.providerName);
         }
-        // Handle server errors
-        if (typeof errorRecord?.message === "string" &&
-            (errorRecord.message.includes("500") ||
-                errorRecord.message.includes("502") ||
-                errorRecord.message.includes("503") ||
-                errorRecord.message.includes("504") ||
-                errorRecord.message.includes("server error"))) {
-            return new Error("Anthropic API server error. Please try again in a few moments.");
+        if (message.includes("500") ||
+            message.includes("502") ||
+            message.includes("503") ||
+            message.includes("504") ||
+            message.includes("server error")) {
+            throw new ProviderError(`Server error: ${message}`, this.providerName);
         }
-        const message = typeof errorRecord?.message === "string"
-            ? errorRecord.message
-            : "Unknown error";
-        return new Error(`Anthropic error: ${message}`);
+        throw new ProviderError(`Anthropic error: ${message}`, this.providerName);
     }
     // executeGenerate removed - BaseProvider handles all generation with tools
     async executeStream(options, analysisSchema) {

package/dist/providers/googleAiStudio.js

@@ -4,6 +4,7 @@ import { GoogleAIModels } from "../core/types.js";
 import { BaseProvider } from "../core/baseProvider.js";
 import { logger } from "../utils/logger.js";
 import { createTimeoutController, TimeoutError, } from "../utils/timeout.js";
+import { AuthenticationError, NetworkError, ProviderError, RateLimitError, } from "../types/errors.js";
 import { DEFAULT_MAX_TOKENS, DEFAULT_MAX_STEPS } from "../core/constants.js";
 import { streamAnalyticsCollector } from "../core/streamAnalytics.js";
 import { buildMessagesArray } from "../utils/messageBuilder.js";
@@ -44,21 +45,19 @@ export class GoogleAIStudioProvider extends BaseProvider {
     }
     handleProviderError(error) {
         if (error instanceof TimeoutError) {
-            return new Error(`Google AI request timed out: ${error.message}`);
+            throw new NetworkError(error.message, this.providerName);
         }
         const errorRecord = error;
-        if (typeof errorRecord?.message === "string" &&
-            errorRecord.message.includes("API_KEY_INVALID")) {
-            return new Error("Invalid Google AI API key. Please check your GOOGLE_AI_API_KEY environment variable.");
-        }
-        if (typeof errorRecord?.message === "string" &&
-            errorRecord.message.includes("RATE_LIMIT_EXCEEDED")) {
-            return new Error("Google AI rate limit exceeded. Please try again later.");
-        }
         const message = typeof errorRecord?.message === "string"
             ? errorRecord.message
             : "Unknown error";
-        return new Error(`Google AI error: ${message}`);
+        if (message.includes("API_KEY_INVALID")) {
+            throw new AuthenticationError("Invalid Google AI API key. Please check your GOOGLE_AI_API_KEY environment variable.", this.providerName);
+        }
+        if (message.includes("RATE_LIMIT_EXCEEDED")) {
+            throw new RateLimitError("Google AI rate limit exceeded. Please try again later.", this.providerName);
+        }
+        throw new ProviderError(`Google AI error: ${message}`, this.providerName);
     }
     // executeGenerate removed - BaseProvider handles all generation with tools
     async executeStream(options, analysisSchema) {
@@ -119,7 +118,7 @@ export class GoogleAIStudioProvider extends BaseProvider {
     getApiKey() {
         const apiKey = process.env.GOOGLE_AI_API_KEY || process.env.GOOGLE_GENERATIVE_AI_API_KEY;
         if (!apiKey) {
-            throw new Error("GOOGLE_AI_API_KEY or GOOGLE_GENERATIVE_AI_API_KEY environment variable is not set");
+            throw new AuthenticationError("GOOGLE_AI_API_KEY or GOOGLE_GENERATIVE_AI_API_KEY environment variable is not set", this.providerName);
         }
         return apiKey;
     }

package/dist/providers/openAI.js

@@ -4,6 +4,7 @@ import { AIProviderName } from "../core/types.js";
 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 { validateApiKey, createOpenAIConfig, getProviderModel, } from "../utils/providerConfig.js";
 import { streamAnalyticsCollector } from "../core/streamAnalytics.js";
@@ -53,20 +54,28 @@ export class OpenAIProvider extends BaseProvider {
     }
     handleProviderError(error) {
         if (error instanceof TimeoutError) {
-            return new Error(`OpenAI request timed out: ${error.message}`);
+            throw new NetworkError(error.message, this.providerName);
         }
         const errorObj = error;
         const message = errorObj?.message && typeof errorObj.message === "string"
             ? errorObj.message
             : "Unknown error";
+        const errorType = errorObj?.type && typeof errorObj.type === "string"
+            ? errorObj.type
+            : undefined;
         if (message.includes("API_KEY_INVALID") ||
-            message.includes("Invalid API key")) {
-            return new Error("Invalid OpenAI API key. Please check your OPENAI_API_KEY environment variable.");
+            message.includes("Invalid API key") ||
+            errorType === "invalid_api_key") {
+            throw new AuthenticationError("Invalid OpenAI API key. Please check your OPENAI_API_KEY environment variable.", this.providerName);
         }
-        if (message.includes("rate limit")) {
-            return new Error("OpenAI rate limit exceeded. Please try again later.");
+        if (message.includes("rate limit") || errorType === "rate_limit_error") {
+            throw new RateLimitError("OpenAI rate limit exceeded. Please try again later.", this.providerName);
         }
-        return new Error(`OpenAI error: ${message}`);
+        if (message.includes("model_not_found")) {
+            throw new InvalidModelError(`Model not found: ${this.modelName}`, this.providerName);
+        }
+        // Generic provider error
+        throw new ProviderError(`OpenAI error: ${message}`, this.providerName);
     }
     /**
      * executeGenerate method removed - generation is now handled by BaseProvider.

package/dist/types/errors.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Base error class for all NeuroLink-specific errors.
+ * This allows for easy identification of errors thrown by the SDK.
+ */
+export declare class BaseError extends Error {
+    constructor(message: string);
+}
+/**
+ * Thrown when a provider encounters a generic error.
+ */
+export declare class ProviderError extends BaseError {
+    provider?: string | undefined;
+    constructor(message: string, provider?: string | undefined);
+}
+/**
+ * Thrown for authentication-related errors, such as invalid or missing API keys.
+ */
+export declare class AuthenticationError extends ProviderError {
+    constructor(message: string, provider?: string);
+}
+/**
+ * Thrown for authorization errors, where the user does not have permission.
+ */
+export declare class AuthorizationError extends ProviderError {
+    constructor(message: string, provider?: string);
+}
+/**
+ * Thrown for network-related issues, such as connectivity problems or timeouts.
+ */
+export declare class NetworkError extends ProviderError {
+    constructor(message: string, provider?: string);
+}
+/**
+ * Thrown when an API rate limit has been exceeded.
+ */
+export declare class RateLimitError extends ProviderError {
+    constructor(message: string, provider?: string);
+}
+/**
+ * Thrown when a specified model is not found or is invalid for the provider.
+ */
+export declare class InvalidModelError extends ProviderError {
+    constructor(message: string, provider?: string);
+}

package/dist/types/errors.js

@@ -0,0 +1,60 @@
+/**
+ * Base error class for all NeuroLink-specific errors.
+ * This allows for easy identification of errors thrown by the SDK.
+ */
+export class BaseError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = this.constructor.name;
+    }
+}
+/**
+ * Thrown when a provider encounters a generic error.
+ */
+export class ProviderError extends BaseError {
+    provider;
+    constructor(message, provider) {
+        super(provider ? `[${provider}] ${message}` : message);
+        this.provider = provider;
+    }
+}
+/**
+ * Thrown for authentication-related errors, such as invalid or missing API keys.
+ */
+export class AuthenticationError extends ProviderError {
+    constructor(message, provider) {
+        super(message, provider);
+    }
+}
+/**
+ * Thrown for authorization errors, where the user does not have permission.
+ */
+export class AuthorizationError extends ProviderError {
+    constructor(message, provider) {
+        super(message, provider);
+    }
+}
+/**
+ * Thrown for network-related issues, such as connectivity problems or timeouts.
+ */
+export class NetworkError extends ProviderError {
+    constructor(message, provider) {
+        super(message, provider);
+    }
+}
+/**
+ * Thrown when an API rate limit has been exceeded.
+ */
+export class RateLimitError extends ProviderError {
+    constructor(message, provider) {
+        super(message, provider);
+    }
+}
+/**
+ * Thrown when a specified model is not found or is invalid for the provider.
+ */
+export class InvalidModelError extends ProviderError {
+    constructor(message, provider) {
+        super(message, provider);
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@juspay/neurolink",
-  "version": "7.24.0",
+  "version": "7.24.1",
   "description": "Universal AI Development Platform with working MCP integration, multi-provider support, and professional CLI. Built-in tools operational, 58+ external MCP servers discoverable. Connect to filesystem, GitHub, database operations, and more. Build, test, and deploy AI applications with 9 major providers: OpenAI, Anthropic, Google AI, AWS Bedrock, Azure, Hugging Face, Ollama, and Mistral AI.",
   "author": {
     "name": "Juspay Technologies",