@honest-magic/mail-mcp 1.3.0 → 1.4.0

package/dist/protocol/sieve.js

@@ -0,0 +1,264 @@
+/**
+ * SieveClient — ManageSieve protocol client (RFC 5804)
+ *
+ * Manages server-side SIEVE email filter scripts via a raw TLS connection
+ * to the ManageSieve daemon (default port 4190).
+ *
+ * Supported operations:
+ *   connect()                    — TLS connect + PLAIN SASL auth
+ *   disconnect()                 — LOGOUT + socket teardown
+ *   listScripts()                — list all scripts with active marker
+ *   getScript(name)              — retrieve script content
+ *   putScript(name, content)     — create or replace a script
+ *   deleteScript(name)           — delete a named script
+ *
+ * NOTE: Many providers (Gmail, Outlook) do NOT support ManageSieve.
+ * Connection errors produce an informative "not supported" message.
+ */
+import * as tls from 'node:tls';
+const CONNECTION_TIMEOUT_MS = 10_000;
+export class SieveClient {
+    host;
+    port;
+    user;
+    password;
+    socket = null;
+    buffer = '';
+    /** Resolvers waiting for the next complete response */
+    waiters = [];
+    constructor(host, port, user, password) {
+        this.host = host;
+        this.port = port;
+        this.user = user;
+        this.password = password;
+    }
+    // ---------------------------------------------------------------------------
+    // Public API
+    // ---------------------------------------------------------------------------
+    async connect() {
+        await this._tlsConnect();
+        // Read server greeting
+        await this._readResponse();
+        // Authenticate
+        await this._authenticate();
+    }
+    async disconnect() {
+        if (!this.socket)
+            return;
+        try {
+            this._send('LOGOUT\r\n');
+            await this._readResponse();
+        }
+        catch {
+            // Ignore errors during logout
+        }
+        finally {
+            this.socket.destroy();
+            this.socket = null;
+            this.buffer = '';
+            this.waiters = [];
+        }
+    }
+    async listScripts() {
+        this._assertConnected();
+        this._send('LISTSCRIPTS\r\n');
+        const response = await this._readResponse();
+        return this._parseScriptList(response);
+    }
+    async getScript(name) {
+        this._assertConnected();
+        this._send(`GETSCRIPT ${this._quoteString(name)}\r\n`);
+        const response = await this._readResponse();
+        return this._parseLiteralContent(response);
+    }
+    async putScript(name, content) {
+        this._assertConnected();
+        const bytes = Buffer.byteLength(content, 'utf-8');
+        // Non-synchronizing literal: {N+} means server should not send a continuation
+        const cmd = `PUTSCRIPT ${this._quoteString(name)} {${bytes}+}\r\n${content}\r\n`;
+        this._send(cmd);
+        await this._readResponse();
+    }
+    async deleteScript(name) {
+        this._assertConnected();
+        this._send(`DELETESCRIPT ${this._quoteString(name)}\r\n`);
+        await this._readResponse();
+    }
+    // ---------------------------------------------------------------------------
+    // Private — connection
+    // ---------------------------------------------------------------------------
+    _tlsConnect() {
+        return new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                reject(new Error('ManageSieve not supported by this server (connection timeout). ' +
+                    'SIEVE filters require ManageSieve (RFC 5804), typically available on ' +
+                    'self-hosted servers but not on Gmail or Outlook.'));
+            }, CONNECTION_TIMEOUT_MS);
+            const sock = tls.connect({
+                host: this.host,
+                port: this.port,
+                rejectUnauthorized: false, // self-signed certs common on self-hosted servers
+            }, () => {
+                clearTimeout(timer);
+                resolve();
+            });
+            // Accumulate incoming data into our buffer
+            sock.on('data', (chunk) => {
+                this.buffer += typeof chunk === 'string' ? chunk : chunk.toString('utf-8');
+                this._drainWaiters();
+            });
+            sock.on('error', (err) => {
+                clearTimeout(timer);
+                const code = err.code ?? '';
+                if (code === 'ECONNREFUSED' || code === 'ENOTFOUND' || code === 'ETIMEDOUT') {
+                    reject(new Error(`ManageSieve not supported by this server (${err.message}). ` +
+                        'SIEVE filters require ManageSieve (RFC 5804), typically available on ' +
+                        'self-hosted servers but not on Gmail or Outlook.'));
+                }
+                else {
+                    reject(err);
+                }
+            });
+            this.socket = sock;
+        });
+    }
+    async _authenticate() {
+        // PLAIN SASL: \0username\0password → base64
+        const plain = `\0${this.user}\0${this.password}`;
+        const encoded = Buffer.from(plain).toString('base64');
+        this._send(`AUTHENTICATE "PLAIN" "${encoded}"\r\n`);
+        await this._readResponse();
+    }
+    // ---------------------------------------------------------------------------
+    // Private — I/O
+    // ---------------------------------------------------------------------------
+    _assertConnected() {
+        if (!this.socket) {
+            throw new Error('SieveClient: not connected. Call connect() first.');
+        }
+    }
+    _send(data) {
+        this.socket.write(data);
+    }
+    /**
+     * Resolves when a complete response is available in the buffer.
+     * Throws on NO or BYE responses.
+     */
+    _readResponse() {
+        return new Promise((resolve, reject) => {
+            const waiter = (full) => {
+                const termMatch = full.match(/^(OK|NO|BYE)[^\r\n]*/im);
+                if (!termMatch) {
+                    resolve(full);
+                    return;
+                }
+                const terminal = termMatch[1].toUpperCase();
+                if (terminal === 'NO' || terminal === 'BYE') {
+                    // Extract message from last line
+                    const lines = full.trimEnd().split('\r\n');
+                    const lastLine = lines[lines.length - 1];
+                    const msgMatch = lastLine.match(/^(?:NO|BYE)\s+"?([^"]*)"?/i);
+                    const msg = msgMatch?.[1] ?? lastLine;
+                    reject(new Error(msg || `ManageSieve error: ${terminal}`));
+                }
+                else {
+                    resolve(full);
+                }
+            };
+            // Try immediately in case data is already buffered
+            const result = this._tryConsumeResponse();
+            if (result !== null) {
+                waiter(result);
+            }
+            else {
+                this.waiters.push(waiter);
+            }
+        });
+    }
+    /**
+     * Called whenever new data arrives. Checks if a complete response is ready
+     * and resolves the oldest waiter if so.
+     */
+    _drainWaiters() {
+        while (this.waiters.length > 0) {
+            const result = this._tryConsumeResponse();
+            if (result === null)
+                break;
+            const waiter = this.waiters.shift();
+            waiter(result);
+        }
+    }
+    /**
+     * Attempt to consume a complete response from the buffer.
+     * A response ends with a line starting with OK, NO, or BYE.
+     * May contain literal strings: {N}\r\n followed by N bytes.
+     * Returns null if the response is not yet complete.
+     */
+    _tryConsumeResponse() {
+        let pos = 0;
+        const buf = this.buffer;
+        while (pos < buf.length) {
+            const lineEnd = buf.indexOf('\r\n', pos);
+            if (lineEnd === -1) {
+                // Incomplete line
+                return null;
+            }
+            const line = buf.slice(pos, lineEnd);
+            const nextPos = lineEnd + 2;
+            // Check for literal string: {N} or {N+}
+            const literalMatch = line.match(/^\{(\d+)\+?\}$/);
+            if (literalMatch) {
+                const byteCount = parseInt(literalMatch[1], 10);
+                if (nextPos + byteCount > buf.length) {
+                    // Literal not fully received yet
+                    return null;
+                }
+                // Skip past the literal data
+                pos = nextPos + byteCount;
+                continue;
+            }
+            // Check for terminal lines
+            const termMatch = line.match(/^(OK|NO|BYE)(?:\s|$)/i);
+            if (termMatch) {
+                const consumed = nextPos;
+                const full = buf.slice(0, consumed);
+                this.buffer = buf.slice(consumed);
+                return full;
+            }
+            pos = nextPos;
+        }
+        return null;
+    }
+    // ---------------------------------------------------------------------------
+    // Private — response parsers
+    // ---------------------------------------------------------------------------
+    _parseScriptList(response) {
+        const scripts = [];
+        const lines = response.split('\r\n');
+        for (const line of lines) {
+            // Lines: "scriptname" ACTIVE  or  "scriptname"
+            const match = line.match(/^"([^"]+)"(\s+ACTIVE)?/i);
+            if (match) {
+                scripts.push({
+                    name: match[1],
+                    active: Boolean(match[2]),
+                });
+            }
+        }
+        return scripts;
+    }
+    _parseLiteralContent(response) {
+        // Response: {N}\r\n<N bytes>\r\nOK\r\n
+        const literalMatch = response.match(/^\{(\d+)\}\r\n/);
+        if (!literalMatch) {
+            throw new Error('Unexpected GETSCRIPT response format');
+        }
+        const byteCount = parseInt(literalMatch[1], 10);
+        const contentStart = literalMatch[0].length;
+        return response.slice(contentStart, contentStart + byteCount);
+    }
+    _quoteString(s) {
+        return `"${s.replace(/\\/g, '\\\\').replace(/"/g, '\\"')}"`;
+    }
+}
+//# sourceMappingURL=sieve.js.map

package/dist/protocol/sieve.js.map

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

package/dist/protocol/smtp.d.ts

@@ -4,5 +4,5 @@ export declare class SmtpClient {
     private account;
     constructor(account: EmailAccount);
     connect(): Promise<void>;
-    send(to: string, subject: string, body: string, isHtml?: boolean, cc?: string, bcc?: string): Promise<any>;
+    send(to: string, subject: string, body: string, isHtml?: boolean, cc?: string, bcc?: string, extraHeaders?: Record<string, string>): Promise<any>;
 }

package/dist/protocol/smtp.js

@@ -30,7 +30,7 @@ export class SmtpClient {
         });
         await this.transporter.verify();
     }
-    async send(to, subject, body, isHtml = false, cc, bcc) {
+    async send(to, subject, body, isHtml = false, cc, bcc, extraHeaders) {
         if (!this.transporter) {
             throw new Error('SMTP client not connected');
         }
@@ -43,6 +43,9 @@ export class SmtpClient {
             mailOptions.cc = cc;
         if (bcc)
             mailOptions.bcc = bcc;
+        if (extraHeaders && Object.keys(extraHeaders).length > 0) {
+            mailOptions.headers = extraHeaders;
+        }
         if (isHtml) {
             mailOptions.html = body;
         }

package/dist/protocol/smtp.js.map

@@ -1 +1 @@
-{"version":3,"file":"smtp.js","sourceRoot":"","sources":["../../src/protocol/smtp.ts"],"names":[],"mappings":"AAAA,OAAO,UAAU,MAAM,YAAY,CAAC;AAEpC,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAE5D,MAAM,OAAO,UAAU;IACb,WAAW,GAAkC,IAAI,CAAC;IAClD,OAAO,CAAe;IAE9B,YAAY,OAAqB;QAC/B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED,KAAK,CAAC,OAAO;QACX,IAAI,UAAU,GAAQ,EAAE,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;QAElD,IAAI,IAAI,CAAC,OAAO,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;YACvC,MAAM,WAAW,GAAG,MAAM,mBAAmB,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;YAC/D,UAAU,CAAC,IAAI,GAAG,QAAQ,CAAC;YAC3B,UAAU,CAAC,WAAW,GAAG,WAAW,CAAC;QACvC,CAAC;aAAM,CAAC;YACN,MAAM,QAAQ,GAAG,MAAM,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;YACxD,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,MAAM,IAAI,KAAK,CAAC,sCAAsC,IAAI,CAAC,OAAO,CAAC,EAAE,EAAE,CAAC,CAAC;YAC3E,CAAC;YACD,UAAU,CAAC,IAAI,GAAG,QAAQ,CAAC;QAC7B,CAAC;QAED,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,IAAI,GAAG,CAAC;QAC9C,IAAI,CAAC,WAAW,GAAG,UAAU,CAAC,eAAe,CAAC;YAC5C,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,QAAQ,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI;YAChD,IAAI,EAAE,QAAQ;YACd,MAAM,EAAE,QAAQ,KAAK,GAAG;YACxB,IAAI,EAAE,UAAU;SACjB,CAAC,CAAC;QAEH,MAAM,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,CAAC;IAClC,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,EAAU,EAAE,OAAe,EAAE,IAAY,EAAE,SAAkB,KAAK,EAAE,EAAW,EAAE,GAAY;QACtG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;QAC/C,CAAC;QAED,MAAM,WAAW,GAAQ;YACvB,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI;YACvB,EAAE;YACF,OAAO;SACR,CAAC;QACF,IAAI,EAAE;YAAE,WAAW,CAAC,EAAE,GAAG,EAAE,CAAC;QAC5B,IAAI,GAAG;YAAE,WAAW,CAAC,GAAG,GAAG,GAAG,CAAC;QAE/B,IAAI,MAAM,EAAE,CAAC;YACX,WAAW,CAAC,IAAI,GAAG,IAAI,CAAC;QAC1B,CAAC;aAAM,CAAC;YACN,WAAW,CAAC,IAAI,GAAG,IAAI,CAAC;QAC1B,CAAC;QAED,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;QAC1D,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}
+{"version":3,"file":"smtp.js","sourceRoot":"","sources":["../../src/protocol/smtp.ts"],"names":[],"mappings":"AAAA,OAAO,UAAU,MAAM,YAAY,CAAC;AAEpC,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAE5D,MAAM,OAAO,UAAU;IACb,WAAW,GAAkC,IAAI,CAAC;IAClD,OAAO,CAAe;IAE9B,YAAY,OAAqB;QAC/B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED,KAAK,CAAC,OAAO;QACX,IAAI,UAAU,GAAQ,EAAE,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;QAElD,IAAI,IAAI,CAAC,OAAO,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;YACvC,MAAM,WAAW,GAAG,MAAM,mBAAmB,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;YAC/D,UAAU,CAAC,IAAI,GAAG,QAAQ,CAAC;YAC3B,UAAU,CAAC,WAAW,GAAG,WAAW,CAAC;QACvC,CAAC;aAAM,CAAC;YACN,MAAM,QAAQ,GAAG,MAAM,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;YACxD,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,MAAM,IAAI,KAAK,CAAC,sCAAsC,IAAI,CAAC,OAAO,CAAC,EAAE,EAAE,CAAC,CAAC;YAC3E,CAAC;YACD,UAAU,CAAC,IAAI,GAAG,QAAQ,CAAC;QAC7B,CAAC;QAED,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,IAAI,GAAG,CAAC;QAC9C,IAAI,CAAC,WAAW,GAAG,UAAU,CAAC,eAAe,CAAC;YAC5C,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,QAAQ,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI;YAChD,IAAI,EAAE,QAAQ;YACd,MAAM,EAAE,QAAQ,KAAK,GAAG;YACxB,IAAI,EAAE,UAAU;SACjB,CAAC,CAAC;QAEH,MAAM,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,CAAC;IAClC,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,EAAU,EAAE,OAAe,EAAE,IAAY,EAAE,SAAkB,KAAK,EAAE,EAAW,EAAE,GAAY,EAAE,YAAqC;QAC7I,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;QAC/C,CAAC;QAED,MAAM,WAAW,GAAQ;YACvB,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI;YACvB,EAAE;YACF,OAAO;SACR,CAAC;QACF,IAAI,EAAE;YAAE,WAAW,CAAC,EAAE,GAAG,EAAE,CAAC;QAC5B,IAAI,GAAG;YAAE,WAAW,CAAC,GAAG,GAAG,GAAG,CAAC;QAC/B,IAAI,YAAY,IAAI,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACzD,WAAW,CAAC,OAAO,GAAG,YAAY,CAAC;QACrC,CAAC;QAED,IAAI,MAAM,EAAE,CAAC;YACX,WAAW,CAAC,IAAI,GAAG,IAAI,CAAC;QAC1B,CAAC;aAAM,CAAC;YACN,WAAW,CAAC,IAAI,GAAG,IAAI,CAAC;QAC1B,CAAC;QAED,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;QAC1D,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}

package/dist/services/mail.d.ts

@@ -1,4 +1,4 @@
-import { ImapClient, MessageMetadata } from '../protocol/imap.js';
+import { ImapClient, MessageMetadata, MailboxStatus } from '../protocol/imap.js';
 import { EmailAccount } from '../types/index.js';
 /**
  * Pure helper — appends `signature` to `body` when `includeSignature` is true and
@@ -6,19 +6,26 @@ import { EmailAccount } from '../types/index.js';
  * HTML bodies get the signature wrapped in a styled paragraph.
  */
 export declare function applySignature(body: string, signature: string | undefined, isHtml: boolean, includeSignature: boolean): string;
+export interface ContactInfo {
+    name: string;
+    email: string;
+    count: number;
+    lastSeen: string;
+}
 export declare class MailService {
     private readonly readOnly;
+    private readonly redact;
     private imapClient;
     private smtpClient;
     private account;
     private smtpConnected;
     private readonly bodyCache;
-    constructor(account: EmailAccount, readOnly?: boolean);
+    constructor(account: EmailAccount, readOnly?: boolean, redact?: boolean);
     get imap(): ImapClient;
     connect(): Promise<void>;
     private ensureSmtp;
     disconnect(): Promise<void>;
-    listEmails(folder?: string, count?: number, offset?: number): Promise<MessageMetadata[]>;
+    listEmails(folder?: string, count?: number, offset?: number, headerOnly?: boolean): Promise<MessageMetadata[]>;
     searchEmails(query: {
         from?: string;
         subject?: string;
@@ -27,9 +34,18 @@ export declare class MailService {
         keywords?: string;
     }, folder?: string, count?: number, offset?: number): Promise<MessageMetadata[]>;
     sendEmail(to: string, subject: string, body: string, isHtml?: boolean, cc?: string, bcc?: string, includeSignature?: boolean): Promise<any>;
+    replyEmail(uid: string, folder: string | undefined, body: string, isHtml?: boolean, cc?: string, bcc?: string, includeSignature?: boolean): Promise<any>;
+    forwardEmail(uid: string, folder: string | undefined, to: string, body?: string, isHtml?: boolean, cc?: string, bcc?: string, includeSignature?: boolean): Promise<any>;
     createDraft(to: string, subject: string, body: string, isHtml?: boolean, cc?: string, bcc?: string, includeSignature?: boolean): Promise<void>;
     private _cachedFetchBody;
     invalidateBodyCache(folder: string, uid: string): void;
+    /**
+     * Parses the raw value of a `List-Unsubscribe` header.
+     * The header contains angle-bracket-delimited tokens, e.g.:
+     *   `<mailto:unsub@example.com>, <https://example.com/unsub>`
+     * Returns separate arrays for https URLs and mailto addresses.
+     */
+    private parseUnsubscribeHeader;
     readEmail(uid: string, folder?: string): Promise<string>;
     getThread(threadId: string, folder?: string): Promise<MessageMetadata[]>;
     downloadAttachment(uid: string, filename: string, folder?: string, maxBytes?: number): Promise<{
@@ -37,8 +53,11 @@ export declare class MailService {
         contentType: string;
     }>;
     extractAttachmentText(uid: string, filename: string, folder?: string): Promise<string>;
+    extractContacts(folder?: string, count?: number): Promise<ContactInfo[]>;
     listFolders(): Promise<string[]>;
+    getMailboxStats(folders?: string[]): Promise<MailboxStatus[]>;
     moveMessage(uid: string, sourceFolder: string, targetFolder: string): Promise<void>;
+    deleteEmail(uid: string, folder?: string): Promise<void>;
     modifyLabels(uid: string, folder: string, addLabels: string[], removeLabels: string[]): Promise<void>;
     batchOperations(uids: string[], folder: string, operation: {
         type: 'move';

package/dist/services/mail.js

@@ -3,6 +3,7 @@ import { SmtpClient } from '../protocol/smtp.js';
 import { htmlToMarkdown } from '../utils/markdown.js';
 import { ValidationError } from '../errors.js';
 import { MessageBodyCache } from '../utils/message-cache.js';
+import { redactSensitiveContent } from '../utils/redact.js';
 /**
  * Pure helper — appends `signature` to `body` when `includeSignature` is true and
  * `signature` is non-empty. Plain-text bodies get the RFC 3676 separator (`\n-- \n`);
@@ -18,13 +19,15 @@ export function applySignature(body, signature, isHtml, includeSignature) {
 }
 export class MailService {
     readOnly;
+    redact;
     imapClient;
     smtpClient;
     account;
     smtpConnected = false;
     bodyCache = new MessageBodyCache();
-    constructor(account, readOnly = false) {
+    constructor(account, readOnly = false, redact = false) {
         this.readOnly = readOnly;
+        this.redact = redact;
         this.account = account;
         this.imapClient = new ImapClient(account);
         this.smtpClient = new SmtpClient(account);
@@ -45,8 +48,8 @@ export class MailService {
         await this.imapClient.disconnect();
         // nodemailer transporter doesn't strictly need closing, but good practice if pooling
     }
-    async listEmails(folder = 'INBOX', count = 10, offset = 0) {
-        return this.imapClient.listMessages(folder, count, offset);
+    async listEmails(folder = 'INBOX', count = 10, offset = 0, headerOnly = false) {
+        return this.imapClient.listMessages(folder, count, offset, headerOnly);
     }
     async searchEmails(query, folder = 'INBOX', count = 10, offset = 0) {
         const criteria = {};
@@ -86,6 +89,105 @@ export class MailService {
         }
         return info;
     }
+    async replyEmail(uid, folder = 'INBOX', body, isHtml = false, cc, bcc, includeSignature = true) {
+        const parsed = await this._cachedFetchBody(uid, folder);
+        const originalMessageId = parsed.messageId;
+        const existingReferences = parsed.headers.get('references');
+        // Build RFC 2822 threading headers only when we have a Message-ID
+        const extraHeaders = {};
+        if (originalMessageId) {
+            extraHeaders['In-Reply-To'] = originalMessageId;
+            if (existingReferences) {
+                extraHeaders['References'] = `${existingReferences} ${originalMessageId}`;
+            }
+            else {
+                extraHeaders['References'] = originalMessageId;
+            }
+        }
+        // Determine reply-to address (original sender)
+        const originalFrom = Array.isArray(parsed.from?.value)
+            ? parsed.from.value[0]?.address
+            : parsed.from?.address;
+        const replyTo = originalFrom || 'unknown@example.com';
+        // Build subject with "Re: " prefix
+        const originalSubject = parsed.subject || '';
+        const replySubject = originalSubject.startsWith('Re: ')
+            ? originalSubject
+            : `Re: ${originalSubject}`;
+        const effectiveBody = applySignature(body, this.account.signature, isHtml, includeSignature);
+        // Build raw message for Sent folder append
+        const rawMessage = [
+            `From: ${this.account.user}`,
+            `To: ${replyTo}`,
+            ...(cc ? [`Cc: ${cc}`] : []),
+            ...(bcc ? [`Bcc: ${bcc}`] : []),
+            `Subject: ${replySubject}`,
+            ...(extraHeaders['In-Reply-To'] ? [`In-Reply-To: ${extraHeaders['In-Reply-To']}`] : []),
+            ...(extraHeaders['References'] ? [`References: ${extraHeaders['References']}`] : []),
+            'MIME-Version: 1.0',
+            `Content-Type: ${isHtml ? 'text/html' : 'text/plain'}; charset=utf-8`,
+            '',
+            effectiveBody,
+        ].join('\r\n');
+        await this.ensureSmtp();
+        const info = await this.smtpClient.send(replyTo, replySubject, effectiveBody, isHtml, cc, bcc, Object.keys(extraHeaders).length > 0 ? extraHeaders : undefined);
+        try {
+            await this.imapClient.appendMessage('Sent', rawMessage, ['\\Seen']);
+        }
+        catch (e) {
+            console.error('Failed to append reply to Sent folder:', e);
+        }
+        return info;
+    }
+    async forwardEmail(uid, folder = 'INBOX', to, body = '', isHtml = false, cc, bcc, includeSignature = true) {
+        const parsed = await this._cachedFetchBody(uid, folder);
+        // Build subject with "Fwd: " prefix
+        const originalSubject = parsed.subject || '';
+        const fwdSubject = originalSubject.startsWith('Fwd: ')
+            ? originalSubject
+            : `Fwd: ${originalSubject}`;
+        // Build forwarded message block (plain-text format)
+        const originalFrom = parsed.from?.text || 'Unknown';
+        const originalDate = parsed.date?.toISOString() || 'Unknown';
+        const originalTo = Array.isArray(parsed.to)
+            ? parsed.to.map((t) => t.text).join(', ')
+            : parsed.to?.text || 'Unknown';
+        const originalBody = parsed.text || '';
+        const forwardedBlock = [
+            '',
+            '',
+            '--- Forwarded message ---',
+            `From: ${originalFrom}`,
+            `Date: ${originalDate}`,
+            `Subject: ${originalSubject}`,
+            `To: ${originalTo}`,
+            '',
+            originalBody,
+        ].join('\n');
+        const combinedBody = body + forwardedBlock;
+        const effectiveBody = applySignature(combinedBody, this.account.signature, isHtml, includeSignature);
+        // Build raw message for Sent folder append
+        const rawMessage = [
+            `From: ${this.account.user}`,
+            `To: ${to}`,
+            ...(cc ? [`Cc: ${cc}`] : []),
+            ...(bcc ? [`Bcc: ${bcc}`] : []),
+            `Subject: ${fwdSubject}`,
+            'MIME-Version: 1.0',
+            `Content-Type: ${isHtml ? 'text/html' : 'text/plain'}; charset=utf-8`,
+            '',
+            effectiveBody,
+        ].join('\r\n');
+        await this.ensureSmtp();
+        const info = await this.smtpClient.send(to, fwdSubject, effectiveBody, isHtml, cc, bcc);
+        try {
+            await this.imapClient.appendMessage('Sent', rawMessage, ['\\Seen']);
+        }
+        catch (e) {
+            console.error('Failed to append forward to Sent folder:', e);
+        }
+        return info;
+    }
     async createDraft(to, subject, body, isHtml = false, cc, bcc, includeSignature = true) {
         const effectiveBody = applySignature(body, this.account.signature, isHtml, includeSignature);
         const headers = [
@@ -113,6 +215,28 @@ export class MailService {
     invalidateBodyCache(folder, uid) {
         this.bodyCache.delete(`${this.account.id}:${folder}:${uid}`);
     }
+    /**
+     * Parses the raw value of a `List-Unsubscribe` header.
+     * The header contains angle-bracket-delimited tokens, e.g.:
+     *   `<mailto:unsub@example.com>, <https://example.com/unsub>`
+     * Returns separate arrays for https URLs and mailto addresses.
+     */
+    parseUnsubscribeHeader(raw) {
+        const https = [];
+        const mailto = [];
+        const tokenRegex = /<([^>]+)>/g;
+        let match;
+        while ((match = tokenRegex.exec(raw)) !== null) {
+            const value = match[1].trim();
+            if (value.startsWith('https://') || value.startsWith('http://')) {
+                https.push(value);
+            }
+            else if (value.startsWith('mailto:')) {
+                mailto.push(value.slice('mailto:'.length));
+            }
+        }
+        return { https, mailto };
+    }
     async readEmail(uid, folder = 'INBOX') {
         const parsed = await this._cachedFetchBody(uid, folder);
         let content = '';
@@ -163,8 +287,24 @@ export class MailService {
         if (messageId) {
             header += `**Message-ID:** ${messageId}\n`;
         }
+        // Extract RFC 2369 List-Unsubscribe headers for mailing list management
+        const rawUnsub = parsed.headers.get('list-unsubscribe');
+        if (rawUnsub) {
+            const { https: httpsUrls, mailto: mailtoAddresses } = this.parseUnsubscribeHeader(String(rawUnsub));
+            for (const url of httpsUrls) {
+                header += `**Unsubscribe:** ${url}\n`;
+            }
+            const rawUnsubPost = parsed.headers.get('list-unsubscribe-post');
+            if (rawUnsubPost && String(rawUnsubPost).includes('List-Unsubscribe=One-Click')) {
+                header += `**Unsubscribe (one-click):** yes\n`;
+            }
+            for (const address of mailtoAddresses) {
+                header += `**Unsubscribe (mailto):** ${address}\n`;
+            }
+        }
         header += `\n---\n\n`;
-        return header + content + attachmentInfo;
+        const body = this.redact ? redactSensitiveContent(content) : content;
+        return header + body + attachmentInfo;
     }
     async getThread(threadId, folder = 'INBOX') {
         return this.imapClient.fetchThreadMessages(threadId, folder);
@@ -203,12 +343,53 @@ export class MailService {
             throw new Error(`Extraction not supported for content type: ${contentType}`);
         }
     }
+    async extractContacts(folder = 'INBOX', count = 100) {
+        const envelopes = await this.imapClient.scanSenderEnvelopes(folder, count);
+        // Aggregate by email address
+        const map = new Map();
+        for (const env of envelopes) {
+            const existing = map.get(env.email);
+            if (!existing) {
+                map.set(env.email, { name: env.name, count: 1, lastDate: env.date });
+            }
+            else {
+                existing.count++;
+                if (env.date > existing.lastDate) {
+                    existing.lastDate = env.date;
+                    existing.name = env.name;
+                }
+            }
+        }
+        // Build and sort
+        const contacts = Array.from(map.entries()).map(([email, data]) => ({
+            email,
+            name: data.name,
+            count: data.count,
+            lastSeen: data.lastDate.toISOString(),
+        }));
+        contacts.sort((a, b) => {
+            if (b.count !== a.count)
+                return b.count - a.count;
+            return b.lastSeen.localeCompare(a.lastSeen);
+        });
+        return contacts.slice(0, 50);
+    }
     async listFolders() {
         return this.imapClient.listFolders();
     }
+    async getMailboxStats(folders) {
+        const targetFolders = (!folders || folders.length === 0)
+            ? await this.imapClient.listFolders()
+            : folders;
+        return this.imapClient.getMailboxStatus(targetFolders);
+    }
     async moveMessage(uid, sourceFolder, targetFolder) {
         return this.imapClient.moveMessage(uid, sourceFolder, targetFolder);
     }
+    async deleteEmail(uid, folder = 'INBOX') {
+        await this.imapClient.deleteMessage(uid, folder);
+        this.invalidateBodyCache(folder, uid);
+    }
     async modifyLabels(uid, folder, addLabels, removeLabels) {
         return this.imapClient.modifyLabels(uid, folder, addLabels, removeLabels);
     }