bootstrap

type Budget struct {
	MaxCostUSD float64 `json:"max_cost_usd,omitempty"` // 美元上限；<=0 未启用
	WarnRatio  float64 `json:"warn_ratio,omitempty"`   // 告警阈值比例 (0,1)，默认 0.8
}

type Config struct {
	// 运行时字段（不序列化到 JSON）
	OutputDir string `json:"-"` // 输出根目录

	// 默认 LLM 配置
	Provider  string `json:"provider"` // 默认 provider（Providers map 中的 key）
	ModelName string `json:"model"`    // 默认模型名

	// Provider 凭证库
	Providers map[string]ProviderConfig `json:"providers,omitempty"`

	// 角色级模型覆盖
	Roles map[string]RoleConfig `json:"roles,omitempty"`

	// 创作参数
	Style string `json:"style,omitempty"`

	// ContextWindow 上下文压缩使用的窗口大小。留空（0）时按模型名自动解析：
	// registry 命中用模型真实窗口，未命中兜底 DefaultContextWindow。
	// 显式配置则优先生效——用于给 registry 查不到的自定义模型指定真实窗口，
	// 或把大窗口模型钉在更小的值上提前触发压缩（1M 名义窗口在 200k+ 通常已注意力衰退）。
	// 仅影响压缩阈值，不改变 LLM API 实际请求长度；配置值由用户自负其责。
	ContextWindow int `json:"context_window,omitempty"`

	// 多人格竞稿配置；为空或 personas < 2 时退回单 Writer 行为（完全向后兼容）。
	WritingContest WritingContest `json:"writing_contest,omitempty"`

	// 全书成本预算；MaxCostUSD<=0 视为未启用（完全向后兼容）。
	Budget Budget `json:"budget,omitempty"`

	// PlanReview 规划完成后是否暂停等待用户审阅大纲："auto"（TUI 开/headless 关，默认）、"on"、"off"
	PlanReview string `json:"plan_review,omitempty"`
}

type ContextWindowSource string

type FailoverEvent struct {
	Role         string
	Reason       string
	FromProvider string
	FromModel    string
	ToProvider   string
	ToModel      string
	Err          error
}

type FailoverReporter func(FailoverEvent)

type ModelRef struct {
	Provider string `json:"provider"` // provider 名称（Providers map 中的 key）
	Model    string `json:"model"`    // 模型名（原样透传，不做任何解析）
}

type ModelSet struct {
	Default *SwappableModel
	// contains filtered or unexported fields
}

type ProviderConfig struct {
	Type    string   `json:"type,omitempty"`     // API 协议类型（openai/anthropic/gemini），自定义代理时指定
	APIKey  string   `json:"api_key,omitempty"`  // API Key
	BaseURL string   `json:"base_url,omitempty"` // API Base URL
	Models  []string `json:"models,omitempty"`   // 可选模型列表，供 TUI 切换时展示
	// ExtraBody 透传给该 provider 每次请求的额外参数（如 temperature/top_p/min_p/
	// presence_penalty，或厂商特有键如 nvidia 开 think 的 chat_template_kwargs）。
	// OpenAI 兼容端逐字并入请求体（即 extra_body 约定）；值由用户自负其责。
	ExtraBody map[string]any `json:"extra_body,omitempty"`
}

type RoleConfig struct {
	Provider  string     `json:"provider"`            // 主 provider 名称（Providers map 中的 key）
	Model     string     `json:"model"`               // 主模型名（原样透传，不做任何解析）
	Fallbacks []ModelRef `json:"fallbacks,omitempty"` // 显式备用 provider/model 列表
}

type SwappableModel struct {
	*agentcore.SwappableModel
	// contains filtered or unexported fields
}

type WritingContest struct {
	// Personas 是作者名列表（如 ["乌贼","卖报小郎君","土豆"]）。
	// 数量即并行 Writer 数；< 2 时不启用竞稿。
	// 每个作者名必须有对应人格画像：把该作者作品语料放入 ./simulate/personas/<作者名>/
	// 并运行 /simulate 生成；缺任一画像则竞稿整体禁用（启动日志会列出缺失项），重启生效。
	// 运行期写手的文风信号 = 人格画像与主画像的融合画像（经 novel_context 注入，单信号）。
	Personas []string `json:"personas,omitempty"`
	// Judge 可选，指定选优裁判模型；缺省复用 editor 角色模型。
	Judge *ModelRef `json:"judge,omitempty"`
	// Concurrency=true 时候选生成阶段并发（一次 parallel subagent 调用）；
	// 缺省/false 为串行（逐个补齐，现状行为）。personas<2 时此开关无意义。
	Concurrency bool `json:"concurrency,omitempty"`
	// Mode 竞稿模式：""/"full"（默认，候选写全章）或 "synopsis"（两段式：候选只写
	// 梗概+开头试写，中选后由该 persona 写全章。token 成本约降为 full 模式的 1/N）。
	Mode string `json:"mode,omitempty"`
}