@n24q02m/better-email-mcp 1.0.0

package/build/src/tools/composite/messages.js

@@ -0,0 +1,244 @@
+/**
+ * Messages Mega Tool
+ * All email message operations in one unified interface
+ */
+import { EmailMCPError, withErrorHandling } from '../helpers/errors.js';
+import { listFolders, modifyFlags, moveEmails, readEmail, searchEmails, trashEmails } from '../helpers/imap-client.js';
+/**
+ * Resolve target accounts from input
+ */
+function resolveAccounts(accounts, accountFilter) {
+    if (!accountFilter)
+        return accounts;
+    const lower = accountFilter.toLowerCase();
+    const matched = accounts.filter((a) => a.email.toLowerCase() === lower || a.id === lower || a.email.toLowerCase().includes(lower));
+    if (matched.length === 0) {
+        throw new EmailMCPError(`Account not found: ${accountFilter}`, 'ACCOUNT_NOT_FOUND', `Available accounts: ${accounts.map((a) => a.email).join(', ')}`);
+    }
+    return matched;
+}
+/**
+ * Resolve a single account (for operations that require exactly one)
+ */
+function resolveSingleAccount(accounts, accountFilter) {
+    const resolved = resolveAccounts(accounts, accountFilter);
+    if (resolved.length > 1) {
+        throw new EmailMCPError('Multiple accounts matched. Specify the exact account email.', 'AMBIGUOUS_ACCOUNT', `Matched: ${resolved.map((a) => a.email).join(', ')}`);
+    }
+    return resolved[0];
+}
+/**
+ * Unified messages tool - handles all message operations
+ */
+export async function messages(accounts, input) {
+    return withErrorHandling(async () => {
+        switch (input.action) {
+            case 'search':
+                return await handleSearch(accounts, input);
+            case 'read':
+                return await handleRead(accounts, input);
+            case 'mark_read':
+                return await handleMarkRead(accounts, input);
+            case 'mark_unread':
+                return await handleMarkUnread(accounts, input);
+            case 'flag':
+                return await handleFlag(accounts, input);
+            case 'unflag':
+                return await handleUnflag(accounts, input);
+            case 'move':
+                return await handleMove(accounts, input);
+            case 'archive':
+                return await handleArchive(accounts, input);
+            case 'trash':
+                return await handleTrash(accounts, input);
+            default:
+                throw new EmailMCPError(`Unknown action: ${input.action}`, 'VALIDATION_ERROR', 'Supported actions: search, read, mark_read, mark_unread, flag, unflag, move, archive, trash');
+        }
+    })();
+}
+/**
+ * Search emails across accounts
+ */
+async function handleSearch(accounts, input) {
+    const targetAccounts = resolveAccounts(accounts, input.account);
+    const query = input.query || 'UNSEEN';
+    const folder = input.folder || 'INBOX';
+    const limit = input.limit || 20;
+    const results = await searchEmails(targetAccounts, query, folder, limit);
+    return {
+        action: 'search',
+        query,
+        folder,
+        total: results.length,
+        accounts_searched: targetAccounts.map((a) => a.email),
+        messages: results
+    };
+}
+/**
+ * Read a single email by UID
+ */
+async function handleRead(accounts, input) {
+    if (!input.uid) {
+        throw new EmailMCPError('uid is required for read action', 'VALIDATION_ERROR', 'Provide the email UID from search');
+    }
+    const account = resolveSingleAccount(accounts, input.account);
+    const folder = input.folder || 'INBOX';
+    const email = await readEmail(account, input.uid, folder);
+    return {
+        action: 'read',
+        ...email
+    };
+}
+/**
+ * Mark emails as read
+ */
+async function handleMarkRead(accounts, input) {
+    const uids = input.uids || (input.uid ? [input.uid] : []);
+    if (uids.length === 0) {
+        throw new EmailMCPError('uid or uids required', 'VALIDATION_ERROR', 'Provide at least one email UID');
+    }
+    const account = resolveSingleAccount(accounts, input.account);
+    const folder = input.folder || 'INBOX';
+    const result = await modifyFlags(account, uids, folder, ['\\Seen'], 'add');
+    return {
+        action: 'mark_read',
+        account: account.email,
+        folder,
+        ...result
+    };
+}
+/**
+ * Mark emails as unread
+ */
+async function handleMarkUnread(accounts, input) {
+    const uids = input.uids || (input.uid ? [input.uid] : []);
+    if (uids.length === 0) {
+        throw new EmailMCPError('uid or uids required', 'VALIDATION_ERROR', 'Provide at least one email UID');
+    }
+    const account = resolveSingleAccount(accounts, input.account);
+    const folder = input.folder || 'INBOX';
+    const result = await modifyFlags(account, uids, folder, ['\\Seen'], 'remove');
+    return {
+        action: 'mark_unread',
+        account: account.email,
+        folder,
+        ...result
+    };
+}
+/**
+ * Flag (star) emails
+ */
+async function handleFlag(accounts, input) {
+    const uids = input.uids || (input.uid ? [input.uid] : []);
+    if (uids.length === 0) {
+        throw new EmailMCPError('uid or uids required', 'VALIDATION_ERROR', 'Provide at least one email UID');
+    }
+    const account = resolveSingleAccount(accounts, input.account);
+    const folder = input.folder || 'INBOX';
+    const result = await modifyFlags(account, uids, folder, ['\\Flagged'], 'add');
+    return {
+        action: 'flag',
+        account: account.email,
+        folder,
+        ...result
+    };
+}
+/**
+ * Unflag (unstar) emails
+ */
+async function handleUnflag(accounts, input) {
+    const uids = input.uids || (input.uid ? [input.uid] : []);
+    if (uids.length === 0) {
+        throw new EmailMCPError('uid or uids required', 'VALIDATION_ERROR', 'Provide at least one email UID');
+    }
+    const account = resolveSingleAccount(accounts, input.account);
+    const folder = input.folder || 'INBOX';
+    const result = await modifyFlags(account, uids, folder, ['\\Flagged'], 'remove');
+    return {
+        action: 'unflag',
+        account: account.email,
+        folder,
+        ...result
+    };
+}
+/**
+ * Move emails to another folder
+ */
+async function handleMove(accounts, input) {
+    const uids = input.uids || (input.uid ? [input.uid] : []);
+    if (uids.length === 0) {
+        throw new EmailMCPError('uid or uids required', 'VALIDATION_ERROR', 'Provide at least one email UID');
+    }
+    if (!input.destination) {
+        throw new EmailMCPError('destination is required for move action', 'VALIDATION_ERROR', 'Provide the target folder name. Use folders tool to list available folders.');
+    }
+    const account = resolveSingleAccount(accounts, input.account);
+    const folder = input.folder || 'INBOX';
+    const result = await moveEmails(account, uids, folder, input.destination);
+    return {
+        action: 'move',
+        account: account.email,
+        from_folder: folder,
+        to_folder: input.destination,
+        ...result
+    };
+}
+/**
+ * Archive emails (move to archive folder)
+ */
+async function handleArchive(accounts, input) {
+    const uids = input.uids || (input.uid ? [input.uid] : []);
+    if (uids.length === 0) {
+        throw new EmailMCPError('uid or uids required', 'VALIDATION_ERROR', 'Provide at least one email UID');
+    }
+    const account = resolveSingleAccount(accounts, input.account);
+    const folder = input.folder || 'INBOX';
+    // Detect archive folder based on provider
+    let archiveFolder = '[Gmail]/All Mail';
+    if (account.imap.host.includes('office365') || account.imap.host.includes('outlook')) {
+        archiveFolder = 'Archive';
+    }
+    else if (account.imap.host.includes('yahoo')) {
+        archiveFolder = 'Archive';
+    }
+    // Try to find actual archive folder
+    try {
+        const folders = await listFolders(account);
+        const found = folders.find((f) => f.path.toLowerCase().includes('archive') ||
+            f.path.toLowerCase().includes('all mail') ||
+            f.flags.some((flag) => flag.toLowerCase().includes('archive') || flag.toLowerCase().includes('all')));
+        if (found) {
+            archiveFolder = found.path;
+        }
+    }
+    catch {
+        // Use default if folder listing fails
+    }
+    const result = await moveEmails(account, uids, folder, archiveFolder);
+    return {
+        action: 'archive',
+        account: account.email,
+        from_folder: folder,
+        archive_folder: archiveFolder,
+        ...result
+    };
+}
+/**
+ * Trash emails
+ */
+async function handleTrash(accounts, input) {
+    const uids = input.uids || (input.uid ? [input.uid] : []);
+    if (uids.length === 0) {
+        throw new EmailMCPError('uid or uids required', 'VALIDATION_ERROR', 'Provide at least one email UID');
+    }
+    const account = resolveSingleAccount(accounts, input.account);
+    const folder = input.folder || 'INBOX';
+    const result = await trashEmails(account, uids, folder);
+    return {
+        action: 'trash',
+        account: account.email,
+        folder,
+        ...result
+    };
+}
+//# sourceMappingURL=messages.js.map

package/build/src/tools/composite/messages.js.map

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

package/build/src/tools/composite/messages.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=messages.test.d.ts.map

package/build/src/tools/composite/messages.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.test.d.ts","sourceRoot":"","sources":["../../../../src/tools/composite/messages.test.ts"],"names":[],"mappings":""}

package/build/src/tools/composite/messages.test.js

@@ -0,0 +1,217 @@
+import { beforeEach, describe, expect, it, vi } from 'vitest';
+// --- Mocks ---
+vi.mock('../helpers/imap-client.js', () => ({
+    searchEmails: vi.fn(),
+    readEmail: vi.fn(),
+    modifyFlags: vi.fn(),
+    moveEmails: vi.fn(),
+    trashEmails: vi.fn(),
+    listFolders: vi.fn()
+}));
+import { listFolders, modifyFlags, moveEmails, readEmail, searchEmails, trashEmails } from '../helpers/imap-client.js';
+import { messages } from './messages.js';
+const mockSearchEmails = vi.mocked(searchEmails);
+const mockReadEmail = vi.mocked(readEmail);
+const mockModifyFlags = vi.mocked(modifyFlags);
+const mockMoveEmails = vi.mocked(moveEmails);
+const mockTrashEmails = vi.mocked(trashEmails);
+const mockListFolders = vi.mocked(listFolders);
+const accounts = [
+    {
+        id: 'user1_gmail_com',
+        email: 'user1@gmail.com',
+        password: 'pass1',
+        imap: { host: 'imap.gmail.com', port: 993, secure: true },
+        smtp: { host: 'smtp.gmail.com', port: 465, secure: true }
+    },
+    {
+        id: 'user2_outlook_com',
+        email: 'user2@outlook.com',
+        password: 'pass2',
+        imap: { host: 'outlook.office365.com', port: 993, secure: true },
+        smtp: { host: 'smtp.office365.com', port: 587, secure: false }
+    }
+];
+beforeEach(() => {
+    vi.clearAllMocks();
+});
+// ============================================================================
+// search
+// ============================================================================
+describe('messages - search', () => {
+    it('searches all accounts by default', async () => {
+        mockSearchEmails.mockResolvedValue([]);
+        const result = await messages(accounts, { action: 'search' });
+        expect(result.action).toBe('search');
+        expect(result.query).toBe('UNSEEN');
+        expect(result.folder).toBe('INBOX');
+        expect(result.accounts_searched).toHaveLength(2);
+        expect(mockSearchEmails).toHaveBeenCalledWith(accounts, 'UNSEEN', 'INBOX', 20);
+    });
+    it('filters by account when specified', async () => {
+        mockSearchEmails.mockResolvedValue([]);
+        await messages(accounts, { action: 'search', account: 'user1@gmail.com' });
+        expect(mockSearchEmails).toHaveBeenCalledWith([accounts[0]], expect.any(String), expect.any(String), expect.any(Number));
+    });
+    it('uses custom query, folder, and limit', async () => {
+        mockSearchEmails.mockResolvedValue([]);
+        await messages(accounts, { action: 'search', query: 'FLAGGED', folder: 'Sent', limit: 5 });
+        expect(mockSearchEmails).toHaveBeenCalledWith(accounts, 'FLAGGED', 'Sent', 5);
+    });
+    it('throws when account not found', async () => {
+        await expect(messages(accounts, { action: 'search', account: 'nonexistent@test.com' })).rejects.toThrow('Account not found');
+    });
+});
+// ============================================================================
+// read
+// ============================================================================
+describe('messages - read', () => {
+    it('reads email by UID', async () => {
+        mockReadEmail.mockResolvedValue({
+            account_id: 'user1_gmail_com',
+            account_email: 'user1@gmail.com',
+            uid: 42,
+            subject: 'Test',
+            from: 'sender@test.com',
+            to: 'user1@gmail.com',
+            date: '2025-01-01',
+            flags: ['\\Seen'],
+            body_text: 'Hello',
+            attachments: []
+        });
+        const result = await messages(accounts, { action: 'read', uid: 42, account: 'user1@gmail.com' });
+        expect(result.action).toBe('read');
+        expect(result.uid).toBe(42);
+        expect(result.subject).toBe('Test');
+    });
+    it('throws when uid is missing', async () => {
+        await expect(messages(accounts, { action: 'read', account: 'user1@gmail.com' })).rejects.toThrow('uid is required');
+    });
+    it('throws when multiple accounts match', async () => {
+        await expect(messages(accounts, { action: 'read', uid: 1, account: '.com' })).rejects.toThrow('Multiple accounts matched');
+    });
+});
+// ============================================================================
+// mark_read / mark_unread
+// ============================================================================
+describe('messages - mark_read', () => {
+    it('adds \\Seen flag', async () => {
+        mockModifyFlags.mockResolvedValue({ success: true, modified: 1 });
+        const result = await messages(accounts, { action: 'mark_read', uid: 5, account: 'user1@gmail.com' });
+        expect(result.action).toBe('mark_read');
+        expect(mockModifyFlags).toHaveBeenCalledWith(accounts[0], [5], 'INBOX', ['\\Seen'], 'add');
+    });
+    it('supports batch uids', async () => {
+        mockModifyFlags.mockResolvedValue({ success: true, modified: 3 });
+        await messages(accounts, { action: 'mark_read', uids: [1, 2, 3], account: 'user1@gmail.com' });
+        expect(mockModifyFlags).toHaveBeenCalledWith(accounts[0], [1, 2, 3], 'INBOX', ['\\Seen'], 'add');
+    });
+    it('throws when no uids provided', async () => {
+        await expect(messages(accounts, { action: 'mark_read', account: 'user1@gmail.com' })).rejects.toThrow('uid or uids required');
+    });
+});
+describe('messages - mark_unread', () => {
+    it('removes \\Seen flag', async () => {
+        mockModifyFlags.mockResolvedValue({ success: true, modified: 1 });
+        await messages(accounts, { action: 'mark_unread', uid: 5, account: 'user1@gmail.com' });
+        expect(mockModifyFlags).toHaveBeenCalledWith(accounts[0], [5], 'INBOX', ['\\Seen'], 'remove');
+    });
+});
+// ============================================================================
+// flag / unflag
+// ============================================================================
+describe('messages - flag', () => {
+    it('adds \\Flagged flag', async () => {
+        mockModifyFlags.mockResolvedValue({ success: true, modified: 1 });
+        await messages(accounts, { action: 'flag', uid: 10, account: 'user1@gmail.com' });
+        expect(mockModifyFlags).toHaveBeenCalledWith(accounts[0], [10], 'INBOX', ['\\Flagged'], 'add');
+    });
+});
+describe('messages - unflag', () => {
+    it('removes \\Flagged flag', async () => {
+        mockModifyFlags.mockResolvedValue({ success: true, modified: 1 });
+        await messages(accounts, { action: 'unflag', uid: 10, account: 'user1@gmail.com' });
+        expect(mockModifyFlags).toHaveBeenCalledWith(accounts[0], [10], 'INBOX', ['\\Flagged'], 'remove');
+    });
+});
+// ============================================================================
+// move
+// ============================================================================
+describe('messages - move', () => {
+    it('moves emails to destination folder', async () => {
+        mockMoveEmails.mockResolvedValue({ success: true, moved: 2 });
+        const result = await messages(accounts, {
+            action: 'move',
+            uids: [1, 2],
+            destination: 'Archive',
+            account: 'user1@gmail.com'
+        });
+        expect(result.action).toBe('move');
+        expect(result.to_folder).toBe('Archive');
+        expect(mockMoveEmails).toHaveBeenCalledWith(accounts[0], [1, 2], 'INBOX', 'Archive');
+    });
+    it('throws when destination is missing', async () => {
+        await expect(messages(accounts, { action: 'move', uid: 1, account: 'user1@gmail.com' })).rejects.toThrow('destination is required');
+    });
+});
+// ============================================================================
+// archive
+// ============================================================================
+describe('messages - archive', () => {
+    it('moves to Gmail archive folder', async () => {
+        mockListFolders.mockResolvedValue([
+            { name: 'All Mail', path: '[Gmail]/All Mail', flags: ['\\All'], delimiter: '/' }
+        ]);
+        mockMoveEmails.mockResolvedValue({ success: true, moved: 1 });
+        const result = await messages(accounts, { action: 'archive', uid: 1, account: 'user1@gmail.com' });
+        expect(result.action).toBe('archive');
+        expect(result.archive_folder).toBe('[Gmail]/All Mail');
+    });
+    it('falls back to default archive folder if listing fails', async () => {
+        mockListFolders.mockRejectedValue(new Error('fail'));
+        mockMoveEmails.mockResolvedValue({ success: true, moved: 1 });
+        const result = await messages(accounts, { action: 'archive', uid: 1, account: 'user1@gmail.com' });
+        expect(result.archive_folder).toBe('[Gmail]/All Mail');
+    });
+    it('uses Archive for Outlook accounts', async () => {
+        mockListFolders.mockResolvedValue([{ name: 'Archive', path: 'Archive', flags: ['\\Archive'], delimiter: '/' }]);
+        mockMoveEmails.mockResolvedValue({ success: true, moved: 1 });
+        const result = await messages(accounts, { action: 'archive', uid: 1, account: 'user2@outlook.com' });
+        expect(result.archive_folder).toBe('Archive');
+    });
+});
+// ============================================================================
+// trash
+// ============================================================================
+describe('messages - trash', () => {
+    it('trashes emails', async () => {
+        mockTrashEmails.mockResolvedValue({ success: true, trashed: 1 });
+        const result = await messages(accounts, { action: 'trash', uid: 99, account: 'user1@gmail.com' });
+        expect(result.action).toBe('trash');
+        expect(mockTrashEmails).toHaveBeenCalledWith(accounts[0], [99], 'INBOX');
+    });
+});
+// ============================================================================
+// unknown action
+// ============================================================================
+describe('messages - unknown action', () => {
+    it('throws for unknown action', async () => {
+        await expect(messages(accounts, { action: 'unknown_action' })).rejects.toThrow();
+    });
+});
+// ============================================================================
+// account resolution
+// ============================================================================
+describe('account resolution', () => {
+    it('matches by partial email', async () => {
+        mockSearchEmails.mockResolvedValue([]);
+        await messages(accounts, { action: 'search', account: 'gmail' });
+        expect(mockSearchEmails).toHaveBeenCalledWith([accounts[0]], expect.any(String), expect.any(String), expect.any(Number));
+    });
+    it('matches by account id', async () => {
+        mockSearchEmails.mockResolvedValue([]);
+        await messages(accounts, { action: 'search', account: 'user1_gmail_com' });
+        expect(mockSearchEmails).toHaveBeenCalledWith([accounts[0]], expect.any(String), expect.any(String), expect.any(Number));
+    });
+});
+//# sourceMappingURL=messages.test.js.map

package/build/src/tools/composite/messages.test.js.map

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

package/build/src/tools/composite/send.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Send Mega Tool
+ * Send new emails, reply, and forward via SMTP
+ */
+import type { AccountConfig } from '../helpers/config.js';
+export interface SendInput {
+    action: 'new' | 'reply' | 'forward';
+    account: string;
+    to: string;
+    subject: string;
+    body: string;
+    cc?: string;
+    bcc?: string;
+    uid?: number;
+    folder?: string;
+}
+/**
+ * Unified send tool - handles all outbound email operations
+ */
+export declare function send(accounts: AccountConfig[], input: SendInput): Promise<any>;
+//# sourceMappingURL=send.d.ts.map

package/build/src/tools/composite/send.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"send.d.ts","sourceRoot":"","sources":["../../../../src/tools/composite/send.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AAKzD,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,KAAK,GAAG,OAAO,GAAG,SAAS,CAAA;IAGnC,OAAO,EAAE,MAAM,CAAA;IACf,EAAE,EAAE,MAAM,CAAA;IACV,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,MAAM,CAAA;IAGZ,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,GAAG,CAAC,EAAE,MAAM,CAAA;IAGZ,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AA8BD;;GAEG;AACH,wBAAsB,IAAI,CAAC,QAAQ,EAAE,aAAa,EAAE,EAAE,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,CAoCpF"}

package/build/src/tools/composite/send.js

@@ -0,0 +1,127 @@
+/**
+ * Send Mega Tool
+ * Send new emails, reply, and forward via SMTP
+ */
+import { EmailMCPError, withErrorHandling } from '../helpers/errors.js';
+import { readEmail } from '../helpers/imap-client.js';
+import { forwardEmail, replyToEmail, sendNewEmail } from '../helpers/smtp-client.js';
+/**
+ * Resolve a single account by filter
+ */
+function resolveSingleAccount(accounts, accountFilter) {
+    const lower = accountFilter.toLowerCase();
+    const matched = accounts.filter((a) => a.email.toLowerCase() === lower || a.id === lower || a.email.toLowerCase().includes(lower));
+    if (matched.length === 0) {
+        throw new EmailMCPError(`Account not found: ${accountFilter}`, 'ACCOUNT_NOT_FOUND', `Available accounts: ${accounts.map((a) => a.email).join(', ')}`);
+    }
+    if (matched.length > 1) {
+        throw new EmailMCPError('Multiple accounts matched. Specify the exact account email.', 'AMBIGUOUS_ACCOUNT', `Matched: ${matched.map((a) => a.email).join(', ')}`);
+    }
+    return matched[0];
+}
+/**
+ * Unified send tool - handles all outbound email operations
+ */
+export async function send(accounts, input) {
+    return withErrorHandling(async () => {
+        if (!input.account) {
+            throw new EmailMCPError('account is required for send operations', 'VALIDATION_ERROR', 'Provide the sender account email address');
+        }
+        if (!input.to) {
+            throw new EmailMCPError('to is required', 'VALIDATION_ERROR', 'Provide recipient email address');
+        }
+        if (!input.body) {
+            throw new EmailMCPError('body is required', 'VALIDATION_ERROR', 'Provide the email body text');
+        }
+        switch (input.action) {
+            case 'new':
+                return await handleNew(accounts, input);
+            case 'reply':
+                return await handleReply(accounts, input);
+            case 'forward':
+                return await handleForward(accounts, input);
+            default:
+                throw new EmailMCPError(`Unknown action: ${input.action}`, 'VALIDATION_ERROR', 'Supported actions: new, reply, forward');
+        }
+    })();
+}
+/**
+ * Send a new email
+ */
+async function handleNew(accounts, input) {
+    if (!input.subject) {
+        throw new EmailMCPError('subject is required for new email', 'VALIDATION_ERROR', 'Provide the email subject');
+    }
+    const account = resolveSingleAccount(accounts, input.account);
+    const result = await sendNewEmail(account, {
+        to: input.to,
+        subject: input.subject,
+        body: input.body,
+        cc: input.cc,
+        bcc: input.bcc
+    });
+    return {
+        action: 'new',
+        from: account.email,
+        to: input.to,
+        subject: input.subject,
+        ...result
+    };
+}
+/**
+ * Reply to an email (maintains thread headers)
+ */
+async function handleReply(accounts, input) {
+    if (!input.uid) {
+        throw new EmailMCPError('uid is required for reply action', 'VALIDATION_ERROR', 'Provide the UID of the email to reply to (from search/read)');
+    }
+    const account = resolveSingleAccount(accounts, input.account);
+    const folder = input.folder || 'INBOX';
+    // Read original email to get threading headers
+    const original = await readEmail(account, input.uid, folder);
+    const result = await replyToEmail(account, {
+        to: input.to,
+        subject: input.subject || original.subject,
+        body: input.body,
+        cc: input.cc,
+        bcc: input.bcc,
+        in_reply_to: original.message_id,
+        references: original.references || original.message_id
+    });
+    return {
+        action: 'reply',
+        from: account.email,
+        to: input.to,
+        subject: input.subject || `Re: ${original.subject}`,
+        in_reply_to: original.message_id,
+        ...result
+    };
+}
+/**
+ * Forward an email
+ */
+async function handleForward(accounts, input) {
+    if (!input.uid) {
+        throw new EmailMCPError('uid is required for forward action', 'VALIDATION_ERROR', 'Provide the UID of the email to forward (from search/read)');
+    }
+    const account = resolveSingleAccount(accounts, input.account);
+    const folder = input.folder || 'INBOX';
+    // Read original email to include in forward
+    const original = await readEmail(account, input.uid, folder);
+    const result = await forwardEmail(account, {
+        to: input.to,
+        subject: input.subject || original.subject,
+        body: input.body,
+        cc: input.cc,
+        bcc: input.bcc,
+        original_body: original.body_text
+    });
+    return {
+        action: 'forward',
+        from: account.email,
+        to: input.to,
+        subject: input.subject || `Fwd: ${original.subject}`,
+        ...result
+    };
+}
+//# sourceMappingURL=send.js.map