@agenticmail/core 0.5.59 → 0.6.0

package/dist/index.cjs

@@ -3653,6 +3653,40 @@ var import_nodemailer2 = __toESM(require("nodemailer"), 1);
 var import_mail_composer2 = __toESM(require("nodemailer/lib/mail-composer/index.js"), 1);
 var import_imapflow3 = require("imapflow");
 var import_mailparser2 = require("mailparser");
+function formatPollError(err) {
+  if (!err) return "unknown error (no error object)";
+  if (typeof err !== "object") return String(err);
+  const e = err;
+  const parts = [];
+  const head = (e.message ?? String(err)).toString().trim();
+  if (head) parts.push(head);
+  if (e.code && e.code !== head) parts.push(`code=${e.code}`);
+  if (typeof e.errno === "number") parts.push(`errno=${e.errno}`);
+  if (e.syscall) parts.push(`syscall=${e.syscall}`);
+  if (e.hostname) parts.push(`host=${e.hostname}`);
+  if (typeof e.port === "number") parts.push(`port=${e.port}`);
+  if (e.responseText && e.responseText !== head) {
+    parts.push(`response=${truncate(String(e.responseText), 240)}`);
+  } else if (e.response && e.response !== head) {
+    parts.push(`response=${truncate(String(e.response), 240)}`);
+  }
+  if (e.command) parts.push(`command=${e.command}`);
+  if (typeof e.exitCode === "number") parts.push(`exit=${e.exitCode}`);
+  else if (e.code && /^\d+$/.test(String(e.code))) parts.push(`exit=${e.code}`);
+  if (e.signal) parts.push(`signal=${e.signal}`);
+  const stderr = (e.stderr ?? "").toString().trim();
+  if (stderr) parts.push(`stderr=${truncate(stderr, 240)}`);
+  const stdout = (e.stdout ?? "").toString().trim();
+  if (stdout && !stderr) parts.push(`stdout=${truncate(stdout, 240)}`);
+  if (parts.length === 1 && /^command failed$/i.test(head)) {
+    return `${head} (no further detail available \u2014 wrapping error did not carry stderr/code/response)`;
+  }
+  return parts.join(" | ");
+}
+function truncate(s, max) {
+  if (s.length <= max) return s;
+  return s.slice(0, max - 1).trimEnd() + "\u2026";
+}
 var RelayGateway = class {
   smtpTransport = null;
   pollTimer = null;
@@ -3827,7 +3861,7 @@ var RelayGateway = class {
       this.consecutiveFailures = 0;
     } catch (err) {
       this.consecutiveFailures++;
-      const msg = err instanceof Error ? err.message : String(err);
+      const msg = formatPollError(err);
       console.error(`[RelayGateway] Poll failed (attempt ${this.consecutiveFailures}): ${msg}`);
       if (this.consecutiveFailures >= 5 && this.consecutiveFailures % 5 === 0) {
         console.error(`[RelayGateway] ${this.consecutiveFailures} consecutive failures \u2014 check IMAP credentials and connectivity (${this.config?.imapHost}:${this.config?.imapPort})`);
@@ -6085,20 +6119,23 @@ var GatewayManager = class {
   }
   /**
    * Resume gateway from saved config (e.g., after server restart).
+   *
+   * Issue #31 — On a Docker container restart the API can come up
+   * before Stalwart / Gmail IMAP / DNS is reachable, so the very first
+   * setup() can fail with a transient network error. Previously that
+   * single failure was logged and never retried, leaving polling
+   * permanently dead until someone noticed and manually revived the
+   * relay. We now schedule background retries with exponential backoff
+   * (5s, 10s, 20s, 40s, 60s cap, indefinite) so the relay
+   * self-recovers as soon as the dependency is reachable again.
    */
   async resume() {
     if (this.config.mode === "relay" && this.config.relay) {
       try {
-        await this.relay.setup(this.config.relay);
-        const savedUid = this.loadLastSeenUid();
-        if (savedUid > 0) {
-          this.relay.setLastSeenUid(savedUid);
-          console.log(`[GatewayManager] Restored lastSeenUid=${savedUid} from database`);
-        }
-        this.relay.onUidAdvance = (uid) => this.saveLastSeenUid(uid);
-        await this.relay.startPolling();
+        await this._resumeRelayOnce();
       } catch (err) {
-        console.error("[GatewayManager] Failed to resume relay:", err);
+        console.error("[GatewayManager] Initial relay resume failed; scheduling retries:", formatPollError(err));
+        this._scheduleRelayResumeRetry();
       }
     }
     if (this.smsManager && this.accountManager) {
@@ -6125,6 +6162,42 @@ var GatewayManager = class {
       }
     }
   }
+  // ─── Issue #31 helpers — resume retry with backoff ───
+  _resumeRetryTimer = null;
+  _resumeRetryAttempt = 0;
+  async _resumeRelayOnce() {
+    if (!this.config.relay) throw new Error("No relay config to resume");
+    await this.relay.setup(this.config.relay);
+    const savedUid = this.loadLastSeenUid();
+    if (savedUid > 0) {
+      this.relay.setLastSeenUid(savedUid);
+      console.log(`[GatewayManager] Restored lastSeenUid=${savedUid} from database`);
+    }
+    this.relay.onUidAdvance = (uid) => this.saveLastSeenUid(uid);
+    await this.relay.startPolling();
+    if (this._resumeRetryAttempt > 0) {
+      console.log(`[GatewayManager] Relay polling resumed after ${this._resumeRetryAttempt} retry attempt${this._resumeRetryAttempt !== 1 ? "s" : ""}`);
+    }
+    this._resumeRetryAttempt = 0;
+  }
+  _scheduleRelayResumeRetry() {
+    if (this._resumeRetryTimer) return;
+    this._resumeRetryAttempt++;
+    const base = Math.min(5e3 * Math.pow(2, this._resumeRetryAttempt - 1), 6e4);
+    const jitter = base * (0.8 + Math.random() * 0.4);
+    const delay = Math.round(jitter);
+    console.log(`[GatewayManager] Will retry relay resume in ${(delay / 1e3).toFixed(1)}s (attempt ${this._resumeRetryAttempt + 1})`);
+    this._resumeRetryTimer = setTimeout(async () => {
+      this._resumeRetryTimer = null;
+      if (this.config.mode !== "relay" || !this.config.relay) return;
+      try {
+        await this._resumeRelayOnce();
+      } catch (err) {
+        console.error(`[GatewayManager] Relay resume retry ${this._resumeRetryAttempt} failed:`, formatPollError(err));
+        this._scheduleRelayResumeRetry();
+      }
+    }, delay);
+  }
   // --- Persistence ---
   loadConfig() {
     const row = this.db.prepare("SELECT * FROM gateway_config WHERE id = ?").get("default");

package/dist/index.d.cts

@@ -1244,8 +1244,21 @@ declare class GatewayManager {
     shutdown(): Promise<void>;
     /**
      * Resume gateway from saved config (e.g., after server restart).
+     *
+     * Issue #31 — On a Docker container restart the API can come up
+     * before Stalwart / Gmail IMAP / DNS is reachable, so the very first
+     * setup() can fail with a transient network error. Previously that
+     * single failure was logged and never retried, leaving polling
+     * permanently dead until someone noticed and manually revived the
+     * relay. We now schedule background retries with exponential backoff
+     * (5s, 10s, 20s, 40s, 60s cap, indefinite) so the relay
+     * self-recovers as soon as the dependency is reachable again.
      */
     resume(): Promise<void>;
+    private _resumeRetryTimer;
+    private _resumeRetryAttempt;
+    private _resumeRelayOnce;
+    private _scheduleRelayResumeRetry;
     private loadConfig;
     private saveConfig;
     private saveLastSeenUid;

package/dist/index.d.ts

@@ -1244,8 +1244,21 @@ declare class GatewayManager {
     shutdown(): Promise<void>;
     /**
      * Resume gateway from saved config (e.g., after server restart).
+     *
+     * Issue #31 — On a Docker container restart the API can come up
+     * before Stalwart / Gmail IMAP / DNS is reachable, so the very first
+     * setup() can fail with a transient network error. Previously that
+     * single failure was logged and never retried, leaving polling
+     * permanently dead until someone noticed and manually revived the
+     * relay. We now schedule background retries with exponential backoff
+     * (5s, 10s, 20s, 40s, 60s cap, indefinite) so the relay
+     * self-recovers as soon as the dependency is reachable again.
      */
     resume(): Promise<void>;
+    private _resumeRetryTimer;
+    private _resumeRetryAttempt;
+    private _resumeRelayOnce;
+    private _scheduleRelayResumeRetry;
     private loadConfig;
     private saveConfig;
     private saveLastSeenUid;

package/dist/index.js

@@ -2896,6 +2896,40 @@ import nodemailer2 from "nodemailer";
 import MailComposer2 from "nodemailer/lib/mail-composer/index.js";
 import { ImapFlow as ImapFlow3 } from "imapflow";
 import { simpleParser as simpleParser2 } from "mailparser";
+function formatPollError(err) {
+  if (!err) return "unknown error (no error object)";
+  if (typeof err !== "object") return String(err);
+  const e = err;
+  const parts = [];
+  const head = (e.message ?? String(err)).toString().trim();
+  if (head) parts.push(head);
+  if (e.code && e.code !== head) parts.push(`code=${e.code}`);
+  if (typeof e.errno === "number") parts.push(`errno=${e.errno}`);
+  if (e.syscall) parts.push(`syscall=${e.syscall}`);
+  if (e.hostname) parts.push(`host=${e.hostname}`);
+  if (typeof e.port === "number") parts.push(`port=${e.port}`);
+  if (e.responseText && e.responseText !== head) {
+    parts.push(`response=${truncate(String(e.responseText), 240)}`);
+  } else if (e.response && e.response !== head) {
+    parts.push(`response=${truncate(String(e.response), 240)}`);
+  }
+  if (e.command) parts.push(`command=${e.command}`);
+  if (typeof e.exitCode === "number") parts.push(`exit=${e.exitCode}`);
+  else if (e.code && /^\d+$/.test(String(e.code))) parts.push(`exit=${e.code}`);
+  if (e.signal) parts.push(`signal=${e.signal}`);
+  const stderr = (e.stderr ?? "").toString().trim();
+  if (stderr) parts.push(`stderr=${truncate(stderr, 240)}`);
+  const stdout = (e.stdout ?? "").toString().trim();
+  if (stdout && !stderr) parts.push(`stdout=${truncate(stdout, 240)}`);
+  if (parts.length === 1 && /^command failed$/i.test(head)) {
+    return `${head} (no further detail available \u2014 wrapping error did not carry stderr/code/response)`;
+  }
+  return parts.join(" | ");
+}
+function truncate(s, max) {
+  if (s.length <= max) return s;
+  return s.slice(0, max - 1).trimEnd() + "\u2026";
+}
 var RelayGateway = class {
   smtpTransport = null;
   pollTimer = null;
@@ -3070,7 +3104,7 @@ var RelayGateway = class {
       this.consecutiveFailures = 0;
     } catch (err) {
       this.consecutiveFailures++;
-      const msg = err instanceof Error ? err.message : String(err);
+      const msg = formatPollError(err);
       console.error(`[RelayGateway] Poll failed (attempt ${this.consecutiveFailures}): ${msg}`);
       if (this.consecutiveFailures >= 5 && this.consecutiveFailures % 5 === 0) {
         console.error(`[RelayGateway] ${this.consecutiveFailures} consecutive failures \u2014 check IMAP credentials and connectivity (${this.config?.imapHost}:${this.config?.imapPort})`);
@@ -5327,20 +5361,23 @@ var GatewayManager = class {
   }
   /**
    * Resume gateway from saved config (e.g., after server restart).
+   *
+   * Issue #31 — On a Docker container restart the API can come up
+   * before Stalwart / Gmail IMAP / DNS is reachable, so the very first
+   * setup() can fail with a transient network error. Previously that
+   * single failure was logged and never retried, leaving polling
+   * permanently dead until someone noticed and manually revived the
+   * relay. We now schedule background retries with exponential backoff
+   * (5s, 10s, 20s, 40s, 60s cap, indefinite) so the relay
+   * self-recovers as soon as the dependency is reachable again.
    */
   async resume() {
     if (this.config.mode === "relay" && this.config.relay) {
       try {
-        await this.relay.setup(this.config.relay);
-        const savedUid = this.loadLastSeenUid();
-        if (savedUid > 0) {
-          this.relay.setLastSeenUid(savedUid);
-          console.log(`[GatewayManager] Restored lastSeenUid=${savedUid} from database`);
-        }
-        this.relay.onUidAdvance = (uid) => this.saveLastSeenUid(uid);
-        await this.relay.startPolling();
+        await this._resumeRelayOnce();
       } catch (err) {
-        console.error("[GatewayManager] Failed to resume relay:", err);
+        console.error("[GatewayManager] Initial relay resume failed; scheduling retries:", formatPollError(err));
+        this._scheduleRelayResumeRetry();
       }
     }
     if (this.smsManager && this.accountManager) {
@@ -5367,6 +5404,42 @@ var GatewayManager = class {
       }
     }
   }
+  // ─── Issue #31 helpers — resume retry with backoff ───
+  _resumeRetryTimer = null;
+  _resumeRetryAttempt = 0;
+  async _resumeRelayOnce() {
+    if (!this.config.relay) throw new Error("No relay config to resume");
+    await this.relay.setup(this.config.relay);
+    const savedUid = this.loadLastSeenUid();
+    if (savedUid > 0) {
+      this.relay.setLastSeenUid(savedUid);
+      console.log(`[GatewayManager] Restored lastSeenUid=${savedUid} from database`);
+    }
+    this.relay.onUidAdvance = (uid) => this.saveLastSeenUid(uid);
+    await this.relay.startPolling();
+    if (this._resumeRetryAttempt > 0) {
+      console.log(`[GatewayManager] Relay polling resumed after ${this._resumeRetryAttempt} retry attempt${this._resumeRetryAttempt !== 1 ? "s" : ""}`);
+    }
+    this._resumeRetryAttempt = 0;
+  }
+  _scheduleRelayResumeRetry() {
+    if (this._resumeRetryTimer) return;
+    this._resumeRetryAttempt++;
+    const base = Math.min(5e3 * Math.pow(2, this._resumeRetryAttempt - 1), 6e4);
+    const jitter = base * (0.8 + Math.random() * 0.4);
+    const delay = Math.round(jitter);
+    console.log(`[GatewayManager] Will retry relay resume in ${(delay / 1e3).toFixed(1)}s (attempt ${this._resumeRetryAttempt + 1})`);
+    this._resumeRetryTimer = setTimeout(async () => {
+      this._resumeRetryTimer = null;
+      if (this.config.mode !== "relay" || !this.config.relay) return;
+      try {
+        await this._resumeRelayOnce();
+      } catch (err) {
+        console.error(`[GatewayManager] Relay resume retry ${this._resumeRetryAttempt} failed:`, formatPollError(err));
+        this._scheduleRelayResumeRetry();
+      }
+    }, delay);
+  }
   // --- Persistence ---
   loadConfig() {
     const row = this.db.prepare("SELECT * FROM gateway_config WHERE id = ?").get("default");

package/package.json

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