resources

type AllocationBreakdown struct {
	InstanceID         string `json:"instance_id"`
	InstanceName       string `json:"instance_name"`
	CPU                int    `json:"cpu"`
	MemoryBytes        int64  `json:"memory_bytes"`
	DiskBytes          int64  `json:"disk_bytes"`
	NetworkDownloadBps int64  `json:"network_download_bps"` // External→VM
	NetworkUploadBps   int64  `json:"network_upload_bps"`   // VM→External
	DiskIOBps          int64  `json:"disk_io_bps"`          // Disk I/O bandwidth
}

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

type DiskBreakdown struct {
	Images   int64 `json:"images_bytes"`    // Exported rootfs disk files
	OCICache int64 `json:"oci_cache_bytes"` // OCI layer cache (shared blobs)
	Volumes  int64 `json:"volumes_bytes"`
	Overlays int64 `json:"overlays_bytes"` // Rootfs overlays + volume overlays
}

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

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

type FullResourceStatus struct {
	CPU         ResourceStatus        `json:"cpu"`
	Memory      ResourceStatus        `json:"memory"`
	Disk        ResourceStatus        `json:"disk"`
	Network     ResourceStatus        `json:"network"`
	DiskIO      ResourceStatus        `json:"disk_io"`
	DiskDetail  *DiskBreakdown        `json:"disk_breakdown,omitempty"`
	GPU         *GPUResourceStatus    `json:"gpu,omitempty"` // nil if no GPU available
	Allocations []AllocationBreakdown `json:"allocations"`
}

type GPUResourceStatus struct {
	Mode       string                      `json:"mode"`               // "vgpu" or "passthrough"
	TotalSlots int                         `json:"total_slots"`        // VFs for vGPU, physical GPUs for passthrough
	UsedSlots  int                         `json:"used_slots"`         // Slots currently in use
	Profiles   []devices.GPUProfile        `json:"profiles,omitempty"` // vGPU mode only
	Devices    []devices.PassthroughDevice `json:"devices,omitempty"`  // passthrough mode only
}

type ImageLister interface {
	// TotalImageBytes returns the total size of all images on disk.
	TotalImageBytes(ctx context.Context) (int64, error)
	// TotalOCICacheBytes returns the total size of the OCI layer cache.
	TotalOCICacheBytes(ctx context.Context) (int64, error)
}

type InstanceAllocation struct {
	ID                 string
	Name               string
	Vcpus              int
	MemoryBytes        int64  // Size + HotplugSize
	OverlayBytes       int64  // Rootfs overlay size
	VolumeOverlayBytes int64  // Sum of volume overlay sizes
	NetworkDownloadBps int64  // Download rate limit (external→VM)
	NetworkUploadBps   int64  // Upload rate limit (VM→external)
	DiskIOBps          int64  // Disk I/O rate limit (bytes/sec)
	State              string // Only count running/paused/created instances
	VolumeBytes        int64  // Sum of attached volume base sizes (for per-instance reporting)
}

type InstanceLister interface {
	// ListInstanceAllocations returns resource allocations for all instances.
	ListInstanceAllocations(ctx context.Context) ([]InstanceAllocation, error)
}

type InstanceUtilizationInfo struct {
	ID            string
	Name          string
	HypervisorPID *int   // PID of the hypervisor process
	TAPDevice     string // Name of the TAP device (e.g., "hype-01234567")

	// Allocated resources (for computing utilization ratios)
	AllocatedVcpus       int   // Number of allocated vCPUs
	AllocatedMemoryBytes int64 // Allocated memory in bytes (Size + HotplugSize)
}

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

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

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

type Resource interface {
	// Type returns the resource type identifier.
	Type() ResourceType

	// Capacity returns the raw host capacity (before oversubscription).
	Capacity() int64

	// Allocated returns current total allocation across all instances.
	Allocated(ctx context.Context) (int64, error)
}

type ResourceStatus struct {
	Type           ResourceType `json:"type"`
	Capacity       int64        `json:"capacity"`         // Raw host capacity
	EffectiveLimit int64        `json:"effective_limit"`  // Capacity * oversubscription ratio
	Allocated      int64        `json:"allocated"`        // Currently allocated
	Available      int64        `json:"available"`        // EffectiveLimit - Allocated
	OversubRatio   float64      `json:"oversub_ratio"`    // Oversubscription ratio applied
	Source         SourceType   `json:"source,omitempty"` // How capacity was determined
}

type ResourceType string

type SourceType string

type VolumeLister interface {
	// TotalVolumeBytes returns the total size of all volumes.
	TotalVolumeBytes(ctx context.Context) (int64, error)
}