@mcp-z/mcp-gmail 1.0.0 → 1.0.1

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

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/Projects/ai/mcp-z/servers/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\nconst 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\nexport type Input = z.infer<typeof inputSchema>;\nexport type Output = z.infer<typeof outputSchema>;\n\nasync function handler(_args: 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","_args","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/Projects/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\nconst 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\nexport type Input = z.infer<typeof inputSchema>;\nexport type Output = z.infer<typeof outputSchema>;\n\nasync function handler(_args: 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","_args","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.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/Projects/ai/mcp-z/servers/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.js';\nimport { toIsoUtc } from '../../lib/date-conversion.js';\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/Projects/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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"}

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

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/Projects/ai/mcp-z/servers/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/Projects/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"}

package/dist/esm/mcp/tools/message-move-to-trash.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/Projects/ai/mcp-z/servers/mcp-gmail/src/mcp/tools/message-move-to-trash.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 message IDs to move to trash'),\n});\n\nconst successBranchSchema = z.object({\n  type: z.literal('success'),\n  totalRequested: z.number().describe('Total number of messages requested to trash'),\n  successCount: z.number().describe('Number of messages successfully moved to trash'),\n  failureCount: z.number().describe('Number of messages that failed to move'),\n  results: z\n    .array(\n      z.object({\n        id: z.string().describe('Message 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 message'),\n});\n\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n  description: 'Move Gmail messages to trash (recoverable).',\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-message-move-to-trash 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 message 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    // Process operations 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          await gmail.users.messages.trash({\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-message-move-to-trash 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-message-move-to-trash error', { error: message });\n\n    throw new McpError(ErrorCode.InternalError, `Error moving messages to trash: ${message}`, {\n      stack: error instanceof Error ? error.stack : undefined,\n    });\n  }\n}\n\nexport default function createTool() {\n  return {\n    name: 'message-move-to-trash',\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","allResults","i","chunk","slice","chunkIndex","chunkSize","totalChunks","Math","ceil","chunkResults","Promise","allSettled","map","users","messages","trash","userId","processedChunkResults","Error","status","errorMessage","reason","message","String","filter","r","chunksProcessed","content","text","JSON","stringify","structuredContent","InternalError","stack","undefined","createTool","name"],"mappings":"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"}
+{"version":3,"sources":["/Users/kevin/Dev/Projects/mcp-z/mcp-gmail/src/mcp/tools/message-move-to-trash.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 message IDs to move to trash'),\n});\n\nconst successBranchSchema = z.object({\n  type: z.literal('success'),\n  totalRequested: z.number().describe('Total number of messages requested to trash'),\n  successCount: z.number().describe('Number of messages successfully moved to trash'),\n  failureCount: z.number().describe('Number of messages that failed to move'),\n  results: z\n    .array(\n      z.object({\n        id: z.string().describe('Message 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 message'),\n});\n\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n  description: 'Move Gmail messages to trash (recoverable).',\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-message-move-to-trash 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 message 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    // Process operations 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          await gmail.users.messages.trash({\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-message-move-to-trash 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-message-move-to-trash error', { error: message });\n\n    throw new McpError(ErrorCode.InternalError, `Error moving messages to trash: ${message}`, {\n      stack: error instanceof Error ? error.stack : undefined,\n    });\n  }\n}\n\nexport default function createTool() {\n  return {\n    name: 'message-move-to-trash',\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","allResults","i","chunk","slice","chunkIndex","chunkSize","totalChunks","Math","ceil","chunkResults","Promise","allSettled","map","users","messages","trash","userId","processedChunkResults","Error","status","errorMessage","reason","message","String","filter","r","chunksProcessed","content","text","JSON","stringify","structuredContent","InternalError","stack","undefined","createTool","name"],"mappings":"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"}

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

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/Projects/ai/mcp-z/servers/mcp-gmail/src/mcp/tools/message-respond.ts"],"sourcesContent":["import { ComposeContentTypeSchema } 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 type { ToolModule } from '@mcp-z/server';\nimport { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';\nimport { google } from 'googleapis';\nimport { z } from 'zod';\nimport { extractEmails } from '../../email/parsing/headers-utils.js';\nimport { b64url } from '../../lib/base64-encoding.js';\n\nconst inputSchema = z.object({\n  id: z.coerce.string().trim().min(1).describe('Gmail message ID to reply to'),\n  body: z.coerce.string().trim().min(1).describe('Reply body content (plain text or HTML)'),\n  contentType: ComposeContentTypeSchema,\n});\n\nconst successBranchSchema = z.object({\n  type: z.literal('success'),\n  id: z.string().describe('Original message ID that was replied to'),\n});\n\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n  description: 'Send a reply 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, body, contentType }: Input, extra: EnrichedExtra) {\n  const logger = extra.logger;\n\n  if (!id || !body) {\n    throw new McpError(ErrorCode.InvalidParams, 'Missing id or body');\n  }\n\n  logger.info('gmail.message.respond called', { id, contentType });\n\n  try {\n    const gmail = google.gmail({ version: 'v1', auth: extra.authContext.auth });\n\n    let full: unknown;\n    try {\n      const response = await gmail.users.messages.get({\n        userId: 'me',\n        id: id,\n        format: 'metadata',\n        metadataHeaders: ['From', 'To', 'Reply-To', 'Subject', 'Message-ID', 'References', 'In-Reply-To', 'Date'],\n      });\n      full = response.data;\n    } catch (error) {\n      const message = error instanceof Error ? error.message : String(error);\n      logger.error('gmail.message.respond fetch error', { error: message });\n\n      throw new McpError(ErrorCode.InternalError, `Error fetching message metadata: ${message}`, {\n        stack: error instanceof Error ? error.stack : undefined,\n      });\n    }\n\n    // Type-safe header extraction\n    const fullData = full as { payload?: { headers?: unknown[] }; threadId?: unknown };\n    const headersArray = Array.isArray(fullData?.payload?.headers) ? fullData.payload.headers : [];\n    const headers = Object.fromEntries(\n      headersArray.map((h: unknown) => {\n        const header = h as { name?: unknown; value?: unknown };\n        return [String(header.name ?? ''), String(header.value ?? '')];\n      })\n    );\n    const fromHdr = headers.From || headers.from;\n    const replyToHdr = headers['Reply-To'] || headers['reply-to'];\n    const toAddr = (replyToHdr ? extractEmails(replyToHdr)[0] : extractEmails(fromHdr)[0]) ?? '';\n    const subject = (headers.Subject || headers.subject) ?? '';\n    const messageIdHeader = headers['Message-ID'] || headers['Message-Id'] || headers['message-id'];\n    const references = (headers.References || headers.references) ?? '';\n    const replySubject = /^re:/i.test(subject) ? subject : `Re: ${subject}`;\n    const inReplyTo = messageIdHeader?.startsWith('<') ? messageIdHeader : messageIdHeader ? `<${messageIdHeader}>` : undefined;\n    const refs = [references, inReplyTo].filter(Boolean).join(' ').trim();\n    const mimeType = contentType === 'html' ? 'text/html' : 'text/plain';\n    const lines = [`To: ${toAddr}`, `Subject: ${replySubject}`, `In-Reply-To: ${inReplyTo ?? ''}`, `References: ${refs}`, 'MIME-Version: 1.0', `Content-Type: ${mimeType}; charset=UTF-8`, '', body].join('\\r\\n');\n    const raw = b64url(lines);\n\n    // Prepare request body with conditional threadId for exactOptionalPropertyTypes\n    const threadId = fullData?.threadId ? String(fullData.threadId) : undefined;\n    await gmail.users.messages.send({\n      userId: 'me',\n      requestBody: {\n        raw: raw,\n        ...(threadId && { threadId }),\n      },\n    });\n\n    logger.info('gmail.message.respond sent reply', { 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.respond error', { error: message });\n\n    throw new McpError(ErrorCode.InternalError, `Error responding to message: ${message}`, {\n      stack: error instanceof Error ? error.stack : undefined,\n    });\n  }\n}\n\nexport default function createTool() {\n  return {\n    name: 'message-respond',\n    config,\n    handler,\n  } satisfies ToolModule;\n}\n"],"names":["ComposeContentTypeSchema","schemas","AuthRequiredBranchSchema","ErrorCode","McpError","google","z","extractEmails","b64url","inputSchema","object","id","coerce","string","trim","min","describe","body","contentType","successBranchSchema","type","literal","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","InvalidParams","info","replyToHdr","headers","fullData","gmail","version","auth","authContext","full","response","users","messages","get","userId","format","metadataHeaders","data","error","message","Error","String","InternalError","stack","undefined","headersArray","Array","isArray","payload","Object","fromEntries","map","h","header","name","value","fromHdr","From","from","toAddr","subject","Subject","messageIdHeader","references","References","replySubject","test","inReplyTo","startsWith","refs","filter","Boolean","join","mimeType","lines","raw","threadId","send","requestBody","content","text","JSON","stringify","structuredContent","createTool"],"mappings":"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"}
+{"version":3,"sources":["/Users/kevin/Dev/Projects/mcp-z/mcp-gmail/src/mcp/tools/message-respond.ts"],"sourcesContent":["import { ComposeContentTypeSchema } 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 type { ToolModule } from '@mcp-z/server';\nimport { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';\nimport { google } from 'googleapis';\nimport { z } from 'zod';\nimport { extractEmails } from '../../email/parsing/headers-utils.ts';\nimport { b64url } from '../../lib/base64-encoding.ts';\n\nconst inputSchema = z.object({\n  id: z.coerce.string().trim().min(1).describe('Gmail message ID to reply to'),\n  body: z.coerce.string().trim().min(1).describe('Reply body content (plain text or HTML)'),\n  contentType: ComposeContentTypeSchema,\n});\n\nconst successBranchSchema = z.object({\n  type: z.literal('success'),\n  id: z.string().describe('Original message ID that was replied to'),\n});\n\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n  description: 'Send a reply 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, body, contentType }: Input, extra: EnrichedExtra) {\n  const logger = extra.logger;\n\n  if (!id || !body) {\n    throw new McpError(ErrorCode.InvalidParams, 'Missing id or body');\n  }\n\n  logger.info('gmail.message.respond called', { id, contentType });\n\n  try {\n    const gmail = google.gmail({ version: 'v1', auth: extra.authContext.auth });\n\n    let full: unknown;\n    try {\n      const response = await gmail.users.messages.get({\n        userId: 'me',\n        id: id,\n        format: 'metadata',\n        metadataHeaders: ['From', 'To', 'Reply-To', 'Subject', 'Message-ID', 'References', 'In-Reply-To', 'Date'],\n      });\n      full = response.data;\n    } catch (error) {\n      const message = error instanceof Error ? error.message : String(error);\n      logger.error('gmail.message.respond fetch error', { error: message });\n\n      throw new McpError(ErrorCode.InternalError, `Error fetching message metadata: ${message}`, {\n        stack: error instanceof Error ? error.stack : undefined,\n      });\n    }\n\n    // Type-safe header extraction\n    const fullData = full as { payload?: { headers?: unknown[] }; threadId?: unknown };\n    const headersArray = Array.isArray(fullData?.payload?.headers) ? fullData.payload.headers : [];\n    const headers = Object.fromEntries(\n      headersArray.map((h: unknown) => {\n        const header = h as { name?: unknown; value?: unknown };\n        return [String(header.name ?? ''), String(header.value ?? '')];\n      })\n    );\n    const fromHdr = headers.From || headers.from;\n    const replyToHdr = headers['Reply-To'] || headers['reply-to'];\n    const toAddr = (replyToHdr ? extractEmails(replyToHdr)[0] : extractEmails(fromHdr)[0]) ?? '';\n    const subject = (headers.Subject || headers.subject) ?? '';\n    const messageIdHeader = headers['Message-ID'] || headers['Message-Id'] || headers['message-id'];\n    const references = (headers.References || headers.references) ?? '';\n    const replySubject = /^re:/i.test(subject) ? subject : `Re: ${subject}`;\n    const inReplyTo = messageIdHeader?.startsWith('<') ? messageIdHeader : messageIdHeader ? `<${messageIdHeader}>` : undefined;\n    const refs = [references, inReplyTo].filter(Boolean).join(' ').trim();\n    const mimeType = contentType === 'html' ? 'text/html' : 'text/plain';\n    const lines = [`To: ${toAddr}`, `Subject: ${replySubject}`, `In-Reply-To: ${inReplyTo ?? ''}`, `References: ${refs}`, 'MIME-Version: 1.0', `Content-Type: ${mimeType}; charset=UTF-8`, '', body].join('\\r\\n');\n    const raw = b64url(lines);\n\n    // Prepare request body with conditional threadId for exactOptionalPropertyTypes\n    const threadId = fullData?.threadId ? String(fullData.threadId) : undefined;\n    await gmail.users.messages.send({\n      userId: 'me',\n      requestBody: {\n        raw: raw,\n        ...(threadId && { threadId }),\n      },\n    });\n\n    logger.info('gmail.message.respond sent reply', { 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.respond error', { error: message });\n\n    throw new McpError(ErrorCode.InternalError, `Error responding to message: ${message}`, {\n      stack: error instanceof Error ? error.stack : undefined,\n    });\n  }\n}\n\nexport default function createTool() {\n  return {\n    name: 'message-respond',\n    config,\n    handler,\n  } satisfies ToolModule;\n}\n"],"names":["ComposeContentTypeSchema","schemas","AuthRequiredBranchSchema","ErrorCode","McpError","google","z","extractEmails","b64url","inputSchema","object","id","coerce","string","trim","min","describe","body","contentType","successBranchSchema","type","literal","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","InvalidParams","info","replyToHdr","headers","fullData","gmail","version","auth","authContext","full","response","users","messages","get","userId","format","metadataHeaders","data","error","message","Error","String","InternalError","stack","undefined","headersArray","Array","isArray","payload","Object","fromEntries","map","h","header","name","value","fromHdr","From","from","toAddr","subject","Subject","messageIdHeader","references","References","replySubject","test","inReplyTo","startsWith","refs","filter","Boolean","join","mimeType","lines","raw","threadId","send","requestBody","content","text","JSON","stringify","structuredContent","createTool"],"mappings":"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"}

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

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/Projects/ai/mcp-z/servers/mcp-gmail/src/mcp/tools/message-search.ts"],"sourcesContent":["import { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';\n/** Gmail message search using middleware-based auth pattern */\n\nimport { EMAIL_COMMON_PATTERNS, EMAIL_FIELD_DESCRIPTIONS, EMAIL_FIELDS, EmailContentTypeSchema, type EmailDetail, EmailDetailSchema, ExcludeThreadHistorySchema } from '@mcp-z/email';\nimport type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport { schemas } from '@mcp-z/oauth-google';\n\nconst { AuthRequiredBranchSchema } = schemas;\n\nimport { createFieldsSchema, createPaginationSchema, createShapeSchema, filterFields, parseFields, type ToolModule, toColumnarFormat } from '@mcp-z/server';\nimport { type gmail_v1, google } from 'googleapis';\nimport { z } from 'zod';\nimport { DEFAULT_PAGE_SIZE, MAX_PAGE_SIZE } from '../../constants.ts';\nimport { extractBodyFromPayload } from '../../email/parsing/html-processing.js';\nimport { executeQuery as executeGmailQuery } from '../../email/querying/execute-query.js';\nimport { GmailQuerySchema } from '../../schemas/gmail-query-schema.js';\n\nconst inputSchema = z.object({\n  query: GmailQuerySchema.optional().describe('Structured query object for filtering messages. Use query-syntax prompt for reference.'),\n  fields: createFieldsSchema({\n    availableFields: EMAIL_FIELDS,\n    fieldDescriptions: EMAIL_FIELD_DESCRIPTIONS,\n    commonPatterns: EMAIL_COMMON_PATTERNS,\n    resourceName: 'email message',\n  }),\n  ...createPaginationSchema({ defaultPageSize: DEFAULT_PAGE_SIZE, maxPageSize: MAX_PAGE_SIZE, provider: 'gmail' }).shape,\n  shape: createShapeSchema(),\n  contentType: EmailContentTypeSchema,\n  excludeThreadHistory: ExcludeThreadHistorySchema,\n});\n\n// Success branch schemas for different shapes\nconst successObjectsBranchSchema = z.object({\n  type: z.literal('success'),\n  shape: z.literal('objects'),\n  items: z.array(EmailDetailSchema).describe('Matching email messages'),\n  nextPageToken: z.string().optional().describe('Token for fetching next page of results'),\n});\n\nconst successArraysBranchSchema = z.object({\n  type: z.literal('success'),\n  shape: z.literal('arrays'),\n  columns: z.array(z.string()).describe('Column names in canonical order'),\n  rows: z.array(z.array(z.unknown())).describe('Row data matching column order'),\n  nextPageToken: z.string().optional().describe('Token for fetching next page of results'),\n});\n\n// Output schema with auth_required support\n// Using z.union instead of discriminatedUnion since we have two success branches with different shapes\nconst outputSchema = z.union([successObjectsBranchSchema, successArraysBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n  description: 'Search Gmail messages using structured query objects 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({ query, pageSize = DEFAULT_PAGE_SIZE, pageToken, fields, shape = 'arrays', contentType = 'text', excludeThreadHistory = false }: Input, extra: EnrichedExtra) {\n  const logger = extra.logger;\n\n  const requestedFields = parseFields(fields, EMAIL_FIELDS);\n  const includeBody = requestedFields === 'all' || requestedFields.has('body');\n\n  logger.info('gmail.message.search called', {\n    query,\n    pageSize,\n    pageToken: pageToken ? '[provided]' : undefined,\n    fields,\n    includeBody,\n    accountId: extra.authContext.accountId, // Available from middleware\n  });\n\n  try {\n    const gmail = google.gmail({ version: 'v1', auth: extra.authContext.auth });\n\n    const started = Date.now();\n\n    const exec = await executeGmailQuery(\n      query,\n      {\n        client: gmail,\n        logger,\n        pageSize,\n        ...(pageToken !== undefined && { pageToken }),\n        includeBody,\n      },\n      (full: unknown) => {\n        // Type-safe property access with guards\n        const fullData = full as gmail_v1.Schema$Message;\n\n        const headersArray = Array.isArray(fullData?.payload?.headers) ? fullData.payload.headers : [];\n        const headers = Object.fromEntries(\n          headersArray.map((h: unknown) => {\n            const header = h as gmail_v1.Schema$MessagePartHeader;\n            return [String(header.name ?? ''), String(header.value ?? '')];\n          })\n        );\n\n        const mapped: Partial<EmailDetail> = {\n          id: String(fullData?.id ?? ''),\n          threadId: fullData?.threadId ? String(fullData.threadId) : undefined,\n          from: headers?.From,\n          to: headers?.To,\n          subject: headers?.Subject,\n          date: headers?.Date,\n          snippet: fullData?.snippet ? String(fullData.snippet) : undefined,\n        };\n\n        if (includeBody) {\n          const payload = fullData?.payload;\n          // Cast to Schema$MessagePart for extractBodyFromPayload\n          const body = payload ? extractBodyFromPayload(payload as gmail_v1.Schema$MessagePart, { contentType, excludeThreadHistory }) : '';\n          if (body) {\n            mapped.body = body;\n            mapped.bodyContentType = contentType;\n          }\n        }\n        return mapped;\n      }\n    );\n\n    const items = exec.items;\n    const metadata = exec.metadata;\n    const durationMs = Date.now() - started;\n\n    // Type-safe field filtering\n    const filteredItems = items.map((item) => filterFields(item, requestedFields));\n\n    logger.info('gmail.message.search results', { query, pageSize, resultCount: filteredItems.length, fields: fields || 'all' });\n    logger.info('gmail.message.search metrics', { durationMs, metadata });\n\n    // Type-safe metadata access\n    const metadataObj = metadata as { nextPageToken?: string } | undefined;\n\n    // Build result based on shape\n    const result: Output =\n      shape === 'arrays'\n        ? {\n            type: 'success' as const,\n            shape: 'arrays' as const,\n            ...toColumnarFormat(filteredItems, requestedFields, EMAIL_FIELDS),\n            ...(metadataObj?.nextPageToken && { nextPageToken: metadataObj.nextPageToken }),\n          }\n        : {\n            type: 'success' as const,\n            shape: 'objects' as const,\n            items: filteredItems,\n            ...(metadataObj?.nextPageToken && { nextPageToken: metadataObj.nextPageToken }),\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.search error', { error: message });\n\n    throw new McpError(ErrorCode.InternalError, `Error searching messages: ${message}`, {\n      stack: error instanceof Error ? error.stack : undefined,\n    });\n  }\n}\n\nexport default function createTool() {\n  return {\n    name: 'message-search',\n    config,\n    handler,\n  } satisfies ToolModule;\n}\n"],"names":["ErrorCode","McpError","EMAIL_COMMON_PATTERNS","EMAIL_FIELD_DESCRIPTIONS","EMAIL_FIELDS","EmailContentTypeSchema","EmailDetailSchema","ExcludeThreadHistorySchema","schemas","AuthRequiredBranchSchema","createFieldsSchema","createPaginationSchema","createShapeSchema","filterFields","parseFields","toColumnarFormat","google","z","DEFAULT_PAGE_SIZE","MAX_PAGE_SIZE","extractBodyFromPayload","executeQuery","executeGmailQuery","GmailQuerySchema","inputSchema","object","query","optional","describe","fields","availableFields","fieldDescriptions","commonPatterns","resourceName","defaultPageSize","maxPageSize","provider","shape","contentType","excludeThreadHistory","successObjectsBranchSchema","type","literal","items","array","nextPageToken","string","successArraysBranchSchema","columns","rows","unknown","outputSchema","union","config","description","result","handler","pageSize","pageToken","extra","logger","requestedFields","includeBody","has","info","undefined","accountId","authContext","gmail","version","auth","started","Date","now","exec","client","full","fullData","headersArray","Array","isArray","payload","headers","Object","fromEntries","map","h","header","String","name","value","mapped","id","threadId","from","From","to","To","subject","Subject","date","snippet","body","bodyContentType","metadata","durationMs","filteredItems","item","resultCount","length","metadataObj","content","text","JSON","stringify","structuredContent","error","message","Error","InternalError","stack","createTool"],"mappings":"AAAA,SAASA,SAAS,EAAEC,QAAQ,QAAQ,qCAAqC;AACzE,6DAA6D,GAE7D,SAASC,qBAAqB,EAAEC,wBAAwB,EAAEC,YAAY,EAAEC,sBAAsB,EAAoBC,iBAAiB,EAAEC,0BAA0B,QAAQ,eAAe;AAEtL,SAASC,OAAO,QAAQ,sBAAsB;AAE9C,MAAM,EAAEC,wBAAwB,EAAE,GAAGD;AAErC,SAASE,kBAAkB,EAAEC,sBAAsB,EAAEC,iBAAiB,EAAEC,YAAY,EAAEC,WAAW,EAAmBC,gBAAgB,QAAQ,gBAAgB;AAC5J,SAAwBC,MAAM,QAAQ,aAAa;AACnD,SAASC,CAAC,QAAQ,MAAM;AACxB,SAASC,iBAAiB,EAAEC,aAAa,QAAQ,qBAAqB;AACtE,SAASC,sBAAsB,QAAQ,yCAAyC;AAChF,SAASC,gBAAgBC,iBAAiB,QAAQ,wCAAwC;AAC1F,SAASC,gBAAgB,QAAQ,sCAAsC;AAEvE,MAAMC,cAAcP,EAAEQ,MAAM,CAAC;IAC3BC,OAAOH,iBAAiBI,QAAQ,GAAGC,QAAQ,CAAC;IAC5CC,QAAQnB,mBAAmB;QACzBoB,iBAAiB1B;QACjB2B,mBAAmB5B;QACnB6B,gBAAgB9B;QAChB+B,cAAc;IAChB;IACA,GAAGtB,uBAAuB;QAAEuB,iBAAiBhB;QAAmBiB,aAAahB;QAAeiB,UAAU;IAAQ,GAAGC,KAAK;IACtHA,OAAOzB;IACP0B,aAAajC;IACbkC,sBAAsBhC;AACxB;AAEA,8CAA8C;AAC9C,MAAMiC,6BAA6BvB,EAAEQ,MAAM,CAAC;IAC1CgB,MAAMxB,EAAEyB,OAAO,CAAC;IAChBL,OAAOpB,EAAEyB,OAAO,CAAC;IACjBC,OAAO1B,EAAE2B,KAAK,CAACtC,mBAAmBsB,QAAQ,CAAC;IAC3CiB,eAAe5B,EAAE6B,MAAM,GAAGnB,QAAQ,GAAGC,QAAQ,CAAC;AAChD;AAEA,MAAMmB,4BAA4B9B,EAAEQ,MAAM,CAAC;IACzCgB,MAAMxB,EAAEyB,OAAO,CAAC;IAChBL,OAAOpB,EAAEyB,OAAO,CAAC;IACjBM,SAAS/B,EAAE2B,KAAK,CAAC3B,EAAE6B,MAAM,IAAIlB,QAAQ,CAAC;IACtCqB,MAAMhC,EAAE2B,KAAK,CAAC3B,EAAE2B,KAAK,CAAC3B,EAAEiC,OAAO,KAAKtB,QAAQ,CAAC;IAC7CiB,eAAe5B,EAAE6B,MAAM,GAAGnB,QAAQ,GAAGC,QAAQ,CAAC;AAChD;AAEA,2CAA2C;AAC3C,uGAAuG;AACvG,MAAMuB,eAAelC,EAAEmC,KAAK,CAAC;IAACZ;IAA4BO;IAA2BtC;CAAyB;AAE9G,MAAM4C,SAAS;IACbC,aAAa;IACb9B,aAAaA;IACb2B,cAAclC,EAAEQ,MAAM,CAAC;QACrB8B,QAAQJ;IACV;AACF;AAKA,eAAeK,QAAQ,EAAE9B,KAAK,EAAE+B,WAAWvC,iBAAiB,EAAEwC,SAAS,EAAE7B,MAAM,EAAEQ,QAAQ,QAAQ,EAAEC,cAAc,MAAM,EAAEC,uBAAuB,KAAK,EAAS,EAAEoB,KAAoB;IAClL,MAAMC,SAASD,MAAMC,MAAM;IAE3B,MAAMC,kBAAkB/C,YAAYe,QAAQzB;IAC5C,MAAM0D,cAAcD,oBAAoB,SAASA,gBAAgBE,GAAG,CAAC;IAErEH,OAAOI,IAAI,CAAC,+BAA+B;QACzCtC;QACA+B;QACAC,WAAWA,YAAY,eAAeO;QACtCpC;QACAiC;QACAI,WAAWP,MAAMQ,WAAW,CAACD,SAAS;IACxC;IAEA,IAAI;QACF,MAAME,QAAQpD,OAAOoD,KAAK,CAAC;YAAEC,SAAS;YAAMC,MAAMX,MAAMQ,WAAW,CAACG,IAAI;QAAC;QAEzE,MAAMC,UAAUC,KAAKC,GAAG;QAExB,MAAMC,OAAO,MAAMpD,kBACjBI,OACA;YACEiD,QAAQP;YACRR;YACAH;YACA,GAAIC,cAAcO,aAAa;gBAAEP;YAAU,CAAC;YAC5CI;QACF,GACA,CAACc;;gBAIoCC;YAHnC,wCAAwC;YACxC,MAAMA,WAAWD;YAEjB,MAAME,eAAeC,MAAMC,OAAO,CAACH,qBAAAA,gCAAAA,oBAAAA,SAAUI,OAAO,cAAjBJ,wCAAAA,kBAAmBK,OAAO,IAAIL,SAASI,OAAO,CAACC,OAAO,GAAG,EAAE;YAC9F,MAAMA,UAAUC,OAAOC,WAAW,CAChCN,aAAaO,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,SAA+B;gBACnCC,IAAIJ,eAAOX,qBAAAA,+BAAAA,SAAUe,EAAE,uCAAI;gBAC3BC,UAAUhB,CAAAA,qBAAAA,+BAAAA,SAAUgB,QAAQ,IAAGL,OAAOX,SAASgB,QAAQ,IAAI5B;gBAC3D6B,IAAI,EAAEZ,oBAAAA,8BAAAA,QAASa,IAAI;gBACnBC,EAAE,EAAEd,oBAAAA,8BAAAA,QAASe,EAAE;gBACfC,OAAO,EAAEhB,oBAAAA,8BAAAA,QAASiB,OAAO;gBACzBC,IAAI,EAAElB,oBAAAA,8BAAAA,QAASV,IAAI;gBACnB6B,SAASxB,CAAAA,qBAAAA,+BAAAA,SAAUwB,OAAO,IAAGb,OAAOX,SAASwB,OAAO,IAAIpC;YAC1D;YAEA,IAAIH,aAAa;gBACf,MAAMmB,UAAUJ,qBAAAA,+BAAAA,SAAUI,OAAO;gBACjC,wDAAwD;gBACxD,MAAMqB,OAAOrB,UAAU7D,uBAAuB6D,SAAwC;oBAAE3C;oBAAaC;gBAAqB,KAAK;gBAC/H,IAAI+D,MAAM;oBACRX,OAAOW,IAAI,GAAGA;oBACdX,OAAOY,eAAe,GAAGjE;gBAC3B;YACF;YACA,OAAOqD;QACT;QAGF,MAAMhD,QAAQ+B,KAAK/B,KAAK;QACxB,MAAM6D,WAAW9B,KAAK8B,QAAQ;QAC9B,MAAMC,aAAajC,KAAKC,GAAG,KAAKF;QAEhC,4BAA4B;QAC5B,MAAMmC,gBAAgB/D,MAAM0C,GAAG,CAAC,CAACsB,OAAS9F,aAAa8F,MAAM9C;QAE7DD,OAAOI,IAAI,CAAC,gCAAgC;YAAEtC;YAAO+B;YAAUmD,aAAaF,cAAcG,MAAM;YAAEhF,QAAQA,UAAU;QAAM;QAC1H+B,OAAOI,IAAI,CAAC,gCAAgC;YAAEyC;YAAYD;QAAS;QAEnE,4BAA4B;QAC5B,MAAMM,cAAcN;QAEpB,8BAA8B;QAC9B,MAAMjD,SACJlB,UAAU,WACN;YACEI,MAAM;YACNJ,OAAO;YACP,GAAGtB,iBAAiB2F,eAAe7C,iBAAiBzD,aAAa;YACjE,GAAI0G,CAAAA,wBAAAA,kCAAAA,YAAajE,aAAa,KAAI;gBAAEA,eAAeiE,YAAYjE,aAAa;YAAC,CAAC;QAChF,IACA;YACEJ,MAAM;YACNJ,OAAO;YACPM,OAAO+D;YACP,GAAII,CAAAA,wBAAAA,kCAAAA,YAAajE,aAAa,KAAI;gBAAEA,eAAeiE,YAAYjE,aAAa;YAAC,CAAC;QAChF;QAEN,OAAO;YACLkE,SAAS;gBACP;oBACEtE,MAAM;oBACNuE,MAAMC,KAAKC,SAAS,CAAC3D;gBACvB;aACD;YACD4D,mBAAmB;gBAAE5D;YAAO;QAC9B;IACF,EAAE,OAAO6D,OAAO;QACd,MAAMC,UAAUD,iBAAiBE,QAAQF,MAAMC,OAAO,GAAG7B,OAAO4B;QAChExD,OAAOwD,KAAK,CAAC,8BAA8B;YAAEA,OAAOC;QAAQ;QAE5D,MAAM,IAAIpH,SAASD,UAAUuH,aAAa,EAAE,CAAC,0BAA0B,EAAEF,SAAS,EAAE;YAClFG,OAAOJ,iBAAiBE,QAAQF,MAAMI,KAAK,GAAGvD;QAChD;IACF;AACF;AAEA,eAAe,SAASwD;IACtB,OAAO;QACLhC,MAAM;QACNpC;QACAG;IACF;AACF"}
+{"version":3,"sources":["/Users/kevin/Dev/Projects/mcp-z/mcp-gmail/src/mcp/tools/message-search.ts"],"sourcesContent":["import { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';\n/** Gmail message search using middleware-based auth pattern */\n\nimport { EMAIL_COMMON_PATTERNS, EMAIL_FIELD_DESCRIPTIONS, EMAIL_FIELDS, EmailContentTypeSchema, type EmailDetail, EmailDetailSchema, ExcludeThreadHistorySchema } from '@mcp-z/email';\nimport type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport { schemas } from '@mcp-z/oauth-google';\n\nconst { AuthRequiredBranchSchema } = schemas;\n\nimport { createFieldsSchema, createPaginationSchema, createShapeSchema, filterFields, parseFields, type ToolModule, toColumnarFormat } from '@mcp-z/server';\nimport { type gmail_v1, google } from 'googleapis';\nimport { z } from 'zod';\nimport { DEFAULT_PAGE_SIZE, MAX_PAGE_SIZE } from '../../constants.ts';\nimport { extractBodyFromPayload } from '../../email/parsing/html-processing.ts';\nimport { executeQuery as executeGmailQuery } from '../../email/querying/execute-query.ts';\nimport { GmailQuerySchema } from '../../schemas/gmail-query-schema.ts';\n\nconst inputSchema = z.object({\n  query: GmailQuerySchema.optional().describe('Structured query object for filtering messages. Use query-syntax prompt for reference.'),\n  fields: createFieldsSchema({\n    availableFields: EMAIL_FIELDS,\n    fieldDescriptions: EMAIL_FIELD_DESCRIPTIONS,\n    commonPatterns: EMAIL_COMMON_PATTERNS,\n    resourceName: 'email message',\n  }),\n  ...createPaginationSchema({ defaultPageSize: DEFAULT_PAGE_SIZE, maxPageSize: MAX_PAGE_SIZE, provider: 'gmail' }).shape,\n  shape: createShapeSchema(),\n  contentType: EmailContentTypeSchema,\n  excludeThreadHistory: ExcludeThreadHistorySchema,\n});\n\n// Success branch schemas for different shapes\nconst successObjectsBranchSchema = z.object({\n  type: z.literal('success'),\n  shape: z.literal('objects'),\n  items: z.array(EmailDetailSchema).describe('Matching email messages'),\n  nextPageToken: z.string().optional().describe('Token for fetching next page of results'),\n});\n\nconst successArraysBranchSchema = z.object({\n  type: z.literal('success'),\n  shape: z.literal('arrays'),\n  columns: z.array(z.string()).describe('Column names in canonical order'),\n  rows: z.array(z.array(z.unknown())).describe('Row data matching column order'),\n  nextPageToken: z.string().optional().describe('Token for fetching next page of results'),\n});\n\n// Output schema with auth_required support\n// Using z.union instead of discriminatedUnion since we have two success branches with different shapes\nconst outputSchema = z.union([successObjectsBranchSchema, successArraysBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n  description: 'Search Gmail messages using structured query objects 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({ query, pageSize = DEFAULT_PAGE_SIZE, pageToken, fields, shape = 'arrays', contentType = 'text', excludeThreadHistory = false }: Input, extra: EnrichedExtra) {\n  const logger = extra.logger;\n\n  const requestedFields = parseFields(fields, EMAIL_FIELDS);\n  const includeBody = requestedFields === 'all' || requestedFields.has('body');\n\n  logger.info('gmail.message.search called', {\n    query,\n    pageSize,\n    pageToken: pageToken ? '[provided]' : undefined,\n    fields,\n    includeBody,\n    accountId: extra.authContext.accountId, // Available from middleware\n  });\n\n  try {\n    const gmail = google.gmail({ version: 'v1', auth: extra.authContext.auth });\n\n    const started = Date.now();\n\n    const exec = await executeGmailQuery(\n      query,\n      {\n        client: gmail,\n        logger,\n        pageSize,\n        ...(pageToken !== undefined && { pageToken }),\n        includeBody,\n      },\n      (full: unknown) => {\n        // Type-safe property access with guards\n        const fullData = full as gmail_v1.Schema$Message;\n\n        const headersArray = Array.isArray(fullData?.payload?.headers) ? fullData.payload.headers : [];\n        const headers = Object.fromEntries(\n          headersArray.map((h: unknown) => {\n            const header = h as gmail_v1.Schema$MessagePartHeader;\n            return [String(header.name ?? ''), String(header.value ?? '')];\n          })\n        );\n\n        const mapped: Partial<EmailDetail> = {\n          id: String(fullData?.id ?? ''),\n          threadId: fullData?.threadId ? String(fullData.threadId) : undefined,\n          from: headers?.From,\n          to: headers?.To,\n          subject: headers?.Subject,\n          date: headers?.Date,\n          snippet: fullData?.snippet ? String(fullData.snippet) : undefined,\n        };\n\n        if (includeBody) {\n          const payload = fullData?.payload;\n          // Cast to Schema$MessagePart for extractBodyFromPayload\n          const body = payload ? extractBodyFromPayload(payload as gmail_v1.Schema$MessagePart, { contentType, excludeThreadHistory }) : '';\n          if (body) {\n            mapped.body = body;\n            mapped.bodyContentType = contentType;\n          }\n        }\n        return mapped;\n      }\n    );\n\n    const items = exec.items;\n    const metadata = exec.metadata;\n    const durationMs = Date.now() - started;\n\n    // Type-safe field filtering\n    const filteredItems = items.map((item) => filterFields(item, requestedFields));\n\n    logger.info('gmail.message.search results', { query, pageSize, resultCount: filteredItems.length, fields: fields || 'all' });\n    logger.info('gmail.message.search metrics', { durationMs, metadata });\n\n    // Type-safe metadata access\n    const metadataObj = metadata as { nextPageToken?: string } | undefined;\n\n    // Build result based on shape\n    const result: Output =\n      shape === 'arrays'\n        ? {\n            type: 'success' as const,\n            shape: 'arrays' as const,\n            ...toColumnarFormat(filteredItems, requestedFields, EMAIL_FIELDS),\n            ...(metadataObj?.nextPageToken && { nextPageToken: metadataObj.nextPageToken }),\n          }\n        : {\n            type: 'success' as const,\n            shape: 'objects' as const,\n            items: filteredItems,\n            ...(metadataObj?.nextPageToken && { nextPageToken: metadataObj.nextPageToken }),\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.search error', { error: message });\n\n    throw new McpError(ErrorCode.InternalError, `Error searching messages: ${message}`, {\n      stack: error instanceof Error ? error.stack : undefined,\n    });\n  }\n}\n\nexport default function createTool() {\n  return {\n    name: 'message-search',\n    config,\n    handler,\n  } satisfies ToolModule;\n}\n"],"names":["ErrorCode","McpError","EMAIL_COMMON_PATTERNS","EMAIL_FIELD_DESCRIPTIONS","EMAIL_FIELDS","EmailContentTypeSchema","EmailDetailSchema","ExcludeThreadHistorySchema","schemas","AuthRequiredBranchSchema","createFieldsSchema","createPaginationSchema","createShapeSchema","filterFields","parseFields","toColumnarFormat","google","z","DEFAULT_PAGE_SIZE","MAX_PAGE_SIZE","extractBodyFromPayload","executeQuery","executeGmailQuery","GmailQuerySchema","inputSchema","object","query","optional","describe","fields","availableFields","fieldDescriptions","commonPatterns","resourceName","defaultPageSize","maxPageSize","provider","shape","contentType","excludeThreadHistory","successObjectsBranchSchema","type","literal","items","array","nextPageToken","string","successArraysBranchSchema","columns","rows","unknown","outputSchema","union","config","description","result","handler","pageSize","pageToken","extra","logger","requestedFields","includeBody","has","info","undefined","accountId","authContext","gmail","version","auth","started","Date","now","exec","client","full","fullData","headersArray","Array","isArray","payload","headers","Object","fromEntries","map","h","header","String","name","value","mapped","id","threadId","from","From","to","To","subject","Subject","date","snippet","body","bodyContentType","metadata","durationMs","filteredItems","item","resultCount","length","metadataObj","content","text","JSON","stringify","structuredContent","error","message","Error","InternalError","stack","createTool"],"mappings":"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"}

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

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/Projects/ai/mcp-z/servers/mcp-gmail/src/mcp/tools/message-send.ts"],"sourcesContent":["import { ComposeContentTypeSchema, createEmailRecipientsSchema, createMessageResultSchema } 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 type { ToolModule } from '@mcp-z/server';\nimport { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';\nimport { google } from 'googleapis';\nimport { z } from 'zod';\nimport { buildRfc822FromArgs } from '../../email/composition/rfc822-builder.js';\nimport { b64url } from '../../lib/base64-encoding.js';\n\nconst inputSchema = z.object({\n  to: createEmailRecipientsSchema('to', true),\n  cc: createEmailRecipientsSchema('cc', false),\n  bcc: createEmailRecipientsSchema('bcc', false),\n  subject: z.string().describe('Message subject').default(''),\n  body: z.string().trim().min(1).describe('Email body content (plain text or HTML)'),\n  contentType: ComposeContentTypeSchema,\n});\n\n// Success branch schema\nconst successBranchSchema = z.object({\n  type: z.literal('success'),\n  item: createMessageResultSchema('gmail'),\n});\n\n// Output schema with auth_required support\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n  description: 'Send an email message through Gmail',\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(params: Input, extra: EnrichedExtra) {\n  const { to, cc, bcc, subject, body, contentType } = params;\n  const logger = extra.logger;\n  logger.info('gmail.message.send called', { to, subject, contentType });\n\n  if (!to) {\n    throw new McpError(ErrorCode.InvalidParams, 'Missing required field: to');\n  }\n\n  try {\n    // Build RFC822 message - only include optional headers when defined to satisfy\n    // exactOptionalPropertyTypes (avoid passing `undefined` into optional props)\n    const msgArgs: { to: string; cc?: string; bcc?: string; subject?: string; body: string; contentType: 'text' | 'html' } = { to, body, contentType };\n    if (cc !== undefined) msgArgs.cc = cc;\n    if (bcc !== undefined) msgArgs.bcc = bcc;\n    if (subject !== undefined) msgArgs.subject = subject;\n\n    const raw = buildRfc822FromArgs(msgArgs);\n    const encodedMessage = b64url(raw);\n\n    const gmail = google.gmail({ version: 'v1', auth: extra.authContext.auth });\n\n    const sendRes = await gmail.users.messages.send({\n      userId: 'me',\n      requestBody: { raw: encodedMessage },\n    });\n    const sendData = sendRes.data;\n    const messageId = sendData.id || 'unknown';\n    logger.info('Gmail: sent message successfully', { id: messageId });\n    logger.info('gmail.message.send result (typed)', { to, subject, messageId });\n\n    const totalRecipients = (Array.isArray(to) ? to.length : 1) + (cc ? (Array.isArray(cc) ? cc.length : 1) : 0) + (bcc ? (Array.isArray(bcc) ? bcc.length : 1) : 0);\n    const result: Output = {\n      type: 'success' as const,\n      item: {\n        id: messageId,\n        sentAt: new Date().toISOString(),\n        recipientCount: totalRecipients,\n        webLink: `https://mail.google.com/mail/u/0/#sent/${messageId}`,\n      },\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.send error', { error: message });\n\n    throw new McpError(ErrorCode.InternalError, `Error sending message: ${message}`, {\n      stack: error instanceof Error ? error.stack : undefined,\n    });\n  }\n}\n\nexport default function createTool() {\n  return {\n    name: 'message-send',\n    config,\n    handler,\n  } satisfies ToolModule;\n}\n"],"names":["ComposeContentTypeSchema","createEmailRecipientsSchema","createMessageResultSchema","schemas","AuthRequiredBranchSchema","ErrorCode","McpError","google","z","buildRfc822FromArgs","b64url","inputSchema","object","to","cc","bcc","subject","string","describe","default","body","trim","min","contentType","successBranchSchema","type","literal","item","outputSchema","discriminatedUnion","config","description","result","handler","params","extra","logger","info","InvalidParams","msgArgs","undefined","raw","encodedMessage","gmail","version","auth","authContext","sendRes","users","messages","send","userId","requestBody","sendData","data","messageId","id","totalRecipients","Array","isArray","length","sentAt","Date","toISOString","recipientCount","webLink","content","text","JSON","stringify","structuredContent","error","message","Error","String","InternalError","stack","createTool","name"],"mappings":"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"}
+{"version":3,"sources":["/Users/kevin/Dev/Projects/mcp-z/mcp-gmail/src/mcp/tools/message-send.ts"],"sourcesContent":["import { ComposeContentTypeSchema, createEmailRecipientsSchema, createMessageResultSchema } 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 type { ToolModule } from '@mcp-z/server';\nimport { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';\nimport { google } from 'googleapis';\nimport { z } from 'zod';\nimport { buildRfc822FromArgs } from '../../email/composition/rfc822-builder.ts';\nimport { b64url } from '../../lib/base64-encoding.ts';\n\nconst inputSchema = z.object({\n  to: createEmailRecipientsSchema('to', true),\n  cc: createEmailRecipientsSchema('cc', false),\n  bcc: createEmailRecipientsSchema('bcc', false),\n  subject: z.string().describe('Message subject').default(''),\n  body: z.string().trim().min(1).describe('Email body content (plain text or HTML)'),\n  contentType: ComposeContentTypeSchema,\n});\n\n// Success branch schema\nconst successBranchSchema = z.object({\n  type: z.literal('success'),\n  item: createMessageResultSchema('gmail'),\n});\n\n// Output schema with auth_required support\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n  description: 'Send an email message through Gmail',\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(params: Input, extra: EnrichedExtra) {\n  const { to, cc, bcc, subject, body, contentType } = params;\n  const logger = extra.logger;\n  logger.info('gmail.message.send called', { to, subject, contentType });\n\n  if (!to) {\n    throw new McpError(ErrorCode.InvalidParams, 'Missing required field: to');\n  }\n\n  try {\n    // Build RFC822 message - only include optional headers when defined to satisfy\n    // exactOptionalPropertyTypes (avoid passing `undefined` into optional props)\n    const msgArgs: { to: string; cc?: string; bcc?: string; subject?: string; body: string; contentType: 'text' | 'html' } = { to, body, contentType };\n    if (cc !== undefined) msgArgs.cc = cc;\n    if (bcc !== undefined) msgArgs.bcc = bcc;\n    if (subject !== undefined) msgArgs.subject = subject;\n\n    const raw = buildRfc822FromArgs(msgArgs);\n    const encodedMessage = b64url(raw);\n\n    const gmail = google.gmail({ version: 'v1', auth: extra.authContext.auth });\n\n    const sendRes = await gmail.users.messages.send({\n      userId: 'me',\n      requestBody: { raw: encodedMessage },\n    });\n    const sendData = sendRes.data;\n    const messageId = sendData.id || 'unknown';\n    logger.info('Gmail: sent message successfully', { id: messageId });\n    logger.info('gmail.message.send result (typed)', { to, subject, messageId });\n\n    const totalRecipients = (Array.isArray(to) ? to.length : 1) + (cc ? (Array.isArray(cc) ? cc.length : 1) : 0) + (bcc ? (Array.isArray(bcc) ? bcc.length : 1) : 0);\n    const result: Output = {\n      type: 'success' as const,\n      item: {\n        id: messageId,\n        sentAt: new Date().toISOString(),\n        recipientCount: totalRecipients,\n        webLink: `https://mail.google.com/mail/u/0/#sent/${messageId}`,\n      },\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.send error', { error: message });\n\n    throw new McpError(ErrorCode.InternalError, `Error sending message: ${message}`, {\n      stack: error instanceof Error ? error.stack : undefined,\n    });\n  }\n}\n\nexport default function createTool() {\n  return {\n    name: 'message-send',\n    config,\n    handler,\n  } satisfies ToolModule;\n}\n"],"names":["ComposeContentTypeSchema","createEmailRecipientsSchema","createMessageResultSchema","schemas","AuthRequiredBranchSchema","ErrorCode","McpError","google","z","buildRfc822FromArgs","b64url","inputSchema","object","to","cc","bcc","subject","string","describe","default","body","trim","min","contentType","successBranchSchema","type","literal","item","outputSchema","discriminatedUnion","config","description","result","handler","params","extra","logger","info","InvalidParams","msgArgs","undefined","raw","encodedMessage","gmail","version","auth","authContext","sendRes","users","messages","send","userId","requestBody","sendData","data","messageId","id","totalRecipients","Array","isArray","length","sentAt","Date","toISOString","recipientCount","webLink","content","text","JSON","stringify","structuredContent","error","message","Error","String","InternalError","stack","createTool","name"],"mappings":"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"}

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

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

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

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

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

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

package/dist/esm/setup/config.js

@@ -1,5 +1,5 @@
 import { parseDcrConfig, parseConfig as parseOAuthConfig } from '@mcp-z/oauth-google';
-import { parseConfig as parseTransportConfig } from '@mcp-z/server';
+import { findConfigPath, parseConfig as parseTransportConfig } from '@mcp-z/server';
 import * as fs from 'fs';
 import moduleRoot from 'module-root-sync';
 import { homedir } from 'os';
@@ -139,7 +139,17 @@ Examples:
     // Parse repository URL from package.json, stripping git+ prefix and .git suffix
     const rawRepoUrl = typeof pkg.repository === 'object' ? pkg.repository.url : pkg.repository;
     const repositoryUrl = (_ref = rawRepoUrl === null || rawRepoUrl === void 0 ? void 0 : rawRepoUrl.replace(/^git\+/, '').replace(/\.git$/, '')) !== null && _ref !== void 0 ? _ref : `https://github.com/mcp-z/${name}`;
-    const rootDir = process.cwd() === '/' ? homedir() : process.cwd();
+    let rootDir = homedir();
+    try {
+        const configPath = findConfigPath({
+            config: '.mcp.json',
+            cwd: process.cwd(),
+            stopDir: homedir()
+        });
+        rootDir = path.dirname(configPath);
+    } catch  {
+        rootDir = homedir();
+    }
     const baseDir = path.join(rootDir, '.mcp-z');
     const cliLogLevel = typeof values['log-level'] === 'string' ? values['log-level'] : undefined;
     const envLogLevel = env.LOG_LEVEL;

package/dist/esm/setup/config.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/Projects/ai/mcp-z/servers/mcp-gmail/src/setup/config.ts"],"sourcesContent":["import { parseDcrConfig, parseConfig as parseOAuthConfig } from '@mcp-z/oauth-google';\nimport { parseConfig as parseTransportConfig } from '@mcp-z/server';\nimport * as fs from 'fs';\nimport moduleRoot from 'module-root-sync';\nimport { homedir } from 'os';\nimport * as path from 'path';\nimport * as url from 'url';\nimport { parseArgs } from 'util';\nimport { GOOGLE_SCOPE } from '../constants.ts';\nimport type { ServerConfig } from '../types.js';\n\nconst pkg = JSON.parse(fs.readFileSync(path.join(moduleRoot(url.fileURLToPath(import.meta.url)), 'package.json'), 'utf-8'));\n\nconst HELP_TEXT = `\nUsage: mcp-gmail [options]\n\nMCP server for Gmail email management with OAuth authentication.\n\nOptions:\n  --version              Show version number\n  --help                 Show this help message\n  --auth=<mode>          Authentication mode (default: loopback-oauth)\n                         Modes: loopback-oauth, service-account, dcr\n  --headless             Disable browser auto-open, return auth URL instead\n  --redirect-uri=<uri>   OAuth redirect URI (default: ephemeral loopback)\n  --dcr-mode=<mode>      DCR mode (self-hosted or external, default: self-hosted)\n  --dcr-verify-url=<url> External verification endpoint (required for external mode)\n  --dcr-store-uri=<uri>  DCR client storage URI (required for self-hosted mode)\n  --port=<port>          Enable HTTP transport on specified port\n  --stdio                Enable stdio transport (default if no port)\n  --log-level=<level>    Logging level (default: info)\n  --storage-dir=<path>   Directory for CSV file storage (default: .mcp-z/files)\n  --base-url=<url>       Base URL for HTTP file serving (optional)\n\nEnvironment Variables:\n  GOOGLE_CLIENT_ID       OAuth client ID (REQUIRED)\n  GOOGLE_CLIENT_SECRET   OAuth client secret (optional)\n  AUTH_MODE              Default authentication mode (optional)\n  HEADLESS               Disable browser auto-open (optional)\n  DCR_MODE               DCR mode (optional, same format as --dcr-mode)\n  DCR_VERIFY_URL         External verification URL (optional, same as --dcr-verify-url)\n  DCR_STORE_URI          DCR storage URI (optional, same as --dcr-store-uri)\n  PORT                   Default HTTP port (optional)\n  LOG_LEVEL              Default logging level (optional)\n  STORAGE_DIR            Default storage directory (optional)\n  BASE_URL               Default base URL for file serving (optional)\n\nOAuth Scopes:\n  openid https://www.googleapis.com/auth/userinfo.profile https://www.googleapis.com/auth/userinfo.email https://mail.google.com/\n\nExamples:\n  mcp-gmail                           # Use default settings\n  mcp-gmail --auth=service-account    # Use service account auth\n  mcp-gmail --port=3000               # HTTP transport on port 3000\n  mcp-gmail --storage-dir=./emails    # Custom storage directory\n  GOOGLE_CLIENT_ID=xxx mcp-gmail      # Set client ID via env var\n`.trim();\n\n/**\n * Handle --version and --help flags before config parsing.\n * These should work without requiring any configuration.\n */\nexport function handleVersionHelp(args: string[]): { handled: boolean; output?: string } {\n  const { values } = parseArgs({\n    args,\n    options: {\n      version: { type: 'boolean' },\n      help: { type: 'boolean' },\n    },\n    strict: false,\n  });\n\n  if (values.version) return { handled: true, output: pkg.version };\n  if (values.help) return { handled: true, output: HELP_TEXT };\n  return { handled: false };\n}\n\n/**\n * Parse Gmail server configuration from CLI arguments and environment.\n *\n * CLI Arguments (all optional):\n * - --auth=<mode>          Authentication mode (default: loopback-oauth)\n *                          Modes: loopback-oauth, service-account, dcr\n * - --headless             Disable browser auto-open, return auth URL instead\n * - --redirect-uri=<uri>   OAuth redirect URI (default: ephemeral loopback)\n * - --dcr-mode=<mode>      DCR mode (self-hosted or external, default: self-hosted)\n * - --dcr-verify-url=<url> External verification endpoint (required for external mode)\n * - --dcr-store-uri=<uri>  DCR client storage URI (required for self-hosted mode)\n * - --port=<port>          Enable HTTP transport on specified port\n * - --stdio                Enable stdio transport (default if no port)\n * - --log-level=<level>    Logging level (default: info)\n * - --storage-dir=<path>   Directory for CSV file storage (default: .mcp-z/files)\n * - --base-url=<url>       Base URL for HTTP file serving (optional)\n *\n * Environment Variables:\n * - GOOGLE_CLIENT_ID       OAuth client ID (REQUIRED)\n * - GOOGLE_CLIENT_SECRET   OAuth client secret (optional)\n * - AUTH_MODE              Default authentication mode (optional)\n * - HEADLESS               Disable browser auto-open (optional)\n * - DCR_MODE               DCR mode (optional, same format as --dcr-mode)\n * - DCR_VERIFY_URL         External verification URL (optional, same as --dcr-verify-url)\n * - DCR_STORE_URI          DCR storage URI (optional, same as --dcr-store-uri)\n * - PORT                   Default HTTP port (optional)\n * - LOG_LEVEL              Default logging level (optional)\n * - STORAGE_DIR            Default storage directory (optional)\n * - BASE_URL               Default base URL for file serving (optional)\n *\n * OAuth Scopes (from constants.ts):\n * openid https://www.googleapis.com/auth/userinfo.profile https://www.googleapis.com/auth/userinfo.email https://mail.google.com/\n */\nexport function parseConfig(args: string[], env: Record<string, string | undefined>): ServerConfig {\n  const transportConfig = parseTransportConfig(args, env);\n  const oauthConfig = parseOAuthConfig(args, env);\n\n  // Parse DCR configuration if DCR mode is enabled\n  const dcrConfig = oauthConfig.auth === 'dcr' ? parseDcrConfig(args, env, GOOGLE_SCOPE) : undefined;\n\n  // Parse application-level config (LOG_LEVEL, STORAGE_DIR, BASE_URL)\n  const { values } = parseArgs({\n    args,\n    options: {\n      'log-level': { type: 'string' },\n      'storage-dir': { type: 'string' },\n      'base-url': { type: 'string' },\n    },\n    strict: false, // Allow other arguments\n    allowPositionals: true,\n  });\n\n  const name = pkg.name.replace(/^@[^/]+\\//, '');\n  // Parse repository URL from package.json, stripping git+ prefix and .git suffix\n  const rawRepoUrl = typeof pkg.repository === 'object' ? pkg.repository.url : pkg.repository;\n  const repositoryUrl = rawRepoUrl?.replace(/^git\\+/, '').replace(/\\.git$/, '') ?? `https://github.com/mcp-z/${name}`;\n  const rootDir = process.cwd() === '/' ? homedir() : process.cwd();\n  const baseDir = path.join(rootDir, '.mcp-z');\n  const cliLogLevel = typeof values['log-level'] === 'string' ? values['log-level'] : undefined;\n  const envLogLevel = env.LOG_LEVEL;\n  const logLevel = cliLogLevel ?? envLogLevel ?? 'info';\n\n  // Parse storage configuration\n  const cliStorageDir = typeof values['storage-dir'] === 'string' ? values['storage-dir'] : undefined;\n  const envStorageDir = env.STORAGE_DIR;\n  let storageDir = cliStorageDir ?? envStorageDir ?? path.join(baseDir, name, 'files');\n  if (storageDir.startsWith('~')) storageDir = storageDir.replace(/^~/, homedir());\n\n  const cliBaseUrl = typeof values['base-url'] === 'string' ? values['base-url'] : undefined;\n  const envBaseUrl = env.BASE_URL;\n  const baseUrl = cliBaseUrl ?? envBaseUrl;\n\n  // Combine configs\n  const result: ServerConfig = {\n    ...oauthConfig, // Includes clientId, auth, headless, redirectUri, serviceAccountKeyFile\n    transport: transportConfig.transport,\n    logLevel,\n    baseDir,\n    name,\n    version: pkg.version,\n    repositoryUrl,\n    storageDir: path.resolve(storageDir),\n  };\n  if (baseUrl) result.baseUrl = baseUrl;\n  if (dcrConfig !== undefined) result.dcrConfig = dcrConfig;\n  return result;\n}\n\n/**\n * Build production configuration from process globals.\n * Entry point for production server.\n */\nexport function createConfig(): ServerConfig {\n  return parseConfig(process.argv, process.env);\n}\n"],"names":["parseDcrConfig","parseConfig","parseOAuthConfig","parseTransportConfig","fs","moduleRoot","homedir","path","url","parseArgs","GOOGLE_SCOPE","pkg","JSON","parse","readFileSync","join","fileURLToPath","HELP_TEXT","trim","handleVersionHelp","args","values","options","version","type","help","strict","handled","output","env","cliLogLevel","cliStorageDir","transportConfig","oauthConfig","dcrConfig","auth","undefined","allowPositionals","name","replace","rawRepoUrl","repository","repositoryUrl","rootDir","process","cwd","baseDir","envLogLevel","LOG_LEVEL","logLevel","envStorageDir","STORAGE_DIR","storageDir","startsWith","cliBaseUrl","envBaseUrl","BASE_URL","baseUrl","result","transport","resolve","createConfig","argv"],"mappings":"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"}
+{"version":3,"sources":["/Users/kevin/Dev/Projects/mcp-z/mcp-gmail/src/setup/config.ts"],"sourcesContent":["import { parseDcrConfig, parseConfig as parseOAuthConfig } from '@mcp-z/oauth-google';\nimport { findConfigPath, parseConfig as parseTransportConfig } from '@mcp-z/server';\nimport * as fs from 'fs';\nimport moduleRoot from 'module-root-sync';\nimport { homedir } from 'os';\nimport * as path from 'path';\nimport * as url from 'url';\nimport { parseArgs } from 'util';\nimport { GOOGLE_SCOPE } from '../constants.ts';\nimport type { ServerConfig } from '../types.ts';\n\nconst pkg = JSON.parse(fs.readFileSync(path.join(moduleRoot(url.fileURLToPath(import.meta.url)), 'package.json'), 'utf-8'));\n\nconst HELP_TEXT = `\nUsage: mcp-gmail [options]\n\nMCP server for Gmail email management with OAuth authentication.\n\nOptions:\n  --version              Show version number\n  --help                 Show this help message\n  --auth=<mode>          Authentication mode (default: loopback-oauth)\n                         Modes: loopback-oauth, service-account, dcr\n  --headless             Disable browser auto-open, return auth URL instead\n  --redirect-uri=<uri>   OAuth redirect URI (default: ephemeral loopback)\n  --dcr-mode=<mode>      DCR mode (self-hosted or external, default: self-hosted)\n  --dcr-verify-url=<url> External verification endpoint (required for external mode)\n  --dcr-store-uri=<uri>  DCR client storage URI (required for self-hosted mode)\n  --port=<port>          Enable HTTP transport on specified port\n  --stdio                Enable stdio transport (default if no port)\n  --log-level=<level>    Logging level (default: info)\n  --storage-dir=<path>   Directory for CSV file storage (default: .mcp-z/files)\n  --base-url=<url>       Base URL for HTTP file serving (optional)\n\nEnvironment Variables:\n  GOOGLE_CLIENT_ID       OAuth client ID (REQUIRED)\n  GOOGLE_CLIENT_SECRET   OAuth client secret (optional)\n  AUTH_MODE              Default authentication mode (optional)\n  HEADLESS               Disable browser auto-open (optional)\n  DCR_MODE               DCR mode (optional, same format as --dcr-mode)\n  DCR_VERIFY_URL         External verification URL (optional, same as --dcr-verify-url)\n  DCR_STORE_URI          DCR storage URI (optional, same as --dcr-store-uri)\n  PORT                   Default HTTP port (optional)\n  LOG_LEVEL              Default logging level (optional)\n  STORAGE_DIR            Default storage directory (optional)\n  BASE_URL               Default base URL for file serving (optional)\n\nOAuth Scopes:\n  openid https://www.googleapis.com/auth/userinfo.profile https://www.googleapis.com/auth/userinfo.email https://mail.google.com/\n\nExamples:\n  mcp-gmail                           # Use default settings\n  mcp-gmail --auth=service-account    # Use service account auth\n  mcp-gmail --port=3000               # HTTP transport on port 3000\n  mcp-gmail --storage-dir=./emails    # Custom storage directory\n  GOOGLE_CLIENT_ID=xxx mcp-gmail      # Set client ID via env var\n`.trim();\n\n/**\n * Handle --version and --help flags before config parsing.\n * These should work without requiring any configuration.\n */\nexport function handleVersionHelp(args: string[]): { handled: boolean; output?: string } {\n  const { values } = parseArgs({\n    args,\n    options: {\n      version: { type: 'boolean' },\n      help: { type: 'boolean' },\n    },\n    strict: false,\n  });\n\n  if (values.version) return { handled: true, output: pkg.version };\n  if (values.help) return { handled: true, output: HELP_TEXT };\n  return { handled: false };\n}\n\n/**\n * Parse Gmail server configuration from CLI arguments and environment.\n *\n * CLI Arguments (all optional):\n * - --auth=<mode>          Authentication mode (default: loopback-oauth)\n *                          Modes: loopback-oauth, service-account, dcr\n * - --headless             Disable browser auto-open, return auth URL instead\n * - --redirect-uri=<uri>   OAuth redirect URI (default: ephemeral loopback)\n * - --dcr-mode=<mode>      DCR mode (self-hosted or external, default: self-hosted)\n * - --dcr-verify-url=<url> External verification endpoint (required for external mode)\n * - --dcr-store-uri=<uri>  DCR client storage URI (required for self-hosted mode)\n * - --port=<port>          Enable HTTP transport on specified port\n * - --stdio                Enable stdio transport (default if no port)\n * - --log-level=<level>    Logging level (default: info)\n * - --storage-dir=<path>   Directory for CSV file storage (default: .mcp-z/files)\n * - --base-url=<url>       Base URL for HTTP file serving (optional)\n *\n * Environment Variables:\n * - GOOGLE_CLIENT_ID       OAuth client ID (REQUIRED)\n * - GOOGLE_CLIENT_SECRET   OAuth client secret (optional)\n * - AUTH_MODE              Default authentication mode (optional)\n * - HEADLESS               Disable browser auto-open (optional)\n * - DCR_MODE               DCR mode (optional, same format as --dcr-mode)\n * - DCR_VERIFY_URL         External verification URL (optional, same as --dcr-verify-url)\n * - DCR_STORE_URI          DCR storage URI (optional, same as --dcr-store-uri)\n * - PORT                   Default HTTP port (optional)\n * - LOG_LEVEL              Default logging level (optional)\n * - STORAGE_DIR            Default storage directory (optional)\n * - BASE_URL               Default base URL for file serving (optional)\n *\n * OAuth Scopes (from constants.ts):\n * openid https://www.googleapis.com/auth/userinfo.profile https://www.googleapis.com/auth/userinfo.email https://mail.google.com/\n */\nexport function parseConfig(args: string[], env: Record<string, string | undefined>): ServerConfig {\n  const transportConfig = parseTransportConfig(args, env);\n  const oauthConfig = parseOAuthConfig(args, env);\n\n  // Parse DCR configuration if DCR mode is enabled\n  const dcrConfig = oauthConfig.auth === 'dcr' ? parseDcrConfig(args, env, GOOGLE_SCOPE) : undefined;\n\n  // Parse application-level config (LOG_LEVEL, STORAGE_DIR, BASE_URL)\n  const { values } = parseArgs({\n    args,\n    options: {\n      'log-level': { type: 'string' },\n      'storage-dir': { type: 'string' },\n      'base-url': { type: 'string' },\n    },\n    strict: false, // Allow other arguments\n    allowPositionals: true,\n  });\n\n  const name = pkg.name.replace(/^@[^/]+\\//, '');\n  // Parse repository URL from package.json, stripping git+ prefix and .git suffix\n  const rawRepoUrl = typeof pkg.repository === 'object' ? pkg.repository.url : pkg.repository;\n  const repositoryUrl = rawRepoUrl?.replace(/^git\\+/, '').replace(/\\.git$/, '') ?? `https://github.com/mcp-z/${name}`;\n  let rootDir = homedir();\n  try {\n    const configPath = findConfigPath({ config: '.mcp.json', cwd: process.cwd(), stopDir: homedir() });\n    rootDir = path.dirname(configPath);\n  } catch {\n    rootDir = homedir();\n  }\n  const baseDir = path.join(rootDir, '.mcp-z');\n  const cliLogLevel = typeof values['log-level'] === 'string' ? values['log-level'] : undefined;\n  const envLogLevel = env.LOG_LEVEL;\n  const logLevel = cliLogLevel ?? envLogLevel ?? 'info';\n\n  // Parse storage configuration\n  const cliStorageDir = typeof values['storage-dir'] === 'string' ? values['storage-dir'] : undefined;\n  const envStorageDir = env.STORAGE_DIR;\n  let storageDir = cliStorageDir ?? envStorageDir ?? path.join(baseDir, name, 'files');\n  if (storageDir.startsWith('~')) storageDir = storageDir.replace(/^~/, homedir());\n\n  const cliBaseUrl = typeof values['base-url'] === 'string' ? values['base-url'] : undefined;\n  const envBaseUrl = env.BASE_URL;\n  const baseUrl = cliBaseUrl ?? envBaseUrl;\n\n  // Combine configs\n  const result: ServerConfig = {\n    ...oauthConfig, // Includes clientId, auth, headless, redirectUri, serviceAccountKeyFile\n    transport: transportConfig.transport,\n    logLevel,\n    baseDir,\n    name,\n    version: pkg.version,\n    repositoryUrl,\n    storageDir: path.resolve(storageDir),\n  };\n  if (baseUrl) result.baseUrl = baseUrl;\n  if (dcrConfig !== undefined) result.dcrConfig = dcrConfig;\n  return result;\n}\n\n/**\n * Build production configuration from process globals.\n * Entry point for production server.\n */\nexport function createConfig(): ServerConfig {\n  return parseConfig(process.argv, process.env);\n}\n"],"names":["parseDcrConfig","parseConfig","parseOAuthConfig","findConfigPath","parseTransportConfig","fs","moduleRoot","homedir","path","url","parseArgs","GOOGLE_SCOPE","pkg","JSON","parse","readFileSync","join","fileURLToPath","HELP_TEXT","trim","handleVersionHelp","args","values","options","version","type","help","strict","handled","output","env","cliLogLevel","cliStorageDir","transportConfig","oauthConfig","dcrConfig","auth","undefined","allowPositionals","name","replace","rawRepoUrl","repository","repositoryUrl","rootDir","configPath","config","cwd","process","stopDir","dirname","baseDir","envLogLevel","LOG_LEVEL","logLevel","envStorageDir","STORAGE_DIR","storageDir","startsWith","cliBaseUrl","envBaseUrl","BASE_URL","baseUrl","result","transport","resolve","createConfig","argv"],"mappings":"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"}