@erdoai/cli 0.26.0 → 0.28.0

package/dist/index.js

@@ -524,6 +524,21 @@ var ErdoClient = class {
       timezone
     });
   }
+  // Fetch rows from a dataset, optionally shaped by a SQL query and/or opting into
+  // named saved filters. filter_names are additive on top of the dataset's default
+  // filters — they narrow the result, never bypass a default. An unknown name is
+  // rejected server-side with the available names.
+  fetchDatasetContents(slug, opts) {
+    return this.request(
+      "POST",
+      `/v1/datasets/${encodeURIComponent(slug)}/fetch`,
+      {
+        sql_query: opts.sql_query,
+        limit: opts.limit,
+        filter_names: opts.filter_names
+      }
+    );
+  }
   uploadDatasetFile(body) {
     return this.request("POST", "/v1/datasets-upload", body);
   }
@@ -2023,34 +2038,60 @@ attnCmd.command("list").description("List attention items").option("--status <st
   }
 );
 attnCmd.command("respond <id>").description(
-  `Respond to an attention item. A choice answer's shape is {"<question_id>": ["<option>", ...]}. Answering a choice mapped to experiment variants records your pick as a human comparison in the calibration ledger.`
-).option("--answer <json>", `a JSON answer, e.g. '{"q1":["option-a"]}'`).option("--ack", "mark read / acknowledge").option("--dismiss", "dismiss the item").action(async (id, opts) => {
-  try {
-    const given = [opts.answer !== void 0, !!opts.ack, !!opts.dismiss].filter(Boolean).length;
-    if (given !== 1) {
-      fail(new Error("provide exactly one of --answer, --ack, or --dismiss"));
-    }
-    let input;
-    if (opts.answer !== void 0) {
-      let parsed;
-      try {
-        parsed = JSON.parse(opts.answer);
-      } catch {
-        throw new Error(
-          `--answer must be valid JSON, e.g. '{"<question_id>": ["<option>", ...]}'`
+  `Respond to an attention item. A choice answer's shape is {"<question_id>": ["<option>", ...]}. Answering a choice mapped to experiment variants records your pick as a human comparison in the calibration ledger. Use --flag-broken to flag one or more variants as broken (recorded as defect observations judge generation reads) \u2014 on its own or alongside --answer.`
+).option("--answer <json>", `a JSON answer, e.g. '{"q1":["option-a"]}'`).option(
+  "--flag-broken <json>",
+  'flag choice variants as broken: JSON array [{"variant_key":"...","reason":"..."}]'
+).option("--ack", "mark read / acknowledge").option("--dismiss", "dismiss the item").action(
+  async (id, opts) => {
+    try {
+      if (opts.ack || opts.dismiss) {
+        if (opts.ack && opts.dismiss) {
+          fail(new Error("provide only one of --ack or --dismiss"));
+        }
+        if (opts.answer !== void 0 || opts.flagBroken !== void 0) {
+          fail(new Error("--answer / --flag-broken cannot be combined with --ack or --dismiss"));
+        }
+        print(
+          await new ErdoClient().respondAttentionItem(id, {
+            action: opts.ack ? "acknowledge" : "dismiss"
+          })
         );
+        return;
       }
-      input = { action: "answer", answer: parsed };
-    } else if (opts.ack) {
-      input = { action: "acknowledge" };
-    } else {
-      input = { action: "dismiss" };
+      if (opts.answer === void 0 && opts.flagBroken === void 0) {
+        fail(new Error("provide one of --answer, --flag-broken, --ack, or --dismiss"));
+      }
+      const input = { action: "answer" };
+      if (opts.answer !== void 0) {
+        try {
+          input.answer = JSON.parse(opts.answer);
+        } catch {
+          throw new Error(
+            `--answer must be valid JSON, e.g. '{"<question_id>": ["<option>", ...]}'`
+          );
+        }
+      }
+      if (opts.flagBroken !== void 0) {
+        let parsed;
+        try {
+          parsed = JSON.parse(opts.flagBroken);
+        } catch {
+          throw new Error(
+            `--flag-broken must be valid JSON, e.g. '[{"variant_key":"b","reason":"clipped hero"}]'`
+          );
+        }
+        if (!Array.isArray(parsed)) {
+          throw new Error('--flag-broken must be a JSON array of {"variant_key","reason"} objects');
+        }
+        input.defects = parsed;
+      }
+      print(await new ErdoClient().respondAttentionItem(id, input));
+    } catch (e) {
+      fail(e);
     }
-    print(await new ErdoClient().respondAttentionItem(id, input));
-  } catch (e) {
-    fail(e);
   }
-});
+);
 var reviewsCmd = program.command("reviews").description(
   "The Knowledge Review queue \u2014 knowledge patches the critic proposes, investigations, and deduplicated failure signals awaiting a human decision"
 );
@@ -2210,6 +2251,24 @@ datasetsCmd.command("query <slug> <question>").description("Ask a natural-langua
     fail(e);
   }
 });
+datasetsCmd.command("fetch <slug>").description("Fetch rows from a dataset, optionally shaped by SQL and named filters").option("-q, --sql <query>", "SQL query to filter/transform the rows").option("-l, --limit <n>", "max rows to return", (v) => parseInt(v, 10)).option(
+  "-f, --filter <name>",
+  "opt into a saved filter by name (repeatable); additive on top of the dataset's default filters (see: erdo datasets filter list <slug>)",
+  (v, acc) => acc.concat(v),
+  []
+).action(async (slug, opts) => {
+  try {
+    print(
+      await new ErdoClient().fetchDatasetContents(slug, {
+        sql_query: opts.sql,
+        limit: opts.limit,
+        filter_names: opts.filter.length ? opts.filter : void 0
+      })
+    );
+  } catch (e) {
+    fail(e);
+  }
+});
 var MAX_UPLOAD_BYTES = 20 * 1024 * 1024;
 datasetsCmd.command("upload <file>").description("Upload a file (CSV, Excel, JSON, ...) and create a dataset from it").option("-n, --name <name>", "display name for the dataset (defaults to the filename)").option("-d, --description <text>", "description shown to agents analyzing the dataset").action(async (file, opts) => {
   try {
@@ -2349,15 +2408,24 @@ pipelinesCmd.command("get <slug>").description("Show one event pipeline \u2014 s
     fail(e);
   }
 });
-filterCmd.command("add <slug>").description("Add a default filter to a dataset").requiredOption(
+filterCmd.command("add <slug>").description("Add a filter to a dataset (default-on unless --no-default)").requiredOption(
   "--where <condition>",
   "a '<column> <operator> <value>' condition (repeatable, AND-combined), e.g. --where 'email contains @example.com'. Operators: " + OPERATORS.join(", ") + " (for 'between' use 'col between 10,100')",
   collect,
   []
-).option("--name <name>", "optional human-readable label, e.g. 'Exclude test submissions'").action(async (slug, opts) => {
+).option("--name <name>", "optional human-readable label, e.g. 'Exclude test submissions'").option(
+  "--no-default",
+  "save as a named view that reads opt into with 'datasets fetch --filter <name>', instead of applying to every read"
+).action(async (slug, opts) => {
   try {
     const conditions = opts.where.map(parseCondition);
-    print(await new ErdoClient().createDatasetFilter(slug, { name: opts.name, conditions }));
+    print(
+      await new ErdoClient().createDatasetFilter(slug, {
+        name: opts.name,
+        conditions,
+        is_default: opts.default === false ? false : void 0
+      })
+    );
   } catch (e) {
     fail(e);
   }

package/package.json

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