@mcp-z/mcp-outlook 1.0.0

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

@@ -0,0 +1,298 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+Object.defineProperty(exports, "default", {
+    enumerable: true,
+    get: function() {
+        return createTool;
+    }
+});
+var _email = require("@mcp-z/email");
+var _oauthmicrosoft = require("@mcp-z/oauth-microsoft");
+var _microsoftgraphclient = require("@microsoft/microsoft-graph-client");
+var _types = require("@modelcontextprotocol/sdk/types.js");
+var _zod = require("zod");
+var _outlookmessagebuilder = require("../../email/composition/outlook-message-builder.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 _instanceof(left, right) {
+    if (right != null && typeof Symbol !== "undefined" && right[Symbol.hasInstance]) {
+        return !!right[Symbol.hasInstance](left);
+    } else {
+        return left instanceof right;
+    }
+}
+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 = _oauthmicrosoft.schemas.AuthRequiredBranchSchema;
+var MessageResultSchema = (0, _email.createMessageResultSchema)('outlook');
+var inputSchema = _zod.z.object({
+    to: (0, _email.createEmailRecipientsSchema)('to', true),
+    cc: (0, _email.createEmailRecipientsSchema)('cc', false),
+    bcc: (0, _email.createEmailRecipientsSchema)('bcc', false),
+    subject: _zod.z.string().describe('Email subject line').default(''),
+    body: _zod.z.string().trim().min(1).describe('Email body content (plain text or HTML)'),
+    contentType: _email.ComposeContentTypeSchema
+});
+// Success branch schema
+var successBranchSchema = MessageResultSchema.extend({
+    type: _zod.z.literal('success')
+});
+// Output schema with auth_required support
+var outputSchema = _zod.z.discriminatedUnion('type', [
+    successBranchSchema,
+    AuthRequiredBranchSchema
+]);
+var config = {
+    description: 'Send an email message through Outlook',
+    inputSchema: inputSchema,
+    outputSchema: _zod.z.object({
+        result: outputSchema
+    })
+};
+function handler(_0, _1) {
+    return _async_to_generator(function(param, extra) {
+        var to, cc, bcc, subject, body, contentType, logger, _ref, _ref1, _ref2, _message_toRecipients, _message_ccRecipients, _message_bccRecipients, graph, toArray, ccArray, bccArray, message, draft, messageId, toCount, ccCount, bccCount, totalRecipients, result, error, message1;
+        return _ts_generator(this, function(_state) {
+            switch(_state.label){
+                case 0:
+                    to = param.to, cc = param.cc, bcc = param.bcc, subject = param.subject, body = param.body, contentType = param.contentType;
+                    logger = extra.logger;
+                    _state.label = 1;
+                case 1:
+                    _state.trys.push([
+                        1,
+                        4,
+                        ,
+                        5
+                    ]);
+                    graph = _microsoftgraphclient.Client.initWithMiddleware({
+                        authProvider: extra.authContext.auth
+                    });
+                    // Use composition module to build the message
+                    toArray = to === null || to === void 0 ? void 0 : to.split(',').map(function(addr) {
+                        return addr.trim();
+                    }).filter(function(addr) {
+                        return addr;
+                    });
+                    ccArray = cc === null || cc === void 0 ? void 0 : cc.split(',').map(function(addr) {
+                        return addr.trim();
+                    }).filter(function(addr) {
+                        return addr;
+                    });
+                    bccArray = bcc === null || bcc === void 0 ? void 0 : bcc.split(',').map(function(addr) {
+                        return addr.trim();
+                    }).filter(function(addr) {
+                        return addr;
+                    });
+                    message = (0, _outlookmessagebuilder.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: body,
+                        contentType: contentType === 'html' ? 'HTML' : 'Text'
+                    });
+                    return [
+                        4,
+                        graph.api('/me/messages').post(message)
+                    ];
+                case 2:
+                    draft = _state.sent();
+                    messageId = draft.id;
+                    if (!messageId) {
+                        logger.error('outlook.message.send draft creation failed - no ID returned');
+                        throw new _types.McpError(_types.ErrorCode.InternalError, 'Failed to create draft message');
+                    }
+                    // 2. Send the draft
+                    return [
+                        4,
+                        graph.api("/me/messages/".concat(messageId, "/send")).post({})
+                    ];
+                case 3:
+                    _state.sent();
+                    logger.info('Outlook: sent mail successfully', {
+                        messageId: messageId
+                    });
+                    toCount = (_ref = (_message_toRecipients = message.toRecipients) === null || _message_toRecipients === void 0 ? void 0 : _message_toRecipients.length) !== null && _ref !== void 0 ? _ref : 0;
+                    ccCount = (_ref1 = (_message_ccRecipients = message.ccRecipients) === null || _message_ccRecipients === void 0 ? void 0 : _message_ccRecipients.length) !== null && _ref1 !== void 0 ? _ref1 : 0;
+                    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: toCount,
+                        ccCount: ccCount,
+                        bccCount: bccCount,
+                        subject: subject !== null && subject !== void 0 ? subject : '',
+                        messageId: messageId
+                    });
+                    totalRecipients = toCount + ccCount + bccCount;
+                    result = {
+                        type: 'success',
+                        id: messageId,
+                        sentAt: new Date().toISOString(),
+                        recipientCount: totalRecipients,
+                        webLink: 'https://outlook.live.com/mail/0/sentitems'
+                    };
+                    return [
+                        2,
+                        {
+                            content: [
+                                {
+                                    type: 'text',
+                                    text: JSON.stringify(result)
+                                }
+                            ],
+                            structuredContent: {
+                                result: result
+                            }
+                        }
+                    ];
+                case 4:
+                    error = _state.sent();
+                    message1 = _instanceof(error, Error) ? error.message : String(error);
+                    logger.error('outlook.message.send error', {
+                        error: message1
+                    });
+                    throw new _types.McpError(_types.ErrorCode.InternalError, "Error sending message: ".concat(message1), {
+                        stack: _instanceof(error, Error) ? error.stack : undefined
+                    });
+                case 5:
+                    return [
+                        2
+                    ];
+            }
+        });
+    }).apply(this, arguments);
+}
+function createTool() {
+    return {
+        name: 'message-send',
+        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-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":["createTool","AuthRequiredBranchSchema","schemas","MessageResultSchema","createMessageResultSchema","inputSchema","z","object","to","createEmailRecipientsSchema","cc","bcc","subject","string","describe","default","body","trim","min","contentType","ComposeContentTypeSchema","successBranchSchema","extend","type","literal","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","message","graph","toArray","ccArray","bccArray","draft","messageId","toCount","ccCount","bccCount","totalRecipients","error","Client","initWithMiddleware","authProvider","authContext","auth","split","map","addr","filter","buildOutlookMessage","length","undefined","api","post","id","McpError","ErrorCode","InternalError","info","toRecipients","ccRecipients","bccRecipients","sentAt","Date","toISOString","recipientCount","webLink","content","text","JSON","stringify","structuredContent","Error","String","stack","name"],"mappings":";;;;+BAuHA;;;eAAwBA;;;qBAvHyE;8BAEzE;oCAKD;qBACkC;mBACvC;qCACkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AANpC,IAAM,AAAEC,2BAA6BC,uBAAO,CAApCD;AAQR,IAAME,sBAAsBC,IAAAA,gCAAyB,EAAC;AAEtD,IAAMC,cAAcC,MAAC,CAACC,MAAM,CAAC;IAC3BC,IAAIC,IAAAA,kCAA2B,EAAC,MAAM;IACtCC,IAAID,IAAAA,kCAA2B,EAAC,MAAM;IACtCE,KAAKF,IAAAA,kCAA2B,EAAC,OAAO;IACxCG,SAASN,MAAC,CAACO,MAAM,GAAGC,QAAQ,CAAC,sBAAsBC,OAAO,CAAC;IAC3DC,MAAMV,MAAC,CAACO,MAAM,GAAGI,IAAI,GAAGC,GAAG,CAAC,GAAGJ,QAAQ,CAAC;IACxCK,aAAaC,+BAAwB;AACvC;AAEA,wBAAwB;AACxB,IAAMC,sBAAsBlB,oBAAoBmB,MAAM,CAAC;IACrDC,MAAMjB,MAAC,CAACkB,OAAO,CAAC;AAClB;AAEA,2CAA2C;AAC3C,IAAMC,eAAenB,MAAC,CAACoB,kBAAkB,CAAC,QAAQ;IAACL;IAAqBpB;CAAyB;AAEjG,IAAM0B,SAAS;IACbC,aAAa;IACbvB,aAAaA;IACboB,cAAcnB,MAAC,CAACC,MAAM,CAAC;QACrBsB,QAAQJ;IACV;AACF;AAKA,SAAeK;wCAAQ,KAAkD,EAAEC,KAAoB;YAAtEvB,IAAIE,IAAIC,KAAKC,SAASI,MAAMG,aAC7Ca,4BA0CYC,uBACAA,uBACCA,wBAzCXC,OAGAC,SAIAC,SAIAC,UAKAJ,SAWAK,OACAC,WAWAC,SACAC,SACAC,UAIAC,iBACAd,QAiBCe,OACDX;;;;oBApEezB,KAAF,MAAEA,IAAIE,KAAN,MAAMA,IAAIC,MAAV,MAAUA,KAAKC,UAAf,MAAeA,SAASI,OAAxB,MAAwBA,MAAMG,cAA9B,MAA8BA;oBAC7Ca,SAASD,MAAMC,MAAM;;;;;;;;;oBAGnBE,QAAQW,4BAAM,CAACC,kBAAkB,CAAC;wBAAEC,cAAchB,MAAMiB,WAAW,CAACC,IAAI;oBAAC;oBAE/E,8CAA8C;oBACxCd,UAAU3B,eAAAA,yBAAAA,GACZ0C,KAAK,CAAC,KACPC,GAAG,CAAC,SAACC;+BAASA,KAAKnC,IAAI;uBACvBoC,MAAM,CAAC,SAACD;+BAASA;;oBACdhB,UAAU1B,eAAAA,yBAAAA,GACZwC,KAAK,CAAC,KACPC,GAAG,CAAC,SAACC;+BAASA,KAAKnC,IAAI;uBACvBoC,MAAM,CAAC,SAACD;+BAASA;;oBACdf,WAAW1B,gBAAAA,0BAAAA,IACbuC,KAAK,CAAC,KACPC,GAAG,CAAC,SAACC;+BAASA,KAAKnC,IAAI;uBACvBoC,MAAM,CAAC,SAACD;+BAASA;;oBAEdnB,UAAUqB,IAAAA,0CAAmB,EAAC;wBAClC9C,IAAI2B;wBACJzB,IAAI0B,WAAWA,QAAQmB,MAAM,GAAG,IAAInB,UAAUoB;wBAC9C7C,KAAK0B,YAAYA,SAASkB,MAAM,GAAG,IAAIlB,WAAWmB;wBAClD5C,OAAO,EAAEA,oBAAAA,qBAAAA,UAAW;wBACpBI,MAAAA;wBACAG,aAAaA,gBAAgB,SAAS,SAAS;oBACjD;oBAIc;;wBAAMe,MAAMuB,GAAG,CAAC,gBAAgBC,IAAI,CAACzB;;;oBAA7CK,QAAQ;oBACRC,YAAYD,MAAMqB,EAAE;oBAE1B,IAAI,CAACpB,WAAW;wBACdP,OAAOY,KAAK,CAAC;wBACb,MAAM,IAAIgB,eAAQ,CAACC,gBAAS,CAACC,aAAa,EAAE;oBAC9C;oBAEA,oBAAoB;oBACpB;;wBAAM5B,MAAMuB,GAAG,CAAC,AAAC,gBAAyB,OAAVlB,WAAU,UAAQmB,IAAI,CAAC,CAAC;;;oBAAxD;oBACA1B,OAAO+B,IAAI,CAAC,mCAAmC;wBAAExB,WAAAA;oBAAU;oBAErDC,mBAAUP,wBAAAA,QAAQ+B,YAAY,cAApB/B,4CAAAA,sBAAsBsB,MAAM,uCAAI;oBAC1Cd,oBAAUR,wBAAAA,QAAQgC,YAAY,cAApBhC,4CAAAA,sBAAsBsB,MAAM,yCAAI;oBAC1Cb,qBAAWT,yBAAAA,QAAQiC,aAAa,cAArBjC,6CAAAA,uBAAuBsB,MAAM,yCAAI;oBAElDvB,OAAO+B,IAAI,CAAC,gCAAgC;wBAAEvB,SAAAA;wBAASC,SAAAA;wBAASC,UAAAA;wBAAU9B,OAAO,EAAEA,oBAAAA,qBAAAA,UAAW;wBAAI2B,WAAAA;oBAAU;oBAEtGI,kBAAkBH,UAAUC,UAAUC;oBACtCb,SAAiB;wBACrBN,MAAM;wBACNoC,IAAIpB;wBACJ4B,QAAQ,IAAIC,OAAOC,WAAW;wBAC9BC,gBAAgB3B;wBAChB4B,SAAS;oBACX;oBAEA;;wBAAO;4BACLC,OAAO;gCACL;oCACEjD,MAAM;oCACNkD,MAAMC,KAAKC,SAAS,CAAC9C;gCACvB;;4BAEF+C,mBAAmB;gCAAE/C,QAAAA;4BAAO;wBAC9B;;;oBACOe;oBACDX,WAAUW,AAAK,YAALA,OAAiBiC,SAAQjC,MAAMX,OAAO,GAAG6C,OAAOlC;oBAChEZ,OAAOY,KAAK,CAAC,8BAA8B;wBAAEA,OAAOX;oBAAQ;oBAE5D,MAAM,IAAI2B,eAAQ,CAACC,gBAAS,CAACC,aAAa,EAAE,AAAC,0BAAiC,OAAR7B,WAAW;wBAC/E8C,OAAOnC,AAAK,YAALA,OAAiBiC,SAAQjC,MAAMmC,KAAK,GAAGvB;oBAChD;;;;;;;IAEJ;;AAEe,SAASxD;IACtB,OAAO;QACLgF,MAAM;QACNrD,QAAAA;QACAG,SAAAA;IACF;AACF"}

package/dist/cjs/mcp/tools/messages-export-csv.d.cts

@@ -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 {};

package/dist/cjs/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 {};