[cunninghamcard-bit]

Summary

按 RFC-0045（#281）把 @ai-sdk/open-responses@2.0.58 的上游测试迁完，按厂商分批的第九个（Mistral #295、Cohere #296、DeepSeek #299、Groq #301、Hugging Face #303、xAI #312、Anthropic AWS #319、Azure #324）。

上游 5 个测试文件共 124 个用例：

• 93 个有对应测试并通过：
  • 新写 57 个：provider 1 个、输入转换 20 个、语言模型 36 个。
  • 原有的 tests/open_responses_test.rs 里已经完整覆盖的 36 个（finish reason 8 个、输入转换 17 个、语言模型 11 个）直接加上 /// upstream: … 标记。另有 31 处只覆盖了一部分，加 /// partial: … 注释指向完整用例。这两类改动单独一个提交，函数体不变。
• 19 个写进 layout.toml 的手写排除：
  • 18 个 sub-feature（Provider 构造与配置：迁移后遗留缺口 #275）：
    • 扩展注册表相关的 10 个：历史回放 5 个、provider tool 编码 3 个、流事件解码 2 个。
    • customToolId 自定义工具 3 个。
    • strictResponseInput 2 个。
    • getResponseErrorMetadata 2 个。
    • 带扩展时拒绝 workflow 序列化 1 个。
  • 1 个 registered（SSE 预读）：流的第一个事件就是 error 时，aimux 的 do_stream 直接返回 Err，不进流。
• 12 个未迁：open-responses-extension.test.ts 整个文件。它测的 createOpenResponsesExtensionRegistry 在 aimux 里没有，layout.toml 里这个文件和 open-responses-tools.ts 都标成 missing，挂 Provider 构造与配置：迁移后遗留缺口 #275。

迁移中发现 16 处行为差异，都修在 #346 里，一处一个提交（每个提交带一个在 master 上失败的测试），#346 已合入 master：

提交	差异
996eaea1	回放 assistant 文本时丢了 item id 和 url_citation 标注
4cfcd02d	用户图片不带 detail（上游默认 auto，可由 providerOptions 指定）
cfac970a	用户内联文件没有按完整 media type 解析
53ea2cf6	用户文件是 provider 引用或文本文件时，上游报 UnsupportedFunctionality，aimux 只给警告
9e54ca4a	回放 tool call 时丢了 item id
787f45ef	输出的 reasoning、文本、tool call 不带 provider metadata（itemId 等）
3eb0e5f0	只有 summary 的 reasoning item 不产出 reasoning
506be6b7	流里的 response.reasoning_summary_text.delta 被忽略
278fb9ec	流结束时没收尾的 reasoning，结束事件不带 item id
2aab71e8	流里 tool call 的参数取累积的 delta，上游取完成事件里的完整参数
0b1433db	流里的 response.failed 和 error 事件没有变成 error part
d3865fa7	无 schema 的 JSON 输出没有发 { "type": "json_object" }
61e808d9	provider-defined tool 没有警告，tool choice 指向它时没有清空
38892609	不读 providerOptions.<name>.reasoningEffort
c8afdf3f	成功响应里带 error 时，status 和 data 跟上游不一致
211a1385	响应里缺 output 时，错误类型跟上游不一致

位置按新定的布局：新测试全放 src/open_responses/tests/，一个上游测试文件对应一个 Rust 文件。

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

cargo test -p aimux-providers
  ├─ unittests src/lib.rs                                       open_responses 一个都没有
  └─ tests/*.rs
       ├─ open_responses_test.rs                70 个   11 个出处写成 /// TS: `…test.ts:行号`，不带 describe 链
       └─ package_user_agent_test.rs             1 处   ai-sdk-open-responses/2.0.58
            create_open_responses(OpenResponsesProviderSettings { .. })        open_responses.rs:181
            └ OpenResponsesProvider::responses(model_id)                       :230
              └ OpenResponsesModel
                ├ do_generate                                                  :294
                │ ├ build_request_body(options)                                :852
                │ │ └ convert_to_open_responses_input(prompt)                  :1039
                │ │   └ _with_namespace(prompt, provider_options_name)        :1045
                │ └ 解析 output → content / usage / finish reason
                │     └ map_open_responses_finish_reason                       :823
                └ do_stream                                                    :434
                  └ OpenResponsesStream（SSE 事件 → StreamPart）               :518

上游 packages/open-responses/src/ 对应：

open-responses-extension.test.ts                      12   createOpenResponsesExtensionRegistry
open-responses-provider.test.ts                        3   createOpenResponses(...)，getResponseErrorMetadata
responses/convert-to-open-responses-input.test.ts     41   convertToOpenResponsesInput
responses/map-open-responses-finish-reason.test.ts     8   mapOpenResponsesFinishReason
responses/open-responses-language-model.test.ts       60   OpenResponsesLanguageModel.doGenerate / doStream，createTestServer + __fixtures__

二、本 PR 的改动（细节）

1. 新测试目录（open_responses.rs 末尾 #[cfg(test)] mod tests;，:1788）

cargo test -p aimux-providers --lib open_responses::                    57 个
  src/open_responses/tests/mod.rs        mod provider; mod responses;
  provider.rs                    1 个   mod endpoint_specific_response_error_metadata
  responses/mod.rs                      mod convert_to_input; mod language_model; mod map_finish_reason;
  responses/convert_to_input.rs 20 个   mod convert_to_open_responses_input › system_messages / user_messages /
                                         assistant_messages / tool_messages / provider_reference /
                                         top_level_only_media_type_resolution
    convert(prompt) / convert_with(name, prompt) → convert_to_open_responses_input_with_namespace   :30 / :39
  responses/language_model.rs   36 个   mod open_responses_language_model
                                         › do_generate › basic_generation / manual_history_replay / tools /
                                           provider_options_reasoning / tool_call_parsing / tool_choice /
                                           system_messages / pdf_input_file
                                         › do_stream › basic_generation / reasoning_with_tool_call / pdf_input_file
    create_model(model_id, responses) → provider.responses(..) + MockFetch                    :46
    json_fixture / chunks_fixture：fixtures/*.json、*.chunks.txt 回放                        :55 / :75
    snapshot!(name)：与 snapshots/*.json 比（上游 __snapshots__ 转成 JSON）                    :37
  responses/map_finish_reason.rs         只有文档注释：8 个用例在 tests/open_responses_test.rs 里已经覆盖并标了出处
  fixtures/（7 个）、snapshots/（13 个）  上游 __fixtures__ 原样拷贝；快照每个 toMatchSnapshot 一个文件
  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)] 块）

2. aimux-providers/layout.toml（只有 [open_responses]）

src/index.ts                                         mapped → open_responses.rs
src/open-responses-extension.ts                      missing，issue = 275
src/open-responses-provider.ts                       mapped，sub-feature 2：getResponseErrorMetadata
src/open-responses-tools.ts                          missing，issue = 275
src/responses/convert-to-open-responses-input.ts     mapped，sub-feature 4：strictResponseInput ×2、自定义工具结果 ×2
src/responses/map-open-responses-finish-reason.ts    mapped
src/responses/open-responses-{api,config,language-model-options}.ts   mapped
src/responses/open-responses-language-model.ts       mapped
  registered 1，ref = "SSE 预读"：preserves $expectedType stream errors
  sub-feature 12：workflow 序列化、扩展回放 ×5、扩展 tool ×3、扩展流事件 ×2、自定义工具输入
src/version.ts                                       not-applicable

3. tests/open_responses_test.rs：36 个测试加 /// upstream: @ai-sdk/open-responses src/<file> › <describe 链>，原来的 11 行 /// TS: …:行号 换成这个；31 处加 /// partial: …; full port in src/open_responses/tests/<file>.rs。

harness 上的差别（期望值都没改）：

• 上游的 createModel 直接 new OpenResponsesLanguageModel，这里用 create_open_responses(..).responses(..)，差别只在这些用例不比的 URL 和 headers。
• 错误比 AiMuxError 的变体和字段，不比同一个错误对象；UnsupportedFunctionalityError 对应 UnsupportedFunctionality(functionality)。
• 快照里值为 undefined 的键在 JSON 里省略。

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 192（其中 open_responses 57），129 个测试二进制全过
• 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 的厂商表。
• 124 个上游用例和标记逐条对过：93 个各有一个标记，19 个在 layout.toml 的手写排除里，12 个是 missing 文件里的。
• map-open-responses-finish-reason.test.ts 的 8 个用例全在旧文件里有完整覆盖，所以 map_finish_reason.rs 只留一段说明，不重复写。
• 基线是 master（Open Responses 的 16 处修复在 fix: Open Responses missing output is an API call error #346 里，已合入）。
• 跟踪 测试：补迁上游 AI SDK 测试（按用例名约 18% 对上） #278；扩展注册表、自定义工具、strictResponseInput、getResponseErrorMetadata 的缺口挂在 Provider 构造与配置：迁移后遗留缺口 #275，行为差异挂在 Core 运行时：与 AI SDK 的剩余差距（对齐文档 §9.1 已知差距） #276。

---

Generated by Claude Code

[eric8810]

Verified the post-approval commits on this head: only additive tests/docs or tightened boundary checks; no weakening or behavior regression. Re-approving the current head.

[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.

[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.

[eric8810]

Rebase verified content-preserving: only master merges and layout.toml 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.