supplier

type Account struct {
	// BaseURL credential-type conditional: if template is codex-oauth/codex-pat must be null (non-empty forbidden); if api_key/responses-special non-empty overrides template
	BaseURL *string `json:"BaseURL"`

	// CacheDomain 共享缓存域（null = 账号私有域；软亲和一致性哈希的域标识；写面 PATCH /accounts/{id} 的 cache_domain 字段）
	CacheDomain *string    `json:"CacheDomain"`
	CreatedAt   *time.Time `json:"CreatedAt,omitempty"`

	// DeletedAt 软删除时间戳；null = 存活（列表过滤已删；GET 单个可查已删项）
	DeletedAt *time.Time `json:"DeletedAt"`

	// Enabled 管理面启停（写面 PATCH /accounts/{id} 的 enabled 字段；与运行时失效语义分离）
	Enabled *bool `json:"Enabled,omitempty"`

	// FailedAt 运行时失效时刻（rule 判死/SDK fatal；null = 未失效；恢复唯一入口 POST /accounts/{id}/recover）
	FailedAt *time.Time `json:"FailedAt"`

	// FailureSource 失效来源（rule/sdk 等；随 recover 清除）
	FailureSource *string `json:"FailureSource"`
	ID            *int64  `json:"ID,omitempty"`

	// IdentityRevision 身份代际 K：仅身份类字段（template_id/base_url/upstream_key 及可轮换凭据）按值变更时 +1；SDK 自动 token 刷新不推进
	IdentityRevision *int64     `json:"IdentityRevision,omitempty"`
	LastError        *string    `json:"LastError"`
	LastUsedAt       *time.Time `json:"LastUsedAt"`

	// LifecycleRevision 配置代际 C（客户端 CAS 令牌 + DB 变更水位）：每次写面落库无条件 +1；PATCH 以 If-Match 作前置条件（陈旧 → 412），recover 以 body expected_revision（陈旧 → 409）
	LifecycleRevision *int64     `json:"LifecycleRevision,omitempty"`
	MaxConcurrency    *int       `json:"MaxConcurrency,omitempty"`
	Name              *string    `json:"Name,omitempty"`
	Template          *Template  `json:"Template,omitempty"`
	TemplateID        *int64     `json:"TemplateID,omitempty"`
	UpdatedAt         *time.Time `json:"UpdatedAt,omitempty"`

	// UpstreamCostMultiplier 采购成本倍率（正常值，1 = ×1，0 = 免费，上限 10 = ×10；API 边界与 basis points 换算——存储 25000 ↔ 显示 2.5；写面 PATCH /accounts/{id} 的 upstream_cost_multiplier 字段）
	UpstreamCostMultiplier *float64 `json:"UpstreamCostMultiplier,omitempty"`
	UpstreamKey            *string  `json:"UpstreamKey,omitempty"`

	// SupplierUserId 供应商归属（null = 平台自有；非空 = 归属该 supplier uid；只读回显，写面 PATCH /accounts/{id} 的 supplier_user_id）
	SupplierUserId *int64 `json:"supplier_user_id"`
}

type AccountBatchUpdateResponse struct {
	Items   []AccountRevision `json:"items"`
	Updated int               `json:"updated"`
}

type AccountConfigPatch struct {
	BaseUrl                nullable.Nullable[string]  `json:"base_url,omitempty"`
	CacheDomain            nullable.Nullable[string]  `json:"cache_domain,omitempty"`
	Enabled                nullable.Nullable[bool]    `json:"enabled,omitempty"`
	GroupIds               *[]int64                   `json:"group_ids,omitempty"`
	MaxConcurrency         nullable.Nullable[int]     `json:"max_concurrency,omitempty"`
	Name                   nullable.Nullable[string]  `json:"name,omitempty"`
	SupplierUserId         nullable.Nullable[int64]   `json:"supplier_user_id,omitempty"`
	TemplateId             nullable.Nullable[int64]   `json:"template_id,omitempty"`
	UpstreamCostMultiplier nullable.Nullable[float64] `json:"upstream_cost_multiplier,omitempty"`
	UpstreamKey            nullable.Nullable[string]  `json:"upstream_key,omitempty"`
}

type AccountCreate = AccountConfigPatch

type AccountEnabled = bool

type AccountExt struct {
	AccountId *int64 `json:"account_id,omitempty"`

	// CodexAccountId 上游账号/空间标识；可留空——导入/单账号保存时自动识别（OAuth token claims 离线解析 / PAT whoami 查询）；识别失败：导入行拒绝、单账号保存留空且下次保存重试
	CodexAccountId *string `json:"codex_account_id"`

	// CodexEmail 管理标识：codex 账号登录邮箱（导入时由人工/上游提供，非自动生成——NewCodexIdentity 只生成 installation_id；可空）
	CodexEmail *string `json:"codex_email"`

	// CodexIdentity codex 账号持久身份（account_ext.codex_identity jsonb 契约形态；对象字段请求语义：null 与空串同 = 未提供）。仅 installation_id——会话级 session/thread/window 已退役为运行时槽状态，不再持久化/暴露。
	CodexIdentity *CodexIdentity `json:"codex_identity,omitempty"`

	// CodexOauthExpiresAt 凭据：oauth 访问令牌过期时间
	CodexOauthExpiresAt *time.Time `json:"codex_oauth_expires_at"`

	// CodexOauthRefreshToken 凭据：oauth 刷新令牌
	CodexOauthRefreshToken *string `json:"codex_oauth_refresh_token"`

	// CodexOauthToken 凭据：oauth 访问令牌（oauth 行必填——最小完整性）
	CodexOauthToken *string `json:"codex_oauth_token"`

	// CodexPatKey 凭据：pat
	CodexPatKey *string `json:"codex_pat_key"`

	// CredentialType 类型-列组约束（service 校验）：oauth 只允许 codex_oauth_* 列组；pat 只允许 codex_pat_key
	CredentialType AccountExtCredentialType `json:"credential_type"`
}

type AccountExtCredentialType string

type AccountGroupsResponse struct {
	GroupIds []int64 `json:"group_ids"`
}

type AccountListResponse struct {
	Rows  []AccountView `json:"rows"`
	Total int64         `json:"total"`
}

type AccountRecoverBody struct {
	// ExpectedRevision CAS 期望代际（= 读到的 LifecycleRevision）；过期 → 409
	ExpectedRevision int64 `json:"expected_revision"`
}

type AccountRevision struct {
	AccountId         int64 `json:"account_id"`
	LifecycleRevision int64 `json:"lifecycle_revision"`
}

type AccountTemplateId = int64

type AccountUsageItem struct {
	AccountId int64 `json:"account_id"`

	// Gateway 账号网关计费聚合（usage_logs 实时明细；毫分 /1e5 → USD；无记录账号全 0）
	Gateway  UsageGatewayStats   `json:"gateway"`
	Upstream *CodexUsageSnapshot `json:"upstream"`

	// UpstreamError 上游快照失败分类（null = 无上游能力/快照成功；auth_expired = 凭据失效（fatal 类）；upstream_unavailable = 网络/5xx 等上游错误）
	UpstreamError *AccountUsageItemUpstreamError `json:"upstream_error"`
}

type AccountUsageItemUpstreamError string

type AccountView struct {
	// BaseURL credential-type conditional: if template is codex-oauth/codex-pat must be null (non-empty forbidden); if api_key/responses-special non-empty overrides template
	BaseURL *string `json:"BaseURL"`

	// CacheDomain 共享缓存域（null = 账号私有域；软亲和一致性哈希的域标识；写面 PATCH /accounts/{id} 的 cache_domain 字段）
	CacheDomain *string    `json:"CacheDomain"`
	CreatedAt   *time.Time `json:"CreatedAt,omitempty"`

	// DeletedAt 软删除时间戳；null = 存活（列表过滤已删；GET 单个可查已删项）
	DeletedAt *time.Time `json:"DeletedAt"`

	// Enabled 管理面启停（写面 PATCH /accounts/{id} 的 enabled 字段；与运行时失效语义分离）
	Enabled *bool `json:"Enabled,omitempty"`

	// FailedAt 运行时失效时刻（rule 判死/SDK fatal；null = 未失效；恢复唯一入口 POST /accounts/{id}/recover）
	FailedAt *time.Time `json:"FailedAt"`

	// FailureSource 失效来源（rule/sdk 等；随 recover 清除）
	FailureSource *string `json:"FailureSource"`
	ID            *int64  `json:"ID,omitempty"`

	// IdentityRevision 身份代际 K：仅身份类字段（template_id/base_url/upstream_key 及可轮换凭据）按值变更时 +1；SDK 自动 token 刷新不推进
	IdentityRevision *int64     `json:"IdentityRevision,omitempty"`
	LastError        *string    `json:"LastError"`
	LastUsedAt       *time.Time `json:"LastUsedAt"`

	// LifecycleRevision 配置代际 C（客户端 CAS 令牌 + DB 变更水位）：每次写面落库无条件 +1；PATCH 以 If-Match 作前置条件（陈旧 → 412），recover 以 body expected_revision（陈旧 → 409）
	LifecycleRevision *int64     `json:"LifecycleRevision,omitempty"`
	MaxConcurrency    *int       `json:"MaxConcurrency,omitempty"`
	Name              *string    `json:"Name,omitempty"`
	Template          *Template  `json:"Template,omitempty"`
	TemplateID        *int64     `json:"TemplateID,omitempty"`
	UpdatedAt         *time.Time `json:"UpdatedAt,omitempty"`

	// UpstreamCostMultiplier 采购成本倍率（正常值，1 = ×1，0 = 免费，上限 10 = ×10；API 边界与 basis points 换算——存储 25000 ↔ 显示 2.5；写面 PATCH /accounts/{id} 的 upstream_cost_multiplier 字段）
	UpstreamCostMultiplier *float64 `json:"UpstreamCostMultiplier,omitempty"`
	UpstreamKey            *string  `json:"UpstreamKey,omitempty"`
	Concurrency            *int64   `json:"concurrency,omitempty"`
	ErrCount               *int     `json:"err_count,omitempty"`
	ErrRate                *float64 `json:"err_rate,omitempty"`

	// SupplierUserId 供应商归属（null = 平台自有；非空 = 归属该 supplier uid；只读回显，写面 PATCH /accounts/{id} 的 supplier_user_id）
	SupplierUserId *int64 `json:"supplier_user_id"`
}

type AccountsUsageResponse struct {
	Items []AccountUsageItem `json:"items"`
}

type ApplySettlementBody struct {
	// AmountMillis 申请金额（> 0；受 available 条件扣约束）
	AmountMillis int64   `json:"amount_millis"`
	Note         *string `json:"note,omitempty"`

	// RequestKey 业务幂等键（客户端生成、重试复用；作用域 = 操作者 × key）
	RequestKey string `json:"request_key"`
}

type BatchDeleteBody struct {
	Ids []int64 `json:"ids"`
}

type BatchDeleteResponse struct {
	Deleted int `json:"deleted"`
}

type BatchUpdateAccountsBody struct {
	// Fields 账号写面唯一字段模型（创建 / PATCH / 批量共用）。三态：字段缺席 = 不变（永不清空）； 可空标量 null = 清空；集合 null = 不变、[] = 清空；不可空标量 null = 400； 可空标量 "" = 400（空串哨兵已取消——清空只有一个拼法 null）。
	Fields AccountConfigPatch `json:"fields"`
	Ids    []int64            `json:"ids"`
}

type ChiServerOptions struct {
	BaseURL          string
	BaseRouter       chi.Router
	Middlewares      []MiddlewareFunc
	ErrorHandlerFunc func(w http.ResponseWriter, r *http.Request, err error)
}

type CodexCredits struct {
	Balance *string `json:"balance"`
}

type CodexIdentity struct {
	// InstallationId 身份：账号级唯一（UUIDv4；响应恒有——首次写入自动生成；空/缺省 → service 自动生成）
	InstallationId *string `json:"installation_id,omitempty"`
}

type CodexOAuthImportBody struct {
	// CacheDomain 可选：新建账号的共享缓存域（缺省/空串 = 账号私有域；非空须为合法小写域名 ≤253——非法 → 400 整批拒绝）
	CacheDomain *string `json:"cache_domain,omitempty"`

	// Enabled 可选：新建账号的管理面启停（缺省 true = 启用；仅新建行生效）
	Enabled *bool `json:"enabled,omitempty"`

	// GroupId 可选：新建账号归组（缺省不归组；不存在 → 行级 failed——FK 违反归行级不整批 400）
	GroupId *int64                 `json:"group_id"`
	Items   []CodexOAuthImportItem `json:"items"`

	// SupplierUserId 保留：供应商面出现 ⇒ 400（归属恒为 JWT 本人；导入不分配归属）
	SupplierUserId *int64 `json:"supplier_user_id"`

	// TemplateId 必填：codex 账号归属模板（credential_type 必须 == 端点类型 codex-oauth）
	TemplateId int64 `json:"template_id"`

	// UpstreamCostMultiplier 可选：新建账号的采购成本倍率（缺省 ×1；0–10，0 = 免费；越界 → 400 整批拒绝）
	UpstreamCostMultiplier *float64 `json:"upstream_cost_multiplier,omitempty"`
}

type CodexOAuthImportItem struct {
	// CodexAccountId 组合幂等键②：上游账号/空间标识（必填）
	CodexAccountId string `json:"codex_account_id"`

	// CodexEmail 组合幂等键①：codex 账号登录邮箱（必填；格式非法 → 行级 failed）
	CodexEmail string `json:"codex_email"`

	// CodexOauthExpiresAt 凭据：oauth 访问令牌过期时间（可选；RFC3339 格式——解析失败 → 行级 failed）
	CodexOauthExpiresAt *string `json:"codex_oauth_expires_at,omitempty"`

	// CodexOauthRefreshToken 凭据：oauth 刷新令牌（必填；与 token 成对）
	CodexOauthRefreshToken string `json:"codex_oauth_refresh_token"`

	// CodexOauthToken 凭据：oauth 访问令牌（必填；与 refresh 成对）
	CodexOauthToken string `json:"codex_oauth_token"`

	// MaxConcurrency 可选；缺省 25（导入面裁决——非账号表默认 8）；<1 → 归 25
	MaxConcurrency *int `json:"max_concurrency,omitempty"`
}

type CodexPATImportBody struct {
	// CacheDomain 可选：新建账号的共享缓存域（缺省/空串 = 账号私有域；非空须为合法小写域名 ≤253——非法 → 400 整批拒绝）
	CacheDomain *string `json:"cache_domain,omitempty"`

	// Enabled 可选：新建账号的管理面启停（缺省 true = 启用；仅新建行生效）
	Enabled *bool `json:"enabled,omitempty"`

	// GroupId 可选：新建账号归组（不存在 → 行级 failed）
	GroupId *int64               `json:"group_id"`
	Items   []CodexPATImportItem `json:"items"`

	// SupplierUserId 保留：供应商面出现 ⇒ 400（归属恒为 JWT 本人；导入不分配归属）
	SupplierUserId *int64 `json:"supplier_user_id"`

	// TemplateId 必填：codex 账号归属模板（credential_type 必须 == 端点类型 codex-pat）
	TemplateId int64 `json:"template_id"`

	// UpstreamCostMultiplier 可选：新建账号的采购成本倍率（缺省 ×1；0–10，0 = 免费；越界 → 400 整批拒绝）
	UpstreamCostMultiplier *float64 `json:"upstream_cost_multiplier,omitempty"`
}

type CodexPATImportItem struct {
	// CodexAccountId 组合幂等键②：上游账号/空间标识（必填）
	CodexAccountId string `json:"codex_account_id"`

	// CodexEmail 组合幂等键①：codex 账号登录邮箱（必填；格式非法 → 行级 failed）
	CodexEmail string `json:"codex_email"`

	// CodexPatKey 凭据：pat（必填非空）
	CodexPatKey string `json:"codex_pat_key"`

	// MaxConcurrency 可选；缺省 25（导入面裁决）；<1 → 归 25
	MaxConcurrency *int `json:"max_concurrency,omitempty"`
}

type CodexRateLimit struct {
	ResetAt     *time.Time `json:"reset_at"`
	UsedPercent int        `json:"used_percent"`
}

type CodexSpendControl struct {
	Limit            string `json:"limit"`
	Remaining        string `json:"remaining"`
	RemainingPercent int    `json:"remaining_percent"`
	Used             string `json:"used"`
	UsedPercent      int    `json:"used_percent"`
}

type CodexUsageSnapshot struct {
	// Credits 充值余额（金额字符串，如 "12.50"；上游空串 → null，非空串占位）
	Credits  *CodexCredits `json:"credits,omitempty"`
	PlanType *string       `json:"plan_type,omitempty"`

	// RateLimit 主窗口用量（reset_at RFC3339——上游主窗口省略时 null，非虚假 0001-01-01）
	RateLimit *CodexRateLimit `json:"rate_limit,omitempty"`

	// SpendControl 消费控制额度（金额字符串）
	SpendControl *CodexSpendControl `json:"spend_control,omitempty"`
}

type DeletedResponse struct {
	Deleted bool `json:"deleted"`
}

type Error = ErrorResponse

type ErrorResponse struct {
	// EffectiveFrom 判定后的生效窗口下界（`window_invalid`/`window_ambiguous` 不携带）
	EffectiveFrom *time.Time `json:"effective_from,omitempty"`

	// EffectiveTo 判定后的生效窗口上界（`window_invalid`/`window_ambiguous` 不携带）
	EffectiveTo *time.Time `json:"effective_to,omitempty"`
	Error       string     `json:"error"`

	// LimitSeconds 成本上限秒数（`window_too_long` 携带；0 = 无上限）
	LimitSeconds *int64 `json:"limit_seconds,omitempty"`

	// Reason 统计窗口被拒的机读原因（仅统计端点可能携带）。取值词表取自规划层原因与
	// 拒绝原因的**全量映射表**（唯一来源），本版实际会发出的有五个：
	// raw_horizon/cube_horizon = 起点早于所要读表的保留截止；
	// window_too_long = 请求跨度超过该形状的成本上限；window_invalid =
	// 必填/倒序/`window` 时长串不可解析等参数本身非法；window_ambiguous =
	// `from`/`to`/`window` 三者的"恰择一"未被满足（两态都给、只给一端、
	// 或两态都不给）。offset/dst/span_below_grid 是"该窗口无法用卷积表精确
	// 表达、已降级到原始行"的派生原因（只用于降级告警日志，不作为拒绝原因
	// 发出）。
	Reason *ErrorResponseReason `json:"reason,omitempty"`

	// RetentionDays 覆盖判定所依据的最保守保留天数（`*_horizon` 携带）
	RetentionDays *int `json:"retention_days,omitempty"`

	// Storage 判定所依据的实际存储（`window_invalid`/`window_ambiguous` 不携带）
	Storage *ErrorResponseStorage `json:"storage,omitempty"`
}

type ErrorResponseReason string

type ErrorResponseStorage string

type GetSupplierAccountsParams struct {
	// Limit 每页条数（上限 200，超限裁剪到 200）
	Limit      *ListLimit                      `form:"limit,omitempty" json:"limit,omitempty"`
	Offset     *ListOffset                     `form:"offset,omitempty" json:"offset,omitempty"`
	Name       *ListName                       `form:"name,omitempty" json:"name,omitempty"`
	Sort       *ListSort                       `form:"sort,omitempty" json:"sort,omitempty"`
	Order      *GetSupplierAccountsParamsOrder `form:"order,omitempty" json:"order,omitempty"`
	TemplateId *AccountTemplateId              `form:"template_id,omitempty" json:"template_id,omitempty"`

	// Enabled 管理面启停过滤：true = 仅启用，false = 仅禁用；缺省 = 不过滤（与运行时失效 failed_at 无关）
	Enabled *AccountEnabled `form:"enabled,omitempty" json:"enabled,omitempty"`
}

type GetSupplierAccountsParamsOrder string

type GetSupplierAccountsUsageParams struct {
	AccountIds string `form:"account_ids" json:"account_ids"`

	// From 绝对窗口下界（含，RFC3339）。窗口两形态**恰择一**（from+to，或 window 单独）：与 window 同给 / 只给一端 / 都不给 → 400 `reason=window_ambiguous`。给出 from/to 时不做时区改写；服务端按判定把两端向后取整到整点（生效窗口见响应头 X-Stats-Effective-From/To）
	From *StatsFrom `form:"from,omitempty" json:"from,omitempty"`

	// To 绝对窗口上界（不含，RFC3339）。与 from 同生共死：只给一端 → 400 `reason=window_ambiguous`；from 不早于 to → 400 `reason=window_invalid`
	To *StatsTo `form:"to,omitempty" json:"to,omitempty"`

	// Window 相对窗口（时长串，Go `time.ParseDuration` 形态，如 `24h`/`168h`/`2160h`）。
	// 给出它时**必须**省略 `from`/`to`（同时给出 → 400 `reason=window_ambiguous`）。
	// 服务端自持时钟：`to` = 当前时刻向上取整到 UTC 整点、`from` = `to` − `window`
	// ⇒ 两端恒整点，命中卷积表的精确分支（零对齐位移、零桶丢失），这就是 UI 预设
	// 走这条形态的理由。
	//
	// **只收时长，不收日历天**：`d` 不是 `time.ParseDuration` 的单位，`7d` → 400
	// （`reason=window_invalid`）。理由：`24h` 与"一个日历天"在 DST 切换日不相等，
	// 而本 API 的唯一对齐基准是固定 1h 网格；另立 `AddDate` 日历语义会引入第二套
	// 窗口长度语义。预设即网格整倍数：24h / 168h / 720h / 2160h。
	Window *StatsWindow `form:"window,omitempty" json:"window,omitempty"`

	// Timezone IANA 时区名（如 Asia/Shanghai / America/New_York；控制台取浏览器时区）。
	// 仅影响**分组读**：时间桶按该时区的本地小时/日界聚合。显式 from/to 恒为
	// 绝对时刻直透，不受时区改写；排行/TTFT 等无分组数值端点接受并校验该参数
	// 但不改变数值。空/缺省 = UTC（兼容旧客户端）；未知名 → 400。overview 的
	// 「今日」日界仍按该时区本地零点计算（窗口是 days，不是 from/to）。
	//
	// 窗口上限**不是一个固定天数**：界不齐时服务端把两端向后取整到整点以换取
	// 卷积表快路径（生效窗口用 X-Stats-Effective-From/To 回显），能否用卷积表
	// 取决于**时区偏移是否恒整点且窗内无 DST 跳变**；DST 或 :30/:45 偏移时区的
	// 分组读只能扫原始明细行。成本上限是保留期无关的纯常量（分组原始行固定
	// 8 天、卷积表 90 天），覆盖上限另有 per-table 保留期闸门（起点早于保留
	// 截止 → 400）。两者的**真实数值见 GET /api/admin/stats/capabilities**。
	Timezone *StatsTimezone `form:"timezone,omitempty" json:"timezone,omitempty"`
}

type GetSupplierChunksParams struct {
	Limit  *int `form:"limit,omitempty" json:"limit,omitempty"`
	Offset *int `form:"offset,omitempty" json:"offset,omitempty"`
}

type GetSupplierEarningsParams struct {
	Limit  *int `form:"limit,omitempty" json:"limit,omitempty"`
	Offset *int `form:"offset,omitempty" json:"offset,omitempty"`
}

type GetSupplierGroupsParams struct {
	// Limit 每页条数（上限 200，超限裁剪到 200）
	Limit  *ListLimit                    `form:"limit,omitempty" json:"limit,omitempty"`
	Offset *ListOffset                   `form:"offset,omitempty" json:"offset,omitempty"`
	Name   *ListName                     `form:"name,omitempty" json:"name,omitempty"`
	Sort   *ListSort                     `form:"sort,omitempty" json:"sort,omitempty"`
	Order  *GetSupplierGroupsParamsOrder `form:"order,omitempty" json:"order,omitempty"`
}

type GetSupplierGroupsParamsOrder string

type GetSupplierSettlementsParams struct {
	Limit  *int `form:"limit,omitempty" json:"limit,omitempty"`
	Offset *int `form:"offset,omitempty" json:"offset,omitempty"`
}

type GetSupplierTemplatesParams struct {
	// Limit 每页条数（上限 200，超限裁剪到 200）
	Limit  *ListLimit                       `form:"limit,omitempty" json:"limit,omitempty"`
	Offset *ListOffset                      `form:"offset,omitempty" json:"offset,omitempty"`
	Name   *ListName                        `form:"name,omitempty" json:"name,omitempty"`
	Sort   *ListSort                        `form:"sort,omitempty" json:"sort,omitempty"`
	Order  *GetSupplierTemplatesParamsOrder `form:"order,omitempty" json:"order,omitempty"`
}

type GetSupplierTemplatesParamsOrder string

type Group struct {
	CreatedAt *time.Time `json:"CreatedAt,omitempty"`

	// DeletedAt 软删除时间戳；null = 存活（列表/消费路径过滤已删；GET 单个可查已删项）
	DeletedAt *time.Time `json:"DeletedAt"`

	// Description 分组描述（空串 = 无描述）
	Description *string `json:"Description,omitempty"`
	ID          *int64  `json:"ID,omitempty"`
	Name        *string `json:"Name,omitempty"`

	// PriceMultiplier 价格倍率（正常值，1 = ×1，0 = 免费，上限 10 = ×10；API 边界与万分数换算——存储 15000 ↔ 显示 1.5）
	PriceMultiplier *float64 `json:"PriceMultiplier,omitempty"`

	// ProtocolConvert 协议转换方向集合（空数组 = off = 不转换；多方向按客户端格式命中）
	ProtocolConvert *[]GroupProtocolConvert `json:"ProtocolConvert,omitempty"`
	UpdatedAt       *time.Time              `json:"UpdatedAt,omitempty"`
	Visibility      *GroupVisibility        `json:"Visibility,omitempty"`
}

type GroupListResponse struct {
	Rows  []Group `json:"rows"`
	Total int64   `json:"total"`
}

type GroupProtocolConvert string

type GroupVisibility string

type ImportFailedItem struct {
	// Error 该行失败原因文案
	Error string `json:"error"`

	// Index items 原始下标
	Index int `json:"index"`
}

type ImportResult struct {
	Failed []ImportFailedItem `json:"failed"`

	// Imported 新建账号数
	Imported int `json:"imported"`

	// Updated 键存在更新凭据数
	Updated int `json:"updated"`
}

type InvalidParamFormatError struct {
	ParamName string
	Err       error
}

type ListLimit = int

type ListName = string

type ListOffset = int

type ListOrder string

type ListSort = string

type MiddlewareFunc func(http.Handler) http.Handler

type ModelMappingEntry struct {
	MappedModel string                `json:"mapped_model"`
	Mode        ModelMappingEntryMode `json:"mode"`
}

type ModelMappingEntryMode string

type PatchSupplierAccountsIdJSONRequestBody = AccountConfigPatch

type PatchSupplierAccountsIdParams struct {
	IfMatch *string `json:"If-Match,omitempty"`
}

type PostSupplierAccountsBatchDeleteJSONRequestBody = BatchDeleteBody

type PostSupplierAccountsBatchImportCodexOauthJSONRequestBody = CodexOAuthImportBody

type PostSupplierAccountsBatchImportCodexPatJSONRequestBody = CodexPATImportBody

type PostSupplierAccountsBatchUpdateJSONRequestBody = BatchUpdateAccountsBody

type PostSupplierAccountsIdRecoverJSONRequestBody = AccountRecoverBody

type PostSupplierAccountsJSONRequestBody = AccountCreate

type PostSupplierSettlementJSONRequestBody = ApplySettlementBody

type PutSupplierAccountsIdExtJSONRequestBody = AccountExt

type RequiredHeaderError struct {
	ParamName string
	Err       error
}

type RequiredParamError struct {
	ParamName string
}

type ServerInterface interface {
	// 账号列表（分页/筛选/排序，含运行时视图；作用域 = JWT 归属）
	// (GET /api/user/supplier/accounts)
	GetSupplierAccounts(w http.ResponseWriter, r *http.Request, params GetSupplierAccountsParams)
	// 创建账号（归属恒为 JWT 本人；携带他人 supplier_user_id ⇒ 400）
	// (POST /api/user/supplier/accounts)
	PostSupplierAccounts(w http.ResponseWriter, r *http.Request)
	// 批量删除账号（事务，全成或全败；任一 id 越域 ⇒ 整事务失败）
	// (POST /api/user/supplier/accounts/batch-delete)
	PostSupplierAccountsBatchDelete(w http.ResponseWriter, r *http.Request)
	// 批量导入 codex-oauth 凭据（幂等组合键 codex_email + codex_account_id；行级失败不毁整批）
	// (POST /api/user/supplier/accounts/batch-import-codex-oauth)
	PostSupplierAccountsBatchImportCodexOauth(w http.ResponseWriter, r *http.Request)
	// 批量导入 codex-pat 凭据（幂等组合键 codex_email + codex_account_id；行级失败不毁整批）
	// (POST /api/user/supplier/accounts/batch-import-codex-pat)
	PostSupplierAccountsBatchImportCodexPat(w http.ResponseWriter, r *http.Request)
	// 批量更新账号（fields 为任意字段子集；字段层与管理面零差异化）
	// (POST /api/user/supplier/accounts/batch-update)
	PostSupplierAccountsBatchUpdate(w http.ResponseWriter, r *http.Request)
	// 账号用量聚合（统一 usage API——批量 ≤100 条；窗口 from/to 或 window 恰择一）
	// (GET /api/user/supplier/accounts/usage)
	GetSupplierAccountsUsage(w http.ResponseWriter, r *http.Request, params GetSupplierAccountsUsageParams)
	// 删除账号（越域 id ⇒ 404）
	// (DELETE /api/user/supplier/accounts/{id})
	DeleteSupplierAccountsId(w http.ResponseWriter, r *http.Request, id int64)
	// 账号（越域 id ⇒ 404，不泄漏存在性）
	// (GET /api/user/supplier/accounts/{id})
	GetSupplierAccountsId(w http.ResponseWriter, r *http.Request, id int64)
	// 部分更新账号（三态语义与管理面一致：缺省=不变；可空标量 null=清空、""=400；不可空标量 null=400；有值=落值）
	// (PATCH /api/user/supplier/accounts/{id})
	PatchSupplierAccountsId(w http.ResponseWriter, r *http.Request, id int64, params PatchSupplierAccountsIdParams)
	// 读取账号类型化鉴权扩展（仅 codex-oauth/codex-pat 账号有 ext 行）
	// (GET /api/user/supplier/accounts/{id}/ext)
	GetSupplierAccountsIdExt(w http.ResponseWriter, r *http.Request, id int64)
	// 幂等写入账号类型化鉴权扩展（Create/Update 合一；全列更新含 NULL 清空）
	// (PUT /api/user/supplier/accounts/{id}/ext)
	PutSupplierAccountsIdExt(w http.ResponseWriter, r *http.Request, id int64)
	// 读取账号的全部分组 id（编辑回显；不随账号列表返回）
	// (GET /api/user/supplier/accounts/{id}/groups)
	GetSupplierAccountsIdGroups(w http.ResponseWriter, r *http.Request, id int64)
	// 失效恢复（fenced）：清 failed_at/last_error/failure_source + revision CAS +1 → 新代际置 PROBING 待探针
	// (POST /api/user/supplier/accounts/{id}/recover)
	PostSupplierAccountsIdRecover(w http.ResponseWriter, r *http.Request, id int64)
	// 冻结中明细（未解冻桶）
	// (GET /api/user/supplier/chunks)
	GetSupplierChunks(w http.ResponseWriter, r *http.Request, params GetSupplierChunksParams)
	// 区间收益明细（分页；走报表索引 ②，窗口 = 保留期）
	// (GET /api/user/supplier/earnings)
	GetSupplierEarnings(w http.ResponseWriter, r *http.Request, params GetSupplierEarningsParams)
	// 分组候选列表（分页/筛选/排序；只读——组写面不在供应商面）
	// (GET /api/user/supplier/groups)
	GetSupplierGroups(w http.ResponseWriter, r *http.Request, params GetSupplierGroupsParams)
	// 供应商收益概览（可提领/冻结/累计/生效分成率与冻结小时/最晚解冻时刻/桶行数）
	// (GET /api/user/supplier/overview)
	GetSupplierOverview(w http.ResponseWriter, r *http.Request)
	// 我的结算单（分页）
	// (GET /api/user/supplier/settlements)
	GetSupplierSettlements(w http.ResponseWriter, r *http.Request, params GetSupplierSettlementsParams)
	// 申请结算（条件扣 available + 期间链 + request_key 幂等）
	// (POST /api/user/supplier/settlements)
	PostSupplierSettlement(w http.ResponseWriter, r *http.Request)
	// 模板列表（分页/筛选/排序；只读——模板写面不在供应商面）
	// (GET /api/user/supplier/templates)
	GetSupplierTemplates(w http.ResponseWriter, r *http.Request, params GetSupplierTemplatesParams)
	// 模板（只读）
	// (GET /api/user/supplier/templates/{id})
	GetSupplierTemplatesId(w http.ResponseWriter, r *http.Request, id int64)
}

type ServerInterfaceWrapper struct {
	Handler            ServerInterface
	HandlerMiddlewares []MiddlewareFunc
	ErrorHandlerFunc   func(w http.ResponseWriter, r *http.Request, err error)
}

type StatsFrom = time.Time

type StatsTimezone = string

type StatsTo = time.Time

type StatsWindow = string

type SupplierChunk struct {
	Amount      int64     `json:"amount"`
	AvailableAt time.Time `json:"available_at"`
}

type SupplierChunkList struct {
	Items []SupplierChunk `json:"items"`
	Total int64           `json:"total"`
}

type SupplierEarning struct {
	// Cost 计价额（毫分）
	Cost      int64     `json:"cost"`
	CreatedAt time.Time `json:"created_at"`

	// EarnMillis 收益额（毫分）
	EarnMillis int64   `json:"earn_millis"`
	Model      *string `json:"model,omitempty"`
}

type SupplierEarningList struct {
	Items []SupplierEarning `json:"items"`
	Total int64             `json:"total"`
}

type SupplierOverview struct {
	// Available 可提领（结算申请条件扣）
	Available int64 `json:"available"`

	// BucketRows 未解冻桶行数
	BucketRows int64 `json:"bucket_rows"`

	// FreezeHours 生效冻结小时（0 = 不冻结）
	FreezeHours int `json:"freeze_hours"`

	// FrozenAmount Σ 未解冻桶 amount
	FrozenAmount int64 `json:"frozen_amount"`

	// LatestAvailableAt 在途桶最晚解冻时刻（无桶 = null；运维可见性 §2.4）
	LatestAvailableAt *time.Time `json:"latest_available_at"`

	// LifetimeCredited 累计已入账（只增，永久）
	LifetimeCredited int64 `json:"lifetime_credited"`

	// LifetimePaid 累计已付（只增，永久）
	LifetimePaid int64 `json:"lifetime_paid"`

	// ShareBp 生效分成率（bp；10000 = 100%）
	ShareBp int `json:"share_bp"`
}

type SupplierSettlement struct {
	AmountMillis       int64                  `json:"amount_millis"`
	ExternalRef        *string                `json:"external_ref"`
	Id                 int64                  `json:"id"`
	Kind               SupplierSettlementKind `json:"kind"`
	Note               *string                `json:"note"`
	PaidAt             *time.Time             `json:"paid_at"`
	PaidOperatorUserId *int64                 `json:"paid_operator_user_id"`

	// PayeeSnapshot 固定收款目标快照（结构化 JSON）
	PayeeSnapshot *string `json:"payee_snapshot"`

	// PaymentKey 首次 claim 生成、全局唯一、永久固定的付款键（重试/恢复复用不换键）
	PaymentKey           *string    `json:"payment_key"`
	PayoutFailedAt       *time.Time `json:"payout_failed_at"`
	PayoutFailureReason  *string    `json:"payout_failure_reason"`
	PayoutOperatorUserId *int64     `json:"payout_operator_user_id"`
	PayoutStartedAt      *time.Time `json:"payout_started_at"`
	PeriodEnd            time.Time  `json:"period_end"`
	PeriodStart          time.Time  `json:"period_start"`
	RejectReason         *string    `json:"reject_reason"`
	RequestKey           string     `json:"request_key"`
	RequestedAt          time.Time  `json:"requested_at"`
	RequestedOperator    int64      `json:"requested_operator"`
	ReviewedAt           *time.Time `json:"reviewed_at"`
	ReviewerUserId       *int64     `json:"reviewer_user_id"`
	Revision             int64      `json:"revision"`

	// RiskReview 风险核对记录（结构化 JSON）
	RiskReview     *string                  `json:"risk_review"`
	Status         SupplierSettlementStatus `json:"status"`
	SupplierUserId int64                    `json:"supplier_user_id"`
}

type SupplierSettlementKind string

type SupplierSettlementList struct {
	Items []SupplierSettlement `json:"items"`
	Total int64                `json:"total"`
}

type SupplierSettlementStatus string

type Template struct {
	// BaseURL credential-type conditional: codex-oauth/codex-pat always empty (non-empty forbidden); api_key/responses-special may include a protocol prefix such as /zen but must not end in /v1 (non-empty override, or empty for default/route failure)
	BaseURL   string    `json:"BaseURL"`
	CreatedAt time.Time `json:"CreatedAt"`

	// CredentialType 模板号池类型；生态三类型只支持 resp / resp-ws / images / search 格式
	CredentialType *TemplateCredentialType `json:"CredentialType,omitempty"`

	// DeletedAt 软删除时间戳；null = 存活（列表过滤已删；GET 单个可查已删项）
	DeletedAt        *time.Time                    `json:"DeletedAt"`
	FormatModels     *map[string][]string          `json:"FormatModels,omitempty"`
	ID               int64                         `json:"ID"`
	ModelMapping     *map[string]ModelMappingEntry `json:"ModelMapping,omitempty"`
	Models           *[]string                     `json:"Models,omitempty"`
	Name             string                        `json:"Name"`
	SupportedFormats []TemplateSupportedFormats    `json:"SupportedFormats"`
	UpdatedAt        time.Time                     `json:"UpdatedAt"`
}

type TemplateCredentialType string

type TemplateListResponse struct {
	Rows  []Template `json:"rows"`
	Total int64      `json:"total"`
}

type TemplateSupportedFormats string

type TooManyValuesForParamError struct {
	ParamName string
	Count     int
}

type UnescapedCookieParamError struct {
	ParamName string
	Err       error
}

type Unimplemented struct{}

type UnmarshalingParamError struct {
	ParamName string
	Err       error
}

type UsageGatewayStats struct {
	// CostUsd 计费成本（USD，毫分 /1e5）
	CostUsd float64 `json:"cost_usd"`

	// RawCostUsd 乘倍率前原始成本（USD，毫分 /1e5）
	RawCostUsd float64 `json:"raw_cost_usd"`

	// Requests 请求数（COUNT(*)）
	Requests int64 `json:"requests"`

	// TotalTokens 总 token（SUM(total_tokens)）
	TotalTokens int64 `json:"total_tokens"`
}