@vm0/cli 3.3.0 → 3.4.0

package/index.js

@@ -12352,6 +12352,26 @@ var ApiClient = class {
     }
     return await response.json();
   }
+  /**
+   * Resolve a version specifier to a full version ID
+   * Supports: "latest", full hash (64 chars), or hash prefix (8+ chars)
+   */
+  async getComposeVersion(composeId, version2) {
+    const baseUrl = await this.getBaseUrl();
+    const headers = await this.getHeaders();
+    const response = await fetch(
+      `${baseUrl}/api/agent/composes/versions?composeId=${encodeURIComponent(composeId)}&version=${encodeURIComponent(version2)}`,
+      {
+        method: "GET",
+        headers
+      }
+    );
+    if (!response.ok) {
+      const error43 = await response.json();
+      throw new Error(error43.error?.message || `Version not found: ${version2}`);
+    }
+    return await response.json();
+  }
   async createOrUpdateCompose(body) {
     const baseUrl = await this.getBaseUrl();
     const headers = await this.getHeaders();
@@ -13100,6 +13120,19 @@ function collectVolumeVersions(value, previous) {
 function isUUID(str) {
   return /^[0-9a-f-]{36}$/i.test(str);
 }
+function parseIdentifier(identifier) {
+  if (isUUID(identifier)) {
+    return { name: identifier };
+  }
+  const colonIndex = identifier.lastIndexOf(":");
+  if (colonIndex > 0 && colonIndex < identifier.length - 1) {
+    return {
+      name: identifier.slice(0, colonIndex),
+      version: identifier.slice(colonIndex + 1)
+    };
+  }
+  return { name: identifier };
+}
 var DEFAULT_TIMEOUT_SECONDS = 120;
 async function pollEvents(runId, timeoutSeconds, options) {
   let nextSequence = -1;
@@ -13166,7 +13199,7 @@ ${action}...`));
 }
 var runCmd = new Command2().name("run").description("Execute an agent").argument(
   "<identifier>",
-  "Agent name or config ID (e.g., 'my-agent' or 'cfg-abc-123')"
+  "Agent name, config ID, or name:version (e.g., 'my-agent', 'my-agent:abc123', 'my-agent:latest')"
 ).argument("<prompt>", "Prompt for the agent").option(
   "--vars <KEY=value>",
   "Template variables for config placeholders (repeatable)",
@@ -13208,25 +13241,26 @@ var runCmd = new Command2().name("run").description("Execute an agent").argument
     }
     const verbose = options.verbose;
     try {
+      const { name, version: version2 } = parseIdentifier(identifier);
       let composeId;
-      if (isUUID(identifier)) {
-        composeId = identifier;
+      if (isUUID(name)) {
+        composeId = name;
         if (verbose) {
           console.log(chalk4.gray(`  Using compose ID: ${composeId}`));
         }
       } else {
         if (verbose) {
-          console.log(chalk4.gray(`  Resolving agent name: ${identifier}`));
+          console.log(chalk4.gray(`  Resolving agent name: ${name}`));
         }
         try {
-          const compose = await apiClient.getComposeByName(identifier);
+          const compose = await apiClient.getComposeByName(name);
           composeId = compose.id;
           if (verbose) {
             console.log(chalk4.gray(`  Resolved to compose ID: ${composeId}`));
           }
         } catch (error43) {
           if (error43 instanceof Error) {
-            console.error(chalk4.red(`\u2717 Agent not found: ${identifier}`));
+            console.error(chalk4.red(`\u2717 Agent not found: ${name}`));
             console.error(
               chalk4.gray(
                 "  Make sure you've built the agent with: vm0 build"
@@ -13236,9 +13270,40 @@ var runCmd = new Command2().name("run").description("Execute an agent").argument
           process.exit(1);
         }
       }
+      let agentComposeVersionId;
+      if (version2 && version2 !== "latest") {
+        if (verbose) {
+          console.log(chalk4.gray(`  Resolving version: ${version2}`));
+        }
+        try {
+          const versionInfo = await apiClient.getComposeVersion(
+            composeId,
+            version2
+          );
+          agentComposeVersionId = versionInfo.versionId;
+          if (verbose) {
+            console.log(
+              chalk4.gray(
+                `  Resolved to version ID: ${agentComposeVersionId.slice(0, 8)}...`
+              )
+            );
+          }
+        } catch (error43) {
+          if (error43 instanceof Error) {
+            console.error(chalk4.red(`\u2717 Version not found: ${version2}`));
+            console.error(
+              chalk4.gray(
+                "  Make sure the version hash exists. Use 'vm0 build' to see available versions."
+              )
+            );
+          }
+          process.exit(1);
+        }
+      }
       if (verbose) {
         logVerbosePreFlight("Creating agent run", [
           { label: "Prompt", value: prompt },
+          { label: "Version", value: version2 || "latest (HEAD)" },
           {
             label: "Variables",
             value: Object.keys(options.vars).length > 0 ? JSON.stringify(options.vars) : void 0
@@ -13253,7 +13318,8 @@ var runCmd = new Command2().name("run").description("Execute an agent").argument
         ]);
       }
       const response = await apiClient.createRun({
-        agentComposeId: composeId,
+        // Use agentComposeVersionId if resolved, otherwise use agentComposeId (resolves to HEAD)
+        ...agentComposeVersionId ? { agentComposeVersionId } : { agentComposeId: composeId },
         prompt,
         templateVars: Object.keys(options.vars).length > 0 ? options.vars : void 0,
         artifactName: options.artifactName,
@@ -14140,7 +14206,7 @@ var artifactCommand = new Command10().name("artifact").description("Manage cloud
 
 // src/index.ts
 var program = new Command11();
-program.name("vm0").description("VM0 CLI - A modern build tool").version("3.3.0");
+program.name("vm0").description("VM0 CLI - A modern build tool").version("3.4.0");
 program.command("hello").description("Say hello from the App").action(() => {
   console.log(chalk11.blue("Welcome to the VM0 CLI!"));
   console.log(chalk11.green(`Core says: ${FOO}`));

package/package.json

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