[cunninghamcard-bit]

Summary

按 RFC-0045（#281）把 @ai-sdk/openai@4.0.83 的上游测试迁完，按厂商分批的最后一个（Mistral #295、Cohere #296、DeepSeek #299、Groq #301、Hugging Face #303、xAI #312、Anthropic AWS #319、Azure #324、Open Responses #347、Google Vertex #352、OpenAI-compatible #355、Amazon Bedrock #358、Anthropic #361、Google #363）。

上游 34 个测试文件，其中 25 个对应 aimux 已有的功能，共 780 个用例：

• 704 个新写了测试并通过，放在 src/openai/tests/，一个上游测试文件对应一个 Rust 文件。
• 28 个由原有的旧测试完整覆盖（embedding 2、image 12、speech 7、transcription 7），旧测试挪进按 describe 链命名的 mod，加上 /// upstream: 标记，函数名和函数体不变；另有 49 处旧测试只覆盖一部分，加了 /// partial: … 指向完整用例。
• 48 个写进 layout.toml：
  • 34 个 sub-feature（Provider 构造与配置：迁移后遗留缺口 #275）：Files 没有 get/download/delete 和流式上传（13 个），没有通用的 throwIfOpenAIStreamErrorBeforeOutput 帮助函数（7 个，同样的规则在 Responses 的 do_stream 里实现并由 doStream 用例覆盖），prompt 里的工具调用和结果 part 没有 provider_metadata（4 个），没有 parallel 包装调用的展开（5 个，另有 expand-parallel-tool-call.ts 整个文件 3 个），UnsupportedFunctionality 只带功能名、比不了上游的 message（2 个），嵌入模型没有单次输入字节上限、转写结果没有 usage、没有 supportsWebSearchSourcesInclude 设置、allowedTools 没有任意工具名映射（各 1 个）。
  • 11 个 ts-only：8 个 expectTypeOf 比较 zod 推出来的 TypeScript 类型，undefined 的工具输入和 undefined 的 header 值 Rust 表达不了，图片下载用的全局 fetch 在 Rust 里注入不了。
  • 另外 3 个属于 missing 的 responses/expand-parallel-tool-call.ts。

另外 9 个上游测试文件（live/ 3 个、realtime/ 3 个、openai-batch、skills/openai-skills、speech-translation/）测的是 aimux 没有的模块，源文件条目是 missing，挂 #275，用例不迁。

迁移中发现 36 处行为差异，修在 #368 里，一处一个提交，各带一个在 master 上失败的测试；其中 3 处是 #323 的同一改动，1 处是 #354 的同一改动，带上它们是为了这里的用例单独就能过。#368 已合入 master。四个用例按 aimux 已有的约定改了比法，见下面 harness 一节，也登记在 #276。

一、体系概览：OpenAI 的测试现在怎么跑（#368 分支 68ce701f）

cargo test -p aimux-providers
  ├─ unittests src/lib.rs                       openai 8 个（model.rs、convert.rs、responses/convert.rs 里的 #[cfg(test)]）
  └─ tests/*.rs
       ├─ openai_upstream_e2e_test.rs           回归测试和上游部分用例
       ├─ openai_image_test.rs                  22 个   ├─ openai_decision_test.rs        13 个
       ├─ openai_output_round_trip_test.rs      16 个   ├─ openai_transcription_test.rs   10 个
       ├─ openai_factory_test.rs                14 个   ├─ openai_speech_test.rs           8 个
       ├─ openai_transcription_stream_test.rs   13 个   ├─ openai_embedding_test.rs        6 个
       └─ openai_realtime_ws_replay_test.rs      1 个
            create_openai(OpenAIProviderSettings { .. })                openai/mod.rs:253   impl Provider :429
            ├ chat → OpenAIModel                                       :340   model.rs do_generate :166、do_stream :184
            ├ completion → OpenAICompletionModel                       :346   completion.rs
            ├ responses → OpenAIResponsesModel                         :355   responses/mod.rs do_generate :260、do_stream :296
            │   ├ convert_to_responses_input                           responses/convert.rs:132
            │   └ read_until_output（流在出内容前报错）                  responses/responses_convert.rs:482
            ├ embedding / image / speech / transcription               :363 / :391 / :397 / :403
            ├ evaluation → DecisionLanguageModel                       :382
            └ files → OpenAIFiles                                      :415   files.rs impl Files :105
            错误：openai_failed_response_handler / openai_stream_error   mod.rs:64 / :91

上游 packages/openai/src/ 的 25 个已迁测试文件（用例数）：

responses/openai-responses-language-model.test.ts   210    chat/openai-chat-language-model.test.ts          100
responses/convert-to-openai-responses-input.test.ts 135    responses/openai-responses-prepare-tools.test.ts  72
image/openai-image-model.test.ts                     34    chat/convert-to-openai-chat-messages.test.ts      34
transcription/openai-transcription-model.test.ts     31    responses/openai-responses-reasoning-effort-update 23
files/openai-files.test.ts                           22    responses/openai-responses-api.test.ts            19
completion/openai-completion-language-model.test.ts  18    chat/openai-chat-prepare-tools.test.ts            14
openai-stream-error.test.ts                          11    speech/openai-speech-model.test.ts                10
embedding/openai-embedding-model.test.ts              8    openai-language-model-capabilities.test.ts         8
openai-provider.test.ts                               7    normalize-openai-json-schema.test.ts               6
openai-evaluation.test.ts                             5    responses/openai-responses-computer.test.ts        4
responses/expand-parallel-tool-call.test.ts           3    openai-forward-compatible-defaults.test.ts         3
chat/convert-openai-chat-usage.test.ts                1    openai-error.test.ts                               1
responses/convert-to-openai-responses-input-tool-search.test.ts   1

二、本 PR 的改动

六个提交，按内容分组：

1 test(openai): port the provider, error, schema and capability tests
    src/lib.rs                       #[cfg(test)] mod test_support;
    src/test_support/mod.rs          #[path = "../../tests/common/mock_fetch.rs"] pub(crate) mod mock_fetch;
    src/openai/mod.rs                结尾 #[cfg(test)] mod tests;
    src/openai/tests/                provider.rs、error.rs、evaluation.rs、forward_compatible_defaults.rs、
                                     language_model_capabilities.rs、normalize_json_schema.rs、stream_error.rs、fixtures/
    tests/openai_decision_test.rs、openai_factory_test.rs     各 1 处 /// partial:
2 test(openai): port the chat and completion tests
    src/openai/tests/chat/           chat_language_model.rs、convert_to_chat_messages.rs、chat_prepare_tools.rs、
                                     convert_chat_usage.rs、fixtures/、snapshots/
    src/openai/tests/completion/     completion_language_model.rs、fixtures/
    src/openai/model.rs:95           convert_usage 改成 pub(super)（usage 用例直接调它）
    src/openai/convert.rs、model.rs、tests/openai_upstream_e2e_test.rs   /// partial:（e2e 里换掉原来的 /// TS: 行）
3 test(openai): port the Responses tests
    src/openai/tests/responses/      responses_language_model.rs、convert_to_responses_input.rs、
                                     convert_to_responses_input_tool_search.rs、responses_prepare_tools.rs、responses_api.rs、
                                     responses_computer.rs、responses_reasoning_effort_update.rs、expand_parallel_tool_call.rs、
                                     fixtures/、snapshots/
    src/openai/responses/convert.rs  prepare_responses_tools_for 改成 pub(crate)（allowedTools 用例直接调它）；2 处 /// partial:
4 test(openai): port the embedding, files and image tests
    src/openai/tests/{embedding,files,image}/
    tests/openai_embedding_test.rs、openai_image_test.rs     旧测试挪进 describe mod 加 /// upstream:
5 test(openai): port the speech and transcription tests
    src/openai/tests/{speech,transcription}/          realtime 的 doStream 用例在 #[cfg(feature = "realtime")] 下，用内存里的 MockWebSocket
    tests/openai_speech_test.rs、openai_transcription_test.rs、openai_transcription_stream_test.rs、
    openai_realtime_ws_replay_test.rs                 旧测试挪进 describe mod 加 /// upstream: 或 /// partial:
6 test(openai): map the upstream OpenAI files in layout.toml
    aimux-providers/layout.toml      只加 [openai]，77 个上游源文件

src/openai/tests/ 的用例跟着 cargo test -p aimux-providers --lib 跑，读调用：

openai::tests::<文件>::<describe mod>::<用例>
  └ create_openai(OpenAIProviderSettings { api_key, base_url, fetch: MockFetch, web_socket: MockWebSocket, .. })
      └ provider.responses(..) / chat(..) / … → do_generate / do_stream     与真实调用同一条路径
  直接调的内部函数：convert_to_responses_input、prepare_responses_tools_for、normalize_json_schema、convert_usage 等

共享进程状态： provider.rs 里 4 个用例改 OPENAI_BASE_URL，#[serial] 并在结束时恢复；lib 测试二进制里另有一个用例把它设成 "not a url"，所以所有新用例都显式传 base_url。其余用例不读也不改环境变量，不换进程默认 transport，没有全局计数器，不写临时文件，每个用例用自己的 MockFetch / MockWebSocket。

layout.toml 的 [openai]

61 个 mapped 到 openai/*.rs
live/*（4）、realtime/*（5）、openai-batch.ts、skills/*（2）、speech-translation/*（2）、
responses/expand-parallel-tool-call.ts                                missing，issue 275
version.ts                                                            not-applicable
files/openai-files.ts                 sub-feature 13
openai-stream-error.ts                sub-feature 7
responses/convert-to-openai-responses-input.ts   sub-feature 6，ts-only 1
responses/openai-responses-language-model.ts     sub-feature 5
responses/openai-responses-api.ts                ts-only 8
transcription/openai-transcription-model.ts      sub-feature 1，ts-only 1
embedding、image、responses/openai-responses-prepare-tools.ts    各 1

openai-evaluation、openai-forward-compatible-defaults、responses/openai-responses-computer、responses/openai-responses-reasoning-effort-update、responses/convert-to-openai-responses-input-tool-search 没有同名源文件，它们的排除写在所测的源文件下面。

harness 上的差别（期望值都没改，除了下面写明的比法）：

• 上游直接 new OpenAIResponsesLanguageModel(...)；这里用 create_openai 加 api_key、base_url、fetch 建，generateId 能注入的地方用 provider 设置注入。
• 请求体按 JS 读 JSON 的方式比（10.0 等于 10）；流里的错误 part 按上游形状比，上游 provider stream error 多出的 type 字段在 aimux 只留在 data.type 里，比的时候去掉。
• 坏 JSON 的报错只比 \nError message: 之前的部分，后面是 JS 运行时 JSON.parse 自己的文字。
• UnsupportedFunctionality、InvalidArgument 只带一个字符串，上游的 argument 等字段查不了，只比错误类型和消息。
• 按 aimux 已有约定改了比法的四个用例（登记在 Core 运行时：与 AI SDK 的剩余差距（对齐文档 §9.1 已知差距） #276）：
  • chat › doStream › should set .modelId for model-router request：aimux 的 Usage.raw 原样保留响应里的 usage（RFC-0016），上游快照是 zod 解析后的，少了 audio_tokens；改成快照里的字段是原始 usage 的子集，其余部分照旧全等。
  • doStream › late response.failed：错误 part 通过 ApiCallError 比，providerCode 对上游的 code；上游的 type 表达不了。
  • openai-provider › rejects an empty OPENAI_BASE_URL during provider creation：aimux 文档写明环境变量里的坏 base URL 在每次调用时报错而不是建 provider 时，改成建成功、第一次调用报 baseURL must be a non-empty string. 且不发请求。
  • transcription › doStream › should cancel the audio stream when the WebSocket constructor throws：aimux 的 WebSocket 转写在 do_stream 返回前就连上（RFC-0028），所以构造失败从 do_stream 本身返回；两处都接受，并照旧要求音频流被取消。

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 --all -- --check passes
• cargo +1.99 clippy -p aimux-providers -p aimux-provider-utils -p aimux-ops --lib --tests --all-features -- -D warnings passes
• cargo +1.99 test -p aimux-providers -p aimux-provider-utils -p aimux-ops --all-features：167 个测试二进制，3568 个测试通过（比 fix: OpenAI Responses, chat, transcription and image behaviour match the AI SDK #368 多 704 个）
• scripts/check_provider_boundaries.sh passes
• Commit messages follow Conventional Commits

Notes for reviewers

• 和前几个厂商的 PR 一样新建了 src/test_support/mod.rs、aimux-providers/layout.toml；这几处在各 PR 里内容相同，后合入的只需合并 layout.toml 的厂商表。
• 780 个上游用例和标记逐条对过：732 个各有一个标记，45 个在 layout.toml 的 tests 表里，3 个属于 missing 的源文件。上游有一个用例名以空格结尾（should extract response id metadata ），Rust 的标记行去掉了这个尾随空格。
• 基线是 master：fix: OpenAI Responses, chat, transcription and image behaviour match the AI SDK #368 合入后改基到 master 并合入 master（e79ddd01，master 209be26）；四个 OpenAI 测试文件的冲突取本 PR 的版本（master 上的版本和 fix: OpenAI Responses, chat, transcription and image behaviour match the AI SDK #368 分支头完全相同），layout.toml 是 master 的原文后接 openai 表。
• 跟踪 测试：补迁上游 AI SDK 测试（按用例名约 18% 对上） #278；行为差异挂在 Core 运行时：与 AI SDK 的剩余差距（对齐文档 §9.1 已知差距） #276，没做的功能挂在 Provider 构造与配置：迁移后遗留缺口 #275。

---

Generated by Claude Code

[eric8810]

OpenAI test port：704 tests/780 upstream cases accounted，无 skip、fixtures/snapshots 非空；在 #368 rebase 后 restack。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.