@protocoltooling/fullcalendar 0.1.0 → 0.1.1

package/README.md

@@ -14,7 +14,7 @@ npm install @protocoltooling/fullcalendar
 
 ```bash
 npm pack
-npm install /path/to/protocoltooling-fullcalendar-0.1.0.tgz
+npm install /path/to/protocoltooling-fullcalendar-0.1.1.tgz
 ```
 
 ### Peer Dependencies

package/dist/index.js

@@ -36,6 +36,9 @@ function readAnnotations() {
 function writeAnnotations() {
   return { readOnlyHint: false, untrustedContentHint: true };
 }
+function executionSignal(executeOptions) {
+  return executeOptions?.signal;
+}
 function createCalendarTools(readOptions) {
   return [
     {
@@ -83,8 +86,12 @@ function createCalendarTools(readOptions) {
         additionalProperties: false
       },
       annotations: readAnnotations(),
-      async execute(query, { signal }) {
-        const events = await readOptions().events.list(query, { signal });
+      async execute(query, executeOptions) {
+        const signal = executionSignal(executeOptions);
+        const events = await readOptions().events.list(
+          query,
+          { signal }
+        );
         return { events };
       }
     },
@@ -101,8 +108,9 @@ function createCalendarTools(readOptions) {
         additionalProperties: false
       },
       annotations: readAnnotations(),
-      async execute(input, { signal }) {
+      async execute(input, executeOptions) {
         const { id } = input;
+        const signal = executionSignal(executeOptions);
         const event = await readOptions().events.get(id, { signal });
         return { event };
       }
@@ -118,8 +126,9 @@ function createCalendarTools(readOptions) {
         additionalProperties: false
       },
       annotations: writeAnnotations(),
-      async execute(rawInput, { signal }) {
+      async execute(rawInput, executeOptions) {
         const input = rawInput;
+        const signal = executionSignal(executeOptions);
         const options = readOptions();
         const event = await options.events.create(input, { signal });
         await options.onEventsChanged();
@@ -141,8 +150,9 @@ function createCalendarTools(readOptions) {
         additionalProperties: false
       },
       annotations: writeAnnotations(),
-      async execute(rawInput, { signal }) {
+      async execute(rawInput, executeOptions) {
         const { id, ...input } = rawInput;
+        const signal = executionSignal(executeOptions);
         const options = readOptions();
         const event = await options.events.update(id, input, { signal });
         await options.onEventsChanged();
@@ -162,8 +172,9 @@ function createCalendarTools(readOptions) {
         additionalProperties: false
       },
       annotations: writeAnnotations(),
-      async execute(input, { signal }) {
+      async execute(input, executeOptions) {
         const { id } = input;
+        const signal = executionSignal(executeOptions);
         const options = readOptions();
         await options.events.delete(id, { signal });
         await options.onEventsChanged();

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\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.\",\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(\n        query: { start?: string; end?: string; text?: string },\n        { signal },\n      ) {\n        const events = await readOptions().events.list(query, { signal });\n        return { events };\n      },\n    },\n    {\n      name: \"calendar_get_event\",\n      title: \"Get calendar event\",\n      description: \"Get 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: readAnnotations(),\n      async execute(input, { signal }) {\n        const { id } = input as { id: string };\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.\",\n      inputSchema: {\n        type: \"object\",\n        properties: eventProperties,\n        required: [\"title\", \"start\"],\n        additionalProperties: false,\n      },\n      annotations: writeAnnotations(),\n      async execute(rawInput, { signal }) {\n        const input = rawInput as unknown as CreateCalendarEventInput;\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.\",\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, { signal }) {\n        const { id, ...input } = rawInput as unknown as UpdateCalendarEventInput & {\n          id: string;\n        };\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, { signal }) {\n        const { id } = input as { id: string };\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  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.\",\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: \"Get 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: 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.\",\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.\",\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"]}

package/package.json

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