feat: add stopTask, Agent Teams env var, delegate mode, and help docs

Author: zebbern

claude/client.ts

@@ -113,6 +113,8 @@ export interface ClaudeModelOptions {
   enableFileCheckpointing?: boolean;
   /** Sandbox settings for safer command execution */
   sandbox?: { enabled: boolean; autoAllowBashIfSandboxed?: boolean };
+  /** Enable experimental Agent Teams (multi-agent collaboration) */
+  enableAgentTeams?: boolean;
   /** Structured output format (JSON schema) */
   outputFormat?: { type: 'json_schema'; schema: Record<string, unknown> };
   /** Callback for AskUserQuestion tool — Claude asks the user mid-session.
@@ -170,6 +172,8 @@ export async function sendToClaudeCode(
         ...Object.fromEntries(Object.entries(Deno.env.toObject())),
         // Enable the Tasks system for subagent background tasks (SDK v0.2.19+)
         CLAUDE_CODE_ENABLE_TASKS: '1',
+        // Enable experimental Agent Teams if configured
+        ...(modelOptions?.enableAgentTeams && { CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS: '1' }),
       };
 
       // Apply extra env vars (proxy settings, etc.)

claude/info-commands.ts

@@ -22,6 +22,7 @@ import {
   getAccountInfo,
   getSupportedModels,
   getMcpServerStatus,
+  stopActiveTask,
 } from "./query-manager.ts";
 
 // ================================
@@ -66,6 +67,7 @@ export const infoCommands = [
           { name: 'Interrupt — Stop current processing', value: 'interrupt' },
           { name: 'Change Model — Switch model mid-session', value: 'set-model' },
           { name: 'Change Permissions — Switch permission mode', value: 'set-permissions' },
+          { name: 'Stop Task — Stop a running background task', value: 'stop-task' },
           { name: 'Status — Show active session info', value: 'status' }
         ))
     .addStringOption(option =>
@@ -428,9 +430,31 @@ export function createInfoCommandHandlers(deps: InfoCommandHandlerDeps) {
           break;
         }
 
+        case 'stop-task': {
+          if (!value) {
+            await ctx.editReply({
+              content: 'Please provide a task ID. Example: `/claude-control action:stop-task value:<taskId>`\nTask IDs are shown in "Subagent Task Started" embeds.',
+              ephemeral: true
+            });
+            return;
+          }
+          const success = await stopActiveTask(value);
+          await ctx.editReply({
+            embeds: [{
+              color: success ? 0x00ff00 : 0xff0000,
+              title: success ? '⏹️ Task Stop Requested' : '❌ Cannot Stop Task',
+              description: success
+                ? `Stop signal sent for task \`${value}\`. A notification will appear when the task stops.`
+                : 'No active query, or the task ID was not found.',
+              timestamp: new Date().toISOString()
+            }]
+          });
+          break;
+        }
+
         default:
           await ctx.editReply({
-            content: `Unknown action: ${action}. Available: interrupt, set-model, set-permissions, status`,
+            content: `Unknown action: ${action}. Available: interrupt, set-model, set-permissions, stop-task, status`,
             ephemeral: true
           });
       }

claude/query-manager.ts

@@ -203,6 +203,22 @@ export async function getMcpServerStatus(): Promise<McpServerStatus[] | null> {
   }
 }
 
+/**
+ * Stop a running background task (subagent).
+ * A task_notification with status 'stopped' will be emitted.
+ * 
+ * @param taskId - The task ID from task_notification/task_started events
+ */
+export async function stopActiveTask(taskId: string): Promise<boolean> {
+  if (!activeQuery) return false;
+  try {
+    await activeQuery.stopTask(taskId);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
 // ================================
 // Ephemeral Info Query
 // ================================

core/handler-registry.ts

@@ -436,6 +436,9 @@ export function createAllHandlers(
     if (s.enableSandbox) {
       opts.sandbox = { enabled: true, autoAllowBashIfSandboxed: true };
     }
+    if (s.enableAgentTeams) {
+      opts.enableAgentTeams = true;
+    }
     if (s.outputJsonSchema) {
       opts.outputFormat = { type: 'json_schema', schema: s.outputJsonSchema };
     }

help/commands.ts

@@ -799,6 +799,70 @@ export const COMMAND_HELP = {
       "Takes effect on the next query (persists across sessions)",
       "Use /fast again to toggle back to standard mode"
     ]
+  },
+  "claude-info": {
+    title: "ℹ️ Claude Info & Diagnostics",
+    description: "Show Claude account info, available models, and MCP server status",
+    usage: "/claude-info section: [account/models/mcp/all]",
+    examples: [
+      "/claude-info",
+      "/claude-info section: account",
+      "/claude-info section: models",
+      "/claude-info section: mcp"
+    ],
+    parameters: [
+      { name: "section", description: "Which info section to show (account, models, mcp, or all)", required: false }
+    ],
+    notes: [
+      "Requires an active Claude session to query",
+      "Shows account tier, rate limits, and usage",
+      "Lists all available models with capabilities",
+      "Displays MCP server connection status"
+    ]
+  },
+  "rewind": {
+    title: "⏪ Rewind File Changes",
+    description: "Rewind file changes to a previous state (requires file checkpointing)",
+    usage: "/rewind turn: [turn_number] dry_run: [true/false]",
+    examples: [
+      "/rewind",
+      "/rewind turn: 5",
+      "/rewind turn: 3 dry_run: true"
+    ],
+    parameters: [
+      { name: "turn", description: "Turn number to rewind to (omit to see available turns)", required: false },
+      { name: "dry_run", description: "Preview changes without modifying files", required: false }
+    ],
+    notes: [
+      "Requires an active Claude session with file checkpointing enabled",
+      "Use without arguments to list available checkpoint turns",
+      "Use dry_run to preview which files would be affected",
+      "Rewinding restores files to their state at the specified turn"
+    ]
+  },
+  "claude-control": {
+    title: "🎛️ Mid-Session Controls",
+    description: "Control an active Claude query — interrupt, switch models, change permissions, or stop tasks",
+    usage: "/claude-control action: [interrupt/set-model/set-permissions/stop-task/status] value: [optional]",
+    examples: [
+      "/claude-control action: interrupt",
+      "/claude-control action: set-model value: claude-sonnet-4",
+      "/claude-control action: set-permissions value: plan",
+      "/claude-control action: stop-task value: task_id_here",
+      "/claude-control action: status"
+    ],
+    parameters: [
+      { name: "action", description: "Control action to perform", required: true },
+      { name: "value", description: "Value for the action (model name, permission mode, or task ID)", required: false }
+    ],
+    notes: [
+      "Requires an active Claude session to control",
+      "Interrupt stops the current processing immediately",
+      "Set-model switches the model mid-conversation",
+      "Set-permissions changes the permission mode (plan, autoEdit, fullAuto, delegate, bypassPermissions)",
+      "Stop-task halts a running background task by its ID",
+      "Status shows active session info"
+    ]
   }
 };
 

settings/unified-settings.ts

@@ -21,7 +21,7 @@ export interface UnifiedBotSettings {
   effortLevel: 'low' | 'medium' | 'high' | 'max';
 
   // Mode settings
-  operationMode: 'normal' | 'plan' | 'auto-accept' | 'danger' | 'dont-ask';
+  operationMode: 'normal' | 'plan' | 'auto-accept' | 'danger' | 'dont-ask' | 'delegate';
 
   // Fast mode — Opus 4.6 speed-optimized API config (2.5x faster, higher cost, same quality)
   fastMode: boolean;
@@ -36,6 +36,8 @@ export interface UnifiedBotSettings {
   enableFileCheckpointing: boolean;
   /** Enable sandbox mode for safer command execution */
   enableSandbox: boolean;
+  /** Enable experimental Agent Teams (multi-agent collaboration) */
+  enableAgentTeams: boolean;
   /** JSON schema for structured output (null = unstructured text) */
   outputJsonSchema: Record<string, unknown> | null;
 
@@ -96,6 +98,7 @@ export const UNIFIED_DEFAULT_SETTINGS: UnifiedBotSettings = {
   enable1MContext: false,
   enableFileCheckpointing: false,
   enableSandbox: false,
+  enableAgentTeams: false,
   outputJsonSchema: null,
 
   // Output
@@ -213,6 +216,12 @@ export const OPERATION_MODES = {
     description: 'Bypasses all permission checks — use with extreme caution',
     permissionMode: 'bypassPermissions' as const,
     riskLevel: 'high'
+  },
+  'delegate': {
+    name: 'Delegate Mode',
+    description: 'Restricts to Teammate + Task tools only — for agent team leaders',
+    permissionMode: 'delegate' as const,
+    riskLevel: 'low'
   }
 } as const;