OA2023/OASystem/OASystem.Api/OAMethodLib/TokenHubAI/Models/TokenHubError.cs

namespace OASystem.API.OAMethodLib.TokenHubAI.Models;

/// <summary>
/// TokenHub API 错误响应（OpenAI 兼容协议）
/// </summary>
public class TokenHubError
{
    /// <summary>
    /// 错误类型
    /// </summary>
    public string? Type { get; set; }

    /// <summary>
    /// 业务错误码
    /// </summary>
    public string? Code { get; set; }

    /// <summary>
    /// 错误描述
    /// </summary>
    public string? Message { get; set; }

    /// <summary>
    /// 中文错误描述
    /// </summary>
    public string? Message_ZH { get; set; }

    /// <summary>
    /// 错误来源: client | gateway | upstream
    /// </summary>
    public string? Source { get; set; }

    /// <summary>
    /// 上游错误码
    /// </summary>
    public string? UpstreamCode { get; set; }

    /// <summary>
    /// 上游 HTTP 状态码
    /// </summary>
    public int? UpstreamStatus { get; set; }

    /// <summary>
    /// 请求唯一标识
    /// </summary>
    public string? RequestId { get; set; }

    /// <summary>
    /// 判断是否为客户端错误
    /// </summary>
    public bool IsClientError => Source == "client";

    /// <summary>
    /// 判断是否为网关错误
    /// </summary>
    public bool IsGatewayError => Source == "gateway";

    /// <summary>
    /// 判断是否为上游错误
    /// </summary>
    public bool IsUpstreamError => Source == "upstream";

    /// <summary>
    /// 判断是否可重试（上游错误或服务不可用）
    /// </summary>
    public bool IsRetryable => Source == "upstream" ||
                               Type == "service_unavailable" ||
                               Type == "timeout_error" ||
                               Code == "503001" ||
                               Code == "504001" ||
                               Code == "502001";

    public override string ToString()
    {
        return $"[{Code}] {Type}: {Message} (RequestId: {RequestId})";
    }
}

/// <summary>
/// 错误响应外层包装（OpenAI 协议）
/// </summary>
public class TokenHubErrorResponse
{
    public TokenHubError? Error { get; set; }
}

/// <summary>
/// Anthropic 协议错误响应
/// </summary>
public class AnthropicErrorResponse
{
    public string? Type { get; set; }
    public AnthropicErrorDetail? Error { get; set; }
}

public class AnthropicErrorDetail
{
    public string? Type { get; set; }
    public string? Message { get; set; }
    public string? Reqid { get; set; }
}