argorant 0.6.0 → 0.7.0

package/README.md

@@ -136,7 +136,16 @@ argorant campaigns leads add <campaign> --list <list-id>           # a saved lis
 argorant campaigns leads add <campaign> --csv leads.csv            # email, first_name, last_name, company, title
 argorant campaigns senders set <campaign> --emails a@x.com,b@y.com # or --all
 argorant campaigns launch <campaign> [-y]                          # asks for confirmation
-argorant campaigns pause | stop | status <campaign>
+argorant campaigns update <campaign> --daily-limit 40 --window 08:00-17:00 --timezone Europe/Berlin --timezone-mode lead --gap 60-120 --tags q4
+argorant campaigns leads list <campaign> [--status replied]   |   leads remove <campaign> <email>
+argorant campaigns senders remove <campaign> <mailbox>
+argorant campaigns replies <campaign>
+argorant campaigns pause | stop | status | delete <campaign>
+
+argorant inbox list [--folder replies|interested|not_interested|out_of_office|bounces|unsubscribes] [--campaign <c>] [--q text]
+argorant inbox read <thread-id>
+argorant inbox reply <thread-id> --body "..." [-y]
+argorant inbox classify <thread-id> meeting_booked
 
 argorant inboxes list
 argorant inboxes connect-google --admin admin@yourdomain.com       # lists mailboxes (or the delegation setup to do first)

package/bin/argorant.js

@@ -1119,35 +1119,19 @@ async function campaignsList(argv) {
 
 async function campaignsCreate(argv) {
   const key = requireKey();
-  const args = readFlags(
-    argv,
-    { "--name": "name", "--timezone": "timezone", "--daily-limit": "dailyLimit", "--gap": "gap", "--start": "start" },
-    { "--html": "html" }
-  );
+  const args = readFlags(argv, CAMPAIGN_SETTING_FLAGS, CAMPAIGN_SETTING_BOOLS);
   const name = (args.name || "").trim();
   if (!name) {
-    die('usage: argorant campaigns create --name "<name>" [--daily-limit 100] [--timezone America/New_York] [--gap 60-120] [--start YYYY-MM-DD] [--html]');
-  }
-  const body = { name };
-  if (args.timezone) body.timezone = args.timezone;
-  if (args.dailyLimit) body.daily_limit = parseLimit(args.dailyLimit, "--daily-limit");
-  if (args.gap) {
-    const m = /^(\d+)(?:-(\d+))?$/.exec(args.gap);
-    if (!m) die("--gap must look like 60-120 (minutes between two sends from one mailbox)");
-    body.gap_minutes_min = Number(m[1]);
-    body.gap_minutes_max = Number(m[2] || m[1]);
-  }
-  if (args.start) {
-    if (!/^\d{4}-\d{2}-\d{2}$/.test(args.start)) die("--start must be YYYY-MM-DD");
-    body.planned_start_date = args.start;
+    die('usage: argorant campaigns create --name "<name>" [--daily-limit 100] [--per-mailbox-limit 20] [--timezone America/New_York] [--timezone-mode fixed|lead] [--window 08:00-17:00] [--no-skip-weekends] [--gap 60-120] [--no-unsubscribe] [--start YYYY-MM-DD] [--tags a,b]');
   }
-  if (args.html) body.plain_text = false;
+  const body = settingsFromFlags(args);
+  body.name = name;
   const res = await request("POST", args.base, "/api/v1/campaigns", { key, body });
   const r = need(res, "campaigns create");
   const c = r.campaign || r;
   if (args.json) return console.log(JSON.stringify(r, null, 2));
   console.log(green("✓") + ` Created campaign ${bold(c.name || name)} ${dim(c.id)}`);
-  console.log(dim(`  ${c.status || "draft"} · ${c.default_timezone || body.timezone || "America/New_York"} · ${c.daily_limit || body.daily_limit || 100} a day`));
+  printSettings(c);
   console.log(dim(`Next:  argorant campaigns emails set ${c.id} --step 1 --subject "..." --body-file ./copy.txt`));
 }
 
@@ -1205,8 +1189,17 @@ async function campaignsEmails(argv) {
 // senders: which connected mailboxes send this campaign.
 async function campaignsSenders(argv) {
   const sub = argv[0];
-  if (sub !== "set") die("usage: argorant campaigns senders set <campaign> --emails a@x.com,b@y.com | --all");
   const key = requireKey();
+  if (sub === "remove") {
+    const args = readFlags(argv.slice(1));
+    const [identifier, email] = args._;
+    if (!identifier || !email) die("usage: argorant campaigns senders remove <campaign> <mailbox@domain>");
+    const campaignId = await resolveCampaign(args.base, key, identifier);
+    const r = need(await request("DELETE", args.base, `/api/v1/campaigns/${campaignId}/senders/${encodeURIComponent(email)}`, { key }), "campaigns senders remove");
+    if (args.json) return console.log(JSON.stringify(r, null, 2));
+    return console.log(green("✓") + ` Detached ${r.detached}`);
+  }
+  if (sub !== "set") die("usage: argorant campaigns senders set <campaign> --emails a@x.com,b@y.com | --all\n   or: argorant campaigns senders remove <campaign> <mailbox>");
   const args = readFlags(argv.slice(1), { "--emails": "emails" }, { "--all": "all" });
   const identifier = args._[0];
   if (!identifier) die("usage: argorant campaigns senders set <campaign> --emails a@x.com,b@y.com | --all");
@@ -1330,8 +1323,14 @@ async function campaignsLeads(argv) {
     'usage: argorant campaigns leads add <campaign> --list <list-id>\n' +
     '   or: argorant campaigns leads add <campaign> --csv <file>        (columns: email, first_name, last_name, company, title)\n' +
     '   or: argorant campaigns leads add <campaign> --query "..." [filters] -n <n>   (operator keys)';
-  if (sub !== "add") die(usage);
   const key = requireKey();
+  if (sub === "list" || sub === "remove") {
+    const args = readFlags(argv.slice(1), { "--status": "status", "--q": "q", "-n": "limit", "--limit": "limit", "--offset": "offset" });
+    if (!args._[0]) die(`usage: argorant campaigns leads ${sub} <campaign>${sub === "remove" ? " <email>" : " [--status queued|replied|bounced] [--q text] [-n 50]"}`);
+    const campaignId = await resolveCampaign(args.base, key, args._[0]);
+    return sub === "list" ? campaignsLeadsList(args, campaignId, key) : campaignsLeadsRemove(args, campaignId, key);
+  }
+  if (sub !== "add") die(usage);
   const valueFlags = { ...CAMPAIGN_FILTER_VALUE_FLAGS, "--csv": "csv", "--file": "csv", "--list": "list", "-n": "limit", "--limit": "limit" };
   const args = readFlags(argv.slice(1), valueFlags, { ...CAMPAIGN_FILTER_BOOL_FLAGS, "--include-catch-all": "includeCatchAll" });
   const identifier = args._[0];
@@ -1406,7 +1405,8 @@ async function campaignsStatus(argv) {
   const c = r.campaign || {};
   console.log(`${bold(c.name || "—")}  ${dim(c.id)}`);
   console.log(`  status ${bold(c.status)}  ·  leads ${Number(c.lead_count || 0).toLocaleString()}  ·  sent ${Number(c.sent_count || 0).toLocaleString()}  ·  replies ${Number(c.replied_count || 0).toLocaleString()}  ·  bounced ${Number(c.bounced_count || 0).toLocaleString()}`);
-  console.log(`  emails ${(r.emails || []).length}  ·  senders ${(r.senders || []).length}  ·  ${c.daily_limit || "?"} a day  ·  ${c.default_timezone || ""}`);
+  console.log(`  emails ${(r.emails || []).length}  ·  senders ${(r.senders || []).length}`);
+  printSettings({ settings: r.settings });
   for (const e of r.emails || []) console.log(dim(`    ${e.step}. ${e.subject || "(same thread)"}${e.step > 1 ? ` · +${e.delay_days || 0} days` : ""}`));
   if (r.launch_blockers && r.launch_blockers.length) {
     console.log(yellow("  before launch:"));
@@ -1415,6 +1415,159 @@ async function campaignsStatus(argv) {
   if (c.url) console.log(dim(`  ${c.url}`));
 }
 
+const CAMPAIGN_SETTING_FLAGS = {
+  "--name": "name", "--daily-limit": "daily_limit", "--per-mailbox-limit": "per_mailbox_daily_limit", "--max-mailboxes": "max_active_mailboxes",
+  "--timezone": "timezone", "--timezone-mode": "timezone_mode", "--window": "window", "--gap": "gap", "--start": "planned_start_date",
+  "--days-ahead": "schedule_days_ahead", "--tags": "tags",
+};
+const CAMPAIGN_SETTING_BOOLS = { "--skip-weekends": "skip_weekends", "--no-skip-weekends": "no_skip_weekends", "--unsubscribe": "include_unsubscribe", "--no-unsubscribe": "no_unsubscribe" };
+
+function settingsFromFlags(args) {
+  const body = {};
+  for (const key of ["name", "timezone", "timezone_mode", "planned_start_date"]) if (args[key] !== undefined) body[key] = args[key];
+  for (const key of ["daily_limit", "per_mailbox_daily_limit", "max_active_mailboxes", "schedule_days_ahead"]) if (args[key] !== undefined) body[key] = parseLimit(args[key], key);
+  if (args.window) {
+    const m = /^(\d{1,2}:\d{2})-(\d{1,2}:\d{2})$/.exec(args.window);
+    if (!m) die("--window must look like 08:00-17:00");
+    body.window_start = m[1].padStart(5, "0"); body.window_end = m[2].padStart(5, "0");
+  }
+  if (args.gap) {
+    const m = /^(\d+)(?:-(\d+))?$/.exec(args.gap);
+    if (!m) die("--gap must look like 60-120 (minutes between two sends from one mailbox)");
+    body.gap_minutes_min = Number(m[1]); body.gap_minutes_max = Number(m[2] || m[1]);
+  }
+  if (args.tags !== undefined) body.tags = String(args.tags).split(",").map((t) => t.trim()).filter(Boolean);
+  if (args.skip_weekends) body.skip_weekends = true;
+  if (args.no_skip_weekends) body.skip_weekends = false;
+  if (args.include_unsubscribe) body.include_unsubscribe = true;
+  if (args.no_unsubscribe) body.include_unsubscribe = false;
+  return body;
+}
+
+function printSettings(c) {
+  const s = c.settings || {};
+  console.log(dim(`  ${s.daily_limit || "?"} a day` + (s.per_mailbox_daily_limit ? ` · ${s.per_mailbox_daily_limit} per mailbox` : "") + ` · ${s.window_start || "?"}-${s.window_end || "?"} ${s.timezone || ""}${s.timezone_mode === "lead" ? " (recipient local time)" : ""}` +
+    ` · ${s.skip_weekends ? "weekdays" : "every day"} · gap ${s.gap_minutes_min || "?"}-${s.gap_minutes_max || "?"} min` + (s.planned_start_date ? ` · starts ${s.planned_start_date}` : "") + (s.include_unsubscribe === false ? " · no opt-out line" : "") + (s.tags && s.tags.length ? ` · ${s.tags.join(", ")}` : "")));
+}
+
+async function campaignsUpdate(argv) {
+  const key = requireKey();
+  const args = readFlags(argv, CAMPAIGN_SETTING_FLAGS, CAMPAIGN_SETTING_BOOLS);
+  const identifier = args._[0];
+  if (!identifier) die('usage: argorant campaigns update <campaign> [--name "<n>"] [--daily-limit 40] [--per-mailbox-limit 20] [--max-mailboxes 10] [--timezone Europe/Berlin] [--timezone-mode fixed|lead] [--window 08:00-17:00] [--skip-weekends|--no-skip-weekends] [--gap 60-120] [--unsubscribe|--no-unsubscribe] [--start YYYY-MM-DD] [--tags a,b]');
+  const campaignId = await resolveCampaign(args.base, key, identifier);
+  const body = settingsFromFlags(args);
+  if (!Object.keys(body).length) die("nothing to change (see: argorant campaigns help)");
+  const r = need(await request("PATCH", args.base, `/api/v1/campaigns/${campaignId}`, { key, body }), "campaigns update");
+  if (args.json) return console.log(JSON.stringify(r, null, 2));
+  console.log(green("✓") + ` Updated ${(r.changed || []).join(", ")}`);
+  printSettings(r.campaign || {});
+}
+
+async function campaignsDelete(argv) {
+  const key = requireKey();
+  const args = readFlags(argv);
+  const identifier = args._[0];
+  if (!identifier) die("usage: argorant campaigns delete <campaign> [-y]");
+  const campaignId = await resolveCampaign(args.base, key, identifier);
+  if (!args.yes) {
+    const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+    const ok = await new Promise((r) => rl.question(`Delete campaign ${campaignId} with all its leads and results? [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/campaigns/${campaignId}`, { key }), "campaigns delete");
+  if (args.json) return console.log(JSON.stringify(r, null, 2));
+  console.log(green("✓") + ` Deleted ${campaignId}`);
+}
+
+async function campaignsLeadsList(args, campaignId, key) {
+  const query = { limit: args.limit || 50, offset: args.offset || 0 };
+  if (args.status) query.status = args.status;
+  if (args.q) query.q = args.q;
+  const r = need(await request("GET", args.base, `/api/v1/campaigns/${campaignId}/leads`, { key, query }), "campaigns leads");
+  if (args.json) return console.log(JSON.stringify(r, null, 2));
+  console.log(dim(`${r.total} lead(s)`));
+  for (const l of r.leads || []) console.log(`${l.email}  ${dim([l.first_name, l.last_name].filter(Boolean).join(" ") || "")}  ${l.status}${l.current_step ? dim(`  step ${l.current_step}`) : ""}${l.replied_at ? green("  replied") : ""}${l.bounced_at ? red("  bounced") : ""}`);
+}
+
+async function campaignsLeadsRemove(args, campaignId, key) {
+  const email = args._[1];
+  if (!email) die("usage: argorant campaigns leads remove <campaign> <email>");
+  const r = need(await request("DELETE", args.base, `/api/v1/campaigns/${campaignId}/leads/${encodeURIComponent(email)}`, { key }), "campaigns leads remove");
+  if (args.json) return console.log(JSON.stringify(r, null, 2));
+  console.log(green("✓") + ` Removed ${r.removed}`);
+}
+
+async function campaignsReplies(argv) {
+  const key = requireKey();
+  const args = readFlags(argv, { "-n": "limit", "--limit": "limit" });
+  const identifier = args._[0];
+  if (!identifier) die("usage: argorant campaigns replies <campaign> [-n 50]");
+  const campaignId = await resolveCampaign(args.base, key, identifier);
+  const r = need(await request("GET", args.base, `/api/v1/campaigns/${campaignId}/replies`, { key, query: { limit: args.limit || 50 } }), "campaigns replies");
+  if (args.json) return console.log(JSON.stringify(r, null, 2));
+  if (!(r.replies || []).length) return console.log(dim("No replies yet."));
+  for (const e of r.replies) {
+    console.log(`${bold(e.from_email || "")}  ${dim([e.first_name, e.last_name].filter(Boolean).join(" "))}  ${e.classification || ""}  ${dim(e.created_at || "")}`);
+    console.log(dim(`  ${(e.subject || "").slice(0, 80)} — ${(e.body || "").replace(/\s+/g, " ").slice(0, 140)}`));
+  }
+}
+
+async function cmdInboxThreads(argv) {
+  const sub = argv[0] || "list";
+  const key = requireKey();
+  if (sub === "list") {
+    const args = readFlags(argv.slice(1), { "--folder": "folder", "--campaign": "campaign", "--classification": "classification", "--q": "q", "-n": "limit", "--limit": "limit" });
+    const query = { folder: args.folder || "replies", limit: args.limit || 50 };
+    if (args.classification) query.classification = args.classification;
+    if (args.q) query.q = args.q;
+    if (args.campaign) query.campaign_id = await resolveCampaign(args.base, key, args.campaign);
+    const r = need(await request("GET", args.base, "/api/v1/inbox", { key, query }), "inbox");
+    if (args.json) return console.log(JSON.stringify(r, null, 2));
+    if (!(r.events || []).length) return console.log(dim(`No conversations in ${query.folder}.`));
+    for (const e of r.events) {
+      console.log(`${dim(e.id)}`);
+      console.log(`  ${bold(e.from_email || e.lead_email || "")}  ${e.classification || ""}  ${dim(e.campaign_name || "")}  ${dim(e.created_at || "")}`);
+      console.log(dim(`  ${(e.subject || "").slice(0, 80)} — ${(e.body || e.snippet || "").replace(/\s+/g, " ").slice(0, 140)}`));
+    }
+    return;
+  }
+  if (sub === "read") {
+    const args = readFlags(argv.slice(1));
+    const id = args._[0]; if (!id) die("usage: argorant inbox read <thread-id>");
+    const r = need(await request("GET", args.base, `/api/v1/inbox/${encodeURIComponent(id)}`, { key }), "inbox read");
+    if (args.json) return console.log(JSON.stringify(r, null, 2));
+    const e = r.event || {};
+    console.log(`${bold(e.from_email || e.lead_email || "")}  ${e.classification || ""}  ${dim(e.campaign_name || "")}\n${dim(e.subject || "")}\n\n${e.body || ""}`);
+    return;
+  }
+  if (sub === "reply") {
+    const args = readFlags(argv.slice(1), { "--body": "body", "--body-file": "bodyFile" });
+    const id = args._[0]; if (!id) die("usage: argorant inbox reply <thread-id> --body \"...\" | --body-file reply.txt [-y]");
+    let body = args.body;
+    if (args.bodyFile) { try { body = fs.readFileSync(args.bodyFile, "utf8"); } catch { die(`cannot read file: ${args.bodyFile}`); } }
+    if (!body || !body.trim()) die("give the reply text with --body or --body-file");
+    if (!args.yes) {
+      const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+      const ok = await new Promise((r) => rl.question(`Send this reply now? [y/N] `, (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/inbox/${encodeURIComponent(id)}/reply`, { key, body: { body } }), "inbox reply");
+    if (args.json) return console.log(JSON.stringify(r, null, 2));
+    console.log(green("✓") + " Reply sent");
+    return;
+  }
+  if (sub === "classify") {
+    const args = readFlags(argv.slice(1));
+    const [id, cl] = args._; if (!id || !cl) die("usage: argorant inbox classify <thread-id> interested|not_interested|out_of_office|meeting_booked|referral|other");
+    const r = need(await request("POST", args.base, `/api/v1/inbox/${encodeURIComponent(id)}/classify`, { key, body: { classification: cl } }), "inbox classify");
+    if (args.json) return console.log(JSON.stringify(r, null, 2));
+    console.log(green("✓") + ` ${r.classification}`);
+    return;
+  }
+  die(`unknown inbox subcommand: ${sub} (list, read, reply, classify)`);
+}
+
 function campaignsHelp() {
   const p = bold("argorant campaigns");
   console.log(`
@@ -1424,11 +1577,20 @@ Works with any Argorant API key. Nothing is sent until you launch.
 
 ${bold("USAGE")}
   ${p} list
-  ${p} create --name "<name>" [--daily-limit 100] [--timezone <tz>] [--gap 60-120] [--start YYYY-MM-DD]
+  ${p} create --name "<name>" [settings]
+  ${p} update <campaign> [settings]      ${dim("only the flags you pass change")}
+      settings: --daily-limit 40 --per-mailbox-limit 20 --max-mailboxes 10 --timezone Europe/Berlin
+                --timezone-mode fixed|lead --window 08:00-17:00 --skip-weekends|--no-skip-weekends
+                --gap 60-120 --unsubscribe|--no-unsubscribe --start YYYY-MM-DD --tags a,b --name "<n>"
   ${p} emails set <campaign> --file emails.json
   ${p} emails set <campaign> --step <n> --subject "..." (--body-file <path> | --body <text|->) [--delay-days <d>]
   ${p} leads add <campaign> --list <list-id> | --csv <file> [--include-catch-all]
+  ${p} leads list <campaign> [--status replied] [--q text] [-n 50]
+  ${p} leads remove <campaign> <email>
   ${p} senders set <campaign> --emails a@x.com,b@y.com | --all
+  ${p} senders remove <campaign> <mailbox>
+  ${p} replies <campaign> [-n 50]
+  ${p} delete <campaign> [-y]
   ${p} launch <campaign> [-y]      ${dim("asks for confirmation; sends real email")}
   ${p} pause <campaign>
   ${p} stop <campaign>
@@ -1437,6 +1599,11 @@ ${bold("USAGE")}
   ${bold("argorant inboxes")} list
   ${bold("argorant inboxes")} connect-google --admin <admin@yourdomain.com> [--emails a,b | --all]
 
+  ${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>
+  ${bold("argorant inbox")} reply <thread-id> --body "..." | --body-file reply.txt [-y]
+  ${bold("argorant inbox")} classify <thread-id> interested|not_interested|out_of_office|meeting_booked|referral|other
+
 ${dim("<campaign> accepts an id or an unambiguous case-insensitive name prefix.")}
 ${dim("Variables in emails: {{first_name}} {{last_name}} {{company}} {{title}}. Spintax {a|b} varies phrasing.")}
 ${dim("Every address is verified before it is enrolled; only valid ones send unless --include-catch-all.")}
@@ -1463,6 +1630,10 @@ async function cmdCampaigns(argv) {
   const table = {
     list: campaignsList,
     create: campaignsCreate,
+    update: campaignsUpdate,
+    set: campaignsUpdate,
+    delete: campaignsDelete,
+    replies: campaignsReplies,
     emails: campaignsEmails,
     steps: campaignsSteps,
     senders: campaignsSenders,
@@ -1551,6 +1722,7 @@ ${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
 
 ${bold("FILTERS")}
   --keywords <k>     Comma = OR. The widest, most reliable filter - prefer it
@@ -1608,9 +1780,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 === "inbox") {
+  if (cmd === "campaigns" || cmd === "campaign" || cmd === "inboxes" || cmd === "mailboxes" || cmd === "inbox" || cmd === "unibox") {
     try {
       if (cmd.startsWith("campaign")) await cmdCampaigns(argv.slice(1));
+      else if (cmd === "inbox" || cmd === "unibox") await cmdInboxThreads(argv.slice(1));
       else await cmdInboxes(argv.slice(1));
     } catch (e) {
       die(e && e.message ? e.message : String(e));

package/package.json

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