[bot] Mistral OCR API (`client.ocr.process()`) not instrumented
メンテナーはふだん 1 日以内に返信
まだ誰も着手していません。
評価
- 難易度
- 4/5
- 見積もり時間
- 3〜5日
- 初心者へのやさしさ
- 58/100
- issue の種類
- 機能追加
- 明瞭さ
- 明確に書かれている
- 活発さ
- 静か
- 技術スタック
- typescript
調査の方向性
まず、js/src/wrappers/mistral.ts、js/src/auto-instrumentations/configs/mistral.ts、js/src/instrumentation/plugins/mistral-channels.ts、js/src/instrumentation/plugins/mistral-plugin.ts、js/src/vendor-sdk-types/mistral.ts にある既存の Mistral 実装を読みます。既存のモデルメソッドのパターンを比較し、e2e/scenarios/mistral-instrumentation/ を確認します。client.ocr.process() が wrapper、config、channel、plugin、vendor types、end-to-end instrumentation scenario にわたってカバーされれば完了です。
索引モデルが issue の本文から書いたものです。
説明
Summary
The @mistralai/mistralai TypeScript SDK provides a stable client.ocr.process() method for document understanding using the Mistral OCR model. This repo has zero instrumentation for the OCR API surface — no channels, no plugin handler, no wrapper proxy, and no auto-instrumentation config. Users calling client.ocr.process() get no Braintrust spans.
What instrumentation is missing
- Wrapper (
js/src/wrappers/mistral.ts): Only proxieschat,embeddings,fim, andagentsproperties (lines 78–95). No proxy forocr. - Auto-instrumentation config (
js/src/auto-instrumentations/configs/mistral.ts): Only defines configs for chat, embeddings, FIM, and agents methods. No config forocr.process. - Channels (
js/src/instrumentation/plugins/mistral-channels.ts): No channel definition for OCR. - Plugin (
js/src/instrumentation/plugins/mistral-plugin.ts): No handler for OCR calls. - Vendor types (
js/src/vendor-sdk-types/mistral.ts):MistralClientonly declareschat,fim,agents, andembeddingsproperties. Noocrproperty.
A grep for ocr (case-insensitive) across js/src/ returns zero matches.
Why this is a concrete gap
Mistral OCR is a dedicated model execution API — it sends document/image input to a model and receives generated structured text output (markdown with bounding boxes, extracted images, and page metadata). This is directly comparable to how generateContent works for Google GenAI. It uses a specific model (mistral-ocr-2503-completion) and returns token-like processing results. It is not a CRUD or management endpoint.
Braintrust docs status
not_found — The Braintrust Mistral integration page at https://www.braintrust.dev/docs/integrations/ai-providers/mistral documents chat completions only. OCR is not mentioned.
Upstream references
- Mistral OCR API endpoint: https://docs.mistral.ai/api/endpoint/ocr
- Mistral OCR capability docs: https://docs.mistral.ai/capabilities/document_ai/basic_ocr
- Mistral TypeScript SDK OCR docs: https://github.com/mistralai/client-ts/blob/main/docs/sdks/ocr/README.md
- SDK method:
client.ocr.process({ model, document, ... })— returnsPromise<OCRResponse> - Parameters include:
model,document(URL or file),pages,table_format,include_image_base64,image_limit, and annotation format options.
Precedent in this repo
This repo instruments 8 other Mistral SDK methods across 4 API categories (chat, embeddings, FIM, agents). OCR is a comparable model execution surface. Additionally, Google GenAI's generateContent (which processes multimodal input and returns structured text) is instrumented with the same depth.
Local files inspected
js/src/wrappers/mistral.tsjs/src/auto-instrumentations/configs/mistral.tsjs/src/instrumentation/plugins/mistral-channels.tsjs/src/instrumentation/plugins/mistral-plugin.tsjs/src/vendor-sdk-types/mistral.tse2e/scenarios/mistral-instrumentation/
- 主要言語
- TypeScript
- スター
- 29
- フォーク
- 16
- 平均マージ
- 1日 19時間
- マージ済み PR（30日）
- 69
環境構築
- Dockerfile または Docker Compose ファイルあり
- プルリクエストのテンプレートなし
- コントリビューションガイドなし
はじめの一歩
- issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
- 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
- リポジトリをフォークし、ブランチを切って変更します。
- issue 番号を参照したプルリクエストを送ります。
braintrustdata/braintrust-sdk-javascript のほかの issue
-
難易度 4/5 3〜5日 初心者へのやさしさ 48/100
braintrustdata/braintrust-sdk-javascript#2605 ·
メンテナーはふだん 1 日以内に返信
-
難易度 5/5 1週間以上 初心者へのやさしさ 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 が 1 日前に担当しました。 オープンtypescript
難易度 4/5 3〜5日 初心者へのやさしさ 55/100
braintrustdata/braintrust-sdk-javascript#2577 ·
メンテナーはふだん 1 日以内に返信
braintrustdata/braintrust-sdk-javascript の issue をすべて見る
似ている issue
-
ui(ListToolbar): search takes the full row on a phone instead of sharing it with the result countオープン
難易度 2/5 1〜3時間 初心者へのやさしさ 64/100
メンテナーはふだん 1 日以内に返信
-
priority:high
難易度 2/5 1〜3時間 初心者へのやさしさ 72/100
メンテナーはふだん 1 日以内に返信
-
難易度 2/5 1〜3時間 初心者へのやさしさ 78/100
メンテナーはふだん 1 日以内に返信
-
難易度 2/5 1〜3時間 初心者へのやさしさ 65/100
immich-app/immich#32426 ·
メンテナーはふだん 1 日以内に返信
-
documentation good first issue hacktoberfest help wanted
難易度 2/5 1〜3時間 初心者へのやさしさ 78/100
libredb/libredb-studio#1756 ·
メンテナーはふだん 1 日以内に返信