@mcp-z/mcp-gmail 1.1.3 → 2.1.0

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

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

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

@@ -1,8 +1,9 @@
 import { schemas } from '@mcp-z/oauth-google';
 const { AuthRequiredBranchSchema } = schemas;
-import { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';
+import { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';
 import { google } from 'googleapis';
 import { z } from 'zod';
+import { googleAuth } from '../../lib/google-auth.js';
 // Schema for individual category items
 const CategorySchema = z.object({
     id: z.string().describe('Gmail category ID (e.g., CATEGORY_PERSONAL)'),
@@ -35,7 +36,7 @@ async function handler(_, extra) {
     try {
         const gmail = google.gmail({
             version: 'v1',
-            auth: extra.authContext.auth
+            auth: googleAuth(extra.authContext.auth)
         });
         const started = Date.now();
         // Fetch all labels from Gmail API
@@ -112,7 +113,7 @@ async function handler(_, extra) {
         logger.error('gmail.categories.list error', {
             error: message
         });
-        throw new McpError(ErrorCode.InternalError, `Error listing categories: ${message}`, {
+        throw new ProtocolError(ProtocolErrorCode.InternalError, `Error listing categories: ${message}`, {
             stack: error instanceof Error ? error.stack : undefined
         });
     }

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

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-gmail/src/mcp/tools/categories-list.ts"],"sourcesContent":["import type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport { schemas } from '@mcp-z/oauth-google';\n\nconst { AuthRequiredBranchSchema } = schemas;\n\nimport type { ToolModule } from '@mcp-z/server';\nimport { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';\nimport { google } from 'googleapis';\nimport { z } from 'zod';\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: 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 McpError(ErrorCode.InternalError, `Error listing categories: ${message}`, {\n      stack: error instanceof Error ? error.stack : undefined,\n    });\n  }\n}\n\nexport default function createTool() {\n  return {\n    name: 'categories-list',\n    config,\n    handler,\n  } satisfies ToolModule;\n}\n"],"names":["schemas","AuthRequiredBranchSchema","ErrorCode","McpError","google","z","CategorySchema","object","id","string","describe","name","description","inputSchema","successBranchSchema","type","literal","items","array","outputSchema","discriminatedUnion","config","result","handler","_","extra","logger","info","gmail","version","auth","authContext","started","Date","now","response","users","labels","list","userId","data","categories","filter","label","startsWith","map","replace","sort","a","b","localeCompare","durationMs","categoryCount","length","totalLabels","content","text","JSON","stringify","structuredContent","error","message","Error","String","InternalError","stack","undefined","createTool"],"mappings":"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"}
+{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-gmail/src/mcp/tools/categories-list.ts"],"sourcesContent":["import type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport { schemas } from '@mcp-z/oauth-google';\n\nconst { AuthRequiredBranchSchema } = schemas;\n\nimport type { ToolModule } from '@mcp-z/server';\nimport { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';\nimport { google } from 'googleapis';\nimport { z } from 'zod';\nimport { googleAuth } from '../../lib/google-auth.ts';\n\n// Schema for individual category items\nconst CategorySchema = z.object({\n  id: z.string().describe('Gmail category ID (e.g., CATEGORY_PERSONAL)'),\n  name: z.string().describe('Human-readable category name'),\n  description: z.string().describe('Description of what emails belong in this category'),\n});\n\n/**\n * Input schema for the categories-list tool (currently empty as this tool takes no parameters).\n */\nexport const inputSchema = z.object({});\n\n// Success branch schema\nconst successBranchSchema = z.object({\n  type: z.literal('success'),\n  items: z.array(CategorySchema),\n});\n\n// Output schema with auth_required support\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n  description: 'List Gmail category labels (CATEGORY_*) with IDs and descriptions.',\n  inputSchema: inputSchema,\n  outputSchema: z.object({\n    result: outputSchema,\n  }),\n} as const;\n\n/**\n * Input parameters for the categories-list tool.\n */\nexport type Input = z.infer<typeof inputSchema>;\nexport type Output = z.infer<typeof outputSchema>;\n\nasync function handler(_: Input, extra: EnrichedExtra) {\n  const logger = extra.logger;\n  logger.info('gmail.categories.list called');\n\n  try {\n    const gmail = google.gmail({ version: 'v1', auth: googleAuth(extra.authContext.auth) });\n    const started = Date.now();\n\n    // Fetch all labels from Gmail API\n    const response = await gmail.users.labels.list({ userId: 'me' });\n    const labels = response.data.labels || [];\n\n    // Filter for CATEGORY_* system labels and map to our schema\n    const categories = labels\n      .filter((label) => label.id?.startsWith('CATEGORY_'))\n      .map((label) => {\n        const id = label.id as string;\n        let name = label.name || id;\n        let description = '';\n\n        // Map known category types to user-friendly names and descriptions\n        switch (id) {\n          case 'CATEGORY_PERSONAL':\n            name = 'Primary';\n            description = 'Important emails from people you know';\n            break;\n          case 'CATEGORY_SOCIAL':\n            name = 'Social';\n            description = 'Social networks and social websites';\n            break;\n          case 'CATEGORY_PROMOTIONS':\n            name = 'Promotions';\n            description = 'Deals, offers, and marketing emails';\n            break;\n          case 'CATEGORY_UPDATES':\n            name = 'Updates';\n            description = 'Confirmations, receipts, bills, and statements';\n            break;\n          case 'CATEGORY_FORUMS':\n            name = 'Forums';\n            description = 'Online groups, discussion boards, mailing lists';\n            break;\n          default:\n            // For any unknown CATEGORY_* labels, use the label name as-is\n            name = label.name || id.replace('CATEGORY_', '');\n            description = `Gmail category: ${name}`;\n        }\n\n        return {\n          id,\n          name,\n          description,\n        };\n      })\n      .sort((a, b) => a.name.localeCompare(b.name)); // Sort alphabetically by name\n\n    const durationMs = Date.now() - started;\n\n    logger.info('gmail.categories.list results', { categoryCount: categories.length, totalLabels: labels.length });\n    logger.info('gmail.categories.list metrics', { durationMs });\n\n    const result: Output = {\n      type: 'success' as const,\n      items: categories,\n    };\n\n    return {\n      content: [\n        {\n          type: 'text' as const,\n          text: JSON.stringify(result),\n        },\n      ],\n      structuredContent: { result },\n    };\n  } catch (error) {\n    const message = error instanceof Error ? error.message : String(error);\n    logger.error('gmail.categories.list error', { error: message });\n\n    throw new ProtocolError(ProtocolErrorCode.InternalError, `Error listing categories: ${message}`, {\n      stack: error instanceof Error ? error.stack : undefined,\n    });\n  }\n}\n\nexport default function createTool() {\n  return {\n    name: 'categories-list',\n    config,\n    handler,\n  } satisfies ToolModule;\n}\n"],"names":["schemas","AuthRequiredBranchSchema","ProtocolError","ProtocolErrorCode","google","z","googleAuth","CategorySchema","object","id","string","describe","name","description","inputSchema","successBranchSchema","type","literal","items","array","outputSchema","discriminatedUnion","config","result","handler","_","extra","logger","info","gmail","version","auth","authContext","started","Date","now","response","users","labels","list","userId","data","categories","filter","label","startsWith","map","replace","sort","a","b","localeCompare","durationMs","categoryCount","length","totalLabels","content","text","JSON","stringify","structuredContent","error","message","Error","String","InternalError","stack","undefined","createTool"],"mappings":"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"}

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

@@ -1,9 +1,10 @@
 import { schemas } from '@mcp-z/oauth-google';
 const { AuthRequiredBranchSchema } = schemas;
-import { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';
+import { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';
 import { google } from 'googleapis';
 import { z } from 'zod';
 import { ensureLabelId } from '../../labels/gmail-labels.js';
+import { googleAuth } from '../../lib/google-auth.js';
 const inputSchema = z.object({
     id: z.coerce.string().trim().min(1).describe('Gmail message ID to add label to'),
     label: z.coerce.string().trim().min(1).describe('Label name or ID (use gmail-labels-list to discover available labels)')
@@ -39,12 +40,12 @@ async function handler({ id, label }, extra) {
             id,
             label
         });
-        throw new McpError(ErrorCode.InvalidParams, 'Missing id or label');
+        throw new ProtocolError(ProtocolErrorCode.InvalidParams, 'Missing id or label');
     }
     try {
         const gmail = google.gmail({
             version: 'v1',
-            auth: extra.authContext.auth
+            auth: googleAuth(extra.authContext.auth)
         });
         const labelId = await ensureLabelId(gmail, 'me', label);
         await gmail.users.messages.modify({
@@ -87,7 +88,7 @@ async function handler({ id, label }, extra) {
         logger.error('gmail.label.add error', {
             error: message
         });
-        throw new McpError(ErrorCode.InternalError, `Error adding label to message: ${message}`, {
+        throw new ProtocolError(ProtocolErrorCode.InternalError, `Error adding label to message: ${message}`, {
             stack: error instanceof Error ? error.stack : undefined
         });
     }

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

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

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

@@ -1,9 +1,10 @@
 import { schemas } from '@mcp-z/oauth-google';
 const { AuthRequiredBranchSchema } = schemas;
-import { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';
+import { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';
 import { google } from 'googleapis';
 import { z } from 'zod';
 import { CHUNK_SIZE, MAX_BATCH_SIZE } from '../../constants.js';
+import { googleAuth } from '../../lib/google-auth.js';
 const inputSchema = z.object({
     ids: z.array(z.coerce.string().trim().min(1)).min(1).describe('Gmail label IDs to delete')
 });
@@ -35,11 +36,11 @@ async function handler({ ids }, extra) {
         count: ids.length
     });
     if (!ids || ids.length === 0) {
-        throw new McpError(ErrorCode.InvalidParams, 'Missing ids');
+        throw new ProtocolError(ProtocolErrorCode.InvalidParams, 'Missing ids');
     }
     // Validate batch size to prevent memory exhaustion
     if (ids.length > MAX_BATCH_SIZE) {
-        throw new McpError(ErrorCode.InvalidParams, `Batch size ${ids.length} exceeds maximum allowed size of ${MAX_BATCH_SIZE}`);
+        throw new ProtocolError(ProtocolErrorCode.InvalidParams, `Batch size ${ids.length} exceeds maximum allowed size of ${MAX_BATCH_SIZE}`);
     }
     // Validate and sanitize IDs
     const validatedIds = [];
@@ -58,15 +59,15 @@ async function handler({ ids }, extra) {
         validatedIds.push(trimmedId);
     }
     if (invalidIds.length > 0) {
-        throw new McpError(ErrorCode.InvalidParams, `Found ${invalidIds.length} invalid IDs: ${invalidIds.join(', ')}`);
+        throw new ProtocolError(ProtocolErrorCode.InvalidParams, `Found ${invalidIds.length} invalid IDs: ${invalidIds.join(', ')}`);
     }
     if (validatedIds.length === 0) {
-        throw new McpError(ErrorCode.InvalidParams, 'No valid IDs found after validation');
+        throw new ProtocolError(ProtocolErrorCode.InvalidParams, 'No valid IDs found after validation');
     }
     try {
         const gmail = google.gmail({
             version: 'v1',
-            auth: extra.authContext.auth
+            auth: googleAuth(extra.authContext.auth)
         });
         // Get all labels first to check for system labels
         const labelsResponse = await gmail.users.labels.list({
@@ -172,7 +173,7 @@ async function handler({ ids }, extra) {
         logger.error('gmail-label-delete error', {
             error: message
         });
-        throw new McpError(ErrorCode.InternalError, `Error deleting labels: ${message}`, {
+        throw new ProtocolError(ProtocolErrorCode.InternalError, `Error deleting labels: ${message}`, {
             stack: error instanceof Error ? error.stack : undefined
         });
     }

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

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-gmail/src/mcp/tools/label-delete.ts"],"sourcesContent":["import type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport { schemas } from '@mcp-z/oauth-google';\n\nconst { AuthRequiredBranchSchema } = schemas;\n\nimport type { ToolModule } from '@mcp-z/server';\nimport { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';\nimport { google } from 'googleapis';\nimport { z } from 'zod';\nimport { CHUNK_SIZE, MAX_BATCH_SIZE } from '../../constants.ts';\n\nconst inputSchema = z.object({\n  ids: z.array(z.coerce.string().trim().min(1)).min(1).describe('Gmail label IDs to delete'),\n});\n\nconst successBranchSchema = z.object({\n  type: z.literal('success'),\n  totalRequested: z.number().describe('Total number of labels requested to delete'),\n  successCount: z.number().describe('Number of labels successfully deleted'),\n  failureCount: z.number().describe('Number of labels that failed to delete'),\n  results: z\n    .array(\n      z.object({\n        id: z.string().describe('Label ID'),\n        success: z.boolean().describe('Whether the operation succeeded'),\n        error: z.string().optional().describe('Error message if operation failed'),\n      })\n    )\n    .describe('Individual results for each label'),\n});\n\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n  description: 'Delete Gmail labels permanently (irreversible). System labels (INBOX, SENT, etc.) cannot be deleted.',\n  inputSchema: inputSchema,\n  outputSchema: z.object({\n    result: outputSchema,\n  }),\n} as const;\n\nexport type Input = z.infer<typeof inputSchema>;\nexport type Output = z.infer<typeof outputSchema>;\n\nasync function handler({ ids }: Input, extra: EnrichedExtra) {\n  const logger = extra.logger;\n  logger.info('gmail-label-delete called', { count: ids.length });\n\n  if (!ids || ids.length === 0) {\n    throw new McpError(ErrorCode.InvalidParams, 'Missing ids');\n  }\n\n  // Validate batch size to prevent memory exhaustion\n  if (ids.length > MAX_BATCH_SIZE) {\n    throw new McpError(ErrorCode.InvalidParams, `Batch size ${ids.length} exceeds maximum allowed size of ${MAX_BATCH_SIZE}`);\n  }\n\n  // Validate and sanitize IDs\n  const validatedIds: string[] = [];\n  const invalidIds: string[] = [];\n\n  for (const id of ids) {\n    const trimmedId = id.trim();\n    if (!trimmedId) {\n      invalidIds.push(id);\n      continue;\n    }\n    // Basic Gmail label ID validation - should not contain certain characters\n    if (trimmedId.includes('/') || trimmedId.includes('\\\\') || trimmedId.includes('<') || trimmedId.includes('>')) {\n      invalidIds.push(id);\n      continue;\n    }\n    validatedIds.push(trimmedId);\n  }\n\n  if (invalidIds.length > 0) {\n    throw new McpError(ErrorCode.InvalidParams, `Found ${invalidIds.length} invalid IDs: ${invalidIds.join(', ')}`);\n  }\n\n  if (validatedIds.length === 0) {\n    throw new McpError(ErrorCode.InvalidParams, 'No valid IDs found after validation');\n  }\n\n  try {\n    const gmail = google.gmail({ version: 'v1', auth: extra.authContext.auth });\n    // Get all labels first to check for system labels\n    const labelsResponse = await gmail.users.labels.list({ userId: 'me' });\n    const allLabels = labelsResponse.data.labels || [];\n    const labelMap = new Map(allLabels.map((label) => [label.id || '', label]));\n\n    // Process deletions in chunks to prevent memory exhaustion\n    const allResults: Array<{ id: string; success: boolean; error?: string }> = [];\n\n    for (let i = 0; i < validatedIds.length; i += CHUNK_SIZE) {\n      const chunk = validatedIds.slice(i, i + CHUNK_SIZE);\n      logger.info('Processing chunk', { chunkIndex: i / CHUNK_SIZE + 1, chunkSize: chunk.length, totalChunks: Math.ceil(validatedIds.length / CHUNK_SIZE) });\n\n      const chunkResults = await Promise.allSettled(\n        chunk.map(async (id) => {\n          const label = labelMap.get(id);\n\n          // Check if label exists\n          if (!label) {\n            throw new Error(`Label not found: ${id}`);\n          }\n\n          // Check if it's a system label\n          if (label.type === 'system') {\n            throw new Error(`Cannot delete system label: ${label.name} (${id})`);\n          }\n\n          // Delete the label\n          await gmail.users.labels.delete({\n            userId: 'me',\n            id: id,\n          });\n          return { id, success: true };\n        })\n      );\n\n      // Process chunk results\n      const processedChunkResults = chunkResults.map((result, chunkIndex) => {\n        const id = chunk[chunkIndex];\n        if (!id) {\n          throw new Error(`Chunk index ${chunkIndex} is out of bounds for chunk of size ${chunk.length}`);\n        }\n        if (result.status === 'fulfilled') {\n          return { id, success: true };\n        }\n\n        // Extract error message more robustly\n        let errorMessage = 'Unknown error';\n        if (result.reason) {\n          if (typeof result.reason === 'string') {\n            errorMessage = result.reason;\n          } else if (result.reason instanceof Error) {\n            errorMessage = result.reason.message;\n          } else if (result.reason && typeof result.reason === 'object' && 'message' in result.reason) {\n            errorMessage = String(result.reason.message);\n          } else if (result.reason && typeof result.reason === 'object' && 'error' in result.reason) {\n            errorMessage = String(result.reason.error);\n          } else {\n            errorMessage = String(result.reason);\n          }\n        }\n\n        return { id, success: false, error: errorMessage };\n      });\n\n      allResults.push(...processedChunkResults);\n    }\n\n    const successCount = allResults.filter((r) => r.success).length;\n    const failureCount = allResults.filter((r) => !r.success).length;\n\n    logger.info('gmail-label-delete completed', {\n      totalRequested: validatedIds.length,\n      successCount,\n      failureCount,\n      chunksProcessed: Math.ceil(validatedIds.length / CHUNK_SIZE),\n    });\n\n    const result: Output = {\n      type: 'success' as const,\n      totalRequested: validatedIds.length,\n      successCount,\n      failureCount,\n      results: allResults,\n    };\n\n    return {\n      content: [\n        {\n          type: 'text' as const,\n          text: JSON.stringify(result),\n        },\n      ],\n      structuredContent: { result },\n    };\n  } catch (error) {\n    const message = error instanceof Error ? error.message : String(error);\n    logger.error('gmail-label-delete error', { error: message });\n\n    throw new McpError(ErrorCode.InternalError, `Error deleting labels: ${message}`, {\n      stack: error instanceof Error ? error.stack : undefined,\n    });\n  }\n}\n\nexport default function createTool() {\n  return {\n    name: 'label-delete',\n    config,\n    handler,\n  } satisfies ToolModule;\n}\n"],"names":["schemas","AuthRequiredBranchSchema","ErrorCode","McpError","google","z","CHUNK_SIZE","MAX_BATCH_SIZE","inputSchema","object","ids","array","coerce","string","trim","min","describe","successBranchSchema","type","literal","totalRequested","number","successCount","failureCount","results","id","success","boolean","error","optional","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","info","count","length","InvalidParams","validatedIds","invalidIds","trimmedId","push","includes","join","gmail","version","auth","authContext","labelsResponse","users","labels","list","userId","allLabels","data","labelMap","Map","map","label","allResults","i","chunk","slice","chunkIndex","chunkSize","totalChunks","Math","ceil","chunkResults","Promise","allSettled","get","Error","name","delete","processedChunkResults","status","errorMessage","reason","message","String","filter","r","chunksProcessed","content","text","JSON","stringify","structuredContent","InternalError","stack","undefined","createTool"],"mappings":"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"}
+{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-gmail/src/mcp/tools/label-delete.ts"],"sourcesContent":["import type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport { schemas } from '@mcp-z/oauth-google';\n\nconst { AuthRequiredBranchSchema } = schemas;\n\nimport type { ToolModule } from '@mcp-z/server';\nimport { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';\nimport { google } from 'googleapis';\nimport { z } from 'zod';\nimport { CHUNK_SIZE, MAX_BATCH_SIZE } from '../../constants.ts';\nimport { googleAuth } from '../../lib/google-auth.ts';\n\nconst inputSchema = z.object({\n  ids: z.array(z.coerce.string().trim().min(1)).min(1).describe('Gmail label IDs to delete'),\n});\n\nconst successBranchSchema = z.object({\n  type: z.literal('success'),\n  totalRequested: z.number().describe('Total number of labels requested to delete'),\n  successCount: z.number().describe('Number of labels successfully deleted'),\n  failureCount: z.number().describe('Number of labels that failed to delete'),\n  results: z\n    .array(\n      z.object({\n        id: z.string().describe('Label ID'),\n        success: z.boolean().describe('Whether the operation succeeded'),\n        error: z.string().optional().describe('Error message if operation failed'),\n      })\n    )\n    .describe('Individual results for each label'),\n});\n\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n  description: 'Delete Gmail labels permanently (irreversible). System labels (INBOX, SENT, etc.) cannot be deleted.',\n  inputSchema: inputSchema,\n  outputSchema: z.object({\n    result: outputSchema,\n  }),\n} as const;\n\nexport type Input = z.infer<typeof inputSchema>;\nexport type Output = z.infer<typeof outputSchema>;\n\nasync function handler({ ids }: Input, extra: EnrichedExtra) {\n  const logger = extra.logger;\n  logger.info('gmail-label-delete called', { count: ids.length });\n\n  if (!ids || ids.length === 0) {\n    throw new ProtocolError(ProtocolErrorCode.InvalidParams, 'Missing ids');\n  }\n\n  // Validate batch size to prevent memory exhaustion\n  if (ids.length > MAX_BATCH_SIZE) {\n    throw new ProtocolError(ProtocolErrorCode.InvalidParams, `Batch size ${ids.length} exceeds maximum allowed size of ${MAX_BATCH_SIZE}`);\n  }\n\n  // Validate and sanitize IDs\n  const validatedIds: string[] = [];\n  const invalidIds: string[] = [];\n\n  for (const id of ids) {\n    const trimmedId = id.trim();\n    if (!trimmedId) {\n      invalidIds.push(id);\n      continue;\n    }\n    // Basic Gmail label ID validation - should not contain certain characters\n    if (trimmedId.includes('/') || trimmedId.includes('\\\\') || trimmedId.includes('<') || trimmedId.includes('>')) {\n      invalidIds.push(id);\n      continue;\n    }\n    validatedIds.push(trimmedId);\n  }\n\n  if (invalidIds.length > 0) {\n    throw new ProtocolError(ProtocolErrorCode.InvalidParams, `Found ${invalidIds.length} invalid IDs: ${invalidIds.join(', ')}`);\n  }\n\n  if (validatedIds.length === 0) {\n    throw new ProtocolError(ProtocolErrorCode.InvalidParams, 'No valid IDs found after validation');\n  }\n\n  try {\n    const gmail = google.gmail({ version: 'v1', auth: googleAuth(extra.authContext.auth) });\n    // Get all labels first to check for system labels\n    const labelsResponse = await gmail.users.labels.list({ userId: 'me' });\n    const allLabels = labelsResponse.data.labels || [];\n    const labelMap = new Map(allLabels.map((label) => [label.id || '', label]));\n\n    // Process deletions in chunks to prevent memory exhaustion\n    const allResults: Array<{ id: string; success: boolean; error?: string }> = [];\n\n    for (let i = 0; i < validatedIds.length; i += CHUNK_SIZE) {\n      const chunk = validatedIds.slice(i, i + CHUNK_SIZE);\n      logger.info('Processing chunk', { chunkIndex: i / CHUNK_SIZE + 1, chunkSize: chunk.length, totalChunks: Math.ceil(validatedIds.length / CHUNK_SIZE) });\n\n      const chunkResults = await Promise.allSettled(\n        chunk.map(async (id) => {\n          const label = labelMap.get(id);\n\n          // Check if label exists\n          if (!label) {\n            throw new Error(`Label not found: ${id}`);\n          }\n\n          // Check if it's a system label\n          if (label.type === 'system') {\n            throw new Error(`Cannot delete system label: ${label.name} (${id})`);\n          }\n\n          // Delete the label\n          await gmail.users.labels.delete({\n            userId: 'me',\n            id: id,\n          });\n          return { id, success: true };\n        })\n      );\n\n      // Process chunk results\n      const processedChunkResults = chunkResults.map((result, chunkIndex) => {\n        const id = chunk[chunkIndex];\n        if (!id) {\n          throw new Error(`Chunk index ${chunkIndex} is out of bounds for chunk of size ${chunk.length}`);\n        }\n        if (result.status === 'fulfilled') {\n          return { id, success: true };\n        }\n\n        // Extract error message more robustly\n        let errorMessage = 'Unknown error';\n        if (result.reason) {\n          if (typeof result.reason === 'string') {\n            errorMessage = result.reason;\n          } else if (result.reason instanceof Error) {\n            errorMessage = result.reason.message;\n          } else if (result.reason && typeof result.reason === 'object' && 'message' in result.reason) {\n            errorMessage = String(result.reason.message);\n          } else if (result.reason && typeof result.reason === 'object' && 'error' in result.reason) {\n            errorMessage = String(result.reason.error);\n          } else {\n            errorMessage = String(result.reason);\n          }\n        }\n\n        return { id, success: false, error: errorMessage };\n      });\n\n      allResults.push(...processedChunkResults);\n    }\n\n    const successCount = allResults.filter((r) => r.success).length;\n    const failureCount = allResults.filter((r) => !r.success).length;\n\n    logger.info('gmail-label-delete completed', {\n      totalRequested: validatedIds.length,\n      successCount,\n      failureCount,\n      chunksProcessed: Math.ceil(validatedIds.length / CHUNK_SIZE),\n    });\n\n    const result: Output = {\n      type: 'success' as const,\n      totalRequested: validatedIds.length,\n      successCount,\n      failureCount,\n      results: allResults,\n    };\n\n    return {\n      content: [\n        {\n          type: 'text' as const,\n          text: JSON.stringify(result),\n        },\n      ],\n      structuredContent: { result },\n    };\n  } catch (error) {\n    const message = error instanceof Error ? error.message : String(error);\n    logger.error('gmail-label-delete error', { error: message });\n\n    throw new ProtocolError(ProtocolErrorCode.InternalError, `Error deleting labels: ${message}`, {\n      stack: error instanceof Error ? error.stack : undefined,\n    });\n  }\n}\n\nexport default function createTool() {\n  return {\n    name: 'label-delete',\n    config,\n    handler,\n  } satisfies ToolModule;\n}\n"],"names":["schemas","AuthRequiredBranchSchema","ProtocolError","ProtocolErrorCode","google","z","CHUNK_SIZE","MAX_BATCH_SIZE","googleAuth","inputSchema","object","ids","array","coerce","string","trim","min","describe","successBranchSchema","type","literal","totalRequested","number","successCount","failureCount","results","id","success","boolean","error","optional","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","info","count","length","InvalidParams","validatedIds","invalidIds","trimmedId","push","includes","join","gmail","version","auth","authContext","labelsResponse","users","labels","list","userId","allLabels","data","labelMap","Map","map","label","allResults","i","chunk","slice","chunkIndex","chunkSize","totalChunks","Math","ceil","chunkResults","Promise","allSettled","get","Error","name","delete","processedChunkResults","status","errorMessage","reason","message","String","filter","r","chunksProcessed","content","text","JSON","stringify","structuredContent","InternalError","stack","undefined","createTool"],"mappings":"AACA,SAASA,OAAO,QAAQ,sBAAsB;AAE9C,MAAM,EAAEC,wBAAwB,EAAE,GAAGD;AAGrC,SAASE,aAAa,EAAEC,iBAAiB,QAAQ,gBAAgB;AACjE,SAASC,MAAM,QAAQ,aAAa;AACpC,SAASC,CAAC,QAAQ,MAAM;AACxB,SAASC,UAAU,EAAEC,cAAc,QAAQ,qBAAqB;AAChE,SAASC,UAAU,QAAQ,2BAA2B;AAEtD,MAAMC,cAAcJ,EAAEK,MAAM,CAAC;IAC3BC,KAAKN,EAAEO,KAAK,CAACP,EAAEQ,MAAM,CAACC,MAAM,GAAGC,IAAI,GAAGC,GAAG,CAAC,IAAIA,GAAG,CAAC,GAAGC,QAAQ,CAAC;AAChE;AAEA,MAAMC,sBAAsBb,EAAEK,MAAM,CAAC;IACnCS,MAAMd,EAAEe,OAAO,CAAC;IAChBC,gBAAgBhB,EAAEiB,MAAM,GAAGL,QAAQ,CAAC;IACpCM,cAAclB,EAAEiB,MAAM,GAAGL,QAAQ,CAAC;IAClCO,cAAcnB,EAAEiB,MAAM,GAAGL,QAAQ,CAAC;IAClCQ,SAASpB,EACNO,KAAK,CACJP,EAAEK,MAAM,CAAC;QACPgB,IAAIrB,EAAES,MAAM,GAAGG,QAAQ,CAAC;QACxBU,SAAStB,EAAEuB,OAAO,GAAGX,QAAQ,CAAC;QAC9BY,OAAOxB,EAAES,MAAM,GAAGgB,QAAQ,GAAGb,QAAQ,CAAC;IACxC,IAEDA,QAAQ,CAAC;AACd;AAEA,MAAMc,eAAe1B,EAAE2B,kBAAkB,CAAC,QAAQ;IAACd;IAAqBjB;CAAyB;AAEjG,MAAMgC,SAAS;IACbC,aAAa;IACbzB,aAAaA;IACbsB,cAAc1B,EAAEK,MAAM,CAAC;QACrByB,QAAQJ;IACV;AACF;AAKA,eAAeK,QAAQ,EAAEzB,GAAG,EAAS,EAAE0B,KAAoB;IACzD,MAAMC,SAASD,MAAMC,MAAM;IAC3BA,OAAOC,IAAI,CAAC,6BAA6B;QAAEC,OAAO7B,IAAI8B,MAAM;IAAC;IAE7D,IAAI,CAAC9B,OAAOA,IAAI8B,MAAM,KAAK,GAAG;QAC5B,MAAM,IAAIvC,cAAcC,kBAAkBuC,aAAa,EAAE;IAC3D;IAEA,mDAAmD;IACnD,IAAI/B,IAAI8B,MAAM,GAAGlC,gBAAgB;QAC/B,MAAM,IAAIL,cAAcC,kBAAkBuC,aAAa,EAAE,CAAC,WAAW,EAAE/B,IAAI8B,MAAM,CAAC,iCAAiC,EAAElC,gBAAgB;IACvI;IAEA,4BAA4B;IAC5B,MAAMoC,eAAyB,EAAE;IACjC,MAAMC,aAAuB,EAAE;IAE/B,KAAK,MAAMlB,MAAMf,IAAK;QACpB,MAAMkC,YAAYnB,GAAGX,IAAI;QACzB,IAAI,CAAC8B,WAAW;YACdD,WAAWE,IAAI,CAACpB;YAChB;QACF;QACA,0EAA0E;QAC1E,IAAImB,UAAUE,QAAQ,CAAC,QAAQF,UAAUE,QAAQ,CAAC,SAASF,UAAUE,QAAQ,CAAC,QAAQF,UAAUE,QAAQ,CAAC,MAAM;YAC7GH,WAAWE,IAAI,CAACpB;YAChB;QACF;QACAiB,aAAaG,IAAI,CAACD;IACpB;IAEA,IAAID,WAAWH,MAAM,GAAG,GAAG;QACzB,MAAM,IAAIvC,cAAcC,kBAAkBuC,aAAa,EAAE,CAAC,MAAM,EAAEE,WAAWH,MAAM,CAAC,cAAc,EAAEG,WAAWI,IAAI,CAAC,OAAO;IAC7H;IAEA,IAAIL,aAAaF,MAAM,KAAK,GAAG;QAC7B,MAAM,IAAIvC,cAAcC,kBAAkBuC,aAAa,EAAE;IAC3D;IAEA,IAAI;QACF,MAAMO,QAAQ7C,OAAO6C,KAAK,CAAC;YAAEC,SAAS;YAAMC,MAAM3C,WAAW6B,MAAMe,WAAW,CAACD,IAAI;QAAE;QACrF,kDAAkD;QAClD,MAAME,iBAAiB,MAAMJ,MAAMK,KAAK,CAACC,MAAM,CAACC,IAAI,CAAC;YAAEC,QAAQ;QAAK;QACpE,MAAMC,YAAYL,eAAeM,IAAI,CAACJ,MAAM,IAAI,EAAE;QAClD,MAAMK,WAAW,IAAIC,IAAIH,UAAUI,GAAG,CAAC,CAACC,QAAU;gBAACA,MAAMrC,EAAE,IAAI;gBAAIqC;aAAM;QAEzE,2DAA2D;QAC3D,MAAMC,aAAsE,EAAE;QAE9E,IAAK,IAAIC,IAAI,GAAGA,IAAItB,aAAaF,MAAM,EAAEwB,KAAK3D,WAAY;YACxD,MAAM4D,QAAQvB,aAAawB,KAAK,CAACF,GAAGA,IAAI3D;YACxCgC,OAAOC,IAAI,CAAC,oBAAoB;gBAAE6B,YAAYH,IAAI3D,aAAa;gBAAG+D,WAAWH,MAAMzB,MAAM;gBAAE6B,aAAaC,KAAKC,IAAI,CAAC7B,aAAaF,MAAM,GAAGnC;YAAY;YAEpJ,MAAMmE,eAAe,MAAMC,QAAQC,UAAU,CAC3CT,MAAMJ,GAAG,CAAC,OAAOpC;gBACf,MAAMqC,QAAQH,SAASgB,GAAG,CAAClD;gBAE3B,wBAAwB;gBACxB,IAAI,CAACqC,OAAO;oBACV,MAAM,IAAIc,MAAM,CAAC,iBAAiB,EAAEnD,IAAI;gBAC1C;gBAEA,+BAA+B;gBAC/B,IAAIqC,MAAM5C,IAAI,KAAK,UAAU;oBAC3B,MAAM,IAAI0D,MAAM,CAAC,4BAA4B,EAAEd,MAAMe,IAAI,CAAC,EAAE,EAAEpD,GAAG,CAAC,CAAC;gBACrE;gBAEA,mBAAmB;gBACnB,MAAMuB,MAAMK,KAAK,CAACC,MAAM,CAACwB,MAAM,CAAC;oBAC9BtB,QAAQ;oBACR/B,IAAIA;gBACN;gBACA,OAAO;oBAAEA;oBAAIC,SAAS;gBAAK;YAC7B;YAGF,wBAAwB;YACxB,MAAMqD,wBAAwBP,aAAaX,GAAG,CAAC,CAAC3B,QAAQiC;gBACtD,MAAM1C,KAAKwC,KAAK,CAACE,WAAW;gBAC5B,IAAI,CAAC1C,IAAI;oBACP,MAAM,IAAImD,MAAM,CAAC,YAAY,EAAET,WAAW,oCAAoC,EAAEF,MAAMzB,MAAM,EAAE;gBAChG;gBACA,IAAIN,OAAO8C,MAAM,KAAK,aAAa;oBACjC,OAAO;wBAAEvD;wBAAIC,SAAS;oBAAK;gBAC7B;gBAEA,sCAAsC;gBACtC,IAAIuD,eAAe;gBACnB,IAAI/C,OAAOgD,MAAM,EAAE;oBACjB,IAAI,OAAOhD,OAAOgD,MAAM,KAAK,UAAU;wBACrCD,eAAe/C,OAAOgD,MAAM;oBAC9B,OAAO,IAAIhD,OAAOgD,MAAM,YAAYN,OAAO;wBACzCK,eAAe/C,OAAOgD,MAAM,CAACC,OAAO;oBACtC,OAAO,IAAIjD,OAAOgD,MAAM,IAAI,OAAOhD,OAAOgD,MAAM,KAAK,YAAY,aAAahD,OAAOgD,MAAM,EAAE;wBAC3FD,eAAeG,OAAOlD,OAAOgD,MAAM,CAACC,OAAO;oBAC7C,OAAO,IAAIjD,OAAOgD,MAAM,IAAI,OAAOhD,OAAOgD,MAAM,KAAK,YAAY,WAAWhD,OAAOgD,MAAM,EAAE;wBACzFD,eAAeG,OAAOlD,OAAOgD,MAAM,CAACtD,KAAK;oBAC3C,OAAO;wBACLqD,eAAeG,OAAOlD,OAAOgD,MAAM;oBACrC;gBACF;gBAEA,OAAO;oBAAEzD;oBAAIC,SAAS;oBAAOE,OAAOqD;gBAAa;YACnD;YAEAlB,WAAWlB,IAAI,IAAIkC;QACrB;QAEA,MAAMzD,eAAeyC,WAAWsB,MAAM,CAAC,CAACC,IAAMA,EAAE5D,OAAO,EAAEc,MAAM;QAC/D,MAAMjB,eAAewC,WAAWsB,MAAM,CAAC,CAACC,IAAM,CAACA,EAAE5D,OAAO,EAAEc,MAAM;QAEhEH,OAAOC,IAAI,CAAC,gCAAgC;YAC1ClB,gBAAgBsB,aAAaF,MAAM;YACnClB;YACAC;YACAgE,iBAAiBjB,KAAKC,IAAI,CAAC7B,aAAaF,MAAM,GAAGnC;QACnD;QAEA,MAAM6B,SAAiB;YACrBhB,MAAM;YACNE,gBAAgBsB,aAAaF,MAAM;YACnClB;YACAC;YACAC,SAASuC;QACX;QAEA,OAAO;YACLyB,SAAS;gBACP;oBACEtE,MAAM;oBACNuE,MAAMC,KAAKC,SAAS,CAACzD;gBACvB;aACD;YACD0D,mBAAmB;gBAAE1D;YAAO;QAC9B;IACF,EAAE,OAAON,OAAO;QACd,MAAMuD,UAAUvD,iBAAiBgD,QAAQhD,MAAMuD,OAAO,GAAGC,OAAOxD;QAChES,OAAOT,KAAK,CAAC,4BAA4B;YAAEA,OAAOuD;QAAQ;QAE1D,MAAM,IAAIlF,cAAcC,kBAAkB2F,aAAa,EAAE,CAAC,uBAAuB,EAAEV,SAAS,EAAE;YAC5FW,OAAOlE,iBAAiBgD,QAAQhD,MAAMkE,KAAK,GAAGC;QAChD;IACF;AACF;AAEA,eAAe,SAASC;IACtB,OAAO;QACLnB,MAAM;QACN7C;QACAG;IACF;AACF"}

package/dist/esm/mcp/tools/labels-list.d.ts

@@ -10,8 +10,8 @@ declare const outputSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         id: z.ZodString;
         name: z.ZodString;
         type: z.ZodEnum<{
-            user: "user";
             system: "system";
+            user: "user";
         }>;
         visibility: z.ZodEnum<{
             labelShow: "labelShow";
@@ -41,7 +41,7 @@ declare function handler(_: Input, extra: EnrichedExtra): Promise<{
             items: {
                 id: string;
                 name: string;
-                type: "user" | "system";
+                type: "system" | "user";
                 visibility: "labelShow" | "labelHide" | "labelShowIfUnread";
             }[];
         };
@@ -59,8 +59,8 @@ export default function createTool(): {
                     id: z.ZodString;
                     name: z.ZodString;
                     type: z.ZodEnum<{
-                        user: "user";
                         system: "system";
+                        user: "user";
                     }>;
                     visibility: z.ZodEnum<{
                         labelShow: "labelShow";

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

@@ -1,8 +1,9 @@
 import { schemas } from '@mcp-z/oauth-google';
 const { AuthRequiredBranchSchema } = schemas;
-import { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';
+import { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';
 import { google } from 'googleapis';
 import { z } from 'zod';
+import { googleAuth } from '../../lib/google-auth.js';
 // Schema for individual label items
 const LabelSchema = z.object({
     id: z.string().describe('Gmail label ID'),
@@ -41,7 +42,7 @@ async function handler(_, extra) {
     try {
         const gmail = google.gmail({
             version: 'v1',
-            auth: extra.authContext.auth
+            auth: googleAuth(extra.authContext.auth)
         });
         const started = Date.now();
         // Fetch all labels from Gmail API
@@ -110,7 +111,7 @@ async function handler(_, extra) {
         logger.error('gmail.labels.list error', {
             error: message
         });
-        throw new McpError(ErrorCode.InternalError, `Error listing labels: ${message}`, {
+        throw new ProtocolError(ProtocolErrorCode.InternalError, `Error listing labels: ${message}`, {
             stack: error instanceof Error ? error.stack : undefined
         });
     }

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

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-gmail/src/mcp/tools/labels-list.ts"],"sourcesContent":["import type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport { schemas } from '@mcp-z/oauth-google';\n\nconst { AuthRequiredBranchSchema } = schemas;\n\nimport type { ToolModule } from '@mcp-z/server';\nimport { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';\nimport { google } from 'googleapis';\nimport { z } from 'zod';\n\n// Schema for individual label items\nconst LabelSchema = z.object({\n  id: z.string().describe('Gmail label ID'),\n  name: z.string().describe('Label name for use in queries (case-sensitive)'),\n  type: z.enum(['user', 'system']).describe('Whether this is a user-created or system label'),\n  visibility: z.enum(['labelShow', 'labelHide', 'labelShowIfUnread']).describe('Label visibility in Gmail UI'),\n});\n\n/**\n * Input schema for the labels-list tool (currently empty as this tool takes no parameters).\n */\nexport const inputSchema = z.object({});\n\nconst successBranchSchema = z.object({\n  type: z.literal('success'),\n  items: z.array(LabelSchema),\n});\n\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n  description: 'List Gmail labels for label: query syntax. Case-sensitive.',\n  inputSchema: inputSchema,\n  outputSchema: z.object({\n    result: outputSchema,\n  }),\n} as const;\n\n/**\n * Input parameters for the labels-list tool.\n */\nexport type Input = z.infer<typeof inputSchema>;\nexport type Output = z.infer<typeof outputSchema>;\n\nasync function handler(_: Input, extra: EnrichedExtra) {\n  const logger = extra.logger;\n  logger.info('gmail.labels.list called');\n\n  try {\n    const gmail = google.gmail({ version: 'v1', auth: extra.authContext.auth });\n    const started = Date.now();\n\n    // Fetch all labels from Gmail API\n    const response = await gmail.users.labels.list({ userId: 'me' });\n    const labels = response.data.labels || [];\n\n    // Filter out CATEGORY_* labels (handled by categories tool) and map to our schema\n    const availableLabels = labels\n      .filter((label) => {\n        // Exclude CATEGORY_* labels as they're handled by the categories tool\n        return !label.id?.startsWith('CATEGORY_');\n      })\n      .map((label) => {\n        const id = label.id as string;\n        const name = label.name || id;\n\n        // Determine label type\n        const type: 'user' | 'system' = label.type === 'user' ? 'user' : 'system';\n\n        // Map label visibility\n        let visibility: 'labelShow' | 'labelHide' | 'labelShowIfUnread' = 'labelShow';\n        if (label.labelListVisibility === 'labelHide') {\n          visibility = 'labelHide';\n        } else if (label.labelListVisibility === 'labelShowIfUnread') {\n          visibility = 'labelShowIfUnread';\n        }\n\n        return {\n          id,\n          name,\n          type,\n          visibility,\n        };\n      })\n      .sort((a, b) => {\n        // Sort user labels first, then system labels, both alphabetically\n        if (a.type !== b.type) {\n          return a.type === 'user' ? -1 : 1;\n        }\n        // Use simple ASCII comparison for consistent, case-sensitive sorting\n        return a.name < b.name ? -1 : a.name > b.name ? 1 : 0;\n      });\n\n    const durationMs = Date.now() - started;\n\n    logger.info('gmail.labels.list results', {\n      labelCount: availableLabels.length,\n      userLabels: availableLabels.filter((l) => l.type === 'user').length,\n      systemLabels: availableLabels.filter((l) => l.type === 'system').length,\n      totalLabels: labels.length,\n    });\n    logger.info('gmail.labels.list metrics', { durationMs });\n\n    const result: Output = {\n      type: 'success' as const,\n      items: availableLabels,\n    };\n\n    return {\n      content: [\n        {\n          type: 'text' as const,\n          text: JSON.stringify(result),\n        },\n      ],\n      structuredContent: { result },\n    };\n  } catch (error) {\n    const message = error instanceof Error ? error.message : String(error);\n    logger.error('gmail.labels.list error', { error: message });\n\n    throw new McpError(ErrorCode.InternalError, `Error listing labels: ${message}`, {\n      stack: error instanceof Error ? error.stack : undefined,\n    });\n  }\n}\n\nexport default function createTool() {\n  return {\n    name: 'labels-list',\n    config,\n    handler,\n  } satisfies ToolModule;\n}\n"],"names":["schemas","AuthRequiredBranchSchema","ErrorCode","McpError","google","z","LabelSchema","object","id","string","describe","name","type","enum","visibility","inputSchema","successBranchSchema","literal","items","array","outputSchema","discriminatedUnion","config","description","result","handler","_","extra","logger","info","gmail","version","auth","authContext","started","Date","now","response","users","labels","list","userId","data","availableLabels","filter","label","startsWith","map","labelListVisibility","sort","a","b","durationMs","labelCount","length","userLabels","l","systemLabels","totalLabels","content","text","JSON","stringify","structuredContent","error","message","Error","String","InternalError","stack","undefined","createTool"],"mappings":"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"}
+{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-gmail/src/mcp/tools/labels-list.ts"],"sourcesContent":["import type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport { schemas } from '@mcp-z/oauth-google';\n\nconst { AuthRequiredBranchSchema } = schemas;\n\nimport type { ToolModule } from '@mcp-z/server';\nimport { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';\nimport { google } from 'googleapis';\nimport { z } from 'zod';\nimport { googleAuth } from '../../lib/google-auth.ts';\n\n// Schema for individual label items\nconst LabelSchema = z.object({\n  id: z.string().describe('Gmail label ID'),\n  name: z.string().describe('Label name for use in queries (case-sensitive)'),\n  type: z.enum(['user', 'system']).describe('Whether this is a user-created or system label'),\n  visibility: z.enum(['labelShow', 'labelHide', 'labelShowIfUnread']).describe('Label visibility in Gmail UI'),\n});\n\n/**\n * Input schema for the labels-list tool (currently empty as this tool takes no parameters).\n */\nexport const inputSchema = z.object({});\n\nconst successBranchSchema = z.object({\n  type: z.literal('success'),\n  items: z.array(LabelSchema),\n});\n\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n  description: 'List Gmail labels for label: query syntax. Case-sensitive.',\n  inputSchema: inputSchema,\n  outputSchema: z.object({\n    result: outputSchema,\n  }),\n} as const;\n\n/**\n * Input parameters for the labels-list tool.\n */\nexport type Input = z.infer<typeof inputSchema>;\nexport type Output = z.infer<typeof outputSchema>;\n\nasync function handler(_: Input, extra: EnrichedExtra) {\n  const logger = extra.logger;\n  logger.info('gmail.labels.list called');\n\n  try {\n    const gmail = google.gmail({ version: 'v1', auth: googleAuth(extra.authContext.auth) });\n    const started = Date.now();\n\n    // Fetch all labels from Gmail API\n    const response = await gmail.users.labels.list({ userId: 'me' });\n    const labels = response.data.labels || [];\n\n    // Filter out CATEGORY_* labels (handled by categories tool) and map to our schema\n    const availableLabels = labels\n      .filter((label) => {\n        // Exclude CATEGORY_* labels as they're handled by the categories tool\n        return !label.id?.startsWith('CATEGORY_');\n      })\n      .map((label) => {\n        const id = label.id as string;\n        const name = label.name || id;\n\n        // Determine label type\n        const type: 'user' | 'system' = label.type === 'user' ? 'user' : 'system';\n\n        // Map label visibility\n        let visibility: 'labelShow' | 'labelHide' | 'labelShowIfUnread' = 'labelShow';\n        if (label.labelListVisibility === 'labelHide') {\n          visibility = 'labelHide';\n        } else if (label.labelListVisibility === 'labelShowIfUnread') {\n          visibility = 'labelShowIfUnread';\n        }\n\n        return {\n          id,\n          name,\n          type,\n          visibility,\n        };\n      })\n      .sort((a, b) => {\n        // Sort user labels first, then system labels, both alphabetically\n        if (a.type !== b.type) {\n          return a.type === 'user' ? -1 : 1;\n        }\n        // Use simple ASCII comparison for consistent, case-sensitive sorting\n        return a.name < b.name ? -1 : a.name > b.name ? 1 : 0;\n      });\n\n    const durationMs = Date.now() - started;\n\n    logger.info('gmail.labels.list results', {\n      labelCount: availableLabels.length,\n      userLabels: availableLabels.filter((l) => l.type === 'user').length,\n      systemLabels: availableLabels.filter((l) => l.type === 'system').length,\n      totalLabels: labels.length,\n    });\n    logger.info('gmail.labels.list metrics', { durationMs });\n\n    const result: Output = {\n      type: 'success' as const,\n      items: availableLabels,\n    };\n\n    return {\n      content: [\n        {\n          type: 'text' as const,\n          text: JSON.stringify(result),\n        },\n      ],\n      structuredContent: { result },\n    };\n  } catch (error) {\n    const message = error instanceof Error ? error.message : String(error);\n    logger.error('gmail.labels.list error', { error: message });\n\n    throw new ProtocolError(ProtocolErrorCode.InternalError, `Error listing labels: ${message}`, {\n      stack: error instanceof Error ? error.stack : undefined,\n    });\n  }\n}\n\nexport default function createTool() {\n  return {\n    name: 'labels-list',\n    config,\n    handler,\n  } satisfies ToolModule;\n}\n"],"names":["schemas","AuthRequiredBranchSchema","ProtocolError","ProtocolErrorCode","google","z","googleAuth","LabelSchema","object","id","string","describe","name","type","enum","visibility","inputSchema","successBranchSchema","literal","items","array","outputSchema","discriminatedUnion","config","description","result","handler","_","extra","logger","info","gmail","version","auth","authContext","started","Date","now","response","users","labels","list","userId","data","availableLabels","filter","label","startsWith","map","labelListVisibility","sort","a","b","durationMs","labelCount","length","userLabels","l","systemLabels","totalLabels","content","text","JSON","stringify","structuredContent","error","message","Error","String","InternalError","stack","undefined","createTool"],"mappings":"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"}

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

@@ -1,12 +1,12 @@
 import { EMAIL_COMMON_PATTERNS, EMAIL_FIELD_DESCRIPTIONS, EMAIL_FIELDS, EmailContentTypeSchema, EmailDetailSchema, ExcludeThreadHistorySchema } from '@mcp-z/email';
 import { schemas } from '@mcp-z/oauth-google';
 const { AuthRequiredBranchSchema } = schemas;
-import { createFieldsSchema, filterFields, parseFields } from '@mcp-z/server';
-import { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';
+import { createFieldsSchema, filterFields, ProtocolError, ProtocolErrorCode, parseFields } from '@mcp-z/server';
 import { google } from 'googleapis';
 import { z } from 'zod';
 import { extractBodyFromPayload, extractEmails, extractFrom } from '../../email/parsing/message-extraction.js';
 import { toIsoUtc } from '../../lib/date-conversion.js';
+import { googleAuth } from '../../lib/google-auth.js';
 const inputSchema = z.object({
     id: z.coerce.string().trim().min(1).describe('Gmail message ID to retrieve'),
     fields: createFieldsSchema({
@@ -46,11 +46,11 @@ async function handler({ id, fields, contentType, excludeThreadHistory }, extra)
         var _fullData_id, _fullData_threadId, _headersMap_Subject, _fullData_snippet;
         var _fullData_payload;
         if (!id) {
-            throw new McpError(ErrorCode.InvalidParams, 'Missing id');
+            throw new ProtocolError(ProtocolErrorCode.InvalidParams, 'Missing id');
         }
         const gmail = google.gmail({
             version: 'v1',
-            auth: extra.authContext.auth
+            auth: googleAuth(extra.authContext.auth)
         });
         const response = await gmail.users.messages.get({
             userId: 'me',
@@ -67,7 +67,7 @@ async function handler({ id, fields, contentType, excludeThreadHistory }, extra)
         });
         const fullData = response.data;
         if (!fullData) {
-            throw new McpError(ErrorCode.InvalidRequest, 'Message not found');
+            throw new ProtocolError(ProtocolErrorCode.InvalidRequest, 'Message not found');
         }
         // Build full message data with type guards
         const headers = fullData === null || fullData === void 0 ? void 0 : (_fullData_payload = fullData.payload) === null || _fullData_payload === void 0 ? void 0 : _fullData_payload.headers;
@@ -131,7 +131,7 @@ async function handler({ id, fields, contentType, excludeThreadHistory }, extra)
         logger.error('gmail.message.get error', {
             error: message
         });
-        throw new McpError(ErrorCode.InternalError, `Error getting message: ${message}`, {
+        throw new ProtocolError(ProtocolErrorCode.InternalError, `Error getting message: ${message}`, {
             stack: error instanceof Error ? error.stack : undefined
         });
     }

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

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

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

@@ -1,8 +1,9 @@
 import { schemas } from '@mcp-z/oauth-google';
 const { AuthRequiredBranchSchema } = schemas;
-import { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';
+import { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';
 import { google } from 'googleapis';
 import { z } from 'zod';
+import { googleAuth } from '../../lib/google-auth.js';
 const inputSchema = z.object({
     id: z.coerce.string().trim().min(1).describe('Gmail message ID to mark as read')
 });
@@ -27,12 +28,12 @@ async function handler({ id }, extra) {
         id: Boolean(id)
     });
     if (!id) {
-        throw new McpError(ErrorCode.InvalidParams, 'Missing id');
+        throw new ProtocolError(ProtocolErrorCode.InvalidParams, 'Missing id');
     }
     try {
         const gmail = google.gmail({
             version: 'v1',
-            auth: extra.authContext.auth
+            auth: googleAuth(extra.authContext.auth)
         });
         await gmail.users.messages.modify({
             userId: 'me',
@@ -66,7 +67,7 @@ async function handler({ id }, extra) {
         logger.error('gmail-message-mark-read error', {
             error: message
         });
-        throw new McpError(ErrorCode.InternalError, `Error marking message as read: ${message}`, {
+        throw new ProtocolError(ProtocolErrorCode.InternalError, `Error marking message as read: ${message}`, {
             stack: error instanceof Error ? error.stack : undefined
         });
     }

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

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-gmail/src/mcp/tools/message-mark-read.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 { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';\nimport { google } from 'googleapis';\nimport { z } from 'zod';\n\nconst inputSchema = z.object({\n  id: z.coerce.string().trim().min(1).describe('Gmail message ID to mark as read'),\n});\n\nconst successBranchSchema = z.object({\n  type: z.literal('success'),\n  id: z.string().describe('Message ID that was marked as read'),\n});\n\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n  description: 'Mark a Gmail message as read',\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 }: Input, extra: EnrichedExtra) {\n  const logger = extra.logger;\n  logger.info('gmail-message-mark-read called', { id: Boolean(id) });\n\n  if (!id) {\n    throw new McpError(ErrorCode.InvalidParams, 'Missing id');\n  }\n\n  try {\n    const gmail = google.gmail({ version: 'v1', auth: extra.authContext.auth });\n    await gmail.users.messages.modify({\n      userId: 'me',\n      id: id,\n      requestBody: {\n        removeLabelIds: ['UNREAD'],\n      },\n    });\n\n    logger.info('gmail-message-mark-read success', { id });\n\n    const result: Output = {\n      type: 'success' as const,\n      id,\n    };\n\n    return {\n      content: [\n        {\n          type: 'text' as const,\n          text: JSON.stringify(result),\n        },\n      ],\n      structuredContent: { result },\n    };\n  } catch (error) {\n    const message = error instanceof Error ? error.message : String(error);\n    logger.error('gmail-message-mark-read error', { error: message });\n\n    throw new McpError(ErrorCode.InternalError, `Error marking message as read: ${message}`, {\n      stack: error instanceof Error ? error.stack : undefined,\n    });\n  }\n}\n\nexport default function createTool() {\n  return {\n    name: 'message-mark-read',\n    config,\n    handler,\n  } satisfies ToolModule;\n}\n"],"names":["schemas","AuthRequiredBranchSchema","ErrorCode","McpError","google","z","inputSchema","object","id","coerce","string","trim","min","describe","successBranchSchema","type","literal","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","info","Boolean","InvalidParams","gmail","version","auth","authContext","users","messages","modify","userId","requestBody","removeLabelIds","content","text","JSON","stringify","structuredContent","error","message","Error","String","InternalError","stack","undefined","createTool","name"],"mappings":"AACA,SAASA,OAAO,QAAQ,sBAAsB;AAE9C,MAAM,EAAEC,wBAAwB,EAAE,GAAGD;AAGrC,SAASE,SAAS,EAAEC,QAAQ,QAAQ,qCAAqC;AACzE,SAASC,MAAM,QAAQ,aAAa;AACpC,SAASC,CAAC,QAAQ,MAAM;AAExB,MAAMC,cAAcD,EAAEE,MAAM,CAAC;IAC3BC,IAAIH,EAAEI,MAAM,CAACC,MAAM,GAAGC,IAAI,GAAGC,GAAG,CAAC,GAAGC,QAAQ,CAAC;AAC/C;AAEA,MAAMC,sBAAsBT,EAAEE,MAAM,CAAC;IACnCQ,MAAMV,EAAEW,OAAO,CAAC;IAChBR,IAAIH,EAAEK,MAAM,GAAGG,QAAQ,CAAC;AAC1B;AAEA,MAAMI,eAAeZ,EAAEa,kBAAkB,CAAC,QAAQ;IAACJ;IAAqBb;CAAyB;AAEjG,MAAMkB,SAAS;IACbC,aAAa;IACbd,aAAaA;IACbW,cAAcZ,EAAEE,MAAM,CAAC;QACrBc,QAAQJ;IACV;AACF;AAKA,eAAeK,QAAQ,EAAEd,EAAE,EAAS,EAAEe,KAAoB;IACxD,MAAMC,SAASD,MAAMC,MAAM;IAC3BA,OAAOC,IAAI,CAAC,kCAAkC;QAAEjB,IAAIkB,QAAQlB;IAAI;IAEhE,IAAI,CAACA,IAAI;QACP,MAAM,IAAIL,SAASD,UAAUyB,aAAa,EAAE;IAC9C;IAEA,IAAI;QACF,MAAMC,QAAQxB,OAAOwB,KAAK,CAAC;YAAEC,SAAS;YAAMC,MAAMP,MAAMQ,WAAW,CAACD,IAAI;QAAC;QACzE,MAAMF,MAAMI,KAAK,CAACC,QAAQ,CAACC,MAAM,CAAC;YAChCC,QAAQ;YACR3B,IAAIA;YACJ4B,aAAa;gBACXC,gBAAgB;oBAAC;iBAAS;YAC5B;QACF;QAEAb,OAAOC,IAAI,CAAC,mCAAmC;YAAEjB;QAAG;QAEpD,MAAMa,SAAiB;YACrBN,MAAM;YACNP;QACF;QAEA,OAAO;YACL8B,SAAS;gBACP;oBACEvB,MAAM;oBACNwB,MAAMC,KAAKC,SAAS,CAACpB;gBACvB;aACD;YACDqB,mBAAmB;gBAAErB;YAAO;QAC9B;IACF,EAAE,OAAOsB,OAAO;QACd,MAAMC,UAAUD,iBAAiBE,QAAQF,MAAMC,OAAO,GAAGE,OAAOH;QAChEnB,OAAOmB,KAAK,CAAC,iCAAiC;YAAEA,OAAOC;QAAQ;QAE/D,MAAM,IAAIzC,SAASD,UAAU6C,aAAa,EAAE,CAAC,+BAA+B,EAAEH,SAAS,EAAE;YACvFI,OAAOL,iBAAiBE,QAAQF,MAAMK,KAAK,GAAGC;QAChD;IACF;AACF;AAEA,eAAe,SAASC;IACtB,OAAO;QACLC,MAAM;QACNhC;QACAG;IACF;AACF"}
+{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-gmail/src/mcp/tools/message-mark-read.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\nconst inputSchema = z.object({\n  id: z.coerce.string().trim().min(1).describe('Gmail message ID to mark as read'),\n});\n\nconst successBranchSchema = z.object({\n  type: z.literal('success'),\n  id: z.string().describe('Message ID that was marked as read'),\n});\n\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n  description: 'Mark a Gmail message as read',\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 }: Input, extra: EnrichedExtra) {\n  const logger = extra.logger;\n  logger.info('gmail-message-mark-read called', { id: Boolean(id) });\n\n  if (!id) {\n    throw new ProtocolError(ProtocolErrorCode.InvalidParams, 'Missing id');\n  }\n\n  try {\n    const gmail = google.gmail({ version: 'v1', auth: googleAuth(extra.authContext.auth) });\n    await gmail.users.messages.modify({\n      userId: 'me',\n      id: id,\n      requestBody: {\n        removeLabelIds: ['UNREAD'],\n      },\n    });\n\n    logger.info('gmail-message-mark-read success', { id });\n\n    const result: Output = {\n      type: 'success' as const,\n      id,\n    };\n\n    return {\n      content: [\n        {\n          type: 'text' as const,\n          text: JSON.stringify(result),\n        },\n      ],\n      structuredContent: { result },\n    };\n  } catch (error) {\n    const message = error instanceof Error ? error.message : String(error);\n    logger.error('gmail-message-mark-read error', { error: message });\n\n    throw new ProtocolError(ProtocolErrorCode.InternalError, `Error marking message as read: ${message}`, {\n      stack: error instanceof Error ? error.stack : undefined,\n    });\n  }\n}\n\nexport default function createTool() {\n  return {\n    name: 'message-mark-read',\n    config,\n    handler,\n  } satisfies ToolModule;\n}\n"],"names":["schemas","AuthRequiredBranchSchema","ProtocolError","ProtocolErrorCode","google","z","googleAuth","inputSchema","object","id","coerce","string","trim","min","describe","successBranchSchema","type","literal","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","info","Boolean","InvalidParams","gmail","version","auth","authContext","users","messages","modify","userId","requestBody","removeLabelIds","content","text","JSON","stringify","structuredContent","error","message","Error","String","InternalError","stack","undefined","createTool","name"],"mappings":"AACA,SAASA,OAAO,QAAQ,sBAAsB;AAE9C,MAAM,EAAEC,wBAAwB,EAAE,GAAGD;AAGrC,SAASE,aAAa,EAAEC,iBAAiB,QAAQ,gBAAgB;AACjE,SAASC,MAAM,QAAQ,aAAa;AACpC,SAASC,CAAC,QAAQ,MAAM;AACxB,SAASC,UAAU,QAAQ,2BAA2B;AAEtD,MAAMC,cAAcF,EAAEG,MAAM,CAAC;IAC3BC,IAAIJ,EAAEK,MAAM,CAACC,MAAM,GAAGC,IAAI,GAAGC,GAAG,CAAC,GAAGC,QAAQ,CAAC;AAC/C;AAEA,MAAMC,sBAAsBV,EAAEG,MAAM,CAAC;IACnCQ,MAAMX,EAAEY,OAAO,CAAC;IAChBR,IAAIJ,EAAEM,MAAM,GAAGG,QAAQ,CAAC;AAC1B;AAEA,MAAMI,eAAeb,EAAEc,kBAAkB,CAAC,QAAQ;IAACJ;IAAqBd;CAAyB;AAEjG,MAAMmB,SAAS;IACbC,aAAa;IACbd,aAAaA;IACbW,cAAcb,EAAEG,MAAM,CAAC;QACrBc,QAAQJ;IACV;AACF;AAKA,eAAeK,QAAQ,EAAEd,EAAE,EAAS,EAAEe,KAAoB;IACxD,MAAMC,SAASD,MAAMC,MAAM;IAC3BA,OAAOC,IAAI,CAAC,kCAAkC;QAAEjB,IAAIkB,QAAQlB;IAAI;IAEhE,IAAI,CAACA,IAAI;QACP,MAAM,IAAIP,cAAcC,kBAAkByB,aAAa,EAAE;IAC3D;IAEA,IAAI;QACF,MAAMC,QAAQzB,OAAOyB,KAAK,CAAC;YAAEC,SAAS;YAAMC,MAAMzB,WAAWkB,MAAMQ,WAAW,CAACD,IAAI;QAAE;QACrF,MAAMF,MAAMI,KAAK,CAACC,QAAQ,CAACC,MAAM,CAAC;YAChCC,QAAQ;YACR3B,IAAIA;YACJ4B,aAAa;gBACXC,gBAAgB;oBAAC;iBAAS;YAC5B;QACF;QAEAb,OAAOC,IAAI,CAAC,mCAAmC;YAAEjB;QAAG;QAEpD,MAAMa,SAAiB;YACrBN,MAAM;YACNP;QACF;QAEA,OAAO;YACL8B,SAAS;gBACP;oBACEvB,MAAM;oBACNwB,MAAMC,KAAKC,SAAS,CAACpB;gBACvB;aACD;YACDqB,mBAAmB;gBAAErB;YAAO;QAC9B;IACF,EAAE,OAAOsB,OAAO;QACd,MAAMC,UAAUD,iBAAiBE,QAAQF,MAAMC,OAAO,GAAGE,OAAOH;QAChEnB,OAAOmB,KAAK,CAAC,iCAAiC;YAAEA,OAAOC;QAAQ;QAE/D,MAAM,IAAI3C,cAAcC,kBAAkB6C,aAAa,EAAE,CAAC,+BAA+B,EAAEH,SAAS,EAAE;YACpGI,OAAOL,iBAAiBE,QAAQF,MAAMK,KAAK,GAAGC;QAChD;IACF;AACF;AAEA,eAAe,SAASC;IACtB,OAAO;QACLC,MAAM;QACNhC;QACAG;IACF;AACF"}