@rubytech/create-maxy-code 0.1.163 → 0.1.165

package/payload/platform/plugins/email/mcp/dist/lib/graph.js

@@ -13,18 +13,6 @@ export function stripAngleBrackets(value) {
     }
     return trimmed;
 }
-export async function getMessageEnvelope(_messageId, _accountId) {
-    // Task 442 — sourcing per-message envelopes from IMAP, not the graph.
-    return null;
-}
-export async function getThreadInfo(_messageIds, _accountId) {
-    // Task 442 — per-message thread-depth lookup requires per-message nodes
-    // the new `:ConversationArchive` shape does not store.
-    return new Map();
-}
-// Re-export neo4j so consumers depending on the legacy module surface keep
-// working without churn. The actual neo4j-driver usage is now in
-// conversation-archive-dispatch.ts.
 export { neo4j };
 export { getSession };
 //# sourceMappingURL=graph.js.map

package/payload/platform/plugins/email/mcp/dist/lib/graph.js.map

@@ -1 +1 @@
-{"version":3,"file":"graph.js","sourceRoot":"","sources":["../../src/lib/graph.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,KAAK,MAAM,cAAc,CAAC;AAmCjC;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAoB;IACrD,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IACxB,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QACrD,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAC9B,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAsBD,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,UAAkB,EAClB,UAAkB;IAElB,sEAAsE;IACtE,OAAO,IAAI,CAAC;AACd,CAAC;AAQD,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,WAAqB,EACrB,UAAkB;IAElB,wEAAwE;IACxE,uDAAuD;IACvD,OAAO,IAAI,GAAG,EAAE,CAAC;AACnB,CAAC;AAED,2EAA2E;AAC3E,iEAAiE;AACjE,oCAAoC;AACpC,OAAO,EAAE,KAAK,EAAE,CAAC;AACjB,OAAO,EAAE,UAAU,EAAE,CAAC"}
+{"version":3,"file":"graph.js","sourceRoot":"","sources":["../../src/lib/graph.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,KAAK,MAAM,cAAc,CAAC;AAuCjC;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAoB;IACrD,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IACxB,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QACrD,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAC9B,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,OAAO,EAAE,KAAK,EAAE,CAAC;AACjB,OAAO,EAAE,UAAU,EAAE,CAAC"}

package/payload/platform/plugins/email/mcp/dist/lib/imap.d.ts

@@ -8,6 +8,7 @@ export interface EmailMessage {
     subject: string;
     date: string;
     bodyPreview: string;
+    attachments: AttachmentMeta[];
 }
 export interface PaginatedMessages {
     messages: EmailMessage[];
@@ -28,6 +29,77 @@ export declare function resolveFolderName(client: ImapFlow, folder: "inbox" | "s
  * Used for extracting readable text from HTML-only email bodies.
  */
 export declare function stripHtml(html: string): string;
+/** Hard cap on a single attachment's bytes — over this size, metadata is surfaced
+ *  but bytes are not downloaded. Matches typical provider send limits. */
+export declare const MAX_ATTACHMENT_BYTES: number;
+/** Attachment metadata as derived from IMAP bodyStructure — no bytes. */
+export interface AttachmentMeta {
+    /** IMAP body part key, e.g. "2" or "1.3". Used to fetch bytes later. */
+    partKey: string;
+    filename: string;
+    mimeType: string;
+    sizeBytes: number;
+    /** RFC 2045 transfer encoding — needed to decode bytes at fetch time. */
+    encoding: string | null;
+}
+/**
+ * Body-structure node shape (subset of ImapFlow's BodyStructure).
+ * Defined locally because ImapFlow does not export a public type for this.
+ */
+interface BodyStructureNode {
+    part?: string;
+    type?: string;
+    encoding?: string;
+    size?: number;
+    disposition?: string;
+    dispositionParameters?: {
+        filename?: string;
+    };
+    parameters?: {
+        name?: string;
+    };
+    childNodes?: BodyStructureNode[];
+}
+/**
+ * Walk an IMAP bodyStructure and return metadata for every attachment-shaped
+ * part. No bytes are downloaded — cheap, runs at preview time.
+ *
+ * An attachment-shaped part is one of:
+ *  - disposition === "attachment" (RFC 2183), OR
+ *  - has a filename in parameters.name or dispositionParameters.filename AND
+ *    is not a multipart container.
+ *
+ * Inline parts without a filename (e.g. the message body) are excluded.
+ */
+export declare function walkAttachmentMetadata(structure: BodyStructureNode | undefined): AttachmentMeta[];
+/**
+ * Format an AttachmentMeta[] as a single-line operator-readable footer.
+ * Returns empty string when the array is empty so callers can skip the
+ * line entirely.
+ */
+export declare function formatAttachmentsFooter(attachments: AttachmentMeta[]): string;
+/**
+ * Result of attempting to fetch one attachment's bytes from IMAP.
+ * `bytes === null` indicates a non-fatal failure (oversize, short buffer,
+ * fetch error) — the caller surfaces metadata-only graph attach instead.
+ */
+export interface AttachmentBytesResult {
+    uid: number;
+    partKey: string;
+    bytes: Buffer | null;
+    failureReason: "oversize" | "short-buffer" | "fetch-error" | null;
+}
+/**
+ * Download decoded bytes for a list of (uid, partKey) attachments from IMAP.
+ * Opens one connection, reuses it across all requests. Per-attachment
+ * failures are isolated — one bad part does not abort the batch.
+ */
+export declare function fetchAttachmentBytesForMessages(config: EmailConfig, password: string, requests: Array<{
+    uid: number;
+    partKey: string;
+    expectedSize: number;
+    encoding: string | null;
+}>): Promise<AttachmentBytesResult[]>;
 /**
  * Decode a raw IMAP body part buffer according to its transfer encoding.
  * Returns a UTF-8 string. Falls back to raw UTF-8 for unknown encodings.
@@ -148,6 +220,8 @@ export interface FetchedEmail {
     subject: string;
     date: string;
     bodyPreview: string;
+    /** Attachment metadata derived from bodyStructure; bytes downloaded later. */
+    attachments: AttachmentMeta[];
 }
 /**
  * Fetch emails from INBOX since a given UID (exclusive) for incremental polling.
@@ -165,51 +239,28 @@ export declare function fetchSinceUid(config: EmailConfig, password: string, sin
     maxUid: number;
 }>;
 /**
- * Get the inbox message count.
+ * Resolve an envelope by Message-ID via IMAP. Searches INBOX first, then
+ * the \Sent special-use folder. Returns null when no folder yields a hit.
+ *
+ * Uses `header: { "message-id": ... }` IMAP SEARCH — sufficient on every
+ * server that honours RFC 3501 header search. The Message-ID is sent with
+ * angle brackets restored because some servers (notably Gmail) only match
+ * the raw header value, not the bare identifier.
  */
-export declare function getInboxCount(config: EmailConfig, password: string): Promise<number>;
-export interface AutoRespondMessage {
+export declare function fetchEnvelopeByMessageId(config: EmailConfig, password: string, messageId: string): Promise<{
     uid: number;
+    mailbox: string;
     messageId: string;
-    from: string;
-    to: string[];
+    fromAddress: string;
+    fromName: string | null;
+    toAddresses: string[];
+    ccAddresses: string[];
     subject: string;
     date: string;
-    inReplyTo: string | null;
-    references: string | null;
-    body: string;
-    /** True if the message has auto-reply indicators and should be skipped. */
-    isAutoReply: boolean;
-}
+} | null>;
 /**
- * Parse raw IMAP header text into a map of lowercased header names → values.
- * Handles multi-line continuation (lines starting with whitespace).
- */
-export declare function parseRawHeaders(raw: string): Map<string, string[]>;
-/**
- * Detect whether a message is an auto-reply based on RFC 3834 headers.
- *
- * Checks:
- * - Auto-Submitted: any value other than "no"
- * - X-Auto-Response-Suppress: present
- * - Precedence: bulk, junk, or list
- * - List-Unsubscribe or List-Id: present (mailing list)
- */
-export declare function detectAutoReply(headers: Map<string, string[]>): boolean;
-/**
- * Fetch new messages for auto-respond processing.
- *
- * Returns messages with UIDs greater than `sinceUid`, filtered by the
- * agent's address (TO header). Includes envelope, body, and auto-reply
- * detection headers in a single IMAP FETCH.
- *
- * Unlike fetchRecent (optimised for tool output with pagination),
- * this function fetches everything needed for auto-respond in one pass:
- * envelope for threading, body for agent input, headers for loop guards.
+ * Get the inbox message count.
  */
-export declare function fetchForAutoRespond(config: EmailConfig, password: string, options: {
-    sinceUid: number;
-    agentAddress: string;
-    limit?: number;
-}): Promise<AutoRespondMessage[]>;
+export declare function getInboxCount(config: EmailConfig, password: string): Promise<number>;
+export {};
 //# sourceMappingURL=imap.d.ts.map

package/payload/platform/plugins/email/mcp/dist/lib/imap.d.ts.map

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

package/payload/platform/plugins/email/mcp/dist/lib/imap.js

@@ -81,6 +81,142 @@ export function stripHtml(html) {
 const BODY_MAX_BYTES = 4096;
 /** Max characters for body preview in tool output. */
 const BODY_PREVIEW_LENGTH = 500;
+/** Hard cap on a single attachment's bytes — over this size, metadata is surfaced
+ *  but bytes are not downloaded. Matches typical provider send limits. */
+export const MAX_ATTACHMENT_BYTES = 25 * 1024 * 1024;
+/**
+ * Walk an IMAP bodyStructure and return metadata for every attachment-shaped
+ * part. No bytes are downloaded — cheap, runs at preview time.
+ *
+ * An attachment-shaped part is one of:
+ *  - disposition === "attachment" (RFC 2183), OR
+ *  - has a filename in parameters.name or dispositionParameters.filename AND
+ *    is not a multipart container.
+ *
+ * Inline parts without a filename (e.g. the message body) are excluded.
+ */
+export function walkAttachmentMetadata(structure) {
+    if (!structure)
+        return [];
+    const out = [];
+    const visit = (node) => {
+        if (node.childNodes && node.childNodes.length > 0) {
+            for (const child of node.childNodes)
+                visit(child);
+            return;
+        }
+        const filename = node.dispositionParameters?.filename?.trim() ||
+            node.parameters?.name?.trim() ||
+            "";
+        const isAttachmentDisposition = typeof node.disposition === "string" &&
+            node.disposition.toLowerCase() === "attachment";
+        const isMultipart = typeof node.type === "string" && node.type.toLowerCase().startsWith("multipart/");
+        if (isMultipart)
+            return;
+        if (!isAttachmentDisposition && !filename)
+            return;
+        if (!node.part)
+            return; // can't fetch bytes without a part key
+        out.push({
+            partKey: node.part,
+            filename: filename || `unnamed-${node.part}`,
+            mimeType: (node.type ?? "application/octet-stream").toLowerCase(),
+            sizeBytes: typeof node.size === "number" ? node.size : 0,
+            encoding: node.encoding ?? null,
+        });
+    };
+    visit(structure);
+    return out;
+}
+function formatBytes(n) {
+    if (n < 1024)
+        return `${n} B`;
+    if (n < 1024 * 1024)
+        return `${(n / 1024).toFixed(1)} KB`;
+    return `${(n / (1024 * 1024)).toFixed(1)} MB`;
+}
+/**
+ * Format an AttachmentMeta[] as a single-line operator-readable footer.
+ * Returns empty string when the array is empty so callers can skip the
+ * line entirely.
+ */
+export function formatAttachmentsFooter(attachments) {
+    if (attachments.length === 0)
+        return "";
+    const parts = attachments
+        .map((a) => `${a.filename} (${a.mimeType}, ${formatBytes(a.sizeBytes)})`)
+        .join("; ");
+    return `Attachments (${attachments.length}): ${parts}`;
+}
+/**
+ * Download decoded bytes for a list of (uid, partKey) attachments from IMAP.
+ * Opens one connection, reuses it across all requests. Per-attachment
+ * failures are isolated — one bad part does not abort the batch.
+ */
+export async function fetchAttachmentBytesForMessages(config, password, requests) {
+    if (requests.length === 0)
+        return [];
+    const client = createClient(config, password);
+    const results = [];
+    try {
+        await client.connect();
+        const lock = await client.getMailboxLock("INBOX");
+        try {
+            for (const req of requests) {
+                if (req.expectedSize > MAX_ATTACHMENT_BYTES) {
+                    diag("fetchAttachmentBytes", "oversize", `uid=${req.uid} part=${req.partKey} size=${req.expectedSize} cap=${MAX_ATTACHMENT_BYTES}`);
+                    results.push({ uid: req.uid, partKey: req.partKey, bytes: null, failureReason: "oversize" });
+                    continue;
+                }
+                try {
+                    const { content } = await client.download(String(req.uid), req.partKey, { uid: true });
+                    if (!content) {
+                        diag("fetchAttachmentBytes", "no-stream", `uid=${req.uid} part=${req.partKey}`);
+                        results.push({ uid: req.uid, partKey: req.partKey, bytes: null, failureReason: "fetch-error" });
+                        continue;
+                    }
+                    const chunks = [];
+                    let total = 0;
+                    let overflow = false;
+                    for await (const chunk of content) {
+                        const buf = Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk);
+                        total += buf.length;
+                        if (total > MAX_ATTACHMENT_BYTES) {
+                            overflow = true;
+                            break;
+                        }
+                        chunks.push(buf);
+                    }
+                    if (overflow) {
+                        diag("fetchAttachmentBytes", "stream-oversize", `uid=${req.uid} part=${req.partKey} streamed=${total}`);
+                        results.push({ uid: req.uid, partKey: req.partKey, bytes: null, failureReason: "oversize" });
+                        continue;
+                    }
+                    // ImapFlow's download() returns already-decoded bytes when given a
+                    // partKey, so we do not re-decode against `encoding` here.
+                    const bytes = Buffer.concat(chunks);
+                    if (req.expectedSize > 0 && bytes.length === 0) {
+                        diag("fetchAttachmentBytes", "short-buffer", `uid=${req.uid} part=${req.partKey} expected=${req.expectedSize} got=0`);
+                        results.push({ uid: req.uid, partKey: req.partKey, bytes: null, failureReason: "short-buffer" });
+                        continue;
+                    }
+                    results.push({ uid: req.uid, partKey: req.partKey, bytes, failureReason: null });
+                }
+                catch (err) {
+                    diag("fetchAttachmentBytes", "fetch-error", `uid=${req.uid} part=${req.partKey} ${err instanceof Error ? err.message : String(err)}`);
+                    results.push({ uid: req.uid, partKey: req.partKey, bytes: null, failureReason: "fetch-error" });
+                }
+            }
+        }
+        finally {
+            lock.release();
+        }
+    }
+    finally {
+        await safeLogout(client);
+    }
+    return results;
+}
 /**
  * Decode a raw IMAP body part buffer according to its transfer encoding.
  * Returns a UTF-8 string. Falls back to raw UTF-8 for unknown encodings.
@@ -328,6 +464,7 @@ export async function fetchRecent(config, password, options = {}) {
                     break;
                 const bodyPreview = extractBodyFromFetch(msg);
                 diag("fetchRecent", `body #${envelopeCount}`, `uid=${msg.uid} preview=${bodyPreview.length}chars type=${msg.bodyStructure?.type ?? "?"}`);
+                const attachments = walkAttachmentMetadata(msg.bodyStructure);
                 messages.push({
                     uid: msg.uid,
                     messageId,
@@ -336,6 +473,7 @@ export async function fetchRecent(config, password, options = {}) {
                     subject,
                     date,
                     bodyPreview,
+                    attachments,
                 });
             }
             diag("fetchRecent", "fetch done", `${envelopeCount} envelopes, ${messages.length} messages in ${Date.now() - t2}ms (total ${Date.now() - t0}ms)`);
@@ -423,6 +561,7 @@ export async function searchMessages(config, password, query) {
                 if (messages.length >= limit)
                     break;
                 const bodyPreview = extractBodyFromFetch(msg);
+                const attachments = walkAttachmentMetadata(msg.bodyStructure);
                 messages.push({
                     uid: msg.uid,
                     messageId,
@@ -431,6 +570,7 @@ export async function searchMessages(config, password, query) {
                     subject: subj,
                     date,
                     bodyPreview,
+                    attachments,
                 });
             }
             diag("searchMessages", "fetch done", `${envelopeCount} envelopes, ${messages.length} messages in ${Date.now() - t2}ms (total ${Date.now() - t0}ms)`);
@@ -528,7 +668,8 @@ export async function fetchSinceUid(config, password, sinceUid, recipientAddress
             const toAddresses = (msg.envelope?.to ?? []).map((a) => a.address).filter((a) => !!a);
             const ccAddresses = (msg.envelope?.cc ?? []).map((a) => a.address).filter((a) => !!a);
             const bodyPreview = extractBodyFromFetch(msg);
-            emails.push({ uid, messageId, inReplyTo, toAddresses, ccAddresses, fromAddress: fromAddr, fromName, subject, date, bodyPreview });
+            const attachments = walkAttachmentMetadata(msg.bodyStructure);
+            emails.push({ uid, messageId, inReplyTo, toAddresses, ccAddresses, fromAddress: fromAddr, fromName, subject, date, bodyPreview, attachments });
         }
         diag("fetchSinceUid", "fetch done", `${emails.length} emails (maxUid=${maxUid}) in ${Date.now() - t2}ms (total ${Date.now() - t0}ms)`);
         return { uidValidity, emails, maxUid };
@@ -542,191 +683,85 @@ export async function fetchSinceUid(config, password, sinceUid, recipientAddress
     }
 }
 /**
- * Get the inbox message count.
+ * Resolve an envelope by Message-ID via IMAP. Searches INBOX first, then
+ * the \Sent special-use folder. Returns null when no folder yields a hit.
+ *
+ * Uses `header: { "message-id": ... }` IMAP SEARCH — sufficient on every
+ * server that honours RFC 3501 header search. The Message-ID is sent with
+ * angle brackets restored because some servers (notably Gmail) only match
+ * the raw header value, not the bare identifier.
  */
-export async function getInboxCount(config, password) {
+export async function fetchEnvelopeByMessageId(config, password, messageId) {
+    const cleanId = messageId.replace(/^<|>$/g, "");
+    const needle = `<${cleanId}>`;
     const client = createClient(config, password);
+    const t0 = Date.now();
+    diag("fetchEnvelopeByMessageId", "start", `messageId=${cleanId}`);
     try {
         await client.connect();
-        const mailbox = await client.mailboxOpen("INBOX");
-        return mailbox.exists;
-    }
-    finally {
-        await safeLogout(client);
-    }
-}
-// ─── Auto-respond types and fetch ────────────────────────────────────
-/** Headers used to detect auto-replies (RFC 3834) and mailing lists. */
-const AUTO_REPLY_HEADER_FIELDS = [
-    "Auto-Submitted",
-    "X-Auto-Response-Suppress",
-    "Precedence",
-    "List-Unsubscribe",
-    "List-Id",
-];
-/**
- * Parse raw IMAP header text into a map of lowercased header names → values.
- * Handles multi-line continuation (lines starting with whitespace).
- */
-export function parseRawHeaders(raw) {
-    const headers = new Map();
-    const lines = raw.split(/\r?\n/);
-    let currentKey = "";
-    let currentValue = "";
-    for (const line of lines) {
-        if (line === "")
-            break; // End of headers
-        if (/^\s/.test(line)) {
-            // Continuation of previous header
-            currentValue += " " + line.trim();
+        diag("fetchEnvelopeByMessageId", "connected", `${Date.now() - t0}ms`);
+        const folders = ["INBOX"];
+        try {
+            const sentPath = await resolveFolderName(client, "sent");
+            folders.push(sentPath);
         }
-        else {
-            // Flush previous header
-            if (currentKey) {
-                const existing = headers.get(currentKey) ?? [];
-                existing.push(currentValue);
-                headers.set(currentKey, existing);
-            }
-            const colonIdx = line.indexOf(":");
-            if (colonIdx > 0) {
-                currentKey = line.slice(0, colonIdx).trim().toLowerCase();
-                currentValue = line.slice(colonIdx + 1).trim();
+        catch {
+            // No \Sent folder advertised — only search INBOX.
+        }
+        for (const folderPath of folders) {
+            const lock = await client.getMailboxLock(folderPath);
+            try {
+                const uids = await client.search({ header: { "message-id": needle } }, { uid: true });
+                if (!uids || uids.length === 0)
+                    continue;
+                const uid = uids[0];
+                for await (const msg of client.fetch(String(uid), { envelope: true, uid: true }, { uid: true })) {
+                    const env = msg.envelope ?? {};
+                    const fromAddr = env.from?.[0]?.address ?? "";
+                    if (!fromAddr)
+                        continue;
+                    diag("fetchEnvelopeByMessageId", "match", `folder=${folderPath} uid=${msg.uid} in ${Date.now() - t0}ms`);
+                    return {
+                        uid: msg.uid,
+                        mailbox: folderPath,
+                        messageId: env.messageId ?? messageId,
+                        fromAddress: fromAddr,
+                        fromName: env.from?.[0]?.name ?? null,
+                        toAddresses: (env.to ?? [])
+                            .map((a) => a.address)
+                            .filter((a) => !!a),
+                        ccAddresses: (env.cc ?? [])
+                            .map((a) => a.address)
+                            .filter((a) => !!a),
+                        subject: env.subject ?? "",
+                        date: env.date?.toISOString() ?? "",
+                    };
+                }
             }
-            else {
-                currentKey = "";
-                currentValue = "";
+            finally {
+                lock.release();
             }
         }
+        diag("fetchEnvelopeByMessageId", "no-match", `searched=${folders.join(",")} in ${Date.now() - t0}ms`);
+        return null;
     }
-    // Flush last header
-    if (currentKey) {
-        const existing = headers.get(currentKey) ?? [];
-        existing.push(currentValue);
-        headers.set(currentKey, existing);
-    }
-    return headers;
-}
-/**
- * Detect whether a message is an auto-reply based on RFC 3834 headers.
- *
- * Checks:
- * - Auto-Submitted: any value other than "no"
- * - X-Auto-Response-Suppress: present
- * - Precedence: bulk, junk, or list
- * - List-Unsubscribe or List-Id: present (mailing list)
- */
-export function detectAutoReply(headers) {
-    const autoSubmitted = headers.get("auto-submitted");
-    if (autoSubmitted && autoSubmitted.some((v) => v.trim().toLowerCase() !== "no")) {
-        return true;
+    catch (err) {
+        diag("fetchEnvelopeByMessageId", "FAILED", `${err instanceof Error ? err.message : String(err)} after ${Date.now() - t0}ms`);
+        throw err;
     }
-    if (headers.has("x-auto-response-suppress"))
-        return true;
-    const precedence = headers.get("precedence");
-    if (precedence) {
-        const val = precedence[0]?.trim().toLowerCase();
-        if (val === "bulk" || val === "junk" || val === "list")
-            return true;
+    finally {
+        await safeLogout(client);
     }
-    if (headers.has("list-unsubscribe") || headers.has("list-id"))
-        return true;
-    return false;
 }
 /**
- * Fetch new messages for auto-respond processing.
- *
- * Returns messages with UIDs greater than `sinceUid`, filtered by the
- * agent's address (TO header). Includes envelope, body, and auto-reply
- * detection headers in a single IMAP FETCH.
- *
- * Unlike fetchRecent (optimised for tool output with pagination),
- * this function fetches everything needed for auto-respond in one pass:
- * envelope for threading, body for agent input, headers for loop guards.
+ * Get the inbox message count.
  */
-export async function fetchForAutoRespond(config, password, options) {
-    const { sinceUid, agentAddress, limit = 20 } = options;
+export async function getInboxCount(config, password) {
     const client = createClient(config, password);
-    const t0 = Date.now();
-    diag("fetchForAutoRespond", "start", `sinceUid=${sinceUid} agentAddress=${agentAddress} limit=${limit}`);
     try {
         await client.connect();
-        diag("fetchForAutoRespond", "connected", `${Date.now() - t0}ms`);
-        const lock = await client.getMailboxLock("INBOX");
-        diag("fetchForAutoRespond", "mailbox locked", `${Date.now() - t0}ms`);
-        try {
-            // Search for messages with UID > sinceUid
-            const criteria = {};
-            if (sinceUid > 0) {
-                criteria.uid = `${sinceUid + 1}:*`;
-            }
-            else {
-                // First poll: only fetch recent messages (last 7 days)
-                const since = new Date();
-                since.setDate(since.getDate() - DEFAULT_SINCE_DAYS);
-                criteria.since = since;
-            }
-            const t1 = Date.now();
-            const searchResult = await client.search(criteria, { uid: true });
-            const uids = searchResult || [];
-            diag("fetchForAutoRespond", "search done", `${uids.length} UIDs in ${Date.now() - t1}ms`);
-            if (uids.length === 0)
-                return [];
-            // Take the oldest N UIDs (process in chronological order)
-            const processUids = uids.slice(0, limit);
-            const messages = [];
-            const t2 = Date.now();
-            const headerSection = `HEADER.FIELDS (${AUTO_REPLY_HEADER_FIELDS.join(" ")})`;
-            for await (const msg of client.fetch(processUids.map(String).join(","), {
-                envelope: true,
-                uid: true,
-                bodyStructure: true,
-                bodyParts: [
-                    { key: "1", start: 0, maxLength: BODY_MAX_BYTES },
-                ],
-                headers: AUTO_REPLY_HEADER_FIELDS.map((h) => h.toLowerCase()),
-            }, { uid: true })) {
-                // Client-side TO filter: only messages addressed to the agent
-                if (!matchesRecipient(msg.envelope ?? {}, agentAddress))
-                    continue;
-                const envelope = msg.envelope ?? {};
-                const fromAddr = envelope.from?.[0]?.address ?? "";
-                const toAddrs = (envelope.to ?? []).map((a) => a.address ?? "");
-                const subject = envelope.subject ?? "(no subject)";
-                const date = envelope.date?.toISOString() ?? new Date().toISOString();
-                const messageId = envelope.messageId ?? "";
-                const inReplyTo = envelope.inReplyTo ?? null;
-                // Extract References from envelope (not available in all IMAP servers)
-                // Fall back to null — threading still works with just In-Reply-To
-                const references = null;
-                // Extract body
-                const body = extractBodyFromFetch(msg);
-                // Detect auto-reply from raw headers (Buffer from ImapFlow)
-                const rawHeaders = msg.headers ? msg.headers.toString("utf-8") : "";
-                const headerMap = parseRawHeaders(rawHeaders);
-                const isAutoReply = detectAutoReply(headerMap);
-                messages.push({
-                    uid: msg.uid,
-                    messageId,
-                    from: fromAddr,
-                    to: toAddrs,
-                    subject,
-                    date,
-                    inReplyTo,
-                    references,
-                    body,
-                    isAutoReply,
-                });
-            }
-            diag("fetchForAutoRespond", "fetch done", `${messages.length} messages in ${Date.now() - t2}ms (total ${Date.now() - t0}ms)`);
-            return messages;
-        }
-        finally {
-            lock.release();
-        }
-    }
-    catch (err) {
-        diag("fetchForAutoRespond", "FAILED", `${err instanceof Error ? err.message : String(err)} after ${Date.now() - t0}ms`);
-        throw err;
+        const mailbox = await client.mailboxOpen("INBOX");
+        return mailbox.exists;
     }
     finally {
         await safeLogout(client);