@juspay/neurolink 12.4.4 → 12.5.1

package/dist/hitl/hitlManager.d.ts

@@ -97,4 +97,18 @@ export declare class HITLManager extends EventEmitter {
      * Get count of pending confirmations
      */
     getPendingCount(): number;
+    /**
+     * Whether a specific confirmation is still awaiting a response on this manager.
+     *
+     * A pending entry holds the `resolve`/`reject` of the suspended tool call, so it
+     * exists only in the memory of the manager that issued it. A manager constructed
+     * after the confirmation was issued — a session rebuilt from persisted state, for
+     * example — has an empty set, and `processUserResponse` for such an id logs a
+     * warning and returns without resolving anything.
+     *
+     * Callers that report an outcome back to a user should check this before treating
+     * a delivered `hitl:confirmation-response` as acted upon: the event being received
+     * says a listener existed, not that anything was waiting for it.
+     */
+    hasPendingConfirmation(confirmationId: string): boolean;
 }

package/dist/hitl/hitlManager.js

@@ -457,4 +457,20 @@ export class HITLManager extends EventEmitter {
     getPendingCount() {
         return this.pendingConfirmations.size;
     }
+    /**
+     * Whether a specific confirmation is still awaiting a response on this manager.
+     *
+     * A pending entry holds the `resolve`/`reject` of the suspended tool call, so it
+     * exists only in the memory of the manager that issued it. A manager constructed
+     * after the confirmation was issued — a session rebuilt from persisted state, for
+     * example — has an empty set, and `processUserResponse` for such an id logs a
+     * warning and returns without resolving anything.
+     *
+     * Callers that report an outcome back to a user should check this before treating
+     * a delivered `hitl:confirmation-response` as acted upon: the event being received
+     * says a listener existed, not that anything was waiting for it.
+     */
+    hasPendingConfirmation(confirmationId) {
+        return this.pendingConfirmations.has(confirmationId);
+    }
 }

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/neurolink.d.ts

@@ -1311,6 +1311,43 @@ export declare class NeuroLink {
      * @see {@link NeuroLink.executeTool} for events related to tool execution
      */
     getEventEmitter(): TypedEventEmitter<NeuroLinkEvents>;
+    /**
+     * Whether a HITL confirmation is still awaiting a response on THIS instance.
+     *
+     * Emitting `hitl:confirmation-response` is not proof the decision landed. The
+     * forwarding listener for that event is installed once at construction, so
+     * `emitter.emit(...)` reports a listener was invoked even when nothing is
+     * waiting — the pending set lives one hop further in, on the HITL manager, and
+     * holds the `resolve`/`reject` of the suspended tool call. An instance built
+     * after the confirmation was issued (a session rebuilt from persisted state)
+     * therefore accepts the event and resolves nothing.
+     *
+     * Returns `false` in two different situations, which it deliberately does not
+     * distinguish: HITL was never configured on this instance, and the id is
+     * unknown or already settled. Both mean "emitting a response here achieves
+     * nothing", which is the question this answers. A caller that needs to tell a
+     * configuration mistake from an expired confirmation should check the HITL
+     * config separately rather than read that into this boolean.
+     *
+     * This is advisory, not atomic: it reports the state at the moment it is
+     * called. Nothing stops the confirmation timing out immediately afterwards, so
+     * emit on the answer without an `await` in between. Over the case it exists
+     * for — an instance rebuilt from persisted state, whose pending set is empty
+     * and can never repopulate for an id it never issued — absence cannot become
+     * presence, so the answer cannot go stale in the unsafe direction.
+     *
+     * @param confirmationId - The id from the `hitl:confirmation-request` event
+     * @returns `true` only if this instance is still holding that confirmation
+     *
+     * @example
+     * ```typescript
+     * if (!neurolink.hasPendingHITLConfirmation(confirmationId)) {
+     *   return refuse("This conversation has expired, so the action was not carried out.");
+     * }
+     * neurolink.getEventEmitter().emit("hitl:confirmation-response", { ... });
+     * ```
+     */
+    hasPendingHITLConfirmation(confirmationId: string): boolean;
     /**
      * Returns the instance-level tool-dedup configuration, or `undefined` when
      * toolDedup was not provided at construction time.

package/dist/neurolink.js

@@ -9132,6 +9132,45 @@ Current user's request: ${currentInput}`;
     getEventEmitter() {
         return this.emitter;
     }
+    /**
+     * Whether a HITL confirmation is still awaiting a response on THIS instance.
+     *
+     * Emitting `hitl:confirmation-response` is not proof the decision landed. The
+     * forwarding listener for that event is installed once at construction, so
+     * `emitter.emit(...)` reports a listener was invoked even when nothing is
+     * waiting — the pending set lives one hop further in, on the HITL manager, and
+     * holds the `resolve`/`reject` of the suspended tool call. An instance built
+     * after the confirmation was issued (a session rebuilt from persisted state)
+     * therefore accepts the event and resolves nothing.
+     *
+     * Returns `false` in two different situations, which it deliberately does not
+     * distinguish: HITL was never configured on this instance, and the id is
+     * unknown or already settled. Both mean "emitting a response here achieves
+     * nothing", which is the question this answers. A caller that needs to tell a
+     * configuration mistake from an expired confirmation should check the HITL
+     * config separately rather than read that into this boolean.
+     *
+     * This is advisory, not atomic: it reports the state at the moment it is
+     * called. Nothing stops the confirmation timing out immediately afterwards, so
+     * emit on the answer without an `await` in between. Over the case it exists
+     * for — an instance rebuilt from persisted state, whose pending set is empty
+     * and can never repopulate for an id it never issued — absence cannot become
+     * presence, so the answer cannot go stale in the unsafe direction.
+     *
+     * @param confirmationId - The id from the `hitl:confirmation-request` event
+     * @returns `true` only if this instance is still holding that confirmation
+     *
+     * @example
+     * ```typescript
+     * if (!neurolink.hasPendingHITLConfirmation(confirmationId)) {
+     *   return refuse("This conversation has expired, so the action was not carried out.");
+     * }
+     * neurolink.getEventEmitter().emit("hitl:confirmation-response", { ... });
+     * ```
+     */
+    hasPendingHITLConfirmation(confirmationId) {
+        return this.hitlManager?.hasPendingConfirmation(confirmationId) ?? false;
+    }
     /**
      * Returns the instance-level tool-dedup configuration, or `undefined` when
      * toolDedup was not provided at construction time.

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"];