nex/openspec/changes/refactor-conversion-engine/specs/error-handling/spec.md

MODIFIED Requirements

Requirement: 统一错误响应

系统 SHALL 统一错误响应格式，新增 ConversionError 支持。

Scenario: OpenAI 协议错误响应

• WHEN OpenAI 协议发生错误
• THEN SHALL 返回标准 OpenAI 错误响应格式
• THEN SHALL 包含 error.message、error.type、error.code 字段

Scenario: Anthropic 协议错误响应

• WHEN Anthropic 协议发生错误
• THEN SHALL 返回标准 Anthropic 错误响应格式
• THEN SHALL 包含 type、error.type、error.message 字段

Scenario: 转换错误响应

• WHEN ConversionEngine 在协议转换过程中产生 ConversionError
• THEN SHALL 使用客户端协议的 Adapter.encodeError 编码错误响应
• THEN 错误响应 SHALL 使用客户端可理解的协议格式

Scenario: 管理 API 错误响应

• WHEN 管理 API 发生错误
• THEN SHALL 返回统一的错误响应格式
• THEN SHALL 包含 code、message 字段
• THEN SHALL 可选包含 details 字段（验证错误详情）

ADDED Requirements

Requirement: 定义 ConversionError 错误类型

系统 SHALL 定义 ConversionError 结构体和 ErrorCode 枚举。

Scenario: ConversionError 结构

• WHEN 定义转换错误
• THEN SHALL 包含 Code（ErrorCode 枚举）、Message 字段
• THEN SHALL 可选包含 ClientProtocol、ProviderProtocol、InterfaceType、Details、Cause 字段

Scenario: ErrorCode 枚举

• WHEN 定义错误码
• THEN SHALL 包含 INVALID_INPUT、MISSING_REQUIRED_FIELD、INCOMPATIBLE_FEATURE、FIELD_MAPPING_FAILURE、TOOL_CALL_PARSE_ERROR、JSON_PARSE_ERROR、STREAM_STATE_ERROR、UTF8_DECODE_ERROR、PROTOCOL_CONSTRAINT_VIOLATION、ENCODING_FAILURE、INTERFACE_NOT_SUPPORTED

Scenario: 错误码到协议错误类型的映射

• WHEN 使用 encodeError 编码错误
• THEN ErrorCode SHALL 映射为各协议的错误类型字符串
• THEN 例如 INVALID_INPUT → OpenAI "invalid_request_error"，Anthropic "invalid_request_error"