@chronary/toolkit 1.6.3 → 1.7.1

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.js CHANGED
@@ -31,7 +31,7 @@ var ListCalendarsSchema = z.object({
31
31
  agent_id: 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."),
32
32
  include: z.enum(["all"]).optional().describe('Pass "all" to include calendars across all agents (Organization keys only)'),
33
33
  limit: z.number().int().min(1).max(200).default(50).describe("Max results to return"),
34
- offset: z.number().int().min(0).default(0).describe("Pagination offset")
34
+ offset: z.number().int().min(0).default(0).describe("Pagination offset, at most 10000")
35
35
  });
36
36
  var GetCalendarSchema = z.object({
37
37
  calendar_id: z.string().describe("Calendar ID to fetch")
@@ -55,7 +55,7 @@ var DeleteCalendarSchema = z.object({
55
55
  });
56
56
  var ListBookingPagesSchema = z.object({
57
57
  limit: z.number().int().min(1).max(200).default(50).describe("Max results to return"),
58
- offset: z.number().int().min(0).default(0).describe("Pagination offset")
58
+ offset: z.number().int().min(0).default(0).describe("Pagination offset, at most 10000")
59
59
  });
60
60
  var GetBookingPageSchema = z.object({
61
61
  booking_page_id: z.string().describe("Booking page ID to fetch (bkp_...)")
@@ -83,7 +83,7 @@ var ListEventsSchema = z.object({
83
83
  status: z.enum(["confirmed", "tentative", "cancelled", "hold"]).optional().describe("Filter by event status"),
84
84
  source: z.enum(["internal", "external_ical"]).optional().describe('Filter by source: "internal" (created via the API) or "external_ical" (synced from an iCal subscription)'),
85
85
  limit: z.number().int().min(1).max(200).default(50).describe("Max results to return"),
86
- offset: z.number().int().min(0).default(0).describe("Pagination offset"),
86
+ offset: z.number().int().min(0).default(0).describe("Pagination offset, at most 10000"),
87
87
  expand: 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.")
88
88
  });
89
89
  var ListOrgEventsSchema = z.object({
@@ -96,7 +96,7 @@ var ListOrgEventsSchema = z.object({
96
96
  q: z.string().optional().describe("Case-insensitive title search. Requires start_after and start_before at most 31 days apart"),
97
97
  expand: 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)."),
98
98
  limit: z.number().int().min(1).max(100).default(50).describe("Max results to return (1-100)"),
99
- offset: z.number().int().min(0).default(0).describe("Pagination offset")
99
+ offset: z.number().int().min(0).default(0).describe("Pagination offset, at most 10000")
100
100
  });
101
101
  var GetEventSchema = z.object({
102
102
  event_id: z.string().describe("Event ID to retrieve"),
@@ -113,7 +113,8 @@ var CreateEventSchema = z.object({
113
113
  reminders: z.array(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."),
114
114
  hold_expires_at: 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.'),
115
115
  hold_priority: 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.'),
116
- recurrence_rule: 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.')
116
+ recurrence_rule: 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.'),
117
+ timezone: 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.')
117
118
  });
118
119
  var UpdateEventSchema = z.object({
119
120
  event_id: z.string().describe("Event ID to update"),
@@ -126,7 +127,8 @@ var UpdateEventSchema = z.object({
126
127
  status: z.enum(["confirmed", "tentative", "cancelled"]).optional().describe("New event status"),
127
128
  metadata: z.record(z.string(), z.unknown()).optional().describe("Replacement metadata object"),
128
129
  reminders: z.array(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."),
129
- recurrence_rule: 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.")
130
+ recurrence_rule: 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."),
131
+ timezone: 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).')
130
132
  });
131
133
  var CancelEventSchema = z.object({
132
134
  event_id: z.string().describe("Event ID to cancel"),
@@ -148,7 +150,7 @@ var ListAgentsSchema = z.object({
148
150
  type: z.enum(["ai", "human", "resource"]).optional().describe("Filter by agent type"),
149
151
  status: z.enum(["active", "paused", "decommissioned"]).optional().describe("Filter by status"),
150
152
  limit: z.number().int().min(1).max(200).default(50).describe("Max results to return"),
151
- offset: z.number().int().min(0).default(0).describe("Pagination offset")
153
+ offset: z.number().int().min(0).default(0).describe("Pagination offset, at most 10000")
152
154
  });
153
155
  var GetAgentSchema = z.object({
154
156
  agent_id: z.string().describe("Agent ID to fetch")
@@ -216,7 +218,7 @@ var ListProposalsSchema = z.object({
216
218
  status: z.enum(["pending", "resolving", "confirmed", "expired", "cancelled"]).optional().describe("Filter by proposal status"),
217
219
  organizer_agent_id: z.string().optional().describe("Filter by organizer agent"),
218
220
  limit: z.number().int().min(1).max(200).optional().describe("Max results (default 50)"),
219
- offset: z.number().int().min(0).optional().describe("Pagination offset (default 0)")
221
+ offset: z.number().int().min(0).optional().describe("Pagination offset, at most 10000 (default 0)")
220
222
  });
221
223
  var GetProposalSchema = z.object({
222
224
  proposal_id: z.string().describe("Proposal to fetch")
@@ -290,7 +292,7 @@ var AcceptTermsSchema = z.object({
290
292
  });
291
293
  var ListWebhooksSchema = z.object({
292
294
  limit: z.number().int().min(1).max(100).default(20).describe("Max results to return"),
293
- offset: z.number().int().min(0).default(0).describe("Pagination offset")
295
+ offset: z.number().int().min(0).default(0).describe("Pagination offset, at most 10000")
294
296
  });
295
297
  var GetWebhookSchema = z.object({
296
298
  webhook_id: z.string().describe("Webhook subscription to fetch")
@@ -311,7 +313,7 @@ var DeleteWebhookSchema = z.object({
311
313
  var ListWebhookDeliveriesSchema = z.object({
312
314
  webhook_id: z.string().describe("Webhook subscription whose deliveries to list"),
313
315
  limit: z.number().int().min(1).max(100).default(20).describe("Max results to return"),
314
- offset: z.number().int().min(0).default(0).describe("Pagination offset. Cannot be combined with cursor"),
316
+ offset: z.number().int().min(0).default(0).describe("Pagination offset, at most 10000. Cannot be combined with cursor"),
315
317
  status: z.enum(WEBHOOK_DELIVERY_STATUSES).optional().describe("Filter to a single delivery status"),
316
318
  include_payload: z.boolean().optional().describe("Include the full event payload sent on each delivery"),
317
319
  event_type: 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"),
@@ -337,7 +339,7 @@ var ListICalSubscriptionsSchema = z.object({
337
339
  agent_id: z.string().describe("Agent ID whose iCal subscriptions to list"),
338
340
  status: z.enum(["active", "error", "paused"]).optional().describe("Filter by subscription status"),
339
341
  limit: z.number().int().min(1).max(200).default(50).describe("Max results to return"),
340
- offset: z.number().int().min(0).default(0).describe("Pagination offset")
342
+ offset: z.number().int().min(0).default(0).describe("Pagination offset, at most 10000")
341
343
  });
342
344
  var GetICalSubscriptionSchema = z.object({
343
345
  subscription_id: z.string().describe("iCal subscription ID to fetch")
@@ -1040,7 +1042,7 @@ var RAW_TOOL_DEFINITIONS = [
1040
1042
  // ── Scheduling proposals ───────────────────────────────────────
1041
1043
  {
1042
1044
  name: "create_proposal",
1043
- description: "Create a scheduling proposal \u2014 send a set of candidate time slots to one or more participant agents so they can accept, decline, or counter-propose. The organizer agent owns the proposal; once every participant responds, the system auto-resolves to the highest-scoring slot (or cancels if all decline). Requires an Organization key. Pro plan only.",
1045
+ description: "Create a scheduling proposal \u2014 send a set of candidate time slots to one or more participant agents so they can accept, decline, or counter-propose. The organizer agent owns the proposal; once every participant responds, the system auto-resolves to the highest-scoring slot (or cancels if all decline). Requires an Organization key and a Developer or Pro plan.",
1044
1046
  schema: CreateProposalSchema,
1045
1047
  annotations: { title: "Create Proposal", readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: false },
1046
1048
  execute: createExecutor(createProposal)
@@ -1061,21 +1063,21 @@ var RAW_TOOL_DEFINITIONS = [
1061
1063
  },
1062
1064
  {
1063
1065
  name: "respond_to_proposal",
1064
- description: 'Submit a response (accept / decline / counter) on behalf of one participant agent to an open proposal. An "accept" requires the slot id from the proposal; a "counter" can suggest alternative slots. When all participants have responded the proposal auto-resolves \u2014 no separate resolve call needed in the normal flow. Requires an Organization key. Pro plan only.',
1066
+ description: 'Submit a response (accept / decline / counter) on behalf of one participant agent to an open proposal. An "accept" requires the slot id from the proposal; a "counter" can suggest alternative slots. When all participants have responded the proposal auto-resolves \u2014 no separate resolve call needed in the normal flow. Requires an Organization key and a Developer or Pro plan.',
1065
1067
  schema: RespondToProposalSchema,
1066
1068
  annotations: { title: "Respond To Proposal", readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: false },
1067
1069
  execute: createExecutor(respondToProposal)
1068
1070
  },
1069
1071
  {
1070
1072
  name: "resolve_proposal",
1071
- description: 'Force-resolve an open proposal using responses collected so far. Picks the highest-scoring slot among those accepted by the most participants and creates a confirmed calendar event. If every response was "decline", the proposal is cancelled instead. Use when you want to close out a proposal without waiting for every participant. Requires an Organization key. Pro plan only.',
1073
+ description: 'Force-resolve an open proposal using responses collected so far. Picks the highest-scoring slot among those accepted by the most participants and creates a confirmed calendar event. If every response was "decline", the proposal is cancelled instead. Use when you want to close out a proposal without waiting for every participant. Requires an Organization key and a Developer or Pro plan.',
1072
1074
  schema: ResolveProposalSchema,
1073
1075
  annotations: { title: "Resolve Proposal", readOnlyHint: false, destructiveHint: false, idempotentHint: true, openWorldHint: false },
1074
1076
  execute: createExecutor(resolveProposal)
1075
1077
  },
1076
1078
  {
1077
1079
  name: "cancel_proposal",
1078
- description: 'Cancel an open proposal. Fires a proposal.cancelled webhook with reason="organizer_cancelled". Requires an Organization key. Pro plan only.',
1080
+ description: 'Cancel an open proposal. Fires a proposal.cancelled webhook with reason="organizer_cancelled". Requires an Organization key. Works on every plan, so an org that dropped to Free can still cancel proposals it made on a paid plan.',
1079
1081
  schema: CancelProposalSchema,
1080
1082
  annotations: { title: "Cancel Proposal", readOnlyHint: false, destructiveHint: true, idempotentHint: true, openWorldHint: false },
1081
1083
  execute: createExecutor(cancelProposal)