@erdoai/cli 0.138.1 → 0.139.0

package/dist/index.js

@@ -1730,6 +1730,9 @@ var ErdoClient = class {
   listHeartbeats() {
     return this.request("GET", "/v1/heartbeats");
   }
+  createHeartbeat(body) {
+    return this.request("POST", "/v1/heartbeats", body);
+  }
   runHeartbeat(id) {
     return this.request("POST", `/v1/heartbeats/${encodeURIComponent(id)}/run`, {});
   }
@@ -8887,10 +8890,51 @@ knowledgeAssetsCmd.command("list <objectId>").description("List files attached t
   }
 });
 var autoCmd = program.command("automations").description("Scheduled automations (heartbeats)");
+function heartbeatBounds(h) {
+  return `${h.run_at ? `	run_at:${h.run_at}` : ""}${h.ends_at ? `	ends_at:${h.ends_at}` : ""}`;
+}
+function scheduleBound(flag, v) {
+  if (v === void 0) return void 0;
+  const value = v.trim();
+  if (!/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(\.\d+)?(Z|[+-]\d{2}:\d{2})$/.test(value) || Number.isNaN(Date.parse(value))) {
+    throw new Error(`${flag} must be an RFC3339 timestamp such as 2026-10-19T09:00:00Z \u2014 got ${JSON.stringify(v)}`);
+  }
+  return value;
+}
+autoCmd.command("create <name>").description(
+  "Create an automation. Pass --run-at for one-off work at a date (it runs once, then stops for good) instead of a recurring automation that checks the date"
+).option("--description <text>", "What the automation does").option("--instructions <text>", "Instructions for each run (agent automation)").option("--script-js <js>", "Deterministic script body (scripted automation, no LLM)").option("--script-file <path>", "Read the script body from a file (scripted automation)").requiredOption("--interval <minutes>", "Interval in minutes (minimum 5)", (v) => parseInt(v, 10)).option("--timezone <tz>", "Scheduling timezone, e.g. America/New_York (default UTC)").option("--run-at <rfc3339>", "Run once at or after this instant, then stop permanently").option("--ends-at <rfc3339>", "Never run after this instant").addOption(new Option2("--agent-key <key>", "Executor for an agent automation").choices(["erdo.heartbeat-executor", "erdo.workflow-executor"])).addOption(new Option2("--conversation <target>", "Target 'new' (fresh thread) or 'direct' conversation").choices(["new", "direct"])).option("--thread-id <id>", "Post each run into an existing conversation UUID").option("--persona-id <id>", "Org-enabled persona UUID to speak as").action(
+  async (name, opts) => {
+    try {
+      if (opts.scriptJs && opts.scriptFile) {
+        fail(new Error("pass either --script-js or --script-file, not both"));
+        return;
+      }
+      const scriptJs = opts.scriptFile ? readFileSync4(opts.scriptFile, "utf8") : opts.scriptJs;
+      const h = await new ErdoClient().createHeartbeat({
+        name,
+        description: opts.description,
+        instructions: opts.instructions,
+        script_js: scriptJs,
+        interval_minutes: opts.interval,
+        timezone: opts.timezone,
+        run_at: scheduleBound("--run-at", opts.runAt),
+        ends_at: scheduleBound("--ends-at", opts.endsAt),
+        agent_key: opts.agentKey,
+        conversation: opts.conversation,
+        thread_id: opts.threadId,
+        persona_id: opts.personaId
+      });
+      console.log(`${h.id}	${h.state}	${h.name}${heartbeatBounds(h)}`);
+    } catch (e) {
+      fail(e);
+    }
+  }
+);
 autoCmd.command("list").description("List automations").action(async () => {
   try {
     const { heartbeats } = await new ErdoClient().listHeartbeats();
-    for (const h of heartbeats) console.log(`${h.id}	${h.state}	${h.name}	${h.kind === "script" ? "script" : h.thread_id ? `thread:${h.thread_id}` : h.conversation ?? "new"}${h.persona_id ? `	persona:${h.persona_id}` : ""}`);
+    for (const h of heartbeats) console.log(`${h.id}	${h.state}	${h.name}	${h.kind === "script" ? "script" : h.thread_id ? `thread:${h.thread_id}` : h.conversation ?? "new"}${h.persona_id ? `	persona:${h.persona_id}` : ""}${heartbeatBounds(h)}`);
   } catch (e) {
     fail(e);
   }
@@ -8916,7 +8960,7 @@ autoCmd.command("run <id>").description("Trigger an automation now").action(asyn
 autoCmd.command("update <id>").description("Edit an automation \u2014 rename, reschedule, or replace its script/instructions").option("--name <name>", "New name").option("--description <text>", "New description").option("--instructions <text>", "Replacement instructions (agent automation)").addOption(new Option2("--agent-key <key>", "Executor for an agent automation; omit to keep current").choices(["erdo.heartbeat-executor", "erdo.workflow-executor"])).option("--script-js <js>", "Replacement script body (scripted automation)").option(
   "--script-file <path>",
   "Read the replacement script body from a file (scripted automation)"
-).addOption(new Option2("--conversation <target>", "Target 'new' (fresh thread) or 'direct' conversation").choices(["new", "direct"])).option("--thread-id <id>", "Post each run into an existing conversation UUID").option("--persona-id <id>", "Org-enabled persona UUID to speak as").option("--interval <minutes>", "New interval in minutes (minimum 5)", (v) => parseInt(v, 10)).option("--timezone <tz>", "New scheduling timezone, e.g. America/New_York").action(
+).addOption(new Option2("--conversation <target>", "Target 'new' (fresh thread) or 'direct' conversation").choices(["new", "direct"])).option("--thread-id <id>", "Post each run into an existing conversation UUID").option("--persona-id <id>", "Org-enabled persona UUID to speak as").option("--interval <minutes>", "New interval in minutes (minimum 5)", (v) => parseInt(v, 10)).option("--timezone <tz>", "New scheduling timezone, e.g. America/New_York").option("--run-at <rfc3339>", "New one-off fire time: runs once at or after it, then stops permanently (omit to keep)").option("--ends-at <rfc3339>", "New end time after which it never runs (omit to keep)").action(
   async (id, opts) => {
     try {
       if (opts.scriptJs && opts.scriptFile) {
@@ -8932,6 +8976,8 @@ autoCmd.command("update <id>").description("Edit an automation \u2014 rename, re
         script_js: scriptJs,
         interval_minutes: opts.interval,
         timezone: opts.timezone,
+        run_at: scheduleBound("--run-at", opts.runAt),
+        ends_at: scheduleBound("--ends-at", opts.endsAt),
         conversation: opts.conversation,
         thread_id: opts.threadId,
         persona_id: opts.personaId
@@ -8941,7 +8987,7 @@ autoCmd.command("update <id>").description("Edit an automation \u2014 rename, re
         return;
       }
       const h = await new ErdoClient().updateHeartbeat(id, body);
-      console.log(`${h.id}	${h.state}	${h.name}`);
+      console.log(`${h.id}	${h.state}	${h.name}${heartbeatBounds(h)}`);
     } catch (e) {
       fail(e);
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@erdoai/cli",
-  "version": "0.138.1",
+  "version": "0.139.0",
   "description": "Erdo CLI \u2014 drive datasets, pages, and evals from the terminal or CI",
   "type": "module",
   "bin": {