@firfi/huly-mcp 0.9.3 → 0.10.0

package/README.md

@@ -295,12 +295,13 @@ MCP_TRANSPORT=http MCP_HTTP_PORT=8080 MCP_HTTP_HOST=0.0.0.0 npx -y @firfi/huly-m
 | Tool | Description |
 |------|-------------|
 | `list_events` | List calendar events. Returns events sorted by date. Supports filtering by date range. |
+| `list_calendars` | List writable, non-hidden calendars that can be used as create_event or create_recurring_event targets. Use this before creating events when you need to choose a target calendarId explicitly. |
 | `get_event` | Retrieve full details for a calendar event including description. Use this to view event content and metadata. |
-| `create_event` | Create a new calendar event. Description supports markdown formatting. Returns the created event ID. |
+| `create_event` | Create a new calendar event. Description supports markdown formatting. Optional calendarId targets a specific calendar; when omitted, the event uses the authenticated user's primary personal calendar. Returns the created event ID. |
 | `update_event` | Update fields on an existing calendar event. Only provided fields are modified. Description updates support markdown. |
 | `delete_event` | Permanently delete a calendar event. This action cannot be undone. |
 | `list_recurring_events` | List recurring event definitions. Returns recurring events sorted by modification date (newest first). |
-| `create_recurring_event` | Create a new recurring calendar event with RFC5545 RRULE rules. Description supports markdown. Returns the created event ID. |
+| `create_recurring_event` | Create a new recurring calendar event with RFC5545 RRULE rules. Description supports markdown. Optional calendarId targets a specific calendar; when omitted, the event uses the authenticated user's primary personal calendar. Returns the created event ID. |
 | `list_event_instances` | List instances of a recurring event. Returns instances sorted by date. Supports filtering by date range. Use includeParticipants=true to fetch full participant info (extra lookups). |
 
 ### Time Tracking
@@ -523,4 +524,3 @@ The CockroachDB credentials can be found in your Huly `compose.yml` or via `dock
 
 - **Bash wrapper scripts** (sourcing `.env` files) may not work reliably when launched by MCP clients on Windows. Prefer setting env vars directly in the MCP config JSON.
 - **Docker pulls over SSH** may fail on Windows due to credential manager issues. Pull images from the server desktop if needed.
-

package/dist/index.cjs

@@ -114648,7 +114648,7 @@ var require_utils15 = __commonJS({
       generateEventId: () => generateEventId3,
       generateRecurringValues: () => generateRecurringValues,
       getAllEvents: () => getAllEvents,
-      getPrimaryCalendar: () => getPrimaryCalendar,
+      getPrimaryCalendar: () => getPrimaryCalendar2,
       getWeekday: () => getWeekday
     });
     module2.exports = __toCommonJS2(utils_exports);
@@ -115004,7 +115004,7 @@ var require_utils15 = __commonJS({
       return result;
     }
     __name(encodeToBase32Hex, "encodeToBase32Hex");
-    function getPrimaryCalendar(calendars, preference, acc) {
+    function getPrimaryCalendar2(calendars, preference, acc) {
       if (preference?.attachedTo !== void 0) {
         const pref = calendars.find((p) => p._id === preference.attachedTo && p);
         if (pref !== void 0) return pref._id;
@@ -115016,7 +115016,7 @@ var require_utils15 = __commonJS({
       }
       return `${acc}_calendar`;
     }
-    __name(getPrimaryCalendar, "getPrimaryCalendar");
+    __name(getPrimaryCalendar2, "getPrimaryCalendar");
   }
 });
 
@@ -115044,7 +115044,7 @@ var require_lib25 = __commonJS({
     var __toCommonJS2 = (mod) => __copyProps2(__defProp2({}, "__esModule", { value: true }), mod);
     var index_exports2 = {};
     __export2(index_exports2, {
-      AccessLevel: () => AccessLevel4,
+      AccessLevel: () => AccessLevel5,
       caldavIntegrationKind: () => caldavIntegrationKind,
       calendarId: () => calendarId,
       calendarIntegrationKind: () => calendarIntegrationKind,
@@ -115053,13 +115053,13 @@ var require_lib25 = __commonJS({
     module2.exports = __toCommonJS2(index_exports2);
     var import_platform3 = require_lib();
     __reExport2(index_exports2, require_utils15(), module2.exports);
-    var AccessLevel4 = /* @__PURE__ */ ((AccessLevel22) => {
+    var AccessLevel5 = /* @__PURE__ */ ((AccessLevel22) => {
       AccessLevel22["FreeBusyReader"] = "freeBusyReader";
       AccessLevel22["Reader"] = "reader";
       AccessLevel22["Writer"] = "writer";
       AccessLevel22["Owner"] = "owner";
       return AccessLevel22;
-    })(AccessLevel4 || {});
+    })(AccessLevel5 || {});
     var calendarIntegrationKind = "google-calendar";
     var caldavIntegrationKind = "caldav";
     var calendarId = "calendar";
@@ -150577,6 +150577,7 @@ var TeamspaceId = HulyRef("TeamspaceId");
 var NotificationId = HulyRef("NotificationId");
 var NotificationContextId = HulyRef("NotificationContextId");
 var EventId = HulyRef("EventId");
+var CalendarId = HulyRef("CalendarId");
 var TodoId = HulyRef("TodoId");
 var SpaceId = HulyRef("SpaceId");
 var CommentId = HulyRef("CommentId");
@@ -151527,7 +151528,15 @@ var HulyClient = class _HulyClient extends Context_exports.Tag("@hulymcp/HulyCli
     Effect_exports.gen(function* () {
       const config3 = yield* HulyConfigService;
       const sdk = yield* HulySdk;
-      const { accountUuid, client, imageUrl, markupOps, refUrl, workspaceUrlSlug } = yield* connectRestWithRetry({
+      const {
+        accountUuid,
+        client,
+        imageUrl,
+        markupOps,
+        primarySocialId,
+        refUrl,
+        workspaceUrlSlug
+      } = yield* connectRestWithRetry({
         url: config3.url,
         auth: config3.auth,
         workspace: config3.workspace
@@ -151549,6 +151558,7 @@ var HulyClient = class _HulyClient extends Context_exports.Tag("@hulymcp/HulyCli
       });
       const operations = {
         getAccountUuid: () => accountUuid,
+        getPrimarySocialId: () => primarySocialId,
         documentUrlConfig,
         markupUrlConfig,
         findAll: (_class, query, options) => withClient(
@@ -151630,6 +151640,9 @@ var HulyClient = class _HulyClient extends Context_exports.Tag("@hulymcp/HulyCli
       // AccountUuid is a double-branded string type with no public constructor
       // eslint-disable-next-line no-restricted-syntax -- see above
       getAccountUuid: () => "test-account-uuid",
+      // PersonId is a branded string type with no public constructor
+      // eslint-disable-next-line no-restricted-syntax -- see above
+      getPrimarySocialId: () => "test-primary-social-id",
       documentUrlConfig: {
         baseUrl: UrlString.make("https://test.huly.local"),
         workspaceUrlSlug: WorkspaceUrlSlug.make("test-workspace")
@@ -151696,6 +151709,7 @@ var connectRest = async (config3, sdk) => {
   return {
     client,
     accountUuid: account.uuid,
+    primarySocialId: account.primarySocialId,
     workspaceUrlSlug: WorkspaceUrlSlug.make(info.workspaceUrl),
     markupOps,
     refUrl,
@@ -171276,7 +171290,7 @@ var PostHog = class extends PostHogBackendClient {
 };
 
 // src/version.ts
-var VERSION = true ? "0.9.3" : "0.0.0-dev";
+var VERSION = true ? "0.10.0" : "0.0.0-dev";
 
 // src/telemetry/posthog.ts
 var POSTHOG_API_KEY = "phc_TGfFqCGdnF0p68wuFzd5WSw1IsBvOJW0YgoMJDyZPjm";
@@ -173564,6 +173578,10 @@ var GetEventParamsSchema = Schema_exports.Struct({
   title: "GetEventParams",
   description: "Parameters for getting a single event"
 });
+var ListCalendarsParamsSchema = EmptyParamsSchema.annotations({
+  title: "ListCalendarsParams",
+  description: "Parameters for listing writable calendar targets"
+});
 var CreateEventParamsSchema = Schema_exports.Struct({
   title: NonEmptyString2.annotations({
     description: "Event title"
@@ -173590,6 +173608,9 @@ var CreateEventParamsSchema = Schema_exports.Struct({
   ),
   visibility: Schema_exports.optional(VisibilitySchema.annotations({
     description: "Event visibility (public, freeBusy, private)"
+  })),
+  calendarId: Schema_exports.optional(CalendarId.annotations({
+    description: "Target writable calendar ID. If omitted, uses the authenticated user's primary personal calendar. Use list_calendars to discover valid calendar IDs."
   }))
 }).annotations({
   title: "CreateEventParams",
@@ -173674,6 +173695,9 @@ var CreateRecurringEventParamsSchema = Schema_exports.Struct({
   })),
   visibility: Schema_exports.optional(VisibilitySchema.annotations({
     description: "Event visibility (public, freeBusy, private)"
+  })),
+  calendarId: Schema_exports.optional(CalendarId.annotations({
+    description: "Target writable calendar ID. If omitted, uses the authenticated user's primary personal calendar. Use list_calendars to discover valid calendar IDs."
   }))
 }).annotations({
   title: "CreateRecurringEventParams",
@@ -173703,6 +173727,7 @@ var ListEventInstancesParamsSchema = Schema_exports.Struct({
 });
 var listEventsParamsJsonSchema = JSONSchema_exports.make(ListEventsParamsSchema);
 var getEventParamsJsonSchema = JSONSchema_exports.make(GetEventParamsSchema);
+var listCalendarsParamsJsonSchema = JSONSchema_exports.make(ListCalendarsParamsSchema);
 var createEventParamsJsonSchema = JSONSchema_exports.make(CreateEventParamsSchema);
 var updateEventParamsJsonSchema = JSONSchema_exports.make(UpdateEventParamsSchema);
 var deleteEventParamsJsonSchema = JSONSchema_exports.make(DeleteEventParamsSchema);
@@ -173711,6 +173736,7 @@ var createRecurringEventParamsJsonSchema = JSONSchema_exports.make(CreateRecurri
 var listEventInstancesParamsJsonSchema = JSONSchema_exports.make(ListEventInstancesParamsSchema);
 var parseListEventsParams = Schema_exports.decodeUnknown(ListEventsParamsSchema);
 var parseGetEventParams = Schema_exports.decodeUnknown(GetEventParamsSchema);
+var parseListCalendarsParams = Schema_exports.decodeUnknown(ListCalendarsParamsSchema);
 var parseCreateEventParams = Schema_exports.decodeUnknown(CreateEventParamsSchema);
 var parseUpdateEventParams = Schema_exports.decodeUnknown(UpdateEventParamsSchema);
 var parseDeleteEventParams = Schema_exports.decodeUnknown(DeleteEventParamsSchema);
@@ -173719,10 +173745,11 @@ var parseCreateRecurringEventParams = Schema_exports.decodeUnknown(CreateRecurri
 var parseListEventInstancesParams = Schema_exports.decodeUnknown(ListEventInstancesParamsSchema);
 
 // src/huly/operations/calendar.ts
-var import_calendar2 = __toESM(require_lib25(), 1);
+var import_calendar3 = __toESM(require_lib25(), 1);
 var import_core25 = __toESM(require_lib4(), 1);
 
 // src/huly/operations/calendar-shared.ts
+var import_calendar = __toESM(require_lib25(), 1);
 var descriptionAsMarkupRef = (desc) => desc;
 var markupRefAsDescription = (ref) => ref ?? "";
 var emptyEventDescription = "";
@@ -173747,10 +173774,46 @@ var findPersonsByEmails = (client, emails) => Effect_exports.gen(function* () {
   );
   return persons;
 });
-var getDefaultCalendar = (client) => client.findOne(
+var findWritablePersonalCalendars = (client) => client.findAll(
   calendar.class.Calendar,
-  {}
+  {
+    user: client.getPrimarySocialId(),
+    hidden: false,
+    access: { $in: [import_calendar.AccessLevel.Owner, import_calendar.AccessLevel.Writer] }
+  }
 );
+var findWritableCalendars = (client) => client.findAll(
+  calendar.class.Calendar,
+  {
+    hidden: false,
+    access: { $in: [import_calendar.AccessLevel.Owner, import_calendar.AccessLevel.Writer] }
+  }
+);
+var getDefaultCalendarRef = (client) => Effect_exports.gen(function* () {
+  const calendars = yield* findWritablePersonalCalendars(client);
+  const preference = yield* client.findOne(
+    calendar.class.PrimaryCalendar,
+    {}
+  );
+  return (0, import_calendar.getPrimaryCalendar)(calendars, preference, client.getAccountUuid());
+});
+var resolveCalendarRef = (client, calendarId) => Effect_exports.gen(function* () {
+  if (calendarId === void 0) {
+    return yield* getDefaultCalendarRef(client);
+  }
+  const cal = yield* client.findOne(
+    calendar.class.Calendar,
+    {
+      _id: toRef(calendarId),
+      hidden: false,
+      access: { $in: [import_calendar.AccessLevel.Owner, import_calendar.AccessLevel.Writer] }
+    }
+  );
+  if (cal === void 0) {
+    return yield* new HulyError({ message: `Calendar '${calendarId}' not found or not accessible` });
+  }
+  return cal._id;
+});
 var buildParticipants = (client, participantRefs) => Effect_exports.gen(function* () {
   if (participantRefs.length === 0) return [];
   const persons = yield* client.findAll(
@@ -173763,8 +173826,7 @@ var buildParticipants = (client, participantRefs) => Effect_exports.gen(function
   }));
 });
 var resolveEventInputs = (client, params, eventClass, eventId) => Effect_exports.gen(function* () {
-  const cal = yield* getDefaultCalendar(client);
-  const calendarRef = cal?._id ?? toRef("");
+  const calendarRef = yield* resolveCalendarRef(client, params.calendarId);
   const participantRefs = params.participants && params.participants.length > 0 ? (yield* findPersonsByEmails(client, params.participants)).map((p) => p._id) : [];
   const descriptionRef = params.description && params.description.trim() !== "" ? yield* client.uploadMarkup(
     eventClass,
@@ -173777,7 +173839,7 @@ var resolveEventInputs = (client, params, eventClass, eventId) => Effect_exports
 });
 
 // src/huly/operations/calendar-recurring.ts
-var import_calendar = __toESM(require_lib25(), 1);
+var import_calendar2 = __toESM(require_lib25(), 1);
 var import_core24 = __toESM(require_lib4(), 1);
 var hulyRuleToRule = (rule) => ({
   freq: rule.freq,
@@ -173827,7 +173889,7 @@ var listRecurringEvents = (params) => Effect_exports.gen(function* () {
 });
 var createRecurringEvent = (params) => Effect_exports.gen(function* () {
   const client = yield* HulyClient;
-  const eventId = (0, import_calendar.generateEventId)();
+  const eventId = (0, import_calendar2.generateEventId)();
   const dueDate = params.dueDate ?? params.startDate + ONE_HOUR_MS;
   const { calendarRef, descriptionRef, participantRefs } = yield* resolveEventInputs(
     client,
@@ -173846,7 +173908,7 @@ var createRecurringEvent = (params) => Effect_exports.gen(function* () {
     calendar: calendarRef,
     participants: participantRefs,
     externalParticipants: [],
-    access: import_calendar.AccessLevel.Owner,
+    access: import_calendar2.AccessLevel.Owner,
     user: serverPopulatedUser,
     blockTime: false,
     rules: hulyRules,
@@ -173936,6 +173998,17 @@ var listEventInstances = (params) => Effect_exports.gen(function* () {
 });
 
 // src/huly/operations/calendar.ts
+var toWritableCalendarAccess = (access) => {
+  switch (access) {
+    case import_calendar3.AccessLevel.Writer:
+      return "writer";
+    case import_calendar3.AccessLevel.Owner:
+      return "owner";
+    case import_calendar3.AccessLevel.FreeBusyReader:
+    case import_calendar3.AccessLevel.Reader:
+      return void 0;
+  }
+};
 var listEvents = (params) => Effect_exports.gen(function* () {
   const client = yield* HulyClient;
   const query = {};
@@ -173965,6 +174038,24 @@ var listEvents = (params) => Effect_exports.gen(function* () {
   }));
   return summaries;
 });
+var listCalendars = (_params) => Effect_exports.gen(function* () {
+  const client = yield* HulyClient;
+  const calendars = yield* findWritableCalendars(client);
+  const primaryCalendarRef = yield* getDefaultCalendarRef(client);
+  return calendars.flatMap((cal) => {
+    const access = toWritableCalendarAccess(cal.access);
+    if (access === void 0) return [];
+    return [{
+      calendarId: CalendarId.make(cal._id),
+      name: cal.name,
+      hidden: cal.hidden,
+      visibility: visibilityToString(cal.visibility) ?? "private",
+      user: PersonId.make(cal.user),
+      access,
+      isPrimary: cal._id === primaryCalendarRef
+    }];
+  });
+});
 var getEvent = (params) => Effect_exports.gen(function* () {
   const client = yield* HulyClient;
   const event = yield* client.findOne(
@@ -173993,7 +174084,7 @@ var getEvent = (params) => Effect_exports.gen(function* () {
     visibility: visibilityToString(event.visibility),
     participants,
     externalParticipants: (event.externalParticipants || []).map((p) => Email.make(p)),
-    calendarId: event.calendar,
+    calendarId: CalendarId.make(event.calendar),
     modifiedOn: event.modifiedOn,
     createdOn: event.createdOn
   };
@@ -174001,7 +174092,7 @@ var getEvent = (params) => Effect_exports.gen(function* () {
 });
 var createEvent = (params) => Effect_exports.gen(function* () {
   const client = yield* HulyClient;
-  const eventId = (0, import_calendar2.generateEventId)();
+  const eventId = (0, import_calendar3.generateEventId)();
   const dueDate = params.dueDate ?? params.date + ONE_HOUR_MS;
   const { calendarRef, descriptionRef, participantRefs } = yield* resolveEventInputs(
     client,
@@ -174019,7 +174110,7 @@ var createEvent = (params) => Effect_exports.gen(function* () {
     calendar: calendarRef,
     participants: participantRefs,
     externalParticipants: [],
-    access: import_calendar2.AccessLevel.Owner,
+    access: import_calendar3.AccessLevel.Owner,
     user: serverPopulatedUser,
     blockTime: false
   };
@@ -174141,6 +174232,17 @@ var calendarTools = [
       listEvents
     )
   },
+  {
+    name: "list_calendars",
+    description: "List writable, non-hidden calendars that can be used as create_event or create_recurring_event targets. Use this before creating events when you need to choose a target calendarId explicitly.",
+    category: CATEGORY3,
+    inputSchema: listCalendarsParamsJsonSchema,
+    handler: createToolHandler(
+      "list_calendars",
+      parseListCalendarsParams,
+      listCalendars
+    )
+  },
   {
     name: "get_event",
     description: "Retrieve full details for a calendar event including description. Use this to view event content and metadata.",
@@ -174154,7 +174256,7 @@ var calendarTools = [
   },
   {
     name: "create_event",
-    description: "Create a new calendar event. Description supports markdown formatting. Returns the created event ID.",
+    description: "Create a new calendar event. Description supports markdown formatting. Optional calendarId targets a specific calendar; when omitted, the event uses the authenticated user's primary personal calendar. Returns the created event ID.",
     category: CATEGORY3,
     inputSchema: createEventParamsJsonSchema,
     handler: createToolHandler(
@@ -174198,7 +174300,7 @@ var calendarTools = [
   },
   {
     name: "create_recurring_event",
-    description: "Create a new recurring calendar event with RFC5545 RRULE rules. Description supports markdown. Returns the created event ID.",
+    description: "Create a new recurring calendar event with RFC5545 RRULE rules. Description supports markdown. Optional calendarId targets a specific calendar; when omitted, the event uses the authenticated user's primary personal calendar. Returns the created event ID.",
     category: CATEGORY3,
     inputSchema: createRecurringEventParamsJsonSchema,
     handler: createToolHandler(
@@ -184345,7 +184447,7 @@ var testManagementPlansTools = [
 ];
 
 // src/huly/operations/time.ts
-var import_calendar6 = __toESM(require_lib25(), 1);
+var import_calendar7 = __toESM(require_lib25(), 1);
 var import_core48 = __toESM(require_lib4(), 1);
 var import_tracker7 = __toESM(require_lib36(), 1);
 var serverPopulatedCalendar = toRef("");
@@ -184575,7 +184677,7 @@ var createWorkSlot = (params) => Effect_exports.gen(function* () {
     description: "",
     allDay: false,
     participants: [],
-    access: import_calendar6.AccessLevel.Owner,
+    access: import_calendar7.AccessLevel.Owner,
     reminders: [],
     visibility: "public",
     eventId: "",