ai-agent-scaffold-go/internal/app/config/loader.go

package config

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

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

type agentRoot struct {
	AI struct {
		Agent struct {
			Config struct {
				Tables map[string]model.AiAgentConfigTable `yaml:"tables"`
			} `yaml:"config"`
		} `yaml:"agent"`
	} `yaml:"ai"`
}

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
}

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)
}

var envPlaceholderRE = regexp.MustCompile(`\$\{([A-Za-z_][A-Za-z0-9_]*)(?::-([^}]*))?\}`)

// expandEnvPlaceholders replaces ${VAR} and ${VAR:-default} in YAML text using
// the current process environment. It deliberately ignores bare $NAME forms so
// dollar signs that happen to appear inside instructions or URLs are not
// mangled.
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 ""
	})
}

func normalizeDefaults(table *model.AiAgentConfigTable) {
	if table.Module.AiAPI.CompletionsPath == "" {
		table.Module.AiAPI.CompletionsPath = "v1/chat/completions"
	}
	if table.Module.AiAPI.EmbeddingsPath == "" {
		table.Module.AiAPI.EmbeddingsPath = "v1/embeddings"
	}
	for i := range table.Module.ChatModel.ToolSkillsList {
		if table.Module.ChatModel.ToolSkillsList[i].Type == "" {
			table.Module.ChatModel.ToolSkillsList[i].Type = "directory"
		}
	}
	for i := range table.Module.AgentWorkflows {
		if table.Module.AgentWorkflows[i].MaxIterations == 0 {
			table.Module.AgentWorkflows[i].MaxIterations = 3
		}
	}
}

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)
		}
	}
	for i, tool := range table.Module.ChatModel.ToolMCPList {
		if err := validateMCPEntry(prefix, i, tool); err != nil {
			return err
		}
	}
	return nil
}

func validateMCPEntry(prefix string, index int, tool model.ToolMCPConfig) error {
	fieldPrefix := fmt.Sprintf("%s: module.chat-model.tool-mcp-list[%d]", prefix, index)
	count := 0
	if tool.Local != nil {
		count++
	}
	if tool.SSE != nil {
		count++
	}
	if tool.Stdio != nil {
		count++
	}

	switch count {
	case 0:
		return fmt.Errorf("%s must define exactly one of local, sse, or stdio", fieldPrefix)
	case 1:
	default:
		return fmt.Errorf("%s cannot define multiple transport types", fieldPrefix)
	}

	if tool.Local != nil {
		if strings.TrimSpace(tool.Local.Name) == "" {
			return fmt.Errorf("%s.local.name is required", fieldPrefix)
		}
	}
	if tool.SSE != nil {
		if strings.TrimSpace(tool.SSE.Name) == "" {
			return fmt.Errorf("%s.sse.name is required", fieldPrefix)
		}
		if strings.TrimSpace(tool.SSE.BaseURI) == "" {
			return fmt.Errorf("%s.sse.base-uri is required", fieldPrefix)
		}
		if tool.SSE.RequestTimeout < 0 {
			return fmt.Errorf("%s.sse.request-timeout must be positive", fieldPrefix)
		}
	}
	if tool.Stdio != nil {
		if strings.TrimSpace(tool.Stdio.Name) == "" {
			return fmt.Errorf("%s.stdio.name is required", fieldPrefix)
		}
		if strings.TrimSpace(tool.Stdio.ServerParameters.Command) == "" {
			return fmt.Errorf("%s.stdio.server-parameters.command is required", fieldPrefix)
		}
		if tool.Stdio.RequestTimeout < 0 {
			return fmt.Errorf("%s.stdio.request-timeout must be positive", fieldPrefix)
		}
	}
	return nil
}