hypermail-mcp 0.7.2 → 0.7.4

package/README.md

@@ -3,6 +3,16 @@
 A **Model Context Protocol** server that lets an agent operate any of the user's
 inboxes through a single, unified tool surface.
 
+> **v0.7.4** — `inReplyTo` is now a required parameter on `send_email` and
+> `draft_email` (was optional). Set it to `false` for a new email, or pass a
+> message ID to thread a reply. This forces the agent to make an explicit choice
+> instead of silently treating replies as new conversations.
+>
+> **v0.7.3** — `edit_draft` now preserves the quoted thread history when editing
+> Outlook reply/forward drafts. Previously, editing a draft body would overwrite
+> the entire content — including the quoted thread. Now only the answer part
+> (above the spacer delimiter) is replaced.
+>
 > **v0.7.2** — `add_attachment_to_draft` now accepts `filePath` (absolute path to
 a local file) as an alternative to `contentBytes`. The file is read from disk and
 base64-encoded automatically, the MIME type is inferred from the extension, and
@@ -227,11 +237,11 @@ account store.
 | `archive_email` | `account`, `id` | Move a message to the Archive folder. Disabled under `--read-only`. |
 | `trash_email` | `account`, `id` | Move a message to Deleted Items (trash). Disabled under `--read-only`. |
 | `move_email` | `account`, `id`, `destination` | Move to any folder by well-known name (`inbox`, `drafts`, etc.) or custom folder ID. Disabled under `--read-only`. |
-| `send_email` | `account`, `to[]`, `cc?`, `bcc?`, `subject`, `body`, `format`, `include_signature?`, `inReplyTo?`, `replyAll?`, `forwardMessageId?` | Send an email. `format` (`"html"` or `"markdown"`) controls body format — Markdown is converted to HTML via `marked`. Appends signature when `include_signature` is true. `inReplyTo` sends as threaded reply; `forwardMessageId` sends as forward. Disabled under `--read-only`. |
-| `draft_email` | `account`, `to[]`, `cc?`, `bcc?`, `subject`, `body`, `format`, `include_signature?`, `inReplyTo?`, `replyAll?`, `forwardMessageId?` | Save as draft instead of sending. `format` (`"html"` or `"markdown"`) controls body format — Markdown is converted to HTML via `marked`. Returns the draft message ID and HTML body (`draftHtml`). Disabled under `--read-only`. |
+| `send_email` | `account`, `to[]`, `cc?`, `bcc?`, `subject`, `body`, `format`, `include_signature`, `inReplyTo`, `replyAll?`, `forwardMessageId?` | Send an email. `format` (`"html"` or `"markdown"`) controls body format — Markdown is converted to HTML via `marked`. Appends signature when `include_signature` is true. `inReplyTo` sends as threaded reply; `forwardMessageId` sends as forward. `inReplyTo` is required — set to `false` for new emails. Disabled under `--read-only`. |
+| `draft_email` | `account`, `to[]`, `cc?`, `bcc?`, `subject`, `body`, `format`, `include_signature`, `inReplyTo`, `replyAll?`, `forwardMessageId?` | Save as draft instead of sending. `format` (`"html"` or `"markdown"`) controls body format — Markdown is converted to HTML via `marked`. Returns the draft message ID and HTML body (`draftHtml`). `inReplyTo` is required — set to `false` for new emails. Disabled under `--read-only`. |
 | `edit_draft` | `account`, `id`, `to?`, `cc?`, `bcc?`, `subject?`, `body?`, `format?`, `include_signature?` | Edit an existing draft by ID. Only provided fields are updated. `format` only meaningful when `body` is provided. Returns the updated draft ID and HTML body (`draftHtml`). Disabled under `--read-only`. |
 | `send_draft` | `account`, `id` | Send an existing draft email by ID. Use with draft IDs returned by `draft_email` or `edit_draft`. Disabled under `--read-only`. |
-| `add_attachment_to_draft` | `account`, `id`, `name`, `contentBytes`, `contentType?` | Attach a base64-encoded file to an existing draft email by ID. Disabled under `--read-only`. |
+| `add_attachment_to_draft` | `account`, `id`, `name?`, `contentBytes?`, `filePath?`, `contentType?` | Attach a file to an existing draft by ID. Provide `contentBytes` (base64) or `filePath` (absolute path — auto-encodes). Disabled under `--read-only`. |
 | `list_folders` | `account`, `parentFolderId?` | List available mail folders. Returns top-level folders by default, or children of `parentFolderId`. |
 | `create_folder` | `account`, `displayName`, `parentFolderId?` | Create a new mail folder under root (default) or the given parent. Disabled under `--read-only`. |
 | `delete_folder` | `account`, `folderId` | Delete a mail folder by ID. Disabled under `--read-only`. |

package/dist/cli.js

@@ -2191,6 +2191,7 @@ async function updateDraft2(clients, account, id, update) {
     subject: update.subject ?? origSubject,
     body: update.body ?? "",
     isHtml: update.isHtml,
+    inReplyTo: false,
     cc: existingCc.length > 0 ? existingCc : void 0,
     bcc: existingBcc.length > 0 ? existingBcc : void 0
   });
@@ -3318,8 +3319,8 @@ function registerComposeTools(server, ctx) {
     include_signature: z6.boolean().describe(
       "Whether to append the account's saved HTML signature to the email. If true, don't include a signature in the body param to avoid double signature. Returns an error if true but no signature is configured for this account."
     ),
-    inReplyTo: z6.string().optional().describe(
-      "Message ID to reply to. When set, sends as a threaded reply which includes the quoted thread history automatically."
+    inReplyTo: z6.union([z6.string(), z6.literal(false)]).describe(
+      "Message ID to reply to. When set, sends as a threaded reply which includes the quoted thread history automatically. Set to `false` for a new email (not a reply)."
     ),
     replyAll: z6.boolean().default(false).optional().describe(
       "When true and `inReplyTo` is set, reply to all recipients instead of just the sender."
@@ -3460,6 +3461,18 @@ function registerComposeTools(server, ctx) {
             bodyPayload = composed.body;
             isHtmlPayload = composed.isHtml;
           }
+          if (bodyPayload !== void 0) {
+            const spacer = '<div style="line-height:12px"><br></div>';
+            try {
+              const existing = await provider.readEmail(account, a.id);
+              const existingHtml = existing.bodyHtml ?? "";
+              const spacerIdx = existingHtml.indexOf(spacer);
+              if (spacerIdx !== -1) {
+                bodyPayload = bodyPayload + existingHtml.slice(spacerIdx);
+              }
+            } catch {
+            }
+          }
           const res = await provider.updateDraft(account, a.id, {
             to: a.to,
             cc: a.cc,
@@ -3616,7 +3629,7 @@ function registerTools(server, opts) {
 // package.json
 var package_default = {
   name: "hypermail-mcp",
-  version: "0.7.2",
+  version: "0.7.4",
   description: "Unified email MCP server \u2014 operate any inbox (Outlook now, IMAP/Gmail later) by passing an email address.",
   type: "module",
   bin: {
@@ -3677,6 +3690,7 @@ var package_default = {
     "@types/isomorphic-fetch": "^0.0.39",
     "@types/node": "^22.10.2",
     "@types/nodemailer": "^8.0.0",
+    "@types/turndown": "^5.0.6",
     tsup: "^8.3.5",
     typescript: "^5.7.2",
     vitest: "^2.1.8"