[bot] Fireworks AI TypeScript SDK (`@fireworksai/sdk`) not instrumented — no tracing for chat completions, embeddings, or image generation (77 weekly downloads)
Mantenedores costumam responder em até 1 dia
Ninguém assumiu esta issue ainda.
Avaliação
- Dificuldade
- 4/5
- Tempo estimado
- 3-5 dias
- Facilidade para iniciantes
- 55/100
- Tipo de issue
- Funcionalidade
- Clareza
- Razoavelmente clara
- Status de atividade
- Ativa
- Stack de tecnologia
- typescript
- Domínio
- observability-sre
Direção de pesquisa
Comece pelas configurações existentes em js/src/auto-instrumentations/configs/, pelos wrappers em js/src/wrappers/, pelos plugins em js/src/instrumentation/plugins/ e por e2e/scenarios/. Revise como as integrações atuais lidam com os métodos de @fireworksai/sdk listados na issue e, em seguida, adicione cobertura e um cenário e2e; está concluído quando chamadas diretas de chat, completion, embedding, image, audio e streaming produzirem spans do Braintrust.
Escrita pelo modelo de indexação a partir do texto da issue.
Descrição
Summary
Fireworks AI publishes an official TypeScript SDK: @fireworksai/sdk on npm (currently in beta, requires zod peer dependency). It provides execution APIs for chat completions, text completions, embeddings, image generation, and audio transcription via Fireworks AI's own REST API client, with HTTP requests powered by fetch. This repository has zero instrumentation for any @fireworksai/sdk surface — no wrapper, no channels, no plugin, no auto-instrumentation config. Users who call @fireworksai/sdk directly get no Braintrust spans.
What instrumentation is missing
The @fireworksai/sdk npm package exposes these execution surfaces, none of which are instrumented:
| SDK Method | Description |
|---|---|
client.chat.completions.create({ model, messages }) |
Chat completions with tool calling and structured outputs |
client.chat.completions.create({ ..., stream: true }) |
Streaming chat completions |
client.completions.create({ model, prompt }) |
Text completions |
client.embeddings.create({ model, input }) |
Text embeddings (OpenAI-compatible format) |
client.images.generate({ model, prompt }) |
Text-to-image generation |
client.audio.transcriptions.create(...) |
Audio transcription |
The SDK uses its own fetch-based HTTP client (with Zod for request/response validation) and does not use the openai npm package internally. Existing openai auto-instrumentation does not cover calls made through @fireworksai/sdk.
No coverage in any instrumentation layer:
- No wrapper function (e.g.
wrapFireworks()) - No diagnostics channels for Fireworks AI methods
- No plugin handler in
js/src/instrumentation/plugins/ - No auto-instrumentation config in
js/src/auto-instrumentations/configs/ - No e2e test scenarios
- Grep for
fireworks(case-insensitive) acrossjs/src/returns zero instrumentation matches
Indirect coverage is insufficient:
Braintrust's Fireworks AI integration page documents a gateway/OpenAI SDK approach — using the openai npm client pointed at the Braintrust gateway with Fireworks model identifiers. Users who call @fireworksai/sdk directly — which ships Fireworks' own type-safe TypeScript API client — get no spans at all under that approach.
Braintrust docs status
not_found for direct SDK instrumentation. The Braintrust Fireworks integration page documents a gateway/OpenAI SDK approach only and does not reference @fireworksai/sdk.
Upstream references
@fireworksai/sdknpm: https://www.npmjs.com/package/@fireworksai/sdk- Fireworks AI GitHub org: https://github.com/fw-ai
- Fireworks AI serverless quickstart: https://docs.fireworks.ai/getting-started/quickstart
- Fireworks AI embeddings & reranking: https://docs.fireworks.ai/guides/querying-embeddings-models
Local files inspected
js/src/auto-instrumentations/configs/— full config list:anthropic.ts,openai.ts,ai-sdk.ts,groq.ts,mistral.ts,cohere.ts,huggingface.ts,google-genai.ts,google-adk.ts,genkit.ts,openai-agents.ts,openrouter.ts,openrouter-agent.ts,claude-agent-sdk.ts,cursor-sdk.ts,github-copilot.ts,openai-codex.ts,flue.ts— no Fireworks AI config presentjs/src/wrappers/— nofireworks.tswrapper filejs/src/instrumentation/plugins/— no Fireworks AI channels or plugine2e/scenarios/— no Fireworks AI test scenarios- Full repo grep for
fireworks(case-insensitive) injs/src/— zero instrumentation matches @fireworksai/sdkinstall notes — confirmedfetch-based HTTP client withzodpeer dependency; noopenairuntime dependency
- Linguagem predominante
- TypeScript
- Estrelas
- 29
- Forks
- 21
- Merge médio
- 1d 13h
- PRs com merge (30d)
- 67
Preparar o ambiente
- Inclui um Dockerfile ou arquivo Docker Compose
- Sem modelo de pull request
- Sem guia de contribuição
Primeiros passos
- Leia a issue inteira e depois o guia de contribuição do projeto.
- Comente na issue dizendo que vai assumir — evita que duas pessoas façam o mesmo trabalho.
- Faça um fork do repositório e trabalhe em uma branch.
- Abra um pull request que referencie o número da issue.
Mais de braintrustdata/braintrust-sdk-javascript
-
Pi Coding Agent instrumentation double-counts tokens and estimated cost in trace rollups (AgentSession.prompt carries summed LLM usage)Talvez já em andamento @sharonadhitya assumiu há 1 dia. Aberta
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 72/100
braintrustdata/braintrust-sdk-javascript#2659 · 1 comentário ·
Mantenedores costumam responder em até 1 dia
-
Dificuldade 4/5 3-5 dias Facilidade para iniciantes 45/100
braintrustdata/braintrust-sdk-javascript#2662 ·
Mantenedores costumam responder em até 1 dia
-
AI SDK tool spans don't respect `toModelOutput`Talvez já em andamento @AbhiPrasad assumiu há 2 dias. Abertatypescript
braintrustdata/braintrust-sdk-javascript#2651 · 1 comentário · 1 responsável ·
Mantenedores costumam responder em até 1 dia
-
High TypeScript checking cost from generated Zod 3 schemasTalvez já em andamento @lforst assumiu há 9 dias. Aberta
Dificuldade 4/5 3-5 dias Facilidade para iniciantes 22/100
braintrustdata/braintrust-sdk-javascript#2624 · 1 comentário · 1 responsável ·
Mantenedores costumam responder em até 1 dia
-
[bot] Instrument Luma AI (17,324 weekly downloads)Talvez já em andamento @karthiksenv assumiu há 9 dias. Abertatypescript
Dificuldade 4/5 3-5 dias Facilidade para iniciantes 55/100
braintrustdata/braintrust-sdk-javascript#2578 ·
Mantenedores costumam responder em até 1 dia
Todas as issues de braintrustdata/braintrust-sdk-javascript
Issues semelhantes
-
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 68/100
cline/cline#15327 · 1 comentário ·
Mantenedores costumam responder em até 1 dia
-
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 78/100
LogicLabs-OU/OpenArchiver#509 ·
-
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 78/100
bigcapitalhq/bigcapital#1545 · 1 comentário ·
Mantenedores costumam responder em até 1 dia
-
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 76/100
-
bug
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 83/100
Mantenedores costumam responder em até 1 dia