@mcp-z/mcp-gmail 1.0.0

package/dist/esm/lib/messages-to-row.d.ts

@@ -0,0 +1,61 @@
+export interface GmailMessage {
+    id?: string;
+    threadId?: string;
+    labelIds?: string[];
+    snippet?: string;
+    payload?: {
+        headers?: Array<{
+            name: string;
+            value: string;
+        }>;
+        body?: {
+            data?: string;
+        };
+        parts?: Array<{
+            mimeType: string;
+            body?: {
+                data?: string;
+            };
+        }>;
+    };
+}
+interface GmailEmailSummary {
+    id: string;
+    provider: 'gmail';
+    threadId?: string | undefined;
+    date?: string | undefined;
+    from?: string | undefined;
+    fromName?: string | undefined;
+    to?: string | undefined;
+    cc?: string | undefined;
+    bcc?: string | undefined;
+    subject?: string | undefined;
+    snippet?: string | undefined;
+    body?: string | undefined;
+}
+interface FormatOptions {
+    body?: boolean;
+    addressFormat?: 'raw' | 'name' | 'email';
+}
+export declare function toRowFromGmail(msg?: GmailMessage, opts?: FormatOptions): string[];
+export declare function toRowFromGmailSummary(msg: GmailEmailSummary, opts?: FormatOptions): string[];
+interface ClientSideFilters {
+    subjectIncludes?: string[];
+    bodyIncludes?: string[];
+    textIncludes?: string[];
+    fromIncludes?: string[];
+    toIncludes?: string[];
+    ccIncludes?: string[];
+    bccIncludes?: string[];
+}
+interface FilterContent {
+    subject?: string;
+    snippetOrPreview?: string;
+    fullBody?: string;
+    from?: string;
+    to?: string;
+    cc?: string;
+    bcc?: string;
+}
+export declare function filterClientSide(filters: ClientSideFilters, { subject, snippetOrPreview, fullBody, from, to, cc, bcc }?: FilterContent): boolean;
+export {};

package/dist/esm/lib/messages-to-row.js

@@ -0,0 +1,188 @@
+import { extractCurrentMessageFromHtmlToText, extractCurrentMessageFromText, formatAddresses, normalizeDateToISO } from '@mcp-z/email';
+function getHeader(headers, name) {
+    if (!headers || !Array.isArray(headers)) return '';
+    const header = headers.find((h)=>h.name.toLowerCase() === name.toLowerCase());
+    return header ? header.value : '';
+}
+function parseEmailHeader(headerValue) {
+    if (!headerValue) return [];
+    const parts = [];
+    let current = '';
+    let inQuotes = false;
+    for(let i = 0; i < headerValue.length; i++){
+        const char = headerValue[i];
+        if (char === '"') {
+            inQuotes = !inQuotes;
+            current += char;
+        } else if (char === ',' && !inQuotes) {
+            parts.push(current.trim());
+            current = '';
+        } else {
+            current += char;
+        }
+    }
+    if (current) parts.push(current.trim());
+    return parts.map((part)=>{
+        const match = part.match(/^(?:"?([^"]*)"? <([^>]+)>|([^,]+))$/);
+        if (match) {
+            if (match[2]) {
+                return {
+                    name: match[1] || undefined,
+                    email: match[2]
+                };
+            }
+            return {
+                email: match[3] || ''
+            };
+        }
+        return {
+            email: part.trim()
+        };
+    }).filter((token)=>!!token.email); // Type guard to ensure email is always present
+}
+function formatRecipientHeader(headerValue, mode = 'email') {
+    const addresses = parseEmailHeader(headerValue);
+    return formatAddresses(addresses, mode);
+}
+/**
+ * Sanitizes email body text for Google Sheets export by enforcing cell character limits.
+ * Google Sheets API limits cells to 50,000 characters - this prevents API errors during export.
+ */ function sanitizeForSheetsExport(text) {
+    // Google Sheets has a 50,000 character limit per cell
+    // Leave some buffer for safety
+    const GOOGLE_SHEETS_CELL_LIMIT = 49000;
+    if (text.length <= GOOGLE_SHEETS_CELL_LIMIT) return text;
+    // Truncate and add indication that it was truncated
+    const truncated = text.substring(0, GOOGLE_SHEETS_CELL_LIMIT - 100);
+    return `${truncated}\n\n[...content truncated to fit Google Sheets cell limit...]`;
+}
+export function toRowFromGmail(msg = {}, opts = {
+    body: false,
+    addressFormat: 'email'
+}) {
+    var _msg_id, _msg_threadId, _normalizeDateToISO, _msg_snippet;
+    var _msg_payload;
+    const id = (_msg_id = msg.id) !== null && _msg_id !== void 0 ? _msg_id : '';
+    const provider = 'gmail';
+    const threadId = (_msg_threadId = msg.threadId) !== null && _msg_threadId !== void 0 ? _msg_threadId : '';
+    const fmt = opts.addressFormat || 'email';
+    const headers = ((_msg_payload = msg.payload) === null || _msg_payload === void 0 ? void 0 : _msg_payload.headers) || [];
+    const toHeader = getHeader(headers, 'To');
+    const fromHeader = getHeader(headers, 'From');
+    const ccHeader = getHeader(headers, 'Cc');
+    const bccHeader = getHeader(headers, 'Bcc');
+    const dateHeader = getHeader(headers, 'Date');
+    const subjectHeader = getHeader(headers, 'Subject');
+    const to = formatRecipientHeader(toHeader, fmt);
+    const from = formatRecipientHeader(fromHeader, fmt);
+    const cc = formatRecipientHeader(ccHeader, fmt);
+    const bcc = formatRecipientHeader(bccHeader, fmt);
+    const date = (_normalizeDateToISO = normalizeDateToISO(dateHeader)) !== null && _normalizeDateToISO !== void 0 ? _normalizeDateToISO : '';
+    const subject = subjectHeader !== null && subjectHeader !== void 0 ? subjectHeader : '';
+    const labels = (msg.labelIds || []).join(', ');
+    const snippet = (_msg_snippet = msg.snippet) !== null && _msg_snippet !== void 0 ? _msg_snippet : '';
+    let bodyFull = '';
+    if (opts.body) {
+        if (msg.payload) {
+            var _msg_payload_body;
+            if ((_msg_payload_body = msg.payload.body) === null || _msg_payload_body === void 0 ? void 0 : _msg_payload_body.data) {
+                const rawBody = Buffer.from(msg.payload.body.data, 'base64').toString('utf-8');
+                bodyFull = extractCurrentMessageFromText(rawBody);
+            } else if (msg.payload.parts && Array.isArray(msg.payload.parts)) {
+                for (const part of msg.payload.parts){
+                    var _part_body;
+                    if ((_part_body = part.body) === null || _part_body === void 0 ? void 0 : _part_body.data) {
+                        const rawBody = Buffer.from(part.body.data, 'base64').toString('utf-8');
+                        if (part.mimeType === 'text/plain') {
+                            bodyFull = extractCurrentMessageFromText(rawBody);
+                            break;
+                        }
+                        if (part.mimeType === 'text/html') {
+                            bodyFull = extractCurrentMessageFromHtmlToText(rawBody);
+                            break;
+                        }
+                    }
+                }
+            }
+        }
+    }
+    return [
+        id,
+        provider,
+        threadId,
+        to,
+        from,
+        cc,
+        bcc,
+        date,
+        subject,
+        labels,
+        snippet,
+        sanitizeForSheetsExport(bodyFull)
+    ];
+}
+export function toRowFromGmailSummary(msg, opts = {
+    body: false,
+    addressFormat: 'email'
+}) {
+    var _msg_id, _msg_threadId, _msg_to, _msg_from, _msg_cc, _msg_bcc, _normalizeDateToISO, _msg_subject, _msg_snippet;
+    const id = (_msg_id = msg.id) !== null && _msg_id !== void 0 ? _msg_id : '';
+    const provider = msg.provider || 'gmail';
+    const threadId = (_msg_threadId = msg.threadId) !== null && _msg_threadId !== void 0 ? _msg_threadId : '';
+    const fmt = opts.addressFormat || 'email';
+    const to = formatRecipientHeader((_msg_to = msg.to) !== null && _msg_to !== void 0 ? _msg_to : '', fmt);
+    const from = formatRecipientHeader((_msg_from = msg.from) !== null && _msg_from !== void 0 ? _msg_from : '', fmt);
+    const cc = formatRecipientHeader((_msg_cc = msg.cc) !== null && _msg_cc !== void 0 ? _msg_cc : '', fmt);
+    const bcc = formatRecipientHeader((_msg_bcc = msg.bcc) !== null && _msg_bcc !== void 0 ? _msg_bcc : '', fmt);
+    const date = (_normalizeDateToISO = normalizeDateToISO(msg.date)) !== null && _normalizeDateToISO !== void 0 ? _normalizeDateToISO : '';
+    const subject = (_msg_subject = msg.subject) !== null && _msg_subject !== void 0 ? _msg_subject : '';
+    const labels = '';
+    const snippet = (_msg_snippet = msg.snippet) !== null && _msg_snippet !== void 0 ? _msg_snippet : '';
+    let bodyFull = '';
+    if (opts.body && msg.body) {
+        bodyFull = extractCurrentMessageFromText(msg.body);
+    }
+    return [
+        id,
+        provider,
+        threadId,
+        to,
+        from,
+        cc,
+        bcc,
+        date,
+        subject,
+        labels,
+        snippet,
+        sanitizeForSheetsExport(bodyFull)
+    ];
+}
+export function filterClientSide(filters, { subject = '', snippetOrPreview = '', fullBody = '', from = '', to = '', cc = '', bcc = '' } = {}) {
+    var _ref;
+    const lower = (a)=>a.map((t)=>String(t).toLowerCase());
+    const subjectTokens = lower(filters.subjectIncludes || []);
+    const bodyTokens = lower(filters.bodyIncludes || []);
+    const textTokens = lower(filters.textIncludes || []);
+    const fromTokens = lower(filters.fromIncludes || []);
+    const toCredentials = lower(filters.toIncludes || []);
+    const ccTokens = lower(filters.ccIncludes || []);
+    const bccTokens = lower(filters.bccIncludes || []);
+    const s = String(subject !== null && subject !== void 0 ? subject : '').toLowerCase();
+    const b = String((_ref = fullBody || snippetOrPreview) !== null && _ref !== void 0 ? _ref : '').toLowerCase();
+    const f = String(from !== null && from !== void 0 ? from : '').toLowerCase();
+    const t = String(to !== null && to !== void 0 ? to : '').toLowerCase();
+    const c = String(cc !== null && cc !== void 0 ? cc : '').toLowerCase();
+    const bc = String(bcc !== null && bcc !== void 0 ? bcc : '').toLowerCase();
+    const anyIncludes = (val, tokens)=>{
+        var _tokens_;
+        return tokens.length === 1 ? val.includes((_tokens_ = tokens[0]) !== null && _tokens_ !== void 0 ? _tokens_ : '') : tokens.some((token)=>val.includes(token));
+    };
+    const subjectOk = subjectTokens.length ? anyIncludes(s, subjectTokens) : true;
+    const bodyOk = bodyTokens.length ? anyIncludes(b, bodyTokens) : true;
+    const textOk = textTokens.length ? textTokens.some((token)=>s.includes(token) || b.includes(token)) : true;
+    const fromOk = fromTokens.length ? anyIncludes(f, fromTokens) : true;
+    const toOk = toCredentials.length ? anyIncludes(t, toCredentials) : true;
+    const ccOk = ccTokens.length ? anyIncludes(c, ccTokens) : true;
+    const bccOk = bccTokens.length ? anyIncludes(bc, bccTokens) : true;
+    return subjectOk && bodyOk && textOk && fromOk && toOk && ccOk && bccOk;
+}

package/dist/esm/lib/messages-to-row.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/kevin/Dev/Projects/ai/mcp-z/servers/mcp-gmail/src/lib/messages-to-row.ts"],"sourcesContent":["import { extractCurrentMessageFromHtmlToText, extractCurrentMessageFromText, formatAddresses, normalizeDateToISO } from '@mcp-z/email';\n\nexport interface GmailMessage {\n  id?: string;\n  threadId?: string;\n  labelIds?: string[];\n  snippet?: string;\n  payload?: {\n    headers?: Array<{ name: string; value: string }>;\n    body?: {\n      data?: string;\n    };\n    parts?: Array<{\n      mimeType: string;\n      body?: {\n        data?: string;\n      };\n    }>;\n  };\n}\n\ninterface GmailEmailSummary {\n  id: string;\n  provider: 'gmail';\n  threadId?: string | undefined;\n  date?: string | undefined;\n  from?: string | undefined;\n  fromName?: string | undefined;\n  to?: string | undefined;\n  cc?: string | undefined;\n  bcc?: string | undefined;\n  subject?: string | undefined;\n  snippet?: string | undefined;\n  body?: string | undefined;\n}\n\ninterface FormatOptions {\n  body?: boolean;\n  addressFormat?: 'raw' | 'name' | 'email';\n}\n\nfunction getHeader(headers: Array<{ name: string; value: string }> | undefined, name: string): string {\n  if (!headers || !Array.isArray(headers)) return '';\n  const header = headers.find((h) => h.name.toLowerCase() === name.toLowerCase());\n  return header ? header.value : '';\n}\n\ninterface AddressToken {\n  name?: string | undefined;\n  email: string;\n}\n\nfunction parseEmailHeader(headerValue: string): AddressToken[] {\n  if (!headerValue) return [];\n\n  const parts: string[] = [];\n  let current = '';\n  let inQuotes = false;\n\n  for (let i = 0; i < headerValue.length; i++) {\n    const char = headerValue[i];\n    if (char === '\"') {\n      inQuotes = !inQuotes;\n      current += char;\n    } else if (char === ',' && !inQuotes) {\n      parts.push(current.trim());\n      current = '';\n    } else {\n      current += char;\n    }\n  }\n\n  if (current) parts.push(current.trim());\n\n  return parts\n    .map((part): AddressToken => {\n      const match = part.match(/^(?:\"?([^\"]*)\"? <([^>]+)>|([^,]+))$/);\n      if (match) {\n        if (match[2]) {\n          return { name: match[1] || undefined, email: match[2] };\n        }\n        return { email: match[3] || '' };\n      }\n      return { email: part.trim() };\n    })\n    .filter((token) => !!token.email); // Type guard to ensure email is always present\n}\n\nfunction formatRecipientHeader(headerValue: string, mode: 'raw' | 'name' | 'email' = 'email'): string {\n  const addresses = parseEmailHeader(headerValue);\n  return formatAddresses(addresses, mode);\n}\n\n/**\n * Sanitizes email body text for Google Sheets export by enforcing cell character limits.\n * Google Sheets API limits cells to 50,000 characters - this prevents API errors during export.\n */\nfunction sanitizeForSheetsExport(text: string): string {\n  // Google Sheets has a 50,000 character limit per cell\n  // Leave some buffer for safety\n  const GOOGLE_SHEETS_CELL_LIMIT = 49000;\n\n  if (text.length <= GOOGLE_SHEETS_CELL_LIMIT) return text;\n\n  // Truncate and add indication that it was truncated\n  const truncated = text.substring(0, GOOGLE_SHEETS_CELL_LIMIT - 100);\n  return `${truncated}\\n\\n[...content truncated to fit Google Sheets cell limit...]`;\n}\n\nexport function toRowFromGmail(msg: GmailMessage = {}, opts: FormatOptions = { body: false, addressFormat: 'email' }) {\n  const id = msg.id ?? '';\n  const provider = 'gmail';\n  const threadId = msg.threadId ?? '';\n  const fmt = opts.addressFormat || 'email';\n\n  const headers = msg.payload?.headers || [];\n  const toHeader = getHeader(headers, 'To');\n  const fromHeader = getHeader(headers, 'From');\n  const ccHeader = getHeader(headers, 'Cc');\n  const bccHeader = getHeader(headers, 'Bcc');\n  const dateHeader = getHeader(headers, 'Date');\n  const subjectHeader = getHeader(headers, 'Subject');\n\n  const to = formatRecipientHeader(toHeader, fmt);\n  const from = formatRecipientHeader(fromHeader, fmt);\n  const cc = formatRecipientHeader(ccHeader, fmt);\n  const bcc = formatRecipientHeader(bccHeader, fmt);\n  const date = normalizeDateToISO(dateHeader) ?? '';\n  const subject = subjectHeader ?? '';\n\n  const labels = (msg.labelIds || []).join(', ');\n  const snippet = msg.snippet ?? '';\n\n  let bodyFull = '';\n  if (opts.body) {\n    if (msg.payload) {\n      if (msg.payload.body?.data) {\n        const rawBody = Buffer.from(msg.payload.body.data, 'base64').toString('utf-8');\n        bodyFull = extractCurrentMessageFromText(rawBody);\n      } else if (msg.payload.parts && Array.isArray(msg.payload.parts)) {\n        for (const part of msg.payload.parts) {\n          if (part.body?.data) {\n            const rawBody = Buffer.from(part.body.data, 'base64').toString('utf-8');\n            if (part.mimeType === 'text/plain') {\n              bodyFull = extractCurrentMessageFromText(rawBody);\n              break;\n            }\n            if (part.mimeType === 'text/html') {\n              bodyFull = extractCurrentMessageFromHtmlToText(rawBody);\n              break;\n            }\n          }\n        }\n      }\n    }\n  }\n\n  return [id, provider, threadId, to, from, cc, bcc, date, subject, labels, snippet, sanitizeForSheetsExport(bodyFull)];\n}\n\nexport function toRowFromGmailSummary(msg: GmailEmailSummary, opts: FormatOptions = { body: false, addressFormat: 'email' }) {\n  const id = msg.id ?? '';\n  const provider = msg.provider || 'gmail';\n  const threadId = msg.threadId ?? '';\n  const fmt = opts.addressFormat || 'email';\n\n  const to = formatRecipientHeader(msg.to ?? '', fmt);\n  const from = formatRecipientHeader(msg.from ?? '', fmt);\n  const cc = formatRecipientHeader(msg.cc ?? '', fmt);\n  const bcc = formatRecipientHeader(msg.bcc ?? '', fmt);\n  const date = normalizeDateToISO(msg.date) ?? '';\n  const subject = msg.subject ?? '';\n  const labels = '';\n  const snippet = msg.snippet ?? '';\n\n  let bodyFull = '';\n  if (opts.body && msg.body) {\n    bodyFull = extractCurrentMessageFromText(msg.body);\n  }\n\n  return [id, provider, threadId, to, from, cc, bcc, date, subject, labels, snippet, sanitizeForSheetsExport(bodyFull)];\n}\n\ninterface ClientSideFilters {\n  subjectIncludes?: string[];\n  bodyIncludes?: string[];\n  textIncludes?: string[];\n  fromIncludes?: string[];\n  toIncludes?: string[];\n  ccIncludes?: string[];\n  bccIncludes?: string[];\n}\n\ninterface FilterContent {\n  subject?: string;\n  snippetOrPreview?: string;\n  fullBody?: string;\n  from?: string;\n  to?: string;\n  cc?: string;\n  bcc?: string;\n}\n\nexport function filterClientSide(filters: ClientSideFilters, { subject = '', snippetOrPreview = '', fullBody = '', from = '', to = '', cc = '', bcc = '' }: FilterContent = {}) {\n  const lower = (a: string[]) => a.map((t) => String(t).toLowerCase());\n  const subjectTokens = lower(filters.subjectIncludes || []);\n  const bodyTokens = lower(filters.bodyIncludes || []);\n  const textTokens = lower(filters.textIncludes || []);\n  const fromTokens = lower(filters.fromIncludes || []);\n  const toCredentials = lower(filters.toIncludes || []);\n  const ccTokens = lower(filters.ccIncludes || []);\n  const bccTokens = lower(filters.bccIncludes || []);\n\n  const s = String(subject ?? '').toLowerCase();\n  const b = String((fullBody || snippetOrPreview) ?? '').toLowerCase();\n  const f = String(from ?? '').toLowerCase();\n  const t = String(to ?? '').toLowerCase();\n  const c = String(cc ?? '').toLowerCase();\n  const bc = String(bcc ?? '').toLowerCase();\n\n  const anyIncludes = (val: string, tokens: string[]) => (tokens.length === 1 ? val.includes(tokens[0] ?? '') : tokens.some((token) => val.includes(token)));\n  const subjectOk = subjectTokens.length ? anyIncludes(s, subjectTokens) : true;\n  const bodyOk = bodyTokens.length ? anyIncludes(b, bodyTokens) : true;\n  const textOk = textTokens.length ? textTokens.some((token) => s.includes(token) || b.includes(token)) : true;\n  const fromOk = fromTokens.length ? anyIncludes(f, fromTokens) : true;\n  const toOk = toCredentials.length ? anyIncludes(t, toCredentials) : true;\n  const ccOk = ccTokens.length ? anyIncludes(c, ccTokens) : true;\n  const bccOk = bccTokens.length ? anyIncludes(bc, bccTokens) : true;\n\n  return subjectOk && bodyOk && textOk && fromOk && toOk && ccOk && bccOk;\n}\n"],"names":["extractCurrentMessageFromHtmlToText","extractCurrentMessageFromText","formatAddresses","normalizeDateToISO","getHeader","headers","name","Array","isArray","header","find","h","toLowerCase","value","parseEmailHeader","headerValue","parts","current","inQuotes","i","length","char","push","trim","map","part","match","undefined","email","filter","token","formatRecipientHeader","mode","addresses","sanitizeForSheetsExport","text","GOOGLE_SHEETS_CELL_LIMIT","truncated","substring","toRowFromGmail","msg","opts","body","addressFormat","id","provider","threadId","fmt","payload","toHeader","fromHeader","ccHeader","bccHeader","dateHeader","subjectHeader","to","from","cc","bcc","date","subject","labels","labelIds","join","snippet","bodyFull","data","rawBody","Buffer","toString","mimeType","toRowFromGmailSummary","filterClientSide","filters","snippetOrPreview","fullBody","lower","a","t","String","subjectTokens","subjectIncludes","bodyTokens","bodyIncludes","textTokens","textIncludes","fromTokens","fromIncludes","toCredentials","toIncludes","ccTokens","ccIncludes","bccTokens","bccIncludes","s","b","f","c","bc","anyIncludes","val","tokens","includes","some","subjectOk","bodyOk","textOk","fromOk","toOk","ccOk","bccOk"],"mappings":"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"}

package/dist/esm/mcp/index.d.ts

@@ -0,0 +1,3 @@
+export * as promptFactories from './prompts/index.js';
+export * as resourceFactories from './resources/index.js';
+export * as toolFactories from './tools/index.js';

package/dist/esm/mcp/index.js

@@ -0,0 +1,6 @@
+import * as _promptFactories from './prompts/index.js';
+export { _promptFactories as promptFactories };
+import * as _resourceFactories from './resources/index.js';
+export { _resourceFactories as resourceFactories };
+import * as _toolFactories from './tools/index.js';
+export { _toolFactories as toolFactories };

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

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/kevin/Dev/Projects/ai/mcp-z/servers/mcp-gmail/src/mcp/index.ts"],"sourcesContent":["export * as promptFactories from './prompts/index.js';\nexport * as resourceFactories from './resources/index.js';\nexport * as toolFactories from './tools/index.js';\n"],"names":["promptFactories","resourceFactories","toolFactories"],"mappings":"AAAA,kCAAiC,qBAAqB;AAAtD,SAAO,oBAAKA,eAAe,GAA2B;AACtD,oCAAmC,uBAAuB;AAA1D,SAAO,sBAAKC,iBAAiB,GAA6B;AAC1D,gCAA+B,mBAAmB;AAAlD,SAAO,kBAAKC,aAAa,GAAyB"}

package/dist/esm/mcp/prompts/draft-email.d.ts

@@ -0,0 +1,30 @@
+import type { RequestHandlerExtra } from '@modelcontextprotocol/sdk/shared/protocol.js';
+import type { ServerNotification, ServerRequest } from '@modelcontextprotocol/sdk/types.js';
+import { z } from 'zod';
+export default function createPrompt(): {
+    name: string;
+    config: {
+        description: string;
+        argsSchema: {
+            context: z.ZodString;
+            tone: z.ZodOptional<z.ZodString>;
+        };
+    };
+    handler: (args: {
+        [x: string]: unknown;
+    }, _extra: RequestHandlerExtra<ServerRequest, ServerNotification>) => Promise<{
+        messages: ({
+            role: "system";
+            content: {
+                type: "text";
+                text: string;
+            };
+        } | {
+            role: "user";
+            content: {
+                type: "text";
+                text: string;
+            };
+        })[];
+    }>;
+};

package/dist/esm/mcp/prompts/draft-email.js

@@ -0,0 +1,37 @@
+import { z } from 'zod';
+export default function createPrompt() {
+    const argsSchema = z.object({
+        context: z.string().min(1).describe('Email context to draft response for'),
+        tone: z.string().optional().describe('Email tone (default: professional)')
+    });
+    const config = {
+        description: 'Draft an email response',
+        argsSchema: argsSchema.shape
+    };
+    const handler = async (args, _extra)=>{
+        const { context, tone } = argsSchema.parse(args);
+        return {
+            messages: [
+                {
+                    role: 'system',
+                    content: {
+                        type: 'text',
+                        text: 'You are an expert email assistant.'
+                    }
+                },
+                {
+                    role: 'user',
+                    content: {
+                        type: 'text',
+                        text: `Draft a ${tone || 'professional'} email:\n\n${context}`
+                    }
+                }
+            ]
+        };
+    };
+    return {
+        name: 'draft-email',
+        config,
+        handler
+    };
+}

package/dist/esm/mcp/prompts/draft-email.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/kevin/Dev/Projects/ai/mcp-z/servers/mcp-gmail/src/mcp/prompts/draft-email.ts"],"sourcesContent":["import type { PromptModule } from '@mcp-z/server';\nimport type { RequestHandlerExtra } from '@modelcontextprotocol/sdk/shared/protocol.js';\nimport type { ServerNotification, ServerRequest } from '@modelcontextprotocol/sdk/types.js';\nimport { z } from 'zod';\n\nexport default function createPrompt() {\n  const argsSchema = z.object({\n    context: z.string().min(1).describe('Email context to draft response for'),\n    tone: z.string().optional().describe('Email tone (default: professional)'),\n  });\n\n  const config = {\n    description: 'Draft an email response',\n    argsSchema: argsSchema.shape,\n  };\n\n  const handler = async (args: { [x: string]: unknown }, _extra: RequestHandlerExtra<ServerRequest, ServerNotification>) => {\n    const { context, tone } = argsSchema.parse(args);\n    return {\n      messages: [\n        { role: 'system' as const, content: { type: 'text' as const, text: 'You are an expert email assistant.' } },\n        { role: 'user' as const, content: { type: 'text' as const, text: `Draft a ${tone || 'professional'} email:\\n\\n${context}` } },\n      ],\n    };\n  };\n\n  return {\n    name: 'draft-email',\n    config,\n    handler,\n  } satisfies PromptModule;\n}\n"],"names":["z","createPrompt","argsSchema","object","context","string","min","describe","tone","optional","config","description","shape","handler","args","_extra","parse","messages","role","content","type","text","name"],"mappings":"AAGA,SAASA,CAAC,QAAQ,MAAM;AAExB,eAAe,SAASC;IACtB,MAAMC,aAAaF,EAAEG,MAAM,CAAC;QAC1BC,SAASJ,EAAEK,MAAM,GAAGC,GAAG,CAAC,GAAGC,QAAQ,CAAC;QACpCC,MAAMR,EAAEK,MAAM,GAAGI,QAAQ,GAAGF,QAAQ,CAAC;IACvC;IAEA,MAAMG,SAAS;QACbC,aAAa;QACbT,YAAYA,WAAWU,KAAK;IAC9B;IAEA,MAAMC,UAAU,OAAOC,MAAgCC;QACrD,MAAM,EAAEX,OAAO,EAAEI,IAAI,EAAE,GAAGN,WAAWc,KAAK,CAACF;QAC3C,OAAO;YACLG,UAAU;gBACR;oBAAEC,MAAM;oBAAmBC,SAAS;wBAAEC,MAAM;wBAAiBC,MAAM;oBAAqC;gBAAE;gBAC1G;oBAAEH,MAAM;oBAAiBC,SAAS;wBAAEC,MAAM;wBAAiBC,MAAM,CAAC,QAAQ,EAAEb,QAAQ,eAAe,WAAW,EAAEJ,SAAS;oBAAC;gBAAE;aAC7H;QACH;IACF;IAEA,OAAO;QACLkB,MAAM;QACNZ;QACAG;IACF;AACF"}

package/dist/esm/mcp/prompts/index.d.ts

@@ -0,0 +1,2 @@
+export { default as draftEmail } from './draft-email.js';
+export { default as querySyntax } from './query-syntax.js';

package/dist/esm/mcp/prompts/index.js

@@ -0,0 +1,2 @@
+export { default as draftEmail } from './draft-email.js';
+export { default as querySyntax } from './query-syntax.js';

package/dist/esm/mcp/prompts/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/kevin/Dev/Projects/ai/mcp-z/servers/mcp-gmail/src/mcp/prompts/index.ts"],"sourcesContent":["export { default as draftEmail } from './draft-email.js';\nexport { default as querySyntax } from './query-syntax.js';\n"],"names":["default","draftEmail","querySyntax"],"mappings":"AAAA,SAASA,WAAWC,UAAU,QAAQ,mBAAmB;AACzD,SAASD,WAAWE,WAAW,QAAQ,oBAAoB"}

package/dist/esm/mcp/prompts/query-syntax.d.ts

@@ -0,0 +1,19 @@
+import type { RequestHandlerExtra } from '@modelcontextprotocol/sdk/shared/protocol.js';
+import type { ServerNotification, ServerRequest } from '@modelcontextprotocol/sdk/types.js';
+export default function createPrompt(): {
+    name: string;
+    config: {
+        description: string;
+    };
+    handler: (_args: {
+        [x: string]: unknown;
+    }, _extra: RequestHandlerExtra<ServerRequest, ServerNotification>) => Promise<{
+        messages: {
+            role: "user";
+            content: {
+                type: "text";
+                text: string;
+            };
+        }[];
+    }>;
+};

package/dist/esm/mcp/prompts/query-syntax.js

@@ -0,0 +1,74 @@
+export default function createPrompt() {
+    const config = {
+        description: 'Reference guide for Gmail query syntax'
+    };
+    const handler = async (_args, _extra)=>{
+        return {
+            messages: [
+                {
+                    role: 'user',
+                    content: {
+                        type: 'text',
+                        text: `# Gmail Query Syntax Reference
+
+## Logical Operators
+- \`$and\`: Array of conditions that ALL must match
+- \`$or\`: Array of conditions where ANY must match
+- \`$not\`: Condition that must NOT match
+
+## Email Address Fields
+- \`from\`, \`to\`, \`cc\`, \`bcc\`: String or field operators
+
+## Content Fields
+- \`subject\`: Search subject line
+- \`body\`: Search message body
+- \`text\`: Search all text content
+- \`fuzzyPhrase\`: Approximate phrase matching (words appear together)
+
+## Boolean Flags
+- \`hasAttachment\`: true/false
+- \`isRead\`: true/false
+
+## Date Range
+\`\`\`json
+{ "date": { "$gte": "2024-01-01", "$lt": "2024-12-31" } }
+\`\`\`
+
+## Gmail-Specific
+- \`categories\`: primary, social, promotions, updates, forums
+- \`label\`: User labels (case-sensitive, use gmail-labels-list to discover)
+- \`rawGmailQuery\`: Escape hatch for advanced Gmail syntax
+
+## Field Operators (for multi-value fields)
+- \`$any\`: OR - matches if ANY value matches
+- \`$all\`: AND - matches if ALL values match
+- \`$none\`: NOT - matches if NONE match
+
+## Example Queries
+\`\`\`json
+// Unread from specific sender
+{ "from": "boss@company.com", "isRead": false }
+
+// Recent with attachment
+{ "hasAttachment": true, "date": { "$gte": "2024-01-01" } }
+
+// Multiple senders
+{ "from": { "$any": ["alice@example.com", "bob@example.com"] } }
+
+// Complex: promotions OR social, unread
+{ "$and": [
+  { "categories": { "$any": ["promotions", "social"] } },
+  { "isRead": false }
+]}
+\`\`\``
+                    }
+                }
+            ]
+        };
+    };
+    return {
+        name: 'query-syntax',
+        config,
+        handler
+    };
+}

package/dist/esm/mcp/prompts/query-syntax.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/kevin/Dev/Projects/ai/mcp-z/servers/mcp-gmail/src/mcp/prompts/query-syntax.ts"],"sourcesContent":["import type { PromptModule } from '@mcp-z/server';\nimport type { RequestHandlerExtra } from '@modelcontextprotocol/sdk/shared/protocol.js';\nimport type { ServerNotification, ServerRequest } from '@modelcontextprotocol/sdk/types.js';\n\nexport default function createPrompt() {\n  const config = {\n    description: 'Reference guide for Gmail query syntax',\n  };\n\n  const handler = async (_args: { [x: string]: unknown }, _extra: RequestHandlerExtra<ServerRequest, ServerNotification>) => {\n    return {\n      messages: [\n        {\n          role: 'user' as const,\n          content: {\n            type: 'text' as const,\n            text: `# Gmail Query Syntax Reference\n\n## Logical Operators\n- \\`$and\\`: Array of conditions that ALL must match\n- \\`$or\\`: Array of conditions where ANY must match\n- \\`$not\\`: Condition that must NOT match\n\n## Email Address Fields\n- \\`from\\`, \\`to\\`, \\`cc\\`, \\`bcc\\`: String or field operators\n\n## Content Fields\n- \\`subject\\`: Search subject line\n- \\`body\\`: Search message body\n- \\`text\\`: Search all text content\n- \\`fuzzyPhrase\\`: Approximate phrase matching (words appear together)\n\n## Boolean Flags\n- \\`hasAttachment\\`: true/false\n- \\`isRead\\`: true/false\n\n## Date Range\n\\`\\`\\`json\n{ \"date\": { \"$gte\": \"2024-01-01\", \"$lt\": \"2024-12-31\" } }\n\\`\\`\\`\n\n## Gmail-Specific\n- \\`categories\\`: primary, social, promotions, updates, forums\n- \\`label\\`: User labels (case-sensitive, use gmail-labels-list to discover)\n- \\`rawGmailQuery\\`: Escape hatch for advanced Gmail syntax\n\n## Field Operators (for multi-value fields)\n- \\`$any\\`: OR - matches if ANY value matches\n- \\`$all\\`: AND - matches if ALL values match\n- \\`$none\\`: NOT - matches if NONE match\n\n## Example Queries\n\\`\\`\\`json\n// Unread from specific sender\n{ \"from\": \"boss@company.com\", \"isRead\": false }\n\n// Recent with attachment\n{ \"hasAttachment\": true, \"date\": { \"$gte\": \"2024-01-01\" } }\n\n// Multiple senders\n{ \"from\": { \"$any\": [\"alice@example.com\", \"bob@example.com\"] } }\n\n// Complex: promotions OR social, unread\n{ \"$and\": [\n  { \"categories\": { \"$any\": [\"promotions\", \"social\"] } },\n  { \"isRead\": false }\n]}\n\\`\\`\\``,\n          },\n        },\n      ],\n    };\n  };\n\n  return {\n    name: 'query-syntax',\n    config,\n    handler,\n  } satisfies PromptModule;\n}\n"],"names":["createPrompt","config","description","handler","_args","_extra","messages","role","content","type","text","name"],"mappings":"AAIA,eAAe,SAASA;IACtB,MAAMC,SAAS;QACbC,aAAa;IACf;IAEA,MAAMC,UAAU,OAAOC,OAAiCC;QACtD,OAAO;YACLC,UAAU;gBACR;oBACEC,MAAM;oBACNC,SAAS;wBACPC,MAAM;wBACNC,MAAM,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MAmDb,CAAC;oBACG;gBACF;aACD;QACH;IACF;IAEA,OAAO;QACLC,MAAM;QACNV;QACAE;IACF;AACF"}

package/dist/esm/mcp/resources/email.d.ts

@@ -0,0 +1,11 @@
+import { ResourceTemplate } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { RequestHandlerExtra } from '@modelcontextprotocol/sdk/shared/protocol.js';
+import type { ReadResourceResult, ServerNotification, ServerRequest } from '@modelcontextprotocol/sdk/types.js';
+export default function createResource(): {
+    name: string;
+    template: ResourceTemplate;
+    config: import("@modelcontextprotocol/sdk/server/mcp.js").ResourceMetadata;
+    handler: (uri: URL, variables: {
+        id: string;
+    }, extra: RequestHandlerExtra<ServerRequest, ServerNotification>) => Promise<ReadResourceResult>;
+};

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

@@ -0,0 +1,92 @@
+import { ResourceTemplate } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { google } from 'googleapis';
+import { extractEmails, extractFrom } from '../../email/parsing/message-extraction.js';
+import { toIsoUtc } from '../../lib/date-conversion.js';
+export default function createResource() {
+    const template = new ResourceTemplate('gmail://messages/{id}', {
+        list: undefined
+    });
+    const config = {
+        description: 'Gmail message metadata (lightweight: id, subject, from, to, date)',
+        mimeType: 'application/json'
+    };
+    const handler = async (uri, variables, extra)=>{
+        try {
+            var _fullData_id, _headersMap_Subject;
+            var _fullData_payload;
+            const { logger, authContext } = extra;
+            logger.info(variables, 'gmail-email resource fetch');
+            const gmail = google.gmail({
+                version: 'v1',
+                auth: authContext.auth
+            });
+            const response = await gmail.users.messages.get({
+                userId: 'me',
+                id: variables.id,
+                format: 'metadata',
+                metadataHeaders: [
+                    'From',
+                    'To',
+                    'Subject',
+                    'Date'
+                ]
+            });
+            const fullData = response.data;
+            if (!fullData) {
+                throw new Error('Message not found');
+            }
+            // Extract headers
+            const headers = fullData === null || fullData === void 0 ? void 0 : (_fullData_payload = fullData.payload) === null || _fullData_payload === void 0 ? void 0 : _fullData_payload.headers;
+            const headersArray = Array.isArray(headers) ? headers : [];
+            const headersMap = Object.fromEntries(headersArray.map((h)=>{
+                var _header_name, _header_value;
+                const header = h;
+                return [
+                    String((_header_name = header.name) !== null && _header_name !== void 0 ? _header_name : ''),
+                    String((_header_value = header.value) !== null && _header_value !== void 0 ? _header_value : '')
+                ];
+            }));
+            const fromInfo = extractFrom(headersMap.From);
+            const toStr = extractEmails(headersMap.To).join(', ');
+            // Return lightweight metadata only (no body/snippet)
+            const metadata = {
+                id: (_fullData_id = fullData.id) !== null && _fullData_id !== void 0 ? _fullData_id : variables.id,
+                subject: (_headersMap_Subject = headersMap.Subject) !== null && _headersMap_Subject !== void 0 ? _headersMap_Subject : '',
+                from: (fromInfo === null || fromInfo === void 0 ? void 0 : fromInfo.address) || headersMap.From,
+                to: toStr,
+                date: toIsoUtc(headersMap.Date) || headersMap.Date
+            };
+            return {
+                contents: [
+                    {
+                        uri: uri.href,
+                        mimeType: 'application/json',
+                        text: JSON.stringify(metadata)
+                    }
+                ]
+            };
+        } catch (e) {
+            var _ref;
+            const { logger } = extra;
+            logger.error(e, 'gmail-email resource fetch failed');
+            const error = e;
+            return {
+                contents: [
+                    {
+                        uri: uri.href,
+                        mimeType: 'application/json',
+                        text: JSON.stringify({
+                            error: String((_ref = error === null || error === void 0 ? void 0 : error.message) !== null && _ref !== void 0 ? _ref : e)
+                        })
+                    }
+                ]
+            };
+        }
+    };
+    return {
+        name: 'email',
+        template,
+        config,
+        handler
+    };
+}

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

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

package/dist/esm/mcp/resources/index.d.ts

@@ -0,0 +1 @@
+export { default as email } from './email.js';

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

@@ -0,0 +1 @@
+export { default as email } from './email.js';

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

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/kevin/Dev/Projects/ai/mcp-z/servers/mcp-gmail/src/mcp/resources/index.ts"],"sourcesContent":["export { default as email } from './email.js';\n"],"names":["default","email"],"mappings":"AAAA,SAASA,WAAWC,KAAK,QAAQ,aAAa"}