feat(a2a): 完善 A2A 1.0 适配与可持久化 HITL

[lzbjut]

背景

AgentScope Java 2.x 已提供类型化的 AgentEvent 流和 HITL 事件，但现有 A2A 模块仍使用 1.0 之前的 Java SDK，并保留了一部分旧事件适配逻辑。本 PR 提供一套完整的 A2A 1.0 适配实现，并补齐远程 HITL 的暂停、恢复与可选持久化协调能力。

主要改动

• 将 A2A client/server 从 io.github.a2asdk:*:0.3.3.Final 迁移到 org.a2aproject.sdk:*:1.0.0.Final，protobuf runtime 对齐到 4.33.2。
• Server 直接消费 AgentEvent，将 text、thinking、tool use/result、子 Agent source 和终态映射为 A2A 1.0 artifact/status。
• Client/Server 分别使用明确的终态状态机，保证 final、hook 和 sink completion exactly-once，并显式处理缺失最终结果。
• 为 user confirmation 和 external tool execution 增加可序列化的 handoff、resume(...) 与 cancelHandoff(...) API；原有 A2aAgent.call() 保持可用。
• 将 HITL resume admission 前移到 SDK executor 调度之前，错误 token、错误 response set 或 lease 冲突不会污染原有 Task。
• HITL 默认关闭；启用后支持单进程 local 模式，并提供可组合的 durability SPI。
• 新增可选的 Redisson 参考实现，用于 A2A Task、handoff、token claim、session lease 和 TTL；AgentStateStore 仍由业务应用负责。
• 补充中英文 A2A 1.0、local HITL、durable HITL、恢复安全边界和接入示例。

与现有工作的关系

• 第一条提交沿用并保留了 feat(a2a): migrate server runner to streamEvents #2222 作者关于 streamEvents 迁移的署名。
• 这是 feat(a2a): migrate server runner to streamEvents #2222 的上层完整方案，不意图抢占其工作；如果维护者希望拆分、调整顺序或先合并 feat(a2a): migrate server runner to streamEvents #2222，我愿意配合 rebase 或拆 PR。
• 关联 [Feature]: Upgrade A2A module event mechanism #2207、feat(a2a): migrate server runner to streamEvents #2222、REQUIRE_EXTERNAL_EXECUTION EXTERNAL_EXECUTION_RESULT #2253。

兼容性与边界

• SDK groupId、Java package 和 server API 均发生变化，因此 SDK 1.0 迁移属于 breaking refactor，而非单纯版本号升级。
• AgentScope 专属的 block/source 信息仅通过可选 metadata 传递；第三方 A2A peer 仍按标准字段 best-effort 兼容。
• 暂停会结束当前流，恢复是在相同 task/context 上发起的新请求，不持久化实时 SSE 事件流。
• durable 模式强验证 A2A 控制面；AgentStateStore 的跨副本可达性由应用保证。
• 不增加 in-task authentication 语义，因为 AgentScope 2.x 当前没有认证恢复契约。
• token claim 保证单次 resume admission，但不承诺任意崩溃点下外部副作用 exactly-once。

验证

• 全 reactor mvn clean verify：85 个 reactor 模块全部成功；7,597 tests，0 failures，0 errors，168 skipped。
• client/server、local HITL、Redis durability、并发 claim、重放拒绝、错误 admission 不污染 Task、跨端 round-trip 测试。
• A2A SDK 仅 1.0.0.Final，protobuf-java/-util 仅 4.33.2。
• Redis provider 进入公共 BOM，但明确不进入 agentscope-all；主 A2A Starter 不传递 Redis/Redisson。
• 中英文文档示例与公共 API 对齐。

Closes #2270

[codecov]

Codecov Report

❌ Patch coverage is 75.77968% with 963 lines in your changes missing coverage. Please review.

Files with missing lines	Patch %	Lines
...core/a2a/server/executor/AgentEventA2aEncoder.java	67.62%	97 Missing and 50 partials ⚠️
...ver/transport/jsonrpc/JsonRpcTransportWrapper.java	66.22%	47 Missing and 30 partials ⚠️
...scope/core/a2a/agent/utils/MessageConvertUtil.java	66.49%	38 Missing and 28 partials ⚠️
...entscope/a2a/redis/RedisHitlResumeCoordinator.java	78.72%	26 Missing and 34 partials ⚠️
...in/java/io/agentscope/core/a2a/agent/A2aAgent.java	86.48%	13 Missing and 37 partials ⚠️
...e/core/nacos/a2a/utils/AgentCardConverterUtil.java	50.50%	39 Missing and 10 partials ⚠️
...tscope/core/a2a/server/hitl/HitlTurnAdmission.java	69.06%	22 Missing and 21 partials ⚠️
.../a2a/server/hitl/ResolvedAgentRequestMetadata.java	80.48%	7 Missing and 25 partials ⚠️
...io/agentscope/a2a/redis/RedisHitlSessionLease.java	71.15%	19 Missing and 11 partials ⚠️
...n/java/io/agentscope/a2a/redis/RedisTaskStore.java	74.13%	16 Missing and 14 partials ⚠️
... and 54 more

📢 Thoughts on this report? Let us know!

[jujn]

@lzbjut 你好，有联系方式不？可以发我主页邮箱，我拉你进官方群

[lzbjut]

这次继续在原分支补齐了 AgentScope 2.0.1 相关适配，没有新增或修改版本号，仍沿用上游现有的 2.0.1-SNAPSHOT：

1. 服务端不可变确认准备

   • 新增 ToolConfirmation / UserConfirmableTool
   • 工具确认前由服务端一次性准备完整批次
   • 暂停恢复后禁止客户端篡改已准备的 input、prompt、metadata 和 permission rules
   • 补充重启恢复、批量原子准备和修改输入等回归测试

2. A2A 入站请求认证

   • 新增 A2aAuthResolver、A2aPrincipal、A2aIdentity 等通用 API
   • JSON-RPC 解析完成后、Task/Agent 分发前执行认证；拒绝保持为真实 HTTP admission error，不污染 Task
   • 默认匿名，Spring Boot 可通过自定义 bean 接入
   • 可信 principal / effective user 以 typed RuntimeContext 传入，客户端 metadata 不能伪造可信身份
   • 这里只处理入站 HTTP 认证，不改变“暂不支持任务内 auth-required resume”的边界

3. 终态工具结果保真

   • 修复工具结果已完成、随后最终 Msg 只含文本时，A2A completed artifact 丢失 tool-result 的问题
   • 保留多个结果的顺序，并避免最终消息已携带同一结果时重复编码

同时将分支 rebase 到当前最新 main。本地已完成：

• 全仓 mvn clean verify：83/83 模块通过
• A2A SDK 仅 1.0.0.Final
• protobuf-java / protobuf-java-util 仅 4.33.2
• PR 11 个提交经 Gitleaks 扫描，无敏感信息命中

[lzbjut]

补充同步了最新一处工具结果信息保真修复，仍未新增或修改版本（保持 2.0.1-SNAPSHOT）：

• Core 在生成 ToolResultEndEvent 时保留原 ToolResultBlock.metadata；
• A2A encoder 将事件 metadata 合并到 tool-result DataPart，避免业务扩展信息在 ToolResultBlock → AgentEvent → A2A 链路中丢失；
• toolCallId、toolName、source、block type、state 等协议保留字段仍保持优先，业务 metadata 不能覆盖；
• 增加两层回归：真实 ReAct 工具执行的 Event metadata，以及 streaming / completed artifact 的跨端 round-trip。

验证结果：A2A server 聚合测试通过（Core 2230、Client 179、Server 249），全仓 83 模块 mvn clean verify 通过；依赖仍为 A2A SDK 1.0.0.Final、protobuf 4.33.2。分支也已 rebase 到当前 upstream/main。

[lzbjut]

已同步最新 upstream/main，并解决 ReActAgent 的 HITL 冲突：保留本 PR 的工具确认准备与修改入参逻辑，同时接入上游新增的 UserConfirmResultEvent replyId 持久化/关联语义。

本地验证：

• ReActAgentHitlTest：8/8
• 相关 65 模块 reactor：BUILD SUCCESS
• A2A client 179、server 249、Redis HITL 27、Nacos A2A 53、A2A Starter 43，均 0 失败

PR 已恢复为 MERGEABLE；新一轮 GitHub CI 正在排队。