@juspay/neurolink 12.5.0 → 12.5.1

package/dist/providers/catalog/loader.js

@@ -0,0 +1,115 @@
+/**
+ * Converts the JSON authoring format into the runtime
+ * OpenAICompatCatalogEntry shape the registry loop consumes. All
+ * knowledge about deriving env vars, template interpolation and error
+ * rule matching lives HERE — the JSON stays declarative.
+ */
+import { CATALOG_JSON_ENTRIES } from "./index.generated.js";
+import { DEFAULT_ERROR_RULES } from "../../utils/errorClassifier.js";
+import { AuthenticationError, RateLimitError, InvalidModelError, NetworkError, ProviderError, } from "../../types/index.js";
+const ERROR_CLASS_MAP = {
+    authentication: AuthenticationError,
+    "rate-limit": RateLimitError,
+    "invalid-model": InvalidModelError,
+    network: NetworkError,
+    provider: ProviderError,
+};
+// Duplicated from tools/codegen-catalog.ts intentionally: src/ must not
+// import from tools/ (build-time tooling depends on runtime source, not the
+// reverse).
+function toCamelCase(id) {
+    return id.replace(/-([a-z])/g, (_m, c) => c.toUpperCase());
+}
+// Resolves the NeurolinkCredentials key for an entry — respects a
+// credentialsKey override (required where the derived camelCase would
+// rename a pre-existing public credential field; see together-ai). Single
+// source of truth shared with codegen's own credentialsKeyFor() so the
+// generated NeurolinkCredentials keys and any runtime consumer (Task 7's
+// descriptors) can never drift from each other.
+export function catalogCredentialsKey(entry) {
+    return entry.credentialsKey ?? toCamelCase(entry.id);
+}
+export function catalogEnvVar(entry, kind) {
+    const override = entry.wire.envOverrides?.[kind];
+    if (override) {
+        return override;
+    }
+    const base = entry.id.toUpperCase().replace(/-/g, "_");
+    return kind === "apiKey"
+        ? `${base}_API_KEY`
+        : kind === "baseURL"
+            ? `${base}_BASE_URL`
+            : `${base}_MODEL`;
+}
+function interpolate(template, entry, modelName) {
+    return template
+        .replace(/\{apiKeyEnvVar\}/g, catalogEnvVar(entry, "apiKey"))
+        .replace(/\{setupUrl\}/g, entry.setup.url)
+        .replace(/\{model\}/g, modelName ?? "");
+}
+export function buildCatalogConfigOptions(entry) {
+    return {
+        providerName: entry.displayName,
+        envVarName: catalogEnvVar(entry, "apiKey"),
+        setupUrl: entry.setup.url,
+        description: entry.setup.description ?? "API key",
+        instructions: entry.setup.instructions.map((line) => interpolate(line, entry)),
+    };
+}
+function buildErrorRules(entry) {
+    const bespoke = entry.errorRules.map((rule) => {
+        const regex = rule.pattern ? new RegExp(rule.pattern, "i") : undefined;
+        return {
+            match: (ctx) => (rule.status !== undefined && ctx.statusCode === rule.status) ||
+                (regex !== undefined && regex.test(ctx.message)),
+            errorClass: ERROR_CLASS_MAP[rule.class],
+            message: rule.message.includes("{model}")
+                ? (ctx) => interpolate(rule.message, entry, ctx.modelName)
+                : interpolate(rule.message, entry),
+        };
+    });
+    return [...bespoke, ...DEFAULT_ERROR_RULES];
+}
+export function getCatalogJsonEntries() {
+    return CATALOG_JSON_ENTRIES;
+}
+export function buildCatalogEntries() {
+    return CATALOG_JSON_ENTRIES.map((entry) => {
+        const base = {
+            providerName: entry.id,
+            aliases: [entry.id, ...entry.aliases],
+            apiKeyEnvVar: catalogEnvVar(entry, "apiKey"),
+            configOptions: buildCatalogConfigOptions(entry),
+            modelEnvVar: catalogEnvVar(entry, "model"),
+            defaultModel: entry.models.default,
+            registryDefaultModel: entry.models.registryDefaultModel ?? entry.models.default,
+            registryDefaultModelChecksEnvVar: entry.quirks?.registryDefaultIgnoresModelEnvVar !== true,
+            fallbackModelName: entry.models.fallbackModelName ??
+                entry.models.fallbacks[1] ??
+                entry.models.fallbacks[0],
+            fallbackModels: [...entry.models.fallbacks],
+            errorRules: buildErrorRules(entry),
+        };
+        const { baseURLTemplate } = entry.wire;
+        if (baseURLTemplate) {
+            // Schema constrains extraCredentials to exactly one entry (Task 1) —
+            // [0] is the whole list by construction, mirroring the deliberately
+            // accountId-shaped runtime computedBaseURL type.
+            const extra = entry.wire.extraCredentials?.[0] ?? "accountId";
+            base.computedBaseURL = {
+                envVar: `${entry.id.toUpperCase().replace(/-/g, "_")}_${extra.replace(/([A-Z])/g, "_$1").toUpperCase()}`,
+                missingValueMessage: entry.wire.missingCredentialMessage ??
+                    `Missing ${extra} for ${entry.displayName}`,
+                build: (value) => baseURLTemplate.replaceAll(`{${extra}}`, value),
+            };
+        }
+        else {
+            base.baseURLEnvVar = catalogEnvVar(entry, "baseURL");
+            base.defaultBaseURL = entry.wire.baseURL;
+        }
+        if (entry.quirks?.timeoutErrorClass === "provider") {
+            base.timeoutErrorClass = ProviderError;
+        }
+        return base;
+    });
+}

package/dist/providers/catalog/mistral.json

@@ -0,0 +1,244 @@
+{
+    "$schema": "./provider-catalog.schema.json",
+    "id": "mistral",
+    "displayName": "Mistral",
+    "aliases": [],
+    "tier": 2,
+    "wire": {
+        "baseURL": "https://api.mistral.ai/v1"
+    },
+    "models": {
+        "default": "mistral-small-2506",
+        "fallbackModelName": "mistral-small-2506",
+        "registryDefaultModel": "mistral-large-latest",
+        "fallbacks": ["mistral-small-2506", "mistral-large-latest"],
+        "defaultContextWindow": 128000,
+        "defaultMaxOutputTokens": 4096,
+        "catalog": {
+            "mistral-large-latest": {
+                "contextWindow": 256000,
+                "vision": true,
+                "status": "production",
+                "description": "Mistral Large (Latest)"
+            },
+            "mistral-large-2512": {
+                "contextWindow": 256000,
+                "vision": true,
+                "status": "production",
+                "description": "Mistral Large 2512"
+            },
+            "mistral-medium-latest": {
+                "contextWindow": 128000,
+                "vision": true,
+                "status": "production",
+                "description": "Mistral Medium (Latest)"
+            },
+            "mistral-medium-2508": {
+                "vision": true,
+                "status": "production",
+                "description": "Mistral Medium 2508"
+            },
+            "mistral-small-latest": {
+                "contextWindow": 128000,
+                "vision": true,
+                "status": "production",
+                "description": "Mistral Small (Latest)"
+            },
+            "mistral-small-2506": {
+                "vision": true,
+                "status": "production",
+                "description": "Recommended - Mistral Small 2506"
+            },
+            "magistral-medium-latest": {
+                "contextWindow": 128000,
+                "vision": true,
+                "status": "production",
+                "description": "Magistral Medium (Reasoning)"
+            },
+            "magistral-small-latest": {
+                "vision": true,
+                "status": "production",
+                "description": "Magistral Small (Reasoning)"
+            },
+            "ministral-14b-2512": {
+                "enumMember": "MINISTRAL_14B_2512",
+                "vision": false,
+                "status": "production",
+                "description": "Ministral 14B (Edge)"
+            },
+            "ministral-8b-2512": {
+                "enumMember": "MINISTRAL_8B_2512",
+                "vision": false,
+                "status": "production",
+                "description": "Ministral 8B (Edge)"
+            },
+            "ministral-3b-2512": {
+                "enumMember": "MINISTRAL_3B_2512",
+                "vision": false,
+                "status": "production",
+                "description": "Ministral 3B (Edge)"
+            },
+            "codestral-latest": {
+                "contextWindow": 256000,
+                "vision": false,
+                "status": "production",
+                "description": "Codestral (Code Generation)"
+            },
+            "codestral-2508": {
+                "contextWindow": 256000,
+                "vision": false,
+                "status": "production",
+                "description": "Codestral 2508 (Code Generation)"
+            },
+            "codestral-embed": {
+                "vision": false,
+                "status": "production",
+                "description": "Codestral Embed"
+            },
+            "devstral-medium-latest": {
+                "vision": false,
+                "status": "production",
+                "description": "Devstral Medium (Software Development)"
+            },
+            "devstral-small-latest": {
+                "vision": false,
+                "status": "production",
+                "description": "Devstral Small (Software Development)"
+            },
+            "pixtral-large": {
+                "vision": true,
+                "status": "retired",
+                "description": "Retired 2026-05-31 — use mistral-medium-latest instead"
+            },
+            "pixtral-12b": {
+                "vision": true,
+                "status": "retired",
+                "description": "Retired 2025-12-31 — use ministral-14b-2512 instead"
+            },
+            "voxtral-small-latest": {
+                "vision": false,
+                "status": "production",
+                "description": "Voxtral Small (Audio)"
+            },
+            "voxtral-mini-latest": {
+                "vision": false,
+                "status": "production",
+                "description": "Voxtral Mini (Audio)"
+            },
+            "devstral-2512": {
+                "enumMember": "DEVSTRAL_2",
+                "contextWindow": 256000,
+                "vision": false,
+                "status": "production",
+                "description": "Devstral 2 (December 2025)"
+            },
+            "devstral-small-2512": {
+                "enumMember": "DEVSTRAL_SMALL_2",
+                "contextWindow": 256000,
+                "vision": false,
+                "status": "production",
+                "description": "Devstral Small 2 (December 2025)"
+            },
+            "magistral-medium-2509": {
+                "vision": true,
+                "status": "production",
+                "description": "Magistral Medium 2509"
+            },
+            "magistral-small-2509": {
+                "vision": true,
+                "status": "production",
+                "description": "Magistral Small 2509"
+            },
+            "voxtral-mini-2602": {
+                "enumMember": "VOXTRAL_MINI_TRANSCRIBE_2",
+                "vision": false,
+                "status": "production",
+                "description": "Voxtral Mini Transcribe 2 (February 2026)"
+            },
+            "mistral-ocr-2512": {
+                "enumMember": "MISTRAL_OCR_3",
+                "vision": false,
+                "status": "production",
+                "description": "Mistral OCR 3 (December 2025)"
+            },
+            "mistral-ocr-latest": {
+                "vision": false,
+                "status": "production",
+                "description": "Mistral OCR (Latest)"
+            },
+            "mistral-nemo": {
+                "vision": false,
+                "status": "production",
+                "description": "Mistral Nemo"
+            },
+            "mistral-embed": {
+                "vision": false,
+                "status": "production",
+                "description": "Mistral Embed"
+            },
+            "mistral-moderation-latest": {
+                "vision": false,
+                "status": "production",
+                "description": "Mistral Moderation (Latest)"
+            },
+            "mistral-small-2603": {
+                "enumMember": "MISTRAL_SMALL_4",
+                "contextWindow": 256000,
+                "vision": true,
+                "status": "production",
+                "description": "Mistral Small 4 (June 2026)"
+            },
+            "mistral-small-creative": {
+                "vision": true,
+                "status": "production",
+                "description": "Mistral Small Creative"
+            }
+        },
+        "topModels": [
+            "mistral-large-latest",
+            "mistral-small-latest",
+            "codestral-latest",
+            "magistral-medium-latest",
+            "mistral-nemo"
+        ]
+    },
+    "capabilities": {
+        "text": true,
+        "streaming": true,
+        "tools": true,
+        "toolsWithStreaming": true,
+        "structuredOutput": true,
+        "structuredOutputWithTools": true,
+        "embeddings": false,
+        "thinking": false
+    },
+    "errorRules": [
+        {
+            "status": 401,
+            "pattern": "API_KEY_INVALID|Invalid API key|Unauthorized",
+            "class": "authentication",
+            "message": "Invalid Mistral API key. Please check your {apiKeyEnvVar} environment variable."
+        }
+    ],
+    "quirks": {
+        "registryDefaultIgnoresModelEnvVar": true
+    },
+    "setup": {
+        "url": "https://console.mistral.ai/",
+        "apiKeyFormat": null,
+        "billingPolicy": "free-with-card",
+        "instructions": [
+            "1. Visit: https://console.mistral.ai/",
+            "2. Create or sign in to your account",
+            "3. Generate a new API key"
+        ]
+    },
+    "evidence": {
+        "rosterVerified": {
+            "date": "2026-08-28",
+            "method": "transcribed from pre-migration TS catalog"
+        },
+        "liveMatrix": null,
+        "addedInPR": "https://github.com/juspay/neurolink/pull/1587"
+    }
+}

package/dist/providers/catalog/perplexity.json

@@ -0,0 +1,103 @@
+{
+    "$schema": "./provider-catalog.schema.json",
+    "id": "perplexity",
+    "displayName": "Perplexity",
+    "aliases": ["pplx"],
+    "tier": 2,
+    "wire": {
+        "baseURL": "https://api.perplexity.ai"
+    },
+    "models": {
+        "default": "sonar",
+        "fallbacks": [
+            "sonar",
+            "sonar-pro",
+            "sonar-reasoning",
+            "sonar-reasoning-pro",
+            "sonar-deep-research"
+        ],
+        "defaultContextWindow": 127000,
+        "defaultMaxOutputTokens": 4096,
+        "catalog": {
+            "sonar": {
+                "contextWindow": 127000,
+                "pricingPerMTok": { "input": 1.0, "output": 1.0 },
+                "vision": false,
+                "status": "production",
+                "description": "Recommended - Sonar with web grounding"
+            },
+            "sonar-pro": {
+                "contextWindow": 200000,
+                "pricingPerMTok": { "input": 3.0, "output": 15.0 },
+                "vision": false,
+                "status": "production",
+                "description": "Better reasoning"
+            },
+            "sonar-reasoning": {
+                "contextWindow": 127000,
+                "pricingPerMTok": { "input": 1.0, "output": 5.0 },
+                "vision": false,
+                "status": "production",
+                "description": "Explicit reasoning traces"
+            },
+            "sonar-reasoning-pro": {
+                "contextWindow": 127000,
+                "pricingPerMTok": { "input": 2.0, "output": 8.0 },
+                "vision": false,
+                "status": "production",
+                "description": "Flagship reasoning + web"
+            },
+            "sonar-deep-research": {
+                "contextWindow": 200000,
+                "pricingPerMTok": { "input": 2.0, "output": 8.0 },
+                "vision": false,
+                "status": "production",
+                "description": "Long-form research with citations"
+            }
+        },
+        "topModels": [
+            "sonar",
+            "sonar-pro",
+            "sonar-reasoning",
+            "sonar-reasoning-pro",
+            "sonar-deep-research"
+        ]
+    },
+    "capabilities": {
+        "text": true,
+        "streaming": true,
+        "tools": true,
+        "toolsWithStreaming": true,
+        "structuredOutput": false,
+        "structuredOutputWithTools": false,
+        "embeddings": false,
+        "thinking": false
+    },
+    "errorRules": [
+        {
+            "status": 401,
+            "pattern": "Invalid API key|Authentication",
+            "class": "authentication",
+            "message": "Invalid Perplexity API key. Get one at https://www.perplexity.ai/settings/api"
+        }
+    ],
+    "setup": {
+        "url": "https://www.perplexity.ai/settings/api",
+        "apiKeyFormat": null,
+        "billingPolicy": "no-free-tier",
+        "instructions": [
+            "1. Visit: https://www.perplexity.ai/settings/api",
+            "2. Sign in to your Perplexity account",
+            "3. Create a new API key (Sonar tier)",
+            "4. Set {apiKeyEnvVar} in your .env file"
+        ]
+    },
+    "evidence": {
+        "rosterVerified": {
+            "date": "2026-08-28",
+            "method": "transcribed from pre-migration TS catalog"
+        },
+        "liveMatrix": null,
+        "addedInPR": "https://github.com/juspay/neurolink/pull/1587"
+    }
+}