@bobfrankston/mailx 1.0.310 → 1.0.317

package/client/compose/compose.js

@@ -4,7 +4,7 @@
  * Receives init data via window.opener.postMessage or URL params.
  */
 import { createEditor } from "./editor.js";
-import { getVersion, getSettings, getAccounts, searchContacts, sendMessage, saveDraft as apiSaveDraft, deleteDraft } from "../lib/api-client.js";
+import { getSettings, getAccounts, searchContacts, sendMessage, saveDraft as apiSaveDraft, deleteDraft } from "../lib/api-client.js";
 /** Close compose window */
 function closeCompose() {
     window.close();
@@ -45,15 +45,37 @@ async function loadEditorAssets(type) {
     }
 }
 // ── Determine editor type from settings ──
+//
+// Compose must open fast. The previous flow awaited getVersion() then
+// getSettings() sequentially before the editor was even loaded — any
+// service-side stall (busy sync, slow IMAP, hung OAuth refresh) turned
+// "click Reply" into a multi-second / multi-minute wait with a blank
+// compose window. Local-first: read the editor-type preference from a
+// tiny localStorage cache that we update whenever getSettings succeeds
+// in the background. Default to quill on first run / cache miss.
 let editorType = "quill";
 let appSettings = null;
 try {
-    await getVersion(); // verify server is up
-    appSettings = await getSettings();
-    if (appSettings.ui?.editor === "tiptap")
-        editorType = "tiptap";
+    const cached = localStorage.getItem("mailx-editor-type");
+    if (cached === "tiptap" || cached === "quill")
+        editorType = cached;
 }
-catch { /* default to quill */ }
+catch { /* private-mode / SecurityError — default quill */ }
+// Refresh the cache asynchronously — doesn't block compose open.
+(async () => {
+    try {
+        appSettings = await getSettings();
+        const next = appSettings?.ui?.editor === "tiptap" ? "tiptap" : "quill";
+        try {
+            localStorage.setItem("mailx-editor-type", next);
+        }
+        catch { /* */ }
+        // Note: we don't hot-swap the editor if the preference changed while
+        // compose was opening — the old type is already instantiated. Next
+        // compose open will pick up the new preference.
+    }
+    catch { /* non-fatal */ }
+})();
 await loadEditorAssets(editorType);
 const container = document.getElementById("compose-editor");
 container.classList.add(editorType === "tiptap" ? "editor-tiptap" : "editor-quill");
@@ -382,26 +404,63 @@ function scheduleDraftSave() {
         clearTimeout(draftDebounceTimer);
     draftDebounceTimer = setTimeout(() => { draftDebounceTimer = null; saveDraft(); }, DRAFT_INPUT_DEBOUNCE_MS);
 }
-// ── Initialize: always fetch real accounts from the API before applying init, then
-//    start the auto-save timer. Callers like message-viewer's Edit Draft pass
-//    init.accounts=[], so we can't trust what's in the init blob. ──
+// ── Initialize: local-first population.
+//
+// Reply / Reply-All / Forward callers pre-populate `init.accounts` with the
+// full account list (app.ts:openCompose). In that common case we do NOT need
+// to call getAccounts() — everything required to fill the compose form is
+// already in sessionStorage and reads synchronously. That turns "click Reply"
+// into an instant-open instead of "wait for getAccounts IPC to respond,
+// which can take >120s when the service is busy syncing / hung on IMAP".
+//
+// getAccounts is still called (non-blocking) to refresh the dropdown with
+// the freshest data — and it IS awaited only in the fallback path where
+// init doesn't have an account list (message-viewer's Edit Draft passes
+// init.accounts=[]).
 (async () => {
-    let accounts = [];
-    try {
-        accounts = await getAccounts();
-    }
-    catch (e) {
-        console.error("Failed to load accounts:", e);
-    }
     const stored = sessionStorage.getItem("composeInit");
     if (stored) {
         sessionStorage.removeItem("composeInit");
         const init = JSON.parse(stored);
-        if (!init.accounts || init.accounts.length === 0)
-            init.accounts = accounts;
-        applyInit(init);
+        if (init.accounts && init.accounts.length > 0) {
+            // Happy path — init is complete. Apply immediately. Kick
+            // getAccounts in the background to refresh the dropdown if the
+            // user keeps compose open long enough for the result.
+            applyInit(init);
+            getAccounts().then((fresh) => {
+                if (Array.isArray(fresh) && fresh.length > 0) {
+                    init.accounts = fresh;
+                    // Re-populate the From dropdown only — don't clobber
+                    // anything the user may have already typed.
+                    try {
+                        populateFromOptions(fresh);
+                    }
+                    catch { /* */ }
+                }
+            }).catch(() => { });
+        }
+        else {
+            // Edit Draft / other callers that didn't pre-fill accounts.
+            // Have to wait on getAccounts here — the From dropdown needs it.
+            let fresh = [];
+            try {
+                fresh = await getAccounts();
+            }
+            catch (e) {
+                console.error("Failed to load accounts:", e);
+            }
+            init.accounts = fresh;
+            applyInit(init);
+        }
     }
     else {
+        let accounts = [];
+        try {
+            accounts = await getAccounts();
+        }
+        catch (e) {
+            console.error("Failed to load accounts:", e);
+        }
         populateFromOptions(accounts);
         toInput.focus();
     }
@@ -459,7 +518,25 @@ document.getElementById("btn-send")?.addEventListener("click", async () => {
     catch (e) {
         btn.disabled = false;
         btn.textContent = "Send";
-        alert(`Send failed: ${e.message}`);
+        const msg = e?.message || String(e);
+        // Distinguish the IPC-timeout case from real send failures. The
+        // service-side send() queues the message to the local DB synchronously
+        // before attempting any IMAP/SMTP work — so if the IPC reached Node at
+        // all, the message is queued and the background worker will retry it
+        // with backoff (X-Mailx-Retry header, 60s settling delay, up to 10
+        // attempts). Treating that as a failure that demands a re-click leads
+        // to duplicate sends. Tell the user honestly: "probably queued, check
+        // Outbox before retrying."
+        if (msg.startsWith("mailxapi timeout")) {
+            alert("Send is taking longer than expected.\n\n" +
+                "The message has likely been queued and will be retried in the background. " +
+                "Check the Outbox folder before clicking Send again — clicking Send now may " +
+                "produce a duplicate.\n\n" +
+                "Your draft is preserved either way.");
+        }
+        else {
+            alert(`Send failed: ${msg}`);
+        }
     }
 });
 // ── Close handling ──

package/client/compose/editor.js

@@ -230,19 +230,63 @@ function createQuillEditor(container) {
         openLinkForRange(q, q.getSelection() || { index: q.getLength() - 1, length: 0 });
     });
     // Paste handling:
-    // - If clipboard has text/html, let Quill convert it (preserves anchors).
-    // - If only text/plain and it's a URL, insert as a link (honoring any text
-    //   currently selected — the URL becomes the href of that text).
-    // - Shift+Ctrl+V (handled via contextmenu "Paste as text") or any other
-    //   plain text is inserted verbatim.
+    // - text/html clipboard with exactly one anchor (the common "copy a link
+    //   with anchor text from a webpage" case): take it over from Quill —
+    //   Quill's clipboard module was producing duplicates ("click here" as
+    //   text PLUS a separate "https://example.com" as a link tail). Insert
+    //   the anchor's text content as a single linked run.
+    // - text/html with richer content: defer to Quill (preserves formatting).
+    // - text/plain that's a URL: insert as a link, optionally wrapping any
+    //   currently-selected text.
+    // - Anything else: default Quill behavior (verbatim plain or HTML).
     q.root.addEventListener("paste", (e) => {
         const cb = e.clipboardData;
         if (!cb)
             return;
         const html = cb.getData("text/html");
         const plain = cb.getData("text/plain");
-        if (html)
-            return; // Quill handles HTML clipboard natively
+        if (html) {
+            // Detect "single anchor" clipboard — copy from a browser usually
+            // produces something like:
+            //   <meta charset='utf-8'><a href="https://example.com">click here</a>
+            // or wrapped in <html><body>. Parse and check.
+            try {
+                const tmp = document.createElement("div");
+                tmp.innerHTML = html;
+                // Strip script/style, then unwrap <html>/<body> noise.
+                const root = tmp.querySelector("body") || tmp;
+                // Walk for the only meaningful element
+                const meaningful = Array.from(root.childNodes).filter(n => {
+                    if (n.nodeType === Node.TEXT_NODE)
+                        return (n.textContent || "").trim().length > 0;
+                    if (n.nodeType === Node.ELEMENT_NODE) {
+                        const tag = n.tagName.toLowerCase();
+                        return tag !== "meta" && tag !== "style" && tag !== "script";
+                    }
+                    return false;
+                });
+                if (meaningful.length === 1 && meaningful[0].tagName?.toLowerCase() === "a") {
+                    const a = meaningful[0];
+                    const href = a.getAttribute("href") || "";
+                    const text = (a.textContent || "").trim();
+                    if (href && text) {
+                        e.preventDefault();
+                        const range = q.getSelection(true);
+                        if (!range)
+                            return;
+                        if (range.length > 0) {
+                            // Selected text exists — replace with the linked anchor text
+                            q.deleteText(range.index, range.length);
+                        }
+                        q.insertText(range.index, text, { link: href });
+                        q.setSelection(range.index + text.length, 0);
+                        return;
+                    }
+                }
+            }
+            catch { /* fall through to Quill default */ }
+            return; // Quill handles richer HTML clipboard
+        }
         if (plain && looksLikeUrl(plain)) {
             e.preventDefault();
             const range = q.getSelection(true);

package/client/index.html

@@ -38,6 +38,8 @@
                     <label class="tb-menu-item"><input type="radio" name="opt-editor" value="tiptap" id="opt-editor-tiptap"> tiptap</label>
                     <hr class="tb-menu-sep">
                     <label class="tb-menu-item"><input type="checkbox" id="opt-autocomplete"> AI autocomplete</label>
+                    <label class="tb-menu-item" title="Right-click in message body → Translate"><input type="checkbox" id="opt-ai-translate"> AI translate (off by default)</label>
+                    <label class="tb-menu-item" title="Right-click in compose editor → Proofread (when wired)"><input type="checkbox" id="opt-ai-proofread"> AI proofread (off by default)</label>
                     <hr class="tb-menu-sep">
                     <button class="tb-menu-item" id="btn-edit-jsonc" title="Edit accounts.jsonc / allowlist.jsonc">Edit config files...</button>
                     <button class="tb-menu-item" id="btn-about" title="Show version and build info">About mailx...</button>
@@ -69,6 +71,22 @@
         <button class="alert-dismiss" id="alert-dismiss" title="Dismiss">&times;</button>
     </div>
 
+    <aside class="icon-rail" id="icon-rail" aria-label="App rail">
+        <div class="rail-top">
+            <button class="rail-btn" id="rail-compose" title="Compose (Ctrl+N)" aria-label="Compose">✏</button>
+            <button class="rail-btn" id="rail-inbox" title="Inbox" aria-label="Inbox" data-active="true">✉</button>
+            <button class="rail-btn" id="rail-unified" title="All Inboxes" aria-label="All Inboxes">⌘</button>
+            <button class="rail-btn" id="rail-contacts" title="Contacts (coming soon)" aria-label="Contacts" disabled>👤</button>
+            <button class="rail-btn" id="rail-calendar" title="Calendar (Phase 4)" aria-label="Calendar" disabled>📅</button>
+            <button class="rail-btn" id="rail-tasks" title="Tasks (Phase 4)" aria-label="Tasks" disabled>☑</button>
+        </div>
+        <div class="rail-bottom">
+            <button class="rail-btn" id="rail-settings" title="Settings" aria-label="Settings">⚙</button>
+            <button class="rail-btn" id="rail-theme" title="Toggle theme" aria-label="Toggle theme">◐</button>
+            <button class="rail-btn" id="rail-help" title="Help / About" aria-label="Help">?</button>
+        </div>
+    </aside>
+
     <div class="folder-panel">
         <div class="ft-filter">
             <input type="text" id="ft-filter-input" placeholder="Find folder..." autocomplete="off">

package/client/lib/api-client.js

@@ -167,6 +167,12 @@ export function readConfigHelp(name) {
 export function unsubscribeOneClick(url) {
     return ipc().unsubscribeOneClick?.(url);
 }
+/** Run an AI text transform (translate / proofread / summarize). Returns
+ *  empty `text` with a `reason` when the feature is disabled or the provider
+ *  errors — caller should surface `reason` in a status bar, not throw. */
+export function aiTransform(req) {
+    return ipc().aiTransform?.(req) ?? Promise.resolve({ text: "", reason: "AI not available in this host" });
+}
 export function setupAccount(name, email, password) {
     return ipc().setupAccount?.(name, email, password);
 }

package/client/lib/mailxapi.js

@@ -115,6 +115,9 @@
         unsubscribeOneClick: function(url) {
             return callNode("unsubscribeOneClick", { url: url });
         },
+        aiTransform: function(req) {
+            return callNode("aiTransform", req);
+        },
         searchContacts: function(query) {
             return callNode("searchContacts", { query: query });
         },

package/client/styles/layout.css

@@ -8,13 +8,14 @@
 
 body {
     display: grid;
-    grid-template-columns: var(--folder-width) 1fr;
+    /* rail | folders | main */
+    grid-template-columns: var(--rail-width, 48px) var(--folder-width) 1fr;
     grid-template-rows: var(--toolbar-height) auto 1fr var(--statusbar-height);
     grid-template-areas:
-        "toolbar  toolbar"
-        "alert    alert"
-        "folders  main"
-        "status   status";
+        "toolbar  toolbar  toolbar"
+        "alert    alert    alert"
+        "rail     folders  main"
+        "status   status   status";
     height: 100vh;
     overflow: hidden;
     font-family: var(--font-ui);
@@ -25,11 +26,55 @@ body {
 }
 
 .toolbar { grid-area: toolbar; }
+.icon-rail { grid-area: rail; }
 .folder-panel { grid-area: folders; display: flex; flex-direction: column; overflow: hidden; }
 .folder-tree { flex: 1; overflow-y: auto; }
 .main-area { grid-area: main; }
 .status-bar { grid-area: status; }
 
+/* Vertical icon rail (Dovecot/Thunderbird-style). Always visible on
+   wide+medium tiers; collapses on narrow (icons move into the hamburger
+   menu — TBD; for now hidden on narrow). */
+.icon-rail {
+    display: flex;
+    flex-direction: column;
+    justify-content: space-between;
+    background: var(--color-bg-alt, #f4f4f5);
+    border-right: 1px solid var(--color-border);
+    padding: 6px 0;
+    overflow: hidden;
+}
+.rail-top, .rail-bottom {
+    display: flex;
+    flex-direction: column;
+    gap: 2px;
+}
+.rail-btn {
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    width: var(--rail-width, 48px);
+    height: 38px;
+    border: 0;
+    background: transparent;
+    cursor: pointer;
+    font-size: 16px;
+    color: var(--color-text);
+    border-left: 3px solid transparent;
+    transition: background 0.12s, border-color 0.12s;
+}
+.rail-btn:hover:not([disabled]) {
+    background: var(--color-hover, rgba(0,0,0,0.06));
+}
+.rail-btn[data-active="true"] {
+    background: var(--color-hover, rgba(0,0,0,0.06));
+    border-left-color: var(--color-accent, #1a6dd4);
+}
+.rail-btn[disabled] {
+    opacity: 0.35;
+    cursor: not-allowed;
+}
+
 /* Main area: message list left, viewer right, vertical splitter */
 .main-area {
     display: grid;
@@ -56,22 +101,22 @@ body {
     background: var(--color-accent);
 }
 
-/* Responsive: mid-width (tablets, foldables) — hide folders, keep list + preview */
+/* Responsive: mid-width (tablets, foldables) — keep rail + list + viewer; folders overlay */
 @media (max-width: 1100px) and (min-width: 769px) {
     body {
-        grid-template-columns: 1fr;
+        grid-template-columns: var(--rail-width, 48px) 1fr;
         grid-template-rows: var(--toolbar-height) auto 1fr var(--statusbar-height);
         grid-template-areas:
-            "toolbar"
-            "alert"
-            "main"
-            "status";
+            "toolbar  toolbar"
+            "alert    alert"
+            "rail     main"
+            "status   status";
     }
 
-    /* Folder panel: overlay slide-in from left (same as narrow) */
+    /* Folder panel: overlay slide-in from left, sitting just to the right of the rail */
     .folder-panel {
         position: fixed;
-        left: -280px;
+        left: calc(var(--rail-width, 48px) - 280px);
         top: var(--toolbar-height);
         bottom: var(--statusbar-height);
         width: 280px;
@@ -81,7 +126,7 @@ body {
         border-right: 1px solid var(--color-border);
         box-shadow: 2px 0 8px rgba(0,0,0,0.3);
     }
-    .folder-panel.open { left: 0; }
+    .folder-panel.open { left: var(--rail-width, 48px); }
 
     /* Show hamburger */
     #btn-menu { display: inline-flex !important; }
@@ -122,6 +167,11 @@ body {
             "status";
     }
 
+    /* Rail hidden on narrow — its commands fold into the hamburger / toolbar.
+       Future work: a slide-in rail behind the hamburger so power-users on phone
+       can still reach calendar/contacts/etc. */
+    .icon-rail { display: none; }
+
     /* Folder panel: overlay slide-in from left */
     .folder-panel {
         position: fixed;

package/client/styles/variables.css

@@ -3,6 +3,7 @@
 
 :root {
     /* Layout */
+    --rail-width: 44px;            /* vertical icon rail (Thunderbird/Dovecot style) */
     --folder-width: 220px;
     --toolbar-height: 44px;
     --statusbar-height: 24px;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bobfrankston/mailx",
-  "version": "1.0.310",
+  "version": "1.0.317",
   "description": "Local-first email client with IMAP sync and standalone native app",
   "type": "module",
   "main": "bin/mailx.js",
@@ -22,10 +22,10 @@
   "dependencies": {
     "@bobfrankston/iflow-direct": "^0.1.23",
     "@bobfrankston/iflow-node": "^0.1.7",
-    "@bobfrankston/miscinfo": "^1.0.8",
+    "@bobfrankston/miscinfo": "^1.0.9",
     "@bobfrankston/oauthsupport": "^1.0.24",
-    "@bobfrankston/msger": "^0.1.340",
-    "@bobfrankston/mailx-host": "^0.1.0",
+    "@bobfrankston/msger": "^0.1.343",
+    "@bobfrankston/mailx-host": "^0.1.3",
     "@capacitor/android": "^8.3.0",
     "@capacitor/cli": "^8.3.0",
     "@capacitor/core": "^8.3.0",
@@ -86,10 +86,10 @@
     "dependencies": {
       "@bobfrankston/iflow-direct": "^0.1.23",
       "@bobfrankston/iflow-node": "^0.1.7",
-      "@bobfrankston/miscinfo": "^1.0.8",
+      "@bobfrankston/miscinfo": "^1.0.9",
       "@bobfrankston/oauthsupport": "^1.0.24",
-      "@bobfrankston/msger": "^0.1.340",
-      "@bobfrankston/mailx-host": "^0.1.0",
+      "@bobfrankston/msger": "^0.1.343",
+      "@bobfrankston/mailx-host": "^0.1.3",
       "@capacitor/android": "^8.3.0",
       "@capacitor/cli": "^8.3.0",
       "@capacitor/core": "^8.3.0",

package/packages/mailx-host/index.d.ts

@@ -16,5 +16,6 @@ export declare function selectHost(): HostName;
 export declare const showMessageBox: typeof msger.showMessageBox;
 export declare const showService: typeof msger.showService;
 export declare const setAppName: typeof msger.setAppName;
+export declare const setAppIcon: typeof msger.setAppIcon;
 export declare const hostName: HostName;
 //# sourceMappingURL=index.d.ts.map

package/packages/mailx-host/index.js

@@ -26,5 +26,6 @@ if (_hostName !== "msger") {
 export const showMessageBox = msger.showMessageBox;
 export const showService = msger.showService;
 export const setAppName = msger.setAppName;
+export const setAppIcon = msger.setAppIcon;
 export const hostName = _hostName;
 //# sourceMappingURL=index.js.map

package/packages/mailx-host/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bobfrankston/mailx-host",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "Host abstraction for mailx — dispatches to msger or msgview",
   "type": "module",
   "main": "index.js",
@@ -16,5 +16,8 @@
   "repository": {
     "type": "git",
     "url": "git@github.com:BobFrankston/mailx-host.git"
+  },
+  "publishConfig": {
+    "access": "public"
   }
 }

package/packages/mailx-imap/index.js

@@ -564,6 +564,11 @@ export class ImapManager extends EventEmitter {
         const folders = await client.getFolderList();
         console.log(`  [diag] ${accountId}: getFolderList done in ${Date.now() - t0}ms (${folders.length} folders)`);
         const specialFolders = client.getSpecialFolders(folders);
+        // Collect server paths so we can prune anything the server no longer
+        // has (user-renamed / -deleted / case-flipped a folder from another
+        // client). IMAP paths are case-sensitive, so "Foo" → "foo" is a real
+        // delete+create of two distinct mailboxes.
+        const serverPaths = new Set();
         for (const folder of folders) {
             // Skip non-selectable folders (virtual parents like "Added", "Added2")
             const flags = folder.flags;
@@ -584,6 +589,34 @@ export class ImapManager extends EventEmitter {
             else if (specialFolders.archive === folder.path)
                 specialUse = "archive";
             this.db.upsertFolder(accountId, folder.path, folder.name || folder.path.split(folder.delimiter || "/").pop() || folder.path, specialUse, folder.delimiter || "/");
+            serverPaths.add(folder.path);
+        }
+        // Prune: any local folder whose exact path (case-sensitive) isn't in
+        // the server's list has been deleted or renamed server-side. Safety
+        // rails: only prune when the server returned a non-empty list (empty
+        // result is more likely a transient protocol / auth error than "all
+        // your folders were deleted"). Never prune INBOX under any
+        // circumstances — even a broken server response shouldn't make us
+        // drop the account's primary mailbox. All other special-use folders
+        // ARE prunable: if the user actually deleted Sent on the server,
+        // we should reflect that locally, and the next sync will re-detect
+        // the server's real Sent folder and re-upsert.
+        if (folders.length > 0) {
+            const localFolders = this.db.getFolders(accountId);
+            const stale = localFolders.filter(f => !serverPaths.has(f.path) &&
+                f.specialUse !== "inbox");
+            for (const f of stale) {
+                console.log(`  [sync] ${accountId}: pruning stale folder "${f.path}" (id=${f.id}) — no longer on server`);
+                try {
+                    this.db.deleteFolder(f.id);
+                }
+                catch (e) {
+                    console.error(`  [sync] ${accountId}: prune failed for "${f.path}": ${e.message}`);
+                }
+            }
+            if (stale.length > 0) {
+                this.emit("folderCountsChanged", accountId, {});
+            }
         }
         this.emit("syncProgress", accountId, "folders", 100);
         // Notify UI that folder structure changed — triggers tree re-render
@@ -964,6 +997,18 @@ export class ImapManager extends EventEmitter {
                 if (!inboxDone) {
                     console.error(`  [sync] ${accountId}: INBOX failed after ${maxAttempts} attempts — will retry next sync cycle`);
                     this.emit("syncError", accountId, `INBOX sync failed after ${maxAttempts} attempts`);
+                    // Even when sync failed, try to prefetch bodies for messages
+                    // already in the local DB. Prefetch uses a separate body
+                    // client (not the ops client that just timed out), so a
+                    // sync timeout on SELECT/SEARCH doesn't necessarily mean
+                    // body fetches will also fail. Without this, a server
+                    // having a slow patch would leave every message with a
+                    // white "not-downloaded" dot indefinitely until sync
+                    // recovers — even though prior syncs already populated
+                    // headers that prefetch can flesh out independently.
+                    if (getPrefetch()) {
+                        this.prefetchBodies(accountId).catch(e => console.error(`  [prefetch] ${accountId}: ${e.message}`));
+                    }
                 }
             }
             else {
@@ -1431,6 +1476,27 @@ export class ImapManager extends EventEmitter {
             }
         }, 30000);
         this.syncIntervals.set("actions", actionsInterval);
+        // Body prefetch as a first-class background task — independent of
+        // sync success. Prefetch was previously only triggered from inside
+        // sync, so any account with slow/failing IMAP had its "not downloaded"
+        // dots stuck forever even though body fetches use a separate
+        // connection that might succeed. Every 60s, for every account, fire
+        // prefetchBodies() (cheap when body_path is already populated — just a
+        // DB query that returns 0 rows; the prefetchingAccounts guard
+        // short-circuits concurrent triggers).
+        if (getPrefetch()) {
+            const kickPrefetch = () => {
+                for (const [accountId] of this.configs) {
+                    this.prefetchBodies(accountId).catch(e => console.error(`  [prefetch] ${accountId}: ${e?.message || e}`));
+                }
+            };
+            // Fire once now so the "not downloaded" dots start filling in
+            // immediately on app start, don't make the user wait a minute.
+            setTimeout(kickPrefetch, 2000);
+            const prefetchInterval = setInterval(kickPrefetch, 60000);
+            this.syncIntervals.set("prefetch", prefetchInterval);
+            console.log(`  [periodic] body prefetch every 60s (independent of sync)`);
+        }
         // Full sync (all folders + IDLE restart) at configured interval
         const fullInterval = setInterval(async () => {
             console.log(`  [periodic] Full sync at ${new Date().toLocaleTimeString()}`);

package/packages/mailx-service/index.d.ts

@@ -5,7 +5,7 @@
  */
 import { MailxDB } from "@bobfrankston/mailx-store";
 import { ImapManager } from "@bobfrankston/mailx-imap";
-import type { Folder, AutocompleteRequest, AutocompleteResponse, AutocompleteSettings } from "@bobfrankston/mailx-types";
+import type { Folder, AutocompleteRequest, AutocompleteResponse, AutocompleteSettings, AiTransformRequest, AiTransformResponse } from "@bobfrankston/mailx-types";
 export declare class MailxService {
     private db;
     private imapManager;
@@ -101,5 +101,10 @@ export declare class MailxService {
     getAutocompleteSettings(): AutocompleteSettings;
     saveAutocompleteSettings(settings: AutocompleteSettings): void;
     autocomplete(req: AutocompleteRequest): Promise<AutocompleteResponse>;
+    /** Generic AI text transform — translate / proofread / summarize.
+     *  Shares the autocomplete provider config (provider, key, model). Each
+     *  feature has its own opt-in toggle (translateEnabled / proofreadEnabled),
+     *  default false. Returns empty text + reason when disabled or on error. */
+    aiTransform(req: AiTransformRequest): Promise<AiTransformResponse>;
 }
 //# sourceMappingURL=index.d.ts.map