@juspay/neurolink 11.2.1 → 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/openaiChatCompletionsBase.js

@@ -464,15 +464,22 @@ export class OpenAIChatCompletionsProvider extends BaseProvider {
                         const apiErr = await buildAPIError(url, body, res);
                         // One-shot 400 retry. The overflow corrector runs FIRST (it can
                         // re-fit max_tokens from the provider's own numbers and also
-                        // self-heals the runtime window registry); otherwise a subclass
-                        // may strip a rejected field and return a modified body (e.g.
-                        // NIM's chat_template / reasoning_budget). The retry runs under
-                        // the SAME timeout controller as the first attempt, so the
-                        // configured timeout caps the overall call — matching the
-                        // streaming path, which reuses its composed signal for the retry.
+                        // self-heals the runtime window registry); its output then feeds
+                        // a subclass hook that may strip a rejected field (e.g. NIM's
+                        // chat_template / reasoning_budget), so a body that needs BOTH
+                        // fixes gets both — a plain `??` between the two would let
+                        // whichever ran first silently win and drop the other's fix. The
+                        // retry runs under the SAME timeout controller as the first
+                        // attempt, so the configured timeout caps the overall call —
+                        // matching the streaming path, which reuses its composed signal
+                        // for the retry.
                         const retryBody = res.status === 400
-                            ? (correctBodyAfterContextOverflow(body, apiErr) ??
-                                adjustBodyAfter400(body, apiErr))
+                            ? (() => {
+                                const typedErr = apiErr;
+                                const overflowCorrected = correctBodyAfterContextOverflow(body, typedErr);
+                                return (adjustBodyAfter400(overflowCorrected ?? body, typedErr) ??
+                                    overflowCorrected);
+                            })()
                             : undefined;
                         if (!retryBody) {
                             throw apiErr;
@@ -967,13 +974,18 @@ export class OpenAIChatCompletionsProvider extends BaseProvider {
             // consumed inside doFetch's closure, either returned on success or
             // discarded after buildAPIError read its body on failure.
             const apiErr = err;
-            // Overflow corrector first (re-fits max_tokens from the provider's
-            // own numbers + self-heals the window registry), then the subclass
-            // hook (e.g. NIM strips chat_template / reasoning_budget when a model
-            // rejects them).
+            // Overflow corrector first (re-fits max_tokens from the provider's own
+            // numbers + self-heals the window registry); its output then feeds the
+            // subclass hook (e.g. NIM strips chat_template / reasoning_budget when
+            // a model rejects them), so a body needing BOTH fixes gets both — a
+            // plain `??` between the two would let whichever ran first silently
+            // win and drop the other's fix.
             const retryBody = apiErr.statusCode === 400
-                ? (this.correctBodyAfterContextOverflow(body, apiErr) ??
-                    this.adjustBodyAfter400(body, apiErr))
+                ? (() => {
+                    const overflowCorrected = this.correctBodyAfterContextOverflow(body, apiErr);
+                    return (this.adjustBodyAfter400(overflowCorrected ?? body, apiErr) ??
+                        overflowCorrected);
+                })()
                 : undefined;
             if (!retryBody) {
                 throw apiErr;

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/openaiChatCompletionsBase.js

@@ -464,15 +464,22 @@ export class OpenAIChatCompletionsProvider extends BaseProvider {
                         const apiErr = await buildAPIError(url, body, res);
                         // One-shot 400 retry. The overflow corrector runs FIRST (it can
                         // re-fit max_tokens from the provider's own numbers and also
-                        // self-heals the runtime window registry); otherwise a subclass
-                        // may strip a rejected field and return a modified body (e.g.
-                        // NIM's chat_template / reasoning_budget). The retry runs under
-                        // the SAME timeout controller as the first attempt, so the
-                        // configured timeout caps the overall call — matching the
-                        // streaming path, which reuses its composed signal for the retry.
+                        // self-heals the runtime window registry); its output then feeds
+                        // a subclass hook that may strip a rejected field (e.g. NIM's
+                        // chat_template / reasoning_budget), so a body that needs BOTH
+                        // fixes gets both — a plain `??` between the two would let
+                        // whichever ran first silently win and drop the other's fix. The
+                        // retry runs under the SAME timeout controller as the first
+                        // attempt, so the configured timeout caps the overall call —
+                        // matching the streaming path, which reuses its composed signal
+                        // for the retry.
                         const retryBody = res.status === 400
-                            ? (correctBodyAfterContextOverflow(body, apiErr) ??
-                                adjustBodyAfter400(body, apiErr))
+                            ? (() => {
+                                const typedErr = apiErr;
+                                const overflowCorrected = correctBodyAfterContextOverflow(body, typedErr);
+                                return (adjustBodyAfter400(overflowCorrected ?? body, typedErr) ??
+                                    overflowCorrected);
+                            })()
                             : undefined;
                         if (!retryBody) {
                             throw apiErr;
@@ -967,13 +974,18 @@ export class OpenAIChatCompletionsProvider extends BaseProvider {
             // consumed inside doFetch's closure, either returned on success or
             // discarded after buildAPIError read its body on failure.
             const apiErr = err;
-            // Overflow corrector first (re-fits max_tokens from the provider's
-            // own numbers + self-heals the window registry), then the subclass
-            // hook (e.g. NIM strips chat_template / reasoning_budget when a model
-            // rejects them).
+            // Overflow corrector first (re-fits max_tokens from the provider's own
+            // numbers + self-heals the window registry); its output then feeds the
+            // subclass hook (e.g. NIM strips chat_template / reasoning_budget when
+            // a model rejects them), so a body needing BOTH fixes gets both — a
+            // plain `??` between the two would let whichever ran first silently
+            // win and drop the other's fix.
             const retryBody = apiErr.statusCode === 400
-                ? (this.correctBodyAfterContextOverflow(body, apiErr) ??
-                    this.adjustBodyAfter400(body, apiErr))
+                ? (() => {
+                    const overflowCorrected = this.correctBodyAfterContextOverflow(body, apiErr);
+                    return (this.adjustBodyAfter400(overflowCorrected ?? body, apiErr) ??
+                        overflowCorrected);
+                })()
                 : undefined;
             if (!retryBody) {
                 throw apiErr;