types

type AccessSurface struct {
	ID            string   `json:"id" doc:"Stable surface identifier" example:"settings.category.webhooks"`
	Kind          string   `json:"kind" enum:"route,settings-category,landing" doc:"Surface type"`
	URL           string   `json:"url,omitempty" doc:"Route URL or prefix represented by this surface" example:"/system/webhooks"`
	Label         string   `json:"label" doc:"Human-readable surface label" example:"Webhooks"`
	AccessMode    string   `json:"accessMode" enum:"permissions,any-child" doc:"How reachability is evaluated"`
	MatchMode     string   `json:"matchMode" enum:"any-of,all-of" doc:"How permissions are combined when accessMode is permissions"`
	ScopeMode     string   `json:"scopeMode" enum:"global-only,env-plus-global,any-effective-scope" doc:"Which effective permission scope is considered"`
	Permissions   []string `json:"permissions,omitempty" doc:"Permissions used by permission-based surfaces"`
	Children      []string `json:"children,omitempty" doc:"Child surface IDs used by aggregate landing surfaces"`
	FallbackOrder int      `json:"fallbackOrder,omitempty" doc:"Positive ordering hint for route fallback selection"`
}

type Activity struct {
	StartedAt    time.Time          `json:"startedAt"`
	CreatedAt    time.Time          `json:"createdAt"`
	BatchID      *string            `json:"batchId,omitempty"`
	ResourceType *string            `json:"resourceType,omitempty"`
	ResourceID   *string            `json:"resourceId,omitempty"`
	ResourceName *string            `json:"resourceName,omitempty"`
	Progress     *int               `json:"progress,omitempty"`
	StartedBy    *ActivityStartedBy `json:"startedBy,omitempty"`
	EndedAt      *time.Time         `json:"endedAt,omitempty"`
	DurationMs   *int64             `json:"durationMs,omitempty"`
	Error        *string            `json:"error,omitempty"`
	Metadata     map[string]any     `json:"metadata,omitempty"`
	UpdatedAt    *time.Time         `json:"updatedAt,omitempty"`
	EnvironmentTag
	ID                    string         `json:"id"`
	SourceEnvironmentID   string         `json:"sourceEnvironmentId,omitempty"`
	SourceEnvironmentName string         `json:"sourceEnvironmentName,omitempty"`
	Type                  ActivityType   `json:"type"`
	Status                ActivityStatus `json:"status"`
	Step                  string         `json:"step,omitempty"`
	LatestMessage         string         `json:"latestMessage,omitempty"`
}

type ActivityClearHistoryResult struct {
	Deleted int64 `json:"deleted"`
}

type ActivityDetail struct {
	Activity Activity          `json:"activity"`
	Messages []ActivityMessage `json:"messages"`
}

type ActivityMessage struct {
	CreatedAt  time.Time            `json:"createdAt"`
	Payload    map[string]any       `json:"payload,omitempty"`
	ID         string               `json:"id"`
	ActivityID string               `json:"activityId"`
	Level      ActivityMessageLevel `json:"level"`
	Message    string               `json:"message"`
}

type ActivityMessageLevel string

type ActivityStartedBy struct {
	UserID      string `json:"userId,omitempty"`
	Username    string `json:"username"`
	DisplayName string `json:"displayName,omitempty"`
}

type ActivityStatus string

type ActivityStreamEvent struct {
	Timestamp     time.Time        `json:"timestamp"`
	Activity      *Activity        `json:"activity,omitempty"`
	Message       *ActivityMessage `json:"message,omitempty"`
	Type          string           `json:"type"`
	EnvironmentID string           `json:"environmentId,omitempty"`
	ActivityID    string           `json:"activityId,omitempty"`
	Error         string           `json:"error,omitempty"`
	ActivityType  ActivityType     `json:"-"`
	Activities    []Activity       `json:"activities,omitempty"`
}

type ActivityType string

type Actor struct {
	Preferences UserPreferences `json:"preferences"`
	DisplayName *string         `json:"displayName,omitempty"`
	ID          string          `json:"id"`
	Username    string          `json:"username"`
}

type ActorDiagnostics struct {
	CheckedAt       time.Time       `json:"checkedAt"`
	Runs            map[string]int  `json:"runs"`
	EnvironmentID   string          `json:"environmentId"`
	EnvironmentName string          `json:"environmentName"`
	Error           string          `json:"error,omitempty"`
	Hosts           []ActorHostInfo `json:"hosts"`
	ActorTypes      []ActorTypeInfo `json:"actorTypes"`
	Ready           bool            `json:"ready"`
}

type ActorHostInfo struct {
	LastHealthCheck time.Time `json:"lastHealthCheck"`
	HostID          string    `json:"hostId"`
	Address         string    `json:"address"`
}

type ActorInstance struct {
	ActivatedAt time.Time `json:"activatedAt"`
	ActorID     string    `json:"actorId"`
	Name        string    `json:"name,omitempty"`
	HostID      string    `json:"hostId"`
}

type ActorJobFailure struct {
	FailedAt  time.Time `json:"failedAt"`
	JobID     string    `json:"jobId"`
	ActorID   string    `json:"actorId"`
	Name      string    `json:"name,omitempty"`
	Method    string    `json:"method"`
	LastError string    `json:"lastError,omitempty"`
	Attempts  int       `json:"attempts"`
}

type ActorProvider interface{ Actor() *Actor }

type ActorTypeInfo struct {
	NextAlarmAt      time.Time         `json:"nextAlarmAt,omitzero"`
	ActorType        string            `json:"actorType"`
	Instances        []ActorInstance   `json:"instances"`
	RecentFailures   []ActorJobFailure `json:"recentFailures"`
	ConcurrencyLimit int               `json:"concurrencyLimit"`
	ActiveActors     int               `json:"activeActors"`
	StoredStates     int               `json:"storedStates"`
	PendingAlarms    int               `json:"pendingAlarms"`
	PendingJobs      int               `json:"pendingJobs"`
	LeasedAlarms     int               `json:"leasedAlarms"`
	CompletedJobs    int               `json:"completedJobs"`
	DeadJobs         int               `json:"deadJobs"`
}

type AgentEnrollRequest struct {
	Hostname       string `json:"hostname" maxLength:"253" doc:"Hostname of the enrolling agent" trim:"true"`
	SwarmNodeID    string `json:"swarmNodeId,omitempty" required:"false" maxLength:"64" doc:"Swarm node ID when the agent runs on an active swarm node"`
	SwarmClusterID string `` /* 130-byte string literal not displayed */
	RequestID      string `` /* 158-byte string literal not displayed */
}

type AgentEnrollResponse struct {
	EnvironmentID string `json:"environmentId" doc:"Environment ID of the enrolled agent"`
	Token         string `json:"token" doc:"Agent token"`
}

type AgentHostInfo struct {
	Hostname      string `json:"hostname,omitempty"`
	OS            string `json:"os,omitempty"`
	KernelVersion string `json:"kernelVersion,omitempty"`
	Architecture  string `json:"architecture,omitempty"`
	DockerVersion string `json:"dockerVersion,omitempty"`
	AgentVersion  string `json:"agentVersion,omitempty"`
	PublicIP      string `json:"publicIp,omitempty"`
	MemoryBytes   int64  `json:"memoryBytes,omitempty"`
	CPUs          int32  `json:"cpus,omitempty"`
}

type AgentMTLSCertificate struct {
	CommonName    *string    `json:"commonName,omitempty"`
	ExpiresAt     *time.Time `json:"expiresAt,omitempty"`
	DaysRemaining *int       `json:"daysRemaining,omitempty"`
	Expired       bool       `json:"expired"`
	ExpiringSoon  bool       `json:"expiringSoon"`
}

type AgentTunnelStats struct {
	RoundTripMinMs       *float64   `json:"roundTripMinMs,omitempty"`
	RoundTripAvgMs       *float64   `json:"roundTripAvgMs,omitempty"`
	RoundTripMaxMs       *float64   `json:"roundTripMaxMs,omitempty"`
	LastDisconnectAt     *time.Time `json:"lastDisconnectAt,omitempty"`
	LastDisconnectReason string     `json:"lastDisconnectReason,omitempty"`
	BytesIn              int64      `json:"bytesIn"`
	BytesOut             int64      `json:"bytesOut"`
	StreamsOpened        int64      `json:"streamsOpened"`
	Sessions             int        `json:"sessions"`
}

type ApiKey struct {
	CreatedAt   time.Time               `json:"createdAt" readOnly:"true" doc:"Creation timestamp"`
	Description *string                 `json:"description,omitempty" maxLength:"1000" doc:"Description of the API key" unorm:"nfc" trim:"true"`
	UserID      *string                 `json:"userId,omitempty" readOnly:"true" doc:"ID of the user who owns the API key"`
	ExpiresAt   *time.Time              `json:"expiresAt,omitempty" doc:"Expiration date of the API key"`
	LastUsedAt  *time.Time              `json:"lastUsedAt,omitempty" readOnly:"true" doc:"Last time the API key was used"`
	UpdatedAt   *time.Time              `json:"updatedAt,omitempty" readOnly:"true" doc:"Last update timestamp"`
	ID          string                  `json:"id" readOnly:"true" doc:"Unique identifier of the API key"`
	Name        string                  `` /* 129-byte string literal not displayed */
	KeyPrefix   string                  `json:"keyPrefix" readOnly:"true" doc:"Prefix of the API key for identification"`
	Kind        string                  `` /* 143-byte string literal not displayed */
	Permissions []ApiKeyPermissionGrant `` /* 159-byte string literal not displayed */
	IsStatic    bool                    `json:"isStatic" readOnly:"true" doc:"Whether the API key is environment-managed and protected from deletion"`
	IsBootstrap bool                    `` /* 156-byte string literal not displayed */
}

type ApiKeyCreatedDto struct {
	Key string `json:"key" readOnly:"true" doc:"The full API key secret (only shown once)"`
	ApiKey
}

type ApiKeyPermissionGrant struct {
	EnvironmentID *string `json:"environmentId,omitempty" doc:"Environment ID to scope the grant to; omit for a global grant"`
	Permission    string  `json:"permission" minLength:"1" doc:"Permission string" example:"containers:list"`
}

type ApiResponse[T any] struct {
	Data               T                    `json:"data" doc:"Response data"`
	Environments       []EnvironmentData[T] `json:"environments,omitempty" doc:"Per-environment data behind a multi-environment response"`
	FailedEnvironments []EnvironmentFailure `json:"failedEnvironments,omitempty" doc:"Environments whose results are missing from a multi-environment response"`
	Success            bool                 `json:"success" doc:"Whether the request was successful"`
}

type ApnsDevice struct {
	CreatedAt      time.Time       `json:"createdAt" readOnly:"true"`
	Events         map[string]bool `json:"events" required:"false"`
	LastSeenAt     *time.Time      `json:"lastSeenAt,omitempty" readOnly:"true"`
	ID             string          `json:"id" readOnly:"true"`
	Label          string          `json:"label" required:"false" maxLength:"100" unorm:"nfc" trim:"true"`
	EnvironmentIDs []string        `json:"environmentIds" required:"false"`
}

type ApnsEnvelope struct {
	OccurredAt      time.Time     `json:"occurredAt"`
	Resource        *ApnsResource `json:"resource,omitempty"`
	Route           ApnsRoute     `json:"route"`
	EventID         string        `json:"eventId"`
	Type            string        `json:"type"`
	Severity        string        `json:"severity"`
	EnvironmentID   string        `json:"environmentId"`
	EnvironmentName string        `json:"environmentName"`
	Title           string        `json:"title"`
	Body            string        `json:"body"`
	ChannelID       string        `json:"channelId"`
	RecipientIDs    []string      `json:"recipientIds"`
	Version         int           `json:"v"`
}

type ApnsPairingToken struct {
	ExpiresAt time.Time `json:"expiresAt"`
	Token     string    `json:"token"`
	ChannelID string    `json:"channelId"`
}

type ApnsRegisterDeviceRequest struct {
	RecipientID    string          `json:"recipientId" minLength:"1" maxLength:"128"`
	Label          string          `json:"label" maxLength:"100" unorm:"nfc" trim:"true"`
	Events         map[string]bool `json:"events,omitzero"`
	EnvironmentIDs []string        `json:"environmentIds,omitzero"`
}

type ApnsResource struct {
	Kind string `json:"kind"`
	ID   string `json:"id"`
	Name string `json:"name,omitempty"`
}

type ApnsRoute struct {
	Kind          string `json:"kind"`
	Tab           string `json:"tab,omitempty"`
	EnvironmentID string `json:"environmentId,omitempty"`
	ID            string `json:"id,omitempty"`
}

type ApnsStatus struct {
	ChannelID string       `json:"channelId,omitempty"`
	RelayURL  string       `json:"relayUrl"`
	Devices   []ApnsDevice `json:"devices"`
	Enabled   bool         `json:"enabled"`
}

type AuthLogin struct {
	Username string `json:"username" minLength:"1" maxLength:"255" doc:"Username of the user" example:"admin"`
	Password string `json:"password" writeOnly:"true" minLength:"1" doc:"Password of the user"`
}

type AuthLogout struct {
	RefreshToken string `` /* 130-byte string literal not displayed */
}

type AuthRefresh struct {
	RefreshToken string `` /* 138-byte string literal not displayed */
}

type AuthenticationResponse struct {
	ExpiresAt    *time.Time           `json:"expiresAt,omitempty" doc:"Expiration time of the access token"`
	User         *User                `json:"user,omitempty" doc:"Authenticated user information"`
	MFA          *MFAChallenge        `json:"mfa,omitempty" doc:"Pending MFA challenge"`
	Status       AuthenticationStatus `json:"status" doc:"Authentication state"`
	Token        string               `json:"token,omitempty" doc:"JWT access token"`
	RefreshToken string               `json:"refreshToken,omitempty" doc:"Refresh token for obtaining new access tokens"`
	Success      bool                 `json:"success" doc:"Whether the authentication request was accepted"`
}

type AuthenticationStatus string

type AutoLoginConfig struct {
	Username string `json:"username" doc:"Username for auto-login (only returned if enabled)"`
	Enabled  bool   `json:"enabled" doc:"Whether auto-login is enabled"`
}

type AutoUpdateRecord struct {
	CreatedAt        time.Time      `json:"createdAt" sortable:"true"`
	StartTime        time.Time      `json:"startTime"`
	UpdatedAt        *time.Time     `json:"updatedAt,omitempty"`
	EndTime          *time.Time     `json:"endTime,omitempty"`
	OldImageVersions map[string]any `json:"oldImageVersions,omitempty"`
	NewImageVersions map[string]any `json:"newImageVersions,omitempty"`
	Error            *string        `json:"error,omitempty"`
	Details          map[string]any `json:"details,omitempty"`
	EnvironmentTag

	ID              string `json:"id"`
	ResourceID      string `json:"resourceId"`
	ResourceType    string `json:"resourceType"`
	ResourceName    string `json:"resourceName"`
	Status          string `json:"status"`
	UpdateAvailable bool   `json:"updateAvailable"`
	UpdateApplied   bool   `json:"updateApplied"`
}

type BackupFileEntry struct {
	Path        string `json:"path"`
	Name        string `json:"name"`
	IsDirectory bool   `json:"isDirectory"`
}

type BackupManagementType string

type BackupRepositoryObservation struct {
	Reason            string
	Available         bool
	SnapshotAvailable bool
}

type BackupRequester struct {
	UserID        string `json:"userId"`
	APIKeyID      string `json:"apiKeyId,omitempty"`
	EnvironmentID string `json:"environmentId"`
	Permission    string `json:"permission"`
}

type BackupRestoreSelection struct {
	Search    string   `json:"search,omitempty"`
	Paths     []string `json:"paths,omitempty"`
	SelectAll bool     `json:"selectAll,omitempty"`
}

type BackupRunAccepted struct {
	ActivityID string `json:"activityId"`
	Status     string `json:"status"`
}

type BackupSeriesRetention struct {
	SeriesIDs     []string
	Keep          int
	IncludeRemote bool
}

type BaseTemplate struct {
	ID          string `json:"id" readOnly:"true"`
	Name        string `json:"name" required:"false" unorm:"nfc" trim:"true" minLength:"1"`
	Description string `json:"description" required:"false" unorm:"nfc" trim:"true"`
}

type BatchImageUpdateRequest struct {
	ImageRefs   []string                      `json:"imageRefs,omitempty"`
	Credentials []ContainerRegistryCredential `json:"credentials,omitempty"`
}

type BulkVulnerabilityFilters struct {
	Search string `json:"search,omitempty"`

	Severity string `json:"severity,omitempty" example:"CRITICAL,HIGH"`

	ImageName    string `json:"imageName,omitempty" example:"nginx"`
	FixAvailable bool   `json:"fixAvailable,omitempty"`
}

type BusWatcher interface {
	Name() string
	Start(ctx context.Context) error
	RunNow(ctx context.Context) error
}

type CVSSInfo struct {
	V2Vector string  `json:"v2Vector,omitempty"`
	V3Vector string  `json:"v3Vector,omitempty"`
	V2Score  float64 `json:"v2Score,omitempty"`
	V3Score  float64 `json:"v3Score,omitempty"`
}

type Category struct {
	ID               string            `json:"id"`
	Title            string            `json:"title"`
	Description      string            `json:"description"`
	Icon             string            `json:"icon"`
	URL              string            `json:"url"`
	Keywords         []string          `json:"keywords"`
	Settings         []SettingMetadata `json:"settings"`
	MatchingSettings []SettingMetadata `json:"matchingSettings,omitempty"`
	RelevanceScore   int               `json:"relevanceScore,omitempty"`
}

type ComposeCache[T any] interface {
	Get(ctx context.Context, projectID, fingerprint string) (T, bool)
	Set(ctx context.Context, projectID, fingerprint, projectPath, projectsDirectory, composePath string, composeFiles, envFiles []string, loadedAt time.Time, value T) error
	Invalidate(projectID string)
}

type ComposeCommands struct {
	Stop   func(context.Context, ComposeTarget) error
	Up     func(context.Context, ComposeUpOptions) error
	Create func(context.Context, ComposeCreateOptions) error
}

type ComposeContentOptions struct {
	PathMapper      VolumeSourcePathMapper
	ProjectName     string
	ComposeContent  string
	OverrideContent string
	EnvContent      string
	WorkingDir      string
}

type ComposeCoordinator interface {
	Deploy(ctx context.Context, request ComposeDeployment) (*composetypes.Project, error)
	UpdateServices(ctx context.Context, request ComposeServiceUpdate) error
	PullServices(ctx context.Context, model *composetypes.Project, services []string, operations ComposeImageOperations, progress io.Writer) error
	EnsureImagesPresent(ctx context.Context, model *composetypes.Project, progress io.Writer, operations ComposeImageOperations) error
	BuildServices(ctx context.Context, projectID string, model *composetypes.Project, options ProjectBuildOptions, progress io.Writer, operations ComposeImageOperations) error
}

type ComposeCreateOptions struct {
	AuthConfigs map[string]registry.AuthConfig
	ComposeTarget
}

type ComposeDependencies struct {
	EnvFiles []string
}

type ComposeDeployment struct {
	Progress          io.Writer
	Options           *ProjectDeployOptions
	AuthConfigs       map[string]registry.AuthConfig
	PreDeploy         func(context.Context) error
	Load              func(context.Context) (*composetypes.Project, error)
	ResolveImages     func(context.Context) (ComposeImageOperations, error)
	Recover           func(context.Context)
	ProjectID         string
	ProjectPath       string
	DockerHost        string
	DefaultPullPolicy string
	WaitTimeout       time.Duration
	GitOpsManaged     bool
}

type ComposeDownOptions struct {
	ComposeTarget
	RemoveVolumes bool
}

type ComposeIdentity struct {
	ComposeProjectName  *string
	ResolvedProjectName string
	ServiceCount        int
	ExplicitProjectName bool
}

type ComposeImageOperations struct {
	Exists        func(context.Context, string) (bool, error)
	LastTagged    func(context.Context, string) (time.Time, error)
	Pull          func(context.Context, string, io.Writer) error
	Build         func(context.Context, buildtypes.BuildRequest, io.Writer, string) error
	BuildProvider string
}

type ComposePsOptions struct {
	ComposeTarget
	All bool
}

type ComposeServiceUpdate struct {
	Progress              io.Writer
	Project               *composetypes.Project
	AuthConfigs           map[string]registry.AuthConfig
	RestoreBeforeMutation func(context.Context)
	Recover               func(context.Context)
	Images                ComposeImageOperations
	DockerHost            string
	Services              []string
	// Dependents share a member's namespace or volumes and are never pulled; StoppedDependents stay stopped.
	Dependents        []string
	StoppedDependents []string
	WaitTimeout       time.Duration
}

type ComposeTarget struct {
	Project    *composetypes.Project
	DockerHost string
	Services   []string
}

type ComposeUpOptions struct {
	AuthConfigs map[string]registry.AuthConfig
	ComposeTarget
	WaitTimeout     time.Duration
	RemoveOrphans   bool
	ForceRecreate   bool
	RecreateVolumes bool
}

type ConditionalJob interface {
	ShouldSchedule(ctx context.Context) bool
}

type Container struct {
	Labels       map[string]string   `json:"labels,omitempty"`
	ExposedPorts map[string]struct{} `json:"exposedPorts,omitempty"`

	Healthcheck      *ContainerHealthcheckCreate      `json:"healthcheck,omitempty"`
	HostConfig       *ContainerHostConfigCreate       `json:"hostConfig,omitempty"`
	NetworkingConfig *ContainerNetworkingConfigCreate `json:"networkingConfig,omitempty"`
	Ports            map[string]string                `json:"ports,omitempty"`
	Name             string                           `json:"name" required:"false"`
	Image            string                           `json:"image" required:"false"`
	WorkingDir       string                           `json:"workingDir,omitempty"`
	User             string                           `json:"user,omitempty"`
	Hostname         string                           `json:"hostname,omitempty"`
	Domainname       string                           `json:"domainname,omitempty"`
	RestartPolicy    string                           `json:"restartPolicy,omitempty"`
	Command          []string                         `json:"command,omitempty"`
	Cmd              []string                         `json:"cmd,omitempty"`
	Entrypoint       []string                         `json:"entrypoint,omitempty"`
	Environment      []string                         `json:"environment,omitempty"`
	Env              []string                         `json:"env,omitempty"`
	Volumes          []string                         `json:"volumes,omitempty"`
	Networks         []string                         `json:"networks,omitempty"`
	Credentials      []ContainerRegistryCredential    `json:"credentials,omitempty" writeOnly:"true"`

	Memory          int64   `json:"memory,omitempty"`
	CPUs            float64 `json:"cpus,omitempty"`
	AttachStdout    bool    `json:"attachStdout,omitempty"`
	AttachStderr    bool    `json:"attachStderr,omitempty"`
	AttachStdin     bool    `json:"attachStdin,omitempty"`
	Tty             bool    `json:"tty,omitempty"`
	OpenStdin       bool    `json:"openStdin,omitempty"`
	StdinOnce       bool    `json:"stdinOnce,omitempty"`
	NetworkDisabled bool    `json:"networkDisabled,omitempty"`
	Privileged      bool    `json:"privileged,omitempty"`
	AutoRemove      bool    `json:"autoRemove,omitempty"`
}

type ContainerActionResult struct {
	ActivityID *string  `json:"activityId,omitempty"`
	Started    []string `json:"started,omitempty"`
	Stopped    []string `json:"stopped,omitempty"`
	Failed     []string `json:"failed,omitempty"`
	Errors     []string `json:"errors,omitempty"`
	Success    bool     `json:"success"`
}

type ContainerCommitRequest struct {
	Repository string   `json:"repository,omitempty" doc:"Target image repository"`
	Tag        string   `json:"tag,omitempty" doc:"Target image tag"`
	Comment    string   `json:"comment,omitempty" doc:"Commit comment"`
	Author     string   `json:"author,omitempty" doc:"Commit author"`
	Changes    []string `json:"changes,omitempty" doc:"Dockerfile changes to apply"`
	NoPause    bool     `json:"noPause,omitempty" doc:"Do not pause the container during commit"`
}

type ContainerCommitResult struct {
	ID string `json:"id"`
}

type ContainerComposeInfo struct {
	ProjectName string `json:"projectName"`
	ServiceName string `json:"serviceName"`
	WorkingDir  string `json:"workingDir,omitempty"`
	ConfigFiles string `json:"configFiles,omitempty"`
}

type ContainerConfig struct {
	Healthcheck *ContainerHealthcheck `json:"healthcheck,omitempty"`
	WorkingDir  string                `json:"workingDir,omitempty"`
	User        string                `json:"user,omitempty"`
	Hostname    string                `json:"hostname,omitempty"`
	Env         []string              `json:"env,omitempty"`
	Cmd         []string              `json:"cmd,omitempty"`
	Entrypoint  []string              `json:"entrypoint,omitempty"`
}

type ContainerCreated struct {
	ID      string `json:"id"`
	Name    string `json:"name"`
	Image   string `json:"image"`
	Status  string `json:"status"`
	Created string `json:"created"`
}

type ContainerDetails struct {
	Config          ContainerConfig          `json:"config"`
	State           ContainerState           `json:"state"`
	NetworkSettings ContainerNetworkSettings `json:"networkSettings"`
	Labels          map[string]string        `json:"labels,omitempty"`

	ComposeInfo      *ContainerComposeInfo `json:"composeInfo,omitempty"`
	UpdateInfo       *ImageUpdateInfo      `json:"updateInfo,omitempty"`
	Hardened         *HardenedImageInfo    `json:"hardened,omitempty"`
	ActivityID       *string               `json:"activityId,omitempty"`
	ID               string                `json:"id"`
	Name             string                `json:"name"`
	Image            string                `json:"image"`
	ImageID          string                `json:"imageId"`
	Created          string                `json:"created"`
	IconLightURL     string                `json:"iconLightUrl,omitempty"`
	IconDarkURL      string                `json:"iconDarkUrl,omitempty"`
	Ports            []ContainerPort       `json:"ports"`
	Mounts           []ContainerMount      `json:"mounts"`
	HostConfig       ContainerHostConfig   `json:"hostConfig"`
	RedeployDisabled bool                  `json:"redeployDisabled,omitempty"`

	AutoUpdateEnabled bool `json:"autoUpdateEnabled"`
}

type ContainerEdit struct {
	Name       *string `json:"name,omitempty"`
	Image      *string `json:"image,omitempty"`
	WorkingDir *string `json:"workingDir,omitempty"`
	User       *string `json:"user,omitempty"`

	Hostname    *string                     `json:"hostname,omitempty"`
	Command     *[]string                   `json:"command,omitempty"`
	Entrypoint  *[]string                   `json:"entrypoint,omitempty"`
	Environment *[]string                   `json:"environment,omitempty"`
	Labels      *map[string]string          `json:"labels,omitempty"`
	Healthcheck *ContainerHealthcheckCreate `json:"healthcheck,omitempty"`
	HostConfig  *ContainerHostConfigEdit    `json:"hostConfig,omitempty"`

	NetworkingConfig *ContainerNetworkingConfigCreate `json:"networkingConfig,omitempty"`
	Credentials      []ContainerRegistryCredential    `json:"credentials,omitempty"`
	ClearHealthcheck bool                             `json:"clearHealthcheck,omitempty"`
}

type ContainerEditConfig struct {
	Labels map[string]string `json:"labels,omitempty"`

	Healthcheck *ContainerHealthcheckCreate           `json:"healthcheck,omitempty"`
	Networks    map[string]ContainerEditConfigNetwork `json:"networks,omitempty"`
	ID          string                                `json:"id"`
	Name        string                                `json:"name"`
	Image       string                                `json:"image"`
	WorkingDir  string                                `json:"workingDir,omitempty"`
	User        string                                `json:"user,omitempty"`

	Hostname       string                        `json:"hostname,omitempty"`
	ComposeProject string                        `json:"composeProject,omitempty"`
	Command        []string                      `json:"command,omitempty"`
	Entrypoint     []string                      `json:"entrypoint,omitempty"`
	Environment    []string                      `json:"environment,omitempty"`
	HostConfig     ContainerEditConfigHostConfig `json:"hostConfig"`
	IsCompose      bool                          `json:"isCompose,omitempty"`
	EditDisabled   bool                          `json:"editDisabled,omitempty"`
	Running        bool                          `json:"running"`
}

type ContainerEditConfigHostConfig struct {
	PortBindings  map[string][]ContainerPortBindingCreate `json:"portBindings,omitempty"`
	NetworkMode   string                                  `json:"networkMode,omitempty"`
	Binds         []string                                `json:"binds,omitempty"`
	Mounts        []ContainerMountCreate                  `json:"mounts,omitempty"`
	RestartPolicy ContainerRestartPolicyCreate            `json:"restartPolicy"`
	CapAdd        []string                                `json:"capAdd,omitempty"`
	CapDrop       []string                                `json:"capDrop,omitempty"`

	Memory int64 `json:"memory,omitempty"`

	MemorySwap     int64 `json:"memorySwap,omitempty"`
	NanoCPUs       int64 `json:"nanoCpus,omitempty"`
	CPUShares      int64 `json:"cpuShares,omitempty"`
	Privileged     bool  `json:"privileged,omitempty"`
	AutoRemove     bool  `json:"autoRemove,omitempty"`
	ReadonlyRootfs bool  `json:"readonlyRootfs,omitempty"`
}

type ContainerEditConfigNetwork struct {
	IPv4Address string   `json:"ipv4Address,omitempty"`
	IPv6Address string   `json:"ipv6Address,omitempty"`
	Aliases     []string `json:"aliases,omitempty"`
}

type ContainerEndpointSettingsCreate struct {
	IPv4Address string   `json:"ipv4Address,omitempty"`
	IPv6Address string   `json:"ipv6Address,omitempty"`
	Aliases     []string `json:"aliases,omitempty"`
}

type ContainerGenerateComposeRequest struct {
	ContainerIDs []string `json:"containerIds" minItems:"1" doc:"IDs of the containers to convert"`
}

type ContainerGenerateComposeResponse struct {
	ComposeContent string `json:"composeContent"`
}

type ContainerHealth struct {
	Status        string                    `json:"status"`
	Log           []ContainerHealthLogEntry `json:"log,omitempty"`
	FailingStreak int                       `json:"failingStreak"`
}

type ContainerHealthLogEntry struct {
	Start    string `json:"start,omitempty"`
	End      string `json:"end,omitempty"`
	Output   string `json:"output,omitempty"`
	ExitCode int    `json:"exitCode"`
}

type ContainerHealthcheck struct {
	Test []string `json:"test,omitempty"`

	Interval int64 `json:"interval,omitempty"`

	Timeout int64 `json:"timeout,omitempty"`

	StartPeriod int64 `json:"startPeriod,omitempty"`

	StartInterval int64 `json:"startInterval,omitempty"`
	Retries       int   `json:"retries,omitempty"`
}

type ContainerHealthcheckCreate struct {
	Test []string `json:"test,omitempty"`

	Interval int64 `json:"interval,omitempty"`

	Timeout int64 `json:"timeout,omitempty"`

	StartPeriod int64 `json:"startPeriod,omitempty"`

	StartInterval int64 `json:"startInterval,omitempty"`
	Retries       int   `json:"retries,omitempty"`
}

type ContainerHostConfig struct {
	NetworkMode   string `json:"networkMode,omitempty"`
	RestartPolicy string `json:"restartPolicy,omitempty"`
	Privileged    bool   `json:"privileged,omitempty"`
	AutoRemove    bool   `json:"autoRemove,omitempty"`
	NanoCPUs      int64  `json:"nanoCpus,omitempty"`

	Memory int64 `json:"memory,omitempty"`
}

type ContainerHostConfigCreate struct {
	PortBindings    map[string][]ContainerPortBindingCreate `json:"portBindings,omitempty"`
	RestartPolicy   *ContainerRestartPolicyCreate           `json:"restartPolicy,omitempty"`
	Privileged      *bool                                   `json:"privileged,omitempty"`
	AutoRemove      *bool                                   `json:"autoRemove,omitempty"`
	ReadonlyRootfs  *bool                                   `json:"readonlyRootfs,omitempty"`
	PublishAllPorts *bool                                   `json:"publishAllPorts,omitempty"`
	NetworkMode     string                                  `json:"networkMode,omitempty"`
	Binds           []string                                `json:"binds,omitempty"`
	CapAdd          []string                                `json:"capAdd,omitempty"`
	CapDrop         []string                                `json:"capDrop,omitempty"`
	Mounts          []ContainerMountCreate                  `json:"mounts,omitempty"`

	Memory int64 `json:"memory,omitempty"`

	MemorySwap int64 `json:"memorySwap,omitempty"`
	NanoCPUs   int64 `json:"nanoCpus,omitempty"`
	CPUShares  int64 `json:"cpuShares,omitempty"`
}

type ContainerHostConfigEdit struct {
	Binds          *[]string                                `json:"binds,omitempty"`
	Mounts         *[]ContainerMountCreate                  `json:"mounts,omitempty"`
	PortBindings   *map[string][]ContainerPortBindingCreate `json:"portBindings,omitempty"`
	RestartPolicy  *ContainerRestartPolicyCreate            `json:"restartPolicy,omitempty"`
	Privileged     *bool                                    `json:"privileged,omitempty"`
	CapAdd         *[]string                                `json:"capAdd,omitempty"`
	CapDrop        *[]string                                `json:"capDrop,omitempty"`
	AutoRemove     *bool                                    `json:"autoRemove,omitempty"`
	ReadonlyRootfs *bool                                    `json:"readonlyRootfs,omitempty"`

	Memory *int64 `json:"memory,omitempty"`

	MemorySwap *int64 `json:"memorySwap,omitempty"`
	NanoCPUs   *int64 `json:"nanoCpus,omitempty"`
	CPUShares  *int64 `json:"cpuShares,omitempty"`
}

type ContainerMount struct {
	Type        string `json:"type"`
	Name        string `json:"name,omitempty"`
	Source      string `json:"source,omitempty"`
	Destination string `json:"destination"`
	Driver      string `json:"driver,omitempty"`
	Mode        string `json:"mode,omitempty"`
	Propagation string `json:"propagation,omitempty"`
	RW          bool   `json:"rw,omitempty"`
}

type ContainerMountCreate struct {
	Type     string `json:"type"`
	Source   string `json:"source"`
	Target   string `json:"target"`
	ReadOnly bool   `json:"readOnly,omitempty"`
}

type ContainerNetworkEndpoint struct {
	IPAMConfig          any               `json:"ipamConfig,omitempty"`
	DriverOpts          map[string]string `json:"driverOpts,omitempty"`
	MacAddress          string            `json:"macAddress,omitempty"`
	NetworkID           string            `json:"networkId,omitempty"`
	EndpointID          string            `json:"endpointId,omitempty"`
	Gateway             string            `json:"gateway,omitempty"`
	IPAddress           string            `json:"ipAddress,omitempty"`
	IPv6Gateway         string            `json:"ipv6Gateway,omitempty"`
	GlobalIPv6Address   string            `json:"globalIPv6Address,omitempty"`
	Links               []string          `json:"links,omitempty"`
	Aliases             []string          `json:"aliases,omitempty"`
	DNSNames            []string          `json:"dnsNames,omitempty"`
	GwPriority          int               `json:"gwPriority,omitempty"`
	IPPrefixLen         int               `json:"ipPrefixLen,omitempty"`
	GlobalIPv6PrefixLen int               `json:"globalIPv6PrefixLen,omitempty"`
}

type ContainerNetworkSettings struct {
	Networks map[string]ContainerNetworkEndpoint `json:"networks"`
}

type ContainerNetworkingConfigCreate struct {
	EndpointsConfig map[string]ContainerEndpointSettingsCreate `json:"endpointsConfig,omitempty"`
}

type ContainerPort struct {
	IP          string `json:"ip,omitempty"`
	Type        string `json:"type"`
	PrivatePort int    `json:"privatePort"`
	PublicPort  int    `json:"publicPort,omitempty"`
}

type ContainerPortBindingCreate struct {
	HostIP   string `json:"hostIp,omitempty"`
	HostPort string `json:"hostPort,omitempty"`
}

type ContainerProcesses struct {
	Titles    []string   `json:"titles"`
	Processes [][]string `json:"processes"`
}

type ContainerRegistry struct {
	CreatedAt    time.Time `json:"createdAt" readOnly:"true"`
	UpdatedAt    time.Time `json:"updatedAt" readOnly:"true"`
	Description  *string   `json:"description,omitempty" unorm:"nfc" trim:"true"`
	ID           string    `json:"id" readOnly:"true"`
	URL          string    `json:"url" required:"false"`
	Host         string    `json:"host" readOnly:"true"`
	Namespace    string    `json:"namespace" readOnly:"true"`
	Username     string    `json:"username" required:"false"`
	RegistryType string    `json:"registryType" required:"false"`

	AWSAccessKeyID string `json:"awsAccessKeyId,omitempty"`
	AWSRegion      string `json:"awsRegion,omitempty"`

	Token              string   `json:"token,omitempty" writeOnly:"true" copier:"-"`
	AWSSecretAccessKey string   `json:"awsSecretAccessKey,omitempty" writeOnly:"true" copier:"-"`
	RepositoryNames    []string `json:"repositoryNames" required:"false"`
	Insecure           bool     `json:"insecure" required:"false"`
	Enabled            bool     `json:"enabled" required:"false"`
}

type ContainerRegistryCredential struct {
	URL      string `json:"url" binding:"required"`
	Username string `json:"username" binding:"required"`
	Token    string `json:"token" binding:"required"`
	Enabled  bool   `json:"enabled"`
}

type ContainerRegistryDeleteTagResponse struct {
	Digest string `json:"digest"`
}

type ContainerRegistryDigestResult struct {
	Digest         string
	AuthMethod     string
	AuthUsername   string
	AuthRegistry   string
	UsedCredential bool
}

type ContainerRegistryPullUsage struct {
	CheckedAt time.Time `json:"checkedAt"`
	Limit     *int      `json:"limit,omitempty"`
	Remaining *int      `json:"remaining,omitempty"`
	Used      *int      `json:"used,omitempty"`

	WindowSeconds *int   `json:"windowSeconds,omitempty"`
	RegistryID    string `json:"registryId"`
	Provider      string `json:"provider"`
	Registry      string `json:"registry"`
	DisplayName   string `json:"displayName"`
	Repository    string `json:"repository,omitempty"`
	AuthMethod    string `json:"authMethod"`
	AuthUsername  string `json:"authUsername,omitempty"`
	Source        string `json:"source,omitempty"`
	Error         string `json:"error,omitempty"`
	ObservedPulls int64  `json:"observedPulls"`
}

type ContainerRegistryPullUsageResponse struct {
	Registries []ContainerRegistryPullUsage `json:"registries"`
}

type ContainerRegistryRepository struct {
	Name string `json:"name"`
}

type ContainerRegistryRepositoryTag struct {
	Created   *time.Time                     `json:"created,omitempty"`
	Name      string                         `json:"name"`
	Digest    string                         `json:"digest,omitempty"`
	MediaType string                         `json:"mediaType,omitempty"`
	Error     string                         `json:"error,omitempty"`
	Platforms []ContainerRegistryTagPlatform `json:"platforms"`

	Size int64 `json:"size"`
}

type ContainerRegistrySync struct {
	CreatedAt    time.Time `json:"createdAt"`
	UpdatedAt    time.Time `json:"updatedAt"`
	Description  *string   `json:"description,omitzero" unorm:"nfc" trim:"true"`
	ID           string    `json:"id" binding:"required"`
	URL          string    `json:"url" binding:"required"`
	Username     string    `json:"username"`
	Token        string    `json:"token"`
	RegistryType string    `json:"registryType"`

	AWSAccessKeyID string `json:"awsAccessKeyId,omitempty"`

	AWSSecretAccessKey string   `json:"awsSecretAccessKey,omitempty"`
	AWSRegion          string   `json:"awsRegion,omitempty"`
	RepositoryNames    []string `json:"repositoryNames"`
	Insecure           bool     `json:"insecure"`
	Enabled            bool     `json:"enabled"`
}

type ContainerRegistrySyncRequest struct {
	Registries []ContainerRegistrySync `json:"registries" binding:"required"`
}

type ContainerRegistryTagPlatform struct {
	OS           string `json:"os"`
	Architecture string `json:"architecture"`
	Variant      string `json:"variant,omitempty"`
	Digest       string `json:"digest"`

	Size int64 `json:"size"`
}

type ContainerResourceSample struct {
	SampleTime       time.Time `json:"sampleTime"`
	CPUPercent       float64   `json:"cpuPercent"`
	MemoryUsageBytes uint64    `json:"memoryUsageBytes"`
	MemoryLimitBytes uint64    `json:"memoryLimitBytes"`

	BlockReadBytes  uint64 `json:"blockReadBytes"`
	BlockWriteBytes uint64 `json:"blockWriteBytes"`
	NetworkRxBytes  uint64 `json:"networkRxBytes"`
	NetworkTxBytes  uint64 `json:"networkTxBytes"`
	PIDs            uint64 `json:"pids"`
}

type ContainerResourceSampleBatch struct {
	Timestamp time.Time                           `json:"timestamp"`
	Samples   map[string]*ContainerResourceSample `json:"samples"`
	Error     string                              `json:"error,omitempty"`
}

type ContainerResourceSampleSubscription struct {
	ContainerIDs []string `json:"containerIds"`
}

type ContainerRestartPolicyCreate struct {
	Name              string `json:"name,omitempty"`
	MaximumRetryCount int    `json:"maximumRetryCount,omitempty"`
}

type ContainerSetAutoUpdateRequest struct {
	Enabled bool `json:"enabled" doc:"Whether auto-update is enabled for this container"`
}

type ContainerState struct {
	Health     *ContainerHealth `json:"health,omitempty"`
	Status     string           `json:"status"`
	StartedAt  string           `json:"startedAt,omitempty"`
	FinishedAt string           `json:"finishedAt,omitempty"`
	ExitCode   int              `json:"exitCode,omitempty"`
	Running    bool             `json:"running"`
}

type ContainerStatusCounts struct {
	RunningContainers int `json:"runningContainers"`
	StoppedContainers int `json:"stoppedContainers"`
	TotalContainers   int `json:"totalContainers"`

	UnhealthyContainers int `json:"unhealthyContainers" doc:"Containers whose healthcheck reports unhealthy"`

	UpdatesAvailable int `json:"updatesAvailable" doc:"Standalone containers with a pending image update"`
}

type ContainerSummary struct {
	Labels          map[string]string        `json:"labels"`
	NetworkSettings ContainerNetworkSettings `json:"networkSettings"`
	UpdateInfo      *ImageUpdateInfo         `json:"updateInfo,omitempty"`

	ResourceSample *ContainerResourceSample `json:"resourceSample,omitempty"`
	EnvironmentTag
	ID             string              `json:"id"`
	Image          string              `json:"image"`
	ImageID        string              `json:"imageId"`
	Command        string              `json:"command"`
	State          string              `json:"state"`
	Status         string              `json:"status"`
	IconLightURL   string              `json:"iconLightUrl,omitempty"`
	IconDarkURL    string              `json:"iconDarkUrl,omitempty"`
	UpdateStrategy string              `json:"updateStrategy,omitempty"`
	Names          []string            `json:"names"`
	Ports          []ContainerPort     `json:"ports"`
	Mounts         []ContainerMount    `json:"mounts"`
	HostConfig     ContainerHostConfig `json:"hostConfig"`

	Created          int64 `json:"created"`
	RedeployDisabled bool  `json:"redeployDisabled,omitempty"`

	AutoUpdateEnabled bool `json:"autoUpdateEnabled"`
	Hidden            bool `json:"hidden,omitempty"`
}

type ContainerSummaryGroup struct {
	GroupName string             `json:"groupName"`
	Items     []ContainerSummary `json:"items"`
}

type ConvertDockerRunRequest struct {
	DockerRunCommand string `json:"dockerRunCommand" binding:"required"`
}

type ConvertDockerRunResponse struct {
	DockerCompose string `json:"dockerCompose"`
	EnvVars       string `json:"envVars"`
	ServiceName   string `json:"serviceName"`
	Success       bool   `json:"success"`
}

type Create[T any] struct {
	Body T
	SubmittedBody
}

type CreateEnrollmentTokenRequest struct {
	MaxUses *int   `` /* 137-byte string literal not displayed */
	Name    string `json:"name" minLength:"1" maxLength:"100" doc:"Enrollment token name" unorm:"nfc" trim:"true"`
}

type CreateProject struct {
	EnvContent     *string                    `json:"envContent,omitempty"`
	TagColors      map[string]ProjectTagColor `json:"tagColors,omitempty"`
	Name           string                     `json:"name" binding:"required"`
	ComposeContent string                     `json:"composeContent" binding:"required"`
	Directory      string                     `json:"directory,omitempty"`
	Tags           []string                   `json:"tags,omitempty"`
}

type CreateProjectResponse struct {
	StatusReason    *string      `json:"statusReason,omitempty"`
	GitOpsManagedBy *string      `json:"gitOpsManagedBy,omitempty"`
	ArchivedAt      *time.Time   `json:"archivedAt,omitempty"`
	ActivityID      *string      `json:"activityId,omitempty"`
	ID              string       `json:"id"`
	Name            string       `json:"name"`
	DirName         string       `json:"dirName,omitempty"`
	RelativePath    string       `json:"relativePath,omitempty"`
	Path            string       `json:"path"`
	Status          string       `json:"status"`
	CreatedAt       string       `json:"createdAt"`
	UpdatedAt       string       `json:"updatedAt"`
	Tags            []ProjectTag `json:"tags"`
	ServiceCount    int          `json:"serviceCount"`
	RunningCount    int          `json:"runningCount"`
	IsArchived      bool         `json:"isArchived"`
}

type CreateProjectWorkspaceManifest struct {
	FileChanges []WorkspaceFileChange `json:"fileChanges" binding:"required" maxItems:"500"`
}

type CreateSystemBackupRequest struct {
	ID              string                  `json:"id,omitempty"`
	Destination     SystemBackupDestination `json:"destination,omitempty"`
	S3DestinationID string                  `json:"s3DestinationId,omitempty"`
	RecoveryKey     string                  `json:"recoveryKey,omitempty"`
	PolicyID        string                  `json:"policyId,omitempty"`
}

type CreateUploadSessionRequest struct {
	Filename  string `json:"filename" required:"true" doc:"Original filename; validated per kind"`
	Size      int64  `json:"size" required:"true" minimum:"1" doc:"Total file size in bytes"`
	ChunkSize int64  `json:"chunkSize,omitempty" doc:"Chunk size in bytes; server default and bounds apply"`
}

type CreateVolumeBackupRequest struct {
	Destination     VolumeBackupDestination `json:"destination,omitempty" doc:"Optional destination override for this manual backup"`
	PolicyID        string                  `json:"policyId,omitempty" doc:"Optional backup policy whose settings should be used"`
	S3DestinationID string                  `json:"s3DestinationId,omitempty" doc:"Saved S3 destination for a manual remote backup"`
}

type CurrentUserContextKey struct{}

type CustomTheme struct {
	ID          string       `json:"id" doc:"Custom theme identifier, prefixed with custom-" example:"custom-solarized"`
	Name        string       `json:"name" doc:"Display name of the custom theme" example:"Solarized"`
	Description string       `json:"description,omitempty" doc:"Optional description of the custom theme"`
	Light       ThemePalette `json:"light" doc:"Color tokens used in light mode"`
	Dark        ThemePalette `json:"dark" doc:"Color tokens used in dark mode"`
}

type DashboardDockerSnapshot struct {
	Volumes    *client.VolumeListResult  `json:"volumes"`
	Containers []dockercontainer.Summary `json:"containers"`
	Images     []dockerimage.Summary     `json:"images"`
	Networks   []dockernetwork.Summary   `json:"networks"`
}

type DashboardWidgetConfig struct {
	Filters        map[string]string `json:"filters,omitempty" doc:"Filters applied to the resource query, keyed by filter name"`
	ResourceKind   string            `json:"resourceKind,omitempty" enum:"containers,projects,images,volumes,networks" doc:"Kind of resource the widget shows"`
	ResourceID     string            `json:"resourceId,omitempty" doc:"Identifier of a single resource shown by the widget"`
	Search         string            `json:"search,omitempty" doc:"Search text applied to the resource query"`
	Display        string            `json:"display,omitempty" enum:"count,list" doc:"How the widget presents query results"`
	EnvironmentIDs []string          `json:"environmentIds,omitempty" doc:"Environments the widget reads from; empty means all environments the user can access"`
	Limit          int               `json:"limit,omitempty" doc:"Maximum number of resources listed by the widget"`
}

type DashboardWidgetLayout struct {
	Config *DashboardWidgetConfig `json:"config,omitempty" doc:"Configuration for custom widget types"`
	ID     string                 `json:"id" required:"false" doc:"Unique dashboard widget instance identifier; assigned by the server for new custom widgets"`
	Type   string                 `json:"type,omitempty" doc:"Dashboard widget type; defaults to the identifier for built-in widgets"`
	Title  string                 `json:"title,omitempty" doc:"Optional custom widget title"`
	X      int                    `json:"x" doc:"Column where the widget starts in the 12-column dashboard grid"`
	Y      int                    `json:"y" doc:"Row where the widget starts in the dashboard grid"`
	W      int                    `json:"w" doc:"Widget width in columns"`
	H      int                    `json:"h" doc:"Widget height in rows"`
	Hidden bool                   `json:"hidden,omitempty" doc:"Whether the widget is hidden"`
}

type DefaultTemplatesResponse struct {
	ComposeTemplate       string `json:"composeTemplate"`
	SwarmStackTemplate    string `json:"swarmStackTemplate"`
	SwarmStackEnvTemplate string `json:"swarmStackEnvTemplate"`
	EnvTemplate           string `json:"envTemplate"`
}

type DeleteSystemBackupRequest struct {
	RecoveryKey string `json:"recoveryKey,omitempty"`
}

type DeploymentSnippet struct {
	MTLS            *DeploymentSnippetMTLS `json:"mtls,omitempty" doc:"Optional Arcane-generated mTLS deployment assets for agents"`
	DockerRun       string                 `json:"dockerRun" doc:"Docker run command snippet"`
	DockerCompose   string                 `json:"dockerCompose" doc:"Docker compose YAML snippet"`
	EnrollmentToken string                 `json:"enrollmentToken" doc:"Single-use enrollment token the agent uses to join this environment, shown only once"`
}

type DeploymentSnippetFile struct {
	Name          string `json:"name" doc:"Suggested filename"`
	Content       string `json:"content,omitempty" doc:"PEM file contents"`
	DownloadURL   string `json:"downloadUrl,omitempty" doc:"Pairing-permission endpoint to download this file"`
	ContainerPath string `json:"containerPath" doc:"Container mount path expected by the mTLS snippet"`
	Permissions   string `json:"permissions" doc:"Suggested file mode"`
}

type DeploymentSnippetMTLS struct {
	DockerRun     string                  `json:"dockerRun" doc:"Docker run snippet using Arcane-generated mTLS assets"`
	DockerCompose string                  `json:"dockerCompose" doc:"Docker compose snippet using Arcane-generated mTLS assets"`
	HostDirHint   string                  `json:"hostDirHint" doc:"Suggested host directory containing the generated PEM files"`
	Files         []DeploymentSnippetFile `json:"files" doc:"Generated PEM files to place on the agent host"`
}

type Diagnostics struct {
	Timestamp time.Time            `json:"timestamp"`
	GC        GCInfo               `json:"gc"`
	Runtime   RuntimeInfo          `json:"runtime"`
	WebSocket WebSocketDiagnostics `json:"websocket"`
	Memory    MemoryInfo           `json:"memory"`
}

type DiagnosticsCommand struct {
	ID      string `json:"id"`
	Type    string `json:"type"`
	Name    string `json:"name,omitempty"`
	Seconds int    `json:"seconds,omitempty"`
}

type DiagnosticsMessage struct {
	Snapshot   *Diagnostics         `json:"snapshot,omitempty"`
	LeakReport *GoroutineLeakReport `json:"leakReport,omitempty"`
	Type       string               `json:"type"`
	ID         string               `json:"id,omitempty"`
	Text       string               `json:"text,omitempty"`
	Error      string               `json:"error,omitempty"`
	Data       []byte               `json:"data,omitempty"`
}

type DiscoverSystemBackupsRequest struct {
	S3DestinationID string `json:"s3DestinationId"`
	RecoveryKey     string `json:"recoveryKey"`
}

type DiscoverVolumeBackupsRequest struct {
	S3DestinationID string `json:"s3DestinationId" doc:"S3 destination to scan for existing volume backups"`
}

type DiscoverVolumeBackupsResponse struct {
	Errors []string `json:"errors,omitempty" doc:"Per-repository failures encountered during discovery"`
	Count  int      `json:"count" doc:"Number of newly discovered volume backups"`
}

type DockerInfo struct {
	APIVersion string `json:"apiVersion"`
	GitCommit  string `json:"gitCommit"`
	GoVersion  string `json:"goVersion"`
	Os         string `json:"os"`
	Arch       string `json:"arch"`
	BuildTime  string `json:"buildTime"`
	system.Info
	Success bool `json:"success"`
}

type DockerRunCommand struct {
	Image       string   `json:"image"`
	Name        string   `json:"name,omitempty"`
	Restart     string   `json:"restart,omitempty"`
	Workdir     string   `json:"workdir,omitempty"`
	User        string   `json:"user,omitempty"`
	Entrypoint  string   `json:"entrypoint,omitempty"`
	Command     string   `json:"command,omitempty"`
	HealthCheck string   `json:"healthCheck,omitempty"`
	MemoryLimit string   `json:"memoryLimit,omitempty"`
	CPULimit    string   `json:"cpuLimit,omitempty"`
	Ports       []string `json:"ports,omitempty"`
	Volumes     []string `json:"volumes,omitempty"`
	Environment []string `json:"environment,omitempty"`
	Networks    []string `json:"networks,omitempty"`
	Labels      []string `json:"labels,omitempty"`
	Detached    bool     `json:"detached,omitempty"`
	Interactive bool     `json:"interactive,omitempty"`
	TTY         bool     `json:"tty,omitempty"`
	Remove      bool     `json:"remove,omitempty"`
	Privileged  bool     `json:"privileged,omitempty"`
}

type DynamicScheduler interface {
	Submit(ctx context.Context, request SchedulerRequest) (SchedulerRun, error)
	AddJob(ctx context.Context, job SchedulerJob) error
	RemoveJob(ctx context.Context, name string)
	HasJob(name string) bool
}

type EnrollmentToken struct {
	CreatedAt       time.Time  `json:"createdAt" doc:"Creation timestamp"`
	LastUsedAt      *time.Time `json:"lastUsedAt,omitempty" doc:"When an agent last enrolled with this token"`
	EnvironmentID   *string    `json:"environmentId,omitempty" doc:"Environment the token enrolls into, when bound"`
	EnvironmentName *string    `json:"environmentName,omitempty" doc:"Name of the bound environment"`
	MaxUses         *int       `json:"maxUses,omitempty" doc:"Maximum number of enrollments; absent means unlimited"`
	ID              string     `json:"id" doc:"Enrollment token ID"`
	Name            string     `json:"name" doc:"Enrollment token name"`
	UseCount        int        `json:"useCount" doc:"Number of enrollments made with this token"`
}

type EnrollmentTokenCreated struct {
	CreatedAt time.Time `json:"createdAt" doc:"Creation timestamp"`
	MaxUses   *int      `json:"maxUses,omitempty" doc:"Maximum number of enrollments; absent means unlimited"`
	ID        string    `json:"id" doc:"Enrollment token ID"`
	Name      string    `json:"name" doc:"Enrollment token name"`
	Token     string    `json:"token" doc:"Enrollment token"`
}

type EnrollmentTokenSecret struct {
	Token string `json:"token" doc:"Enrollment token"`
}

type EnvSummary struct {
	Variables []EnvVariable `json:"variables"`
}

type EnvVariable struct {
	Key      string `json:"key"`
	Value    string `json:"value"`
	NoInject bool   `json:"noInject,omitzero"`
}

type Environment struct {
	LastSeen *time.Time `json:"lastSeen,omitempty" readOnly:"true"`

	AgentTransport *string `json:"agentTransport,omitempty" readOnly:"true"`

	LastAgentTransport *string `json:"lastAgentTransport,omitempty" readOnly:"true"`

	// Values include "token" and "mtls".
	AgentSecurityMode *string `json:"agentSecurityMode,omitempty" readOnly:"true"`
	AgentSessionID    *string `json:"agentSessionId,omitempty" readOnly:"true"`
	AgentInstance     *string `json:"agentInstance,omitempty" readOnly:"true"`

	AgentRoundTripMs     *float64              `json:"agentRoundTripMs,omitempty" readOnly:"true"`
	AgentOpenStreams     *int                  `json:"agentOpenStreams,omitempty" readOnly:"true"`
	Connected            *bool                 `json:"connected,omitempty" readOnly:"true"`
	ConnectedAt          *time.Time            `json:"connectedAt,omitempty" readOnly:"true"`
	LastHeartbeat        *time.Time            `json:"lastHeartbeat,omitempty" readOnly:"true"`
	AgentMTLSCertificate *AgentMTLSCertificate `json:"agentMTLSCertificate,omitempty" readOnly:"true"`

	AgentHost *AgentHostInfo `json:"agentHost,omitempty" readOnly:"true"`

	AgentTunnelStats  *AgentTunnelStats `json:"agentTunnelStats,omitempty" readOnly:"true"`
	ID                string            `json:"id" readOnly:"true"`
	Name              string            `json:"name,omitempty" unorm:"nfc" trim:"true"`
	ApiUrl            string            `json:"apiUrl" readOnly:"true"`
	Status            string            `json:"status" readOnly:"true"`
	AgentCapabilities []string          `json:"agentCapabilities,omitempty" readOnly:"true"`
	Enabled           bool              `json:"enabled" required:"false"`
}

type EnvironmentChanges struct {
	Kinds         map[string]uint64 `json:"kinds"`
	EnvironmentID string            `json:"environmentId"`
	Epoch         string            `json:"epoch"`
}

type EnvironmentData[T any] struct {
	Data        T              `json:"data" doc:"Data reported by the environment"`
	Environment EnvironmentRef `json:"environment" doc:"Environment the data came from"`
}

type EnvironmentFailure struct {
	Environment EnvironmentRef `json:"environment" doc:"Environment that failed"`
	Message     string         `json:"message" doc:"Why the environment's results are missing"`
}

type EnvironmentInput struct {
	EnvironmentID string `path:"id" doc:"Environment ID"`
}

type EnvironmentRef struct {
	ID   string `json:"id" doc:"Environment ID"`
	Name string `json:"name" doc:"Environment display name"`
}

type EnvironmentStreamEvent struct {
	Timestamp    time.Time     `json:"timestamp"`
	Type         string        `json:"type"`
	Environments []Environment `json:"environments,omitempty"`
}

type EnvironmentSyncStatus struct {
	LastSyncedAt    *time.Time `json:"lastSyncedAt,omitempty"`
	EnvironmentID   string     `json:"environmentId"`
	EnvironmentName string     `json:"environmentName,omitempty"`
	Status          string     `json:"status"` // "synced" | "pending" | "error"
	Error           string     `json:"error,omitempty"`
}

type EnvironmentTag struct {
	EnvironmentID   string `json:"environmentId,omitempty" doc:"Environment the row came from in a multi-environment list"`
	EnvironmentName string `json:"environmentName,omitempty" doc:"Display name of the environment the row came from"`
}

type EnvironmentTest struct {
	Message *string `json:"message,omitempty"`
	Status  string  `json:"status"`
}

type EnvironmentTunnelRestart struct {
	SessionID   string `json:"sessionId,omitzero"`
	Reconnected bool   `json:"reconnected"`
}

type EnvironmentVulnerabilitySummary struct {
	Summary       *VulnerabilitySeveritySummary `json:"summary,omitempty"`
	TotalImages   int                           `json:"totalImages"`
	ScannedImages int                           `json:"scannedImages"`

	ActionableCount int `json:"actionableCount" doc:"Critical and high findings that are not ignored"`
}

type ErrorResponse struct {
	Error string `json:"error" doc:"Error message describing what went wrong"`
}

type Event struct {
	Timestamp     time.Time      `json:"timestamp"`
	CreatedAt     time.Time      `json:"createdAt"`
	ResourceType  *string        `json:"resourceType,omitempty"`
	ResourceID    *string        `json:"resourceId,omitempty"`
	ResourceName  *string        `json:"resourceName,omitempty"`
	UserID        *string        `json:"userId,omitempty"`
	Username      *string        `json:"username,omitempty"`
	EnvironmentID *string        `json:"environmentId,omitempty"`
	Metadata      map[string]any `json:"metadata,omitempty"`
	UpdatedAt     *time.Time     `json:"updatedAt,omitempty"`
	ID            string         `json:"id"`
	Type          string         `json:"type"`
	Severity      string         `json:"severity"`
	Title         string         `json:"title"`
	Description   string         `json:"description,omitempty"`
}

type EventSeverityCounts struct {
	Total   int64 `json:"total"`
	Info    int64 `json:"info"`
	Success int64 `json:"success"`
	Warning int64 `json:"warning"`
	Error   int64 `json:"error"`
}

type EventStreamEvent struct {
	Type      string               `json:"type"`
	Timestamp time.Time            `json:"timestamp"`
	Changes   []EnvironmentChanges `json:"changes"`
}

type FeatureDefinition struct {
	ID             FeatureID
	SettingKey     string
	DefaultEnabled bool
}

type FeatureDisabledError struct {
	Title   string    `json:"title"`
	Detail  string    `json:"detail"`
	Code    string    `json:"code"`
	Feature FeatureID `json:"feature"`
	Status  int       `json:"status"`
}

type FeatureID string

type FederatedCredential struct {
	CreatedAt       time.Time  `json:"createdAt" readOnly:"true" doc:"Creation timestamp"`
	Description     *string    `json:"description,omitempty" maxLength:"1000" doc:"Optional description" unorm:"nfc" trim:"true"`
	EnvironmentID   *string    `json:"environmentId,omitempty" doc:"Optional environment scope for the role assignment"`
	LastUsedAt      *time.Time `json:"lastUsedAt,omitempty" readOnly:"true" doc:"Last successful token exchange"`
	ExpiresAt       *time.Time `json:"expiresAt,omitempty" doc:"Optional credential expiration"`
	UpdatedAt       *time.Time `json:"updatedAt,omitempty" readOnly:"true" doc:"Last update timestamp"`
	ID              string     `json:"id" readOnly:"true" doc:"Unique identifier of the federated credential"`
	Name            string     `json:"name" required:"false" minLength:"1" maxLength:"255" doc:"Display name" unorm:"nfc" trim:"true"`
	IssuerURL       string     `json:"issuerUrl" required:"false" doc:"Trusted external OIDC issuer URL"`
	SubjectClaim    string     `json:"subjectClaim" required:"false" doc:"Claim path to match against; defaults to sub"`
	SubjectMatch    string     `json:"subjectMatch" required:"false" doc:"Exact subject or anchored glob pattern"`
	MatchType       string     `json:"matchType" required:"false" doc:"Subject match strategy" enum:"exact,glob"`
	RoleID          string     `json:"roleId" required:"false" doc:"Mapped role ID"`
	IdentityUserID  string     `json:"identityUserId" readOnly:"true" doc:"Dedicated service user ID backing issued tokens"`
	ServiceUsername string     `json:"serviceUsername,omitempty" readOnly:"true" doc:"Dedicated service account username"`
	RoleName        string     `json:"roleName,omitempty" readOnly:"true" doc:"Mapped role name"`
	EnvironmentName string     `json:"environmentName,omitempty" readOnly:"true" doc:"Mapped environment name when scoped"`
	Audiences       []string   `json:"audiences" required:"false" doc:"Allowed external token audiences"`
	TokenTTLSeconds int        `json:"tokenTtlSeconds" required:"false" minimum:"60" maximum:"3600" doc:"Issued token lifetime in seconds"`
	Enabled         bool       `json:"enabled" required:"false" doc:"Whether exchanges are allowed"`
}

type FederatedTokenResponse struct {
	AccessToken     string `json:"access_token"`      //nolint:tagliatelle // RFC 8693 wire shape is snake_case.
	TokenType       string `json:"token_type"`        //nolint:tagliatelle // RFC 8693 wire shape is snake_case.
	IssuedTokenType string `json:"issued_token_type"` //nolint:tagliatelle // RFC 8693 wire shape is snake_case.
	ExpiresIn       int    `json:"expires_in"`        //nolint:tagliatelle // RFC 8693 wire shape is snake_case.
}

type FieldError struct {
	Err   error
	Field string
}

type FileTreeNode struct {
	Name     string           `json:"name"`
	Path     string           `json:"path"`
	Type     FileTreeNodeType `json:"type"`
	Children []FileTreeNode   `json:"children,omitempty"`

	Size int64 `json:"size,omitempty"`
}

type FileTreeNodeType string

type FrozenUpdateTarget struct {
	ContainerID          string
	ContainerName        string
	ComposeProject       string
	ComposeService       string
	ComposeNumber        string
	BaselineImageID      string
	BaselineStartedAt    string
	DesiredImageRef      string
	DesiredDigest        string
	BaselineRestartCount int
	BaselineRunning      bool
}

type GCInfo struct {
	LastGC         time.Time `json:"lastGc"`
	RecentPausesNs []int64   `json:"recentPausesNs"`
	NumGC          int64     `json:"numGc"`
	PauseTotalNs   int64     `json:"pauseTotalNs"`
}

type GPUStats struct {
	Name        string  `json:"name"`
	Index       int     `json:"index"`
	MemoryUsed  float64 `json:"memoryUsed"`
	MemoryTotal float64 `json:"memoryTotal"`
}

type GenericJob struct {
	ScheduleFn  func(ctx context.Context) string
	RunFn       func(ctx context.Context) (SchedulerOutcome, error)
	ReconcileFn func(ctx context.Context, previous SchedulerRun) (SchedulerOutcome, error)
	ShouldRunFn func(ctx context.Context) bool
	JobName     string
}

type GitBranchInfo struct {
	Name      string `json:"name"`
	IsDefault bool   `json:"isDefault"`
}

type GitBranchesResponse struct {
	Branches []GitBranchInfo `json:"branches"`
}

type GitOpsBackupFileChange struct {
	Path   string `json:"path"`
	Change string `json:"change"`
}

type GitOpsBackupFileDiff struct {
	Path  string `json:"path"`
	Patch string `json:"patch"`
}

type GitOpsBackupHistoryEntry struct {
	Commit  string    `json:"commit"`
	Author  string    `json:"author"`
	Message string    `json:"message"`
	Date    time.Time `json:"date"`
	Files   []string  `json:"files"`
}

type GitOpsBackupHistoryResponse struct {
	Entries []GitOpsBackupHistoryEntry `json:"entries"`
}

type GitOpsBackupPreview struct {
	State        string                   `json:"state"`
	RemoteCommit string                   `json:"remoteCommit,omitempty"`
	Changes      []GitOpsBackupFileChange `json:"changes"`
	Conflicts    []GitOpsBackupFileChange `json:"conflicts"`
	Files        []string                 `json:"files"`
}

type GitOpsBackupRevision struct {
	Entry GitOpsBackupHistoryEntry `json:"entry"`
	Diffs []GitOpsBackupFileDiff   `json:"diffs"`
}

type GitOpsBrowseResponse struct {
	Path  string         `json:"path"`
	Files []FileTreeNode `json:"files"`
}

type GitOpsPreDeployConfigRequest struct {
	PreDeployScriptPath *string `json:"preDeployScriptPath,omitempty"`

	// When omitted, the lifecycleDefaultRunnerImage setting is used.
	PreDeployRunnerImage *string `json:"preDeployRunnerImage,omitempty"`

	PreDeployEnv         *string `json:"preDeployEnv,omitempty"`
	PreDeployExtraMounts *string `json:"preDeployExtraMounts,omitempty"`

	PreDeployTimeoutSec *int `json:"preDeployTimeoutSec,omitempty"`

	PreDeployNetworkMode *string `json:"preDeployNetworkMode,omitempty"`
}

type GitOpsResolveBackupConflictRequest struct {
	Strategy string `json:"strategy" binding:"required,oneof=use_arcane"`
}

type GitOpsSync struct {
	CreatedAt time.Time `json:"createdAt" readOnly:"true"`
	UpdatedAt time.Time `json:"updatedAt" readOnly:"true"`

	PreDeployEnv           *string        `json:"preDeployEnv,omitempty"`
	EnvContent             *string        `json:"envContent,omitempty" doc:"KEY=VALUE lines merged over the repository .env on every deploy sync"`
	PreDeployLastRunOutput *string        `json:"preDeployLastRunOutput,omitempty" readOnly:"true"`
	Repository             *GitRepository `json:"repository,omitempty" readOnly:"true"`
	PreDeployLastRunStatus *string        `json:"preDeployLastRunStatus,omitempty" readOnly:"true"`
	PreDeployLastRunAt     *time.Time     `json:"preDeployLastRunAt,omitempty" readOnly:"true"`
	PreDeployExtraMounts   *string        `json:"preDeployExtraMounts,omitempty"`
	LastSyncAt             *time.Time     `json:"lastSyncAt,omitempty" readOnly:"true"`
	ProjectID              *string        `json:"projectId,omitempty"`

	// Required whenever PreDeployScriptPath is set.
	PreDeployRunnerImage *string `json:"preDeployRunnerImage,omitempty"`

	PreDeployScriptPath *string `json:"preDeployScriptPath,omitempty"`
	LastSyncCommit      *string `json:"lastSyncCommit,omitempty" readOnly:"true"`

	SyncedFiles         *string    `json:"syncedFiles,omitempty" readOnly:"true"`
	LastSyncError       *string    `json:"lastSyncError,omitempty" readOnly:"true"`
	LastSyncStatus      *string    `json:"lastSyncStatus,omitempty" readOnly:"true"`
	BackupFailureReason *string    `json:"backupFailureReason,omitempty" readOnly:"true"`
	LastBackupAt        *time.Time `json:"lastBackupAt,omitempty" readOnly:"true"`
	ProjectName         string     `json:"projectName" required:"false"`

	PreDeployNetworkMode string `json:"preDeployNetworkMode" required:"false"`
	Name                 string `json:"name" required:"false"`
	EnvironmentID        string `json:"environmentId" readOnly:"true"`

	ComposeOverridePath string `` /* 150-byte string literal not displayed */

	EnvironmentName string   `json:"environmentName,omitempty" readOnly:"true" doc:"Display name of the environment the sync belongs to"`
	RepositoryID    string   `json:"repositoryId" required:"false"`
	Branch          string   `json:"branch" required:"false"`
	ComposePath     string   `json:"composePath" required:"false"`
	ID              string   `json:"id" readOnly:"true"`
	TargetType      string   `json:"targetType" required:"false"`
	Mode            string   `json:"mode" required:"false"`
	BackupDirectory string   `json:"backupDirectory,omitempty"`
	BackupState     string   `json:"backupState,omitempty" readOnly:"true"`
	BackupPaths     []string `json:"backupPaths,omitempty"`

	PreDeployTimeoutSec int `json:"preDeployTimeoutSec" required:"false"`

	MaxSyncBinarySize int64 `json:"maxSyncBinarySize" required:"false"`

	SyncInterval int `json:"syncInterval" required:"false"`

	// 0 means unlimited; env var overrides take precedence.
	MaxSyncFiles int `json:"maxSyncFiles" required:"false"`

	MaxSyncTotalSize int64 `json:"maxSyncTotalSize" required:"false"`
	AutoSync         bool  `json:"autoSync" required:"false"`
	SyncDirectory    bool  `json:"syncDirectory" required:"false"`

	PullImageAfterSync bool `json:"pullImageAfterSync" required:"false"`

	RedeployAfterSync bool `json:"redeployAfterSync" required:"false"`
	BackupOnSave      bool `json:"backupOnSave" required:"false"`
	BackupPending     bool `json:"backupPending" readOnly:"true"`
}

type GitOpsSyncCounts struct {
	TotalSyncs      int `json:"totalSyncs"`
	ActiveSyncs     int `json:"activeSyncs"`
	SuccessfulSyncs int `json:"successfulSyncs"`
	DeploySyncs     int `json:"deploySyncs"`
	BackupSyncs     int `json:"backupSyncs"`
}

type GitOpsSyncResult struct {
	SyncedAt time.Time `json:"syncedAt"`
	Error    *string   `json:"error,omitempty"`
	Message  string    `json:"message"`
	Success  bool      `json:"success"`
}

type GitOpsSyncStatus struct {
	NextSyncAt          *time.Time `json:"nextSyncAt,omitempty"`
	LastSyncAt          *time.Time `json:"lastSyncAt,omitempty"`
	LastSyncStatus      *string    `json:"lastSyncStatus,omitempty"`
	LastSyncError       *string    `json:"lastSyncError,omitempty"`
	LastSyncCommit      *string    `json:"lastSyncCommit,omitempty"`
	BackupFailureReason *string    `json:"backupFailureReason,omitempty"`
	LastBackupAt        *time.Time `json:"lastBackupAt,omitempty"`
	ID                  string     `json:"id"`
	Mode                string     `json:"mode"`
	BackupState         string     `json:"backupState,omitempty"`
	AutoSync            bool       `json:"autoSync"`
	BackupPending       bool       `json:"backupPending"`
}

type GitRepository struct {
	CreatedAt              time.Time `json:"createdAt" readOnly:"true"`
	UpdatedAt              time.Time `json:"updatedAt" readOnly:"true"`
	Description            *string   `json:"description,omitempty" unorm:"nfc" trim:"true"`
	ID                     string    `json:"id" readOnly:"true"`
	Name                   string    `json:"name" required:"false" unorm:"nfc" trim:"true"`
	URL                    string    `json:"url" required:"false"`
	Provider               string    `` /* 135-byte string literal not displayed */
	AuthType               string    `json:"authType" required:"false"`
	Username               string    `json:"username,omitempty"`
	SSHHostKeyVerification string    `json:"sshHostKeyVerification,omitempty"`
	CommitAuthorName       string    `json:"commitAuthorName,omitempty" unorm:"nfc" trim:"true"`
	CommitAuthorEmail      string    `json:"commitAuthorEmail,omitempty" trim:"true"`

	Token                string `json:"token,omitempty" writeOnly:"true" copier:"-"`
	SSHKey               string `json:"sshKey,omitempty" writeOnly:"true" copier:"-"`
	SigningKey           string `json:"signingKey,omitempty" writeOnly:"true" copier:"-"`
	SigningKeyPassphrase string `json:"signingKeyPassphrase,omitempty" writeOnly:"true" copier:"-"`
	HasToken             bool   `json:"hasToken" readOnly:"true"`
	HasSshKey            bool   `json:"hasSshKey" readOnly:"true"`
	HasSigningKey        bool   `json:"hasSigningKey" readOnly:"true"`
	Enabled              bool   `json:"enabled" required:"false"`
}

type GitRepositorySync struct {
	CreatedAt              time.Time `json:"createdAt"`
	UpdatedAt              time.Time `json:"updatedAt"`
	Description            *string   `json:"description,omitempty" unorm:"nfc" trim:"true"`
	ID                     string    `json:"id" binding:"required"`
	Name                   string    `json:"name" binding:"required" unorm:"nfc" trim:"true"`
	URL                    string    `json:"url" binding:"required"`
	Provider               string    `json:"provider,omitempty"`
	AuthType               string    `json:"authType" binding:"required"`
	Username               string    `json:"username,omitempty"`
	Token                  string    `json:"token,omitempty"`
	SSHKey                 string    `json:"sshKey,omitempty"`
	SSHHostKeyVerification string    `json:"sshHostKeyVerification,omitempty"`
	CommitAuthorName       string    `json:"commitAuthorName,omitempty"`
	CommitAuthorEmail      string    `json:"commitAuthorEmail,omitempty"`
	SigningKey             string    `json:"signingKey,omitempty"`
	SigningKeyPassphrase   string    `json:"signingKeyPassphrase,omitempty"`
	Enabled                bool      `json:"enabled"`
}

type GitRepositorySyncRequest struct {
	Repositories []GitRepositorySync `json:"repositories" binding:"required"`
}

type GlobalVariable struct {
	CreatedAt            time.Time  `json:"createdAt" readOnly:"true"`
	UpdatedAt            *time.Time `json:"updatedAt,omitempty" readOnly:"true"`
	ID                   string     `json:"id" readOnly:"true"`
	Key                  string     `json:"key" required:"false"`
	Value                string     `json:"value" required:"false"`
	EnvironmentIDs       []string   `json:"environmentIds" required:"false"`
	IsSecret             bool       `json:"isSecret" required:"false"`
	AllEnvironments      bool       `json:"allEnvironments" required:"false"`
	InjectIntoContainers bool       `json:"injectIntoContainers" required:"false"`
}

type GlobalVariableMutationResponse struct {
	Variable    *GlobalVariable         `json:"variable,omitempty"`
	SyncResults []EnvironmentSyncStatus `json:"syncResults,omitempty"`
}

type GoroutineFrame struct {
	Function string `json:"function"`
	File     string `json:"file"`
	Line     int    `json:"line"`
}

type GoroutineGroup struct {
	Label  string           `json:"label"`
	Frames []GoroutineFrame `json:"frames"`
	Count  int              `json:"count"`
}

type GoroutineLeakReport struct {
	ScannedAt time.Time `json:"scannedAt"`
	Profile   string    `json:"profile"`
	Count     int       `json:"count"`
}

type GoroutineProfile struct {
	CapturedAt time.Time        `json:"capturedAt"`
	Groups     []GoroutineGroup `json:"groups"`
	Total      int              `json:"total"`
}

type HardenedImageInfo struct {
	// Shell and PackageManager are empty when the label says the image has none, and nil when the label is missing.
	Shell          *string                    `json:"shell,omitzero" doc:"Shell in the image; empty when it has none"`
	PackageManager *string                    `json:"packageManager,omitzero" doc:"Package manager in the image; empty when it has none"`
	Name           string                     `json:"name" doc:"Hardened image name, such as dhi/aspnetcore"`
	Title          string                     `json:"title,omitempty" doc:"Display title"`
	Version        string                     `json:"version,omitempty" doc:"Image version"`
	Definition     string                     `json:"definition,omitempty" doc:"Catalog definition path"`
	Distro         string                     `json:"distro,omitempty" doc:"Base distribution"`
	Variant        string                     `json:"variant,omitempty" doc:"Image variant, such as runtime or dev"`
	Flavor         string                     `json:"flavor,omitempty" doc:"Image flavor"`
	Entitlement    string                     `json:"entitlement,omitempty" doc:"Catalog entitlement"`
	URL            string                     `json:"url,omitempty" doc:"Catalog page URL"`
	ChainID        string                     `json:"chainId,omitempty" doc:"Build chain ID"`
	Created        string                     `json:"created,omitempty" doc:"Build time (RFC 3339)"`
	ReleaseDate    string                     `json:"releaseDate,omitempty" doc:"Release date (YYYY-MM-DD)"`
	EndOfLifeDate  string                     `json:"endOfLifeDate,omitempty" doc:"End-of-life date (YYYY-MM-DD)"`
	SupportStatus  HardenedImageSupportStatus `json:"supportStatus" enum:"supported,ending_soon,end_of_life,unknown" doc:"Support status from the end-of-life date"`
	Compliance     []string                   `json:"compliance,omitempty" doc:"Compliance frameworks, such as cis"`
}

type HardenedImageSupportStatus string

type HealthResponse struct {
	Status string `json:"status"`
}

type IgnoredVulnerability struct {
	CreatedAt time.Time `json:"createdAt" readOnly:"true"`
	Reason    *string   `json:"reason,omitempty" example:"False positive - not exploitable"`

	EnvironmentTag
	ID               string `json:"id" readOnly:"true"`
	ImageID          string `json:"imageId" example:"sha256:abc123"`
	VulnerabilityID  string `json:"vulnerabilityId" example:"CVE-2023-1234"`
	PkgName          string `json:"pkgName" example:"openssl"`
	InstalledVersion string `json:"installedVersion" required:"false" example:"1.1.1l"`
	CreatedBy        string `json:"createdBy" readOnly:"true"`
}

type ImageAttestation struct {
	Digest        string                    `json:"digest"`
	MediaType     string                    `json:"mediaType"`
	ArtifactType  string                    `json:"artifactType,omitempty"`
	PredicateType string                    `json:"predicateType"`
	StatementType string                    `json:"statementType,omitempty"`
	Platform      string                    `json:"platform,omitempty"`
	Subject       []ImageAttestationSubject `json:"subject"`
	Statement     jsontext.Value            `json:"statement,omitempty"`
	Size          int64                     `json:"size"`
}

type ImageAttestationList struct {
	ImageRef      string             `json:"imageRef"`
	SubjectDigest string             `json:"subjectDigest"`
	Platform      string             `json:"platform,omitempty"`
	Attestations  []ImageAttestation `json:"attestations"`
}

type ImageAttestationSubject struct {
	Digest map[string]string `json:"digest"`
	Name   string            `json:"name"`
}

type ImageBuildRecord struct {
	CreatedAt       time.Time         `json:"createdAt" sortable:"true"`
	BuildArgs       map[string]string `json:"buildArgs,omitempty"`
	UserID          *string           `json:"userId,omitempty"`
	Username        *string           `json:"username,omitempty"`
	Digest          *string           `json:"digest,omitempty"`
	ErrorMessage    *string           `json:"errorMessage,omitempty"`
	Output          *string           `json:"output,omitempty"`
	CompletedAt     *time.Time        `json:"completedAt,omitempty" sortable:"true"`
	DurationMs      *int64            `json:"durationMs,omitempty"`
	Labels          map[string]string `json:"labels,omitempty"`
	Ulimits         map[string]string `json:"ulimits,omitempty"`
	ID              string            `json:"id" sortable:"true"`
	EnvironmentID   string            `json:"environmentId"`
	EnvironmentName string            `json:"environmentName,omitempty"`
	Status          string            `json:"status" sortable:"true"`
	Provider        string            `json:"provider,omitempty"`
	ContextDir      string            `json:"contextDir"`
	Dockerfile      string            `json:"dockerfile,omitempty"`
	Target          string            `json:"target,omitempty"`
	Network         string            `json:"network,omitempty"`
	Isolation       string            `json:"isolation,omitempty"`
	Tags            []string          `json:"tags,omitempty"`
	Platforms       []string          `json:"platforms,omitempty"`
	CacheFrom       []string          `json:"cacheFrom,omitempty"`
	CacheTo         []string          `json:"cacheTo,omitempty"`
	Entitlements    []string          `json:"entitlements,omitempty"`
	ExtraHosts      []string          `json:"extraHosts,omitempty"`
	ShmSize         int64             `json:"shmSize,omitempty"`
	NoCache         bool              `json:"noCache"`
	Pull            bool              `json:"pull"`
	Privileged      bool              `json:"privileged"`
	Push            bool              `json:"push"`
	Load            bool              `json:"load"`
	OutputTruncated bool              `json:"outputTruncated"`
}

type ImageDetailSummary struct {
	GraphDriver struct {
		Data any    `json:"data"`
		Name string `json:"name"`
	} `json:"graphDriver"`
	Os           string `json:"os"`
	Created      string `json:"created"`
	Author       string `json:"author"`
	Architecture string `json:"architecture"`
	ID           string `json:"id"`
	Metadata     struct {
		LastTagTime string `json:"lastTagTime"`
	} `json:"metadata"`
	Comment    string `json:"comment"`
	Descriptor struct {
		MediaType string `json:"mediaType"`
		Digest    string `json:"digest"`
		Size      int64  `json:"size"`
	} `json:"descriptor"`
	RootFs struct {
		Type   string   `json:"type"`
		Layers []string `json:"layers"`
	} `json:"rootFs"`
	RepoTags         []string           `json:"repoTags"`
	RepoDigests      []string           `json:"repoDigests"`
	PinnedReferences []string           `json:"pinnedReferences,omitempty"`
	Hardened         *HardenedImageInfo `json:"hardened,omitempty"`
	UpdateInfo       *ImageUpdateInfo   `json:"updateInfo,omitempty"`
	Config           struct {
		ExposedPorts map[string]struct{} `json:"exposedPorts,omitempty"`
		Volumes      map[string]struct{} `json:"volumes,omitempty"`
		WorkingDir   string              `json:"workingDir,omitempty"`
		Env          []string            `json:"env,omitempty"`
		Cmd          []string            `json:"cmd,omitempty"`
		ArgsEscaped  bool                `json:"argsEscaped,omitempty"`
	} `json:"config"`
	Size int64 `json:"size"`
}

type ImageExposure string

type ImageHistoryItem struct {
	ID        string   `json:"id"`
	CreatedBy string   `json:"createdBy"`
	Comment   string   `json:"comment"`
	Tags      []string `json:"tags"`
	Created   int64    `json:"created"`
	Size      int64    `json:"size"`
}

type ImageListResponse struct {
	Data []ImageSummary `json:"data" doc:"Array of items for the current page"`

	FailedEnvironments []EnvironmentFailure `json:"failedEnvironments,omitempty" doc:"Environments whose results are missing from a multi-environment response"`
	Pagination         PaginationResponse   `json:"pagination" doc:"Pagination metadata"`

	MaxImageUploadSize int `json:"maxImageUploadSize" doc:"Maximum image archive upload size in MB"`

	Success bool `json:"success" doc:"Whether the request was successful"`
}

type ImageLoadResult struct {
	Stream string `json:"stream"`
}

type ImagePruneReport struct {
	ImagesDeleted []string `json:"imagesDeleted"`

	SpaceReclaimed int64 `json:"spaceReclaimed"`
}

type ImagePullOptions struct {
	ImageName string `json:"imageName" minLength:"1" doc:"Name of the image to pull (e.g., nginx)"`

	Tag         string                        `json:"tag,omitempty" doc:"Tag of the image to pull (e.g., latest)"`
	Auth        *ContainerRegistryCredential  `json:"auth,omitempty"`
	Credentials []ContainerRegistryCredential `json:"credentials,omitempty"`
}

type ImageReleaseNotes struct {
	ImageRef    string `json:"imageRef"`
	Version     string `json:"version,omitempty"`
	Status      string `json:"status"`
	SourceURL   string `json:"sourceUrl,omitempty"`
	ReleaseURL  string `json:"releaseUrl,omitempty"`
	ReleaseName string `json:"releaseName,omitempty"`
	Notes       string `json:"notes,omitempty"`
	PublishedAt string `json:"publishedAt,omitempty"`
}

type ImageSearchResult struct {
	Name        string `json:"name"`
	Description string `json:"description"`
	StarCount   int    `json:"starCount"`
	Official    bool   `json:"official"`
	Automated   bool   `json:"automated"`
}

type ImageSummary struct {
	Labels            map[string]any            `json:"labels"`
	UpdateInfo        *ImageUpdateInfo          `json:"updateInfo,omitempty"`
	VulnerabilityScan *VulnerabilityScanSummary `json:"vulnerabilityScan,omitempty"`
	Hardened          *HardenedImageInfo        `json:"hardened,omitempty"`

	EnvironmentTag
	ID               string        `json:"id" sortable:"true"`
	Repo             string        `json:"repo" sortable:"true"`
	Tag              string        `json:"tag" sortable:"true"`
	RepoTags         []string      `json:"repoTags"`
	RepoDigests      []string      `json:"repoDigests"`
	UsedBy           []ImageUsedBy `json:"usedBy,omitempty"`
	PinnedReferences []string      `json:"pinnedReferences,omitempty"`

	Created     int64 `json:"created" sortable:"true"`
	Size        int64 `json:"size" sortable:"true"`
	VirtualSize int64 `json:"virtualSize"`
	InUse       bool  `json:"inUse" sortable:"true"`
}

type ImageTagRequest struct {
	Repository string `json:"repository" doc:"Target repository name"`

	Tag string `json:"tag,omitempty" doc:"Target tag"`
}

type ImageUpdateBatchResponse map[string]*ImageUpdateResponse

type ImageUpdateCheckRequest struct {
	ImageRefs []string `json:"imageRefs,omitempty"`
	All       bool     `json:"all,omitempty"`
}

type ImageUpdateInfo struct {
	CheckTime      time.Time `json:"checkTime"`
	UpdateType     string    `json:"updateType"`
	CurrentVersion string    `json:"currentVersion"`
	LatestVersion  string    `json:"latestVersion"`
	CurrentDigest  string    `json:"currentDigest"`
	LatestDigest   string    `json:"latestDigest"`

	CurrentCreated *time.Time `json:"currentCreated,omitempty"`

	LatestCreated *time.Time `json:"latestCreated,omitempty"`
	Error         string     `json:"error"`
	AuthMethod    string     `json:"authMethod,omitempty"`
	AuthUsername  string     `json:"authUsername,omitempty"`
	AuthRegistry  string     `json:"authRegistry,omitempty"`

	ResponseTimeMs int  `json:"responseTimeMs"`
	HasUpdate      bool `json:"hasUpdate"`
	UsedCredential bool `json:"usedCredential,omitempty"`
}

type ImageUpdateResponse struct {
	CheckTime        time.Time                       `json:"checkTime"`
	ImageUpdate      *ImageUpdateResponse            `json:"imageUpdate,omitempty"`
	ContainerUpdates map[string]*ImageUpdateResponse `json:"containerUpdates,omitempty"`
	ActivityID       *string                         `json:"activityId,omitempty"`
	ImageRef         string                          `json:"imageRef,omitempty"`
	UpdateType       string                          `json:"updateType"`
	CurrentVersion   string                          `json:"currentVersion"`
	LatestVersion    string                          `json:"latestVersion,omitempty"`
	CurrentDigest    string                          `json:"currentDigest,omitempty"`
	LatestDigest     string                          `json:"latestDigest,omitempty"`

	CurrentCreated *time.Time `json:"currentCreated,omitempty"`

	LatestCreated *time.Time `json:"latestCreated,omitempty"`
	Error         string     `json:"error,omitempty"`
	AuthMethod    string     `json:"authMethod,omitempty"`
	AuthUsername  string     `json:"authUsername,omitempty"`
	AuthRegistry  string     `json:"authRegistry,omitempty"`
	ReleaseURL    string     `json:"releaseUrl,omitempty"`

	ResponseTimeMs int  `json:"responseTimeMs"`
	HasUpdate      bool `json:"hasUpdate"`
	UsedCredential bool `json:"usedCredential,omitempty"`
}

type ImageUpdateSummary struct {
	TotalImages       int `json:"totalImages"`
	ImagesWithUpdates int `json:"imagesWithUpdates"`
	DigestUpdates     int `json:"digestUpdates"`
	ErrorsCount       int `json:"errorsCount"`
}

type ImageUsageCounts struct {
	Inuse  int `json:"imagesInuse"`
	Unused int `json:"imagesUnused"`
	Total  int `json:"totalImages"`

	HardenedEndingSoon int `json:"hardenedEndingSoon" doc:"Hardened images whose end of life is near"`
	HardenedEndOfLife  int `json:"hardenedEndOfLife" doc:"Hardened images past their end of life"`

	TotalSize int64 `json:"totalImageSize"`
}

type ImageUsedBy struct {
	Type string `json:"type"`
	Name string `json:"name"`
	ID   string `json:"id,omitempty"`
}

type ImportGitOpsSyncRequest struct {
	GitOpsPreDeployConfigRequest

	SyncDirectory *bool `json:"syncDirectory,omitempty"`

	// 0 means unlimited; env var overrides take precedence.
	MaxSyncFiles *int `json:"maxSyncFiles,omitempty"`

	MaxSyncTotalSize *int64 `json:"maxSyncTotalSize,omitempty"`

	MaxSyncBinarySize  *int64 `json:"maxSyncBinarySize,omitempty"`
	PullImageAfterSync *bool  `json:"pullImageAfterSync,omitempty"`
	RedeployAfterSync  *bool  `json:"redeployAfterSync,omitempty"`
	SyncName           string `json:"syncName"`
	GitRepo            string `json:"gitRepo"`
	Branch             string `json:"branch"`
	DockerComposePath  string `json:"dockerComposePath"`

	ProjectName string `json:"projectName,omitempty"`

	SyncInterval int  `json:"syncInterval"`
	AutoSync     bool `json:"autoSync"`
}

type ImportGitOpsSyncResponse struct {
	Errors       []string `json:"errors"`
	SuccessCount int      `json:"successCount"`
	FailedCount  int      `json:"failedCount"`
}

type JobController interface {
	GetJob(jobID string) (SchedulerJob, bool)
	GetJobRuntimeState(jobID string) (JobRuntimeState, bool)
	AddJob(ctx context.Context, job SchedulerJob) error
	RunBusWatcherNow(ctx context.Context, watcherID string) error
}

type JobListResponse struct {
	ObservedAt  time.Time   `json:"observedAt"`
	Timezone    string      `json:"timezone,omitempty"`
	Jobs        []JobStatus `json:"jobs"`
	DurableRuns bool        `json:"durableRuns"`
	Offline     bool        `json:"offline,omitempty"`
	IsAgent     bool        `json:"isAgent"`
}

type JobListRunsInput struct {
	ID    string `path:"id"`
	JobID string `path:"jobId" minLength:"1"`
	Page  int    `query:"page" default:"1" minimum:"1"`
	Limit int    `query:"limit" default:"20" minimum:"1" maximum:"100"`
}

type JobListRunsOutput struct{ Body SchedulerRunList }

type JobMetadata struct {
	ID             string
	Name           string
	Description    string
	Category       string
	SettingsKey    string
	EnabledKey     string
	Prerequisites  []JobPrerequisiteMetadata
	ManagerOnly    bool
	IsContinuous   bool
	CanRunManually bool
}

type JobPrerequisite struct {
	SettingKey string `json:"settingKey"`
	Label      string `json:"label"`
	IsMet      bool   `json:"isMet"`
}

type JobPrerequisiteMetadata struct {
	SettingKey string
	Label      string
}

type JobRunInput struct {
	ID    string `path:"id"`
	JobID string `path:"jobId" minLength:"1"`
	RunID string `path:"runId" format:"uuid"`
}

type JobRunOutput struct{ Body SchedulerRun }

type JobRunResponse struct {
	RunID   string    `json:"runId,omitempty"`
	Status  RunStatus `json:"status,omitempty"`
	Message string    `json:"message"`
	Success bool      `json:"success"`
}

type JobRuntimeState struct {
	NextRun   *time.Time
	Schedule  string
	Scheduled bool
}

type JobScheduleConfig struct {
	EnvironmentHealthInterval      string `json:"environmentHealthInterval" required:"false"`
	EventCleanupInterval           string `json:"eventCleanupInterval" required:"false"`
	ExpiredSessionsCleanupInterval string `json:"expiredSessionsCleanupInterval" required:"false"`
	AutoUpdateInterval             string `json:"autoUpdateInterval" required:"false"`
	DockerClientRefreshInterval    string `json:"dockerClientRefreshInterval" required:"false"`
	PollingInterval                string `json:"pollingInterval" required:"false"`
	ScheduledPruneInterval         string `json:"scheduledPruneInterval" required:"false"`
	VulnerabilityScanInterval      string `json:"vulnerabilityScanInterval" required:"false"`
	ImageAutoPatchInterval         string `json:"imageAutoPatchInterval" required:"false"`
	AutoHealInterval               string `json:"autoHealInterval" required:"false"`
}

type JobScheduler interface {
	ListRegisteredJobs() []SchedulerJob
	WorkerController
	DynamicScheduler
	JobController

	RegisterJob(job SchedulerJob) error
	RegisterBusWatcher(watcher BusWatcher, canRunManually bool) error
	StartScheduler(ctx context.Context) error
	GetLocation() *time.Location
	Stop(ctx context.Context) error
}

type JobStatus struct {
	CurrentRun     *SchedulerRun          `json:"currentRun,omitempty"`
	LastRun        *SchedulerRun          `json:"lastRun,omitempty"`
	LastSuccess    *time.Time             `json:"lastSuccess,omitempty"`
	WorkerHealth   *SchedulerWorkerHealth `json:"workerHealth,omitempty"`
	NextRun        *time.Time             `json:"nextRun,omitempty"`
	LastError      string                 `json:"lastError,omitempty"`
	ID             string                 `json:"id"`
	Name           string                 `json:"name"`
	Description    string                 `json:"description"`
	Category       string                 `json:"category"`
	Schedule       string                 `json:"schedule"`
	SettingsKey    string                 `json:"settingsKey,omitempty"`
	Children       []JobStatus            `json:"children,omitempty"`
	Prerequisites  []JobPrerequisite      `json:"prerequisites"`
	Enabled        bool                   `json:"enabled"`
	ManagerOnly    bool                   `json:"managerOnly"`
	IsContinuous   bool                   `json:"isContinuous"`
	CanRunManually bool                   `json:"canRunManually"`
}

type JobSubmitRunInput struct {
	RunID string `json:"runId"`
}

type JsonObject map[string]any

type KubeDownPod struct {
	ID string `json:"id"`
}

type KubeDownReport struct {
	StopReport []KubeDownPod `json:"stopReport"`
	RmReport   []KubeDownPod `json:"rmReport"`
}

type KubeDownRequest struct {
	YAML  string `json:"yaml" minLength:"1" doc:"Kubernetes YAML to tear down"`
	Force bool   `json:"force,omitempty" doc:"Also remove volumes created by the YAML"`
}

type KubeGenerateRequest struct {
	Type    KubeGenerateType `json:"type,omitempty" enum:"pod,service,deployment,daemonset,job" doc:"Kubernetes kind to generate"`
	Names   []string         `json:"names" minItems:"1" doc:"Pods, containers, or volumes to include"`
	Service bool             `json:"service,omitempty" doc:"Also generate a Kubernetes service"`
}

type KubeGenerateResponse struct {
	YAML string `json:"yaml"`
}

type KubeGenerateType string

type KubePlayPod struct {
	ID              string   `json:"id"`
	Containers      []string `json:"containers"`
	InitContainers  []string `json:"initContainers"`
	Logs            []string `json:"logs"`
	ContainerErrors []string `json:"containerErrors"`
}

type KubePlayReport struct {
	ExitCode           *int32           `json:"exitCode,omitempty"`
	ServiceContainerID string           `json:"serviceContainerId,omitempty"`
	Pods               []KubePlayPod    `json:"pods"`
	Volumes            []KubePlayVolume `json:"volumes"`
}

type KubePlayRequest struct {
	Start    *bool    `json:"start,omitempty" doc:"Start the pods after creating them"`
	YAML     string   `json:"yaml" minLength:"1" doc:"Kubernetes YAML to play"`
	Networks []string `json:"networks,omitempty" doc:"Networks to attach the pods to"`
	Replace  bool     `json:"replace,omitempty" doc:"Replace existing pods and containers"`
}

type KubePlayVolume struct {
	Name string `json:"name"`
}

type LifecycleExtraMount struct {
	Source   string
	Target   string
	Readonly bool
}

type LogStreamOptions struct {
	Tail       string
	Since      string
	Follow     bool
	Timestamps bool
}

type MFAChallenge struct {
	ExpiresAt     time.Time `json:"expiresAt" doc:"MFA transaction expiration time"`
	Options       any       `json:"options" doc:"WebAuthn assertion options"`
	TransactionID string    `json:"transactionId" doc:"Opaque MFA transaction identifier"`
	Method        string    `json:"method" doc:"MFA method"`
}

type MemoryInfo struct {
	Alloc         uint64  `json:"alloc"`
	TotalAlloc    uint64  `json:"totalAlloc"`
	Sys           uint64  `json:"sys"`
	HeapAlloc     uint64  `json:"heapAlloc"`
	HeapSys       uint64  `json:"heapSys"`
	HeapInuse     uint64  `json:"heapInuse"`
	HeapIdle      uint64  `json:"heapIdle"`
	HeapReleased  uint64  `json:"heapReleased"`
	HeapObjects   uint64  `json:"heapObjects"`
	StackInuse    uint64  `json:"stackInuse"`
	StackSys      uint64  `json:"stackSys"`
	MSpanInuse    uint64  `json:"mspanInuse"`
	MCacheInuse   uint64  `json:"mcacheInuse"`
	NextGC        uint64  `json:"nextGc"`
	NumGC         uint32  `json:"numGc"`
	NumForcedGC   uint32  `json:"numForcedGc"`
	GCCPUFraction float64 `json:"gcCpuFraction"`
}

type MessageResponse struct {
	ActivityID *string `json:"activityId,omitempty" doc:"Background activity ID tracking this action"`
	Message    string  `json:"message" doc:"Response message"`
}

type MobilePasskeyCompletion struct {
	ExpiresAt     time.Time `json:"expiresAt" doc:"Mobile passkey transaction expiration time"`
	TransactionID string    `json:"transactionId" doc:"Opaque mobile passkey transaction identifier"`
}

type Network struct {
	Name    string               `json:"name" required:"false" doc:"Name of the network"`
	Options NetworkCreateOptions `json:"options" required:"false" doc:"Network creation options"`
}

type NetworkContainerEndpoint struct {
	ID          string `json:"id"`
	Name        string `json:"name"`
	EndpointID  string `json:"endpointId"`
	IPv4Address string `json:"ipv4Address"`
	IPv6Address string `json:"ipv6Address"`
	MacAddress  string `json:"macAddress"`
}

type NetworkContainerRequest struct {
	ContainerID string   `json:"containerId" minLength:"1" doc:"Container ID or name"`
	IPv4Address string   `json:"ipv4Address,omitempty" doc:"Static IPv4 address (connect only)"`
	IPv6Address string   `json:"ipv6Address,omitempty" doc:"Static IPv6 address (connect only)"`
	Aliases     []string `json:"aliases,omitempty" doc:"Network-scoped aliases (connect only)"`
	Force       bool     `json:"force,omitempty" doc:"Force the disconnect (disconnect only)"`
}

type NetworkCreateOptions struct {
	IPAM           *NetworkIPAM      `json:"ipam,omitempty" doc:"IP Address Management configuration"`
	Options        map[string]string `json:"options,omitempty" doc:"Driver-specific options"`
	Labels         map[string]string `json:"labels,omitempty" doc:"User-defined labels"`
	Driver         string            `json:"driver,omitempty" doc:"Network driver (e.g., bridge, overlay)"`
	CheckDuplicate bool              `json:"checkDuplicate,omitempty" doc:"Check for duplicate network names"`
	Internal       bool              `json:"internal,omitempty" doc:"Restrict external access to the network"`
	Attachable     bool              `json:"attachable,omitempty" doc:"Allow manual container attachment"`
	Ingress        bool              `json:"ingress,omitempty" doc:"Enable routing-mesh for swarm cluster"`
	EnableIPv6     bool              `json:"enableIPv6,omitempty" doc:"Enable IPv6 networking"`
}

type NetworkCreateResponse struct {
	ActivityID *string `json:"activityId,omitempty"`
	ID         string  `json:"id"`
	Warning    string  `json:"warning,omitempty"`
}

type NetworkIPAM struct {
	Driver  string              `json:"driver,omitempty"`
	Options map[string]string   `json:"options,omitempty"`
	Config  []NetworkIPAMConfig `json:"config,omitempty"`
}

type NetworkIPAMConfig struct {
	AuxAddress map[string]string `json:"auxAddress,omitempty"`
	Subnet     string            `json:"subnet,omitempty"`
	Gateway    string            `json:"gateway,omitempty"`
	IPRange    string            `json:"ipRange,omitempty"`
}

type NetworkInspect struct {
	ID             string                              `json:"id"`
	Name           string                              `json:"name"`
	Driver         string                              `json:"driver"`
	Scope          string                              `json:"scope"`
	Created        time.Time                           `json:"created"`
	IPAM           NetworkIPAM                         `json:"ipam"`
	ConfigFrom     network.ConfigReference             `json:"configFrom"`
	Containers     map[string]network.EndpointResource `json:"containers"`
	Options        map[string]string                   `json:"options"`
	Labels         map[string]string                   `json:"labels"`
	Peers          []network.PeerInfo                  `json:"peers,omitempty"`
	Services       map[string]network.ServiceInfo      `json:"services,omitempty"`
	ContainersList []NetworkContainerEndpoint          `json:"containersList"`
	EnableIPv4     bool                                `json:"enableIPv4"`
	EnableIPv6     bool                                `json:"enableIPv6"`
	Internal       bool                                `json:"internal"`
	Attachable     bool                                `json:"attachable"`
	Ingress        bool                                `json:"ingress"`
	ConfigOnly     bool                                `json:"configOnly"`
}