dockerclient

type API interface {
	ServerVersion(ctx context.Context, opts mobyclient.ServerVersionOptions) (mobyclient.ServerVersionResult, error)
	ImageInspect(ctx context.Context, image string, opts ...mobyclient.ImageInspectOption) (mobyclient.ImageInspectResult, error)
	ImagePull(ctx context.Context, ref string, opts mobyclient.ImagePullOptions) (mobyclient.ImagePullResponse, error)

	ContainerCreate(ctx context.Context, opts mobyclient.ContainerCreateOptions) (mobyclient.ContainerCreateResult, error)
	ContainerStart(ctx context.Context, container string, opts mobyclient.ContainerStartOptions) (mobyclient.ContainerStartResult, error)
	ContainerStop(ctx context.Context, container string, opts mobyclient.ContainerStopOptions) (mobyclient.ContainerStopResult, error)
	ContainerRemove(ctx context.Context, container string, opts mobyclient.ContainerRemoveOptions) (mobyclient.ContainerRemoveResult, error)
	ContainerInspect(ctx context.Context, container string, opts mobyclient.ContainerInspectOptions) (mobyclient.ContainerInspectResult, error)
	ContainerList(ctx context.Context, opts mobyclient.ContainerListOptions) (mobyclient.ContainerListResult, error)

	VolumeCreate(ctx context.Context, opts mobyclient.VolumeCreateOptions) (mobyclient.VolumeCreateResult, error)
	VolumeList(ctx context.Context, opts mobyclient.VolumeListOptions) (mobyclient.VolumeListResult, error)
	VolumeRemove(ctx context.Context, volumeID string, opts mobyclient.VolumeRemoveOptions) (mobyclient.VolumeRemoveResult, error)

	ExecCreate(ctx context.Context, container string, opts mobyclient.ExecCreateOptions) (mobyclient.ExecCreateResult, error)
	ExecAttach(ctx context.Context, execID string, opts mobyclient.ExecAttachOptions) (mobyclient.ExecAttachResult, error)
	ExecInspect(ctx context.Context, execID string, opts mobyclient.ExecInspectOptions) (mobyclient.ExecInspectResult, error)

	Close() error
}

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

type ContainerState struct {
	Running  bool
	ExitCode int
}

type CreateOptions struct {
	Image          string
	WorkspaceHost  string      // absolute host path (daemon-side)
	WorkspaceMount string      // absolute in-container path (e.g. "/workspace")
	ExtraMounts    []Mount     // additional host -> container mounts; ReadOnly is honored per mount
	NetworkMode    NetworkMode // disabled | allow_all
	Network        string      // optional Docker network to join (e.g. to reach stellad in DooD); ignored when NetworkMode is disabled
	Env            map[string]string
	User           string            // optional container user override
	Labels         map[string]string // must include LabelSessionID + LabelStellaHome + LabelCreatedAt
	Name           string            // optional; caller builds "stella-sandbox-<session-id>"
}

type ExecHandle struct {
	// Stdin is non-nil only when opts.Stdin was nil (i.e. we opened a pipe for the caller).
	Stdin  io.WriteCloser
	Stdout io.ReadCloser
	Stderr io.ReadCloser
	// Wait blocks until the exec finishes and returns the exit code.
	Wait func() (int, error)
	// Kill terminates the underlying exec attach.
	Kill func() error
}

type ExecOptions struct {
	ContainerID string
	Command     []string // argv — not a shell string
	Cwd         string   // absolute in-container path
	Env         map[string]string
	User        string    // optional override
	Stdin       io.Reader // optional
	Tty         bool      // default false
}

type ExecResult struct {
	ExitCode int
	Stdout   []byte
	Stderr   []byte
}

type Mount struct {
	HostPath      string
	ContainerPath string
	ReadOnly      bool
	Type          MountType
	// VolumeSubpath selects a sub-path within the named volume to mount.
	// Only valid when Type is MountTypeVolume. Requires Docker Engine 25+.
	VolumeSubpath string
}

type MountType string

type NetworkMode string

type SelfContainer struct {
	ID       string
	Name     string // without the leading slash docker prepends
	Networks []SelfNetwork
	BridgeIP string
}

type SelfNetwork struct {
	Name string
	IP   string // this container's IP on the network, empty if unset
}

type VersionInfo struct {
	Server struct {
		APIVersion string
	}
	Client struct {
		Version string
	}
}