config

type MCPConfig struct {
	// Description is a text shown to AI clients that explains what this server does
	Description string `yaml:"description,omitempty"`

	// Run contains runtime configuration
	Run MCPRunConfig `yaml:"run,omitempty"`

	// Tools is a list of tool definitions that will be provided to clients
	Tools []MCPToolConfig `yaml:"tools"`
}

type MCPRunConfig struct {
	// Shell is the shell to use for executing commands (e.g., bash, sh, zsh)
	Shell string `yaml:"shell,omitempty"`
}

type MCPToolConfig struct {
	// Name is the unique identifier for the tool
	Name string `yaml:"name"`

	// Description explains what the tool does (shown to AI clients)
	Description string `yaml:"description"`

	// Params defines the parameters that the tool accepts
	Params map[string]common.ParamConfig `yaml:"params"`

	// Constraints are expressions that limit when the tool can be executed
	Constraints []string `yaml:"constraints,omitempty"`

	// Run specifies how to execute the tool
	Run MCPToolRunConfig `yaml:"run"`

	// Output specifies how to format the tool's output
	Output common.OutputConfig `yaml:"output,omitempty"`
}

type MCPToolRequirements struct {
	// OS is the operating system that the prerequisite tool must be installed on
	OS string `yaml:"os,omitempty"`

	// Executables is a list of executable names that must be present in the system
	Executables []string `yaml:"executables"`
}

type MCPToolRunConfig struct {
	// Command is a template for the shell command to execute
	Command string `yaml:"command"`

	// Env is a list of environment variable names to pass from the parent process
	Env []string `yaml:"env,omitempty"`

	// Runners is a list of possible runner configurations
	Runners []MCPToolRunner `yaml:"runners,omitempty"`
}

type MCPToolRunner struct {
	// Name is the identifier for this runner (e.g., "osx", "linux")
	Name string `yaml:"name"`

	// Requirements are the prerequisites for this runner to be used
	Requirements MCPToolRequirements `yaml:"requirements,omitempty"`

	// Options for the runner
	Options map[string]interface{} `yaml:"options,omitempty"`
}

type Tool struct {
	// MCPTool is the MCP client-facing tool definition
	MCPTool mcp.Tool

	// Config is the original tool configuration
	Config MCPToolConfig

	// SelectedRunner is the runner that will be used to execute the tool command
	// This is set during validation when a suitable runner is found
	SelectedRunner *MCPToolRunner
}

type ToolsConfig struct {
	// Prompts is a prompt configuration that will be provided to clients
	Prompts common.PromptsConfig `yaml:"prompts,omitempty"`

	// MCP contains the configuration specific to the MCP server and tools
	MCP MCPConfig `yaml:"mcp"`
}