[bot] Mistral OCR API (`client.ocr.process()`) not instrumented
Maintainer thường phản hồi trong vòng 1 ngày
Chưa có ai nhận issue này.
Đánh giá
- Độ khó
- 4/5
- Thời gian dự kiến
- 3-5 ngày
- Mức phù hợp với người mới
- 58/100
- Loại issue
- Tính năng
- Độ rõ ràng
- Đặc tả rõ ràng
- Mức độ hoạt động
- Ít trao đổi
- Công nghệ
- typescript
- Lĩnh vực
- devtools, observability-sre
Hướng nghiên cứu
Bắt đầu bằng cách đọc các triển khai Mistral hiện có trong 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 và js/src/vendor-sdk-types/mistral.ts. So sánh các mẫu của những model method hiện có và kiểm tra e2e/scenarios/mistral-instrumentation/. Hoàn thành khi client.ocr.process() được bao phủ trong wrapper, config, channel, plugin, vendor types và end-to-end instrumentation scenario.
Do mô hình lập chỉ mục viết ra từ nội dung của issue.
Mô tả
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/
- Ngôn ngữ chính
- TypeScript
- Star
- 29
- Fork
- 16
- Merge trung bình
- 1 ngày 20 giờ
- Pull request đã merge (30 ngày)
- 70
Chuẩn bị môi trường
- Có Dockerfile hoặc tệp Docker Compose
- Không có mẫu pull request
- Không có hướng dẫn đóng góp
Bắt đầu từ đâu
- Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
- Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
- Fork repository và làm thay đổi trên một nhánh.
- Mở pull request có tham chiếu số hiệu của issue.
Issue khác của braintrustdata/braintrust-sdk-javascript
-
typescript
Độ khó 4/5 3-5 ngày Mức phù hợp với người mới 55/100
braintrustdata/braintrust-sdk-javascript#2578 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
typescript
Độ khó 4/5 3-5 ngày Mức phù hợp với người mới 55/100
braintrustdata/braintrust-sdk-javascript#2577 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
Độ khó 4/5 3-5 ngày Mức phù hợp với người mới 55/100
braintrustdata/braintrust-sdk-javascript#2527 · 1 bình luận ·
Maintainer thường phản hồi trong vòng 1 ngày
-
Độ khó 4/5 3-5 ngày Mức phù hợp với người mới 65/100
braintrustdata/braintrust-sdk-javascript#2526 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
Độ khó 4/5 3-5 ngày Mức phù hợp với người mới 56/100
braintrustdata/braintrust-sdk-javascript#2482 ·
Maintainer thường phản hồi trong vòng 1 ngày
Tất cả issue của braintrustdata/braintrust-sdk-javascript
Issue tương tự
-
Table: Space fires onActivate in single-selection mode — the reference doc and the JSDoc disagreeĐang mở
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 68/100
sidorares/react-x11-components#764 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 76/100
backnotprop/plannotator#1840 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 78/100
JoviDeCroock/pracht#432 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
Add: CNN en Espanol SDĐang mởapproved check:passed streams:add
Độ khó 1/5 Dưới một giờ Mức phù hợp với người mới 75/100
Maintainer thường phản hồi trong vòng 1 ngày
-
Hardware attribute name "app Connection Support" has inconsistent casingCó thể đã có người làm Có pull request liên kết đang mở hoặc đã được merge. Đang mở
Độ khó 1/5 Dưới một giờ Mức phù hợp với người mới 88/100
walletbeat/walletbeat#1628 ·
Maintainer thường phản hồi trong vòng 1 ngày