driver

type ArgvExecDriver interface {
	Driver
	CommandContainerArgv(
		ctx context.Context,
		workspaceID string,
		argv []string,
		streams Streams,
	) error
}

type BuildRequest struct {
	PrebuildHash         string
	ParsedConfig         *config.SubstitutedConfig
	ExtendedBuildInfo    *feature.ExtendedBuildInfo
	DockerfilePath       string
	DockerfileContent    string
	LocalWorkspaceFolder string
	Options              provider.BuildOptions
}

type CommandParams struct {
	WorkspaceID string
	User        string
	Command     string
	Stdin       io.Reader
	Stdout      io.Writer
	Stderr      io.Writer
	// RawStdout preserves protocol bytes; text commands keep stdout redacted.
	// Protocol consumers must not log the unredacted stream.
	RawStdout bool
}

type ComposeDriver interface {
	Driver

	// ComposeHelper returns the compose helper
	ComposeHelper() (*compose.ComposeHelper, error)
}

type ContainerUserUpdater interface {
	UpdateContainerUserUID(
		ctx context.Context,
		workspaceID string,
		parsedConfig *config.DevContainerConfig,
		writer io.Writer,
	) error
}

type DockerHelperProvider interface {
	Driver

	// DockerHelper returns the docker helper
	DockerHelper() (*docker.DockerHelper, error)
}

type Driver interface {
	// FindDevContainer returns a running devcontainer details
	FindDevContainer(ctx context.Context, workspaceID string) (*config.ContainerDetails, error)

	// CommandDevContainer runs the given command inside the devcontainer
	CommandDevContainer(ctx context.Context, params *CommandParams) error

	// TargetArchitecture returns the architecture of the container runtime. e.g. amd64 or arm64
	TargetArchitecture(ctx context.Context, workspaceID string) (string, error)

	// DeleteDevContainer deletes the devcontainer
	DeleteDevContainer(ctx context.Context, workspaceID string) error

	// StartDevContainer starts the devcontainer
	StartDevContainer(ctx context.Context, workspaceID string) error

	// StopDevContainer stops the devcontainer
	StopDevContainer(ctx context.Context, workspaceID string) error

	// GetContainerLogs returns the logs of the devcontainer
	GetDevContainerLogs(
		ctx context.Context,
		workspaceID string,
		stdout io.Writer,
		stderr io.Writer,
	) error
}

type ImageBackend interface {
	ImageInspector
	ImageBuilder
	ImagePublisher
}

type ImageBuilder interface {
	BuildDevContainer(ctx context.Context, req BuildRequest) (*config.BuildInfo, error)
}

type ImageDriver interface {
	ImageRunner
	ImageBackend
	ContainerUserUpdater
}

type ImageInspector interface {
	InspectImage(ctx context.Context, imageName string) (*config.ImageDetails, error)
	GetImageTag(ctx context.Context, imageName string) (string, error)
}

type ImagePublisher interface {
	PushDevContainer(ctx context.Context, image string) error
	TagDevContainer(ctx context.Context, image, tag string) error
}

type ImageRunner interface {
	Driver
	RunImageDevContainer(ctx context.Context, params *RunImageDevContainerParams) error
}

type MountCapableDriver interface {
	Driver

	SupportsMountType(mountType string) bool
}

type MountDeliveryDriver interface {
	Driver
	RequiresMountStreaming() bool
}

type PreflightError struct {
	Provider string
	Err      error
}

type PreflightOptions struct {
	// DisableAutoStart reports whether a stopped backend should be left as-is
	// (reported) rather than started.
	DisableAutoStart bool
}

type Preflighter interface {
	Driver

	Preflight(ctx context.Context, opts PreflightOptions) error
}

type ProvisioningPreflighter interface {
	Driver

	ProvisioningPreflight(ctx context.Context) error
}

type RecreateMode string

type RecreatePolicyDriver interface {
	Driver
	RecreateMode() RecreateMode
}

type ReprovisioningDriver interface {
	RunOptionsDriver

	// CanReprovision returns true if the driver can reprovision the devcontainer
	CanReprovision() bool
}

type RunImageDevContainerParams struct {
	WorkspaceID          string
	Options              *RunOptions
	ParsedConfig         *config.DevContainerConfig
	IDE                  string
	IDEOptions           map[string]config2.OptionValue
	LocalWorkspaceFolder string
	GPUAvailability      string
}

type RunOptions struct {
	// UID is a unique identifier for this workspace
	UID string `json:"uid,omitempty"`

	// Image is the image to run
	Image string `json:"image,omitempty"`

	// User is the user to run the container as
	User string `json:"user,omitempty"`

	// Entrypoint is the entrypoint of the container
	Entrypoint string `json:"entrypoint,omitempty"`

	// Cmd are the cmd for the entrypoint
	Cmd []string `json:"cmd,omitempty"`

	// Env are additional environment variables to set
	Env map[string]string `json:"env,omitempty"`

	// CapAdd are additional capabilities for the container
	CapAdd []string `json:"capAdd,omitempty"`

	// SecurityOpt are additional security options
	SecurityOpt []string `json:"securityOpt,omitempty"`

	// Labels are labels to set on the container
	Labels []string `json:"labels,omitempty"`

	// Privileged indicates if the container should run with elevated permissions
	Privileged *bool `json:"privileged,omitempty"`

	// Init passes the --init flag when creating the container
	Init *bool `json:"init,omitempty"`

	// WorkspaceMount is the mount where the workspace should get mounted
	WorkspaceMount *config.Mount `json:"workspaceMount,omitempty"`

	// Mounts are additional mounts on the container. Supported are volume and bind mounts.
	// Bind mounts are expected to get copied from local to remote once. Volume mounts are expected
	// to be persisted for the lifetime of the container.
	Mounts []*config.Mount `json:"mounts,omitempty"`

	// Userns is the user namespace to use for the container
	Userns string `json:"userns,omitempty"`

	// UidMap are UID mappings for user namespace
	UidMap []string `json:"uidMap,omitempty"`

	// GidMap are GID mappings for user namespace
	GidMap []string `json:"gidMap,omitempty"`

	// Platform is the target platform (os/arch) to run the container under,
	// e.g. "linux/amd64". Empty means use the host's native platform.
	Platform string `json:"platform,omitempty"`

	// ImageBuilt is true if the image was built locally and is not expected to be
	// pullable from a registry. False for a devcontainer.json "image:" reference.
	ImageBuilt bool `json:"imageBuilt,omitempty"`
}

type RunOptionsDriver interface {
	Driver

	// RunDevContainer runs a devcontainer
	RunDevContainer(ctx context.Context, workspaceID string, options *RunOptions) error
}

type SnapshotCapableDriver interface {
	Driver

	// CommitContainer commits the running devcontainer's filesystem to a new
	// image, tagged as tag, to capture apt installs, global packages, and
	// other filesystem drift for workspace snapshots.
	CommitContainer(ctx context.Context, workspaceID, tag string) error
}

type Streams struct {
	Stdin  io.Reader
	Stdout io.Writer
	Stderr io.Writer
}

type WorkspaceChowner interface {
	RequiresWorkspaceChown() bool
}