@juspay/neurolink 11.2.1 → 11.2.3

package/dist/providers/openaiCompatCatalog.js

@@ -49,17 +49,15 @@ export const OPENAI_COMPAT_CATALOG = [
             GroqModels.LLAMA_3_2_90B_VISION_PREVIEW,
             GroqModels.LLAMA_3_2_11B_VISION_PREVIEW,
         ],
-        // KNOWN GAP (not reproducible by this data-only array — flagged for PR C,
-        // see plan-05/task-A-report.md): live GroqProvider.formatProviderError()
-        // intercepts TimeoutError and returns a plain ProviderError BEFORE ever
-        // calling classifyProviderError, overriding that function's own
-        // (non-overridable) rule that TimeoutError always maps to NetworkError.
-        // ConfiguredOpenAICompatProvider.formatProviderError() has no such
-        // pre-check hook, so migrating Groq onto it as-is would silently
-        // reclassify Groq timeouts as NetworkError. This entry's errorRules
-        // still mirrors Groq's live rule array faithfully for every other error
-        // shape; the TimeoutError special case is a structural gap in
-        // ConfiguredOpenAICompatProvider, not a data error here.
+        // Groq's pre-migration subclass intercepted TimeoutError itself and
+        // returned a plain ProviderError, ahead of classifyProviderError's own
+        // non-overridable TimeoutError -> NetworkError default. Expressed here
+        // as data — see OpenAICompatCatalogEntry.timeoutErrorClass and
+        // ConfiguredOpenAICompatProvider.formatProviderError, which consults
+        // this field before ever delegating to the shared classifier. No other
+        // entry in this catalog sets it, so every other provider still gets
+        // the classifier's unmodified default.
+        timeoutErrorClass: ProviderError,
         errorRules: [
             {
                 match: (ctx) => ctx.statusCode === 401 ||

package/dist/types/providers.d.ts

@@ -8,7 +8,7 @@ import type { ValidationSchema } from "./aliases.js";
 import type { EnhancedGenerateResult, GenerateResult, TextGenerationOptions } from "./generate.js";
 import type { MultimodalAudioEntry } from "./file.js";
 import type { StreamOptions, StreamResult } from "./stream.js";
-import type { ProviderErrorRule } from "./errors.js";
+import type { ProviderError, ProviderErrorRule } from "./errors.js";
 import type { ExternalMCPToolInfo } from "./externalMcp.js";
 import type { ClaudeSubscriptionTier, AnthropicAuthMethod, AnthropicAuthConfig, SubscriptionInfo, OAuthToken } from "./subscription.js";
 import type { Tool } from "./tools.js";
@@ -671,6 +671,20 @@ export type OpenAICompatCatalogEntry = {
      * Task 4, so nothing actually mutates it at runtime.
      */
     errorRules: ProviderErrorRule[];
+    /**
+     * Optional override for the Error subclass a TimeoutError should produce
+     * for this entry. classifyProviderError() hard-codes
+     * TimeoutError -> NetworkError unconditionally, ahead of any rule table,
+     * and does not make that mapping overridable per-provider (see
+     * errorClassifier.ts). Groq's pre-migration subclass predates that
+     * shared classifier and intercepted TimeoutError itself, returning a
+     * plain ProviderError instead — this field lets
+     * ConfiguredOpenAICompatProvider reproduce that one documented
+     * divergence as data (see its formatProviderError), rather than adding a
+     * class-level hook back in. Omit for every entry whose timeout should use
+     * the classifier's default (six of the seven catalog entries).
+     */
+    timeoutErrorClass?: new (message: string, provider?: string) => ProviderError;
 };
 /** The subset of OpenAICompatCatalogEntry that resolveOpenAICompatConfig()
  *  needs — lets call sites pass a minimal object without the full catalog

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@juspay/neurolink",
-  "version": "11.2.1",
+  "version": "11.2.3",
   "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": {
@@ -82,6 +82,7 @@
     "test:memory": "npx tsx test/continuous-test-suite-memory.ts",
     "test:openai-compat-streaming-retry": "npx tsx test/continuous-test-suite-openai-compat-streaming-retry.ts",
     "test:anthropic-streaming-retry": "npx tsx test/continuous-test-suite-anthropic-streaming-retry.ts",
+    "test:adjust-body-after-400": "npx tsx test/continuous-test-suite-adjust-body-after-400.ts",
     "test:error-classification-e2e": "npx tsx test/continuous-test-suite-error-classification-e2e.ts",
     "test:error-classifier-contract": "npx tsx test/continuous-test-suite-error-classifier-contract.ts",
     "test:middleware": "npx tsx test/continuous-test-suite-middleware.ts",
@@ -124,7 +125,7 @@
     "test:tool-dedup": "npx tsx test/continuous-test-suite-tool-dedup.ts",
     "test:model-not-found-retryable": "npx tsx test/continuous-test-suite-model-not-found-retryable.ts",
     "test:ci": "pnpm run test && pnpm run test:client && pnpm run test:hitl",
-    "// CI tier — fast, no live AI calls, safe for every commit (test:unit; also see the separate provider-safety-net CI job, which runs build + test:providers-mocked + test:provider-structure on every PR)": "",
+    "// CI tier — fast, no live AI calls, safe for every commit (test:unit; also see the separate provider-safety-net CI job, which runs build + test:providers-mocked + test:provider-structure + test:error-classifier-contract on every PR)": "",
     "test:tool-routing": "npx tsx test/continuous-test-suite-tool-routing.ts",
     "test:tool-routing-semantic": "npx tsx test/continuous-test-suite-tool-routing-semantic.ts",
     "test:unit": "pnpm run test:bugfixes && pnpm run test:mcp:infra && pnpm run test:mcp:spans && pnpm run test:tool-routing && pnpm run test:tool-routing-cli && pnpm run test:tool-dedup && pnpm run test:model-pool && pnpm run test:tool-routing-semantic && pnpm run test:mcp-result-cache && pnpm run test:model-not-found-retryable && pnpm run test:archive:security && pnpm run test:office:security && pnpm run test:vector-chroma && pnpm run test:vector-pgvector && pnpm run test:vector-pinecone && pnpm run test:provider-wiring",

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

@@ -1,26 +0,0 @@
-import type { AIProviderName } from "../constants/enums.js";
-import type { NeurolinkCredentials } from "../types/index.js";
-import { OpenAIChatCompletionsProvider } from "./openaiChatCompletionsBase.js";
-/**
- * Cloudflare Workers AI Provider — direct HTTP, no AI SDK.
- *
- * Edge-served open models (Llama / Mistral / Qwen / Gemma) at
- * `https://api.cloudflare.com/client/v4/accounts/{accountId}/ai/v1`
- * (OpenAI-compatible). Cheapest tier for high-volume usage.
- *
- * Required env: `CLOUDFLARE_API_KEY` + `CLOUDFLARE_ACCOUNT_ID`.
- *
- * All request/stream/tool-loop orchestration lives in
- * `OpenAIChatCompletionsProvider`; this class only declares configuration
- * and provider-specific error mapping.
- *
- * @see https://developers.cloudflare.com/workers-ai/configuration/open-ai-compatibility/
- */
-export declare class CloudflareProvider extends OpenAIChatCompletionsProvider {
-    constructor(modelName?: string, sdk?: unknown, _region?: string, credentials?: NeurolinkCredentials["cloudflare"]);
-    protected getProviderName(): AIProviderName;
-    protected getDefaultModel(): string;
-    protected getFallbackModelName(): string;
-    protected getFallbackModels(): string[];
-    protected formatProviderError(error: unknown): Error;
-}

package/dist/lib/providers/cloudflare.js

@@ -1,83 +0,0 @@
-import { CloudflareModels } from "../constants/enums.js";
-import { AuthenticationError } from "../types/index.js";
-import { logger } from "../utils/logger.js";
-import { redactUrlCredentials } from "../utils/logSanitize.js";
-import { classifyProviderError, DEFAULT_ERROR_RULES, } from "../utils/errorClassifier.js";
-import { createCloudflareConfig, getProviderModel, validateApiKey, } from "../utils/providerConfig.js";
-import { OpenAIChatCompletionsProvider } from "./openaiChatCompletionsBase.js";
-/**
- * Cloudflare Workers AI exposes an OpenAI-compatible endpoint scoped per
- * account: `https://api.cloudflare.com/client/v4/accounts/{ACCOUNT_ID}/ai/v1`.
- * The account id is required — without it the URL would 404.
- */
-const buildCloudflareBaseURL = (accountId) => `https://api.cloudflare.com/client/v4/accounts/${accountId}/ai/v1`;
-const getCloudflareApiKey = () => validateApiKey(createCloudflareConfig());
-const getDefaultCloudflareModel = () => getProviderModel("CLOUDFLARE_MODEL", CloudflareModels.LLAMA_3_3_70B_FAST);
-/**
- * Cloudflare Workers AI Provider — direct HTTP, no AI SDK.
- *
- * Edge-served open models (Llama / Mistral / Qwen / Gemma) at
- * `https://api.cloudflare.com/client/v4/accounts/{accountId}/ai/v1`
- * (OpenAI-compatible). Cheapest tier for high-volume usage.
- *
- * Required env: `CLOUDFLARE_API_KEY` + `CLOUDFLARE_ACCOUNT_ID`.
- *
- * All request/stream/tool-loop orchestration lives in
- * `OpenAIChatCompletionsProvider`; this class only declares configuration
- * and provider-specific error mapping.
- *
- * @see https://developers.cloudflare.com/workers-ai/configuration/open-ai-compatibility/
- */
-export class CloudflareProvider extends OpenAIChatCompletionsProvider {
-    constructor(modelName, sdk, _region, credentials) {
-        const overrideApiKey = credentials?.apiKey?.trim();
-        const apiKey = overrideApiKey && overrideApiKey.length > 0
-            ? overrideApiKey
-            : getCloudflareApiKey();
-        const accountId = (credentials?.accountId ??
-            process.env.CLOUDFLARE_ACCOUNT_ID ??
-            "").trim();
-        if (!accountId) {
-            throw new Error("CLOUDFLARE_ACCOUNT_ID is required (or pass credentials.cloudflare.accountId). Get the account id from https://dash.cloudflare.com/");
-        }
-        const baseURL = credentials?.baseURL ?? buildCloudflareBaseURL(accountId);
-        super("cloudflare", modelName, sdk, { baseURL, apiKey });
-        logger.debug("Cloudflare Workers AI Provider initialized", {
-            modelName: this.modelName,
-            providerName: this.providerName,
-            baseURL: redactUrlCredentials(this.config.baseURL),
-        });
-    }
-    getProviderName() {
-        return "cloudflare";
-    }
-    getDefaultModel() {
-        return getDefaultCloudflareModel();
-    }
-    getFallbackModelName() {
-        return CloudflareModels.LLAMA_3_1_8B_FAST;
-    }
-    getFallbackModels() {
-        return [
-            CloudflareModels.LLAMA_3_3_70B_FAST,
-            CloudflareModels.LLAMA_3_1_70B_INSTRUCT,
-            CloudflareModels.LLAMA_3_1_8B_FAST,
-            CloudflareModels.LLAMA_3_2_11B_VISION,
-            CloudflareModels.MISTRAL_7B_INSTRUCT_V0_2,
-            CloudflareModels.QWEN_1P5_14B_CHAT_AWQ,
-        ];
-    }
-    formatProviderError(error) {
-        const rules = [
-            {
-                match: (ctx) => ctx.statusCode === 401 ||
-                    /Invalid API key|Authentication/i.test(ctx.message),
-                errorClass: AuthenticationError,
-                message: "Invalid Cloudflare API key. Use a token with Workers AI Read+Write scope. Get one at https://dash.cloudflare.com/profile/api-tokens",
-            },
-            ...DEFAULT_ERROR_RULES,
-        ];
-        return classifyProviderError(error, rules, "cloudflare", this.modelName);
-    }
-}
-//# sourceMappingURL=cloudflare.js.map

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

@@ -1,22 +0,0 @@
-import type { AIProviderName } from "../constants/enums.js";
-import type { NeurolinkCredentials } from "../types/index.js";
-import { OpenAIChatCompletionsProvider } from "./openaiChatCompletionsBase.js";
-/**
- * Fireworks AI Provider — direct HTTP, no AI SDK.
- *
- * Hosted open-model serving at api.fireworks.ai/inference/v1
- * (OpenAI-compatible). Best for low-latency at scale on Llama / Mixtral /
- * Qwen / DeepSeek. All request/stream/tool-loop orchestration lives in
- * `OpenAIChatCompletionsProvider`; this class only declares configuration
- * and provider-specific error mapping.
- *
- * @see https://docs.fireworks.ai/api-reference/introduction
- */
-export declare class FireworksProvider extends OpenAIChatCompletionsProvider {
-    constructor(modelName?: string, sdk?: unknown, _region?: string, credentials?: NeurolinkCredentials["fireworks"]);
-    protected getProviderName(): AIProviderName;
-    protected getDefaultModel(): string;
-    protected getFallbackModelName(): string;
-    protected getFallbackModels(): string[];
-    protected formatProviderError(error: unknown): Error;
-}

package/dist/lib/providers/fireworks.js

@@ -1,73 +0,0 @@
-import { FireworksModels } from "../constants/enums.js";
-import { AuthenticationError } from "../types/index.js";
-import { logger } from "../utils/logger.js";
-import { redactUrlCredentials } from "../utils/logSanitize.js";
-import { classifyProviderError, DEFAULT_ERROR_RULES, } from "../utils/errorClassifier.js";
-import { createFireworksConfig, getProviderModel, validateApiKey, } from "../utils/providerConfig.js";
-import { OpenAIChatCompletionsProvider } from "./openaiChatCompletionsBase.js";
-const FIREWORKS_DEFAULT_BASE_URL = "https://api.fireworks.ai/inference/v1";
-const getFireworksApiKey = () => validateApiKey(createFireworksConfig());
-const getDefaultFireworksModel = () => getProviderModel("FIREWORKS_MODEL", FireworksModels.DEEPSEEK_V4_PRO);
-/**
- * Fireworks AI Provider — direct HTTP, no AI SDK.
- *
- * Hosted open-model serving at api.fireworks.ai/inference/v1
- * (OpenAI-compatible). Best for low-latency at scale on Llama / Mixtral /
- * Qwen / DeepSeek. All request/stream/tool-loop orchestration lives in
- * `OpenAIChatCompletionsProvider`; this class only declares configuration
- * and provider-specific error mapping.
- *
- * @see https://docs.fireworks.ai/api-reference/introduction
- */
-export class FireworksProvider extends OpenAIChatCompletionsProvider {
-    constructor(modelName, sdk, _region, credentials) {
-        // Trim the override before applying precedence. A blank/whitespace
-        // `credentials.apiKey` must NOT bypass the env key — that would build a
-        // client with an unusable bearer token and fail at request time.
-        const overrideApiKey = credentials?.apiKey?.trim();
-        const apiKey = overrideApiKey && overrideApiKey.length > 0
-            ? overrideApiKey
-            : getFireworksApiKey();
-        const baseURL = credentials?.baseURL?.trim() ||
-            process.env.FIREWORKS_BASE_URL?.trim() ||
-            FIREWORKS_DEFAULT_BASE_URL;
-        super("fireworks", modelName, sdk, { baseURL, apiKey });
-        logger.debug("Fireworks Provider initialized", {
-            modelName: this.modelName,
-            providerName: this.providerName,
-            baseURL: redactUrlCredentials(this.config.baseURL),
-        });
-    }
-    getProviderName() {
-        return "fireworks";
-    }
-    getDefaultModel() {
-        return getDefaultFireworksModel();
-    }
-    getFallbackModelName() {
-        return FireworksModels.DEEPSEEK_V4_PRO;
-    }
-    getFallbackModels() {
-        return [
-            FireworksModels.DEEPSEEK_V4_PRO,
-            FireworksModels.GLM_5P1,
-            FireworksModels.GLM_5,
-            FireworksModels.KIMI_K2P6,
-            FireworksModels.KIMI_K2P5,
-            FireworksModels.GPT_OSS_120B,
-        ];
-    }
-    formatProviderError(error) {
-        const rules = [
-            {
-                match: (ctx) => ctx.statusCode === 401 ||
-                    /Invalid API key|Authentication/i.test(ctx.message),
-                errorClass: AuthenticationError,
-                message: "Invalid Fireworks API key. Get one at https://fireworks.ai/account/api-keys",
-            },
-            ...DEFAULT_ERROR_RULES,
-        ];
-        return classifyProviderError(error, rules, "fireworks", this.modelName);
-    }
-}
-//# sourceMappingURL=fireworks.js.map

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

@@ -1,24 +0,0 @@
-import type { AIProviderName } from "../constants/enums.js";
-import type { NeurolinkCredentials } from "../types/index.js";
-import { OpenAIChatCompletionsProvider } from "./openaiChatCompletionsBase.js";
-/**
- * Groq Provider — direct HTTP, no AI SDK.
- *
- * Sub-100ms inference of Llama / Mistral / Gemma at api.groq.com/openai/v1
- * (OpenAI-compatible). Best for low-latency tier; trade-off vs other open
- * model hosts is throughput latency, not quality.
- *
- * All request/stream/tool-loop orchestration lives in
- * `OpenAIChatCompletionsProvider`; this class only declares configuration
- * and provider-specific error mapping.
- *
- * @see https://console.groq.com/docs/quickstart
- */
-export declare class GroqProvider extends OpenAIChatCompletionsProvider {
-    constructor(modelName?: string, sdk?: unknown, _region?: string, credentials?: NeurolinkCredentials["groq"]);
-    protected getProviderName(): AIProviderName;
-    protected getDefaultModel(): string;
-    protected getFallbackModelName(): string;
-    protected getFallbackModels(): string[];
-    protected formatProviderError(error: unknown): Error;
-}

package/dist/lib/providers/groq.js

@@ -1,83 +0,0 @@
-import { GroqModels } from "../constants/enums.js";
-import { AuthenticationError, InvalidModelError, ProviderError, } from "../types/index.js";
-import { logger } from "../utils/logger.js";
-import { redactUrlCredentials } from "../utils/logSanitize.js";
-import { classifyProviderError, DEFAULT_ERROR_RULES, } from "../utils/errorClassifier.js";
-import { createGroqConfig, getProviderModel, validateApiKey, } from "../utils/providerConfig.js";
-import { TimeoutError } from "../utils/timeout.js";
-import { OpenAIChatCompletionsProvider } from "./openaiChatCompletionsBase.js";
-const GROQ_DEFAULT_BASE_URL = "https://api.groq.com/openai/v1";
-const getGroqApiKey = () => validateApiKey(createGroqConfig());
-const getDefaultGroqModel = () => getProviderModel("GROQ_MODEL", GroqModels.LLAMA_3_3_70B_VERSATILE);
-/**
- * Groq Provider — direct HTTP, no AI SDK.
- *
- * Sub-100ms inference of Llama / Mistral / Gemma at api.groq.com/openai/v1
- * (OpenAI-compatible). Best for low-latency tier; trade-off vs other open
- * model hosts is throughput latency, not quality.
- *
- * All request/stream/tool-loop orchestration lives in
- * `OpenAIChatCompletionsProvider`; this class only declares configuration
- * and provider-specific error mapping.
- *
- * @see https://console.groq.com/docs/quickstart
- */
-export class GroqProvider extends OpenAIChatCompletionsProvider {
-    constructor(modelName, sdk, _region, credentials) {
-        const overrideApiKey = credentials?.apiKey?.trim();
-        const apiKey = overrideApiKey && overrideApiKey.length > 0
-            ? overrideApiKey
-            : getGroqApiKey();
-        const baseURL = credentials?.baseURL?.trim() ||
-            process.env.GROQ_BASE_URL?.trim() ||
-            GROQ_DEFAULT_BASE_URL;
-        super("groq", modelName, sdk, { baseURL, apiKey });
-        logger.debug("Groq Provider initialized", {
-            modelName: this.modelName,
-            providerName: this.providerName,
-            baseURL: redactUrlCredentials(this.config.baseURL),
-        });
-    }
-    getProviderName() {
-        return "groq";
-    }
-    getDefaultModel() {
-        return getDefaultGroqModel();
-    }
-    getFallbackModelName() {
-        return GroqModels.LLAMA_3_1_8B_INSTANT;
-    }
-    getFallbackModels() {
-        return [
-            GroqModels.LLAMA_3_3_70B_VERSATILE,
-            GroqModels.LLAMA_3_1_8B_INSTANT,
-            GroqModels.GEMMA_2_9B_IT,
-            GroqModels.MIXTRAL_8X7B_32768,
-            GroqModels.LLAMA_3_2_90B_VISION_PREVIEW,
-            GroqModels.LLAMA_3_2_11B_VISION_PREVIEW,
-        ];
-    }
-    formatProviderError(error) {
-        // Groq's TimeoutError maps to plain ProviderError (not NetworkError, the
-        // classifier's built-in default) — intercept before delegating.
-        if (error instanceof TimeoutError) {
-            return new ProviderError(`Groq request timed out: ${error.message}`, "groq");
-        }
-        const rules = [
-            {
-                match: (ctx) => ctx.statusCode === 401 ||
-                    /Invalid API key|Authentication|invalid_api_key/i.test(ctx.message),
-                errorClass: AuthenticationError,
-                message: "Invalid Groq API key. Check GROQ_API_KEY. Get one at https://console.groq.com/keys",
-            },
-            {
-                match: (ctx) => /model_decommissioned/i.test(ctx.message),
-                errorClass: InvalidModelError,
-                message: (ctx) => `Groq model '${ctx.modelName}' was decommissioned. Pick a current model from https://console.groq.com/docs/models.`,
-            },
-            ...DEFAULT_ERROR_RULES,
-        ];
-        return classifyProviderError(error, rules, "groq", this.modelName);
-    }
-}
-//# sourceMappingURL=groq.js.map

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

@@ -1,25 +0,0 @@
-import type { AIProviderName } from "../constants/enums.js";
-import type { NeurolinkCredentials } from "../types/index.js";
-import { OpenAIChatCompletionsProvider } from "./openaiChatCompletionsBase.js";
-/**
- * Mistral AI Provider — direct HTTP, no AI SDK.
- *
- * OpenAI-compatible chat completions at api.mistral.ai/v1. All request/stream/
- * tool-loop orchestration lives in `OpenAIChatCompletionsProvider`; this class
- * only declares configuration and the provider-specific error mapping.
- *
- * Mistral's `/chat/completions` accepts `response_format: { type:
- * "json_schema" }` on current models (mistral-small-2506 and newer), so no
- * structured-output downgrade is needed — the base client's default
- * pass-through is correct.
- *
- * @see https://docs.mistral.ai/api/
- */
-export declare class MistralProvider extends OpenAIChatCompletionsProvider {
-    constructor(modelName?: string, sdk?: unknown, _region?: string, credentials?: NeurolinkCredentials["mistral"]);
-    protected getProviderName(): AIProviderName;
-    protected getDefaultModel(): string;
-    protected formatProviderError(error: unknown): Error;
-    protected getFallbackModelName(): string;
-    protected getFallbackModels(): string[];
-}

package/dist/lib/providers/mistral.js

@@ -1,87 +0,0 @@
-import { MistralModels } from "../constants/enums.js";
-import { AuthenticationError } from "../types/index.js";
-import { logger } from "../utils/logger.js";
-import { redactUrlCredentials } from "../utils/logSanitize.js";
-import { classifyProviderError, DEFAULT_ERROR_RULES, } from "../utils/errorClassifier.js";
-import { createMistralConfig, getProviderModel, validateApiKey, } from "../utils/providerConfig.js";
-import { OpenAIChatCompletionsProvider } from "./openaiChatCompletionsBase.js";
-const MISTRAL_DEFAULT_BASE_URL = "https://api.mistral.ai/v1";
-const getMistralApiKey = () => {
-    return validateApiKey(createMistralConfig());
-};
-const getDefaultMistralModel = () => {
-    // Vision-capable Mistral Small (June 2025) with multimodal support.
-    return getProviderModel("MISTRAL_MODEL", MistralModels.MISTRAL_SMALL_2506);
-};
-/**
- * Mistral AI Provider — direct HTTP, no AI SDK.
- *
- * OpenAI-compatible chat completions at api.mistral.ai/v1. All request/stream/
- * tool-loop orchestration lives in `OpenAIChatCompletionsProvider`; this class
- * only declares configuration and the provider-specific error mapping.
- *
- * Mistral's `/chat/completions` accepts `response_format: { type:
- * "json_schema" }` on current models (mistral-small-2506 and newer), so no
- * structured-output downgrade is needed — the base client's default
- * pass-through is correct.
- *
- * @see https://docs.mistral.ai/api/
- */
-export class MistralProvider extends OpenAIChatCompletionsProvider {
-    constructor(modelName, sdk, _region, credentials) {
-        // Trim the override before applying precedence. A blank/whitespace
-        // `credentials.apiKey` must NOT bypass `getMistralApiKey()` — that would
-        // build a client with an unusable bearer token and fail at request time
-        // with a confusing 401 instead of at construction time.
-        const overrideApiKey = credentials?.apiKey?.trim();
-        const apiKey = overrideApiKey && overrideApiKey.length > 0
-            ? overrideApiKey
-            : getMistralApiKey();
-        // Treat blank/whitespace overrides as unset so an empty
-        // `credentials.baseURL` or `MISTRAL_BASE_URL=` cannot silently override
-        // the default with "" (mirrors the apiKey precedence above).
-        const baseURL = credentials?.baseURL?.trim() ||
-            process.env.MISTRAL_BASE_URL?.trim() ||
-            MISTRAL_DEFAULT_BASE_URL;
-        super("mistral", modelName, sdk, { baseURL, apiKey });
-        logger.debug("Mistral Provider initialized", {
-            modelName: this.modelName,
-            providerName: this.providerName,
-            baseURL: redactUrlCredentials(this.config.baseURL),
-        });
-    }
-    // ===========================================================================
-    // Abstract hooks (required)
-    // ===========================================================================
-    getProviderName() {
-        return "mistral";
-    }
-    getDefaultModel() {
-        return getDefaultMistralModel();
-    }
-    formatProviderError(error) {
-        const rules = [
-            {
-                match: (ctx) => ctx.statusCode === 401 ||
-                    /API_KEY_INVALID|Invalid API key|Unauthorized/i.test(ctx.message),
-                errorClass: AuthenticationError,
-                message: "Invalid Mistral API key. Please check your MISTRAL_API_KEY environment variable.",
-            },
-            ...DEFAULT_ERROR_RULES,
-        ];
-        return classifyProviderError(error, rules, "mistral", this.modelName);
-    }
-    // ===========================================================================
-    // Optional hooks
-    // ===========================================================================
-    getFallbackModelName() {
-        return MistralModels.MISTRAL_SMALL_2506;
-    }
-    getFallbackModels() {
-        return [
-            MistralModels.MISTRAL_SMALL_2506,
-            MistralModels.MISTRAL_LARGE_LATEST,
-        ];
-    }
-}
-//# sourceMappingURL=mistral.js.map

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

@@ -1,24 +0,0 @@
-import type { AIProviderName } from "../constants/enums.js";
-import type { NeurolinkCredentials } from "../types/index.js";
-import { OpenAIChatCompletionsProvider } from "./openaiChatCompletionsBase.js";
-/**
- * Perplexity Provider — direct HTTP, no AI SDK.
- *
- * Sonar models with built-in web grounding. OpenAI-compatible chat
- * completions at api.perplexity.ai. Best for queries that need fresh
- * web context (search-augmented answers). Citation data, if the API returns
- * any, is not extracted or exposed by this provider.
- *
- * All request/stream/tool-loop orchestration lives in
- * `OpenAIChatCompletionsProvider`; this class only declares configuration
- * and provider-specific error mapping.
- *
- * @see https://docs.perplexity.ai/api-reference/chat-completions
- */
-export declare class PerplexityProvider extends OpenAIChatCompletionsProvider {
-    constructor(modelName?: string, sdk?: unknown, _region?: string, credentials?: NeurolinkCredentials["perplexity"]);
-    protected getProviderName(): AIProviderName;
-    protected getDefaultModel(): string;
-    protected getFallbackModels(): string[];
-    protected formatProviderError(error: unknown): Error;
-}

package/dist/lib/providers/perplexity.js

@@ -1,69 +0,0 @@
-import { PerplexityModels } from "../constants/enums.js";
-import { AuthenticationError } from "../types/index.js";
-import { logger } from "../utils/logger.js";
-import { redactUrlCredentials } from "../utils/logSanitize.js";
-import { classifyProviderError, DEFAULT_ERROR_RULES, } from "../utils/errorClassifier.js";
-import { createPerplexityConfig, getProviderModel, validateApiKey, } from "../utils/providerConfig.js";
-import { OpenAIChatCompletionsProvider } from "./openaiChatCompletionsBase.js";
-const PERPLEXITY_DEFAULT_BASE_URL = "https://api.perplexity.ai";
-const getPerplexityApiKey = () => validateApiKey(createPerplexityConfig());
-const getDefaultPerplexityModel = () => getProviderModel("PERPLEXITY_MODEL", PerplexityModels.SONAR);
-/**
- * Perplexity Provider — direct HTTP, no AI SDK.
- *
- * Sonar models with built-in web grounding. OpenAI-compatible chat
- * completions at api.perplexity.ai. Best for queries that need fresh
- * web context (search-augmented answers). Citation data, if the API returns
- * any, is not extracted or exposed by this provider.
- *
- * All request/stream/tool-loop orchestration lives in
- * `OpenAIChatCompletionsProvider`; this class only declares configuration
- * and provider-specific error mapping.
- *
- * @see https://docs.perplexity.ai/api-reference/chat-completions
- */
-export class PerplexityProvider extends OpenAIChatCompletionsProvider {
-    constructor(modelName, sdk, _region, credentials) {
-        const overrideApiKey = credentials?.apiKey?.trim();
-        const apiKey = overrideApiKey && overrideApiKey.length > 0
-            ? overrideApiKey
-            : getPerplexityApiKey();
-        const baseURL = credentials?.baseURL?.trim() ||
-            process.env.PERPLEXITY_BASE_URL?.trim() ||
-            PERPLEXITY_DEFAULT_BASE_URL;
-        super("perplexity", modelName, sdk, { baseURL, apiKey });
-        logger.debug("Perplexity Provider initialized", {
-            modelName: this.modelName,
-            providerName: this.providerName,
-            baseURL: redactUrlCredentials(this.config.baseURL),
-        });
-    }
-    getProviderName() {
-        return "perplexity";
-    }
-    getDefaultModel() {
-        return getDefaultPerplexityModel();
-    }
-    getFallbackModels() {
-        return [
-            PerplexityModels.SONAR,
-            PerplexityModels.SONAR_PRO,
-            PerplexityModels.SONAR_REASONING,
-            PerplexityModels.SONAR_REASONING_PRO,
-            PerplexityModels.SONAR_DEEP_RESEARCH,
-        ];
-    }
-    formatProviderError(error) {
-        const rules = [
-            {
-                match: (ctx) => ctx.statusCode === 401 ||
-                    /Invalid API key|Authentication/i.test(ctx.message),
-                errorClass: AuthenticationError,
-                message: "Invalid Perplexity API key. Get one at https://www.perplexity.ai/settings/api",
-            },
-            ...DEFAULT_ERROR_RULES,
-        ];
-        return classifyProviderError(error, rules, "perplexity", this.modelName);
-    }
-}
-//# sourceMappingURL=perplexity.js.map

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

@@ -1,23 +0,0 @@
-import type { AIProviderName } from "../constants/enums.js";
-import type { NeurolinkCredentials } from "../types/index.js";
-import { OpenAIChatCompletionsProvider } from "./openaiChatCompletionsBase.js";
-/**
- * Together AI Provider — direct HTTP, no AI SDK.
- *
- * Hosted open-model gateway at api.together.xyz/v1 (OpenAI-compatible).
- * Llama / Mistral / Qwen / DeepSeek / Gemma / WizardLM available
- * server-less; pass any catalog id via `--model`.
- * All request/stream/tool-loop orchestration lives in
- * `OpenAIChatCompletionsProvider`; this class only declares configuration
- * and provider-specific error mapping.
- *
- * @see https://docs.together.ai/docs/openai-api-compatibility
- */
-export declare class TogetherAIProvider extends OpenAIChatCompletionsProvider {
-    constructor(modelName?: string, sdk?: unknown, _region?: string, credentials?: NeurolinkCredentials["together"]);
-    protected getProviderName(): AIProviderName;
-    protected getDefaultModel(): string;
-    protected getFallbackModelName(): string;
-    protected getFallbackModels(): string[];
-    protected formatProviderError(error: unknown): Error;
-}