@vm0/cli 9.165.3 → 9.166.0

package/index.js

@@ -68,7 +68,7 @@ import {
   source_default,
   volumeConfigSchema,
   withErrorHandler
-} from "./chunk-X7OEKYPB.js";
+} from "./chunk-TRRVYMW2.js";
 import {
   __toESM,
   init_esm_shims
@@ -387,7 +387,7 @@ function getConfigPath() {
   return join(os.homedir(), ".vm0", "config.json");
 }
 var infoCommand = new Command().name("info").description("Display environment and debug information").action(async () => {
-  console.log(source_default.bold(`VM0 CLI v${"9.165.3"}`));
+  console.log(source_default.bold(`VM0 CLI v${"9.166.0"}`));
   console.log();
   const config = await loadConfig();
   const hasEnvToken = !!process.env.VM0_TOKEN;
@@ -4280,7 +4280,7 @@ var composeCommand = new Command().name("compose").description("Create or update
         options.autoUpdate = false;
       }
       if (options.autoUpdate !== false) {
-        await startSilentUpgrade("9.165.3");
+        await startSilentUpgrade("9.166.0");
       }
       try {
         let result;
@@ -4372,7 +4372,7 @@ var mainRunCommand = new Command().name("run").description("Run an agent").argum
   withErrorHandler(
     async (identifier, prompt, options) => {
       if (options.autoUpdate !== false) {
-        await startSilentUpgrade("9.165.3");
+        await startSilentUpgrade("9.166.0");
       }
       const { name, version } = parseIdentifier(identifier);
       let composeId;
@@ -6165,13 +6165,13 @@ var upgradeCommand = new Command().name("upgrade").description("Upgrade vm0 CLI
     if (latestVersion === null) {
       throw new Error("Could not check for updates. Please try again later.");
     }
-    if (latestVersion === "9.165.3") {
-      console.log(source_default.green(`\u2713 Already up to date (${"9.165.3"})`));
+    if (latestVersion === "9.166.0") {
+      console.log(source_default.green(`\u2713 Already up to date (${"9.166.0"})`));
       return;
     }
     console.log(
       source_default.yellow(
-        `Current version: ${"9.165.3"} -> Latest version: ${latestVersion}`
+        `Current version: ${"9.166.0"} -> Latest version: ${latestVersion}`
       )
     );
     console.log();
@@ -6198,7 +6198,7 @@ var upgradeCommand = new Command().name("upgrade").description("Upgrade vm0 CLI
     const success = await performUpgrade(packageManager);
     if (success) {
       console.log(
-        source_default.green(`\u2713 Upgraded from ${"9.165.3"} to ${latestVersion}`)
+        source_default.green(`\u2713 Upgraded from ${"9.166.0"} to ${latestVersion}`)
       );
       return;
     }
@@ -6265,7 +6265,7 @@ var whoamiCommand = new Command().name("whoami").description("Show current ident
 
 // src/index.ts
 var program = new Command();
-program.name("vm0").description("VM0 CLI - Build and run agents with natural language").version("9.165.3");
+program.name("vm0").description("VM0 CLI - Build and run agents with natural language").version("9.166.0");
 program.addCommand(authCommand);
 program.addCommand(infoCommand);
 program.addCommand(composeCommand);

package/package.json

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

package/zero.js

@@ -152,7 +152,7 @@ import {
   zeroAgentCustomSkillNameSchema,
   zeroLocalAgentCommand,
   zeroTokenAllowsFeatureSwitch
-} from "./chunk-X7OEKYPB.js";
+} from "./chunk-TRRVYMW2.js";
 import {
   __toESM,
   init_esm_shims
@@ -6850,6 +6850,44 @@ import { mkdir, writeFile } from "fs/promises";
 import { join as join6 } from "path";
 var COMPUTER_USE_SCREENSHOT_DIR = "/tmp/vm0/computer-use";
 var DATA_URL_PATTERN = /^data:([^;,]+);base64,(.*)$/s;
+var COMPUTER_USE_HELP_TEXT = `
+Workflow:
+  1. Start the Zero Desktop app and make sure Computer Use is online.
+  2. Run "zero computer-use list-apps" to find the target app name or bundle id.
+  3. Run "zero computer-use get-app-state --app <app>" to get a screenshot,
+     snapshotId, visible element indexes, and accessibility state.
+  4. Prefer element actions with --snapshot-id and --element-index. Use --x/--y
+     only when the target is visible in the returned screenshot but has no useful
+     accessibility element.
+  5. Read the JSON result. Screenshot data is saved under /tmp/vm0/computer-use
+     and replaced with a local file path in CLI output.
+
+Notes:
+  Write commands are sent to the connected Desktop host and may wait for local
+  approval before they run. Coordinate fallbacks use screenshot coordinates from
+  get-app-state; pass the matching --snapshot-id when acting on a prior snapshot.
+
+Examples:
+  List available apps:
+    zero computer-use list-apps
+
+  Inspect Safari state:
+    zero computer-use get-app-state --app Safari
+
+  Click element index 7 from snapshot desktop_abc:
+    zero computer-use click --app Safari --snapshot-id desktop_abc --element-index 7
+
+  Click screenshot coordinate (320, 240) from snapshot desktop_abc:
+    zero computer-use click --app Safari --snapshot-id desktop_abc --x 320 --y 240
+
+  Type text into the current focus in Safari:
+    zero computer-use type-text --app Safari --text "Hello"
+
+  Press a keyboard shortcut:
+    zero computer-use press-key --app Safari --key Command+L
+
+  Open an app without activating the current foreground app:
+    zero computer-use open-app --app Things`;
 function sleep2(ms) {
   return new Promise((resolve2) => {
     setTimeout(resolve2, ms);
@@ -7144,7 +7182,7 @@ var openAppCommand = appOption(
     )
   )
 );
-var zeroComputerUseCommand = new Command().name("computer-use").description("Desktop app computer use through Zero CLI").addCommand(listAppsCommand).addCommand(getAppStateCommand).addCommand(clickCommand).addCommand(scrollCommand).addCommand(setValueCommand).addCommand(typeTextCommand).addCommand(pressKeyCommand).addCommand(performActionCommand).addCommand(openAppCommand);
+var zeroComputerUseCommand = new Command().name("computer-use").description("Desktop app computer use through Zero CLI").addHelpText("after", COMPUTER_USE_HELP_TEXT).addCommand(listAppsCommand).addCommand(getAppStateCommand).addCommand(clickCommand).addCommand(scrollCommand).addCommand(setValueCommand).addCommand(typeTextCommand).addCommand(pressKeyCommand).addCommand(performActionCommand).addCommand(openAppCommand);
 
 // src/commands/zero/built-in/index.ts
 init_esm_shims();
@@ -7441,6 +7479,7 @@ var OPEN_DESIGN_REGISTRY = [
     kind: "image-style",
     name: "Notion Illustration",
     description: "Zero-native illustration style for hand-drawn product spot illustrations with simple ink contours and soft backgrounds.",
+    desc: 'Notion-editorial-style hand-drawn spot illustration. Black brush-pen ink on white, tapered confident strokes, solid-black curly hair, solid-black pants/shoes, 3/4 face turned toward viewer with closed-eye smile and soft nose hint, open breathing body outlines, and 1-3 supporting scene props + ambient marks that frame the moment. Trigger when user says /notion-illustration, asks for a "Notion-style illustration", "Notion spot illustration", or a new piece in this hand-drawn brush-pen Notion editorial style.',
     source: sourceRef(
       VM0_SKILLS_REPO,
       VM0_SKILLS_REF,
@@ -7473,6 +7512,7 @@ var OPEN_DESIGN_REGISTRY = [
     kind: "image-style",
     name: "vm0 Illustration",
     description: "vm0 in-app spot illustration style with bold hand-drawn ink line art, white-filled interiors, and a soft rounded color backdrop.",
+    desc: "Generate vm0-style vm0 in-app spot illustrations: bold hand-drawn ink line art with white-filled interiors, a soft rounded color backdrop, transparent output, and simple iconic metaphors for product states.",
     source: sourceRef(
       VM0_SKILLS_REPO,
       VM0_SKILLS_REF,
@@ -7509,6 +7549,16 @@ var OPEN_DESIGN_REGISTRY = [
     priority: 19
   }
 ];
+function listImageStyles() {
+  return OPEN_DESIGN_REGISTRY.filter((entry) => {
+    return entry.kind === "image-style" && entry.status !== "hidden";
+  });
+}
+function findImageStyle(id) {
+  return listImageStyles().find((entry) => {
+    return entry.id === id;
+  });
+}
 function toOpenDesignTarget(value) {
   if (value === "dashboard") {
     return "dashboard-design";
@@ -7639,16 +7689,22 @@ function selectOpenDesignCandidates(options) {
 // src/commands/zero/shared/image-style-authoring.ts
 var outputDir = "./opendesign/images";
 var artifactRules = [
-  "Select the image style that best matches the prompt before generation.",
   "Resolve the selected style source before generating the image.",
   "Use the style skill's referenced assets and generation path when it provides one.",
   "Produce a single final image file and keep any temporary metadata under the output directory."
 ];
 function createStyledImageAuthoringPacket(options) {
-  const candidateSlice = selectOpenDesignCandidates({
+  const baseSlice = selectOpenDesignCandidates({
     target: "image",
     prompt: [options.prompt, ...options.details, ...artifactRules].join("\n")
   });
+  const candidateSlice = {
+    ...baseSlice,
+    candidates: {
+      ...baseSlice.candidates,
+      imageStyles: [options.style]
+    }
+  };
   const selectionSchema = {
     imageStyle: "string",
     skills: "string[]",
@@ -7671,18 +7727,20 @@ function createStyledImageAuthoringPacket(options) {
     outputDir
   };
   const instructions = [
-    "# Zero built-in generate image --styled",
+    `# Zero built-in generate image --style ${options.style.id}`,
     "",
     "This is a federated generation resource-selection packet for the current agent.",
-    "Zero is not generating this image on the server yet. You select resources, resolve them, and generate the styled image.",
+    "Zero is not generating this image on the server yet. The image style has already been selected by the caller \u2014 resolve it and generate the styled image.",
     "",
     "## User Prompt",
     options.prompt,
     "",
-    "## Stage 1: Resource Selection",
-    "- Choose an image style from the bundled federated registry slice below.",
+    "## Selected Image Style",
+    `- \`${options.style.id}\` \u2014 ${options.style.name}`,
+    "",
+    "## Stage 1: Supporting Resource Selection",
+    "- The image style is locked. Optionally pick supporting skills/templates from the candidate slice below.",
     "- Choose only IDs present in this packet; do not invent registry IDs.",
-    "- Prefer image-style resources with matching triggers, but the user prompt is the highest-priority signal.",
     "- Treat the selection JSON as internal working state, then continue to generation.",
     "",
     "## Selection Output Schema",
@@ -7748,6 +7806,43 @@ function createStyledImageAuthoringPacket(options) {
 }
 
 // src/commands/zero/shared/image-generate.ts
+function formatStyleListing(styles) {
+  if (styles.length === 0) {
+    return "  (no image styles registered)";
+  }
+  return styles.map((style) => {
+    const desc = style.desc ?? style.description;
+    return `  ${style.id}
+    ${desc}`;
+  }).join("\n\n");
+}
+function requireStyleError(usageCommand) {
+  const styles = listImageStyles();
+  const message = [
+    "--style <id> or --skip-style is required",
+    "",
+    "Available styles:",
+    formatStyleListing(styles),
+    "",
+    `Examples:`,
+    `  ${usageCommand} --style ${styles[0]?.id ?? "<style-id>"} --prompt "..."`,
+    `  ${usageCommand} --skip-style --prompt "..."`
+  ].join("\n");
+  return new Error(message);
+}
+function unknownStyleError(id, usageCommand) {
+  const styles = listImageStyles();
+  const message = [
+    `Unknown image style: ${id}`,
+    "",
+    "Available styles:",
+    formatStyleListing(styles),
+    "",
+    `Example:`,
+    `  ${usageCommand} --style ${styles[0]?.id ?? "<style-id>"} --prompt "..."`
+  ].join("\n");
+  return new Error(message);
+}
 function readPrompt(options, usageCommand) {
   if (options.prompt?.trim()) {
     return options.prompt.trim();
@@ -7837,17 +7932,21 @@ function createImageGenerateCommand(config) {
     "--image-prompt-strength <0-1>",
     "Reference strength override for Flux Redux"
   ).option(
-    "--styled",
-    "Print a resource-selection packet for styled image generation"
-  ).option("--json", "Print metadata as JSON").addHelpText(
-    "after",
-    `
+    "--style <id>",
+    "Image style id from the registry (see Image Styles below)"
+  ).option(
+    "--skip-style",
+    "Opt out of styled image generation for this invocation"
+  ).option("--json", "Print metadata as JSON").addHelpText("after", () => {
+    const styles = listImageStyles();
+    return `
 Examples:
 ${config.examples}
 
 Output:
-  Prints the generated /f/ image file URL and metadata. With --styled, prints
-  an Open Design resource-selection packet for the current agent.
+  Prints the generated /f/ image file URL and metadata. With --style <id>,
+  prints an Open Design resource-selection packet for the current agent
+  with the selected style locked in.
 
 Notes:
   - Authenticates via ZERO_TOKEN (requires file:write capability)
@@ -7864,6 +7963,8 @@ Models:
 
 Options:
   - Prompt: required, up to 32,000 characters; stdin is supported.
+  - Style: required. Pass --style <id> to generate in a registered style
+    or --skip-style to bypass styled generation entirely.
   - Size: gpt-image-2 accepts auto or WIDTHxHEIGHT. Popular sizes include
     1024x1024,
     1536x1024, 1024x1536, 2048x2048, 2048x1152, 3840x2160,
@@ -7883,14 +7984,26 @@ Options:
     Flux Redux accepts --image-prompt-strength to override the provider
     default; GPT edit models accept --input-fidelity and supported models
     accept --mask-image-url.
-  - Styled mode: pass --styled to select an image style resource first. In this
-    mode the agent resolves the selected style source and generates the image.`
-  ).action(
+
+Image Styles:
+${formatStyleListing(styles)}`;
+  }).action(
     withErrorHandler(async (options, command) => {
+      if (options.style && options.skipStyle) {
+        throw new Error("--style and --skip-style cannot be combined");
+      }
+      if (!options.style && !options.skipStyle) {
+        throw requireStyleError(config.usageCommand);
+      }
       const prompt = readPrompt(options, config.usageCommand);
-      if (options.styled) {
+      if (options.style) {
+        const style = findImageStyle(options.style);
+        if (!style) {
+          throw unknownStyleError(options.style, config.usageCommand);
+        }
         const packet = createStyledImageAuthoringPacket({
           prompt,
+          style,
           details: [
             `Model preference if direct image generation is used: ${options.model}`,
             `Requested size: ${options.size}`,
@@ -7966,12 +8079,12 @@ Options:
 var imageCommand = createImageGenerateCommand({
   name: "image",
   usageCommand: "zero built-in generate image",
-  examples: `  Generate image:        zero built-in generate image --prompt "A watercolor fox"
-  Pipe prompt:           cat prompt.txt | zero built-in generate image
-  Styled image:          zero built-in generate image --styled --prompt "A product manager mapping a launch plan"
-  GPT Image model:       zero built-in generate image --model gpt-image-1.5 --prompt "A poster" --size 1024x1536 --quality high
-  Flux model:            zero built-in generate image --model flux-pro-1.1 --prompt "A product hero shot" --seed 42
-  Image-to-image:        zero built-in generate image --model flux-pro-1.1 --image-url https://example.com/mockup.png --prompt "Turn this mockup into a polished product shot"`
+  examples: `  Styled image:          zero built-in generate image --style vm0:image-style:notion-illustration --prompt "A product manager mapping a launch plan"
+  Skip style:            zero built-in generate image --skip-style --prompt "A watercolor fox"
+  Pipe prompt:           cat prompt.txt | zero built-in generate image --skip-style
+  GPT Image model:       zero built-in generate image --skip-style --model gpt-image-1.5 --prompt "A poster" --size 1024x1536 --quality high
+  Flux model:            zero built-in generate image --skip-style --model flux-pro-1.1 --prompt "A product hero shot" --seed 42
+  Image-to-image:        zero built-in generate image --skip-style --model flux-pro-1.1 --image-url https://example.com/mockup.png --prompt "Turn this mockup into a polished product shot"`
 });
 
 // src/commands/zero/built-in/generate/open-design-artifacts.ts
@@ -10083,7 +10196,7 @@ function registerZeroCommands(prog, commands) {
 var program = new Command();
 program.name("zero").description(
   "Zero CLI \u2014 interact with the zero platform from inside the sandbox"
-).version("9.165.3").addHelpText("after", () => {
+).version("9.166.0").addHelpText("after", () => {
   return buildZeroHelpText();
 });
 if (process.argv[1]?.endsWith("zero.js") || process.argv[1]?.endsWith("zero.ts") || process.argv[1]?.endsWith("zero")) {