@juspay/neurolink 12.2.6 → 12.4.0

package/dist/models/manifests/sambanova.js

@@ -0,0 +1,42 @@
+/**
+ * Context windows from the vendor's SambaCloud model specifications page
+ * (docs.sambanova.ai, checked 2026-08-27): 128K on the production mainline
+ * (Meta-Llama-3.3-70B-Instruct, gpt-oss-120b, DeepSeek-V3.1), 192K on
+ * MiniMax-M2.7, 32K on the DeepSeek-V3.2 preview. Max output is not
+ * published — the 8192 floor stays deliberately conservative, same
+ * pattern as groq.ts/cerebras.ts. gemma-4-31B-it is the one vision model
+ * (text+image+video per the vendor page).
+ */
+export const sambanovaManifest = {
+    defaultContextWindow: 131072,
+    models: {
+        _default: {
+            aliases: [],
+            contextWindow: 131072,
+            maxOutputTokens: 8192,
+            vision: false,
+            functionCalling: true,
+        },
+        "MiniMax-M2.7": {
+            aliases: [],
+            contextWindow: 196608,
+            maxOutputTokens: 8192,
+            vision: false,
+            functionCalling: true,
+        },
+        "DeepSeek-V3.2": {
+            aliases: [],
+            contextWindow: 32768,
+            maxOutputTokens: 8192,
+            vision: false,
+            functionCalling: true,
+        },
+        "gemma-4-31B-it": {
+            aliases: [],
+            contextWindow: 131072,
+            maxOutputTokens: 8192,
+            vision: true,
+            functionCalling: true,
+        },
+    },
+};

package/dist/providers/openaiChatCompletionsClient.d.ts

@@ -42,7 +42,7 @@ export declare const estimateWireTokens: (messages: ReadonlyArray<OpenAICompatCh
 export declare const safeStringify: (value: unknown) => string;
 export declare const stringifyToolInput: (input: unknown) => string;
 export declare const stringifyToolOutput: (output: unknown) => string;
-export declare const imageDataToURL: (data: unknown) => string | undefined;
+export declare const imageDataToURL: (data: unknown, mediaType?: string) => string | undefined;
 export declare const convertContentForOpenAI: (content: unknown) => string | OpenAICompatMessageContent[];
 export declare const messageBuilderToOpenAI: (messages: ReadonlyArray<OpenAICompatMessage>, toolNameToWire?: Map<string, string>) => OpenAICompatChatMessage[];
 export declare const buildToolsForOpenAI: (tools: Record<string, Tool>, toolNameToWire?: Map<string, string>) => OpenAICompatChatTool[] | undefined;

package/dist/providers/openaiChatCompletionsClient.js

@@ -150,18 +150,19 @@ export const stringifyToolOutput = (output) => {
             return safeStringify(output);
     }
 };
-export const imageDataToURL = (data) => {
+export const imageDataToURL = (data, mediaType) => {
+    const mime = mediaType && mediaType.includes("/") ? mediaType : "image/png";
     if (typeof data === "string") {
         if (data.startsWith("data:") || /^https?:\/\//i.test(data)) {
             return data;
         }
-        return `data:image/png;base64,${data}`;
+        return `data:${mime};base64,${data}`;
     }
     if (data instanceof URL) {
         return data.toString();
     }
     if (data instanceof Uint8Array) {
-        return `data:image/png;base64,${Buffer.from(data).toString("base64")}`;
+        return `data:${mime};base64,${Buffer.from(data).toString("base64")}`;
     }
     return undefined;
 };
@@ -197,6 +198,22 @@ export const convertContentForOpenAI = (content) => {
                 out.push({ type: "image_url", image_url: { url } });
             }
         }
+        else if (p.type === "file") {
+            // ai@6 delivers images as FILE parts ({type:"file", mediaType, data}),
+            // not "image" parts. The hand-rolled client that replaced
+            // @ai-sdk/openai-compatible only handled "image"/"image_url", so every
+            // image reaching a catalog provider was silently dropped — the wire
+            // carried a text-only message (found live on sambanova/gemma-4-31B-it,
+            // 2026-08-28; affected xai vision too). Non-image file parts are still
+            // skipped: the OpenAI chat wire format has no generic file slot.
+            const fp = part;
+            if (fp.mediaType?.startsWith("image/")) {
+                const url = imageDataToURL(fp.data, fp.mediaType);
+                if (url) {
+                    out.push({ type: "image_url", image_url: { url } });
+                }
+            }
+        }
     }
     if (out.length === 1 && out[0].type === "text") {
         return out[0].text;

package/dist/providers/openaiCompatCatalog.d.ts

@@ -1,6 +1,6 @@
 import type { OpenAICompatCatalogEntry } from "../types/index.js";
 /**
- * Config-driven catalog of the 8 zero-quirk OpenAI-compatible providers.
+ * Config-driven catalog of the 9 zero-quirk OpenAI-compatible providers.
  * Each entry fully replaces what used to be a hand-written
  * OpenAIChatCompletionsProvider subclass — see ConfiguredOpenAICompatProvider
  * for the class that reads these entries, and providerRegistry.ts for the

package/dist/providers/openaiCompatCatalog.js

@@ -1,13 +1,13 @@
 import { AIProviderName } from "../constants/enums.js";
-import { CerebrasModels, CloudflareModels, FireworksModels, GroqModels, MistralModels, PerplexityModels, TogetherAIModels, XaiModels, } from "../constants/enums.js";
+import { CerebrasModels, SambanovaModels, CloudflareModels, FireworksModels, GroqModels, MistralModels, PerplexityModels, TogetherAIModels, XaiModels, } from "../constants/enums.js";
 import { AuthenticationError, InvalidModelError, ProviderError, } from "../types/index.js";
 import { DEFAULT_ERROR_RULES } from "../utils/errorClassifier.js";
-import { createCerebrasConfig, createCloudflareConfig, createFireworksConfig, createGroqConfig, createMistralConfig, createPerplexityConfig, createTogetherAIConfig, createXaiConfig, } from "../utils/providerConfig.js";
+import { createCerebrasConfig, createSambanovaConfig, createCloudflareConfig, createFireworksConfig, createGroqConfig, createMistralConfig, createPerplexityConfig, createTogetherAIConfig, createXaiConfig, } from "../utils/providerConfig.js";
 function buildCloudflareBaseURL(accountId) {
     return `https://api.cloudflare.com/client/v4/accounts/${accountId}/ai/v1`;
 }
 /**
- * Config-driven catalog of the 8 zero-quirk OpenAI-compatible providers.
+ * Config-driven catalog of the 9 zero-quirk OpenAI-compatible providers.
  * Each entry fully replaces what used to be a hand-written
  * OpenAIChatCompletionsProvider subclass — see ConfiguredOpenAICompatProvider
  * for the class that reads these entries, and providerRegistry.ts for the
@@ -29,6 +29,46 @@ function buildCloudflareBaseURL(accountId) {
  * Task 14's docs task for the deciding criteria).
  */
 export const OPENAI_COMPAT_CATALOG = [
+    {
+        providerName: AIProviderName.SAMBANOVA,
+        aliases: ["sambanova"],
+        apiKeyEnvVar: "SAMBANOVA_API_KEY",
+        baseURLEnvVar: "SAMBANOVA_BASE_URL",
+        defaultBaseURL: "https://api.sambanova.ai/v1",
+        configOptions: createSambanovaConfig(),
+        modelEnvVar: "SAMBANOVA_MODEL",
+        defaultModel: SambanovaModels.META_LLAMA_3_3_70B_INSTRUCT,
+        registryDefaultModel: SambanovaModels.META_LLAMA_3_3_70B_INSTRUCT,
+        registryDefaultModelChecksEnvVar: true,
+        fallbackModelName: SambanovaModels.GPT_OSS_120B,
+        fallbackModels: [
+            SambanovaModels.META_LLAMA_3_3_70B_INSTRUCT,
+            SambanovaModels.GPT_OSS_120B,
+        ],
+        errorRules: [
+            {
+                // Probed live 2026-08-27: a bad key gets HTTP 401 with an
+                // OpenAI-shaped body {"error":{"message":"Incorrect API key
+                // provided: ...","type":"authentication_error","code":
+                // "invalid_api_key"}}.
+                match: (ctx) => ctx.statusCode === 401 ||
+                    /invalid_api_key|Incorrect API key|authentication_error/i.test(ctx.message),
+                errorClass: AuthenticationError,
+                message: "Invalid SambaNova API key. Check SAMBANOVA_API_KEY. Get one at https://cloud.sambanova.ai/apis",
+            },
+            {
+                // Probed live 2026-08-27: a zero-balance account gets HTTP 402 with
+                // {"error":{"balance_units":0,"code":"PAYMENT_METHOD_REQUIRED",
+                //  "billing_portal_url":"https://cloud.sambanova.ai/plans/billing"}}.
+                // New accounts have NO free allowance — credits must be purchased.
+                match: (ctx) => ctx.statusCode === 402 ||
+                    /PAYMENT_METHOD_REQUIRED|balance_units/i.test(ctx.message),
+                errorClass: ProviderError,
+                message: "SambaNova account has no credits (new accounts have no free allowance). Add a payment method and purchase credits at https://cloud.sambanova.ai/plans/billing",
+            },
+            ...DEFAULT_ERROR_RULES,
+        ],
+    },
     {
         providerName: AIProviderName.CEREBRAS,
         aliases: ["cerebras"],

package/dist/proxy/proxyTranslationEngine.js

@@ -14,6 +14,7 @@
 import { ClaudeStreamSerializer, generateToolUseId, serializeClaudeResponse, } from "./claudeFormat.js";
 import { buildGeminiResponse, createGeminiSerializerAdapter, } from "./geminiFormat.js";
 import { generateOpenAIToolCallId, OpenAIStreamSerializer, serializeOpenAIResponse, } from "./openaiFormat.js";
+import { DEFAULT_PROXY_MODEL_IDS } from "../constants/proxyModels.js";
 import { logRequest } from "./requestLogger.js";
 import { recordAttempt, recordAttemptError, recordFinalError, recordFinalSuccess, } from "./usageStats.js";
 import { ErrorCategory, ErrorSeverity } from "../constants/enums.js";
@@ -677,7 +678,7 @@ export function buildModelsListResponse(modelRouter) {
     }
     // Always include a default entry if nothing else is configured
     if (models.length === 0) {
-        for (const id of DEFAULT_MODEL_IDS) {
+        for (const id of DEFAULT_PROXY_MODEL_IDS) {
             models.push({
                 id,
                 object: "model",
@@ -691,26 +692,6 @@ export function buildModelsListResponse(modelRouter) {
         data: models,
     };
 }
-/**
- * Canonical default model IDs surfaced when no router is configured. Format
- * matches the IDs used throughout `src/lib/models/` and `src/lib/constants/`
- * (e.g. `claude-3-5-haiku-20241022`, not `claude-haiku-3.5-20241022`).
- */
-const DEFAULT_MODEL_IDS = [
-    // Claude 4-series (current generation, hyphen-suffix family)
-    "claude-opus-4-6",
-    "claude-sonnet-4-6",
-    "claude-haiku-4-5",
-    // Claude 4 dated variant
-    "claude-sonnet-4-20250514",
-    // Claude 3.5-series (canonical Anthropic form: claude-3-5-{variant}-{date})
-    "claude-3-5-sonnet-20241022",
-    "claude-3-5-haiku-20241022",
-    // OpenAI / Google for translated-fallback users
-    "gpt-4o",
-    "gemini-2.5-pro",
-    "gemini-2.5-flash",
-];
 /**
  * Build an Anthropic-shaped `/v1/models` list response.
  *
@@ -736,7 +717,7 @@ export function buildAnthropicModelsListResponse(modelRouter) {
         }
     }
     if (ids.length === 0) {
-        ids.push(...DEFAULT_MODEL_IDS);
+        ids.push(...DEFAULT_PROXY_MODEL_IDS);
     }
     // Deduplicate while preserving order — multiple router sources can publish
     // the same id (e.g. both an explicit mapping and a passthrough entry).

package/dist/types/providers.d.ts

@@ -182,6 +182,10 @@ export type NeurolinkCredentials = {
         apiKey?: string;
         baseURL?: string;
     };
+    sambanova?: {
+        apiKey?: string;
+        baseURL?: string;
+    };
     cohere?: {
         apiKey?: string;
         baseURL?: string;

package/dist/types/proxyClient.d.ts

@@ -47,6 +47,39 @@ export type CliProxyClientRestoreResult = {
     restored: boolean;
     error?: Error;
 };
+/**
+ * Snapshot of the user's pre-existing OpenCode `provider.neurolink`.
+ *
+ * Persisted to `~/.neurolink/opencode-proxy-snapshot.json`, never inside
+ * `opencode.json` — OpenCode validates against a closed schema and rejects
+ * unknown top-level keys, so an in-file snapshot made the CLI unstartable.
+ */
+export type CliOpenCodeSnapshot = {
+    /** The user's provider.neurolink before the proxy first touched it. */
+    original: unknown;
+    /** What the writer last wrote, so apply() can recognise its own block. */
+    written?: unknown;
+};
+/**
+ * Snapshot of the user's pre-existing Gemini CLI `~/.gemini/.env`.
+ *
+ * The whole file is kept rather than the managed keys alone: restoring must
+ * reproduce the user's comments, ordering and unrelated variables exactly.
+ */
+export type CliGeminiSnapshot = {
+    /** The whole prior `.env`, or null when the user had no such file. */
+    originalEnv: string | null;
+    /**
+     * What the writer last wrote for each managed variable. Compared against the
+     * file on disk to detect a snapshot that has gone stale — one left behind by
+     * a restore whose cleanup failed, or overtaken by a user edit. Reusing such a
+     * record would make the next restore replay outdated values.
+     */
+    written?: {
+        baseUrl: string;
+        apiKey: string;
+    };
+};
 /**
  * Raw contents of a Qwen Code `settings.json`. Deliberately open-ended: the
  * configurator rewrites only `security.auth` and must round-trip every other

package/dist/utils/modelChoices.js

@@ -2,7 +2,7 @@
  * Centralized model choices for CLI commands
  * Derives choices from model enums to ensure consistency
  */
-import { AIProviderName, OpenAIModels, AnthropicModels, GoogleAIModels, BedrockModels, VertexModels, MistralModels, OllamaModels, AzureOpenAIModels, LiteLLMModels, HuggingFaceModels, SageMakerModels, OpenRouterModels, DeepSeekModels, NvidiaNimModels, XaiModels, GroqModels, CerebrasModels, CohereModels, TogetherAIModels, FireworksModels, PerplexityModels, CloudflareModels, VoyageModels, JinaModels, StabilityModels, IdeogramModels, RecraftModels, ReplicateModels, } from "../constants/enums.js";
+import { AIProviderName, OpenAIModels, AnthropicModels, GoogleAIModels, BedrockModels, VertexModels, MistralModels, OllamaModels, AzureOpenAIModels, LiteLLMModels, HuggingFaceModels, SageMakerModels, OpenRouterModels, DeepSeekModels, NvidiaNimModels, XaiModels, GroqModels, CerebrasModels, SambanovaModels, CohereModels, TogetherAIModels, FireworksModels, PerplexityModels, CloudflareModels, VoyageModels, JinaModels, StabilityModels, IdeogramModels, RecraftModels, ReplicateModels, } from "../constants/enums.js";
 /**
  * Top models per provider with descriptions for CLI prompts
  * These are curated lists of the most commonly used/recommended models
@@ -302,6 +302,33 @@ const TOP_MODELS_CONFIG = {
             description: "Mistral 8x7B MoE, 32K context",
         },
     ],
+    [AIProviderName.SAMBANOVA]: [
+        {
+            model: SambanovaModels.META_LLAMA_3_3_70B_INSTRUCT,
+            description: "Recommended - Meta Llama 3.3 70B; production, 128K context",
+        },
+        {
+            model: SambanovaModels.GPT_OSS_120B,
+            description: "OpenAI GPT-OSS 120B (open-weight)",
+        },
+        {
+            model: SambanovaModels.DEEPSEEK_V3_1,
+            description: "DeepSeek V3.1 (reasoning)",
+        },
+        {
+            model: SambanovaModels.DEEPSEEK_V3_2,
+            description: "DeepSeek V3.2 (reasoning; vendor preview, 32K context)",
+        },
+        {
+            model: SambanovaModels.MINIMAX_M2_7,
+            description: "MiniMax M2.7, 192K context",
+        },
+        { model: SambanovaModels.MINIMAX_M3, description: "MiniMax M3 (vision)" },
+        {
+            model: SambanovaModels.GEMMA_4_31B_IT,
+            description: "Google Gemma 4 31B IT (vision; vendor preview)",
+        },
+    ],
     [AIProviderName.CEREBRAS]: [
         {
             model: CerebrasModels.GPT_OSS_120B,
@@ -550,6 +577,7 @@ const MODEL_ENUMS = {
     [AIProviderName.XAI]: XaiModels,
     [AIProviderName.GROQ]: GroqModels,
     [AIProviderName.CEREBRAS]: CerebrasModels,
+    [AIProviderName.SAMBANOVA]: SambanovaModels,
     [AIProviderName.COHERE]: CohereModels,
     [AIProviderName.TOGETHER_AI]: TogetherAIModels,
     [AIProviderName.FIREWORKS]: FireworksModels,

package/dist/utils/pricing.js

@@ -527,6 +527,21 @@ const PRICING = {
         "gpt-oss-120b": { input: 0.35 / 1_000_000, output: 0.75 / 1_000_000 },
         "gemma-4-31b": { input: 0.99 / 1_000_000, output: 1.49 / 1_000_000 },
     },
+    // cloud.sambanova.ai/plans/pricing, checked 2026-08-27. MiniMax-M2.7
+    // also has a $0.06/M cached-input rate the flat model here can't express.
+    sambanova: {
+        _default: { input: 0.6 / 1_000_000, output: 1.2 / 1_000_000 },
+        "Meta-Llama-3.3-70B-Instruct": {
+            input: 0.6 / 1_000_000,
+            output: 1.2 / 1_000_000,
+        },
+        "gpt-oss-120b": { input: 0.22 / 1_000_000, output: 0.59 / 1_000_000 },
+        "DeepSeek-V3.1": { input: 3.0 / 1_000_000, output: 4.5 / 1_000_000 },
+        "DeepSeek-V3.2": { input: 3.0 / 1_000_000, output: 4.5 / 1_000_000 },
+        "MiniMax-M2.7": { input: 0.6 / 1_000_000, output: 2.4 / 1_000_000 },
+        "MiniMax-M3": { input: 0.6 / 1_000_000, output: 2.4 / 1_000_000 },
+        "gemma-4-31B-it": { input: 0.38 / 1_000_000, output: 1.15 / 1_000_000 },
+    },
     cohere: {
         _default: { input: 2.5 / 1_000_000, output: 10.0 / 1_000_000 },
         "command-r-plus": { input: 2.5 / 1_000_000, output: 10.0 / 1_000_000 },
@@ -695,6 +710,7 @@ const PROVIDER_ALIASES = {
     grok: "xai",
     groq: "groq",
     cerebras: "cerebras",
+    sambanova: "sambanova",
     cohere: "cohere",
     togetherai: "together-ai",
     together: "together-ai",

package/dist/utils/providerConfig.d.ts

@@ -138,6 +138,7 @@ export declare function createXaiConfig(): ProviderConfigOptions;
 /**
  * Creates Cerebras provider configuration.
  */
+export declare function createSambanovaConfig(): ProviderConfigOptions;
 export declare function createCerebrasConfig(): ProviderConfigOptions;
 /**
  * Creates Groq provider configuration.

package/dist/utils/providerConfig.js

@@ -454,6 +454,20 @@ export function createXaiConfig() {
 /**
  * Creates Cerebras provider configuration.
  */
+export function createSambanovaConfig() {
+    return {
+        providerName: "SambaNova",
+        envVarName: "SAMBANOVA_API_KEY",
+        setupUrl: "https://cloud.sambanova.ai/apis",
+        description: "API key",
+        instructions: [
+            "1. Visit: https://cloud.sambanova.ai (Google/Microsoft OAuth works)",
+            "2. Complete the profile step; note new accounts have NO free allowance — a payment method and purchased credits are required before calls succeed",
+            "3. Create an API key under API Keys",
+            "4. Set SAMBANOVA_API_KEY in your .env file",
+        ],
+    };
+}
 export function createCerebrasConfig() {
     return {
         providerName: "Cerebras",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@juspay/neurolink",
-  "version": "12.2.6",
+  "version": "12.4.0",
   "packageManager": "pnpm@10.15.1",
   "description": "TypeScript AI SDK with 24+ LLM providers behind one consistent API. MCP-native (connect any MCP server), voice TTS/STT/realtime, RAG, agents, memory, context compaction. OpenAI · Anthropic · Gemini · Bedrock · Azure · Ollama · DeepSeek · NVIDIA NIM and more.",
   "author": {