@chronary/toolkit 1.6.2 → 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 +6 -1
- package/README.md +18 -15
- package/dist/ai-sdk.cjs +24 -23
- package/dist/ai-sdk.cjs.map +1 -1
- package/dist/ai-sdk.d.cts +32 -27
- package/dist/ai-sdk.d.ts +32 -27
- package/dist/ai-sdk.js +24 -23
- package/dist/ai-sdk.js.map +1 -1
- package/dist/index.cjs +23 -23
- package/dist/index.cjs.map +1 -1
- package/dist/index.js +23 -23
- package/dist/index.js.map +1 -1
- package/dist/langchain.cjs +23 -23
- package/dist/langchain.cjs.map +1 -1
- package/dist/langchain.js +23 -23
- package/dist/langchain.js.map +1 -1
- package/dist/mastra.cjs +23 -23
- package/dist/mastra.cjs.map +1 -1
- package/dist/mastra.js +23 -23
- package/dist/mastra.js.map +1 -1
- package/dist/mcp.cjs +23 -23
- package/dist/mcp.cjs.map +1 -1
- package/dist/mcp.js +23 -23
- package/dist/mcp.js.map +1 -1
- package/dist/openai.cjs +23 -23
- package/dist/openai.cjs.map +1 -1
- package/dist/openai.js +23 -23
- package/dist/openai.js.map +1 -1
- package/package.json +3 -2
package/CHANGELOG.md
CHANGED
|
@@ -2,7 +2,12 @@
|
|
|
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
|
-
##
|
|
5
|
+
## 1.6.3 — 2026-11-12
|
|
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
|
|
6
11
|
|
|
7
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).
|
|
8
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.
|
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 {
|
|
22
|
+
import { chronaryTools } from '@chronary/toolkit/ai-sdk';
|
|
23
23
|
|
|
24
|
-
const tools =
|
|
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 {
|
|
42
|
+
import { ChronaryToolkit } from '@chronary/toolkit/langchain';
|
|
40
43
|
|
|
41
|
-
const tools =
|
|
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 {
|
|
55
|
+
import { ChronaryToolkit } from '@chronary/toolkit/openai';
|
|
53
56
|
|
|
54
|
-
const tools =
|
|
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 {
|
|
73
|
+
import { ChronaryToolkit } from '@chronary/toolkit/mastra';
|
|
71
74
|
|
|
72
|
-
const tools =
|
|
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 {
|
|
86
|
+
import { ChronaryToolkit } from '@chronary/toolkit/mcp';
|
|
84
87
|
|
|
85
|
-
const tools =
|
|
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,13 +132,13 @@ 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
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
|
});
|
|
@@ -147,8 +147,8 @@ var UpdateEventSchema = import_zod.z.object({
|
|
|
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
|
|
346
|
-
created_before: import_zod.z.string().datetime().optional().describe("Only deliveries created before this time (ISO 8601
|
|
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);
|