@erdoai/cli 0.121.0 → 0.124.0

package/dist/index.js

@@ -186,7 +186,7 @@ async function rawRequest(baseURL, token, orgId, projectId, method, path, body,
         continue;
       }
       if (!retryNetworkFailures) {
-        throw new ErdoNetworkError(`${netErr.message}. The launch may have started; inspect agent runs before retrying.`, netErr);
+        throw new ErdoNetworkError(`${netErr.message}. The request may have succeeded; inspect the affected resource before retrying.`, netErr);
       }
       throw netErr;
     }
@@ -1200,6 +1200,12 @@ var ErdoClient = class {
   updateDatasetSchema(slug, input) {
     return this.request("POST", `/v1/datasets/${encodeURIComponent(slug)}/schema`, input);
   }
+  // Dataset row writes are deliberately never replayed after a network
+  // failure: the server may have committed the rows before the response was
+  // lost, and repeating an append or upsert can change the result.
+  writeDatasetRows(slug, input) {
+    return this.request("POST", `/v1/datasets/${encodeURIComponent(slug)}/rows`, input, false);
+  }
   // The endpoint's field is `question` (QueryDataNaturalLanguageInput). Sending  // The endpoint's field is `question` (QueryDataNaturalLanguageInput). Sending
   // `query` made every `erdo datasets query` fail with "question is required".
   //
@@ -1714,6 +1720,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);
@@ -4184,7 +4191,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}`);
@@ -4192,13 +4199,13 @@ runsCmd.command("list").description("List agent runs (filter by agent OR thread
     fail(e);
   }
 });
-runsCmd.command("get <id>").description("Show an agent run (status, output, trace metadata)").option("--resources", "also show the skills, knowledge and entities the run used").option("--steps", "also show the run's iterations, tool calls and sub-agent invocations").action(async (id, opts) => {
+runsCmd.command("get <id>").description("Show an agent run (status, output, trace metadata)").option("--resources", "also show the skills, knowledge and entities the run used").option("--steps", "also show the run's iterations, tool calls and sub-agent invocations").option("--json", "print the full JSON response, including requested resources and steps").action(async (id, opts) => {
   try {
     const include = [];
     if (opts.resources) include.push("resources");
     if (opts.steps) include.push("steps");
     const detail = await new ErdoClient().getAgentRun(id, include);
-    if (include.length === 0) {
+    if (opts.json || include.length === 0) {
       print(detail);
       return;
     }
@@ -6658,6 +6665,53 @@ datasetsCmd.command("purposes").description(
     fail(e);
   }
 });
+datasetsCmd.command("write <slug>").description(
+  "Write rows to a dataset. Without --key-column rows append. File and writable PostgreSQL datasets support keyed replace or merge. ClickHouse-backed writes always append, even with a key, and refuse merge."
+).requiredOption("--rows <json-or-@file>", "JSON array of row objects, or @path to a JSON file").option("--key-column <columns>", "non-blank key column, or comma-separated columns for a composite key").option("--write-mode <replace|merge>", "replace matching fields (files clear omitted fields; PostgreSQL updates batch columns), or merge; either explicit mode requires --key-column").option("--overwrite-columns <csv>", "comma-separated columns merge mode may overwrite").action(
+  async (slug, opts) => {
+    try {
+      const rawRows = readMaybeFile(opts.rows);
+      let parsed;
+      try {
+        parsed = JSON.parse(rawRows ?? "");
+      } catch (error) {
+        throw new Error(`--rows must contain valid JSON: ${error instanceof Error ? error.message : String(error)}`);
+      }
+      if (!Array.isArray(parsed) || parsed.some((row) => row === null || typeof row !== "object" || Array.isArray(row))) {
+        throw new Error("--rows must contain a JSON array of non-null objects");
+      }
+      const writeMode = opts.writeMode;
+      if (writeMode !== void 0 && writeMode !== "replace" && writeMode !== "merge") {
+        throw new Error('--write-mode must be "replace" or "merge"');
+      }
+      if (writeMode !== void 0 && !opts.keyColumn?.trim()) {
+        throw new Error(`--write-mode "${writeMode}" requires a non-blank --key-column`);
+      }
+      if (opts.keyColumn !== void 0 && !opts.keyColumn.split(",").some((column) => column.trim())) {
+        throw new Error("--key-column must name at least one non-blank column");
+      }
+      let overwriteColumns;
+      if (opts.overwriteColumns !== void 0) {
+        if (writeMode !== "merge") {
+          throw new Error("--overwrite-columns requires --write-mode merge");
+        }
+        overwriteColumns = opts.overwriteColumns.split(",").map((column) => column.trim());
+        if (overwriteColumns.some((column) => !column)) {
+          throw new Error("--overwrite-columns must not contain empty column names");
+        }
+      }
+      const result = await new ErdoClient().writeDatasetRows(slug, {
+        rows: parsed,
+        ...opts.keyColumn !== void 0 ? { key_column: opts.keyColumn } : {},
+        ...writeMode !== void 0 ? { write_mode: writeMode } : {},
+        ...overwriteColumns !== void 0 ? { overwrite_columns: overwriteColumns } : {}
+      });
+      print(result);
+    } catch (e) {
+      fail(e);
+    }
+  }
+);
 function readSchemaFile(path) {
   const parsed = JSON.parse(readFileSync4(path, "utf8"));
   const schema = Array.isArray(parsed) ? { columns: parsed } : parsed;
@@ -7096,7 +7150,7 @@ refreshCmd.command("set <slug>").description(
 ).option(
   "--mode <replace|upsert>",
   "replace overwrites every row with what the recipe returned; upsert merges by --key-column and keeps rows outside the returned window. Omit it and you get upsert when you passed --key-column and replace when you did not, since a key column is only meaningful to a merge"
-).option("--key-column <c>", "the column an upsert merges on; required with --mode upsert").option(
+).option("--key-column <c>", "non-blank column, or comma-separated columns, an upsert merges on; required with --mode upsert").option(
   "--schedule <cron>",
   "a cron expression to run the refresh on a fixed cadence. Omit it and the refresh runs on view instead \u2014 cheaper, because it never runs while nobody is looking"
 ).option("--timezone <tz>", "IANA timezone the cron expression is read in (default UTC)").option(
@@ -7146,6 +7200,10 @@ refreshCmd.command("set <slug>").description(
         fail(new Error("--mode must be replace or upsert"));
         return;
       }
+      if (opts.keyColumn !== void 0 && !opts.keyColumn.split(",").some((column) => column.trim())) {
+        fail(new Error("--key-column must name at least one non-blank column"));
+        return;
+      }
       if (opts.mode === "upsert" && !opts.keyColumn) {
         fail(new Error("--mode upsert needs --key-column <c>: the column the merge keys on"));
         return;

package/package.json

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