@vm0/cli 9.4.1 → 9.5.0

package/index.js

@@ -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}`));
@@ -7960,135 +7983,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 +8076,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.0", 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:");
@@ -10710,82 +10748,106 @@ 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("#FF9650"),
+  // Line 1 - lightest
+  chalk53.hex("#FF7832"),
+  // Line 2
+  chalk53.hex("#FF7832"),
+  // Line 3
+  chalk53.hex("#ED4E01"),
+  // Line 4 - brand orange
+  chalk53.hex("#ED4E01"),
+  // Line 5
+  chalk53.hex("#C83C00")
+  // 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("Let's create your first agent.")}`);
+  console.log();
 }
 
 // src/lib/ui/progress-line.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 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"));
+function createProgressiveProgress(interactive = true) {
+  let currentLabel = "";
+  let detailLineCount = 0;
+  let isFinalStep = false;
+  const clearDetails = () => {
+    if (!interactive || detailLineCount === 0) return;
+    process.stdout.write(`\x1B[${detailLineCount + 1}A`);
+    process.stdout.write(`\x1B[K`);
+  };
+  const clearDetailLines = () => {
+    if (!interactive) return;
+    for (let i = 0; i < detailLineCount; i++) {
+      process.stdout.write(`
+\x1B[K`);
     }
-  }
-}
-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" }
-  ];
+    if (detailLineCount > 0) {
+      process.stdout.write(`\x1B[${detailLineCount}A`);
+    }
+  };
   return {
-    steps,
-    render: () => renderProgressLine(steps),
-    update: (index, status) => {
-      const step = steps[index];
-      if (step) {
-        step.status = status;
+    startStep: (label) => {
+      currentLabel = label;
+      detailLineCount = 0;
+      isFinalStep = false;
+      console.log(chalk54.yellow(`\u25CB ${label}`));
+    },
+    detail: (message) => {
+      console.log(chalk54.dim(`\u2502 ${message}`));
+      detailLineCount++;
+    },
+    completeStep: () => {
+      if (interactive && detailLineCount > 0) {
+        clearDetails();
+      } else if (interactive) {
+        process.stdout.write(`\x1B[1A\x1B[K`);
+      }
+      console.log(chalk54.green(`\u25CF ${currentLabel}`));
+      if (interactive && detailLineCount > 0) {
+        clearDetailLines();
       }
+      if (!isFinalStep) {
+        console.log(chalk54.dim("\u2502"));
+      }
+      currentLabel = "";
+      detailLineCount = 0;
+    },
+    failStep: () => {
+      if (interactive && detailLineCount > 0) {
+        clearDetails();
+      } else if (interactive) {
+        process.stdout.write(`\x1B[1A\x1B[K`);
+      }
+      console.log(chalk54.red(`\u2717 ${currentLabel}`));
+      if (interactive && detailLineCount > 0) {
+        clearDetailLines();
+      }
+      currentLabel = "";
+      detailLineCount = 0;
+    },
+    setFinalStep: () => {
+      isFinalStep = true;
     }
   };
 }
@@ -11022,61 +11084,54 @@ 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");
+  ctx.progress.startStep("Authentication");
   const authenticated = await isAuthenticated();
   if (authenticated) {
-    ctx.updateProgress(0, "completed");
+    ctx.progress.completeStep();
     return;
   }
   if (!ctx.interactive) {
+    ctx.progress.failStep();
     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...");
+      ctx.progress.detail(`Visit: ${url}`);
+      ctx.progress.detail(`Code: ${code}`);
+      ctx.progress.detail(`Expires in ${expiresIn} minutes`);
+      ctx.progress.detail("Waiting for confirmation...");
     },
     onPolling: () => {
-      process.stdout.write(chalk56.dim("."));
     },
     onSuccess: () => {
-      console.log(chalk56.green("\nAuthentication successful!"));
-      console.log("Your credentials have been saved.");
     },
     onError: (error) => {
+      ctx.progress.failStep();
       console.error(chalk56.red(`
 ${error.message}`));
       process.exit(1);
     }
   });
-  ctx.updateProgress(0, "completed");
+  ctx.progress.completeStep();
 }
 async function handleModelProvider(ctx) {
-  ctx.updateProgress(1, "in-progress");
+  ctx.progress.startStep("Model Provider Setup");
   const providerStatus = await checkModelProviderStatus();
   if (providerStatus.hasProvider) {
-    ctx.updateProgress(1, "completed");
+    ctx.progress.completeStep();
     return;
   }
   if (!ctx.interactive) {
+    ctx.progress.failStep();
     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();
+  ctx.progress.detail("Setup required...");
   const choices = getProviderChoices();
   const providerType = await promptSelect(
     "Select provider type:",
@@ -11090,11 +11145,6 @@ async function handleModelProvider(ctx) {
     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"}:`
   );
@@ -11103,16 +11153,13 @@ async function handleModelProvider(ctx) {
     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.progress.detail(
+    `${providerType} ${result.created ? "created" : "updated"}${result.isDefault ? ` (default for ${result.framework})` : ""}`
   );
-  ctx.updateProgress(1, "completed");
+  ctx.progress.completeStep();
 }
 async function handleAgentCreation(ctx) {
-  ctx.updateProgress(2, "in-progress");
+  ctx.progress.startStep("Create Agent");
   let agentName = ctx.options.name ?? DEFAULT_AGENT_NAME;
   if (!ctx.options.yes && !ctx.options.name && ctx.interactive) {
     const inputName = await promptText(
@@ -11131,6 +11178,7 @@ async function handleAgentCreation(ctx) {
     agentName = inputName;
   }
   if (!validateAgentName(agentName)) {
+    ctx.progress.failStep();
     console.error(
       chalk56.red(
         "Invalid agent name: must be 3-64 chars, alphanumeric + hyphens"
@@ -11139,20 +11187,20 @@ async function handleAgentCreation(ctx) {
     process.exit(1);
   }
   if (existsSync11(agentName)) {
-    console.error(chalk56.red(`
-\u2717 ${agentName}/ already exists`));
+    ctx.progress.failStep();
+    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 });
-  console.log(chalk56.green(`\u2713 Created ${agentName}/`));
-  ctx.updateProgress(2, "completed");
+  ctx.progress.detail(`Created ${agentName}/`);
+  ctx.progress.completeStep();
   return agentName;
 }
 async function handlePluginInstallation(ctx, agentName) {
-  ctx.updateProgress(3, "in-progress");
+  ctx.progress.startStep("Claude Plugin Install");
   let shouldInstall = true;
   if (!ctx.options.yes && ctx.interactive) {
     const confirmed = await promptConfirm(
@@ -11163,21 +11211,21 @@ async function handlePluginInstallation(ctx, agentName) {
     shouldInstall = confirmed ?? true;
   }
   if (!shouldInstall) {
-    console.log(chalk56.dim("Skipped plugin installation"));
-    ctx.updateProgress(3, "completed");
+    ctx.progress.detail("Skipped");
+    ctx.progress.completeStep();
     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})`)
+    ctx.progress.detail(
+      `Installed ${result.pluginId} (scope: ${result.scope})`
     );
   } catch (error) {
     handlePluginError(error);
   }
-  ctx.updateProgress(3, "completed");
+  ctx.progress.completeStep();
 }
 function printNextSteps(agentName) {
   console.log();
@@ -11195,27 +11243,15 @@ var onboardCommand = new Command56().name("onboard").description("Guided setup f
     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 progress = createProgressiveProgress(interactive);
+  const ctx = { interactive, options, progress };
   await handleAuthentication(ctx);
   await handleModelProvider(ctx);
   const agentName = await handleAgentCreation(ctx);
   await handlePluginInstallation(ctx, agentName);
-  ctx.updateProgress(4, "completed");
+  progress.startStep("Complete");
+  progress.setFinalStep();
+  progress.completeStep();
   printNextSteps(agentName);
 });
 
@@ -11245,7 +11281,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.0");
 program.addCommand(authCommand);
 program.addCommand(infoCommand);
 program.addCommand(composeCommand);

package/package.json

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