@rubytech/create-realagent 1.0.614 → 1.0.616

package/payload/platform/plugins/email/mcp/dist/lib/providers.js

@@ -1,99 +1,552 @@
 /**
  * Known email provider defaults.
  * Maps domain → IMAP/SMTP host + port + security.
- * Used by email-setup to auto-infer connection settings.
+ * Used by email-setup to auto-infer connection settings so the agent
+ * does not need to ask the user for technical server details.
+ *
+ * Convention for port + security pairs:
+ *   993 → "tls"        (IMAP implicit TLS)
+ *   143 → "starttls"   (IMAP with STARTTLS upgrade)
+ *   465 → "tls"        (SMTP implicit TLS / legacy SSL)
+ *   587 → "starttls"   (SMTP submission with STARTTLS)
  */
+// ---------- Shared provider definitions ----------
+// Alias domains reference the same object so updates stay in sync.
+const gmail = {
+    imapHost: "imap.gmail.com",
+    imapPort: 993,
+    imapSecurity: "tls",
+    smtpHost: "smtp.gmail.com",
+    smtpPort: 587,
+    smtpSecurity: "starttls",
+    notes: "Requires an app-specific password (Google Account → Security → 2-Step Verification → App passwords). IMAP must be enabled in Gmail settings. Google Workspace custom domains use the same hosts.",
+};
+const outlook = {
+    imapHost: "outlook.office365.com",
+    imapPort: 993,
+    imapSecurity: "tls",
+    smtpHost: "smtp.office365.com",
+    smtpPort: 587,
+    smtpSecurity: "starttls",
+    notes: "Requires an app password if 2FA is enabled (Microsoft Account → Security → App passwords). Microsoft 365 custom domains use the same hosts.",
+};
+const icloud = {
+    imapHost: "imap.mail.me.com",
+    imapPort: 993,
+    imapSecurity: "tls",
+    smtpHost: "smtp.mail.me.com",
+    smtpPort: 587,
+    smtpSecurity: "starttls",
+    notes: "Requires an app-specific password (Apple ID → Sign-In and Security → App-Specific Passwords). iCloud+ custom domains use the same hosts.",
+};
+const yahoo = {
+    imapHost: "imap.mail.yahoo.com",
+    imapPort: 993,
+    imapSecurity: "tls",
+    smtpHost: "smtp.mail.yahoo.com",
+    smtpPort: 587,
+    smtpSecurity: "starttls",
+    notes: "Requires an app password (Yahoo Account → Account Security → Generate app password).",
+};
+const aol = {
+    imapHost: "imap.aol.com",
+    imapPort: 993,
+    imapSecurity: "tls",
+    smtpHost: "smtp.aol.com",
+    smtpPort: 465,
+    smtpSecurity: "tls",
+    notes: "Requires an app password (AOL Account Security → Generate app password). AOL is operated by Yahoo; Verizon.net mail migrated here.",
+};
+const protonBridge = {
+    imapHost: "127.0.0.1",
+    imapPort: 1143,
+    imapSecurity: "starttls",
+    smtpHost: "127.0.0.1",
+    smtpPort: 1025,
+    smtpSecurity: "starttls",
+    notes: "Requires Proton Mail Bridge running locally. Bridge provides IMAP/SMTP on localhost and supplies the bridge-specific password to use here.",
+};
+const gmxCom = {
+    imapHost: "imap.gmx.com",
+    imapPort: 993,
+    imapSecurity: "tls",
+    smtpHost: "mail.gmx.com",
+    smtpPort: 587,
+    smtpSecurity: "starttls",
+    notes: "POP3/IMAP access must be enabled in GMX webmail settings first.",
+};
+const gmxNet = {
+    imapHost: "imap.gmx.net",
+    imapPort: 993,
+    imapSecurity: "tls",
+    smtpHost: "mail.gmx.net",
+    smtpPort: 587,
+    smtpSecurity: "starttls",
+    notes: "German GMX — POP3/IMAP access must be enabled in GMX webmail settings first.",
+};
+const mailCom = {
+    imapHost: "imap.mail.com",
+    imapPort: 993,
+    imapSecurity: "tls",
+    smtpHost: "smtp.mail.com",
+    smtpPort: 587,
+    smtpSecurity: "starttls",
+    notes: "POP3/IMAP access must be enabled in mail.com webmail settings first.",
+};
+const zohoCom = {
+    imapHost: "imap.zoho.com",
+    imapPort: 993,
+    imapSecurity: "tls",
+    smtpHost: "smtp.zoho.com",
+    smtpPort: 465,
+    smtpSecurity: "tls",
+    notes: "Requires an app-specific password when 2FA is enabled (Zoho Account → Security → App Passwords). Zoho Mail free accounts must enable IMAP access in Mail Settings first.",
+};
+const zohoEu = {
+    imapHost: "imap.zoho.eu",
+    imapPort: 993,
+    imapSecurity: "tls",
+    smtpHost: "smtp.zoho.eu",
+    smtpPort: 465,
+    smtpSecurity: "tls",
+    notes: "Zoho EU region. Requires app-specific password with 2FA and IMAP enabled in Mail Settings.",
+};
+const zohoIn = {
+    imapHost: "imap.zoho.in",
+    imapPort: 993,
+    imapSecurity: "tls",
+    smtpHost: "smtp.zoho.in",
+    smtpPort: 465,
+    smtpSecurity: "tls",
+    notes: "Zoho India region. Requires app-specific password with 2FA and IMAP enabled in Mail Settings.",
+};
+const fastmail = {
+    imapHost: "imap.fastmail.com",
+    imapPort: 993,
+    imapSecurity: "tls",
+    smtpHost: "smtp.fastmail.com",
+    smtpPort: 465,
+    smtpSecurity: "tls",
+    notes: "Requires an app-specific password (Fastmail Settings → Privacy & Security → App passwords). Fastmail also hosts many custom-domain mailboxes — use the same hosts.",
+};
+const yandex = {
+    imapHost: "imap.yandex.com",
+    imapPort: 993,
+    imapSecurity: "tls",
+    smtpHost: "smtp.yandex.com",
+    smtpPort: 465,
+    smtpSecurity: "tls",
+    notes: "Requires an app password (Yandex ID → Security → App passwords). IMAP access must be enabled in Yandex Mail settings.",
+};
+const mailRu = {
+    imapHost: "imap.mail.ru",
+    imapPort: 993,
+    imapSecurity: "tls",
+    smtpHost: "smtp.mail.ru",
+    smtpPort: 465,
+    smtpSecurity: "tls",
+    notes: "Requires an app password (Mail.ru Account → Security → External applications).",
+};
+const qq = {
+    imapHost: "imap.qq.com",
+    imapPort: 993,
+    imapSecurity: "tls",
+    smtpHost: "smtp.qq.com",
+    smtpPort: 465,
+    smtpSecurity: "tls",
+    notes: "Use the IMAP/SMTP authorization code from QQ Mail settings, not the account password. IMAP service must be enabled first.",
+};
+const netease163 = {
+    imapHost: "imap.163.com",
+    imapPort: 993,
+    imapSecurity: "tls",
+    smtpHost: "smtp.163.com",
+    smtpPort: 465,
+    smtpSecurity: "tls",
+    notes: "NetEase 163 Mail — use the client authorization code from Mail Settings → POP3/SMTP/IMAP, not the account password.",
+};
+const netease126 = {
+    imapHost: "imap.126.com",
+    imapPort: 993,
+    imapSecurity: "tls",
+    smtpHost: "smtp.126.com",
+    smtpPort: 465,
+    smtpSecurity: "tls",
+    notes: "NetEase 126 Mail — use the client authorization code from Mail Settings → POP3/SMTP/IMAP.",
+};
+const neteaseYeah = {
+    imapHost: "imap.yeah.net",
+    imapPort: 993,
+    imapSecurity: "tls",
+    smtpHost: "smtp.yeah.net",
+    smtpPort: 465,
+    smtpSecurity: "tls",
+    notes: "NetEase yeah.net — use the client authorization code from Mail Settings → POP3/SMTP/IMAP.",
+};
+const sina = {
+    imapHost: "imap.sina.com",
+    imapPort: 993,
+    imapSecurity: "tls",
+    smtpHost: "smtp.sina.com",
+    smtpPort: 465,
+    smtpSecurity: "tls",
+    notes: "Sina Mail — enable IMAP/SMTP in webmail settings first.",
+};
+const orangeFr = {
+    imapHost: "imap.orange.fr",
+    imapPort: 993,
+    imapSecurity: "tls",
+    smtpHost: "smtp.orange.fr",
+    smtpPort: 465,
+    smtpSecurity: "tls",
+    notes: "Orange/Wanadoo — a mail-specific password may be required (managed via Orange account security).",
+};
+const freeFr = {
+    imapHost: "imap.free.fr",
+    imapPort: 993,
+    imapSecurity: "tls",
+    smtpHost: "smtp.free.fr",
+    smtpPort: 465,
+    smtpSecurity: "tls",
+};
+const laposte = {
+    imapHost: "imap.laposte.net",
+    imapPort: 993,
+    imapSecurity: "tls",
+    smtpHost: "smtp.laposte.net",
+    smtpPort: 465,
+    smtpSecurity: "tls",
+};
+const sfrFr = {
+    imapHost: "imap.sfr.fr",
+    imapPort: 993,
+    imapSecurity: "tls",
+    smtpHost: "smtp.sfr.fr",
+    smtpPort: 465,
+    smtpSecurity: "tls",
+};
+const tOnline = {
+    imapHost: "secureimap.t-online.de",
+    imapPort: 993,
+    imapSecurity: "tls",
+    smtpHost: "securesmtp.t-online.de",
+    smtpPort: 465,
+    smtpSecurity: "tls",
+    notes: "Deutsche Telekom / T-Online — an E-Mail-Passwort (separate from the account password) must be generated in Telekom account security settings.",
+};
+const webDe = {
+    imapHost: "imap.web.de",
+    imapPort: 993,
+    imapSecurity: "tls",
+    smtpHost: "smtp.web.de",
+    smtpPort: 587,
+    smtpSecurity: "starttls",
+    notes: "POP3/IMAP access must be enabled in web.de webmail settings first.",
+};
+const ionosDe = {
+    imapHost: "imap.ionos.de",
+    imapPort: 993,
+    imapSecurity: "tls",
+    smtpHost: "smtp.ionos.de",
+    smtpPort: 465,
+    smtpSecurity: "tls",
+    notes: "IONOS / 1&1 hosted mail. Business mailboxes on custom domains also use these hosts.",
+};
+const ionosCom = {
+    imapHost: "imap.ionos.com",
+    imapPort: 993,
+    imapSecurity: "tls",
+    smtpHost: "smtp.ionos.com",
+    smtpPort: 465,
+    smtpSecurity: "tls",
+    notes: "IONOS (non-DE regions). Business mailboxes on custom domains also use these hosts.",
+};
+const libero = {
+    imapHost: "imapmail.libero.it",
+    imapPort: 993,
+    imapSecurity: "tls",
+    smtpHost: "smtp.libero.it",
+    smtpPort: 465,
+    smtpSecurity: "tls",
+};
+const virgilio = {
+    imapHost: "in.virgilio.it",
+    imapPort: 993,
+    imapSecurity: "tls",
+    smtpHost: "out.virgilio.it",
+    smtpPort: 465,
+    smtpSecurity: "tls",
+};
+const tiscali = {
+    imapHost: "imap.tiscali.it",
+    imapPort: 993,
+    imapSecurity: "tls",
+    smtpHost: "smtp.tiscali.it",
+    smtpPort: 465,
+    smtpSecurity: "tls",
+};
+const seznam = {
+    imapHost: "imap.seznam.cz",
+    imapPort: 993,
+    imapSecurity: "tls",
+    smtpHost: "smtp.seznam.cz",
+    smtpPort: 465,
+    smtpSecurity: "tls",
+};
+const wp = {
+    imapHost: "imap.wp.pl",
+    imapPort: 993,
+    imapSecurity: "tls",
+    smtpHost: "smtp.wp.pl",
+    smtpPort: 465,
+    smtpSecurity: "tls",
+};
+const onet = {
+    imapHost: "imap.poczta.onet.pl",
+    imapPort: 993,
+    imapSecurity: "tls",
+    smtpHost: "smtp.poczta.onet.pl",
+    smtpPort: 465,
+    smtpSecurity: "tls",
+};
+const comcast = {
+    imapHost: "imap.comcast.net",
+    imapPort: 993,
+    imapSecurity: "tls",
+    smtpHost: "smtp.comcast.net",
+    smtpPort: 587,
+    smtpSecurity: "starttls",
+    notes: "Xfinity/Comcast. Third-party access must be enabled at xfinity.com/email → Security → Third Party Access Security.",
+};
+const att = {
+    imapHost: "imap.mail.att.net",
+    imapPort: 993,
+    imapSecurity: "tls",
+    smtpHost: "smtp.mail.att.net",
+    smtpPort: 465,
+    smtpSecurity: "tls",
+    notes: "AT&T / SBCGlobal / BellSouth / Ameritech / PacBell. Requires a Secure Mail Key from currently.com → Profile → Sign-in info, not the account password.",
+};
+const cox = {
+    imapHost: "imap.cox.net",
+    imapPort: 993,
+    imapSecurity: "tls",
+    smtpHost: "smtp.cox.net",
+    smtpPort: 465,
+    smtpSecurity: "tls",
+    notes: "Cox requires third-party email access to be enabled at myaccount.cox.com.",
+};
+const spectrum = {
+    imapHost: "mobile.charter.net",
+    imapPort: 993,
+    imapSecurity: "tls",
+    smtpHost: "mobile.charter.net",
+    smtpPort: 587,
+    smtpSecurity: "starttls",
+    notes: "Charter/Spectrum/TWC. Third-party email access must be enabled in Spectrum account settings.",
+};
+const earthlink = {
+    imapHost: "imap.earthlink.net",
+    imapPort: 993,
+    imapSecurity: "tls",
+    smtpHost: "smtpauth.earthlink.net",
+    smtpPort: 587,
+    smtpSecurity: "starttls",
+};
+const btInternet = {
+    imapHost: "mail.btinternet.com",
+    imapPort: 993,
+    imapSecurity: "tls",
+    smtpHost: "mail.btinternet.com",
+    smtpPort: 465,
+    smtpSecurity: "tls",
+    notes: "BT Internet / BT Openworld / BT Yahoo. Third-party access may require enabling in the BT email security settings.",
+};
+const sky = {
+    imapHost: "imap.tools.sky.com",
+    imapPort: 993,
+    imapSecurity: "tls",
+    smtpHost: "smtp.tools.sky.com",
+    smtpPort: 465,
+    smtpSecurity: "tls",
+};
+const virginMedia = {
+    imapHost: "imap.virginmedia.com",
+    imapPort: 993,
+    imapSecurity: "tls",
+    smtpHost: "smtp.virginmedia.com",
+    smtpPort: 465,
+    smtpSecurity: "tls",
+};
+const talktalk = {
+    imapHost: "mail.talktalk.net",
+    imapPort: 993,
+    imapSecurity: "tls",
+    smtpHost: "smtp.talktalk.net",
+    smtpPort: 465,
+    smtpSecurity: "tls",
+};
+const rackspace = {
+    imapHost: "secure.emailsrvr.com",
+    imapPort: 993,
+    imapSecurity: "tls",
+    smtpHost: "secure.emailsrvr.com",
+    smtpPort: 465,
+    smtpSecurity: "tls",
+    notes: "Rackspace Email — also covers custom domains hosted on Rackspace. Use the full email address as the username.",
+};
+// ---------- Domain → provider map ----------
 const providers = {
-    "gmail.com": {
-        imapHost: "imap.gmail.com",
-        imapPort: 993,
-        imapSecurity: "tls",
-        smtpHost: "smtp.gmail.com",
-        smtpPort: 587,
-        smtpSecurity: "starttls",
-        notes: "Requires an app-specific password (Google Account → Security → 2-Step Verification → App passwords). IMAP must be enabled in Gmail settings.",
-    },
-    "googlemail.com": {
-        imapHost: "imap.gmail.com",
-        imapPort: 993,
-        imapSecurity: "tls",
-        smtpHost: "smtp.gmail.com",
-        smtpPort: 587,
-        smtpSecurity: "starttls",
-        notes: "Same as gmail.com — requires app-specific password.",
-    },
-    "outlook.com": {
-        imapHost: "outlook.office365.com",
-        imapPort: 993,
-        imapSecurity: "tls",
-        smtpHost: "smtp.office365.com",
-        smtpPort: 587,
-        smtpSecurity: "starttls",
-        notes: "Requires an app password if 2FA is enabled (Microsoft Account → Security → App passwords).",
-    },
-    "hotmail.com": {
-        imapHost: "outlook.office365.com",
-        imapPort: 993,
-        imapSecurity: "tls",
-        smtpHost: "smtp.office365.com",
-        smtpPort: 587,
-        smtpSecurity: "starttls",
-        notes: "Same as outlook.com — requires app password with 2FA.",
-    },
-    "live.com": {
-        imapHost: "outlook.office365.com",
-        imapPort: 993,
-        imapSecurity: "tls",
-        smtpHost: "smtp.office365.com",
-        smtpPort: 587,
-        smtpSecurity: "starttls",
-        notes: "Same as outlook.com — requires app password with 2FA.",
-    },
-    "icloud.com": {
-        imapHost: "imap.mail.me.com",
-        imapPort: 993,
-        imapSecurity: "tls",
-        smtpHost: "smtp.mail.me.com",
-        smtpPort: 587,
-        smtpSecurity: "starttls",
-        notes: "Requires an app-specific password (Apple ID → Sign-In and Security → App-Specific Passwords).",
-    },
-    "me.com": {
-        imapHost: "imap.mail.me.com",
-        imapPort: 993,
-        imapSecurity: "tls",
-        smtpHost: "smtp.mail.me.com",
-        smtpPort: 587,
-        smtpSecurity: "starttls",
-        notes: "Same as icloud.com.",
-    },
-    "yahoo.com": {
-        imapHost: "imap.mail.yahoo.com",
-        imapPort: 993,
-        imapSecurity: "tls",
-        smtpHost: "smtp.mail.yahoo.com",
-        smtpPort: 587,
-        smtpSecurity: "starttls",
-        notes: "Requires an app password (Yahoo Account → Account Security → Generate app password).",
-    },
-    "protonmail.com": {
-        imapHost: "127.0.0.1",
-        imapPort: 1143,
-        imapSecurity: "starttls",
-        smtpHost: "127.0.0.1",
-        smtpPort: 1025,
-        smtpSecurity: "starttls",
-        notes: "Requires Proton Mail Bridge running locally. Bridge provides IMAP/SMTP on localhost.",
-    },
-    "proton.me": {
-        imapHost: "127.0.0.1",
-        imapPort: 1143,
-        imapSecurity: "starttls",
-        smtpHost: "127.0.0.1",
-        smtpPort: 1025,
-        smtpSecurity: "starttls",
-        notes: "Same as protonmail.com — requires Proton Mail Bridge.",
-    },
+    // Gmail + Google Workspace consumer aliases
+    "gmail.com": gmail,
+    "googlemail.com": gmail,
+    // Microsoft consumer
+    "outlook.com": outlook,
+    "hotmail.com": outlook,
+    "live.com": outlook,
+    "msn.com": outlook,
+    "outlook.co.uk": outlook,
+    "hotmail.co.uk": outlook,
+    "live.co.uk": outlook,
+    "outlook.de": outlook,
+    "hotmail.de": outlook,
+    "live.de": outlook,
+    "outlook.fr": outlook,
+    "hotmail.fr": outlook,
+    "live.fr": outlook,
+    "outlook.es": outlook,
+    "hotmail.es": outlook,
+    "outlook.it": outlook,
+    "hotmail.it": outlook,
+    "passport.com": outlook,
+    // Apple
+    "icloud.com": icloud,
+    "me.com": icloud,
+    "mac.com": icloud,
+    // Yahoo
+    "yahoo.com": yahoo,
+    "yahoo.co.uk": yahoo,
+    "yahoo.co.jp": yahoo,
+    "yahoo.fr": yahoo,
+    "yahoo.de": yahoo,
+    "yahoo.it": yahoo,
+    "yahoo.es": yahoo,
+    "yahoo.ca": yahoo,
+    "yahoo.com.au": yahoo,
+    "yahoo.com.br": yahoo,
+    "yahoo.in": yahoo,
+    "ymail.com": yahoo,
+    "rocketmail.com": yahoo,
+    "frontier.com": yahoo,
+    "frontiernet.net": yahoo,
+    // AOL (Yahoo-operated; Verizon migrated here)
+    "aol.com": aol,
+    "aim.com": aol,
+    "verizon.net": aol,
+    // Proton (requires Bridge for IMAP/SMTP)
+    "protonmail.com": protonBridge,
+    "proton.me": protonBridge,
+    "pm.me": protonBridge,
+    "protonmail.ch": protonBridge,
+    // GMX / Mail.com (United Internet family)
+    "gmx.com": gmxCom,
+    "gmx.co.uk": gmxCom,
+    "gmx.us": gmxCom,
+    "gmx.net": gmxNet,
+    "gmx.de": gmxNet,
+    "gmx.at": gmxNet,
+    "gmx.ch": gmxNet,
+    "mail.com": mailCom,
+    "email.com": mailCom,
+    // Zoho (per-region hosts)
+    "zoho.com": zohoCom,
+    "zohomail.com": zohoCom,
+    "zoho.eu": zohoEu,
+    "zohomail.eu": zohoEu,
+    "zoho.in": zohoIn,
+    "zohomail.in": zohoIn,
+    // Fastmail (and its alias domains)
+    "fastmail.com": fastmail,
+    "fastmail.fm": fastmail,
+    "fastmail.co.uk": fastmail,
+    "fastmail.net": fastmail,
+    "fastmail.to": fastmail,
+    "fastmail.us": fastmail,
+    "messagingengine.com": fastmail,
+    // Yandex
+    "yandex.com": yandex,
+    "yandex.ru": yandex,
+    "yandex.by": yandex,
+    "yandex.kz": yandex,
+    "yandex.ua": yandex,
+    "ya.ru": yandex,
+    "narod.ru": yandex,
+    // Mail.ru
+    "mail.ru": mailRu,
+    "inbox.ru": mailRu,
+    "list.ru": mailRu,
+    "bk.ru": mailRu,
+    "internet.ru": mailRu,
+    // Chinese providers
+    "qq.com": qq,
+    "foxmail.com": qq,
+    "163.com": netease163,
+    "126.com": netease126,
+    "yeah.net": neteaseYeah,
+    "sina.com": sina,
+    "sina.cn": sina,
+    // France
+    "orange.fr": orangeFr,
+    "wanadoo.fr": orangeFr,
+    "free.fr": freeFr,
+    "laposte.net": laposte,
+    "sfr.fr": sfrFr,
+    "neuf.fr": sfrFr,
+    // Germany / Austria / Switzerland
+    "t-online.de": tOnline,
+    "web.de": webDe,
+    "ionos.de": ionosDe,
+    "ionos.com": ionosCom,
+    "1und1.de": ionosDe,
+    // Italy
+    "libero.it": libero,
+    "virgilio.it": virgilio,
+    "tiscali.it": tiscali,
+    // Czech Republic / Poland
+    "seznam.cz": seznam,
+    "email.cz": seznam,
+    "wp.pl": wp,
+    "o2.pl": wp,
+    "onet.pl": onet,
+    "op.pl": onet,
+    // US ISPs
+    "comcast.net": comcast,
+    "xfinity.com": comcast,
+    "att.net": att,
+    "sbcglobal.net": att,
+    "bellsouth.net": att,
+    "ameritech.net": att,
+    "pacbell.net": att,
+    "swbell.net": att,
+    "cox.net": cox,
+    "charter.net": spectrum,
+    "spectrum.net": spectrum,
+    "twc.com": spectrum,
+    "rr.com": spectrum,
+    "roadrunner.com": spectrum,
+    "earthlink.net": earthlink,
+    // UK ISPs
+    "btinternet.com": btInternet,
+    "btopenworld.com": btInternet,
+    "btconnect.com": btInternet,
+    "sky.com": sky,
+    "virginmedia.com": virginMedia,
+    "blueyonder.co.uk": virginMedia,
+    "ntlworld.com": virginMedia,
+    "talktalk.net": talktalk,
+    "tiscali.co.uk": talktalk,
+    // Business/hosting (custom domains — users often don't know the infrastructure, but these patterns are common)
+    "emailsrvr.com": rackspace,
 };
 /**
  * Look up provider defaults from an email address domain.
@@ -107,7 +560,7 @@ export function inferProvider(email) {
 }
 /**
  * Get provider-specific setup notes for an email domain.
- * Returns null for unknown domains.
+ * Returns null for unknown domains or providers without notes.
  */
 export function getProviderNotes(email) {
     const defaults = inferProvider(email);