@erdoai/cli 0.68.0 → 0.72.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
@@ -327,6 +332,33 @@ var ErdoClient = class {
       { successor_manager_slug: successorManagerSlug }
     );
   }
+  // Reads the Google Ads container a managed org already has under this manager
+  // and creates nothing, so it is safe to run against an org mid-setup: a 404
+  // means the org has no container here, not that anything is broken.
+  getManagedOrganizationAdsContainer(slug) {
+    return this.request(
+      "GET",
+      `/v1/managed-organizations/${encodeURIComponent(slug)}/ads-container`
+    );
+  }
+  // Creates the container — a sub-account under the manager's MCC plus the
+  // delegated connection inside the managed org. `replaceCurrentAccount` is the
+  // one input with consequences: provisioning refuses outright when the org is
+  // already running campaigns in another account, and passing this accepts that
+  // those campaigns are left behind, so the key is sent only when it is asked
+  // for rather than as a `false` the server has to read.
+  provisionManagedOrganizationAdsContainer(slug, input) {
+    const body = {};
+    if (input.descriptiveName) body.descriptive_name = input.descriptiveName;
+    if (input.currencyCode) body.currency_code = input.currencyCode;
+    if (input.timeZone) body.time_zone = input.timeZone;
+    if (input.replaceCurrentAccount) body.replace_current_account = true;
+    return this.request(
+      "POST",
+      `/v1/managed-organizations/${encodeURIComponent(slug)}/ads-container`,
+      body
+    );
+  }
   // --- Custom page domains: the branded hostnames the org's pages serve from ---
   listCustomDomains() {
     return this.request("GET", "/v1/custom-domains");
@@ -434,6 +466,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.
@@ -869,6 +917,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".
   //
@@ -1165,17 +1221,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) {
@@ -1910,9 +1985,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}`);
@@ -1942,6 +2028,76 @@ managed.command("add-member <orgSlug> <email>").description("Seat a person in a
     fail(e);
   }
 });
+function printAdsContainer(c) {
+  console.log(`org: ${c.org_slug}`);
+  console.log(`customer id: ${c.customer_id}`);
+  console.log(`manager (login customer id): ${c.login_customer_id}`);
+  console.log(`integration: ${c.integration_id}`);
+  if (c.descriptive_name) {
+    console.log(`name: ${c.descriptive_name}`);
+  }
+  console.log(`billing: ${c.billing_status}`);
+  if (c.billing_status === "unknown") {
+    process.stderr.write(
+      `Billing could not be checked for ${c.customer_id} \u2014 open the account in the Google Ads UI and confirm; this is not evidence that billing is missing.
+`
+    );
+  } else if (!c.billing_configured) {
+    process.stderr.write(
+      `Billing is ${c.billing_status}: ${c.customer_id} cannot serve until a payments profile is linked to it in the Google Ads UI.
+`
+    );
+  }
+}
+managed.command("ads-container <orgSlug>").description(
+  "Read the Google Ads account a managed org runs its campaigns in, or --provision one under your manager account"
+).option("--provision", "create the account and the org's delegated google_ads connection instead of reading them").option(
+  "--replace-current-account",
+  "with --provision: go ahead even though the org already runs campaigns in another account. Google Ads cannot move a campaign, so those campaigns stay behind and have to be rebuilt"
+).option("--name <descriptiveName>", "display name for the new account (default: the org's name and slug)").option("--currency <code>", "ISO currency code for the new account, e.g. USD").option("--time-zone <tz>", "IANA time zone for the new account, e.g. America/New_York").action(
+  async (orgSlug, opts) => {
+    try {
+      if (opts.replaceCurrentAccount && !opts.provision) {
+        fail(new Error("--replace-current-account only applies with --provision"));
+      }
+      const api = new ErdoClient();
+      if (!opts.provision) {
+        try {
+          printAdsContainer(await api.getManagedOrganizationAdsContainer(orgSlug));
+        } catch (e) {
+          if (e instanceof ErdoApiError && e.status === 404) {
+            fail(
+              new Error(
+                `${orgSlug} has no Google Ads container under this manager. Create one with: erdo org managed ads-container ${orgSlug} --provision`
+              )
+            );
+          }
+          throw e;
+        }
+        return;
+      }
+      const c = await api.provisionManagedOrganizationAdsContainer(orgSlug, {
+        descriptiveName: opts.name,
+        currencyCode: opts.currency,
+        timeZone: opts.timeZone,
+        replaceCurrentAccount: opts.replaceCurrentAccount
+      });
+      console.log(
+        c.already_provisioned ? `Google Ads container already existed for ${c.org_slug}` : `Created Google Ads container for ${c.org_slug}`
+      );
+      printAdsContainer(c);
+      const leftBehind = c.previous_campaign_count ?? 0;
+      if (c.previous_customer_id && leftBehind > 0) {
+        process.stderr.write(
+          `${leftBehind} campaign${leftBehind === 1 ? "" : "s"} stayed in ${c.previous_customer_id}, the account this replaced. Google Ads cannot move a campaign between accounts and nothing in ${c.org_slug} resolves that account any more, so they have to be rebuilt in ${c.customer_id}.
+`
+        );
+      }
+    } catch (e) {
+      fail(e);
+    }
+  }
+);
 managed.command("handoff-token <orgSlug>").description("Mint a one-time token offering an ownerless managed org to another manager; shown ONCE").requiredOption("--successor <managerOrgSlug>", "the manager org allowed to redeem the token").action(async (orgSlug, opts) => {
   try {
     const res = await new ErdoClient().createManagedOrganizationHandoffToken(orgSlug, opts.successor);
@@ -3019,7 +3175,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}`);
@@ -3027,13 +3183,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"
 );
@@ -3833,7 +4106,13 @@ function grantList(v) {
 pagesCmd.command("deploy").description("Deploy a page (HTML/React); --html/--js/--css accept @file").requiredOption("--title <title>", "page title").requiredOption("--html <htmlOr@file>", "HTML (or @path to a file)").option("--js <jsOr@file>", "JS/JSX (or @path)").option("--css <cssOr@file>", "CSS (or @path)").option("--runtime <runtime>", "react-tailwind (default) or none").option(
   "--meta-title <title>",
   "public SEO title (browser tab + shared-link headline) \u2014 distinct from --title, the internal name"
-).option("--meta-description <description>", "public SEO description (shared-link preview / search result blurb)").option("--datasets <csv>", "dataset slugs the page reads").option("--writable-datasets <csv>", "dataset slugs the page may write via erdo.insertRows").option("--kv <csv>", "named KV-store slugs the page reads").option("--writable-kv <csv>", "named KV-store slugs the page may write").option("--public", "make the page publicly viewable").action(
+).option("--meta-description <description>", "public SEO description (shared-link preview / search result blurb)").option(
+  "--meta-icon-asset <attachmentId>",
+  "public favicon: a Brand Style attachment id (apple-icon-180x180 / favicon-32x32) for the browser-tab icon"
+).option(
+  "--meta-image-asset <attachmentId>",
+  "public share image: a Brand Style attachment id (og-image / hero photo) for the link-preview card"
+).option("--datasets <csv>", "dataset slugs the page reads").option("--writable-datasets <csv>", "dataset slugs the page may write via erdo.insertRows").option("--kv <csv>", "named KV-store slugs the page reads").option("--writable-kv <csv>", "named KV-store slugs the page may write").option("--public", "make the page publicly viewable").action(
   async (opts) => {
     try {
       const csv = (v) => v ? v.split(",").map((s) => s.trim()) : void 0;
@@ -3845,6 +4124,8 @@ pagesCmd.command("deploy").description("Deploy a page (HTML/React); --html/--js/
         runtime: opts.runtime,
         meta_title: opts.metaTitle,
         meta_description: opts.metaDescription,
+        meta_icon_asset_id: opts.metaIconAsset,
+        meta_image_asset_id: opts.metaImageAsset,
         dataset_slugs: csv(opts.datasets),
         writable_dataset_slugs: csv(opts.writableDatasets),
         kv_slugs: csv(opts.kv),
@@ -3863,7 +4144,13 @@ pagesCmd.command("update <id>").description(
 ).option("--title <title>", "new title").option("--html <htmlOr@file>", "HTML (or @path to a file)").option("--js <jsOr@file>", "JS/JSX (or @path)").option("--css <cssOr@file>", "CSS (or @path)").option(
   "--meta-title <title>",
   'new public SEO title (omit to keep current; pass "" to clear back to the default)'
-).option("--meta-description <description>", 'new public SEO description (omit to keep current; pass "" to clear)').option("--datasets <csv>", 'replacement read-dataset slugs ("[]" clears)').option("--writable-datasets <csv>", 'replacement writable-dataset slugs ("[]" clears)').option("--kv <csv>", 'replacement read KV-store slugs ("[]" clears)').option("--writable-kv <csv>", 'replacement writable KV-store slugs ("[]" clears)').option("--public", "make the page publicly viewable").option("--private", "make the page private").option(
+).option("--meta-description <description>", 'new public SEO description (omit to keep current; pass "" to clear)').option(
+  "--meta-icon-asset <attachmentId>",
+  'new public favicon: a Brand Style attachment id (apple-icon-180x180 / favicon-32x32) (omit to keep current; pass "" to clear back to the default)'
+).option(
+  "--meta-image-asset <attachmentId>",
+  'new public share image: a Brand Style attachment id (og-image / hero photo) (omit to keep current; pass "" to clear)'
+).option("--datasets <csv>", 'replacement read-dataset slugs ("[]" clears)').option("--writable-datasets <csv>", 'replacement writable-dataset slugs ("[]" clears)').option("--kv <csv>", 'replacement read KV-store slugs ("[]" clears)').option("--writable-kv <csv>", 'replacement writable KV-store slugs ("[]" clears)').option("--public", "make the page publicly viewable").option("--private", "make the page private").option(
   "--request-review",
   "ask the judge lenses to review the page after this update and report findings -- for material edits to a LIVE page (layout, forms/CTA, legal/compliance copy, restructured sections), not cosmetic tweaks. First builds and full rewrites are already reviewed automatically"
 ).action(
@@ -3876,6 +4163,8 @@ pagesCmd.command("update <id>").description(
         css: readMaybeFile(opts.css),
         meta_title: opts.metaTitle,
         meta_description: opts.metaDescription,
+        meta_icon_asset_id: opts.metaIconAsset,
+        meta_image_asset_id: opts.metaImageAsset,
         dataset_slugs: grantList(opts.datasets),
         writable_dataset_slugs: grantList(opts.writableDatasets),
         kv_slugs: grantList(opts.kv),
@@ -3943,6 +4232,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) => {
@@ -4389,6 +4704,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>",
@@ -4433,6 +4801,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.68.0",
-  "description": "Erdo CLI — drive datasets, pages, and evals from the terminal or CI",
+  "version": "0.72.0",
+  "description": "Erdo CLI \u2014 drive datasets, pages, and evals from the terminal or CI",
   "type": "module",
   "bin": {
     "erdo": "dist/index.js"
@@ -53,4 +53,4 @@
   "overrides": {
     "esbuild": "^0.28.1"
   }
-}
+}