@@ -2,6 +2,9 @@
22 package config
33
44 import (
5+ "errors"
6+ "fmt"
7+ "net/url"
58 "os"
69 "path/filepath"
710 "strconv"
@@ -65,115 +68,219 @@ func DefaultConfig() *Config {
6568
6669 // Load reads configuration from a TOML file and applies environment variable overrides.
6770 func Load(path string) (*Config, error) {
71+ defaults := DefaultConfig()
6872 cfg := DefaultConfig()
73+ var meta toml.MetaData
74+ var loaded bool
6975
7076 // Load from file if it exists
7177 if path != "" {
7278 if _, err := os.Stat(path); err == nil {
73- if _, err := toml.DecodeFile(path, cfg); err != nil {
79+ decoded, err := toml.DecodeFile(path, cfg)
80+ if err != nil {
7481 return nil, err
7582 }
83+ meta = decoded
84+ loaded = true
7685 }
7786 }
7887
88+ if loaded {
89+ applyProviderDefaults(cfg, defaults, meta)
90+ }
91+
7992 // Apply environment variable overrides
8093 applyEnvOverrides(cfg)
8194
95+ if err := cfg.Validate(); err != nil {
96+ return nil, err
97+ }
98+
8299 return cfg, nil
83100 }
84101
85-// applyEnvOverrides applies environment variable overrides to the configuration.
86-func applyEnvOverrides(cfg *Config) {
87- if v := os.Getenv("ZOEA_MAX_MYSES"); v != "" {
88- if n, err := strconv.Atoi(v); err == nil {
89- cfg.Swarm.MaxMyses = n
102+// Validate returns an error if the configuration is invalid.
103+func (c *Config) Validate() error {
104+ var errs []error
105+
106+ if c.Swarm.MaxMyses < 1 || c.Swarm.MaxMyses > 100 {
107+ errs = append(errs, fmt.Errorf("swarm.max_myses=%d must be between 1 and 100", c.Swarm.MaxMyses))
108+ }
109+
110+ if len(c.Providers) == 0 {
111+ errs = append(errs, errors.New("providers: at least one provider must be configured"))
112+ } else {
113+ for name, providerCfg := range c.Providers {
114+ errs = append(errs, validateProviderConfig(name, providerCfg)...)
90115 }
91116 }
92117
93- if v := os.Getenv("ZOEA_MCP_ENDPOINT"); v != "" {
94- cfg.MCP.Upstream = v
118+ if len(errs) > 0 {
119+ return errors.Join(errs...)
95120 }
96121
97- if v := os.Getenv("ZOEA_OLLAMA_ENDPOINT"); v != "" {
98- if p, ok := cfg.Providers["ollama"]; ok {
99- p.Endpoint = v
100- cfg.Providers["ollama"] = p
101- }
122+ return nil
123+}
124+
125+func validateProviderConfig(name string, cfg ProviderConfig) []error {
126+ var errs []error
127+ if cfg.Endpoint == "" {
128+ errs = append(errs, fmt.Errorf("providers.%s.endpoint is required", name))
129+ } else if err := validateEndpoint(cfg.Endpoint); err != nil {
130+ errs = append(errs, fmt.Errorf("providers.%s.endpoint=%q is invalid: %v", name, cfg.Endpoint, err))
102131 }
103132
104- if v := os.Getenv("ZOEA_OLLAMA_MODEL"); v != "" {
105- if p, ok := cfg.Providers["ollama"]; ok {
106- p.Model = v
107- cfg.Providers["ollama"] = p
108- }
133+ if cfg.Model == "" {
134+ errs = append(errs, fmt.Errorf("providers.%s.model is required", name))
109135 }
110136
111- if v := os.Getenv("ZOEA_OLLAMA_TEMPERATURE"); v != "" {
112- if f, err := strconv.ParseFloat(v, 64); err == nil {
113- if p, ok := cfg.Providers["ollama"]; ok {
114- p.Temperature = f
115- cfg.Providers["ollama"] = p
116- }
117- }
137+ if cfg.Temperature < 0.0 || cfg.Temperature > 2.0 {
138+ errs = append(errs, fmt.Errorf("providers.%s.temperature=%v must be between 0.0 and 2.0", name, cfg.Temperature))
118139 }
119140
120- if v := os.Getenv("ZOEA_OLLAMA_RATE_LIMIT"); v != "" {
121- if f, err := strconv.ParseFloat(v, 64); err == nil {
122- if p, ok := cfg.Providers["ollama"]; ok {
123- p.RateLimit = f
124- cfg.Providers["ollama"] = p
125- }
126- }
141+ if cfg.RateLimit <= 0 {
142+ errs = append(errs, fmt.Errorf("providers.%s.rate_limit=%v must be greater than 0", name, cfg.RateLimit))
143+ }
144+ if cfg.RateBurst < 1 {
145+ errs = append(errs, fmt.Errorf("providers.%s.rate_burst=%d must be at least 1", name, cfg.RateBurst))
127146 }
128147
129- if v := os.Getenv("ZOEA_OLLAMA_RATE_BURST"); v != "" {
130- if n, err := strconv.Atoi(v); err == nil {
131- if p, ok := cfg.Providers["ollama"]; ok {
132- p.RateBurst = n
133- cfg.Providers["ollama"] = p
134- }
135- }
148+ return errs
149+}
150+
151+func validateEndpoint(value string) error {
152+ parsed, err := url.Parse(value)
153+ if err != nil {
154+ return err
136155 }
156+ if parsed.Scheme == "" || parsed.Host == "" {
157+ return errors.New("missing scheme or host")
158+ }
159+ return nil
160+}
161+
162+func applyProviderDefaults(cfg *Config, defaults *Config, meta toml.MetaData) {
163+ if cfg == nil || defaults == nil {
164+ return
165+ }
166+
167+ for name, fallback := range defaults.Providers {
168+ current, ok := cfg.Providers[name]
169+ if !ok {
170+ cfg.Providers[name] = fallback
171+ continue
172+ }
137173
138- if v := os.Getenv("ZOEA_OPENCODE_ENDPOINT"); v != "" {
139- if p, ok := cfg.Providers["opencode_zen"]; ok {
140- p.Endpoint = v
141- cfg.Providers["opencode_zen"] = p
174+ if !meta.IsDefined("providers", name, "endpoint") {
175+ current.Endpoint = fallback.Endpoint
142176 }
177+ if !meta.IsDefined("providers", name, "model") {
178+ current.Model = fallback.Model
179+ }
180+ if !meta.IsDefined("providers", name, "temperature") {
181+ current.Temperature = fallback.Temperature
182+ }
183+ if !meta.IsDefined("providers", name, "rate_limit") {
184+ current.RateLimit = fallback.RateLimit
185+ }
186+ if !meta.IsDefined("providers", name, "rate_burst") {
187+ current.RateBurst = fallback.RateBurst
188+ }
189+
190+ cfg.Providers[name] = current
143191 }
192+}
144193
145- if v := os.Getenv("ZOEA_OPENCODE_MODEL"); v != "" {
146- if p, ok := cfg.Providers["opencode_zen"]; ok {
147- p.Model = v
148- cfg.Providers["opencode_zen"] = p
194+// applyEnvOverrides applies environment variable overrides to the configuration.
195+func applyEnvOverrides(cfg *Config) {
196+ updateProvider := func(name string, update func(ProviderConfig) ProviderConfig) {
197+ providerCfg, ok := cfg.Providers[name]
198+ if !ok {
199+ return
149200 }
201+ cfg.Providers[name] = update(providerCfg)
150202 }
151203
152- if v := os.Getenv("ZOEA_OPENCODE_TEMPERATURE"); v != "" {
153- if f, err := strconv.ParseFloat(v, 64); err == nil {
154- if p, ok := cfg.Providers["opencode_zen"]; ok {
155- p.Temperature = f
156- cfg.Providers["opencode_zen"] = p
157- }
204+ applyInt := func(value string, set func(int)) {
205+ if value == "" {
206+ return
207+ }
208+ if n, err := strconv.Atoi(value); err == nil {
209+ set(n)
158210 }
159211 }
160212
161- if v := os.Getenv("ZOEA_OPENCODE_RATE_LIMIT"); v != "" {
162- if f, err := strconv.ParseFloat(v, 64); err == nil {
163- if p, ok := cfg.Providers["opencode_zen"]; ok {
164- p.RateLimit = f
165- cfg.Providers["opencode_zen"] = p
166- }
213+ applyFloat := func(value string, set func(float64)) {
214+ if value == "" {
215+ return
216+ }
217+ if f, err := strconv.ParseFloat(value, 64); err == nil {
218+ set(f)
167219 }
168220 }
169221
170- if v := os.Getenv("ZOEA_OPENCODE_RATE_BURST"); v != "" {
171- if n, err := strconv.Atoi(v); err == nil {
172- if p, ok := cfg.Providers["opencode_zen"]; ok {
173- p.RateBurst = n
174- cfg.Providers["opencode_zen"] = p
222+ for _, setter := range []struct {
223+ env string
224+ apply func(string)
225+ }{
226+ {"ZOEA_MAX_MYSES", func(v string) { applyInt(v, func(n int) { cfg.Swarm.MaxMyses = n }) }},
227+ {"ZOEA_MCP_ENDPOINT", func(v string) {
228+ if v != "" {
229+ cfg.MCP.Upstream = v
175230 }
176- }
231+ }},
232+ {"ZOEA_OLLAMA_ENDPOINT", func(v string) {
233+ if v != "" {
234+ updateProvider("ollama", func(p ProviderConfig) ProviderConfig { p.Endpoint = v; return p })
235+ }
236+ }},
237+ {"ZOEA_OLLAMA_MODEL", func(v string) {
238+ if v != "" {
239+ updateProvider("ollama", func(p ProviderConfig) ProviderConfig { p.Model = v; return p })
240+ }
241+ }},
242+ {"ZOEA_OLLAMA_TEMPERATURE", func(v string) {
243+ applyFloat(v, func(f float64) {
244+ updateProvider("ollama", func(p ProviderConfig) ProviderConfig { p.Temperature = f; return p })
245+ })
246+ }},
247+ {"ZOEA_OLLAMA_RATE_LIMIT", func(v string) {
248+ applyFloat(v, func(f float64) {
249+ updateProvider("ollama", func(p ProviderConfig) ProviderConfig { p.RateLimit = f; return p })
250+ })
251+ }},
252+ {"ZOEA_OLLAMA_RATE_BURST", func(v string) {
253+ applyInt(v, func(n int) {
254+ updateProvider("ollama", func(p ProviderConfig) ProviderConfig { p.RateBurst = n; return p })
255+ })
256+ }},
257+ {"ZOEA_OPENCODE_ENDPOINT", func(v string) {
258+ if v != "" {
259+ updateProvider("opencode_zen", func(p ProviderConfig) ProviderConfig { p.Endpoint = v; return p })
260+ }
261+ }},
262+ {"ZOEA_OPENCODE_MODEL", func(v string) {
263+ if v != "" {
264+ updateProvider("opencode_zen", func(p ProviderConfig) ProviderConfig { p.Model = v; return p })
265+ }
266+ }},
267+ {"ZOEA_OPENCODE_TEMPERATURE", func(v string) {
268+ applyFloat(v, func(f float64) {
269+ updateProvider("opencode_zen", func(p ProviderConfig) ProviderConfig { p.Temperature = f; return p })
270+ })
271+ }},
272+ {"ZOEA_OPENCODE_RATE_LIMIT", func(v string) {
273+ applyFloat(v, func(f float64) {
274+ updateProvider("opencode_zen", func(p ProviderConfig) ProviderConfig { p.RateLimit = f; return p })
275+ })
276+ }},
277+ {"ZOEA_OPENCODE_RATE_BURST", func(v string) {
278+ applyInt(v, func(n int) {
279+ updateProvider("opencode_zen", func(p ProviderConfig) ProviderConfig { p.RateBurst = n; return p })
280+ })
281+ }},
282+ } {
283+ setter.apply(os.Getenv(setter.env))
177284 }
178285 }
179286