@vm0/cli 9.219.0 → 9.220.0

package/{variable-3QU5KSPD.js → variable-UNXSGRUU.js}

@@ -10,7 +10,7 @@ import {
   deleteZeroVariable,
   listZeroVariables,
   setZeroVariable
-} from "./chunk-C3NCF7AC.js";
+} from "./chunk-PHLVIRTN.js";
 import {
   withErrorHandler
 } from "./chunk-3F4RFLPX.js";
@@ -117,4 +117,4 @@ var zeroVariableCommand = new Command().name("variable").description("Read or wr
 export {
   zeroVariableCommand
 };
-//# sourceMappingURL=variable-3QU5KSPD.js.map
+//# sourceMappingURL=variable-UNXSGRUU.js.map

package/{web-NUS7HONQ.js → web-NX3LRDTP.js}

@@ -2,7 +2,7 @@
 import { createRequire as __createRequire } from "node:module";
 const require = __createRequire(import.meta.url);
 import "./chunk-LTDQISD7.js";
-import "./chunk-C3NCF7AC.js";
+import "./chunk-PHLVIRTN.js";
 import {
   downloadWebFile,
   uploadWebFile,
@@ -106,4 +106,4 @@ Examples:
 export {
   zeroWebCommand
 };
-//# sourceMappingURL=web-NUS7HONQ.js.map
+//# sourceMappingURL=web-NX3LRDTP.js.map

package/{whoami-BVBVPCEX.js → whoami-W6ZRUGTN.js}

@@ -4,16 +4,16 @@ const require = __createRequire(import.meta.url);
 import {
   loadConnectorPermissionInfos,
   policyIcon
-} from "./chunk-NUCGXUQW.js";
+} from "./chunk-2WLLGU5G.js";
 import {
   permissionGrantsToFirewallPolicies
-} from "./chunk-UQBJX5J5.js";
+} from "./chunk-BDVHHGRQ.js";
 import "./chunk-LTDQISD7.js";
 import {
   getZeroAgentUserConnectors,
   listZeroConnectors,
   listZeroUserPermissionGrants
-} from "./chunk-C3NCF7AC.js";
+} from "./chunk-PHLVIRTN.js";
 import {
   getActiveOrg,
   getApiUrl,
@@ -192,4 +192,4 @@ Notes:
 export {
   zeroWhoamiCommand
 };
-//# sourceMappingURL=whoami-BVBVPCEX.js.map
+//# sourceMappingURL=whoami-W6ZRUGTN.js.map

package/{workflow-KFXYP54E.js → workflow-F2YOTCAJ.js}

@@ -27,7 +27,7 @@ import {
   listWorkflows,
   updateWorkflow,
   updateWorkflowTrigger
-} from "./chunk-C3NCF7AC.js";
+} from "./chunk-PHLVIRTN.js";
 import {
   withErrorHandler
 } from "./chunk-3F4RFLPX.js";
@@ -169,7 +169,56 @@ Notes:
 // src/commands/zero/workflow/edit.ts
 init_esm_shims();
 import { readFileSync as readFileSync3 } from "fs";
-var editCommand = new Command().name("edit").description("Update a workflow's instruction, files, or metadata").argument("<workflowId>", "Workflow ID").option("--instruction <text>", "New instruction text").option(
+
+// src/commands/zero/workflow/resolve-workflow-ref.ts
+init_esm_shims();
+var UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+var WORKFLOW_NAME_RE = /^[a-z0-9][a-z0-9-]*[a-z0-9]$/;
+function isWorkflowName(ref) {
+  return ref.length >= 2 && ref.length <= 64 && WORKFLOW_NAME_RE.test(ref);
+}
+async function resolveWorkflowRef(ref, options) {
+  if (UUID_RE.test(ref)) {
+    return ref;
+  }
+  if (!isWorkflowName(ref)) {
+    throw new Error(
+      `Invalid workflow ref: "${ref}". Use a workflow ID or a slug name like "tell-a-joke"`
+    );
+  }
+  const agentId = options.agent ?? process.env.ZERO_AGENT_ID;
+  if (!agentId) {
+    throw new Error(
+      "Workflow name refs require an agent scope. Pass --agent <agent-id>, set ZERO_AGENT_ID, or use a workflow ID"
+    );
+  }
+  if (!UUID_RE.test(agentId)) {
+    throw new Error(
+      `Invalid agent ID: "${agentId}". Pass an agent UUID for --agent or use a workflow ID`
+    );
+  }
+  const workflows = await listWorkflows({ agentId });
+  const matches = workflows.filter((workflow) => {
+    return workflow.name === ref;
+  });
+  if (matches.length === 0) {
+    throw new Error(
+      `Workflow not found: "${ref}" under agent "${agentId}". Check the name and agent, or use the workflow ID`
+    );
+  }
+  const winners = matches.filter((workflow) => {
+    return workflow.shadowedBy == null;
+  });
+  if (winners.length !== 1) {
+    throw new Error(
+      `Workflow name "${ref}" did not resolve to exactly one runtime winner under agent "${agentId}". Use the workflow ID`
+    );
+  }
+  return winners[0].id;
+}
+
+// src/commands/zero/workflow/edit.ts
+var editCommand = new Command().name("edit").description("Update a workflow's instruction, files, or metadata").argument("<workflow>", "Workflow ID or name").option("--agent <id>", "Agent ID for resolving workflow names").option("--instruction <text>", "New instruction text").option(
   "--instruction-file <path>",
   "Path to a file containing the instruction"
 ).option(
@@ -179,6 +228,7 @@ var editCommand = new Command().name("edit").description("Update a workflow's in
   "after",
   `
 Examples:
+  zero workflow edit tell-a-joke --agent <agent-id> --instruction "New steps"
   zero workflow edit <workflow-id> --instruction "New steps"
   zero workflow edit <workflow-id> --instruction-file ./instruction.md
   zero workflow edit <workflow-id> --dir ./workflows/my-workflow/files/
@@ -189,7 +239,7 @@ Notes:
   - At least one of --instruction, --instruction-file, --dir, --display-name, or --description is required`
 ).action(
   withErrorHandler(
-    async (workflowId, options) => {
+    async (workflowRef, options) => {
       if (options.instruction && options.instructionFile) {
         console.error(
           source_default.red("\u2717 Use either --instruction or --instruction-file")
@@ -208,6 +258,7 @@ Notes:
         );
         process.exit(1);
       }
+      const workflowId = await resolveWorkflowRef(workflowRef, options);
       const workflow = await updateWorkflow(workflowId, {
         instruction,
         files,
@@ -233,41 +284,45 @@ Notes:
 
 // src/commands/zero/workflow/view.ts
 init_esm_shims();
-var viewCommand = new Command().name("view").description("View a workflow").argument("<workflowId>", "Workflow ID").addHelpText(
+var viewCommand = new Command().name("view").description("View a workflow").argument("<workflow>", "Workflow ID or name").option("--agent <id>", "Agent ID for resolving workflow names").addHelpText(
   "after",
   `
 Examples:
+  zero workflow view tell-a-joke --agent <agent-id>
   zero workflow view <workflow-id>`
 ).action(
-  withErrorHandler(async (workflowId) => {
-    const workflow = await getWorkflow(workflowId);
-    console.log(source_default.bold(workflow.name));
-    if (workflow.displayName) console.log(source_default.dim(workflow.displayName));
-    console.log();
-    console.log(`ID:           ${workflow.id}`);
-    console.log(`Name:         ${workflow.name}`);
-    console.log(`Visibility:   ${workflow.visibility}`);
-    console.log(`Agent Name:   ${formatWorkflowAgentName(workflow)}`);
-    console.log(`Agent ID:     ${workflow.agentId}`);
-    if (workflow.displayName)
-      console.log(`Display Name: ${workflow.displayName}`);
-    if (workflow.description)
-      console.log(`Description:  ${workflow.description}`);
-    if (workflow.files && workflow.files.length > 0) {
+  withErrorHandler(
+    async (workflowRef, options) => {
+      const workflowId = await resolveWorkflowRef(workflowRef, options);
+      const workflow = await getWorkflow(workflowId);
+      console.log(source_default.bold(workflow.name));
+      if (workflow.displayName) console.log(source_default.dim(workflow.displayName));
       console.log();
-      console.log(source_default.dim("\u2500\u2500 Files \u2500\u2500"));
-      for (const f of workflow.files) {
-        console.log(`  ${f.path} (${f.size} bytes)`);
+      console.log(`ID:           ${workflow.id}`);
+      console.log(`Name:         ${workflow.name}`);
+      console.log(`Visibility:   ${workflow.visibility}`);
+      console.log(`Agent Name:   ${formatWorkflowAgentName(workflow)}`);
+      console.log(`Agent ID:     ${workflow.agentId}`);
+      if (workflow.displayName)
+        console.log(`Display Name: ${workflow.displayName}`);
+      if (workflow.description)
+        console.log(`Description:  ${workflow.description}`);
+      if (workflow.files && workflow.files.length > 0) {
+        console.log();
+        console.log(source_default.dim("\u2500\u2500 Files \u2500\u2500"));
+        for (const f of workflow.files) {
+          console.log(`  ${f.path} (${f.size} bytes)`);
+        }
+      }
+      console.log();
+      if (workflow.instruction) {
+        console.log(source_default.dim("\u2500\u2500 Instruction \u2500\u2500"));
+        console.log(workflow.instruction);
+      } else {
+        console.log(source_default.dim("No instruction"));
       }
     }
-    console.log();
-    if (workflow.instruction) {
-      console.log(source_default.dim("\u2500\u2500 Instruction \u2500\u2500"));
-      console.log(workflow.instruction);
-    } else {
-      console.log(source_default.dim("No instruction"));
-    }
-  })
+  )
 );
 
 // src/commands/zero/workflow/list.ts
@@ -339,46 +394,52 @@ Examples:
 
 // src/commands/zero/workflow/delete.ts
 init_esm_shims();
-var deleteCommand = new Command().name("delete").alias("rm").description("Delete a workflow").argument("<workflowId>", "Workflow ID").option("-y, --yes", "Skip confirmation prompt").addHelpText(
+var deleteCommand = new Command().name("delete").alias("rm").description("Delete a workflow").argument("<workflow>", "Workflow ID or name").option("--agent <id>", "Agent ID for resolving workflow names").option("-y, --yes", "Skip confirmation prompt").addHelpText(
   "after",
   `
 Examples:
+  zero workflow delete tell-a-joke --agent <agent-id> -y
   zero workflow delete <workflow-id>
   zero workflow delete <workflow-id> -y
 
 Notes:
   - Use -y to skip confirmation in non-interactive mode`
 ).action(
-  withErrorHandler(async (workflowId, options) => {
-    const workflow = await getWorkflow(workflowId);
-    if (!options.yes) {
-      if (!isInteractive()) {
-        throw new Error("--yes flag is required in non-interactive mode");
-      }
-      const confirmed = await promptConfirm(
-        `Delete workflow '${workflow.name}'?`,
-        false
-      );
-      if (!confirmed) {
-        console.log(source_default.dim("Cancelled"));
-        return;
+  withErrorHandler(
+    async (workflowRef, options) => {
+      const workflowId = await resolveWorkflowRef(workflowRef, options);
+      const workflow = await getWorkflow(workflowId);
+      if (!options.yes) {
+        if (!isInteractive()) {
+          throw new Error("--yes flag is required in non-interactive mode");
+        }
+        const confirmed = await promptConfirm(
+          `Delete workflow '${workflow.name}'?`,
+          false
+        );
+        if (!confirmed) {
+          console.log(source_default.dim("Cancelled"));
+          return;
+        }
       }
+      await deleteWorkflow(workflowId);
+      console.log(source_default.green(`\u2713 Workflow "${workflow.name}" deleted`));
     }
-    await deleteWorkflow(workflowId);
-    console.log(source_default.green(`\u2713 Workflow "${workflow.name}" deleted`));
-  })
+  )
 );
 
 // src/commands/zero/workflow/copy.ts
 init_esm_shims();
-var copyCommand = new Command().name("copy").description("Copy (fork) a workflow onto another agent").argument("<workflowId>", "Workflow ID to copy").requiredOption("--to-agent <agent-id>", "Target agent ID").addHelpText(
+var copyCommand = new Command().name("copy").description("Copy (fork) a workflow onto another agent").argument("<workflow>", "Workflow ID or name to copy").option("--agent <id>", "Agent ID for resolving workflow names").requiredOption("--to-agent <agent-id>", "Target agent ID").addHelpText(
   "after",
   `
 Examples:
-  zero workflow copy <workflow-id> --to-agent <agent-id>`
+  zero workflow copy tell-a-joke --agent <source-agent-id> --to-agent <target-agent-id>
+  zero workflow copy <workflow-id> --to-agent <target-agent-id>`
 ).action(
   withErrorHandler(
-    async (workflowId, options) => {
+    async (workflowRef, options) => {
+      const workflowId = await resolveWorkflowRef(workflowRef, options);
       const workflow = await copyWorkflow(workflowId, options.toAgent);
       console.log(source_default.green(`\u2713 Workflow "${workflow.name}" copied`));
       console.log(`  ID:           ${workflow.id}`);
@@ -826,7 +887,6 @@ function buildGmailLabelAppliedEventConfig(options) {
 }
 
 // src/commands/zero/workflow/trigger/index.ts
-var UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
 var SCHEDULE_KINDS = ["cron", "once", "loop"];
 var EVENT_KINDS = [
   "gmail-new-message",
@@ -1297,26 +1357,6 @@ function buildUpdate(options, existing) {
   }
   return buildScheduleUpdate(options);
 }
-async function resolveWorkflowId(ref, options) {
-  if (UUID_RE.test(ref)) {
-    return ref;
-  }
-  const agentId = options.agent ?? process.env.ZERO_AGENT_ID;
-  const workflows = await listWorkflows(agentId ? { agentId } : {});
-  const matches = workflows.filter((workflow) => {
-    return workflow.name === ref;
-  });
-  if (matches.length === 0) {
-    const hint = agentId ? ` under agent "${agentId}"` : ". Provide --agent <agent-id> or use the workflow ID";
-    throw new Error(`Workflow not found: "${ref}"${hint}`);
-  }
-  if (matches.length > 1) {
-    throw new Error(
-      `Ambiguous workflow name: "${ref}". Provide --agent <agent-id> or use the workflow ID`
-    );
-  }
-  return matches[0].id;
-}
 var addCommand = addGithubTriggerOptions(
   addGmailTriggerOptions(
     new Command().name("add").description("Add a trigger to a workflow").argument("<workflow>", "Workflow ID or name").argument("<kind>", `Trigger type: ${TRIGGER_KINDS.join(" | ")}`).option("--expr <expression>", 'Cron expression for kind "cron"').option("--at <iso-time>", 'Fire time for kind "once"').option(
@@ -1334,20 +1374,20 @@ var addCommand = addGithubTriggerOptions(
   "after",
   `
 Examples:
-  zero workflow trigger add tell-a-joke cron --expr "0 9 * * *" -z Asia/Shanghai
-  zero workflow trigger add tell-a-joke once --at "2026-06-10T09:00" -z Asia/Shanghai
-  zero workflow trigger add tell-a-joke loop --every 15m
-  zero workflow trigger add triage gmail-new-message --from-contains "@example.com"
-  zero workflow trigger add triage gmail-new-message --config ./gmail-trigger.json
-  zero workflow trigger add triage gmail-label-applied --label "Support"
-  zero workflow trigger add triage github-label-applied --label "triage" --subject both --actor me
-  zero workflow trigger add triage google-calendar-event-created
-  zero workflow trigger add triage google-calendar-event-updated
-  zero workflow trigger add triage google-calendar-event-cancelled
-  zero workflow trigger add triage webhook
+  zero workflow trigger add tell-a-joke --agent <agent-id> cron --expr "0 9 * * *" -z Asia/Shanghai
+  zero workflow trigger add tell-a-joke --agent <agent-id> once --at "2026-06-10T09:00" -z Asia/Shanghai
+  zero workflow trigger add tell-a-joke --agent <agent-id> loop --every 15m
+  zero workflow trigger add triage --agent <agent-id> gmail-new-message --from-contains "@example.com"
+  zero workflow trigger add triage --agent <agent-id> gmail-new-message --config ./gmail-trigger.json
+  zero workflow trigger add triage --agent <agent-id> gmail-label-applied --label "Support"
+  zero workflow trigger add triage --agent <agent-id> github-label-applied --label "triage" --subject both --actor me
+  zero workflow trigger add triage --agent <agent-id> google-calendar-event-created
+  zero workflow trigger add triage --agent <agent-id> google-calendar-event-updated
+  zero workflow trigger add triage --agent <agent-id> google-calendar-event-cancelled
+  zero workflow trigger add triage --agent <agent-id> webhook
 
 Notes:
-  - Workflow names resolve under --agent, then ZERO_AGENT_ID, then all visible workflows
+  - Workflow names resolve under --agent, then ZERO_AGENT_ID
   - Gmail triggers match all inbound messages when no text match rules are provided
   - GitHub label triggers require the GitHub App installation in the workspace
   - Webhook triggers print the signing secret only once after creation
@@ -1358,7 +1398,7 @@ Notes:
       if (options.timezone && kind !== "cron" && kind !== "once" && kind !== "gmail-new-message") {
         throw new Error("--timezone only applies to cron and once triggers");
       }
-      const workflowId = await resolveWorkflowId(workflowRef, options);
+      const workflowId = await resolveWorkflowRef(workflowRef, options);
       const body = buildCreateRequest(kind, options);
       const trigger = await createWorkflowTrigger(workflowId, body);
       console.log(
@@ -1400,12 +1440,12 @@ var listCommand2 = new Command().name("list").alias("ls").description("List a wo
   "after",
   `
 Examples:
-  zero workflow trigger list tell-a-joke
-  zero workflow trigger list tell-a-joke --agent <agent-id>`
+  zero workflow trigger list tell-a-joke --agent <agent-id>
+  zero workflow trigger list <workflow-id>`
 ).action(
   withErrorHandler(
     async (workflowRef, options) => {
-      const workflowId = await resolveWorkflowId(workflowRef, options);
+      const workflowId = await resolveWorkflowRef(workflowRef, options);
       const triggers = await listWorkflowTriggers(workflowId);
       if (triggers.length === 0) {
         console.log(source_default.dim("No triggers"));
@@ -1448,10 +1488,10 @@ var triggerCommand = new Command().name("trigger").description("Manage a workflo
   "after",
   `
 Examples:
-  Add a trigger:      zero workflow trigger add <workflow> cron --expr "0 9 * * *"
-  Add a webhook:      zero workflow trigger add <workflow> webhook
+  Add a trigger:      zero workflow trigger add <workflow-id> cron --expr "0 9 * * *"
+  Add a webhook:      zero workflow trigger add <workflow-id> webhook
   Update a schedule:  zero workflow trigger update <trigger-id> --every 10m
-  List triggers:      zero workflow trigger list <workflow>
+  List triggers:      zero workflow trigger list <workflow-id>
   Inspect a trigger:  zero workflow trigger show <trigger-id>
   Pause one trigger:  zero workflow trigger disable <trigger-id>`
 );
@@ -1463,13 +1503,13 @@ var zeroWorkflowCommand = new Command("workflow").description("Manage workflows"
 Examples:
   Create under an agent:   zero workflow create my-workflow --agent <agent-id> --instruction "Do things"
   List workflows:          zero workflow list
-  View workflow content:   zero workflow view <workflow-id>
-  Update workflow content: zero workflow edit <workflow-id> --instruction "New steps"
-  Copy onto another agent: zero workflow copy <workflow-id> --to-agent <agent-id>
+  View workflow content:   zero workflow view <workflow> --agent <agent-id>
+  Update workflow content: zero workflow edit <workflow> --agent <agent-id> --instruction "New steps"
+  Copy onto another agent: zero workflow copy <workflow> --agent <source-agent-id> --to-agent <target-agent-id>
   Manage triggers:         zero workflow trigger --help
-  Delete a workflow:       zero workflow delete <workflow-id> -y`
+  Delete a workflow:       zero workflow delete <workflow> --agent <agent-id> -y`
 );
 export {
   zeroWorkflowCommand
 };
-//# sourceMappingURL=workflow-KFXYP54E.js.map
+//# sourceMappingURL=workflow-F2YOTCAJ.js.map