@mcp-z/mcp-gmail 2.1.0 → 2.2.0

package/dist/cjs/email/messages/fetch-message.d.cts

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

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

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

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

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-gmail/src/email/messages/fetch-message.ts"],"sourcesContent":["import type { gmail_v1 } from 'googleapis';\nimport { toIsoUtc } from '../../lib/date-conversion.ts';\nimport { extractEmails, extractFrom } from '../parsing/headers-utils.ts';\n\nexport type FetchMode = 'metadata' | 'full';\n\nexport interface NormalizedAddress {\n  address?: string | undefined;\n  name?: string | undefined;\n}\nexport interface NormalizedMessage {\n  id: string;\n  threadId?: string | undefined;\n  date?: string | undefined;\n  subject?: string | undefined;\n  from?: NormalizedAddress | undefined;\n  to?: string[] | undefined;\n  cc?: string[] | undefined;\n  bcc?: string[] | undefined;\n  snippet?: string | undefined;\n  labels?: string[] | undefined;\n  body?: string | undefined;\n}\n\nexport interface GmailDeps {\n  /** googleapis Gmail client created via createGmailClient(provider). */\n  gmail: gmail_v1.Gmail;\n}\n\nfunction extractHeader(headers: Array<{ name?: string; value?: string }> | undefined, key: string): string | undefined {\n  const h = headers?.find((x) => (x.name ?? '').toLowerCase() === key.toLowerCase());\n  return h?.value ?? undefined;\n}\n\nfunction base64UrlDecode(input: string): string {\n  let s = String(input).replace(/-/g, '+').replace(/_/g, '/');\n  while (s.length % 4 !== 0) s += '=';\n  try {\n    return Buffer.from(s, 'base64').toString('utf8');\n  } catch {\n    return '';\n  }\n}\n\nfunction extractBody(payload: unknown): string | undefined {\n  const find = (parts: unknown[] | undefined, mime: string): string | undefined => {\n    for (const p of parts ?? []) {\n      if (p && typeof p === 'object' && 'mimeType' in p && 'body' in p) {\n        if (p.mimeType === mime && p.body && typeof p.body === 'object' && 'data' in p.body) {\n          return base64UrlDecode(p.body.data as string);\n        }\n      }\n      if (p && typeof p === 'object' && 'parts' in p) {\n        const nested = find(p.parts as unknown[], mime);\n        if (nested) return nested;\n      }\n    }\n    return undefined;\n  };\n  if (payload && typeof payload === 'object' && 'parts' in payload) {\n    return find(payload.parts as unknown[], 'text/plain') ?? find(payload.parts as unknown[], 'text/html')?.replace(/\\r\\n?/g, '\\n');\n  }\n  return undefined;\n}\n\nexport async function fetchMessage(deps: GmailDeps, id: string, mode: FetchMode): Promise<NormalizedMessage> {\n  const { gmail } = deps;\n  // When only metadata is requested, ask Gmail for a reduced payload with just the headers we care about.\n  const metadataHeaders = ['Date', 'Subject', 'From', 'To', 'Cc', 'Bcc'];\n  const format = mode === 'full' ? 'full' : 'metadata';\n  const baseParams = { userId: 'me' as const, id, format };\n  const resp = format === 'metadata' ? await gmail.users.messages.get({ ...baseParams, metadataHeaders }) : await gmail.users.messages.get(baseParams);\n  const data = resp?.data as unknown;\n  const headers = data && typeof data === 'object' && 'payload' in data && data.payload && typeof data.payload === 'object' && 'headers' in data.payload ? (data.payload.headers as Array<{ name?: string; value?: string }> | undefined) : undefined;\n  const dateRaw = extractHeader(headers, 'Date');\n  const fromRaw = extractHeader(headers, 'From');\n  const toRaw = extractHeader(headers, 'To');\n  const ccRaw = extractHeader(headers, 'Cc');\n  const bccRaw = extractHeader(headers, 'Bcc');\n\n  const fromObj = (fromRaw ? (extractFrom(fromRaw) as NormalizedAddress) : undefined) ?? undefined;\n  const toArr = toRaw ? extractEmails(toRaw) : [];\n  const ccArr = ccRaw ? extractEmails(ccRaw) : [];\n  const bccArr = bccRaw ? extractEmails(bccRaw) : [];\n\n  const getId = (): string => {\n    if (data && typeof data === 'object' && 'id' in data) {\n      return String(data.id ?? id);\n    }\n    return id;\n  };\n\n  const getThreadId = (): string | undefined => {\n    if (data && typeof data === 'object' && 'threadId' in data && data.threadId) {\n      return String(data.threadId);\n    }\n    return undefined;\n  };\n\n  const getSnippet = (): string | undefined => {\n    if (data && typeof data === 'object' && 'snippet' in data && data.snippet) {\n      return String(data.snippet);\n    }\n    return undefined;\n  };\n\n  const getLabelIds = (): string[] | undefined => {\n    if (data && typeof data === 'object' && 'labelIds' in data && Array.isArray(data.labelIds)) {\n      return data.labelIds.map(String);\n    }\n    return undefined;\n  };\n\n  const getPayload = (): unknown => {\n    if (data && typeof data === 'object' && 'payload' in data) {\n      return data.payload;\n    }\n    return undefined;\n  };\n\n  const msg: NormalizedMessage = {\n    id: getId(),\n    threadId: getThreadId(),\n    date: dateRaw ? (toIsoUtc(dateRaw) ?? dateRaw) : undefined,\n    subject: extractHeader(headers, 'Subject'),\n    from: fromObj,\n    to: toArr.length ? toArr : undefined,\n    cc: ccArr.length ? ccArr : undefined,\n    bcc: bccArr.length ? bccArr : undefined,\n    snippet: getSnippet(),\n    labels: getLabelIds(),\n  };\n  if (mode === 'full') {\n    const body = extractBody(getPayload());\n    if (body) msg.body = body;\n  }\n  return msg;\n}\n"],"names":["fetchMessage","extractHeader","headers","key","h","find","x","name","toLowerCase","value","undefined","base64UrlDecode","input","s","String","replace","length","Buffer","from","toString","extractBody","payload","parts","mime","p","mimeType","body","data","nested","deps","id","mode","fromRaw","toIsoUtc","gmail","metadataHeaders","format","baseParams","resp","dateRaw","toRaw","ccRaw","bccRaw","fromObj","toArr","ccArr","bccArr","getId","getThreadId","getSnippet","getLabelIds","getPayload","msg","userId","users","messages","get","extractFrom","extractEmails","threadId","snippet","Array","isArray","labelIds","map","date","subject","to","cc","bcc","labels"],"mappings":";;;;+BAiEsBA;;;eAAAA;;;gCAhEG;8BACkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA2B3C,SAASC,cAAcC,OAA6D,EAAEC,GAAW;;IAC/F,IAAMC,IAAIF,oBAAAA,8BAAAA,QAASG,IAAI,CAAC,SAACC;YAAOA;eAAD,EAACA,UAAAA,EAAEC,IAAI,cAAND,qBAAAA,UAAU,IAAIE,WAAW,OAAOL,IAAIK,WAAW;;IAC/E,eAAOJ,cAAAA,wBAAAA,EAAGK,KAAK,uCAAIC;AACrB;AAEA,SAASC,gBAAgBC,KAAa;IACpC,IAAIC,IAAIC,OAAOF,OAAOG,OAAO,CAAC,MAAM,KAAKA,OAAO,CAAC,MAAM;IACvD,MAAOF,EAAEG,MAAM,GAAG,MAAM,EAAGH,KAAK;IAChC,IAAI;QACF,OAAOI,OAAOC,IAAI,CAACL,GAAG,UAAUM,QAAQ,CAAC;IAC3C,EAAE,eAAM;QACN,OAAO;IACT;AACF;AAEA,SAASC,YAAYC,OAAgB;IACnC,IAAMhB,OAAO,eAACiB,OAA8BC;YACrC,kCAAA,2BAAA;;YAAL,QAAK,aAAWD,kBAAAA,mBAAAA,QAAS,EAAE,sBAAtB,SAAA,6BAAA,QAAA,yBAAA,iCAAwB;gBAAxB,IAAME,IAAN;gBACH,IAAIA,KAAK,CAAA,OAAOA,kCAAP,SAAOA,EAAAA,MAAM,YAAY,cAAcA,KAAK,UAAUA,GAAG;oBAChE,IAAIA,EAAEC,QAAQ,KAAKF,QAAQC,EAAEE,IAAI,IAAI,SAAOF,EAAEE,IAAI,MAAK,YAAY,UAAUF,EAAEE,IAAI,EAAE;wBACnF,OAAOf,gBAAgBa,EAAEE,IAAI,CAACC,IAAI;oBACpC;gBACF;gBACA,IAAIH,KAAK,CAAA,OAAOA,kCAAP,SAAOA,EAAAA,MAAM,YAAY,WAAWA,GAAG;oBAC9C,IAAMI,SAASvB,KAAKmB,EAAEF,KAAK,EAAeC;oBAC1C,IAAIK,QAAQ,OAAOA;gBACrB;YACF;;YAVK;YAAA;;;qBAAA,6BAAA;oBAAA;;;oBAAA;0BAAA;;;;QAWL,OAAOlB;IACT;IACA,IAAIW,WAAW,CAAA,OAAOA,wCAAP,SAAOA,QAAM,MAAM,YAAY,WAAWA,SAAS;YACzDhB;YAAkDA;QAAzD,QAAOA,QAAAA,KAAKgB,QAAQC,KAAK,EAAe,2BAAjCjB,mBAAAA,SAAkDA,SAAAA,KAAKgB,QAAQC,KAAK,EAAe,0BAAjCjB,6BAAAA,OAA+CU,OAAO,CAAC,UAAU;IAC5H;IACA,OAAOL;AACT;AAEO,SAAeV,aAAa6B,IAAe,EAAEC,EAAU,EAAEC,IAAe;;YAe5DC,MA2CEC,WAzDXC,OAEFC,iBACAC,QACAC,YACAC,YACAX,MACAzB,SACAqC,SACAP,SACAQ,OACAC,OACAC,QAEAC,SACAC,OACAC,OACAC,QAEAC,OAOAC,aAOAC,YAOAC,aAOAC,YAOAC,KAaE1B;;;;oBAnEAQ,QAAUL,KAAVK;oBACR,wGAAwG;oBAClGC;wBAAmB;wBAAQ;wBAAW;wBAAQ;wBAAM;wBAAM;;oBAC1DC,SAASL,SAAS,SAAS,SAAS;oBACpCM,aAAa;wBAAEgB,QAAQ;wBAAevB,IAAAA;wBAAIM,QAAAA;oBAAO;yBAC1CA,CAAAA,WAAW,UAAS,GAApBA;;;;oBAAwB;;wBAAMF,MAAMoB,KAAK,CAACC,QAAQ,CAACC,GAAG,CAAC,wCAAKnB;4BAAYF,iBAAAA;;;;2BAAhD;;;;;;oBAAqE;;wBAAMD,MAAMoB,KAAK,CAACC,QAAQ,CAACC,GAAG,CAACnB;;;2BAA/B;;;oBAApGC;oBACAX,OAAOW,iBAAAA,2BAAAA,KAAMX,IAAI;oBACjBzB,UAAUyB,QAAQ,CAAA,OAAOA,qCAAP,SAAOA,KAAG,MAAM,YAAY,aAAaA,QAAQA,KAAKN,OAAO,IAAI,SAAOM,KAAKN,OAAO,MAAK,YAAY,aAAaM,KAAKN,OAAO,GAAIM,KAAKN,OAAO,CAACnB,OAAO,GAA4DQ;oBACpO6B,UAAUtC,cAAcC,SAAS;oBACjC8B,UAAU/B,cAAcC,SAAS;oBACjCsC,QAAQvC,cAAcC,SAAS;oBAC/BuC,QAAQxC,cAAcC,SAAS;oBAC/BwC,SAASzC,cAAcC,SAAS;oBAEhCyC,WAAWX,OAAAA,UAAWyB,IAAAA,2BAAW,EAACzB,WAAiCtB,uBAAxDsB,kBAAAA,OAAsEtB;oBACjFkC,QAAQJ,QAAQkB,IAAAA,6BAAa,EAAClB;oBAC9BK,QAAQJ,QAAQiB,IAAAA,6BAAa,EAACjB;oBAC9BK,SAASJ,SAASgB,IAAAA,6BAAa,EAAChB;oBAEhCK,QAAQ;wBACZ,IAAIpB,QAAQ,CAAA,OAAOA,qCAAP,SAAOA,KAAG,MAAM,YAAY,QAAQA,MAAM;gCACtCA;4BAAd,OAAOb,QAAOa,WAAAA,KAAKG,EAAE,cAAPH,sBAAAA,WAAWG;wBAC3B;wBACA,OAAOA;oBACT;oBAEMkB,cAAc;wBAClB,IAAIrB,QAAQ,CAAA,OAAOA,qCAAP,SAAOA,KAAG,MAAM,YAAY,cAAcA,QAAQA,KAAKgC,QAAQ,EAAE;4BAC3E,OAAO7C,OAAOa,KAAKgC,QAAQ;wBAC7B;wBACA,OAAOjD;oBACT;oBAEMuC,aAAa;wBACjB,IAAItB,QAAQ,CAAA,OAAOA,qCAAP,SAAOA,KAAG,MAAM,YAAY,aAAaA,QAAQA,KAAKiC,OAAO,EAAE;4BACzE,OAAO9C,OAAOa,KAAKiC,OAAO;wBAC5B;wBACA,OAAOlD;oBACT;oBAEMwC,cAAc;wBAClB,IAAIvB,QAAQ,CAAA,OAAOA,qCAAP,SAAOA,KAAG,MAAM,YAAY,cAAcA,QAAQkC,MAAMC,OAAO,CAACnC,KAAKoC,QAAQ,GAAG;4BAC1F,OAAOpC,KAAKoC,QAAQ,CAACC,GAAG,CAAClD;wBAC3B;wBACA,OAAOJ;oBACT;oBAEMyC,aAAa;wBACjB,IAAIxB,QAAQ,CAAA,OAAOA,qCAAP,SAAOA,KAAG,MAAM,YAAY,aAAaA,MAAM;4BACzD,OAAOA,KAAKN,OAAO;wBACrB;wBACA,OAAOX;oBACT;oBAEM0C,MAAyB;wBAC7BtB,IAAIiB;wBACJY,UAAUX;wBACViB,MAAM1B,WAAWN,YAAAA,IAAAA,0BAAQ,EAACM,sBAATN,uBAAAA,YAAqBM,UAAW7B;wBACjDwD,SAASjE,cAAcC,SAAS;wBAChCgB,MAAMyB;wBACNwB,IAAIvB,MAAM5B,MAAM,GAAG4B,QAAQlC;wBAC3B0D,IAAIvB,MAAM7B,MAAM,GAAG6B,QAAQnC;wBAC3B2D,KAAKvB,OAAO9B,MAAM,GAAG8B,SAASpC;wBAC9BkD,SAASX;wBACTqB,QAAQpB;oBACV;oBACA,IAAInB,SAAS,QAAQ;wBACbL,OAAON,YAAY+B;wBACzB,IAAIzB,MAAM0B,IAAI1B,IAAI,GAAGA;oBACvB;oBACA;;wBAAO0B;;;;IACT"}
+{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-gmail/src/email/messages/fetch-message.ts"],"sourcesContent":["import type { gmail_v1 } from '@googleapis/gmail';\nimport { toIsoUtc } from '../../lib/date-conversion.ts';\nimport { extractEmails, extractFrom } from '../parsing/headers-utils.ts';\n\nexport type FetchMode = 'metadata' | 'full';\n\nexport interface NormalizedAddress {\n  address?: string | undefined;\n  name?: string | undefined;\n}\nexport interface NormalizedMessage {\n  id: string;\n  threadId?: string | undefined;\n  date?: string | undefined;\n  subject?: string | undefined;\n  from?: NormalizedAddress | undefined;\n  to?: string[] | undefined;\n  cc?: string[] | undefined;\n  bcc?: string[] | undefined;\n  snippet?: string | undefined;\n  labels?: string[] | undefined;\n  body?: string | undefined;\n}\n\nexport interface GmailDeps {\n  /** googleapis Gmail client created via createGmailClient(provider). */\n  gmail: gmail_v1.Gmail;\n}\n\nfunction extractHeader(headers: Array<{ name?: string; value?: string }> | undefined, key: string): string | undefined {\n  const h = headers?.find((x) => (x.name ?? '').toLowerCase() === key.toLowerCase());\n  return h?.value ?? undefined;\n}\n\nfunction base64UrlDecode(input: string): string {\n  let s = String(input).replace(/-/g, '+').replace(/_/g, '/');\n  while (s.length % 4 !== 0) s += '=';\n  try {\n    return Buffer.from(s, 'base64').toString('utf8');\n  } catch {\n    return '';\n  }\n}\n\nfunction extractBody(payload: unknown): string | undefined {\n  const find = (parts: unknown[] | undefined, mime: string): string | undefined => {\n    for (const p of parts ?? []) {\n      if (p && typeof p === 'object' && 'mimeType' in p && 'body' in p) {\n        if (p.mimeType === mime && p.body && typeof p.body === 'object' && 'data' in p.body) {\n          return base64UrlDecode(p.body.data as string);\n        }\n      }\n      if (p && typeof p === 'object' && 'parts' in p) {\n        const nested = find(p.parts as unknown[], mime);\n        if (nested) return nested;\n      }\n    }\n    return undefined;\n  };\n  if (payload && typeof payload === 'object' && 'parts' in payload) {\n    return find(payload.parts as unknown[], 'text/plain') ?? find(payload.parts as unknown[], 'text/html')?.replace(/\\r\\n?/g, '\\n');\n  }\n  return undefined;\n}\n\nexport async function fetchMessage(deps: GmailDeps, id: string, mode: FetchMode): Promise<NormalizedMessage> {\n  const { gmail } = deps;\n  // When only metadata is requested, ask Gmail for a reduced payload with just the headers we care about.\n  const metadataHeaders = ['Date', 'Subject', 'From', 'To', 'Cc', 'Bcc'];\n  const format = mode === 'full' ? 'full' : 'metadata';\n  const baseParams = { userId: 'me' as const, id, format };\n  const resp = format === 'metadata' ? await gmail.users.messages.get({ ...baseParams, metadataHeaders }) : await gmail.users.messages.get(baseParams);\n  const data = resp?.data as unknown;\n  const headers = data && typeof data === 'object' && 'payload' in data && data.payload && typeof data.payload === 'object' && 'headers' in data.payload ? (data.payload.headers as Array<{ name?: string; value?: string }> | undefined) : undefined;\n  const dateRaw = extractHeader(headers, 'Date');\n  const fromRaw = extractHeader(headers, 'From');\n  const toRaw = extractHeader(headers, 'To');\n  const ccRaw = extractHeader(headers, 'Cc');\n  const bccRaw = extractHeader(headers, 'Bcc');\n\n  const fromObj = (fromRaw ? (extractFrom(fromRaw) as NormalizedAddress) : undefined) ?? undefined;\n  const toArr = toRaw ? extractEmails(toRaw) : [];\n  const ccArr = ccRaw ? extractEmails(ccRaw) : [];\n  const bccArr = bccRaw ? extractEmails(bccRaw) : [];\n\n  const getId = (): string => {\n    if (data && typeof data === 'object' && 'id' in data) {\n      return String(data.id ?? id);\n    }\n    return id;\n  };\n\n  const getThreadId = (): string | undefined => {\n    if (data && typeof data === 'object' && 'threadId' in data && data.threadId) {\n      return String(data.threadId);\n    }\n    return undefined;\n  };\n\n  const getSnippet = (): string | undefined => {\n    if (data && typeof data === 'object' && 'snippet' in data && data.snippet) {\n      return String(data.snippet);\n    }\n    return undefined;\n  };\n\n  const getLabelIds = (): string[] | undefined => {\n    if (data && typeof data === 'object' && 'labelIds' in data && Array.isArray(data.labelIds)) {\n      return data.labelIds.map(String);\n    }\n    return undefined;\n  };\n\n  const getPayload = (): unknown => {\n    if (data && typeof data === 'object' && 'payload' in data) {\n      return data.payload;\n    }\n    return undefined;\n  };\n\n  const msg: NormalizedMessage = {\n    id: getId(),\n    threadId: getThreadId(),\n    date: dateRaw ? (toIsoUtc(dateRaw) ?? dateRaw) : undefined,\n    subject: extractHeader(headers, 'Subject'),\n    from: fromObj,\n    to: toArr.length ? toArr : undefined,\n    cc: ccArr.length ? ccArr : undefined,\n    bcc: bccArr.length ? bccArr : undefined,\n    snippet: getSnippet(),\n    labels: getLabelIds(),\n  };\n  if (mode === 'full') {\n    const body = extractBody(getPayload());\n    if (body) msg.body = body;\n  }\n  return msg;\n}\n"],"names":["fetchMessage","extractHeader","headers","key","h","find","x","name","toLowerCase","value","undefined","base64UrlDecode","input","s","String","replace","length","Buffer","from","toString","extractBody","payload","parts","mime","p","mimeType","body","data","nested","deps","id","mode","fromRaw","toIsoUtc","gmail","metadataHeaders","format","baseParams","resp","dateRaw","toRaw","ccRaw","bccRaw","fromObj","toArr","ccArr","bccArr","getId","getThreadId","getSnippet","getLabelIds","getPayload","msg","userId","users","messages","get","extractFrom","extractEmails","threadId","snippet","Array","isArray","labelIds","map","date","subject","to","cc","bcc","labels"],"mappings":";;;;+BAiEsBA;;;eAAAA;;;gCAhEG;8BACkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA2B3C,SAASC,cAAcC,OAA6D,EAAEC,GAAW;;IAC/F,IAAMC,IAAIF,oBAAAA,8BAAAA,QAASG,IAAI,CAAC,SAACC;YAAOA;eAAD,EAACA,UAAAA,EAAEC,IAAI,cAAND,qBAAAA,UAAU,IAAIE,WAAW,OAAOL,IAAIK,WAAW;;IAC/E,eAAOJ,cAAAA,wBAAAA,EAAGK,KAAK,uCAAIC;AACrB;AAEA,SAASC,gBAAgBC,KAAa;IACpC,IAAIC,IAAIC,OAAOF,OAAOG,OAAO,CAAC,MAAM,KAAKA,OAAO,CAAC,MAAM;IACvD,MAAOF,EAAEG,MAAM,GAAG,MAAM,EAAGH,KAAK;IAChC,IAAI;QACF,OAAOI,OAAOC,IAAI,CAACL,GAAG,UAAUM,QAAQ,CAAC;IAC3C,EAAE,eAAM;QACN,OAAO;IACT;AACF;AAEA,SAASC,YAAYC,OAAgB;IACnC,IAAMhB,OAAO,eAACiB,OAA8BC;YACrC,kCAAA,2BAAA;;YAAL,QAAK,aAAWD,kBAAAA,mBAAAA,QAAS,EAAE,sBAAtB,SAAA,6BAAA,QAAA,yBAAA,iCAAwB;gBAAxB,IAAME,IAAN;gBACH,IAAIA,KAAK,CAAA,OAAOA,kCAAP,SAAOA,EAAAA,MAAM,YAAY,cAAcA,KAAK,UAAUA,GAAG;oBAChE,IAAIA,EAAEC,QAAQ,KAAKF,QAAQC,EAAEE,IAAI,IAAI,SAAOF,EAAEE,IAAI,MAAK,YAAY,UAAUF,EAAEE,IAAI,EAAE;wBACnF,OAAOf,gBAAgBa,EAAEE,IAAI,CAACC,IAAI;oBACpC;gBACF;gBACA,IAAIH,KAAK,CAAA,OAAOA,kCAAP,SAAOA,EAAAA,MAAM,YAAY,WAAWA,GAAG;oBAC9C,IAAMI,SAASvB,KAAKmB,EAAEF,KAAK,EAAeC;oBAC1C,IAAIK,QAAQ,OAAOA;gBACrB;YACF;;YAVK;YAAA;;;qBAAA,6BAAA;oBAAA;;;oBAAA;0BAAA;;;;QAWL,OAAOlB;IACT;IACA,IAAIW,WAAW,CAAA,OAAOA,wCAAP,SAAOA,QAAM,MAAM,YAAY,WAAWA,SAAS;YACzDhB;YAAkDA;QAAzD,QAAOA,QAAAA,KAAKgB,QAAQC,KAAK,EAAe,2BAAjCjB,mBAAAA,SAAkDA,SAAAA,KAAKgB,QAAQC,KAAK,EAAe,0BAAjCjB,6BAAAA,OAA+CU,OAAO,CAAC,UAAU;IAC5H;IACA,OAAOL;AACT;AAEO,SAAeV,aAAa6B,IAAe,EAAEC,EAAU,EAAEC,IAAe;;YAe5DC,MA2CEC,WAzDXC,OAEFC,iBACAC,QACAC,YACAC,YACAX,MACAzB,SACAqC,SACAP,SACAQ,OACAC,OACAC,QAEAC,SACAC,OACAC,OACAC,QAEAC,OAOAC,aAOAC,YAOAC,aAOAC,YAOAC,KAaE1B;;;;oBAnEAQ,QAAUL,KAAVK;oBACR,wGAAwG;oBAClGC;wBAAmB;wBAAQ;wBAAW;wBAAQ;wBAAM;wBAAM;;oBAC1DC,SAASL,SAAS,SAAS,SAAS;oBACpCM,aAAa;wBAAEgB,QAAQ;wBAAevB,IAAAA;wBAAIM,QAAAA;oBAAO;yBAC1CA,CAAAA,WAAW,UAAS,GAApBA;;;;oBAAwB;;wBAAMF,MAAMoB,KAAK,CAACC,QAAQ,CAACC,GAAG,CAAC,wCAAKnB;4BAAYF,iBAAAA;;;;2BAAhD;;;;;;oBAAqE;;wBAAMD,MAAMoB,KAAK,CAACC,QAAQ,CAACC,GAAG,CAACnB;;;2BAA/B;;;oBAApGC;oBACAX,OAAOW,iBAAAA,2BAAAA,KAAMX,IAAI;oBACjBzB,UAAUyB,QAAQ,CAAA,OAAOA,qCAAP,SAAOA,KAAG,MAAM,YAAY,aAAaA,QAAQA,KAAKN,OAAO,IAAI,SAAOM,KAAKN,OAAO,MAAK,YAAY,aAAaM,KAAKN,OAAO,GAAIM,KAAKN,OAAO,CAACnB,OAAO,GAA4DQ;oBACpO6B,UAAUtC,cAAcC,SAAS;oBACjC8B,UAAU/B,cAAcC,SAAS;oBACjCsC,QAAQvC,cAAcC,SAAS;oBAC/BuC,QAAQxC,cAAcC,SAAS;oBAC/BwC,SAASzC,cAAcC,SAAS;oBAEhCyC,WAAWX,OAAAA,UAAWyB,IAAAA,2BAAW,EAACzB,WAAiCtB,uBAAxDsB,kBAAAA,OAAsEtB;oBACjFkC,QAAQJ,QAAQkB,IAAAA,6BAAa,EAAClB;oBAC9BK,QAAQJ,QAAQiB,IAAAA,6BAAa,EAACjB;oBAC9BK,SAASJ,SAASgB,IAAAA,6BAAa,EAAChB;oBAEhCK,QAAQ;wBACZ,IAAIpB,QAAQ,CAAA,OAAOA,qCAAP,SAAOA,KAAG,MAAM,YAAY,QAAQA,MAAM;gCACtCA;4BAAd,OAAOb,QAAOa,WAAAA,KAAKG,EAAE,cAAPH,sBAAAA,WAAWG;wBAC3B;wBACA,OAAOA;oBACT;oBAEMkB,cAAc;wBAClB,IAAIrB,QAAQ,CAAA,OAAOA,qCAAP,SAAOA,KAAG,MAAM,YAAY,cAAcA,QAAQA,KAAKgC,QAAQ,EAAE;4BAC3E,OAAO7C,OAAOa,KAAKgC,QAAQ;wBAC7B;wBACA,OAAOjD;oBACT;oBAEMuC,aAAa;wBACjB,IAAItB,QAAQ,CAAA,OAAOA,qCAAP,SAAOA,KAAG,MAAM,YAAY,aAAaA,QAAQA,KAAKiC,OAAO,EAAE;4BACzE,OAAO9C,OAAOa,KAAKiC,OAAO;wBAC5B;wBACA,OAAOlD;oBACT;oBAEMwC,cAAc;wBAClB,IAAIvB,QAAQ,CAAA,OAAOA,qCAAP,SAAOA,KAAG,MAAM,YAAY,cAAcA,QAAQkC,MAAMC,OAAO,CAACnC,KAAKoC,QAAQ,GAAG;4BAC1F,OAAOpC,KAAKoC,QAAQ,CAACC,GAAG,CAAClD;wBAC3B;wBACA,OAAOJ;oBACT;oBAEMyC,aAAa;wBACjB,IAAIxB,QAAQ,CAAA,OAAOA,qCAAP,SAAOA,KAAG,MAAM,YAAY,aAAaA,MAAM;4BACzD,OAAOA,KAAKN,OAAO;wBACrB;wBACA,OAAOX;oBACT;oBAEM0C,MAAyB;wBAC7BtB,IAAIiB;wBACJY,UAAUX;wBACViB,MAAM1B,WAAWN,YAAAA,IAAAA,0BAAQ,EAACM,sBAATN,uBAAAA,YAAqBM,UAAW7B;wBACjDwD,SAASjE,cAAcC,SAAS;wBAChCgB,MAAMyB;wBACNwB,IAAIvB,MAAM5B,MAAM,GAAG4B,QAAQlC;wBAC3B0D,IAAIvB,MAAM7B,MAAM,GAAG6B,QAAQnC;wBAC3B2D,KAAKvB,OAAO9B,MAAM,GAAG8B,SAASpC;wBAC9BkD,SAASX;wBACTqB,QAAQpB;oBACV;oBACA,IAAInB,SAAS,QAAQ;wBACbL,OAAON,YAAY+B;wBACzB,IAAIzB,MAAM0B,IAAI1B,IAAI,GAAGA;oBACvB;oBACA;;wBAAO0B;;;;IACT"}

package/dist/cjs/email/messages/messages.d.cts

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

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

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

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

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

package/dist/cjs/email/parsing/html-processing.d.cts

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

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

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

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

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-gmail/src/email/parsing/html-processing.ts"],"sourcesContent":["import { extractCurrentMessageFromHtml } from '@mcp-z/email';\nimport type { gmail_v1 } from 'googleapis';\nimport { parse } from 'node-html-parser';\n\nexport interface BodyExtractionOptions {\n  /** Format to return: 'text' extracts plain text, 'html' preserves HTML structure */\n  contentType?: 'text' | 'html';\n  /** When true, removes quoted thread history from HTML content */\n  excludeThreadHistory?: boolean;\n}\n\nexport function extractBodyFromPayload(payload: gmail_v1.Schema$MessagePart, options: BodyExtractionOptions = {}): string {\n  const { contentType = 'text', excludeThreadHistory = false } = options;\n  if (!payload) return '';\n\n  // If there's a direct body with data\n  if (payload.body?.data) {\n    return Buffer.from(payload.body.data, 'base64').toString('utf-8');\n  }\n\n  // If there are parts, look for text/plain or text/html\n  if (payload.parts && Array.isArray(payload.parts)) {\n    for (const part of payload.parts) {\n      if (part.mimeType === 'text/plain' && part.body?.data) {\n        return Buffer.from(part.body.data, 'base64').toString('utf-8');\n      }\n      if (part.mimeType === 'text/html' && part.body?.data) {\n        let html = Buffer.from(part.body.data, 'base64').toString('utf-8');\n\n        // Remove thread history if requested\n        if (excludeThreadHistory) {\n          html = extractCurrentMessageFromHtml(html);\n        }\n\n        // Return HTML directly if requested\n        if (contentType === 'html') {\n          return html;\n        }\n\n        // Otherwise extract plain text from HTML\n        const doc = parse(html);\n        const docUnknown = doc as unknown;\n        if (docUnknown && typeof docUnknown === 'object' && 'text' in docUnknown) {\n          return docUnknown.text as string;\n        }\n        return '';\n      }\n    }\n  }\n\n  return '';\n}\n"],"names":["extractBodyFromPayload","payload","options","contentType","excludeThreadHistory","body","data","Buffer","from","toString","parts","Array","isArray","part","mimeType","html","extractCurrentMessageFromHtml","doc","parse","docUnknown","text"],"mappings":";;;;+BAWgBA;;;eAAAA;;;qBAX8B;8BAExB;;;;;AASf,SAASA,uBAAuBC,OAAoC;QAAEC,UAAAA,iEAAiC,CAAC;QAKzGD;IAJJ,2BAA+DC,QAAvDC,aAAAA,gDAAc,+DAAyCD,QAAjCE,sBAAAA,kEAAuB;IACrD,IAAI,CAACH,SAAS,OAAO;IAErB,qCAAqC;IACrC,KAAIA,gBAAAA,QAAQI,IAAI,cAAZJ,oCAAAA,cAAcK,IAAI,EAAE;QACtB,OAAOC,OAAOC,IAAI,CAACP,QAAQI,IAAI,CAACC,IAAI,EAAE,UAAUG,QAAQ,CAAC;IAC3D;IAEA,uDAAuD;IACvD,IAAIR,QAAQS,KAAK,IAAIC,MAAMC,OAAO,CAACX,QAAQS,KAAK,GAAG;YAC5C,kCAAA,2BAAA;;YAAL,QAAK,YAAcT,QAAQS,KAAK,qBAA3B,SAAA,6BAAA,QAAA,yBAAA,iCAA6B;gBAA7B,IAAMG,OAAN;oBACmCA,YAGDA;gBAHrC,IAAIA,KAAKC,QAAQ,KAAK,kBAAgBD,aAAAA,KAAKR,IAAI,cAATQ,iCAAAA,WAAWP,IAAI,GAAE;oBACrD,OAAOC,OAAOC,IAAI,CAACK,KAAKR,IAAI,CAACC,IAAI,EAAE,UAAUG,QAAQ,CAAC;gBACxD;gBACA,IAAII,KAAKC,QAAQ,KAAK,iBAAeD,cAAAA,KAAKR,IAAI,cAATQ,kCAAAA,YAAWP,IAAI,GAAE;oBACpD,IAAIS,OAAOR,OAAOC,IAAI,CAACK,KAAKR,IAAI,CAACC,IAAI,EAAE,UAAUG,QAAQ,CAAC;oBAE1D,qCAAqC;oBACrC,IAAIL,sBAAsB;wBACxBW,OAAOC,IAAAA,oCAA6B,EAACD;oBACvC;oBAEA,oCAAoC;oBACpC,IAAIZ,gBAAgB,QAAQ;wBAC1B,OAAOY;oBACT;oBAEA,yCAAyC;oBACzC,IAAME,MAAMC,IAAAA,qBAAK,EAACH;oBAClB,IAAMI,aAAaF;oBACnB,IAAIE,cAAc,CAAA,OAAOA,2CAAP,SAAOA,WAAS,MAAM,YAAY,UAAUA,YAAY;wBACxE,OAAOA,WAAWC,IAAI;oBACxB;oBACA,OAAO;gBACT;YACF;;YAzBK;YAAA;;;qBAAA,6BAAA;oBAAA;;;oBAAA;0BAAA;;;;IA0BP;IAEA,OAAO;AACT"}
+{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-gmail/src/email/parsing/html-processing.ts"],"sourcesContent":["import type { gmail_v1 } from '@googleapis/gmail';\nimport { extractCurrentMessageFromHtml } from '@mcp-z/email';\nimport { parse } from 'node-html-parser';\n\nexport interface BodyExtractionOptions {\n  /** Format to return: 'text' extracts plain text, 'html' preserves HTML structure */\n  contentType?: 'text' | 'html';\n  /** When true, removes quoted thread history from HTML content */\n  excludeThreadHistory?: boolean;\n}\n\nexport function extractBodyFromPayload(payload: gmail_v1.Schema$MessagePart, options: BodyExtractionOptions = {}): string {\n  const { contentType = 'text', excludeThreadHistory = false } = options;\n  if (!payload) return '';\n\n  // If there's a direct body with data\n  if (payload.body?.data) {\n    return Buffer.from(payload.body.data, 'base64').toString('utf-8');\n  }\n\n  // If there are parts, look for text/plain or text/html\n  if (payload.parts && Array.isArray(payload.parts)) {\n    for (const part of payload.parts) {\n      if (part.mimeType === 'text/plain' && part.body?.data) {\n        return Buffer.from(part.body.data, 'base64').toString('utf-8');\n      }\n      if (part.mimeType === 'text/html' && part.body?.data) {\n        let html = Buffer.from(part.body.data, 'base64').toString('utf-8');\n\n        // Remove thread history if requested\n        if (excludeThreadHistory) {\n          html = extractCurrentMessageFromHtml(html);\n        }\n\n        // Return HTML directly if requested\n        if (contentType === 'html') {\n          return html;\n        }\n\n        // Otherwise extract plain text from HTML\n        const doc = parse(html);\n        const docUnknown = doc as unknown;\n        if (docUnknown && typeof docUnknown === 'object' && 'text' in docUnknown) {\n          return docUnknown.text as string;\n        }\n        return '';\n      }\n    }\n  }\n\n  return '';\n}\n"],"names":["extractBodyFromPayload","payload","options","contentType","excludeThreadHistory","body","data","Buffer","from","toString","parts","Array","isArray","part","mimeType","html","extractCurrentMessageFromHtml","doc","parse","docUnknown","text"],"mappings":";;;;+BAWgBA;;;eAAAA;;;qBAV8B;8BACxB;;;;;AASf,SAASA,uBAAuBC,OAAoC;QAAEC,UAAAA,iEAAiC,CAAC;QAKzGD;IAJJ,2BAA+DC,QAAvDC,aAAAA,gDAAc,+DAAyCD,QAAjCE,sBAAAA,kEAAuB;IACrD,IAAI,CAACH,SAAS,OAAO;IAErB,qCAAqC;IACrC,KAAIA,gBAAAA,QAAQI,IAAI,cAAZJ,oCAAAA,cAAcK,IAAI,EAAE;QACtB,OAAOC,OAAOC,IAAI,CAACP,QAAQI,IAAI,CAACC,IAAI,EAAE,UAAUG,QAAQ,CAAC;IAC3D;IAEA,uDAAuD;IACvD,IAAIR,QAAQS,KAAK,IAAIC,MAAMC,OAAO,CAACX,QAAQS,KAAK,GAAG;YAC5C,kCAAA,2BAAA;;YAAL,QAAK,YAAcT,QAAQS,KAAK,qBAA3B,SAAA,6BAAA,QAAA,yBAAA,iCAA6B;gBAA7B,IAAMG,OAAN;oBACmCA,YAGDA;gBAHrC,IAAIA,KAAKC,QAAQ,KAAK,kBAAgBD,aAAAA,KAAKR,IAAI,cAATQ,iCAAAA,WAAWP,IAAI,GAAE;oBACrD,OAAOC,OAAOC,IAAI,CAACK,KAAKR,IAAI,CAACC,IAAI,EAAE,UAAUG,QAAQ,CAAC;gBACxD;gBACA,IAAII,KAAKC,QAAQ,KAAK,iBAAeD,cAAAA,KAAKR,IAAI,cAATQ,kCAAAA,YAAWP,IAAI,GAAE;oBACpD,IAAIS,OAAOR,OAAOC,IAAI,CAACK,KAAKR,IAAI,CAACC,IAAI,EAAE,UAAUG,QAAQ,CAAC;oBAE1D,qCAAqC;oBACrC,IAAIL,sBAAsB;wBACxBW,OAAOC,IAAAA,oCAA6B,EAACD;oBACvC;oBAEA,oCAAoC;oBACpC,IAAIZ,gBAAgB,QAAQ;wBAC1B,OAAOY;oBACT;oBAEA,yCAAyC;oBACzC,IAAME,MAAMC,IAAAA,qBAAK,EAACH;oBAClB,IAAMI,aAAaF;oBACnB,IAAIE,cAAc,CAAA,OAAOA,2CAAP,SAAOA,WAAS,MAAM,YAAY,UAAUA,YAAY;wBACxE,OAAOA,WAAWC,IAAI;oBACxB;oBACA,OAAO;gBACT;YACF;;YAzBK;YAAA;;;qBAAA,6BAAA;oBAAA;;;oBAAA;0BAAA;;;;IA0BP;IAEA,OAAO;AACT"}

package/dist/cjs/email/querying/execute-query.d.cts

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

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

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

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

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-gmail/src/email/querying/execute-query.ts"],"sourcesContent":["import type { ExecutionResult } from '@mcp-z/email';\nimport type { gmail_v1 } from 'googleapis';\nimport { MAX_PAGE_SIZE } from '../../constants.ts';\nimport type { GmailQuery as QueryNode } from '../../schemas/gmail-query-schema.ts';\nimport type { Logger } from '../../types.ts';\nimport { searchMessages } from './search-execution.ts';\n\nexport interface ExecuteQueryOptions {\n  client: gmail_v1.Gmail;\n  logger: Logger;\n  pageSize?: number;\n  pageToken?: string;\n  includeBody?: boolean;\n}\n\n/**\n * Execute a Gmail query with direct, single-attempt execution.\n * No planning, no fallbacks, no retries.\n * Provider errors are returned directly to the caller for actionable feedback.\n */\nexport async function executeQuery<T>(query: QueryNode | undefined, options: ExecuteQueryOptions, transform: (item: unknown) => T): Promise<ExecutionResult<T>> {\n  const { client, logger, pageSize, pageToken, includeBody } = options;\n\n  // Validate pagination parameters\n  if (pageSize !== undefined && (pageSize < 1 || pageSize > MAX_PAGE_SIZE)) {\n    throw new Error(`pageSize must be between 1 and ${MAX_PAGE_SIZE}`);\n  }\n\n  if (pageToken !== undefined && typeof pageToken === 'string' && pageToken.trim().length === 0) {\n    logger.info('Empty pageToken provided, ignoring');\n  }\n\n  // Single execution - direct query to Gmail API\n  logger.info('executeQuery: executing direct Gmail query');\n\n  try {\n    const result = await searchMessages(client, {\n      ...(query !== undefined && { query }),\n      pageSize: pageSize ?? 50,\n      pageToken: pageToken && pageToken.trim().length > 0 ? pageToken : undefined,\n      includeBody: includeBody ?? false,\n      logger,\n    });\n\n    // Transform results\n    const transformedResults = result.messages.map(transform);\n\n    logger.info(`executeQuery: succeeded with ${transformedResults.length} results`);\n\n    return {\n      success: true,\n      items: transformedResults,\n      metadata: {\n        nextPageToken: result.nextPageToken,\n      },\n    };\n  } catch (error) {\n    // Re-throw errors directly - no fallback logic\n    logger.error('executeQuery: failed', { error: error instanceof Error ? error.message : String(error) });\n    throw error;\n  }\n}\n"],"names":["executeQuery","query","options","transform","client","logger","pageSize","pageToken","includeBody","result","transformedResults","error","undefined","MAX_PAGE_SIZE","Error","trim","length","info","searchMessages","messages","map","success","items","metadata","nextPageToken","message","String"],"mappings":";;;;+BAoBsBA;;;eAAAA;;;2BAlBQ;iCAGC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAexB,SAAeA,aAAgBC,KAA4B,EAAEC,OAA4B,EAAEC,SAA+B;;YACvHC,QAAQC,QAAQC,UAAUC,WAAWC,aAerCC,QASAC,oBAWCC;;;;oBAnCDP,SAAqDF,QAArDE,QAAQC,SAA6CH,QAA7CG,QAAQC,WAAqCJ,QAArCI,UAAUC,YAA2BL,QAA3BK,WAAWC,cAAgBN,QAAhBM;oBAE7C,iCAAiC;oBACjC,IAAIF,aAAaM,aAAcN,CAAAA,WAAW,KAAKA,WAAWO,0BAAa,AAAD,GAAI;wBACxE,MAAM,IAAIC,MAAM,AAAC,kCAA+C,OAAdD,0BAAa;oBACjE;oBAEA,IAAIN,cAAcK,aAAa,OAAOL,cAAc,YAAYA,UAAUQ,IAAI,GAAGC,MAAM,KAAK,GAAG;wBAC7FX,OAAOY,IAAI,CAAC;oBACd;oBAEA,+CAA+C;oBAC/CZ,OAAOY,IAAI,CAAC;;;;;;;;;oBAGK;;wBAAMC,IAAAA,iCAAc,EAACd,QAAQ,wCACtCH,UAAUW,aAAa;4BAAEX,OAAAA;wBAAM;4BACnCK,QAAQ,EAAEA,qBAAAA,sBAAAA,WAAY;4BACtBC,WAAWA,aAAaA,UAAUQ,IAAI,GAAGC,MAAM,GAAG,IAAIT,YAAYK;4BAClEJ,WAAW,EAAEA,wBAAAA,yBAAAA,cAAe;4BAC5BH,QAAAA;;;;oBALII,SAAS;oBAQf,oBAAoB;oBACdC,qBAAqBD,OAAOU,QAAQ,CAACC,GAAG,CAACjB;oBAE/CE,OAAOY,IAAI,CAAC,AAAC,gCAAyD,OAA1BP,mBAAmBM,MAAM,EAAC;oBAEtE;;wBAAO;4BACLK,SAAS;4BACTC,OAAOZ;4BACPa,UAAU;gCACRC,eAAef,OAAOe,aAAa;4BACrC;wBACF;;;oBACOb;oBACP,+CAA+C;oBAC/CN,OAAOM,KAAK,CAAC,wBAAwB;wBAAEA,OAAOA,AAAK,YAALA,OAAiBG,SAAQH,MAAMc,OAAO,GAAGC,OAAOf;oBAAO;oBACrG,MAAMA;;;;;;;IAEV"}
+{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-gmail/src/email/querying/execute-query.ts"],"sourcesContent":["import type { gmail_v1 } from '@googleapis/gmail';\nimport type { ExecutionResult } from '@mcp-z/email';\nimport { MAX_PAGE_SIZE } from '../../constants.ts';\nimport type { GmailQuery as QueryNode } from '../../schemas/gmail-query-schema.ts';\nimport type { Logger } from '../../types.ts';\nimport { searchMessages } from './search-execution.ts';\n\nexport interface ExecuteQueryOptions {\n  client: gmail_v1.Gmail;\n  logger: Logger;\n  pageSize?: number;\n  pageToken?: string;\n  includeBody?: boolean;\n}\n\n/**\n * Execute a Gmail query with direct, single-attempt execution.\n * No planning, no fallbacks, no retries.\n * Provider errors are returned directly to the caller for actionable feedback.\n */\nexport async function executeQuery<T>(query: QueryNode | undefined, options: ExecuteQueryOptions, transform: (item: unknown) => T): Promise<ExecutionResult<T>> {\n  const { client, logger, pageSize, pageToken, includeBody } = options;\n\n  // Validate pagination parameters\n  if (pageSize !== undefined && (pageSize < 1 || pageSize > MAX_PAGE_SIZE)) {\n    throw new Error(`pageSize must be between 1 and ${MAX_PAGE_SIZE}`);\n  }\n\n  if (pageToken !== undefined && typeof pageToken === 'string' && pageToken.trim().length === 0) {\n    logger.info('Empty pageToken provided, ignoring');\n  }\n\n  // Single execution - direct query to Gmail API\n  logger.info('executeQuery: executing direct Gmail query');\n\n  try {\n    const result = await searchMessages(client, {\n      ...(query !== undefined && { query }),\n      pageSize: pageSize ?? 50,\n      pageToken: pageToken && pageToken.trim().length > 0 ? pageToken : undefined,\n      includeBody: includeBody ?? false,\n      logger,\n    });\n\n    // Transform results\n    const transformedResults = result.messages.map(transform);\n\n    logger.info(`executeQuery: succeeded with ${transformedResults.length} results`);\n\n    return {\n      success: true,\n      items: transformedResults,\n      metadata: {\n        nextPageToken: result.nextPageToken,\n      },\n    };\n  } catch (error) {\n    // Re-throw errors directly - no fallback logic\n    logger.error('executeQuery: failed', { error: error instanceof Error ? error.message : String(error) });\n    throw error;\n  }\n}\n"],"names":["executeQuery","query","options","transform","client","logger","pageSize","pageToken","includeBody","result","transformedResults","error","undefined","MAX_PAGE_SIZE","Error","trim","length","info","searchMessages","messages","map","success","items","metadata","nextPageToken","message","String"],"mappings":";;;;+BAoBsBA;;;eAAAA;;;2BAlBQ;iCAGC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAexB,SAAeA,aAAgBC,KAA4B,EAAEC,OAA4B,EAAEC,SAA+B;;YACvHC,QAAQC,QAAQC,UAAUC,WAAWC,aAerCC,QASAC,oBAWCC;;;;oBAnCDP,SAAqDF,QAArDE,QAAQC,SAA6CH,QAA7CG,QAAQC,WAAqCJ,QAArCI,UAAUC,YAA2BL,QAA3BK,WAAWC,cAAgBN,QAAhBM;oBAE7C,iCAAiC;oBACjC,IAAIF,aAAaM,aAAcN,CAAAA,WAAW,KAAKA,WAAWO,0BAAa,AAAD,GAAI;wBACxE,MAAM,IAAIC,MAAM,AAAC,kCAA+C,OAAdD,0BAAa;oBACjE;oBAEA,IAAIN,cAAcK,aAAa,OAAOL,cAAc,YAAYA,UAAUQ,IAAI,GAAGC,MAAM,KAAK,GAAG;wBAC7FX,OAAOY,IAAI,CAAC;oBACd;oBAEA,+CAA+C;oBAC/CZ,OAAOY,IAAI,CAAC;;;;;;;;;oBAGK;;wBAAMC,IAAAA,iCAAc,EAACd,QAAQ,wCACtCH,UAAUW,aAAa;4BAAEX,OAAAA;wBAAM;4BACnCK,QAAQ,EAAEA,qBAAAA,sBAAAA,WAAY;4BACtBC,WAAWA,aAAaA,UAAUQ,IAAI,GAAGC,MAAM,GAAG,IAAIT,YAAYK;4BAClEJ,WAAW,EAAEA,wBAAAA,yBAAAA,cAAe;4BAC5BH,QAAAA;;;;oBALII,SAAS;oBAQf,oBAAoB;oBACdC,qBAAqBD,OAAOU,QAAQ,CAACC,GAAG,CAACjB;oBAE/CE,OAAOY,IAAI,CAAC,AAAC,gCAAyD,OAA1BP,mBAAmBM,MAAM,EAAC;oBAEtE;;wBAAO;4BACLK,SAAS;4BACTC,OAAOZ;4BACPa,UAAU;gCACRC,eAAef,OAAOe,aAAa;4BACrC;wBACF;;;oBACOb;oBACP,+CAA+C;oBAC/CN,OAAOM,KAAK,CAAC,wBAAwB;wBAAEA,OAAOA,AAAK,YAALA,OAAiBG,SAAQH,MAAMc,OAAO,GAAGC,OAAOf;oBAAO;oBACrG,MAAMA;;;;;;;IAEV"}

package/dist/cjs/email/querying/pagination.d.cts

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

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

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

package/dist/cjs/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":["fetchMessagesConcurrently","fetchMessagesPage","gmail","params","gmailQ","pageSize","pageToken","body","logger","metadataHeaders","maxPageSize","minPageSize","safePageSize","listParams","listResponse","response","messages","items","concurrentArgs","detailedMessages","error","errorMessage","Number","isInteger","Error","Math","min","max","info","requested","applied","userId","q","maxResults","trim","length","users","list","data","nextPageToken","undefined","map","m","id","filter","Boolean","concurrency","message","String","query","hasPageToken","maxConcurrency","minConcurrency","safeConcurrency","results","format","metadataHeadersForRequest","requestParams","batchSize","batches","i","processedCount","batch","batchPromises","Array","baseParams","push","slice","batchIndex","messageResponse","globalIndex","get","messageId","Promise","all","result"],"mappings":"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"}
+{"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":["fetchMessagesConcurrently","fetchMessagesPage","gmail","params","gmailQ","pageSize","pageToken","body","logger","metadataHeaders","maxPageSize","minPageSize","safePageSize","listParams","listResponse","response","messages","items","concurrentArgs","detailedMessages","error","errorMessage","Number","isInteger","Error","Math","min","max","info","requested","applied","userId","q","maxResults","trim","length","users","list","data","nextPageToken","undefined","map","m","id","filter","Boolean","concurrency","message","String","query","hasPageToken","maxConcurrency","minConcurrency","safeConcurrency","results","format","metadataHeadersForRequest","requestParams","batchSize","batches","i","processedCount","batch","batchPromises","Array","baseParams","push","slice","batchIndex","messageResponse","globalIndex","get","messageId","Promise","all","result"],"mappings":"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"}

package/dist/cjs/email/querying/search-execution.d.cts

@@ -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/cjs/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/cjs/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":["searchMessages","buildGmailQ","query","emitted","toGmailQuery","q","gmail","opts","pageSize","includeBody","pageToken","logger","gmailQ","metadataHeaders","pageParams","result","body","fetchMessagesPage","messages","nextPageToken"],"mappings":";;;;+BAwCsBA;;;eAAAA;;;4BArC0C;8BACnC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAyB7B,SAASC,YAAYC,KAA4B;;IAC/C,IAAI,CAACA,OAAO,OAAO;IACnB,IAAMC,UAAUC,IAAAA,4BAAY,EAACF;IAC7B,eAAOC,oBAAAA,8BAAAA,QAASE,CAAC,uCAAI;AACvB;AAOO,SAAeL,eAAeM,KAAqB,EAAEC,IAAwB;;YAC1EL,uBAAOM,6BAAeC,aAAqBC,WAAWC,QACxDC,QACAC,iBAEAC,YAQAC;;;;oBAZEb,QAAiEK,KAAjEL,wBAAiEK,KAA1DC,UAAAA,uCAAW,yCAA+CD,KAA3CE,aAAAA,6CAAc,2BAAOC,YAAsBH,KAAtBG,WAAWC,SAAWJ,KAAXI;oBACxDC,SAASX,YAAYC;oBACrBW;wBAAmB;wBAAQ;wBAAW;wBAAQ;wBAAM;wBAAM;;oBAChE,4FAA4F;oBACtFC,aAAsC;wBAC1CF,QAAAA;wBACAJ,UAAAA;wBACAQ,MAAMP;wBACNI,iBAAAA;wBACAH,WAAAA;wBACAC,QAAAA;oBACF;oBACe;;wBAAMM,IAAAA,+BAAiB,EAACX,OAAOQ;;;oBAAxCC,SAAS;oBAEf,+DAA+D;oBAC/D;;wBAAO;4BACLG,UAAUH,OAAOG,QAAQ;4BACzBC,eAAeJ,OAAOI,aAAa;wBACrC;;;;IACF"}
+{"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":["searchMessages","buildGmailQ","query","emitted","toGmailQuery","q","gmail","opts","pageSize","includeBody","pageToken","logger","gmailQ","metadataHeaders","pageParams","result","body","fetchMessagesPage","messages","nextPageToken"],"mappings":";;;;+BAwCsBA;;;eAAAA;;;4BArC0C;8BACnC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAyB7B,SAASC,YAAYC,KAA4B;;IAC/C,IAAI,CAACA,OAAO,OAAO;IACnB,IAAMC,UAAUC,IAAAA,4BAAY,EAACF;IAC7B,eAAOC,oBAAAA,8BAAAA,QAASE,CAAC,uCAAI;AACvB;AAOO,SAAeL,eAAeM,KAAqB,EAAEC,IAAwB;;YAC1EL,uBAAOM,6BAAeC,aAAqBC,WAAWC,QACxDC,QACAC,iBAEAC,YAQAC;;;;oBAZEb,QAAiEK,KAAjEL,wBAAiEK,KAA1DC,UAAAA,uCAAW,yCAA+CD,KAA3CE,aAAAA,6CAAc,2BAAOC,YAAsBH,KAAtBG,WAAWC,SAAWJ,KAAXI;oBACxDC,SAASX,YAAYC;oBACrBW;wBAAmB;wBAAQ;wBAAW;wBAAQ;wBAAM;wBAAM;;oBAChE,4FAA4F;oBACtFC,aAAsC;wBAC1CF,QAAAA;wBACAJ,UAAAA;wBACAQ,MAAMP;wBACNI,iBAAAA;wBACAH,WAAAA;wBACAC,QAAAA;oBACF;oBACe;;wBAAMM,IAAAA,+BAAiB,EAACX,OAAOQ;;;oBAAxCC,SAAS;oBAEf,+DAA+D;oBAC/D;;wBAAO;4BACLG,UAAUH,OAAOG,QAAQ;4BACzBC,eAAeJ,OAAOI,aAAa;wBACrC;;;;IACF"}

package/dist/cjs/labels/gmail-labels.d.cts

@@ -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/cjs/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/cjs/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","upper","labels","existing","existingTyped","INBOX","SPAM","TRASH","UNREAD","STARRED","IMPORTANT","SENT","DRAFT","CATEGORY_PERSONAL","CATEGORY_SOCIAL","CATEGORY_PROMOTIONS","CATEGORY_UPDATES","CATEGORY_FORUMS","toUpperCase","users","list","Array","isArray","data","find","l","label","name","id","String","create","requestBody","labelListVisibility","messageListVisibility","Error"],"mappings":";;;;+BAEsBA;;;eAAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAf,SAAeA,cAAcC,KAAqB,EAAEC,MAAc,EAAEC,SAAiB;;YAuB7DC,cAiBxBC,eAtCCC,eAgBAC,OAIAH,QACAI,QACAC,UAIAC,eAIAL;;;;oBA/BN,+CAA+C;oBACzCC,gBAAwC;wBAC5CK,OAAO;wBACPC,MAAM;wBACNC,OAAO;wBACPC,QAAQ;wBACRC,SAAS;wBACTC,WAAW;wBACXC,MAAM;wBACNC,OAAO;wBACPC,mBAAmB;wBACnBC,iBAAiB;wBACjBC,qBAAqB;wBACrBC,kBAAkB;wBAClBC,iBAAiB;oBACnB;oBAEMhB,QAAQJ,UAAUqB,WAAW;oBACnC,IAAIlB,aAAa,CAACC,MAAM,EAAE;;wBAAOD,aAAa,CAACC,MAAM;;oBAGtC;;wBAAMN,MAAMwB,KAAK,CAACjB,MAAM,CAACkB,IAAI,CAAC;4BAAExB,QAAAA;wBAAO;;;oBAAhDE,SAAS;oBACTI,SAASmB,MAAMC,OAAO,CAACxB,mBAAAA,8BAAAA,eAAAA,OAAQyB,IAAI,cAAZzB,mCAAAA,aAAcI,MAAM,IAAIJ,OAAOyB,IAAI,CAACrB,MAAM;oBACjEC,WAAWD,OAAOsB,IAAI,CAAC,SAACC;wBAC5B,IAAMC,QAAQD;wBACd,OAAOC,CAAAA,kBAAAA,4BAAAA,MAAOC,IAAI,MAAK9B;oBACzB;oBACMO,gBAAgBD;oBACtB,IAAIC,0BAAAA,oCAAAA,cAAewB,EAAE,EAAE;;wBAAOC,OAAOzB,cAAcwB,EAAE;;oBAGrC;;wBAAMjC,MAAMwB,KAAK,CAACjB,MAAM,CAAC4B,MAAM,CAAC;4BAC9ClC,QAAAA;4BACAmC,aAAa;gCACXJ,MAAM9B;gCACNmC,qBAAqB;gCACrBC,uBAAuB;4BACzB;wBACF;;;oBAPMlC,UAAU;oBAQhB,IAAI,EAACA,oBAAAA,+BAAAA,gBAAAA,QAASwB,IAAI,cAAbxB,oCAAAA,cAAe6B,EAAE,GAAE,MAAM,IAAIM,MAAM;oBACxC;;wBAAOnC,QAAQwB,IAAI,CAACK,EAAE;;;;IACxB"}
+{"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","upper","labels","existing","existingTyped","INBOX","SPAM","TRASH","UNREAD","STARRED","IMPORTANT","SENT","DRAFT","CATEGORY_PERSONAL","CATEGORY_SOCIAL","CATEGORY_PROMOTIONS","CATEGORY_UPDATES","CATEGORY_FORUMS","toUpperCase","users","list","Array","isArray","data","find","l","label","name","id","String","create","requestBody","labelListVisibility","messageListVisibility","Error"],"mappings":";;;;+BAEsBA;;;eAAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAf,SAAeA,cAAcC,KAAqB,EAAEC,MAAc,EAAEC,SAAiB;;YAuB7DC,cAiBxBC,eAtCCC,eAgBAC,OAIAH,QACAI,QACAC,UAIAC,eAIAL;;;;oBA/BN,+CAA+C;oBACzCC,gBAAwC;wBAC5CK,OAAO;wBACPC,MAAM;wBACNC,OAAO;wBACPC,QAAQ;wBACRC,SAAS;wBACTC,WAAW;wBACXC,MAAM;wBACNC,OAAO;wBACPC,mBAAmB;wBACnBC,iBAAiB;wBACjBC,qBAAqB;wBACrBC,kBAAkB;wBAClBC,iBAAiB;oBACnB;oBAEMhB,QAAQJ,UAAUqB,WAAW;oBACnC,IAAIlB,aAAa,CAACC,MAAM,EAAE;;wBAAOD,aAAa,CAACC,MAAM;;oBAGtC;;wBAAMN,MAAMwB,KAAK,CAACjB,MAAM,CAACkB,IAAI,CAAC;4BAAExB,QAAAA;wBAAO;;;oBAAhDE,SAAS;oBACTI,SAASmB,MAAMC,OAAO,CAACxB,mBAAAA,8BAAAA,eAAAA,OAAQyB,IAAI,cAAZzB,mCAAAA,aAAcI,MAAM,IAAIJ,OAAOyB,IAAI,CAACrB,MAAM;oBACjEC,WAAWD,OAAOsB,IAAI,CAAC,SAACC;wBAC5B,IAAMC,QAAQD;wBACd,OAAOC,CAAAA,kBAAAA,4BAAAA,MAAOC,IAAI,MAAK9B;oBACzB;oBACMO,gBAAgBD;oBACtB,IAAIC,0BAAAA,oCAAAA,cAAewB,EAAE,EAAE;;wBAAOC,OAAOzB,cAAcwB,EAAE;;oBAGrC;;wBAAMjC,MAAMwB,KAAK,CAACjB,MAAM,CAAC4B,MAAM,CAAC;4BAC9ClC,QAAAA;4BACAmC,aAAa;gCACXJ,MAAM9B;gCACNmC,qBAAqB;gCACrBC,uBAAuB;4BACzB;wBACF;;;oBAPMlC,UAAU;oBAQhB,IAAI,EAACA,oBAAAA,+BAAAA,gBAAAA,QAASwB,IAAI,cAAbxB,oCAAAA,cAAe6B,EAAE,GAAE,MAAM,IAAIM,MAAM;oBACxC;;wBAAOnC,QAAQwB,IAAI,CAACK,EAAE;;;;IACxB"}

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

@@ -8,9 +8,9 @@ Object.defineProperty(exports, "googleAuth", {
         return googleAuth;
     }
 });
+var _gmail = require("@googleapis/gmail");
 var _oauthgoogle = require("@mcp-z/oauth-google");
-var _googleapis = require("googleapis");
 function googleAuth(auth) {
-    return (0, _oauthgoogle.attachTokenProvider)(new _googleapis.google.auth.OAuth2(), auth);
+    return (0, _oauthgoogle.attachTokenProvider)(new _gmail.auth.OAuth2(), auth);
 }
 /* CJS INTEROP */ if (exports.__esModule && exports.default) { try { Object.defineProperty(exports.default, '__esModule', { value: true }); for (var key in exports) { exports.default[key] = exports[key]; } } catch (_) {}; module.exports = exports.default; }

package/dist/cjs/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":["googleAuth","auth","attachTokenProvider","google","OAuth2"],"mappings":";;;;+BAUgBA;;;eAAAA;;;2BAV6C;0BACtC;AAShB,SAASA,WAAWC,IAAwB;IACjD,OAAOC,IAAAA,gCAAmB,EAAC,IAAIC,kBAAM,CAACF,IAAI,CAACG,MAAM,IAAIH;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":["googleAuth","auth","attachTokenProvider","googleAuthPlus","OAuth2"],"mappings":";;;;+BAUgBA;;;eAAAA;;;qBAVuB;2BACsB;AAStD,SAASA,WAAWC,IAAwB;IACjD,OAAOC,IAAAA,gCAAmB,EAAC,IAAIC,WAAc,CAACC,MAAM,IAAIH;AAC1D"}

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

@@ -8,8 +8,8 @@ Object.defineProperty(exports, "default", {
         return createResource;
     }
 });
+var _gmail = require("@googleapis/gmail");
 var _server = require("@mcp-z/server");
-var _googleapis = require("googleapis");
 var _messageextractionts = require("../../email/parsing/message-extraction.js");
 var _dateconversionts = require("../../lib/date-conversion.js");
 var _googleauthts = require("../../lib/google-auth.js");
@@ -160,7 +160,7 @@ function createResource() {
                         ]);
                         logger = extra.logger, authContext = extra.authContext;
                         logger.info(variables, 'gmail-email resource fetch');
-                        gmail = _googleapis.google.gmail({
+                        gmail = (0, _gmail.gmail)({
                             version: 'v1',
                             auth: (0, _googleauthts.googleAuth)(authContext.auth)
                         });

package/dist/cjs/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":["createResource","template","ResourceTemplate","list","undefined","config","description","mimeType","handler","uri","variables","extra","fullData","headersMap","logger","authContext","gmail","response","headers","headersArray","fromInfo","toStr","metadata","e","error","info","google","version","auth","googleAuth","users","messages","get","userId","id","format","metadataHeaders","data","Error","payload","Array","isArray","Object","fromEntries","map","h","header","String","name","value","extractFrom","From","extractEmails","To","join","subject","Subject","from","address","to","date","toIsoUtc","Date","contents","href","text","JSON","stringify","message"],"mappings":"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"}
+{"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":["createResource","template","ResourceTemplate","list","undefined","config","description","mimeType","handler","uri","variables","extra","fullData","headersMap","logger","authContext","gmail","response","headers","headersArray","fromInfo","toStr","metadata","e","error","info","gmailApi","version","auth","googleAuth","users","messages","get","userId","id","format","metadataHeaders","data","Error","payload","Array","isArray","Object","fromEntries","map","h","header","String","name","value","extractFrom","From","extractEmails","To","join","subject","Subject","from","address","to","date","toIsoUtc","Date","contents","href","text","JSON","stringify","message"],"mappings":"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"}

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

@@ -16,9 +16,9 @@ _export(exports, {
         return inputSchema;
     }
 });
+var _gmail = require("@googleapis/gmail");
 var _oauthgoogle = require("@mcp-z/oauth-google");
 var _server = require("@mcp-z/server");
-var _googleapis = require("googleapis");
 var _zod = require("zod");
 var _googleauthts = require("../../lib/google-auth.js");
 function asyncGeneratorStep(gen, resolve, reject, _next, _throw, key, arg) {
@@ -193,7 +193,7 @@ function handler(_, extra) {
                         ,
                         4
                     ]);
-                    gmail = _googleapis.google.gmail({
+                    gmail = (0, _gmail.gmail)({
                         version: 'v1',
                         auth: (0, _googleauthts.googleAuth)(extra.authContext.auth)
                     });

package/dist/cjs/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":["createTool","inputSchema","AuthRequiredBranchSchema","schemas","CategorySchema","z","object","id","string","describe","name","description","successBranchSchema","type","literal","items","array","outputSchema","discriminatedUnion","config","result","handler","_","extra","logger","gmail","started","response","labels","categories","durationMs","error","message","info","google","version","auth","googleAuth","authContext","Date","now","users","list","userId","data","filter","label","startsWith","map","replace","sort","a","b","localeCompare","categoryCount","length","totalLabels","content","text","JSON","stringify","structuredContent","Error","String","ProtocolError","ProtocolErrorCode","InternalError","stack","undefined"],"mappings":"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"}
+{"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":["createTool","inputSchema","AuthRequiredBranchSchema","schemas","CategorySchema","z","object","id","string","describe","name","description","successBranchSchema","type","literal","items","array","outputSchema","discriminatedUnion","config","result","handler","_","extra","logger","gmail","started","response","labels","categories","durationMs","error","message","info","gmailApi","version","auth","googleAuth","authContext","Date","now","users","list","userId","data","filter","label","startsWith","map","replace","sort","a","b","localeCompare","categoryCount","length","totalLabels","content","text","JSON","stringify","structuredContent","Error","String","ProtocolError","ProtocolErrorCode","InternalError","stack","undefined"],"mappings":"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"}

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

@@ -8,9 +8,9 @@ Object.defineProperty(exports, "default", {
         return createTool;
     }
 });
+var _gmail = require("@googleapis/gmail");
 var _oauthgoogle = require("@mcp-z/oauth-google");
 var _server = require("@mcp-z/server");
-var _googleapis = require("googleapis");
 var _zod = require("zod");
 var _gmaillabelsts = require("../../labels/gmail-labels.js");
 var _googleauthts = require("../../lib/google-auth.js");
@@ -197,7 +197,7 @@ function handler(_0, _1) {
                         ,
                         5
                     ]);
-                    gmail = _googleapis.google.gmail({
+                    gmail = (0, _gmail.gmail)({
                         version: 'v1',
                         auth: (0, _googleauthts.googleAuth)(extra.authContext.auth)
                     });

package/dist/cjs/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":["createTool","AuthRequiredBranchSchema","schemas","inputSchema","z","object","id","coerce","string","trim","min","describe","label","successBranchSchema","type","literal","item","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","gmail","labelId","error","message","info","ProtocolError","ProtocolErrorCode","InvalidParams","google","version","auth","googleAuth","authContext","ensureLabelId","users","messages","modify","userId","requestBody","addLabelIds","content","text","JSON","stringify","structuredContent","Error","String","InternalError","stack","undefined","name"],"mappings":"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"}
+{"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":["createTool","AuthRequiredBranchSchema","schemas","inputSchema","z","object","id","coerce","string","trim","min","describe","label","successBranchSchema","type","literal","item","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","gmail","labelId","error","message","info","ProtocolError","ProtocolErrorCode","InvalidParams","gmailApi","version","auth","googleAuth","authContext","ensureLabelId","users","messages","modify","userId","requestBody","addLabelIds","content","text","JSON","stringify","structuredContent","Error","String","InternalError","stack","undefined","name"],"mappings":"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"}

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

@@ -8,9 +8,9 @@ Object.defineProperty(exports, "default", {
         return createTool;
     }
 });
+var _gmail = require("@googleapis/gmail");
 var _oauthgoogle = require("@mcp-z/oauth-google");
 var _server = require("@mcp-z/server");
-var _googleapis = require("googleapis");
 var _zod = require("zod");
 var _constantsts = require("../../constants.js");
 var _googleauthts = require("../../lib/google-auth.js");
@@ -379,7 +379,7 @@ function handler(_0, _1) {
                             }
                         });
                     };
-                    gmail = _googleapis.google.gmail({
+                    gmail = (0, _gmail.gmail)({
                         version: 'v1',
                         auth: (0, _googleauthts.googleAuth)(extra.authContext.auth)
                     });