@mcp-z/mcp-outlook 1.0.0

package/dist/cjs/email/parsing/message-extraction.js

@@ -0,0 +1,192 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+Object.defineProperty(exports, "fetchOutlookMessage", {
+    enumerable: true,
+    get: function() {
+        return fetchOutlookMessage;
+    }
+});
+var _messagemapping = require("./message-mapping.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 _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
+        };
+    }
+}
+function fetchOutlookMessage(graph, id) {
+    return _async_to_generator(function() {
+        var selectFields, data, e, status;
+        return _ts_generator(this, function(_state) {
+            switch(_state.label){
+                case 0:
+                    if (!id) throw new Error('fetchOutlookMessage: id required');
+                    selectFields = [
+                        'id',
+                        'conversationId',
+                        'receivedDateTime',
+                        'subject',
+                        'from',
+                        'toRecipients',
+                        'ccRecipients',
+                        'bccRecipients',
+                        'bodyPreview',
+                        'categories',
+                        'body'
+                    ];
+                    _state.label = 1;
+                case 1:
+                    _state.trys.push([
+                        1,
+                        3,
+                        ,
+                        4
+                    ]);
+                    return [
+                        4,
+                        graph.api("/me/messages/".concat(encodeURIComponent(id))).select(selectFields.join(',')).get()
+                    ];
+                case 2:
+                    data = _state.sent();
+                    return [
+                        2,
+                        (0, _messagemapping.mapOutlookMessage)(data, {
+                            preferHtml: true
+                        })
+                    ];
+                case 3:
+                    e = _state.sent();
+                    status = (e === null || e === void 0 ? void 0 : e.status) || (e === null || e === void 0 ? void 0 : e.code) || 'unknown';
+                    throw new Error("outlook.fetchMessage: failed (".concat(status, ")"));
+                case 4:
+                    return [
+                        2
+                    ];
+            }
+        });
+    })();
+}
+/* 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/email/parsing/message-extraction.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/kevin/Dev/Projects/ai/mcp-z/servers/mcp-outlook/src/email/parsing/message-extraction.ts"],"sourcesContent":["import type { Client } from '@microsoft/microsoft-graph-client';\nimport type { OutlookMessage } from '../../lib/outlook/types.js';\nimport { mapOutlookMessage, type NormalizedMessage } from './message-mapping.js';\n\n/** Fetch a single Outlook message. Throws on non-OK Graph responses. */\nexport async function fetchOutlookMessage(graph: Client, id: string): Promise<NormalizedMessage> {\n  if (!id) throw new Error('fetchOutlookMessage: id required');\n  const selectFields = ['id', 'conversationId', 'receivedDateTime', 'subject', 'from', 'toRecipients', 'ccRecipients', 'bccRecipients', 'bodyPreview', 'categories', 'body'];\n  try {\n    const data: unknown = await graph\n      .api(`/me/messages/${encodeURIComponent(id)}`)\n      .select(selectFields.join(','))\n      .get();\n    return mapOutlookMessage(data as OutlookMessage, { preferHtml: true });\n  } catch (e: unknown) {\n    const status = (e as Record<string, unknown>)?.status || (e as Record<string, unknown>)?.code || 'unknown';\n    throw new Error(`outlook.fetchMessage: failed (${status})`);\n  }\n}\n"],"names":["fetchOutlookMessage","graph","id","selectFields","data","e","status","Error","api","encodeURIComponent","select","join","get","mapOutlookMessage","preferHtml","code"],"mappings":";;;;+BAKsBA;;;eAAAA;;;8BAHoC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAGnD,SAAeA,oBAAoBC,KAAa,EAAEC,EAAU;;YAE3DC,cAEEC,MAKCC,GACDC;;;;oBATR,IAAI,CAACJ,IAAI,MAAM,IAAIK,MAAM;oBACnBJ;wBAAgB;wBAAM;wBAAkB;wBAAoB;wBAAW;wBAAQ;wBAAgB;wBAAgB;wBAAiB;wBAAe;wBAAc;;;;;;;;;;oBAE3I;;wBAAMF,MACzBO,GAAG,CAAC,AAAC,gBAAsC,OAAvBC,mBAAmBP,MACvCQ,MAAM,CAACP,aAAaQ,IAAI,CAAC,MACzBC,GAAG;;;oBAHAR,OAAgB;oBAItB;;wBAAOS,IAAAA,iCAAiB,EAACT,MAAwB;4BAAEU,YAAY;wBAAK;;;oBAC7DT;oBACDC,SAAS,CAACD,cAAAA,wBAAD,AAACA,EAA+BC,MAAM,MAAKD,cAAAA,wBAAD,AAACA,EAA+BU,IAAI,KAAI;oBACjG,MAAM,IAAIR,MAAM,AAAC,iCAAuC,OAAPD,QAAO;;;;;;;IAE5D"}

package/dist/cjs/email/parsing/message-mapping.d.cts

@@ -0,0 +1,21 @@
+import type { OutlookMessage } from '../../lib/outlook/types.js';
+export interface NormalizedAddress {
+    address?: string | undefined;
+    name?: string | undefined;
+}
+export interface NormalizedMessage {
+    id: string;
+    threadId?: string;
+    date?: string;
+    subject?: string;
+    from?: NormalizedAddress;
+    to?: string[];
+    cc?: string[];
+    bcc?: string[];
+    snippet?: string;
+    labels?: string[];
+    body?: string;
+}
+export declare function mapOutlookMessage(msg: OutlookMessage, opts?: {
+    preferHtml?: boolean;
+}): NormalizedMessage;

package/dist/cjs/email/parsing/message-mapping.d.ts

@@ -0,0 +1,21 @@
+import type { OutlookMessage } from '../../lib/outlook/types.js';
+export interface NormalizedAddress {
+    address?: string | undefined;
+    name?: string | undefined;
+}
+export interface NormalizedMessage {
+    id: string;
+    threadId?: string;
+    date?: string;
+    subject?: string;
+    from?: NormalizedAddress;
+    to?: string[];
+    cc?: string[];
+    bcc?: string[];
+    snippet?: string;
+    labels?: string[];
+    body?: string;
+}
+export declare function mapOutlookMessage(msg: OutlookMessage, opts?: {
+    preferHtml?: boolean;
+}): NormalizedMessage;

package/dist/cjs/email/parsing/message-mapping.js

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+Object.defineProperty(exports, "mapOutlookMessage", {
+    enumerable: true,
+    get: function() {
+        return mapOutlookMessage;
+    }
+});
+var _email = require("@mcp-z/email");
+var _headerparsing = require("./header-parsing.js");
+function mapOutlookMessage(msg) {
+    var opts = arguments.length > 1 && arguments[1] !== void 0 ? arguments[1] : {};
+    var _ref, _ref1, _msg_id, _toIsoUtc, _msg_toRecipients, _msg_ccRecipients, _msg_bccRecipients;
+    var _msg_from, _msg_body, _msg_body1;
+    var fromAddr = (_msg_from = msg.from) === null || _msg_from === void 0 ? void 0 : _msg_from.emailAddress;
+    var bodyContent = (_ref = (_msg_body = msg.body) === null || _msg_body === void 0 ? void 0 : _msg_body.content) !== null && _ref !== void 0 ? _ref : '';
+    var bodyType = String((_ref1 = (_msg_body1 = msg.body) === null || _msg_body1 === void 0 ? void 0 : _msg_body1.contentType) !== null && _ref1 !== void 0 ? _ref1 : '').toLowerCase();
+    var body;
+    if (bodyContent) {
+        if (opts.preferHtml && bodyType === 'html') body = (0, _email.stripHtml)(bodyContent);
+        else body = bodyType === 'html' ? (0, _email.stripHtml)(bodyContent) : String(bodyContent);
+    }
+    var out = {
+        id: (_msg_id = msg.id) !== null && _msg_id !== void 0 ? _msg_id : ''
+    };
+    if (msg.conversationId) out.threadId = String(msg.conversationId);
+    if (msg.receivedDateTime) out.date = (_toIsoUtc = (0, _email.normalizeDateToISO)(msg.receivedDateTime)) !== null && _toIsoUtc !== void 0 ? _toIsoUtc : String(msg.receivedDateTime);
+    if (msg.subject) out.subject = String(msg.subject);
+    var fromObj = fromAddr ? {
+        address: fromAddr.address || undefined,
+        name: fromAddr.name || undefined
+    } : undefined;
+    if (fromObj && (fromObj.address || fromObj.name)) out.from = fromObj;
+    var toList = (0, _headerparsing.extractEmailsFromRecipients)((_msg_toRecipients = msg.toRecipients) !== null && _msg_toRecipients !== void 0 ? _msg_toRecipients : []);
+    if (Array.isArray(toList) && toList.length) out.to = toList;
+    var ccList = (0, _headerparsing.extractEmailsFromRecipients)((_msg_ccRecipients = msg.ccRecipients) !== null && _msg_ccRecipients !== void 0 ? _msg_ccRecipients : []);
+    if (Array.isArray(ccList) && ccList.length) out.cc = ccList;
+    var bccList = (0, _headerparsing.extractEmailsFromRecipients)((_msg_bccRecipients = msg.bccRecipients) !== null && _msg_bccRecipients !== void 0 ? _msg_bccRecipients : []);
+    if (Array.isArray(bccList) && bccList.length) out.bcc = bccList;
+    if (msg.bodyPreview) out.snippet = String(msg.bodyPreview);
+    if (Array.isArray(msg.categories) && msg.categories.length) out.labels = msg.categories.map(String);
+    if (body) out.body = body;
+    return out;
+}
+/* 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/email/parsing/message-mapping.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/kevin/Dev/Projects/ai/mcp-z/servers/mcp-outlook/src/email/parsing/message-mapping.ts"],"sourcesContent":["import { stripHtml, normalizeDateToISO as toIsoUtc } from '@mcp-z/email';\nimport type { OutlookMessage } from '../../lib/outlook/types.js';\nimport { extractEmailsFromRecipients } from './header-parsing.js';\n\nexport interface NormalizedAddress {\n  address?: string | undefined;\n  name?: string | undefined;\n}\nexport interface NormalizedMessage {\n  id: string;\n  threadId?: string;\n  date?: string;\n  subject?: string;\n  from?: NormalizedAddress;\n  to?: string[];\n  cc?: string[];\n  bcc?: string[];\n  snippet?: string;\n  labels?: string[];\n  body?: string;\n}\n\nexport function mapOutlookMessage(msg: OutlookMessage, opts: { preferHtml?: boolean } = {}): NormalizedMessage {\n  const fromAddr = msg.from?.emailAddress;\n  const bodyContent = msg.body?.content ?? '';\n  const bodyType = String(msg.body?.contentType ?? '').toLowerCase();\n\n  let body: string | undefined;\n  if (bodyContent) {\n    if (opts.preferHtml && bodyType === 'html') body = stripHtml(bodyContent);\n    else body = bodyType === 'html' ? stripHtml(bodyContent) : String(bodyContent);\n  }\n\n  const out: NormalizedMessage = { id: msg.id ?? '' };\n\n  if (msg.conversationId) out.threadId = String(msg.conversationId);\n  if (msg.receivedDateTime) out.date = toIsoUtc(msg.receivedDateTime) ?? String(msg.receivedDateTime);\n  if (msg.subject) out.subject = String(msg.subject);\n\n  const fromObj = fromAddr ? { address: fromAddr.address || undefined, name: fromAddr.name || undefined } : undefined;\n  if (fromObj && (fromObj.address || fromObj.name)) out.from = fromObj;\n\n  const toList = extractEmailsFromRecipients(msg.toRecipients ?? []);\n  if (Array.isArray(toList) && toList.length) out.to = toList;\n\n  const ccList = extractEmailsFromRecipients(msg.ccRecipients ?? []);\n  if (Array.isArray(ccList) && ccList.length) out.cc = ccList;\n\n  const bccList = extractEmailsFromRecipients(msg.bccRecipients ?? []);\n  if (Array.isArray(bccList) && bccList.length) out.bcc = bccList;\n\n  if (msg.bodyPreview) out.snippet = String(msg.bodyPreview);\n  if (Array.isArray(msg.categories) && msg.categories.length) out.labels = msg.categories.map(String);\n  if (body) out.body = body;\n\n  return out;\n}\n"],"names":["mapOutlookMessage","msg","opts","toIsoUtc","fromAddr","from","emailAddress","bodyContent","body","content","bodyType","String","contentType","toLowerCase","preferHtml","stripHtml","out","id","conversationId","threadId","receivedDateTime","date","subject","fromObj","address","undefined","name","toList","extractEmailsFromRecipients","toRecipients","Array","isArray","length","to","ccList","ccRecipients","cc","bccList","bccRecipients","bcc","bodyPreview","snippet","categories","labels","map"],"mappings":";;;;+BAsBgBA;;;eAAAA;;;qBAtB0C;6BAEd;AAoBrC,SAASA,kBAAkBC,GAAmB;QAAEC,OAAAA,iEAAiC,CAAC;qBAWlDD,SAGAE,WAMMF,mBAGAA,mBAGCA;QAzB3BA,WACGA,WACIA;IAFxB,IAAMG,YAAWH,YAAAA,IAAII,IAAI,cAARJ,gCAAAA,UAAUK,YAAY;IACvC,IAAMC,uBAAcN,YAAAA,IAAIO,IAAI,cAARP,gCAAAA,UAAUQ,OAAO,uCAAI;IACzC,IAAMC,WAAWC,iBAAOV,aAAAA,IAAIO,IAAI,cAARP,iCAAAA,WAAUW,WAAW,yCAAI,IAAIC,WAAW;IAEhE,IAAIL;IACJ,IAAID,aAAa;QACf,IAAIL,KAAKY,UAAU,IAAIJ,aAAa,QAAQF,OAAOO,IAAAA,gBAAS,EAACR;aACxDC,OAAOE,aAAa,SAASK,IAAAA,gBAAS,EAACR,eAAeI,OAAOJ;IACpE;IAEA,IAAMS,MAAyB;QAAEC,EAAE,GAAEhB,UAAAA,IAAIgB,EAAE,cAANhB,qBAAAA,UAAU;IAAG;IAElD,IAAIA,IAAIiB,cAAc,EAAEF,IAAIG,QAAQ,GAAGR,OAAOV,IAAIiB,cAAc;IAChE,IAAIjB,IAAImB,gBAAgB,EAAEJ,IAAIK,IAAI,IAAGlB,YAAAA,IAAAA,yBAAQ,EAACF,IAAImB,gBAAgB,eAA7BjB,uBAAAA,YAAkCQ,OAAOV,IAAImB,gBAAgB;IAClG,IAAInB,IAAIqB,OAAO,EAAEN,IAAIM,OAAO,GAAGX,OAAOV,IAAIqB,OAAO;IAEjD,IAAMC,UAAUnB,WAAW;QAAEoB,SAASpB,SAASoB,OAAO,IAAIC;QAAWC,MAAMtB,SAASsB,IAAI,IAAID;IAAU,IAAIA;IAC1G,IAAIF,WAAYA,CAAAA,QAAQC,OAAO,IAAID,QAAQG,IAAI,AAAD,GAAIV,IAAIX,IAAI,GAAGkB;IAE7D,IAAMI,SAASC,IAAAA,0CAA2B,GAAC3B,oBAAAA,IAAI4B,YAAY,cAAhB5B,+BAAAA,oBAAoB,EAAE;IACjE,IAAI6B,MAAMC,OAAO,CAACJ,WAAWA,OAAOK,MAAM,EAAEhB,IAAIiB,EAAE,GAAGN;IAErD,IAAMO,SAASN,IAAAA,0CAA2B,GAAC3B,oBAAAA,IAAIkC,YAAY,cAAhBlC,+BAAAA,oBAAoB,EAAE;IACjE,IAAI6B,MAAMC,OAAO,CAACG,WAAWA,OAAOF,MAAM,EAAEhB,IAAIoB,EAAE,GAAGF;IAErD,IAAMG,UAAUT,IAAAA,0CAA2B,GAAC3B,qBAAAA,IAAIqC,aAAa,cAAjBrC,gCAAAA,qBAAqB,EAAE;IACnE,IAAI6B,MAAMC,OAAO,CAACM,YAAYA,QAAQL,MAAM,EAAEhB,IAAIuB,GAAG,GAAGF;IAExD,IAAIpC,IAAIuC,WAAW,EAAExB,IAAIyB,OAAO,GAAG9B,OAAOV,IAAIuC,WAAW;IACzD,IAAIV,MAAMC,OAAO,CAAC9B,IAAIyC,UAAU,KAAKzC,IAAIyC,UAAU,CAACV,MAAM,EAAEhB,IAAI2B,MAAM,GAAG1C,IAAIyC,UAAU,CAACE,GAAG,CAACjC;IAC5F,IAAIH,MAAMQ,IAAIR,IAAI,GAAGA;IAErB,OAAOQ;AACT"}

package/dist/cjs/email/querying/execute-query.d.cts

@@ -0,0 +1,20 @@
+import type { ExecutionResult } from '@mcp-z/email';
+import type { Client } from '@microsoft/microsoft-graph-client';
+import type { OutlookQuery as QueryNode } from '../../schemas/outlook-query-schema.js';
+import type { Logger } from '../../types.js';
+export interface ExecuteQueryOptions {
+    readonly logger: Logger;
+    readonly limit?: number;
+    readonly includeBody?: boolean;
+    readonly maxPages?: number | null;
+    readonly pageSize?: number;
+    readonly pageToken?: string;
+    readonly timezone?: string;
+    readonly abortSignal?: AbortSignal;
+}
+/**
+ * Execute an Outlook query with direct, single-attempt execution.
+ * No planning, no fallbacks, no retries.
+ * Microsoft Graph errors are returned directly to the caller for actionable feedback.
+ */
+export declare function executeQuery<T>(graph: Client, query: QueryNode | undefined, options: ExecuteQueryOptions, transform: (item: unknown) => T): Promise<ExecutionResult<T>>;

package/dist/cjs/email/querying/execute-query.d.ts

@@ -0,0 +1,20 @@
+import type { ExecutionResult } from '@mcp-z/email';
+import type { Client } from '@microsoft/microsoft-graph-client';
+import type { OutlookQuery as QueryNode } from '../../schemas/outlook-query-schema.js';
+import type { Logger } from '../../types.js';
+export interface ExecuteQueryOptions {
+    readonly logger: Logger;
+    readonly limit?: number;
+    readonly includeBody?: boolean;
+    readonly maxPages?: number | null;
+    readonly pageSize?: number;
+    readonly pageToken?: string;
+    readonly timezone?: string;
+    readonly abortSignal?: AbortSignal;
+}
+/**
+ * Execute an Outlook query with direct, single-attempt execution.
+ * No planning, no fallbacks, no retries.
+ * Microsoft Graph errors are returned directly to the caller for actionable feedback.
+ */
+export declare function executeQuery<T>(graph: Client, query: QueryNode | undefined, options: ExecuteQueryOptions, transform: (item: unknown) => T): Promise<ExecutionResult<T>>;

package/dist/cjs/email/querying/execute-query.js

@@ -0,0 +1,268 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+Object.defineProperty(exports, "executeQuery", {
+    enumerable: true,
+    get: function() {
+        return executeQuery;
+    }
+});
+var _searchexecution = require("./search-execution.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
+        };
+    }
+}
+function executeQuery(graph, query, options, transform) {
+    return _async_to_generator(function() {
+        var logger, limit, includeBody, maxPages, pageSize, pageToken, result, transformedResults, error;
+        return _ts_generator(this, function(_state) {
+            switch(_state.label){
+                case 0:
+                    logger = options.logger, limit = options.limit, includeBody = options.includeBody, maxPages = options.maxPages, pageSize = options.pageSize, pageToken = options.pageToken;
+                    // Single execution - direct query to Microsoft Graph API
+                    logger.info('executeQuery: executing direct Outlook query');
+                    _state.label = 1;
+                case 1:
+                    _state.trys.push([
+                        1,
+                        3,
+                        ,
+                        4
+                    ]);
+                    return [
+                        4,
+                        (0, _searchexecution.searchMessages)(graph, _object_spread_props(_object_spread({}, query !== undefined && {
+                            query: query
+                        }), {
+                            limit: limit !== null && limit !== void 0 ? limit : 50,
+                            includeBody: includeBody !== null && includeBody !== void 0 ? includeBody : false,
+                            maxPages: maxPages !== null && maxPages !== void 0 ? maxPages : null,
+                            pageSize: pageSize !== null && pageSize !== void 0 ? pageSize : 50,
+                            pageToken: pageToken !== null && pageToken !== void 0 ? pageToken : undefined,
+                            logger: logger
+                        }))
+                    ];
+                case 2:
+                    result = _state.sent();
+                    // Transform directly - if Microsoft Graph returns invalid data, fail loud
+                    transformedResults = result.messages.map(function(item, index) {
+                        try {
+                            return transform(item);
+                        } catch (transformError) {
+                            logger.error("Transform function failed for item ".concat(index), {
+                                itemIndex: index,
+                                error: _instanceof(transformError, Error) ? transformError.message : String(transformError)
+                            });
+                            throw new Error("Transform failed at item ".concat(index, ": ").concat(transformError));
+                        }
+                    });
+                    logger.info("executeQuery: succeeded with ".concat(transformedResults.length, " results"));
+                    return [
+                        2,
+                        {
+                            success: true,
+                            items: transformedResults,
+                            metadata: {
+                                nextPageToken: result.nextPageToken,
+                                totalFetched: result.messages.length
+                            }
+                        }
+                    ];
+                case 3:
+                    error = _state.sent();
+                    // Re-throw errors directly - no fallback logic
+                    logger.error('executeQuery: failed', error);
+                    throw error;
+                case 4:
+                    return [
+                        2
+                    ];
+            }
+        });
+    })();
+}
+/* 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/email/querying/execute-query.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/kevin/Dev/Projects/ai/mcp-z/servers/mcp-outlook/src/email/querying/execute-query.ts"],"sourcesContent":["import type { ExecutionResult } from '@mcp-z/email';\nimport type { Client } from '@microsoft/microsoft-graph-client';\nimport type { OutlookQuery as QueryNode } from '../../schemas/outlook-query-schema.js';\nimport type { Logger } from '../../types.js';\nimport { searchMessages } from './search-execution.js';\n\nexport interface ExecuteQueryOptions {\n  readonly logger: Logger;\n  readonly limit?: number;\n  readonly includeBody?: boolean;\n  readonly maxPages?: number | null;\n  readonly pageSize?: number;\n  readonly pageToken?: string;\n  readonly timezone?: string;\n  readonly abortSignal?: AbortSignal;\n}\n\n/**\n * Execute an Outlook query with direct, single-attempt execution.\n * No planning, no fallbacks, no retries.\n * Microsoft Graph errors are returned directly to the caller for actionable feedback.\n */\nexport async function executeQuery<T>(graph: Client, query: QueryNode | undefined, options: ExecuteQueryOptions, transform: (item: unknown) => T): Promise<ExecutionResult<T>> {\n  const { logger, limit, includeBody, maxPages, pageSize, pageToken } = options;\n\n  // Single execution - direct query to Microsoft Graph API\n  logger.info('executeQuery: executing direct Outlook query');\n\n  try {\n    const result = await searchMessages(graph, {\n      ...(query !== undefined && { query }),\n      limit: limit ?? 50,\n      includeBody: includeBody ?? false,\n      maxPages: maxPages ?? null,\n      pageSize: pageSize ?? 50,\n      pageToken: pageToken ?? undefined,\n      logger,\n    });\n\n    // Transform directly - if Microsoft Graph returns invalid data, fail loud\n    const transformedResults = result.messages.map((item, index) => {\n      try {\n        return transform(item);\n      } catch (transformError) {\n        logger.error(`Transform function failed for item ${index}`, {\n          itemIndex: index,\n          error: transformError instanceof Error ? transformError.message : String(transformError),\n        });\n        throw new Error(`Transform failed at item ${index}: ${transformError}`);\n      }\n    });\n\n    logger.info(`executeQuery: succeeded with ${transformedResults.length} results`);\n\n    return {\n      success: true,\n      items: transformedResults,\n      metadata: {\n        nextPageToken: result.nextPageToken,\n        totalFetched: result.messages.length,\n      },\n    };\n  } catch (error) {\n    // Re-throw errors directly - no fallback logic\n    logger.error('executeQuery: failed', error as Record<string, unknown>);\n    throw error;\n  }\n}\n"],"names":["executeQuery","graph","query","options","transform","logger","limit","includeBody","maxPages","pageSize","pageToken","result","transformedResults","error","info","searchMessages","undefined","messages","map","item","index","transformError","itemIndex","Error","message","String","length","success","items","metadata","nextPageToken","totalFetched"],"mappings":";;;;+BAsBsBA;;;eAAAA;;;+BAlBS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAkBxB,SAAeA,aAAgBC,KAAa,EAAEC,KAA4B,EAAEC,OAA4B,EAAEC,SAA+B;;YACtIC,QAAQC,OAAOC,aAAaC,UAAUC,UAAUC,WAMhDC,QAWAC,oBAsBCC;;;;oBAvCDR,SAA8DF,QAA9DE,QAAQC,QAAsDH,QAAtDG,OAAOC,cAA+CJ,QAA/CI,aAAaC,WAAkCL,QAAlCK,UAAUC,WAAwBN,QAAxBM,UAAUC,YAAcP,QAAdO;oBAExD,yDAAyD;oBACzDL,OAAOS,IAAI,CAAC;;;;;;;;;oBAGK;;wBAAMC,IAAAA,+BAAc,EAACd,OAAO,wCACrCC,UAAUc,aAAa;4BAAEd,OAAAA;wBAAM;4BACnCI,KAAK,EAAEA,kBAAAA,mBAAAA,QAAS;4BAChBC,WAAW,EAAEA,wBAAAA,yBAAAA,cAAe;4BAC5BC,QAAQ,EAAEA,qBAAAA,sBAAAA,WAAY;4BACtBC,QAAQ,EAAEA,qBAAAA,sBAAAA,WAAY;4BACtBC,SAAS,EAAEA,sBAAAA,uBAAAA,YAAaM;4BACxBX,QAAAA;;;;oBAPIM,SAAS;oBAUf,0EAA0E;oBACpEC,qBAAqBD,OAAOM,QAAQ,CAACC,GAAG,CAAC,SAACC,MAAMC;wBACpD,IAAI;4BACF,OAAOhB,UAAUe;wBACnB,EAAE,OAAOE,gBAAgB;4BACvBhB,OAAOQ,KAAK,CAAC,AAAC,sCAA2C,OAANO,QAAS;gCAC1DE,WAAWF;gCACXP,OAAOQ,AAAc,YAAdA,gBAA0BE,SAAQF,eAAeG,OAAO,GAAGC,OAAOJ;4BAC3E;4BACA,MAAM,IAAIE,MAAM,AAAC,4BAAqCF,OAAVD,OAAM,MAAmB,OAAfC;wBACxD;oBACF;oBAEAhB,OAAOS,IAAI,CAAC,AAAC,gCAAyD,OAA1BF,mBAAmBc,MAAM,EAAC;oBAEtE;;wBAAO;4BACLC,SAAS;4BACTC,OAAOhB;4BACPiB,UAAU;gCACRC,eAAenB,OAAOmB,aAAa;gCACnCC,cAAcpB,OAAOM,QAAQ,CAACS,MAAM;4BACtC;wBACF;;;oBACOb;oBACP,+CAA+C;oBAC/CR,OAAOQ,KAAK,CAAC,wBAAwBA;oBACrC,MAAMA;;;;;;;IAEV"}

package/dist/cjs/email/querying/query-builder.d.cts

@@ -0,0 +1,32 @@
+import type { OutlookQuery as QueryNode } from '../../schemas/outlook-query-schema.js';
+export interface ODataFilterResult {
+    search: string | null;
+    filter: string | null;
+    requireBodyClientFilter: boolean;
+}
+export declare function toGraphFilter(query: QueryNode): ODataFilterResult;
+export declare function toOutlookFilter(parsed: QueryNode, _options?: {
+    includeBodyContent?: boolean;
+    useCaseInsensitiveWrap?: boolean;
+}): {
+    filter: string;
+    search: string;
+    requireBodyClientFilter: boolean;
+    filters: ExtractedFilters;
+};
+interface ExtractedFilters {
+    subjectIncludes: string[];
+    bodyIncludes: string[];
+    textIncludes: string[];
+    fromIncludes: string[];
+    toIncludes: string[];
+    ccIncludes: string[];
+    bccIncludes: string[];
+    categoriesIncludes: string[];
+    labelIncludes: string[];
+    hasAttachment?: boolean;
+    since?: string;
+    before?: string;
+}
+export declare function extractOutlookFilters(parsed: QueryNode): ExtractedFilters;
+export {};