@diskd-ai/email-mcp 0.3.0

package/dist/tools/folders.tool.js

@@ -0,0 +1,111 @@
+/**
+ * MCP tools: create_mailbox, rename_mailbox, delete_mailbox
+ */
+import { z } from 'zod';
+import audit from '../safety/audit.js';
+export default function registerFolderTools(server, imapService) {
+    // ---------------------------------------------------------------------------
+    // create_mailbox
+    // ---------------------------------------------------------------------------
+    server.tool('create_mailbox', "Create a new mailbox (folder). Use '/' as separator for nested folders (e.g., 'Work/Projects'). Use list_mailboxes to see existing folders.", {
+        account: z.string().describe('Account name from list_accounts'),
+        path: z
+            .string()
+            .min(1)
+            .describe("Folder path to create (e.g., 'Archive/2026' or 'Projects')"),
+    }, { readOnlyHint: false, destructiveHint: false, idempotentHint: true }, async ({ account, path: folderPath }) => {
+        try {
+            await imapService.createMailbox(account, folderPath);
+            await audit.log('create_mailbox', account, { path: folderPath }, 'ok');
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `📁 Mailbox "${folderPath}" created.`,
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            const errMsg = err instanceof Error ? err.message : String(err);
+            await audit.log('create_mailbox', account, { path: folderPath }, 'error', errMsg);
+            return {
+                isError: true,
+                content: [
+                    {
+                        type: 'text',
+                        text: `Failed to create mailbox: ${errMsg}`,
+                    },
+                ],
+            };
+        }
+    });
+    // ---------------------------------------------------------------------------
+    // rename_mailbox
+    // ---------------------------------------------------------------------------
+    server.tool('rename_mailbox', 'Rename an existing mailbox (folder). Use list_mailboxes to see current folder paths.', {
+        account: z.string().describe('Account name from list_accounts'),
+        path: z.string().min(1).describe('Current folder path'),
+        new_path: z.string().min(1).describe('New folder path'),
+    }, { readOnlyHint: false, destructiveHint: false }, async ({ account, path: folderPath, new_path: newPath }) => {
+        try {
+            await imapService.renameMailbox(account, folderPath, newPath);
+            await audit.log('rename_mailbox', account, { path: folderPath, new_path: newPath }, 'ok');
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `📁 Mailbox renamed from "${folderPath}" to "${newPath}".`,
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            const errMsg = err instanceof Error ? err.message : String(err);
+            await audit.log('rename_mailbox', account, { path: folderPath, new_path: newPath }, 'error', errMsg);
+            return {
+                isError: true,
+                content: [
+                    {
+                        type: 'text',
+                        text: `Failed to rename mailbox: ${errMsg}`,
+                    },
+                ],
+            };
+        }
+    });
+    // ---------------------------------------------------------------------------
+    // delete_mailbox
+    // ---------------------------------------------------------------------------
+    server.tool('delete_mailbox', '⚠️ DESTRUCTIVE: Permanently delete a mailbox and ALL its contents. This cannot be undone. Use list_mailboxes to verify the folder path.', {
+        account: z.string().describe('Account name from list_accounts'),
+        path: z.string().min(1).describe('Folder path to delete (⚠️ all emails inside will be lost)'),
+    }, { readOnlyHint: false, destructiveHint: true }, async ({ account, path: folderPath }) => {
+        try {
+            await imapService.deleteMailbox(account, folderPath);
+            await audit.log('delete_mailbox', account, { path: folderPath }, 'ok');
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `⚠️ Mailbox "${folderPath}" permanently deleted.`,
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            const errMsg = err instanceof Error ? err.message : String(err);
+            await audit.log('delete_mailbox', account, { path: folderPath }, 'error', errMsg);
+            return {
+                isError: true,
+                content: [
+                    {
+                        type: 'text',
+                        text: `Failed to delete mailbox: ${errMsg}`,
+                    },
+                ],
+            };
+        }
+    });
+}
+//# sourceMappingURL=folders.tool.js.map

package/dist/tools/folders.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"folders.tool.js","sourceRoot":"","sources":["../../src/tools/folders.tool.ts"],"names":[],"mappings":"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"}

package/dist/tools/health.tool.d.ts

@@ -0,0 +1,10 @@
+/**
+ * MCP Tool: check_health
+ *
+ * Connection health diagnostics for email accounts.
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type ConnectionManager from '../connections/manager.js';
+import type ImapService from '../services/imap.service.js';
+export default function registerHealthTools(server: McpServer, connections: ConnectionManager, imapService: ImapService): void;
+//# sourceMappingURL=health.tool.d.ts.map

package/dist/tools/health.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.tool.d.ts","sourceRoot":"","sources":["../../src/tools/health.tool.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGzE,OAAO,KAAK,iBAAiB,MAAM,2BAA2B,CAAC;AAC/D,OAAO,KAAK,WAAW,MAAM,6BAA6B,CAAC;AAE3D,MAAM,CAAC,OAAO,UAAU,mBAAmB,CACzC,MAAM,EAAE,SAAS,EACjB,WAAW,EAAE,iBAAiB,EAC9B,WAAW,EAAE,WAAW,GACvB,IAAI,CAqFN"}

package/dist/tools/health.tool.js

@@ -0,0 +1,78 @@
+/**
+ * MCP Tool: check_health
+ *
+ * Connection health diagnostics for email accounts.
+ */
+import { z } from 'zod';
+export default function registerHealthTools(server, connections, imapService) {
+    server.tool('check_health', 'Check connection health, quota, and capabilities for email accounts. Useful for diagnosing issues.', {
+        account: z.string().optional().describe('Account name (checks all accounts if omitted)'),
+    }, { readOnlyHint: true, destructiveHint: false }, async ({ account }) => {
+        const names = account ? [account] : connections.getAccountNames();
+        const results = await Promise.all(names.map(async (name) => {
+            const cfg = connections.getAccount(name);
+            const result = {
+                name,
+                auth_type: cfg.oauth2 ? 'oauth2' : 'password',
+            };
+            // IMAP health
+            try {
+                const start = Date.now();
+                await connections.getImapClient(name);
+                const latency = Date.now() - start;
+                const capabilities = await imapService.getCapabilities(name);
+                const quota = await imapService.getQuota(name);
+                result.imap = {
+                    connected: true,
+                    latency_ms: latency,
+                    host: cfg.imap.host,
+                    capabilities: capabilities.slice(0, 20),
+                    tls: cfg.imap.tls,
+                };
+                if (quota) {
+                    result.quota = {
+                        used_mb: quota.usedMb,
+                        total_mb: quota.totalMb,
+                        percentage: quota.percentage,
+                    };
+                }
+            }
+            catch (err) {
+                result.imap = {
+                    connected: false,
+                    error: err instanceof Error ? err.message : String(err),
+                    host: cfg.imap.host,
+                };
+            }
+            // SMTP health
+            try {
+                const start = Date.now();
+                await connections.verifySmtpTransport(name);
+                const latency = Date.now() - start;
+                result.smtp = {
+                    connected: true,
+                    latency_ms: latency,
+                    host: cfg.smtp.host,
+                    tls: cfg.smtp.tls,
+                };
+            }
+            catch (err) {
+                result.smtp = {
+                    connected: false,
+                    error: err instanceof Error ? err.message : String(err),
+                    host: cfg.smtp.host,
+                };
+            }
+            return result;
+        }));
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({ accounts: results }, null, 2),
+                },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=health.tool.js.map

package/dist/tools/health.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.tool.js","sourceRoot":"","sources":["../../src/tools/health.tool.ts"],"names":[],"mappings":"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"}

package/dist/tools/label.tool.d.ts

@@ -0,0 +1,11 @@
+/**
+ * MCP tools: list_labels, add_label, remove_label, create_label, delete_label
+ *
+ * Provider-aware label management. Automatically detects whether the account
+ * uses ProtonMail (folder-based labels), Gmail (X-GM-LABELS), or standard
+ * IMAP keywords, and applies the correct strategy.
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type ImapService from '../services/imap.service.js';
+export default function registerLabelTools(server: McpServer, imapService: ImapService): void;
+//# sourceMappingURL=label.tool.d.ts.map

package/dist/tools/label.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"label.tool.d.ts","sourceRoot":"","sources":["../../src/tools/label.tool.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAKzE,OAAO,KAAK,WAAW,MAAM,6BAA6B,CAAC;AAE3D,MAAM,CAAC,OAAO,UAAU,kBAAkB,CAAC,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,WAAW,GAAG,IAAI,CAyL5F"}

package/dist/tools/label.tool.js

@@ -0,0 +1,165 @@
+/**
+ * MCP tools: list_labels, add_label, remove_label, create_label, delete_label
+ *
+ * Provider-aware label management. Automatically detects whether the account
+ * uses ProtonMail (folder-based labels), Gmail (X-GM-LABELS), or standard
+ * IMAP keywords, and applies the correct strategy.
+ */
+import { z } from 'zod';
+import audit from '../safety/audit.js';
+import { validateLabelName } from '../safety/validation.js';
+export default function registerLabelTools(server, imapService) {
+    // ---------------------------------------------------------------------------
+    // list_labels
+    // ---------------------------------------------------------------------------
+    server.tool('list_labels', 'List available labels for an email account. ' +
+        'Auto-detects the label system: ProtonMail folder-labels, Gmail X-GM-LABELS, or IMAP keywords. ' +
+        'ProtonMail note: labels are represented as IMAP folders under the Labels/ prefix. ' +
+        'Use list_emails with mailbox="Labels/<name>" to find emails tagged with a ProtonMail label.', {
+        account: z.string().describe('Account name from list_accounts'),
+    }, { readOnlyHint: true }, async ({ account }) => {
+        try {
+            const labels = await imapService.listLabels(account);
+            if (labels.length === 0) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: 'No labels found. Use create_label to create one.',
+                        },
+                    ],
+                };
+            }
+            const { strategy } = labels[0];
+            const lines = [
+                `🏷️ ${labels.length} label(s) — strategy: ${strategy}`,
+                '',
+                ...labels.map((l) => `  • ${l.name}${l.path ? ` (${l.path})` : ''}`),
+            ];
+            return {
+                content: [{ type: 'text', text: lines.join('\n') }],
+            };
+        }
+        catch (err) {
+            const errMsg = err instanceof Error ? err.message : String(err);
+            return {
+                isError: true,
+                content: [{ type: 'text', text: `Failed to list labels: ${errMsg}` }],
+            };
+        }
+    });
+    // ---------------------------------------------------------------------------
+    // add_label
+    // ---------------------------------------------------------------------------
+    server.tool('add_label', 'Add a label to an email. ' +
+        'For ProtonMail, this copies the email into the corresponding Labels/<name> folder. ' +
+        'For Gmail and standard IMAP, this sets a keyword flag on the message.', {
+        account: z.string().describe('Account name from list_accounts'),
+        emailId: z.string().describe('Email ID (UID) from list_emails'),
+        mailbox: z.string().describe('Mailbox containing the email (must be a real folder)'),
+        label: z.string().describe('Label name to add (e.g., "Important", "Project-X")'),
+    }, { readOnlyHint: false, destructiveHint: false, idempotentHint: true }, async ({ account, emailId, mailbox, label }) => {
+        try {
+            const cleanLabel = validateLabelName(label);
+            await imapService.addLabel(account, emailId, mailbox, cleanLabel);
+            await audit.log('add_label', account, { emailId, mailbox, label: cleanLabel }, 'ok');
+            return {
+                content: [
+                    { type: 'text', text: `🏷️ Label "${label}" added to email ${emailId}.` },
+                ],
+            };
+        }
+        catch (err) {
+            const errMsg = err instanceof Error ? err.message : String(err);
+            await audit.log('add_label', account, { emailId, mailbox, label }, 'error', errMsg);
+            return {
+                isError: true,
+                content: [{ type: 'text', text: `Failed to add label: ${errMsg}` }],
+            };
+        }
+    });
+    // ---------------------------------------------------------------------------
+    // remove_label
+    // ---------------------------------------------------------------------------
+    server.tool('remove_label', 'Remove a label from an email. For ProtonMail, this removes the email from the label folder. ' +
+        'For Gmail and standard IMAP, this removes a keyword flag.', {
+        account: z.string().describe('Account name from list_accounts'),
+        emailId: z.string().describe('Email ID (UID) from list_emails'),
+        mailbox: z.string().describe('Mailbox containing the email (must be a real folder)'),
+        label: z.string().describe('Label name to remove'),
+    }, { readOnlyHint: false, destructiveHint: false, idempotentHint: true }, async ({ account, emailId, mailbox, label }) => {
+        try {
+            const cleanLabel = validateLabelName(label);
+            await imapService.removeLabel(account, emailId, mailbox, cleanLabel);
+            await audit.log('remove_label', account, { emailId, mailbox, label: cleanLabel }, 'ok');
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `🏷️ Label "${label}" removed from email ${emailId}.`,
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            const errMsg = err instanceof Error ? err.message : String(err);
+            await audit.log('remove_label', account, { emailId, mailbox, label }, 'error', errMsg);
+            return {
+                isError: true,
+                content: [{ type: 'text', text: `Failed to remove label: ${errMsg}` }],
+            };
+        }
+    });
+    // ---------------------------------------------------------------------------
+    // create_label
+    // ---------------------------------------------------------------------------
+    server.tool('create_label', 'Create a new label. For ProtonMail, creates a folder under Labels/. ' +
+        'For standard IMAP keywords, labels are auto-created on first use — this is a no-op.', {
+        account: z.string().describe('Account name from list_accounts'),
+        name: z
+            .string()
+            .describe('Label name (e.g., "Project-X"). For nested labels use "/" separator (e.g., "Work/Urgent").'),
+    }, { readOnlyHint: false, destructiveHint: false }, async ({ account, name }) => {
+        try {
+            const cleanName = validateLabelName(name);
+            await imapService.createLabel(account, cleanName);
+            await audit.log('create_label', account, { name: cleanName }, 'ok');
+            return {
+                content: [{ type: 'text', text: `🏷️ Label "${name}" created.` }],
+            };
+        }
+        catch (err) {
+            const errMsg = err instanceof Error ? err.message : String(err);
+            await audit.log('create_label', account, { name }, 'error', errMsg);
+            return {
+                isError: true,
+                content: [{ type: 'text', text: `Failed to create label: ${errMsg}` }],
+            };
+        }
+    });
+    // ---------------------------------------------------------------------------
+    // delete_label
+    // ---------------------------------------------------------------------------
+    server.tool('delete_label', 'Delete a label. For ProtonMail, deletes the label folder. ' +
+        'For standard IMAP keywords, labels cannot be deleted server-wide — use remove_label on individual emails.', {
+        account: z.string().describe('Account name from list_accounts'),
+        name: z.string().describe('Label name to delete'),
+    }, { readOnlyHint: false, destructiveHint: true }, async ({ account, name }) => {
+        try {
+            await imapService.deleteLabel(account, name);
+            await audit.log('delete_label', account, { name }, 'ok');
+            return {
+                content: [{ type: 'text', text: `🏷️ Label "${name}" deleted.` }],
+            };
+        }
+        catch (err) {
+            const errMsg = err instanceof Error ? err.message : String(err);
+            await audit.log('delete_label', account, { name }, 'error', errMsg);
+            return {
+                isError: true,
+                content: [{ type: 'text', text: `Failed to delete label: ${errMsg}` }],
+            };
+        }
+    });
+}
+//# sourceMappingURL=label.tool.js.map

package/dist/tools/label.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"label.tool.js","sourceRoot":"","sources":["../../src/tools/label.tool.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,MAAM,oBAAoB,CAAC;AACvC,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAI5D,MAAM,CAAC,OAAO,UAAU,kBAAkB,CAAC,MAAiB,EAAE,WAAwB;IACpF,8EAA8E;IAC9E,cAAc;IACd,8EAA8E;IAC9E,MAAM,CAAC,IAAI,CACT,aAAa,EACb,8CAA8C;QAC5C,gGAAgG;QAChG,oFAAoF;QACpF,6FAA6F,EAC/F;QACE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,iCAAiC,CAAC;KAChE,EACD,EAAE,YAAY,EAAE,IAAI,EAAE,EACtB,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE;QACpB,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;YACrD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACxB,OAAO;oBACL,OAAO,EAAE;wBACP;4BACE,IAAI,EAAE,MAAe;4BACrB,IAAI,EAAE,kDAAkD;yBACzD;qBACF;iBACF,CAAC;YACJ,CAAC;YAED,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;YAC/B,MAAM,KAAK,GAAG;gBACZ,OAAO,MAAM,CAAC,MAAM,yBAAyB,QAAQ,EAAE;gBACvD,EAAE;gBACF,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;aACrE,CAAC;YACF,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;aAC7D,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,MAAM,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAChE,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,0BAA0B,MAAM,EAAE,EAAE,CAAC;aAC/E,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;IAEF,8EAA8E;IAC9E,YAAY;IACZ,8EAA8E;IAC9E,MAAM,CAAC,IAAI,CACT,WAAW,EACX,2BAA2B;QACzB,qFAAqF;QACrF,uEAAuE,EACzE;QACE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,iCAAiC,CAAC;QAC/D,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,iCAAiC,CAAC;QAC/D,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,sDAAsD,CAAC;QACpF,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,oDAAoD,CAAC;KACjF,EACD,EAAE,YAAY,EAAE,KAAK,EAAE,eAAe,EAAE,KAAK,EAAE,cAAc,EAAE,IAAI,EAAE,EACrE,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE;QAC7C,IAAI,CAAC;YACH,MAAM,UAAU,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAC;YAC5C,MAAM,WAAW,CAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC;YAClE,MAAM,KAAK,CAAC,GAAG,CAAC,WAAW,EAAE,OAAO,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,EAAE,IAAI,CAAC,CAAC;YACrF,OAAO;gBACL,OAAO,EAAE;oBACP,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,cAAc,KAAK,oBAAoB,OAAO,GAAG,EAAE;iBACnF;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,MAAM,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAChE,MAAM,KAAK,CAAC,GAAG,CAAC,WAAW,EAAE,OAAO,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;YACpF,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,wBAAwB,MAAM,EAAE,EAAE,CAAC;aAC7E,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;IAEF,8EAA8E;IAC9E,eAAe;IACf,8EAA8E;IAC9E,MAAM,CAAC,IAAI,CACT,cAAc,EACd,8FAA8F;QAC5F,2DAA2D,EAC7D;QACE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,iCAAiC,CAAC;QAC/D,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,iCAAiC,CAAC;QAC/D,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,sDAAsD,CAAC;QACpF,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,sBAAsB,CAAC;KACnD,EACD,EAAE,YAAY,EAAE,KAAK,EAAE,eAAe,EAAE,KAAK,EAAE,cAAc,EAAE,IAAI,EAAE,EACrE,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE;QAC7C,IAAI,CAAC;YACH,MAAM,UAAU,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAC;YAC5C,MAAM,WAAW,CAAC,WAAW,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC;YACrE,MAAM,KAAK,CAAC,GAAG,CAAC,cAAc,EAAE,OAAO,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,EAAE,IAAI,CAAC,CAAC;YACxF,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,cAAc,KAAK,wBAAwB,OAAO,GAAG;qBAC5D;iBACF;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,MAAM,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAChE,MAAM,KAAK,CAAC,GAAG,CAAC,cAAc,EAAE,OAAO,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;YACvF,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,2BAA2B,MAAM,EAAE,EAAE,CAAC;aAChF,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;IAEF,8EAA8E;IAC9E,eAAe;IACf,8EAA8E;IAC9E,MAAM,CAAC,IAAI,CACT,cAAc,EACd,sEAAsE;QACpE,qFAAqF,EACvF;QACE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,iCAAiC,CAAC;QAC/D,IAAI,EAAE,CAAC;aACJ,MAAM,EAAE;aACR,QAAQ,CACP,4FAA4F,CAC7F;KACJ,EACD,EAAE,YAAY,EAAE,KAAK,EAAE,eAAe,EAAE,KAAK,EAAE,EAC/C,KAAK,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE;QAC1B,IAAI,CAAC;YACH,MAAM,SAAS,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC;YAC1C,MAAM,WAAW,CAAC,WAAW,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;YAClD,MAAM,KAAK,CAAC,GAAG,CAAC,cAAc,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,IAAI,CAAC,CAAC;YACpE,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,cAAc,IAAI,YAAY,EAAE,CAAC;aAC3E,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,MAAM,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAChE,MAAM,KAAK,CAAC,GAAG,CAAC,cAAc,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;YACpE,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,2BAA2B,MAAM,EAAE,EAAE,CAAC;aAChF,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;IAEF,8EAA8E;IAC9E,eAAe;IACf,8EAA8E;IAC9E,MAAM,CAAC,IAAI,CACT,cAAc,EACd,4DAA4D;QAC1D,2GAA2G,EAC7G;QACE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,iCAAiC,CAAC;QAC/D,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,sBAAsB,CAAC;KAClD,EACD,EAAE,YAAY,EAAE,KAAK,EAAE,eAAe,EAAE,IAAI,EAAE,EAC9C,KAAK,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE;QAC1B,IAAI,CAAC;YACH,MAAM,WAAW,CAAC,WAAW,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;YAC7C,MAAM,KAAK,CAAC,GAAG,CAAC,cAAc,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,EAAE,IAAI,CAAC,CAAC;YACzD,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,cAAc,IAAI,YAAY,EAAE,CAAC;aAC3E,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,MAAM,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAChE,MAAM,KAAK,CAAC,GAAG,CAAC,cAAc,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;YACpE,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,2BAA2B,MAAM,EAAE,EAAE,CAAC;aAChF,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/locate.tool.d.ts

@@ -0,0 +1,11 @@
+/**
+ * MCP tool: find_email_folder
+ *
+ * Locates the real mailbox folder(s) containing an email.
+ * Essential when working with virtual folders like "All Mail" or "Starred",
+ * which don't support IMAP MOVE operations.
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type ImapService from '../services/imap.service.js';
+export default function registerLocateTools(server: McpServer, imapService: ImapService): void;
+//# sourceMappingURL=locate.tool.d.ts.map

package/dist/tools/locate.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"locate.tool.d.ts","sourceRoot":"","sources":["../../src/tools/locate.tool.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGzE,OAAO,KAAK,WAAW,MAAM,6BAA6B,CAAC;AAE3D,MAAM,CAAC,OAAO,UAAU,mBAAmB,CAAC,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,WAAW,GAAG,IAAI,CA6D7F"}

package/dist/tools/locate.tool.js

@@ -0,0 +1,59 @@
+/**
+ * MCP tool: find_email_folder
+ *
+ * Locates the real mailbox folder(s) containing an email.
+ * Essential when working with virtual folders like "All Mail" or "Starred",
+ * which don't support IMAP MOVE operations.
+ */
+import { z } from 'zod';
+export default function registerLocateTools(server, imapService) {
+    server.tool('find_email_folder', 'Find which real mailbox folder(s) an email belongs to. ' +
+        'Required before move_email or delete_email when the email was found in a virtual folder ' +
+        '(e.g., "All Mail", "Starred"). Returns the real folder path to use as sourceMailbox.', {
+        account: z.string().describe('Account name from list_accounts'),
+        emailId: z.string().describe('Email ID (UID) from list_emails'),
+        sourceMailbox: z
+            .string()
+            .default('INBOX')
+            .describe('Mailbox where the email is currently visible (e.g., "All Mail")'),
+    }, { readOnlyHint: true }, async ({ account, emailId, sourceMailbox }) => {
+        try {
+            const { folders, messageId } = await imapService.findEmailFolder(account, emailId, sourceMailbox);
+            if (folders.length === 0) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `No real folder found for email ${emailId}. It may only exist in virtual folders.`,
+                        },
+                    ],
+                };
+            }
+            const lines = [
+                `📁 Email ${emailId} found in ${folders.length} folder(s):`,
+                ...folders.map((f) => `  • ${f}`),
+                '',
+                `Use the first folder as sourceMailbox for move_email or delete_email.`,
+            ];
+            if (messageId) {
+                lines.push(`Message-ID: ${messageId}`);
+            }
+            return {
+                content: [{ type: 'text', text: lines.join('\n') }],
+            };
+        }
+        catch (err) {
+            const errMsg = err instanceof Error ? err.message : String(err);
+            return {
+                isError: true,
+                content: [
+                    {
+                        type: 'text',
+                        text: `Failed to locate email: ${errMsg}`,
+                    },
+                ],
+            };
+        }
+    });
+}
+//# sourceMappingURL=locate.tool.js.map

package/dist/tools/locate.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"locate.tool.js","sourceRoot":"","sources":["../../src/tools/locate.tool.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,MAAM,CAAC,OAAO,UAAU,mBAAmB,CAAC,MAAiB,EAAE,WAAwB;IACrF,MAAM,CAAC,IAAI,CACT,mBAAmB,EACnB,yDAAyD;QACvD,0FAA0F;QAC1F,sFAAsF,EACxF;QACE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,iCAAiC,CAAC;QAC/D,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,iCAAiC,CAAC;QAC/D,aAAa,EAAE,CAAC;aACb,MAAM,EAAE;aACR,OAAO,CAAC,OAAO,CAAC;aAChB,QAAQ,CAAC,iEAAiE,CAAC;KAC/E,EACD,EAAE,YAAY,EAAE,IAAI,EAAE,EACtB,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,EAAE,EAAE;QAC5C,IAAI,CAAC;YACH,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,MAAM,WAAW,CAAC,eAAe,CAC9D,OAAO,EACP,OAAO,EACP,aAAa,CACd,CAAC;YAEF,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACzB,OAAO;oBACL,OAAO,EAAE;wBACP;4BACE,IAAI,EAAE,MAAe;4BACrB,IAAI,EAAE,kCAAkC,OAAO,yCAAyC;yBACzF;qBACF;iBACF,CAAC;YACJ,CAAC;YAED,MAAM,KAAK,GAAG;gBACZ,YAAY,OAAO,aAAa,OAAO,CAAC,MAAM,aAAa;gBAC3D,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;gBACjC,EAAE;gBACF,uEAAuE;aACxE,CAAC;YACF,IAAI,SAAS,EAAE,CAAC;gBACd,KAAK,CAAC,IAAI,CAAC,eAAe,SAAS,EAAE,CAAC,CAAC;YACzC,CAAC;YAED,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;aAC7D,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,MAAM,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAChE,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,2BAA2B,MAAM,EAAE;qBAC1C;iBACF;aACF,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/mailboxes.tool.d.ts

@@ -0,0 +1,7 @@
+/**
+ * MCP tool: list_mailboxes
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type ImapService from '../services/imap.service.js';
+export default function registerMailboxesTools(server: McpServer, imapService: ImapService): void;
+//# sourceMappingURL=mailboxes.tool.d.ts.map

package/dist/tools/mailboxes.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mailboxes.tool.d.ts","sourceRoot":"","sources":["../../src/tools/mailboxes.tool.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGzE,OAAO,KAAK,WAAW,MAAM,6BAA6B,CAAC;AAE3D,MAAM,CAAC,OAAO,UAAU,sBAAsB,CAAC,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,WAAW,GAAG,IAAI,CAuChG"}

package/dist/tools/mailboxes.tool.js

@@ -0,0 +1,38 @@
+/**
+ * MCP tool: list_mailboxes
+ */
+import { z } from 'zod';
+export default function registerMailboxesTools(server, imapService) {
+    server.tool('list_mailboxes', 'List all mailbox folders for an account with unread counts and special-use flags. Use list_accounts first to get the account name.', {
+        account: z.string().describe('Account name from list_accounts'),
+    }, { readOnlyHint: true, destructiveHint: false }, async ({ account }) => {
+        try {
+            const mailboxes = await imapService.listMailboxes(account);
+            const lines = mailboxes.map((mb) => {
+                const badge = mb.unseenMessages > 0 ? ` (${mb.unseenMessages} unread)` : '';
+                const special = mb.specialUse ? ` [${mb.specialUse}]` : '';
+                return `• ${mb.path}${special} — ${mb.totalMessages} messages${badge}`;
+            });
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: lines.join('\n') || 'No mailboxes found.',
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            return {
+                isError: true,
+                content: [
+                    {
+                        type: 'text',
+                        text: `Failed to list mailboxes: ${err instanceof Error ? err.message : String(err)}`,
+                    },
+                ],
+            };
+        }
+    });
+}
+//# sourceMappingURL=mailboxes.tool.js.map

package/dist/tools/mailboxes.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mailboxes.tool.js","sourceRoot":"","sources":["../../src/tools/mailboxes.tool.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,MAAM,CAAC,OAAO,UAAU,sBAAsB,CAAC,MAAiB,EAAE,WAAwB;IACxF,MAAM,CAAC,IAAI,CACT,gBAAgB,EAChB,oIAAoI,EACpI;QACE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,iCAAiC,CAAC;KAChE,EACD,EAAE,YAAY,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,EAC9C,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE;QACpB,IAAI,CAAC;YACH,MAAM,SAAS,GAAG,MAAM,WAAW,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;YAE3D,MAAM,KAAK,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE;gBACjC,MAAM,KAAK,GAAG,EAAE,CAAC,cAAc,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,cAAc,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC5E,MAAM,OAAO,GAAG,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC3D,OAAO,KAAK,EAAE,CAAC,IAAI,GAAG,OAAO,MAAM,EAAE,CAAC,aAAa,YAAY,KAAK,EAAE,CAAC;YACzE,CAAC,CAAC,CAAC;YAEH,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,qBAAqB;qBAChD;iBACF;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,6BAA6B,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE;qBACtF;iBACF;aACF,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/manage.tool.d.ts

@@ -0,0 +1,7 @@
+/**
+ * MCP tools: move_email, delete_email, mark_email
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type ImapService from '../services/imap.service.js';
+export default function registerManageTools(server: McpServer, imapService: ImapService): void;
+//# sourceMappingURL=manage.tool.d.ts.map

package/dist/tools/manage.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manage.tool.d.ts","sourceRoot":"","sources":["../../src/tools/manage.tool.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAKzE,OAAO,KAAK,WAAW,MAAM,6BAA6B,CAAC;AAE3D,MAAM,CAAC,OAAO,UAAU,mBAAmB,CAAC,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,WAAW,GAAG,IAAI,CAiJ7F"}