@erdoai/cli 0.138.1 → 0.139.1

package/dist/index.js

@@ -1223,6 +1223,9 @@ var ErdoClient = class {
   getDatasetDeclaredSchema(slug) {
     return this.request("POST", `/v1/datasets/${encodeURIComponent(slug)}/fetch`, { view: "declared_schema" });
   }
+  getDatasetResourceSchema(slug) {
+    return this.request("POST", `/v1/datasets/${encodeURIComponent(slug)}/fetch`, { view: "resource_schema" });
+  }
   // Create an empty dataset with its declared columns. The server refuses a
   // create without a schema unless the purpose's columns are platform-defined.
   createDataset(input) {
@@ -1730,6 +1733,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`, {});
   }
@@ -7278,7 +7284,7 @@ Read one with: erdo datasets fetch ${res.dataset_slug} --revision <id> --sql "SE
   }
 });
 datasetsCmd.command("schema <slug>").alias("describe").description(
-  "Show physical columns by default, or the declared write contract with --declared. Physical columns are the names and types you can reference in `datasets fetch --sql`, read from the stored `data` table itself (DuckDB DESCRIBE) so they are what is actually there, not what was declared. For a database or warehouse dataset, DESCRIBE its real table names instead: `datasets fetch <slug> --sql 'DESCRIBE <table>'`."
+  "Show physical columns by default, or the declared write contract with --declared. File datasets read the stored `data` table; integration datasets show their discovered resource tables and columns. For an integration dataset, choose a resource/table explicitly when fetching: `datasets fetch <slug> --sql 'SELECT * FROM <table>'`."
 ).option("--json", "print the raw JSON result instead of a table").option("--declared", "read the declared write contract (column names, type hints, required flags, semantic roles) instead of the physical columns").action(async (slug, opts) => {
   try {
     const client = new ErdoClient();
@@ -7307,7 +7313,35 @@ datasetsCmd.command("schema <slug>").alias("describe").description(
       );
       return;
     }
-    const res = await client.fetchDatasetContents(slug, { sql_query: "DESCRIBE data" });
+    const res = await client.getDatasetResourceSchema(slug);
+    if (!res || typeof res !== "object" || res.view !== "resource_schema")
+      throw new Error("Invalid dataset schema response: the server did not answer the resource_schema view");
+    if (res.schema_provenance === "resource_catalog") {
+      const resources = res.resources ?? [];
+      if (!Array.isArray(resources) || resources.some((resource) => !resource || !Array.isArray(resource.columns)))
+        throw new Error("Invalid dataset schema response: malformed resource catalog");
+      if (opts.json) {
+        print(res);
+        return;
+      }
+      if (!resources.length) {
+        console.log(`${slug} has no discovered integration resources yet.`);
+        return;
+      }
+      const rows = resources.flatMap(
+        (resource) => resource.columns.length ? resource.columns.map((column) => [
+          resource.table_name || resource.key || resource.name,
+          column.name,
+          column.type || ""
+        ]) : [[resource.table_name || resource.key || resource.name, "", "(columns unavailable)"]]
+      );
+      printAlignedTable(["table", "column", "type"], rows);
+      console.log(`
+Fetch a selected table with: erdo datasets fetch ${slug} --sql "SELECT * FROM <table>"`);
+      return;
+    }
+    if (res.schema_provenance !== "dataset_storage" || !Array.isArray(res.columns) || !Array.isArray(res.rows))
+      throw new Error("Invalid dataset schema response: malformed physical schema");
     if (opts.json) {
       print(res);
       return;
@@ -8887,10 +8921,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 +8991,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 +9007,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 +9018,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.1",
   "description": "Erdo CLI \u2014 drive datasets, pages, and evals from the terminal or CI",
   "type": "module",
   "bin": {