workspaces

type AlreadyExists string

type Client struct {
	GpuProfilesEndpoint   goa.Endpoint
	SetGpuProfileEndpoint goa.Endpoint
	CredentialsEndpoint   goa.Endpoint
	ListEndpoint          goa.Endpoint
	GetEndpoint           goa.Endpoint
	CreateEndpoint        goa.Endpoint
	DeleteEndpoint        goa.Endpoint
	StartEndpoint         goa.Endpoint
	StopEndpoint          goa.Endpoint
	ResetEndpoint         goa.Endpoint
	CloneEndpoint         goa.Endpoint
}

type ClonePayload struct {
	// Namespace
	Namespace string
	// Source workspace name
	Name string
	// Name for the cloned workspace
	NewName string
	// Override the container image on the clone
	Image *string
	// Override the container port on the clone
	Port *int
	// Override the CPU request on the clone
	CPURequest *string
	// Override the memory request on the clone
	MemoryRequest *string
	// Override the CPU limit on the clone
	CPULimit *string
	// Override the memory limit on the clone
	MemoryLimit *string
}

type Conflict string

type ContainerState struct {
	// Current state: running, waiting, terminated
	State *string
	// Reason for the state
	Reason *string
	// Details about the state
	Message *string
	// Time the container started
	StartedAt *string
}

type CreateWorkspacePayload struct {
	// Workspace name
	Name string
	// Target namespace
	Namespace string
	// Workspace type: 'container' (default, runs as a StatefulSet), 'vm' (KubeVirt
	// VirtualMachine booting a containerDisk image), or 'scratch' (plain
	// Deployment)
	Type string
	// Main container spec
	Container *WorkspaceContainer
	// Windows private root import settings
	VMOptions *VMOptions
	// Volumes to mount
	VolumeMounts []*VolumeMount
	// Custom environment variables to inject into the workspace container
	Env []*EnvVar
	// Pod tolerations for scheduling
	Tolerations []*Toleration
	// Node selector labels for scheduling
	NodeSelector map[string]string
	// Mount /dev/shm as an emptyDir with medium=Memory (required for Chrome, ML
	// frameworks)
	SharedMemory bool
	// Image pull policy for the workspace container (Always, IfNotPresent, Never).
	// Overrides the image's default. When unset, the image's
	// defaultImagePullPolicy applies; if that is also unset the field is omitted
	// so Kubernetes applies its own default (Always for :latest or untagged
	// references, IfNotPresent otherwise)
	ImagePullPolicy *string
}

type CredentialsPayload struct {
	Name      string
	Namespace string
}

type DeletePayload struct {
	// Namespace
	Namespace string
	// Workspace name
	Name string
}

type Endpoints struct {
	GpuProfiles   goa.Endpoint
	SetGpuProfile goa.Endpoint
	Credentials   goa.Endpoint
	List          goa.Endpoint
	Get           goa.Endpoint
	Create        goa.Endpoint
	Delete        goa.Endpoint
	Start         goa.Endpoint
	Stop          goa.Endpoint
	Reset         goa.Endpoint
	Clone         goa.Endpoint
}

type EnvVar struct {
	// Environment variable name
	Name string
	// Environment variable value
	Value string
}

type Forbidden string

type GetPayload struct {
	// Namespace
	Namespace string
	// Workspace name
	Name string
}

type ImageRemoteDesktop struct {
	// Protocol name: "selkies" (Linux in-guest agent) or "agent" (cross-platform
	// kw-agent)
	Protocol string
	// Guest port the agent listens on
	Port int
	// Path relative to the agent's base URL
	Path string
}

type Invalid string

type ListPayload struct {
	// Filter by namespace
	Namespace string
}

type NotFound string

type ResetPayload struct {
	// Namespace
	Namespace string
	// Workspace name
	Name string
}

type Service interface {
	// List validated operator-declared Windows VM GPU profiles; device
	// availability is determined by scheduling
	GpuProfiles(context.Context) (res []*VMGPUProfile, err error)
	// Add, change or remove a Windows GPU profile only while its VM is fully
	// stopped; preserves root/EFI/TPM/identity. Empty profile_id restores software
	// graphics.
	SetGpuProfile(context.Context, *SetGpuProfilePayload) (res *Workspace, err error)
	// Retrieve this Windows workspace's unique initial credentials; namespace
	// editors/admins only
	Credentials(context.Context, *CredentialsPayload) (res *WorkspaceInitialCredentials, err error)
	// List all workspaces
	List(context.Context, *ListPayload) (res []*Workspace, err error)
	// Get a workspace by name
	Get(context.Context, *GetPayload) (res *Workspace, err error)
	// Create a new workspace
	Create(context.Context, *CreateWorkspacePayload) (res *Workspace, err error)
	// Delete a workspace
	Delete(context.Context, *DeletePayload) (err error)
	// Start a stopped workspace
	Start(context.Context, *StartPayload) (res *Workspace, err error)
	// Stop a running workspace
	Stop(context.Context, *StopPayload) (res *Workspace, err error)
	// Reset a workspace by re-provisioning it from its image
	Reset(context.Context, *ResetPayload) (res *Workspace, err error)
	// Clone an existing workspace under a new name, copying its spec and volume
	// mounts
	Clone(context.Context, *ClonePayload) (res *Workspace, err error)
}

type SetGpuProfilePayload struct {
	Name      string
	Namespace string
	ProfileID string
}

type StartPayload struct {
	// Namespace
	Namespace string
	// Workspace name
	Name string
}

type StopPayload struct {
	// Namespace
	Namespace string
	// Workspace name
	Name string
}

type Toleration struct {
	// Toleration key
	Key string
	// Operator: Exists or Equal
	Operator string
	// Toleration value
	Value *string
	// Taint effect: NoSchedule, PreferNoSchedule, or NoExecute
	Effect *string
}

type Unavailable string

type VMGPUProfile struct {
	ID                 string
	DisplayName        string
	ResourceName       string
	Kind               string
	Count              int
	NodeSelector       map[string]string
	GuestDriverVersion string
	Experimental       bool
}

type VMOptions struct {
	// Same-namespace CDI accessKeyId/secretKey Secret
	ImportSecretName *string
	// Same-namespace registry CA ConfigMap
	ImportCertConfigMapName *string
	// Persistent root StorageClass; empty uses cluster default
	StorageClassName *string
	// Persistent Windows root capacity, at least 80Gi
	RootDiskSize *string
	// Versioned operator-approved VM GPU profile ID; omitted/empty keeps software
	// graphics
	GpuProfile *string
}

type VolumeMount struct {
	// Volume/PVC name
	Name string
	// Mount path in container
	MountPath string
	// Volume mount type for VMs: 'disk' (virtio disk) or 'cdrom' (optical disc).
	// Empty/omitted defaults to 'disk' for VM volume mounts.
	Type *string
	// Disk bus type for VMs when type is 'cdrom' (e.g. 'sata', 'ide'). Ignored for
	// 'disk' type.
	Bus *string
	// Whether the mount is read-only. Omitted defaults to writable for container
	// PVCs and VM data disks, and read-only for VM CD-ROMs.
	Readonly *bool
}

type Workspace struct {
	// Workspace name
	Name string
	// Kubernetes namespace
	Namespace string
	// Workspace type: container, vm, or scratch
	Type string
	// Container image
	Image string
	// Container port
	Port *int
	// CPU request
	CPURequest *string
	// Memory request
	MemoryRequest *string
	// CPU limit
	CPULimit *string
	// Memory limit
	MemoryLimit *string
	// Number of ready replicas
	ReadyReplicas int
	// Container state
	ContainerState *ContainerState
	// Workspace conditions
	Conditions []*WorkspaceCondition
	// Whether the workspace is stopped
	Stopped bool
	// Creation timestamp
	CreatedAt *string
	// Attached volumes
	VolumeMounts []*VolumeMount
	// Remote desktop agent configuration (Tier 1)
	RemoteDesktop *ImageRemoteDesktop
	// Resolved guest profile; windows11-amd64-v1 uses display-only native
	// provisioning
	VMProfile *string
	// Configured elevated command identity hint, not live runner readiness;
	// admission verifies policy, ownership and installed runner
	ExecutionIdentity *string
	// Windows native setup and bootstrap removal have completed
	Provisioned *bool
	// Resolved GPU contract; absent means software rendering, not guest
	// driver/capture/encode status
	VMGpuProfile *VMGPUProfile
}

type WorkspaceCondition struct {
	// Condition type
	Type *string
	// Condition status
	Status *string
	// Brief reason
	Reason *string
	// Detailed message
	Message *string
	// Last transition time
	LastTransitionTime *string
}

type WorkspaceContainer struct {
	// Container entrypoint override, passed verbatim
	Command []string
	// Container argument override, passed verbatim
	Args []string
	// Container name
	Name string
	// Container image
	Image string
	// Container port
	Port int
	// CPU request
	CPURequest string
	// Memory request
	MemoryRequest string
	// CPU limit
	CPULimit string
	// Memory limit
	MemoryLimit string
	// GPU resource request count (e.g. "1")
	GpuRequest *string
	// GPU vendor resource name (e.g. nvidia.com/gpu, amd.com/gpu)
	GpuVendor string
}

type WorkspaceInitialCredentials struct {
	Username     string
	Password     string
	CacheControl string
}