images

type AlreadyExists string

type Client struct {
	ListEndpoint   goa.Endpoint
	CreateEndpoint goa.Endpoint
}

type CreateImagePayload struct {
	// Display name
	Name string
	// Container image reference
	Image string
	// Description of the image
	Description *string
	// Category for grouping (e.g. Desktop, IDE, Tool, Game)
	Category *string
	// Tags for filtering/searching images
	Tags []string
	// Default container port
	DefaultPort int
	// Default URL path for connecting
	DefaultPath *string
	// Icon identifier
	Icon *string
	// Default command-line args
	DefaultArgs []string
	// Default environment variables
	DefaultEnv []*ImageEnvVar
	// Run container in privileged mode
	Privileged bool
	// Project homepage or documentation URL
	HomepageURL *string
	// Source code repository URL
	SourceURL *string
	// Container image registry page (e.g. Docker Hub)
	ImageHomepageURL *string
	// Default user for this image
	DefaultUser *string
	// Known default password for DefaultUser. Only set when the image has a known
	// default password; leave unset when the guest uses no password
	DefaultPassword *string
	// Set to true when the image has cloud-init baked in, allowing user-data (e.g.
	// a user/password) to be seeded into the guest at first boot
	DefaultCloudInit *bool
	// Reserved user-data for the guest (cloud-init). Empty by default; later used
	// to seed first-boot configuration when cloud-init is supported. Not yet
	// consumed
	DefaultUserData *string
	// Default home directory for the default user
	DefaultHomedir *string
	// Default shell for exec/console sessions (e.g. /bin/bash)
	DefaultShell *string
	// Additional relevant URLs for this image
	Links []*ImageLink
	// Default login credentials for this image
	DefaultCredentials *ImageCredentials
	// Proxy behavior configuration
	ProxyConfig *ImageProxyConfig
	// Remote desktop agent configuration (Tier 1)
	RemoteDesktop *ImageRemoteDesktop
	// UID that the main container runs as (sets runAsUser and fsGroup)
	DefaultUID *int64
	// Automatically mount /dev/shm as emptyDir with medium=Memory (required for
	// Selkies streaming, Chrome, ML frameworks)
	DefaultSharedMemory *bool
	// Workspace types this image supports (container, vm, scratch). Empty means
	// container-only
	WorkspaceTypes []string
}

type Endpoints struct {
	List   goa.Endpoint
	Create goa.Endpoint
}

type Image struct {
	// Kubernetes resource name (metadata.name)
	CrName string
	// Display name
	Name string
	// Full image reference
	Image string
	// Description of the image
	Description *string
	// Category for grouping (e.g. Desktop, IDE, Tool, Game)
	Category *string
	// Tags for filtering/searching images
	Tags []string
	// Default container port
	DefaultPort int
	// Default URL path for connecting (e.g. /vnc.html?resize=remote)
	DefaultPath *string
	// Proxy behavior configuration for this image
	ProxyConfig *ImageProxyConfig
	// Icon identifier
	Icon *string
	// Default command-line args injected at workspace creation
	DefaultArgs []string
	// Default environment variables injected at workspace creation
	DefaultEnv []*ImageEnvVar
	// UID that the main container runs as (sets runAsUser and fsGroup)
	DefaultUID *int64
	// Automatically mount /dev/shm as emptyDir with medium=Memory (required for
	// Selkies streaming, Chrome, ML frameworks)
	DefaultSharedMemory *bool
	// Run container in privileged mode
	Privileged *bool
	// Project homepage or documentation URL
	HomepageURL *string
	// Source code repository URL
	SourceURL *string
	// Container image registry page (e.g. Docker Hub)
	ImageHomepageURL *string
	// Default user for this image
	DefaultUser *string
	// Known default password for DefaultUser. Only set when the image has a known
	// default password; leave unset when the guest uses no password
	DefaultPassword *string
	// Set to true when the image has cloud-init baked in, allowing user-data (e.g.
	// a user/password) to be seeded into the guest at first boot
	DefaultCloudInit *bool
	// Reserved user-data for the guest (cloud-init). Empty by default; later used
	// to seed first-boot configuration when cloud-init is supported. Not yet
	// consumed
	DefaultUserData *string
	// Default home directory for the default user
	DefaultHomedir *string
	// Default shell for exec/console sessions (e.g. /bin/bash)
	DefaultShell *string
	// Additional relevant URLs for this image
	Links []*ImageLink
	// Default login credentials for this image
	DefaultCredentials *ImageCredentials
	// Remote desktop agent configuration (Tier 1)
	RemoteDesktop *ImageRemoteDesktop
	// Workspace types this image supports (container, vm, scratch). Empty means
	// container-only
	WorkspaceTypes []string
}

type ImageCredentials struct {
	// Default username
	Username *string
	// Default password
	Password *string
}

type ImageEnvVar struct {
	// Name of the environment variable
	Name string
	// Value (supports {{namespace}} and {{name}} placeholders)
	Value string
}

type ImageLink struct {
	// Display label for the link
	Title string
	// Link target URL
	URL string
}

type ImageProxyConfig struct {
	// Serve a no-op ServiceWorker at /sw.js to prevent SW registration errors
	NeedsNoopSw bool
	// Paths that use WebSocket (informational, all paths support WS transparently)
	WebsocketPaths []string
	// Rewrite requests with absolute paths that escape the proxy prefix using
	// Referer header
	RewriteHostAbsolutePaths bool
	// Additional headers to inject into proxied requests
	CustomRequestHeaders map[string]string
	// Inject a <base> tag into HTML responses to fix relative path resolution
	InjectBaseTag bool
	// Connect to backend over HTTPS with skip-verify (for self-signed certs)
	TLSInsecure bool
	// Forward the full proxy path (including /proxy/{ns}/{name}) to the pod
	// instead of stripping it. Required for apps configured with a base URL
	// matching the proxy prefix.
	PreservePathPrefix bool
}

type ImageRemoteDesktop struct {
	// Protocol name (e.g. "selkies")
	Protocol string
	// Guest port the agent listens on
	Port int
	// Path relative to the agent's base URL
	Path string
}

type Invalid string

type Service interface {
	// List available workspace images
	List(context.Context) (res []*Image, err error)
	// Create a new image
	Create(context.Context, *CreateImagePayload) (res *Image, err error)
}