@mcp-z/mcp-gmail 1.1.3 → 1.2.0

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

@@ -8,18 +8,18 @@ Object.defineProperty(exports, "default", {
         return createTool;
     }
 });
+var _gmail = require("@googleapis/gmail");
 var _email = require("@mcp-z/email");
 var _oauthgoogle = require("@mcp-z/oauth-google");
 var _server = require("@mcp-z/server");
-var _types = require("@modelcontextprotocol/sdk/types.js");
 var _sync = require("csv-stringify/sync");
 var _fs = require("fs");
 var _promises = require("fs/promises");
-var _googleapis = require("googleapis");
 var _zod = require("zod");
 var _constantsts = require("../../constants.js");
 var _htmlprocessingts = require("../../email/parsing/html-processing.js");
 var _executequeryts = require("../../email/querying/execute-query.js");
+var _googleauthts = require("../../lib/google-auth.js");
 var _gmailqueryschemats = require("../../schemas/gmail-query-schema.js");
 function asyncGeneratorStep(gen, resolve, reject, _next, _throw, key, arg) {
     try {
@@ -276,9 +276,9 @@ var config = {
                         filename: filename,
                         accountId: extra.authContext.accountId
                     });
-                    gmail = _googleapis.google.gmail({
+                    gmail = (0, _gmail.gmail)({
                         version: 'v1',
-                        auth: extra.authContext.auth
+                        auth: (0, _googleauthts.googleAuth)(extra.authContext.auth)
                     });
                     // Create CSV headers (all email fields)
                     csvHeaders = [
@@ -503,7 +503,7 @@ var config = {
                     logger.error('gmail.messages.export-csv error', {
                         error: message
                     });
-                    throw new _types.McpError(_types.ErrorCode.InternalError, "Error exporting messages to CSV: ".concat(message), {
+                    throw new _server.ProtocolError(_server.ProtocolErrorCode.InternalError, "Error exporting messages to CSV: ".concat(message), {
                         stack: _instanceof(error, Error) ? error.stack : undefined
                     });
                 case 12:

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

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/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.ts';\nimport { executeQuery as executeGmailQuery } from '../../email/querying/execute-query.ts';\nimport { GmailQueryParameterSchema, parseGmailQueryParameter } from '../../schemas/gmail-query-schema.ts';\nimport type { StorageExtra } from '../../types.ts';\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: GmailQueryParameterSchema.optional().describe('Structured query object or JSON string for filtering messages. Use query-syntax prompt for reference and rawGmailQuery for Gmail syntax.'),\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, resourceStoreUri, baseUrl } = storageContext;\n\n  // Reserve file location for streaming write (creates directory, generates ID, formats filename)\n  const reservation = await reserveFile(filename, {\n    resourceStoreUri,\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 parsedQuery = parseGmailQueryParameter(query);\n\n    logger.info('gmail.messages.export-csv called', {\n      query: parsedQuery,\n      maxItems,\n      filename,\n      accountId: extra.authContext.accountId,\n    });\n\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        parsedQuery,\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      resourceStoreUri,\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":["createTool","AuthRequiredBranchSchema","schemas","DEFAULT_MAX_ITEMS","MAX_EXPORT_ITEMS","inputSchema","z","object","query","GmailQueryParameterSchema","optional","describe","maxItems","number","int","positive","max","default","filename","string","trim","min","contentType","EmailContentTypeSchema","excludeThreadHistory","ExcludeThreadHistorySchema","successBranchSchema","type","literal","uri","rowCount","truncated","boolean","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","storageContext","transport","resourceStoreUri","baseUrl","reservation","storedName","fullPath","parsedQuery","gmail","csvHeaders","writeStream","headerLine","totalRows","nextPageToken","started","exec","remainingItems","pageSize","csvRows","rowsContent","durationMs","error","_cleanupError","message","reserveFile","info","path","parseGmailQueryParameter","accountId","authContext","google","version","auth","createWriteStream","encoding","stringify","header","quoted","quote","escape","write","Date","now","Math","DEFAULT_PAGE_SIZE","executeGmailQuery","client","undefined","pageToken","includeBody","full","fullData","headersArray","Array","isArray","payload","headers","Object","fromEntries","map","h","String","name","value","body","extractBodyFromPayload","labelIds","id","threadId","from","From","to","To","cc","Cc","bcc","Bcc","subject","Subject","date","snippet","provider","labels","join","items","row","length","metadata","batchSize","hasMore","Boolean","Promise","resolve","reject","end","on","getFileUri","endpoint","content","text","JSON","structuredContent","unlink","debug","Error","McpError","ErrorCode","InternalError","stack"],"mappings":"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"}
+{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-gmail/src/mcp/tools/messages-export-csv.ts"],"sourcesContent":["import { type gmail_v1, gmail as gmailApi } from '@googleapis/gmail';\nimport { 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, ProtocolError, ProtocolErrorCode, reserveFile, type ToolModule } from '@mcp-z/server';\n\nimport { stringify } from 'csv-stringify/sync';\nimport { createWriteStream } from 'fs';\nimport { unlink } from 'fs/promises';\nimport { z } from 'zod';\nimport { DEFAULT_PAGE_SIZE } from '../../constants.ts';\nimport { extractBodyFromPayload } from '../../email/parsing/html-processing.ts';\nimport { executeQuery as executeGmailQuery } from '../../email/querying/execute-query.ts';\nimport { googleAuth } from '../../lib/google-auth.ts';\nimport { GmailQueryParameterSchema, parseGmailQueryParameter } from '../../schemas/gmail-query-schema.ts';\nimport type { StorageExtra } from '../../types.ts';\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: GmailQueryParameterSchema.optional().describe('Structured query object or JSON string for filtering messages. Use query-syntax prompt for reference and rawGmailQuery for Gmail syntax.'),\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, resourceStoreUri, baseUrl } = storageContext;\n\n  // Reserve file location for streaming write (creates directory, generates ID, formats filename)\n  const reservation = await reserveFile(filename, {\n    resourceStoreUri,\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 parsedQuery = parseGmailQueryParameter(query);\n\n    logger.info('gmail.messages.export-csv called', {\n      query: parsedQuery,\n      maxItems,\n      filename,\n      accountId: extra.authContext.accountId,\n    });\n\n    const gmail = gmailApi({ version: 'v1', auth: googleAuth(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        parsedQuery,\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      resourceStoreUri,\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 ProtocolError(ProtocolErrorCode.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":["createTool","AuthRequiredBranchSchema","schemas","DEFAULT_MAX_ITEMS","MAX_EXPORT_ITEMS","inputSchema","z","object","query","GmailQueryParameterSchema","optional","describe","maxItems","number","int","positive","max","default","filename","string","trim","min","contentType","EmailContentTypeSchema","excludeThreadHistory","ExcludeThreadHistorySchema","successBranchSchema","type","literal","uri","rowCount","truncated","boolean","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","storageContext","transport","resourceStoreUri","baseUrl","reservation","storedName","fullPath","parsedQuery","gmail","csvHeaders","writeStream","headerLine","totalRows","nextPageToken","started","exec","remainingItems","pageSize","csvRows","rowsContent","durationMs","error","_cleanupError","message","reserveFile","info","path","parseGmailQueryParameter","accountId","authContext","gmailApi","version","auth","googleAuth","createWriteStream","encoding","stringify","header","quoted","quote","escape","write","Date","now","Math","DEFAULT_PAGE_SIZE","executeGmailQuery","client","undefined","pageToken","includeBody","full","fullData","headersArray","Array","isArray","payload","headers","Object","fromEntries","map","h","String","name","value","body","extractBodyFromPayload","labelIds","id","threadId","from","From","to","To","cc","Cc","bcc","Bcc","subject","Subject","date","snippet","provider","labels","join","items","row","length","metadata","batchSize","hasMore","Boolean","Promise","resolve","reject","end","on","getFileUri","endpoint","content","text","JSON","structuredContent","unlink","debug","Error","ProtocolError","ProtocolErrorCode","InternalError","stack"],"mappings":"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"}

package/dist/cjs/setup/http.d.cts

@@ -1,8 +1,6 @@
-import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import type { RuntimeOverrides, ServerConfig } from '../types.js';
 export declare function createHTTPServer(config: ServerConfig, overrides?: RuntimeOverrides): Promise<{
     httpServer: import("node:http").Server<typeof import("node:http").IncomingMessage, typeof import("node:http").ServerResponse>;
-    mcpServer: McpServer;
     logger: import("@mcp-z/server").Logger;
     close: () => Promise<void>;
 }>;

package/dist/cjs/setup/http.d.ts

@@ -1,8 +1,6 @@
-import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import type { RuntimeOverrides, ServerConfig } from '../types.js';
 export declare function createHTTPServer(config: ServerConfig, overrides?: RuntimeOverrides): Promise<{
     httpServer: import("node:http").Server<typeof import("node:http").IncomingMessage, typeof import("node:http").ServerResponse>;
-    mcpServer: McpServer;
     logger: import("@mcp-z/server").Logger;
     close: () => Promise<void>;
 }>;

package/dist/cjs/setup/http.js

@@ -9,7 +9,6 @@ Object.defineProperty(exports, "createHTTPServer", {
     }
 });
 var _server = require("@mcp-z/server");
-var _mcp = require("@modelcontextprotocol/sdk/server/mcp.js");
 var _cors = /*#__PURE__*/ _interop_require_default(require("cors"));
 var _express = /*#__PURE__*/ _interop_require_default(require("express"));
 var _runtimets = require("./runtime.js");
@@ -172,7 +171,7 @@ function _unsupported_iterable_to_array(o, minLen) {
 }
 function createHTTPServer(config, overrides) {
     return _async_to_generator(function() {
-        var runtime, modules, layers, composed, logger, port, tools, filteredTools, prompts, mcpServer, app, publicUrl, _ref, close, httpServer, fileRouter;
+        var runtime, modules, layers, composed, logger, port, tools, filteredTools, prompts, buildServer, app, publicUrl, _ref, close, httpServer, fileRouter;
         return _ts_generator(this, function(_state) {
             switch(_state.label){
                 case 0:
@@ -196,13 +195,22 @@ function createHTTPServer(config, overrides) {
                     }) // No file storage in DCR (public cloud responsibility)
                      : tools;
                     prompts = _to_consumable_array(composed.prompts).concat(_to_consumable_array(runtime.deps.oauthAdapters.accountPrompts));
-                    mcpServer = new _mcp.McpServer({
-                        name: config.name,
-                        version: config.version
-                    });
-                    (0, _server.registerTools)(mcpServer, filteredTools);
-                    (0, _server.registerResources)(mcpServer, composed.resources);
-                    (0, _server.registerPrompts)(mcpServer, prompts);
+                    // Built per request (HTTP) and per connection (stdio), not shared. The SDK caches the
+                    // negotiated protocol revision on the McpServer instance - its own docs say a negotiated
+                    // session never re-routes a method onto the other era - so one shared instance pins itself
+                    // to whichever revision reaches it first and answers the other with -32601.
+                    buildServer = function buildServer() {
+                        var mcpServer = new _server.McpServer({
+                            name: config.name,
+                            version: config.version
+                        }, {
+                            cacheHints: _server.defaultCacheHints
+                        });
+                        (0, _server.registerTools)(mcpServer, filteredTools);
+                        (0, _server.registerResources)(mcpServer, composed.resources);
+                        (0, _server.registerPrompts)(mcpServer, prompts);
+                        return mcpServer;
+                    };
                     app = (0, _express.default)();
                     app.use(_express.default.json({
                         limit: '10mb'
@@ -213,7 +221,7 @@ function createHTTPServer(config, overrides) {
                     logger.info("Starting ".concat(config.name, " MCP server (http)"));
                     return [
                         4,
-                        (0, _server.connectHttp)(mcpServer, {
+                        (0, _server.connectHttp)(buildServer, {
                             logger: logger,
                             app: app,
                             port: port,
@@ -252,7 +260,6 @@ function createHTTPServer(config, overrides) {
                         2,
                         {
                             httpServer: httpServer,
-                            mcpServer: mcpServer,
                             logger: logger,
                             close: function close1() {
                                 return _async_to_generator(function() {

package/dist/cjs/setup/http.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-gmail/src/setup/http.ts"],"sourcesContent":["import { composeMiddleware, connectHttp, createFileServingRouter, registerPrompts, registerResources, registerTools } from '@mcp-z/server';\nimport { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';\nimport cors from 'cors';\nimport express from 'express';\nimport type { RuntimeOverrides, ServerConfig } from '../types.ts';\nimport { createDefaultRuntime } from './runtime.ts';\n\nexport async function createHTTPServer(config: ServerConfig, overrides?: RuntimeOverrides) {\n  const runtime = await createDefaultRuntime(config, overrides);\n  const modules = runtime.createDomainModules();\n  const layers = runtime.middlewareFactories.map((factory) => factory(runtime.deps));\n  const composed = composeMiddleware(modules, layers);\n  const logger = runtime.deps.logger;\n  const port = config.transport.port;\n  if (!port) throw new Error('Port is required for HTTP transport');\n\n  const tools = [...composed.tools, ...runtime.deps.oauthAdapters.accountTools];\n  const filteredTools =\n    config.auth === 'dcr'\n      ? tools.filter((tool) => tool.name !== 'messages-export-csv') // No file storage in DCR (public cloud responsibility)\n      : tools;\n  const prompts = [...composed.prompts, ...runtime.deps.oauthAdapters.accountPrompts];\n\n  const mcpServer = new McpServer({ name: config.name, version: config.version });\n  registerTools(mcpServer, filteredTools);\n  registerResources(mcpServer, composed.resources);\n  registerPrompts(mcpServer, prompts);\n\n  const app = express();\n  app.use(express.json({ limit: '10mb' }));\n\n  // Must mount '/mcp' before any permissive app-level cors(), or that layer answers its\n  // preflight first; pass baseUrl's origin/host below or a public deployment 403s itself.\n  const publicUrl = config.baseUrl ? new URL(config.baseUrl) : undefined;\n  logger.info(`Starting ${config.name} MCP server (http)`);\n  const { close, httpServer } = await connectHttp(mcpServer, {\n    logger,\n    app,\n    port,\n    allowedOrigins: publicUrl ? [publicUrl.origin] : undefined,\n    allowedHosts: publicUrl ? [publicUrl.host] : undefined,\n  });\n\n  // The loopback OAuth callback, the file-export download, and the DCR discovery/\n  // registration endpoints are all meant to be reached from a browser on another\n  // origin. Keep cors() for them, scoped to their own routes - never in front of '/mcp'.\n  if (runtime.deps.oauthAdapters.loopbackRouter) {\n    app.use('/', cors(), runtime.deps.oauthAdapters.loopbackRouter);\n    logger.info('Mounted loopback OAuth callback router');\n  }\n\n  if (config.auth !== 'dcr') {\n    const fileRouter = createFileServingRouter({ resourceStoreUri: config.resourceStoreUri }, { contentType: 'text/csv', contentDisposition: 'attachment' });\n    app.use('/files', cors(), fileRouter);\n  }\n\n  if (runtime.deps.oauthAdapters.dcrRouter) {\n    app.use('/', cors(), runtime.deps.oauthAdapters.dcrRouter);\n    logger.info('Mounted DCR router with OAuth endpoints');\n  }\n\n  logger.info('http transport ready');\n\n  return {\n    httpServer,\n    mcpServer,\n    logger,\n    close: async () => {\n      await close();\n      await runtime.close();\n    },\n  };\n}\n"],"names":["createHTTPServer","config","overrides","runtime","modules","layers","composed","logger","port","tools","filteredTools","prompts","mcpServer","app","publicUrl","close","httpServer","fileRouter","createDefaultRuntime","createDomainModules","middlewareFactories","map","factory","deps","composeMiddleware","transport","Error","oauthAdapters","accountTools","auth","filter","tool","name","accountPrompts","McpServer","version","registerTools","registerResources","resources","registerPrompts","express","use","json","limit","baseUrl","URL","undefined","info","connectHttp","allowedOrigins","origin","allowedHosts","host","loopbackRouter","cors","createFileServingRouter","resourceStoreUri","contentType","contentDisposition","dcrRouter"],"mappings":"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"}
+{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-gmail/src/setup/http.ts"],"sourcesContent":["import { composeMiddleware, connectHttp, createFileServingRouter, defaultCacheHints, McpServer, registerPrompts, registerResources, registerTools } from '@mcp-z/server';\nimport cors from 'cors';\nimport express from 'express';\nimport type { RuntimeOverrides, ServerConfig } from '../types.ts';\nimport { createDefaultRuntime } from './runtime.ts';\n\nexport async function createHTTPServer(config: ServerConfig, overrides?: RuntimeOverrides) {\n  const runtime = await createDefaultRuntime(config, overrides);\n  const modules = runtime.createDomainModules();\n  const layers = runtime.middlewareFactories.map((factory) => factory(runtime.deps));\n  const composed = composeMiddleware(modules, layers);\n  const logger = runtime.deps.logger;\n  const port = config.transport.port;\n  if (!port) throw new Error('Port is required for HTTP transport');\n\n  const tools = [...composed.tools, ...runtime.deps.oauthAdapters.accountTools];\n  const filteredTools =\n    config.auth === 'dcr'\n      ? tools.filter((tool) => tool.name !== 'messages-export-csv') // No file storage in DCR (public cloud responsibility)\n      : tools;\n  const prompts = [...composed.prompts, ...runtime.deps.oauthAdapters.accountPrompts];\n\n  // Built per request (HTTP) and per connection (stdio), not shared. The SDK caches the\n  // negotiated protocol revision on the McpServer instance - its own docs say a negotiated\n  // session never re-routes a method onto the other era - so one shared instance pins itself\n  // to whichever revision reaches it first and answers the other with -32601.\n  const buildServer = () => {\n    const mcpServer = new McpServer({ name: config.name, version: config.version }, { cacheHints: defaultCacheHints });\n    registerTools(mcpServer, filteredTools);\n    registerResources(mcpServer, composed.resources);\n    registerPrompts(mcpServer, prompts);\n    return mcpServer;\n  };\n\n  const app = express();\n  app.use(express.json({ limit: '10mb' }));\n\n  // Must mount '/mcp' before any permissive app-level cors(), or that layer answers its\n  // preflight first; pass baseUrl's origin/host below or a public deployment 403s itself.\n  const publicUrl = config.baseUrl ? new URL(config.baseUrl) : undefined;\n  logger.info(`Starting ${config.name} MCP server (http)`);\n  const { close, httpServer } = await connectHttp(buildServer, {\n    logger,\n    app,\n    port,\n    allowedOrigins: publicUrl ? [publicUrl.origin] : undefined,\n    allowedHosts: publicUrl ? [publicUrl.host] : undefined,\n  });\n\n  // The loopback OAuth callback, the file-export download, and the DCR discovery/\n  // registration endpoints are all meant to be reached from a browser on another\n  // origin. Keep cors() for them, scoped to their own routes - never in front of '/mcp'.\n  if (runtime.deps.oauthAdapters.loopbackRouter) {\n    app.use('/', cors(), runtime.deps.oauthAdapters.loopbackRouter);\n    logger.info('Mounted loopback OAuth callback router');\n  }\n\n  if (config.auth !== 'dcr') {\n    const fileRouter = createFileServingRouter({ resourceStoreUri: config.resourceStoreUri }, { contentType: 'text/csv', contentDisposition: 'attachment' });\n    app.use('/files', cors(), fileRouter);\n  }\n\n  if (runtime.deps.oauthAdapters.dcrRouter) {\n    app.use('/', cors(), runtime.deps.oauthAdapters.dcrRouter);\n    logger.info('Mounted DCR router with OAuth endpoints');\n  }\n\n  logger.info('http transport ready');\n\n  return {\n    httpServer,\n    logger,\n    close: async () => {\n      await close();\n      await runtime.close();\n    },\n  };\n}\n"],"names":["createHTTPServer","config","overrides","runtime","modules","layers","composed","logger","port","tools","filteredTools","prompts","buildServer","app","publicUrl","close","httpServer","fileRouter","createDefaultRuntime","createDomainModules","middlewareFactories","map","factory","deps","composeMiddleware","transport","Error","oauthAdapters","accountTools","auth","filter","tool","name","accountPrompts","mcpServer","McpServer","version","cacheHints","defaultCacheHints","registerTools","registerResources","resources","registerPrompts","express","use","json","limit","baseUrl","URL","undefined","info","connectHttp","allowedOrigins","origin","allowedHosts","host","loopbackRouter","cors","createFileServingRouter","resourceStoreUri","contentType","contentDisposition","dcrRouter"],"mappings":"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"}

package/dist/cjs/setup/stdio.d.cts

@@ -1,7 +1,5 @@
-import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import type { RuntimeOverrides, ServerConfig } from '../types.js';
 export declare function createStdioServer(config: ServerConfig, overrides?: RuntimeOverrides): Promise<{
-    mcpServer: McpServer;
     logger: import("@mcp-z/server").Logger;
     close: () => Promise<void>;
 }>;

package/dist/cjs/setup/stdio.d.ts

@@ -1,7 +1,5 @@
-import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import type { RuntimeOverrides, ServerConfig } from '../types.js';
 export declare function createStdioServer(config: ServerConfig, overrides?: RuntimeOverrides): Promise<{
-    mcpServer: McpServer;
     logger: import("@mcp-z/server").Logger;
     close: () => Promise<void>;
 }>;

package/dist/cjs/setup/stdio.js

@@ -9,7 +9,6 @@ Object.defineProperty(exports, "createStdioServer", {
     }
 });
 var _server = require("@mcp-z/server");
-var _mcp = require("@modelcontextprotocol/sdk/server/mcp.js");
 var _runtimets = require("./runtime.js");
 function _array_like_to_array(arr, len) {
     if (len == null || len > arr.length) len = arr.length;
@@ -165,7 +164,7 @@ function _unsupported_iterable_to_array(o, minLen) {
 }
 function createStdioServer(config, overrides) {
     return _async_to_generator(function() {
-        var runtime, modules, layers, composed, logger, tools, filteredTools, prompts, mcpServer, close;
+        var runtime, modules, layers, composed, logger, tools, filteredTools, prompts, buildServer, close;
         return _ts_generator(this, function(_state) {
             switch(_state.label){
                 case 0:
@@ -187,17 +186,26 @@ function createStdioServer(config, overrides) {
                     }) // No file storage in DCR (public cloud responsibility)
                      : tools;
                     prompts = _to_consumable_array(composed.prompts).concat(_to_consumable_array(runtime.deps.oauthAdapters.accountPrompts));
-                    mcpServer = new _mcp.McpServer({
-                        name: config.name,
-                        version: config.version
-                    });
-                    (0, _server.registerTools)(mcpServer, filteredTools);
-                    (0, _server.registerResources)(mcpServer, composed.resources);
-                    (0, _server.registerPrompts)(mcpServer, prompts);
+                    // Built per request (HTTP) and per connection (stdio), not shared. The SDK caches the
+                    // negotiated protocol revision on the McpServer instance - its own docs say a negotiated
+                    // session never re-routes a method onto the other era - so one shared instance pins itself
+                    // to whichever revision reaches it first and answers the other with -32601.
+                    buildServer = function buildServer() {
+                        var mcpServer = new _server.McpServer({
+                            name: config.name,
+                            version: config.version
+                        }, {
+                            cacheHints: _server.defaultCacheHints
+                        });
+                        (0, _server.registerTools)(mcpServer, filteredTools);
+                        (0, _server.registerResources)(mcpServer, composed.resources);
+                        (0, _server.registerPrompts)(mcpServer, prompts);
+                        return mcpServer;
+                    };
                     logger.info("Starting ".concat(config.name, " MCP server (stdio)"));
                     return [
                         4,
-                        (0, _server.connectStdio)(mcpServer, {
+                        (0, _server.connectStdio)(buildServer, {
                             logger: logger
                         })
                     ];
@@ -207,7 +215,6 @@ function createStdioServer(config, overrides) {
                     return [
                         2,
                         {
-                            mcpServer: mcpServer,
                             logger: logger,
                             close: function close1() {
                                 return _async_to_generator(function() {

package/dist/cjs/setup/stdio.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-gmail/src/setup/stdio.ts"],"sourcesContent":["import { composeMiddleware, connectStdio, registerPrompts, registerResources, registerTools } from '@mcp-z/server';\nimport { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';\nimport type { RuntimeOverrides, ServerConfig } from '../types.ts';\nimport { createDefaultRuntime } from './runtime.ts';\n\nexport async function createStdioServer(config: ServerConfig, overrides?: RuntimeOverrides) {\n  const runtime = await createDefaultRuntime(config, overrides);\n  const modules = runtime.createDomainModules();\n  const layers = runtime.middlewareFactories.map((factory) => factory(runtime.deps));\n  const composed = composeMiddleware(modules, layers);\n  const logger = runtime.deps.logger;\n\n  const tools = [...composed.tools, ...runtime.deps.oauthAdapters.accountTools];\n  const filteredTools =\n    config.auth === 'dcr'\n      ? tools.filter((tool) => tool.name !== 'messages-export-csv') // No file storage in DCR (public cloud responsibility)\n      : tools;\n  const prompts = [...composed.prompts, ...runtime.deps.oauthAdapters.accountPrompts];\n\n  const mcpServer = new McpServer({ name: config.name, version: config.version });\n  registerTools(mcpServer, filteredTools);\n  registerResources(mcpServer, composed.resources);\n  registerPrompts(mcpServer, prompts);\n\n  logger.info(`Starting ${config.name} MCP server (stdio)`);\n  const { close } = await connectStdio(mcpServer, { logger });\n  logger.info('stdio transport ready');\n\n  return {\n    mcpServer,\n    logger,\n    close: async () => {\n      await close();\n      await runtime.close();\n    },\n  };\n}\n"],"names":["createStdioServer","config","overrides","runtime","modules","layers","composed","logger","tools","filteredTools","prompts","mcpServer","close","createDefaultRuntime","createDomainModules","middlewareFactories","map","factory","deps","composeMiddleware","oauthAdapters","accountTools","auth","filter","tool","name","accountPrompts","McpServer","version","registerTools","registerResources","resources","registerPrompts","info","connectStdio"],"mappings":";;;;+BAKsBA;;;eAAAA;;;sBAL6E;mBACzE;yBAEW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAE9B,SAAeA,kBAAkBC,MAAoB,EAAEC,SAA4B;;YAClFC,SACAC,SACAC,QACAC,UACAC,QAEAC,OACAC,eAIAC,SAEAC,WAMEC;;;;oBAnBQ;;wBAAMC,IAAAA,+BAAoB,EAACZ,QAAQC;;;oBAA7CC,UAAU;oBACVC,UAAUD,QAAQW,mBAAmB;oBACrCT,SAASF,QAAQY,mBAAmB,CAACC,GAAG,CAAC,SAACC;+BAAYA,QAAQd,QAAQe,IAAI;;oBAC1EZ,WAAWa,IAAAA,yBAAiB,EAACf,SAASC;oBACtCE,SAASJ,QAAQe,IAAI,CAACX,MAAM;oBAE5BC,QAAQ,AAAC,qBAAGF,SAASE,KAAK,SAAE,qBAAGL,QAAQe,IAAI,CAACE,aAAa,CAACC,YAAY;oBACtEZ,gBACJR,OAAOqB,IAAI,KAAK,QACZd,MAAMe,MAAM,CAAC,SAACC;+BAASA,KAAKC,IAAI,KAAK;uBAAuB,uDAAuD;uBACnHjB;oBACAE,UAAU,AAAC,qBAAGJ,SAASI,OAAO,SAAE,qBAAGP,QAAQe,IAAI,CAACE,aAAa,CAACM,cAAc;oBAE5Ef,YAAY,IAAIgB,cAAS,CAAC;wBAAEF,MAAMxB,OAAOwB,IAAI;wBAAEG,SAAS3B,OAAO2B,OAAO;oBAAC;oBAC7EC,IAAAA,qBAAa,EAAClB,WAAWF;oBACzBqB,IAAAA,yBAAiB,EAACnB,WAAWL,SAASyB,SAAS;oBAC/CC,IAAAA,uBAAe,EAACrB,WAAWD;oBAE3BH,OAAO0B,IAAI,CAAC,AAAC,YAAuB,OAAZhC,OAAOwB,IAAI,EAAC;oBAClB;;wBAAMS,IAAAA,oBAAY,EAACvB,WAAW;4BAAEJ,QAAAA;wBAAO;;;oBAAjDK,QAAU,cAAVA;oBACRL,OAAO0B,IAAI,CAAC;oBAEZ;;wBAAO;4BACLtB,WAAAA;4BACAJ,QAAAA;4BACAK,OAAO,SAAPA;;;;;gDACE;;oDAAMA;;;gDAAN;gDACA;;oDAAMT,QAAQS,KAAK;;;gDAAnB;;;;;;gCACF;;wBACF;;;;IACF"}
+{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-gmail/src/setup/stdio.ts"],"sourcesContent":["import { composeMiddleware, connectStdio, defaultCacheHints, McpServer, registerPrompts, registerResources, registerTools } from '@mcp-z/server';\nimport type { RuntimeOverrides, ServerConfig } from '../types.ts';\nimport { createDefaultRuntime } from './runtime.ts';\n\nexport async function createStdioServer(config: ServerConfig, overrides?: RuntimeOverrides) {\n  const runtime = await createDefaultRuntime(config, overrides);\n  const modules = runtime.createDomainModules();\n  const layers = runtime.middlewareFactories.map((factory) => factory(runtime.deps));\n  const composed = composeMiddleware(modules, layers);\n  const logger = runtime.deps.logger;\n\n  const tools = [...composed.tools, ...runtime.deps.oauthAdapters.accountTools];\n  const filteredTools =\n    config.auth === 'dcr'\n      ? tools.filter((tool) => tool.name !== 'messages-export-csv') // No file storage in DCR (public cloud responsibility)\n      : tools;\n  const prompts = [...composed.prompts, ...runtime.deps.oauthAdapters.accountPrompts];\n\n  // Built per request (HTTP) and per connection (stdio), not shared. The SDK caches the\n  // negotiated protocol revision on the McpServer instance - its own docs say a negotiated\n  // session never re-routes a method onto the other era - so one shared instance pins itself\n  // to whichever revision reaches it first and answers the other with -32601.\n  const buildServer = () => {\n    const mcpServer = new McpServer({ name: config.name, version: config.version }, { cacheHints: defaultCacheHints });\n    registerTools(mcpServer, filteredTools);\n    registerResources(mcpServer, composed.resources);\n    registerPrompts(mcpServer, prompts);\n    return mcpServer;\n  };\n\n  logger.info(`Starting ${config.name} MCP server (stdio)`);\n  const { close } = await connectStdio(buildServer, { logger });\n  logger.info('stdio transport ready');\n\n  return {\n    logger,\n    close: async () => {\n      await close();\n      await runtime.close();\n    },\n  };\n}\n"],"names":["createStdioServer","config","overrides","runtime","modules","layers","composed","logger","tools","filteredTools","prompts","buildServer","close","createDefaultRuntime","createDomainModules","middlewareFactories","map","factory","deps","composeMiddleware","oauthAdapters","accountTools","auth","filter","tool","name","accountPrompts","mcpServer","McpServer","version","cacheHints","defaultCacheHints","registerTools","registerResources","resources","registerPrompts","info","connectStdio"],"mappings":";;;;+BAIsBA;;;eAAAA;;;sBAJ2G;yBAE5F;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAE9B,SAAeA,kBAAkBC,MAAoB,EAAEC,SAA4B;;YAClFC,SACAC,SACAC,QACAC,UACAC,QAEAC,OACAC,eAIAC,SAMAC,aASEC;;;;oBA1BQ;;wBAAMC,IAAAA,+BAAoB,EAACZ,QAAQC;;;oBAA7CC,UAAU;oBACVC,UAAUD,QAAQW,mBAAmB;oBACrCT,SAASF,QAAQY,mBAAmB,CAACC,GAAG,CAAC,SAACC;+BAAYA,QAAQd,QAAQe,IAAI;;oBAC1EZ,WAAWa,IAAAA,yBAAiB,EAACf,SAASC;oBACtCE,SAASJ,QAAQe,IAAI,CAACX,MAAM;oBAE5BC,QAAQ,AAAC,qBAAGF,SAASE,KAAK,SAAE,qBAAGL,QAAQe,IAAI,CAACE,aAAa,CAACC,YAAY;oBACtEZ,gBACJR,OAAOqB,IAAI,KAAK,QACZd,MAAMe,MAAM,CAAC,SAACC;+BAASA,KAAKC,IAAI,KAAK;uBAAuB,uDAAuD;uBACnHjB;oBACAE,UAAU,AAAC,qBAAGJ,SAASI,OAAO,SAAE,qBAAGP,QAAQe,IAAI,CAACE,aAAa,CAACM,cAAc;oBAElF,sFAAsF;oBACtF,yFAAyF;oBACzF,2FAA2F;oBAC3F,4EAA4E;oBACtEf,cAAc;wBAClB,IAAMgB,YAAY,IAAIC,iBAAS,CAAC;4BAAEH,MAAMxB,OAAOwB,IAAI;4BAAEI,SAAS5B,OAAO4B,OAAO;wBAAC,GAAG;4BAAEC,YAAYC,yBAAiB;wBAAC;wBAChHC,IAAAA,qBAAa,EAACL,WAAWlB;wBACzBwB,IAAAA,yBAAiB,EAACN,WAAWrB,SAAS4B,SAAS;wBAC/CC,IAAAA,uBAAe,EAACR,WAAWjB;wBAC3B,OAAOiB;oBACT;oBAEApB,OAAO6B,IAAI,CAAC,AAAC,YAAuB,OAAZnC,OAAOwB,IAAI,EAAC;oBAClB;;wBAAMY,IAAAA,oBAAY,EAAC1B,aAAa;4BAAEJ,QAAAA;wBAAO;;;oBAAnDK,QAAU,cAAVA;oBACRL,OAAO6B,IAAI,CAAC;oBAEZ;;wBAAO;4BACL7B,QAAAA;4BACAK,OAAO,SAAPA;;;;;gDACE;;oDAAMA;;;gDAAN;gDACA;;oDAAMT,QAAQS,KAAK;;;gDAAnB;;;;;;gCACF;;wBACF;;;;IACF"}

package/dist/esm/email/messages/fetch-message.d.ts

@@ -1,4 +1,4 @@
-import type { gmail_v1 } from 'googleapis';
+import type { gmail_v1 } from '@googleapis/gmail';
 export type FetchMode = 'metadata' | 'full';
 export interface NormalizedAddress {
     address?: string | undefined;

package/dist/esm/email/messages/fetch-message.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-gmail/src/email/messages/fetch-message.ts"],"sourcesContent":["import type { gmail_v1 } from 'googleapis';\nimport { toIsoUtc } from '../../lib/date-conversion.ts';\nimport { extractEmails, extractFrom } from '../parsing/headers-utils.ts';\n\nexport type FetchMode = 'metadata' | 'full';\n\nexport interface NormalizedAddress {\n  address?: string | undefined;\n  name?: string | undefined;\n}\nexport interface NormalizedMessage {\n  id: string;\n  threadId?: string | undefined;\n  date?: string | undefined;\n  subject?: string | undefined;\n  from?: NormalizedAddress | undefined;\n  to?: string[] | undefined;\n  cc?: string[] | undefined;\n  bcc?: string[] | undefined;\n  snippet?: string | undefined;\n  labels?: string[] | undefined;\n  body?: string | undefined;\n}\n\nexport interface GmailDeps {\n  /** googleapis Gmail client created via createGmailClient(provider). */\n  gmail: gmail_v1.Gmail;\n}\n\nfunction extractHeader(headers: Array<{ name?: string; value?: string }> | undefined, key: string): string | undefined {\n  const h = headers?.find((x) => (x.name ?? '').toLowerCase() === key.toLowerCase());\n  return h?.value ?? undefined;\n}\n\nfunction base64UrlDecode(input: string): string {\n  let s = String(input).replace(/-/g, '+').replace(/_/g, '/');\n  while (s.length % 4 !== 0) s += '=';\n  try {\n    return Buffer.from(s, 'base64').toString('utf8');\n  } catch {\n    return '';\n  }\n}\n\nfunction extractBody(payload: unknown): string | undefined {\n  const find = (parts: unknown[] | undefined, mime: string): string | undefined => {\n    for (const p of parts ?? []) {\n      if (p && typeof p === 'object' && 'mimeType' in p && 'body' in p) {\n        if (p.mimeType === mime && p.body && typeof p.body === 'object' && 'data' in p.body) {\n          return base64UrlDecode(p.body.data as string);\n        }\n      }\n      if (p && typeof p === 'object' && 'parts' in p) {\n        const nested = find(p.parts as unknown[], mime);\n        if (nested) return nested;\n      }\n    }\n    return undefined;\n  };\n  if (payload && typeof payload === 'object' && 'parts' in payload) {\n    return find(payload.parts as unknown[], 'text/plain') ?? find(payload.parts as unknown[], 'text/html')?.replace(/\\r\\n?/g, '\\n');\n  }\n  return undefined;\n}\n\nexport async function fetchMessage(deps: GmailDeps, id: string, mode: FetchMode): Promise<NormalizedMessage> {\n  const { gmail } = deps;\n  // When only metadata is requested, ask Gmail for a reduced payload with just the headers we care about.\n  const metadataHeaders = ['Date', 'Subject', 'From', 'To', 'Cc', 'Bcc'];\n  const format = mode === 'full' ? 'full' : 'metadata';\n  const baseParams = { userId: 'me' as const, id, format };\n  const resp = format === 'metadata' ? await gmail.users.messages.get({ ...baseParams, metadataHeaders }) : await gmail.users.messages.get(baseParams);\n  const data = resp?.data as unknown;\n  const headers = data && typeof data === 'object' && 'payload' in data && data.payload && typeof data.payload === 'object' && 'headers' in data.payload ? (data.payload.headers as Array<{ name?: string; value?: string }> | undefined) : undefined;\n  const dateRaw = extractHeader(headers, 'Date');\n  const fromRaw = extractHeader(headers, 'From');\n  const toRaw = extractHeader(headers, 'To');\n  const ccRaw = extractHeader(headers, 'Cc');\n  const bccRaw = extractHeader(headers, 'Bcc');\n\n  const fromObj = (fromRaw ? (extractFrom(fromRaw) as NormalizedAddress) : undefined) ?? undefined;\n  const toArr = toRaw ? extractEmails(toRaw) : [];\n  const ccArr = ccRaw ? extractEmails(ccRaw) : [];\n  const bccArr = bccRaw ? extractEmails(bccRaw) : [];\n\n  const getId = (): string => {\n    if (data && typeof data === 'object' && 'id' in data) {\n      return String(data.id ?? id);\n    }\n    return id;\n  };\n\n  const getThreadId = (): string | undefined => {\n    if (data && typeof data === 'object' && 'threadId' in data && data.threadId) {\n      return String(data.threadId);\n    }\n    return undefined;\n  };\n\n  const getSnippet = (): string | undefined => {\n    if (data && typeof data === 'object' && 'snippet' in data && data.snippet) {\n      return String(data.snippet);\n    }\n    return undefined;\n  };\n\n  const getLabelIds = (): string[] | undefined => {\n    if (data && typeof data === 'object' && 'labelIds' in data && Array.isArray(data.labelIds)) {\n      return data.labelIds.map(String);\n    }\n    return undefined;\n  };\n\n  const getPayload = (): unknown => {\n    if (data && typeof data === 'object' && 'payload' in data) {\n      return data.payload;\n    }\n    return undefined;\n  };\n\n  const msg: NormalizedMessage = {\n    id: getId(),\n    threadId: getThreadId(),\n    date: dateRaw ? (toIsoUtc(dateRaw) ?? dateRaw) : undefined,\n    subject: extractHeader(headers, 'Subject'),\n    from: fromObj,\n    to: toArr.length ? toArr : undefined,\n    cc: ccArr.length ? ccArr : undefined,\n    bcc: bccArr.length ? bccArr : undefined,\n    snippet: getSnippet(),\n    labels: getLabelIds(),\n  };\n  if (mode === 'full') {\n    const body = extractBody(getPayload());\n    if (body) msg.body = body;\n  }\n  return msg;\n}\n"],"names":["toIsoUtc","extractEmails","extractFrom","extractHeader","headers","key","h","find","x","name","toLowerCase","value","undefined","base64UrlDecode","input","s","String","replace","length","Buffer","from","toString","extractBody","payload","parts","mime","p","mimeType","body","data","nested","fetchMessage","deps","id","mode","fromRaw","gmail","metadataHeaders","format","baseParams","userId","resp","users","messages","get","dateRaw","toRaw","ccRaw","bccRaw","fromObj","toArr","ccArr","bccArr","getId","getThreadId","threadId","getSnippet","snippet","getLabelIds","Array","isArray","labelIds","map","getPayload","msg","date","subject","to","cc","bcc","labels"],"mappings":"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"}
+{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-gmail/src/email/messages/fetch-message.ts"],"sourcesContent":["import type { gmail_v1 } from '@googleapis/gmail';\nimport { toIsoUtc } from '../../lib/date-conversion.ts';\nimport { extractEmails, extractFrom } from '../parsing/headers-utils.ts';\n\nexport type FetchMode = 'metadata' | 'full';\n\nexport interface NormalizedAddress {\n  address?: string | undefined;\n  name?: string | undefined;\n}\nexport interface NormalizedMessage {\n  id: string;\n  threadId?: string | undefined;\n  date?: string | undefined;\n  subject?: string | undefined;\n  from?: NormalizedAddress | undefined;\n  to?: string[] | undefined;\n  cc?: string[] | undefined;\n  bcc?: string[] | undefined;\n  snippet?: string | undefined;\n  labels?: string[] | undefined;\n  body?: string | undefined;\n}\n\nexport interface GmailDeps {\n  /** googleapis Gmail client created via createGmailClient(provider). */\n  gmail: gmail_v1.Gmail;\n}\n\nfunction extractHeader(headers: Array<{ name?: string; value?: string }> | undefined, key: string): string | undefined {\n  const h = headers?.find((x) => (x.name ?? '').toLowerCase() === key.toLowerCase());\n  return h?.value ?? undefined;\n}\n\nfunction base64UrlDecode(input: string): string {\n  let s = String(input).replace(/-/g, '+').replace(/_/g, '/');\n  while (s.length % 4 !== 0) s += '=';\n  try {\n    return Buffer.from(s, 'base64').toString('utf8');\n  } catch {\n    return '';\n  }\n}\n\nfunction extractBody(payload: unknown): string | undefined {\n  const find = (parts: unknown[] | undefined, mime: string): string | undefined => {\n    for (const p of parts ?? []) {\n      if (p && typeof p === 'object' && 'mimeType' in p && 'body' in p) {\n        if (p.mimeType === mime && p.body && typeof p.body === 'object' && 'data' in p.body) {\n          return base64UrlDecode(p.body.data as string);\n        }\n      }\n      if (p && typeof p === 'object' && 'parts' in p) {\n        const nested = find(p.parts as unknown[], mime);\n        if (nested) return nested;\n      }\n    }\n    return undefined;\n  };\n  if (payload && typeof payload === 'object' && 'parts' in payload) {\n    return find(payload.parts as unknown[], 'text/plain') ?? find(payload.parts as unknown[], 'text/html')?.replace(/\\r\\n?/g, '\\n');\n  }\n  return undefined;\n}\n\nexport async function fetchMessage(deps: GmailDeps, id: string, mode: FetchMode): Promise<NormalizedMessage> {\n  const { gmail } = deps;\n  // When only metadata is requested, ask Gmail for a reduced payload with just the headers we care about.\n  const metadataHeaders = ['Date', 'Subject', 'From', 'To', 'Cc', 'Bcc'];\n  const format = mode === 'full' ? 'full' : 'metadata';\n  const baseParams = { userId: 'me' as const, id, format };\n  const resp = format === 'metadata' ? await gmail.users.messages.get({ ...baseParams, metadataHeaders }) : await gmail.users.messages.get(baseParams);\n  const data = resp?.data as unknown;\n  const headers = data && typeof data === 'object' && 'payload' in data && data.payload && typeof data.payload === 'object' && 'headers' in data.payload ? (data.payload.headers as Array<{ name?: string; value?: string }> | undefined) : undefined;\n  const dateRaw = extractHeader(headers, 'Date');\n  const fromRaw = extractHeader(headers, 'From');\n  const toRaw = extractHeader(headers, 'To');\n  const ccRaw = extractHeader(headers, 'Cc');\n  const bccRaw = extractHeader(headers, 'Bcc');\n\n  const fromObj = (fromRaw ? (extractFrom(fromRaw) as NormalizedAddress) : undefined) ?? undefined;\n  const toArr = toRaw ? extractEmails(toRaw) : [];\n  const ccArr = ccRaw ? extractEmails(ccRaw) : [];\n  const bccArr = bccRaw ? extractEmails(bccRaw) : [];\n\n  const getId = (): string => {\n    if (data && typeof data === 'object' && 'id' in data) {\n      return String(data.id ?? id);\n    }\n    return id;\n  };\n\n  const getThreadId = (): string | undefined => {\n    if (data && typeof data === 'object' && 'threadId' in data && data.threadId) {\n      return String(data.threadId);\n    }\n    return undefined;\n  };\n\n  const getSnippet = (): string | undefined => {\n    if (data && typeof data === 'object' && 'snippet' in data && data.snippet) {\n      return String(data.snippet);\n    }\n    return undefined;\n  };\n\n  const getLabelIds = (): string[] | undefined => {\n    if (data && typeof data === 'object' && 'labelIds' in data && Array.isArray(data.labelIds)) {\n      return data.labelIds.map(String);\n    }\n    return undefined;\n  };\n\n  const getPayload = (): unknown => {\n    if (data && typeof data === 'object' && 'payload' in data) {\n      return data.payload;\n    }\n    return undefined;\n  };\n\n  const msg: NormalizedMessage = {\n    id: getId(),\n    threadId: getThreadId(),\n    date: dateRaw ? (toIsoUtc(dateRaw) ?? dateRaw) : undefined,\n    subject: extractHeader(headers, 'Subject'),\n    from: fromObj,\n    to: toArr.length ? toArr : undefined,\n    cc: ccArr.length ? ccArr : undefined,\n    bcc: bccArr.length ? bccArr : undefined,\n    snippet: getSnippet(),\n    labels: getLabelIds(),\n  };\n  if (mode === 'full') {\n    const body = extractBody(getPayload());\n    if (body) msg.body = body;\n  }\n  return msg;\n}\n"],"names":["toIsoUtc","extractEmails","extractFrom","extractHeader","headers","key","h","find","x","name","toLowerCase","value","undefined","base64UrlDecode","input","s","String","replace","length","Buffer","from","toString","extractBody","payload","parts","mime","p","mimeType","body","data","nested","fetchMessage","deps","id","mode","fromRaw","gmail","metadataHeaders","format","baseParams","userId","resp","users","messages","get","dateRaw","toRaw","ccRaw","bccRaw","fromObj","toArr","ccArr","bccArr","getId","getThreadId","threadId","getSnippet","snippet","getLabelIds","Array","isArray","labelIds","map","getPayload","msg","date","subject","to","cc","bcc","labels"],"mappings":"AACA,SAASA,QAAQ,QAAQ,+BAA+B;AACxD,SAASC,aAAa,EAAEC,WAAW,QAAQ,8BAA8B;AA2BzE,SAASC,cAAcC,OAA6D,EAAEC,GAAW;;IAC/F,MAAMC,IAAIF,oBAAAA,8BAAAA,QAASG,IAAI,CAAC,CAACC;YAAOA;eAAD,EAACA,UAAAA,EAAEC,IAAI,cAAND,qBAAAA,UAAU,IAAIE,WAAW,OAAOL,IAAIK,WAAW;;IAC/E,eAAOJ,cAAAA,wBAAAA,EAAGK,KAAK,uCAAIC;AACrB;AAEA,SAASC,gBAAgBC,KAAa;IACpC,IAAIC,IAAIC,OAAOF,OAAOG,OAAO,CAAC,MAAM,KAAKA,OAAO,CAAC,MAAM;IACvD,MAAOF,EAAEG,MAAM,GAAG,MAAM,EAAGH,KAAK;IAChC,IAAI;QACF,OAAOI,OAAOC,IAAI,CAACL,GAAG,UAAUM,QAAQ,CAAC;IAC3C,EAAE,OAAM;QACN,OAAO;IACT;AACF;AAEA,SAASC,YAAYC,OAAgB;IACnC,MAAMhB,OAAO,CAACiB,OAA8BC;QAC1C,KAAK,MAAMC,KAAKF,kBAAAA,mBAAAA,QAAS,EAAE,CAAE;YAC3B,IAAIE,KAAK,OAAOA,MAAM,YAAY,cAAcA,KAAK,UAAUA,GAAG;gBAChE,IAAIA,EAAEC,QAAQ,KAAKF,QAAQC,EAAEE,IAAI,IAAI,OAAOF,EAAEE,IAAI,KAAK,YAAY,UAAUF,EAAEE,IAAI,EAAE;oBACnF,OAAOf,gBAAgBa,EAAEE,IAAI,CAACC,IAAI;gBACpC;YACF;YACA,IAAIH,KAAK,OAAOA,MAAM,YAAY,WAAWA,GAAG;gBAC9C,MAAMI,SAASvB,KAAKmB,EAAEF,KAAK,EAAeC;gBAC1C,IAAIK,QAAQ,OAAOA;YACrB;QACF;QACA,OAAOlB;IACT;IACA,IAAIW,WAAW,OAAOA,YAAY,YAAY,WAAWA,SAAS;YACzDhB;YAAkDA;QAAzD,QAAOA,QAAAA,KAAKgB,QAAQC,KAAK,EAAe,2BAAjCjB,mBAAAA,SAAkDA,SAAAA,KAAKgB,QAAQC,KAAK,EAAe,0BAAjCjB,6BAAAA,OAA+CU,OAAO,CAAC,UAAU;IAC5H;IACA,OAAOL;AACT;AAEA,OAAO,eAAemB,aAAaC,IAAe,EAAEC,EAAU,EAAEC,IAAe;QAe5DC,MA2CEnC;IAzDnB,MAAM,EAAEoC,KAAK,EAAE,GAAGJ;IAClB,wGAAwG;IACxG,MAAMK,kBAAkB;QAAC;QAAQ;QAAW;QAAQ;QAAM;QAAM;KAAM;IACtE,MAAMC,SAASJ,SAAS,SAAS,SAAS;IAC1C,MAAMK,aAAa;QAAEC,QAAQ;QAAeP;QAAIK;IAAO;IACvD,MAAMG,OAAOH,WAAW,aAAa,MAAMF,MAAMM,KAAK,CAACC,QAAQ,CAACC,GAAG,CAAC;QAAE,GAAGL,UAAU;QAAEF;IAAgB,KAAK,MAAMD,MAAMM,KAAK,CAACC,QAAQ,CAACC,GAAG,CAACL;IACzI,MAAMV,OAAOY,iBAAAA,2BAAAA,KAAMZ,IAAI;IACvB,MAAMzB,UAAUyB,QAAQ,OAAOA,SAAS,YAAY,aAAaA,QAAQA,KAAKN,OAAO,IAAI,OAAOM,KAAKN,OAAO,KAAK,YAAY,aAAaM,KAAKN,OAAO,GAAIM,KAAKN,OAAO,CAACnB,OAAO,GAA4DQ;IAC1O,MAAMiC,UAAU1C,cAAcC,SAAS;IACvC,MAAM+B,UAAUhC,cAAcC,SAAS;IACvC,MAAM0C,QAAQ3C,cAAcC,SAAS;IACrC,MAAM2C,QAAQ5C,cAAcC,SAAS;IACrC,MAAM4C,SAAS7C,cAAcC,SAAS;IAEtC,MAAM6C,WAAWd,OAAAA,UAAWjC,YAAYiC,WAAiCvB,uBAAxDuB,kBAAAA,OAAsEvB;IACvF,MAAMsC,QAAQJ,QAAQ7C,cAAc6C,SAAS,EAAE;IAC/C,MAAMK,QAAQJ,QAAQ9C,cAAc8C,SAAS,EAAE;IAC/C,MAAMK,SAASJ,SAAS/C,cAAc+C,UAAU,EAAE;IAElD,MAAMK,QAAQ;QACZ,IAAIxB,QAAQ,OAAOA,SAAS,YAAY,QAAQA,MAAM;gBACtCA;YAAd,OAAOb,QAAOa,WAAAA,KAAKI,EAAE,cAAPJ,sBAAAA,WAAWI;QAC3B;QACA,OAAOA;IACT;IAEA,MAAMqB,cAAc;QAClB,IAAIzB,QAAQ,OAAOA,SAAS,YAAY,cAAcA,QAAQA,KAAK0B,QAAQ,EAAE;YAC3E,OAAOvC,OAAOa,KAAK0B,QAAQ;QAC7B;QACA,OAAO3C;IACT;IAEA,MAAM4C,aAAa;QACjB,IAAI3B,QAAQ,OAAOA,SAAS,YAAY,aAAaA,QAAQA,KAAK4B,OAAO,EAAE;YACzE,OAAOzC,OAAOa,KAAK4B,OAAO;QAC5B;QACA,OAAO7C;IACT;IAEA,MAAM8C,cAAc;QAClB,IAAI7B,QAAQ,OAAOA,SAAS,YAAY,cAAcA,QAAQ8B,MAAMC,OAAO,CAAC/B,KAAKgC,QAAQ,GAAG;YAC1F,OAAOhC,KAAKgC,QAAQ,CAACC,GAAG,CAAC9C;QAC3B;QACA,OAAOJ;IACT;IAEA,MAAMmD,aAAa;QACjB,IAAIlC,QAAQ,OAAOA,SAAS,YAAY,aAAaA,MAAM;YACzD,OAAOA,KAAKN,OAAO;QACrB;QACA,OAAOX;IACT;IAEA,MAAMoD,MAAyB;QAC7B/B,IAAIoB;QACJE,UAAUD;QACVW,MAAMpB,WAAW7C,YAAAA,SAAS6C,sBAAT7C,uBAAAA,YAAqB6C,UAAWjC;QACjDsD,SAAS/D,cAAcC,SAAS;QAChCgB,MAAM6B;QACNkB,IAAIjB,MAAMhC,MAAM,GAAGgC,QAAQtC;QAC3BwD,IAAIjB,MAAMjC,MAAM,GAAGiC,QAAQvC;QAC3ByD,KAAKjB,OAAOlC,MAAM,GAAGkC,SAASxC;QAC9B6C,SAASD;QACTc,QAAQZ;IACV;IACA,IAAIxB,SAAS,QAAQ;QACnB,MAAMN,OAAON,YAAYyC;QACzB,IAAInC,MAAMoC,IAAIpC,IAAI,GAAGA;IACvB;IACA,OAAOoC;AACT"}

package/dist/esm/email/messages/messages.d.ts

@@ -1,5 +1,5 @@
+import type { gmail_v1 } from '@googleapis/gmail';
 import { buildContentForItems } from '@mcp-z/email';
-import type { gmail_v1 } from 'googleapis';
 export { buildContentForItems };
 export declare function toRowFromGmail(msg?: gmail_v1.Schema$Message, opts?: {
     body?: boolean;

package/dist/esm/email/messages/messages.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-gmail/src/email/messages/messages.ts"],"sourcesContent":["import { buildContentForItems } from '@mcp-z/email';\nimport type { gmail_v1 } from 'googleapis';\nimport { safeBase64Decode } from '../../lib/base64-encoding.ts';\nimport { toIsoUtc } from '../../lib/date-conversion.ts';\nimport { extractEmails, extractFrom } from '../parsing/headers-utils.ts';\n\nexport { buildContentForItems };\n\n// Convert a Gmail messages.get() response into canonical row shape used by sheets writer\n// [id, provider, threadId, to, from, cc, bcc, date, subject, labels, snippet, body]\nexport function toRowFromGmail(msg: gmail_v1.Schema$Message = {}, opts: { body?: boolean; addressFormat?: 'email' | string } = { body: false, addressFormat: 'email' }) {\n  const headers = msg?.payload?.headers || [];\n  const headerObj: Record<string, string> = Object.fromEntries((headers || []).map((h) => [String(h?.name ?? ''), String(h?.value ?? '')]));\n  const id = msg?.id ?? '';\n  const provider = 'gmail';\n  const threadId = msg?.threadId ?? '';\n  const to = extractEmails(headerObj.To ?? '').join(', ');\n  const fromInfo = extractFrom(headerObj.From ?? '');\n  const from = ((fromInfo && fromInfo.address) || headerObj.From) ?? '';\n  const cc = extractEmails(headerObj.Cc ?? '').join(', ');\n  const bcc = extractEmails(headerObj.Bcc ?? '').join(', ');\n  const date = (toIsoUtc(headerObj.Date) || headerObj.Date) ?? '';\n  const subject = headerObj.Subject ?? '';\n  const labelIds = Array.isArray(msg?.labelIds) ? (msg.labelIds as string[]) : [];\n  const labels = labelIds.join(';');\n  const snippet = msg?.snippet ?? '';\n\n  let bodyFull = '';\n  if (opts?.body) {\n    const parts = msg?.payload?.parts || [];\n    const findText = (partsArr: unknown[]): string | null => {\n      for (const p of partsArr || []) {\n        if (p && typeof p === 'object' && 'mimeType' in p && 'body' in p) {\n          if (p.mimeType === 'text/plain' && p.body && typeof p.body === 'object' && 'data' in p.body) {\n            return p.body.data as string;\n          }\n        }\n        if (p && typeof p === 'object' && 'parts' in p) {\n          const nested = findText(p.parts as unknown[]);\n          if (nested) return nested;\n        }\n      }\n      return null;\n    };\n    const raw = findText(parts as unknown[]) || (msg?.payload?.body && typeof msg.payload.body === 'object' && 'data' in msg.payload.body ? msg.payload.body.data : null) || null;\n    if (raw) {\n      bodyFull = safeBase64Decode(raw as string);\n    } else {\n      const findHtml = (partsArr: unknown[]): string | null => {\n        for (const p of partsArr || []) {\n          if (p && typeof p === 'object' && 'mimeType' in p && 'body' in p) {\n            if (p.mimeType === 'text/html' && p.body && typeof p.body === 'object' && 'data' in p.body) {\n              return p.body.data as string;\n            }\n          }\n          if (p && typeof p === 'object' && 'parts' in p) {\n            const nested = findHtml(p.parts as unknown[]);\n            if (nested) return nested;\n          }\n        }\n        return null;\n      };\n      const htmlPart = findHtml(parts as unknown[]);\n      if (htmlPart) {\n        bodyFull = safeBase64Decode(htmlPart).replace(/\\r\\n?/g, '\\n');\n      }\n    }\n  }\n  return [id, provider, threadId, to, from, cc, bcc, date, subject, labels, snippet, bodyFull];\n}\n"],"names":["buildContentForItems","safeBase64Decode","toIsoUtc","extractEmails","extractFrom","toRowFromGmail","msg","opts","body","addressFormat","headerObj","headers","payload","Object","fromEntries","map","h","String","name","value","id","provider","threadId","to","To","join","fromInfo","From","from","address","cc","Cc","bcc","Bcc","date","Date","subject","Subject","labelIds","Array","isArray","labels","snippet","bodyFull","parts","findText","partsArr","p","mimeType","data","nested","raw","findHtml","htmlPart","replace"],"mappings":"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"}
+{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-gmail/src/email/messages/messages.ts"],"sourcesContent":["import type { gmail_v1 } from '@googleapis/gmail';\nimport { buildContentForItems } from '@mcp-z/email';\nimport { safeBase64Decode } from '../../lib/base64-encoding.ts';\nimport { toIsoUtc } from '../../lib/date-conversion.ts';\nimport { extractEmails, extractFrom } from '../parsing/headers-utils.ts';\n\nexport { buildContentForItems };\n\n// Convert a Gmail messages.get() response into canonical row shape used by sheets writer\n// [id, provider, threadId, to, from, cc, bcc, date, subject, labels, snippet, body]\nexport function toRowFromGmail(msg: gmail_v1.Schema$Message = {}, opts: { body?: boolean; addressFormat?: 'email' | string } = { body: false, addressFormat: 'email' }) {\n  const headers = msg?.payload?.headers || [];\n  const headerObj: Record<string, string> = Object.fromEntries((headers || []).map((h) => [String(h?.name ?? ''), String(h?.value ?? '')]));\n  const id = msg?.id ?? '';\n  const provider = 'gmail';\n  const threadId = msg?.threadId ?? '';\n  const to = extractEmails(headerObj.To ?? '').join(', ');\n  const fromInfo = extractFrom(headerObj.From ?? '');\n  const from = ((fromInfo && fromInfo.address) || headerObj.From) ?? '';\n  const cc = extractEmails(headerObj.Cc ?? '').join(', ');\n  const bcc = extractEmails(headerObj.Bcc ?? '').join(', ');\n  const date = (toIsoUtc(headerObj.Date) || headerObj.Date) ?? '';\n  const subject = headerObj.Subject ?? '';\n  const labelIds = Array.isArray(msg?.labelIds) ? (msg.labelIds as string[]) : [];\n  const labels = labelIds.join(';');\n  const snippet = msg?.snippet ?? '';\n\n  let bodyFull = '';\n  if (opts?.body) {\n    const parts = msg?.payload?.parts || [];\n    const findText = (partsArr: unknown[]): string | null => {\n      for (const p of partsArr || []) {\n        if (p && typeof p === 'object' && 'mimeType' in p && 'body' in p) {\n          if (p.mimeType === 'text/plain' && p.body && typeof p.body === 'object' && 'data' in p.body) {\n            return p.body.data as string;\n          }\n        }\n        if (p && typeof p === 'object' && 'parts' in p) {\n          const nested = findText(p.parts as unknown[]);\n          if (nested) return nested;\n        }\n      }\n      return null;\n    };\n    const raw = findText(parts as unknown[]) || (msg?.payload?.body && typeof msg.payload.body === 'object' && 'data' in msg.payload.body ? msg.payload.body.data : null) || null;\n    if (raw) {\n      bodyFull = safeBase64Decode(raw as string);\n    } else {\n      const findHtml = (partsArr: unknown[]): string | null => {\n        for (const p of partsArr || []) {\n          if (p && typeof p === 'object' && 'mimeType' in p && 'body' in p) {\n            if (p.mimeType === 'text/html' && p.body && typeof p.body === 'object' && 'data' in p.body) {\n              return p.body.data as string;\n            }\n          }\n          if (p && typeof p === 'object' && 'parts' in p) {\n            const nested = findHtml(p.parts as unknown[]);\n            if (nested) return nested;\n          }\n        }\n        return null;\n      };\n      const htmlPart = findHtml(parts as unknown[]);\n      if (htmlPart) {\n        bodyFull = safeBase64Decode(htmlPart).replace(/\\r\\n?/g, '\\n');\n      }\n    }\n  }\n  return [id, provider, threadId, to, from, cc, bcc, date, subject, labels, snippet, bodyFull];\n}\n"],"names":["buildContentForItems","safeBase64Decode","toIsoUtc","extractEmails","extractFrom","toRowFromGmail","msg","opts","body","addressFormat","headerObj","headers","payload","Object","fromEntries","map","h","String","name","value","id","provider","threadId","to","To","join","fromInfo","From","from","address","cc","Cc","bcc","Bcc","date","Date","subject","Subject","labelIds","Array","isArray","labels","snippet","bodyFull","parts","findText","partsArr","p","mimeType","data","nested","raw","findHtml","htmlPart","replace"],"mappings":"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"}

package/dist/esm/email/parsing/html-processing.d.ts

@@ -1,4 +1,4 @@
-import type { gmail_v1 } from 'googleapis';
+import type { gmail_v1 } from '@googleapis/gmail';
 export interface BodyExtractionOptions {
     /** Format to return: 'text' extracts plain text, 'html' preserves HTML structure */
     contentType?: 'text' | 'html';

package/dist/esm/email/parsing/html-processing.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-gmail/src/email/parsing/html-processing.ts"],"sourcesContent":["import { extractCurrentMessageFromHtml } from '@mcp-z/email';\nimport type { gmail_v1 } from 'googleapis';\nimport { parse } from 'node-html-parser';\n\nexport interface BodyExtractionOptions {\n  /** Format to return: 'text' extracts plain text, 'html' preserves HTML structure */\n  contentType?: 'text' | 'html';\n  /** When true, removes quoted thread history from HTML content */\n  excludeThreadHistory?: boolean;\n}\n\nexport function extractBodyFromPayload(payload: gmail_v1.Schema$MessagePart, options: BodyExtractionOptions = {}): string {\n  const { contentType = 'text', excludeThreadHistory = false } = options;\n  if (!payload) return '';\n\n  // If there's a direct body with data\n  if (payload.body?.data) {\n    return Buffer.from(payload.body.data, 'base64').toString('utf-8');\n  }\n\n  // If there are parts, look for text/plain or text/html\n  if (payload.parts && Array.isArray(payload.parts)) {\n    for (const part of payload.parts) {\n      if (part.mimeType === 'text/plain' && part.body?.data) {\n        return Buffer.from(part.body.data, 'base64').toString('utf-8');\n      }\n      if (part.mimeType === 'text/html' && part.body?.data) {\n        let html = Buffer.from(part.body.data, 'base64').toString('utf-8');\n\n        // Remove thread history if requested\n        if (excludeThreadHistory) {\n          html = extractCurrentMessageFromHtml(html);\n        }\n\n        // Return HTML directly if requested\n        if (contentType === 'html') {\n          return html;\n        }\n\n        // Otherwise extract plain text from HTML\n        const doc = parse(html);\n        const docUnknown = doc as unknown;\n        if (docUnknown && typeof docUnknown === 'object' && 'text' in docUnknown) {\n          return docUnknown.text as string;\n        }\n        return '';\n      }\n    }\n  }\n\n  return '';\n}\n"],"names":["extractCurrentMessageFromHtml","parse","extractBodyFromPayload","payload","options","contentType","excludeThreadHistory","body","data","Buffer","from","toString","parts","Array","isArray","part","mimeType","html","doc","docUnknown","text"],"mappings":"AAAA,SAASA,6BAA6B,QAAQ,eAAe;AAE7D,SAASC,KAAK,QAAQ,mBAAmB;AASzC,OAAO,SAASC,uBAAuBC,OAAoC,EAAEC,UAAiC,CAAC,CAAC;QAK1GD;IAJJ,MAAM,EAAEE,cAAc,MAAM,EAAEC,uBAAuB,KAAK,EAAE,GAAGF;IAC/D,IAAI,CAACD,SAAS,OAAO;IAErB,qCAAqC;IACrC,KAAIA,gBAAAA,QAAQI,IAAI,cAAZJ,oCAAAA,cAAcK,IAAI,EAAE;QACtB,OAAOC,OAAOC,IAAI,CAACP,QAAQI,IAAI,CAACC,IAAI,EAAE,UAAUG,QAAQ,CAAC;IAC3D;IAEA,uDAAuD;IACvD,IAAIR,QAAQS,KAAK,IAAIC,MAAMC,OAAO,CAACX,QAAQS,KAAK,GAAG;QACjD,KAAK,MAAMG,QAAQZ,QAAQS,KAAK,CAAE;gBACMG,YAGDA;YAHrC,IAAIA,KAAKC,QAAQ,KAAK,kBAAgBD,aAAAA,KAAKR,IAAI,cAATQ,iCAAAA,WAAWP,IAAI,GAAE;gBACrD,OAAOC,OAAOC,IAAI,CAACK,KAAKR,IAAI,CAACC,IAAI,EAAE,UAAUG,QAAQ,CAAC;YACxD;YACA,IAAII,KAAKC,QAAQ,KAAK,iBAAeD,cAAAA,KAAKR,IAAI,cAATQ,kCAAAA,YAAWP,IAAI,GAAE;gBACpD,IAAIS,OAAOR,OAAOC,IAAI,CAACK,KAAKR,IAAI,CAACC,IAAI,EAAE,UAAUG,QAAQ,CAAC;gBAE1D,qCAAqC;gBACrC,IAAIL,sBAAsB;oBACxBW,OAAOjB,8BAA8BiB;gBACvC;gBAEA,oCAAoC;gBACpC,IAAIZ,gBAAgB,QAAQ;oBAC1B,OAAOY;gBACT;gBAEA,yCAAyC;gBACzC,MAAMC,MAAMjB,MAAMgB;gBAClB,MAAME,aAAaD;gBACnB,IAAIC,cAAc,OAAOA,eAAe,YAAY,UAAUA,YAAY;oBACxE,OAAOA,WAAWC,IAAI;gBACxB;gBACA,OAAO;YACT;QACF;IACF;IAEA,OAAO;AACT"}
+{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-gmail/src/email/parsing/html-processing.ts"],"sourcesContent":["import type { gmail_v1 } from '@googleapis/gmail';\nimport { extractCurrentMessageFromHtml } from '@mcp-z/email';\nimport { parse } from 'node-html-parser';\n\nexport interface BodyExtractionOptions {\n  /** Format to return: 'text' extracts plain text, 'html' preserves HTML structure */\n  contentType?: 'text' | 'html';\n  /** When true, removes quoted thread history from HTML content */\n  excludeThreadHistory?: boolean;\n}\n\nexport function extractBodyFromPayload(payload: gmail_v1.Schema$MessagePart, options: BodyExtractionOptions = {}): string {\n  const { contentType = 'text', excludeThreadHistory = false } = options;\n  if (!payload) return '';\n\n  // If there's a direct body with data\n  if (payload.body?.data) {\n    return Buffer.from(payload.body.data, 'base64').toString('utf-8');\n  }\n\n  // If there are parts, look for text/plain or text/html\n  if (payload.parts && Array.isArray(payload.parts)) {\n    for (const part of payload.parts) {\n      if (part.mimeType === 'text/plain' && part.body?.data) {\n        return Buffer.from(part.body.data, 'base64').toString('utf-8');\n      }\n      if (part.mimeType === 'text/html' && part.body?.data) {\n        let html = Buffer.from(part.body.data, 'base64').toString('utf-8');\n\n        // Remove thread history if requested\n        if (excludeThreadHistory) {\n          html = extractCurrentMessageFromHtml(html);\n        }\n\n        // Return HTML directly if requested\n        if (contentType === 'html') {\n          return html;\n        }\n\n        // Otherwise extract plain text from HTML\n        const doc = parse(html);\n        const docUnknown = doc as unknown;\n        if (docUnknown && typeof docUnknown === 'object' && 'text' in docUnknown) {\n          return docUnknown.text as string;\n        }\n        return '';\n      }\n    }\n  }\n\n  return '';\n}\n"],"names":["extractCurrentMessageFromHtml","parse","extractBodyFromPayload","payload","options","contentType","excludeThreadHistory","body","data","Buffer","from","toString","parts","Array","isArray","part","mimeType","html","doc","docUnknown","text"],"mappings":"AACA,SAASA,6BAA6B,QAAQ,eAAe;AAC7D,SAASC,KAAK,QAAQ,mBAAmB;AASzC,OAAO,SAASC,uBAAuBC,OAAoC,EAAEC,UAAiC,CAAC,CAAC;QAK1GD;IAJJ,MAAM,EAAEE,cAAc,MAAM,EAAEC,uBAAuB,KAAK,EAAE,GAAGF;IAC/D,IAAI,CAACD,SAAS,OAAO;IAErB,qCAAqC;IACrC,KAAIA,gBAAAA,QAAQI,IAAI,cAAZJ,oCAAAA,cAAcK,IAAI,EAAE;QACtB,OAAOC,OAAOC,IAAI,CAACP,QAAQI,IAAI,CAACC,IAAI,EAAE,UAAUG,QAAQ,CAAC;IAC3D;IAEA,uDAAuD;IACvD,IAAIR,QAAQS,KAAK,IAAIC,MAAMC,OAAO,CAACX,QAAQS,KAAK,GAAG;QACjD,KAAK,MAAMG,QAAQZ,QAAQS,KAAK,CAAE;gBACMG,YAGDA;YAHrC,IAAIA,KAAKC,QAAQ,KAAK,kBAAgBD,aAAAA,KAAKR,IAAI,cAATQ,iCAAAA,WAAWP,IAAI,GAAE;gBACrD,OAAOC,OAAOC,IAAI,CAACK,KAAKR,IAAI,CAACC,IAAI,EAAE,UAAUG,QAAQ,CAAC;YACxD;YACA,IAAII,KAAKC,QAAQ,KAAK,iBAAeD,cAAAA,KAAKR,IAAI,cAATQ,kCAAAA,YAAWP,IAAI,GAAE;gBACpD,IAAIS,OAAOR,OAAOC,IAAI,CAACK,KAAKR,IAAI,CAACC,IAAI,EAAE,UAAUG,QAAQ,CAAC;gBAE1D,qCAAqC;gBACrC,IAAIL,sBAAsB;oBACxBW,OAAOjB,8BAA8BiB;gBACvC;gBAEA,oCAAoC;gBACpC,IAAIZ,gBAAgB,QAAQ;oBAC1B,OAAOY;gBACT;gBAEA,yCAAyC;gBACzC,MAAMC,MAAMjB,MAAMgB;gBAClB,MAAME,aAAaD;gBACnB,IAAIC,cAAc,OAAOA,eAAe,YAAY,UAAUA,YAAY;oBACxE,OAAOA,WAAWC,IAAI;gBACxB;gBACA,OAAO;YACT;QACF;IACF;IAEA,OAAO;AACT"}

package/dist/esm/email/querying/execute-query.d.ts

@@ -1,5 +1,5 @@
+import type { gmail_v1 } from '@googleapis/gmail';
 import type { ExecutionResult } from '@mcp-z/email';
-import type { gmail_v1 } from 'googleapis';
 import type { GmailQuery as QueryNode } from '../../schemas/gmail-query-schema.js';
 import type { Logger } from '../../types.js';
 export interface ExecuteQueryOptions {

package/dist/esm/email/querying/execute-query.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-gmail/src/email/querying/execute-query.ts"],"sourcesContent":["import type { ExecutionResult } from '@mcp-z/email';\nimport type { gmail_v1 } from 'googleapis';\nimport { MAX_PAGE_SIZE } from '../../constants.ts';\nimport type { GmailQuery as QueryNode } from '../../schemas/gmail-query-schema.ts';\nimport type { Logger } from '../../types.ts';\nimport { searchMessages } from './search-execution.ts';\n\nexport interface ExecuteQueryOptions {\n  client: gmail_v1.Gmail;\n  logger: Logger;\n  pageSize?: number;\n  pageToken?: string;\n  includeBody?: boolean;\n}\n\n/**\n * Execute a Gmail query with direct, single-attempt execution.\n * No planning, no fallbacks, no retries.\n * Provider errors are returned directly to the caller for actionable feedback.\n */\nexport async function executeQuery<T>(query: QueryNode | undefined, options: ExecuteQueryOptions, transform: (item: unknown) => T): Promise<ExecutionResult<T>> {\n  const { client, logger, pageSize, pageToken, includeBody } = options;\n\n  // Validate pagination parameters\n  if (pageSize !== undefined && (pageSize < 1 || pageSize > MAX_PAGE_SIZE)) {\n    throw new Error(`pageSize must be between 1 and ${MAX_PAGE_SIZE}`);\n  }\n\n  if (pageToken !== undefined && typeof pageToken === 'string' && pageToken.trim().length === 0) {\n    logger.info('Empty pageToken provided, ignoring');\n  }\n\n  // Single execution - direct query to Gmail API\n  logger.info('executeQuery: executing direct Gmail query');\n\n  try {\n    const result = await searchMessages(client, {\n      ...(query !== undefined && { query }),\n      pageSize: pageSize ?? 50,\n      pageToken: pageToken && pageToken.trim().length > 0 ? pageToken : undefined,\n      includeBody: includeBody ?? false,\n      logger,\n    });\n\n    // Transform results\n    const transformedResults = result.messages.map(transform);\n\n    logger.info(`executeQuery: succeeded with ${transformedResults.length} results`);\n\n    return {\n      success: true,\n      items: transformedResults,\n      metadata: {\n        nextPageToken: result.nextPageToken,\n      },\n    };\n  } catch (error) {\n    // Re-throw errors directly - no fallback logic\n    logger.error('executeQuery: failed', { error: error instanceof Error ? error.message : String(error) });\n    throw error;\n  }\n}\n"],"names":["MAX_PAGE_SIZE","searchMessages","executeQuery","query","options","transform","client","logger","pageSize","pageToken","includeBody","undefined","Error","trim","length","info","result","transformedResults","messages","map","success","items","metadata","nextPageToken","error","message","String"],"mappings":"AAEA,SAASA,aAAa,QAAQ,qBAAqB;AAGnD,SAASC,cAAc,QAAQ,wBAAwB;AAUvD;;;;CAIC,GACD,OAAO,eAAeC,aAAgBC,KAA4B,EAAEC,OAA4B,EAAEC,SAA+B;IAC/H,MAAM,EAAEC,MAAM,EAAEC,MAAM,EAAEC,QAAQ,EAAEC,SAAS,EAAEC,WAAW,EAAE,GAAGN;IAE7D,iCAAiC;IACjC,IAAII,aAAaG,aAAcH,CAAAA,WAAW,KAAKA,WAAWR,aAAY,GAAI;QACxE,MAAM,IAAIY,MAAM,CAAC,+BAA+B,EAAEZ,eAAe;IACnE;IAEA,IAAIS,cAAcE,aAAa,OAAOF,cAAc,YAAYA,UAAUI,IAAI,GAAGC,MAAM,KAAK,GAAG;QAC7FP,OAAOQ,IAAI,CAAC;IACd;IAEA,+CAA+C;IAC/CR,OAAOQ,IAAI,CAAC;IAEZ,IAAI;QACF,MAAMC,SAAS,MAAMf,eAAeK,QAAQ;YAC1C,GAAIH,UAAUQ,aAAa;gBAAER;YAAM,CAAC;YACpCK,QAAQ,EAAEA,qBAAAA,sBAAAA,WAAY;YACtBC,WAAWA,aAAaA,UAAUI,IAAI,GAAGC,MAAM,GAAG,IAAIL,YAAYE;YAClED,WAAW,EAAEA,wBAAAA,yBAAAA,cAAe;YAC5BH;QACF;QAEA,oBAAoB;QACpB,MAAMU,qBAAqBD,OAAOE,QAAQ,CAACC,GAAG,CAACd;QAE/CE,OAAOQ,IAAI,CAAC,CAAC,6BAA6B,EAAEE,mBAAmBH,MAAM,CAAC,QAAQ,CAAC;QAE/E,OAAO;YACLM,SAAS;YACTC,OAAOJ;YACPK,UAAU;gBACRC,eAAeP,OAAOO,aAAa;YACrC;QACF;IACF,EAAE,OAAOC,OAAO;QACd,+CAA+C;QAC/CjB,OAAOiB,KAAK,CAAC,wBAAwB;YAAEA,OAAOA,iBAAiBZ,QAAQY,MAAMC,OAAO,GAAGC,OAAOF;QAAO;QACrG,MAAMA;IACR;AACF"}
+{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-gmail/src/email/querying/execute-query.ts"],"sourcesContent":["import type { gmail_v1 } from '@googleapis/gmail';\nimport type { ExecutionResult } from '@mcp-z/email';\nimport { MAX_PAGE_SIZE } from '../../constants.ts';\nimport type { GmailQuery as QueryNode } from '../../schemas/gmail-query-schema.ts';\nimport type { Logger } from '../../types.ts';\nimport { searchMessages } from './search-execution.ts';\n\nexport interface ExecuteQueryOptions {\n  client: gmail_v1.Gmail;\n  logger: Logger;\n  pageSize?: number;\n  pageToken?: string;\n  includeBody?: boolean;\n}\n\n/**\n * Execute a Gmail query with direct, single-attempt execution.\n * No planning, no fallbacks, no retries.\n * Provider errors are returned directly to the caller for actionable feedback.\n */\nexport async function executeQuery<T>(query: QueryNode | undefined, options: ExecuteQueryOptions, transform: (item: unknown) => T): Promise<ExecutionResult<T>> {\n  const { client, logger, pageSize, pageToken, includeBody } = options;\n\n  // Validate pagination parameters\n  if (pageSize !== undefined && (pageSize < 1 || pageSize > MAX_PAGE_SIZE)) {\n    throw new Error(`pageSize must be between 1 and ${MAX_PAGE_SIZE}`);\n  }\n\n  if (pageToken !== undefined && typeof pageToken === 'string' && pageToken.trim().length === 0) {\n    logger.info('Empty pageToken provided, ignoring');\n  }\n\n  // Single execution - direct query to Gmail API\n  logger.info('executeQuery: executing direct Gmail query');\n\n  try {\n    const result = await searchMessages(client, {\n      ...(query !== undefined && { query }),\n      pageSize: pageSize ?? 50,\n      pageToken: pageToken && pageToken.trim().length > 0 ? pageToken : undefined,\n      includeBody: includeBody ?? false,\n      logger,\n    });\n\n    // Transform results\n    const transformedResults = result.messages.map(transform);\n\n    logger.info(`executeQuery: succeeded with ${transformedResults.length} results`);\n\n    return {\n      success: true,\n      items: transformedResults,\n      metadata: {\n        nextPageToken: result.nextPageToken,\n      },\n    };\n  } catch (error) {\n    // Re-throw errors directly - no fallback logic\n    logger.error('executeQuery: failed', { error: error instanceof Error ? error.message : String(error) });\n    throw error;\n  }\n}\n"],"names":["MAX_PAGE_SIZE","searchMessages","executeQuery","query","options","transform","client","logger","pageSize","pageToken","includeBody","undefined","Error","trim","length","info","result","transformedResults","messages","map","success","items","metadata","nextPageToken","error","message","String"],"mappings":"AAEA,SAASA,aAAa,QAAQ,qBAAqB;AAGnD,SAASC,cAAc,QAAQ,wBAAwB;AAUvD;;;;CAIC,GACD,OAAO,eAAeC,aAAgBC,KAA4B,EAAEC,OAA4B,EAAEC,SAA+B;IAC/H,MAAM,EAAEC,MAAM,EAAEC,MAAM,EAAEC,QAAQ,EAAEC,SAAS,EAAEC,WAAW,EAAE,GAAGN;IAE7D,iCAAiC;IACjC,IAAII,aAAaG,aAAcH,CAAAA,WAAW,KAAKA,WAAWR,aAAY,GAAI;QACxE,MAAM,IAAIY,MAAM,CAAC,+BAA+B,EAAEZ,eAAe;IACnE;IAEA,IAAIS,cAAcE,aAAa,OAAOF,cAAc,YAAYA,UAAUI,IAAI,GAAGC,MAAM,KAAK,GAAG;QAC7FP,OAAOQ,IAAI,CAAC;IACd;IAEA,+CAA+C;IAC/CR,OAAOQ,IAAI,CAAC;IAEZ,IAAI;QACF,MAAMC,SAAS,MAAMf,eAAeK,QAAQ;YAC1C,GAAIH,UAAUQ,aAAa;gBAAER;YAAM,CAAC;YACpCK,QAAQ,EAAEA,qBAAAA,sBAAAA,WAAY;YACtBC,WAAWA,aAAaA,UAAUI,IAAI,GAAGC,MAAM,GAAG,IAAIL,YAAYE;YAClED,WAAW,EAAEA,wBAAAA,yBAAAA,cAAe;YAC5BH;QACF;QAEA,oBAAoB;QACpB,MAAMU,qBAAqBD,OAAOE,QAAQ,CAACC,GAAG,CAACd;QAE/CE,OAAOQ,IAAI,CAAC,CAAC,6BAA6B,EAAEE,mBAAmBH,MAAM,CAAC,QAAQ,CAAC;QAE/E,OAAO;YACLM,SAAS;YACTC,OAAOJ;YACPK,UAAU;gBACRC,eAAeP,OAAOO,aAAa;YACrC;QACF;IACF,EAAE,OAAOC,OAAO;QACd,+CAA+C;QAC/CjB,OAAOiB,KAAK,CAAC,wBAAwB;YAAEA,OAAOA,iBAAiBZ,QAAQY,MAAMC,OAAO,GAAGC,OAAOF;QAAO;QACrG,MAAMA;IACR;AACF"}

package/dist/esm/email/querying/pagination.d.ts

@@ -1,5 +1,5 @@
 /** Gmail pagination helpers for single-page operations. */
-import type { gmail_v1 } from 'googleapis';
+import type { gmail_v1 } from '@googleapis/gmail';
 import type { Logger } from '../../types.js';
 export interface SinglePageResult {
     readonly messages: gmail_v1.Schema$Message[];