Merge pull request #560 from headlamp-k8s/holmes-integration

Holmes integration into ai-assistant plugin

Author: illume

ai-assistant/README.md

@@ -24,6 +24,73 @@ The plugin supports multiple AI providers, allowing you to choose the one that b
 - **Anthropic** (Claude models)
 - **Mistral AI**
 - **Google** (Gemini models)
+- **DeepSeek** (DeepSeek-Chat, DeepSeek-Reasoner)
 - **Local Models** (via Ollama)
 
 You will need to provide your own API keys and endpoint information for the provider you choose to use. Please note that using AI providers may incur costs, so check the pricing details of your chosen provider.
+
+## Adding Holmes Agent to Your Cluster
+
+The AI Assistant can connect to a [HolmesGPT](https://holmesgpt.dev) agent running in your cluster for enhanced Kubernetes diagnostics and troubleshooting. Follow the steps below to deploy Holmes.
+
+### 1. Add the Robusta Helm Repository
+
+```bash
+helm repo add robusta https://robusta-charts.storage.googleapis.com
+helm repo update
+```
+
+### 2. Create a `values.yaml`
+
+Below is an example using Azure OpenAI. For other providers (OpenAI, AWS Bedrock, etc.), see the [HolmesGPT installation docs](https://holmesgpt.dev/latest/installation/kubernetes-installation/#installation).
+
+```yaml
+# values.yaml
+image: robustadev/holmes:0.19.1
+
+additionalEnvVars:
+- name: AZURE_API_KEY
+  value: ""
+- name: AZURE_API_BASE
+  value: "https://<your-azure-endpoint>.openai.azure.com"
+- name: AZURE_API_VERSION
+  value: "2024-02-15-preview"
+# Or load from secret:
+# - name: AZURE_API_KEY
+#   valueFrom:
+#     secretKeyRef:
+#       name: holmes-secrets
+#       key: azure-api-key
+# - name: AZURE_API_BASE
+#   valueFrom:
+#     secretKeyRef:
+#       name: holmes-secrets
+#       key: azure-api-base
+
+modelList:
+  azure-gpt4:
+    api_key: "{{ env.AZURE_API_KEY }}"
+    model: azure/gpt-5
+    api_base: "{{ env.AZURE_API_BASE }}"
+    api_version: "{{ env.AZURE_API_VERSION }}"
+```
+
+### 3. Render and Patch the Helm Template
+
+Holmes requires enabling the AG-UI server for the AI Assistant to communicate with it. Render the template and update the container command:
+
+```bash
+helm template holmesgpt robusta/holmes -f values.yaml > rendered.yaml
+```
+
+In `rendered.yaml`, find the container command and change it to:
+
+```yaml
+command: ["python3", "-u", "/app/experimental/ag-ui/server-agui.py"]
+```
+
+### 4. Deploy to Your Cluster
+
+```bash
+kubectl apply -f rendered.yaml
+```

ai-assistant/package-lock.json

@@ -36,6 +36,7 @@
     "@kinvolk/headlamp-plugin": "^0.13.0-alpha.14"
   },
   "dependencies": {
+    "@ag-ui/client": "^0.0.45",
     "@langchain/anthropic": "^1.3.16",
     "@langchain/core": "^1.1.20",
     "@langchain/deepseek": "1.0.8",

ai-assistant/package.json

@@ -280,38 +280,45 @@ const ContentRenderer: React.FC<ContentRendererProps> = React.memo(
     const history = useHistory();
     // Create code component that has access to onYamlDetected
     const CodeComponent = React.useMemo(() => {
+      /** Extract a plain string from React children (may be string, array, or nested elements). */
+      const extractText = (node: any): string => {
+        if (typeof node === 'string') return node;
+        if (Array.isArray(node)) return node.map(extractText).join('');
+        if (node?.props?.children) return extractText(node.props.children);
+        return String(node ?? '');
+      };
+
       const component = React.memo(({ className, children, ...props }: any) => {
+        // Robustly get the text content from children (string or array)
+        const textContent = extractText(children);
+
         // Check if this is a YAML code block
         const isYamlBlock =
           !props.inline &&
           (className === 'language-yaml' ||
             className === 'language-yml' ||
-            (typeof children === 'string' &&
-              children.includes('apiVersion:') &&
-              children.includes('kind:')));
+            (textContent.includes('apiVersion:') && textContent.includes('kind:')));
 
         // Check if this is a JSON code block with Kubernetes resource
         const isJsonKubernetesBlock =
-          !props.inline &&
-          typeof children === 'string' &&
-          (className === 'language-json' || isJsonKubernetesResource(children));
+          !props.inline && (className === 'language-json' || isJsonKubernetesResource(textContent));
 
-        if (isYamlBlock && onYamlDetected && typeof children === 'string') {
-          const parsed = parseKubernetesYAML(children);
+        if (isYamlBlock && onYamlDetected && textContent) {
+          const parsed = parseKubernetesYAML(textContent);
           if (parsed.isValid) {
             return (
               <YamlDisplay
-                yaml={children}
+                yaml={textContent}
                 title={parsed.resourceType}
                 onOpenInEditor={onYamlDetected}
               />
             );
           }
         }
 
-        if (isJsonKubernetesBlock && onYamlDetected && typeof children === 'string') {
+        if (isJsonKubernetesBlock && onYamlDetected && textContent) {
           // Convert JSON to YAML and display
-          const yamlContent = convertJsonToYaml(children);
+          const yamlContent = convertJsonToYaml(textContent);
           const parsed = parseKubernetesYAML(yamlContent);
           if (parsed.isValid) {
             return (
@@ -325,7 +332,7 @@ const ContentRenderer: React.FC<ContentRendererProps> = React.memo(
         }
 
         // Check if it's just one line of code
-        if (typeof children === 'string' && !children.trim().includes('\n')) {
+        if (textContent && !textContent.trim().includes('\n')) {
           // Display inline
           return <em>{children}</em>;
         }

ai-assistant/src/ContentRenderer.tsx

@@ -0,0 +1,9 @@
+// ag-ui types for Holmes agent communication.
+// Event types and protocol types are provided by @ag-ui/client and @ag-ui/core.
+// This file only defines types specific to the Headlamp–Holmes integration.
+
+export interface HolmesServiceInfo {
+  namespace: string;
+  service: string;
+  port: number;
+}