按结构化异常区分 Agent 失败类型

目标

把 SDK 错误转为可审计的失败类别和适当恢复动作。

步骤

1. 导入 CLINotFoundError、CLIConnectionError、ProcessError、ResultError 与 CLIJSONDecodeError。 [readme]
2. 按具体类型捕获；对 ResultError 读取 subtype、terminal_reason、api_error_status、result 或 errors。 [readme]
3. 只对可重试连接问题执行有上限重试；错误终态、配置问题与解码失败分别报告。 [readme]

验证方式

构造或模拟各类异常，断言映射到不同告警/恢复策略，且不会无限重试。

故障处理

若异常未捕获，优先检查继承关系并保留结构化字段；不要记录完整提示或凭证。