@vm0/cli 5.7.2 → 5.8.0

package/index.js

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
 
 // src/index.ts
-import { Command as Command35 } from "commander";
-import chalk36 from "chalk";
+import { Command as Command36 } from "commander";
+import chalk37 from "chalk";
 
 // src/lib/api/auth.ts
 import chalk from "chalk";
@@ -333,7 +333,9 @@ var storedExecutionContextSchema = z2.object({
   encryptedSecrets: z2.string().nullable(),
   // AES-256-GCM encrypted secrets
   cliAgentType: z2.string(),
-  experimentalFirewall: experimentalFirewallSchema.optional()
+  experimentalFirewall: experimentalFirewallSchema.optional(),
+  // Debug flag to force real Claude in mock environments (internal use only)
+  debugNoMockClaude: z2.boolean().optional()
 });
 var executionContextSchema = z2.object({
   runId: z2.string().uuid(),
@@ -351,7 +353,9 @@ var executionContextSchema = z2.object({
   secretValues: z2.array(z2.string()).nullable(),
   cliAgentType: z2.string(),
   // Experimental firewall configuration
-  experimentalFirewall: experimentalFirewallSchema.optional()
+  experimentalFirewall: experimentalFirewallSchema.optional(),
+  // Debug flag to force real Claude in mock environments (internal use only)
+  debugNoMockClaude: z2.boolean().optional()
 });
 var runnersJobClaimContract = c.router({
   claim: {
@@ -634,6 +638,8 @@ var unifiedRunRequestSchema = z4.object({
   vars: z4.record(z4.string(), z4.string()).optional(),
   secrets: z4.record(z4.string(), z4.string()).optional(),
   volumeVersions: z4.record(z4.string(), z4.string()).optional(),
+  // Debug flag to force real Claude in mock environments (internal use only)
+  debugNoMockClaude: z4.boolean().optional(),
   // Required
   prompt: z4.string().min(1, "Missing prompt")
 });
@@ -2586,6 +2592,16 @@ function getProviderDisplayName(provider) {
   return PROVIDER_DISPLAY_NAMES[provider];
 }
 
+// ../../packages/core/src/feature-switch.ts
+var PricingSwitch = {
+  key: "pricing" /* Pricing */,
+  maintainer: "ethan@vm0.ai",
+  enabled: false
+};
+var FEATURE_SWITCHES = {
+  ["pricing" /* Pricing */]: PricingSwitch
+};
+
 // src/lib/api/api-client.ts
 import { initClient } from "@ts-rest/core";
 var ApiClient = class {
@@ -3256,6 +3272,26 @@ var ApiClient = class {
     const message = errorBody.error?.message || `Volume "${id}" not found`;
     throw new Error(message);
   }
+  /**
+   * Get usage statistics
+   */
+  async getUsage(options) {
+    const baseUrl = await this.getBaseUrl();
+    const headers = await this.getHeaders();
+    const params = new URLSearchParams({
+      start_date: options.startDate,
+      end_date: options.endDate
+    });
+    const response = await fetch(`${baseUrl}/api/usage?${params}`, {
+      method: "GET",
+      headers
+    });
+    if (!response.ok) {
+      const error = await response.json();
+      throw new Error(error.error?.message || "Failed to fetch usage data");
+    }
+    return response.json();
+  }
   /**
    * Generic GET request
    */
@@ -5103,7 +5139,7 @@ var runCmd = new Command2().name("run").description("Execute an agent").argument
 ).option(
   "--conversation <id>",
   "Resume from conversation ID (for fine-grained control)"
-).option("-v, --verbose", "Show verbose output with timing information").action(
+).option("-v, --verbose", "Show verbose output with timing information").option("--debug-no-mock-claude").action(
   async (identifier, prompt, options) => {
     const startTimestamp = /* @__PURE__ */ new Date();
     const verbose = options.verbose;
@@ -5204,7 +5240,8 @@ var runCmd = new Command2().name("run").description("Execute an agent").argument
         artifactName: options.artifactName,
         artifactVersion: options.artifactVersion,
         volumeVersions: Object.keys(options.volumeVersion).length > 0 ? options.volumeVersion : void 0,
-        conversationId: options.conversation
+        conversationId: options.conversation,
+        debugNoMockClaude: options.debugNoMockClaude || void 0
       });
       if (response.status === "failed") {
         console.error(chalk5.red("\u2717 Run preparation failed"));
@@ -5269,7 +5306,7 @@ runCmd.command("resume").description("Resume an agent run from a checkpoint (use
   "Volume version override (repeatable)",
   collectVolumeVersions,
   {}
-).option("-v, --verbose", "Show verbose output with timing information").action(
+).option("-v, --verbose", "Show verbose output with timing information").option("--debug-no-mock-claude").action(
   async (checkpointId, prompt, options, command) => {
     const startTimestamp = /* @__PURE__ */ new Date();
     const allOpts = command.optsWithGlobals();
@@ -5310,7 +5347,8 @@ runCmd.command("resume").description("Resume an agent run from a checkpoint (use
         prompt,
         vars: Object.keys(vars).length > 0 ? vars : void 0,
         secrets: loadedSecrets,
-        volumeVersions: Object.keys(allOpts.volumeVersion).length > 0 ? allOpts.volumeVersion : void 0
+        volumeVersions: Object.keys(allOpts.volumeVersion).length > 0 ? allOpts.volumeVersion : void 0,
+        debugNoMockClaude: options.debugNoMockClaude || allOpts.debugNoMockClaude || void 0
       });
       if (response.status === "failed") {
         console.error(chalk5.red("\u2717 Run preparation failed"));
@@ -5367,7 +5405,7 @@ runCmd.command("continue").description(
   "Volume version override (repeatable)",
   collectVolumeVersions,
   {}
-).option("-v, --verbose", "Show verbose output with timing information").action(
+).option("-v, --verbose", "Show verbose output with timing information").option("--debug-no-mock-claude").action(
   async (agentSessionId, prompt, options, command) => {
     const startTimestamp = /* @__PURE__ */ new Date();
     const allOpts = command.optsWithGlobals();
@@ -5409,7 +5447,8 @@ runCmd.command("continue").description(
         prompt,
         vars: Object.keys(vars).length > 0 ? vars : void 0,
         secrets: loadedSecrets,
-        volumeVersions: Object.keys(allOpts.volumeVersion).length > 0 ? allOpts.volumeVersion : void 0
+        volumeVersions: Object.keys(allOpts.volumeVersion).length > 0 ? allOpts.volumeVersion : void 0,
+        debugNoMockClaude: options.debugNoMockClaude || allOpts.debugNoMockClaude || void 0
       });
       if (response.status === "failed") {
         console.error(chalk5.red("\u2717 Run preparation failed"));
@@ -6731,180 +6770,186 @@ async function autoPullArtifact(runOutput, artifactDir) {
   }
 }
 var cookCmd = new Command17().name("cook").description("One-click agent preparation and execution from vm0.yaml");
-cookCmd.argument("[prompt]", "Prompt for the agent").option("-y, --yes", "Skip confirmation prompts").action(async (prompt, options) => {
-  const shouldExit = await checkAndUpgrade("5.7.2", prompt);
-  if (shouldExit) {
-    process.exit(0);
-  }
-  const cwd = process.cwd();
-  console.log(chalk21.bold(`Reading config: ${CONFIG_FILE3}`));
-  if (!existsSync8(CONFIG_FILE3)) {
-    console.error(chalk21.red(`\u2717 Config file not found: ${CONFIG_FILE3}`));
-    process.exit(1);
-  }
-  let config;
-  try {
-    const content = await readFile7(CONFIG_FILE3, "utf8");
-    config = parseYaml4(content);
-  } catch (error) {
-    console.error(chalk21.red("\u2717 Invalid YAML format"));
-    if (error instanceof Error) {
-      console.error(chalk21.dim(`  ${error.message}`));
+cookCmd.argument("[prompt]", "Prompt for the agent").option("-y, --yes", "Skip confirmation prompts").option("--debug-no-mock-claude").action(
+  async (prompt, options) => {
+    const shouldExit = await checkAndUpgrade("5.8.0", prompt);
+    if (shouldExit) {
+      process.exit(0);
     }
-    process.exit(1);
-  }
-  const validation = validateAgentCompose(config);
-  if (!validation.valid) {
-    console.error(chalk21.red(`\u2717 ${validation.error}`));
-    process.exit(1);
-  }
-  const agentNames = Object.keys(config.agents);
-  const agentName = agentNames[0];
-  const volumeCount = config.volumes ? Object.keys(config.volumes).length : 0;
-  console.log(
-    chalk21.green(`\u2713 Config validated: 1 agent, ${volumeCount} volume(s)`)
-  );
-  const requiredVarNames = extractRequiredVarNames(config);
-  if (requiredVarNames.length > 0) {
-    const envFilePath = path12.join(cwd, ".env");
-    const missingVars = checkMissingVariables(requiredVarNames, envFilePath);
-    if (missingVars.length > 0) {
-      await generateEnvPlaceholders(missingVars, envFilePath);
-      console.log();
-      console.log(
-        chalk21.yellow(
-          `\u26A0 Missing environment variables. Please fill in values in .env file:`
-        )
-      );
-      for (const varName of missingVars) {
-        console.log(chalk21.yellow(`    ${varName}`));
+    const cwd = process.cwd();
+    console.log(chalk21.bold(`Reading config: ${CONFIG_FILE3}`));
+    if (!existsSync8(CONFIG_FILE3)) {
+      console.error(chalk21.red(`\u2717 Config file not found: ${CONFIG_FILE3}`));
+      process.exit(1);
+    }
+    let config;
+    try {
+      const content = await readFile7(CONFIG_FILE3, "utf8");
+      config = parseYaml4(content);
+    } catch (error) {
+      console.error(chalk21.red("\u2717 Invalid YAML format"));
+      if (error instanceof Error) {
+        console.error(chalk21.dim(`  ${error.message}`));
       }
       process.exit(1);
     }
-  }
-  if (config.volumes && Object.keys(config.volumes).length > 0) {
-    console.log();
-    console.log(chalk21.bold("Processing volumes:"));
-    for (const volumeConfig of Object.values(config.volumes)) {
-      const volumeDir = path12.join(cwd, volumeConfig.name);
-      if (!existsSync8(volumeDir)) {
-        console.error(
-          chalk21.red(
-            `\u2717 Directory not found: ${volumeConfig.name}. Create the directory and add files first.`
+    const validation = validateAgentCompose(config);
+    if (!validation.valid) {
+      console.error(chalk21.red(`\u2717 ${validation.error}`));
+      process.exit(1);
+    }
+    const agentNames = Object.keys(config.agents);
+    const agentName = agentNames[0];
+    const volumeCount = config.volumes ? Object.keys(config.volumes).length : 0;
+    console.log(
+      chalk21.green(`\u2713 Config validated: 1 agent, ${volumeCount} volume(s)`)
+    );
+    const requiredVarNames = extractRequiredVarNames(config);
+    if (requiredVarNames.length > 0) {
+      const envFilePath = path12.join(cwd, ".env");
+      const missingVars = checkMissingVariables(
+        requiredVarNames,
+        envFilePath
+      );
+      if (missingVars.length > 0) {
+        await generateEnvPlaceholders(missingVars, envFilePath);
+        console.log();
+        console.log(
+          chalk21.yellow(
+            `\u26A0 Missing environment variables. Please fill in values in .env file:`
           )
         );
+        for (const varName of missingVars) {
+          console.log(chalk21.yellow(`    ${varName}`));
+        }
         process.exit(1);
       }
-      try {
-        printCommand(`cd ${volumeConfig.name}`);
-        const existingConfig = await readStorageConfig(volumeDir);
-        if (!existingConfig) {
-          printCommand(`vm0 volume init --name ${volumeConfig.name}`);
-          await execVm0Command(
-            ["volume", "init", "--name", volumeConfig.name],
-            {
-              cwd: volumeDir,
-              silent: true
-            }
+    }
+    if (config.volumes && Object.keys(config.volumes).length > 0) {
+      console.log();
+      console.log(chalk21.bold("Processing volumes:"));
+      for (const volumeConfig of Object.values(config.volumes)) {
+        const volumeDir = path12.join(cwd, volumeConfig.name);
+        if (!existsSync8(volumeDir)) {
+          console.error(
+            chalk21.red(
+              `\u2717 Directory not found: ${volumeConfig.name}. Create the directory and add files first.`
+            )
           );
+          process.exit(1);
         }
-        printCommand("vm0 volume push");
-        await execVm0Command(["volume", "push"], {
-          cwd: volumeDir,
-          silent: true
-        });
-        printCommand("cd ..");
-      } catch (error) {
-        console.error(chalk21.red(`\u2717 Failed`));
-        if (error instanceof Error) {
-          console.error(chalk21.dim(`  ${error.message}`));
+        try {
+          printCommand(`cd ${volumeConfig.name}`);
+          const existingConfig = await readStorageConfig(volumeDir);
+          if (!existingConfig) {
+            printCommand(`vm0 volume init --name ${volumeConfig.name}`);
+            await execVm0Command(
+              ["volume", "init", "--name", volumeConfig.name],
+              {
+                cwd: volumeDir,
+                silent: true
+              }
+            );
+          }
+          printCommand("vm0 volume push");
+          await execVm0Command(["volume", "push"], {
+            cwd: volumeDir,
+            silent: true
+          });
+          printCommand("cd ..");
+        } catch (error) {
+          console.error(chalk21.red(`\u2717 Failed`));
+          if (error instanceof Error) {
+            console.error(chalk21.dim(`  ${error.message}`));
+          }
+          process.exit(1);
         }
-        process.exit(1);
       }
     }
-  }
-  console.log();
-  console.log(chalk21.bold("Processing artifact:"));
-  const artifactDir = path12.join(cwd, ARTIFACT_DIR);
-  try {
-    if (!existsSync8(artifactDir)) {
-      printCommand(`mkdir ${ARTIFACT_DIR}`);
-      await mkdir6(artifactDir, { recursive: true });
-    }
-    printCommand(`cd ${ARTIFACT_DIR}`);
-    const existingConfig = await readStorageConfig(artifactDir);
-    if (!existingConfig) {
-      printCommand(`vm0 artifact init --name ${ARTIFACT_DIR}`);
-      await execVm0Command(["artifact", "init", "--name", ARTIFACT_DIR], {
+    console.log();
+    console.log(chalk21.bold("Processing artifact:"));
+    const artifactDir = path12.join(cwd, ARTIFACT_DIR);
+    try {
+      if (!existsSync8(artifactDir)) {
+        printCommand(`mkdir ${ARTIFACT_DIR}`);
+        await mkdir6(artifactDir, { recursive: true });
+      }
+      printCommand(`cd ${ARTIFACT_DIR}`);
+      const existingConfig = await readStorageConfig(artifactDir);
+      if (!existingConfig) {
+        printCommand(`vm0 artifact init --name ${ARTIFACT_DIR}`);
+        await execVm0Command(["artifact", "init", "--name", ARTIFACT_DIR], {
+          cwd: artifactDir,
+          silent: true
+        });
+      }
+      printCommand("vm0 artifact push");
+      await execVm0Command(["artifact", "push"], {
         cwd: artifactDir,
         silent: true
       });
+      printCommand("cd ..");
+    } catch (error) {
+      console.error(chalk21.red(`\u2717 Failed`));
+      if (error instanceof Error) {
+        console.error(chalk21.dim(`  ${error.message}`));
+      }
+      process.exit(1);
     }
-    printCommand("vm0 artifact push");
-    await execVm0Command(["artifact", "push"], {
-      cwd: artifactDir,
-      silent: true
-    });
-    printCommand("cd ..");
-  } catch (error) {
-    console.error(chalk21.red(`\u2717 Failed`));
-    if (error instanceof Error) {
-      console.error(chalk21.dim(`  ${error.message}`));
-    }
-    process.exit(1);
-  }
-  console.log();
-  console.log(chalk21.bold("Composing agent:"));
-  const composeArgs = options.yes ? ["compose", "--yes", CONFIG_FILE3] : ["compose", CONFIG_FILE3];
-  printCommand(`vm0 ${composeArgs.join(" ")}`);
-  try {
-    await execVm0Command(composeArgs, {
-      cwd
-    });
-  } catch (error) {
-    console.error(chalk21.red(`\u2717 Compose failed`));
-    if (error instanceof Error) {
-      console.error(chalk21.dim(`  ${error.message}`));
-    }
-    process.exit(1);
-  }
-  if (prompt) {
     console.log();
-    console.log(chalk21.bold("Running agent:"));
-    printCommand(
-      `vm0 run ${agentName} --artifact-name ${ARTIFACT_DIR} "${prompt}"`
-    );
-    console.log();
-    let runOutput;
+    console.log(chalk21.bold("Composing agent:"));
+    const composeArgs = options.yes ? ["compose", "--yes", CONFIG_FILE3] : ["compose", CONFIG_FILE3];
+    printCommand(`vm0 ${composeArgs.join(" ")}`);
     try {
-      const runArgs = [
-        "run",
-        agentName,
-        "--artifact-name",
-        ARTIFACT_DIR,
-        prompt
-      ];
-      runOutput = await execVm0RunWithCapture(runArgs, { cwd });
-    } catch {
+      await execVm0Command(composeArgs, {
+        cwd
+      });
+    } catch (error) {
+      console.error(chalk21.red(`\u2717 Compose failed`));
+      if (error instanceof Error) {
+        console.error(chalk21.dim(`  ${error.message}`));
+      }
       process.exit(1);
     }
-    const runIds = parseRunIdsFromOutput(runOutput);
-    if (runIds.runId || runIds.sessionId || runIds.checkpointId) {
-      await saveCookState({
-        lastRunId: runIds.runId,
-        lastSessionId: runIds.sessionId,
-        lastCheckpointId: runIds.checkpointId
-      });
+    if (prompt) {
+      console.log();
+      console.log(chalk21.bold("Running agent:"));
+      printCommand(
+        `vm0 run ${agentName} --artifact-name ${ARTIFACT_DIR} "${prompt}"`
+      );
+      console.log();
+      let runOutput;
+      try {
+        const runArgs = [
+          "run",
+          agentName,
+          "--artifact-name",
+          ARTIFACT_DIR,
+          ...options.debugNoMockClaude ? ["--debug-no-mock-claude"] : [],
+          prompt
+        ];
+        runOutput = await execVm0RunWithCapture(runArgs, { cwd });
+      } catch {
+        process.exit(1);
+      }
+      const runIds = parseRunIdsFromOutput(runOutput);
+      if (runIds.runId || runIds.sessionId || runIds.checkpointId) {
+        await saveCookState({
+          lastRunId: runIds.runId,
+          lastSessionId: runIds.sessionId,
+          lastCheckpointId: runIds.checkpointId
+        });
+      }
+      await autoPullArtifact(runOutput, artifactDir);
+    } else {
+      console.log();
+      console.log("To run your agent:");
+      printCommand(
+        `vm0 run ${agentName} --artifact-name ${ARTIFACT_DIR} "your prompt"`
+      );
     }
-    await autoPullArtifact(runOutput, artifactDir);
-  } else {
-    console.log();
-    console.log("To run your agent:");
-    printCommand(
-      `vm0 run ${agentName} --artifact-name ${ARTIFACT_DIR} "your prompt"`
-    );
   }
-});
+);
 cookCmd.command("logs").description("View logs from the last cook run").option("-a, --agent", "Show agent events (default)").option("-s, --system", "Show system log").option("-m, --metrics", "Show metrics").option("-n, --network", "Show network logs (proxy traffic)").option(
   "--since <time>",
   "Show logs since timestamp (e.g., 5m, 2h, 1d, 2024-01-15T10:30:00Z)"
@@ -6952,7 +6997,7 @@ cookCmd.command("logs").description("View logs from the last cook run").option("
 );
 cookCmd.command("continue").description(
   "Continue from the last session (latest conversation and artifact)"
-).argument("<prompt>", "Prompt for the continued agent").action(async (prompt) => {
+).argument("<prompt>", "Prompt for the continued agent").option("--debug-no-mock-claude").action(async (prompt, options) => {
   const state = await loadCookState();
   if (!state.lastSessionId) {
     console.error(chalk21.red("\u2717 No previous session found"));
@@ -6966,7 +7011,13 @@ cookCmd.command("continue").description(
   let runOutput;
   try {
     runOutput = await execVm0RunWithCapture(
-      ["run", "continue", state.lastSessionId, prompt],
+      [
+        "run",
+        "continue",
+        state.lastSessionId,
+        ...options.debugNoMockClaude ? ["--debug-no-mock-claude"] : [],
+        prompt
+      ],
       { cwd }
     );
   } catch {
@@ -6984,7 +7035,7 @@ cookCmd.command("continue").description(
 });
 cookCmd.command("resume").description(
   "Resume from the last checkpoint (snapshotted conversation and artifact)"
-).argument("<prompt>", "Prompt for the resumed agent").action(async (prompt) => {
+).argument("<prompt>", "Prompt for the resumed agent").option("--debug-no-mock-claude").action(async (prompt, options) => {
   const state = await loadCookState();
   if (!state.lastCheckpointId) {
     console.error(chalk21.red("\u2717 No previous checkpoint found"));
@@ -6998,7 +7049,13 @@ cookCmd.command("resume").description(
   let runOutput;
   try {
     runOutput = await execVm0RunWithCapture(
-      ["run", "resume", state.lastCheckpointId, prompt],
+      [
+        "run",
+        "resume",
+        state.lastCheckpointId,
+        ...options.debugNoMockClaude ? ["--debug-no-mock-claude"] : [],
+        prompt
+      ],
       { cwd }
     );
   } catch {
@@ -7394,10 +7451,10 @@ var setCommand = new Command20().name("set").description("Set your scope slug").
 // src/commands/scope/index.ts
 var scopeCommand = new Command21().name("scope").description("Manage your scope (namespace for images)").addCommand(statusCommand3).addCommand(setCommand);
 
-// src/commands/agents/index.ts
+// src/commands/agent/index.ts
 import { Command as Command24 } from "commander";
 
-// src/commands/agents/list.ts
+// src/commands/agent/list.ts
 import { Command as Command22 } from "commander";
 import chalk25 from "chalk";
 var listCommand3 = new Command22().name("list").alias("ls").description("List all agent composes").option("-s, --scope <scope>", "Scope to list composes from").action(async (options) => {
@@ -7443,7 +7500,7 @@ var listCommand3 = new Command22().name("list").alias("ls").description("List al
   }
 });
 
-// src/commands/agents/inspect.ts
+// src/commands/agent/inspect.ts
 import { Command as Command23 } from "commander";
 import chalk26 from "chalk";
 
@@ -7553,7 +7610,7 @@ async function deriveComposeVariableSources(content, options) {
   return results;
 }
 
-// src/commands/agents/inspect.ts
+// src/commands/agent/inspect.ts
 function formatComposeOutput(name, versionId, content, variableSources) {
   console.log(chalk26.bold("Name:") + `    ${name}`);
   console.log(chalk26.bold("Version:") + ` ${versionId}`);
@@ -7635,7 +7692,7 @@ var inspectCommand = new Command23().name("inspect").description("Inspect an age
       } catch (error) {
         if (error instanceof Error && error.message.includes("not found")) {
           console.error(chalk26.red(`\u2717 Agent compose not found: ${name}`));
-          console.error(chalk26.dim("  Run: vm0 agents list"));
+          console.error(chalk26.dim("  Run: vm0 agent list"));
           process.exit(1);
         }
         throw error;
@@ -7702,8 +7759,8 @@ var inspectCommand = new Command23().name("inspect").description("Inspect an age
   }
 );
 
-// src/commands/agents/index.ts
-var agentsCommand = new Command24().name("agents").description("Manage agent composes").addCommand(listCommand3).addCommand(inspectCommand);
+// src/commands/agent/index.ts
+var agentCommand = new Command24().name("agent").description("Manage agent composes").addCommand(listCommand3).addCommand(inspectCommand);
 
 // src/commands/init.ts
 import { Command as Command25 } from "commander";
@@ -9398,11 +9455,183 @@ var disableCommand = new Command33().name("disable").description("Disable a sche
 // src/commands/schedule/index.ts
 var scheduleCommand = new Command34().name("schedule").description("Manage agent schedules").addCommand(initCommand4).addCommand(deployCommand).addCommand(listCommand4).addCommand(statusCommand4).addCommand(deleteCommand).addCommand(enableCommand).addCommand(disableCommand);
 
+// src/commands/usage.ts
+import { Command as Command35 } from "commander";
+import chalk36 from "chalk";
+
+// src/lib/utils/duration-formatter.ts
+function formatDuration(ms) {
+  if (ms === null || ms === void 0 || ms === 0) {
+    return "-";
+  }
+  if (ms < 0) {
+    return "-";
+  }
+  const totalSeconds = Math.floor(ms / 1e3);
+  if (totalSeconds === 0) {
+    return "< 1s";
+  }
+  const hours = Math.floor(totalSeconds / 3600);
+  const minutes = Math.floor(totalSeconds % 3600 / 60);
+  const seconds = totalSeconds % 60;
+  const parts = [];
+  if (hours > 0) {
+    parts.push(`${hours}h`);
+  }
+  if (minutes > 0) {
+    parts.push(`${minutes}m`);
+  }
+  if (seconds > 0) {
+    parts.push(`${seconds}s`);
+  }
+  return parts.join(" ");
+}
+
+// src/commands/usage.ts
+var MAX_RANGE_MS = 30 * 24 * 60 * 60 * 1e3;
+var DEFAULT_RANGE_MS = 7 * 24 * 60 * 60 * 1e3;
+function formatDateDisplay(dateStr) {
+  const date = new Date(dateStr);
+  return date.toLocaleDateString("en-US", { month: "short", day: "numeric" });
+}
+function formatDateRange(start, end) {
+  const startDate = new Date(start);
+  const endDate = new Date(end);
+  endDate.setDate(endDate.getDate() - 1);
+  const startStr = startDate.toLocaleDateString("en-US", {
+    month: "short",
+    day: "numeric"
+  });
+  const endStr = endDate.toLocaleDateString("en-US", {
+    month: "short",
+    day: "numeric",
+    year: "numeric"
+  });
+  return `${startStr} - ${endStr}`;
+}
+function fillMissingDates(daily, startDate, endDate) {
+  const dateMap = /* @__PURE__ */ new Map();
+  for (const day of daily) {
+    dateMap.set(day.date, day);
+  }
+  const result = [];
+  const current = new Date(startDate);
+  current.setUTCHours(0, 0, 0, 0);
+  while (current < endDate) {
+    const dateStr = current.toISOString().split("T")[0];
+    const existing = dateMap.get(dateStr);
+    if (existing) {
+      result.push(existing);
+    } else {
+      result.push({ date: dateStr, run_count: 0, run_time_ms: 0 });
+    }
+    current.setDate(current.getDate() + 1);
+  }
+  result.sort((a, b) => b.date.localeCompare(a.date));
+  return result;
+}
+var usageCommand = new Command35().name("usage").description("View usage statistics").option("--since <date>", "Start date (ISO format or relative: 7d, 30d)").option(
+  "--until <date>",
+  "End date (ISO format or relative, defaults to now)"
+).action(async (options) => {
+  try {
+    const now = /* @__PURE__ */ new Date();
+    let endDate;
+    let startDate;
+    if (options.until) {
+      try {
+        const untilMs = parseTime(options.until);
+        endDate = new Date(untilMs);
+      } catch {
+        console.error(
+          chalk36.red(
+            "Error: Invalid --until format. Use ISO (2026-01-01) or relative (7d, 30d)"
+          )
+        );
+        process.exit(1);
+      }
+    } else {
+      endDate = now;
+    }
+    if (options.since) {
+      try {
+        const sinceMs = parseTime(options.since);
+        startDate = new Date(sinceMs);
+      } catch {
+        console.error(
+          chalk36.red(
+            "Error: Invalid --since format. Use ISO (2026-01-01) or relative (7d, 30d)"
+          )
+        );
+        process.exit(1);
+      }
+    } else {
+      startDate = new Date(endDate.getTime() - DEFAULT_RANGE_MS);
+    }
+    if (startDate >= endDate) {
+      console.error(chalk36.red("Error: --since must be before --until"));
+      process.exit(1);
+    }
+    const rangeMs = endDate.getTime() - startDate.getTime();
+    if (rangeMs > MAX_RANGE_MS) {
+      console.error(
+        chalk36.red(
+          "Error: Time range exceeds maximum of 30 days. Use --until to specify an end date."
+        )
+      );
+      process.exit(1);
+    }
+    const usage = await apiClient.getUsage({
+      startDate: startDate.toISOString(),
+      endDate: endDate.toISOString()
+    });
+    const filledDaily = fillMissingDates(
+      usage.daily,
+      new Date(usage.period.start),
+      new Date(usage.period.end)
+    );
+    console.log();
+    console.log(
+      chalk36.bold(
+        `Usage Summary (${formatDateRange(usage.period.start, usage.period.end)})`
+      )
+    );
+    console.log();
+    console.log(chalk36.dim("DATE        RUNS    RUN TIME"));
+    for (const day of filledDaily) {
+      const dateDisplay = formatDateDisplay(day.date).padEnd(10);
+      const runsDisplay = String(day.run_count).padStart(6);
+      const timeDisplay = formatDuration(day.run_time_ms);
+      console.log(`${dateDisplay}${runsDisplay}    ${timeDisplay}`);
+    }
+    console.log(chalk36.dim("\u2500".repeat(29)));
+    const totalRunsDisplay = String(usage.summary.total_runs).padStart(6);
+    const totalTimeDisplay = formatDuration(usage.summary.total_run_time_ms);
+    console.log(
+      `${"TOTAL".padEnd(10)}${totalRunsDisplay}    ${totalTimeDisplay}`
+    );
+    console.log();
+  } catch (error) {
+    if (error instanceof Error) {
+      if (error.message.includes("Not authenticated")) {
+        console.error(
+          chalk36.red("Error: Not authenticated. Run: vm0 auth login")
+        );
+      } else {
+        console.error(chalk36.red(`Error: ${error.message}`));
+      }
+    } else {
+      console.error(chalk36.red("Error: An unexpected error occurred"));
+    }
+    process.exit(1);
+  }
+});
+
 // src/index.ts
-var program = new Command35();
-program.name("vm0").description("VM0 CLI - A modern build tool").version("5.7.2");
+var program = new Command36();
+program.name("vm0").description("VM0 CLI - A modern build tool").version("5.8.0");
 program.command("info").description("Display environment information").action(async () => {
-  console.log(chalk36.bold("System Information:"));
+  console.log(chalk37.bold("System Information:"));
   console.log(`Node Version: ${process.version}`);
   console.log(`Platform: ${process.platform}`);
   console.log(`Architecture: ${process.arch}`);
@@ -9429,10 +9658,11 @@ program.addCommand(artifactCommand);
 program.addCommand(cookCommand);
 program.addCommand(logsCommand);
 program.addCommand(scopeCommand);
-program.addCommand(agentsCommand);
+program.addCommand(agentCommand);
 program.addCommand(initCommand3);
 program.addCommand(setupGithubCommand);
 program.addCommand(scheduleCommand);
+program.addCommand(usageCommand);
 if (process.argv[1]?.endsWith("index.js") || process.argv[1]?.endsWith("index.ts") || process.argv[1]?.endsWith("vm0")) {
   program.parse();
 }

package/package.json

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