"""通用响应模型。"""

from typing import Any

from pydantic import BaseModel, ConfigDict, Field


class ErrorBody(BaseModel):
    model_config = ConfigDict(
        json_schema_extra={
            "examples": [
                {
                    "code": "model_error",
                    "message": "模型 provider 返回错误。",
                    "trace_id": "trace_e5e220f8656c488895a696a5e9b5eedd",
                    "details": {"status_code": 400, "body": "Model Not Exist"},
                }
            ]
        }
    )

    code: str = Field(description="标准错误码，取值见契约字典 API 标准错误码。")
    message: str = Field(description="面向用户的错误信息。")
    trace_id: str = Field(description="链路追踪 ID。")
    details: dict[str, Any] = Field(default_factory=dict, description="脱敏后的错误详情。")


class ErrorResponse(BaseModel):
    model_config = ConfigDict(
        json_schema_extra={
            "examples": [
                {
                    "error": {
                        "code": "not_found",
                        "message": "会话不存在。",
                        "trace_id": "trace_e5e220f8656c488895a696a5e9b5eedd",
                        "details": {},
                    }
                }
            ]
        }
    )

    error: ErrorBody = Field(description="错误响应主体。")


class Page[T](BaseModel):
    items: list[T] = Field(description="当前页数据。")
    page: int = Field(description="页码，从 1 开始。")
    page_size: int = Field(description="每页数量。")
    total: int = Field(description="总数量。")


class OrmModel(BaseModel):
    model_config = ConfigDict(from_attributes=True)