@agenticmail/core 0.5.10 → 0.5.13

package/dist/index.d.ts

@@ -1440,19 +1440,16 @@ declare class DependencyInstaller {
      */
     private findDockerApp;
     /**
-     * Pre-accept the Docker Desktop license agreement by writing the settings
-     * file that Docker checks on startup. This prevents the license dialog from
-     * appearing and blocking automated setup.
-     *
-     * Docker Desktop checks /Library/Application Support/com.docker.docker/install-settings.json
-     * (system-level, requires sudo) for {"acceptLicense": true}. The --accept-license
-     * flag on the installer binary tries to write this but fails without sudo.
-     *
-     * We try multiple approaches:
-     * 1. Write to the system-level path (may fail without sudo — that's OK)
-     * 2. Write to the user-level Docker settings (Group Containers)
+     * Check if Docker Desktop license has already been accepted.
+     * Returns true if we're confident the user has accepted before.
+     */
+    private isDockerLicenseAccepted;
+    /**
+     * Configure Docker Desktop to run headless after first-time setup.
+     * Call this AFTER Docker has been started and license accepted.
+     * Suppresses UI, dock icon, tips, analytics, and auto-updates.
      */
-    private preAcceptDockerLicense;
+    private configureDockerHeadless;
     /**
      * Docker.app exists but CLI isn't available or daemon isn't running.
      * Runs the built-in installer silently (--accept-license to link CLI tools),
@@ -1460,8 +1457,8 @@ declare class DependencyInstaller {
      */
     private setupExistingDockerApp;
     /**
-     * Hide the Docker Desktop window using AppleScript.
-     * Called after starting Docker to suppress the welcome/dashboard GUI.
+     * Hide Docker Desktop completely — close all windows, hide from dock, make invisible.
+     * Called after starting Docker to ensure the user never sees any Docker UI.
      */
     private hideDockerWindow;
     /**

package/dist/index.js

@@ -6086,7 +6086,7 @@ var DependencyInstaller = class {
     }
     const dockerApp = this.findDockerApp();
     if (dockerApp) {
-      this.onProgress("__progress__:10:Docker Desktop found \u2014 setting it up...");
+      this.onProgress("__progress__:10:Setting up mail server engine...");
       await this.setupExistingDockerApp(dockerApp);
       return;
     }
@@ -6150,52 +6150,67 @@ var DependencyInstaller = class {
     return null;
   }
   /**
-   * Pre-accept the Docker Desktop license agreement by writing the settings
-   * file that Docker checks on startup. This prevents the license dialog from
-   * appearing and blocking automated setup.
-   *
-   * Docker Desktop checks /Library/Application Support/com.docker.docker/install-settings.json
-   * (system-level, requires sudo) for {"acceptLicense": true}. The --accept-license
-   * flag on the installer binary tries to write this but fails without sudo.
-   *
-   * We try multiple approaches:
-   * 1. Write to the system-level path (may fail without sudo — that's OK)
-   * 2. Write to the user-level Docker settings (Group Containers)
+   * Check if Docker Desktop license has already been accepted.
+   * Returns true if we're confident the user has accepted before.
    */
-  preAcceptDockerLicense() {
-    const systemDir = "/Library/Application Support/com.docker.docker";
-    const systemFile = join6(systemDir, "install-settings.json");
-    const licenseJson = JSON.stringify({ acceptLicense: true });
+  isDockerLicenseAccepted() {
     try {
-      if (!existsSync4(systemDir)) {
-        execSync(`mkdir -p "${systemDir}"`, { timeout: 5e3, stdio: "ignore" });
+      const systemFile = "/Library/Application Support/com.docker.docker/install-settings.json";
+      if (existsSync4(systemFile)) {
+        const raw = readFileSync2(systemFile, "utf-8");
+        const data = JSON.parse(raw);
+        if (data.acceptLicense) return true;
       }
-      writeFileSync3(systemFile, licenseJson, { mode: 420 });
     } catch {
-      try {
-        execSync(`sudo -n mkdir -p "${systemDir}" 2>/dev/null && sudo -n tee "${systemFile}" > /dev/null 2>&1`, {
-          timeout: 5e3,
-          input: licenseJson,
-          stdio: ["pipe", "ignore", "ignore"]
-        });
-      } catch {
+    }
+    try {
+      const settingsFile = join6(process.env.HOME || "", "Library/Group Containers/group.com.docker/settings-store.json");
+      if (existsSync4(settingsFile)) {
+        return true;
       }
+    } catch {
     }
+    return false;
+  }
+  /**
+   * Configure Docker Desktop to run headless after first-time setup.
+   * Call this AFTER Docker has been started and license accepted.
+   * Suppresses UI, dock icon, tips, analytics, and auto-updates.
+   */
+  configureDockerHeadless() {
     try {
       const userDockerDir = join6(process.env.HOME || "", "Library/Group Containers/group.com.docker");
       const settingsFile = join6(userDockerDir, "settings-store.json");
+      const headlessDefaults = {
+        AutoStart: false,
+        // Don't auto-start on login (we start it ourselves)
+        OpenUIOnStartupDisabled: true,
+        // Don't show dashboard on start
+        TipShown: true,
+        // Don't show tips/welcome
+        SUAutomaticallyUpdate: false,
+        // Don't nag about updates
+        AnalyticsEnabled: false
+        // No analytics prompts
+      };
       if (existsSync4(settingsFile)) {
         const raw = readFileSync2(settingsFile, "utf-8");
         try {
           const settings = JSON.parse(raw);
-          if (!settings.AcceptedLicense) {
-            settings.AcceptedLicense = true;
+          let changed = false;
+          for (const [key, val] of Object.entries(headlessDefaults)) {
+            if (settings[key] !== val) {
+              settings[key] = val;
+              changed = true;
+            }
+          }
+          if (changed) {
             writeFileSync3(settingsFile, JSON.stringify(settings, null, 2));
           }
         } catch {
         }
       } else if (existsSync4(userDockerDir)) {
-        writeFileSync3(settingsFile, JSON.stringify({ AcceptedLicense: true }, null, 2));
+        writeFileSync3(settingsFile, JSON.stringify(headlessDefaults, null, 2));
       }
     } catch {
     }
@@ -6207,9 +6222,9 @@ var DependencyInstaller = class {
    */
   async setupExistingDockerApp(appPath) {
     const installBin = join6(appPath, "Contents", "MacOS", "install");
-    this.preAcceptDockerLicense();
+    const isFirstLaunch = !this.isDockerLicenseAccepted();
     if (existsSync4(installBin)) {
-      this.onProgress("__progress__:30:Setting up Docker CLI tools...");
+      this.onProgress("__progress__:30:Setting up CLI tools...");
       const user = process.env.USER || execSync("whoami", { timeout: 5e3 }).toString().trim();
       try {
         execSync(`"${installBin}" --accept-license --user=${user}`, {
@@ -6219,14 +6234,25 @@ var DependencyInstaller = class {
       } catch {
       }
     }
-    this.onProgress("__progress__:50:Starting Docker engine...");
-    this.startDockerDaemon();
-    this.hideDockerWindow();
-    await this.waitForDocker();
+    if (isFirstLaunch) {
+      this.onProgress("__progress__:50:Opening Docker \u2014 please accept the license agreement...");
+      try {
+        execFileSync2("open", ["-a", appPath], { timeout: 1e4, stdio: "ignore" });
+      } catch {
+      }
+      await this.waitForDocker();
+      this.configureDockerHeadless();
+      this.hideDockerWindow();
+    } else {
+      this.onProgress("__progress__:50:Starting engine...");
+      this.startDockerDaemon();
+      this.hideDockerWindow();
+      await this.waitForDocker();
+    }
   }
   /**
-   * Hide the Docker Desktop window using AppleScript.
-   * Called after starting Docker to suppress the welcome/dashboard GUI.
+   * Hide Docker Desktop completely — close all windows, hide from dock, make invisible.
+   * Called after starting Docker to ensure the user never sees any Docker UI.
    */
   hideDockerWindow() {
     try {
@@ -6250,6 +6276,25 @@ var DependencyInstaller = class {
       );
     } catch {
     }
+    const dockerApp = this.findDockerApp();
+    if (dockerApp) {
+      const plistPath = join6(dockerApp, "Contents", "Info.plist");
+      try {
+        const plistContent = readFileSync2(plistPath, "utf-8");
+        if (!plistContent.includes("LSUIElement")) {
+          execSync(
+            `/usr/libexec/PlistBuddy -c "Add :LSUIElement bool true" "${plistPath}" 2>/dev/null`,
+            { timeout: 5e3, stdio: "ignore" }
+          );
+        } else if (!plistContent.includes("<key>LSUIElement</key>\n	<true/>") && !plistContent.includes("<key>LSUIElement</key><true/>")) {
+          execSync(
+            `/usr/libexec/PlistBuddy -c "Set :LSUIElement true" "${plistPath}" 2>/dev/null`,
+            { timeout: 5e3, stdio: "ignore" }
+          );
+        }
+      } catch {
+      }
+    }
   }
   /**
    * Full Docker Desktop install on macOS.
@@ -6258,7 +6303,7 @@ var DependencyInstaller = class {
    */
   async installDockerMac() {
     if (hasHomebrew()) {
-      this.onProgress("__progress__:5:Installing Docker Desktop...");
+      this.onProgress("__progress__:5:Installing mail server engine...");
       try {
         const brewResult = await runSilent(
           "brew",
@@ -6266,7 +6311,7 @@ var DependencyInstaller = class {
           { timeout: 6e5 }
         );
         if (brewResult.exitCode === 0) {
-          this.onProgress("__progress__:45:Docker Desktop installed!");
+          this.onProgress("__progress__:45:Mail server engine installed!");
           const appPath = this.findDockerApp();
           if (appPath) {
             await this.setupExistingDockerApp(appPath);
@@ -6281,7 +6326,7 @@ var DependencyInstaller = class {
     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...");
+    this.onProgress("__progress__:5:Downloading mail server engine...");
     const dlResult = await runSilent("curl", [
       "-fSL",
       "-o",
@@ -6291,7 +6336,7 @@ var DependencyInstaller = class {
     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...");
+    this.onProgress("__progress__:40:Installing mail server engine...");
     try {
       try {
         execSync("hdiutil detach /Volumes/Docker 2>/dev/null", { timeout: 1e4, stdio: "ignore" });
@@ -6301,8 +6346,7 @@ var DependencyInstaller = class {
     } catch {
       throw new Error("Failed to mount Docker DMG. The download may be corrupted \u2014 try again.");
     }
-    this.preAcceptDockerLicense();
-    this.onProgress("__progress__:55:Running Docker installer...");
+    this.onProgress("__progress__:55:Running installer...");
     const user = process.env.USER || execSync("whoami", { timeout: 5e3 }).toString().trim();
     try {
       execSync(`/Volumes/Docker/Docker.app/Contents/MacOS/install --accept-license --user=${user}`, {
@@ -6315,7 +6359,7 @@ var DependencyInstaller = class {
         try {
           execSync('cp -R "/Volumes/Docker/Docker.app" /Applications/', { timeout: 6e4, stdio: "ignore" });
         } catch {
-          throw new Error("Failed to install Docker Desktop. You may need to run this with admin privileges.");
+          throw new Error("Failed to install. You may need to run this with admin privileges.");
         }
       }
     }
@@ -6327,10 +6371,14 @@ var DependencyInstaller = class {
       await unlink(dmgPath);
     } catch {
     }
-    this.onProgress("__progress__:70:Starting Docker engine...");
-    this.startDockerDaemon();
-    this.hideDockerWindow();
+    this.onProgress("__progress__:70:Opening Docker \u2014 please accept the license agreement...");
+    try {
+      execFileSync2("open", ["-a", "/Applications/Docker.app"], { timeout: 1e4, stdio: "ignore" });
+    } catch {
+    }
     await this.waitForDocker();
+    this.configureDockerHeadless();
+    this.hideDockerWindow();
   }
   /**
    * Install Docker Engine on Linux using Docker's official convenience script.
@@ -6496,10 +6544,10 @@ var DependencyInstaller = class {
         strategyIdx++;
         const strategy = strategies[strategyIdx];
         const msgs = {
-          cli: "Trying Docker CLI...",
-          reopen: "Restarting Docker Desktop...",
+          cli: "Checking engine...",
+          reopen: "Restarting engine...",
           background: "Trying direct launch...",
-          install: "Re-running Docker installer...",
+          install: "Re-running installer...",
           service: "Trying service command...",
           snap: "Trying snap..."
         };
@@ -6507,9 +6555,9 @@ var DependencyInstaller = class {
         this.startDockerDaemon(strategy);
       } else {
         const msgs = [
-          "Starting Docker...",
-          "Waiting for Docker engine...",
-          "Docker is loading...",
+          "Starting engine...",
+          "Waiting for engine...",
+          "Loading...",
           "Almost there...",
           "Still starting up...",
           "First launch takes a bit longer...",
@@ -6518,11 +6566,11 @@ var DependencyInstaller = class {
         const msgIdx = Math.floor(elapsed / 1e4) % msgs.length;
         this.onProgress(`__progress__:${pct}:${msgs[msgIdx]}`);
       }
-      if (os === "darwin") this.hideDockerWindow();
+      if (os === "darwin" && this.isDockerLicenseAccepted()) this.hideDockerWindow();
       await new Promise((r) => setTimeout(r, 3e3));
     }
     throw new Error(
-      "Docker could not be started after trying all available methods. This usually means Docker Desktop needs a one-time manual launch to complete its setup. Open Docker from your Applications folder, then run this command again."
+      "Engine could not be started after trying all available methods. If this is your first time, open Docker from your Applications folder, accept the license agreement, then run this command again."
     );
   }
   /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agenticmail/core",
-  "version": "0.5.10",
+  "version": "0.5.13",
   "description": "Core SDK for AgenticMail \u2014 email, SMS, and phone number access for AI agents",
   "type": "module",
   "main": "dist/index.js",