container

type CPUMetrics struct {
	UsagePercent      float64
	UsageNanoseconds  uint64
	UsageNanocores    uint64
	UserNanoseconds   uint64
	KernelNanoseconds uint64
}

type CommitSnapshotRequest struct {
	Source StorageRef
	Target SnapshotRef
}

type ContainerInfo struct {
	ID         string
	Image      string
	Labels     map[string]string
	StorageRef StorageRef
	Runtime    RuntimeInfo
	CreatedAt  time.Time
	UpdatedAt  time.Time
}

type ContainerMetrics struct {
	SampledAt time.Time
	CPU       *CPUMetrics
	Memory    *MemoryMetrics
}

type ContainerService interface {
	CreateContainer(ctx context.Context, req CreateContainerRequest) (ContainerInfo, error)
	GetContainer(ctx context.Context, id string) (ContainerInfo, error)
	ListContainers(ctx context.Context) ([]ContainerInfo, error)
	DeleteContainer(ctx context.Context, id string, opts *DeleteContainerOptions) error
	ListContainersByLabel(ctx context.Context, key, value string) ([]ContainerInfo, error)
}

type ContainerSpec struct {
	Cmd               []string
	Env               []string
	WorkDir           string
	User              string
	Mounts            []MountSpec
	DNS               []string
	NetworkJoinTarget NetworkJoinTarget
	AddedCapabilities []string
	// CDIDevices contains fully-qualified CDI device names such as
	// "nvidia.com/gpu=0" or "amd.com/gpu=0".
	CDIDevices []string
	TTY        bool
}

type CreateContainerRequest struct {
	ID              string
	ImageRef        string
	ImagePullPolicy string
	StorageRef      StorageRef
	ResourceLimits  ResourceLimits
	Labels          map[string]string
	Spec            ContainerSpec
}

type DeleteContainerOptions struct {
	CleanupSnapshot bool
}

type DeleteImageOptions struct {
	Synchronous bool
}

type DeleteTaskOptions struct {
	Force bool
}

type ImageInfo struct {
	Name string
	ID   string
	Tags []string
}

type ImageService interface {
	PullImage(ctx context.Context, ref string, opts *PullImageOptions) (ImageInfo, error)
	GetImage(ctx context.Context, ref string) (ImageInfo, error)
	ListImages(ctx context.Context) ([]ImageInfo, error)
	DeleteImage(ctx context.Context, ref string, opts *DeleteImageOptions) error
	// ResolveRemoteDigest fetches only the manifest digest from the registry
	// without downloading any layers. Returns ErrNotSupported on backends that
	// have no concept of a remote registry.
	ResolveRemoteDigest(ctx context.Context, ref string) (string, error)
}

type LayerStatus struct {
	Ref    string `json:"ref"`
	Offset int64  `json:"offset"`
	Total  int64  `json:"total"`
}

type ListSnapshotsRequest struct {
	Driver string
}

type ListTasksOptions struct {
	ContainerID string
}

type MemoryMetrics struct {
	UsageBytes   uint64
	LimitBytes   uint64
	UsagePercent float64
}

type MountInfo struct {
	Type    string
	Source  string
	Target  string
	Options []string
}

type MountSpec struct {
	Destination string
	Type        string
	Source      string
	Options     []string
}

type NetworkJoinTarget struct {
	Kind  string
	Value string
	PID   uint32
}

type NetworkRequest struct {
	ContainerID string
	JoinTarget  NetworkJoinTarget
}

type NetworkResult struct {
	IP string
}

type NetworkService interface {
	SetupNetwork(ctx context.Context, req NetworkRequest) (NetworkResult, error)
	RemoveNetwork(ctx context.Context, req NetworkRequest) error
	CheckNetwork(ctx context.Context, req NetworkRequest) error
}

type PrepareSnapshotRequest struct {
	Target StorageRef
	Parent SnapshotRef
}

type PullImageOptions struct {
	Unpack        bool
	StorageDriver string
	OnProgress    func(PullProgress) // optional, nil = no progress reporting
}

type PullProgress struct {
	Layers []LayerStatus `json:"layers"`
}

type ResourceLimits struct {
	CPUMillicores int64
	MemoryBytes   int64
	StorageBytes  int64
}

type RuntimeInfo struct {
	Name string
}

type Service interface {
	ContainerService
	WorkloadService
	NetworkService
	SnapshotService
}

type SnapshotInfo struct {
	Name    string
	Parent  string
	Kind    string
	Created time.Time
	Updated time.Time
	Labels  map[string]string
}

type SnapshotRef struct {
	Driver string
	Key    string
	Kind   string
}

type SnapshotService interface {
	CommitSnapshot(ctx context.Context, req CommitSnapshotRequest) error
	ListSnapshots(ctx context.Context, req ListSnapshotsRequest) ([]SnapshotInfo, error)
	PrepareSnapshot(ctx context.Context, req PrepareSnapshotRequest) error
	RestoreContainer(ctx context.Context, req CreateContainerRequest) (ContainerInfo, error)
}

type SnapshotUsage struct {
	SizeBytes uint64
	Inodes    uint64
}

type StartTaskOptions struct {
	Terminal bool
}

type StopTaskOptions struct {
	Signal  syscall.Signal
	Timeout time.Duration
	Force   bool
}

type StorageRef struct {
	Driver string
	Key    string
	Kind   string
}

type TaskInfo struct {
	ContainerID       string
	ID                string
	PID               uint32
	NetworkJoinTarget NetworkJoinTarget
	Status            TaskStatus
	ExitCode          uint32
}

type TaskStatus int

type WorkloadService interface {
	StartContainer(ctx context.Context, containerID string, opts *StartTaskOptions) error
	StopContainer(ctx context.Context, containerID string, opts *StopTaskOptions) error
	DeleteTask(ctx context.Context, containerID string, opts *DeleteTaskOptions) error
	GetTaskInfo(ctx context.Context, containerID string) (TaskInfo, error)
	GetContainerMetrics(ctx context.Context, containerID string) (ContainerMetrics, error)
	ListTasks(ctx context.Context, opts *ListTasksOptions) ([]TaskInfo, error)
}