收敛 A2A 扩展协商与承载实现到官方最佳实践

[liujuanjuan1984]

背景

对照 a2a-python 1.0+ 的扩展实践复审后，当前仓库在扩展协商与承载方式上仍有缺口，需要单独跟进。

发现

1. AgentCard.capabilities.extensions 已按 SDK v1 推荐声明扩展能力。
2. 客户端当前只把扩展 URI 放进 Message.extensions，没有通过 ClientCallContext.service_parameters 发出 A2A-Extensions 请求头。
3. 服务端虽已通过 SDK 默认 ServerCallContextBuilder 读取 A2A-Extensions 并填入 requested_extensions，但仓库主路径没有消费 requested_extensions，共享扩展行为仍只依赖 metadata.shared.* / metadata.opencode.*。
4. 共享扩展中的 session binding / model selection / streaming 已经主要承载在标准 A2A 方法上，但 provider-private 能力仍大量通过 opencode.* JSON-RPC 方法暴露。

期望

• 客户端按官方推荐显式发送 A2A-Extensions。
• 服务端基于 requested_extensions 真正参与扩展协商，而不是只声明能力或被动读取 header。
• 共享扩展继续优先承载在标准 A2A 方法上，并明确哪些 provider-private 方法仍保留为自定义扩展接口。
• 补齐测试与文档，确保扩展声明、协商和运行时行为一致。

[liujuanjuan1984]

已在当前工作分支完成基于官方最佳实践的 extensions 收敛，提交 8e8b07d，并已推送到 chore/423-a2a-v1-migration-gap-audit。

本轮实现：

• 新增 src/opencode_a2a/extension_negotiation.py，统一处理 A2A-Extensions 合并、请求扩展解析、缺失扩展判定，以及任务/事件 metadata 过滤。
• client 侧改为通过 ClientCallContext.service_parameters 显式发送 A2A-Extensions；不再把扩展 URI 冗余塞进 Message.extensions。
• server / REST / JSON-RPC 统一要求显式协商后再开放扩展行为；未协商时返回稳定的 EXTENSION_NEGOTIATION_REQUIRED 错误。
• GetTask / SubscribeToTask / ListTasks / 流式执行链路现在都会按已协商扩展裁剪或保留 metadata.shared.*。
• 测试基座已同步到显式协商模型，包括 JSON-RPC 扩展请求头、执行上下文默认协商扩展，以及相关持久化/契约回归。

验证结果：

• ./scripts/doctor.sh passed
• 599 passed
• coverage 91.31%

相关 PR：#424

[liujuanjuan1984]

复审结论：

• 这个 issue 作为 open 跟踪项，已经基本失效。对应主目标已在已合并的 #424 中落地：client 已通过 ClientCallContext.service_parameters 发送 A2A-Extensions，server / REST / JSON-RPC 也都开始基于 requested_extensions 做显式协商与约束。
• 当前代码已经符合这条 issue 的主方向，继续保留这个大而全的 open issue 容易和现状脱节。
• 若还想继续收敛，后续更适合拆成更小的 follow-up：例如单独评估哪些 opencode.* 方法长期保留为 vendor-specific extension，哪些未来有机会继续向共享扩展迁移。

建议：关闭本 issue；如需后续工作，改为新建更窄的 follow-up issue。

[liujuanjuan1984]

复审后确认：该 issue 的主目标已在已合并的 #424 中完成，当前 open 状态已失效。关闭处理；如果后续还要继续细化扩展边界，请直接在新的具体需求或 PR 中继续收口。