@chronary/toolkit 1.2.3 → 1.3.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +13 -0
- package/README.md +2 -2
- package/dist/ai-sdk.cjs +15 -6
- package/dist/ai-sdk.cjs.map +1 -1
- package/dist/ai-sdk.js +15 -6
- package/dist/ai-sdk.js.map +1 -1
- package/dist/index.cjs +15 -6
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.cts +4 -0
- package/dist/index.d.ts +4 -0
- package/dist/index.js +15 -6
- package/dist/index.js.map +1 -1
- package/dist/langchain.cjs +15 -6
- package/dist/langchain.cjs.map +1 -1
- package/dist/langchain.js +15 -6
- package/dist/langchain.js.map +1 -1
- package/dist/mastra.cjs +15 -6
- package/dist/mastra.cjs.map +1 -1
- package/dist/mastra.js +15 -6
- package/dist/mastra.js.map +1 -1
- package/dist/mcp.cjs +15 -6
- package/dist/mcp.cjs.map +1 -1
- package/dist/mcp.js +15 -6
- package/dist/mcp.js.map +1 -1
- package/dist/openai.cjs +15 -6
- package/dist/openai.cjs.map +1 -1
- package/dist/openai.js +15 -6
- package/dist/openai.js.map +1 -1
- package/package.json +2 -2
package/CHANGELOG.md
CHANGED
|
@@ -2,6 +2,19 @@
|
|
|
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
|
+
## 1.3.0 — 2026-07-10
|
|
6
|
+
|
|
7
|
+
- Recurring events (#996), in parity with the hosted MCP server and REST API:
|
|
8
|
+
- `create_event` gains optional `recurrence_rule` (RFC 5545 RRULE subset, no `RRULE:` prefix) to create a recurring series.
|
|
9
|
+
- `update_event` gains `recurrence_rule` (string to set/change the series rule — full-series semantics — or `null` to make the event a one-off).
|
|
10
|
+
- `list_events` gains `expand` — expands recurring series into individual occurrence instances within the `start_after`/`start_before` window (both required when `expand=true`, max 366 days apart). Instances carry `recurringEventId` + `originalStartTime`.
|
|
11
|
+
- `cancel_event` gains optional `occurrence_start` — cancels just that one occurrence of a recurring series (the series continues) and returns the updated series master; omit it to cancel the whole series. No new tool: the tool count stays 47.
|
|
12
|
+
- Requires `@chronary/sdk` >= 0.5.0 (the release that adds `recurrence_rule` / `expand` / `occurrence_start`); the workspace dependency resolves this automatically at publish time.
|
|
13
|
+
|
|
14
|
+
## 1.2.4 — 2026-07-09
|
|
15
|
+
|
|
16
|
+
- Docs/metadata: correct the README tool count (the adapters expose **47** calendar tools, not 23 — the toolkit was expanded to full parity with the hosted MCP surface). No code or behavioral change; version bump exists to publish the corrected README to npm + the mirror.
|
|
17
|
+
|
|
5
18
|
## 1.2.3 — 2026-07-07
|
|
6
19
|
|
|
7
20
|
- Add parameter descriptions to the nested scheduling-proposal slot object (`start_time`, `end_time`, `weight`, `calendar_id` on `create_proposal` / `respond_to_proposal` slots) and to the availability-rules working-hours `start`/`end` fields. These were the only tool parameters lacking `.describe()`, so agents now get guidance on every field. Improves MCP tool-definition quality (e.g. Glama's scoring) with no behavioral change. `@chronary/mcp` picks this up automatically via its `^1.2.2` caret range.
|
package/README.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# @chronary/toolkit
|
|
2
2
|
|
|
3
|
-
AI-agent framework adapters for [Chronary](https://chronary.ai) —
|
|
3
|
+
AI-agent framework adapters for [Chronary](https://chronary.ai) — 47 calendar tools usable directly by Vercel AI SDK, LangChain, Mastra, OpenAI function calling, and MCP clients.
|
|
4
4
|
|
|
5
5
|
## Installation
|
|
6
6
|
|
|
@@ -101,7 +101,7 @@ your agent code
|
|
|
101
101
|
api.chronary.ai (REST)
|
|
102
102
|
```
|
|
103
103
|
|
|
104
|
-
Every adapter produces the same
|
|
104
|
+
Every adapter produces the same 47 calendar tools in the format the target framework expects. Tool definitions live in [`src/definitions.ts`](./src/definitions.ts); Zod schemas are in [`src/schemas.ts`](./src/schemas.ts).
|
|
105
105
|
|
|
106
106
|
## Documentation
|
|
107
107
|
|
package/dist/ai-sdk.cjs
CHANGED
|
@@ -85,7 +85,8 @@ var ListEventsSchema = import_zod.z.object({
|
|
|
85
85
|
status: import_zod.z.enum(["confirmed", "tentative", "cancelled", "hold"]).optional().describe("Filter by event status"),
|
|
86
86
|
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)'),
|
|
87
87
|
limit: import_zod.z.number().int().min(1).max(200).default(50).describe("Max results to return"),
|
|
88
|
-
offset: import_zod.z.number().int().min(0).default(0).describe("Pagination offset")
|
|
88
|
+
offset: import_zod.z.number().int().min(0).default(0).describe("Pagination offset"),
|
|
89
|
+
expand: import_zod.z.boolean().default(false).describe("Expand recurring series into individual occurrence instances within the window. Requires both start_after and start_before (max 366 days apart). Instances carry recurringEventId + originalStartTime.")
|
|
89
90
|
});
|
|
90
91
|
var GetEventSchema = import_zod.z.object({
|
|
91
92
|
event_id: import_zod.z.string().describe("Event ID to retrieve"),
|
|
@@ -101,7 +102,8 @@ var CreateEventSchema = import_zod.z.object({
|
|
|
101
102
|
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".'),
|
|
102
103
|
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."),
|
|
103
104
|
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.'),
|
|
104
|
-
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.')
|
|
105
|
+
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.'),
|
|
106
|
+
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.')
|
|
105
107
|
});
|
|
106
108
|
var UpdateEventSchema = import_zod.z.object({
|
|
107
109
|
event_id: import_zod.z.string().describe("Event ID to update"),
|
|
@@ -113,11 +115,13 @@ var UpdateEventSchema = import_zod.z.object({
|
|
|
113
115
|
all_day: import_zod.z.boolean().optional().describe("Whether this is an all-day event"),
|
|
114
116
|
status: import_zod.z.enum(["confirmed", "tentative", "cancelled"]).optional().describe("New event status"),
|
|
115
117
|
metadata: import_zod.z.record(import_zod.z.string(), import_zod.z.unknown()).optional().describe("Replacement metadata object"),
|
|
116
|
-
reminders: import_zod.z.array(import_zod.z.number().int().min(1).max(40320)).max(5).nullable().optional().describe("Reminder offsets in minutes before start_time. Omit to leave unchanged, null to inherit the calendar default, [] for no reminders.")
|
|
118
|
+
reminders: import_zod.z.array(import_zod.z.number().int().min(1).max(40320)).max(5).nullable().optional().describe("Reminder offsets in minutes before start_time. Omit to leave unchanged, null to inherit the calendar default, [] for no reminders."),
|
|
119
|
+
recurrence_rule: import_zod.z.string().max(256).nullable().optional().describe("Set/change the recurring series rule (RFC 5545 RRULE subset, full-series semantics), or null to make the event a one-off. Changing the rule or start_time resets cancelled occurrences.")
|
|
117
120
|
});
|
|
118
121
|
var CancelEventSchema = import_zod.z.object({
|
|
119
122
|
event_id: import_zod.z.string().describe("Event ID to cancel"),
|
|
120
|
-
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.")
|
|
123
|
+
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."),
|
|
124
|
+
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.")
|
|
121
125
|
});
|
|
122
126
|
var ConfirmEventSchema = import_zod.z.object({
|
|
123
127
|
event_id: import_zod.z.string().describe("Event ID of the hold to confirm")
|
|
@@ -376,6 +380,7 @@ var listEvents = safeFunc(async (ctx) => {
|
|
|
376
380
|
start_before: params.start_before,
|
|
377
381
|
status: params.status,
|
|
378
382
|
source: params.source,
|
|
383
|
+
expand: params.expand,
|
|
379
384
|
limit: params.limit
|
|
380
385
|
});
|
|
381
386
|
return fetchPage(iter, params.offset, params.limit);
|
|
@@ -395,7 +400,11 @@ var updateEvent = safeFunc(async (ctx) => {
|
|
|
395
400
|
return calendar_id ? client.events.update(calendar_id, event_id, updates) : client.events.updateById(event_id, updates);
|
|
396
401
|
});
|
|
397
402
|
var cancelEvent = safeFunc(async (ctx) => {
|
|
398
|
-
const { calendar_id, event_id } = ctx.params;
|
|
403
|
+
const { calendar_id, event_id, occurrence_start } = ctx.params;
|
|
404
|
+
if (occurrence_start) {
|
|
405
|
+
const event = calendar_id ? await ctx.client.events.delete(calendar_id, event_id, { occurrence_start }) : await ctx.client.events.deleteById(event_id, { occurrence_start });
|
|
406
|
+
return { occurrence_cancelled: true, id: event_id, occurrence_start, event };
|
|
407
|
+
}
|
|
399
408
|
if (calendar_id) {
|
|
400
409
|
await ctx.client.events.delete(calendar_id, event_id);
|
|
401
410
|
} else {
|
|
@@ -698,7 +707,7 @@ var TOOL_DEFINITIONS = [
|
|
|
698
707
|
},
|
|
699
708
|
{
|
|
700
709
|
name: "cancel_event",
|
|
701
|
-
description: "Delete or cancel an event from a calendar. Use this to remove, cancel, or delete any scheduled event or appointment. The event is marked cancelled and excluded from future availability calculations. `calendar_id` is optional \u2014 if omitted the calendar is looked up from the event. Provide `calendar_id` to fail fast on cross-calendar typos.",
|
|
710
|
+
description: "Delete or cancel an event from a calendar. Use this to remove, cancel, or delete any scheduled event or appointment. The event is marked cancelled and excluded from future availability calculations. For a recurring series, pass `occurrence_start` to cancel just that one occurrence (the series continues); omit it to cancel the whole series. `calendar_id` is optional \u2014 if omitted the calendar is looked up from the event. Provide `calendar_id` to fail fast on cross-calendar typos.",
|
|
702
711
|
schema: CancelEventSchema,
|
|
703
712
|
annotations: { title: "Cancel Event", readOnlyHint: false, destructiveHint: true, idempotentHint: true, openWorldHint: false },
|
|
704
713
|
execute: createExecutor(cancelEvent)
|