@juspay/neurolink 11.1.0 → 11.2.0

package/dist/cli/commands/setup.d.ts

@@ -28,4 +28,7 @@ export declare function checkExistingConfigurations(): Promise<string[]>;
 /**
  * Delegate to existing provider setup commands
  */
-export declare function delegateToProviderSetup(providerId: string): Promise<void>;
+export declare function delegateToProviderSetup(providerId: string, flags?: {
+    check?: boolean;
+    nonInteractive?: boolean;
+}): Promise<void>;

package/dist/cli/commands/setup.js

@@ -20,7 +20,7 @@ import { handleGCPSetup } from "./setup-gcp.js";
 import { handleHuggingFaceSetup } from "./setup-huggingface.js";
 import { handleMistralSetup } from "./setup-mistral.js";
 import { PROVIDER_DESCRIPTORS_BY_NAME } from "../../lib/factories/providerDescriptors.js";
-import { createCloudflareConfig, createCohereConfig, createDeepSeekConfig, createFireworksConfig, createGroqConfig, createIdeogramConfig, createJinaConfig, createNvidiaNimConfig, createOpenAICompatibleConfig, createPerplexityConfig, createRecraftConfig, createReplicateConfig, createStabilityConfig, createTogetherAIConfig, createVoyageConfig, createXaiConfig, } from "../../lib/utils/providerConfig.js";
+import { createCloudflareConfig, createCohereConfig, createDeepSeekConfig, createFireworksConfig, createGroqConfig, createIdeogramConfig, createJinaConfig, createNvidiaNimConfig, createOpenAICompatibleConfig, createPerplexityConfig, createRecraftConfig, createReplicateConfig, createStabilityConfig, createTogetherAIConfig, createVoyageConfig, createXaiConfig, satisfiesFallbacks, } from "../../lib/utils/providerConfig.js";
 // Provider information database
 const PROVIDERS = [
     {
@@ -277,15 +277,22 @@ function printGenericProviderSetup(providerId, config) {
  */
 export async function handleSetup(argv) {
     try {
-        // Handle specific flags
+        // Handle specific flags. `--list`/`--status` are documented as one-shot,
+        // non-interactive informational commands (see the `setup --list` /
+        // `setup --status` examples in setupCommandFactory.ts) — pass
+        // interactive: false so they print and return instead of chaining into
+        // the wizard's follow-up inquirer prompt below.
         if (argv.list) {
-            return await showProviderList();
+            return await showProviderList(false);
         }
         if (argv.status) {
-            return await showProviderStatus();
+            return await showProviderStatus(false);
         }
         if (argv.provider && argv.provider !== "auto") {
-            return await delegateToProviderSetup(argv.provider);
+            return await delegateToProviderSetup(argv.provider, {
+                check: argv.check,
+                nonInteractive: argv.nonInteractive,
+            });
         }
         // Main setup wizard
         await showWelcomeScreen();
@@ -399,7 +406,7 @@ export async function checkExistingConfigurations() {
             continue;
         }
         const requiredOk = (extraRequired ?? []).every((v) => !!process.env[v]) ||
-            (extraRequiredFallbacks ?? []).some((v) => !!process.env[v]);
+            satisfiesFallbacks(extraRequiredFallbacks, process.env);
         if (requiredOk) {
             configured.push(p.id);
         }
@@ -482,11 +489,16 @@ async function runProviderSelection() {
 /**
  * Delegate to existing provider setup commands
  */
-export async function delegateToProviderSetup(providerId) {
+export async function delegateToProviderSetup(providerId, flags = {
+    check: false,
+    nonInteractive: false,
+}) {
+    const nonInteractive = flags.nonInteractive ?? false;
+    const check = flags.check ?? false;
     const setupArgs = {
-        nonInteractive: false,
-        "non-interactive": false,
-        check: false,
+        nonInteractive,
+        "non-interactive": nonInteractive,
+        check,
         _: [],
         $0: "neurolink",
     };
@@ -580,9 +592,15 @@ async function showSetupCompletion(providerId) {
     logger.always(chalk.blue("Happy generating! 🚀"));
 }
 /**
- * Show detailed provider information
+ * Show detailed provider information.
+ *
+ * @param interactive - When true (the default, used by the interactive
+ * wizard's "learn more" menu choice), follows up with a prompt offering to
+ * launch the setup wizard. When false (used by the direct `setup --list`
+ * flag), returns immediately after printing so the command exits cleanly
+ * without waiting on stdin.
  */
-async function showProviderList() {
+async function showProviderList(interactive = true) {
     logger.always(chalk.blue("📚 NeuroLink Supported AI Providers"));
     logger.always("");
     for (const provider of PROVIDERS) {
@@ -612,6 +630,9 @@ async function showProviderList() {
     logger.always("• neurolink setup --provider azure");
     logger.always("• neurolink setup --provider bedrock");
     logger.always("");
+    if (!interactive) {
+        return;
+    }
     const { action } = await inquirer.prompt([
         {
             type: "select",
@@ -628,9 +649,15 @@ async function showProviderList() {
     }
 }
 /**
- * Show provider status with detailed information
+ * Show provider status with detailed information.
+ *
+ * @param interactive - When true (the default, used by the interactive
+ * wizard's "check status" menu choice), follows up with a prompt offering to
+ * set up another provider. When false (used by the direct `setup --status`
+ * flag), returns immediately after printing so the command exits cleanly
+ * without waiting on stdin.
  */
-async function showProviderStatus() {
+async function showProviderStatus(interactive = true) {
     const spinner = ora("🔍 Checking all AI provider configurations...").start();
     try {
         // Get provider status using NeuroLink SDK
@@ -691,6 +718,9 @@ async function showProviderStatus() {
             logger.always("• Check performance: neurolink provider status");
             logger.always("");
         }
+        if (!interactive) {
+            return;
+        }
         const { setupAnother } = await inquirer.prompt([
             {
                 type: "confirm",

package/dist/constants/networkErrorCodes.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Error codes that indicate a transient transport failure (dropped
+ * connection, socket reset, connect timeout) rather than a permanent
+ * misconfiguration. Shared between `proxy/proxyFetch.ts` (retry gating) and
+ * `utils/errorClassifier.ts` (NetworkError classification) so both stay in
+ * sync — a second hand-maintained copy would drift the two apart the same
+ * way the "5xx literal text vs statusCode" split did.
+ *
+ * undici's native `fetch()` wraps the real transport failure in
+ * `TypeError: fetch failed`, with the actionable code on `error.cause`
+ * (sometimes nested another level deep, e.g. a SocketError inside a
+ * ConnectTimeoutError) — never on the outer TypeError itself.
+ */
+export declare const TRANSIENT_NETWORK_CODES: ReadonlySet<string>;

package/dist/constants/networkErrorCodes.js

@@ -0,0 +1,21 @@
+/**
+ * Error codes that indicate a transient transport failure (dropped
+ * connection, socket reset, connect timeout) rather than a permanent
+ * misconfiguration. Shared between `proxy/proxyFetch.ts` (retry gating) and
+ * `utils/errorClassifier.ts` (NetworkError classification) so both stay in
+ * sync — a second hand-maintained copy would drift the two apart the same
+ * way the "5xx literal text vs statusCode" split did.
+ *
+ * undici's native `fetch()` wraps the real transport failure in
+ * `TypeError: fetch failed`, with the actionable code on `error.cause`
+ * (sometimes nested another level deep, e.g. a SocketError inside a
+ * ConnectTimeoutError) — never on the outer TypeError itself.
+ */
+export const TRANSIENT_NETWORK_CODES = new Set([
+    "ECONNRESET",
+    "ETIMEDOUT",
+    "ECONNREFUSED",
+    "EPIPE",
+    "UND_ERR_SOCKET",
+    "UND_ERR_CONNECT_TIMEOUT",
+]);

package/dist/factories/providerDescriptors.js

@@ -26,6 +26,9 @@ export const PROVIDER_DESCRIPTORS = [
         timeouts: { generateMs: 45_000, streamMs: 120_000 },
         autoSelectPriority: 7,
         apiKeyFormatPattern: API_KEY_FORMATS.bedrock,
+        // Falls back to the AWS SDK's own default credential chain (shared
+        // profile, IAM role) when these env vars are absent — see field JSDoc.
+        credentialsResolvedExternally: true,
     },
     {
         name: AIProviderName.OPENAI,
@@ -89,12 +92,14 @@ export const PROVIDER_DESCRIPTORS = [
             // priority than GOOGLE_APPLICATION_CREDENTIALS by the real gating
             // logic (hasGoogleCredentials() in googleVertex/client.ts and
             // googleVertex/utils.ts) — corrected here vs. the plan snippet, which
-            // omitted it.
+            // omitted it. GOOGLE_AUTH_CLIENT_EMAIL and GOOGLE_AUTH_PRIVATE_KEY are
+            // nested together because hasGoogleCredentials() only accepts them as
+            // a pair — either alone is not valid auth, unlike the other flat
+            // entries here which are each independently sufficient.
             extraRequiredFallbacks: [
                 "GOOGLE_APPLICATION_CREDENTIALS_NEUROLINK",
                 "GOOGLE_SERVICE_ACCOUNT_KEY",
-                "GOOGLE_AUTH_CLIENT_EMAIL",
-                "GOOGLE_AUTH_PRIVATE_KEY",
+                ["GOOGLE_AUTH_CLIENT_EMAIL", "GOOGLE_AUTH_PRIVATE_KEY"],
             ],
         },
         defaultModel: VertexModels.CLAUDE_4_6_SONNET,
@@ -104,6 +109,9 @@ export const PROVIDER_DESCRIPTORS = [
         setupUrl: "https://console.cloud.google.com/",
         timeouts: { generateMs: 60_000, streamMs: 120_000 },
         autoSelectPriority: 3,
+        // OR-of-multiple-auth-paths (file / individual fields / base64 key) —
+        // not a flat AND-list of required env vars. See field JSDoc.
+        credentialsResolvedExternally: true,
     },
     {
         name: AIProviderName.ANTHROPIC,
@@ -241,6 +249,8 @@ export const PROVIDER_DESCRIPTORS = [
         setupUrl: "https://docs.litellm.ai/docs/proxy/quick_start",
         timeouts: { generateMs: 300_000, streamMs: 120_000 },
         autoSelectPriority: 1,
+        // Documented zero-config local proxy — see field JSDoc.
+        credentialsResolvedExternally: true,
     },
     {
         name: AIProviderName.SAGEMAKER,

package/dist/lib/constants/networkErrorCodes.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Error codes that indicate a transient transport failure (dropped
+ * connection, socket reset, connect timeout) rather than a permanent
+ * misconfiguration. Shared between `proxy/proxyFetch.ts` (retry gating) and
+ * `utils/errorClassifier.ts` (NetworkError classification) so both stay in
+ * sync — a second hand-maintained copy would drift the two apart the same
+ * way the "5xx literal text vs statusCode" split did.
+ *
+ * undici's native `fetch()` wraps the real transport failure in
+ * `TypeError: fetch failed`, with the actionable code on `error.cause`
+ * (sometimes nested another level deep, e.g. a SocketError inside a
+ * ConnectTimeoutError) — never on the outer TypeError itself.
+ */
+export declare const TRANSIENT_NETWORK_CODES: ReadonlySet<string>;

package/dist/lib/constants/networkErrorCodes.js

@@ -0,0 +1,22 @@
+/**
+ * Error codes that indicate a transient transport failure (dropped
+ * connection, socket reset, connect timeout) rather than a permanent
+ * misconfiguration. Shared between `proxy/proxyFetch.ts` (retry gating) and
+ * `utils/errorClassifier.ts` (NetworkError classification) so both stay in
+ * sync — a second hand-maintained copy would drift the two apart the same
+ * way the "5xx literal text vs statusCode" split did.
+ *
+ * undici's native `fetch()` wraps the real transport failure in
+ * `TypeError: fetch failed`, with the actionable code on `error.cause`
+ * (sometimes nested another level deep, e.g. a SocketError inside a
+ * ConnectTimeoutError) — never on the outer TypeError itself.
+ */
+export const TRANSIENT_NETWORK_CODES = new Set([
+    "ECONNRESET",
+    "ETIMEDOUT",
+    "ECONNREFUSED",
+    "EPIPE",
+    "UND_ERR_SOCKET",
+    "UND_ERR_CONNECT_TIMEOUT",
+]);
+//# sourceMappingURL=networkErrorCodes.js.map

package/dist/lib/factories/providerDescriptors.js

@@ -26,6 +26,9 @@ export const PROVIDER_DESCRIPTORS = [
         timeouts: { generateMs: 45_000, streamMs: 120_000 },
         autoSelectPriority: 7,
         apiKeyFormatPattern: API_KEY_FORMATS.bedrock,
+        // Falls back to the AWS SDK's own default credential chain (shared
+        // profile, IAM role) when these env vars are absent — see field JSDoc.
+        credentialsResolvedExternally: true,
     },
     {
         name: AIProviderName.OPENAI,
@@ -89,12 +92,14 @@ export const PROVIDER_DESCRIPTORS = [
             // priority than GOOGLE_APPLICATION_CREDENTIALS by the real gating
             // logic (hasGoogleCredentials() in googleVertex/client.ts and
             // googleVertex/utils.ts) — corrected here vs. the plan snippet, which
-            // omitted it.
+            // omitted it. GOOGLE_AUTH_CLIENT_EMAIL and GOOGLE_AUTH_PRIVATE_KEY are
+            // nested together because hasGoogleCredentials() only accepts them as
+            // a pair — either alone is not valid auth, unlike the other flat
+            // entries here which are each independently sufficient.
             extraRequiredFallbacks: [
                 "GOOGLE_APPLICATION_CREDENTIALS_NEUROLINK",
                 "GOOGLE_SERVICE_ACCOUNT_KEY",
-                "GOOGLE_AUTH_CLIENT_EMAIL",
-                "GOOGLE_AUTH_PRIVATE_KEY",
+                ["GOOGLE_AUTH_CLIENT_EMAIL", "GOOGLE_AUTH_PRIVATE_KEY"],
             ],
         },
         defaultModel: VertexModels.CLAUDE_4_6_SONNET,
@@ -104,6 +109,9 @@ export const PROVIDER_DESCRIPTORS = [
         setupUrl: "https://console.cloud.google.com/",
         timeouts: { generateMs: 60_000, streamMs: 120_000 },
         autoSelectPriority: 3,
+        // OR-of-multiple-auth-paths (file / individual fields / base64 key) —
+        // not a flat AND-list of required env vars. See field JSDoc.
+        credentialsResolvedExternally: true,
     },
     {
         name: AIProviderName.ANTHROPIC,
@@ -241,6 +249,8 @@ export const PROVIDER_DESCRIPTORS = [
         setupUrl: "https://docs.litellm.ai/docs/proxy/quick_start",
         timeouts: { generateMs: 300_000, streamMs: 120_000 },
         autoSelectPriority: 1,
+        // Documented zero-config local proxy — see field JSDoc.
+        credentialsResolvedExternally: true,
     },
     {
         name: AIProviderName.SAGEMAKER,

package/dist/lib/processors/base/BaseFileProcessor.d.ts

@@ -45,6 +45,23 @@
  */
 import { FileErrorCode } from "../errors/index.js";
 import type { BatchProcessingSummary, FileInfo, FileProcessingError, ProcessorFileProcessingResult, FileProcessorConfig, ProcessorOperationResult, ProcessedFileBase, ProcessOptions } from "../../types/index.js";
+/**
+ * Marker on the error raised when a processor refuses content for exceeding
+ * the size limit *after* the download — a ZIP entry that expands past the
+ * bound, say.
+ *
+ * Separate from DOWNLOAD_TOO_LARGE because the two fire at different stages,
+ * but it exists for the same reason. Without it a bound that fires reaches
+ * `buildProcessedResultWithResult` as a plain Error and becomes
+ * PROCESSING_FAILED, which is `retryable: true` — so a caller retries a
+ * deterministic refusal three times and gets the identical answer each time.
+ * FILE_TOO_LARGE is `retryable: false`, which is the truth about this failure.
+ */
+export declare const CONTENT_TOO_LARGE_CODE = "CONTENT_TOO_LARGE";
+/** An error that a processor's own size bound was exceeded. */
+export declare function contentTooLargeError(message: string): Error;
+/** Whether `error` is a processor size bound firing rather than a fault. */
+export declare function isContentTooLarge(error: unknown): boolean;
 /**
  * Abstract base class for file processors.
  * Provides common download, validation, and error handling functionality.

package/dist/lib/processors/base/BaseFileProcessor.js

@@ -72,6 +72,29 @@ function downloadTooLargeError(maxSizeMB, typeName) {
 function isDownloadTooLarge(error) {
     return (error?.code === DOWNLOAD_TOO_LARGE_CODE);
 }
+/**
+ * Marker on the error raised when a processor refuses content for exceeding
+ * the size limit *after* the download — a ZIP entry that expands past the
+ * bound, say.
+ *
+ * Separate from DOWNLOAD_TOO_LARGE because the two fire at different stages,
+ * but it exists for the same reason. Without it a bound that fires reaches
+ * `buildProcessedResultWithResult` as a plain Error and becomes
+ * PROCESSING_FAILED, which is `retryable: true` — so a caller retries a
+ * deterministic refusal three times and gets the identical answer each time.
+ * FILE_TOO_LARGE is `retryable: false`, which is the truth about this failure.
+ */
+export const CONTENT_TOO_LARGE_CODE = "CONTENT_TOO_LARGE";
+/** An error that a processor's own size bound was exceeded. */
+export function contentTooLargeError(message) {
+    const error = new Error(message);
+    error.code = CONTENT_TOO_LARGE_CODE;
+    return error;
+}
+/** Whether `error` is a processor size bound firing rather than a fault. */
+export function isContentTooLarge(error) {
+    return (error?.code === CONTENT_TOO_LARGE_CODE);
+}
 /** Node's signal that a zlib output bound was reached. */
 function isBufferTooLargeError(error) {
     return (error?.code === "ERR_BUFFER_TOO_LARGE");
@@ -360,6 +383,23 @@ export class BaseFileProcessor {
             return { success: true, data: result };
         }
         catch (error) {
+            // A size bound firing is a verdict, not a fault: PROCESSING_FAILED is
+            // retryable, and re-running a decompression that will hit the same
+            // ceiling is the one thing worth not doing three times.
+            if (isContentTooLarge(error)) {
+                return {
+                    success: false,
+                    // Same detail keys as the other FILE_TOO_LARGE sites, so anything
+                    // reading them does not have to special-case where the verdict came
+                    // from. `sizeMB` is absent on purpose: the decompressed size is the
+                    // number this bound exists to never find out.
+                    error: this.createError(FileErrorCode.FILE_TOO_LARGE, {
+                        maxMB: this.config.maxSizeMB,
+                        type: this.config.fileTypeName,
+                        reason: error instanceof Error ? error.message : undefined,
+                    }),
+                };
+            }
             return {
                 success: false,
                 error: this.createError(FileErrorCode.PROCESSING_FAILED, { fileType: this.config.fileTypeName }, error instanceof Error ? error : undefined),

package/dist/lib/processors/document/OpenDocumentProcessor.js

@@ -8,7 +8,7 @@
  */
 import { createRequire } from "node:module";
 import * as zlib from "node:zlib";
-import { BaseFileProcessor } from "../base/BaseFileProcessor.js";
+import { BaseFileProcessor, contentTooLargeError, isContentTooLarge, } from "../base/BaseFileProcessor.js";
 import { readZipEntryWithinLimit } from "../archive/zipEntryReader.js";
 import { SIZE_LIMITS } from "../config/index.js";
 const require = createRequire(import.meta.url);
@@ -71,7 +71,10 @@ export class OpenDocumentProcessor extends BaseFileProcessor {
                 // `maxSizeMB` only ever saw the compressed archive on the way in.
                 const read = readZipEntryWithinLimit(contentEntry, SIZE_LIMITS.DOCUMENT_MAX_MB * 1024 * 1024, zlib);
                 if (read.status === "too-large") {
-                    throw new Error(`content.xml exceeds the ${SIZE_LIMITS.DOCUMENT_MAX_MB}MB limit for OpenDocument content`);
+                    // Coded, so the bound surfaces as FILE_TOO_LARGE (not retryable)
+                    // rather than PROCESSING_FAILED (retryable). The file will be
+                    // exactly as oversized on the next attempt.
+                    throw contentTooLargeError(`content.xml in "${this.getFilename(fileInfo)}" exceeds the ${SIZE_LIMITS.DOCUMENT_MAX_MB}MB limit for OpenDocument content`);
                 }
                 if (read.status !== "ok") {
                     throw new Error("content.xml could not be read from the archive");
@@ -93,6 +96,13 @@ export class OpenDocumentProcessor extends BaseFileProcessor {
             }
         }
         catch (error) {
+            // A size verdict passes through intact. Re-wrapping it as a plain Error
+            // drops the code, and the base class then reports PROCESSING_FAILED —
+            // which is retryable, so the caller would refetch and decompress a file
+            // guaranteed to be exactly as oversized.
+            if (isContentTooLarge(error)) {
+                throw error;
+            }
             const message = error instanceof Error ? error.message : "Unknown error";
             throw new Error(`Failed to extract OpenDocument content: ${message}`, {
                 cause: error,

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

@@ -0,0 +1,24 @@
+import type { AIProviderName } from "../constants/enums.js";
+import type { OpenAICompatCatalogEntry, OpenAICompatCredentials } from "../types/index.js";
+import { OpenAIChatCompletionsProvider } from "./openaiChatCompletionsBase.js";
+/**
+ * Generic OpenAI-compatible provider driven entirely by an
+ * OpenAICompatCatalogEntry. Replaces a hand-written subclass for any
+ * provider whose only differences from its siblings are credentials, base
+ * URL, model defaults, and error-classification rules — see
+ * OPENAI_COMPAT_CATALOG in openaiCompatCatalog.ts for the entries.
+ *
+ * If a provider needs a real hook override (adjustRequestBody,
+ * adjustBodyAfter400, getChatCompletionsURL, getAuthHeaders,
+ * suppressResponseFormatWithTools, ...) it does NOT belong in the catalog —
+ * write a dedicated subclass instead (see deepseek.ts, azureOpenai.ts).
+ */
+export declare class ConfiguredOpenAICompatProvider extends OpenAIChatCompletionsProvider {
+    private readonly entry;
+    constructor(entry: OpenAICompatCatalogEntry, modelName?: string, sdk?: unknown, credentials?: OpenAICompatCredentials);
+    protected getProviderName(): AIProviderName;
+    protected getDefaultModel(): string;
+    protected getFallbackModelName(): string;
+    protected getFallbackModels(): string[];
+    protected formatProviderError(error: unknown): Error;
+}

package/dist/lib/providers/configuredOpenAICompat.js

@@ -0,0 +1,60 @@
+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 { OpenAIChatCompletionsProvider } from "./openaiChatCompletionsBase.js";
+/**
+ * Generic OpenAI-compatible provider driven entirely by an
+ * OpenAICompatCatalogEntry. Replaces a hand-written subclass for any
+ * provider whose only differences from its siblings are credentials, base
+ * URL, model defaults, and error-classification rules — see
+ * OPENAI_COMPAT_CATALOG in openaiCompatCatalog.ts for the entries.
+ *
+ * If a provider needs a real hook override (adjustRequestBody,
+ * adjustBodyAfter400, getChatCompletionsURL, getAuthHeaders,
+ * suppressResponseFormatWithTools, ...) it does NOT belong in the catalog —
+ * write a dedicated subclass instead (see deepseek.ts, azureOpenai.ts).
+ */
+export class ConfiguredOpenAICompatProvider extends OpenAIChatCompletionsProvider {
+    entry;
+    constructor(entry, modelName, sdk, credentials) {
+        const { apiKey, baseURL } = resolveOpenAICompatConfig(entry, credentials);
+        // BaseProvider's constructor calls `this.getDefaultModel()` /
+        // `this.getProviderName()` synchronously inside `super()`, before this
+        // class's own constructor body (or field initializers) ever run — so
+        // `this.entry` is not yet assigned at that point and those overrides
+        // would read `undefined.modelEnvVar`. `entry.providerName` is always
+        // defined, so passing it straight through makes the base constructor's
+        // `providerName || this.getProviderName()` short-circuit; resolving the
+        // model up front and always passing a truthy `modelName` does the same
+        // for `getDefaultModel()`. Both overrides remain correct for any call
+        // made after construction, once `this.entry` is set below.
+        const resolvedModelName = modelName || getProviderModel(entry.modelEnvVar, entry.defaultModel);
+        super(entry.providerName, resolvedModelName, sdk, { baseURL, apiKey });
+        this.entry = entry;
+        logger.debug(`${entry.configOptions.providerName} Provider initialized`, {
+            modelName: this.modelName,
+            providerName: this.providerName,
+            baseURL: redactUrlCredentials(this.config.baseURL),
+        });
+    }
+    getProviderName() {
+        return this.entry.providerName;
+    }
+    getDefaultModel() {
+        return getProviderModel(this.entry.modelEnvVar, this.entry.defaultModel);
+    }
+    getFallbackModelName() {
+        return this.entry.fallbackModelName;
+    }
+    getFallbackModels() {
+        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.
+        return classifyProviderError(error, this.entry.errorRules, this.entry.providerName, this.modelName);
+    }
+}
+//# sourceMappingURL=configuredOpenAICompat.js.map

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

@@ -0,0 +1,24 @@
+import type { OpenAICompatCatalogEntry } from "../types/index.js";
+/**
+ * Config-driven catalog of the 7 zero-quirk OpenAI-compatible providers.
+ * Each entry fully replaces what used to be a hand-written
+ * OpenAIChatCompletionsProvider subclass — see ConfiguredOpenAICompatProvider
+ * for the class that reads these entries, and providerRegistry.ts for the
+ * registration loop that consumes this array.
+ *
+ * `errorRules` mirrors each provider's LIVE `formatProviderError` rule array
+ * (post plan-07/wave-2 migration), not the original hand-rolled ladder these
+ * providers had when plan 05 was first drafted: every provider below now
+ * keeps only its bespoke rule(s) — auth, plus Groq's model_decommissioned and
+ * xAI's insufficient_quota — before spreading the SAME exported
+ * `DEFAULT_ERROR_RULES` constant that the live subclasses spread (never an
+ * inlined copy, so this catalog cannot drift from that table independently).
+ * See plan-05/progress.md Ruling R4 for the full rationale.
+ *
+ * To add a new zero-quirk OpenAI-compatible provider: add one entry here.
+ * Do NOT add a provider here if it needs any hook override beyond the 3
+ * mandatory ones (getProviderName/getDefaultModel/formatProviderError) —
+ * write a dedicated subclass instead (see deepseek.ts, azureOpenai.ts, and
+ * Task 14's docs task for the deciding criteria).
+ */
+export declare const OPENAI_COMPAT_CATALOG: readonly OpenAICompatCatalogEntry[];