config

type A2AAgent struct {
	Name string   `yaml:"name"`           // Local alias for this remote agent
	URL  string   `yaml:"url"`            // Base URL for the remote agent's A2A endpoint
	Auth *A2AAuth `yaml:"auth,omitempty"` // Authentication configuration
}

type A2AAuth struct {
	Type       string `yaml:"type,omitempty"`        // "bearer", "api_key", or "none"
	TokenEnv   string `yaml:"token_env,omitempty"`   // Environment variable containing the token
	HeaderName string `yaml:"header_name,omitempty"` // Header name for API key auth (default: "Authorization")
}

type A2AConfig struct {
	Enabled bool       `yaml:"enabled,omitempty"` // Enable A2A exposure (default: true when block present)
	Version string     `yaml:"version,omitempty"` // Agent version (default: "1.0.0")
	Skills  []A2ASkill `yaml:"skills,omitempty"`  // Skills this agent exposes
}

type A2ASkill struct {
	ID          string   `yaml:"id"`
	Name        string   `yaml:"name"`
	Description string   `yaml:"description,omitempty"`
	Tags        []string `yaml:"tags,omitempty"`
}

type Agent struct {
	Name           string            `yaml:"name"`
	Image          string            `yaml:"image,omitempty"`
	Source         *Source           `yaml:"source,omitempty"`
	Description    string            `yaml:"description,omitempty"`
	Capabilities   []string          `yaml:"capabilities,omitempty"`
	Uses           []ToolSelector    `yaml:"uses"`                      // References mcp-servers or agents by name
	EquippedSkills []ToolSelector    `yaml:"equipped_skills,omitempty"` // Alias for Uses (merged during load)
	Env            map[string]string `yaml:"env,omitempty"`
	BuildArgs      map[string]string `yaml:"build_args,omitempty"`
	Network        string            `yaml:"network,omitempty"` // Network to join (for multi-network mode)
	Command        []string          `yaml:"command,omitempty"` // Override container entrypoint
	Runtime        string            `yaml:"runtime,omitempty"` // Headless runtime (e.g., "claude-code")
	Prompt         string            `yaml:"prompt,omitempty"`  // System prompt for headless agents
	A2A            *A2AConfig        `yaml:"a2a,omitempty"`     // A2A protocol configuration
}

type MCPServer struct {
	Name      string            `yaml:"name"`
	Image     string            `yaml:"image,omitempty"`
	Source    *Source           `yaml:"source,omitempty"`
	URL       string            `yaml:"url,omitempty"`       // External server URL (no container)
	Port      int               `yaml:"port,omitempty"`      // For HTTP transport (container-based)
	Transport string            `yaml:"transport,omitempty"` // "http" (default), "stdio", or "sse"
	Command   []string          `yaml:"command,omitempty"`   // Override container command or remote command for SSH
	Env       map[string]string `yaml:"env,omitempty"`
	BuildArgs map[string]string `yaml:"build_args,omitempty"`
	Network   string            `yaml:"network,omitempty"` // Network to join (for multi-network mode)
	SSH       *SSHConfig        `yaml:"ssh,omitempty"`     // SSH connection config for remote servers
	Tools     []string          `yaml:"tools,omitempty"`   // Tool whitelist (empty = all tools exposed)
}

type Network struct {
	Name   string `yaml:"name"`
	Driver string `yaml:"driver"`
}

type Resource struct {
	Name    string            `yaml:"name"`
	Image   string            `yaml:"image"`
	Env     map[string]string `yaml:"env,omitempty"`
	Ports   []string          `yaml:"ports,omitempty"`
	Volumes []string          `yaml:"volumes,omitempty"`
	Network string            `yaml:"network,omitempty"` // Network to join (for multi-network mode)
}

type SSHConfig struct {
	Host         string `yaml:"host"`                   // Required: hostname or IP address
	User         string `yaml:"user"`                   // Required: SSH username
	Port         int    `yaml:"port,omitempty"`         // Optional: SSH port (default 22)
	IdentityFile string `yaml:"identityFile,omitempty"` // Optional: path to SSH private key
}

type Source struct {
	Type       string `yaml:"type"` // "git" or "local"
	URL        string `yaml:"url,omitempty"`
	Ref        string `yaml:"ref,omitempty"`
	Path       string `yaml:"path,omitempty"`
	Dockerfile string `yaml:"dockerfile,omitempty"`
}

type ToolSelector struct {
	Server string   `yaml:"server" json:"server"`                   // MCP server or A2A agent name
	Tools  []string `yaml:"tools,omitempty" json:"tools,omitempty"` // Tool whitelist (empty = all tools from this server)
}

type Topology struct {
	Version    string      `yaml:"version"`
	Name       string      `yaml:"name"`
	Network    Network     `yaml:"network"`            // Single network (simple mode)
	Networks   []Network   `yaml:"networks,omitempty"` // Multiple networks (advanced mode)
	MCPServers []MCPServer `yaml:"mcp-servers"`
	Agents     []Agent     `yaml:"agents,omitempty"` // Active agents that consume MCP tools
	Resources  []Resource  `yaml:"resources,omitempty"`
	A2AAgents  []A2AAgent  `yaml:"a2a-agents,omitempty"` // External A2A agents for agent-to-agent communication
}

type ValidationError struct {
	Field   string
	Message string
}

type ValidationErrors []ValidationError