xonecas.io
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}