[bot] LiveKit Agents for Node.js (`@livekit/agents`) not instrumented in the JS SDK — Braintrust's own integration docs are Python-only (819,555 weekly downloads)
Maintainer antworten meist innerhalb von 1 Tag
Bewertung
- Schwierigkeit
- 5/5
- Geschätzter Aufwand
- Über eine Woche
- Anfängerfreundlichkeit
- 45/100
- Issue-Typ
- Feature
- Klarheit
- Größtenteils klar
- Aktivitätsstatus
- Ruhig
- Tech-Stack
- node.js, typescript
- Bereich
- observability, tooling
Rechercherichtung
Beginne damit, die vorhandenen Layouts unter js/src/wrappers/, js/src/instrumentation/plugins/, js/src/auto-instrumentations/configs/ und js/src/instrumentation/config.ts zu lesen, und untersuche anschließend e2e/scenarios/ auf vergleichbare Integrationen. Als abgeschlossen gilt die Aufgabe, wenn die im Issue aufgeführten LiveKit Agents-Oberflächen über Instrumentierung, Konfiguration und ein End-to-End-Szenario verfügen.
Vom Indexierungsmodell aus dem Issue-Text verfasst.
Beschreibung
Summary
LiveKit publishes @livekit/agents on npm — the official Node.js distribution of the LiveKit Agents framework (source: livekit/agents-js on GitHub) for building realtime, multimodal voice/video AI agents that pipeline STT → LLM → TTS with tool-calling, turn detection, and session tracing hooks. It is actively maintained with regular releases and its own reference docs. This JavaScript SDK repository has zero instrumentation for any @livekit/agents execution surface — no wrapper, no diagnostics channel, no plugin, no auto-instrumentation config, no e2e scenario.
What instrumentation is missing
| SDK Surface | Description |
|---|---|
AgentSession run/turn execution |
Orchestrates a realtime multimodal agent session (STT → LLM → TTS pipeline) |
LLM turns issued through agent plugins (e.g. @livekit/agents-plugin-openai, -anthropic, -google) |
Model calls made through LiveKit's own plugin abstraction rather than directly through an instrumented provider SDK |
Function/tool calls (llm.FunctionTool execution during a session) |
Tool-calling during agent execution |
| STT/TTS pipeline stages | Speech-to-text and text-to-speech legs of the realtime pipeline |
None of these are covered by any existing plugin in this repo. Even when a LiveKit agent uses an underlying provider that this repo already instruments (e.g. OpenAI), calls routed through LiveKit's own plugin layer are not guaranteed to hit the same code paths patched by the existing per-provider auto-instrumentation, and there is no session/pipeline-level span for the agent turn itself.
No coverage in any instrumentation layer:
- No wrapper function in
js/src/wrappers/ - No channel definitions or plugin in
js/src/instrumentation/plugins/ - No auto-instrumentation config in
js/src/auto-instrumentations/configs/ - No e2e test scenario under
e2e/scenarios/ - Full repo grep for
livekit(case-insensitive) returns zero matches anywhere injs/,integrations/, ore2e/
Braintrust docs status
supported for Python only. Braintrust documents a LiveKit Agents integration at https://www.braintrust.dev/docs/integrations/agent-frameworks/livekit-agents, but it is built on OpenTelemetry configuration through Braintrust's Python SDK, tracing the Python livekit-agents package. The docs do not mention @livekit/agents (the Node.js distribution) or any JavaScript/TypeScript setup. This mirrors a documented Python/JS parity gap pattern already seen in this repo's instrumentation coverage (compare to the Python-only Firebase Genkit gap that was previously filed and fixed for the JS side in this repo).
Upstream references
- npm package: https://www.npmjs.com/package/@livekit/agents
- Official Node.js Agents SDK GitHub: https://github.com/livekit/agents-js
- Agents for Node.js reference docs: https://docs.livekit.io/reference/agents-js/
- Agents framework overview: https://docs.livekit.io/agents/
Local files inspected
js/src/wrappers/— no LiveKit wrapperjs/src/instrumentation/plugins/— no LiveKit channels or plugin filejs/src/auto-instrumentations/configs/— no LiveKit config entryjs/src/instrumentation/config.ts—InstrumentationIntegrationsConfighas no LiveKit-related keye2e/scenarios/— no LiveKit test scenario- Full repo grep for
livekit(case-insensitive) — zero matches
Weekly downloads: 819,555 (as of 2026-10-14; window 2026-10-06 to 2026-10-12; source https://api.npmjs.org/downloads/point/last-week/@livekit/agents)
- Vorherrschende Sprache
- TypeScript
- Sterne
- 29
- Forks
- 16
- Ø Merge
- 1 T. 15 Std.
- Gemergte PRs (30 T.)
- 69
Entwicklungsumgebung
- Enthält ein Dockerfile oder eine Docker-Compose-Datei
- Keine Pull-Request-Vorlage
- Kein Beitragsleitfaden
Erste Schritte
- Lesen Sie das ganze Issue und danach den Beitragsleitfaden des Projekts.
- Schreiben Sie ins Issue, dass Sie es übernehmen — das erspart doppelte Arbeit.
- Forken Sie das Repository und arbeiten Sie in einem Branch.
- Öffnen Sie einen Pull Request, der die Issue-Nummer nennt.
Mehr aus braintrustdata/braintrust-sdk-javascript
-
High TypeScript checking cost from generated Zod 3 schemasEvtl. vergeben @lforst hat das vor 1 Tag übernommen. Offen
Schwierigkeit 4/5 3-5 Tage Anfängerfreundlichkeit 22/100
braintrustdata/braintrust-sdk-javascript#2624 · 1 Kommentar · 1 zugewiesene Person ·
Maintainer antworten meist innerhalb von 1 Tag
-
[bot] Instrument Luma AI (17,324 weekly downloads)Evtl. vergeben @karthiksenv hat das vor 1 Tag übernommen. Offentypescript
Schwierigkeit 4/5 3-5 Tage Anfängerfreundlichkeit 55/100
braintrustdata/braintrust-sdk-javascript#2578 ·
Maintainer antworten meist innerhalb von 1 Tag
-
[bot] Instrument Letta Agent SDK (87,205 weekly downloads)Evtl. vergeben @karthiksenv hat das vor 4 Tagen übernommen. Offentypescript
Schwierigkeit 4/5 3-5 Tage Anfängerfreundlichkeit 55/100
braintrustdata/braintrust-sdk-javascript#2577 ·
Maintainer antworten meist innerhalb von 1 Tag
-
Schwierigkeit 4/5 3-5 Tage Anfängerfreundlichkeit 55/100
braintrustdata/braintrust-sdk-javascript#2527 · 1 Kommentar ·
Maintainer antworten meist innerhalb von 1 Tag
-
Schwierigkeit 4/5 3-5 Tage Anfängerfreundlichkeit 65/100
braintrustdata/braintrust-sdk-javascript#2526 ·
Maintainer antworten meist innerhalb von 1 Tag
Alle Issues in braintrustdata/braintrust-sdk-javascript
Ähnliche Issues
-
bnv-manager-v2: accept_invite creates the Mailcow domain admin before the commitEvtl. vergeben @myOmikron hat das heute übernommen. Offenbug ready-for-agent
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 82/100
-
Windows: mio 1.2.3 named-pipe use-after-free panics the native IPC broker and hangs every toolOffenplatform:windows tool triaged wontfix
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 62/100
Maintainer antworten meist innerhalb von 1 Tag
-
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 72/100
Maintainer antworten meist innerhalb von 1 Tag
-
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 82/100
nicolettas-muggelbude/RechnungsFee#448 ·
Maintainer antworten meist innerhalb von 1 Tag
-
Android bug feature/error-tracking react-native team/error-tracking
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 72/100
PostHog/posthog-js#5310 · 1 Kommentar ·
Maintainer antworten meist innerhalb von 1 Tag