@vm0/cli 9.200.4 → 9.201.0

package/zero.js

@@ -35,12 +35,14 @@ import {
   createGithubLabelListener,
   createGoal,
   createWorkflow,
+  createWorkflowTrigger,
   createZeroAgent,
   createZeroCreditCheckout,
   decodeZeroTokenPayload,
   deleteAutomation,
   deleteGithubLabelListener,
   deleteWorkflow,
+  deleteWorkflowTrigger,
   deleteZeroAgent,
   deleteZeroOrg,
   deleteZeroOrgModelProvider,
@@ -50,6 +52,7 @@ import {
   deleteZeroVariable,
   disableAutomation,
   disableAutomationTrigger,
+  disableWorkflowTrigger,
   downloadGithubFile,
   downloadPhoneFile,
   downloadSlackFile,
@@ -58,6 +61,7 @@ import {
   editGoal,
   enableAutomation,
   enableAutomationTrigger,
+  enableWorkflowTrigger,
   extractSecretNamesFromApis,
   fetchComputerUseScreenshot,
   findColorSystem,
@@ -93,6 +97,7 @@ import {
   getToken,
   getVm0ModelMultiplier,
   getWorkflow,
+  getWorkflowTrigger,
   getZeroAgent,
   getZeroAgentInstructions,
   getZeroAgentUserConnectors,
@@ -122,6 +127,7 @@ import {
   listTelegramBots,
   listTemplates,
   listVideoTemplates,
+  listWorkflowTriggers,
   listWorkflows,
   listZeroAgents,
   listZeroConnectors,
@@ -154,6 +160,7 @@ import {
   rotateAutomationTriggerSecret,
   runAutomation,
   runWorkflow,
+  runWorkflowTrigger,
   saveConfig,
   searchZeroChat,
   searchZeroConnectors,
@@ -178,6 +185,7 @@ import {
   updateAutomationTrigger,
   updateGithubLabelListener,
   updateWorkflow,
+  updateWorkflowTrigger,
   updateZeroAgent,
   updateZeroAgentInstructions,
   updateZeroOrg,
@@ -185,7 +193,7 @@ import {
   uploadWebFile,
   upsertZeroOrgModelProvider,
   withErrorHandler
-} from "./chunk-IMHXYYPH.js";
+} from "./chunk-M5DCFTDG.js";
 import "./chunk-NR42YJMI.js";
 import {
   __toESM,
@@ -5909,8 +5917,373 @@ Examples:
   })
 );
 
+// src/commands/zero/workflow/trigger/index.ts
+init_esm_shims();
+
+// src/commands/zero/workflow/trigger/display.ts
+init_esm_shims();
+function formatWorkflowTriggerSchedule(trigger) {
+  const { schedule } = trigger;
+  switch (schedule.type) {
+    case "cron":
+      return `${schedule.cronExpression} (${schedule.timezone})`;
+    case "once":
+      return `at ${schedule.atTime} (${schedule.timezone})`;
+    case "loop":
+      return `every ${formatDurationSeconds(schedule.intervalSeconds)}`;
+  }
+}
+function formatRunTime(value) {
+  return value ? formatRelativeTime(value) : source_default.dim("-");
+}
+function printWorkflowTriggersTable(triggers) {
+  const idWidth = Math.max(
+    2,
+    ...triggers.map((trigger) => {
+      return trigger.id.length;
+    })
+  );
+  const scheduleWidth = Math.max(
+    8,
+    ...triggers.map((trigger) => {
+      return formatWorkflowTriggerSchedule(trigger).length;
+    })
+  );
+  console.log(
+    source_default.dim(
+      [
+        "ID".padEnd(idWidth),
+        "STATUS".padEnd(8),
+        "SCHEDULE".padEnd(scheduleWidth),
+        "NEXT RUN"
+      ].join("  ")
+    )
+  );
+  for (const trigger of triggers) {
+    const status = trigger.enabled ? source_default.green("enabled") : source_default.yellow("disabled");
+    console.log(
+      [
+        trigger.id.padEnd(idWidth),
+        status.padEnd(8 + (trigger.enabled ? 0 : 2)),
+        formatWorkflowTriggerSchedule(trigger).padEnd(scheduleWidth),
+        formatRunTime(trigger.nextRunAt)
+      ].join("  ")
+    );
+  }
+}
+function printWorkflowTriggerDetails(trigger, options) {
+  const status = trigger.enabled ? source_default.green("enabled") : source_default.yellow("disabled");
+  console.log(`${"Kind:".padEnd(14)}${trigger.kind}`);
+  console.log(`${"ID:".padEnd(14)}${trigger.id}`);
+  if (options?.workflowRef) {
+    console.log(`${"Workflow:".padEnd(14)}${options.workflowRef}`);
+  }
+  console.log(`${"Status:".padEnd(14)}${status}`);
+  console.log(
+    `${"Schedule:".padEnd(14)}${formatWorkflowTriggerSchedule(trigger)}`
+  );
+  console.log(`${"Owner:".padEnd(14)}${trigger.ownerUserId}`);
+  console.log(
+    `${"Chat thread:".padEnd(14)}${trigger.chatThreadId ?? source_default.dim("-")}`
+  );
+  console.log(`${"Next run:".padEnd(14)}${formatRunTime(trigger.nextRunAt)}`);
+  console.log(`${"Last run:".padEnd(14)}${formatRunTime(trigger.lastRunAt)}`);
+}
+
+// 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 EXACTLY_ONE_FLAG_MESSAGE2 = "Provide exactly one of --expr (cron), --at (once), --every (loop)";
+function timezoneOrUtc(timezone) {
+  return timezone ?? "UTC";
+}
+function assertValidTimezone(timezone) {
+  new Intl.DateTimeFormat("en-US", { timeZone: timezone });
+}
+function hasExplicitOffset(value) {
+  return /(?:Z|[+-]\d{2}:?\d{2})$/i.test(value);
+}
+function parseLocalDateTime(value) {
+  const match = value.match(
+    /^(\d{4})-(\d{2})-(\d{2})T(\d{2}):(\d{2})(?::(\d{2})(?:\.(\d{1,3}))?)?$/
+  );
+  if (!match) {
+    throw new Error(
+      `Invalid at time: "${value}". Use ISO datetime, e.g. 2026-06-10T09:00 or 2026-06-10T09:00:00Z`
+    );
+  }
+  return {
+    year: Number(match[1]),
+    month: Number(match[2]),
+    day: Number(match[3]),
+    hour: Number(match[4]),
+    minute: Number(match[5]),
+    second: match[6] ? Number(match[6]) : 0,
+    millisecond: match[7] ? Number(match[7].padEnd(3, "0")) : 0
+  };
+}
+function zonedParts(instant, timezone) {
+  const parts = new Intl.DateTimeFormat("en-US", {
+    timeZone: timezone,
+    year: "numeric",
+    month: "2-digit",
+    day: "2-digit",
+    hour: "2-digit",
+    minute: "2-digit",
+    second: "2-digit",
+    hourCycle: "h23"
+  }).formatToParts(instant);
+  const values = /* @__PURE__ */ new Map();
+  for (const part of parts) {
+    if (part.type !== "literal") {
+      values.set(part.type, part.value);
+    }
+  }
+  return {
+    year: Number(values.get("year")),
+    month: Number(values.get("month")),
+    day: Number(values.get("day")),
+    hour: Number(values.get("hour")),
+    minute: Number(values.get("minute")),
+    second: Number(values.get("second"))
+  };
+}
+function wallTimeToUtcIso(value, timezone) {
+  assertValidTimezone(timezone);
+  if (hasExplicitOffset(value)) {
+    const instant = new Date(value);
+    if (Number.isNaN(instant.getTime())) {
+      throw new Error(`Invalid at time: "${value}"`);
+    }
+    return instant.toISOString();
+  }
+  const target = parseLocalDateTime(value);
+  const targetUtc = Date.UTC(
+    target.year,
+    target.month - 1,
+    target.day,
+    target.hour,
+    target.minute,
+    target.second,
+    target.millisecond
+  );
+  let guess = targetUtc;
+  for (let i = 0; i < 3; i++) {
+    const parts = zonedParts(new Date(guess), timezone);
+    const renderedUtc = Date.UTC(
+      parts.year,
+      parts.month - 1,
+      parts.day,
+      parts.hour,
+      parts.minute,
+      parts.second,
+      target.millisecond
+    );
+    guess += targetUtc - renderedUtc;
+  }
+  const result = new Date(guess);
+  const rendered = zonedParts(result, timezone);
+  if (rendered.year !== target.year || rendered.month !== target.month || rendered.day !== target.day || rendered.hour !== target.hour || rendered.minute !== target.minute || rendered.second !== target.second) {
+    throw new Error(
+      `Invalid at time for ${timezone}: "${value}". The local time does not exist`
+    );
+  }
+  return result.toISOString();
+}
+function buildSchedule(kind, options) {
+  switch (kind) {
+    case "cron":
+      if (!options.expr) {
+        throw new Error(
+          'cron triggers require --expr (e.g. --expr "0 9 * * *")'
+        );
+      }
+      return {
+        type: "cron",
+        cronExpression: options.expr,
+        timezone: timezoneOrUtc(options.timezone)
+      };
+    case "once": {
+      if (!options.at) {
+        throw new Error(
+          'once triggers require --at (e.g. --at "2026-06-10T09:00")'
+        );
+      }
+      const timezone = timezoneOrUtc(options.timezone);
+      return {
+        type: "once",
+        atTime: wallTimeToUtcIso(options.at, timezone),
+        timezone
+      };
+    }
+    case "loop":
+      if (!options.every) {
+        throw new Error("loop triggers require --every (e.g. --every 15m)");
+      }
+      return {
+        type: "loop",
+        intervalSeconds: parseDurationSeconds(options.every)
+      };
+    default:
+      throw new Error(
+        `Unknown trigger kind: "${kind}". Use one of: ${SCHEDULE_KINDS.join(", ")}`
+      );
+  }
+}
+function buildUpdate2(options) {
+  const flagCount = [options.expr, options.at, options.every].filter(
+    (value) => {
+      return value !== void 0;
+    }
+  ).length;
+  if (flagCount !== 1) {
+    throw new Error(EXACTLY_ONE_FLAG_MESSAGE2);
+  }
+  if (options.timezone && !options.expr && !options.at) {
+    throw new Error("--timezone only applies to --expr and --at");
+  }
+  if (options.expr) {
+    return { schedule: buildSchedule("cron", options) };
+  }
+  if (options.at) {
+    return { schedule: buildSchedule("once", options) };
+  }
+  return { schedule: buildSchedule("loop", 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 addCommand2 = new Command().name("add").description("Add a schedule trigger to a workflow").argument("<workflow>", "Workflow ID or name").argument("<kind>", `Trigger kind: ${SCHEDULE_KINDS.join(" | ")}`).option("--expr <expression>", 'Cron expression for kind "cron"').option("--at <iso-time>", 'Fire time for kind "once"').option("--every <duration>", 'Interval for kind "loop" (e.g. 15m, 1h, 90s)').option("-z, --timezone <tz>", "IANA timezone for cron/once (default: UTC)").option("--agent <id>", "Agent ID for resolving a workflow name").addHelpText(
+  "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
+
+Notes:
+  - Workflow names resolve under --agent, then ZERO_AGENT_ID, then all visible workflows
+  - Use the workflow ID when a name is ambiguous`
+).action(
+  withErrorHandler(
+    async (workflowRef, kind, options) => {
+      if (options.timezone && kind !== "cron" && kind !== "once") {
+        throw new Error("--timezone only applies to cron and once triggers");
+      }
+      const workflowId = await resolveWorkflowId(workflowRef, options);
+      const body = {
+        schedule: buildSchedule(kind, options)
+      };
+      const trigger = await createWorkflowTrigger(workflowId, body);
+      console.log(
+        source_default.green(`\u2713 Trigger added to workflow "${workflowRef}"`)
+      );
+      printWorkflowTriggerDetails(trigger, { workflowRef });
+    }
+  )
+);
+var updateCommand4 = new Command().name("update").description("Replace a workflow trigger's schedule").argument("<trigger>", "Workflow trigger ID").option("--expr <expression>", 'New cron schedule (e.g. "0 9 * * *")').option("--at <iso-time>", 'New one-time fire (e.g. "2026-06-10T09:00")').option("--every <duration>", "New loop interval (e.g. 15m, 1h, 90s)").option("-z, --timezone <tz>", "IANA timezone for --expr / --at").addHelpText(
+  "after",
+  `
+Examples:
+  zero workflow trigger update 22222222-2222-4222-8222-222222222222 --expr "0 9 * * *" -z Asia/Shanghai
+  zero workflow trigger update 22222222-2222-4222-8222-222222222222 --at "2026-06-10T09:00" -z UTC
+  zero workflow trigger update 22222222-2222-4222-8222-222222222222 --every 10m`
+).action(
+  withErrorHandler(async (id, options) => {
+    const trigger = await updateWorkflowTrigger(id, buildUpdate2(options));
+    console.log(source_default.green(`\u2713 Trigger ${trigger.id} updated`));
+    printWorkflowTriggerDetails(trigger);
+  })
+);
+var listCommand14 = new Command().name("list").alias("ls").description("List a workflow's schedule triggers").argument("<workflow>", "Workflow ID or name").option("--agent <id>", "Agent ID for resolving a workflow name").addHelpText(
+  "after",
+  `
+Examples:
+  zero workflow trigger list tell-a-joke
+  zero workflow trigger list tell-a-joke --agent <agent-id>`
+).action(
+  withErrorHandler(
+    async (workflowRef, options) => {
+      const workflowId = await resolveWorkflowId(workflowRef, options);
+      const triggers = await listWorkflowTriggers(workflowId);
+      if (triggers.length === 0) {
+        console.log(source_default.dim("No triggers"));
+        console.log(
+          source_default.dim(
+            `  Add one with: zero workflow trigger add ${workflowRef} cron --expr "0 9 * * *"`
+          )
+        );
+        return;
+      }
+      printWorkflowTriggersTable(triggers);
+    }
+  )
+);
+var showCommand3 = new Command().name("show").description("Show a workflow trigger").argument("<trigger>", "Workflow trigger ID").action(
+  withErrorHandler(async (id) => {
+    const trigger = await getWorkflowTrigger(id);
+    printWorkflowTriggerDetails(trigger);
+  })
+);
+var rmCommand2 = new Command().name("rm").alias("remove").description("Remove a workflow trigger").argument("<trigger>", "Workflow trigger ID").action(
+  withErrorHandler(async (id) => {
+    await deleteWorkflowTrigger(id);
+    console.log(source_default.green(`\u2713 Trigger ${id} removed`));
+  })
+);
+var enableCommand3 = new Command().name("enable").description("Enable a workflow trigger").argument("<trigger>", "Workflow trigger ID").action(
+  withErrorHandler(async (id) => {
+    const trigger = await enableWorkflowTrigger(id);
+    console.log(source_default.green(`\u2713 Trigger ${trigger.id} enabled`));
+  })
+);
+var disableCommand3 = new Command().name("disable").description("Disable a workflow trigger").argument("<trigger>", "Workflow trigger ID").action(
+  withErrorHandler(async (id) => {
+    const trigger = await disableWorkflowTrigger(id);
+    console.log(source_default.green(`\u2713 Trigger ${trigger.id} disabled`));
+  })
+);
+var runCommand3 = new Command().name("run").description("Fire a workflow trigger test run").argument("<trigger>", "Workflow trigger ID").action(
+  withErrorHandler(async (id) => {
+    const result = await runWorkflowTrigger(id);
+    console.log(source_default.green(`\u2713 Workflow trigger ${id} run started`));
+    console.log(`  Run ID:        ${result.runId}`);
+    console.log();
+    console.log(`Stream logs: zero logs ${result.runId}`);
+  })
+);
+var triggerCommand2 = new Command().name("trigger").description("Manage a workflow's schedule triggers").addCommand(addCommand2).addCommand(updateCommand4).addCommand(listCommand14).addCommand(showCommand3).addCommand(rmCommand2).addCommand(enableCommand3).addCommand(disableCommand3).addCommand(runCommand3).addHelpText(
+  "after",
+  `
+Examples:
+  Add a trigger:      zero workflow trigger add <workflow> cron --expr "0 9 * * *"
+  Update a schedule:  zero workflow trigger update <trigger-id> --every 10m
+  List triggers:      zero workflow trigger list <workflow>
+  Inspect a trigger:  zero workflow trigger show <trigger-id>
+  Test run:           zero workflow trigger run <trigger-id>
+  Pause one trigger:  zero workflow trigger disable <trigger-id>`
+);
+
 // src/commands/zero/workflow/index.ts
-var zeroWorkflowCommand = new Command("workflow").description("Manage workflows").addCommand(createCommand4).addCommand(editCommand2).addCommand(viewCommand2).addCommand(listCommand13).addCommand(deleteCommand7).addCommand(copyCommand).addCommand(runCommand2).addHelpText(
+var zeroWorkflowCommand = new Command("workflow").description("Manage workflows").addCommand(createCommand4).addCommand(editCommand2).addCommand(viewCommand2).addCommand(listCommand13).addCommand(deleteCommand7).addCommand(copyCommand).addCommand(runCommand2).addCommand(triggerCommand2).addHelpText(
   "after",
   `
 Examples:
@@ -5920,6 +6293,7 @@ Examples:
   Update workflow content: zero workflow edit <workflow-id> --instruction "New steps"
   Copy onto another agent: zero workflow copy <workflow-id> --to-agent <agent-id>
   Run a workflow once:     zero workflow run <workflow-id>
+  Manage triggers:         zero workflow trigger --help
   Delete a workflow:       zero workflow delete <workflow-id> -y`
 );
 
@@ -6007,7 +6381,7 @@ function formatStatus(status) {
 function formatTime(iso) {
   return new Date(iso).toISOString().replace(/\.\d{3}Z$/, "Z");
 }
-var listCommand14 = new Command().name("list").alias("ls").description("List agent run logs").option("--agent <id>", "Filter by Zero agent ID").option(
+var listCommand15 = 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(
@@ -6253,7 +6627,7 @@ async function showAgentEvents(runId, options) {
     renderer.render(parsed);
   }
 }
-var zeroLogsCommand = new Command().name("logs").description("View and search agent run logs").argument("[runId]", "Run ID to view agent events for").addCommand(listCommand14).addCommand(searchCommand2).option(
+var zeroLogsCommand = new Command().name("logs").description("View and search agent run logs").argument("[runId]", "Run ID to view agent events for").addCommand(listCommand15).addCommand(searchCommand2).option(
   "--since <time>",
   "Show logs since timestamp (e.g., 5m, 2h, 1d, 2024-01-15T10:30:00Z)"
 ).option("--tail <n>", "Show last N entries (default: 5)").option("--head <n>", "Show first N entries").option("--all", "Fetch all log entries").addHelpText(
@@ -10504,7 +10878,7 @@ function getModelSwitchGuidance(integration = getCurrentIntegration()) {
   }
   return "Open https://app.vm0.ai and switch models from the model selector next to the input box.";
 }
-var listCommand15 = new Command().name("list").alias("ls").description("List models allowed by the current organization").action(
+var listCommand16 = new Command().name("list").alias("ls").description("List models allowed by the current organization").action(
   withErrorHandler(async () => {
     const result = await listZeroModelPolicies();
     if (result.policies.length === 0) {
@@ -10540,7 +10914,7 @@ var listCommand15 = new Command().name("list").alias("ls").description("List mod
 var switchCommand = new Command().name("switch").description("Show how to switch models in the current environment").action(() => {
   console.log(getModelSwitchGuidance());
 });
-var zeroModelCommand = new Command().name("model").description("List available models and model-switching guidance").addCommand(listCommand15).addCommand(switchCommand);
+var zeroModelCommand = new Command().name("model").description("List available models and model-switching guidance").addCommand(listCommand16).addCommand(switchCommand);
 
 // src/commands/zero/model-provider/index.ts
 init_esm_shims();
@@ -10551,7 +10925,7 @@ var MODEL_PROVIDER_SET_GUIDANCE = [
   "",
   "If an organization admin sets a model provider to subscription, members must use the bottom-left user menu, choose Preferences / Personal Models, and connect their personal subscription."
 ].join("\n");
-var listCommand16 = new Command().name("list").alias("ls").description(
+var listCommand17 = new Command().name("list").alias("ls").description(
   "List provider routing for each model allowed by the organization"
 ).action(
   withErrorHandler(async () => {
@@ -10586,7 +10960,7 @@ var setCommand6 = new Command().name("set").description("Show where to adjust mo
 ${MODEL_PROVIDER_SET_GUIDANCE}`).action(() => {
   console.log(MODEL_PROVIDER_SET_GUIDANCE);
 });
-var zeroModelProviderCommand = new Command().name("model-provider").description("Inspect model provider routing").addCommand(listCommand16).addCommand(setCommand6);
+var zeroModelProviderCommand = new Command().name("model-provider").description("Inspect model provider routing").addCommand(listCommand17).addCommand(setCommand6);
 
 // src/commands/zero/video/index.ts
 init_esm_shims();
@@ -11043,7 +11417,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.200.4").addHelpText("after", () => {
+).version("9.201.0").addHelpText("after", () => {
   return buildZeroHelpText();
 });
 if (process.argv[1]?.endsWith("zero.js") || process.argv[1]?.endsWith("zero.ts") || process.argv[1]?.endsWith("zero")) {