orchestrator

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

type PauseQueueExhaustedError = sandbox.PauseQueueExhaustedError

type SandboxDataFetcher func(ctx context.Context) (SandboxMetadata, *api.APIError)

type SandboxMetadata struct {
	Metadata            map[string]string
	EnvVars             map[string]string
	Build               queries.EnvBuild
	AllowInternetAccess *bool
	Network             *types.SandboxNetworkConfig
	Alias               string
	TemplateID          string
	BaseTemplateID      string
	AutoPause           bool
	// AutoPauseFilesystemOnly makes a timeout auto-pause take a filesystem-only
	// snapshot instead of a full memory one. Only meaningful when AutoPause.
	AutoPauseFilesystemOnly bool
	AutoResume              *types.SandboxAutoResumeConfig
	VolumeMounts            []*orchestrator.SandboxVolumeMount
	EnvdAccessToken         *string
	// Iam records the sandbox workload identity configuration requested at create
	// time. Nil means workload identity is disabled.
	Iam    *types.SandboxIam
	NodeID *string
	// SnapshotSandboxID is the sandbox ID the resume snapshot is stored under.
	// It differs from the ID of the sandbox being started when forking.
	SnapshotSandboxID string
	// FilesystemBoot demands a cold boot of a memory-inclusive snapshot
	// (explicit memory:false resume). Set only by the resume data fetchers;
	// template creates and auto-resume never set it.
	FilesystemBoot bool
	// FilesystemOnlySnapshot marks a resume whose snapshot persists only the
	// rootfs. Unlike FilesystemBoot it describes the stored artifact rather than
	// the request, so every path that resumes such a snapshot sets it.
	FilesystemOnlySnapshot bool
}

type SnapshotCacheInvalidator interface {
	Invalidate(ctx context.Context, sandboxID string)
}

type SnapshotTemplateOpts struct {
	// ExistingTemplateID is set when the alias resolved to an existing template owned by the team.
	ExistingTemplateID *string
	// Alias is the parsed alias name (without namespace). Set when a name was provided.
	Alias *string
	// Namespace is the team slug used for alias scoping. Set when a name was provided.
	Namespace *string
	// Tag is the build tag parsed from the name, defaults to "default".
	Tag string
}

type SnapshotTemplateResult struct {
	TemplateID string
	BuildID    uuid.UUID
}