@vm0/cli 9.2.0 → 9.3.0

package/index.js

@@ -2,7 +2,7 @@
 
 // src/index.ts
 import { Command as Command48 } from "commander";
-import chalk48 from "chalk";
+import chalk50 from "chalk";
 
 // src/lib/api/auth.ts
 import chalk from "chalk";
@@ -1807,19 +1807,11 @@ var MODEL_PROVIDER_TYPES = {
     label: "Anthropic API Key",
     credentialLabel: "API key",
     helpText: "Get your API key at: https://console.anthropic.com/settings/keys"
-  },
-  "openai-api-key": {
-    framework: "codex",
-    credentialName: "OPENAI_API_KEY",
-    label: "OpenAI API Key",
-    credentialLabel: "API key",
-    helpText: "Get your API key at: https://platform.openai.com/api-keys"
   }
 };
 var modelProviderTypeSchema = z14.enum([
   "claude-code-oauth-token",
-  "anthropic-api-key",
-  "openai-api-key"
+  "anthropic-api-key"
 ]);
 var modelProviderFrameworkSchema = z14.enum(["claude-code", "codex"]);
 var modelProviderResponseSchema = z14.object({
@@ -2296,6 +2288,27 @@ var realtimeTokenContract = c14.router({
     summary: "Get Ably token for run event subscription"
   }
 });
+var runnerRealtimeTokenContract = c14.router({
+  /**
+   * POST /api/runners/realtime/token
+   * Get an Ably token to subscribe to a runner group's job notification channel
+   */
+  create: {
+    method: "POST",
+    path: "/api/runners/realtime/token",
+    headers: authHeadersSchema,
+    body: z17.object({
+      group: runnerGroupSchema
+    }),
+    responses: {
+      200: ablyTokenRequestSchema,
+      401: apiErrorSchema,
+      403: apiErrorSchema,
+      500: apiErrorSchema
+    },
+    summary: "Get Ably token for runner group job notifications"
+  }
+});
 
 // ../../packages/core/src/contracts/platform.ts
 import { z as z19 } from "zod";
@@ -3136,10 +3149,10 @@ async function getRawHeaders() {
   }
   return headers;
 }
-async function httpGet(path15) {
+async function httpGet(path16) {
   const baseUrl = await getBaseUrl();
   const headers = await getRawHeaders();
-  return fetch(`${baseUrl}${path15}`, {
+  return fetch(`${baseUrl}${path16}`, {
     method: "GET",
     headers
   });
@@ -3619,49 +3632,49 @@ var cliComposeSchema = z24.object({
 function formatZodError(error) {
   const issue = error.issues[0];
   if (!issue) return "Validation failed";
-  const path15 = issue.path.join(".");
+  const path16 = issue.path.join(".");
   const message = issue.message;
-  if (!path15) 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 (path15 === "version" && isMissing) {
+    if (path16 === "version" && isMissing) {
       return "Missing config.version";
     }
-    if (path15 === "agents" && isMissing) {
+    if (path16 === "agents" && isMissing) {
       return "Missing agents object in config";
     }
-    if (path15.startsWith("volumes.") && path15.endsWith(".name")) {
-      const volumeKey = path15.split(".")[1];
+    if (path16.startsWith("volumes.") && path16.endsWith(".name")) {
+      const volumeKey = path16.split(".")[1];
       return `Volume "${volumeKey}" must have a 'name' field (string)`;
     }
-    if (path15.startsWith("volumes.") && path15.endsWith(".version")) {
-      const volumeKey = path15.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 = path15.replace(/^agents\.[^.]+\./, "agent.");
+      const fieldName = path16.replace(/^agents\.[^.]+\./, "agent.");
       return `${fieldName} must be an array`;
     }
     if (issue.expected === "string" && received === "number") {
-      const fieldName = path15.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" && path15.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" && path15.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 (path15.startsWith("agents.")) {
-    const cleanPath = path15.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") {
@@ -3673,7 +3686,7 @@ function formatZodError(error) {
     }
     return `${cleanPath}: ${message}`;
   }
-  return `${path15}: ${message}`;
+  return `${path16}: ${message}`;
 }
 function validateAgentName(name) {
   return cliAgentNameSchema.safeParse(name).success;
@@ -5849,7 +5862,7 @@ var ApiClient = class {
   /**
    * Generic GET request
    */
-  async get(path15) {
+  async get(path16) {
     const baseUrl = await this.getBaseUrl();
     const token = await getToken();
     if (!token) {
@@ -5862,7 +5875,7 @@ var ApiClient = class {
     if (bypassSecret) {
       headers["x-vercel-protection-bypass"] = bypassSecret;
     }
-    return fetch(`${baseUrl}${path15}`, {
+    return fetch(`${baseUrl}${path16}`, {
       method: "GET",
       headers
     });
@@ -5870,7 +5883,7 @@ var ApiClient = class {
   /**
    * Generic POST request
    */
-  async post(path15, options) {
+  async post(path16, options) {
     const baseUrl = await this.getBaseUrl();
     const token = await getToken();
     if (!token) {
@@ -5886,7 +5899,7 @@ var ApiClient = class {
     if (bypassSecret) {
       headers["x-vercel-protection-bypass"] = bypassSecret;
     }
-    return fetch(`${baseUrl}${path15}`, {
+    return fetch(`${baseUrl}${path16}`, {
       method: "POST",
       headers,
       body: options?.body
@@ -5895,7 +5908,7 @@ var ApiClient = class {
   /**
    * Generic DELETE request
    */
-  async delete(path15) {
+  async delete(path16) {
     const baseUrl = await this.getBaseUrl();
     const token = await getToken();
     if (!token) {
@@ -5908,7 +5921,7 @@ var ApiClient = class {
     if (bypassSecret) {
       headers["x-vercel-protection-bypass"] = bypassSecret;
     }
-    return fetch(`${baseUrl}${path15}`, {
+    return fetch(`${baseUrl}${path16}`, {
       method: "DELETE",
       headers
     });
@@ -7730,7 +7743,7 @@ cookCmd.argument("[prompt]", "Prompt for the agent").option(
   // eslint-disable-next-line complexity -- TODO: refactor complex function
   async (prompt, options) => {
     if (!options.noAutoUpdate) {
-      const shouldExit = await checkAndUpgrade("9.2.0", prompt);
+      const shouldExit = await checkAndUpgrade("9.3.0", prompt);
       if (shouldExit) {
         process.exit(0);
       }
@@ -10446,18 +10459,708 @@ var setDefaultCommand = new Command44().name("set-default").description("Set a m
 var modelProviderCommand = new Command45().name("model-provider").description("Manage model providers for agent runs").addCommand(listCommand6).addCommand(setupCommand2).addCommand(deleteCommand3).addCommand(setDefaultCommand);
 
 // src/commands/onboard.ts
-import { Command as Command47 } from "commander";
-import chalk47 from "chalk";
-import prompts3 from "prompts";
+import { Command as Command46 } from "commander";
+import chalk48 from "chalk";
 import { mkdir as mkdir8 } from "fs/promises";
 import { existsSync as existsSync10 } from "fs";
 
-// src/commands/setup-claude.ts
-import { Command as Command46 } from "commander";
+// src/lib/ui/welcome-box.ts
 import chalk46 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(chalk46.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(chalk46.cyan("\u2502") + centeredLine + chalk46.cyan("\u2502"));
+  }
+  console.log(chalk46.cyan(bottomBorder));
+}
+function renderOnboardWelcome() {
+  renderWelcomeBox([
+    "",
+    "Welcome to VM0!",
+    "",
+    "Let's set up your first agent.",
+    ""
+  ]);
+}
+
+// src/lib/ui/progress-line.ts
+import chalk47 from "chalk";
+var STATUS_SYMBOLS = {
+  completed: "\u25CF",
+  "in-progress": "\u25D0",
+  pending: "\u25CB",
+  failed: "\u2717"
+};
+function getStatusColor(status) {
+  switch (status) {
+    case "completed":
+      return chalk47.green;
+    case "in-progress":
+      return chalk47.yellow;
+    case "failed":
+      return chalk47.red;
+    case "pending":
+    default:
+      return chalk47.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(chalk47.dim("\u2502"));
+    }
+  }
+}
+function createOnboardProgress() {
+  const steps = [
+    { label: "Authentication", status: "pending" },
+    { label: "Model Provider Setup", status: "pending" },
+    { label: "Create Agent", status: "pending" },
+    { label: "Complete", status: "pending" }
+  ];
+  return {
+    steps,
+    render: () => renderProgressLine(steps),
+    update: (index, status) => {
+      const step = steps[index];
+      if (step) {
+        step.status = status;
+      }
+    }
+  };
+}
+
+// src/lib/domain/onboard/auth.ts
+function buildHeaders2() {
+  const headers = {
+    "Content-Type": "application/json"
+  };
+  const bypassSecret = process.env.VERCEL_AUTOMATION_BYPASS_SECRET;
+  if (bypassSecret) {
+    headers["x-vercel-protection-bypass"] = bypassSecret;
+  }
+  return headers;
+}
+async function requestDeviceCode2(apiUrl) {
+  const response = await fetch(`${apiUrl}/api/cli/auth/device`, {
+    method: "POST",
+    headers: buildHeaders2(),
+    body: JSON.stringify({})
+  });
+  if (!response.ok) {
+    throw new Error(`Failed to request device code: ${response.statusText}`);
+  }
+  return response.json();
+}
+async function exchangeToken2(apiUrl, deviceCode) {
+  const response = await fetch(`${apiUrl}/api/cli/auth/token`, {
+    method: "POST",
+    headers: buildHeaders2(),
+    body: JSON.stringify({ device_code: deviceCode })
+  });
+  return response.json();
+}
+function delay2(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+async function isAuthenticated() {
+  const token = await getToken();
+  return !!token;
+}
+function handleTokenResult(tokenResult) {
+  if (tokenResult.access_token) {
+    return tokenResult.access_token;
+  }
+  if (tokenResult.error === "authorization_pending") {
+    return null;
+  }
+  if (tokenResult.error === "expired_token") {
+    throw new Error("The device code has expired. Please try again.");
+  }
+  if (tokenResult.error) {
+    throw new Error(
+      `Authentication failed: ${tokenResult.error_description ?? tokenResult.error}`
+    );
+  }
+  return null;
+}
+async function pollForToken(apiUrl, deviceAuth, callbacks) {
+  const startTime = Date.now();
+  const maxWaitTime = deviceAuth.expires_in * 1e3;
+  const pollInterval = (deviceAuth.interval || 5) * 1e3;
+  let isFirstPoll = true;
+  while (Date.now() - startTime < maxWaitTime) {
+    if (!isFirstPoll) {
+      await delay2(pollInterval);
+    }
+    isFirstPoll = false;
+    const tokenResult = await exchangeToken2(apiUrl, deviceAuth.device_code);
+    const accessToken = handleTokenResult(tokenResult);
+    if (accessToken) {
+      return accessToken;
+    }
+    callbacks?.onPolling?.();
+  }
+  throw new Error("Authentication timed out. Please try again.");
+}
+async function runAuthFlow(callbacks, apiUrl) {
+  const targetApiUrl = apiUrl ?? await getApiUrl();
+  callbacks?.onInitiating?.();
+  const deviceAuth = await requestDeviceCode2(targetApiUrl);
+  const verificationUrl = `${targetApiUrl}${deviceAuth.verification_path}`;
+  const expiresInMinutes = Math.floor(deviceAuth.expires_in / 60);
+  callbacks?.onDeviceCodeReady?.(
+    verificationUrl,
+    deviceAuth.user_code,
+    expiresInMinutes
+  );
+  try {
+    const accessToken = await pollForToken(targetApiUrl, deviceAuth, callbacks);
+    await saveConfig({
+      token: accessToken,
+      apiUrl: targetApiUrl
+    });
+    callbacks?.onSuccess?.();
+  } catch (error) {
+    callbacks?.onError?.(error);
+    throw error;
+  }
+}
+
+// src/lib/domain/onboard/model-provider.ts
+async function checkModelProviderStatus() {
+  const response = await listModelProviders();
+  return {
+    hasProvider: response.modelProviders.length > 0,
+    providers: response.modelProviders
+  };
+}
+function getProviderChoices() {
+  return Object.keys(MODEL_PROVIDER_TYPES).map(
+    (type) => ({
+      type,
+      label: MODEL_PROVIDER_TYPES[type].label,
+      helpText: MODEL_PROVIDER_TYPES[type].helpText,
+      credentialLabel: MODEL_PROVIDER_TYPES[type].credentialLabel
+    })
+  );
+}
+async function setupModelProvider(type, credential, options) {
+  const response = await upsertModelProvider({
+    type,
+    credential,
+    convert: options?.convert
+  });
+  return {
+    provider: response.provider,
+    created: response.created,
+    isDefault: response.provider.isDefault,
+    framework: response.provider.framework
+  };
+}
+
+// src/lib/domain/onboard/claude-setup.ts
 import { mkdir as mkdir7, writeFile as writeFile7 } from "fs/promises";
 import path14 from "path";
 var SKILL_DIR = ".claude/skills/vm0-agent-builder";
+var SKILL_FILE = "SKILL.md";
+function getSkillContent() {
+  return `---
+name: vm0-agent-builder
+description: Build VM0 agents by creating AGENTS.md and vm0.yaml. Use when users describe what agent they want to build.
+---
+
+# VM0 Agent Builder
+
+Build AI agents that run in VM0's secure sandbox environment. This skill helps you create the two essential files: \`AGENTS.md\` (agent instructions) and \`vm0.yaml\` (configuration).
+
+## Workflow
+
+### Step 1: Understand the Goal
+
+First, clarify what the user wants their agent to do:
+- What task should the agent accomplish?
+- What inputs does it need? (files, APIs, websites)
+- What outputs should it produce? (reports, files, notifications)
+- Should it run once or on a schedule?
+
+### Step 2: Create AGENTS.md
+
+Write clear, step-by-step instructions. The agent will follow these exactly.
+
+**Template:**
+
+\`\`\`markdown
+# [Agent Name]
+
+You are a [role description].
+
+## Workflow
+
+1. [First action - be specific]
+2. [Second action - include details]
+3. [Continue with clear steps...]
+
+## Output
+
+Write results to \`[filename]\` in the current directory.
+\`\`\`
+
+**Writing Tips:**
+- Be specific: "Read the top 10 stories" not "Read some stories"
+- One action per step: Keep steps focused and atomic
+- Specify output: Exact filenames and formats
+- Use active voice: "Create a file" not "A file should be created"
+
+### Step 3: Create vm0.yaml
+
+Configure the agent with required skills and environment variables.
+
+\`\`\`yaml
+version: "1.0"
+
+agents:
+  [agent-name]:
+    framework: claude-code
+    instructions: AGENTS.md
+    # Pre-install GitHub CLI (optional)
+    apps:
+      - github
+    # Add skills the agent needs (optional)
+    skills:
+      - https://github.com/vm0-ai/vm0-skills/tree/main/[skill-name]
+    # Mount volumes for input files (optional)
+    volumes:
+      - my-volume:/home/user/input
+    # Environment variables (optional)
+    environment:
+      API_KEY: "\${{ secrets.API_KEY }}"
+\`\`\`
+
+### Step 4: Test the Agent
+
+After creating both files, the user runs:
+
+\`\`\`bash
+vm0 cook "start working"
+\`\`\`
+
+This command:
+1. Uploads the configuration to VM0
+2. Runs the agent in a secure sandbox
+3. Downloads results to the \`artifact/\` directory
+
+## Available Skills
+
+Skills give agents access to external services. Add them to vm0.yaml when needed.
+
+**Popular Skills:**
+
+| Skill | Use Case |
+|-------|----------|
+| \`github\` | Read/write issues, PRs, files |
+| \`slack\` | Send messages to channels |
+| \`notion\` | Access Notion pages/databases |
+| \`firecrawl\` | Scrape and extract web content |
+| \`supabase\` | Database operations |
+| \`google-sheets\` | Read/write spreadsheets |
+| \`linear\` | Project management |
+| \`discord\` | Send Discord messages |
+| \`gmail\` | Send emails |
+| \`openai\` | Embeddings, additional AI calls |
+
+**All 79 skills:** https://github.com/vm0-ai/vm0-skills
+
+**Skill URL format:**
+\`\`\`
+https://github.com/vm0-ai/vm0-skills/tree/main/[skill-name]
+\`\`\`
+
+## Examples
+
+### HackerNews Curator
+
+**AGENTS.md:**
+\`\`\`markdown
+# HackerNews AI Curator
+
+You are a content curator that finds AI-related articles on HackerNews.
+
+## Workflow
+
+1. Go to https://news.ycombinator.com
+2. Read the top 30 stories
+3. Filter for AI, ML, and LLM related content
+4. For each relevant article, extract:
+   - Title and URL
+   - 2-3 sentence summary
+   - Why it matters
+5. Write findings to \`daily-digest.md\`
+
+## Output
+
+Create \`daily-digest.md\` with today's date as the header.
+Format as a bulleted list with links.
+\`\`\`
+
+**vm0.yaml:**
+\`\`\`yaml
+version: "1.0"
+
+agents:
+  hn-curator:
+    framework: claude-code
+    instructions: AGENTS.md
+\`\`\`
+
+### GitHub Issue Reporter
+
+**AGENTS.md:**
+\`\`\`markdown
+# GitHub Issue Reporter
+
+You are a GitHub analyst that creates issue summary reports.
+
+## Workflow
+
+1. List all open issues in the repository
+2. Group by labels: bug, feature, documentation, other
+3. For each group, report:
+   - Total count
+   - Oldest issue (with age in days)
+   - Most commented issue
+4. Write report to \`issue-report.md\`
+
+## Output
+
+Create \`issue-report.md\` with sections for each label group.
+Include links to referenced issues.
+\`\`\`
+
+**vm0.yaml:**
+\`\`\`yaml
+version: "1.0"
+
+agents:
+  issue-reporter:
+    framework: claude-code
+    instructions: AGENTS.md
+    skills:
+      - https://github.com/vm0-ai/vm0-skills/tree/main/github
+    environment:
+      GITHUB_REPO: "\${{ vars.GITHUB_REPO }}"
+\`\`\`
+
+### Slack Daily Digest
+
+**AGENTS.md:**
+\`\`\`markdown
+# Slack Daily Digest
+
+You are an assistant that posts daily summaries to Slack.
+
+## Workflow
+
+1. Read the contents of \`updates.md\` from the input volume
+2. Summarize the key points (max 5 bullets)
+3. Format as a Slack message with emoji headers
+4. Post to the #daily-updates channel
+
+## Output
+
+Post the summary to Slack. Write a copy to \`sent-message.md\`.
+\`\`\`
+
+**vm0.yaml:**
+\`\`\`yaml
+version: "1.0"
+
+agents:
+  slack-digest:
+    framework: claude-code
+    instructions: AGENTS.md
+    skills:
+      - https://github.com/vm0-ai/vm0-skills/tree/main/slack
+    environment:
+      SLACK_CHANNEL: "\${{ vars.SLACK_CHANNEL }}"
+\`\`\`
+
+## Environment Variables
+
+Use environment variables for sensitive data and configuration:
+
+\`\`\`yaml
+environment:
+  # Secrets (encrypted, for API keys)
+  API_KEY: "\${{ secrets.API_KEY }}"
+
+  # Variables (plain text, for config)
+  REPO_NAME: "\${{ vars.REPO_NAME }}"
+
+  # Credentials (from vm0 credential storage)
+  MY_TOKEN: "\${{ credentials.MY_TOKEN }}"
+\`\`\`
+
+Set credentials with (names must be UPPERCASE):
+\`\`\`bash
+vm0 credential set API_KEY "your-api-key"
+\`\`\`
+
+## Troubleshooting
+
+**Agent doesn't follow instructions:**
+- Make steps more specific and explicit
+- Add "Do not..." constraints for unwanted behavior
+- Break complex steps into smaller sub-steps
+
+**Agent can't access a service:**
+- Add the required skill to vm0.yaml
+- Set up credentials with \`vm0 credential set\`
+
+**Output is in wrong format:**
+- Provide an exact template in the instructions
+- Include a small example of expected output
+
+## Next Steps After Creating Files
+
+\`\`\`bash
+# Run your agent
+vm0 cook "start working"
+
+# View logs if needed
+vm0 logs [run-id]
+
+# Results are in artifact/ directory
+ls artifact/
+
+# Continue from where agent left off
+vm0 cook continue "keep going"
+
+# Resume from a checkpoint
+vm0 cook resume "try again"
+\`\`\`
+`;
+}
+async function installClaudeSkill(targetDir = process.cwd()) {
+  const skillDirPath = path14.join(targetDir, SKILL_DIR);
+  const skillFilePath = path14.join(skillDirPath, SKILL_FILE);
+  await mkdir7(skillDirPath, { recursive: true });
+  await writeFile7(skillFilePath, getSkillContent());
+  return {
+    skillDir: skillDirPath,
+    skillFile: skillFilePath
+  };
+}
+
+// src/commands/onboard.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(chalk48.red("Error: Not authenticated"));
+    console.error("Run 'vm0 auth login' first or set VM0_TOKEN");
+    process.exit(1);
+  }
+  console.log(chalk48.dim("Authentication required..."));
+  console.log();
+  await runAuthFlow({
+    onInitiating: () => {
+      console.log("Initiating authentication...");
+    },
+    onDeviceCodeReady: (url, code, expiresIn) => {
+      console.log(chalk48.green("\nDevice code generated"));
+      console.log(chalk48.cyan(`
+To authenticate, visit: ${url}`));
+      console.log(`And enter this code: ${chalk48.bold(code)}`);
+      console.log(`
+The code expires in ${expiresIn} minutes.`);
+      console.log("\nWaiting for authentication...");
+    },
+    onPolling: () => {
+      process.stdout.write(chalk48.dim("."));
+    },
+    onSuccess: () => {
+      console.log(chalk48.green("\nAuthentication successful!"));
+      console.log("Your credentials have been saved.");
+    },
+    onError: (error) => {
+      console.error(chalk48.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(chalk48.red("Error: No model provider configured"));
+    console.error("Run 'vm0 model-provider setup' first");
+    process.exit(1);
+  }
+  console.log(chalk48.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(chalk48.dim(selectedChoice.helpText));
+    console.log();
+  }
+  const credential = await promptPassword(
+    `Enter your ${selectedChoice?.credentialLabel ?? "credential"}:`
+  );
+  if (!credential) {
+    console.log(chalk48.dim("Cancelled"));
+    process.exit(0);
+  }
+  const result = await setupModelProvider(providerType, credential);
+  console.log(
+    chalk48.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;
+      }
+    );
+    if (!inputName) {
+      process.exit(0);
+    }
+    agentName = inputName;
+  }
+  if (!validateAgentName(agentName)) {
+    console.error(
+      chalk48.red(
+        "Invalid agent name: must be 3-64 chars, alphanumeric + hyphens"
+      )
+    );
+    process.exit(1);
+  }
+  if (existsSync10(agentName)) {
+    console.error(chalk48.red(`
+\u2717 ${agentName}/ already exists`));
+    console.log();
+    console.log("Remove it first or choose a different name:");
+    console.log(chalk48.cyan(`  rm -rf ${agentName}`));
+    process.exit(1);
+  }
+  if (!ctx.options.yes && ctx.interactive) {
+    const confirmed = await promptConfirm(`Create ${agentName}/?`, true);
+    if (!confirmed) {
+      console.log(chalk48.dim("Cancelled"));
+      process.exit(0);
+    }
+  }
+  await mkdir8(agentName, { recursive: true });
+  console.log(chalk48.green(`\u2713 Created ${agentName}/`));
+  ctx.updateProgress(2, "completed");
+  return agentName;
+}
+async function handleSkillInstallation(ctx, agentName) {
+  ctx.updateProgress(3, "in-progress");
+  const skillResult = await installClaudeSkill(agentName);
+  console.log(
+    chalk48.green(
+      `\u2713 Installed vm0-agent-builder skill to ${skillResult.skillDir}`
+    )
+  );
+  ctx.updateProgress(3, "completed");
+}
+function printNextSteps(agentName) {
+  console.log();
+  console.log(chalk48.bold("Next step:"));
+  console.log();
+  console.log(
+    `  ${chalk48.cyan(`cd ${agentName} && claude "/vm0-agent-builder I want to build an agent that..."`)}`
+  );
+  console.log();
+}
+var onboardCommand = new Command46().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) {
+    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 };
+  await handleAuthentication(ctx);
+  await handleModelProvider(ctx);
+  const agentName = await handleAgentCreation(ctx);
+  await handleSkillInstallation(ctx, agentName);
+  printNextSteps(agentName);
+});
+
+// src/commands/setup-claude.ts
+import { Command as Command47 } from "commander";
+import chalk49 from "chalk";
+import { mkdir as mkdir9, writeFile as writeFile8 } from "fs/promises";
+import path15 from "path";
+var SKILL_DIR2 = ".claude/skills/vm0-agent-builder";
 var SKILL_CONTENT = `---
 name: vm0-agent-builder
 description: Guide for building VM0 agents with Claude's help. Use this skill when users want to create or improve their agent's AGENTS.md and vm0.yaml configuration.
@@ -10665,132 +11368,31 @@ Write results to the artifact directory.
 - Provide exact templates for output files
 - Include example output in the instructions
 `;
-var setupClaudeCommand = new Command46().name("setup-claude").description("Add/update Claude skill for agent building").action(async () => {
-  console.log(chalk46.dim("Installing vm0-agent-builder skill..."));
-  await mkdir7(SKILL_DIR, { recursive: true });
-  await writeFile7(path14.join(SKILL_DIR, "SKILL.md"), SKILL_CONTENT);
+var setupClaudeCommand = new Command47().name("setup-claude").description("Add/update Claude skill for agent building").option(
+  "--agent-dir <dir>",
+  "Agent directory (shown in next step instructions)"
+).action(async (options) => {
+  console.log(chalk49.dim("Installing vm0-agent-builder skill..."));
+  await mkdir9(SKILL_DIR2, { recursive: true });
+  await writeFile8(path15.join(SKILL_DIR2, "SKILL.md"), SKILL_CONTENT);
   console.log(
-    chalk46.green(`Done Installed vm0-agent-builder skill to ${SKILL_DIR}`)
+    chalk49.green(`Done Installed vm0-agent-builder skill to ${SKILL_DIR2}`)
   );
   console.log();
   console.log("Next step:");
+  const cdPrefix = options.agentDir ? `cd ${options.agentDir} && ` : "";
   console.log(
-    chalk46.cyan(
-      '  claude /vm0-agent-builder "I want to build an agent that..."'
+    chalk49.cyan(
+      `  ${cdPrefix}claude "/vm0-agent-builder I want to build an agent that..."`
     )
   );
 });
 
-// src/commands/onboard.ts
-var DEMO_AGENT_DIR = "vm0-demo-agent";
-var DEMO_AGENT_NAME = "vm0-demo-agent";
-var onboardCommand = new Command47().name("onboard").description("Guided setup for new VM0 users").option("-y, --yes", "Skip confirmation prompts").option(
-  "--method <method>",
-  "Agent building method: claude or manual",
-  void 0
-).action(async (options) => {
-  const token = await getToken();
-  if (token) {
-    console.log(chalk47.green("Done Authenticated"));
-  } else {
-    console.log(chalk47.dim("Authentication required..."));
-    console.log();
-    await loginCommand.parseAsync([], { from: "user" });
-  }
-  try {
-    const result = await listModelProviders();
-    if (result.modelProviders.length > 0) {
-      console.log(chalk47.green("Done Model provider configured"));
-    } else {
-      console.log(chalk47.dim("Model provider setup required..."));
-      console.log();
-      await setupCommand2.parseAsync([], { from: "user" });
-    }
-  } catch {
-    console.log(chalk47.dim("Setting up model provider..."));
-    console.log();
-    await setupCommand2.parseAsync([], { from: "user" });
-  }
-  let createAgent = options.yes;
-  if (!createAgent && isInteractive()) {
-    const response = await prompts3(
-      {
-        type: "confirm",
-        name: "create",
-        message: `Create ${DEMO_AGENT_DIR}?`,
-        initial: true
-      },
-      { onCancel: () => process.exit(0) }
-    );
-    createAgent = response.create;
-  }
-  if (!createAgent) {
-    console.log(chalk47.dim("Skipped agent creation"));
-    return;
-  }
-  if (existsSync10(DEMO_AGENT_DIR)) {
-    console.log(chalk47.red(`x ${DEMO_AGENT_DIR}/ already exists`));
-    console.log();
-    console.log("Remove it first or use a different directory:");
-    console.log(chalk47.cyan(`  rm -rf ${DEMO_AGENT_DIR}`));
-    process.exit(1);
-  }
-  await mkdir8(DEMO_AGENT_DIR, { recursive: true });
-  const originalDir = process.cwd();
-  process.chdir(DEMO_AGENT_DIR);
-  try {
-    await initCommand3.parseAsync(["--name", DEMO_AGENT_NAME], {
-      from: "user"
-    });
-  } finally {
-    process.chdir(originalDir);
-  }
-  console.log();
-  let method = options.method;
-  if (!method && isInteractive()) {
-    const response = await prompts3(
-      {
-        type: "select",
-        name: "method",
-        message: "How would you like to build your agent?",
-        choices: [
-          {
-            title: "Use `vm0 setup-claude` to let Claude help (Recommended)",
-            value: "claude"
-          },
-          {
-            title: "I will do it myself (Edit `AGENTS.md` and `vm0.yaml`)",
-            value: "manual"
-          }
-        ]
-      },
-      { onCancel: () => process.exit(0) }
-    );
-    method = response.method;
-  }
-  if (method === "claude") {
-    process.chdir(DEMO_AGENT_DIR);
-    try {
-      await setupClaudeCommand.parseAsync([], { from: "user" });
-    } finally {
-      process.chdir(originalDir);
-    }
-  } else {
-    console.log("Next steps:");
-    console.log(`  1. ${chalk47.cyan(`cd ${DEMO_AGENT_DIR}`)}`);
-    console.log(
-      `  2. Edit ${chalk47.cyan("AGENTS.md")} to define your agent's workflow`
-    );
-    console.log(`  3. Edit ${chalk47.cyan("vm0.yaml")} to configure skills`);
-    console.log(`  4. Run ${chalk47.cyan('vm0 cook "start working"')} to test`);
-  }
-});
-
 // src/index.ts
 var program = new Command48();
-program.name("vm0").description("VM0 CLI - Build and run agents with natural language").version("9.2.0");
+program.name("vm0").description("VM0 CLI - Build and run agents with natural language").version("9.3.0");
 program.command("info").description("Display environment information").action(async () => {
-  console.log(chalk48.bold("System Information:"));
+  console.log(chalk50.bold("System Information:"));
   console.log(`Node Version: ${process.version}`);
   console.log(`Platform: ${process.platform}`);
   console.log(`Architecture: ${process.arch}`);

package/package.json

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