@juspay/neurolink 12.5.0 → 12.5.2

package/dist/models/manifestRegistry.js

@@ -1,4 +1,5 @@
 import { PROVIDER_MAX_TOKENS } from "../core/constants.js";
+import { getCatalogJsonEntries } from "../providers/catalog/loader.js";
 import { anthropicManifest } from "./manifests/anthropic.js";
 import { openaiManifest } from "./manifests/openai.js";
 import { azureManifest } from "./manifests/azure.js";
@@ -18,8 +19,6 @@ import { lmStudioManifest } from "./manifests/lm-studio.js";
 import { llamacppManifest } from "./manifests/llamacpp.js";
 import { xaiManifest } from "./manifests/xai.js";
 import { groqManifest } from "./manifests/groq.js";
-import { cerebrasManifest } from "./manifests/cerebras.js";
-import { sambanovaManifest } from "./manifests/sambanova.js";
 import { cohereManifest } from "./manifests/cohere.js";
 import { togetherAiManifest } from "./manifests/together-ai.js";
 import { fireworksManifest } from "./manifests/fireworks.js";
@@ -31,6 +30,56 @@ import { jinaManifest } from "./manifests/jina.js";
 import { stabilityManifest } from "./manifests/stability.js";
 import { ideogramManifest } from "./manifests/ideogram.js";
 import { recraftManifest } from "./manifests/recraft.js";
+/**
+ * Builds a manifest for a JSON-catalog provider from its catalog entry.
+ *
+ * Only used for cerebras and sambanova (see MANIFEST_REGISTRY below) — the
+ * catalog JSON carries no per-model `maxOutputTokens`, only a provider-wide
+ * `models.defaultMaxOutputTokens`, so every derived entry uses that ceiling.
+ * For cerebras/sambanova this is 8192, identical to their old hand-written
+ * manifests' `maxOutputTokens`. The other 7 catalog providers' hand
+ * manifests carry higher documented ceilings — 64000 for groq, xai,
+ * together-ai, fireworks and perplexity, 8192 for mistral and cloudflare —
+ * that the JSON's `defaultMaxOutputTokens` (a generic 4096 placeholder for
+ * all 7) would silently regress, so they stay hand-written, untouched.
+ *
+ * `contextWindow` falls back to `models.defaultContextWindow` when a model
+ * spec omits its own (matches resolveManifestEntry's synthesized-`_default`
+ * fallback pattern above). `aliases` is always `[]` — CatalogModelSpec has
+ * no alias field.
+ */
+function buildCatalogManifest(entry) {
+    const namedModels = Object.fromEntries(Object.entries(entry.models.catalog).map(([modelId, spec]) => [
+        modelId,
+        {
+            aliases: [],
+            contextWindow: spec.contextWindow ?? entry.models.defaultContextWindow,
+            maxOutputTokens: entry.models.defaultMaxOutputTokens,
+            vision: spec.vision,
+            functionCalling: entry.capabilities.tools,
+        },
+    ]));
+    return {
+        defaultContextWindow: entry.models.defaultContextWindow,
+        models: {
+            _default: {
+                aliases: [],
+                contextWindow: entry.models.defaultContextWindow,
+                maxOutputTokens: entry.models.defaultMaxOutputTokens,
+                vision: false,
+                functionCalling: entry.capabilities.tools,
+            },
+            ...namedModels,
+        },
+    };
+}
+const catalogManifest = (id) => {
+    const entry = getCatalogJsonEntries().find((e) => e.id === id);
+    if (!entry) {
+        throw new Error(`No catalog JSON entry found for provider "${id}"`);
+    }
+    return buildCatalogManifest(entry);
+};
 /**
  * Every provider's model manifest, keyed by the exact AIProviderName enum
  * value (kebab-case) — e.g. "google-ai", "nvidia-nim". Manifests are pure
@@ -58,8 +107,8 @@ export const MANIFEST_REGISTRY = {
     llamacpp: llamacppManifest,
     xai: xaiManifest,
     groq: groqManifest,
-    cerebras: cerebrasManifest,
-    sambanova: sambanovaManifest,
+    cerebras: catalogManifest("cerebras"),
+    sambanova: catalogManifest("sambanova"),
     cohere: cohereManifest,
     "together-ai": togetherAiManifest,
     fireworks: fireworksManifest,

package/dist/providers/catalog/cerebras.json

@@ -0,0 +1,75 @@
+{
+    "$schema": "./provider-catalog.schema.json",
+    "id": "cerebras",
+    "displayName": "Cerebras",
+    "aliases": [],
+    "tier": 2,
+    "wire": {
+        "baseURL": "https://api.cerebras.ai/v1"
+    },
+    "models": {
+        "default": "gpt-oss-120b",
+        "fallbacks": ["gpt-oss-120b", "gemma-4-31b"],
+        "defaultContextWindow": 65536,
+        "defaultMaxOutputTokens": 8192,
+        "catalog": {
+            "gpt-oss-120b": {
+                "contextWindow": 65536,
+                "pricingPerMTok": { "input": 0.35, "output": 0.75 },
+                "vision": false,
+                "status": "production",
+                "description": "Recommended - OpenAI GPT-OSS 120B (open-weight); wafer-scale speed"
+            },
+            "gemma-4-31b": {
+                "contextWindow": 65536,
+                "pricingPerMTok": { "input": 0.99, "output": 1.49 },
+                "vision": false,
+                "status": "production",
+                "description": "Google Gemma 4 31B"
+            }
+        },
+        "topModels": ["gpt-oss-120b", "gemma-4-31b"]
+    },
+    "capabilities": {
+        "text": true,
+        "streaming": true,
+        "tools": true,
+        "toolsWithStreaming": true,
+        "structuredOutput": true,
+        "structuredOutputWithTools": false,
+        "embeddings": false,
+        "thinking": false
+    },
+    "errorRules": [
+        {
+            "status": 401,
+            "pattern": "wrong_api_key|Wrong API Key|invalid_api_key",
+            "class": "authentication",
+            "message": "Invalid Cerebras API key. Check {apiKeyEnvVar}. Get one at https://cloud.cerebras.ai"
+        }
+    ],
+    "setup": {
+        "url": "https://cloud.cerebras.ai",
+        "apiKeyFormat": null,
+        "billingPolicy": "free-with-card",
+        "instructions": [
+            "1. Visit: https://cloud.cerebras.ai",
+            "2. Sign in or create a free Cerebras account",
+            "3. Create an API key under API Keys",
+            "4. Set {apiKeyEnvVar} in your .env file"
+        ]
+    },
+    "evidence": {
+        "rosterVerified": {
+            "date": "2026-08-27",
+            "method": "authenticated GET /v1/models"
+        },
+        "authProbe": {
+            "date": "2026-08-26",
+            "status": 401,
+            "code": "wrong_api_key"
+        },
+        "liveMatrix": { "date": "2026-08-27", "result": "4/4" },
+        "addedInPR": "https://github.com/juspay/neurolink/pull/1561"
+    }
+}

package/dist/providers/catalog/cloudflare.json

@@ -0,0 +1,121 @@
+{
+    "$schema": "./provider-catalog.schema.json",
+    "id": "cloudflare",
+    "displayName": "Cloudflare Workers AI",
+    "aliases": ["workers-ai", "cf-ai"],
+    "tier": 2,
+    "wire": {
+        "baseURLTemplate": "https://api.cloudflare.com/client/v4/accounts/{accountId}/ai/v1",
+        "extraCredentials": ["accountId"],
+        "missingCredentialMessage": "CLOUDFLARE_ACCOUNT_ID is required (or pass credentials.cloudflare.accountId). Get the account id from https://dash.cloudflare.com/"
+    },
+    "models": {
+        "default": "@cf/meta/llama-3.3-70b-instruct-fp8-fast",
+        "fallbackModelName": "@cf/meta/llama-3.1-8b-instruct-fast",
+        "fallbacks": [
+            "@cf/meta/llama-3.3-70b-instruct-fp8-fast",
+            "@cf/meta/llama-3.1-70b-instruct",
+            "@cf/meta/llama-3.1-8b-instruct-fast",
+            "@cf/meta/llama-3.2-11b-vision-instruct",
+            "@cf/mistral/mistral-7b-instruct-v0.2",
+            "@cf/qwen/qwen1.5-14b-chat-awq"
+        ],
+        "defaultContextWindow": 8192,
+        "defaultMaxOutputTokens": 4096,
+        "catalog": {
+            "@cf/meta/llama-3.3-70b-instruct-fp8-fast": {
+                "enumMember": "LLAMA_3_3_70B_FAST",
+                "contextWindow": 24000,
+                "vision": false,
+                "status": "production",
+                "description": "Recommended - Llama 3.3 70B Instruct (FP8 fast)"
+            },
+            "@cf/meta/llama-3.1-70b-instruct": {
+                "enumMember": "LLAMA_3_1_70B_INSTRUCT",
+                "contextWindow": 24000,
+                "vision": false,
+                "status": "production",
+                "description": "Llama 3.1 70B Instruct"
+            },
+            "@cf/meta/llama-3.1-8b-instruct-fast": {
+                "enumMember": "LLAMA_3_1_8B_FAST",
+                "contextWindow": 24000,
+                "vision": false,
+                "status": "production",
+                "description": "Llama 3.1 8B Instruct (fast)"
+            },
+            "@cf/meta/llama-3.2-11b-vision-instruct": {
+                "enumMember": "LLAMA_3_2_11B_VISION",
+                "contextWindow": 24000,
+                "vision": true,
+                "status": "production",
+                "description": "Llama 3.2 11B Vision Instruct"
+            },
+            "@cf/mistral/mistral-7b-instruct-v0.2": {
+                "enumMember": "MISTRAL_7B_INSTRUCT_V0_2",
+                "contextWindow": 32768,
+                "vision": false,
+                "status": "production",
+                "description": "Mistral 7B Instruct v0.2"
+            },
+            "@cf/qwen/qwen1.5-14b-chat-awq": {
+                "enumMember": "QWEN_1P5_14B_CHAT_AWQ",
+                "contextWindow": 7500,
+                "vision": false,
+                "status": "production",
+                "description": "Qwen 1.5 14B Chat AWQ"
+            },
+            "@cf/google/gemma-2b-it-lora": {
+                "enumMember": "GEMMA_2B_IT_LORA",
+                "contextWindow": 4096,
+                "vision": false,
+                "status": "production",
+                "description": "Gemma 2B IT (LoRA)"
+            }
+        },
+        "topModels": [
+            "@cf/meta/llama-3.3-70b-instruct-fp8-fast",
+            "@cf/meta/llama-3.1-70b-instruct",
+            "@cf/meta/llama-3.1-8b-instruct-fast",
+            "@cf/meta/llama-3.2-11b-vision-instruct"
+        ]
+    },
+    "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 Cloudflare API key. Use a token with Workers AI Read+Write scope. Get one at https://dash.cloudflare.com/profile/api-tokens"
+        }
+    ],
+    "setup": {
+        "url": "https://dash.cloudflare.com/profile/api-tokens",
+        "apiKeyFormat": null,
+        "billingPolicy": "free-tier",
+        "description": "API token (Workers AI Read+Write scope)",
+        "instructions": [
+            "1. Visit: https://dash.cloudflare.com/profile/api-tokens",
+            "2. Create a token with 'Workers AI: Read + Write' scope",
+            "3. Set {apiKeyEnvVar} in your .env file",
+            "4. Also set CLOUDFLARE_ACCOUNT_ID (find it in the dashboard URL or under 'Account ID')"
+        ]
+    },
+    "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/fireworks.json

@@ -0,0 +1,124 @@
+{
+    "$schema": "./provider-catalog.schema.json",
+    "id": "fireworks",
+    "displayName": "Fireworks AI",
+    "aliases": [],
+    "tier": 2,
+    "wire": {
+        "baseURL": "https://api.fireworks.ai/inference/v1"
+    },
+    "models": {
+        "default": "accounts/fireworks/models/deepseek-v4-pro",
+        "testModel": "accounts/fireworks/models/kimi-k2p6",
+        "fallbackModelName": "accounts/fireworks/models/deepseek-v4-pro",
+        "fallbacks": [
+            "accounts/fireworks/models/deepseek-v4-pro",
+            "accounts/fireworks/models/glm-5p1",
+            "accounts/fireworks/models/glm-5",
+            "accounts/fireworks/models/kimi-k2p6",
+            "accounts/fireworks/models/kimi-k2p5",
+            "accounts/fireworks/models/gpt-oss-120b"
+        ],
+        "defaultContextWindow": 128000,
+        "defaultMaxOutputTokens": 4096,
+        "catalog": {
+            "accounts/fireworks/models/deepseek-v4-pro": {
+                "enumMember": "DEEPSEEK_V4_PRO",
+                "vision": false,
+                "status": "production",
+                "description": "Recommended - DeepSeek V4 Pro, current general-purpose default"
+            },
+            "accounts/fireworks/models/glm-5p1": {
+                "enumMember": "GLM_5P1",
+                "vision": false,
+                "status": "production",
+                "description": "GLM 5.1 — Zhipu flagship"
+            },
+            "accounts/fireworks/models/glm-5": {
+                "enumMember": "GLM_5",
+                "vision": false,
+                "status": "production",
+                "description": "GLM 5 — broader coverage"
+            },
+            "accounts/fireworks/models/kimi-k2p6": {
+                "enumMember": "KIMI_K2P6",
+                "vision": false,
+                "status": "production",
+                "description": "Kimi K2.6 — Moonshot flagship"
+            },
+            "accounts/fireworks/models/kimi-k2p5": {
+                "enumMember": "KIMI_K2P5",
+                "vision": false,
+                "status": "production",
+                "description": "Kimi K2.5 — preceding Kimi"
+            },
+            "accounts/fireworks/models/gpt-oss-120b": {
+                "enumMember": "GPT_OSS_120B",
+                "vision": false,
+                "status": "production",
+                "description": "GPT-OSS 120B — Apache-2.0 OpenAI weights"
+            },
+            "accounts/fireworks/models/llama-v3p2-90b-vision-instruct": {
+                "enumMember": "LLAMA_V3P2_90B_VISION_INSTRUCT",
+                "vision": true,
+                "status": "production",
+                "description": "Llama 3.2 90B Vision Instruct — vision-capable; restored from the pre-migration adapter's vision map (contextWindow/pricing not yet re-verified)"
+            },
+            "accounts/fireworks/models/llama-v3p2-11b-vision-instruct": {
+                "enumMember": "LLAMA_V3P2_11B_VISION_INSTRUCT",
+                "vision": true,
+                "status": "production",
+                "description": "Llama 3.2 11B Vision Instruct — vision-capable; restored from the pre-migration adapter's vision map (contextWindow/pricing not yet re-verified)"
+            },
+            "accounts/fireworks/models/phi-3-vision-128k-instruct": {
+                "enumMember": "PHI_3_VISION_128K_INSTRUCT",
+                "vision": true,
+                "status": "production",
+                "description": "Phi-3 Vision 128K Instruct — vision-capable; restored from the pre-migration adapter's vision map (contextWindow/pricing not yet re-verified)"
+            }
+        },
+        "topModels": [
+            "accounts/fireworks/models/deepseek-v4-pro",
+            "accounts/fireworks/models/glm-5p1",
+            "accounts/fireworks/models/kimi-k2p6",
+            "accounts/fireworks/models/gpt-oss-120b"
+        ]
+    },
+    "capabilities": {
+        "text": true,
+        "streaming": true,
+        "tools": true,
+        "toolsWithStreaming": true,
+        "structuredOutput": true,
+        "structuredOutputWithTools": true,
+        "embeddings": false,
+        "thinking": false
+    },
+    "errorRules": [
+        {
+            "status": 401,
+            "pattern": "Invalid API key|Authentication",
+            "class": "authentication",
+            "message": "Invalid Fireworks API key. Get one at https://fireworks.ai/account/api-keys"
+        }
+    ],
+    "setup": {
+        "url": "https://fireworks.ai/account/api-keys",
+        "apiKeyFormat": null,
+        "billingPolicy": "free-with-card",
+        "instructions": [
+            "1. Visit: https://fireworks.ai/account/api-keys",
+            "2. Sign in to your Fireworks AI account",
+            "3. Create a new API key",
+            "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"
+    }
+}

package/dist/providers/catalog/groq.json

@@ -0,0 +1,127 @@
+{
+    "$schema": "./provider-catalog.schema.json",
+    "id": "groq",
+    "displayName": "Groq",
+    "aliases": [],
+    "tier": 2,
+    "wire": {
+        "baseURL": "https://api.groq.com/openai/v1"
+    },
+    "models": {
+        "default": "llama-3.3-70b-versatile",
+        "testModel": "openai/gpt-oss-120b",
+        "fallbacks": [
+            "llama-3.3-70b-versatile",
+            "llama-3.1-8b-instant",
+            "gemma2-9b-it",
+            "mixtral-8x7b-32768",
+            "llama-3.2-90b-vision-preview",
+            "llama-3.2-11b-vision-preview"
+        ],
+        "defaultContextWindow": 128000,
+        "defaultMaxOutputTokens": 4096,
+        "catalog": {
+            "llama-3.3-70b-versatile": {
+                "contextWindow": 131072,
+                "pricingPerMTok": { "input": 0.59, "output": 0.79 },
+                "vision": false,
+                "status": "production",
+                "description": "Recommended - Production default; sub-100ms"
+            },
+            "llama-3.1-8b-instant": {
+                "contextWindow": 128000,
+                "pricingPerMTok": { "input": 0.05, "output": 0.08 },
+                "vision": false,
+                "status": "production",
+                "description": "Lowest latency tier"
+            },
+            "gemma2-9b-it": {
+                "enumMember": "GEMMA_2_9B_IT",
+                "contextWindow": 8192,
+                "pricingPerMTok": { "input": 0.2, "output": 0.2 },
+                "vision": false,
+                "status": "production",
+                "description": "Google Gemma 2 9B"
+            },
+            "mixtral-8x7b-32768": {
+                "contextWindow": 32768,
+                "pricingPerMTok": { "input": 0.24, "output": 0.24 },
+                "vision": false,
+                "status": "production",
+                "description": "Mistral 8x7B MoE, 32K context"
+            },
+            "llama-guard-3-8b": {
+                "contextWindow": 8192,
+                "vision": false,
+                "status": "production",
+                "description": "Llama Guard 3 8B — safety classifier"
+            },
+            "llama-3.2-90b-vision-preview": {
+                "contextWindow": 128000,
+                "pricingPerMTok": { "input": 0.9, "output": 0.9 },
+                "vision": true,
+                "status": "preview",
+                "description": "Multimodal (vision)"
+            },
+            "llama-3.2-11b-vision-preview": {
+                "contextWindow": 128000,
+                "pricingPerMTok": { "input": 0.18, "output": 0.18 },
+                "vision": true,
+                "status": "preview",
+                "description": "Llama 3.2 11B Vision Preview — smaller multimodal"
+            }
+        },
+        "topModels": [
+            "llama-3.3-70b-versatile",
+            "llama-3.1-8b-instant",
+            "llama-3.2-90b-vision-preview",
+            "gemma2-9b-it",
+            "mixtral-8x7b-32768"
+        ]
+    },
+    "capabilities": {
+        "text": true,
+        "streaming": true,
+        "tools": true,
+        "toolsWithStreaming": true,
+        "structuredOutput": true,
+        "structuredOutputWithTools": false,
+        "embeddings": false,
+        "thinking": false
+    },
+    "errorRules": [
+        {
+            "status": 401,
+            "pattern": "Invalid API key|Authentication|invalid_api_key",
+            "class": "authentication",
+            "message": "Invalid Groq API key. Check {apiKeyEnvVar}. Get one at https://console.groq.com/keys"
+        },
+        {
+            "pattern": "model_decommissioned",
+            "class": "invalid-model",
+            "message": "Groq model '{model}' was decommissioned. Pick a current model from https://console.groq.com/docs/models."
+        }
+    ],
+    "quirks": {
+        "timeoutErrorClass": "provider"
+    },
+    "setup": {
+        "url": "https://console.groq.com/keys",
+        "apiKeyFormat": null,
+        "billingPolicy": "free-tier",
+        "instructions": [
+            "1. Visit: https://console.groq.com/keys",
+            "2. Sign in to your Groq account",
+            "3. Create a new API key",
+            "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"
+    }
+}

package/dist/providers/catalog/index.generated.d.ts

@@ -0,0 +1,3 @@
+import type { ProviderCatalogJson } from "../../types/index.js";
+export declare const CATALOG_JSON_ENTRIES: ProviderCatalogJson[];
+export declare const CATALOG_PROVIDER_IDS: readonly ["cerebras", "cloudflare", "fireworks", "groq", "mistral", "perplexity", "sambanova", "together-ai", "xai"];

package/dist/providers/catalog/index.generated.js

@@ -0,0 +1,33 @@
+// GENERATED FILE — do not edit. Regenerate with `pnpm run codegen:catalog`.
+// Source of truth: the per-provider JSON files in this directory.
+import cerebrasJson from "./cerebras.json" with { type: "json" };
+import cloudflareJson from "./cloudflare.json" with { type: "json" };
+import fireworksJson from "./fireworks.json" with { type: "json" };
+import groqJson from "./groq.json" with { type: "json" };
+import mistralJson from "./mistral.json" with { type: "json" };
+import perplexityJson from "./perplexity.json" with { type: "json" };
+import sambanovaJson from "./sambanova.json" with { type: "json" };
+import togetherAiJson from "./together-ai.json" with { type: "json" };
+import xaiJson from "./xai.json" with { type: "json" };
+export const CATALOG_JSON_ENTRIES = [
+    cerebrasJson,
+    cloudflareJson,
+    fireworksJson,
+    groqJson,
+    mistralJson,
+    perplexityJson,
+    sambanovaJson,
+    togetherAiJson,
+    xaiJson,
+];
+export const CATALOG_PROVIDER_IDS = [
+    "cerebras",
+    "cloudflare",
+    "fireworks",
+    "groq",
+    "mistral",
+    "perplexity",
+    "sambanova",
+    "together-ai",
+    "xai",
+];

package/dist/providers/catalog/loader.d.ts

@@ -0,0 +1,6 @@
+import type { OpenAICompatCatalogEntry, ProviderCatalogJson, ProviderConfigOptions } from "../../types/index.js";
+export declare function catalogCredentialsKey(entry: ProviderCatalogJson): string;
+export declare function catalogEnvVar(entry: ProviderCatalogJson, kind: "apiKey" | "baseURL" | "model"): string;
+export declare function buildCatalogConfigOptions(entry: ProviderCatalogJson): ProviderConfigOptions;
+export declare function getCatalogJsonEntries(): ProviderCatalogJson[];
+export declare function buildCatalogEntries(): OpenAICompatCatalogEntry[];