@kononenko-e/email-mcp 0.2.3

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

@@ -0,0 +1,37 @@
+/**
+ * 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[]);
+    setAccounts(accounts: AccountConfig[]): void;
+    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;IAK5D,WAAW,CAAC,QAAQ,EAAE,aAAa,EAAE,GAAG,IAAI;IAItC,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,244 @@
+/**
+ * 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;
+    }
+    setAccounts(accounts) {
+        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/account-config.tool.d.ts

@@ -0,0 +1,14 @@
+/**
+ * MCP tools: list_account_configs, upsert_account_config, delete_account_config, test_account_config
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import ConnectionManager from '../connections/manager.js';
+import type OAuthService from '../services/oauth.service.js';
+import type WatcherService from '../services/watcher.service.js';
+type RuntimeSync = {
+    connections: ConnectionManager;
+    watcherService: WatcherService;
+};
+export default function registerAccountConfigTools(server: McpServer, runtimeSync: RuntimeSync, oauthService: OAuthService): void;
+export {};
+//# sourceMappingURL=account-config.tool.d.ts.map

package/dist/tools/account-config.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"account-config.tool.d.ts","sourceRoot":"","sources":["../../src/tools/account-config.tool.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAgBzE,OAAO,iBAAiB,MAAM,2BAA2B,CAAC;AAC1D,OAAO,KAAK,YAAY,MAAM,8BAA8B,CAAC;AAC7D,OAAO,KAAK,cAAc,MAAM,gCAAgC,CAAC;AAsDjE,KAAK,WAAW,GAAG;IACjB,WAAW,EAAE,iBAAiB,CAAC;IAC/B,cAAc,EAAE,cAAc,CAAC;CAChC,CAAC;AA8CF,MAAM,CAAC,OAAO,UAAU,0BAA0B,CAChD,MAAM,EAAE,SAAS,EACjB,WAAW,EAAE,WAAW,EACxB,YAAY,EAAE,YAAY,GACzB,IAAI,CAuMN"}

package/dist/tools/account-config.tool.js

@@ -0,0 +1,245 @@
+/**
+ * MCP tools: list_account_configs, upsert_account_config, delete_account_config, test_account_config
+ */
+import { z } from 'zod';
+import { AppConfigFileSchema, } from '../config/schema.js';
+import { CONFIG_FILE, configExists, createDefaultRawConfig, loadRawConfig, normalizeRawAccount, saveConfig, } from '../config/loader.js';
+import ConnectionManager from '../connections/manager.js';
+const ImapSchema = z.object({
+    host: z.string().min(1),
+    port: z.number().int().min(1).max(65535).default(993),
+    tls: z.boolean().default(true),
+    starttls: z.boolean().default(false),
+    verify_ssl: z.boolean().default(true),
+});
+const SmtpPoolSchema = z.object({
+    enabled: z.boolean().default(true),
+    max_connections: z.number().int().min(1).default(1),
+    max_messages: z.number().int().min(1).default(100),
+});
+const SmtpSchema = z.object({
+    host: z.string().min(1),
+    port: z.number().int().min(1).max(65535).default(465),
+    tls: z.boolean().default(true),
+    starttls: z.boolean().default(false),
+    verify_ssl: z.boolean().default(true),
+    pool: SmtpPoolSchema.default({
+        enabled: true,
+        max_connections: 1,
+        max_messages: 100,
+    }),
+});
+const OAuth2Schema = z.object({
+    provider: z.enum(['google', 'microsoft', 'custom']),
+    client_id: z.string().min(1),
+    client_secret: z.string().min(1),
+    refresh_token: z.string().min(1),
+    token_url: z.string().url().optional(),
+    auth_url: z.string().url().optional(),
+    scopes: z.array(z.string()).optional(),
+});
+const AccountInputSchema = z
+    .object({
+    name: z.string().min(1),
+    email: z.string().email(),
+    full_name: z.string().optional(),
+    username: z.string().optional(),
+    password: z.string().optional(),
+    oauth2: OAuth2Schema.optional(),
+    imap: ImapSchema,
+    smtp: SmtpSchema,
+})
+    .refine((data) => data.password ?? data.oauth2, {
+    message: 'Either password or oauth2 must be provided',
+});
+function maskSecret(secret) {
+    if (!secret)
+        return undefined;
+    if (secret.length <= 4)
+        return '*'.repeat(secret.length);
+    return `${'*'.repeat(Math.max(secret.length - 4, 4))}${secret.slice(-4)}`;
+}
+function redactAccount(account) {
+    return {
+        name: account.name,
+        email: account.email,
+        full_name: account.full_name ?? null,
+        username: account.username ?? account.email,
+        auth_type: account.oauth2 ? 'oauth2' : 'password',
+        password_masked: account.password ? maskSecret(account.password) : null,
+        oauth2: account.oauth2
+            ? {
+                provider: account.oauth2.provider,
+                client_id_masked: maskSecret(account.oauth2.client_id),
+                client_secret_masked: maskSecret(account.oauth2.client_secret),
+                refresh_token_masked: maskSecret(account.oauth2.refresh_token),
+                token_url: account.oauth2.token_url ?? null,
+                auth_url: account.oauth2.auth_url ?? null,
+                scopes: account.oauth2.scopes ?? [],
+            }
+            : null,
+        imap: account.imap,
+        smtp: account.smtp,
+    };
+}
+async function loadOrCreateRawConfig() {
+    const exists = await configExists();
+    if (!exists)
+        return createDefaultRawConfig([]);
+    return loadRawConfig();
+}
+async function persistConfig(config, runtimeSync) {
+    const validated = AppConfigFileSchema.parse(config);
+    await saveConfig(validated);
+    const normalizedAccounts = validated.accounts.map(normalizeRawAccount);
+    runtimeSync.connections.setAccounts(normalizedAccounts);
+    runtimeSync.watcherService.setAccounts(normalizedAccounts);
+}
+export default function registerAccountConfigTools(server, runtimeSync, oauthService) {
+    server.tool('list_account_configs', 'List configured email accounts including server settings, while masking all secrets. Use this before adding or updating account config entries.', {}, { readOnlyHint: true, destructiveHint: false }, async () => {
+        const config = await loadOrCreateRawConfig();
+        const redacted = config.accounts.map(redactAccount);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({
+                        config_path: CONFIG_FILE,
+                        accounts: redacted,
+                    }, null, 2),
+                },
+            ],
+        };
+    });
+    server.tool('upsert_account_config', 'Create or update an email account configuration in the email-mcp config file. This stores credentials for future email tool usage and supports password or OAuth2 authentication.', {
+        account: AccountInputSchema,
+        test_connection: z
+            .boolean()
+            .default(true)
+            .describe('Run IMAP/SMTP connection checks after saving the account'),
+    }, { readOnlyHint: false, destructiveHint: false, openWorldHint: true }, async ({ account, test_connection }) => {
+        try {
+            const config = await loadOrCreateRawConfig();
+            const nextAccount = {
+                ...account,
+                username: account.username ?? account.email,
+            };
+            const existingIndex = config.accounts.findIndex((item) => item.name === nextAccount.name);
+            if (existingIndex >= 0) {
+                config.accounts[existingIndex] = nextAccount;
+            }
+            else {
+                config.accounts.push(nextAccount);
+            }
+            await persistConfig(config, runtimeSync);
+            let testResult;
+            if (test_connection) {
+                const normalized = normalizeRawAccount(nextAccount);
+                const [imap, smtp] = await Promise.all([
+                    ConnectionManager.testImap(normalized, oauthService),
+                    ConnectionManager.testSmtp(normalized, oauthService),
+                ]);
+                testResult = {
+                    imap: { success: imap.success, error: imap.error },
+                    smtp: { success: smtp.success, error: smtp.error },
+                };
+            }
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            success: true,
+                            action: existingIndex >= 0 ? 'updated' : 'created',
+                            config_path: CONFIG_FILE,
+                            account: redactAccount(nextAccount),
+                            test_result: testResult ?? null,
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            return {
+                isError: true,
+                content: [{ type: 'text', text: `Failed to upsert account config: ${message}` }],
+            };
+        }
+    });
+    server.tool('delete_account_config', 'Delete an email account configuration from the email-mcp config file by account name.', {
+        name: z.string().min(1).describe('Configured account name to delete'),
+    }, { readOnlyHint: false, destructiveHint: true }, async ({ name }) => {
+        try {
+            const config = await loadOrCreateRawConfig();
+            const existing = config.accounts.find((item) => item.name === name);
+            if (!existing) {
+                return {
+                    isError: true,
+                    content: [{ type: 'text', text: `Account config "${name}" not found.` }],
+                };
+            }
+            config.accounts = config.accounts.filter((item) => item.name !== name);
+            await persistConfig(config, runtimeSync);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            success: true,
+                            deleted: name,
+                            config_path: CONFIG_FILE,
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            return {
+                isError: true,
+                content: [{ type: 'text', text: `Failed to delete account config: ${message}` }],
+            };
+        }
+    });
+    server.tool('test_account_config', 'Test IMAP and SMTP connectivity for a configured account without exposing stored secrets.', {
+        name: z.string().min(1).describe('Configured account name to test'),
+    }, { readOnlyHint: false, destructiveHint: false, openWorldHint: true }, async ({ name }) => {
+        try {
+            const config = await loadOrCreateRawConfig();
+            const rawAccount = config.accounts.find((item) => item.name === name);
+            if (!rawAccount) {
+                return {
+                    isError: true,
+                    content: [{ type: 'text', text: `Account config "${name}" not found.` }],
+                };
+            }
+            const normalized = normalizeRawAccount(rawAccount);
+            const [imap, smtp] = await Promise.all([
+                ConnectionManager.testImap(normalized, oauthService),
+                ConnectionManager.testSmtp(normalized, oauthService),
+            ]);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            success: imap.success && smtp.success,
+                            account: redactAccount(rawAccount),
+                            imap,
+                            smtp,
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            return {
+                isError: true,
+                content: [{ type: 'text', text: `Failed to test account config: ${message}` }],
+            };
+        }
+    });
+}
+//# sourceMappingURL=account-config.tool.js.map

package/dist/tools/account-config.tool.js.map

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