[cunninghamcard-bit]

Summary

把 src/bedrock/ 按 @ai-sdk/amazon-bedrock@5.0.100 一个文件对一个文件重排（RFC-0046 §4.2），照上游建 reranking/ 子目录。五个老测试程序和 event_stream.rs 里的单元测试并进厂商测试目录 src/bedrock/tests/（RFC-0046 §5）。函数体只改了路径和可见性。crate 根和 bedrock 模块根的再导出不变；bedrock 下有公开模块路径变了，列在“公开路径”一节。测试数量和函数名前后一致；2 个用例加了 #[serial]，一个搬来的用例的代理设置让本机地址直连（见“共享进程状态”）。叠在测试 PR #358 上。实施进度在 #328 跟踪。

已经测试分支 328982c8 合上 master b69137eb，冲突按 master 的改动搬到新位置解决（RFC-0047 的错误结构体改动从 convert.rs、model.rs、embedding.rs、image.rs、reranking.rs、event_stream.rs、mod.rs 搬到对应的新文件，老测试程序 bedrock_remaining_test.rs 和 bedrock_upstream_e2e_test.rs 里的两处匹配改动搬到 src/bedrock/tests）；测试数前后仍相等（549 个：测试分支 lib 414 个加老测试程序 135 个，名字多重集相同）。

一、体系现状（概览，测试 PR #358 头 9915ab4d）

aimux_providers::bedrock::create_amazon_bedrock     src/bedrock/mod.rs:410
 ├ Auth（region / api_key / 凭据）                    src/bedrock/mod.rs:232
 │  ├ bearer、credentials、base_url                  mod.rs:243、:303、:334
 │  └ BedrockAuthFetch / ProcessDefaultFetch         mod.rs:372、:397
 └ AmazonBedrockProvider::model_config → BedrockEndpoint::resolve
                                                    mod.rs:539 → :495
   ├ chat → BedrockModel                            mod.rs:566 → model.rs:150（do_generate）、:249（do_stream）
   │  ├ build_request_body_checked                  convert.rs:1028
   │  │  ├ validate_options                         convert.rs:1590
   │  │  ├ convert_prompt                           convert.rs:51
   │  │  │  └ normalize_tool_call_id                convert.rs:545
   │  │  └ prepare_tools、supports_strict_tools     convert.rs:912、:876
   │  ├ bedrock_failed_response_handler             mod.rs:127
   │  ├ bedrock_event_stream_response_handler → decode_stream
   │  │                                             model.rs:38 → event_stream.rs:280
   │  ├ map_finish_reason                           convert.rs:1665
   │  └ convert_usage                               convert.rs:1688
   ├ embedding_model → BedrockEmbeddingModel        mod.rs:644 → embedding.rs:99
   ├ image_model → BedrockImageModel                mod.rs:648 → image.rs:86
   └ reranking_model → BedrockRerankingModel        mod.rs:652 → reranking.rs:105
ProviderDiscovery::list_models                      mod.rs:663

上游同一条路：createAmazonBedrock（amazon-bedrock-provider.ts）用 createSigV4FetchFunction / createApiKeyFetchFunction（amazon-bedrock-sigv4-fetch.ts）和 resolveAmazonBedrockBaseUrl（resolve-amazon-bedrock-base-url.ts）给每个模型一份配置，建 AmazonBedrockChatLanguageModel、-EmbeddingModel、-ImageModel 和 reranking/ 下的 -RerankingModel；消息转换、工具准备、Claude 能力表、usage、finish reason、Mistral 的 tool call id、错误处理、event stream 解码和响应处理、API 类型、各模型的选项各在自己的文件。aimux 把这些放在 9 个文件里：mod.rs（provider、Auth、transport、设置、错误处理）、convert.rs（消息转换、工具、能力表、getArgs 的检查、finish reason、usage）、model.rs、embedding.rs、image.rs、reranking.rs、event_stream.rs、tools.rs、types.rs，加上 aimux 自己的 options.rs。

测试：#358 的新用例在 src/bedrock/tests/（408 个）；event_stream.rs 里还有 6 个单元测试；老用例在七个独立测试程序里：tests/amazon_bedrock_image_test.rs（8）、tests/bedrock_convert_test.rs（51）、tests/bedrock_embedding_test.rs（8）、tests/bedrock_remaining_test.rs（45）、tests/bedrock_upstream_e2e_test.rs（12）、tests/bedrock_stream_replay_test.rs（4）、tests/bedrock_user_agent_test.rs（10）。

二、本 PR 改动（细节）

aimux_providers::bedrock::create_amazon_bedrock     src/bedrock/provider.rs:141        ← amazon-bedrock-provider.ts
 ├ Auth（region / api_key / 凭据）                    src/bedrock/sigv4_fetch.rs:19       ← amazon-bedrock-sigv4-fetch.ts
 │  ├ bearer、credentials                            sigv4_fetch.rs:30、:90
 │  ├ base_url                                       sigv4_fetch.rs:121                 ← resolve-amazon-bedrock-base-url.ts
 │  └ BedrockAuthFetch / ProcessDefaultFetch         sigv4_fetch.rs:159、:184
 └ AmazonBedrockProvider::model_config → BedrockEndpoint::resolve
                                                    provider.rs:270 → :226
   ├ chat → BedrockModel                            provider.rs:297 → chat_language_model.rs:99、:198   ← amazon-bedrock-chat-language-model.ts
   │  ├ build_request_body_checked                  chat_language_model.rs:888
   │  │  ├ validate_options                         chat_language_model_options.rs:26   ← amazon-bedrock-chat-language-model-options.ts
   │  │  ├ convert_prompt                           convert_to_chat_messages.rs:48      ← convert-to-amazon-bedrock-chat-messages.ts
   │  │  │  └ normalize_tool_call_id                normalize_tool_call_id.rs:4         ← normalize-tool-call-id.ts
   │  │  ├ prepare_tools                            prepare_tools.rs:248                ← amazon-bedrock-prepare-tools.ts
   │  │  └ supports_strict_tools                    anthropic_model_support.rs:11       ← amazon-bedrock-anthropic-model-support.ts
   │  ├ bedrock_failed_response_handler             error.rs:6                          ← amazon-bedrock-error.ts
   │  ├ bedrock_event_stream_response_handler → decode_stream
   │  │                                             event_stream_response_handler.rs:9 → event_stream_decoder.rs:280
   │  │                                             ← amazon-bedrock-event-stream-response-handler.ts、-event-stream-decoder.ts
   │  ├ map_finish_reason                           map_finish_reason.rs:7              ← map-amazon-bedrock-finish-reason.ts
   │  └ convert_usage                               convert_usage.rs:12                 ← convert-amazon-bedrock-usage.ts
   ├ embedding_model → BedrockEmbeddingModel        provider.rs:375 → embedding_model.rs:98   ← amazon-bedrock-embedding-model.ts
   │  └ parse_bedrock_provider_options              embedding_model_options.rs:35       ← amazon-bedrock-embedding-model-options.ts
   ├ image_model → BedrockImageModel                provider.rs:379 → image_model.rs:83 ← amazon-bedrock-image-model.ts
   └ reranking_model → BedrockRerankingModel        provider.rs:383 → reranking/reranking_model.rs:53   ← reranking/amazon-bedrock-reranking-model.ts
      ├ parse_bedrock_reranking_options             reranking/reranking_model_options.rs:15   ← reranking/amazon-bedrock-reranking-model-options.ts
      └ BedrockRerankingResponse                    reranking/reranking_api.rs:7        ← reranking/amazon-bedrock-reranking-api.ts
ProviderDiscovery::list_models                      provider.rs:394

现在	搬到	上游
mod.rs 的模块文档、mod、pub use	mod.rs（只有模块声明和导出）	index.ts
mod.rs 的常量、encode_model_id、AmazonBedrockProviderSettings、create_amazon_bedrock、amazon_bedrock、AmazonBedrockProvider、BedrockEndpoint 和 Provider / ProviderDiscovery 实现	provider.rs	amazon-bedrock-provider.ts
mod.rs 的 Auth（含 base_url）、BedrockAuthFetch、ProcessDefaultFetch	sigv4_fetch.rs	amazon-bedrock-sigv4-fetch.ts；resolve-amazon-bedrock-base-url.ts 在 aimux 是 Auth::base_url，也指这里
mod.rs 的 bedrock_failed_response_handler	error.rs	amazon-bedrock-error.ts
mod.rs 的 AmazonBedrockChatModelFamily、AmazonBedrockChatModelSettings；convert.rs 的 validate_options	chat_language_model_options.rs	amazon-bedrock-chat-language-model-options.ts
mod.rs 的 AmazonBedrockEmbeddingModelFamily、AmazonBedrockEmbeddingModelSettings；embedding.rs 的 BedrockEmbeddingProviderOptions、parse_bedrock_provider_options	embedding_model_options.rs	amazon-bedrock-embedding-model-options.ts
model.rs 除 bedrock_event_stream_response_handler；convert.rs 的 reasoning_capabilities、build_request_body_checked	chat_language_model.rs	amazon-bedrock-chat-language-model.ts（getArgs 在这个文件）；amazon-bedrock-reasoning-metadata.ts、amazon-bedrock-stream-error.ts 在 aimux 是流里就地处理的，也指这里
model.rs 的 bedrock_event_stream_response_handler	event_stream_response_handler.rs	amazon-bedrock-event-stream-response-handler.ts
event_stream.rs（去掉单元测试）	event_stream_decoder.rs	amazon-bedrock-event-stream-decoder.ts
convert.rs 的消息转换（convert_prompt 等、validate_prompt）	convert_to_chat_messages.rs	convert-to-amazon-bedrock-chat-messages.ts
convert.rs 的 normalize_tool_call_id	normalize_tool_call_id.rs	normalize-tool-call-id.ts
convert.rs 的 supports_strict_tools、MODELS_WITHOUT_STRICT_TOOL_SUPPORT、supports_native_structured_output	anthropic_model_support.rs	amazon-bedrock-anthropic-model-support.ts
tools.rs；convert.rs 的 is_strict_schema_compatible、prepare_tools	prepare_tools.rs	amazon-bedrock-prepare-tools.ts
convert.rs 的 map_finish_reason	map_finish_reason.rs	map-amazon-bedrock-finish-reason.ts
convert.rs 的 convert_usage	convert_usage.rs	convert-amazon-bedrock-usage.ts
types.rs	api_types.rs（原样）	amazon-bedrock-api-types.ts
embedding.rs 其余	embedding_model.rs	amazon-bedrock-embedding-model.ts
image.rs	image_model.rs	amazon-bedrock-image-model.ts；-image-model-options.ts、-image-settings.ts 在 aimux 没有单独的代码，指这里
reranking.rs 的响应类型	reranking/reranking_api.rs	reranking/amazon-bedrock-reranking-api.ts
reranking.rs 的 BedrockRerankingOptions、parse_bedrock_reranking_options	reranking/reranking_model_options.rs	reranking/amazon-bedrock-reranking-model-options.ts
reranking.rs 其余	reranking/reranking_model.rs	reranking/amazon-bedrock-reranking-model.ts
options.rs	不动	aimux 独有（命名空间读写，边界规则 7c 点名这个文件）

• 公开路径（RFC-0046 §4.5，按 refactor: move the Mistral files to the upstream layout #297 / refactor: move the Cohere files to the upstream layout #298 / refactor: move the xAI files to the upstream layout #313 的做法只列出来）：
  • bedrock::convert 不再公开。原来经它公开的 convert_prompt_to_bedrock、normalize_tool_call_id、validate_prompt、supports_strict_tools、prepare_tools、build_request_body_checked、map_finish_reason、convert_usage、BedrockUsage 都变成 crate 内部；只给老测试用的 convert_prompt_to_bedrock 现在是 #[cfg(test)] pub(super)。
  • bedrock::embedding、bedrock::image 不再公开；里面的 BedrockEmbeddingModel、BedrockImageModel 仍可从 bedrock:: 和 crate 根拿到。
  • bedrock::event_stream 改名为 bedrock::event_stream_decoder，仍是 pub mod（跨厂商的 tests/bedrock_user_agent_test.rs 和 tests/data_loss_regression_test.rs 用 encode_message(s)，两处 import 已改）。
  • bedrock::reranking 仍是公开模块，bedrock::reranking::BedrockRerankingModel 照旧。
• 可见性：拆到兄弟文件后要互相调用的项改为 pub(super)：provider.rs 的 PROVIDER、SIGV4_SERVICE 和五个 *_ENV_VAR 常量；Auth 的六个字段和 bearer、static_credentials、credentials、preflight、base_url；BedrockAuthFetch（及 signing、inner 字段）、ProcessDefaultFetch；validate_options、supports_native_structured_output、is_strict_schema_compatible、bedrock_event_stream_response_handler；BedrockEmbeddingProviderOptions（及字段）、parse_bedrock_provider_options；BedrockRerankingResponse / BedrockRerankingResult / BedrockRerankingOptions（及字段）、parse_bedrock_reranking_options。BEARER_TOKEN_ENV_VAR 由 bedrock 以 pub(crate) use 导出，default_providers.rs 不用改。mod.rs 文档里的 [`SigV4Fetch`] 链接改写成完整路径，因为 mod.rs 不再 import 它。
• 测试：
  • tests/amazon_bedrock_image_test.rs → tests/image_model.rs 末尾的 amazon_bedrock_image 模块；tests/bedrock_embedding_test.rs → tests/embedding_model.rs 的 bedrock_embedding 模块。
  • tests/bedrock_convert_test.rs 按上游测试文件拆三段，各在一个 bedrock_convert 模块里：消息转换 39 个进 tests/convert_to_chat_messages.rs，prepare-tools 5 个进 tests/prepare_tools.rs，usage 7 个进 tests/convert_usage.rs。
  • tests/bedrock_remaining_test.rs 按每个用例 /// partial: 标注里的 “full port in …” 文件拆，各在一个 bedrock_remaining 模块里：chat_language_model.rs 21、provider.rs 9、normalize_tool_call_id.rs 7、convert_usage.rs 3、convert_to_chat_messages.rs 3、chat_language_model_event_stream.rs 1（流里的 checksum 错误）、sigv4_fetch.rs 1（默认 transport 按请求查找）；共用的 make_model、collect_stream、clear_bedrock_env 等 17 个助手放到新的 tests/remaining_support.rs。
  • tests/bedrock_upstream_e2e_test.rs 同样按标注拆进 chat_language_model.rs 6、image_model.rs 2、prepare_tools.rs 1、embedding_model.rs 1、error.rs 1、reranking/reranking_model.rs 1，各在 bedrock_upstream_e2e 模块里；provider、options、chat_body、stream_response 放到 tests/upstream_e2e_support.rs。mock_fetch 改用 crate::test_support::mock_fetch。
  • event_stream.rs 的 6 个单元测试进 tests/event_stream_decoder.rs 的 frame_round_trip_and_crc 模块。
  • 每节前一行注释写明原来的位置，老文件头的说明改成普通注释。test: port the upstream Amazon Bedrock tests #358 测试里的 convert::…、event_stream::…、bedrock::{Auth, …}、bedrock::bedrock_failed_response_handler、bedrock::{BedrockAuthFetch, SIGV4_SERVICE} import 改到新路径，两处文件头注释里的 bedrock/mod.rs 改成新文件。断言都没改（172 个老函数体去掉路径和空白后逐个比对一致；rustfmt 因缩进多一层重排了一处 match 分支）。
• 留在 tests/ 的：tests/bedrock_stream_replay_test.rs（单厂商的 cassette 回放，按 refactor: move the Anthropic AWS files to the upstream layout #320 的做法留下）和 tests/bedrock_user_agent_test.rs（Converse、Anthropic-on-Bedrock、Mantle 跨厂商的 user-agent 字面量）。
• layout.toml 的 [bedrock] 25 个 rust 字段改到新路径。scripts/check_provider_boundaries.sh：规则 7 的 from_env 改成 \bfrom_env\b，因为老用例 provider_from_env_* 现在在 src/bedrock/ 下，测试名不是 builder 时代的 from_env；规则 7b 的 bedrock::sigv4|bedrock/sigv4 改成 bedrock(::|/)sigv4\b，否则会命中上游同名的 sigv4_fetch.rs。两条对真正的 ::from_env( 和 bedrock::sigv4 / bedrock/sigv4.rs 仍然报。

共享进程状态：老测试原来各是单独的测试程序，现在和 #358 的用例同在 lib 的一个测试程序里。

• test: port the upstream Amazon Bedrock tests #358 的 26 个 #[serial] 用例设 AWS_REGION、AWS_BEARER_TOKEN_BEDROCK、AWS_ENDPOINT_URL(_BEDROCK_RUNTIME / _AGENT_RUNTIME) 等变量。搬来的用例里没给 base_url、会读端点变量的两个加了 #[serial_test::serial]，函数体不变：provider.rs 的 bedrock_remaining::provider_custom_region_base_url（断言 URL）、provider_bearer_token_auth。
• 搬来的 sigv4_fetch.rs 的 bedrock_remaining::provider_default_transport_is_looked_up_per_request（本来就是 #[serial]）在运行期间把进程默认 transport 换成一个代理。原来它单独一个程序，现在同一程序里其他用 fetch: None 访问本机 wiremock 的用例（Bedrock 的 image、embedding，兼容层的 chat 等）会被这个代理截走。它的 ProxyConfig 加了 no_proxy: "localhost,127.0.0.1"，和 test: port the upstream Amazon Bedrock tests #358 在 sigv4_fetch.rs:273 的写法一样；它自己的请求发往 example.com，断言不受影响。这样不用给别的用例逐个加 #[serial]。

其余搬来的用例都给了 base_url、api_key 和 fetch，或者本来就是 #[serial]，不读这些状态。没有全局计数器；fixture 路径按 CARGO_MANIFEST_DIR 算，位置不影响。

CHANGELOG

CHANGELOG Unreleased 的 Breaking 加了一条，列出本家变了的公开子模块路径和替代入口（RFC-0046 §4.5 第 2 条）。

验证

• cargo test -p aimux-providers --lib 加原来七个 --test：前后都是 688 个测试（前 lib 550 + 138，后 lib 674 + 回放 4 + user-agent 10），函数名多重集相同；bedrock:: 下 414 → 538。改了代理设置之后，lib 测试程序又连跑 29 次，674 个全过。
• cargo +1.99 clippy -p aimux-providers --lib --tests -- -D warnings、cargo +1.99 check -p aimux-providers --lib --tests --all-features、RUSTDOCFLAGS="-D warnings" cargo +1.99 doc -p aimux-providers --no-deps、cargo fmt --all -- --check、scripts/check_provider_boundaries.sh、cargo +1.99 check --workspace、cargo test -p aimux-providers（2793 过，5 ignored）通过。

Type of change

• Refactor (no behavior change)

Checklist

• Tests pass locally
• Commit messages follow Conventional Commits

https://claude.ai/code/session_0116HPMoqaLfFr1TyqDq1hrW

---

Generated by Claude Code

[eric8810]

Bedrock layout refactor：549→549 tests，move-only，公开导出保留；在 #357 rebase 后 restack。Approve。

[cunninghamcard-bit]

eric 的意见（原话）

处理

「在 #357 rebase 后 restack」

已做，c58fa374：测试分支 #358 现在的头 c0df1212（合了 #357 修复 464c39ed）已合上来。#357 在 bedrock_remaining_test.rs 加的两条用例跟着邻居搬：prelude 校验和用例到 src/bedrock/tests/chat_language_model_event_stream.rs（路径改成 event_stream_decoder），embedding/image/reranking 按请求取默认传输的用例到 src/bedrock/tests/sigv4_fetch.rs，它的代理和旁边 chat 那条一样对回环地址不走代理，免得同一个测试程序里的 wiremock 用例被代理拦住。layout.toml 里 amazon-bedrock-error.ts 仍指向这个 PR 放错误处理的 bedrock/error.rs。测试属性数和 #358 相同（全仓 2131 个），本地 clippy、文档、格式、边界脚本和全部测试通过。

---

Generated by Claude Code