@chronary/toolkit 1.1.0 → 1.2.1

package/dist/index.d.ts

@@ -6,6 +6,7 @@ import '@chronary/sdk';
 declare const TOOL_DEFINITIONS: ToolDefinition[];
 
 declare const ListCalendarsSchema: z.ZodObject<{
+    agent_id: z.ZodOptional<z.ZodString>;
     include: z.ZodOptional<z.ZodEnum<{
         all: "all";
     }>>;
@@ -38,15 +39,26 @@ declare const DeleteCalendarSchema: z.ZodObject<{
     calendar_id: z.ZodString;
 }, z.core.$strip>;
 declare const ListEventsSchema: z.ZodObject<{
-    calendar_id: z.ZodString;
+    calendar_id: z.ZodOptional<z.ZodString>;
+    agent_id: z.ZodOptional<z.ZodString>;
     start_after: z.ZodOptional<z.ZodString>;
     start_before: z.ZodOptional<z.ZodString>;
+    status: z.ZodOptional<z.ZodEnum<{
+        confirmed: "confirmed";
+        tentative: "tentative";
+        cancelled: "cancelled";
+        hold: "hold";
+    }>>;
+    source: z.ZodOptional<z.ZodEnum<{
+        internal: "internal";
+        external_ical: "external_ical";
+    }>>;
     limit: z.ZodDefault<z.ZodNumber>;
     offset: z.ZodDefault<z.ZodNumber>;
 }, z.core.$strip>;
 declare const GetEventSchema: z.ZodObject<{
     event_id: z.ZodString;
-    calendar_id: z.ZodString;
+    calendar_id: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 declare const CreateEventSchema: z.ZodObject<{
     calendar_id: z.ZodString;
@@ -66,7 +78,7 @@ declare const CreateEventSchema: z.ZodObject<{
 }, z.core.$strip>;
 declare const UpdateEventSchema: z.ZodObject<{
     event_id: z.ZodString;
-    calendar_id: z.ZodString;
+    calendar_id: z.ZodOptional<z.ZodString>;
     title: z.ZodOptional<z.ZodString>;
     description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     start_time: z.ZodOptional<z.ZodString>;
@@ -82,7 +94,7 @@ declare const UpdateEventSchema: z.ZodObject<{
 }, z.core.$strip>;
 declare const CancelEventSchema: z.ZodObject<{
     event_id: z.ZodString;
-    calendar_id: z.ZodString;
+    calendar_id: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 declare const ConfirmEventSchema: z.ZodObject<{
     event_id: z.ZodString;

package/dist/index.js

@@ -129,6 +129,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")
@@ -154,15 +155,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"),
@@ -178,7 +182,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)"),
@@ -190,7 +194,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")
@@ -287,7 +291,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(),
@@ -296,7 +300,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)"),
@@ -410,7 +414,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) => {
@@ -437,16 +441,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;
@@ -456,10 +467,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) => {
@@ -727,7 +743,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)
@@ -1001,7 +1017,7 @@ var TOOL_DEFINITIONS = [
   },
   {
     name: "revoke_scoped_key",
-    description: "Revoke an agent-scoped API key by ID. The key stops authenticating immediately and cannot be un-revoked. Requires an org-level API key.",
+    description: "Revoke an agent-scoped API key by ID. Revocation is permanent (cannot be un-revoked); the key stops authenticating within about a minute. Requires an org-level API key.",
     schema: RevokeScopedKeySchema,
     annotations: { title: "Revoke Scoped Key", readOnlyHint: false, destructiveHint: true, idempotentHint: true, openWorldHint: false },
     execute: createExecutor(revokeScopedKey)