60255
Zn
Zoea-Nova / files
Zoea-Nova / internal / config / config.go
4.1 KB
1// Package config handles configuration loading from TOML files and environment variables. 2package config 3 4import ( 5 "errors" 6 "fmt" 7 "net/url" 8 "os" 9 "path/filepath" 10 "strconv" 11 12 "github.com/BurntSushi/toml" 13) 14 15// Config is the root configuration structure. 16type Config struct { 17 Swarm SwarmConfig `toml:"swarm"` 18 Providers map[string]ProviderConfig `toml:"providers"` 19 MCP MCPConfig `toml:"mcp"` 20} 21 22// SwarmConfig holds swarm-related settings. 23type SwarmConfig struct { 24 MaxMyses int `toml:"max_myses"` 25 DefaultProvider string `toml:"default_provider"` 26} 27 28// ProviderConfig holds LLM provider settings. 29type ProviderConfig struct { 30 Endpoint string `toml:"endpoint"` 31 Model string `toml:"model"` 32 APIKeyName string `toml:"api_key_name"` 33 Temperature float64 `toml:"temperature"` 34} 35 36// MCPConfig holds MCP proxy settings. 37type MCPConfig struct { 38 Upstream string `toml:"upstream"` 39} 40 41// Load reads configuration from a TOML file and applies environment variable overrides. 42func Load(path string) (*Config, error) { 43 cfg := &Config{ 44 Providers: make(map[string]ProviderConfig), 45 } 46 47 // Config file is required 48 if path == "" { 49 return nil, fmt.Errorf("config path is required") 50 } 51 52 // File must exist 53 if _, err := os.Stat(path); err != nil { 54 return nil, fmt.Errorf("config file not found: %s", path) 55 } 56 57 // Load from file 58 _, err := toml.DecodeFile(path, cfg) 59 if err != nil { 60 return nil, fmt.Errorf("failed to parse config: %w", err) 61 } 62 63 // Apply environment variable overrides 64 applyEnvOverrides(cfg) 65 66 if err := cfg.Validate(); err != nil { 67 return nil, err 68 } 69 70 return cfg, nil 71} 72 73// Validate returns an error if the configuration is invalid. 74func (c *Config) Validate() error { 75 var errs []error 76 77 if c.Swarm.MaxMyses < 1 || c.Swarm.MaxMyses > 100 { 78 errs = append(errs, fmt.Errorf("swarm.max_myses=%d must be between 1 and 100", c.Swarm.MaxMyses)) 79 } 80 81 if len(c.Providers) == 0 { 82 errs = append(errs, errors.New("providers: at least one provider must be configured")) 83 } else { 84 for name, providerCfg := range c.Providers { 85 errs = append(errs, validateProviderConfig(name, providerCfg)...) 86 } 87 } 88 89 if len(errs) > 0 { 90 return errors.Join(errs...) 91 } 92 93 return nil 94} 95 96func validateProviderConfig(name string, cfg ProviderConfig) []error { 97 var errs []error 98 if cfg.Endpoint == "" { 99 errs = append(errs, fmt.Errorf("providers.%s.endpoint is required", name)) 100 } else if err := validateEndpoint(cfg.Endpoint); err != nil { 101 errs = append(errs, fmt.Errorf("providers.%s.endpoint=%q is invalid: %v", name, cfg.Endpoint, err)) 102 } 103 104 if cfg.Model == "" { 105 errs = append(errs, fmt.Errorf("providers.%s.model is required", name)) 106 } 107 108 if cfg.Temperature < 0.0 || cfg.Temperature > 2.0 { 109 errs = append(errs, fmt.Errorf("providers.%s.temperature=%v must be between 0.0 and 2.0", name, cfg.Temperature)) 110 } 111 112 return errs 113} 114 115func validateEndpoint(value string) error { 116 parsed, err := url.Parse(value) 117 if err != nil { 118 return err 119 } 120 if parsed.Scheme == "" || parsed.Host == "" { 121 return errors.New("missing scheme or host") 122 } 123 return nil 124} 125 126// applyEnvOverrides applies environment variable overrides to the configuration. 127func applyEnvOverrides(cfg *Config) { 128 applyInt := func(value string, set func(int)) { 129 if value == "" { 130 return 131 } 132 if n, err := strconv.Atoi(value); err == nil { 133 set(n) 134 } 135 } 136 137 for _, setter := range []struct { 138 env string 139 apply func(string) 140 }{ 141 {"ZOEA_MAX_MYSES", func(v string) { applyInt(v, func(n int) { cfg.Swarm.MaxMyses = n }) }}, 142 {"ZOEA_MCP_ENDPOINT", func(v string) { 143 if v != "" { 144 cfg.MCP.Upstream = v 145 } 146 }}, 147 } { 148 setter.apply(os.Getenv(setter.env)) 149 } 150} 151 152// DataDir returns the path to the Zoea data directory (~/.zoea-nova). 153func DataDir() (string, error) { 154 home, err := os.UserHomeDir() 155 if err != nil { 156 return "", err 157 } 158 return filepath.Join(home, ".zoea-nova"), nil 159} 160 161// EnsureDataDir creates the data directory if it doesn't exist. 162func EnsureDataDir() (string, error) { 163 dir, err := DataDir() 164 if err != nil { 165 return "", err 166 } 167 if err := os.MkdirAll(dir, 0755); err != nil { 168 return "", err 169 } 170 return dir, nil 171}