@laylzj777/my-apple-apple-eventkit 1.1.0

package/dist/tools/definitions.d.ts

@@ -0,0 +1,9 @@
+/**
+ * tools/definitions.ts
+ * MCP tool definitions for the Apple Reminders / Calendar server.
+ *
+ * The schema is the cross-action property union for each tool; the per-action
+ * validator (src/validation/schemas.ts) narrows the accepted fields.
+ */
+import type { Tool } from '@modelcontextprotocol/sdk/types.js';
+export declare const TOOLS: Tool[];

package/dist/tools/definitions.js

@@ -0,0 +1,272 @@
+/**
+ * tools/definitions.ts
+ * MCP tool definitions for the Apple Reminders / Calendar server.
+ *
+ * The schema is the cross-action property union for each tool; the per-action
+ * validator (src/validation/schemas.ts) narrows the accepted fields.
+ */
+import { CALENDAR_ACTIONS, DUE_WITHIN_OPTIONS, LIST_ACTIONS, REMINDER_ACTIONS, } from '../types/index.js';
+export const TOOLS = [
+    {
+        name: 'reminders_tasks',
+        description: 'Manages reminder tasks. Supports reading, creating, updating, and deleting reminders. Alarms, recurrence rules, and location-based triggers are read-only via this tool; configure them in Reminders.app.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                action: {
+                    type: 'string',
+                    enum: REMINDER_ACTIONS,
+                    description: 'The operation to perform.',
+                },
+                // ID-based operations
+                id: {
+                    type: 'string',
+                    description: 'The unique identifier of the reminder (REQUIRED for update, delete; optional for read to get single reminder).',
+                },
+                // Creation/Update properties
+                title: {
+                    type: 'string',
+                    description: 'The title of the reminder (REQUIRED for create, optional for update).',
+                },
+                startDate: {
+                    type: 'string',
+                    description: "Start date. UPDATE-ONLY: the underlying CLI cannot set a start date at create time. RECOMMENDED format: 'YYYY-MM-DD HH:mm:ss' (local time without timezone). Also supports 'YYYY-MM-DD' and ISO 8601 with timezone.",
+                },
+                dueDate: {
+                    type: 'string',
+                    description: "Due date. RECOMMENDED format: 'YYYY-MM-DD HH:mm:ss' (local time without timezone, e.g., '2025-11-04 18:00:00'). Also supports: 'YYYY-MM-DD', 'YYYY-MM-DDTHH:mm:ss', or ISO 8601 with timezone (e.g., '2025-10-30T04:00:00Z'). When no timezone is specified, the time is interpreted as local time.",
+                },
+                note: {
+                    type: 'string',
+                    description: 'Additional notes for the reminder.',
+                },
+                url: {
+                    type: 'string',
+                    description: 'A URL to associate with the reminder.',
+                    format: 'uri',
+                },
+                completed: {
+                    type: 'boolean',
+                    description: 'Mark the reminder as completed/uncompleted (update only).',
+                },
+                priority: {
+                    type: 'integer',
+                    enum: [0, 1, 5, 9],
+                    description: 'Priority level: 0=none, 1=high, 5=medium, 9=low (for create/update).',
+                },
+                targetList: {
+                    type: 'string',
+                    description: 'The name of the list for create or update operations.',
+                },
+                // Read filters
+                filterList: {
+                    type: 'string',
+                    description: 'Filter reminders by a specific list name.',
+                },
+                showCompleted: {
+                    type: 'boolean',
+                    description: 'Include completed reminders in the results.',
+                    default: false,
+                },
+                search: {
+                    type: 'string',
+                    description: 'A search term to filter reminders by title or notes (applied in TS after fetch).',
+                },
+                dueWithin: {
+                    type: 'string',
+                    enum: DUE_WITHIN_OPTIONS,
+                    description: 'Filter reminders by a due date range (applied in TS after fetch).',
+                },
+                filterPriority: {
+                    type: 'string',
+                    enum: ['high', 'medium', 'low', 'none'],
+                    description: 'Filter reminders by priority level.',
+                },
+                filterRecurring: {
+                    type: 'boolean',
+                    description: 'Filter to only show recurring reminders when true.',
+                },
+                filterLocationBased: {
+                    type: 'boolean',
+                    description: 'Filter to only show location-based reminders when true.',
+                },
+                // Tag filtering
+                filterTags: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: 'Filter reminders by tags (must have ALL specified tags). Example: ["work", "urgent"]',
+                },
+                // Tag properties for create/update
+                tags: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: 'Tags to set on the reminder (for create). Replaces any existing tags. Example: ["work", "urgent"]',
+                },
+                addTags: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: 'Tags to add to the reminder (for update). Merges with existing tags. Example: ["followup"]',
+                },
+                removeTags: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: 'Tags to remove from the reminder (for update). Example: ["urgent"]',
+                },
+                // Subtask properties for create
+                subtasks: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: 'Initial subtasks to create with the reminder (for create action). Provide an array of subtask titles. Example: ["Buy milk", "Get eggs", "Pick up bread"]',
+                },
+            },
+            required: ['action'],
+        },
+    },
+    {
+        name: 'reminders_lists',
+        description: 'Manages reminder lists. Supports reading, creating, updating, and deleting reminder lists.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                action: {
+                    type: 'string',
+                    enum: LIST_ACTIONS,
+                    description: 'The operation to perform on a list.',
+                },
+                name: {
+                    type: 'string',
+                    description: 'The current name of the list (for update, delete) or the name of the new list (for create).',
+                },
+                newName: {
+                    type: 'string',
+                    description: 'The new name for the list (for update).',
+                },
+            },
+            required: ['action'],
+        },
+    },
+    {
+        name: 'calendar_events',
+        description: 'Manages calendar events (time blocks). Supports reading, creating, updating, and deleting events. URL, structured-location, all-day toggle, availability, alarms, and recurrence rules are read-only via this tool; configure them in Calendar.app. All-day events are inferred from the date format ("YYYY-MM-DD" without a time component).',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                action: {
+                    type: 'string',
+                    enum: CALENDAR_ACTIONS,
+                    description: 'The operation to perform.',
+                },
+                // ID-based operations
+                id: {
+                    type: 'string',
+                    description: 'The unique identifier of the event (REQUIRED for update, delete; optional for read to get single event).',
+                },
+                // Creation/Update properties
+                title: {
+                    type: 'string',
+                    description: 'The title of the event (REQUIRED for create, optional for update).',
+                },
+                startDate: {
+                    type: 'string',
+                    description: "Start date and time. RECOMMENDED format: 'YYYY-MM-DD HH:mm:ss' (local time, e.g., '2025-11-04 09:00:00'). Use 'YYYY-MM-DD' (no time) for all-day events. Also supports 'YYYY-MM-DDTHH:mm:ss' or ISO 8601 with timezone. For action='read': if omitted and endDate is omitted, defaults to today; if only endDate is provided, startDate defaults to endDate - 14 days.",
+                },
+                endDate: {
+                    type: 'string',
+                    description: "End date and time. RECOMMENDED format: 'YYYY-MM-DD HH:mm:ss' (local time). Use 'YYYY-MM-DD' (no time) for all-day events. Also supports 'YYYY-MM-DDTHH:mm:ss' or ISO 8601 with timezone. For action='read': if omitted and startDate is omitted, defaults to today + 14 days; if only startDate is provided, endDate defaults to startDate + 14 days.",
+                },
+                note: {
+                    type: 'string',
+                    description: 'Additional notes for the event.',
+                },
+                location: {
+                    type: 'string',
+                    description: 'Location text for the event.',
+                },
+                availability: {
+                    type: 'string',
+                    enum: ['not-supported', 'busy', 'free', 'tentative', 'unavailable'],
+                    description: 'READ-ONLY filter: narrow read results by event availability. Cannot be set via create/update; configure in Calendar.app.',
+                },
+                span: {
+                    type: 'string',
+                    enum: ['this-event', 'future-events'],
+                    description: 'Scope for changes to recurring events: this-event or future-events.',
+                },
+                targetCalendar: {
+                    type: 'string',
+                    description: 'The name of the calendar for the create action. Events cannot be moved across calendars via update — delete and recreate instead.',
+                },
+                // Read filters
+                filterCalendar: {
+                    type: 'string',
+                    description: 'Filter events by a specific calendar name.',
+                },
+                search: {
+                    type: 'string',
+                    description: 'A search term to filter events by title, notes, or location (applied in TS after fetch).',
+                },
+            },
+            required: ['action'],
+        },
+    },
+    {
+        name: 'calendar_calendars',
+        description: 'Reads calendar collections. Use to inspect available calendars before creating or updating events. Optional date range filters return only calendars with events in that range.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                action: {
+                    type: 'string',
+                    enum: ['read'],
+                    description: 'The operation to perform on calendars.',
+                },
+                startDate: {
+                    type: 'string',
+                    description: "Optional range start for scoped calendar discovery. Format: 'YYYY-MM-DD', 'YYYY-MM-DD HH:mm:ss', or ISO 8601. If only one of startDate/endDate is supplied, the other is filled in as a 14-day window from the bound that was given.",
+                },
+                endDate: {
+                    type: 'string',
+                    description: 'Optional range end for scoped calendar discovery. When used with startDate, only calendars with at least one event in the range are returned, each annotated with the in-range event count (recurring events count as one per instance). endDate must be on or after startDate.',
+                },
+            },
+            required: ['action'],
+        },
+    },
+    {
+        name: 'reminders_subtasks',
+        description: 'Manages subtasks/checklists within reminders. Subtasks are stored in the notes field and visible in the native Reminders app. Use this to create checklist items for a reminder.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                action: {
+                    type: 'string',
+                    enum: ['read', 'create', 'update', 'delete', 'toggle', 'reorder'],
+                    description: 'The operation to perform: read (list subtasks), create (add new), update (modify), delete (remove), toggle (flip completion), reorder (change order).',
+                },
+                reminderId: {
+                    type: 'string',
+                    description: 'The unique identifier of the parent reminder (REQUIRED for all operations).',
+                },
+                subtaskId: {
+                    type: 'string',
+                    description: 'The unique identifier of the subtask (REQUIRED for update, delete, toggle).',
+                },
+                title: {
+                    type: 'string',
+                    description: 'The title of the subtask (REQUIRED for create, optional for update).',
+                },
+                completed: {
+                    type: 'boolean',
+                    description: 'The completion status of the subtask (for update).',
+                },
+                order: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: 'Array of subtask IDs in desired order (REQUIRED for reorder). Must include all subtask IDs.',
+                },
+            },
+            required: ['action', 'reminderId'],
+        },
+    },
+];
+//# sourceMappingURL=definitions.js.map

package/dist/tools/definitions.js.map

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

package/dist/tools/handlers/calendarHandlers.d.ts

@@ -0,0 +1,11 @@
+/**
+ * handlers/calendarHandlers.ts
+ * Handlers for calendar event operations
+ */
+import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+import type { CalendarsToolArgs, CalendarToolArgs } from '../../types/index.js';
+export declare const handleCreateCalendarEvent: (args: CalendarToolArgs) => Promise<CallToolResult>;
+export declare const handleUpdateCalendarEvent: (args: CalendarToolArgs) => Promise<CallToolResult>;
+export declare const handleDeleteCalendarEvent: (args: CalendarToolArgs) => Promise<CallToolResult>;
+export declare const handleReadCalendarEvents: (args: CalendarToolArgs) => Promise<CallToolResult>;
+export declare const handleReadCalendars: (args?: CalendarsToolArgs) => Promise<CallToolResult>;

package/dist/tools/handlers/calendarHandlers.js

@@ -0,0 +1,151 @@
+/**
+ * handlers/calendarHandlers.ts
+ * Handlers for calendar event operations
+ */
+import { calendarRepository } from '../../utils/calendarRepository.js';
+import { handleAsyncOperation } from '../../utils/errorHandling.js';
+import { formatMultilineNotes } from '../../utils/helpers.js';
+import { CreateCalendarEventSchema, DeleteCalendarEventSchema, ReadCalendarEventsSchema, ReadCalendarsSchema, UpdateCalendarEventSchema, } from '../../validation/schemas.js';
+import { formatAlarm, formatRecurrenceRules } from './formatters.js';
+import { extractAndValidateArgs, formatDeleteMessage, formatListMarkdown, formatSuccessMessage, UNTRUSTED_DATA_NOTICE, } from './shared.js';
+/**
+ * Formats a calendar event as a markdown list item. Renders alarms /
+ * recurrence rules through the same helpers as the reminder formatter so the
+ * two outputs stay structurally consistent (instead of degenerating to bare
+ * counts like `Alarms: 2`).
+ */
+const formatEventMarkdown = (event) => {
+    const lines = [];
+    lines.push(`- ${event.title}`);
+    if (event.calendar)
+        lines.push(`  - Calendar: ${event.calendar}`);
+    if (event.id)
+        lines.push(`  - ID: ${event.id}`);
+    if (event.startDate)
+        lines.push(`  - Start: ${event.startDate}`);
+    if (event.endDate)
+        lines.push(`  - End: ${event.endDate}`);
+    if (event.isAllDay !== undefined)
+        lines.push(`  - All Day: ${event.isAllDay}`);
+    if (event.location)
+        lines.push(`  - Location: ${event.location}`);
+    if (event.structuredLocation)
+        lines.push(`  - Structured Location: ${event.structuredLocation.title}`);
+    if (event.availability)
+        lines.push(`  - Availability: ${event.availability}`);
+    if (event.alarms && event.alarms.length > 0) {
+        lines.push(`  - Alarms: ${event.alarms.map(formatAlarm).join('; ')}`);
+    }
+    if (event.recurrenceRules && event.recurrenceRules.length > 0) {
+        lines.push(`  - Repeats: ${formatRecurrenceRules(event.recurrenceRules)}`);
+    }
+    if (event.organizer)
+        lines.push(`  - Organizer: ${event.organizer.name ?? event.organizer.url}`);
+    if (event.attendees && event.attendees.length > 0) {
+        const attendeeList = event.attendees.map((a) => a.name ?? a.url).join(', ');
+        lines.push(`  - Attendees (${event.attendees.length}): ${attendeeList}`);
+    }
+    if (event.status)
+        lines.push(`  - Status: ${event.status}`);
+    if (event.isDetached !== undefined)
+        lines.push(`  - Detached: ${event.isDetached}`);
+    if (event.occurrenceDate)
+        lines.push(`  - Occurrence Date: ${event.occurrenceDate}`);
+    if (event.externalId)
+        lines.push(`  - External ID: ${event.externalId}`);
+    if (event.creationDate)
+        lines.push(`  - Created: ${event.creationDate}`);
+    if (event.lastModifiedDate)
+        lines.push(`  - Modified: ${event.lastModifiedDate}`);
+    if (event.notes)
+        lines.push(`  - Notes: ${formatMultilineNotes(event.notes)}`);
+    if (event.url)
+        lines.push(`  - URL: ${event.url}`);
+    return lines;
+};
+export const handleCreateCalendarEvent = async (args) => {
+    return handleAsyncOperation(async () => {
+        const validatedArgs = extractAndValidateArgs(args, CreateCalendarEventSchema);
+        const event = await calendarRepository.createEvent({
+            title: validatedArgs.title,
+            startDate: validatedArgs.startDate,
+            endDate: validatedArgs.endDate,
+            calendar: validatedArgs.targetCalendar,
+            notes: validatedArgs.note,
+            location: validatedArgs.location,
+        });
+        return formatSuccessMessage('created', 'event', event.title, event.id);
+    }, 'create calendar event');
+};
+export const handleUpdateCalendarEvent = async (args) => {
+    return handleAsyncOperation(async () => {
+        const validatedArgs = extractAndValidateArgs(args, UpdateCalendarEventSchema);
+        const event = await calendarRepository.updateEvent({
+            id: validatedArgs.id,
+            title: validatedArgs.title,
+            startDate: validatedArgs.startDate,
+            endDate: validatedArgs.endDate,
+            notes: validatedArgs.note,
+            location: validatedArgs.location,
+        });
+        return formatSuccessMessage('updated', 'event', event.title, event.id);
+    }, 'update calendar event');
+};
+export const handleDeleteCalendarEvent = async (args) => {
+    return handleAsyncOperation(async () => {
+        const validatedArgs = extractAndValidateArgs(args, DeleteCalendarEventSchema);
+        await calendarRepository.deleteEvent(validatedArgs.id, validatedArgs.span);
+        return formatDeleteMessage('event', validatedArgs.id, {
+            useQuotes: true,
+            useIdPrefix: true,
+            usePeriod: true,
+            useColon: false,
+        });
+    }, 'delete calendar event');
+};
+export const handleReadCalendarEvents = async (args) => {
+    return handleAsyncOperation(async () => {
+        const validatedArgs = extractAndValidateArgs(args, ReadCalendarEventsSchema);
+        if (validatedArgs.id) {
+            const event = await calendarRepository.findEventById(validatedArgs.id);
+            return [
+                '### Calendar Event',
+                '',
+                UNTRUSTED_DATA_NOTICE,
+                '',
+                ...formatEventMarkdown(event),
+            ].join('\n');
+        }
+        const events = await calendarRepository.findEvents({
+            startDate: validatedArgs.startDate,
+            endDate: validatedArgs.endDate,
+            calendarName: validatedArgs.filterCalendar,
+            search: validatedArgs.search,
+            availability: validatedArgs.availability,
+        });
+        return formatListMarkdown('Calendar Events', events, formatEventMarkdown, 'No calendar events found.');
+    }, 'read calendar events');
+};
+export const handleReadCalendars = async (args) => {
+    return handleAsyncOperation(async () => {
+        const validatedArgs = extractAndValidateArgs(args, ReadCalendarsSchema);
+        const calendars = await calendarRepository.findCalendars({
+            startDate: validatedArgs.startDate,
+            endDate: validatedArgs.endDate,
+        });
+        return formatListMarkdown('Calendars', calendars, (calendar) => {
+            // The vendored `event` CLI doesn't expose EventKit calendar
+            // identifiers, so calendars synthesized from the read window have
+            // `id === title`. Skip the trailing `(ID: …)` then since it just
+            // duplicates the title.
+            const idSuffix = calendar.id && calendar.id !== calendar.title
+                ? ` (ID: ${calendar.id})`
+                : '';
+            const countSuffix = calendar.eventCount !== undefined
+                ? ` - ${calendar.eventCount} event${calendar.eventCount === 1 ? '' : 's'}`
+                : '';
+            return [`- ${calendar.title}${idSuffix}${countSuffix}`];
+        }, 'No calendars found.');
+    }, 'read calendars');
+};
+//# sourceMappingURL=calendarHandlers.js.map

package/dist/tools/handlers/calendarHandlers.js.map

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

package/dist/tools/handlers/formatters.d.ts

@@ -0,0 +1,24 @@
+/**
+ * handlers/formatters.ts
+ * Shared display formatters for reminder/event sub-structures (alarms,
+ * recurrence rules, location triggers). Calendar events and reminders both
+ * persist these as the same EventKit primitives, so rendering them through
+ * a single set of helpers keeps the two tool outputs consistent.
+ */
+import type { Alarm, LocationTrigger, RecurrenceRule } from '../../types/index.js';
+/**
+ * Formats a single recurrence rule into a short human-readable phrase
+ * (e.g. "every 2 weeks on Mon, Wed").
+ */
+export declare const formatRecurrence: (recurrence: RecurrenceRule) => string;
+export declare const formatRecurrenceRules: (rules: RecurrenceRule[]) => string;
+/**
+ * Formats a location trigger as a short human-readable phrase
+ * (e.g. `Arriving at "Home" (100m radius)`).
+ */
+export declare const formatLocationTrigger: (location: LocationTrigger) => string;
+/**
+ * Formats a single alarm — relative offset, absolute date, or location
+ * trigger — into a single line.
+ */
+export declare const formatAlarm: (alarm: Alarm) => string;

package/dist/tools/handlers/formatters.js

@@ -0,0 +1,105 @@
+/**
+ * handlers/formatters.ts
+ * Shared display formatters for reminder/event sub-structures (alarms,
+ * recurrence rules, location triggers). Calendar events and reminders both
+ * persist these as the same EventKit primitives, so rendering them through
+ * a single set of helpers keeps the two tool outputs consistent.
+ */
+/**
+ * Formats a single recurrence rule into a short human-readable phrase
+ * (e.g. "every 2 weeks on Mon, Wed").
+ */
+export const formatRecurrence = (recurrence) => {
+    const parts = [];
+    const interval = recurrence.interval > 1 ? `every ${recurrence.interval} ` : '';
+    switch (recurrence.frequency) {
+        case 'minutely':
+            parts.push(`${interval}minute${recurrence.interval > 1 ? 's' : ''}`);
+            break;
+        case 'hourly':
+            parts.push(`${interval}hour${recurrence.interval > 1 ? 's' : ''}`);
+            break;
+        case 'daily':
+            parts.push(`${interval}day${recurrence.interval > 1 ? 's' : ''}`);
+            break;
+        case 'weekly':
+            parts.push(`${interval}week${recurrence.interval > 1 ? 's' : ''}`);
+            if (recurrence.daysOfWeek?.length) {
+                const dayNames = ['', 'Sun', 'Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat'];
+                const days = recurrence.daysOfWeek.map((d) => dayNames[d]).join(', ');
+                parts.push(`on ${days}`);
+            }
+            break;
+        case 'monthly':
+            parts.push(`${interval}month${recurrence.interval > 1 ? 's' : ''}`);
+            if (recurrence.daysOfMonth?.length) {
+                parts.push(`on day${recurrence.daysOfMonth.length > 1 ? 's' : ''} ${recurrence.daysOfMonth.join(', ')}`);
+            }
+            break;
+        case 'yearly':
+            parts.push(`${interval}year${recurrence.interval > 1 ? 's' : ''}`);
+            if (recurrence.monthsOfYear?.length) {
+                const monthNames = [
+                    '',
+                    'Jan',
+                    'Feb',
+                    'Mar',
+                    'Apr',
+                    'May',
+                    'Jun',
+                    'Jul',
+                    'Aug',
+                    'Sep',
+                    'Oct',
+                    'Nov',
+                    'Dec',
+                ];
+                const months = recurrence.monthsOfYear
+                    .map((m) => monthNames[m])
+                    .join(', ');
+                parts.push(`in ${months}`);
+            }
+            break;
+        default: {
+            const exhaustiveCheck = recurrence.frequency;
+            throw new Error(`Unknown recurrence frequency: ${exhaustiveCheck}`);
+        }
+    }
+    if (recurrence.endDate) {
+        parts.push(`until ${recurrence.endDate}`);
+    }
+    else if (recurrence.occurrenceCount) {
+        parts.push(`(${recurrence.occurrenceCount} times)`);
+    }
+    return parts.join(' ');
+};
+export const formatRecurrenceRules = (rules) => {
+    const [first, ...rest] = rules;
+    if (first && rest.length === 0)
+        return formatRecurrence(first);
+    return rules.map((rule) => formatRecurrence(rule)).join('; ');
+};
+/**
+ * Formats a location trigger as a short human-readable phrase
+ * (e.g. `Arriving at "Home" (100m radius)`).
+ */
+export const formatLocationTrigger = (location) => {
+    const proximityText = location.proximity === 'enter' ? 'Arriving at' : 'Leaving';
+    const radiusText = location.radius ? ` (${location.radius}m radius)` : '';
+    return `${proximityText} "${location.title}"${radiusText}`;
+};
+/**
+ * Formats a single alarm — relative offset, absolute date, or location
+ * trigger — into a single line.
+ */
+export const formatAlarm = (alarm) => {
+    const typeStr = alarm.alarmType ? ` (${alarm.alarmType})` : '';
+    if (alarm.absoluteDate)
+        return `at ${alarm.absoluteDate}${typeStr}`;
+    if (alarm.relativeOffset !== undefined)
+        return `${alarm.relativeOffset}s from due/start${typeStr}`;
+    if (alarm.locationTrigger)
+        return `on ${formatLocationTrigger(alarm.locationTrigger)}${typeStr}`;
+    return 'unknown';
+};
+//# sourceMappingURL=formatters.js.map

package/dist/tools/handlers/formatters.js.map

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

package/dist/tools/handlers/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * handlers/index.ts
+ * Unified exports for all tool handlers
+ */
+export { handleCreateCalendarEvent, handleDeleteCalendarEvent, handleReadCalendarEvents, handleReadCalendars, handleUpdateCalendarEvent, } from './calendarHandlers.js';
+export { handleCreateReminderList, handleDeleteReminderList, handleReadReminderLists, handleUpdateReminderList, } from './listHandlers.js';
+export { handleCreateReminder, handleDeleteReminder, handleReadReminders, handleUpdateReminder, } from './reminderHandlers.js';
+export { handleCreateSubtask, handleDeleteSubtask, handleReadSubtasks, handleReorderSubtasks, handleToggleSubtask, handleUpdateSubtask, } from './subtaskHandlers.js';

package/dist/tools/handlers/index.js

@@ -0,0 +1,9 @@
+/**
+ * handlers/index.ts
+ * Unified exports for all tool handlers
+ */
+export { handleCreateCalendarEvent, handleDeleteCalendarEvent, handleReadCalendarEvents, handleReadCalendars, handleUpdateCalendarEvent, } from './calendarHandlers.js';
+export { handleCreateReminderList, handleDeleteReminderList, handleReadReminderLists, handleUpdateReminderList, } from './listHandlers.js';
+export { handleCreateReminder, handleDeleteReminder, handleReadReminders, handleUpdateReminder, } from './reminderHandlers.js';
+export { handleCreateSubtask, handleDeleteSubtask, handleReadSubtasks, handleReorderSubtasks, handleToggleSubtask, handleUpdateSubtask, } from './subtaskHandlers.js';
+//# sourceMappingURL=index.js.map

package/dist/tools/handlers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/handlers/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACL,yBAAyB,EACzB,yBAAyB,EACzB,wBAAwB,EACxB,mBAAmB,EACnB,yBAAyB,GAC1B,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,wBAAwB,EACxB,wBAAwB,EACxB,uBAAuB,EACvB,wBAAwB,GACzB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,kBAAkB,EAClB,qBAAqB,EACrB,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,sBAAsB,CAAC"}

package/dist/tools/handlers/listHandlers.d.ts

@@ -0,0 +1,10 @@
+/**
+ * handlers/listHandlers.ts
+ * Handlers for reminder list operations
+ */
+import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+import type { ListsToolArgs } from '../../types/index.js';
+export declare const handleReadReminderLists: () => Promise<CallToolResult>;
+export declare const handleCreateReminderList: (args: ListsToolArgs) => Promise<CallToolResult>;
+export declare const handleUpdateReminderList: (args: ListsToolArgs) => Promise<CallToolResult>;
+export declare const handleDeleteReminderList: (args: ListsToolArgs) => Promise<CallToolResult>;