[bot] Cerebras Cloud TypeScript SDK (`@cerebras/cerebras_cloud_sdk`) not instrumented — no tracing for fast-inference chat completions or embeddings (126,155 weekly downloads)
メンテナーはふだん 1 日以内に返信
まだ誰も着手していません。
評価
- 難易度
- 4/5
- 見積もり時間
- 3〜5日
- 初心者へのやさしさ
- 68/100
- issue の種類
- 機能追加
- 明瞭さ
- おおむね明確
- 活発さ
- 活発
- 技術スタック
- node.js, typescript
調査の方向性
まず js/src/auto-instrumentations/configs/ にある既存の設定、特に openai.ts、groq.ts、mistral.ts を読み、次に js/src/wrappers/ と js/src/instrumentation/plugins/ を調べて対応するパターンを確認します。Cerebras chat completions、streaming、completions、embeddings のカバレッジを追加し、e2e/scenarios/ に auto-instrumentation 設定と e2e シナリオを追加します。完了条件は、@cerebras/cerebras_cloud_sdk の直接呼び出しで Braintrust spans が生成されることです。
索引モデルが issue の本文から書いたものです。
説明
Summary
Cerebras publishes an official TypeScript SDK for their ultra-fast LLM inference API: @cerebras/cerebras_cloud_sdk on npm (v1.64.1, actively maintained). It provides execution APIs for chat completions, completions, embeddings, and streaming responses. The SDK has its own HTTP client based on node-fetch — it does not depend on the openai npm package. This repository has zero instrumentation for any Cerebras SDK surface — no wrapper, no channels, no plugin, no auto-instrumentation config. Users who call @cerebras/cerebras_cloud_sdk directly get no Braintrust spans.
What instrumentation is missing
The @cerebras/cerebras_cloud_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 use, structured outputs, and reasoning |
client.chat.completions.create({ ..., stream: true }) |
Streaming chat completions |
client.completions.create({ model, prompt }) |
Raw text completions |
client.embeddings.create(...) |
Text embeddings |
Cerebras is notable for extremely low-latency LLM inference (their wafer-scale hardware delivers tokens significantly faster than GPU-based providers), making observability especially valuable for latency-sensitive production workloads.
No coverage in any instrumentation layer:
- No wrapper function (e.g.
wrapCerebras()) - No diagnostics channels for Cerebras 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
cerebras(case-insensitive) acrossjs/src/returns zero matches
Indirect coverage is insufficient:
Braintrust's Cerebras integration page documents a gateway/OpenAI SDK approach only — using the openai npm client pointed at the Braintrust gateway to route to Cerebras models. Users who call @cerebras/cerebras_cloud_sdk directly get no spans at all. The Cerebras SDK has its own separate HTTP layer (runtime deps: node-fetch, abort-controller, agentkeepalive, form-data-encoder, formdata-node) and is not patched by the existing openai auto-instrumentation.
Braintrust docs status
not_found for direct SDK instrumentation. The Braintrust Cerebras integration page documents a gateway/OpenAI SDK approach only and does not reference @cerebras/cerebras_cloud_sdk.
Upstream references
@cerebras/cerebras_cloud_sdknpm: https://www.npmjs.com/package/@cerebras/cerebras_cloud_sdk- Cerebras Cloud SDK Node.js GitHub: https://github.com/Cerebras/cerebras-cloud-sdk-node
- Cerebras inference quickstart: https://inference-docs.cerebras.ai/quickstart
- Cerebras API reference: https://inference-docs.cerebras.ai/api-reference/chat-completions
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 Cerebras config presentjs/src/wrappers/— nocerebras.tswrapper filejs/src/instrumentation/plugins/— no Cerebras channels or plugine2e/scenarios/— no Cerebras test scenarios- Full repo grep for
cerebras(case-insensitive) injs/src/— zero matches - Cerebras SDK
package.json(GitHub) — confirmed runtime deps arenode-fetch/agentkeepalive/form-data-encoder; noopenaidependency
- 主要言語
- TypeScript
- スター
- 29
- フォーク
- 16
- 平均マージ
- 1日 20時間
- マージ済み PR(30日)
- 70
環境構築
- Dockerfile または Docker Compose ファイルあり
- プルリクエストのテンプレートなし
- コントリビューションガイドなし
はじめの一歩
- issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
- 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
- リポジトリをフォークし、ブランチを切って変更します。
- issue 番号を参照したプルリクエストを送ります。
braintrustdata/braintrust-sdk-javascript のほかの issue
-
typescript
難易度 4/5 3〜5日 初心者へのやさしさ 55/100
braintrustdata/braintrust-sdk-javascript#2578 ·
メンテナーはふだん 1 日以内に返信
-
typescript
難易度 4/5 3〜5日 初心者へのやさしさ 55/100
braintrustdata/braintrust-sdk-javascript#2577 ·
メンテナーはふだん 1 日以内に返信
-
難易度 4/5 3〜5日 初心者へのやさしさ 55/100
braintrustdata/braintrust-sdk-javascript#2527 · コメント 1 件 ·
メンテナーはふだん 1 日以内に返信
-
難易度 4/5 3〜5日 初心者へのやさしさ 65/100
braintrustdata/braintrust-sdk-javascript#2526 ·
メンテナーはふだん 1 日以内に返信
-
難易度 4/5 3〜5日 初心者へのやさしさ 56/100
braintrustdata/braintrust-sdk-javascript#2482 ·
メンテナーはふだん 1 日以内に返信
braintrustdata/braintrust-sdk-javascript の issue をすべて見る