v1alpha1

type ModelAdapter struct {
	metav1.TypeMeta   `json:",inline"`
	metav1.ObjectMeta `json:"metadata,omitempty"`

	Spec   ModelAdapterSpec   `json:"spec,omitempty"`
	Status ModelAdapterStatus `json:"status,omitempty"`
}

type ModelAdapterConditionType string

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

type ModelAdapterPhase string

type ModelAdapterSpec struct {

	// BaseModel is the identifier for the base model to which the ModelAdapter will be attached.
	// +optional
	BaseModel *string `json:"baseModel,omitempty"`

	// PodSelector is a label query over pods that should match the ModelAdapter configuration.
	// +kubebuilder:validation:Required
	PodSelector *metav1.LabelSelector `json:"podSelector,omitempty"`

	// SchedulerName is the name of the scheduler to use for scheduling the ModelAdapter.
	// +optional
	// +kubebuilder:default=default
	SchedulerName string `json:"schedulerName,omitempty"`

	// ArtifactURL is the address of the model artifact to be downloaded. Different protocol is supported like s3,gcs,huggingface
	// +kubebuilder:validation:Required
	ArtifactURL string `json:"artifactURL,omitempty"`

	// CredentialsSecretRef points to the secret used to authenticate the artifact download requests
	// +optional
	CredentialsSecretRef *corev1.LocalObjectReference `json:"credentialsSecretRef,omitempty"`

	// Replicas controls adapter distribution across pods:
	// - nil (omitted): Load adapter on ALL matching pods (recommended)
	// - 1: Load adapter on a single pod selected by the scheduler
	// Only nil or 1 are supported. Other values will be rejected.
	// +optional
	// +kubebuilder:validation:Enum=1
	Replicas *int32 `json:"replicas,omitempty"`

	// Additional fields can be added here to customize the scheduling and deployment
	// +optional
	AdditionalConfig map[string]string `json:"additionalConfig,omitempty"`
}

type ModelAdapterStatus struct {
	// Phase is a simple, high-level summary of where the ModelAdapter is in its lifecycle
	// Phase maps to latest status.conditions.type
	// +optional
	Phase ModelAdapterPhase `json:"phase,omitempty"`

	// Candidates is the total number of pods matching the selector (candidate pods for adapter loading)
	// +optional
	Candidates int32 `json:"candidates,omitempty"`

	// ReadyReplicas is the number of adapter replicas successfully loaded and ready
	// +optional
	ReadyReplicas int32 `json:"readyReplicas,omitempty"`

	// DesiredReplicas is the desired number of adapter replicas based on spec.replicas
	// - If replicas is nil: equals candidates (load on all)
	// - If replicas is 1: equals 1 (single pod)
	// +optional
	DesiredReplicas int32 `json:"desiredReplicas,omitempty"`

	// Conditions represents the observation of a model adapter's current state.
	// +patchMergeKey=type
	// +patchStrategy=merge
	// +optional
	Conditions []metav1.Condition `json:"conditions,omitempty"`

	// Instances lists all pod instances of ModelAdapter
	// +optional
	Instances []string `json:"instances,omitempty"`
}