[bot] LiveKit Agents for Node.js (`@livekit/agents`) not instrumented in the JS SDK — Braintrust's own integration docs are Python-only (449,224 weekly downloads)
维护者通常 1 天内回复
评估
- 难度
- 5/5
- 预计耗时
- 一周以上
- 新手友好度
- 45/100
- Issue 类型
- 功能
- 描述清晰度
- 基本清楚
- 活跃度
- 冷清
- 技术栈
- node.js, typescript
- 领域
- observability, tooling
调研方向
首先阅读 js/src/wrappers/、js/src/instrumentation/plugins/、js/src/auto-instrumentations/configs/ 和 js/src/instrumentation/config.ts 下现有的布局，然后检查 e2e/scenarios/ 中是否有可比较的集成。完成的标准是：Issue 中列出的 LiveKit Agents 接口都具备 instrumentation 覆盖、配置和端到端场景。
由索引模型根据 Issue 内容生成。
描述
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
- 主要语言
- TypeScript
- 星标
- 29
- 派生
- 16
- 平均合并
- 1 天 16 小时
- 30 天内合并 PR
- 64
环境准备
- 提供 Dockerfile 或 Docker Compose 文件
- 没有 Pull Request 模板
- 没有贡献指南
从这里开始
- 先读完整个 Issue，再读项目的贡献指南。
- 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
- Fork 仓库，在一个分支上完成修改。
- 提交 Pull Request，并在描述里引用这个 Issue 编号。
braintrustdata/braintrust-sdk-javascript 的其他 Issue
-
难度 4/5 3-5 天 新手友好度 48/100
braintrustdata/braintrust-sdk-javascript#2605 ·
维护者通常 1 天内回复
-
难度 5/5 一周以上 新手友好度 35/100
braintrustdata/braintrust-sdk-javascript#2604 ·
维护者通常 1 天内回复
-
难度 4/5 3-5 天 新手友好度 52/100
braintrustdata/braintrust-sdk-javascript#2603 ·
维护者通常 1 天内回复
-
typescript
难度 4/5 3-5 天 新手友好度 55/100
braintrustdata/braintrust-sdk-javascript#2578 ·
维护者通常 1 天内回复
-
[bot] Instrument Letta Agent SDK (143,425 weekly downloads)可能已有人在做 @karthiksenv 今天认领。 未关闭typescript
难度 4/5 3-5 天 新手友好度 55/100
braintrustdata/braintrust-sdk-javascript#2577 ·
维护者通常 1 天内回复
查看 braintrustdata/braintrust-sdk-javascript 的全部 Issue
相似的 Issue
-
难度 1/5 1 小时以内 新手友好度 83/100
维护者通常 1 天内回复
-
Feil lovtekst i bekreftelsen når leder melder unntak fra oppfølgingsplan可能已有人在做 @AudunSorheim 今天认领。 未关闭
难度 1/5 1 小时以内 新手友好度 92/100
navikt/syfo-oppfolgingsplan-frontend#1110 ·
维护者通常 1 天内回复
-
难度 2/5 1-3 小时 新手友好度 78/100
db-ux-design-system/core-web#8461 ·
维护者通常 1 天内回复
-
难度 2/5 1-3 小时 新手友好度 78/100
维护者通常 1 天内回复
-
Cannot run an integration on windows when power shell is selected as the default profile terminal未关闭Priority/Blocker Type/Bug
难度 2/5 1-3 小时 新手友好度 76/100
wso2/product-integrator#2767 ·
维护者通常 1 天内回复