refactor(tools): move contextual manifest helpers

Author: limityan

docs/architecture/core-decomposition.md

@@ -66,7 +66,7 @@ Rust 编译和链接面。
 | `bitfun-agent-stream` | Stream 聚合和 stream-focused 测试 | done：stream 聚合已独立 |
 | `bitfun-runtime-ports` | 面向 service/agent 边界的轻量跨层 DTO 和 trait | partial：DTO/trait-only 边界已建立，包含 agent submission/transcript/cancel、remote state、runtime event 与 remote image attachment 契约；不拥有 runtime 实现 |
 | `bitfun-agent-runtime` | Sessions、execution、coordination、agent system | target：crate 尚不存在，agent runtime 仍在 core |
-| `bitfun-agent-tools` | 轻量 tool DTO / contract、portable tool context facts / provider、runtime restriction、pure manifest/exposure and GetToolSpec presentation/schema contract、generic registry / static-provider / dynamic-provider container | partial：runtime manifest assembly / context filtering、`ToolUseContext`、`GetToolSpec` 执行和 concrete tools 仍在 core；core 当前仅把内置工具列表收敛为 core-owned static provider group，并只通过 `PortableToolContextProvider` 提供 `ToolContextFacts` 只读投影 |
+| `bitfun-agent-tools` | 轻量 tool DTO / contract、portable tool context facts / provider、runtime restriction、pure manifest/exposure and GetToolSpec presentation/schema/detail contract、generic contextual manifest resolver、generic catalog snapshot provider / GetToolSpec catalog provider、generic registry / static-provider / dynamic-provider container | partial：product registry snapshot access、`ToolUseContext` adapter、`GetToolSpec` 执行和 concrete tools 仍在 core；core 当前把内置工具列表收敛为 core-owned static provider group，并只通过 `PortableToolContextProvider` 提供 `ToolContextFacts` 只读投影 |
 | `bitfun-tool-packs` | 由 feature group 隔离的具体工具实现 | target/scaffold：仅提供 basic / git / mcp / browser-web / computer-use / image-analysis / miniapp / agent-control feature-group 元数据，不得声明 concrete tools 已迁移 |
 | `bitfun-services-core` | Config、session、workspace、storage、filesystem、system services | partial：部分 pure helper 已迁出；config/workspace/filesystem runtime 多数仍在 core |
 | `bitfun-services-integrations` | Git、MCP、remote SSH、remote connect、file watch integrations | partial：MCP runtime 已迁入；remote SSH 仍只迁移低风险 contracts/helpers；remote-connect 已拥有 wire DTO、request builder、tracker state / registry lifecycle 与 tracker event reduction，dispatcher/product execution 仍在 core |
@@ -136,17 +136,20 @@ owner 边界，否则不要把一个 feature group 继续拆成更小的 crate
   处理前，必须保留 `report.md` / `citations.md` / `display_map.json` 的 deterministic post-processing 行为；
   在此之前该 hook 仍属于 `bitfun-core` agent runtime assembly。
 - 最新主干新增 on-demand tool spec discovery。`ToolExposure`、`GetToolSpec` 名称、
-  collapsed stub、manifest ordering、generic collapsed exposure query、GetToolSpec
-  prompt / schema / assistant-detail rendering 等纯契约可由 `bitfun-agent-tools`
-  拥有；但 `manifest_resolver`、产品 registry snapshot、product collapsed-tool catalog、context-aware
-  tool schema/description、`GetToolSpec` 执行和 `ToolUseContext.unlocked_collapsed_tools`
-  暂时仍属于 `bitfun-core` product tool runtime。继续迁移前必须证明 prompt-visible
-  manifest、expanded/collapsed exposure、unlock state 与 desktop/MCP/ACP tool catalog 等价。
+  collapsed stub、manifest ordering、generic collapsed exposure query、generic contextual
+  prompt-manifest resolver、generic catalog snapshot provider、GetToolSpec catalog provider /
+  prompt / schema / assistant-detail rendering / detail JSON 等 provider-neutral 契约可由 `bitfun-agent-tools`
+  拥有；但产品 registry snapshot、`dyn Tool`
+  / `ToolUseContext` adapter、product collapsed-tool catalog、context-aware tool
+  schema/description 的实际调用、`GetToolSpec` 执行和
+  `ToolUseContext.unlocked_collapsed_tools` 仍属于 `bitfun-core` product tool runtime。
+  继续迁移前必须证明 prompt-visible manifest、expanded/collapsed exposure、unlock state
+  与 desktop/MCP/ACP tool catalog 等价。
 - 当前 tool runtime 外移的低风险入口是 `StaticToolProvider` / `install_static_provider`
   合约归属 `bitfun-agent-tools`，并让 core 通过 `runtime_assembly.rs` + `static_providers.rs`
   将内置工具列表收敛为 `core.basic`、`core.agent`、`core.session`、`core.integration`
   provider group。
-  这不代表 concrete tools、`ToolUseContext`、runtime manifest resolver 或
+  这不代表 concrete tools、`ToolUseContext`、product registry snapshot adapter 或
   `GetToolSpecTool` 执行已经迁移。
 - `ToolContextFacts` 只记录 tool call、agent/session/turn、workspace kind/root
   与 runtime restriction 等可移植事实。它不携带 collapsed-tool unlock state、
@@ -254,12 +257,13 @@ owner 边界，否则不要把一个 feature group 继续拆成更小的 crate
 - 已合入的 semantic baseline 已补 config failure、catalog replacement invalidation、沿用既有 list-changed
   helper baseline、dynamic manifest order/metadata、tool manifest / `GetToolSpec`、MiniApp storage layout
   adapter 等价和 remote search fallback gate；这些都是 behavior-locking tests，不移动 runtime owner。
-- 本轮 tool manifest presentation contract closure 只把 `ToolExposure`、`GetToolSpec` 名称、纯 manifest
-  policy、collapsed prompt stub、prompt-visible ordering、GetToolSpec input schema / validation、
-  prompt description、assistant-detail rendering 与 duplicate-load hint 归入 `bitfun-agent-tools`，
-  并让 core runtime manifest resolver / `GetToolSpecTool` 委托这些纯 helper；不迁移
-  `ToolUseContext`、registry snapshot、context-aware tool discovery、`GetToolSpecTool` 执行、
-  unlock state 或 concrete tool implementation。
+- 本轮 tool manifest presentation contract closure 把 `ToolExposure`、`GetToolSpec` 名称、纯 manifest
+  policy、collapsed prompt stub、prompt-visible ordering、generic contextual manifest resolver、
+  generic catalog snapshot provider、GetToolSpec catalog provider、GetToolSpec input schema / validation、prompt description、
+  assistant-detail rendering、collapsed summary/detail JSON 与 duplicate-load hint 归入
+  `bitfun-agent-tools`，并让 core manifest adapter / `GetToolSpecTool` 委托这些
+  provider-neutral helper；不迁移 `ToolUseContext`、registry snapshot access、
+  `GetToolSpecTool` 执行、unlock state 或 concrete tool implementation。
   该阶段闭环后，后续不应再插入 baseline-only PR 才开始 runtime owner 迁移；下一组 PR 应直接以
   单一 owner 为单位移动实际 runtime，并沿用本节等价测试和边界脚本。
 - 已合入的 `Services/Product Runtime Owner Closure` 只收口已经有 port/contract 保护的低风险 owner：