@diskd-ai/email-client-mcp 0.1.0

package/dist/tools/bulkAction.js

@@ -0,0 +1,82 @@
+/**
+ * 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 { imapError, notFound, virtualFolderRefused } from "../domain/errors.js";
+import { Err, Ok } from "../domain/result.js";
+import { withMailboxLock } from "../imap/fetch.js";
+import { isVirtualFolderPath } from "../imap/virtualFolders.js";
+const bulkActionEnum = z.enum(["mark_read", "mark_unread", "flag", "unflag", "move", "delete"]);
+export const bulkActionInput = z
+    .object({
+    account: z.string().min(1),
+    sourceMailbox: z.string().min(1),
+    uids: z.array(z.number().int().positive()).min(1).max(100),
+    action: bulkActionEnum,
+    targetMailbox: z.string().optional(),
+})
+    .strict();
+export const bulkAction = async (pool, input) => {
+    if (!pool.accountIds.includes(input.account))
+        return Err(notFound(`account '${input.account}'`));
+    if (input.action === "move" &&
+        (input.targetMailbox === undefined || input.targetMailbox.length === 0)) {
+        return Err(imapError(input.account, "bulk_action(move) requires targetMailbox"));
+    }
+    if (input.action === "move" && isVirtualFolderPath(input.sourceMailbox)) {
+        return Err(virtualFolderRefused(input.sourceMailbox));
+    }
+    const clientR = await pool.forAccount(input.account);
+    if (clientR.tag === "Err")
+        return clientR;
+    const client = clientR.value;
+    try {
+        return await withMailboxLock(client, input.sourceMailbox, async () => {
+            let ok = false;
+            switch (input.action) {
+                case "mark_read":
+                    ok = await client.messageFlagsAdd(input.uids, ["\\Seen"], { uid: true });
+                    break;
+                case "mark_unread":
+                    ok = await client.messageFlagsRemove(input.uids, ["\\Seen"], { uid: true });
+                    break;
+                case "flag":
+                    ok = await client.messageFlagsAdd(input.uids, ["\\Flagged"], { uid: true });
+                    break;
+                case "unflag":
+                    ok = await client.messageFlagsRemove(input.uids, ["\\Flagged"], { uid: true });
+                    break;
+                case "move": {
+                    const r = await client.messageMove(input.uids, input.targetMailbox, {
+                        uid: true,
+                    });
+                    ok = r !== false;
+                    break;
+                }
+                case "delete":
+                    ok = await client.messageDelete(input.uids, { uid: true });
+                    break;
+            }
+            // imapflow STORE/MOVE/DELETE is all-or-nothing per call; we cannot
+            // partition success across UIDs without a per-UID retry. If the
+            // server rejected the whole batch, surface every UID as failed.
+            return Ok({
+                action: input.action,
+                succeeded: ok ? input.uids.length : 0,
+                failedUids: ok ? [] : [...input.uids],
+            });
+        });
+    }
+    catch (cause) {
+        return Err(imapError(input.account, `bulk_action(${input.action}) failed`, cause));
+    }
+};
+//# sourceMappingURL=bulkAction.js.map

package/dist/tools/bulkAction.js.map

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

package/dist/tools/findMailboxFolder.d.ts

@@ -0,0 +1,33 @@
+/**
+ * MCP tool: find_mailbox_folder -- given a Message-Id, list all real
+ * folders that contain a copy of that message. Required pre-step for
+ * `move_email` when the message was discovered via a virtual folder
+ * (e.g. Gmail "[Gmail]/All Mail").
+ *
+ * Strategy: list folders, skip virtuals, run UID SEARCH HEADER
+ * Message-Id on each, collect the hits.
+ */
+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 findMailboxFolderInput: z.ZodObject<{
+    account: z.ZodString;
+    messageId: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    account: string;
+    messageId: string;
+}, {
+    account: string;
+    messageId: string;
+}>;
+export type FindMailboxFolderInput = z.infer<typeof findMailboxFolderInput>;
+export type FindMailboxFolderResult = {
+    readonly account: string;
+    readonly messageId: string;
+    readonly folders: ReadonlyArray<{
+        readonly path: string;
+        readonly uids: readonly number[];
+    }>;
+};
+export declare const findMailboxFolder: (pool: ImapPool, input: FindMailboxFolderInput) => Promise<Result<AppError, FindMailboxFolderResult>>;

package/dist/tools/findMailboxFolder.js

@@ -0,0 +1,45 @@
+/**
+ * MCP tool: find_mailbox_folder -- given a Message-Id, list all real
+ * folders that contain a copy of that message. Required pre-step for
+ * `move_email` when the message was discovered via a virtual folder
+ * (e.g. Gmail "[Gmail]/All Mail").
+ *
+ * Strategy: list folders, skip virtuals, run UID SEARCH HEADER
+ * Message-Id on each, collect the hits.
+ */
+import { z } from "zod";
+import { imapError, notFound } from "../domain/errors.js";
+import { Err, Ok } from "../domain/result.js";
+import { withMailboxLock } from "../imap/fetch.js";
+import { isVirtualFolderPath, isVirtualSpecialUse } from "../imap/virtualFolders.js";
+export const findMailboxFolderInput = z
+    .object({
+    account: z.string().min(1),
+    messageId: z.string().min(1),
+})
+    .strict();
+export const findMailboxFolder = async (pool, input) => {
+    if (!pool.accountIds.includes(input.account))
+        return Err(notFound(`account '${input.account}'`));
+    const clientR = await pool.forAccount(input.account);
+    if (clientR.tag === "Err")
+        return clientR;
+    const client = clientR.value;
+    try {
+        const folders = await client.list();
+        const hits = [];
+        for (const f of folders) {
+            const specialUse = (f.specialUse ?? null);
+            if (isVirtualFolderPath(f.path) || isVirtualSpecialUse(specialUse))
+                continue;
+            const uids = await withMailboxLock(client, f.path, () => client.search({ header: { "message-id": input.messageId } }, { uid: true }));
+            if (Array.isArray(uids) && uids.length > 0)
+                hits.push({ path: f.path, uids });
+        }
+        return Ok({ account: input.account, messageId: input.messageId, folders: hits });
+    }
+    catch (cause) {
+        return Err(imapError(input.account, "find_mailbox_folder failed", cause));
+    }
+};
+//# sourceMappingURL=findMailboxFolder.js.map

package/dist/tools/findMailboxFolder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"findMailboxFolder.js","sourceRoot":"","sources":["../../src/tools/findMailboxFolder.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAiB,SAAS,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AACzE,OAAO,EAAE,GAAG,EAAE,EAAE,EAAe,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAEnD,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAErF,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC;KACpC,MAAM,CAAC;IACN,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CAC7B,CAAC;KACD,MAAM,EAAE,CAAC;AASZ,MAAM,CAAC,MAAM,iBAAiB,GAAG,KAAK,EACpC,IAAc,EACd,KAA6B,EACuB,EAAE;IACtD,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC;QAAE,OAAO,GAAG,CAAC,QAAQ,CAAC,YAAY,KAAK,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC;IACjG,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACrD,IAAI,OAAO,CAAC,GAAG,KAAK,KAAK;QAAE,OAAO,OAAO,CAAC;IAC1C,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;IAC7B,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;QACpC,MAAM,IAAI,GAAuC,EAAE,CAAC;QACpD,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;YACxB,MAAM,UAAU,GAAG,CAAC,CAAC,CAAC,UAAU,IAAI,IAAI,CAAkB,CAAC;YAC3D,IAAI,mBAAmB,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,mBAAmB,CAAC,UAAU,CAAC;gBAAE,SAAS;YAC7E,MAAM,IAAI,GAAG,MAAM,eAAe,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,EAAE,GAAG,EAAE,CACtD,MAAM,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,EAAE,YAAY,EAAE,KAAK,CAAC,SAAS,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAC5E,CAAC;YACF,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC;gBAAE,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QAChF,CAAC;QACD,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;IACnF,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,GAAG,CAAC,SAAS,CAAC,KAAK,CAAC,OAAO,EAAE,4BAA4B,EAAE,KAAK,CAAC,CAAC,CAAC;IAC5E,CAAC;AACH,CAAC,CAAC"}

package/dist/tools/getEmail.d.ts

@@ -0,0 +1,41 @@
+/**
+ * MCP tool: get_email -- fetch one email by UID with BODY.PEEK.
+ *
+ * Live-IMAP. Defaults `markRead=false` so the IMAP `\Seen` flag is not
+ * touched. Format: "raw" returns the structured payload; "text" strips
+ * HTML; "stripped" additionally drops quoted replies and signatures.
+ */
+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";
+import type { StoredEmailPayload } from "../store/payloadTypes.js";
+export declare const getEmailInput: z.ZodObject<{
+    account: z.ZodString;
+    mailbox: z.ZodString;
+    uid: z.ZodNumber;
+    format: z.ZodDefault<z.ZodEnum<["raw", "text", "stripped"]>>;
+    maxLength: z.ZodOptional<z.ZodNumber>;
+    markRead: z.ZodDefault<z.ZodBoolean>;
+}, "strict", z.ZodTypeAny, {
+    uid: number;
+    mailbox: string;
+    account: string;
+    format: "text" | "raw" | "stripped";
+    markRead: boolean;
+    maxLength?: number | undefined;
+}, {
+    uid: number;
+    mailbox: string;
+    account: string;
+    format?: "text" | "raw" | "stripped" | undefined;
+    maxLength?: number | undefined;
+    markRead?: boolean | undefined;
+}>;
+export type GetEmailInput = z.infer<typeof getEmailInput>;
+export type GetEmailResult = {
+    readonly email: StoredEmailPayload;
+    readonly bodyForDisplay: string | null;
+    readonly markedRead: boolean;
+};
+export declare const getEmail: (pool: ImapPool, input: GetEmailInput) => Promise<Result<AppError, GetEmailResult>>;

package/dist/tools/getEmail.js

@@ -0,0 +1,74 @@
+/**
+ * MCP tool: get_email -- fetch one email by UID with BODY.PEEK.
+ *
+ * Live-IMAP. Defaults `markRead=false` so the IMAP `\Seen` flag is not
+ * touched. Format: "raw" returns the structured payload; "text" strips
+ * HTML; "stripped" additionally drops quoted replies and signatures.
+ */
+import { z } from "zod";
+import { imapError, notFound } from "../domain/errors.js";
+import { Err, Ok } from "../domain/result.js";
+import { fetchOneByUid, withMailboxLock } from "../imap/fetch.js";
+import { htmlToText, stripQuotedAndSignature, toStoredPayload } from "../imap/mapper.js";
+export const getEmailInput = z
+    .object({
+    account: z.string().min(1),
+    mailbox: z.string().min(1),
+    uid: z.number().int().positive(),
+    format: z.enum(["raw", "text", "stripped"]).default("raw"),
+    maxLength: z.number().int().positive().optional(),
+    markRead: z.boolean().default(false),
+})
+    .strict();
+const buildDisplayBody = (payload, format, maxLength) => {
+    let text = payload.bodyText;
+    if (text === null && payload.bodyHtml !== null)
+        text = htmlToText(payload.bodyHtml);
+    if (text === null)
+        return null;
+    if (format === "stripped")
+        text = stripQuotedAndSignature(text);
+    if (maxLength !== undefined && text.length > maxLength)
+        text = text.slice(0, maxLength);
+    return text;
+};
+export const getEmail = async (pool, input) => {
+    if (!pool.accountIds.includes(input.account))
+        return Err(notFound(`account '${input.account}'`));
+    const clientR = await pool.forAccount(input.account);
+    if (clientR.tag === "Err")
+        return clientR;
+    const client = clientR.value;
+    try {
+        return await withMailboxLock(client, input.mailbox, async () => {
+            // Capture UIDVALIDITY so the produced payload has a stable externalId.
+            const status = await client.status(input.mailbox, { uidValidity: true });
+            const bundle = await fetchOneByUid(client, input.uid);
+            if (bundle === null) {
+                return Err(notFound(`message UID ${input.uid} in ${input.mailbox}`));
+            }
+            const payload = toStoredPayload(bundle.imapMessage, {
+                accountId: input.account,
+                mailbox: input.mailbox,
+                uidValidity: Number(status.uidValidity ?? 0),
+                fetchedAt: new Date(),
+                bodyText: bundle.bodyText,
+                bodyHtml: bundle.bodyHtml,
+                truncated: false,
+            });
+            const display = input.format === "raw"
+                ? (payload.bodyText ?? (payload.bodyHtml !== null ? htmlToText(payload.bodyHtml) : null))
+                : buildDisplayBody(payload, input.format, input.maxLength);
+            let markedRead = false;
+            if (input.markRead === true) {
+                const ok = await client.messageFlagsAdd([input.uid], ["\\Seen"], { uid: true });
+                markedRead = ok === true;
+            }
+            return Ok({ email: payload, bodyForDisplay: display, markedRead });
+        });
+    }
+    catch (cause) {
+        return Err(imapError(input.account, "get_email failed", cause));
+    }
+};
+//# sourceMappingURL=getEmail.js.map

package/dist/tools/getEmail.js.map

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

package/dist/tools/getEmails.d.ts

@@ -0,0 +1,38 @@
+/**
+ * MCP tool: get_emails -- bulk variant of get_email (max 20). One IMAP
+ * lock + one FETCH for the UID set. BODY.PEEK; never sets `\Seen`.
+ */
+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";
+import type { StoredEmailPayload } from "../store/payloadTypes.js";
+export declare const getEmailsInput: z.ZodObject<{
+    account: z.ZodString;
+    mailbox: z.ZodString;
+    uids: z.ZodArray<z.ZodNumber, "many">;
+    format: z.ZodDefault<z.ZodEnum<["raw", "text", "stripped"]>>;
+    maxLength: z.ZodOptional<z.ZodNumber>;
+}, "strict", z.ZodTypeAny, {
+    mailbox: string;
+    account: string;
+    uids: number[];
+    format: "text" | "raw" | "stripped";
+    maxLength?: number | undefined;
+}, {
+    mailbox: string;
+    account: string;
+    uids: number[];
+    format?: "text" | "raw" | "stripped" | undefined;
+    maxLength?: number | undefined;
+}>;
+export type GetEmailsInput = z.infer<typeof getEmailsInput>;
+export type GetEmailsItem = {
+    readonly email: StoredEmailPayload;
+    readonly bodyForDisplay: string | null;
+};
+export type GetEmailsResult = {
+    readonly items: readonly GetEmailsItem[];
+    readonly missing: readonly number[];
+};
+export declare const getEmails: (pool: ImapPool, input: GetEmailsInput) => Promise<Result<AppError, GetEmailsResult>>;

package/dist/tools/getEmails.js

@@ -0,0 +1,72 @@
+/**
+ * MCP tool: get_emails -- bulk variant of get_email (max 20). One IMAP
+ * lock + one FETCH for the UID set. BODY.PEEK; never sets `\Seen`.
+ */
+import { z } from "zod";
+import { imapError, notFound } from "../domain/errors.js";
+import { Err, Ok } from "../domain/result.js";
+import { fetchEnvelopesUidRange, withMailboxLock } from "../imap/fetch.js";
+import { htmlToText, stripQuotedAndSignature, toStoredPayload } from "../imap/mapper.js";
+export const getEmailsInput = z
+    .object({
+    account: z.string().min(1),
+    mailbox: z.string().min(1),
+    uids: z.array(z.number().int().positive()).min(1).max(20),
+    format: z.enum(["raw", "text", "stripped"]).default("text"),
+    maxLength: z.number().int().positive().optional(),
+})
+    .strict();
+const display = (p, fmt, cap) => {
+    let txt = p.bodyText;
+    if (txt === null && p.bodyHtml !== null)
+        txt = htmlToText(p.bodyHtml);
+    if (txt === null)
+        return null;
+    if (fmt === "stripped")
+        txt = stripQuotedAndSignature(txt);
+    if (cap !== undefined && txt.length > cap)
+        txt = txt.slice(0, cap);
+    return txt;
+};
+export const getEmails = async (pool, input) => {
+    if (!pool.accountIds.includes(input.account))
+        return Err(notFound(`account '${input.account}'`));
+    const clientR = await pool.forAccount(input.account);
+    if (clientR.tag === "Err")
+        return clientR;
+    const client = clientR.value;
+    try {
+        return await withMailboxLock(client, input.mailbox, async () => {
+            const status = await client.status(input.mailbox, { uidValidity: true });
+            const wanted = new Set(input.uids);
+            const items = [];
+            const seen = new Set();
+            const minUid = Math.min(...input.uids);
+            const maxUid = Math.max(...input.uids);
+            for await (const env of fetchEnvelopesUidRange(client, minUid, maxUid)) {
+                if (!wanted.has(env.uid))
+                    continue;
+                const payload = toStoredPayload(env, {
+                    accountId: input.account,
+                    mailbox: input.mailbox,
+                    uidValidity: Number(status.uidValidity ?? 0),
+                    fetchedAt: new Date(),
+                    bodyText: null,
+                    bodyHtml: null,
+                    truncated: false,
+                });
+                items.push({
+                    email: payload,
+                    bodyForDisplay: display(payload, input.format, input.maxLength),
+                });
+                seen.add(env.uid);
+            }
+            const missing = input.uids.filter((u) => !seen.has(u));
+            return Ok({ items, missing });
+        });
+    }
+    catch (cause) {
+        return Err(imapError(input.account, "get_emails failed", cause));
+    }
+};
+//# sourceMappingURL=getEmails.js.map

package/dist/tools/getEmails.js.map

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

package/dist/tools/getWatcherStatus.d.ts

@@ -0,0 +1,9 @@
+/**
+ * MCP tool: get_watcher_status -- in-memory status snapshot from the
+ * sync watcher. Read-only; no IMAP / Drive contact.
+ */
+import { z } from "zod";
+import type { Watcher, WatcherStatus } from "../sync/watcher.js";
+export declare const getWatcherStatusInput: z.ZodObject<{}, "strict", z.ZodTypeAny, {}, {}>;
+export type GetWatcherStatusInput = z.infer<typeof getWatcherStatusInput>;
+export declare const getWatcherStatus: (watcher: Watcher) => WatcherStatus;

package/dist/tools/getWatcherStatus.js

@@ -0,0 +1,8 @@
+/**
+ * MCP tool: get_watcher_status -- in-memory status snapshot from the
+ * sync watcher. Read-only; no IMAP / Drive contact.
+ */
+import { z } from "zod";
+export const getWatcherStatusInput = z.object({}).strict();
+export const getWatcherStatus = (watcher) => watcher.status();
+//# sourceMappingURL=getWatcherStatus.js.map

package/dist/tools/getWatcherStatus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getWatcherStatus.js","sourceRoot":"","sources":["../../src/tools/getWatcherStatus.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC;AAG3D,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,OAAgB,EAAiB,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC"}

package/dist/tools/listAccounts.d.ts

@@ -0,0 +1,19 @@
+/**
+ * MCP tool: list_accounts -- enumerate the configured email accounts.
+ *
+ * Read-only and config-driven; does not contact IMAP. Always call this
+ * first to discover available account names for use with other tools.
+ */
+import { z } from "zod";
+import type { Account } from "../config/schema.js";
+export declare const listAccountsInput: z.ZodObject<{}, "strict", z.ZodTypeAny, {}, {}>;
+export type ListAccountsInput = z.infer<typeof listAccountsInput>;
+export type ListAccountsResult = {
+    readonly accounts: ReadonlyArray<{
+        readonly name: string;
+        readonly email: string;
+        readonly authType: "password" | "oauth";
+        readonly fullName: string;
+    }>;
+};
+export declare const listAccounts: (accounts: readonly Account[]) => ListAccountsResult;

package/dist/tools/listAccounts.js

@@ -0,0 +1,18 @@
+/**
+ * MCP tool: list_accounts -- enumerate the configured email accounts.
+ *
+ * Read-only and config-driven; does not contact IMAP. Always call this
+ * first to discover available account names for use with other tools.
+ */
+import { z } from "zod";
+import { isOAuthAccount } from "../config/schema.js";
+export const listAccountsInput = z.object({}).strict();
+export const listAccounts = (accounts) => ({
+    accounts: accounts.map((a) => ({
+        name: a.name,
+        email: a.email,
+        authType: isOAuthAccount(a) ? "oauth" : "password",
+        fullName: a.full_name ?? a.email,
+    })),
+});
+//# sourceMappingURL=listAccounts.js.map

package/dist/tools/listAccounts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"listAccounts.js","sourceRoot":"","sources":["../../src/tools/listAccounts.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAErD,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC;AAYvD,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,QAA4B,EAAsB,EAAE,CAAC,CAAC;IACjF,QAAQ,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAC7B,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,KAAK,EAAE,CAAC,CAAC,KAAK;QACd,QAAQ,EAAE,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU;QAClD,QAAQ,EAAE,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC,KAAK;KACjC,CAAC,CAAC;CACJ,CAAC,CAAC"}

package/dist/tools/listEmails.d.ts

@@ -0,0 +1,70 @@
+/**
+ * MCP tool: list_emails -- paginated metadata listing of a mailbox.
+ *
+ * Live-IMAP. Combines IMAP UID SEARCH (with optional filters) and
+ * envelope-only FETCH for matched UIDs. Pagination is offset-based:
+ * the first call returns the highest-UID page, subsequent calls pass
+ * the previous page's `nextCursor` (a UID).
+ */
+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 listEmailsInput: z.ZodObject<{
+    account: z.ZodString;
+    mailbox: z.ZodString;
+    pageSize: z.ZodDefault<z.ZodNumber>;
+    cursor: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    unread: z.ZodOptional<z.ZodBoolean>;
+    flagged: z.ZodOptional<z.ZodBoolean>;
+    from: z.ZodOptional<z.ZodString>;
+    to: z.ZodOptional<z.ZodString>;
+    subject: z.ZodOptional<z.ZodString>;
+    since: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    mailbox: string;
+    account: string;
+    pageSize: number;
+    cursor?: number | null | undefined;
+    unread?: boolean | undefined;
+    flagged?: boolean | undefined;
+    from?: string | undefined;
+    to?: string | undefined;
+    subject?: string | undefined;
+    since?: string | undefined;
+}, {
+    mailbox: string;
+    account: string;
+    pageSize?: number | undefined;
+    cursor?: number | null | undefined;
+    unread?: boolean | undefined;
+    flagged?: boolean | undefined;
+    from?: string | undefined;
+    to?: string | undefined;
+    subject?: string | undefined;
+    since?: string | undefined;
+}>;
+export type ListEmailsInput = z.infer<typeof listEmailsInput>;
+export type ListedEmail = {
+    readonly uid: number;
+    readonly messageId: string | null;
+    readonly subject: string;
+    readonly from: {
+        readonly name: string | null;
+        readonly address: string;
+    } | null;
+    readonly to: ReadonlyArray<{
+        readonly name: string | null;
+        readonly address: string;
+    }>;
+    readonly date: string;
+    readonly flags: readonly string[];
+    readonly hasAttachments: boolean;
+};
+export type ListEmailsResult = {
+    readonly account: string;
+    readonly mailbox: string;
+    readonly items: readonly ListedEmail[];
+    readonly nextCursor: number | null;
+};
+export declare const listEmails: (pool: ImapPool, input: ListEmailsInput) => Promise<Result<AppError, ListEmailsResult>>;