@chronary/toolkit 1.6.2 → 1.7.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/mastra.cjs CHANGED
@@ -57,7 +57,7 @@ var ListCalendarsSchema = import_zod.z.object({
57
57
  agent_id: import_zod.z.string().optional().describe("Filter to calendars owned by this agent. Organization keys only \u2014 Agent keys are always limited to their own agent and ignore this."),
58
58
  include: import_zod.z.enum(["all"]).optional().describe('Pass "all" to include calendars across all agents (Organization keys only)'),
59
59
  limit: import_zod.z.number().int().min(1).max(200).default(50).describe("Max results to return"),
60
- offset: import_zod.z.number().int().min(0).default(0).describe("Pagination offset")
60
+ offset: import_zod.z.number().int().min(0).default(0).describe("Pagination offset, at most 10000")
61
61
  });
62
62
  var GetCalendarSchema = import_zod.z.object({
63
63
  calendar_id: import_zod.z.string().describe("Calendar ID to fetch")
@@ -81,7 +81,7 @@ var DeleteCalendarSchema = import_zod.z.object({
81
81
  });
82
82
  var ListBookingPagesSchema = import_zod.z.object({
83
83
  limit: import_zod.z.number().int().min(1).max(200).default(50).describe("Max results to return"),
84
- offset: import_zod.z.number().int().min(0).default(0).describe("Pagination offset")
84
+ offset: import_zod.z.number().int().min(0).default(0).describe("Pagination offset, at most 10000")
85
85
  });
86
86
  var GetBookingPageSchema = import_zod.z.object({
87
87
  booking_page_id: import_zod.z.string().describe("Booking page ID to fetch (bkp_...)")
@@ -104,25 +104,25 @@ var DeleteBookingPageSchema = import_zod.z.object({
104
104
  var ListEventsSchema = import_zod.z.object({
105
105
  calendar_id: import_zod.z.string().optional().describe("Calendar ID to list events from. Provide this or agent_id."),
106
106
  agent_id: import_zod.z.string().optional().describe("Agent ID to list events for across all of the agent's calendars. Provide this or calendar_id."),
107
- start_after: import_zod.z.string().datetime().optional().describe("Only events starting after this ISO 8601 time"),
108
- start_before: import_zod.z.string().datetime().optional().describe("Only events starting before this ISO 8601 time"),
107
+ start_after: import_zod.z.string().datetime({ offset: true }).optional().describe("Only events starting after this ISO 8601 time"),
108
+ start_before: import_zod.z.string().datetime({ offset: true }).optional().describe("Only events starting before this ISO 8601 time"),
109
109
  status: import_zod.z.enum(["confirmed", "tentative", "cancelled", "hold"]).optional().describe("Filter by event status"),
110
110
  source: import_zod.z.enum(["internal", "external_ical"]).optional().describe('Filter by source: "internal" (created via the API) or "external_ical" (synced from an iCal subscription)'),
111
111
  limit: import_zod.z.number().int().min(1).max(200).default(50).describe("Max results to return"),
112
- offset: import_zod.z.number().int().min(0).default(0).describe("Pagination offset"),
112
+ offset: import_zod.z.number().int().min(0).default(0).describe("Pagination offset, at most 10000"),
113
113
  expand: import_zod.z.boolean().default(false).describe("Expand recurring series into individual occurrence instances within the window. Requires both start_after and start_before (max 366 days apart). Instances carry recurringEventId + originalStartTime.")
114
114
  });
115
115
  var ListOrgEventsSchema = import_zod.z.object({
116
116
  calendar_ids: import_zod.z.array(import_zod.z.string()).max(50).optional().describe("Only these calendar IDs (at most 50)"),
117
117
  agent_id: import_zod.z.string().optional().describe("Only this agent's calendars"),
118
- start_after: import_zod.z.string().datetime().optional().describe("Only events starting at or after this ISO 8601 time"),
119
- start_before: import_zod.z.string().datetime().optional().describe("Only events starting at or before this ISO 8601 time"),
118
+ start_after: import_zod.z.string().datetime({ offset: true }).optional().describe("Only events starting at or after this ISO 8601 time"),
119
+ start_before: import_zod.z.string().datetime({ offset: true }).optional().describe("Only events starting at or before this ISO 8601 time"),
120
120
  status: import_zod.z.enum(["confirmed", "tentative", "cancelled", "hold"]).optional().describe("Filter by event status"),
121
121
  source: import_zod.z.enum(["internal", "external_ical"]).optional().describe('Filter by source: "internal" (created via the API) or "external_ical" (synced from an iCal subscription)'),
122
122
  q: import_zod.z.string().optional().describe("Case-insensitive title search. Requires start_after and start_before at most 31 days apart"),
123
123
  expand: import_zod.z.boolean().default(false).describe("Expand recurring series into individual occurrences within the window. Requires both start_after and start_before (max 366 days apart)."),
124
124
  limit: import_zod.z.number().int().min(1).max(100).default(50).describe("Max results to return (1-100)"),
125
- offset: import_zod.z.number().int().min(0).default(0).describe("Pagination offset")
125
+ offset: import_zod.z.number().int().min(0).default(0).describe("Pagination offset, at most 10000")
126
126
  });
127
127
  var GetEventSchema = import_zod.z.object({
128
128
  event_id: import_zod.z.string().describe("Event ID to retrieve"),
@@ -131,33 +131,35 @@ var GetEventSchema = import_zod.z.object({
131
131
  var CreateEventSchema = import_zod.z.object({
132
132
  calendar_id: import_zod.z.string().describe("Calendar ID to add the event to"),
133
133
  title: import_zod.z.string().min(1).max(500).describe("Event title"),
134
- start_time: import_zod.z.string().datetime().describe("Start time (ISO 8601)"),
135
- end_time: import_zod.z.string().datetime().describe("End time (ISO 8601)"),
134
+ start_time: import_zod.z.string().datetime({ offset: true }).describe("Start time (ISO 8601)"),
135
+ end_time: import_zod.z.string().datetime({ offset: true }).describe("End time (ISO 8601)"),
136
136
  description: import_zod.z.string().max(1e4).optional().describe("Optional event description"),
137
137
  all_day: import_zod.z.boolean().default(false).describe("Whether this is an all-day event"),
138
138
  status: import_zod.z.enum(["confirmed", "tentative", "hold"]).optional().describe('Event status. "hold" creates a tentative reservation that auto-expires at hold_expires_at. Defaults to "confirmed".'),
139
139
  reminders: import_zod.z.array(import_zod.z.number().int().min(1).max(40320)).max(5).nullable().optional().describe("Reminder offsets in minutes before start_time (e.g. [10, 1440]). Each fires an event.reminder webhook and shows as an alarm in the iCal feed. Omit or null to inherit the calendar default (then the system default of 10 min); [] for no reminders."),
140
- hold_expires_at: import_zod.z.string().datetime().optional().describe('Required when status="hold". ISO 8601 timestamp 30s-15min in the future. Auto-releases the hold when reached.'),
140
+ hold_expires_at: import_zod.z.string().datetime({ offset: true }).optional().describe('Required when status="hold". ISO 8601 timestamp 30s-15min in the future. Auto-releases the hold when reached.'),
141
141
  hold_priority: import_zod.z.number().int().min(0).max(100).optional().describe('Only valid with status="hold". Higher-priority overlapping holds pre-empt lower-priority ones. Defaults to 0.'),
142
- recurrence_rule: import_zod.z.string().max(256).optional().describe('Make this a recurring series (RFC 5545 RRULE subset, no "RRULE:" prefix), e.g. "FREQ=WEEKLY;BYDAY=MO,WE;COUNT=12". Supports FREQ=DAILY/WEEKLY/MONTHLY/YEARLY, INTERVAL, COUNT (max 730) or UNTIL, BYDAY (weekly list or monthly ordinal like 2TU/-1FR), BYMONTHDAY (1-28 or -1). start_time must match the rule pattern; expansion is UTC-only. Not allowed with status="hold". Free plan: 1 recurring series, must end within 90 days.')
142
+ recurrence_rule: import_zod.z.string().max(256).optional().describe('Make this a recurring series (RFC 5545 RRULE subset, no "RRULE:" prefix), e.g. "FREQ=WEEKLY;BYDAY=MO,WE;COUNT=12". Supports FREQ=DAILY/WEEKLY/MONTHLY/YEARLY, INTERVAL, COUNT (max 730) or UNTIL, BYDAY (weekly list or monthly ordinal like 2TU/-1FR), BYMONTHDAY (1-28 or -1). start_time must match the rule pattern (in timezone when set, else UTC). Not allowed with status="hold". Free plan: 1 recurring series, must end within 90 days.'),
143
+ timezone: import_zod.z.string().max(64).optional().describe('IANA time zone the recurring series repeats in, e.g. "America/Los_Angeles". A weekly 16:00 then stays 16:00 local across daylight-saving changes; BYDAY and a date-only UNTIL are read in this zone. Omit for UTC.')
143
144
  });
144
145
  var UpdateEventSchema = import_zod.z.object({
145
146
  event_id: import_zod.z.string().describe("Event ID to update"),
146
147
  calendar_id: import_zod.z.string().optional().describe("Calendar ID that owns the event. Optional \u2014 if omitted the calendar is resolved from the event."),
147
148
  title: import_zod.z.string().min(1).max(500).optional().describe("New event title"),
148
149
  description: import_zod.z.string().max(1e4).nullable().optional().describe("New description, or null to clear it"),
149
- start_time: import_zod.z.string().datetime().optional().describe("New start time (ISO 8601)"),
150
- end_time: import_zod.z.string().datetime().optional().describe("New end time (ISO 8601)"),
150
+ start_time: import_zod.z.string().datetime({ offset: true }).optional().describe("New start time (ISO 8601)"),
151
+ end_time: import_zod.z.string().datetime({ offset: true }).optional().describe("New end time (ISO 8601)"),
151
152
  all_day: import_zod.z.boolean().optional().describe("Whether this is an all-day event"),
152
153
  status: import_zod.z.enum(["confirmed", "tentative", "cancelled"]).optional().describe("New event status"),
153
154
  metadata: import_zod.z.record(import_zod.z.string(), import_zod.z.unknown()).optional().describe("Replacement metadata object"),
154
155
  reminders: import_zod.z.array(import_zod.z.number().int().min(1).max(40320)).max(5).nullable().optional().describe("Reminder offsets in minutes before start_time. Omit to leave unchanged, null to inherit the calendar default, [] for no reminders."),
155
- recurrence_rule: import_zod.z.string().max(256).nullable().optional().describe("Set/change the recurring series rule (RFC 5545 RRULE subset, full-series semantics), or null to make the event a one-off. Changing the rule or start_time resets cancelled occurrences.")
156
+ recurrence_rule: import_zod.z.string().max(256).nullable().optional().describe("Set/change the recurring series rule (RFC 5545 RRULE subset, full-series semantics), or null to make the event a one-off. Changing the rule, start_time or timezone keeps each cancelled occurrence on its local date; the response lists any that no longer match in droppedExdates."),
157
+ timezone: import_zod.z.string().max(64).nullable().optional().describe('Set or change the IANA time zone the series repeats in (e.g. "America/Los_Angeles"), or null for UTC. Validated together with recurrence_rule and start_time, so a UTC-stored series can move to local time in one call (e.g. timezone + BYDAY=TU).')
156
158
  });
157
159
  var CancelEventSchema = import_zod.z.object({
158
160
  event_id: import_zod.z.string().describe("Event ID to cancel"),
159
161
  calendar_id: import_zod.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."),
160
- occurrence_start: import_zod.z.string().datetime().optional().describe("For recurring events only: ISO 8601 start of the single occurrence to cancel. The rest of the series is unaffected.")
162
+ occurrence_start: import_zod.z.string().datetime({ offset: true }).optional().describe("For recurring events only: ISO 8601 start of the single occurrence to cancel. The rest of the series is unaffected.")
161
163
  });
162
164
  var ConfirmEventSchema = import_zod.z.object({
163
165
  event_id: import_zod.z.string().describe("Event ID of the hold to confirm")
@@ -174,7 +176,7 @@ var ListAgentsSchema = import_zod.z.object({
174
176
  type: import_zod.z.enum(["ai", "human", "resource"]).optional().describe("Filter by agent type"),
175
177
  status: import_zod.z.enum(["active", "paused", "decommissioned"]).optional().describe("Filter by status"),
176
178
  limit: import_zod.z.number().int().min(1).max(200).default(50).describe("Max results to return"),
177
- offset: import_zod.z.number().int().min(0).default(0).describe("Pagination offset")
179
+ offset: import_zod.z.number().int().min(0).default(0).describe("Pagination offset, at most 10000")
178
180
  });
179
181
  var GetAgentSchema = import_zod.z.object({
180
182
  agent_id: import_zod.z.string().describe("Agent ID to fetch")
@@ -191,10 +193,10 @@ var DeleteAgentSchema = import_zod.z.object({
191
193
  });
192
194
  var GetAvailabilitySchema = import_zod.z.object({
193
195
  agent_id: import_zod.z.string().describe("Agent ID to check availability for"),
194
- start: import_zod.z.string().datetime().optional().describe("Range start (ISO 8601). Alias: start_time."),
195
- end: import_zod.z.string().datetime().optional().describe("Range end (ISO 8601). Alias: end_time."),
196
- start_time: import_zod.z.string().datetime().optional().describe("Alias for `start` (matches REST events naming)."),
197
- end_time: import_zod.z.string().datetime().optional().describe("Alias for `end` (matches REST events naming)."),
196
+ start: import_zod.z.string().datetime({ offset: true }).optional().describe("Range start (ISO 8601). Alias: start_time."),
197
+ end: import_zod.z.string().datetime({ offset: true }).optional().describe("Range end (ISO 8601). Alias: end_time."),
198
+ start_time: import_zod.z.string().datetime({ offset: true }).optional().describe("Alias for `start` (matches REST events naming)."),
199
+ end_time: import_zod.z.string().datetime({ offset: true }).optional().describe("Alias for `end` (matches REST events naming)."),
198
200
  duration: import_zod.z.enum(["15m", "30m", "45m", "1h", "2h"]).optional().describe("Requested slot length (15m/30m/45m/1h/2h). Preferred over the deprecated slot_duration. Defaults to 30m."),
199
201
  slot_duration: import_zod.z.enum(["15m", "30m", "45m", "1h", "2h"]).optional().describe("Deprecated alias for `duration` \u2014 minimum slot length. Prefer `duration`."),
200
202
  include_busy: import_zod.z.boolean().default(false).describe("Include busy blocks in response")
@@ -202,10 +204,10 @@ var GetAvailabilitySchema = import_zod.z.object({
202
204
  var FindMeetingTimeSchema = import_zod.z.object({
203
205
  agents: import_zod.z.array(import_zod.z.string()).min(1).optional().describe("Array of agent IDs to find common free time for. All agents must be free during the returned slots. Alias: agent_ids."),
204
206
  agent_ids: import_zod.z.array(import_zod.z.string()).min(1).optional().describe("Alias for `agents` (matches REST/scheduling-proposal naming)."),
205
- start: import_zod.z.string().datetime().optional().describe("Search range start (ISO 8601). Alias: start_time."),
206
- end: import_zod.z.string().datetime().optional().describe("Search range end (ISO 8601). Alias: end_time."),
207
- start_time: import_zod.z.string().datetime().optional().describe("Alias for `start` (matches REST events naming)."),
208
- end_time: import_zod.z.string().datetime().optional().describe("Alias for `end` (matches REST events naming)."),
207
+ start: import_zod.z.string().datetime({ offset: true }).optional().describe("Search range start (ISO 8601). Alias: start_time."),
208
+ end: import_zod.z.string().datetime({ offset: true }).optional().describe("Search range end (ISO 8601). Alias: end_time."),
209
+ start_time: import_zod.z.string().datetime({ offset: true }).optional().describe("Alias for `start` (matches REST events naming)."),
210
+ end_time: import_zod.z.string().datetime({ offset: true }).optional().describe("Alias for `end` (matches REST events naming)."),
209
211
  duration: import_zod.z.enum(["15m", "30m", "45m", "1h", "2h"]).optional().describe("Requested slot length (15m/30m/45m/1h/2h). Preferred over the deprecated slot_duration. Defaults to 30m."),
210
212
  slot_duration: import_zod.z.enum(["15m", "30m", "45m", "1h", "2h"]).optional().describe("Deprecated alias for `duration` \u2014 minimum slot length. Prefer `duration`."),
211
213
  calendars: import_zod.z.array(import_zod.z.string()).optional().describe("Additional shared calendar IDs to treat as busy"),
@@ -224,8 +226,8 @@ var GetCalendarContextSchema = import_zod.z.object({
224
226
  calendar_id: import_zod.z.string().describe("Calendar ID")
225
227
  });
226
228
  var proposalSlotSchema = import_zod.z.object({
227
- start_time: import_zod.z.string().datetime().describe("Slot start time (ISO 8601)"),
228
- end_time: import_zod.z.string().datetime().describe("Slot end time (ISO 8601), after start_time"),
229
+ start_time: import_zod.z.string().datetime({ offset: true }).describe("Slot start time (ISO 8601)"),
230
+ end_time: import_zod.z.string().datetime({ offset: true }).describe("Slot end time (ISO 8601), after start_time"),
229
231
  weight: import_zod.z.number().min(0).max(10).default(1).optional().describe("Preference for this slot, 0\u201310 (higher = more preferred). Used to rank candidate slots when the proposal is resolved. Defaults to 1."),
230
232
  calendar_id: import_zod.z.string().optional().describe("Calendar to create the event on if this slot is chosen. Defaults to the proposal's top-level calendar_id.")
231
233
  });
@@ -236,13 +238,13 @@ var CreateProposalSchema = import_zod.z.object({
236
238
  participant_agent_ids: import_zod.z.array(import_zod.z.string()).min(1).max(50).describe("Agent IDs invited to respond"),
237
239
  calendar_id: import_zod.z.string().describe("Calendar the resolved event will be created on"),
238
240
  slots: import_zod.z.array(proposalSlotSchema).min(1).max(20).describe("Candidate time slots (up to 20)"),
239
- expires_at: import_zod.z.string().datetime().optional().describe("Auto-cancel cutoff if unresolved")
241
+ expires_at: import_zod.z.string().datetime({ offset: true }).optional().describe("Auto-cancel cutoff if unresolved")
240
242
  });
241
243
  var ListProposalsSchema = import_zod.z.object({
242
244
  status: import_zod.z.enum(["pending", "resolving", "confirmed", "expired", "cancelled"]).optional().describe("Filter by proposal status"),
243
245
  organizer_agent_id: import_zod.z.string().optional().describe("Filter by organizer agent"),
244
246
  limit: import_zod.z.number().int().min(1).max(200).optional().describe("Max results (default 50)"),
245
- offset: import_zod.z.number().int().min(0).optional().describe("Pagination offset (default 0)")
247
+ offset: import_zod.z.number().int().min(0).optional().describe("Pagination offset, at most 10000 (default 0)")
246
248
  });
247
249
  var GetProposalSchema = import_zod.z.object({
248
250
  proposal_id: import_zod.z.string().describe("Proposal to fetch")
@@ -316,7 +318,7 @@ var AcceptTermsSchema = import_zod.z.object({
316
318
  });
317
319
  var ListWebhooksSchema = import_zod.z.object({
318
320
  limit: import_zod.z.number().int().min(1).max(100).default(20).describe("Max results to return"),
319
- offset: import_zod.z.number().int().min(0).default(0).describe("Pagination offset")
321
+ offset: import_zod.z.number().int().min(0).default(0).describe("Pagination offset, at most 10000")
320
322
  });
321
323
  var GetWebhookSchema = import_zod.z.object({
322
324
  webhook_id: import_zod.z.string().describe("Webhook subscription to fetch")
@@ -337,12 +339,12 @@ var DeleteWebhookSchema = import_zod.z.object({
337
339
  var ListWebhookDeliveriesSchema = import_zod.z.object({
338
340
  webhook_id: import_zod.z.string().describe("Webhook subscription whose deliveries to list"),
339
341
  limit: import_zod.z.number().int().min(1).max(100).default(20).describe("Max results to return"),
340
- offset: import_zod.z.number().int().min(0).default(0).describe("Pagination offset. Cannot be combined with cursor"),
342
+ offset: import_zod.z.number().int().min(0).default(0).describe("Pagination offset, at most 10000. Cannot be combined with cursor"),
341
343
  status: import_zod.z.enum(WEBHOOK_DELIVERY_STATUSES).optional().describe("Filter to a single delivery status"),
342
344
  include_payload: import_zod.z.boolean().optional().describe("Include the full event payload sent on each delivery"),
343
345
  event_type: import_zod.z.string().max(100).regex(/^[a-z_]+\.(?:[a-z_]+)?$/).optional().describe("An exact event type (event.created), or a prefix ending in a dot (event.) for a whole group"),
344
- created_after: import_zod.z.string().datetime().optional().describe("Only deliveries created at or after this time (ISO 8601, UTC)"),
345
- created_before: import_zod.z.string().datetime().optional().describe("Only deliveries created before this time (ISO 8601, UTC)"),
346
+ created_after: import_zod.z.string().datetime({ offset: true }).optional().describe("Only deliveries created at or after this time (ISO 8601)"),
347
+ created_before: import_zod.z.string().datetime({ offset: true }).optional().describe("Only deliveries created before this time (ISO 8601)"),
346
348
  delivery_id: import_zod.z.string().max(100).regex(/^whd_[A-Za-z0-9_-]+$/).optional().describe("Only the delivery with this id"),
347
349
  is_test: import_zod.z.boolean().optional().describe("true for test events only, false to leave them out"),
348
350
  cursor: import_zod.z.string().min(1).max(1024).optional().describe("The next_cursor from the previous page")
@@ -363,7 +365,7 @@ var ListICalSubscriptionsSchema = import_zod.z.object({
363
365
  agent_id: import_zod.z.string().describe("Agent ID whose iCal subscriptions to list"),
364
366
  status: import_zod.z.enum(["active", "error", "paused"]).optional().describe("Filter by subscription status"),
365
367
  limit: import_zod.z.number().int().min(1).max(200).default(50).describe("Max results to return"),
366
- offset: import_zod.z.number().int().min(0).default(0).describe("Pagination offset")
368
+ offset: import_zod.z.number().int().min(0).default(0).describe("Pagination offset, at most 10000")
367
369
  });
368
370
  var GetICalSubscriptionSchema = import_zod.z.object({
369
371
  subscription_id: import_zod.z.string().describe("iCal subscription ID to fetch")