@erdoai/cli 0.67.0 → 0.71.0

package/dist/index.js

@@ -297,14 +297,19 @@ var ErdoClient = class {
   createManagerKey() {
     return this.request("POST", "/v1/manager-key");
   }
-  // Brings an EXISTING org under your manager org by redeeming a one-time consent
-  // token — a manager credential on its own can never adopt an arbitrary org, it
-  // has to present a secret only the target org's owner (or, for an ownerless
-  // managed org, its current manager) could have minted. The path is a sibling of
-  // /v1/managed-organizations rather than a nested `adopt` because Encore rejects
-  // a static segment alongside the parameterized /:orgSlug routes.
-  adoptManagedOrganization(token) {
-    return this.request("POST", "/v1/managed-organization-adoptions", { token });
+  // Brings an EXISTING org under your manager org. Two consents redeem here: a
+  // one-time token minted by the target org's owner (or, for an ownerless managed
+  // org, its current manager) — a manager credential on its own can never adopt an
+  // arbitrary org — or, DIRECT adoption, the org's slug when the caller themselves
+  // is a seated owner of it (both halves of the consent in one person, so no token
+  // ferrying). The path is a sibling of /v1/managed-organizations rather than a
+  // nested `adopt` because Encore rejects a static segment alongside the
+  // parameterized /:orgSlug routes.
+  adoptManagedOrganization(input) {
+    return this.request("POST", "/v1/managed-organization-adoptions", {
+      token: input.token ?? "",
+      organization_slug: input.organizationSlug ?? ""
+    });
   }
   // Seats a person in a managed org. The role is capped at admin — ownership of a
   // client org stays with the client — and an omitted role means the backend's
@@ -331,8 +336,30 @@ var ErdoClient = class {
   listCustomDomains() {
     return this.request("GET", "/v1/custom-domains");
   }
-  createCustomDomain(domain) {
-    return this.request("POST", "/v1/custom-domains", { domain });
+  // `managerDefault` registers the domain and points the orgs this one manages at
+  // it in one step, for a manager setting up its very first branded hostname. The
+  // key is left out of the body when false so an ordinary registration sends what
+  // it always sent; changing the flag on a domain that is already live goes
+  // through setCustomDomainManagerDefault, which does not touch the certificate.
+  createCustomDomain(domain, managerDefault) {
+    return this.request(
+      "POST",
+      "/v1/custom-domains",
+      managerDefault ? { domain, manager_default: true } : { domain }
+    );
+  }
+  // Marks a domain the org already owns as the one its managed orgs serve their
+  // pages from, or clears it. At most one domain per org carries the flag, so
+  // promoting a second demotes the first in the same write — the managed orgs
+  // never see a moment with no default and fall back to platform URLs. Only a
+  // manager account with at least one client org can set it; clearing is always
+  // allowed, so an org that has since let its last client go can still tidy up.
+  setCustomDomainManagerDefault(domain, managerDefault) {
+    return this.request(
+      "PATCH",
+      `/v1/custom-domains/${encodeURIComponent(domain)}/manager-default`,
+      { manager_default: managerDefault }
+    );
   }
   deleteCustomDomain(domain) {
     return this.request(
@@ -412,6 +439,22 @@ var ErdoClient = class {
   getSentEmail(emailID) {
     return this.request("GET", `/v1/emails/${encodeURIComponent(emailID)}`);
   }
+  // Phone conversation records: inbound calls to a voice agent's own number and
+  // the outbound calls Erdo placed. Website chat widget conversations are a
+  // different resource — they live under /v1/voice/widget-conversations.
+  listVoiceCalls(params) {
+    const q = new URLSearchParams();
+    if (params?.agent) q.set("agent", params.agent);
+    if (params?.direction) q.set("direction", params.direction);
+    if (params?.limit !== void 0) q.set("limit", String(params.limit));
+    if (params?.offset !== void 0) q.set("offset", String(params.offset));
+    if (params?.cursor) q.set("cursor", params.cursor);
+    const qs = q.toString();
+    return this.request("GET", `/v1/voice/calls${qs ? `?${qs}` : ""}`);
+  }
+  getVoiceCall(callID) {
+    return this.request("GET", `/v1/voice/calls/${encodeURIComponent(callID)}`);
+  }
   // Run a read-only HogQL query against the org's page-analytics events. Rows are
   // positional per columns; enabled:false means page analytics is off for the org
   // (not zero traffic). A rejected query surfaces PostHog's message as the error.
@@ -847,6 +890,14 @@ var ErdoClient = class {
   listDatasetPurposes() {
     return this.request("GET", `/v1/datasets-purposes`);
   }
+  // Correct which dataset carries a purpose. Pass `purpose` to set one,
+  // `clear_purpose` to remove it; moving a purpose is clearing it from the old
+  // dataset and setting it on the right one. Setting a purpose the org already
+  // uses elsewhere succeeds and answers with a warning naming what it shadows,
+  // since one purpose is meant to map to one dataset.
+  setDatasetPurpose(slug, input) {
+    return this.request("POST", `/v1/datasets/${encodeURIComponent(slug)}/schema`, input);
+  }
   // 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".
   //
@@ -888,6 +939,69 @@ var ErdoClient = class {
   listDatasetRevisions(slug) {
     return this.request("GET", `/v1/datasets/${encodeURIComponent(slug)}/revisions`);
   }
+  // --- bounded outreach ---
+  putOutreachBatch(batch, body) {
+    return this.request(
+      "PUT",
+      `/v1/outreach-batches/${encodeURIComponent(batch)}`,
+      body
+    );
+  }
+  listOutreachBatches(opts = {}) {
+    const q = new URLSearchParams();
+    if (opts.limit !== void 0) q.set("limit", String(opts.limit));
+    if (opts.cursor) q.set("cursor", opts.cursor);
+    if (opts.initiative_ref) q.set("initiative_ref", opts.initiative_ref);
+    const qs = q.toString();
+    return this.request(
+      "GET",
+      `/v1/outreach-batches${qs ? `?${qs}` : ""}`
+    );
+  }
+  getOutreachBatch(batch) {
+    return this.request(
+      "GET",
+      `/v1/outreach-batches/${encodeURIComponent(batch)}`
+    );
+  }
+  listOutreachBatchRecipients(batch, opts = {}) {
+    const q = new URLSearchParams();
+    if (opts.limit !== void 0) q.set("limit", String(opts.limit));
+    if (opts.cursor) q.set("cursor", opts.cursor);
+    const qs = q.toString();
+    return this.request(
+      "GET",
+      `/v1/outreach-batches/${encodeURIComponent(batch)}/recipients${qs ? `?${qs}` : ""}`
+    );
+  }
+  actOnOutreachBatch(batch, body) {
+    return this.request(
+      "POST",
+      `/v1/outreach-batches/${encodeURIComponent(batch)}/actions`,
+      body
+    );
+  }
+  putOutreachConsent(body) {
+    return this.request("PUT", "/v1/outreach-consents", body);
+  }
+  listOutreachConsents(opts = {}) {
+    const q = new URLSearchParams();
+    if (opts.limit !== void 0) q.set("limit", String(opts.limit));
+    if (opts.cursor) q.set("cursor", opts.cursor);
+    const qs = q.toString();
+    return this.request(
+      "GET",
+      `/v1/outreach-consents${qs ? `?${qs}` : ""}`
+    );
+  }
+  getOutreachConsent(opts) {
+    const q = new URLSearchParams();
+    if (opts.grant_ref) q.set("grant_ref", opts.grant_ref);
+    if (opts.recipient_ref) q.set("recipient_ref", opts.recipient_ref);
+    if (opts.phone_raw) q.set("phone_raw", opts.phone_raw);
+    if (opts.default_country) q.set("default_country", opts.default_country);
+    return this.request("GET", `/v1/outreach-consents?${q.toString()}`);
+  }
   uploadDatasetFile(body) {
     return this.request("POST", "/v1/datasets-upload", body);
   }
@@ -1080,17 +1194,36 @@ var ErdoClient = class {
       `/v1/kv/${encodeURIComponent(slug)}/items/${encodeURIComponent(key)}`
     );
   }
+  // --- page monitoring ---
+  // These live here rather than being called through `request` from the command
+  // layer: `request` is private, and reaching past it left the CLI's own
+  // typecheck red.
+  setPageMonitoring(id, body) {
+    return this.request(
+      "POST",
+      `/v1/pages/monitoring/${encodeURIComponent(id)}`,
+      body
+    );
+  }
+  getPageMonitoring(id) {
+    return this.request(
+      "GET",
+      `/v1/pages/monitoring/${encodeURIComponent(id)}`
+    );
+  }
   // --- agent runs ---
   listAgentRuns(opts) {
     const params = new URLSearchParams();
     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);
     if (opts.limit) params.set("limit", String(opts.limit));
     const qs = params.toString();
     return this.request("GET", `/v1/runs${qs ? `?${qs}` : ""}`);
   }
-  getAgentRun(id) {
-    return this.request("GET", `/v1/runs/${encodeURIComponent(id)}`);
+  getAgentRun(id, include = []) {
+    const qs = include.length ? `?include=${encodeURIComponent(include.join(","))}` : "";
+    return this.request("GET", `/v1/runs/${encodeURIComponent(id)}${qs}`);
   }
   // --- approvals ---
   listApprovals(opts) {
@@ -1534,6 +1667,25 @@ function timedOutMessage(threadID) {
 function print(value) {
   console.log(JSON.stringify(value, null, 2));
 }
+function readJSONObject(file, label) {
+  let parsed;
+  try {
+    parsed = JSON.parse(readFileSync4(file, "utf8"));
+  } catch (error) {
+    throw new Error(`${label} must be a readable JSON file: ${error instanceof Error ? error.message : String(error)}`);
+  }
+  if (parsed === null || Array.isArray(parsed) || typeof parsed !== "object") {
+    throw new Error(`${label} must contain one JSON object`);
+  }
+  return parsed;
+}
+function requireOutreachProject() {
+  if (!process.env.ERDO_PROJECT?.trim()) {
+    throw new Error(
+      "outreach commands require a project: pass --project <uuid> (and --org when the key can reach more than one organization)"
+    );
+  }
+}
 function printPageReview(review) {
   if (!review) return;
   if (!review.reviewed) {
@@ -1806,9 +1958,20 @@ id: ${o.id}`);
     fail(e);
   }
 });
-managed.command("adopt <token>").description("Take over an existing org by redeeming a one-time consent token").action(async (token) => {
+managed.command("adopt [token]").description(
+  "Take over an existing org: redeem a one-time consent token, or --from-org <slug> for an org you own yourself (no token needed)"
+).option("--from-org <slug>", "slug of an org you are an owner of, adopted directly").action(async (token, opts) => {
   try {
-    const o = await new ErdoClient().adoptManagedOrganization(token);
+    if (!token && !opts.fromOrg) {
+      fail(new Error("provide a consent token, or --from-org <slug> for an org you own"));
+    }
+    if (token && opts.fromOrg) {
+      fail(new Error("provide a token or --from-org, not both"));
+    }
+    const o = await new ErdoClient().adoptManagedOrganization({
+      token,
+      organizationSlug: opts.fromOrg
+    });
     console.log(`Adopted managed org: ${o.name}`);
     console.log(`slug: ${o.slug}
 id: ${o.id}`);
@@ -2915,7 +3078,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("-l, --limit <n>", "max runs", (v) => parseInt(v, 10)).action(async (opts) => {
+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) => {
   try {
     const { runs } = await new ErdoClient().listAgentRuns(opts);
     for (const r of runs) console.log(`${r.id}	${r.status}	${r.agent_key}`);
@@ -2923,13 +3086,130 @@ 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)").action(async (id) => {
+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) => {
   try {
-    print(await new ErdoClient().getAgentRun(id));
+    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) {
+      print(detail);
+      return;
+    }
+    printRunDetail(detail, opts.resources === true, opts.steps === true);
   } catch (e) {
     fail(e);
   }
 });
+var RUN_ARRIVAL_LABELS = {
+  "knowledge.kind_pinned": "pinned for this kind",
+  "knowledge.list": "pinned",
+  "knowledge.search": "ambient search",
+  "knowledge.tool_search": "fetched mid-run",
+  "knowledge.tool_list": "listed mid-run",
+  judge_lens: "review lens",
+  persona_lens: "persona lens",
+  read_knowledge_object: "read directly",
+  definition: "definition",
+  constraint_source: "constraint source"
+};
+function arrivalLabel(usageKind) {
+  return RUN_ARRIVAL_LABELS[usageKind] || usageKind || "used";
+}
+function resourceKind(resource) {
+  if (resource.resource_type === "query_constraint") return "query_constraint";
+  return resource.type || resource.resource_type;
+}
+function printRunDetail(detail, wantResources, wantSteps) {
+  const run = detail.run;
+  console.log(`${run.id}	${run.status}	${run.agent_name || run.agent_key}`);
+  if (wantResources) {
+    const resources = detail.resources ?? [];
+    console.log("");
+    console.log("Resources used");
+    if (resources.length === 0) {
+      console.log("  (none recorded)");
+    } else {
+      const byKind = /* @__PURE__ */ new Map();
+      for (const resource of resources) {
+        const kind = resourceKind(resource);
+        const key = resource.resource_id || resource.id;
+        const group = byKind.get(kind) ?? /* @__PURE__ */ new Map();
+        const entry = group.get(key) ?? {
+          name: resource.display_name || resource.resource_id || resource.id,
+          arrivals: []
+        };
+        const arrival = arrivalLabel(resource.usage_kind);
+        if (!entry.arrivals.includes(arrival)) entry.arrivals.push(arrival);
+        group.set(key, entry);
+        byKind.set(kind, group);
+      }
+      const kinds = [...byKind.keys()].sort(
+        (a, b) => a === "skill" ? -1 : b === "skill" ? 1 : a.localeCompare(b)
+      );
+      for (const kind of kinds) {
+        console.log(`  ${kind}`);
+        for (const entry of byKind.get(kind).values()) {
+          console.log(`    ${entry.name}	(${entry.arrivals.join(", ")})`);
+        }
+      }
+    }
+  }
+  if (wantSteps) {
+    const steps = detail.steps ?? [];
+    console.log("");
+    console.log("Steps");
+    if (steps.length === 0) {
+      console.log("  (none recorded)");
+    } else {
+      printStepTree(steps);
+    }
+  }
+}
+function printStepTree(steps) {
+  const childrenOf = /* @__PURE__ */ new Map();
+  const known = new Set(steps.map((s) => s.step_id));
+  const roots = [];
+  for (const step of steps) {
+    if (step.parent_step_id && known.has(step.parent_step_id)) {
+      const siblings = childrenOf.get(step.parent_step_id) ?? [];
+      siblings.push(step);
+      childrenOf.set(step.parent_step_id, siblings);
+    } else {
+      roots.push(step);
+    }
+  }
+  const printed = /* @__PURE__ */ new Set();
+  const walk = (step, depth) => {
+    if (printed.has(step.step_id)) return;
+    printed.add(step.step_id);
+    console.log(`${"  ".repeat(depth + 1)}${stepLine(step)}`);
+    for (const child of childrenOf.get(step.step_id) ?? []) walk(child, depth + 1);
+  };
+  for (const root of roots) walk(root, 0);
+  for (const step of steps) {
+    if (!printed.has(step.step_id)) {
+      printed.add(step.step_id);
+      console.log(`  ${stepLine(step)}`);
+    }
+  }
+}
+function stepLine(step) {
+  const parts = [];
+  if (step.kind === "agent") {
+    parts.push(`agent ${step.agent_key || step.name}`);
+    if (step.agent_run_id) parts.push(`run ${step.agent_run_id}`);
+  } else if (step.kind === "tool_call") {
+    parts.push(`tool ${step.name}`);
+  } else {
+    parts.push(step.iteration ? `iteration ${step.iteration}` : "iteration");
+    if (step.name) parts.push(step.name);
+  }
+  if (step.duration_ms !== void 0) parts.push(`${step.duration_ms}ms`);
+  if (step.status) parts.push(step.status);
+  if (step.error) parts.push(`error: ${step.error}`);
+  return parts.join("	");
+}
 var decisionsCmd = program.command("decisions").description(
   "The decision record \u2014 what your organization committed to, whether the change actually happened, and what the evidence said afterwards"
 );
@@ -3839,6 +4119,32 @@ pagesCmd.command("restore <id>").description("Restore a previously deleted page
     fail(e);
   }
 });
+pagesCmd.command("monitor <id>").description(
+  "Control health monitoring for a published page: --exclude stops all probing (dashboards, trackers, demos); --ack <sig> acknowledges a known failure class (mobile:overflow, desktop:resource) so it stops alerting and never auto-repairs while a NEW failure class still alerts"
+).option("--exclude [reason]", "exclude this page from monitoring entirely (optional reason)").option("--include", "re-include the page in monitoring").option("--ack <sigs>", "comma-separated failure signatures to acknowledge (e.g. mobile:overflow,desktop:resource)").option("--unack <sigs>", "comma-separated failure signatures to un-acknowledge").option("--reset", "clear all acknowledged failure signatures").action(async (id, opts) => {
+  try {
+    const api = new ErdoClient();
+    const body = {};
+    if (opts.include) body.excluded = false;
+    else if (typeof opts.exclude === "string") {
+      body.excluded = true;
+      body.excluded_reason = opts.exclude;
+    } else if (opts.exclude === true) body.excluded = true;
+    if (opts.ack) body.ack_add = opts.ack.split(",").map((s) => s.trim()).filter(Boolean);
+    if (opts.unack) body.ack_remove = opts.unack.split(",").map((s) => s.trim()).filter(Boolean);
+    if (opts.reset) body.ack_reset = true;
+    print(await api.setPageMonitoring(id, body));
+  } catch (e) {
+    fail(e);
+  }
+});
+pagesCmd.command("monitor-get <id>").description("Read a page's monitoring controls (excluded flag + acknowledged failure signatures)").action(async (id) => {
+  try {
+    print(await new ErdoClient().getPageMonitoring(id));
+  } catch (e) {
+    fail(e);
+  }
+});
 pagesCmd.command("clone <id>").description(
   "Copy a page. The copy is byte-identical and starts private (publish state is never inherited); the source's lead-form pipelines are duplicated onto it and the ids in its content rewritten, so it captures its own leads"
 ).option("--title <title>", 'title for the copy (default: "Copy of <source title>")').option("--json", "print the full JSON, including the cloned pipelines and id rewrites").action(async (id, opts) => {
@@ -3924,17 +4230,21 @@ domainsCmd.command("list").description("List the org's custom domains with live
     }
     for (const d of domains) {
       const checked = d.last_checked_at ? `checked ${d.last_checked_at}` : "never checked";
+      const managerDefault = d.manager_default ? "	manager default" : "";
       const reason = d.error_reason ? `	${d.error_reason}` : "";
-      console.log(`${d.domain}	${d.status}	${checked}${reason}`);
+      console.log(`${d.domain}	${d.status}	${checked}${managerDefault}${reason}`);
     }
   } catch (e) {
     fail(e);
   }
 });
-domainsCmd.command("add <domain>").description("Register a custom domain (a direct subdomain, e.g. pages.acme.com) and print the DNS records to create").action(async (domain) => {
+domainsCmd.command("add <domain>").description("Register a custom domain (a direct subdomain, e.g. pages.acme.com) and print the DNS records to create").option(
+  "--manager-default",
+  "also point the orgs you manage at this domain, for a manager registering its first branded hostname"
+).action(async (domain, opts) => {
   try {
-    const d = await new ErdoClient().createCustomDomain(domain);
-    console.log(`${d.domain}: ${d.status}`);
+    const d = await new ErdoClient().createCustomDomain(domain, opts.managerDefault);
+    console.log(`${d.domain}: ${d.status}${d.manager_default ? " (manager default)" : ""}`);
     if (d.dns_records.length > 0) {
       process.stderr.write("Create these records at the domain's DNS provider:\n");
       for (const r of d.dns_records) {
@@ -3945,6 +4255,20 @@ domainsCmd.command("add <domain>").description("Register a custom domain (a dire
     fail(e);
   }
 });
+domainsCmd.command("manager-default <domain>").description(
+  "Make this the domain the orgs you manage serve their pages from when they have registered none of their own \u2014 a client with its own domain keeps it \u2014 or clear that with --unset"
+).option("--unset", "clear the flag instead, returning the managed orgs to the platform pages host").action(async (domain, opts) => {
+  try {
+    const d = await new ErdoClient().setCustomDomainManagerDefault(domain, !opts.unset);
+    if (d.manager_default) {
+      console.log(`${d.domain} is now the default domain for the orgs you manage (status: ${d.status})`);
+    } else {
+      console.log(`${d.domain} is no longer the default domain for the orgs you manage`);
+    }
+  } catch (e) {
+    fail(e);
+  }
+});
 domainsCmd.command("remove <domain>").description("Remove a custom domain registration (stops it serving pages)").action(async (domain) => {
   try {
     const res = await new ErdoClient().deleteCustomDomain(domain);
@@ -4168,6 +4492,98 @@ sentEmailsCmd.command("list").description("List sent email, newest first, includ
     }
   }
 );
+var outreachCmd = program.command("outreach").description("Consent-gated SMS outreach to an explicit reviewed selection of up to 700 people");
+var outreachBatchesCmd = outreachCmd.command("batches").description("Prepare and control outreach batches");
+outreachBatchesCmd.command("put <batch>").description("Create one immutable draft preview from a JSON declaration; this never starts sending").requiredOption("-f, --file <path>", "JSON object containing the batch declaration and recipients").action(async (batch, opts) => {
+  try {
+    requireOutreachProject();
+    print(await new ErdoClient().putOutreachBatch(batch, readJSONObject(opts.file, "--file")));
+  } catch (e) {
+    fail(e);
+  }
+});
+outreachBatchesCmd.command("list").description("List outreach batches in the required project").option("-l, --limit <n>", "max batches to return", (v) => parseInt(v, 10)).option("--cursor <cursor>", "opaque next_cursor from the preceding page").option("--initiative <ref>", "return only this outreach initiative before pagination").action(async (opts) => {
+  try {
+    requireOutreachProject();
+    print(await new ErdoClient().listOutreachBatches({
+      limit: opts.limit,
+      cursor: opts.cursor,
+      initiative_ref: opts.initiative
+    }));
+  } catch (e) {
+    fail(e);
+  }
+});
+outreachBatchesCmd.command("get <batch>").description("Read a batch summary, or its paged recipient receipts").option("--recipients", "return recipient eligibility, delivery, and response receipts").option("-l, --limit <n>", "max recipients to return", (v) => parseInt(v, 10)).option("--cursor <cursor>", "opaque next_cursor from the preceding recipient page").action(async (batch, opts) => {
+  try {
+    requireOutreachProject();
+    const client = new ErdoClient();
+    print(
+      opts.recipients ? await client.listOutreachBatchRecipients(batch, opts) : await client.getOutreachBatch(batch)
+    );
+  } catch (e) {
+    fail(e);
+  }
+});
+outreachBatchesCmd.command("act <batch> <action>").description("Apply a replay-safe arm, pause, resume, or cancel action").requiredOption("--action-ref <ref>", "stable idempotency reference for this operator action").option("--preview-revision <revision>", "arm only this reviewed preview revision").option("--eligible-count <n>", "arm only when this many recipients remain eligible", (v) => parseInt(v, 10)).option("--message-hash <hash>", "arm only the reviewed message hash").option("--source-snapshot <ref>", "pause, resume, or cancel only the rendered source snapshot").option("--batch-state <state>", "pause, resume, or cancel only the rendered batch state").option("--batch-updated-at <timestamp>", "pause, resume, or cancel only the rendered batch version").action(
+  async (batch, action, opts) => {
+    try {
+      requireOutreachProject();
+      print(
+        await new ErdoClient().actOnOutreachBatch(batch, {
+          action,
+          action_ref: opts.actionRef,
+          expected_preview_revision: opts.previewRevision,
+          expected_eligible_count: opts.eligibleCount,
+          expected_message_hash: opts.messageHash,
+          expected_source_snapshot_ref: opts.sourceSnapshot,
+          expected_batch_state: opts.batchState,
+          expected_batch_updated_at: opts.batchUpdatedAt
+        })
+      );
+    } catch (e) {
+      fail(e);
+    }
+  }
+);
+var outreachConsentsCmd = outreachCmd.command("consents").description("Declare and read auditable SMS consent evidence");
+outreachConsentsCmd.command("put").description("Declare or revoke one consent grant from a JSON object").requiredOption("-f, --file <path>", "JSON object containing the consent declaration").action(async (opts) => {
+  try {
+    requireOutreachProject();
+    print(await new ErdoClient().putOutreachConsent(readJSONObject(opts.file, "--file")));
+  } catch (e) {
+    fail(e);
+  }
+});
+outreachConsentsCmd.command("list").description("List consent grants in the required project").option("-l, --limit <n>", "max grants to return", (v) => parseInt(v, 10)).option("--cursor <cursor>", "opaque next_cursor from the preceding page").action(async (opts) => {
+  try {
+    requireOutreachProject();
+    print(await new ErdoClient().listOutreachConsents(opts));
+  } catch (e) {
+    fail(e);
+  }
+});
+outreachConsentsCmd.command("get [grant-ref]").description("Read one consent grant by reference, or by recipient and phone").option("--recipient-ref <ref>", "stable lead identity when the grant reference is not known").option("--phone <phone>", "source phone recorded for the recipient").option("--country <code>", "ISO country hint used to normalize --phone").action(async (grantRef, opts) => {
+  try {
+    requireOutreachProject();
+    const byGrant = Boolean(grantRef);
+    const byRecipient = Boolean(opts.recipientRef || opts.phone || opts.country);
+    if (byGrant === byRecipient) {
+      throw new Error("consents get requires either <grant-ref> or all of --recipient-ref, --phone, and --country");
+    }
+    if (!byGrant && !(opts.recipientRef && opts.phone && opts.country)) {
+      throw new Error("consents get by recipient requires --recipient-ref, --phone, and --country together");
+    }
+    print(await new ErdoClient().getOutreachConsent({
+      grant_ref: grantRef,
+      recipient_ref: opts.recipientRef,
+      phone_raw: opts.phone,
+      default_country: opts.country
+    }));
+  } catch (e) {
+    fail(e);
+  }
+});
 sentEmailsCmd.command("get <emailID>").description("Read one sent email, including exact bodies and delivery evidence").action(async (emailID) => {
   try {
     print(await new ErdoClient().getSentEmail(emailID));
@@ -4175,6 +4591,59 @@ sentEmailsCmd.command("get <emailID>").description("Read one sent email, includi
     fail(e);
   }
 });
+var voiceCmd = program.command("voice").description("Read voice agent phone conversations");
+var voiceCallsCmd = voiceCmd.command("calls").description("Inbound and outbound phone call records");
+voiceCallsCmd.command("list").description("List the organization's phone calls, newest first").option("--agent <slug>", "only calls held by this voice agent, by slug").option("--direction <direction>", "only 'inbound' (calls to the agent's number) or 'outbound'").option("--limit <n>", "page size (default 25, max 100)").option("--offset <n>", "rows to skip").option("--cursor <cursor>", "next_cursor from the preceding page (stable paging)").option("--json", "print the raw JSON result instead of a table").action(
+  async (opts) => {
+    try {
+      const res = await new ErdoClient().listVoiceCalls({
+        agent: opts.agent,
+        direction: opts.direction,
+        limit: opts.limit ? Number(opts.limit) : void 0,
+        offset: opts.offset ? Number(opts.offset) : void 0,
+        cursor: opts.cursor
+      });
+      if (opts.json) {
+        print(res);
+        return;
+      }
+      const calls = res.conversations ?? [];
+      if (calls.length === 0) {
+        console.log("No calls match those filters.");
+        return;
+      }
+      printAlignedTable(
+        ["call id", "direction", "from", "to", "status", "secs", "transcript", "started", "summary"],
+        calls.map((call) => [
+          call.call_id,
+          call.direction,
+          call.from_number ?? "",
+          call.to_number,
+          call.status,
+          call.duration_seconds,
+          call.has_transcript ? "yes" : "no",
+          call.created_at,
+          call.transcript_summary
+        ])
+      );
+      process.stderr.write(`showing ${calls.length} call(s)
+`);
+      if (res.next_cursor) {
+        process.stderr.write(`more available \u2014 re-run with --cursor ${res.next_cursor}
+`);
+      }
+    } catch (e) {
+      fail(e);
+    }
+  }
+);
+voiceCallsCmd.command("get <callID>").description("Read one phone call in full: transcript, summary, and per-turn LLM metrics").action(async (callID) => {
+  try {
+    print(await new ErdoClient().getVoiceCall(callID));
+  } catch (e) {
+    fail(e);
+  }
+});
 var datasetsCmd = program.command("datasets").description("Datasets");
 datasetsCmd.command("list").description("List datasets").option(
   "--class <class>",
@@ -4219,6 +4688,32 @@ datasetsCmd.command("purposes").description(
     fail(e);
   }
 });
+datasetsCmd.command("set-purpose <slug> [purpose]").description(
+  "Set (or with --clear, remove) the dataset's purpose \u2014 the org-vocabulary role `datasets purposes` reports. Use it to CORRECT a purpose that names the wrong dataset: one purpose maps to one dataset per org, so a purpose left on the wrong one points everything that resolves through the vocabulary at the wrong rows. Moving a purpose is two calls \u2014 clear it from the old dataset, set it on the right one. Setting a purpose the org already uses elsewhere succeeds and prints a warning naming what it now shadows."
+).option("--clear", "remove the dataset's purpose instead of setting one").option(
+  "--description <text>",
+  "description for a purpose new to this org; ignored when the org already has an entry for it"
+).action(async (slug, purpose, opts) => {
+  try {
+    if (opts.clear && purpose) {
+      fail(new Error("pass a purpose or --clear, not both"));
+      return;
+    }
+    if (!opts.clear && !purpose) {
+      fail(new Error("pass a purpose to set, or --clear to remove one"));
+      return;
+    }
+    const res = await new ErdoClient().setDatasetPurpose(slug, {
+      ...purpose ? { purpose } : {},
+      ...opts.clear ? { clear_purpose: true } : {},
+      ...opts.description ? { purpose_description: opts.description } : {}
+    });
+    for (const w of res.warnings ?? []) console.error(`warning: ${w}`);
+    console.log(res.purpose ? `${slug}	${res.purpose}` : `${slug}	(no purpose)`);
+  } catch (e) {
+    fail(e);
+  }
+});
 datasetsCmd.command("query <slug> <question>").description(
   "Ask a natural-language question of a dataset \u2014 Erdo writes and runs the SQL, and answers with that SQL alongside the values. It runs an agent, so it is slower and two identical questions can produce two different queries: for a deterministic or scripted read, write the SQL yourself with `datasets fetch --sql`."
 ).action(async (slug, question) => {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@erdoai/cli",
-  "version": "0.67.0",
-  "description": "Erdo CLI — drive datasets, pages, and evals from the terminal or CI",
+  "version": "0.71.0",
+  "description": "Erdo CLI \u2014 drive datasets, pages, and evals from the terminal or CI",
   "type": "module",
   "bin": {
     "erdo": "dist/index.js"
@@ -35,7 +35,7 @@
   "scripts": {
     "build": "tsup src/index.ts --format esm --clean",
     "build:check": "tsc --noEmit",
-    "test": "node --import tsx --test src/input.test.ts",
+    "test": "node --import tsx --test src/*.test.ts",
     "dev": "tsx src/index.ts",
     "postinstall": "node scripts/postinstall.mjs",
     "prepublishOnly": "npm run build"
@@ -53,4 +53,4 @@
   "overrides": {
     "esbuild": "^0.28.1"
   }
-}
+}