@mcp-z/mcp-outlook 1.0.0

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

@@ -0,0 +1,138 @@
+import type { EnrichedExtra } from '@mcp-z/oauth-microsoft';
+import { type CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+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/outlook-query-schema.js").OutlookQuery, unknown, z.core.$ZodTypeInternals<import("../../schemas/outlook-query-schema.js").OutlookQuery, 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<CallToolResult>;
+export default function createTool(): {
+    name: string;
+    config: {
+        readonly description: "Search Outlook 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/outlook-query-schema.js").OutlookQuery, unknown, z.core.$ZodTypeInternals<import("../../schemas/outlook-query-schema.js").OutlookQuery, 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/esm/mcp/tools/message-search.js

@@ -0,0 +1,184 @@
+import { EMAIL_COMMON_PATTERNS, EMAIL_FIELD_DESCRIPTIONS, EMAIL_FIELDS, EmailContentTypeSchema, EmailDetailSchema, ExcludeThreadHistorySchema, extractCurrentMessageFromHtml, extractCurrentMessageFromHtmlToText } from '@mcp-z/email';
+import { schemas } from '@mcp-z/oauth-microsoft';
+const { AuthRequiredBranchSchema } = schemas;
+import { createFieldsSchema, createPaginationSchema, createShapeSchema, filterFields, parseFields, toColumnarFormat } from '@mcp-z/server';
+import { Client } from '@microsoft/microsoft-graph-client';
+import { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';
+import { z } from 'zod';
+import { executeQuery as executeOutlookQuery } from '../../email/querying/execute-query.js';
+import { OutlookQuerySchema } from '../../schemas/outlook-query-schema.js';
+const inputSchema = z.object({
+    query: OutlookQuerySchema.optional().describe('Structured query object for filtering messages. Use query-syntax prompt for reference.'),
+    fields: createFieldsSchema({
+        availableFields: EMAIL_FIELDS,
+        fieldDescriptions: EMAIL_FIELD_DESCRIPTIONS,
+        commonPatterns: EMAIL_COMMON_PATTERNS,
+        resourceName: 'email message'
+    }),
+    ...createPaginationSchema({
+        defaultPageSize: 50,
+        maxPageSize: 500,
+        provider: 'outlook'
+    }).shape,
+    shape: createShapeSchema(),
+    contentType: EmailContentTypeSchema,
+    excludeThreadHistory: ExcludeThreadHistorySchema
+});
+// Success branch schemas for different shapes
+const successObjectsBranchSchema = z.object({
+    type: z.literal('success'),
+    shape: z.literal('objects'),
+    items: z.array(EmailDetailSchema).describe('Matching email messages'),
+    nextPageToken: z.string().optional().describe('Token for fetching next page of results')
+});
+const successArraysBranchSchema = z.object({
+    type: z.literal('success'),
+    shape: z.literal('arrays'),
+    columns: z.array(z.string()).describe('Column names in canonical order'),
+    rows: z.array(z.array(z.unknown())).describe('Row data matching column order'),
+    nextPageToken: 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
+const outputSchema = z.union([
+    successObjectsBranchSchema,
+    successArraysBranchSchema,
+    AuthRequiredBranchSchema
+]);
+const config = {
+    description: 'Search Outlook messages using structured query objects with flexible field selection.',
+    inputSchema: inputSchema,
+    outputSchema: z.object({
+        result: outputSchema
+    })
+};
+async function handler({ query, pageSize = 50, pageToken, fields, shape = 'arrays', contentType, excludeThreadHistory }, extra) {
+    const logger = extra.logger;
+    const requestedFields = parseFields(fields, EMAIL_FIELDS);
+    const includeBody = requestedFields === 'all' || requestedFields.has('body');
+    logger.info('outlook.search called with', {
+        query,
+        pageSize,
+        pageToken: pageToken ? '[provided]' : undefined,
+        fields: fields || 'all',
+        includeBody
+    });
+    try {
+        const graph = Client.initWithMiddleware({
+            authProvider: extra.authContext.auth
+        });
+        const started = Date.now();
+        const exec = await executeOutlookQuery(graph, query, {
+            logger,
+            pageSize,
+            ...pageToken ? {
+                pageToken
+            } : {},
+            includeBody,
+            limit: pageSize
+        }, (m)=>{
+            var _ref, _ref1, _ref2, _ref3, _ref4, _ref5;
+            var _message_from_emailAddress, _message_from, _message_from_emailAddress1, _message_from1, _message_body;
+            const message = m;
+            const to = Array.isArray(message === null || message === void 0 ? void 0 : message.toRecipients) ? message.toRecipients.map((r)=>{
+                var _r_emailAddress;
+                return r === null || r === void 0 ? void 0 : (_r_emailAddress = r.emailAddress) === null || _r_emailAddress === void 0 ? void 0 : _r_emailAddress.address;
+            }).filter(Boolean).join(', ') : undefined;
+            const cc = Array.isArray(message === null || message === void 0 ? void 0 : message.ccRecipients) ? message.ccRecipients.map((r)=>{
+                var _r_emailAddress;
+                return r === null || r === void 0 ? void 0 : (_r_emailAddress = r.emailAddress) === null || _r_emailAddress === void 0 ? void 0 : _r_emailAddress.address;
+            }).filter(Boolean).join(', ') : undefined;
+            const bcc = Array.isArray(message === null || message === void 0 ? void 0 : message.bccRecipients) ? message.bccRecipients.map((r)=>{
+                var _r_emailAddress;
+                return r === null || r === void 0 ? void 0 : (_r_emailAddress = r.emailAddress) === null || _r_emailAddress === void 0 ? void 0 : _r_emailAddress.address;
+            }).filter(Boolean).join(', ') : undefined;
+            const fromAddr = (_ref = message === null || message === void 0 ? void 0 : (_message_from = message.from) === null || _message_from === void 0 ? void 0 : (_message_from_emailAddress = _message_from.emailAddress) === null || _message_from_emailAddress === void 0 ? void 0 : _message_from_emailAddress.address) !== null && _ref !== void 0 ? _ref : null;
+            const fromName = (_ref1 = message === null || message === void 0 ? void 0 : (_message_from1 = message.from) === null || _message_from1 === void 0 ? void 0 : (_message_from_emailAddress1 = _message_from1.emailAddress) === null || _message_from_emailAddress1 === void 0 ? void 0 : _message_from_emailAddress1.name) !== null && _ref1 !== void 0 ? _ref1 : null;
+            // Process body based on contentType and excludeThreadHistory options
+            let bodyContent;
+            if (includeBody && (message === null || message === void 0 ? void 0 : (_message_body = message.body) === null || _message_body === void 0 ? void 0 : _message_body.content)) {
+                var _message_body_contentType;
+                const isHtml = ((_message_body_contentType = message.body.contentType) === null || _message_body_contentType === void 0 ? void 0 : _message_body_contentType.toLowerCase()) === 'html';
+                bodyContent = message.body.content;
+                if (isHtml && excludeThreadHistory) {
+                    bodyContent = extractCurrentMessageFromHtml(bodyContent);
+                }
+                if (isHtml && contentType === 'text') {
+                    bodyContent = excludeThreadHistory ? extractCurrentMessageFromHtmlToText(bodyContent) : extractCurrentMessageFromHtmlToText(message.body.content);
+                }
+            }
+            const mapped = {
+                id: (_ref2 = message === null || message === void 0 ? void 0 : message.id) !== null && _ref2 !== void 0 ? _ref2 : undefined,
+                subject: (_ref3 = message === null || message === void 0 ? void 0 : message.subject) !== null && _ref3 !== void 0 ? _ref3 : undefined,
+                from: fromAddr !== null && fromAddr !== void 0 ? fromAddr : undefined,
+                fromName: fromName !== null && fromName !== void 0 ? fromName : undefined,
+                to,
+                cc,
+                bcc,
+                date: (_ref4 = message === null || message === void 0 ? void 0 : message.receivedDateTime) !== null && _ref4 !== void 0 ? _ref4 : undefined,
+                snippet: (_ref5 = message === null || message === void 0 ? void 0 : message.bodyPreview) !== null && _ref5 !== void 0 ? _ref5 : undefined,
+                ...bodyContent && {
+                    body: bodyContent,
+                    bodyContentType: contentType
+                }
+            };
+            return mapped;
+        });
+        const durationMs = Date.now() - started;
+        const filteredItems = exec.items.map((item)=>filterFields(item, requestedFields));
+        logger.info('outlook.message.search returning', {
+            query,
+            pageSize,
+            itemsLength: filteredItems.length,
+            fields: fields || 'all'
+        });
+        logger.info('outlook.message.search metrics', {
+            durationMs,
+            metadata: exec.metadata
+        });
+        // Type-safe metadata access
+        const metadataObj = exec.metadata;
+        // Build result based on shape
+        const result = shape === 'arrays' ? {
+            type: 'success',
+            shape: 'arrays',
+            ...toColumnarFormat(filteredItems, requestedFields, EMAIL_FIELDS),
+            ...(metadataObj === null || metadataObj === void 0 ? void 0 : metadataObj.nextPageToken) && {
+                nextPageToken: metadataObj.nextPageToken
+            }
+        } : {
+            type: 'success',
+            shape: 'objects',
+            items: filteredItems,
+            ...(metadataObj === null || metadataObj === void 0 ? void 0 : metadataObj.nextPageToken) && {
+                nextPageToken: metadataObj.nextPageToken
+            }
+        };
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify(result)
+                }
+            ],
+            structuredContent: {
+                result
+            }
+        };
+    } catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        logger.error('outlook.message.search error', {
+            error: message
+        });
+        throw new McpError(ErrorCode.InternalError, `Error searching messages: ${message}`, {
+            stack: error instanceof Error ? error.stack : undefined
+        });
+    }
+}
+export default function createTool() {
+    return {
+        name: 'message-search',
+        config,
+        handler
+    };
+}

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

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/kevin/Dev/Projects/ai/mcp-z/servers/mcp-outlook/src/mcp/tools/message-search.ts"],"sourcesContent":["import { EMAIL_COMMON_PATTERNS, EMAIL_FIELD_DESCRIPTIONS, EMAIL_FIELDS, EmailContentTypeSchema, type EmailDetail, EmailDetailSchema, ExcludeThreadHistorySchema, extractCurrentMessageFromHtml, extractCurrentMessageFromHtmlToText } from '@mcp-z/email';\nimport type { EnrichedExtra } from '@mcp-z/oauth-microsoft';\nimport { schemas } from '@mcp-z/oauth-microsoft';\n\nconst { AuthRequiredBranchSchema } = schemas;\n\nimport { createFieldsSchema, createPaginationSchema, createShapeSchema, filterFields, parseFields, type ToolModule, toColumnarFormat } from '@mcp-z/server';\nimport { Client } from '@microsoft/microsoft-graph-client';\nimport type * as MicrosoftGraph from '@microsoft/microsoft-graph-types';\nimport { type CallToolResult, ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';\nimport { z } from 'zod';\nimport { executeQuery as executeOutlookQuery } from '../../email/querying/execute-query.js';\nimport { OutlookQuerySchema } from '../../schemas/outlook-query-schema.js';\n\nconst inputSchema = z.object({\n  query: OutlookQuerySchema.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({\n    defaultPageSize: 50,\n    maxPageSize: 500,\n    provider: 'outlook',\n  }).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 Outlook 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 = 50, pageToken, fields, shape = 'arrays', contentType, excludeThreadHistory }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\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('outlook.search called with', {\n    query,\n    pageSize,\n    pageToken: pageToken ? '[provided]' : undefined,\n    fields: fields || 'all',\n    includeBody,\n  });\n\n  try {\n    const graph = Client.initWithMiddleware({\n      authProvider: extra.authContext.auth,\n    });\n    const started = Date.now();\n    const exec = await executeOutlookQuery(\n      graph,\n      query,\n      {\n        logger,\n        pageSize,\n        ...(pageToken ? { pageToken } : {}),\n        includeBody,\n        limit: pageSize,\n      },\n      (m: unknown) => {\n        const message = m as MicrosoftGraph.Message;\n        const to = Array.isArray(message?.toRecipients)\n          ? message.toRecipients\n              .map((r: MicrosoftGraph.Recipient) => r?.emailAddress?.address)\n              .filter(Boolean)\n              .join(', ')\n          : undefined;\n        const cc = Array.isArray(message?.ccRecipients)\n          ? message.ccRecipients\n              .map((r: MicrosoftGraph.Recipient) => r?.emailAddress?.address)\n              .filter(Boolean)\n              .join(', ')\n          : undefined;\n        const bcc = Array.isArray(message?.bccRecipients)\n          ? message.bccRecipients\n              .map((r: MicrosoftGraph.Recipient) => r?.emailAddress?.address)\n              .filter(Boolean)\n              .join(', ')\n          : undefined;\n        const fromAddr = message?.from?.emailAddress?.address ?? null;\n        const fromName = message?.from?.emailAddress?.name ?? null;\n        // Process body based on contentType and excludeThreadHistory options\n        let bodyContent: string | undefined;\n        if (includeBody && message?.body?.content) {\n          const isHtml = message.body.contentType?.toLowerCase() === 'html';\n          bodyContent = message.body.content;\n\n          if (isHtml && excludeThreadHistory) {\n            bodyContent = extractCurrentMessageFromHtml(bodyContent);\n          }\n\n          if (isHtml && contentType === 'text') {\n            bodyContent = excludeThreadHistory ? extractCurrentMessageFromHtmlToText(bodyContent) : extractCurrentMessageFromHtmlToText(message.body.content);\n          }\n        }\n\n        const mapped: Partial<EmailDetail> = {\n          id: message?.id ?? undefined,\n          subject: message?.subject ?? undefined,\n          from: fromAddr ?? undefined,\n          fromName: fromName ?? undefined,\n          to,\n          cc,\n          bcc,\n          date: message?.receivedDateTime ?? undefined,\n          snippet: message?.bodyPreview ?? undefined,\n          ...(bodyContent && { body: bodyContent, bodyContentType: contentType }),\n        };\n        return mapped;\n      }\n    );\n    const durationMs = Date.now() - started;\n\n    const filteredItems = exec.items.map((item) => filterFields(item, requestedFields));\n\n    logger.info('outlook.message.search returning', {\n      query,\n      pageSize,\n      itemsLength: filteredItems.length,\n      fields: fields || 'all',\n    });\n    logger.info('outlook.message.search metrics', {\n      durationMs,\n      metadata: exec.metadata,\n    });\n\n    // Type-safe metadata access\n    const metadataObj = exec.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('outlook.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":["EMAIL_COMMON_PATTERNS","EMAIL_FIELD_DESCRIPTIONS","EMAIL_FIELDS","EmailContentTypeSchema","EmailDetailSchema","ExcludeThreadHistorySchema","extractCurrentMessageFromHtml","extractCurrentMessageFromHtmlToText","schemas","AuthRequiredBranchSchema","createFieldsSchema","createPaginationSchema","createShapeSchema","filterFields","parseFields","toColumnarFormat","Client","ErrorCode","McpError","z","executeQuery","executeOutlookQuery","OutlookQuerySchema","inputSchema","object","query","optional","describe","fields","availableFields","fieldDescriptions","commonPatterns","resourceName","defaultPageSize","maxPageSize","provider","shape","contentType","excludeThreadHistory","successObjectsBranchSchema","type","literal","items","array","nextPageToken","string","successArraysBranchSchema","columns","rows","unknown","outputSchema","union","config","description","result","handler","pageSize","pageToken","extra","logger","requestedFields","includeBody","has","info","undefined","graph","initWithMiddleware","authProvider","authContext","auth","started","Date","now","exec","limit","m","message","to","Array","isArray","toRecipients","map","r","emailAddress","address","filter","Boolean","join","cc","ccRecipients","bcc","bccRecipients","fromAddr","from","fromName","name","bodyContent","body","content","isHtml","toLowerCase","mapped","id","subject","date","receivedDateTime","snippet","bodyPreview","bodyContentType","durationMs","filteredItems","item","itemsLength","length","metadata","metadataObj","text","JSON","stringify","structuredContent","error","Error","String","InternalError","stack","createTool"],"mappings":"AAAA,SAASA,qBAAqB,EAAEC,wBAAwB,EAAEC,YAAY,EAAEC,sBAAsB,EAAoBC,iBAAiB,EAAEC,0BAA0B,EAAEC,6BAA6B,EAAEC,mCAAmC,QAAQ,eAAe;AAE1P,SAASC,OAAO,QAAQ,yBAAyB;AAEjD,MAAM,EAAEC,wBAAwB,EAAE,GAAGD;AAErC,SAASE,kBAAkB,EAAEC,sBAAsB,EAAEC,iBAAiB,EAAEC,YAAY,EAAEC,WAAW,EAAmBC,gBAAgB,QAAQ,gBAAgB;AAC5J,SAASC,MAAM,QAAQ,oCAAoC;AAE3D,SAA8BC,SAAS,EAAEC,QAAQ,QAAQ,qCAAqC;AAC9F,SAASC,CAAC,QAAQ,MAAM;AACxB,SAASC,gBAAgBC,mBAAmB,QAAQ,wCAAwC;AAC5F,SAASC,kBAAkB,QAAQ,wCAAwC;AAE3E,MAAMC,cAAcJ,EAAEK,MAAM,CAAC;IAC3BC,OAAOH,mBAAmBI,QAAQ,GAAGC,QAAQ,CAAC;IAC9CC,QAAQlB,mBAAmB;QACzBmB,iBAAiB3B;QACjB4B,mBAAmB7B;QACnB8B,gBAAgB/B;QAChBgC,cAAc;IAChB;IACA,GAAGrB,uBAAuB;QACxBsB,iBAAiB;QACjBC,aAAa;QACbC,UAAU;IACZ,GAAGC,KAAK;IACRA,OAAOxB;IACPyB,aAAalC;IACbmC,sBAAsBjC;AACxB;AAEA,8CAA8C;AAC9C,MAAMkC,6BAA6BpB,EAAEK,MAAM,CAAC;IAC1CgB,MAAMrB,EAAEsB,OAAO,CAAC;IAChBL,OAAOjB,EAAEsB,OAAO,CAAC;IACjBC,OAAOvB,EAAEwB,KAAK,CAACvC,mBAAmBuB,QAAQ,CAAC;IAC3CiB,eAAezB,EAAE0B,MAAM,GAAGnB,QAAQ,GAAGC,QAAQ,CAAC;AAChD;AAEA,MAAMmB,4BAA4B3B,EAAEK,MAAM,CAAC;IACzCgB,MAAMrB,EAAEsB,OAAO,CAAC;IAChBL,OAAOjB,EAAEsB,OAAO,CAAC;IACjBM,SAAS5B,EAAEwB,KAAK,CAACxB,EAAE0B,MAAM,IAAIlB,QAAQ,CAAC;IACtCqB,MAAM7B,EAAEwB,KAAK,CAACxB,EAAEwB,KAAK,CAACxB,EAAE8B,OAAO,KAAKtB,QAAQ,CAAC;IAC7CiB,eAAezB,EAAE0B,MAAM,GAAGnB,QAAQ,GAAGC,QAAQ,CAAC;AAChD;AAEA,2CAA2C;AAC3C,uGAAuG;AACvG,MAAMuB,eAAe/B,EAAEgC,KAAK,CAAC;IAACZ;IAA4BO;IAA2BrC;CAAyB;AAE9G,MAAM2C,SAAS;IACbC,aAAa;IACb9B,aAAaA;IACb2B,cAAc/B,EAAEK,MAAM,CAAC;QACrB8B,QAAQJ;IACV;AACF;AAKA,eAAeK,QAAQ,EAAE9B,KAAK,EAAE+B,WAAW,EAAE,EAAEC,SAAS,EAAE7B,MAAM,EAAEQ,QAAQ,QAAQ,EAAEC,WAAW,EAAEC,oBAAoB,EAAS,EAAEoB,KAAoB;IAClJ,MAAMC,SAASD,MAAMC,MAAM;IAE3B,MAAMC,kBAAkB9C,YAAYc,QAAQ1B;IAC5C,MAAM2D,cAAcD,oBAAoB,SAASA,gBAAgBE,GAAG,CAAC;IAErEH,OAAOI,IAAI,CAAC,8BAA8B;QACxCtC;QACA+B;QACAC,WAAWA,YAAY,eAAeO;QACtCpC,QAAQA,UAAU;QAClBiC;IACF;IAEA,IAAI;QACF,MAAMI,QAAQjD,OAAOkD,kBAAkB,CAAC;YACtCC,cAAcT,MAAMU,WAAW,CAACC,IAAI;QACtC;QACA,MAAMC,UAAUC,KAAKC,GAAG;QACxB,MAAMC,OAAO,MAAMpD,oBACjB4C,OACAxC,OACA;YACEkC;YACAH;YACA,GAAIC,YAAY;gBAAEA;YAAU,IAAI,CAAC,CAAC;YAClCI;YACAa,OAAOlB;QACT,GACA,CAACmB;;gBAoBkBC,4BAAAA,eACAA,6BAAAA,gBAGEA;YAvBnB,MAAMA,UAAUD;YAChB,MAAME,KAAKC,MAAMC,OAAO,CAACH,oBAAAA,8BAAAA,QAASI,YAAY,IAC1CJ,QAAQI,YAAY,CACjBC,GAAG,CAAC,CAACC;oBAAgCA;uBAAAA,cAAAA,yBAAAA,kBAAAA,EAAGC,YAAY,cAAfD,sCAAAA,gBAAiBE,OAAO;eAC7DC,MAAM,CAACC,SACPC,IAAI,CAAC,QACRvB;YACJ,MAAMwB,KAAKV,MAAMC,OAAO,CAACH,oBAAAA,8BAAAA,QAASa,YAAY,IAC1Cb,QAAQa,YAAY,CACjBR,GAAG,CAAC,CAACC;oBAAgCA;uBAAAA,cAAAA,yBAAAA,kBAAAA,EAAGC,YAAY,cAAfD,sCAAAA,gBAAiBE,OAAO;eAC7DC,MAAM,CAACC,SACPC,IAAI,CAAC,QACRvB;YACJ,MAAM0B,MAAMZ,MAAMC,OAAO,CAACH,oBAAAA,8BAAAA,QAASe,aAAa,IAC5Cf,QAAQe,aAAa,CAClBV,GAAG,CAAC,CAACC;oBAAgCA;uBAAAA,cAAAA,yBAAAA,kBAAAA,EAAGC,YAAY,cAAfD,sCAAAA,gBAAiBE,OAAO;eAC7DC,MAAM,CAACC,SACPC,IAAI,CAAC,QACRvB;YACJ,MAAM4B,mBAAWhB,oBAAAA,+BAAAA,gBAAAA,QAASiB,IAAI,cAAbjB,qCAAAA,6BAAAA,cAAeO,YAAY,cAA3BP,iDAAAA,2BAA6BQ,OAAO,uCAAI;YACzD,MAAMU,oBAAWlB,oBAAAA,+BAAAA,iBAAAA,QAASiB,IAAI,cAAbjB,sCAAAA,8BAAAA,eAAeO,YAAY,cAA3BP,kDAAAA,4BAA6BmB,IAAI,yCAAI;YACtD,qEAAqE;YACrE,IAAIC;YACJ,IAAInC,gBAAee,oBAAAA,+BAAAA,gBAAAA,QAASqB,IAAI,cAAbrB,oCAAAA,cAAesB,OAAO,GAAE;oBAC1BtB;gBAAf,MAAMuB,SAASvB,EAAAA,4BAAAA,QAAQqB,IAAI,CAAC5D,WAAW,cAAxBuC,gDAAAA,0BAA0BwB,WAAW,QAAO;gBAC3DJ,cAAcpB,QAAQqB,IAAI,CAACC,OAAO;gBAElC,IAAIC,UAAU7D,sBAAsB;oBAClC0D,cAAc1F,8BAA8B0F;gBAC9C;gBAEA,IAAIG,UAAU9D,gBAAgB,QAAQ;oBACpC2D,cAAc1D,uBAAuB/B,oCAAoCyF,eAAezF,oCAAoCqE,QAAQqB,IAAI,CAACC,OAAO;gBAClJ;YACF;YAEA,MAAMG,SAA+B;gBACnCC,EAAE,WAAE1B,oBAAAA,8BAAAA,QAAS0B,EAAE,yCAAItC;gBACnBuC,OAAO,WAAE3B,oBAAAA,8BAAAA,QAAS2B,OAAO,yCAAIvC;gBAC7B6B,IAAI,EAAED,qBAAAA,sBAAAA,WAAY5B;gBAClB8B,QAAQ,EAAEA,qBAAAA,sBAAAA,WAAY9B;gBACtBa;gBACAW;gBACAE;gBACAc,IAAI,WAAE5B,oBAAAA,8BAAAA,QAAS6B,gBAAgB,yCAAIzC;gBACnC0C,OAAO,WAAE9B,oBAAAA,8BAAAA,QAAS+B,WAAW,yCAAI3C;gBACjC,GAAIgC,eAAe;oBAAEC,MAAMD;oBAAaY,iBAAiBvE;gBAAY,CAAC;YACxE;YACA,OAAOgE;QACT;QAEF,MAAMQ,aAAatC,KAAKC,GAAG,KAAKF;QAEhC,MAAMwC,gBAAgBrC,KAAK/B,KAAK,CAACuC,GAAG,CAAC,CAAC8B,OAASlG,aAAakG,MAAMnD;QAElED,OAAOI,IAAI,CAAC,oCAAoC;YAC9CtC;YACA+B;YACAwD,aAAaF,cAAcG,MAAM;YACjCrF,QAAQA,UAAU;QACpB;QACA+B,OAAOI,IAAI,CAAC,kCAAkC;YAC5C8C;YACAK,UAAUzC,KAAKyC,QAAQ;QACzB;QAEA,4BAA4B;QAC5B,MAAMC,cAAc1C,KAAKyC,QAAQ;QAEjC,8BAA8B;QAC9B,MAAM5D,SACJlB,UAAU,WACN;YACEI,MAAM;YACNJ,OAAO;YACP,GAAGrB,iBAAiB+F,eAAelD,iBAAiB1D,aAAa;YACjE,GAAIiH,CAAAA,wBAAAA,kCAAAA,YAAavE,aAAa,KAAI;gBAAEA,eAAeuE,YAAYvE,aAAa;YAAC,CAAC;QAChF,IACA;YACEJ,MAAM;YACNJ,OAAO;YACPM,OAAOoE;YACP,GAAIK,CAAAA,wBAAAA,kCAAAA,YAAavE,aAAa,KAAI;gBAAEA,eAAeuE,YAAYvE,aAAa;YAAC,CAAC;QAChF;QAEN,OAAO;YACLsD,SAAS;gBACP;oBACE1D,MAAM;oBACN4E,MAAMC,KAAKC,SAAS,CAAChE;gBACvB;aACD;YACDiE,mBAAmB;gBAAEjE;YAAO;QAC9B;IACF,EAAE,OAAOkE,OAAO;QACd,MAAM5C,UAAU4C,iBAAiBC,QAAQD,MAAM5C,OAAO,GAAG8C,OAAOF;QAChE7D,OAAO6D,KAAK,CAAC,gCAAgC;YAAEA,OAAO5C;QAAQ;QAE9D,MAAM,IAAI1D,SAASD,UAAU0G,aAAa,EAAE,CAAC,0BAA0B,EAAE/C,SAAS,EAAE;YAClFgD,OAAOJ,iBAAiBC,QAAQD,MAAMI,KAAK,GAAG5D;QAChD;IACF;AACF;AAEA,eAAe,SAAS6D;IACtB,OAAO;QACL9B,MAAM;QACN3C;QACAG;IACF;AACF"}

package/dist/esm/mcp/tools/message-send.d.ts

@@ -0,0 +1,66 @@
+import type { EnrichedExtra } from '@mcp-z/oauth-microsoft';
+import { type CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+import { z } from 'zod';
+declare const inputSchema: z.ZodObject<{
+    to: z.ZodString | z.ZodOptional<z.ZodString>;
+    cc: z.ZodString | z.ZodOptional<z.ZodString>;
+    bcc: z.ZodString | z.ZodOptional<z.ZodString>;
+    subject: z.ZodDefault<z.ZodString>;
+    body: z.ZodString;
+    contentType: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
+        text: "text";
+        html: "html";
+    }>>>;
+}, z.core.$strip>;
+declare const outputSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    id: z.ZodString;
+    threadId: z.ZodOptional<z.ZodString>;
+    sentAt: z.ZodString;
+    recipientCount: z.ZodNumber;
+    webLink: z.ZodOptional<z.ZodString>;
+    size: z.ZodOptional<z.ZodNumber>;
+    type: z.ZodLiteral<"success">;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"auth_required">;
+    provider: z.ZodString;
+    message: z.ZodString;
+    url: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>], "type">;
+export type Input = z.infer<typeof inputSchema>;
+export type Output = z.infer<typeof outputSchema>;
+declare function handler({ to, cc, bcc, subject, body, contentType }: Input, extra: EnrichedExtra): Promise<CallToolResult>;
+export default function createTool(): {
+    name: string;
+    config: {
+        readonly description: "Send an email message through Outlook";
+        readonly inputSchema: z.ZodObject<{
+            to: z.ZodString | z.ZodOptional<z.ZodString>;
+            cc: z.ZodString | z.ZodOptional<z.ZodString>;
+            bcc: z.ZodString | z.ZodOptional<z.ZodString>;
+            subject: z.ZodDefault<z.ZodString>;
+            body: z.ZodString;
+            contentType: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
+                text: "text";
+                html: "html";
+            }>>>;
+        }, z.core.$strip>;
+        readonly outputSchema: z.ZodObject<{
+            result: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                id: z.ZodString;
+                threadId: z.ZodOptional<z.ZodString>;
+                sentAt: z.ZodString;
+                recipientCount: z.ZodNumber;
+                webLink: z.ZodOptional<z.ZodString>;
+                size: z.ZodOptional<z.ZodNumber>;
+                type: z.ZodLiteral<"success">;
+            }, z.core.$strip>, z.ZodObject<{
+                type: z.ZodLiteral<"auth_required">;
+                provider: z.ZodString;
+                message: z.ZodString;
+                url: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>], "type">;
+        }, z.core.$strip>;
+    };
+    handler: typeof handler;
+};
+export {};

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

@@ -0,0 +1,111 @@
+import { ComposeContentTypeSchema, createEmailRecipientsSchema, createMessageResultSchema } from '@mcp-z/email';
+import { schemas } from '@mcp-z/oauth-microsoft';
+const { AuthRequiredBranchSchema } = schemas;
+import { Client } from '@microsoft/microsoft-graph-client';
+import { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';
+import { z } from 'zod';
+import { buildOutlookMessage } from '../../email/composition/outlook-message-builder.js';
+const MessageResultSchema = createMessageResultSchema('outlook');
+const inputSchema = z.object({
+    to: createEmailRecipientsSchema('to', true),
+    cc: createEmailRecipientsSchema('cc', false),
+    bcc: createEmailRecipientsSchema('bcc', false),
+    subject: z.string().describe('Email subject line').default(''),
+    body: z.string().trim().min(1).describe('Email body content (plain text or HTML)'),
+    contentType: ComposeContentTypeSchema
+});
+// Success branch schema
+const successBranchSchema = MessageResultSchema.extend({
+    type: z.literal('success')
+});
+// Output schema with auth_required support
+const outputSchema = z.discriminatedUnion('type', [
+    successBranchSchema,
+    AuthRequiredBranchSchema
+]);
+const config = {
+    description: 'Send an email message through Outlook',
+    inputSchema: inputSchema,
+    outputSchema: z.object({
+        result: outputSchema
+    })
+};
+async function handler({ to, cc, bcc, subject, body, contentType }, extra) {
+    const logger = extra.logger;
+    try {
+        var _ref, _ref1, _ref2;
+        var _message_toRecipients, _message_ccRecipients, _message_bccRecipients;
+        const graph = Client.initWithMiddleware({
+            authProvider: extra.authContext.auth
+        });
+        // Use composition module to build the message
+        const toArray = to === null || to === void 0 ? void 0 : to.split(',').map((addr)=>addr.trim()).filter((addr)=>addr);
+        const ccArray = cc === null || cc === void 0 ? void 0 : cc.split(',').map((addr)=>addr.trim()).filter((addr)=>addr);
+        const bccArray = bcc === null || bcc === void 0 ? void 0 : bcc.split(',').map((addr)=>addr.trim()).filter((addr)=>addr);
+        const message = buildOutlookMessage({
+            to: toArray,
+            cc: ccArray && ccArray.length > 0 ? ccArray : undefined,
+            bcc: bccArray && bccArray.length > 0 ? bccArray : undefined,
+            subject: subject !== null && subject !== void 0 ? subject : '',
+            body,
+            contentType: contentType === 'html' ? 'HTML' : 'Text'
+        });
+        // Use draft-send pattern to get message ID
+        // 1. Create draft message
+        const draft = await graph.api('/me/messages').post(message);
+        const messageId = draft.id;
+        if (!messageId) {
+            logger.error('outlook.message.send draft creation failed - no ID returned');
+            throw new McpError(ErrorCode.InternalError, 'Failed to create draft message');
+        }
+        // 2. Send the draft
+        await graph.api(`/me/messages/${messageId}/send`).post({});
+        logger.info('Outlook: sent mail successfully', {
+            messageId
+        });
+        const toCount = (_ref = (_message_toRecipients = message.toRecipients) === null || _message_toRecipients === void 0 ? void 0 : _message_toRecipients.length) !== null && _ref !== void 0 ? _ref : 0;
+        const ccCount = (_ref1 = (_message_ccRecipients = message.ccRecipients) === null || _message_ccRecipients === void 0 ? void 0 : _message_ccRecipients.length) !== null && _ref1 !== void 0 ? _ref1 : 0;
+        const bccCount = (_ref2 = (_message_bccRecipients = message.bccRecipients) === null || _message_bccRecipients === void 0 ? void 0 : _message_bccRecipients.length) !== null && _ref2 !== void 0 ? _ref2 : 0;
+        logger.info('outlook.message.send success', {
+            toCount,
+            ccCount,
+            bccCount,
+            subject: subject !== null && subject !== void 0 ? subject : '',
+            messageId
+        });
+        const totalRecipients = toCount + ccCount + bccCount;
+        const result = {
+            type: 'success',
+            id: messageId,
+            sentAt: new Date().toISOString(),
+            recipientCount: totalRecipients,
+            webLink: 'https://outlook.live.com/mail/0/sentitems'
+        };
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify(result)
+                }
+            ],
+            structuredContent: {
+                result
+            }
+        };
+    } catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        logger.error('outlook.message.send error', {
+            error: message
+        });
+        throw new McpError(ErrorCode.InternalError, `Error sending message: ${message}`, {
+            stack: error instanceof Error ? error.stack : undefined
+        });
+    }
+}
+export default function createTool() {
+    return {
+        name: 'message-send',
+        config,
+        handler
+    };
+}

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

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/kevin/Dev/Projects/ai/mcp-z/servers/mcp-outlook/src/mcp/tools/message-send.ts"],"sourcesContent":["import { ComposeContentTypeSchema, createEmailRecipientsSchema, createMessageResultSchema } from '@mcp-z/email';\nimport type { EnrichedExtra } from '@mcp-z/oauth-microsoft';\nimport { schemas } from '@mcp-z/oauth-microsoft';\n\nconst { AuthRequiredBranchSchema } = schemas;\n\nimport type { ToolModule } from '@mcp-z/server';\nimport { Client } from '@microsoft/microsoft-graph-client';\nimport { type CallToolResult, ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';\nimport { z } from 'zod';\nimport { buildOutlookMessage } from '../../email/composition/outlook-message-builder.js';\n\nconst MessageResultSchema = createMessageResultSchema('outlook');\n\nconst inputSchema = z.object({\n  to: createEmailRecipientsSchema('to', true),\n  cc: createEmailRecipientsSchema('cc', false),\n  bcc: createEmailRecipientsSchema('bcc', false),\n  subject: z.string().describe('Email subject line').default(''),\n  body: z.string().trim().min(1).describe('Email body content (plain text or HTML)'),\n  contentType: ComposeContentTypeSchema,\n});\n\n// Success branch schema\nconst successBranchSchema = MessageResultSchema.extend({\n  type: z.literal('success'),\n});\n\n// Output schema with auth_required support\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n  description: 'Send an email message through Outlook',\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({ to, cc, bcc, subject, body, contentType }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n  const logger = extra.logger;\n\n  try {\n    const graph = Client.initWithMiddleware({ authProvider: extra.authContext.auth });\n\n    // Use composition module to build the message\n    const toArray = to\n      ?.split(',')\n      .map((addr) => addr.trim())\n      .filter((addr) => addr);\n    const ccArray = cc\n      ?.split(',')\n      .map((addr) => addr.trim())\n      .filter((addr) => addr);\n    const bccArray = bcc\n      ?.split(',')\n      .map((addr) => addr.trim())\n      .filter((addr) => addr);\n\n    const message = buildOutlookMessage({\n      to: toArray,\n      cc: ccArray && ccArray.length > 0 ? ccArray : undefined,\n      bcc: bccArray && bccArray.length > 0 ? bccArray : undefined,\n      subject: subject ?? '',\n      body,\n      contentType: contentType === 'html' ? 'HTML' : 'Text',\n    });\n\n    // Use draft-send pattern to get message ID\n    // 1. Create draft message\n    const draft = await graph.api('/me/messages').post(message);\n    const messageId = draft.id;\n\n    if (!messageId) {\n      logger.error('outlook.message.send draft creation failed - no ID returned');\n      throw new McpError(ErrorCode.InternalError, 'Failed to create draft message');\n    }\n\n    // 2. Send the draft\n    await graph.api(`/me/messages/${messageId}/send`).post({});\n    logger.info('Outlook: sent mail successfully', { messageId });\n\n    const toCount = message.toRecipients?.length ?? 0;\n    const ccCount = message.ccRecipients?.length ?? 0;\n    const bccCount = message.bccRecipients?.length ?? 0;\n\n    logger.info('outlook.message.send success', { toCount, ccCount, bccCount, subject: subject ?? '', messageId });\n\n    const totalRecipients = toCount + ccCount + bccCount;\n    const result: Output = {\n      type: 'success' as const,\n      id: messageId,\n      sentAt: new Date().toISOString(),\n      recipientCount: totalRecipients,\n      webLink: 'https://outlook.live.com/mail/0/sentitems',\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('outlook.message.send error', { error: message });\n\n    throw new McpError(ErrorCode.InternalError, `Error sending message: ${message}`, {\n      stack: error instanceof Error ? error.stack : undefined,\n    });\n  }\n}\n\nexport default function createTool() {\n  return {\n    name: 'message-send',\n    config,\n    handler,\n  } satisfies ToolModule;\n}\n"],"names":["ComposeContentTypeSchema","createEmailRecipientsSchema","createMessageResultSchema","schemas","AuthRequiredBranchSchema","Client","ErrorCode","McpError","z","buildOutlookMessage","MessageResultSchema","inputSchema","object","to","cc","bcc","subject","string","describe","default","body","trim","min","contentType","successBranchSchema","extend","type","literal","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","message","graph","initWithMiddleware","authProvider","authContext","auth","toArray","split","map","addr","filter","ccArray","bccArray","length","undefined","draft","api","post","messageId","id","error","InternalError","info","toCount","toRecipients","ccCount","ccRecipients","bccCount","bccRecipients","totalRecipients","sentAt","Date","toISOString","recipientCount","webLink","content","text","JSON","stringify","structuredContent","Error","String","stack","createTool","name"],"mappings":"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"}

package/dist/esm/mcp/tools/messages-export-csv.d.ts

@@ -0,0 +1,72 @@
+/** Outlook message CSV export tool - streams results to file without loading all data into context */
+import type { EnrichedExtra } from '@mcp-z/oauth-microsoft';
+import { type CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+import { z } from 'zod';
+import type { StorageExtra } from '../../types.js';
+declare const inputSchema: z.ZodObject<{
+    query: z.ZodOptional<z.ZodType<import("../../types.js").OutlookQuery, unknown, z.core.$ZodTypeInternals<import("../../types.js").OutlookQuery, unknown>>>;
+    maxItems: z.ZodDefault<z.ZodNumber>;
+    filename: z.ZodDefault<z.ZodString>;
+    contentType: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
+        text: "text";
+        html: "html";
+    }>>>;
+    excludeThreadHistory: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, z.core.$strip>;
+declare const outputSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    uri: z.ZodString;
+    filename: z.ZodString;
+    rowCount: z.ZodNumber;
+    truncated: z.ZodBoolean;
+    type: z.ZodLiteral<"success">;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"auth_required">;
+    provider: z.ZodString;
+    message: z.ZodString;
+    url: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>], "type">;
+export type Input = z.infer<typeof inputSchema>;
+export type Output = z.infer<typeof outputSchema>;
+/**
+ * Handler for outlook-messages-export-csv tool
+ *
+ * CRITICAL: Streaming implementation per user requirements
+ * - Generate UUID upfront
+ * - Write CSV header immediately
+ * - Append rows as batches arrive
+ * - Delete partial file on error
+ * - NO RETRIES (fail fast on error)
+ */
+declare function handler({ query, maxItems, filename, contentType, excludeThreadHistory }: Input, extra: EnrichedExtra & StorageExtra): Promise<CallToolResult>;
+export default function createTool(): {
+    name: string;
+    config: {
+        readonly description: "Export Outlook messages to CSV with streaming pagination. Returns file URI. Use query-syntax prompt for query reference.";
+        readonly inputSchema: z.ZodObject<{
+            query: z.ZodOptional<z.ZodType<import("../../types.js").OutlookQuery, unknown, z.core.$ZodTypeInternals<import("../../types.js").OutlookQuery, unknown>>>;
+            maxItems: z.ZodDefault<z.ZodNumber>;
+            filename: z.ZodDefault<z.ZodString>;
+            contentType: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
+                text: "text";
+                html: "html";
+            }>>>;
+            excludeThreadHistory: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        }, z.core.$strip>;
+        readonly outputSchema: z.ZodObject<{
+            result: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                uri: z.ZodString;
+                filename: z.ZodString;
+                rowCount: z.ZodNumber;
+                truncated: z.ZodBoolean;
+                type: z.ZodLiteral<"success">;
+            }, z.core.$strip>, z.ZodObject<{
+                type: z.ZodLiteral<"auth_required">;
+                provider: z.ZodString;
+                message: z.ZodString;
+                url: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>], "type">;
+        }, z.core.$strip>;
+    };
+    handler: typeof handler;
+};
+export {};