@mcp-z/mcp-gmail 1.0.0

package/dist/cjs/mcp/tools/message-search.d.ts

@@ -0,0 +1,182 @@
+import type { EnrichedExtra } from '@mcp-z/oauth-google';
+import { z } from 'zod';
+declare const inputSchema: z.ZodObject<{
+    shape: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
+        objects: "objects";
+        arrays: "arrays";
+    }>>>;
+    contentType: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
+        text: "text";
+        html: "html";
+    }>>>;
+    excludeThreadHistory: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    pageSize: z.ZodDefault<z.ZodOptional<z.ZodCoercedNumber<unknown>>>;
+    pageToken: z.ZodOptional<z.ZodString>;
+    query: z.ZodOptional<z.ZodType<import("../../schemas/gmail-query-schema.js").GmailQuery, unknown, z.core.$ZodTypeInternals<import("../../schemas/gmail-query-schema.js").GmailQuery, unknown>>>;
+    fields: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+declare const outputSchema: z.ZodUnion<readonly [z.ZodObject<{
+    type: z.ZodLiteral<"success">;
+    shape: z.ZodLiteral<"objects">;
+    items: z.ZodArray<z.ZodObject<{
+        id: z.ZodOptional<z.ZodString>;
+        threadId: z.ZodOptional<z.ZodString>;
+        subject: z.ZodOptional<z.ZodString>;
+        from: z.ZodOptional<z.ZodString>;
+        fromName: z.ZodOptional<z.ZodString>;
+        to: z.ZodOptional<z.ZodString>;
+        cc: z.ZodOptional<z.ZodString>;
+        bcc: z.ZodOptional<z.ZodString>;
+        date: z.ZodOptional<z.ZodString>;
+        receivedDateTime: z.ZodOptional<z.ZodString>;
+        snippet: z.ZodOptional<z.ZodString>;
+        isRead: z.ZodOptional<z.ZodBoolean>;
+        isImportant: z.ZodOptional<z.ZodBoolean>;
+        hasAttachments: z.ZodOptional<z.ZodBoolean>;
+        attachmentCount: z.ZodOptional<z.ZodNumber>;
+        labelIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        folderName: z.ZodOptional<z.ZodString>;
+        body: z.ZodOptional<z.ZodString>;
+        bodyContentType: z.ZodOptional<z.ZodEnum<{
+            text: "text";
+            html: "html";
+        }>>;
+        attachments: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            filename: z.ZodString;
+            mimeType: z.ZodString;
+            size: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>>;
+    nextPageToken: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"success">;
+    shape: z.ZodLiteral<"arrays">;
+    columns: z.ZodArray<z.ZodString>;
+    rows: z.ZodArray<z.ZodArray<z.ZodUnknown>>;
+    nextPageToken: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"auth_required">;
+    provider: z.ZodString;
+    message: z.ZodString;
+    url: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>]>;
+export type Input = z.infer<typeof inputSchema>;
+export type Output = z.infer<typeof outputSchema>;
+declare function handler({ query, pageSize, pageToken, fields, shape, contentType, excludeThreadHistory }: Input, extra: EnrichedExtra): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    structuredContent: {
+        result: {
+            type: "success";
+            shape: "objects";
+            items: {
+                id?: string;
+                threadId?: string;
+                subject?: string;
+                from?: string;
+                fromName?: string;
+                to?: string;
+                cc?: string;
+                bcc?: string;
+                date?: string;
+                receivedDateTime?: string;
+                snippet?: string;
+                isRead?: boolean;
+                isImportant?: boolean;
+                hasAttachments?: boolean;
+                attachmentCount?: number;
+                labelIds?: string[];
+                folderName?: string;
+                body?: string;
+                bodyContentType?: "text" | "html";
+                attachments?: {
+                    id: string;
+                    filename: string;
+                    mimeType: string;
+                    size?: number;
+                }[];
+            }[];
+            nextPageToken?: string;
+        } | {
+            type: "success";
+            shape: "arrays";
+            columns: string[];
+            rows: unknown[][];
+            nextPageToken?: string;
+        };
+    };
+}>;
+export default function createTool(): {
+    name: string;
+    config: {
+        readonly description: "Search Gmail messages using structured query objects with flexible field selection.";
+        readonly inputSchema: z.ZodObject<{
+            shape: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
+                objects: "objects";
+                arrays: "arrays";
+            }>>>;
+            contentType: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
+                text: "text";
+                html: "html";
+            }>>>;
+            excludeThreadHistory: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+            pageSize: z.ZodDefault<z.ZodOptional<z.ZodCoercedNumber<unknown>>>;
+            pageToken: z.ZodOptional<z.ZodString>;
+            query: z.ZodOptional<z.ZodType<import("../../schemas/gmail-query-schema.js").GmailQuery, unknown, z.core.$ZodTypeInternals<import("../../schemas/gmail-query-schema.js").GmailQuery, unknown>>>;
+            fields: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+        readonly outputSchema: z.ZodObject<{
+            result: z.ZodUnion<readonly [z.ZodObject<{
+                type: z.ZodLiteral<"success">;
+                shape: z.ZodLiteral<"objects">;
+                items: z.ZodArray<z.ZodObject<{
+                    id: z.ZodOptional<z.ZodString>;
+                    threadId: z.ZodOptional<z.ZodString>;
+                    subject: z.ZodOptional<z.ZodString>;
+                    from: z.ZodOptional<z.ZodString>;
+                    fromName: z.ZodOptional<z.ZodString>;
+                    to: z.ZodOptional<z.ZodString>;
+                    cc: z.ZodOptional<z.ZodString>;
+                    bcc: z.ZodOptional<z.ZodString>;
+                    date: z.ZodOptional<z.ZodString>;
+                    receivedDateTime: z.ZodOptional<z.ZodString>;
+                    snippet: z.ZodOptional<z.ZodString>;
+                    isRead: z.ZodOptional<z.ZodBoolean>;
+                    isImportant: z.ZodOptional<z.ZodBoolean>;
+                    hasAttachments: z.ZodOptional<z.ZodBoolean>;
+                    attachmentCount: z.ZodOptional<z.ZodNumber>;
+                    labelIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                    folderName: z.ZodOptional<z.ZodString>;
+                    body: z.ZodOptional<z.ZodString>;
+                    bodyContentType: z.ZodOptional<z.ZodEnum<{
+                        text: "text";
+                        html: "html";
+                    }>>;
+                    attachments: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                        id: z.ZodString;
+                        filename: z.ZodString;
+                        mimeType: z.ZodString;
+                        size: z.ZodOptional<z.ZodNumber>;
+                    }, z.core.$strip>>>;
+                }, z.core.$strip>>;
+                nextPageToken: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>, z.ZodObject<{
+                type: z.ZodLiteral<"success">;
+                shape: z.ZodLiteral<"arrays">;
+                columns: z.ZodArray<z.ZodString>;
+                rows: z.ZodArray<z.ZodArray<z.ZodUnknown>>;
+                nextPageToken: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>, z.ZodObject<{
+                type: z.ZodLiteral<"auth_required">;
+                provider: z.ZodString;
+                message: z.ZodString;
+                url: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>]>;
+        }, z.core.$strip>;
+    };
+    handler: typeof handler;
+};
+export {};

package/dist/cjs/mcp/tools/message-search.js

@@ -0,0 +1,405 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+Object.defineProperty(exports, "default", {
+    enumerable: true,
+    get: function() {
+        return createTool;
+    }
+});
+var _types = require("@modelcontextprotocol/sdk/types.js");
+var _email = require("@mcp-z/email");
+var _oauthgoogle = require("@mcp-z/oauth-google");
+var _server = require("@mcp-z/server");
+var _googleapis = require("googleapis");
+var _zod = require("zod");
+var _constantsts = require("../../constants.js");
+var _htmlprocessing = require("../../email/parsing/html-processing.js");
+var _executequery = require("../../email/querying/execute-query.js");
+var _gmailqueryschema = require("../../schemas/gmail-query-schema.js");
+function asyncGeneratorStep(gen, resolve, reject, _next, _throw, key, arg) {
+    try {
+        var info = gen[key](arg);
+        var value = info.value;
+    } catch (error) {
+        reject(error);
+        return;
+    }
+    if (info.done) {
+        resolve(value);
+    } else {
+        Promise.resolve(value).then(_next, _throw);
+    }
+}
+function _async_to_generator(fn) {
+    return function() {
+        var self = this, args = arguments;
+        return new Promise(function(resolve, reject) {
+            var gen = fn.apply(self, args);
+            function _next(value) {
+                asyncGeneratorStep(gen, resolve, reject, _next, _throw, "next", value);
+            }
+            function _throw(err) {
+                asyncGeneratorStep(gen, resolve, reject, _next, _throw, "throw", err);
+            }
+            _next(undefined);
+        });
+    };
+}
+function _define_property(obj, key, value) {
+    if (key in obj) {
+        Object.defineProperty(obj, key, {
+            value: value,
+            enumerable: true,
+            configurable: true,
+            writable: true
+        });
+    } else {
+        obj[key] = value;
+    }
+    return obj;
+}
+function _instanceof(left, right) {
+    if (right != null && typeof Symbol !== "undefined" && right[Symbol.hasInstance]) {
+        return !!right[Symbol.hasInstance](left);
+    } else {
+        return left instanceof right;
+    }
+}
+function _object_spread(target) {
+    for(var i = 1; i < arguments.length; i++){
+        var source = arguments[i] != null ? arguments[i] : {};
+        var ownKeys = Object.keys(source);
+        if (typeof Object.getOwnPropertySymbols === "function") {
+            ownKeys = ownKeys.concat(Object.getOwnPropertySymbols(source).filter(function(sym) {
+                return Object.getOwnPropertyDescriptor(source, sym).enumerable;
+            }));
+        }
+        ownKeys.forEach(function(key) {
+            _define_property(target, key, source[key]);
+        });
+    }
+    return target;
+}
+function ownKeys(object, enumerableOnly) {
+    var keys = Object.keys(object);
+    if (Object.getOwnPropertySymbols) {
+        var symbols = Object.getOwnPropertySymbols(object);
+        if (enumerableOnly) {
+            symbols = symbols.filter(function(sym) {
+                return Object.getOwnPropertyDescriptor(object, sym).enumerable;
+            });
+        }
+        keys.push.apply(keys, symbols);
+    }
+    return keys;
+}
+function _object_spread_props(target, source) {
+    source = source != null ? source : {};
+    if (Object.getOwnPropertyDescriptors) {
+        Object.defineProperties(target, Object.getOwnPropertyDescriptors(source));
+    } else {
+        ownKeys(Object(source)).forEach(function(key) {
+            Object.defineProperty(target, key, Object.getOwnPropertyDescriptor(source, key));
+        });
+    }
+    return target;
+}
+function _ts_generator(thisArg, body) {
+    var f, y, t, _ = {
+        label: 0,
+        sent: function() {
+            if (t[0] & 1) throw t[1];
+            return t[1];
+        },
+        trys: [],
+        ops: []
+    }, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype), d = Object.defineProperty;
+    return d(g, "next", {
+        value: verb(0)
+    }), d(g, "throw", {
+        value: verb(1)
+    }), d(g, "return", {
+        value: verb(2)
+    }), typeof Symbol === "function" && d(g, Symbol.iterator, {
+        value: function() {
+            return this;
+        }
+    }), g;
+    function verb(n) {
+        return function(v) {
+            return step([
+                n,
+                v
+            ]);
+        };
+    }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while(g && (g = 0, op[0] && (_ = 0)), _)try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [
+                op[0] & 2,
+                t.value
+            ];
+            switch(op[0]){
+                case 0:
+                case 1:
+                    t = op;
+                    break;
+                case 4:
+                    _.label++;
+                    return {
+                        value: op[1],
+                        done: false
+                    };
+                case 5:
+                    _.label++;
+                    y = op[1];
+                    op = [
+                        0
+                    ];
+                    continue;
+                case 7:
+                    op = _.ops.pop();
+                    _.trys.pop();
+                    continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) {
+                        _ = 0;
+                        continue;
+                    }
+                    if (op[0] === 3 && (!t || op[1] > t[0] && op[1] < t[3])) {
+                        _.label = op[1];
+                        break;
+                    }
+                    if (op[0] === 6 && _.label < t[1]) {
+                        _.label = t[1];
+                        t = op;
+                        break;
+                    }
+                    if (t && _.label < t[2]) {
+                        _.label = t[2];
+                        _.ops.push(op);
+                        break;
+                    }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop();
+                    continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) {
+            op = [
+                6,
+                e
+            ];
+            y = 0;
+        } finally{
+            f = t = 0;
+        }
+        if (op[0] & 5) throw op[1];
+        return {
+            value: op[0] ? op[1] : void 0,
+            done: true
+        };
+    }
+}
+var AuthRequiredBranchSchema = _oauthgoogle.schemas.AuthRequiredBranchSchema;
+var inputSchema = _zod.z.object(_object_spread_props(_object_spread({
+    query: _gmailqueryschema.GmailQuerySchema.optional().describe('Structured query object for filtering messages. Use query-syntax prompt for reference.'),
+    fields: (0, _server.createFieldsSchema)({
+        availableFields: _email.EMAIL_FIELDS,
+        fieldDescriptions: _email.EMAIL_FIELD_DESCRIPTIONS,
+        commonPatterns: _email.EMAIL_COMMON_PATTERNS,
+        resourceName: 'email message'
+    })
+}, (0, _server.createPaginationSchema)({
+    defaultPageSize: _constantsts.DEFAULT_PAGE_SIZE,
+    maxPageSize: _constantsts.MAX_PAGE_SIZE,
+    provider: 'gmail'
+}).shape), {
+    shape: (0, _server.createShapeSchema)(),
+    contentType: _email.EmailContentTypeSchema,
+    excludeThreadHistory: _email.ExcludeThreadHistorySchema
+}));
+// Success branch schemas for different shapes
+var successObjectsBranchSchema = _zod.z.object({
+    type: _zod.z.literal('success'),
+    shape: _zod.z.literal('objects'),
+    items: _zod.z.array(_email.EmailDetailSchema).describe('Matching email messages'),
+    nextPageToken: _zod.z.string().optional().describe('Token for fetching next page of results')
+});
+var successArraysBranchSchema = _zod.z.object({
+    type: _zod.z.literal('success'),
+    shape: _zod.z.literal('arrays'),
+    columns: _zod.z.array(_zod.z.string()).describe('Column names in canonical order'),
+    rows: _zod.z.array(_zod.z.array(_zod.z.unknown())).describe('Row data matching column order'),
+    nextPageToken: _zod.z.string().optional().describe('Token for fetching next page of results')
+});
+// Output schema with auth_required support
+// Using z.union instead of discriminatedUnion since we have two success branches with different shapes
+var outputSchema = _zod.z.union([
+    successObjectsBranchSchema,
+    successArraysBranchSchema,
+    AuthRequiredBranchSchema
+]);
+var config = {
+    description: 'Search Gmail messages using structured query objects with flexible field selection.',
+    inputSchema: inputSchema,
+    outputSchema: _zod.z.object({
+        result: outputSchema
+    })
+};
+function handler(_0, _1) {
+    return _async_to_generator(function(param, extra) {
+        var query, _param_pageSize, pageSize, pageToken, fields, _param_shape, shape, _param_contentType, contentType, _param_excludeThreadHistory, excludeThreadHistory, logger, requestedFields, includeBody, gmail, started, exec, items, metadata, durationMs, filteredItems, metadataObj, result, error, message;
+        return _ts_generator(this, function(_state) {
+            switch(_state.label){
+                case 0:
+                    query = param.query, _param_pageSize = param.pageSize, pageSize = _param_pageSize === void 0 ? _constantsts.DEFAULT_PAGE_SIZE : _param_pageSize, pageToken = param.pageToken, fields = param.fields, _param_shape = param.shape, shape = _param_shape === void 0 ? 'arrays' : _param_shape, _param_contentType = param.contentType, contentType = _param_contentType === void 0 ? 'text' : _param_contentType, _param_excludeThreadHistory = param.excludeThreadHistory, excludeThreadHistory = _param_excludeThreadHistory === void 0 ? false : _param_excludeThreadHistory;
+                    logger = extra.logger;
+                    requestedFields = (0, _server.parseFields)(fields, _email.EMAIL_FIELDS);
+                    includeBody = requestedFields === 'all' || requestedFields.has('body');
+                    logger.info('gmail.message.search called', {
+                        query: query,
+                        pageSize: pageSize,
+                        pageToken: pageToken ? '[provided]' : undefined,
+                        fields: fields,
+                        includeBody: includeBody,
+                        accountId: extra.authContext.accountId
+                    });
+                    _state.label = 1;
+                case 1:
+                    _state.trys.push([
+                        1,
+                        3,
+                        ,
+                        4
+                    ]);
+                    gmail = _googleapis.google.gmail({
+                        version: 'v1',
+                        auth: extra.authContext.auth
+                    });
+                    started = Date.now();
+                    return [
+                        4,
+                        (0, _executequery.executeQuery)(query, _object_spread_props(_object_spread({
+                            client: gmail,
+                            logger: logger,
+                            pageSize: pageSize
+                        }, pageToken !== undefined && {
+                            pageToken: pageToken
+                        }), {
+                            includeBody: includeBody
+                        }), function(full) {
+                            var _ref;
+                            var _fullData_payload;
+                            // Type-safe property access with guards
+                            var fullData = full;
+                            var headersArray = Array.isArray(fullData === null || fullData === void 0 ? void 0 : (_fullData_payload = fullData.payload) === null || _fullData_payload === void 0 ? void 0 : _fullData_payload.headers) ? fullData.payload.headers : [];
+                            var headers = Object.fromEntries(headersArray.map(function(h) {
+                                var _header_name, _header_value;
+                                var 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 : '')
+                                ];
+                            }));
+                            var mapped = {
+                                id: String((_ref = fullData === null || fullData === void 0 ? void 0 : fullData.id) !== null && _ref !== void 0 ? _ref : ''),
+                                threadId: (fullData === null || fullData === void 0 ? void 0 : fullData.threadId) ? String(fullData.threadId) : undefined,
+                                from: headers === null || headers === void 0 ? void 0 : headers.From,
+                                to: headers === null || headers === void 0 ? void 0 : headers.To,
+                                subject: headers === null || headers === void 0 ? void 0 : headers.Subject,
+                                date: headers === null || headers === void 0 ? void 0 : headers.Date,
+                                snippet: (fullData === null || fullData === void 0 ? void 0 : fullData.snippet) ? String(fullData.snippet) : undefined
+                            };
+                            if (includeBody) {
+                                var payload = fullData === null || fullData === void 0 ? void 0 : fullData.payload;
+                                // Cast to Schema$MessagePart for extractBodyFromPayload
+                                var body = payload ? (0, _htmlprocessing.extractBodyFromPayload)(payload, {
+                                    contentType: contentType,
+                                    excludeThreadHistory: excludeThreadHistory
+                                }) : '';
+                                if (body) {
+                                    mapped.body = body;
+                                    mapped.bodyContentType = contentType;
+                                }
+                            }
+                            return mapped;
+                        })
+                    ];
+                case 2:
+                    exec = _state.sent();
+                    items = exec.items;
+                    metadata = exec.metadata;
+                    durationMs = Date.now() - started;
+                    // Type-safe field filtering
+                    filteredItems = items.map(function(item) {
+                        return (0, _server.filterFields)(item, requestedFields);
+                    });
+                    logger.info('gmail.message.search results', {
+                        query: query,
+                        pageSize: pageSize,
+                        resultCount: filteredItems.length,
+                        fields: fields || 'all'
+                    });
+                    logger.info('gmail.message.search metrics', {
+                        durationMs: durationMs,
+                        metadata: metadata
+                    });
+                    // Type-safe metadata access
+                    metadataObj = metadata;
+                    // Build result based on shape
+                    result = shape === 'arrays' ? _object_spread({
+                        type: 'success',
+                        shape: 'arrays'
+                    }, (0, _server.toColumnarFormat)(filteredItems, requestedFields, _email.EMAIL_FIELDS), (metadataObj === null || metadataObj === void 0 ? void 0 : metadataObj.nextPageToken) && {
+                        nextPageToken: metadataObj.nextPageToken
+                    }) : _object_spread({
+                        type: 'success',
+                        shape: 'objects',
+                        items: filteredItems
+                    }, (metadataObj === null || metadataObj === void 0 ? void 0 : metadataObj.nextPageToken) && {
+                        nextPageToken: metadataObj.nextPageToken
+                    });
+                    return [
+                        2,
+                        {
+                            content: [
+                                {
+                                    type: 'text',
+                                    text: JSON.stringify(result)
+                                }
+                            ],
+                            structuredContent: {
+                                result: result
+                            }
+                        }
+                    ];
+                case 3:
+                    error = _state.sent();
+                    message = _instanceof(error, Error) ? error.message : String(error);
+                    logger.error('gmail.message.search error', {
+                        error: message
+                    });
+                    throw new _types.McpError(_types.ErrorCode.InternalError, "Error searching messages: ".concat(message), {
+                        stack: _instanceof(error, Error) ? error.stack : undefined
+                    });
+                case 4:
+                    return [
+                        2
+                    ];
+            }
+        });
+    }).apply(this, arguments);
+}
+function createTool() {
+    return {
+        name: 'message-search',
+        config: config,
+        handler: handler
+    };
+}
+/* CJS INTEROP */ if (exports.__esModule && exports.default) { try { Object.defineProperty(exports.default, '__esModule', { value: true }); for (var key in exports) { exports.default[key] = exports[key]; } } catch (_) {}; module.exports = exports.default; }

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

@@ -0,0 +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":["createTool","AuthRequiredBranchSchema","schemas","inputSchema","z","object","query","GmailQuerySchema","optional","describe","fields","createFieldsSchema","availableFields","EMAIL_FIELDS","fieldDescriptions","EMAIL_FIELD_DESCRIPTIONS","commonPatterns","EMAIL_COMMON_PATTERNS","resourceName","createPaginationSchema","defaultPageSize","DEFAULT_PAGE_SIZE","maxPageSize","MAX_PAGE_SIZE","provider","shape","createShapeSchema","contentType","EmailContentTypeSchema","excludeThreadHistory","ExcludeThreadHistorySchema","successObjectsBranchSchema","type","literal","items","array","EmailDetailSchema","nextPageToken","string","successArraysBranchSchema","columns","rows","unknown","outputSchema","union","config","description","result","handler","extra","pageSize","pageToken","logger","requestedFields","includeBody","gmail","started","exec","metadata","durationMs","filteredItems","metadataObj","error","message","parseFields","has","info","undefined","accountId","authContext","google","version","auth","Date","now","executeGmailQuery","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","extractBodyFromPayload","bodyContentType","item","filterFields","resultCount","length","toColumnarFormat","content","text","JSON","stringify","structuredContent","Error","McpError","ErrorCode","InternalError","stack"],"mappings":";;;;+BA8KA;;;eAAwBA;;;qBA9KY;qBAGmI;2BAE/I;sBAIoH;0BACtG;mBACpB;2BAC+B;8BACV;4BACW;gCACjB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AARjC,IAAM,AAAEC,2BAA6BC,oBAAO,CAApCD;AAUR,IAAME,cAAcC,MAAC,CAACC,MAAM,CAAC;IAC3BC,OAAOC,kCAAgB,CAACC,QAAQ,GAAGC,QAAQ,CAAC;IAC5CC,QAAQC,IAAAA,0BAAkB,EAAC;QACzBC,iBAAiBC,mBAAY;QAC7BC,mBAAmBC,+BAAwB;QAC3CC,gBAAgBC,4BAAqB;QACrCC,cAAc;IAChB;GACGC,IAAAA,8BAAsB,EAAC;IAAEC,iBAAiBC,8BAAiB;IAAEC,aAAaC,0BAAa;IAAEC,UAAU;AAAQ,GAAGC,KAAK;IACtHA,OAAOC,IAAAA,yBAAiB;IACxBC,aAAaC,6BAAsB;IACnCC,sBAAsBC,iCAA0B;;AAGlD,8CAA8C;AAC9C,IAAMC,6BAA6B3B,MAAC,CAACC,MAAM,CAAC;IAC1C2B,MAAM5B,MAAC,CAAC6B,OAAO,CAAC;IAChBR,OAAOrB,MAAC,CAAC6B,OAAO,CAAC;IACjBC,OAAO9B,MAAC,CAAC+B,KAAK,CAACC,wBAAiB,EAAE3B,QAAQ,CAAC;IAC3C4B,eAAejC,MAAC,CAACkC,MAAM,GAAG9B,QAAQ,GAAGC,QAAQ,CAAC;AAChD;AAEA,IAAM8B,4BAA4BnC,MAAC,CAACC,MAAM,CAAC;IACzC2B,MAAM5B,MAAC,CAAC6B,OAAO,CAAC;IAChBR,OAAOrB,MAAC,CAAC6B,OAAO,CAAC;IACjBO,SAASpC,MAAC,CAAC+B,KAAK,CAAC/B,MAAC,CAACkC,MAAM,IAAI7B,QAAQ,CAAC;IACtCgC,MAAMrC,MAAC,CAAC+B,KAAK,CAAC/B,MAAC,CAAC+B,KAAK,CAAC/B,MAAC,CAACsC,OAAO,KAAKjC,QAAQ,CAAC;IAC7C4B,eAAejC,MAAC,CAACkC,MAAM,GAAG9B,QAAQ,GAAGC,QAAQ,CAAC;AAChD;AAEA,2CAA2C;AAC3C,uGAAuG;AACvG,IAAMkC,eAAevC,MAAC,CAACwC,KAAK,CAAC;IAACb;IAA4BQ;IAA2BtC;CAAyB;AAE9G,IAAM4C,SAAS;IACbC,aAAa;IACb3C,aAAaA;IACbwC,cAAcvC,MAAC,CAACC,MAAM,CAAC;QACrB0C,QAAQJ;IACV;AACF;AAKA,SAAeK;wCAAQ,KAAuI,EAAEC,KAAoB;YAA3J3C,wBAAO4C,UAA8BC,WAAWzC,sBAAQe,2BAAkBE,0CAAsBE,sBACjHuB,QAEAC,iBACAC,aAYEC,OAEAC,SAEAC,MA4CAvB,OACAwB,UACAC,YAGAC,eAMAC,aAGAd,QAwBCe,OACDC;;;;oBAvGezD,QAAF,MAAEA,yBAAF,MAAS4C,UAAAA,wCAAW7B,8BAAiB,oBAAE8B,YAAvC,MAAuCA,WAAWzC,SAAlD,MAAkDA,uBAAlD,MAA0De,OAAAA,kCAAQ,8CAAlE,MAA4EE,aAAAA,8CAAc,2DAA1F,MAAkGE,sBAAAA,gEAAuB;oBACxIuB,SAASH,MAAMG,MAAM;oBAErBC,kBAAkBW,IAAAA,mBAAW,EAACtD,QAAQG,mBAAY;oBAClDyC,cAAcD,oBAAoB,SAASA,gBAAgBY,GAAG,CAAC;oBAErEb,OAAOc,IAAI,CAAC,+BAA+B;wBACzC5D,OAAAA;wBACA4C,UAAAA;wBACAC,WAAWA,YAAY,eAAegB;wBACtCzD,QAAAA;wBACA4C,aAAAA;wBACAc,WAAWnB,MAAMoB,WAAW,CAACD,SAAS;oBACxC;;;;;;;;;oBAGQb,QAAQe,kBAAM,CAACf,KAAK,CAAC;wBAAEgB,SAAS;wBAAMC,MAAMvB,MAAMoB,WAAW,CAACG,IAAI;oBAAC;oBAEnEhB,UAAUiB,KAAKC,GAAG;oBAEX;;wBAAMC,IAAAA,0BAAiB,EAClCrE,OACA;4BACEsE,QAAQrB;4BACRH,QAAAA;4BACAF,UAAAA;2BACIC,cAAcgB,aAAa;4BAAEhB,WAAAA;wBAAU;4BAC3CG,aAAAA;4BAEF,SAACuB;;gCAIoCC;4BAHnC,wCAAwC;4BACxC,IAAMA,WAAWD;4BAEjB,IAAME,eAAeC,MAAMC,OAAO,CAACH,qBAAAA,gCAAAA,oBAAAA,SAAUI,OAAO,cAAjBJ,wCAAAA,kBAAmBK,OAAO,IAAIL,SAASI,OAAO,CAACC,OAAO,GAAG,EAAE;4BAC9F,IAAMA,UAAUC,OAAOC,WAAW,CAChCN,aAAaO,GAAG,CAAC,SAACC;oCAEDC,cAA2BA;gCAD1C,IAAMA,SAASD;gCACf,OAAO;oCAACE,QAAOD,eAAAA,OAAOE,IAAI,cAAXF,0BAAAA,eAAe;oCAAKC,QAAOD,gBAAAA,OAAOG,KAAK,cAAZH,2BAAAA,gBAAgB;iCAAI;4BAChE;4BAGF,IAAMI,SAA+B;gCACnCC,IAAIJ,eAAOX,qBAAAA,+BAAAA,SAAUe,EAAE,uCAAI;gCAC3BC,UAAUhB,CAAAA,qBAAAA,+BAAAA,SAAUgB,QAAQ,IAAGL,OAAOX,SAASgB,QAAQ,IAAI3B;gCAC3D4B,IAAI,EAAEZ,oBAAAA,8BAAAA,QAASa,IAAI;gCACnBC,EAAE,EAAEd,oBAAAA,8BAAAA,QAASe,EAAE;gCACfC,OAAO,EAAEhB,oBAAAA,8BAAAA,QAASiB,OAAO;gCACzBC,IAAI,EAAElB,oBAAAA,8BAAAA,QAASV,IAAI;gCACnB6B,SAASxB,CAAAA,qBAAAA,+BAAAA,SAAUwB,OAAO,IAAGb,OAAOX,SAASwB,OAAO,IAAInC;4BAC1D;4BAEA,IAAIb,aAAa;gCACf,IAAM4B,UAAUJ,qBAAAA,+BAAAA,SAAUI,OAAO;gCACjC,wDAAwD;gCACxD,IAAMqB,OAAOrB,UAAUsB,IAAAA,sCAAsB,EAACtB,SAAwC;oCAAEvD,aAAAA;oCAAaE,sBAAAA;gCAAqB,KAAK;gCAC/H,IAAI0E,MAAM;oCACRX,OAAOW,IAAI,GAAGA;oCACdX,OAAOa,eAAe,GAAG9E;gCAC3B;4BACF;4BACA,OAAOiE;wBACT;;;oBAzCInC,OAAO;oBA4CPvB,QAAQuB,KAAKvB,KAAK;oBAClBwB,WAAWD,KAAKC,QAAQ;oBACxBC,aAAac,KAAKC,GAAG,KAAKlB;oBAEhC,4BAA4B;oBACtBI,gBAAgB1B,MAAMoD,GAAG,CAAC,SAACoB;+BAASC,IAAAA,oBAAY,EAACD,MAAMrD;;oBAE7DD,OAAOc,IAAI,CAAC,gCAAgC;wBAAE5D,OAAAA;wBAAO4C,UAAAA;wBAAU0D,aAAahD,cAAciD,MAAM;wBAAEnG,QAAQA,UAAU;oBAAM;oBAC1H0C,OAAOc,IAAI,CAAC,gCAAgC;wBAAEP,YAAAA;wBAAYD,UAAAA;oBAAS;oBAEnE,4BAA4B;oBACtBG,cAAcH;oBAEpB,8BAA8B;oBACxBX,SACJtB,UAAU,WACN;wBACEO,MAAM;wBACNP,OAAO;uBACJqF,IAAAA,wBAAgB,EAAClD,eAAeP,iBAAiBxC,mBAAY,GAC5DgD,CAAAA,wBAAAA,kCAAAA,YAAaxB,aAAa,KAAI;wBAAEA,eAAewB,YAAYxB,aAAa;oBAAC,KAE/E;wBACEL,MAAM;wBACNP,OAAO;wBACPS,OAAO0B;uBACHC,CAAAA,wBAAAA,kCAAAA,YAAaxB,aAAa,KAAI;wBAAEA,eAAewB,YAAYxB,aAAa;oBAAC;oBAGrF;;wBAAO;4BACL0E,OAAO;gCACL;oCACE/E,MAAM;oCACNgF,MAAMC,KAAKC,SAAS,CAACnE;gCACvB;;4BAEFoE,mBAAmB;gCAAEpE,QAAAA;4BAAO;wBAC9B;;;oBACOe;oBACDC,UAAUD,AAAK,YAALA,OAAiBsD,SAAQtD,MAAMC,OAAO,GAAG0B,OAAO3B;oBAChEV,OAAOU,KAAK,CAAC,8BAA8B;wBAAEA,OAAOC;oBAAQ;oBAE5D,MAAM,IAAIsD,eAAQ,CAACC,gBAAS,CAACC,aAAa,EAAE,AAAC,6BAAoC,OAARxD,UAAW;wBAClFyD,OAAO1D,AAAK,YAALA,OAAiBsD,SAAQtD,MAAM0D,KAAK,GAAGrD;oBAChD;;;;;;;IAEJ;;AAEe,SAASnE;IACtB,OAAO;QACL0F,MAAM;QACN7C,QAAAA;QACAG,SAAAA;IACF;AACF"}