@agenticmail/cli 0.9.36 → 0.9.38

package/dist/cli.js

@@ -4927,6 +4927,254 @@ var NON_INTERACTIVE = false;
 function nonInteractiveDefault(value) {
   return NON_INTERACTIVE ? value : null;
 }
+async function cmdSetupRelay() {
+  const args = process.argv.slice(3);
+  if (args.some((a) => a === "--help" || a === "-h" || a === "help")) {
+    log2("");
+    log2(`  ${c2.pinkBg(" \u{1F380} agenticmail setup-relay ")}`);
+    log2("");
+    log2(`  ${c2.bold("Usage:")} agenticmail setup-relay`);
+    log2("");
+    log2(`  Adds (or updates) the Gmail / Outlook / custom relay AgenticMail uses`);
+    log2(`  to send mail to the public internet. Run this YOURSELF \u2014 never paste`);
+    log2(`  the Gmail app password into an agent's chat (it would end up in the`);
+    log2(`  LLM's context / logs / conversation history).`);
+    log2("");
+    log2(`  Password input is hidden (raw-mode stdin). The agent never sees it.`);
+    log2("");
+    log2(`  Prereq: AgenticMail already bootstrapped (run \`agenticmail setup\` first).`);
+    log2("");
+    return;
+  }
+  const configPath = join(homedir(), ".agenticmail", "config.json");
+  if (!existsSync2(configPath)) {
+    log2("");
+    fail2(`AgenticMail isn't set up yet \u2014 no config at ${c2.dim(configPath)}`);
+    log2(`  Run ${c2.cyan("agenticmail setup")} first, then come back to add the relay.`);
+    log2("");
+    process.exit(1);
+  }
+  let config;
+  try {
+    config = JSON.parse(readFileSync2(configPath, "utf-8"));
+  } catch (err) {
+    log2("");
+    fail2(`Could not read ${configPath}: ${err.message}`);
+    log2("");
+    process.exit(1);
+  }
+  log2("");
+  log2(`   ${c2.bold("\u{1F380} AgenticMail \u2014 set up Gmail relay")} `);
+  log2("");
+  log2(`  ${c2.dim("This command runs entirely in your terminal. The password")}`);
+  log2(`  ${c2.dim("input is hidden and never leaves this process \u2014 your agent")}`);
+  log2(`  ${c2.dim("doesn't see it.")}`);
+  log2("");
+  try {
+    const result = await setupRelay(config);
+    if (!result.success) {
+      log2("");
+      fail2("Relay setup did not complete \u2014 see messages above.");
+      process.exit(1);
+    }
+    log2("");
+    ok2("Gmail relay configured.");
+    log2("");
+    log2(`  ${c2.bold("Next:")} point bridge-escalation alerts at your personal email:`);
+    log2("");
+    log2(`    ${c2.cyan("Option A")} \u2014 tell your host agent: "set my operator notification email to <you@gmail.com>"`);
+    log2(`    ${c2.cyan("Option B")} \u2014 open the web UI \u2192 click your avatar \u2192 ${c2.bold("Alert email")} \u2192 type, Save`);
+    log2("");
+    log2(`  ${c2.dim("Either path writes ~/.agenticmail/operator-prefs.json \u2014 the dispatcher")}`);
+    log2(`  ${c2.dim("forwards a digest there when sub-agents mail your bridge and the")}`);
+    log2(`  ${c2.dim("dispatcher can't resume your host session.")}`);
+    log2("");
+  } catch (err) {
+    log2("");
+    fail2(`Setup-relay failed: ${err.message}`);
+    log2("");
+    process.exit(1);
+  }
+}
+async function cmdSetupEmail() {
+  const args = process.argv.slice(3);
+  if (args.some((a) => a === "--help" || a === "-h" || a === "help")) {
+    log2("");
+    log2(`  ${c2.pinkBg(" \u{1F380} agenticmail setup-email ")}`);
+    log2("");
+    log2(`  ${c2.bold("Usage:")} agenticmail setup-email`);
+    log2("");
+    log2(`  Minimal email-relay setup: enter your address, enter the password,`);
+    log2(`  done. Provider (Gmail, Outlook, custom) is detected from the domain.`);
+    log2(`  Password is collected via hidden stdin \u2014 your agent never sees it.`);
+    log2("");
+    log2(`  Prereq: AgenticMail already bootstrapped (run \`agenticmail setup\` first).`);
+    log2("");
+    return;
+  }
+  const configPath = join(homedir(), ".agenticmail", "config.json");
+  if (!existsSync2(configPath)) {
+    log2("");
+    fail2(`AgenticMail isn't set up yet \u2014 no config at ${c2.dim(configPath)}`);
+    log2(`  Run ${c2.cyan("agenticmail setup")} first, then come back to add your email.`);
+    log2("");
+    process.exit(1);
+  }
+  let config;
+  try {
+    config = JSON.parse(readFileSync2(configPath, "utf-8"));
+  } catch (err) {
+    log2("");
+    fail2(`Could not read ${configPath}: ${err.message}`);
+    log2("");
+    process.exit(1);
+  }
+  log2("");
+  log2(`   ${c2.bold("\u{1F380} AgenticMail \u2014 connect your mailbox")} `);
+  log2("");
+  log2(`  ${c2.dim("Two questions: your email, your password. Password input is")}`);
+  log2(`  ${c2.dim("hidden and never leaves this process \u2014 your agent doesn't see it.")}`);
+  log2("");
+  const apiBase = `http://${config.api.host}:${config.api.port}`;
+  let serverReady = false;
+  try {
+    const probe = await fetch(`${apiBase}/api/agenticmail/health`, { signal: AbortSignal.timeout(2e3) });
+    serverReady = probe.ok;
+  } catch {
+  }
+  if (!serverReady) {
+    try {
+      serverReady = await startApiServer(config);
+    } catch {
+    }
+  }
+  if (!serverReady) {
+    fail2(`API server not reachable at ${c2.cyan(apiBase)}`);
+    info2(`Start it with ${c2.green("agenticmail start")}, then re-run this command.`);
+    process.exit(1);
+  }
+  let agentName = "secretary";
+  try {
+    const acctResp = await fetch(`${apiBase}/api/agenticmail/accounts`, {
+      headers: { "Authorization": `Bearer ${config.masterKey}` },
+      signal: AbortSignal.timeout(5e3)
+    });
+    if (acctResp.ok) {
+      const data = await acctResp.json();
+      const agents = data?.agents ?? data ?? [];
+      const first = agents.find((a) => a.name && a.name !== "claudecode" && a.name !== "codex") ?? agents[0];
+      if (first?.name) agentName = first.name;
+    }
+  } catch {
+  }
+  const email = (await ask(`  ${c2.cyan("Your email address:")} `)).trim();
+  if (!email || !email.includes("@")) {
+    log2("");
+    fail2("That doesn't look like a valid email address.");
+    process.exit(1);
+  }
+  const domain = email.split("@")[1].toLowerCase();
+  const GMAIL_DOMAINS = /* @__PURE__ */ new Set(["gmail.com", "googlemail.com"]);
+  const OUTLOOK_DOMAINS = /* @__PURE__ */ new Set(["outlook.com", "hotmail.com", "live.com", "msn.com"]);
+  let provider;
+  let smtpHost;
+  let smtpPort;
+  let imapHost;
+  let imapPort;
+  let appPasswordHint = "";
+  if (GMAIL_DOMAINS.has(domain)) {
+    provider = "gmail";
+    appPasswordHint = `App password: ${c2.cyan("https://myaccount.google.com/apppasswords")}`;
+  } else if (OUTLOOK_DOMAINS.has(domain)) {
+    provider = "outlook";
+    appPasswordHint = `App password: your Microsoft account \u2192 Security \u2192 Advanced security options \u2192 App passwords`;
+  } else {
+    log2("");
+    log2(`  ${c2.dim("We don't recognize the domain ")}${c2.bold(domain)}${c2.dim(". Where does it live?")}`);
+    log2(`    ${c2.cyan("1.")} Google Workspace ${c2.dim("(mail hosted by Gmail)")}`);
+    log2(`    ${c2.cyan("2.")} Microsoft 365 ${c2.dim("(mail hosted by Outlook)")}`);
+    log2(`    ${c2.cyan("3.")} Custom mail server`);
+    const pickProv = await pick(`  ${c2.magenta(">")} `, ["1", "2", "3"]);
+    if (pickProv === "1") {
+      provider = "gmail";
+      appPasswordHint = `App password: ${c2.cyan("https://myaccount.google.com/apppasswords")}`;
+    } else if (pickProv === "2") {
+      provider = "outlook";
+      appPasswordHint = `App password: your Microsoft account \u2192 Security \u2192 Advanced security options \u2192 App passwords`;
+    } else {
+      provider = "custom";
+      log2("");
+      log2(`  ${c2.dim("Your mail-server hostnames (check your provider's docs):")}`);
+      smtpHost = (await ask(`  ${c2.cyan("Outgoing (SMTP) host:")} `)).trim();
+      const smtpPortStr = (await ask(`  ${c2.cyan("SMTP port")} ${c2.dim("(587)")}: `)).trim();
+      smtpPort = smtpPortStr ? parseInt(smtpPortStr, 10) : 587;
+      imapHost = (await ask(`  ${c2.cyan("Incoming (IMAP) host:")} `)).trim();
+      const imapPortStr = (await ask(`  ${c2.cyan("IMAP port")} ${c2.dim("(993)")}: `)).trim();
+      imapPort = imapPortStr ? parseInt(imapPortStr, 10) : 993;
+    }
+  }
+  log2("");
+  if (appPasswordHint) log2(`  ${c2.dim(appPasswordHint)}`);
+  log2(`  ${c2.dim("Spaces in the password are fine \u2014 we'll strip them.")}`);
+  log2("");
+  const rawPassword = await askSecret(`  ${c2.cyan("Password:")} `);
+  const password = rawPassword.replace(/\s+/g, "");
+  if (!password) {
+    log2("");
+    fail2("No password entered.");
+    process.exit(1);
+  }
+  log2("");
+  const spinner = new Spinner("relay");
+  spinner.start();
+  try {
+    const response = await fetch(`${apiBase}/api/agenticmail/gateway/relay`, {
+      method: "POST",
+      headers: {
+        "Authorization": `Bearer ${config.masterKey}`,
+        "Content-Type": "application/json"
+      },
+      body: JSON.stringify({
+        provider,
+        email,
+        password,
+        agentName,
+        smtpHost,
+        smtpPort,
+        imapHost,
+        imapPort
+      }),
+      signal: AbortSignal.timeout(3e4)
+    });
+    if (!response.ok) {
+      const text = await response.text();
+      const friendly = parseFriendlyError(text);
+      spinner.fail(friendly.message);
+      log2("");
+      if (friendly.isAuthError) {
+        info2("Check the email + password and run `agenticmail setup-email` again.");
+      }
+      log2("");
+      process.exit(1);
+    }
+    const data = await response.json();
+    spinner.succeed(`Mailbox connected \u2014 ${c2.bold(email)} ${c2.dim("via " + provider)}`);
+    if (data?.agent?.subAddress) {
+      log2("");
+      ok2(`Agent ${c2.bold('"' + (data.agent.name ?? agentName) + '"')} ready at ${c2.cyan(data.agent.subAddress)}`);
+    }
+    log2("");
+    log2(`  ${c2.bold("Next:")} point bridge-escalation alerts at your personal email:`);
+    log2("");
+    log2(`    ${c2.cyan("Option A")} \u2014 tell your host agent: "set my operator notification email to <you@example.com>"`);
+    log2(`    ${c2.cyan("Option B")} \u2014 open the web UI \u2192 click your avatar \u2192 ${c2.bold("Alert email")} \u2192 type, Save`);
+    log2("");
+  } catch (err) {
+    spinner.fail(`Setup-email failed: ${err.message}`);
+    log2("");
+    process.exit(1);
+  }
+}
 async function cmdSetup() {
   const setupArgs = process.argv.slice(3);
   if (setupArgs.some((a) => a === "--help" || a === "-h" || a === "help")) {
@@ -7392,6 +7640,21 @@ switch (command) {
       process.exit(1);
     });
     break;
+  case "setup-relay":
+  case "relay":
+    cmdSetupRelay().catch((err) => {
+      console.error(err);
+      process.exit(1);
+    });
+    break;
+  case "setup-email":
+  case "email":
+  case "connect-email":
+    cmdSetupEmail().catch((err) => {
+      console.error(err);
+      process.exit(1);
+    });
+    break;
   case "start":
     cmdStart().catch((err) => {
       console.error(err);
@@ -7483,6 +7746,7 @@ switch (command) {
     log2(`    ${c2.green("agenticmail")}           Get started (setup + start)`);
     log2(`    ${c2.green("agenticmail bootstrap")} ${c2.dim("Zero-question install \u2014 for AI agents (Claude Code) to run on a user's behalf")}`);
     log2(`    ${c2.green("agenticmail setup")}     Re-run the setup wizard ${c2.dim("(use --yes for non-interactive)")}`);
+    log2(`    ${c2.green("agenticmail setup-email")}  Connect your mailbox \u2014 just email + password ${c2.dim("(auto-detects Gmail/Outlook/custom)")}`);
     log2(`    ${c2.green("agenticmail start")}     Start the server`);
     log2(`    ${c2.green("agenticmail stop")}      Stop the server`);
     log2(`    ${c2.green("agenticmail status")}    See what's running`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agenticmail/cli",
-  "version": "0.9.36",
+  "version": "0.9.38",
   "description": "Email and SMS infrastructure for AI agents — the first platform to give agents real email addresses and phone numbers",
   "type": "module",
   "main": "dist/index.js",