@vm0/cli 9.142.0 → 9.143.0

package/package.json

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

package/zero.js

@@ -127,7 +127,7 @@ import {
   upsertZeroOrgModelProvider,
   withErrorHandler,
   zeroAgentCustomSkillNameSchema
-} from "./chunk-OD6W3UMZ.js";
+} from "./chunk-FEQSPUBX.js";
 import {
   __toESM,
   init_esm_shims
@@ -2192,6 +2192,18 @@ async function getPlatformOrigin() {
 
 // src/commands/zero/connector/status.ts
 var LABEL_WIDTH = 16;
+function getDoctorCommand(type) {
+  const [envName] = Object.keys(getConnectorEnvironmentMapping(type));
+  return envName ? `zero doctor check-connector --env-name ${envName}` : null;
+}
+function printDoctorHint(type) {
+  const command = getDoctorCommand(type);
+  if (command) {
+    console.log(`Diagnose it with: ${command}`);
+  } else {
+    console.log("Having trouble? Run: zero doctor --help");
+  }
+}
 var statusCommand2 = new Command().name("status").description("Show detailed status of a connector").argument("<type>", "Connector type (e.g., github)").option("--agent <id>", "Show authorization state for the given agent").action(
   withErrorHandler(async (type, options) => {
     const parseResult = connectorTypeSchema.safeParse(type);
@@ -2256,7 +2268,15 @@ var statusCommand2 = new Command().name("status").description("Show detailed sta
       const isConnected = connector !== null;
       const agentLabel = agentCtx.displayName === agentCtx.agentId ? agentCtx.agentId : `${agentCtx.displayName} (${agentCtx.agentId})`;
       console.log();
-      if (authorized) {
+      if (authorized && !isConnected) {
+        const origin = await getPlatformOrigin();
+        const url = `${origin}/connectors/${parseResult.data}/connect?agentId=${agentCtx.agentId}`;
+        console.log(
+          `The ${parseResult.data} connector is authorized for agent ${agentLabel}, but it is not connected.`
+        );
+        console.log(`Connect it at: [Connect ${parseResult.data}](${url})`);
+        printDoctorHint(parseResult.data);
+      } else if (authorized) {
         console.log(
           `The ${parseResult.data} connector is authorized for agent ${agentLabel}.`
         );
@@ -2267,6 +2287,7 @@ var statusCommand2 = new Command().name("status").description("Show detailed sta
           `The ${parseResult.data} connector is not connected. Once connected, it will be authorized for agent ${agentLabel}.`
         );
         console.log(`Connect it at: [Connect ${parseResult.data}](${url})`);
+        printDoctorHint(parseResult.data);
       } else {
         const origin = await getPlatformOrigin();
         const url = `${origin}/connectors/${parseResult.data}/authorize?agentId=${agentCtx.agentId}`;
@@ -2277,6 +2298,9 @@ var statusCommand2 = new Command().name("status").description("Show detailed sta
           `Authorize it at: [Authorize ${parseResult.data}](${url})`
         );
       }
+    } else if (!connector) {
+      console.log();
+      printDoctorHint(parseResult.data);
     }
   })
 );
@@ -2358,7 +2382,10 @@ async function checkConnectorStatus(ctx) {
   console.log("");
   if (!isConnected) {
     console.log(`The ${ctx.label} connector is not connected.`);
-    if (!ctx.agentId) {
+    if (ctx.agentId && hasPermission) {
+      const connectUrl = `${ctx.platformOrigin}/connectors/${ctx.connectorType}/connect?agentId=${ctx.agentId}`;
+      console.log(`Connect it at: [Connect ${ctx.label}](${connectUrl})`);
+    } else if (!ctx.agentId) {
       const connectUrl = `${ctx.platformOrigin}/connectors/${ctx.connectorType}/connect`;
       console.log(`Connect it at: [Connect ${ctx.label}](${connectUrl})`);
     }
@@ -2383,7 +2410,9 @@ async function checkConnectorStatus(ctx) {
       `Skipped \u2014 agent authorization can only be checked once the ${ctx.label} connector is reconnected (see 2a).`
     );
   } else if (hasPermission) {
-    console.log(`The ${ctx.label} connector is authorized for this agent.`);
+    console.log(
+      isConnected ? `The ${ctx.label} connector is authorized for this agent.` : `The ${ctx.label} connector is authorized for this agent, but it is not connected.`
+    );
   } else {
     const url = `${ctx.platformOrigin}/connectors/${ctx.connectorType}/authorize?agentId=${ctx.agentId}`;
     console.log(
@@ -2696,10 +2725,16 @@ How connectors work:
 
 // src/commands/zero/doctor/generate.ts
 init_esm_shims();
+var BUILT_IN_GENERATION_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",
@@ -2714,8 +2749,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)) {
@@ -2724,7 +2766,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) {
@@ -2845,6 +2887,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];
@@ -2865,6 +2914,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`);
@@ -2881,6 +2931,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(),
@@ -2894,7 +2945,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,
@@ -2918,10 +2969,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
@@ -5518,7 +5571,7 @@ function formatStatus(status) {
 function formatTime(iso) {
   return new Date(iso).toISOString().replace(/\.\d{3}Z$/, "Z");
 }
-var listCommand12 = new Command().name("list").alias("ls").description("List agent run logs").option("--agent <name>", "Filter by agent name").option(
+var listCommand12 = new Command().name("list").alias("ls").description("List agent run logs").option("--agent <id>", "Filter by Zero agent ID").option(
   "--status <status>",
   "Filter by status (queued|pending|running|completed|failed|timeout|cancelled)"
 ).option(
@@ -5529,7 +5582,7 @@ var listCommand12 = new Command().name("list").alias("ls").description("List age
   `
 Examples:
   zero logs list
-  zero logs list --agent my-agent
+  zero logs list --agent 123e4567-e89b-12d3-a456-426614174000
   zero logs list --status completed --limit 10
   zero logs list --since 1h
   zero logs list --since 1d --status completed`
@@ -5539,7 +5592,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
@@ -5685,7 +5738,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,
@@ -5703,17 +5756,20 @@ async function runLogsSearch(keyword, options) {
   }
   renderResults(response);
 }
-var searchCommand2 = new Command().name("search").description("Search agent events across runs").argument("<keyword>", "Search keyword").option("-A, --after-context <n>", "Show n events after each match").option("-B, --before-context <n>", "Show n events before each match").option("-C, --context <n>", "Show n events before and after each match").option("--agent <name>", "Filter by agent name").option("--run <id>", "Filter by specific run ID").option("--since <time>", "Search logs since (default: 7d)").option("--limit <n>", "Maximum number of matches (default: 20)").addHelpText(
+var searchCommand2 = new Command().name("search").description("Search agent events across runs").argument("<keyword>", "Search keyword").option("-A, --after-context <n>", "Show n events after each match").option("-B, --before-context <n>", "Show n events before each match").option("-C, --context <n>", "Show n events before and after each match").option("--agent <id>", "Filter by Zero agent ID").option("--run <id>", "Filter by specific run ID").option("--since <time>", "Search logs since (default: 7d)").option("--limit <n>", "Maximum number of matches (default: 20)").addHelpText(
   "after",
   `
 Examples:
   zero logs search "error"
-  zero logs search "timeout" --agent my-agent -C 2
+  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
@@ -5891,7 +5947,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
@@ -5943,7 +5999,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,
@@ -5968,7 +6024,7 @@ var zeroSearchCommand = new Command().name("search").description("Search logs, c
   "Source to search: logs | chat | slack (pass once)",
   collectSource,
   []
-).option("--agent <name>", "Filter by agent 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) {
@@ -7071,6 +7127,93 @@ 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/voice.ts
+init_esm_shims();
+
+// src/commands/zero/shared/voice-generate.ts
+init_esm_shims();
+import { readFileSync as readFileSync10 } from "fs";
+function readText(options, usageCommand) {
+  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: ${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(voiceCommand).addHelpText(
+  "after",
+  `
+Examples:
+  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 speech:  zero official generate voice --text "Hello"`
+);
+
 // src/commands/zero/web/index.ts
 init_esm_shims();
 
@@ -7148,67 +7291,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
@@ -7227,6 +7316,7 @@ var COMMAND_CAPABILITY_MAP = {
   whoami: null,
   "developer-support": null,
   "computer-use": "computer-use:write",
+  official: "file:write",
   web: null
 };
 var DEFAULT_COMMANDS = [
@@ -7248,6 +7338,7 @@ var DEFAULT_COMMANDS = [
   zeroSkillCommand,
   zeroDeveloperSupportCommand,
   zeroComputerUseCommand,
+  zeroOfficialCommand,
   zeroWebCommand
 ];
 function shouldHideCommand(name, payload) {
@@ -7273,7 +7364,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.0").addHelpText(
+).version("9.143.0").addHelpText(
   "after",
   `
 Examples:
@@ -7286,6 +7377,7 @@ Examples:
   Set up a schedule?     zero schedule setup --help
   Update yourself?       zero agent --help
   Manage custom skills?  zero skill --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")) {