审查 a2a-sdk 内置能力替代自实现

[liujuanjuan1984]

背景

需要基于本仓库锁定的 a2a-sdk==0.3.26，审查当前实现中是否存在非必要的自主实现。

任务

• 对照本地 SDK 0.3.26 的 server/client/transport 能力与本仓库实现。
• 识别哪些业务逻辑可以采用 SDK 内置能力。
• 区分可以替换、应继续保留、以及需要进一步验证的部分。
• 本次评估结果无需落库文档；结论同步到 issue/comment 即可。

验证

• 以本地 SDK 源码和仓库源码审查为主。
• 若不产生代码变更，可不运行 ./scripts/doctor.sh，但需说明。

[liujuanjuan1984]

已从最新 main 创建分支 eval/413-a2a-sdk-builtins-review。前一轮 commonground gateway 评估文档已按要求撤回，当前工作树无文档落库变更；接下来基于本地 a2a-sdk==0.3.26 源码审查可替代的自主实现。

[liujuanjuan1984]

审查进展：已基于本地安装的 a2a-sdk==0.3.26 源码完成第一轮对照，未落库评估文档。

结论摘要：

• REST /v1/tasks：SDK 0.3.26 路由存在，但 handler 仍是 NotImplementedError；我们的分页、过滤、history/artifact 控制和错误格式仍需保留。
• Streaming 断连、terminal resubscribe replay、idempotent cancel、输出模式协商、任务存储终态写保护：这些是业务语义或可靠性策略，不建议替换成 SDK 默认行为。
• Client bootstrap：SDK ClientFactory.connect() 已覆盖 resolver + factory.create，可作为后续低风险收敛方向；但我们仍需保留 URL 归一化、Basic Auth、A2A-Version、trace header、错误映射和缓存策略。
• Client polling：SDK ClientConfig.polling 只负责把 message/send 设置为 non-blocking，实际轮询仍需调用方做；如果启用我们的 polling fallback，值得考虑同步设置该字段。
• AuthInterceptor：SDK 支持 Bearer/OAuth/OIDC/header API key，但不覆盖 Basic、A2A-Version、trace header，且 REST transport 当前 interceptor 未真正应用；不建议整体替换当前 header context。
• Push notification：SDK 已有 config store / sender / JSON-RPC handler，当前业务明确保持 unsupported，因此不建议现在引入；如果以后要支持 push，应优先用 SDK 内置存储和 sender 接口扩展。

[liujuanjuan1984]

已执行第 1 条并创建 Draft PR：#414。\n\n变更：启用 polling fallback 时，同步设置 SDK ClientConfig.polling=True，并补充 client facade 测试覆盖该配置。\n\n验证已通过：\n- uv run pytest tests/client/test_client_facade.py --no-cov\n- ./scripts/doctor.sh