用途:cursor-errors 是 Cursor SDK 的错误处理参考文档,帮助开发者对 SDK 抛出的失败进行分类、决定是否重试,并向用户呈现可操作的错误信息。
主要能力:SDK 的每次抛出都是 CursorAgentError 或其子类。基类提供 isRetryable、code、cause、protoErrorCode 等字段,其中 isRetryable 用作路由判断:可重试的瞬时错误走重试,终止性错误直接上报。子类覆盖 AuthenticationError、RateLimitError、ConfigurationError、IntegrationNotConnectedError、NetworkError、UnknownAgentError、UnsupportedRunOperationError 等具体失败类型。
使用方式:文档给出重试模式(基于 isRetryable 做退避)与模式稳定性(对工具调用参数与结果做防御性解析)两类参考。另与 cursor-runs 交叉链接:运行状态中终止性错误与抛出的区别见 wait 参考,操作门控见 operation-support 参考。
适用场景:为 SDK 调用编写重试与错误上报逻辑、区分认证/限流/配置/网络等失败原因、在工具调用结果解析时做防御处理。
限制:资料未提供具体代码示例、退避参数、各子类字段细节及版本兼容信息,需查阅对应 references 页面获取。