@vm0/cli 9.83.3 → 9.84.1

package/index.js

@@ -51,7 +51,7 @@ import {
   searchLogs,
   volumeConfigSchema,
   withErrorHandler
-} from "./chunk-IFUYTPFH.js";
+} from "./chunk-A5NPNEP5.js";
 
 // src/index.ts
 import { Command as Command44 } from "commander";
@@ -436,7 +436,7 @@ function getConfigPath() {
   return join(homedir(), ".vm0", "config.json");
 }
 var infoCommand = new Command6().name("info").description("Display environment and debug information").action(async () => {
-  console.log(chalk3.bold(`VM0 CLI v${"9.83.3"}`));
+  console.log(chalk3.bold(`VM0 CLI v${"9.84.1"}`));
   console.log();
   const config = await loadConfig();
   const hasEnvToken = !!process.env.VM0_TOKEN;
@@ -1662,7 +1662,7 @@ var composeCommand = new Command7().name("compose").description("Create or updat
         options.autoUpdate = false;
       }
       if (options.autoUpdate !== false) {
-        await startSilentUpgrade("9.83.3");
+        await startSilentUpgrade("9.84.1");
       }
       try {
         let result;
@@ -2497,7 +2497,7 @@ var mainRunCommand = new Command8().name("run").description("Run an agent").argu
   withErrorHandler(
     async (identifier, prompt, options) => {
       if (options.autoUpdate !== false) {
-        await startSilentUpgrade("9.83.3");
+        await startSilentUpgrade("9.84.1");
       }
       const { org, name, version } = parseIdentifier(identifier);
       let composeId;
@@ -4253,7 +4253,7 @@ var cookAction = new Command35().name("cook").description("Quick start: prepare,
   withErrorHandler(
     async (prompt, options) => {
       if (options.autoUpdate !== false) {
-        const shouldExit = await checkAndUpgrade("9.83.3", prompt);
+        const shouldExit = await checkAndUpgrade("9.84.1", prompt);
         if (shouldExit) {
           process.exit(0);
         }
@@ -4993,13 +4993,13 @@ var upgradeCommand = new Command42().name("upgrade").description("Upgrade vm0 CL
     if (latestVersion === null) {
       throw new Error("Could not check for updates. Please try again later.");
     }
-    if (latestVersion === "9.83.3") {
-      console.log(chalk36.green(`\u2713 Already up to date (${"9.83.3"})`));
+    if (latestVersion === "9.84.1") {
+      console.log(chalk36.green(`\u2713 Already up to date (${"9.84.1"})`));
       return;
     }
     console.log(
       chalk36.yellow(
-        `Current version: ${"9.83.3"} -> Latest version: ${latestVersion}`
+        `Current version: ${"9.84.1"} -> Latest version: ${latestVersion}`
       )
     );
     console.log();
@@ -5026,7 +5026,7 @@ var upgradeCommand = new Command42().name("upgrade").description("Upgrade vm0 CL
     const success = await performUpgrade(packageManager);
     if (success) {
       console.log(
-        chalk36.green(`\u2713 Upgraded from ${"9.83.3"} to ${latestVersion}`)
+        chalk36.green(`\u2713 Upgraded from ${"9.84.1"} to ${latestVersion}`)
       );
       return;
     }
@@ -5094,7 +5094,7 @@ var whoamiCommand = new Command43().name("whoami").description("Show current ide
 
 // src/index.ts
 var program = new Command44();
-program.name("vm0").description("VM0 CLI - Build and run agents with natural language").version("9.83.3");
+program.name("vm0").description("VM0 CLI - Build and run agents with natural language").version("9.84.1");
 program.addCommand(authCommand);
 program.addCommand(infoCommand);
 program.addCommand(composeCommand);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vm0/cli",
-  "version": "9.83.3",
+  "version": "9.84.1",
   "description": "CLI application",
   "repository": {
     "type": "git",

package/zero.js

@@ -29,6 +29,7 @@ import {
   getBaseUrl,
   getComposeByName,
   getConnectorDerivedNames,
+  getConnectorTypeForSecretName,
   getCustomModelPlaceholder,
   getDefaultAuthMethod,
   getDefaultModel,
@@ -81,10 +82,10 @@ import {
   updateZeroUserPreferences,
   upsertZeroOrgModelProvider,
   withErrorHandler
-} from "./chunk-IFUYTPFH.js";
+} from "./chunk-A5NPNEP5.js";
 
 // src/zero.ts
-import { Command as Command55 } from "commander";
+import { Command as Command57 } from "commander";
 
 // src/commands/zero/org/index.ts
 import { Command as Command23 } from "commander";
@@ -1049,7 +1050,7 @@ var setDefaultCommand = new Command21().name("set-default").description("Set an
 var zeroOrgModelProviderCommand = new Command22().name("model-provider").description("Manage org-level model providers").addCommand(listCommand4).addCommand(setupCommand).addCommand(removeCommand4).addCommand(setDefaultCommand);
 
 // src/commands/zero/org/index.ts
-var zeroOrgCommand = new Command23().name("org").description("Manage your organization").addCommand(statusCommand).addCommand(setCommand).addCommand(listCommand).addCommand(useCommand).addCommand(membersCommand).addCommand(inviteCommand).addCommand(removeCommand).addCommand(leaveCommand).addCommand(deleteCommand).addCommand(zeroOrgSecretCommand).addCommand(zeroOrgVariableCommand).addCommand(zeroOrgModelProviderCommand);
+var zeroOrgCommand = new Command23().name("org").description("Manage organization settings, members, and providers").addCommand(statusCommand).addCommand(setCommand).addCommand(listCommand).addCommand(useCommand).addCommand(membersCommand).addCommand(inviteCommand).addCommand(removeCommand).addCommand(leaveCommand).addCommand(deleteCommand).addCommand(zeroOrgSecretCommand).addCommand(zeroOrgVariableCommand).addCommand(zeroOrgModelProviderCommand);
 
 // src/commands/zero/agent/index.ts
 import { Command as Command29 } from "commander";
@@ -1217,7 +1218,16 @@ var deleteCommand2 = new Command28().name("delete").alias("rm").description("Del
 );
 
 // src/commands/zero/agent/index.ts
-var zeroAgentCommand = new Command29("agent").description("Manage zero agents").addCommand(createCommand).addCommand(editCommand).addCommand(viewCommand).addCommand(listCommand5).addCommand(deleteCommand2);
+var zeroAgentCommand = new Command29("agent").description("View or manage zero agents").addCommand(createCommand).addCommand(editCommand).addCommand(viewCommand).addCommand(listCommand5).addCommand(deleteCommand2).addHelpText(
+  "after",
+  `
+Self-management (inside sandbox):
+  Your agent ID is in $ZERO_AGENT_ID (or run: zero whoami)
+  View your config:      zero agent view $ZERO_AGENT_ID --instructions
+  Update description:    zero agent edit $ZERO_AGENT_ID --description "new role"
+  Update tone:           zero agent edit $ZERO_AGENT_ID --sound friendly
+  Update instructions:   zero agent edit $ZERO_AGENT_ID --instructions-file <path>`
+);
 
 // src/commands/zero/connector/index.ts
 import { Command as Command34 } from "commander";
@@ -1811,10 +1821,38 @@ var disconnectCommand = new Command33().name("disconnect").description("Disconne
 );
 
 // src/commands/zero/connector/index.ts
-var zeroConnectorCommand = new Command34().name("connector").description("Manage third-party service connections").addCommand(listCommand6).addCommand(statusCommand2).addCommand(connectCommand).addCommand(disconnectCommand);
+var zeroConnectorCommand = new Command34().name("connector").description("Check or connect third-party services (GitHub, Slack, etc.)").addCommand(listCommand6).addCommand(statusCommand2).addCommand(connectCommand).addCommand(disconnectCommand);
 
-// src/commands/zero/preference/index.ts
+// src/commands/zero/doctor/index.ts
+import { Command as Command36 } from "commander";
+
+// src/commands/zero/doctor/missing-token.ts
 import { Command as Command35 } from "commander";
+var missingTokenCommand = new Command35().name("missing-token").description(
+  "Diagnose a missing token and find the connector that provides it"
+).argument("<token-name>", "The environment variable / token name to look up").action(
+  withErrorHandler(async (tokenName) => {
+    const connectorType = getConnectorTypeForSecretName(tokenName);
+    if (!connectorType) {
+      throw new Error(
+        `Unknown token: ${tokenName} \u2014 not managed by any connector`
+      );
+    }
+    const { label } = CONNECTOR_TYPES[connectorType];
+    const baseUrl = await getApiUrl();
+    const agentId = process.env.ZERO_AGENT_ID;
+    const path = agentId ? `/team/${agentId}` : "/team";
+    const url = `${baseUrl}${path}?tab=connectors`;
+    console.log(`${tokenName} is provided by the ${label} connector.`);
+    console.log(`Ask the user to connect it at: ${url}`);
+  })
+);
+
+// src/commands/zero/doctor/index.ts
+var zeroDoctorCommand = new Command36().name("doctor").description("Diagnose runtime issues (missing tokens, connectors)").addCommand(missingTokenCommand);
+
+// src/commands/zero/preference/index.ts
+import { Command as Command37 } from "commander";
 import chalk31 from "chalk";
 function detectTimezone2() {
   return Intl.DateTimeFormat().resolvedOptions().timeZone;
@@ -1871,7 +1909,7 @@ System timezone detected: ${detectedTz}`));
     }
   }
 }
-var zeroPreferenceCommand = new Command35().name("preference").description("View or update your preferences").option("--timezone <timezone>", "IANA timezone (e.g., America/New_York)").action(
+var zeroPreferenceCommand = new Command37().name("preference").description("View or update user preferences (timezone, notifications)").option("--timezone <timezone>", "IANA timezone (e.g., America/New_York)").action(
   withErrorHandler(async (opts) => {
     const updates = buildUpdates(opts);
     if (updates) {
@@ -1896,10 +1934,10 @@ var zeroPreferenceCommand = new Command35().name("preference").description("View
 );
 
 // src/commands/zero/schedule/index.ts
-import { Command as Command42 } from "commander";
+import { Command as Command44 } from "commander";
 
 // src/commands/zero/schedule/setup.ts
-import { Command as Command36 } from "commander";
+import { Command as Command38 } from "commander";
 import chalk32 from "chalk";
 var FREQUENCY_CHOICES = [
   { title: "Daily", value: "daily", description: "Run every day" },
@@ -2330,7 +2368,7 @@ async function handleScheduleEnabling(params) {
     showEnableHint(agentName);
   }
 }
-var setupCommand2 = new Command36().name("setup").description("Create or edit a schedule for a zero agent").argument("<agent-name>", "Agent name to configure schedule for").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 Command38().name("setup").description("Create or edit a schedule for a zero agent").argument("<agent-name>", "Agent name to configure schedule for").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 (agentName, options) => {
     const compose = await getComposeByName(agentName);
     if (!compose) {
@@ -2411,9 +2449,9 @@ var setupCommand2 = new Command36().name("setup").description("Create or edit a
 );
 
 // src/commands/zero/schedule/list.ts
-import { Command as Command37 } from "commander";
+import { Command as Command39 } from "commander";
 import chalk33 from "chalk";
-var listCommand7 = new Command37().name("list").alias("ls").description("List all zero schedules").action(
+var listCommand7 = new Command39().name("list").alias("ls").description("List all zero schedules").action(
   withErrorHandler(async () => {
     const result = await listZeroSchedules();
     if (result.schedules.length === 0) {
@@ -2462,7 +2500,7 @@ var listCommand7 = new Command37().name("list").alias("ls").description("List al
 );
 
 // src/commands/zero/schedule/status.ts
-import { Command as Command38 } from "commander";
+import { Command as Command40 } from "commander";
 import chalk34 from "chalk";
 function formatDateTimeStyled(dateStr) {
   if (!dateStr) return chalk34.dim("-");
@@ -2521,7 +2559,7 @@ function printTimeSchedule(schedule) {
     console.log(`${"Failures:".padEnd(16)}${failureText}`);
   }
 }
-var statusCommand3 = new Command38().name("status").description("Show detailed status of a zero schedule").argument("<agent-name>", "Agent name").option(
+var statusCommand3 = new Command40().name("status").description("Show detailed status of a zero schedule").argument("<agent-name>", "Agent name").option(
   "-n, --name <schedule-name>",
   "Schedule name (required when agent has multiple schedules)"
 ).action(
@@ -2540,9 +2578,9 @@ var statusCommand3 = new Command38().name("status").description("Show detailed s
 );
 
 // src/commands/zero/schedule/delete.ts
-import { Command as Command39 } from "commander";
+import { Command as Command41 } from "commander";
 import chalk35 from "chalk";
-var deleteCommand3 = new Command39().name("delete").alias("rm").description("Delete a zero schedule").argument("<agent-name>", "Agent name").option(
+var deleteCommand3 = new Command41().name("delete").alias("rm").description("Delete a zero schedule").argument("<agent-name>", "Agent name").option(
   "-n, --name <schedule-name>",
   "Schedule name (required when agent has multiple schedules)"
 ).option("-y, --yes", "Skip confirmation prompt").action(
@@ -2575,9 +2613,9 @@ var deleteCommand3 = new Command39().name("delete").alias("rm").description("Del
 );
 
 // src/commands/zero/schedule/enable.ts
-import { Command as Command40 } from "commander";
+import { Command as Command42 } from "commander";
 import chalk36 from "chalk";
-var enableCommand = new Command40().name("enable").description("Enable a zero schedule").argument("<agent-name>", "Agent name").option(
+var enableCommand = new Command42().name("enable").description("Enable a zero schedule").argument("<agent-name>", "Agent name").option(
   "-n, --name <schedule-name>",
   "Schedule name (required when agent has multiple schedules)"
 ).action(
@@ -2595,9 +2633,9 @@ var enableCommand = new Command40().name("enable").description("Enable a zero sc
 );
 
 // src/commands/zero/schedule/disable.ts
-import { Command as Command41 } from "commander";
+import { Command as Command43 } from "commander";
 import chalk37 from "chalk";
-var disableCommand = new Command41().name("disable").description("Disable a zero schedule").argument("<agent-name>", "Agent name").option(
+var disableCommand = new Command43().name("disable").description("Disable a zero schedule").argument("<agent-name>", "Agent name").option(
   "-n, --name <schedule-name>",
   "Schedule name (required when agent has multiple schedules)"
 ).action(
@@ -2615,15 +2653,15 @@ var disableCommand = new Command41().name("disable").description("Disable a zero
 );
 
 // src/commands/zero/schedule/index.ts
-var zeroScheduleCommand = new Command42().name("schedule").description("Manage zero agent schedules").addCommand(setupCommand2).addCommand(listCommand7).addCommand(statusCommand3).addCommand(deleteCommand3).addCommand(enableCommand).addCommand(disableCommand);
+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);
 
 // src/commands/zero/secret/index.ts
-import { Command as Command46 } from "commander";
+import { Command as Command48 } from "commander";
 
 // src/commands/zero/secret/list.ts
-import { Command as Command43 } from "commander";
+import { Command as Command45 } from "commander";
 import chalk38 from "chalk";
-var listCommand8 = new Command43().name("list").alias("ls").description("List all secrets").action(
+var listCommand8 = new Command45().name("list").alias("ls").description("List all secrets").action(
   withErrorHandler(async () => {
     const result = await listZeroSecrets();
     if (result.secrets.length === 0) {
@@ -2676,9 +2714,9 @@ var listCommand8 = new Command43().name("list").alias("ls").description("List al
 );
 
 // src/commands/zero/secret/set.ts
-import { Command as Command44 } from "commander";
+import { Command as Command46 } from "commander";
 import chalk39 from "chalk";
-var setCommand4 = new Command44().name("set").description("Create or update a secret").argument("<name>", "Secret name (uppercase, e.g., MY_API_KEY)").option(
+var setCommand4 = new Command46().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(
@@ -2724,9 +2762,9 @@ var setCommand4 = new Command44().name("set").description("Create or update a se
 );
 
 // src/commands/zero/secret/delete.ts
-import { Command as Command45 } from "commander";
+import { Command as Command47 } from "commander";
 import chalk40 from "chalk";
-var deleteCommand4 = new Command45().name("delete").description("Delete a secret").argument("<name>", "Secret name to delete").option("-y, --yes", "Skip confirmation prompt").action(
+var deleteCommand4 = new Command47().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()) {
@@ -2747,19 +2785,19 @@ var deleteCommand4 = new Command45().name("delete").description("Delete a secret
 );
 
 // src/commands/zero/secret/index.ts
-var zeroSecretCommand = new Command46().name("secret").description("Manage secrets").addCommand(listCommand8).addCommand(setCommand4).addCommand(deleteCommand4);
+var zeroSecretCommand = new Command48().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 Command49 } from "commander";
+import { Command as Command51 } from "commander";
 
 // src/commands/zero/slack/message/index.ts
-import { Command as Command48 } from "commander";
+import { Command as Command50 } from "commander";
 
 // src/commands/zero/slack/message/send.ts
 import { readFileSync as readFileSync3 } from "fs";
-import { Command as Command47 } from "commander";
+import { Command as Command49 } from "commander";
 import chalk41 from "chalk";
-var sendCommand = new Command47().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(
+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(
   withErrorHandler(
     async (options) => {
       let text = options.text;
@@ -2799,16 +2837,16 @@ var sendCommand = new Command47().name("send").description("Send a message to a
 );
 
 // src/commands/zero/slack/message/index.ts
-var zeroSlackMessageCommand = new Command48().name("message").description("Manage Slack messages").addCommand(sendCommand);
+var zeroSlackMessageCommand = new Command50().name("message").description("Manage Slack messages").addCommand(sendCommand);
 
 // src/commands/zero/slack/index.ts
-var zeroSlackCommand = new Command49().name("slack").description("Manage Slack integrations").addCommand(zeroSlackMessageCommand);
+var zeroSlackCommand = new Command51().name("slack").description("Send messages to Slack channels as the bot").addCommand(zeroSlackMessageCommand);
 
 // src/commands/zero/variable/index.ts
-import { Command as Command53 } from "commander";
+import { Command as Command55 } from "commander";
 
 // src/commands/zero/variable/list.ts
-import { Command as Command50 } from "commander";
+import { Command as Command52 } from "commander";
 import chalk42 from "chalk";
 function truncateValue2(value, maxLength = 60) {
   if (value.length <= maxLength) {
@@ -2816,7 +2854,7 @@ function truncateValue2(value, maxLength = 60) {
   }
   return value.slice(0, maxLength - 15) + "... [truncated]";
 }
-var listCommand9 = new Command50().name("list").alias("ls").description("List all variables").action(
+var listCommand9 = new Command52().name("list").alias("ls").description("List all variables").action(
   withErrorHandler(async () => {
     const result = await listZeroVariables();
     if (result.variables.length === 0) {
@@ -2844,9 +2882,9 @@ var listCommand9 = new Command50().name("list").alias("ls").description("List al
 );
 
 // src/commands/zero/variable/set.ts
-import { Command as Command51 } from "commander";
+import { Command as Command53 } from "commander";
 import chalk43 from "chalk";
-var setCommand5 = new Command51().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(
+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(
   withErrorHandler(
     async (name, value, options) => {
       let variable;
@@ -2872,9 +2910,9 @@ var setCommand5 = new Command51().name("set").description("Create or update a va
 );
 
 // src/commands/zero/variable/delete.ts
-import { Command as Command52 } from "commander";
+import { Command as Command54 } from "commander";
 import chalk44 from "chalk";
-var deleteCommand5 = new Command52().name("delete").description("Delete a variable").argument("<name>", "Variable name to delete").option("-y, --yes", "Skip confirmation prompt").action(
+var deleteCommand5 = new Command54().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()) {
@@ -2895,10 +2933,10 @@ var deleteCommand5 = new Command52().name("delete").description("Delete a variab
 );
 
 // src/commands/zero/variable/index.ts
-var zeroVariableCommand = new Command53().name("variable").description("Manage variables").addCommand(listCommand9).addCommand(setCommand5).addCommand(deleteCommand5);
+var zeroVariableCommand = new Command55().name("variable").description("Read or write non-sensitive configuration values").addCommand(listCommand9).addCommand(setCommand5).addCommand(deleteCommand5);
 
 // src/commands/zero/whoami.ts
-import { Command as Command54 } from "commander";
+import { Command as Command56 } from "commander";
 import chalk45 from "chalk";
 function isInsideSandbox() {
   return !!process.env.ZERO_AGENT_ID;
@@ -2935,7 +2973,7 @@ async function showLocalInfo() {
     console.log(`  Active:     ${activeOrg}`);
   }
 }
-var zeroWhoamiCommand = new Command54().name("whoami").description("Show current identity and environment information").action(
+var zeroWhoamiCommand = new Command56().name("whoami").description("Show agent identity, run ID, and capabilities").action(
   withErrorHandler(async () => {
     if (isInsideSandbox()) {
       await showSandboxInfo();
@@ -2949,6 +2987,7 @@ var zeroWhoamiCommand = new Command54().name("whoami").description("Show current
 var COMMAND_CAPABILITY_MAP = {
   agent: "agent:read",
   schedule: "schedule:read",
+  doctor: null,
   slack: "slack:write",
   whoami: null
 };
@@ -2956,6 +2995,7 @@ var DEFAULT_COMMANDS = [
   zeroOrgCommand,
   zeroAgentCommand,
   zeroConnectorCommand,
+  zeroDoctorCommand,
   zeroPreferenceCommand,
   zeroScheduleCommand,
   zeroSecretCommand,
@@ -2977,8 +3017,19 @@ function registerZeroCommands(prog, commands) {
     prog.addCommand(cmd, hidden ? { hidden: true } : {});
   }
 }
-var program = new Command55();
-program.name("zero").description("Zero CLI - Manage your zero platform").version("9.83.3");
+var program = new Command57();
+program.name("zero").description(
+  "Zero CLI \u2014 interact with the zero platform from inside the sandbox"
+).version("9.84.1").addHelpText(
+  "after",
+  `
+Common scenarios:
+  Missing a token?       zero doctor missing-token <TOKEN_NAME>
+  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
+  Check your identity?   zero whoami`
+);
 if (process.argv[1]?.endsWith("zero.js") || process.argv[1]?.endsWith("zero.ts") || process.argv[1]?.endsWith("zero")) {
   configureGlobalProxyFromEnv();
   registerZeroCommands(program);