v1beta1

type ConfigMount struct {
	// Name of a ConfigMap in the same namespace.
	// +kubebuilder:validation:Required
	// +kubebuilder:validation:MinLength=1
	Name string `json:"name"`

	// MountPath is the absolute directory the ConfigMap keys are projected to.
	// +kubebuilder:validation:Required
	// +kubebuilder:validation:MinLength=1
	// +kubebuilder:validation:Pattern=`^/[^\p{Cc}]*$`
	MountPath string `json:"mountPath"`
}

type LightspeedStackSpec struct {
	// BaseURL of the Lightspeed Stack OpenAI-compatible endpoint,
	// e.g. "https://lightspeed-app-server.openstack.svc:8443/v1".
	// Exposed to the assistant container as the LIGHTSPEED_URL env var.
	// +kubebuilder:validation:Required
	// +kubebuilder:validation:MinLength=1
	// +kubebuilder:validation:Pattern=`^https?://[^\p{Cc}]+$`
	BaseURL string `json:"baseURL"`

	// Model identifier, e.g. "gemini/models/gemini-2.5-flash".
	// Exposed to the assistant container as the LIGHTSPEED_MODEL env var.
	// +kubebuilder:validation:Required
	// +kubebuilder:validation:MinLength=1
	Model string `json:"model"`

	// AdditionalModels are extra models the agent may select per subagent, e.g.
	// a heavier model for adversarial cross-review or a cheaper model for simple
	// tasks. Exposed to the container as the LIGHTSPEED_ADDITIONAL_MODELS env var
	// (JSON) for the image entrypoint to render into the harness config.
	// +kubebuilder:validation:Optional
	// +listType=map
	// +listMapKey=name
	AdditionalModels []ModelRef `json:"additionalModels,omitempty"`
}

type MCPServerRef struct {
	// Name is the MCP server name. It is used to derive the
	// MCP_SERVER_<name> environment variable, so it must be a valid
	// environment-variable name: start with a letter or underscore and
	// contain only letters, digits, and underscores (no dashes).
	// +kubebuilder:validation:Required
	// +kubebuilder:validation:MinLength=1
	// +kubebuilder:validation:MaxLength=63
	// +kubebuilder:validation:Pattern=`^[a-zA-Z_][a-zA-Z0-9_]*$`
	Name string `json:"name"`

	// URL is the MCP server's Streamable HTTP endpoint.
	// Mutually exclusive with OpenStackClientRef.
	// +kubebuilder:validation:Optional
	// +kubebuilder:validation:MinLength=1
	// ensures that a string contains no control characters
	// +kubebuilder:validation:Pattern=`^[^\p{Cc}]*$`
	URL string `json:"url,omitempty"`

	// OpenStackClientRef is the name of an OpenStackClient CR in the same
	// namespace that has MCP enabled. The controller reads the service URL
	// published in the OpenStackClient status.
	// Mutually exclusive with URL.
	// +kubebuilder:validation:Optional
	// +kubebuilder:validation:MinLength=1
	OpenStackClientRef string `json:"openstackClientRef,omitempty"`
}

type ModelRef struct {
	// Name is the model identifier, e.g. "gemini/models/gemini-2.5-pro".
	// +kubebuilder:validation:Required
	// +kubebuilder:validation:MinLength=1
	Name string `json:"name"`

	// BaseURL overrides the LightspeedStack BaseURL for this model. When empty
	// the LightspeedStack BaseURL is used.
	// +kubebuilder:validation:Optional
	// +kubebuilder:validation:Pattern=`^https?://[^\p{Cc}]+$`
	BaseURL string `json:"baseURL,omitempty"`
}

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

	Spec   OpenStackAssistantSpec   `json:"spec,omitempty"`
	Status OpenStackAssistantStatus `json:"status,omitempty"`
}

type OpenStackAssistantDefaults struct {
	ContainerImageURL string
}

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

type OpenStackAssistantSpec struct {
	// ContainerImage is the agent/harness image (will be set to the
	// environmental default if empty). Its baked-in entrypoint is responsible
	// for rendering harness config from the env vars and mounts the operator
	// provides.
	// +kubebuilder:validation:Required
	ContainerImage string `json:"containerImage"`

	// LightspeedStack configuration for the AI backend (base URL + model).
	// +kubebuilder:validation:Required
	LightspeedStack LightspeedStackSpec `json:"lightspeedStack"`

	// ExtraConfig is a list of ConfigMaps to project into the pod at chosen
	// paths for the image entrypoint to consume (recipes, skills, hints,
	// system prompts, etc. - all harness-defined).
	// +kubebuilder:validation:Optional
	// +listType=map
	// +listMapKey=name
	ExtraConfig []ConfigMount `json:"extraConfig,omitempty"`

	// MCPServers lists MCP server endpoints to expose to the assistant. Each
	// entry is exported to the pod as an MCP_SERVER_<name> environment variable.
	// +kubebuilder:validation:Optional
	// +listType=map
	// +listMapKey=name
	MCPServers []MCPServerRef `json:"mcpServers,omitempty"`

	// +kubebuilder:validation:Optional
	// +operator-sdk:csv:customresourcedefinitions:type=spec
	// Secret containing any CA certificates which should be added to the assistant pod.
	tls.Ca `json:",inline"`

	// Storage configures the writable working directory (also HOME) used for the
	// agent's configuration, sessions, and runtime state. Defaults to an emptyDir
	// mounted at /home/goose; an existing PVC can be used to persist its contents.
	// +kubebuilder:validation:Optional
	Storage *StorageSpec `json:"storage,omitempty"`

	// Resources defines the compute resource requirements for the assistant
	// container. This is useful for agent workloads that run concurrent processes.
	// +kubebuilder:validation:Optional
	Resources corev1.ResourceRequirements `json:"resources,omitempty"`

	// NodeSelector to target subset of worker nodes for pod scheduling.
	// +kubebuilder:validation:Optional
	NodeSelector *map[string]string `json:"nodeSelector,omitempty"`

	// Env is a list of additional environment variables for the container.
	// +kubebuilder:validation:Optional
	// +listType=map
	// +listMapKey=name
	Env []corev1.EnvVar `json:"env,omitempty"`
}

type OpenStackAssistantStatus struct {
	// PodName is the name of the running assistant pod
	PodName string `json:"podName,omitempty"`

	// Conditions tracks the state of each sub-resource
	Conditions condition.Conditions `json:"conditions,omitempty" optional:"true"`

	// ObservedGeneration - the most recent generation observed
	ObservedGeneration int64 `json:"observedGeneration,omitempty"`

	// Hash tracks input hashes to detect changes
	Hash map[string]string `json:"hash,omitempty"`
}

type StorageSpec struct {
	// MountPath is the writable working directory, also exported as HOME.
	// +kubebuilder:validation:Optional
	// +kubebuilder:default=/home/goose
	// +kubebuilder:validation:Pattern=`^/[^\p{Cc}]*$`
	MountPath string `json:"mountPath,omitempty"`

	// PVCName, when set, backs the working directory with an existing
	// PersistentVolumeClaim instead of an ephemeral emptyDir, persisting state
	// across pod replacement and node reboots.
	// +kubebuilder:validation:Optional
	// +kubebuilder:validation:MinLength=1
	PVCName string `json:"pvcName,omitempty"`
}