provider

type ColimaProvider struct{}

type ContainerRuntime interface {
	// Name returns the runtime CLI name (e.g. "podman", "docker", "nerdctl").
	Name() string

	// RunInteractive executes a container with stdin/stdout/stderr attached.
	// This replaces direct exec.Command calls in cmd/shell.go so that each
	// backend can prepend the correct wrapper (e.g. "limactl shell <vm> nerdctl").
	RunInteractive(args ...string) error

	// Exec runs a container command and returns combined output.
	Exec(args ...string) (string, error)

	// CommandContext returns an *exec.Cmd to run a container command with context.
	CommandContext(ctx context.Context, args ...string) *exec.Cmd

	// SupportsCheckpoint reports whether CRIU checkpoint/restore is available.
	SupportsCheckpoint() bool
}

type DetectedProvider struct {
	Name    string // "podman", "lima", "colima", "docker", "orbstack"
	Binary  string // path to the binary
	Version string // detected version string
}

type DockerProvider struct{}

type DockerRuntime struct{}

type LimaProvider struct{}

type MachineInfo struct {
	Name  string
	State string
}

type MultipleProvidersError struct {
	Available []DetectedProvider
}

type NerdctlRuntime struct {
	// ShellCmd is the command prefix to enter the VM shell.
	// For Lima: []string{"limactl", "shell", "<vmname>"}
	// For Colima: []string{"colima", "ssh", "--profile", "<profile>", "--"}
	ShellCmd []string
}

type PodmanProvider struct{}

type PodmanRuntime struct{}

type Provider struct {
	VM      VMProvider
	Runtime ContainerRuntime
}

type VMProvider interface {
	// Name returns the human-readable provider name (e.g. "podman", "lima").
	Name() string

	// Init provisions a new VM with the given name.
	Init(name string) error

	// Start starts a named VM.
	Start(name string) error

	// StopAll stops all running VMs managed by this provider.
	StopAll() error

	// Remove force-removes a VM by name.
	Remove(name string) error

	// Sleep suspends the VM to save memory/battery.
	Sleep(name string) error

	// Resize modifies the VM's hardware limits (cpus, memory).
	Resize(name string, cpus int, memoryMB int) error

	// SetDefault sets the active connection context to the named VM.
	SetDefault(name string) error

	// SSH executes a shell command inside the named VM and returns stdout.
	SSH(machineName, command string) (string, error)

	// IsRunning checks if the named VM is in the "running" state.
	IsRunning(name string) bool

	// Inspect returns structured info about a machine.
	Inspect(name string) (*MachineInfo, error)
}