[cunninghamcard-bit]

Summary

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

上游 2 个测试文件共 97 个用例：

• 88 个有对应测试并通过，全部是新写的：provider 62 个、转写 26 个。原有的 tests/azure_upstream_e2e_test.rs 12 个测试里有 9 个带 /// TS: "…" 出处，但只比部分字段，出处改成 /// partial: … 注释，指向完整用例所在的文件（单独一个提交，函数体不变）。
• 9 个写进 layout.toml 的手写排除：
  • 8 个 sub-feature（Provider 构造与配置：迁移后遗留缺口 #275）：Azure 上的 DeepSeek 模型 4 个、completion() 2 个，aimux 都没移植；embedding 的单次输入字节上限 1 个，aimux 的 EmbeddingModel 只有 max_embeddings_per_call()；转写的 workflow 序列化往返 1 个，aimux 的模型不能序列化。
  • 1 个 ts-only：用 vi.spyOn 替换 OpenAITranscriptionModel.prototype.doStream，Rust 模型没有可替换的接缝。

Azure 复用 OpenAI 的模型代码，迁移中发现的 3 处差异都在 OpenAI 共用代码里，原先各自单独一个 fix PR（#323 合并了三处），现在三处都已随 OpenAI 的 fix PR #368 合入 master，#323 已关闭：

• fix: OpenAI file search sends max_num_results as an integer #321：file search 的 max_num_results 是 f64，请求体里发成 5.0，上游发 5。
• fix: OpenAI Responses stream reports a null response id #322：流里没有 response.created 时，结束时的 responseId 是 ""，上游是 null。
• fix: OpenAI Responses reasoning deltas carry the item id #323：推理 delta 不带 provider metadata，上游每个 delta 都带 { azure: { itemId } }。

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

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

cargo test -p aimux-providers
  ├─ unittests src/lib.rs                                       azure 一个都没有
  └─ tests/*.rs
       ├─ azure_upstream_e2e_test.rs            12 个   出处写成 /// TS: "…"，不带 describe 链，只比部分字段
       └─ package_user_agent_test.rs             1 处   ai-sdk-azure/4.0.84
            create_azure(AzureOpenAIProviderSettings { .. })                     azure/mod.rs:177
            ├ AzureOpenAIProvider::chat / responses                             :457 / :469
            │ └ crate::openai 的 Chat / Responses 模型，provider 名 azure.chat / azure.responses
            │   └ OpenAIResponsesLanguageModel → ResponsesStreamTransformer     openai/responses/responses_convert.rs
            │       ├ "response.reasoning_summary_text.delta"                   :1059（#323 改）
            │       └ flush → providerMetadata.azure.responseId                 :1517（#322 改）
            ├ AzureOpenAIProvider::embedding / image / speech                   :482 / :492 / :522   OpenAI 模型
            ├ AzureOpenAIProvider::transcription → AzureTranscriptionModel      :503
            │ └ do_generate：按 providerOptions.azure.api 选 OpenAI 转写或 Azure Speech   azure/transcription.rs:172
            │   do_stream：Speech 直接拒绝，OpenAI 转交                          :364
            ├ AzureOpenAIProvider::call / Provider::language_model              :534 / :544
            └ tools：crate::openai::tools::AzureOpenAITools                     openai/tools.rs:766
                └ file_search(FileSearchArgs { max_num_results: Option<f64> })  :199（#321 改）

上游 packages/azure/src/ 对应：

azure-openai-provider.test.ts       69   createAzure(...).responses / chat / embedding / image / transcription / speech，createTestServer
azure-transcription-model.test.ts   28   AzureTranscriptionModel（定义在 azure-openai-provider.ts），mock fetch + 录制的 MAI-Transcribe-2 响应

改动前 aimux 没有一个测试带上游的完整 describe 链。

二、本 PR 的改动（细节）

1. 新测试目录（azure/mod.rs 末尾 #[cfg(test)] mod tests;）

cargo test -p aimux-providers --lib azure::                            88 个
  src/azure/tests/mod.rs             mod openai_provider; mod transcription_model;
  openai_provider.rs        62 个   mod responses_default_language_model / chat / transcription / speech /
                                    embedding / image / responses / resource_name_validation
    provider(fetch) / azure_with(..) → create_azure(..)                                   :99 / :87
    responses › do_generate / do_stream：fixtures/*.json、*.chunks.txt 回放，
      generate_json / stream_json 与 snapshots/*.json 比（上游 __snapshots__ 转成 JSON）   :283 / :298
      renumber_source_ids：source id 按出现顺序改成 id-0、id-1，对应上游的 mockId      :257
    file_search_tool → provider.tools.file_search(FileSearchArgs { max_num_results: Some(5), .. })   :323
  transcription_model.rs    26 个   mod api_routing / speech_requests / speech_responses /
                                    streaming_and_serialization / recorded_mai_transcribe_2_responses / provider
    setup(settings, body) → RouteFetch 按 URL 分 OpenAI 转写和 Speech                      :110
  fixtures/、snapshots/              上游 __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（只有 [azure]）

src/azure-openai-provider.ts                   mapped → azure/mod.rs
  sub-feature 8，issue = 275：deepseek ×4、completion ×2、embedding 单次输入上限、workflow 序列化
  ts-only 1：delegates OpenAI streaming without changing call options
  （azure-transcription-model.test.ts 没有同名源文件，它测的 AzureTranscriptionModel 在这个文件里，排除也列在这里）
src/azure-openai-tools.ts                      elsewhere → openai/tools.rs
src/azure-openai-provider-metadata.ts          mapped → azure/options.rs
src/azure-speech-transcription-model{,-options}.ts、azure-transcription-model-options.ts、
  azure-transcription-provider-metadata.ts     mapped → azure/transcription.rs
src/index.ts                                   mapped → azure/mod.rs
src/version.ts                                 not-applicable

3. tests/azure_upstream_e2e_test.rs：9 个测试上的 11 行 /// TS: "…" 改成 /// partial: …; full port in src/azure/tests/<file>.rs。

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

• 上游的 createModel 自己拼 URL 和 headers 建 OpenAIResponsesLanguageModel，这里用 provider.responses(..)，差别只在这些用例不比的 URL 和鉴权头。
• user-agent 比 ai-sdk-azure/4.0.84（钉住的版本），不比上游 mock 的 0.0.0-test；比对发出的 headers 时去掉 user-agent，单独比。
• InvalidArgument 只带 message，argument: 'resourceName' 改比变体和 message，并确认没有发请求。
• 中止用例比 AiMuxError::Aborted，不比同一个错误对象；AbortSignal 的同一性改为取消调用方的 signal、看 transport 收到的那份是否跟着取消。
• 快照里值为 undefined 的键在 JSON 里省略，Date 写成 ISO 字符串。

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 223（其中 azure 88），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 的厂商表。
• 97 个上游用例和标记逐条对过：88 个各有一个标记，9 个在 layout.toml 的手写排除里。
• RFC-0045 §3.1 假定 foo.test.ts 测 foo.ts；azure-transcription-model.test.ts 是第一个没有同名源文件的，这里把它的排除挂在定义 AzureTranscriptionModel 的 azure-openai-provider.ts 上，并在 layout.toml 里注明。
• 基线是 master：三处 OpenAI 修复随 fix: OpenAI Responses, chat, transcription and image behaviour match the AI SDK #368 合入后，fix: OpenAI Responses reasoning deltas carry the item id #323 关闭，本 PR 改基到 master 并合入 master（f6279139，master 209be26）。合并时 openai_upstream_e2e_test.rs 和 CHANGELOG 取 master 的版本（fix: OpenAI Responses reasoning deltas carry the item id #323 的改动 master 都有）；azure_upstream_e2e_test.rs 保留了 fix: OpenAI Responses, chat, transcription and image behaviour match the AI SDK #368 新加的 image_input_capabilities_are_unknown_for_deployments，注释改成和其他用例一样的 partial 写法；layout.toml 是 master 的原文后接 azure 表。
• 跟踪 测试：补迁上游 AI SDK 测试（按用例名约 18% 对上） #278；DeepSeek、completion、embedding 上限、workflow 序列化的缺口挂在 Provider 构造与配置：迁移后遗留缺口 #275，行为差异挂在 Core 运行时：与 AI SDK 的剩余差距（对齐文档 §9.1 已知差距） #276。

---

Generated by Claude Code

[cunninghamcard-bit]

说明里提到的「测试文件没有同名源文件」，check.mjs 该怎么处理，已记到 #278（https://github.com/arcships/aimux/issues/278#issuecomment-6288575903）。本 PR 不变。

---

Generated by Claude Code

[eric8810]

Azure test port：88 tests + 9 exclusions = 97，16 个 snapshots/18 个 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.

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