@rndmjoker/proton-mcp 0.4.7 → 0.4.12

package/dist/mail/messages.js

@@ -7,7 +7,8 @@
  * full text is fetched one message at a time.
  */
 import { BridgeError } from '../bridge/errors.js';
-import { resolveMessageId, presentMessageId } from './ids.js';
+import { resolveMessageId, presentMessageId, ALL_MAIL, TRASH } from './ids.js';
+import { searchUids } from './uid-search.js';
 import { parseMessage } from '../mime/parse.js';
 /** Upper bound for one listing. Deliberately low, callers can page. */
 export const MAX_LIST_LIMIT = 100;
@@ -50,6 +51,16 @@ export function detectAttachments(node) {
     }
     return false;
 }
+/**
+ * The date of an envelope, or nothing when there is none that can be used.
+ *
+ * imapflow hands out the header text itself, not a Date, when it cannot read
+ * the date, and calling getTime() on that text throws. Such a message is
+ * treated as one without a date, which puts it at the end of a listing.
+ */
+export function envelopeDate(value) {
+    return value instanceof Date ? value : undefined;
+}
 /**
  * Reads nothing but the date of each message.
  *
@@ -71,7 +82,29 @@ export async function fetchDates(client, uids) {
         return [];
     const entries = [];
     for await (const msg of client.fetch(uids, { uid: true, envelope: true }, { uid: true })) {
-        entries.push({ uid: msg.uid, date: msg.envelope?.date });
+        entries.push({ uid: msg.uid, date: envelopeDate(msg.envelope?.date) });
+    }
+    return entries;
+}
+/**
+ * The date of each message, and the decoded subject, sender and recipients.
+ *
+ * Costs the same as fetchDates: both read the envelope, this one keeps more of
+ * it. A search needs those fields because the Bridge compares its text against
+ * the header as stored, encoded, see searchMessages.
+ */
+export async function fetchEnvelopes(client, uids) {
+    if (uids.length === 0)
+        return [];
+    const entries = [];
+    for await (const msg of client.fetch(uids, { uid: true, envelope: true }, { uid: true })) {
+        entries.push({
+            uid: msg.uid,
+            date: envelopeDate(msg.envelope?.date),
+            subject: msg.envelope?.subject ?? '',
+            from: toAddresses(msg.envelope?.from),
+            to: toAddresses(msg.envelope?.to),
+        });
     }
     return entries;
 }
@@ -119,6 +152,42 @@ export function orderNewestFirst(entries) {
  * page: fetching headers for a whole result set would defeat the purpose, since
  * a common word matched 6803 messages in the measured mailbox.
  */
+/**
+ * Which of these identifiers are in the trash.
+ *
+ * One search per page rather than one per message. The alternative was to
+ * resolve the real folder of every entry, which is what findHomeFolder costs and
+ * would mean 25 lookups for a listing that is supposed to be the cheap call.
+ *
+ * A single OR over the page's identifiers, then the envelopes of whatever it
+ * found - so an empty trash or a page with nothing discarded pays for one search
+ * and no fetch.
+ *
+ * Failure is not an error. The mark is an addition to a listing, so a trash that
+ * cannot be opened costs the mark and not the answer.
+ */
+async function trashedAmong(connection, ids) {
+    const wanted = ids.filter((id) => id !== '');
+    if (wanted.length === 0)
+        return new Set();
+    return connection
+        .withMailbox(TRASH, async (client, status) => {
+        // The Bridge answers a fetch on an empty mailbox with BAD.
+        if (status.messages === 0)
+            return new Set();
+        const hits = await client.search({ or: wanted.map((id) => ({ header: { 'message-id': id } })) }, { uid: true });
+        if (!Array.isArray(hits) || hits.length === 0)
+            return new Set();
+        const found = new Set();
+        for await (const msg of client.fetch(hits, { uid: true, envelope: true }, { uid: true })) {
+            const id = presentMessageId(msg.envelope?.messageId ?? '');
+            if (id)
+                found.add(id);
+        }
+        return found;
+    })
+        .catch(() => new Set());
+}
 export async function fetchHeaders(client, uids) {
     if (uids.length === 0)
         return [];
@@ -132,7 +201,7 @@ export async function fetchHeaders(client, uids) {
             subject: env?.subject ?? '',
             from: toAddresses(env?.from),
             to: toAddresses(env?.to),
-            date: env?.date,
+            date: envelopeDate(env?.date),
             size: msg.size ?? 0,
             seen: msg.flags?.has('\\Seen') ?? false,
             flagged: msg.flags?.has('\\Flagged') ?? false,
@@ -168,14 +237,14 @@ export async function listMessages(connection, path, options = {}) {
     const limit = Math.min(Math.max(options.limit ?? 25, 1), MAX_LIST_LIMIT);
     const offset = Math.max(options.offset ?? 0, 0);
     const nothing = { messages: 0, elapsedMs: 0 };
-    return connection.withMailbox(path, async (client, status) => {
+    const result = await connection.withMailbox(path, async (client, status) => {
         // The Bridge answers FETCH on an empty mailbox with `BAD no such message`
         // instead of an empty result, so nothing may be fetched here.
         if (status.messages === 0) {
             return { path, total: 0, offset, headers: [], ordering: nothing };
         }
-        const uids = await client.search(options.unreadOnly ? { seen: false } : { all: true }, { uid: true });
-        if (!uids || uids.length === 0) {
+        const uids = await searchUids(client, options.unreadOnly ? { seen: false } : { all: true }, `the messages in "${path}"`);
+        if (uids.length === 0) {
             return { path, total: 0, offset, headers: [], ordering: nothing };
         }
         const started = process.hrtime.bigint();
@@ -191,6 +260,25 @@ export async function listMessages(connection, path, options = {}) {
         const headers = await fetchHeaders(client, page);
         return { path, total: ordered.length, offset, headers, ordering };
     });
+    return withTrashMarks(connection, result);
+}
+/**
+ * Marks the entries of an "All Mail" page that are in the trash.
+ *
+ * Outside the withMailbox above rather than inside it, and not by choice: a
+ * mailbox is held under a lock for the duration of the operation, so a second
+ * withMailbox nested in the first would wait for a lock its own frame holds.
+ */
+export async function withTrashMarks(connection, result) {
+    if (result.path !== ALL_MAIL || result.headers.length === 0)
+        return result;
+    const trashed = await trashedAmong(connection, result.headers.map((h) => h.messageId));
+    if (trashed.size === 0)
+        return result;
+    return {
+        ...result,
+        headers: result.headers.map((h) => (trashed.has(h.messageId) ? { ...h, inTrash: true } : h)),
+    };
 }
 /**
  * Reads a single message and converts it into readable text.

package/dist/mail/messages.js.map

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

package/dist/mail/saved-attachments.d.ts

@@ -0,0 +1,128 @@
+/**
+ * Attachments saved to this machine, and taking them away again.
+ *
+ * Saving means writing what Proton keeps encrypted, decrypted, to a disk. That
+ * is worth doing so an assistant can open a PDF or a spreadsheet rather than
+ * only say it exists, and it is bounded on every side:
+ *
+ * - **Only into a directory the user named**, in PROTON_MCP_ATTACHMENT_DIR, and
+ *   only through the environment: a setting in the web interface would be
+ *   within reach of an assistant, which gets that page's address. Without the
+ *   variable nothing is written and the tool says how to set it up.
+ * - **Nothing outside it.** A folder is checked after it is resolved, `..` is
+ *   refused, and so is a symbolic link anywhere on the way.
+ * - **The name comes from the sender** and is reduced to a plain one, with the
+ *   rule in mime/filenames.ts. An existing file is never replaced: the file is
+ *   created with O_EXCL, which also refuses to follow a link in its place.
+ * - **Readable by the user only**, 0600, and folders created here 0700.
+ * - **Gone again within the hour.** Decided by Tobi on 2026-11-02: a file lies
+ *   unattended for at most one hour, and is deleted when the server stops.
+ *   Better the assistant fetches it again than that it lies around for days.
+ *   A server that was killed leaves its files to the next one to start.
+ *
+ * What may be deleted is recorded per process, in this server's own
+ * configuration directory rather than in the directory the files go to. Each
+ * running server writes only its own record, so two of them never overwrite
+ * each other's. Before anything is deleted it is checked to be the very file
+ * that was saved: the same inode, size and modification time, a plain file and
+ * not a link. A file replaced or changed since is left where it is, because in
+ * the directory there may be files that are not ours.
+ *
+ * A folder created for a file goes again once it is empty, decided by Tobi on
+ * 2026-11-02: its name can say what was in it. Recorded like the files, with
+ * its inode, and removed with rmdir, which takes an empty folder and nothing
+ * else. A folder that was there before is never recorded and never removed.
+ */
+import { BridgeError } from '../bridge/errors.js';
+/** How long a saved file may lie, fixed. */
+export declare const KEEP_MS: number;
+/** Proton accepts up to 25 MB per message, so no real attachment is larger. */
+export declare const MAX_SAVE_BYTES: number;
+/** The variable that names the directory. */
+export declare const ATTACHMENT_DIR_VARIABLE = "PROTON_MCP_ATTACHMENT_DIR";
+/** A refusal to save or delete, explained. Reported like any explained failure. */
+export declare class SaveRefused extends BridgeError {
+    name: string;
+}
+/** One file this server wrote, with what identifies it as that file. */
+export interface SavedEntry {
+    path: string;
+    dev: number;
+    ino: number;
+    size: number;
+    mtimeMs: number;
+    savedAt: string;
+    expiresAt: string;
+}
+/** A folder this server created, with what identifies it as that folder. */
+export interface CreatedFolder {
+    path: string;
+    dev: number;
+    ino: number;
+}
+/** What save hands back. */
+export interface SavedFile {
+    path: string;
+    size: number;
+    contentType: string;
+    sha256: string;
+    expiresAt: Date;
+}
+/** What delete did, file by file. */
+export interface DeleteReport {
+    deleted: string[];
+    /** Changed or replaced since it was saved, so left in place. */
+    left: string[];
+    /** Already gone. */
+    missing: string[];
+    /** Not a file this server saved, so not touched. */
+    unknown: string[];
+    /** Folders this server had created and removed again, because they were empty. */
+    folders: string[];
+}
+export interface SavedAttachmentsOptions {
+    /** The directory from PROTON_MCP_ATTACHMENT_DIR, if it is set. */
+    root: string | undefined;
+    /** Where the records live. Defaults to this server's configuration directory. */
+    recordDir?: string;
+    now?: () => number;
+    pid?: number;
+    /** Whether a process still runs. Replaced in tests. */
+    isAlive?: (pid: number) => boolean;
+}
+/** Where the records live unless told otherwise. */
+export declare function defaultRecordDir(): string;
+export declare class SavedAttachments {
+    #private;
+    constructor(options: SavedAttachmentsOptions);
+    /** Whether the user set a directory at all. */
+    get configured(): boolean;
+    /**
+     * Throws the explanation when nothing can be saved: no directory set, or one
+     * that is not there. Called before a message is fetched, so that nothing is
+     * decrypted only to be thrown away.
+     */
+    assertUsable(): void;
+    /**
+     * Saves one attachment. Synchronous on purpose: the file and its record are
+     * written in one step, with nothing in between that could stop halfway.
+     */
+    save(name: string, content: Buffer, contentType: string, folder?: string): SavedFile;
+    /**
+     * Deletes what this server saved: everything, or the files named.
+     *
+     * A path it did not save is not touched, whatever it is.
+     */
+    delete(paths?: string[]): DeleteReport;
+    /**
+     * Clears up after other servers: everything of one that no longer runs, and
+     * what one that still runs has left lying well past its hour.
+     */
+    sweepOthers(): void;
+    /** Called once at start: clears up what earlier servers left. */
+    start(): void;
+    /** Called on the way out: deletes everything this server saved. */
+    stop(): void;
+    /** What this server has saved and not yet deleted. */
+    get entries(): readonly SavedEntry[];
+}