@erdoai/cli 0.23.1 → 0.25.0

package/dist/index.js

@@ -427,6 +427,32 @@ var ErdoClient = class {
       input
     );
   }
+  // --- knowledge review queue ---
+  listReviewItems(params) {
+    const q = new URLSearchParams();
+    if (params?.status !== void 0) q.set("status", params.status);
+    if (params?.type) q.set("type", params.type);
+    if (params?.limit) q.set("limit", String(params.limit));
+    if (params?.offset) q.set("offset", String(params.offset));
+    const qs = q.toString();
+    return this.request(
+      "GET",
+      `/v1/review-items${qs ? `?${qs}` : ""}`
+    );
+  }
+  getReviewItem(id) {
+    return this.request(
+      "GET",
+      `/v1/review-items/${encodeURIComponent(id)}`
+    );
+  }
+  decideReviewItem(id, input) {
+    return this.request(
+      "POST",
+      `/v1/review-items/${encodeURIComponent(id)}/decide`,
+      input
+    );
+  }
   // --- agents ---
   ask(input) {
     return this.request("POST", "/v1/ask", input);
@@ -922,13 +948,13 @@ function awaitingApprovalMessage(threadID) {
     "the run paused for approval.",
     "  erdo approvals list --status pending",
     "  erdo approvals decide <id> --approve",
-    `  erdo agent messages ${threadID}`
+    `  erdo agent wait ${threadID}`
   ].join("\n");
 }
 function timedOutMessage(threadID) {
   return [
     "timed out waiting for the run to finish \u2014 it is still running on its thread.",
-    `  erdo agent messages ${threadID}`,
+    `  erdo agent wait ${threadID}`,
     `  erdo runs list --thread ${threadID}`
   ].join("\n");
 }
@@ -1831,6 +1857,22 @@ agentCmd.command("send <threadId> <message>").description("Send a message to a t
     fail(e);
   }
 });
+agentCmd.command("wait <threadId>").description("Re-attach to a thread's latest run and wait for it to finish; prints the answer").action(async (threadId) => {
+  try {
+    const client = new ErdoClient();
+    process.stderr.write("waiting\u2026");
+    const run = await client.waitForThreadRun(threadId, {
+      onTick: () => process.stderr.write(".")
+    });
+    process.stderr.write("\n");
+    if (!run) throw new Error(timedOutMessage(threadId));
+    if (run.status === "awaiting_approval") throw new Error(awaitingApprovalMessage(threadId));
+    if (run.error) throw new Error(run.error);
+    console.log(run.output || `(status: ${run.status})`);
+  } catch (e) {
+    fail(e);
+  }
+});
 agentCmd.command("thread").description("Create a thread; prints its id").option("-n, --name <name>", "thread name").option("-d, --datasets <csv>", "dataset UUIDs to attach").action(async (opts) => {
   try {
     const res = await new ErdoClient().createThread({
@@ -1966,6 +2008,60 @@ attnCmd.command("respond <id>").description(
     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"
+);
+reviewsCmd.command("list").description("List review items (decision items rank above failure signals)").option("--status <status>", "open (default) | snoozed | resolved | rejected | '' for all").option("--type <type>", "filter by type, e.g. knowledge_patch, eval_failure, failed_run").option("-n, --limit <n>", "max items", (v) => parseInt(v, 10)).option("--offset <n>", "pagination offset", (v) => parseInt(v, 10)).action(
+  async (opts) => {
+    try {
+      print(
+        await new ErdoClient().listReviewItems({
+          status: opts.status,
+          type: opts.type,
+          limit: opts.limit,
+          offset: opts.offset
+        })
+      );
+    } catch (e) {
+      fail(e);
+    }
+  }
+);
+reviewsCmd.command("show <id>").description("Show one review item with its full payload (the proposed patch body for a knowledge_patch)").action(async (id) => {
+  try {
+    print(await new ErdoClient().getReviewItem(id));
+  } catch (e) {
+    fail(e);
+  }
+});
+reviewsCmd.command("decide <id>").description(
+  "Decide a review item: --apply a knowledge patch (mutates Knowledge, then resolves), --resolve, --reject, or --snooze [minutes]"
+).option("--apply", "apply a knowledge_patch: create/update the proposed Knowledge object, then resolve").option("--resolve", "close as handled").option("--reject", "close as declined").option("--snooze [minutes]", "hide the item for [minutes] (default 7 days)").option("--note <note>", "resolution note recorded on the item").action(
+  async (id, opts) => {
+    try {
+      const chosen = [
+        opts.apply ? "apply" : null,
+        opts.resolve ? "resolve" : null,
+        opts.reject ? "reject" : null,
+        opts.snooze !== void 0 ? "snooze" : null
+      ].filter(Boolean);
+      if (chosen.length !== 1) {
+        fail(new Error("provide exactly one of --apply, --resolve, --reject, or --snooze"));
+      }
+      const action = chosen[0];
+      let minutes;
+      if (action === "snooze" && typeof opts.snooze === "string") {
+        minutes = parseInt(opts.snooze, 10);
+        if (Number.isNaN(minutes)) {
+          throw new Error("--snooze minutes must be a number");
+        }
+      }
+      print(await new ErdoClient().decideReviewItem(id, { action, minutes, note: opts.note }));
+    } catch (e) {
+      fail(e);
+    }
+  }
+);
 var pagesCmd = program.command("pages").description("Create and manage pages/artifacts");
 function readMaybeFile(v) {
   if (!v) return void 0;

package/package.json

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