Hacktoberfest 2026:メンテナが10月に向けて印を付けた、オープンで初心者向けの issue。 Hacktoberfest の issue を見る

[bot] Cerebras Cloud TypeScript SDK (`@cerebras/cerebras_cloud_sdk`) not instrumented — no tracing for fast-inference chat completions or embeddings (126,155 weekly downloads)

オープン
#2,101 コメント 2 件 リアクション 0 件 担当者 0 名 GitHub で見る

メンテナーはふだん 1 日以内に返信

まだ誰も着手していません。

評価

難易度
4/5
見積もり時間
3〜5日
初心者へのやさしさ
68/100
issue の種類
機能追加
明瞭さ
おおむね明確
活発さ
活発
技術スタック
node.js, typescript
領域
observability

調査の方向性

まず 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) across js/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

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 present
  • js/src/wrappers/ — no cerebras.ts wrapper file
  • js/src/instrumentation/plugins/ — no Cerebras channels or plugin
  • e2e/scenarios/ — no Cerebras test scenarios
  • Full repo grep for cerebras (case-insensitive) in js/src/ — zero matches
  • Cerebras SDK package.json (GitHub) — confirmed runtime deps are node-fetch/agentkeepalive/form-data-encoder; no openai dependency
主要言語
TypeScript
スター
29
フォーク
16
平均マージ
1日 20時間
マージ済み PR(30日)
70

環境構築

  • Dockerfile または Docker Compose ファイルあり
  • プルリクエストのテンプレートなし
  • コントリビューションガイドなし

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

braintrustdata/braintrust-sdk-javascript のほかの issue

braintrustdata/braintrust-sdk-javascript の issue をすべて見る

似ている issue

TypeScript の issue をもっと見る

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。