@mgcrea/mcp-apple-calendar 0.0.0-bootstrap → 1.3.0

package/dist/cli.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { A as BUILD_INFO, C as CALENDAR_SURFACE, a as loadConfig, r as createServer } from "./server-B2HtiXLF.js";
+import { A as BUILD_INFO, C as CALENDAR_SURFACE, a as loadConfig, r as createServer } from "./server-ai6cmDj4.js";
 import { runStdioServer } from "@mgcrea/mcp-apple-core";
 //#region src/cli.ts
 const LOG_PREFIX = "apple-calendar-mcp";

package/dist/index.d.ts

@@ -175,6 +175,7 @@ declare const openStore: (path: string | null, mode: ReadOnlyMode, logger?: Logg
  */
 declare const ConfigSchema: z.ZodObject<{
   allowWrites: z.ZodDefault<z.ZodBoolean>;
+  exposePrompts: z.ZodDefault<z.ZodBoolean>;
   debug: z.ZodDefault<z.ZodBoolean>;
   osascriptPath: z.ZodDefault<z.ZodString>;
   osascriptTimeoutMs: z.ZodDefault<z.ZodNumber>;
@@ -191,6 +192,17 @@ declare const ConfigSchema: z.ZodObject<{
   defaultCalendar: z.ZodOptional<z.ZodString>;
   defaultRangeDays: z.ZodDefault<z.ZodNumber>;
   maxRangeDays: z.ZodDefault<z.ZodNumber>;
+  workdayStart: z.ZodDefault<z.ZodString>;
+  workdayEnd: z.ZodDefault<z.ZodString>;
+  workdays: z.ZodDefault<z.ZodArray<z.ZodEnum<{
+    fri: "fri";
+    mon: "mon";
+    sat: "sat";
+    sun: "sun";
+    thu: "thu";
+    tue: "tue";
+    wed: "wed";
+  }>>>;
   defaultEventDurationMinutes: z.ZodDefault<z.ZodNumber>;
   includeDeclined: z.ZodDefault<z.ZodBoolean>;
   includeCancelled: z.ZodDefault<z.ZodBoolean>;
@@ -203,6 +215,10 @@ type Config = z.infer<typeof ConfigSchema>;
  */
 declare const loadConfig: (env?: NodeJS.ProcessEnv) => Config;
 //#endregion
+//#region src/client/availability.d.ts
+declare const WEEKDAY_KEYS: readonly ["sun", "mon", "tue", "wed", "thu", "fri", "sat"];
+type WeekdayKey = (typeof WEEKDAY_KEYS)[number];
+//#endregion
 //#region src/client/dates.d.ts
 /**
  * What a tool reports for an event's start or end.
@@ -374,6 +390,97 @@ type EventFilters = {
   includeCancelled?: boolean | undefined;
   limit: number;
 };
+/**
+ * A window of time nothing is on the calendar, long enough to hold the meeting
+ * that was asked for.
+ */
+type FreeSlot = {
+  /** Local wall clock with its offset, ready to hand back to create_event. */
+  start: string;
+  end: string;
+  /** The local day it falls on, so a caller can group without re-parsing. */
+  day: string;
+  /** How long the whole gap is — usually longer than the duration requested. */
+  minutes: number;
+};
+type AvailabilityFilters = {
+  from?: string | undefined;
+  to?: string | undefined;
+  durationMinutes: number;
+  calendar?: string | undefined;
+  dayStart: string;
+  dayEnd: string;
+  weekdays?: readonly WeekdayKey[] | undefined;
+  granularityMinutes: number;
+  /** Let an all-day event block its whole day. Off by default — see below. */
+  allDayBusy: boolean;
+  /** Trust `CalendarItem.availability`. Off by default — the mapping is inferred. */
+  respectFreeMarking: boolean;
+  includeDeclined?: boolean | undefined;
+  includeCancelled?: boolean | undefined;
+  limit: number;
+};
+/**
+ * Why an availability answer was withheld.
+ *
+ * A separate shape from an empty `slots` array on purpose, and the distinction
+ * is the whole point of the tool: "nothing is free" and "I cannot see enough of
+ * the calendar to say" look identical to a model unless one of them says so.
+ */
+type AvailabilityRefusal = {
+  degraded: true;
+  capability: string;
+  reason: string;
+  hint: string;
+};
+type AvailabilityResult = {
+  slots: FreeSlot[];
+  durationMinutes: number;
+  window: {
+    from: string;
+    to: string;
+    clamped: boolean;
+    /** True when the start was pulled forward to now, dropping time already past. */
+    startedAtNow: boolean;
+  };
+  workingHours: {
+    dayStart: string;
+    dayEnd: string;
+    weekdays: readonly WeekdayKey[];
+    granularityMinutes: number;
+    /** The zone the working hours were read in — always this machine's. */
+    timeZone: string;
+  };
+  busy: {
+    /** Events that blocked time, after every filter. */
+    blocking: number;
+    /** Contiguous busy intervals they collapsed into. */
+    intervals: number;
+  };
+  /**
+   * All-day events overlapping the window, reported whether or not they were
+   * applied. See `allDayBusy` on the tool for why this is not a default.
+   */
+  allDayEvents: {
+    day: string;
+    summary: string | null;
+    calendar: string | null;
+  }[];
+  expansion: ExpansionState;
+  coverage: {
+    from: string;
+    to: string;
+    rows: number;
+  } | null;
+  /** Set when the window was cut back to what the expansion actually covers. */
+  truncated?: {
+    reason: string;
+    requestedTo?: string;
+    requestedFrom?: string;
+  };
+  /** Set when the window survived every check but held no time at all. */
+  note?: string;
+};
 type CreateClientOptions = {
   config: Config;
   logger?: Logger;
@@ -450,6 +557,32 @@ declare class AppleCalendarClient {
     query: string;
     scope?: "summary" | "full" | undefined;
   }): EventPage;
+  /**
+   * When nothing is on the calendar, for long enough to hold a meeting.
+   *
+   * ## Why this is not list_events with arithmetic bolted on
+   *
+   * Every other read here returns what it found and flags what it missed, and
+   * a caller reads the flag or does not. This one INVERTS the events: what it
+   * returns is the complement of what it read, so anything the read missed
+   * comes back as free time. A page limit, an unexpanded weekly meeting, an
+   * event past the coverage edge — each of those shortens a `list_events`
+   * result harmlessly and each of them, here, invents a slot that is already
+   * booked. `docs/calendar.md` names the failure directly: "a short list of
+   * events is indistinguishable from a free afternoon."
+   *
+   * So the busy set is either complete or the answer is withheld. Three checks
+   * enforce that, and each returns a refusal rather than a short list:
+   *
+   *   1. the scan bound, so a saturated leg never passes for a quiet week
+   *   2. the expansion, because an unexpanded series is invisible on every
+   *      date but one
+   *   3. the coverage edge, past which repeating events simply are not there
+   *
+   * The third clips the window rather than refusing outright, because the part
+   * inside the edge is genuinely answerable — but it says what it cut.
+   */
+  findAvailability(args: AvailabilityFilters): AvailabilityResult | AvailabilityRefusal;
   getEvent(ref: string): EventDetail;
   calendars(): IndexCalendar[];
   accounts(): IndexAccount[];

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../src/build-info.ts","../src/client/store.ts","../src/config.ts","../src/client/dates.ts","../src/client/locate.ts","../src/client/recurrence.ts","../src/client/calendar.ts","../src/client/errors.ts","../src/client/ref.ts","../src/server.ts","../src/tools/index.ts"],"mappings":"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"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/build-info.ts","../src/client/store.ts","../src/config.ts","../src/client/availability.ts","../src/client/dates.ts","../src/client/locate.ts","../src/client/recurrence.ts","../src/client/calendar.ts","../src/client/errors.ts","../src/client/ref.ts","../src/server.ts","../src/tools/index.ts"],"mappings":"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"}

package/dist/index.js

@@ -1,2 +1,2 @@
-import { A as BUILD_INFO, C as CALENDAR_SURFACE, D as CalendarNotWritableError, E as CalendarNotRunningError, O as EventNotFoundError, S as CALENDAR_BUNDLE_ID, T as CalendarNotFoundError, _ as STORE_FILENAME, a as loadConfig, b as locateStore, c as introspect, d as decodeRef, f as encodeRef, g as GROUP_CONTAINER, h as EXTRAS_FILENAME, i as registerTools, k as InvalidDateError, l as openStore, m as uuidOf, n as SERVER_VERSION, o as AppleCalendarClient, p as seriesRefOf, r as createServer, s as CalendarStore, t as SERVER_NAME, u as REF_VERSION, v as defaultContainerPath, w as CalendarBusyError, x as AppleCalendarError, y as defaultStorePath } from "./server-B2HtiXLF.js";
+import { A as BUILD_INFO, C as CALENDAR_SURFACE, D as CalendarNotWritableError, E as CalendarNotRunningError, O as EventNotFoundError, S as CALENDAR_BUNDLE_ID, T as CalendarNotFoundError, _ as STORE_FILENAME, a as loadConfig, b as locateStore, c as introspect, d as decodeRef, f as encodeRef, g as GROUP_CONTAINER, h as EXTRAS_FILENAME, i as registerTools, k as InvalidDateError, l as openStore, m as uuidOf, n as SERVER_VERSION, o as AppleCalendarClient, p as seriesRefOf, r as createServer, s as CalendarStore, t as SERVER_NAME, u as REF_VERSION, v as defaultContainerPath, w as CalendarBusyError, x as AppleCalendarError, y as defaultStorePath } from "./server-ai6cmDj4.js";
 export { AppleCalendarClient, AppleCalendarError, BUILD_INFO, CALENDAR_BUNDLE_ID, CALENDAR_SURFACE, CalendarBusyError, CalendarNotFoundError, CalendarNotRunningError, CalendarNotWritableError, CalendarStore, EXTRAS_FILENAME, EventNotFoundError, GROUP_CONTAINER, InvalidDateError, REF_VERSION, SERVER_NAME, SERVER_VERSION, STORE_FILENAME, createServer, decodeRef, defaultContainerPath, defaultStorePath, encodeRef, introspect, loadConfig, locateStore, openStore, registerTools, seriesRefOf, uuidOf };