config

type AgentConfig struct {
	// Providers 是「模型提供商」配置表，key 为模型名（与 Profile.Model 对应）。
	// 一次请求使用的模型由 Profile.Model 指定，据此在此表中查找 base_url / api_key 等 LLM 配置。
	Providers map[string]ModelProviderConfig `yaml:"providers" json:"providers"`
}

type CLIFlags struct {
	ConfigPath     string // --config, config file path
	Port           int    // --port, server port
	Host           string // --host, server host
	LogPath        string // --log-path, server log path
	LogLevel       string // --log-level, log level (debug/info/warn/error/fatal)
	GinMode        string // --gin-mode, gin run mode (debug/release/test)
	DBDriver       string // --db-driver, database driver (sqlite/postgres)
	DBHost         string // --db-host, database host
	DBPort         string // --db-port, database port
	DBUser         string // --db-user, database user
	DBPassword     string // --db-password, database password
	DBName         string // --db-name, database name
	DBPath         string // --db-path, sqlite database file path
	DBSSLMode      string // --db-ssl-mode, database ssl mode
	DefaultRuntime string // --default-runtime, default container runtime (docker/k8s/k3s)
	BaseDir        string // --base-dir, storage base directory
	// contains filtered or unexported fields
}

type Config struct {
	Server      *ServerConfig    `yaml:"server"   json:"server"`
	Database    *DatabaseConfig  `yaml:"database" json:"database"`
	Proxy       *ProxyConfig     `yaml:"proxy"    json:"proxy"`
	Route       *RouteConfig     `yaml:"route"    json:"route"`
	Storage     *StorageConfig   `yaml:"storage"  json:"storage"`
	Git         *GitConfig       `yaml:"git"      json:"git"`
	Realtime    *RealtimeConfig  `yaml:"realtime" json:"realtime"`
	LLM         *LLMConfig       `yaml:"llm" json:"llm"`
	Agent       *AgentConfig     `yaml:"agent" json:"agent"`
	MCP         *MCPConfig       `yaml:"mcp" json:"mcp"`
	Container   *ContainerConfig `yaml:"container" json:"container"`
	DebugConfig *DebugConfig     `yaml:"debug" json:"debug"`
	User        *UserConfig      `yaml:"user"  json:"user"`
	Log         *LogConfig       `yaml:"log"   json:"log"`
}

type ConfigFile struct {
	// Path 是 config.yml 的绝对路径。
	Path string
	// Exists 表示文档被加载时文件是否已经存在。
	Exists bool
	// contains filtered or unexported fields
}

type ContainerConfig struct {
	Kubernetes *KubernetesRuntimeConfig `yaml:"kubernetes" json:"kubernetes"`
	Docker     *DockerRuntimeConfig     `yaml:"docker" json:"docker"`
	// Runtimes is the list of container runtimes to register at startup.
	// e.g. [docker, k8s]. Each entry is normalized via normalizeContainerRuntime.
	Runtimes []string `yaml:"runtimes" json:"runtimes"`
	// DefaultRuntime is the runtime used when no specific runtime is selected.
	// Falls back to the first entry in Runtimes, then "docker".
	DefaultRuntime string `yaml:"default_runtime" json:"default_runtime"`
	// RefreshImageStatusOnStart           bool   `yaml:"refresh_image_status_on_start" json:"refresh_image_status_on_start"`
	RecoverRunningDagOnStart            bool   `yaml:"recover_running_dag_on_start" json:"recover_running_dag_on_start"`
	CleanupDagNodeContainersBeforeStart bool   `yaml:"cleanup_dag_node_containers_before_start" json:"cleanup_dag_node_containers_before_start"`
	DeleteContainerOnNodeSuccess        bool   `yaml:"delete_container_on_node_success" json:"delete_container_on_node_success"`
	DagNodeCleanupOnFailed              string `yaml:"dag_node_cleanup_on_failed" json:"dag_node_cleanup_on_failed"`
	DagNodeCleanupOnDagFinished         string `yaml:"dag_node_cleanup_on_dag_finished" json:"dag_node_cleanup_on_dag_finished"`
	// CreateQueueMaxConcurrency limits how many containers can be created concurrently.
	CreateQueueMaxConcurrency int `yaml:"create_queue_max_concurrency" json:"create_queue_max_concurrency"`
	// CreateQueueMaxPending limits how many creation requests can wait in the queue.
	CreateQueueMaxPending int `yaml:"create_queue_max_pending" json:"create_queue_max_pending"`
	// TerminalSessionTTLMinutes 是终端会话的空闲上限：空闲超过该时长即回收容器并删除记录。
	// <=0 使用默认 120 分钟。设置为很大的值时，只有显式删除 / 容器消失才会回收。
	TerminalSessionTTLMinutes int `yaml:"terminal_session_ttl_minutes" json:"terminal_session_ttl_minutes"`
	// TerminalMaxSessionsPerUser 是单用户同时存在的终端会话上限；<=0 使用默认 4。
	TerminalMaxSessionsPerUser int `yaml:"terminal_max_sessions_per_user" json:"terminal_max_sessions_per_user"`
	// TerminalBufferDir 是滚动缓冲落盘目录；留空使用 <storage.base_dir>/terminal_sessions。
	TerminalBufferDir string `yaml:"terminal_buffer_dir" json:"terminal_buffer_dir"`
	// TerminalBufferKB 是单个会话滚动缓冲的上限（KB）；<=0 使用默认 1024。
	TerminalBufferKB int `yaml:"terminal_buffer_kb" json:"terminal_buffer_kb"`

	// BashExecutionMode 决定 bash 工具的实际执行位置：host（宿主机，默认）或 container（容器）。
	// 该开关只影响执行位置，Agent 对此无感知（工具参数不变）。
	BashExecutionMode string `yaml:"bash_execution_mode" json:"bash_execution_mode"`
	// BashContainerTemplateID 是 container 模式下 bash 工具使用的容器模板 ID。
	// <=0 时使用 DefaultBashContainerTemplateID。
	// ,string 让 JSON 同时接受字符串与数字：int64 主键超出 JS 安全整数范围，
	// 前端以字符串传递，不加该标记会报 cannot unmarshal string into int64。
	BashContainerTemplateID int64 `yaml:"bash_container_template_id" json:"bash_container_template_id,string"`

	// NetworkMode 决定应用容器端口的可达方式（container.network_mode）。
	//
	// 默认 container_ip：gobrave 直接访问容器 IP（docker0 / k8s Pod IP），
	// 不占用宿主机端口；适用于 Linux、Docker Desktop 等能与 daemon 共享网络的主机。
	//
	// host_port：容器端口随机发布到宿主机（-p 0.0.0.0:<random>:<port>），
	// gobrave 通过 宿主机地址 + 随机端口 访问；多实例不会端口冲突。
	// 用于「gobrave 无法路由容器 IP」的场景，典型是 Windows + WSL2 自管 dockerd
	// （容器 IP 在发行版内的 docker0 网桥上，Windows 不可路由）。
	NetworkMode string `yaml:"network_mode" json:"network_mode"`
}

type DatabaseConfig struct {
	Driver   string `yaml:"driver"   json:"driver"`
	Host     string `yaml:"host"     json:"host"`
	Port     string `yaml:"port"     json:"port"`
	User     string `yaml:"user"     json:"user"`
	Password string `yaml:"password" json:"password"`
	Name     string `yaml:"name"     json:"name"`
	SSLMode  string `yaml:"ssl_mode" json:"ssl_mode"`
	Path     string `yaml:"path"     json:"path"`
	// LogLevel 控制 GORM 的 SQL 日志级别，取值 silent / error / warn / info。
	// 默认 warn（只打印慢查询与报错的 SQL）；设为 info 可打印每条 SQL，
	// 仅在排查问题时开启；设为 silent 完全关闭。
	// 该级别只影响 SQL 日志，与 log.level（进程日志级别）互不影响。
	LogLevel string `yaml:"log_level" json:"log_level"`
}

type DebugConfig struct {
	// EnableDagOrchestrator 为 true 时，提交分析会把编排器入参写入调试目录。
	EnableDagOrchestrator bool `yaml:"enable_dag_orchestrator" json:"enable_dag_orchestrator"`
}

type DockerRuntimeConfig struct {
	// WSLDaemon 声明 docker daemon 是否运行在 WSL2 内。
	//
	// nil（未配置）：Windows 上按照 DOCKER_HOST（tcp://…）自动推断；
	// true：强制开启，bind mount 的 Source 会从 D:\x 翻译成 /mnt/d/x；
	// false：强制关闭，Source 保持 Windows 盘符路径（Docker Desktop npipe 等）。
	WSLDaemon *bool `yaml:"wsl_daemon" json:"wsl_daemon"`

	// Provision 是 gobrave 自管运行时预置（Windows 上是 WSL 发行版，Linux 上是
	// 本机 dockerd）的配置段。
	Provision *RuntimeProvisionConfig `yaml:"provision" json:"provision"`
}

type GitConfig struct {
	User  string `yaml:"user"  json:"user"`
	Email string `yaml:"email" json:"email"`
}

type K8sIngressRouteConfig struct {
	Namespace        string            `yaml:"namespace"          json:"namespace"`
	Kubeconfig       string            `yaml:"kubeconfig"         json:"kubeconfig"`
	InCluster        bool              `yaml:"in_cluster"         json:"in_cluster"`
	IngressClassName string            `yaml:"ingress_class_name" json:"ingress_class_name"`
	Host             string            `yaml:"host"               json:"host"`
	PathType         string            `yaml:"path_type"          json:"path_type"`
	Annotations      map[string]string `yaml:"annotations"        json:"annotations"`
}

type KubernetesRuntimeConfig struct {
	Namespace  string `yaml:"namespace" json:"namespace"`
	Kubeconfig string `yaml:"kubeconfig" json:"kubeconfig"`
	InCluster  bool   `yaml:"in_cluster" json:"in_cluster"`
}

type LLMConfig struct {
	CLIURL      string             `yaml:"cli_url" json:"cli_url"`
	Model       string             `yaml:"model" json:"model"`
	GitHubToken string             `yaml:"github_token" json:"github_token"`
	Provider    *LLMProviderConfig `yaml:"provider" json:"provider"`
}

type LLMProviderConfig struct {
	Type        string `yaml:"type" json:"type"`
	BaseURL     string `yaml:"base_url" json:"base_url"`
	APIKey      string `yaml:"api_key" json:"api_key"`
	BearerToken string `yaml:"bearer_token" json:"bearer_token"`
}

type LogConfig struct {
	// Level 日志级别：trace/debug/info/warn/error/fatal/panic。默认 info。
	// 需要开启 debug 模式时将其设为 debug 即可。
	Level string `yaml:"level" json:"level"`
	// Path 日志文件路径；为空时使用默认路径 logs/app.log。
	Path string `yaml:"path" json:"path"`
	// Color 颜色模式：auto（默认，仅终端着色）/always/never。
	Color string `yaml:"color" json:"color"`
}

type MCPConfig struct {
	// Enabled 是总开关；false 时不会连接任何 MCP 服务。
	Enabled bool `yaml:"enabled" json:"enabled"`
	// TimeoutSeconds 是启动时发现工具的超时时间（秒），<=0 时使用默认值 60。
	TimeoutSeconds int `yaml:"timeout_seconds" json:"timeout_seconds"`
	// Servers 是 MCP 服务表，key 为服务名。
	Servers map[string]MCPServerConfig `yaml:"servers" json:"servers"`
}

type MCPServerConfig struct {
	// Enabled 控制单个服务是否启用；nil 视为启用。
	Enabled *bool `yaml:"enabled" json:"enabled,omitempty"`
	// Type 是传输类型：stdio（默认）/ sse。留空时按 command / url 推断。
	Type string `yaml:"type" json:"type"`
	// Command / Args / Env 仅 stdio 使用。
	Command string            `yaml:"command" json:"command,omitempty"`
	Args    []string          `yaml:"args" json:"args,omitempty"`
	Env     map[string]string `yaml:"env" json:"env,omitempty"`
	// URL / Headers 仅 sse 使用。
	URL     string            `yaml:"url" json:"url,omitempty"`
	Headers map[string]string `yaml:"headers" json:"headers,omitempty"`
}

type ModelProviderConfig struct {
	// ModelID 是模型标识（配置表的 key），与 API 模型名分离。
	ModelID string `yaml:"model_id" json:"model_id"`
	BaseURL string `yaml:"base_url" json:"base_url"`
	APIKey  string `yaml:"api_key" json:"api_key"`

	// Provider 是模型厂商类型（openai / anthropic / deepseek / gemini …）。
	Provider string `yaml:"provider" json:"provider"`
	// APIModel 是发给厂商的真实模型名；为空时回退 ModelID。
	APIModel string `yaml:"api_model" json:"api_model"`
	// Name 是模型展示名（供前端 / TUI 显示）；为空时回退 ModelID。
	Name string `yaml:"name" json:"name"`

	// ContextWindow 模型上下文窗口（token）；0 表示未知。
	ContextWindow int64 `yaml:"context_window" json:"context_window"`
	// DefaultMaxTokens 模型默认最大输出 token；0 表示未知。
	DefaultMaxTokens int64 `yaml:"default_max_tokens" json:"default_max_tokens"`
	// CanReason 表示模型支持推理 / 思考过程。
	CanReason bool `yaml:"can_reason" json:"can_reason"`
	// SupportsAttachments 表示模型支持图片等附件。
	SupportsAttachments bool `yaml:"supports_attachments" json:"supports_attachments"`

	// CostPer1MIn / CostPer1MOut 是每百万输入 / 输出 token 的价格（美元）。
	// 仅用于会话费用统计与 TUI 展示，不参与请求。
	CostPer1MIn  float64 `yaml:"cost_per_1m_in" json:"cost_per_1m_in"`
	CostPer1MOut float64 `yaml:"cost_per_1m_out" json:"cost_per_1m_out"`
	// CostPer1MInCached / CostPer1MOutCached 是命中缓存的输入 / 输出价格。
	CostPer1MInCached  float64 `yaml:"cost_per_1m_in_cached" json:"cost_per_1m_in_cached"`
	CostPer1MOutCached float64 `yaml:"cost_per_1m_out_cached" json:"cost_per_1m_out_cached"`

	// ReasoningEffort 推理强度（openai 系 low / medium / high），空表示不指定。
	ReasoningEffort string `yaml:"reasoning_effort" json:"reasoning_effort"`

	Extra map[string]string `yaml:"extra" json:"extra"`
}

type ModelVendorOverride map[string]ModelProviderConfig

type ModelVendorPreset struct {
	// Type 是厂商类型，写入 ModelProviderConfig.Provider（决定 SDK 走哪条客户端）。
	Type string `json:"type"`
	// Name 是展示名（UI 下拉框使用）。
	Name string `json:"name"`
	// BaseURL 是厂商默认 API 基地址；留空表示由 SDK 决定（如 azure / bedrock）。
	BaseURL string `json:"base_url"`
	// APIModelPrefix 是该厂商常见的模型名前缀，用于自动补全 APIModel
	// （例如 deepseek 的 deepseek-v4-flash 直接就是真实模型名，前缀即模型名本身）。
	APIModelPrefix string `json:"api_model_prefix,omitempty"`
	// Models 是常见模型名（可为空，用户也可以自行填写）。
	Models []string `json:"models"`
}

type ProxyConfig struct {
	BraveAPI   string `yaml:"brave_api" json:"brave_api"`
	Container  string `yaml:"container" json:"container"`
	OnlyOffice string `yaml:"onlyoffice" json:"onlyoffice"`

	// HTTPProxy 是出站 http:// 请求使用的代理地址，例如 http://10.110.1.11:7890。
	// 为空表示不使用该协议的代理（不会回退到环境变量）。
	HTTPProxy string `yaml:"http_proxy" json:"http_proxy"`
	// HTTPSProxy 是出站 https:// 请求使用的代理地址，例如 http://10.110.1.11:7890。
	// 为空表示不使用该协议的代理（不会回退到环境变量）。
	HTTPSProxy string `yaml:"https_proxy" json:"https_proxy"`
	// NoProxy 是不走代理的主机列表（逗号分隔，支持域名 / IP / CIDR）。
	NoProxy string `yaml:"no_proxy" json:"no_proxy"`
}

type RealtimeConfig struct {
	Transport             string `yaml:"transport" json:"transport"`
	MaxConnectionsPerUser int    `yaml:"max_connections_per_user" json:"max_connections_per_user"`
	AckTimeoutSeconds     int    `yaml:"ack_timeout_seconds" json:"ack_timeout_seconds"`
	AckMaxRetries         int    `yaml:"ack_max_retries" json:"ack_max_retries"`
}

type RouteConfig struct {
	// Registrys is the list of route registries to register at startup.
	// e.g. [gateway, traefik, k8s-ingress]. Each entry is normalized via
	// normalizeRouteRegistry.
	Registrys  []string               `yaml:"registrys"    json:"registrys"`
	AppsPrefix string                 `yaml:"apps_prefix"  json:"apps_prefix"`
	Traefik    *TraefikRouteConfig    `yaml:"traefik"      json:"traefik"`
	K8sIngress *K8sIngressRouteConfig `yaml:"k8s_ingress"  json:"k8s_ingress"`
}

type RuntimeProvisionConfig struct {
	// Enabled 为 true 时启用运行时预置的启动自检：每次启动尝试 Start
	// （已安装则拉起 daemon），未安装时不安装任何东西，等待 UI 安装向导。
	//
	// 与平台无关：Windows 上拉起 WSL 内的 dockerd，Linux 上拉起本机 dockerd。
	Enabled bool `yaml:"enabled" json:"enabled"`
	// Distro 导入到 WSL 的发行版名，默认 gobrave-ubuntu-docker。仅 Windows 生效。
	//
	// 若系统上已存在同名发行版（例如 Ubuntu），安装/启动时直接接管并启动
	// dockerd，无需 DownloadURL、也不会重新导入。
	Distro string `yaml:"distro" json:"distro"`
	// DownloadURL rootfs 包下载地址（安装向导使用）。仅 Windows 生效；
	// 接管已存在的同名发行版时可为空。
	DownloadURL string `yaml:"download_url" json:"download_url"`
	// Endpoint 是 daemon 地址，取值形如 tcp://localhost:2375 或
	// unix:///var/run/docker.sock。仅 Windows 生效：Linux 实现固定用本机 socket。
	Endpoint string `yaml:"endpoint" json:"endpoint"`
}

type Section struct {
	// Key 是配置段在 config.yml 中的顶层键名，同时也是 API 中使用的段标识。
	Key string
	// Label 是用于错误提示的中文名称。
	Label string
	// Effective 返回当前生效的配置段值（用于表单回填与落盘）。
	Effective func(cfg *Config) any
	// Decode 解析并归一化请求体，返回待落盘的值；不会修改 cfg。
	Decode func(raw json.RawMessage) (any, error)
	// Apply 把已经成功落盘的值写入内存配置，使其立即生效。
	Apply func(cfg *Config, value any) error
}

type ServerConfig struct {
	Port int `yaml:"port"             json:"port"`
	// GRPCPort        int           `yaml:"grpc_port"        json:"grpc_port"`
	Host            string        `yaml:"host"             json:"host"`
	ShutdownTimeout time.Duration `yaml:"shutdown_timeout" json:"shutdown_timeout" default:"30s"`
	// Mode 是 Gin 运行模式：debug / release / test。
	// 留空时回退到 GIN_MODE 环境变量，最后回退到默认值（debug）。
	Mode string `yaml:"mode" json:"mode"`
}

type StorageConfig struct {
	// ImageDir string `yaml:"image_dir" json:"image_dir"`
	BaseDir string `yaml:"base_dir" json:"base_dir"`
}

type TraefikRouteConfig struct {
	Provider      string `yaml:"provider"        json:"provider"`
	BaseURL       string `yaml:"base_url"        json:"base_url"`
	UpsertPath    string `yaml:"upsert_path"     json:"upsert_path"`
	DeletePath    string `yaml:"delete_path"     json:"delete_path"`
	AuthToken     string `yaml:"auth_token"      json:"auth_token"`
	TimeoutSecond int    `yaml:"timeout_second"  json:"timeout_second"`
	FilePath      string `yaml:"file_path"       json:"file_path"`
}

type UserConfig struct {
	DisableRegistration bool   `yaml:"disable_registration" json:"disable_registration"`
	JWTSecret           string `yaml:"jwt_secret" json:"jwt_secret"`
}