Enable & disable agents (#16225)

packages/cli/src/ui/commands/agentsCommand.ts

@@ -4,9 +4,17 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 
-import type { SlashCommand, CommandContext } from './types.js';
+import type {
+  SlashCommand,
+  CommandContext,
+  SlashCommandActionReturn,
+} from './types.js';
 import { CommandKind } from './types.js';
 import { MessageType, type HistoryItemAgentsList } from '../types.js';
+import { SettingScope } from '../../config/settings.js';
+import type { AgentOverride } from '@google/gemini-cli-core';
+import { disableAgent, enableAgent } from '../../utils/agentSettings.js';
+import { renderAgentActionFeedback } from '../../utils/agentUtils.js';
 
 const agentsListCommand: SlashCommand = {
   name: 'list',
@@ -50,6 +58,197 @@ const agentsListCommand: SlashCommand = {
   },
 };
 
+async function enableAction(
+  context: CommandContext,
+  args: string,
+): Promise<SlashCommandActionReturn | void> {
+  const { config, settings } = context.services;
+  if (!config) return;
+
+  const agentName = args.trim();
+  if (!agentName) {
+    return {
+      type: 'message',
+      messageType: 'error',
+      content: 'Usage: /agents enable <agent-name>',
+    };
+  }
+
+  const agentRegistry = config.getAgentRegistry();
+  if (!agentRegistry) {
+    return {
+      type: 'message',
+      messageType: 'error',
+      content: 'Agent registry not found.',
+    };
+  }
+
+  const allAgents = agentRegistry.getAllAgentNames();
+  const overrides = (settings.merged.agents?.overrides ?? {}) as Record<
+    string,
+    AgentOverride
+  >;
+  const disabledAgents = Object.keys(overrides).filter(
+    (name) => overrides[name]?.disabled === true,
+  );
+
+  if (allAgents.includes(agentName)) {
+    return {
+      type: 'message',
+      messageType: 'info',
+      content: `Agent '${agentName}' is already enabled.`,
+    };
+  }
+
+  if (!disabledAgents.includes(agentName)) {
+    return {
+      type: 'message',
+      messageType: 'error',
+      content: `Agent '${agentName}' not found.`,
+    };
+  }
+
+  const result = enableAgent(settings, agentName);
+
+  if (result.status === 'no-op') {
+    return {
+      type: 'message',
+      messageType: 'info',
+      content: renderAgentActionFeedback(result, (l, p) => `${l} (${p})`),
+    };
+  }
+
+  context.ui.addItem({
+    type: MessageType.INFO,
+    text: `Enabling ${agentName}...`,
+  });
+  await agentRegistry.reload();
+
+  return {
+    type: 'message',
+    messageType: 'info',
+    content: renderAgentActionFeedback(result, (l, p) => `${l} (${p})`),
+  };
+}
+
+async function disableAction(
+  context: CommandContext,
+  args: string,
+): Promise<SlashCommandActionReturn | void> {
+  const { config, settings } = context.services;
+  if (!config) return;
+
+  const agentName = args.trim();
+  if (!agentName) {
+    return {
+      type: 'message',
+      messageType: 'error',
+      content: 'Usage: /agents disable <agent-name>',
+    };
+  }
+
+  const agentRegistry = config.getAgentRegistry();
+  if (!agentRegistry) {
+    return {
+      type: 'message',
+      messageType: 'error',
+      content: 'Agent registry not found.',
+    };
+  }
+
+  const allAgents = agentRegistry.getAllAgentNames();
+  const overrides = (settings.merged.agents?.overrides ?? {}) as Record<
+    string,
+    AgentOverride
+  >;
+  const disabledAgents = Object.keys(overrides).filter(
+    (name) => overrides[name]?.disabled === true,
+  );
+
+  if (disabledAgents.includes(agentName)) {
+    return {
+      type: 'message',
+      messageType: 'info',
+      content: `Agent '${agentName}' is already disabled.`,
+    };
+  }
+
+  if (!allAgents.includes(agentName)) {
+    return {
+      type: 'message',
+      messageType: 'error',
+      content: `Agent '${agentName}' not found.`,
+    };
+  }
+
+  const scope = context.services.settings.workspace.path
+    ? SettingScope.Workspace
+    : SettingScope.User;
+  const result = disableAgent(settings, agentName, scope);
+
+  if (result.status === 'no-op') {
+    return {
+      type: 'message',
+      messageType: 'info',
+      content: renderAgentActionFeedback(result, (l, p) => `${l} (${p})`),
+    };
+  }
+
+  context.ui.addItem({
+    type: MessageType.INFO,
+    text: `Disabling ${agentName}...`,
+  });
+  await agentRegistry.reload();
+
+  return {
+    type: 'message',
+    messageType: 'info',
+    content: renderAgentActionFeedback(result, (l, p) => `${l} (${p})`),
+  };
+}
+
+function completeAgentsToEnable(context: CommandContext, partialArg: string) {
+  const { config, settings } = context.services;
+  if (!config) return [];
+
+  const overrides = (settings.merged.agents?.overrides ?? {}) as Record<
+    string,
+    AgentOverride
+  >;
+  const disabledAgents = Object.entries(overrides)
+    .filter(([_, override]) => override?.disabled === true)
+    .map(([name]) => name);
+
+  return disabledAgents.filter((name) => name.startsWith(partialArg));
+}
+
+function completeAgentsToDisable(context: CommandContext, partialArg: string) {
+  const { config } = context.services;
+  if (!config) return [];
+
+  const agentRegistry = config.getAgentRegistry();
+  const allAgents = agentRegistry ? agentRegistry.getAllAgentNames() : [];
+  return allAgents.filter((name: string) => name.startsWith(partialArg));
+}
+
+const enableCommand: SlashCommand = {
+  name: 'enable',
+  description: 'Enable a disabled agent',
+  kind: CommandKind.BUILT_IN,
+  autoExecute: false,
+  action: enableAction,
+  completion: completeAgentsToEnable,
+};
+
+const disableCommand: SlashCommand = {
+  name: 'disable',
+  description: 'Disable an enabled agent',
+  kind: CommandKind.BUILT_IN,
+  autoExecute: false,
+  action: disableAction,
+  completion: completeAgentsToDisable,
+};
+
 const agentsRefreshCommand: SlashCommand = {
   name: 'refresh',
   description: 'Reload the agent registry',
@@ -84,7 +283,12 @@ export const agentsCommand: SlashCommand = {
   name: 'agents',
   description: 'Manage agents',
   kind: CommandKind.BUILT_IN,
-  subCommands: [agentsListCommand, agentsRefreshCommand],
+  subCommands: [
+    agentsListCommand,
+    agentsRefreshCommand,
+    enableCommand,
+    disableCommand,
+  ],
   action: async (context: CommandContext, args) =>
     // Default to list if no subcommand is provided
     agentsListCommand.action!(context, args),