@erdoai/cli 0.48.0 → 0.49.1

package/dist/index.js

@@ -547,6 +547,7 @@ var ErdoClient = class {
     const q = new URLSearchParams();
     for (const s of params?.statuses ?? []) q.append("statuses", s);
     if (params?.engine_actions_only) q.set("engine_actions_only", "true");
+    if (params?.item_id) q.set("item_id", params.item_id);
     if (params?.limit) q.set("limit", String(params.limit));
     if (params?.offset) q.set("offset", String(params.offset));
     const qs = q.toString();
@@ -901,6 +902,13 @@ var ErdoClient = class {
       `/v1/approvals${qs ? `?${qs}` : ""}`
     );
   }
+  // One request in full — the itemized projection, the recorded reason, and the
+  // scope options a decision is made against, where the list is sized for
+  // scanning. A request belonging to another organization reads as 404, so an id
+  // cannot be probed for existence.
+  getApproval(id) {
+    return this.request("GET", `/v1/approvals/${encodeURIComponent(id)}`);
+  }
   decideApproval(id, input) {
     return this.request(
       "POST",
@@ -1257,6 +1265,7 @@ function awaitingApprovalMessage(threadID) {
   return [
     "the run paused for approval.",
     "  erdo approvals list --status pending",
+    "  erdo approvals show <id>",
     "  erdo approvals decide <id> --approve",
     `  erdo agent wait ${threadID}`
   ].join("\n");
@@ -1713,7 +1722,7 @@ wsCmd.command("arm <slug>").description("Arm the recurring reconciliation loop (
   }
 );
 wsCmd.command("ledger <slug>").description(
-  "Read the allocator's single ledger view \u2014 budget, experiments + observations, judge calibration, attention items, allocator recommendation"
+  "Read the allocator's single ledger view \u2014 budget, experiments + observations, judge calibration, the decisions currently in force, attention items, allocator recommendation"
 ).option("--observations <n>", "observations to include per experiment", (v) => parseInt(v, 10)).action(async (slug, opts) => {
   try {
     print(await new ErdoClient().readWorkstreamLedger(slug, opts.observations));
@@ -2457,6 +2466,67 @@ approvalsCmd.command("list").description("List approval requests, optionally fil
     }
   }
 );
+function renderApproval(r) {
+  console.log(r.action_headline || r.action_display);
+  const facts = [["status", r.status]];
+  if (r.decision_class) facts.push(["decision", r.decision_class]);
+  if (r.subject_display_name) {
+    facts.push(["subject", r.subject_display_name]);
+  } else if (r.subject_resource_type && r.subject_resource_id) {
+    facts.push(["subject", `${r.subject_resource_type} ${r.subject_resource_id}`]);
+  }
+  if (r.occurrence_count && r.occurrence_count > 1) {
+    facts.push([
+      "proposed",
+      `${r.occurrence_count}\xD7 since ${r.first_proposed_at ?? r.created_at}`
+    ]);
+  }
+  facts.push(["created", r.created_at]);
+  if (r.decided_at) facts.push(["decided", r.decided_at]);
+  if (r.expires_at) facts.push(["expires", r.expires_at]);
+  for (const [label, value] of facts) {
+    console.log(`  ${label.padEnd(9)} ${value}`);
+  }
+  if (r.action_context) {
+    console.log("");
+    console.log(`Reason: ${r.action_context}`);
+  }
+  const items = r.action_items ?? [];
+  if (items.length) {
+    console.log("");
+    console.log(items.length === 1 ? "Action:" : `Actions (${items.length}):`);
+    items.forEach((item, i) => {
+      console.log(`  ${i + 1}. ${item.what}`);
+      if (item.why) console.log(`     why: ${item.why}`);
+      for (const [key, value] of Object.entries(item.params_compact ?? {})) {
+        console.log(`     ${key}: ${value}`);
+      }
+    });
+  }
+  if (r.omitted_items && r.omitted_items > 0) {
+    console.log(`  \u2026 and ${r.omitted_items} more actions`);
+  }
+  const options = r.scope_options ?? [];
+  if (options.length) {
+    console.log("");
+    console.log("Scope options (`erdo approvals decide --option N`):");
+    options.forEach((o, i) => console.log(`  ${i + 1}. ${o.label}`));
+  }
+}
+approvalsCmd.command("show <id>").description(
+  "Show one approval request in full: the outcome headline, the actions it covers with the reason each was proposed, the subject it acts on, and the scope options a standing decision can use"
+).option("--json", "output raw JSON").action(async (id, opts) => {
+  try {
+    const req = await new ErdoClient().getApproval(id);
+    if (opts.json) {
+      print(req);
+      return;
+    }
+    renderApproval(req);
+  } catch (e) {
+    fail(e);
+  }
+});
 approvalsCmd.command("decide <id>").description("Approve or reject a pending approval request").option("--approve", "approve the request").option("--reject", "reject the request").option(
   "--scope <scope>",
   "once (default) | always_this_job | always_this_workstream | always_org | always_user",
@@ -2513,7 +2583,7 @@ ${listing}`);
   }
 );
 var attnCmd = program.command("attention").description("The attention feed \u2014 digests, choices, escalations awaiting a human");
-attnCmd.command("list").description("List attention items").option("--status <status...>", "open | answered | dismissed | expired").option("--open", "shorthand for --status open").option("--engine-actions", "only engine-generated items").option("-n, --limit <n>", "max items", (v) => parseInt(v, 10)).option("--offset <n>", "pagination offset", (v) => parseInt(v, 10)).action(
+attnCmd.command("list").description("List attention items").option("--status <status...>", "open | answered | dismissed | expired").option("--open", "shorthand for --status open").option("--engine-actions", "only engine-generated items").option("--item <idOrSlug>", "read one item: its slug or its uuid").option("-n, --limit <n>", "max items", (v) => parseInt(v, 10)).option("--offset <n>", "pagination offset", (v) => parseInt(v, 10)).action(
   async (opts) => {
     try {
       const statuses = opts.status?.length ? opts.status : opts.open ? ["open"] : void 0;
@@ -2521,6 +2591,7 @@ attnCmd.command("list").description("List attention items").option("--status <st
         await new ErdoClient().listAttentionItems({
           statuses,
           engine_actions_only: opts.engineActions,
+          item_id: opts.item,
           limit: opts.limit,
           offset: opts.offset
         })

package/package.json

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