错误与兼容性
面向用户的错误包含 code、message 和 retryable。公开错误信息不包含内部原因或凭据。retryable 不意味着可以重放非幂等操作，例如创建 Run 或重复结果不确定的操作。
请求与服务错误
具体错误实例可以覆盖错误目录的默认值，请检查实际返回的错误码和是否可重试。
Run 与执行错误
这些是常见类别，不是所有包定义业务错误的完整列表。检查 Run 游标、日志和 Workflow 上下文以确定具体原因。之前的提交成功后再失败，不会撤销此前提交。
CLI 与客户端错误
CLI_INIT_TARGET_NOT_EMPTY 用于保护已有文件，请使用新建或空的初始化目录。
CLI_OUTPUT_EXISTS 用于保护已有导出文件，请在选择 --overwrite 前审核。CLI_ARTIFACT_EXPORT_FAILED 表示本地输出发布失败，不会修改存储结果。
PROJECT_CONNECTION_FAILED、PROJECT_REQUEST_FAILED、PROJECT_RESPONSE_INVALID 和 PROJECT_CLIENT_CLOSED 属于 Node.js 客户端边界。请求结果不确定时先查询已有任务，不要自动创建另一个 Run。
Compiler 错误见 Compiler 参考。
兼容性检查
- 独立于 npm 版本，匹配当前
2026-10-08Workflow 协议。 - 修改 CLI 或包后重启服务，已加载资源不会热重载。
- 为未完成检查点保留精确的 Workflow 资源。
- 测试实际提供商和模型对 Tools、输出 Schema 和输出预算的支持。
- 用服务中的可执行程序版本验证业务检查命令。Node 26 不接受过时的
--experimental-transform-types参数。 - 将原生表单界面验证与 MCP Tool 传输成功分别验证。