@mcp-z/mcp-outlook 1.0.0

package/dist/esm/mcp/tools/label-delete.d.ts

@@ -0,0 +1,54 @@
+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<{
+    ids: z.ZodArray<z.ZodCoercedString<unknown>>;
+}, z.core.$strip>;
+declare const outputSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    totalRequested: z.ZodNumber;
+    successCount: z.ZodNumber;
+    failureCount: z.ZodNumber;
+    results: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        success: z.ZodBoolean;
+        error: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    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({ ids }: Input, extra: EnrichedExtra): Promise<CallToolResult>;
+export default function createTool(): {
+    name: string;
+    config: {
+        readonly description: "Delete Outlook categories permanently (irreversible). Categories organize messages by color and name.";
+        readonly inputSchema: z.ZodObject<{
+            ids: z.ZodArray<z.ZodCoercedString<unknown>>;
+        }, z.core.$strip>;
+        readonly outputSchema: z.ZodObject<{
+            result: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                totalRequested: z.ZodNumber;
+                successCount: z.ZodNumber;
+                failureCount: z.ZodNumber;
+                results: z.ZodArray<z.ZodObject<{
+                    id: z.ZodString;
+                    success: z.ZodBoolean;
+                    error: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>>;
+                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/label-delete.js

@@ -0,0 +1,166 @@
+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 { CHUNK_SIZE, MAX_BATCH_SIZE } from '../../constants.js';
+const BatchResultSchema = z.object({
+    totalRequested: z.number().describe('Total number of categories requested to delete'),
+    successCount: z.number().describe('Number of categories successfully deleted'),
+    failureCount: z.number().describe('Number of categories that failed to delete'),
+    results: z.array(z.object({
+        id: z.string().describe('Category ID'),
+        success: z.boolean().describe('Whether the operation succeeded'),
+        error: z.string().optional().describe('Error message if operation failed')
+    })).describe('Individual results for each category')
+});
+const inputSchema = z.object({
+    ids: z.array(z.coerce.string().trim().min(1)).min(1).max(MAX_BATCH_SIZE).describe('Outlook category IDs to delete')
+});
+// Success branch schema
+const successBranchSchema = BatchResultSchema.extend({
+    type: z.literal('success')
+});
+// Output schema with auth_required support
+const outputSchema = z.discriminatedUnion('type', [
+    successBranchSchema,
+    AuthRequiredBranchSchema
+]);
+const config = {
+    description: 'Delete Outlook categories permanently (irreversible). Categories organize messages by color and name.',
+    inputSchema: inputSchema,
+    outputSchema: z.object({
+        result: outputSchema
+    })
+};
+async function handler({ ids }, extra) {
+    const logger = extra.logger;
+    logger.info('outlook-label-delete called', {
+        count: ids.length
+    });
+    // Validate IDs for Outlook-specific constraints
+    // Note: Schema already validates non-empty, trimmed strings with min/max length
+    // This check enforces business rule: Outlook category IDs cannot contain path separators or angle brackets
+    const invalidIds = [];
+    for (const id of ids){
+        if (id.includes('/') || id.includes('\\') || id.includes('<') || id.includes('>')) {
+            invalidIds.push(id);
+        }
+    }
+    if (invalidIds.length > 0) {
+        logger.info('outlook-label-delete found invalid ids', {
+            invalidIds,
+            count: invalidIds.length
+        });
+        throw new McpError(ErrorCode.InvalidParams, `Found ${invalidIds.length} invalid IDs (contain invalid characters): ${invalidIds.join(', ')}`);
+    }
+    try {
+        const graph = Client.initWithMiddleware({
+            authProvider: extra.authContext.auth
+        });
+        // Process deletions in chunks to prevent memory exhaustion
+        const allResults = [];
+        for(let i = 0; i < ids.length; i += CHUNK_SIZE){
+            const chunk = ids.slice(i, i + CHUNK_SIZE);
+            logger.info('Processing chunk', {
+                chunkIndex: i / CHUNK_SIZE + 1,
+                chunkSize: chunk.length,
+                totalChunks: Math.ceil(ids.length / CHUNK_SIZE)
+            });
+            // Delete categories sequentially to avoid API lock conflicts
+            const chunkResults = [];
+            for (const id of chunk){
+                try {
+                    await graph.api(`/me/outlook/masterCategories/${encodeURIComponent(id)}`).delete();
+                    chunkResults.push({
+                        status: 'fulfilled',
+                        value: {
+                            id,
+                            success: true
+                        }
+                    });
+                } catch (error) {
+                    chunkResults.push({
+                        status: 'rejected',
+                        reason: error
+                    });
+                }
+            }
+            // Process chunk results
+            const processedChunkResults = chunkResults.map((result, chunkIndex)=>{
+                const id = chunk[chunkIndex];
+                if (!id) {
+                    throw new Error(`Chunk index ${chunkIndex} is out of bounds for chunk of size ${chunk.length}`);
+                }
+                if (result.status === 'fulfilled') {
+                    return {
+                        id,
+                        success: true
+                    };
+                }
+                // Extract error message more robustly
+                let errorMessage = 'Unknown error';
+                if (result.reason) {
+                    if (typeof result.reason === 'string') {
+                        errorMessage = result.reason;
+                    } else if (result.reason instanceof Error) {
+                        errorMessage = result.reason.message;
+                    } else if (result.reason && typeof result.reason === 'object' && 'message' in result.reason) {
+                        errorMessage = String(result.reason.message);
+                    } else if (result.reason && typeof result.reason === 'object' && 'error' in result.reason) {
+                        errorMessage = String(result.reason.error);
+                    } else {
+                        errorMessage = String(result.reason);
+                    }
+                }
+                return {
+                    id,
+                    success: false,
+                    error: errorMessage
+                };
+            });
+            allResults.push(...processedChunkResults);
+        }
+        const successCount = allResults.filter((r)=>r.success).length;
+        const failureCount = allResults.filter((r)=>!r.success).length;
+        const result = {
+            type: 'success',
+            totalRequested: ids.length,
+            successCount,
+            failureCount,
+            results: allResults
+        };
+        logger.info('outlook-label-delete completed', {
+            totalRequested: ids.length,
+            successCount,
+            failureCount,
+            chunksProcessed: Math.ceil(ids.length / CHUNK_SIZE)
+        });
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify(result)
+                }
+            ],
+            structuredContent: {
+                result
+            }
+        };
+    } catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        logger.error('outlook-label-delete error', {
+            error: message
+        });
+        throw new McpError(ErrorCode.InternalError, `Error deleting categories: ${message}`, {
+            stack: error instanceof Error ? error.stack : undefined
+        });
+    }
+}
+export default function createTool() {
+    return {
+        name: 'label-delete',
+        config,
+        handler
+    };
+}

package/dist/esm/mcp/tools/label-delete.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/kevin/Dev/Projects/ai/mcp-z/servers/mcp-outlook/src/mcp/tools/label-delete.ts"],"sourcesContent":["import 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 { CHUNK_SIZE, MAX_BATCH_SIZE } from '../../constants.ts';\n\nconst BatchResultSchema = z.object({\n  totalRequested: z.number().describe('Total number of categories requested to delete'),\n  successCount: z.number().describe('Number of categories successfully deleted'),\n  failureCount: z.number().describe('Number of categories that failed to delete'),\n  results: z\n    .array(\n      z.object({\n        id: z.string().describe('Category ID'),\n        success: z.boolean().describe('Whether the operation succeeded'),\n        error: z.string().optional().describe('Error message if operation failed'),\n      })\n    )\n    .describe('Individual results for each category'),\n});\n\nconst inputSchema = z.object({\n  ids: z.array(z.coerce.string().trim().min(1)).min(1).max(MAX_BATCH_SIZE).describe('Outlook category IDs to delete'),\n});\n\n// Success branch schema\nconst successBranchSchema = BatchResultSchema.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: 'Delete Outlook categories permanently (irreversible). Categories organize messages by color and name.',\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({ ids }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n  const logger = extra.logger;\n  logger.info('outlook-label-delete called', { count: ids.length });\n\n  // Validate IDs for Outlook-specific constraints\n  // Note: Schema already validates non-empty, trimmed strings with min/max length\n  // This check enforces business rule: Outlook category IDs cannot contain path separators or angle brackets\n  const invalidIds: string[] = [];\n  for (const id of ids) {\n    if (id.includes('/') || id.includes('\\\\') || id.includes('<') || id.includes('>')) {\n      invalidIds.push(id);\n    }\n  }\n\n  if (invalidIds.length > 0) {\n    logger.info('outlook-label-delete found invalid ids', { invalidIds, count: invalidIds.length });\n    throw new McpError(ErrorCode.InvalidParams, `Found ${invalidIds.length} invalid IDs (contain invalid characters): ${invalidIds.join(', ')}`);\n  }\n\n  try {\n    const graph = Client.initWithMiddleware({ authProvider: extra.authContext.auth });\n    // Process deletions in chunks to prevent memory exhaustion\n    const allResults: Array<{ id: string; success: boolean; error?: string }> = [];\n\n    for (let i = 0; i < ids.length; i += CHUNK_SIZE) {\n      const chunk = ids.slice(i, i + CHUNK_SIZE);\n      logger.info('Processing chunk', { chunkIndex: i / CHUNK_SIZE + 1, chunkSize: chunk.length, totalChunks: Math.ceil(ids.length / CHUNK_SIZE) });\n\n      // Delete categories sequentially to avoid API lock conflicts\n      const chunkResults: Array<{ status: string; value?: unknown; reason?: unknown }> = [];\n      for (const id of chunk) {\n        try {\n          await graph.api(`/me/outlook/masterCategories/${encodeURIComponent(id)}`).delete();\n          chunkResults.push({ status: 'fulfilled', value: { id, success: true } });\n        } catch (error) {\n          chunkResults.push({ status: 'rejected', reason: error });\n        }\n      }\n\n      // Process chunk results\n      const processedChunkResults = chunkResults.map((result, chunkIndex) => {\n        const id = chunk[chunkIndex];\n        if (!id) {\n          throw new Error(`Chunk index ${chunkIndex} is out of bounds for chunk of size ${chunk.length}`);\n        }\n        if (result.status === 'fulfilled') {\n          return { id, success: true };\n        }\n\n        // Extract error message more robustly\n        let errorMessage = 'Unknown error';\n        if (result.reason) {\n          if (typeof result.reason === 'string') {\n            errorMessage = result.reason;\n          } else if (result.reason instanceof Error) {\n            errorMessage = result.reason.message;\n          } else if (result.reason && typeof result.reason === 'object' && 'message' in result.reason) {\n            errorMessage = String(result.reason.message);\n          } else if (result.reason && typeof result.reason === 'object' && 'error' in result.reason) {\n            errorMessage = String(result.reason.error);\n          } else {\n            errorMessage = String(result.reason);\n          }\n        }\n\n        return { id, success: false, error: errorMessage };\n      });\n\n      allResults.push(...processedChunkResults);\n    }\n\n    const successCount = allResults.filter((r) => r.success).length;\n    const failureCount = allResults.filter((r) => !r.success).length;\n\n    const result: Output = {\n      type: 'success' as const,\n      totalRequested: ids.length,\n      successCount,\n      failureCount,\n      results: allResults,\n    };\n\n    logger.info('outlook-label-delete completed', {\n      totalRequested: ids.length,\n      successCount,\n      failureCount,\n      chunksProcessed: Math.ceil(ids.length / CHUNK_SIZE),\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-label-delete error', { error: message });\n\n    throw new McpError(ErrorCode.InternalError, `Error deleting categories: ${message}`, {\n      stack: error instanceof Error ? error.stack : undefined,\n    });\n  }\n}\n\nexport default function createTool() {\n  return {\n    name: 'label-delete',\n    config,\n    handler,\n  } satisfies ToolModule;\n}\n"],"names":["schemas","AuthRequiredBranchSchema","Client","ErrorCode","McpError","z","CHUNK_SIZE","MAX_BATCH_SIZE","BatchResultSchema","object","totalRequested","number","describe","successCount","failureCount","results","array","id","string","success","boolean","error","optional","inputSchema","ids","coerce","trim","min","max","successBranchSchema","extend","type","literal","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","info","count","length","invalidIds","includes","push","InvalidParams","join","graph","initWithMiddleware","authProvider","authContext","auth","allResults","i","chunk","slice","chunkIndex","chunkSize","totalChunks","Math","ceil","chunkResults","api","encodeURIComponent","delete","status","value","reason","processedChunkResults","map","Error","errorMessage","message","String","filter","r","chunksProcessed","content","text","JSON","stringify","structuredContent","InternalError","stack","undefined","createTool","name"],"mappings":"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"}

package/dist/esm/mcp/tools/labels-list.d.ts

@@ -0,0 +1,96 @@
+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<{}, z.core.$strip>;
+declare const outputSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"success">;
+    items: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        displayName: z.ZodString;
+        color: z.ZodEnum<{
+            preset0: "preset0";
+            preset1: "preset1";
+            preset2: "preset2";
+            preset3: "preset3";
+            preset4: "preset4";
+            preset5: "preset5";
+            preset6: "preset6";
+            preset7: "preset7";
+            preset8: "preset8";
+            preset9: "preset9";
+            preset10: "preset10";
+            preset11: "preset11";
+            preset12: "preset12";
+            preset13: "preset13";
+            preset14: "preset14";
+            preset15: "preset15";
+            preset16: "preset16";
+            preset17: "preset17";
+            preset18: "preset18";
+            preset19: "preset19";
+            preset20: "preset20";
+            preset21: "preset21";
+            preset22: "preset22";
+            preset23: "preset23";
+            preset24: "preset24";
+        }>;
+    }, z.core.$strip>>;
+}, 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(_: Input, extra: EnrichedExtra): Promise<CallToolResult>;
+export default function createTool(): {
+    name: string;
+    config: {
+        readonly description: "List Outlook categories for label: query syntax. Case-sensitive.";
+        readonly inputSchema: z.ZodObject<{}, z.core.$strip>;
+        readonly outputSchema: z.ZodObject<{
+            result: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                type: z.ZodLiteral<"success">;
+                items: z.ZodArray<z.ZodObject<{
+                    id: z.ZodString;
+                    displayName: z.ZodString;
+                    color: z.ZodEnum<{
+                        preset0: "preset0";
+                        preset1: "preset1";
+                        preset2: "preset2";
+                        preset3: "preset3";
+                        preset4: "preset4";
+                        preset5: "preset5";
+                        preset6: "preset6";
+                        preset7: "preset7";
+                        preset8: "preset8";
+                        preset9: "preset9";
+                        preset10: "preset10";
+                        preset11: "preset11";
+                        preset12: "preset12";
+                        preset13: "preset13";
+                        preset14: "preset14";
+                        preset15: "preset15";
+                        preset16: "preset16";
+                        preset17: "preset17";
+                        preset18: "preset18";
+                        preset19: "preset19";
+                        preset20: "preset20";
+                        preset21: "preset21";
+                        preset22: "preset22";
+                        preset23: "preset23";
+                        preset24: "preset24";
+                    }>;
+                }, z.core.$strip>>;
+            }, 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/labels-list.js

@@ -0,0 +1,78 @@
+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 { OutlookCategorySchema } from '../../schemas/index.js';
+const inputSchema = z.object({});
+// Success branch schema
+const successBranchSchema = z.object({
+    type: z.literal('success'),
+    items: z.array(OutlookCategorySchema)
+});
+// Output schema with auth_required support
+const outputSchema = z.discriminatedUnion('type', [
+    successBranchSchema,
+    AuthRequiredBranchSchema
+]);
+const config = {
+    description: 'List Outlook categories for label: query syntax. Case-sensitive.',
+    inputSchema: inputSchema,
+    outputSchema: z.object({
+        result: outputSchema
+    })
+};
+async function handler(_, extra) {
+    const logger = extra.logger;
+    logger.info('outlook.labels.list called');
+    try {
+        const graph = Client.initWithMiddleware({
+            authProvider: extra.authContext.auth
+        });
+        const started = Date.now();
+        // Call Microsoft Graph API to get master categories (same as categories tool)
+        const response = await graph.api('/me/outlook/masterCategories').get();
+        const categories = Array.isArray(response.value) ? response.value : [];
+        const durationMs = Date.now() - started;
+        logger.info('outlook.labels.list returning', {
+            labelsCount: categories.length
+        });
+        logger.info('outlook.labels.list metrics', {
+            durationMs
+        });
+        const result = {
+            type: 'success',
+            items: categories.map((category)=>({
+                    id: category.id || undefined,
+                    displayName: category.displayName || undefined,
+                    color: category.color || undefined
+                }))
+        };
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify(result)
+                }
+            ],
+            structuredContent: {
+                result
+            }
+        };
+    } catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        logger.error('outlook.labels.list error', {
+            error: message
+        });
+        throw new McpError(ErrorCode.InternalError, `Error listing labels: ${message}`, {
+            stack: error instanceof Error ? error.stack : undefined
+        });
+    }
+}
+export default function createTool() {
+    return {
+        name: 'labels-list',
+        config,
+        handler
+    };
+}

package/dist/esm/mcp/tools/labels-list.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/kevin/Dev/Projects/ai/mcp-z/servers/mcp-outlook/src/mcp/tools/labels-list.ts"],"sourcesContent":["import 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 * as MicrosoftGraph from '@microsoft/microsoft-graph-types';\nimport { type CallToolResult, ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';\nimport { z } from 'zod';\nimport { OutlookCategorySchema } from '../../schemas/index.js';\n\nconst inputSchema = z.object({});\n\n// Success branch schema\nconst successBranchSchema = z.object({\n  type: z.literal('success'),\n  items: z.array(OutlookCategorySchema),\n});\n\n// Output schema with auth_required support\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n  description: 'List Outlook categories for label: query syntax. Case-sensitive.',\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(_: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n  const logger = extra.logger;\n  logger.info('outlook.labels.list called');\n\n  try {\n    const graph = Client.initWithMiddleware({ authProvider: extra.authContext.auth });\n    const started = Date.now();\n\n    // Call Microsoft Graph API to get master categories (same as categories tool)\n    const response = await graph.api('/me/outlook/masterCategories').get();\n    const categories = Array.isArray(response.value) ? response.value : [];\n\n    const durationMs = Date.now() - started;\n    logger.info('outlook.labels.list returning', { labelsCount: categories.length });\n    logger.info('outlook.labels.list metrics', { durationMs });\n\n    const result: Output = {\n      type: 'success' as const,\n      items: categories.map((category: MicrosoftGraph.OutlookCategory) => ({\n        id: category.id || undefined,\n        displayName: category.displayName || undefined,\n        color: category.color || undefined,\n      })),\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.labels.list error', { error: message });\n\n    throw new McpError(ErrorCode.InternalError, `Error listing labels: ${message}`, {\n      stack: error instanceof Error ? error.stack : undefined,\n    });\n  }\n}\n\nexport default function createTool() {\n  return {\n    name: 'labels-list',\n    config,\n    handler,\n  } satisfies ToolModule;\n}\n"],"names":["schemas","AuthRequiredBranchSchema","Client","ErrorCode","McpError","z","OutlookCategorySchema","inputSchema","object","successBranchSchema","type","literal","items","array","outputSchema","discriminatedUnion","config","description","result","handler","_","extra","logger","info","graph","initWithMiddleware","authProvider","authContext","auth","started","Date","now","response","api","get","categories","Array","isArray","value","durationMs","labelsCount","length","map","category","id","undefined","displayName","color","content","text","JSON","stringify","structuredContent","error","message","Error","String","InternalError","stack","createTool","name"],"mappings":"AACA,SAASA,OAAO,QAAQ,yBAAyB;AAEjD,MAAM,EAAEC,wBAAwB,EAAE,GAAGD;AAGrC,SAASE,MAAM,QAAQ,oCAAoC;AAE3D,SAA8BC,SAAS,EAAEC,QAAQ,QAAQ,qCAAqC;AAC9F,SAASC,CAAC,QAAQ,MAAM;AACxB,SAASC,qBAAqB,QAAQ,yBAAyB;AAE/D,MAAMC,cAAcF,EAAEG,MAAM,CAAC,CAAC;AAE9B,wBAAwB;AACxB,MAAMC,sBAAsBJ,EAAEG,MAAM,CAAC;IACnCE,MAAML,EAAEM,OAAO,CAAC;IAChBC,OAAOP,EAAEQ,KAAK,CAACP;AACjB;AAEA,2CAA2C;AAC3C,MAAMQ,eAAeT,EAAEU,kBAAkB,CAAC,QAAQ;IAACN;IAAqBR;CAAyB;AAEjG,MAAMe,SAAS;IACbC,aAAa;IACbV,aAAaA;IACbO,cAAcT,EAAEG,MAAM,CAAC;QACrBU,QAAQJ;IACV;AACF;AAKA,eAAeK,QAAQC,CAAQ,EAAEC,KAAoB;IACnD,MAAMC,SAASD,MAAMC,MAAM;IAC3BA,OAAOC,IAAI,CAAC;IAEZ,IAAI;QACF,MAAMC,QAAQtB,OAAOuB,kBAAkB,CAAC;YAAEC,cAAcL,MAAMM,WAAW,CAACC,IAAI;QAAC;QAC/E,MAAMC,UAAUC,KAAKC,GAAG;QAExB,8EAA8E;QAC9E,MAAMC,WAAW,MAAMR,MAAMS,GAAG,CAAC,gCAAgCC,GAAG;QACpE,MAAMC,aAAaC,MAAMC,OAAO,CAACL,SAASM,KAAK,IAAIN,SAASM,KAAK,GAAG,EAAE;QAEtE,MAAMC,aAAaT,KAAKC,GAAG,KAAKF;QAChCP,OAAOC,IAAI,CAAC,iCAAiC;YAAEiB,aAAaL,WAAWM,MAAM;QAAC;QAC9EnB,OAAOC,IAAI,CAAC,+BAA+B;YAAEgB;QAAW;QAExD,MAAMrB,SAAiB;YACrBR,MAAM;YACNE,OAAOuB,WAAWO,GAAG,CAAC,CAACC,WAA8C,CAAA;oBACnEC,IAAID,SAASC,EAAE,IAAIC;oBACnBC,aAAaH,SAASG,WAAW,IAAID;oBACrCE,OAAOJ,SAASI,KAAK,IAAIF;gBAC3B,CAAA;QACF;QAEA,OAAO;YACLG,SAAS;gBACP;oBACEtC,MAAM;oBACNuC,MAAMC,KAAKC,SAAS,CAACjC;gBACvB;aACD;YACDkC,mBAAmB;gBAAElC;YAAO;QAC9B;IACF,EAAE,OAAOmC,OAAO;QACd,MAAMC,UAAUD,iBAAiBE,QAAQF,MAAMC,OAAO,GAAGE,OAAOH;QAChE/B,OAAO+B,KAAK,CAAC,6BAA6B;YAAEA,OAAOC;QAAQ;QAE3D,MAAM,IAAIlD,SAASD,UAAUsD,aAAa,EAAE,CAAC,sBAAsB,EAAEH,SAAS,EAAE;YAC9EI,OAAOL,iBAAiBE,QAAQF,MAAMK,KAAK,GAAGb;QAChD;IACF;AACF;AAEA,eAAe,SAASc;IACtB,OAAO;QACLC,MAAM;QACN5C;QACAG;IACF;AACF"}

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

@@ -0,0 +1,110 @@
+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<{
+    id: z.ZodCoercedString<unknown>;
+    fields: z.ZodOptional<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<{
+    type: z.ZodLiteral<"success">;
+    item: 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>;
+}, 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({ id, fields, contentType, excludeThreadHistory }: Input, extra: EnrichedExtra): Promise<CallToolResult>;
+export default function createTool(): {
+    name: string;
+    config: {
+        readonly description: "Get an Outlook message by ID with flexible field selection";
+        readonly inputSchema: z.ZodObject<{
+            id: z.ZodCoercedString<unknown>;
+            fields: z.ZodOptional<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<{
+                type: z.ZodLiteral<"success">;
+                item: 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>;
+            }, 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-get.js

@@ -0,0 +1,117 @@
+import { EMAIL_COMMON_PATTERNS, EMAIL_FIELD_DESCRIPTIONS, EMAIL_FIELDS, EmailContentTypeSchema, EmailDetailSchema, ExcludeThreadHistorySchema, extractCurrentMessageFromHtml, extractCurrentMessageFromHtmlToText, normalizeDateToISO as toIsoUtc } from '@mcp-z/email';
+import { schemas } from '@mcp-z/oauth-microsoft';
+const { AuthRequiredBranchSchema } = schemas;
+import { createFieldsSchema, filterFields, parseFields } from '@mcp-z/server';
+import { Client } from '@microsoft/microsoft-graph-client';
+import { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';
+import { z } from 'zod';
+const inputSchema = z.object({
+    id: z.coerce.string().trim().min(1).describe('Outlook message ID to retrieve'),
+    fields: createFieldsSchema({
+        availableFields: EMAIL_FIELDS,
+        fieldDescriptions: EMAIL_FIELD_DESCRIPTIONS,
+        commonPatterns: EMAIL_COMMON_PATTERNS,
+        resourceName: 'email message'
+    }),
+    contentType: EmailContentTypeSchema,
+    excludeThreadHistory: ExcludeThreadHistorySchema
+});
+// Success branch schema - uses item: wrapper for consistency with standard vocabulary
+const successBranchSchema = z.object({
+    type: z.literal('success'),
+    item: EmailDetailSchema
+});
+// Output schema with auth_required support
+const outputSchema = z.discriminatedUnion('type', [
+    successBranchSchema,
+    AuthRequiredBranchSchema
+]);
+const config = {
+    description: 'Get an Outlook message by ID with flexible field selection',
+    inputSchema: inputSchema,
+    outputSchema: z.object({
+        result: outputSchema
+    })
+};
+async function handler({ id, fields, contentType, excludeThreadHistory }, extra) {
+    const logger = extra.logger;
+    const requestedFields = parseFields(fields, EMAIL_FIELDS);
+    logger.info('outlook.message.get called', {
+        id,
+        fields: fields || 'all'
+    });
+    if (!id) {
+        logger.info('outlook.message.get missing id');
+        throw new McpError(ErrorCode.InvalidParams, 'Missing id');
+    }
+    try {
+        var _ref;
+        var _message_body, _message_body_contentType, _message_body1, _message_from_emailAddress, _message_from;
+        const graph = Client.initWithMiddleware({
+            authProvider: extra.authContext.auth
+        });
+        const message = await graph.api(`/me/messages/${encodeURIComponent(id)}`).get();
+        // Process body based on contentType and excludeThreadHistory options
+        let bodyContent = (_ref = (_message_body = message.body) === null || _message_body === void 0 ? void 0 : _message_body.content) !== null && _ref !== void 0 ? _ref : '';
+        const isHtml = ((_message_body1 = message.body) === null || _message_body1 === void 0 ? void 0 : (_message_body_contentType = _message_body1.contentType) === null || _message_body_contentType === void 0 ? void 0 : _message_body_contentType.toLowerCase()) === 'html';
+        if (isHtml && excludeThreadHistory) {
+            // Remove thread history from HTML
+            bodyContent = extractCurrentMessageFromHtml(bodyContent);
+        }
+        if (isHtml && contentType === 'text') {
+            var _ref1;
+            var _message_body2;
+            // Convert HTML to plain text (thread extraction happens inside if excludeThreadHistory was true)
+            bodyContent = excludeThreadHistory ? extractCurrentMessageFromHtmlToText(bodyContent) : extractCurrentMessageFromHtmlToText((_ref1 = (_message_body2 = message.body) === null || _message_body2 === void 0 ? void 0 : _message_body2.content) !== null && _ref1 !== void 0 ? _ref1 : '');
+        }
+        // Build full message data
+        const payload = {
+            id: message.id,
+            subject: message.subject,
+            from: (_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,
+            date: toIsoUtc(message.receivedDateTime) || message.receivedDateTime,
+            snippet: message.bodyPreview,
+            body: bodyContent,
+            bodyContentType: contentType
+        };
+        // Filter based on requested fields
+        const filteredPayload = filterFields(payload, requestedFields);
+        logger.info('outlook.message.get success', {
+            id: payload.id,
+            subject: payload.subject,
+            from: payload.from,
+            date: payload.date,
+            fields: fields || 'all'
+        });
+        const result = {
+            type: 'success',
+            item: filteredPayload
+        };
+        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.get error', {
+            error: message
+        });
+        throw new McpError(ErrorCode.InternalError, `Error getting message: ${message}`, {
+            stack: error instanceof Error ? error.stack : undefined
+        });
+    }
+}
+export default function createTool() {
+    return {
+        name: 'message-get',
+        config,
+        handler
+    };
+}