agent

type Agent interface {
	// Name returns the unique identifier for the agent (e.g., "claude", "opencode").
	// Used for command-line invocation and configuration lookup.
	Name() string

	// DisplayName returns the human-readable name (e.g., "Claude Code", "OpenCode").
	// Used in help text and status messages.
	DisplayName() string

	// Command returns the command tokens to run the agent.
	// For most agents this is a single element (e.g., ["claude"]),
	// but some agents may require multiple tokens (e.g., ["gh", "copilot"]).
	Command() []string

	// APIKeyEnvVar returns the environment variable name for the API key.
	// Returns empty string if the agent uses a different authentication method.
	APIKeyEnvVar() string

	// CredentialsDir returns the path inside the container where credentials are stored.
	// This is used to mount the host credentials directory.
	CredentialsDir() string

	// InstallScript returns the command to install the agent in the container.
	// Returns empty string if the agent is pre-installed in the base image.
	InstallScript() string

	// Flags returns agent-specific flags to append to the command.
	// Returns nil if no additional flags are needed.
	Flags() []string

	// PathEntries returns directories to prepend to PATH in the container image.
	// Returns nil if the agent's binary is already on the default PATH.
	PathEntries() []string

	// YOLOFlag returns the agent's permission-skipping flag (e.g., "--dangerously-skip-permissions").
	// Returns empty string if the agent does not support YOLO mode.
	YOLOFlag() string
}