@chronary/toolkit 1.1.0 → 1.2.0

package/dist/mcp.js

@@ -28,6 +28,7 @@ var WEBHOOK_EVENT_TYPES = [
 ];
 var WEBHOOK_DELIVERY_STATUSES = ["pending", "delivered", "failed"];
 var ListCalendarsSchema = z.object({
+  agent_id: z.string().optional().describe("Filter to calendars owned by this agent. Org keys only \u2014 agent-scoped keys are always limited to their own agent and ignore this."),
   include: z.enum(["all"]).optional().describe('Pass "all" to include calendars across all agents (org keys only)'),
   limit: z.number().int().min(1).max(200).default(50).describe("Max results to return"),
   offset: z.number().int().min(0).default(0).describe("Pagination offset")
@@ -53,15 +54,18 @@ var DeleteCalendarSchema = z.object({
   calendar_id: z.string().describe("Calendar ID to delete")
 });
 var ListEventsSchema = z.object({
-  calendar_id: z.string().describe("Calendar ID to list events from"),
-  start_after: z.string().datetime().optional().describe("Filter events starting after this time"),
-  start_before: z.string().datetime().optional().describe("Filter events starting before this time"),
+  calendar_id: z.string().optional().describe("Calendar ID to list events from. Provide this or agent_id."),
+  agent_id: z.string().optional().describe("Agent ID to list events for across all of the agent's calendars. Provide this or calendar_id."),
+  start_after: z.string().datetime().optional().describe("Only events starting after this ISO 8601 time"),
+  start_before: z.string().datetime().optional().describe("Only events starting before this ISO 8601 time"),
+  status: z.enum(["confirmed", "tentative", "cancelled", "hold"]).optional().describe("Filter by event status"),
+  source: z.enum(["internal", "external_ical"]).optional().describe('Filter by source: "internal" (created via the API) or "external_ical" (synced from an iCal subscription)'),
   limit: z.number().int().min(1).max(200).default(50).describe("Max results to return"),
   offset: z.number().int().min(0).default(0).describe("Pagination offset")
 });
 var GetEventSchema = z.object({
   event_id: z.string().describe("Event ID to retrieve"),
-  calendar_id: z.string().describe("Calendar ID that owns the event. Required \u2014 the SDK is calendar-scoped (unlike the hosted MCP, which can resolve the calendar from event_id).")
+  calendar_id: z.string().optional().describe("Calendar ID that owns the event. Optional \u2014 if omitted the calendar is resolved from the event.")
 });
 var CreateEventSchema = z.object({
   calendar_id: z.string().describe("Calendar ID to add the event to"),
@@ -77,7 +81,7 @@ var CreateEventSchema = z.object({
 });
 var UpdateEventSchema = z.object({
   event_id: z.string().describe("Event ID to update"),
-  calendar_id: z.string().describe("Calendar ID that owns the event. Required \u2014 the SDK is calendar-scoped (unlike the hosted MCP, which can resolve the calendar from event_id)."),
+  calendar_id: z.string().optional().describe("Calendar ID that owns the event. Optional \u2014 if omitted the calendar is resolved from the event."),
   title: z.string().min(1).max(500).optional().describe("New event title"),
   description: z.string().nullable().optional().describe("New description, or null to clear it"),
   start_time: z.string().datetime().optional().describe("New start time (ISO 8601)"),
@@ -89,7 +93,7 @@ var UpdateEventSchema = z.object({
 });
 var CancelEventSchema = z.object({
   event_id: z.string().describe("Event ID to cancel"),
-  calendar_id: z.string().describe("Calendar ID that owns the event. Required \u2014 the SDK is calendar-scoped (unlike the hosted MCP, which can resolve the calendar from event_id).")
+  calendar_id: z.string().optional().describe("Calendar ID that owns the event. Optional \u2014 if omitted the calendar is resolved from the event. Matches the asymmetry with confirm_event / release_event which never required this arg.")
 });
 var ConfirmEventSchema = z.object({
   event_id: z.string().describe("Event ID of the hold to confirm")
@@ -186,7 +190,7 @@ var timeOfDay = z.string().regex(/^([01]\d|2[0-3]):[0-5]\d$/, "must be HH:MM in
 var workingHoursDaySchema = z.object({
   start: timeOfDay,
   end: timeOfDay
-});
+}).refine((v) => v.end > v.start, "end must be after start").describe("A single day's working hours window");
 var workingHoursSchema = z.object({
   mon: workingHoursDaySchema.optional(),
   tue: workingHoursDaySchema.optional(),
@@ -195,7 +199,7 @@ var workingHoursSchema = z.object({
   fri: workingHoursDaySchema.optional(),
   sat: workingHoursDaySchema.optional(),
   sun: workingHoursDaySchema.optional()
-}).nullable();
+}).refine((v) => Object.keys(v).length > 0, "at least one day must be specified").nullable();
 var SetAvailabilityRulesSchema = z.object({
   calendar_id: z.string().describe("Calendar to configure"),
   buffer_before_minutes: z.number().int().min(0).max(120).default(0).describe("Minutes of buffer before each event (0\u2013120)"),
@@ -309,7 +313,7 @@ async function fetchPage(iterator, offset, limit) {
 }
 var listCalendars = safeFunc(async (ctx) => {
   const { client, params } = ctx;
-  const iter = client.calendars.list({ include: params.include, limit: params.limit });
+  const iter = client.calendars.list({ agentId: params.agent_id, include: params.include, limit: params.limit });
   return fetchPage(iter, params.offset, params.limit);
 });
 var getCalendar = safeFunc(async (ctx) => {
@@ -336,16 +340,23 @@ var deleteCalendar = safeFunc(async (ctx) => {
 });
 var listEvents = safeFunc(async (ctx) => {
   const { client, params } = ctx;
+  if (!params.calendar_id && !params.agent_id) {
+    throw new Error("Provide calendar_id or agent_id");
+  }
   const iter = client.events.list({
     calendarId: params.calendar_id,
+    agentId: params.agent_id,
     start_after: params.start_after,
     start_before: params.start_before,
+    status: params.status,
+    source: params.source,
     limit: params.limit
   });
   return fetchPage(iter, params.offset, params.limit);
 });
 var getEvent = safeFunc(async (ctx) => {
-  return ctx.client.events.get(ctx.params.calendar_id, ctx.params.event_id);
+  const { calendar_id, event_id } = ctx.params;
+  return calendar_id ? ctx.client.events.get(calendar_id, event_id) : ctx.client.events.getById(event_id);
 });
 var createEvent = safeFunc(async (ctx) => {
   const { client, params } = ctx;
@@ -355,10 +366,15 @@ var createEvent = safeFunc(async (ctx) => {
 var updateEvent = safeFunc(async (ctx) => {
   const { client, params } = ctx;
   const { calendar_id, event_id, ...updates } = params;
-  return client.events.update(calendar_id, event_id, updates);
+  return calendar_id ? client.events.update(calendar_id, event_id, updates) : client.events.updateById(event_id, updates);
 });
 var cancelEvent = safeFunc(async (ctx) => {
-  await ctx.client.events.delete(ctx.params.calendar_id, ctx.params.event_id);
+  const { calendar_id, event_id } = ctx.params;
+  if (calendar_id) {
+    await ctx.client.events.delete(calendar_id, event_id);
+  } else {
+    await ctx.client.events.deleteById(event_id);
+  }
   return void 0;
 });
 var confirmEvent = safeFunc(async (ctx) => {
@@ -626,7 +642,7 @@ var TOOL_DEFINITIONS = [
   // ── Events ─────────────────────────────────────────────────────
   {
     name: "list_events",
-    description: "List all events on a calendar, including internally created events and externally synced events from iCal subscriptions (e.g. Google Calendar, Outlook). Use start_after and start_before to query a specific time window.",
+    description: "List events on a calendar or across an agent's calendars, including internally created events and externally synced events from iCal subscriptions (e.g. Google Calendar, Outlook). Provide `calendar_id` OR `agent_id`. Narrow with `start_after`/`start_before` (time window), `status`, and `source`.",
     schema: ListEventsSchema,
     annotations: { title: "List Events", readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
     execute: createExecutor(listEvents)