feat: add agent-operator & kb-operator

charts/agent-operator/Chart.yaml

@@ -0,0 +1,9 @@
+apiVersion: v2
+name: agent-operator
+description: A Helm chart for Agent Operator
+type: application
+version: 0.1.0
+appVersion: "0.1.0"
+home: https://github.com/linode/ai-operators
+sources:
+  - https://github.com/linode/ai-operators

charts/agent-operator/crds/crd.yaml

@@ -0,0 +1,186 @@
+apiVersion: apiextensions.k8s.io/v1
+kind: CustomResourceDefinition
+metadata:
+  name: akamaiagents.akamai.io
+spec:
+  group: akamai.io
+  versions:
+  - name: v1alpha1
+    served: true
+    storage: true
+    schema:
+      openAPIV3Schema:
+        type: object
+        description: AkamaiAgent is a custom resource for managing AI agents with foundation models
+        properties:
+          apiVersion:
+            description: 'APIVersion defines the versioned schema of this representation of an object.'
+            type: string
+          kind:
+            description: 'Kind is a string value representing the REST resource this object represents.'
+            type: string
+          metadata:
+            type: object
+            properties:
+              name:
+                type: string
+                pattern: '^[a-z0-9]([-a-z0-9]*[a-z0-9])?$'
+                maxLength: 253
+          spec:
+            type: object
+            required:
+            - foundationModel
+            - agentInstructions
+            properties:
+              foundationModel:
+                description: The foundation model to use for the agent
+                type: string
+                minLength: 1
+                example: llama
+              foundationModelEndpoint:
+                description: The foundation model endpoint to use for the agent
+                type: string
+                minLength: 1
+                example: http://llama-service.default.svc.cluster.local:8080/openai/v1
+              agentInstructions:
+                description: Instructions that define the agent's behavior and personality
+                type: string
+                minLength: 1
+                maxLength: 4096
+              maxTokens:
+                description: Maximum number of tokens for model responses
+                type: integer
+                default: 512
+                minimum: 1
+              temperature:
+                description: Controls randomness in model responses (0.0 = deterministic, 1.0 = creative)
+                type: number
+                default: 0.7
+                minimum: 0.0
+                maximum: 2.0
+              topP:
+                description: Nucleus sampling - limits token selection to top cumulative probability (0.1 = focused, 1.0 = all tokens)
+                type: number
+                default: 1.0
+                minimum: 0.0
+                maximum: 1.0
+              routes:
+                description: Routes to other agents for conditional delegation
+                type: array
+                items:
+                  type: object
+                  properties:
+                    agent:
+                      description: Name of the target agent
+                      type: string
+                    condition:
+                      description: Condition for routing to this agent
+                      type: string
+                    apiUrl:
+                      description: API URL of the target agent
+                      type: string
+                    apiKey:
+                      description: API key for authentication
+                      type: string
+                  required:
+                  - agent
+                  - condition
+              tools:
+                description: Tools available to the agent
+                type: array
+                items:
+                  type: object
+                  properties:
+                    type:
+                      description: Type of tool (knowledgeBase, function, mcpServer, subWorkflow)
+                      type: string
+                      enum:
+                      - knowledgeBase
+                      - function
+                      - mcpServer
+                      - subWorkflow
+                    name:
+                      description: Name of the tool
+                      type: string
+                    description:
+                      description: Description of how the agent can use this tool
+                      type: string
+                    apiUrl:
+                      description: API URL for the tool (for mcpServer, function, subWorkflow)
+                      type: string
+                    apiKey:
+                      description: API key for authentication
+                      type: string
+                    endpoint:
+                      description: Deprecated - use apiUrl instead
+                      type: string
+                  required:
+                  - type
+          status:
+            type: object
+            x-kubernetes-preserve-unknown-fields: true
+            properties:
+              phase:
+                description: Current phase of the agent (Deployed, Failed, Running)
+                type: string
+              conditions:
+                description: Current conditions of the agent
+                type: array
+                items:
+                  description: Condition represents the current condition of the agent
+                  type: object
+                  required:
+                  - type
+                  - status
+                  properties:
+                    type:
+                      description: Type of condition
+                      type: string
+                      enum:
+                      - AgentDeployed
+                      - AgentReady
+                      - AgentFailed
+                    status:
+                      description: Status of the condition
+                      type: string
+                      enum:
+                      - "True"
+                      - "False"
+                      - "Unknown"
+                    reason:
+                      description: Reason for the condition status
+                      type: string
+                    message:
+                      description: Human readable message describing the condition
+                      type: string
+                      maxLength: 1024
+                    lastTransitionTime:
+                      description: Last time the condition transitioned from one status to another
+                      type: string
+                      format: date-time
+                    lastUpdateTime:
+                      description: Last time the condition was updated
+                      type: string
+                      format: date-time
+    additionalPrinterColumns:
+    - name: Model
+      type: string
+      description: Foundation model
+      jsonPath: .spec.foundationModel
+    - name: Status
+      type: string
+      description: Agent deployment status
+      jsonPath: .status.conditions[?(@.type=="AgentDeployed")].status
+    - name: Created
+      type: string
+      format: date-time
+      jsonPath: .metadata.creationTimestamp
+  scope: Namespaced
+  names:
+    plural: akamaiagents
+    singular: akamaiagent
+    kind: AkamaiAgent
+    shortNames:
+    - aag
+    categories:
+    - apl

charts/agent-operator/templates/_helpers.tpl

@@ -0,0 +1,67 @@
+{{/*
+Expand the name of the chart.
+*/}}
+{{- define "agent-operator.name" -}}
+{{- default .Chart.Name .Values.nameOverride | trunc 63 | trimSuffix "-" }}
+{{- end }}
+
+{{/*
+Create a default fully qualified app name.
+*/}}
+{{- define "agent-operator.fullname" -}}
+{{- if .Values.fullnameOverride }}
+{{- .Values.fullnameOverride | trunc 63 | trimSuffix "-" }}
+{{- else }}
+{{- $name := default .Chart.Name .Values.nameOverride }}
+{{- if contains $name .Release.Name }}
+{{- .Release.Name | trunc 63 | trimSuffix "-" }}
+{{- else }}
+{{- printf "%s-%s" .Release.Name $name | trunc 63 | trimSuffix "-" }}
+{{- end }}
+{{- end }}
+{{- end }}
+
+{{/*
+Create chart name and version as used by the chart label.
+*/}}
+{{- define "agent-operator.chart" -}}
+{{- printf "%s-%s" .Chart.Name .Chart.Version | replace "+" "_" | trunc 63 | trimSuffix "-" }}
+{{- end }}
+
+{{/*
+Common labels
+*/}}
+{{- define "agent-operator.labels" -}}
+helm.sh/chart: {{ include "agent-operator.chart" . }}
+{{ include "agent-operator.selectorLabels" . }}
+{{- if .Chart.AppVersion }}
+app.kubernetes.io/version: {{ .Chart.AppVersion | quote }}
+{{- end }}
+app.kubernetes.io/managed-by: {{ .Release.Service }}
+{{- end }}
+
+{{/*
+Selector labels
+*/}}
+{{- define "agent-operator.selectorLabels" -}}
+app.kubernetes.io/name: {{ include "agent-operator.name" . }}
+app.kubernetes.io/instance: {{ .Release.Name }}
+{{- end }}
+
+{{/*
+Create the name of the service account to use
+*/}}
+{{- define "agent-operator.serviceAccountName" -}}
+{{- if .Values.serviceAccount.create }}
+{{- default (include "agent-operator.fullname" .) .Values.serviceAccount.name }}
+{{- else }}
+{{- default "default" .Values.serviceAccount.name }}
+{{- end }}
+{{- end }}
+
+{{/*
+Parse watch namespaces list - returns comma-separated list (required for agent-operator)
+*/}}
+{{- define "agent-operator.watchNamespacesList" -}}
+{{- .Values.watchNamespaces }}
+{{- end }}

charts/agent-operator/templates/clusterrole.yaml

@@ -0,0 +1,44 @@
+
+apiVersion: rbac.authorization.k8s.io/v1
+kind: ClusterRole
+metadata:
+  name: {{ include "agent-operator.fullname" . }}
+  labels:
+    {{- include "agent-operator.labels" . | nindent 4 }}
+rules:
+# Framework: Kopf requires CRD access
+- apiGroups: ["apiextensions.k8s.io"]
+  resources: ["customresourcedefinitions"]
+  verbs: ["list", "watch"]
+
+# Framework: Posting events about handler progress/errors
+- apiGroups: [""]
+  resources: ["events"]
+  verbs: ["create", "patch"]
+
+# AkamaiAgent custom resources
+- apiGroups: ["akamai.io"]
+  resources: ["akamaiagents"]
+  verbs: ["get", "list", "watch", "patch"]
+- apiGroups: ["akamai.io"]
+  resources: ["akamaiagents/status"]
+  verbs: ["get", "update", "patch"]
+- apiGroups: ["akamai.io"]
+  resources: ["akamaiagents/finalizers"]
+  verbs: ["update"]
+
+# AkamaiKnowledgeBase custom resources
+- apiGroups: ["akamai.io"]
+  resources: ["akamaiknowledgebases"]
+  verbs: ["get", "list", "watch"]
+
+# Deployments access
+- apiGroups: ["apps"]
+  resources: ["deployments"]
+  verbs: ["get", "list", "watch"]
+
+{{- if eq (.Values.provider | default "") "apl" }}
+- apiGroups: ["argoproj.io"]
+  resources: ["applications"]
+  verbs: ["get", "list", "create", "update", "patch", "delete"]
+{{- end }}

charts/agent-operator/templates/clusterrolebinding.yaml

@@ -0,0 +1,15 @@
+
+apiVersion: rbac.authorization.k8s.io/v1
+kind: ClusterRoleBinding
+metadata:
+  name: {{ include "agent-operator.fullname" . }}
+  labels:
+    {{- include "agent-operator.labels" . | nindent 4 }}
+roleRef:
+  apiGroup: rbac.authorization.k8s.io
+  kind: ClusterRole
+  name: {{ include "agent-operator.fullname" . }}
+subjects:
+- kind: ServiceAccount
+  name: {{ include "agent-operator.serviceAccountName" . }}
+  namespace: {{ .Release.Namespace }}