deploy

type BaseConfig struct {
	Schema      string                      `json:"schema"`
	Environment []ConfigEnvironmentVariable `json:"environment"`
	User        string                      `json:"user"`
	WorkingDir  string                      `json:"working_dir"`
	Entrypoint  []string                    `json:"entrypoint"`
	Command     []string                    `json:"command"`
	Healthcheck string                      `json:"healthcheck"`
	StopSignal  string                      `json:"stop_signal"`
	OnBuild     []string                    `json:"on_build"`
	Volumes     []string                    `json:"volumes"`
}

type BaseImageOverrideV1 struct {
	Image string `yaml:"image"`
}

type BuildLockV1 struct {
	Schema                string                       `json:"schema"`
	BlueprintDigest       canonical.Digest             `json:"blueprint_digest"`
	Overlay               RequestOverlayV1             `json:"overlay"`
	PackageOverrides      PackageOverrideIntentV1      `json:"package_overrides"`
	ResolvedRequestDigest canonical.Digest             `json:"resolved_request_digest"`
	Platform              blueprint.Platform           `json:"platform"`
	Base                  ImageDescriptor              `json:"base"`
	Graph                 ProviderGraphLockV1          `json:"graph"`
	Nodes                 []NodeLockV1                 `json:"nodes"`
	Catalog               []providers.RealizedOutput   `json:"catalog"`
	RuntimePolicy         RuntimePolicyV1              `json:"runtime_policy"`
	ValidationRecord      providerstore.StoreObjectRef `json:"validation_record"`
	FinalImage            providers.RealizedImageV1    `json:"final_image"`
}

type CleanupItemV1 struct {
	Kind     string `json:"kind"`
	Identity string `json:"identity"`
}

type ConfigEnvironmentVariable struct {
	Name  string `json:"name"`
	Value string `json:"value"`
}

type ControlLeaseV1 = QueueEntryLeaseV1

type ControlMarkerV1 struct {
	ID                  string
	Operation           ControlOperationV1
	GenerationReference string
	BootSession         string
	Status              LiveRunStatusV1
}

type ControlOperationV1 string

type DeploymentStateV1 struct {
	Schema       string              `json:"schema"`
	Installation InstallationStateV1 `json:"installation"`
}

type DesiredPlatformSelector func(blueprint.Document) (blueprint.Platform, error)

type DesiredStateUpdateResult struct {
	State   StateV1
	Changed bool
}

type DirectPackageRequest struct {
	Contribution string                            `json:"contribution"`
	Package      providers.CanonicalPackageRequest `json:"package"`
}

type EnvironmentGenerationState struct {
	Reference           string             `json:"reference"`
	ImageDigest         canonical.Digest   `json:"image_digest"`
	RootFSSubject       canonical.Digest   `json:"rootfs_subject"`
	BuildLockDigest     canonical.Digest   `json:"build_lock_digest"`
	Platform            blueprint.Platform `json:"platform"`
	RuntimePolicyDigest canonical.Digest   `json:"runtime_policy_digest"`
}

type ImageDescriptor struct {
	Schema             string             `json:"schema"`
	Platform           blueprint.Platform `json:"platform"`
	AuthorReference    string             `json:"author_reference"`
	ImmutableReference string             `json:"immutable_reference"`
	ManifestDigest     canonical.Digest   `json:"manifest_digest"`
	ConfigDigest       canonical.Digest   `json:"config_digest"`
	RootFSDiffIDs      []canonical.Digest `json:"rootfs_diff_ids"`
}

type InstallationPortBindingV1 struct {
	Name          string `json:"name"`
	HostBind      string `json:"host_bind"`
	HostPort      string `json:"host_port"`
	ContainerPort string `json:"container_port"`
}

type InstallationStateV1 struct {
	Schema         string                      `json:"schema"`
	Status         string                      `json:"status"`
	TargetDir      string                      `json:"target_dir"`
	Scope          string                      `json:"scope"`
	Service        string                      `json:"service"`
	UnitPath       string                      `json:"unit_path"`
	InstanceID     string                      `json:"instance_id"`
	ComposeProject string                      `json:"compose_project"`
	ContainerName  string                      `json:"container_name"`
	NetworkName    string                      `json:"network_name"`
	Ports          []InstallationPortBindingV1 `json:"ports"`
}

type LegacyComponentsStagingRecoveryV1 struct {
	State               StateV1
	PreviousCurrent     *EnvironmentGenerationState
	PreviousEnvironment string
	// contains filtered or unexported fields
}

type LiveRunContainerCleanupV1 struct {
	Container string                  `json:"container"`
	RunID     string                  `json:"run_id"`
	Kind      LiveRunKindV1           `json:"kind"`
	Name      string                  `json:"name"`
	Reason    LiveRunRecoveryReasonV1 `json:"reason"`
}

type LiveRunKindV1 string

type LiveRunQueueV1 struct {
	Schema  string                      `json:"schema"`
	Runs    []LiveRunV1                 `json:"runs"`
	Cleanup []LiveRunContainerCleanupV1 `json:"cleanup,omitempty"`
}

type LiveRunRecoveryReasonV1 string

type LiveRunRecoveryV1 struct {
	Removed []RecoveredLiveRunV1
}

type LiveRunStatusV1 string

type LiveRunV1 struct {
	ID                  string          `json:"id"`
	Kind                LiveRunKindV1   `json:"kind"`
	Name                string          `json:"name"`
	GenerationReference string          `json:"generation_reference"`
	BootSession         string          `json:"boot_session,omitempty"`
	Status              LiveRunStatusV1 `json:"status"`
	Exclusive           bool            `json:"exclusive"`
	WritableMount       string          `json:"writable_mount,omitempty"`
	WritablePaths       []string        `json:"writable_paths,omitempty"`
	Container           string          `json:"container,omitempty"`
}

type LoadedBlueprint struct {
	Document         blueprint.Document
	Ref              PackRef
	RequestedRef     PackRef
	ResolvedArtifact *ResolvedPackArtifact
	ManifestPath     string
	BlueprintSource  string
}

type NodeLockV1 struct {
	NodeID               providers.NodeID                        `json:"node_id"`
	Provider             blueprint.ComponentType                 `json:"provider"`
	PlanDigest           canonical.Digest                        `json:"plan_digest"`
	ResolverCacheKey     canonical.Digest                        `json:"resolver_cache_key"`
	RequirementProfile   providers.RequirementProfile            `json:"requirement_profile"`
	ValidationEvidence   providers.ValidationEvidence            `json:"validation_evidence"`
	BundleManifest       providerstore.StoreObjectRef            `json:"bundle_manifest"`
	TransactionDigest    canonical.Digest                        `json:"transaction_digest"`
	Upstream             providers.RealizedImageV1               `json:"upstream"`
	Result               providers.RealizedImageV1               `json:"result"`
	GeneratedExecutables []providers.RealizedGeneratedExecutable `json:"generated_executables"`
	Outputs              []providers.RealizedOutput              `json:"outputs"`
}

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

type PackRef struct {
	Raw      string     `json:"raw"`
	Scheme   string     `json:"scheme"`
	Source   string     `json:"source"`
	Subdir   string     `json:"subdir,omitempty"`
	Query    url.Values `json:"query,omitempty"`
	IsPinned bool       `json:"is_pinned"`
}

type PackageAdditionIntentV1 struct {
	Provider    string `json:"provider"`
	Requirement string `json:"requirement"`
}

type PackageOverrideChoiceV1 struct {
	Path    string `yaml:"path,omitempty"`
	Version string `yaml:"version,omitempty"`
}

type PackageOverrideIntentChoiceV1 struct {
	Provider string `json:"provider"`
	Package  string `json:"package"`
	Kind     string `json:"kind"`
	Version  string `json:"version"`
}

type PackageOverrideIntentV1 struct {
	Schema        string                          `json:"schema"`
	EnvironmentID string                          `json:"environment_id"`
	Additions     []PackageAdditionIntentV1       `json:"additions,omitempty"`
	Choices       []PackageOverrideIntentChoiceV1 `json:"choices"`
}

type PackageOverridesEnvironmentV1 struct {
	ID               string                                        `yaml:"id"`
	Vars             map[string]any                                `yaml:"vars,omitempty"`
	Base             *BaseImageOverrideV1                          `yaml:"base,omitempty"`
	PackageAdditions map[string][]string                           `yaml:"package_additions,omitempty"`
	PackageOverrides map[string]map[string]PackageOverrideChoiceV1 `yaml:"package_overrides"`
}

type PackageOverridesV1 struct {
	Environment PackageOverridesEnvironmentV1 `yaml:"environment"`
}

type PackageRequestParser func(blueprint.ComponentType, string) (providers.CanonicalPackageRequest, error)

type PackageRequestValidator func(blueprint.ComponentType, providers.CanonicalPackageRequest) error

type PendingBuildLockLoader func(canonical.Digest) (BuildLockV1, error)

type PendingBuildV1 struct {
	Schema    string                      `json:"schema"`
	Phase     string                      `json:"phase"`
	Old       *EnvironmentGenerationState `json:"old"`
	Candidate PendingCandidateV1          `json:"candidate"`
	Cleanup   []CleanupItemV1             `json:"cleanup"`
}

type PendingCandidateV1 struct {
	TemporaryReference  string                         `json:"temporary_reference"`
	GenerationReference string                         `json:"generation_reference"`
	Image               providers.RealizedImageV1      `json:"image"`
	BuildLockDigest     canonical.Digest               `json:"build_lock_digest"`
	StoreObjects        []providerstore.StoreObjectRef `json:"store_objects"`
}

type PendingRecoveryDecision string

type PrefixValidationV1 struct {
	Schema         string                         `json:"schema"`
	SubjectRootFS  canonical.Digest               `json:"subject_rootfs"`
	Profiles       []providers.ValidationEvidence `json:"profiles"`
	RuntimePolicy  canonical.Digest               `json:"runtime_policy"`
	ExposedOutputs []providers.ExecutableEvidence `json:"exposed_outputs"`
}

type ProtectedPathV1 struct {
	Path  string `json:"path"`
	Kind  string `json:"kind"`
	Owner string `json:"owner"`
}

type ProviderGraphLockV1 struct {
	Nodes []providers.NodeID         `json:"nodes"`
	Edges []providers.ProviderEdgeV1 `json:"edges"`
}

type QualifiedOption struct {
	Application string `json:"application"`
	Option      string `json:"option"`
}

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

type RecoveredLiveRunV1 struct {
	Run    LiveRunV1
	Reason LiveRunRecoveryReasonV1
}

type RequestOverlayMutation func(blueprint.Document, RequestOverlayV1) (RequestOverlayV1, error)

type RequestOverlayMutationResult struct {
	Overlay RequestOverlayV1
	Digest  canonical.Digest
	Changed bool
}

type RequestOverlayV1 struct {
	Schema          string                 `json:"schema"`
	SelectedOptions []QualifiedOption      `json:"selected_options"`
	DirectPackages  []DirectPackageRequest `json:"direct_packages"`
}

type ResolvedPackArtifact struct {
	Scheme        string `json:"scheme"`
	Package       string `json:"package,omitempty"`
	Version       string `json:"version,omitempty"`
	Filename      string `json:"filename,omitempty"`
	SHA256        string `json:"sha256,omitempty"`
	Subdir        string `json:"subdir,omitempty"`
	CachePath     string `json:"cache_path,omitempty"`
	BlueprintPath string `json:"blueprint_path,omitempty"`
}

type ResolvedPackageOverrideChoiceV1 struct {
	Path    string
	Version string
}

type ResolvedPackageOverridesV1 struct {
	EnvironmentID string
	Additions     map[string][]string
	Providers     map[string]map[string]ResolvedPackageOverrideChoiceV1
}

type RuntimeMountV1 struct {
	Destination string `json:"destination"`
	SourceKind  string `json:"source_kind"`
	ReadOnly    bool   `json:"read_only"`
}

type RuntimePlanV1 struct {
	ID          string                      `json:"id"`
	Mounts      []RuntimeMountV1            `json:"mounts"`
	Executables []providers.QualifiedOutput `json:"executables"`
}

type RuntimePolicyV1 struct {
	Schema         string            `json:"schema"`
	ProtectedPaths []ProtectedPathV1 `json:"protected_paths"`
	Plans          []RuntimePlanV1   `json:"plans"`
}

type StagingStateV1 struct {
	Schema string `json:"schema"`
}

type StateV1 struct {
	Schema          string                       `json:"schema"`
	Blueprint       blueprint.ResolvedDocumentV1 `json:"blueprint"`
	BlueprintSource string                       `json:"blueprint_source"`
	Platform        blueprint.Platform           `json:"platform"`
	Overlay         RequestOverlayV1             `json:"overlay"`
	Current         *EnvironmentGenerationState  `json:"current"`
	Staging         *StagingStateV1              `json:"staging"`
	Deployment      *DeploymentStateV1           `json:"deployment"`
}

type UpdateStatus string

type ValidatedBuildReferenceV1 struct {
	Image          providers.RealizedImageV1 `json:"image"`
	ImageReference string                    `json:"image_reference"`
}

type ValidatedBuildV1 struct {
	Schema                 string                      `json:"schema"`
	BlueprintDigest        canonical.Digest            `json:"blueprint_digest"`
	OverlayDigest          canonical.Digest            `json:"overlay_digest"`
	PackageOverridesDigest canonical.Digest            `json:"package_overrides_digest"`
	Platform               blueprint.Platform          `json:"platform"`
	BuildLockDigest        canonical.Digest            `json:"build_lock_digest"`
	Image                  providers.RealizedImageV1   `json:"image"`
	ImageReference         string                      `json:"image_reference"`
	PendingCleanup         []ValidatedBuildReferenceV1 `json:"pending_cleanup,omitempty"`
	// PendingStorageCleanup keeps successful validation authoritative while
	// superseded locks or provider-store objects await another cleanup attempt.
	PendingStorageCleanup bool `json:"pending_storage_cleanup,omitempty"`
	// Discarded prevents reuse after image references have been removed while
	// retaining a durable storage-cleanup retry record.
	Discarded bool `json:"discarded,omitempty"`
}