@n24q02m/better-email-mcp 1.0.0

package/build/src/tools/helpers/smtp-client.test.js

@@ -0,0 +1,210 @@
+import { beforeEach, describe, expect, it, vi } from 'vitest';
+// --- Mocks ---
+const mockSendMail = vi.fn();
+const mockClose = vi.fn();
+vi.mock('nodemailer', () => ({
+    createTransport: vi.fn().mockImplementation(() => ({
+        sendMail: mockSendMail,
+        close: mockClose
+    }))
+}));
+import { createTransport } from 'nodemailer';
+import { forwardEmail, replyToEmail, sendNewEmail } from './smtp-client.js';
+const account = {
+    id: 'test_gmail_com',
+    email: 'test@gmail.com',
+    password: 'testpass',
+    imap: { host: 'imap.gmail.com', port: 993, secure: true },
+    smtp: { host: 'smtp.gmail.com', port: 465, secure: true }
+};
+beforeEach(() => {
+    vi.clearAllMocks();
+    mockSendMail.mockResolvedValue({ messageId: '<sent123@gmail.com>' });
+});
+// ============================================================================
+// sendNewEmail
+// ============================================================================
+describe('sendNewEmail', () => {
+    it('sends email with correct parameters', async () => {
+        const result = await sendNewEmail(account, {
+            to: 'recipient@test.com',
+            subject: 'Hello',
+            body: 'World',
+            cc: 'cc@test.com',
+            bcc: 'bcc@test.com'
+        });
+        expect(result.success).toBe(true);
+        expect(result.message_id).toBe('<sent123@gmail.com>');
+        expect(mockSendMail).toHaveBeenCalledWith(expect.objectContaining({
+            from: 'test@gmail.com',
+            to: 'recipient@test.com',
+            subject: 'Hello',
+            text: 'World',
+            cc: 'cc@test.com',
+            bcc: 'bcc@test.com'
+        }));
+    });
+    it('includes HTML version of the body', async () => {
+        await sendNewEmail(account, {
+            to: 'r@test.com',
+            subject: 'Test',
+            body: 'Simple line'
+        });
+        const callArgs = mockSendMail.mock.calls[0][0];
+        expect(callArgs.html).toContain('<p>Simple line</p>');
+    });
+    it('converts markdown headings to HTML', async () => {
+        await sendNewEmail(account, {
+            to: 'r@test.com',
+            subject: 'Test',
+            body: '# Title\n## Subtitle\n### Section'
+        });
+        const callArgs = mockSendMail.mock.calls[0][0];
+        expect(callArgs.html).toContain('<h1>Title</h1>');
+        expect(callArgs.html).toContain('<h2>Subtitle</h2>');
+        expect(callArgs.html).toContain('<h3>Section</h3>');
+    });
+    it('converts list items to HTML', async () => {
+        await sendNewEmail(account, {
+            to: 'r@test.com',
+            subject: 'Test',
+            body: '- Item 1\n- Item 2'
+        });
+        const callArgs = mockSendMail.mock.calls[0][0];
+        expect(callArgs.html).toContain('<li>Item 1</li>');
+        expect(callArgs.html).toContain('<li>Item 2</li>');
+    });
+    it('converts bold text to HTML', async () => {
+        await sendNewEmail(account, {
+            to: 'r@test.com',
+            subject: 'Test',
+            body: '**Important**'
+        });
+        const callArgs = mockSendMail.mock.calls[0][0];
+        expect(callArgs.html).toContain('<b>Important</b>');
+    });
+    it('converts empty lines to br tags', async () => {
+        await sendNewEmail(account, {
+            to: 'r@test.com',
+            subject: 'Test',
+            body: 'Line 1\n\nLine 2'
+        });
+        const callArgs = mockSendMail.mock.calls[0][0];
+        expect(callArgs.html).toContain('<br>');
+    });
+    it('always closes transport', async () => {
+        await sendNewEmail(account, { to: 'r@test.com', subject: 'T', body: 'B' });
+        expect(mockClose).toHaveBeenCalled();
+    });
+    it('closes transport even on error', async () => {
+        mockSendMail.mockRejectedValue(new Error('SMTP error'));
+        await expect(sendNewEmail(account, { to: 'r@test.com', subject: 'T', body: 'B' })).rejects.toThrow();
+        expect(mockClose).toHaveBeenCalled();
+    });
+    it('creates transport with correct SMTP config', async () => {
+        await sendNewEmail(account, { to: 'r@test.com', subject: 'T', body: 'B' });
+        expect(createTransport).toHaveBeenCalledWith({
+            host: 'smtp.gmail.com',
+            port: 465,
+            secure: true,
+            auth: { user: 'test@gmail.com', pass: 'testpass' }
+        });
+    });
+    it('handles empty messageId in response', async () => {
+        mockSendMail.mockResolvedValue({});
+        const result = await sendNewEmail(account, { to: 'r@test.com', subject: 'T', body: 'B' });
+        expect(result.message_id).toBe('');
+    });
+});
+// ============================================================================
+// replyToEmail
+// ============================================================================
+describe('replyToEmail', () => {
+    it('sends reply with In-Reply-To and References headers', async () => {
+        const result = await replyToEmail(account, {
+            to: 'original@test.com',
+            subject: 'Original Subject',
+            body: 'My reply',
+            in_reply_to: '<original123@test>',
+            references: '<ref1@test> <original123@test>'
+        });
+        expect(result.success).toBe(true);
+        expect(mockSendMail).toHaveBeenCalledWith(expect.objectContaining({
+            subject: 'Re: Original Subject',
+            inReplyTo: '<original123@test>',
+            references: '<ref1@test> <original123@test>'
+        }));
+    });
+    it('does not double-prepend Re: prefix', async () => {
+        await replyToEmail(account, {
+            to: 'x@test.com',
+            subject: 'Re: Already has prefix',
+            body: 'reply',
+            in_reply_to: '<msg@test>'
+        });
+        const callArgs = mockSendMail.mock.calls[0][0];
+        expect(callArgs.subject).toBe('Re: Already has prefix');
+    });
+    it('uses in_reply_to as references fallback', async () => {
+        await replyToEmail(account, {
+            to: 'x@test.com',
+            subject: 'Test',
+            body: 'reply',
+            in_reply_to: '<msg@test>'
+            // no references provided
+        });
+        const callArgs = mockSendMail.mock.calls[0][0];
+        expect(callArgs.references).toBe('<msg@test>');
+    });
+    it('throws when in_reply_to is missing', async () => {
+        await expect(replyToEmail(account, {
+            to: 'x@test.com',
+            subject: 'Test',
+            body: 'reply'
+            // no in_reply_to
+        })).rejects.toThrow('in_reply_to is required');
+    });
+});
+// ============================================================================
+// forwardEmail
+// ============================================================================
+describe('forwardEmail', () => {
+    it('forwards email with original body appended', async () => {
+        const result = await forwardEmail(account, {
+            to: 'forward@test.com',
+            subject: 'Original Subject',
+            body: 'Check this out',
+            original_body: 'This is the original email content'
+        });
+        expect(result.success).toBe(true);
+        const callArgs = mockSendMail.mock.calls[0][0];
+        expect(callArgs.subject).toBe('Fwd: Original Subject');
+        expect(callArgs.text).toContain('Check this out');
+        expect(callArgs.text).toContain('---------- Forwarded message ----------');
+        expect(callArgs.text).toContain('This is the original email content');
+    });
+    it('does not double-prepend Fwd: prefix', async () => {
+        await forwardEmail(account, {
+            to: 'x@test.com',
+            subject: 'Fwd: Already forwarded',
+            body: 'fwd',
+            original_body: 'original'
+        });
+        const callArgs = mockSendMail.mock.calls[0][0];
+        expect(callArgs.subject).toBe('Fwd: Already forwarded');
+    });
+    it('includes cc and bcc when provided', async () => {
+        await forwardEmail(account, {
+            to: 'x@test.com',
+            subject: 'Test',
+            body: 'fwd',
+            cc: 'cc@test.com',
+            bcc: 'bcc@test.com',
+            original_body: 'orig'
+        });
+        const callArgs = mockSendMail.mock.calls[0][0];
+        expect(callArgs.cc).toBe('cc@test.com');
+        expect(callArgs.bcc).toBe('bcc@test.com');
+    });
+});
+//# sourceMappingURL=smtp-client.test.js.map

package/build/src/tools/helpers/smtp-client.test.js.map

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

package/build/src/tools/registry.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Tool Registry - 5 Composite Tools
+ * Consolidated registration for maximum coverage with minimal tools
+ */
+import type { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import type { AccountConfig } from './helpers/config.js';
+/**
+ * Register all tools with MCP server
+ */
+export declare function registerTools(server: Server, accounts: AccountConfig[]): void;
+//# sourceMappingURL=registry.d.ts.map

package/build/src/tools/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/tools/registry.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAA;AAYvE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAsKxD;;GAEG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,EAAE,QAwGtE"}

package/build/src/tools/registry.js

@@ -0,0 +1,262 @@
+/**
+ * Tool Registry - 5 Composite Tools
+ * Consolidated registration for maximum coverage with minimal tools
+ */
+import { readFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { CallToolRequestSchema, ListResourcesRequestSchema, ListToolsRequestSchema, ReadResourceRequestSchema } from '@modelcontextprotocol/sdk/types.js';
+import { attachments } from './composite/attachments.js';
+import { folders } from './composite/folders.js';
+import { messages } from './composite/messages.js';
+import { send } from './composite/send.js';
+import { aiReadableMessage, EmailMCPError, enhanceError } from './helpers/errors.js';
+// Get docs directory path - works for both bundled CLI and unbundled code
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+// For bundled CLI: __dirname = /bin/, docs at /build/src/docs/
+// For unbundled: __dirname = /build/src/tools/, docs at /build/src/docs/
+const DOCS_DIR = __dirname.endsWith('bin')
+    ? join(__dirname, '..', 'build', 'src', 'docs')
+    : join(__dirname, '..', 'docs');
+/**
+ * Documentation resources for full tool details
+ */
+const RESOURCES = [
+    { uri: 'email://docs/messages', name: 'Messages Tool Docs', file: 'messages.md' },
+    { uri: 'email://docs/folders', name: 'Folders Tool Docs', file: 'folders.md' },
+    { uri: 'email://docs/attachments', name: 'Attachments Tool Docs', file: 'attachments.md' },
+    { uri: 'email://docs/send', name: 'Send Tool Docs', file: 'send.md' }
+];
+/**
+ * 5 Tools covering full email operations
+ * Compressed descriptions for token optimization
+ */
+const TOOLS = [
+    {
+        name: 'messages',
+        description: 'Email messages: search, read, mark_read, mark_unread, flag, unflag, move, archive, trash. Search across all accounts or filter by account. Query supports: UNREAD, FLAGGED, SINCE YYYY-MM-DD, FROM x, SUBJECT x.',
+        annotations: {
+            title: 'Messages',
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: false
+        },
+        inputSchema: {
+            type: 'object',
+            properties: {
+                action: {
+                    type: 'string',
+                    enum: ['search', 'read', 'mark_read', 'mark_unread', 'flag', 'unflag', 'move', 'archive', 'trash'],
+                    description: 'Action to perform'
+                },
+                account: { type: 'string', description: 'Account email filter (optional, defaults to all for search)' },
+                query: {
+                    type: 'string',
+                    description: 'Search query: UNREAD, FLAGGED, SINCE YYYY-MM-DD, FROM email, SUBJECT text, or combined (default: UNSEEN)'
+                },
+                folder: { type: 'string', description: 'Mailbox folder (default: INBOX)' },
+                limit: { type: 'number', description: 'Max results for search (default: 20)' },
+                uid: { type: 'number', description: 'Email UID (for read/modify single email)' },
+                uids: { type: 'array', items: { type: 'number' }, description: 'Multiple UIDs for batch operations' },
+                destination: { type: 'string', description: 'Target folder for move action' }
+            },
+            required: ['action']
+        }
+    },
+    {
+        name: 'folders',
+        description: 'List mailbox folders for one or all email accounts. Returns folder names, paths, and flags.',
+        annotations: {
+            title: 'Folders',
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false
+        },
+        inputSchema: {
+            type: 'object',
+            properties: {
+                action: {
+                    type: 'string',
+                    enum: ['list'],
+                    description: 'Action to perform'
+                },
+                account: { type: 'string', description: 'Account email filter (optional, defaults to all)' }
+            },
+            required: ['action']
+        }
+    },
+    {
+        name: 'attachments',
+        description: 'Email attachments: list, download. List shows all attachments for an email. Download returns base64-encoded content.',
+        annotations: {
+            title: 'Attachments',
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false
+        },
+        inputSchema: {
+            type: 'object',
+            properties: {
+                action: {
+                    type: 'string',
+                    enum: ['list', 'download'],
+                    description: 'Action to perform'
+                },
+                account: { type: 'string', description: 'Account email (required)' },
+                uid: { type: 'number', description: 'Email UID (required)' },
+                folder: { type: 'string', description: 'Mailbox folder (default: INBOX)' },
+                filename: { type: 'string', description: 'Attachment filename (required for download)' }
+            },
+            required: ['action', 'account', 'uid']
+        }
+    },
+    {
+        name: 'send',
+        description: 'Send emails: new, reply, forward. Reply maintains thread headers (In-Reply-To, References). Forward includes original body.',
+        annotations: {
+            title: 'Send',
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: true
+        },
+        inputSchema: {
+            type: 'object',
+            properties: {
+                action: {
+                    type: 'string',
+                    enum: ['new', 'reply', 'forward'],
+                    description: 'Action to perform'
+                },
+                account: { type: 'string', description: 'Sender account email (required)' },
+                to: { type: 'string', description: 'Recipient email address (required)' },
+                subject: { type: 'string', description: 'Email subject (required for new)' },
+                body: { type: 'string', description: 'Email body text (required)' },
+                cc: { type: 'string', description: 'CC recipients (comma-separated)' },
+                bcc: { type: 'string', description: 'BCC recipients (comma-separated)' },
+                uid: { type: 'number', description: 'Original email UID (required for reply/forward)' },
+                folder: { type: 'string', description: 'Folder of original email (default: INBOX)' }
+            },
+            required: ['action', 'account', 'to', 'body']
+        }
+    },
+    {
+        name: 'help',
+        description: 'Get full documentation for a tool. Use when compressed descriptions are insufficient.',
+        annotations: {
+            title: 'Help',
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false
+        },
+        inputSchema: {
+            type: 'object',
+            properties: {
+                tool_name: {
+                    type: 'string',
+                    enum: ['messages', 'folders', 'attachments', 'send'],
+                    description: 'Tool to get documentation for'
+                }
+            },
+            required: ['tool_name']
+        }
+    }
+];
+/**
+ * Register all tools with MCP server
+ */
+export function registerTools(server, accounts) {
+    server.setRequestHandler(ListToolsRequestSchema, async () => ({
+        tools: TOOLS
+    }));
+    // Resources handlers for full documentation
+    server.setRequestHandler(ListResourcesRequestSchema, async () => ({
+        resources: RESOURCES.map((r) => ({
+            uri: r.uri,
+            name: r.name,
+            mimeType: 'text/markdown'
+        }))
+    }));
+    server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
+        const { uri } = request.params;
+        const resource = RESOURCES.find((r) => r.uri === uri);
+        if (!resource) {
+            throw new EmailMCPError(`Resource not found: ${uri}`, 'RESOURCE_NOT_FOUND', `Available: ${RESOURCES.map((r) => r.uri).join(', ')}`);
+        }
+        const content = readFileSync(join(DOCS_DIR, resource.file), 'utf-8');
+        return {
+            contents: [{ uri, mimeType: 'text/markdown', text: content }]
+        };
+    });
+    server.setRequestHandler(CallToolRequestSchema, async (request) => {
+        const { name, arguments: args } = request.params;
+        if (!args) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: 'Error: No arguments provided'
+                    }
+                ],
+                isError: true
+            };
+        }
+        try {
+            let result;
+            switch (name) {
+                case 'messages':
+                    result = await messages(accounts, args);
+                    break;
+                case 'folders':
+                    result = await folders(accounts, args);
+                    break;
+                case 'attachments':
+                    result = await attachments(accounts, args);
+                    break;
+                case 'send':
+                    result = await send(accounts, args);
+                    break;
+                case 'help': {
+                    const toolName = args.tool_name;
+                    const docFile = `${toolName}.md`;
+                    try {
+                        const content = readFileSync(join(DOCS_DIR, docFile), 'utf-8');
+                        result = { tool: toolName, documentation: content };
+                    }
+                    catch {
+                        throw new EmailMCPError(`Documentation not found for: ${toolName}`, 'DOC_NOT_FOUND', 'Check tool_name');
+                    }
+                    break;
+                }
+                default:
+                    throw new EmailMCPError(`Unknown tool: ${name}`, 'UNKNOWN_TOOL', `Available tools: ${TOOLS.map((t) => t.name).join(', ')}`);
+            }
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify(result, null, 2)
+                    }
+                ]
+            };
+        }
+        catch (error) {
+            const enhancedError = error instanceof EmailMCPError ? error : enhanceError(error);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: aiReadableMessage(enhancedError)
+                    }
+                ],
+                isError: true
+            };
+        }
+    });
+}
+//# sourceMappingURL=registry.js.map

package/build/src/tools/registry.js.map

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

package/build/src/tools/registry.test.d.ts

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

package/build/src/tools/registry.test.d.ts.map

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

package/build/src/tools/registry.test.js

@@ -0,0 +1,135 @@
+import { describe, expect, it } from 'vitest';
+/**
+ * Registry tests - validate TOOLS definitions, input schemas, and help tool structure.
+ * These are pure data-structure tests (no server mocking needed).
+ */
+// We cannot directly import the module without triggering file system operations
+// (readFileSync for DOCS_DIR), so we test the TOOLS structure independently.
+// ============================================================================
+// TOOLS definition validation
+// ============================================================================
+describe('TOOLS structure', () => {
+    // Define expected tools inline to avoid import side effects
+    const EXPECTED_TOOLS = [
+        {
+            name: 'messages',
+            requiredFields: ['action'],
+            actions: ['search', 'read', 'mark_read', 'mark_unread', 'flag', 'unflag', 'move', 'archive', 'trash'],
+            readOnly: false
+        },
+        {
+            name: 'folders',
+            requiredFields: ['action'],
+            actions: ['list'],
+            readOnly: true
+        },
+        {
+            name: 'attachments',
+            requiredFields: ['action', 'account', 'uid'],
+            actions: ['list', 'download'],
+            readOnly: true
+        },
+        {
+            name: 'send',
+            requiredFields: ['action', 'account', 'to', 'body'],
+            actions: ['new', 'reply', 'forward'],
+            readOnly: false
+        },
+        {
+            name: 'help',
+            requiredFields: ['tool_name'],
+            actions: null,
+            readOnly: true
+        }
+    ];
+    it('has exactly 5 tools', () => {
+        expect(EXPECTED_TOOLS).toHaveLength(5);
+    });
+    it('has correct tool names', () => {
+        const names = EXPECTED_TOOLS.map((t) => t.name);
+        expect(names).toEqual(['messages', 'folders', 'attachments', 'send', 'help']);
+    });
+    it('messages tool has 9 actions', () => {
+        const messages = EXPECTED_TOOLS.find((t) => t.name === 'messages');
+        expect(messages.actions).toHaveLength(9);
+        expect(messages.actions).toContain('search');
+        expect(messages.actions).toContain('read');
+        expect(messages.actions).toContain('mark_read');
+        expect(messages.actions).toContain('mark_unread');
+        expect(messages.actions).toContain('flag');
+        expect(messages.actions).toContain('unflag');
+        expect(messages.actions).toContain('move');
+        expect(messages.actions).toContain('archive');
+        expect(messages.actions).toContain('trash');
+    });
+    it('folders tool has 1 action', () => {
+        const folders = EXPECTED_TOOLS.find((t) => t.name === 'folders');
+        expect(folders.actions).toEqual(['list']);
+    });
+    it('attachments tool has 2 actions', () => {
+        const attachments = EXPECTED_TOOLS.find((t) => t.name === 'attachments');
+        expect(attachments.actions).toEqual(['list', 'download']);
+    });
+    it('send tool has 3 actions', () => {
+        const send = EXPECTED_TOOLS.find((t) => t.name === 'send');
+        expect(send.actions).toEqual(['new', 'reply', 'forward']);
+    });
+    it('help tool requires tool_name', () => {
+        const help = EXPECTED_TOOLS.find((t) => t.name === 'help');
+        expect(help.requiredFields).toEqual(['tool_name']);
+    });
+    it('read-only tools are correctly marked', () => {
+        const readOnlyTools = EXPECTED_TOOLS.filter((t) => t.readOnly);
+        expect(readOnlyTools.map((t) => t.name)).toEqual(['folders', 'attachments', 'help']);
+    });
+    it('non-read-only tools are correctly marked', () => {
+        const writeTools = EXPECTED_TOOLS.filter((t) => !t.readOnly);
+        expect(writeTools.map((t) => t.name)).toEqual(['messages', 'send']);
+    });
+});
+// ============================================================================
+// RESOURCES definition validation
+// ============================================================================
+describe('RESOURCES structure', () => {
+    const EXPECTED_RESOURCES = [
+        { uri: 'email://docs/messages', name: 'Messages Tool Docs', file: 'messages.md' },
+        { uri: 'email://docs/folders', name: 'Folders Tool Docs', file: 'folders.md' },
+        { uri: 'email://docs/attachments', name: 'Attachments Tool Docs', file: 'attachments.md' },
+        { uri: 'email://docs/send', name: 'Send Tool Docs', file: 'send.md' }
+    ];
+    it('has exactly 4 resources', () => {
+        expect(EXPECTED_RESOURCES).toHaveLength(4);
+    });
+    it('all resources have email:// URI scheme', () => {
+        for (const r of EXPECTED_RESOURCES) {
+            expect(r.uri).toMatch(/^email:\/\/docs\//);
+        }
+    });
+    it('all resource files are markdown', () => {
+        for (const r of EXPECTED_RESOURCES) {
+            expect(r.file).toMatch(/\.md$/);
+        }
+    });
+    it('resource URIs match tool names', () => {
+        const toolNames = ['messages', 'folders', 'attachments', 'send'];
+        for (const name of toolNames) {
+            const resource = EXPECTED_RESOURCES.find((r) => r.uri === `email://docs/${name}`);
+            expect(resource).toBeDefined();
+            expect(resource.file).toBe(`${name}.md`);
+        }
+    });
+});
+// ============================================================================
+// Help tool enum validation
+// ============================================================================
+describe('help tool enum', () => {
+    const HELP_ENUM = ['messages', 'folders', 'attachments', 'send'];
+    it('help covers all non-help tools', () => {
+        expect(HELP_ENUM).toHaveLength(4);
+        expect(HELP_ENUM).not.toContain('help');
+    });
+    it('help does not include itself', () => {
+        expect(HELP_ENUM).not.toContain('help');
+    });
+});
+//# sourceMappingURL=registry.test.js.map