[cunninghamcard-bit]

Summary

按 RFC-0045（#281）把 @ai-sdk/amazon-bedrock@5.0.100 的上游测试迁完，按厂商分批的第十二个（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）。

上游 21 个测试文件共 518 个用例。anthropic/ 和 mantle/ 两个子 provider 的 61 个不在范围里：Bedrock-Anthropic（InvokeModel 走 Anthropic 消息体）aimux 没做，是对齐文档 §5 登记的产品选择；Mantle 在 aimux 里只是 registry 预设，做成完整 provider 挂在 #275。其余 457 个：

• 408 个新写了测试并通过，放在 src/bedrock/tests/，一个上游测试文件对应一个 Rust 文件。
• 28 个由原有的旧测试完整覆盖，旧测试挪进按 describe 链命名的 mod，加上 /// upstream: 标记，函数名和函数体不变；另有 87 处旧测试只覆盖了一部分，加了 /// partial: … 指向完整用例。这部分单独一个提交。
• 21 个写进 layout.toml：3 个 registered（SigV4 也给 GET 和无 body 的请求签名，§9.1 已知差距），4 个 sub-feature（Provider 构造与配置：迁移后遗留缺口 #275：没有 createAmazonBedrockCachePoint、provider 上没有 anthropicTools），10 个 ts-only，另外 inject-fetch-headers.ts 是上游包内的测试 helper（不导出），条目是 not-applicable，它的 4 个用例不迁，helper 本身在 tests/support.rs 里留了一份 Rust 版给嵌入、图像、重排序的测试用。

迁移中发现 7 处行为差异，修在 #357 里，一处一个提交，各带一个在 master 上失败的测试。#357 已合入 master：

提交	差异
e4ecf494	事件流 CRC 校验失败时报 @smithy/eventstream-codec 的原文，不再是 Invalid Amazon Bedrock event-stream frame
469c5403	不支持的文件 part 用上游的 functionality 名：file parts with provider references、File URL data（先查 s3: 再查媒体类型）、tool result file data of type "…"
38bc4a3c	convert_usage 的 raw 保留 Bedrock 发来的原对象，显式的 null 键不再丢
cb6aab13	doGenerate 里 toolUseId 为空时生成一个 id（流式本来就这样）
4a3354c3	拒收采样参数的模型，警告顺序按上游 temperature、topK、topP
866ce154	Nova 2 高推理时丢弃 maxOutputTokens 的警告带上模型 id
9abb06eb	没设 fetch 时，每次请求再取进程默认 transport（同 #318 对 Anthropic AWS 的改法）

一、体系概览：Amazon Bedrock 的测试现在怎么跑（master e115e723）

cargo test -p aimux-providers
  ├─ unittests src/lib.rs                     bedrock 6 个（event_stream.rs 里的 #[cfg(test)]）
  └─ tests/*.rs
       ├─ bedrock_convert_test.rs                51 个   消息转换、prepare_tools
       ├─ bedrock_remaining_test.rs              38 个   tool id、usage、provider、请求体
       ├─ bedrock_upstream_e2e_test.rs           12 个
       ├─ bedrock_user_agent_test.rs             10 个
       ├─ bedrock_embedding_test.rs               8 个
       ├─ amazon_bedrock_image_test.rs            8 个
       └─ bedrock_stream_replay_test.rs           1 个
            create_amazon_bedrock(AmazonBedrockProviderSettings { .. })   bedrock/mod.rs:399
            └ AmazonBedrockProvider                                       :456   impl Provider :622
              ├ chat / language_model → BedrockModel                      model.rs:93   impl LanguageModel :129
              │   ├ build_request_body_checked / prepare_tools            convert.rs:1013 / :897
              │   ├ convert_prompt_to_bedrock / validate_prompt           convert.rs:45 / :693
              │   ├ convert_usage / map_finish_reason                     convert.rs:1661 / :1638
              │   └ 流：decode_stream → AmazonBedrockChatStream           event_stream.rs:263 / model.rs:575
              ├ embedding → BedrockEmbeddingModel                         embedding.rs:30
              ├ image → BedrockImageModel                                 image.rs:36
              └ reranking → BedrockRerankingModel                         reranking.rs:78
            鉴权：BedrockAuthFetch（API key，否则 SigV4Fetch）             mod.rs:372   aimux-provider-utils/src/sigv4_fetch.rs

上游 packages/amazon-bedrock/src/ 的 21 个测试文件（用例数）：

amazon-bedrock-chat-language-model.test.ts               175
convert-to-amazon-bedrock-chat-messages.test.ts           85
amazon-bedrock-prepare-tools.test.ts                      33
amazon-bedrock-provider.test.ts                           30
amazon-bedrock-image-model.test.ts                        29
amazon-bedrock-sigv4-fetch.test.ts                        27
amazon-bedrock-embedding-model.test.ts                    14
reranking/amazon-bedrock-reranking-model.test.ts          13
convert-amazon-bedrock-usage.test.ts                       9
normalize-tool-call-id.test.ts                             8
amazon-bedrock-chat-language-model-event-stream.test.ts    6
amazon-bedrock-chat-language-model-options.test.ts         5
amazon-bedrock-event-stream-decoder.test.ts                5
amazon-bedrock-event-stream-response-handler.test.ts       5
amazon-bedrock-usage-raw.test.ts                           4
inject-fetch-headers.test.ts                               4
amazon-bedrock-api-types.test.ts                           3
amazon-bedrock-error.test.ts                               2
anthropic/amazon-bedrock-anthropic-provider.test.ts       32   不在范围
anthropic/amazon-bedrock-anthropic-fetch.test.ts          13   不在范围
mantle/bedrock-mantle-provider.test.ts                    16   不在范围

二、本 PR 的改动（细节）

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

cargo test -p aimux-providers --lib bedrock::tests::            408 个
  src/bedrock/tests/mod.rs           每个上游测试文件一个 mod，另加 support
  chat_language_model.rs           174   mod do_generate（121）/ do_stream（47）/ request_url / supported_urls / application_inference_profile_* / do_generate_request_metadata
  convert_to_chat_messages.rs       74   convert::convert_prompt（:51，传 isMistral）
  image_model.rs                    28
  provider.rs                       28   经 create_amazon_bedrock 发一次请求，看 URL、头和签名
  prepare_tools.rs                  27   经 build_request_body_checked（aimux 没有单独的 prepareTools）
  sigv4_fetch.rs                    22   aimux_provider_utils::SigV4Fetch
  reranking/reranking_model.rs      13
  embedding_model.rs                11
  convert_usage.rs                   7
  chat_language_model_event_stream.rs 6  事件流帧按 AWS 格式编码
  chat_language_model_options.rs     4   build_request_body_checked 的选项校验
  usage_raw.rs                       4
  event_stream_decoder.rs            4
  event_stream_response_handler.rs   3
  error.rs                           2
  normalize_tool_call_id.rs          1
  support.rs                             inject_fetch_headers（上游测试 helper 的 Rust 版）
  fixtures/（21 个）、reranking/fixtures/（1 个）   上游 __fixtures__ 原样拷贝
  snapshots/（4 个）                     上游 toMatchSnapshot 转成 JSON
  src/test_support/mod.rs                #[path = "../../tests/common/mock_fetch.rs"] mod mock_fetch;   lib.rs 末尾 #[cfg(test)] mod test_support;
可见性                                   convert.rs:51 的 convert_prompt，model.rs:96、embedding.rs:33 的 model_family 改成 pub(super)
scripts/check_provider_boundaries.sh     规则 7c、8b 的 find 跳过 */tests/*

2. 这些测试动到的进程级状态

新测试编进 aimux-providers 的 lib 测试二进制，和其他模块的单元测试同进程并行跑。

• 环境变量：provider.rs 里模拟上游 settings mock 的用例会设置或清掉 AWS_REGION、AWS_ACCESS_KEY_ID、AWS_SECRET_ACCESS_KEY、AWS_SESSION_TOKEN、AWS_BEARER_TOKEN_BEDROCK、AWS_ENDPOINT_URL、AWS_ENDPOINT_URL_BEDROCK_RUNTIME、AWS_ENDPOINT_URL_BEDROCK_AGENT_RUNTIME，用完恢复原值。
• 进程默认 transport：sigv4_fetch.rs 的 2 个用例用 set_default_transport 换成本地假代理，测完换回默认。
• 上面这些用例都是 #[serial]（共 26 个），和库里其他 #[serial] 用例互斥；其余新测试不读这些变量，也不走默认 transport（都传自己的 MockFetch）。没有全局计数器，不写临时文件。

3. aimux-providers/layout.toml（只加 [bedrock]，35 个上游源文件）

26 个 mapped 到 bedrock/*.rs
anthropic/*（4 个）       not-applicable：对齐文档 §5 "Bedrock 上的 Anthropic InvokeModel"
mantle/*（3 个）          missing，issue 275
inject-fetch-headers.ts   not-applicable：上游测试 helper
version.ts                not-applicable
amazon-bedrock-sigv4-fetch.ts   registered 3，ts-only 2（非字符串 body、空字符串 API key）
amazon-bedrock-api-types.ts     sub-feature 3（createAmazonBedrockCachePoint）
amazon-bedrock-provider.ts      sub-feature 1（anthropicTools），ts-only 1（new）
其余 ts-only 7：类型推断、`responseFormat: 'xml' as any`、NaN usage、processEvent 回调、null body、zod chunk schema、vi.mock 的 spy

amazon-bedrock-chat-language-model-event-stream.test.ts 和 amazon-bedrock-usage-raw.test.ts 没有同名源文件，用例全迁了，不需要写排除。

4. 旧测试的标记（单独一个提交，函数名和函数体不变）

tests/bedrock_convert_test.rs        16 个挪进 mod 加 /// upstream:，其余加 /// partial:
tests/bedrock_remaining_test.rs       9 个挪进 mod 加 /// upstream:，其余加 /// partial:
tests/bedrock_embedding_test.rs       2 个挪进 mod do_embed 加 /// upstream:，6 处 /// partial:
tests/amazon_bedrock_image_test.rs    1 个挪进 mod do_generate 加 /// upstream:，7 处 /// partial:
tests/bedrock_upstream_e2e_test.rs   10 处 /// partial:（换掉原来的 /// TS: 行）
src/bedrock/event_stream.rs           1 处 /// partial:
tests/bedrock_user_agent_test.rs、bedrock_stream_replay_test.rs   不动：不对应上游用例

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

• 上游直接 new BedrockChatLanguageModel(...)；这里用 create_amazon_bedrock 加 API key、region、base_url、fetch 建。上游 mock 掉模型类、fetch 工厂和 settings loader 的用例，改成发一次请求，从线上看到的 URL、头和签名断言 mock 本该收到的参数。
• 上游的事件流 chunk 编码成真实的 AWS event-stream 帧（…Exception 用 :message-type exception）。
• 流里的错误 part 按上游的形状比（message、type、statusCode、isRetryable、data）。should handle failed chunk parsing 上游经 mock 注入错误值，Rust 注入不了，改用一个 payload 不是 JSON 的帧，两边都不比错误值本身。
• UnsupportedFunctionality 只带一个字符串，即上游的 functionality，没有单独的 message：上游默认文案 'X' functionality not supported. 和三个 mime type 错误的自定义 message，都比抛出时的 functionality。
• usage 字段类型错误时，aimux 的 cause 是 serde 的文字（inputTokens: invalid type: …），不是 zod 的 issue 列表，所以只查 cause 里有字段名，不要求带引号。
• 上游注入的 generateId、currentDate 在 Rust 里注入不了：空 toolUseId 用例先断言生成的 id 非空再比其余字段；图像时间戳断言落在调用期间。
• user agent 钉住的是 ai-sdk-amazon-bedrock/5.0.100（上游 mock 成 0.0.0-test），单独比。快照里值为 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 --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：177 个测试二进制，3240 个全过（aimux-providers lib 550，其中 bedrock 414：新 408、原有 6）
• scripts/check_provider_boundaries.sh passes
• Commit messages follow Conventional Commits

Notes for reviewers

• 和前几个厂商的 PR 一样新建了 src/test_support/mod.rs、aimux-providers/layout.toml，并改了边界脚本规则 7c、8b 的同两行；这几处在各 PR 里内容相同，后合入的只需合并 layout.toml 的厂商表。
• 457 个在范围内的上游用例和标记逐条对过：436 个各有一个标记，21 个在 layout.toml 里。
• 基线是 master：fix: Amazon Bedrock errors, warnings, usage and transport match the AI SDK #357 合入后改基到 master 并合入 master（5a4bbf7e，master 5157fdc）；layout.toml 是 master 的原文后接 bedrock 表。
• 跟踪 测试：补迁上游 AI SDK 测试（按用例名约 18% 对上） #278；行为差异挂在 Core 运行时：与 AI SDK 的剩余差距（对齐文档 §9.1 已知差距） #276。

---

Generated by Claude Code

[eric8810]

Bedrock test port：408 新测试 + 28 旧测试 + 21 exclusions = 457 覆盖，fixtures 逐字节一致，无 runtime 变化；layout 中 error.ts 的映射应改到 bedrock/mod.rs 或后续 error.rs。Approve。

[cunninghamcard-bit]

eric 的意见（原话）	处理
layout 中 error.ts 的映射应改到 bedrock/mod.rs 或后续 error.rs。	已改（6077be3c）。aimux-providers/layout.toml 里 src/amazon-bedrock-error.ts 的 rust 从 bedrock/model.rs 改成了 bedrock/mod.rs，因为上游 amazonBedrockFailedResponseHandler 的移植 bedrock_failed_response_handler 就在 mod.rs 里。只改了这一行，没有动测试和源码。lib + *bedrock* 共 688 个测试全过，fmt、clippy 和边界检查也都通过。如果之后把错误处理拆到 error.rs，这一行跟着搬移 PR 一起改。

---

Generated by Claude Code

---

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.