agenticmail 0.4.0 → 0.5.1

package/dist/cli.js

@@ -9,7 +9,8 @@ import { createRequire } from "module";
 import { homedir } from "os";
 import JSON5 from "json5";
 import {
-  SetupManager
+  SetupManager,
+  ServiceManager
 } from "@agenticmail/core";
 
 // src/shell.ts
@@ -4215,6 +4216,8 @@ var c2 = {
   yellow: (s) => `\x1B[33m${s}\x1B[0m`,
   cyan: (s) => `\x1B[36m${s}\x1B[0m`,
   magenta: (s) => `\x1B[35m${s}\x1B[0m`,
+  pink: (s) => `\x1B[38;5;205m${s}\x1B[0m`,
+  pinkBg: (s) => `\x1B[48;5;205m\x1B[97m${s}\x1B[0m`,
   dim: (s) => `\x1B[90m${s}\x1B[0m`,
   bold: (s) => `\x1B[1m${s}\x1B[0m`,
   bgGreen: (s) => `\x1B[42m\x1B[30m${s}\x1B[0m`,
@@ -4299,6 +4302,8 @@ var Spinner = class {
   msgChangeCounter = 0;
   category;
   currentMsg;
+  progressPct = -1;
+  // -1 = no progress bar
   constructor(category, initialMsg) {
     this.category = category;
     const msgs = LOADING_MESSAGES[category] ?? LOADING_MESSAGES.general;
@@ -4308,13 +4313,23 @@ var Spinner = class {
     this.frameIdx = 0;
     this.msgIdx = 0;
     this.msgChangeCounter = 0;
+    this.progressPct = -1;
     const msgs = LOADING_MESSAGES[this.category] ?? LOADING_MESSAGES.general;
     this.interval = setInterval(() => {
       const frame = SPINNER_FRAMES[this.frameIdx % SPINNER_FRAMES.length];
-      process.stdout.write(`\r  ${c2.cyan(frame)} ${c2.yellow(this.currentMsg)}\x1B[K`);
+      if (this.progressPct >= 0) {
+        const barWidth = 20;
+        const filled = Math.round(this.progressPct / 100 * barWidth);
+        const empty = barWidth - filled;
+        const bar = c2.pink("\u2588".repeat(filled)) + c2.dim("\u2591".repeat(empty));
+        const pctStr = c2.pink(`${this.progressPct}%`);
+        process.stdout.write(`\r  ${c2.pink(frame)} ${bar} ${pctStr} ${c2.dim(this.currentMsg)}\x1B[K`);
+      } else {
+        process.stdout.write(`\r  ${c2.cyan(frame)} ${c2.yellow(this.currentMsg)}\x1B[K`);
+      }
       this.frameIdx++;
       this.msgChangeCounter++;
-      if (this.msgChangeCounter >= 30) {
+      if (this.msgChangeCounter >= 30 && this.progressPct < 0) {
         this.msgChangeCounter = 0;
         this.msgIdx = (this.msgIdx + 1) % msgs.length;
         this.currentMsg = msgs[this.msgIdx];
@@ -4322,7 +4337,13 @@ var Spinner = class {
     }, 100);
   }
   update(msg) {
-    this.currentMsg = msg;
+    const match = msg.match(/^__progress__:(\d+):(.*)$/);
+    if (match) {
+      this.progressPct = Math.min(100, parseInt(match[1], 10));
+      this.currentMsg = match[2];
+    } else {
+      this.currentMsg = msg;
+    }
     this.msgChangeCounter = 0;
   }
   succeed(msg) {
@@ -4408,6 +4429,10 @@ async function startApiServer(config) {
   const { spawn } = await import("child_process");
   const apiEntry = resolveApiEntry();
   const env = configToEnv(config);
+  try {
+    new ServiceManager().cacheApiEntryPath(apiEntry);
+  } catch {
+  }
   const child = spawn(process.execPath, [apiEntry], {
     detached: true,
     stdio: "ignore",
@@ -4542,14 +4567,41 @@ async function cmdSetup() {
   {
     const spinner = new Spinner("docker");
     spinner.start();
+    const dockerSetup = new SetupManager((msg) => spinner.update(msg));
     try {
-      await setup.ensureDocker();
+      await dockerSetup.ensureDocker();
       spinner.succeed(`${c2.bold("Docker")} \u2014 engine running`);
     } catch (err) {
-      spinner.fail(`Couldn't start Docker: ${err.message}`);
-      log2("");
-      log2(`  ${c2.yellow("Tip:")} Install Docker manually from ${c2.cyan("https://docker.com/get-docker")}`);
-      log2(`  ${c2.dim("Then run")} ${c2.green("agenticmail setup")} ${c2.dim("again.")}`);
+      const msg = err.message;
+      if (msg === "DOCKER_MANUAL_START") {
+        spinner.fail(`Docker installed but couldn't start automatically`);
+        log2("");
+        log2(`  ${c2.pink(c2.bold("Don't worry! Here's how to fix this:"))}`);
+        log2("");
+        log2(`  ${c2.pink("Step 1:")} Open a ${c2.bold("new terminal window")}`);
+        log2(`         ${c2.dim("(Command + T on Mac, or open Terminal from your dock)")}`);
+        log2("");
+        log2(`  ${c2.pink("Step 2:")} Run this command:`);
+        log2(`         ${c2.cyan("open -a Docker")}`);
+        log2("");
+        log2(`  ${c2.pink("Step 3:")} Wait for Docker Desktop to fully load`);
+        log2(`         ${c2.dim("You'll see a whale icon in your menu bar (top of screen).")}`);
+        log2(`         ${c2.dim("Wait until it stops animating \u2014 that means it's ready.")}`);
+        log2("");
+        log2(`  ${c2.pink("Step 4:")} Close that terminal window`);
+        log2(`         ${c2.dim("Just close the window normally (Command + W). Don't press Ctrl+C.")}`);
+        log2("");
+        log2(`  ${c2.pink("Step 5:")} Come back here and run:`);
+        log2(`         ${c2.green("npx agenticmail@latest")}`);
+        log2("");
+        log2(`  ${c2.dim("That's it! Docker only needs this manual start the first time.")}`);
+        log2(`  ${c2.dim("After that, it starts automatically.")}`);
+      } else {
+        spinner.fail(`Couldn't start Docker: ${msg}`);
+        log2("");
+        log2(`  ${c2.yellow("Tip:")} Install Docker manually from ${c2.cyan("https://docker.com/get-docker")}`);
+        log2(`  ${c2.dim("Then run")} ${c2.green("agenticmail setup")} ${c2.dim("again.")}`);
+      }
       process.exit(1);
     }
     await new Promise((r) => setTimeout(r, 300));
@@ -4558,8 +4610,9 @@ async function cmdSetup() {
   if (!stalwart?.installed) {
     const spinner = new Spinner("stalwart");
     spinner.start();
+    const stalwartSetup = new SetupManager((msg) => spinner.update(msg));
     try {
-      await setup.ensureStalwart();
+      await stalwartSetup.ensureStalwart();
       spinner.succeed(`${c2.bold("Mail Server")} \u2014 up and running!`);
     } catch (err) {
       spinner.fail(`Couldn't start the mail server: ${err.message}`);
@@ -4831,6 +4884,23 @@ async function cmdSetup() {
     log2("");
     await registerWithOpenClaw(result.config);
   }
+  if (serverReady) {
+    const svcSpinner = new Spinner("general", "Setting up auto-start...");
+    svcSpinner.start();
+    try {
+      const svc = new ServiceManager();
+      const svcResult = svc.install();
+      if (svcResult.installed) {
+        svcSpinner.succeed(`${c2.bold("Auto-start")} \u2014 AgenticMail will start on boot`);
+      } else {
+        svcSpinner.fail(`Auto-start: ${svcResult.message}`);
+        info2("You can set this up later with: agenticmail service install");
+      }
+    } catch (err) {
+      svcSpinner.fail(`Auto-start: ${err.message}`);
+    }
+    await new Promise((r) => setTimeout(r, 300));
+  }
   printSummary(result, false);
   if (serverReady) {
     await interactiveShell({ config: result.config, onExit: () => {
@@ -6175,6 +6245,23 @@ async function cmdStatus() {
     info2("Can't check email status \u2014 server isn't running");
   }
   log2("");
+  log2(`  ${c2.bold("Auto-Start:")}`);
+  try {
+    const svc = new ServiceManager();
+    const svcStatus = svc.status();
+    if (svcStatus.installed) {
+      if (svcStatus.running) {
+        ok2(`Enabled ${c2.dim(`(${svcStatus.platform}) \u2014 starts on boot`)}`);
+      } else {
+        ok2(`Installed ${c2.dim(`(${svcStatus.platform})`)} \u2014 ${c2.yellow("not currently running")}`);
+      }
+    } else {
+      fail2(`Not installed ${c2.dim("\u2014 run: agenticmail service install")}`);
+    }
+  } catch {
+    info2("Could not check auto-start status");
+  }
+  log2("");
 }
 async function cmdStart() {
   const setup = new SetupManager();
@@ -6225,19 +6312,107 @@ async function cmdStart() {
     serverSpinner.fail(`Couldn't start the server: ${err.message}`);
     process.exit(1);
   }
+  try {
+    const svc = new ServiceManager();
+    const svcStatus = svc.status();
+    if (!svcStatus.installed) {
+      const svcResult = svc.install();
+      if (svcResult.installed) {
+        ok2(`${c2.bold("Auto-start")} enabled \u2014 survives reboots`);
+      }
+    }
+  } catch {
+  }
   await interactiveShell({ config, onExit: () => {
   } });
 }
 async function cmdStop() {
   log2("");
   const stopped = stopApiServer();
-  if (stopped) {
+  const svc = new ServiceManager();
+  const svcStatus = svc.status();
+  if (svcStatus.installed && svcStatus.running) {
+    try {
+      if (svcStatus.platform === "launchd") {
+        const { execFileSync } = await import("child_process");
+        execFileSync("launchctl", ["unload", svcStatus.servicePath], { timeout: 1e4, stdio: "ignore" });
+      } else if (svcStatus.platform === "systemd") {
+        const { execFileSync } = await import("child_process");
+        execFileSync("systemctl", ["--user", "stop", "agenticmail.service"], { timeout: 1e4, stdio: "ignore" });
+      }
+    } catch {
+    }
+  }
+  if (stopped || svcStatus.installed && svcStatus.running) {
     ok2("AgenticMail server stopped");
+    if (svcStatus.installed) {
+      info2("Auto-start is still enabled. It will restart on next boot.");
+      info2(`To disable: ${c2.green("agenticmail service uninstall")}`);
+    }
   } else {
     info2("Server is not running");
   }
   log2("");
 }
+async function cmdService() {
+  const subCmd = process.argv[3] || "status";
+  const svc = new ServiceManager();
+  log2("");
+  switch (subCmd) {
+    case "install": {
+      const result = svc.install();
+      if (result.installed) {
+        ok2(`Auto-start service installed`);
+        info2(result.message);
+        info2("AgenticMail will now start automatically when your computer boots.");
+      } else {
+        fail2(result.message);
+      }
+      break;
+    }
+    case "uninstall":
+    case "remove": {
+      const result = svc.uninstall();
+      if (result.removed) {
+        ok2("Auto-start service removed");
+        info2("AgenticMail will no longer start on boot.");
+      } else {
+        fail2(result.message);
+      }
+      break;
+    }
+    case "reinstall": {
+      const result = svc.reinstall();
+      if (result.installed) {
+        ok2("Auto-start service reinstalled");
+        info2(result.message);
+      } else {
+        fail2(result.message);
+      }
+      break;
+    }
+    case "status":
+    default: {
+      const status = svc.status();
+      log2(`  ${c2.bold("Auto-Start Service")}`);
+      log2("");
+      if (status.installed) {
+        ok2(`Installed ${c2.dim(`(${status.platform})`)}`);
+        if (status.running) {
+          ok2(`Running`);
+        } else {
+          fail2(`Not running ${c2.dim("\u2014 will start on next boot or: agenticmail service reinstall")}`);
+        }
+        info2(`Service file: ${status.servicePath}`);
+      } else {
+        fail2("Not installed");
+        info2(`Install with: ${c2.green("agenticmail service install")}`);
+      }
+      break;
+    }
+  }
+  log2("");
+}
 async function cmdUpdate() {
   const { execSync } = await import("child_process");
   log2("");
@@ -6362,6 +6537,14 @@ switch (command) {
       process.exit(1);
     });
     break;
+  case "service":
+    cmdService().then(() => {
+      process.exit(0);
+    }).catch((err) => {
+      console.error(err);
+      process.exit(1);
+    });
+    break;
   case "update":
     cmdUpdate().catch((err) => {
       console.error(err);
@@ -6381,6 +6564,7 @@ switch (command) {
     log2(`    ${c2.green("agenticmail stop")}      Stop the server`);
     log2(`    ${c2.green("agenticmail status")}    See what's running`);
     log2(`    ${c2.green("agenticmail openclaw")}  Set up AgenticMail for OpenClaw`);
+    log2(`    ${c2.green("agenticmail service")}   Manage auto-start (install/uninstall/status)`);
     log2(`    ${c2.green("agenticmail update")}    Update to the latest version`);
     log2("");
     process.exit(0);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agenticmail",
-  "version": "0.4.0",
+  "version": "0.5.1",
   "description": "Email infrastructure for AI agents — send and receive real email programmatically",
   "type": "module",
   "main": "dist/index.js",
@@ -26,8 +26,8 @@
     "prepublishOnly": "npm run build"
   },
   "dependencies": {
-    "@agenticmail/api": "^0.3.0",
-    "@agenticmail/core": "^0.3.0",
+    "@agenticmail/api": "^0.5.0",
+    "@agenticmail/core": "^0.5.0",
     "json5": "^2.2.3"
   },
   "devDependencies": {