GoLoom/backend/internal/config/loader.go

package config

import (
	"fmt"
	"os"
	"regexp"
	"strings"

	"ai-agent-scaffold-go/internal/model"
	"gopkg.in/yaml.v3"
)

// agentRoot 对应 YAML 的 ai.agent.config.tables 结构
type agentRoot struct {
	AI struct {
		Agent struct {
			Config struct {
				Tables map[string]model.AiAgentConfigTable `yaml:"tables"`
			} `yaml:"config"`
		} `yaml:"agent"`
	} `yaml:"ai"`
}

// LoadAgentTables 从字节数据加载 Agent 配置表
func LoadAgentTables(data []byte) (map[string]model.AiAgentConfigTable, error) {
	expanded := expandEnvPlaceholders(string(data))
	var root agentRoot
	if err := yaml.Unmarshal([]byte(expanded), &root); err != nil {
		return nil, fmt.Errorf("parse agent config: %w", err)
	}
	tables := root.AI.Agent.Config.Tables
	if len(tables) == 0 {
		return nil, fmt.Errorf("agent config tables are required")
	}
	for name, table := range tables {
		normalizeDefaults(&table)
		if err := validateTable(name, table); err != nil {
			return nil, err
		}
		tables[name] = table
	}
	return tables, nil
}

// LoadAgentTablesFile 从文件路径加载 Agent 配置表
func LoadAgentTablesFile(path string) (map[string]model.AiAgentConfigTable, error) {
	data, err := os.ReadFile(path)
	if err != nil {
		return nil, fmt.Errorf("read agent config %s: %w", path, err)
	}
	return LoadAgentTables(data)
}

// envPlaceholderRE 匹配 ${VAR} 和 ${VAR:-default} 格式的环境变量占位符
var envPlaceholderRE = regexp.MustCompile(`\$\{([A-Za-z_][A-Za-z0-9_]*)(?::-([^}]*))?\}`)

// expandEnvPlaceholders 替换字符串中的环境变量占位符
func expandEnvPlaceholders(input string) string {
	return envPlaceholderRE.ReplaceAllStringFunc(input, func(match string) string {
		groups := envPlaceholderRE.FindStringSubmatch(match)
		name := groups[1]
		if value, ok := os.LookupEnv(name); ok && value != "" {
			return value
		}
		if len(groups) > 2 {
			return groups[2]
		}
		return ""
	})
}

// normalizeDefaults 填充配置默认值
func normalizeDefaults(table *model.AiAgentConfigTable) {
	if table.Module.AiAPI.CompletionsPath == "" {
		table.Module.AiAPI.CompletionsPath = "v1/chat/completions"
	}
	for i := range table.Module.AgentWorkflows {
		if table.Module.AgentWorkflows[i].MaxIterations == 0 {
			table.Module.AgentWorkflows[i].MaxIterations = 3
		}
	}
}

// validateTable 校验配置表的必填字段
func validateTable(name string, table model.AiAgentConfigTable) error {
	prefix := "agent table " + name
	required := map[string]string{
		"app-name":                 table.AppName,
		"agent.agent-id":           table.Agent.AgentID,
		"module.ai-api.base-url":   table.Module.AiAPI.BaseURL,
		"module.ai-api.api-key":    table.Module.AiAPI.APIKey,
		"module.chat-model.model":  table.Module.ChatModel.Model,
		"module.runner.agent-name": table.Module.Runner.AgentName,
	}
	for field, value := range required {
		if strings.TrimSpace(value) == "" {
			return fmt.Errorf("%s: %s is required", prefix, field)
		}
	}
	if len(table.Module.Agents) == 0 {
		return fmt.Errorf("%s: module.agents is required", prefix)
	}
	for i, agent := range table.Module.Agents {
		if strings.TrimSpace(agent.Name) == "" {
			return fmt.Errorf("%s: module.agents[%d].name is required", prefix, i)
		}
		if strings.TrimSpace(agent.Instruction) == "" {
			return fmt.Errorf("%s: module.agents[%d].instruction is required", prefix, i)
		}
	}
	for i, workflow := range table.Module.AgentWorkflows {
		switch workflow.Type {
		case model.WorkflowTypeLoop, model.WorkflowTypeParallel, model.WorkflowTypeSequential:
		default:
			return fmt.Errorf("%s: module.agent-workflows[%d].type is invalid: %s", prefix, i, workflow.Type)
		}
		if strings.TrimSpace(workflow.Name) == "" {
			return fmt.Errorf("%s: module.agent-workflows[%d].name is required", prefix, i)
		}
	}
	return nil
}