agenticmail 0.4.0 → 0.5.0

package/dist/cli.js

@@ -4215,6 +4215,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 +4301,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 +4312,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 +4336,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) {
@@ -4542,14 +4562,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 +4605,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}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agenticmail",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "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": {