llm

type Classified struct {
	Retryable bool
	Code      string // contract.ErrCode*（Server/Auth/RateLimit/Transport/Overflow/Aborted）
	Message   string // 面向用户的中文文案（调用方自行截断）
}

type ImageResolver func(path string) ([]byte, string, error)

type Limit struct {
	Context int `json:"context"`
	Output  int `json:"output"`
}

type ModelFactory func(ctx context.Context, p ProviderSpec, m ModelSpec, effort string) (model.BaseModel[*schema.Message], error)

type ModelOpt struct {
	Key           string   `json:"key"`
	Provider      string   `json:"provider"`
	ProviderName  string   `json:"provider_name"`
	Name          string   `json:"name"`
	Input         []string `json:"input"`
	ContextWindow int      `json:"context_window"` // 上下文窗口（Limit.Context 显式值 > 推断表；0=未知只显 token 绝对数）
}

type ModelSpec struct {
	ID        string     `json:"id"`
	Name      string     `json:"name"`
	Reasoning *Reasoning `json:"reasoning"`
	Limit     *Limit     `json:"limit,omitempty"`
	Input     []string   `json:"input"` // ⊆ text/image（空 = text）
	Priority  int        `json:"priority"`
	// NoToolCalls 明示该模型不支持函数调用（A4：人工维护元数据，可能过时——
	// fail fast 价值大于标记维护成本）。置位时 assemble 期工具面非空（含会话
	// 域件与 spawn）即 CONFIG 错误，不等首轮运行期报端点方言各异的错；能力
	// 是模型属性故放 ModelSpec 而非 ProviderSpec（同 provider 各模型可不同，
	// Input 能力面同先例）。
	NoToolCalls bool `json:"no_tool_calls,omitempty"`
	// Temperature / TopP 采样参数（nil = 不发字段走端点默认——多数推理端点
	// 拒绝显式 temperature，只在用户显式设置时下发；随会话模型快照粘住，
	// 会话内不变即前缀缓存友好）。建议二选一，不同时设。
	Temperature *float64 `json:"temperature,omitempty"`
	TopP        *float64 `json:"top_p,omitempty"`
}

type ProviderSpec struct {
	ID      string      `json:"id"` // 稳定标识（复合键引用，不可改）
	Name    string      `json:"name"`
	Kind    string      `json:"kind"` // anthropic | openai | responses（responses 形式选项,组装未实现）
	BaseURL string      `json:"base_url"`
	APIKey  string      `json:"api_key"`           // write-only
	Dialect string      `json:"dialect,omitempty"` // 思考方言("" 零发送走端点默认 | "deepseek" 私有块+档位直传 | "glm" 智谱同形私有块 | "effort" 通用 reasoning_effort)——厂家私有格式只走 dialect,绝不写进通用分支
	Enabled bool        `json:"enabled"`
	Catalog []string    `json:"catalog,omitempty"` // 拉取到的端点模型清单（fetch-models 结果缓存,随保存持久化;UI 下拉数据源,不参与校验/路由）
	Models  []ModelSpec `json:"models"`
}

type Reasoning struct {
	Variants []string `json:"variants"`
	Default  string   `json:"default"`
}

type Settings struct {
	Providers []ProviderSpec `json:"providers"`
}

type SettingsV1 struct {
	API          string    `json:"api" yaml:"api"`
	BaseURL      string    `json:"base_url" yaml:"base_url"`
	APIKey       string    `json:"api_key" yaml:"api_key"`
	DefaultModel string    `json:"default_model" yaml:"default_model"` // 迁移丢弃（默认值改属用户）
	Thinking     string    `json:"thinking" yaml:"thinking"`
	Models       []string  `json:"models" yaml:"models"`
	Vision       *VisionV1 `json:"vision" yaml:"vision"`
}

type Store interface {
	ReadLLMFile(name string) ([]byte, bool)
}

type UserPrefs = contract.UserPrefs

type VisionV1 struct {
	API     string `json:"api" yaml:"api"`
	BaseURL string `json:"base_url" yaml:"base_url"`
	APIKey  string `json:"api_key" yaml:"api_key"`
	Model   string `json:"model" yaml:"model"`
}