@erdoai/cli 0.122.0 → 0.125.0

package/dist/index.js

@@ -1660,6 +1660,12 @@ var ErdoClient = class {
   runHeartbeat(id) {
     return this.request("POST", `/v1/heartbeats/${encodeURIComponent(id)}/run`, {});
   }
+  listHeartbeatExecutions(id, limit = 10) {
+    if (!Number.isInteger(limit) || limit < 1 || limit > 100) {
+      throw new Error("limit must be an integer between 1 and 100");
+    }
+    return this.request("GET", `/v1/heartbeats/${encodeURIComponent(id)}/executions?limit=${limit}`);
+  }
   updateHeartbeat(id, body) {
     return this.request(
       "PATCH",
@@ -1720,6 +1726,7 @@ var ErdoClient = class {
   // --- agent runs ---
   listAgentRuns(opts) {
     const params = new URLSearchParams();
+    if (opts.invocation) params.set("invocation_id", opts.invocation);
     if (opts.agent) params.set("agent_key", opts.agent);
     if (opts.thread) params.set("thread_id", opts.thread);
     if (opts.status) params.set("status", opts.status);
@@ -4190,7 +4197,7 @@ agentCmd.command("messages <threadId>").description("Show a thread's messages (r
   }
 });
 var runsCmd = program.command("runs").description("Inspect agent runs");
-runsCmd.command("list").description("List agent runs (filter by agent OR thread \u2014 mutually exclusive)").option("-a, --agent <key>", "filter by agent key").option("-t, --thread <id>", "filter to a thread").option("-s, --status <status>", "filter by status (running, completed, failed, cancelled, pending)").option("-l, --limit <n>", "max runs", (v) => parseInt(v, 10)).action(async (opts) => {
+runsCmd.command("list").description("List agent runs; select an exact invocation, optionally constrained by agent OR thread").option("--invocation <id>", "select the exact root run for an invocation").option("-a, --agent <key>", "filter by agent key").option("-t, --thread <id>", "filter to a thread").option("-s, --status <status>", "filter by status (running, completed, failed, cancelled, pending)").option("-l, --limit <n>", "max runs", (v) => parseInt(v, 10)).action(async (opts) => {
   try {
     const { runs } = await new ErdoClient().listAgentRuns(opts);
     for (const r of runs) console.log(`${r.id}	${r.status}	${r.agent_key}`);
@@ -8450,6 +8457,17 @@ autoCmd.command("list").description("List automations").action(async () => {
     fail(e);
   }
 });
+autoCmd.command("executions <id>").description("Read recent execution history for one automation or refresh job").option("--limit <n>", "Number of executions (integer 1\u2013100)", "10").action(async (id, opts) => {
+  try {
+    const limit = Number(opts.limit);
+    if (!/^\d+$/.test(opts.limit) || !Number.isInteger(limit) || limit < 1 || limit > 100) {
+      throw new Error("limit must be an integer between 1 and 100");
+    }
+    print(await new ErdoClient().listHeartbeatExecutions(id, limit));
+  } catch (e) {
+    fail(e);
+  }
+});
 autoCmd.command("run <id>").description("Trigger an automation now").action(async (id) => {
   try {
     print(await new ErdoClient().runHeartbeat(id));

package/package.json

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