@vm0/cli 9.4.1 → 9.5.1

package/index.js

@@ -1878,7 +1878,7 @@ var credentialsByNameContract = c10.router({
       name: credentialNameSchema
     }),
     responses: {
-      204: z13.undefined(),
+      204: c10.noBody(),
       401: apiErrorSchema,
       404: apiErrorSchema,
       500: apiErrorSchema
@@ -1990,7 +1990,7 @@ var modelProvidersByTypeContract = c11.router({
       type: modelProviderTypeSchema
     }),
     responses: {
-      204: z14.undefined(),
+      204: c11.noBody(),
       401: apiErrorSchema,
       404: apiErrorSchema,
       500: apiErrorSchema
@@ -2275,7 +2275,7 @@ var schedulesByNameContract = c13.router({
       composeId: z16.string().uuid("Compose ID required")
     }),
     responses: {
-      204: z16.undefined(),
+      204: c13.noBody(),
       401: apiErrorSchema,
       404: apiErrorSchema
     },
@@ -3246,10 +3246,10 @@ async function getRawHeaders() {
   }
   return headers;
 }
-async function httpGet(path17) {
+async function httpGet(path16) {
   const baseUrl = await getBaseUrl();
   const headers = await getRawHeaders();
-  return fetch(`${baseUrl}${path17}`, {
+  return fetch(`${baseUrl}${path16}`, {
     method: "GET",
     headers
   });
@@ -3754,49 +3754,49 @@ var cliComposeSchema = z24.object({
 function formatZodError(error) {
   const issue = error.issues[0];
   if (!issue) return "Validation failed";
-  const path17 = issue.path.join(".");
+  const path16 = issue.path.join(".");
   const message = issue.message;
-  if (!path17) return message;
+  if (!path16) return message;
   if (issue.code === "invalid_type") {
     const received = issue.received;
     const isMissing = received === "undefined" || message.includes("received undefined") || message === "Required";
-    if (path17 === "version" && isMissing) {
+    if (path16 === "version" && isMissing) {
       return "Missing config.version";
     }
-    if (path17 === "agents" && isMissing) {
+    if (path16 === "agents" && isMissing) {
       return "Missing agents object in config";
     }
-    if (path17.startsWith("volumes.") && path17.endsWith(".name")) {
-      const volumeKey = path17.split(".")[1];
+    if (path16.startsWith("volumes.") && path16.endsWith(".name")) {
+      const volumeKey = path16.split(".")[1];
       return `Volume "${volumeKey}" must have a 'name' field (string)`;
     }
-    if (path17.startsWith("volumes.") && path17.endsWith(".version")) {
-      const volumeKey = path17.split(".")[1];
+    if (path16.startsWith("volumes.") && path16.endsWith(".version")) {
+      const volumeKey = path16.split(".")[1];
       return `Volume "${volumeKey}" must have a 'version' field (string)`;
     }
     if (issue.expected === "array") {
-      const fieldName = path17.replace(/^agents\.[^.]+\./, "agent.");
+      const fieldName = path16.replace(/^agents\.[^.]+\./, "agent.");
       return `${fieldName} must be an array`;
     }
     if (issue.expected === "string" && received === "number") {
-      const fieldName = path17.replace(/^agents\.[^.]+\./, "agent.");
+      const fieldName = path16.replace(/^agents\.[^.]+\./, "agent.");
       const match = fieldName.match(/^(agent\.[^.]+)\.\d+$/);
       if (match) {
         return `Each entry in ${match[1]?.replace("agent.", "")} must be a string`;
       }
     }
   }
-  if (issue.code === "invalid_key" && path17.startsWith("agents.")) {
+  if (issue.code === "invalid_key" && path16.startsWith("agents.")) {
     return "Invalid agent name format. Must be 3-64 characters, letters, numbers, and hyphens only. Must start and end with letter or number.";
   }
-  if (message === "Invalid key in record" && path17.startsWith("agents.")) {
+  if (message === "Invalid key in record" && path16.startsWith("agents.")) {
     return "Invalid agent name format. Must be 3-64 characters, letters, numbers, and hyphens only. Must start and end with letter or number.";
   }
   if (issue.code === "custom") {
     return message;
   }
-  if (path17.startsWith("agents.")) {
-    const cleanPath = path17.replace(/^agents\.[^.]+\./, "agent.");
+  if (path16.startsWith("agents.")) {
+    const cleanPath = path16.replace(/^agents\.[^.]+\./, "agent.");
     if (message.startsWith("Invalid input:")) {
       const match = message.match(/expected (\w+), received (\w+)/);
       if (match && match[1] === "string" && match[2] === "number") {
@@ -3808,7 +3808,7 @@ function formatZodError(error) {
     }
     return `${cleanPath}: ${message}`;
   }
-  return `${path17}: ${message}`;
+  return `${path16}: ${message}`;
 }
 function validateAgentName(name) {
   return cliAgentNameSchema.safeParse(name).success;
@@ -4382,175 +4382,201 @@ function getSecretsFromComposeContent(content) {
   const grouped = groupVariablesBySource(refs);
   return new Set(grouped.secrets.map((r) => r.name));
 }
-var composeCommand = new Command7().name("compose").description("Create or update agent compose (e.g., vm0.yaml)").argument("<agent-yaml>", "Path to agent YAML file").option("-y, --yes", "Skip confirmation prompts for skill requirements").action(async (configFile, options) => {
+async function loadAndValidateConfig(configFile) {
+  if (!existsSync3(configFile)) {
+    console.error(chalk3.red(`\u2717 Config file not found: ${configFile}`));
+    process.exit(1);
+  }
+  const content = await readFile4(configFile, "utf8");
+  let config;
   try {
-    if (!existsSync3(configFile)) {
-      console.error(chalk3.red(`\u2717 Config file not found: ${configFile}`));
-      process.exit(1);
-    }
-    const content = await readFile4(configFile, "utf8");
-    let config;
-    try {
-      config = parseYaml2(content);
-    } catch (error) {
-      console.error(chalk3.red("\u2717 Invalid YAML format"));
-      if (error instanceof Error) {
-        console.error(chalk3.dim(`  ${error.message}`));
-      }
-      process.exit(1);
-    }
-    const validation = validateAgentCompose(config);
-    if (!validation.valid) {
-      console.error(chalk3.red(`\u2717 ${validation.error}`));
-      process.exit(1);
+    config = parseYaml2(content);
+  } catch (error) {
+    console.error(chalk3.red("\u2717 Invalid YAML format"));
+    if (error instanceof Error) {
+      console.error(chalk3.dim(`  ${error.message}`));
     }
-    const cfg = config;
-    const agentsConfig = cfg.agents;
-    for (const [name, agentConfig] of Object.entries(agentsConfig)) {
-      const image = agentConfig.image;
-      if (image) {
-        console.log(
-          chalk3.yellow(
-            `\u26A0 Agent "${name}": 'image' field is deprecated. Use 'apps' field for pre-installed tools.`
-          )
-        );
-        const warning = getLegacySystemTemplateWarning(image);
-        if (warning) {
-          console.log(chalk3.yellow(`  ${warning}`));
-        }
+    process.exit(1);
+  }
+  const validation = validateAgentCompose(config);
+  if (!validation.valid) {
+    console.error(chalk3.red(`\u2717 ${validation.error}`));
+    process.exit(1);
+  }
+  const cfg = config;
+  const agentsConfig = cfg.agents;
+  const agentName = Object.keys(agentsConfig)[0];
+  const agent = agentsConfig[agentName];
+  const basePath = dirname2(configFile);
+  return { config, agentName, agent, basePath };
+}
+function checkLegacyImageFormat(config) {
+  const cfg = config;
+  const agentsConfig = cfg.agents;
+  for (const [name, agentConfig] of Object.entries(agentsConfig)) {
+    const image = agentConfig.image;
+    if (image) {
+      console.log(
+        chalk3.yellow(
+          `\u26A0 Agent "${name}": 'image' field is deprecated. Use 'apps' field for pre-installed tools.`
+        )
+      );
+      const warning = getLegacySystemTemplateWarning(image);
+      if (warning) {
+        console.log(chalk3.yellow(`  ${warning}`));
       }
     }
-    const agents = agentsConfig;
-    const agentName = Object.keys(agents)[0];
-    const agent = agents[agentName];
-    const basePath = dirname2(configFile);
-    if (agent.instructions) {
-      const instructionsPath = agent.instructions;
-      const framework = agent.framework;
-      console.log(`Uploading instructions: ${instructionsPath}`);
-      const result = await uploadInstructions(
-        agentName,
-        instructionsPath,
-        basePath,
-        framework
-      );
+  }
+}
+async function uploadAssets(agentName, agent, basePath) {
+  if (agent.instructions) {
+    console.log(`Uploading instructions: ${agent.instructions}`);
+    const result = await uploadInstructions(
+      agentName,
+      agent.instructions,
+      basePath,
+      agent.framework
+    );
+    console.log(
+      chalk3.green(
+        `\u2713 Instructions ${result.action === "deduplicated" ? "(unchanged)" : "uploaded"}: ${result.versionId.slice(0, 8)}`
+      )
+    );
+  }
+  const skillResults = [];
+  if (agent.skills && Array.isArray(agent.skills)) {
+    console.log(`Uploading ${agent.skills.length} skill(s)...`);
+    for (const skillUrl of agent.skills) {
+      console.log(chalk3.dim(`  Downloading: ${skillUrl}`));
+      const result = await uploadSkill(skillUrl);
+      skillResults.push(result);
       console.log(
         chalk3.green(
-          `\u2713 Instructions ${result.action === "deduplicated" ? "(unchanged)" : "uploaded"}: ${result.versionId.slice(0, 8)}`
+          `  \u2713 Skill ${result.action === "deduplicated" ? "(unchanged)" : "uploaded"}: ${result.skillName} (${result.versionId.slice(0, 8)})`
         )
       );
     }
-    const skillResults = [];
-    if (agent.skills && Array.isArray(agent.skills)) {
-      const skillUrls = agent.skills;
-      console.log(`Uploading ${skillUrls.length} skill(s)...`);
-      for (const skillUrl of skillUrls) {
-        console.log(chalk3.dim(`  Downloading: ${skillUrl}`));
-        const result = await uploadSkill(skillUrl);
-        skillResults.push(result);
-        console.log(
-          chalk3.green(
-            `  \u2713 Skill ${result.action === "deduplicated" ? "(unchanged)" : "uploaded"}: ${result.skillName} (${result.versionId.slice(0, 8)})`
-          )
-        );
-      }
-    }
-    const skillSecrets = /* @__PURE__ */ new Map();
-    const skillVars = /* @__PURE__ */ new Map();
-    for (const result of skillResults) {
-      const { frontmatter, skillName } = result;
-      if (frontmatter.vm0_secrets) {
-        for (const secret of frontmatter.vm0_secrets) {
-          if (!skillSecrets.has(secret)) {
-            skillSecrets.set(secret, []);
-          }
-          skillSecrets.get(secret).push(skillName);
+  }
+  return skillResults;
+}
+async function collectSkillVariables(skillResults, environment, agentName) {
+  const skillSecrets = /* @__PURE__ */ new Map();
+  const skillVars = /* @__PURE__ */ new Map();
+  for (const result of skillResults) {
+    const { frontmatter, skillName } = result;
+    if (frontmatter.vm0_secrets) {
+      for (const secret of frontmatter.vm0_secrets) {
+        if (!skillSecrets.has(secret)) {
+          skillSecrets.set(secret, []);
         }
+        skillSecrets.get(secret).push(skillName);
       }
-      if (frontmatter.vm0_vars) {
-        for (const varName of frontmatter.vm0_vars) {
-          if (!skillVars.has(varName)) {
-            skillVars.set(varName, []);
-          }
-          skillVars.get(varName).push(skillName);
+    }
+    if (frontmatter.vm0_vars) {
+      for (const varName of frontmatter.vm0_vars) {
+        if (!skillVars.has(varName)) {
+          skillVars.set(varName, []);
         }
+        skillVars.get(varName).push(skillName);
       }
     }
-    const environment = agent.environment || {};
-    const newSecrets = [...skillSecrets.entries()].filter(
-      ([name]) => !(name in environment)
-    );
-    const newVars = [...skillVars.entries()].filter(
-      ([name]) => !(name in environment)
-    );
-    let headSecrets = /* @__PURE__ */ new Set();
-    const existingCompose = await getComposeByName(agentName);
-    if (existingCompose?.content) {
-      headSecrets = getSecretsFromComposeContent(existingCompose.content);
+  }
+  const newSecrets = [...skillSecrets.entries()].filter(
+    ([name]) => !(name in environment)
+  );
+  const newVars = [...skillVars.entries()].filter(
+    ([name]) => !(name in environment)
+  );
+  let headSecrets = /* @__PURE__ */ new Set();
+  const existingCompose = await getComposeByName(agentName);
+  if (existingCompose?.content) {
+    headSecrets = getSecretsFromComposeContent(existingCompose.content);
+  }
+  const trulyNewSecrets = newSecrets.map(([name]) => name).filter((name) => !headSecrets.has(name));
+  return { newSecrets, newVars, trulyNewSecrets };
+}
+async function displayAndConfirmVariables(variables, options) {
+  const { newSecrets, newVars, trulyNewSecrets } = variables;
+  if (newSecrets.length === 0 && newVars.length === 0) {
+    return true;
+  }
+  console.log();
+  console.log(
+    chalk3.bold("Skills require the following environment variables:")
+  );
+  console.log();
+  if (newSecrets.length > 0) {
+    console.log(chalk3.cyan("  Secrets:"));
+    for (const [name, skills] of newSecrets) {
+      const isNew = trulyNewSecrets.includes(name);
+      const newMarker = isNew ? chalk3.yellow(" (new)") : "";
+      console.log(`    ${name.padEnd(24)}${newMarker} <- ${skills.join(", ")}`);
     }
-    const trulyNewSecrets = newSecrets.map(([name]) => name).filter((name) => !headSecrets.has(name));
-    if (newSecrets.length > 0 || newVars.length > 0) {
-      console.log();
-      console.log(
-        chalk3.bold("Skills require the following environment variables:")
+  }
+  if (newVars.length > 0) {
+    console.log(chalk3.cyan("  Vars:"));
+    for (const [name, skills] of newVars) {
+      console.log(`    ${name.padEnd(24)} <- ${skills.join(", ")}`);
+    }
+  }
+  console.log();
+  if (trulyNewSecrets.length > 0 && !options.yes) {
+    if (!isInteractive()) {
+      console.error(
+        chalk3.red(`\u2717 New secrets detected: ${trulyNewSecrets.join(", ")}`)
       );
-      console.log();
-      if (newSecrets.length > 0) {
-        console.log(chalk3.cyan("  Secrets:"));
-        for (const [name, skills] of newSecrets) {
-          const isNew = trulyNewSecrets.includes(name);
-          const newMarker = isNew ? chalk3.yellow(" (new)") : "";
-          console.log(
-            `    ${name.padEnd(24)}${newMarker} <- ${skills.join(", ")}`
-          );
-        }
-      }
-      if (newVars.length > 0) {
-        console.log(chalk3.cyan("  Vars:"));
-        for (const [name, skills] of newVars) {
-          console.log(`    ${name.padEnd(24)} <- ${skills.join(", ")}`);
-        }
-      }
-      console.log();
-      if (trulyNewSecrets.length > 0) {
-        if (!options.yes) {
-          if (!isInteractive()) {
-            console.error(
-              chalk3.red(
-                `\u2717 New secrets detected: ${trulyNewSecrets.join(", ")}`
-              )
-            );
-            console.error(
-              chalk3.dim(
-                "  Use --yes flag to approve new secrets in non-interactive mode."
-              )
-            );
-            process.exit(1);
-          }
-          const confirmed = await promptConfirm(
-            `Approve ${trulyNewSecrets.length} new secret(s)?`,
-            true
-          );
-          if (!confirmed) {
-            console.log(chalk3.yellow("Compose cancelled"));
-            process.exit(0);
-          }
-        }
-      }
-      for (const [name] of newSecrets) {
-        environment[name] = `\${{ secrets.${name} }}`;
-      }
-      for (const [name] of newVars) {
-        environment[name] = `\${{ vars.${name} }}`;
-      }
-      if (Object.keys(environment).length > 0) {
-        agent.environment = environment;
-      }
+      console.error(
+        chalk3.dim(
+          "  Use --yes flag to approve new secrets in non-interactive mode."
+        )
+      );
+      process.exit(1);
+    }
+    const confirmed = await promptConfirm(
+      `Approve ${trulyNewSecrets.length} new secret(s)?`,
+      true
+    );
+    if (!confirmed) {
+      console.log(chalk3.yellow("Compose cancelled"));
+      return false;
     }
+  }
+  return true;
+}
+function mergeSkillVariables(agent, variables) {
+  const { newSecrets, newVars } = variables;
+  if (newSecrets.length === 0 && newVars.length === 0) {
+    return;
+  }
+  const environment = agent.environment || {};
+  for (const [name] of newSecrets) {
+    environment[name] = `\${{ secrets.${name} }}`;
+  }
+  for (const [name] of newVars) {
+    environment[name] = `\${{ vars.${name} }}`;
+  }
+  if (Object.keys(environment).length > 0) {
+    agent.environment = environment;
+  }
+}
+var composeCommand = new Command7().name("compose").description("Create or update agent compose (e.g., vm0.yaml)").argument("<agent-yaml>", "Path to agent YAML file").option("-y, --yes", "Skip confirmation prompts for skill requirements").action(async (configFile, options) => {
+  try {
+    const { config, agentName, agent, basePath } = await loadAndValidateConfig(configFile);
+    checkLegacyImageFormat(config);
+    const skillResults = await uploadAssets(agentName, agent, basePath);
+    const environment = agent.environment || {};
+    const variables = await collectSkillVariables(
+      skillResults,
+      environment,
+      agentName
+    );
+    const confirmed = await displayAndConfirmVariables(variables, options);
+    if (!confirmed) {
+      process.exit(0);
+    }
+    mergeSkillVariables(agent, variables);
     console.log("Uploading compose...");
-    const response = await createOrUpdateCompose({
-      content: config
-    });
+    const response = await createOrUpdateCompose({ content: config });
     const scopeResponse = await getScope();
     const shortVersionId = response.versionId.slice(0, 8);
     const displayName = `${scopeResponse.slug}/${response.name}`;
@@ -4571,9 +4597,6 @@ var composeCommand = new Command7().name("compose").description("Create or updat
     if (error instanceof Error) {
       if (error.message.includes("Not authenticated")) {
         console.error(chalk3.red("\u2717 Not authenticated. Run: vm0 auth login"));
-      } else if (error.message.includes("Failed to create compose")) {
-        console.error(chalk3.red("\u2717 Failed to create compose"));
-        console.error(chalk3.dim(`  ${error.message}`));
       } else {
         console.error(chalk3.red("\u2717 Failed to create compose"));
         console.error(chalk3.dim(`  ${error.message}`));
@@ -5984,7 +6007,7 @@ var ApiClient = class {
   /**
    * Generic GET request
    */
-  async get(path17) {
+  async get(path16) {
     const baseUrl = await this.getBaseUrl();
     const token = await getToken();
     if (!token) {
@@ -5997,7 +6020,7 @@ var ApiClient = class {
     if (bypassSecret) {
       headers["x-vercel-protection-bypass"] = bypassSecret;
     }
-    return fetch(`${baseUrl}${path17}`, {
+    return fetch(`${baseUrl}${path16}`, {
       method: "GET",
       headers
     });
@@ -6005,7 +6028,7 @@ var ApiClient = class {
   /**
    * Generic POST request
    */
-  async post(path17, options) {
+  async post(path16, options) {
     const baseUrl = await this.getBaseUrl();
     const token = await getToken();
     if (!token) {
@@ -6021,7 +6044,7 @@ var ApiClient = class {
     if (bypassSecret) {
       headers["x-vercel-protection-bypass"] = bypassSecret;
     }
-    return fetch(`${baseUrl}${path17}`, {
+    return fetch(`${baseUrl}${path16}`, {
       method: "POST",
       headers,
       body: options?.body
@@ -6030,7 +6053,7 @@ var ApiClient = class {
   /**
    * Generic DELETE request
    */
-  async delete(path17) {
+  async delete(path16) {
     const baseUrl = await this.getBaseUrl();
     const token = await getToken();
     if (!token) {
@@ -6043,7 +6066,7 @@ var ApiClient = class {
     if (bypassSecret) {
       headers["x-vercel-protection-bypass"] = bypassSecret;
     }
-    return fetch(`${baseUrl}${path17}`, {
+    return fetch(`${baseUrl}${path16}`, {
       method: "DELETE",
       headers
     });
@@ -7848,8 +7871,10 @@ function execVm0Command(args, options = {}) {
 }
 function execVm0RunWithCapture(args, options = {}) {
   return new Promise((resolve, reject) => {
+    const env = process.stdout.isTTY ? { ...process.env, FORCE_COLOR: "1" } : process.env;
     const proc = spawn2("vm0", args, {
       cwd: options.cwd,
+      env,
       stdio: ["inherit", "pipe", "pipe"],
       shell: process.platform === "win32"
     });
@@ -7960,135 +7985,89 @@ function checkMissingVariables(varNames, envFilePath) {
   }
   return missing;
 }
-var cookAction = new Command27().name("cook").description("Quick start: prepare, compose and run agent from vm0.yaml").argument("[prompt]", "Prompt for the agent").option(
-  "--env-file <path>",
-  "Load environment variables from file (priority: CLI flags > file > env vars)"
-).option("-y, --yes", "Skip confirmation prompts").addOption(new Option4("--debug-no-mock-claude").hideHelp()).addOption(new Option4("--no-auto-update").hideHelp()).action(
-  // eslint-disable-next-line complexity -- TODO: refactor complex function
-  async (prompt, options) => {
-    if (!options.noAutoUpdate) {
-      const shouldExit = await checkAndUpgrade("9.4.1", prompt);
-      if (shouldExit) {
-        process.exit(0);
-      }
-    }
-    const cwd = process.cwd();
-    console.log(chalk28.bold(`Reading config: ${CONFIG_FILE2}`));
-    if (!existsSync9(CONFIG_FILE2)) {
-      console.error(chalk28.red(`\u2717 Config file not found: ${CONFIG_FILE2}`));
-      process.exit(1);
+async function loadAndValidateConfig2() {
+  console.log(chalk28.bold(`Reading config: ${CONFIG_FILE2}`));
+  if (!existsSync9(CONFIG_FILE2)) {
+    console.error(chalk28.red(`\u2717 Config file not found: ${CONFIG_FILE2}`));
+    process.exit(1);
+  }
+  let config;
+  try {
+    const content = await readFile7(CONFIG_FILE2, "utf8");
+    config = parseYaml4(content);
+  } catch (error) {
+    console.error(chalk28.red("\u2717 Invalid YAML format"));
+    if (error instanceof Error) {
+      console.error(chalk28.dim(`  ${error.message}`));
     }
-    let config;
-    try {
-      const content = await readFile7(CONFIG_FILE2, "utf8");
-      config = parseYaml4(content);
-    } catch (error) {
-      console.error(chalk28.red("\u2717 Invalid YAML format"));
-      if (error instanceof Error) {
-        console.error(chalk28.dim(`  ${error.message}`));
+    process.exit(1);
+  }
+  const validation = validateAgentCompose(config);
+  if (!validation.valid) {
+    console.error(chalk28.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(
+    chalk28.green(`\u2713 Config validated: 1 agent, ${volumeCount} volume(s)`)
+  );
+  return { config, agentName, volumeCount };
+}
+function validateEnvVariables(config, envFile) {
+  const requiredVarNames = extractRequiredVarNames(config);
+  if (requiredVarNames.length === 0) {
+    return;
+  }
+  try {
+    const missingVars = checkMissingVariables(requiredVarNames, envFile);
+    if (missingVars.length > 0) {
+      console.log();
+      console.error(chalk28.red("\u2717 Missing required variables:"));
+      for (const varName of missingVars) {
+        console.error(chalk28.red(`  ${varName}`));
       }
+      console.error(
+        chalk28.dim(
+          "\n  Provide via --env-file, or set as environment variables"
+        )
+      );
       process.exit(1);
     }
-    const validation = validateAgentCompose(config);
-    if (!validation.valid) {
-      console.error(chalk28.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(
-      chalk28.green(`\u2713 Config validated: 1 agent, ${volumeCount} volume(s)`)
-    );
-    const requiredVarNames = extractRequiredVarNames(config);
-    if (requiredVarNames.length > 0) {
-      try {
-        const missingVars = checkMissingVariables(
-          requiredVarNames,
-          options.envFile
-        );
-        if (missingVars.length > 0) {
-          console.log();
-          console.error(chalk28.red("\u2717 Missing required variables:"));
-          for (const varName of missingVars) {
-            console.error(chalk28.red(`  ${varName}`));
-          }
-          console.error(
-            chalk28.dim(
-              "\n  Provide via --env-file, or set as environment variables"
-            )
-          );
-          process.exit(1);
-        }
-      } catch (error) {
-        if (error instanceof Error) {
-          console.error(chalk28.red(`\u2717 ${error.message}`));
-        }
-        process.exit(1);
-      }
+  } catch (error) {
+    if (error instanceof Error) {
+      console.error(chalk28.red(`\u2717 ${error.message}`));
     }
-    if (config.volumes && Object.keys(config.volumes).length > 0) {
-      console.log();
-      console.log(chalk28.bold("Processing volumes:"));
-      for (const volumeConfig of Object.values(config.volumes)) {
-        const volumeDir = path11.join(cwd, volumeConfig.name);
-        if (!existsSync9(volumeDir)) {
-          console.error(
-            chalk28.red(`\u2717 Directory not found: ${volumeConfig.name}`)
-          );
-          console.error(
-            chalk28.dim("  Create the directory and add files first")
-          );
-          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
-              }
-            );
-          }
-          printCommand("vm0 volume push");
-          await execVm0Command(["volume", "push"], {
-            cwd: volumeDir,
-            silent: true
-          });
-          printCommand("cd ..");
-        } catch (error) {
-          console.error(chalk28.red(`\u2717 Failed`));
-          if (error instanceof Error) {
-            console.error(chalk28.dim(`  ${error.message}`));
-          }
-          process.exit(1);
-        }
-      }
+    process.exit(1);
+  }
+}
+async function processVolumes(config, cwd) {
+  if (!config.volumes || Object.keys(config.volumes).length === 0) {
+    return;
+  }
+  console.log();
+  console.log(chalk28.bold("Processing volumes:"));
+  for (const volumeConfig of Object.values(config.volumes)) {
+    const volumeDir = path11.join(cwd, volumeConfig.name);
+    if (!existsSync9(volumeDir)) {
+      console.error(chalk28.red(`\u2717 Directory not found: ${volumeConfig.name}`));
+      console.error(chalk28.dim("  Create the directory and add files first"));
+      process.exit(1);
     }
-    console.log();
-    console.log(chalk28.bold("Processing artifact:"));
-    const artifactDir = path11.join(cwd, ARTIFACT_DIR);
     try {
-      if (!existsSync9(artifactDir)) {
-        printCommand(`mkdir ${ARTIFACT_DIR}`);
-        await mkdir6(artifactDir, { recursive: true });
-      }
-      printCommand(`cd ${ARTIFACT_DIR}`);
-      const existingConfig = await readStorageConfig(artifactDir);
+      printCommand(`cd ${volumeConfig.name}`);
+      const existingConfig = await readStorageConfig(volumeDir);
       if (!existingConfig) {
-        printCommand(`vm0 artifact init --name ${ARTIFACT_DIR}`);
-        await execVm0Command(["artifact", "init", "--name", ARTIFACT_DIR], {
-          cwd: artifactDir,
+        printCommand(`vm0 volume init --name ${volumeConfig.name}`);
+        await execVm0Command(["volume", "init", "--name", volumeConfig.name], {
+          cwd: volumeDir,
           silent: true
         });
       }
-      printCommand("vm0 artifact push");
-      await execVm0Command(["artifact", "push"], {
-        cwd: artifactDir,
+      printCommand("vm0 volume push");
+      await execVm0Command(["volume", "push"], {
+        cwd: volumeDir,
         silent: true
       });
       printCommand("cd ..");
@@ -8099,51 +8078,112 @@ var cookAction = new Command27().name("cook").description("Quick start: prepare,
       }
       process.exit(1);
     }
-    console.log();
-    console.log(chalk28.bold("Composing agent:"));
-    const composeArgs = options.yes ? ["compose", "--yes", CONFIG_FILE2] : ["compose", CONFIG_FILE2];
-    printCommand(`vm0 ${composeArgs.join(" ")}`);
-    try {
-      await execVm0Command(composeArgs, {
-        cwd
+  }
+}
+async function processArtifact(cwd) {
+  console.log();
+  console.log(chalk28.bold("Processing artifact:"));
+  const artifactDir = path11.join(cwd, ARTIFACT_DIR);
+  try {
+    if (!existsSync9(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
       });
-    } catch (error) {
-      console.error(chalk28.red(`\u2717 Compose failed`));
-      if (error instanceof Error) {
-        console.error(chalk28.dim(`  ${error.message}`));
+    }
+    printCommand("vm0 artifact push");
+    await execVm0Command(["artifact", "push"], {
+      cwd: artifactDir,
+      silent: true
+    });
+    printCommand("cd ..");
+  } catch (error) {
+    console.error(chalk28.red(`\u2717 Failed`));
+    if (error instanceof Error) {
+      console.error(chalk28.dim(`  ${error.message}`));
+    }
+    process.exit(1);
+  }
+  return artifactDir;
+}
+async function composeAgent(cwd, skipConfirm) {
+  console.log();
+  console.log(chalk28.bold("Composing agent:"));
+  const composeArgs = skipConfirm ? ["compose", "--yes", CONFIG_FILE2] : ["compose", CONFIG_FILE2];
+  printCommand(`vm0 ${composeArgs.join(" ")}`);
+  try {
+    await execVm0Command(composeArgs, { cwd });
+  } catch (error) {
+    console.error(chalk28.red(`\u2717 Compose failed`));
+    if (error instanceof Error) {
+      console.error(chalk28.dim(`  ${error.message}`));
+    }
+    process.exit(1);
+  }
+}
+async function runAgent(agentName, artifactDir, prompt, cwd, debugNoMockClaude) {
+  console.log();
+  console.log(chalk28.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,
+      ...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);
+}
+var cookAction = new Command27().name("cook").description("Quick start: prepare, compose and run agent from vm0.yaml").argument("[prompt]", "Prompt for the agent").option(
+  "--env-file <path>",
+  "Load environment variables from file (priority: CLI flags > file > env vars)"
+).option("-y, --yes", "Skip confirmation prompts").addOption(new Option4("--debug-no-mock-claude").hideHelp()).addOption(new Option4("--no-auto-update").hideHelp()).action(
+  async (prompt, options) => {
+    if (!options.noAutoUpdate) {
+      const shouldExit = await checkAndUpgrade("9.5.1", prompt);
+      if (shouldExit) {
+        process.exit(0);
       }
-      process.exit(1);
     }
+    const cwd = process.cwd();
+    const { config, agentName } = await loadAndValidateConfig2();
+    validateEnvVariables(config, options.envFile);
+    await processVolumes(config, cwd);
+    const artifactDir = await processArtifact(cwd);
+    await composeAgent(cwd, options.yes ?? false);
     if (prompt) {
-      console.log();
-      console.log(chalk28.bold("Running agent:"));
-      printCommand(
-        `vm0 run ${agentName} --artifact-name ${ARTIFACT_DIR} "${prompt}"`
+      await runAgent(
+        agentName,
+        artifactDir,
+        prompt,
+        cwd,
+        options.debugNoMockClaude ?? false
       );
-      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:");
@@ -10706,86 +10746,115 @@ import { Command as Command56 } from "commander";
 import chalk56 from "chalk";
 import { mkdir as mkdir7 } from "fs/promises";
 import { existsSync as existsSync11 } from "fs";
-import path16 from "path";
 
 // src/lib/ui/welcome-box.ts
 import chalk53 from "chalk";
-function renderWelcomeBox(lines, width) {
-  const maxLineLength = Math.max(...lines.map((line) => line.length));
-  const boxWidth = width ?? maxLineLength + 4;
-  const innerWidth = boxWidth - 2;
-  const horizontalLine = "\u2500".repeat(innerWidth);
-  const topBorder = `\u250C${horizontalLine}\u2510`;
-  const bottomBorder = `\u2514${horizontalLine}\u2518`;
-  console.log(chalk53.cyan(topBorder));
-  for (const line of lines) {
-    const padding = innerWidth - line.length;
-    const leftPad = Math.floor(padding / 2);
-    const rightPad = padding - leftPad;
-    const centeredLine = " ".repeat(leftPad) + line + " ".repeat(rightPad);
-    console.log(chalk53.cyan("\u2502") + centeredLine + chalk53.cyan("\u2502"));
-  }
-  console.log(chalk53.cyan(bottomBorder));
+var gradientColors = [
+  chalk53.hex("#FFAB5E"),
+  // Line 1 - lightest
+  chalk53.hex("#FF9642"),
+  // Line 2
+  chalk53.hex("#FF8228"),
+  // Line 3
+  chalk53.hex("#FF6D0A"),
+  // Line 4
+  chalk53.hex("#E85D00"),
+  // Line 5
+  chalk53.hex("#CC4E00")
+  // Line 6 - darkest
+];
+var vm0LogoLines = [
+  "\u2588\u2588\u2557   \u2588\u2588\u2557\u2588\u2588\u2588\u2557   \u2588\u2588\u2588\u2557 \u2588\u2588\u2588\u2588\u2588\u2588\u2557 ",
+  "\u2588\u2588\u2551   \u2588\u2588\u2551\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2550\u2550\u2588\u2588\u2557",
+  "\u2588\u2588\u2551   \u2588\u2588\u2551\u2588\u2588\u2554\u2588\u2588\u2588\u2588\u2554\u2588\u2588\u2551\u2588\u2588\u2551   \u2588\u2588\u2551",
+  "\u255A\u2588\u2588\u2557 \u2588\u2588\u2554\u255D\u2588\u2588\u2551\u255A\u2588\u2588\u2554\u255D\u2588\u2588\u2551\u2588\u2588\u2551   \u2588\u2588\u2551",
+  " \u255A\u2588\u2588\u2588\u2588\u2554\u255D \u2588\u2588\u2551 \u255A\u2550\u255D \u2588\u2588\u2551\u255A\u2588\u2588\u2588\u2588\u2588\u2588\u2554\u255D",
+  "  \u255A\u2550\u2550\u2550\u255D  \u255A\u2550\u255D     \u255A\u2550\u255D \u255A\u2550\u2550\u2550\u2550\u2550\u255D "
+];
+function renderVm0Banner() {
+  console.log();
+  for (let i = 0; i < vm0LogoLines.length; i++) {
+    const color = gradientColors[i] ?? gradientColors[gradientColors.length - 1];
+    console.log(`  ${color?.(vm0LogoLines[i])}`);
+  }
+  console.log();
 }
 function renderOnboardWelcome() {
-  renderWelcomeBox([
-    "",
-    "Welcome to VM0!",
-    "",
-    "Let's create your first agent.",
-    ""
-  ]);
+  renderVm0Banner();
+  console.log(`  ${chalk53.bold("Welcome to VM0!")}`);
+  console.log(
+    `  ${chalk53.dim("Build agentic workflows using natural language.")}`
+  );
+  console.log();
 }
 
-// src/lib/ui/progress-line.ts
+// src/lib/ui/step-runner.ts
 import chalk54 from "chalk";
-var STATUS_SYMBOLS = {
-  completed: "\u25CF",
-  "in-progress": "\u25D0",
-  pending: "\u25CB",
-  failed: "\u2717"
-};
-function getStatusColor(status) {
-  switch (status) {
-    case "completed":
-      return chalk54.green;
-    case "in-progress":
-      return chalk54.yellow;
-    case "failed":
-      return chalk54.red;
-    case "pending":
-    default:
-      return chalk54.dim;
+function createStepRunner(options = true) {
+  const opts = typeof options === "boolean" ? { interactive: options } : options;
+  const interactive = opts.interactive ?? true;
+  const headerFn = opts.header;
+  const completedSteps = [];
+  function redrawCompletedSteps(isFinal) {
+    process.stdout.write("\x1B[2J\x1B[H");
+    if (headerFn) {
+      console.log();
+      headerFn();
+      console.log();
+    }
+    for (const [i, step] of completedSteps.entries()) {
+      if (step.failed) {
+        console.log(chalk54.red(`\u2717 ${step.label}`));
+      } else {
+        console.log(chalk54.green(`\u25CF ${step.label}`));
+      }
+      const isLastStep = i === completedSteps.length - 1;
+      if (!isLastStep || !isFinal) {
+        console.log(chalk54.dim("\u2502"));
+      }
+    }
   }
-}
-function renderProgressLine(steps) {
-  for (let i = 0; i < steps.length; i++) {
-    const step = steps[i];
-    if (!step) continue;
-    const symbol = STATUS_SYMBOLS[step.status];
-    const color = getStatusColor(step.status);
-    console.log(color(`${symbol} ${step.label}`));
-    if (i < steps.length - 1) {
-      console.log(chalk54.dim("\u2502"));
+  async function executeStep(label, fn, isFinal) {
+    let stepFailed = false;
+    console.log(chalk54.yellow(`\u25CB ${label}`));
+    const ctx = {
+      connector() {
+        console.log(chalk54.dim("\u2502"));
+      },
+      detail(message) {
+        console.log(`${chalk54.dim("\u2502")} ${message}`);
+      },
+      async prompt(promptFn) {
+        return await promptFn();
+      }
+    };
+    try {
+      await fn(ctx);
+    } catch (error) {
+      stepFailed = true;
+      throw error;
+    } finally {
+      completedSteps.push({ label, failed: stepFailed });
+      if (interactive) {
+        redrawCompletedSteps(isFinal);
+      } else {
+        if (stepFailed) {
+          console.log(chalk54.red(`\u2717 ${label}`));
+        } else {
+          console.log(chalk54.green(`\u25CF ${label}`));
+        }
+        if (!isFinal) {
+          console.log(chalk54.dim("\u2502"));
+        }
+      }
     }
   }
-}
-function createOnboardProgress() {
-  const steps = [
-    { label: "Authentication", status: "pending" },
-    { label: "Model Provider Setup", status: "pending" },
-    { label: "Create Agent", status: "pending" },
-    { label: "Claude Plugin Install", status: "pending" },
-    { label: "Complete", status: "pending" }
-  ];
   return {
-    steps,
-    render: () => renderProgressLine(steps),
-    update: (index, status) => {
-      const step = steps[index];
-      if (step) {
-        step.status = status;
-      }
+    async step(label, fn) {
+      await executeStep(label, fn, false);
+    },
+    async finalStep(label, fn) {
+      await executeStep(label, fn, true);
     }
   };
 }
@@ -11022,162 +11091,162 @@ async function installVm0Plugin(scope = "user", cwd) {
 // src/commands/onboard/index.ts
 var DEFAULT_AGENT_NAME = "my-vm0-agent";
 async function handleAuthentication(ctx) {
-  ctx.updateProgress(0, "in-progress");
-  const authenticated = await isAuthenticated();
-  if (authenticated) {
-    ctx.updateProgress(0, "completed");
-    return;
-  }
-  if (!ctx.interactive) {
-    console.error(chalk56.red("Error: Not authenticated"));
-    console.error("Run 'vm0 auth login' first or set VM0_TOKEN");
-    process.exit(1);
-  }
-  console.log(chalk56.dim("Authentication required..."));
-  console.log();
-  await runAuthFlow({
-    onInitiating: () => {
-      console.log("Initiating authentication...");
-    },
-    onDeviceCodeReady: (url, code, expiresIn) => {
-      console.log(chalk56.green("\nDevice code generated"));
-      console.log(chalk56.cyan(`
-To authenticate, visit: ${url}`));
-      console.log(`And enter this code: ${chalk56.bold(code)}`);
-      console.log(`
-The code expires in ${expiresIn} minutes.`);
-      console.log("\nWaiting for authentication...");
-    },
-    onPolling: () => {
-      process.stdout.write(chalk56.dim("."));
-    },
-    onSuccess: () => {
-      console.log(chalk56.green("\nAuthentication successful!"));
-      console.log("Your credentials have been saved.");
-    },
-    onError: (error) => {
-      console.error(chalk56.red(`
-${error.message}`));
+  await ctx.runner.step("Authenticate to vm0.ai", async (step) => {
+    const authenticated = await isAuthenticated();
+    if (authenticated) {
+      return;
+    }
+    if (!ctx.interactive) {
+      console.error(chalk56.red("Error: Not authenticated"));
+      console.error("Run 'vm0 auth login' first or set VM0_TOKEN");
       process.exit(1);
     }
+    await runAuthFlow({
+      onInitiating: () => {
+      },
+      onDeviceCodeReady: (url, code, expiresIn) => {
+        step.detail(`Copy code: ${chalk56.cyan.bold(code)}`);
+        step.detail(`Open: ${chalk56.cyan(url)}`);
+        step.detail(chalk56.dim(`Expires in ${expiresIn} minutes`));
+      },
+      onPolling: () => {
+      },
+      onSuccess: () => {
+      },
+      onError: (error) => {
+        console.error(chalk56.red(`
+${error.message}`));
+        process.exit(1);
+      }
+    });
   });
-  ctx.updateProgress(0, "completed");
 }
 async function handleModelProvider(ctx) {
-  ctx.updateProgress(1, "in-progress");
-  const providerStatus = await checkModelProviderStatus();
-  if (providerStatus.hasProvider) {
-    ctx.updateProgress(1, "completed");
-    return;
-  }
-  if (!ctx.interactive) {
-    console.error(chalk56.red("Error: No model provider configured"));
-    console.error("Run 'vm0 model-provider setup' first");
-    process.exit(1);
-  }
-  console.log(chalk56.dim("Model provider setup required..."));
-  console.log();
-  const choices = getProviderChoices();
-  const providerType = await promptSelect(
-    "Select provider type:",
-    choices.map((c20) => ({
-      title: c20.label,
-      value: c20.type,
-      description: c20.helpText
-    }))
-  );
-  if (!providerType) {
-    process.exit(0);
-  }
-  const selectedChoice = choices.find((c20) => c20.type === providerType);
-  if (selectedChoice) {
-    console.log();
-    console.log(chalk56.dim(selectedChoice.helpText));
-    console.log();
-  }
-  const credential = await promptPassword(
-    `Enter your ${selectedChoice?.credentialLabel ?? "credential"}:`
-  );
-  if (!credential) {
-    console.log(chalk56.dim("Cancelled"));
-    process.exit(0);
-  }
-  const result = await setupModelProvider(providerType, credential);
-  console.log(
-    chalk56.green(
-      `
-\u2713 Model provider "${providerType}" ${result.created ? "created" : "updated"}${result.isDefault ? ` (default for ${result.framework})` : ""}`
-    )
-  );
-  ctx.updateProgress(1, "completed");
-}
-async function handleAgentCreation(ctx) {
-  ctx.updateProgress(2, "in-progress");
-  let agentName = ctx.options.name ?? DEFAULT_AGENT_NAME;
-  if (!ctx.options.yes && !ctx.options.name && ctx.interactive) {
-    const inputName = await promptText(
-      "Enter agent name:",
-      DEFAULT_AGENT_NAME,
-      (value) => {
-        if (!validateAgentName(value)) {
-          return "Invalid name: 3-64 chars, alphanumeric + hyphens, start/end with letter/number";
-        }
-        return true;
+  await ctx.runner.step("Set Up Model Provider", async (step) => {
+    const providerStatus = await checkModelProviderStatus();
+    if (providerStatus.hasProvider) {
+      return;
+    }
+    if (!ctx.interactive) {
+      console.error(chalk56.red("Error: No model provider configured"));
+      console.error("Run 'vm0 model-provider setup' first");
+      process.exit(1);
+    }
+    const choices = getProviderChoices();
+    step.connector();
+    const providerType = await step.prompt(
+      () => promptSelect(
+        "Select provider type:",
+        choices.map((c20) => ({
+          title: c20.label,
+          value: c20.type
+        }))
+      )
+    );
+    if (!providerType) {
+      process.exit(0);
+    }
+    const selectedChoice = choices.find((c20) => c20.type === providerType);
+    if (selectedChoice?.helpText) {
+      for (const line of selectedChoice.helpText.split("\n")) {
+        step.detail(chalk56.dim(line));
       }
+    }
+    const credential = await step.prompt(
+      () => promptPassword(
+        `Enter your ${selectedChoice?.credentialLabel ?? "credential"}:`
+      )
     );
-    if (!inputName) {
+    if (!credential) {
+      console.log(chalk56.dim("Cancelled"));
       process.exit(0);
     }
-    agentName = inputName;
-  }
-  if (!validateAgentName(agentName)) {
-    console.error(
-      chalk56.red(
-        "Invalid agent name: must be 3-64 chars, alphanumeric + hyphens"
+    const result = await setupModelProvider(providerType, credential);
+    step.detail(
+      chalk56.green(
+        `${providerType} ${result.created ? "created" : "updated"}${result.isDefault ? ` (default for ${result.framework})` : ""}`
       )
     );
-    process.exit(1);
-  }
-  if (existsSync11(agentName)) {
-    console.error(chalk56.red(`
-\u2717 ${agentName}/ already exists`));
-    console.log();
-    console.log("Remove it first or choose a different name:");
-    console.log(chalk56.cyan(`  rm -rf ${agentName}`));
-    process.exit(1);
-  }
-  await mkdir7(agentName, { recursive: true });
-  console.log(chalk56.green(`\u2713 Created ${agentName}/`));
-  ctx.updateProgress(2, "completed");
+  });
+}
+async function handleAgentCreation(ctx) {
+  let agentName = ctx.options.name ?? DEFAULT_AGENT_NAME;
+  await ctx.runner.step("Create New Project", async (step) => {
+    if (!ctx.options.yes && !ctx.options.name && ctx.interactive) {
+      let folderExists = true;
+      while (folderExists) {
+        step.connector();
+        const inputName = await step.prompt(
+          () => promptText(
+            "Enter project name:",
+            DEFAULT_AGENT_NAME,
+            (value) => {
+              if (!validateAgentName(value)) {
+                return "Invalid name: 3-64 chars, alphanumeric + hyphens, start/end with letter/number";
+              }
+              return true;
+            }
+          )
+        );
+        if (!inputName) {
+          process.exit(0);
+        }
+        agentName = inputName;
+        if (existsSync11(agentName)) {
+          step.detail(
+            chalk56.yellow(`${agentName}/ already exists, choose another name`)
+          );
+        } else {
+          folderExists = false;
+        }
+      }
+    } else {
+      if (!validateAgentName(agentName)) {
+        console.error(
+          chalk56.red(
+            "Invalid agent name: must be 3-64 chars, alphanumeric + hyphens"
+          )
+        );
+        process.exit(1);
+      }
+      if (existsSync11(agentName)) {
+        console.error(chalk56.red(`${agentName}/ already exists`));
+        console.log();
+        console.log("Remove it first or choose a different name:");
+        console.log(chalk56.cyan(`  rm -rf ${agentName}`));
+        process.exit(1);
+      }
+    }
+    await mkdir7(agentName, { recursive: true });
+    step.detail(chalk56.green(`Created ${agentName}/`));
+  });
   return agentName;
 }
 async function handlePluginInstallation(ctx, agentName) {
-  ctx.updateProgress(3, "in-progress");
-  let shouldInstall = true;
-  if (!ctx.options.yes && ctx.interactive) {
-    const confirmed = await promptConfirm(
-      "Install VM0 Claude Plugin?",
-      true
-      // default: Yes
-    );
-    shouldInstall = confirmed ?? true;
-  }
-  if (!shouldInstall) {
-    console.log(chalk56.dim("Skipped plugin installation"));
-    ctx.updateProgress(3, "completed");
-    return;
-  }
-  const scope = "project";
-  try {
-    const agentDir = path16.resolve(process.cwd(), agentName);
-    const result = await installVm0Plugin(scope, agentDir);
-    console.log(
-      chalk56.green(`\u2713 Installed ${result.pluginId} (scope: ${result.scope})`)
-    );
-  } catch (error) {
-    handlePluginError(error);
-  }
-  ctx.updateProgress(3, "completed");
+  await ctx.runner.step("Install Claude Plugin", async (step) => {
+    let shouldInstall = true;
+    if (!ctx.options.yes && ctx.interactive) {
+      step.connector();
+      const confirmed = await step.prompt(
+        () => promptConfirm("Install VM0 Claude Plugin?", true)
+      );
+      shouldInstall = confirmed ?? true;
+    }
+    if (!shouldInstall) {
+      step.detail(chalk56.dim("Skipped"));
+      return;
+    }
+    const scope = "project";
+    try {
+      const agentDir = `${process.cwd()}/${agentName}`;
+      const result = await installVm0Plugin(scope, agentDir);
+      step.detail(
+        chalk56.green(`Installed ${result.pluginId} (scope: ${result.scope})`)
+      );
+    } catch (error) {
+      handlePluginError(error);
+    }
+  });
 }
 function printNextSteps(agentName) {
   console.log();
@@ -11191,31 +11260,22 @@ function printNextSteps(agentName) {
 var onboardCommand = new Command56().name("onboard").description("Guided setup for new VM0 users").option("-y, --yes", "Skip confirmation prompts").option("--name <name>", `Agent name (default: ${DEFAULT_AGENT_NAME})`).action(async (options) => {
   const interactive = isInteractive();
   if (interactive) {
+    process.stdout.write("\x1B[2J\x1B[H");
     console.log();
     renderOnboardWelcome();
     console.log();
   }
-  const progress = createOnboardProgress();
-  const updateProgress = (index, status) => {
-    progress.update(index, status);
-    if (interactive) {
-      console.clear();
-      renderOnboardWelcome();
-      console.log();
-      progress.render();
-      console.log();
-    }
-  };
-  if (interactive) {
-    progress.render();
-    console.log();
-  }
-  const ctx = { interactive, options, updateProgress };
+  const runner = createStepRunner({
+    interactive,
+    header: interactive ? renderOnboardWelcome : void 0
+  });
+  const ctx = { interactive, options, runner };
   await handleAuthentication(ctx);
   await handleModelProvider(ctx);
   const agentName = await handleAgentCreation(ctx);
   await handlePluginInstallation(ctx, agentName);
-  ctx.updateProgress(4, "completed");
+  await ctx.runner.finalStep("Completed", async () => {
+  });
   printNextSteps(agentName);
 });
 
@@ -11245,7 +11305,7 @@ var setupClaudeCommand = new Command57().name("setup-claude").description("Insta
 
 // src/index.ts
 var program = new Command58();
-program.name("vm0").description("VM0 CLI - Build and run agents with natural language").version("9.4.1");
+program.name("vm0").description("VM0 CLI - Build and run agents with natural language").version("9.5.1");
 program.addCommand(authCommand);
 program.addCommand(infoCommand);
 program.addCommand(composeCommand);