proton-mail-bridge-client 1.14.0 → 1.15.0

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAOA,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAYnE,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,EAAE,qBAAqB,EAAE,MAAM,uCAAuC,CAAC;AAC9E,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AACtE,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AACtE,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AACtE,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,KAAK,EAYV,gBAAgB,EACjB,MAAM,kBAAkB,CAAC;AAq/E1B,wBAAgB,kBAAkB,IAAI,gBAAgB,CAuFrD;AAED,wBAAgB,YAAY,CAC1B,MAAM,EAAE,gBAAgB,EACxB,OAAO,GAAE;IACP,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC1B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA4yEP;AAED,wBAAsB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAmD1C"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAOA,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAYnE,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,EAAE,qBAAqB,EAAE,MAAM,uCAAuC,CAAC;AAC9E,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AACtE,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AACtE,OAAO,EAAwD,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AAC5H,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,KAAK,EAYV,gBAAgB,EACjB,MAAM,kBAAkB,CAAC;AAq/E1B,wBAAgB,kBAAkB,IAAI,gBAAgB,CA0FrD;AAED,wBAAgB,YAAY,CAC1B,MAAM,EAAE,gBAAgB,EACxB,OAAO,GAAE;IACP,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC1B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAq2EP;AAED,wBAAsB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAmD1C"}

package/dist/index.js

@@ -13,7 +13,7 @@ import { AuditService } from "./services/audit-service.js";
 import { BackgroundSyncService } from "./services/background-sync-service.js";
 import { DraftStoreService } from "./services/draft-store-service.js";
 import { LocalIndexService } from "./services/local-index-service.js";
-import { SimpleIMAPService } from "./services/simple-imap-service.js";
+import { isLikelyAuthenticationError, isLikelyConnectionError, SimpleIMAPService } from "./services/simple-imap-service.js";
 import { SMTPService } from "./services/smtp-service.js";
 import { ensureValidEmails, isTextLikeMimeType, isValidEmail, lowerCaseAddress, normalizeBoolean, normalizeLimit, normalizeJsonValue, parseEmails, renderMarkdown, stringifyForJson, } from "./utils/helpers.js";
 import { logger } from "./utils/logger.js";
@@ -1043,7 +1043,7 @@ const TOOLS = [
     },
     {
         name: "run_doctor",
-        description: "Run a comprehensive production health check covering SMTP auth, IMAP auth, optional IMAP IDLE probe, SQLite index integrity, and runtime policy validation. Use to fully diagnose or validate the setup. Prefer get_connection_status for a quick protocol-only reachability check.",
+        description: "Run a comprehensive production health check covering SMTP auth, IMAP auth, optional IMAP IDLE probe, SQLite index integrity, sync-failed drafts, runtime policy validation, and what this server can/cannot do (capabilities). Connection failures include a classified diagnosis (authentication_failed vs bridge_unreachable) with a specific fix. Use to fully diagnose or validate the setup. Prefer get_connection_status for a quick protocol-only reachability check.",
         annotations: { readOnlyHint: true },
         inputSchema: {
             type: "object",
@@ -2355,7 +2355,10 @@ export function buildConfigFromEnv() {
             allowRemoteDraftSync,
             allowedActions: parseAllowedActionsEnv("PROTONMAIL_ALLOWED_ACTIONS"),
             startupSync: parseBooleanEnv("PROTONMAIL_STARTUP_SYNC", autoSync),
-            autoSyncFolder: process.env.PROTONMAIL_AUTO_SYNC_FOLDER?.trim() || "INBOX",
+            // Comma-separated; Sent is included by default so pendingOn/digest/follow-up
+            // candidates don't misreport threads that were already answered — IDLE still
+            // only watches the first folder (see BackgroundSyncService.primaryIdleFolder).
+            autoSyncFolder: process.env.PROTONMAIL_AUTO_SYNC_FOLDER?.trim() || "INBOX,Sent",
             autoSyncFull: parseBooleanEnv("PROTONMAIL_AUTO_SYNC_FULL", false),
             autoSyncLimitPerFolder: parseIntegerEnv("PROTONMAIL_AUTO_SYNC_LIMIT_PER_FOLDER", 100, 1, 500),
             idleWatchEnabled,
@@ -3730,7 +3733,7 @@ export function createServer(config, options = {}) {
                     const includeImap = normalizeBoolean(args.includeImap, true);
                     const includeIdleProbe = normalizeBoolean(args.includeIdleProbe, false);
                     const idleTimeoutSeconds = normalizeLimit(args.idleTimeoutSeconds, 5, 1, 60);
-                    const [smtpStatus, imapStatus, indexStatus, integrity] = await Promise.all([
+                    const [smtpStatus, imapStatus, indexStatus, integrity, drafts] = await Promise.all([
                         includeSmtp
                             ? Promise.allSettled([smtpService.verifyConnection()]).then(([result]) => result)
                             : Promise.resolve({ status: "fulfilled", value: undefined }),
@@ -3739,6 +3742,7 @@ export function createServer(config, options = {}) {
                             : Promise.resolve({ status: "fulfilled", value: undefined }),
                         localIndexService.getStatus(),
                         localIndexService.runIntegrityCheck(),
+                        draftStore.listDrafts(true),
                     ]);
                     const idleProbe = includeIdleProbe
                         ? await Promise.allSettled([
@@ -3748,6 +3752,24 @@ export function createServer(config, options = {}) {
                             }),
                         ]).then(([result]) => result)
                         : undefined;
+                    // Classifies the connection failure into a specific, actionable cause —
+                    // without PROTONMAIL_DEBUG this used to just say "connection failed" for
+                    // both a wrong password and Bridge not being open at all.
+                    const diagnoseFailure = (reason) => {
+                        if (isLikelyAuthenticationError(reason)) {
+                            return {
+                                cause: "authentication_failed",
+                                suggestion: "PROTONMAIL_PASSWORD must be the Proton Bridge password (Bridge app -> account -> Mailbox details), not your Proton account password. Confirm you're signed in inside the Bridge app.",
+                            };
+                        }
+                        if (isLikelyConnectionError(reason)) {
+                            return {
+                                cause: "bridge_unreachable",
+                                suggestion: "Proton Bridge isn't reachable on the configured host/port. Make sure the Bridge app is running, and that PROTONMAIL_IMAP_HOST/PORT and PROTONMAIL_SMTP_HOST/PORT match Bridge's Mailbox details.",
+                            };
+                        }
+                        return undefined;
+                    };
                     return createTextResult({
                         checkedAt: new Date().toISOString(),
                         runtime: sanitizeRuntimeConfig(config.runtime),
@@ -3761,6 +3783,7 @@ export function createServer(config, options = {}) {
                                         ? smtpStatus.reason.message
                                         : String(smtpStatus.reason)
                                     : "SMTP connection failed.",
+                            ...(smtpStatus.status === "rejected" ? { diagnosis: diagnoseFailure(smtpStatus.reason) } : {}),
                         },
                         imap: {
                             ok: imapStatus.status === "fulfilled",
@@ -3773,6 +3796,7 @@ export function createServer(config, options = {}) {
                                         ? imapStatus.reason.message
                                         : String(imapStatus.reason)
                                     : "IMAP connection failed.",
+                            ...(imapStatus.status === "rejected" ? { diagnosis: diagnoseFailure(imapStatus.reason) } : {}),
                         },
                         idleProbe: idleProbe === undefined
                             ? { skipped: true }
@@ -3789,9 +3813,28 @@ export function createServer(config, options = {}) {
                         backgroundSync: backgroundSyncService.getStatus(),
                         index: indexStatus,
                         integrity,
+                        drafts: {
+                            total: drafts.length,
+                            syncFailed: drafts.filter((draft) => draft.remoteSyncState === "sync_failed").length,
+                            syncFailedIds: drafts
+                                .filter((draft) => draft.remoteSyncState === "sync_failed")
+                                .map((draft) => draft.id),
+                        },
                         audit: {
                             path: auditService.getPath(),
                         },
+                        // What this server can and cannot do, given Proton Bridge only proxies
+                        // local IMAP/SMTP — prevents an agent from attempting an impossible
+                        // operation (e.g. server-side filters) and getting a confusing failure.
+                        capabilities: {
+                            supported: ["mail read/search/send", "folders", "labels (IMAP folders under Labels/)", "drafts", "local full-text index"],
+                            notSupported: [
+                                "server-side filters/rules (no ManageSieve access through Bridge)",
+                                "real contacts / address book (no CardDAV access through Bridge)",
+                                "calendar (no CalDAV access through Bridge)",
+                                "vacation responder (Proton account API only, not exposed via Bridge)",
+                            ],
+                        },
                     });
                 }
                 case "get_runtime_status": {
@@ -4286,7 +4329,13 @@ export function createServer(config, options = {}) {
                 throw error;
             }
             logger.error("Tool call failed", "MCPServer", { name, error });
-            throw new McpError(ErrorCode.InternalError, "An internal error occurred. Check get_logs for details.");
+            if (isLikelyAuthenticationError(error)) {
+                throw new McpError(ErrorCode.InternalError, "IMAP authentication failed. Check that PROTONMAIL_PASSWORD is your Proton Bridge password (not your Proton account password) and that you're signed in inside the Bridge app. Run run_doctor for a full connectivity check.");
+            }
+            if (isLikelyConnectionError(error)) {
+                throw new McpError(ErrorCode.InternalError, "Could not connect to Proton Bridge. Make sure the Bridge app is running, and that PROTONMAIL_IMAP_HOST/PORT and PROTONMAIL_SMTP_HOST/PORT match the ports shown in Bridge's settings. Run run_doctor for a full connectivity check.");
+            }
+            throw new McpError(ErrorCode.InternalError, "An internal error occurred. Check get_logs for details, or run run_doctor for a full connectivity check.");
         }
     });
     return {