@jbctechsolutions/mcp-outlook-mac 1.0.0

package/dist/parsers/olk15.js

@@ -0,0 +1,364 @@
+/**
+ * OLK15 binary file parser.
+ *
+ * Parses Outlook for Mac's proprietary binary content files.
+ * These files contain email bodies, event details, contact information, etc.
+ *
+ * File types:
+ * - .olk15MsgSource / .olk15Message - Email content
+ * - .olk15Event - Calendar event details
+ * - .olk15Contact - Contact information
+ * - .olk15Note - Note content
+ * - .olk15Task - Task details
+ *
+ * The format is proprietary and not documented. This parser uses heuristics
+ * to extract text content and provides graceful fallbacks when parsing fails.
+ */
+import { readFileSync, existsSync } from 'node:fs';
+import { join } from 'node:path';
+// =============================================================================
+// Configuration
+// =============================================================================
+/**
+ * Default profile data directory path.
+ */
+export function getDefaultDataPath(profileName = 'Main Profile') {
+    const home = process.env.HOME ?? '';
+    return join(home, 'Library/Group Containers/UBF8T346G9.Office/Outlook/Outlook 15 Profiles', profileName, 'Data');
+}
+// =============================================================================
+// Binary Parsing Utilities
+// =============================================================================
+/**
+ * Finds UTF-16LE encoded text in binary data.
+ * OLK15 files often store text as UTF-16LE.
+ */
+function findUtf16Text(buffer, minLength = 10) {
+    const results = [];
+    let start = -1;
+    let chars = [];
+    for (let i = 0; i < buffer.length - 1; i += 2) {
+        const char = buffer.readUInt16LE(i);
+        // Check if it's a printable character or common whitespace
+        if ((char >= 0x20 && char < 0x7f) || char === 0x0a || char === 0x0d || char === 0x09) {
+            if (start === -1)
+                start = i;
+            chars.push(String.fromCharCode(char));
+        }
+        else if (char === 0) {
+            // Null character - end of string
+            if (chars.length >= minLength) {
+                results.push(chars.join(''));
+            }
+            chars = [];
+            start = -1;
+        }
+        else {
+            // Non-printable, non-null - might be end of text section
+            if (chars.length >= minLength) {
+                results.push(chars.join(''));
+            }
+            chars = [];
+            start = -1;
+        }
+    }
+    // Don't forget the last string
+    if (chars.length >= minLength) {
+        results.push(chars.join(''));
+    }
+    return results;
+}
+/**
+ * Finds UTF-8 encoded text in binary data.
+ */
+function findUtf8Text(buffer, minLength = 10) {
+    const results = [];
+    let start = -1;
+    let chars = [];
+    for (let i = 0; i < buffer.length; i++) {
+        const byte = buffer[i];
+        if (byte !== undefined) {
+            // Check if it's a printable ASCII or common whitespace
+            if ((byte >= 0x20 && byte < 0x7f) || byte === 0x0a || byte === 0x0d || byte === 0x09) {
+                if (start === -1)
+                    start = i;
+                chars.push(byte);
+            }
+            else if (byte === 0) {
+                // Null terminator
+                if (chars.length >= minLength) {
+                    results.push(Buffer.from(chars).toString('utf8'));
+                }
+                chars = [];
+                start = -1;
+            }
+            else if (byte >= 0x80) {
+                // UTF-8 multi-byte - try to include
+                chars.push(byte);
+            }
+            else {
+                // Control character - end of text
+                if (chars.length >= minLength) {
+                    results.push(Buffer.from(chars).toString('utf8'));
+                }
+                chars = [];
+                start = -1;
+            }
+        }
+    }
+    if (chars.length >= minLength) {
+        results.push(Buffer.from(chars).toString('utf8'));
+    }
+    return results;
+}
+/**
+ * Extracts the longest text block that looks like content.
+ */
+function extractPrimaryText(buffer) {
+    // Try UTF-16LE first (common in OLK15)
+    const utf16Texts = findUtf16Text(buffer, 20);
+    // Try UTF-8 as fallback
+    const utf8Texts = findUtf8Text(buffer, 20);
+    // Combine and find the longest meaningful text
+    const allTexts = [...utf16Texts, ...utf8Texts]
+        .filter((t) => t.trim().length > 0)
+        // eslint-disable-next-line no-control-regex
+        .filter((t) => !t.match(/^[\x00-\x1f\x7f-\x9f]+$/)) // Filter control chars
+        .sort((a, b) => b.length - a.length);
+    return allTexts[0] ?? null;
+}
+/**
+ * Checks if text looks like HTML content.
+ */
+function looksLikeHtml(text) {
+    return /<\/?[a-z][\s\S]*>/i.test(text);
+}
+/**
+ * Finds HTML content in buffer.
+ */
+function findHtmlContent(buffer) {
+    const text = buffer.toString('utf8', 0, Math.min(buffer.length, 1024 * 1024));
+    // Look for HTML patterns
+    const htmlStart = text.search(/<html[^>]*>/i);
+    if (htmlStart >= 0) {
+        const htmlEnd = text.indexOf('</html>', htmlStart);
+        if (htmlEnd > htmlStart) {
+            return text.substring(htmlStart, htmlEnd + 7);
+        }
+    }
+    // Look for body content
+    const bodyStart = text.search(/<body[^>]*>/i);
+    if (bodyStart >= 0) {
+        const bodyEnd = text.indexOf('</body>', bodyStart);
+        if (bodyEnd > bodyStart) {
+            return text.substring(bodyStart, bodyEnd + 7);
+        }
+    }
+    return null;
+}
+/**
+ * Parses an OLK15 file and extracts text content.
+ */
+export function parseOlk15File(filePath) {
+    try {
+        if (!existsSync(filePath)) {
+            return { success: false, text: null, html: null, error: 'File not found' };
+        }
+        const buffer = readFileSync(filePath);
+        if (buffer.length === 0) {
+            return { success: false, text: null, html: null, error: 'Empty file' };
+        }
+        // Try to find HTML content first
+        const html = findHtmlContent(buffer);
+        if (html != null) {
+            return { success: true, text: null, html };
+        }
+        // Extract text content
+        const text = extractPrimaryText(buffer);
+        if (text != null) {
+            // Check if the text is actually HTML
+            if (looksLikeHtml(text)) {
+                return { success: true, text: null, html: text };
+            }
+            return { success: true, text, html: null };
+        }
+        return { success: false, text: null, html: null, error: 'No text content found' };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Unknown error';
+        return { success: false, text: null, html: null, error: message };
+    }
+}
+// =============================================================================
+// Content Reader Implementations
+// =============================================================================
+/**
+ * OLK15 content reader for email bodies.
+ */
+export class Olk15EmailContentReader {
+    dataPath;
+    constructor(dataPath) {
+        this.dataPath = dataPath;
+    }
+    readEmailBody(dataFilePath) {
+        if (dataFilePath == null) {
+            return null;
+        }
+        const fullPath = join(this.dataPath, dataFilePath);
+        const result = parseOlk15File(fullPath);
+        if (result.success) {
+            return result.html ?? result.text;
+        }
+        return null;
+    }
+}
+/**
+ * OLK15 content reader for calendar events.
+ */
+export class Olk15EventContentReader {
+    dataPath;
+    constructor(dataPath) {
+        this.dataPath = dataPath;
+    }
+    readEventDetails(dataFilePath) {
+        if (dataFilePath == null) {
+            return null;
+        }
+        const fullPath = join(this.dataPath, dataFilePath);
+        const result = parseOlk15File(fullPath);
+        if (!result.success) {
+            return null;
+        }
+        const text = result.text ?? result.html ?? '';
+        // Basic extraction - can be improved with format knowledge
+        return {
+            title: this.extractTitle(text),
+            location: this.extractField(text, 'Location'),
+            description: text,
+            organizer: this.extractField(text, 'Organizer'),
+            attendees: [],
+        };
+    }
+    extractTitle(text) {
+        // Try to find a subject/title line
+        const subjectMatch = text.match(/Subject:\s*(.+?)(?:\r?\n|$)/i);
+        if (subjectMatch?.[1] != null && subjectMatch[1].length > 0) {
+            return subjectMatch[1].trim();
+        }
+        // Use first line as title
+        const firstLine = text.split(/\r?\n/)[0]?.trim();
+        return firstLine != null && firstLine.length > 0 ? firstLine : null;
+    }
+    extractField(text, fieldName) {
+        const regex = new RegExp(`${fieldName}:\\s*(.+?)(?:\\r?\\n|$)`, 'i');
+        const match = text.match(regex);
+        return match?.[1]?.trim() ?? null;
+    }
+}
+/**
+ * OLK15 content reader for contacts.
+ */
+export class Olk15ContactContentReader {
+    dataPath;
+    constructor(dataPath) {
+        this.dataPath = dataPath;
+    }
+    readContactDetails(dataFilePath) {
+        if (dataFilePath == null) {
+            return null;
+        }
+        const fullPath = join(this.dataPath, dataFilePath);
+        const result = parseOlk15File(fullPath);
+        if (!result.success) {
+            return null;
+        }
+        // Contact parsing would require understanding the binary format
+        // For now, return a basic structure
+        return {
+            firstName: null,
+            lastName: null,
+            middleName: null,
+            nickname: null,
+            company: null,
+            jobTitle: null,
+            department: null,
+            emails: [],
+            phones: [],
+            addresses: [],
+            notes: result.text,
+        };
+    }
+}
+/**
+ * OLK15 content reader for tasks.
+ */
+export class Olk15TaskContentReader {
+    dataPath;
+    constructor(dataPath) {
+        this.dataPath = dataPath;
+    }
+    readTaskDetails(dataFilePath) {
+        if (dataFilePath == null) {
+            return null;
+        }
+        const fullPath = join(this.dataPath, dataFilePath);
+        const result = parseOlk15File(fullPath);
+        if (!result.success) {
+            return null;
+        }
+        return {
+            body: result.text ?? result.html,
+            completedDate: null,
+            reminderDate: null,
+            categories: [],
+        };
+    }
+}
+/**
+ * OLK15 content reader for notes.
+ */
+export class Olk15NoteContentReader {
+    dataPath;
+    constructor(dataPath) {
+        this.dataPath = dataPath;
+    }
+    readNoteDetails(dataFilePath) {
+        if (dataFilePath == null) {
+            return null;
+        }
+        const fullPath = join(this.dataPath, dataFilePath);
+        const result = parseOlk15File(fullPath);
+        if (!result.success) {
+            return null;
+        }
+        const body = result.text ?? result.html ?? '';
+        const lines = body.split(/\r?\n/).filter((l) => l.trim().length > 0);
+        return {
+            title: lines[0] ?? null,
+            body,
+            preview: body.substring(0, 200),
+            createdDate: null,
+            categories: [],
+        };
+    }
+}
+/**
+ * Creates content readers for all Outlook data types.
+ */
+export function createContentReaders(dataPath) {
+    return {
+        email: new Olk15EmailContentReader(dataPath),
+        event: new Olk15EventContentReader(dataPath),
+        contact: new Olk15ContactContentReader(dataPath),
+        task: new Olk15TaskContentReader(dataPath),
+        note: new Olk15NoteContentReader(dataPath),
+    };
+}
+/**
+ * Creates content readers using the default profile path.
+ */
+export function createDefaultContentReaders(profileName) {
+    const dataPath = getDefaultDataPath(profileName);
+    return createContentReaders(dataPath);
+}
+//# sourceMappingURL=olk15.js.map

package/dist/parsers/olk15.js.map

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

package/dist/tools/calendar.d.ts

@@ -0,0 +1,203 @@
+/**
+ * Calendar-related MCP tools.
+ *
+ * Provides tools for listing calendars, events, and searching.
+ */
+import { z } from 'zod';
+import type { IRepository } from '../database/repository.js';
+import type { CalendarFolder, EventSummary, Event, Attendee } from '../types/index.js';
+export declare const ListCalendarsInput: z.ZodObject<{}, z.core.$strict>;
+export declare const ListEventsInput: z.ZodObject<{
+    calendar_id: z.ZodOptional<z.ZodNumber>;
+    start_date: z.ZodOptional<z.ZodString>;
+    end_date: z.ZodOptional<z.ZodString>;
+    limit: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strict>;
+export declare const GetEventInput: z.ZodObject<{
+    event_id: z.ZodNumber;
+}, z.core.$strict>;
+export declare const SearchEventsInput: z.ZodObject<{
+    query: z.ZodString;
+    limit: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strict>;
+export declare const RespondToEventInput: z.ZodObject<{
+    event_id: z.ZodNumber;
+    response: z.ZodEnum<{
+        accept: "accept";
+        decline: "decline";
+        tentative: "tentative";
+    }>;
+    send_response: z.ZodDefault<z.ZodBoolean>;
+    comment: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export declare const RecurrenceInput: z.ZodObject<{
+    frequency: z.ZodEnum<{
+        daily: "daily";
+        weekly: "weekly";
+        monthly: "monthly";
+        yearly: "yearly";
+    }>;
+    interval: z.ZodDefault<z.ZodNumber>;
+    days_of_week: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        sunday: "sunday";
+        monday: "monday";
+        tuesday: "tuesday";
+        wednesday: "wednesday";
+        thursday: "thursday";
+        friday: "friday";
+        saturday: "saturday";
+    }>>>;
+    day_of_month: z.ZodOptional<z.ZodNumber>;
+    week_of_month: z.ZodOptional<z.ZodEnum<{
+        first: "first";
+        second: "second";
+        third: "third";
+        fourth: "fourth";
+        last: "last";
+    }>>;
+    day_of_week_monthly: z.ZodOptional<z.ZodEnum<{
+        sunday: "sunday";
+        monday: "monday";
+        tuesday: "tuesday";
+        wednesday: "wednesday";
+        thursday: "thursday";
+        friday: "friday";
+        saturday: "saturday";
+    }>>;
+    end: z.ZodDefault<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        type: z.ZodLiteral<"no_end">;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"end_date">;
+        date: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"end_after_count">;
+        count: z.ZodNumber;
+    }, z.core.$strict>], "type">>;
+}, z.core.$strict>;
+export declare const CreateEventInput: z.ZodObject<{
+    title: z.ZodString;
+    start_date: z.ZodString;
+    end_date: z.ZodString;
+    calendar_id: z.ZodOptional<z.ZodNumber>;
+    location: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    is_all_day: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    recurrence: z.ZodOptional<z.ZodObject<{
+        frequency: z.ZodEnum<{
+            daily: "daily";
+            weekly: "weekly";
+            monthly: "monthly";
+            yearly: "yearly";
+        }>;
+        interval: z.ZodDefault<z.ZodNumber>;
+        days_of_week: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+            sunday: "sunday";
+            monday: "monday";
+            tuesday: "tuesday";
+            wednesday: "wednesday";
+            thursday: "thursday";
+            friday: "friday";
+            saturday: "saturday";
+        }>>>;
+        day_of_month: z.ZodOptional<z.ZodNumber>;
+        week_of_month: z.ZodOptional<z.ZodEnum<{
+            first: "first";
+            second: "second";
+            third: "third";
+            fourth: "fourth";
+            last: "last";
+        }>>;
+        day_of_week_monthly: z.ZodOptional<z.ZodEnum<{
+            sunday: "sunday";
+            monday: "monday";
+            tuesday: "tuesday";
+            wednesday: "wednesday";
+            thursday: "thursday";
+            friday: "friday";
+            saturday: "saturday";
+        }>>;
+        end: z.ZodDefault<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            type: z.ZodLiteral<"no_end">;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"end_date">;
+            date: z.ZodString;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"end_after_count">;
+            count: z.ZodNumber;
+        }, z.core.$strict>], "type">>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type ListCalendarsParams = z.infer<typeof ListCalendarsInput>;
+export type ListEventsParams = z.infer<typeof ListEventsInput>;
+export type GetEventParams = z.infer<typeof GetEventInput>;
+export type SearchEventsParams = z.infer<typeof SearchEventsInput>;
+export type CreateEventParams = z.infer<typeof CreateEventInput>;
+export type RecurrenceParams = z.infer<typeof RecurrenceInput>;
+export type RespondToEventParams = z.infer<typeof RespondToEventInput>;
+/**
+ * Result of creating a calendar event.
+ */
+export interface CreateEventResult {
+    readonly id: number;
+    readonly title: string;
+    readonly start_date: string;
+    readonly end_date: string;
+    readonly calendar_id: number | null;
+    readonly location: string | null;
+    readonly description: string | null;
+    readonly is_all_day: boolean;
+    readonly is_recurring: boolean;
+}
+/**
+ * Interface for reading event content from data files.
+ */
+export interface IEventContentReader {
+    /**
+     * Reads event details from the given data file path.
+     */
+    readEventDetails(dataFilePath: string | null): EventDetails | null;
+}
+/**
+ * Event details from content file.
+ */
+export interface EventDetails {
+    readonly title: string | null;
+    readonly location: string | null;
+    readonly description: string | null;
+    readonly organizer: string | null;
+    readonly attendees: readonly Attendee[];
+}
+/**
+ * Default event content reader that returns null.
+ */
+export declare const nullEventContentReader: IEventContentReader;
+/**
+ * Calendar tools implementation with dependency injection.
+ */
+export declare class CalendarTools {
+    private readonly repository;
+    private readonly contentReader;
+    constructor(repository: IRepository, contentReader?: IEventContentReader);
+    /**
+     * Lists all calendar folders.
+     */
+    listCalendars(_params: ListCalendarsParams): CalendarFolder[];
+    /**
+     * Lists events with optional filtering.
+     */
+    listEvents(params: ListEventsParams): EventSummary[];
+    /**
+     * Gets a single event by ID.
+     */
+    getEvent(params: GetEventParams): Event | null;
+    /**
+     * Searches events by title (requires content reader).
+     * Note: Basic implementation - returns all events since title is in content files.
+     */
+    searchEvents(params: SearchEventsParams): EventSummary[];
+}
+/**
+ * Creates calendar tools with the given repository.
+ */
+export declare function createCalendarTools(repository: IRepository, contentReader?: IEventContentReader): CalendarTools;
+//# sourceMappingURL=calendar.d.ts.map

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

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