@chronary/toolkit 1.7.1 → 1.7.3

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/index.d.cts CHANGED
@@ -73,10 +73,36 @@ declare const CreateBookingPageSchema: z.ZodObject<{
73
73
  window_days: z.ZodOptional<z.ZodNumber>;
74
74
  min_notice_minutes: z.ZodOptional<z.ZodNumber>;
75
75
  timezone: z.ZodOptional<z.ZodString>;
76
- availability_constraints: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodObject<{
77
- start: z.ZodString;
78
- end: z.ZodString;
79
- }, z.core.$strip>>>>;
76
+ availability_constraints: z.ZodOptional<z.ZodNullable<z.ZodObject<{
77
+ mon: z.ZodOptional<z.ZodObject<{
78
+ start: z.ZodString;
79
+ end: z.ZodString;
80
+ }, z.core.$strip>>;
81
+ tue: z.ZodOptional<z.ZodObject<{
82
+ start: z.ZodString;
83
+ end: z.ZodString;
84
+ }, z.core.$strip>>;
85
+ wed: z.ZodOptional<z.ZodObject<{
86
+ start: z.ZodString;
87
+ end: z.ZodString;
88
+ }, z.core.$strip>>;
89
+ thu: z.ZodOptional<z.ZodObject<{
90
+ start: z.ZodString;
91
+ end: z.ZodString;
92
+ }, z.core.$strip>>;
93
+ fri: z.ZodOptional<z.ZodObject<{
94
+ start: z.ZodString;
95
+ end: z.ZodString;
96
+ }, z.core.$strip>>;
97
+ sat: z.ZodOptional<z.ZodObject<{
98
+ start: z.ZodString;
99
+ end: z.ZodString;
100
+ }, z.core.$strip>>;
101
+ sun: z.ZodOptional<z.ZodObject<{
102
+ start: z.ZodString;
103
+ end: z.ZodString;
104
+ }, z.core.$strip>>;
105
+ }, z.core.$strip>>>;
80
106
  active: z.ZodOptional<z.ZodBoolean>;
81
107
  }, z.core.$strip>;
82
108
  declare const DeleteBookingPageSchema: z.ZodObject<{
package/dist/index.d.ts CHANGED
@@ -73,10 +73,36 @@ declare const CreateBookingPageSchema: z.ZodObject<{
73
73
  window_days: z.ZodOptional<z.ZodNumber>;
74
74
  min_notice_minutes: z.ZodOptional<z.ZodNumber>;
75
75
  timezone: z.ZodOptional<z.ZodString>;
76
- availability_constraints: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodObject<{
77
- start: z.ZodString;
78
- end: z.ZodString;
79
- }, z.core.$strip>>>>;
76
+ availability_constraints: z.ZodOptional<z.ZodNullable<z.ZodObject<{
77
+ mon: z.ZodOptional<z.ZodObject<{
78
+ start: z.ZodString;
79
+ end: z.ZodString;
80
+ }, z.core.$strip>>;
81
+ tue: z.ZodOptional<z.ZodObject<{
82
+ start: z.ZodString;
83
+ end: z.ZodString;
84
+ }, z.core.$strip>>;
85
+ wed: z.ZodOptional<z.ZodObject<{
86
+ start: z.ZodString;
87
+ end: z.ZodString;
88
+ }, z.core.$strip>>;
89
+ thu: z.ZodOptional<z.ZodObject<{
90
+ start: z.ZodString;
91
+ end: z.ZodString;
92
+ }, z.core.$strip>>;
93
+ fri: z.ZodOptional<z.ZodObject<{
94
+ start: z.ZodString;
95
+ end: z.ZodString;
96
+ }, z.core.$strip>>;
97
+ sat: z.ZodOptional<z.ZodObject<{
98
+ start: z.ZodString;
99
+ end: z.ZodString;
100
+ }, z.core.$strip>>;
101
+ sun: z.ZodOptional<z.ZodObject<{
102
+ start: z.ZodString;
103
+ end: z.ZodString;
104
+ }, z.core.$strip>>;
105
+ }, z.core.$strip>>>;
80
106
  active: z.ZodOptional<z.ZodBoolean>;
81
107
  }, z.core.$strip>;
82
108
  declare const DeleteBookingPageSchema: z.ZodObject<{
package/dist/index.js CHANGED
@@ -193,6 +193,20 @@ var UpdateCalendarSchema = z.object({
193
193
  var DeleteCalendarSchema = z.object({
194
194
  calendar_id: z.string().describe("Calendar ID to delete")
195
195
  });
196
+ var timeOfDay = z.string().regex(/^([01]\d|2[0-3]):[0-5]\d$/, "must be HH:MM in 24-hour time");
197
+ var workingHoursDaySchema = z.object({
198
+ start: timeOfDay.describe('Start of the working window, HH:MM 24-hour, in the timezone of the availability rules or booking page it belongs to (e.g. "09:00")'),
199
+ end: timeOfDay.describe('End of the working window, HH:MM 24-hour, after start (e.g. "17:00")')
200
+ }).refine((v) => v.end > v.start, "end must be after start").describe("A single day's working hours window");
201
+ var workingHoursSchema = z.object({
202
+ mon: workingHoursDaySchema.optional(),
203
+ tue: workingHoursDaySchema.optional(),
204
+ wed: workingHoursDaySchema.optional(),
205
+ thu: workingHoursDaySchema.optional(),
206
+ fri: workingHoursDaySchema.optional(),
207
+ sat: workingHoursDaySchema.optional(),
208
+ sun: workingHoursDaySchema.optional()
209
+ }).refine((v) => Object.keys(v).length > 0, "at least one day must be specified").nullable();
196
210
  var ListBookingPagesSchema = z.object({
197
211
  limit: z.number().int().min(1).max(200).default(50).describe("Max results to return"),
198
212
  offset: z.number().int().min(0).default(0).describe("Pagination offset, at most 10000")
@@ -201,7 +215,7 @@ var GetBookingPageSchema = z.object({
201
215
  booking_page_id: z.string().describe("Booking page ID to fetch (bkp_...)")
202
216
  });
203
217
  var CreateBookingPageSchema = z.object({
204
- calendar_id: z.string().describe("Calendar a booking resolves to (from create_calendar/list_calendars)."),
218
+ calendar_id: z.string().describe("Calendar ID a booking resolves to."),
205
219
  title: z.string().min(1).max(200).describe("Meeting title shown on the page."),
206
220
  description: z.string().max(2e3).optional().describe("Optional description shown to the booker."),
207
221
  duration_minutes: z.number().int().min(5).max(480).optional().describe("Slot length in minutes (default 30)."),
@@ -209,7 +223,8 @@ var CreateBookingPageSchema = z.object({
209
223
  window_days: z.number().int().min(1).max(365).optional().describe("How far ahead bookings are allowed (default 14)."),
210
224
  min_notice_minutes: z.number().int().min(0).max(40320).optional().describe("Minimum lead time before a bookable slot (default 0)."),
211
225
  timezone: z.string().min(1).max(64).optional().describe("IANA timezone for display + working hours (default UTC)."),
212
- availability_constraints: z.record(z.string(), z.object({ start: z.string(), end: z.string() })).nullable().optional().describe('Weekly working hours, e.g. {"mon":{"start":"09:00","end":"17:00"}}. Omit/null for any time in the window.'),
226
+ // Same shape the hosted API validates (#2525).
227
+ availability_constraints: workingHoursSchema.optional().describe('Weekly working hours keyed by day (mon, tue, wed, thu, fri, sat, sun; a day left out takes no bookings), each {"start":"HH:MM","end":"HH:MM"} in 24-hour time with end after start, e.g. {"mon":{"start":"09:00","end":"17:00"}}. Omit/null for any time in the window.'),
213
228
  active: z.boolean().optional().describe("Whether the page accepts bookings (default true).")
214
229
  });
215
230
  var DeleteBookingPageSchema = z.object({
@@ -272,7 +287,7 @@ var UpdateEventSchema = z.object({
272
287
  });
273
288
  var CancelEventSchema = z.object({
274
289
  event_id: z.string().describe("Event ID to cancel"),
275
- 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."),
290
+ calendar_id: z.string().optional().describe("Calendar ID that owns the event. Optional \u2014 if omitted the calendar is resolved from the event."),
276
291
  occurrence_start: 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.")
277
292
  });
278
293
  var ConfirmEventSchema = z.object({
@@ -344,7 +359,11 @@ var proposalSlotSchema = z.object({
344
359
  end_time: z.string().datetime({ offset: true }).describe("Slot end time (ISO 8601), after start_time"),
345
360
  weight: 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."),
346
361
  calendar_id: z.string().optional().describe("Calendar to create the event on if this slot is chosen. Defaults to the proposal's top-level calendar_id.")
347
- });
362
+ }).refine(
363
+ // Same rule as the API (#2538): a slot must end after it starts.
364
+ (v) => new Date(v.end_time).getTime() > new Date(v.start_time).getTime(),
365
+ "end_time must be after start_time"
366
+ );
348
367
  var CreateProposalSchema = z.object({
349
368
  title: z.string().min(1).max(500).describe("Short description of what the meeting is about"),
350
369
  description: z.string().max(5e3).optional().describe("Longer context/agenda"),
@@ -377,20 +396,6 @@ var ResolveProposalSchema = z.object({
377
396
  var CancelProposalSchema = z.object({
378
397
  proposal_id: z.string().describe("Proposal to cancel")
379
398
  });
380
- var timeOfDay = z.string().regex(/^([01]\d|2[0-3]):[0-5]\d$/, "must be HH:MM in 24-hour time");
381
- var workingHoursDaySchema = z.object({
382
- start: timeOfDay.describe('Start of the working window, HH:MM 24-hour, in the rules timezone (e.g. "09:00")'),
383
- end: timeOfDay.describe('End of the working window, HH:MM 24-hour, after start (e.g. "17:00")')
384
- }).refine((v) => v.end > v.start, "end must be after start").describe("A single day's working hours window");
385
- var workingHoursSchema = z.object({
386
- mon: workingHoursDaySchema.optional(),
387
- tue: workingHoursDaySchema.optional(),
388
- wed: workingHoursDaySchema.optional(),
389
- thu: workingHoursDaySchema.optional(),
390
- fri: workingHoursDaySchema.optional(),
391
- sat: workingHoursDaySchema.optional(),
392
- sun: workingHoursDaySchema.optional()
393
- }).refine((v) => Object.keys(v).length > 0, "at least one day must be specified").nullable();
394
399
  var SetAvailabilityRulesSchema = z.object({
395
400
  calendar_id: z.string().describe("Calendar to configure"),
396
401
  buffer_before_minutes: z.number().int().min(0).max(120).default(0).describe("Minutes of buffer before each event (0\u2013120)"),
@@ -465,7 +470,7 @@ var ListWebhookDeliveriesSchema = z.object({
465
470
  });
466
471
  var GetWebhookDeliverySchema = z.object({
467
472
  webhook_id: z.string().describe("Webhook subscription the delivery belongs to"),
468
- delivery_id: z.string().describe("Delivery ID (whd_...) from list_webhook_deliveries")
473
+ delivery_id: z.string().describe("Delivery ID (whd_...)")
469
474
  });
470
475
  var SendTestWebhookSchema = z.object({
471
476
  webhook_id: z.string().describe("Webhook subscription to send the test event to"),
@@ -989,14 +994,14 @@ var RAW_TOOL_DEFINITIONS = [
989
994
  name: "create_calendar",
990
995
  description: 'Create a calendar to hold events and track availability. Calendars are required before creating events \u2014 call this first when setting up a new agent. An agent can have multiple calendars (e.g. "Work", "Personal"). Org-level calendars (no agent_id) can be used as shared resources like meeting rooms.',
991
996
  schema: CreateCalendarSchema,
992
- annotations: { title: "Create Calendar", readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: false },
997
+ annotations: { title: "Create Calendar", readOnlyHint: false, destructiveHint: true, idempotentHint: false, openWorldHint: false },
993
998
  execute: createExecutor(createCalendar)
994
999
  },
995
1000
  {
996
1001
  name: "update_calendar",
997
1002
  description: "Update a calendar's name, timezone, agent status, default reminders, or metadata. Agent keys may only update calendars owned by their agent.",
998
1003
  schema: UpdateCalendarSchema,
999
- annotations: { title: "Update Calendar", readOnlyHint: false, destructiveHint: false, idempotentHint: true, openWorldHint: false },
1004
+ annotations: { title: "Update Calendar", readOnlyHint: false, destructiveHint: true, idempotentHint: true, openWorldHint: false },
1000
1005
  execute: createExecutor(updateCalendar)
1001
1006
  },
1002
1007
  {
@@ -1011,7 +1016,7 @@ var RAW_TOOL_DEFINITIONS = [
1011
1016
  name: "create_booking_page",
1012
1017
  description: "Create a public booking page (a hosted scheduling link) for a calendar. Returns a booking_url to send to a human; when they pick a slot, a confirmed event is created on the calendar and an event.created webhook fires with a booking_page_id field. Set availability_constraints to restrict to weekly working hours; existing calendar events always block slots.",
1013
1018
  schema: CreateBookingPageSchema,
1014
- annotations: { title: "Create Booking Page", readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: false },
1019
+ annotations: { title: "Create Booking Page", readOnlyHint: false, destructiveHint: true, idempotentHint: false, openWorldHint: false },
1015
1020
  execute: createExecutor(createBookingPage)
1016
1021
  },
1017
1022
  {
@@ -1046,7 +1051,7 @@ var RAW_TOOL_DEFINITIONS = [
1046
1051
  },
1047
1052
  {
1048
1053
  name: "list_org_events",
1049
- description: "List events across all of the organization's calendars in one call, ordered by start time (an Agent key sees only its agent's calendars). Narrow with `calendar_ids`, `agent_id`, a `start_after`/`start_before` window, `status` and `source`. `q` searches titles (case-insensitive) and needs both window bounds at most 31 days apart. Use list_events for one calendar.",
1054
+ description: "List events across all of the organization's calendars in one call, ordered by start time (an Agent key sees only its agent's calendars). Narrow with `calendar_ids`, `agent_id`, a `start_after`/`start_before` window, `status` and `source`. `q` searches titles (case-insensitive) and needs both window bounds at most 31 days apart. Page with the returned next_cursor.",
1050
1055
  schema: ListOrgEventsSchema,
1051
1056
  annotations: { title: "List Organization Events", readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
1052
1057
  untrustedFields: EVENT_UNTRUSTED_FIELDS,
@@ -1062,16 +1067,16 @@ var RAW_TOOL_DEFINITIONS = [
1062
1067
  },
1063
1068
  {
1064
1069
  name: "create_event",
1065
- description: `Create a booking, appointment, meeting, hold, or any scheduled event on a calendar. The calendar_id comes from create_calendar or list_events. Once created, this event blocks the agent's availability during that time and appears in availability queries. Use status="hold" with hold_expires_at to tentatively reserve a slot that auto-releases on TTL.`,
1070
+ description: `Create a booking, appointment, meeting, hold, or any scheduled event on a calendar. Once created, this event blocks the agent's availability during that time and appears in availability queries. Use status="hold" with hold_expires_at to tentatively reserve a slot that auto-releases on TTL.`,
1066
1071
  schema: CreateEventSchema,
1067
- annotations: { title: "Create Event", readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: false },
1072
+ annotations: { title: "Create Event", readOnlyHint: false, destructiveHint: true, idempotentHint: false, openWorldHint: false },
1068
1073
  execute: createExecutor(createEvent)
1069
1074
  },
1070
1075
  {
1071
1076
  name: "update_event",
1072
- description: "Reschedule or edit an event \u2014 change its title, description, start/end times, location, status, reminders, or metadata. Use this to move an appointment to a new time or update its details. Provide only the fields you want to change. Holds cannot be edited via this tool (use confirm_event / release_event). External iCal events are read-only. `calendar_id` is optional \u2014 if omitted it is resolved from the event.",
1077
+ description: "Reschedule or edit an event \u2014 change its title, description, start/end times, location, status, reminders, or metadata. Use this to move an appointment to a new time or update its details. Provide only the fields you want to change. Holds cannot be edited; confirm or release them instead. External iCal events are read-only. `calendar_id` is optional \u2014 if omitted it is resolved from the event.",
1073
1078
  schema: UpdateEventSchema,
1074
- annotations: { title: "Update Event", readOnlyHint: false, destructiveHint: false, idempotentHint: true, openWorldHint: false },
1079
+ annotations: { title: "Update Event", readOnlyHint: false, destructiveHint: true, idempotentHint: true, openWorldHint: false },
1075
1080
  untrustedFields: EVENT_UNTRUSTED_FIELDS,
1076
1081
  execute: createExecutor(updateEvent)
1077
1082
  },
@@ -1087,7 +1092,7 @@ var RAW_TOOL_DEFINITIONS = [
1087
1092
  name: "confirm_event",
1088
1093
  description: 'Promote a held event to a confirmed booking. The event must currently have status="hold" and its hold_expires_at must not have passed. After confirmation, event.started and event.ended lifecycle webhooks fire at the scheduled times.',
1089
1094
  schema: ConfirmEventSchema,
1090
- annotations: { title: "Confirm Event", readOnlyHint: false, destructiveHint: false, idempotentHint: true, openWorldHint: false },
1095
+ annotations: { title: "Confirm Event", readOnlyHint: false, destructiveHint: true, idempotentHint: true, openWorldHint: false },
1091
1096
  untrustedFields: EVENT_UNTRUSTED_FIELDS,
1092
1097
  execute: createExecutor(confirmEvent)
1093
1098
  },
@@ -1103,7 +1108,7 @@ var RAW_TOOL_DEFINITIONS = [
1103
1108
  name: "create_agent",
1104
1109
  description: "Register your agent (AI assistant, human participant, or resource) with Chronary so it can own calendars, events, and webhooks.",
1105
1110
  schema: CreateAgentSchema,
1106
- annotations: { title: "Create Agent", readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: false },
1111
+ annotations: { title: "Create Agent", readOnlyHint: false, destructiveHint: true, idempotentHint: false, openWorldHint: false },
1107
1112
  execute: createExecutor(createAgent)
1108
1113
  },
1109
1114
  {
@@ -1122,14 +1127,14 @@ var RAW_TOOL_DEFINITIONS = [
1122
1127
  },
1123
1128
  {
1124
1129
  name: "update_agent",
1125
- description: "Update an agent's name, description, metadata, or status (active/paused). Requires an Organization key \u2014 Agent keys cannot mutate agents.",
1130
+ description: "Update an agent's name, description, metadata, or status (active/paused). Setting status on a decommissioned agent restores it and makes its calendars writable again; that is refused with quota_exceeded when the agent, its calendars or their recurring series would put the organization over the plan's agent, calendar or recurring series limit. Requires an Organization key \u2014 Agent keys cannot mutate agents.",
1126
1131
  schema: UpdateAgentSchema,
1127
- annotations: { title: "Update Agent", readOnlyHint: false, destructiveHint: false, idempotentHint: true, openWorldHint: false },
1132
+ annotations: { title: "Update Agent", readOnlyHint: false, destructiveHint: true, idempotentHint: true, openWorldHint: false },
1128
1133
  execute: createExecutor(updateAgent)
1129
1134
  },
1130
1135
  {
1131
1136
  name: "delete_agent",
1132
- description: "Decommission an agent. This marks the agent as decommissioned and revokes all of its Agent keys. Requires an Organization key \u2014 Agent keys cannot delete agents.",
1137
+ description: "Decommission an agent. This marks the agent as decommissioned and revokes all of its Agent keys. Its calendars and events are kept but stop counting toward the plan's calendar limit, and they are read-only (writes return agent_inactive) until the agent is restored by setting its status again (active or paused). Requires an Organization key \u2014 Agent keys cannot delete agents.",
1133
1138
  schema: DeleteAgentSchema,
1134
1139
  annotations: { title: "Delete Agent", readOnlyHint: false, destructiveHint: true, idempotentHint: true, openWorldHint: false },
1135
1140
  execute: createExecutor(deleteAgent)
@@ -1153,7 +1158,7 @@ var RAW_TOOL_DEFINITIONS = [
1153
1158
  name: "create_connection_link",
1154
1159
  description: "Request human setup of Google Calendar or Microsoft Outlook for a Chronary calendar. Give setup_url to a human; the agent never receives OAuth credentials, provider calendar names, or event data. When the human finishes, the linked account becomes a Connection, listed under Human calendars in the Chronary console. The secret URL is returned only on first creation. If reused=true and setup_url is null, retain the original URL or cancel this link and create a replacement.",
1155
1160
  schema: CreateConnectionLinkSchema,
1156
- annotations: { title: "Create Human Calendar Setup Link", readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: true },
1161
+ annotations: { title: "Create Human Calendar Setup Link", readOnlyHint: false, destructiveHint: true, idempotentHint: false, openWorldHint: true },
1157
1162
  execute: createExecutor(createConnectionLink)
1158
1163
  },
1159
1164
  {
@@ -1173,7 +1178,7 @@ var RAW_TOOL_DEFINITIONS = [
1173
1178
  // ── Calendar context ───────────────────────────────────────────
1174
1179
  {
1175
1180
  name: "get_calendar_context",
1176
- description: `Get a calendar's temporal context in a single call: the current event (if one is happening now), the next upcoming event, recent past events, a short upcoming window, and the owning agent's status (idle/working/waiting/error). Use this to answer "what is this agent doing right now?" without issuing multiple list_events queries.`,
1181
+ description: `Get a calendar's temporal context in a single call: the current event (if one is happening now), the next upcoming event, recent past events, a short upcoming window, and the owning agent's status (idle/working/waiting/error). Use this to answer "what is this agent doing right now?" without listing events separately. Recurring series appear as their occurrences (with recurringEventId); when events overlap, the current event is the most recently started.`,
1177
1182
  schema: GetCalendarContextSchema,
1178
1183
  annotations: { title: "Get Calendar Context", readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
1179
1184
  untrustedFields: EVENT_UNTRUSTED_FIELDS,
@@ -1184,7 +1189,7 @@ var RAW_TOOL_DEFINITIONS = [
1184
1189
  name: "create_proposal",
1185
1190
  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.",
1186
1191
  schema: CreateProposalSchema,
1187
- annotations: { title: "Create Proposal", readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: false },
1192
+ annotations: { title: "Create Proposal", readOnlyHint: false, destructiveHint: true, idempotentHint: false, openWorldHint: false },
1188
1193
  execute: createExecutor(createProposal)
1189
1194
  },
1190
1195
  {
@@ -1203,16 +1208,16 @@ var RAW_TOOL_DEFINITIONS = [
1203
1208
  },
1204
1209
  {
1205
1210
  name: "respond_to_proposal",
1206
- 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.',
1211
+ 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. The result is the saved response plus auto_resolved (confirmed / cancelled / null) and auto_resolve_error: if the auto-resolve fails, the response is still saved and auto_resolve_error says what to do next (usually: resolve the proposal once the cause is fixed). Do not respond again. Requires an Organization key and a Developer or Pro plan.',
1207
1212
  schema: RespondToProposalSchema,
1208
- annotations: { title: "Respond To Proposal", readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: false },
1213
+ annotations: { title: "Respond To Proposal", readOnlyHint: false, destructiveHint: true, idempotentHint: false, openWorldHint: false },
1209
1214
  execute: createExecutor(respondToProposal)
1210
1215
  },
1211
1216
  {
1212
1217
  name: "resolve_proposal",
1213
1218
  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.',
1214
1219
  schema: ResolveProposalSchema,
1215
- annotations: { title: "Resolve Proposal", readOnlyHint: false, destructiveHint: false, idempotentHint: true, openWorldHint: false },
1220
+ annotations: { title: "Resolve Proposal", readOnlyHint: false, destructiveHint: true, idempotentHint: true, openWorldHint: false },
1216
1221
  execute: createExecutor(resolveProposal)
1217
1222
  },
1218
1223
  {
@@ -1227,7 +1232,7 @@ var RAW_TOOL_DEFINITIONS = [
1227
1232
  name: "set_availability_rules",
1228
1233
  description: "Set or replace the availability rules on a calendar \u2014 buffer times before/after events and optional per-day working hours. When these rules are set, every availability query on this calendar automatically applies them (busy-block expansion for buffers, masking outside working hours). Upsert: overwrites any existing rules.",
1229
1234
  schema: SetAvailabilityRulesSchema,
1230
- annotations: { title: "Set Availability Rules", readOnlyHint: false, destructiveHint: false, idempotentHint: true, openWorldHint: false },
1235
+ annotations: { title: "Set Availability Rules", readOnlyHint: false, destructiveHint: true, idempotentHint: true, openWorldHint: false },
1231
1236
  execute: createExecutor(setAvailabilityRules)
1232
1237
  },
1233
1238
  {
@@ -1263,7 +1268,7 @@ var RAW_TOOL_DEFINITIONS = [
1263
1268
  name: "create_webhook",
1264
1269
  description: "Create a webhook subscription so the org receives HTTP POST notifications when events occur (e.g. event.created, proposal.confirmed). The signing secret is returned ONCE in this response \u2014 store it to verify the HMAC-SHA256 signature on delivered payloads. Requires an Organization key.",
1265
1270
  schema: CreateWebhookSchema,
1266
- annotations: { title: "Create Webhook", readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: true },
1271
+ annotations: { title: "Create Webhook", readOnlyHint: false, destructiveHint: true, idempotentHint: false, openWorldHint: true },
1267
1272
  execute: createExecutor(createWebhook)
1268
1273
  },
1269
1274
  {
@@ -1298,16 +1303,16 @@ var RAW_TOOL_DEFINITIONS = [
1298
1303
  },
1299
1304
  {
1300
1305
  name: "send_test_webhook",
1301
- description: "Send a signed sample payload of one event type to a webhook endpoint, to check that it receives and verifies deliveries. The delivery is marked is_test, carries the X-Chronary-Test: 1 header, makes one attempt, does not count toward the monthly delivery quota and is sent even when the endpoint is paused or disabled. The endpoint must subscribe to the event type. Poll get_webhook_delivery with the returned delivery_id for the result. Limited to 10 per minute. Requires an Organization key.",
1306
+ description: "Send a signed sample payload of one event type to a webhook endpoint, to check that it receives and verifies deliveries. The delivery is marked is_test, carries the X-Chronary-Test: 1 header, makes one attempt, does not count toward the monthly delivery quota and is sent even when the endpoint is paused or disabled. The endpoint must subscribe to the event type. The outcome is recorded on the returned delivery_id. Limited to 10 per minute. Requires an Organization key.",
1302
1307
  schema: SendTestWebhookSchema,
1303
- annotations: { title: "Send Test Webhook", readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: true },
1308
+ annotations: { title: "Send Test Webhook", readOnlyHint: false, destructiveHint: true, idempotentHint: false, openWorldHint: true },
1304
1309
  execute: createExecutor(sendTestWebhook)
1305
1310
  },
1306
1311
  {
1307
1312
  name: "replay_webhook_delivery",
1308
- description: "Send a failed or dropped webhook delivery again, as a new delivery with a new delivery_id. The stored payload goes out unchanged (same event id), signed with the endpoint's current secret, with an X-Chronary-Replay-Of header naming the original delivery. Only failed or dropped deliveries that are not test events can be replayed, the endpoint must be active, and the payload must still be stored (30 days). The replay follows the normal retry schedule and counts toward the monthly delivery quota. Poll get_webhook_delivery with the returned delivery_id for the result. Limited to 30 per minute. Requires a Developer or Pro plan and an Organization key.",
1313
+ description: "Send a failed or dropped webhook delivery again, as a new delivery with a new delivery_id. The stored payload goes out unchanged (same event id), signed with the endpoint's current secret, with an X-Chronary-Replay-Of header naming the original delivery. Only failed or dropped deliveries that are not test events can be replayed, the endpoint must be active, and the payload must still be stored (30 days). The replay follows the normal retry schedule and counts toward the monthly delivery quota. The outcome is recorded on the returned delivery_id. Limited to 30 per minute. Requires a Developer or Pro plan and an Organization key.",
1309
1314
  schema: ReplayWebhookDeliverySchema,
1310
- annotations: { title: "Replay Webhook Delivery", readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: true },
1315
+ annotations: { title: "Replay Webhook Delivery", readOnlyHint: false, destructiveHint: true, idempotentHint: false, openWorldHint: true },
1311
1316
  execute: createExecutor(replayWebhookDelivery)
1312
1317
  },
1313
1318
  // ── iCal Subscriptions ─────────────────────────────────────────
@@ -1329,14 +1334,14 @@ var RAW_TOOL_DEFINITIONS = [
1329
1334
  name: "subscribe_ical",
1330
1335
  description: "Link an external iCal feed (e.g. a human's Google Calendar) to an agent's calendar so external events appear in availability calculations. The target calendar must be owned by the specified agent \u2014 create the calendar with that agent_id first (org-level calendars without an agent_id cannot host external iCal subscriptions; create a dedicated per-agent calendar for sync targets).",
1331
1336
  schema: SubscribeICalSchema,
1332
- annotations: { title: "Subscribe iCal", readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: true },
1337
+ annotations: { title: "Subscribe iCal", readOnlyHint: false, destructiveHint: true, idempotentHint: false, openWorldHint: true },
1333
1338
  execute: createExecutor(subscribeICal)
1334
1339
  },
1335
1340
  {
1336
1341
  name: "update_ical_subscription",
1337
1342
  description: "Update an external iCal feed subscription \u2014 change its label or its feed URL. Changing the URL forces a full re-sync on the next poll.",
1338
1343
  schema: UpdateICalSubscriptionSchema,
1339
- annotations: { title: "Update iCal Subscription", readOnlyHint: false, destructiveHint: false, idempotentHint: true, openWorldHint: true },
1344
+ annotations: { title: "Update iCal Subscription", readOnlyHint: false, destructiveHint: true, idempotentHint: true, openWorldHint: true },
1340
1345
  execute: createExecutor(updateICalSubscription)
1341
1346
  },
1342
1347
  {
@@ -1348,23 +1353,23 @@ var RAW_TOOL_DEFINITIONS = [
1348
1353
  },
1349
1354
  {
1350
1355
  name: "sync_ical_subscription",
1351
- description: 'Start an immediate fetch of an external iCal feed instead of waiting for the next scheduled poll. Returns {"status":"syncing"} as soon as the fetch has started; call get_ical_subscription a few seconds later to read last_synced_at and last_error. A paused feed must be resumed first; one manual sync per feed per minute.',
1356
+ description: 'Start an immediate fetch of an external iCal feed instead of waiting for the next scheduled poll. Returns {"status":"syncing"} as soon as the fetch has started; last_synced_at and last_error on the subscription update when the fetch finishes, usually within a few seconds. A paused feed must be resumed first; one manual sync per feed per minute on paid plans, per 15 minutes on Free.',
1352
1357
  schema: SyncICalSubscriptionSchema,
1353
- annotations: { title: "Sync iCal Subscription", readOnlyHint: false, destructiveHint: false, idempotentHint: true, openWorldHint: true },
1358
+ annotations: { title: "Sync iCal Subscription", readOnlyHint: false, destructiveHint: true, idempotentHint: true, openWorldHint: true },
1354
1359
  execute: createExecutor(syncICalSubscription)
1355
1360
  },
1356
1361
  {
1357
1362
  name: "pause_ical_subscription",
1358
1363
  description: "Pause an external iCal feed subscription: scheduled polls skip it and manual syncs are refused until it is resumed. Busy blocks already imported stay. Pausing a paused feed changes nothing. Returns the subscription.",
1359
1364
  schema: PauseICalSubscriptionSchema,
1360
- annotations: { title: "Pause iCal Subscription", readOnlyHint: false, destructiveHint: false, idempotentHint: true, openWorldHint: false },
1365
+ annotations: { title: "Pause iCal Subscription", readOnlyHint: false, destructiveHint: true, idempotentHint: true, openWorldHint: false },
1361
1366
  execute: createExecutor(pauseICalSubscription)
1362
1367
  },
1363
1368
  {
1364
1369
  name: "resume_ical_subscription",
1365
1370
  description: "Resume a paused or failing external iCal feed subscription: it returns to scheduled polling and its last_error is cleared. Resuming an active feed changes nothing. Returns the subscription.",
1366
1371
  schema: ResumeICalSubscriptionSchema,
1367
- annotations: { title: "Resume iCal Subscription", readOnlyHint: false, destructiveHint: false, idempotentHint: true, openWorldHint: false },
1372
+ annotations: { title: "Resume iCal Subscription", readOnlyHint: false, destructiveHint: true, idempotentHint: true, openWorldHint: false },
1368
1373
  execute: createExecutor(resumeICalSubscription)
1369
1374
  },
1370
1375
  // ── Scoped keys ────────────────────────────────────────────────
@@ -1372,7 +1377,7 @@ var RAW_TOOL_DEFINITIONS = [
1372
1377
  name: "create_scoped_key",
1373
1378
  description: "Create an Agent key (chr_ak_*) that can only act on behalf of a single agent. Use this to self-provision or rotate per-agent credentials. The plaintext key is returned exactly once in the response \u2014 store it immediately, it cannot be retrieved later. Requires an Organization key.",
1374
1379
  schema: CreateScopedKeySchema,
1375
- annotations: { title: "Create Scoped Key", readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: false },
1380
+ annotations: { title: "Create Scoped Key", readOnlyHint: false, destructiveHint: true, idempotentHint: false, openWorldHint: false },
1376
1381
  execute: createExecutor(createScopedKey)
1377
1382
  },
1378
1383
  {
@@ -1402,7 +1407,7 @@ var RAW_TOOL_DEFINITIONS = [
1402
1407
  name: "accept_terms",
1403
1408
  description: "Re-accept the current Chronary terms of service on behalf of the calling org. Use this when responses carry the Chronary-Terms-Upgrade-Required header \u2014 a material ToS bump otherwise leaves MCP-only agents stuck without a console session. Pass the current tos_version (read it from GET /v1/auth/terms/current). Requires an Organization key (chr_sk_*); Agent keys cannot accept org-wide terms.",
1404
1409
  schema: AcceptTermsSchema,
1405
- annotations: { title: "Accept Terms", readOnlyHint: false, destructiveHint: false, idempotentHint: true, openWorldHint: false },
1410
+ annotations: { title: "Accept Terms", readOnlyHint: false, destructiveHint: true, idempotentHint: true, openWorldHint: false },
1406
1411
  execute: createExecutor(acceptTerms)
1407
1412
  },
1408
1413
  // ── Usage ──────────────────────────────────────────────────────
@@ -1430,9 +1435,9 @@ var RAW_TOOL_DEFINITIONS = [
1430
1435
  },
1431
1436
  {
1432
1437
  name: "request_upgrade",
1433
- description: "Ask your human to upgrade this Chronary account to Pro. Returns approval_url \u2014 give it to your human; only a human can pay. If reused=true a request is already pending \u2014 do not call again; poll get_upgrade_request at most once a minute. The link opens the Billing page in the Chronary console.",
1438
+ description: "Ask your human to upgrade this Chronary account to the next plan up. Returns approval_url \u2014 give it to your human; only a human can pay. If reused=true a request is already pending \u2014 do not call again; check the status of the request at most once a minute. The link opens the Billing page in the Chronary console.",
1434
1439
  schema: RequestUpgradeSchema,
1435
- annotations: { title: "Request Upgrade", readOnlyHint: false, destructiveHint: false, idempotentHint: true, openWorldHint: false },
1440
+ annotations: { title: "Request Upgrade", readOnlyHint: false, destructiveHint: true, idempotentHint: true, openWorldHint: false },
1436
1441
  execute: createExecutor(requestUpgrade)
1437
1442
  },
1438
1443
  {
@@ -1446,7 +1451,7 @@ var RAW_TOOL_DEFINITIONS = [
1446
1451
  name: "cancel_upgrade_request",
1447
1452
  description: "Withdraw a pending upgrade request (for example, the blocker went away). The approval URL stops working. Fails with upgrade_request_not_pending if the request is already completed, declined, canceled, or expired.",
1448
1453
  schema: CancelUpgradeRequestSchema,
1449
- annotations: { title: "Cancel Upgrade Request", readOnlyHint: false, destructiveHint: false, idempotentHint: true, openWorldHint: false },
1454
+ annotations: { title: "Cancel Upgrade Request", readOnlyHint: false, destructiveHint: true, idempotentHint: true, openWorldHint: false },
1450
1455
  execute: createExecutor(cancelUpgradeRequest)
1451
1456
  }
1452
1457
  ];