agent

type Agent interface {
	// Name returns the agent name (e.g., "claude", "goose").
	Name() string
	// SkipOnboarding modifies agent settings to skip onboarding prompts.
	// It takes the current agent settings map (path -> SettingsFile), the workspace
	// sources path inside the container, and an optional list of API key values
	// to pre-approve so the agent does not prompt the user about them.
	// Returns the modified settings map, or an error if modification fails.
	SkipOnboarding(settings map[string]SettingsFile, workspaceSourcesPath string, approvedKeys []string) (map[string]SettingsFile, error)
	// SetModel configures the model ID in the agent settings.
	// It takes the current agent settings map (path -> SettingsFile) and the model ID,
	// and returns the modified settings with the model configured.
	// If the agent does not support model configuration, settings are returned unchanged.
	// Returns the modified settings map, or an error if modification fails.
	SetModel(settings map[string]SettingsFile, modelID string) (map[string]SettingsFile, error)
	// SkillsDir returns the container path (using $HOME variable) under which skill
	// directories should be mounted (e.g., "$HOME/.claude/skills" for Claude Code).
	// Returns "" if the agent does not support skills mounting.
	SkillsDir() string
	// SetMCPServers configures MCP servers in the agent settings.
	// It takes the current agent settings map (path -> SettingsFile) and the MCP configuration,
	// and returns the modified settings with MCP servers configured.
	// If the agent does not support MCP configuration, settings are returned unchanged.
	// If mcp is nil, settings are returned unchanged.
	// Returns the modified settings map, or an error if modification fails.
	SetMCPServers(settings map[string]SettingsFile, mcp *workspace.McpConfiguration) (map[string]SettingsFile, error)
}

type PortProvider interface {
	DefaultPorts() []int
}

type Registry interface {
	// Register registers an agent implementation by name.
	Register(name string, agent Agent) error
	// Get retrieves an agent implementation by name.
	// Returns ErrAgentNotFound if the agent is not registered.
	Get(name string) (Agent, error)
	// List returns all registered agent names.
	List() []string
}

type SettingsFile struct {
	Content    []byte
	Executable bool
}