@erdoai/cli 0.66.0 → 0.68.0

package/dist/index.js

@@ -331,8 +331,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(
@@ -464,7 +486,7 @@ var ErdoClient = class {
       `/v1/evals/suites/${encodeURIComponent(slug)}/cases/${encodeURIComponent(caseName)}`
     );
   }
-  runEvalSuite(slug, concurrency, commitSha, frontendCommitSha, backendCommitSha, source, modelOverride) {
+  runEvalSuite(slug, concurrency, commitSha, frontendCommitSha, backendCommitSha, source, modelOverride, rotateCases) {
     return this.request(
       "POST",
       `/v1/evals/suites/${encodeURIComponent(slug)}/run`,
@@ -474,7 +496,8 @@ var ErdoClient = class {
         frontend_commit_sha: frontendCommitSha,
         backend_commit_sha: backendCommitSha,
         source,
-        model_override: modelOverride
+        model_override: modelOverride,
+        rotate_cases: rotateCases
       }
     );
   }
@@ -887,6 +910,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);
   }
@@ -1533,6 +1619,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) {
@@ -2551,7 +2656,13 @@ evalCmd.command("create <name>").description("Create a suite (in the active org)
     }
   }
 );
-evalCmd.command("run <slug>").description("Run a suite; --watch polls until it completes").option("-w, --watch", "poll until the run finishes and print results").option("-c, --concurrency <n>", "parallel cases", (v) => parseInt(v, 10)).option("--commit-sha <sha>", "full 40-character Git commit SHA to associate with the run").option("--frontend-commit-sha <sha>", "frontend revision in the evaluated production snapshot").option("--backend-commit-sha <sha>", "backend revision in the evaluated production snapshot").option("--source <source>", "staff-only run source: post_deploy, nightly, or rollback").option("--model <model>", "pin the suite's agent to a model for this run (e.g. glm-5.3) \u2014 for model comparisons").action(async (slug, opts) => {
+evalCmd.command("run <slug>").description("Run a suite; --watch polls until it completes").option("-w, --watch", "poll until the run finishes and print results").option("-c, --concurrency <n>", "parallel cases", (v) => parseInt(v, 10)).option("--commit-sha <sha>", "full 40-character Git commit SHA to associate with the run").option("--frontend-commit-sha <sha>", "frontend revision in the evaluated production snapshot").option("--backend-commit-sha <sha>", "backend revision in the evaluated production snapshot").option("--source <source>", "staff-only run source: post_deploy, nightly, or rollback").option("--model <model>", "pin the suite's agent to a model for this run (e.g. glm-5.3) \u2014 for model comparisons").option("--rotate-cases <n>", "run a rotating subset of n cases (deterministic per suite + UTC day) instead of all cases", (v) => {
+  const parsed = parseInt(v, 10);
+  if (isNaN(parsed) || parsed < 0) {
+    throw new Error(`--rotate-cases must be a non-negative integer, got "${v}"`);
+  }
+  return parsed;
+}).action(async (slug, opts) => {
   try {
     const api = new ErdoClient();
     const { suite } = await api.getEvalSuite(slug);
@@ -2574,7 +2685,8 @@ evalCmd.command("run <slug>").description("Run a suite; --watch polls until it c
       opts.frontendCommitSha,
       opts.backendCommitSha,
       opts.source,
-      opts.model
+      opts.model,
+      opts.rotateCases
     );
     console.log(`run_id: ${run_id}`);
     if (!opts.watch) return;
@@ -3916,17 +4028,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) {
@@ -3937,6 +4053,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);
@@ -4160,6 +4290,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));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@erdoai/cli",
-  "version": "0.66.0",
+  "version": "0.68.0",
   "description": "Erdo CLI — drive datasets, pages, and evals from the terminal or CI",
   "type": "module",
   "bin": {
@@ -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"