@juspay/neurolink 11.2.2 → 11.2.3

package/dist/factories/providerRegistry.d.ts

@@ -1,4 +1,14 @@
 import type { ProviderRegistryOptions } from "../types/index.js";
+import { AIProviderName } from "../constants/enums.js";
+/**
+ * Static module -> provider-ID manifest for every provider registered below.
+ * Module names (file/dir under src/lib/providers/) intentionally differ from
+ * their canonical IDs (e.g. amazonBedrock -> "bedrock", googleVertex ->
+ * "vertex"); static scanners that cannot resolve the dynamic import() calls
+ * use this mapping to confirm a module is registered. Enforced at runtime so
+ * the registry cannot silently drift from this manifest.
+ */
+export declare const PROVIDER_MODULE_TO_ID: Readonly<Record<string, AIProviderName>>;
 /**
  * Provider Registry - registers all providers with the factory
  * This is where we migrate providers one by one to the new pattern
@@ -33,10 +43,12 @@ export declare class ProviderRegistry {
      * (avoids circular dependencies; see CLAUDE.md).
      *
      * Not registered (by design): index.ts, providerTypeUtils.ts,
-     * anthropicBaseProvider.ts (legacy; anthropic.ts is live),
-     * googleNativeGemini3.ts (shared helpers). Filename != provider ID
-     * (e.g. amazonBedrock -> "bedrock"); static scanners that miss dynamic
-     * imports may false-positive (Pattern Analysis #1178).
+     * openaiChatCompletionsBase.ts, openaiChatCompletionsClient.ts,
+     * anthropicImageBlocks.ts (shared base/helper modules), anthropicBaseProvider.ts
+     * (legacy; anthropic.ts is live), googleNativeGemini3.ts (shared helpers).
+     * Filename != provider ID (e.g. amazonBedrock -> "bedrock"); the
+     * statically-scannable PROVIDER_MODULE_TO_ID manifest maps every registered
+     * module to its provider ID and is enforced below (Pattern Analysis #1178/#1317).
      */
     private static _doRegister;
     /**

package/dist/factories/providerRegistry.js

@@ -1,7 +1,48 @@
 import { ProviderFactory } from "./providerFactory.js";
 import { logger } from "../utils/logger.js";
-import { AIProviderName, GoogleAIModels, OpenAIModels, AnthropicModels, VertexModels, MistralModels, OllamaModels, LiteLLMModels, HuggingFaceModels, DeepSeekModels, NvidiaNimModels, OpenRouterModels, XaiModels, GroqModels, CohereModels, TogetherAIModels, FireworksModels, PerplexityModels, CloudflareModels, VoyageModels, JinaModels, StabilityModels, IdeogramModels, RecraftModels, ReplicateModels, } from "../constants/enums.js";
+import { AIProviderName, GoogleAIModels, OpenAIModels, AnthropicModels, VertexModels, OllamaModels, LiteLLMModels, HuggingFaceModels, DeepSeekModels, NvidiaNimModels, OpenRouterModels, CohereModels, VoyageModels, JinaModels, StabilityModels, IdeogramModels, RecraftModels, ReplicateModels, } from "../constants/enums.js";
 import { PROVIDER_DESCRIPTORS_BY_NAME } from "./providerDescriptors.js";
+import { OPENAI_COMPAT_CATALOG } from "../providers/openaiCompatCatalog.js";
+/**
+ * Static module -> provider-ID manifest for every provider registered below.
+ * Module names (file/dir under src/lib/providers/) intentionally differ from
+ * their canonical IDs (e.g. amazonBedrock -> "bedrock", googleVertex ->
+ * "vertex"); static scanners that cannot resolve the dynamic import() calls
+ * use this mapping to confirm a module is registered. Enforced at runtime so
+ * the registry cannot silently drift from this manifest.
+ */
+export const PROVIDER_MODULE_TO_ID = {
+    amazonBedrock: AIProviderName.BEDROCK,
+    amazonSagemaker: AIProviderName.SAGEMAKER,
+    anthropic: AIProviderName.ANTHROPIC,
+    azureOpenai: AIProviderName.AZURE,
+    cloudflare: AIProviderName.CLOUDFLARE,
+    cohere: AIProviderName.COHERE,
+    deepseek: AIProviderName.DEEPSEEK,
+    fireworks: AIProviderName.FIREWORKS,
+    googleAiStudio: AIProviderName.GOOGLE_AI,
+    googleVertex: AIProviderName.VERTEX,
+    groq: AIProviderName.GROQ,
+    huggingFace: AIProviderName.HUGGINGFACE,
+    ideogram: AIProviderName.IDEOGRAM,
+    jina: AIProviderName.JINA,
+    litellm: AIProviderName.LITELLM,
+    llamaCpp: AIProviderName.LLAMACPP,
+    lmStudio: AIProviderName.LM_STUDIO,
+    mistral: AIProviderName.MISTRAL,
+    nvidiaNim: AIProviderName.NVIDIA_NIM,
+    ollama: AIProviderName.OLLAMA,
+    openAI: AIProviderName.OPENAI,
+    openaiCompatible: AIProviderName.OPENAI_COMPATIBLE,
+    openRouter: AIProviderName.OPENROUTER,
+    perplexity: AIProviderName.PERPLEXITY,
+    recraft: AIProviderName.RECRAFT,
+    replicate: AIProviderName.REPLICATE,
+    stability: AIProviderName.STABILITY,
+    togetherAi: AIProviderName.TOGETHER_AI,
+    voyage: AIProviderName.VOYAGE,
+    xai: AIProviderName.XAI,
+};
 /**
  * Provider Registry - registers all providers with the factory
  * This is where we migrate providers one by one to the new pattern
@@ -53,10 +94,12 @@ export class ProviderRegistry {
      * (avoids circular dependencies; see CLAUDE.md).
      *
      * Not registered (by design): index.ts, providerTypeUtils.ts,
-     * anthropicBaseProvider.ts (legacy; anthropic.ts is live),
-     * googleNativeGemini3.ts (shared helpers). Filename != provider ID
-     * (e.g. amazonBedrock -> "bedrock"); static scanners that miss dynamic
-     * imports may false-positive (Pattern Analysis #1178).
+     * openaiChatCompletionsBase.ts, openaiChatCompletionsClient.ts,
+     * anthropicImageBlocks.ts (shared base/helper modules), anthropicBaseProvider.ts
+     * (legacy; anthropic.ts is live), googleNativeGemini3.ts (shared helpers).
+     * Filename != provider ID (e.g. amazonBedrock -> "bedrock"); the
+     * statically-scannable PROVIDER_MODULE_TO_ID manifest maps every registered
+     * module to its provider ID and is enforced below (Pattern Analysis #1178/#1317).
      */
     // eslint-disable-next-line max-lines-per-function
     static async _doRegister() {
@@ -111,12 +154,18 @@ export class ProviderRegistry {
                 return new HuggingFaceProvider(modelName, sdk, region, hfCreds);
             }, process.env.HUGGINGFACE_MODEL ||
                 HuggingFaceModels.QWEN_2_5_72B_INSTRUCT, ["huggingface", "hf"], PROVIDER_DESCRIPTORS_BY_NAME.get(AIProviderName.HUGGINGFACE));
-            // Register Mistral AI provider
-            ProviderFactory.registerProvider(AIProviderName.MISTRAL, async (modelName, _providerName, sdk, _region, credentials) => {
-                const mistralCreds = credentials;
-                const { MistralProvider } = await import("../providers/mistral.js");
-                return new MistralProvider(modelName, sdk, undefined, mistralCreds);
-            }, MistralModels.MISTRAL_LARGE_LATEST, ["mistral"], PROVIDER_DESCRIPTORS_BY_NAME.get(AIProviderName.MISTRAL));
+            // Register the config-driven OpenAI-compatible catalog providers
+            // (groq, xai, together-ai, fireworks, perplexity, mistral, cloudflare).
+            // To add a new zero-quirk OpenAI-compatible provider, add one entry to
+            // OPENAI_COMPAT_CATALOG (openaiCompatCatalog.ts) — not a new block here.
+            for (const entry of OPENAI_COMPAT_CATALOG) {
+                ProviderFactory.registerProvider(entry.providerName, async (modelName, _providerName, sdk, _region, credentials) => {
+                    const { ConfiguredOpenAICompatProvider } = await import("../providers/configuredOpenAICompat.js");
+                    return new ConfiguredOpenAICompatProvider(entry, modelName, sdk, credentials);
+                }, entry.registryDefaultModelChecksEnvVar
+                    ? process.env[entry.modelEnvVar] || entry.registryDefaultModel
+                    : entry.registryDefaultModel, entry.aliases, PROVIDER_DESCRIPTORS_BY_NAME.get(entry.providerName));
+            }
             // Register Ollama provider
             ProviderFactory.registerProvider(AIProviderName.OLLAMA, async (modelName, _providerName, sdk, _region, credentials) => {
                 const ollamaCreds = credentials;
@@ -178,49 +227,12 @@ export class ProviderRegistry {
                 const { LlamaCppProvider } = await import("../providers/llamaCpp.js");
                 return new LlamaCppProvider(modelName, sdk, undefined, llamaCppCreds);
             }, process.env.LLAMACPP_MODEL || undefined, ["llamacpp", "llama.cpp", "llama-cpp"], PROVIDER_DESCRIPTORS_BY_NAME.get(AIProviderName.LLAMACPP));
-            // Register xAI Grok provider
-            ProviderFactory.registerProvider(AIProviderName.XAI, async (modelName, _providerName, sdk, _region, credentials) => {
-                const xaiCreds = credentials;
-                const { XaiProvider } = await import("../providers/xai.js");
-                return new XaiProvider(modelName, sdk, undefined, xaiCreds);
-            }, process.env.XAI_MODEL || XaiModels.GROK_3, ["xai", "grok"], PROVIDER_DESCRIPTORS_BY_NAME.get(AIProviderName.XAI));
-            // Register Groq provider
-            ProviderFactory.registerProvider(AIProviderName.GROQ, async (modelName, _providerName, sdk, _region, credentials) => {
-                const groqCreds = credentials;
-                const { GroqProvider } = await import("../providers/groq.js");
-                return new GroqProvider(modelName, sdk, undefined, groqCreds);
-            }, process.env.GROQ_MODEL || GroqModels.LLAMA_3_3_70B_VERSATILE, ["groq"], PROVIDER_DESCRIPTORS_BY_NAME.get(AIProviderName.GROQ));
             // Register Cohere provider
             ProviderFactory.registerProvider(AIProviderName.COHERE, async (modelName, _providerName, sdk, _region, credentials) => {
                 const cohereCreds = credentials;
                 const { CohereProvider } = await import("../providers/cohere.js");
                 return new CohereProvider(modelName, sdk, undefined, cohereCreds);
             }, process.env.COHERE_MODEL || CohereModels.COMMAND_R_PLUS, ["cohere"], PROVIDER_DESCRIPTORS_BY_NAME.get(AIProviderName.COHERE));
-            // Register Together AI provider
-            ProviderFactory.registerProvider(AIProviderName.TOGETHER_AI, async (modelName, _providerName, sdk, _region, credentials) => {
-                const togetherCreds = credentials;
-                const { TogetherAIProvider } = await import("../providers/togetherAi.js");
-                return new TogetherAIProvider(modelName, sdk, undefined, togetherCreds);
-            }, process.env.TOGETHER_MODEL ||
-                TogetherAIModels.LLAMA_3_3_70B_INSTRUCT_TURBO, ["together-ai", "together"], PROVIDER_DESCRIPTORS_BY_NAME.get(AIProviderName.TOGETHER_AI));
-            // Register Fireworks AI provider
-            ProviderFactory.registerProvider(AIProviderName.FIREWORKS, async (modelName, _providerName, sdk, _region, credentials) => {
-                const fireworksCreds = credentials;
-                const { FireworksProvider } = await import("../providers/fireworks.js");
-                return new FireworksProvider(modelName, sdk, undefined, fireworksCreds);
-            }, process.env.FIREWORKS_MODEL || FireworksModels.DEEPSEEK_V4_PRO, ["fireworks"], PROVIDER_DESCRIPTORS_BY_NAME.get(AIProviderName.FIREWORKS));
-            // Register Perplexity provider
-            ProviderFactory.registerProvider(AIProviderName.PERPLEXITY, async (modelName, _providerName, sdk, _region, credentials) => {
-                const perplexityCreds = credentials;
-                const { PerplexityProvider } = await import("../providers/perplexity.js");
-                return new PerplexityProvider(modelName, sdk, undefined, perplexityCreds);
-            }, process.env.PERPLEXITY_MODEL || PerplexityModels.SONAR, ["perplexity", "pplx"], PROVIDER_DESCRIPTORS_BY_NAME.get(AIProviderName.PERPLEXITY));
-            // Register Cloudflare Workers AI provider
-            ProviderFactory.registerProvider(AIProviderName.CLOUDFLARE, async (modelName, _providerName, sdk, _region, credentials) => {
-                const cloudflareCreds = credentials;
-                const { CloudflareProvider } = await import("../providers/cloudflare.js");
-                return new CloudflareProvider(modelName, sdk, undefined, cloudflareCreds);
-            }, process.env.CLOUDFLARE_MODEL || CloudflareModels.LLAMA_3_3_70B_FAST, ["cloudflare", "workers-ai", "cf-ai"], PROVIDER_DESCRIPTORS_BY_NAME.get(AIProviderName.CLOUDFLARE));
             // Register Voyage AI embeddings provider
             ProviderFactory.registerProvider(AIProviderName.VOYAGE, async (modelName, _providerName, sdk, _region, credentials) => {
                 const voyageCreds = credentials;
@@ -258,6 +270,16 @@ export class ProviderRegistry {
                 const { RecraftProvider } = await import("../providers/recraft.js");
                 return new RecraftProvider(modelName, sdk, undefined, recraftCreds);
             }, process.env.RECRAFT_MODEL || RecraftModels.RECRAFT_V3, ["recraft"], PROVIDER_DESCRIPTORS_BY_NAME.get(AIProviderName.RECRAFT));
+            const unregistered = Object.entries(PROVIDER_MODULE_TO_ID).filter(([module, id]) => {
+                if (!ProviderFactory.hasProvider(id)) {
+                    logger.error(`[ProviderRegistry] drift: module "${module}" not registered as "${id}"`);
+                    return true;
+                }
+                return false;
+            });
+            if (unregistered.length > 0) {
+                throw new Error(`ProviderRegistry drift: ${unregistered.length} module(s) in PROVIDER_MODULE_TO_ID are not registered`);
+            }
             logger.debug("All AI providers registered successfully");
             // ===== TTS HANDLER REGISTRATION =====
             try {

package/dist/lib/factories/providerRegistry.d.ts

@@ -1,4 +1,14 @@
 import type { ProviderRegistryOptions } from "../types/index.js";
+import { AIProviderName } from "../constants/enums.js";
+/**
+ * Static module -> provider-ID manifest for every provider registered below.
+ * Module names (file/dir under src/lib/providers/) intentionally differ from
+ * their canonical IDs (e.g. amazonBedrock -> "bedrock", googleVertex ->
+ * "vertex"); static scanners that cannot resolve the dynamic import() calls
+ * use this mapping to confirm a module is registered. Enforced at runtime so
+ * the registry cannot silently drift from this manifest.
+ */
+export declare const PROVIDER_MODULE_TO_ID: Readonly<Record<string, AIProviderName>>;
 /**
  * Provider Registry - registers all providers with the factory
  * This is where we migrate providers one by one to the new pattern
@@ -33,10 +43,12 @@ export declare class ProviderRegistry {
      * (avoids circular dependencies; see CLAUDE.md).
      *
      * Not registered (by design): index.ts, providerTypeUtils.ts,
-     * anthropicBaseProvider.ts (legacy; anthropic.ts is live),
-     * googleNativeGemini3.ts (shared helpers). Filename != provider ID
-     * (e.g. amazonBedrock -> "bedrock"); static scanners that miss dynamic
-     * imports may false-positive (Pattern Analysis #1178).
+     * openaiChatCompletionsBase.ts, openaiChatCompletionsClient.ts,
+     * anthropicImageBlocks.ts (shared base/helper modules), anthropicBaseProvider.ts
+     * (legacy; anthropic.ts is live), googleNativeGemini3.ts (shared helpers).
+     * Filename != provider ID (e.g. amazonBedrock -> "bedrock"); the
+     * statically-scannable PROVIDER_MODULE_TO_ID manifest maps every registered
+     * module to its provider ID and is enforced below (Pattern Analysis #1178/#1317).
      */
     private static _doRegister;
     /**

package/dist/lib/factories/providerRegistry.js

@@ -1,7 +1,48 @@
 import { ProviderFactory } from "./providerFactory.js";
 import { logger } from "../utils/logger.js";
-import { AIProviderName, GoogleAIModels, OpenAIModels, AnthropicModels, VertexModels, MistralModels, OllamaModels, LiteLLMModels, HuggingFaceModels, DeepSeekModels, NvidiaNimModels, OpenRouterModels, XaiModels, GroqModels, CohereModels, TogetherAIModels, FireworksModels, PerplexityModels, CloudflareModels, VoyageModels, JinaModels, StabilityModels, IdeogramModels, RecraftModels, ReplicateModels, } from "../constants/enums.js";
+import { AIProviderName, GoogleAIModels, OpenAIModels, AnthropicModels, VertexModels, OllamaModels, LiteLLMModels, HuggingFaceModels, DeepSeekModels, NvidiaNimModels, OpenRouterModels, CohereModels, VoyageModels, JinaModels, StabilityModels, IdeogramModels, RecraftModels, ReplicateModels, } from "../constants/enums.js";
 import { PROVIDER_DESCRIPTORS_BY_NAME } from "./providerDescriptors.js";
+import { OPENAI_COMPAT_CATALOG } from "../providers/openaiCompatCatalog.js";
+/**
+ * Static module -> provider-ID manifest for every provider registered below.
+ * Module names (file/dir under src/lib/providers/) intentionally differ from
+ * their canonical IDs (e.g. amazonBedrock -> "bedrock", googleVertex ->
+ * "vertex"); static scanners that cannot resolve the dynamic import() calls
+ * use this mapping to confirm a module is registered. Enforced at runtime so
+ * the registry cannot silently drift from this manifest.
+ */
+export const PROVIDER_MODULE_TO_ID = {
+    amazonBedrock: AIProviderName.BEDROCK,
+    amazonSagemaker: AIProviderName.SAGEMAKER,
+    anthropic: AIProviderName.ANTHROPIC,
+    azureOpenai: AIProviderName.AZURE,
+    cloudflare: AIProviderName.CLOUDFLARE,
+    cohere: AIProviderName.COHERE,
+    deepseek: AIProviderName.DEEPSEEK,
+    fireworks: AIProviderName.FIREWORKS,
+    googleAiStudio: AIProviderName.GOOGLE_AI,
+    googleVertex: AIProviderName.VERTEX,
+    groq: AIProviderName.GROQ,
+    huggingFace: AIProviderName.HUGGINGFACE,
+    ideogram: AIProviderName.IDEOGRAM,
+    jina: AIProviderName.JINA,
+    litellm: AIProviderName.LITELLM,
+    llamaCpp: AIProviderName.LLAMACPP,
+    lmStudio: AIProviderName.LM_STUDIO,
+    mistral: AIProviderName.MISTRAL,
+    nvidiaNim: AIProviderName.NVIDIA_NIM,
+    ollama: AIProviderName.OLLAMA,
+    openAI: AIProviderName.OPENAI,
+    openaiCompatible: AIProviderName.OPENAI_COMPATIBLE,
+    openRouter: AIProviderName.OPENROUTER,
+    perplexity: AIProviderName.PERPLEXITY,
+    recraft: AIProviderName.RECRAFT,
+    replicate: AIProviderName.REPLICATE,
+    stability: AIProviderName.STABILITY,
+    togetherAi: AIProviderName.TOGETHER_AI,
+    voyage: AIProviderName.VOYAGE,
+    xai: AIProviderName.XAI,
+};
 /**
  * Provider Registry - registers all providers with the factory
  * This is where we migrate providers one by one to the new pattern
@@ -53,10 +94,12 @@ export class ProviderRegistry {
      * (avoids circular dependencies; see CLAUDE.md).
      *
      * Not registered (by design): index.ts, providerTypeUtils.ts,
-     * anthropicBaseProvider.ts (legacy; anthropic.ts is live),
-     * googleNativeGemini3.ts (shared helpers). Filename != provider ID
-     * (e.g. amazonBedrock -> "bedrock"); static scanners that miss dynamic
-     * imports may false-positive (Pattern Analysis #1178).
+     * openaiChatCompletionsBase.ts, openaiChatCompletionsClient.ts,
+     * anthropicImageBlocks.ts (shared base/helper modules), anthropicBaseProvider.ts
+     * (legacy; anthropic.ts is live), googleNativeGemini3.ts (shared helpers).
+     * Filename != provider ID (e.g. amazonBedrock -> "bedrock"); the
+     * statically-scannable PROVIDER_MODULE_TO_ID manifest maps every registered
+     * module to its provider ID and is enforced below (Pattern Analysis #1178/#1317).
      */
     // eslint-disable-next-line max-lines-per-function
     static async _doRegister() {
@@ -111,12 +154,18 @@ export class ProviderRegistry {
                 return new HuggingFaceProvider(modelName, sdk, region, hfCreds);
             }, process.env.HUGGINGFACE_MODEL ||
                 HuggingFaceModels.QWEN_2_5_72B_INSTRUCT, ["huggingface", "hf"], PROVIDER_DESCRIPTORS_BY_NAME.get(AIProviderName.HUGGINGFACE));
-            // Register Mistral AI provider
-            ProviderFactory.registerProvider(AIProviderName.MISTRAL, async (modelName, _providerName, sdk, _region, credentials) => {
-                const mistralCreds = credentials;
-                const { MistralProvider } = await import("../providers/mistral.js");
-                return new MistralProvider(modelName, sdk, undefined, mistralCreds);
-            }, MistralModels.MISTRAL_LARGE_LATEST, ["mistral"], PROVIDER_DESCRIPTORS_BY_NAME.get(AIProviderName.MISTRAL));
+            // Register the config-driven OpenAI-compatible catalog providers
+            // (groq, xai, together-ai, fireworks, perplexity, mistral, cloudflare).
+            // To add a new zero-quirk OpenAI-compatible provider, add one entry to
+            // OPENAI_COMPAT_CATALOG (openaiCompatCatalog.ts) — not a new block here.
+            for (const entry of OPENAI_COMPAT_CATALOG) {
+                ProviderFactory.registerProvider(entry.providerName, async (modelName, _providerName, sdk, _region, credentials) => {
+                    const { ConfiguredOpenAICompatProvider } = await import("../providers/configuredOpenAICompat.js");
+                    return new ConfiguredOpenAICompatProvider(entry, modelName, sdk, credentials);
+                }, entry.registryDefaultModelChecksEnvVar
+                    ? process.env[entry.modelEnvVar] || entry.registryDefaultModel
+                    : entry.registryDefaultModel, entry.aliases, PROVIDER_DESCRIPTORS_BY_NAME.get(entry.providerName));
+            }
             // Register Ollama provider
             ProviderFactory.registerProvider(AIProviderName.OLLAMA, async (modelName, _providerName, sdk, _region, credentials) => {
                 const ollamaCreds = credentials;
@@ -178,49 +227,12 @@ export class ProviderRegistry {
                 const { LlamaCppProvider } = await import("../providers/llamaCpp.js");
                 return new LlamaCppProvider(modelName, sdk, undefined, llamaCppCreds);
             }, process.env.LLAMACPP_MODEL || undefined, ["llamacpp", "llama.cpp", "llama-cpp"], PROVIDER_DESCRIPTORS_BY_NAME.get(AIProviderName.LLAMACPP));
-            // Register xAI Grok provider
-            ProviderFactory.registerProvider(AIProviderName.XAI, async (modelName, _providerName, sdk, _region, credentials) => {
-                const xaiCreds = credentials;
-                const { XaiProvider } = await import("../providers/xai.js");
-                return new XaiProvider(modelName, sdk, undefined, xaiCreds);
-            }, process.env.XAI_MODEL || XaiModels.GROK_3, ["xai", "grok"], PROVIDER_DESCRIPTORS_BY_NAME.get(AIProviderName.XAI));
-            // Register Groq provider
-            ProviderFactory.registerProvider(AIProviderName.GROQ, async (modelName, _providerName, sdk, _region, credentials) => {
-                const groqCreds = credentials;
-                const { GroqProvider } = await import("../providers/groq.js");
-                return new GroqProvider(modelName, sdk, undefined, groqCreds);
-            }, process.env.GROQ_MODEL || GroqModels.LLAMA_3_3_70B_VERSATILE, ["groq"], PROVIDER_DESCRIPTORS_BY_NAME.get(AIProviderName.GROQ));
             // Register Cohere provider
             ProviderFactory.registerProvider(AIProviderName.COHERE, async (modelName, _providerName, sdk, _region, credentials) => {
                 const cohereCreds = credentials;
                 const { CohereProvider } = await import("../providers/cohere.js");
                 return new CohereProvider(modelName, sdk, undefined, cohereCreds);
             }, process.env.COHERE_MODEL || CohereModels.COMMAND_R_PLUS, ["cohere"], PROVIDER_DESCRIPTORS_BY_NAME.get(AIProviderName.COHERE));
-            // Register Together AI provider
-            ProviderFactory.registerProvider(AIProviderName.TOGETHER_AI, async (modelName, _providerName, sdk, _region, credentials) => {
-                const togetherCreds = credentials;
-                const { TogetherAIProvider } = await import("../providers/togetherAi.js");
-                return new TogetherAIProvider(modelName, sdk, undefined, togetherCreds);
-            }, process.env.TOGETHER_MODEL ||
-                TogetherAIModels.LLAMA_3_3_70B_INSTRUCT_TURBO, ["together-ai", "together"], PROVIDER_DESCRIPTORS_BY_NAME.get(AIProviderName.TOGETHER_AI));
-            // Register Fireworks AI provider
-            ProviderFactory.registerProvider(AIProviderName.FIREWORKS, async (modelName, _providerName, sdk, _region, credentials) => {
-                const fireworksCreds = credentials;
-                const { FireworksProvider } = await import("../providers/fireworks.js");
-                return new FireworksProvider(modelName, sdk, undefined, fireworksCreds);
-            }, process.env.FIREWORKS_MODEL || FireworksModels.DEEPSEEK_V4_PRO, ["fireworks"], PROVIDER_DESCRIPTORS_BY_NAME.get(AIProviderName.FIREWORKS));
-            // Register Perplexity provider
-            ProviderFactory.registerProvider(AIProviderName.PERPLEXITY, async (modelName, _providerName, sdk, _region, credentials) => {
-                const perplexityCreds = credentials;
-                const { PerplexityProvider } = await import("../providers/perplexity.js");
-                return new PerplexityProvider(modelName, sdk, undefined, perplexityCreds);
-            }, process.env.PERPLEXITY_MODEL || PerplexityModels.SONAR, ["perplexity", "pplx"], PROVIDER_DESCRIPTORS_BY_NAME.get(AIProviderName.PERPLEXITY));
-            // Register Cloudflare Workers AI provider
-            ProviderFactory.registerProvider(AIProviderName.CLOUDFLARE, async (modelName, _providerName, sdk, _region, credentials) => {
-                const cloudflareCreds = credentials;
-                const { CloudflareProvider } = await import("../providers/cloudflare.js");
-                return new CloudflareProvider(modelName, sdk, undefined, cloudflareCreds);
-            }, process.env.CLOUDFLARE_MODEL || CloudflareModels.LLAMA_3_3_70B_FAST, ["cloudflare", "workers-ai", "cf-ai"], PROVIDER_DESCRIPTORS_BY_NAME.get(AIProviderName.CLOUDFLARE));
             // Register Voyage AI embeddings provider
             ProviderFactory.registerProvider(AIProviderName.VOYAGE, async (modelName, _providerName, sdk, _region, credentials) => {
                 const voyageCreds = credentials;
@@ -258,6 +270,16 @@ export class ProviderRegistry {
                 const { RecraftProvider } = await import("../providers/recraft.js");
                 return new RecraftProvider(modelName, sdk, undefined, recraftCreds);
             }, process.env.RECRAFT_MODEL || RecraftModels.RECRAFT_V3, ["recraft"], PROVIDER_DESCRIPTORS_BY_NAME.get(AIProviderName.RECRAFT));
+            const unregistered = Object.entries(PROVIDER_MODULE_TO_ID).filter(([module, id]) => {
+                if (!ProviderFactory.hasProvider(id)) {
+                    logger.error(`[ProviderRegistry] drift: module "${module}" not registered as "${id}"`);
+                    return true;
+                }
+                return false;
+            });
+            if (unregistered.length > 0) {
+                throw new Error(`ProviderRegistry drift: ${unregistered.length} module(s) in PROVIDER_MODULE_TO_ID are not registered`);
+            }
             logger.debug("All AI providers registered successfully");
             // ===== TTS HANDLER REGISTRATION =====
             try {

package/dist/lib/providers/configuredOpenAICompat.js

@@ -2,6 +2,7 @@ import { logger } from "../utils/logger.js";
 import { redactUrlCredentials } from "../utils/logSanitize.js";
 import { getProviderModel, resolveOpenAICompatConfig, } from "../utils/providerConfig.js";
 import { classifyProviderError } from "../utils/errorClassifier.js";
+import { TimeoutError } from "../utils/timeout.js";
 import { OpenAIChatCompletionsProvider } from "./openaiChatCompletionsBase.js";
 /**
  * Generic OpenAI-compatible provider driven entirely by an
@@ -51,9 +52,15 @@ export class ConfiguredOpenAICompatProvider extends OpenAIChatCompletionsProvide
         return this.entry.fallbackModels;
     }
     formatProviderError(error) {
-        // classifyProviderError handles TimeoutError internally (always maps
-        // to NetworkError, ahead of any rule table) — no local pre-check
-        // needed or wanted here; see this task's design note.
+        // classifyProviderError hard-codes TimeoutError -> NetworkError ahead
+        // of any rule table and does not allow a per-provider override. An
+        // entry can opt out of that default via timeoutErrorClass (currently
+        // only Groq, reproducing its pre-migration subclass's own TimeoutError
+        // interception) — checked here, before ever reaching the shared
+        // classifier, so every other entry still gets its unmodified default.
+        if (error instanceof TimeoutError && this.entry.timeoutErrorClass) {
+            return new this.entry.timeoutErrorClass(`${this.entry.configOptions.providerName} request timed out: ${error.message}`, this.entry.providerName);
+        }
         return classifyProviderError(error, this.entry.errorRules, this.entry.providerName, this.modelName);
     }
 }

package/dist/lib/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/lib/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/dist/providers/configuredOpenAICompat.js

@@ -2,6 +2,7 @@ import { logger } from "../utils/logger.js";
 import { redactUrlCredentials } from "../utils/logSanitize.js";
 import { getProviderModel, resolveOpenAICompatConfig, } from "../utils/providerConfig.js";
 import { classifyProviderError } from "../utils/errorClassifier.js";
+import { TimeoutError } from "../utils/timeout.js";
 import { OpenAIChatCompletionsProvider } from "./openaiChatCompletionsBase.js";
 /**
  * Generic OpenAI-compatible provider driven entirely by an
@@ -51,9 +52,15 @@ export class ConfiguredOpenAICompatProvider extends OpenAIChatCompletionsProvide
         return this.entry.fallbackModels;
     }
     formatProviderError(error) {
-        // classifyProviderError handles TimeoutError internally (always maps
-        // to NetworkError, ahead of any rule table) — no local pre-check
-        // needed or wanted here; see this task's design note.
+        // classifyProviderError hard-codes TimeoutError -> NetworkError ahead
+        // of any rule table and does not allow a per-provider override. An
+        // entry can opt out of that default via timeoutErrorClass (currently
+        // only Groq, reproducing its pre-migration subclass's own TimeoutError
+        // interception) — checked here, before ever reaching the shared
+        // classifier, so every other entry still gets its unmodified default.
+        if (error instanceof TimeoutError && this.entry.timeoutErrorClass) {
+            return new this.entry.timeoutErrorClass(`${this.entry.configOptions.providerName} request timed out: ${error.message}`, this.entry.providerName);
+        }
         return classifyProviderError(error, this.entry.errorRules, this.entry.providerName, this.modelName);
     }
 }

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.2",
+  "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": {
@@ -125,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;
-}