@diskd-ai/email-client-mcp 0.1.0

package/dist/domain/result.js

@@ -0,0 +1,12 @@
+/**
+ * Result + Option ADTs. Domain returns `Result<E, T>`; adapters convert
+ * thrown exceptions into typed `Err`. Mirrors the project conventions
+ * from CODING_CONVENTIONS_TYPESCRIPT.md.
+ */
+export const Ok = (value) => ({ tag: "Ok", value });
+export const Err = (error) => ({ tag: "Err", error });
+export const isOk = (r) => r.tag === "Ok";
+export const isErr = (r) => r.tag === "Err";
+export const Some = (value) => ({ tag: "Some", value });
+export const None = { tag: "None" };
+//# sourceMappingURL=result.js.map

package/dist/domain/result.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"result.js","sourceRoot":"","sources":["../../src/domain/result.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,MAAM,CAAC,MAAM,EAAE,GAAG,CAAI,KAAQ,EAAoB,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;AAC5E,MAAM,CAAC,MAAM,GAAG,GAAG,CAAI,KAAQ,EAAoB,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;AAE9E,MAAM,CAAC,MAAM,IAAI,GAAG,CAAO,CAAe,EAAkD,EAAE,CAC5F,CAAC,CAAC,GAAG,KAAK,IAAI,CAAC;AACjB,MAAM,CAAC,MAAM,KAAK,GAAG,CAAO,CAAe,EAAmD,EAAE,CAC9F,CAAC,CAAC,GAAG,KAAK,KAAK,CAAC;AAGlB,MAAM,CAAC,MAAM,IAAI,GAAG,CAAI,KAAQ,EAAa,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;AACzE,MAAM,CAAC,MAAM,IAAI,GAAkB,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC"}

package/dist/imap/fetch.d.ts

@@ -0,0 +1,44 @@
+/**
+ * imapflow fetch helpers used by both the watcher (bulk sync) and the
+ * read tools (`get_email`, `get_emails`, `list_emails`). All helpers are
+ * BODY.PEEK by default so reads do not silently flip `\\Seen`.
+ *
+ * Body decoding strategy: we ask imapflow for `bodyParts` (the small
+ * `text/plain` and `text/html` pieces) instead of full source -- this
+ * keeps payloads bounded without requiring a separate MIME parser. The
+ * mapper truncates body byte-size on top.
+ */
+import type { ImapFlow } from "imapflow";
+import type { FetchedMessageLike } from "./mapper.js";
+export type FolderStatusSnapshot = {
+    readonly uidValidity: number;
+    readonly uidNext: number;
+    readonly messages: number;
+};
+/**
+ * Run a callback under a per-folder IMAP lock. imapflow requires this
+ * for any FETCH/STORE/MOVE operation. The lock is released even if the
+ * callback throws.
+ */
+export declare const withMailboxLock: <T>(client: ImapFlow, mailbox: string, fn: () => Promise<T>) => Promise<T>;
+export declare const folderStatus: (client: ImapFlow, mailbox: string) => Promise<FolderStatusSnapshot>;
+export type FetchedEnvelopeBundle = {
+    readonly imapMessage: FetchedMessageLike;
+    readonly bodyText: string | null;
+    readonly bodyHtml: string | null;
+};
+/**
+ * UID-range fetch for the watcher. Yields envelope + flags + bodyStructure
+ * + bodyParts(text/html) without setting `\\Seen`.
+ */
+export declare function fetchUidRange(client: ImapFlow, fromUid: number, toUid: number): AsyncIterable<FetchedEnvelopeBundle>;
+/**
+ * Fetch a single message by UID with BODY.PEEK semantics. Used by
+ * `get_email` and `get_emails`.
+ */
+export declare const fetchOneByUid: (client: ImapFlow, uid: number) => Promise<FetchedEnvelopeBundle | null>;
+/**
+ * Envelope-only fetch over a UID range. Used by `list_emails` and the
+ * watcher's flag-reconciliation pass (no body, no bodyStructure).
+ */
+export declare function fetchEnvelopesUidRange(client: ImapFlow, fromUid: number, toUid: number): AsyncIterable<FetchedMessageLike>;

package/dist/imap/fetch.js

@@ -0,0 +1,127 @@
+/**
+ * imapflow fetch helpers used by both the watcher (bulk sync) and the
+ * read tools (`get_email`, `get_emails`, `list_emails`). All helpers are
+ * BODY.PEEK by default so reads do not silently flip `\\Seen`.
+ *
+ * Body decoding strategy: we ask imapflow for `bodyParts` (the small
+ * `text/plain` and `text/html` pieces) instead of full source -- this
+ * keeps payloads bounded without requiring a separate MIME parser. The
+ * mapper truncates body byte-size on top.
+ */
+const BODY_PARTS = ["text", "html"];
+/**
+ * Run a callback under a per-folder IMAP lock. imapflow requires this
+ * for any FETCH/STORE/MOVE operation. The lock is released even if the
+ * callback throws.
+ */
+export const withMailboxLock = async (client, mailbox, fn) => {
+    let lock = null;
+    try {
+        lock = await client.getMailboxLock(mailbox);
+        return await fn();
+    }
+    finally {
+        if (lock !== null)
+            lock.release();
+    }
+};
+export const folderStatus = async (client, mailbox) => {
+    const status = await client.status(mailbox, {
+        uidValidity: true,
+        uidNext: true,
+        messages: true,
+    });
+    return {
+        uidValidity: Number(status.uidValidity ?? 0),
+        uidNext: Number(status.uidNext ?? 1),
+        messages: Number(status.messages ?? 0),
+    };
+};
+const decodeBuffer = (b) => {
+    if (!b || b.length === 0)
+        return null;
+    return b.toString("utf8");
+};
+const extractText = (msg) => {
+    const candidate = msg.bodyParts?.get("text") ?? msg.bodyParts?.get("1");
+    return decodeBuffer(candidate);
+};
+const extractHtml = (msg) => {
+    const candidate = msg.bodyParts?.get("html") ?? msg.bodyParts?.get("1.2");
+    return decodeBuffer(candidate);
+};
+const toInternalDate = (raw) => {
+    if (raw instanceof Date)
+        return raw;
+    if (typeof raw === "string" && raw.length > 0) {
+        const d = new Date(raw);
+        return Number.isNaN(d.getTime()) ? undefined : d;
+    }
+    return undefined;
+};
+const toLike = (msg) => ({
+    uid: msg.uid,
+    flags: msg.flags ?? new Set(),
+    envelope: msg.envelope,
+    bodyStructure: msg.bodyStructure,
+    internalDate: toInternalDate(msg.internalDate),
+});
+/**
+ * UID-range fetch for the watcher. Yields envelope + flags + bodyStructure
+ * + bodyParts(text/html) without setting `\\Seen`.
+ */
+export async function* fetchUidRange(client, fromUid, toUid) {
+    const range = `${fromUid}:${toUid}`;
+    for await (const msg of client.fetch(range, {
+        uid: true,
+        flags: true,
+        envelope: true,
+        bodyStructure: true,
+        bodyParts: BODY_PARTS,
+        internalDate: true,
+    }, { uid: true })) {
+        yield {
+            imapMessage: toLike(msg),
+            bodyText: extractText(msg),
+            bodyHtml: extractHtml(msg),
+        };
+    }
+}
+/**
+ * Fetch a single message by UID with BODY.PEEK semantics. Used by
+ * `get_email` and `get_emails`.
+ */
+export const fetchOneByUid = async (client, uid) => {
+    const msg = await client.fetchOne(String(uid), {
+        uid: true,
+        flags: true,
+        envelope: true,
+        bodyStructure: true,
+        bodyParts: BODY_PARTS,
+        internalDate: true,
+    }, { uid: true });
+    if (!msg)
+        return null;
+    return {
+        imapMessage: toLike(msg),
+        bodyText: extractText(msg),
+        bodyHtml: extractHtml(msg),
+    };
+};
+/**
+ * Envelope-only fetch over a UID range. Used by `list_emails` and the
+ * watcher's flag-reconciliation pass (no body, no bodyStructure).
+ */
+export async function* fetchEnvelopesUidRange(client, fromUid, toUid) {
+    const range = `${fromUid}:${toUid}`;
+    for await (const msg of client.fetch(range, {
+        uid: true,
+        flags: true,
+        envelope: true,
+        bodyStructure: true,
+        internalDate: true,
+    }, { uid: true })) {
+        yield toLike(msg);
+    }
+}
+//# sourceMappingURL=fetch.js.map

package/dist/imap/fetch.js.map

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

package/dist/imap/mapper.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Pure mapping from imapflow `FetchMessageObject` to our opaque
+ * `StoredEmailPayload`. Kept I/O-free and free of imapflow runtime
+ * imports so unit tests can build payload-shaped objects without a
+ * real IMAP connection.
+ */
+import type { StoredEmailPayload } from "../store/payloadTypes.js";
+type ImapAddressLike = {
+    readonly name?: string | undefined;
+    readonly address?: string | undefined;
+};
+type ImapEnvelopeLike = {
+    readonly date?: Date | string | undefined;
+    readonly subject?: string | undefined;
+    readonly messageId?: string | undefined;
+    readonly inReplyTo?: string | undefined;
+    readonly from?: readonly ImapAddressLike[] | undefined;
+    readonly to?: readonly ImapAddressLike[] | undefined;
+    readonly cc?: readonly ImapAddressLike[] | undefined;
+};
+type ImapBodyStructureLike = {
+    readonly type?: string | undefined;
+    readonly part?: string | undefined;
+    readonly disposition?: string | undefined;
+    readonly dispositionParameters?: {
+        readonly filename?: string | undefined;
+    } | undefined;
+    readonly parameters?: {
+        readonly name?: string | undefined;
+    } | undefined;
+    readonly size?: number | undefined;
+    readonly childNodes?: readonly ImapBodyStructureLike[] | undefined;
+};
+export type FetchedMessageLike = {
+    readonly uid: number;
+    readonly flags?: ReadonlySet<string> | readonly string[] | undefined;
+    readonly labels?: ReadonlySet<string> | readonly string[] | undefined;
+    readonly envelope?: ImapEnvelopeLike | undefined;
+    readonly bodyStructure?: ImapBodyStructureLike | undefined;
+    readonly source?: Buffer | undefined;
+    readonly internalDate?: Date | undefined;
+};
+export type MapperParams = {
+    readonly accountId: string;
+    readonly mailbox: string;
+    readonly uidValidity: number;
+    readonly fetchedAt: Date;
+    readonly bodyText: string | null;
+    readonly bodyHtml: string | null;
+    readonly truncated: boolean;
+};
+/**
+ * Build a `StoredEmailPayload` from imapflow fetch output and decoded
+ * body parts. Pure: no imapflow types are imported, so tests can pass
+ * shaped POJOs.
+ */
+export declare const toStoredPayload: (msg: FetchedMessageLike, params: MapperParams) => StoredEmailPayload;
+/**
+ * Strip `text/html` to an approximate plain-text representation. Conservative:
+ * removes scripts/styles, replaces tags with spaces, decodes a small set of
+ * named entities. Used by the `format="text"` option of get_email/get_emails.
+ */
+export declare const htmlToText: (html: string) => string;
+/**
+ * Strip quoted reply blocks and signatures from a plain-text body. Heuristic
+ * but conservative: cuts at the first `On <date>, <name> wrote:` block, or at
+ * a leading-`>` quote run, or at a `-- ` signature delimiter.
+ */
+export declare const stripQuotedAndSignature: (text: string) => string;
+export {};

package/dist/imap/mapper.js

@@ -0,0 +1,140 @@
+/**
+ * Pure mapping from imapflow `FetchMessageObject` to our opaque
+ * `StoredEmailPayload`. Kept I/O-free and free of imapflow runtime
+ * imports so unit tests can build payload-shaped objects without a
+ * real IMAP connection.
+ */
+const MAX_BODY_BYTES = 1_048_576; // 1 MiB cap per body part to keep store payloads small
+const SNIPPET_CHARS = 200;
+const toAddr = (a) => ({
+    name: a.name && a.name.length > 0 ? a.name : null,
+    address: a.address ?? "",
+});
+const toAddrArr = (xs) => (xs ?? []).map(toAddr).filter((a) => a.address.length > 0);
+const toIso = (d, fallback) => {
+    if (d instanceof Date)
+        return d.toISOString();
+    if (typeof d === "string" && d.length > 0) {
+        const parsed = new Date(d);
+        if (!Number.isNaN(parsed.getTime()))
+            return parsed.toISOString();
+    }
+    return fallback.toISOString();
+};
+const flagArray = (src) => {
+    if (!src)
+        return [];
+    if (src instanceof Set)
+        return Array.from(src);
+    return [...src];
+};
+const collectAttachments = (node, out) => {
+    if (!node)
+        return;
+    const isAttachment = node.disposition === "attachment" ||
+        (node.disposition === "inline" &&
+            (node.dispositionParameters?.filename ?? node.parameters?.name));
+    const filename = node.dispositionParameters?.filename ?? node.parameters?.name;
+    if (isAttachment && filename) {
+        out.push({
+            filename,
+            contentType: node.type ?? "application/octet-stream",
+            sizeBytes: node.size ?? 0,
+            partId: node.part ?? "",
+        });
+    }
+    for (const child of node.childNodes ?? []) {
+        collectAttachments(child, out);
+    }
+};
+const truncateBody = (body) => {
+    if (body === null)
+        return { value: null, truncated: false };
+    const bytes = Buffer.byteLength(body, "utf8");
+    if (bytes <= MAX_BODY_BYTES)
+        return { value: body, truncated: false };
+    // Truncate to MAX_BODY_BYTES bytes (UTF-8 safe).
+    const buf = Buffer.from(body, "utf8").subarray(0, MAX_BODY_BYTES);
+    return { value: buf.toString("utf8"), truncated: true };
+};
+const buildSnippet = (text) => {
+    if (text === null)
+        return "";
+    const trimmed = text.replace(/\s+/g, " ").trim();
+    return trimmed.slice(0, SNIPPET_CHARS);
+};
+/**
+ * Build a `StoredEmailPayload` from imapflow fetch output and decoded
+ * body parts. Pure: no imapflow types are imported, so tests can pass
+ * shaped POJOs.
+ */
+export const toStoredPayload = (msg, params) => {
+    const env = msg.envelope ?? {};
+    const attachments = [];
+    collectAttachments(msg.bodyStructure, attachments);
+    const bodyText = truncateBody(params.bodyText);
+    const bodyHtml = truncateBody(params.bodyHtml);
+    const fallbackDate = msg.internalDate ?? params.fetchedAt;
+    return {
+        accountId: params.accountId,
+        mailbox: params.mailbox,
+        uid: msg.uid,
+        uidValidity: params.uidValidity,
+        messageId: env.messageId ?? null,
+        inReplyTo: env.inReplyTo ?? null,
+        references: [],
+        from: env.from && env.from.length > 0 ? toAddr(env.from[0]) : null,
+        to: toAddrArr(env.to),
+        cc: toAddrArr(env.cc),
+        subject: env.subject ?? "",
+        date: toIso(env.date, fallbackDate),
+        flags: flagArray(msg.flags),
+        labels: flagArray(msg.labels),
+        hasAttachments: attachments.length > 0,
+        attachments,
+        snippet: buildSnippet(bodyText.value),
+        bodyText: bodyText.value,
+        bodyHtml: bodyHtml.value,
+        truncated: bodyText.truncated || bodyHtml.truncated || params.truncated,
+        fetchedAt: params.fetchedAt.toISOString(),
+    };
+};
+/**
+ * Strip `text/html` to an approximate plain-text representation. Conservative:
+ * removes scripts/styles, replaces tags with spaces, decodes a small set of
+ * named entities. Used by the `format="text"` option of get_email/get_emails.
+ */
+export const htmlToText = (html) => {
+    const noScript = html
+        .replace(/<script[\s\S]*?<\/script>/gi, "")
+        .replace(/<style[\s\S]*?<\/style>/gi, "");
+    const noTags = noScript.replace(/<[^>]+>/g, " ");
+    const decoded = noTags
+        .replace(/&nbsp;/g, " ")
+        .replace(/&amp;/g, "&")
+        .replace(/&lt;/g, "<")
+        .replace(/&gt;/g, ">")
+        .replace(/&quot;/g, '"')
+        .replace(/&#39;/g, "'");
+    return decoded.replace(/\s+/g, " ").trim();
+};
+/**
+ * Strip quoted reply blocks and signatures from a plain-text body. Heuristic
+ * but conservative: cuts at the first `On <date>, <name> wrote:` block, or at
+ * a leading-`>` quote run, or at a `-- ` signature delimiter.
+ */
+export const stripQuotedAndSignature = (text) => {
+    const lines = text.split(/\r?\n/);
+    const out = [];
+    for (const line of lines) {
+        if (/^-- $/.test(line))
+            break;
+        if (/^On\s.+wrote:$/.test(line))
+            break;
+        if (/^>+\s/.test(line))
+            break;
+        out.push(line);
+    }
+    return out.join("\n").trimEnd();
+};
+//# sourceMappingURL=mapper.js.map

package/dist/imap/mapper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mapper.js","sourceRoot":"","sources":["../../src/imap/mapper.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,MAAM,cAAc,GAAG,SAAS,CAAC,CAAC,uDAAuD;AACzF,MAAM,aAAa,GAAG,GAAG,CAAC;AA8C1B,MAAM,MAAM,GAAG,CAAC,CAAkB,EAAgB,EAAE,CAAC,CAAC;IACpD,IAAI,EAAE,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI;IACjD,OAAO,EAAE,CAAC,CAAC,OAAO,IAAI,EAAE;CACzB,CAAC,CAAC;AAEH,MAAM,SAAS,GAAG,CAAC,EAA0C,EAA2B,EAAE,CACxF,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AAE7D,MAAM,KAAK,GAAG,CAAC,CAA4B,EAAE,QAAc,EAAU,EAAE;IACrE,IAAI,CAAC,YAAY,IAAI;QAAE,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC;IAC9C,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1C,MAAM,MAAM,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC;QAC3B,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YAAE,OAAO,MAAM,CAAC,WAAW,EAAE,CAAC;IACnE,CAAC;IACD,OAAO,QAAQ,CAAC,WAAW,EAAE,CAAC;AAChC,CAAC,CAAC;AAEF,MAAM,SAAS,GAAG,CAAC,GAAwD,EAAqB,EAAE;IAChG,IAAI,CAAC,GAAG;QAAE,OAAO,EAAE,CAAC;IACpB,IAAI,GAAG,YAAY,GAAG;QAAE,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC/C,OAAO,CAAC,GAAG,GAAG,CAAC,CAAC;AAClB,CAAC,CAAC;AAEF,MAAM,kBAAkB,GAAG,CACzB,IAAuC,EACvC,GAAuB,EACjB,EAAE;IACR,IAAI,CAAC,IAAI;QAAE,OAAO;IAClB,MAAM,YAAY,GAChB,IAAI,CAAC,WAAW,KAAK,YAAY;QACjC,CAAC,IAAI,CAAC,WAAW,KAAK,QAAQ;YAC5B,CAAC,IAAI,CAAC,qBAAqB,EAAE,QAAQ,IAAI,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC,CAAC;IACrE,MAAM,QAAQ,GAAG,IAAI,CAAC,qBAAqB,EAAE,QAAQ,IAAI,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC;IAC/E,IAAI,YAAY,IAAI,QAAQ,EAAE,CAAC;QAC7B,GAAG,CAAC,IAAI,CAAC;YACP,QAAQ;YACR,WAAW,EAAE,IAAI,CAAC,IAAI,IAAI,0BAA0B;YACpD,SAAS,EAAE,IAAI,CAAC,IAAI,IAAI,CAAC;YACzB,MAAM,EAAE,IAAI,CAAC,IAAI,IAAI,EAAE;SACxB,CAAC,CAAC;IACL,CAAC;IACD,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,UAAU,IAAI,EAAE,EAAE,CAAC;QAC1C,kBAAkB,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IACjC,CAAC;AACH,CAAC,CAAC;AAEF,MAAM,YAAY,GAAG,CAAC,IAAmB,EAAgD,EAAE;IACzF,IAAI,IAAI,KAAK,IAAI;QAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;IAC5D,MAAM,KAAK,GAAG,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAC9C,IAAI,KAAK,IAAI,cAAc;QAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;IACtE,iDAAiD;IACjD,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,cAAc,CAAC,CAAC;IAClE,OAAO,EAAE,KAAK,EAAE,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;AAC1D,CAAC,CAAC;AAEF,MAAM,YAAY,GAAG,CAAC,IAAmB,EAAU,EAAE;IACnD,IAAI,IAAI,KAAK,IAAI;QAAE,OAAO,EAAE,CAAC;IAC7B,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IACjD,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,aAAa,CAAC,CAAC;AACzC,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAC7B,GAAuB,EACvB,MAAoB,EACA,EAAE;IACtB,MAAM,GAAG,GAAG,GAAG,CAAC,QAAQ,IAAI,EAAE,CAAC;IAC/B,MAAM,WAAW,GAAuB,EAAE,CAAC;IAC3C,kBAAkB,CAAC,GAAG,CAAC,aAAa,EAAE,WAAW,CAAC,CAAC;IACnD,MAAM,QAAQ,GAAG,YAAY,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC/C,MAAM,QAAQ,GAAG,YAAY,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC/C,MAAM,YAAY,GAAG,GAAG,CAAC,YAAY,IAAI,MAAM,CAAC,SAAS,CAAC;IAE1D,OAAO;QACL,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,GAAG,EAAE,GAAG,CAAC,GAAG;QACZ,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,SAAS,EAAE,GAAG,CAAC,SAAS,IAAI,IAAI;QAChC,SAAS,EAAE,GAAG,CAAC,SAAS,IAAI,IAAI;QAChC,UAAU,EAAE,EAAE;QACd,IAAI,EAAE,GAAG,CAAC,IAAI,IAAI,GAAG,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAoB,CAAC,CAAC,CAAC,CAAC,IAAI;QACrF,EAAE,EAAE,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC;QACrB,EAAE,EAAE,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC;QACrB,OAAO,EAAE,GAAG,CAAC,OAAO,IAAI,EAAE;QAC1B,IAAI,EAAE,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,YAAY,CAAC;QACnC,KAAK,EAAE,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC;QAC3B,MAAM,EAAE,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC;QAC7B,cAAc,EAAE,WAAW,CAAC,MAAM,GAAG,CAAC;QACtC,WAAW;QACX,OAAO,EAAE,YAAY,CAAC,QAAQ,CAAC,KAAK,CAAC;QACrC,QAAQ,EAAE,QAAQ,CAAC,KAAK;QACxB,QAAQ,EAAE,QAAQ,CAAC,KAAK;QACxB,SAAS,EAAE,QAAQ,CAAC,SAAS,IAAI,QAAQ,CAAC,SAAS,IAAI,MAAM,CAAC,SAAS;QACvE,SAAS,EAAE,MAAM,CAAC,SAAS,CAAC,WAAW,EAAE;KAC1C,CAAC;AACJ,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,IAAY,EAAU,EAAE;IACjD,MAAM,QAAQ,GAAG,IAAI;SAClB,OAAO,CAAC,6BAA6B,EAAE,EAAE,CAAC;SAC1C,OAAO,CAAC,2BAA2B,EAAE,EAAE,CAAC,CAAC;IAC5C,MAAM,MAAM,GAAG,QAAQ,CAAC,OAAO,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;IACjD,MAAM,OAAO,GAAG,MAAM;SACnB,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC;SACvB,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC;SACtB,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC;SACrB,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC;SACrB,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC;SACvB,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;IAC1B,OAAO,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;AAC7C,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,IAAY,EAAU,EAAE;IAC9D,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAClC,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC;YAAE,MAAM;QAC9B,IAAI,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC;YAAE,MAAM;QACvC,IAAI,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC;YAAE,MAAM;QAC9B,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACjB,CAAC;IACD,OAAO,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;AAClC,CAAC,CAAC"}

package/dist/imap/pool.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Per-account `ImapFlow` connection cache.
+ *
+ * Reliability properties:
+ *  - Connections are created lazily and reused across tool calls and
+ *    sync ticks. Lock acquisition (per imapflow's getMailboxLock) is
+ *    the only way folder operations occur, so two concurrent callers
+ *    can share one socket without races.
+ *  - On a connection that has dropped (`usable === false`), the next
+ *    `forAccount(...)` call rebuilds it.
+ *  - OAuth refresh: imapflow accepts an `accessToken` for XOAUTH2;
+ *    the pool keeps a per-account "fetcher" that swaps the access
+ *    token in-place at reconnect time. The provider-side refresh is
+ *    a follow-up (see SDK gap notes); for v1 the password path is
+ *    fully wired and OAuth runs against a long-lived access token.
+ */
+import { ImapFlow } from "imapflow";
+import { type Account } from "../config/schema.js";
+import { type ImapError } from "../domain/errors.js";
+import { type Result } from "../domain/result.js";
+export type ImapPool = {
+    readonly forAccount: (accountId: string) => Promise<Result<ImapError, ImapFlow>>;
+    readonly closeAll: () => Promise<void>;
+    readonly accountIds: readonly string[];
+};
+export declare const buildImapPool: (accounts: readonly Account[]) => ImapPool;

package/dist/imap/pool.js

@@ -0,0 +1,92 @@
+/**
+ * Per-account `ImapFlow` connection cache.
+ *
+ * Reliability properties:
+ *  - Connections are created lazily and reused across tool calls and
+ *    sync ticks. Lock acquisition (per imapflow's getMailboxLock) is
+ *    the only way folder operations occur, so two concurrent callers
+ *    can share one socket without races.
+ *  - On a connection that has dropped (`usable === false`), the next
+ *    `forAccount(...)` call rebuilds it.
+ *  - OAuth refresh: imapflow accepts an `accessToken` for XOAUTH2;
+ *    the pool keeps a per-account "fetcher" that swaps the access
+ *    token in-place at reconnect time. The provider-side refresh is
+ *    a follow-up (see SDK gap notes); for v1 the password path is
+ *    fully wired and OAuth runs against a long-lived access token.
+ */
+import { ImapFlow } from "imapflow";
+import { isOAuthAccount } from "../config/schema.js";
+import { imapError } from "../domain/errors.js";
+import { Err, Ok } from "../domain/result.js";
+const buildClient = (acct) => {
+    if (isOAuthAccount(acct)) {
+        return new ImapFlow({
+            host: acct.imap.host,
+            port: acct.imap.port,
+            secure: acct.imap.tls,
+            tls: { rejectUnauthorized: acct.imap.verify_ssl },
+            auth: {
+                user: acct.email,
+                accessToken: acct.oauth2.refresh_token,
+            },
+            logger: false,
+        });
+    }
+    return new ImapFlow({
+        host: acct.imap.host,
+        port: acct.imap.port,
+        secure: acct.imap.tls,
+        tls: { rejectUnauthorized: acct.imap.verify_ssl },
+        auth: {
+            user: acct.username ?? acct.email,
+            pass: acct.password,
+        },
+        logger: false,
+    });
+};
+export const buildImapPool = (accounts) => {
+    const byId = new Map();
+    for (const a of accounts)
+        byId.set(a.name, a);
+    const liveById = new Map();
+    const forAccount = async (accountId) => {
+        const acct = byId.get(accountId);
+        if (!acct)
+            return Err(imapError(accountId, "unknown account id"));
+        const cached = liveById.get(accountId);
+        if (cached && cached.usable)
+            return Ok(cached);
+        if (cached && !cached.usable) {
+            try {
+                await cached.logout();
+            }
+            catch {
+                // ignore: connection was already broken
+            }
+            liveById.delete(accountId);
+        }
+        const client = buildClient(acct);
+        try {
+            await client.connect();
+        }
+        catch (cause) {
+            return Err(imapError(accountId, `connect failed: ${cause?.message ?? String(cause)}`, cause));
+        }
+        liveById.set(accountId, client);
+        return Ok(client);
+    };
+    const closeAll = async () => {
+        const closes = Array.from(liveById.values()).map(async (c) => {
+            try {
+                await c.logout();
+            }
+            catch {
+                // ignore on shutdown
+            }
+        });
+        await Promise.all(closes);
+        liveById.clear();
+    };
+    return { forAccount, closeAll, accountIds: Array.from(byId.keys()) };
+};
+//# sourceMappingURL=pool.js.map

package/dist/imap/pool.js.map

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

package/dist/imap/virtualFolders.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Allowlist of well-known IMAP "virtual" folders. move_email and
+ * bulk_action#move refuse these because IMAP MOVE on a virtual mailbox
+ * either fails or moves a different message than the agent intended.
+ *
+ * The list is intentionally short and explicit; `find_mailbox_folder`
+ * is the documented path to resolve real folders for messages
+ * discovered via virtuals (e.g. Gmail's "[Gmail]/All Mail").
+ */
+export declare const isVirtualFolderPath: (path: string) => boolean;
+export declare const isVirtualSpecialUse: (specialUse: string | undefined | null) => boolean;

package/dist/imap/virtualFolders.js

@@ -0,0 +1,20 @@
+/**
+ * Allowlist of well-known IMAP "virtual" folders. move_email and
+ * bulk_action#move refuse these because IMAP MOVE on a virtual mailbox
+ * either fails or moves a different message than the agent intended.
+ *
+ * The list is intentionally short and explicit; `find_mailbox_folder`
+ * is the documented path to resolve real folders for messages
+ * discovered via virtuals (e.g. Gmail's "[Gmail]/All Mail").
+ */
+const VIRTUAL_FOLDER_PATHS = new Set([
+    "[Gmail]/All Mail",
+    "[Gmail]/Starred",
+    "[Gmail]/Important",
+    "INBOX/All Mail",
+    "All Mail",
+]);
+const VIRTUAL_SPECIAL_USE = new Set(["\\All", "\\Flagged", "\\Important"]);
+export const isVirtualFolderPath = (path) => VIRTUAL_FOLDER_PATHS.has(path);
+export const isVirtualSpecialUse = (specialUse) => specialUse !== undefined && specialUse !== null && VIRTUAL_SPECIAL_USE.has(specialUse);
+//# sourceMappingURL=virtualFolders.js.map

package/dist/imap/virtualFolders.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"virtualFolders.js","sourceRoot":"","sources":["../../src/imap/virtualFolders.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,oBAAoB,GAAG,IAAI,GAAG,CAAS;IAC3C,kBAAkB;IAClB,iBAAiB;IACjB,mBAAmB;IACnB,gBAAgB;IAChB,UAAU;CACX,CAAC,CAAC;AAEH,MAAM,mBAAmB,GAAG,IAAI,GAAG,CAAS,CAAC,OAAO,EAAE,WAAW,EAAE,aAAa,CAAC,CAAC,CAAC;AAEnF,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,IAAY,EAAW,EAAE,CAAC,oBAAoB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AAE7F,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,UAAqC,EAAW,EAAE,CACpF,UAAU,KAAK,SAAS,IAAI,UAAU,KAAK,IAAI,IAAI,mBAAmB,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC"}

package/dist/sdk/diskdClient.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Build the @diskd/sdk client used by the drive-backed messages store.
+ *
+ * SDK constraint observed in 5.1.x: `APIS_API_KEY` and `APIS_BASE_URL`
+ * are read from `process.env` only -- there is no constructor param.
+ * We therefore copy the TOML `[sdk]` block into env *before* calling
+ * `diskd.auth.apiKey()`. This is a small SDK gap (would prefer explicit
+ * params); documented in the design plan and called out here.
+ *
+ * Workspace id falls back to `MCP_HUB_WORKSPACE_ID` (injected by mcp-hub
+ * k8s-gateway specs) so deployments don't have to encode workspaceId twice.
+ */
+import { diskd } from "@diskd/sdk";
+import type { SdkSettings } from "../config/schema.js";
+import { type ConfigError } from "../domain/errors.js";
+import { type Result } from "../domain/result.js";
+export type DiskdRuntime = {
+    readonly workspaceId: string;
+    readonly messagesStore: ReturnType<typeof diskd.os.messagesStore>;
+};
+export declare const buildDiskd: (sdkSettings: SdkSettings, envWorkspaceId: string | undefined) => Result<ConfigError, DiskdRuntime>;

package/dist/sdk/diskdClient.js

@@ -0,0 +1,39 @@
+/**
+ * Build the @diskd/sdk client used by the drive-backed messages store.
+ *
+ * SDK constraint observed in 5.1.x: `APIS_API_KEY` and `APIS_BASE_URL`
+ * are read from `process.env` only -- there is no constructor param.
+ * We therefore copy the TOML `[sdk]` block into env *before* calling
+ * `diskd.auth.apiKey()`. This is a small SDK gap (would prefer explicit
+ * params); documented in the design plan and called out here.
+ *
+ * Workspace id falls back to `MCP_HUB_WORKSPACE_ID` (injected by mcp-hub
+ * k8s-gateway specs) so deployments don't have to encode workspaceId twice.
+ */
+import { diskd } from "@diskd/sdk";
+import { configError } from "../domain/errors.js";
+import { Err, Ok } from "../domain/result.js";
+const ensureEnv = (key, value) => {
+    // Only set if unset, so an explicit env value (e.g. from mcp-hub) wins
+    // over the TOML when present.
+    const current = process.env[key];
+    if (current === undefined || current.length === 0) {
+        process.env[key] = value;
+    }
+};
+export const buildDiskd = (sdkSettings, envWorkspaceId) => {
+    const workspaceId = sdkSettings.workspace_id ?? envWorkspaceId;
+    if (workspaceId === undefined || workspaceId.length === 0) {
+        return Err(configError("workspace_id is missing -- set [sdk].workspace_id in TOML or MCP_HUB_WORKSPACE_ID in env"));
+    }
+    ensureEnv("APIS_API_KEY", sdkSettings.api_key);
+    if (sdkSettings.base_url)
+        ensureEnv("APIS_BASE_URL", sdkSettings.base_url);
+    if (process.env.APIS_BASE_URL === undefined || process.env.APIS_BASE_URL.length === 0) {
+        return Err(configError("APIS_BASE_URL is not set -- provide [sdk].base_url in TOML or APIS_BASE_URL in env"));
+    }
+    const auth = diskd.auth.apiKey({ workspaceId });
+    const messagesStore = diskd.os.messagesStore({ auth });
+    return Ok({ workspaceId, messagesStore });
+};
+//# sourceMappingURL=diskdClient.js.map

package/dist/sdk/diskdClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diskdClient.js","sourceRoot":"","sources":["../../src/sdk/diskdClient.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnC,OAAO,EAAoB,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACpE,OAAO,EAAE,GAAG,EAAE,EAAE,EAAe,MAAM,qBAAqB,CAAC;AAO3D,MAAM,SAAS,GAAG,CAAC,GAAW,EAAE,KAAa,EAAQ,EAAE;IACrD,uEAAuE;IACvE,8BAA8B;IAC9B,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACjC,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAClD,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;IAC3B,CAAC;AACH,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,UAAU,GAAG,CACxB,WAAwB,EACxB,cAAkC,EACC,EAAE;IACrC,MAAM,WAAW,GAAG,WAAW,CAAC,YAAY,IAAI,cAAc,CAAC;IAC/D,IAAI,WAAW,KAAK,SAAS,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1D,OAAO,GAAG,CACR,WAAW,CACT,0FAA0F,CAC3F,CACF,CAAC;IACJ,CAAC;IAED,SAAS,CAAC,cAAc,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;IAC/C,IAAI,WAAW,CAAC,QAAQ;QAAE,SAAS,CAAC,eAAe,EAAE,WAAW,CAAC,QAAQ,CAAC,CAAC;IAC3E,IAAI,OAAO,CAAC,GAAG,CAAC,aAAa,KAAK,SAAS,IAAI,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtF,OAAO,GAAG,CACR,WAAW,CACT,oFAAoF,CACrF,CACF,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC;IAChD,MAAM,aAAa,GAAG,KAAK,CAAC,EAAE,CAAC,aAAa,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;IACvD,OAAO,EAAE,CAAC,EAAE,WAAW,EAAE,aAAa,EAAE,CAAC,CAAC;AAC5C,CAAC,CAAC"}