@jbctechsolutions/mcp-office365 2.5.1 → 4.0.0

package/dist/tools/mail.d.ts

@@ -2,56 +2,100 @@
  * Copyright (c) 2026 JBC Tech Solutions, LLC
  * Licensed under the MIT License. See LICENSE file in the project root.
  */
+/**
+ * Mail-related MCP tools.
+ *
+ * Provides tools for listing folders, emails, and searching.
+ */
 import { z } from 'zod';
-import type { IRepository } from '../database/repository.js';
-import type { Folder, EmailSummary, Email, AttachmentInfo } from '../types/index.js';
-import type { IAttachmentReader } from '../applescript/content-readers.js';
+import type { ToolDefinition } from '../registry/types.js';
+import type { GraphMailTools } from './mail-graph.js';
+declare module '../registry/types.js' {
+    interface GraphToolsets {
+        mailGraph: GraphMailTools;
+    }
+}
 export declare const ListFoldersInput: z.ZodObject<{}, z.core.$strict>;
+/**
+ * Canonical (advertised) input for the `list_folders` tool. The Graph backend
+ * ignores `account_id` and returns the default mailbox's folders.
+ */
+export declare const ListFoldersToolInput: z.ZodObject<{
+    account_id: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodArray<z.ZodNumber>, z.ZodLiteral<"all">]>>;
+}, z.core.$strict>;
 export declare const ListEmailsInput: z.ZodObject<{
-    folder_id: z.ZodNumber;
+    folder_id: z.ZodString;
     limit: z.ZodDefault<z.ZodNumber>;
     offset: z.ZodDefault<z.ZodNumber>;
     unread_only: z.ZodDefault<z.ZodBoolean>;
 }, z.core.$strict>;
 export declare const SearchEmailsInput: z.ZodObject<{
     query: z.ZodString;
-    folder_id: z.ZodOptional<z.ZodNumber>;
+    folder_id: z.ZodOptional<z.ZodString>;
     limit: z.ZodDefault<z.ZodNumber>;
 }, z.core.$strict>;
+/**
+ * Structured email search (U7 / D9). Replaces raw KQL — the #1 failure class —
+ * with typed criteria compiled server-side to the correct Graph mechanism
+ * ($filter / quoted $search / /search/query), so operator syntax, quoting, and
+ * date formatting are handled for you. Provide at least one criterion.
+ */
 export declare const SearchEmailsAdvancedInput: z.ZodObject<{
-    query: z.ZodString;
-    folder_id: z.ZodOptional<z.ZodNumber>;
+    from: z.ZodOptional<z.ZodString>;
+    to: z.ZodOptional<z.ZodString>;
+    subject_contains: z.ZodOptional<z.ZodString>;
+    body_contains: z.ZodOptional<z.ZodString>;
+    text: z.ZodOptional<z.ZodString>;
+    received_after: z.ZodOptional<z.ZodString>;
+    received_before: z.ZodOptional<z.ZodString>;
+    has_attachments: z.ZodOptional<z.ZodBoolean>;
+    is_unread: z.ZodOptional<z.ZodBoolean>;
+    importance: z.ZodOptional<z.ZodEnum<{
+        high: "high";
+        low: "low";
+        normal: "normal";
+    }>>;
     limit: z.ZodDefault<z.ZodNumber>;
 }, z.core.$strict>;
 export declare const GetEmailInput: z.ZodObject<{
-    email_id: z.ZodNumber;
+    email_id: z.ZodString;
     include_body: z.ZodDefault<z.ZodBoolean>;
     strip_html: z.ZodDefault<z.ZodBoolean>;
 }, z.core.$strict>;
 export declare const GetEmailsInput: z.ZodObject<{
-    email_ids: z.ZodArray<z.ZodNumber>;
+    email_ids: z.ZodArray<z.ZodString>;
     include_body: z.ZodDefault<z.ZodBoolean>;
     strip_html: z.ZodDefault<z.ZodBoolean>;
 }, z.core.$strict>;
 export declare const ListConversationInput: z.ZodObject<{
-    message_id: z.ZodNumber;
+    message_id: z.ZodString;
     limit: z.ZodDefault<z.ZodNumber>;
 }, z.core.$strict>;
 export declare const GetUnreadCountInput: z.ZodObject<{
-    folder_id: z.ZodOptional<z.ZodNumber>;
+    folder_id: z.ZodOptional<z.ZodString>;
 }, z.core.$strict>;
 export declare const ListAttachmentsInput: z.ZodObject<{
-    email_id: z.ZodNumber;
+    email_id: z.ZodString;
 }, z.core.$strict>;
 export declare const DownloadAttachmentInput: z.ZodObject<{
-    email_id: z.ZodNumber;
-    attachment_index: z.ZodNumber;
+    email_id: z.ZodString;
+    attachment_id: z.ZodString;
     save_path: z.ZodString;
 }, z.core.$strict>;
 export declare const CheckNewEmailsInput: z.ZodObject<{
-    folder_id: z.ZodNumber;
+    folder_id: z.ZodString;
+}, z.core.$strict>;
+export declare const GetMessageHeadersInput: z.ZodObject<{
+    email_id: z.ZodString;
+}, z.core.$strict>;
+export declare const GetMessageMimeInput: z.ZodObject<{
+    email_id: z.ZodString;
+}, z.core.$strict>;
+export declare const GetMailTipsInput: z.ZodObject<{
+    email_addresses: z.ZodArray<z.ZodString>;
 }, z.core.$strict>;
 export type ListFoldersParams = z.infer<typeof ListFoldersInput>;
+export type ListFoldersToolParams = z.infer<typeof ListFoldersToolInput>;
 export type ListEmailsParams = z.infer<typeof ListEmailsInput>;
 export type SearchEmailsParams = z.infer<typeof SearchEmailsInput>;
 export type GetEmailParams = z.infer<typeof GetEmailInput>;
@@ -60,8 +104,14 @@ export type GetUnreadCountParams = z.infer<typeof GetUnreadCountInput>;
 export type ListAttachmentsParams = z.infer<typeof ListAttachmentsInput>;
 export type DownloadAttachmentParams = z.infer<typeof DownloadAttachmentInput>;
 export type CheckNewEmailsParams = z.infer<typeof CheckNewEmailsInput>;
+export type SearchEmailsAdvancedParams = z.infer<typeof SearchEmailsAdvancedInput>;
+export type ListConversationParams = z.infer<typeof ListConversationInput>;
+export type GetMessageHeadersParams = z.infer<typeof GetMessageHeadersInput>;
+export type GetMessageMimeParams = z.infer<typeof GetMessageMimeInput>;
+export type GetMailTipsParams = z.infer<typeof GetMailTipsInput>;
 /**
- * Interface for reading email body content from data files.
+ * Interface for reading email body content from data files. Implemented by the
+ * Graph content reader.
  */
 export interface IContentReader {
     /**
@@ -71,57 +121,30 @@ export interface IContentReader {
     readEmailBody(dataFilePath: string | null): string | null;
 }
 /**
- * Default content reader that returns null (body reading not implemented yet).
- * Will be replaced with OLK15 parser implementation.
- */
-export declare const nullContentReader: IContentReader;
-/**
- * Mail tools implementation with dependency injection.
- */
-export declare class MailTools {
-    private readonly repository;
-    private readonly contentReader;
-    private readonly attachmentReader?;
-    constructor(repository: IRepository, contentReader?: IContentReader, attachmentReader?: IAttachmentReader | undefined);
-    /**
-     * Lists all mail folders with message and unread counts.
-     */
-    listFolders(_params: ListFoldersParams): Folder[];
-    /**
-     * Lists emails in a folder with pagination.
-     */
-    listEmails(params: ListEmailsParams): EmailSummary[];
-    /**
-     * Searches emails by subject, sender, or preview.
-     */
-    searchEmails(params: SearchEmailsParams): EmailSummary[];
-    /**
-     * Gets a single email by ID with optional body content.
-     */
-    getEmail(params: GetEmailParams): (Email & {
-        attachments: AttachmentInfo[];
-    }) | null;
-    /**
-     * Gets the unread email count.
-     */
-    getUnreadCount(params: GetUnreadCountParams): {
-        count: number;
-    };
-    /**
-     * Lists attachment metadata for an email.
-     */
-    listAttachments(params: ListAttachmentsParams): AttachmentInfo[];
-    /**
-     * Downloads/saves an attachment to disk.
-     */
-    downloadAttachment(params: DownloadAttachmentParams): {
-        name: string;
-        savedTo: string;
-        size: number;
-    };
-}
-/**
- * Creates mail tools with the given repository.
+ * Registry tool definitions for the mail READ domain. Each handler delegates
+ * to GraphMailTools, which returns MCP content directly.
  */
-export declare function createMailTools(repository: IRepository, contentReader?: IContentReader, attachmentReader?: IAttachmentReader): MailTools;
+export declare const SendEmailInput: z.ZodObject<{
+    to: z.ZodArray<z.ZodString>;
+    subject: z.ZodString;
+    body: z.ZodString;
+    body_type: z.ZodDefault<z.ZodEnum<{
+        html: "html";
+        plain: "plain";
+    }>>;
+    cc: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    bcc: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    reply_to: z.ZodOptional<z.ZodString>;
+    attachments: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        name: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>>;
+    inline_images: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        content_id: z.ZodString;
+    }, z.core.$strict>>>;
+    account_id: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>;
+export type SendEmailParams = z.infer<typeof SendEmailInput>;
+export declare function mailToolDefinitions(): ToolDefinition[];
 //# sourceMappingURL=mail.d.ts.map

package/dist/tools/mail.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mail.d.ts","sourceRoot":"","sources":["../../src/tools/mail.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"mail.d.ts","sourceRoot":"","sources":["../../src/tools/mail.ts"],"names":[],"mappings":"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"}