[cunninghamcard-bit]

Summary

按 RFC-0045（#281）把 @ai-sdk/xai@5.0.12 的上游测试迁完，按厂商分批的第六个（Mistral #295、Cohere #296、DeepSeek #299、Groq #301、Hugging Face #303）。

上游 15 个测试文件共 367 个用例：

• 297 个有对应测试并通过：原有 36 个补上出处标记，新增 261 个。
• 66 个所在的源文件没有迁：Files API 25 个、图片模型 23 个是 missing（Provider 构造与配置：迁移后遗留缺口 #275）；Batch 16 个、Realtime 2 个是 not-applicable（对齐文档写明本期不做）。
• 4 个记为 sub-feature：provider 的 3 个 imageModel 用例（Provider 构造与配置：迁移后遗留缺口 #275，aimux 没有 xAI 图片模型）；视频 doStatus 的 expired 用例要比对 response，aimux 的错误状态是 Err，不带响应信息（Core 运行时：与 AI SDK 的剩余差距（对齐文档 §9.1 已知差距） #276）。

迁移中发现两处行为差异，各自单独一个 fix PR，都已合入 master：

• fix: xAI streaming transcription connect failure errors the stream #310：流式转写连接失败时，aimux 让 do_stream 直接返回 Err；上游 doStream 照常返回，错误从流里出来。
• fix: dropping an xAI streaming transcription closes the socket #311：流式转写的流被丢弃时，aimux 不发 WebSocket 关闭帧；上游取消流时会调 connection.close()。

另有一处只是错误类型不同，没有当作差异修：流里的 error、response.failed 事件，上游产出 createProviderStreamError 的对象（带 type、code），aimux 产出 AI_APICallError（providerCode 存上游的 code，type 留在 data 里）。message、statusCode、isRetryable、data 都和上游一致。这 3 个用例经一个视图函数改名后比对，期望值没改。

位置按新定的布局：xAI 的新测试全放 src/xai/tests/，一个上游测试文件对应一个 Rust 文件。原有的 tests/xai_*_test.rs 留在原地，由包拆分线程的搬移 PR 合进来。

一、体系概览：xAI 的测试现在怎么跑（master b91829af）

cargo test -p aimux-providers
  ├─ unittests src/lib.rs                                   xAI 一个都没有
  └─ tests/*.rs
       ├─ xai_speech_test.rs           17 个 ┐
       ├─ xai_transcription_test.rs    18 个 ├ 出处写成 /// TS: "…" 或文件头注释，不带 describe 链
       ├─ xai_video_test.rs            34 个 │
       └─ xai_upstream_e2e_test.rs      5 个 ┘ 只比部分字段
            create_xai(XAIProviderSettings { .. })                  xai/mod.rs:319
            ├ XAIProvider::responses / call                         xai/mod.rs:385 / :419
            │ └ XaiResponsesModel::do_generate / do_stream          xai/responses/mod.rs:216 / :506
            │   ├ build_responses_request_body                      responses/convert.rs:717
            │   │ ├ convert_to_xai_responses_input                  responses/convert.rs:425
            │   │ └ prepare_responses_tools                         responses/convert.rs:99
            │   ├ convert_xai_responses_usage                       responses/convert.rs:43
            │   └ transform_event → "error" / "response.failed"     responses/mod.rs:872 / :886
            │       └ xai_stream_error → stream_error_api_call      xai/mod.rs:83   产出 AI_APICallError
            ├ XAIProvider::speech        → XaiSpeechModel::do_generate          xai/speech.rs:157
            ├ XAIProvider::transcription → XaiTranscriptionModel::do_generate   xai/transcription.rs:134
            │                              └ do_stream（WebSocket）             xai/transcription.rs:210（#310、#311 改）
            ├ XAIProvider::video         → XaiVideoModel::do_start / do_status  xai/video.rs:699 / :729
            └ Provider::image_model                                 xai/mod.rs:437   → NoSuchModel

上游 packages/xai/src/ 对应：

responses/xai-responses-language-model.test.ts   101   createTestServer → provider.responses(...).doGenerate / doStream
  createXaiResponsesStreamError                         xai-responses-language-model.ts:57-81 → createProviderStreamError
xai-video-model.test.ts                           76   createTestServer → XaiVideoModel.doStart / doStatus
responses/xai-responses-prepare-tools.test.ts     35   直接调 prepareResponsesTools
files/xai-files.test.ts                           25   XaiFiles（aimux 没有）
xai-image-model.test.ts                           23   XaiImageModel（aimux 没有）
responses/convert-to-xai-responses-input.test.ts  22   直接调 convertToXaiResponsesInput
xai-transcription-model.test.ts                   20   createTestServer / MockWebSocket → doGenerate / doStream
xai-speech-model.test.ts                          17   createTestServer → XaiSpeechModel.doGenerate
xai-provider.test.ts                              16   createXai → 各 model 方法
xai-batch.test.ts                                 16   Batch（本期不做）
responses/convert-xai-responses-usage.test.ts      6   直接调 convertXaiResponsesUsage
其余 4 个文件                                      10   raw usage 3、error 3、supports-reasoning-effort 2、realtime 2

改动前 74 个原有测试里只有 36 个能和上游用例一一对应，出处只写了 it 文本，没有 describe 链。

二、本 PR 的改动（细节）

1. 原有测试补标记（tests/xai_speech_test.rs、xai_transcription_test.rs、xai_video_test.rs、xai_upstream_e2e_test.rs）

mod xai_speech_model › mod do_generate                         xai_speech_test.rs          15 个标记
mod do_generate / mod do_stream                                xai_transcription_test.rs    9 个标记
mod xai_video_model › mod do_start / mod do_status             xai_video_test.rs           12 个标记
  /// upstream: @ai-sdk/xai src/xai-video-model.test.ts › XaiVideoModel › doStatus › should return pending when status is pending
xai_upstream_e2e_test.rs                                       5 个都只比部分字段，改成 /// partial: … 注释

一一对应的加标记、按 describe 包 mod；只覆盖了部分断言或换了输入的不加标记，注释写明完整用例在 src/xai/tests/ 的哪个文件。函数体不变。#310、#311 各加的 1 个 aimux 测试在 xai_transcription_test.rs 末尾。

2. 剩下的上游用例（新目录，xai/mod.rs 末尾 #[cfg(test)] mod tests;）

cargo test -p aimux-providers --lib xai::                            262 个
  src/xai/tests/mod.rs                       mod error; mod provider; mod responses; mod speech_model; …
  src/xai/tests/responses/
    responses_language_model.rs            101 个   公开 API：create_xai → responses(..).do_generate / do_stream
      stream_fetch(events) → run_stream → 与上游 toMatchInlineSnapshot / snapshots/*.json 比      :201 / :230
      stream_provider_error_view(part)                                                        :263
        AI_APICallError 的 providerCode → code、data.type → type，其余字段原样，期望值不动
    responses_prepare_tools.rs              35 个   prepare_responses_tools(..)
    convert_to_responses_input.rs           22 个   convert_to_xai_responses_input(..)
    convert_responses_usage.rs               6 个   convert_xai_responses_usage(..)
    responses_raw_usage.rs                   3 个
    fixtures/ snapshots/                            上游 __fixtures__、__snapshots__ 原样拷贝
  src/xai/tests/video_model.rs              64 个   其中 expired 用例只比 error 文本，不带标记（sub-feature）
  src/xai/tests/provider.rs                 13 个   #[serial]，读 XAI_API_KEY
  src/xai/tests/transcription_model.rs      11 个   MockConnector / MockSocket 代替 MockWebSocket   :343 / :279
  src/xai/tests/error.rs、speech_model.rs、supports_reasoning_effort.rs   3 / 2 / 2 个
  src/test_support/mod.rs                    #[path = "../../tests/common/mock_fetch.rs"] mod mock_fetch;   lib.rs 末尾 #[cfg(test)] mod test_support;
scripts/check_provider_boundaries.sh         规则 7c、8b 的 find 跳过 */tests/*（同 #[cfg(test)] 块）

3. aimux-providers/layout.toml（只有 [xai]）

42 个上游源文件：19 个 mapped（rust 是现在的源文件名）
  xai-provider.ts             sub-feature 3 条，issue = 275：imageModel
  xai-video-model.ts          sub-feature 1 条，issue = 276：错误状态不带 response
files/*（3）、tool/*（9）、xai-image-*（3）          missing，issue = 275
realtime/*（4）、xai-batch.ts、map-xai-finish-reason.ts（只给 batch 用）   not-applicable，对齐文档本期范围外
version.ts、xai-video-settings.ts                    not-applicable

harness 上的差别（期望值都没改）：快照里值为 undefined 的键在 JSON 里省略；上游靠 _internal.currentDate 注入固定日期，Rust 侧没有这个入口，改成检查时间戳落在调用前后之间；undici 的 multipart boundary 只比 multipart/form-data; boundary= 前缀；user-agent 比 ai-sdk-xai/5.0.12；result.stream.cancel() 换成丢弃流，await flush() 换成等关闭帧发出。

Type of change

• Bug fix (non-breaking)
• New feature (non-breaking)
• Breaking change
• New provider
• New / updated binding
• Docs / RFC
• Tests（上游测试迁移）

Checklist

• cargo +1.99 fmt -p aimux-providers -- --check passes
• cargo +1.99 clippy -p aimux-providers --lib --tests -- -D warnings passes
• cargo +1.99 test -p aimux-providers：lib 397（其中 xai 262）、xai_speech 17、xai_transcription 20、xai_video 34、xai_upstream_e2e 5，以及用到 xAI 的 cassette_full、cassette_multimodal、conformance、data_loss_regression、openai_compatible、package_user_agent、vertex_upstream_e2e，全过
• scripts/check_provider_boundaries.sh passes
• Commit messages follow Conventional Commits

Notes for reviewers

• 和 test: port the upstream Mistral tests #295、test: port the upstream Cohere tests #296、test: port the upstream DeepSeek tests #299、test: port the upstream Groq tests #301、test: port the upstream Hugging Face tests #303 一样新建了 src/test_support/mod.rs、aimux-providers/layout.toml，并改了边界脚本的同两行；这几处在各 PR 里内容相同，后合入的只需合并 layout.toml 的厂商表。
• 367 个上游用例和标记逐条对过：297 个各有一个标记，66 个在 missing / not-applicable 的源文件下，4 个在 layout.toml 的手写排除里。
• 基线是 master：fix: dropping an xAI streaming transcription closes the socket #311 合入后改基到 master 并合入 master（15571d85，master 209be26）；layout.toml 是 master 的原文后接 xai 表。
• 跟踪 测试：补迁上游 AI SDK 测试（按用例名约 18% 对上） #278；图片模型、Files API、工具工厂的缺口挂在 Provider 构造与配置：迁移后遗留缺口 #275，视频错误状态挂在 Core 运行时：与 AI SDK 的剩余差距（对齐文档 §9.1 已知差距） #276。

---

Generated by Claude Code

[eric8810]

xAI test port：297 个 marker + 4 个 layout case 覆盖 367 个 in-scope case，11 个 fixtures 逐字节一致，无生产变化。Approve。

[eric8810]

Rebase is content-preserving: only master/parent merges and CHANGELOG/layout conflict resolution; tests and CI unchanged. Re-approving current head.

[eric8810]

Rebase verified content-preserving: only master/parent merges and CHANGELOG/layout conflict resolution; CI 16/16. Re-approving current head.

[eric8810]

Rebase verified content-preserving: only master/parent merges and conflict resolution; CI 16/16. Re-approving current head.

[cunninghamcard-bit]

Flutter example (android) failed on 0ca5568 while Gradle was still configuring :app: the Android SDK manager's NDK r28c download stalled at 16% and sdkmanager exited 1 after 27 minutes, before any project code was built. This PR only changes Rust tests under aimux-providers and doesn't touch the Flutter binding or the Android toolchain. The same download failure hit #361 this hour and passed on re-run, so I've re-run the failed jobs once here too.

---

Generated by Claude Code

---

Generated by Claude Code

[eric8810]

Rebase verified content-preserving: only master/parent merges and conflict resolution; CI 16/16. Re-approving current head.

[eric8810]

Rebase verified content-preserving: only master merges and conflict resolution; CI 16/16. Re-approving current head.

[eric8810]

Rebase verified content-preserving: only master merges and conflict resolution; CI 16/16. Re-approving current head.