@juspay/neurolink 12.47.0 → 12.47.2

package/dist/cli/commands/setup.js

@@ -19,6 +19,7 @@ import { handleBedrockSetup } from "./setup-bedrock.js";
 import { handleGCPSetup } from "./setup-gcp.js";
 import { handleHuggingFaceSetup } from "./setup-huggingface.js";
 import { handleMistralSetup } from "./setup-mistral.js";
+import { OpenRouterModels, } from "../../constants/enums.js";
 import { PROVIDER_DESCRIPTORS_BY_NAME } from "../../factories/providerDescriptors.js";
 import { createCohereConfig, createDeepSeekConfig, createIdeogramConfig, createJinaConfig, createNvidiaNimConfig, createOpenAICompatibleConfig, createRecraftConfig, createReplicateConfig, createStabilityConfig, createVoyageConfig, createTypeSafeConfig, createLayaConfig, createXorConfig, createPerplexityDeciderConfig, createCloudflareClefConfig, satisfiesFallbacks, } from "../../utils/providerConfig.js";
 import { getCatalogJsonEntries, buildCatalogConfigOptions, } from "../../providers/catalog/loader.js";
@@ -571,13 +572,13 @@ async function handleOpenRouterSetup() {
     logger.always(chalk.cyan("  export OPENROUTER_API_KEY=your_api_key_here"));
     logger.always("");
     logger.always(chalk.yellow("Step 3: Test the configuration"));
-    logger.always(chalk.cyan('  neurolink generate "Hello!" --provider openrouter --model google/gemini-2.0-flash-exp:free'));
+    logger.always(chalk.cyan(`  neurolink generate "Hello!" --provider openrouter --model ${OpenRouterModels.GEMINI_2_5_FLASH}`));
     logger.always("");
     logger.always(chalk.green("Available models include:"));
-    logger.always("  • anthropic/claude-3.5-sonnet - Best for analysis");
-    logger.always("  • openai/gpt-4o - Industry standard");
-    logger.always("  • google/gemini-2.0-flash-exp:free - Free tier");
-    logger.always("  • meta-llama/llama-3.1-70b-instruct - Open source");
+    logger.always(`  • ${OpenRouterModels.CLAUDE_SONNET_4_6} - Best for analysis`);
+    logger.always(`  • ${OpenRouterModels.GPT_4O} - Industry standard`);
+    logger.always(`  • ${OpenRouterModels.GEMINI_2_5_FLASH} - Fast and efficient`);
+    logger.always(`  • ${OpenRouterModels.LLAMA_3_1_70B} - Open source`);
     logger.always("");
     logger.always(chalk.gray("See all models at: https://openrouter.ai/models"));
 }

package/dist/cli/proxy-clients/copilot.js

@@ -46,12 +46,66 @@ function getCopilotEnvPath() {
 function getProfileCandidates() {
     return [".zshrc", ".zprofile", ".bashrc", ".bash_profile", ".profile"].map((name) => join(homedir(), name));
 }
+/** A command that is `source`/`.` of a path ending in exactly `copilot-env.sh`, optionally after `then`/`else`/`do`. */
+const ENV_SCRIPT_SOURCE_COMMAND = /^\s*(?:(?:then|else|do)\s+)?(?:source|\.)\s+(["']?)(?:[^\s"']*\/)?copilot-env\.sh\1(?:\s|$)/;
+/**
+ * One profile line as the commands it runs, comment dropped. Quote-aware, so a
+ * `;` or `#` inside quotes neither splits nor starts a comment. Heredocs,
+ * multi-line strings and line continuations are not modelled, so a source line
+ * inside one is still counted, and a source built with `eval` is missed. Both
+ * are rare; this guards against the common mentions (a comment, an `echo`, a
+ * file-existence test, a `.bak` name) that suppressed the note before.
+ */
+function splitProfileCommands(line) {
+    const commands = [];
+    let current = "";
+    let quote = null;
+    for (let i = 0; i < line.length; i++) {
+        const char = line[i];
+        if (quote) {
+            current += char;
+            if (quote === '"' && char === "\\") {
+                current += line[i + 1] ?? "";
+                i++;
+            }
+            else if (char === quote) {
+                quote = null;
+            }
+            continue;
+        }
+        if (char === "\\") {
+            current += char + (line[i + 1] ?? "");
+            i++;
+            continue;
+        }
+        if (char === '"' || char === "'") {
+            quote = char;
+            current += char;
+            continue;
+        }
+        if (char === "#" &&
+            (current === "" || /\s/.test(current[current.length - 1]))) {
+            break;
+        }
+        if (char === ";" || char === "&" || char === "|") {
+            commands.push(current);
+            current = "";
+            continue;
+        }
+        current += char;
+    }
+    commands.push(current);
+    return commands;
+}
 /** Whether any shell profile already sources the generated script. */
 async function isEnvScriptSourced() {
     const fs = await import("fs");
     for (const profile of getProfileCandidates()) {
         try {
-            if (fs.readFileSync(profile, "utf8").includes("copilot-env.sh")) {
+            if (fs
+                .readFileSync(profile, "utf8")
+                .split(/\r?\n/)
+                .some((line) => splitProfileCommands(line).some((command) => ENV_SCRIPT_SOURCE_COMMAND.test(command)))) {
                 return true;
             }
         }

package/dist/constants/contextWindows.js

@@ -122,6 +122,11 @@ export const MODEL_CONTEXT_WINDOWS = {
         "claude-fable-5-1": 1_000_000,
         // Claude 5 (mid 2026) — 1M context window
         "claude-sonnet-5": 1_000_000,
+        "claude-opus-5": 1_000_000,
+        "claude-fable-5": 1_000_000,
+        // Claude 4.7 / 4.8 — 1M context window (platform.claude.com/docs/en/models)
+        "claude-opus-4-8": 1_000_000,
+        "claude-opus-4-7": 1_000_000,
         // Claude 4.6 (Feb 2026) — 1M context window
         "claude-opus-4-6": 1_000_000,
         "claude-sonnet-4-6": 1_000_000,
@@ -220,6 +225,13 @@ export const MODEL_CONTEXT_WINDOWS = {
         "claude-sonnet-5-5": 1_000_000,
         "claude-fable-5-1": 1_000_000,
         "claude-sonnet-5": 1_000_000,
+        // Placed before the 200K `claude-opus-4` prefix key below: the lookup takes
+        // the first prefix that matches, so a dated `claude-opus-4-8@...` id would
+        // otherwise land on 200K.
+        "claude-opus-5": 1_000_000,
+        "claude-fable-5": 1_000_000,
+        "claude-opus-4-8": 1_000_000,
+        "claude-opus-4-7": 1_000_000,
         "claude-opus-4-6": 1_000_000,
         "claude-sonnet-4-6": 1_000_000,
         "claude-sonnet-4-5": 200_000,

package/dist/core/toolExecutionGuards.d.ts

@@ -13,15 +13,7 @@
  */
 import type { Tool, ToolExecutionGuards } from "../types/index.js";
 /**
- * Mid-turn tool sync for the native Gemini loops that build their snapshot
- * via buildNativeToolDeclarations. `search_tools` (tools.discovery) hydrates
- * discovered tools into the live record between steps; without this refresh
- * they stay invisible to the rest of the turn and every call dies as
- * TOOL_NOT_FOUND. Mutates the snapshot in place — the request config holds
- * `toolsConfig` by reference — and returns true when anything was added.
- */
-/**
- * Everything a native Gemini loop wraps around a tool call that the shared
+ * Everything a native provider loop wraps around a tool call that the shared
  * engine does not do itself.
  *
  * Order matters. `raceWithAbort` sits INSIDE `withTimeout` so a turn-level

package/dist/core/toolExecutionGuards.js

@@ -13,15 +13,7 @@
  */
 import { raceWithAbort, withTimeout } from "../utils/async/index.js";
 /**
- * Mid-turn tool sync for the native Gemini loops that build their snapshot
- * via buildNativeToolDeclarations. `search_tools` (tools.discovery) hydrates
- * discovered tools into the live record between steps; without this refresh
- * they stay invisible to the rest of the turn and every call dies as
- * TOOL_NOT_FOUND. Mutates the snapshot in place — the request config holds
- * `toolsConfig` by reference — and returns true when anything was added.
- */
-/**
- * Everything a native Gemini loop wraps around a tool call that the shared
+ * Everything a native provider loop wraps around a tool call that the shared
  * engine does not do itself.
  *
  * Order matters. `raceWithAbort` sits INSIDE `withTimeout` so a turn-level

package/dist/factories/providerFactory.js

@@ -22,6 +22,17 @@ export function resolveCredentialKey(providerName) {
     const normalized = providerName.toLowerCase();
     return (ProviderFactory.getDescriptor(normalized)?.credentialsKey ?? normalized);
 }
+/**
+ * registerProvider() takes a class as well as a factory (ProviderConstructor),
+ * and calling a class without `new` throws. A prototype test cannot tell them
+ * apart, because every non-arrow function's prototype points back at itself,
+ * so the source text decides. A factory is therefore never constructed and
+ * never retried after it throws.
+ */
+function isClassConstructor(candidate) {
+    return (typeof candidate === "function" &&
+        /^class[\s{]/.test(Function.prototype.toString.call(candidate)));
+}
 /**
  * True Factory Pattern implementation for AI Providers
  * Uses registration-based approach to eliminate switch statements
@@ -113,7 +124,11 @@ export class ProviderFactory {
             if (typeof registration.constructor !== "function") {
                 throw new Error(`Invalid constructor for provider ${providerName}: not a function`);
             }
-            const factoryResult = registration.constructor(model, resolvedProviderName, sdk, region, scopedCredentials);
+            // A factory keeps being called as a method of the registration, as it
+            // always was; only a class is constructed.
+            const factoryResult = isClassConstructor(registration.constructor)
+                ? new registration.constructor(model, resolvedProviderName, sdk, region, scopedCredentials)
+                : registration.constructor(model, resolvedProviderName, sdk, region, scopedCredentials);
             const result = factoryResult instanceof Promise ? await factoryResult : factoryResult;
             return result;
         }

package/dist/files/fileReferenceRegistry.js

@@ -827,7 +827,7 @@ export class FileReferenceRegistry {
                     extractedText = await this.extractWordText(buffer, ref);
                     break;
                 case "pptx":
-                    extractedText = await this.extractPptxText(buffer);
+                    extractedText = await this.extractPptxText(buffer, ref.filename);
                     break;
                 case "video":
                     extractedText = await this.extractVideoContent(buffer, ref);
@@ -992,13 +992,13 @@ export class FileReferenceRegistry {
     /**
      * Extract text from a PowerPoint file using PptxProcessor.
      */
-    async extractPptxText(buffer) {
+    async extractPptxText(buffer, filename) {
         try {
             const { PptxProcessor } = await import("../processors/document/PptxProcessor.js");
             return await PptxProcessor.extractText(buffer);
         }
         catch (err) {
-            logger.warn(`[FileReferenceRegistry] PPTX extraction failed: ${err instanceof Error ? err.message : String(err)}`);
+            logger.warn(`[FileReferenceRegistry] PPTX extraction failed for "${filename}": ${err instanceof Error ? err.message : String(err)}`);
             return null;
         }
     }

package/dist/neurolink.js

@@ -8640,11 +8640,22 @@ Current user's request: ${currentInput}`;
                 }
                 yield fallbackChunk;
             }
+            // Read after the drain: a background-loop provider (native Vertex+Claude)
+            // fills these while the stream is consumed, so the values taken before
+            // the loop are still empty for it. Without this, a fallback that ran
+            // tools reports none on the result and in the end-of-turn events, and
+            // the 0-output gate below counts tool calls that had not appeared yet.
+            const finalToolCalls = fallbackResult.toolCalls ?? [];
+            const finalToolResults = fallbackResult.toolResults ?? [];
             if (fallbackRealOutputChunks === 0 &&
-                fallbackToolCalls.length === 0 &&
-                fallbackToolResults.length === 0) {
+                finalToolCalls.length === 0 &&
+                finalToolResults.length === 0) {
                 throw new Error(`Fallback provider ${fallbackRoute.provider} also returned 0 real output chunks (chunkCount=${fallbackChunkCount}, sentinel-only or empty)`);
             }
+            streamState.toolCalls = finalToolCalls;
+            streamState.toolResults = finalToolResults;
+            streamState.finishReason =
+                fallbackResult.finishReason ?? streamState.finishReason;
             // Fallback succeeded - likely guardrails blocked primary
             metadata.fallbackProvider = fallbackRoute.provider;
             metadata.fallbackModel = fallbackRoute.model;

package/dist/processors/media/VideoProcessor.js

@@ -660,6 +660,7 @@ export class VideoProcessor extends BaseFileProcessor {
      */
     async probeVideoWithFfmpeg(filePath) {
         let report;
+        let exitFailure;
         try {
             const { stderr } = await runFfmpeg(["-hide_banner", "-i", filePath, "-t", "0", "-f", "null", "-"], { timeoutMs: VIDEO_CONFIG.FFPROBE_TIMEOUT_MS });
             report = stderr;
@@ -668,18 +669,29 @@ export class VideoProcessor extends BaseFileProcessor {
             // A non-zero exit still carries the stream report when the failure came
             // after the input was opened.
             const stderr = error.stderr;
+            const message = error instanceof Error ? error.message : String(error);
             if (typeof stderr !== "string") {
                 return {
                     success: false,
-                    error: `ffmpeg probe failed: ${error instanceof Error ? error.message : String(error)}`,
+                    error: `ffmpeg probe failed: ${message}`,
                 };
             }
             report = stderr;
+            exitFailure = message;
         }
         const data = this.parseFfmpegInputReport(report);
-        return data
-            ? { success: true, data }
-            : { success: false, error: "ffmpeg reported no duration" };
+        if (data) {
+            return { success: true, data };
+        }
+        // Keep ffmpeg's own words when it failed as well as found no duration:
+        // a file it cannot read at all is the common case, and the reason is the
+        // only thing the warning that follows can tell the reader.
+        return {
+            success: false,
+            error: exitFailure
+                ? `ffmpeg reported no duration: ${exitFailure}`
+                : "ffmpeg reported no duration",
+        };
     }
     /**
      * Parse the input section of an ffmpeg banner: `Duration:`, `bitrate:` and

package/dist/providers/googleAiStudio/client.js

@@ -21,7 +21,7 @@ import { resolveToolExecutionRecords } from "../../core/toolExecutionRecorder.js
 import { buildDedupedEngineTools, buildGeminiResponseSchema, buildLoopExitMessage, buildNativeConfig, buildWrapupNudgeText, computeMaxSteps, createContextGuard, createTurnClock, buildUserPartsWithMultimodal, extractThoughtSignature, geminiContentsToV3Prompt, handleMaxStepsTermination, mapGeminiFinishReason, prependConversationMessages, resolveTurnStopReason, v3PromptToGeminiContents, } from "../googleNativeGemini3/index.js";
 import { createStreamChannel } from "../../core/streamChannel.js";
 import { toNativeToolDeclarations } from "../../core/nativeToolFormat.js";
-import { warnGoogleSdkIgnoresProxy } from "../../proxy/proxyFetch.js";
+import { googleSdkProxyHttpOptions } from "../../proxy/proxyFetch.js";
 // ── Model middleware stream/generate bridges ──
 //
 // Caller model middleware (transformParams / wrapGenerate / wrapStream) is
@@ -145,20 +145,19 @@ async function createGoogleGenAIClient(apiKey, baseURL) {
         });
     }
     const Ctor = ctor;
-    // httpOptions carries the endpoint override and nothing else. It used to
-    // also pass a proxy fetch, which the SDK silently ignored — see
-    // warnGoogleSdkIgnoresProxy for why that is not fixable here.
+    // httpOptions carries the endpoint override and, when a proxy is configured,
+    // the proxy-aware fetch the SDK sends its requests through.
     //
     // baseUrl is only included when resolved — verified against
     // @google/genai's ApiClient (dist/node/index.cjs) that it falls back to
     // its own default whenever httpOptions.baseUrl is undefined, so omitting
     // the key and passing `baseUrl: undefined` behave identically; the key is
     // still omitted outright for a cleaner outbound config object.
-    warnGoogleSdkIgnoresProxy("GoogleAIStudio");
     return new Ctor({
         apiKey,
         httpOptions: {
             ...(baseURL ? { baseUrl: baseURL } : {}),
+            ...googleSdkProxyHttpOptions(),
         },
     });
 }
@@ -2202,7 +2201,17 @@ export class GoogleAIStudioProvider extends BaseProvider {
             }
             queue.push(item);
         };
-        const session = await client.live.connect({
+        // @google/genai 2.x waits inside connect() for the server's setupComplete
+        // message and does not reject when the socket errors or closes first, so a
+        // refused key or model would leave this await pending forever. Fail on the
+        // first error or close that arrives before the session is up. Once it is
+        // up, the callbacks below end the stream as they always did.
+        let sessionOpen = false;
+        let failConnect = () => undefined;
+        const connectFailed = new Promise((_resolve, reject) => {
+            failConnect = reject;
+        });
+        const connecting = client.live.connect({
             model,
             callbacks: {
                 onopen: () => {
@@ -2230,9 +2239,15 @@ export class GoogleAIStudioProvider extends BaseProvider {
                     }
                 },
                 onerror: (e) => {
+                    if (!sessionOpen) {
+                        failConnect(new Error("Gemini Live connection failed before setup completed"));
+                    }
                     push({ type: "error", error: e });
                 },
                 onclose: (_e) => {
+                    if (!sessionOpen) {
+                        failConnect(new Error("Gemini Live connection closed before setup completed"));
+                    }
                     push({ type: "end" });
                 },
             },
@@ -2243,6 +2258,8 @@ export class GoogleAIStudioProvider extends BaseProvider {
                 },
             },
         });
+        const session = await Promise.race([connecting, connectFailed]);
+        sessionOpen = true;
         // Feed upstream audio frames concurrently
         (async () => {
             try {
@@ -2411,11 +2428,35 @@ export class GoogleAIStudioProvider extends BaseProvider {
         try {
             const apiKey = this.getApiKey();
             const client = await createGoogleGenAIClient(apiKey, this.getBaseURL());
-            const result = await client.models.embedContent({
-                model: embeddingModelName,
-                contents: texts,
-            });
-            const embeddings = (result.embeddings || []).map((e) => e.values || []);
+            const embeddings = [];
+            if (embeddingModelName.includes("gemini-embedding-2")) {
+                // @google/genai 2.x reads an array of strings for these models as ONE
+                // content with several parts, so a batch would come back as a single
+                // vector. Embed each text on its own, a few at a time, in order.
+                const concurrency = 8;
+                for (let start = 0; start < texts.length; start += concurrency) {
+                    const group = texts.slice(start, start + concurrency);
+                    const results = await Promise.all(group.map((text) => client.models.embedContent({
+                        model: embeddingModelName,
+                        contents: [text],
+                    })));
+                    for (const result of results) {
+                        embeddings.push(result.embeddings?.[0]?.values || []);
+                    }
+                }
+            }
+            else {
+                const result = await client.models.embedContent({
+                    model: embeddingModelName,
+                    contents: texts,
+                });
+                embeddings.push(...(result.embeddings || []).map((e) => e.values || []));
+            }
+            // One vector per text, or fail: a silent mismatch would pair texts with
+            // the wrong vectors downstream.
+            if (embeddings.length !== texts.length) {
+                throw new Error(`Embedding response held ${embeddings.length} vectors for ${texts.length} texts`);
+            }
             logger.debug("Batch embeddings generated successfully", {
                 provider: this.providerName,
                 model: embeddingModelName,

package/dist/providers/googleNativeGemini3/utils.d.ts

@@ -52,6 +52,15 @@ export declare function buildNativeToolDeclarations(tools: Record<string, Tool>,
  * duplicate side effects the moment the model repeats itself.
  */
 export declare function buildDedupedEngineTools(declarations: NativeToolDeclarationsResult | undefined, tools: Record<string, Tool> | undefined, guards?: ToolExecutionGuards): NonNullable<AgenticLoopOptions["tools"]>;
+/**
+ * Mid-turn tool sync for the native Gemini loops that build their snapshot
+ * via buildNativeToolDeclarations. `search_tools` (tools.discovery) hydrates
+ * discovered tools into the live record between steps; without this refresh
+ * they stay invisible to the rest of the turn and every call dies as
+ * TOOL_NOT_FOUND. Mutates the snapshot in place — the request config holds
+ * `toolsConfig` by reference — and returns the original names of the tools it
+ * added (empty when nothing was added).
+ */
 export declare function refreshNativeToolDeclarations(liveTools: Record<string, Tool> | undefined, current: NativeToolDeclarationsResult): string[];
 /**
  * Build the native @google/genai config object shared by stream and generate.

package/dist/providers/googleNativeGemini3/utils.js

@@ -381,6 +381,15 @@ export function buildDedupedEngineTools(declarations, tools, guards) {
     }
     return engineTools;
 }
+/**
+ * Mid-turn tool sync for the native Gemini loops that build their snapshot
+ * via buildNativeToolDeclarations. `search_tools` (tools.discovery) hydrates
+ * discovered tools into the live record between steps; without this refresh
+ * they stay invisible to the rest of the turn and every call dies as
+ * TOOL_NOT_FOUND. Mutates the snapshot in place — the request config holds
+ * `toolsConfig` by reference — and returns the original names of the tools it
+ * added (empty when nothing was added).
+ */
 export function refreshNativeToolDeclarations(liveTools, current) {
     if (!liveTools) {
         return [];

package/dist/providers/googleVertex/client.js

@@ -13,7 +13,7 @@ import { resolveRequestKind } from "../../core/resolveRequestKind.js";
 import { ModelConfigurationManager } from "../../core/modelConfiguration.js";
 import { isSchemaComplexityError } from "../../core/modules/structuredOutputPolicy.js";
 import { redactUrlForError, stringifyContentSafe, } from "../../utils/logSanitize.js";
-import { warnGoogleSdkIgnoresProxy } from "../../proxy/proxyFetch.js";
+import { googleSdkProxyHttpOptions } from "../../proxy/proxyFetch.js";
 import { AuthenticationError, InvalidModelError, NetworkError, ProviderError, RateLimitError, } from "../../types/index.js";
 import { classifyProviderError } from "../../utils/errorClassifier.js";
 import { ERROR_CODES, NeuroLinkError } from "../../utils/errorHandling.js";
@@ -1122,7 +1122,6 @@ export class GoogleVertexProvider extends BaseProvider {
      * Create @google/genai client configured for Vertex AI
      */
     async createVertexGenAIClient(regionOverride) {
-        warnGoogleSdkIgnoresProxy("GoogleVertex");
         const expressApiKey = this.resolveExpressApiKey();
         // Resolved only on the ADC path, and from the per-instance projectId the
         // constructor already settled (credentials.projectId if supplied, else
@@ -1147,14 +1146,14 @@ export class GoogleVertexProvider extends BaseProvider {
         const Ctor = ctor;
         const baseUrl = this.resolveBaseURL();
         const httpOptions = {
-            // The endpoint override and nothing else. This object used to also pass
-            // a proxy fetch, which the SDK silently ignored — see
-            // warnGoogleSdkIgnoresProxy for why that is not fixable here.
+            // The endpoint override and, when a proxy is configured, the
+            // proxy-aware fetch the SDK sends its requests through.
             //
-            // Only set when resolved: the SDK falls back to its own default
-            // whenever httpOptions.baseUrl is undefined, so omitting the key and
-            // passing undefined behave identically.
+            // baseUrl is only set when resolved: the SDK falls back to its own
+            // default whenever httpOptions.baseUrl is undefined, so omitting the key
+            // and passing undefined behave identically.
             ...(baseUrl ? { baseUrl } : {}),
+            ...googleSdkProxyHttpOptions(),
         };
         if (expressApiKey) {
             // Express Mode: an API key replaces project/location entirely. Passing

package/dist/proxy/proxyFetch.d.ts

@@ -3,6 +3,7 @@
  * Supports HTTP/HTTPS, SOCKS4/5, authentication, and NO_PROXY bypass
  * Lightweight implementation extracted from research of major proxy packages
  */
+import type { GoogleGenAIHttpOptions } from "../types/index.js";
 /**
  * Classify a fetch failure as a transient network error worth retrying.
  *
@@ -47,4 +48,18 @@ export declare function getProxyStatus(): {
     method: string;
     capabilities: string[];
 };
-export declare function warnGoogleSdkIgnoresProxy(providerLabel: string): void;
+/**
+ * `httpOptions` fragment that routes the @google/genai SDK through the
+ * configured proxy, or nothing when none is configured.
+ *
+ * The SDK calls global `fetch` unless `HttpOptions.fetch` is set (declared and
+ * used from 2.23.0), and global `fetch` does not read HTTP_PROXY / HTTPS_PROXY
+ * unless Node itself was started with env-proxy support. The proxy-aware fetch
+ * is passed only when a proxy is configured: with none, the SDK keeps its own
+ * request path instead of gaining this module's trace headers and retries.
+ *
+ * Covers the SDK's `generateContent`, `generateContentStream` and
+ * `embedContent` requests. It does not reach Gemini Live websockets or the
+ * Application Default Credentials token requests.
+ */
+export declare function googleSdkProxyHttpOptions(): GoogleGenAIHttpOptions;

package/dist/proxy/proxyFetch.js

@@ -698,31 +698,19 @@ export function getProxyStatus() {
     };
 }
 /**
- * One-time warning that the @google/genai SDK cannot honour a configured
- * proxy.
+ * `httpOptions` fragment that routes the @google/genai SDK through the
+ * configured proxy, or nothing when none is configured.
  *
- * Both Google providers passed `httpOptions: { fetch: createProxyFetch() }`,
- * which does nothing. `HttpOptions` in @google/genai 1.46.0 declares only
- * baseUrl, baseUrlResourceScope, apiVersion, headers, timeout, extraBody and
- * retryOptions — there is no `fetch` on it. That property belongs to a
- * different interface (`ClientOptions`), which `GoogleGenAIOptions` does not
- * accept, and the SDK's request path calls global `fetch`. The option was
- * silently dropped and requests went direct.
+ * The SDK calls global `fetch` unless `HttpOptions.fetch` is set (declared and
+ * used from 2.23.0), and global `fetch` does not read HTTP_PROXY / HTTPS_PROXY
+ * unless Node itself was started with env-proxy support. The proxy-aware fetch
+ * is passed only when a proxy is configured: with none, the SDK keeps its own
+ * request path instead of gaining this module's trace headers and retries.
  *
- * It type-checked only because those constructors are reached through a
- * loosely-typed local alias, which turns off excess-property checking.
- *
- * This SDK version offers no supported injection point, so rather than keep a
- * line that reads like working proxy support, the situation is reported once
- * per process — and only to someone who actually configured a proxy. Silent
- * bypass is the worst outcome available: a corporate user believes their
- * traffic is proxied when it is not.
+ * Covers the SDK's `generateContent`, `generateContentStream` and
+ * `embedContent` requests. It does not reach Gemini Live websockets or the
+ * Application Default Credentials token requests.
  */
-let proxyUnsupportedWarned = false;
-export function warnGoogleSdkIgnoresProxy(providerLabel) {
-    if (proxyUnsupportedWarned || !getProxyStatus().enabled) {
-        return;
-    }
-    proxyUnsupportedWarned = true;
-    logger.warn(`[${providerLabel}] A proxy is configured, but the @google/genai SDK provides no way to route its requests through it (HttpOptions has no 'fetch', and GoogleGenAIOptions accepts none). Requests from this provider go direct.`);
+export function googleSdkProxyHttpOptions() {
+    return getProxyStatus().enabled ? { fetch: createProxyFetch() } : {};
 }

package/docs-site/static/search-index.json

@@ -9687,8 +9687,8 @@
 {"objectID":"a5276d835ceba15da6ec36261ab78001e17f8b78ba9c8cb1c5e1282aa2f377e3","title":"Error-message fidelity","url":"/docs/provider-integration/openai-compat-catalog#error-message-fidelity","content":"Each entry's errorRules is a direct, order-preserving translation of its\noriginal subclass's formatProviderError if/else ladder into rule data\n(status code and/or case-insensitive pattern), classified via\nclassifyProviderError()\n(src/lib/utils/errorClassifier.ts). Every bespoke message string is\npreserved verbatim — including xAI's \"top up your account\" quota URL and\nGroq's decommissioned-vs-not-found distinction — via each rule's own\nmessage field (string | ((ctx) => string)), with model-name\ninterpolation carried through ctx.modelName. There is no message-wording\nregression here. Timeout classification is likewise unchanged: every catalog\nprovider except Groq maps TimeoutError to NetworkError (the classifier's\ndefault), and Groq alone maps it to ProviderError. Groq's subclass override is\npreserved verbatim via the JSON's quirks.timeoutErrorClass, so no\nprovider's timeout class changed during migration.","hierarchy":{"lvl0":"Provider Integration","lvl1":"OpenAI-Compatible Provider Catalog","lvl2":"Error-message fidelity","lvl3":""}},
 {"objectID":"2a22fddc1a2c383a5e75a53e2d512d764f01ad66ab03bfe6edf12acb5d204814","title":"Known pre-existing quirk this migration preserved (not fixed)","url":"/docs/provider-integration/openai-compat-catalog#known-pre-existing-quirk-this-migration-preserved-not-fixed","content":"Mistral's provider registration passes a defaultModel value to\nProviderFactory.registerProvider() that does not check MISTRAL_MODEL\n(MistralModels.MISTRAL_LARGE_LATEST, a bare literal), while\nConfiguredOpenAICompatProvider.getDefaultModel() for Mistral does\ncheck MISTRAL_MODEL (falling back to MistralModels.MISTRAL_SMALL_2506).\nEvery other catalog provider's registry default and class default agree.\nThis is expressed via the JSON's quirks.registryDefaultIgnoresModelEnvVar\n(true only for Mistral). The JSON migration did reconcile one half of it:\ngetDefaultModel(MISTRAL) now returns the real generation default\n(mistral-small-2506) rather than the registry literal — a disclosed\nbug-fix-grade delta, since the two disagreed before.","hierarchy":{"lvl0":"Provider Integration","lvl1":"OpenAI-Compatible Provider Catalog","lvl2":"Known pre-existing quirk this migration preserved (not fixed)","lvl3":""}},
 {"objectID":"1d94ab5116c71ed28e2428889216922df96e1d6d4d5fdc955ee65a4171c483e3","title":"What comes next","url":"/docs/provider-integration/openai-compat-catalog#what-comes-next","content":"The credential-free growth queue in docs/provider-integration/growth-queue.json lists every\nverified candidate vendor by wave (W1 = hosted OpenAI-compatible, the catalog path). Entries\nonboarded from it carry evidence.liveMatrix: null until a live run with a real key.","hierarchy":{"lvl0":"Provider Integration","lvl1":"OpenAI-Compatible Provider Catalog","lvl2":"What comes next","lvl3":""}},
-{"objectID":"bf3e1f8f1233a9b3d12aedbdbec4bf8cd196d18bf56b7bb104b34e31e90b61e0","title":"Provider Onboarding Tiers","url":"/docs/provider-integration/tiers/README","content":"Provider Onboarding Tiers\n\nFour tiers, ordered by effort. Always pick the lowest tier that's\nactually true for the provider you're adding — a provider that's\nOpenAI-wire-compatible but gets built as a bespoke Tier 3 subclass \"to be\nsafe\" is exactly the copy-pasted-boilerplate problem this redesign\nexists to eliminate (see ../adr/0002-catalog-over-subclass-default.md).\n\n| Tier                       | Example                                                                            | Code required                                                     | Time                              |\n| -------------------------- | ---------------------------------------------------------------------------------- | ----------------------------------------------------------------- | --------------------------------- |\n| 1 — Aggregator passthrough | A new model id on an existing LiteLLM/OpenRouter route                             | None                                                              | Minutes                           |\n| 2 — Catalog entry          | A new zero-quirk OpenAI-compatible vendor (the Groq/xAI/Together shape)            | One data row + one mocked-test section                            | ~1 hour                           |\n| 3 — Adapter-based native   | A vendor with its own SDK/wire format but a normal request/response HTTP lifecycle | One provider class                                                | Days                              |\n| 4 — Full custom            | SageMaker-class: non-HTTP protocol, SDK-signed auth, bespoke lifecycle             | Custom executeStream/doGenerate, possibly own CLI subcommands | Days, needs written justification |\n\nTier 1 adds zero provider coverage — it is a usage change against an\nalready-counted aggregator, never reflected in\ndocs/reference/provider-comparison.md or the README's provider count.\n\nEvery tier that adds a new AIProviderName member (Tier 2 and above) ends\nthe same way: a manifest at\ndocs/provider-integration/manifests/<provider>.json\n(see ../manifests/README.md) and a green run\nof pnpm run verify:provider-onboarding (see\n../../../tools/verify-provider-onboarding.ts).\nTier 1 needs no manifest and no gate — see\ntier-1-aggregator-passthrough.md.\n\nUse ../../../tools/scaffold-provider.ts\n(pnpm run scaffold:provider) to generate the starting-point snippets for\nTiers 2–4 instead of copy-pasting from an existing provider by hand. Both\ntools ship in the tree; there is no manual-fallback era anymore — a PR\nthat skips the gate locally just fails it in CI.","hierarchy":{"lvl0":"Provider Integration","lvl1":"Provider Onboarding Tiers","lvl2":"","lvl3":""}},
-{"objectID":"de01fcaf93bee302e2fca5e18f85cba5def099685383ec01b61d18489dbca5aa","title":"Provider Onboarding Tiers","url":"/docs/provider-integration/tiers/README#provider-onboarding-tiers","content":"Four tiers, ordered by effort. Always pick the lowest tier that's\nactually true for the provider you're adding — a provider that's\nOpenAI-wire-compatible but gets built as a bespoke Tier 3 subclass \"to be\nsafe\" is exactly the copy-pasted-boilerplate problem this redesign\nexists to eliminate (see ../adr/0002-catalog-over-subclass-default.md).\n\n| Tier                       | Example                                                                            | Code required                                                     | Time                              |\n| -------------------------- | ---------------------------------------------------------------------------------- | ----------------------------------------------------------------- | --------------------------------- |\n| 1 — Aggregator passthrough | A new model id on an existing LiteLLM/OpenRouter route                             | None                                                              | Minutes                           |\n| 2 — Catalog entry          | A new zero-quirk OpenAI-compatible vendor (the Groq/xAI/Together shape)            | One data row + one mocked-test section                            | ~1 hour                           |\n| 3 — Adapter-based native   | A vendor with its own SDK/wire format but a normal request/response HTTP lifecycle | One provider class                                                | Days                              |\n| 4 — Full custom            | SageMaker-class: non-HTTP protocol, SDK-signed auth, bespoke lifecycle             | Custom executeStream/doGenerate, possibly own CLI subcommands | Days, needs written justification |\n\nTier 1 adds zero provider coverage — it is a usage change against an\nalready-counted aggregator, never reflected in\ndocs/reference/provider-comparison.md or the README's provider count.","hierarchy":{"lvl0":"Provider Integration","lvl1":"Provider Onboarding Tiers","lvl2":"Provider Onboarding Tiers","lvl3":""}},
+{"objectID":"bf3e1f8f1233a9b3d12aedbdbec4bf8cd196d18bf56b7bb104b34e31e90b61e0","title":"Provider Onboarding Tiers","url":"/docs/provider-integration/tiers/README","content":"Provider Onboarding Tiers\n\nFour tiers, ordered by effort. Always pick the lowest tier that's\nactually true for the provider you're adding — a provider that's\nOpenAI-wire-compatible but gets built as a bespoke Tier 3 subclass \"to be\nsafe\" is exactly the copy-pasted-boilerplate problem this redesign\nexists to eliminate (see ../adr/0002-catalog-over-subclass-default.md).\n\nProvider Integration index\n\n| Tier                       | Example                                                                            | Code required                                                     | Time                              |\n| -------------------------- | ---------------------------------------------------------------------------------- | ----------------------------------------------------------------- | --------------------------------- |\n| 1 — Aggregator passthrough | A new model id on an existing LiteLLM/OpenRouter route                             | None                                                              | Minutes                           |\n| 2 — Catalog entry          | A new zero-quirk OpenAI-compatible vendor (the Groq/xAI/Together shape)            | One data row + one mocked-test section                            | ~1 hour                           |\n| 3 — Adapter-based native   | A vendor with its own SDK/wire format but a normal request/response HTTP lifecycle | One provider class                                                | Days                              |\n| 4 — Full custom            | SageMaker-class: non-HTTP protocol, SDK-signed auth, bespoke lifecycle             | Custom executeStream/doGenerate, possibly own CLI subcommands | Days, needs written justification |\n\nTier 1 adds zero provider coverage — it is a usage change against an\nalready-counted aggregator, never reflected in\ndocs/reference/provider-comparison.md or the README's provider count.\n\nEvery tier that adds a new AIProviderName member (Tier 2 and above) ends\nthe same way: a manifest at\ndocs/provider-integration/manifests/<provider>.json\n(see ../manifests/README.md) and a green run\nof pnpm run verify:provider-onboarding (see\n../../../tools/verify-provider-onboarding.ts).\nTier 1 needs no manifest and no gate — see\ntier-1-aggregator-passthrough.md.\n\nUse ../../../tools/scaffold-provider.ts\n(pnpm run scaffold:provider) to generate the starting-point snippets for\nTiers 2–4 instead of copy-pasting from an existing provider by hand. Both\ntools ship in the tree; there is no manual-fallback era anymore — a PR\nthat skips the gate locally just fails it in CI.","hierarchy":{"lvl0":"Provider Integration","lvl1":"Provider Onboarding Tiers","lvl2":"","lvl3":""}},
+{"objectID":"de01fcaf93bee302e2fca5e18f85cba5def099685383ec01b61d18489dbca5aa","title":"Provider Onboarding Tiers","url":"/docs/provider-integration/tiers/README#provider-onboarding-tiers","content":"Four tiers, ordered by effort. Always pick the lowest tier that's\nactually true for the provider you're adding — a provider that's\nOpenAI-wire-compatible but gets built as a bespoke Tier 3 subclass \"to be\nsafe\" is exactly the copy-pasted-boilerplate problem this redesign\nexists to eliminate (see ../adr/0002-catalog-over-subclass-default.md).\n\nProvider Integration index\n\n| Tier                       | Example                                                                            | Code required                                                     | Time                              |\n| -------------------------- | ---------------------------------------------------------------------------------- | ----------------------------------------------------------------- | --------------------------------- |\n| 1 — Aggregator passthrough | A new model id on an existing LiteLLM/OpenRouter route                             | None                                                              | Minutes                           |\n| 2 — Catalog entry          | A new zero-quirk OpenAI-compatible vendor (the Groq/xAI/Together shape)            | One data row + one mocked-test section                            | ~1 hour                           |\n| 3 — Adapter-based native   | A vendor with its own SDK/wire format but a normal request/response HTTP lifecycle | One provider class                                                | Days                              |\n| 4 — Full custom            | SageMaker-class: non-HTTP protocol, SDK-signed auth, bespoke lifecycle             | Custom executeStream/doGenerate, possibly own CLI subcommands | Days, needs written justification |\n\nTier 1 adds zero provider coverage — it is a usage change against an\nalready-counted aggregator, never reflected in\ndocs/reference/provider-comparison.md or the README's provider count.","hierarchy":{"lvl0":"Provider Integration","lvl1":"Provider Onboarding Tiers","lvl2":"Provider Onboarding Tiers","lvl3":""}},
 {"objectID":"a9753e41ed762a57c15471c49e70dc9917e8388eca055e3dc1c4ce90db6804bb","title":"Tier 1 — Aggregator Passthrough","url":"/docs/provider-integration/tiers/tier-1-aggregator-passthrough","content":"Tier 1 — Aggregator Passthrough\n\nWhen this applies: the model you want is already reachable through a\nprovider NeuroLink already registers as a pass-through aggregator —\ntoday that's litellm (any backend the user's LiteLLM proxy exposes) or\nopenrouter (any model in OpenRouter's catalog). No new\nAIProviderName member, no new provider class, no new catalog row.\n\nWhat you're actually doing: picking a model id string and confirming\nit works — this is a usage change, not an integration change.\n\nChecklist\n[ ] Confirm the aggregator actually serves the model. For LiteLLM,\n      check the proxy's /v1/models (or its config.yaml) for the\n      model's model_name. For OpenRouter, check\n      https://openrouter.ai/models for the exact vendor/model-id\n      slug.\n[ ] No AIProviderName enum change. No PROVIDER_DESCRIPTORS change.\n      No OPENAI_COMPAT_CATALOG change. If you find yourself editing any\n      of those three for a \"Tier 1\" provider, it isn't Tier 1 — restart\n      from ../tiers/README.md's decision tree.\n[ ] Optional: if the model needs a friendlier default alias, add it to\n      MODEL_ALIASES / DEFAULT_MODEL_ALIASES in\n      src/lib/models/modelRegistry.ts. Not required for the model to\n      work.\n[ ] Optional: if the model needs a documented env var (e.g., a\n      dedicated LiteLLM route), document it in\n      docs/getting-started/environment-variables.md.\n[ ] Manually smoke-test the model end-to-end.\n[ ] No manifest file is required — tools/verify-provider-onboarding.ts\n      (see ../../../tools/verify-provider-onboarding.ts) only gates\n      new AIProviderName members, and Tier 1 never adds one.\n[ ] Confirmed: no edit to docs/reference/provider-comparison.md or\n      README provider count for this change.\n\nVerification commands\n\nBoth should return a normal GenerateResult with non-empty content. If\neither 400s with an \"unknown model\" style error, the aggregator doesn't\nactually serve that model yet — fix the aggregator-side config, not\nNeuroLink.","hierarchy":{"lvl0":"Provider Integration","lvl1":"Tier 1 — Aggregator Passthrough","lvl2":"","lvl3":""}},
 {"objectID":"f04f6a19785cf4ff03d1ed0808f35ddbedb0508a51ca0590d1a57ff6703b40eb","title":"Tier 1 — Aggregator Passthrough","url":"/docs/provider-integration/tiers/tier-1-aggregator-passthrough#tier-1-aggregator-passthrough","content":"When this applies: the model you want is already reachable through a\nprovider NeuroLink already registers as a pass-through aggregator —\ntoday that's litellm (any backend the user's LiteLLM proxy exposes) or\nopenrouter (any model in OpenRouter's catalog). No new\nAIProviderName member, no new provider class, no new catalog row.\n\nWhat you're actually doing: picking a model id string and confirming\nit works — this is a usage change, not an integration change.","hierarchy":{"lvl0":"Provider Integration","lvl1":"Tier 1 — Aggregator Passthrough","lvl2":"Tier 1 — Aggregator Passthrough","lvl3":""}},
 {"objectID":"209d4e31f0601ea928a348869f63ad32c049e6624269f06d4fe795f15d30d311","title":"Checklist","url":"/docs/provider-integration/tiers/tier-1-aggregator-passthrough#checklist","content":"[ ] Confirm the aggregator actually serves the model. For LiteLLM,\n      check the proxy's /v1/models (or its config.yaml) for the\n      model's model_name. For OpenRouter, check\n      https://openrouter.ai/models for the exact vendor/model-id\n      slug.\n[ ] No AIProviderName enum change. No PROVIDER_DESCRIPTORS change.\n      No OPENAI_COMPAT_CATALOG change. If you find yourself editing any\n      of those three for a \"Tier 1\" provider, it isn't Tier 1 — restart\n      from ../tiers/README.md's decision tree.\n[ ] Optional: if the model needs a friendlier default alias, add it to\n      MODEL_ALIASES / DEFAULT_MODEL_ALIASES in\n      src/lib/models/modelRegistry.ts. Not required for the model to\n      work.\n[ ] Optional: if the model needs a documented env var (e.g., a\n      dedicated LiteLLM route), document it in\n      docs/getting-started/environment-variables.md.\n[ ] Manually smoke-test the model end-to-end.\n[ ] No manifest file is required — tools/verify-provider-onboarding.ts\n      (see ../../../tools/verify-provider-onboarding.ts) only gates\n      new AIProviderName members, and Tier 1 never adds one.\n[ ] Confirmed: no edit to docs/reference/provider-comparison.md or\n      README provider count for this change.","hierarchy":{"lvl0":"Provider Integration","lvl1":"Tier 1 — Aggregator Passthrough","lvl2":"Checklist","lvl3":""}},

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@juspay/neurolink",
-  "version": "12.47.0",
+  "version": "12.47.2",
   "packageManager": "pnpm@10.15.1",
   "description": "The pipe layer of an AI nervous system: one interface connecting provider neurons to your application, across three inference types — generate, stream and decide. `decide` returns typed, calibrated judgements from a non-generative model (~400ms, ~$0.00002/call) for routing, tool selection and context budgeting. MCP-native (4 transports), voice TTS/STT/realtime, RAG, agents, memory, compaction, 9 observability exporters. OpenAI · Anthropic · Gemini · Bedrock · Azure · Ollama · TypeSafe Jev and more.",
   "author": {
@@ -280,6 +280,8 @@
     "test:anthropic-loop-characterization": "tsx test/continuous-test-suite-anthropic-loop-characterization.ts",
     "test:anthropic-execution-control": "tsx test/continuous-test-suite-anthropic-execution-control.ts",
     "test:aistudio-loop-characterization": "tsx test/continuous-test-suite-aistudio-loop-characterization.ts",
+    "test:google-genai-proxy": "tsx test/continuous-test-suite-google-genai-proxy.ts",
+    "test:google-genai-sdk": "tsx test/continuous-test-suite-google-genai-sdk.ts",
     "test:docs-mcp": "pnpm exec tsx test/continuous-test-suite-docs-mcp.ts",
     "test:docs-search-index": "pnpm exec tsx test/continuous-test-suite-docs-search-index.ts",
     "test:docs-snippets": "pnpm exec tsx test/continuous-test-suite-docs-snippets.ts",
@@ -430,7 +432,7 @@
     "@anthropic-ai/vertex-sdk": "^0.16.0",
     "@aws-sdk/types": "^3.862.0",
     "@cfworker/json-schema": "^4.1.1",
-    "@google/genai": "^1.43.0",
+    "@google/genai": "^2.23.0",
     "@modelcontextprotocol/sdk": "^1.27.1",
     "@opentelemetry/api-logs": "^0.214.0",
     "@opentelemetry/context-async-hooks": "^2.6.1",