[feat] 将 step/snapshot 事件下沉为 shared progress metadata

[liujuanjuan1984]

背景

当前分支已经修复了 #242 / #243 的核心问题，并收紧了可见文本提取边界：step-start / step-finish / snapshot 不再直接作为正文 TextPart 透传。

但这些事件仍然承载了有价值的结构化进度信息，例如阶段类型、reason、part 身份、状态字段等。现阶段这些信息要么只留在日志中，要么被内部消费后丢弃，未以稳定的 shared metadata 形式暴露给下游。

仓库里已经存在可参考的 shared metadata 设计：

• metadata.shared.usage
• metadata.shared.interrupt
• metadata.shared.stream

因此需要将 step/snapshot 相关事件也按类似方式下沉为结构化 shared metadata，而不是恢复成可见正文输出。

复现步骤

1. 启动当前分支服务并发起 message/stream 请求。
2. 让上游输出 step-start / step-finish / snapshot 相关 part。
3. 观察当前 A2A 输出。

期望行为

• step-start / step-finish / snapshot 不应作为可见正文 artifact 输出。
• 这些事件中可稳定消费的进度信息应通过 shared metadata 暴露给下游。
• metadata 设计应与现有 usage / interrupt / stream 风格一致，避免临时私有字段。

实际行为

• 当前分支已停止将这些 part 作为正文输出，这是正确的。
• 但相关阶段信息尚未以 shared metadata 形式输出，下游无法稳定读取这些进度事件。

验收标准

• 为 streaming 输出增加结构化 metadata.shared.progress（命名可根据实现微调，但需保持 shared metadata 风格一致）。
• step-start / step-finish / snapshot 至少有一部分稳定字段可被下游消费。
• 不重新引入将 snapshot/hash 透传为正文文本的问题。
• 增加回归测试，覆盖 progress metadata 的输出与正文隔离。
• 如有必要，同步更新 agent card / extension contract 暴露的字段说明。

HEAD 快照

• git rev-parse HEAD: 4e22c86a619f1d24097cfdca3f3eafd2b2fbfc89

[liujuanjuan1984]

本次实现已经统一收敛最终方案，相关改动已并入同一条 PR：#244。

最终实际决策

• 可见正文只接受 text / reasoning part。
• step-start / step-finish / snapshot 不再进入正文 artifact，避免 hash、opaque snapshot、内部阶段字符串被误当成用户可见内容透传。
• step-start / step-finish / snapshot 改为通过结构化 shared metadata 暴露，下沉到 metadata.shared.progress。
• step-finish 继续保留 usage 提取职责；也就是说它仍可贡献 metadata.shared.usage，但不再承担正文输出职责。
• 流式完成仍以 session.idle / session.error 为终止判定，不回退到“HTTP 返回即完成”的旧逻辑。
• 最终 /session/{id}/message 的 response.info.error 与流内 message.updated -> info.error 都会映射到失败态，不再误报 completed。

关联关系

• #242：已由当前 PR 覆盖，关闭时机交由 PR 合并处理。
• #243：已由当前 PR 覆盖，关闭时机交由 PR 合并处理。
• #246：用于跟踪 step/snapshot 结构化 metadata 设计，已在当前 PR 中实现。

[liujuanjuan1984]

补充最终决策说明：

本次没有直接移除 metadata.shared.stream.source，原因是下游 ~/a2a-client-hub 仍在消费该字段：

• final_snapshot 用于覆盖语义判定
• tool_part_update 用于 tool block 兼容处理

因此最终实现选择是：

• 保留 metadata.shared.stream.source 兼容位
• 将 shared 层 source 收敛为稳定公开枚举：stream、final_snapshot、tool_part_update
• 不再向 shared 协议暴露 part_text_diff、delta_event、delta_event_buffered 等内部归一化实现值

同时继续保持：

• 可见正文只接受 text / reasoning
• step-start / step-finish / snapshot 通过 metadata.shared.progress 暴露结构化阶段信息
• step-finish 仍保留 usage 提取职责

[liujuanjuan1984]

补充最终收尾决策：

在确认 ~/a2a-client-hub 仍消费 metadata.shared.stream.source 之后，本次没有改动下游协议字段名，也没有移除该字段。

最终实现进一步收敛为：

• 对外协议继续保持 metadata.shared.stream.source
• shared 层只暴露稳定公开枚举：stream、final_snapshot、tool_part_update
• 服务端内部保留更细粒度的来源标签用于实现与调试，但内部来源与 shared 协议字段已经解耦，不再依赖出口二次映射共用同一个中间字段

这样既保持了下游兼容，也避免 part_text_diff、delta_event、delta_event_buffered 这类内部值再次泄露到 shared 协议。