agenticmail 0.3.24 → 0.4.0

package/README.md

@@ -2,7 +2,7 @@
 
 The main package for [AgenticMail](https://github.com/agenticmail/agenticmail) — email infrastructure for AI agents. This is the package you install to get started.
 
-It bundles a setup wizard, API server launcher, and a full interactive shell with 36 commands for managing agents, sending and receiving email, configuring gateways, and more. It also re-exports everything from `@agenticmail/core` so you can use it as an SDK.
+It bundles a setup wizard, API server launcher, and a full interactive shell with 44 commands for managing agents, sending and receiving email, configuring gateways, and more. It also re-exports everything from `@agenticmail/core` so you can use it as an SDK.
 
 ## Install
 
@@ -42,7 +42,11 @@ Running `agenticmail setup` walks you through everything needed to get email wor
 
 3. **Service startup** — starts Docker if needed, ensures Stalwart is running and healthy.
 
-4. **Email connection** — this is where you choose how your agents connect to the outside world:
+4. **Email connection** — this is where you choose how your agents connect to the outside world.
+
+5. **Phone number access (optional)** — set up Google Voice for SMS. Agents can receive verification codes and send texts. The wizard validates Gmail/Google Voice email matching, warns about mismatches, and collects separate credentials when needed. SMS reading prioritizes direct Google Voice web access (instant) with email forwarding as fallback.
+
+6. **OpenClaw integration** — if OpenClaw is detected, automatically registers the plugin.
 
 ### Relay Mode (Recommended for Getting Started)
 
@@ -99,7 +103,7 @@ If the server crashes, you get clear error output showing what went wrong.
 
 ## The Interactive Shell
 
-The shell is the main way to interact with AgenticMail. It provides 36 commands organized by category, with arrow-key navigation, color-coded output, and keyboard shortcuts.
+The shell is the main way to interact with AgenticMail. It provides 44 commands organized by category, with arrow-key navigation, color-coded output, and keyboard shortcuts.
 
 ### Getting Around
 
@@ -182,8 +186,17 @@ The shell is the main way to interact with AgenticMail. It provides 36 commands
 |---------|-------------|
 | `/help` | Show all available commands with descriptions. |
 | `/clear` | Clear the screen. |
+| `/update` | Check for and install the latest AgenticMail version. Auto-detects OpenClaw and updates both. |
 | `/exit` | Exit the shell (also `/quit`). Stops the server and cleans up. |
 
+### CLI Update Command
+
+```bash
+agenticmail update
+```
+
+Checks npm for the latest version, compares with your current install, and updates in-place. If OpenClaw is detected, it also updates `@agenticmail/openclaw` and restarts the gateway automatically. Works with npm, pnpm, and bun.
+
 ---
 
 ## Inbox Navigation

package/dist/cli.js

@@ -2,7 +2,7 @@
 
 // src/cli.ts
 import { createInterface as createInterface2, emitKeypressEvents as emitKeypressEvents2 } from "readline";
-import { existsSync as existsSync2, readFileSync as readFileSync2, writeFileSync as writeFileSync2, mkdirSync, realpathSync } from "fs";
+import { existsSync as existsSync2, readFileSync as readFileSync2, writeFileSync as writeFileSync2, mkdirSync, realpathSync, unlinkSync } from "fs";
 import { join, dirname } from "path";
 import { fileURLToPath } from "url";
 import { createRequire } from "module";
@@ -235,6 +235,21 @@ async function interactiveShell(options) {
   log(`  ${c.dim("Server:")} ${c.cyan(`http://${config.api.host}:${config.api.port}`)}`);
   if (agentLine) log(`  ${c.dim("Agents:")} ${agentLine}`);
   if (emailLine) log(`  ${c.dim("Email:")}  ${emailLine}`);
+  try {
+    const agentsResp = await apiFetch("/api/agenticmail/accounts");
+    if (agentsResp.ok) {
+      const agentsData = await agentsResp.json();
+      const agents = agentsData.agents || agentsData.accounts || [];
+      for (const a of agents) {
+        const smsConf = a.metadata?.sms;
+        if (smsConf?.enabled && smsConf.phoneNumber) {
+          log(`  ${c.dim("Phone:")}  ${c.green(smsConf.phoneNumber)} ${c.dim("via Google Voice")} ${c.dim("(" + a.name + ")")}`);
+          break;
+        }
+      }
+    }
+  } catch {
+  }
   log("");
   log("");
   log(`  ${c.dim("Type")} ${c.bold("/help")} ${c.dim("for commands, or")} ${c.bold("/exit")} ${c.dim("to stop.")}`);
@@ -1665,6 +1680,14 @@ ${orig.text || ""}`;
                 log(`  ${c.cyan("\u{1F4C1}")} ${f.path}${special}`);
               }
             }
+            try {
+              const smsResp = await agentFetch(agent.apiKey, "/api/agenticmail/sms/config");
+              const smsData = await smsResp.json();
+              if (smsData.sms?.enabled) {
+                log(`  ${c.green("\u{1F4F1}")} SMS ${c.dim(`(${smsData.sms.phoneNumber})`)}`);
+              }
+            } catch {
+            }
           } else if (choice.trim() === "2" || choice.trim().toLowerCase() === "create") {
             const name = await question(`  ${c.dim("Folder name:")} `);
             if (isBack(name) || !name.trim()) {
@@ -1694,10 +1717,25 @@ ${orig.text || ""}`;
               log("");
               return;
             }
+            let hasSms = false;
+            try {
+              const smsResp = await agentFetch(agent.apiKey, "/api/agenticmail/sms/config");
+              const smsData = await smsResp.json();
+              if (smsData.sms?.enabled) hasSms = true;
+            } catch {
+            }
             for (let i = 0; i < folders.length; i++) {
               log(`  ${c.dim(`[${i + 1}]`)} ${c.cyan(folders[i].path)}`);
             }
-            const idx = await askChoice(`  ${c.dim("Folder #:")} `, folders.length);
+            if (hasSms) {
+              log(`  ${c.dim(`[${folders.length + 1}]`)} ${c.green("SMS")} ${c.dim("(text messages)")}`);
+            }
+            const totalChoices = hasSms ? folders.length + 1 : folders.length;
+            const idx = await askChoice(`  ${c.dim("Folder #:")} `, totalChoices);
+            if (idx !== null && hasSms && idx === folders.length) {
+              await commands.sms.run();
+              return;
+            }
             if (idx === null) {
               log("");
               return;
@@ -3617,6 +3655,308 @@ ${c.dim(boxChar.bl + boxChar.h.repeat(bWidth) + boxChar.br)}`);
         }
       }
     },
+    sms: {
+      desc: "Manage SMS / phone number (view, setup, change, disable)",
+      run: async () => {
+        const agent = getActiveAgent();
+        if (!agent) return;
+        log("");
+        log(hr());
+        heading("SMS / Phone Number");
+        log("");
+        let smsConfig = null;
+        try {
+          const resp = await fetch(`${apiBase}/api/agenticmail/sms/config`, {
+            headers: { "Authorization": `Bearer ${agent.apiKey}` }
+          });
+          const data = await resp.json();
+          smsConfig = data.sms;
+        } catch {
+        }
+        if (smsConfig?.enabled) {
+          log(`  ${c.green("\u25CF")} SMS is ${c.green("enabled")}`);
+          log(`  ${c.dim("Phone number:")}    ${c.bold(smsConfig.phoneNumber)}`);
+          log(`  ${c.dim("Forwarding to:")}   ${smsConfig.forwardingEmail || c.dim("(agent email)")}`);
+          log(`  ${c.dim("Provider:")}        ${smsConfig.provider}`);
+          log(`  ${c.dim("Configured:")}      ${smsConfig.configuredAt ? new Date(smsConfig.configuredAt).toLocaleDateString() : "unknown"}`);
+        } else if (smsConfig && !smsConfig.enabled) {
+          log(`  ${c.yellow("\u25CF")} SMS is ${c.yellow("disabled")}`);
+          log(`  ${c.dim("Phone number:")}    ${smsConfig.phoneNumber}`);
+        } else {
+          log(`  ${c.dim("\u25CF")} SMS is ${c.dim("not configured")}`);
+        }
+        log("");
+        log(`  ${c.bold("Options:")}`);
+        if (!smsConfig?.enabled) {
+          log(`    ${c.cyan("1")} Set up a phone number`);
+        } else {
+          log(`    ${c.cyan("1")} View SMS messages`);
+          log(`    ${c.cyan("2")} Change phone number`);
+          log(`    ${c.cyan("3")} Check for verification codes`);
+          log(`    ${c.cyan("4")} Disable SMS`);
+        }
+        log(`    ${c.dim("Enter")} Go back`);
+        log("");
+        const choice = await new Promise((resolve) => {
+          rl.question(`  ${c.bold("Choose:")} `, resolve);
+        });
+        if (!smsConfig?.enabled) {
+          if (choice.trim() === "1") {
+            log("");
+            log(`  ${c.bold("Google Voice Setup (takes ~2 minutes):")}`);
+            log("");
+            log(`    1. Go to ${c.cyan("https://voice.google.com")}`);
+            log(`    2. Sign in with your Google account`);
+            log(`    3. Click "Choose a phone number"`);
+            log(`    4. Search by city or area code, pick a number`);
+            log(`    5. Verify with your existing phone`);
+            log(`    6. Go to Settings > Messages > Enable "Forward messages to email"`);
+            log("");
+            const phone = await new Promise((resolve) => {
+              rl.question(`  ${c.bold("Google Voice number")} ${c.dim("(e.g. +12125551234):")} `, resolve);
+            });
+            if (!phone.trim()) {
+              info("Cancelled.");
+              return;
+            }
+            const fwdEmail = await new Promise((resolve) => {
+              rl.question(`  ${c.bold("Forwarding email")} ${c.dim("(Enter for agent email):")} `, resolve);
+            });
+            try {
+              const resp = await fetch(`${apiBase}/api/agenticmail/sms/setup`, {
+                method: "POST",
+                headers: { "Content-Type": "application/json", "Authorization": `Bearer ${agent.apiKey}` },
+                body: JSON.stringify({ phoneNumber: phone.trim(), forwardingEmail: fwdEmail.trim() || void 0 })
+              });
+              const data = await resp.json();
+              if (data.success) {
+                ok(`Phone number saved: ${data.sms?.phoneNumber || phone.trim()}`);
+                info("Make sure SMS forwarding is enabled in Google Voice settings.");
+              } else {
+                fail(data.error || "Setup failed");
+              }
+            } catch (err) {
+              fail(err.message);
+            }
+          }
+        } else {
+          if (choice.trim() === "1") {
+            try {
+              const resp = await fetch(`${apiBase}/api/agenticmail/sms/messages?limit=20`, {
+                headers: { "Authorization": `Bearer ${agent.apiKey}` }
+              });
+              const data = await resp.json();
+              if (!data.messages?.length) {
+                info("No SMS messages yet.");
+              } else {
+                log("");
+                for (const msg of data.messages) {
+                  const dir = msg.direction === "inbound" ? c.green("\u2190 IN ") : c.blue("\u2192 OUT");
+                  const status = msg.status === "received" ? "" : ` ${c.dim(`[${msg.status}]`)}`;
+                  const time = new Date(msg.createdAt).toLocaleString();
+                  log(`  ${dir} ${c.bold(msg.phoneNumber)}${status} ${c.dim(time)}`);
+                  log(`       ${msg.body.length > 80 ? msg.body.slice(0, 80) + "..." : msg.body}`);
+                  log("");
+                }
+                info(`${data.messages.length} message(s)`);
+              }
+            } catch (err) {
+              fail(err.message);
+            }
+          } else if (choice.trim() === "2") {
+            const newPhone = await new Promise((resolve) => {
+              rl.question(`  ${c.bold("New Google Voice number")} ${c.dim("(e.g. +12125551234):")} `, resolve);
+            });
+            if (!newPhone.trim()) {
+              info("Cancelled.");
+              return;
+            }
+            const newFwd = await new Promise((resolve) => {
+              rl.question(`  ${c.bold("Forwarding email")} ${c.dim("(Enter to keep current):")} `, resolve);
+            });
+            try {
+              const resp = await fetch(`${apiBase}/api/agenticmail/sms/setup`, {
+                method: "POST",
+                headers: { "Content-Type": "application/json", "Authorization": `Bearer ${agent.apiKey}` },
+                body: JSON.stringify({ phoneNumber: newPhone.trim(), forwardingEmail: newFwd.trim() || void 0 })
+              });
+              const data = await resp.json();
+              if (data.success) {
+                ok(`Phone number updated to: ${data.sms?.phoneNumber || newPhone.trim()}`);
+              } else {
+                fail(data.error || "Update failed");
+              }
+            } catch (err) {
+              fail(err.message);
+            }
+          } else if (choice.trim() === "3") {
+            try {
+              const resp = await fetch(`${apiBase}/api/agenticmail/sms/verification-code?minutes=30`, {
+                headers: { "Authorization": `Bearer ${agent.apiKey}` }
+              });
+              const data = await resp.json();
+              if (data.found) {
+                log("");
+                ok(`Verification code found: ${c.bold(c.green(data.code))}`);
+                log(`  ${c.dim("From:")} ${data.from}`);
+                log(`  ${c.dim("Message:")} ${data.body}`);
+                log(`  ${c.dim("Received:")} ${new Date(data.receivedAt).toLocaleString()}`);
+              } else {
+                info("No verification codes found in the last 30 minutes.");
+                info("Make sure Google Voice SMS forwarding is enabled and use /inbox to check for forwarded SMS emails.");
+              }
+            } catch (err) {
+              fail(err.message);
+            }
+          } else if (choice.trim() === "4") {
+            const confirm = await new Promise((resolve) => {
+              rl.question(`  ${c.bold("Disable SMS?")} ${c.dim("This keeps your number saved but stops SMS features. (y/N)")} `, resolve);
+            });
+            if (confirm.toLowerCase().startsWith("y")) {
+              try {
+                const resp = await fetch(`${apiBase}/api/agenticmail/sms/disable`, {
+                  method: "POST",
+                  headers: { "Authorization": `Bearer ${agent.apiKey}` }
+                });
+                const data = await resp.json();
+                if (data.success) {
+                  ok("SMS disabled. Your number is still saved. Use /sms to re-enable anytime.");
+                } else {
+                  fail(data.error || "Failed to disable");
+                }
+              } catch (err) {
+                fail(err.message);
+              }
+            } else {
+              info("Cancelled.");
+            }
+          }
+        }
+        log("");
+      }
+    },
+    update: {
+      desc: "Check for and install the latest AgenticMail version",
+      run: async () => {
+        log("");
+        log(hr());
+        heading("Update AgenticMail");
+        log("");
+        const { execSync } = await import("child_process");
+        let currentVersion = "unknown";
+        try {
+          const pkg = await import("agenticmail/package.json");
+          currentVersion = pkg.default?.version ?? "unknown";
+        } catch {
+          try {
+            const { readFileSync: readFileSync3 } = await import("fs");
+            const { join: join2, dirname: dirname2 } = await import("path");
+            const { fileURLToPath: fileURLToPath2 } = await import("url");
+            const thisDir = dirname2(fileURLToPath2(import.meta.url));
+            const pkgPath = join2(thisDir, "..", "package.json");
+            const pkg = JSON.parse(readFileSync3(pkgPath, "utf-8"));
+            currentVersion = pkg.version ?? "unknown";
+          } catch {
+          }
+        }
+        info(`Current version: ${c.bold(currentVersion)}`);
+        let latestVersion = "unknown";
+        try {
+          latestVersion = execSync("npm view agenticmail version", { encoding: "utf-8", timeout: 15e3 }).trim();
+        } catch {
+          fail("Could not check npm for latest version. Check your internet connection.");
+          return;
+        }
+        info(`Latest version:  ${c.bold(latestVersion)}`);
+        if (currentVersion === latestVersion) {
+          ok("You are already on the latest version!");
+          log("");
+          return;
+        }
+        log("");
+        info(`New version available: ${c.yellow(currentVersion)} \u2192 ${c.green(latestVersion)}`);
+        let hasOpenClaw = false;
+        let openClawVersion = "";
+        try {
+          openClawVersion = execSync('openclaw --version 2>/dev/null || echo ""', { encoding: "utf-8", timeout: 1e4 }).trim();
+          if (openClawVersion) hasOpenClaw = true;
+        } catch {
+        }
+        if (hasOpenClaw) {
+          info(`OpenClaw detected: ${c.bold(openClawVersion)}`);
+          try {
+            const peerDeps = execSync(`npm view agenticmail@${latestVersion} peerDependencies --json 2>/dev/null`, { encoding: "utf-8", timeout: 15e3 }).trim();
+            if (peerDeps) {
+              const deps = JSON.parse(peerDeps);
+              if (deps.openclaw) {
+                info(`Required OpenClaw version: ${c.bold(deps.openclaw)}`);
+              }
+            }
+          } catch {
+          }
+          info("OpenClaw plugin will also be updated.");
+        }
+        log("");
+        const confirm = await new Promise((resolve) => {
+          rl.question(`  ${c.bold("Update now?")} ${c.dim("(Y/n)")} `, resolve);
+        });
+        if (confirm.toLowerCase().startsWith("n")) {
+          info("Update cancelled.");
+          log("");
+          return;
+        }
+        log("");
+        info("Updating...");
+        try {
+          let pm = "npm";
+          try {
+            execSync("pnpm --version", { stdio: "ignore", timeout: 5e3 });
+            pm = "pnpm";
+          } catch {
+            try {
+              execSync("bun --version", { stdio: "ignore", timeout: 5e3 });
+              pm = "bun";
+            } catch {
+            }
+          }
+          let isGlobal = false;
+          try {
+            const globalList = execSync(`${pm === "npm" ? "npm" : pm} list -g agenticmail 2>/dev/null`, { encoding: "utf-8", timeout: 1e4 });
+            if (globalList.includes("agenticmail")) isGlobal = true;
+          } catch {
+          }
+          const scope = isGlobal ? "-g" : "";
+          const installCmd = pm === "bun" ? `bun add ${scope} agenticmail@latest` : `${pm} install ${scope} agenticmail@latest`;
+          info(`Running: ${c.dim(installCmd)}`);
+          execSync(installCmd, { stdio: "inherit", timeout: 12e4 });
+          if (hasOpenClaw) {
+            const pluginCmd = pm === "bun" ? `bun add ${scope} @agenticmail/openclaw@latest` : `${pm} install ${scope} @agenticmail/openclaw@latest`;
+            info(`Updating OpenClaw plugin: ${c.dim(pluginCmd)}`);
+            try {
+              execSync(pluginCmd, { stdio: "inherit", timeout: 12e4 });
+              ok("OpenClaw plugin updated.");
+              try {
+                execSync("openclaw gateway restart", { stdio: "pipe", timeout: 3e4 });
+                ok("OpenClaw gateway restarted.");
+              } catch {
+                info(`Restart OpenClaw manually: ${c.green("openclaw gateway restart")}`);
+              }
+            } catch (err) {
+              log(`  ${c.yellow("!")} Plugin update failed: ${err.message}`);
+              info(`Update manually: ${c.green(pluginCmd)}`);
+            }
+          }
+          log("");
+          ok(`Updated to agenticmail@${latestVersion}`);
+          info("Restart the shell to use the new version.");
+          log("");
+        } catch (err) {
+          fail(`Update failed: ${err.message}`);
+          info(`Try manually: ${c.green("npm install -g agenticmail@latest")}`);
+          log("");
+        }
+      }
+    },
     exit: {
       desc: "Stop the server and exit",
       run: async () => {
@@ -4054,22 +4394,53 @@ async function waitForApi(host, port, timeoutMs = 15e3) {
   }
   return false;
 }
-var apiChild = null;
-function cleanupChild() {
-  if (apiChild) {
-    apiChild.kill();
-    apiChild = null;
+var PID_FILE = join(homedir(), ".agenticmail", "server.pid");
+async function startApiServer(config) {
+  const host = config.api.host;
+  const port = config.api.port;
+  try {
+    const probe = await fetch(`http://${host}:${port}/api/agenticmail/health`, {
+      signal: AbortSignal.timeout(2e3)
+    });
+    if (probe.ok) return true;
+  } catch {
+  }
+  const { spawn } = await import("child_process");
+  const apiEntry = resolveApiEntry();
+  const env = configToEnv(config);
+  const child = spawn(process.execPath, [apiEntry], {
+    detached: true,
+    stdio: "ignore",
+    env
+  });
+  child.unref();
+  if (child.pid) {
+    try {
+      writeFileSync2(PID_FILE, String(child.pid));
+    } catch {
+    }
+  }
+  return waitForApi(host, port);
+}
+function stopApiServer() {
+  try {
+    if (!existsSync2(PID_FILE)) return false;
+    const pid = parseInt(readFileSync2(PID_FILE, "utf-8").trim(), 10);
+    if (isNaN(pid)) return false;
+    process.kill(pid, "SIGTERM");
+    try {
+      unlinkSync(PID_FILE);
+    } catch {
+    }
+    return true;
+  } catch {
+    try {
+      unlinkSync(PID_FILE);
+    } catch {
+    }
+    return false;
   }
 }
-process.on("exit", cleanupChild);
-process.on("SIGINT", () => {
-  cleanupChild();
-  process.exit(0);
-});
-process.on("SIGTERM", () => {
-  cleanupChild();
-  process.exit(0);
-});
 async function cmdSetup() {
   log2("");
   log2(`  ${c2.bgCyan(" AgenticMail Setup ")}`);
@@ -4078,7 +4449,7 @@ async function cmdSetup() {
   log2(`  needs to send and receive real email.`);
   log2("");
   const hasOpenClaw = existsSync2(join(homedir(), ".openclaw", "openclaw.json"));
-  const totalSteps = hasOpenClaw ? 5 : 4;
+  const totalSteps = hasOpenClaw ? 6 : 5;
   log2(`  Here's what we'll do:`);
   log2(`    ${c2.dim("1.")} Check your system for required tools`);
   log2(`    ${c2.dim("2.")} Create your private account and keys`);
@@ -4258,51 +4629,14 @@ async function cmdSetup() {
   serverSpinner.start();
   let serverReady = false;
   try {
-    const probe = await fetch(`http://${result.config.api.host}:${result.config.api.port}/api/agenticmail/health`, {
-      signal: AbortSignal.timeout(2e3)
-    });
-    if (probe.ok) serverReady = true;
-  } catch {
-  }
-  if (serverReady) {
-    serverSpinner.succeed(`Server already running at ${c2.cyan(`http://${result.config.api.host}:${result.config.api.port}`)}`);
-  } else {
-    try {
-      const { fork } = await import("child_process");
-      const apiEntry = resolveApiEntry();
-      const env = configToEnv(result.config);
-      apiChild = fork(apiEntry, [], { stdio: ["ignore", "ignore", "pipe", "ipc"], env });
-      const stderrLines = [];
-      apiChild.stderr?.on("data", (chunk) => {
-        const lines = chunk.toString().trim().split("\n");
-        for (const line of lines) {
-          stderrLines.push(line);
-          if (stderrLines.length > 50) stderrLines.shift();
-        }
-      });
-      apiChild.on("exit", (code, signal) => {
-        apiChild = null;
-        log2("");
-        fail2(`Server stopped unexpectedly${signal ? ` (signal: ${signal})` : code ? ` (exit code: ${code})` : ""}`);
-        if (stderrLines.length > 0) {
-          log2("");
-          log2(`  ${c2.dim("Last server output:")}`);
-          for (const line of stderrLines.slice(-10)) {
-            log2(`  ${c2.dim(line)}`);
-          }
-        }
-        log2("");
-        process.exit(code ?? 1);
-      });
-      serverReady = await waitForApi(result.config.api.host, result.config.api.port);
-      if (serverReady) {
-        serverSpinner.succeed(`Server running at ${c2.cyan(`http://${result.config.api.host}:${result.config.api.port}`)}`);
-      } else {
-        serverSpinner.fail("Server did not start in time");
-      }
-    } catch (err) {
-      serverSpinner.fail(`Could not start server: ${err.message}`);
+    serverReady = await startApiServer(result.config);
+    if (serverReady) {
+      serverSpinner.succeed(`Server running at ${c2.cyan(`http://${result.config.api.host}:${result.config.api.port}`)}`);
+    } else {
+      serverSpinner.fail("Server did not start in time");
     }
+  } catch (err) {
+    serverSpinner.fail(`Could not start server: ${err.message}`);
   }
   let existingEmail = null;
   let existingProvider = null;
@@ -4363,7 +4697,6 @@ async function cmdSetup() {
   if (choice === "1" || choice === "2") {
     if (!serverReady) {
       info2("You can configure email later by running: agenticmail setup");
-      cleanupChild();
       printSummary(result, true);
       return;
     }
@@ -4378,22 +4711,130 @@ async function cmdSetup() {
     if (!emailOk) {
       log2("");
       info2("Email setup did not complete. Run " + c2.green("npx agenticmail setup") + " again to retry.");
-      cleanupChild();
       printSummary(result, true);
       return;
     }
   } else if (!existingEmail) {
     info2("No problem! You can set up email anytime by running this again.");
   }
+  if (serverReady) {
+    log2("");
+    log2(`  ${c2.bold(`Step 5 of ${totalSteps}`)} ${c2.dim("\u2014")} ${c2.bold("Phone number access (optional)")}`);
+    log2("");
+    log2(`  ${c2.dim("Give your AI agent a phone number via Google Voice.")}`);
+    log2(`  ${c2.dim("This lets agents receive verification codes and send texts.")}`);
+    log2("");
+    const wantSms = await ask(`  ${c2.bold("Set up phone number access?")} ${c2.dim("(y/N)")} `);
+    if (wantSms.toLowerCase().startsWith("y")) {
+      log2("");
+      log2(`  ${c2.bold("What this does:")}`);
+      log2(`    Your AI agent gets a real phone number it can use to:`);
+      log2(`    ${c2.dim("*")} Receive verification codes when signing up for services`);
+      log2(`    ${c2.dim("*")} Send and receive text messages`);
+      log2(`    ${c2.dim("*")} Verify accounts on platforms that require phone numbers`);
+      log2("");
+      log2(`  ${c2.bold("How it works:")}`);
+      log2(`    Google Voice gives you a free US phone number. When someone`);
+      log2(`    texts that number, Google forwards it to your email. Your`);
+      log2(`    agent reads the email and extracts the message or code.`);
+      log2("");
+      const hasVoice = await ask(`  ${c2.bold("Do you already have a Google Voice number?")} ${c2.dim("(y/N)")} `);
+      if (!hasVoice.toLowerCase().startsWith("y")) {
+        log2("");
+        log2(`  ${c2.bold("No problem! Setting up Google Voice takes about 2 minutes:")}`);
+        log2("");
+        log2(`  ${c2.cyan("Step 1:")} Open ${c2.bold(c2.cyan("https://voice.google.com"))} in your browser`);
+        log2(`  ${c2.cyan("Step 2:")} Sign in with your Google account`);
+        log2(`  ${c2.cyan("Step 3:")} Click ${c2.bold('"Choose a phone number"')}`);
+        log2(`  ${c2.cyan("Step 4:")} Search for a number by city or area code`);
+        log2(`  ${c2.cyan("Step 5:")} Pick a number and click ${c2.bold('"Verify"')}`);
+        log2(`         ${c2.dim("(Google will verify via your existing phone number)")}`);
+        log2(`  ${c2.cyan("Step 6:")} Once verified, go to ${c2.bold("Settings")} (gear icon)`);
+        log2(`  ${c2.cyan("Step 7:")} Under Messages, enable ${c2.bold('"Forward messages to email"')}`);
+        log2("");
+        log2(`  ${c2.dim("That's it! Come back here when you have your number.")}`);
+        log2("");
+        const ready = await ask(`  ${c2.bold("Press Enter when you have your Google Voice number ready...")} `);
+      }
+      log2("");
+      const phoneNumber = await ask(`  ${c2.bold("Your Google Voice phone number")} ${c2.dim("(e.g. +12125551234):")} `);
+      if (phoneNumber.trim()) {
+        const digits = phoneNumber.replace(/[^+\d]/g, "").replace(/\D/g, "");
+        if (digits.length < 10) {
+          log2(`  ${c2.yellow("!")} That doesn't look like a valid phone number (need at least 10 digits).`);
+          info2("You can set this up later in the shell with /sms or via the agenticmail_sms_setup tool.");
+        } else {
+          const forwardEmail = await ask(`  ${c2.bold("Email Google Voice forwards SMS to")} ${c2.dim("(Enter to use agent email):")} `);
+          try {
+            const apiBase = `http://${result.config.api.host}:${result.config.api.port}`;
+            const resp = await fetch(`${apiBase}/api/agenticmail/sms/setup`, {
+              method: "POST",
+              headers: {
+                "Content-Type": "application/json",
+                "Authorization": `Bearer ${result.config.masterKey}`
+              },
+              body: JSON.stringify({
+                phoneNumber: phoneNumber.trim(),
+                forwardingEmail: forwardEmail.trim() || void 0
+              })
+            });
+            const data = await resp.json();
+            if (data.success) {
+              log2("");
+              log2(`  ${c2.green("\u2714")} Phone number saved: ${c2.bold(data.sms?.phoneNumber || phoneNumber.trim())}`);
+              log2("");
+              log2(`  ${c2.bold("Important:")} Make sure you enabled SMS forwarding in Google Voice:`);
+              log2(`    ${c2.dim("voice.google.com > Settings > Messages > Forward messages to email")}`);
+              log2("");
+              log2(`  ${c2.dim("Your agent can now receive verification codes and text messages.")}`);
+              log2(`  ${c2.dim("Manage SMS anytime in the shell with /sms")}`);
+            } else {
+              throw new Error(data.error || "API call failed");
+            }
+          } catch {
+            try {
+              const { readFileSync: readFileSync3, writeFileSync: writeFileSync3 } = await import("fs");
+              const { join: join2 } = await import("path");
+              const os = await import("os");
+              const configPath = join2(result.config.dataDir || os.homedir() + "/.agenticmail", "config.json");
+              let fileConfig = {};
+              try {
+                fileConfig = JSON.parse(readFileSync3(configPath, "utf-8"));
+              } catch {
+              }
+              fileConfig.sms = {
+                enabled: true,
+                phoneNumber: phoneNumber.trim(),
+                forwardingEmail: forwardEmail.trim() || "",
+                provider: "google_voice",
+                configuredAt: (/* @__PURE__ */ new Date()).toISOString()
+              };
+              writeFileSync3(configPath, JSON.stringify(fileConfig, null, 2), { encoding: "utf-8", mode: 384 });
+              log2(`  ${c2.green("\u2714")} Phone number saved: ${c2.bold(phoneNumber.trim())}`);
+              log2(`  ${c2.dim("Make sure SMS forwarding is enabled in Google Voice settings.")}`);
+            } catch (err) {
+              log2(`  ${c2.yellow("!")} Could not save: ${err.message}`);
+              log2(`  ${c2.dim("Set up later in the shell with /sms")}`);
+            }
+          }
+        }
+      } else {
+        info2("Skipped. Set up anytime in the shell with /sms");
+      }
+    } else {
+      info2("Skipped. Add a phone number anytime with /sms in the shell.");
+    }
+  }
   if (hasOpenClaw && serverReady) {
     log2("");
-    log2(`  ${c2.bold(`Step 5 of ${totalSteps}`)} ${c2.dim("\u2014")} ${c2.bold("Configure OpenClaw integration")}`);
+    log2(`  ${c2.bold(`Step 6 of ${totalSteps}`)} ${c2.dim("\u2014")} ${c2.bold("Configure OpenClaw integration")}`);
     log2("");
     await registerWithOpenClaw(result.config);
   }
   printSummary(result, false);
   if (serverReady) {
-    await interactiveShell({ config: result.config, onExit: cleanupChild });
+    await interactiveShell({ config: result.config, onExit: () => {
+    } });
   }
 }
 function printSummary(result, exitAfter) {
@@ -4975,11 +5416,12 @@ async function cmdOpenClaw() {
   log2(`  This will:`);
   log2(`    ${c2.dim("1.")} Set up the mail server infrastructure`);
   log2(`    ${c2.dim("2.")} Create an agent email account`);
-  log2(`    ${c2.dim("3.")} Configure the OpenClaw plugin`);
-  log2(`    ${c2.dim("4.")} Restart the OpenClaw gateway`);
+  log2(`    ${c2.dim("3.")} Set up phone number access ${c2.green("NEW")}`);
+  log2(`    ${c2.dim("4.")} Configure the OpenClaw plugin`);
+  log2(`    ${c2.dim("5.")} Restart the OpenClaw gateway`);
   log2("");
   const setup = new SetupManager();
-  log2(`  ${c2.bold("Step 1 of 5")} ${c2.dim("\u2014")} ${c2.bold("Checking infrastructure")}`);
+  log2(`  ${c2.bold("Step 1 of 6")} ${c2.dim("\u2014")} ${c2.bold("Checking infrastructure")}`);
   log2("");
   let config;
   let configPath;
@@ -5038,7 +5480,7 @@ async function cmdOpenClaw() {
     }
   }
   log2("");
-  log2(`  ${c2.bold("Step 2 of 5")} ${c2.dim("\u2014")} ${c2.bold("Starting server")}`);
+  log2(`  ${c2.bold("Step 2 of 6")} ${c2.dim("\u2014")} ${c2.bold("Starting server")}`);
   log2("");
   const apiHost = config.api.host;
   const apiPort = config.api.port;
@@ -5057,17 +5499,9 @@ async function cmdOpenClaw() {
     const serverSpinner = new Spinner("server", "Starting the server...");
     serverSpinner.start();
     try {
-      const { fork } = await import("child_process");
-      const apiEntry = resolveApiEntry();
-      const env = configToEnv(config);
-      apiChild = fork(apiEntry, [], { stdio: ["ignore", "ignore", "pipe", "ipc"], env });
-      apiChild.on("exit", () => {
-        apiChild = null;
-      });
-      const ready = await waitForApi(apiHost, apiPort);
+      const ready = await startApiServer(config);
       if (!ready) {
         serverSpinner.fail("Server did not start in time");
-        cleanupChild();
         process.exit(1);
       }
       serverSpinner.succeed(`Server running at ${c2.cyan(apiBase)}`);
@@ -5077,7 +5511,7 @@ async function cmdOpenClaw() {
     }
   }
   log2("");
-  log2(`  ${c2.bold("Step 3 of 5")} ${c2.dim("\u2014")} ${c2.bold("Agent account")}`);
+  log2(`  ${c2.bold("Step 3 of 6")} ${c2.dim("\u2014")} ${c2.bold("Agent account")}`);
   log2("");
   let agentApiKey;
   let agentEmail = "";
@@ -5249,7 +5683,212 @@ async function cmdOpenClaw() {
     }
   }
   log2("");
-  log2(`  ${c2.bold("Step 4 of 5")} ${c2.dim("\u2014")} ${c2.bold("Installing plugin + configuring OpenClaw")}`);
+  log2(`  ${c2.bold("Step 4 of 6")} ${c2.dim("\u2014")} ${c2.bold("Phone number access")} ${c2.green("NEW")}`);
+  log2("");
+  log2(`  ${c2.dim("Give your AI agent a phone number via Google Voice.")}`);
+  log2(`  ${c2.dim("Agents can receive verification codes and send texts.")}`);
+  log2("");
+  let smsAlreadyConfigured = false;
+  if (agentApiKey) {
+    try {
+      const smsResp = await fetch(`${apiBase}/api/agenticmail/sms/config`, {
+        headers: { "Authorization": `Bearer ${agentApiKey}` },
+        signal: AbortSignal.timeout(3e3)
+      });
+      const smsData = await smsResp.json();
+      if (smsData.sms?.enabled) {
+        smsAlreadyConfigured = true;
+        ok2(`SMS already configured: ${c2.bold(smsData.sms.phoneNumber)}`);
+      }
+    } catch {
+    }
+  }
+  if (!smsAlreadyConfigured) {
+    const wantSms = await ask(`  ${c2.bold("Set up phone number access?")} ${c2.dim("(y/N)")} `);
+    if (wantSms.toLowerCase().startsWith("y")) {
+      log2("");
+      const hasVoice = await ask(`  ${c2.bold("Do you already have a Google Voice number?")} ${c2.dim("(y/N)")} `);
+      if (!hasVoice.toLowerCase().startsWith("y")) {
+        log2("");
+        log2(`  ${c2.bold("Google Voice Setup (takes about 2 minutes):")}`);
+        log2("");
+        log2(`  ${c2.cyan("Step 1:")} Open ${c2.bold(c2.cyan("https://voice.google.com"))} in your browser`);
+        log2(`  ${c2.cyan("Step 2:")} Sign in with your Google account`);
+        log2(`  ${c2.cyan("Step 3:")} Click ${c2.bold('"Choose a phone number"')}`);
+        log2(`  ${c2.cyan("Step 4:")} Search for a number by city or area code`);
+        log2(`  ${c2.cyan("Step 5:")} Pick a number and click ${c2.bold('"Verify"')}`);
+        log2(`         ${c2.dim("(Google will send a code to your existing phone to verify)")}`);
+        log2(`  ${c2.cyan("Step 6:")} Once verified, go to ${c2.bold("Settings")} (gear icon)`);
+        log2(`  ${c2.cyan("Step 7:")} Under Messages, enable ${c2.bold('"Forward messages to email"')}`);
+        log2("");
+        log2(`  ${c2.dim("Come back here when you have your number.")}`);
+        log2("");
+        await ask(`  ${c2.bold("Press Enter when ready...")} `);
+      }
+      log2("");
+      const phoneNumber = await ask(`  ${c2.bold("Your Google Voice number")} ${c2.dim("(e.g. +12125551234):")} `);
+      if (phoneNumber.trim()) {
+        const digits = phoneNumber.replace(/[^+\d]/g, "").replace(/\D/g, "");
+        if (digits.length < 10) {
+          log2(`  ${c2.yellow("!")} That doesn't look like a valid phone number.`);
+          info2("You can set this up later in the shell with /sms");
+        } else {
+          let forwardingEmail;
+          let forwardingPassword;
+          let relayEmail = "";
+          let relayProvider = "";
+          try {
+            const gwResp = await fetch(`${apiBase}/api/agenticmail/gateway/status`, {
+              headers: { "Authorization": `Bearer ${config.masterKey}` },
+              signal: AbortSignal.timeout(5e3)
+            });
+            const gwData = await gwResp.json();
+            if (gwData.mode === "relay" && gwData.relay?.email) {
+              relayEmail = gwData.relay.email;
+              relayProvider = gwData.relay.provider || "";
+            } else if (gwData.mode === "domain") {
+              relayProvider = "domain";
+            }
+          } catch {
+          }
+          log2("");
+          log2(`  \u250C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510`);
+          log2(`  \u2502  ${c2.red(c2.bold("READ THIS"))} \u2014 Google Voice email matching is ${c2.red(c2.bold("critical"))}  \u2502`);
+          log2(`  \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518`);
+          log2("");
+          log2(`  Google Voice forwards SMS ${c2.bold("ONLY")} to the ${c2.green(c2.bold("Gmail account"))}`);
+          log2(`  you used to ${c2.green(c2.bold("sign up"))} for Google Voice.`);
+          log2("");
+          log2(`  ${c2.yellow("If your agent can't read that Gmail, it will")} ${c2.red(c2.bold("NEVER"))}`);
+          log2(`  ${c2.yellow("receive any SMS messages.")}`);
+          log2("");
+          if (relayEmail) {
+            const isGmail = relayEmail.toLowerCase().endsWith("@gmail.com");
+            log2(`  Your email relay: ${c2.bold(c2.cyan(relayEmail))}`);
+            if (!isGmail) {
+              log2("");
+              log2(`  ${c2.red(c2.bold("!!"))} Your relay is ${c2.bold("not Gmail")}. Google Voice won't forward here.`);
+              log2(`  ${c2.red(c2.bold("!!"))} You ${c2.bold("must")} provide the Gmail you used for Google Voice.`);
+              log2("");
+              const gvEmail = await ask(`  ${c2.green(c2.bold("Gmail used for Google Voice:"))} `);
+              if (gvEmail.trim() && gvEmail.toLowerCase().includes("@gmail.com")) {
+                log2("");
+                log2(`  ${c2.dim("Get an app password at:")} ${c2.cyan("https://myaccount.google.com/apppasswords")}`);
+                const gvPass = await ask(`  ${c2.green(c2.bold("App password for"))} ${c2.bold(gvEmail.trim())}: `);
+                if (gvPass.trim()) {
+                  forwardingEmail = gvEmail.trim();
+                  forwardingPassword = gvPass.trim();
+                } else {
+                  log2(`  ${c2.red("!")} No password. ${c2.yellow("SMS will not work without this.")}`);
+                  log2(`  ${c2.dim("Fix later with /sms in the shell.")}`);
+                }
+              } else if (gvEmail.trim()) {
+                log2(`  ${c2.red("!")} Google Voice requires a ${c2.bold("Gmail")} address (ends in @gmail.com).`);
+                log2(`  ${c2.dim("Fix later with /sms in the shell.")}`);
+              } else {
+                log2(`  ${c2.yellow("!")} Skipped. ${c2.dim("SMS will not work until you provide this.")}`);
+                log2(`  ${c2.dim("Fix later with /sms in the shell.")}`);
+              }
+            } else {
+              log2("");
+              log2(`  ${c2.yellow("?")} Did you sign up for Google Voice with ${c2.bold("this same Gmail")}?`);
+              log2(`    ${c2.dim("If you used a different Gmail for Google Voice, say no.")}`);
+              log2("");
+              const sameEmail = await ask(`  ${c2.bold("Same Gmail as Google Voice?")} ${c2.dim("(Y/n)")} `);
+              if (sameEmail.toLowerCase().startsWith("n")) {
+                log2("");
+                log2(`  ${c2.yellow(c2.bold("Different Gmail detected."))} Your agent needs access to the`);
+                log2(`  Google Voice Gmail to receive SMS.`);
+                log2("");
+                const gvEmail = await ask(`  ${c2.green(c2.bold("Gmail used for Google Voice:"))} `);
+                if (gvEmail.trim() && gvEmail.toLowerCase().includes("@gmail.com")) {
+                  if (gvEmail.trim().toLowerCase() === relayEmail.toLowerCase()) {
+                    log2(`  ${c2.green("!")} That's the same email as your relay \u2014 you're all set!`);
+                  } else {
+                    log2("");
+                    log2(`  ${c2.dim("Get an app password at:")} ${c2.cyan("https://myaccount.google.com/apppasswords")}`);
+                    const gvPass = await ask(`  ${c2.green(c2.bold("App password for"))} ${c2.bold(gvEmail.trim())}: `);
+                    if (gvPass.trim()) {
+                      forwardingEmail = gvEmail.trim();
+                      forwardingPassword = gvPass.trim();
+                    } else {
+                      log2(`  ${c2.red("!")} No password. ${c2.yellow("SMS will not work without this.")}`);
+                      log2(`  ${c2.dim("Fix later with /sms in the shell.")}`);
+                    }
+                  }
+                } else if (gvEmail.trim()) {
+                  log2(`  ${c2.red("!")} Google Voice requires a ${c2.bold("Gmail")} address.`);
+                  log2(`  ${c2.dim("Fix later with /sms in the shell.")}`);
+                } else {
+                  log2(`  ${c2.yellow("!")} Skipped. ${c2.dim("SMS may not work if emails don't match.")}`);
+                  log2(`  ${c2.dim("Fix later with /sms in the shell.")}`);
+                }
+              }
+            }
+          } else if (relayProvider === "domain") {
+            log2(`  ${c2.yellow("!")} You're using ${c2.bold("domain mode")} (no Gmail relay).`);
+            log2(`  ${c2.yellow("!")} Google Voice needs a Gmail. Provide the one you signed up with.`);
+            log2("");
+            const gvEmail = await ask(`  ${c2.green(c2.bold("Gmail used for Google Voice:"))} `);
+            if (gvEmail.trim() && gvEmail.toLowerCase().includes("@gmail.com")) {
+              log2("");
+              log2(`  ${c2.dim("Get an app password at:")} ${c2.cyan("https://myaccount.google.com/apppasswords")}`);
+              const gvPass = await ask(`  ${c2.green(c2.bold("App password for"))} ${c2.bold(gvEmail.trim())}: `);
+              if (gvPass.trim()) {
+                forwardingEmail = gvEmail.trim();
+                forwardingPassword = gvPass.trim();
+              } else {
+                log2(`  ${c2.red("!")} No password. ${c2.yellow("SMS will not work without this.")}`);
+                log2(`  ${c2.dim("Fix later with /sms in the shell.")}`);
+              }
+            } else {
+              log2(`  ${c2.yellow("!")} Skipped. ${c2.dim("SMS will not work until you provide this.")}`);
+              log2(`  ${c2.dim("Fix later with /sms in the shell.")}`);
+            }
+          } else {
+            log2(`  ${c2.dim("No email relay detected yet.")}`);
+            log2("");
+            const gvEmail = await ask(`  ${c2.green(c2.bold("Gmail used for Google Voice:"))} `);
+            if (gvEmail.trim() && gvEmail.includes("@")) {
+              forwardingEmail = gvEmail.trim();
+            }
+          }
+          if (agentApiKey) {
+            try {
+              const body = { phoneNumber: phoneNumber.trim() };
+              if (forwardingEmail) body.forwardingEmail = forwardingEmail;
+              if (forwardingPassword) body.forwardingPassword = forwardingPassword;
+              const resp = await fetch(`${apiBase}/api/agenticmail/sms/setup`, {
+                method: "POST",
+                headers: { "Content-Type": "application/json", "Authorization": `Bearer ${agentApiKey}` },
+                body: JSON.stringify(body)
+              });
+              const data = await resp.json();
+              if (data.success) {
+                log2("");
+                ok2(`Phone number saved: ${c2.bold(data.sms?.phoneNumber || phoneNumber.trim())}`);
+                if (forwardingEmail) {
+                  ok2(`SMS forwarding via: ${c2.bold(forwardingEmail)}`);
+                }
+                log2(`  ${c2.dim('Remember: enable "Forward messages to email" in Google Voice settings')}`);
+                log2(`  ${c2.dim("Manage SMS anytime in the shell with /sms")}`);
+              } else {
+                fail2(data.error || "Setup failed");
+              }
+            } catch (err) {
+              fail2(err.message);
+            }
+          }
+        }
+      } else {
+        info2("Skipped. Use /sms in the shell anytime.");
+      }
+    } else {
+      info2("Skipped. Add a phone number anytime with /sms in the shell.");
+    }
+  }
+  log2("");
+  log2(`  ${c2.bold("Step 5 of 6")} ${c2.dim("\u2014")} ${c2.bold("Installing plugin + configuring OpenClaw")}`);
   log2("");
   const pluginDir = resolveOpenClawPluginDir();
   if (pluginDir) {
@@ -5323,7 +5962,7 @@ async function cmdOpenClaw() {
     }
   }
   log2("");
-  log2(`  ${c2.bold("Step 5 of 5")} ${c2.dim("\u2014")} ${c2.bold("Restarting OpenClaw gateway")}`);
+  log2(`  ${c2.bold("Step 6 of 6")} ${c2.dim("\u2014")} ${c2.bold("Restarting OpenClaw gateway")}`);
   log2("");
   let gatewayRestarted = false;
   let hasOpenClawCli = false;
@@ -5371,27 +6010,69 @@ async function cmdOpenClaw() {
   }
   log2(`  ${c2.dim("Master Key:")}  ${c2.yellow(config.masterKey)}`);
   log2(`  ${c2.dim("Server:")}      ${c2.cyan(apiBase)}`);
+  let smsPhone = "";
+  if (agentApiKey) {
+    try {
+      const smsResp = await fetch(`${apiBase}/api/agenticmail/sms/config`, {
+        headers: { "Authorization": `Bearer ${agentApiKey}` },
+        signal: AbortSignal.timeout(3e3)
+      });
+      const smsData = await smsResp.json();
+      if (smsData.sms?.enabled && smsData.sms?.phoneNumber) {
+        smsPhone = smsData.sms.phoneNumber;
+        log2(`  ${c2.dim("Phone:")}      ${c2.green(smsPhone)} ${c2.dim("via Google Voice")}`);
+      }
+    } catch {
+    }
+  }
+  if (!smsPhone) {
+    try {
+      const acctResp = await fetch(`${apiBase}/api/agenticmail/accounts`, {
+        headers: { "Authorization": `Bearer ${config.masterKey}` },
+        signal: AbortSignal.timeout(3e3)
+      });
+      const acctData = await acctResp.json();
+      for (const a of acctData.agents || []) {
+        const smsConf = a.metadata?.sms;
+        if (smsConf?.enabled && smsConf.phoneNumber) {
+          smsPhone = smsConf.phoneNumber;
+          log2(`  ${c2.dim("Phone:")}      ${c2.green(smsPhone)} ${c2.dim("via Google Voice")} ${c2.dim("(" + a.name + ")")}`);
+          break;
+        }
+      }
+    } catch {
+    }
+  }
   log2("");
   if (gatewayRestarted) {
-    log2(`  Your agent now has ${c2.bold("54 email tools")} available!`);
+    log2(`  Your agent now has ${c2.bold("63 email + SMS tools")} available!`);
     log2(`  Try: ${c2.dim('"Send an email to test@example.com"')}`);
     log2("");
     log2(`  ${c2.bold("\u{1F380} AgenticMail Coordination")} ${c2.dim("(auto-configured)")}`);
     log2(`    Your agent can now use ${c2.cyan("agenticmail_call_agent")} to call other agents`);
     log2(`    with structured task queues, push notifications, and auto-spawned sessions.`);
     log2(`    This replaces sessions_spawn for coordinated multi-agent work.`);
+    log2("");
+    if (smsPhone) {
+      log2(`  ${c2.bold("\u{1F4F1} SMS & Phone Access")} ${c2.green("ACTIVE")}`);
+      log2(`    Phone: ${c2.bold(smsPhone)} via Google Voice`);
+      log2(`    Your agent can receive verification codes and send texts.`);
+      log2(`    Manage with ${c2.cyan("/sms")} in the shell.`);
+    } else {
+      log2(`  ${c2.bold("\u{1F4F1} SMS & Phone Access")} ${c2.dim("(Google Voice)")}`);
+      log2(`    Your agent can receive verification codes and send texts.`);
+      log2(`    SMS messages are auto-detected from Google Voice email forwarding.`);
+      log2(`    Set up with ${c2.cyan("/sms")} in the shell or during setup wizard.`);
+    }
   } else {
     log2(`  ${c2.bold("Next step:")}`);
     log2(`    Restart your OpenClaw gateway, then your agent will`);
-    log2(`    have ${c2.bold("54 email tools")} available!`);
+    log2(`    have ${c2.bold("63 email + SMS tools")} available!`);
   }
   log2("");
   if (process.stdin.isTTY) {
-    await interactiveShell({ config, onExit: cleanupChild });
-  } else {
-    if (!serverWasRunning) {
-      cleanupChild();
-    }
+    await interactiveShell({ config, onExit: () => {
+    } });
   }
 }
 function printPluginSnippet(apiUrl, masterKey, agentApiKey) {
@@ -5532,61 +6213,118 @@ async function cmdStart() {
   }
   const serverSpinner = new Spinner("server", "Launching your server...");
   serverSpinner.start();
-  let alreadyRunning = false;
   try {
-    const probe = await fetch(`http://${config.api.host}:${config.api.port}/api/agenticmail/health`, {
-      signal: AbortSignal.timeout(2e3)
-    });
-    if (probe.ok) alreadyRunning = true;
-  } catch {
+    const ready = await startApiServer(config);
+    if (ready) {
+      serverSpinner.succeed(`Server running at ${c2.cyan(`http://${config.api.host}:${config.api.port}`)}`);
+    } else {
+      serverSpinner.fail("Server did not start in time");
+      process.exit(1);
+    }
+  } catch (err) {
+    serverSpinner.fail(`Couldn't start the server: ${err.message}`);
+    process.exit(1);
   }
-  if (alreadyRunning) {
-    serverSpinner.succeed(`Server already running at ${c2.cyan(`http://${config.api.host}:${config.api.port}`)}`);
+  await interactiveShell({ config, onExit: () => {
+  } });
+}
+async function cmdStop() {
+  log2("");
+  const stopped = stopApiServer();
+  if (stopped) {
+    ok2("AgenticMail server stopped");
   } else {
+    info2("Server is not running");
+  }
+  log2("");
+}
+async function cmdUpdate() {
+  const { execSync } = await import("child_process");
+  log2("");
+  log2(`  ${c2.dim("\u2500".repeat(50))}`);
+  log2(`  ${c2.bold("Update AgenticMail")}`);
+  log2("");
+  let currentVersion = "unknown";
+  try {
+    const { readFileSync: readFileSync3 } = await import("fs");
+    const { join: join2, dirname: dirname2 } = await import("path");
+    const { fileURLToPath: fileURLToPath2 } = await import("url");
+    const thisDir = dirname2(fileURLToPath2(import.meta.url));
+    const pkg = JSON.parse(readFileSync3(join2(thisDir, "..", "package.json"), "utf-8"));
+    currentVersion = pkg.version ?? "unknown";
+  } catch {
+  }
+  info2(`Current version: ${c2.bold(currentVersion)}`);
+  let latestVersion = "unknown";
+  try {
+    latestVersion = execSync("npm view agenticmail version", { encoding: "utf-8", timeout: 15e3 }).trim();
+  } catch {
+    fail2("Could not check npm. Check your internet connection.");
+    process.exit(1);
+  }
+  info2(`Latest version:  ${c2.bold(latestVersion)}`);
+  if (currentVersion === latestVersion) {
+    ok2("Already on the latest version!");
+    log2("");
+    process.exit(0);
+  }
+  info2(`New version available: ${c2.yellow(currentVersion)} \u2192 ${c2.green(latestVersion)}`);
+  log2("");
+  let hasOpenClaw = false;
+  try {
+    execSync("which openclaw", { stdio: "ignore", timeout: 5e3 });
+    hasOpenClaw = true;
+    const ocVersion = execSync('openclaw --version 2>/dev/null || echo "?"', { encoding: "utf-8", timeout: 1e4 }).trim();
+    info2(`OpenClaw detected: ${c2.bold(ocVersion)}`);
+  } catch {
+  }
+  let pm = "npm";
+  try {
+    execSync("pnpm --version", { stdio: "ignore", timeout: 5e3 });
+    pm = "pnpm";
+  } catch {
     try {
-      const { fork } = await import("child_process");
-      const apiEntry = resolveApiEntry();
-      if (!existsSync2(apiEntry)) {
-        serverSpinner.fail(`Server isn't built yet. Run: ${c2.bold("npm run build")}`);
-        process.exit(1);
-      }
-      const env = configToEnv(config);
-      apiChild = fork(apiEntry, [], { stdio: ["ignore", "ignore", "pipe", "ipc"], env });
-      const stderrLines = [];
-      apiChild.stderr?.on("data", (chunk) => {
-        const lines = chunk.toString().trim().split("\n");
-        for (const line of lines) {
-          stderrLines.push(line);
-          if (stderrLines.length > 50) stderrLines.shift();
-        }
-      });
-      apiChild.on("exit", (code, signal) => {
-        apiChild = null;
-        log2("");
-        fail2(`Server stopped unexpectedly${signal ? ` (signal: ${signal})` : code ? ` (exit code: ${code})` : ""}`);
-        if (stderrLines.length > 0) {
-          log2("");
-          log2(`  ${c2.dim("Last server output:")}`);
-          for (const line of stderrLines.slice(-10)) {
-            log2(`  ${c2.dim(line)}`);
-          }
-        }
-        log2("");
-        process.exit(code ?? 1);
-      });
-      const ready = await waitForApi(config.api.host, config.api.port, 2e4);
-      if (!ready) {
-        serverSpinner.fail("Server did not start in time");
-        cleanupChild();
-        process.exit(1);
+      execSync("bun --version", { stdio: "ignore", timeout: 5e3 });
+      pm = "bun";
+    } catch {
+    }
+  }
+  let isGlobal = false;
+  try {
+    const list = execSync(`npm list -g agenticmail 2>/dev/null`, { encoding: "utf-8", timeout: 1e4 });
+    if (list.includes("agenticmail@")) isGlobal = true;
+  } catch {
+  }
+  const scope = isGlobal ? "-g" : "";
+  const installCmd = pm === "bun" ? `bun add ${scope} agenticmail@latest`.trim() : `${pm} install ${scope} agenticmail@latest`.trim();
+  info2(`Running: ${c2.dim(installCmd)}`);
+  try {
+    execSync(installCmd, { stdio: "inherit", timeout: 12e4 });
+    ok2(`Updated to agenticmail@${latestVersion}`);
+  } catch (err) {
+    fail2(`Update failed: ${err.message}`);
+    info2(`Try: ${c2.green("npm install -g agenticmail@latest")}`);
+    process.exit(1);
+  }
+  if (hasOpenClaw) {
+    const pluginCmd = pm === "bun" ? `bun add ${scope} @agenticmail/openclaw@latest`.trim() : `${pm} install ${scope} @agenticmail/openclaw@latest`.trim();
+    info2(`Updating OpenClaw plugin: ${c2.dim(pluginCmd)}`);
+    try {
+      execSync(pluginCmd, { stdio: "inherit", timeout: 12e4 });
+      ok2("OpenClaw plugin updated.");
+      try {
+        execSync("openclaw gateway restart", { stdio: "pipe", timeout: 3e4 });
+        ok2("OpenClaw gateway restarted.");
+      } catch {
+        info2(`Restart OpenClaw: ${c2.green("openclaw gateway restart")}`);
       }
-      serverSpinner.succeed(`Server running at ${c2.cyan(`http://${config.api.host}:${config.api.port}`)}`);
-    } catch (err) {
-      serverSpinner.fail(`Couldn't start the server: ${err.message}`);
-      process.exit(1);
+    } catch {
+      info2(`Update plugin manually: ${c2.green(pluginCmd)}`);
     }
   }
-  await interactiveShell({ config, onExit: cleanupChild });
+  log2("");
+  ok2("Update complete!");
+  log2("");
 }
 var command = process.argv[2];
 switch (command) {
@@ -5602,6 +6340,14 @@ switch (command) {
       process.exit(1);
     });
     break;
+  case "stop":
+    cmdStop().then(() => {
+      process.exit(0);
+    }).catch((err) => {
+      console.error(err);
+      process.exit(1);
+    });
+    break;
   case "status":
     cmdStatus().then(() => {
       process.exit(0);
@@ -5616,6 +6362,12 @@ switch (command) {
       process.exit(1);
     });
     break;
+  case "update":
+    cmdUpdate().catch((err) => {
+      console.error(err);
+      process.exit(1);
+    });
+    break;
   case "help":
   case "--help":
   case "-h":
@@ -5626,8 +6378,10 @@ switch (command) {
     log2(`    ${c2.green("agenticmail")}           Get started (setup + start)`);
     log2(`    ${c2.green("agenticmail setup")}     Re-run the setup wizard`);
     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`);
     log2(`    ${c2.green("agenticmail openclaw")}  Set up AgenticMail for OpenClaw`);
+    log2(`    ${c2.green("agenticmail update")}    Update to the latest version`);
     log2("");
     process.exit(0);
   default:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agenticmail",
-  "version": "0.3.24",
+  "version": "0.4.0",
   "description": "Email infrastructure for AI agents — send and receive real email programmatically",
   "type": "module",
   "main": "dist/index.js",