@vm0/cli 9.85.1 → 9.86.0

package/zero.js

@@ -2,6 +2,7 @@
 import {
   ApiRequestError,
   CONNECTOR_TYPES,
+  EventRenderer,
   MODEL_PROVIDER_TYPES,
   allowsCustomModel,
   configureGlobalProxyFromEnv,
@@ -9,6 +10,7 @@ import {
   createZeroAgent,
   createZeroComputerConnector,
   createZeroConnectorSession,
+  createZeroRun,
   decodeZeroTokenPayload,
   deleteZeroAgent,
   deleteZeroComputerConnector,
@@ -44,6 +46,8 @@ import {
   getZeroConnectorSession,
   getZeroOrg,
   getZeroOrgMembers,
+  getZeroRun,
+  getZeroRunAgentEvents,
   getZeroUserPreferences,
   hasAuthMethods,
   hasModelSelection,
@@ -51,6 +55,7 @@ import {
   inviteZeroOrgMember,
   isFeatureEnabled,
   isInteractive,
+  isUUID,
   leaveZeroOrg,
   listZeroAgents,
   listZeroConnectors,
@@ -61,12 +66,14 @@ import {
   listZeroSchedules,
   listZeroSecrets,
   listZeroVariables,
+  parseEvent,
   postAskUserQuestion,
   promptConfirm,
   promptPassword,
   promptSelect,
   promptText,
   removeZeroOrgMember,
+  renderRunCreated,
   resolveCompose,
   resolveZeroScheduleByAgent,
   saveConfig,
@@ -84,10 +91,10 @@ import {
   updateZeroUserPreferences,
   upsertZeroOrgModelProvider,
   withErrorHandler
-} from "./chunk-FEUDHROP.js";
+} from "./chunk-MAYVCUG7.js";
 
 // src/zero.ts
-import { Command as Command59 } from "commander";
+import { Command as Command61 } from "commander";
 
 // src/commands/zero/org/index.ts
 import { Command as Command23 } from "commander";
@@ -1955,12 +1962,184 @@ var zeroPreferenceCommand = new Command37().name("preference").description("View
   })
 );
 
+// src/commands/zero/run/run.ts
+import { Command as Command38 } from "commander";
+
+// src/commands/zero/run/shared.ts
+import chalk32 from "chalk";
+function toRunResult(result) {
+  const { checkpointId, agentSessionId, conversationId } = result;
+  if (!checkpointId || !agentSessionId || !conversationId) {
+    return void 0;
+  }
+  return { checkpointId, agentSessionId, conversationId };
+}
+async function pollZeroEvents(runId, options) {
+  const renderer = new EventRenderer({ verbose: options?.verbose });
+  let lastSequence = -1;
+  let complete = false;
+  let result = { succeeded: true, runId };
+  const pollIntervalMs = 1e3;
+  while (!complete) {
+    const eventsResponse = await getZeroRunAgentEvents(runId, {
+      since: lastSequence,
+      limit: 100,
+      order: "asc"
+    });
+    for (const event of eventsResponse.events) {
+      const eventData = event.eventData;
+      const parsed = parseEvent(eventData);
+      if (parsed) {
+        renderer.render(parsed);
+      }
+    }
+    if (eventsResponse.events.length > 0) {
+      lastSequence = Math.max(
+        ...eventsResponse.events.map((e) => e.sequenceNumber)
+      );
+    }
+    const runResponse = await getZeroRun(runId);
+    const runStatus = runResponse.status;
+    if (runStatus === "completed") {
+      complete = true;
+      EventRenderer.renderRunCompleted(
+        runResponse.result ? toRunResult(runResponse.result) : void 0
+      );
+      result = {
+        succeeded: true,
+        runId,
+        sessionId: runResponse.result?.agentSessionId,
+        checkpointId: runResponse.result?.checkpointId
+      };
+    } else if (runStatus === "failed") {
+      complete = true;
+      EventRenderer.renderRunFailed(runResponse.error, runId);
+      result = { succeeded: false, runId };
+    } else if (runStatus === "timeout") {
+      complete = true;
+      console.error(chalk32.red("\n\u2717 Run timed out"));
+      result = { succeeded: false, runId };
+    } else if (runStatus === "cancelled") {
+      complete = true;
+      console.error(chalk32.yellow("\n\u2717 Run cancelled"));
+      result = { succeeded: false, runId };
+    }
+    if (!complete) {
+      await new Promise((resolve) => setTimeout(resolve, pollIntervalMs));
+    }
+  }
+  return result;
+}
+function showZeroNextSteps(result) {
+  const { sessionId } = result;
+  console.log();
+  if (sessionId) {
+    console.log("  Continue delegation:");
+    console.log(
+      chalk32.cyan(`    zero run continue ${sessionId} "your next prompt"`)
+    );
+  }
+}
+
+// src/commands/zero/run/run.ts
+var mainRunCommand = new Command38().name("run").description("Delegate a task to a teammate agent").argument("<agent-id>", "Agent UUID (from `zero agent list`)").argument("<prompt>", "Task prompt for the agent").option(
+  "--append-system-prompt <text>",
+  "Append text to the agent's system prompt"
+).option(
+  "--model-provider <type>",
+  "Override model provider (e.g., anthropic-api-key)"
+).option("--verbose", "Show full tool inputs and outputs").action(
+  withErrorHandler(
+    async (agentId, prompt, options) => {
+      if (!isUUID(agentId)) {
+        throw new Error(`Invalid agent ID format: ${agentId}`, {
+          cause: new Error(
+            "Agent ID must be a valid UUID. Use `zero agent list` to find agent IDs."
+          )
+        });
+      }
+      const response = await createZeroRun({
+        agentId,
+        prompt,
+        appendSystemPrompt: options.appendSystemPrompt,
+        modelProvider: options.modelProvider
+      });
+      if (response.status === "failed") {
+        throw new Error(
+          "Run preparation failed",
+          response.error ? { cause: new Error(response.error) } : void 0
+        );
+      }
+      renderRunCreated(response);
+      const result = await pollZeroEvents(response.runId, {
+        verbose: options.verbose
+      });
+      if (!result.succeeded) {
+        throw new Error("Run failed");
+      }
+      showZeroNextSteps(result);
+    }
+  )
+);
+
+// src/commands/zero/run/continue.ts
+import { Command as Command39 } from "commander";
+var continueCommand = new Command39().name("continue").description("Continue a previous delegation from a session").argument("<session-id>", "Session ID from a previous run").argument("<prompt>", "Follow-up prompt for the agent").option(
+  "--append-system-prompt <text>",
+  "Append text to the agent's system prompt"
+).option(
+  "--model-provider <type>",
+  "Override model provider (e.g., anthropic-api-key)"
+).option("--verbose", "Show full tool inputs and outputs").action(
+  withErrorHandler(
+    async (sessionId, prompt, options) => {
+      if (!isUUID(sessionId)) {
+        throw new Error(`Invalid session ID format: ${sessionId}`, {
+          cause: new Error("Session ID must be a valid UUID")
+        });
+      }
+      const response = await createZeroRun({
+        sessionId,
+        prompt,
+        appendSystemPrompt: options.appendSystemPrompt,
+        modelProvider: options.modelProvider
+      });
+      if (response.status === "failed") {
+        throw new Error(
+          "Run preparation failed",
+          response.error ? { cause: new Error(response.error) } : void 0
+        );
+      }
+      renderRunCreated(response);
+      const result = await pollZeroEvents(response.runId, {
+        verbose: options.verbose
+      });
+      if (!result.succeeded) {
+        throw new Error("Run failed");
+      }
+      showZeroNextSteps(result);
+    }
+  )
+);
+
+// src/commands/zero/run/index.ts
+mainRunCommand.addCommand(continueCommand);
+mainRunCommand.addHelpText(
+  "after",
+  `
+Delegation workflow:
+  Discover teammates:    zero agent list
+  Delegate a task:       zero run <agent-id> "your task"
+  Continue delegation:   zero run continue <session-id> "follow up"`
+);
+var zeroRunCommand = mainRunCommand;
+
 // src/commands/zero/schedule/index.ts
-import { Command as Command44 } from "commander";
+import { Command as Command46 } from "commander";
 
 // src/commands/zero/schedule/setup.ts
-import { Command as Command38 } from "commander";
-import chalk32 from "chalk";
+import { Command as Command40 } from "commander";
+import chalk33 from "chalk";
 var FREQUENCY_CHOICES = [
   { title: "Daily", value: "daily", description: "Run every day" },
   {
@@ -2170,7 +2349,7 @@ async function gatherTimezone(optionTimezone, existingTimezone) {
     userTimezone = prefs.timezone;
   } catch {
     console.log(
-      chalk32.dim("Could not fetch timezone preference, using detected timezone")
+      chalk33.dim("Could not fetch timezone preference, using detected timezone")
     );
   }
   const defaultTimezone = userTimezone || detectTimezone();
@@ -2295,7 +2474,7 @@ async function buildAndDeploy(params) {
   }
   console.log(
     `
-Deploying schedule for agent ${chalk32.cyan(params.agentName)}...`
+Deploying schedule for agent ${chalk33.cyan(params.agentName)}...`
   );
   const deployResult = await deployZeroSchedule({
     name: params.scheduleName,
@@ -2317,58 +2496,58 @@ Deploying schedule for agent ${chalk32.cyan(params.agentName)}...`
 }
 function displayDeployResult(scheduleName, deployResult) {
   if (deployResult.created) {
-    console.log(chalk32.green(`\u2713 Schedule "${scheduleName}" created`));
+    console.log(chalk33.green(`\u2713 Schedule "${scheduleName}" created`));
   } else {
-    console.log(chalk32.green(`\u2713 Schedule "${scheduleName}" updated`));
+    console.log(chalk33.green(`\u2713 Schedule "${scheduleName}" updated`));
   }
-  console.log(chalk32.dim(`  Timezone: ${deployResult.schedule.timezone}`));
+  console.log(chalk33.dim(`  Timezone: ${deployResult.schedule.timezone}`));
   if (deployResult.schedule.triggerType === "loop" && deployResult.schedule.intervalSeconds != null) {
     console.log(
-      chalk32.dim(
+      chalk33.dim(
         `  Mode: Loop (interval ${deployResult.schedule.intervalSeconds}s)`
       )
     );
   } else if (deployResult.schedule.cronExpression) {
-    console.log(chalk32.dim(`  Cron: ${deployResult.schedule.cronExpression}`));
+    console.log(chalk33.dim(`  Cron: ${deployResult.schedule.cronExpression}`));
     if (deployResult.schedule.nextRunAt) {
       const nextRun = formatInTimezone(
         deployResult.schedule.nextRunAt,
         deployResult.schedule.timezone
       );
-      console.log(chalk32.dim(`  Next run: ${nextRun}`));
+      console.log(chalk33.dim(`  Next run: ${nextRun}`));
     }
   } else if (deployResult.schedule.atTime) {
     const atTimeFormatted = formatInTimezone(
       deployResult.schedule.atTime,
       deployResult.schedule.timezone
     );
-    console.log(chalk32.dim(`  At: ${atTimeFormatted}`));
+    console.log(chalk33.dim(`  At: ${atTimeFormatted}`));
   }
 }
 async function tryEnableSchedule(scheduleName, agentId, agentName) {
   try {
     await enableZeroSchedule({ name: scheduleName, agentId });
-    console.log(chalk32.green(`\u2713 Schedule "${scheduleName}" enabled`));
+    console.log(chalk33.green(`\u2713 Schedule "${scheduleName}" enabled`));
   } catch (error) {
-    console.error(chalk32.yellow("\u26A0 Failed to enable schedule"));
+    console.error(chalk33.yellow("\u26A0 Failed to enable schedule"));
     if (error instanceof ApiRequestError) {
       if (error.code === "SCHEDULE_PAST") {
-        console.error(chalk32.dim("  Scheduled time has already passed"));
+        console.error(chalk33.dim("  Scheduled time has already passed"));
       } else {
-        console.error(chalk32.dim(`  ${error.message}`));
+        console.error(chalk33.dim(`  ${error.message}`));
       }
     } else if (error instanceof Error) {
-      console.error(chalk32.dim(`  ${error.message}`));
+      console.error(chalk33.dim(`  ${error.message}`));
     }
     console.log(
-      `  To enable manually: ${chalk32.cyan(`zero schedule enable ${agentName}`)}`
+      `  To enable manually: ${chalk33.cyan(`zero schedule enable ${agentName}`)}`
     );
   }
 }
 function showEnableHint(agentName) {
   console.log();
   console.log(
-    `  To enable: ${chalk32.cyan(`zero schedule enable ${agentName}`)}`
+    `  To enable: ${chalk33.cyan(`zero schedule enable ${agentName}`)}`
   );
 }
 async function handleScheduleEnabling(params) {
@@ -2390,7 +2569,7 @@ async function handleScheduleEnabling(params) {
     showEnableHint(agentName);
   }
 }
-var setupCommand2 = new Command38().name("setup").description("Create or edit a schedule for a zero agent").argument("<agent-id>", "Agent ID").option("-n, --name <schedule-name>", 'Schedule name (default: "default")').option("-f, --frequency <type>", "Frequency: daily|weekly|monthly|once|loop").option("-t, --time <HH:MM>", "Time to run (24-hour format)").option("-d, --day <day>", "Day of week (mon-sun) or day of month (1-31)").option("-i, --interval <seconds>", "Interval in seconds for loop mode").option("-z, --timezone <tz>", "IANA timezone").option("-p, --prompt <text>", "Prompt to run").option("--artifact-name <name>", "Artifact name", "artifact").option("-e, --enable", "Enable schedule immediately after creation").option("--notify-email", "Enable email notifications (default: true)").option("--no-notify-email", "Disable email notifications").option("--notify-slack", "Enable Slack notifications (default: true)").option("--no-notify-slack", "Disable Slack notifications").action(
+var setupCommand2 = new Command40().name("setup").description("Create or edit a schedule for a zero agent").argument("<agent-id>", "Agent ID").option("-n, --name <schedule-name>", 'Schedule name (default: "default")').option("-f, --frequency <type>", "Frequency: daily|weekly|monthly|once|loop").option("-t, --time <HH:MM>", "Time to run (24-hour format)").option("-d, --day <day>", "Day of week (mon-sun) or day of month (1-31)").option("-i, --interval <seconds>", "Interval in seconds for loop mode").option("-z, --timezone <tz>", "IANA timezone").option("-p, --prompt <text>", "Prompt to run").option("--artifact-name <name>", "Artifact name", "artifact").option("-e, --enable", "Enable schedule immediately after creation").option("--notify-email", "Enable email notifications (default: true)").option("--no-notify-email", "Disable email notifications").option("--notify-slack", "Enable Slack notifications (default: true)").option("--no-notify-slack", "Disable Slack notifications").action(
   withErrorHandler(async (agentIdentifier, options) => {
     const compose = await resolveCompose(agentIdentifier);
     if (!compose) {
@@ -2404,7 +2583,7 @@ var setupCommand2 = new Command38().name("setup").description("Create or edit a
     );
     const agentName = compose.name;
     console.log(
-      chalk32.dim(
+      chalk33.dim(
         existingSchedule ? `Editing existing schedule for agent ${agentName}` : `Creating new schedule for agent ${agentName}`
       )
     );
@@ -2414,12 +2593,12 @@ var setupCommand2 = new Command38().name("setup").description("Create or edit a
       defaults.frequency
     );
     if (!frequency) {
-      console.log(chalk32.dim("Cancelled"));
+      console.log(chalk33.dim("Cancelled"));
       return;
     }
     const timing = await gatherTiming(frequency, options, defaults);
     if (!timing) {
-      console.log(chalk32.dim("Cancelled"));
+      console.log(chalk33.dim("Cancelled"));
       return;
     }
     const { day, time, atTime, intervalSeconds } = timing;
@@ -2428,7 +2607,7 @@ var setupCommand2 = new Command38().name("setup").description("Create or edit a
       existingSchedule?.timezone
     );
     if (!timezone) {
-      console.log(chalk32.dim("Cancelled"));
+      console.log(chalk33.dim("Cancelled"));
       return;
     }
     const promptText_ = await gatherPromptText(
@@ -2436,7 +2615,7 @@ var setupCommand2 = new Command38().name("setup").description("Create or edit a
       existingSchedule?.prompt
     );
     if (!promptText_) {
-      console.log(chalk32.dim("Cancelled"));
+      console.log(chalk33.dim("Cancelled"));
       return;
     }
     const { notifyEmail, notifySlack } = await gatherNotificationPreferences(
@@ -2472,15 +2651,15 @@ var setupCommand2 = new Command38().name("setup").description("Create or edit a
 );
 
 // src/commands/zero/schedule/list.ts
-import { Command as Command39 } from "commander";
-import chalk33 from "chalk";
-var listCommand7 = new Command39().name("list").alias("ls").description("List all zero schedules").action(
+import { Command as Command41 } from "commander";
+import chalk34 from "chalk";
+var listCommand7 = new Command41().name("list").alias("ls").description("List all zero schedules").action(
   withErrorHandler(async () => {
     const result = await listZeroSchedules();
     if (result.schedules.length === 0) {
-      console.log(chalk33.dim("No schedules found"));
+      console.log(chalk34.dim("No schedules found"));
       console.log(
-        chalk33.dim("  Create one with: zero schedule setup <agent-id>")
+        chalk34.dim("  Create one with: zero schedule setup <agent-id>")
       );
       return;
     }
@@ -2505,10 +2684,10 @@ var listCommand7 = new Command39().name("list").alias("ls").description("List al
       "STATUS".padEnd(8),
       "NEXT RUN"
     ].join("  ");
-    console.log(chalk33.dim(header));
+    console.log(chalk34.dim(header));
     for (const schedule of result.schedules) {
       const trigger = schedule.cronExpression ? `${schedule.cronExpression} (${schedule.timezone})` : schedule.atTime || "-";
-      const status = schedule.enabled ? chalk33.green("enabled") : chalk33.yellow("disabled");
+      const status = schedule.enabled ? chalk34.green("enabled") : chalk34.yellow("disabled");
       const nextRun = schedule.enabled ? formatRelativeTime(schedule.nextRunAt) : "-";
       const row = [
         schedule.agentId.padEnd(agentWidth),
@@ -2523,33 +2702,33 @@ var listCommand7 = new Command39().name("list").alias("ls").description("List al
 );
 
 // src/commands/zero/schedule/status.ts
-import { Command as Command40 } from "commander";
-import chalk34 from "chalk";
+import { Command as Command42 } from "commander";
+import chalk35 from "chalk";
 function formatDateTimeStyled(dateStr) {
-  if (!dateStr) return chalk34.dim("-");
+  if (!dateStr) return chalk35.dim("-");
   const formatted = formatDateTime(dateStr);
-  return formatted.replace(/\(([^)]+)\)$/, chalk34.dim("($1)"));
+  return formatted.replace(/\(([^)]+)\)$/, chalk35.dim("($1)"));
 }
 function formatTrigger(schedule) {
   if (schedule.triggerType === "loop" && schedule.intervalSeconds !== null) {
-    return `interval ${schedule.intervalSeconds}s ${chalk34.dim("(loop)")}`;
+    return `interval ${schedule.intervalSeconds}s ${chalk35.dim("(loop)")}`;
   }
   if (schedule.cronExpression) {
     return schedule.cronExpression;
   }
   if (schedule.atTime) {
-    return `${schedule.atTime} ${chalk34.dim("(one-time)")}`;
+    return `${schedule.atTime} ${chalk35.dim("(one-time)")}`;
   }
-  return chalk34.dim("-");
+  return chalk35.dim("-");
 }
 function printRunConfiguration(schedule) {
-  const statusText = schedule.enabled ? chalk34.green("enabled") : chalk34.yellow("disabled");
+  const statusText = schedule.enabled ? chalk35.green("enabled") : chalk35.yellow("disabled");
   console.log(`${"Status:".padEnd(16)}${statusText}`);
   console.log(
-    `${"Agent:".padEnd(16)}${schedule.agentId} ${chalk34.dim(`(${schedule.orgSlug})`)}`
+    `${"Agent:".padEnd(16)}${schedule.agentId} ${chalk35.dim(`(${schedule.orgSlug})`)}`
   );
   const promptPreview = schedule.prompt.length > 60 ? schedule.prompt.slice(0, 57) + "..." : schedule.prompt;
-  console.log(`${"Prompt:".padEnd(16)}${chalk34.dim(promptPreview)}`);
+  console.log(`${"Prompt:".padEnd(16)}${chalk35.dim(promptPreview)}`);
   if (schedule.vars && Object.keys(schedule.vars).length > 0) {
     console.log(
       `${"Variables:".padEnd(16)}${Object.keys(schedule.vars).join(", ")}`
@@ -2578,11 +2757,11 @@ function printTimeSchedule(schedule) {
     );
   }
   if (schedule.triggerType === "loop") {
-    const failureText = schedule.consecutiveFailures > 0 ? chalk34.yellow(`${schedule.consecutiveFailures}/3`) : chalk34.dim("0/3");
+    const failureText = schedule.consecutiveFailures > 0 ? chalk35.yellow(`${schedule.consecutiveFailures}/3`) : chalk35.dim("0/3");
     console.log(`${"Failures:".padEnd(16)}${failureText}`);
   }
 }
-var statusCommand3 = new Command40().name("status").description("Show detailed status of a zero schedule").argument("<agent-id>", "Agent ID").option(
+var statusCommand3 = new Command42().name("status").description("Show detailed status of a zero schedule").argument("<agent-id>", "Agent ID").option(
   "-n, --name <schedule-name>",
   "Schedule name (required when agent has multiple schedules)"
 ).action(
@@ -2592,8 +2771,8 @@ var statusCommand3 = new Command40().name("status").description("Show detailed s
       options.name
     );
     console.log();
-    console.log(`Schedule for agent: ${chalk34.cyan(agentName)}`);
-    console.log(chalk34.dim("\u2501".repeat(50)));
+    console.log(`Schedule for agent: ${chalk35.cyan(agentName)}`);
+    console.log(chalk35.dim("\u2501".repeat(50)));
     printRunConfiguration(schedule);
     printTimeSchedule(schedule);
     console.log();
@@ -2601,9 +2780,9 @@ var statusCommand3 = new Command40().name("status").description("Show detailed s
 );
 
 // src/commands/zero/schedule/delete.ts
-import { Command as Command41 } from "commander";
-import chalk35 from "chalk";
-var deleteCommand3 = new Command41().name("delete").alias("rm").description("Delete a zero schedule").argument("<agent-id>", "Agent ID").option(
+import { Command as Command43 } from "commander";
+import chalk36 from "chalk";
+var deleteCommand3 = new Command43().name("delete").alias("rm").description("Delete a zero schedule").argument("<agent-id>", "Agent ID").option(
   "-n, --name <schedule-name>",
   "Schedule name (required when agent has multiple schedules)"
 ).option("-y, --yes", "Skip confirmation prompt").action(
@@ -2618,11 +2797,11 @@ var deleteCommand3 = new Command41().name("delete").alias("rm").description("Del
           throw new Error("--yes flag is required in non-interactive mode");
         }
         const confirmed = await promptConfirm(
-          `Delete schedule for agent ${chalk35.cyan(agentName)}?`,
+          `Delete schedule for agent ${chalk36.cyan(agentName)}?`,
           false
         );
         if (!confirmed) {
-          console.log(chalk35.dim("Cancelled"));
+          console.log(chalk36.dim("Cancelled"));
           return;
         }
       }
@@ -2630,15 +2809,15 @@ var deleteCommand3 = new Command41().name("delete").alias("rm").description("Del
         name: resolved.name,
         agentId: resolved.agentId
       });
-      console.log(chalk35.green(`\u2713 Schedule "${resolved.name}" deleted`));
+      console.log(chalk36.green(`\u2713 Schedule "${resolved.name}" deleted`));
     }
   )
 );
 
 // src/commands/zero/schedule/enable.ts
-import { Command as Command42 } from "commander";
-import chalk36 from "chalk";
-var enableCommand = new Command42().name("enable").description("Enable a zero schedule").argument("<agent-id>", "Agent ID").option(
+import { Command as Command44 } from "commander";
+import chalk37 from "chalk";
+var enableCommand = new Command44().name("enable").description("Enable a zero schedule").argument("<agent-id>", "Agent ID").option(
   "-n, --name <schedule-name>",
   "Schedule name (required when agent has multiple schedules)"
 ).action(
@@ -2651,14 +2830,14 @@ var enableCommand = new Command42().name("enable").description("Enable a zero sc
       name: resolved.name,
       agentId: resolved.agentId
     });
-    console.log(chalk36.green(`\u2713 Schedule "${resolved.name}" enabled`));
+    console.log(chalk37.green(`\u2713 Schedule "${resolved.name}" enabled`));
   })
 );
 
 // src/commands/zero/schedule/disable.ts
-import { Command as Command43 } from "commander";
-import chalk37 from "chalk";
-var disableCommand = new Command43().name("disable").description("Disable a zero schedule").argument("<agent-id>", "Agent ID").option(
+import { Command as Command45 } from "commander";
+import chalk38 from "chalk";
+var disableCommand = new Command45().name("disable").description("Disable a zero schedule").argument("<agent-id>", "Agent ID").option(
   "-n, --name <schedule-name>",
   "Schedule name (required when agent has multiple schedules)"
 ).action(
@@ -2671,75 +2850,75 @@ var disableCommand = new Command43().name("disable").description("Disable a zero
       name: resolved.name,
       agentId: resolved.agentId
     });
-    console.log(chalk37.green(`\u2713 Schedule "${resolved.name}" disabled`));
+    console.log(chalk38.green(`\u2713 Schedule "${resolved.name}" disabled`));
   })
 );
 
 // src/commands/zero/schedule/index.ts
-var zeroScheduleCommand = new Command44().name("schedule").description("Create or manage recurring scheduled tasks").addCommand(setupCommand2).addCommand(listCommand7).addCommand(statusCommand3).addCommand(deleteCommand3).addCommand(enableCommand).addCommand(disableCommand);
+var zeroScheduleCommand = new Command46().name("schedule").description("Create or manage recurring scheduled tasks").addCommand(setupCommand2).addCommand(listCommand7).addCommand(statusCommand3).addCommand(deleteCommand3).addCommand(enableCommand).addCommand(disableCommand);
 
 // src/commands/zero/secret/index.ts
-import { Command as Command48 } from "commander";
+import { Command as Command50 } from "commander";
 
 // src/commands/zero/secret/list.ts
-import { Command as Command45 } from "commander";
-import chalk38 from "chalk";
-var listCommand8 = new Command45().name("list").alias("ls").description("List all secrets").action(
+import { Command as Command47 } from "commander";
+import chalk39 from "chalk";
+var listCommand8 = new Command47().name("list").alias("ls").description("List all secrets").action(
   withErrorHandler(async () => {
     const result = await listZeroSecrets();
     if (result.secrets.length === 0) {
-      console.log(chalk38.dim("No secrets found"));
+      console.log(chalk39.dim("No secrets found"));
       console.log();
       console.log("To add a secret:");
-      console.log(chalk38.cyan("  zero secret set MY_API_KEY --body <value>"));
+      console.log(chalk39.cyan("  zero secret set MY_API_KEY --body <value>"));
       return;
     }
-    console.log(chalk38.bold("Secrets:"));
+    console.log(chalk39.bold("Secrets:"));
     console.log();
     for (const secret of result.secrets) {
       let typeIndicator = "";
       let derivedLine = null;
       if (secret.type === "model-provider") {
-        typeIndicator = chalk38.dim(" [model-provider]");
+        typeIndicator = chalk39.dim(" [model-provider]");
       } else if (secret.type === "connector") {
         const derived = getConnectorDerivedNames(secret.name);
         if (derived) {
-          typeIndicator = chalk38.dim(` [${derived.connectorLabel} connector]`);
-          derivedLine = chalk38.dim(
+          typeIndicator = chalk39.dim(` [${derived.connectorLabel} connector]`);
+          derivedLine = chalk39.dim(
             `Available as: ${derived.envVarNames.join(", ")}`
           );
         } else {
-          typeIndicator = chalk38.dim(" [connector]");
+          typeIndicator = chalk39.dim(" [connector]");
         }
       } else if (secret.type === "user") {
         const derived = getConnectorDerivedNames(secret.name);
         if (derived) {
-          typeIndicator = chalk38.dim(` [${derived.connectorLabel} connector]`);
-          derivedLine = chalk38.dim(
+          typeIndicator = chalk39.dim(` [${derived.connectorLabel} connector]`);
+          derivedLine = chalk39.dim(
             `Available as: ${derived.envVarNames.join(", ")}`
           );
         }
       }
-      console.log(`  ${chalk38.cyan(secret.name)}${typeIndicator}`);
+      console.log(`  ${chalk39.cyan(secret.name)}${typeIndicator}`);
       if (derivedLine) {
         console.log(`    ${derivedLine}`);
       }
       if (secret.description) {
-        console.log(`    ${chalk38.dim(secret.description)}`);
+        console.log(`    ${chalk39.dim(secret.description)}`);
       }
       console.log(
-        `    ${chalk38.dim(`Updated: ${new Date(secret.updatedAt).toLocaleString()}`)}`
+        `    ${chalk39.dim(`Updated: ${new Date(secret.updatedAt).toLocaleString()}`)}`
       );
       console.log();
     }
-    console.log(chalk38.dim(`Total: ${result.secrets.length} secret(s)`));
+    console.log(chalk39.dim(`Total: ${result.secrets.length} secret(s)`));
   })
 );
 
 // src/commands/zero/secret/set.ts
-import { Command as Command46 } from "commander";
-import chalk39 from "chalk";
-var setCommand4 = new Command46().name("set").description("Create or update a secret").argument("<name>", "Secret name (uppercase, e.g., MY_API_KEY)").option(
+import { Command as Command48 } from "commander";
+import chalk40 from "chalk";
+var setCommand4 = new Command48().name("set").description("Create or update a secret").argument("<name>", "Secret name (uppercase, e.g., MY_API_KEY)").option(
   "-b, --body <value>",
   "Secret value (required in non-interactive mode)"
 ).option("-d, --description <description>", "Optional description").action(
@@ -2751,7 +2930,7 @@ var setCommand4 = new Command46().name("set").description("Create or update a se
       } else if (isInteractive()) {
         const prompted = await promptPassword("Enter secret value:");
         if (prompted === void 0) {
-          console.log(chalk39.dim("Cancelled"));
+          console.log(chalk40.dim("Cancelled"));
           return;
         }
         value = prompted;
@@ -2779,15 +2958,15 @@ var setCommand4 = new Command46().name("set").description("Create or update a se
         }
         throw error;
       }
-      console.log(chalk39.green(`\u2713 Secret "${secret.name}" saved`));
+      console.log(chalk40.green(`\u2713 Secret "${secret.name}" saved`));
     }
   )
 );
 
 // src/commands/zero/secret/delete.ts
-import { Command as Command47 } from "commander";
-import chalk40 from "chalk";
-var deleteCommand4 = new Command47().name("delete").description("Delete a secret").argument("<name>", "Secret name to delete").option("-y, --yes", "Skip confirmation prompt").action(
+import { Command as Command49 } from "commander";
+import chalk41 from "chalk";
+var deleteCommand4 = new Command49().name("delete").description("Delete a secret").argument("<name>", "Secret name to delete").option("-y, --yes", "Skip confirmation prompt").action(
   withErrorHandler(async (name, options) => {
     if (!options.yes) {
       if (!isInteractive()) {
@@ -2798,29 +2977,29 @@ var deleteCommand4 = new Command47().name("delete").description("Delete a secret
         false
       );
       if (!confirmed) {
-        console.log(chalk40.dim("Cancelled"));
+        console.log(chalk41.dim("Cancelled"));
         return;
       }
     }
     await deleteZeroSecret(name);
-    console.log(chalk40.green(`\u2713 Secret "${name}" deleted`));
+    console.log(chalk41.green(`\u2713 Secret "${name}" deleted`));
   })
 );
 
 // src/commands/zero/secret/index.ts
-var zeroSecretCommand = new Command48().name("secret").description("Read or write secrets (API keys, tokens)").addCommand(listCommand8).addCommand(setCommand4).addCommand(deleteCommand4);
+var zeroSecretCommand = new Command50().name("secret").description("Read or write secrets (API keys, tokens)").addCommand(listCommand8).addCommand(setCommand4).addCommand(deleteCommand4);
 
 // src/commands/zero/slack/index.ts
-import { Command as Command51 } from "commander";
+import { Command as Command53 } from "commander";
 
 // src/commands/zero/slack/message/index.ts
-import { Command as Command50 } from "commander";
+import { Command as Command52 } from "commander";
 
 // src/commands/zero/slack/message/send.ts
 import { readFileSync as readFileSync3 } from "fs";
-import { Command as Command49 } from "commander";
-import chalk41 from "chalk";
-var sendCommand = new Command49().name("send").description("Send a message to a Slack channel").requiredOption("-c, --channel <id>", "Channel ID").option("-t, --text <message>", "Message text").option("--thread <ts>", "Thread timestamp for replies").option("--blocks <json>", "Block Kit JSON string").action(
+import { Command as Command51 } from "commander";
+import chalk42 from "chalk";
+var sendCommand = new Command51().name("send").description("Send a message to a Slack channel").requiredOption("-c, --channel <id>", "Channel ID").option("-t, --text <message>", "Message text").option("--thread <ts>", "Thread timestamp for replies").option("--blocks <json>", "Block Kit JSON string").action(
   withErrorHandler(
     async (options) => {
       let text = options.text;
@@ -2854,60 +3033,60 @@ var sendCommand = new Command49().name("send").description("Send a message to a
         blocks
       });
       const tsInfo = result.ts ? ` (ts: ${result.ts})` : "";
-      console.log(chalk41.green(`\u2713 Message sent${tsInfo}`));
+      console.log(chalk42.green(`\u2713 Message sent${tsInfo}`));
     }
   )
 );
 
 // src/commands/zero/slack/message/index.ts
-var zeroSlackMessageCommand = new Command50().name("message").description("Manage Slack messages").addCommand(sendCommand);
+var zeroSlackMessageCommand = new Command52().name("message").description("Manage Slack messages").addCommand(sendCommand);
 
 // src/commands/zero/slack/index.ts
-var zeroSlackCommand = new Command51().name("slack").description("Send messages to Slack channels as the bot").addCommand(zeroSlackMessageCommand);
+var zeroSlackCommand = new Command53().name("slack").description("Send messages to Slack channels as the bot").addCommand(zeroSlackMessageCommand);
 
 // src/commands/zero/variable/index.ts
-import { Command as Command55 } from "commander";
+import { Command as Command57 } from "commander";
 
 // src/commands/zero/variable/list.ts
-import { Command as Command52 } from "commander";
-import chalk42 from "chalk";
+import { Command as Command54 } from "commander";
+import chalk43 from "chalk";
 function truncateValue2(value, maxLength = 60) {
   if (value.length <= maxLength) {
     return value;
   }
   return value.slice(0, maxLength - 15) + "... [truncated]";
 }
-var listCommand9 = new Command52().name("list").alias("ls").description("List all variables").action(
+var listCommand9 = new Command54().name("list").alias("ls").description("List all variables").action(
   withErrorHandler(async () => {
     const result = await listZeroVariables();
     if (result.variables.length === 0) {
-      console.log(chalk42.dim("No variables found"));
+      console.log(chalk43.dim("No variables found"));
       console.log();
       console.log("To add a variable:");
-      console.log(chalk42.cyan("  zero variable set MY_VAR <value>"));
+      console.log(chalk43.cyan("  zero variable set MY_VAR <value>"));
       return;
     }
-    console.log(chalk42.bold("Variables:"));
+    console.log(chalk43.bold("Variables:"));
     console.log();
     for (const variable of result.variables) {
       const displayValue = truncateValue2(variable.value);
-      console.log(`  ${chalk42.cyan(variable.name)} = ${displayValue}`);
+      console.log(`  ${chalk43.cyan(variable.name)} = ${displayValue}`);
       if (variable.description) {
-        console.log(`    ${chalk42.dim(variable.description)}`);
+        console.log(`    ${chalk43.dim(variable.description)}`);
       }
       console.log(
-        `    ${chalk42.dim(`Updated: ${new Date(variable.updatedAt).toLocaleString()}`)}`
+        `    ${chalk43.dim(`Updated: ${new Date(variable.updatedAt).toLocaleString()}`)}`
       );
       console.log();
     }
-    console.log(chalk42.dim(`Total: ${result.variables.length} variable(s)`));
+    console.log(chalk43.dim(`Total: ${result.variables.length} variable(s)`));
   })
 );
 
 // src/commands/zero/variable/set.ts
-import { Command as Command53 } from "commander";
-import chalk43 from "chalk";
-var setCommand5 = new Command53().name("set").description("Create or update a variable").argument("<name>", "Variable name (uppercase, e.g., MY_VAR)").argument("<value>", "Variable value").option("-d, --description <description>", "Optional description").action(
+import { Command as Command55 } from "commander";
+import chalk44 from "chalk";
+var setCommand5 = new Command55().name("set").description("Create or update a variable").argument("<name>", "Variable name (uppercase, e.g., MY_VAR)").argument("<value>", "Variable value").option("-d, --description <description>", "Optional description").action(
   withErrorHandler(
     async (name, value, options) => {
       let variable;
@@ -2927,15 +3106,15 @@ var setCommand5 = new Command53().name("set").description("Create or update a va
         }
         throw error;
       }
-      console.log(chalk43.green(`\u2713 Variable "${variable.name}" saved`));
+      console.log(chalk44.green(`\u2713 Variable "${variable.name}" saved`));
     }
   )
 );
 
 // src/commands/zero/variable/delete.ts
-import { Command as Command54 } from "commander";
-import chalk44 from "chalk";
-var deleteCommand5 = new Command54().name("delete").description("Delete a variable").argument("<name>", "Variable name to delete").option("-y, --yes", "Skip confirmation prompt").action(
+import { Command as Command56 } from "commander";
+import chalk45 from "chalk";
+var deleteCommand5 = new Command56().name("delete").description("Delete a variable").argument("<name>", "Variable name to delete").option("-y, --yes", "Skip confirmation prompt").action(
   withErrorHandler(async (name, options) => {
     if (!options.yes) {
       if (!isInteractive()) {
@@ -2946,21 +3125,21 @@ var deleteCommand5 = new Command54().name("delete").description("Delete a variab
         false
       );
       if (!confirmed) {
-        console.log(chalk44.dim("Cancelled"));
+        console.log(chalk45.dim("Cancelled"));
         return;
       }
     }
     await deleteZeroVariable(name);
-    console.log(chalk44.green(`\u2713 Variable "${name}" deleted`));
+    console.log(chalk45.green(`\u2713 Variable "${name}" deleted`));
   })
 );
 
 // src/commands/zero/variable/index.ts
-var zeroVariableCommand = new Command55().name("variable").description("Read or write non-sensitive configuration values").addCommand(listCommand9).addCommand(setCommand5).addCommand(deleteCommand5);
+var zeroVariableCommand = new Command57().name("variable").description("Read or write non-sensitive configuration values").addCommand(listCommand9).addCommand(setCommand5).addCommand(deleteCommand5);
 
 // src/commands/zero/whoami.ts
-import { Command as Command56 } from "commander";
-import chalk45 from "chalk";
+import { Command as Command58 } from "commander";
+import chalk46 from "chalk";
 function isInsideSandbox() {
   return !!process.env.ZERO_AGENT_ID;
 }
@@ -2968,11 +3147,11 @@ async function showSandboxInfo() {
   const agentId = process.env.ZERO_AGENT_ID;
   const payload = decodeZeroTokenPayload();
   console.log(`Agent ID:   ${agentId}`);
-  console.log(`Run ID:     ${payload?.runId ?? chalk45.dim("unavailable")}`);
-  console.log(`Org ID:     ${payload?.orgId ?? chalk45.dim("unavailable")}`);
+  console.log(`Run ID:     ${payload?.runId ?? chalk46.dim("unavailable")}`);
+  console.log(`Org ID:     ${payload?.orgId ?? chalk46.dim("unavailable")}`);
   if (payload?.capabilities?.length) {
     console.log();
-    console.log(chalk45.bold("Capabilities:"));
+    console.log(chalk46.bold("Capabilities:"));
     console.log(`  ${payload.capabilities.join(", ")}`);
   }
 }
@@ -2980,23 +3159,23 @@ async function showLocalInfo() {
   const token = await getToken();
   const apiUrl = await getApiUrl();
   const activeOrg = await getActiveOrg();
-  console.log(chalk45.bold("Auth:"));
+  console.log(chalk46.bold("Auth:"));
   if (token) {
     const tokenSource = process.env.ZERO_TOKEN ? "ZERO_TOKEN env var" : process.env.VM0_TOKEN ? "VM0_TOKEN env var" : "config file";
     console.log(
-      `  Status:     ${chalk45.green("Authenticated")} (via ${tokenSource})`
+      `  Status:     ${chalk46.green("Authenticated")} (via ${tokenSource})`
     );
   } else {
-    console.log(`  Status:     ${chalk45.dim("Not authenticated")}`);
+    console.log(`  Status:     ${chalk46.dim("Not authenticated")}`);
   }
   console.log(`  API:        ${apiUrl}`);
   console.log();
   if (activeOrg) {
-    console.log(chalk45.bold("Org:"));
+    console.log(chalk46.bold("Org:"));
     console.log(`  Active:     ${activeOrg}`);
   }
 }
-var zeroWhoamiCommand = new Command56().name("whoami").description("Show agent identity, run ID, and capabilities").action(
+var zeroWhoamiCommand = new Command58().name("whoami").description("Show agent identity, run ID, and capabilities").action(
   withErrorHandler(async () => {
     if (isInsideSandbox()) {
       await showSandboxInfo();
@@ -3007,11 +3186,11 @@ var zeroWhoamiCommand = new Command56().name("whoami").description("Show agent i
 );
 
 // src/commands/zero/ask-user/index.ts
-import { Command as Command58 } from "commander";
+import { Command as Command60 } from "commander";
 
 // src/commands/zero/ask-user/question.ts
-import { Command as Command57 } from "commander";
-import chalk46 from "chalk";
+import { Command as Command59 } from "commander";
+import chalk47 from "chalk";
 function collectOption(value, previous) {
   const list = previous ?? [];
   list.push({ label: value });
@@ -3022,7 +3201,7 @@ function collectDesc(value, previous) {
   list.push(value);
   return list;
 }
-var questionCommand = new Command57().name("question").description("Ask the user a question and wait for the answer").argument("<question>", "The question to ask").option("--header <text>", "Short label displayed as chip/tag (max 12 chars)").option("--option <label>", "Add a choice option (repeatable)", collectOption).option(
+var questionCommand = new Command59().name("question").description("Ask the user a question and wait for the answer").argument("<question>", "The question to ask").option("--header <text>", "Short label displayed as chip/tag (max 12 chars)").option("--option <label>", "Add a choice option (repeatable)", collectOption).option(
   "--desc <text>",
   "Description for the preceding --option",
   collectDesc
@@ -3038,6 +3217,11 @@ var questionCommand = new Command57().name("question").description("Ask the user
         }
         opt.description = descItems[i];
       }
+      if (optionItems.length === 0) {
+        throw new Error(
+          'At least one --option is required. Example: zero ask-user question "Pick one" --option "Yes" --option "No"'
+        );
+      }
       const timeoutMs = parseInt(options.timeout, 10) * 1e3;
       if (isNaN(timeoutMs) || timeoutMs <= 0) {
         throw new Error("--timeout must be a positive number of seconds");
@@ -3045,14 +3229,14 @@ var questionCommand = new Command57().name("question").description("Ask the user
       const questionItem = {
         question,
         header: options.header,
-        options: optionItems.length > 0 ? optionItems : void 0,
+        options: optionItems,
         multiSelect: options.multiSelect
       };
       const { pendingId } = await postAskUserQuestion({
         questions: [questionItem]
       });
       console.error(
-        chalk46.dim(
+        chalk47.dim(
           `\u23F3 Waiting for user response... (pendingId: ${pendingId})`
         )
       );
@@ -3077,11 +3261,12 @@ var questionCommand = new Command57().name("question").description("Ask the user
 );
 
 // src/commands/zero/ask-user/index.ts
-var zeroAskUserCommand = new Command58().name("ask-user").description("Ask the user a question and wait for the answer").addCommand(questionCommand);
+var zeroAskUserCommand = new Command60().name("ask-user").description("Ask the user a question and wait for the answer").addCommand(questionCommand);
 
 // src/zero.ts
 var COMMAND_CAPABILITY_MAP = {
   agent: "agent:read",
+  run: "agent-run:write",
   schedule: "schedule:read",
   doctor: null,
   slack: "slack:write",
@@ -3094,6 +3279,7 @@ var DEFAULT_COMMANDS = [
   zeroConnectorCommand,
   zeroDoctorCommand,
   zeroPreferenceCommand,
+  zeroRunCommand,
   zeroScheduleCommand,
   zeroSecretCommand,
   zeroSlackCommand,
@@ -3115,14 +3301,15 @@ function registerZeroCommands(prog, commands) {
     prog.addCommand(cmd, hidden ? { hidden: true } : {});
   }
 }
-var program = new Command59();
+var program = new Command61();
 program.name("zero").description(
   "Zero CLI \u2014 interact with the zero platform from inside the sandbox"
-).version("9.85.1").addHelpText(
+).version("9.86.0").addHelpText(
   "after",
   `
 Common scenarios:
   Missing a token?       zero doctor missing-token <TOKEN_NAME>
+  Delegate to teammate?  zero run <agent-id> "your task"
   Send a Slack message?  zero slack message send -c <channel> -t "text"
   Set up a schedule?     zero schedule setup <agent-name>
   Update yourself?       zero agent --help