Merged
fix(a2a):adjust timeout config, support idle timeout in stream mode #390
fix(a2a):adjust timeout config, support idle timeout in stream mode #390
Merged
wangweizhenAdd on 12 days ago
wangweizhenCollaborators
12 days ago

Paired: GitHub #201 ↔ GitCode !390

What type of PR is this?

/kind

Self-checklist:(请自检,在[ ]内打上x,我们将检视你的完成情况,否则会导致pr无法合入)

likedislike
Pull Request has been successfully merged by openJiuwen-bot.
(Thank you for wangweizhen's contribution.)
WwangweizhenCollaborators
12 days ago Associated issue: [A2A] 协议层超时控制体系不完善:缺少分阶段超时与可配置策略
atomgit-bot
atomgit-bot
12 days ago Comments:

变更摘要

本 PR 调整 A2A C++ SDK 的超时配置体系:将超时从连接层内部固定值改为可配置项,在 ClientConfig 中新增 timeoutSeconds 与 streamingIdleTimeoutSeconds,并为 AgentCard 发现、非流式请求、流式请求分别定义超时语义;流式请求不再设置总时长上限,改为基于数据到达间隔的「空闲超时」检测。同时移除了连接层原有的 FinishRequest / RefreshRequest 定时器接口(改用连接内部的周期性空闲检查),并将 libcurl 超时失败映射为带阶段信息的 A2A_REQUEST_TIMEOUT 错误。

主要改动

  • ClientConfig 新增超时配置项: 新增 timeoutSeconds(默认 300 秒,非流式总超时)与 streamingIdleTimeoutSeconds(默认 60 秒,流式数据到达最大间隔),并明确 SendMessage / Resubscribe 的 timeout 形参在流式与非流式下分别表示空闲间隔与总超时。
  • AgentCard 发现超时参数化: A2ACardResolver::GetAgentCard / GetAllAgentCards 新增 timeout 形参,配合新增常量 DEFAULT_CARD_TIMEOUT_SECONDS(60 秒),HttpCardResolver 在 timeout <= 0 时回落到该默认值,以便发现阶段快速失败。
  • LibcurlConn 三档超时与流式空闲检测: 构造函数改为接收 connectTimeoutMs、requestTimeoutMs、streamIdleTimeoutMs 三个参数并新增 streamIdleTimeoutMs 配置与 DEFAULT_STREAM_IDLE_TIMEOUT_MS;SetupCurlHandle 仅对非流式请求设置 CURLOPT_TIMEOUT_MS,流式请求改由新增的重复定时器与 OnIdleCheck 依据 lastActivityTime(在 HeaderCallback / WriteCallback 中刷新)判定空闲超时并中止请求。
  • 错误码与错误信息增强: 新增 CurlErrorCode / DescribeCurlError 将 CURLE_OPERATION_TIMEDOUT 映射为 A2A_REQUEST_TIMEOUT、连接类错误映射为 A2A_TRANSPORT_EXCEPTION,并在消息中携带 stage(connect-or-waiting-response-headers、waiting-response-body、stream-idle)与耗时;HttpResponse 新增 errCode 字段透传该错误码,JsonRpcTransportImpl 从 JSON-RPC 错误包中提取 message 作为错误信息。
  • 连接接口与定时器机制收敛: 删除 ClientConn 及 LibcurlConn 的 FinishRequest / RefreshRequest 纯虚接口与 UserData 中的 timerId / timeout 字段,移除 JsonRpcTransportImpl 中各处对这两个接口的调用,并新增 SECONDS_TO_MS 作为秒到毫秒的统一换算常量;同时补充 examples/timeout_client.cpp 打桩验证程序及相应 UT 调整。
likedislike
Incorrect?
atomgit-bot
atomgit-bot
12 days ago Comments:

代码审查

审查结论

发现汇总(按严重度)

严重度 数量 说明
P0 0 —
P1 0 —
P2 2 配置超时值被下层私有上限拒绝导致 Create 静默返回 nullptr;核心新逻辑 OnIdleCheck 无 UT 覆盖
P3 4 流式 connect 超时被误标 stream-idle;空闲定时器创建失败后流式无兜底;per-call 秒转毫秒无上界/溢出保护;示例桩 listenFd_ 数据竞争

逐文件复核确认

  • A2A/cpp-sdk/CMakeLists.txt:no issues(仅把 timeout_client 加入示例输出目录循环,if(TARGET ...) 保护已存在)
  • A2A/cpp-sdk/examples/CMakeLists.txt:no issues(新增目标位于 if(A2A_BUILD_CLIENT) 内,链接方式与既有示例一致)
  • A2A/cpp-sdk/examples/timeout_client.cpp:1 项发现(listenFd_ 跨线程数据竞争);其余经核对 API 均存在(A2AClientTimeoutError、ClientFactory::Create(card,cfg)、ClientEvent/ResponseHandler、Part::text、Log::SetLogLevel),client_factory.h 已包含 client.h,不会因缺声明编译失败
  • A2A/cpp-sdk/include/client/a2a_card_resolver.h:no issues(新增纯虚参数有默认值,全仓无其它子类,未产生 override 编译破坏)
  • A2A/cpp-sdk/include/client/client.h:no issues(注释已说明秒级语义;上限缺失问题已在 transport 侧报告)
  • A2A/cpp-sdk/include/client/http_card_resolver_builder.h:no issues(仅注释)
  • A2A/cpp-sdk/src/client/connection/client_conn.h:no issues(FinishRequest/RefreshRequest 已无任何残留引用,LibcurlConn/MockClientConn 均已同步)
  • A2A/cpp-sdk/src/client/connection/libcurl_conn.cpp:3 项发现(DescribeCurlError 阶段误标、空闲定时器失败无兜底、timeoutSecs 溢出/无上界)+ 1 项测试覆盖缺失
  • A2A/cpp-sdk/src/client/connection/libcurl_conn.h:no issues(常量、RequestContext 初始化顺序、lastActivityTime(startTime) 均正确)
  • A2A/cpp-sdk/src/client/http_card_resolver.cpp:no issues(timeout>0 回退 60s,与文档一致)
  • A2A/cpp-sdk/src/client/http_card_resolver.h:no issues
  • A2A/cpp-sdk/src/client/jsonrpc_transport_impl.cpp:1 项发现(config 秒数上界/溢出 → Create 返回 nullptr)
  • A2A/cpp-sdk/src/shared/common_types.h:no issues(timerId/timeout 删除后无残留引用)
  • A2A/cpp-sdk/src/shared/http_common.h:no issues(新增 errCode 字段默认 0,兼容旧调用)
  • A2A/cpp-sdk/tests/ut/client/test_jsonrpc_transport_impl.cpp:no issues(删除的两处 mock 在文件中无对应期望调用)
  • A2A/cpp-sdk/tests/ut/client/test_libcurl_conn.cpp:no issues(仅删 FinishRequest 用例;构造函数 4 参调用因新签名默认参数仍可编译);但新增空闲中止路径的用例缺失已在 libcurl_conn.cpp:826 报告

整体风险判断

改动方向与 issue #29 一致,错误码/异常类型链路(CurlErrorCode → SendError → TransportError → A2AClientTimeoutError(-32101))经逐段核对是通的,未发现构建破坏或数据损坏级缺陷。主要风险集中在两点:公开配置项(秒级超时)与传输层私有上限(30min)之间缺少一致的边界校验,超限时会退化为 ClientFactory::Create 静默返回 nullptr(P2,最应优先修);以及流式空闲超时这一全新并发路径完全没有 UT 兜底,后续微小改动就可能变成静默挂死或 UAF 而不被 CI 捕获(P2)。建议合入前至少修复这两项,其余 P3 可按排期跟进。

类型 数量
🔴 阻塞 0
🟡 建议 2

💬 仅评论

likedislike
Incorrect?
OopenJiuwen-botCollaborators
12 days ago Set YiyangShao,xinyu-jiuwen as approver
atomgit-bot
atomgit-bot
12 days ago Comments:

AtomGit AI 助手使用指南

在 PR 评论中使用命令即可触发。支持在普通评论和代码行评论中使用。

功能 命令 说明
代码审查 /ai review 检查代码质量、潜在问题、安全风险
PR 摘要 /ai summary 生成 PR 变更内容的结构化摘要
代码解释 /ai explain 解释代码变更的逻辑和意图
自由提问 @atomgit-bot <问题> 询问关于本 PR 的任何问题
帮助 /ai help 显示此帮助信息

免责声明

AI 助手可能存在误判,请结合自身判断。可以对评论点 👍 或 👎 帮助我们改进。

likedislike
Incorrect?
121 messages are collapsed here。 See more
OopenJiuwen-botCollaborators
6 days ago Added label: approvedlgtm-mingo007
openJiuwen-botCollaborators
6 days ago Comments:

Review Code Feedback

  • The label lgtm-mingo007, approved was added to this pull request. It means that mingo007 reviewed the code changes. 👋
Tips
  • If this pull request is not merged while all conditions are met, comment /check-pr to try again. 😄
likedislike
OopenJiuwen-botCollaborators
6 days ago Closed associated issue
OopenJiuwen-botCollaborators
6 days ago Merged pull request
OopenJiuwen-botCollaborators
6 days ago Removed label: ci-successful