runtime

type Container struct {
	ID      string
	Name    string
	State   string // running, exited, paused, ...
	Labels  map[string]string
	Mounts  []Mount
	Project string // com.docker.compose.project, empty if not a compose service
	Service string // com.docker.compose.service, empty if not a compose service

	// Image is the container's image reference. Populated on both List and
	// Inspect.
	Image string

	// LogDriver is the effective logging driver, e.g. "json-file", "local",
	// "journald". Inspect-only (the list summary carries no HostConfig), and
	// empty when unknown.
	LogDriver string

	// Env holds the container's environment entries as KEY=VALUE strings.
	// Inspect-only. Core surfaces the raw slice: callers that only need the
	// names must split it themselves and must not log the values.
	Env []string

	// Health is the container health status when a HEALTHCHECK is defined,
	// e.g. "healthy", "unhealthy", "starting". Empty when the container has no
	// healthcheck. Inspect-only.
	Health string

	// Networks lists the container's network attachments and the IP
	// addresses it holds on each. Unlike Image/LogDriver/Env/Health, the
	// list summary carries this data at no extra cost (it is already part
	// of the same API response), so Networks is populated on both List and
	// Inspect.
	Networks []ContainerNetwork
}

type ContainerNetwork struct {
	Name string
	ID   string
	IPs  []netip.Addr
}

type DockerRuntime struct {
	// contains filtered or unexported fields
}

type Event struct {
	Type   EventType
	ID     string
	Name   string
	Labels map[string]string
}

type EventType string

type ExecHandle struct {
	Stdout io.Reader
	Wait   func() (exitCode int, err error)
}

type ExecSpec struct {
	Cmd  []string
	User string // empty means the container's default user
}

type Mount struct {
	Type        MountType
	Name        string // named-volume name, empty for binds and tmpfs
	Source      string // host-side path, empty for tmpfs
	Destination string // container-side path
	ReadOnly    bool
}

type MountType string

type Network struct {
	Name     string
	ID       string
	Driver   string
	Internal bool
	Subnets  []netip.Prefix
	Labels   map[string]string
}

type NetworkInspector interface {
	// ListNetworks returns every network the runtime knows about, with its
	// subnet CIDRs and whether it is marked internal.
	ListNetworks(ctx context.Context) ([]Network, error)
}

type PodmanRuntime struct {
	// contains filtered or unexported fields
}

type Runtime interface {
	// List returns every container the runtime knows about, running or not.
	List(ctx context.Context) ([]Container, error)

	// Inspect returns a single container by ID or name.
	Inspect(ctx context.Context, id string) (Container, error)

	// Watch streams lifecycle events until ctx is cancelled. The error channel
	// carries a terminal error and is then closed alongside the event channel.
	Watch(ctx context.Context) (<-chan Event, <-chan error)

	// Exec runs a command inside a running container and returns a handle whose
	// Stdout the caller reads (for stream backups it is piped straight into the
	// engine's stdin) before calling Wait for the exit code.
	Exec(ctx context.Context, id string, spec ExecSpec) (*ExecHandle, error)

	// Stop stops a running container, waiting up to timeoutSeconds before a kill.
	Stop(ctx context.Context, id string, timeoutSeconds int) error

	// Start starts a stopped container.
	Start(ctx context.Context, id string) error

	// Kill sends a signal to a running container, e.g. "SIGHUP" to prompt a
	// collector to reload its configuration.
	Kill(ctx context.Context, id string, signal string) error

	// Restart restarts a container, using the runtime's default stop timeout.
	Restart(ctx context.Context, id string) error

	// Close releases the underlying client.
	Close() error
}