@juspay/neurolink 9.32.0 → 9.33.0

package/dist/client/providers/googleVertex.js

@@ -1,2936 +0,0 @@
-import dns from "node:dns";
-import { createVertex, } from "@ai-sdk/google-vertex";
-import { createVertexAnthropic, } from "@ai-sdk/google-vertex/anthropic";
-import { SpanKind, SpanStatusCode, trace } from "@opentelemetry/api";
-import { embed, embedMany, Output, stepCountIs, streamText, } from "ai";
-import fs from "fs";
-import os from "os";
-import path from "path";
-import { ErrorCategory, ErrorSeverity, } from "../constants/enums.js";
-import { BaseProvider } from "../core/baseProvider.js";
-import { DEFAULT_MAX_STEPS, GLOBAL_LOCATION_MODELS, } from "../core/constants.js";
-import { ModelConfigurationManager } from "../core/modelConfiguration.js";
-import { createProxyFetch } from "../proxy/proxyFetch.js";
-import { ATTR, tracers, withClientSpan } from "../telemetry/index.js";
-import { AuthenticationError, InvalidModelError, NetworkError, ProviderError, RateLimitError, } from "../types/errors.js";
-import { ERROR_CODES, NeuroLinkError } from "../utils/errorHandling.js";
-import { FileDetector } from "../utils/fileDetector.js";
-import { logger } from "../utils/logger.js";
-import { isGemini3Model } from "../utils/modelDetection.js";
-import { calculateCost } from "../utils/pricing.js";
-import { createGoogleAuthConfig, createVertexProjectConfig, validateApiKey, } from "../utils/providerConfig.js";
-import { convertZodToJsonSchema, inlineJsonSchema, } from "../utils/schemaConversion.js";
-import { composeAbortSignals, createTimeoutController, TimeoutError, } from "../utils/timeout.js";
-import { estimateTokens } from "../utils/tokenEstimation.js";
-import { buildNativeConfig, buildNativeToolDeclarations, collectStreamChunks, collectStreamChunksIncremental, computeMaxSteps as computeMaxStepsShared, createTextChannel, executeNativeToolCalls, extractTextFromParts, handleMaxStepsTermination, pushModelResponseToHistory, sanitizeToolsForGemini, } from "./googleNativeGemini3.js";
-import { getModelId } from "./providerTypeUtils.js";
-// Import proper types for multimodal message handling
-// Keep-alive note: Node.js native fetch and undici (used by createProxyFetch)
-// handle HTTP keep-alive internally. The fetchWithRetry wrapper in proxyFetch.ts
-// provides retry protection for transient ECONNRESET/ETIMEDOUT errors.
-//
-// Auth isolation note: @ai-sdk/google-vertex resolves auth tokens (via
-// generateAuthToken → google-auth-library) BEFORE applying the user AbortSignal
-// to the main API call. Auth token refresh uses gaxios internally, not our
-// custom fetch, so it is inherently isolated from user cancellation signals.
-// The image generation path (getImageGenerationAccessToken) has an additional
-// explicit 15s timeout per attempt for direct REST API calls.
-/** Check whether an IP address belongs to a private, loopback, or link-local range. */
-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;
-}
-const MAX_IMAGE_DOWNLOAD_BYTES = 10 * 1024 * 1024; // 10 MB
-const streamTracer = trace.getTracer("neurolink.provider.vertex");
-// Enhanced Anthropic support with direct imports
-// Using the dual provider architecture from Vercel AI SDK
-const hasAnthropicSupport = () => {
-    try {
-        // Verify the anthropic module is available
-        return typeof createVertexAnthropic === "function";
-    }
-    catch {
-        return false;
-    }
-};
-// Configuration helpers - now using consolidated utility
-const getVertexProjectId = () => {
-    return validateApiKey(createVertexProjectConfig());
-};
-const getVertexLocation = () => {
-    return (process.env.GOOGLE_CLOUD_LOCATION ||
-        process.env.VERTEX_LOCATION ||
-        process.env.GOOGLE_VERTEX_LOCATION ||
-        "us-central1");
-};
-const getDefaultVertexModel = () => {
-    // Use gemini-2.5-flash as default - latest and best price-performance model
-    // Override with VERTEX_MODEL environment variable if needed
-    return process.env.VERTEX_MODEL || "gemini-2.5-flash";
-};
-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));
-};
-// Module-level cache for runtime-created credentials file to avoid per-request writes
-let cachedCredentialsPath = null;
-// Enhanced Vertex settings creation with authentication fallback and proxy support
-const createVertexSettings = async (region) => {
-    const location = region || getVertexLocation();
-    const project = getVertexProjectId();
-    const baseSettings = {
-        project,
-        location,
-        fetch: createProxyFetch(),
-    };
-    // Special handling for global endpoint
-    // Google's global endpoint uses aiplatform.googleapis.com (no region prefix)
-    // instead of {region}-aiplatform.googleapis.com
-    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,
-        });
-    }
-    // 🎯 OPTION 2: Create credentials file from environment variables at runtime
-    // This solves the problem where GOOGLE_APPLICATION_CREDENTIALS exists in ZSHRC locally
-    // but the file doesn't exist on production servers
-    // First, try to create credentials file from individual environment variables
-    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 we have the essential fields, create a runtime credentials file (cached)
-    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 {
-            // Build complete service account credentials object
-            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",
-            };
-            // Create temporary credentials file with restricted permissions
-            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 });
-            cachedCredentialsPath = credentialsFilePath;
-            // Register cleanup on process exit to remove the credentials file
-            process.once("exit", () => {
-                try {
-                    if (cachedCredentialsPath && fs.existsSync(cachedCredentialsPath)) {
-                        fs.unlinkSync(cachedCredentialsPath);
-                    }
-                }
-                catch {
-                    /* ignore cleanup errors */
-                }
-            });
-            // Set the environment variable to point to our runtime-created file
-            process.env.GOOGLE_APPLICATION_CREDENTIALS = credentialsFilePath;
-            return baseSettings;
-        }
-        catch {
-            // Silent error handling for runtime credentials file creation
-        }
-    }
-    // 🎯 OPTION 1: Check for principal account authentication (Accept any valid GOOGLE_APPLICATION_CREDENTIALS file (service account OR ADC))
-    if (process.env.GOOGLE_APPLICATION_CREDENTIALS_NEUROLINK) {
-        const credentialsPath = process.env.GOOGLE_APPLICATION_CREDENTIALS_NEUROLINK;
-        // Check if the credentials file exists
-        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;
-            // Check if the credentials file exists
-            let fileExists;
-            try {
-                fileExists = fs.existsSync(credentialsPath);
-            }
-            catch {
-                fileExists = false;
-            }
-            if (fileExists) {
-                return baseSettings;
-            }
-        }
-    }
-    // Fallback to explicit credentials for development and production
-    // Enhanced to check ALL required fields from the .env file configuration
-    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,
-    };
-    // Check if we have the minimal required fields (client_email and private_key are essential)
-    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",
-        });
-        // Build complete service account credentials object
-        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,
-            },
-        };
-    }
-    // Log comprehensive warning if no valid authentication is available
-    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, // We already checked above
-            },
-            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;
-};
-// Create Anthropic-specific Vertex settings with the same authentication and proxy support
-const createVertexAnthropicSettings = async (region) => {
-    // The @ai-sdk/google-vertex SDK constructs Anthropic URLs as:
-    //   https://{location}-aiplatform.googleapis.com/...
-    // When location is "global", this creates "https://global-aiplatform.googleapis.com"
-    // which is invalid. The correct global endpoint omits the region prefix entirely.
-    // Since the SDK doesn't handle this, redirect "global" to "us-east5" for Anthropic.
-    const anthropicRegion = !region || region === "global" ? "us-east5" : region;
-    const baseVertexSettings = await createVertexSettings(anthropicRegion);
-    // GoogleVertexAnthropicProviderSettings extends GoogleVertexProviderSettings
-    // so we can use the same settings with proper typing
-    return {
-        project: baseVertexSettings.project,
-        location: baseVertexSettings.location,
-        fetch: baseVertexSettings.fetch,
-        ...(baseVertexSettings.googleAuthOptions && {
-            googleAuthOptions: baseVertexSettings.googleAuthOptions,
-        }),
-    };
-};
-// Helper function to determine if a model is an Anthropic model
-const isAnthropicModel = (modelName) => {
-    return modelName.toLowerCase().includes("claude");
-};
-/**
- * Vertex Model Aliases
- *
- * Maps shorthand model names to their full versioned IDs required by the
- * Vertex AI API. This allows users to pass convenient names like
- * "claude-sonnet-4-5" instead of "claude-sonnet-4-5@20250929".
- *
- * Alias resolution runs at the very start of getModel() so that all
- * downstream code (isAnthropicModel, validateAnthropicModelName, etc.)
- * sees the canonical versioned name.
- *
- * To add a new model: simply add an entry mapping the shorthand to the
- * full versioned string. No other changes are needed.
- */
-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",
-};
-/**
- * Google Vertex AI Provider v2 - BaseProvider Implementation
- *
- * Features:
- * - Extends BaseProvider for shared functionality
- * - Preserves existing Google Cloud authentication
- * - Maintains Anthropic model support via dynamic imports
- * - Fresh model creation for each request
- * - Enhanced error handling with setup guidance
- * - Tool registration and context management
- *
- * @important Structured Output Limitation (Gemini Models Only)
- * Google Gemini models on Vertex AI cannot combine function calling (tools) with
- * structured output (JSON schema). When using schemas, you MUST set disableTools: true.
- *
- * Error without disableTools:
- * "Function calling with a response mime type: 'application/json' is unsupported"
- *
- * This limitation ONLY affects Gemini models. Anthropic Claude models via Vertex
- * AI do NOT have this limitation and support both tools + schemas simultaneously.
- *
- * @example Gemini models with schemas
- * ```typescript
- * const provider = new GoogleVertexProvider("gemini-2.5-flash");
- * const result = await provider.generate({
- *   input: { text: "Analyze data" },
- *   schema: MySchema,
- *   output: { format: "json" },
- *   disableTools: true  // Required for Gemini models
- * });
- * ```
- *
- * @example Claude models (no limitation)
- * ```typescript
- * const provider = new GoogleVertexProvider("claude-3-5-sonnet-20241022");
- * const result = await provider.generate({
- *   input: { text: "Analyze data" },
- *   schema: MySchema,
- *   output: { format: "json" }
- *   // No disableTools needed - Claude supports both
- * });
- * ```
- *
- * @note Gemini 3 Pro Preview (November 2025) will support combining tools + schemas
- * @see https://cloud.google.com/vertex-ai/docs/generative-ai/learn/models
- */
-export class GoogleVertexProvider extends BaseProvider {
-    projectId;
-    location;
-    registeredTools = new Map();
-    toolContext = {};
-    // Memory-managed cache for model configuration lookups to avoid repeated calls
-    // Uses WeakMap for automatic cleanup and bounded LRU for recently used models
-    static modelConfigCache = new Map();
-    static modelConfigCacheTime = 0;
-    static CACHE_DURATION = 5 * 60 * 1000; // 5 minutes
-    static MAX_CACHE_SIZE = 50; // Prevent memory leaks by limiting cache size
-    // Memory-managed cache for maxTokens handling decisions to optimize streaming performance
-    static maxTokensCache = new Map();
-    static maxTokensCacheTime = 0;
-    constructor(modelName, _providerName, sdk, region) {
-        super(modelName, "vertex", sdk);
-        // Validate Google Cloud credentials - now using consolidated utility
-        if (!hasGoogleCredentials()) {
-            validateApiKey(createGoogleAuthConfig());
-        }
-        // Initialize Google Cloud configuration
-        this.projectId = getVertexProjectId();
-        this.location = region || getVertexLocation();
-        logger.debug("[GoogleVertexProvider] Constructor initialized", {
-            regionParam: region,
-            resolvedLocation: this.location,
-            projectId: this.projectId,
-        });
-        logger.debug("Google Vertex AI BaseProvider v2 initialized", {
-            modelName: this.modelName,
-            projectId: this.projectId,
-            location: this.location,
-            provider: this.providerName,
-        });
-    }
-    getProviderName() {
-        return "vertex";
-    }
-    getDefaultModel() {
-        return getDefaultVertexModel();
-    }
-    /**
-     * Get the default embedding model for Google Vertex
-     * @returns The default Vertex AI embedding model name
-     */
-    getDefaultEmbeddingModel() {
-        return (process.env.VERTEX_EMBEDDING_MODEL ||
-            process.env.GOOGLE_EMBEDDING_MODEL ||
-            "text-embedding-004");
-    }
-    /**
-     * Returns the Vercel AI SDK model instance for Google Vertex
-     * Creates fresh model instances for each request
-     */
-    async getAISDKModel() {
-        const model = await this.getModel();
-        return model;
-    }
-    /**
-     * Resolve a raw model name through the alias map.
-     * Used internally to normalize model names before any API calls.
-     */
-    resolveAlias(modelName) {
-        return VERTEX_MODEL_ALIASES[modelName] ?? modelName;
-    }
-    /**
-     * Initialize model creation tracking
-     */
-    initializeModelCreationLogging() {
-        const modelCreationId = `vertex-model-${Date.now()}-${Math.random().toString(36).substring(2, 11)}`;
-        const modelCreationStartTime = Date.now();
-        const modelCreationHrTimeStart = process.hrtime.bigint();
-        // Resolve shorthand model aliases (e.g. "claude-sonnet-4-5" → "claude-sonnet-4-5@20250929")
-        // before any downstream logic that depends on the versioned name.
-        const rawModelName = this.modelName || getDefaultVertexModel();
-        const modelName = VERTEX_MODEL_ALIASES[rawModelName] ?? rawModelName;
-        return {
-            modelCreationId,
-            modelCreationStartTime,
-            modelCreationHrTimeStart,
-            modelName,
-        };
-    }
-    /**
-     * Check if model is Anthropic-based and attempt creation
-     */
-    async attemptAnthropicModelCreation(modelName, modelCreationId, modelCreationStartTime, modelCreationHrTimeStart) {
-        const isAnthropic = isAnthropicModel(modelName);
-        if (!isAnthropic) {
-            return null;
-        }
-        logger.debug("Creating Anthropic model using vertexAnthropic provider", {
-            modelName,
-        });
-        if (!hasAnthropicSupport()) {
-            logger.warn(`[GoogleVertexProvider] Anthropic support not available, falling back to Google model`);
-            return null;
-        }
-        try {
-            const anthropicModel = await this.createAnthropicModel(modelName);
-            if (anthropicModel) {
-                return anthropicModel;
-            }
-            // Anthropic model creation returned null, falling back to Google model
-        }
-        catch (error) {
-            logger.error(`[GoogleVertexProvider] ❌ LOG_POINT_V006_ANTHROPIC_MODEL_ERROR`, {
-                logPoint: "V006_ANTHROPIC_MODEL_ERROR",
-                modelCreationId,
-                timestamp: new Date().toISOString(),
-                elapsedMs: Date.now() - modelCreationStartTime,
-                elapsedNs: (process.hrtime.bigint() - modelCreationHrTimeStart).toString(),
-                modelName,
-                error: error instanceof Error ? error.message : String(error),
-                errorName: error instanceof Error ? error.name : "UnknownError",
-                errorStack: error instanceof Error ? error.stack : undefined,
-                fallbackToGoogle: true,
-                message: "Anthropic model creation failed - falling back to Google model",
-            });
-        }
-        // Fall back to regular model if Anthropic not available
-        logger.warn(`Anthropic model ${modelName} requested but not available, falling back to Google model`);
-        return null;
-    }
-    /**
-     * Create Google Vertex model with comprehensive logging and error handling
-     */
-    async createGoogleVertexModel(modelName, modelCreationId, modelCreationStartTime, modelCreationHrTimeStart) {
-        logger.debug("Creating Google Vertex model", {
-            modelName,
-            project: this.projectId,
-            location: this.location,
-        });
-        const vertexSettingsStartTime = process.hrtime.bigint();
-        logger.debug(`[GoogleVertexProvider] ⚙️ LOG_POINT_V008_VERTEX_SETTINGS_START`, {
-            logPoint: "V008_VERTEX_SETTINGS_START",
-            modelCreationId,
-            timestamp: new Date().toISOString(),
-            elapsedMs: Date.now() - modelCreationStartTime,
-            elapsedNs: (process.hrtime.bigint() - modelCreationHrTimeStart).toString(),
-            vertexSettingsStartTimeNs: vertexSettingsStartTime.toString(),
-            // Network configuration analysis
-            networkConfig: {
-                projectId: this.projectId,
-                location: this.location,
-                expectedEndpoint: `https://${this.location}-aiplatform.googleapis.com`,
-                httpProxy: process.env.HTTP_PROXY || process.env.http_proxy,
-                httpsProxy: process.env.HTTPS_PROXY || process.env.https_proxy,
-                noProxy: process.env.NO_PROXY || process.env.no_proxy,
-                proxyConfigured: !!(process.env.HTTP_PROXY ||
-                    process.env.HTTPS_PROXY ||
-                    process.env.http_proxy ||
-                    process.env.https_proxy),
-            },
-            message: "Starting Vertex settings creation with network configuration analysis",
-        });
-        try {
-            const vertexSettings = await createVertexSettings(this.location);
-            const vertexSettingsEndTime = process.hrtime.bigint();
-            const vertexSettingsDurationNs = vertexSettingsEndTime - vertexSettingsStartTime;
-            logger.debug(`[GoogleVertexProvider] ✅ LOG_POINT_V009_VERTEX_SETTINGS_SUCCESS`, {
-                logPoint: "V009_VERTEX_SETTINGS_SUCCESS",
-                modelCreationId,
-                timestamp: new Date().toISOString(),
-                elapsedMs: Date.now() - modelCreationStartTime,
-                elapsedNs: (process.hrtime.bigint() - modelCreationHrTimeStart).toString(),
-                vertexSettingsDurationNs: vertexSettingsDurationNs.toString(),
-                vertexSettingsDurationMs: Number(vertexSettingsDurationNs) / 1000000,
-                // Settings analysis
-                vertexSettingsAnalysis: {
-                    hasSettings: !!vertexSettings,
-                    settingsType: typeof vertexSettings,
-                    settingsKeys: vertexSettings ? Object.keys(vertexSettings) : [],
-                    projectId: vertexSettings?.project,
-                    location: vertexSettings?.location,
-                    hasFetch: !!vertexSettings?.fetch,
-                    hasGoogleAuthOptions: !!vertexSettings?.googleAuthOptions,
-                    settingsSize: vertexSettings
-                        ? JSON.stringify(vertexSettings).length
-                        : 0,
-                },
-                message: "Vertex settings created successfully",
-            });
-            return await this.createVertexInstance(vertexSettings, modelName, modelCreationId, modelCreationStartTime, modelCreationHrTimeStart);
-        }
-        catch (error) {
-            const vertexSettingsErrorTime = process.hrtime.bigint();
-            const vertexSettingsDurationNs = vertexSettingsErrorTime - vertexSettingsStartTime;
-            const totalErrorDurationNs = vertexSettingsErrorTime - modelCreationHrTimeStart;
-            logger.error(`[GoogleVertexProvider] ❌ LOG_POINT_V014_VERTEX_SETTINGS_ERROR`, {
-                logPoint: "V014_VERTEX_SETTINGS_ERROR",
-                modelCreationId,
-                timestamp: new Date().toISOString(),
-                totalElapsedMs: Date.now() - modelCreationStartTime,
-                totalElapsedNs: totalErrorDurationNs.toString(),
-                totalErrorDurationMs: Number(totalErrorDurationNs) / 1000000,
-                vertexSettingsDurationNs: vertexSettingsDurationNs.toString(),
-                vertexSettingsDurationMs: Number(vertexSettingsDurationNs) / 1000000,
-                // Comprehensive error analysis
-                error: error instanceof Error ? error.message : String(error),
-                errorName: error instanceof Error ? error.name : "UnknownError",
-                errorStack: error instanceof Error ? error.stack : undefined,
-                // Network diagnostic information
-                networkDiagnostics: {
-                    errorCode: error?.code || "UNKNOWN",
-                    errorErrno: error?.errno || "UNKNOWN",
-                    errorAddress: error?.address || "UNKNOWN",
-                    errorPort: error?.port || "UNKNOWN",
-                    errorSyscall: error?.syscall || "UNKNOWN",
-                    errorHostname: error?.hostname || "UNKNOWN",
-                    isTimeoutError: error instanceof Error &&
-                        (error.message.includes("timeout") ||
-                            error.message.includes("ETIMEDOUT")),
-                    isNetworkError: error instanceof Error &&
-                        (error.message.includes("ENOTFOUND") ||
-                            error.message.includes("ECONNREFUSED") ||
-                            error.message.includes("ETIMEDOUT")),
-                    isAuthError: error instanceof Error &&
-                        (error.message.includes("PERMISSION_DENIED") ||
-                            error.message.includes("401") ||
-                            error.message.includes("403")),
-                    infrastructureIssue: error instanceof Error &&
-                        error.message.includes("ETIMEDOUT") &&
-                        error.message.includes("aiplatform.googleapis.com"),
-                },
-                // Environment at error time
-                errorEnvironment: {
-                    httpProxy: process.env.HTTP_PROXY || process.env.http_proxy,
-                    httpsProxy: process.env.HTTPS_PROXY || process.env.https_proxy,
-                    googleAppCreds: process.env.GOOGLE_APPLICATION_CREDENTIALS_NEUROLINK ||
-                        process.env.GOOGLE_APPLICATION_CREDENTIALS ||
-                        "NOT_SET",
-                    hasGoogleServiceKey: !!process.env.GOOGLE_SERVICE_ACCOUNT_KEY,
-                    nodeVersion: process.version,
-                    memoryUsage: process.memoryUsage(),
-                    uptime: process.uptime(),
-                },
-                message: "Vertex settings creation failed - critical network/authentication error",
-            });
-            throw error;
-        }
-    }
-    /**
-     * Create Vertex AI instance and model with comprehensive logging
-     */
-    async createVertexInstance(vertexSettings, modelName, modelCreationId, modelCreationStartTime, modelCreationHrTimeStart) {
-        const vertexInstanceStartTime = process.hrtime.bigint();
-        logger.debug(`[GoogleVertexProvider] 🏗️ LOG_POINT_V010_VERTEX_INSTANCE_START`, {
-            logPoint: "V010_VERTEX_INSTANCE_START",
-            modelCreationId,
-            timestamp: new Date().toISOString(),
-            elapsedMs: Date.now() - modelCreationStartTime,
-            elapsedNs: (process.hrtime.bigint() - modelCreationHrTimeStart).toString(),
-            vertexInstanceStartTimeNs: vertexInstanceStartTime.toString(),
-            // Pre-creation network environment
-            networkEnvironment: {
-                dnsServers: (() => {
-                    try {
-                        return dns.getServers ? dns.getServers() : "NOT_AVAILABLE";
-                    }
-                    catch {
-                        return "NOT_AVAILABLE";
-                    }
-                })(),
-                networkInterfaces: (() => {
-                    try {
-                        return Object.keys(os.networkInterfaces());
-                    }
-                    catch {
-                        return [];
-                    }
-                })(),
-                hostname: (() => {
-                    try {
-                        return os.hostname();
-                    }
-                    catch {
-                        return "UNKNOWN";
-                    }
-                })(),
-                platform: (() => {
-                    try {
-                        return os.platform();
-                    }
-                    catch {
-                        return "UNKNOWN";
-                    }
-                })(),
-                release: (() => {
-                    try {
-                        return os.release();
-                    }
-                    catch {
-                        return "UNKNOWN";
-                    }
-                })(),
-            },
-            message: "Creating Vertex AI instance",
-        });
-        const vertex = createVertex(vertexSettings);
-        const vertexInstanceEndTime = process.hrtime.bigint();
-        const vertexInstanceDurationNs = vertexInstanceEndTime - vertexInstanceStartTime;
-        logger.debug(`[GoogleVertexProvider] ✅ LOG_POINT_V011_VERTEX_INSTANCE_SUCCESS`, {
-            logPoint: "V011_VERTEX_INSTANCE_SUCCESS",
-            modelCreationId,
-            timestamp: new Date().toISOString(),
-            elapsedMs: Date.now() - modelCreationStartTime,
-            elapsedNs: (process.hrtime.bigint() - modelCreationHrTimeStart).toString(),
-            vertexInstanceDurationNs: vertexInstanceDurationNs.toString(),
-            vertexInstanceDurationMs: Number(vertexInstanceDurationNs) / 1000000,
-            hasVertexInstance: !!vertex,
-            vertexInstanceType: typeof vertex,
-            message: "Vertex AI instance created successfully",
-        });
-        const modelInstanceStartTime = process.hrtime.bigint();
-        logger.debug(`[GoogleVertexProvider] 🎯 LOG_POINT_V012_MODEL_INSTANCE_START`, {
-            logPoint: "V012_MODEL_INSTANCE_START",
-            modelCreationId,
-            timestamp: new Date().toISOString(),
-            elapsedMs: Date.now() - modelCreationStartTime,
-            elapsedNs: (process.hrtime.bigint() - modelCreationHrTimeStart).toString(),
-            modelInstanceStartTimeNs: modelInstanceStartTime.toString(),
-            modelName,
-            hasVertexInstance: !!vertex,
-            message: "Creating model instance from Vertex AI instance",
-        });
-        const model = vertex(modelName);
-        const modelInstanceEndTime = process.hrtime.bigint();
-        const modelInstanceDurationNs = modelInstanceEndTime - modelInstanceStartTime;
-        const totalModelCreationDurationNs = modelInstanceEndTime - modelCreationHrTimeStart;
-        logger.info(`[GoogleVertexProvider] 🏁 LOG_POINT_V013_MODEL_CREATION_COMPLETE`, {
-            logPoint: "V013_MODEL_CREATION_COMPLETE",
-            modelCreationId,
-            timestamp: new Date().toISOString(),
-            totalElapsedMs: Date.now() - modelCreationStartTime,
-            totalElapsedNs: totalModelCreationDurationNs.toString(),
-            totalDurationMs: Number(totalModelCreationDurationNs) / 1000000,
-            modelInstanceDurationNs: modelInstanceDurationNs.toString(),
-            modelInstanceDurationMs: Number(modelInstanceDurationNs) / 1000000,
-            // Final model analysis
-            finalModel: {
-                hasModel: !!model,
-                modelType: typeof model,
-                modelName,
-                isAnthropicModel: isAnthropicModel(modelName),
-                projectId: this.projectId,
-                location: this.location,
-            },
-            // Performance summary
-            performanceSummary: {
-                vertexSettingsDurationMs: Number(vertexInstanceDurationNs) / 1000000,
-                vertexInstanceDurationMs: Number(vertexInstanceDurationNs) / 1000000,
-                modelInstanceDurationMs: Number(modelInstanceDurationNs) / 1000000,
-                totalDurationMs: Number(totalModelCreationDurationNs) / 1000000,
-            },
-            // Memory usage
-            finalMemoryUsage: process.memoryUsage(),
-            message: "Model creation completed successfully - ready for API calls",
-        });
-        return model;
-    }
-    /**
-     * Gets the appropriate model instance (Google or Anthropic)
-     * Uses dual provider architecture for proper model routing
-     * Creates fresh instances for each request to ensure proper authentication
-     */
-    async getModel() {
-        // Initialize logging and setup (alias resolution happens inside)
-        const { modelCreationId, modelCreationStartTime, modelCreationHrTimeStart, modelName, } = this.initializeModelCreationLogging();
-        // Check if this is an Anthropic model and attempt creation
-        const anthropicModel = await this.attemptAnthropicModelCreation(modelName, modelCreationId, modelCreationStartTime, modelCreationHrTimeStart);
-        if (anthropicModel) {
-            return anthropicModel;
-        }
-        // Fall back to Google Vertex model creation
-        return await this.createGoogleVertexModel(modelName, modelCreationId, modelCreationStartTime, modelCreationHrTimeStart);
-    }
-    // executeGenerate removed - BaseProvider handles all generation with tools
-    /**
-     * Validate stream options
-     */
-    validateStreamOptionsOnly(options) {
-        this.validateStreamOptions(options);
-    }
-    async executeStream(options, analysisSchema) {
-        // Check if this is a Gemini 3 model with tools - use native SDK for thought_signature
-        const gemini3CheckModelName = this.resolveAlias(options.model || this.modelName || getDefaultVertexModel());
-        // Structured output (analysisSchema, JSON format, or schema) is incompatible with tools on Gemini.
-        // Compute once and reuse in both the native Gemini 3 gate and the streamText fallback path.
-        const wantsStructuredOutput = analysisSchema || options.output?.format === "json" || options.schema;
-        // Check for tools from options AND from SDK (MCP tools)
-        // Need to check early if we should route to native SDK
-        const gemini3CheckShouldUseTools = !options.disableTools && this.supportsTools() && !wantsStructuredOutput;
-        const optionTools = options.tools || {};
-        const sdkTools = gemini3CheckShouldUseTools ? await this.getAllTools() : {};
-        const combinedToolCount = Object.keys(optionTools).length + Object.keys(sdkTools).length;
-        const hasTools = gemini3CheckShouldUseTools && combinedToolCount > 0;
-        if (isGemini3Model(gemini3CheckModelName) && hasTools) {
-            // Process CSV files before routing to native SDK (bypasses normal message builder)
-            const processedOptions = await this.processCSVFilesForNativeSDK(options);
-            // Merge SDK tools into options for native SDK path
-            const mergedOptions = {
-                ...processedOptions,
-                tools: { ...sdkTools, ...optionTools },
-            };
-            logger.info("[GoogleVertex] Routing Gemini 3 to native SDK for tool calling", {
-                model: gemini3CheckModelName,
-                optionToolCount: Object.keys(optionTools).length,
-                sdkToolCount: Object.keys(sdkTools).length,
-                totalToolCount: combinedToolCount,
-            });
-            return this.executeNativeGemini3Stream(mergedOptions);
-        }
-        // Initialize stream execution tracking
-        const functionTag = "GoogleVertexProvider.executeStream";
-        let chunkCount = 0;
-        // Setup timeout controller
-        const timeout = this.getTimeout(options);
-        const timeoutController = createTimeoutController(timeout, this.providerName, "stream");
-        try {
-            // Validate stream options
-            this.validateStreamOptionsOnly(options);
-            // Build message array from options with multimodal support
-            // Using protected helper from BaseProvider to eliminate code duplication
-            const messages = await this.buildMessagesForStream(options);
-            const model = await this.getAISDKModelWithMiddleware(options); // This is where network connection happens!
-            // Get all available tools (direct + MCP + external + user-provided RAG tools) for streaming
-            const shouldUseTools = !options.disableTools && this.supportsTools();
-            const baseStreamTools = shouldUseTools ? await this.getAllTools() : {};
-            const rawTools = shouldUseTools
-                ? { ...baseStreamTools, ...(options.tools || {}) }
-                : {};
-            // Only sanitize for Gemini models (not Anthropic/Claude models routed through Vertex)
-            const isAnthropic = isAnthropicModel(gemini3CheckModelName);
-            let tools;
-            if (Object.keys(rawTools).length > 0 && !isAnthropic) {
-                const sanitized = sanitizeToolsForGemini(rawTools);
-                if (sanitized.dropped.length > 0) {
-                    logger.warn(`[GoogleVertex] Dropped ${sanitized.dropped.length} incompatible tool(s): ${sanitized.dropped.join(", ")}`);
-                }
-                tools =
-                    Object.keys(sanitized.tools).length > 0 ? sanitized.tools : undefined;
-            }
-            else if (isAnthropic && Object.keys(rawTools).length > 0) {
-                // Anthropic models don't need Gemini sanitization — pass tools through
-                tools = rawTools;
-            }
-            else {
-                tools = undefined;
-            }
-            logger.debug(`${functionTag}: Tools for streaming`, {
-                shouldUseTools,
-                baseToolCount: Object.keys(baseStreamTools).length,
-                externalToolCount: Object.keys(options.tools || {}).length,
-                toolCount: Object.keys(tools ?? {}).length,
-                toolNames: Object.keys(tools ?? {}),
-            });
-            // Model-specific maxTokens handling
-            const modelName = this.resolveAlias(options.model || this.modelName || getDefaultVertexModel());
-            // Use cached model configuration to determine maxTokens handling for streaming performance
-            // This avoids hardcoded model-specific logic and repeated config lookups
-            const shouldSetMaxTokens = this.shouldSetMaxTokensCached(modelName);
-            const maxTokens = shouldSetMaxTokens
-                ? options.maxTokens // No default limit
-                : undefined;
-            // Build complete stream options with proper typing
-            let streamOptions = {
-                model: model,
-                messages: messages,
-                temperature: options.temperature,
-                ...(maxTokens && { maxTokens }),
-                maxRetries: 0, // NL11: Disable AI SDK's invisible internal retries; we handle retries with OTel instrumentation
-                ...(shouldUseTools &&
-                    tools &&
-                    Object.keys(tools).length > 0 && {
-                    tools,
-                    toolChoice: "auto",
-                    stopWhen: stepCountIs(options.maxSteps || DEFAULT_MAX_STEPS),
-                }),
-                abortSignal: composeAbortSignals(options.abortSignal, timeoutController?.controller.signal),
-                experimental_telemetry: this.telemetryHandler.getTelemetryConfig(options),
-                // Gemini 3: use thinkingLevel via providerOptions (Vertex AI)
-                // Gemini 2.5: use thinkingBudget via providerOptions
-                ...(options.thinkingConfig?.enabled && {
-                    providerOptions: {
-                        vertex: {
-                            thinkingConfig: {
-                                ...(options.thinkingConfig.thinkingLevel && {
-                                    thinkingLevel: options.thinkingConfig.thinkingLevel,
-                                }),
-                                ...(options.thinkingConfig.budgetTokens &&
-                                    !options.thinkingConfig.thinkingLevel && {
-                                    thinkingBudget: options.thinkingConfig.budgetTokens,
-                                }),
-                                includeThoughts: true,
-                            },
-                        },
-                    },
-                }),
-                onError: (event) => {
-                    const error = event.error;
-                    const errorMessage = error instanceof Error ? error.message : String(error);
-                    logger.error(`${functionTag}: Stream error`, {
-                        provider: this.providerName,
-                        modelName: this.modelName,
-                        error: errorMessage,
-                        chunkCount,
-                    });
-                },
-                onFinish: (event) => {
-                    logger.debug(`${functionTag}: Stream finished`, {
-                        finishReason: event.finishReason,
-                        totalChunks: chunkCount,
-                    });
-                },
-                onChunk: () => {
-                    chunkCount++;
-                },
-                onStepFinish: ({ toolCalls, toolResults }) => {
-                    logger.info("Tool execution completed", { toolResults, toolCalls });
-                    // Handle tool execution storage
-                    this.handleToolExecutionStorage(toolCalls, toolResults, options, new Date()).catch((error) => {
-                        logger.warn("[GoogleVertexProvider] Failed to store tool executions", {
-                            provider: this.providerName,
-                            error: error instanceof Error ? error.message : String(error),
-                        });
-                    });
-                },
-            };
-            if (analysisSchema) {
-                try {
-                    // Gemini cannot use tools and JSON schema simultaneously
-                    if (!isAnthropic) {
-                        delete streamOptions.tools;
-                        delete streamOptions.toolChoice;
-                        delete streamOptions.stopWhen;
-                    }
-                    streamOptions = {
-                        ...streamOptions,
-                        experimental_output: Output.object({
-                            schema: analysisSchema,
-                        }),
-                    };
-                }
-                catch (error) {
-                    logger.warn("Schema application failed, continuing without schema", {
-                        error: String(error),
-                    });
-                }
-            }
-            // Wrap streamText in an OTel span to capture provider-level latency and token usage
-            const streamSpan = streamTracer.startSpan("neurolink.provider.streamText", {
-                kind: SpanKind.CLIENT,
-                attributes: {
-                    "gen_ai.system": "vertex",
-                    "gen_ai.request.model": getModelId(model, this.modelName || "unknown"),
-                },
-            });
-            let result;
-            try {
-                result = streamText(streamOptions);
-            }
-            catch (err) {
-                streamSpan.recordException(err instanceof Error ? err : new Error(String(err)));
-                streamSpan.setStatus({
-                    code: SpanStatusCode.ERROR,
-                    message: err instanceof Error ? err.message : String(err),
-                });
-                streamSpan.end();
-                throw err;
-            }
-            // Collect token usage and finish reason asynchronously when the stream completes,
-            // then end the span. This avoids blocking the stream consumer.
-            Promise.resolve(result.usage)
-                .then((usage) => {
-                streamSpan.setAttribute("gen_ai.usage.input_tokens", usage.inputTokens || 0);
-                streamSpan.setAttribute("gen_ai.usage.output_tokens", usage.outputTokens || 0);
-                const effectiveModel = options.model ||
-                    getModelId(model, this.modelName || getDefaultVertexModel());
-                const cost = calculateCost(this.providerName, effectiveModel, {
-                    input: usage.inputTokens || 0,
-                    output: usage.outputTokens || 0,
-                    total: (usage.inputTokens || 0) + (usage.outputTokens || 0),
-                });
-                if (cost && cost > 0) {
-                    streamSpan.setAttribute("neurolink.cost", cost);
-                }
-            })
-                .catch(() => {
-                // Usage may not be available if the stream is aborted
-            });
-            Promise.resolve(result.finishReason)
-                .then((reason) => {
-                streamSpan.setAttribute("gen_ai.response.finish_reason", reason || "unknown");
-            })
-                .catch(() => {
-                // Finish reason may not be available if the stream is aborted
-            });
-            Promise.resolve(result.text)
-                .then(() => {
-                streamSpan.end();
-            })
-                .catch((err) => {
-                streamSpan.setStatus({
-                    code: SpanStatusCode.ERROR,
-                    message: err instanceof Error ? err.message : String(err),
-                });
-                streamSpan.end();
-            });
-            // Defer timeout cleanup until the stream completes or errors.
-            // Guard against NoOutputGeneratedError becoming an unhandled rejection.
-            Promise.resolve(result.text)
-                .catch((err) => {
-                logger.debug("Stream text promise rejected (expected for empty streams)", {
-                    error: err instanceof Error ? err.message : String(err),
-                });
-            })
-                .finally(() => timeoutController?.cleanup());
-            // Transform string stream to content object stream using BaseProvider method
-            const transformedStream = this.createTextStream(result);
-            // Track tool calls and results for streaming
-            const toolCalls = [];
-            const toolResults = [];
-            return {
-                stream: transformedStream,
-                provider: this.providerName,
-                model: this.modelName,
-                ...(shouldUseTools && {
-                    toolCalls,
-                    toolResults,
-                }),
-            };
-        }
-        catch (error) {
-            timeoutController?.cleanup();
-            logger.error(`${functionTag}: Exception`, {
-                provider: this.providerName,
-                modelName: this.modelName,
-                error: String(error),
-                chunkCount,
-            });
-            throw this.handleProviderError(error);
-        }
-    }
-    /**
-     * Create @google/genai client configured for Vertex AI
-     */
-    async createVertexGenAIClient(regionOverride) {
-        const project = getVertexProjectId();
-        const location = regionOverride || this.location || getVertexLocation();
-        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;
-        // Use vertexai mode with project and location
-        return new Ctor({
-            vertexai: true,
-            project,
-            location,
-        });
-    }
-    // ── Shared helpers for native Gemini 3 SDK methods ──
-    /**
-     * Build multimodal content parts (user message) from input text, PDFs, and images.
-     * Shared by both stream and generate native Gemini 3 paths.
-     */
-    buildNativeContentParts(inputText, multimodalInput, logLabel) {
-        const userParts = [{ text: inputText }];
-        // Add PDF files as inlineData parts if present
-        if (multimodalInput?.pdfFiles && multimodalInput.pdfFiles.length > 0) {
-            logger.debug(`[GoogleVertex] Processing ${multimodalInput.pdfFiles.length} PDF file(s) for ${logLabel}`);
-            for (const pdfFile of multimodalInput.pdfFiles) {
-                let pdfBuffer;
-                if (typeof pdfFile === "string") {
-                    if (fs.existsSync(pdfFile)) {
-                        pdfBuffer = fs.readFileSync(pdfFile);
-                    }
-                    else {
-                        pdfBuffer = Buffer.from(pdfFile, "base64");
-                    }
-                }
-                else {
-                    pdfBuffer = pdfFile;
-                }
-                const base64Data = pdfBuffer.toString("base64");
-                userParts.push({
-                    inlineData: {
-                        mimeType: "application/pdf",
-                        data: base64Data,
-                    },
-                });
-            }
-        }
-        // Add images as inlineData parts if present
-        if (multimodalInput?.images && multimodalInput.images.length > 0) {
-            logger.debug(`[GoogleVertex] Processing ${multimodalInput.images.length} image(s) for ${logLabel}`);
-            for (const image of multimodalInput.images) {
-                let imageBuffer;
-                let mimeType = "image/jpeg"; // Default
-                if (typeof image === "string") {
-                    if (fs.existsSync(image)) {
-                        imageBuffer = fs.readFileSync(image);
-                        const ext = path.extname(image).toLowerCase();
-                        if (ext === ".png") {
-                            mimeType = "image/png";
-                        }
-                        else if (ext === ".gif") {
-                            mimeType = "image/gif";
-                        }
-                        else if (ext === ".webp") {
-                            mimeType = "image/webp";
-                        }
-                    }
-                    else if (image.startsWith("data:")) {
-                        const matches = image.match(/^data:([^;]+);base64,(.+)$/);
-                        if (matches) {
-                            mimeType = matches[1];
-                            imageBuffer = Buffer.from(matches[2], "base64");
-                        }
-                        else {
-                            continue; // Skip invalid data URL
-                        }
-                    }
-                    else {
-                        imageBuffer = Buffer.from(image, "base64");
-                    }
-                }
-                else {
-                    imageBuffer = image;
-                }
-                const base64Data = imageBuffer.toString("base64");
-                userParts.push({
-                    inlineData: {
-                        mimeType,
-                        data: base64Data,
-                    },
-                });
-            }
-        }
-        return [
-            {
-                role: "user",
-                parts: userParts,
-            },
-        ];
-    }
-    /**
-     * Convert conversationMessages from NeuroLink's ChatMessage format into
-     * the @google/genai contents format and prepend them before the current
-     * user message. This gives the native Gemini 3 path multi-turn context
-     * that was previously dropped (only the current prompt was sent).
-     */
-    prependConversationHistory(currentContents, conversationMessages) {
-        if (!conversationMessages || conversationMessages.length === 0) {
-            return currentContents;
-        }
-        const history = [];
-        for (const msg of conversationMessages) {
-            // @google/genai only accepts "user" and "model" roles in contents.
-            // Skip system messages (handled via config.systemInstruction).
-            // Map "assistant" → "model" (Gemini convention).
-            const role = msg.role === "assistant" ? "model" : msg.role;
-            if (role !== "user" && role !== "model") {
-                continue;
-            }
-            if (!msg.content || msg.content.trim().length === 0) {
-                continue;
-            }
-            history.push({ role, parts: [{ text: msg.content }] });
-        }
-        // Prepend history before current user message
-        return [...history, ...currentContents];
-    }
-    // ── Shared Gemini 3 helpers are now in ./googleNativeGemini3.ts ──
-    /**
-     * Execute stream using native @google/genai SDK for Gemini 3 models on Vertex AI
-     * This bypasses @ai-sdk/google-vertex to properly handle thought_signature
-     */
-    async executeNativeGemini3Stream(options) {
-        const modelName = this.resolveAlias(options.model || this.modelName || getDefaultVertexModel());
-        return withClientSpan({
-            name: "neurolink.provider.stream",
-            tracer: tracers.provider,
-            attributes: {
-                [ATTR.GEN_AI_SYSTEM]: "vertex",
-                [ATTR.GEN_AI_MODEL]: modelName,
-                [ATTR.GEN_AI_OPERATION]: "stream",
-                [ATTR.NL_PROVIDER]: this.providerName,
-            },
-        }, async (span) => {
-            const client = await this.createVertexGenAIClient(options.region);
-            const effectiveLocation = options.region || this.location || getVertexLocation();
-            logger.debug("[GoogleVertex] Using native @google/genai for Gemini 3", {
-                model: modelName,
-                hasTools: !!options.tools && Object.keys(options.tools).length > 0,
-                project: this.projectId,
-                location: effectiveLocation,
-            });
-            // Build contents from input with multimodal support
-            const multimodalInput = options.input;
-            const contents = this.buildNativeContentParts(options.input.text, multimodalInput, "native stream");
-            // Convert tools to native format
-            let hasToolsInput = options.tools &&
-                Object.keys(options.tools).length > 0 &&
-                !options.disableTools;
-            // Guard: Gemini cannot use tools + JSON schema simultaneously
-            const streamOptions = options;
-            const wantsJsonOutput = streamOptions.output?.format === "json" || streamOptions.schema;
-            if (wantsJsonOutput && hasToolsInput) {
-                logger.warn("[GoogleVertex] Gemini does not support tools and JSON schema output simultaneously. Disabling tools for this request.");
-                hasToolsInput = false;
-            }
-            let toolsConfig;
-            let executeMap = new Map();
-            if (hasToolsInput) {
-                const result = buildNativeToolDeclarations(options.tools);
-                toolsConfig = result.toolsConfig;
-                executeMap = result.executeMap;
-                logger.debug("[GoogleVertex] Converted tools for native SDK", {
-                    toolCount: toolsConfig[0].functionDeclarations.length,
-                    toolNames: toolsConfig[0].functionDeclarations.map((t) => t.name),
-                });
-            }
-            // Build config — systemInstruction stays in config for Gemini 3.x.
-            // The @google/genai SDK maps config.systemInstruction to the HTTP-level
-            // system_instruction field, which is the correct mechanism for all
-            // Gemini 3.x models (including global endpoint).  Older workaround
-            // that moved systemInstruction into user/model content messages caused
-            // "Please use a valid role: user, model" on Gemini 3.1+ preview models.
-            const config = buildNativeConfig(options, toolsConfig);
-            // Add JSON output format support for native SDK stream
-            if (streamOptions.output?.format === "json" || streamOptions.schema) {
-                config.responseMimeType = "application/json";
-                if (streamOptions.schema) {
-                    const rawSchema = convertZodToJsonSchema(streamOptions.schema);
-                    const inlinedSchema = inlineJsonSchema(rawSchema);
-                    if (inlinedSchema.$schema) {
-                        delete inlinedSchema.$schema;
-                    }
-                    config.responseSchema = inlinedSchema;
-                    logger.debug("[GoogleVertex] Added responseSchema for JSON output (stream)", {
-                        schemaKeys: Object.keys(inlinedSchema),
-                    });
-                }
-            }
-            const startTime = Date.now();
-            const timeout = this.getTimeout(options);
-            const timeoutController = createTimeoutController(timeout, this.providerName, "stream");
-            const composedSignal = composeAbortSignals(options.abortSignal, timeoutController?.controller.signal);
-            const maxSteps = computeMaxStepsShared(options.maxSteps);
-            // Inject conversation history so the native path has multi-turn context
-            const currentContents = this.prependConversationHistory([...contents], options.conversationMessages);
-            // Create a push-based text channel so the caller receives tokens as
-            // they arrive from the network rather than after full buffering.
-            const channel = createTextChannel();
-            // Shared mutable state updated by the background agentic loop.
-            const allToolCalls = [];
-            // Shared metadata object mutated by the background loop so that
-            // responseTime and totalToolExecutions reflect final values.
-            const metadata = {
-                streamId: `native-vertex-${Date.now()}`,
-                startTime,
-                responseTime: 0,
-                totalToolExecutions: 0,
-            };
-            // analyticsResolvers lets the background loop settle the analytics
-            // promise once token counts are known (after the loop completes).
-            let analyticsResolve;
-            let analyticsReject;
-            const analyticsPromise = new Promise((res, rej) => {
-                analyticsResolve = res;
-                analyticsReject = rej;
-            });
-            // Run the agentic loop in the background without awaiting it here,
-            // so we can return the StreamResult (with channel.iterable) immediately.
-            const loopPromise = (async () => {
-                let lastStepText = "";
-                let totalInputTokens = 0;
-                let totalOutputTokens = 0;
-                let step = 0;
-                let completedWithFinalAnswer = false;
-                const failedTools = new Map();
-                try {
-                    // Agentic loop for tool calling
-                    while (step < maxSteps) {
-                        if (composedSignal?.aborted) {
-                            throw composedSignal.reason instanceof Error
-                                ? composedSignal.reason
-                                : new Error("Request aborted");
-                        }
-                        step++;
-                        logger.debug(`[GoogleVertex] Native SDK step ${step}/${maxSteps}`);
-                        try {
-                            const rawStream = await client.models.generateContentStream({
-                                model: modelName,
-                                contents: currentContents,
-                                config,
-                                ...(composedSignal
-                                    ? { httpOptions: { signal: composedSignal } }
-                                    : {}),
-                            });
-                            // For every step, use incremental collection so text parts
-                            // are pushed to the channel as they arrive.  For intermediate
-                            // steps (those that produce function calls) we still need the
-                            // complete rawResponseParts for pushModelResponseToHistory,
-                            // which collectStreamChunksIncremental provides at stream end.
-                            const chunkResult = await collectStreamChunksIncremental(rawStream, channel);
-                            totalInputTokens += chunkResult.inputTokens;
-                            totalOutputTokens += chunkResult.outputTokens;
-                            const stepText = extractTextFromParts(chunkResult.rawResponseParts);
-                            // If no function calls, this was the final step — channel
-                            // already received all text parts incrementally.
-                            if (chunkResult.stepFunctionCalls.length === 0) {
-                                completedWithFinalAnswer = true;
-                                break;
-                            }
-                            lastStepText = stepText;
-                            // Record tool call events on the span
-                            for (const fc of chunkResult.stepFunctionCalls) {
-                                span.addEvent("gen_ai.tool_call", {
-                                    "tool.name": fc.name,
-                                    "tool.step": step,
-                                });
-                            }
-                            logger.debug(`[GoogleVertex] Executing ${chunkResult.stepFunctionCalls.length} function calls`);
-                            pushModelResponseToHistory(currentContents, chunkResult.rawResponseParts, chunkResult.stepFunctionCalls);
-                            const functionResponses = await executeNativeToolCalls("[GoogleVertex]", chunkResult.stepFunctionCalls, executeMap, failedTools, allToolCalls, { abortSignal: composedSignal });
-                            // Function/tool responses must use role: "user" — the
-                            // @google/genai SDK's validateHistory() only accepts "user"
-                            // and "model" roles (matching automaticFunctionCalling).
-                            currentContents.push({
-                                role: "user",
-                                parts: functionResponses,
-                            });
-                        }
-                        catch (error) {
-                            logger.error("[GoogleVertex] Native SDK error", error);
-                            throw this.handleProviderError(error);
-                        }
-                    }
-                    // Handle max-steps termination: if the model was still calling
-                    // tools when we hit the limit, push a synthetic final message.
-                    if (step >= maxSteps && !completedWithFinalAnswer) {
-                        const fallback = handleMaxStepsTermination("[GoogleVertex]", step, maxSteps, "", // finalText is empty — model didn't stop on its own
-                        lastStepText);
-                        if (fallback) {
-                            channel.push(fallback);
-                        }
-                    }
-                    const responseTime = Date.now() - startTime;
-                    // Propagate final values to the shared metadata object so that
-                    // the already-returned StreamResult reflects accurate telemetry.
-                    metadata.responseTime = responseTime;
-                    metadata.totalToolExecutions = allToolCalls.length;
-                    // Set token usage and finish reason on the span
-                    span.setAttribute(ATTR.GEN_AI_INPUT_TOKENS, totalInputTokens);
-                    span.setAttribute(ATTR.GEN_AI_OUTPUT_TOKENS, totalOutputTokens);
-                    span.setAttribute(ATTR.GEN_AI_FINISH_REASON, step >= maxSteps && !completedWithFinalAnswer
-                        ? "max_steps"
-                        : "stop");
-                    analyticsResolve({
-                        provider: this.providerName,
-                        model: modelName,
-                        tokenUsage: {
-                            input: totalInputTokens,
-                            output: totalOutputTokens,
-                            total: totalInputTokens + totalOutputTokens,
-                        },
-                        requestDuration: responseTime,
-                        timestamp: new Date().toISOString(),
-                    });
-                    channel.close();
-                }
-                catch (err) {
-                    channel.error(err);
-                    analyticsReject(err);
-                }
-                finally {
-                    timeoutController?.cleanup();
-                }
-            })();
-            // Suppress unhandled-rejection warnings on loopPromise — errors are
-            // forwarded to the channel and will surface when the caller iterates.
-            loopPromise.catch(() => undefined);
-            return {
-                stream: channel.iterable,
-                provider: this.providerName,
-                model: modelName,
-                toolCalls: allToolCalls,
-                analytics: analyticsPromise,
-                metadata,
-            };
-        });
-    }
-    /**
-     * Execute generate using native @google/genai SDK for Gemini 3 models on Vertex AI
-     * This bypasses @ai-sdk/google-vertex to properly handle thought_signature
-     */
-    async executeNativeGemini3Generate(options) {
-        const modelName = this.resolveAlias(options.model || this.modelName || getDefaultVertexModel());
-        return withClientSpan({
-            name: "neurolink.provider.generate",
-            tracer: tracers.provider,
-            attributes: {
-                [ATTR.GEN_AI_SYSTEM]: "vertex",
-                [ATTR.GEN_AI_MODEL]: modelName,
-                [ATTR.GEN_AI_OPERATION]: "generate",
-                [ATTR.NL_PROVIDER]: this.providerName,
-            },
-        }, async (span) => {
-            const client = await this.createVertexGenAIClient(options.region);
-            const effectiveLocation = options.region || this.location || getVertexLocation();
-            logger.debug("[GoogleVertex] Using native @google/genai for Gemini 3 generate", {
-                model: modelName,
-                project: this.projectId,
-                location: effectiveLocation,
-            });
-            // Build contents from input with multimodal support
-            // Prefer input.text over prompt — processCSVFilesForNativeSDK enriches
-            // input.text with inlined CSV data, so using prompt first would discard it.
-            const inputText = options.input?.text || options.prompt || "Please respond.";
-            const multimodalInput = options.input;
-            const contents = this.buildNativeContentParts(inputText, multimodalInput, "native generate");
-            // Get tools from SDK and options
-            let shouldUseTools = !options.disableTools && this.supportsTools();
-            // Guard: Gemini cannot use tools + JSON schema simultaneously
-            const wantsJsonOutputGen = options.output?.format === "json" || options.schema;
-            if (wantsJsonOutputGen && shouldUseTools) {
-                logger.warn("[GoogleVertex] Gemini does not support tools and JSON schema output simultaneously. Disabling tools for this request.");
-                shouldUseTools = false;
-            }
-            const sdkTools = shouldUseTools ? await this.getAllTools() : {};
-            const combinedTools = shouldUseTools
-                ? { ...sdkTools, ...(options.tools || {}) }
-                : {};
-            let toolsConfig;
-            let executeMap = new Map();
-            if (Object.keys(combinedTools).length > 0) {
-                const result = buildNativeToolDeclarations(combinedTools);
-                toolsConfig = result.toolsConfig;
-                executeMap = result.executeMap;
-                logger.debug("[GoogleVertex] Converted tools for native SDK generate", {
-                    toolCount: toolsConfig[0].functionDeclarations.length,
-                    toolNames: toolsConfig[0].functionDeclarations.map((t) => t.name),
-                });
-            }
-            // Build config — systemInstruction stays in config for Gemini 3.x.
-            // See stream path comment for rationale.
-            const config = buildNativeConfig(options, toolsConfig);
-            // Note: Schema/JSON output for Gemini 3 native SDK is complex due to $ref resolution issues
-            // For now, schemas are handled via the AI SDK fallback path, not native SDK
-            // TODO: Implement proper $ref resolution for complex nested schemas
-            const startTime = Date.now();
-            const timeout = this.getTimeout(options);
-            const timeoutController = createTimeoutController(timeout, this.providerName, "generate");
-            const composedSignal = composeAbortSignals(options.abortSignal, timeoutController?.controller.signal);
-            const maxSteps = computeMaxStepsShared(options.maxSteps);
-            // Inject conversation history so the native path has multi-turn context
-            const currentContents = this.prependConversationHistory([...contents], options.conversationMessages);
-            let finalText = "";
-            let lastStepText = "";
-            let totalInputTokens = 0;
-            let totalOutputTokens = 0;
-            const allToolCalls = [];
-            const toolExecutions = [];
-            let step = 0;
-            const failedTools = new Map();
-            try {
-                // Agentic loop for tool calling
-                while (step < maxSteps) {
-                    if (composedSignal?.aborted) {
-                        throw composedSignal.reason instanceof Error
-                            ? composedSignal.reason
-                            : new Error("Request aborted");
-                    }
-                    step++;
-                    logger.debug(`[GoogleVertex] Native SDK generate step ${step}/${maxSteps}`);
-                    try {
-                        // Use generateContentStream and collect all chunks (same as GoogleAIStudio)
-                        const stream = await client.models.generateContentStream({
-                            model: modelName,
-                            contents: currentContents,
-                            config,
-                            ...(composedSignal
-                                ? { httpOptions: { signal: composedSignal } }
-                                : {}),
-                        });
-                        const chunkResult = await collectStreamChunks(stream);
-                        totalInputTokens += chunkResult.inputTokens;
-                        totalOutputTokens += chunkResult.outputTokens;
-                        const stepText = extractTextFromParts(chunkResult.rawResponseParts);
-                        if (chunkResult.stepFunctionCalls.length === 0) {
-                            finalText = stepText;
-                            break;
-                        }
-                        lastStepText = stepText;
-                        // Record tool call events on the span
-                        for (const fc of chunkResult.stepFunctionCalls) {
-                            span.addEvent("gen_ai.tool_call", {
-                                "tool.name": fc.name,
-                                "tool.step": step,
-                            });
-                        }
-                        logger.debug(`[GoogleVertex] Generate executing ${chunkResult.stepFunctionCalls.length} function calls`);
-                        pushModelResponseToHistory(currentContents, chunkResult.rawResponseParts, chunkResult.stepFunctionCalls);
-                        const functionResponses = await executeNativeToolCalls("[GoogleVertex]", chunkResult.stepFunctionCalls, executeMap, failedTools, allToolCalls, { toolExecutions, abortSignal: composedSignal });
-                        // Function/tool responses must use role: "user" — the
-                        // @google/genai SDK's validateHistory() only accepts "user"
-                        // and "model" roles (matching automaticFunctionCalling).
-                        currentContents.push({
-                            role: "user",
-                            parts: functionResponses,
-                        });
-                    }
-                    catch (error) {
-                        logger.error("[GoogleVertex] Native SDK generate error", error);
-                        throw this.handleProviderError(error);
-                    }
-                }
-            }
-            finally {
-                timeoutController?.cleanup();
-            }
-            finalText = handleMaxStepsTermination("[GoogleVertex]", step, maxSteps, finalText, lastStepText);
-            const responseTime = Date.now() - startTime;
-            // Set token usage and finish reason on the span
-            span.setAttribute(ATTR.GEN_AI_INPUT_TOKENS, totalInputTokens);
-            span.setAttribute(ATTR.GEN_AI_OUTPUT_TOKENS, totalOutputTokens);
-            span.setAttribute(ATTR.GEN_AI_FINISH_REASON, step >= maxSteps ? "max_steps" : "stop");
-            // Build EnhancedGenerateResult
-            return {
-                content: finalText,
-                provider: this.providerName,
-                model: modelName,
-                usage: {
-                    input: totalInputTokens,
-                    output: totalOutputTokens,
-                    total: totalInputTokens + totalOutputTokens,
-                },
-                responseTime,
-                toolsUsed: allToolCalls.map((tc) => tc.toolName),
-                toolExecutions: toolExecutions,
-                enhancedWithTools: allToolCalls.length > 0,
-            };
-        });
-    }
-    /**
-     * Process CSV files and append content to options.input.text
-     * This ensures CSV data is available in the prompt for native Gemini 3 SDK calls
-     * Returns a new options object with modified input (immutable pattern)
-     */
-    async processCSVFilesForNativeSDK(options) {
-        const input = options.input;
-        if (!input?.csvFiles || input.csvFiles.length === 0) {
-            return options;
-        }
-        logger.info(`[GoogleVertex] Processing ${input.csvFiles.length} CSV file(s) for native Gemini 3 SDK`);
-        let modifiedText = input.text || "";
-        for (let i = 0; i < input.csvFiles.length; i++) {
-            const csvFile = input.csvFiles[i];
-            try {
-                const result = await FileDetector.detectAndProcess(csvFile, {
-                    allowedTypes: ["csv"],
-                    csvOptions: "csvOptions" in options
-                        ? options.csvOptions
-                        : undefined,
-                });
-                // Extract filename for display
-                const filename = typeof csvFile === "string"
-                    ? path.basename(csvFile)
-                    : `csv_file_${i + 1}.csv`;
-                let csvSection = `\n\n## CSV Data from "${filename}":\n`;
-                // Add metadata if available
-                if (result.metadata) {
-                    const meta = result.metadata;
-                    if (meta.rowCount || meta.columnCount || meta.columnNames) {
-                        csvSection += `**File Info:**\n`;
-                        if (meta.rowCount) {
-                            csvSection += `- Rows: ${meta.rowCount}\n`;
-                        }
-                        if (meta.columnCount) {
-                            csvSection += `- Columns: ${meta.columnCount}\n`;
-                        }
-                        if (meta.columnNames && Array.isArray(meta.columnNames)) {
-                            csvSection += `- Column Names: ${meta.columnNames.join(", ")}\n`;
-                        }
-                        csvSection += "\n";
-                    }
-                }
-                // Add strong instructions to use the CSV data directly
-                csvSection += `\n**CRITICAL INSTRUCTION**: The complete CSV data is included below. You MUST use this data directly from this prompt.\n`;
-                csvSection += `DO NOT use any external tools (github, search_code, get_file_contents, etc.) to access this data.\n`;
-                csvSection += `The data you need is right here in this message - read it carefully and answer based on it.\n\n`;
-                csvSection += result.content;
-                // Prepend CSV to ensure data appears before user's question
-                modifiedText =
-                    csvSection + "\n\n---\n\n**USER QUESTION:**\n" + modifiedText;
-                logger.info(`[GoogleVertex] ✅ Processed CSV: ${filename}`);
-            }
-            catch (error) {
-                logger.error(`[GoogleVertex] ❌ Failed to process CSV file ${i + 1}:`, error);
-                const filename = typeof csvFile === "string"
-                    ? path.basename(csvFile)
-                    : `csv_file_${i + 1}.csv`;
-                modifiedText += `\n\n## CSV Data Error: Failed to process "${filename}"\nReason: ${error instanceof Error ? error.message : "Unknown error"}`;
-            }
-        }
-        // Return new options with modified input (immutable pattern)
-        // Preserve the full type of options.input by spreading options.input directly
-        return {
-            ...options,
-            input: { ...options.input, text: modifiedText },
-        };
-    }
-    /**
-     * Override generate to route Gemini 3 models with tools to native SDK
-     */
-    async generate(optionsOrPrompt) {
-        // Normalize options
-        const options = typeof optionsOrPrompt === "string"
-            ? { prompt: optionsOrPrompt }
-            : optionsOrPrompt;
-        const modelName = this.resolveAlias(options.model || this.modelName || getDefaultVertexModel());
-        // Structured output (JSON format or schema) is incompatible with tools on Gemini.
-        // Mirror the stream path pattern to prevent silent downgrade on the generate path.
-        const wantsStructuredOutput = options.output?.format === "json" || !!options.schema;
-        // Check if we should use native SDK for Gemini 3 with tools
-        const shouldUseTools = !options.disableTools && this.supportsTools() && !wantsStructuredOutput;
-        const sdkTools = shouldUseTools ? await this.getAllTools() : {};
-        const hasTools = shouldUseTools &&
-            (Object.keys(sdkTools).length > 0 ||
-                (options.tools && Object.keys(options.tools).length > 0));
-        if (isGemini3Model(modelName) && hasTools && !wantsStructuredOutput) {
-            // Process CSV files before routing to native SDK (bypasses normal message builder)
-            const processedOptions = await this.processCSVFilesForNativeSDK(options);
-            // Merge SDK tools into options for native SDK path
-            const mergedOptions = {
-                ...processedOptions,
-                tools: { ...sdkTools, ...(processedOptions.tools || {}) },
-            };
-            logger.info("[GoogleVertex] Routing Gemini 3 generate to native SDK for tool calling", {
-                model: modelName,
-                sdkToolCount: Object.keys(sdkTools).length,
-                optionToolCount: Object.keys(processedOptions.tools || {}).length,
-                totalToolCount: Object.keys(sdkTools).length +
-                    Object.keys(processedOptions.tools || {}).length,
-            });
-            return this.executeNativeGemini3Generate(mergedOptions);
-        }
-        // Fall back to BaseProvider implementation
-        return super.generate(optionsOrPrompt);
-    }
-    formatProviderError(error) {
-        // Pass through AbortError as-is so callers can detect cancellation
-        const errorRecord = error;
-        if (typeof errorRecord?.name === "string" &&
-            errorRecord.name === "AbortError") {
-            return error;
-        }
-        if (typeof errorRecord?.name === "string" &&
-            errorRecord.name === "TimeoutError") {
-            return new NetworkError(`Google Vertex AI request timed out. Consider increasing timeout or using a lighter model.`, this.providerName);
-        }
-        const message = typeof errorRecord?.message === "string"
-            ? errorRecord.message
-            : "Unknown error occurred";
-        const code = typeof errorRecord?.code === "string" ? errorRecord.code : undefined;
-        if (code === "ECONNRESET" ||
-            code === "ENOTFOUND" ||
-            code === "ECONNREFUSED" ||
-            message.includes("ECONNRESET") ||
-            message.includes("ENOTFOUND") ||
-            message.includes("ECONNREFUSED") ||
-            message.includes("connect ETIMEDOUT")) {
-            return new NetworkError(`Google Vertex AI network error: ${message}`, this.providerName);
-        }
-        if (message.includes("PERMISSION_DENIED")) {
-            return new AuthenticationError(`❌ Google Vertex AI Permission Denied\n\nYour Google Cloud credentials don't have permission to access Vertex AI.\n\nRequired Steps:\n1. Ensure your service account has Vertex AI User role\n2. Check if Vertex AI API is enabled in your project\n3. Verify your project ID is correct\n4. Confirm your location/region has Vertex AI available`, this.providerName);
-        }
-        if (message.includes("NOT_FOUND")) {
-            const modelSuggestions = this.getModelSuggestions(this.modelName);
-            return new InvalidModelError(`❌ Google Vertex AI Model Not Found\n\n${message}\n\nModel '${this.modelName}' is not available.\n\nSuggested alternatives:\n${modelSuggestions}\n\nTroubleshooting:\n1. Check model name spelling and format\n2. Verify model is available in your region (${this.location})\n3. Ensure your project has access to the model\n4. For Claude models, enable Anthropic integration in Google Cloud Console`, this.providerName);
-        }
-        if (message.includes("QUOTA_EXCEEDED")) {
-            return new RateLimitError(`❌ Google Vertex AI Quota Exceeded\n\n${message}\n\nSolutions:\n1. Check your Vertex AI quotas in Google Cloud Console\n2. Request quota increase if needed\n3. Try a different model or reduce request frequency\n4. Consider using a different region`, this.providerName);
-        }
-        if (message.includes("INVALID_ARGUMENT")) {
-            return new ProviderError(`❌ Google Vertex AI Invalid Request\n\n${message}\n\nCheck:\n1. Request parameters are within model limits\n2. Input text is properly formatted\n3. Temperature and other settings are valid\n4. Model supports your request type`, this.providerName);
-        }
-        return new ProviderError(`❌ Google Vertex AI Provider Error\n\n${message}\n\nTroubleshooting:\n1. Check Google Cloud credentials and permissions\n2. Verify project ID and location settings\n3. Ensure Vertex AI API is enabled\n4. Check network connectivity`, this.providerName);
-    }
-    /**
-     * Memory-safe cache management for model configurations
-     * Implements LRU eviction to prevent memory leaks in long-running processes
-     */
-    static evictLRUCacheEntries(cache) {
-        if (cache.size <= GoogleVertexProvider.MAX_CACHE_SIZE) {
-            return;
-        }
-        // Evict oldest entries (first entries in Map are oldest in insertion order)
-        const entriesToRemove = cache.size - GoogleVertexProvider.MAX_CACHE_SIZE + 5; // Remove extra to avoid frequent evictions
-        let removed = 0;
-        for (const key of cache.keys()) {
-            if (removed >= entriesToRemove) {
-                break;
-            }
-            cache.delete(key);
-            removed++;
-        }
-        logger.debug("GoogleVertexProvider: Evicted LRU cache entries", {
-            entriesRemoved: removed,
-            currentCacheSize: cache.size,
-        });
-    }
-    /**
-     * Access and refresh cache entry (moves to end for LRU)
-     */
-    static accessCacheEntry(cache, key) {
-        const value = cache.get(key);
-        if (value !== undefined) {
-            // Move to end (most recently used)
-            cache.delete(key);
-            cache.set(key, value);
-        }
-        return value;
-    }
-    /**
-     * Memory-safe cached check for whether maxTokens should be set for the given model
-     * Optimized for streaming performance with LRU eviction to prevent memory leaks
-     */
-    shouldSetMaxTokensCached(modelName) {
-        const now = Date.now();
-        // Check if cache is valid (within 5 minutes)
-        if (now - GoogleVertexProvider.maxTokensCacheTime >
-            GoogleVertexProvider.CACHE_DURATION) {
-            // Cache expired, refresh all cached results
-            GoogleVertexProvider.maxTokensCache.clear();
-            GoogleVertexProvider.maxTokensCacheTime = now;
-        }
-        // Check if we have cached result for this model (with LRU access)
-        const cachedResult = GoogleVertexProvider.accessCacheEntry(GoogleVertexProvider.maxTokensCache, modelName);
-        if (cachedResult !== undefined) {
-            return cachedResult;
-        }
-        // Calculate and cache the result with memory management
-        const shouldSet = !this.modelHasMaxTokensIssues(modelName);
-        GoogleVertexProvider.maxTokensCache.set(modelName, shouldSet);
-        // Prevent memory leaks by evicting old entries if cache grows too large
-        GoogleVertexProvider.evictLRUCacheEntries(GoogleVertexProvider.maxTokensCache);
-        return shouldSet;
-    }
-    /**
-     * Memory-safe check if model has maxTokens issues using configuration-based approach
-     * This replaces hardcoded model-specific logic with configurable behavior
-     * Includes LRU caching to avoid repeated configuration lookups during streaming
-     */
-    modelHasMaxTokensIssues(modelName) {
-        const now = Date.now();
-        const cacheKey = "google-vertex-config";
-        // Check if cache is valid (within 5 minutes)
-        if (now - GoogleVertexProvider.modelConfigCacheTime >
-            GoogleVertexProvider.CACHE_DURATION) {
-            // Cache expired, refresh it with memory management
-            GoogleVertexProvider.modelConfigCache.clear();
-            const config = ModelConfigurationManager.getInstance();
-            const vertexConfig = config.getProviderConfiguration("google-vertex");
-            GoogleVertexProvider.modelConfigCache.set(cacheKey, vertexConfig);
-            GoogleVertexProvider.modelConfigCacheTime = now;
-        }
-        // Access cached config with LRU behavior
-        const vertexConfig = GoogleVertexProvider.accessCacheEntry(GoogleVertexProvider.modelConfigCache, cacheKey);
-        // Check if model is in the list of models with maxTokens issues
-        const modelsWithIssues = vertexConfig?.modelBehavior?.maxTokensIssues || [
-            "gemini-2.5-flash",
-            "gemini-2.5-pro",
-        ];
-        return modelsWithIssues.some((problematicModel) => modelName.includes(problematicModel));
-    }
-    /**
-     * Check if Anthropic models are available
-     * @returns Promise<boolean> indicating if Anthropic support is available
-     */
-    async hasAnthropicSupport() {
-        return hasAnthropicSupport();
-    }
-    /**
-     * Resolve a shorthand model name to its full versioned Vertex AI identifier.
-     * Returns the original name unchanged if no alias exists.
-     *
-     * @param modelName - A model name, possibly a shorthand alias
-     * @returns The resolved full versioned model name
-     *
-     * @example
-     * ```typescript
-     * provider.resolveModelAlias("claude-sonnet-4-5"); // "claude-sonnet-4-5@20250929"
-     * provider.resolveModelAlias("gemini-3-pro");      // "gemini-3.1-pro-preview"
-     * provider.resolveModelAlias("gemini-2.5-flash");  // "gemini-2.5-flash" (unchanged)
-     * ```
-     */
-    resolveModelAlias(modelName) {
-        return VERTEX_MODEL_ALIASES[modelName] ?? modelName;
-    }
-    /**
-     * Create an Anthropic model instance using vertexAnthropic provider
-     * Uses fresh vertex settings for each request with comprehensive validation
-     * @param modelName Anthropic model name (e.g., 'claude-3-sonnet@20240229')
-     * @returns LanguageModel instance or null if not available
-     */
-    async createAnthropicModel(modelName) {
-        const validationId = `anthropic-validation-${Date.now()}-${Math.random().toString(36).substring(2, 11)}`;
-        logger.debug("[GoogleVertexProvider] 🧠 Starting comprehensive Anthropic model validation", {
-            validationId,
-            modelName,
-            timestamp: new Date().toISOString(),
-        });
-        // 1. SDK Module Availability Validation
-        if (!hasAnthropicSupport()) {
-            logger.error("[GoogleVertexProvider] ❌ SDK module validation failed", {
-                validationId,
-                issue: "createVertexAnthropic function not available",
-                solution: "Update @ai-sdk/google-vertex to latest version with Anthropic support",
-                command: "npm install @ai-sdk/google-vertex@latest",
-                documentation: "https://sdk.vercel.ai/providers/ai-sdk-providers/google-vertex#anthropic-models",
-            });
-            return null;
-        }
-        // 2. Authentication Validation
-        const authValidation = await this.validateVertexAuthentication();
-        if (!authValidation.isValid) {
-            logger.error("[GoogleVertexProvider] ❌ Authentication validation failed", {
-                validationId,
-                method: authValidation.method,
-                issues: authValidation.issues,
-                solutions: [
-                    "Option 1: Set GOOGLE_APPLICATION_CREDENTIALS to valid service account OR ADC file",
-                    "Option 2: Set individual env vars: GOOGLE_AUTH_CLIENT_EMAIL, GOOGLE_AUTH_PRIVATE_KEY",
-                    "Option 3: Use gcloud auth application-default login for ADC",
-                    "Documentation: https://cloud.google.com/docs/authentication/provide-credentials-adc",
-                ],
-            });
-            return null;
-        }
-        // 3. Project Configuration Validation
-        const projectValidation = await this.validateVertexProjectConfiguration();
-        if (!projectValidation.isValid) {
-            logger.error("[GoogleVertexProvider] ❌ Project configuration validation failed", {
-                validationId,
-                projectId: projectValidation.projectId,
-                region: projectValidation.region,
-                issues: projectValidation.issues,
-                solutions: [
-                    "Set GOOGLE_VERTEX_PROJECT or GOOGLE_CLOUD_PROJECT environment variable",
-                    "Ensure project exists and has Vertex AI API enabled",
-                    "Check: https://console.cloud.google.com/apis/library/aiplatform.googleapis.com",
-                ],
-            });
-            return null;
-        }
-        // 4. Regional Support Validation
-        const regionSupported = await this.checkVertexRegionalSupport(projectValidation.region);
-        if (!regionSupported) {
-            logger.warn("[GoogleVertexProvider] ⚠️ Regional support warning", {
-                validationId,
-                region: projectValidation.region,
-                warning: "Anthropic models may not be available in this region",
-                supportedRegions: [
-                    "us-central1",
-                    "us-east4",
-                    "us-east5",
-                    "us-west1",
-                    "us-west4",
-                    "europe-west1",
-                    "europe-west4",
-                    "asia-southeast1",
-                    "asia-northeast1",
-                ],
-                solution: "Set GOOGLE_CLOUD_LOCATION to a supported region",
-            });
-            // Continue with warning, don't block
-        }
-        // 5. Model Name Validation
-        const modelValidation = this.validateAnthropicModelName(modelName);
-        if (!modelValidation.isValid) {
-            logger.error("[GoogleVertexProvider] ❌ Model name validation failed", {
-                validationId,
-                modelName,
-                issue: modelValidation.issue,
-                recommendedModels: [
-                    "claude-sonnet-4-6",
-                    "claude-opus-4-6",
-                    "claude-sonnet-4-5@20250929",
-                    "claude-opus-4@20250514",
-                    "claude-3-5-sonnet-20241022",
-                ],
-            });
-            return null;
-        }
-        try {
-            // 6. Settings Creation with Enhanced Error Handling
-            logger.debug("[GoogleVertexProvider] 🔧 Creating vertexAnthropic settings", {
-                validationId,
-                authMethod: authValidation.method,
-                projectId: projectValidation.projectId,
-                region: projectValidation.region,
-            });
-            const vertexAnthropicSettings = await createVertexAnthropicSettings(this.location);
-            // 7. Settings Validation
-            if (!vertexAnthropicSettings.project ||
-                !vertexAnthropicSettings.location) {
-                logger.error("[GoogleVertexProvider] ❌ Settings validation failed", {
-                    validationId,
-                    hasProject: !!vertexAnthropicSettings.project,
-                    hasLocation: !!vertexAnthropicSettings.location,
-                    hasProxy: !!vertexAnthropicSettings.fetch,
-                    hasAuth: !!vertexAnthropicSettings.googleAuthOptions,
-                });
-                return null;
-            }
-            logger.debug("[GoogleVertexProvider] ✅ Creating vertexAnthropic instance", {
-                validationId,
-                modelName,
-                project: vertexAnthropicSettings.project,
-                location: vertexAnthropicSettings.location,
-                hasProxy: !!vertexAnthropicSettings.fetch,
-                hasAuth: !!vertexAnthropicSettings.googleAuthOptions,
-            });
-            // 8. Provider Instance Creation
-            const vertexAnthropicInstance = createVertexAnthropic(vertexAnthropicSettings);
-            // 9. Model Instance Creation with Network Error Handling
-            const model = vertexAnthropicInstance(modelName);
-            logger.info("[GoogleVertexProvider] ✅ Anthropic model created successfully", {
-                validationId,
-                modelName,
-                hasModel: !!model,
-                modelType: typeof model,
-                authMethod: authValidation.method,
-                projectId: projectValidation.projectId,
-                region: projectValidation.region,
-                validationsPassed: [
-                    "SDK_MODULE_AVAILABLE",
-                    "AUTHENTICATION_VALID",
-                    "PROJECT_CONFIGURED",
-                    "MODEL_NAME_VALID",
-                    "SETTINGS_CREATED",
-                    "PROVIDER_INSTANCE_CREATED",
-                    "MODEL_INSTANCE_CREATED",
-                ],
-            });
-            return model;
-        }
-        catch (error) {
-            // Enhanced error analysis and reporting
-            const errorAnalysis = this.analyzeAnthropicCreationError(error, {
-                validationId,
-                modelName,
-                projectId: projectValidation.projectId,
-                region: projectValidation.region,
-                authMethod: authValidation.method,
-            });
-            logger.error("[GoogleVertexProvider] ❌ Anthropic model creation failed", {
-                validationId,
-                modelName,
-                ...errorAnalysis,
-                detailedTroubleshooting: this.getAnthropicTroubleshootingSteps(errorAnalysis),
-            });
-            return null;
-        }
-    }
-    /**
-     * Validate Vertex AI authentication configuration
-     */
-    async validateVertexAuthentication() {
-        const result = {
-            isValid: false,
-            method: "none",
-            issues: [],
-        };
-        try {
-            // Check for service account file authentication (preferred)
-            if (process.env.GOOGLE_APPLICATION_CREDENTIALS_NEUROLINK ||
-                process.env.GOOGLE_APPLICATION_CREDENTIALS) {
-                const credentialsPath = process.env
-                    .GOOGLE_APPLICATION_CREDENTIALS_NEUROLINK
-                    ? process.env.GOOGLE_APPLICATION_CREDENTIALS_NEUROLINK
-                    : process.env.GOOGLE_APPLICATION_CREDENTIALS || "";
-                try {
-                    if (fs.existsSync(credentialsPath)) {
-                        // Validate JSON structure
-                        const credentialsContent = fs.readFileSync(credentialsPath, "utf8");
-                        const credentials = JSON.parse(credentialsContent);
-                        if (credentials.type === "service_account" &&
-                            credentials.project_id &&
-                            credentials.client_email &&
-                            credentials.private_key) {
-                            result.isValid = true;
-                            result.method = "service_account_file";
-                            return result;
-                        }
-                        else if (credentials.client_id &&
-                            credentials.client_secret &&
-                            credentials.refresh_token &&
-                            credentials.type !== "service_account") {
-                            result.isValid = true;
-                            result.method = "application_default_credentials";
-                            return result;
-                        }
-                        else {
-                            result.issues.push("Credentials file missing required fields (not service account or ADC format)");
-                        }
-                    }
-                    else {
-                        result.issues.push(`Service account file not found: ${credentialsPath}`);
-                    }
-                }
-                catch (fileError) {
-                    result.issues.push(`Service account file validation failed: ${fileError}`);
-                }
-            }
-            // Check for individual environment variables
-            if (process.env.GOOGLE_AUTH_CLIENT_EMAIL &&
-                process.env.GOOGLE_AUTH_PRIVATE_KEY) {
-                const email = process.env.GOOGLE_AUTH_CLIENT_EMAIL;
-                const privateKey = process.env.GOOGLE_AUTH_PRIVATE_KEY;
-                if (email.includes("@") && privateKey.includes("BEGIN PRIVATE KEY")) {
-                    result.isValid = true;
-                    result.method = "environment_variables";
-                    return result;
-                }
-                else {
-                    result.issues.push("Individual credentials format validation failed");
-                }
-            }
-            else {
-                result.issues.push("Missing individual credential environment variables");
-            }
-            if (!result.isValid) {
-                result.issues.push("No valid authentication method found");
-            }
-        }
-        catch (error) {
-            result.issues.push(`Authentication validation error: ${error}`);
-        }
-        return result;
-    }
-    /**
-     * Validate Vertex AI project configuration
-     */
-    async validateVertexProjectConfiguration() {
-        const result = {
-            isValid: false,
-            projectId: undefined,
-            region: undefined,
-            issues: [],
-        };
-        // Check project ID
-        const projectId = process.env.GOOGLE_VERTEX_PROJECT ||
-            process.env.GOOGLE_CLOUD_PROJECT_ID ||
-            process.env.GOOGLE_PROJECT_ID ||
-            process.env.GOOGLE_CLOUD_PROJECT;
-        if (projectId) {
-            result.projectId = projectId;
-            // Validate project ID format
-            const projectIdPattern = /^[a-z][a-z0-9-]{4,28}[a-z0-9]$/;
-            if (projectIdPattern.test(projectId)) {
-                result.isValid = true;
-            }
-            else {
-                result.issues.push(`Invalid project ID format: ${projectId}`);
-            }
-        }
-        else {
-            result.issues.push("No project ID configured");
-        }
-        // Check region/location
-        const region = process.env.GOOGLE_CLOUD_LOCATION ||
-            process.env.VERTEX_LOCATION ||
-            process.env.GOOGLE_VERTEX_LOCATION ||
-            "us-central1";
-        result.region = region;
-        // Validate region format (regional format like us-central1 or global endpoint)
-        const regionPattern = /^([a-z]+-[a-z]+\d+|global)$/;
-        if (!regionPattern.test(region)) {
-            result.issues.push(`Invalid region format: ${region} (expected format: 'us-central1' or 'global')`);
-            result.isValid = false;
-        }
-        return result;
-    }
-    /**
-     * Check if the specified region supports Anthropic models
-     */
-    async checkVertexRegionalSupport(region = "us-central1") {
-        // Based on Google Cloud documentation, these regions support Anthropic models
-        const supportedRegions = [
-            // Global endpoint (routed automatically)
-            "global",
-            // North America
-            "us-central1",
-            "us-east1",
-            "us-east4",
-            "us-east5",
-            "us-south1",
-            "us-west1",
-            "us-west4",
-            "northamerica-northeast1",
-            "northamerica-northeast2",
-            // Europe
-            "europe-west1",
-            "europe-west2",
-            "europe-west3",
-            "europe-west4",
-            "europe-west6",
-            "europe-west8",
-            "europe-west9",
-            "europe-north1",
-            "europe-central2",
-            "europe-southwest1",
-            // Asia Pacific
-            "asia-east1",
-            "asia-east2",
-            "asia-northeast1",
-            "asia-northeast2",
-            "asia-northeast3",
-            "asia-south1",
-            "asia-southeast1",
-            "asia-southeast2",
-            "australia-southeast1",
-            "australia-southeast2",
-            // Middle East & Africa
-            "me-west1",
-            "me-central1",
-            "africa-south1",
-            // South America
-            "southamerica-east1",
-            "southamerica-west1",
-        ];
-        return supportedRegions.includes(region);
-    }
-    /**
-     * Validate Anthropic model name format and availability
-     */
-    validateAnthropicModelName(modelName) {
-        if (!modelName || typeof modelName !== "string") {
-            return {
-                isValid: false,
-                issue: "Model name is required and must be a string",
-            };
-        }
-        // Check if it's a Claude model
-        if (!modelName.toLowerCase().includes("claude")) {
-            return {
-                isValid: false,
-                issue: 'Model name must be a Claude model (should contain "claude")',
-            };
-        }
-        // Validate against known Claude model patterns
-        const validPatterns = [
-            // Claude 4.6 — versionless IDs (no @YYYYMMDD suffix)
-            /^claude-opus-4-6$/,
-            /^claude-sonnet-4-6$/,
-            // Claude 4.x versioned
-            /^claude-sonnet-4@\d{8}$/,
-            /^claude-sonnet-4-5@\d{8}$/,
-            /^claude-opus-4@\d{8}$/,
-            /^claude-opus-4-1@\d{8}$/,
-            /^claude-opus-4-5@\d{8}$/,
-            /^claude-haiku-4-5@\d{8}$/,
-            // Claude 3.x
-            /^claude-3-7-sonnet@\d{8}$/,
-            /^claude-3-5-sonnet-\d{8}$/,
-            /^claude-3-5-haiku-\d{8}$/,
-            /^claude-3-sonnet-\d{8}$/,
-            /^claude-3-haiku-\d{8}$/,
-            /^claude-3-opus-\d{8}$/,
-        ];
-        const isValidFormat = validPatterns.some((pattern) => pattern.test(modelName));
-        if (!isValidFormat) {
-            return {
-                isValid: false,
-                issue: `Model name format not recognized. Expected formats like "claude-3-5-sonnet-20241022" or "claude-sonnet-4@20250514"`,
-            };
-        }
-        return { isValid: true };
-    }
-    /**
-     * Analyze Anthropic model creation errors for detailed troubleshooting
-     */
-    analyzeAnthropicCreationError(error, context) {
-        const errorMessage = error instanceof Error ? error.message : String(error);
-        const errorName = error instanceof Error ? error.name : "UnknownError";
-        const analysis = {
-            error: errorMessage,
-            errorName,
-            errorType: "UNKNOWN",
-            isNetworkError: false,
-            isAuthError: false,
-            isConfigurationError: false,
-            isModelError: false,
-            isRegionalError: false,
-            specificIssue: "Unknown error occurred",
-            errorStack: error instanceof Error ? error.stack : undefined,
-        };
-        // Network-related errors
-        if (errorMessage.includes("ETIMEDOUT") ||
-            errorMessage.includes("ECONNREFUSED") ||
-            errorMessage.includes("ENOTFOUND") ||
-            errorMessage.includes("timeout")) {
-            analysis.errorType = "NETWORK";
-            analysis.isNetworkError = true;
-            analysis.specificIssue =
-                "Network connectivity issue - cannot reach Google Cloud endpoints";
-        }
-        // Authentication errors
-        else if (errorMessage.includes("PERMISSION_DENIED") ||
-            errorMessage.includes("401") ||
-            errorMessage.includes("403") ||
-            errorMessage.includes("Unauthorized") ||
-            errorMessage.includes("Forbidden")) {
-            analysis.errorType = "AUTHENTICATION";
-            analysis.isAuthError = true;
-            analysis.specificIssue =
-                "Authentication failed - invalid credentials or insufficient permissions";
-        }
-        // Model availability errors
-        else if (errorMessage.includes("NOT_FOUND") ||
-            errorMessage.includes("404") ||
-            (errorMessage.includes("model") && errorMessage.includes("not available"))) {
-            analysis.errorType = "MODEL_AVAILABILITY";
-            analysis.isModelError = true;
-            analysis.specificIssue = `Model "${context.modelName}" not available in region "${context.region}"`;
-        }
-        // Regional/quota errors
-        else if (errorMessage.includes("QUOTA_EXCEEDED") ||
-            errorMessage.includes("quota") ||
-            errorMessage.includes("limit")) {
-            analysis.errorType = "QUOTA";
-            analysis.isRegionalError = true;
-            analysis.specificIssue = "Quota exceeded or rate limit reached";
-        }
-        // Configuration errors
-        else if (errorMessage.includes("INVALID_ARGUMENT") ||
-            errorMessage.includes("BadRequest") ||
-            errorMessage.includes("400")) {
-            analysis.errorType = "CONFIGURATION";
-            analysis.isConfigurationError = true;
-            analysis.specificIssue = "Invalid configuration or request parameters";
-        }
-        return analysis;
-    }
-    /**
-     * Get detailed troubleshooting steps based on error analysis
-     */
-    getAnthropicTroubleshootingSteps(errorAnalysis) {
-        const steps = [];
-        switch (errorAnalysis.errorType) {
-            case "NETWORK":
-                steps.push("🌐 Network Troubleshooting:", "1. Check internet connectivity", "2. Verify proxy configuration if behind corporate firewall", "3. Ensure firewall allows HTTPS to *.googleapis.com", "4. Try different network or wait for network issues to resolve", "5. Check if using VPN that might block Google Cloud endpoints");
-                break;
-            case "AUTHENTICATION":
-                steps.push("🔐 Authentication Troubleshooting:", "1. Verify GOOGLE_APPLICATION_CREDENTIALS file exists and is valid", "2. Check individual credentials: GOOGLE_AUTH_CLIENT_EMAIL, GOOGLE_AUTH_PRIVATE_KEY", '3. Ensure service account has "Vertex AI User" role', "4. Verify project ID matches the one in your credentials", "5. Enable Vertex AI API: https://console.cloud.google.com/apis/library/aiplatform.googleapis.com");
-                break;
-            case "MODEL_AVAILABILITY":
-                steps.push("🤖 Model Availability Troubleshooting:", "1. Verify model name format and spelling", "2. Check if Anthropic integration is enabled in your project", "3. Enable Claude models: https://console.cloud.google.com/vertex-ai/publishers/anthropic", "4. Try a different region if current region lacks Anthropic support", "5. Accept Anthropic terms and conditions in Google Cloud Console");
-                break;
-            case "QUOTA":
-                steps.push("📊 Quota Troubleshooting:", "1. Check Vertex AI quotas in Google Cloud Console", "2. Request quota increase if needed", "3. Try a different model with lower resource requirements", "4. Wait before retrying if rate limited", "5. Consider using a different region with available quota");
-                break;
-            case "CONFIGURATION":
-                steps.push("⚙️ Configuration Troubleshooting:", "1. Verify all required environment variables are set", "2. Check project ID and region format", "3. Ensure model name follows correct format", "4. Verify request parameters are within model limits", "5. Update @ai-sdk/google-vertex to latest version");
-                break;
-            default:
-                steps.push("🔧 General Troubleshooting:", "1. Update @ai-sdk/google-vertex to latest version", "2. Check Google Cloud service status", "3. Verify all authentication and configuration", "4. Try with a simple Claude model like claude-3-haiku-20240307", "5. Enable debug logging with NEUROLINK_DEBUG=true");
-        }
-        return steps;
-    }
-    /**
-     * Register a tool with the AI provider
-     * @param name The name of the tool
-     * @param schema The Zod schema defining the tool's parameters
-     * @param description A description of what the tool does
-     * @param handler The function to execute when the tool is called
-     */
-    registerTool(name, schema, description, handler) {
-        const functionTag = "GoogleVertexProvider.registerTool";
-        try {
-            const tool = {
-                description,
-                parameters: schema,
-                execute: async (params) => {
-                    try {
-                        const contextEnrichedParams = {
-                            ...params,
-                            __context: this.toolContext,
-                        };
-                        return await handler(contextEnrichedParams);
-                    }
-                    catch (error) {
-                        logger.error(`${functionTag}: Tool execution error`, {
-                            toolName: name,
-                            error: error instanceof Error ? error.message : String(error),
-                        });
-                        throw error;
-                    }
-                },
-            };
-            this.registeredTools.set(name, tool);
-            logger.debug(`${functionTag}: Tool registered`, {
-                toolName: name,
-                modelName: this.modelName,
-            });
-        }
-        catch (error) {
-            logger.error(`${functionTag}: Tool registration error`, {
-                toolName: name,
-                error: error instanceof Error ? error.message : String(error),
-            });
-            throw error;
-        }
-    }
-    /**
-     * Set the context for tool execution
-     * @param context The context to use for tool execution
-     */
-    setToolContext(context) {
-        this.toolContext = { ...this.toolContext, ...context };
-        logger.debug("GoogleVertexProvider.setToolContext: Tool context set", {
-            contextKeys: Object.keys(context),
-        });
-    }
-    /**
-     * Get the current tool execution context
-     * @returns The current tool execution context
-     */
-    getToolContext() {
-        return { ...this.toolContext };
-    }
-    /**
-     * Set the tool executor function for custom tool execution
-     * This method is called by BaseProvider.setupToolExecutor()
-     * @param executor Function to execute tools by name
-     */
-    setToolExecutor(executor) {
-        this.toolExecutor = executor;
-        logger.debug("GoogleVertexProvider.setToolExecutor: Tool executor set", {
-            hasExecutor: typeof executor === "function",
-        });
-    }
-    /**
-     * Clear all static caches - useful for testing and memory cleanup
-     * Public method to allow external cache management
-     */
-    static clearCaches() {
-        GoogleVertexProvider.modelConfigCache.clear();
-        GoogleVertexProvider.maxTokensCache.clear();
-        GoogleVertexProvider.modelConfigCacheTime = 0;
-        GoogleVertexProvider.maxTokensCacheTime = 0;
-        logger.debug("GoogleVertexProvider: All caches cleared", {
-            clearedAt: Date.now(),
-        });
-    }
-    /**
-     * Get cache statistics for monitoring and debugging
-     */
-    static getCacheStats() {
-        const now = Date.now();
-        return {
-            modelConfigCacheSize: GoogleVertexProvider.modelConfigCache.size,
-            maxTokensCacheSize: GoogleVertexProvider.maxTokensCache.size,
-            maxCacheSize: GoogleVertexProvider.MAX_CACHE_SIZE,
-            cacheAge: {
-                modelConfig: now - GoogleVertexProvider.modelConfigCacheTime,
-                maxTokens: now - GoogleVertexProvider.maxTokensCacheTime,
-            },
-        };
-    }
-    /**
-     * Detect image MIME type from buffer
-     */
-    detectImageType(buffer) {
-        // Check PNG signature
-        if (buffer.length >= 8 &&
-            buffer[0] === 0x89 &&
-            buffer[1] === 0x50 &&
-            buffer[2] === 0x4e &&
-            buffer[3] === 0x47) {
-            return "image/png";
-        }
-        // Check JPEG signature
-        if (buffer.length >= 3 &&
-            buffer[0] === 0xff &&
-            buffer[1] === 0xd8 &&
-            buffer[2] === 0xff) {
-            return "image/jpeg";
-        }
-        // Check WebP signature
-        if (buffer.length >= 12 &&
-            buffer[0] === 0x52 &&
-            buffer[1] === 0x49 &&
-            buffer[2] === 0x46 &&
-            buffer[3] === 0x46 &&
-            buffer[8] === 0x57 &&
-            buffer[9] === 0x45 &&
-            buffer[10] === 0x42 &&
-            buffer[11] === 0x50) {
-            return "image/webp";
-        }
-        // Check GIF signature
-        if (buffer.length >= 6 &&
-            buffer[0] === 0x47 &&
-            buffer[1] === 0x49 &&
-            buffer[2] === 0x46) {
-            return "image/gif";
-        }
-        // Default to PNG if unknown
-        return "image/png";
-    }
-    /**
-     * Estimate token count from text using centralized estimation with provider multipliers
-     */
-    estimateTokenCount(text) {
-        return estimateTokens(text, "vertex");
-    }
-    /**
-     * Obtain a Google Auth access token for Vertex AI REST API calls.
-     */
-    async getImageGenerationAccessToken() {
-        const maxRetries = 3;
-        const baseDelay = 500;
-        const authTimeoutMs = 15000;
-        const { GoogleAuth } = await import("google-auth-library");
-        // Priority: GOOGLE_APPLICATION_CREDENTIALS_NEUROLINK > GOOGLE_APPLICATION_CREDENTIALS
-        const credentialsPath = process.env.GOOGLE_APPLICATION_CREDENTIALS_NEUROLINK ||
-            process.env.GOOGLE_APPLICATION_CREDENTIALS;
-        for (let attempt = 1; attempt <= maxRetries; attempt++) {
-            // Enforce per-attempt timeout with AbortController
-            const controller = new AbortController();
-            const authTimer = setTimeout(() => {
-                controller.abort();
-                logger.warn(`[GoogleVertexProvider] Auth token refresh exceeded ${authTimeoutMs}ms timeout (attempt ${attempt}/${maxRetries})`);
-            }, authTimeoutMs);
-            try {
-                const auth = new GoogleAuth({
-                    ...(credentialsPath && { keyFilename: credentialsPath }),
-                    scopes: ["https://www.googleapis.com/auth/cloud-platform"],
-                });
-                const client = await auth.getClient();
-                const accessToken = await client.getAccessToken();
-                if (!accessToken.token) {
-                    throw new AuthenticationError("Failed to obtain access token from Google Auth", this.providerName);
-                }
-                return accessToken.token;
-            }
-            catch (error) {
-                const err = error;
-                const isRetryable = controller.signal.aborted ||
-                    err?.code === "ECONNRESET" ||
-                    err?.code === "ETIMEDOUT" ||
-                    err?.code === "ENOTFOUND" ||
-                    err?.message?.includes("socket hang up") ||
-                    err?.message?.includes("network socket disconnected");
-                if (!isRetryable || attempt === maxRetries) {
-                    throw error;
-                }
-                const delay = baseDelay * 2 ** (attempt - 1);
-                logger.warn(`[GoogleVertexProvider] Auth token transient error (${err?.code || err?.message}), retrying in ${delay}ms (attempt ${attempt}/${maxRetries})`);
-                await new Promise((r) => setTimeout(r, delay));
-            }
-            finally {
-                clearTimeout(authTimer);
-            }
-        }
-        throw new AuthenticationError("Failed to obtain access token after retries", this.providerName);
-    }
-    /**
-     * Build request parts for image generation from prompt, PDFs, and images.
-     */
-    async buildImageGenerationParts(prompt, pdfFiles, inputImages) {
-        const parts = [];
-        if (prompt) {
-            parts.push({ text: prompt });
-        }
-        // Add PDF files as inline data
-        for (const pdfFile of pdfFiles) {
-            let pdfBase64;
-            if (Buffer.isBuffer(pdfFile)) {
-                pdfBase64 = pdfFile.toString("base64");
-            }
-            else if (typeof pdfFile === "string") {
-                const isFilePath = pdfFile.startsWith("/") ||
-                    /^[a-zA-Z]:\\/.test(pdfFile) ||
-                    pdfFile.startsWith("./") ||
-                    pdfFile.startsWith("../") ||
-                    pdfFile.startsWith("..\\") ||
-                    pdfFile.startsWith(".\\");
-                if (isFilePath) {
-                    const normalizedPath = path.resolve(pdfFile);
-                    const cwd = process.cwd();
-                    if (!normalizedPath.startsWith(cwd + path.sep) &&
-                        normalizedPath !== cwd) {
-                        throw new ProviderError(`PDF file path must be within current directory for security`, this.providerName);
-                    }
-                    if (!fs.existsSync(normalizedPath)) {
-                        throw new ProviderError(`PDF file not found: ${normalizedPath}`, this.providerName);
-                    }
-                    const pdfBuffer = fs.readFileSync(normalizedPath);
-                    pdfBase64 = pdfBuffer.toString("base64");
-                }
-                else {
-                    pdfBase64 = pdfFile;
-                }
-            }
-            else {
-                logger.warn("Invalid PDF file format, skipping", {
-                    type: typeof pdfFile,
-                });
-                continue;
-            }
-            parts.push({
-                inlineData: {
-                    mimeType: "application/pdf",
-                    data: pdfBase64,
-                },
-            });
-            logger.debug("Added PDF file to request", {
-                dataLength: pdfBase64.length,
-            });
-        }
-        // Add images (including those converted from PDF by baseProvider)
-        for (let i = 0; i < inputImages.length; i++) {
-            const image = inputImages[i];
-            let imageBase64;
-            let mimeType;
-            if (Buffer.isBuffer(image)) {
-                imageBase64 = image.toString("base64");
-                mimeType = this.detectImageType(image);
-            }
-            else if (typeof image === "string") {
-                const isFilePath = image.startsWith("/") ||
-                    /^[a-zA-Z]:\\/.test(image) ||
-                    image.startsWith("./") ||
-                    image.startsWith("../") ||
-                    image.startsWith("..\\") ||
-                    image.startsWith(".\\");
-                if (isFilePath) {
-                    const normalizedPath = path.resolve(image);
-                    if (!fs.existsSync(normalizedPath)) {
-                        logger.warn(`Image file not found: ${normalizedPath}, skipping`);
-                        continue;
-                    }
-                    const imageBuffer = fs.readFileSync(normalizedPath);
-                    imageBase64 = imageBuffer.toString("base64");
-                    mimeType = this.detectImageType(imageBuffer);
-                }
-                else if (image.startsWith("data:")) {
-                    const matches = image.match(/^data:([^;]+);base64,(.+)$/);
-                    if (matches) {
-                        mimeType = matches[1];
-                        imageBase64 = matches[2];
-                    }
-                    else {
-                        logger.warn("Invalid data URL format, skipping image", {
-                            index: i,
-                        });
-                        continue;
-                    }
-                }
-                else if (image.startsWith("http://") ||
-                    image.startsWith("https://")) {
-                    // Download URL image and convert to base64
-                    try {
-                        // Validate URL to prevent SSRF attacks
-                        const parsedUrl = new URL(image);
-                        const hostname = parsedUrl.hostname;
-                        const blockedHosts = ["localhost", "127.0.0.1", "0.0.0.0", "[::1]"];
-                        if (blockedHosts.some((h) => hostname === h) ||
-                            /^(10\.|172\.(1[6-9]|2\d|3[01])\.|192\.168\.)/.test(hostname)) {
-                            logger.warn(`[GoogleVertexProvider] Blocked fetch to private/local URL: ${hostname}`, { index: i });
-                            continue;
-                        }
-                        // DNS resolution check — verify resolved IPs are not private/loopback
-                        try {
-                            const { resolve4, resolve6 } = dns.promises;
-                            const addresses = [];
-                            try {
-                                addresses.push(...(await resolve4(hostname)));
-                            }
-                            catch {
-                                /* hostname may not have A records */
-                            }
-                            try {
-                                addresses.push(...(await resolve6(hostname)));
-                            }
-                            catch {
-                                /* hostname may not have AAAA records */
-                            }
-                            if (addresses.length > 0 &&
-                                addresses.every((addr) => isPrivateOrLoopbackAddress(addr))) {
-                                logger.warn(`[GoogleVertexProvider] Blocked fetch: hostname ${hostname} resolves to private/loopback address`, { index: i, addresses });
-                                continue;
-                            }
-                        }
-                        catch (dnsError) {
-                            logger.warn(`[GoogleVertexProvider] DNS resolution failed for ${hostname}, blocking fetch`, {
-                                index: i,
-                                error: dnsError instanceof Error
-                                    ? dnsError.message
-                                    : String(dnsError),
-                            });
-                            continue;
-                        }
-                        const response = await fetch(image, {
-                            signal: AbortSignal.timeout(15_000),
-                        });
-                        if (!response.ok) {
-                            logger.warn(`Failed to fetch image URL (${response.status}), skipping`, { index: i, url: image });
-                            continue;
-                        }
-                        // Size guard — reject downloads exceeding 10 MB
-                        const contentLength = response.headers.get("content-length");
-                        if (contentLength &&
-                            Number(contentLength) > MAX_IMAGE_DOWNLOAD_BYTES) {
-                            logger.warn(`[GoogleVertexProvider] Image URL exceeds ${MAX_IMAGE_DOWNLOAD_BYTES} byte limit (Content-Length: ${contentLength}), skipping`, { index: i, url: image });
-                            continue;
-                        }
-                        const buffer = Buffer.from(await response.arrayBuffer());
-                        if (buffer.byteLength > MAX_IMAGE_DOWNLOAD_BYTES) {
-                            logger.warn(`[GoogleVertexProvider] Downloaded image exceeds ${MAX_IMAGE_DOWNLOAD_BYTES} byte limit (${buffer.byteLength} bytes), skipping`, { index: i, url: image });
-                            continue;
-                        }
-                        imageBase64 = buffer.toString("base64");
-                        mimeType = this.detectImageType(buffer);
-                    }
-                    catch (fetchError) {
-                        logger.warn(`Failed to download image from URL, skipping: ${fetchError instanceof Error ? fetchError.message : String(fetchError)}`, { index: i, url: image });
-                        continue;
-                    }
-                }
-                else {
-                    imageBase64 = image;
-                    const decodedBuffer = Buffer.from(imageBase64, "base64");
-                    mimeType = this.detectImageType(decodedBuffer);
-                }
-            }
-            else {
-                logger.warn("Invalid image format, skipping", {
-                    type: typeof image,
-                    index: i,
-                });
-                continue;
-            }
-            parts.push({
-                inlineData: {
-                    mimeType: mimeType,
-                    data: imageBase64,
-                },
-            });
-            logger.debug("Added image to request", {
-                index: i,
-                mimeType,
-                dataLength: imageBase64.length,
-            });
-        }
-        return parts;
-    }
-    /**
-     * Parse the Vertex AI image generation REST API response and extract image data.
-     */
-    parseImageGenerationResponse(data, imageModelName) {
-        const candidate = data.candidates?.[0];
-        if (!candidate?.content?.parts) {
-            throw new ProviderError("No content parts in Vertex AI response", this.providerName);
-        }
-        // Find image part (check both camelCase and snake_case)
-        const imagePart = candidate.content.parts.find((part) => (part.inlineData || part.inline_data) &&
-            ((part.inlineData && part.inlineData.mimeType) ||
-                (part.inline_data && part.inline_data.mime_type)) &&
-            ((part.inlineData && part.inlineData.mimeType?.startsWith("image/")) ||
-                (part.inline_data &&
-                    part.inline_data.mime_type?.startsWith("image/"))));
-        if (!imagePart) {
-            const hasTextContent = candidate.content.parts.some((part) => part.text);
-            throw new ProviderError(hasTextContent
-                ? `Image generation completed but model returned text instead of image data. Model: ${imageModelName}`
-                : `Image generation completed but no image data was returned. Model: ${imageModelName}`, this.providerName);
-        }
-        const imageData = imagePart.inlineData?.data || imagePart.inline_data?.data;
-        const mimeType = imagePart.inlineData?.mimeType ||
-            imagePart.inline_data?.mime_type ||
-            "image/png";
-        if (!imageData) {
-            throw new ProviderError("Image part found but no data available", this.providerName);
-        }
-        return { imageData, mimeType };
-    }
-    /**
-     * Overrides the BaseProvider's image generation method to implement it for Vertex AI.
-     * Uses REST API approach with google-auth-library for authentication.
-     * Supports PDF input for image generation with gemini-3-pro-image-preview (Nano Banana Pro).
-     * @param options The generation options containing the prompt and optional PDF files.
-     * @returns A promise that resolves to the generation result, including the image data.
-     */
-    async executeImageGeneration(options) {
-        const prompt = options.prompt || options.input?.text || "";
-        const pdfFiles = options.input?.pdfFiles || [];
-        const inputImages = options.input?.images || [];
-        const hasPdfInput = pdfFiles.length > 0;
-        const hasImageInput = inputImages.length > 0;
-        if (!prompt.trim() && !hasPdfInput && !hasImageInput) {
-            throw new ProviderError("Image generation requires either a prompt, PDF file, or image as input", this.providerName);
-        }
-        // Select appropriate model
-        let imageModelName = options.model || this.modelName || "gemini-3-pro-image-preview";
-        if (hasPdfInput && !imageModelName.includes("gemini-3-pro-image")) {
-            imageModelName = "gemini-3-pro-image-preview";
-        }
-        // Determine location - some image models require 'global' location
-        const imageLocation = process.env.GOOGLE_VERTEX_IMAGE_LOCATION || "global";
-        const requiresGlobalLocation = GLOBAL_LOCATION_MODELS.some((model) => imageModelName.includes(model) || model.includes(imageModelName));
-        const location = requiresGlobalLocation ? imageLocation : this.location;
-        const startTime = Date.now();
-        logger.info("🎨 Starting Vertex AI image generation (REST API)", {
-            model: imageModelName,
-            prompt: prompt.substring(0, 100),
-            provider: this.providerName,
-            projectId: this.projectId,
-            location: location,
-            hasPdfInput,
-            pdfCount: pdfFiles.length,
-            hasImageInput,
-            imageCount: inputImages.length,
-        });
-        try {
-            const token = await this.getImageGenerationAccessToken();
-            const parts = await this.buildImageGenerationParts(prompt, pdfFiles, inputImages);
-            // Build request body with CRITICAL response_modalities setting
-            const requestBody = {
-                contents: [{ role: "user", parts }],
-                generation_config: {
-                    response_modalities: ["TEXT", "IMAGE"],
-                    temperature: options.temperature || 0.7,
-                    candidate_count: 1,
-                },
-            };
-            // Construct Vertex AI endpoint
-            let url;
-            if (location === "global") {
-                url = `https://aiplatform.googleapis.com/v1/projects/${this.projectId}/locations/global/publishers/google/models/${imageModelName}:generateContent`;
-            }
-            else {
-                url = `https://${location}-aiplatform.googleapis.com/v1/projects/${this.projectId}/locations/${location}/publishers/google/models/${imageModelName}:generateContent`;
-            }
-            logger.debug("Making REST API call to Vertex AI", {
-                url,
-                model: imageModelName,
-                hasAccessToken: true,
-            });
-            // Add timeout protection (120 seconds for image generation)
-            const timeoutMs = 120000;
-            const fetchPromise = fetch(url, {
-                method: "POST",
-                headers: {
-                    Authorization: `Bearer ${token}`,
-                    "Content-Type": "application/json",
-                },
-                body: JSON.stringify(requestBody),
-            });
-            const timeoutPromise = new Promise((_, reject) => {
-                setTimeout(() => {
-                    reject(new TimeoutError(`Vertex AI image generation timed out after ${timeoutMs}ms`, timeoutMs));
-                }, timeoutMs);
-            });
-            const response = await Promise.race([fetchPromise, timeoutPromise]);
-            if (!response.ok) {
-                const errorText = await response.text();
-                throw new ProviderError(`Vertex AI API error (${response.status}): ${errorText}`, this.providerName);
-            }
-            const data = (await response.json());
-            const { imageData, mimeType } = this.parseImageGenerationResponse(data, imageModelName);
-            logger.info("Image generation successful", {
-                model: imageModelName,
-                mimeType,
-                dataLength: imageData.length,
-                responseTime: Date.now() - startTime,
-            });
-            const result = {
-                content: `Generated image using ${imageModelName} (${mimeType})`,
-                imageOutput: {
-                    base64: imageData,
-                },
-                provider: this.providerName,
-                model: imageModelName,
-                usage: {
-                    input: this.estimateTokenCount(prompt),
-                    output: 0,
-                    total: this.estimateTokenCount(prompt),
-                },
-            };
-            return await this.enhanceResult(result, options, startTime);
-        }
-        catch (error) {
-            logger.error("Image generation failed", {
-                error: error instanceof Error ? error.message : String(error),
-                model: imageModelName,
-                prompt: prompt.substring(0, 100),
-            });
-            throw this.handleProviderError(error);
-        }
-    }
-    /**
-     * Generate embeddings for text using Google Vertex AI text-embedding models
-     * @param text - The text to embed
-     * @param modelName - The embedding model to use (default: text-embedding-004)
-     * @returns Promise resolving to the embedding vector
-     */
-    async embed(text, modelName) {
-        const embeddingModelName = modelName || "text-embedding-004";
-        logger.debug("Generating embedding", {
-            provider: this.providerName,
-            model: embeddingModelName,
-            textLength: text.length,
-        });
-        try {
-            // Create the Vertex provider with current settings
-            const vertexSettings = await createVertexSettings(this.location);
-            const vertex = createVertex(vertexSettings);
-            // Get the text embedding model
-            const embeddingModel = vertex.textEmbeddingModel(embeddingModelName);
-            // Generate the embedding
-            const result = await embed({
-                model: embeddingModel,
-                value: text,
-            });
-            logger.debug("Embedding generated successfully", {
-                provider: this.providerName,
-                model: embeddingModelName,
-                embeddingDimension: result.embedding.length,
-            });
-            return result.embedding;
-        }
-        catch (error) {
-            logger.error("Embedding generation failed", {
-                error: error instanceof Error ? error.message : String(error),
-                model: embeddingModelName,
-                textLength: text.length,
-            });
-            throw this.handleProviderError(error);
-        }
-    }
-    /**
-     * Generate embeddings for multiple texts in a single batch
-     * @param texts - The texts to embed
-     * @param modelName - The embedding model to use (default: text-embedding-004)
-     * @returns Promise resolving to an array of embedding vectors
-     */
-    async embedMany(texts, modelName) {
-        const embeddingModelName = modelName || this.getDefaultEmbeddingModel() || "text-embedding-004";
-        logger.debug("Generating batch embeddings", {
-            provider: this.providerName,
-            model: embeddingModelName,
-            count: texts.length,
-        });
-        try {
-            const vertexSettings = await createVertexSettings(this.location);
-            const vertex = createVertex(vertexSettings);
-            const embeddingModel = vertex.textEmbeddingModel(embeddingModelName);
-            const result = await embedMany({
-                model: embeddingModel,
-                values: texts,
-            });
-            logger.debug("Batch embeddings generated successfully", {
-                provider: this.providerName,
-                model: embeddingModelName,
-                count: result.embeddings.length,
-                embeddingDimension: result.embeddings[0]?.length,
-            });
-            return result.embeddings;
-        }
-        catch (error) {
-            logger.error("Batch embedding generation failed", {
-                error: error instanceof Error ? error.message : String(error),
-                model: embeddingModelName,
-                count: texts.length,
-            });
-            throw this.handleProviderError(error);
-        }
-    }
-    /**
-     * Get model suggestions when a model is not found
-     */
-    getModelSuggestions(requestedModel) {
-        const availableModels = {
-            google: [
-                "gemini-3.1-pro-preview",
-                "gemini-3.1-flash-lite-preview",
-                "gemini-3-flash-preview",
-                "gemini-2.5-pro",
-                "gemini-2.5-flash",
-                "gemini-2.5-flash-lite",
-                "gemini-2.0-flash-001",
-                "gemini-2.0-flash-lite",
-                "gemini-1.5-pro",
-                "gemini-1.5-flash",
-            ],
-            claude: [
-                "claude-sonnet-4-5@20250929",
-                "claude-sonnet-4@20250514",
-                "claude-opus-4@20250514",
-                "claude-3-5-sonnet-20241022",
-                "claude-3-5-haiku-20241022",
-                "claude-3-sonnet-20240229",
-                "claude-3-haiku-20240307",
-                "claude-3-opus-20240229",
-            ],
-        };
-        let suggestions = "\n🤖 Google Models (always available):\n";
-        availableModels.google.forEach((model) => {
-            suggestions += `  • ${model}\n`;
-        });
-        suggestions += "\n🧠 Claude Models (requires Anthropic integration):\n";
-        availableModels.claude.forEach((model) => {
-            suggestions += `  • ${model}\n`;
-        });
-        // If the requested model looks like a Claude model, provide specific guidance
-        if (requestedModel && requestedModel.toLowerCase().includes("claude")) {
-            suggestions += `\n💡 Tip: "${requestedModel}" appears to be a Claude model.\n`;
-            suggestions +=
-                "Ensure Anthropic integration is enabled in your Google Cloud project.\n";
-            suggestions += "Try using an available Claude model from the list above.";
-        }
-        return suggestions;
-    }
-}
-export default GoogleVertexProvider;
-// Re-export for compatibility
-export { GoogleVertexProvider as GoogleVertexAI };