container

type AttachOptions struct {
	// NoStdin attaches output only, leaving the container's stdin unconnected
	// (maps to `--no-stdin`).
	NoStdin bool
	// DetachKeys overrides the key sequence that detaches without stopping the
	// container (maps to `--detach-keys`; runtime default is ctrl-p,ctrl-q).
	DetachKeys string

	// IO streams for input/output. If nil, defaults to os.Stdin and iolib.Data/UI.
	Stdin  io.Reader
	Stdout io.Writer
	Stderr io.Writer
}

type BakeConfig struct {
	File    string
	Files   []string
	Target  string
	Targets []string
	Set     []string
	Vars    map[string]string
	Load    bool
	Push    bool
	Print   bool
}

type BuildConfig struct {
	Dockerfile string
	Context    string
	Engine     string
	Args       map[string]string
	Tags       []string
	Target     string
	NoCache    bool
	Pull       bool
	Bake       *BakeConfig
}

type CreateConfig struct {
	Name            string
	Image           string
	Command         []string // Command/args to run; appended after the image. Ignored when OverrideCommand is set.
	WorkspaceFolder string
	Mounts          []Mount
	Ports           []PortBinding
	Networks        []NetworkAttachment
	Env             map[string]string
	User            string
	Labels          map[string]string

	// Runtime configuration
	RunArgs         []string
	OverrideCommand bool           // Whether to override default command with sleep infinity
	Init            bool           // Whether to use init process
	Privileged      bool           // Run in privileged mode
	Host            bool           // Grant access to the host container runtime (Docker-out-of-Docker)
	CapAdd          []string       // Linux capabilities to add
	SecurityOpt     []string       // Security options
	Restart         *RestartPolicy // Restart policy (nil = runtime default)
	HealthCheck     *HealthCheck   // Health check (nil = inherit image healthcheck)
}

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

type EnvSetter interface {
	SetEnv(env []string)
}

type EphemeralConfig struct {
	Name              string
	Image             string
	Command           []string
	WorkspaceHostPath string
	WorkspaceFolder   string
	WorkspaceReadOnly bool
	Mounts            []Mount
	Ports             []PortBinding
	Env               []string
	User              string
	Labels            map[string]string
	RunArgs           []string
	PullPolicy        string
	CleanupPolicy     string
	TTY               bool
	Interactive       bool
	Stdin             io.Reader
	Host              bool // grant access to the host container runtime (Docker-out-of-Docker)
}

type EphemeralResult struct {
	ContainerID string
	Stdout      string
	Stderr      string
	ExitCode    int
}

type ExecOptions struct {
	User         string
	WorkingDir   string
	Env          []string
	AttachStdin  bool
	AttachStdout bool
	AttachStderr bool
	Tty          bool

	// IO streams for input/output. If nil, defaults to iolib.Data/UI.
	Stdin  io.Reader
	Stdout io.Writer
	Stderr io.Writer
}

type HealthCheck struct {
	Cmd           string // shell command for --health-cmd ("" when Disable).
	Interval      string
	Timeout       string
	Retries       int
	StartPeriod   string
	StartInterval string
	Disable       bool
}

type ImageInfo struct {
	ID             string
	RepoTags       []string
	RepoDigests    []string
	Size           int64
	Created        string
	Architecture   string
	Os             string
	Author         string
	Labels         map[string]string
	Env            []string
	Cmd            []string
	Entrypoint     []string
	ExposedPorts   []string
	StopSignal     string
	StorageDriver  string
	LayerDigests   []string
	Layers         int
	RawInspectJSON string
}

type ImageSummaryOptions struct {
	Image  string
	Digest string
}

type Info struct {
	ID         string
	Name       string
	Image      string
	Status     string // running, stopped, exited, etc.
	Health     string // healthy, unhealthy, starting, or "" when no healthcheck.
	Created    time.Time
	Ports      []PortBinding
	Networks   []string
	NetworkIPs map[string]string
	Labels     map[string]string
}

type Instance struct {
	Stack         string
	ComponentType string
	Component     string
}

type Mount struct {
	Type     string // bind, volume, tmpfs
	Source   string
	Target   string
	ReadOnly bool
}

type Named struct {

	// AlreadyRunning is true when Up found the instance already running and made
	// no change.
	AlreadyRunning bool
	// contains filtered or unexported fields
}

type NamedConfig struct {
	// Canonical identity — drives the runtime name and labels.
	Stack         string
	ComponentType string
	Component     string

	// Container spec.
	Image       string
	Command     []string
	Ports       []PortBinding
	Networks    []NetworkAttachment
	Mounts      []Mount
	Env         map[string]string
	User        string
	Labels      map[string]string // extra labels, merged over the canonical instance labels
	RunArgs     []string
	Privileged  bool           // run the container in privileged mode
	Host        bool           // grant access to the host container runtime (Docker-out-of-Docker)
	Restart     *RestartPolicy // restart policy (nil = runtime default)
	HealthCheck *HealthCheck   // health check (nil = inherit image healthcheck)

	// Runtime selection and behavior.
	RuntimeName      string   // preferred runtime: "docker" | "podman" | "" (auto-detect)
	RuntimeAutoStart bool     // auto-init/start the Podman machine when needed
	RuntimeEnv       []string // environment forwarded to EnvSetter runtimes (e.g. registry auth)
	PullPolicy       string   // missing | always | never
	DryRun           bool
}

type NetworkAttachment struct {
	Name    string
	Aliases []string
}

type NetworkEnsurer interface {
	// EnsureNetwork creates the named user-defined network, treating an
	// already-existing network as success.
	EnsureNetwork(ctx context.Context, name string) error
}

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

type PortBinding struct {
	ContainerPort int
	HostPort      int
	Protocol      string // tcp, udp
}

type PushResult struct {
	Image  string
	Digest string
	Output string
}

type RestartPolicy struct {
	Policy     string // no, always, on-failure, unless-stopped.
	MaxRetries int    // on-failure only.
}

type Runtime interface {
	// Lifecycle operations
	Build(ctx context.Context, config *BuildConfig) error
	Create(ctx context.Context, config *CreateConfig) (string, error)
	Start(ctx context.Context, containerID string) error
	Stop(ctx context.Context, containerID string, timeout time.Duration) error
	Remove(ctx context.Context, containerID string, force bool) error

	// State inspection
	Inspect(ctx context.Context, containerID string) (*Info, error)
	List(ctx context.Context, filters map[string]string) ([]Info, error)

	// Execution - IO streams configured via options structs
	Exec(ctx context.Context, containerID string, cmd []string, opts *ExecOptions) error
	// Shell opens an interactive shell in a running container (a new shell
	// process via `exec`). Used to "shell into" a container.
	Shell(ctx context.Context, containerID string, opts *ShellOptions) error
	// Attach connects local stdin/stdout/stderr to a running container's main
	// process (PID 1) via `docker/podman attach`. Unlike Shell, it does not
	// start a new process — it attaches to the existing one (Docker/Compose
	// `attach` semantics).
	Attach(ctx context.Context, containerID string, opts *AttachOptions) error

	// Image operations
	Pull(ctx context.Context, image string) error
	Tag(ctx context.Context, source, target string) error
	Push(ctx context.Context, image string) (*PushResult, error)
	ImageInspect(ctx context.Context, image string) (*ImageInfo, error)

	// Logs - methods that produce user-facing output accept io.Writer
	Logs(ctx context.Context, containerID string, follow bool, tail string, stdout, stderr io.Writer) error

	// Info
	Info(ctx context.Context) (*RuntimeInfo, error)
}

type RuntimeInfo struct {
	Type    string // docker, podman
	Version string
	Running bool
}

type RuntimeStatus int

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

type SandboxConfig struct {
	Name              string
	Workflow          string
	WorkflowPath      string
	RunID             string
	RuntimeName       string
	RuntimeAutoStart  bool
	Image             string
	WorkspaceHostPath string
	WorkspaceFolder   string
	WorkspaceReadOnly bool
	Mounts            []Mount
	Ports             []PortBinding
	Env               []string
	RuntimeEnv        []string
	User              string
	Labels            map[string]string
	RunArgs           []string
	PullPolicy        string
	CleanupPolicy     string
	DryRun            bool
}

type ShellOptions struct {
	Shell     string
	ShellArgs []string
	User      string

	// IO streams for input/output. If nil, defaults to os.Stdin and iolib.Data/UI.
	Stdin  io.Reader
	Stdout io.Writer
	Stderr io.Writer
}

type Type string