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"`
	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"`
	// 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"`
}

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 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 ModelProviderConfig struct {
	Model       string            `yaml:"model" json:"model"`
	BaseURL     string            `yaml:"base_url" json:"base_url"`
	APIKey      string            `yaml:"api_key" json:"api_key"`
	BearerToken string            `yaml:"bearer_token" json:"bearer_token"`
	WorkingDir  string            `yaml:"working_dir" json:"working_dir"`
	Extra       map[string]string `yaml:"extra" json:"extra"`
}

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

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 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"`
}