feat: Add instrumentation for @huggingface/inference (#1807)

Resolves:
#1806

Author: lforst

.agents/skills/instrumentation/SKILL.md

@@ -28,6 +28,7 @@ Map the change before editing:
 - Support both auto-instrumentation and manual instrumentation. Auto-instrumentation does not cover every environment, loader, or framework.
 - For orchestrion auto-instrumentation, prefer targeting public API functions. Instrumenting internal helpers is more likely to break across library versions.
 - Auto and manual paths should share logic. Prefer both paths emitting the same tracing-channel events, with provider plugins converting those events into spans/logs/errors. Manual wrappers should not directly emit observability data.
+- Reuse shared repo utilities before introducing local helpers. Check `js/util/index.ts`, neighboring instrumentation files, and existing plugins/wrappers for utilities like `isObject`, merge helpers, and sanitizers before adding ad hoc replacements.
 - If a public instrumentation surface changes, check whether the export surface also needs updates in `js/src/instrumentation/index.ts` or `js/src/exports.ts`.
 - Preserve async context propagation. Changes around tracing channels, stream patching, or loader hooks must keep the current span context across awaits and stream consumption.
 - Maintain isomorphic behavior. Node and browser/bundled paths must use compatible channel implementations and avoid channel-registry mismatches.

.env.example

@@ -4,4 +4,5 @@ ANTHROPIC_API_KEY=
 GEMINI_API_KEY=
 OPENROUTER_API_KEY=
 MISTRAL_API_KEY=
+HUGGINGFACE_API_KEY=
 COHERE_API_KEY=

.github/workflows/e2e-canary.yaml

@@ -38,6 +38,7 @@ jobs:
           OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
           OPENROUTER_API_KEY: ${{ secrets.OPENROUTER_API_KEY }}
           MISTRAL_API_KEY: ${{ secrets.MISTRAL_API_KEY }}
+          HUGGINGFACE_API_KEY: ${{ secrets.HUGGINGFACE_API_KEY }}
         run: pnpm test:e2e:canary
       - name: Create or update nightly canary issue
         if: ${{ failure() && github.event_name == 'schedule' }}

.github/workflows/integration-tests.yaml

@@ -31,6 +31,7 @@ jobs:
       GEMINI_API_KEY: ${{ secrets.GEMINI_API_KEY }}
       OPENROUTER_API_KEY: ${{ secrets.OPENROUTER_API_KEY }}
       MISTRAL_API_KEY: ${{ secrets.MISTRAL_API_KEY }}
+      HUGGINGFACE_API_KEY: ${{ secrets.HUGGINGFACE_API_KEY }}
     steps:
       - uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5 # v4.3.1
       - uses: actions/setup-node@49933ea5288caeca8642d1e84afbd3f7d6820020 # v4.4.0
@@ -60,6 +61,7 @@ jobs:
       OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
       OPENROUTER_API_KEY: ${{ secrets.OPENROUTER_API_KEY }}
       MISTRAL_API_KEY: ${{ secrets.MISTRAL_API_KEY }}
+      HUGGINGFACE_API_KEY: ${{ secrets.HUGGINGFACE_API_KEY }}
     steps:
       - uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5 # v4.3.1
       - uses: denoland/setup-deno@ff4860f9d7236f320afa0f82b7e6457384805d05 # v2.0.4
@@ -110,6 +112,7 @@ jobs:
       OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
       OPENROUTER_API_KEY: ${{ secrets.OPENROUTER_API_KEY }}
       MISTRAL_API_KEY: ${{ secrets.MISTRAL_API_KEY }}
+      HUGGINGFACE_API_KEY: ${{ secrets.HUGGINGFACE_API_KEY }}
     steps:
       - uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5 # v4.3.1
       - uses: actions/setup-node@49933ea5288caeca8642d1e84afbd3f7d6820020 # v4.4.0

e2e/README.md

@@ -117,6 +117,7 @@ Non-hermetic scenarios require provider credentials in addition to the mock Brai
 - `GEMINI_API_KEY` or `GOOGLE_API_KEY`
 - `OPENROUTER_API_KEY`
 - `MISTRAL_API_KEY`
+- `HUGGINGFACE_API_KEY`
 - `COHERE_API_KEY`
 
 `claude-agent-sdk-instrumentation` also uses `ANTHROPIC_API_KEY`, because it runs the real Claude Agent SDK against Anthropic in the same style as the existing live Anthropic wrapper coverage.

e2e/config/pr-comment-scenarios.json

@@ -33,6 +33,16 @@
       { "variantKey": "google-genai-v1460", "label": "v1.46.0" }
     ]
   },
+  {
+    "scenarioDirName": "huggingface-instrumentation",
+    "label": "HuggingFace Instrumentation",
+    "metadataScenario": "huggingface-instrumentation",
+    "variants": [
+      { "variantKey": "huggingface-v281", "label": "v2.8.1" },
+      { "variantKey": "huggingface-v3150", "label": "v3.15.0" },
+      { "variantKey": "huggingface-v41315", "label": "v4.13.15" }
+    ]
+  },
   {
     "scenarioDirName": "mistral-instrumentation",
     "label": "Mistral Instrumentation",

e2e/helpers/scenario-installer.ts

@@ -21,13 +21,14 @@ const CANARY_MODE_ENV = "BRAINTRUST_E2E_MODE";
 const INSTALL_SECRET_ENV_VARS = [
   "ANTHROPIC_API_KEY",
   "BRAINTRUST_API_KEY",
+  "COHERE_API_KEY",
   "GEMINI_API_KEY",
   "GITHUB_TOKEN",
   "GH_TOKEN",
+  "HUGGINGFACE_API_KEY",
   "OPENAI_API_KEY",
   "OPENROUTER_API_KEY",
   "MISTRAL_API_KEY",
-  "COHERE_API_KEY",
 ] as const;
 
 const cleanupDirs = new Set<string>();