enhance: add optional bounded client polling fallback

[liujuanjuan1984]

概述

• 为 A2AClient.send() 增加可选且有界的 polling fallback，用于兼容 peer 返回 non-terminal task 且需要后续 tasks/get 轮询的场景
• 保持 send_message() 的 stream-first 事件流 contract 不变，只在 send() 上做可选收敛
• 同时收紧 send() 与文档表述，明确其返回的是 latest response event；当 fallback 启用时，可能进一步收敛为轮询得到的最终 task snapshot

Client facade

• 在 src/opencode_a2a/client/client.py 中为 send() 增加 bounded polling fallback
• 仅当 send() 收到 (Task, None) 且 task state 属于 submitted、working、unknown 时触发自动轮询
• 到达 terminal state 后返回最终 task snapshot
• 若轮询过程中进入 input_required、auth_required 等 caller-intervention state，则停止自动轮询并返回当前 snapshot
• 保持现有 tasks/get 错误映射与 send_message() 事件流行为不变

Polling policy / config

• 新增 src/opencode_a2a/client/polling.py，收敛 polling fallback 的状态判定、退避和配置校验逻辑
• 在 src/opencode_a2a/client/config.py 中增加以下配置项：
  • A2A_CLIENT_POLLING_FALLBACK_ENABLED
  • A2A_CLIENT_POLLING_FALLBACK_INITIAL_INTERVAL_SECONDS
  • A2A_CLIENT_POLLING_FALLBACK_MAX_INTERVAL_SECONDS
  • A2A_CLIENT_POLLING_FALLBACK_BACKOFF_MULTIPLIER
  • A2A_CLIENT_POLLING_FALLBACK_TIMEOUT_SECONDS

Tests

• 在 tests/client/test_client_facade.py 中补充 terminal 收敛、caller-intervention state、timeout、tasks/get 错误路径回归测试
• 在 tests/client/test_client_config.py 中补充新配置解析与非法参数校验
• 新增 tests/client/test_polling.py 覆盖 polling policy helper

Docs

• 在 docs/guide.md 中补充 send() 的最新语义说明与 polling fallback 配置说明

验证

• ./scripts/doctor.sh

关联

• Closes [Priority: Med] [Feature] Client 侧自动轮询回退机制 (GetTask) #310
• 不关联 #311、#321：这两个 issue 已关闭，且本 PR 未修改 server-side heartbeat 或 durable task contract

[liujuanjuan1984]

本轮基于 PR diff 的自审结论：未发现阻塞性问题。

审查要点：

1. 需求贴合度

• 本 PR 实现的范围与 #310 一致：只在 facade 层补可选、bounded 的 polling fallback，没有把 client 改回 sync/blocking-first，也没有改变 send_message() 的流式 contract。

2. 设计边界

• 触发条件限制在 (Task, None) + submitted/working/unknown，避免把 input_required/auth_required 这类 caller-intervention state 错误纳入自动轮询。
• polling 策略已抽到独立 helper，较当前规模下是更稳妥的收口方式；没有引入额外对外 API 迁移面。

3. 风险评估

• 当前未发现明显遗漏、冗余或行为偏差。
• 残余注意点是：send() 在 fallback 启用后返回的可能是轮询得到的 task snapshot，而不是原始流事件；这在当前 PR 的文档与代码表述中已明确，属于有意设计，不是隐藏行为变化。

4. issue / PR 关系

• Closes #310 是准确的。
• #311、#321 不应继续挂到本 PR 的关系区，因为它们已关闭且本 PR 未覆盖对应 server-side 议题。