hypermail-mcp 0.7.1 → 0.7.2

package/README.md

@@ -3,7 +3,11 @@
 A **Model Context Protocol** server that lets an agent operate any of the user's
 inboxes through a single, unified tool surface.
 
-> **v0.7.1** — Every config field is now settable via a dedicated
+> **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
+`name` defaults to the file's basename.
+>> **v0.7.1** — Every config field is now settable via a dedicated
 > `HYPERMAIL_*` env var. Legacy env vars (`MS_CLIENT_ID`, `MS_TENANT_ID`,
 > `GOOGLE_CLIENT_ID`, `GOOGLE_CLIENT_SECRET`) still work as fallbacks. See
 > [Environment Variables](#environment-variables) for the full reference.

package/dist/cli.js

@@ -3301,6 +3301,8 @@ function registerOrganizeTools(server, ctx) {
 
 // src/tools/compose.ts
 import { z as z6 } from "zod";
+import { readFileSync } from "fs";
+import { basename, extname } from "path";
 function registerComposeTools(server, ctx) {
   const { store, registry, tools } = ctx;
   const sendEmailSchema = z6.object({
@@ -3506,6 +3508,31 @@ function registerComposeTools(server, ctx) {
       }
     );
   }
+  const MIME_TYPES = {
+    ".pdf": "application/pdf",
+    ".png": "image/png",
+    ".jpg": "image/jpeg",
+    ".jpeg": "image/jpeg",
+    ".gif": "image/gif",
+    ".svg": "image/svg+xml",
+    ".webp": "image/webp",
+    ".txt": "text/plain",
+    ".html": "text/html",
+    ".css": "text/css",
+    ".csv": "text/csv",
+    ".json": "application/json",
+    ".xml": "application/xml",
+    ".zip": "application/zip",
+    ".gz": "application/gzip",
+    ".tar": "application/x-tar",
+    ".doc": "application/msword",
+    ".docx": "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
+    ".xls": "application/vnd.ms-excel",
+    ".xlsx": "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
+    ".pptx": "application/vnd.openxmlformats-officedocument.presentationml.presentation",
+    ".mp3": "audio/mpeg",
+    ".mp4": "video/mp4"
+  };
   const addAttachmentOutputSchema = {
     attached: z6.literal(true),
     id: z6.string(),
@@ -3519,25 +3546,48 @@ function registerComposeTools(server, ctx) {
     server.registerTool(
       "add_attachment_to_draft",
       {
-        description: "Add a file attachment to an existing draft email by ID. `contentBytes` must be base64-encoded file content. `contentType` is the MIME type (e.g. 'application/pdf'); defaults to 'application/octet-stream' if omitted. Disabled in --read-only mode.",
-        inputSchema: {
+        description: "Add a file attachment to an existing draft email by ID. Provide exactly one of `contentBytes` (base64-encoded content) or `filePath` (absolute path to a local file). When using `filePath`, the file is read from disk and base64-encoded automatically, and `name` defaults to the file's basename if not provided. `contentType` is the MIME type (e.g. 'application/pdf'); when using `filePath` it is inferred from the extension if omitted. Disabled in --read-only mode.",
+        inputSchema: z6.object({
           account: z6.string().email(),
           id: z6.string().min(1).describe("Draft message ID"),
-          name: z6.string().min(1).describe("Attachment filename (e.g. 'report.pdf')"),
-          contentBytes: z6.string().min(1).describe("Base64-encoded file content"),
-          contentType: z6.string().optional().describe("MIME type (e.g. 'application/pdf')")
-        },
+          name: z6.string().min(1).optional().describe(
+            "Attachment filename (e.g. 'report.pdf'). Defaults to the file's basename when `filePath` is used."
+          ),
+          contentBytes: z6.string().min(1).optional().describe("Base64-encoded file content. Mutually exclusive with `filePath`."),
+          filePath: z6.string().min(1).optional().describe(
+            "Absolute path to a local file. The file is read and base64-encoded automatically. Mutually exclusive with `contentBytes`."
+          ),
+          contentType: z6.string().optional().describe("MIME type (e.g. 'application/pdf'). Inferred from `filePath` extension if omitted.")
+        }).refine(
+          (v) => Boolean(v.contentBytes) !== Boolean(v.filePath),
+          { message: "Provide exactly one of `contentBytes` or `filePath`." }
+        ),
         outputSchema: addAttachmentOutputSchema
       },
       async (args) => {
         try {
           const { provider, account } = registry.resolveByEmail(args.account);
+          let contentBytes;
+          let name;
+          let contentType = args.contentType;
+          if (args.filePath) {
+            const fileData = readFileSync(args.filePath);
+            contentBytes = fileData.toString("base64");
+            name = args.name ?? basename(args.filePath);
+            if (!contentType) {
+              const ext = extname(args.filePath).toLowerCase();
+              contentType = MIME_TYPES[ext] ?? "application/octet-stream";
+            }
+          } else {
+            contentBytes = args.contentBytes;
+            name = args.name;
+          }
           const res = await provider.addAttachmentToDraft(
             account,
             args.id,
-            args.name,
-            args.contentBytes,
-            args.contentType
+            name,
+            contentBytes,
+            contentType
           );
           const data = {
             attached: true,
@@ -3566,7 +3616,7 @@ function registerTools(server, opts) {
 // package.json
 var package_default = {
   name: "hypermail-mcp",
-  version: "0.7.1",
+  version: "0.7.2",
   description: "Unified email MCP server \u2014 operate any inbox (Outlook now, IMAP/Gmail later) by passing an email address.",
   type: "module",
   bin: {
@@ -3747,7 +3797,7 @@ var WatcherManager = class {
 };
 
 // src/config.ts
-import { readFileSync } from "fs";
+import { readFileSync as readFileSync2 } from "fs";
 import { z as z7 } from "zod";
 var httpConfigSchema = z7.object({
   enabled: z7.boolean().default(false),
@@ -3886,7 +3936,7 @@ function loadConfig(configPath, cliOverrides = {}) {
   let raw = {};
   if (configPath) {
     try {
-      raw = JSON.parse(readFileSync(configPath, "utf-8"));
+      raw = JSON.parse(readFileSync2(configPath, "utf-8"));
     } catch (err) {
       const detail = err instanceof SyntaxError ? "Invalid JSON" : err instanceof Error ? err.message : String(err);
       throw new Error(`Failed to read config file "${configPath}": ${detail}`);