@juspay/neurolink 10.8.4 → 10.8.5

package/dist/{providers/googleAiStudio.js → lib/providers/googleAiStudio/client.js}

@@ -1,18 +1,18 @@
-import { ErrorCategory, ErrorSeverity, GoogleAIModels, } from "../constants/enums.js";
-import { BaseProvider } from "../core/baseProvider.js";
-import { IMAGE_GENERATION_MODELS, TOOL_STORAGE_TIMEOUT_MS, } from "../core/constants.js";
-import { processUnifiedFilesArray } from "../utils/messageBuilder.js";
-import { ATTR, tracers, withClientSpan, withClientStreamSpan, withSpan, } from "../telemetry/index.js";
-import { AuthenticationError, InvalidModelError, NetworkError, ProviderError, RateLimitError, } from "../types/index.js";
-import { ERROR_CODES, NeuroLinkError } from "../utils/errorHandling.js";
-import { logger } from "../utils/logger.js";
-import { composeAbortSignals, createTimeoutController, TimeoutError, } from "../utils/timeout.js";
-import { withTimeout } from "../utils/async/index.js";
-import { estimateTokens } from "../utils/tokenEstimation.js";
-import { transformToolExecutions } from "../utils/transformationUtils.js";
-import { resolveToolExecutionRecords } from "../core/toolExecutionRecorder.js";
-import { buildGeminiResponseSchema, buildNativeConfig, buildNativeToolDeclarations, collectStreamChunks, collectStreamChunksIncremental, computeMaxSteps, createTextChannel, buildUserPartsWithMultimodal, executeNativeToolCalls, extractTextFromParts, extractThoughtSignature, handleMaxStepsTermination, prependConversationMessages, pushModelResponseToHistory, refreshNativeToolDeclarations, DedupExecuteMap, } from "./googleNativeGemini3.js";
-import { createProxyFetch } from "../proxy/proxyFetch.js";
+import { ErrorCategory, ErrorSeverity, GoogleAIModels, } from "../../constants/enums.js";
+import { BaseProvider } from "../../core/baseProvider.js";
+import { IMAGE_GENERATION_MODELS, TOOL_STORAGE_TIMEOUT_MS, } from "../../core/constants.js";
+import { processUnifiedFilesArray } from "../../utils/messageBuilder.js";
+import { ATTR, tracers, withClientSpan, withClientStreamSpan, withSpan, } from "../../telemetry/index.js";
+import { AuthenticationError, InvalidModelError, NetworkError, ProviderError, RateLimitError, } from "../../types/index.js";
+import { ERROR_CODES, NeuroLinkError } from "../../utils/errorHandling.js";
+import { logger } from "../../utils/logger.js";
+import { composeAbortSignals, createTimeoutController, TimeoutError, } from "../../utils/timeout.js";
+import { withTimeout } from "../../utils/async/index.js";
+import { estimateTokens } from "../../utils/tokenEstimation.js";
+import { transformToolExecutions } from "../../utils/transformationUtils.js";
+import { resolveToolExecutionRecords } from "../../core/toolExecutionRecorder.js";
+import { buildGeminiResponseSchema, buildNativeConfig, buildNativeToolDeclarations, collectStreamChunks, collectStreamChunksIncremental, computeMaxSteps, createTextChannel, buildUserPartsWithMultimodal, executeNativeToolCalls, extractTextFromParts, extractThoughtSignature, handleMaxStepsTermination, prependConversationMessages, pushModelResponseToHistory, refreshNativeToolDeclarations, DedupExecuteMap, } from "../googleNativeGemini3/index.js";
+import { createProxyFetch } from "../../proxy/proxyFetch.js";
 // Google AI Live API types now imported from ../types/providerSpecific.js
 // Import proper types for multimodal message handling
 // Create Google GenAI client
@@ -1442,3 +1442,4 @@ export class GoogleAIStudioProvider extends BaseProvider {
     }
 }
 export default GoogleAIStudioProvider;
+//# sourceMappingURL=client.js.map

package/dist/lib/providers/googleAiStudio/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./client.js";
+export * from "./utils.js";

package/dist/lib/providers/googleAiStudio/index.js

@@ -0,0 +1,3 @@
+export * from "./client.js";
+export * from "./utils.js";
+//# sourceMappingURL=index.js.map

package/dist/lib/providers/googleAiStudio/utils.d.ts

@@ -0,0 +1,2 @@
+import type { GenAIClient } from "../../types/index.js";
+export declare function createGoogleGenAIClient(apiKey: string): Promise<GenAIClient>;

package/dist/lib/providers/googleAiStudio/utils.js

@@ -0,0 +1,19 @@
+import { ErrorCategory, ErrorSeverity } from "../../constants/enums.js";
+import { ERROR_CODES, NeuroLinkError } from "../../utils/errorHandling.js";
+export async function createGoogleGenAIClient(apiKey) {
+    const mod = await import("@google/genai");
+    const ctor = mod.GoogleGenAI;
+    if (!ctor) {
+        throw new NeuroLinkError({
+            code: ERROR_CODES.INVALID_CONFIGURATION,
+            message: "@google/genai does not export GoogleGenAI",
+            category: ErrorCategory.CONFIGURATION,
+            severity: ErrorSeverity.CRITICAL,
+            retriable: false,
+            context: { module: "@google/genai", expectedExport: "GoogleGenAI" },
+        });
+    }
+    const Ctor = ctor;
+    return new Ctor({ apiKey });
+}
+//# sourceMappingURL=utils.js.map

package/dist/lib/providers/googleNativeGemini3/constants.d.ts

@@ -0,0 +1 @@
+export declare const GEMINI3_NATIVE_MAX_STEPS = 100;

package/dist/lib/providers/googleNativeGemini3/constants.js

@@ -0,0 +1,2 @@
+export const GEMINI3_NATIVE_MAX_STEPS = 100;
+//# sourceMappingURL=constants.js.map

package/dist/lib/providers/googleNativeGemini3/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./constants.js";
+export * from "./utils.js";

package/dist/lib/providers/googleNativeGemini3/index.js

@@ -0,0 +1,3 @@
+export * from "./constants.js";
+export * from "./utils.js";
+//# sourceMappingURL=index.js.map

package/dist/lib/providers/{googleNativeGemini3.d.ts → googleNativeGemini3/utils.d.ts}

@@ -8,8 +8,8 @@
  * This module extracts the functions that are duplicated between the two
  * providers so they can share a single implementation.
  */
-import type { GenerateStopReason, ThinkingConfig, ChatMessage, CollectedChunkResult, MinimalChatMessage, NativeFunctionCall, NativeFunctionResponse, NativeToolDeclarationsResult, NativeToolsConfig, TextChannel, VertexNativePart, GeminiMultimodalInput } from "../types/index.js";
-import type { Tool } from "../types/index.js";
+import type { GenerateStopReason, ThinkingConfig, ChatMessage, CollectedChunkResult, MinimalChatMessage, NativeFunctionCall, NativeFunctionResponse, NativeToolDeclarationsResult, NativeToolsConfig, TextChannel, VertexNativePart, GeminiMultimodalInput } from "../../types/index.js";
+import type { Tool } from "../../types/index.js";
 /**
  * A per-turn tool execute map that deduplicates identical tool calls.
  *

package/dist/lib/providers/{googleNativeGemini3.js → googleNativeGemini3/utils.js}

@@ -11,13 +11,13 @@
 import { randomUUID } from "node:crypto";
 import { existsSync, readFileSync } from "node:fs";
 import { extname } from "node:path";
-import { DEFAULT_CONTEXT_GUARD_RATIO, DEFAULT_MAX_STEPS, DEFAULT_TOOL_MAX_RETRIES, DEFAULT_WRAPUP_TIME_LEAD_MS, } from "../core/constants.js";
-import { logger } from "../utils/logger.js";
-import { resolveSamplingParams } from "../models/modelRegistry.js";
-import { convertZodToJsonSchema, ensureNestedSchemaTypes, inlineJsonSchema, isZodSchema, normalizeJsonSchemaObject, } from "../utils/schemaConversion.js";
-import { createNativeThinkingConfig } from "../utils/thinkingConfig.js";
-import { resolveLiveTool } from "../tools/toolDiscovery.js";
-import { jsonSchema as aiJsonSchema, tool as createAISDKTool, } from "../utils/tool.js";
+import { DEFAULT_CONTEXT_GUARD_RATIO, DEFAULT_MAX_STEPS, DEFAULT_TOOL_MAX_RETRIES, DEFAULT_WRAPUP_TIME_LEAD_MS, } from "../../core/constants.js";
+import { logger } from "../../utils/logger.js";
+import { resolveSamplingParams } from "../../models/modelRegistry.js";
+import { convertZodToJsonSchema, ensureNestedSchemaTypes, inlineJsonSchema, isZodSchema, normalizeJsonSchemaObject, } from "../../utils/schemaConversion.js";
+import { createNativeThinkingConfig } from "../../utils/thinkingConfig.js";
+import { resolveLiveTool } from "../../tools/toolDiscovery.js";
+import { jsonSchema as aiJsonSchema, tool as createAISDKTool, } from "../../utils/tool.js";
 // ── Functions ──
 /** Stable, key-order-independent serialization of tool args for the dedup key. */
 function stableStringifyForDedup(value) {
@@ -1523,4 +1523,4 @@ export async function buildUserPartsWithMultimodal(input, textOverride, logPrefi
     }
     return parts;
 }
-//# sourceMappingURL=googleNativeGemini3.js.map
+//# sourceMappingURL=utils.js.map

package/dist/{providers/googleVertex.d.ts → lib/providers/googleVertex/client.d.ts}

@@ -1,8 +1,8 @@
 import type { ZodType } from "zod";
-import { AIProviderName } from "../constants/enums.js";
-import { BaseProvider } from "../core/baseProvider.js";
-import type { EnhancedGenerateResult, TextGenerationOptions, StreamOptions, StreamResult, VertexAnthropicMessage, ChatMessage, MinimalChatMessage } from "../types/index.js";
-import type { Schema, LanguageModel } from "../types/index.js";
+import { AIProviderName } from "../../constants/enums.js";
+import { BaseProvider } from "../../core/baseProvider.js";
+import type { EnhancedGenerateResult, TextGenerationOptions, StreamOptions, StreamResult, VertexAnthropicMessage, ChatMessage, MinimalChatMessage } from "../../types/index.js";
+import type { Schema, LanguageModel } from "../../types/index.js";
 export declare function buildAnthropicHistoryMessages(conversationMessages: Array<ChatMessage | MinimalChatMessage>): VertexAnthropicMessage[];
 export declare function appendUserMessage(messages: VertexAnthropicMessage[], content: VertexAnthropicMessage["content"]): void;
 /**

package/dist/lib/providers/{googleVertex.js → googleVertex/client.js}

@@ -3,38 +3,38 @@
 import fs from "fs";
 import path from "path";
 import os from "os";
-import { AIProviderName, ErrorCategory, ErrorSeverity, } from "../constants/enums.js";
-import { BaseProvider } from "../core/baseProvider.js";
-import { DEFAULT_GEMINI_STREAM_TIMEOUT_MS, DEFAULT_MAX_STEPS, DEFAULT_TOOL_EXECUTION_TIMEOUT_MS, DEFAULT_TOOL_MAX_RETRIES, GLOBAL_LOCATION_MODELS, IMAGE_GENERATION_MODELS, TOOL_STORAGE_TIMEOUT_MS, } from "../core/constants.js";
-import { ModelConfigurationManager } from "../core/modelConfiguration.js";
-import { isSchemaComplexityError } from "../core/modules/structuredOutputPolicy.js";
-import { stringifyContentSafe } from "../utils/logSanitize.js";
-import { createProxyFetch } from "../proxy/proxyFetch.js";
-import { AuthenticationError, InvalidModelError, NetworkError, ProviderError, RateLimitError, } from "../types/index.js";
-import { ERROR_CODES, NeuroLinkError } from "../utils/errorHandling.js";
-import { applyVertexAnthropicCacheBreakpoints } from "../utils/anthropicCacheBreakpoints.js";
-import { FileDetector } from "../utils/fileDetector.js";
-import { processUnifiedFilesArray } from "../utils/messageBuilder.js";
-import { logger } from "../utils/logger.js";
-import { hasRestrictedOutputLimit, RESTRICTED_OUTPUT_TOKEN_LIMIT, toVertexAnthropicModelId, } from "../utils/modelDetection.js";
-import { detectImageMimeType } from "../utils/imageDetection.js";
-import { resolveClaudeMaxTokens } from "../utils/tokenLimits.js";
-import { validateApiKey, createVertexProjectConfig, createGoogleAuthConfig, } from "../utils/providerConfig.js";
-import { convertZodToJsonSchema, inlineJsonSchema, ensureNestedSchemaTypes, } from "../utils/schemaConversion.js";
-import { createNativeThinkingConfig } from "../utils/thinkingConfig.js";
-import { TimeoutError, raceWithAbort, withTimeout, } from "../utils/async/index.js";
-import { parseTimeout } from "../utils/timeout.js";
-import { appendStepText, buildAbortedTurnMessage, buildContextCapMessage, buildToolLoopCapMessage, buildTurnStalledMessage, buildTurnTimeoutMessage, buildWrapupNudgeText, createContextGuard, createTextChannel, createTurnClock, extractThoughtSignature, isAbortError, mapGeminiFinishReason, prependConversationMessages, resolveTurnStopReason, DedupExecuteMap, } from "./googleNativeGemini3.js";
-import { getContextWindowSize } from "../constants/contextWindows.js";
-import { resolveLiveTool } from "../tools/toolDiscovery.js";
-import { ATTR, LANGFUSE_ATTR, spanJsonAttribute, tracers, withClientSpan, withClientStreamSpan, withSpan, } from "../telemetry/index.js";
+import { AIProviderName, ErrorCategory, ErrorSeverity, } from "../../constants/enums.js";
+import { BaseProvider } from "../../core/baseProvider.js";
+import { DEFAULT_GEMINI_STREAM_TIMEOUT_MS, DEFAULT_MAX_STEPS, DEFAULT_TOOL_EXECUTION_TIMEOUT_MS, DEFAULT_TOOL_MAX_RETRIES, GLOBAL_LOCATION_MODELS, IMAGE_GENERATION_MODELS, TOOL_STORAGE_TIMEOUT_MS, } from "../../core/constants.js";
+import { ModelConfigurationManager } from "../../core/modelConfiguration.js";
+import { isSchemaComplexityError } from "../../core/modules/structuredOutputPolicy.js";
+import { stringifyContentSafe } from "../../utils/logSanitize.js";
+import { createProxyFetch } from "../../proxy/proxyFetch.js";
+import { AuthenticationError, InvalidModelError, NetworkError, ProviderError, RateLimitError, } from "../../types/index.js";
+import { ERROR_CODES, NeuroLinkError } from "../../utils/errorHandling.js";
+import { applyVertexAnthropicCacheBreakpoints } from "../../utils/anthropicCacheBreakpoints.js";
+import { FileDetector } from "../../utils/fileDetector.js";
+import { processUnifiedFilesArray } from "../../utils/messageBuilder.js";
+import { logger } from "../../utils/logger.js";
+import { hasRestrictedOutputLimit, RESTRICTED_OUTPUT_TOKEN_LIMIT, toVertexAnthropicModelId, } from "../../utils/modelDetection.js";
+import { detectImageMimeType } from "../../utils/imageDetection.js";
+import { resolveClaudeMaxTokens } from "../../utils/tokenLimits.js";
+import { validateApiKey, createVertexProjectConfig, createGoogleAuthConfig, } from "../../utils/providerConfig.js";
+import { convertZodToJsonSchema, inlineJsonSchema, ensureNestedSchemaTypes, } from "../../utils/schemaConversion.js";
+import { createNativeThinkingConfig } from "../../utils/thinkingConfig.js";
+import { TimeoutError, raceWithAbort, withTimeout, } from "../../utils/async/index.js";
+import { parseTimeout } from "../../utils/timeout.js";
+import { appendStepText, buildAbortedTurnMessage, buildContextCapMessage, buildToolLoopCapMessage, buildTurnStalledMessage, buildTurnTimeoutMessage, buildWrapupNudgeText, createContextGuard, createTextChannel, createTurnClock, extractThoughtSignature, isAbortError, mapGeminiFinishReason, prependConversationMessages, resolveTurnStopReason, DedupExecuteMap, } from "../googleNativeGemini3/index.js";
+import { getContextWindowSize } from "../../constants/contextWindows.js";
+import { resolveLiveTool } from "../../tools/toolDiscovery.js";
+import { ATTR, LANGFUSE_ATTR, spanJsonAttribute, tracers, withClientSpan, withClientStreamSpan, withSpan, } from "../../telemetry/index.js";
 import { SpanKind, SpanStatusCode, context as otelContext, trace as otelTrace, } from "@opentelemetry/api";
-import { calculateCost } from "../utils/pricing.js";
-import { transformToolExecutions } from "../utils/transformationUtils.js";
-import { resolveToolExecutionRecords } from "../core/toolExecutionRecorder.js";
-import { resolveSamplingParams } from "../models/modelRegistry.js";
-import { sanitizeAnthropicMessagesForTrace } from "../utils/anthropicTraceSanitizer.js";
-import { extractMcpToolErrorMessage, extractToolFailureText, } from "../utils/mcpErrorText.js";
+import { calculateCost } from "../../utils/pricing.js";
+import { transformToolExecutions } from "../../utils/transformationUtils.js";
+import { resolveToolExecutionRecords } from "../../core/toolExecutionRecorder.js";
+import { resolveSamplingParams } from "../../models/modelRegistry.js";
+import { sanitizeAnthropicMessagesForTrace } from "../../utils/anthropicTraceSanitizer.js";
+import { extractMcpToolErrorMessage, extractToolFailureText, } from "../../utils/mcpErrorText.js";
 // Import proper types for multimodal message handling
 // Dynamic import helper for native Anthropic Vertex SDK
 let anthropicVertexModule = null;
@@ -7316,4 +7316,4 @@ export class GoogleVertexProvider extends BaseProvider {
 export default GoogleVertexProvider;
 // Re-export for compatibility
 export { GoogleVertexProvider as GoogleVertexAI };
-//# sourceMappingURL=googleVertex.js.map
+//# sourceMappingURL=client.js.map

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

@@ -0,0 +1,5 @@
+export declare const MAX_IMAGE_DOWNLOAD_BYTES: number;
+export declare const streamTracer: import("@opentelemetry/api").Tracer;
+export declare let cachedCredentialsPath: string | null;
+export declare const VERTEX_MODEL_ALIASES: Record<string, string>;
+export declare const setCachedCredentialsPath: (newPath: string | null) => void;

package/dist/lib/providers/googleVertex/constants.js

@@ -0,0 +1,27 @@
+import { trace } from "@opentelemetry/api";
+export const MAX_IMAGE_DOWNLOAD_BYTES = 10 * 1024 * 1024;
+export const streamTracer = trace.getTracer("neurolink.provider.vertex");
+export let cachedCredentialsPath = null;
+export const VERTEX_MODEL_ALIASES = {
+    // Claude 4.x shorthand aliases → versioned names
+    "claude-sonnet-4-5": "claude-sonnet-4-5@20250929",
+    "claude-opus-4-5": "claude-opus-4-5@20251124",
+    "claude-haiku-4-5": "claude-haiku-4-5@20251001",
+    "claude-sonnet-4": "claude-sonnet-4@20250514",
+    "claude-opus-4": "claude-opus-4@20250514",
+    "claude-opus-4-1": "claude-opus-4-1@20250805",
+    // Claude 3.x shorthand aliases → versioned names
+    "claude-3-7-sonnet": "claude-3-7-sonnet@20250219",
+    "claude-3-5-sonnet": "claude-3-5-sonnet-20241022",
+    "claude-3-5-haiku": "claude-3-5-haiku-20241022",
+    "claude-3-opus": "claude-3-opus-20240229",
+    "claude-3-sonnet": "claude-3-sonnet-20240229",
+    "claude-3-haiku": "claude-3-haiku-20240307",
+    // Gemini shorthand aliases
+    "gemini-3-pro": "gemini-3.1-pro-preview",
+    "gemini-3-flash": "gemini-3-flash-preview",
+};
+export const setCachedCredentialsPath = (newPath) => {
+    cachedCredentialsPath = newPath;
+};
+//# sourceMappingURL=constants.js.map

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

@@ -0,0 +1,3 @@
+export * from "./client.js";
+export * from "./constants.js";
+export * from "./utils.js";

package/dist/lib/providers/googleVertex/index.js

@@ -0,0 +1,4 @@
+export * from "./client.js";
+export * from "./constants.js";
+export * from "./utils.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1,12 @@
+import { type GoogleVertexAnthropicProviderSettings } from "@ai-sdk/google-vertex/anthropic";
+import type { GoogleVertexProviderSettings } from "@ai-sdk/google-vertex";
+import type { NeurolinkCredentials } from "../../types/index.js";
+export declare function isPrivateOrLoopbackAddress(address: string): boolean;
+export declare const hasAnthropicSupport: () => boolean;
+export declare const getVertexProjectId: () => string;
+export declare const getVertexLocation: () => string;
+export declare const getDefaultVertexModel: () => string;
+export declare const hasGoogleCredentials: () => boolean;
+export declare const createVertexSettings: (region?: string, credentials?: NeurolinkCredentials["vertex"], modelName?: string) => Promise<GoogleVertexProviderSettings>;
+export declare const createVertexAnthropicSettings: (region?: string, credentials?: NeurolinkCredentials["vertex"]) => Promise<GoogleVertexAnthropicProviderSettings>;
+export declare const isAnthropicModel: (modelName: string) => boolean;

package/dist/lib/providers/googleVertex/utils.js

@@ -0,0 +1,287 @@
+import { createVertexAnthropic, } from "@ai-sdk/google-vertex/anthropic";
+import fs from "fs";
+import os from "os";
+import path from "path";
+import { logger } from "../../utils/logger.js";
+import { createProxyFetch } from "../../proxy/proxyFetch.js";
+import { createVertexProjectConfig, validateApiKey, } from "../../utils/providerConfig.js";
+import { cachedCredentialsPath, setCachedCredentialsPath, } from "./constants.js";
+export function isPrivateOrLoopbackAddress(address) {
+    const lower = address.toLowerCase();
+    // IPv4 loopback, unspecified, and private ranges
+    if (address.startsWith("127.") || address === "0.0.0.0") {
+        return true;
+    }
+    if (address.startsWith("10.") || address.startsWith("192.168.")) {
+        return true;
+    }
+    if (/^172\.(1[6-9]|2\d|3[01])\./.test(address)) {
+        return true;
+    }
+    // IPv6 loopback, link-local, unique-local
+    if (address === "::1" ||
+        lower.startsWith("fe80:") ||
+        lower.startsWith("fc00:") ||
+        lower.startsWith("fd00:")) {
+        return true;
+    }
+    return false;
+}
+// Keep createVertexAnthropic import used by hasAnthropicSupport check above
+export const hasAnthropicSupport = () => {
+    try {
+        // Verify the anthropic module is available
+        return typeof createVertexAnthropic === "function";
+    }
+    catch {
+        return false;
+    }
+};
+export const getVertexProjectId = () => {
+    return validateApiKey(createVertexProjectConfig());
+};
+export const getVertexLocation = () => {
+    return (process.env.GOOGLE_CLOUD_LOCATION ||
+        process.env.VERTEX_LOCATION ||
+        process.env.GOOGLE_VERTEX_LOCATION ||
+        "global");
+};
+import { resolveVertexLocation } from "./client.js";
+export const getDefaultVertexModel = () => {
+    return process.env.VERTEX_MODEL || "gemini-2.5-flash";
+};
+export const hasGoogleCredentials = () => {
+    return !!(process.env.GOOGLE_APPLICATION_CREDENTIALS_NEUROLINK ||
+        process.env.GOOGLE_APPLICATION_CREDENTIALS ||
+        process.env.GOOGLE_SERVICE_ACCOUNT_KEY ||
+        (process.env.GOOGLE_AUTH_CLIENT_EMAIL &&
+            process.env.GOOGLE_AUTH_PRIVATE_KEY));
+};
+export const createVertexSettings = async (region, credentials, modelName) => {
+    const configuredLocation = credentials?.location || region || getVertexLocation();
+    const location = resolveVertexLocation(modelName, configuredLocation);
+    const project = credentials?.projectId || getVertexProjectId();
+    const baseSettings = {
+        project,
+        location,
+        fetch: createProxyFetch(),
+    };
+    // Special handling for global endpoint
+    if (location === "global") {
+        baseSettings.baseURL = `https://aiplatform.googleapis.com/v1/projects/${project}/locations/global/publishers/google`;
+        logger.debug("[GoogleVertexProvider] Using global endpoint", {
+            baseURL: baseSettings.baseURL,
+            location,
+            project,
+        });
+    }
+    // ── Per-request credentials (highest priority) ──
+    if (credentials) {
+        if (credentials.apiKey) {
+            return { ...baseSettings, apiKey: credentials.apiKey };
+        }
+        const resolvedClientEmail = credentials.clientEmail ||
+            (credentials.serviceAccountKey
+                ? JSON.parse(credentials.serviceAccountKey)
+                    .client_email
+                : undefined);
+        const resolvedPrivateKey = credentials.privateKey ||
+            (credentials.serviceAccountKey
+                ? JSON.parse(credentials.serviceAccountKey)
+                    .private_key
+                : undefined);
+        if (resolvedClientEmail && resolvedPrivateKey) {
+            return {
+                ...baseSettings,
+                googleAuthOptions: {
+                    credentials: {
+                        client_email: resolvedClientEmail,
+                        private_key: resolvedPrivateKey.replace(/\\n/g, "\n"),
+                    },
+                },
+            };
+        }
+    }
+    // 🎯 OPTION 2: Create credentials file from environment variables at runtime
+    const requiredEnvVarsForFile = {
+        type: process.env.GOOGLE_AUTH_TYPE,
+        project_id: process.env.GOOGLE_AUTH_BREEZE_PROJECT_ID,
+        private_key: process.env.GOOGLE_AUTH_PRIVATE_KEY,
+        client_email: process.env.GOOGLE_AUTH_CLIENT_EMAIL,
+        client_id: process.env.GOOGLE_AUTH_CLIENT_ID,
+        auth_uri: process.env.GOOGLE_AUTH_AUTH_URI,
+        token_uri: process.env.GOOGLE_AUTH_TOKEN_URI,
+        auth_provider_x509_cert_url: process.env.GOOGLE_AUTH_AUTH_PROVIDER_CERT_URL,
+        client_x509_cert_url: process.env.GOOGLE_AUTH_CLIENT_CERT_URL,
+        universe_domain: process.env.GOOGLE_AUTH_UNIVERSE_DOMAIN,
+    };
+    if (requiredEnvVarsForFile.client_email &&
+        requiredEnvVarsForFile.private_key) {
+        // Return cached path if already written and still exists on disk
+        if (cachedCredentialsPath && fs.existsSync(cachedCredentialsPath)) {
+            process.env.GOOGLE_APPLICATION_CREDENTIALS = cachedCredentialsPath;
+            return baseSettings;
+        }
+        try {
+            const serviceAccountCredentials = {
+                type: requiredEnvVarsForFile.type || "service_account",
+                project_id: requiredEnvVarsForFile.project_id || getVertexProjectId(),
+                private_key: requiredEnvVarsForFile.private_key.replace(/\\n/g, "\n"),
+                client_email: requiredEnvVarsForFile.client_email,
+                client_id: requiredEnvVarsForFile.client_id || "",
+                auth_uri: requiredEnvVarsForFile.auth_uri ||
+                    "https://accounts.google.com/o/oauth2/auth",
+                token_uri: requiredEnvVarsForFile.token_uri ||
+                    "https://oauth2.googleapis.com/token",
+                auth_provider_x509_cert_url: requiredEnvVarsForFile.auth_provider_x509_cert_url ||
+                    "https://www.googleapis.com/oauth2/v1/certs",
+                client_x509_cert_url: requiredEnvVarsForFile.client_x509_cert_url || "",
+                universe_domain: requiredEnvVarsForFile.universe_domain || "googleapis.com",
+            };
+            const tmpDir = os.tmpdir();
+            const credentialsFileName = `google-credentials-${Date.now()}-${Math.random().toString(36).substring(2, 11)}.json`;
+            const credentialsFilePath = path.join(tmpDir, credentialsFileName);
+            fs.writeFileSync(credentialsFilePath, JSON.stringify(serviceAccountCredentials, null, 2), { mode: 0o600 });
+            setCachedCredentialsPath(credentialsFilePath);
+            process.once("exit", () => {
+                try {
+                    if (cachedCredentialsPath && fs.existsSync(cachedCredentialsPath)) {
+                        fs.unlinkSync(cachedCredentialsPath);
+                    }
+                }
+                catch {
+                    /* ignore cleanup errors */
+                }
+            });
+            process.env.GOOGLE_APPLICATION_CREDENTIALS = credentialsFilePath;
+            return baseSettings;
+        }
+        catch {
+            // Silent error handling for runtime credentials file creation
+        }
+    }
+    // 🎯 OPTION 1: Check for principal account authentication
+    if (process.env.GOOGLE_APPLICATION_CREDENTIALS_NEUROLINK) {
+        const credentialsPath = process.env.GOOGLE_APPLICATION_CREDENTIALS_NEUROLINK;
+        let fileExists;
+        try {
+            fileExists = fs.existsSync(credentialsPath);
+        }
+        catch {
+            fileExists = false;
+        }
+        if (fileExists) {
+            return baseSettings;
+        }
+    }
+    else {
+        if (process.env.GOOGLE_APPLICATION_CREDENTIALS) {
+            const credentialsPath = process.env.GOOGLE_APPLICATION_CREDENTIALS;
+            let fileExists;
+            try {
+                fileExists = fs.existsSync(credentialsPath);
+            }
+            catch {
+                fileExists = false;
+            }
+            if (fileExists) {
+                return baseSettings;
+            }
+        }
+    }
+    const requiredEnvVars = {
+        type: process.env.GOOGLE_AUTH_TYPE,
+        project_id: process.env.GOOGLE_AUTH_BREEZE_PROJECT_ID,
+        private_key: process.env.GOOGLE_AUTH_PRIVATE_KEY,
+        client_email: process.env.GOOGLE_AUTH_CLIENT_EMAIL,
+        client_id: process.env.GOOGLE_AUTH_CLIENT_ID,
+        auth_uri: process.env.GOOGLE_AUTH_AUTH_URI,
+        token_uri: process.env.GOOGLE_AUTH_TOKEN_URI,
+        auth_provider_x509_cert_url: process.env.GOOGLE_AUTH_AUTH_PROVIDER_CERT_URL,
+        client_x509_cert_url: process.env.GOOGLE_AUTH_CLIENT_CERT_URL,
+        universe_domain: process.env.GOOGLE_AUTH_UNIVERSE_DOMAIN,
+    };
+    if (requiredEnvVars.client_email && requiredEnvVars.private_key) {
+        logger.debug("Using explicit service account credentials authentication", {
+            authMethod: "explicit_service_account_credentials",
+            hasType: !!requiredEnvVars.type,
+            hasProjectId: !!requiredEnvVars.project_id,
+            hasClientEmail: !!requiredEnvVars.client_email,
+            hasPrivateKey: !!requiredEnvVars.private_key,
+            hasClientId: !!requiredEnvVars.client_id,
+            hasAuthUri: !!requiredEnvVars.auth_uri,
+            hasTokenUri: !!requiredEnvVars.token_uri,
+            hasAuthProviderCertUrl: !!requiredEnvVars.auth_provider_x509_cert_url,
+            hasClientCertUrl: !!requiredEnvVars.client_x509_cert_url,
+            hasUniverseDomain: !!requiredEnvVars.universe_domain,
+            credentialsCompleteness: "using_individual_env_vars_as_fallback",
+        });
+        const serviceAccountCredentials = {
+            type: requiredEnvVars.type || "service_account",
+            project_id: requiredEnvVars.project_id || getVertexProjectId(),
+            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",
+            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",
+            client_x509_cert_url: requiredEnvVars.client_x509_cert_url || "",
+            universe_domain: requiredEnvVars.universe_domain || "googleapis.com",
+        };
+        return {
+            ...baseSettings,
+            googleAuthOptions: {
+                credentials: serviceAccountCredentials,
+            },
+        };
+    }
+    logger.warn("No valid authentication found for Google Vertex AI", {
+        authMethod: "none",
+        authenticationAttempts: {
+            principalAccountFile: {
+                envVarSet: !!process.env.GOOGLE_APPLICATION_CREDENTIALS,
+                filePath: process.env.GOOGLE_APPLICATION_CREDENTIALS || "NOT_SET",
+                fileExists: false,
+            },
+            explicitCredentials: {
+                hasClientEmail: !!requiredEnvVars.client_email,
+                hasPrivateKey: !!requiredEnvVars.private_key,
+                hasProjectId: !!requiredEnvVars.project_id,
+                hasType: !!requiredEnvVars.type,
+                missingFields: Object.entries(requiredEnvVars)
+                    .filter(([_key, value]) => !value)
+                    .map(([key]) => key),
+            },
+        },
+        troubleshooting: [
+            "1. Ensure GOOGLE_APPLICATION_CREDENTIALS points to an existing file, OR",
+            "2. Set individual environment variables: GOOGLE_AUTH_CLIENT_EMAIL and GOOGLE_AUTH_PRIVATE_KEY",
+        ],
+    });
+    return baseSettings;
+};
+export const createVertexAnthropicSettings = async (region, credentials) => {
+    const anthropicRegion = !region || region === "global" ? "us-east5" : region;
+    const anthropicCredentials = credentials?.location
+        ? { ...credentials, location: anthropicRegion }
+        : credentials;
+    const baseVertexSettings = await createVertexSettings(anthropicRegion, anthropicCredentials);
+    return {
+        project: baseVertexSettings.project,
+        location: baseVertexSettings.location,
+        fetch: baseVertexSettings.fetch,
+        // The SDK's built-in retry honors Retry-After hints without any upper
+        // bound (a 429 with retry-after: 8549 sleeps 2.4h per retry, invisible
+        // to fallback orchestration). Retries are the orchestrator's job.
+        maxRetries: 0,
+        ...(baseVertexSettings.apiKey && { apiKey: baseVertexSettings.apiKey }),
+        ...(baseVertexSettings.googleAuthOptions && {
+            googleAuthOptions: baseVertexSettings.googleAuthOptions,
+        }),
+    };
+};
+export const isAnthropicModel = (modelName) => {
+    return modelName.toLowerCase().includes("claude");
+};
+//# sourceMappingURL=utils.js.map

package/dist/lib/providers/{huggingFace.d.ts → huggingFace/client.d.ts}

@@ -1,6 +1,6 @@
-import type { AIProviderName } from "../constants/enums.js";
-import type { NeurolinkCredentials } from "../types/index.js";
-import { OpenAIChatCompletionsProvider } from "./openaiChatCompletionsBase.js";
+import type { AIProviderName } from "../../constants/enums.js";
+import type { NeurolinkCredentials } from "../../types/index.js";
+import { OpenAIChatCompletionsProvider } from "../openaiChatCompletionsBase.js";
 /**
  * HuggingFace Provider — direct HTTP, no AI SDK.
  *

package/dist/lib/providers/{huggingFace.js → huggingFace/client.js}

@@ -1,9 +1,9 @@
-import { AuthenticationError, InvalidModelError, NetworkError, ProviderError, RateLimitError, } from "../types/index.js";
-import { logger } from "../utils/logger.js";
-import { redactUrlCredentials } from "../utils/logSanitize.js";
-import { createHuggingFaceConfig, getProviderModel, validateApiKey, } from "../utils/providerConfig.js";
-import { TimeoutError } from "../utils/timeout.js";
-import { OpenAIChatCompletionsProvider } from "./openaiChatCompletionsBase.js";
+import { AuthenticationError, InvalidModelError, NetworkError, ProviderError, RateLimitError, } from "../../types/index.js";
+import { logger } from "../../utils/logger.js";
+import { redactUrlCredentials } from "../../utils/logSanitize.js";
+import { createHuggingFaceConfig, getProviderModel, validateApiKey, } from "../../utils/providerConfig.js";
+import { TimeoutError } from "../../utils/timeout.js";
+import { OpenAIChatCompletionsProvider } from "../openaiChatCompletionsBase.js";
 const HUGGINGFACE_DEFAULT_BASE_URL = "https://router.huggingface.co/v1";
 const getHuggingFaceApiKey = () => validateApiKey(createHuggingFaceConfig());
 const getDefaultHuggingFaceModel = () => getProviderModel("HUGGINGFACE_MODEL", "microsoft/DialoGPT-medium");
@@ -98,4 +98,4 @@ export class HuggingFaceProvider extends OpenAIChatCompletionsProvider {
         return new ProviderError(`HuggingFace Provider Error: ${message}`, "huggingface");
     }
 }
-//# sourceMappingURL=huggingFace.js.map
+//# sourceMappingURL=client.js.map

package/dist/lib/providers/huggingFace/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./client.js";
+export * from "./utils.js";

package/dist/lib/providers/huggingFace/index.js

@@ -0,0 +1,3 @@
+export * from "./client.js";
+export * from "./utils.js";
+//# sourceMappingURL=index.js.map

package/dist/lib/providers/huggingFace/utils.d.ts

@@ -0,0 +1,2 @@
+export declare const getHuggingFaceApiKey: () => string;
+export declare const getDefaultHuggingFaceModel: () => string;

package/dist/lib/providers/huggingFace/utils.js

@@ -0,0 +1,8 @@
+import { createHuggingFaceConfig, getProviderModel, validateApiKey, } from "../../utils/providerConfig.js";
+export const getHuggingFaceApiKey = () => {
+    return validateApiKey(createHuggingFaceConfig());
+};
+export const getDefaultHuggingFaceModel = () => {
+    return getProviderModel("HUGGINGFACE_MODEL", "microsoft/DialoGPT-medium");
+};
+//# sourceMappingURL=utils.js.map