Hacktoberfest 2026:维护者为十月标记出来的 issue,仍然开放、适合新手。 浏览 Hacktoberfest issue

[bot] Instrument BAML (275,854 weekly downloads)

未关闭
#2,604 0 条评论 0 个 reaction 已指派 0 人 在 GitHub 查看

维护者通常 1 天内回复

还没有人认领这个 Issue。

评估

难度
5/5
预计耗时
一周以上
新手友好度
35/100
Issue 类型
功能
描述清晰度
基本清楚
活跃度
活跃
技术栈
typescript
领域
observability

调研方向

Start by reading js/src/auto-instrumentations/configs/all.ts and js/src/span-origin.ts, then inspect existing instrumentation and end-to-end scenarios under e2e/scenarios/ for their patterns. Add coverage for generated BAML calls, its lower-level request API, and tool-calling flows; done means these execution paths produce Braintrust spans and the integration has end-to-end scenario coverage.

由索引模型根据 Issue 内容生成。

描述

Summary

@boundaryml/baml is the TypeScript runtime for BAML (Basically A Made-up Language), BoundaryML's typed language for defining LLM functions. BAML functions compile to generated TS client code; calling a generated function drives BAML's own runtime, which renders the prompt, builds the HTTP request, calls the configured LLM provider (OpenAI, Anthropic, and others), streams the response, and schema-aligned-parses the result into a typed output — including tool/function-calling flows. None of this execution surface produces any Braintrust spans today, and the library is entirely absent from this repo.

What's missing

  • Generated BAML function calls (the high-level API: b.FunctionName(...)/.stream()), which perform the actual prompt render → LLM request → response parse cycle — this is the model-execution surface.
  • BAML's lower-level API (b.request.FunctionName(...) / response parsers) for callers that build the HTTP request/response handling themselves.
  • Tool-calling support inside BAML functions (functions that return structured tool-call objects based on an LLM response).

None of baml, boundaryml, BamlRuntime, or baml_client (case-insensitive) appear anywhere in js/src/, js/src/auto-instrumentations/configs/all.ts (the instrumentation registry), js/src/span-origin.ts (INSTRUMENTATION_NAMES), or any e2e/scenarios/* directory.

Weekly downloads

Weekly downloads: 275,854 (as of 2026-10-12; window 2026-10-04–2026-10-10; source https://api.npmjs.org/downloads/point/last-week/@boundaryml/baml)

Braintrust docs status

not_found — Checked https://www.braintrust.dev/docs/guides/traces/integrations (full enumerated list of tracing integrations: OpenTelemetry, Temporal, Vercel AI SDK, OpenRouter, LangChain, LangChain4j, LangSmith, LlamaIndex, Apollo GraphQL, Cloudflare Workers AI, DSPy, Google Discovery Engine, Instructor, LiteLLM, Ruby LLM, Spring AI, Traceloop, TrueFoundry — plus the separate agent-framework list) and https://www.braintrust.dev/docs (general docs search) — no mention of BAML or BoundaryML anywhere.

Upstream sources

Local repo files inspected

  • js/src/auto-instrumentations/configs/all.ts (full instrumentation registry — no BAML entry)
  • js/src/span-origin.ts (INSTRUMENTATION_NAMES — no BAML entry)
  • Repo-wide case-insensitive search for baml/boundaryml/bedrock-agent-runtime across the working tree (zero relevant matches for BAML)
  • e2e/scenarios/ directory listing (no BAML-named scenario)
主要语言
TypeScript
星标
29
派生
16
平均合并
1 天 16 小时
30 天内合并 PR
64

环境准备

  • 提供 Dockerfile 或 Docker Compose 文件
  • 没有 Pull Request 模板
  • 没有贡献指南

从这里开始

  1. 先读完整个 Issue,再读项目的贡献指南。
  2. 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
  3. Fork 仓库,在一个分支上完成修改。
  4. 提交 Pull Request,并在描述里引用这个 Issue 编号。

braintrustdata/braintrust-sdk-javascript 的其他 Issue

查看 braintrustdata/braintrust-sdk-javascript 的全部 Issue

相似的 Issue

更多 TypeScript Issue

把新 issue 发到你的邮箱

精选适合新手参与的 GitHub issue 摘要。