feat: add ConfigMap-driven AI agent registry

Replace hardcoded agent definitions with a Kubernetes ConfigMap
(`ai-agent-registry`) so administrators can add, remove, or update
AI agents without dashboard code changes.

Backend: new GET /dashboard/api/ai-agent-registry route reads
the ConfigMap via service account token and returns the agent list.
Terminal proxy parameterized to accept workspace name and port.

Frontend: new AiAgentRegistry Redux store fetched at bootstrap;
DevWorkspace spec built dynamically from AiAgentDefinition;
agent panel and terminal init command driven by registry data;
UI hidden when no agents are registered.

Assisted-by: Claude Opus 4.6
Signed-off-by: Oleksii Orel <oorel@redhat.com>

Author: olexii4

packages/common/src/dto/api/index.ts

@@ -77,6 +77,29 @@ export interface IPatch {
   value?: any;
 }
 
+// Generated by Claude Opus 4.6
+
+export interface AiAgentDefinition {
+  id: string;
+  name: string;
+  publisher: string;
+  description: string;
+  icon: string;
+  docsUrl: string;
+  image: string;
+  tag: string;
+  memoryLimit: string;
+  cpuLimit: string;
+  terminalPort: number;
+  env: Array<{ name: string; value: string }>;
+  initCommand: string;
+}
+
+export interface IAiAgentRegistry {
+  agents: AiAgentDefinition[];
+  defaultAgentId: string;
+}
+
 export interface IGitConfig {
   resourceVersion?: string;
   gitconfig: {

packages/dashboard-backend/src/app.ts

@@ -22,6 +22,7 @@ import { registerCors } from '@/plugins/cors';
 import { registerStaticServer } from '@/plugins/staticServer';
 import { registerSwagger } from '@/plugins/swagger';
 import { registerWebSocket } from '@/plugins/webSocket';
+import { registerAiAgentRegistryRoute } from '@/routes/api/aiAgentRegistry';
 import { registerAirGapSampleRoute } from '@/routes/api/airGapSample';
 import { registerBackupRoutes } from '@/routes/api/backup';
 import { registerClusterConfigRoute } from '@/routes/api/clusterConfig';
@@ -149,5 +150,7 @@ export default async function buildApp(server: FastifyInstance): Promise<unknown
     registerDevfileCreatorRoute(server),
 
     registerDevfileSchemaRoute(server),
+
+    registerAiAgentRegistryRoute(server),
   ]);
 }

packages/dashboard-backend/src/routes/api/aiAgentRegistry.ts

@@ -0,0 +1,97 @@
+/*
+ * Copyright (c) 2018-2025 Red Hat, Inc.
+ * This program and the accompanying materials are made
+ * available under the terms of the Eclipse Public License 2.0
+ * which is available at https://www.eclipse.org/legal/epl-2.0/
+ *
+ * SPDX-License-Identifier: EPL-2.0
+ *
+ * Contributors:
+ *   Red Hat, Inc. - initial API and implementation
+ */
+
+// Generated by Claude Opus 4.6
+
+import { api } from '@eclipse-che/common';
+import * as k8s from '@kubernetes/client-node';
+import { FastifyInstance } from 'fastify';
+
+import { baseApiPath } from '@/constants/config';
+import { getServiceAccountToken } from '@/routes/api/helpers/getServiceAccountToken';
+import { getSchema } from '@/services/helpers';
+import { KubeConfigProvider } from '@/services/kubeclient/kubeConfigProvider';
+import { logger } from '@/utils/logger';
+
+const tags = ['AI Agent Registry'];
+
+const AI_AGENT_REGISTRY_LABEL_SELECTOR =
+  'app.kubernetes.io/component=ai-agent-registry,app.kubernetes.io/part-of=che.eclipse.org';
+
+const EMPTY_REGISTRY: api.IAiAgentRegistry = { agents: [], defaultAgentId: '' };
+
+function isValidAgent(obj: unknown): obj is api.AiAgentDefinition {
+  if (typeof obj !== 'object' || obj === null) return false;
+  const agent = obj as Record<string, unknown>;
+  return (
+    typeof agent.id === 'string' &&
+    typeof agent.name === 'string' &&
+    typeof agent.image === 'string' &&
+    typeof agent.tag === 'string' &&
+    typeof agent.terminalPort === 'number'
+  );
+}
+
+function parseRegistryJson(raw: string): api.IAiAgentRegistry {
+  const parsed = JSON.parse(raw) as Record<string, unknown>;
+  const agents = Array.isArray(parsed.agents) ? parsed.agents.filter(isValidAgent) : [];
+  const defaultAgentId = typeof parsed.defaultAgentId === 'string' ? parsed.defaultAgentId : '';
+  return { agents, defaultAgentId };
+}
+
+export function registerAiAgentRegistryRoute(instance: FastifyInstance) {
+  instance.register(async server => {
+    server.get(
+      `${baseApiPath}/ai-agent-registry`,
+      getSchema({ tags }),
+      async function (): Promise<api.IAiAgentRegistry> {
+        const cheNamespace = process.env.CHECLUSTER_CR_NAMESPACE;
+        if (!cheNamespace) {
+          logger.warn('CHECLUSTER_CR_NAMESPACE not set, returning empty AI agent registry');
+          return EMPTY_REGISTRY;
+        }
+
+        try {
+          const token = getServiceAccountToken();
+          const provider = new KubeConfigProvider();
+          const kc = provider.getKubeConfig(token);
+          const coreV1Api = kc.makeApiClient(k8s.CoreV1Api);
+
+          const response = await coreV1Api.listNamespacedConfigMap({
+            namespace: cheNamespace,
+            labelSelector: AI_AGENT_REGISTRY_LABEL_SELECTOR,
+          });
+
+          const configMaps = response.items;
+          if (configMaps.length === 0) {
+            return EMPTY_REGISTRY;
+          }
+
+          const data = configMaps[0].data;
+          if (!data) {
+            return EMPTY_REGISTRY;
+          }
+
+          const registryJson = data['registry.json'];
+          if (!registryJson) {
+            return EMPTY_REGISTRY;
+          }
+
+          return parseRegistryJson(registryJson);
+        } catch (error) {
+          logger.error(error, 'Failed to read AI agent registry ConfigMap');
+          return EMPTY_REGISTRY;
+        }
+      },
+    );
+  });
+}

packages/dashboard-backend/src/routes/api/helpers/terminal/index.ts

@@ -29,7 +29,12 @@ export interface DevWorkspaceItem {
 /**
  * Returns the in-cluster service URL for the agent terminal (HTTP, no TLS).
  */
-export async function getTerminalServiceUrl(token: string, namespace: string): Promise<string> {
+export async function getTerminalServiceUrl(
+  token: string,
+  namespace: string,
+  workspaceName = 'devfile-agent',
+  terminalPort = 8080,
+): Promise<string> {
   const kubeConfig = getKubeConfig(token);
   const customObjectsApi = kubeConfig.makeApiClient(k8s.CustomObjectsApi);
 
@@ -41,14 +46,14 @@ export async function getTerminalServiceUrl(token: string, namespace: string): P
   });
 
   const workspaces = (dwList as { items: Array<DevWorkspaceItem> }).items;
-  const agentWs = workspaces.find(ws => ws.metadata.name === 'devfile-agent');
+  const agentWs = workspaces.find(ws => ws.metadata.name === workspaceName);
 
   if (!agentWs?.status?.devworkspaceId) {
-    throw new Error('Agent DevWorkspace not found or not ready');
+    throw new Error(`Agent DevWorkspace '${workspaceName}' not found or not ready`);
   }
 
   const workspaceId = agentWs.status.devworkspaceId;
-  return `http://${workspaceId}-service.${namespace}.svc:8080`;
+  return `http://${workspaceId}-service.${namespace}.svc:${terminalPort}`;
 }
 
 /**

packages/dashboard-frontend/src/components/AgentTerminal/index.tsx

@@ -44,6 +44,7 @@ export interface Props {
   namespace: string;
   devfileName: string;
   isDarkTheme: boolean;
+  initCommand?: string;
 }
 
 interface State {
@@ -127,7 +128,10 @@ export default class AgentTerminal extends React.PureComponent<Props, State> {
   };
 
   private buildInitCommand(): string {
-    const { namespace, devfileName } = this.props;
+    const { namespace, devfileName, initCommand } = this.props;
+    if (initCommand) {
+      return initCommand + '\r';
+    }
     return (
       'claude --bare --dangerously-skip-permissions ' +
       '--append-system-prompt-file "$HOME/CLAUDE.md" ' +

packages/dashboard-frontend/src/components/DevfileEditor/index.module.css

@@ -20,6 +20,10 @@
   border: 1px solid var(--pf-t--global--border--color--default);
 }
 
+.devfileEditor > * {
+  height: inherit;
+}
+
 .error {
   padding: 4px 8px;
   font-size: 13px;

packages/dashboard-frontend/src/components/DevfileEditor/index.tsx

@@ -90,6 +90,7 @@ const readOnlyCompartment = new Compartment();
 const onValidationRef: { current?: (errorMessage: string) => void } = { current: undefined };
 const onChangeRef: { current?: (value: string) => void } = { current: undefined };
 const setErrorRef: { current?: (msg: string) => void } = { current: undefined };
+const isProgrammaticChangeRef = { current: false };
 
 function diagnosticsReporter() {
   return EditorView.updateListener.of(update => {
@@ -129,7 +130,7 @@ function diagnosticsReporter() {
 
 function changeListener() {
   return EditorView.updateListener.of(update => {
-    if (update.docChanged && onChangeRef.current) {
+    if (update.docChanged && onChangeRef.current && !isProgrammaticChangeRef.current) {
       onChangeRef.current(update.state.doc.toString());
     }
   });
@@ -173,9 +174,11 @@ export const DevfileEditor: React.FC<Props> = ({
     if (viewRef.current && value !== prevValueRef.current) {
       const currentContent = viewRef.current.state.doc.toString();
       if (value !== currentContent) {
+        isProgrammaticChangeRef.current = true;
         viewRef.current.dispatch({
           changes: { from: 0, to: currentContent.length, insert: value },
         });
+        isProgrammaticChangeRef.current = false;
       }
       prevValueRef.current = value;
     }

packages/dashboard-frontend/src/containers/DevfileDetails/index.tsx

@@ -20,6 +20,7 @@ import Fallback from '@/components/Fallback';
 import { useTheme } from '@/contexts/ThemeContext';
 import DevfileDetails from '@/pages/DevfileDetails';
 import { RootState } from '@/store';
+import { selectAiAgentRegistryEnabled, selectDefaultAgent } from '@/store/AiAgentRegistry';
 import { devfileSchemaActionCreators, selectDevfileSchema } from '@/store/DevfileSchema';
 import { actionCreators, clearAgentTerminalUrl } from '@/store/LocalDevfiles';
 import {
@@ -131,7 +132,10 @@ export class DevfileDetailsContainer extends React.PureComponent<Props> {
   }
 
   private handleStartAgent = () => {
-    this.props.startAgentWorkspace();
+    const { defaultAgent } = this.props;
+    if (defaultAgent) {
+      this.props.startAgentWorkspace(defaultAgent);
+    }
   };
 
   render() {
@@ -145,6 +149,8 @@ export class DevfileDetailsContainer extends React.PureComponent<Props> {
       namespace,
       navigate,
       isDarkTheme,
+      agentEnabled,
+      defaultAgent,
     } = this.props;
 
     const devfile = devfiles.find(d => d.name === devfileName);
@@ -177,6 +183,8 @@ export class DevfileDetailsContainer extends React.PureComponent<Props> {
         agentWorkspace={agentWorkspace}
         agentTerminalUrl={agentTerminalUrl}
         isDarkTheme={isDarkTheme}
+        agentEnabled={agentEnabled}
+        agentInitCommand={defaultAgent?.initCommand}
       />
     );
   }
@@ -206,6 +214,8 @@ const mapStateToProps = (state: RootState) => ({
   isLoading: selectLocalDevfilesIsLoading(state),
   agentWorkspaces: selectAgentWorkspaces(state),
   agentTerminalUrl: selectAgentTerminalUrl(state),
+  agentEnabled: selectAiAgentRegistryEnabled(state),
+  defaultAgent: selectDefaultAgent(state),
 });
 
 const mapDispatchToProps = {

packages/dashboard-frontend/src/pages/DevfileDetails/__tests__/index.spec.tsx

@@ -85,6 +85,7 @@ function renderComponent(overrides?: Partial<React.ComponentProps<typeof Devfile
       agentWorkspace={undefined}
       agentTerminalUrl={undefined}
       isDarkTheme={true}
+      agentEnabled={true}
       {...overrides}
     />,
   );
@@ -171,6 +172,6 @@ describe('DevfileDetails', () => {
 
   test('shows Start button when no agent workspace', () => {
     renderComponent();
-    expect(screen.getByRole('button', { name: /^Start$/i })).toBeDefined();
+    expect(screen.getByRole('button', { name: /Start Agent/i })).toBeDefined();
   });
 });

packages/dashboard-frontend/src/pages/DevfileDetails/index.tsx

@@ -62,6 +62,8 @@ interface Props {
   agentWorkspace: Workspace | undefined;
   agentTerminalUrl: string | undefined;
   isDarkTheme: boolean;
+  agentEnabled: boolean;
+  agentInitCommand?: string;
 }
 
 interface State {
@@ -107,7 +109,7 @@ export default class DevfileDetails extends React.PureComponent<Props, State> {
   private handleEditorChange = (value: string) => {
     this.setState({
       editorContent: value,
-      isSaved: value === this.props.devfile.content,
+      isSaved: false,
     });
   };
 
@@ -226,6 +228,7 @@ export default class DevfileDetails extends React.PureComponent<Props, State> {
               namespace={this.props.namespace}
               devfileName={this.props.devfile.name}
               isDarkTheme={this.props.isDarkTheme}
+              initCommand={this.props.agentInitCommand}
             />
           </div>
         );
@@ -317,7 +320,7 @@ export default class DevfileDetails extends React.PureComponent<Props, State> {
   }
 
   render(): React.ReactElement {
-    const { devfile, agentWorkspace, agentTerminalUrl } = this.props;
+    const { devfile, agentWorkspace, agentTerminalUrl, agentEnabled } = this.props;
     const { editorContent, isSaved, saveError, hasValidationError } = this.state;
     const isAgentConnected = agentWorkspace?.isRunning && agentTerminalUrl;
 
@@ -404,17 +407,19 @@ export default class DevfileDetails extends React.PureComponent<Props, State> {
               </Toolbar>
             </SplitItem>
 
-            <SplitItem
-              style={{
-                width: isAgentConnected ? '50%' : '500px',
-                minWidth: '350px',
-                transition: 'width 0.3s ease',
-                maxHeight: '452px',
-                marginBottom: '45px',
-              }}
-            >
-              {this.renderAgentPanel()}
-            </SplitItem>
+            {agentEnabled && (
+              <SplitItem
+                style={{
+                  width: isAgentConnected ? '50%' : '500px',
+                  minWidth: '350px',
+                  transition: 'width 0.3s ease',
+                  maxHeight: '452px',
+                  marginBottom: '45px',
+                }}
+              >
+                {this.renderAgentPanel()}
+              </SplitItem>
+            )}
           </Split>
         </PageSection>
       </React.Fragment>