/* Copyright 2026 LocoStack. Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. */ package templates import ( "fmt" "maps" "slices" "github.com/LocoStack/loco-operator/api/v1alpha1" "github.com/LocoStack/loco-operator/pkg/templates/litellm" llamacpp "github.com/LocoStack/loco-operator/pkg/templates/llama_cpp" "github.com/LocoStack/loco-operator/pkg/templates/locostack" "github.com/LocoStack/loco-operator/pkg/templates/neo4j" "github.com/LocoStack/loco-operator/pkg/templates/npx" "github.com/LocoStack/loco-operator/pkg/templates/phoenix" "github.com/LocoStack/loco-operator/pkg/templates/postgresql" "github.com/LocoStack/loco-operator/pkg/templates/qdrant" "github.com/LocoStack/loco-operator/pkg/templates/tei" "github.com/LocoStack/loco-operator/pkg/templates/uvx" corev1 "k8s.io/api/core/v1" ) type TemplateManager struct { templates map[string]v1alpha1.Template runtimes map[string]v1alpha1.RuntimeSpec } func NewTemplateManager() *TemplateManager { return &TemplateManager{ templates: make(map[string]v1alpha1.Template), runtimes: make(map[string]v1alpha1.RuntimeSpec), } } func (m *TemplateManager) GetTemplate(name string) (v1alpha1.Template, bool) { tmpl, ok := m.templates[name] return tmpl, ok } func (m *TemplateManager) GetRuntime(name string) (v1alpha1.RuntimeSpec, bool) { rt, ok := m.runtimes[name] return rt, ok } func (m *TemplateManager) RegisterTemplate(tmpl v1alpha1.Template) { m.templates[tmpl.Name] = tmpl } func (m *TemplateManager) RegisterRuntime(rt v1alpha1.RuntimeSpec) { m.runtimes[rt.Name] = rt } func (m *TemplateManager) ResolveTemplate(tmpl *v1alpha1.Template, defaultKey string) (v1alpha1.Template, error) { var templateName string if tmpl == nil { templateName = defaultKey } else { templateName = tmpl.Name if templateName == "" { templateName = defaultKey } } base, ok := m.GetTemplate(templateName) if !ok { return v1alpha1.Template{}, fmt.Errorf("template %q not found", templateName) } // resolve runtime if specified in the template or inherited from the base if tmpl != nil && tmpl.Spec.Runtime.Name != "" && tmpl.Spec.Runtime.Name != base.Spec.Runtime.Name { rtBase, ok := m.GetRuntime(tmpl.Spec.Runtime.Name) if !ok { return v1alpha1.Template{}, fmt.Errorf("runtime %q not found", tmpl.Spec.Runtime.Name) } mergeRuntimeSpec(&rtBase, &tmpl.Spec.Runtime) tmpl.Spec.Runtime = rtBase } return mergeTemplates(base, tmpl), nil } func mergeTemplates(base v1alpha1.Template, override *v1alpha1.Template) v1alpha1.Template { merged := base.DeepCopy() if override == nil { return *merged } if override.Name != "" && base.Name != override.Name { return *override.DeepCopy() } mergeStringMap(&merged.Metadata.Labels, override.Metadata.Labels) mergeStringMap(&merged.Metadata.Annotations, override.Metadata.Annotations) mergeTemplateSpec(&merged.Spec, &override.Spec) return *merged } func mergeTemplateSpec(dst, src *v1alpha1.TemplateSpec) { mergeRuntimeSpec(&dst.Runtime, &src.Runtime) if src.Volumes != nil { dst.Volumes = deepCopyVolumes(src.Volumes) } mergeResourceRequirements(&dst.Resources, &src.Resources) mergeStringMap(&dst.NodeSelector, src.NodeSelector) if src.Affinity != nil { dst.Affinity = src.Affinity.DeepCopy() } if src.Tolerations != nil { dst.Tolerations = deepCopyTolerations(src.Tolerations) } if src.TopologySpreadConstraints != nil { dst.TopologySpreadConstraints = deepCopyTopologySpreadConstraints(src.TopologySpreadConstraints) } if src.SecurityContext != nil { dst.SecurityContext = src.SecurityContext.DeepCopy() } } func mergeRuntimeSpec(dst, src *v1alpha1.RuntimeSpec) { if src.Name != "" && dst.Name != "" && src.Name != dst.Name { *dst = *src.DeepCopy() return } if src.Name != "" { dst.Name = src.Name } if src.Image != "" { dst.Image = src.Image } if src.Command != nil { dst.Command = slices.Clone(src.Command) } if src.Args != nil { dst.Args = slices.Clone(src.Args) } if src.ExtraArgs != nil { dst.ExtraArgs = slices.Clone(src.ExtraArgs) } if src.Env != nil { mergeEnvVars(&dst.Env, src.Env) } if src.VolumeMounts != nil { dst.VolumeMounts = deepCopyVolumeMounts(src.VolumeMounts) } if src.Port != 0 { dst.Port = src.Port } } func mergeResourceRequirements(dst, src *corev1.ResourceRequirements) { if src.Limits != nil { if dst.Limits == nil { dst.Limits = make(corev1.ResourceList) } maps.Copy(dst.Limits, src.Limits) } if src.Requests != nil { if dst.Requests == nil { dst.Requests = make(corev1.ResourceList) } maps.Copy(dst.Requests, src.Requests) } if src.Claims != nil { dst.Claims = slices.Clone(src.Claims) } } func mergeStringMap(dst *map[string]string, src map[string]string) { if src == nil { return } if *dst == nil { *dst = make(map[string]string) } maps.Copy(*dst, src) } func mergeEnvVars(dst *[]corev1.EnvVar, src []corev1.EnvVar) { if src == nil { return } if *dst == nil { *dst = make([]corev1.EnvVar, 0, len(src)) } existing := make(map[string]int) for i, env := range *dst { existing[env.Name] = i } for _, env := range src { if idx, ok := existing[env.Name]; ok { env.DeepCopyInto(&(*dst)[idx]) } else { *dst = append(*dst, *env.DeepCopy()) } } } func deepCopyVolumeMounts(in []corev1.VolumeMount) []corev1.VolumeMount { out := make([]corev1.VolumeMount, len(in)) for i := range in { in[i].DeepCopyInto(&out[i]) } return out } func deepCopyVolumes(in []corev1.Volume) []corev1.Volume { out := make([]corev1.Volume, len(in)) for i := range in { in[i].DeepCopyInto(&out[i]) } return out } func deepCopyTolerations(in []corev1.Toleration) []corev1.Toleration { out := make([]corev1.Toleration, len(in)) for i := range in { in[i].DeepCopyInto(&out[i]) } return out } func deepCopyTopologySpreadConstraints(in []corev1.TopologySpreadConstraint) []corev1.TopologySpreadConstraint { out := make([]corev1.TopologySpreadConstraint, len(in)) for i := range in { in[i].DeepCopyInto(&out[i]) } return out } var Manager = NewTemplateManager() func init() { Manager.RegisterTemplate(litellm.LiteLLMTemplate) Manager.RegisterRuntime(litellm.LiteLLMTemplate.Spec.Runtime) Manager.RegisterTemplate(qdrant.QdrantTemplate) Manager.RegisterRuntime(qdrant.QdrantTemplate.Spec.Runtime) Manager.RegisterTemplate(neo4j.Neo4jTemplate) Manager.RegisterRuntime(neo4j.Neo4jTemplate.Spec.Runtime) Manager.RegisterTemplate(postgresql.PostgreSQLTemplate) Manager.RegisterRuntime(postgresql.PostgreSQLTemplate.Spec.Runtime) Manager.RegisterTemplate(phoenix.PhoenixTemplate) Manager.RegisterRuntime(phoenix.PhoenixTemplate.Spec.Runtime) Manager.RegisterTemplate(llamacpp.LlamaCPPTemplate) Manager.RegisterRuntime(llamacpp.LlamaCPPTemplate.Spec.Runtime) Manager.RegisterRuntime(llamacpp.LlamaCPPEmbeddingRuntime) Manager.RegisterRuntime(llamacpp.LlamaCPPRerankerRuntime) Manager.RegisterTemplate(tei.TEITemplate) Manager.RegisterRuntime(tei.TEITemplate.Spec.Runtime) Manager.RegisterRuntime(tei.TEIARM64Runtime) Manager.RegisterTemplate(npx.NpxTemplate) Manager.RegisterRuntime(npx.NpxTemplate.Spec.Runtime) Manager.RegisterTemplate(uvx.UvxTemplate) Manager.RegisterRuntime(uvx.UvxTemplate.Spec.Runtime) Manager.RegisterTemplate(locostack.LocoContextTemplate) Manager.RegisterRuntime(locostack.LocoContextTemplate.Spec.Runtime) Manager.RegisterTemplate(locostack.LocoSimpleRAGIngestionTemplate) Manager.RegisterTemplate(locostack.LocoSimpleRAGEgestionTemplate) Manager.RegisterTemplate(locostack.LocoAgentsTemplate) Manager.RegisterRuntime(locostack.LocoAgentsTemplate.Spec.Runtime) }