fix: rename bash tool to exec (#748) (thanks @myfunc)

src/config/config.test.ts

@@ -1100,7 +1100,7 @@ describe("legacy config detection", () => {
     expect(res.changes).toContain("Moved agent.tools.allow → tools.allow.");
     expect(res.changes).toContain("Moved agent.tools.deny → tools.deny.");
     expect(res.changes).toContain("Moved agent.elevated → tools.elevated.");
-    expect(res.changes).toContain("Moved agent.bash → tools.bash.");
+    expect(res.changes).toContain("Moved agent.bash → tools.exec.");
     expect(res.changes).toContain(
       "Moved agent.sandbox.tools → tools.sandbox.tools.",
     );
@@ -1118,7 +1118,7 @@ describe("legacy config detection", () => {
       enabled: true,
       allowFrom: { discord: ["user:1"] },
     });
-    expect(res.config?.tools?.bash).toEqual({ timeoutSec: 12 });
+    expect(res.config?.tools?.exec).toEqual({ timeoutSec: 12 });
     expect(res.config?.tools?.sandbox?.tools).toEqual({
       allow: ["browser.open"],
     });

src/config/legacy.ts

@@ -179,7 +179,7 @@ const LEGACY_CONFIG_RULES: LegacyConfigRule[] = [
   {
     path: ["agent"],
     message:
-      "agent.* was moved; use agents.defaults (and tools.* for tool/elevated/bash settings) instead (run `clawdbot doctor` to migrate).",
+      "agent.* was moved; use agents.defaults (and tools.* for tool/elevated/exec settings) instead (run `clawdbot doctor` to migrate).",
   },
   {
     path: ["agent", "model"],
@@ -819,9 +819,11 @@ const LEGACY_CONFIG_MIGRATIONS: LegacyConfigMigration[] = [
 
       const bash = getRecord(agent.bash);
       if (bash) {
-        if (tools.bash === undefined) {
-          tools.bash = bash;
-          changes.push("Moved agent.bash → tools.bash.");
+        if (tools.exec === undefined && tools.bash === undefined) {
+          tools.exec = bash;
+          changes.push("Moved agent.bash → tools.exec.");
+        } else if (tools.exec !== undefined) {
+          changes.push("Removed agent.bash (tools.exec already set).");
         } else {
           changes.push("Removed agent.bash (tools.bash already set).");
         }

src/config/types.ts

@@ -972,7 +972,7 @@ export type QueueConfig = {
 export type AgentToolsConfig = {
   allow?: string[];
   deny?: string[];
-  /** Per-agent elevated bash gate (can only further restrict global tools.elevated). */
+  /** Per-agent elevated exec gate (can only further restrict global tools.elevated). */
   elevated?: {
     /** Enable or disable elevated mode for this agent (default: true). */
     enabled?: boolean;
@@ -1003,14 +1003,23 @@ export type ToolsConfig = {
     /** Allowlist of agent ids or patterns (implementation-defined). */
     allow?: string[];
   };
-  /** Elevated bash permissions for the host machine. */
+  /** Elevated exec permissions for the host machine. */
   elevated?: {
     /** Enable or disable elevated mode (default: true). */
     enabled?: boolean;
     /** Approved senders for /elevated (per-provider allowlists). */
     allowFrom?: AgentElevatedAllowFromConfig;
   };
-  /** Bash tool defaults. */
+  /** Exec tool defaults. */
+  exec?: {
+    /** Default time (ms) before an exec command auto-backgrounds. */
+    backgroundMs?: number;
+    /** Default timeout (seconds) before auto-killing exec commands. */
+    timeoutSec?: number;
+    /** How long to keep finished sessions in memory (ms). */
+    cleanupMs?: number;
+  };
+  /** @deprecated Use tools.exec. */
   bash?: {
     /** Default time (ms) before a bash command auto-backgrounds. */
     backgroundMs?: number;

src/config/zod-schema.ts

@@ -905,6 +905,13 @@ const ToolsSchema = z
         allowFrom: ElevatedAllowFromSchema,
       })
       .optional(),
+    exec: z
+      .object({
+        backgroundMs: z.number().int().positive().optional(),
+        timeoutSec: z.number().int().positive().optional(),
+        cleanupMs: z.number().int().positive().optional(),
+      })
+      .optional(),
     bash: z
       .object({
         backgroundMs: z.number().int().positive().optional(),