@laylzj777/my-apple-apple-eventkit 1.1.0

package/dist/utils/binaryValidator.js

@@ -0,0 +1,185 @@
+/**
+ * utils/binaryValidator.ts
+ * Secure binary path validation and integrity checking
+ */
+import crypto from 'node:crypto';
+import fs from 'node:fs';
+import path from 'node:path';
+/**
+ * Default security configuration.
+ *
+ * Each `allowedPaths` entry is a path suffix that the candidate binary must
+ * match against either its full normalized path or its parent directory.
+ * Suffix matching is segment-aligned so `foo-bin` doesn't partial-match
+ * `bin`. The defaults intentionally do NOT include a bare `bin` entry — that
+ * would pass for any `/<anywhere>/bin/<anything>` (e.g. `/usr/local/bin/curl`).
+ * Production callers pass an absolute path tied to the project root via
+ * configuration (see `src/utils/eventCli.ts`); the defaults below exist for
+ * tests that exercise the suffix matcher.
+ */
+const DEFAULT_CONFIG = {
+    maxFileSize: 50 * 1024 * 1024, // 50MB max
+    allowedPaths: ['dist/swift/bin', 'src/swift/bin', 'swift/bin', 'bin/event'],
+    requireAbsolutePath: true,
+};
+/**
+ * Binary validation error
+ */
+export class BinaryValidationError extends Error {
+    constructor(message, code) {
+        super(message);
+        this.code = code;
+        this.name = 'BinaryValidationError';
+    }
+}
+/**
+ * Validates binary path for security
+ */
+export function validateBinaryPath(binaryPath, config = {}) {
+    const fullConfig = { ...DEFAULT_CONFIG, ...config };
+    if (fullConfig.requireAbsolutePath && !path.isAbsolute(binaryPath)) {
+        throw new BinaryValidationError('Binary path must be absolute', 'INVALID_PATH');
+    }
+    const normalizedPath = path.normalize(binaryPath);
+    // `path.normalize` resolves any embedded `..`, so a surviving `..` segment
+    // would only come from a deliberately malformed input — check segments
+    // rather than substring (`..foo` is a legal filename).
+    const segments = normalizedPath.split(path.sep);
+    if (segments.includes('..')) {
+        throw new BinaryValidationError('Path traversal detected in binary path', 'PATH_TRAVERSAL');
+    }
+    // An entry matches when it is a suffix of either the full binary path
+    // (including its filename, e.g. `bin/event`) or the binary's parent
+    // directory. Suffix matching is segment-aligned — `endsWith('/bin')` after
+    // stripping trailing separators avoids the `foo-bin` partial-match trap
+    // while still working for absolute and relative allowed paths.
+    const parentDir = path.dirname(normalizedPath);
+    const isInAllowedPath = fullConfig.allowedPaths.some((allowedPath) => {
+        const allowedNormalized = path
+            .normalize(allowedPath)
+            .replace(/[\\/]+$/, '');
+        if (!allowedNormalized)
+            return false;
+        const sepSuffix = path.sep + allowedNormalized;
+        return (normalizedPath === allowedNormalized ||
+            normalizedPath.endsWith(sepSuffix) ||
+            parentDir === allowedNormalized ||
+            parentDir.endsWith(sepSuffix));
+    });
+    if (!isInAllowedPath) {
+        throw new BinaryValidationError('Binary path not in allowed directories', 'FORBIDDEN_PATH');
+    }
+    if (!fs.existsSync(normalizedPath)) {
+        throw new BinaryValidationError(`Binary file not found: ${normalizedPath}`, 'FILE_NOT_FOUND');
+    }
+    const stats = fs.statSync(normalizedPath);
+    if (!stats.isFile()) {
+        throw new BinaryValidationError('Binary path does not point to a file', 'NOT_A_FILE');
+    }
+    if (stats.size > fullConfig.maxFileSize) {
+        throw new BinaryValidationError(`Binary file too large: ${stats.size} bytes`, 'FILE_TOO_LARGE');
+    }
+    try {
+        fs.accessSync(normalizedPath, fs.constants.X_OK);
+    }
+    catch (_error) {
+        throw new BinaryValidationError('Binary file is not executable', 'NOT_EXECUTABLE');
+    }
+}
+/**
+ * Calculates SHA256 hash of binary file
+ */
+export function calculateBinaryHash(binaryPath) {
+    try {
+        const fileBuffer = fs.readFileSync(binaryPath);
+        return crypto.createHash('sha256').update(fileBuffer).digest('hex');
+    }
+    catch (error) {
+        throw new BinaryValidationError(`Failed to calculate binary hash: ${error.message}`, 'HASH_CALCULATION_FAILED');
+    }
+}
+/**
+ * Validates binary integrity using hash
+ */
+export function validateBinaryIntegrity(binaryPath, expectedHash) {
+    try {
+        const actualHash = calculateBinaryHash(binaryPath);
+        const isValid = actualHash === expectedHash;
+        return isValid;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Comprehensive binary security validation
+ */
+export function validateBinarySecurity(binaryPath, config = {}) {
+    const errors = [];
+    let hash;
+    try {
+        // Path validation
+        validateBinaryPath(binaryPath, config);
+        // Hashing the multi-MB binary takes 10–30 ms and blocks the event loop;
+        // only do it when the caller will actually compare the result.
+        if (config.expectedHash) {
+            hash = calculateBinaryHash(binaryPath);
+            if (hash !== config.expectedHash) {
+                errors.push('Binary integrity check failed - hash mismatch');
+            }
+        }
+    }
+    catch (error) {
+        if (error instanceof BinaryValidationError) {
+            errors.push(`${error.code}: ${error.message}`);
+        }
+        else {
+            errors.push(`Unexpected validation error: ${error.message}`);
+        }
+    }
+    return {
+        isValid: errors.length === 0,
+        hash,
+        errors,
+    };
+}
+/**
+ * Secure binary path finder with validation
+ */
+export function findSecureBinaryPath(possiblePaths, config = {}) {
+    for (const binaryPath of possiblePaths) {
+        const validationResult = validateBinarySecurity(binaryPath, config);
+        if (validationResult.isValid) {
+            return { path: binaryPath, validationResult };
+        }
+    }
+    return { path: null };
+}
+/**
+ * Environment-specific binary validation
+ */
+export function getEnvironmentBinaryConfig() {
+    if (process.env.NODE_ENV === 'test') {
+        // Relaxed validation for testing
+        return {
+            requireAbsolutePath: false,
+            maxFileSize: 100 * 1024 * 1024, // 100MB for test
+        };
+    }
+    if (process.env.NODE_ENV === 'development') {
+        // Development mode - log more details
+        return {
+            maxFileSize: 100 * 1024 * 1024, // 100MB for dev
+        };
+    }
+    // Production mode - strict validation
+    return {
+        expectedHash: process.env.SWIFT_BINARY_HASH,
+        // The universal bin/event sits at ~51.7MB today; 80MB matches the
+        // published-tarball size-sanity bound and leaves room for vendor bumps
+        // without surfacing as a misleading "binary not found" error.
+        maxFileSize: 80 * 1024 * 1024, // 80MB
+        requireAbsolutePath: true,
+    };
+}
+//# sourceMappingURL=binaryValidator.js.map

package/dist/utils/binaryValidator.js.map

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

package/dist/utils/calendarRepository.d.ts

@@ -0,0 +1,49 @@
+/**
+ * calendarRepository.ts
+ * Repository for calendar event data access via the vendored `event` CLI.
+ *
+ * Read-only fields (URL, structured location, all-day toggle, availability,
+ * alarms, recurrence rules) are passed through from JSON when present;
+ * write paths only cover what `event` exposes today. See
+ * `docs/migration-to-event-cli.md` for the full table.
+ */
+import type { Calendar, CalendarEvent } from '../types/index.js';
+import type { CreateEventData, EventJSON, ICalendarRepository, UpdateEventData } from '../types/repository.js';
+type EventSpan = 'this-event' | 'future-events';
+declare class CalendarRepository implements ICalendarRepository {
+    private listEvents;
+    private listEventsWideWindow;
+    findEventById(id: string): Promise<CalendarEvent>;
+    findEvents(filters?: {
+        startDate?: string;
+        endDate?: string;
+        calendarName?: string;
+        search?: string;
+        availability?: string;
+    }): Promise<CalendarEvent[]>;
+    /**
+     * `event` has no first-class "list calendars" command — calendar names are
+     * surfaced only as the `calendar` field on each event in `calendar list`.
+     * Derive a unique-by-name listing from a wide read window so callers of
+     * `calendar_calendars` see every calendar that contains an event. Calendars
+     * with zero events in the window won't appear; see
+     * `docs/migration-to-event-cli.md` for the workaround.
+     */
+    findAllCalendars(): Promise<Calendar[]>;
+    /**
+     * When a date range is supplied, scope the listing to that window instead
+     * of the default wide window and annotate each calendar with how many
+     * events it contributed — this is the only per-calendar signal `event`
+     * exposes (it has no EventKit account/identifier info to filter or key
+     * on), so counts are grouped by calendar title rather than a stable id.
+     */
+    findCalendars(filters?: {
+        startDate?: string;
+        endDate?: string;
+    }): Promise<Calendar[]>;
+    createEvent(data: CreateEventData): Promise<EventJSON>;
+    updateEvent(data: UpdateEventData): Promise<EventJSON>;
+    deleteEvent(id: string, span?: EventSpan): Promise<void>;
+}
+export declare const calendarRepository: CalendarRepository;
+export { CalendarRepository };

package/dist/utils/calendarRepository.js

@@ -0,0 +1,226 @@
+/**
+ * calendarRepository.ts
+ * Repository for calendar event data access via the vendored `event` CLI.
+ *
+ * Read-only fields (URL, structured location, all-day toggle, availability,
+ * alarms, recurrence rules) are passed through from JSON when present;
+ * write paths only cover what `event` exposes today. See
+ * `docs/migration-to-event-cli.md` for the full table.
+ */
+import { CliUserError } from './errorHandling.js';
+import { executeEventCliJson, executeEventCliPlain } from './eventCli.js';
+import { addOptionalArg, nullToUndefined } from './helpers.js';
+import { parseReminderDueDate } from './reminderDateParser.js';
+const DEFAULT_READ_WINDOW_DAYS = 14;
+/**
+ * When looking up a single event by ID, expand the read window aggressively
+ * so events scheduled years away (e.g. recurring annual reservations) can
+ * still be located without requiring the caller to know the date in advance.
+ * EventKit only supports a maximum 4-year predicate window — bound at
+ * roughly that to stay within Apple's limits.
+ */
+const FIND_BY_ID_WINDOW_DAYS = 365 * 4;
+const formatDateOnly = (date) => {
+    const year = date.getFullYear();
+    const month = String(date.getMonth() + 1).padStart(2, '0');
+    const day = String(date.getDate()).padStart(2, '0');
+    return `${year}-${month}-${day}`;
+};
+const shiftDays = (date, days) => {
+    const shifted = new Date(date);
+    shifted.setDate(shifted.getDate() + days);
+    return shifted;
+};
+// `event calendar list --start/--end` expects bare `yyyy-MM-dd`; trim any
+// time component from caller-supplied dates so the predicate succeeds.
+const toDateOnly = (value) => {
+    const match = value.match(/^(\d{4}-\d{2}-\d{2})/);
+    return match?.[1] ?? value;
+};
+const resolveReadDateRange = (filters) => {
+    const today = new Date();
+    if (filters.startDate && filters.endDate) {
+        return {
+            startDate: toDateOnly(filters.startDate),
+            endDate: toDateOnly(filters.endDate),
+        };
+    }
+    if (!filters.startDate && !filters.endDate) {
+        return {
+            startDate: formatDateOnly(today),
+            endDate: formatDateOnly(shiftDays(today, DEFAULT_READ_WINDOW_DAYS)),
+        };
+    }
+    if (filters.startDate && !filters.endDate) {
+        // `parseReminderDueDate` is the strict parser shared with the reminder
+        // pipeline; it rejects auto-corrected dates like `2025-02-30` that the
+        // native `Date` constructor silently coerces to March 2.
+        const start = parseReminderDueDate(filters.startDate);
+        return {
+            startDate: toDateOnly(filters.startDate),
+            endDate: formatDateOnly(shiftDays(start ?? today, DEFAULT_READ_WINDOW_DAYS)),
+        };
+    }
+    // !filters.startDate && filters.endDate
+    const endStr = filters.endDate;
+    const end = parseReminderDueDate(endStr);
+    return {
+        startDate: formatDateOnly(shiftDays(end ?? today, -DEFAULT_READ_WINDOW_DAYS)),
+        endDate: toDateOnly(endStr),
+    };
+};
+const EVENT_NULLABLE_FIELDS = [
+    'notes',
+    'location',
+    'structuredLocation',
+    'url',
+    'availability',
+    'alarms',
+    'recurrenceRules',
+    'organizer',
+    'attendees',
+    'status',
+    'isDetached',
+    'occurrenceDate',
+    'creationDate',
+    'lastModifiedDate',
+    'externalId',
+];
+const mapEvent = (event) => nullToUndefined(event, EVENT_NULLABLE_FIELDS);
+/**
+ * Maps our schema span values to `event calendar delete --span` strings.
+ * `event` understands "this" (default → `.thisEvent`) and "all"
+ * (→ `.futureEvents`).
+ */
+const mapSpanForEvent = (span) => span === 'this-event' ? 'this' : span === 'future-events' ? 'all' : undefined;
+class CalendarRepository {
+    async listEvents(startDate, endDate, calendarName) {
+        const args = ['calendar', 'list', '--start', startDate, '--end', endDate];
+        addOptionalArg(args, '--calendar', calendarName);
+        args.push('--json');
+        return executeEventCliJson(args);
+    }
+    // `findEventById` and `findAllCalendars` both need a wide read window
+    // because EventKit can't be queried for a single event by id directly via
+    // `event`, and empty calendars don't appear in narrow windows. Centralize
+    // the bounds here so both paths stay in sync.
+    listEventsWideWindow() {
+        const today = new Date();
+        return this.listEvents(formatDateOnly(shiftDays(today, -FIND_BY_ID_WINDOW_DAYS)), formatDateOnly(shiftDays(today, FIND_BY_ID_WINDOW_DAYS)));
+    }
+    async findEventById(id) {
+        const events = await this.listEventsWideWindow();
+        const event = events.find((e) => e.id === id);
+        if (!event) {
+            throw new CliUserError(`Event with ID '${id}' not found.`);
+        }
+        return mapEvent(event);
+    }
+    async findEvents(filters = {}) {
+        const dateRange = resolveReadDateRange({
+            startDate: filters.startDate,
+            endDate: filters.endDate,
+        });
+        const events = await this.listEvents(dateRange.startDate, dateRange.endDate, filters.calendarName);
+        let normalized = events.map(mapEvent);
+        // `event` does not surface `--search`; apply the substring match in TS
+        // against title / notes / location.
+        if (filters.search) {
+            const needle = filters.search.toLowerCase();
+            normalized = normalized.filter((event) => {
+                const haystack = [event.title, event.notes, event.location]
+                    .filter((value) => Boolean(value))
+                    .map((value) => value.toLowerCase());
+                return haystack.some((value) => value.includes(needle));
+            });
+        }
+        if (filters.availability) {
+            normalized = normalized.filter((event) => event.availability === filters.availability);
+        }
+        return normalized;
+    }
+    /**
+     * `event` has no first-class "list calendars" command — calendar names are
+     * surfaced only as the `calendar` field on each event in `calendar list`.
+     * Derive a unique-by-name listing from a wide read window so callers of
+     * `calendar_calendars` see every calendar that contains an event. Calendars
+     * with zero events in the window won't appear; see
+     * `docs/migration-to-event-cli.md` for the workaround.
+     */
+    async findAllCalendars() {
+        const events = await this.listEventsWideWindow();
+        const distinct = new Set();
+        for (const event of events) {
+            if (event.calendar)
+                distinct.add(event.calendar);
+        }
+        return Array.from(distinct)
+            .sort((a, b) => a.localeCompare(b))
+            .map((name) => ({ id: name, title: name }));
+    }
+    /**
+     * When a date range is supplied, scope the listing to that window instead
+     * of the default wide window and annotate each calendar with how many
+     * events it contributed — this is the only per-calendar signal `event`
+     * exposes (it has no EventKit account/identifier info to filter or key
+     * on), so counts are grouped by calendar title rather than a stable id.
+     */
+    async findCalendars(filters = {}) {
+        if (!filters.startDate && !filters.endDate) {
+            return this.findAllCalendars();
+        }
+        const dateRange = resolveReadDateRange({
+            startDate: filters.startDate,
+            endDate: filters.endDate,
+        });
+        const events = await this.listEvents(dateRange.startDate, dateRange.endDate);
+        const eventCountByTitle = new Map();
+        for (const event of events) {
+            if (!event.calendar)
+                continue;
+            eventCountByTitle.set(event.calendar, (eventCountByTitle.get(event.calendar) ?? 0) + 1);
+        }
+        return Array.from(eventCountByTitle.keys())
+            .sort((a, b) => a.localeCompare(b))
+            .map((title) => ({
+            id: title,
+            title,
+            eventCount: eventCountByTitle.get(title) ?? 0,
+        }));
+    }
+    async createEvent(data) {
+        const args = [
+            'calendar',
+            'create',
+            '--title',
+            data.title,
+            '--start',
+            data.startDate,
+            '--end',
+            data.endDate,
+        ];
+        addOptionalArg(args, '--calendar', data.calendar);
+        addOptionalArg(args, '--notes', data.notes);
+        addOptionalArg(args, '--location', data.location);
+        args.push('--json');
+        return executeEventCliJson(args);
+    }
+    async updateEvent(data) {
+        const args = ['calendar', 'update', '--id', data.id];
+        addOptionalArg(args, '--title', data.title);
+        addOptionalArg(args, '--start', data.startDate);
+        addOptionalArg(args, '--end', data.endDate);
+        addOptionalArg(args, '--location', data.location);
+        addOptionalArg(args, '--notes', data.notes);
+        args.push('--json');
+        return executeEventCliJson(args);
+    }
+    async deleteEvent(id, span) {
+        const args = ['calendar', 'delete', '--id', id];
+        addOptionalArg(args, '--span', mapSpanForEvent(span));
+        await executeEventCliPlain(args);
+    }
+}
+export const calendarRepository = new CalendarRepository();
+export { CalendarRepository };
+//# sourceMappingURL=calendarRepository.js.map

package/dist/utils/calendarRepository.js.map

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

package/dist/utils/constants.d.ts

@@ -0,0 +1,79 @@
+/**
+ * constants.ts
+ * Centralized constants and configuration values to eliminate magic numbers
+ */
+/**
+ * File system and path constants
+ */
+export declare const FILE_SYSTEM: {
+    /** Maximum directory traversal depth when searching for project root */
+    readonly MAX_DIRECTORY_SEARCH_DEPTH: 10;
+    /** Package.json filename for project root detection */
+    readonly PACKAGE_JSON_FILENAME: "package.json";
+    /** Swift binary filename — points at the vendored `event` CLI (FradSer/event). */
+    readonly SWIFT_BINARY_NAME: "event";
+    /**
+     * TCC disclaim shim filename — spawns `event` as its own TCC-responsible
+     * process so EventKit permission prompts work from desktop MCP clients
+     * that lack usage-description strings (issue #93).
+     */
+    readonly DISCLAIM_BINARY_NAME: "event-disclaim";
+};
+/**
+ * Validation and security constants
+ */
+export declare const VALIDATION: {
+    /** Maximum lengths for different text fields */
+    readonly MAX_TITLE_LENGTH: 200;
+    readonly MAX_NOTE_LENGTH: 20000;
+    readonly MAX_LIST_NAME_LENGTH: 100;
+    readonly MAX_SEARCH_LENGTH: 100;
+    readonly MAX_URL_LENGTH: 500;
+    readonly MAX_LOCATION_LENGTH: 200;
+};
+/**
+ * Tool names for MCP server operations
+ */
+export declare const TOOLS: {
+    /** Reminder tasks management tool */
+    readonly REMINDERS_TASKS: "reminders_tasks";
+    /** Reminder lists management tool */
+    readonly REMINDERS_LISTS: "reminders_lists";
+    /** Reminder subtasks management tool */
+    readonly REMINDERS_SUBTASKS: "reminders_subtasks";
+    /** Calendar events management tool */
+    readonly CALENDAR_EVENTS: "calendar_events";
+    /** Calendar collections management tool */
+    readonly CALENDAR_CALENDARS: "calendar_calendars";
+};
+/**
+ * Time and date constants for consistent time-based logic
+ */
+export declare const TIME: {
+    /** Working hours boundaries */
+    readonly WORKING_HOURS_START: 9;
+    readonly WORKING_HOURS_END: 18;
+    /** Time of day boundaries for categorization */
+    readonly MORNING_START: 5;
+    readonly NOON: 12;
+    readonly AFTERNOON_END: 17;
+    readonly EVENING_START: 17;
+    readonly NIGHT_START: 21;
+    /** Default time suggestions */
+    readonly LATER_TODAY_HOURS: 4;
+    readonly END_OF_WEEK_HOUR: 17;
+    readonly DEFAULT_MORNING_HOUR: 9;
+    /** Day of week constants (0 = Sunday, 6 = Saturday) */
+    readonly SUNDAY: 0;
+    readonly FRIDAY: 5;
+    readonly SATURDAY: 6;
+};
+/**
+ * Error message templates
+ */
+export declare const MESSAGES: {
+    readonly ERROR: {
+        readonly UNKNOWN_TOOL: (name: string) => string;
+        readonly UNKNOWN_ACTION: (tool: string, action: string) => string;
+    };
+};

package/dist/utils/constants.js

@@ -0,0 +1,80 @@
+/**
+ * constants.ts
+ * Centralized constants and configuration values to eliminate magic numbers
+ */
+/**
+ * File system and path constants
+ */
+export const FILE_SYSTEM = {
+    /** Maximum directory traversal depth when searching for project root */
+    MAX_DIRECTORY_SEARCH_DEPTH: 10,
+    /** Package.json filename for project root detection */
+    PACKAGE_JSON_FILENAME: 'package.json',
+    /** Swift binary filename — points at the vendored `event` CLI (FradSer/event). */
+    SWIFT_BINARY_NAME: 'event',
+    /**
+     * TCC disclaim shim filename — spawns `event` as its own TCC-responsible
+     * process so EventKit permission prompts work from desktop MCP clients
+     * that lack usage-description strings (issue #93).
+     */
+    DISCLAIM_BINARY_NAME: 'event-disclaim',
+};
+/**
+ * Validation and security constants
+ */
+export const VALIDATION = {
+    /** Maximum lengths for different text fields */
+    MAX_TITLE_LENGTH: 200,
+    MAX_NOTE_LENGTH: 20000,
+    MAX_LIST_NAME_LENGTH: 100,
+    MAX_SEARCH_LENGTH: 100,
+    MAX_URL_LENGTH: 500,
+    MAX_LOCATION_LENGTH: 200,
+};
+/**
+ * Tool names for MCP server operations
+ */
+export const TOOLS = {
+    /** Reminder tasks management tool */
+    REMINDERS_TASKS: 'reminders_tasks',
+    /** Reminder lists management tool */
+    REMINDERS_LISTS: 'reminders_lists',
+    /** Reminder subtasks management tool */
+    REMINDERS_SUBTASKS: 'reminders_subtasks',
+    /** Calendar events management tool */
+    CALENDAR_EVENTS: 'calendar_events',
+    /** Calendar collections management tool */
+    CALENDAR_CALENDARS: 'calendar_calendars',
+};
+/**
+ * Time and date constants for consistent time-based logic
+ */
+export const TIME = {
+    /** Working hours boundaries */
+    WORKING_HOURS_START: 9,
+    WORKING_HOURS_END: 18,
+    /** Time of day boundaries for categorization */
+    MORNING_START: 5,
+    NOON: 12,
+    AFTERNOON_END: 17,
+    EVENING_START: 17,
+    NIGHT_START: 21,
+    /** Default time suggestions */
+    LATER_TODAY_HOURS: 4,
+    END_OF_WEEK_HOUR: 17,
+    DEFAULT_MORNING_HOUR: 9,
+    /** Day of week constants (0 = Sunday, 6 = Saturday) */
+    SUNDAY: 0,
+    FRIDAY: 5,
+    SATURDAY: 6,
+};
+/**
+ * Error message templates
+ */
+export const MESSAGES = {
+    ERROR: {
+        UNKNOWN_TOOL: (name) => `Unknown tool: ${name}`,
+        UNKNOWN_ACTION: (tool, action) => `Unknown ${tool} action: ${action}`,
+    },
+};
+//# sourceMappingURL=constants.js.map

package/dist/utils/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/utils/constants.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,wEAAwE;IACxE,0BAA0B,EAAE,EAAE;IAE9B,uDAAuD;IACvD,qBAAqB,EAAE,cAAc;IAErC,kFAAkF;IAClF,iBAAiB,EAAE,OAAO;IAE1B;;;;OAIG;IACH,oBAAoB,EAAE,gBAAgB;CAC9B,CAAC;AAEX;;GAEG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,gDAAgD;IAChD,gBAAgB,EAAE,GAAG;IACrB,eAAe,EAAE,KAAK;IACtB,oBAAoB,EAAE,GAAG;IACzB,iBAAiB,EAAE,GAAG;IACtB,cAAc,EAAE,GAAG;IACnB,mBAAmB,EAAE,GAAG;CAChB,CAAC;AAEX;;GAEG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG;IACnB,qCAAqC;IACrC,eAAe,EAAE,iBAAiB;IAClC,qCAAqC;IACrC,eAAe,EAAE,iBAAiB;IAClC,wCAAwC;IACxC,kBAAkB,EAAE,oBAAoB;IACxC,sCAAsC;IACtC,eAAe,EAAE,iBAAiB;IAClC,2CAA2C;IAC3C,kBAAkB,EAAE,oBAAoB;CAChC,CAAC;AAEX;;GAEG;AACH,MAAM,CAAC,MAAM,IAAI,GAAG;IAClB,+BAA+B;IAC/B,mBAAmB,EAAE,CAAC;IACtB,iBAAiB,EAAE,EAAE;IAErB,gDAAgD;IAChD,aAAa,EAAE,CAAC;IAChB,IAAI,EAAE,EAAE;IACR,aAAa,EAAE,EAAE;IACjB,aAAa,EAAE,EAAE;IACjB,WAAW,EAAE,EAAE;IAEf,+BAA+B;IAC/B,iBAAiB,EAAE,CAAC;IACpB,gBAAgB,EAAE,EAAE;IACpB,oBAAoB,EAAE,CAAC;IAEvB,uDAAuD;IACvD,MAAM,EAAE,CAAC;IACT,MAAM,EAAE,CAAC;IACT,QAAQ,EAAE,CAAC;CACH,CAAC;AAEX;;GAEG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,KAAK,EAAE;QACL,YAAY,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,iBAAiB,IAAI,EAAE;QACvD,cAAc,EAAE,CAAC,IAAY,EAAE,MAAc,EAAE,EAAE,CAC/C,WAAW,IAAI,YAAY,MAAM,EAAE;KACtC;CACO,CAAC"}