@protocoltooling/fullcalendar 0.2.0 → 0.3.0

package/README.md

@@ -1,35 +1,25 @@
 # FullCalendar WebMCP
 
-**FullCalendar WebMCP** is published by **Protocol Tooling**.
+Add WebMCP calendar tools to an existing FullCalendar React application. Keep your backend, database, and FullCalendar setup.
 
-It exposes standard WebMCP calendar tools (`calendar_get_context`, `calendar_list_events`, `calendar_get_event`, `calendar_create_event`, `calendar_update_event`, `calendar_delete_event`) over existing FullCalendar React instances and host persistence without altering the application's UI, mutation workflows, or database architecture.
-
-## Installation
+Protocol Tooling is an **adapter layer** — it registers browser WebMCP tools and routes agent reads and writes through your `CalendarEventRepository`. It does not authenticate users, store events, or authorize mutations. Your backend remains authoritative.
 
 ```bash
 npm install @protocoltooling/fullcalendar
 ```
 
-### Local / Tarball Installation (Development)
+## Minimal integration
 
-```bash
-npm pack
-npm install /path/to/protocoltooling-fullcalendar-0.2.0.tgz
+```tsx
+useFullCalendarWebMCP({
+  calendarRef,
+  events: repository, // list / get / create / update / delete
+  onEventsChanged: refreshEvents,
+});
 ```
 
-### Peer Dependencies
-
-Ensure host peer dependencies are installed:
-
-- `react`: `>=17 <20`
-- `@fullcalendar/react`: `^6.0.0 || ^7.0.0`
-
----
-
-## Minimal Integration
-
 ```tsx
-import FullCalendar from "@fullcalendar/react"; // v6 or v7
+import FullCalendar from "@fullcalendar/react";
 import { useCallback, useRef, useState } from "react";
 import {
   useFullCalendarWebMCP,
@@ -37,123 +27,91 @@ import {
   type CalendarEventRepository,
 } from "@protocoltooling/fullcalendar";
 
+const repository: CalendarEventRepository = {
+  /* wire to your API */
+};
+
 export function MyCalendar() {
   const calendarRef = useRef<FullCalendar>(null);
   const [events, setEvents] = useState<CalendarEvent[]>([]);
 
-  const reloadEvents = useCallback(async () => {
-    const data = await eventRepository.list();
-    setEvents(data);
-    return data;
+  const refreshEvents = useCallback(async () => {
+    setEvents(await repository.list());
   }, []);
 
   useFullCalendarWebMCP({
     calendarRef,
-    events: eventRepository,
-    onEventsChanged: reloadEvents,
+    events: repository,
+    onEventsChanged: refreshEvents,
   });
 
   return (
     <FullCalendar
       ref={calendarRef}
-      events={events}
-      /* ... other FullCalendar options */
+      events={events.map((event) => ({
+        ...event,
+        end: event.end ?? undefined,
+      }))}
     />
   );
 }
 ```
 
----
-
-## Repository Contract
+## WebMCP tools
 
-The host provides an object implementing `CalendarEventRepository` mapped to its existing database or API:
+Six tools agents can call:
 
-```ts
-import type {
-  CalendarEvent,
-  CalendarEventQuery,
-  CalendarEventRepository,
-  CreateCalendarEventInput,
-  UpdateCalendarEventInput,
-} from "@protocoltooling/fullcalendar";
-
-export const eventRepository: CalendarEventRepository = {
-  async list(query?: CalendarEventQuery, options?: { signal?: AbortSignal }): Promise<CalendarEvent[]> {
-    return api.events.list(query, options);
-  },
-  async get(id: string, options?: { signal?: AbortSignal }): Promise<CalendarEvent | null> {
-    return api.events.get(id, options);
-  },
-  async create(input: CreateCalendarEventInput, options?: { signal?: AbortSignal }): Promise<CalendarEvent> {
-    return api.events.create(input, options);
-  },
-  async update(id: string, input: UpdateCalendarEventInput, options?: { signal?: AbortSignal }): Promise<CalendarEvent> {
-    return api.events.update(id, input, options);
-  },
-  async delete(id: string, options?: { signal?: AbortSignal }): Promise<void> {
-    return api.events.delete(id, options);
-  },
-};
-```
+| Tool | Purpose |
+|---|---|
+| `calendar_get_context` | Anchor relative dates; read viewport/timezones |
+| `calendar_list_events` | Search/discover persisted events |
+| `calendar_get_event` | Fetch one event by stable id |
+| `calendar_create_event` | Create a persisted event |
+| `calendar_update_event` | Partial update of one event |
+| `calendar_delete_event` | Permanently delete one event |
 
----
+Tools return **structured domain state** (events, ids, time context) — not conversational messages. The consuming agent phrases results for the user.
 
-## Persistence Model
+Optional `capabilities` limits which tools register (defense in depth; not a substitute for server-side authorization).
 
-> **FullCalendar WebMCP does not persist calendar events itself. The host application's persistence remains authoritative.**
+## Documentation
 
-Agent mutations and human interactions (e.g. dragging, resizing, modal editing) converge on the host application's authoritative persistence. The integration maintains no secondary event ledger.
+Full docs: [protocoltooling.com/integrations/fullcalendar](https://protocoltooling.com/integrations/fullcalendar)
 
----
+- [Quickstart](https://protocoltooling.com/integrations/fullcalendar/quickstart)
+- [Security model](https://protocoltooling.com/integrations/fullcalendar/concepts/security)
+- [Agent workflows](https://protocoltooling.com/integrations/fullcalendar/concepts/agent-tools)
+- [WebMCP tools reference](https://protocoltooling.com/integrations/fullcalendar/concepts/webmcp)
 
-## Supported Architecture
+## Peer dependencies
 
-- **React:** React 17, 18, and 19.
-- **FullCalendar React:** FullCalendar React v6 class instances (`RefObject<FullCalendar | null>`) and FullCalendar React v7 handles (`RefObject<CalendarRef | null>`).
-- **Runtime:** WebMCP runtime required for tool registration (`document.modelContext.registerTool`).
-- **Framework Agnostic:** Compatible with Next.js (App Router & Pages Router), Vite, Remix / React Router, TanStack Start, or pure client SPAs.
-- **Backend Agnostic:** Works with Server Actions, REST, GraphQL, Supabase / PostgreSQL, ORMs, or custom APIs.
-
----
+- `react`: `>=17 <20`
+- `@fullcalendar/react`: `^6.0.0 || ^7.0.0`
 
-## Server-Side Rendering (SSR) & Lifecycle
+## Persistence and metadata
 
-- **SSR-Safe:** The package contains no top-level browser global (`window`, `document`) access. Server rendering completes without error.
-- **Client Lifecycle:** Tool registration occurs inside `useEffect` via an `AbortController`. React Strict Mode replay and unmount cleanup properly unregister tools with zero orphaned state.
-- **Delayed Runtime:** Automatically waits for late-injected WebMCP runtime if not immediately present at mount time.
-- **React Server Components (RSC):** The package entry includes the `'use client';` directive for seamless import into Next.js App Router client components.
+Your repository is authoritative. FullCalendar WebMCP does not store events.
 
----
+Optional `metadata` on `CalendarEvent` is host-selected, JSON-safe, and read-only through WebMCP writes. FullCalendar `extendedProps` are never exposed automatically.
 
 ## Package migration
 
-Previous package: `protocoltooling`  
-Current package: `@protocoltooling/fullcalendar`  
-The old package is deprecated.
+Previous package: `protocoltooling` (deprecated)  
+Current package: `@protocoltooling/fullcalendar`
 
----
-
-## Development & Verification
+## Development
 
 ```bash
-# Build library package (dist/index.js, dist/index.d.ts)
 npm run build:lib
-
-# Run unit, integration, public type, and SSR tests
 npm test
-
-# Run typecheck & linter
 npm run typecheck
 npm run lint
-
-# Build package tarball and test in external Vite and Next.js consumers
 npm run test:pack
-
-# Run interactive dev example
-npm run dev
+npm run docs:dev
 ```
 
+Local example: `npm run dev` (Vite demo in `example/`).
+
 ## License
 
 MIT

package/dist/index.d.ts

@@ -96,6 +96,27 @@ interface FullCalendarHandle {
         };
     };
 }
+/**
+ * Controls which WebMCP calendar tools are registered at runtime.
+ *
+ * Disabled capabilities omit the corresponding tools entirely — they are not
+ * registered and cannot be discovered or invoked. This is defense in depth /
+ * least-privilege exposure only; the host repository and backend remain
+ * authoritative for authorization.
+ *
+ * `calendar_get_context` is always registered regardless of `read`, because it
+ * exposes viewport/timezone context rather than persisted event records.
+ */
+interface FullCalendarWebMCPCapabilities {
+    /** Register `calendar_list_events` and `calendar_get_event`. Default: true. */
+    read?: boolean;
+    /** Register `calendar_create_event`. Default: true. */
+    create?: boolean;
+    /** Register `calendar_update_event`. Default: true. */
+    update?: boolean;
+    /** Register `calendar_delete_event`. Default: true. */
+    delete?: boolean;
+}
 /**
  * Options for the useFullCalendarWebMCP hook.
  */
@@ -103,6 +124,11 @@ interface FullCalendarWebMCPOptions {
     calendarRef: RefObject<FullCalendarHandle | null>;
     events: CalendarEventRepository;
     onEventsChanged: () => unknown | Promise<unknown>;
+    /**
+     * Optional least-privilege tool exposure. Omitted fields default to enabled.
+     * Does not replace server-side authorization in the host repository/backend.
+     */
+    capabilities?: FullCalendarWebMCPCapabilities;
     onRegistrationError?: (error: unknown) => void;
 }
 
@@ -114,4 +140,4 @@ interface FullCalendarWebMCPOptions {
  */
 declare function useFullCalendarWebMCP(options: FullCalendarWebMCPOptions): void;
 
-export { type CalendarEvent, type CalendarEventQuery, type CalendarEventRepository, type CreateCalendarEventInput, type FullCalendarHandle, type FullCalendarWebMCPOptions, type JsonObject, type JsonPrimitive, type JsonValue, type UpdateCalendarEventInput, useFullCalendarWebMCP };
+export { type CalendarEvent, type CalendarEventQuery, type CalendarEventRepository, type CreateCalendarEventInput, type FullCalendarHandle, type FullCalendarWebMCPCapabilities, type FullCalendarWebMCPOptions, type JsonObject, type JsonPrimitive, type JsonValue, type UpdateCalendarEventInput, useFullCalendarWebMCP };

package/dist/index.js

@@ -9,44 +9,96 @@ var emptySchema = {
   properties: {},
   additionalProperties: false
 };
-var eventProperties = {
-  title: {
-    type: "string",
-    minLength: 1,
-    description: "The human-readable event title."
-  },
-  start: {
-    type: "string",
-    format: "date-time",
-    description: "Inclusive event start as ISO 8601 with an explicit offset."
-  },
-  end: {
-    type: ["string", "null"],
-    format: "date-time",
-    description: "Exclusive event end as ISO 8601 with an explicit offset, or null."
-  },
-  allDay: {
-    type: "boolean",
-    description: "Whether the event is an all-day event."
-  }
+var stableEventIdProperty = {
+  type: "string",
+  minLength: 1,
+  description: "Stable id of the persisted event. Obtain from calendar_list_events, calendar_get_event, or a prior create/update result. Never substitute an event title."
 };
-function readAnnotations() {
-  return { readOnlyHint: true, untrustedContentHint: true };
-}
-function writeAnnotations() {
-  return { readOnlyHint: false, untrustedContentHint: true };
+var queryStartProperty = {
+  type: "string",
+  format: "date-time",
+  description: "Inclusive lower bound for filtering persisted events (ISO 8601 date-time with explicit offset). Omit to include events from any earlier time."
+};
+var queryEndProperty = {
+  type: "string",
+  format: "date-time",
+  description: "Exclusive upper bound for filtering persisted events (ISO 8601 date-time with explicit offset). For one calendar day, set end to the start of the following day. Omit for no upper limit."
+};
+var queryTextProperty = {
+  type: "string",
+  description: "Case-insensitive substring matched against event titles. Omit to skip title filtering."
+};
+var createEventTitleProperty = {
+  type: "string",
+  minLength: 1,
+  description: "Display title for the new event."
+};
+var updateEventTitleProperty = {
+  type: "string",
+  minLength: 1,
+  description: "New display title. Omit to leave the current title unchanged."
+};
+var createEventStartProperty = {
+  type: "string",
+  format: "date-time",
+  description: "Inclusive event start as ISO 8601 date-time with an explicit offset (e.g. 2026-09-02T14:00:00-06:00). Resolve relative times with calendar_get_context first."
+};
+var updateEventStartProperty = {
+  type: "string",
+  format: "date-time",
+  description: "New inclusive event start (ISO 8601 with explicit offset). Omit to leave the current start unchanged."
+};
+var createEventEndProperty = {
+  type: ["string", "null"],
+  format: "date-time",
+  description: "Exclusive event end as ISO 8601 date-time with explicit offset, or null for open-ended. Omit on create to use host defaults."
+};
+var updateEventEndProperty = {
+  type: ["string", "null"],
+  format: "date-time",
+  description: "New exclusive event end (ISO 8601 with explicit offset) or null. Omit to leave the current end unchanged."
+};
+var createAllDayProperty = {
+  type: "boolean",
+  description: "Whether the event spans full calendar days without clock times. Defaults to false when omitted."
+};
+var updateAllDayProperty = {
+  type: "boolean",
+  description: "Whether the event is all-day. Omit to leave unchanged."
+};
+var contextAnnotations = { readOnlyHint: true };
+var eventReadAnnotations = {
+  readOnlyHint: true,
+  untrustedContentHint: true
+};
+var eventWriteAnnotations = {
+  readOnlyHint: false,
+  untrustedContentHint: true
+};
+var deleteAnnotations = { readOnlyHint: false };
+function resolveCapabilities(capabilities) {
+  return {
+    read: capabilities?.read ?? true,
+    create: capabilities?.create ?? true,
+    update: capabilities?.update ?? true,
+    delete: capabilities?.delete ?? true
+  };
 }
 function executionSignal(executeOptions) {
   return executeOptions?.signal;
 }
+function cloneEvent(event) {
+  return JSON.parse(JSON.stringify(event));
+}
 function createCalendarTools(readOptions) {
-  return [
+  const capabilities = resolveCapabilities(readOptions().capabilities);
+  const tools = [
     {
       name: "calendar_get_context",
       title: "Get calendar context",
-      description: "Get the current time, resolved browser timezone, FullCalendar timezone, visible date range, and active view. Call this before interpreting relative dates such as Wednesday or tomorrow.",
+      description: "Read-only temporal and viewport context for the open calendar \u2014 not persisted events. Use when the user mentions relative times (today, tomorrow, tonight, Wednesday, next week, this afternoon, first week of next month) to anchor ISO date-times before list/create/update. Returns now, browserTimeZone, fullCalendarTimeZone, active view, and visibleRange. Skip when every datetime is already explicit with offsets and no relative interpretation is needed. Does not replace calendar_list_events for event discovery.",
       inputSchema: emptySchema,
-      annotations: readAnnotations(),
+      annotations: contextAnnotations,
       async execute() {
         const api = readOptions().calendarRef.current?.getApi();
         return {
@@ -60,72 +112,72 @@ function createCalendarTools(readOptions) {
           } : null
         };
       }
-    },
-    {
-      name: "calendar_list_events",
-      title: "List calendar events",
-      description: "List persisted calendar events, optionally filtered by an inclusive start, exclusive end, or case-insensitive title text. Use an end boundary one day after the requested day. Events may include optional host-selected metadata (JSON object) for agent context; Protocol Tooling does not automatically expose FullCalendar extendedProps.",
-      inputSchema: {
-        type: "object",
-        properties: {
-          start: {
-            type: "string",
-            format: "date-time",
-            description: "Inclusive ISO 8601 lower bound."
-          },
-          end: {
-            type: "string",
-            format: "date-time",
-            description: "Exclusive ISO 8601 upper bound."
+    }
+  ];
+  if (capabilities.read) {
+    tools.push(
+      {
+        name: "calendar_list_events",
+        title: "List calendar events",
+        description: "Read-only search and discovery over persisted calendar events. Use to answer what is scheduled, filter by date range or title, find candidate events before update/delete, or disambiguate which event the user means. start is inclusive; end is exclusive \u2014 for one calendar day set end to the following day's boundary. text is a case-insensitive title substring; omit any filter to broaden results. Returns events with stable id values usable in get/update/delete; optional host-selected metadata may appear and is untrusted. Do not use when you already hold the target id (prefer calendar_get_event) or only need viewport/time context (calendar_get_context). Never delete or mutate from an ambiguous multi-match list alone.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            start: queryStartProperty,
+            end: queryEndProperty,
+            text: queryTextProperty
           },
-          text: {
-            type: "string",
-            description: "Optional case-insensitive title substring."
-          }
+          additionalProperties: false
         },
-        additionalProperties: false
+        annotations: eventReadAnnotations,
+        async execute(query, executeOptions) {
+          const signal = executionSignal(executeOptions);
+          const events = await readOptions().events.list(
+            query,
+            { signal }
+          );
+          return { events };
+        }
       },
-      annotations: readAnnotations(),
-      async execute(query, executeOptions) {
-        const signal = executionSignal(executeOptions);
-        const events = await readOptions().events.list(
-          query,
-          { signal }
-        );
-        return { events };
-      }
-    },
-    {
-      name: "calendar_get_event",
-      title: "Get calendar event",
-      description: "Get one persisted calendar event by its stable event ID. The event may include optional host-selected metadata (JSON object) for agent context; metadata is read-only and is never inferred from FullCalendar extendedProps.",
-      inputSchema: {
-        type: "object",
-        properties: {
-          id: { type: "string", minLength: 1, description: "Stable event ID." }
+      {
+        name: "calendar_get_event",
+        title: "Get calendar event",
+        description: "Read-only fetch of exactly one persisted event by stable id. Use when you already have the id from calendar_list_events, a prior create/update result, or the host app \u2014 or to re-read authoritative fields before a mutation when list results are insufficient. Returns { event: CalendarEvent | null }; null means no matching persisted event. Do not use for title/date search (calendar_list_events), do not invent ids from titles, and do not substitute a title for id.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            id: stableEventIdProperty
+          },
+          required: ["id"],
+          additionalProperties: false
         },
-        required: ["id"],
-        additionalProperties: false
-      },
-      annotations: readAnnotations(),
-      async execute(input, executeOptions) {
-        const { id } = input;
-        const signal = executionSignal(executeOptions);
-        const event = await readOptions().events.get(id, { signal });
-        return { event };
+        annotations: eventReadAnnotations,
+        async execute(input, executeOptions) {
+          const { id } = input;
+          const signal = executionSignal(executeOptions);
+          const event = await readOptions().events.get(id, { signal });
+          return { event };
+        }
       }
-    },
-    {
+    );
+  }
+  if (capabilities.create) {
+    tools.push({
       name: "calendar_create_event",
       title: "Create calendar event",
-      description: "Create and persist a generic calendar event. Times must be ISO 8601 values with explicit offsets. Returns the host-assigned stable event ID. Metadata cannot be supplied on create; only title, start, end, and allDay are accepted.",
+      description: "Create and persist a new calendar event (state mutation). Use only for brand-new events the user wants scheduled. Requires title and start (ISO 8601 with explicit offset); optional end (exclusive, ISO 8601 or null) and allDay. Resolve relative times via calendar_get_context first. Returns the persisted event including host-assigned id. Metadata cannot be supplied. Do not use to modify, reschedule, or rename an existing event \u2014 use calendar_update_event.",
       inputSchema: {
         type: "object",
-        properties: eventProperties,
+        properties: {
+          title: createEventTitleProperty,
+          start: createEventStartProperty,
+          end: createEventEndProperty,
+          allDay: createAllDayProperty
+        },
         required: ["title", "start"],
         additionalProperties: false
       },
-      annotations: writeAnnotations(),
+      annotations: eventWriteAnnotations,
       async execute(rawInput, executeOptions) {
         const input = rawInput;
         const signal = executionSignal(executeOptions);
@@ -134,22 +186,27 @@ function createCalendarTools(readOptions) {
         await options.onEventsChanged();
         return { event };
       }
-    },
-    {
+    });
+  }
+  if (capabilities.update) {
+    tools.push({
       name: "calendar_update_event",
       title: "Update calendar event",
-      description: "Update selected fields on one persisted calendar event using its stable event ID. Omitted fields remain unchanged. Metadata cannot be supplied on update; only title, start, end, and allDay may be changed. Host-owned metadata is preserved by the repository.",
+      description: "Persisted partial update of exactly one existing event (state mutation). Requires stable id plus at least one of title, start, end, allDay; omitted fields stay unchanged. Host-selected metadata is preserved and cannot be written here. When the user names an event without an id, find it with calendar_list_events first; calendar_get_event is optional if the list row already has sufficient detail. Use for reschedule, rename, time/end changes, or all-day toggles \u2014 not for creating a duplicate or deleting (calendar_create_event / calendar_delete_event).",
       inputSchema: {
         type: "object",
         properties: {
-          id: { type: "string", minLength: 1, description: "Stable event ID." },
-          ...eventProperties
+          id: stableEventIdProperty,
+          title: updateEventTitleProperty,
+          start: updateEventStartProperty,
+          end: updateEventEndProperty,
+          allDay: updateAllDayProperty
         },
         required: ["id"],
         minProperties: 2,
         additionalProperties: false
       },
-      annotations: writeAnnotations(),
+      annotations: eventWriteAnnotations,
       async execute(rawInput, executeOptions) {
         const { id, ...input } = rawInput;
         const signal = executionSignal(executeOptions);
@@ -158,30 +215,38 @@ function createCalendarTools(readOptions) {
         await options.onEventsChanged();
         return { event };
       }
-    },
-    {
+    });
+  }
+  if (capabilities.delete) {
+    tools.push({
       name: "calendar_delete_event",
       title: "Delete calendar event",
-      description: "Delete one persisted calendar event by its stable event ID.",
+      description: "Permanently delete exactly one persisted calendar event (destructive state mutation). Requires stable id \u2014 obtain via calendar_list_events after disambiguating natural-language references; never pass a title as id and never delete from an ambiguous multi-match list. Use only when the user intends removal/cancellation, not to move, rename, shorten, or otherwise edit (calendar_update_event). Returns { deleted: true, event } where event is the deleted resource snapshot read immediately before removal.",
       inputSchema: {
         type: "object",
         properties: {
-          id: { type: "string", minLength: 1, description: "Stable event ID." }
+          id: stableEventIdProperty
         },
         required: ["id"],
         additionalProperties: false
       },
-      annotations: writeAnnotations(),
+      annotations: deleteAnnotations,
       async execute(input, executeOptions) {
         const { id } = input;
         const signal = executionSignal(executeOptions);
         const options = readOptions();
+        const existing = await options.events.get(id, { signal });
+        if (existing === null) {
+          throw new Error(`Event ${id} was not found.`);
+        }
+        const snapshot = cloneEvent(existing);
         await options.events.delete(id, { signal });
         await options.onEventsChanged();
-        return { deleted: true, id };
+        return { deleted: true, event: snapshot };
       }
-    }
-  ];
+    });
+  }
+  return tools;
 }
 
 // src/register-tools.ts

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/tool-definitions.ts","../src/register-tools.ts","../src/use-fullcalendar-webmcp.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/// <reference types=\"webmcp-types\" />\n\nimport type {\n  CreateCalendarEventInput,\n  FullCalendarWebMCPOptions,\n  UpdateCalendarEventInput,\n} from \"./types\";\n\ntype OptionsReader = () => FullCalendarWebMCPOptions;\n\nconst emptySchema = {\n  type: \"object\",\n  properties: {},\n  additionalProperties: false,\n} as const;\n\nconst eventProperties = {\n  title: {\n    type: \"string\",\n    minLength: 1,\n    description: \"The human-readable event title.\",\n  },\n  start: {\n    type: \"string\",\n    format: \"date-time\",\n    description: \"Inclusive event start as ISO 8601 with an explicit offset.\",\n  },\n  end: {\n    type: [\"string\", \"null\"],\n    format: \"date-time\",\n    description: \"Exclusive event end as ISO 8601 with an explicit offset, or null.\",\n  },\n  allDay: {\n    type: \"boolean\",\n    description: \"Whether the event is an all-day event.\",\n  },\n} as const;\n\nfunction readAnnotations(): WebMCP.ToolAnnotations {\n  return { readOnlyHint: true, untrustedContentHint: true };\n}\n\nfunction writeAnnotations(): WebMCP.ToolAnnotations {\n  return { readOnlyHint: false, untrustedContentHint: true };\n}\n\n/**\n * WebMCP imperative execute steps always pass ToolExecuteCallbackOptions with a\n * fresh AbortSignal. Some agent shims still call execute(input) with one argument.\n * Never require-destructure options; forward signal when present.\n */\nfunction executionSignal(\n  executeOptions: WebMCP.ToolExecuteCallbackOptions | undefined,\n): AbortSignal | undefined {\n  return executeOptions?.signal;\n}\n\nexport function createCalendarTools(\n  readOptions: OptionsReader,\n): WebMCP.ModelContextTool[] {\n  return [\n    {\n      name: \"calendar_get_context\",\n      title: \"Get calendar context\",\n      description:\n        \"Get the current time, resolved browser timezone, FullCalendar timezone, visible date range, and active view. Call this before interpreting relative dates such as Wednesday or tomorrow.\",\n      inputSchema: emptySchema,\n      annotations: readAnnotations(),\n      async execute() {\n        const api = readOptions().calendarRef.current?.getApi();\n        return {\n          now: new Date().toISOString(),\n          browserTimeZone: Intl.DateTimeFormat().resolvedOptions().timeZone,\n          fullCalendarTimeZone: api?.getOption(\"timeZone\") ?? \"local\",\n          view: api?.view.type ?? null,\n          visibleRange: api\n            ? {\n                start: api.view.activeStart.toISOString(),\n                end: api.view.activeEnd.toISOString(),\n              }\n            : null,\n        };\n      },\n    },\n    {\n      name: \"calendar_list_events\",\n      title: \"List calendar events\",\n      description:\n        \"List persisted calendar events, optionally filtered by an inclusive start, exclusive end, or case-insensitive title text. Use an end boundary one day after the requested day. Events may include optional host-selected metadata (JSON object) for agent context; Protocol Tooling does not automatically expose FullCalendar extendedProps.\",\n      inputSchema: {\n        type: \"object\",\n        properties: {\n          start: {\n            type: \"string\",\n            format: \"date-time\",\n            description: \"Inclusive ISO 8601 lower bound.\",\n          },\n          end: {\n            type: \"string\",\n            format: \"date-time\",\n            description: \"Exclusive ISO 8601 upper bound.\",\n          },\n          text: {\n            type: \"string\",\n            description: \"Optional case-insensitive title substring.\",\n          },\n        },\n        additionalProperties: false,\n      },\n      annotations: readAnnotations(),\n      async execute(query, executeOptions) {\n        const signal = executionSignal(executeOptions);\n        const events = await readOptions().events.list(\n          query as { start?: string; end?: string; text?: string },\n          { signal },\n        );\n        return { events };\n      },\n    },\n    {\n      name: \"calendar_get_event\",\n      title: \"Get calendar event\",\n      description:\n        \"Get one persisted calendar event by its stable event ID. The event may include optional host-selected metadata (JSON object) for agent context; metadata is read-only and is never inferred from FullCalendar extendedProps.\",\n      inputSchema: {\n        type: \"object\",\n        properties: {\n          id: { type: \"string\", minLength: 1, description: \"Stable event ID.\" },\n        },\n        required: [\"id\"],\n        additionalProperties: false,\n      },\n      annotations: readAnnotations(),\n      async execute(input, executeOptions) {\n        const { id } = input as { id: string };\n        const signal = executionSignal(executeOptions);\n        const event = await readOptions().events.get(id, { signal });\n        return { event };\n      },\n    },\n    {\n      name: \"calendar_create_event\",\n      title: \"Create calendar event\",\n      description:\n        \"Create and persist a generic calendar event. Times must be ISO 8601 values with explicit offsets. Returns the host-assigned stable event ID. Metadata cannot be supplied on create; only title, start, end, and allDay are accepted.\",\n      inputSchema: {\n        type: \"object\",\n        properties: eventProperties,\n        required: [\"title\", \"start\"],\n        additionalProperties: false,\n      },\n      annotations: writeAnnotations(),\n      async execute(rawInput, executeOptions) {\n        const input = rawInput as unknown as CreateCalendarEventInput;\n        const signal = executionSignal(executeOptions);\n        const options = readOptions();\n        const event = await options.events.create(input, { signal });\n        await options.onEventsChanged();\n        return { event };\n      },\n    },\n    {\n      name: \"calendar_update_event\",\n      title: \"Update calendar event\",\n      description:\n        \"Update selected fields on one persisted calendar event using its stable event ID. Omitted fields remain unchanged. Metadata cannot be supplied on update; only title, start, end, and allDay may be changed. Host-owned metadata is preserved by the repository.\",\n      inputSchema: {\n        type: \"object\",\n        properties: {\n          id: { type: \"string\", minLength: 1, description: \"Stable event ID.\" },\n          ...eventProperties,\n        },\n        required: [\"id\"],\n        minProperties: 2,\n        additionalProperties: false,\n      },\n      annotations: writeAnnotations(),\n      async execute(rawInput, executeOptions) {\n        const { id, ...input } = rawInput as unknown as UpdateCalendarEventInput & {\n          id: string;\n        };\n        const signal = executionSignal(executeOptions);\n        const options = readOptions();\n        const event = await options.events.update(id, input, { signal });\n        await options.onEventsChanged();\n        return { event };\n      },\n    },\n    {\n      name: \"calendar_delete_event\",\n      title: \"Delete calendar event\",\n      description: \"Delete one persisted calendar event by its stable event ID.\",\n      inputSchema: {\n        type: \"object\",\n        properties: {\n          id: { type: \"string\", minLength: 1, description: \"Stable event ID.\" },\n        },\n        required: [\"id\"],\n        additionalProperties: false,\n      },\n      annotations: writeAnnotations(),\n      async execute(input, executeOptions) {\n        const { id } = input as { id: string };\n        const signal = executionSignal(executeOptions);\n        const options = readOptions();\n        await options.events.delete(id, { signal });\n        await options.onEventsChanged();\n        return { deleted: true, id };\n      },\n    },\n  ];\n}\n","import { createCalendarTools } from \"./tool-definitions\";\nimport type { FullCalendarWebMCPOptions } from \"./types\";\n\nconst RUNTIME_POLL_INTERVAL_MS = 250;\n\nexport function registerCalendarToolsWhenAvailable(\n  readOptions: () => FullCalendarWebMCPOptions,\n  lifecycleSignal: AbortSignal,\n) {\n  let retryTimer: number | undefined;\n\n  const register = async () => {\n    if (lifecycleSignal.aborted) return;\n\n    const modelContext = document.modelContext;\n    if (!modelContext) {\n      retryTimer = window.setTimeout(register, RUNTIME_POLL_INTERVAL_MS);\n      return;\n    }\n\n    const registration = new AbortController();\n    const unregister = () => registration.abort(lifecycleSignal.reason);\n    lifecycleSignal.addEventListener(\"abort\", unregister, { once: true });\n\n    try {\n      await Promise.all(\n        createCalendarTools(readOptions).map((tool) =>\n          modelContext.registerTool(tool, { signal: registration.signal }),\n        ),\n      );\n    } catch (error) {\n      registration.abort();\n      if (!lifecycleSignal.aborted) {\n        readOptions().onRegistrationError?.(error);\n      }\n    }\n  };\n\n  void register();\n\n  lifecycleSignal.addEventListener(\n    \"abort\",\n    () => {\n      if (retryTimer !== undefined) window.clearTimeout(retryTimer);\n    },\n    { once: true },\n  );\n}\n","import { useEffect, useRef } from \"react\";\nimport { registerCalendarToolsWhenAvailable } from \"./register-tools\";\nimport type { FullCalendarWebMCPOptions } from \"./types\";\n\n/**\n * Primary React hook integrating FullCalendar with the browser WebMCP model context.\n *\n * Provides safe client-side registration, unmount cleanup, and continuous\n * binding to host persistence callbacks without re-registering tools across renders.\n */\nexport function useFullCalendarWebMCP(options: FullCalendarWebMCPOptions): void {\n  const latestOptions = useRef(options);\n  latestOptions.current = options;\n\n  useEffect(() => {\n    const lifecycle = new AbortController();\n    registerCalendarToolsWhenAvailable(\n      () => latestOptions.current,\n      lifecycle.signal,\n    );\n    return () => lifecycle.abort();\n  }, []);\n}\n"]}
+{"version":3,"sources":["../src/tool-definitions.ts","../src/register-tools.ts","../src/use-fullcalendar-webmcp.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/// <reference types=\"webmcp-types\" />\n\nimport type {\n  CalendarEvent,\n  CreateCalendarEventInput,\n  FullCalendarWebMCPCapabilities,\n  FullCalendarWebMCPOptions,\n  UpdateCalendarEventInput,\n} from \"./types\";\n\ntype OptionsReader = () => FullCalendarWebMCPOptions;\n\nconst emptySchema = {\n  type: \"object\",\n  properties: {},\n  additionalProperties: false,\n} as const;\n\nconst stableEventIdProperty = {\n  type: \"string\",\n  minLength: 1,\n  description:\n    \"Stable id of the persisted event. Obtain from calendar_list_events, calendar_get_event, or a prior create/update result. Never substitute an event title.\",\n} as const;\n\nconst queryStartProperty = {\n  type: \"string\",\n  format: \"date-time\",\n  description:\n    \"Inclusive lower bound for filtering persisted events (ISO 8601 date-time with explicit offset). Omit to include events from any earlier time.\",\n} as const;\n\nconst queryEndProperty = {\n  type: \"string\",\n  format: \"date-time\",\n  description:\n    \"Exclusive upper bound for filtering persisted events (ISO 8601 date-time with explicit offset). For one calendar day, set end to the start of the following day. Omit for no upper limit.\",\n} as const;\n\nconst queryTextProperty = {\n  type: \"string\",\n  description:\n    \"Case-insensitive substring matched against event titles. Omit to skip title filtering.\",\n} as const;\n\nconst createEventTitleProperty = {\n  type: \"string\",\n  minLength: 1,\n  description: \"Display title for the new event.\",\n} as const;\n\nconst updateEventTitleProperty = {\n  type: \"string\",\n  minLength: 1,\n  description: \"New display title. Omit to leave the current title unchanged.\",\n} as const;\n\nconst createEventStartProperty = {\n  type: \"string\",\n  format: \"date-time\",\n  description:\n    \"Inclusive event start as ISO 8601 date-time with an explicit offset (e.g. 2026-09-02T14:00:00-06:00). Resolve relative times with calendar_get_context first.\",\n} as const;\n\nconst updateEventStartProperty = {\n  type: \"string\",\n  format: \"date-time\",\n  description:\n    \"New inclusive event start (ISO 8601 with explicit offset). Omit to leave the current start unchanged.\",\n} as const;\n\nconst createEventEndProperty = {\n  type: [\"string\", \"null\"],\n  format: \"date-time\",\n  description:\n    \"Exclusive event end as ISO 8601 date-time with explicit offset, or null for open-ended. Omit on create to use host defaults.\",\n} as const;\n\nconst updateEventEndProperty = {\n  type: [\"string\", \"null\"],\n  format: \"date-time\",\n  description:\n    \"New exclusive event end (ISO 8601 with explicit offset) or null. Omit to leave the current end unchanged.\",\n} as const;\n\nconst createAllDayProperty = {\n  type: \"boolean\",\n  description:\n    \"Whether the event spans full calendar days without clock times. Defaults to false when omitted.\",\n} as const;\n\nconst updateAllDayProperty = {\n  type: \"boolean\",\n  description: \"Whether the event is all-day. Omit to leave unchanged.\",\n} as const;\n\n/** Library-generated viewport/time context — not user-authored event content. */\nconst contextAnnotations: WebMCP.ToolAnnotations = { readOnlyHint: true };\n\n/** Persisted event reads may include user-controlled titles and host metadata. */\nconst eventReadAnnotations: WebMCP.ToolAnnotations = {\n  readOnlyHint: true,\n  untrustedContentHint: true,\n};\n\n/** Mutations that return persisted event records with user-controlled fields. */\nconst eventWriteAnnotations: WebMCP.ToolAnnotations = {\n  readOnlyHint: false,\n  untrustedContentHint: true,\n};\n\n/** Destructive mutation with a minimal structured confirmation payload. */\nconst deleteAnnotations: WebMCP.ToolAnnotations = { readOnlyHint: false };\n\nexport function resolveCapabilities(\n  capabilities?: FullCalendarWebMCPCapabilities,\n): Required<FullCalendarWebMCPCapabilities> {\n  return {\n    read: capabilities?.read ?? true,\n    create: capabilities?.create ?? true,\n    update: capabilities?.update ?? true,\n    delete: capabilities?.delete ?? true,\n  };\n}\n\n/**\n * WebMCP imperative execute steps always pass ToolExecuteCallbackOptions with a\n * fresh AbortSignal. Some agent shims still call execute(input) with one argument.\n * Never require-destructure options; forward signal when present.\n */\nfunction executionSignal(\n  executeOptions: WebMCP.ToolExecuteCallbackOptions | undefined,\n): AbortSignal | undefined {\n  return executeOptions?.signal;\n}\n\n/** JSON-clone so delete snapshots cannot mutate repository-owned objects. */\nfunction cloneEvent(event: CalendarEvent): CalendarEvent {\n  return JSON.parse(JSON.stringify(event)) as CalendarEvent;\n}\n\nexport function createCalendarTools(\n  readOptions: OptionsReader,\n): WebMCP.ModelContextTool[] {\n  const capabilities = resolveCapabilities(readOptions().capabilities);\n  const tools: WebMCP.ModelContextTool[] = [\n    {\n      name: \"calendar_get_context\",\n      title: \"Get calendar context\",\n      description:\n        \"Read-only temporal and viewport context for the open calendar — not persisted events. \" +\n        \"Use when the user mentions relative times (today, tomorrow, tonight, Wednesday, next week, this afternoon, first week of next month) to anchor ISO date-times before list/create/update. \" +\n        \"Returns now, browserTimeZone, fullCalendarTimeZone, active view, and visibleRange. \" +\n        \"Skip when every datetime is already explicit with offsets and no relative interpretation is needed. \" +\n        \"Does not replace calendar_list_events for event discovery.\",\n      inputSchema: emptySchema,\n      annotations: contextAnnotations,\n      async execute() {\n        const api = readOptions().calendarRef.current?.getApi();\n        return {\n          now: new Date().toISOString(),\n          browserTimeZone: Intl.DateTimeFormat().resolvedOptions().timeZone,\n          fullCalendarTimeZone: api?.getOption(\"timeZone\") ?? \"local\",\n          view: api?.view.type ?? null,\n          visibleRange: api\n            ? {\n                start: api.view.activeStart.toISOString(),\n                end: api.view.activeEnd.toISOString(),\n              }\n            : null,\n        };\n      },\n    },\n  ];\n\n  if (capabilities.read) {\n    tools.push(\n      {\n        name: \"calendar_list_events\",\n        title: \"List calendar events\",\n        description:\n          \"Read-only search and discovery over persisted calendar events. \" +\n          \"Use to answer what is scheduled, filter by date range or title, find candidate events before update/delete, or disambiguate which event the user means. \" +\n          \"start is inclusive; end is exclusive — for one calendar day set end to the following day's boundary. \" +\n          \"text is a case-insensitive title substring; omit any filter to broaden results. \" +\n          \"Returns events with stable id values usable in get/update/delete; optional host-selected metadata may appear and is untrusted. \" +\n          \"Do not use when you already hold the target id (prefer calendar_get_event) or only need viewport/time context (calendar_get_context). \" +\n          \"Never delete or mutate from an ambiguous multi-match list alone.\",\n        inputSchema: {\n          type: \"object\",\n          properties: {\n            start: queryStartProperty,\n            end: queryEndProperty,\n            text: queryTextProperty,\n          },\n          additionalProperties: false,\n        },\n        annotations: eventReadAnnotations,\n        async execute(query, executeOptions) {\n          const signal = executionSignal(executeOptions);\n          const events = await readOptions().events.list(\n            query as { start?: string; end?: string; text?: string },\n            { signal },\n          );\n          return { events };\n        },\n      },\n      {\n        name: \"calendar_get_event\",\n        title: \"Get calendar event\",\n        description:\n          \"Read-only fetch of exactly one persisted event by stable id. \" +\n          \"Use when you already have the id from calendar_list_events, a prior create/update result, or the host app — or to re-read authoritative fields before a mutation when list results are insufficient. \" +\n          \"Returns { event: CalendarEvent | null }; null means no matching persisted event. \" +\n          \"Do not use for title/date search (calendar_list_events), do not invent ids from titles, and do not substitute a title for id.\",\n        inputSchema: {\n          type: \"object\",\n          properties: {\n            id: stableEventIdProperty,\n          },\n          required: [\"id\"],\n          additionalProperties: false,\n        },\n        annotations: eventReadAnnotations,\n        async execute(input, executeOptions) {\n          const { id } = input as { id: string };\n          const signal = executionSignal(executeOptions);\n          const event = await readOptions().events.get(id, { signal });\n          return { event };\n        },\n      },\n    );\n  }\n\n  if (capabilities.create) {\n    tools.push({\n      name: \"calendar_create_event\",\n      title: \"Create calendar event\",\n      description:\n        \"Create and persist a new calendar event (state mutation). \" +\n        \"Use only for brand-new events the user wants scheduled. \" +\n        \"Requires title and start (ISO 8601 with explicit offset); optional end (exclusive, ISO 8601 or null) and allDay. \" +\n        \"Resolve relative times via calendar_get_context first. \" +\n        \"Returns the persisted event including host-assigned id. Metadata cannot be supplied. \" +\n        \"Do not use to modify, reschedule, or rename an existing event — use calendar_update_event.\",\n      inputSchema: {\n        type: \"object\",\n        properties: {\n          title: createEventTitleProperty,\n          start: createEventStartProperty,\n          end: createEventEndProperty,\n          allDay: createAllDayProperty,\n        },\n        required: [\"title\", \"start\"],\n        additionalProperties: false,\n      },\n      annotations: eventWriteAnnotations,\n      async execute(rawInput, executeOptions) {\n        const input = rawInput as unknown as CreateCalendarEventInput;\n        const signal = executionSignal(executeOptions);\n        const options = readOptions();\n        const event = await options.events.create(input, { signal });\n        await options.onEventsChanged();\n        return { event };\n      },\n    });\n  }\n\n  if (capabilities.update) {\n    tools.push({\n      name: \"calendar_update_event\",\n      title: \"Update calendar event\",\n      description:\n        \"Persisted partial update of exactly one existing event (state mutation). \" +\n        \"Requires stable id plus at least one of title, start, end, allDay; omitted fields stay unchanged. \" +\n        \"Host-selected metadata is preserved and cannot be written here. \" +\n        \"When the user names an event without an id, find it with calendar_list_events first; calendar_get_event is optional if the list row already has sufficient detail. \" +\n        \"Use for reschedule, rename, time/end changes, or all-day toggles — not for creating a duplicate or deleting (calendar_create_event / calendar_delete_event).\",\n      inputSchema: {\n        type: \"object\",\n        properties: {\n          id: stableEventIdProperty,\n          title: updateEventTitleProperty,\n          start: updateEventStartProperty,\n          end: updateEventEndProperty,\n          allDay: updateAllDayProperty,\n        },\n        required: [\"id\"],\n        minProperties: 2,\n        additionalProperties: false,\n      },\n      annotations: eventWriteAnnotations,\n      async execute(rawInput, executeOptions) {\n        const { id, ...input } = rawInput as unknown as UpdateCalendarEventInput & {\n          id: string;\n        };\n        const signal = executionSignal(executeOptions);\n        const options = readOptions();\n        const event = await options.events.update(id, input, { signal });\n        await options.onEventsChanged();\n        return { event };\n      },\n    });\n  }\n\n  if (capabilities.delete) {\n    tools.push({\n      name: \"calendar_delete_event\",\n      title: \"Delete calendar event\",\n      description:\n        \"Permanently delete exactly one persisted calendar event (destructive state mutation). \" +\n        \"Requires stable id — obtain via calendar_list_events after disambiguating natural-language references; never pass a title as id and never delete from an ambiguous multi-match list. \" +\n        \"Use only when the user intends removal/cancellation, not to move, rename, shorten, or otherwise edit (calendar_update_event). \" +\n        \"Returns { deleted: true, event } where event is the deleted resource snapshot read immediately before removal.\",\n      inputSchema: {\n        type: \"object\",\n        properties: {\n          id: stableEventIdProperty,\n        },\n        required: [\"id\"],\n        additionalProperties: false,\n      },\n      annotations: deleteAnnotations,\n      async execute(input, executeOptions) {\n        const { id } = input as { id: string };\n        const signal = executionSignal(executeOptions);\n        const options = readOptions();\n        const existing = await options.events.get(id, { signal });\n        if (existing === null) {\n          throw new Error(`Event ${id} was not found.`);\n        }\n        const snapshot = cloneEvent(existing);\n        await options.events.delete(id, { signal });\n        await options.onEventsChanged();\n        return { deleted: true, event: snapshot };\n      },\n    });\n  }\n\n  return tools;\n}\n","import { createCalendarTools } from \"./tool-definitions\";\nimport type { FullCalendarWebMCPOptions } from \"./types\";\n\nconst RUNTIME_POLL_INTERVAL_MS = 250;\n\nexport function registerCalendarToolsWhenAvailable(\n  readOptions: () => FullCalendarWebMCPOptions,\n  lifecycleSignal: AbortSignal,\n) {\n  let retryTimer: number | undefined;\n\n  const register = async () => {\n    if (lifecycleSignal.aborted) return;\n\n    const modelContext = document.modelContext;\n    if (!modelContext) {\n      retryTimer = window.setTimeout(register, RUNTIME_POLL_INTERVAL_MS);\n      return;\n    }\n\n    const registration = new AbortController();\n    const unregister = () => registration.abort(lifecycleSignal.reason);\n    lifecycleSignal.addEventListener(\"abort\", unregister, { once: true });\n\n    try {\n      await Promise.all(\n        createCalendarTools(readOptions).map((tool) =>\n          modelContext.registerTool(tool, { signal: registration.signal }),\n        ),\n      );\n    } catch (error) {\n      registration.abort();\n      if (!lifecycleSignal.aborted) {\n        readOptions().onRegistrationError?.(error);\n      }\n    }\n  };\n\n  void register();\n\n  lifecycleSignal.addEventListener(\n    \"abort\",\n    () => {\n      if (retryTimer !== undefined) window.clearTimeout(retryTimer);\n    },\n    { once: true },\n  );\n}\n","import { useEffect, useRef } from \"react\";\nimport { registerCalendarToolsWhenAvailable } from \"./register-tools\";\nimport type { FullCalendarWebMCPOptions } from \"./types\";\n\n/**\n * Primary React hook integrating FullCalendar with the browser WebMCP model context.\n *\n * Provides safe client-side registration, unmount cleanup, and continuous\n * binding to host persistence callbacks without re-registering tools across renders.\n */\nexport function useFullCalendarWebMCP(options: FullCalendarWebMCPOptions): void {\n  const latestOptions = useRef(options);\n  latestOptions.current = options;\n\n  useEffect(() => {\n    const lifecycle = new AbortController();\n    registerCalendarToolsWhenAvailable(\n      () => latestOptions.current,\n      lifecycle.signal,\n    );\n    return () => lifecycle.abort();\n  }, []);\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@protocoltooling/fullcalendar",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Add WebMCP tools to FullCalendar React applications.",
   "publishConfig": {
     "access": "public"