@vm0/cli 1.4.0 → 1.6.0

package/index.js

@@ -736,15 +736,15 @@ function mergeDefs(...defs) {
 function cloneDef(schema) {
   return mergeDefs(schema._zod.def);
 }
-function getElementAtPath(obj, path5) {
-  if (!path5)
+function getElementAtPath(obj, path8) {
+  if (!path8)
     return obj;
-  return path5.reduce((acc, key) => acc?.[key], obj);
+  return path8.reduce((acc, key) => acc?.[key], obj);
 }
 function promiseAllObject(promisesObj) {
   const keys = Object.keys(promisesObj);
-  const promises3 = keys.map((key) => promisesObj[key]);
-  return Promise.all(promises3).then((results) => {
+  const promises5 = keys.map((key) => promisesObj[key]);
+  return Promise.all(promises5).then((results) => {
     const resolvedObj = {};
     for (let i = 0; i < keys.length; i++) {
       resolvedObj[keys[i]] = results[i];
@@ -1098,11 +1098,11 @@ function aborted(x, startIndex = 0) {
   }
   return false;
 }
-function prefixIssues(path5, issues) {
+function prefixIssues(path8, issues) {
   return issues.map((iss) => {
     var _a;
     (_a = iss).path ?? (_a.path = []);
-    iss.path.unshift(path5);
+    iss.path.unshift(path8);
     return iss;
   });
 }
@@ -1270,7 +1270,7 @@ function treeifyError(error43, _mapper) {
     return issue2.message;
   };
   const result = { errors: [] };
-  const processError = (error44, path5 = []) => {
+  const processError = (error44, path8 = []) => {
     var _a, _b;
     for (const issue2 of error44.issues) {
       if (issue2.code === "invalid_union" && issue2.errors.length) {
@@ -1280,7 +1280,7 @@ function treeifyError(error43, _mapper) {
       } else if (issue2.code === "invalid_element") {
         processError({ issues: issue2.issues }, issue2.path);
       } else {
-        const fullpath = [...path5, ...issue2.path];
+        const fullpath = [...path8, ...issue2.path];
         if (fullpath.length === 0) {
           result.errors.push(mapper(issue2));
           continue;
@@ -1312,8 +1312,8 @@ function treeifyError(error43, _mapper) {
 }
 function toDotPath(_path) {
   const segs = [];
-  const path5 = _path.map((seg) => typeof seg === "object" ? seg.key : seg);
-  for (const seg of path5) {
+  const path8 = _path.map((seg) => typeof seg === "object" ? seg.key : seg);
+  for (const seg of path8) {
     if (typeof seg === "number")
       segs.push(`[${seg}]`);
     else if (typeof seg === "symbol")
@@ -12147,8 +12147,8 @@ var helloContract = c.router({
 var FOO = "hello";
 
 // src/index.ts
-import { Command as Command7 } from "commander";
-import chalk8 from "chalk";
+import { Command as Command11 } from "commander";
+import chalk11 from "chalk";
 
 // src/lib/auth.ts
 import chalk from "chalk";
@@ -12416,7 +12416,7 @@ var ApiClient = class {
   /**
    * Generic GET request
    */
-  async get(path5) {
+  async get(path8) {
     const baseUrl = await this.getBaseUrl();
     const token = await getToken();
     if (!token) {
@@ -12429,7 +12429,7 @@ var ApiClient = class {
     if (bypassSecret) {
       headers["x-vercel-protection-bypass"] = bypassSecret;
     }
-    return fetch(`${baseUrl}${path5}`, {
+    return fetch(`${baseUrl}${path8}`, {
       method: "GET",
       headers
     });
@@ -12437,7 +12437,7 @@ var ApiClient = class {
   /**
    * Generic POST request
    */
-  async post(path5, options) {
+  async post(path8, options) {
     const baseUrl = await this.getBaseUrl();
     const token = await getToken();
     if (!token) {
@@ -12450,7 +12450,7 @@ var ApiClient = class {
     if (bypassSecret) {
       headers["x-vercel-protection-bypass"] = bypassSecret;
     }
-    return fetch(`${baseUrl}${path5}`, {
+    return fetch(`${baseUrl}${path8}`, {
       method: "POST",
       headers,
       body: options?.body
@@ -12821,9 +12821,7 @@ var EventRenderer = class {
     if (input && typeof input === "object") {
       for (const [key, value] of Object.entries(input)) {
         if (value !== void 0 && value !== null) {
-          const valueStr = String(value);
-          const displayValue = valueStr.length > 100 ? valueStr.substring(0, 100) + "..." : valueStr;
-          console.log(`  ${key}: ${chalk3.gray(displayValue)}`);
+          console.log(`  ${key}: ${chalk3.gray(String(value))}`);
         }
       }
     }
@@ -12834,8 +12832,7 @@ var EventRenderer = class {
     const color = isError ? chalk3.red : chalk3.green;
     console.log(color("[tool_result]") + " " + status);
     const result = String(event.data.result || "");
-    const displayResult = result.length > 200 ? result.substring(0, 200) + "..." : result;
-    console.log(`  ${chalk3.gray(displayResult)}`);
+    console.log(`  ${chalk3.gray(result)}`);
   }
   static renderResult(event) {
     const success2 = Boolean(event.data.success);
@@ -12872,8 +12869,7 @@ var EventRenderer = class {
       console.log(`  Run ID: ${chalk3.gray(String(event.data.runId))}`);
     }
     const prompt = String(event.data.prompt || "");
-    const displayPrompt = prompt.length > 100 ? prompt.substring(0, 100) + "..." : prompt;
-    console.log(`  Prompt: ${chalk3.gray(displayPrompt)}`);
+    console.log(`  Prompt: ${chalk3.gray(prompt)}`);
     if (event.data.agentName) {
       console.log(`  Agent: ${chalk3.gray(String(event.data.agentName))}`);
     }
@@ -12920,18 +12916,20 @@ function collectEnvVars(value, previous) {
 function isUUID(str) {
   return /^[0-9a-f-]{36}$/i.test(str);
 }
-async function pollEvents(runId) {
+var DEFAULT_TIMEOUT_SECONDS = 60;
+async function pollEvents(runId, timeoutSeconds) {
   let nextSequence = -1;
   let complete = false;
   const pollIntervalMs = 500;
-  const timeoutMs = 3 * 60 * 1e3;
+  const timeoutMs = timeoutSeconds * 1e3;
   const startTime = Date.now();
   while (!complete) {
     const elapsed = Date.now() - startTime;
     if (elapsed > timeoutMs) {
       console.error(
         chalk4.red(
-          "\n\u2717 Agent execution timed out after 3 minutes without receiving events"
+          `
+\u2717 Agent execution timed out after ${timeoutSeconds} seconds without receiving events`
         )
       );
       throw new Error("Agent execution timed out");
@@ -12964,8 +12962,22 @@ var runCmd = new Command2().name("run").description("Execute an agent").argument
   "Environment variables (repeatable)",
   collectEnvVars,
   {}
+).option(
+  "-a, --artifact <key>",
+  "Artifact key to mount (for VM0 driver artifacts)"
+).option(
+  "-t, --timeout <seconds>",
+  "Polling timeout in seconds (default: 60)",
+  String(DEFAULT_TIMEOUT_SECONDS)
 ).action(
   async (identifier, prompt, options) => {
+    const timeoutSeconds = parseInt(options.timeout, 10);
+    if (isNaN(timeoutSeconds) || timeoutSeconds <= 0) {
+      console.error(
+        chalk4.red("\u2717 Invalid timeout value. Must be a positive number.")
+      );
+      process.exit(1);
+    }
     try {
       let configId;
       if (isUUID(identifier)) {
@@ -12996,15 +13008,19 @@ var runCmd = new Command2().name("run").description("Execute an agent").argument
           chalk4.gray(`  Variables: ${JSON.stringify(options.env)}`)
         );
       }
+      if (options.artifact) {
+        console.log(chalk4.gray(`  Artifact: ${options.artifact}`));
+      }
       console.log();
       console.log(chalk4.blue("Executing in sandbox..."));
       console.log();
       const response = await apiClient.createRun({
         agentConfigId: configId,
         prompt,
-        dynamicVars: Object.keys(options.env).length > 0 ? options.env : void 0
+        dynamicVars: Object.keys(options.env).length > 0 ? options.env : void 0,
+        artifactKey: options.artifact
       });
-      await pollEvents(response.runId);
+      await pollEvents(response.runId, timeoutSeconds);
     } catch (error43) {
       if (error43 instanceof Error) {
         if (error43.message.includes("Not authenticated")) {
@@ -13027,42 +13043,57 @@ var runCmd = new Command2().name("run").description("Execute an agent").argument
     }
   }
 );
-runCmd.command("resume").description("Resume an agent run from a checkpoint").argument("<checkpointId>", "Checkpoint ID to resume from").argument("<prompt>", "Prompt for the resumed agent").action(async (checkpointId, prompt) => {
-  try {
-    if (!isUUID(checkpointId)) {
+runCmd.command("resume").description("Resume an agent run from a checkpoint").argument("<checkpointId>", "Checkpoint ID to resume from").argument("<prompt>", "Prompt for the resumed agent").option(
+  "-t, --timeout <seconds>",
+  "Polling timeout in seconds (default: 60)",
+  String(DEFAULT_TIMEOUT_SECONDS)
+).action(
+  async (checkpointId, prompt, options) => {
+    const timeoutSeconds = parseInt(options.timeout, 10);
+    if (isNaN(timeoutSeconds) || timeoutSeconds <= 0) {
       console.error(
-        chalk4.red(`\u2717 Invalid checkpoint ID format: ${checkpointId}`)
+        chalk4.red("\u2717 Invalid timeout value. Must be a positive number.")
       );
-      console.error(chalk4.gray("  Checkpoint ID must be a valid UUID"));
       process.exit(1);
     }
-    console.log(chalk4.blue("\nResuming agent run from checkpoint..."));
-    console.log(chalk4.gray(`  Checkpoint ID: ${checkpointId}`));
-    console.log(chalk4.gray(`  Prompt: ${prompt}`));
-    console.log();
-    console.log(chalk4.blue("Executing in sandbox..."));
-    console.log();
-    const response = await apiClient.resumeRun({
-      checkpointId,
-      prompt
-    });
-    await pollEvents(response.runId);
-  } catch (error43) {
-    if (error43 instanceof Error) {
-      if (error43.message.includes("Not authenticated")) {
-        console.error(chalk4.red("\u2717 Not authenticated. Run: vm0 auth login"));
-      } else if (error43.message.includes("not found")) {
-        console.error(chalk4.red(`\u2717 Checkpoint not found: ${checkpointId}`));
+    try {
+      if (!isUUID(checkpointId)) {
+        console.error(
+          chalk4.red(`\u2717 Invalid checkpoint ID format: ${checkpointId}`)
+        );
+        console.error(chalk4.gray("  Checkpoint ID must be a valid UUID"));
+        process.exit(1);
+      }
+      console.log(chalk4.blue("\nResuming agent run from checkpoint..."));
+      console.log(chalk4.gray(`  Checkpoint ID: ${checkpointId}`));
+      console.log(chalk4.gray(`  Prompt: ${prompt}`));
+      console.log();
+      console.log(chalk4.blue("Executing in sandbox..."));
+      console.log();
+      const response = await apiClient.resumeRun({
+        checkpointId,
+        prompt
+      });
+      await pollEvents(response.runId, timeoutSeconds);
+    } catch (error43) {
+      if (error43 instanceof Error) {
+        if (error43.message.includes("Not authenticated")) {
+          console.error(
+            chalk4.red("\u2717 Not authenticated. Run: vm0 auth login")
+          );
+        } else if (error43.message.includes("not found")) {
+          console.error(chalk4.red(`\u2717 Checkpoint not found: ${checkpointId}`));
+        } else {
+          console.error(chalk4.red("\u2717 Resume failed"));
+          console.error(chalk4.gray(`  ${error43.message}`));
+        }
       } else {
-        console.error(chalk4.red("\u2717 Resume failed"));
-        console.error(chalk4.gray(`  ${error43.message}`));
+        console.error(chalk4.red("\u2717 An unexpected error occurred"));
       }
-    } else {
-      console.error(chalk4.red("\u2717 An unexpected error occurred"));
+      process.exit(1);
     }
-    process.exit(1);
   }
-});
+);
 var runCommand = runCmd;
 
 // src/commands/volume/index.ts
@@ -13073,37 +13104,48 @@ import { Command as Command3 } from "commander";
 import chalk5 from "chalk";
 import path2 from "path";
 
-// src/lib/volume-utils.ts
+// src/lib/storage-utils.ts
 import { readFile as readFile3, writeFile as writeFile2, mkdir as mkdir2 } from "fs/promises";
 import { existsSync as existsSync3 } from "fs";
 import { parse as parseYaml2, stringify as stringifyYaml } from "yaml";
 import path from "path";
 var CONFIG_DIR2 = ".vm0";
-var CONFIG_FILE2 = "volume.yaml";
-function isValidVolumeName(name) {
+var CONFIG_FILE2 = "storage.yaml";
+function isValidStorageName(name) {
   if (name.length < 3 || name.length > 64) {
     return false;
   }
   const pattern = /^[a-z0-9][a-z0-9-]{1,62}[a-z0-9]$/;
   return pattern.test(name) && !name.includes("--");
 }
-async function readVolumeConfig(basePath = process.cwd()) {
+async function readStorageConfig(basePath = process.cwd()) {
   const configPath = path.join(basePath, CONFIG_DIR2, CONFIG_FILE2);
-  if (!existsSync3(configPath)) {
+  const legacyConfigPath = path.join(basePath, CONFIG_DIR2, "volume.yaml");
+  let actualPath = null;
+  if (existsSync3(configPath)) {
+    actualPath = configPath;
+  } else if (existsSync3(legacyConfigPath)) {
+    actualPath = legacyConfigPath;
+  }
+  if (!actualPath) {
     return null;
   }
-  const content = await readFile3(configPath, "utf8");
+  const content = await readFile3(actualPath, "utf8");
   const config2 = parseYaml2(content);
+  if (!config2.type) {
+    config2.type = "volume";
+  }
   return config2;
 }
-async function writeVolumeConfig(volumeName, basePath = process.cwd()) {
+async function writeStorageConfig(storageName, basePath = process.cwd(), type = "volume") {
   const configDir = path.join(basePath, CONFIG_DIR2);
   const configPath = path.join(configDir, CONFIG_FILE2);
   if (!existsSync3(configDir)) {
     await mkdir2(configDir, { recursive: true });
   }
   const config2 = {
-    name: volumeName
+    name: storageName,
+    type
   };
   const yamlContent = stringifyYaml(config2);
   await writeFile2(configPath, yamlContent, "utf8");
@@ -13114,18 +13156,18 @@ var initCommand = new Command3().name("init").description("Initialize a volume i
   try {
     const cwd = process.cwd();
     const dirName = path2.basename(cwd);
-    const existingConfig = await readVolumeConfig(cwd);
+    const existingConfig = await readStorageConfig(cwd);
     if (existingConfig) {
       console.log(
         chalk5.yellow(`Volume already initialized: ${existingConfig.name}`)
       );
       console.log(
-        chalk5.gray(`Config file: ${path2.join(cwd, ".vm0", "volume.yaml")}`)
+        chalk5.gray(`Config file: ${path2.join(cwd, ".vm0", "storage.yaml")}`)
       );
       return;
     }
     const volumeName = dirName;
-    if (!isValidVolumeName(volumeName)) {
+    if (!isValidStorageName(volumeName)) {
       console.error(chalk5.red(`\u2717 Invalid volume name: "${dirName}"`));
       console.error(
         chalk5.gray(
@@ -13137,11 +13179,11 @@ var initCommand = new Command3().name("init").description("Initialize a volume i
       );
       process.exit(1);
     }
-    await writeVolumeConfig(volumeName, cwd);
+    await writeStorageConfig(volumeName, cwd);
     console.log(chalk5.green(`\u2713 Initialized volume: ${volumeName}`));
     console.log(
       chalk5.gray(
-        `\u2713 Config saved to ${path2.join(cwd, ".vm0", "volume.yaml")}`
+        `\u2713 Config saved to ${path2.join(cwd, ".vm0", "storage.yaml")}`
       )
     );
   } catch (error43) {
@@ -13187,7 +13229,7 @@ function formatBytes(bytes) {
 var pushCommand = new Command4().name("push").description("Push local files to cloud volume").action(async () => {
   try {
     const cwd = process.cwd();
-    const config2 = await readVolumeConfig(cwd);
+    const config2 = await readStorageConfig(cwd);
     if (!config2) {
       console.error(chalk6.red("\u2717 No volume initialized in this directory"));
       console.error(chalk6.gray("  Run: vm0 volume init"));
@@ -13220,13 +13262,14 @@ var pushCommand = new Command4().name("push").description("Push local files to c
     );
     console.log(chalk6.gray("Uploading..."));
     const formData = new FormData();
-    formData.append("volumeName", config2.name);
+    formData.append("name", config2.name);
+    formData.append("type", "volume");
     formData.append(
       "file",
       new Blob([zipBuffer], { type: "application/zip" }),
       "volume.zip"
     );
-    const response = await apiClient.post("/api/volumes", {
+    const response = await apiClient.post("/api/storages", {
       body: formData
     });
     if (!response.ok) {
@@ -13263,7 +13306,7 @@ function formatBytes2(bytes) {
 var pullCommand = new Command5().name("pull").description("Pull cloud files to local directory").action(async () => {
   try {
     const cwd = process.cwd();
-    const config2 = await readVolumeConfig(cwd);
+    const config2 = await readStorageConfig(cwd);
     if (!config2) {
       console.error(chalk7.red("\u2717 No volume initialized in this directory"));
       console.error(chalk7.gray("  Run: vm0 volume init"));
@@ -13272,14 +13315,14 @@ var pullCommand = new Command5().name("pull").description("Pull cloud files to l
     console.log(chalk7.cyan(`Pulling volume: ${config2.name}`));
     console.log(chalk7.gray("Downloading..."));
     const response = await apiClient.get(
-      `/api/volumes?name=${encodeURIComponent(config2.name)}`
+      `/api/storages?name=${encodeURIComponent(config2.name)}`
     );
     if (!response.ok) {
       if (response.status === 404) {
         console.error(chalk7.red(`\u2717 Volume "${config2.name}" not found`));
         console.error(
           chalk7.gray(
-            "  Make sure the volume name is correct in .vm0/volume.yaml"
+            "  Make sure the volume name is correct in .vm0/storage.yaml"
           )
         );
         console.error(
@@ -13321,15 +13364,267 @@ var pullCommand = new Command5().name("pull").description("Pull cloud files to l
 // src/commands/volume/index.ts
 var volumeCommand = new Command6().name("volume").description("Manage cloud volumes").addCommand(initCommand).addCommand(pushCommand).addCommand(pullCommand);
 
+// src/commands/artifact/index.ts
+import { Command as Command10 } from "commander";
+
+// src/commands/artifact/init.ts
+import { Command as Command7 } from "commander";
+import chalk8 from "chalk";
+import path5 from "path";
+var initCommand2 = new Command7().name("init").description("Initialize an artifact in the current directory").action(async () => {
+  try {
+    const cwd = process.cwd();
+    const dirName = path5.basename(cwd);
+    const existingConfig = await readStorageConfig(cwd);
+    if (existingConfig) {
+      if (existingConfig.type === "artifact") {
+        console.log(
+          chalk8.yellow(
+            `Artifact already initialized: ${existingConfig.name}`
+          )
+        );
+      } else {
+        console.log(
+          chalk8.yellow(
+            `Directory already initialized as volume: ${existingConfig.name}`
+          )
+        );
+        console.log(
+          chalk8.gray(
+            "  To change type, delete .vm0/storage.yaml and reinitialize"
+          )
+        );
+      }
+      console.log(
+        chalk8.gray(`Config file: ${path5.join(cwd, ".vm0", "storage.yaml")}`)
+      );
+      return;
+    }
+    const artifactName = dirName;
+    if (!isValidStorageName(artifactName)) {
+      console.error(chalk8.red(`\u2717 Invalid artifact name: "${dirName}"`));
+      console.error(
+        chalk8.gray(
+          "  Artifact names must be 3-64 characters, lowercase alphanumeric with hyphens"
+        )
+      );
+      console.error(
+        chalk8.gray("  Example: my-project, user-workspace, code-artifact")
+      );
+      process.exit(1);
+    }
+    await writeStorageConfig(artifactName, cwd, "artifact");
+    console.log(chalk8.green(`\u2713 Initialized artifact: ${artifactName}`));
+    console.log(
+      chalk8.gray(
+        `\u2713 Config saved to ${path5.join(cwd, ".vm0", "storage.yaml")}`
+      )
+    );
+  } catch (error43) {
+    console.error(chalk8.red("\u2717 Failed to initialize artifact"));
+    if (error43 instanceof Error) {
+      console.error(chalk8.gray(`  ${error43.message}`));
+    }
+    process.exit(1);
+  }
+});
+
+// src/commands/artifact/push.ts
+import { Command as Command8 } from "commander";
+import chalk9 from "chalk";
+import path6 from "path";
+import * as fs3 from "fs";
+import AdmZip3 from "adm-zip";
+async function getAllFiles2(dirPath, baseDir = dirPath) {
+  const files = [];
+  const entries = await fs3.promises.readdir(dirPath, { withFileTypes: true });
+  for (const entry of entries) {
+    const fullPath = path6.join(dirPath, entry.name);
+    const relativePath = path6.relative(baseDir, fullPath);
+    if (relativePath.startsWith(".vm0")) {
+      continue;
+    }
+    if (entry.isDirectory()) {
+      const subFiles = await getAllFiles2(fullPath, baseDir);
+      files.push(...subFiles);
+    } else {
+      files.push(fullPath);
+    }
+  }
+  return files;
+}
+function formatBytes3(bytes) {
+  if (bytes === 0) return "0 B";
+  const k = 1024;
+  const sizes = ["B", "KB", "MB", "GB"];
+  const i = Math.floor(Math.log(bytes) / Math.log(k));
+  return `${(bytes / Math.pow(k, i)).toFixed(2)} ${sizes[i]}`;
+}
+var pushCommand2 = new Command8().name("push").description("Push local files to cloud artifact").action(async () => {
+  try {
+    const cwd = process.cwd();
+    const config2 = await readStorageConfig(cwd);
+    if (!config2) {
+      console.error(chalk9.red("\u2717 No artifact initialized in this directory"));
+      console.error(chalk9.gray("  Run: vm0 artifact init"));
+      process.exit(1);
+    }
+    if (config2.type !== "artifact") {
+      console.error(
+        chalk9.red(
+          `\u2717 This directory is initialized as a volume, not an artifact`
+        )
+      );
+      console.error(chalk9.gray("  Use: vm0 volume push"));
+      process.exit(1);
+    }
+    console.log(chalk9.cyan(`Pushing artifact: ${config2.name}`));
+    console.log(chalk9.gray("Collecting files..."));
+    const files = await getAllFiles2(cwd);
+    if (files.length === 0) {
+      console.log(chalk9.yellow("No files to upload"));
+      return;
+    }
+    let totalSize = 0;
+    for (const file2 of files) {
+      const stats = await fs3.promises.stat(file2);
+      totalSize += stats.size;
+    }
+    console.log(
+      chalk9.gray(`Found ${files.length} files (${formatBytes3(totalSize)})`)
+    );
+    console.log(chalk9.gray("Compressing files..."));
+    const zip = new AdmZip3();
+    for (const file2 of files) {
+      const relativePath = path6.relative(cwd, file2);
+      zip.addLocalFile(file2, path6.dirname(relativePath));
+    }
+    const zipBuffer = zip.toBuffer();
+    console.log(
+      chalk9.green(`\u2713 Compressed to ${formatBytes3(zipBuffer.length)}`)
+    );
+    console.log(chalk9.gray("Uploading..."));
+    const formData = new FormData();
+    formData.append("name", config2.name);
+    formData.append("type", "artifact");
+    formData.append(
+      "file",
+      new Blob([zipBuffer], { type: "application/zip" }),
+      "artifact.zip"
+    );
+    const response = await apiClient.post("/api/storages", {
+      body: formData
+    });
+    if (!response.ok) {
+      const error43 = await response.json();
+      throw new Error(error43.error || "Upload failed");
+    }
+    const result = await response.json();
+    console.log(chalk9.green("\u2713 Upload complete"));
+    console.log(chalk9.gray(`  Version: ${result.versionId}`));
+    console.log(chalk9.gray(`  Files: ${result.fileCount.toLocaleString()}`));
+    console.log(chalk9.gray(`  Size: ${formatBytes3(result.size)}`));
+  } catch (error43) {
+    console.error(chalk9.red("\u2717 Push failed"));
+    if (error43 instanceof Error) {
+      console.error(chalk9.gray(`  ${error43.message}`));
+    }
+    process.exit(1);
+  }
+});
+
+// src/commands/artifact/pull.ts
+import { Command as Command9 } from "commander";
+import chalk10 from "chalk";
+import path7 from "path";
+import * as fs4 from "fs";
+import AdmZip4 from "adm-zip";
+function formatBytes4(bytes) {
+  if (bytes === 0) return "0 B";
+  const k = 1024;
+  const sizes = ["B", "KB", "MB", "GB"];
+  const i = Math.floor(Math.log(bytes) / Math.log(k));
+  return `${(bytes / Math.pow(k, i)).toFixed(2)} ${sizes[i]}`;
+}
+var pullCommand2 = new Command9().name("pull").description("Pull cloud artifact to local directory").action(async () => {
+  try {
+    const cwd = process.cwd();
+    const config2 = await readStorageConfig(cwd);
+    if (!config2) {
+      console.error(chalk10.red("\u2717 No artifact initialized in this directory"));
+      console.error(chalk10.gray("  Run: vm0 artifact init"));
+      process.exit(1);
+    }
+    if (config2.type !== "artifact") {
+      console.error(
+        chalk10.red(
+          `\u2717 This directory is initialized as a volume, not an artifact`
+        )
+      );
+      console.error(chalk10.gray("  Use: vm0 volume pull"));
+      process.exit(1);
+    }
+    console.log(chalk10.cyan(`Pulling artifact: ${config2.name}`));
+    console.log(chalk10.gray("Downloading..."));
+    const response = await apiClient.get(
+      `/api/storages?name=${encodeURIComponent(config2.name)}`
+    );
+    if (!response.ok) {
+      if (response.status === 404) {
+        console.error(chalk10.red(`\u2717 Artifact "${config2.name}" not found`));
+        console.error(
+          chalk10.gray(
+            "  Make sure the artifact name is correct in .vm0/storage.yaml"
+          )
+        );
+        console.error(
+          chalk10.gray("  Or push the artifact first with: vm0 artifact push")
+        );
+      } else {
+        const error43 = await response.json();
+        throw new Error(error43.error || "Download failed");
+      }
+      process.exit(1);
+    }
+    const arrayBuffer = await response.arrayBuffer();
+    const zipBuffer = Buffer.from(arrayBuffer);
+    console.log(chalk10.green(`\u2713 Downloaded ${formatBytes4(zipBuffer.length)}`));
+    console.log(chalk10.gray("Extracting files..."));
+    const zip = new AdmZip4(zipBuffer);
+    const zipEntries = zip.getEntries();
+    let extractedCount = 0;
+    for (const entry of zipEntries) {
+      if (!entry.isDirectory) {
+        const targetPath = path7.join(cwd, entry.entryName);
+        const dir = path7.dirname(targetPath);
+        await fs4.promises.mkdir(dir, { recursive: true });
+        const data = entry.getData();
+        await fs4.promises.writeFile(targetPath, data);
+        extractedCount++;
+      }
+    }
+    console.log(chalk10.green(`\u2713 Extracted ${extractedCount} files`));
+  } catch (error43) {
+    console.error(chalk10.red("\u2717 Pull failed"));
+    if (error43 instanceof Error) {
+      console.error(chalk10.gray(`  ${error43.message}`));
+    }
+    process.exit(1);
+  }
+});
+
+// src/commands/artifact/index.ts
+var artifactCommand = new Command10().name("artifact").description("Manage cloud artifacts (work products)").addCommand(initCommand2).addCommand(pushCommand2).addCommand(pullCommand2);
+
 // src/index.ts
-var program = new Command7();
+var program = new Command11();
 program.name("vm0").description("VM0 CLI - A modern build tool").version("0.1.0");
 program.command("hello").description("Say hello from the App").action(() => {
-  console.log(chalk8.blue("Welcome to the VM0 CLI!"));
-  console.log(chalk8.green(`Core says: ${FOO}`));
+  console.log(chalk11.blue("Welcome to the VM0 CLI!"));
+  console.log(chalk11.green(`Core says: ${FOO}`));
 });
 program.command("info").description("Display environment information").action(async () => {
-  console.log(chalk8.cyan("System Information:"));
+  console.log(chalk11.cyan("System Information:"));
   console.log(`Node Version: ${process.version}`);
   console.log(`Platform: ${process.platform}`);
   console.log(`Architecture: ${process.arch}`);
@@ -13349,6 +13644,7 @@ authCommand.command("status").description("Show current authentication status").
 program.addCommand(buildCommand);
 program.addCommand(runCommand);
 program.addCommand(volumeCommand);
+program.addCommand(artifactCommand);
 if (process.argv[1]?.endsWith("index.js") || process.argv[1]?.endsWith("index.ts") || process.argv[1]?.endsWith("vm0")) {
   program.parse();
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vm0/cli",
-  "version": "1.4.0",
+  "version": "1.6.0",
   "description": "CLI application",
   "type": "module",
   "bin": {