v1

type PhaseTransition struct {
	// Phase is the phase that was entered (e.g. "Queued", "Initializing", "Executing", "Succeeded", "Failed").
	Phase string `json:"phase"`

	// OccurredAt is when this phase transition happened.
	OccurredAt metav1.Time `json:"occurredAt"`

	// Message is an optional human-readable message about the transition.
	// +optional
	Message string `json:"message,omitempty"`
}

type TaskAction struct {
	metav1.TypeMeta `json:",inline"`

	// metadata is a standard object metadata
	// +optional
	metav1.ObjectMeta `json:"metadata,omitempty,omitzero"`

	// spec defines the desired state of TaskAction
	// +required
	Spec TaskActionSpec `json:"spec"`

	// status defines the observed state of TaskAction
	// +optional
	Status TaskActionStatus `json:"status,omitempty,omitzero"`
}

type TaskActionConditionReason string

type TaskActionConditionType string

type TaskActionList struct {
	metav1.TypeMeta `json:",inline"`
	metav1.ListMeta `json:"metadata,omitempty"`
	Items           []TaskAction `json:"items"`
}

type TaskActionSpec struct {
	// RunName is the name of the run this action belongs to
	// +kubebuilder:validation:Required
	// +kubebuilder:validation:MinLength=1
	// +kubebuilder:validation:MaxLength=30
	RunName string `json:"runName"`

	// Org this action belongs to
	// +kubebuilder:validation:Required
	// +kubebuilder:validation:MinLength=1
	// +kubebuilder:validation:MaxLength=63
	Org string `json:"org"`

	// Project this action belongs to
	// +kubebuilder:validation:Required
	// +kubebuilder:validation:MinLength=1
	// +kubebuilder:validation:MaxLength=63
	Project string `json:"project"`

	// Domain this action belongs to
	// +kubebuilder:validation:Required
	// +kubebuilder:validation:MinLength=1
	// +kubebuilder:validation:MaxLength=63
	Domain string `json:"domain"`

	// ActionName is the unique name of this action within the run
	// +kubebuilder:validation:Required
	// +kubebuilder:validation:MinLength=1
	// +kubebuilder:validation:MaxLength=30
	ActionName string `json:"actionName"`

	// ParentActionName is the optional name of the parent action
	// +optional
	// +kubebuilder:validation:MinLength=1
	// +kubebuilder:validation:MaxLength=30
	ParentActionName *string `json:"parentActionName,omitempty"`

	// InputURI is the path to the input data for this action
	// +kubebuilder:validation:Required
	// +kubebuilder:validation:MinLength=1
	InputURI string `json:"inputUri"`

	// RunOutputBase is the base path where this action should write its output
	// +kubebuilder:validation:Required
	// +kubebuilder:validation:MinLength=1
	RunOutputBase string `json:"runOutputBase"`

	// TaskType identifies which plugin handles this task (e.g. "container", "spark", "ray")
	// +kubebuilder:validation:Required
	// +kubebuilder:validation:MinLength=1
	// +kubebuilder:validation:MaxLength=63
	TaskType string `json:"taskType"`

	// ShortName is the human-readable display name for this task
	// +optional
	// +kubebuilder:validation:MaxLength=63
	ShortName string `json:"shortName,omitempty"`

	// TaskTemplate is the proto-serialized core.TaskTemplate stored inline in etcd
	// +kubebuilder:validation:Required
	TaskTemplate []byte `json:"taskTemplate"`
}

type TaskActionStatus struct {

	// StateJSON is the JSON serialized NodeStatus that was last sent to the State Service
	// +optional
	StateJSON string `json:"stateJson,omitempty"`

	// PluginState is the Gob-encoded plugin state from the last reconciliation round.
	// +optional
	PluginState []byte `json:"pluginState,omitempty"`

	// PluginStateVersion tracks the version of the plugin state schema for compatibility.
	// +optional
	PluginStateVersion uint8 `json:"pluginStateVersion,omitempty"`

	// PluginPhase is a human-readable representation of the plugin's current phase.
	// +optional
	PluginPhase string `json:"pluginPhase,omitempty"`

	// PluginPhaseVersion is the version of the current plugin phase.
	// +optional
	PluginPhaseVersion uint32 `json:"pluginPhaseVersion,omitempty"`

	// conditions represent the current state of the TaskAction resource.
	// Each condition has a unique type and reflects the status of a specific aspect of the resource.
	//
	// Standard condition types include:
	// - "Available": the resource is fully functional
	// - "Progressing": the resource is being created or updated
	// - "Degraded": the resource failed to reach or maintain its desired state
	//
	// The status of each condition is one of True, False, or Unknown.
	// +listType=map
	// +listMapKey=type
	// +optional
	Conditions []metav1.Condition `json:"conditions,omitempty"`

	// PhaseHistory is an append-only log of phase transitions. Unlike conditions
	// (which are updated in-place by type), this preserves the full timeline:
	// Queued → Initializing → Executing → Succeeded/Failed, each with a timestamp.
	// +optional
	PhaseHistory []PhaseTransition `json:"phaseHistory,omitempty"`
}