@juspay/neurolink 7.44.0 → 7.45.0

package/CHANGELOG.md

@@ -1,3 +1,9 @@
+## [7.45.0](https://github.com/juspay/neurolink/compare/v7.44.0...v7.45.0) (2025-09-24)
+
+### Features
+
+- **(provider):** Add support to provide region while streaming or generating for few providers ([a0a5bed](https://github.com/juspay/neurolink/commit/a0a5bed2bba4118dde149713708e36d4d29e1aae))
+
 ## [7.44.0](https://github.com/juspay/neurolink/compare/v7.43.0...v7.44.0) (2025-09-24)
 
 ### Features

package/dist/cli/loop/optionsSchema.d.ts

@@ -12,4 +12,4 @@ export interface OptionSchema {
  * This object provides metadata for validation and help text in the CLI loop.
  * It is derived from the main TextGenerationOptions interface to ensure consistency.
  */
-export declare const textGenerationOptionsSchema: Record<keyof Omit<TextGenerationOptions, "prompt" | "input" | "schema" | "tools" | "context" | "conversationHistory" | "conversationMessages" | "conversationMemoryConfig" | "originalPrompt" | "middleware" | "expectedOutcome" | "evaluationCriteria">, OptionSchema>;
+export declare const textGenerationOptionsSchema: Record<keyof Omit<TextGenerationOptions, "prompt" | "input" | "schema" | "tools" | "context" | "conversationHistory" | "conversationMessages" | "conversationMemoryConfig" | "originalPrompt" | "middleware" | "expectedOutcome" | "evaluationCriteria" | "region">, OptionSchema>;

package/dist/core/factory.d.ts

@@ -19,9 +19,11 @@ export declare class AIProviderFactory {
      * @param providerName - Name of the provider ('vertex', 'bedrock', 'openai')
      * @param modelName - Optional model name override
      * @param enableMCP - Optional flag to enable MCP integration (default: true)
+     * @param sdk - SDK instance
+     * @param region - Optional region override for cloud providers
      * @returns AIProvider instance
      */
-    static createProvider(providerName: string, modelName?: string | null, enableMCP?: boolean, sdk?: UnknownRecord): Promise<AIProvider>;
+    static createProvider(providerName: string, modelName?: string | null, enableMCP?: boolean, sdk?: UnknownRecord, region?: string): Promise<AIProvider>;
     /**
      * Create a provider instance with specific provider enum and model
      * @param provider - Provider enum value

package/dist/core/factory.js

@@ -52,9 +52,11 @@ export class AIProviderFactory {
      * @param providerName - Name of the provider ('vertex', 'bedrock', 'openai')
      * @param modelName - Optional model name override
      * @param enableMCP - Optional flag to enable MCP integration (default: true)
+     * @param sdk - SDK instance
+     * @param region - Optional region override for cloud providers
      * @returns AIProvider instance
      */
-    static async createProvider(providerName, modelName, enableMCP = true, sdk) {
+    static async createProvider(providerName, modelName, enableMCP = true, sdk, region) {
         const functionTag = "AIProviderFactory.createProvider";
         // Providers are registered via ProviderFactory.initialize() on first use
         logger.debug(`[${functionTag}] Provider creation started`, {
@@ -198,8 +200,8 @@ export class AIProviderFactory {
                 resolvedModelName: resolvedModelName || "not resolved",
                 finalModelName: finalModelName || "using provider default",
             });
-            // Create provider with enhanced SDK
-            const provider = await ProviderFactory.createProvider(normalizedName, finalModelName, sdk);
+            // Create provider with enhanced SDK and region support
+            const provider = await ProviderFactory.createProvider(normalizedName, finalModelName, sdk, region);
             // Summary logging in format expected by debugging tools
             logger.debug(`[AIProviderFactory] Provider creation completed { providerName: '${normalizedName}', modelName: '${finalModelName}' }`);
             logger.debug(`[AIProviderFactory] Resolved model: ${finalModelName}`);

package/dist/factories/providerFactory.d.ts

@@ -4,8 +4,8 @@ import type { UnknownRecord } from "../types/common.js";
  * Provider constructor interface - supports both sync constructors and async factory functions
  */
 type ProviderConstructor = {
-    new (modelName?: string, providerName?: string, sdk?: UnknownRecord): AIProvider;
-} | ((modelName?: string, providerName?: string, sdk?: UnknownRecord) => Promise<AIProvider>);
+    new (modelName?: string, providerName?: string, sdk?: UnknownRecord, region?: string): AIProvider;
+} | ((modelName?: string, providerName?: string, sdk?: UnknownRecord, region?: string) => Promise<AIProvider>);
 /**
  * Provider registration entry
  */
@@ -30,7 +30,7 @@ export declare class ProviderFactory {
     /**
      * Create a provider instance
      */
-    static createProvider(providerName: AIProviderName | string, modelName?: string, sdk?: UnknownRecord): Promise<AIProvider>;
+    static createProvider(providerName: AIProviderName | string, modelName?: string, sdk?: UnknownRecord, region?: string): Promise<AIProvider>;
     /**
      * Check if a provider is registered
      */

package/dist/factories/providerFactory.js

@@ -28,7 +28,7 @@ export class ProviderFactory {
     /**
      * Create a provider instance
      */
-    static async createProvider(providerName, modelName, sdk) {
+    static async createProvider(providerName, modelName, sdk, region) {
         // Note: Providers are registered explicitly by ProviderRegistry to avoid circular dependencies
         const normalizedName = providerName.toLowerCase();
         const registration = this.providers.get(normalizedName);
@@ -54,7 +54,7 @@ export class ProviderFactory {
             }
             let result;
             try {
-                const factoryResult = registration.constructor(model, providerName, sdk);
+                const factoryResult = registration.constructor(model, providerName, sdk, region);
                 // Handle both sync and async results
                 result =
                     factoryResult instanceof Promise
@@ -66,7 +66,7 @@ export class ProviderFactory {
                     registration.constructor.prototype.constructor ===
                         registration.constructor) {
                     try {
-                        result = new registration.constructor(model, providerName, sdk);
+                        result = new registration.constructor(model, providerName, sdk, region);
                     }
                     catch (constructorError) {
                         throw new Error(`Both factory function and constructor failed. Factory error: ${factoryError}. Constructor error: ${constructorError}`);

package/dist/factories/providerRegistry.js

@@ -39,9 +39,9 @@ export class ProviderRegistry {
                 return new AnthropicProvider(modelName, sdk);
             }, "claude-3-5-sonnet-20241022", ["claude", "anthropic"]);
             // Register Amazon Bedrock provider
-            ProviderFactory.registerProvider(AIProviderName.BEDROCK, async (modelName, _providerName, sdk) => {
+            ProviderFactory.registerProvider(AIProviderName.BEDROCK, async (modelName, _providerName, sdk, region) => {
                 const { AmazonBedrockProvider } = await import("../providers/amazonBedrock.js");
-                return new AmazonBedrockProvider(modelName, sdk);
+                return new AmazonBedrockProvider(modelName, sdk, region);
             }, undefined, // Let provider read BEDROCK_MODEL from .env
             ["bedrock", "aws"]);
             // Register Azure OpenAI provider
@@ -54,9 +54,9 @@ export class ProviderRegistry {
                 process.env.AZURE_OPENAI_DEPLOYMENT_ID ||
                 "gpt-4o-mini", ["azure", "azureOpenai"]);
             // Register Google Vertex AI provider
-            ProviderFactory.registerProvider(AIProviderName.VERTEX, async (modelName, providerName, sdk) => {
+            ProviderFactory.registerProvider(AIProviderName.VERTEX, async (modelName, providerName, sdk, region) => {
                 const { GoogleVertexProvider } = await import("../providers/googleVertex.js");
-                return new GoogleVertexProvider(modelName, providerName, sdk);
+                return new GoogleVertexProvider(modelName, providerName, sdk, region);
             }, "claude-sonnet-4@20250514", ["vertex", "googleVertex"]);
             // Register Hugging Face provider (Unified Router implementation)
             ProviderFactory.registerProvider(AIProviderName.HUGGINGFACE, async (modelName) => {
@@ -85,9 +85,9 @@ export class ProviderRegistry {
             }, process.env.OPENAI_COMPATIBLE_MODEL || undefined, // Enable auto-discovery when no model specified
             ["openai-compatible", "openrouter", "vllm", "compatible"]);
             // Register Amazon SageMaker provider
-            ProviderFactory.registerProvider(AIProviderName.SAGEMAKER, async (modelName, _providerName, _sdk) => {
+            ProviderFactory.registerProvider(AIProviderName.SAGEMAKER, async (modelName, _providerName, _sdk, region) => {
                 const { AmazonSageMakerProvider } = await import("../providers/amazonSagemaker.js");
-                return new AmazonSageMakerProvider(modelName);
+                return new AmazonSageMakerProvider(modelName, region);
             }, process.env.SAGEMAKER_MODEL || "sagemaker-model", ["sagemaker", "aws-sagemaker"]);
             logger.debug("All providers registered successfully");
             this.registered = true;

package/dist/lib/core/factory.d.ts

@@ -19,9 +19,11 @@ export declare class AIProviderFactory {
      * @param providerName - Name of the provider ('vertex', 'bedrock', 'openai')
      * @param modelName - Optional model name override
      * @param enableMCP - Optional flag to enable MCP integration (default: true)
+     * @param sdk - SDK instance
+     * @param region - Optional region override for cloud providers
      * @returns AIProvider instance
      */
-    static createProvider(providerName: string, modelName?: string | null, enableMCP?: boolean, sdk?: UnknownRecord): Promise<AIProvider>;
+    static createProvider(providerName: string, modelName?: string | null, enableMCP?: boolean, sdk?: UnknownRecord, region?: string): Promise<AIProvider>;
     /**
      * Create a provider instance with specific provider enum and model
      * @param provider - Provider enum value

package/dist/lib/core/factory.js

@@ -52,9 +52,11 @@ export class AIProviderFactory {
      * @param providerName - Name of the provider ('vertex', 'bedrock', 'openai')
      * @param modelName - Optional model name override
      * @param enableMCP - Optional flag to enable MCP integration (default: true)
+     * @param sdk - SDK instance
+     * @param region - Optional region override for cloud providers
      * @returns AIProvider instance
      */
-    static async createProvider(providerName, modelName, enableMCP = true, sdk) {
+    static async createProvider(providerName, modelName, enableMCP = true, sdk, region) {
         const functionTag = "AIProviderFactory.createProvider";
         // Providers are registered via ProviderFactory.initialize() on first use
         logger.debug(`[${functionTag}] Provider creation started`, {
@@ -198,8 +200,8 @@ export class AIProviderFactory {
                 resolvedModelName: resolvedModelName || "not resolved",
                 finalModelName: finalModelName || "using provider default",
             });
-            // Create provider with enhanced SDK
-            const provider = await ProviderFactory.createProvider(normalizedName, finalModelName, sdk);
+            // Create provider with enhanced SDK and region support
+            const provider = await ProviderFactory.createProvider(normalizedName, finalModelName, sdk, region);
             // Summary logging in format expected by debugging tools
             logger.debug(`[AIProviderFactory] Provider creation completed { providerName: '${normalizedName}', modelName: '${finalModelName}' }`);
             logger.debug(`[AIProviderFactory] Resolved model: ${finalModelName}`);

package/dist/lib/factories/providerFactory.d.ts

@@ -4,8 +4,8 @@ import type { UnknownRecord } from "../types/common.js";
  * Provider constructor interface - supports both sync constructors and async factory functions
  */
 type ProviderConstructor = {
-    new (modelName?: string, providerName?: string, sdk?: UnknownRecord): AIProvider;
-} | ((modelName?: string, providerName?: string, sdk?: UnknownRecord) => Promise<AIProvider>);
+    new (modelName?: string, providerName?: string, sdk?: UnknownRecord, region?: string): AIProvider;
+} | ((modelName?: string, providerName?: string, sdk?: UnknownRecord, region?: string) => Promise<AIProvider>);
 /**
  * Provider registration entry
  */
@@ -30,7 +30,7 @@ export declare class ProviderFactory {
     /**
      * Create a provider instance
      */
-    static createProvider(providerName: AIProviderName | string, modelName?: string, sdk?: UnknownRecord): Promise<AIProvider>;
+    static createProvider(providerName: AIProviderName | string, modelName?: string, sdk?: UnknownRecord, region?: string): Promise<AIProvider>;
     /**
      * Check if a provider is registered
      */

package/dist/lib/factories/providerFactory.js

@@ -28,7 +28,7 @@ export class ProviderFactory {
     /**
      * Create a provider instance
      */
-    static async createProvider(providerName, modelName, sdk) {
+    static async createProvider(providerName, modelName, sdk, region) {
         // Note: Providers are registered explicitly by ProviderRegistry to avoid circular dependencies
         const normalizedName = providerName.toLowerCase();
         const registration = this.providers.get(normalizedName);
@@ -54,7 +54,7 @@ export class ProviderFactory {
             }
             let result;
             try {
-                const factoryResult = registration.constructor(model, providerName, sdk);
+                const factoryResult = registration.constructor(model, providerName, sdk, region);
                 // Handle both sync and async results
                 result =
                     factoryResult instanceof Promise
@@ -66,7 +66,7 @@ export class ProviderFactory {
                     registration.constructor.prototype.constructor ===
                         registration.constructor) {
                     try {
-                        result = new registration.constructor(model, providerName, sdk);
+                        result = new registration.constructor(model, providerName, sdk, region);
                     }
                     catch (constructorError) {
                         throw new Error(`Both factory function and constructor failed. Factory error: ${factoryError}. Constructor error: ${constructorError}`);

package/dist/lib/factories/providerRegistry.js

@@ -39,9 +39,9 @@ export class ProviderRegistry {
                 return new AnthropicProvider(modelName, sdk);
             }, "claude-3-5-sonnet-20241022", ["claude", "anthropic"]);
             // Register Amazon Bedrock provider
-            ProviderFactory.registerProvider(AIProviderName.BEDROCK, async (modelName, _providerName, sdk) => {
+            ProviderFactory.registerProvider(AIProviderName.BEDROCK, async (modelName, _providerName, sdk, region) => {
                 const { AmazonBedrockProvider } = await import("../providers/amazonBedrock.js");
-                return new AmazonBedrockProvider(modelName, sdk);
+                return new AmazonBedrockProvider(modelName, sdk, region);
             }, undefined, // Let provider read BEDROCK_MODEL from .env
             ["bedrock", "aws"]);
             // Register Azure OpenAI provider
@@ -54,9 +54,9 @@ export class ProviderRegistry {
                 process.env.AZURE_OPENAI_DEPLOYMENT_ID ||
                 "gpt-4o-mini", ["azure", "azureOpenai"]);
             // Register Google Vertex AI provider
-            ProviderFactory.registerProvider(AIProviderName.VERTEX, async (modelName, providerName, sdk) => {
+            ProviderFactory.registerProvider(AIProviderName.VERTEX, async (modelName, providerName, sdk, region) => {
                 const { GoogleVertexProvider } = await import("../providers/googleVertex.js");
-                return new GoogleVertexProvider(modelName, providerName, sdk);
+                return new GoogleVertexProvider(modelName, providerName, sdk, region);
             }, "claude-sonnet-4@20250514", ["vertex", "googleVertex"]);
             // Register Hugging Face provider (Unified Router implementation)
             ProviderFactory.registerProvider(AIProviderName.HUGGINGFACE, async (modelName) => {
@@ -85,9 +85,9 @@ export class ProviderRegistry {
             }, process.env.OPENAI_COMPATIBLE_MODEL || undefined, // Enable auto-discovery when no model specified
             ["openai-compatible", "openrouter", "vllm", "compatible"]);
             // Register Amazon SageMaker provider
-            ProviderFactory.registerProvider(AIProviderName.SAGEMAKER, async (modelName, _providerName, _sdk) => {
+            ProviderFactory.registerProvider(AIProviderName.SAGEMAKER, async (modelName, _providerName, _sdk, region) => {
                 const { AmazonSageMakerProvider } = await import("../providers/amazonSagemaker.js");
-                return new AmazonSageMakerProvider(modelName);
+                return new AmazonSageMakerProvider(modelName, region);
             }, process.env.SAGEMAKER_MODEL || "sagemaker-model", ["sagemaker", "aws-sagemaker"]);
             logger.debug("All providers registered successfully");
             this.registered = true;

package/dist/lib/neurolink.js

@@ -1082,6 +1082,7 @@ export class NeuroLink {
             evaluationDomain: options.evaluationDomain,
             toolUsageContext: options.toolUsageContext,
             input: options.input, // This includes text, images, and content arrays
+            region: options.region,
         };
         // Apply factory enhancement using centralized utilities
         const textOptions = enhanceTextGenerationOptions(baseOptions, factoryResult);
@@ -1410,7 +1411,8 @@ export class NeuroLink {
             const conversationMessages = await getConversationMessages(this.conversationMemory, options);
             // Create provider and generate
             const provider = await AIProviderFactory.createProvider(providerName, options.model, !options.disableTools, // Pass disableTools as inverse of enableMCP
-            this);
+            this, // Pass SDK instance
+            options.region);
             // ADD: Emit connection events for all providers (Bedrock-compatible)
             this.emitter.emit("connected");
             this.emitter.emit("message", `${providerName} provider initialized successfully`);
@@ -1520,7 +1522,8 @@ export class NeuroLink {
                 // Get conversation messages for context
                 const conversationMessages = await getConversationMessages(this.conversationMemory, options);
                 const provider = await AIProviderFactory.createProvider(providerName, options.model, !options.disableTools, // Pass disableTools as inverse of enableMCP
-                this);
+                this, // Pass SDK instance
+                options.region);
                 // ADD: Emit connection events for successful provider creation (Bedrock-compatible)
                 this.emitter.emit("connected");
                 this.emitter.emit("message", `${providerName} provider initialized successfully`);
@@ -1897,7 +1900,8 @@ export class NeuroLink {
         // Simplified placeholder - in the actual implementation this would contain the complex MCP stream logic
         const providerName = await getBestProvider(options.provider);
         const provider = await AIProviderFactory.createProvider(providerName, options.model, !options.disableTools, // Pass disableTools as inverse of enableMCP
-        this);
+        this, // Pass SDK instance
+        options.region);
         // Enable tool execution for the provider using BaseProvider method
         provider.setupToolExecutor({
             customTools: this.getCustomTools(),

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

@@ -6,7 +6,8 @@ import type { NeuroLink } from "../neurolink.js";
 export declare class AmazonBedrockProvider extends BaseProvider {
     private bedrockClient;
     private conversationHistory;
-    constructor(modelName?: string, neurolink?: NeuroLink);
+    private region;
+    constructor(modelName?: string, neurolink?: NeuroLink, region?: string);
     /**
      * Perform initial health check to catch credential/connectivity issues early
      * This prevents the health check failure we saw in production logs

package/dist/lib/providers/amazonBedrock.js

@@ -7,8 +7,10 @@ import { convertZodToJsonSchema } from "../utils/schemaConversion.js";
 export class AmazonBedrockProvider extends BaseProvider {
     bedrockClient;
     conversationHistory = [];
-    constructor(modelName, neurolink) {
+    region;
+    constructor(modelName, neurolink, region) {
         super(modelName, "bedrock", neurolink);
+        this.region = region || process.env.AWS_REGION || "us-east-1";
         logger.debug("[AmazonBedrockProvider] Starting constructor with extensive logging for debugging");
         // Log environment variables for debugging
         logger.debug(`[AmazonBedrockProvider] Environment check: AWS_REGION=${process.env.AWS_REGION || "undefined"}, AWS_ACCESS_KEY_ID=${process.env.AWS_ACCESS_KEY_ID ? "SET" : "undefined"}, AWS_SECRET_ACCESS_KEY=${process.env.AWS_SECRET_ACCESS_KEY ? "SET" : "undefined"}`);
@@ -17,14 +19,14 @@ export class AmazonBedrockProvider extends BaseProvider {
             // Absolutely no proxy interference - let AWS SDK handle everything natively
             logger.debug("[AmazonBedrockProvider] Creating BedrockRuntimeClient with clean configuration");
             this.bedrockClient = new BedrockRuntimeClient({
-                region: process.env.AWS_REGION || "us-east-1",
+                region: this.region,
                 // Clean configuration - AWS SDK will handle credentials via:
                 // 1. IAM roles (preferred in production)
                 // 2. Environment variables
                 // 3. AWS config files
                 // 4. Instance metadata
             });
-            logger.debug(`[AmazonBedrockProvider] Successfully created BedrockRuntimeClient with model: ${this.modelName}, region: ${process.env.AWS_REGION || "us-east-1"}`);
+            logger.debug(`[AmazonBedrockProvider] Successfully created BedrockRuntimeClient with model: ${this.modelName}, region: ${this.region}`);
             // Immediate health check to catch credential issues early
             this.performInitialHealthCheck();
         }
@@ -39,7 +41,7 @@ export class AmazonBedrockProvider extends BaseProvider {
      */
     async performInitialHealthCheck() {
         const bedrockClient = new BedrockClient({
-            region: process.env.AWS_REGION || "us-east-1",
+            region: this.region,
         });
         try {
             logger.debug("[AmazonBedrockProvider] Starting initial health check to validate credentials and connectivity");

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

@@ -16,7 +16,7 @@ export declare class AmazonSageMakerProvider extends BaseProvider {
     private sagemakerModel;
     private sagemakerConfig;
     private modelConfig;
-    constructor(modelName?: string, endpointName?: string);
+    constructor(modelName?: string, endpointName?: string, region?: string);
     protected getProviderName(): AIProviderName;
     protected getDefaultModel(): string;
     protected getAISDKModel(): LanguageModelV1;

package/dist/lib/providers/amazonSagemaker.js

@@ -17,11 +17,11 @@ export class AmazonSageMakerProvider extends BaseProvider {
     sagemakerModel;
     sagemakerConfig;
     modelConfig;
-    constructor(modelName, endpointName) {
+    constructor(modelName, endpointName, region) {
         super(modelName, "sagemaker");
         try {
             // Load and validate configuration
-            this.sagemakerConfig = getSageMakerConfig();
+            this.sagemakerConfig = getSageMakerConfig(region);
             this.modelConfig = getSageMakerModelConfig(endpointName || getDefaultSageMakerEndpoint());
             // Create the proper LanguageModel (v2) implementation
             this.sagemakerModel = new SageMakerLanguageModel(this.modelName, this.sagemakerConfig, this.modelConfig);

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

@@ -25,7 +25,7 @@ export declare class GoogleVertexProvider extends BaseProvider {
     private static readonly MAX_CACHE_SIZE;
     private static maxTokensCache;
     private static maxTokensCacheTime;
-    constructor(modelName?: string, _providerName?: string, sdk?: unknown);
+    constructor(modelName?: string, _providerName?: string, sdk?: unknown, region?: string);
     protected getProviderName(): AIProviderName;
     protected getDefaultModel(): string;
     /**

package/dist/lib/providers/googleVertex.js

@@ -46,10 +46,10 @@ const hasGoogleCredentials = () => {
             process.env.GOOGLE_AUTH_PRIVATE_KEY));
 };
 // Enhanced Vertex settings creation with authentication fallback and proxy support
-const createVertexSettings = async () => {
+const createVertexSettings = async (region) => {
     const baseSettings = {
         project: getVertexProjectId(),
-        location: getVertexLocation(),
+        location: region || getVertexLocation(),
         fetch: createProxyFetch(),
     };
     // 🎯 OPTION 2: Create credentials file from environment variables at runtime
@@ -157,8 +157,7 @@ const createVertexSettings = async () => {
             private_key: requiredEnvVars.private_key.replace(/\\n/g, "\n"),
             client_email: requiredEnvVars.client_email,
             client_id: requiredEnvVars.client_id || "",
-            auth_uri: requiredEnvVars.auth_uri ||
-                "https://accounts.google.com/o/oauth2/auth",
+            auth_uri: requiredEnvVars.auth_uri || "https://accounts.google.com/o/oauth2/auth",
             token_uri: requiredEnvVars.token_uri || "https://oauth2.googleapis.com/token",
             auth_provider_x509_cert_url: requiredEnvVars.auth_provider_x509_cert_url ||
                 "https://www.googleapis.com/oauth2/v1/certs",
@@ -199,8 +198,8 @@ const createVertexSettings = async () => {
     return baseSettings;
 };
 // Create Anthropic-specific Vertex settings with the same authentication and proxy support
-const createVertexAnthropicSettings = async () => {
-    const baseVertexSettings = await createVertexSettings();
+const createVertexAnthropicSettings = async (region) => {
+    const baseVertexSettings = await createVertexSettings(region);
     // GoogleVertexAnthropicProviderSettings extends GoogleVertexProviderSettings
     // so we can use the same settings with proper typing
     return {
@@ -241,7 +240,7 @@ export class GoogleVertexProvider extends BaseProvider {
     // Memory-managed cache for maxTokens handling decisions to optimize streaming performance
     static maxTokensCache = new Map();
     static maxTokensCacheTime = 0;
-    constructor(modelName, _providerName, sdk) {
+    constructor(modelName, _providerName, sdk, region) {
         super(modelName, "vertex", sdk);
         // Validate Google Cloud credentials - now using consolidated utility
         if (!hasGoogleCredentials()) {
@@ -249,7 +248,7 @@ export class GoogleVertexProvider extends BaseProvider {
         }
         // Initialize Google Cloud configuration
         this.projectId = getVertexProjectId();
-        this.location = getVertexLocation();
+        this.location = region || getVertexLocation();
         logger.debug("Google Vertex AI BaseProvider v2 initialized", {
             modelName: this.modelName,
             projectId: this.projectId,
@@ -360,7 +359,7 @@ export class GoogleVertexProvider extends BaseProvider {
             message: "Starting Vertex settings creation with network configuration analysis",
         });
         try {
-            const vertexSettings = await createVertexSettings();
+            const vertexSettings = await createVertexSettings(this.location);
             const vertexSettingsEndTime = process.hrtime.bigint();
             const vertexSettingsDurationNs = vertexSettingsEndTime - vertexSettingsStartTime;
             logger.debug(`[GoogleVertexProvider] ✅ LOG_POINT_V009_VERTEX_SETTINGS_SUCCESS`, {
@@ -920,7 +919,7 @@ export class GoogleVertexProvider extends BaseProvider {
                 projectId: projectValidation.projectId,
                 region: projectValidation.region,
             });
-            const vertexAnthropicSettings = await createVertexAnthropicSettings();
+            const vertexAnthropicSettings = await createVertexAnthropicSettings(this.location);
             // 7. Settings Validation
             if (!vertexAnthropicSettings.project ||
                 !vertexAnthropicSettings.location) {

package/dist/lib/providers/sagemaker/config.d.ts

@@ -8,15 +8,17 @@ import type { SageMakerConfig, SageMakerModelConfig } from "./types.js";
 /**
  * Load and validate SageMaker configuration from environment variables
  *
- * Environment variable priority:
- * 1. SAGEMAKER_* variables (highest priority)
- * 2. AWS_* variables (standard AWS SDK variables)
- * 3. Default values (lowest priority)
+ * Region priority:
+ * 1. region parameter (highest priority)
+ * 2. SAGEMAKER_REGION environment variable
+ * 3. AWS_REGION environment variable
+ * 4. Default value "us-east-1" (lowest priority)
  *
+ * @param region - Optional region parameter override
  * @returns Validated SageMaker configuration
  * @throws {Error} When required configuration is missing or invalid
  */
-export declare function getSageMakerConfig(): SageMakerConfig;
+export declare function getSageMakerConfig(region?: string): SageMakerConfig;
 /**
  * Load and validate SageMaker model configuration
  *

package/dist/lib/providers/sagemaker/config.js

@@ -45,21 +45,26 @@ const modelConfigCache = new Map();
 /**
  * Load and validate SageMaker configuration from environment variables
  *
- * Environment variable priority:
- * 1. SAGEMAKER_* variables (highest priority)
- * 2. AWS_* variables (standard AWS SDK variables)
- * 3. Default values (lowest priority)
+ * Region priority:
+ * 1. region parameter (highest priority)
+ * 2. SAGEMAKER_REGION environment variable
+ * 3. AWS_REGION environment variable
+ * 4. Default value "us-east-1" (lowest priority)
  *
+ * @param region - Optional region parameter override
  * @returns Validated SageMaker configuration
  * @throws {Error} When required configuration is missing or invalid
  */
-export function getSageMakerConfig() {
+export function getSageMakerConfig(region) {
     // Return cached config if available
     if (configCache) {
         return configCache;
     }
     const config = {
-        region: process.env.SAGEMAKER_REGION || process.env.AWS_REGION || "us-east-1",
+        region: region ||
+            process.env.SAGEMAKER_REGION ||
+            process.env.AWS_REGION ||
+            "us-east-1",
         accessKeyId: process.env.AWS_ACCESS_KEY_ID || "",
         secretAccessKey: process.env.AWS_SECRET_ACCESS_KEY || "",
         sessionToken: process.env.AWS_SESSION_TOKEN,

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

@@ -22,6 +22,7 @@ export type GenerateOptions = {
     };
     provider?: AIProviderName | string;
     model?: string;
+    region?: string;
     temperature?: number;
     maxTokens?: number;
     systemPrompt?: string;
@@ -143,6 +144,7 @@ export type TextGenerationOptions = {
     };
     provider?: AIProviderName;
     model?: string;
+    region?: string;
     temperature?: number;
     maxTokens?: number;
     systemPrompt?: string;

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

@@ -137,6 +137,7 @@ export interface StreamOptions {
     };
     provider?: AIProviderName | string;
     model?: string;
+    region?: string;
     temperature?: number;
     maxTokens?: number;
     systemPrompt?: string;

package/dist/neurolink.js

@@ -1082,6 +1082,7 @@ export class NeuroLink {
             evaluationDomain: options.evaluationDomain,
             toolUsageContext: options.toolUsageContext,
             input: options.input, // This includes text, images, and content arrays
+            region: options.region,
         };
         // Apply factory enhancement using centralized utilities
         const textOptions = enhanceTextGenerationOptions(baseOptions, factoryResult);
@@ -1410,7 +1411,8 @@ export class NeuroLink {
             const conversationMessages = await getConversationMessages(this.conversationMemory, options);
             // Create provider and generate
             const provider = await AIProviderFactory.createProvider(providerName, options.model, !options.disableTools, // Pass disableTools as inverse of enableMCP
-            this);
+            this, // Pass SDK instance
+            options.region);
             // ADD: Emit connection events for all providers (Bedrock-compatible)
             this.emitter.emit("connected");
             this.emitter.emit("message", `${providerName} provider initialized successfully`);
@@ -1520,7 +1522,8 @@ export class NeuroLink {
                 // Get conversation messages for context
                 const conversationMessages = await getConversationMessages(this.conversationMemory, options);
                 const provider = await AIProviderFactory.createProvider(providerName, options.model, !options.disableTools, // Pass disableTools as inverse of enableMCP
-                this);
+                this, // Pass SDK instance
+                options.region);
                 // ADD: Emit connection events for successful provider creation (Bedrock-compatible)
                 this.emitter.emit("connected");
                 this.emitter.emit("message", `${providerName} provider initialized successfully`);
@@ -1897,7 +1900,8 @@ export class NeuroLink {
         // Simplified placeholder - in the actual implementation this would contain the complex MCP stream logic
         const providerName = await getBestProvider(options.provider);
         const provider = await AIProviderFactory.createProvider(providerName, options.model, !options.disableTools, // Pass disableTools as inverse of enableMCP
-        this);
+        this, // Pass SDK instance
+        options.region);
         // Enable tool execution for the provider using BaseProvider method
         provider.setupToolExecutor({
             customTools: this.getCustomTools(),

package/dist/providers/amazonBedrock.d.ts

@@ -6,7 +6,8 @@ import type { NeuroLink } from "../neurolink.js";
 export declare class AmazonBedrockProvider extends BaseProvider {
     private bedrockClient;
     private conversationHistory;
-    constructor(modelName?: string, neurolink?: NeuroLink);
+    private region;
+    constructor(modelName?: string, neurolink?: NeuroLink, region?: string);
     /**
      * Perform initial health check to catch credential/connectivity issues early
      * This prevents the health check failure we saw in production logs

package/dist/providers/amazonBedrock.js

@@ -7,8 +7,10 @@ import { convertZodToJsonSchema } from "../utils/schemaConversion.js";
 export class AmazonBedrockProvider extends BaseProvider {
     bedrockClient;
     conversationHistory = [];
-    constructor(modelName, neurolink) {
+    region;
+    constructor(modelName, neurolink, region) {
         super(modelName, "bedrock", neurolink);
+        this.region = region || process.env.AWS_REGION || "us-east-1";
         logger.debug("[AmazonBedrockProvider] Starting constructor with extensive logging for debugging");
         // Log environment variables for debugging
         logger.debug(`[AmazonBedrockProvider] Environment check: AWS_REGION=${process.env.AWS_REGION || "undefined"}, AWS_ACCESS_KEY_ID=${process.env.AWS_ACCESS_KEY_ID ? "SET" : "undefined"}, AWS_SECRET_ACCESS_KEY=${process.env.AWS_SECRET_ACCESS_KEY ? "SET" : "undefined"}`);
@@ -17,14 +19,14 @@ export class AmazonBedrockProvider extends BaseProvider {
             // Absolutely no proxy interference - let AWS SDK handle everything natively
             logger.debug("[AmazonBedrockProvider] Creating BedrockRuntimeClient with clean configuration");
             this.bedrockClient = new BedrockRuntimeClient({
-                region: process.env.AWS_REGION || "us-east-1",
+                region: this.region,
                 // Clean configuration - AWS SDK will handle credentials via:
                 // 1. IAM roles (preferred in production)
                 // 2. Environment variables
                 // 3. AWS config files
                 // 4. Instance metadata
             });
-            logger.debug(`[AmazonBedrockProvider] Successfully created BedrockRuntimeClient with model: ${this.modelName}, region: ${process.env.AWS_REGION || "us-east-1"}`);
+            logger.debug(`[AmazonBedrockProvider] Successfully created BedrockRuntimeClient with model: ${this.modelName}, region: ${this.region}`);
             // Immediate health check to catch credential issues early
             this.performInitialHealthCheck();
         }
@@ -39,7 +41,7 @@ export class AmazonBedrockProvider extends BaseProvider {
      */
     async performInitialHealthCheck() {
         const bedrockClient = new BedrockClient({
-            region: process.env.AWS_REGION || "us-east-1",
+            region: this.region,
         });
         try {
             logger.debug("[AmazonBedrockProvider] Starting initial health check to validate credentials and connectivity");

package/dist/providers/amazonSagemaker.d.ts

@@ -16,7 +16,7 @@ export declare class AmazonSageMakerProvider extends BaseProvider {
     private sagemakerModel;
     private sagemakerConfig;
     private modelConfig;
-    constructor(modelName?: string, endpointName?: string);
+    constructor(modelName?: string, endpointName?: string, region?: string);
     protected getProviderName(): AIProviderName;
     protected getDefaultModel(): string;
     protected getAISDKModel(): LanguageModelV1;

package/dist/providers/amazonSagemaker.js

@@ -17,11 +17,11 @@ export class AmazonSageMakerProvider extends BaseProvider {
     sagemakerModel;
     sagemakerConfig;
     modelConfig;
-    constructor(modelName, endpointName) {
+    constructor(modelName, endpointName, region) {
         super(modelName, "sagemaker");
         try {
             // Load and validate configuration
-            this.sagemakerConfig = getSageMakerConfig();
+            this.sagemakerConfig = getSageMakerConfig(region);
             this.modelConfig = getSageMakerModelConfig(endpointName || getDefaultSageMakerEndpoint());
             // Create the proper LanguageModel (v2) implementation
             this.sagemakerModel = new SageMakerLanguageModel(this.modelName, this.sagemakerConfig, this.modelConfig);

package/dist/providers/googleVertex.d.ts

@@ -25,7 +25,7 @@ export declare class GoogleVertexProvider extends BaseProvider {
     private static readonly MAX_CACHE_SIZE;
     private static maxTokensCache;
     private static maxTokensCacheTime;
-    constructor(modelName?: string, _providerName?: string, sdk?: unknown);
+    constructor(modelName?: string, _providerName?: string, sdk?: unknown, region?: string);
     protected getProviderName(): AIProviderName;
     protected getDefaultModel(): string;
     /**

package/dist/providers/googleVertex.js

@@ -46,10 +46,10 @@ const hasGoogleCredentials = () => {
             process.env.GOOGLE_AUTH_PRIVATE_KEY));
 };
 // Enhanced Vertex settings creation with authentication fallback and proxy support
-const createVertexSettings = async () => {
+const createVertexSettings = async (region) => {
     const baseSettings = {
         project: getVertexProjectId(),
-        location: getVertexLocation(),
+        location: region || getVertexLocation(),
         fetch: createProxyFetch(),
     };
     // 🎯 OPTION 2: Create credentials file from environment variables at runtime
@@ -157,8 +157,7 @@ const createVertexSettings = async () => {
             private_key: requiredEnvVars.private_key.replace(/\\n/g, "\n"),
             client_email: requiredEnvVars.client_email,
             client_id: requiredEnvVars.client_id || "",
-            auth_uri: requiredEnvVars.auth_uri ||
-                "https://accounts.google.com/o/oauth2/auth",
+            auth_uri: requiredEnvVars.auth_uri || "https://accounts.google.com/o/oauth2/auth",
             token_uri: requiredEnvVars.token_uri || "https://oauth2.googleapis.com/token",
             auth_provider_x509_cert_url: requiredEnvVars.auth_provider_x509_cert_url ||
                 "https://www.googleapis.com/oauth2/v1/certs",
@@ -199,8 +198,8 @@ const createVertexSettings = async () => {
     return baseSettings;
 };
 // Create Anthropic-specific Vertex settings with the same authentication and proxy support
-const createVertexAnthropicSettings = async () => {
-    const baseVertexSettings = await createVertexSettings();
+const createVertexAnthropicSettings = async (region) => {
+    const baseVertexSettings = await createVertexSettings(region);
     // GoogleVertexAnthropicProviderSettings extends GoogleVertexProviderSettings
     // so we can use the same settings with proper typing
     return {
@@ -241,7 +240,7 @@ export class GoogleVertexProvider extends BaseProvider {
     // Memory-managed cache for maxTokens handling decisions to optimize streaming performance
     static maxTokensCache = new Map();
     static maxTokensCacheTime = 0;
-    constructor(modelName, _providerName, sdk) {
+    constructor(modelName, _providerName, sdk, region) {
         super(modelName, "vertex", sdk);
         // Validate Google Cloud credentials - now using consolidated utility
         if (!hasGoogleCredentials()) {
@@ -249,7 +248,7 @@ export class GoogleVertexProvider extends BaseProvider {
         }
         // Initialize Google Cloud configuration
         this.projectId = getVertexProjectId();
-        this.location = getVertexLocation();
+        this.location = region || getVertexLocation();
         logger.debug("Google Vertex AI BaseProvider v2 initialized", {
             modelName: this.modelName,
             projectId: this.projectId,
@@ -360,7 +359,7 @@ export class GoogleVertexProvider extends BaseProvider {
             message: "Starting Vertex settings creation with network configuration analysis",
         });
         try {
-            const vertexSettings = await createVertexSettings();
+            const vertexSettings = await createVertexSettings(this.location);
             const vertexSettingsEndTime = process.hrtime.bigint();
             const vertexSettingsDurationNs = vertexSettingsEndTime - vertexSettingsStartTime;
             logger.debug(`[GoogleVertexProvider] ✅ LOG_POINT_V009_VERTEX_SETTINGS_SUCCESS`, {
@@ -920,7 +919,7 @@ export class GoogleVertexProvider extends BaseProvider {
                 projectId: projectValidation.projectId,
                 region: projectValidation.region,
             });
-            const vertexAnthropicSettings = await createVertexAnthropicSettings();
+            const vertexAnthropicSettings = await createVertexAnthropicSettings(this.location);
             // 7. Settings Validation
             if (!vertexAnthropicSettings.project ||
                 !vertexAnthropicSettings.location) {

package/dist/providers/sagemaker/config.d.ts

@@ -8,15 +8,17 @@ import type { SageMakerConfig, SageMakerModelConfig } from "./types.js";
 /**
  * Load and validate SageMaker configuration from environment variables
  *
- * Environment variable priority:
- * 1. SAGEMAKER_* variables (highest priority)
- * 2. AWS_* variables (standard AWS SDK variables)
- * 3. Default values (lowest priority)
+ * Region priority:
+ * 1. region parameter (highest priority)
+ * 2. SAGEMAKER_REGION environment variable
+ * 3. AWS_REGION environment variable
+ * 4. Default value "us-east-1" (lowest priority)
  *
+ * @param region - Optional region parameter override
  * @returns Validated SageMaker configuration
  * @throws {Error} When required configuration is missing or invalid
  */
-export declare function getSageMakerConfig(): SageMakerConfig;
+export declare function getSageMakerConfig(region?: string): SageMakerConfig;
 /**
  * Load and validate SageMaker model configuration
  *

package/dist/providers/sagemaker/config.js

@@ -45,21 +45,26 @@ const modelConfigCache = new Map();
 /**
  * Load and validate SageMaker configuration from environment variables
  *
- * Environment variable priority:
- * 1. SAGEMAKER_* variables (highest priority)
- * 2. AWS_* variables (standard AWS SDK variables)
- * 3. Default values (lowest priority)
+ * Region priority:
+ * 1. region parameter (highest priority)
+ * 2. SAGEMAKER_REGION environment variable
+ * 3. AWS_REGION environment variable
+ * 4. Default value "us-east-1" (lowest priority)
  *
+ * @param region - Optional region parameter override
  * @returns Validated SageMaker configuration
  * @throws {Error} When required configuration is missing or invalid
  */
-export function getSageMakerConfig() {
+export function getSageMakerConfig(region) {
     // Return cached config if available
     if (configCache) {
         return configCache;
     }
     const config = {
-        region: process.env.SAGEMAKER_REGION || process.env.AWS_REGION || "us-east-1",
+        region: region ||
+            process.env.SAGEMAKER_REGION ||
+            process.env.AWS_REGION ||
+            "us-east-1",
         accessKeyId: process.env.AWS_ACCESS_KEY_ID || "",
         secretAccessKey: process.env.AWS_SECRET_ACCESS_KEY || "",
         sessionToken: process.env.AWS_SESSION_TOKEN,

package/dist/types/generateTypes.d.ts

@@ -22,6 +22,7 @@ export type GenerateOptions = {
     };
     provider?: AIProviderName | string;
     model?: string;
+    region?: string;
     temperature?: number;
     maxTokens?: number;
     systemPrompt?: string;
@@ -143,6 +144,7 @@ export type TextGenerationOptions = {
     };
     provider?: AIProviderName;
     model?: string;
+    region?: string;
     temperature?: number;
     maxTokens?: number;
     systemPrompt?: string;

package/dist/types/streamTypes.d.ts

@@ -137,6 +137,7 @@ export interface StreamOptions {
     };
     provider?: AIProviderName | string;
     model?: string;
+    region?: string;
     temperature?: number;
     maxTokens?: number;
     systemPrompt?: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@juspay/neurolink",
-  "version": "7.44.0",
+  "version": "7.45.0",
   "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",