@chronary/toolkit 1.3.0 → 1.4.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 CHANGED
@@ -2,18 +2,23 @@
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.4.0 — 2026-07-12
6
+
7
+ - Add `create_connection_link`, `get_connection_link`, and `cancel_connection_link` for provider-neutral, human-approved Google Calendar and Microsoft Outlook setup.
8
+ - Availability tool guidance now requires agents to inspect fail-closed `availability_state` and `warnings`. The toolkit has full 50-tool hosted-MCP parity.
9
+
5
10
  ## 1.3.0 — 2026-07-10
6
11
 
7
12
  - Recurring events (#996), in parity with the hosted MCP server and REST API:
8
13
  - `create_event` gains optional `recurrence_rule` (RFC 5545 RRULE subset, no `RRULE:` prefix) to create a recurring series.
9
14
  - `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
15
  - `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.
16
+ - `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 was added in that release.
12
17
  - 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
18
 
14
19
  ## 1.2.4 — 2026-07-09
15
20
 
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.
21
+ - Docs/metadata: correct the then-current README tool count after the toolkit expanded to full hosted-MCP parity. No code or behavioral change; version bump exists to publish the corrected README to npm + the mirror.
17
22
 
18
23
  ## 1.2.3 — 2026-07-07
19
24
 
package/README.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # @chronary/toolkit
2
2
 
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.
3
+ AI-agent framework adapters for [Chronary](https://chronary.ai) — 50 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 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).
104
+ Every adapter produces the same 50 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
@@ -175,6 +175,15 @@ var FindMeetingTimeSchema = import_zod.z.object({
175
175
  calendars: import_zod.z.array(import_zod.z.string()).optional().describe("Additional shared calendar IDs to treat as busy"),
176
176
  include_busy: import_zod.z.boolean().default(false).describe("Include per-agent busy blocks in response")
177
177
  });
178
+ var CreateConnectionLinkSchema = import_zod.z.object({
179
+ calendar_id: import_zod.z.string().startsWith("cal_").describe("Chronary calendar whose owning agent will receive authorized availability"),
180
+ capabilities: import_zod.z.array(import_zod.z.enum(["availability", "publishing"])).min(1).max(2).default(["availability"]).describe("Request opaque availability and optional publishing permission"),
181
+ publication_policy: import_zod.z.enum(["none", "confirmed", "confirmed_tentative"]).default("none").describe("Desired event publishing policy; a human still selects the destination")
182
+ });
183
+ var GetConnectionLinkSchema = import_zod.z.object({
184
+ connection_link_id: import_zod.z.string().startsWith("csl_").describe("Connection setup link ID")
185
+ });
186
+ var CancelConnectionLinkSchema = GetConnectionLinkSchema;
178
187
  var GetCalendarContextSchema = import_zod.z.object({
179
188
  calendar_id: import_zod.z.string().describe("Calendar ID")
180
189
  });
@@ -471,6 +480,15 @@ var findMeetingTime = safeFunc(async (ctx) => {
471
480
  include_busy: params.include_busy
472
481
  });
473
482
  });
483
+ var createConnectionLink = safeFunc(async (ctx) => {
484
+ const { calendar_id, ...params } = ctx.params;
485
+ return ctx.client.connectionLinks.create(calendar_id, params);
486
+ });
487
+ var getConnectionLink = safeFunc(async (ctx) => ctx.client.connectionLinks.get(ctx.params.connection_link_id));
488
+ var cancelConnectionLink = safeFunc(async (ctx) => {
489
+ await ctx.client.connectionLinks.cancel(ctx.params.connection_link_id);
490
+ return { cancelled: true, id: ctx.params.connection_link_id };
491
+ });
474
492
  var getCalendarContext = safeFunc(async (ctx) => {
475
493
  return ctx.client.calendars.getContext(ctx.params.calendar_id);
476
494
  });
@@ -600,6 +618,9 @@ var HOSTED_API_MCP_TOOL_NAMES = [
600
618
  "update_event",
601
619
  "get_availability",
602
620
  "find_meeting_time",
621
+ "create_connection_link",
622
+ "get_connection_link",
623
+ "cancel_connection_link",
603
624
  "cancel_event",
604
625
  "confirm_event",
605
626
  "release_event",
@@ -765,18 +786,39 @@ var TOOL_DEFINITIONS = [
765
786
  // ── Availability ───────────────────────────────────────────────
766
787
  {
767
788
  name: "get_availability",
768
- description: "Check when a single agent is free within a time range. Accepts `start`/`end` (preferred \u2014 matches the underlying availability service) or `start_time`/`end_time` (aliases that match the REST events schema).",
789
+ description: "Check when a single agent is free across Chronary and authorized human calendars. This tool is fail-closed: always inspect availability_state and warnings before using slots.",
769
790
  schema: GetAvailabilitySchema,
770
791
  annotations: { title: "Get Availability", readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
771
792
  execute: createExecutor(getAvailability)
772
793
  },
773
794
  {
774
795
  name: "find_meeting_time",
775
- description: "Find time slots when multiple agents are all free simultaneously. Accepts `agents`/`start`/`end` (preferred \u2014 matches the availability service) or `agent_ids`/`start_time`/`end_time` (aliases that match the REST/scheduling-proposal naming).",
796
+ description: "Find time when multiple agents are free across Chronary and their authorized human calendars. This tool is fail-closed: always inspect availability_state and warnings before using slots.",
776
797
  schema: FindMeetingTimeSchema,
777
798
  annotations: { title: "Find Meeting Time", readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
778
799
  execute: createExecutor(findMeetingTime)
779
800
  },
801
+ {
802
+ name: "create_connection_link",
803
+ description: "Request human setup of Google Calendar or Microsoft Outlook for a Chronary calendar. Give setup_url to a human; agents never receive provider credentials or event data. The secret URL is returned only once.",
804
+ schema: CreateConnectionLinkSchema,
805
+ annotations: { title: "Create Human Calendar Setup Link", readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: true },
806
+ execute: createExecutor(createConnectionLink)
807
+ },
808
+ {
809
+ name: "get_connection_link",
810
+ description: "Poll provider-neutral human-calendar setup status. The bearer setup URL and provider data are never returned by polling.",
811
+ schema: GetConnectionLinkSchema,
812
+ annotations: { title: "Get Human Calendar Setup Status", readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
813
+ execute: createExecutor(getConnectionLink)
814
+ },
815
+ {
816
+ name: "cancel_connection_link",
817
+ description: "Cancel a pending human-calendar setup request and invalidate its setup URL.",
818
+ schema: CancelConnectionLinkSchema,
819
+ annotations: { title: "Cancel Human Calendar Setup Link", readOnlyHint: false, destructiveHint: true, idempotentHint: true, openWorldHint: false },
820
+ execute: createExecutor(cancelConnectionLink)
821
+ },
780
822
  // ── Calendar context ───────────────────────────────────────────
781
823
  {
782
824
  name: "get_calendar_context",