@erdoai/cli 0.68.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
@@ -434,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.
@@ -869,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".
   //
@@ -1165,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) {
@@ -1910,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}`);
@@ -3019,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}`);
@@ -3027,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"
 );
@@ -3943,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) => {
@@ -4389,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>",
@@ -4433,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.68.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"
@@ -53,4 +53,4 @@
   "overrides": {
     "esbuild": "^0.28.1"
   }
-}
+}