argorant 0.7.0 → 0.8.0

package/bin/argorant.js

@@ -1568,6 +1568,47 @@ async function cmdInboxThreads(argv) {
   die(`unknown inbox subcommand: ${sub} (list, read, reply, classify)`);
 }
 
+async function campaignsAnalytics(argv) {
+  const key = requireKey();
+  const args = readFlags(argv, { "--days": "days" });
+  const identifier = args._[0];
+  if (!identifier) die("usage: argorant campaigns analytics <campaign> [--days 30]");
+  const campaignId = await resolveCampaign(args.base, key, identifier);
+  const r = need(await request("GET", args.base, `/api/v1/campaigns/${campaignId}/analytics`, { key, query: { days: args.days || 30 } }), "campaigns analytics");
+  if (args.json) return console.log(JSON.stringify(r, null, 2));
+  const t = r.totals || {};
+  console.log(`${bold("last " + r.days + " days")}  sent ${Number(t.sent || 0).toLocaleString()} · replies ${Number(t.replies || 0).toLocaleString()} (${t.reply_rate}%) · positive ${Number(t.positive || 0).toLocaleString()} · bounces ${Number(t.bounces || 0).toLocaleString()} (${t.bounce_rate}%) · unsubscribes ${Number(t.unsubscribes || 0).toLocaleString()}`);
+  for (const d of r.series || []) console.log(dim(`  ${d.day}  sent ${d.sent}  replies ${d.replies}  positive ${d.positive}  bounces ${d.bounces}`));
+}
+
+async function cmdBlocklist(argv) {
+  const sub = argv[0] || "list";
+  const key = requireKey();
+  if (sub === "list") {
+    const args = readFlags(argv.slice(1));
+    const r = need(await request("GET", args.base, "/api/v1/blocklist", { key }), "blocklist");
+    if (args.json) return console.log(JSON.stringify(r, null, 2));
+    if (!(r.entries || []).length) return console.log(dim("Blocklist is empty."));
+    for (const e of r.entries) console.log(`${e.type === "domain" ? "@" : " "}${e.value}  ${dim(e.reason || "")}${e.yours ? "" : dim("  (Argorant-wide)")}  ${dim(e.id)}`);
+    return;
+  }
+  if (sub === "add") {
+    const args = readFlags(argv.slice(1), { "--reason": "reason" });
+    const value = args._[0]; if (!value) die("usage: argorant blocklist add <email|domain> [--reason text]");
+    const r = need(await request("POST", args.base, "/api/v1/blocklist", { key, body: { value, reason: args.reason || "manual" } }), "blocklist add");
+    if (args.json) return console.log(JSON.stringify(r, null, 2));
+    return console.log(green("✓") + ` Blocked ${r.type} ${r.value}` + (r.leads_suppressed ? dim(`  (${r.leads_suppressed} enrolled lead(s) suppressed)`) : ""));
+  }
+  if (sub === "remove") {
+    const args = readFlags(argv.slice(1));
+    const id = args._[0]; if (!id) die("usage: argorant blocklist remove <entry-id>");
+    const r = need(await request("DELETE", args.base, `/api/v1/blocklist/${encodeURIComponent(id)}`, { key }), "blocklist remove");
+    if (args.json) return console.log(JSON.stringify(r, null, 2));
+    return console.log(green("✓") + ` Removed ${r.removed}`);
+  }
+  die(`unknown blocklist subcommand: ${sub} (list, add, remove)`);
+}
+
 function campaignsHelp() {
   const p = bold("argorant campaigns");
   console.log(`
@@ -1590,6 +1631,7 @@ ${bold("USAGE")}
   ${p} senders set <campaign> --emails a@x.com,b@y.com | --all
   ${p} senders remove <campaign> <mailbox>
   ${p} replies <campaign> [-n 50]
+  ${p} analytics <campaign> [--days 30]   ${dim("daily sent / replies / positive / bounces")}
   ${p} delete <campaign> [-y]
   ${p} launch <campaign> [-y]      ${dim("asks for confirmation; sends real email")}
   ${p} pause <campaign>
@@ -1597,7 +1639,10 @@ ${bold("USAGE")}
   ${p} status <campaign>
 
   ${bold("argorant inboxes")} list
+  ${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 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]
   ${bold("argorant inbox")} read <thread-id>
@@ -1634,6 +1679,7 @@ async function cmdCampaigns(argv) {
     set: campaignsUpdate,
     delete: campaignsDelete,
     replies: campaignsReplies,
+    analytics: campaignsAnalytics,
     emails: campaignsEmails,
     steps: campaignsSteps,
     senders: campaignsSenders,
@@ -1666,6 +1712,33 @@ async function cmdInboxes(argv) {
     }
     return;
   }
+  if (sub === "set") {
+    const args = readFlags(argv.slice(1), { "--daily-limit": "dailyLimit", "--name": "name", "--timezone": "timezone" }, { "--warmup": "warmupOn", "--no-warmup": "warmupOff", "--active": "activeOn", "--inactive": "activeOff" });
+    const email = args._[0]; if (!email) die("usage: argorant inboxes set <mailbox> [--daily-limit 40] [--warmup|--no-warmup] [--active|--inactive] [--name \"…\"] [--timezone Europe/Berlin]");
+    const body = {};
+    if (args.dailyLimit) body.daily_limit = parseLimit(args.dailyLimit, "--daily-limit");
+    if (args.warmupOn) body.warmup = true; if (args.warmupOff) body.warmup = false;
+    if (args.activeOn) body.active = true; if (args.activeOff) body.active = false;
+    if (args.name !== undefined) body.display_name = args.name;
+    if (args.timezone) body.timezone = args.timezone;
+    if (!Object.keys(body).length) die("nothing to change");
+    const r = need(await request("PATCH", args.base, `/api/v1/inboxes/${encodeURIComponent(email)}`, { key, body }), "inboxes set");
+    if (args.json) return console.log(JSON.stringify(r, null, 2));
+    const i = r.inbox || {};
+    return console.log(green("✓") + ` ${i.email}: ${i.daily_limit} a day · warm-up ${i.warmup ? "on" : "off"} · ${i.active ? "active" : "inactive"} · ${i.timezone || ""}`);
+  }
+  if (sub === "disconnect") {
+    const args = readFlags(argv.slice(1));
+    const email = args._[0]; if (!email) die("usage: argorant inboxes disconnect <mailbox> [-y]");
+    if (!args.yes) {
+      const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+      const ok = await new Promise((r) => rl.question(`Disconnect ${email}? It is detached from every campaign. [y/N] `, (a) => { rl.close(); r(/^y/i.test(a)); }));
+      if (!ok) return console.log(dim("aborted"));
+    }
+    const r = need(await request("DELETE", args.base, `/api/v1/inboxes/${encodeURIComponent(email)}`, { key }), "inboxes disconnect");
+    if (args.json) return console.log(JSON.stringify(r, null, 2));
+    return console.log(green("✓") + ` Disconnected ${r.disconnected}`);
+  }
   if (sub === "connect-google") {
     const args = readFlags(argv.slice(1), { "--admin": "admin", "--emails": "emails" }, { "--all": "all" });
     if (!args.admin) die("usage: argorant inboxes connect-google --admin admin@yourdomain.com [--emails a@x.com,b@x.com | --all]");
@@ -1690,7 +1763,7 @@ 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, connect-google)`);
+  die(`unknown inboxes subcommand: ${sub} (list, set, disconnect, connect-google)`);
 }
 
 function help() {
@@ -1723,6 +1796,7 @@ ${bold("COMMANDS")}
   ${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("blocklist")} list | add | remove       Addresses and domains never contacted
 
 ${bold("FILTERS")}
   --keywords <k>     Comma = OR. The widest, most reliable filter - prefer it
@@ -1780,9 +1854,10 @@ async function main() {
   // `campaigns` has its own flag vocabulary (--step, --count, --pool, --csv, ...)
   // handled by readFlags — it never goes through the generic filter parser
   // below, which would reject those flags as unknown.
-  if (cmd === "campaigns" || cmd === "campaign" || cmd === "inboxes" || cmd === "mailboxes" || cmd === "inbox" || cmd === "unibox") {
+  if (cmd === "campaigns" || cmd === "campaign" || cmd === "inboxes" || cmd === "mailboxes" || cmd === "inbox" || cmd === "unibox" || cmd === "blocklist") {
     try {
       if (cmd.startsWith("campaign")) await cmdCampaigns(argv.slice(1));
+      else if (cmd === "blocklist") await cmdBlocklist(argv.slice(1));
       else if (cmd === "inbox" || cmd === "unibox") await cmdInboxThreads(argv.slice(1));
       else await cmdInboxes(argv.slice(1));
     } catch (e) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "argorant",
-  "version": "0.7.0",
+  "version": "0.8.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"