@chronary/toolkit 1.6.1 → 1.6.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/CHANGELOG.md CHANGED
@@ -2,8 +2,14 @@
2
2
 
3
3
  All notable changes to `@chronary/toolkit` will be documented in this file starting with the soft-launch release.
4
4
 
5
- ## Unreleased
5
+ ## 1.6.3 — 2026-11-12
6
6
 
7
+ - Fix the Vercel AI SDK adapter (`@chronary/toolkit/ai-sdk`) on AI SDK 5 and 6: each tool now sets its Zod input schema as `inputSchema` as well as `parameters`. AI SDK 5 renamed the field and AI SDK 6 ignores `parameters`, so models saw an empty argument schema for every tool and could not pass `calendar_id`, `start_time` and the rest. AI SDK 4 still reads `parameters`. New type export `AISDKTool` (#1987).
8
+ - Date-time tool inputs now accept a numeric UTC offset (`-08:00`, `+05:30`) as well as `Z`, matching the API (#1989). Before, the toolkit rejected offsets client-side before sending the request.
9
+
10
+ ## 1.6.2 — 2026-11-12
11
+
12
+ - Ships `@chronary/sdk` 0.9.0: a 429 `quota_exceeded` (a monthly plan limit) is no longer retried, so a tool call at the cap fails at once with the quota error and its upgrade hints instead of sleeping on `Retry-After` (#1936).
7
13
  - Static MCP instructions and tool descriptions now use the Developer-plan wording: scoped keys, cross-agent availability, webhook delivery replay and secret rotation require a Developer or Pro plan; scheduling proposals and temporal holds stay Pro.
8
14
 
9
15
  ## 1.6.1 — 2026-11-09
package/README.md CHANGED
@@ -17,30 +17,33 @@ Each adapter's runtime peer dependency (e.g. `ai`, `@langchain/core`, `@modelcon
17
17
  ### Vercel AI SDK
18
18
 
19
19
  ```ts
20
- import { generateText } from 'ai';
20
+ import { generateText, stepCountIs } from 'ai';
21
21
  import { openai } from '@ai-sdk/openai';
22
- import { createChronaryAISDKToolkit } from '@chronary/toolkit/ai-sdk';
22
+ import { chronaryTools } from '@chronary/toolkit/ai-sdk';
23
23
 
24
- const tools = createChronaryAISDKToolkit({
24
+ const tools = chronaryTools({
25
25
  apiKey: process.env.CHRONARY_API_KEY!,
26
26
  });
27
27
 
28
28
  const result = await generateText({
29
29
  model: openai('gpt-4o'),
30
30
  tools,
31
+ stopWhen: stepCountIs(5), // AI SDK 4: maxSteps: 5
31
32
  prompt: 'Schedule a 30-minute sync with Alex next Tuesday at 10am.',
32
33
  });
33
34
  ```
34
35
 
36
+ Works with AI SDK 4, 5 and 6: each tool carries its Zod input schema as `inputSchema` (AI SDK 5 and 6) and as `parameters` (AI SDK 4).
37
+
35
38
  ### LangChain
36
39
 
37
40
  ```ts
38
41
  import { ChatOpenAI } from '@langchain/openai';
39
- import { createChronaryLangChainToolkit } from '@chronary/toolkit/langchain';
42
+ import { ChronaryToolkit } from '@chronary/toolkit/langchain';
40
43
 
41
- const tools = createChronaryLangChainToolkit({
44
+ const tools = new ChronaryToolkit({
42
45
  apiKey: process.env.CHRONARY_API_KEY!,
43
- });
46
+ }).getTools();
44
47
 
45
48
  const llm = new ChatOpenAI({ model: 'gpt-4o' }).bindTools(tools);
46
49
  ```
@@ -49,11 +52,11 @@ const llm = new ChatOpenAI({ model: 'gpt-4o' }).bindTools(tools);
49
52
 
50
53
  ```ts
51
54
  import OpenAI from 'openai';
52
- import { createChronaryOpenAIToolkit } from '@chronary/toolkit/openai';
55
+ import { ChronaryToolkit } from '@chronary/toolkit/openai';
53
56
 
54
- const tools = createChronaryOpenAIToolkit({
57
+ const tools = new ChronaryToolkit({
55
58
  apiKey: process.env.CHRONARY_API_KEY!,
56
- });
59
+ }).getTools();
57
60
 
58
61
  const client = new OpenAI();
59
62
  const response = await client.chat.completions.create({
@@ -67,11 +70,11 @@ const response = await client.chat.completions.create({
67
70
 
68
71
  ```ts
69
72
  import { Agent } from '@mastra/core/agent';
70
- import { createChronaryMastraToolkit } from '@chronary/toolkit/mastra';
73
+ import { ChronaryToolkit } from '@chronary/toolkit/mastra';
71
74
 
72
- const tools = createChronaryMastraToolkit({
75
+ const tools = new ChronaryToolkit({
73
76
  apiKey: process.env.CHRONARY_API_KEY!,
74
- });
77
+ }).getTools();
75
78
 
76
79
  const agent = new Agent({ name: 'scheduler', tools });
77
80
  ```
@@ -80,11 +83,11 @@ const agent = new Agent({ name: 'scheduler', tools });
80
83
 
81
84
  ```ts
82
85
  import { Server } from '@modelcontextprotocol/sdk/server';
83
- import { createChronaryMCPToolkit } from '@chronary/toolkit/mcp';
86
+ import { ChronaryToolkit } from '@chronary/toolkit/mcp';
84
87
 
85
- const tools = createChronaryMCPToolkit({
88
+ const tools = new ChronaryToolkit({
86
89
  apiKey: process.env.CHRONARY_API_KEY!,
87
- });
90
+ }).getTools();
88
91
  ```
89
92
 
90
93
  If you want a ready-to-run stdio MCP server instead of wiring tools into your own server, use [`chronary-mcp`](https://github.com/Chronary/chronary-mcp) — it wraps this toolkit for one-line MCP client setup.
package/dist/ai-sdk.cjs CHANGED
@@ -105,8 +105,8 @@ var DeleteBookingPageSchema = import_zod.z.object({
105
105
  var ListEventsSchema = import_zod.z.object({
106
106
  calendar_id: import_zod.z.string().optional().describe("Calendar ID to list events from. Provide this or agent_id."),
107
107
  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."),
108
- start_after: import_zod.z.string().datetime().optional().describe("Only events starting after this ISO 8601 time"),
109
- start_before: import_zod.z.string().datetime().optional().describe("Only events starting before this ISO 8601 time"),
108
+ start_after: import_zod.z.string().datetime({ offset: true }).optional().describe("Only events starting after this ISO 8601 time"),
109
+ start_before: import_zod.z.string().datetime({ offset: true }).optional().describe("Only events starting before this ISO 8601 time"),
110
110
  status: import_zod.z.enum(["confirmed", "tentative", "cancelled", "hold"]).optional().describe("Filter by event status"),
111
111
  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)'),
112
112
  limit: import_zod.z.number().int().min(1).max(200).default(50).describe("Max results to return"),
@@ -116,8 +116,8 @@ var ListEventsSchema = import_zod.z.object({
116
116
  var ListOrgEventsSchema = import_zod.z.object({
117
117
  calendar_ids: import_zod.z.array(import_zod.z.string()).max(50).optional().describe("Only these calendar IDs (at most 50)"),
118
118
  agent_id: import_zod.z.string().optional().describe("Only this agent's calendars"),
119
- start_after: import_zod.z.string().datetime().optional().describe("Only events starting at or after this ISO 8601 time"),
120
- start_before: import_zod.z.string().datetime().optional().describe("Only events starting at or before this ISO 8601 time"),
119
+ start_after: import_zod.z.string().datetime({ offset: true }).optional().describe("Only events starting at or after this ISO 8601 time"),
120
+ start_before: import_zod.z.string().datetime({ offset: true }).optional().describe("Only events starting at or before this ISO 8601 time"),
121
121
  status: import_zod.z.enum(["confirmed", "tentative", "cancelled", "hold"]).optional().describe("Filter by event status"),
122
122
  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)'),
123
123
  q: import_zod.z.string().optional().describe("Case-insensitive title search. Requires start_after and start_before at most 31 days apart"),
@@ -132,23 +132,23 @@ var GetEventSchema = import_zod.z.object({
132
132
  var CreateEventSchema = import_zod.z.object({
133
133
  calendar_id: import_zod.z.string().describe("Calendar ID to add the event to"),
134
134
  title: import_zod.z.string().min(1).max(500).describe("Event title"),
135
- start_time: import_zod.z.string().datetime().describe("Start time (ISO 8601)"),
136
- end_time: import_zod.z.string().datetime().describe("End time (ISO 8601)"),
135
+ start_time: import_zod.z.string().datetime({ offset: true }).describe("Start time (ISO 8601)"),
136
+ end_time: import_zod.z.string().datetime({ offset: true }).describe("End time (ISO 8601)"),
137
137
  description: import_zod.z.string().max(1e4).optional().describe("Optional event description"),
138
138
  all_day: import_zod.z.boolean().default(false).describe("Whether this is an all-day event"),
139
139
  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".'),
140
140
  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."),
141
- 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.'),
141
+ 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.'),
142
142
  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.'),
143
- 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: max 5 recurring events, series must end within 90 days.')
143
+ 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.')
144
144
  });
145
145
  var UpdateEventSchema = import_zod.z.object({
146
146
  event_id: import_zod.z.string().describe("Event ID to update"),
147
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."),
148
148
  title: import_zod.z.string().min(1).max(500).optional().describe("New event title"),
149
149
  description: import_zod.z.string().max(1e4).nullable().optional().describe("New description, or null to clear it"),
150
- start_time: import_zod.z.string().datetime().optional().describe("New start time (ISO 8601)"),
151
- 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)"),
152
152
  all_day: import_zod.z.boolean().optional().describe("Whether this is an all-day event"),
153
153
  status: import_zod.z.enum(["confirmed", "tentative", "cancelled"]).optional().describe("New event status"),
154
154
  metadata: import_zod.z.record(import_zod.z.string(), import_zod.z.unknown()).optional().describe("Replacement metadata object"),
@@ -158,7 +158,7 @@ var UpdateEventSchema = import_zod.z.object({
158
158
  var CancelEventSchema = import_zod.z.object({
159
159
  event_id: import_zod.z.string().describe("Event ID to cancel"),
160
160
  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."),
161
- 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.")
161
+ 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.")
162
162
  });
163
163
  var ConfirmEventSchema = import_zod.z.object({
164
164
  event_id: import_zod.z.string().describe("Event ID of the hold to confirm")
@@ -192,10 +192,10 @@ var DeleteAgentSchema = import_zod.z.object({
192
192
  });
193
193
  var GetAvailabilitySchema = import_zod.z.object({
194
194
  agent_id: import_zod.z.string().describe("Agent ID to check availability for"),
195
- start: import_zod.z.string().datetime().optional().describe("Range start (ISO 8601). Alias: start_time."),
196
- end: import_zod.z.string().datetime().optional().describe("Range end (ISO 8601). Alias: end_time."),
197
- start_time: import_zod.z.string().datetime().optional().describe("Alias for `start` (matches REST events naming)."),
198
- end_time: import_zod.z.string().datetime().optional().describe("Alias for `end` (matches REST events naming)."),
195
+ start: import_zod.z.string().datetime({ offset: true }).optional().describe("Range start (ISO 8601). Alias: start_time."),
196
+ end: import_zod.z.string().datetime({ offset: true }).optional().describe("Range end (ISO 8601). Alias: end_time."),
197
+ start_time: import_zod.z.string().datetime({ offset: true }).optional().describe("Alias for `start` (matches REST events naming)."),
198
+ end_time: import_zod.z.string().datetime({ offset: true }).optional().describe("Alias for `end` (matches REST events naming)."),
199
199
  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."),
200
200
  slot_duration: import_zod.z.enum(["15m", "30m", "45m", "1h", "2h"]).optional().describe("Deprecated alias for `duration` \u2014 minimum slot length. Prefer `duration`."),
201
201
  include_busy: import_zod.z.boolean().default(false).describe("Include busy blocks in response")
@@ -203,10 +203,10 @@ var GetAvailabilitySchema = import_zod.z.object({
203
203
  var FindMeetingTimeSchema = import_zod.z.object({
204
204
  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."),
205
205
  agent_ids: import_zod.z.array(import_zod.z.string()).min(1).optional().describe("Alias for `agents` (matches REST/scheduling-proposal naming)."),
206
- start: import_zod.z.string().datetime().optional().describe("Search range start (ISO 8601). Alias: start_time."),
207
- end: import_zod.z.string().datetime().optional().describe("Search range end (ISO 8601). Alias: end_time."),
208
- start_time: import_zod.z.string().datetime().optional().describe("Alias for `start` (matches REST events naming)."),
209
- end_time: import_zod.z.string().datetime().optional().describe("Alias for `end` (matches REST events naming)."),
206
+ start: import_zod.z.string().datetime({ offset: true }).optional().describe("Search range start (ISO 8601). Alias: start_time."),
207
+ end: import_zod.z.string().datetime({ offset: true }).optional().describe("Search range end (ISO 8601). Alias: end_time."),
208
+ start_time: import_zod.z.string().datetime({ offset: true }).optional().describe("Alias for `start` (matches REST events naming)."),
209
+ end_time: import_zod.z.string().datetime({ offset: true }).optional().describe("Alias for `end` (matches REST events naming)."),
210
210
  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."),
211
211
  slot_duration: import_zod.z.enum(["15m", "30m", "45m", "1h", "2h"]).optional().describe("Deprecated alias for `duration` \u2014 minimum slot length. Prefer `duration`."),
212
212
  calendars: import_zod.z.array(import_zod.z.string()).optional().describe("Additional shared calendar IDs to treat as busy"),
@@ -225,8 +225,8 @@ var GetCalendarContextSchema = import_zod.z.object({
225
225
  calendar_id: import_zod.z.string().describe("Calendar ID")
226
226
  });
227
227
  var proposalSlotSchema = import_zod.z.object({
228
- start_time: import_zod.z.string().datetime().describe("Slot start time (ISO 8601)"),
229
- end_time: import_zod.z.string().datetime().describe("Slot end time (ISO 8601), after start_time"),
228
+ start_time: import_zod.z.string().datetime({ offset: true }).describe("Slot start time (ISO 8601)"),
229
+ end_time: import_zod.z.string().datetime({ offset: true }).describe("Slot end time (ISO 8601), after start_time"),
230
230
  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."),
231
231
  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.")
232
232
  });
@@ -237,7 +237,7 @@ var CreateProposalSchema = import_zod.z.object({
237
237
  participant_agent_ids: import_zod.z.array(import_zod.z.string()).min(1).max(50).describe("Agent IDs invited to respond"),
238
238
  calendar_id: import_zod.z.string().describe("Calendar the resolved event will be created on"),
239
239
  slots: import_zod.z.array(proposalSlotSchema).min(1).max(20).describe("Candidate time slots (up to 20)"),
240
- expires_at: import_zod.z.string().datetime().optional().describe("Auto-cancel cutoff if unresolved")
240
+ expires_at: import_zod.z.string().datetime({ offset: true }).optional().describe("Auto-cancel cutoff if unresolved")
241
241
  });
242
242
  var ListProposalsSchema = import_zod.z.object({
243
243
  status: import_zod.z.enum(["pending", "resolving", "confirmed", "expired", "cancelled"]).optional().describe("Filter by proposal status"),
@@ -342,8 +342,8 @@ var ListWebhookDeliveriesSchema = import_zod.z.object({
342
342
  status: import_zod.z.enum(WEBHOOK_DELIVERY_STATUSES).optional().describe("Filter to a single delivery status"),
343
343
  include_payload: import_zod.z.boolean().optional().describe("Include the full event payload sent on each delivery"),
344
344
  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"),
345
- created_after: import_zod.z.string().datetime().optional().describe("Only deliveries created at or after this time (ISO 8601, UTC)"),
346
- created_before: import_zod.z.string().datetime().optional().describe("Only deliveries created before this time (ISO 8601, UTC)"),
345
+ created_after: import_zod.z.string().datetime({ offset: true }).optional().describe("Only deliveries created at or after this time (ISO 8601)"),
346
+ created_before: import_zod.z.string().datetime({ offset: true }).optional().describe("Only deliveries created before this time (ISO 8601)"),
347
347
  delivery_id: import_zod.z.string().max(100).regex(/^whd_[A-Za-z0-9_-]+$/).optional().describe("Only the delivery with this id"),
348
348
  is_test: import_zod.z.boolean().optional().describe("true for test events only, false to leave them out"),
349
349
  cursor: import_zod.z.string().min(1).max(1024).optional().describe("The next_cursor from the previous page")
@@ -1377,6 +1377,7 @@ var ChronaryToolkit = class extends MapToolkit {
1377
1377
  const client = this.client;
1378
1378
  return {
1379
1379
  description: def.description,
1380
+ inputSchema: def.schema,
1380
1381
  parameters: def.schema,
1381
1382
  execute: async (params) => {
1382
1383
  const result = await def.execute(client, params);