@diskd-ai/email-mcp 0.3.0

package/dist/services/watcher.service.d.ts

@@ -0,0 +1,36 @@
+/**
+ * IMAP IDLE Watcher — real-time email monitoring.
+ *
+ * Maintains dedicated IMAP connections per account using IDLE to detect
+ * new emails in real-time. Emits events on the shared event bus.
+ *
+ * Key design decisions:
+ * - Separate ImapFlow connections from ConnectionManager (IDLE holds lock)
+ * - Auto-reconnect with exponential backoff on connection failures
+ * - Tracks last-seen UID per folder to detect genuinely new messages
+ */
+import type { AccountConfig, WatcherConfig } from '../types/index.js';
+export interface WatcherStatus {
+    account: string;
+    folder: string;
+    connected: boolean;
+    lastSeenUid: number;
+}
+export default class WatcherService {
+    private idleStates;
+    private config;
+    private accounts;
+    constructor(config: WatcherConfig, accounts: AccountConfig[]);
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    getStatus(): WatcherStatus[];
+    private static stateKey;
+    private updateState;
+    private startIdle;
+    private connectIdle;
+    private scheduleReconnect;
+    private handleNewEmails;
+    private static buildEmailMeta;
+    private static hasAttachments;
+}
+//# sourceMappingURL=watcher.service.d.ts.map

package/dist/services/watcher.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watcher.service.d.ts","sourceRoot":"","sources":["../../src/services/watcher.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,OAAO,KAAK,EAAE,aAAa,EAAa,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAkBjF,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,OAAO,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;CACrB;AAuBD,MAAM,CAAC,OAAO,OAAO,cAAc;IACjC,OAAO,CAAC,UAAU,CAAgC;IAElD,OAAO,CAAC,MAAM,CAAgB;IAE9B,OAAO,CAAC,QAAQ,CAAkB;gBAEtB,MAAM,EAAE,aAAa,EAAE,QAAQ,EAAE,aAAa,EAAE;IAKtD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAatB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAe3B,SAAS,IAAI,aAAa,EAAE;IAa5B,OAAO,CAAC,MAAM,CAAC,QAAQ;IAIvB,OAAO,CAAC,WAAW;YASL,SAAS;YAeT,WAAW;IAuEzB,OAAO,CAAC,iBAAiB;YAuBX,eAAe;IAiD7B,OAAO,CAAC,MAAM,CAAC,cAAc;IA+B7B,OAAO,CAAC,MAAM,CAAC,cAAc;CAM9B"}

package/dist/services/watcher.service.js

@@ -0,0 +1,241 @@
+/**
+ * IMAP IDLE Watcher — real-time email monitoring.
+ *
+ * Maintains dedicated IMAP connections per account using IDLE to detect
+ * new emails in real-time. Emits events on the shared event bus.
+ *
+ * Key design decisions:
+ * - Separate ImapFlow connections from ConnectionManager (IDLE holds lock)
+ * - Auto-reconnect with exponential backoff on connection failures
+ * - Tracks last-seen UID per folder to detect genuinely new messages
+ */
+import { ImapFlow } from 'imapflow';
+import { mcpLog } from '../logging.js';
+import eventBus from './event-bus.js';
+// ---------------------------------------------------------------------------
+// System flags excluded from label extraction
+// ---------------------------------------------------------------------------
+const SYSTEM_FLAGS = new Set([
+    '\\Seen',
+    '\\Answered',
+    '\\Flagged',
+    '\\Deleted',
+    '\\Draft',
+    '\\Recent',
+    '\\*',
+]);
+// ---------------------------------------------------------------------------
+// WatcherService
+// ---------------------------------------------------------------------------
+const MAX_BACKOFF_MS = 60_000;
+const INITIAL_BACKOFF_MS = 1_000;
+export default class WatcherService {
+    idleStates = new Map();
+    config;
+    accounts;
+    constructor(config, accounts) {
+        this.config = config;
+        this.accounts = accounts;
+    }
+    async start() {
+        if (!this.config.enabled)
+            return;
+        const { folders } = this.config;
+        const startOps = [];
+        this.accounts.forEach((account) => {
+            folders.forEach((folder) => {
+                startOps.push(this.startIdle(account, folder));
+            });
+        });
+        await Promise.allSettled(startOps);
+    }
+    async stop() {
+        const stopOps = [...this.idleStates.values()].map(async (state) => {
+            this.updateState(WatcherService.stateKey(state), { stopped: true });
+            if (state.reconnectTimer)
+                clearTimeout(state.reconnectTimer);
+            try {
+                state.lock?.release();
+                if (state.client)
+                    await state.client.logout();
+            }
+            catch {
+                /* ignore */
+            }
+        });
+        await Promise.allSettled(stopOps);
+        this.idleStates.clear();
+    }
+    getStatus() {
+        return [...this.idleStates.values()].map((state) => ({
+            account: state.account.name,
+            folder: state.folder,
+            connected: state.client?.usable === true,
+            lastSeenUid: state.lastSeenUid,
+        }));
+    }
+    // -------------------------------------------------------------------------
+    // State helpers (avoid param reassignment)
+    // -------------------------------------------------------------------------
+    static stateKey(state) {
+        return `${state.account.name}:${state.folder}`;
+    }
+    updateState(key, updates) {
+        const state = this.idleStates.get(key);
+        if (state)
+            Object.assign(state, updates);
+    }
+    // -------------------------------------------------------------------------
+    // IDLE connection lifecycle
+    // -------------------------------------------------------------------------
+    async startIdle(account, folder) {
+        const key = `${account.name}:${folder}`;
+        this.idleStates.set(key, {
+            client: null,
+            account,
+            folder,
+            lastSeenUid: 0,
+            lock: null,
+            reconnectTimer: null,
+            backoffMs: INITIAL_BACKOFF_MS,
+            stopped: false,
+        });
+        await this.connectIdle(key);
+    }
+    async connectIdle(key) {
+        const state = this.idleStates.get(key);
+        if (!state || state.stopped)
+            return;
+        try {
+            const auth = state.account.oauth2
+                ? { user: state.account.username, accessToken: state.account.password }
+                : { user: state.account.username, pass: state.account.password };
+            const client = new ImapFlow({
+                host: state.account.imap.host,
+                port: state.account.imap.port,
+                secure: state.account.imap.tls,
+                tls: { rejectUnauthorized: state.account.imap.verifySsl },
+                auth,
+                logger: false,
+                maxIdleTime: this.config.idleTimeout * 1000,
+            });
+            await client.connect();
+            const lock = await client.getMailboxLock(state.folder);
+            const { mailbox } = client;
+            const uidNext = mailbox && typeof mailbox === 'object'
+                ? (mailbox.uidNext ?? 1)
+                : 1;
+            this.updateState(key, {
+                client,
+                lock,
+                lastSeenUid: uidNext - 1,
+                backoffMs: INITIAL_BACKOFF_MS,
+            });
+            // Listen for new messages
+            client.on('exists', (data) => {
+                if (data.count > data.prevCount) {
+                    this.handleNewEmails(key).catch(() => { });
+                }
+            });
+            // Auto-reconnect on close
+            client.on('close', () => {
+                this.updateState(key, { lock: null, client: null });
+                const current = this.idleStates.get(key);
+                if (current && !current.stopped) {
+                    this.scheduleReconnect(key);
+                }
+            });
+            client.on('error', () => {
+                // Error will be followed by 'close' event
+            });
+            await mcpLog('info', 'watcher', `IDLE started: ${state.account.name}/${state.folder} (uid > ${uidNext - 1})`);
+        }
+        catch (err) {
+            const errMsg = err instanceof Error ? err.message : String(err);
+            await mcpLog('warning', 'watcher', `IDLE connect failed for ${state.account.name}/${state.folder}: ${errMsg}`);
+            this.scheduleReconnect(key);
+        }
+    }
+    scheduleReconnect(key) {
+        const state = this.idleStates.get(key);
+        if (!state || state.stopped)
+            return;
+        const { backoffMs } = state;
+        mcpLog('info', 'watcher', `Reconnecting ${state.account.name}/${state.folder} in ${backoffMs}ms`).catch(() => { });
+        const timer = setTimeout(() => {
+            this.updateState(key, { backoffMs: Math.min(backoffMs * 2, MAX_BACKOFF_MS) });
+            this.connectIdle(key).catch(() => { });
+        }, backoffMs);
+        this.updateState(key, { reconnectTimer: timer });
+    }
+    // -------------------------------------------------------------------------
+    // New email detection
+    // -------------------------------------------------------------------------
+    async handleNewEmails(key) {
+        const state = this.idleStates.get(key);
+        if (!state?.client)
+            return;
+        try {
+            const searchRange = `${state.lastSeenUid + 1}:*`;
+            const emails = [];
+            let maxUid = state.lastSeenUid;
+            // eslint-disable-next-line no-restricted-syntax -- need sequential async iteration
+            for await (const msg of state.client.fetch(searchRange, {
+                uid: true,
+                envelope: true,
+                flags: true,
+                bodyStructure: true,
+            })) {
+                if (msg.uid > state.lastSeenUid) {
+                    emails.push(WatcherService.buildEmailMeta(msg));
+                    maxUid = Math.max(maxUid, msg.uid);
+                }
+            }
+            if (maxUid > state.lastSeenUid) {
+                this.updateState(key, { lastSeenUid: maxUid });
+            }
+            if (emails.length > 0) {
+                eventBus.emit('email:new', {
+                    account: state.account.name,
+                    mailbox: state.folder,
+                    emails,
+                });
+                await mcpLog('info', 'watcher', `📬 ${emails.length} new email(s) in ${state.account.name}/${state.folder}`);
+            }
+        }
+        catch (err) {
+            const errMsg = err instanceof Error ? err.message : String(err);
+            await mcpLog('warning', 'watcher', `Failed to fetch new emails: ${errMsg}`);
+        }
+    }
+    // -------------------------------------------------------------------------
+    // Helpers
+    // -------------------------------------------------------------------------
+    static buildEmailMeta(msg) {
+        const flags = msg.flags ?? new Set();
+        const labels = [...flags].filter((f) => !SYSTEM_FLAGS.has(f));
+        const from = msg.envelope?.from?.[0];
+        const to = msg.envelope?.to ?? [];
+        return {
+            id: String(msg.uid),
+            subject: msg.envelope?.subject ?? '(no subject)',
+            from: { name: from?.name, address: from?.address ?? '' },
+            to: to.map((a) => ({ name: a.name, address: a.address ?? '' })),
+            date: msg.envelope?.date?.toISOString() ?? new Date().toISOString(),
+            seen: flags.has('\\Seen'),
+            flagged: flags.has('\\Flagged'),
+            answered: flags.has('\\Answered'),
+            hasAttachments: WatcherService.hasAttachments(msg.bodyStructure),
+            labels,
+        };
+    }
+    static hasAttachments(bodyStructure) {
+        if (!bodyStructure || typeof bodyStructure !== 'object')
+            return false;
+        const bs = bodyStructure;
+        if (bs.disposition === 'attachment')
+            return true;
+        return bs.childNodes?.some((child) => WatcherService.hasAttachments(child)) ?? false;
+    }
+}
+//# sourceMappingURL=watcher.service.js.map

package/dist/services/watcher.service.js.map

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

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

@@ -0,0 +1,7 @@
+/**
+ * MCP tool: list_accounts
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type ConnectionManager from '../connections/manager.js';
+export default function registerAccountsTools(server: McpServer, connections: ConnectionManager): void;
+//# sourceMappingURL=accounts.tool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"accounts.tool.d.ts","sourceRoot":"","sources":["../../src/tools/accounts.tool.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,KAAK,iBAAiB,MAAM,2BAA2B,CAAC;AAE/D,MAAM,CAAC,OAAO,UAAU,qBAAqB,CAC3C,MAAM,EAAE,SAAS,EACjB,WAAW,EAAE,iBAAiB,GAC7B,IAAI,CAgCN"}

package/dist/tools/accounts.tool.js

@@ -0,0 +1,29 @@
+/**
+ * MCP tool: list_accounts
+ */
+export default function registerAccountsTools(server, connections) {
+    server.tool('list_accounts', 'List all configured email accounts. Call this first to discover available account names for use with other tools.', {}, { readOnlyHint: true, destructiveHint: false }, async () => {
+        const names = connections.getAccountNames();
+        const accounts = names.map((name) => {
+            const cfg = connections.getAccount(name);
+            return {
+                name: cfg.name,
+                email: cfg.email,
+                fullName: cfg.fullName ?? null,
+            };
+        });
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: accounts.length > 0
+                        ? accounts
+                            .map((a) => `• ${a.name}: ${a.email}${a.fullName ? ` (${a.fullName})` : ''}`)
+                            .join('\n')
+                        : 'No accounts configured.',
+                },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=accounts.tool.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"accounts.tool.js","sourceRoot":"","sources":["../../src/tools/accounts.tool.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,MAAM,CAAC,OAAO,UAAU,qBAAqB,CAC3C,MAAiB,EACjB,WAA8B;IAE9B,MAAM,CAAC,IAAI,CACT,eAAe,EACf,mHAAmH,EACnH,EAAE,EACF,EAAE,YAAY,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,EAC9C,KAAK,IAAI,EAAE;QACT,MAAM,KAAK,GAAG,WAAW,CAAC,eAAe,EAAE,CAAC;QAC5C,MAAM,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;YAClC,MAAM,GAAG,GAAG,WAAW,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;YACzC,OAAO;gBACL,IAAI,EAAE,GAAG,CAAC,IAAI;gBACd,KAAK,EAAE,GAAG,CAAC,KAAK;gBAChB,QAAQ,EAAE,GAAG,CAAC,QAAQ,IAAI,IAAI;aAC/B,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAe;oBACrB,IAAI,EACF,QAAQ,CAAC,MAAM,GAAG,CAAC;wBACjB,CAAC,CAAC,QAAQ;6BACL,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;6BAC5E,IAAI,CAAC,IAAI,CAAC;wBACf,CAAC,CAAC,yBAAyB;iBAChC;aACF;SACF,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,9 @@
+/**
+ * MCP Tool: get_email_stats
+ *
+ * Provides email analytics and statistics for a mailbox.
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type ImapService from '../services/imap.service.js';
+export default function registerAnalyticsTools(server: McpServer, imapService: ImapService): void;
+//# sourceMappingURL=analytics.tool.d.ts.map

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

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

package/dist/tools/analytics.tool.js

@@ -0,0 +1,27 @@
+/**
+ * MCP Tool: get_email_stats
+ *
+ * Provides email analytics and statistics for a mailbox.
+ */
+import { z } from 'zod';
+export default function registerAnalyticsTools(server, imapService) {
+    server.tool('get_email_stats', 'Get email statistics and analytics for a mailbox. Shows volume, top senders, daily trends, and read/flagged counts.', {
+        account: z.string().describe('Account name'),
+        period: z
+            .enum(['day', 'week', 'month'])
+            .default('week')
+            .describe('Time period: day, week, or month'),
+        mailbox: z.string().default('INBOX').describe('Mailbox path (default: INBOX)'),
+    }, { readOnlyHint: true, destructiveHint: false }, async ({ account, period, mailbox }) => {
+        const stats = await imapService.getEmailStats(account, mailbox, period);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify(stats, null, 2),
+                },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=analytics.tool.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"analytics.tool.js","sourceRoot":"","sources":["../../src/tools/analytics.tool.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,MAAM,CAAC,OAAO,UAAU,sBAAsB,CAAC,MAAiB,EAAE,WAAwB;IACxF,MAAM,CAAC,IAAI,CACT,iBAAiB,EACjB,qHAAqH,EACrH;QACE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,cAAc,CAAC;QAC5C,MAAM,EAAE,CAAC;aACN,IAAI,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;aAC9B,OAAO,CAAC,MAAM,CAAC;aACf,QAAQ,CAAC,kCAAkC,CAAC;QAC/C,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,+BAA+B,CAAC;KAC/E,EACD,EAAE,YAAY,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,EAC9C,KAAK,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,EAAE;QACrC,MAAM,KAAK,GAAG,MAAM,WAAW,CAAC,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;QAExE,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;iBACrC;aACF;SACF,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"attachments.tool.d.ts","sourceRoot":"","sources":["../../src/tools/attachments.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,uBAAuB,CAAC,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,WAAW,GAAG,IAAI,CAiDjG"}

package/dist/tools/attachments.tool.js

@@ -0,0 +1,45 @@
+/**
+ * MCP tool: download_attachment
+ */
+import { z } from 'zod';
+export default function registerAttachmentTools(server, imapService) {
+    server.tool('download_attachment', 'Download an email attachment by filename. First use get_email to see available attachments and their filenames. Returns base64-encoded content for files ≤5MB.', {
+        account: z.string().describe('Account name from list_accounts'),
+        id: z.string().describe('Email ID (UID) from list_emails or get_email'),
+        mailbox: z.string().default('INBOX').describe('Mailbox containing the email'),
+        filename: z.string().describe('Exact attachment filename (from get_email metadata)'),
+    }, { readOnlyHint: true, destructiveHint: false }, async ({ account, id, mailbox, filename }) => {
+        try {
+            const result = await imapService.downloadAttachment(account, id, mailbox, filename);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            filename: result.filename,
+                            mimeType: result.mimeType,
+                            size: result.size,
+                            sizeHuman: `${Math.round(result.size / 1024)}KB`,
+                        }, null, 2),
+                    },
+                    {
+                        type: 'text',
+                        text: `\n--- Base64 Content ---\n${result.contentBase64}`,
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            return {
+                isError: true,
+                content: [
+                    {
+                        type: 'text',
+                        text: `Failed to download attachment: ${err instanceof Error ? err.message : String(err)}`,
+                    },
+                ],
+            };
+        }
+    });
+}
+//# sourceMappingURL=attachments.tool.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"attachments.tool.js","sourceRoot":"","sources":["../../src/tools/attachments.tool.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,MAAM,CAAC,OAAO,UAAU,uBAAuB,CAAC,MAAiB,EAAE,WAAwB;IACzF,MAAM,CAAC,IAAI,CACT,qBAAqB,EACrB,gKAAgK,EAChK;QACE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,iCAAiC,CAAC;QAC/D,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,8CAA8C,CAAC;QACvE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,8BAA8B,CAAC;QAC7E,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,qDAAqD,CAAC;KACrF,EACD,EAAE,YAAY,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,EAC9C,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE;QAC3C,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,kBAAkB,CAAC,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;YAEpF,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAClB;4BACE,QAAQ,EAAE,MAAM,CAAC,QAAQ;4BACzB,QAAQ,EAAE,MAAM,CAAC,QAAQ;4BACzB,IAAI,EAAE,MAAM,CAAC,IAAI;4BACjB,SAAS,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI;yBACjD,EACD,IAAI,EACJ,CAAC,CACF;qBACF;oBACD;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,6BAA6B,MAAM,CAAC,aAAa,EAAE;qBAC1D;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,kCAAkC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE;qBAC3F;iBACF;aACF,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,7 @@
+/**
+ * MCP tool: bulk_action — batch operations on multiple emails.
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type ImapService from '../services/imap.service.js';
+export default function registerBulkTools(server: McpServer, imapService: ImapService): void;
+//# sourceMappingURL=bulk.tool.d.ts.map

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

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

package/dist/tools/bulk.tool.js

@@ -0,0 +1,75 @@
+/**
+ * MCP tool: bulk_action — batch operations on multiple emails.
+ */
+import { z } from 'zod';
+import audit from '../safety/audit.js';
+export default function registerBulkTools(server, imapService) {
+    server.tool('bulk_action', 'Batch operation on multiple emails by UID list. Supports mark_read, mark_unread, flag, unflag, move, and delete. Max 100 IDs per call. Returns success/failure counts.', {
+        account: z.string().describe('Account name from list_accounts'),
+        mailbox: z.string().default('INBOX').describe('Source mailbox containing the emails'),
+        action: z
+            .enum(['mark_read', 'mark_unread', 'flag', 'unflag', 'move', 'delete'])
+            .describe('Bulk action to perform'),
+        ids: z
+            .array(z.number().int())
+            .min(1)
+            .max(100)
+            .describe('Array of email UIDs (max 100). Get UIDs from list_emails or search_emails.'),
+        destination: z
+            .string()
+            .optional()
+            .describe("Destination mailbox — required when action is 'move'"),
+    }, { readOnlyHint: false, destructiveHint: true }, async ({ account, mailbox, action, ids, destination }) => {
+        try {
+            if (action === 'move' && !destination) {
+                return {
+                    isError: true,
+                    content: [
+                        {
+                            type: 'text',
+                            text: `Destination mailbox is required for "move" action.`,
+                        },
+                    ],
+                };
+            }
+            let result;
+            if (action === 'move') {
+                result = await imapService.bulkMove(account, ids, mailbox, destination);
+            }
+            else if (action === 'delete') {
+                result = await imapService.bulkDelete(account, ids, mailbox);
+            }
+            else {
+                result = await imapService.bulkSetFlags(account, ids, mailbox, action);
+            }
+            await audit.log('bulk_action', account, {
+                mailbox,
+                action,
+                ids: ids.length,
+                destination,
+            }, 'ok');
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify(result, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            const errMsg = err instanceof Error ? err.message : String(err);
+            await audit.log('bulk_action', account, { mailbox, action, ids: ids.length }, 'error', errMsg);
+            return {
+                isError: true,
+                content: [
+                    {
+                        type: 'text',
+                        text: `Bulk action failed: ${errMsg}`,
+                    },
+                ],
+            };
+        }
+    });
+}
+//# sourceMappingURL=bulk.tool.js.map

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

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

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

@@ -0,0 +1,19 @@
+/**
+ * MCP Tools: calendar operations
+ *
+ * - extract_calendar            — parse ICS/iCalendar from email
+ * - add_to_calendar             — add email event to local calendar (with confirmation dialog + dedup)
+ * - check_calendar_permissions  — check OS calendar/reminders access
+ * - list_calendars              — list available local calendars
+ * - list_events                 — search/list local calendar events
+ * - list_reminders              — search/list reminders from Reminders.app
+ * - create_reminder             — create a reminder in macOS Reminders.app from email
+ * - analyze_email_for_scheduling — detect events + reminders in email; AI decides what to create
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type CalendarService from '../services/calendar.service.js';
+import type ImapService from '../services/imap.service.js';
+import type LocalCalendarService from '../services/local-calendar.service.js';
+import type RemindersService from '../services/reminders.service.js';
+export default function registerCalendarTools(server: McpServer, imapService: ImapService, calendarService: CalendarService, localCalendarService: LocalCalendarService, remindersService: RemindersService): void;
+//# sourceMappingURL=calendar.tool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"calendar.tool.d.ts","sourceRoot":"","sources":["../../src/tools/calendar.tool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAIzE,OAAO,KAAK,eAAe,MAAM,iCAAiC,CAAC;AACnE,OAAO,KAAK,WAAW,MAAM,6BAA6B,CAAC;AAC3D,OAAO,KAAK,oBAAoB,MAAM,uCAAuC,CAAC;AAC9E,OAAO,KAAK,gBAAgB,MAAM,kCAAkC,CAAC;AASrE,MAAM,CAAC,OAAO,UAAU,qBAAqB,CAC3C,MAAM,EAAE,SAAS,EACjB,WAAW,EAAE,WAAW,EACxB,eAAe,EAAE,eAAe,EAChC,oBAAoB,EAAE,oBAAoB,EAC1C,gBAAgB,EAAE,gBAAgB,GACjC,IAAI,CA6pBN"}