@vm0/cli 9.142.1 → 9.144.0

package/package.json

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

package/zero.js

@@ -35,6 +35,7 @@ import {
   enableZeroSchedule,
   extractSecretNamesFromApis,
   findMatchingPermissions,
+  generateWebImage,
   generateWebVoice,
   getActiveOrg,
   getApiUrl,
@@ -127,7 +128,7 @@ import {
   upsertZeroOrgModelProvider,
   withErrorHandler,
   zeroAgentCustomSkillNameSchema
-} from "./chunk-MB6EHK2G.js";
+} from "./chunk-75VR4R5J.js";
 import {
   __toESM,
   init_esm_shims
@@ -2725,10 +2726,19 @@ How connectors work:
 
 // src/commands/zero/doctor/generate.ts
 init_esm_shims();
+var BUILT_IN_GENERATION_OPTIONS = {
+  image: {
+    description: "If the user did not explicitly request a specific connector or provider, you can use the official generation capability. Run `zero official generate image -h` for options."
+  },
+  voice: {
+    description: "If the user did not explicitly request a specific connector or provider, you can use the official generation capability. Run `zero official generate voice -h` for options."
+  }
+};
 var GENERATION_TYPE_ORDER = [
   "image",
   "video",
   "audio",
+  "voice",
   "text",
   "code",
   "document",
@@ -2743,8 +2753,15 @@ var GENERATION_TYPE_LABELS = {
   presentation: "Presentation",
   text: "Text",
   video: "Video",
+  voice: "Voice",
   website: "Website"
 };
+function getConnectorGenerationType(generationType) {
+  if (generationType === "voice") {
+    return "audio";
+  }
+  return generationType;
+}
 function getAvailableGenerationTypes() {
   const available = /* @__PURE__ */ new Set();
   for (const config of Object.values(CONNECTOR_TYPES)) {
@@ -2753,7 +2770,7 @@ function getAvailableGenerationTypes() {
     }
   }
   return GENERATION_TYPE_ORDER.filter((type) => {
-    return available.has(type);
+    return type in BUILT_IN_GENERATION_OPTIONS || available.has(getConnectorGenerationType(type));
   });
 }
 function parseGenerationType(value) {
@@ -2874,6 +2891,13 @@ function renderActions(candidates) {
     console.log(`  [${candidate.actionLabel}](${candidate.actionUrl})`);
   }
 }
+function renderBuiltInOption(generationType) {
+  const option = BUILT_IN_GENERATION_OPTIONS[generationType];
+  if (!option) return;
+  console.log("");
+  console.log("Fallback option:");
+  console.log(`  ${option.description}`);
+}
 function renderText(params) {
   const { generationType, agentId, ready, other, showAll } = params;
   const label = GENERATION_TYPE_LABELS[generationType];
@@ -2894,6 +2918,7 @@ function renderText(params) {
   } else {
     console.log(`No ready ${generationType} generation connectors found.`);
   }
+  renderBuiltInOption(generationType);
   if (showAll && other.length > 0) {
     console.log("");
     console.log(`Other ${generationType} generation connectors`);
@@ -2910,6 +2935,7 @@ var generateCommand = new Command().name("generate").description("Show generatio
 ).option("--all", "Also show unavailable or not-yet-authorized connectors").option("--json", "Output machine-readable JSON").action(
   withErrorHandler(async (type, options) => {
     const generationType = parseGenerationType(type);
+    const connectorGenerationType = getConnectorGenerationType(generationType);
     const agentId = process.env.ZERO_AGENT_ID;
     const [connectorList, enabledTypes, platformOrigin] = await Promise.all([
       listZeroConnectors(),
@@ -2923,7 +2949,7 @@ var generateCommand = new Command().name("generate").description("Show generatio
     );
     const configuredTypes = new Set(connectorList.configuredTypes);
     const authorizedTypes = enabledTypes ? new Set(enabledTypes) : null;
-    const candidates = getGenerationConnectors(generationType).map(
+    const candidates = getGenerationConnectors(connectorGenerationType).map(
       ([connectorType, config]) => {
         return toCandidate({
           type: connectorType,
@@ -2947,10 +2973,12 @@ var generateCommand = new Command().name("generate").description("Show generatio
         JSON.stringify(
           {
             generationType,
+            connectorGenerationType,
             availableTypes: getAvailableGenerationTypes(),
             agentId: agentId ?? null,
             choices: ready,
-            otherCandidates: other
+            otherCandidates: other,
+            builtInOption: BUILT_IN_GENERATION_OPTIONS[generationType] ?? null
           },
           null,
           2
@@ -5568,7 +5596,7 @@ Examples:
       const limit = options.limit ? parseInt(options.limit, 10) : void 0;
       const since = options.since ? parseTime(options.since) : void 0;
       const result = await listZeroLogs({
-        agent: options.agent,
+        agentId: options.agent,
         status: options.status,
         since,
         limit
@@ -5714,7 +5742,7 @@ async function runLogsSearch(keyword, options) {
   const limit = parseLimit2(options.limit);
   const response = await searchZeroLogs({
     keyword,
-    agent: options.agent,
+    agentId: options.agentId,
     runId: options.run,
     since,
     limit,
@@ -5740,9 +5768,12 @@ Examples:
   zero logs search "timeout" --agent 123e4567-e89b-12d3-a456-426614174000 -C 2
   zero logs search "failed" --since 30d --limit 50`
 ).action(
-  withErrorHandler(async (keyword, options) => {
-    await runLogsSearch(keyword, options);
-  })
+  withErrorHandler(
+    async (keyword, options) => {
+      const { agent, ...searchOptions } = options;
+      await runLogsSearch(keyword, { ...searchOptions, agentId: agent });
+    }
+  )
 );
 
 // src/commands/zero/logs/index.ts
@@ -5920,7 +5951,7 @@ async function runLogsSource(query, options) {
     afterContext: options.afterContext,
     beforeContext: options.beforeContext,
     context: options.context,
-    agent: options.agent,
+    agentId: options.agent,
     run: options.run,
     since: options.since,
     limit: options.limit
@@ -5972,7 +6003,7 @@ async function runChatSource(query, options) {
   const since = options.since ? parseTime(options.since) : Date.now() - SEVEN_DAYS_MS2;
   const response = await searchZeroChat({
     keyword: query,
-    agent: options.agent,
+    agentId: options.agent,
     since,
     limit,
     before,
@@ -5997,7 +6028,7 @@ var zeroSearchCommand = new Command().name("search").description("Search logs, c
   "Source to search: logs | chat | slack (pass once)",
   collectSource,
   []
-).option("--agent <agent>", "Filter by agent (logs use ID; chat uses name)").option("--run <id>", "Filter by run ID").option("--since <time>", "Time window (e.g., 7d, 2h)").option("--limit <n>", "Maximum number of matches").option("-A, --after-context <n>", "Show n items after each match").option("-B, --before-context <n>", "Show n items before each match").option("-C, --context <n>", "Show n items before and after each match").addHelpText("after", SEARCH_EXPLAINER).action(
+).option("--agent <id>", "Filter by Zero agent ID").option("--run <id>", "Filter by run ID").option("--since <time>", "Time window (e.g., 7d, 2h)").option("--limit <n>", "Maximum number of matches").option("-A, --after-context <n>", "Show n items after each match").option("-B, --before-context <n>", "Show n items before each match").option("-C, --context <n>", "Show n items before and after each match").addHelpText("after", SEARCH_EXPLAINER).action(
   withErrorHandler(async (query, options) => {
     const sources = options.source;
     if (sources.length === 0) {
@@ -7100,6 +7131,175 @@ Examples:
 );
 var zeroComputerUseCommand = new Command().name("computer-use").description("Remote desktop control for cloud agents").addCommand(hostCommand).addCommand(clientCommand);
 
+// src/commands/zero/official/index.ts
+init_esm_shims();
+
+// src/commands/zero/official/generate/index.ts
+init_esm_shims();
+
+// src/commands/zero/official/generate/image.ts
+init_esm_shims();
+
+// src/commands/zero/shared/image-generate.ts
+init_esm_shims();
+import { readFileSync as readFileSync10 } from "fs";
+function readPrompt(options, usageCommand) {
+  if (options.prompt?.trim()) {
+    return options.prompt.trim();
+  }
+  if (process.stdin.isTTY === false) {
+    const prompt = readFileSync10("/dev/stdin", "utf8").trim();
+    if (prompt.length > 0) {
+      return prompt;
+    }
+  }
+  throw new Error("--prompt is required", {
+    cause: new Error(`Usage: ${usageCommand} --prompt "A watercolor fox"`)
+  });
+}
+function createImageGenerateCommand(config) {
+  return new Command().name(config.name).description("Generate a billed image file from a prompt").option("--prompt <text>", "Image prompt; can also be piped via stdin").option(
+    "--size <size>",
+    "Image size: 1024x1024, 1024x1536, or 1536x1024",
+    "1024x1024"
+  ).option(
+    "--quality <quality>",
+    "Image quality: low, medium, high, or auto",
+    "medium"
+  ).option(
+    "--background <background>",
+    "Background: auto, opaque, or transparent",
+    "auto"
+  ).option("--format <format>", "Output format: png, webp, or jpeg", "png").option("--json", "Print metadata as JSON").addHelpText(
+    "after",
+    `
+Examples:
+${config.examples}
+
+Output:
+  Prints the generated /f/ image file URL and metadata
+
+Notes:
+  - Authenticates via ZERO_TOKEN (requires file:write capability)
+  - Charges org credits after successful image generation
+  - Uses OpenAI gpt-image-2 and bills returned usage tokens`
+  ).action(
+    withErrorHandler(async (options) => {
+      const prompt = readPrompt(options, config.usageCommand);
+      const result = await generateWebImage({
+        prompt,
+        size: options.size,
+        quality: options.quality,
+        background: options.background,
+        outputFormat: options.format
+      });
+      if (options.json) {
+        console.log(JSON.stringify(result));
+        return;
+      }
+      console.log(source_default.green(`\u2713 Image generated: ${result.url}`));
+      console.log(source_default.dim(`  File: ${result.filename}`));
+      console.log(source_default.dim(`  Size: ${result.imageSize}`));
+      console.log(source_default.dim(`  Quality: ${result.quality}`));
+      console.log(source_default.dim(`  Format: ${result.outputFormat}`));
+      console.log(source_default.dim(`  Credits charged: ${result.creditsCharged}`));
+      console.log(source_default.dim(`  Model: ${result.model}`));
+    })
+  );
+}
+
+// src/commands/zero/official/generate/image.ts
+var imageCommand = createImageGenerateCommand({
+  name: "image",
+  usageCommand: "zero official generate image",
+  examples: `  Generate image:        zero official generate image --prompt "A watercolor fox"
+  Pipe prompt:           cat prompt.txt | zero official generate image
+  Pick size/quality:     zero official generate image --prompt "A poster" --size 1024x1536 --quality high`
+});
+
+// src/commands/zero/official/generate/voice.ts
+init_esm_shims();
+
+// src/commands/zero/shared/voice-generate.ts
+init_esm_shims();
+import { readFileSync as readFileSync11 } from "fs";
+function readText(options, usageCommand) {
+  if (options.text?.trim()) {
+    return options.text.trim();
+  }
+  if (process.stdin.isTTY === false) {
+    const text = readFileSync11("/dev/stdin", "utf8").trim();
+    if (text.length > 0) {
+      return text;
+    }
+  }
+  throw new Error("--text is required", {
+    cause: new Error(`Usage: ${usageCommand} --text "Hello"`)
+  });
+}
+function createVoiceGenerateCommand(config) {
+  return new Command().name(config.name).description("Generate a billed speech audio file from text").option("--text <text>", "Text to speak; can also be piped via stdin").option("--voice <voice>", "OpenAI voice to use", "marin").option("--instructions <text>", "Voice style instructions").option("--json", "Print metadata as JSON").addHelpText(
+    "after",
+    `
+Examples:
+${config.examples}
+
+Output:
+  Prints the generated /f/ audio file URL and metadata
+
+Notes:
+  - Authenticates via ZERO_TOKEN (requires file:write capability)
+  - Charges org credits after successful audio generation
+  - Uses gpt-4o-mini-tts with WAV output`
+  ).action(
+    withErrorHandler(async (options) => {
+      const text = readText(options, config.usageCommand);
+      const result = await generateWebVoice({
+        text,
+        voice: options.voice,
+        instructions: options.instructions
+      });
+      if (options.json) {
+        console.log(JSON.stringify(result));
+        return;
+      }
+      console.log(source_default.green(`\u2713 Voice generated: ${result.url}`));
+      console.log(source_default.dim(`  File: ${result.filename}`));
+      console.log(source_default.dim(`  Duration: ${result.durationSeconds}s`));
+      console.log(source_default.dim(`  Credits charged: ${result.creditsCharged}`));
+      console.log(source_default.dim(`  Model: ${result.model}`));
+      console.log(source_default.dim(`  Voice: ${result.voice}`));
+    })
+  );
+}
+
+// src/commands/zero/official/generate/voice.ts
+var voiceCommand = createVoiceGenerateCommand({
+  name: "voice",
+  usageCommand: "zero official generate voice",
+  examples: `  Generate speech:       zero official generate voice --text "Hello from vm0"
+  Pipe text:             cat script.txt | zero official generate voice
+  Pick a voice:          zero official generate voice --text "Ship it" --voice cedar`
+});
+
+// src/commands/zero/official/generate/index.ts
+var generateCommand2 = new Command().name("generate").description("Generate assets with official Zero services").addCommand(imageCommand).addCommand(voiceCommand).addHelpText(
+  "after",
+  `
+Examples:
+  Generate image:   zero official generate image --prompt "A watercolor fox"
+  Generate speech:  zero official generate voice --text "Hello"`
+);
+
+// src/commands/zero/official/index.ts
+var zeroOfficialCommand = new Command().name("official").description("Use official Zero services").addCommand(generateCommand2).addHelpText(
+  "after",
+  `
+Examples:
+  Generate image:   zero official generate image --prompt "A watercolor fox"
+  Generate speech:  zero official generate voice --text "Hello"`
+);
+
 // src/commands/zero/web/index.ts
 init_esm_shims();
 
@@ -7177,67 +7377,13 @@ Notes:
   )
 );
 
-// src/commands/zero/web/voice.ts
-init_esm_shims();
-import { readFileSync as readFileSync10 } from "fs";
-function readText(options) {
-  if (options.text?.trim()) {
-    return options.text.trim();
-  }
-  if (process.stdin.isTTY === false) {
-    const text = readFileSync10("/dev/stdin", "utf8").trim();
-    if (text.length > 0) {
-      return text;
-    }
-  }
-  throw new Error("--text is required", {
-    cause: new Error('Usage: zero web voice --text "Hello"')
-  });
-}
-var voiceCommand = new Command().name("voice").description("Generate a billed speech audio file from text").option("--text <text>", "Text to speak; can also be piped via stdin").option("--voice <voice>", "OpenAI voice to use", "marin").option("--instructions <text>", "Voice style instructions").option("--json", "Print metadata as JSON").addHelpText(
-  "after",
-  `
-Examples:
-  Generate speech:       zero web voice --text "Hello from vm0"
-  Pipe text:             cat script.txt | zero web voice
-  Pick a voice:          zero web voice --text "Ship it" --voice cedar
-
-Output:
-  Prints the generated /f/ audio file URL and metadata
-
-Notes:
-  - Authenticates via ZERO_TOKEN (requires file:write capability)
-  - Charges org credits after successful audio generation
-  - Uses gpt-4o-mini-tts with WAV output`
-).action(
-  withErrorHandler(async (options) => {
-    const text = readText(options);
-    const result = await generateWebVoice({
-      text,
-      voice: options.voice,
-      instructions: options.instructions
-    });
-    if (options.json) {
-      console.log(JSON.stringify(result));
-      return;
-    }
-    console.log(source_default.green(`\u2713 Voice generated: ${result.url}`));
-    console.log(source_default.dim(`  File: ${result.filename}`));
-    console.log(source_default.dim(`  Duration: ${result.durationSeconds}s`));
-    console.log(source_default.dim(`  Credits charged: ${result.creditsCharged}`));
-    console.log(source_default.dim(`  Model: ${result.model}`));
-    console.log(source_default.dim(`  Voice: ${result.voice}`));
-  })
-);
-
 // src/commands/zero/web/index.ts
-var zeroWebCommand = new Command().name("web").description("Upload, download, and generate files via the web chat endpoint").addCommand(downloadFileCommand3).addCommand(voiceCommand).addCommand(uploadFileCommand3).addHelpText(
+var zeroWebCommand = new Command().name("web").description("Upload and download files via the web chat endpoint").addCommand(downloadFileCommand3).addCommand(uploadFileCommand3).addHelpText(
   "after",
   `
 Examples:
   Upload a file:    zero web upload-file -f /tmp/report.pdf
-  Download a file:  zero web download-file <file-id> -o /tmp/out.pdf
-  Generate speech:  zero web voice --text "Hello"`
+  Download a file:  zero web download-file <file-id> -o /tmp/out.pdf`
 );
 
 // src/zero.ts
@@ -7256,6 +7402,7 @@ var COMMAND_CAPABILITY_MAP = {
   whoami: null,
   "developer-support": null,
   "computer-use": "computer-use:write",
+  official: "file:write",
   web: null
 };
 var DEFAULT_COMMANDS = [
@@ -7277,6 +7424,7 @@ var DEFAULT_COMMANDS = [
   zeroSkillCommand,
   zeroDeveloperSupportCommand,
   zeroComputerUseCommand,
+  zeroOfficialCommand,
   zeroWebCommand
 ];
 function shouldHideCommand(name, payload) {
@@ -7302,7 +7450,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.142.1").addHelpText(
+).version("9.144.0").addHelpText(
   "after",
   `
 Examples:
@@ -7315,6 +7463,8 @@ Examples:
   Set up a schedule?     zero schedule setup --help
   Update yourself?       zero agent --help
   Manage custom skills?  zero skill --help
+  Generate image?        zero official generate image --help
+  Generate voice?        zero official generate voice --help
   Check your identity?   zero whoami`
 );
 if (process.argv[1]?.endsWith("zero.js") || process.argv[1]?.endsWith("zero.ts") || process.argv[1]?.endsWith("zero")) {