argorant 0.8.0 → 0.10.0

package/README.md

@@ -152,6 +152,30 @@ argorant inboxes connect-google --admin admin@yourdomain.com       # lists mailb
 argorant inboxes connect-google --admin admin@yourdomain.com --emails a@x.com,b@x.com   # or --all
 ```
 
+New mailboxes on their own new domains, ordered from the terminal. The quote shows every domain with its
+first-year and renewal price, the mailboxes, the total and how it is paid. When your workspace saved its card
+for API and agent purchases (you ticked that box when you paid an earlier order, and the setting in
+Settings > Billing is on), the order is charged to that card right away, within any limit you set there, and a
+receipt is emailed to the workspace. Otherwise the order returns a payment link that you pay yourself.
+Nothing is bought before the payment, and setup starts once it went through. Warm-up is included in every
+plan; switch it on per mailbox with `argorant inboxes set <mailbox> --warmup`.
+
+Domains can end in .com, .net, .org, .co, .sbs, .biz or .info (`argorant inboxes endings` prints the live list).
+
+```
+argorant inboxes suggest acme.com [--ending com]                   # free domain names with prices
+argorant inboxes quote --mailboxes 100 --company acme.com          # or --domains getacme.com,tryacme.co
+argorant inboxes order <quote-id> --senders "Elena Vaughn"         # asks first; saved card or a payment link
+argorant inboxes order <quote-id> --senders "Elena Vaughn" --pay-with link   # always a payment link
+argorant inboxes status [<order-id>]                               # steps, domains, renewal, bundles
+argorant inboxes renewal <order-id> <domain> --off                 # Stop renewal (nothing is charged now)
+argorant inboxes renewal <order-id> <domain> --on                  # Turn renewal back on (billed shortly before it renews)
+argorant inboxes cancel-bundle <order-id> <bundle-id> --reason too_expensive [--note "..."] [--keep-domains]
+```
+
+Cancel reasons: `too_expensive`, `not_sending_enough`, `deliverability`, `switching_provider`,
+`campaign_finished`, `other`. `cancel-domain` still works as the old name of `renewal --off`.
+
 `<campaign>` accepts an id or an unambiguous case-insensitive name prefix. Every address is verified before
 it is enrolled; only valid ones send unless `--include-catch-all`. Variables: `{{first_name}}`, `{{last_name}}`,
 `{{company}}`, `{{title}}`; spintax `{a|b}` varies phrasing. `--query "..."` filter enrollment stays available

package/bin/argorant.js

@@ -5,6 +5,7 @@
 // Search, count, reveal, export, and verify B2B contacts from the terminal.
 // Auth: an Argorant API key (ag_live_*) via `argorant login`, or ARGORANT_API_KEY.
 
+const crypto = require("crypto");
 const https = require("https");
 const http = require("http");
 const fs = require("fs");
@@ -178,7 +179,7 @@ function parseArgs(argv) {
 }
 
 // ---- HTTP ----
-function request(method, base, urlPath, { key, query, body } = {}) {
+function request(method, base, urlPath, { key, query, body, headers: extraHeaders } = {}) {
   return new Promise((resolve, reject) => {
     let u;
     try {
@@ -192,7 +193,7 @@ function request(method, base, urlPath, { key, query, body } = {}) {
       }
     }
     const payload = body ? Buffer.from(JSON.stringify(body)) : null;
-    const headers = { Accept: "application/json", "User-Agent": `argorant-cli/${VERSION}` };
+    const headers = { Accept: "application/json", "User-Agent": `argorant-cli/${VERSION}`, ...(extraHeaders || {}) };
     if (key) headers["Authorization"] = `Bearer ${key}`;
     if (payload) {
       headers["Content-Type"] = "application/json";
@@ -912,27 +913,28 @@ async function cmdVerifyFile(args, key) {
   const out = ensureWritable(args.output || "argorant-verified.csv");
   // Interactive-only by design — see reveal/export.
   if (!args.yes && !args.json && process.stdin.isTTY) {
-    const ans = await prompt(`Verify ${bold(emails.length.toLocaleString())} emails? You're billed only for fresh checks from your verification-check pool; recent re-checks are free. [y/N] `);
+    const ans = await prompt(`Verify ${bold(emails.length.toLocaleString())} emails? Fresh checks cost half a credit each; recent re-checks are free. [y/N] `);
     if (!/^y(es)?$/i.test(ans)) return console.log(dim("aborted."));
   }
   const all = [];
-  let charged = 0, cached = 0;
+  let charged = 0, credits = 0, cached = 0;
   for (let i = 0; i < emails.length; i += 500) {
     const chunk = emails.slice(i, i + 500);
     const res = await request("POST", args.base, "/api/mcp/email/verify/batch", { key, body: { emails: chunk } });
     const r = need(res, "verify");
     charged += r.checks_charged || 0;
+    credits += r.credits_charged || 0;
     cached += r.cached || 0;
     for (const row of r.results || []) all.push(row);
     if (!args.json) process.stdout.write(`\r${dim(`verified ${Math.min(i + 500, emails.length).toLocaleString()}/${emails.length.toLocaleString()}`)}`);
   }
   if (!args.json) process.stdout.write("\n");
-  if (args.json) return console.log(JSON.stringify({ ok: true, total: all.length, checks_charged: charged, cached, results: all }, null, 2));
+  if (args.json) return console.log(JSON.stringify({ ok: true, total: all.length, checks_charged: charged, credits_charged: credits, cached, results: all }, null, 2));
   const q = (v) => `"${String(v == null ? "" : v).replace(/"/g, '""')}"`;
   const csv = ["email,status,deliverable", ...all.map((r) => [r.email, r.status, r.deliverable].map(q).join(","))].join("\n") + "\n";
   fs.writeFileSync(out, csv);
   const deliverable = all.filter((r) => r.deliverable).length;
-  console.log(green("✓") + ` ${bold(all.length.toLocaleString())} verified → ${bold(out)}  ${dim(`(${deliverable.toLocaleString()} deliverable · ${charged.toLocaleString()} checks billed · ${cached.toLocaleString()} free)`)}`);
+  console.log(green("✓") + ` ${bold(all.length.toLocaleString())} verified → ${bold(out)}  ${dim(`(${deliverable.toLocaleString()} deliverable · ${charged.toLocaleString()} fresh checks, ${credits.toLocaleString()} credits · ${cached.toLocaleString()} free)`)}`);
 }
 
 // ---- list: save & inspect reusable lead lists (parity with MCP/app). Creating a
@@ -1565,7 +1567,17 @@ async function cmdInboxThreads(argv) {
     console.log(green("✓") + ` ${r.classification}`);
     return;
   }
-  die(`unknown inbox subcommand: ${sub} (list, read, reply, classify)`);
+  if (sub === "forward") {
+    const args = readFlags(argv.slice(1), { "--to": "to", "--note": "note" });
+    const id = args._[0]; if (!id) die("usage: argorant inbox forward <thread-id> --to someone@company.com[,other@company.com] [--note \"...\"]");
+    const to = String(args.to || "").split(",").map((x) => x.trim()).filter(Boolean);
+    if (!to.length) die("give at least one address with --to");
+    const r = need(await request("POST", args.base, `/api/v1/inbox/${encodeURIComponent(id)}/forward`, { key, body: { to, note: args.note || "" } }), "inbox forward");
+    if (args.json) return console.log(JSON.stringify(r, null, 2));
+    console.log(green("✓") + ` Forwarded to ${to.join(", ")} from ${r.from || "the mailbox"}`);
+    return;
+  }
+  die(`unknown inbox subcommand: ${sub} (list, read, reply, forward, classify)`);
 }
 
 async function campaignsAnalytics(argv) {
@@ -1642,6 +1654,14 @@ ${bold("USAGE")}
   ${bold("argorant inboxes")} set <mailbox> [--daily-limit 40] [--warmup|--no-warmup] [--active|--inactive] [--timezone <tz>]
   ${bold("argorant inboxes")} disconnect <mailbox>
   ${bold("argorant inboxes")} connect-google --admin <admin@yourdomain.com> [--emails a,b | --all]
+  ${bold("argorant inboxes")} endings   ${dim("the domain endings on offer (com, net, org, co, sbs, biz, info)")}
+  ${bold("argorant inboxes")} suggest <website|brand> [--ending com] [-n 20]   ${dim("free domain names with prices")}
+  ${bold("argorant inboxes")} quote --mailboxes 100 [--company acme.com] [--domains a.com,b.com] [--currency usd|eur] [--billing month|quarter]
+  ${bold("argorant inboxes")} order <quote-id> --senders "Elena Vaughn[,Mark Hill]" [--website acme.com] [--pay-with link] [-y]   ${dim("the saved card when your workspace allows it, else a payment link")}
+  ${bold("argorant inboxes")} status [<order-id>]
+  ${bold("argorant inboxes")} renewal <order-id> <domain> --off|--on [-y]   ${dim("Stop renewal / Turn renewal back on; nothing is charged now")}
+  ${bold("argorant inboxes")} cancel-bundle <order-id> <bundle-id> --reason <reason> [--note "..."] [--keep-domains] [-y]
+  ${dim("  reasons: too_expensive, not_sending_enough, deliverability, switching_provider, campaign_finished, other")}
   ${bold("argorant blocklist")} list | add <email|domain> | remove <id>
 
   ${bold("argorant inbox")} list [--folder replies|interested|not_interested|out_of_office|bounces|unsubscribes|all] [--campaign <c>] [--q text]
@@ -1763,7 +1783,162 @@ async function cmdInboxes(argv) {
     for (const c of r.connected || []) console.log(dim(`  ${c.email} · ${c.health || "ok"}`));
     return;
   }
-  die(`unknown inboxes subcommand: ${sub} (list, set, disconnect, connect-google)`);
+  if (sub === "endings") {
+    const args = readFlags(argv.slice(1));
+    const r = need(await request("GET", args.base, "/api/v1/inboxes/endings", { key }), "inboxes endings");
+    if (args.json) return console.log(JSON.stringify(r, null, 2));
+    return console.log((r.endings || []).map((e) => "." + e).join("  "));
+  }
+  if (sub === "suggest") {
+    const args = readFlags(argv.slice(1), { "-n": "limit", "--limit": "limit", "--ending": "ending", "--tld": "ending" });
+    const company = args._.join(" ").trim();
+    if (!company) die("usage: argorant inboxes suggest <website|brand> [--ending com] [-n 20]");
+    const query = { company, limit: args.limit ? parseLimit(args.limit, "--limit") : 20 };
+    if (args.ending) query.ending = String(args.ending).replace(/^\./, "").toLowerCase();
+    const r = need(await request("GET", args.base, "/api/v1/inboxes/domains/suggest", { key, query }), "inboxes suggest");
+    if (args.json) return console.log(JSON.stringify(r, null, 2));
+    for (const d of r.results || []) {
+      const price = d.first_year ? `${money(d.first_year.usd, "usd")} first year, ${money(d.renewal.usd, "usd")}/year after` : "";
+      console.log(`${d.available ? green("✓") : dim("x")} ${d.available ? bold(d.name) : dim(d.name)}  ${dim(d.available ? price : "taken")}`);
+    }
+    return;
+  }
+  if (sub === "quote") {
+    const args = readFlags(argv.slice(1), { "--mailboxes": "mailboxes", "--daily-volume": "dailyVolume", "--domains": "domains",
+      "--company": "company", "--currency": "currency", "--billing": "billing" });
+    if (!args.mailboxes && !args.dailyVolume) die("usage: argorant inboxes quote --mailboxes 100 [--company acme.com] [--domains a.com,b.com] [--currency usd|eur] [--billing month|quarter]  (or --daily-volume 500)");
+    const body = {
+      mailboxes: args.mailboxes ? parseLimit(args.mailboxes, "--mailboxes") : null,
+      daily_volume: args.dailyVolume ? parseLimit(args.dailyVolume, "--daily-volume") : null,
+      domains: args.domains ? String(args.domains).split(",").map((x) => x.trim()).filter(Boolean) : [],
+      company: args.company || "",
+      currency: (args.currency || "usd").toLowerCase(),
+      billing: (args.billing || "month").toLowerCase(),
+    };
+    const q = need(await request("POST", args.base, "/api/v1/inboxes/quote", { key, body }), "inboxes quote");
+    if (args.json) return console.log(JSON.stringify(q, null, 2));
+    const cur = q.currency;
+    console.log(bold(`${q.plan.mailboxes} mailboxes on ${q.plan.domains} new domains`) + dim(`  (${q.plan.daily_capacity} cold emails a day)`));
+    for (const d of q.domains || []) {
+      console.log(`  ${d.available ? green("✓") : red("x")} ${d.name}  ${money(d.first_year_cents, cur)} first year, renews at ${money(d.renewal_per_year_cents, cur)}/year${d.available ? "" : red("  not available")}${d.suggested ? dim("  suggested") : ""}`);
+    }
+    console.log(`  Mailboxes: ${money(q.mailboxes.price_cents, cur)} per ${q.mailboxes.billing}`);
+    console.log(bold(`Due today: ${money(q.due_today_cents, cur)}`) + `  then ${money(q.recurring_cents, cur)} per ${q.mailboxes.billing}; domains renew at ${money(q.renewal_per_year_cents, cur)} a year in total`);
+    console.log(dim(q.currency_rule));
+    for (const line of q.included || []) console.log(dim(`  · ${line}`));
+    const card = q.payment && q.payment.saved_card;
+    if (card && card.usable) console.log(bold(`Paid with: the saved ${card.card}, charged right away when you order (within 15 minutes of this quote)`));
+    else if (card) console.log(dim(`Paid with: a payment link${card.reason ? ` (saved card: ${card.reason})` : ""}`));
+    console.log(`\nQuote ${bold(q.quote_id)} ${dim(`(valid until ${String(q.expires_at).slice(0, 16).replace("T", " ")} UTC)`)}`);
+    if (q.can_order) console.log(dim(`Order it:  argorant inboxes order ${q.quote_id} --senders "First Last"`));
+    else console.log(yellow(q.next_step));
+    return;
+  }
+  if (sub === "order") {
+    const args = readFlags(argv.slice(1), { "--senders": "senders", "--sender": "senders", "--website": "website", "--pay-with": "payWith" });
+    const quoteId = args._[0];
+    if (!quoteId || !args.senders) die("usage: argorant inboxes order <quote-id> --senders \"Elena Vaughn[,Mark Hill]\" [--website acme.com] [--pay-with link] [-y]");
+    const payWith = String(args.payWith || "auto").toLowerCase();
+    if (!["auto", "link"].includes(payWith)) die("--pay-with is link (always a payment link); leave it out for the saved card when allowed");
+    const senders = String(args.senders).split(",").map((x) => x.trim()).filter(Boolean).map((full) => {
+      const parts = full.split(/\s+/);
+      if (parts.length < 2) die(`sender "${full}" needs a first and a last name`);
+      return { first_name: parts[0], last_name: parts.slice(1).join(" ") };
+    });
+    if (!args.yes) {
+      const how = payWith === "link" ? "You get a payment link; nothing is bought before you pay it."
+        : "If your workspace saved its card for API and agent purchases (the quote says so), that card is charged now; otherwise you get a payment link.";
+      const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+      const ok = await new Promise((r) => rl.question(`Order the inboxes in quote ${quoteId}? ${how} [y/N] `, (a) => { rl.close(); r(/^y/i.test(a)); }));
+      if (!ok) return console.log(dim("aborted"));
+    }
+    const body = { quote_id: quoteId, senders, website: args.website || "", confirmed: true };
+    if (payWith !== "auto") body.pay_with = payWith;
+    // Same command, same key: running it again returns the same order (and never charges twice).
+    const idem = "cli-" + crypto.createHash("sha256").update(JSON.stringify(body)).digest("hex").slice(0, 40);
+    const r = need(await request("POST", args.base, "/api/v1/inboxes/orders", { key, body, headers: { "Idempotency-Key": idem } }), "inboxes order");
+    if (args.json) return console.log(JSON.stringify(r, null, 2));
+    if (r.status === "paid") {
+      console.log(green("✓") + ` Order ${bold(r.order_id)} paid with the saved ${r.card || "card"}${r.replayed ? dim(" (already placed)") : ""}`);
+      console.log(dim(r.message || ""));
+      console.log(dim(`Track it:  argorant inboxes status ${r.order_id}`));
+      return;
+    }
+    if (!r.checkout_url) return console.log(`Order ${r.order_id}: ${r.status}. ${dim(r.message || "")}`);
+    console.log(green("✓") + ` Order ${bold(r.order_id)}${r.existing || r.replayed ? dim(" (already placed)") : ""}`);
+    if (r.saved_card && r.saved_card.reason) console.log(yellow(`Not charged to the saved card: ${r.saved_card.reason}`));
+    console.log(`Pay here: ${cyan(r.checkout_url)}`);
+    console.log(dim("Nothing is bought until you pay it; setup starts after the payment is confirmed."));
+    console.log(dim(`Track it:  argorant inboxes status ${r.order_id}`));
+    return;
+  }
+  if (sub === "status" || sub === "orders") {
+    const args = readFlags(argv.slice(1));
+    const orderId = sub === "status" ? args._[0] : undefined;
+    const path_ = orderId ? `/api/v1/inboxes/orders/${encodeURIComponent(orderId)}` : "/api/v1/inboxes/orders";
+    const r = need(await request("GET", args.base, path_, { key }), "inboxes status");
+    if (args.json) return console.log(JSON.stringify(r, null, 2));
+    const rows = orderId ? [r] : r.orders || [];
+    if (!rows.length) return console.log(dim("No inbox orders yet. Start with: argorant inboxes quote --mailboxes 100 --company <your website>"));
+    for (const o of rows) {
+      const mb = o.mailboxes || {};
+      console.log(`${bold(o.order_id)}  ${o.status}${o.step ? dim(` · ${o.step}`) : ""}  ${dim(`${mb.created || 0}/${mb.total || 0} mailboxes`)}${o.aging_ends_at ? dim(` · aging ends ${o.aging_ends_at}`) : ""}${o.ordered_via ? dim(` · ordered via API/agent${o.paid_with === "saved_card" ? ", saved card" : ""}`) : ""}`);
+      for (const d of o.domains || []) {
+        console.log(dim(`  ${d.name}${d.expires_at ? ` · expires ${String(d.expires_at).slice(0, 10)}` : ""} · renews at ${money(d.renewal_per_year_cents, o.currency)}/year${d.auto_renew === false ? " · renewal off" : ""}`));
+      }
+      for (const b of (o.billing && o.billing.bundles) || []) {
+        console.log(dim(`  bundle ${b.bundle_id}: ${b.mailboxes} mailboxes on ${(b.domains || []).join(", ")} · ${b.status}${b.ends_at ? ` · ends ${String(b.ends_at).slice(0, 10)}` : ""}`));
+      }
+    }
+    return;
+  }
+  if (sub === "renewal" || sub === "cancel-domain") {
+    // cancel-domain is the old name of `renewal --off` (kept working, deprecated).
+    const args = readFlags(argv.slice(1), {}, { "--on": "on", "--off": "off" });
+    const [orderId, domain] = args._;
+    const on = sub === "renewal" ? (args.on ? true : args.off ? false : null) : false;
+    if (!orderId || !domain || on === null || (args.on && args.off)) die("usage: argorant inboxes renewal <order-id> <domain> --off|--on [-y]");
+    if (sub === "cancel-domain") console.error(dim("cancel-domain is deprecated: use `argorant inboxes renewal <order-id> <domain> --off`."));
+    const question = on
+      ? `Turn renewal back on for ${domain}? Nothing is charged now; it renews at its expiry date, billed shortly before. [y/N] `
+      : `Stop renewal for ${domain}? Nothing is charged now; it keeps working until its expiry date and is not renewed. [y/N] `;
+    if (!args.yes) {
+      const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+      const ok = await new Promise((r) => rl.question(question, (a) => { rl.close(); r(/^y/i.test(a)); }));
+      if (!ok) return console.log(dim("aborted"));
+    }
+    const r = need(await request("POST", args.base, `/api/v1/inboxes/orders/${encodeURIComponent(orderId)}/domains/${encodeURIComponent(domain)}/renewal`,
+      { key, body: { on } }), "inboxes renewal");
+    if (args.json) return console.log(JSON.stringify(r, null, 2));
+    return console.log(green("✓") + ` ${r.message || (on ? `${domain} renews again` : `${domain} will not renew`)}`);
+  }
+  if (sub === "cancel-bundle") {
+    const REASONS = ["too_expensive", "not_sending_enough", "deliverability", "switching_provider", "campaign_finished", "other"];
+    const args = readFlags(argv.slice(1), { "--reason": "reason", "--note": "note" }, { "--keep-domains": "keepDomains" });
+    const [orderId, target] = args._;
+    if (!orderId || !target || !args.reason) die("usage: argorant inboxes cancel-bundle <order-id> <bundle-id> --reason <reason> [--note \"...\"] [--keep-domains] [-y]\n  reasons: " + REASONS.join(", "));
+    const reason = String(args.reason).toLowerCase();
+    if (!REASONS.includes(reason)) die(`--reason is one of: ${REASONS.join(", ")}`);
+    const question = `Cancel bundle ${target}? Billing for its mailboxes stops now (no refund); they work until the paid period ends, then they are deleted${args.keepDomains ? "" : " and its domains stop renewing"}. [y/N] `;
+    if (!args.yes) {
+      const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+      const ok = await new Promise((r) => rl.question(question, (a) => { rl.close(); r(/^y/i.test(a)); }));
+      if (!ok) return console.log(dim("aborted"));
+    }
+    const body = { keep_domains: !!args.keepDomains, reason };
+    if (args.note) body.note = String(args.note);
+    const r = need(await request("POST", args.base, `/api/v1/inboxes/orders/${encodeURIComponent(orderId)}/bundles/${encodeURIComponent(target)}/cancel`,
+      { key, body }), "inboxes cancel-bundle");
+    if (args.json) return console.log(JSON.stringify(r, null, 2));
+    return console.log(green("✓") + ` Bundle ${target} cancelled${r.existing ? dim(" (already)") : ""}`);
+  }
+  die(`unknown inboxes subcommand: ${sub} (list, set, disconnect, connect-google, endings, suggest, quote, order, status, renewal, cancel-bundle)`);
+}
+
+function money(cents, currency) {
+  if (cents === null || cents === undefined) return "?";
+  const sign = String(currency || "usd").toLowerCase() === "eur" ? "€" : "$";
+  return sign + (Number(cents) / 100).toFixed(2);
 }
 
 function help() {
@@ -1795,7 +1970,8 @@ ${bold("COMMANDS")}
   ${cyan("verify")} --file emails.csv -o out.csv      Bulk-verify your own list ${dim("(recent re-checks free)")}
   ${cyan("campaigns")} ...                Email outreach: create, write, enroll, launch ${dim("(argorant campaigns help)")}
   ${cyan("inboxes")} list | connect-google  Connected mailboxes; connect a Google Workspace
-  ${cyan("inbox")} list | read | reply | classify   Replies across campaigns; answer in-thread
+  ${cyan("inboxes")} quote | order | status | renewal  New mailboxes on new domains ${dim("(saved card or payment link)")}
+  ${cyan("inbox")} list | read | reply | forward | classify   Replies across campaigns; answer in-thread or forward
   ${cyan("blocklist")} list | add | remove       Addresses and domains never contacted
 
 ${bold("FILTERS")}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "argorant",
-  "version": "0.8.0",
+  "version": "0.10.0",
   "description": "Search, count, reveal, export, and verify B2B contacts from the Argorant database — from your terminal, scripts, or coding agent.",
   "bin": {
     "argorant": "bin/argorant.js"