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 -> content) and the workspace
	// sources path inside the container, and returns the modified settings with
	// onboarding flags set appropriately.
	// Returns the modified settings map, or an error if modification fails.
	SkipOnboarding(settings map[string][]byte, workspaceSourcesPath string) (map[string][]byte, error)
	// SetModel configures the model ID in the agent settings.
	// It takes the current agent settings map (path -> content) 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][]byte, modelID string) (map[string][]byte, 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 -> content) 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][]byte, mcp *workspace.McpConfiguration) (map[string][]byte, error)
}

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
}