@aaronsb/google-workspace-mcp 2.0.0-alpha.4

package/build/services/calendar/patch.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Calendar patch — domain-specific hooks for the calendar service.
+ *
+ * Key customizations:
+ * - List: default timeMin to today start
+ * - Agenda: raw text passthrough with event refs extraction
+ * - Create: custom response formatting with event details
+ * - Delete: custom confirmation message
+ */
+import type { ServicePatch } from '../../factory/types.js';
+export declare const calendarPatch: ServicePatch;

package/build/services/calendar/patch.js

@@ -0,0 +1,116 @@
+/**
+ * Calendar patch — domain-specific hooks for the calendar service.
+ *
+ * Key customizations:
+ * - List: default timeMin to today start
+ * - Agenda: raw text passthrough with event refs extraction
+ * - Create: custom response formatting with event details
+ * - Delete: custom confirmation message
+ */
+import { execute } from '../../executor/gws.js';
+import { formatEventList, formatEventDetail } from '../../server/formatting/markdown.js';
+import { nextSteps } from '../../server/formatting/next-steps.js';
+import { requireString } from '../../server/handlers/validate.js';
+/** Format calendar list — name, access role, primary flag. */
+function formatCalendarList(data) {
+    const raw = data;
+    const items = (raw?.items ?? []);
+    if (items.length === 0) {
+        return { text: 'No calendars found.', refs: { count: 0 } };
+    }
+    const lines = items.map(cal => {
+        const id = String(cal.id ?? '');
+        const summary = String(cal.summary ?? '(unnamed)');
+        const role = String(cal.accessRole ?? '');
+        const primary = cal.primary ? ' ★' : '';
+        return `${summary}${primary} | ${role} | ${id}`;
+    });
+    return {
+        text: `## Calendars (${items.length})\n\n${lines.join('\n')}`,
+        refs: {
+            count: items.length,
+            calendarId: String(items[0]?.id ?? ''),
+            calendars: items.map(c => ({ id: c.id, summary: c.summary })),
+        },
+    };
+}
+export const calendarPatch = {
+    beforeExecute: {
+        list: async (args, ctx) => {
+            // Inject default timeMin (today start) if not provided
+            if (!ctx.params.timeMin) {
+                const now = new Date();
+                const todayStart = new Date(now.getFullYear(), now.getMonth(), now.getDate()).toISOString();
+                // Patch the --params JSON to include timeMin
+                const paramsIdx = args.indexOf('--params');
+                if (paramsIdx !== -1) {
+                    const gwsParams = JSON.parse(args[paramsIdx + 1]);
+                    if (!gwsParams.timeMin) {
+                        gwsParams.timeMin = todayStart;
+                    }
+                    args[paramsIdx + 1] = JSON.stringify(gwsParams);
+                }
+            }
+            return args;
+        },
+    },
+    formatList: (data, ctx) => {
+        switch (ctx.operation) {
+            case 'calendars':
+                return formatCalendarList(data);
+            default:
+                return formatEventList(data);
+        }
+    },
+    formatDetail: (data) => formatEventDetail(data),
+    customHandlers: {
+        agenda: async (params, account) => {
+            const result = await execute(['calendar', '+agenda'], { account });
+            const data = result.data;
+            const text = typeof result.data === 'string' ? result.data : JSON.stringify(result.data, null, 2);
+            const events = Array.isArray(data?.events) ? data.events : [];
+            return {
+                text: text + nextSteps('calendar', 'agenda', { email: account }),
+                refs: {
+                    count: events.length,
+                    eventId: events[0]?.id,
+                    events: events.map((e) => e.id),
+                },
+            };
+        },
+        create: async (params, account) => {
+            const summary = requireString(params, 'summary');
+            const start = requireString(params, 'start');
+            const end = requireString(params, 'end');
+            const args = ['calendar', '+insert', '--summary', summary, '--start', start, '--end', end];
+            if (params.description)
+                args.push('--description', String(params.description));
+            if (params.location)
+                args.push('--location', String(params.location));
+            if (params.attendees)
+                args.push('--attendees', String(params.attendees));
+            const result = await execute(args, { account });
+            const data = result.data;
+            return {
+                text: `Event created: **${summary}**\n\n` +
+                    `**When:** ${start} – ${end}\n` +
+                    (params.location ? `**Where:** ${params.location}\n` : '') +
+                    `**Event ID:** ${data.id ?? 'unknown'}` +
+                    nextSteps('calendar', 'create', { email: account }),
+                refs: { id: data.id, eventId: data.id, summary, start, end },
+            };
+        },
+        delete: async (params, account) => {
+            const eventId = requireString(params, 'eventId');
+            await execute([
+                'calendar', 'events', 'delete',
+                '--params', JSON.stringify({ calendarId: 'primary', eventId }),
+            ], { account });
+            return {
+                text: `Event deleted: ${eventId}` + nextSteps('calendar', 'delete', { email: account }),
+                refs: { eventId, status: 'deleted' },
+            };
+        },
+    },
+};
+//# sourceMappingURL=patch.js.map

package/build/services/calendar/patch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"patch.js","sourceRoot":"","sources":["../../../src/services/calendar/patch.ts"],"names":[],"mappings":"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"}

package/build/services/drive/patch.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Drive patch — domain-specific hooks for the drive service.
+ *
+ * Key customizations:
+ * - Custom formatters for file lists and details
+ * - Upload: custom handler with positional file path arg
+ * - Download/Export: save to workspace via gws --output, return inline for text
+ */
+import type { ServicePatch } from '../../factory/types.js';
+export declare const drivePatch: ServicePatch;

package/build/services/drive/patch.js

@@ -0,0 +1,131 @@
+/**
+ * Drive patch — domain-specific hooks for the drive service.
+ *
+ * Key customizations:
+ * - Custom formatters for file lists and details
+ * - Upload: custom handler with positional file path arg
+ * - Download/Export: save to workspace via gws --output, return inline for text
+ */
+import * as fs from 'node:fs/promises';
+import { execute } from '../../executor/gws.js';
+import { formatFileList, formatFileDetail } from '../../server/formatting/markdown.js';
+import { nextSteps } from '../../server/formatting/next-steps.js';
+import { requireString } from '../../server/handlers/validate.js';
+import { ensureWorkspaceDir, resolveWorkspacePath, verifyPathSafety } from '../../executor/workspace.js';
+import { isTextFile, formatFileOutput } from '../../executor/file-output.js';
+/** Read a file from workspace and build the output result with optional inline content. */
+async function readWorkspaceFile(filePath, filename, mimeType) {
+    const stat = await fs.stat(filePath);
+    const result = {
+        filename,
+        path: filePath,
+        size: stat.size,
+    };
+    if (isTextFile(filename, mimeType) && stat.size < 100_000) {
+        result.content = await fs.readFile(filePath, 'utf-8');
+    }
+    return result;
+}
+export const drivePatch = {
+    formatList: (data) => formatFileList(data),
+    formatDetail: (data) => formatFileDetail(data),
+    customHandlers: {
+        upload: async (params, account) => {
+            const filePath = requireString(params, 'filePath');
+            const args = ['drive', '+upload', filePath];
+            if (params.name)
+                args.push('--name', String(params.name));
+            if (params.parentFolderId)
+                args.push('--parent', String(params.parentFolderId));
+            const result = await execute(args, { account });
+            const data = result.data;
+            return {
+                text: `File uploaded: **${data.name ?? filePath}**\n\n**File ID:** ${data.id ?? 'unknown'}` +
+                    nextSteps('drive', 'upload', { email: account }),
+                refs: { id: data.id, fileId: data.id, name: data.name },
+            };
+        },
+        download: async (params, account) => {
+            const fileId = requireString(params, 'fileId');
+            // Get file metadata for filename and mime type
+            const metaResult = await execute([
+                'drive', 'files', 'get',
+                '--params', JSON.stringify({ fileId, fields: 'name,mimeType' }),
+            ], { account });
+            const meta = metaResult.data;
+            const filename = String(params.outputPath || meta.name || `file-${fileId}`);
+            const mimeType = String(meta.mimeType || '');
+            // Ensure workspace and resolve output path
+            const wsStatus = await ensureWorkspaceDir();
+            if (!wsStatus.valid)
+                throw new Error(`Workspace invalid: ${wsStatus.warning}`);
+            const outputPath = resolveWorkspacePath(filename);
+            await verifyPathSafety(outputPath);
+            // Download directly to disk via --output (preserves binary integrity)
+            await execute([
+                'drive', 'files', 'get',
+                '--params', JSON.stringify({ fileId, alt: 'media' }),
+                '--output', outputPath,
+            ], { account });
+            const output = await readWorkspaceFile(outputPath, filename, mimeType);
+            return {
+                text: formatFileOutput(output) + nextSteps('drive', 'download', { email: account }),
+                refs: {
+                    fileId,
+                    filename: output.filename,
+                    path: output.path,
+                    size: output.size,
+                    ...(output.content ? { content: output.content } : {}),
+                },
+            };
+        },
+        export: async (params, account) => {
+            const fileId = requireString(params, 'fileId');
+            const mimeType = requireString(params, 'mimeType');
+            // Map MIME type to file extension
+            const extMap = {
+                'application/pdf': '.pdf',
+                'text/csv': '.csv',
+                'text/plain': '.txt',
+                'text/html': '.html',
+                'application/vnd.openxmlformats-officedocument.wordprocessingml.document': '.docx',
+                'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet': '.xlsx',
+                'application/vnd.openxmlformats-officedocument.presentationml.presentation': '.pptx',
+            };
+            const ext = extMap[mimeType] || '';
+            // Get source file name
+            const metaResult = await execute([
+                'drive', 'files', 'get',
+                '--params', JSON.stringify({ fileId, fields: 'name' }),
+            ], { account });
+            const meta = metaResult.data;
+            const baseName = String(meta.name || `export-${fileId}`).replace(/\.[^.]+$/, '');
+            const filename = String(params.outputPath || `${baseName}${ext}`);
+            // Ensure workspace and resolve output path
+            const wsStatus = await ensureWorkspaceDir();
+            if (!wsStatus.valid)
+                throw new Error(`Workspace invalid: ${wsStatus.warning}`);
+            const outputPath = resolveWorkspacePath(filename);
+            await verifyPathSafety(outputPath);
+            // Export directly to disk via --output (preserves binary integrity)
+            await execute([
+                'drive', 'files', 'export',
+                '--params', JSON.stringify({ fileId, mimeType }),
+                '--output', outputPath,
+            ], { account });
+            const output = await readWorkspaceFile(outputPath, filename, mimeType);
+            return {
+                text: formatFileOutput(output) + nextSteps('drive', 'export', { email: account }),
+                refs: {
+                    fileId,
+                    filename: output.filename,
+                    path: output.path,
+                    size: output.size,
+                    mimeType,
+                    ...(output.content ? { content: output.content } : {}),
+                },
+            };
+        },
+    },
+};
+//# sourceMappingURL=patch.js.map

package/build/services/drive/patch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"patch.js","sourceRoot":"","sources":["../../../src/services/drive/patch.ts"],"names":[],"mappings":"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"}

package/build/services/gmail/attachments.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Gmail attachment handler — downloads email attachments to the workspace directory.
+ *
+ * The agent discovers attachments via the `read` operation, which lists
+ * filenames and sizes. Then calls `getAttachment` with just the messageId
+ * and filename — we resolve the attachment ID internally by re-reading
+ * the message payload. This keeps long Gmail attachment IDs out of the
+ * agent's context.
+ *
+ * Flow: read → see filenames → getAttachment(messageId, filename) → file in workspace
+ */
+import type { HandlerResponse } from '../../server/formatting/markdown.js';
+/**
+ * Download an email attachment by filename.
+ *
+ * Resolves the attachment ID internally by reading the message payload —
+ * the agent only needs to provide messageId and filename (from the read response).
+ */
+export declare function handleGetAttachment(params: Record<string, unknown>, account: string): Promise<HandlerResponse>;

package/build/services/gmail/attachments.js

@@ -0,0 +1,90 @@
+/**
+ * Gmail attachment handler — downloads email attachments to the workspace directory.
+ *
+ * The agent discovers attachments via the `read` operation, which lists
+ * filenames and sizes. Then calls `getAttachment` with just the messageId
+ * and filename — we resolve the attachment ID internally by re-reading
+ * the message payload. This keeps long Gmail attachment IDs out of the
+ * agent's context.
+ *
+ * Flow: read → see filenames → getAttachment(messageId, filename) → file in workspace
+ */
+import { execute } from '../../executor/gws.js';
+import { requireString } from '../../server/handlers/validate.js';
+import { saveToWorkspace, formatFileOutput } from '../../executor/file-output.js';
+/** Walk message parts recursively to find attachments. */
+function findAttachments(parts) {
+    const attachments = [];
+    for (const part of parts) {
+        const p = part;
+        const filename = p.filename;
+        const body = p.body;
+        const attachmentId = body?.attachmentId;
+        if (filename && attachmentId) {
+            attachments.push({
+                filename,
+                attachmentId,
+                mimeType: String(p.mimeType ?? ''),
+                size: Number(body?.size ?? 0),
+            });
+        }
+        if (Array.isArray(p.parts)) {
+            attachments.push(...findAttachments(p.parts));
+        }
+    }
+    return attachments;
+}
+/**
+ * Download an email attachment by filename.
+ *
+ * Resolves the attachment ID internally by reading the message payload —
+ * the agent only needs to provide messageId and filename (from the read response).
+ */
+export async function handleGetAttachment(params, account) {
+    const messageId = requireString(params, 'messageId');
+    const filename = requireString(params, 'filename');
+    // Read the message to find the attachment ID for this filename
+    const msgResult = await execute([
+        'gmail', 'users', 'messages', 'get',
+        '--params', JSON.stringify({ userId: 'me', id: messageId }),
+    ], { account });
+    const msg = msgResult.data;
+    const payload = msg.payload;
+    const allAttachments = payload?.parts ? findAttachments(payload.parts) : [];
+    const match = allAttachments.find(a => a.filename === filename);
+    if (!match) {
+        const available = allAttachments.map(a => a.filename).join(', ') || '(none)';
+        throw new Error(`Attachment '${filename}' not found in message ${messageId}. ` +
+            `Available attachments: ${available}`);
+    }
+    // Fetch the attachment data
+    const result = await execute([
+        'gmail', 'users', 'messages', 'attachments', 'get',
+        '--params', JSON.stringify({
+            userId: 'me',
+            messageId,
+            id: match.attachmentId,
+        }),
+    ], { account });
+    const data = result.data;
+    const base64Data = String(data.data ?? '');
+    if (!base64Data) {
+        throw new Error('Attachment data is empty');
+    }
+    // Decode base64url to buffer
+    const base64Standard = base64Data.replace(/-/g, '+').replace(/_/g, '/');
+    const buffer = Buffer.from(base64Standard, 'base64');
+    // Save to workspace and return inline content for text files
+    const output = await saveToWorkspace(filename, buffer, match.mimeType);
+    return {
+        text: formatFileOutput(output),
+        refs: {
+            filename: output.filename,
+            path: output.path,
+            size: output.size,
+            messageId,
+            ...(output.content ? { content: output.content } : {}),
+        },
+    };
+}
+//# sourceMappingURL=attachments.js.map

package/build/services/gmail/attachments.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attachments.js","sourceRoot":"","sources":["../../../src/services/gmail/attachments.ts"],"names":[],"mappings":"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"}

package/build/services/gmail/patch.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Gmail patch — domain-specific hooks for the email service.
+ *
+ * Key customizations:
+ * - Search hydration: messages.list only returns IDs, so we fetch metadata
+ * - Custom formatters: pipe-delimited list, header-extracted detail
+ * - Custom handlers: send/reply use specific response formatting
+ */
+import type { ServicePatch } from '../../factory/types.js';
+export declare const gmailPatch: ServicePatch;

package/build/services/gmail/patch.js

@@ -0,0 +1,226 @@
+/**
+ * Gmail patch — domain-specific hooks for the email service.
+ *
+ * Key customizations:
+ * - Search hydration: messages.list only returns IDs, so we fetch metadata
+ * - Custom formatters: pipe-delimited list, header-extracted detail
+ * - Custom handlers: send/reply use specific response formatting
+ */
+import { execute } from '../../executor/gws.js';
+import { formatEmailList, formatEmailDetail } from '../../server/formatting/markdown.js';
+import { nextSteps } from '../../server/formatting/next-steps.js';
+import { requireString } from '../../server/handlers/validate.js';
+import { handleGetAttachment } from './attachments.js';
+/**
+ * Hydrate message IDs with metadata (From, Subject, Date, snippet).
+ * Reused from the original email handler.
+ */
+async function hydrateMessages(messageIds, account) {
+    return Promise.all(messageIds.map(async (msg) => {
+        try {
+            const result = await execute([
+                'gmail', 'users', 'messages', 'get',
+                '--params', JSON.stringify({
+                    userId: 'me',
+                    id: msg.id,
+                    format: 'metadata',
+                    metadataHeaders: ['From', 'Subject', 'Date'],
+                }),
+            ], { account });
+            const data = result.data;
+            const headers = (data.payload?.headers ?? []);
+            const getHeader = (name) => headers.find(h => h.name.toLowerCase() === name.toLowerCase())?.value;
+            return {
+                id: data.id,
+                threadId: data.threadId,
+                from: getHeader('from'),
+                subject: getHeader('subject'),
+                date: getHeader('date'),
+                snippet: data.snippet,
+            };
+        }
+        catch {
+            return { id: msg.id };
+        }
+    }));
+}
+/** Format labels list — name, type, unread count. */
+function formatLabelList(data) {
+    const raw = data;
+    const labels = (raw?.labels ?? []);
+    if (labels.length === 0) {
+        return { text: 'No labels found.', refs: { count: 0 } };
+    }
+    // Separate system and user labels
+    const system = labels.filter(l => l.type === 'system');
+    const user = labels.filter(l => l.type === 'user');
+    const formatLabel = (l) => {
+        const id = String(l.id ?? '');
+        const name = String(l.name ?? '');
+        const unread = l.messagesUnread ? ` (${l.messagesUnread} unread)` : '';
+        return `${id} | ${name}${unread}`;
+    };
+    const parts = [];
+    if (user.length > 0) {
+        parts.push(`## User Labels (${user.length})\n`);
+        parts.push(...user.map(formatLabel));
+    }
+    if (system.length > 0) {
+        parts.push('', `## System Labels (${system.length})\n`);
+        parts.push(...system.map(formatLabel));
+    }
+    return {
+        text: parts.join('\n'),
+        refs: {
+            count: labels.length,
+            labels: labels.map(l => ({ id: l.id, name: l.name })),
+        },
+    };
+}
+/** Format threads list — thread ID, snippet, message count. */
+function formatThreadList(data) {
+    const raw = data;
+    const threads = (raw?.threads ?? []);
+    if (threads.length === 0) {
+        return { text: 'No threads found.', refs: { count: 0 } };
+    }
+    const lines = threads.map(t => {
+        const id = String(t.id ?? '');
+        const snippet = String(t.snippet ?? '').slice(0, 80);
+        return `${id} | ${snippet}`;
+    });
+    return {
+        text: `## Threads (${threads.length})\n\n${lines.join('\n')}`,
+        refs: {
+            count: threads.length,
+            threadId: String(threads[0]?.id ?? ''),
+            threads: threads.map(t => String(t.id ?? '')),
+        },
+    };
+}
+/** Format thread detail — all messages in the thread. */
+function formatThreadDetail(data) {
+    const raw = data;
+    const messages = (raw?.messages ?? []);
+    const threadId = String(raw?.id ?? '');
+    if (messages.length === 0) {
+        return { text: 'Empty thread.', refs: { threadId } };
+    }
+    const parts = [`## Thread (${messages.length} messages)\n`];
+    for (const msg of messages) {
+        const payload = msg.payload;
+        const headers = (payload?.headers ?? []);
+        const getHeader = (name) => headers.find(h => h.name.toLowerCase() === name.toLowerCase())?.value ?? '';
+        const from = getHeader('from');
+        const date = getHeader('date');
+        const subject = getHeader('subject');
+        const snippet = String(msg.snippet ?? '');
+        parts.push(`**${from}** — ${date}`);
+        if (subject)
+            parts.push(`Subject: ${subject}`);
+        parts.push(snippet, '');
+    }
+    return {
+        text: parts.join('\n'),
+        refs: {
+            threadId,
+            messageCount: messages.length,
+            messageId: String(messages[messages.length - 1]?.id ?? ''),
+            messages: messages.map(m => String(m.id ?? '')),
+        },
+    };
+}
+export const gmailPatch = {
+    afterExecute: {
+        search: async (result, ctx) => {
+            // messages.list returns bare IDs — hydrate with metadata
+            const raw = result;
+            const ids = (raw?.messages ?? []);
+            if (ids.length === 0)
+                return { messages: [] };
+            const messages = await hydrateMessages(ids, ctx.account);
+            return { messages };
+        },
+    },
+    formatList: (data, ctx) => {
+        switch (ctx.operation) {
+            case 'labels':
+                return formatLabelList(data);
+            case 'threads':
+                return formatThreadList(data);
+            default:
+                return formatEmailList(data);
+        }
+    },
+    formatDetail: (data, ctx) => {
+        switch (ctx.operation) {
+            case 'getThread':
+                return formatThreadDetail(data);
+            default:
+                return formatEmailDetail(data);
+        }
+    },
+    customHandlers: {
+        send: async (params, account) => {
+            const to = requireString(params, 'to');
+            const subject = requireString(params, 'subject');
+            const body = requireString(params, 'body');
+            const args = ['gmail', '+send', '--to', to, '--subject', subject, '--body', body];
+            if (params.cc)
+                args.push('--cc', String(params.cc));
+            if (params.bcc)
+                args.push('--bcc', String(params.bcc));
+            const result = await execute(args, { account });
+            const data = result.data;
+            return {
+                text: `Email sent to ${to}.\n\n**Subject:** ${subject}\n**Message ID:** ${data.id ?? 'unknown'}` +
+                    nextSteps('email', 'send', { email: account }),
+                refs: { id: data.id, threadId: data.threadId, to, subject },
+            };
+        },
+        modify: async (params, account) => {
+            const messageId = requireString(params, 'messageId');
+            const addLabelIds = params.addLabelIds
+                ? String(params.addLabelIds).split(',').map(s => s.trim())
+                : [];
+            const removeLabelIds = params.removeLabelIds
+                ? String(params.removeLabelIds).split(',').map(s => s.trim())
+                : [];
+            if (addLabelIds.length === 0 && removeLabelIds.length === 0) {
+                throw new Error('At least one of addLabelIds or removeLabelIds is required');
+            }
+            const body = {};
+            if (addLabelIds.length > 0)
+                body.addLabelIds = addLabelIds;
+            if (removeLabelIds.length > 0)
+                body.removeLabelIds = removeLabelIds;
+            const result = await execute([
+                'gmail', 'users', 'messages', 'modify',
+                '--params', JSON.stringify({ userId: 'me', id: messageId }),
+                '--json', JSON.stringify(body),
+            ], { account });
+            const data = result.data;
+            const labels = (data.labelIds ?? []);
+            return {
+                text: `Labels updated on ${messageId}.\n\n**Current labels:** ${labels.join(', ') || '(none)'}` +
+                    nextSteps('email', 'modify', { email: account }),
+                refs: { messageId, labelIds: labels },
+            };
+        },
+        getAttachment: handleGetAttachment,
+        reply: async (params, account) => {
+            const messageId = requireString(params, 'messageId');
+            const body = requireString(params, 'body');
+            const result = await execute([
+                'gmail', '+reply', '--message-id', messageId, '--body', body,
+            ], { account });
+            const data = result.data;
+            return {
+                text: `Reply sent.\n\n**Message ID:** ${data.id ?? 'unknown'}` +
+                    nextSteps('email', 'reply', { email: account }),
+                refs: { id: data.id, threadId: data.threadId, messageId },
+            };
+        },
+    },
+};
+//# sourceMappingURL=patch.js.map