@mcp-z/mcp-gmail 1.0.0

package/dist/esm/mcp/tools/messages-export-csv.d.ts

@@ -0,0 +1,84 @@
+import type { EnrichedExtra } from '@mcp-z/oauth-google';
+import { z } from 'zod';
+import type { StorageExtra } from '../../types.js';
+declare const inputSchema: z.ZodObject<{
+    query: z.ZodOptional<z.ZodType<import("../../types.js").GmailQuery, unknown, z.core.$ZodTypeInternals<import("../../types.js").GmailQuery, unknown>>>;
+    maxItems: z.ZodDefault<z.ZodNumber>;
+    filename: z.ZodDefault<z.ZodString>;
+    contentType: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
+        text: "text";
+        html: "html";
+    }>>>;
+    excludeThreadHistory: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, z.core.$strip>;
+declare const outputSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"success">;
+    uri: z.ZodString;
+    filename: z.ZodString;
+    rowCount: z.ZodNumber;
+    truncated: z.ZodBoolean;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"auth_required">;
+    provider: z.ZodString;
+    message: z.ZodString;
+    url: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>], "type">;
+export type Input = z.infer<typeof inputSchema>;
+export type Output = z.infer<typeof outputSchema>;
+/**
+ * Handler for gmail-messages-export-csv tool
+ *
+ * CRITICAL: Streaming implementation per user requirements
+ * - Generate UUID upfront
+ * - Write CSV header immediately
+ * - Append rows as batches arrive
+ * - Delete partial file on error
+ * - NO RETRIES (fail fast on error)
+ */
+declare function handler({ query, maxItems, filename, contentType, excludeThreadHistory }: Input, extra: EnrichedExtra & StorageExtra): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    structuredContent: {
+        result: {
+            type: "success";
+            uri: string;
+            filename: string;
+            rowCount: number;
+            truncated: boolean;
+        };
+    };
+}>;
+export default function createTool(): {
+    name: string;
+    config: {
+        readonly description: "Export Gmail messages to CSV with streaming pagination. Returns file URI. Use query-syntax prompt for query reference.";
+        readonly inputSchema: z.ZodObject<{
+            query: z.ZodOptional<z.ZodType<import("../../types.js").GmailQuery, unknown, z.core.$ZodTypeInternals<import("../../types.js").GmailQuery, unknown>>>;
+            maxItems: z.ZodDefault<z.ZodNumber>;
+            filename: z.ZodDefault<z.ZodString>;
+            contentType: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
+                text: "text";
+                html: "html";
+            }>>>;
+            excludeThreadHistory: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        }, z.core.$strip>;
+        readonly outputSchema: z.ZodObject<{
+            result: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                type: z.ZodLiteral<"success">;
+                uri: z.ZodString;
+                filename: z.ZodString;
+                rowCount: z.ZodNumber;
+                truncated: z.ZodBoolean;
+            }, z.core.$strip>, z.ZodObject<{
+                type: z.ZodLiteral<"auth_required">;
+                provider: z.ZodString;
+                message: z.ZodString;
+                url: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>], "type">;
+        }, z.core.$strip>;
+    };
+    handler: typeof handler;
+};
+export {};

package/dist/esm/mcp/tools/messages-export-csv.js

@@ -0,0 +1,261 @@
+import { EmailContentTypeSchema, ExcludeThreadHistorySchema } from '@mcp-z/email';
+import { schemas } from '@mcp-z/oauth-google';
+const { AuthRequiredBranchSchema } = schemas;
+import { getFileUri, reserveFile } from '@mcp-z/server';
+import { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';
+import { stringify } from 'csv-stringify/sync';
+import { createWriteStream } from 'fs';
+import { unlink } from 'fs/promises';
+import { google } from 'googleapis';
+import { z } from 'zod';
+import { DEFAULT_PAGE_SIZE } from '../../constants.js';
+import { extractBodyFromPayload } from '../../email/parsing/html-processing.js';
+import { executeQuery as executeGmailQuery } from '../../email/querying/execute-query.js';
+import { GmailQuerySchema } from '../../schemas/gmail-query-schema.js';
+const DEFAULT_MAX_ITEMS = 10000;
+const MAX_EXPORT_ITEMS = 50000;
+const inputSchema = z.object({
+    query: GmailQuerySchema.optional().describe('Structured query object for filtering messages. Use query-syntax prompt for reference.'),
+    maxItems: z.number().int().positive().max(MAX_EXPORT_ITEMS).default(DEFAULT_MAX_ITEMS).describe(`Maximum messages to export (default: ${DEFAULT_MAX_ITEMS}, max: ${MAX_EXPORT_ITEMS})`),
+    filename: z.string().trim().min(1).default('gmail-messages.csv').describe('Output filename (default: gmail-messages.csv)'),
+    contentType: EmailContentTypeSchema,
+    excludeThreadHistory: ExcludeThreadHistorySchema
+});
+const successBranchSchema = z.object({
+    type: z.literal('success'),
+    uri: z.string().describe('File URI (file:// or http://)'),
+    filename: z.string().describe('Stored filename'),
+    rowCount: z.number().describe('Number of messages exported'),
+    truncated: z.boolean().describe('Whether export was truncated at maxItems')
+});
+const outputSchema = z.discriminatedUnion('type', [
+    successBranchSchema,
+    AuthRequiredBranchSchema
+]);
+const config = {
+    description: 'Export Gmail messages to CSV with streaming pagination. Returns file URI. Use query-syntax prompt for query reference.',
+    inputSchema: inputSchema,
+    outputSchema: z.object({
+        result: outputSchema
+    })
+};
+/**
+ * Handler for gmail-messages-export-csv tool
+ *
+ * CRITICAL: Streaming implementation per user requirements
+ * - Generate UUID upfront
+ * - Write CSV header immediately
+ * - Append rows as batches arrive
+ * - Delete partial file on error
+ * - NO RETRIES (fail fast on error)
+ */ async function handler({ query, maxItems, filename, contentType, excludeThreadHistory }, extra) {
+    const logger = extra.logger;
+    const { storageContext } = extra;
+    const { transport, storageDir, baseUrl } = storageContext;
+    logger.info('gmail.messages.export-csv called', {
+        query,
+        maxItems,
+        filename,
+        accountId: extra.authContext.accountId
+    });
+    // Reserve file location for streaming write (creates directory, generates ID, formats filename)
+    const reservation = await reserveFile(filename, {
+        storageDir
+    });
+    const { storedName, fullPath } = reservation;
+    logger.info('gmail.messages.export-csv starting streaming export', {
+        path: fullPath,
+        maxItems
+    });
+    try {
+        const gmail = google.gmail({
+            version: 'v1',
+            auth: extra.authContext.auth
+        });
+        // Create CSV headers (all email fields)
+        const csvHeaders = [
+            'id',
+            'threadId',
+            'from',
+            'to',
+            'cc',
+            'bcc',
+            'subject',
+            'date',
+            'snippet',
+            'body',
+            'provider',
+            'labels'
+        ];
+        // Create write stream and write headers immediately
+        const writeStream = createWriteStream(fullPath, {
+            encoding: 'utf-8'
+        });
+        const headerLine = stringify([
+            csvHeaders
+        ], {
+            header: false,
+            quoted: true,
+            quote: '"',
+            escape: '"'
+        });
+        writeStream.write(headerLine);
+        // Internal pagination loop - append to CSV with each batch
+        // NO RETRIES: If any error occurs, fail the whole operation and clean up
+        let totalRows = 0;
+        let nextPageToken;
+        const started = Date.now();
+        while(totalRows < maxItems){
+            var _exec_metadata;
+            const remainingItems = maxItems - totalRows;
+            const pageSize = Math.min(remainingItems, DEFAULT_PAGE_SIZE);
+            const exec = await executeGmailQuery(query, {
+                client: gmail,
+                logger,
+                pageSize,
+                ...nextPageToken !== undefined && {
+                    pageToken: nextPageToken
+                },
+                includeBody: true
+            }, (full)=>{
+                var _ref;
+                var _fullData_payload;
+                // Type-safe property access with guards
+                const fullData = full;
+                const headersArray = Array.isArray(fullData === null || fullData === void 0 ? void 0 : (_fullData_payload = fullData.payload) === null || _fullData_payload === void 0 ? void 0 : _fullData_payload.headers) ? fullData.payload.headers : [];
+                const headers = Object.fromEntries(headersArray.map((h)=>{
+                    var _header_name, _header_value;
+                    const header = h;
+                    return [
+                        String((_header_name = header.name) !== null && _header_name !== void 0 ? _header_name : ''),
+                        String((_header_value = header.value) !== null && _header_value !== void 0 ? _header_value : '')
+                    ];
+                }));
+                const payload = fullData === null || fullData === void 0 ? void 0 : fullData.payload;
+                // Cast to Schema$MessagePart for extractBodyFromPayload
+                const body = payload ? extractBodyFromPayload(payload, {
+                    contentType,
+                    excludeThreadHistory
+                }) : '';
+                const labelIds = Array.isArray(fullData === null || fullData === void 0 ? void 0 : fullData.labelIds) ? fullData.labelIds.map((id)=>String(id !== null && id !== void 0 ? id : '')) : [];
+                return {
+                    id: String((_ref = fullData === null || fullData === void 0 ? void 0 : fullData.id) !== null && _ref !== void 0 ? _ref : ''),
+                    threadId: (fullData === null || fullData === void 0 ? void 0 : fullData.threadId) ? String(fullData.threadId) : '',
+                    from: (headers === null || headers === void 0 ? void 0 : headers.From) || '',
+                    to: (headers === null || headers === void 0 ? void 0 : headers.To) || '',
+                    cc: (headers === null || headers === void 0 ? void 0 : headers.Cc) || '',
+                    bcc: (headers === null || headers === void 0 ? void 0 : headers.Bcc) || '',
+                    subject: (headers === null || headers === void 0 ? void 0 : headers.Subject) || '',
+                    date: (headers === null || headers === void 0 ? void 0 : headers.Date) || '',
+                    snippet: (fullData === null || fullData === void 0 ? void 0 : fullData.snippet) ? String(fullData.snippet) : '',
+                    body,
+                    provider: 'gmail',
+                    labels: labelIds.join(';')
+                };
+            });
+            // Type-safe CSV row mapping
+            const csvRows = exec.items.map((row)=>{
+                return [
+                    row.id,
+                    row.threadId,
+                    row.from,
+                    row.to,
+                    row.cc,
+                    row.bcc,
+                    row.subject,
+                    row.date,
+                    row.snippet,
+                    row.body,
+                    row.provider,
+                    row.labels
+                ];
+            });
+            // Append rows to CSV file immediately
+            if (csvRows.length > 0) {
+                const rowsContent = stringify(csvRows, {
+                    header: false,
+                    quoted: true,
+                    quote: '"',
+                    escape: '"'
+                });
+                writeStream.write(rowsContent);
+            }
+            totalRows += exec.items.length;
+            nextPageToken = (_exec_metadata = exec.metadata) === null || _exec_metadata === void 0 ? void 0 : _exec_metadata.nextPageToken;
+            logger.info('gmail.messages.export-csv batch written', {
+                batchSize: exec.items.length,
+                totalRows,
+                hasMore: Boolean(nextPageToken)
+            });
+            // Exit if no more results or reached maxItems
+            if (!nextPageToken || exec.items.length === 0) {
+                break;
+            }
+        }
+        // Close write stream
+        await new Promise((resolve, reject)=>{
+            writeStream.end(()=>resolve());
+            writeStream.on('error', reject);
+        });
+        const durationMs = Date.now() - started;
+        const truncated = totalRows >= maxItems && Boolean(nextPageToken);
+        logger.info('gmail.messages.export-csv completed', {
+            rowCount: totalRows,
+            truncated,
+            durationMs,
+            filename: storedName
+        });
+        // Generate URI based on transport type (stdio: file://, HTTP: http://)
+        const uri = getFileUri(storedName, transport, {
+            storageDir,
+            ...baseUrl && {
+                baseUrl
+            },
+            endpoint: '/files'
+        });
+        const result = {
+            type: 'success',
+            uri,
+            filename: storedName,
+            rowCount: totalRows,
+            truncated
+        };
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify(result)
+                }
+            ],
+            structuredContent: {
+                result
+            }
+        };
+    } catch (error) {
+        // CRITICAL: Clean up partial CSV file on error
+        try {
+            await unlink(fullPath);
+            logger.debug('Cleaned up partial CSV file after error', {
+                path: fullPath
+            });
+        } catch (_cleanupError) {
+            logger.debug('Could not clean up CSV file (may not exist)', {
+                path: fullPath
+            });
+        }
+        const message = error instanceof Error ? error.message : String(error);
+        logger.error('gmail.messages.export-csv error', {
+            error: message
+        });
+        throw new McpError(ErrorCode.InternalError, `Error exporting messages to CSV: ${message}`, {
+            stack: error instanceof Error ? error.stack : undefined
+        });
+    }
+}
+export default function createTool() {
+    return {
+        name: 'messages-export-csv',
+        config,
+        handler
+    };
+}

package/dist/esm/mcp/tools/messages-export-csv.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/kevin/Dev/Projects/ai/mcp-z/servers/mcp-gmail/src/mcp/tools/messages-export-csv.ts"],"sourcesContent":["import { EmailContentTypeSchema, ExcludeThreadHistorySchema } from '@mcp-z/email';\nimport type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport { schemas } from '@mcp-z/oauth-google';\n\nconst { AuthRequiredBranchSchema } = schemas;\n\nimport { getFileUri, reserveFile, type ToolModule } from '@mcp-z/server';\nimport { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';\n\nimport { stringify } from 'csv-stringify/sync';\nimport { createWriteStream } from 'fs';\nimport { unlink } from 'fs/promises';\nimport { type gmail_v1, google } from 'googleapis';\nimport { z } from 'zod';\nimport { DEFAULT_PAGE_SIZE } from '../../constants.ts';\nimport { extractBodyFromPayload } from '../../email/parsing/html-processing.js';\nimport { executeQuery as executeGmailQuery } from '../../email/querying/execute-query.js';\nimport { GmailQuerySchema } from '../../schemas/gmail-query-schema.js';\nimport type { StorageExtra } from '../../types.js';\n\nconst DEFAULT_MAX_ITEMS = 10000;\nconst MAX_EXPORT_ITEMS = 50000;\n\n/**\n * CSV row format based on EmailDetail\n * All fields are strings (empty string instead of undefined)\n * Includes additional CSV-specific fields: provider and labels\n */\ninterface CsvRow {\n  id: string;\n  threadId: string;\n  from: string;\n  to: string;\n  cc: string;\n  bcc: string;\n  subject: string;\n  date: string;\n  snippet: string;\n  body: string;\n  provider: string;\n  labels: string;\n}\n\nconst inputSchema = z.object({\n  query: GmailQuerySchema.optional().describe('Structured query object for filtering messages. Use query-syntax prompt for reference.'),\n  maxItems: z.number().int().positive().max(MAX_EXPORT_ITEMS).default(DEFAULT_MAX_ITEMS).describe(`Maximum messages to export (default: ${DEFAULT_MAX_ITEMS}, max: ${MAX_EXPORT_ITEMS})`),\n  filename: z.string().trim().min(1).default('gmail-messages.csv').describe('Output filename (default: gmail-messages.csv)'),\n  contentType: EmailContentTypeSchema,\n  excludeThreadHistory: ExcludeThreadHistorySchema,\n});\n\nconst successBranchSchema = z.object({\n  type: z.literal('success'),\n  uri: z.string().describe('File URI (file:// or http://)'),\n  filename: z.string().describe('Stored filename'),\n  rowCount: z.number().describe('Number of messages exported'),\n  truncated: z.boolean().describe('Whether export was truncated at maxItems'),\n});\n\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n  description: 'Export Gmail messages to CSV with streaming pagination. Returns file URI. Use query-syntax prompt for query reference.',\n  inputSchema: inputSchema,\n  outputSchema: z.object({\n    result: outputSchema,\n  }),\n} as const;\n\nexport type Input = z.infer<typeof inputSchema>;\nexport type Output = z.infer<typeof outputSchema>;\n\n/**\n * Handler for gmail-messages-export-csv tool\n *\n * CRITICAL: Streaming implementation per user requirements\n * - Generate UUID upfront\n * - Write CSV header immediately\n * - Append rows as batches arrive\n * - Delete partial file on error\n * - NO RETRIES (fail fast on error)\n */\nasync function handler({ query, maxItems, filename, contentType, excludeThreadHistory }: Input, extra: EnrichedExtra & StorageExtra) {\n  const logger = extra.logger;\n  const { storageContext } = extra;\n  const { transport, storageDir, baseUrl } = storageContext;\n\n  logger.info('gmail.messages.export-csv called', {\n    query,\n    maxItems,\n    filename,\n    accountId: extra.authContext.accountId,\n  });\n\n  // Reserve file location for streaming write (creates directory, generates ID, formats filename)\n  const reservation = await reserveFile(filename, {\n    storageDir,\n  });\n  const { storedName, fullPath } = reservation;\n\n  logger.info('gmail.messages.export-csv starting streaming export', { path: fullPath, maxItems });\n\n  try {\n    const gmail = google.gmail({ version: 'v1', auth: extra.authContext.auth });\n\n    // Create CSV headers (all email fields)\n    const csvHeaders = ['id', 'threadId', 'from', 'to', 'cc', 'bcc', 'subject', 'date', 'snippet', 'body', 'provider', 'labels'];\n\n    // Create write stream and write headers immediately\n    const writeStream = createWriteStream(fullPath, { encoding: 'utf-8' });\n    const headerLine = stringify([csvHeaders], { header: false, quoted: true, quote: '\"', escape: '\"' });\n    writeStream.write(headerLine);\n\n    // Internal pagination loop - append to CSV with each batch\n    // NO RETRIES: If any error occurs, fail the whole operation and clean up\n    let totalRows = 0;\n    let nextPageToken: string | undefined;\n    const started = Date.now();\n\n    while (totalRows < maxItems) {\n      const remainingItems = maxItems - totalRows;\n      const pageSize = Math.min(remainingItems, DEFAULT_PAGE_SIZE);\n\n      const exec: {\n        items: CsvRow[];\n        metadata?: { nextPageToken?: string };\n      } = await executeGmailQuery(\n        query,\n        {\n          client: gmail,\n          logger,\n          pageSize,\n          ...(nextPageToken !== undefined && { pageToken: nextPageToken }),\n          includeBody: true, // Always include body for CSV export\n        },\n        (full: unknown): CsvRow => {\n          // Type-safe property access with guards\n          const fullData = full as {\n            id?: unknown;\n            threadId?: unknown;\n            snippet?: unknown;\n            labelIds?: unknown[];\n            payload?: { headers?: unknown[] };\n          };\n\n          const headersArray = Array.isArray(fullData?.payload?.headers) ? fullData.payload.headers : [];\n          const headers = Object.fromEntries(\n            headersArray.map((h: unknown) => {\n              const header = h as { name?: unknown; value?: unknown };\n              return [String(header.name ?? ''), String(header.value ?? '')];\n            })\n          );\n\n          const payload = fullData?.payload;\n          // Cast to Schema$MessagePart for extractBodyFromPayload\n          const body = payload ? extractBodyFromPayload(payload as gmail_v1.Schema$MessagePart, { contentType, excludeThreadHistory }) : '';\n\n          const labelIds = Array.isArray(fullData?.labelIds) ? fullData.labelIds.map((id) => String(id ?? '')) : [];\n\n          return {\n            id: String(fullData?.id ?? ''),\n            threadId: fullData?.threadId ? String(fullData.threadId) : '',\n            from: headers?.From || '',\n            to: headers?.To || '',\n            cc: headers?.Cc || '',\n            bcc: headers?.Bcc || '',\n            subject: headers?.Subject || '',\n            date: headers?.Date || '',\n            snippet: fullData?.snippet ? String(fullData.snippet) : '',\n            body,\n            provider: 'gmail',\n            labels: labelIds.join(';'),\n          };\n        }\n      );\n\n      // Type-safe CSV row mapping\n      const csvRows = exec.items.map((row) => {\n        return [row.id, row.threadId, row.from, row.to, row.cc, row.bcc, row.subject, row.date, row.snippet, row.body, row.provider, row.labels];\n      });\n\n      // Append rows to CSV file immediately\n      if (csvRows.length > 0) {\n        const rowsContent = stringify(csvRows, { header: false, quoted: true, quote: '\"', escape: '\"' });\n        writeStream.write(rowsContent);\n      }\n\n      totalRows += exec.items.length;\n      nextPageToken = exec.metadata?.nextPageToken;\n\n      logger.info('gmail.messages.export-csv batch written', {\n        batchSize: exec.items.length,\n        totalRows,\n        hasMore: Boolean(nextPageToken),\n      });\n\n      // Exit if no more results or reached maxItems\n      if (!nextPageToken || exec.items.length === 0) {\n        break;\n      }\n    }\n\n    // Close write stream\n    await new Promise<void>((resolve, reject) => {\n      writeStream.end(() => resolve());\n      writeStream.on('error', reject);\n    });\n\n    const durationMs = Date.now() - started;\n    const truncated = totalRows >= maxItems && Boolean(nextPageToken);\n\n    logger.info('gmail.messages.export-csv completed', {\n      rowCount: totalRows,\n      truncated,\n      durationMs,\n      filename: storedName,\n    });\n\n    // Generate URI based on transport type (stdio: file://, HTTP: http://)\n    const uri = getFileUri(storedName, transport, {\n      storageDir,\n      ...(baseUrl && { baseUrl }),\n      endpoint: '/files',\n    });\n\n    const result: Output = {\n      type: 'success' as const,\n      uri,\n      filename: storedName,\n      rowCount: totalRows,\n      truncated,\n    };\n\n    return {\n      content: [\n        {\n          type: 'text' as const,\n          text: JSON.stringify(result),\n        },\n      ],\n      structuredContent: { result },\n    };\n  } catch (error) {\n    // CRITICAL: Clean up partial CSV file on error\n    try {\n      await unlink(fullPath);\n      logger.debug('Cleaned up partial CSV file after error', { path: fullPath });\n    } catch (_cleanupError) {\n      logger.debug('Could not clean up CSV file (may not exist)', { path: fullPath });\n    }\n\n    const message = error instanceof Error ? error.message : String(error);\n    logger.error('gmail.messages.export-csv error', { error: message });\n\n    throw new McpError(ErrorCode.InternalError, `Error exporting messages to CSV: ${message}`, {\n      stack: error instanceof Error ? error.stack : undefined,\n    });\n  }\n}\n\nexport default function createTool() {\n  return {\n    name: 'messages-export-csv',\n    config,\n    handler,\n  } satisfies ToolModule;\n}\n"],"names":["EmailContentTypeSchema","ExcludeThreadHistorySchema","schemas","AuthRequiredBranchSchema","getFileUri","reserveFile","ErrorCode","McpError","stringify","createWriteStream","unlink","google","z","DEFAULT_PAGE_SIZE","extractBodyFromPayload","executeQuery","executeGmailQuery","GmailQuerySchema","DEFAULT_MAX_ITEMS","MAX_EXPORT_ITEMS","inputSchema","object","query","optional","describe","maxItems","number","int","positive","max","default","filename","string","trim","min","contentType","excludeThreadHistory","successBranchSchema","type","literal","uri","rowCount","truncated","boolean","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","storageContext","transport","storageDir","baseUrl","info","accountId","authContext","reservation","storedName","fullPath","path","gmail","version","auth","csvHeaders","writeStream","encoding","headerLine","header","quoted","quote","escape","write","totalRows","nextPageToken","started","Date","now","exec","remainingItems","pageSize","Math","client","undefined","pageToken","includeBody","full","fullData","headersArray","Array","isArray","payload","headers","Object","fromEntries","map","h","String","name","value","body","labelIds","id","threadId","from","From","to","To","cc","Cc","bcc","Bcc","subject","Subject","date","snippet","provider","labels","join","csvRows","items","row","length","rowsContent","metadata","batchSize","hasMore","Boolean","Promise","resolve","reject","end","on","durationMs","endpoint","content","text","JSON","structuredContent","error","debug","_cleanupError","message","Error","InternalError","stack","createTool"],"mappings":"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"}

package/dist/esm/package.json

@@ -0,0 +1 @@
+{ "type": "module" }

package/dist/esm/schemas/gmail-query-schema.d.ts

@@ -0,0 +1,36 @@
+import { type BaseEmailQueryFields, type FieldOperator } from '@mcp-z/email';
+import { z } from 'zod';
+/**
+ * Gmail-specific query schema with recursive operators and Gmail features.
+ *
+ * Includes Gmail-specific features:
+ * - fuzzyPhrase: Approximate phrase matching (Gmail's quoted string behavior with relevance ranking)
+ * - categories: Gmail system categories (primary, social, promotions, updates, forums)
+ * - label: User-created Gmail labels (case-sensitive, discovered via gmail-labels-list)
+ * - rawGmailQuery: Escape hatch for advanced Gmail query syntax
+ *
+ * Plus all base fields from baseEmailQueryFields:
+ * - Email addresses: from, to, cc, bcc (support string or field operators)
+ * - Content: subject, body, text
+ * - Flags: hasAttachment, isRead
+ * - Date range: date { $gte, $lt }
+ * - Logical operators: $and, $or, $not (recursive)
+ *
+ * Note: Cast through unknown to work around Zod's lazy schema type inference issue
+ * with exactOptionalPropertyTypes. The runtime schema is correct; this cast ensures
+ * TypeScript sees the strict GmailQuery type everywhere the schema is used.
+ */
+export declare const GmailQuerySchema: z.ZodType<GmailQuery>;
+export type GmailQuery = BaseEmailQueryFields & {
+    $and?: GmailQuery[];
+    $or?: GmailQuery[];
+    $not?: GmailQuery;
+    fuzzyPhrase?: string;
+    categories?: 'primary' | 'social' | 'promotions' | 'updates' | 'forums' | {
+        $any?: ('primary' | 'social' | 'promotions' | 'updates' | 'forums')[];
+        $all?: ('primary' | 'social' | 'promotions' | 'updates' | 'forums')[];
+        $none?: ('primary' | 'social' | 'promotions' | 'updates' | 'forums')[];
+    };
+    label?: string | FieldOperator;
+    rawGmailQuery?: string;
+};

package/dist/esm/schemas/gmail-query-schema.js

@@ -0,0 +1,72 @@
+import { baseEmailQueryFields, FieldOperatorSchema } from '@mcp-z/email';
+import { z } from 'zod';
+/**
+ * Gmail-specific query schema with recursive operators and Gmail features.
+ *
+ * Includes Gmail-specific features:
+ * - fuzzyPhrase: Approximate phrase matching (Gmail's quoted string behavior with relevance ranking)
+ * - categories: Gmail system categories (primary, social, promotions, updates, forums)
+ * - label: User-created Gmail labels (case-sensitive, discovered via gmail-labels-list)
+ * - rawGmailQuery: Escape hatch for advanced Gmail query syntax
+ *
+ * Plus all base fields from baseEmailQueryFields:
+ * - Email addresses: from, to, cc, bcc (support string or field operators)
+ * - Content: subject, body, text
+ * - Flags: hasAttachment, isRead
+ * - Date range: date { $gte, $lt }
+ * - Logical operators: $and, $or, $not (recursive)
+ *
+ * Note: Cast through unknown to work around Zod's lazy schema type inference issue
+ * with exactOptionalPropertyTypes. The runtime schema is correct; this cast ensures
+ * TypeScript sees the strict GmailQuery type everywhere the schema is used.
+ */ export const GmailQuerySchema = z.lazy(()=>z.object({
+        // Logical operators for combining conditions (recursive)
+        $and: z.array(GmailQuerySchema).optional().describe('Array of conditions that must ALL match'),
+        $or: z.array(GmailQuerySchema).optional().describe('Array of conditions where ANY must match'),
+        $not: GmailQuerySchema.optional().describe('Nested condition that must NOT match'),
+        // Spread base email query fields (from, to, subject, body, etc.)
+        ...baseEmailQueryFields,
+        // Gmail-specific features
+        // Fuzzy phrase matching - Gmail's approximate search using quoted strings
+        fuzzyPhrase: z.string().min(1).optional().describe('Fuzzy phrase matching - words should appear together (approximate matching). Gmail uses relevance-based matching.'),
+        // Gmail system categories with field operator support
+        categories: z.union([
+            z.enum([
+                'primary',
+                'social',
+                'promotions',
+                'updates',
+                'forums'
+            ]),
+            z.object({
+                $any: z.array(z.enum([
+                    'primary',
+                    'social',
+                    'promotions',
+                    'updates',
+                    'forums'
+                ])).optional(),
+                $all: z.array(z.enum([
+                    'primary',
+                    'social',
+                    'promotions',
+                    'updates',
+                    'forums'
+                ])).optional(),
+                $none: z.array(z.enum([
+                    'primary',
+                    'social',
+                    'promotions',
+                    'updates',
+                    'forums'
+                ])).optional()
+            }).strict()
+        ]).optional().describe('Filter by Gmail system categories (primary, social, promotions, updates, forums)'),
+        // User-created labels
+        label: z.union([
+            z.string().min(1),
+            FieldOperatorSchema
+        ]).optional().describe('Filter by user-created labels (case-sensitive). Use gmail-labels-list to see available labels'),
+        // Raw Gmail query string - escape hatch for advanced syntax
+        rawGmailQuery: z.string().min(1).optional().describe('Raw Gmail query syntax for advanced use cases. Bypasses schema validation - use sparingly.')
+    }).strict());

package/dist/esm/schemas/gmail-query-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/kevin/Dev/Projects/ai/mcp-z/servers/mcp-gmail/src/schemas/gmail-query-schema.ts"],"sourcesContent":["import { type BaseEmailQueryFields, baseEmailQueryFields, type FieldOperator, FieldOperatorSchema } from '@mcp-z/email';\nimport { z } from 'zod';\n\n/**\n * Gmail-specific query schema with recursive operators and Gmail features.\n *\n * Includes Gmail-specific features:\n * - fuzzyPhrase: Approximate phrase matching (Gmail's quoted string behavior with relevance ranking)\n * - categories: Gmail system categories (primary, social, promotions, updates, forums)\n * - label: User-created Gmail labels (case-sensitive, discovered via gmail-labels-list)\n * - rawGmailQuery: Escape hatch for advanced Gmail query syntax\n *\n * Plus all base fields from baseEmailQueryFields:\n * - Email addresses: from, to, cc, bcc (support string or field operators)\n * - Content: subject, body, text\n * - Flags: hasAttachment, isRead\n * - Date range: date { $gte, $lt }\n * - Logical operators: $and, $or, $not (recursive)\n *\n * Note: Cast through unknown to work around Zod's lazy schema type inference issue\n * with exactOptionalPropertyTypes. The runtime schema is correct; this cast ensures\n * TypeScript sees the strict GmailQuery type everywhere the schema is used.\n */\nexport const GmailQuerySchema = z.lazy(() =>\n  z\n    .object({\n      // Logical operators for combining conditions (recursive)\n      $and: z.array(GmailQuerySchema).optional().describe('Array of conditions that must ALL match'),\n      $or: z.array(GmailQuerySchema).optional().describe('Array of conditions where ANY must match'),\n      $not: GmailQuerySchema.optional().describe('Nested condition that must NOT match'),\n\n      // Spread base email query fields (from, to, subject, body, etc.)\n      ...baseEmailQueryFields,\n\n      // Gmail-specific features\n\n      // Fuzzy phrase matching - Gmail's approximate search using quoted strings\n      fuzzyPhrase: z.string().min(1).optional().describe('Fuzzy phrase matching - words should appear together (approximate matching). Gmail uses relevance-based matching.'),\n\n      // Gmail system categories with field operator support\n      categories: z\n        .union([\n          z.enum(['primary', 'social', 'promotions', 'updates', 'forums']),\n          z\n            .object({\n              $any: z.array(z.enum(['primary', 'social', 'promotions', 'updates', 'forums'])).optional(),\n              $all: z.array(z.enum(['primary', 'social', 'promotions', 'updates', 'forums'])).optional(),\n              $none: z.array(z.enum(['primary', 'social', 'promotions', 'updates', 'forums'])).optional(),\n            })\n            .strict(),\n        ])\n        .optional()\n        .describe('Filter by Gmail system categories (primary, social, promotions, updates, forums)'),\n\n      // User-created labels\n      label: z\n        .union([z.string().min(1), FieldOperatorSchema])\n        .optional()\n        .describe('Filter by user-created labels (case-sensitive). Use gmail-labels-list to see available labels'),\n\n      // Raw Gmail query string - escape hatch for advanced syntax\n      rawGmailQuery: z.string().min(1).optional().describe('Raw Gmail query syntax for advanced use cases. Bypasses schema validation - use sparingly.'),\n    })\n    .strict()\n) as unknown as z.ZodType<GmailQuery>;\n\nexport type GmailQuery = BaseEmailQueryFields & {\n  $and?: GmailQuery[];\n  $or?: GmailQuery[];\n  $not?: GmailQuery;\n  fuzzyPhrase?: string;\n  categories?:\n    | 'primary'\n    | 'social'\n    | 'promotions'\n    | 'updates'\n    | 'forums'\n    | {\n        $any?: ('primary' | 'social' | 'promotions' | 'updates' | 'forums')[];\n        $all?: ('primary' | 'social' | 'promotions' | 'updates' | 'forums')[];\n        $none?: ('primary' | 'social' | 'promotions' | 'updates' | 'forums')[];\n      };\n  label?: string | FieldOperator;\n  rawGmailQuery?: string;\n};\n"],"names":["baseEmailQueryFields","FieldOperatorSchema","z","GmailQuerySchema","lazy","object","$and","array","optional","describe","$or","$not","fuzzyPhrase","string","min","categories","union","enum","$any","$all","$none","strict","label","rawGmailQuery"],"mappings":"AAAA,SAAoCA,oBAAoB,EAAsBC,mBAAmB,QAAQ,eAAe;AACxH,SAASC,CAAC,QAAQ,MAAM;AAExB;;;;;;;;;;;;;;;;;;;CAmBC,GACD,OAAO,MAAMC,mBAAmBD,EAAEE,IAAI,CAAC,IACrCF,EACGG,MAAM,CAAC;QACN,yDAAyD;QACzDC,MAAMJ,EAAEK,KAAK,CAACJ,kBAAkBK,QAAQ,GAAGC,QAAQ,CAAC;QACpDC,KAAKR,EAAEK,KAAK,CAACJ,kBAAkBK,QAAQ,GAAGC,QAAQ,CAAC;QACnDE,MAAMR,iBAAiBK,QAAQ,GAAGC,QAAQ,CAAC;QAE3C,iEAAiE;QACjE,GAAGT,oBAAoB;QAEvB,0BAA0B;QAE1B,0EAA0E;QAC1EY,aAAaV,EAAEW,MAAM,GAAGC,GAAG,CAAC,GAAGN,QAAQ,GAAGC,QAAQ,CAAC;QAEnD,sDAAsD;QACtDM,YAAYb,EACTc,KAAK,CAAC;YACLd,EAAEe,IAAI,CAAC;gBAAC;gBAAW;gBAAU;gBAAc;gBAAW;aAAS;YAC/Df,EACGG,MAAM,CAAC;gBACNa,MAAMhB,EAAEK,KAAK,CAACL,EAAEe,IAAI,CAAC;oBAAC;oBAAW;oBAAU;oBAAc;oBAAW;iBAAS,GAAGT,QAAQ;gBACxFW,MAAMjB,EAAEK,KAAK,CAACL,EAAEe,IAAI,CAAC;oBAAC;oBAAW;oBAAU;oBAAc;oBAAW;iBAAS,GAAGT,QAAQ;gBACxFY,OAAOlB,EAAEK,KAAK,CAACL,EAAEe,IAAI,CAAC;oBAAC;oBAAW;oBAAU;oBAAc;oBAAW;iBAAS,GAAGT,QAAQ;YAC3F,GACCa,MAAM;SACV,EACAb,QAAQ,GACRC,QAAQ,CAAC;QAEZ,sBAAsB;QACtBa,OAAOpB,EACJc,KAAK,CAAC;YAACd,EAAEW,MAAM,GAAGC,GAAG,CAAC;YAAIb;SAAoB,EAC9CO,QAAQ,GACRC,QAAQ,CAAC;QAEZ,4DAA4D;QAC5Dc,eAAerB,EAAEW,MAAM,GAAGC,GAAG,CAAC,GAAGN,QAAQ,GAAGC,QAAQ,CAAC;IACvD,GACCY,MAAM,IAC2B"}

package/dist/esm/schemas/index.d.ts

@@ -0,0 +1 @@
+export * from './gmail-query-schema.js';

package/dist/esm/schemas/index.js

@@ -0,0 +1 @@
+export * from './gmail-query-schema.js';

package/dist/esm/schemas/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/kevin/Dev/Projects/ai/mcp-z/servers/mcp-gmail/src/schemas/index.ts"],"sourcesContent":["export * from './gmail-query-schema.js';\n"],"names":[],"mappings":"AAAA,cAAc,0BAA0B"}

package/dist/esm/setup/config.d.ts

@@ -0,0 +1,48 @@
+import type { ServerConfig } from '../types.js';
+/**
+ * Handle --version and --help flags before config parsing.
+ * These should work without requiring any configuration.
+ */
+export declare function handleVersionHelp(args: string[]): {
+    handled: boolean;
+    output?: string;
+};
+/**
+ * Parse Gmail server configuration from CLI arguments and environment.
+ *
+ * CLI Arguments (all optional):
+ * - --auth=<mode>          Authentication mode (default: loopback-oauth)
+ *                          Modes: loopback-oauth, service-account, dcr
+ * - --headless             Disable browser auto-open, return auth URL instead
+ * - --redirect-uri=<uri>   OAuth redirect URI (default: ephemeral loopback)
+ * - --dcr-mode=<mode>      DCR mode (self-hosted or external, default: self-hosted)
+ * - --dcr-verify-url=<url> External verification endpoint (required for external mode)
+ * - --dcr-store-uri=<uri>  DCR client storage URI (required for self-hosted mode)
+ * - --port=<port>          Enable HTTP transport on specified port
+ * - --stdio                Enable stdio transport (default if no port)
+ * - --log-level=<level>    Logging level (default: info)
+ * - --storage-dir=<path>   Directory for CSV file storage (default: .mcp-z/files)
+ * - --base-url=<url>       Base URL for HTTP file serving (optional)
+ *
+ * Environment Variables:
+ * - GOOGLE_CLIENT_ID       OAuth client ID (REQUIRED)
+ * - GOOGLE_CLIENT_SECRET   OAuth client secret (optional)
+ * - AUTH_MODE              Default authentication mode (optional)
+ * - HEADLESS               Disable browser auto-open (optional)
+ * - DCR_MODE               DCR mode (optional, same format as --dcr-mode)
+ * - DCR_VERIFY_URL         External verification URL (optional, same as --dcr-verify-url)
+ * - DCR_STORE_URI          DCR storage URI (optional, same as --dcr-store-uri)
+ * - PORT                   Default HTTP port (optional)
+ * - LOG_LEVEL              Default logging level (optional)
+ * - STORAGE_DIR            Default storage directory (optional)
+ * - BASE_URL               Default base URL for file serving (optional)
+ *
+ * OAuth Scopes (from constants.ts):
+ * openid https://www.googleapis.com/auth/userinfo.profile https://www.googleapis.com/auth/userinfo.email https://mail.google.com/
+ */
+export declare function parseConfig(args: string[], env: Record<string, string | undefined>): ServerConfig;
+/**
+ * Build production configuration from process globals.
+ * Entry point for production server.
+ */
+export declare function createConfig(): ServerConfig;