@rubytech/create-realagent 1.0.406

package/payload/platform/plugins/email/mcp/dist/tools/email-graph-query.js

@@ -0,0 +1,188 @@
+import neo4j from "neo4j-driver";
+import { getSession } from "../lib/neo4j.js";
+import { computeEmbedding } from "../lib/embedding.js";
+import { getThreadInfo, stripAngleBrackets } from "../lib/graph.js";
+/**
+ * Query Email nodes stored in the graph.
+ *
+ * Two modes:
+ *   - List (no query): Cypher MATCH with optional filters, sorted by receivedAt DESC
+ *   - Search (query provided): embed via Ollama, vector similarity on email_embedding index
+ *
+ * Always scoped to accountId. Thread info enriched when available.
+ */
+export async function emailGraphQuery(params) {
+    const limit = Math.min(Math.max(1, params.limit ?? 20), 50);
+    const offset = Math.max(0, params.offset ?? 0);
+    const query = params.query?.trim();
+    let emails;
+    if (query && query.length > 0) {
+        emails = await searchMode(query, params, limit);
+    }
+    else {
+        emails = await listMode(params, limit, offset);
+    }
+    if (emails.length === 0) {
+        return formatEmptyResult(params, query);
+    }
+    // Enrich with thread info (best-effort)
+    const messageIds = emails
+        .map((e) => e.messageId)
+        .filter((id) => !!id);
+    let threadMap = new Map();
+    try {
+        threadMap = await getThreadInfo(messageIds, params.accountId);
+    }
+    catch {
+        // Thread enrichment is optional — continue without it
+    }
+    const lines = emails
+        .map((e) => {
+        let entry = `From: ${e.fromName ? `${e.fromName} <${e.fromAddress}>` : e.fromAddress}`;
+        entry += `\nSubject: ${e.subject}`;
+        entry += `\nDate: ${e.receivedAt}`;
+        if (e.direction === "outbound")
+            entry += `\nDirection: outbound`;
+        if (e.messageId)
+            entry += `\nMessage-ID: ${e.messageId}`;
+        if (e.inReplyTo)
+            entry += `\nIn-Reply-To: ${e.inReplyTo}`;
+        if (e.score !== undefined)
+            entry += `\nScore: ${e.score.toFixed(3)}`;
+        const normalisedMid = stripAngleBrackets(e.messageId);
+        if (normalisedMid) {
+            const thread = threadMap.get(normalisedMid);
+            if (thread) {
+                entry += `\nThread-Depth: ${thread.threadDepth}`;
+                entry += `\nThread-ID: ${thread.threadId}`;
+            }
+        }
+        if (e.bodyPreview)
+            entry += `\n\n${e.bodyPreview}`;
+        return entry + "\n---";
+    })
+        .join("\n\n");
+    // Pagination hint for list mode only (search mode is ranked by similarity, not paginated)
+    if (!query && emails.length === limit) {
+        return `${lines}\n\nPagination: next offset=${offset + limit} (pass as offset to get more results)`;
+    }
+    return lines;
+}
+// ---------------------------------------------------------------------------
+// List mode — Cypher query with optional filters
+// ---------------------------------------------------------------------------
+async function listMode(params, limit, offset) {
+    // Exclude discarded emails (spam) from list results. Legacy emails without
+    // a screening property (IS NULL) are included — only explicitly discarded
+    // emails are hidden. Admin can still find them via direct Cypher.
+    const conditions = [
+        "e.accountId = $accountId",
+        "(e.screening <> 'discarded' OR e.screening IS NULL)",
+    ];
+    const cyParams = {
+        accountId: params.accountId,
+        limit: neo4j.int(limit),
+        offset: neo4j.int(offset),
+    };
+    if (params.sender) {
+        conditions.push("toLower(e.fromAddress) CONTAINS toLower($sender)");
+        cyParams.sender = params.sender;
+    }
+    if (params.dateFrom) {
+        conditions.push("e.receivedAt >= $dateFrom");
+        cyParams.dateFrom = params.dateFrom;
+    }
+    if (params.dateTo) {
+        conditions.push("e.receivedAt <= $dateTo");
+        cyParams.dateTo = params.dateTo;
+    }
+    if (params.direction === "outbound") {
+        conditions.push("e.direction = 'outbound'");
+    }
+    else if (params.direction === "inbound") {
+        conditions.push("e.direction IS NULL");
+    }
+    const cypher = `
+    MATCH (e:Email)
+    WHERE ${conditions.join(" AND ")}
+    RETURN e
+    ORDER BY e.receivedAt DESC
+    SKIP $offset
+    LIMIT $limit
+  `;
+    const session = getSession();
+    try {
+        const result = await session.run(cypher, cyParams);
+        return result.records.map((r) => nodeToRecord(r.get("e")));
+    }
+    finally {
+        await session.close();
+    }
+}
+// ---------------------------------------------------------------------------
+// Search mode — vector similarity on email_embedding index
+// ---------------------------------------------------------------------------
+async function searchMode(query, params, limit) {
+    const embedding = await computeEmbedding(query);
+    if (embedding.length === 0) {
+        throw new Error("Semantic search unavailable — the embedding service is not responding. " +
+            "Try again without a query to list emails instead.");
+    }
+    // Over-fetch to account for accountId filtering, then trim
+    const topK = Math.min(limit * 3, 150);
+    const session = getSession();
+    try {
+        const result = await session.run(`CALL db.index.vector.queryNodes('email_embedding', $topK, $embedding)
+       YIELD node, score
+       WHERE node.accountId = $accountId
+       RETURN node, score
+       ORDER BY score DESC
+       LIMIT $limit`, {
+            topK: neo4j.int(topK),
+            embedding,
+            accountId: params.accountId,
+            limit: neo4j.int(limit),
+        });
+        return result.records.map((r) => {
+            const record = nodeToRecord(r.get("node"));
+            record.score = r.get("score");
+            return record;
+        });
+    }
+    finally {
+        await session.close();
+    }
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function nodeToRecord(node) {
+    const p = node.properties;
+    return {
+        emailId: p.emailId,
+        messageId: p.messageId ?? null,
+        inReplyTo: p.inReplyTo ?? null,
+        fromAddress: p.fromAddress,
+        fromName: p.fromName ?? null,
+        toAddresses: p.toAddresses ?? [],
+        subject: p.subject,
+        bodyPreview: p.bodyPreview ?? "",
+        receivedAt: p.receivedAt,
+        direction: p.direction ?? null,
+    };
+}
+function formatEmptyResult(params, query) {
+    const filters = [];
+    if (query)
+        filters.push(`query: "${query}"`);
+    if (params.sender)
+        filters.push(`sender: ${params.sender}`);
+    if (params.dateFrom)
+        filters.push(`from: ${params.dateFrom}`);
+    if (params.dateTo)
+        filters.push(`to: ${params.dateTo}`);
+    if (params.direction)
+        filters.push(`direction: ${params.direction}`);
+    return `No emails found in the graph${filters.length > 0 ? ` matching ${filters.join(", ")}` : ""}.`;
+}
+//# sourceMappingURL=email-graph-query.js.map

package/payload/platform/plugins/email/mcp/dist/tools/email-graph-query.js.map

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

package/payload/platform/plugins/email/mcp/dist/tools/email-otp-extract.d.ts

@@ -0,0 +1,15 @@
+interface OtpParams {
+    accountId: string;
+    sender: string;
+    subjectPattern?: string;
+    timeout?: number;
+}
+export declare function emailOtpExtract(params: OtpParams): Promise<{
+    success: boolean;
+    code?: string;
+    message: string;
+    from?: string;
+    subject?: string;
+}>;
+export {};
+//# sourceMappingURL=email-otp-extract.d.ts.map

package/payload/platform/plugins/email/mcp/dist/tools/email-otp-extract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"email-otp-extract.d.ts","sourceRoot":"","sources":["../../src/tools/email-otp-extract.ts"],"names":[],"mappings":"AAsDA,UAAU,SAAS;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,wBAAsB,eAAe,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC;IAChE,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC,CAkGD"}

package/payload/platform/plugins/email/mcp/dist/tools/email-otp-extract.js

@@ -0,0 +1,142 @@
+import { loadCredentials } from "../lib/credentials.js";
+import { fetchRecent, stripHtml } from "../lib/imap.js";
+const POLL_INTERVAL_MS = 5_000;
+/**
+ * OTP context patterns — phrases that typically surround a verification code.
+ * The regex captures the numeric code adjacent to these contextual markers.
+ * None use the /g flag — they are stateless and safe for repeated exec() calls.
+ */
+const OTP_CONTEXT_PATTERNS = [
+    /(?:verification|verify|security|confirmation|one[- ]time|otp|login|sign[- ]?in|access)\s*(?:code|pin|number|token)\s*(?:is|:)?\s*(\d{4,8})/i,
+    /(\d{4,8})\s*(?:is your|is the)\s*(?:verification|security|confirmation|one[- ]time|otp|login|sign[- ]?in)/i,
+    /(?:code|pin|token)\s*(?:is|:)\s*(\d{4,8})/i,
+    /(?:enter|use|input|type)\s*(?:the\s*)?(?:code\s*)?(\d{4,8})/i,
+];
+function extractOtpFromText(text) {
+    // Try context-aware patterns first
+    for (const pattern of OTP_CONTEXT_PATTERNS) {
+        const match = pattern.exec(text);
+        if (match?.[1])
+            return match[1];
+    }
+    // Fallback: extract standalone 4-8 digit numbers, filtering false positives.
+    // Pattern created locally to avoid /g lastIndex state leaking between calls.
+    const standalonePattern = /\b(\d{4,8})\b/g;
+    const matches = [];
+    let match;
+    while ((match = standalonePattern.exec(text)) !== null) {
+        const num = match[1];
+        // Filter out likely years (1900-2099)
+        if (/^(19|20)\d{2}$/.test(num))
+            continue;
+        // Filter out numbers that are part of a phone-like sequence
+        const surrounding = text.slice(Math.max(0, match.index - 5), match.index + num.length + 5);
+        if (/\+?\d[\d\s\-()]{9,}/.test(surrounding))
+            continue;
+        matches.push(num);
+    }
+    // If exactly one candidate remains, it's likely the OTP
+    if (matches.length === 1)
+        return matches[0];
+    // Multiple candidates — prefer 6-digit codes (most common OTP length)
+    const sixDigit = matches.find((m) => m.length === 6);
+    if (sixDigit)
+        return sixDigit;
+    // Return the first candidate if any exist
+    return matches[0] ?? null;
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+export async function emailOtpExtract(params) {
+    const result = await loadCredentials(params.accountId);
+    if ("error" in result) {
+        return { success: false, message: result.error };
+    }
+    const { config, password } = result.credentials;
+    const timeoutMs = (params.timeout ?? 60) * 1000;
+    const senderDomain = params.sender.toLowerCase();
+    const startTime = Date.now();
+    const to = config.agentAddress !== config.email ? config.agentAddress : undefined;
+    // Compile subject regex once (not per-message) — also avoids ReDoS on each iteration
+    let subjectRegex = null;
+    if (params.subjectPattern) {
+        try {
+            subjectRegex = new RegExp(params.subjectPattern, "i");
+        }
+        catch {
+            // Invalid regex — ignore filter
+        }
+    }
+    // Phase 1: Check recent messages (last 5 minutes) for an OTP that already arrived
+    const recentSince = new Date(Date.now() - 5 * 60 * 1000);
+    const { messages: recentMessages } = await fetchRecent(config, password, {
+        limit: 10,
+        since: recentSince,
+        to,
+    });
+    for (const msg of recentMessages) {
+        if (!msg.from.toLowerCase().includes(senderDomain))
+            continue;
+        if (subjectRegex && !subjectRegex.test(msg.subject))
+            continue;
+        const text = stripHtml(msg.bodyPreview);
+        const code = extractOtpFromText(text);
+        if (code) {
+            return {
+                success: true,
+                code,
+                message: `OTP extracted: ${code}`,
+                from: msg.from,
+                subject: msg.subject,
+            };
+        }
+    }
+    // Phase 2: Poll for new messages until timeout
+    // Track the best "found but no code" match to report if timeout expires
+    let bestNoCodeMatch = null;
+    while (Date.now() - startTime < timeoutMs) {
+        await sleep(POLL_INTERVAL_MS);
+        const { messages } = await fetchRecent(config, password, {
+            limit: 5,
+            since: recentSince,
+            to,
+        });
+        for (const msg of messages) {
+            if (!msg.from.toLowerCase().includes(senderDomain))
+                continue;
+            if (subjectRegex && !subjectRegex.test(msg.subject))
+                continue;
+            const text = stripHtml(msg.bodyPreview);
+            const code = extractOtpFromText(text);
+            if (code) {
+                return {
+                    success: true,
+                    code,
+                    message: `OTP extracted: ${code}`,
+                    from: msg.from,
+                    subject: msg.subject,
+                };
+            }
+            // Found a matching email but no code — record it but keep polling
+            if (!bestNoCodeMatch) {
+                bestNoCodeMatch = { from: msg.from, subject: msg.subject, preview: text.slice(0, 200) };
+            }
+        }
+    }
+    // Timeout reached
+    const elapsed = Math.round((Date.now() - startTime) / 1000);
+    if (bestNoCodeMatch) {
+        return {
+            success: false,
+            message: `Found email from ${bestNoCodeMatch.from} ("${bestNoCodeMatch.subject}") but could not extract a verification code within ${elapsed}s. Body preview: ${bestNoCodeMatch.preview}`,
+            from: bestNoCodeMatch.from,
+            subject: bestNoCodeMatch.subject,
+        };
+    }
+    return {
+        success: false,
+        message: `No verification email from *${senderDomain}* received within ${elapsed}s. Check the email address is correct, or ask the service to resend the code.`,
+    };
+}
+//# sourceMappingURL=email-otp-extract.js.map

package/payload/platform/plugins/email/mcp/dist/tools/email-otp-extract.js.map

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

package/payload/platform/plugins/email/mcp/dist/tools/email-read.d.ts

@@ -0,0 +1,14 @@
+interface ReadParams {
+    accountId: string;
+    sender?: string;
+    subjectPattern?: string;
+    since?: string;
+    before?: string;
+    to?: string;
+    folder?: "inbox" | "sent";
+    before_uid?: number;
+    limit?: number;
+}
+export declare function emailRead(params: ReadParams): Promise<string>;
+export {};
+//# sourceMappingURL=email-read.d.ts.map

package/payload/platform/plugins/email/mcp/dist/tools/email-read.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"email-read.d.ts","sourceRoot":"","sources":["../../src/tools/email-read.ts"],"names":[],"mappings":"AAIA,UAAU,UAAU;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAsB,SAAS,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAoEnE"}

package/payload/platform/plugins/email/mcp/dist/tools/email-read.js

@@ -0,0 +1,75 @@
+import { loadCredentials } from "../lib/credentials.js";
+import { fetchRecent, MAX_LIMIT } from "../lib/imap.js";
+import { getThreadInfo, stripAngleBrackets } from "../lib/graph.js";
+export async function emailRead(params) {
+    const result = await loadCredentials(params.accountId);
+    if ("error" in result)
+        throw new Error(result.error);
+    const { config, password } = result.credentials;
+    // Clamp limit to hard cap — silently, per spec
+    const requestedLimit = Math.max(1, params.limit ?? 20);
+    const limit = Math.min(requestedLimit, MAX_LIMIT);
+    // Use agent address for TO filtering when alias is configured
+    // Coerce empty string to undefined to avoid matching nothing silently
+    const to = (params.to || undefined) ?? (config.agentAddress !== config.email ? config.agentAddress : undefined);
+    const { messages, nextBeforeUid } = await fetchRecent(config, password, {
+        limit,
+        sender: params.sender,
+        subjectPattern: params.subjectPattern,
+        since: params.since ? new Date(params.since) : undefined,
+        before: params.before ? new Date(params.before) : undefined,
+        to,
+        folder: params.folder,
+        beforeUid: params.before_uid,
+    });
+    if (messages.length === 0) {
+        const filters = [];
+        if (params.sender)
+            filters.push(`from: ${params.sender}`);
+        if (params.subjectPattern)
+            filters.push(`subject: ${params.subjectPattern}`);
+        if (params.since)
+            filters.push(`since: ${params.since}`);
+        if (params.before)
+            filters.push(`before: ${params.before}`);
+        if (params.to)
+            filters.push(`to: ${params.to}`);
+        if (params.folder)
+            filters.push(`folder: ${params.folder}`);
+        return `No messages found${filters.length > 0 ? ` matching ${filters.join(", ")}` : ""}.`;
+    }
+    // Enrich with thread info from the graph (best-effort — failures return empty map)
+    const messageIds = messages.map((m) => m.messageId).filter((id) => !!id);
+    let threadMap = new Map();
+    try {
+        threadMap = await getThreadInfo(messageIds, params.accountId);
+    }
+    catch {
+        // Thread enrichment is optional — continue without it
+    }
+    const lines = messages
+        .map((m) => {
+        let entry = `UID: ${m.uid}\nFrom: ${m.from}\nSubject: ${m.subject}\nDate: ${m.date}`;
+        if (m.messageId)
+            entry += `\nMessage-ID: ${m.messageId}`;
+        if (m.inReplyTo)
+            entry += `\nIn-Reply-To: ${m.inReplyTo}`;
+        const normalisedMid = stripAngleBrackets(m.messageId);
+        if (normalisedMid) {
+            const thread = threadMap.get(normalisedMid);
+            if (thread) {
+                entry += `\nThread-Depth: ${thread.threadDepth}`;
+                entry += `\nThread-ID: ${thread.threadId}`;
+            }
+        }
+        if (m.bodyPreview)
+            entry += `\n\n${m.bodyPreview}`;
+        return entry + "\n---";
+    })
+        .join("\n\n");
+    if (nextBeforeUid) {
+        return `${lines}\n\nPagination: next_before_uid=${nextBeforeUid} (pass as before_uid to get older messages)`;
+    }
+    return lines;
+}
+//# sourceMappingURL=email-read.js.map

package/payload/platform/plugins/email/mcp/dist/tools/email-read.js.map

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

package/payload/platform/plugins/email/mcp/dist/tools/email-reply.d.ts

@@ -0,0 +1,10 @@
+interface ReplyParams {
+    accountId: string;
+    messageId: string;
+    body: string;
+    html?: string;
+    replyAll?: boolean;
+}
+export declare function emailReply(params: ReplyParams): Promise<string>;
+export {};
+//# sourceMappingURL=email-reply.d.ts.map

package/payload/platform/plugins/email/mcp/dist/tools/email-reply.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"email-reply.d.ts","sourceRoot":"","sources":["../../src/tools/email-reply.ts"],"names":[],"mappings":"AAIA,UAAU,WAAW;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAUD,wBAAsB,UAAU,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAsFrE"}

package/payload/platform/plugins/email/mcp/dist/tools/email-reply.js

@@ -0,0 +1,83 @@
+import { loadCredentials } from "../lib/credentials.js";
+import { sendEmail } from "../lib/smtp.js";
+import { getSession } from "../lib/neo4j.js";
+/**
+ * Strip duplicate Re:/RE:/re: prefixes and prepend a single Re:.
+ */
+function replySubject(subject) {
+    const stripped = subject.replace(/^(Re:\s*)+/i, "").trim();
+    return `Re: ${stripped || "(no subject)"}`;
+}
+export async function emailReply(params) {
+    const result = await loadCredentials(params.accountId);
+    if ("error" in result)
+        throw new Error(result.error);
+    const { config, password } = result.credentials;
+    // Look up the original email in the graph by messageId
+    const session = getSession();
+    try {
+        const queryResult = await session.run(`MATCH (e:Email {messageId: $messageId, accountId: $accountId})
+       RETURN e.messageId AS messageId,
+              e.fromAddress AS fromAddress,
+              e.toAddresses AS toAddresses,
+              e.ccAddresses AS ccAddresses,
+              e.subject AS subject`, { messageId: params.messageId, accountId: params.accountId });
+        if (queryResult.records.length === 0) {
+            throw new Error(`No email found with Message-ID ${params.messageId}. The email may not have been fetched yet — emails are stored by the background polling job.`);
+        }
+        const record = queryResult.records[0];
+        const originalMessageId = record.get("messageId");
+        const originalFrom = record.get("fromAddress");
+        const originalTo = record.get("toAddresses") ?? [];
+        const originalCc = record.get("ccAddresses") ?? [];
+        const originalSubject = record.get("subject") ?? "(no subject)";
+        if (!originalMessageId) {
+            throw new Error("Cannot reply — the original email has no Message-ID header. This can happen with malformed messages from some servers.");
+        }
+        // Guard: don't reply to own messages
+        const agentAddr = config.agentAddress.toLowerCase();
+        if (originalFrom.toLowerCase() === agentAddr) {
+            throw new Error("Cannot reply to a message sent from the agent's own address.");
+        }
+        // Build recipient list
+        let to;
+        if (params.replyAll) {
+            // Union of original sender + TO + CC, minus the agent's own address (case-insensitive)
+            const all = [originalFrom, ...originalTo, ...originalCc];
+            const filtered = [...new Set(all)].filter((a) => a.toLowerCase() !== agentAddr);
+            to = filtered.join(", ");
+        }
+        else {
+            to = originalFrom;
+        }
+        if (!to) {
+            throw new Error("Cannot reply — no valid recipients after filtering the agent's own address.");
+        }
+        // Send the reply with threading headers
+        let sentMessageId;
+        try {
+            ({ messageId: sentMessageId } = await sendEmail(config, password, {
+                to,
+                subject: replySubject(originalSubject),
+                body: params.body,
+                html: params.html,
+                inReplyTo: originalMessageId,
+                references: originalMessageId,
+            }));
+        }
+        catch (smtpErr) {
+            const smtpMsg = smtpErr instanceof Error ? smtpErr.message : String(smtpErr);
+            // Add alias diagnostic only for SMTP failures
+            if (config.agentAddress !== config.email) {
+                throw new Error(`${smtpMsg} — Note: sending as ${config.agentAddress} (authenticated as ${config.email}). If your provider doesn't allow sending as this alias, check your catchall or alias settings.`);
+            }
+            throw smtpErr;
+        }
+        const replyType = params.replyAll ? "Reply-all" : "Reply";
+        return `${replyType} sent to ${to} (Message-ID: ${sentMessageId})`;
+    }
+    finally {
+        await session.close();
+    }
+}
+//# sourceMappingURL=email-reply.js.map

package/payload/platform/plugins/email/mcp/dist/tools/email-reply.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"email-reply.js","sourceRoot":"","sources":["../../src/tools/email-reply.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAU7C;;GAEG;AACH,SAAS,YAAY,CAAC,OAAe;IACnC,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAC3D,OAAO,OAAO,QAAQ,IAAI,cAAc,EAAE,CAAC;AAC7C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,MAAmB;IAClD,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACvD,IAAI,OAAO,IAAI,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAErD,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,CAAC,WAAW,CAAC;IAEhD,uDAAuD;IACvD,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAC7B,IAAI,CAAC;QACH,MAAM,WAAW,GAAG,MAAM,OAAO,CAAC,GAAG,CACnC;;;;;mCAK6B,EAC7B,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,CAC7D,CAAC;QAEF,IAAI,WAAW,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACrC,MAAM,IAAI,KAAK,CACb,kCAAkC,MAAM,CAAC,SAAS,8FAA8F,CACjJ,CAAC;QACJ,CAAC;QAED,MAAM,MAAM,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QACtC,MAAM,iBAAiB,GAAkB,MAAM,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QACjE,MAAM,YAAY,GAAW,MAAM,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;QACvD,MAAM,UAAU,GAAa,MAAM,CAAC,GAAG,CAAC,aAAa,CAAC,IAAI,EAAE,CAAC;QAC7D,MAAM,UAAU,GAAa,MAAM,CAAC,GAAG,CAAC,aAAa,CAAC,IAAI,EAAE,CAAC;QAC7D,MAAM,eAAe,GAAW,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,cAAc,CAAC;QAExE,IAAI,CAAC,iBAAiB,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CACb,wHAAwH,CACzH,CAAC;QACJ,CAAC;QAED,qCAAqC;QACrC,MAAM,SAAS,GAAG,MAAM,CAAC,YAAY,CAAC,WAAW,EAAE,CAAC;QACpD,IAAI,YAAY,CAAC,WAAW,EAAE,KAAK,SAAS,EAAE,CAAC;YAC7C,MAAM,IAAI,KAAK,CAAC,8DAA8D,CAAC,CAAC;QAClF,CAAC;QAED,uBAAuB;QACvB,IAAI,EAAU,CAAC;QACf,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;YACpB,uFAAuF;YACvF,MAAM,GAAG,GAAG,CAAC,YAAY,EAAE,GAAG,UAAU,EAAE,GAAG,UAAU,CAAC,CAAC;YACzD,MAAM,QAAQ,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,KAAK,SAAS,CAAC,CAAC;YAChF,EAAE,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC3B,CAAC;aAAM,CAAC;YACN,EAAE,GAAG,YAAY,CAAC;QACpB,CAAC;QAED,IAAI,CAAC,EAAE,EAAE,CAAC;YACR,MAAM,IAAI,KAAK,CAAC,6EAA6E,CAAC,CAAC;QACjG,CAAC;QAED,wCAAwC;QACxC,IAAI,aAAqB,CAAC;QAC1B,IAAI,CAAC;YACH,CAAC,EAAE,SAAS,EAAE,aAAa,EAAE,GAAG,MAAM,SAAS,CAAC,MAAM,EAAE,QAAQ,EAAE;gBAChE,EAAE;gBACF,OAAO,EAAE,YAAY,CAAC,eAAe,CAAC;gBACtC,IAAI,EAAE,MAAM,CAAC,IAAI;gBACjB,IAAI,EAAE,MAAM,CAAC,IAAI;gBACjB,SAAS,EAAE,iBAAiB;gBAC5B,UAAU,EAAE,iBAAiB;aAC9B,CAAC,CAAC,CAAC;QACN,CAAC;QAAC,OAAO,OAAO,EAAE,CAAC;YACjB,MAAM,OAAO,GAAG,OAAO,YAAY,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YAC7E,8CAA8C;YAC9C,IAAI,MAAM,CAAC,YAAY,KAAK,MAAM,CAAC,KAAK,EAAE,CAAC;gBACzC,MAAM,IAAI,KAAK,CACb,GAAG,OAAO,uBAAuB,MAAM,CAAC,YAAY,sBAAsB,MAAM,CAAC,KAAK,iGAAiG,CACxL,CAAC;YACJ,CAAC;YACD,MAAM,OAAO,CAAC;QAChB,CAAC;QAED,MAAM,SAAS,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC;QAC1D,OAAO,GAAG,SAAS,YAAY,EAAE,iBAAiB,aAAa,GAAG,CAAC;IACrE,CAAC;YAAS,CAAC;QACT,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;IACxB,CAAC;AACH,CAAC"}

package/payload/platform/plugins/email/mcp/dist/tools/email-search.d.ts

@@ -0,0 +1,15 @@
+interface SearchParams {
+    accountId: string;
+    sender?: string;
+    subject?: string;
+    body?: string;
+    since?: string;
+    before?: string;
+    to?: string;
+    folder?: "inbox" | "sent";
+    before_uid?: number;
+    limit?: number;
+}
+export declare function emailSearch(params: SearchParams): Promise<string>;
+export {};
+//# sourceMappingURL=email-search.d.ts.map

package/payload/platform/plugins/email/mcp/dist/tools/email-search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"email-search.d.ts","sourceRoot":"","sources":["../../src/tools/email-search.ts"],"names":[],"mappings":"AAIA,UAAU,YAAY;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAsB,WAAW,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,CA8DvE"}