@laylzj777/my-apple-apple-eventkit 1.1.0

package/dist/types/index.d.ts

@@ -0,0 +1,263 @@
+/**
+ * types/index.ts
+ * Type definitions for the Apple Reminders MCP server
+ */
+/**
+ * Priority levels for reminders, matching `EKReminderPriority` raw values:
+ * 0 = none, 1 = high, 5 = medium, 9 = low. Other integers in 1–9 fall in
+ * between those buckets but are not produced by Apple's UI; the read path
+ * still tolerates them via `PRIORITY_LABELS[priority] ?? 'unknown'`.
+ */
+export type ReminderPriority = 0 | 1 | 5 | 9;
+/**
+ * Priority label mapping for display
+ */
+export declare const PRIORITY_LABELS: Record<number, string>;
+/**
+ * Recurrence frequency types
+ */
+export type RecurrenceFrequency = 'minutely' | 'hourly' | 'daily' | 'weekly' | 'monthly' | 'yearly';
+/**
+ * Recurrence rule interface for repeating reminders
+ */
+export interface RecurrenceRule {
+    frequency: RecurrenceFrequency;
+    interval: number;
+    endDate?: string;
+    occurrenceCount?: number;
+    daysOfWeek?: number[];
+    daysOfMonth?: number[];
+    monthsOfYear?: number[];
+}
+/**
+ * Location trigger proximity types
+ */
+export type LocationProximity = 'enter' | 'leave';
+/**
+ * Location trigger interface for geofence-based reminders
+ */
+export interface LocationTrigger {
+    title: string;
+    latitude: number;
+    longitude: number;
+    radius?: number;
+    proximity: LocationProximity;
+}
+/**
+ * Structured location interface (EventKit EKStructuredLocation)
+ */
+export interface StructuredLocation {
+    title: string;
+    latitude?: number;
+    longitude?: number;
+    radius?: number;
+}
+/**
+ * Alarm interface (EventKit EKAlarm)
+ * - Relative alarms use seconds offset from start/due dates (negative = before).
+ * - Absolute alarms fire at a specific date/time.
+ * - Location alarms use a structured location + proximity (geofence).
+ * - alarmType is READ-ONLY: determined automatically by EventKit based on alarm properties.
+ */
+export interface Alarm {
+    relativeOffset?: number;
+    absoluteDate?: string;
+    locationTrigger?: LocationTrigger;
+    alarmType?: 'display' | 'audio' | 'procedure' | 'email';
+}
+/**
+ * Subtask interface for checklist items within reminders
+ */
+export interface Subtask {
+    id: string;
+    title: string;
+    isCompleted: boolean;
+}
+/**
+ * Subtask progress info
+ */
+export interface SubtaskProgress {
+    completed: number;
+    total: number;
+    percentage: number;
+}
+/**
+ * Reminder item interface
+ */
+export interface Reminder {
+    id: string;
+    title: string;
+    startDate?: string;
+    dueDate?: string;
+    completionDate?: string;
+    notes?: string;
+    url?: string;
+    location?: string;
+    timeZone?: string;
+    creationDate?: string;
+    lastModifiedDate?: string;
+    externalId?: string;
+    list: string;
+    isCompleted: boolean;
+    priority: number;
+    alarms?: Alarm[];
+    recurrenceRules?: RecurrenceRule[];
+    locationTrigger?: LocationTrigger;
+    tags?: string[];
+    subtasks?: Subtask[];
+    subtaskProgress?: SubtaskProgress;
+}
+/**
+ * Reminder list interface
+ */
+export interface ReminderList {
+    id: string;
+    title: string;
+    color?: string;
+}
+/**
+ * Calendar event interface
+ */
+export interface CalendarEvent {
+    id: string;
+    title: string;
+    startDate: string;
+    endDate: string;
+    calendar: string;
+    notes?: string;
+    location?: string;
+    structuredLocation?: StructuredLocation;
+    url?: string;
+    isAllDay: boolean;
+    availability?: 'not-supported' | 'busy' | 'free' | 'tentative' | 'unavailable' | 'unknown';
+    alarms?: Alarm[];
+    recurrenceRules?: RecurrenceRule[];
+    organizer?: {
+        name?: string;
+        url: string;
+    };
+    attendees?: Array<{
+        name?: string;
+        url: string;
+        status: string;
+        role: string;
+        type: string;
+        isCurrentUser: boolean;
+    }>;
+    status?: string;
+    isDetached?: boolean;
+    occurrenceDate?: string;
+    creationDate?: string;
+    lastModifiedDate?: string;
+    externalId?: string;
+}
+/**
+ * Calendar interface
+ */
+export interface Calendar {
+    id: string;
+    title: string;
+    eventCount?: number;
+}
+/**
+ * Server configuration
+ */
+export interface ServerConfig {
+    name: string;
+    version: string;
+    /** 子模块模式(fork 增量):按域暴露工具,缺省 'all'。见 server/mode.ts。 */
+    mode?: import('../server/mode.js').ServerMode;
+}
+/**
+ * Shared type constants for better type safety and consistency
+ */
+export type ReminderAction = 'read' | 'create' | 'update' | 'delete';
+export type ListAction = 'read' | 'create' | 'update' | 'delete';
+export type CalendarAction = 'read' | 'create' | 'update' | 'delete';
+export type CalendarsAction = 'read';
+export type DueWithinOption = 'today' | 'tomorrow' | 'this-week' | 'overdue' | 'no-date';
+/**
+ * Action constant arrays for enum validation
+ */
+export declare const REMINDER_ACTIONS: readonly ReminderAction[];
+export declare const LIST_ACTIONS: readonly ListAction[];
+export declare const CALENDAR_ACTIONS: readonly CalendarAction[];
+export declare const DUE_WITHIN_OPTIONS: readonly DueWithinOption[];
+/**
+ * Base tool arguments interface
+ */
+interface BaseToolArgs {
+    action: string;
+}
+/**
+ * Tool argument types - keeping flexible for handler routing while maintaining type safety
+ */
+export interface RemindersToolArgs extends BaseToolArgs {
+    action: ReminderAction;
+    id?: string;
+    filterList?: string;
+    showCompleted?: boolean;
+    search?: string;
+    dueWithin?: DueWithinOption;
+    filterPriority?: 'high' | 'medium' | 'low' | 'none';
+    filterRecurring?: boolean;
+    filterLocationBased?: boolean;
+    filterTags?: string[];
+    title?: string;
+    newTitle?: string;
+    startDate?: string;
+    dueDate?: string;
+    note?: string;
+    url?: string;
+    completed?: boolean;
+    priority?: number;
+    tags?: string[];
+    addTags?: string[];
+    removeTags?: string[];
+    subtasks?: string[];
+    targetList?: string;
+}
+/**
+ * Subtask action type
+ */
+export type SubtaskAction = 'read' | 'create' | 'update' | 'delete' | 'toggle' | 'reorder';
+/**
+ * Tool arguments for subtask operations
+ */
+export interface SubtasksToolArgs extends BaseToolArgs {
+    action: SubtaskAction;
+    reminderId: string;
+    subtaskId?: string;
+    title?: string;
+    completed?: boolean;
+    order?: string[];
+}
+export interface ListsToolArgs extends BaseToolArgs {
+    action: ListAction;
+    name?: string;
+    newName?: string;
+}
+export interface CalendarToolArgs extends BaseToolArgs {
+    action: CalendarAction;
+    id?: string;
+    filterCalendar?: string;
+    search?: string;
+    availability?: 'not-supported' | 'busy' | 'free' | 'tentative' | 'unavailable';
+    startDate?: string;
+    endDate?: string;
+    title?: string;
+    note?: string;
+    location?: string;
+    span?: 'this-event' | 'future-events';
+    targetCalendar?: string;
+}
+export interface CalendarsToolArgs extends BaseToolArgs {
+    action: CalendarsAction;
+    startDate?: string;
+    endDate?: string;
+}
+/**
+ * Prompt-related type exports for consumers that need to interact with the
+ * structured MCP prompt registry.
+ */
+export type { DailyTaskOrganizerArgs, PromptArgsByName, PromptArgumentDefinition, PromptMessage, PromptMessageContent, PromptMetadata, PromptName, PromptResponse, PromptTemplate, ReminderReviewAssistantArgs, SmartReminderCreatorArgs, WeeklyPlanningWorkflowArgs, } from './prompts.js';

package/dist/types/index.js

@@ -0,0 +1,42 @@
+/**
+ * types/index.ts
+ * Type definitions for the Apple Reminders MCP server
+ */
+/**
+ * Priority label mapping for display
+ */
+export const PRIORITY_LABELS = {
+    0: 'none',
+    1: 'high',
+    5: 'medium',
+    9: 'low',
+};
+/**
+ * Action constant arrays for enum validation
+ */
+export const REMINDER_ACTIONS = [
+    'read',
+    'create',
+    'update',
+    'delete',
+];
+export const LIST_ACTIONS = [
+    'read',
+    'create',
+    'update',
+    'delete',
+];
+export const CALENDAR_ACTIONS = [
+    'read',
+    'create',
+    'update',
+    'delete',
+];
+export const DUE_WITHIN_OPTIONS = [
+    'today',
+    'tomorrow',
+    'this-week',
+    'overdue',
+    'no-date',
+];
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAUH;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAA2B;IACrD,CAAC,EAAE,MAAM;IACT,CAAC,EAAE,MAAM;IACT,CAAC,EAAE,QAAQ;IACX,CAAC,EAAE,KAAK;CACT,CAAC;AAqMF;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAA8B;IACzD,MAAM;IACN,QAAQ;IACR,QAAQ;IACR,QAAQ;CACA,CAAC;AAEX,MAAM,CAAC,MAAM,YAAY,GAA0B;IACjD,MAAM;IACN,QAAQ;IACR,QAAQ;IACR,QAAQ;CACA,CAAC;AAEX,MAAM,CAAC,MAAM,gBAAgB,GAA8B;IACzD,MAAM;IACN,QAAQ;IACR,QAAQ;IACR,QAAQ;CACA,CAAC;AAEX,MAAM,CAAC,MAAM,kBAAkB,GAA+B;IAC5D,OAAO;IACP,UAAU;IACV,WAAW;IACX,SAAS;IACT,SAAS;CACD,CAAC"}

package/dist/types/prompts.d.ts

@@ -0,0 +1,88 @@
+/**
+ * types/prompts.ts
+ * Type definitions for MCP prompt templates and arguments
+ */
+export type PromptName = 'daily-task-organizer' | 'smart-reminder-creator' | 'reminder-review-assistant' | 'weekly-planning-workflow';
+/**
+ * Describes an individual prompt argument exposed to MCP clients.
+ */
+export interface PromptArgumentDefinition {
+    name: string;
+    description: string;
+    required: boolean;
+}
+/**
+ * Prompt metadata that is surfaced through the `ListPrompts` endpoint.
+ * Fields mirror the MCP `Prompt` schema (`name`, optional `title`,
+ * `description`, `arguments`). A `version` field was previously included but
+ * the MCP `Prompt` type has no such concept, so clients silently dropped it.
+ */
+export interface PromptMetadata<Name extends PromptName = PromptName> {
+    name: Name;
+    title?: string;
+    description: string;
+    arguments: PromptArgumentDefinition[];
+}
+/**
+ * Content definition for a single prompt message.
+ */
+export interface PromptMessageContent {
+    type: 'text';
+    text: string;
+}
+/**
+ * User-facing prompt message structure used when constructing prompt templates.
+ */
+export interface PromptMessage {
+    role: 'user';
+    content: PromptMessageContent;
+}
+/**
+ * Response payload returned from `GetPrompt` requests.
+ */
+export interface PromptResponse {
+    description: string;
+    messages: PromptMessage[];
+    [key: string]: unknown;
+}
+/**
+ * Arguments accepted by the `daily-task-organizer` prompt.
+ */
+export interface DailyTaskOrganizerArgs {
+    "Today's focus"?: string;
+}
+/**
+ * Arguments accepted by the `smart-reminder-creator` prompt.
+ */
+export interface SmartReminderCreatorArgs {
+    'Task idea'?: string;
+}
+/**
+ * Arguments accepted by the `reminder-review-assistant` prompt.
+ */
+export interface ReminderReviewAssistantArgs {
+    'Review focus'?: string;
+}
+/**
+ * Arguments accepted by the `weekly-planning-workflow` prompt.
+ */
+export interface WeeklyPlanningWorkflowArgs {
+    'User ideas'?: string;
+}
+/**
+ * Mapped helper type that links prompt names with their argument signatures.
+ */
+export interface PromptArgsByName {
+    'daily-task-organizer': DailyTaskOrganizerArgs;
+    'smart-reminder-creator': SmartReminderCreatorArgs;
+    'reminder-review-assistant': ReminderReviewAssistantArgs;
+    'weekly-planning-workflow': WeeklyPlanningWorkflowArgs;
+}
+/**
+ * Describes an individual prompt template with parsing and builder helpers.
+ */
+export interface PromptTemplate<Name extends PromptName> {
+    metadata: PromptMetadata<Name>;
+    parseArgs(rawArgs: Record<string, unknown> | null | undefined): PromptArgsByName[Name];
+    buildPrompt(args: PromptArgsByName[Name]): PromptResponse;
+}

package/dist/types/prompts.js

@@ -0,0 +1,6 @@
+/**
+ * types/prompts.ts
+ * Type definitions for MCP prompt templates and arguments
+ */
+export {};
+//# sourceMappingURL=prompts.js.map

package/dist/types/prompts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.js","sourceRoot":"","sources":["../../src/types/prompts.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/types/repository.d.ts

@@ -0,0 +1,197 @@
+/**
+ * repository.ts
+ * Shared type definitions for repository layer JSON interfaces and the
+ * abstract contracts the application layer is allowed to depend on.
+ *
+ * Domain layer rule (CLAUDE.md): interfaces are defined in the *consuming*
+ * layer, not the implementation layer. The handlers / orchestration code in
+ * `src/tools/handlers/` are the consumers — these interfaces live here in
+ * `src/types/` so the concrete repositories in `src/utils/` formally
+ * implement them rather than the handlers being coupled to the
+ * implementation.
+ */
+import type { Calendar, CalendarEvent, Reminder, ReminderList } from './index.js';
+/**
+ * Recurrence rule JSON interface as emitted by the `event` CLI
+ */
+export interface RecurrenceRuleJSON {
+    frequency: 'minutely' | 'hourly' | 'daily' | 'weekly' | 'monthly' | 'yearly';
+    interval?: number;
+    endDate?: string | null;
+    occurrenceCount?: number | null;
+    daysOfWeek?: number[] | null;
+    daysOfMonth?: number[] | null;
+    monthsOfYear?: number[] | null;
+}
+/**
+ * Location trigger JSON interface as emitted by the `event` CLI
+ */
+export interface LocationTriggerJSON {
+    title: string;
+    latitude: number;
+    longitude: number;
+    radius?: number;
+    proximity: 'enter' | 'leave' | 'none';
+}
+export interface StructuredLocationJSON {
+    title: string;
+    latitude?: number | null;
+    longitude?: number | null;
+    radius?: number | null;
+}
+export interface AlarmJSON {
+    relativeOffset?: number | null;
+    absoluteDate?: string | null;
+    locationTrigger?: LocationTriggerJSON | null;
+    alarmType?: string | null;
+}
+export interface ParticipantJSON {
+    name?: string | null;
+    url: string;
+    status?: string | null;
+    role?: string | null;
+    type?: string | null;
+    isCurrentUser?: boolean | null;
+}
+/**
+ * JSON interfaces emitted by the `event` CLI
+ */
+export interface ReminderJSON {
+    id: string;
+    title: string;
+    isCompleted: boolean;
+    list: string;
+    notes: string | null;
+    url: string | null;
+    location?: string | null;
+    timeZone?: string | null;
+    dueDate: string | null;
+    startDate?: string | null;
+    completionDate?: string | null;
+    creationDate?: string | null;
+    lastModifiedDate?: string | null;
+    externalId?: string | null;
+    priority: number;
+    alarms?: AlarmJSON[] | null;
+    recurrenceRules?: RecurrenceRuleJSON[] | null;
+    locationTrigger: LocationTriggerJSON | null;
+}
+export interface ListJSON {
+    id: string;
+    title: string;
+    color?: string | null;
+}
+export interface EventJSON {
+    id: string;
+    title: string;
+    calendar: string;
+    startDate: string;
+    endDate: string;
+    notes: string | null;
+    location: string | null;
+    structuredLocation?: StructuredLocationJSON | null;
+    url: string | null;
+    isAllDay: boolean;
+    availability?: string | null;
+    alarms?: AlarmJSON[] | null;
+    recurrenceRules?: RecurrenceRuleJSON[] | null;
+    organizer?: ParticipantJSON | null;
+    attendees?: ParticipantJSON[] | null;
+    status?: string | null;
+    isDetached?: boolean | null;
+    occurrenceDate?: string | null;
+    creationDate?: string | null;
+    lastModifiedDate?: string | null;
+    externalId?: string | null;
+}
+/**
+ * Data interfaces for repository methods
+ */
+/** Fields accepted by `event reminders create`. */
+export interface CreateReminderData {
+    title: string;
+    list?: string;
+    notes?: string;
+    url?: string;
+    dueDate?: string;
+    priority?: number;
+}
+/** Fields accepted by `event reminders update`. */
+export interface UpdateReminderData {
+    id: string;
+    newTitle?: string;
+    notes?: string;
+    url?: string;
+    isCompleted?: boolean;
+    startDate?: string;
+    dueDate?: string;
+    priority?: number;
+}
+/**
+ * Fields accepted by `event calendar create`. All-day events are inferred
+ * from the date format (bare `YYYY-MM-DD` without a time component).
+ */
+export interface CreateEventData {
+    title: string;
+    startDate: string;
+    endDate: string;
+    calendar?: string;
+    notes?: string;
+    location?: string;
+}
+/** Fields accepted by `event calendar update`. */
+export interface UpdateEventData {
+    id: string;
+    title?: string;
+    startDate?: string;
+    endDate?: string;
+    notes?: string;
+    location?: string;
+}
+/**
+ * Reminder repository contract. Implementations are responsible for talking
+ * to the underlying EventKit data store (today: via the Swift CLI). The
+ * application layer depends only on this interface.
+ */
+export interface IReminderRepository {
+    findReminderById(id: string): Promise<Reminder>;
+    findReminders(filters?: {
+        list?: string;
+        showCompleted?: boolean;
+        search?: string;
+        dueWithin?: string;
+        priority?: 'high' | 'medium' | 'low' | 'none';
+        recurring?: boolean;
+        locationBased?: boolean;
+        tags?: string[];
+    }): Promise<Reminder[]>;
+    findAllLists(): Promise<ReminderList[]>;
+    createReminder(data: CreateReminderData): Promise<ReminderJSON>;
+    updateReminder(data: UpdateReminderData): Promise<ReminderJSON>;
+    deleteReminder(id: string): Promise<void>;
+    createReminderList(name: string): Promise<ReminderList>;
+    updateReminderList(currentName: string, newName: string): Promise<ReminderList>;
+    deleteReminderList(name: string): Promise<void>;
+}
+/**
+ * Calendar repository contract. Mirrors `IReminderRepository` for EventKit
+ * calendar/event operations.
+ */
+export interface ICalendarRepository {
+    findEventById(id: string): Promise<CalendarEvent>;
+    findEvents(filters?: {
+        startDate?: string;
+        endDate?: string;
+        calendarName?: string;
+        search?: string;
+        availability?: string;
+    }): Promise<CalendarEvent[]>;
+    findAllCalendars(): Promise<Calendar[]>;
+    findCalendars(filters?: {
+        startDate?: string;
+        endDate?: string;
+    }): Promise<Calendar[]>;
+    createEvent(data: CreateEventData): Promise<EventJSON>;
+    updateEvent(data: UpdateEventData): Promise<EventJSON>;
+    deleteEvent(id: string, span?: 'this-event' | 'future-events'): Promise<void>;
+}

package/dist/types/repository.js

@@ -0,0 +1,14 @@
+/**
+ * repository.ts
+ * Shared type definitions for repository layer JSON interfaces and the
+ * abstract contracts the application layer is allowed to depend on.
+ *
+ * Domain layer rule (CLAUDE.md): interfaces are defined in the *consuming*
+ * layer, not the implementation layer. The handlers / orchestration code in
+ * `src/tools/handlers/` are the consumers — these interfaces live here in
+ * `src/types/` so the concrete repositories in `src/utils/` formally
+ * implement them rather than the handlers being coupled to the
+ * implementation.
+ */
+export {};
+//# sourceMappingURL=repository.js.map

package/dist/types/repository.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"repository.js","sourceRoot":"","sources":["../../src/types/repository.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG"}

package/dist/utils/binaryValidator.d.ts

@@ -0,0 +1,52 @@
+/**
+ * utils/binaryValidator.ts
+ * Secure binary path validation and integrity checking
+ */
+/**
+ * Security configuration for binary validation
+ */
+interface BinarySecurityConfig {
+    expectedHash?: string;
+    maxFileSize: number;
+    allowedPaths: string[];
+    requireAbsolutePath: boolean;
+}
+/**
+ * Binary validation error
+ */
+export declare class BinaryValidationError extends Error {
+    code: string;
+    constructor(message: string, code: string);
+}
+/**
+ * Validates binary path for security
+ */
+export declare function validateBinaryPath(binaryPath: string, config?: Partial<BinarySecurityConfig>): void;
+/**
+ * Calculates SHA256 hash of binary file
+ */
+export declare function calculateBinaryHash(binaryPath: string): string;
+/**
+ * Validates binary integrity using hash
+ */
+export declare function validateBinaryIntegrity(binaryPath: string, expectedHash: string): boolean;
+/**
+ * Comprehensive binary security validation
+ */
+export declare function validateBinarySecurity(binaryPath: string, config?: Partial<BinarySecurityConfig>): {
+    isValid: boolean;
+    hash?: string;
+    errors: string[];
+};
+/**
+ * Secure binary path finder with validation
+ */
+export declare function findSecureBinaryPath(possiblePaths: string[], config?: Partial<BinarySecurityConfig>): {
+    path: string | null;
+    validationResult?: ReturnType<typeof validateBinarySecurity>;
+};
+/**
+ * Environment-specific binary validation
+ */
+export declare function getEnvironmentBinaryConfig(): Partial<BinarySecurityConfig>;
+export {};