@agenticmail/api 0.9.18 → 0.9.19

package/dist/index.js

@@ -2673,6 +2673,17 @@ function createMailRoutes(accountManager, config, db, gatewayManager) {
       next(err);
     }
   });
+  async function resolveSpamFolder(receiver) {
+    const folders = await receiver.listFolders();
+    const junkRe = /^junk\b|^junk mail\b|^spam\b/i;
+    const found = folders.find((f) => f.specialUse === "\\Junk")?.path ?? folders.find((f) => junkRe.test(f.name) || junkRe.test(f.path))?.path;
+    if (found) return found;
+    try {
+      await receiver.createFolder("Junk Mail");
+    } catch {
+    }
+    return "Junk Mail";
+  }
   router.get("/mail/spam", requireAgent, async (req, res, next) => {
     try {
       const agent = req.agent;
@@ -2680,15 +2691,16 @@ function createMailRoutes(accountManager, config, db, gatewayManager) {
       const offset = Math.max(parseInt(req.query.offset) || 0, 0);
       const password = getAgentPassword(agent);
       const receiver = await getReceiver(agent.stalwartPrincipal, password, config);
+      const spamFolder = await resolveSpamFolder(receiver);
       let mailboxInfo;
       try {
-        mailboxInfo = await receiver.getMailboxInfo("Spam");
+        mailboxInfo = await receiver.getMailboxInfo(spamFolder);
       } catch {
-        res.json({ messages: [], count: 0, total: 0, folder: "Spam" });
+        res.json({ messages: [], count: 0, total: 0, folder: spamFolder });
         return;
       }
-      const envelopes = await receiver.listEnvelopes("Spam", { limit, offset });
-      res.json({ messages: envelopes, count: envelopes.length, total: mailboxInfo.exists, folder: "Spam" });
+      const envelopes = await receiver.listEnvelopes(spamFolder, { limit, offset });
+      res.json({ messages: envelopes, count: envelopes.length, total: mailboxInfo.exists, folder: spamFolder });
     } catch (err) {
       next(err);
     }
@@ -2793,12 +2805,13 @@ function createMailRoutes(accountManager, config, db, gatewayManager) {
       const folder = req.body?.folder || "INBOX";
       const password = getAgentPassword(agent);
       const receiver = await getReceiver(agent.stalwartPrincipal, password, config);
-      try {
-        await receiver.createFolder("Spam");
-      } catch {
+      const spamFolder = await resolveSpamFolder(receiver);
+      if (spamFolder === folder) {
+        res.status(400).json({ error: "Message already in spam" });
+        return;
       }
-      await receiver.moveMessage(uid, folder, "Spam");
-      res.json({ ok: true, movedToSpam: true });
+      await receiver.moveMessage(uid, folder, spamFolder);
+      res.json({ ok: true, movedToSpam: true, spam: spamFolder });
     } catch (err) {
       next(err);
     }
@@ -2813,8 +2826,9 @@ function createMailRoutes(accountManager, config, db, gatewayManager) {
       }
       const password = getAgentPassword(agent);
       const receiver = await getReceiver(agent.stalwartPrincipal, password, config);
-      await receiver.moveMessage(uid, "Spam", "INBOX");
-      res.json({ ok: true, movedToInbox: true });
+      const spamFolder = await resolveSpamFolder(receiver);
+      await receiver.moveMessage(uid, spamFolder, "INBOX");
+      res.json({ ok: true, movedToInbox: true, spam: spamFolder });
     } catch (err) {
       next(err);
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agenticmail/api",
-  "version": "0.9.18",
+  "version": "0.9.19",
   "description": "REST API server for AgenticMail — email and SMS endpoints for AI agents",
   "type": "module",
   "main": "dist/index.js",