mcp-twake-mail 0.1.0

package/build/mcp/tools/email.test.js

@@ -0,0 +1,332 @@
+/**
+ * Tests for email MCP tools - get_email, search_emails, get_email_labels.
+ */
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+import { registerEmailTools } from './email.js';
+describe('registerEmailTools', () => {
+    let mockServer;
+    let mockJmapClient;
+    let mockLogger;
+    let registeredTools;
+    beforeEach(() => {
+        registeredTools = new Map();
+        // Mock MCP server
+        mockServer = {
+            registerTool: vi.fn((name, _options, handler) => {
+                registeredTools.set(name, handler);
+            }),
+        };
+        // Mock JMAP client
+        mockJmapClient = {
+            getSession: vi.fn(() => ({ accountId: 'account-1', apiUrl: 'https://jmap.example.com/api' })),
+            request: vi.fn(),
+            parseMethodResponse: vi.fn(),
+        };
+        // Mock logger (silent)
+        mockLogger = {
+            debug: vi.fn(),
+            info: vi.fn(),
+            warn: vi.fn(),
+            error: vi.fn(),
+        };
+        // Register all tools
+        registerEmailTools(mockServer, mockJmapClient, mockLogger);
+    });
+    describe('get_email', () => {
+        it('returns transformed email on success', async () => {
+            const mockEmail = {
+                id: 'email-1',
+                blobId: 'blob-1',
+                threadId: 'thread-1',
+                mailboxIds: { inbox: true },
+                keywords: { $seen: true, $flagged: true },
+                receivedAt: '2024-01-15T10:00:00Z',
+                subject: 'Test Email',
+                from: [{ name: 'Sender', email: 'sender@example.com' }],
+                to: [{ name: 'Recipient', email: 'recipient@example.com' }],
+                preview: 'Email preview text...',
+                hasAttachment: false,
+                size: 1234,
+                textBody: [{ partId: 'part1' }],
+                bodyValues: { part1: { value: 'Email body content' } },
+            };
+            vi.mocked(mockJmapClient.request).mockResolvedValue({
+                methodResponses: [
+                    ['Email/get', { accountId: 'account-1', list: [mockEmail] }, 'getEmail'],
+                ],
+            });
+            vi.mocked(mockJmapClient.parseMethodResponse).mockReturnValue({
+                success: true,
+                data: { accountId: 'account-1', list: [mockEmail] },
+            });
+            const handler = registeredTools.get('get_email');
+            const result = await handler({ emailId: 'email-1' });
+            expect(result.isError).toBeUndefined();
+            const parsed = JSON.parse(result.content[0].text);
+            expect(parsed.id).toBe('email-1');
+            expect(parsed.isRead).toBe(true);
+            expect(parsed.isFlagged).toBe(true);
+            expect(parsed.subject).toBe('Test Email');
+        });
+        it('returns error when email not found', async () => {
+            vi.mocked(mockJmapClient.request).mockResolvedValue({
+                methodResponses: [
+                    ['Email/get', { accountId: 'account-1', list: [], notFound: ['email-nonexistent'] }, 'getEmail'],
+                ],
+            });
+            vi.mocked(mockJmapClient.parseMethodResponse).mockReturnValue({
+                success: true,
+                data: { accountId: 'account-1', list: [], notFound: ['email-nonexistent'] },
+            });
+            const handler = registeredTools.get('get_email');
+            const result = await handler({ emailId: 'email-nonexistent' });
+            expect(result.isError).toBe(true);
+            expect(result.content[0].text).toContain('Email not found');
+        });
+        it('returns error on JMAP error', async () => {
+            vi.mocked(mockJmapClient.request).mockResolvedValue({
+                methodResponses: [
+                    ['error', { type: 'serverError', description: 'Internal server error' }, 'getEmail'],
+                ],
+            });
+            vi.mocked(mockJmapClient.parseMethodResponse).mockReturnValue({
+                success: false,
+                error: { type: 'serverError', description: 'Internal server error' },
+            });
+            const handler = registeredTools.get('get_email');
+            const result = await handler({ emailId: 'email-1' });
+            expect(result.isError).toBe(true);
+            expect(result.content[0].text).toContain('Failed to retrieve email');
+            expect(result.content[0].text).toContain('Internal server error');
+        });
+        it('handles exception gracefully', async () => {
+            vi.mocked(mockJmapClient.request).mockRejectedValue(new Error('Network error'));
+            const handler = registeredTools.get('get_email');
+            const result = await handler({ emailId: 'email-1' });
+            expect(result.isError).toBe(true);
+            expect(result.content[0].text).toContain('Error retrieving email');
+            expect(result.content[0].text).toContain('Network error');
+        });
+    });
+    describe('search_emails', () => {
+        it('returns list of emails matching filters', async () => {
+            const mockEmails = [
+                {
+                    id: 'email-1',
+                    blobId: 'blob-1',
+                    threadId: 'thread-1',
+                    mailboxIds: { inbox: true },
+                    keywords: { $seen: true },
+                    receivedAt: '2024-01-15T10:00:00Z',
+                    subject: 'Test Email 1',
+                    from: [{ email: 'sender@example.com' }],
+                    to: [],
+                    preview: 'Preview 1',
+                },
+                {
+                    id: 'email-2',
+                    blobId: 'blob-2',
+                    threadId: 'thread-2',
+                    mailboxIds: { inbox: true },
+                    keywords: {},
+                    receivedAt: '2024-01-14T10:00:00Z',
+                    subject: 'Test Email 2',
+                    from: [{ email: 'other@example.com' }],
+                    to: [],
+                    preview: 'Preview 2',
+                },
+            ];
+            vi.mocked(mockJmapClient.request).mockResolvedValue({
+                methodResponses: [
+                    ['Email/query', { accountId: 'account-1', ids: ['email-1', 'email-2'], total: 2 }, 'queryEmails'],
+                    ['Email/get', { accountId: 'account-1', list: mockEmails }, 'getEmails'],
+                ],
+            });
+            vi.mocked(mockJmapClient.parseMethodResponse)
+                .mockReturnValueOnce({
+                success: true,
+                data: { accountId: 'account-1', ids: ['email-1', 'email-2'], total: 2 },
+            })
+                .mockReturnValueOnce({
+                success: true,
+                data: { accountId: 'account-1', list: mockEmails },
+            });
+            const handler = registeredTools.get('search_emails');
+            const result = await handler({ mailboxId: 'inbox', limit: 20 });
+            expect(result.isError).toBeUndefined();
+            const parsed = JSON.parse(result.content[0].text);
+            expect(parsed.total).toBe(2);
+            expect(parsed.returned).toBe(2);
+            expect(parsed.emails).toHaveLength(2);
+        });
+        it('builds filter with all parameters', async () => {
+            vi.mocked(mockJmapClient.request).mockResolvedValue({
+                methodResponses: [
+                    ['Email/query', { accountId: 'account-1', ids: [], total: 0 }, 'queryEmails'],
+                    ['Email/get', { accountId: 'account-1', list: [] }, 'getEmails'],
+                ],
+            });
+            vi.mocked(mockJmapClient.parseMethodResponse)
+                .mockReturnValueOnce({
+                success: true,
+                data: { accountId: 'account-1', ids: [], total: 0 },
+            })
+                .mockReturnValueOnce({
+                success: true,
+                data: { accountId: 'account-1', list: [] },
+            });
+            const handler = registeredTools.get('search_emails');
+            await handler({
+                mailboxId: 'inbox',
+                from: 'sender@example.com',
+                to: 'recipient@example.com',
+                subject: 'Test',
+                text: 'body search',
+                before: '2024-01-20T00:00:00Z',
+                after: '2024-01-01T00:00:00Z',
+                hasAttachment: true,
+                unreadOnly: true,
+                flagged: true,
+                limit: 50,
+            });
+            expect(mockJmapClient.request).toHaveBeenCalled();
+            const requestCall = vi.mocked(mockJmapClient.request).mock.calls[0][0];
+            const queryArgs = requestCall[0][1];
+            expect(queryArgs.filter).toEqual({
+                inMailbox: 'inbox',
+                from: 'sender@example.com',
+                to: 'recipient@example.com',
+                subject: 'Test',
+                text: 'body search',
+                before: '2024-01-20T00:00:00Z',
+                after: '2024-01-01T00:00:00Z',
+                hasAttachment: true,
+                notKeyword: '$seen',
+                hasKeyword: '$flagged',
+            });
+            expect(queryArgs.limit).toBe(50);
+        });
+        it('returns error on query failure', async () => {
+            vi.mocked(mockJmapClient.request).mockResolvedValue({
+                methodResponses: [
+                    ['error', { type: 'invalidArguments', description: 'Bad filter' }, 'queryEmails'],
+                ],
+            });
+            vi.mocked(mockJmapClient.parseMethodResponse).mockReturnValue({
+                success: false,
+                error: { type: 'invalidArguments', description: 'Bad filter' },
+            });
+            const handler = registeredTools.get('search_emails');
+            const result = await handler({ limit: 20 });
+            expect(result.isError).toBe(true);
+            expect(result.content[0].text).toContain('Search failed');
+        });
+        it('returns error on Email/get failure', async () => {
+            vi.mocked(mockJmapClient.request).mockResolvedValue({
+                methodResponses: [
+                    ['Email/query', { accountId: 'account-1', ids: ['email-1'], total: 1 }, 'queryEmails'],
+                    ['error', { type: 'serverError', description: 'Fetch failed' }, 'getEmails'],
+                ],
+            });
+            vi.mocked(mockJmapClient.parseMethodResponse)
+                .mockReturnValueOnce({
+                success: true,
+                data: { accountId: 'account-1', ids: ['email-1'], total: 1 },
+            })
+                .mockReturnValueOnce({
+                success: false,
+                error: { type: 'serverError', description: 'Fetch failed' },
+            });
+            const handler = registeredTools.get('search_emails');
+            const result = await handler({ limit: 20 });
+            expect(result.isError).toBe(true);
+            expect(result.content[0].text).toContain('Failed to fetch email details');
+        });
+        it('handles exception gracefully', async () => {
+            vi.mocked(mockJmapClient.request).mockRejectedValue(new Error('Connection timeout'));
+            const handler = registeredTools.get('search_emails');
+            const result = await handler({ limit: 20 });
+            expect(result.isError).toBe(true);
+            expect(result.content[0].text).toContain('Search error');
+            expect(result.content[0].text).toContain('Connection timeout');
+        });
+    });
+    describe('get_email_labels', () => {
+        it('returns mailbox IDs for an email', async () => {
+            vi.mocked(mockJmapClient.request).mockResolvedValue({
+                methodResponses: [
+                    [
+                        'Email/get',
+                        {
+                            accountId: 'account-1',
+                            list: [{ id: 'email-1', mailboxIds: { inbox: true, archive: true, trash: false } }],
+                        },
+                        'getEmailLabels',
+                    ],
+                ],
+            });
+            vi.mocked(mockJmapClient.parseMethodResponse).mockReturnValue({
+                success: true,
+                data: {
+                    accountId: 'account-1',
+                    list: [{ id: 'email-1', mailboxIds: { inbox: true, archive: true, trash: false } }],
+                },
+            });
+            const handler = registeredTools.get('get_email_labels');
+            const result = await handler({ emailId: 'email-1' });
+            expect(result.isError).toBeUndefined();
+            const parsed = JSON.parse(result.content[0].text);
+            expect(parsed.emailId).toBe('email-1');
+            expect(parsed.mailboxIds).toContain('inbox');
+            expect(parsed.mailboxIds).toContain('archive');
+            expect(parsed.mailboxIds).not.toContain('trash');
+        });
+        it('returns error when email not found', async () => {
+            vi.mocked(mockJmapClient.request).mockResolvedValue({
+                methodResponses: [
+                    ['Email/get', { accountId: 'account-1', list: [] }, 'getEmailLabels'],
+                ],
+            });
+            vi.mocked(mockJmapClient.parseMethodResponse).mockReturnValue({
+                success: true,
+                data: { accountId: 'account-1', list: [] },
+            });
+            const handler = registeredTools.get('get_email_labels');
+            const result = await handler({ emailId: 'email-nonexistent' });
+            expect(result.isError).toBe(true);
+            expect(result.content[0].text).toContain('Email not found');
+        });
+        it('returns error on JMAP error', async () => {
+            vi.mocked(mockJmapClient.request).mockResolvedValue({
+                methodResponses: [
+                    ['error', { type: 'serverError', description: 'Internal error' }, 'getEmailLabels'],
+                ],
+            });
+            vi.mocked(mockJmapClient.parseMethodResponse).mockReturnValue({
+                success: false,
+                error: { type: 'serverError', description: 'Internal error' },
+            });
+            const handler = registeredTools.get('get_email_labels');
+            const result = await handler({ emailId: 'email-1' });
+            expect(result.isError).toBe(true);
+            expect(result.content[0].text).toContain('Failed to get email labels');
+        });
+        it('handles exception gracefully', async () => {
+            vi.mocked(mockJmapClient.request).mockRejectedValue(new Error('Network failure'));
+            const handler = registeredTools.get('get_email_labels');
+            const result = await handler({ emailId: 'email-1' });
+            expect(result.isError).toBe(true);
+            expect(result.content[0].text).toContain('Error getting email labels');
+            expect(result.content[0].text).toContain('Network failure');
+        });
+    });
+    describe('tool registration', () => {
+        it('registers all email tools', () => {
+            expect(registeredTools.has('get_email')).toBe(true);
+            expect(registeredTools.has('search_emails')).toBe(true);
+            expect(registeredTools.has('get_email_labels')).toBe(true);
+            expect(registeredTools.size).toBe(3);
+        });
+    });
+});
+//# sourceMappingURL=email.test.js.map

package/build/mcp/tools/email.test.js.map

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

package/build/mcp/tools/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Tool registration aggregator.
+ * Centralizes all MCP tool registrations.
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { JMAPClient } from '../../jmap/client.js';
+import type { Logger } from '../../config/logger.js';
+/**
+ * Register all MCP tools with the server.
+ * @param server MCP server instance
+ * @param jmapClient JMAP client for API calls
+ * @param logger Pino logger
+ */
+export declare function registerAllTools(server: McpServer, jmapClient: JMAPClient, logger: Logger): void;

package/build/mcp/tools/index.js

@@ -0,0 +1,29 @@
+import { registerEmailTools } from './email.js';
+import { registerMailboxTools } from './mailbox.js';
+import { registerEmailOperationTools } from './email-operations.js';
+import { registerEmailSendingTools } from './email-sending.js';
+import { registerAttachmentTools } from './attachment.js';
+import { registerThreadTools } from './thread.js';
+/**
+ * Register all MCP tools with the server.
+ * @param server MCP server instance
+ * @param jmapClient JMAP client for API calls
+ * @param logger Pino logger
+ */
+export function registerAllTools(server, jmapClient, logger) {
+    logger.debug('Registering MCP tools...');
+    // Register email tools (get_email, search_emails, get_email_labels)
+    registerEmailTools(server, jmapClient, logger);
+    // Register mailbox tools (get_mailbox, list_mailboxes)
+    registerMailboxTools(server, jmapClient, logger);
+    // Register email operation tools (mark_as_read, mark_as_unread, delete_email)
+    registerEmailOperationTools(server, jmapClient, logger);
+    // Register email sending tools (send_email)
+    registerEmailSendingTools(server, jmapClient, logger);
+    // Register attachment tools (get_attachments)
+    registerAttachmentTools(server, jmapClient, logger);
+    // Register thread tools (get_thread, get_thread_emails)
+    registerThreadTools(server, jmapClient, logger);
+    logger.info('All MCP tools registered');
+}
+//# sourceMappingURL=index.js.map

package/build/mcp/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/mcp/tools/index.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,2BAA2B,EAAE,MAAM,uBAAuB,CAAC;AACpE,OAAO,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAC;AAC/D,OAAO,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAC1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAElD;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAC9B,MAAiB,EACjB,UAAsB,EACtB,MAAc;IAEd,MAAM,CAAC,KAAK,CAAC,0BAA0B,CAAC,CAAC;IAEzC,oEAAoE;IACpE,kBAAkB,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC;IAE/C,uDAAuD;IACvD,oBAAoB,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC;IAEjD,8EAA8E;IAC9E,2BAA2B,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC;IAExD,4CAA4C;IAC5C,yBAAyB,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC;IAEtD,8CAA8C;IAC9C,uBAAuB,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC;IAEpD,wDAAwD;IACxD,mBAAmB,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC;IAEhD,MAAM,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;AAC1C,CAAC"}

package/build/mcp/tools/mailbox.d.ts

@@ -0,0 +1,10 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { JMAPClient } from '../../jmap/client.js';
+import type { Logger } from '../../config/logger.js';
+/**
+ * Register mailbox tools with the MCP server.
+ * @param server MCP server instance
+ * @param jmapClient JMAP client for server communication
+ * @param logger Logger instance
+ */
+export declare function registerMailboxTools(server: McpServer, jmapClient: JMAPClient, logger: Logger): void;

package/build/mcp/tools/mailbox.js

@@ -0,0 +1,195 @@
+/**
+ * Mailbox MCP tools for retrieving and listing mailboxes.
+ * Provides get_mailbox (MBOX-01) and list_mailboxes (MBOX-02) tools.
+ */
+import { z } from 'zod';
+import { transformMailbox } from '../../transformers/mailbox.js';
+/** Properties to fetch for mailbox operations */
+const MAILBOX_PROPERTIES = [
+    'id',
+    'name',
+    'parentId',
+    'role',
+    'sortOrder',
+    'totalEmails',
+    'unreadEmails',
+    'totalThreads',
+    'unreadThreads',
+    'myRights',
+    'isSubscribed',
+];
+/** Common tool annotations for read-only mailbox operations */
+const MAILBOX_TOOL_ANNOTATIONS = {
+    readOnlyHint: true,
+    destructiveHint: false,
+    idempotentHint: true,
+    openWorldHint: true,
+};
+/**
+ * Register mailbox tools with the MCP server.
+ * @param server MCP server instance
+ * @param jmapClient JMAP client for server communication
+ * @param logger Logger instance
+ */
+export function registerMailboxTools(server, jmapClient, logger) {
+    // get_mailbox tool (MBOX-01)
+    server.tool('get_mailbox', 'Retrieve a mailbox by its ID with metadata including email counts and permissions.', {
+        mailboxId: z.string().describe('The unique identifier of the mailbox to retrieve'),
+    }, {
+        ...MAILBOX_TOOL_ANNOTATIONS,
+        title: 'Get Mailbox',
+    }, async ({ mailboxId }) => {
+        logger.debug({ mailboxId }, 'get_mailbox called');
+        try {
+            const session = jmapClient.getSession();
+            const response = await jmapClient.request([
+                [
+                    'Mailbox/get',
+                    {
+                        accountId: session.accountId,
+                        ids: [mailboxId],
+                        properties: MAILBOX_PROPERTIES,
+                    },
+                    'get-mailbox',
+                ],
+            ]);
+            const result = jmapClient.parseMethodResponse(response.methodResponses[0]);
+            if (!result.success) {
+                logger.error({ error: result.error }, 'JMAP error in get_mailbox');
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `Error retrieving mailbox: ${result.error?.description || result.error?.type || 'Unknown error'}`,
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            const list = result.data?.list;
+            const notFound = result.data?.notFound;
+            if (notFound && notFound.includes(mailboxId)) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `Mailbox not found: ${mailboxId}`,
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            if (!list || list.length === 0) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `Mailbox not found: ${mailboxId}`,
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            const mailbox = transformMailbox(list[0]);
+            logger.debug({ mailboxId: mailbox.id, name: mailbox.name }, 'get_mailbox success');
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify(mailbox, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            logger.error({ error, mailboxId }, 'Exception in get_mailbox');
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Error retrieving mailbox: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+    // list_mailboxes tool (MBOX-02)
+    server.tool('list_mailboxes', 'List all mailboxes with optional filtering by role (inbox, drafts, sent, trash, archive, spam, junk, important, all).', {
+        role: z
+            .enum(['inbox', 'drafts', 'sent', 'trash', 'archive', 'junk', 'important', 'all', 'subscribed'])
+            .optional()
+            .describe('Filter mailboxes by role (e.g., inbox, drafts, sent, trash)'),
+    }, {
+        ...MAILBOX_TOOL_ANNOTATIONS,
+        title: 'List Mailboxes',
+    }, async ({ role }) => {
+        logger.debug({ role }, 'list_mailboxes called');
+        try {
+            const session = jmapClient.getSession();
+            const response = await jmapClient.request([
+                [
+                    'Mailbox/get',
+                    {
+                        accountId: session.accountId,
+                        properties: MAILBOX_PROPERTIES,
+                    },
+                    'list-mailboxes',
+                ],
+            ]);
+            const result = jmapClient.parseMethodResponse(response.methodResponses[0]);
+            if (!result.success) {
+                logger.error({ error: result.error }, 'JMAP error in list_mailboxes');
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `Error listing mailboxes: ${result.error?.description || result.error?.type || 'Unknown error'}`,
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            const list = result.data?.list;
+            if (!list) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify([], null, 2),
+                        },
+                    ],
+                };
+            }
+            // Transform all mailboxes
+            let mailboxes = list.map((item) => transformMailbox(item));
+            // Filter by role if specified (client-side filtering)
+            if (role) {
+                mailboxes = mailboxes.filter((mailbox) => mailbox.role === role);
+            }
+            logger.debug({ count: mailboxes.length, filtered: !!role, role }, 'list_mailboxes success');
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify(mailboxes, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            logger.error({ error, role }, 'Exception in list_mailboxes');
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Error listing mailboxes: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+    logger.info('Mailbox tools registered: get_mailbox, list_mailboxes');
+}
+//# sourceMappingURL=mailbox.js.map

package/build/mcp/tools/mailbox.js.map

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

package/build/mcp/tools/mailbox.test.d.ts

@@ -0,0 +1 @@
+export {};