@juspay/neurolink 12.23.3 → 12.24.0

package/dist/factories/providerRegistry.js

@@ -1,6 +1,6 @@
 import { ProviderFactory } from "./providerFactory.js";
 import { logger } from "../utils/logger.js";
-import { AIProviderName, GoogleAIModels, OpenAIModels, AnthropicModels, VertexModels, OllamaModels, LiteLLMModels, HuggingFaceModels, DeepSeekModels, NvidiaNimModels, OpenRouterModels, CohereModels, VoyageModels, JinaModels, StabilityModels, IdeogramModels, RecraftModels, TypeSafeModels, ReplicateModels, } from "../constants/enums.js";
+import { AIProviderName, GoogleAIModels, OpenAIModels, AnthropicModels, VertexModels, OllamaModels, LiteLLMModels, NvidiaNimModels, OpenRouterModels, CohereModels, VoyageModels, JinaModels, StabilityModels, IdeogramModels, RecraftModels, TypeSafeModels, ReplicateModels, } from "../constants/enums.js";
 import { PROVIDER_DESCRIPTORS_BY_NAME } from "./providerDescriptors.js";
 import { OPENAI_COMPAT_CATALOG } from "../providers/openaiCompatCatalog.js";
 import { providerChoicesFor } from "./mediaHandlerCatalog.js";
@@ -106,17 +106,13 @@ export class ProviderRegistry {
                 const { GoogleVertexProvider } = await import("../providers/googleVertex/index.js");
                 return new GoogleVertexProvider(modelName, providerName, sdk, region, vertexCreds);
             }, VertexModels.CLAUDE_4_6_SONNET, ["vertex", "googleVertex"], PROVIDER_DESCRIPTORS_BY_NAME.get(AIProviderName.VERTEX));
-            // Register Hugging Face provider (Unified Router implementation)
-            ProviderFactory.registerProvider(AIProviderName.HUGGINGFACE, async (modelName, _providerName, sdk, region, credentials) => {
-                const hfCreds = credentials;
-                const { HuggingFaceProvider } = await import("../providers/huggingFace/index.js");
-                return new HuggingFaceProvider(modelName, sdk, region, hfCreds);
-            }, process.env.HUGGINGFACE_MODEL ||
-                HuggingFaceModels.QWEN_2_5_72B_INSTRUCT, ["huggingface", "hf"], PROVIDER_DESCRIPTORS_BY_NAME.get(AIProviderName.HUGGINGFACE));
+            // HuggingFace migrated to the JSON catalog (catalog/huggingface.json)
+            // — it is now registered by the "config-driven OpenAI-compatible
+            // catalog providers" loop below, not a dedicated block here.
             // Register the config-driven OpenAI-compatible catalog providers
             // (cerebras, groq, xai, together-ai, fireworks, perplexity, mistral,
-            // cloudflare).
-            // To add a new zero-quirk OpenAI-compatible provider, add one entry to
+            // cloudflare, deepseek, huggingface).
+            // To add a new OpenAI-compatible provider, add one entry to
             // OPENAI_COMPAT_CATALOG (openaiCompatCatalog.ts) — not a new block here.
             for (const entry of OPENAI_COMPAT_CATALOG) {
                 ProviderFactory.registerProvider(entry.providerName, async (modelName, _providerName, sdk, _region, credentials) => {
@@ -163,12 +159,9 @@ export class ProviderRegistry {
                 const { AmazonSageMakerProvider } = await import("../providers/amazonSagemaker.js");
                 return new AmazonSageMakerProvider(modelName, undefined, region, undefined, sagemakerCreds);
             }, process.env.SAGEMAKER_MODEL || "sagemaker-model", ["sagemaker", "aws-sagemaker"], PROVIDER_DESCRIPTORS_BY_NAME.get(AIProviderName.SAGEMAKER));
-            // Register DeepSeek provider
-            ProviderFactory.registerProvider(AIProviderName.DEEPSEEK, async (modelName, _providerName, sdk, _region, credentials) => {
-                const deepseekCreds = credentials;
-                const { DeepSeekProvider } = await import("../providers/deepseek.js");
-                return new DeepSeekProvider(modelName, sdk, undefined, deepseekCreds);
-            }, process.env.DEEPSEEK_MODEL || DeepSeekModels.DEEPSEEK_CHAT, ["deepseek", "ds"], PROVIDER_DESCRIPTORS_BY_NAME.get(AIProviderName.DEEPSEEK));
+            // DeepSeek migrated to the JSON catalog (catalog/deepseek.json) — it is
+            // now registered by the "config-driven OpenAI-compatible catalog
+            // providers" loop above, not a dedicated block here.
             // Register NVIDIA NIM provider
             ProviderFactory.registerProvider(AIProviderName.NVIDIA_NIM, async (modelName, _providerName, sdk, _region, credentials) => {
                 const nimCreds = credentials;

package/dist/models/manifestRegistry.js

@@ -50,6 +50,15 @@ import { recraftManifest } from "./manifests/recraft.js";
  * no alias field.
  */
 function buildCatalogManifest(entry) {
+    // capabilities.tools is "model-dependent" for huggingface, but
+    // huggingface uses its own hand-written manifest (see MANIFEST_REGISTRY
+    // below), never this generic path — cerebras/sambanova, the only two
+    // providers actually routed through buildCatalogManifest() today, both
+    // have a plain boolean here. Narrowed rather than widening
+    // ProviderModelManifestEntry.functionCalling itself: a provider entering
+    // this generic (non-hand-curated) path with "model-dependent" tools gets
+    // the conservative false, not an unearned optimistic true.
+    const functionCalling = entry.capabilities.tools === true;
     const namedModels = Object.fromEntries(Object.entries(entry.models.catalog).map(([modelId, spec]) => [
         modelId,
         {
@@ -57,7 +66,7 @@ function buildCatalogManifest(entry) {
             contextWindow: spec.contextWindow ?? entry.models.defaultContextWindow,
             maxOutputTokens: entry.models.defaultMaxOutputTokens,
             vision: spec.vision,
-            functionCalling: entry.capabilities.tools,
+            functionCalling,
         },
     ]));
     return {
@@ -68,7 +77,7 @@ function buildCatalogManifest(entry) {
                 contextWindow: entry.models.defaultContextWindow,
                 maxOutputTokens: entry.models.defaultMaxOutputTokens,
                 vision: false,
-                functionCalling: entry.capabilities.tools,
+                functionCalling,
             },
             ...namedModels,
         },

package/dist/providers/catalog/deepseek.json

@@ -0,0 +1,84 @@
+{
+    "$schema": "./provider-catalog.schema.json",
+    "id": "deepseek",
+    "displayName": "DeepSeek",
+    "enumTypeName": "DeepSeekModels",
+    "aliases": ["ds"],
+    "tier": 2,
+    "wire": {
+        "baseURL": "https://api.deepseek.com"
+    },
+    "models": {
+        "default": "deepseek-chat",
+        "fallbacks": ["deepseek-chat", "deepseek-reasoner"],
+        "defaultContextWindow": 64000,
+        "defaultMaxOutputTokens": 64000,
+        "catalog": {
+            "deepseek-chat": {
+                "contextWindow": 64000,
+                "maxOutputTokens": 64000,
+                "vision": false,
+                "status": "production",
+                "description": "DeepSeek-V3 general chat"
+            },
+            "deepseek-reasoner": {
+                "contextWindow": 64000,
+                "maxOutputTokens": 64000,
+                "vision": false,
+                "status": "production",
+                "description": "DeepSeek-R1 reasoning (slower, deeper)"
+            }
+        }
+    },
+    "capabilities": {
+        "text": true,
+        "streaming": true,
+        "tools": true,
+        "toolsWithStreaming": true,
+        "structuredOutput": true,
+        "structuredOutputWithTools": true,
+        "embeddings": false,
+        "thinking": true
+    },
+    "errorRules": [
+        {
+            "status": 401,
+            "pattern": "Invalid API key|Authentication",
+            "class": "authentication",
+            "message": "Invalid DeepSeek API key. Please check your {apiKeyEnvVar} environment variable."
+        },
+        {
+            "status": 402,
+            "pattern": "Insufficient Balance|insufficient_balance",
+            "class": "provider",
+            "message": "DeepSeek account has insufficient balance. Top up at https://platform.deepseek.com/usage"
+        },
+        {
+            "pattern": "model_not_found",
+            "class": "invalid-model",
+            "message": "DeepSeek model '{model}' not found. Use 'deepseek-chat' or 'deepseek-reasoner'."
+        }
+    ],
+    "quirks": {
+        "responseFormatDowngrade": "json-schema-to-json-object"
+    },
+    "setup": {
+        "url": "https://platform.deepseek.com/api_keys",
+        "apiKeyFormat": null,
+        "billingPolicy": "no-free-tier",
+        "instructions": [
+            "1. Visit: https://platform.deepseek.com/api_keys",
+            "2. Create or sign in to your DeepSeek account",
+            "3. Generate a new API key",
+            "4. Set {apiKeyEnvVar} in your .env file"
+        ]
+    },
+    "evidence": {
+        "rosterVerified": {
+            "date": "2026-09-22",
+            "method": "Ported from already-committed repo data (DeepSeekModels enum, deepseekManifest.ts, deepseek.ts's own error-rule and quirk comments) on origin/release @ a7fd9bf04 — no live vendor probe performed, per this migration's no-vendor-call constraint. billingPolicy is carried over from general knowledge, not independently re-verified live; flagged for confirmation before merge. The capability flags mirror the hand-written live-matrix row this entry replaces (test/helpers/providerMatrix.ts on origin/release), so the migration leaves the set of live-matrix cells unchanged."
+        },
+        "liveMatrix": null,
+        "addedInPR": "TBD — integration-tested in a worktree before a PR was opened"
+    }
+}

package/dist/providers/catalog/huggingface.json

@@ -0,0 +1,405 @@
+{
+    "$schema": "./provider-catalog.schema.json",
+    "id": "huggingface",
+    "displayName": "HuggingFace",
+    "enumTypeName": "HuggingFaceModels",
+    "aliases": ["hf"],
+    "credentialsKey": "huggingFace",
+    "tier": 2,
+    "wire": {
+        "baseURL": "https://router.huggingface.co/v1",
+        "apiKeyFallbackEnvVars": ["HF_TOKEN"]
+    },
+    "models": {
+        "default": "Qwen/Qwen2.5-72B-Instruct",
+        "fallbackModelName": "meta-llama/Llama-3.1-8B-Instruct",
+        "fallbacks": ["meta-llama/Llama-3.1-8B-Instruct"],
+        "testModel": "meta-llama/Llama-3.1-8B-Instruct",
+        "topModels": [
+            "meta-llama/Llama-3.3-70B-Instruct",
+            "mistralai/Mistral-Large-3-675B-Instruct-2512",
+            "deepseek-ai/DeepSeek-R1",
+            "Qwen/Qwen2.5-72B-Instruct",
+            "microsoft/phi-4",
+            "google/gemma-3-27b-it"
+        ],
+        "defaultContextWindow": 32000,
+        "defaultMaxOutputTokens": 32000,
+        "catalog": {
+            "meta-llama/Llama-3.3-70B-Instruct": {
+                "vision": false,
+                "status": "production",
+                "description": "Recommended - Latest Llama",
+                "enumMember": "LLAMA_3_3_70B_INSTRUCT"
+            },
+            "meta-llama/Llama-3.2-1B": {
+                "vision": false,
+                "status": "production",
+                "description": "Meta Llama 3.2 — Llama-3.2-1B",
+                "enumMember": "LLAMA_3_2_1B"
+            },
+            "meta-llama/Llama-3.2-3B-Instruct": {
+                "vision": false,
+                "status": "production",
+                "description": "Meta Llama 3.2 — Llama-3.2-3B-Instruct",
+                "enumMember": "LLAMA_3_2_3B_INSTRUCT"
+            },
+            "meta-llama/Llama-3.1-8B": {
+                "vision": false,
+                "status": "production",
+                "description": "Meta Llama 3.1 — Llama-3.1-8B",
+                "enumMember": "LLAMA_3_1_8B"
+            },
+            "meta-llama/Llama-3.1-8B-Instruct": {
+                "vision": false,
+                "status": "production",
+                "description": "Llama 3.1 8B, tool-calling capable",
+                "enumMember": "LLAMA_3_1_8B_INSTRUCT"
+            },
+            "meta-llama/Llama-3.1-70B-Instruct": {
+                "vision": false,
+                "status": "production",
+                "description": "Meta Llama 3.1 — Llama-3.1-70B-Instruct",
+                "enumMember": "LLAMA_3_1_70B_INSTRUCT"
+            },
+            "meta-llama/Llama-3.1-405B-Instruct": {
+                "vision": false,
+                "status": "production",
+                "description": "Meta Llama 3.1 — Llama-3.1-405B-Instruct",
+                "enumMember": "LLAMA_3_1_405B_INSTRUCT"
+            },
+            "meta-llama/Meta-Llama-3-8B-Instruct": {
+                "vision": false,
+                "status": "production",
+                "description": "Meta Llama 3.0 — Meta-Llama-3-8B-Instruct",
+                "enumMember": "LLAMA_3_8B_INSTRUCT"
+            },
+            "meta-llama/Meta-Llama-3-70B-Instruct": {
+                "vision": false,
+                "status": "production",
+                "description": "Meta Llama 3.0 — Meta-Llama-3-70B-Instruct",
+                "enumMember": "LLAMA_3_70B_INSTRUCT"
+            },
+            "mistralai/Mistral-Large-3-675B-Instruct-2512": {
+                "vision": false,
+                "status": "production",
+                "description": "Mistral Large",
+                "enumMember": "MISTRAL_LARGE_3_675B"
+            },
+            "mistralai/Mistral-Small-3.1-24B-Instruct-2503": {
+                "vision": false,
+                "status": "production",
+                "description": "Mistral Small — Mistral-Small-3.1-24B-Instruct-2503",
+                "enumMember": "MISTRAL_SMALL_3_1_24B"
+            },
+            "mistralai/Mistral-Small-24B-Instruct-2501": {
+                "vision": false,
+                "status": "production",
+                "description": "Mistral Small — Mistral-Small-24B-Instruct-2501",
+                "enumMember": "MISTRAL_SMALL_24B"
+            },
+            "mistralai/Mistral-7B-Instruct-v0.2": {
+                "vision": false,
+                "status": "production",
+                "description": "Mistral — Mistral-7B-Instruct-v0.2",
+                "enumMember": "MISTRAL_7B_INSTRUCT"
+            },
+            "mistralai/Mixtral-8x7B-Instruct-v0.1": {
+                "vision": false,
+                "status": "production",
+                "description": "Mistral — Mixtral-8x7B-Instruct-v0.1",
+                "enumMember": "MIXTRAL_8X7B_INSTRUCT"
+            },
+            "mistralai/Devstral-2": {
+                "vision": false,
+                "status": "production",
+                "description": "Mistral Devstral — Devstral-2",
+                "enumMember": "DEVSTRAL_2"
+            },
+            "Qwen/Qwen2.5-7B": {
+                "vision": false,
+                "status": "production",
+                "description": "Qwen 2.5 — Qwen2.5-7B",
+                "enumMember": "QWEN_2_5_7B"
+            },
+            "Qwen/Qwen2.5-32B": {
+                "vision": false,
+                "status": "production",
+                "description": "Qwen 2.5 — Qwen2.5-32B",
+                "enumMember": "QWEN_2_5_32B"
+            },
+            "Qwen/Qwen2.5-72B-Instruct": {
+                "vision": false,
+                "status": "production",
+                "description": "Qwen flagship",
+                "enumMember": "QWEN_2_5_72B_INSTRUCT"
+            },
+            "Qwen/Qwen2.5-Coder-7B": {
+                "vision": false,
+                "status": "production",
+                "description": "Qwen 2.5 Coder — Qwen2.5-Coder-7B",
+                "enumMember": "QWEN_2_5_CODER_7B"
+            },
+            "Qwen/Qwen2.5-Coder-32B-Instruct": {
+                "vision": false,
+                "status": "production",
+                "description": "Qwen 2.5 Coder — Qwen2.5-Coder-32B-Instruct",
+                "enumMember": "QWEN_2_5_CODER_32B_INSTRUCT"
+            },
+            "Qwen/QwQ-32B": {
+                "vision": false,
+                "status": "production",
+                "description": "Qwen QwQ — QwQ-32B",
+                "enumMember": "QWQ_32B"
+            },
+            "Qwen/Qwen2.5-VL-32B-Instruct": {
+                "vision": false,
+                "status": "production",
+                "description": "Qwen 2.5 VL (Multimodal) — Qwen2.5-VL-32B-Instruct",
+                "enumMember": "QWEN_2_5_VL_32B"
+            },
+            "deepseek-ai/DeepSeek-R1": {
+                "vision": false,
+                "status": "production",
+                "description": "Advanced reasoning",
+                "enumMember": "DEEPSEEK_R1"
+            },
+            "deepseek-ai/DeepSeek-V3": {
+                "vision": false,
+                "status": "production",
+                "description": "DeepSeek — DeepSeek-V3",
+                "enumMember": "DEEPSEEK_V3"
+            },
+            "deepseek-ai/DeepSeek-V3.1": {
+                "vision": false,
+                "status": "production",
+                "description": "DeepSeek — DeepSeek-V3.1",
+                "enumMember": "DEEPSEEK_V3_1"
+            },
+            "deepseek-ai/DeepSeek-V3.2-Exp": {
+                "vision": false,
+                "status": "production",
+                "description": "DeepSeek — DeepSeek-V3.2-Exp",
+                "enumMember": "DEEPSEEK_V3_2_EXP"
+            },
+            "microsoft/phi-4": {
+                "vision": false,
+                "status": "production",
+                "description": "Microsoft Phi-4",
+                "enumMember": "PHI_4"
+            },
+            "microsoft/Phi-4-reasoning": {
+                "vision": false,
+                "status": "production",
+                "description": "Microsoft Phi — Phi-4-reasoning",
+                "enumMember": "PHI_4_REASONING"
+            },
+            "microsoft/Phi-4-mini-instruct": {
+                "vision": false,
+                "status": "production",
+                "description": "Microsoft Phi — Phi-4-mini-instruct",
+                "enumMember": "PHI_4_MINI_INSTRUCT"
+            },
+            "microsoft/Phi-4-mini-reasoning": {
+                "vision": false,
+                "status": "production",
+                "description": "Microsoft Phi — Phi-4-mini-reasoning",
+                "enumMember": "PHI_4_MINI_REASONING"
+            },
+            "microsoft/Phi-3-mini-128k-instruct": {
+                "vision": false,
+                "status": "production",
+                "description": "Microsoft Phi — Phi-3-mini-128k-instruct",
+                "enumMember": "PHI_3_MINI_128K_INSTRUCT"
+            },
+            "microsoft/Phi-3-vision-128k-instruct": {
+                "vision": false,
+                "status": "production",
+                "description": "Microsoft Phi — Phi-3-vision-128k-instruct",
+                "enumMember": "PHI_3_VISION_128K_INSTRUCT"
+            },
+            "google/gemma-3-270m": {
+                "vision": false,
+                "status": "production",
+                "description": "Google Gemma 3 — gemma-3-270m",
+                "enumMember": "GEMMA_3_270M"
+            },
+            "google/gemma-3-1b-it": {
+                "vision": false,
+                "status": "production",
+                "description": "Google Gemma 3 — gemma-3-1b-it",
+                "enumMember": "GEMMA_3_1B_IT"
+            },
+            "google/gemma-3-4b-it": {
+                "vision": false,
+                "status": "production",
+                "description": "Google Gemma 3 — gemma-3-4b-it",
+                "enumMember": "GEMMA_3_4B_IT"
+            },
+            "google/gemma-3-12b-it": {
+                "vision": false,
+                "status": "production",
+                "description": "Google Gemma 3 — gemma-3-12b-it",
+                "enumMember": "GEMMA_3_12B_IT"
+            },
+            "google/gemma-3-27b-it": {
+                "vision": false,
+                "status": "production",
+                "description": "Google Gemma 3",
+                "enumMember": "GEMMA_3_27B_IT"
+            },
+            "google/gemma-2-9b": {
+                "vision": false,
+                "status": "production",
+                "description": "Google Gemma 2 — gemma-2-9b",
+                "enumMember": "GEMMA_2_9B"
+            },
+            "google/gemma-2-27b": {
+                "vision": false,
+                "status": "production",
+                "description": "Google Gemma 2 — gemma-2-27b",
+                "enumMember": "GEMMA_2_27B"
+            },
+            "google/gemma-2b": {
+                "vision": false,
+                "status": "production",
+                "description": "Google Gemma 1 — gemma-2b",
+                "enumMember": "GEMMA_2B"
+            },
+            "google/gemma-7b": {
+                "vision": false,
+                "status": "production",
+                "description": "Google Gemma 1 — gemma-7b",
+                "enumMember": "GEMMA_7B"
+            },
+            "tiiuae/falcon-40b-instruct": {
+                "vision": false,
+                "status": "production",
+                "description": "Falcon — falcon-40b-instruct",
+                "enumMember": "FALCON_40B_INSTRUCT"
+            },
+            "tiiuae/falcon-180B-chat": {
+                "vision": false,
+                "status": "production",
+                "description": "Falcon — falcon-180B-chat",
+                "enumMember": "FALCON_180B_CHAT"
+            },
+            "bigcode/starcoder2-15b": {
+                "vision": false,
+                "status": "production",
+                "description": "Code Models — starcoder2-15b",
+                "enumMember": "STARCODER2_15B"
+            },
+            "codellama/CodeLlama-34b-Instruct-hf": {
+                "vision": false,
+                "status": "production",
+                "description": "Code Models — CodeLlama-34b-Instruct-hf",
+                "enumMember": "CODELLAMA_34B_INSTRUCT"
+            },
+            "bigscience/bloom-7b1": {
+                "vision": false,
+                "status": "production",
+                "description": "BLOOM — bloom-7b1",
+                "enumMember": "BLOOM_7B1"
+            },
+            "bigscience/bloom-1b3": {
+                "vision": false,
+                "status": "production",
+                "description": "BLOOM — bloom-1b3",
+                "enumMember": "BLOOM_1B3"
+            },
+            "zai-org/GLM-5": {
+                "vision": false,
+                "status": "production",
+                "description": "Z.AI GLM-5 (February 2026) — GLM-5",
+                "enumMember": "GLM_5"
+            },
+            "Qwen/Qwen3.5-397B-A17B": {
+                "vision": false,
+                "status": "production",
+                "description": "Qwen 3.5 Multimodal (February 2026) — Qwen3.5-397B-A17B",
+                "enumMember": "QWEN_3_5_397B_A17B"
+            },
+            "nvidia/NVIDIA-Nemotron-3-Nano-30B-A3B-BF16": {
+                "vision": false,
+                "status": "production",
+                "description": "NVIDIA Nemotron 3 Nano — NVIDIA-Nemotron-3-Nano-30B-A3B-BF16",
+                "enumMember": "NEMOTRON_3_NANO_30B"
+            },
+            "HuggingFaceTB/SmolLM3-3B": {
+                "vision": false,
+                "status": "production",
+                "description": "HuggingFace SmolLM3 — SmolLM3-3B",
+                "enumMember": "SMOLLM3_3B"
+            },
+            "tiiuae/Falcon3-7B-Instruct": {
+                "vision": false,
+                "status": "production",
+                "description": "Falcon 3 Series — Falcon3-7B-Instruct",
+                "enumMember": "FALCON_3_7B_INSTRUCT"
+            },
+            "tiiuae/Falcon3-10B-Instruct": {
+                "vision": false,
+                "status": "production",
+                "description": "Falcon 3 Series — Falcon3-10B-Instruct",
+                "enumMember": "FALCON_3_10B_INSTRUCT"
+            }
+        }
+    },
+    "capabilities": {
+        "text": true,
+        "streaming": true,
+        "tools": "model-dependent",
+        "toolsWithStreaming": false,
+        "structuredOutput": false,
+        "structuredOutputWithTools": false,
+        "embeddings": false,
+        "thinking": false
+    },
+    "errorRules": [
+        {
+            "pattern": "API_TOKEN_INVALID|Invalid token",
+            "class": "authentication",
+            "message": "Invalid HuggingFace API token. Please check your {apiKeyEnvVar} environment variable."
+        },
+        {
+            "pattern": "rate limit",
+            "class": "rate-limit",
+            "message": "HuggingFace rate limit exceeded. Consider using a paid plan or try again later."
+        },
+        {
+            "pattern": "model.*not found|not found.*model",
+            "class": "invalid-model",
+            "message": "HuggingFace model '{model}' not found.\n\nSuggestions:\n1. Check model name spelling\n2. Ensure model exists on HuggingFace Hub\n3. For tool calling, use: Llama-3.1-8B-Instruct, Hermes-3-Llama-3.2-3B, or CodeLlama-34b-Instruct-hf"
+        },
+        {
+            "pattern": "function|tool",
+            "class": "provider",
+            "message": "HuggingFace tool calling error: {message}\n\nNotes:\n1. Ensure you're using a tool-capable model (Llama-3.1+, Hermes-3+, CodeLlama)\n2. Check that your model supports function calling\n3. Verify tool schema format is correct"
+        }
+    ],
+    "timeouts": {
+        "generateMs": 120000,
+        "streamMs": 120000
+    },
+    "autoSelectPriority": 10,
+    "setup": {
+        "url": "https://huggingface.co/settings/tokens",
+        "apiKeyFormat": "^hf_[A-Za-z0-9]{37}$",
+        "billingPolicy": "free-with-card",
+        "instructions": [
+            "1. Visit: https://huggingface.co/settings/tokens",
+            "2. Create or sign in to your HuggingFace account",
+            "3. Generate a new access token",
+            "4. Set {apiKeyEnvVar} in your .env file (HF_TOKEN also accepted)"
+        ]
+    },
+    "evidence": {
+        "rosterVerified": {
+            "date": "2026-09-22",
+            "method": "Ported from already-committed repo data (HuggingFaceModels enum, huggingfaceManifest.ts, the hand ProviderDescriptor, and huggingFace/client.ts's own error-rule/model comments) on this worktree's current state — no live vendor probe performed, per this migration's no-vendor-call constraint. models.catalog carries every member of the HuggingFaceModels enum it replaces, with the same enumMember names, plus the Llama-3.1-8B-Instruct fallback; topModels restores the previous picker order and text. Per-model vision is false to mirror huggingfaceManifest, which declares no HuggingFace vision support — it is not a vendor capability claim; billingPolicy is carried over from general knowledge, not independently re-verified live. testModel and the capability flags mirror the hand-written live-matrix row this entry replaces (test/helpers/providerMatrix.ts on origin/release), so the migration leaves the set of live-matrix cells unchanged."
+        },
+        "liveMatrix": null,
+        "addedInPR": "TBD — integration-tested in a worktree before a PR was opened"
+    }
+}

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

@@ -1,3 +1,3 @@
 import type { ProviderCatalogJson } from "../../types/index.js";
 export declare const CATALOG_JSON_ENTRIES: ProviderCatalogJson[];
-export declare const CATALOG_PROVIDER_IDS: readonly ["api-route", "baseten", "cerebras", "cloudflare", "fireworks", "friendli", "gmicloud", "groq", "inception-labs", "io-intelligence", "mancer", "mistral", "perplexity", "sambanova", "together-ai", "upstage", "xai"];
+export declare const CATALOG_PROVIDER_IDS: readonly ["api-route", "baseten", "cerebras", "cloudflare", "deepseek", "fireworks", "friendli", "gmicloud", "groq", "huggingface", "inception-labs", "io-intelligence", "mancer", "mistral", "perplexity", "sambanova", "together-ai", "upstage", "xai"];

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

@@ -4,10 +4,12 @@ import apiRouteJson from "./api-route.json" with { type: "json" };
 import basetenJson from "./baseten.json" with { type: "json" };
 import cerebrasJson from "./cerebras.json" with { type: "json" };
 import cloudflareJson from "./cloudflare.json" with { type: "json" };
+import deepseekJson from "./deepseek.json" with { type: "json" };
 import fireworksJson from "./fireworks.json" with { type: "json" };
 import friendliJson from "./friendli.json" with { type: "json" };
 import gmicloudJson from "./gmicloud.json" with { type: "json" };
 import groqJson from "./groq.json" with { type: "json" };
+import huggingfaceJson from "./huggingface.json" with { type: "json" };
 import inceptionLabsJson from "./inception-labs.json" with { type: "json" };
 import ioIntelligenceJson from "./io-intelligence.json" with { type: "json" };
 import mancerJson from "./mancer.json" with { type: "json" };
@@ -22,10 +24,12 @@ export const CATALOG_JSON_ENTRIES = [
     basetenJson,
     cerebrasJson,
     cloudflareJson,
+    deepseekJson,
     fireworksJson,
     friendliJson,
     gmicloudJson,
     groqJson,
+    huggingfaceJson,
     inceptionLabsJson,
     ioIntelligenceJson,
     mancerJson,
@@ -41,10 +45,12 @@ export const CATALOG_PROVIDER_IDS = [
     "baseten",
     "cerebras",
     "cloudflare",
+    "deepseek",
     "fireworks",
     "friendli",
     "gmicloud",
     "groq",
+    "huggingface",
     "inception-labs",
     "io-intelligence",
     "mancer",