@knowsuchagency/fulcrum 2.6.4 → 2.6.6

package/README.md

@@ -153,6 +153,17 @@ Create documents with live preview. Generate charts and visualizations. The assi
 
 ![AI Assistant Editor](https://raw.githubusercontent.com/knowsuchagency/fulcrum/main/screenshots/assistant-editor-dark.png)
 
+### Calendar Integration
+
+Connect your calendars via CalDAV so the AI assistant knows your schedule. Google Calendar is supported out of the box with OAuth2.
+
+- **Google Calendar** — OAuth2 flow, no password needed
+- **Any CalDAV server** — Nextcloud, Radicale, Baikal, iCloud
+- **Automatic sync** — Calendars sync on a configurable interval
+- **Assistant awareness** — The AI assistant uses your calendar context for planning and scheduling
+
+Enable in Settings → Calendar Integration.
+
 ### Messaging Integrations
 
 Chat with the AI assistant from anywhere via your favorite messaging platform.

package/bin/fulcrum.js

@@ -1541,6 +1541,48 @@ class FulcrumClient {
       body: JSON.stringify(data)
     });
   }
+  async getCaldavStatus() {
+    return this.fetch("/api/caldav/status");
+  }
+  async listCalendars() {
+    return this.fetch("/api/caldav/calendars");
+  }
+  async syncCalendars() {
+    return this.fetch("/api/caldav/sync", { method: "POST" });
+  }
+  async listCalendarEvents(options) {
+    const params = new URLSearchParams;
+    if (options?.calendarId)
+      params.set("calendarId", options.calendarId);
+    if (options?.from)
+      params.set("from", options.from);
+    if (options?.to)
+      params.set("to", options.to);
+    if (options?.limit)
+      params.set("limit", String(options.limit));
+    const query = params.toString();
+    return this.fetch(`/api/caldav/events${query ? `?${query}` : ""}`);
+  }
+  async getCalendarEvent(id) {
+    return this.fetch(`/api/caldav/events/${id}`);
+  }
+  async createCalendarEvent(input) {
+    return this.fetch("/api/caldav/events", {
+      method: "POST",
+      body: JSON.stringify(input)
+    });
+  }
+  async updateCalendarEvent(id, updates) {
+    return this.fetch(`/api/caldav/events/${id}`, {
+      method: "PATCH",
+      body: JSON.stringify(updates)
+    });
+  }
+  async deleteCalendarEvent(id) {
+    return this.fetch(`/api/caldav/events/${id}`, {
+      method: "DELETE"
+    });
+  }
   async getAssistantStats() {
     return this.fetch("/api/assistant/stats");
   }
@@ -43378,7 +43420,8 @@ var init_types4 = __esm(() => {
     "backup",
     "email",
     "messaging",
-    "assistant"
+    "assistant",
+    "caldav"
   ]);
   AgentTypeSchema = exports_external.enum(["claude", "opencode"]);
 });
@@ -44081,6 +44124,55 @@ var init_registry = __esm(() => {
       category: "assistant",
       keywords: ["sweep", "last", "hourly", "morning", "evening", "ritual"],
       defer_loading: false
+    },
+    {
+      name: "list_calendars",
+      description: "List all CalDAV calendars synced from the configured server",
+      category: "caldav",
+      keywords: ["calendar", "caldav", "list", "schedule"],
+      defer_loading: true
+    },
+    {
+      name: "sync_calendars",
+      description: "Trigger a manual sync of all CalDAV calendars and events",
+      category: "caldav",
+      keywords: ["calendar", "caldav", "sync", "refresh", "update"],
+      defer_loading: true
+    },
+    {
+      name: "list_calendar_events",
+      description: "List calendar events with optional filtering by calendar, date range, or limit",
+      category: "caldav",
+      keywords: ["calendar", "event", "list", "schedule", "appointment", "meeting"],
+      defer_loading: true
+    },
+    {
+      name: "get_calendar_event",
+      description: "Get details of a specific calendar event by ID",
+      category: "caldav",
+      keywords: ["calendar", "event", "get", "details", "appointment"],
+      defer_loading: true
+    },
+    {
+      name: "create_calendar_event",
+      description: "Create a new calendar event on a CalDAV calendar",
+      category: "caldav",
+      keywords: ["calendar", "event", "create", "new", "schedule", "appointment", "meeting"],
+      defer_loading: true
+    },
+    {
+      name: "update_calendar_event",
+      description: "Update an existing calendar event",
+      category: "caldav",
+      keywords: ["calendar", "event", "update", "edit", "modify", "reschedule"],
+      defer_loading: true
+    },
+    {
+      name: "delete_calendar_event",
+      description: "Delete a calendar event",
+      category: "caldav",
+      keywords: ["calendar", "event", "delete", "remove", "cancel"],
+      defer_loading: true
     }
   ];
 });
@@ -45595,6 +45687,101 @@ var init_assistant_events = __esm(() => {
   ChannelSchema = exports_external.enum(["email", "whatsapp", "discord", "telegram", "slack", "all"]);
 });
 
+// cli/src/mcp/tools/caldav.ts
+var registerCaldavTools = (server, client) => {
+  server.tool("list_calendars", "List all CalDAV calendars synced from the configured server.", {}, async () => {
+    try {
+      const calendars = await client.listCalendars();
+      return formatSuccess(calendars);
+    } catch (err) {
+      return handleToolError(err);
+    }
+  });
+  server.tool("sync_calendars", "Trigger a manual sync of all CalDAV calendars and events from the server.", {}, async () => {
+    try {
+      const result = await client.syncCalendars();
+      return formatSuccess(result);
+    } catch (err) {
+      return handleToolError(err);
+    }
+  });
+  server.tool("list_calendar_events", "List calendar events with optional filtering by calendar, date range, or limit.", {
+    calendarId: exports_external.optional(exports_external.string()).describe("Filter by calendar ID"),
+    from: exports_external.optional(exports_external.string()).describe("Start date filter (ISO format or iCal date)"),
+    to: exports_external.optional(exports_external.string()).describe("End date filter (ISO format or iCal date)"),
+    limit: exports_external.optional(exports_external.number()).describe("Maximum events to return")
+  }, async ({ calendarId, from, to, limit }) => {
+    try {
+      const events = await client.listCalendarEvents({ calendarId, from, to, limit });
+      return formatSuccess(events);
+    } catch (err) {
+      return handleToolError(err);
+    }
+  });
+  server.tool("get_calendar_event", "Get details of a specific calendar event by ID.", {
+    id: exports_external.string().describe("Event ID")
+  }, async ({ id }) => {
+    try {
+      const event = await client.getCalendarEvent(id);
+      return formatSuccess(event);
+    } catch (err) {
+      return handleToolError(err);
+    }
+  });
+  server.tool("create_calendar_event", "Create a new calendar event on a CalDAV calendar.", {
+    calendarId: exports_external.string().describe("Calendar ID to create the event in"),
+    summary: exports_external.string().describe("Event title/summary"),
+    dtstart: exports_external.string().describe("Start date/time (iCal format: 20250115T090000Z or 20250115 for all-day)"),
+    dtend: exports_external.optional(exports_external.string()).describe("End date/time (iCal format)"),
+    duration: exports_external.optional(exports_external.string()).describe("Duration (iCal format, e.g., PT1H for 1 hour)"),
+    description: exports_external.optional(exports_external.string()).describe("Event description"),
+    location: exports_external.optional(exports_external.string()).describe("Event location"),
+    allDay: exports_external.optional(exports_external.boolean()).describe("Whether this is an all-day event"),
+    recurrenceRule: exports_external.optional(exports_external.string()).describe("Recurrence rule (RRULE format)"),
+    status: exports_external.optional(exports_external.string()).describe("Event status (TENTATIVE, CONFIRMED, CANCELLED)")
+  }, async (input) => {
+    try {
+      const event = await client.createCalendarEvent(input);
+      return formatSuccess(event);
+    } catch (err) {
+      return handleToolError(err);
+    }
+  });
+  server.tool("update_calendar_event", "Update an existing calendar event.", {
+    id: exports_external.string().describe("Event ID to update"),
+    summary: exports_external.optional(exports_external.string()).describe("New event title/summary"),
+    dtstart: exports_external.optional(exports_external.string()).describe("New start date/time"),
+    dtend: exports_external.optional(exports_external.string()).describe("New end date/time"),
+    duration: exports_external.optional(exports_external.string()).describe("New duration"),
+    description: exports_external.optional(exports_external.string()).describe("New description"),
+    location: exports_external.optional(exports_external.string()).describe("New location"),
+    allDay: exports_external.optional(exports_external.boolean()).describe("Whether this is an all-day event"),
+    recurrenceRule: exports_external.optional(exports_external.string()).describe("New recurrence rule"),
+    status: exports_external.optional(exports_external.string()).describe("New status")
+  }, async ({ id, ...updates }) => {
+    try {
+      const event = await client.updateCalendarEvent(id, updates);
+      return formatSuccess(event);
+    } catch (err) {
+      return handleToolError(err);
+    }
+  });
+  server.tool("delete_calendar_event", "Delete a calendar event from the CalDAV server.", {
+    id: exports_external.string().describe("Event ID to delete")
+  }, async ({ id }) => {
+    try {
+      const result = await client.deleteCalendarEvent(id);
+      return formatSuccess(result);
+    } catch (err) {
+      return handleToolError(err);
+    }
+  });
+};
+var init_caldav = __esm(() => {
+  init_zod2();
+  init_utils();
+});
+
 // cli/src/mcp/tools/index.ts
 function registerTools(server, client) {
   registerCoreTools(server, client);
@@ -45609,6 +45796,7 @@ function registerTools(server, client) {
   registerBackupTools(server, client);
   registerEmailTools(server, client);
   registerAssistantEventTools(server, client);
+  registerCaldavTools(server, client);
 }
 var init_tools = __esm(() => {
   init_core5();
@@ -45623,6 +45811,7 @@ var init_tools = __esm(() => {
   init_backup();
   init_email();
   init_assistant_events();
+  init_caldav();
   init_types4();
 });
 
@@ -45641,7 +45830,7 @@ async function runMcpServer(urlOverride, portOverride) {
   const client = new FulcrumClient(urlOverride, portOverride);
   const server = new McpServer({
     name: "fulcrum",
-    version: "2.6.4"
+    version: "2.6.6"
   });
   registerTools(server, client);
   const transport = new StdioServerTransport;
@@ -47990,7 +48179,7 @@ var marketplace_default = `{
       "name": "fulcrum",
       "source": "./",
       "description": "Task orchestration for Claude Code",
-      "version": "2.6.4",
+      "version": "2.6.6",
       "skills": [
         "./skills/fulcrum"
       ],
@@ -49178,7 +49367,7 @@ function compareVersions(v1, v2) {
 var package_default = {
   name: "@knowsuchagency/fulcrum",
   private: true,
-  version: "2.6.4",
+  version: "2.6.6",
   description: "Harness Attention. Orchestrate Agents. Ship.",
   license: "PolyForm-Perimeter-1.0.0",
   type: "module",
@@ -49258,6 +49447,7 @@ var package_default = {
     sonner: "^2.0.7",
     "tailwind-merge": "^3.4.0",
     tailwindcss: "^4.1.17",
+    tsdav: "^2.1.6",
     "tw-animate-css": "^1.4.0",
     ws: "^8.18.3",
     yaml: "^2.8.2"