argorant 0.8.0 → 0.9.0

package/README.md

@@ -152,6 +152,19 @@ 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 and the total; the order returns a checkout link that you pay
+yourself. Nothing is bought before that payment, and setup starts once it is confirmed. Warm-up is included
+in every plan; switch it on per mailbox with `argorant inboxes set <mailbox> --warmup`.
+
+```
+argorant inboxes suggest acme.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; prints the checkout link
+argorant inboxes status [<order-id>]                               # steps, domains, renewal prices, bundles
+argorant inboxes cancel-bundle <order-id> <bundle-id> [--keep-domains]   |   cancel-domain <order-id> <domain>
+```
+
 `<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,11 @@ ${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")} suggest <website|brand> [-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] [-y]   ${dim("returns a checkout link; nothing is bought before you pay it")}
+  ${bold("argorant inboxes")} status [<order-id>]
+  ${bold("argorant inboxes")} cancel-bundle <order-id> <bundle-id> [--keep-domains] [-y]  |  cancel-domain <order-id> <domain> [-y]
   ${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 +1780,119 @@ 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 === "suggest") {
+    const args = readFlags(argv.slice(1), { "-n": "limit", "--limit": "limit" });
+    const company = args._.join(" ").trim();
+    if (!company) die("usage: argorant inboxes suggest <website|brand> [-n 20]");
+    const query = { company, limit: args.limit ? parseLimit(args.limit, "--limit") : 20 };
+    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}`));
+    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" });
+    const quoteId = args._[0];
+    if (!quoteId || !args.senders) die("usage: argorant inboxes order <quote-id> --senders \"Elena Vaughn[,Mark Hill]\" [--website acme.com] [-y]");
+    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 rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+      const ok = await new Promise((r) => rl.question(`Order the inboxes in quote ${quoteId}? You get a checkout link to pay; nothing is bought before that. [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 };
+    // Same command, same key: running it again returns the same order and link instead of a second order.
+    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.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)") : ""}`);
+    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}`) : ""}`);
+      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 === "cancel-bundle" || sub === "cancel-domain") {
+    const args = readFlags(argv.slice(1), {}, { "--keep-domains": "keepDomains" });
+    const [orderId, target] = args._;
+    if (!orderId || !target) die(sub === "cancel-bundle" ? "usage: argorant inboxes cancel-bundle <order-id> <bundle-id> [--keep-domains] [-y]" : "usage: argorant inboxes cancel-domain <order-id> <domain> [-y]");
+    const question = sub === "cancel-bundle"
+      ? `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] `
+      : `Stop renewing ${target}? It works 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 base = `/api/v1/inboxes/orders/${encodeURIComponent(orderId)}`;
+    const r = sub === "cancel-bundle"
+      ? need(await request("POST", args.base, `${base}/bundles/${encodeURIComponent(target)}/cancel`, { key, body: { keep_domains: !!args.keepDomains } }), "inboxes cancel-bundle")
+      : need(await request("POST", args.base, `${base}/domains/${encodeURIComponent(target)}/cancel`, { key, body: {} }), "inboxes cancel-domain");
+    if (args.json) return console.log(JSON.stringify(r, null, 2));
+    return console.log(green("✓") + (sub === "cancel-bundle" ? ` Bundle ${target} cancelled${r.existing ? dim(" (already)") : ""}` : ` ${target} will not renew`));
+  }
+  die(`unknown inboxes subcommand: ${sub} (list, set, disconnect, connect-google, suggest, quote, order, status, cancel-bundle, cancel-domain)`);
+}
+
+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 +1924,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  New mailboxes on new domains ${dim("(you pay each order at checkout)")}
+  ${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.9.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"