@mcp-z/mcp-gmail 2.1.0 → 2.2.0

package/dist/esm/email/querying/pagination.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-gmail/src/email/querying/pagination.ts"],"sourcesContent":["/** Gmail pagination helpers for single-page operations. */\n\nimport type { gmail_v1 } from 'googleapis';\nimport type { Logger } from '../../types.ts';\n\nexport interface SinglePageResult {\n  readonly messages: gmail_v1.Schema$Message[];\n  readonly nextPageToken: string | undefined;\n}\n\n/**\n * Fetch a single page of messages from Gmail\n */\nexport interface FetchMessagesPageParams {\n  readonly gmailQ: string;\n  readonly pageSize?: number;\n  readonly pageToken: string | undefined;\n  readonly body?: boolean;\n  readonly logger: Logger;\n  readonly metadataHeaders?: readonly string[];\n}\n\nexport async function fetchMessagesPage(gmail: gmail_v1.Gmail, params: FetchMessagesPageParams): Promise<SinglePageResult> {\n  const { gmailQ, pageSize = 50, pageToken, body = false, logger, metadataHeaders } = params;\n\n  // Secure resource bounds checking - prevent security bypasses\n  const maxPageSize = 500; // Gmail API maximum - enforced for security\n  const minPageSize = 1; // Minimum valid page size\n\n  // Validate input is a positive number to prevent bypass attempts\n  if (!Number.isInteger(pageSize) || pageSize < 0) {\n    throw new Error(`Invalid pageSize: must be a positive integer, got ${pageSize}`);\n  }\n\n  const safePageSize = Math.min(Math.max(minPageSize, pageSize), maxPageSize);\n\n  if (pageSize !== safePageSize && logger) {\n    logger.info('Page size bounded for API safety', { requested: pageSize, applied: safePageSize });\n    // No fallback to console - would corrupt MCP stdio communication\n  }\n\n  try {\n    const listParams = {\n      userId: 'me',\n      q: gmailQ,\n      maxResults: safePageSize,\n    };\n    const listResponse = pageToken && pageToken.trim().length > 0 ? await gmail.users.messages.list({ ...listParams, pageToken }) : await gmail.users.messages.list(listParams);\n    const response = listResponse.data;\n    const messages = response.messages || [];\n\n    if (messages.length === 0) {\n      if (logger) logger.info('No messages found on page');\n      return { messages: [], nextPageToken: undefined };\n    }\n\n    const items = messages.map((m: gmail_v1.Schema$Message) => m.id).filter(Boolean) as string[];\n    if (items.length === 0) {\n      if (logger) logger.info('No valid message ids on page');\n      return { messages: [], nextPageToken: response.nextPageToken && response.nextPageToken.trim().length > 0 ? response.nextPageToken : undefined };\n    }\n\n    const concurrentArgs: FetchMessagesConcurrentlyParams = {\n      items,\n      concurrency: 5,\n      body,\n      ...(logger && { logger }),\n      ...(metadataHeaders && { metadataHeaders }),\n    };\n    const detailedMessages = await fetchMessagesConcurrently(gmail, concurrentArgs);\n\n    if (logger) logger.info(`Fetched page with ${detailedMessages.length} messages`);\n    return {\n      messages: detailedMessages,\n      nextPageToken: response.nextPageToken && response.nextPageToken.trim().length > 0 ? response.nextPageToken : undefined,\n    };\n  } catch (error) {\n    // Standardized error handling for pagination pipeline\n    const errorMessage = error instanceof Error ? error.message : String(error);\n    if (logger)\n      logger.error('Gmail pagination: single page fetch failed', {\n        error: errorMessage,\n        query: gmailQ,\n        pageSize: safePageSize,\n        hasPageToken: !!pageToken,\n      });\n\n    // Preserve original error type for upstream handling\n    if (error instanceof Error) {\n      // Enhance error with pagination context\n      error.message = `Gmail pagination fetch failed: ${error.message}`;\n      throw error;\n    }\n\n    // Convert non-Error objects to proper Error instances\n    throw new Error(`Gmail pagination fetch failed: ${errorMessage}`);\n  }\n}\n\nexport interface FetchMessagesConcurrentlyParams {\n  readonly items: readonly string[];\n  readonly concurrency?: number;\n  readonly body?: boolean;\n  readonly logger: Logger;\n  readonly metadataHeaders?: readonly string[];\n}\n\nexport async function fetchMessagesConcurrently(gmail: gmail_v1.Gmail, params: FetchMessagesConcurrentlyParams): Promise<gmail_v1.Schema$Message[]> {\n  const { items, concurrency = 2, body = false, logger, metadataHeaders } = params;\n\n  // Secure resource bounds checking for concurrent operations\n  const maxConcurrency = 10; // Conservative limit to prevent rate limiting and resource exhaustion\n  const minConcurrency = 1; // Minimum valid concurrency\n\n  // Validate input is a positive number to prevent bypass attempts\n  if (!Number.isInteger(concurrency) || concurrency < 0) {\n    throw new Error(`Invalid concurrency: must be a positive integer, got ${concurrency}`);\n  }\n\n  const safeConcurrency = Math.min(Math.max(minConcurrency, concurrency), maxConcurrency);\n\n  if (concurrency !== safeConcurrency && logger) {\n    logger.info('Concurrency bounded for API safety', { requested: concurrency, applied: safeConcurrency });\n    // No fallback to console - would corrupt MCP stdio communication\n  }\n\n  if (items.length === 0) return [];\n\n  const results: (gmail_v1.Schema$Message | null)[] = new Array(items.length);\n  const format = body ? 'full' : 'metadata';\n  // Always pass metadataHeaders if provided - body doesn't replace headers, it's additional content\n  const metadataHeadersForRequest = metadataHeaders;\n\n  // Pre-build request parameters to avoid repeated object creation\n  const requestParams = items.map((id) => {\n    const baseParams = {\n      userId: 'me' as const,\n      id,\n      format,\n    };\n    // Only include metadataHeaders if defined (exactOptionalPropertyTypes compliance)\n    return metadataHeadersForRequest ? { ...baseParams, metadataHeaders: [...metadataHeadersForRequest] } : baseParams;\n  });\n\n  // Optimize concurrent processing using batching\n  const batchSize = safeConcurrency;\n  const batches: (typeof requestParams)[] = [];\n  for (let i = 0; i < requestParams.length; i += batchSize) {\n    batches.push(requestParams.slice(i, i + batchSize));\n  }\n\n  let processedCount = 0;\n  for (const batch of batches) {\n    const batchPromises = batch.map(async (params, batchIndex) => {\n      try {\n        const messageResponse = await gmail.users.messages.get(params);\n        const globalIndex = processedCount + batchIndex;\n        results[globalIndex] = messageResponse.data;\n        return messageResponse.data;\n      } catch (error) {\n        // Log individual message fetch failures but continue processing\n        const errorMessage = error instanceof Error ? error.message : String(error);\n        if (logger)\n          logger.info('Gmail pagination: individual message fetch failed, continuing', {\n            error: errorMessage,\n            messageId: params.id,\n            globalIndex: processedCount + batchIndex,\n          });\n        return null; // Mark as failed but continue\n      }\n    });\n\n    await Promise.all(batchPromises);\n    processedCount += batch.length;\n\n    // Progress logging for large batches\n    if (items.length > 20) {\n      if (logger) logger.info(`Gmail pagination: processed ${processedCount}/${items.length} messages`);\n    }\n  }\n\n  // Filter out any null results from failed individual fetches\n  return results.filter((result) => result !== null && result !== undefined);\n}\n"],"names":["fetchMessagesPage","gmail","params","gmailQ","pageSize","pageToken","body","logger","metadataHeaders","maxPageSize","minPageSize","Number","isInteger","Error","safePageSize","Math","min","max","info","requested","applied","listParams","userId","q","maxResults","listResponse","trim","length","users","messages","list","response","data","nextPageToken","undefined","items","map","m","id","filter","Boolean","concurrentArgs","concurrency","detailedMessages","fetchMessagesConcurrently","error","errorMessage","message","String","query","hasPageToken","maxConcurrency","minConcurrency","safeConcurrency","results","Array","format","metadataHeadersForRequest","requestParams","baseParams","batchSize","batches","i","push","slice","processedCount","batch","batchPromises","batchIndex","messageResponse","get","globalIndex","messageId","Promise","all","result"],"mappings":"AAAA,yDAAyD,GAsBzD,OAAO,eAAeA,kBAAkBC,KAAqB,EAAEC,MAA+B;IAC5F,MAAM,EAAEC,MAAM,EAAEC,WAAW,EAAE,EAAEC,SAAS,EAAEC,OAAO,KAAK,EAAEC,MAAM,EAAEC,eAAe,EAAE,GAAGN;IAEpF,8DAA8D;IAC9D,MAAMO,cAAc,KAAK,4CAA4C;IACrE,MAAMC,cAAc,GAAG,0BAA0B;IAEjD,iEAAiE;IACjE,IAAI,CAACC,OAAOC,SAAS,CAACR,aAAaA,WAAW,GAAG;QAC/C,MAAM,IAAIS,MAAM,CAAC,kDAAkD,EAAET,UAAU;IACjF;IAEA,MAAMU,eAAeC,KAAKC,GAAG,CAACD,KAAKE,GAAG,CAACP,aAAaN,WAAWK;IAE/D,IAAIL,aAAaU,gBAAgBP,QAAQ;QACvCA,OAAOW,IAAI,CAAC,oCAAoC;YAAEC,WAAWf;YAAUgB,SAASN;QAAa;IAC7F,iEAAiE;IACnE;IAEA,IAAI;QACF,MAAMO,aAAa;YACjBC,QAAQ;YACRC,GAAGpB;YACHqB,YAAYV;QACd;QACA,MAAMW,eAAepB,aAAaA,UAAUqB,IAAI,GAAGC,MAAM,GAAG,IAAI,MAAM1B,MAAM2B,KAAK,CAACC,QAAQ,CAACC,IAAI,CAAC;YAAE,GAAGT,UAAU;YAAEhB;QAAU,KAAK,MAAMJ,MAAM2B,KAAK,CAACC,QAAQ,CAACC,IAAI,CAACT;QAChK,MAAMU,WAAWN,aAAaO,IAAI;QAClC,MAAMH,WAAWE,SAASF,QAAQ,IAAI,EAAE;QAExC,IAAIA,SAASF,MAAM,KAAK,GAAG;YACzB,IAAIpB,QAAQA,OAAOW,IAAI,CAAC;YACxB,OAAO;gBAAEW,UAAU,EAAE;gBAAEI,eAAeC;YAAU;QAClD;QAEA,MAAMC,QAAQN,SAASO,GAAG,CAAC,CAACC,IAA+BA,EAAEC,EAAE,EAAEC,MAAM,CAACC;QACxE,IAAIL,MAAMR,MAAM,KAAK,GAAG;YACtB,IAAIpB,QAAQA,OAAOW,IAAI,CAAC;YACxB,OAAO;gBAAEW,UAAU,EAAE;gBAAEI,eAAeF,SAASE,aAAa,IAAIF,SAASE,aAAa,CAACP,IAAI,GAAGC,MAAM,GAAG,IAAII,SAASE,aAAa,GAAGC;YAAU;QAChJ;QAEA,MAAMO,iBAAkD;YACtDN;YACAO,aAAa;YACbpC;YACA,GAAIC,UAAU;gBAAEA;YAAO,CAAC;YACxB,GAAIC,mBAAmB;gBAAEA;YAAgB,CAAC;QAC5C;QACA,MAAMmC,mBAAmB,MAAMC,0BAA0B3C,OAAOwC;QAEhE,IAAIlC,QAAQA,OAAOW,IAAI,CAAC,CAAC,kBAAkB,EAAEyB,iBAAiBhB,MAAM,CAAC,SAAS,CAAC;QAC/E,OAAO;YACLE,UAAUc;YACVV,eAAeF,SAASE,aAAa,IAAIF,SAASE,aAAa,CAACP,IAAI,GAAGC,MAAM,GAAG,IAAII,SAASE,aAAa,GAAGC;QAC/G;IACF,EAAE,OAAOW,OAAO;QACd,sDAAsD;QACtD,MAAMC,eAAeD,iBAAiBhC,QAAQgC,MAAME,OAAO,GAAGC,OAAOH;QACrE,IAAItC,QACFA,OAAOsC,KAAK,CAAC,8CAA8C;YACzDA,OAAOC;YACPG,OAAO9C;YACPC,UAAUU;YACVoC,cAAc,CAAC,CAAC7C;QAClB;QAEF,qDAAqD;QACrD,IAAIwC,iBAAiBhC,OAAO;YAC1B,wCAAwC;YACxCgC,MAAME,OAAO,GAAG,CAAC,+BAA+B,EAAEF,MAAME,OAAO,EAAE;YACjE,MAAMF;QACR;QAEA,sDAAsD;QACtD,MAAM,IAAIhC,MAAM,CAAC,+BAA+B,EAAEiC,cAAc;IAClE;AACF;AAUA,OAAO,eAAeF,0BAA0B3C,KAAqB,EAAEC,MAAuC;IAC5G,MAAM,EAAEiC,KAAK,EAAEO,cAAc,CAAC,EAAEpC,OAAO,KAAK,EAAEC,MAAM,EAAEC,eAAe,EAAE,GAAGN;IAE1E,4DAA4D;IAC5D,MAAMiD,iBAAiB,IAAI,sEAAsE;IACjG,MAAMC,iBAAiB,GAAG,4BAA4B;IAEtD,iEAAiE;IACjE,IAAI,CAACzC,OAAOC,SAAS,CAAC8B,gBAAgBA,cAAc,GAAG;QACrD,MAAM,IAAI7B,MAAM,CAAC,qDAAqD,EAAE6B,aAAa;IACvF;IAEA,MAAMW,kBAAkBtC,KAAKC,GAAG,CAACD,KAAKE,GAAG,CAACmC,gBAAgBV,cAAcS;IAExE,IAAIT,gBAAgBW,mBAAmB9C,QAAQ;QAC7CA,OAAOW,IAAI,CAAC,sCAAsC;YAAEC,WAAWuB;YAAatB,SAASiC;QAAgB;IACrG,iEAAiE;IACnE;IAEA,IAAIlB,MAAMR,MAAM,KAAK,GAAG,OAAO,EAAE;IAEjC,MAAM2B,UAA8C,IAAIC,MAAMpB,MAAMR,MAAM;IAC1E,MAAM6B,SAASlD,OAAO,SAAS;IAC/B,kGAAkG;IAClG,MAAMmD,4BAA4BjD;IAElC,iEAAiE;IACjE,MAAMkD,gBAAgBvB,MAAMC,GAAG,CAAC,CAACE;QAC/B,MAAMqB,aAAa;YACjBrC,QAAQ;YACRgB;YACAkB;QACF;QACA,kFAAkF;QAClF,OAAOC,4BAA4B;YAAE,GAAGE,UAAU;YAAEnD,iBAAiB;mBAAIiD;aAA0B;QAAC,IAAIE;IAC1G;IAEA,gDAAgD;IAChD,MAAMC,YAAYP;IAClB,MAAMQ,UAAoC,EAAE;IAC5C,IAAK,IAAIC,IAAI,GAAGA,IAAIJ,cAAc/B,MAAM,EAAEmC,KAAKF,UAAW;QACxDC,QAAQE,IAAI,CAACL,cAAcM,KAAK,CAACF,GAAGA,IAAIF;IAC1C;IAEA,IAAIK,iBAAiB;IACrB,KAAK,MAAMC,SAASL,QAAS;QAC3B,MAAMM,gBAAgBD,MAAM9B,GAAG,CAAC,OAAOlC,QAAQkE;YAC7C,IAAI;gBACF,MAAMC,kBAAkB,MAAMpE,MAAM2B,KAAK,CAACC,QAAQ,CAACyC,GAAG,CAACpE;gBACvD,MAAMqE,cAAcN,iBAAiBG;gBACrCd,OAAO,CAACiB,YAAY,GAAGF,gBAAgBrC,IAAI;gBAC3C,OAAOqC,gBAAgBrC,IAAI;YAC7B,EAAE,OAAOa,OAAO;gBACd,gEAAgE;gBAChE,MAAMC,eAAeD,iBAAiBhC,QAAQgC,MAAME,OAAO,GAAGC,OAAOH;gBACrE,IAAItC,QACFA,OAAOW,IAAI,CAAC,iEAAiE;oBAC3E2B,OAAOC;oBACP0B,WAAWtE,OAAOoC,EAAE;oBACpBiC,aAAaN,iBAAiBG;gBAChC;gBACF,OAAO,MAAM,8BAA8B;YAC7C;QACF;QAEA,MAAMK,QAAQC,GAAG,CAACP;QAClBF,kBAAkBC,MAAMvC,MAAM;QAE9B,qCAAqC;QACrC,IAAIQ,MAAMR,MAAM,GAAG,IAAI;YACrB,IAAIpB,QAAQA,OAAOW,IAAI,CAAC,CAAC,4BAA4B,EAAE+C,eAAe,CAAC,EAAE9B,MAAMR,MAAM,CAAC,SAAS,CAAC;QAClG;IACF;IAEA,6DAA6D;IAC7D,OAAO2B,QAAQf,MAAM,CAAC,CAACoC,SAAWA,WAAW,QAAQA,WAAWzC;AAClE"}
+{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-gmail/src/email/querying/pagination.ts"],"sourcesContent":["/** Gmail pagination helpers for single-page operations. */\n\nimport type { gmail_v1 } from '@googleapis/gmail';\nimport type { Logger } from '../../types.ts';\n\nexport interface SinglePageResult {\n  readonly messages: gmail_v1.Schema$Message[];\n  readonly nextPageToken: string | undefined;\n}\n\n/**\n * Fetch a single page of messages from Gmail\n */\nexport interface FetchMessagesPageParams {\n  readonly gmailQ: string;\n  readonly pageSize?: number;\n  readonly pageToken: string | undefined;\n  readonly body?: boolean;\n  readonly logger: Logger;\n  readonly metadataHeaders?: readonly string[];\n}\n\nexport async function fetchMessagesPage(gmail: gmail_v1.Gmail, params: FetchMessagesPageParams): Promise<SinglePageResult> {\n  const { gmailQ, pageSize = 50, pageToken, body = false, logger, metadataHeaders } = params;\n\n  // Secure resource bounds checking - prevent security bypasses\n  const maxPageSize = 500; // Gmail API maximum - enforced for security\n  const minPageSize = 1; // Minimum valid page size\n\n  // Validate input is a positive number to prevent bypass attempts\n  if (!Number.isInteger(pageSize) || pageSize < 0) {\n    throw new Error(`Invalid pageSize: must be a positive integer, got ${pageSize}`);\n  }\n\n  const safePageSize = Math.min(Math.max(minPageSize, pageSize), maxPageSize);\n\n  if (pageSize !== safePageSize && logger) {\n    logger.info('Page size bounded for API safety', { requested: pageSize, applied: safePageSize });\n    // No fallback to console - would corrupt MCP stdio communication\n  }\n\n  try {\n    const listParams = {\n      userId: 'me',\n      q: gmailQ,\n      maxResults: safePageSize,\n    };\n    const listResponse = pageToken && pageToken.trim().length > 0 ? await gmail.users.messages.list({ ...listParams, pageToken }) : await gmail.users.messages.list(listParams);\n    const response = listResponse.data;\n    const messages = response.messages || [];\n\n    if (messages.length === 0) {\n      if (logger) logger.info('No messages found on page');\n      return { messages: [], nextPageToken: undefined };\n    }\n\n    const items = messages.map((m: gmail_v1.Schema$Message) => m.id).filter(Boolean) as string[];\n    if (items.length === 0) {\n      if (logger) logger.info('No valid message ids on page');\n      return { messages: [], nextPageToken: response.nextPageToken && response.nextPageToken.trim().length > 0 ? response.nextPageToken : undefined };\n    }\n\n    const concurrentArgs: FetchMessagesConcurrentlyParams = {\n      items,\n      concurrency: 5,\n      body,\n      ...(logger && { logger }),\n      ...(metadataHeaders && { metadataHeaders }),\n    };\n    const detailedMessages = await fetchMessagesConcurrently(gmail, concurrentArgs);\n\n    if (logger) logger.info(`Fetched page with ${detailedMessages.length} messages`);\n    return {\n      messages: detailedMessages,\n      nextPageToken: response.nextPageToken && response.nextPageToken.trim().length > 0 ? response.nextPageToken : undefined,\n    };\n  } catch (error) {\n    // Standardized error handling for pagination pipeline\n    const errorMessage = error instanceof Error ? error.message : String(error);\n    if (logger)\n      logger.error('Gmail pagination: single page fetch failed', {\n        error: errorMessage,\n        query: gmailQ,\n        pageSize: safePageSize,\n        hasPageToken: !!pageToken,\n      });\n\n    // Preserve original error type for upstream handling\n    if (error instanceof Error) {\n      // Enhance error with pagination context\n      error.message = `Gmail pagination fetch failed: ${error.message}`;\n      throw error;\n    }\n\n    // Convert non-Error objects to proper Error instances\n    throw new Error(`Gmail pagination fetch failed: ${errorMessage}`);\n  }\n}\n\nexport interface FetchMessagesConcurrentlyParams {\n  readonly items: readonly string[];\n  readonly concurrency?: number;\n  readonly body?: boolean;\n  readonly logger: Logger;\n  readonly metadataHeaders?: readonly string[];\n}\n\nexport async function fetchMessagesConcurrently(gmail: gmail_v1.Gmail, params: FetchMessagesConcurrentlyParams): Promise<gmail_v1.Schema$Message[]> {\n  const { items, concurrency = 2, body = false, logger, metadataHeaders } = params;\n\n  // Secure resource bounds checking for concurrent operations\n  const maxConcurrency = 10; // Conservative limit to prevent rate limiting and resource exhaustion\n  const minConcurrency = 1; // Minimum valid concurrency\n\n  // Validate input is a positive number to prevent bypass attempts\n  if (!Number.isInteger(concurrency) || concurrency < 0) {\n    throw new Error(`Invalid concurrency: must be a positive integer, got ${concurrency}`);\n  }\n\n  const safeConcurrency = Math.min(Math.max(minConcurrency, concurrency), maxConcurrency);\n\n  if (concurrency !== safeConcurrency && logger) {\n    logger.info('Concurrency bounded for API safety', { requested: concurrency, applied: safeConcurrency });\n    // No fallback to console - would corrupt MCP stdio communication\n  }\n\n  if (items.length === 0) return [];\n\n  const results: (gmail_v1.Schema$Message | null)[] = new Array(items.length);\n  const format = body ? 'full' : 'metadata';\n  // Always pass metadataHeaders if provided - body doesn't replace headers, it's additional content\n  const metadataHeadersForRequest = metadataHeaders;\n\n  // Pre-build request parameters to avoid repeated object creation\n  const requestParams = items.map((id) => {\n    const baseParams = {\n      userId: 'me' as const,\n      id,\n      format,\n    };\n    // Only include metadataHeaders if defined (exactOptionalPropertyTypes compliance)\n    return metadataHeadersForRequest ? { ...baseParams, metadataHeaders: [...metadataHeadersForRequest] } : baseParams;\n  });\n\n  // Optimize concurrent processing using batching\n  const batchSize = safeConcurrency;\n  const batches: (typeof requestParams)[] = [];\n  for (let i = 0; i < requestParams.length; i += batchSize) {\n    batches.push(requestParams.slice(i, i + batchSize));\n  }\n\n  let processedCount = 0;\n  for (const batch of batches) {\n    const batchPromises = batch.map(async (params, batchIndex) => {\n      try {\n        const messageResponse = await gmail.users.messages.get(params);\n        const globalIndex = processedCount + batchIndex;\n        results[globalIndex] = messageResponse.data;\n        return messageResponse.data;\n      } catch (error) {\n        // Log individual message fetch failures but continue processing\n        const errorMessage = error instanceof Error ? error.message : String(error);\n        if (logger)\n          logger.info('Gmail pagination: individual message fetch failed, continuing', {\n            error: errorMessage,\n            messageId: params.id,\n            globalIndex: processedCount + batchIndex,\n          });\n        return null; // Mark as failed but continue\n      }\n    });\n\n    await Promise.all(batchPromises);\n    processedCount += batch.length;\n\n    // Progress logging for large batches\n    if (items.length > 20) {\n      if (logger) logger.info(`Gmail pagination: processed ${processedCount}/${items.length} messages`);\n    }\n  }\n\n  // Filter out any null results from failed individual fetches\n  return results.filter((result) => result !== null && result !== undefined);\n}\n"],"names":["fetchMessagesPage","gmail","params","gmailQ","pageSize","pageToken","body","logger","metadataHeaders","maxPageSize","minPageSize","Number","isInteger","Error","safePageSize","Math","min","max","info","requested","applied","listParams","userId","q","maxResults","listResponse","trim","length","users","messages","list","response","data","nextPageToken","undefined","items","map","m","id","filter","Boolean","concurrentArgs","concurrency","detailedMessages","fetchMessagesConcurrently","error","errorMessage","message","String","query","hasPageToken","maxConcurrency","minConcurrency","safeConcurrency","results","Array","format","metadataHeadersForRequest","requestParams","baseParams","batchSize","batches","i","push","slice","processedCount","batch","batchPromises","batchIndex","messageResponse","get","globalIndex","messageId","Promise","all","result"],"mappings":"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"}

package/dist/esm/email/querying/search-execution.d.ts

@@ -1,4 +1,4 @@
-import type { gmail_v1 } from 'googleapis';
+import type { gmail_v1 } from '@googleapis/gmail';
 import type { GmailQuery as QueryNode } from '../../schemas/gmail-query-schema.js';
 import type { Logger } from '../../types.js';
 export interface GmailSearchOptions {

package/dist/esm/email/querying/search-execution.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-gmail/src/email/querying/search-execution.ts"],"sourcesContent":["import type { gmail_v1 } from 'googleapis';\nimport type { GmailQuery as QueryNode } from '../../schemas/gmail-query-schema.ts';\nimport type { Logger } from '../../types.ts';\nimport { type FetchMessagesPageParams, fetchMessagesPage } from './pagination.ts';\nimport { toGmailQuery } from './query-builder.ts';\n\nexport interface GmailSearchOptions {\n  readonly query?: QueryNode;\n  readonly pageSize?: number;\n  readonly includeBody?: boolean;\n  readonly pageToken: string | undefined; // For pagination support - explicit undefined allowed\n  readonly logger: Logger;\n}\n\nexport interface GmailEmailSummary {\n  readonly id: string;\n  readonly provider: 'gmail';\n  readonly threadId?: string;\n  readonly date?: string;\n  readonly from?: string;\n  readonly fromName?: string;\n  readonly to?: string;\n  readonly cc?: string;\n  readonly bcc?: string;\n  readonly subject?: string;\n  readonly snippet?: string;\n  readonly body?: string;\n}\n\nfunction buildGmailQ(query: QueryNode | undefined): string {\n  if (!query) return '';\n  const emitted = toGmailQuery(query);\n  return emitted?.q ?? '';\n}\n\nexport interface GmailSearchResult {\n  readonly messages: gmail_v1.Schema$Message[]; // Raw Gmail API messages for transformation by caller\n  readonly nextPageToken: string | undefined;\n}\n\nexport async function searchMessages(gmail: gmail_v1.Gmail, opts: GmailSearchOptions): Promise<GmailSearchResult> {\n  const { query, pageSize = 50, includeBody = false, pageToken, logger } = opts;\n  const gmailQ = buildGmailQ(query);\n  const metadataHeaders = ['Date', 'Subject', 'From', 'To', 'Cc', 'Bcc'];\n  // Always fetch metadata headers - body is additional content, not a replacement for headers\n  const pageParams: FetchMessagesPageParams = {\n    gmailQ,\n    pageSize,\n    body: includeBody,\n    metadataHeaders,\n    pageToken,\n    logger,\n  };\n  const result = await fetchMessagesPage(gmail, pageParams);\n\n  // Return raw Gmail messages - transformation happens in caller\n  return {\n    messages: result.messages,\n    nextPageToken: result.nextPageToken,\n  };\n}\n"],"names":["fetchMessagesPage","toGmailQuery","buildGmailQ","query","emitted","q","searchMessages","gmail","opts","pageSize","includeBody","pageToken","logger","gmailQ","metadataHeaders","pageParams","body","result","messages","nextPageToken"],"mappings":"AAGA,SAAuCA,iBAAiB,QAAQ,kBAAkB;AAClF,SAASC,YAAY,QAAQ,qBAAqB;AAyBlD,SAASC,YAAYC,KAA4B;;IAC/C,IAAI,CAACA,OAAO,OAAO;IACnB,MAAMC,UAAUH,aAAaE;IAC7B,eAAOC,oBAAAA,8BAAAA,QAASC,CAAC,uCAAI;AACvB;AAOA,OAAO,eAAeC,eAAeC,KAAqB,EAAEC,IAAwB;IAClF,MAAM,EAAEL,KAAK,EAAEM,WAAW,EAAE,EAAEC,cAAc,KAAK,EAAEC,SAAS,EAAEC,MAAM,EAAE,GAAGJ;IACzE,MAAMK,SAASX,YAAYC;IAC3B,MAAMW,kBAAkB;QAAC;QAAQ;QAAW;QAAQ;QAAM;QAAM;KAAM;IACtE,4FAA4F;IAC5F,MAAMC,aAAsC;QAC1CF;QACAJ;QACAO,MAAMN;QACNI;QACAH;QACAC;IACF;IACA,MAAMK,SAAS,MAAMjB,kBAAkBO,OAAOQ;IAE9C,+DAA+D;IAC/D,OAAO;QACLG,UAAUD,OAAOC,QAAQ;QACzBC,eAAeF,OAAOE,aAAa;IACrC;AACF"}
+{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-gmail/src/email/querying/search-execution.ts"],"sourcesContent":["import type { gmail_v1 } from '@googleapis/gmail';\nimport type { GmailQuery as QueryNode } from '../../schemas/gmail-query-schema.ts';\nimport type { Logger } from '../../types.ts';\nimport { type FetchMessagesPageParams, fetchMessagesPage } from './pagination.ts';\nimport { toGmailQuery } from './query-builder.ts';\n\nexport interface GmailSearchOptions {\n  readonly query?: QueryNode;\n  readonly pageSize?: number;\n  readonly includeBody?: boolean;\n  readonly pageToken: string | undefined; // For pagination support - explicit undefined allowed\n  readonly logger: Logger;\n}\n\nexport interface GmailEmailSummary {\n  readonly id: string;\n  readonly provider: 'gmail';\n  readonly threadId?: string;\n  readonly date?: string;\n  readonly from?: string;\n  readonly fromName?: string;\n  readonly to?: string;\n  readonly cc?: string;\n  readonly bcc?: string;\n  readonly subject?: string;\n  readonly snippet?: string;\n  readonly body?: string;\n}\n\nfunction buildGmailQ(query: QueryNode | undefined): string {\n  if (!query) return '';\n  const emitted = toGmailQuery(query);\n  return emitted?.q ?? '';\n}\n\nexport interface GmailSearchResult {\n  readonly messages: gmail_v1.Schema$Message[]; // Raw Gmail API messages for transformation by caller\n  readonly nextPageToken: string | undefined;\n}\n\nexport async function searchMessages(gmail: gmail_v1.Gmail, opts: GmailSearchOptions): Promise<GmailSearchResult> {\n  const { query, pageSize = 50, includeBody = false, pageToken, logger } = opts;\n  const gmailQ = buildGmailQ(query);\n  const metadataHeaders = ['Date', 'Subject', 'From', 'To', 'Cc', 'Bcc'];\n  // Always fetch metadata headers - body is additional content, not a replacement for headers\n  const pageParams: FetchMessagesPageParams = {\n    gmailQ,\n    pageSize,\n    body: includeBody,\n    metadataHeaders,\n    pageToken,\n    logger,\n  };\n  const result = await fetchMessagesPage(gmail, pageParams);\n\n  // Return raw Gmail messages - transformation happens in caller\n  return {\n    messages: result.messages,\n    nextPageToken: result.nextPageToken,\n  };\n}\n"],"names":["fetchMessagesPage","toGmailQuery","buildGmailQ","query","emitted","q","searchMessages","gmail","opts","pageSize","includeBody","pageToken","logger","gmailQ","metadataHeaders","pageParams","body","result","messages","nextPageToken"],"mappings":"AAGA,SAAuCA,iBAAiB,QAAQ,kBAAkB;AAClF,SAASC,YAAY,QAAQ,qBAAqB;AAyBlD,SAASC,YAAYC,KAA4B;;IAC/C,IAAI,CAACA,OAAO,OAAO;IACnB,MAAMC,UAAUH,aAAaE;IAC7B,eAAOC,oBAAAA,8BAAAA,QAASC,CAAC,uCAAI;AACvB;AAOA,OAAO,eAAeC,eAAeC,KAAqB,EAAEC,IAAwB;IAClF,MAAM,EAAEL,KAAK,EAAEM,WAAW,EAAE,EAAEC,cAAc,KAAK,EAAEC,SAAS,EAAEC,MAAM,EAAE,GAAGJ;IACzE,MAAMK,SAASX,YAAYC;IAC3B,MAAMW,kBAAkB;QAAC;QAAQ;QAAW;QAAQ;QAAM;QAAM;KAAM;IACtE,4FAA4F;IAC5F,MAAMC,aAAsC;QAC1CF;QACAJ;QACAO,MAAMN;QACNI;QACAH;QACAC;IACF;IACA,MAAMK,SAAS,MAAMjB,kBAAkBO,OAAOQ;IAE9C,+DAA+D;IAC/D,OAAO;QACLG,UAAUD,OAAOC,QAAQ;QACzBC,eAAeF,OAAOE,aAAa;IACrC;AACF"}

package/dist/esm/labels/gmail-labels.d.ts

@@ -1,2 +1,2 @@
-import type { gmail_v1 } from 'googleapis';
+import type { gmail_v1 } from '@googleapis/gmail';
 export declare function ensureLabelId(gmail: gmail_v1.Gmail, userId: string, labelName: string): Promise<string>;

package/dist/esm/labels/gmail-labels.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-gmail/src/labels/gmail-labels.ts"],"sourcesContent":["import type { gmail_v1 } from 'googleapis';\n\nexport async function ensureLabelId(gmail: gmail_v1.Gmail, userId: string, labelName: string): Promise<string> {\n  // Built-in system labels: pass through by name\n  const builtInLabels: Record<string, string> = {\n    INBOX: 'INBOX',\n    SPAM: 'SPAM',\n    TRASH: 'TRASH',\n    UNREAD: 'UNREAD',\n    STARRED: 'STARRED',\n    IMPORTANT: 'IMPORTANT',\n    SENT: 'SENT',\n    DRAFT: 'DRAFT',\n    CATEGORY_PERSONAL: 'CATEGORY_PERSONAL',\n    CATEGORY_SOCIAL: 'CATEGORY_SOCIAL',\n    CATEGORY_PROMOTIONS: 'CATEGORY_PROMOTIONS',\n    CATEGORY_UPDATES: 'CATEGORY_UPDATES',\n    CATEGORY_FORUMS: 'CATEGORY_FORUMS',\n  };\n\n  const upper = labelName.toUpperCase();\n  if (builtInLabels[upper]) return builtInLabels[upper];\n\n  // Try to find an existing user label by name\n  const listed = await gmail.users.labels.list({ userId });\n  const labels = Array.isArray(listed?.data?.labels) ? listed.data.labels : [];\n  const existing = labels.find((l: unknown) => {\n    const label = l as { name?: unknown; id?: unknown };\n    return label?.name === labelName;\n  });\n  const existingTyped = existing as { id?: unknown } | undefined;\n  if (existingTyped?.id) return String(existingTyped.id);\n\n  // Create the label if it doesn't exist\n  const created = await gmail.users.labels.create({\n    userId,\n    requestBody: {\n      name: labelName,\n      labelListVisibility: 'labelShow',\n      messageListVisibility: 'show',\n    },\n  });\n  if (!created?.data?.id) throw new Error('Failed to create label');\n  return created.data.id as string;\n}\n"],"names":["ensureLabelId","gmail","userId","labelName","listed","created","builtInLabels","INBOX","SPAM","TRASH","UNREAD","STARRED","IMPORTANT","SENT","DRAFT","CATEGORY_PERSONAL","CATEGORY_SOCIAL","CATEGORY_PROMOTIONS","CATEGORY_UPDATES","CATEGORY_FORUMS","upper","toUpperCase","users","labels","list","Array","isArray","data","existing","find","l","label","name","existingTyped","id","String","create","requestBody","labelListVisibility","messageListVisibility","Error"],"mappings":"AAEA,OAAO,eAAeA,cAAcC,KAAqB,EAAEC,MAAc,EAAEC,SAAiB;QAuB7DC,cAiBxBC;IAvCL,+CAA+C;IAC/C,MAAMC,gBAAwC;QAC5CC,OAAO;QACPC,MAAM;QACNC,OAAO;QACPC,QAAQ;QACRC,SAAS;QACTC,WAAW;QACXC,MAAM;QACNC,OAAO;QACPC,mBAAmB;QACnBC,iBAAiB;QACjBC,qBAAqB;QACrBC,kBAAkB;QAClBC,iBAAiB;IACnB;IAEA,MAAMC,QAAQjB,UAAUkB,WAAW;IACnC,IAAIf,aAAa,CAACc,MAAM,EAAE,OAAOd,aAAa,CAACc,MAAM;IAErD,6CAA6C;IAC7C,MAAMhB,SAAS,MAAMH,MAAMqB,KAAK,CAACC,MAAM,CAACC,IAAI,CAAC;QAAEtB;IAAO;IACtD,MAAMqB,SAASE,MAAMC,OAAO,CAACtB,mBAAAA,8BAAAA,eAAAA,OAAQuB,IAAI,cAAZvB,mCAAAA,aAAcmB,MAAM,IAAInB,OAAOuB,IAAI,CAACJ,MAAM,GAAG,EAAE;IAC5E,MAAMK,WAAWL,OAAOM,IAAI,CAAC,CAACC;QAC5B,MAAMC,QAAQD;QACd,OAAOC,CAAAA,kBAAAA,4BAAAA,MAAOC,IAAI,MAAK7B;IACzB;IACA,MAAM8B,gBAAgBL;IACtB,IAAIK,0BAAAA,oCAAAA,cAAeC,EAAE,EAAE,OAAOC,OAAOF,cAAcC,EAAE;IAErD,uCAAuC;IACvC,MAAM7B,UAAU,MAAMJ,MAAMqB,KAAK,CAACC,MAAM,CAACa,MAAM,CAAC;QAC9ClC;QACAmC,aAAa;YACXL,MAAM7B;YACNmC,qBAAqB;YACrBC,uBAAuB;QACzB;IACF;IACA,IAAI,EAAClC,oBAAAA,+BAAAA,gBAAAA,QAASsB,IAAI,cAAbtB,oCAAAA,cAAe6B,EAAE,GAAE,MAAM,IAAIM,MAAM;IACxC,OAAOnC,QAAQsB,IAAI,CAACO,EAAE;AACxB"}
+{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-gmail/src/labels/gmail-labels.ts"],"sourcesContent":["import type { gmail_v1 } from '@googleapis/gmail';\n\nexport async function ensureLabelId(gmail: gmail_v1.Gmail, userId: string, labelName: string): Promise<string> {\n  // Built-in system labels: pass through by name\n  const builtInLabels: Record<string, string> = {\n    INBOX: 'INBOX',\n    SPAM: 'SPAM',\n    TRASH: 'TRASH',\n    UNREAD: 'UNREAD',\n    STARRED: 'STARRED',\n    IMPORTANT: 'IMPORTANT',\n    SENT: 'SENT',\n    DRAFT: 'DRAFT',\n    CATEGORY_PERSONAL: 'CATEGORY_PERSONAL',\n    CATEGORY_SOCIAL: 'CATEGORY_SOCIAL',\n    CATEGORY_PROMOTIONS: 'CATEGORY_PROMOTIONS',\n    CATEGORY_UPDATES: 'CATEGORY_UPDATES',\n    CATEGORY_FORUMS: 'CATEGORY_FORUMS',\n  };\n\n  const upper = labelName.toUpperCase();\n  if (builtInLabels[upper]) return builtInLabels[upper];\n\n  // Try to find an existing user label by name\n  const listed = await gmail.users.labels.list({ userId });\n  const labels = Array.isArray(listed?.data?.labels) ? listed.data.labels : [];\n  const existing = labels.find((l: unknown) => {\n    const label = l as { name?: unknown; id?: unknown };\n    return label?.name === labelName;\n  });\n  const existingTyped = existing as { id?: unknown } | undefined;\n  if (existingTyped?.id) return String(existingTyped.id);\n\n  // Create the label if it doesn't exist\n  const created = await gmail.users.labels.create({\n    userId,\n    requestBody: {\n      name: labelName,\n      labelListVisibility: 'labelShow',\n      messageListVisibility: 'show',\n    },\n  });\n  if (!created?.data?.id) throw new Error('Failed to create label');\n  return created.data.id as string;\n}\n"],"names":["ensureLabelId","gmail","userId","labelName","listed","created","builtInLabels","INBOX","SPAM","TRASH","UNREAD","STARRED","IMPORTANT","SENT","DRAFT","CATEGORY_PERSONAL","CATEGORY_SOCIAL","CATEGORY_PROMOTIONS","CATEGORY_UPDATES","CATEGORY_FORUMS","upper","toUpperCase","users","labels","list","Array","isArray","data","existing","find","l","label","name","existingTyped","id","String","create","requestBody","labelListVisibility","messageListVisibility","Error"],"mappings":"AAEA,OAAO,eAAeA,cAAcC,KAAqB,EAAEC,MAAc,EAAEC,SAAiB;QAuB7DC,cAiBxBC;IAvCL,+CAA+C;IAC/C,MAAMC,gBAAwC;QAC5CC,OAAO;QACPC,MAAM;QACNC,OAAO;QACPC,QAAQ;QACRC,SAAS;QACTC,WAAW;QACXC,MAAM;QACNC,OAAO;QACPC,mBAAmB;QACnBC,iBAAiB;QACjBC,qBAAqB;QACrBC,kBAAkB;QAClBC,iBAAiB;IACnB;IAEA,MAAMC,QAAQjB,UAAUkB,WAAW;IACnC,IAAIf,aAAa,CAACc,MAAM,EAAE,OAAOd,aAAa,CAACc,MAAM;IAErD,6CAA6C;IAC7C,MAAMhB,SAAS,MAAMH,MAAMqB,KAAK,CAACC,MAAM,CAACC,IAAI,CAAC;QAAEtB;IAAO;IACtD,MAAMqB,SAASE,MAAMC,OAAO,CAACtB,mBAAAA,8BAAAA,eAAAA,OAAQuB,IAAI,cAAZvB,mCAAAA,aAAcmB,MAAM,IAAInB,OAAOuB,IAAI,CAACJ,MAAM,GAAG,EAAE;IAC5E,MAAMK,WAAWL,OAAOM,IAAI,CAAC,CAACC;QAC5B,MAAMC,QAAQD;QACd,OAAOC,CAAAA,kBAAAA,4BAAAA,MAAOC,IAAI,MAAK7B;IACzB;IACA,MAAM8B,gBAAgBL;IACtB,IAAIK,0BAAAA,oCAAAA,cAAeC,EAAE,EAAE,OAAOC,OAAOF,cAAcC,EAAE;IAErD,uCAAuC;IACvC,MAAM7B,UAAU,MAAMJ,MAAMqB,KAAK,CAACC,MAAM,CAACa,MAAM,CAAC;QAC9ClC;QACAmC,aAAa;YACXL,MAAM7B;YACNmC,qBAAqB;YACrBC,uBAAuB;QACzB;IACF;IACA,IAAI,EAAClC,oBAAAA,+BAAAA,gBAAAA,QAASsB,IAAI,cAAbtB,oCAAAA,cAAe6B,EAAE,GAAE,MAAM,IAAIM,MAAM;IACxC,OAAOnC,QAAQsB,IAAI,CAACO,EAAE;AACxB"}

package/dist/esm/lib/google-auth.js

@@ -1,5 +1,5 @@
+import { auth as googleAuthPlus } from '@googleapis/gmail';
 import { attachTokenProvider } from '@mcp-z/oauth-google';
-import { google } from 'googleapis';
 /**
  * A Google API client bound to this request's token provider.
  *
@@ -7,5 +7,5 @@ import { google } from 'googleapis';
  * is built here, from this package's own `googleapis`. That keeps one copy of
  * `google-auth-library` in the tree by construction rather than by matching pins.
  */ export function googleAuth(auth) {
-    return attachTokenProvider(new google.auth.OAuth2(), auth);
+    return attachTokenProvider(new googleAuthPlus.OAuth2(), auth);
 }

package/dist/esm/lib/google-auth.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-gmail/src/lib/google-auth.ts"],"sourcesContent":["import { attachTokenProvider, type GoogleAuthProvider } from '@mcp-z/oauth-google';\nimport { google } from 'googleapis';\n\n/**\n * A Google API client bound to this request's token provider.\n *\n * `@mcp-z/oauth-google` mints tokens and depends on no Google SDK, so the client\n * is built here, from this package's own `googleapis`. That keeps one copy of\n * `google-auth-library` in the tree by construction rather than by matching pins.\n */\nexport function googleAuth(auth: GoogleAuthProvider) {\n  return attachTokenProvider(new google.auth.OAuth2(), auth);\n}\n"],"names":["attachTokenProvider","google","googleAuth","auth","OAuth2"],"mappings":"AAAA,SAASA,mBAAmB,QAAiC,sBAAsB;AACnF,SAASC,MAAM,QAAQ,aAAa;AAEpC;;;;;;CAMC,GACD,OAAO,SAASC,WAAWC,IAAwB;IACjD,OAAOH,oBAAoB,IAAIC,OAAOE,IAAI,CAACC,MAAM,IAAID;AACvD"}
+{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-gmail/src/lib/google-auth.ts"],"sourcesContent":["import { auth as googleAuthPlus } from '@googleapis/gmail';\nimport { attachTokenProvider, type GoogleAuthProvider } from '@mcp-z/oauth-google';\n\n/**\n * A Google API client bound to this request's token provider.\n *\n * `@mcp-z/oauth-google` mints tokens and depends on no Google SDK, so the client\n * is built here, from this package's own `googleapis`. That keeps one copy of\n * `google-auth-library` in the tree by construction rather than by matching pins.\n */\nexport function googleAuth(auth: GoogleAuthProvider) {\n  return attachTokenProvider(new googleAuthPlus.OAuth2(), auth);\n}\n"],"names":["auth","googleAuthPlus","attachTokenProvider","googleAuth","OAuth2"],"mappings":"AAAA,SAASA,QAAQC,cAAc,QAAQ,oBAAoB;AAC3D,SAASC,mBAAmB,QAAiC,sBAAsB;AAEnF;;;;;;CAMC,GACD,OAAO,SAASC,WAAWH,IAAwB;IACjD,OAAOE,oBAAoB,IAAID,eAAeG,MAAM,IAAIJ;AAC1D"}

package/dist/esm/mcp/resources/email.js

@@ -1,5 +1,5 @@
+import { gmail as gmailApi } from '@googleapis/gmail';
 import { ResourceTemplate } from '@mcp-z/server';
-import { google } from 'googleapis';
 import { extractEmails, extractFrom } from '../../email/parsing/message-extraction.js';
 import { toIsoUtc } from '../../lib/date-conversion.js';
 import { googleAuth } from '../../lib/google-auth.js';
@@ -17,7 +17,7 @@ export default function createResource() {
             var _fullData_payload;
             const { logger, authContext } = extra;
             logger.info(variables, 'gmail-email resource fetch');
-            const gmail = google.gmail({
+            const gmail = gmailApi({
                 version: 'v1',
                 auth: googleAuth(authContext.auth)
             });

package/dist/esm/mcp/resources/email.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-gmail/src/mcp/resources/email.ts"],"sourcesContent":["import type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport type { ReadResourceResult, ResourceConfig, ResourceModule, ServerContext } from '@mcp-z/server';\nimport { ResourceTemplate } from '@mcp-z/server';\nimport { type gmail_v1, google } from 'googleapis';\nimport { extractEmails, extractFrom } from '../../email/parsing/message-extraction.ts';\nimport { toIsoUtc } from '../../lib/date-conversion.ts';\nimport { googleAuth } from '../../lib/google-auth.ts';\n\nexport default function createResource() {\n  const template = new ResourceTemplate('gmail://messages/{id}', {\n    list: undefined,\n  });\n  const config: ResourceConfig = {\n    description: 'Gmail message metadata (lightweight: id, subject, from, to, date)',\n    mimeType: 'application/json',\n  };\n\n  const handler = async (uri: URL, variables: { id: string }, extra: ServerContext): Promise<ReadResourceResult> => {\n    try {\n      const { logger, authContext } = extra as unknown as EnrichedExtra;\n\n      logger.info(variables, 'gmail-email resource fetch');\n\n      const gmail = google.gmail({ version: 'v1', auth: googleAuth(authContext.auth) });\n      const response = await gmail.users.messages.get({\n        userId: 'me',\n        id: variables.id,\n        format: 'metadata',\n        metadataHeaders: ['From', 'To', 'Subject', 'Date'],\n      });\n\n      const fullData = response.data;\n      if (!fullData) {\n        throw new Error('Message not found');\n      }\n\n      // Extract headers\n      const headers = fullData?.payload?.headers;\n      const headersArray = Array.isArray(headers) ? headers : [];\n      const headersMap: Record<string, string> = Object.fromEntries(\n        headersArray.map((h: unknown) => {\n          const header = h as gmail_v1.Schema$MessagePartHeader;\n          return [String(header.name ?? ''), String(header.value ?? '')];\n        })\n      );\n\n      const fromInfo = extractFrom(headersMap.From);\n      const toStr = extractEmails(headersMap.To).join(', ');\n\n      // Return lightweight metadata only (no body/snippet)\n      const metadata = {\n        id: fullData.id ?? variables.id,\n        subject: headersMap.Subject ?? '',\n        from: fromInfo?.address || headersMap.From,\n        to: toStr,\n        date: toIsoUtc(headersMap.Date) || headersMap.Date,\n      };\n\n      return {\n        contents: [\n          {\n            uri: uri.href,\n            mimeType: 'application/json',\n            text: JSON.stringify(metadata),\n          },\n        ],\n      };\n    } catch (e) {\n      const { logger } = extra as unknown as EnrichedExtra;\n      logger.error(e as Record<string, unknown>, 'gmail-email resource fetch failed');\n      const error = e as { message?: unknown };\n      return {\n        contents: [\n          {\n            uri: uri.href,\n            mimeType: 'application/json',\n            text: JSON.stringify({ error: String(error?.message ?? e) }),\n          },\n        ],\n      };\n    }\n  };\n\n  return {\n    name: 'email',\n    template,\n    config,\n    handler,\n  } satisfies ResourceModule;\n}\n"],"names":["ResourceTemplate","google","extractEmails","extractFrom","toIsoUtc","googleAuth","createResource","template","list","undefined","config","description","mimeType","handler","uri","variables","extra","fullData","headersMap","logger","authContext","info","gmail","version","auth","response","users","messages","get","userId","id","format","metadataHeaders","data","Error","headers","payload","headersArray","Array","isArray","Object","fromEntries","map","h","header","String","name","value","fromInfo","From","toStr","To","join","metadata","subject","Subject","from","address","to","date","Date","contents","href","text","JSON","stringify","e","error","message"],"mappings":"AAEA,SAASA,gBAAgB,QAAQ,gBAAgB;AACjD,SAAwBC,MAAM,QAAQ,aAAa;AACnD,SAASC,aAAa,EAAEC,WAAW,QAAQ,4CAA4C;AACvF,SAASC,QAAQ,QAAQ,+BAA+B;AACxD,SAASC,UAAU,QAAQ,2BAA2B;AAEtD,eAAe,SAASC;IACtB,MAAMC,WAAW,IAAIP,iBAAiB,yBAAyB;QAC7DQ,MAAMC;IACR;IACA,MAAMC,SAAyB;QAC7BC,aAAa;QACbC,UAAU;IACZ;IAEA,MAAMC,UAAU,OAAOC,KAAUC,WAA2BC;QAC1D,IAAI;gBAiCIC,cACKC;gBAfKD;YAlBhB,MAAM,EAAEE,MAAM,EAAEC,WAAW,EAAE,GAAGJ;YAEhCG,OAAOE,IAAI,CAACN,WAAW;YAEvB,MAAMO,QAAQrB,OAAOqB,KAAK,CAAC;gBAAEC,SAAS;gBAAMC,MAAMnB,WAAWe,YAAYI,IAAI;YAAE;YAC/E,MAAMC,WAAW,MAAMH,MAAMI,KAAK,CAACC,QAAQ,CAACC,GAAG,CAAC;gBAC9CC,QAAQ;gBACRC,IAAIf,UAAUe,EAAE;gBAChBC,QAAQ;gBACRC,iBAAiB;oBAAC;oBAAQ;oBAAM;oBAAW;iBAAO;YACpD;YAEA,MAAMf,WAAWQ,SAASQ,IAAI;YAC9B,IAAI,CAAChB,UAAU;gBACb,MAAM,IAAIiB,MAAM;YAClB;YAEA,kBAAkB;YAClB,MAAMC,UAAUlB,qBAAAA,gCAAAA,oBAAAA,SAAUmB,OAAO,cAAjBnB,wCAAAA,kBAAmBkB,OAAO;YAC1C,MAAME,eAAeC,MAAMC,OAAO,CAACJ,WAAWA,UAAU,EAAE;YAC1D,MAAMjB,aAAqCsB,OAAOC,WAAW,CAC3DJ,aAAaK,GAAG,CAAC,CAACC;oBAEDC,cAA2BA;gBAD1C,MAAMA,SAASD;gBACf,OAAO;oBAACE,QAAOD,eAAAA,OAAOE,IAAI,cAAXF,0BAAAA,eAAe;oBAAKC,QAAOD,gBAAAA,OAAOG,KAAK,cAAZH,2BAAAA,gBAAgB;iBAAI;YAChE;YAGF,MAAMI,WAAW7C,YAAYe,WAAW+B,IAAI;YAC5C,MAAMC,QAAQhD,cAAcgB,WAAWiC,EAAE,EAAEC,IAAI,CAAC;YAEhD,qDAAqD;YACrD,MAAMC,WAAW;gBACfvB,EAAE,GAAEb,eAAAA,SAASa,EAAE,cAAXb,0BAAAA,eAAeF,UAAUe,EAAE;gBAC/BwB,OAAO,GAAEpC,sBAAAA,WAAWqC,OAAO,cAAlBrC,iCAAAA,sBAAsB;gBAC/BsC,MAAMR,CAAAA,qBAAAA,+BAAAA,SAAUS,OAAO,KAAIvC,WAAW+B,IAAI;gBAC1CS,IAAIR;gBACJS,MAAMvD,SAASc,WAAW0C,IAAI,KAAK1C,WAAW0C,IAAI;YACpD;YAEA,OAAO;gBACLC,UAAU;oBACR;wBACE/C,KAAKA,IAAIgD,IAAI;wBACblD,UAAU;wBACVmD,MAAMC,KAAKC,SAAS,CAACZ;oBACvB;iBACD;YACH;QACF,EAAE,OAAOa,GAAG;;YACV,MAAM,EAAE/C,MAAM,EAAE,GAAGH;YACnBG,OAAOgD,KAAK,CAACD,GAA8B;YAC3C,MAAMC,QAAQD;YACd,OAAO;gBACLL,UAAU;oBACR;wBACE/C,KAAKA,IAAIgD,IAAI;wBACblD,UAAU;wBACVmD,MAAMC,KAAKC,SAAS,CAAC;4BAAEE,OAAOtB,eAAOsB,kBAAAA,4BAAAA,MAAOC,OAAO,uCAAIF;wBAAG;oBAC5D;iBACD;YACH;QACF;IACF;IAEA,OAAO;QACLpB,MAAM;QACNvC;QACAG;QACAG;IACF;AACF"}
+{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-gmail/src/mcp/resources/email.ts"],"sourcesContent":["import { type gmail_v1, gmail as gmailApi } from '@googleapis/gmail';\nimport type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport type { ReadResourceResult, ResourceConfig, ResourceModule, ServerContext } from '@mcp-z/server';\nimport { ResourceTemplate } from '@mcp-z/server';\nimport { extractEmails, extractFrom } from '../../email/parsing/message-extraction.ts';\nimport { toIsoUtc } from '../../lib/date-conversion.ts';\nimport { googleAuth } from '../../lib/google-auth.ts';\n\nexport default function createResource() {\n  const template = new ResourceTemplate('gmail://messages/{id}', {\n    list: undefined,\n  });\n  const config: ResourceConfig = {\n    description: 'Gmail message metadata (lightweight: id, subject, from, to, date)',\n    mimeType: 'application/json',\n  };\n\n  const handler = async (uri: URL, variables: { id: string }, extra: ServerContext): Promise<ReadResourceResult> => {\n    try {\n      const { logger, authContext } = extra as unknown as EnrichedExtra;\n\n      logger.info(variables, 'gmail-email resource fetch');\n\n      const gmail = gmailApi({ version: 'v1', auth: googleAuth(authContext.auth) });\n      const response = await gmail.users.messages.get({\n        userId: 'me',\n        id: variables.id,\n        format: 'metadata',\n        metadataHeaders: ['From', 'To', 'Subject', 'Date'],\n      });\n\n      const fullData = response.data;\n      if (!fullData) {\n        throw new Error('Message not found');\n      }\n\n      // Extract headers\n      const headers = fullData?.payload?.headers;\n      const headersArray = Array.isArray(headers) ? headers : [];\n      const headersMap: Record<string, string> = Object.fromEntries(\n        headersArray.map((h: unknown) => {\n          const header = h as gmail_v1.Schema$MessagePartHeader;\n          return [String(header.name ?? ''), String(header.value ?? '')];\n        })\n      );\n\n      const fromInfo = extractFrom(headersMap.From);\n      const toStr = extractEmails(headersMap.To).join(', ');\n\n      // Return lightweight metadata only (no body/snippet)\n      const metadata = {\n        id: fullData.id ?? variables.id,\n        subject: headersMap.Subject ?? '',\n        from: fromInfo?.address || headersMap.From,\n        to: toStr,\n        date: toIsoUtc(headersMap.Date) || headersMap.Date,\n      };\n\n      return {\n        contents: [\n          {\n            uri: uri.href,\n            mimeType: 'application/json',\n            text: JSON.stringify(metadata),\n          },\n        ],\n      };\n    } catch (e) {\n      const { logger } = extra as unknown as EnrichedExtra;\n      logger.error(e as Record<string, unknown>, 'gmail-email resource fetch failed');\n      const error = e as { message?: unknown };\n      return {\n        contents: [\n          {\n            uri: uri.href,\n            mimeType: 'application/json',\n            text: JSON.stringify({ error: String(error?.message ?? e) }),\n          },\n        ],\n      };\n    }\n  };\n\n  return {\n    name: 'email',\n    template,\n    config,\n    handler,\n  } satisfies ResourceModule;\n}\n"],"names":["gmail","gmailApi","ResourceTemplate","extractEmails","extractFrom","toIsoUtc","googleAuth","createResource","template","list","undefined","config","description","mimeType","handler","uri","variables","extra","fullData","headersMap","logger","authContext","info","version","auth","response","users","messages","get","userId","id","format","metadataHeaders","data","Error","headers","payload","headersArray","Array","isArray","Object","fromEntries","map","h","header","String","name","value","fromInfo","From","toStr","To","join","metadata","subject","Subject","from","address","to","date","Date","contents","href","text","JSON","stringify","e","error","message"],"mappings":"AAAA,SAAwBA,SAASC,QAAQ,QAAQ,oBAAoB;AAGrE,SAASC,gBAAgB,QAAQ,gBAAgB;AACjD,SAASC,aAAa,EAAEC,WAAW,QAAQ,4CAA4C;AACvF,SAASC,QAAQ,QAAQ,+BAA+B;AACxD,SAASC,UAAU,QAAQ,2BAA2B;AAEtD,eAAe,SAASC;IACtB,MAAMC,WAAW,IAAIN,iBAAiB,yBAAyB;QAC7DO,MAAMC;IACR;IACA,MAAMC,SAAyB;QAC7BC,aAAa;QACbC,UAAU;IACZ;IAEA,MAAMC,UAAU,OAAOC,KAAUC,WAA2BC;QAC1D,IAAI;gBAiCIC,cACKC;gBAfKD;YAlBhB,MAAM,EAAEE,MAAM,EAAEC,WAAW,EAAE,GAAGJ;YAEhCG,OAAOE,IAAI,CAACN,WAAW;YAEvB,MAAMhB,QAAQC,SAAS;gBAAEsB,SAAS;gBAAMC,MAAMlB,WAAWe,YAAYG,IAAI;YAAE;YAC3E,MAAMC,WAAW,MAAMzB,MAAM0B,KAAK,CAACC,QAAQ,CAACC,GAAG,CAAC;gBAC9CC,QAAQ;gBACRC,IAAId,UAAUc,EAAE;gBAChBC,QAAQ;gBACRC,iBAAiB;oBAAC;oBAAQ;oBAAM;oBAAW;iBAAO;YACpD;YAEA,MAAMd,WAAWO,SAASQ,IAAI;YAC9B,IAAI,CAACf,UAAU;gBACb,MAAM,IAAIgB,MAAM;YAClB;YAEA,kBAAkB;YAClB,MAAMC,UAAUjB,qBAAAA,gCAAAA,oBAAAA,SAAUkB,OAAO,cAAjBlB,wCAAAA,kBAAmBiB,OAAO;YAC1C,MAAME,eAAeC,MAAMC,OAAO,CAACJ,WAAWA,UAAU,EAAE;YAC1D,MAAMhB,aAAqCqB,OAAOC,WAAW,CAC3DJ,aAAaK,GAAG,CAAC,CAACC;oBAEDC,cAA2BA;gBAD1C,MAAMA,SAASD;gBACf,OAAO;oBAACE,QAAOD,eAAAA,OAAOE,IAAI,cAAXF,0BAAAA,eAAe;oBAAKC,QAAOD,gBAAAA,OAAOG,KAAK,cAAZH,2BAAAA,gBAAgB;iBAAI;YAChE;YAGF,MAAMI,WAAW5C,YAAYe,WAAW8B,IAAI;YAC5C,MAAMC,QAAQ/C,cAAcgB,WAAWgC,EAAE,EAAEC,IAAI,CAAC;YAEhD,qDAAqD;YACrD,MAAMC,WAAW;gBACfvB,EAAE,GAAEZ,eAAAA,SAASY,EAAE,cAAXZ,0BAAAA,eAAeF,UAAUc,EAAE;gBAC/BwB,OAAO,GAAEnC,sBAAAA,WAAWoC,OAAO,cAAlBpC,iCAAAA,sBAAsB;gBAC/BqC,MAAMR,CAAAA,qBAAAA,+BAAAA,SAAUS,OAAO,KAAItC,WAAW8B,IAAI;gBAC1CS,IAAIR;gBACJS,MAAMtD,SAASc,WAAWyC,IAAI,KAAKzC,WAAWyC,IAAI;YACpD;YAEA,OAAO;gBACLC,UAAU;oBACR;wBACE9C,KAAKA,IAAI+C,IAAI;wBACbjD,UAAU;wBACVkD,MAAMC,KAAKC,SAAS,CAACZ;oBACvB;iBACD;YACH;QACF,EAAE,OAAOa,GAAG;;YACV,MAAM,EAAE9C,MAAM,EAAE,GAAGH;YACnBG,OAAO+C,KAAK,CAACD,GAA8B;YAC3C,MAAMC,QAAQD;YACd,OAAO;gBACLL,UAAU;oBACR;wBACE9C,KAAKA,IAAI+C,IAAI;wBACbjD,UAAU;wBACVkD,MAAMC,KAAKC,SAAS,CAAC;4BAAEE,OAAOtB,eAAOsB,kBAAAA,4BAAAA,MAAOC,OAAO,uCAAIF;wBAAG;oBAC5D;iBACD;YACH;QACF;IACF;IAEA,OAAO;QACLpB,MAAM;QACNtC;QACAG;QACAG;IACF;AACF"}

package/dist/esm/mcp/tools/categories-list.js

@@ -1,7 +1,7 @@
+import { gmail as gmailApi } from '@googleapis/gmail';
 import { schemas } from '@mcp-z/oauth-google';
 const { AuthRequiredBranchSchema } = schemas;
 import { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';
-import { google } from 'googleapis';
 import { z } from 'zod';
 import { googleAuth } from '../../lib/google-auth.js';
 // Schema for individual category items
@@ -34,7 +34,7 @@ async function handler(_, extra) {
     const logger = extra.logger;
     logger.info('gmail.categories.list called');
     try {
-        const gmail = google.gmail({
+        const gmail = gmailApi({
             version: 'v1',
             auth: googleAuth(extra.authContext.auth)
         });

package/dist/esm/mcp/tools/categories-list.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-gmail/src/mcp/tools/categories-list.ts"],"sourcesContent":["import type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport { schemas } from '@mcp-z/oauth-google';\n\nconst { AuthRequiredBranchSchema } = schemas;\n\nimport type { ToolModule } from '@mcp-z/server';\nimport { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';\nimport { google } from 'googleapis';\nimport { z } from 'zod';\nimport { googleAuth } from '../../lib/google-auth.ts';\n\n// Schema for individual category items\nconst CategorySchema = z.object({\n  id: z.string().describe('Gmail category ID (e.g., CATEGORY_PERSONAL)'),\n  name: z.string().describe('Human-readable category name'),\n  description: z.string().describe('Description of what emails belong in this category'),\n});\n\n/**\n * Input schema for the categories-list tool (currently empty as this tool takes no parameters).\n */\nexport const inputSchema = z.object({});\n\n// Success branch schema\nconst successBranchSchema = z.object({\n  type: z.literal('success'),\n  items: z.array(CategorySchema),\n});\n\n// Output schema with auth_required support\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n  description: 'List Gmail category labels (CATEGORY_*) with IDs and descriptions.',\n  inputSchema: inputSchema,\n  outputSchema: z.object({\n    result: outputSchema,\n  }),\n} as const;\n\n/**\n * Input parameters for the categories-list tool.\n */\nexport type Input = z.infer<typeof inputSchema>;\nexport type Output = z.infer<typeof outputSchema>;\n\nasync function handler(_: Input, extra: EnrichedExtra) {\n  const logger = extra.logger;\n  logger.info('gmail.categories.list called');\n\n  try {\n    const gmail = google.gmail({ version: 'v1', auth: googleAuth(extra.authContext.auth) });\n    const started = Date.now();\n\n    // Fetch all labels from Gmail API\n    const response = await gmail.users.labels.list({ userId: 'me' });\n    const labels = response.data.labels || [];\n\n    // Filter for CATEGORY_* system labels and map to our schema\n    const categories = labels\n      .filter((label) => label.id?.startsWith('CATEGORY_'))\n      .map((label) => {\n        const id = label.id as string;\n        let name = label.name || id;\n        let description = '';\n\n        // Map known category types to user-friendly names and descriptions\n        switch (id) {\n          case 'CATEGORY_PERSONAL':\n            name = 'Primary';\n            description = 'Important emails from people you know';\n            break;\n          case 'CATEGORY_SOCIAL':\n            name = 'Social';\n            description = 'Social networks and social websites';\n            break;\n          case 'CATEGORY_PROMOTIONS':\n            name = 'Promotions';\n            description = 'Deals, offers, and marketing emails';\n            break;\n          case 'CATEGORY_UPDATES':\n            name = 'Updates';\n            description = 'Confirmations, receipts, bills, and statements';\n            break;\n          case 'CATEGORY_FORUMS':\n            name = 'Forums';\n            description = 'Online groups, discussion boards, mailing lists';\n            break;\n          default:\n            // For any unknown CATEGORY_* labels, use the label name as-is\n            name = label.name || id.replace('CATEGORY_', '');\n            description = `Gmail category: ${name}`;\n        }\n\n        return {\n          id,\n          name,\n          description,\n        };\n      })\n      .sort((a, b) => a.name.localeCompare(b.name)); // Sort alphabetically by name\n\n    const durationMs = Date.now() - started;\n\n    logger.info('gmail.categories.list results', { categoryCount: categories.length, totalLabels: labels.length });\n    logger.info('gmail.categories.list metrics', { durationMs });\n\n    const result: Output = {\n      type: 'success' as const,\n      items: categories,\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    const message = error instanceof Error ? error.message : String(error);\n    logger.error('gmail.categories.list error', { error: message });\n\n    throw new ProtocolError(ProtocolErrorCode.InternalError, `Error listing categories: ${message}`, {\n      stack: error instanceof Error ? error.stack : undefined,\n    });\n  }\n}\n\nexport default function createTool() {\n  return {\n    name: 'categories-list',\n    config,\n    handler,\n  } satisfies ToolModule;\n}\n"],"names":["schemas","AuthRequiredBranchSchema","ProtocolError","ProtocolErrorCode","google","z","googleAuth","CategorySchema","object","id","string","describe","name","description","inputSchema","successBranchSchema","type","literal","items","array","outputSchema","discriminatedUnion","config","result","handler","_","extra","logger","info","gmail","version","auth","authContext","started","Date","now","response","users","labels","list","userId","data","categories","filter","label","startsWith","map","replace","sort","a","b","localeCompare","durationMs","categoryCount","length","totalLabels","content","text","JSON","stringify","structuredContent","error","message","Error","String","InternalError","stack","undefined","createTool"],"mappings":"AACA,SAASA,OAAO,QAAQ,sBAAsB;AAE9C,MAAM,EAAEC,wBAAwB,EAAE,GAAGD;AAGrC,SAASE,aAAa,EAAEC,iBAAiB,QAAQ,gBAAgB;AACjE,SAASC,MAAM,QAAQ,aAAa;AACpC,SAASC,CAAC,QAAQ,MAAM;AACxB,SAASC,UAAU,QAAQ,2BAA2B;AAEtD,uCAAuC;AACvC,MAAMC,iBAAiBF,EAAEG,MAAM,CAAC;IAC9BC,IAAIJ,EAAEK,MAAM,GAAGC,QAAQ,CAAC;IACxBC,MAAMP,EAAEK,MAAM,GAAGC,QAAQ,CAAC;IAC1BE,aAAaR,EAAEK,MAAM,GAAGC,QAAQ,CAAC;AACnC;AAEA;;CAEC,GACD,OAAO,MAAMG,cAAcT,EAAEG,MAAM,CAAC,CAAC,GAAG;AAExC,wBAAwB;AACxB,MAAMO,sBAAsBV,EAAEG,MAAM,CAAC;IACnCQ,MAAMX,EAAEY,OAAO,CAAC;IAChBC,OAAOb,EAAEc,KAAK,CAACZ;AACjB;AAEA,2CAA2C;AAC3C,MAAMa,eAAef,EAAEgB,kBAAkB,CAAC,QAAQ;IAACN;IAAqBd;CAAyB;AAEjG,MAAMqB,SAAS;IACbT,aAAa;IACbC,aAAaA;IACbM,cAAcf,EAAEG,MAAM,CAAC;QACrBe,QAAQH;IACV;AACF;AAQA,eAAeI,QAAQC,CAAQ,EAAEC,KAAoB;IACnD,MAAMC,SAASD,MAAMC,MAAM;IAC3BA,OAAOC,IAAI,CAAC;IAEZ,IAAI;QACF,MAAMC,QAAQzB,OAAOyB,KAAK,CAAC;YAAEC,SAAS;YAAMC,MAAMzB,WAAWoB,MAAMM,WAAW,CAACD,IAAI;QAAE;QACrF,MAAME,UAAUC,KAAKC,GAAG;QAExB,kCAAkC;QAClC,MAAMC,WAAW,MAAMP,MAAMQ,KAAK,CAACC,MAAM,CAACC,IAAI,CAAC;YAAEC,QAAQ;QAAK;QAC9D,MAAMF,SAASF,SAASK,IAAI,CAACH,MAAM,IAAI,EAAE;QAEzC,4DAA4D;QAC5D,MAAMI,aAAaJ,OAChBK,MAAM,CAAC,CAACC;gBAAUA;oBAAAA,YAAAA,MAAMnC,EAAE,cAARmC,gCAAAA,UAAUC,UAAU,CAAC;WACvCC,GAAG,CAAC,CAACF;YACJ,MAAMnC,KAAKmC,MAAMnC,EAAE;YACnB,IAAIG,OAAOgC,MAAMhC,IAAI,IAAIH;YACzB,IAAII,cAAc;YAElB,mEAAmE;YACnE,OAAQJ;gBACN,KAAK;oBACHG,OAAO;oBACPC,cAAc;oBACd;gBACF,KAAK;oBACHD,OAAO;oBACPC,cAAc;oBACd;gBACF,KAAK;oBACHD,OAAO;oBACPC,cAAc;oBACd;gBACF,KAAK;oBACHD,OAAO;oBACPC,cAAc;oBACd;gBACF,KAAK;oBACHD,OAAO;oBACPC,cAAc;oBACd;gBACF;oBACE,8DAA8D;oBAC9DD,OAAOgC,MAAMhC,IAAI,IAAIH,GAAGsC,OAAO,CAAC,aAAa;oBAC7ClC,cAAc,CAAC,gBAAgB,EAAED,MAAM;YAC3C;YAEA,OAAO;gBACLH;gBACAG;gBACAC;YACF;QACF,GACCmC,IAAI,CAAC,CAACC,GAAGC,IAAMD,EAAErC,IAAI,CAACuC,aAAa,CAACD,EAAEtC,IAAI,IAAI,8BAA8B;QAE/E,MAAMwC,aAAalB,KAAKC,GAAG,KAAKF;QAEhCN,OAAOC,IAAI,CAAC,iCAAiC;YAAEyB,eAAeX,WAAWY,MAAM;YAAEC,aAAajB,OAAOgB,MAAM;QAAC;QAC5G3B,OAAOC,IAAI,CAAC,iCAAiC;YAAEwB;QAAW;QAE1D,MAAM7B,SAAiB;YACrBP,MAAM;YACNE,OAAOwB;QACT;QAEA,OAAO;YACLc,SAAS;gBACP;oBACExC,MAAM;oBACNyC,MAAMC,KAAKC,SAAS,CAACpC;gBACvB;aACD;YACDqC,mBAAmB;gBAAErC;YAAO;QAC9B;IACF,EAAE,OAAOsC,OAAO;QACd,MAAMC,UAAUD,iBAAiBE,QAAQF,MAAMC,OAAO,GAAGE,OAAOH;QAChElC,OAAOkC,KAAK,CAAC,+BAA+B;YAAEA,OAAOC;QAAQ;QAE7D,MAAM,IAAI5D,cAAcC,kBAAkB8D,aAAa,EAAE,CAAC,0BAA0B,EAAEH,SAAS,EAAE;YAC/FI,OAAOL,iBAAiBE,QAAQF,MAAMK,KAAK,GAAGC;QAChD;IACF;AACF;AAEA,eAAe,SAASC;IACtB,OAAO;QACLxD,MAAM;QACNU;QACAE;IACF;AACF"}
+{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-gmail/src/mcp/tools/categories-list.ts"],"sourcesContent":["import { gmail as gmailApi } from '@googleapis/gmail';\nimport type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport { schemas } from '@mcp-z/oauth-google';\n\nconst { AuthRequiredBranchSchema } = schemas;\n\nimport type { ToolModule } from '@mcp-z/server';\nimport { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';\nimport { z } from 'zod';\nimport { googleAuth } from '../../lib/google-auth.ts';\n\n// Schema for individual category items\nconst CategorySchema = z.object({\n  id: z.string().describe('Gmail category ID (e.g., CATEGORY_PERSONAL)'),\n  name: z.string().describe('Human-readable category name'),\n  description: z.string().describe('Description of what emails belong in this category'),\n});\n\n/**\n * Input schema for the categories-list tool (currently empty as this tool takes no parameters).\n */\nexport const inputSchema = z.object({});\n\n// Success branch schema\nconst successBranchSchema = z.object({\n  type: z.literal('success'),\n  items: z.array(CategorySchema),\n});\n\n// Output schema with auth_required support\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n  description: 'List Gmail category labels (CATEGORY_*) with IDs and descriptions.',\n  inputSchema: inputSchema,\n  outputSchema: z.object({\n    result: outputSchema,\n  }),\n} as const;\n\n/**\n * Input parameters for the categories-list tool.\n */\nexport type Input = z.infer<typeof inputSchema>;\nexport type Output = z.infer<typeof outputSchema>;\n\nasync function handler(_: Input, extra: EnrichedExtra) {\n  const logger = extra.logger;\n  logger.info('gmail.categories.list called');\n\n  try {\n    const gmail = gmailApi({ version: 'v1', auth: googleAuth(extra.authContext.auth) });\n    const started = Date.now();\n\n    // Fetch all labels from Gmail API\n    const response = await gmail.users.labels.list({ userId: 'me' });\n    const labels = response.data.labels || [];\n\n    // Filter for CATEGORY_* system labels and map to our schema\n    const categories = labels\n      .filter((label) => label.id?.startsWith('CATEGORY_'))\n      .map((label) => {\n        const id = label.id as string;\n        let name = label.name || id;\n        let description = '';\n\n        // Map known category types to user-friendly names and descriptions\n        switch (id) {\n          case 'CATEGORY_PERSONAL':\n            name = 'Primary';\n            description = 'Important emails from people you know';\n            break;\n          case 'CATEGORY_SOCIAL':\n            name = 'Social';\n            description = 'Social networks and social websites';\n            break;\n          case 'CATEGORY_PROMOTIONS':\n            name = 'Promotions';\n            description = 'Deals, offers, and marketing emails';\n            break;\n          case 'CATEGORY_UPDATES':\n            name = 'Updates';\n            description = 'Confirmations, receipts, bills, and statements';\n            break;\n          case 'CATEGORY_FORUMS':\n            name = 'Forums';\n            description = 'Online groups, discussion boards, mailing lists';\n            break;\n          default:\n            // For any unknown CATEGORY_* labels, use the label name as-is\n            name = label.name || id.replace('CATEGORY_', '');\n            description = `Gmail category: ${name}`;\n        }\n\n        return {\n          id,\n          name,\n          description,\n        };\n      })\n      .sort((a, b) => a.name.localeCompare(b.name)); // Sort alphabetically by name\n\n    const durationMs = Date.now() - started;\n\n    logger.info('gmail.categories.list results', { categoryCount: categories.length, totalLabels: labels.length });\n    logger.info('gmail.categories.list metrics', { durationMs });\n\n    const result: Output = {\n      type: 'success' as const,\n      items: categories,\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    const message = error instanceof Error ? error.message : String(error);\n    logger.error('gmail.categories.list error', { error: message });\n\n    throw new ProtocolError(ProtocolErrorCode.InternalError, `Error listing categories: ${message}`, {\n      stack: error instanceof Error ? error.stack : undefined,\n    });\n  }\n}\n\nexport default function createTool() {\n  return {\n    name: 'categories-list',\n    config,\n    handler,\n  } satisfies ToolModule;\n}\n"],"names":["gmail","gmailApi","schemas","AuthRequiredBranchSchema","ProtocolError","ProtocolErrorCode","z","googleAuth","CategorySchema","object","id","string","describe","name","description","inputSchema","successBranchSchema","type","literal","items","array","outputSchema","discriminatedUnion","config","result","handler","_","extra","logger","info","version","auth","authContext","started","Date","now","response","users","labels","list","userId","data","categories","filter","label","startsWith","map","replace","sort","a","b","localeCompare","durationMs","categoryCount","length","totalLabels","content","text","JSON","stringify","structuredContent","error","message","Error","String","InternalError","stack","undefined","createTool"],"mappings":"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"}

package/dist/esm/mcp/tools/label-add.js

@@ -1,7 +1,7 @@
+import { gmail as gmailApi } from '@googleapis/gmail';
 import { schemas } from '@mcp-z/oauth-google';
 const { AuthRequiredBranchSchema } = schemas;
 import { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';
-import { google } from 'googleapis';
 import { z } from 'zod';
 import { ensureLabelId } from '../../labels/gmail-labels.js';
 import { googleAuth } from '../../lib/google-auth.js';
@@ -43,7 +43,7 @@ async function handler({ id, label }, extra) {
         throw new ProtocolError(ProtocolErrorCode.InvalidParams, 'Missing id or label');
     }
     try {
-        const gmail = google.gmail({
+        const gmail = gmailApi({
             version: 'v1',
             auth: googleAuth(extra.authContext.auth)
         });

package/dist/esm/mcp/tools/label-add.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-gmail/src/mcp/tools/label-add.ts"],"sourcesContent":["import type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport { schemas } from '@mcp-z/oauth-google';\n\nconst { AuthRequiredBranchSchema } = schemas;\n\nimport type { ToolModule } from '@mcp-z/server';\nimport { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';\nimport { google } from 'googleapis';\nimport { z } from 'zod';\nimport { ensureLabelId } from '../../labels/gmail-labels.ts';\nimport { googleAuth } from '../../lib/google-auth.ts';\n\nconst inputSchema = z.object({\n  id: z.coerce.string().trim().min(1).describe('Gmail message ID to add label to'),\n  label: z.coerce.string().trim().min(1).describe('Label name or ID (use gmail-labels-list to discover available labels)'),\n});\n\n// Success branch schema\nconst successBranchSchema = z.object({\n  type: z.literal('success'),\n  item: z.object({\n    id: z.string().describe('Message ID the label was added to'),\n    label: z.string().describe('Label that was added'),\n  }),\n});\n\n// Output schema with auth_required support\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n  description: 'Add a label to a Gmail message',\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\nasync function handler({ id, label }: Input, extra: EnrichedExtra) {\n  const logger = extra.logger;\n  logger.info('gmail.label.add called', { id, label });\n\n  if (!id || !label) {\n    logger.info('gmail.label.add missing parameters', { id, label });\n    throw new ProtocolError(ProtocolErrorCode.InvalidParams, 'Missing id or label');\n  }\n\n  try {\n    const gmail = google.gmail({ version: 'v1', auth: googleAuth(extra.authContext.auth) });\n\n    const labelId = await ensureLabelId(gmail, 'me', label);\n    await gmail.users.messages.modify({\n      userId: 'me',\n      id: id,\n      requestBody: {\n        addLabelIds: [labelId],\n      },\n    });\n\n    logger.info('gmail.label.add success', { id, label });\n    logger.info('gmail.label.add result (typed)', { id, label });\n\n    const result: Output = {\n      type: 'success' as const,\n      item: { id, label },\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    const message = error instanceof Error ? error.message : String(error);\n    logger.error('gmail.label.add error', { error: message });\n\n    throw new ProtocolError(ProtocolErrorCode.InternalError, `Error adding label to message: ${message}`, {\n      stack: error instanceof Error ? error.stack : undefined,\n    });\n  }\n}\n\nexport default function createTool() {\n  return {\n    name: 'label-add',\n    config,\n    handler,\n  } satisfies ToolModule;\n}\n"],"names":["schemas","AuthRequiredBranchSchema","ProtocolError","ProtocolErrorCode","google","z","ensureLabelId","googleAuth","inputSchema","object","id","coerce","string","trim","min","describe","label","successBranchSchema","type","literal","item","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","info","InvalidParams","gmail","version","auth","authContext","labelId","users","messages","modify","userId","requestBody","addLabelIds","content","text","JSON","stringify","structuredContent","error","message","Error","String","InternalError","stack","undefined","createTool","name"],"mappings":"AACA,SAASA,OAAO,QAAQ,sBAAsB;AAE9C,MAAM,EAAEC,wBAAwB,EAAE,GAAGD;AAGrC,SAASE,aAAa,EAAEC,iBAAiB,QAAQ,gBAAgB;AACjE,SAASC,MAAM,QAAQ,aAAa;AACpC,SAASC,CAAC,QAAQ,MAAM;AACxB,SAASC,aAAa,QAAQ,+BAA+B;AAC7D,SAASC,UAAU,QAAQ,2BAA2B;AAEtD,MAAMC,cAAcH,EAAEI,MAAM,CAAC;IAC3BC,IAAIL,EAAEM,MAAM,CAACC,MAAM,GAAGC,IAAI,GAAGC,GAAG,CAAC,GAAGC,QAAQ,CAAC;IAC7CC,OAAOX,EAAEM,MAAM,CAACC,MAAM,GAAGC,IAAI,GAAGC,GAAG,CAAC,GAAGC,QAAQ,CAAC;AAClD;AAEA,wBAAwB;AACxB,MAAME,sBAAsBZ,EAAEI,MAAM,CAAC;IACnCS,MAAMb,EAAEc,OAAO,CAAC;IAChBC,MAAMf,EAAEI,MAAM,CAAC;QACbC,IAAIL,EAAEO,MAAM,GAAGG,QAAQ,CAAC;QACxBC,OAAOX,EAAEO,MAAM,GAAGG,QAAQ,CAAC;IAC7B;AACF;AAEA,2CAA2C;AAC3C,MAAMM,eAAehB,EAAEiB,kBAAkB,CAAC,QAAQ;IAACL;IAAqBhB;CAAyB;AAEjG,MAAMsB,SAAS;IACbC,aAAa;IACbhB,aAAaA;IACba,cAAchB,EAAEI,MAAM,CAAC;QACrBgB,QAAQJ;IACV;AACF;AAKA,eAAeK,QAAQ,EAAEhB,EAAE,EAAEM,KAAK,EAAS,EAAEW,KAAoB;IAC/D,MAAMC,SAASD,MAAMC,MAAM;IAC3BA,OAAOC,IAAI,CAAC,0BAA0B;QAAEnB;QAAIM;IAAM;IAElD,IAAI,CAACN,MAAM,CAACM,OAAO;QACjBY,OAAOC,IAAI,CAAC,sCAAsC;YAAEnB;YAAIM;QAAM;QAC9D,MAAM,IAAId,cAAcC,kBAAkB2B,aAAa,EAAE;IAC3D;IAEA,IAAI;QACF,MAAMC,QAAQ3B,OAAO2B,KAAK,CAAC;YAAEC,SAAS;YAAMC,MAAM1B,WAAWoB,MAAMO,WAAW,CAACD,IAAI;QAAE;QAErF,MAAME,UAAU,MAAM7B,cAAcyB,OAAO,MAAMf;QACjD,MAAMe,MAAMK,KAAK,CAACC,QAAQ,CAACC,MAAM,CAAC;YAChCC,QAAQ;YACR7B,IAAIA;YACJ8B,aAAa;gBACXC,aAAa;oBAACN;iBAAQ;YACxB;QACF;QAEAP,OAAOC,IAAI,CAAC,2BAA2B;YAAEnB;YAAIM;QAAM;QACnDY,OAAOC,IAAI,CAAC,kCAAkC;YAAEnB;YAAIM;QAAM;QAE1D,MAAMS,SAAiB;YACrBP,MAAM;YACNE,MAAM;gBAAEV;gBAAIM;YAAM;QACpB;QAEA,OAAO;YACL0B,SAAS;gBACP;oBACExB,MAAM;oBACNyB,MAAMC,KAAKC,SAAS,CAACpB;gBACvB;aACD;YACDqB,mBAAmB;gBAAErB;YAAO;QAC9B;IACF,EAAE,OAAOsB,OAAO;QACd,MAAMC,UAAUD,iBAAiBE,QAAQF,MAAMC,OAAO,GAAGE,OAAOH;QAChEnB,OAAOmB,KAAK,CAAC,yBAAyB;YAAEA,OAAOC;QAAQ;QAEvD,MAAM,IAAI9C,cAAcC,kBAAkBgD,aAAa,EAAE,CAAC,+BAA+B,EAAEH,SAAS,EAAE;YACpGI,OAAOL,iBAAiBE,QAAQF,MAAMK,KAAK,GAAGC;QAChD;IACF;AACF;AAEA,eAAe,SAASC;IACtB,OAAO;QACLC,MAAM;QACNhC;QACAG;IACF;AACF"}
+{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-gmail/src/mcp/tools/label-add.ts"],"sourcesContent":["import { gmail as gmailApi } from '@googleapis/gmail';\nimport type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport { schemas } from '@mcp-z/oauth-google';\n\nconst { AuthRequiredBranchSchema } = schemas;\n\nimport type { ToolModule } from '@mcp-z/server';\nimport { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';\nimport { z } from 'zod';\nimport { ensureLabelId } from '../../labels/gmail-labels.ts';\nimport { googleAuth } from '../../lib/google-auth.ts';\n\nconst inputSchema = z.object({\n  id: z.coerce.string().trim().min(1).describe('Gmail message ID to add label to'),\n  label: z.coerce.string().trim().min(1).describe('Label name or ID (use gmail-labels-list to discover available labels)'),\n});\n\n// Success branch schema\nconst successBranchSchema = z.object({\n  type: z.literal('success'),\n  item: z.object({\n    id: z.string().describe('Message ID the label was added to'),\n    label: z.string().describe('Label that was added'),\n  }),\n});\n\n// Output schema with auth_required support\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n  description: 'Add a label to a Gmail message',\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\nasync function handler({ id, label }: Input, extra: EnrichedExtra) {\n  const logger = extra.logger;\n  logger.info('gmail.label.add called', { id, label });\n\n  if (!id || !label) {\n    logger.info('gmail.label.add missing parameters', { id, label });\n    throw new ProtocolError(ProtocolErrorCode.InvalidParams, 'Missing id or label');\n  }\n\n  try {\n    const gmail = gmailApi({ version: 'v1', auth: googleAuth(extra.authContext.auth) });\n\n    const labelId = await ensureLabelId(gmail, 'me', label);\n    await gmail.users.messages.modify({\n      userId: 'me',\n      id: id,\n      requestBody: {\n        addLabelIds: [labelId],\n      },\n    });\n\n    logger.info('gmail.label.add success', { id, label });\n    logger.info('gmail.label.add result (typed)', { id, label });\n\n    const result: Output = {\n      type: 'success' as const,\n      item: { id, label },\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    const message = error instanceof Error ? error.message : String(error);\n    logger.error('gmail.label.add error', { error: message });\n\n    throw new ProtocolError(ProtocolErrorCode.InternalError, `Error adding label to message: ${message}`, {\n      stack: error instanceof Error ? error.stack : undefined,\n    });\n  }\n}\n\nexport default function createTool() {\n  return {\n    name: 'label-add',\n    config,\n    handler,\n  } satisfies ToolModule;\n}\n"],"names":["gmail","gmailApi","schemas","AuthRequiredBranchSchema","ProtocolError","ProtocolErrorCode","z","ensureLabelId","googleAuth","inputSchema","object","id","coerce","string","trim","min","describe","label","successBranchSchema","type","literal","item","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","info","InvalidParams","version","auth","authContext","labelId","users","messages","modify","userId","requestBody","addLabelIds","content","text","JSON","stringify","structuredContent","error","message","Error","String","InternalError","stack","undefined","createTool","name"],"mappings":"AAAA,SAASA,SAASC,QAAQ,QAAQ,oBAAoB;AAEtD,SAASC,OAAO,QAAQ,sBAAsB;AAE9C,MAAM,EAAEC,wBAAwB,EAAE,GAAGD;AAGrC,SAASE,aAAa,EAAEC,iBAAiB,QAAQ,gBAAgB;AACjE,SAASC,CAAC,QAAQ,MAAM;AACxB,SAASC,aAAa,QAAQ,+BAA+B;AAC7D,SAASC,UAAU,QAAQ,2BAA2B;AAEtD,MAAMC,cAAcH,EAAEI,MAAM,CAAC;IAC3BC,IAAIL,EAAEM,MAAM,CAACC,MAAM,GAAGC,IAAI,GAAGC,GAAG,CAAC,GAAGC,QAAQ,CAAC;IAC7CC,OAAOX,EAAEM,MAAM,CAACC,MAAM,GAAGC,IAAI,GAAGC,GAAG,CAAC,GAAGC,QAAQ,CAAC;AAClD;AAEA,wBAAwB;AACxB,MAAME,sBAAsBZ,EAAEI,MAAM,CAAC;IACnCS,MAAMb,EAAEc,OAAO,CAAC;IAChBC,MAAMf,EAAEI,MAAM,CAAC;QACbC,IAAIL,EAAEO,MAAM,GAAGG,QAAQ,CAAC;QACxBC,OAAOX,EAAEO,MAAM,GAAGG,QAAQ,CAAC;IAC7B;AACF;AAEA,2CAA2C;AAC3C,MAAMM,eAAehB,EAAEiB,kBAAkB,CAAC,QAAQ;IAACL;IAAqBf;CAAyB;AAEjG,MAAMqB,SAAS;IACbC,aAAa;IACbhB,aAAaA;IACba,cAAchB,EAAEI,MAAM,CAAC;QACrBgB,QAAQJ;IACV;AACF;AAKA,eAAeK,QAAQ,EAAEhB,EAAE,EAAEM,KAAK,EAAS,EAAEW,KAAoB;IAC/D,MAAMC,SAASD,MAAMC,MAAM;IAC3BA,OAAOC,IAAI,CAAC,0BAA0B;QAAEnB;QAAIM;IAAM;IAElD,IAAI,CAACN,MAAM,CAACM,OAAO;QACjBY,OAAOC,IAAI,CAAC,sCAAsC;YAAEnB;YAAIM;QAAM;QAC9D,MAAM,IAAIb,cAAcC,kBAAkB0B,aAAa,EAAE;IAC3D;IAEA,IAAI;QACF,MAAM/B,QAAQC,SAAS;YAAE+B,SAAS;YAAMC,MAAMzB,WAAWoB,MAAMM,WAAW,CAACD,IAAI;QAAE;QAEjF,MAAME,UAAU,MAAM5B,cAAcP,OAAO,MAAMiB;QACjD,MAAMjB,MAAMoC,KAAK,CAACC,QAAQ,CAACC,MAAM,CAAC;YAChCC,QAAQ;YACR5B,IAAIA;YACJ6B,aAAa;gBACXC,aAAa;oBAACN;iBAAQ;YACxB;QACF;QAEAN,OAAOC,IAAI,CAAC,2BAA2B;YAAEnB;YAAIM;QAAM;QACnDY,OAAOC,IAAI,CAAC,kCAAkC;YAAEnB;YAAIM;QAAM;QAE1D,MAAMS,SAAiB;YACrBP,MAAM;YACNE,MAAM;gBAAEV;gBAAIM;YAAM;QACpB;QAEA,OAAO;YACLyB,SAAS;gBACP;oBACEvB,MAAM;oBACNwB,MAAMC,KAAKC,SAAS,CAACnB;gBACvB;aACD;YACDoB,mBAAmB;gBAAEpB;YAAO;QAC9B;IACF,EAAE,OAAOqB,OAAO;QACd,MAAMC,UAAUD,iBAAiBE,QAAQF,MAAMC,OAAO,GAAGE,OAAOH;QAChElB,OAAOkB,KAAK,CAAC,yBAAyB;YAAEA,OAAOC;QAAQ;QAEvD,MAAM,IAAI5C,cAAcC,kBAAkB8C,aAAa,EAAE,CAAC,+BAA+B,EAAEH,SAAS,EAAE;YACpGI,OAAOL,iBAAiBE,QAAQF,MAAMK,KAAK,GAAGC;QAChD;IACF;AACF;AAEA,eAAe,SAASC;IACtB,OAAO;QACLC,MAAM;QACN/B;QACAG;IACF;AACF"}

package/dist/esm/mcp/tools/label-delete.js

@@ -1,7 +1,7 @@
+import { gmail as gmailApi } from '@googleapis/gmail';
 import { schemas } from '@mcp-z/oauth-google';
 const { AuthRequiredBranchSchema } = schemas;
 import { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';
-import { google } from 'googleapis';
 import { z } from 'zod';
 import { CHUNK_SIZE, MAX_BATCH_SIZE } from '../../constants.js';
 import { googleAuth } from '../../lib/google-auth.js';
@@ -65,7 +65,7 @@ async function handler({ ids }, extra) {
         throw new ProtocolError(ProtocolErrorCode.InvalidParams, 'No valid IDs found after validation');
     }
     try {
-        const gmail = google.gmail({
+        const gmail = gmailApi({
             version: 'v1',
             auth: googleAuth(extra.authContext.auth)
         });

package/dist/esm/mcp/tools/label-delete.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-gmail/src/mcp/tools/label-delete.ts"],"sourcesContent":["import type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport { schemas } from '@mcp-z/oauth-google';\n\nconst { AuthRequiredBranchSchema } = schemas;\n\nimport type { ToolModule } from '@mcp-z/server';\nimport { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';\nimport { google } from 'googleapis';\nimport { z } from 'zod';\nimport { CHUNK_SIZE, MAX_BATCH_SIZE } from '../../constants.ts';\nimport { googleAuth } from '../../lib/google-auth.ts';\n\nconst inputSchema = z.object({\n  ids: z.array(z.coerce.string().trim().min(1)).min(1).describe('Gmail label IDs to delete'),\n});\n\nconst successBranchSchema = z.object({\n  type: z.literal('success'),\n  totalRequested: z.number().describe('Total number of labels requested to delete'),\n  successCount: z.number().describe('Number of labels successfully deleted'),\n  failureCount: z.number().describe('Number of labels that failed to delete'),\n  results: z\n    .array(\n      z.object({\n        id: z.string().describe('Label ID'),\n        success: z.boolean().describe('Whether the operation succeeded'),\n        error: z.string().optional().describe('Error message if operation failed'),\n      })\n    )\n    .describe('Individual results for each label'),\n});\n\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n  description: 'Delete Gmail labels permanently (irreversible). System labels (INBOX, SENT, etc.) cannot be deleted.',\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\nasync function handler({ ids }: Input, extra: EnrichedExtra) {\n  const logger = extra.logger;\n  logger.info('gmail-label-delete called', { count: ids.length });\n\n  if (!ids || ids.length === 0) {\n    throw new ProtocolError(ProtocolErrorCode.InvalidParams, 'Missing ids');\n  }\n\n  // Validate batch size to prevent memory exhaustion\n  if (ids.length > MAX_BATCH_SIZE) {\n    throw new ProtocolError(ProtocolErrorCode.InvalidParams, `Batch size ${ids.length} exceeds maximum allowed size of ${MAX_BATCH_SIZE}`);\n  }\n\n  // Validate and sanitize IDs\n  const validatedIds: string[] = [];\n  const invalidIds: string[] = [];\n\n  for (const id of ids) {\n    const trimmedId = id.trim();\n    if (!trimmedId) {\n      invalidIds.push(id);\n      continue;\n    }\n    // Basic Gmail label ID validation - should not contain certain characters\n    if (trimmedId.includes('/') || trimmedId.includes('\\\\') || trimmedId.includes('<') || trimmedId.includes('>')) {\n      invalidIds.push(id);\n      continue;\n    }\n    validatedIds.push(trimmedId);\n  }\n\n  if (invalidIds.length > 0) {\n    throw new ProtocolError(ProtocolErrorCode.InvalidParams, `Found ${invalidIds.length} invalid IDs: ${invalidIds.join(', ')}`);\n  }\n\n  if (validatedIds.length === 0) {\n    throw new ProtocolError(ProtocolErrorCode.InvalidParams, 'No valid IDs found after validation');\n  }\n\n  try {\n    const gmail = google.gmail({ version: 'v1', auth: googleAuth(extra.authContext.auth) });\n    // Get all labels first to check for system labels\n    const labelsResponse = await gmail.users.labels.list({ userId: 'me' });\n    const allLabels = labelsResponse.data.labels || [];\n    const labelMap = new Map(allLabels.map((label) => [label.id || '', label]));\n\n    // Process deletions in chunks to prevent memory exhaustion\n    const allResults: Array<{ id: string; success: boolean; error?: string }> = [];\n\n    for (let i = 0; i < validatedIds.length; i += CHUNK_SIZE) {\n      const chunk = validatedIds.slice(i, i + CHUNK_SIZE);\n      logger.info('Processing chunk', { chunkIndex: i / CHUNK_SIZE + 1, chunkSize: chunk.length, totalChunks: Math.ceil(validatedIds.length / CHUNK_SIZE) });\n\n      const chunkResults = await Promise.allSettled(\n        chunk.map(async (id) => {\n          const label = labelMap.get(id);\n\n          // Check if label exists\n          if (!label) {\n            throw new Error(`Label not found: ${id}`);\n          }\n\n          // Check if it's a system label\n          if (label.type === 'system') {\n            throw new Error(`Cannot delete system label: ${label.name} (${id})`);\n          }\n\n          // Delete the label\n          await gmail.users.labels.delete({\n            userId: 'me',\n            id: id,\n          });\n          return { id, success: true };\n        })\n      );\n\n      // Process chunk results\n      const processedChunkResults = chunkResults.map((result, chunkIndex) => {\n        const id = chunk[chunkIndex];\n        if (!id) {\n          throw new Error(`Chunk index ${chunkIndex} is out of bounds for chunk of size ${chunk.length}`);\n        }\n        if (result.status === 'fulfilled') {\n          return { id, success: true };\n        }\n\n        // Extract error message more robustly\n        let errorMessage = 'Unknown error';\n        if (result.reason) {\n          if (typeof result.reason === 'string') {\n            errorMessage = result.reason;\n          } else if (result.reason instanceof Error) {\n            errorMessage = result.reason.message;\n          } else if (result.reason && typeof result.reason === 'object' && 'message' in result.reason) {\n            errorMessage = String(result.reason.message);\n          } else if (result.reason && typeof result.reason === 'object' && 'error' in result.reason) {\n            errorMessage = String(result.reason.error);\n          } else {\n            errorMessage = String(result.reason);\n          }\n        }\n\n        return { id, success: false, error: errorMessage };\n      });\n\n      allResults.push(...processedChunkResults);\n    }\n\n    const successCount = allResults.filter((r) => r.success).length;\n    const failureCount = allResults.filter((r) => !r.success).length;\n\n    logger.info('gmail-label-delete completed', {\n      totalRequested: validatedIds.length,\n      successCount,\n      failureCount,\n      chunksProcessed: Math.ceil(validatedIds.length / CHUNK_SIZE),\n    });\n\n    const result: Output = {\n      type: 'success' as const,\n      totalRequested: validatedIds.length,\n      successCount,\n      failureCount,\n      results: allResults,\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    const message = error instanceof Error ? error.message : String(error);\n    logger.error('gmail-label-delete error', { error: message });\n\n    throw new ProtocolError(ProtocolErrorCode.InternalError, `Error deleting labels: ${message}`, {\n      stack: error instanceof Error ? error.stack : undefined,\n    });\n  }\n}\n\nexport default function createTool() {\n  return {\n    name: 'label-delete',\n    config,\n    handler,\n  } satisfies ToolModule;\n}\n"],"names":["schemas","AuthRequiredBranchSchema","ProtocolError","ProtocolErrorCode","google","z","CHUNK_SIZE","MAX_BATCH_SIZE","googleAuth","inputSchema","object","ids","array","coerce","string","trim","min","describe","successBranchSchema","type","literal","totalRequested","number","successCount","failureCount","results","id","success","boolean","error","optional","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","info","count","length","InvalidParams","validatedIds","invalidIds","trimmedId","push","includes","join","gmail","version","auth","authContext","labelsResponse","users","labels","list","userId","allLabels","data","labelMap","Map","map","label","allResults","i","chunk","slice","chunkIndex","chunkSize","totalChunks","Math","ceil","chunkResults","Promise","allSettled","get","Error","name","delete","processedChunkResults","status","errorMessage","reason","message","String","filter","r","chunksProcessed","content","text","JSON","stringify","structuredContent","InternalError","stack","undefined","createTool"],"mappings":"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"}
+{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-gmail/src/mcp/tools/label-delete.ts"],"sourcesContent":["import { gmail as gmailApi } from '@googleapis/gmail';\nimport type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport { schemas } from '@mcp-z/oauth-google';\n\nconst { AuthRequiredBranchSchema } = schemas;\n\nimport type { ToolModule } from '@mcp-z/server';\nimport { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';\nimport { z } from 'zod';\nimport { CHUNK_SIZE, MAX_BATCH_SIZE } from '../../constants.ts';\nimport { googleAuth } from '../../lib/google-auth.ts';\n\nconst inputSchema = z.object({\n  ids: z.array(z.coerce.string().trim().min(1)).min(1).describe('Gmail label IDs to delete'),\n});\n\nconst successBranchSchema = z.object({\n  type: z.literal('success'),\n  totalRequested: z.number().describe('Total number of labels requested to delete'),\n  successCount: z.number().describe('Number of labels successfully deleted'),\n  failureCount: z.number().describe('Number of labels that failed to delete'),\n  results: z\n    .array(\n      z.object({\n        id: z.string().describe('Label ID'),\n        success: z.boolean().describe('Whether the operation succeeded'),\n        error: z.string().optional().describe('Error message if operation failed'),\n      })\n    )\n    .describe('Individual results for each label'),\n});\n\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n  description: 'Delete Gmail labels permanently (irreversible). System labels (INBOX, SENT, etc.) cannot be deleted.',\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\nasync function handler({ ids }: Input, extra: EnrichedExtra) {\n  const logger = extra.logger;\n  logger.info('gmail-label-delete called', { count: ids.length });\n\n  if (!ids || ids.length === 0) {\n    throw new ProtocolError(ProtocolErrorCode.InvalidParams, 'Missing ids');\n  }\n\n  // Validate batch size to prevent memory exhaustion\n  if (ids.length > MAX_BATCH_SIZE) {\n    throw new ProtocolError(ProtocolErrorCode.InvalidParams, `Batch size ${ids.length} exceeds maximum allowed size of ${MAX_BATCH_SIZE}`);\n  }\n\n  // Validate and sanitize IDs\n  const validatedIds: string[] = [];\n  const invalidIds: string[] = [];\n\n  for (const id of ids) {\n    const trimmedId = id.trim();\n    if (!trimmedId) {\n      invalidIds.push(id);\n      continue;\n    }\n    // Basic Gmail label ID validation - should not contain certain characters\n    if (trimmedId.includes('/') || trimmedId.includes('\\\\') || trimmedId.includes('<') || trimmedId.includes('>')) {\n      invalidIds.push(id);\n      continue;\n    }\n    validatedIds.push(trimmedId);\n  }\n\n  if (invalidIds.length > 0) {\n    throw new ProtocolError(ProtocolErrorCode.InvalidParams, `Found ${invalidIds.length} invalid IDs: ${invalidIds.join(', ')}`);\n  }\n\n  if (validatedIds.length === 0) {\n    throw new ProtocolError(ProtocolErrorCode.InvalidParams, 'No valid IDs found after validation');\n  }\n\n  try {\n    const gmail = gmailApi({ version: 'v1', auth: googleAuth(extra.authContext.auth) });\n    // Get all labels first to check for system labels\n    const labelsResponse = await gmail.users.labels.list({ userId: 'me' });\n    const allLabels = labelsResponse.data.labels || [];\n    const labelMap = new Map(allLabels.map((label) => [label.id || '', label]));\n\n    // Process deletions in chunks to prevent memory exhaustion\n    const allResults: Array<{ id: string; success: boolean; error?: string }> = [];\n\n    for (let i = 0; i < validatedIds.length; i += CHUNK_SIZE) {\n      const chunk = validatedIds.slice(i, i + CHUNK_SIZE);\n      logger.info('Processing chunk', { chunkIndex: i / CHUNK_SIZE + 1, chunkSize: chunk.length, totalChunks: Math.ceil(validatedIds.length / CHUNK_SIZE) });\n\n      const chunkResults = await Promise.allSettled(\n        chunk.map(async (id) => {\n          const label = labelMap.get(id);\n\n          // Check if label exists\n          if (!label) {\n            throw new Error(`Label not found: ${id}`);\n          }\n\n          // Check if it's a system label\n          if (label.type === 'system') {\n            throw new Error(`Cannot delete system label: ${label.name} (${id})`);\n          }\n\n          // Delete the label\n          await gmail.users.labels.delete({\n            userId: 'me',\n            id: id,\n          });\n          return { id, success: true };\n        })\n      );\n\n      // Process chunk results\n      const processedChunkResults = chunkResults.map((result, chunkIndex) => {\n        const id = chunk[chunkIndex];\n        if (!id) {\n          throw new Error(`Chunk index ${chunkIndex} is out of bounds for chunk of size ${chunk.length}`);\n        }\n        if (result.status === 'fulfilled') {\n          return { id, success: true };\n        }\n\n        // Extract error message more robustly\n        let errorMessage = 'Unknown error';\n        if (result.reason) {\n          if (typeof result.reason === 'string') {\n            errorMessage = result.reason;\n          } else if (result.reason instanceof Error) {\n            errorMessage = result.reason.message;\n          } else if (result.reason && typeof result.reason === 'object' && 'message' in result.reason) {\n            errorMessage = String(result.reason.message);\n          } else if (result.reason && typeof result.reason === 'object' && 'error' in result.reason) {\n            errorMessage = String(result.reason.error);\n          } else {\n            errorMessage = String(result.reason);\n          }\n        }\n\n        return { id, success: false, error: errorMessage };\n      });\n\n      allResults.push(...processedChunkResults);\n    }\n\n    const successCount = allResults.filter((r) => r.success).length;\n    const failureCount = allResults.filter((r) => !r.success).length;\n\n    logger.info('gmail-label-delete completed', {\n      totalRequested: validatedIds.length,\n      successCount,\n      failureCount,\n      chunksProcessed: Math.ceil(validatedIds.length / CHUNK_SIZE),\n    });\n\n    const result: Output = {\n      type: 'success' as const,\n      totalRequested: validatedIds.length,\n      successCount,\n      failureCount,\n      results: allResults,\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    const message = error instanceof Error ? error.message : String(error);\n    logger.error('gmail-label-delete error', { error: message });\n\n    throw new ProtocolError(ProtocolErrorCode.InternalError, `Error deleting labels: ${message}`, {\n      stack: error instanceof Error ? error.stack : undefined,\n    });\n  }\n}\n\nexport default function createTool() {\n  return {\n    name: 'label-delete',\n    config,\n    handler,\n  } satisfies ToolModule;\n}\n"],"names":["gmail","gmailApi","schemas","AuthRequiredBranchSchema","ProtocolError","ProtocolErrorCode","z","CHUNK_SIZE","MAX_BATCH_SIZE","googleAuth","inputSchema","object","ids","array","coerce","string","trim","min","describe","successBranchSchema","type","literal","totalRequested","number","successCount","failureCount","results","id","success","boolean","error","optional","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","info","count","length","InvalidParams","validatedIds","invalidIds","trimmedId","push","includes","join","version","auth","authContext","labelsResponse","users","labels","list","userId","allLabels","data","labelMap","Map","map","label","allResults","i","chunk","slice","chunkIndex","chunkSize","totalChunks","Math","ceil","chunkResults","Promise","allSettled","get","Error","name","delete","processedChunkResults","status","errorMessage","reason","message","String","filter","r","chunksProcessed","content","text","JSON","stringify","structuredContent","InternalError","stack","undefined","createTool"],"mappings":"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"}

package/dist/esm/mcp/tools/labels-list.js

@@ -1,7 +1,7 @@
+import { gmail as gmailApi } from '@googleapis/gmail';
 import { schemas } from '@mcp-z/oauth-google';
 const { AuthRequiredBranchSchema } = schemas;
 import { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';
-import { google } from 'googleapis';
 import { z } from 'zod';
 import { googleAuth } from '../../lib/google-auth.js';
 // Schema for individual label items
@@ -40,7 +40,7 @@ async function handler(_, extra) {
     const logger = extra.logger;
     logger.info('gmail.labels.list called');
     try {
-        const gmail = google.gmail({
+        const gmail = gmailApi({
             version: 'v1',
             auth: googleAuth(extra.authContext.auth)
         });

package/dist/esm/mcp/tools/labels-list.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-gmail/src/mcp/tools/labels-list.ts"],"sourcesContent":["import type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport { schemas } from '@mcp-z/oauth-google';\n\nconst { AuthRequiredBranchSchema } = schemas;\n\nimport type { ToolModule } from '@mcp-z/server';\nimport { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';\nimport { google } from 'googleapis';\nimport { z } from 'zod';\nimport { googleAuth } from '../../lib/google-auth.ts';\n\n// Schema for individual label items\nconst LabelSchema = z.object({\n  id: z.string().describe('Gmail label ID'),\n  name: z.string().describe('Label name for use in queries (case-sensitive)'),\n  type: z.enum(['user', 'system']).describe('Whether this is a user-created or system label'),\n  visibility: z.enum(['labelShow', 'labelHide', 'labelShowIfUnread']).describe('Label visibility in Gmail UI'),\n});\n\n/**\n * Input schema for the labels-list tool (currently empty as this tool takes no parameters).\n */\nexport const inputSchema = z.object({});\n\nconst successBranchSchema = z.object({\n  type: z.literal('success'),\n  items: z.array(LabelSchema),\n});\n\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n  description: 'List Gmail labels for label: query syntax. Case-sensitive.',\n  inputSchema: inputSchema,\n  outputSchema: z.object({\n    result: outputSchema,\n  }),\n} as const;\n\n/**\n * Input parameters for the labels-list tool.\n */\nexport type Input = z.infer<typeof inputSchema>;\nexport type Output = z.infer<typeof outputSchema>;\n\nasync function handler(_: Input, extra: EnrichedExtra) {\n  const logger = extra.logger;\n  logger.info('gmail.labels.list called');\n\n  try {\n    const gmail = google.gmail({ version: 'v1', auth: googleAuth(extra.authContext.auth) });\n    const started = Date.now();\n\n    // Fetch all labels from Gmail API\n    const response = await gmail.users.labels.list({ userId: 'me' });\n    const labels = response.data.labels || [];\n\n    // Filter out CATEGORY_* labels (handled by categories tool) and map to our schema\n    const availableLabels = labels\n      .filter((label) => {\n        // Exclude CATEGORY_* labels as they're handled by the categories tool\n        return !label.id?.startsWith('CATEGORY_');\n      })\n      .map((label) => {\n        const id = label.id as string;\n        const name = label.name || id;\n\n        // Determine label type\n        const type: 'user' | 'system' = label.type === 'user' ? 'user' : 'system';\n\n        // Map label visibility\n        let visibility: 'labelShow' | 'labelHide' | 'labelShowIfUnread' = 'labelShow';\n        if (label.labelListVisibility === 'labelHide') {\n          visibility = 'labelHide';\n        } else if (label.labelListVisibility === 'labelShowIfUnread') {\n          visibility = 'labelShowIfUnread';\n        }\n\n        return {\n          id,\n          name,\n          type,\n          visibility,\n        };\n      })\n      .sort((a, b) => {\n        // Sort user labels first, then system labels, both alphabetically\n        if (a.type !== b.type) {\n          return a.type === 'user' ? -1 : 1;\n        }\n        // Use simple ASCII comparison for consistent, case-sensitive sorting\n        return a.name < b.name ? -1 : a.name > b.name ? 1 : 0;\n      });\n\n    const durationMs = Date.now() - started;\n\n    logger.info('gmail.labels.list results', {\n      labelCount: availableLabels.length,\n      userLabels: availableLabels.filter((l) => l.type === 'user').length,\n      systemLabels: availableLabels.filter((l) => l.type === 'system').length,\n      totalLabels: labels.length,\n    });\n    logger.info('gmail.labels.list metrics', { durationMs });\n\n    const result: Output = {\n      type: 'success' as const,\n      items: availableLabels,\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    const message = error instanceof Error ? error.message : String(error);\n    logger.error('gmail.labels.list error', { error: message });\n\n    throw new ProtocolError(ProtocolErrorCode.InternalError, `Error listing labels: ${message}`, {\n      stack: error instanceof Error ? error.stack : undefined,\n    });\n  }\n}\n\nexport default function createTool() {\n  return {\n    name: 'labels-list',\n    config,\n    handler,\n  } satisfies ToolModule;\n}\n"],"names":["schemas","AuthRequiredBranchSchema","ProtocolError","ProtocolErrorCode","google","z","googleAuth","LabelSchema","object","id","string","describe","name","type","enum","visibility","inputSchema","successBranchSchema","literal","items","array","outputSchema","discriminatedUnion","config","description","result","handler","_","extra","logger","info","gmail","version","auth","authContext","started","Date","now","response","users","labels","list","userId","data","availableLabels","filter","label","startsWith","map","labelListVisibility","sort","a","b","durationMs","labelCount","length","userLabels","l","systemLabels","totalLabels","content","text","JSON","stringify","structuredContent","error","message","Error","String","InternalError","stack","undefined","createTool"],"mappings":"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"}
+{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-gmail/src/mcp/tools/labels-list.ts"],"sourcesContent":["import { gmail as gmailApi } from '@googleapis/gmail';\nimport type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport { schemas } from '@mcp-z/oauth-google';\n\nconst { AuthRequiredBranchSchema } = schemas;\n\nimport type { ToolModule } from '@mcp-z/server';\nimport { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';\nimport { z } from 'zod';\nimport { googleAuth } from '../../lib/google-auth.ts';\n\n// Schema for individual label items\nconst LabelSchema = z.object({\n  id: z.string().describe('Gmail label ID'),\n  name: z.string().describe('Label name for use in queries (case-sensitive)'),\n  type: z.enum(['user', 'system']).describe('Whether this is a user-created or system label'),\n  visibility: z.enum(['labelShow', 'labelHide', 'labelShowIfUnread']).describe('Label visibility in Gmail UI'),\n});\n\n/**\n * Input schema for the labels-list tool (currently empty as this tool takes no parameters).\n */\nexport const inputSchema = z.object({});\n\nconst successBranchSchema = z.object({\n  type: z.literal('success'),\n  items: z.array(LabelSchema),\n});\n\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n  description: 'List Gmail labels for label: query syntax. Case-sensitive.',\n  inputSchema: inputSchema,\n  outputSchema: z.object({\n    result: outputSchema,\n  }),\n} as const;\n\n/**\n * Input parameters for the labels-list tool.\n */\nexport type Input = z.infer<typeof inputSchema>;\nexport type Output = z.infer<typeof outputSchema>;\n\nasync function handler(_: Input, extra: EnrichedExtra) {\n  const logger = extra.logger;\n  logger.info('gmail.labels.list called');\n\n  try {\n    const gmail = gmailApi({ version: 'v1', auth: googleAuth(extra.authContext.auth) });\n    const started = Date.now();\n\n    // Fetch all labels from Gmail API\n    const response = await gmail.users.labels.list({ userId: 'me' });\n    const labels = response.data.labels || [];\n\n    // Filter out CATEGORY_* labels (handled by categories tool) and map to our schema\n    const availableLabels = labels\n      .filter((label) => {\n        // Exclude CATEGORY_* labels as they're handled by the categories tool\n        return !label.id?.startsWith('CATEGORY_');\n      })\n      .map((label) => {\n        const id = label.id as string;\n        const name = label.name || id;\n\n        // Determine label type\n        const type: 'user' | 'system' = label.type === 'user' ? 'user' : 'system';\n\n        // Map label visibility\n        let visibility: 'labelShow' | 'labelHide' | 'labelShowIfUnread' = 'labelShow';\n        if (label.labelListVisibility === 'labelHide') {\n          visibility = 'labelHide';\n        } else if (label.labelListVisibility === 'labelShowIfUnread') {\n          visibility = 'labelShowIfUnread';\n        }\n\n        return {\n          id,\n          name,\n          type,\n          visibility,\n        };\n      })\n      .sort((a, b) => {\n        // Sort user labels first, then system labels, both alphabetically\n        if (a.type !== b.type) {\n          return a.type === 'user' ? -1 : 1;\n        }\n        // Use simple ASCII comparison for consistent, case-sensitive sorting\n        return a.name < b.name ? -1 : a.name > b.name ? 1 : 0;\n      });\n\n    const durationMs = Date.now() - started;\n\n    logger.info('gmail.labels.list results', {\n      labelCount: availableLabels.length,\n      userLabels: availableLabels.filter((l) => l.type === 'user').length,\n      systemLabels: availableLabels.filter((l) => l.type === 'system').length,\n      totalLabels: labels.length,\n    });\n    logger.info('gmail.labels.list metrics', { durationMs });\n\n    const result: Output = {\n      type: 'success' as const,\n      items: availableLabels,\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    const message = error instanceof Error ? error.message : String(error);\n    logger.error('gmail.labels.list error', { error: message });\n\n    throw new ProtocolError(ProtocolErrorCode.InternalError, `Error listing labels: ${message}`, {\n      stack: error instanceof Error ? error.stack : undefined,\n    });\n  }\n}\n\nexport default function createTool() {\n  return {\n    name: 'labels-list',\n    config,\n    handler,\n  } satisfies ToolModule;\n}\n"],"names":["gmail","gmailApi","schemas","AuthRequiredBranchSchema","ProtocolError","ProtocolErrorCode","z","googleAuth","LabelSchema","object","id","string","describe","name","type","enum","visibility","inputSchema","successBranchSchema","literal","items","array","outputSchema","discriminatedUnion","config","description","result","handler","_","extra","logger","info","version","auth","authContext","started","Date","now","response","users","labels","list","userId","data","availableLabels","filter","label","startsWith","map","labelListVisibility","sort","a","b","durationMs","labelCount","length","userLabels","l","systemLabels","totalLabels","content","text","JSON","stringify","structuredContent","error","message","Error","String","InternalError","stack","undefined","createTool"],"mappings":"AAAA,SAASA,SAASC,QAAQ,QAAQ,oBAAoB;AAEtD,SAASC,OAAO,QAAQ,sBAAsB;AAE9C,MAAM,EAAEC,wBAAwB,EAAE,GAAGD;AAGrC,SAASE,aAAa,EAAEC,iBAAiB,QAAQ,gBAAgB;AACjE,SAASC,CAAC,QAAQ,MAAM;AACxB,SAASC,UAAU,QAAQ,2BAA2B;AAEtD,oCAAoC;AACpC,MAAMC,cAAcF,EAAEG,MAAM,CAAC;IAC3BC,IAAIJ,EAAEK,MAAM,GAAGC,QAAQ,CAAC;IACxBC,MAAMP,EAAEK,MAAM,GAAGC,QAAQ,CAAC;IAC1BE,MAAMR,EAAES,IAAI,CAAC;QAAC;QAAQ;KAAS,EAAEH,QAAQ,CAAC;IAC1CI,YAAYV,EAAES,IAAI,CAAC;QAAC;QAAa;QAAa;KAAoB,EAAEH,QAAQ,CAAC;AAC/E;AAEA;;CAEC,GACD,OAAO,MAAMK,cAAcX,EAAEG,MAAM,CAAC,CAAC,GAAG;AAExC,MAAMS,sBAAsBZ,EAAEG,MAAM,CAAC;IACnCK,MAAMR,EAAEa,OAAO,CAAC;IAChBC,OAAOd,EAAEe,KAAK,CAACb;AACjB;AAEA,MAAMc,eAAehB,EAAEiB,kBAAkB,CAAC,QAAQ;IAACL;IAAqBf;CAAyB;AAEjG,MAAMqB,SAAS;IACbC,aAAa;IACbR,aAAaA;IACbK,cAAchB,EAAEG,MAAM,CAAC;QACrBiB,QAAQJ;IACV;AACF;AAQA,eAAeK,QAAQC,CAAQ,EAAEC,KAAoB;IACnD,MAAMC,SAASD,MAAMC,MAAM;IAC3BA,OAAOC,IAAI,CAAC;IAEZ,IAAI;QACF,MAAM/B,QAAQC,SAAS;YAAE+B,SAAS;YAAMC,MAAM1B,WAAWsB,MAAMK,WAAW,CAACD,IAAI;QAAE;QACjF,MAAME,UAAUC,KAAKC,GAAG;QAExB,kCAAkC;QAClC,MAAMC,WAAW,MAAMtC,MAAMuC,KAAK,CAACC,MAAM,CAACC,IAAI,CAAC;YAAEC,QAAQ;QAAK;QAC9D,MAAMF,SAASF,SAASK,IAAI,CAACH,MAAM,IAAI,EAAE;QAEzC,kFAAkF;QAClF,MAAMI,kBAAkBJ,OACrBK,MAAM,CAAC,CAACC;gBAECA;YADR,sEAAsE;YACtE,OAAO,GAACA,YAAAA,MAAMpC,EAAE,cAARoC,gCAAAA,UAAUC,UAAU,CAAC;QAC/B,GACCC,GAAG,CAAC,CAACF;YACJ,MAAMpC,KAAKoC,MAAMpC,EAAE;YACnB,MAAMG,OAAOiC,MAAMjC,IAAI,IAAIH;YAE3B,uBAAuB;YACvB,MAAMI,OAA0BgC,MAAMhC,IAAI,KAAK,SAAS,SAAS;YAEjE,uBAAuB;YACvB,IAAIE,aAA8D;YAClE,IAAI8B,MAAMG,mBAAmB,KAAK,aAAa;gBAC7CjC,aAAa;YACf,OAAO,IAAI8B,MAAMG,mBAAmB,KAAK,qBAAqB;gBAC5DjC,aAAa;YACf;YAEA,OAAO;gBACLN;gBACAG;gBACAC;gBACAE;YACF;QACF,GACCkC,IAAI,CAAC,CAACC,GAAGC;YACR,kEAAkE;YAClE,IAAID,EAAErC,IAAI,KAAKsC,EAAEtC,IAAI,EAAE;gBACrB,OAAOqC,EAAErC,IAAI,KAAK,SAAS,CAAC,IAAI;YAClC;YACA,qEAAqE;YACrE,OAAOqC,EAAEtC,IAAI,GAAGuC,EAAEvC,IAAI,GAAG,CAAC,IAAIsC,EAAEtC,IAAI,GAAGuC,EAAEvC,IAAI,GAAG,IAAI;QACtD;QAEF,MAAMwC,aAAajB,KAAKC,GAAG,KAAKF;QAEhCL,OAAOC,IAAI,CAAC,6BAA6B;YACvCuB,YAAYV,gBAAgBW,MAAM;YAClCC,YAAYZ,gBAAgBC,MAAM,CAAC,CAACY,IAAMA,EAAE3C,IAAI,KAAK,QAAQyC,MAAM;YACnEG,cAAcd,gBAAgBC,MAAM,CAAC,CAACY,IAAMA,EAAE3C,IAAI,KAAK,UAAUyC,MAAM;YACvEI,aAAanB,OAAOe,MAAM;QAC5B;QACAzB,OAAOC,IAAI,CAAC,6BAA6B;YAAEsB;QAAW;QAEtD,MAAM3B,SAAiB;YACrBZ,MAAM;YACNM,OAAOwB;QACT;QAEA,OAAO;YACLgB,SAAS;gBACP;oBACE9C,MAAM;oBACN+C,MAAMC,KAAKC,SAAS,CAACrC;gBACvB;aACD;YACDsC,mBAAmB;gBAAEtC;YAAO;QAC9B;IACF,EAAE,OAAOuC,OAAO;QACd,MAAMC,UAAUD,iBAAiBE,QAAQF,MAAMC,OAAO,GAAGE,OAAOH;QAChEnC,OAAOmC,KAAK,CAAC,2BAA2B;YAAEA,OAAOC;QAAQ;QAEzD,MAAM,IAAI9D,cAAcC,kBAAkBgE,aAAa,EAAE,CAAC,sBAAsB,EAAEH,SAAS,EAAE;YAC3FI,OAAOL,iBAAiBE,QAAQF,MAAMK,KAAK,GAAGC;QAChD;IACF;AACF;AAEA,eAAe,SAASC;IACtB,OAAO;QACL3D,MAAM;QACNW;QACAG;IACF;AACF"}

package/dist/esm/mcp/tools/message-get.js

@@ -1,8 +1,8 @@
+import { gmail as gmailApi } from '@googleapis/gmail';
 import { EMAIL_COMMON_PATTERNS, EMAIL_FIELD_DESCRIPTIONS, EMAIL_FIELDS, EmailContentTypeSchema, EmailDetailSchema, ExcludeThreadHistorySchema } from '@mcp-z/email';
 import { schemas } from '@mcp-z/oauth-google';
 const { AuthRequiredBranchSchema } = schemas;
 import { createFieldsSchema, filterFields, ProtocolError, ProtocolErrorCode, parseFields } from '@mcp-z/server';
-import { google } from 'googleapis';
 import { z } from 'zod';
 import { extractBodyFromPayload, extractEmails, extractFrom } from '../../email/parsing/message-extraction.js';
 import { toIsoUtc } from '../../lib/date-conversion.js';
@@ -48,7 +48,7 @@ async function handler({ id, fields, contentType, excludeThreadHistory }, extra)
         if (!id) {
             throw new ProtocolError(ProtocolErrorCode.InvalidParams, 'Missing id');
         }
-        const gmail = google.gmail({
+        const gmail = gmailApi({
             version: 'v1',
             auth: googleAuth(extra.authContext.auth)
         });

package/dist/esm/mcp/tools/message-get.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-gmail/src/mcp/tools/message-get.ts"],"sourcesContent":["import { EMAIL_COMMON_PATTERNS, EMAIL_FIELD_DESCRIPTIONS, EMAIL_FIELDS, EmailContentTypeSchema, type EmailDetail, EmailDetailSchema, 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 { createFieldsSchema, filterFields, ProtocolError, ProtocolErrorCode, parseFields, type ToolModule } from '@mcp-z/server';\nimport { type gmail_v1, google } from 'googleapis';\nimport { z } from 'zod';\nimport { extractBodyFromPayload, extractEmails, extractFrom } from '../../email/parsing/message-extraction.ts';\nimport { toIsoUtc } from '../../lib/date-conversion.ts';\nimport { googleAuth } from '../../lib/google-auth.ts';\n\nconst inputSchema = z.object({\n  id: z.coerce.string().trim().min(1).describe('Gmail message ID to retrieve'),\n  fields: createFieldsSchema({\n    availableFields: EMAIL_FIELDS,\n    fieldDescriptions: EMAIL_FIELD_DESCRIPTIONS,\n    commonPatterns: EMAIL_COMMON_PATTERNS,\n    resourceName: 'email message',\n  }),\n  contentType: EmailContentTypeSchema,\n  excludeThreadHistory: ExcludeThreadHistorySchema,\n});\n\n// Success branch schema\nconst successBranchSchema = z.object({\n  type: z.literal('success'),\n  item: EmailDetailSchema,\n});\n\n// Output schema with auth_required support\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n  description: 'Get a Gmail message by ID with flexible field selection',\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\nasync function handler({ id, fields, contentType, excludeThreadHistory }: Input, extra: EnrichedExtra) {\n  const logger = extra.logger;\n\n  const requestedFields = parseFields(fields, EMAIL_FIELDS);\n\n  logger.info('gmail.message.get called', { id: Boolean(id), fields: fields || 'all' });\n\n  try {\n    if (!id) {\n      throw new ProtocolError(ProtocolErrorCode.InvalidParams, 'Missing id');\n    }\n\n    const gmail = google.gmail({ version: 'v1', auth: googleAuth(extra.authContext.auth) });\n    const response = await gmail.users.messages.get({\n      userId: 'me',\n      id: id,\n      format: 'full',\n      metadataHeaders: ['From', 'To', 'Cc', 'Bcc', 'Subject', 'Date'],\n    });\n    const fullData = response.data;\n    if (!fullData) {\n      throw new ProtocolError(ProtocolErrorCode.InvalidRequest, 'Message not found');\n    }\n\n    // Build full message data with type guards\n    const headers = fullData?.payload?.headers;\n    const headersArray = Array.isArray(headers) ? headers : [];\n    const headersMap: Record<string, string> = Object.fromEntries(\n      headersArray.map((h: unknown) => {\n        const header = h as gmail_v1.Schema$MessagePartHeader;\n        return [String(header.name ?? ''), String(header.value ?? '')];\n      })\n    );\n    const fromInfo = extractFrom(headersMap.From);\n    const toStr = extractEmails(headersMap.To).join(', ');\n    const ccStr = extractEmails(headersMap.Cc).join(', ');\n    const bccStr = extractEmails(headersMap.Bcc).join(', ');\n    const messagePayload = fullData?.payload;\n    const bodyContent = messagePayload ? extractBodyFromPayload(messagePayload, { contentType, excludeThreadHistory }) : '';\n    const payload: Partial<EmailDetail> = {\n      id: fullData.id ?? undefined,\n      threadId: fullData.threadId ?? undefined,\n      date: toIsoUtc(headersMap.Date) || headersMap.Date,\n      from: fromInfo?.address || headersMap.From,\n      fromName: fromInfo?.name,\n      to: toStr,\n      cc: ccStr,\n      bcc: bccStr,\n      subject: headersMap.Subject ?? '',\n      snippet: fullData.snippet ?? undefined,\n      body: bodyContent,\n      bodyContentType: contentType,\n    };\n\n    // Filter based on requested fields\n    const filteredPayload = filterFields(payload, requestedFields);\n\n    logger.info('gmail.message.get result', { id: fullData.id, subject: payload.subject, from: payload.from, fields: fields || 'all' });\n\n    const result: Output = {\n      type: 'success' as const,\n      item: filteredPayload,\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    const message = error instanceof Error ? error.message : String(error);\n    logger.error('gmail.message.get error', { error: message });\n\n    throw new ProtocolError(ProtocolErrorCode.InternalError, `Error getting message: ${message}`, {\n      stack: error instanceof Error ? error.stack : undefined,\n    });\n  }\n}\n\nexport default function createTool() {\n  return {\n    name: 'message-get',\n    config,\n    handler,\n  } satisfies ToolModule;\n}\n"],"names":["EMAIL_COMMON_PATTERNS","EMAIL_FIELD_DESCRIPTIONS","EMAIL_FIELDS","EmailContentTypeSchema","EmailDetailSchema","ExcludeThreadHistorySchema","schemas","AuthRequiredBranchSchema","createFieldsSchema","filterFields","ProtocolError","ProtocolErrorCode","parseFields","google","z","extractBodyFromPayload","extractEmails","extractFrom","toIsoUtc","googleAuth","inputSchema","object","id","coerce","string","trim","min","describe","fields","availableFields","fieldDescriptions","commonPatterns","resourceName","contentType","excludeThreadHistory","successBranchSchema","type","literal","item","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","requestedFields","info","Boolean","fullData","headersMap","InvalidParams","gmail","version","auth","authContext","response","users","messages","get","userId","format","metadataHeaders","data","InvalidRequest","headers","payload","headersArray","Array","isArray","Object","fromEntries","map","h","header","String","name","value","fromInfo","From","toStr","To","join","ccStr","Cc","bccStr","Bcc","messagePayload","bodyContent","undefined","threadId","date","Date","from","address","fromName","to","cc","bcc","subject","Subject","snippet","body","bodyContentType","filteredPayload","content","text","JSON","stringify","structuredContent","error","message","Error","InternalError","stack","createTool"],"mappings":"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"}
+{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-gmail/src/mcp/tools/message-get.ts"],"sourcesContent":["import { type gmail_v1, gmail as gmailApi } from '@googleapis/gmail';\nimport { EMAIL_COMMON_PATTERNS, EMAIL_FIELD_DESCRIPTIONS, EMAIL_FIELDS, EmailContentTypeSchema, type EmailDetail, EmailDetailSchema, 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 { createFieldsSchema, filterFields, ProtocolError, ProtocolErrorCode, parseFields, type ToolModule } from '@mcp-z/server';\nimport { z } from 'zod';\nimport { extractBodyFromPayload, extractEmails, extractFrom } from '../../email/parsing/message-extraction.ts';\nimport { toIsoUtc } from '../../lib/date-conversion.ts';\nimport { googleAuth } from '../../lib/google-auth.ts';\n\nconst inputSchema = z.object({\n  id: z.coerce.string().trim().min(1).describe('Gmail message ID to retrieve'),\n  fields: createFieldsSchema({\n    availableFields: EMAIL_FIELDS,\n    fieldDescriptions: EMAIL_FIELD_DESCRIPTIONS,\n    commonPatterns: EMAIL_COMMON_PATTERNS,\n    resourceName: 'email message',\n  }),\n  contentType: EmailContentTypeSchema,\n  excludeThreadHistory: ExcludeThreadHistorySchema,\n});\n\n// Success branch schema\nconst successBranchSchema = z.object({\n  type: z.literal('success'),\n  item: EmailDetailSchema,\n});\n\n// Output schema with auth_required support\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n  description: 'Get a Gmail message by ID with flexible field selection',\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\nasync function handler({ id, fields, contentType, excludeThreadHistory }: Input, extra: EnrichedExtra) {\n  const logger = extra.logger;\n\n  const requestedFields = parseFields(fields, EMAIL_FIELDS);\n\n  logger.info('gmail.message.get called', { id: Boolean(id), fields: fields || 'all' });\n\n  try {\n    if (!id) {\n      throw new ProtocolError(ProtocolErrorCode.InvalidParams, 'Missing id');\n    }\n\n    const gmail = gmailApi({ version: 'v1', auth: googleAuth(extra.authContext.auth) });\n    const response = await gmail.users.messages.get({\n      userId: 'me',\n      id: id,\n      format: 'full',\n      metadataHeaders: ['From', 'To', 'Cc', 'Bcc', 'Subject', 'Date'],\n    });\n    const fullData = response.data;\n    if (!fullData) {\n      throw new ProtocolError(ProtocolErrorCode.InvalidRequest, 'Message not found');\n    }\n\n    // Build full message data with type guards\n    const headers = fullData?.payload?.headers;\n    const headersArray = Array.isArray(headers) ? headers : [];\n    const headersMap: Record<string, string> = Object.fromEntries(\n      headersArray.map((h: unknown) => {\n        const header = h as gmail_v1.Schema$MessagePartHeader;\n        return [String(header.name ?? ''), String(header.value ?? '')];\n      })\n    );\n    const fromInfo = extractFrom(headersMap.From);\n    const toStr = extractEmails(headersMap.To).join(', ');\n    const ccStr = extractEmails(headersMap.Cc).join(', ');\n    const bccStr = extractEmails(headersMap.Bcc).join(', ');\n    const messagePayload = fullData?.payload;\n    const bodyContent = messagePayload ? extractBodyFromPayload(messagePayload, { contentType, excludeThreadHistory }) : '';\n    const payload: Partial<EmailDetail> = {\n      id: fullData.id ?? undefined,\n      threadId: fullData.threadId ?? undefined,\n      date: toIsoUtc(headersMap.Date) || headersMap.Date,\n      from: fromInfo?.address || headersMap.From,\n      fromName: fromInfo?.name,\n      to: toStr,\n      cc: ccStr,\n      bcc: bccStr,\n      subject: headersMap.Subject ?? '',\n      snippet: fullData.snippet ?? undefined,\n      body: bodyContent,\n      bodyContentType: contentType,\n    };\n\n    // Filter based on requested fields\n    const filteredPayload = filterFields(payload, requestedFields);\n\n    logger.info('gmail.message.get result', { id: fullData.id, subject: payload.subject, from: payload.from, fields: fields || 'all' });\n\n    const result: Output = {\n      type: 'success' as const,\n      item: filteredPayload,\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    const message = error instanceof Error ? error.message : String(error);\n    logger.error('gmail.message.get error', { error: message });\n\n    throw new ProtocolError(ProtocolErrorCode.InternalError, `Error getting message: ${message}`, {\n      stack: error instanceof Error ? error.stack : undefined,\n    });\n  }\n}\n\nexport default function createTool() {\n  return {\n    name: 'message-get',\n    config,\n    handler,\n  } satisfies ToolModule;\n}\n"],"names":["gmail","gmailApi","EMAIL_COMMON_PATTERNS","EMAIL_FIELD_DESCRIPTIONS","EMAIL_FIELDS","EmailContentTypeSchema","EmailDetailSchema","ExcludeThreadHistorySchema","schemas","AuthRequiredBranchSchema","createFieldsSchema","filterFields","ProtocolError","ProtocolErrorCode","parseFields","z","extractBodyFromPayload","extractEmails","extractFrom","toIsoUtc","googleAuth","inputSchema","object","id","coerce","string","trim","min","describe","fields","availableFields","fieldDescriptions","commonPatterns","resourceName","contentType","excludeThreadHistory","successBranchSchema","type","literal","item","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","requestedFields","info","Boolean","fullData","headersMap","InvalidParams","version","auth","authContext","response","users","messages","get","userId","format","metadataHeaders","data","InvalidRequest","headers","payload","headersArray","Array","isArray","Object","fromEntries","map","h","header","String","name","value","fromInfo","From","toStr","To","join","ccStr","Cc","bccStr","Bcc","messagePayload","bodyContent","undefined","threadId","date","Date","from","address","fromName","to","cc","bcc","subject","Subject","snippet","body","bodyContentType","filteredPayload","content","text","JSON","stringify","structuredContent","error","message","Error","InternalError","stack","createTool"],"mappings":"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"}

package/dist/esm/mcp/tools/message-mark-read.js

@@ -1,7 +1,7 @@
+import { gmail as gmailApi } from '@googleapis/gmail';
 import { schemas } from '@mcp-z/oauth-google';
 const { AuthRequiredBranchSchema } = schemas;
 import { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';
-import { google } from 'googleapis';
 import { z } from 'zod';
 import { googleAuth } from '../../lib/google-auth.js';
 const inputSchema = z.object({
@@ -31,7 +31,7 @@ async function handler({ id }, extra) {
         throw new ProtocolError(ProtocolErrorCode.InvalidParams, 'Missing id');
     }
     try {
-        const gmail = google.gmail({
+        const gmail = gmailApi({
             version: 'v1',
             auth: googleAuth(extra.authContext.auth)
         });