@diskd-ai/email-client-mcp 0.1.0

package/dist/sync/sync.js

@@ -0,0 +1,383 @@
+/**
+ * The reliability core. `runSyncOnce(account)` performs one watcher
+ * pass for one account.
+ *
+ * Invariants enforced here:
+ *  1. `lastSyncedUid` is advanced ONLY after a successful upsertBatch.
+ *     A crash mid-tick or a Drive 5xx leaves the checkpoint untouched,
+ *     so the next tick re-fetches the unprocessed UIDs (idempotent
+ *     because externalId is `${UIDVALIDITY}:${UID}`).
+ *  2. UIDVALIDITY mismatch -> drop+recreate folder, resync from UID 1.
+ *  3. Folder metadata is the source of truth across restarts. The
+ *     watcher never relies on in-memory state to resume.
+ *  4. Folders deleted in IMAP are pruned from Drive at the end of a tick.
+ *  5. A bounded sliding-window flag reconciliation catches drift on
+ *     already-synced UIDs without re-downloading bodies.
+ *
+ * The function takes injected dependencies (drive store, IMAP client
+ * factory, mapper) so unit tests can drive it without real I/O.
+ */
+import { isOAuthAccount } from "../config/schema.js";
+import { errorMessage, imapError } from "../domain/errors.js";
+import { Err } from "../domain/result.js";
+import { toStoredPayload } from "../imap/mapper.js";
+import { externalIdFor, sanitizeMailboxId } from "../store/conventions.js";
+const BATCH_SIZE = 50;
+const parseSyncState = (raw) => {
+    if (raw === null)
+        return null;
+    const uv = raw.uidValidity;
+    const un = raw.uidNext;
+    const ls = raw.lastSyncedUid;
+    if (typeof uv !== "number" || typeof un !== "number" || typeof ls !== "number")
+        return null;
+    return {
+        uidValidity: uv,
+        uidNext: un,
+        lastSyncedUid: ls,
+        lastSyncStartedAt: typeof raw.lastSyncStartedAt === "string" ? raw.lastSyncStartedAt : null,
+        lastSyncFinishedAt: typeof raw.lastSyncFinishedAt === "string" ? raw.lastSyncFinishedAt : null,
+        lastSyncError: typeof raw.lastSyncError === "string" ? raw.lastSyncError : null,
+    };
+};
+const range = (lo, hi) => {
+    const out = [];
+    for (let from = lo; from <= hi; from += BATCH_SIZE) {
+        const to = Math.min(from + BATCH_SIZE - 1, hi);
+        out.push([from, to]);
+    }
+    return out;
+};
+const flagsAreEqual = (a, b) => {
+    if (a.length !== b.length)
+        return false;
+    const sa = new Set(a);
+    for (const x of b)
+        if (!sa.has(x))
+            return false;
+    return true;
+};
+/**
+ * Sync one folder. Returns the per-folder report; never throws.
+ * `lastSyncedUid` is advanced only after each successful batch upsert.
+ */
+const syncFolder = async (deps, account, mailboxId, folderPath, flagWindow) => {
+    const folderId = folderPath;
+    const startIso = deps.now().toISOString();
+    const statusR = await deps.imap.folderStatus(account.name, folderPath);
+    if (statusR.tag === "Err") {
+        return {
+            folderId,
+            newMessages: 0,
+            reconciledFlags: 0,
+            uidValidityRolled: false,
+            error: errorMessage(statusR.error),
+        };
+    }
+    const status = statusR.value;
+    const existing = await deps.drive.getFolder(mailboxId, folderId);
+    if (existing.tag === "Err") {
+        return {
+            folderId,
+            newMessages: 0,
+            reconciledFlags: 0,
+            uidValidityRolled: false,
+            error: errorMessage(existing.error),
+        };
+    }
+    let state = parseSyncState(existing.value?.metadata ?? null);
+    let uidValidityRolled = false;
+    // UIDVALIDITY rollover: drop the folder and start over.
+    if (state !== null && state.uidValidity !== status.uidValidity) {
+        uidValidityRolled = true;
+        const del = await deps.drive.deleteFolder(mailboxId, folderId);
+        if (del.tag === "Err") {
+            return {
+                folderId,
+                newMessages: 0,
+                reconciledFlags: 0,
+                uidValidityRolled,
+                error: errorMessage(del.error),
+            };
+        }
+        state = null;
+    }
+    const fromUid = (state?.lastSyncedUid ?? 0) + 1;
+    const toUid = status.uidNext - 1;
+    let lastSynced = state?.lastSyncedUid ?? 0;
+    let newMessages = 0;
+    // Initial folder upsert with fresh metadata. We rewrite metadata at
+    // each successful batch so the on-disk checkpoint mirrors progress.
+    const writeState = async (next) => deps.drive.upsertFolder(mailboxId, folderId, folderId, next);
+    if (state === null) {
+        const init = {
+            uidValidity: status.uidValidity,
+            uidNext: status.uidNext,
+            lastSyncedUid: 0,
+            lastSyncStartedAt: startIso,
+            lastSyncFinishedAt: null,
+            lastSyncError: null,
+        };
+        const w = await writeState(init);
+        if (w.tag === "Err") {
+            return {
+                folderId,
+                newMessages: 0,
+                reconciledFlags: 0,
+                uidValidityRolled,
+                error: errorMessage(w.error),
+            };
+        }
+        state = init;
+    }
+    else {
+        const w = await writeState({
+            ...state,
+            uidNext: status.uidNext,
+            lastSyncStartedAt: startIso,
+            lastSyncError: null,
+        });
+        if (w.tag === "Err") {
+            return {
+                folderId,
+                newMessages: 0,
+                reconciledFlags: 0,
+                uidValidityRolled,
+                error: errorMessage(w.error),
+            };
+        }
+    }
+    if (toUid >= fromUid) {
+        for (const [batchFrom, batchTo] of range(fromUid, toUid)) {
+            const payloads = [];
+            const externalIds = [];
+            let highestUidInBatch = lastSynced;
+            try {
+                for await (const bundle of deps.imap.fetchRange(account.name, folderPath, batchFrom, batchTo)) {
+                    const uid = bundle.imapMessage.uid;
+                    if (uid > highestUidInBatch)
+                        highestUidInBatch = uid;
+                    const payload = toStoredPayload(bundle.imapMessage, {
+                        accountId: account.name,
+                        mailbox: folderPath,
+                        uidValidity: status.uidValidity,
+                        fetchedAt: deps.now(),
+                        bodyText: bundle.bodyText,
+                        bodyHtml: bundle.bodyHtml,
+                        truncated: false,
+                    });
+                    payloads.push(payload);
+                    externalIds.push(externalIdFor(status.uidValidity, uid));
+                }
+            }
+            catch (cause) {
+                // Imap fetch failure: leave checkpoint untouched, surface error.
+                const e = imapError(account.name, `fetch UID ${batchFrom}:${batchTo}`, cause);
+                const w = await writeState({
+                    ...state,
+                    lastSyncError: errorMessage(e),
+                    lastSyncFinishedAt: deps.now().toISOString(),
+                });
+                if (w.tag === "Err") {
+                    return {
+                        folderId,
+                        newMessages,
+                        reconciledFlags: 0,
+                        uidValidityRolled,
+                        error: errorMessage(w.error),
+                    };
+                }
+                return {
+                    folderId,
+                    newMessages,
+                    reconciledFlags: 0,
+                    uidValidityRolled,
+                    error: errorMessage(e),
+                };
+            }
+            if (payloads.length === 0) {
+                // Range was empty -- advance the checkpoint to the batch top
+                // anyway, we now know there is nothing to fetch in there.
+                lastSynced = batchTo;
+            }
+            else {
+                const ups = await deps.drive.upsertMessages(mailboxId, folderId, payloads, externalIds);
+                if (ups.tag === "Err") {
+                    // Critical: do NOT advance lastSyncedUid. Next tick replays.
+                    const w = await writeState({
+                        ...state,
+                        lastSyncError: errorMessage(ups.error),
+                        lastSyncFinishedAt: deps.now().toISOString(),
+                    });
+                    if (w.tag === "Err") {
+                        return {
+                            folderId,
+                            newMessages,
+                            reconciledFlags: 0,
+                            uidValidityRolled,
+                            error: errorMessage(w.error),
+                        };
+                    }
+                    return {
+                        folderId,
+                        newMessages,
+                        reconciledFlags: 0,
+                        uidValidityRolled,
+                        error: errorMessage(ups.error),
+                    };
+                }
+                newMessages += ups.value.inserted + ups.value.updated;
+                lastSynced = highestUidInBatch;
+            }
+            // Checkpoint: advance lastSyncedUid after the batch is durable.
+            const checkpoint = {
+                ...state,
+                uidValidity: status.uidValidity,
+                uidNext: status.uidNext,
+                lastSyncedUid: lastSynced,
+                lastSyncFinishedAt: deps.now().toISOString(),
+                lastSyncError: null,
+            };
+            const w = await writeState(checkpoint);
+            if (w.tag === "Err") {
+                return {
+                    folderId,
+                    newMessages,
+                    reconciledFlags: 0,
+                    uidValidityRolled,
+                    error: errorMessage(w.error),
+                };
+            }
+            state = checkpoint;
+        }
+    }
+    // Sliding-window flag reconciliation. Bounds drift to flagWindow UIDs.
+    let reconciledFlags = 0;
+    if (flagWindow > 0 && lastSynced > 0) {
+        const reconFrom = Math.max(1, lastSynced - flagWindow + 1);
+        try {
+            const updated = [];
+            const updatedIds = [];
+            for await (const env of deps.imap.fetchEnvelopesRange(account.name, folderPath, reconFrom, lastSynced)) {
+                const incoming = toStoredPayload(env, {
+                    accountId: account.name,
+                    mailbox: folderPath,
+                    uidValidity: status.uidValidity,
+                    fetchedAt: deps.now(),
+                    bodyText: null,
+                    bodyHtml: null,
+                    truncated: false,
+                });
+                // Always upsert -- the store is opaque, but flagsAreEqual would
+                // require a read-back. Bounded set keeps cost predictable.
+                // We keep the shape stable; bodyText/Html stay null in this mode
+                // but flags/labels reflect the latest IMAP state.
+                if (!flagsAreEqual(incoming.flags, [])) {
+                    updated.push(incoming);
+                    updatedIds.push(externalIdFor(status.uidValidity, env.uid));
+                }
+                else {
+                    updated.push(incoming);
+                    updatedIds.push(externalIdFor(status.uidValidity, env.uid));
+                }
+            }
+            if (updated.length > 0) {
+                const ups = await deps.drive.upsertMessages(mailboxId, folderId, updated, updatedIds);
+                if (ups.tag === "Err") {
+                    // Reconciliation is best-effort; record but don't advance error state.
+                    return {
+                        folderId,
+                        newMessages,
+                        reconciledFlags: 0,
+                        uidValidityRolled,
+                        error: errorMessage(ups.error),
+                    };
+                }
+                reconciledFlags = updated.length;
+            }
+        }
+        catch (cause) {
+            // Best-effort step; keep main result.
+            const e = imapError(account.name, "flag reconciliation", cause);
+            return {
+                folderId,
+                newMessages,
+                reconciledFlags: 0,
+                uidValidityRolled,
+                error: errorMessage(e),
+            };
+        }
+    }
+    return { folderId, newMessages, reconciledFlags, uidValidityRolled, error: null };
+};
+/**
+ * Run one sync tick for one account. Sequentially walks all folders,
+ * then prunes Drive folders that no longer exist in IMAP.
+ */
+export const runSyncOnce = async (deps, account, watcher) => {
+    const startedAt = deps.now().toISOString();
+    const mailboxId = sanitizeMailboxId(account.name);
+    const displayName = isOAuthAccount(account)
+        ? account.email
+        : (account.full_name ?? account.email);
+    const ens = await deps.drive.ensureMailbox(mailboxId, displayName);
+    if (ens.tag === "Err") {
+        return {
+            accountId: account.name,
+            folders: [],
+            prunedFolders: 0,
+            startedAt,
+            finishedAt: deps.now().toISOString(),
+            error: errorMessage(ens.error),
+        };
+    }
+    const foldersR = await deps.imap.listFolders(account.name);
+    if (foldersR.tag === "Err") {
+        return {
+            accountId: account.name,
+            folders: [],
+            prunedFolders: 0,
+            startedAt,
+            finishedAt: deps.now().toISOString(),
+            error: errorMessage(foldersR.error),
+        };
+    }
+    const allFolders = foldersR.value;
+    const filteredFolders = (() => {
+        if (watcher.folders === undefined || watcher.folders.length === 0)
+            return allFolders;
+        const allow = new Set(watcher.folders);
+        return allFolders.filter((f) => allow.has(f.path));
+    })();
+    const reports = [];
+    for (const f of filteredFolders) {
+        const r = await syncFolder(deps, account, mailboxId, f.path, watcher.flag_reconcile_window);
+        reports.push(r);
+    }
+    // Prune Drive folders that disappeared from IMAP.
+    let prunedFolders = 0;
+    const driveFoldersR = await deps.drive.listFolders(mailboxId);
+    if (driveFoldersR.tag === "Ok") {
+        const imapPaths = new Set(filteredFolders.map((f) => f.path));
+        for (const df of driveFoldersR.value) {
+            if (!imapPaths.has(df.folderId)) {
+                const del = await deps.drive.deleteFolder(mailboxId, df.folderId);
+                if (del.tag === "Ok")
+                    prunedFolders += 1;
+            }
+        }
+    }
+    const finishedAt = deps.now().toISOString();
+    const firstError = reports.find((r) => r.error !== null)?.error ?? null;
+    return {
+        accountId: account.name,
+        folders: reports,
+        prunedFolders,
+        startedAt,
+        finishedAt,
+        error: firstError,
+    };
+};
+// Re-export for tests.
+export const __test__ = { Err };
+//# sourceMappingURL=sync.js.map

package/dist/sync/sync.js.map

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

package/dist/sync/watcher.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Interval-based watcher.
+ *
+ * Reliability properties:
+ *  - Per-account in-flight lock: a tick that runs longer than the
+ *    interval will not be doubled-up. The next interval simply skips
+ *    the busy account (logged) -- it never queues.
+ *  - Hard floor of `MIN_TICK_INTERVAL_MS` per spec ("no more often
+ *    than 1 minute"). Configured intervals below the floor are clamped.
+ *  - Status snapshot exposes per-account / per-folder progress for
+ *    `get_watcher_status`.
+ *  - Errors are caught at the per-account boundary and recorded into
+ *    the snapshot; one bad account does not stop the others.
+ */
+import type { Account, WatcherSettings } from "../config/schema.js";
+import { type SyncDeps, type SyncReport } from "./sync.js";
+export type WatcherFolderStatus = {
+    readonly folderId: string;
+    readonly newMessages: number;
+    readonly reconciledFlags: number;
+    readonly uidValidityRolled: boolean;
+    readonly error: string | null;
+};
+export type WatcherAccountStatus = {
+    readonly accountId: string;
+    readonly currentlySyncing: boolean;
+    readonly lastTickStartedAt: string | null;
+    readonly lastTickFinishedAt: string | null;
+    readonly lastTickError: string | null;
+    readonly folders: readonly WatcherFolderStatus[];
+};
+export type WatcherStatus = {
+    readonly running: boolean;
+    readonly intervalMs: number;
+    readonly accounts: readonly WatcherAccountStatus[];
+};
+export type Watcher = {
+    readonly start: () => void;
+    readonly stop: () => Promise<void>;
+    readonly status: () => WatcherStatus;
+    readonly runOnceNow: (accountId?: string) => Promise<readonly SyncReport[]>;
+};
+export declare const buildWatcher: (deps: SyncDeps, accounts: readonly Account[], watcher: WatcherSettings, log: (msg: string, extra?: Readonly<Record<string, unknown>>) => void) => Watcher;

package/dist/sync/watcher.js

@@ -0,0 +1,141 @@
+/**
+ * Interval-based watcher.
+ *
+ * Reliability properties:
+ *  - Per-account in-flight lock: a tick that runs longer than the
+ *    interval will not be doubled-up. The next interval simply skips
+ *    the busy account (logged) -- it never queues.
+ *  - Hard floor of `MIN_TICK_INTERVAL_MS` per spec ("no more often
+ *    than 1 minute"). Configured intervals below the floor are clamped.
+ *  - Status snapshot exposes per-account / per-folder progress for
+ *    `get_watcher_status`.
+ *  - Errors are caught at the per-account boundary and recorded into
+ *    the snapshot; one bad account does not stop the others.
+ */
+import { clampTickInterval } from "./backoff.js";
+import { runSyncOnce } from "./sync.js";
+const reportToStatus = (rep) => ({
+    accountId: rep.accountId,
+    currentlySyncing: false,
+    lastTickStartedAt: rep.startedAt,
+    lastTickFinishedAt: rep.finishedAt,
+    lastTickError: rep.error,
+    folders: rep.folders.map((f) => ({
+        folderId: f.folderId,
+        newMessages: f.newMessages,
+        reconciledFlags: f.reconciledFlags,
+        uidValidityRolled: f.uidValidityRolled,
+        error: f.error,
+    })),
+});
+export const buildWatcher = (deps, accounts, watcher, log) => {
+    const intervalMs = clampTickInterval(watcher.interval_ms);
+    const inFlight = new Map();
+    const lastStatus = new Map();
+    for (const a of accounts) {
+        lastStatus.set(a.name, {
+            accountId: a.name,
+            currentlySyncing: false,
+            lastTickStartedAt: null,
+            lastTickFinishedAt: null,
+            lastTickError: null,
+            folders: [],
+        });
+    }
+    let timer = null;
+    let stopped = false;
+    const runForAccount = async (acct) => {
+        const existing = inFlight.get(acct.name);
+        if (existing !== undefined) {
+            log("watcher.skip-overlap", { accountId: acct.name });
+            return existing;
+        }
+        const cur = lastStatus.get(acct.name);
+        if (cur !== undefined) {
+            lastStatus.set(acct.name, { ...cur, currentlySyncing: true });
+        }
+        const p = (async () => {
+            try {
+                const rep = await runSyncOnce(deps, acct, watcher);
+                lastStatus.set(acct.name, reportToStatus(rep));
+                if (rep.error !== null)
+                    log("watcher.tick-err", { accountId: acct.name, error: rep.error });
+                else
+                    log("watcher.tick-ok", {
+                        accountId: acct.name,
+                        folders: rep.folders.length,
+                        newMessages: rep.folders.reduce((s, f) => s + f.newMessages, 0),
+                    });
+                return rep;
+            }
+            catch (cause) {
+                const msg = cause?.message ?? String(cause);
+                const finishedAt = deps.now().toISOString();
+                const rep = {
+                    accountId: acct.name,
+                    folders: [],
+                    prunedFolders: 0,
+                    startedAt: cur?.lastTickStartedAt ?? finishedAt,
+                    finishedAt,
+                    error: msg,
+                };
+                lastStatus.set(acct.name, reportToStatus(rep));
+                log("watcher.tick-throw", { accountId: acct.name, error: msg });
+                return rep;
+            }
+        })();
+        inFlight.set(acct.name, p);
+        try {
+            return await p;
+        }
+        finally {
+            inFlight.delete(acct.name);
+        }
+    };
+    const tick = async () => {
+        if (stopped)
+            return;
+        // Run all accounts in parallel; in-flight lock per account makes overlap safe.
+        const work = accounts.map((a) => runForAccount(a));
+        await Promise.all(work);
+    };
+    const start = () => {
+        if (timer !== null)
+            return;
+        if (!watcher.enabled) {
+            log("watcher.disabled");
+            return;
+        }
+        log("watcher.start", { intervalMs, accounts: accounts.map((a) => a.name) });
+        // Fire one tick immediately on boot so first sync does not wait a full interval.
+        void tick();
+        timer = setInterval(() => {
+            void tick();
+        }, intervalMs);
+    };
+    const stop = async () => {
+        stopped = true;
+        if (timer !== null) {
+            clearInterval(timer);
+            timer = null;
+        }
+        // Wait for any in-flight ticks so we never tear state down mid-batch.
+        await Promise.all(Array.from(inFlight.values()));
+    };
+    const status = () => ({
+        running: timer !== null,
+        intervalMs,
+        accounts: Array.from(lastStatus.values()),
+    });
+    const runOnceNow = async (accountId) => {
+        if (accountId !== undefined) {
+            const acct = accounts.find((a) => a.name === accountId);
+            if (acct === undefined)
+                return [];
+            return [await runForAccount(acct)];
+        }
+        return await Promise.all(accounts.map((a) => runForAccount(a)));
+    };
+    return { start, stop, status, runOnceNow };
+};
+//# sourceMappingURL=watcher.js.map

package/dist/sync/watcher.js.map

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

package/dist/tools/bulkAction.d.ts

@@ -0,0 +1,41 @@
+/**
+ * MCP tool: bulk_action -- batch operation on a UID list (max 100).
+ *
+ * Actions:
+ *   - mark_read / mark_unread: STORE +/-FLAGS \\Seen
+ *   - flag / unflag:           STORE +/-FLAGS \\Flagged
+ *   - move:                    MOVE to targetMailbox (refuses virtual sources)
+ *   - delete:                  EXPUNGE-style delete
+ *
+ * Returns per-UID success/failure detail so callers can recover.
+ */
+import { z } from "zod";
+import { type AppError } from "../domain/errors.js";
+import { type Result } from "../domain/result.js";
+import type { ImapPool } from "../imap/pool.js";
+export declare const bulkActionInput: z.ZodObject<{
+    account: z.ZodString;
+    sourceMailbox: z.ZodString;
+    uids: z.ZodArray<z.ZodNumber, "many">;
+    action: z.ZodEnum<["mark_read", "mark_unread", "flag", "unflag", "move", "delete"]>;
+    targetMailbox: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    account: string;
+    sourceMailbox: string;
+    uids: number[];
+    action: "delete" | "mark_read" | "mark_unread" | "flag" | "unflag" | "move";
+    targetMailbox?: string | undefined;
+}, {
+    account: string;
+    sourceMailbox: string;
+    uids: number[];
+    action: "delete" | "mark_read" | "mark_unread" | "flag" | "unflag" | "move";
+    targetMailbox?: string | undefined;
+}>;
+export type BulkActionInput = z.infer<typeof bulkActionInput>;
+export type BulkActionResult = {
+    readonly action: BulkActionInput["action"];
+    readonly succeeded: number;
+    readonly failedUids: readonly number[];
+};
+export declare const bulkAction: (pool: ImapPool, input: BulkActionInput) => Promise<Result<AppError, BulkActionResult>>;