@agenticmail/core 0.5.2 → 0.5.3

package/README.md

@@ -1,6 +1,6 @@
 # @agenticmail/core
 
-Core SDK for [AgenticMail](https://github.com/agenticmail/agenticmail) — email infrastructure for AI agents.
+Core SDK for [AgenticMail](https://github.com/agenticmail/agenticmail) — the first platform to give AI agents real email addresses and phone numbers.
 
 This is the foundation layer that everything else builds on. If the API server, MCP server, OpenClaw plugin, and CLI are the ways people interact with AgenticMail, this package is what actually does the work underneath. It handles creating and managing AI agent accounts, sending and receiving real email, watching inboxes for new messages in real time, routing email to and from the internet (through Gmail relay or a custom domain with Cloudflare), filtering spam, scanning outgoing emails to prevent agents from leaking sensitive data, and storing everything in a local SQLite database.
 

package/dist/index.d.ts

@@ -1419,10 +1419,22 @@ declare class DependencyInstaller {
     constructor(onProgress?: InstallProgress);
     /**
      * Ensure Docker is installed AND the daemon is running.
-     * Installs Docker if not present (Homebrew on macOS, apt on Linux).
+     * macOS: Downloads official DMG and runs Docker's CLI installer (no Homebrew needed).
+     * Linux: Uses Docker's official convenience script (https://get.docker.com).
      * Starts the daemon if Docker CLI is present but daemon is stopped.
      */
     installDocker(): Promise<void>;
+    /**
+     * Install Docker Desktop on macOS using the official DMG installer.
+     * Downloads the DMG, mounts it, runs the silent CLI installer, then starts Docker Desktop.
+     * This is Docker's recommended command-line installation method.
+     */
+    private installDockerMac;
+    /**
+     * Install Docker Engine on Linux using Docker's official convenience script.
+     * Also adds the current user to the docker group for rootless usage.
+     */
+    private installDockerLinux;
     /**
      * Attempt to start the Docker daemon using multiple strategies.
      * On macOS: tries Docker Desktop app, then docker CLI commands.

package/dist/index.js

@@ -5903,7 +5903,7 @@ function runWithRollingOutput(command, args, opts = {}) {
   const timeout = opts.timeout ?? 3e5;
   return new Promise((resolve, reject) => {
     const child = spawnChild(command, args, {
-      stdio: ["ignore", "pipe", "pipe"],
+      stdio: [opts.inheritStdin ? "inherit" : "ignore", "pipe", "pipe"],
       timeout
     });
     const lines = [];
@@ -6024,7 +6024,8 @@ var DependencyInstaller = class {
   }
   /**
    * Ensure Docker is installed AND the daemon is running.
-   * Installs Docker if not present (Homebrew on macOS, apt on Linux).
+   * macOS: Downloads official DMG and runs Docker's CLI installer (no Homebrew needed).
+   * Linux: Uses Docker's official convenience script (https://get.docker.com).
    * Starts the daemon if Docker CLI is present but daemon is stopped.
    */
   async installDocker() {
@@ -6047,33 +6048,116 @@ var DependencyInstaller = class {
     }
     const os = platform2();
     if (os === "darwin") {
-      this.onProgress("Installing Docker via Homebrew...");
+      await this.installDockerMac();
+    } else if (os === "linux") {
+      await this.installDockerLinux();
+    } else {
+      throw new Error(`Automatic Docker installation not supported on ${os}. Install it manually: https://docs.docker.com/get-docker/`);
+    }
+  }
+  /**
+   * Install Docker Desktop on macOS using the official DMG installer.
+   * Downloads the DMG, mounts it, runs the silent CLI installer, then starts Docker Desktop.
+   * This is Docker's recommended command-line installation method.
+   */
+  async installDockerMac() {
+    const cpu = arch2();
+    const archName = cpu === "arm64" ? "arm64" : "amd64";
+    const dmgUrl = `https://desktop.docker.com/mac/main/${archName}/Docker.dmg`;
+    const dmgPath = "/tmp/Docker.dmg";
+    this.onProgress("__progress__:5:Downloading Docker Desktop...");
+    const dlResult = await runWithRollingOutput("curl", [
+      "-fSL",
+      "--progress-bar",
+      "-o",
+      dmgPath,
+      dmgUrl
+    ], { timeout: 6e5 });
+    if (dlResult.exitCode !== 0) {
+      throw new Error("Failed to download Docker Desktop. Check your internet connection and try again.");
+    }
+    this.onProgress("__progress__:40:Installing Docker Desktop...");
+    try {
       try {
-        execFileSync2("brew", ["--version"], { timeout: 5e3, stdio: "ignore" });
+        execSync("hdiutil detach /Volumes/Docker 2>/dev/null", { timeout: 1e4, stdio: "ignore" });
       } catch {
-        throw new Error("Homebrew is required to install Docker on macOS. Install it from https://brew.sh then try again.");
       }
-      const brewResult = await runWithRollingOutput("brew", ["install", "--cask", "docker"], { timeout: 3e5 });
-      if (brewResult.exitCode !== 0) {
-        throw new Error("Failed to install Docker via Homebrew. Try: brew install --cask docker");
+      execSync(`hdiutil attach "${dmgPath}" -nobrowse -quiet`, { timeout: 3e4, stdio: "ignore" });
+    } catch {
+      throw new Error("Failed to mount Docker DMG. The download may be corrupted \u2014 try again.");
+    }
+    this.onProgress("__progress__:55:Running Docker installer...");
+    const user = process.env.USER || execSync("whoami", { timeout: 5e3 }).toString().trim();
+    try {
+      const installResult = await runWithRollingOutput(
+        "/Volumes/Docker/Docker.app/Contents/MacOS/install",
+        ["--accept-license", `--user=${user}`],
+        { timeout: 12e4 }
+      );
+      if (installResult.exitCode !== 0) {
+        if (!existsSync4("/Applications/Docker.app")) {
+          throw new Error("Installer exited with errors");
+        }
       }
-      this.onProgress("Docker installed. Starting Docker Desktop...");
-      this.startDockerDaemon();
-      await this.waitForDocker();
-    } else if (os === "linux") {
-      this.onProgress("Installing Docker...");
-      try {
-        const result = await runShellWithRollingOutput("curl -fsSL https://get.docker.com | sh", { timeout: 3e5 });
-        if (result.exitCode !== 0) {
-          throw new Error("Install script failed");
+    } catch (err) {
+      if (!existsSync4("/Applications/Docker.app")) {
+        this.onProgress("__progress__:60:Trying alternative install method...");
+        try {
+          execSync('cp -R "/Volumes/Docker/Docker.app" /Applications/', { timeout: 6e4, stdio: "ignore" });
+        } catch {
+          throw new Error("Failed to install Docker Desktop. Try dragging Docker.app to Applications manually.");
         }
+      }
+    }
+    try {
+      execSync("hdiutil detach /Volumes/Docker -quiet", { timeout: 15e3, stdio: "ignore" });
+    } catch {
+    }
+    try {
+      await unlink(dmgPath);
+    } catch {
+    }
+    this.onProgress("__progress__:70:Starting Docker Desktop...");
+    this.startDockerDaemon();
+    await this.waitForDocker();
+  }
+  /**
+   * Install Docker Engine on Linux using Docker's official convenience script.
+   * Also adds the current user to the docker group for rootless usage.
+   */
+  async installDockerLinux() {
+    this.onProgress("__progress__:5:Installing Docker Engine...");
+    const dlResult = await runShellWithRollingOutput(
+      "curl -fsSL https://get.docker.com -o /tmp/install-docker.sh && sudo sh /tmp/install-docker.sh",
+      { timeout: 3e5 }
+    );
+    if (dlResult.exitCode !== 0) {
+      throw new Error(
+        "Failed to install Docker Engine. You may need sudo privileges.\nManual install: https://docs.docker.com/engine/install/"
+      );
+    }
+    const user = process.env.USER || process.env.LOGNAME || "";
+    if (user && user !== "root") {
+      this.onProgress("__progress__:80:Adding user to docker group...");
+      try {
+        execSync(`sudo usermod -aG docker ${user}`, { timeout: 1e4, stdio: "ignore" });
       } catch {
-        throw new Error("Failed to install Docker. Install it manually: https://docs.docker.com/get-docker/");
       }
-      await this.waitForDocker();
-    } else {
-      throw new Error(`Automatic Docker installation not supported on ${os}. Install it manually: https://docs.docker.com/get-docker/`);
     }
+    try {
+      await unlink("/tmp/install-docker.sh");
+    } catch {
+    }
+    this.onProgress("__progress__:85:Starting Docker service...");
+    try {
+      execSync("sudo systemctl enable --now docker", { timeout: 15e3, stdio: "ignore" });
+    } catch {
+      try {
+        execSync("sudo service docker start", { timeout: 15e3, stdio: "ignore" });
+      } catch {
+      }
+    }
+    await this.waitForDocker();
   }
   /**
    * Attempt to start the Docker daemon using multiple strategies.
@@ -6191,9 +6275,7 @@ var DependencyInstaller = class {
       }
       await new Promise((r) => setTimeout(r, 3e3));
     }
-    throw new Error(
-      "DOCKER_MANUAL_START"
-    );
+    throw new Error("DOCKER_MANUAL_START");
   }
   /**
    * Start the Stalwart mail server Docker container.

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@agenticmail/core",
-  "version": "0.5.2",
-  "description": "Core SDK for AgenticMail — programmatic email for AI agents",
+  "version": "0.5.3",
+  "description": "Core SDK for AgenticMail \u2014 email, SMS, and phone number access for AI agents",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -52,6 +52,8 @@
   "bugs": "https://github.com/agenticmail/agenticmail/issues",
   "keywords": [
     "email",
+    "sms",
+    "phone",
     "ai",
     "agent",
     "mail",
@@ -59,7 +61,9 @@
     "imap",
     "agenticmail",
     "ai-agent",
-    "mcp"
+    "mcp",
+    "google-voice",
+    "text-message"
   ],
   "publishConfig": {
     "access": "public"