@project-ajax/sdk 0.0.72 → 0.0.75

package/dist/builder.d.ts

@@ -1,5 +1,5 @@
 import type { NoticonName } from "./icon-names.js";
-import type { Icon, NoticonColor, PeopleValue, PlaceValue, TextValue } from "./types.js";
+import type { Icon, NoticonColor, PeopleValue, PlaceValue, RelationReference, TextValue } from "./types.js";
 /**
  * Creates a rich text value.
  */
@@ -83,6 +83,21 @@ export declare function people(...emails: string[]): PeopleValue;
  * @param value - The place value with lat/lon coordinates and optional name/address
  */
 export declare function place(value: PlaceValue): PlaceValue;
+/**
+ * Creates a relation reference from a primary key of a related record.
+ * Use an array of relation references as the property value.
+ *
+ * @param primaryKey - The primary key of the related record
+ * @example
+ * ```typescript
+ * // Single relation
+ * { Project: [Builder.relation("project-123")] }
+ *
+ * // Multiple relations
+ * { Projects: [Builder.relation("project-123"), Builder.relation("project-456")] }
+ * ```
+ */
+export declare function relation(primaryKey: string): RelationReference;
 /**
  * Creates an emoji icon.
  * @param emoji - An emoji string (e.g., "🎯", "✨", "🚀")

package/dist/builder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"builder.d.ts","sourceRoot":"","sources":["../src/builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,KAAK,EAEX,IAAI,EACJ,YAAY,EACZ,WAAW,EACX,UAAU,EACV,SAAS,EACT,MAAM,YAAY,CAAC;AAEpB;;GAEG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAEnD;AAED;;GAEG;AACH,wBAAgB,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAE1C;AAED;;GAEG;AACH,wBAAgB,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAEhD;AAED;;GAEG;AACH,wBAAgB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAE/C;AAED;;GAEG;AACH,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAE9C;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAEpD;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,SAAS,CAEpD;AAED;;;;GAIG;AACH,wBAAgB,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAElE;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAK/C;AAED;;GAEG;AACH,wBAAgB,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,CASlD;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAYjE;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,SAAS,CAWvE;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC5B,SAAS,EAAE,IAAI,EACf,OAAO,EAAE,IAAI,EACb,QAAQ,CAAC,EAAE,MAAM,GACf,SAAS,CAcX;AAED;;;;GAIG;AACH,wBAAgB,IAAI,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,SAAS,CAEhE;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAE/C;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,GAAG,MAAM,EAAE,MAAM,EAAE,GAAG,SAAS,CAK1D;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAE/C;AAED;;;GAGG;AACH,wBAAgB,MAAM,CAAC,GAAG,MAAM,EAAE,MAAM,EAAE,GAAG,WAAW,CAEvD;AAED;;;GAGG;AACH,wBAAgB,KAAK,CAAC,KAAK,EAAE,UAAU,GAAG,UAAU,CAKnD;AA4CD;;;GAGG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAK7C;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CACzB,IAAI,EAAE,WAAW,EACjB,KAAK,GAAE,YAAqB,GAC1B,IAAI,CAMN;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAK3C"}
+{"version":3,"file":"builder.d.ts","sourceRoot":"","sources":["../src/builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,KAAK,EAEX,IAAI,EACJ,YAAY,EACZ,WAAW,EACX,UAAU,EACV,iBAAiB,EACjB,SAAS,EACT,MAAM,YAAY,CAAC;AAEpB;;GAEG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAEnD;AAED;;GAEG;AACH,wBAAgB,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAE1C;AAED;;GAEG;AACH,wBAAgB,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAEhD;AAED;;GAEG;AACH,wBAAgB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAE/C;AAED;;GAEG;AACH,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAE9C;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAEpD;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,SAAS,CAEpD;AAED;;;;GAIG;AACH,wBAAgB,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAElE;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAK/C;AAED;;GAEG;AACH,wBAAgB,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,CASlD;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAYjE;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,SAAS,CAWvE;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC5B,SAAS,EAAE,IAAI,EACf,OAAO,EAAE,IAAI,EACb,QAAQ,CAAC,EAAE,MAAM,GACf,SAAS,CAcX;AAED;;;;GAIG;AACH,wBAAgB,IAAI,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,SAAS,CAEhE;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAE/C;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,GAAG,MAAM,EAAE,MAAM,EAAE,GAAG,SAAS,CAK1D;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAE/C;AAED;;;GAGG;AACH,wBAAgB,MAAM,CAAC,GAAG,MAAM,EAAE,MAAM,EAAE,GAAG,WAAW,CAEvD;AAED;;;GAGG;AACH,wBAAgB,KAAK,CAAC,KAAK,EAAE,UAAU,GAAG,UAAU,CAKnD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,iBAAiB,CAE9D;AA4CD;;;GAGG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAK7C;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CACzB,IAAI,EAAE,WAAW,EACjB,KAAK,GAAE,YAAqB,GAC1B,IAAI,CAMN;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAK3C"}

package/dist/builder.js

@@ -94,6 +94,9 @@ function place(value) {
   }
   return value;
 }
+function relation(primaryKey) {
+  return { type: "primaryKey", value: primaryKey };
+}
 function validateDateString(dateString) {
   if (!/^\d{4}-\d{2}-\d{2}$/.test(dateString)) {
     throw new Error(
@@ -155,6 +158,7 @@ export {
   people,
   phoneNumber,
   place,
+  relation,
   richText,
   select,
   status,

package/dist/capabilities/automation.d.ts

@@ -1,7 +1,8 @@
+import type { CapabilityContext } from "./context.js";
 /**
- * Context provided to automation execute functions
+ * Event provided to automation execute functions
  */
-export interface AutomationContext {
+export interface AutomationEvent {
     /**
      * The ID of the page that triggered the automation (if applicable)
      */
@@ -54,10 +55,11 @@ export interface AutomationConfiguration {
     description: string;
     /**
      * The function that executes when the automation is triggered
-     * @param context - Context about the automation trigger, including page data if applicable
+     * @param event - Event data about the automation trigger, including page data if applicable
+     * @param context - The capability execution context (Notion client, etc.)
      * @returns A promise that resolves when the automation completes
      */
-    execute: (context: AutomationContext) => Promise<void> | void;
+    execute: (event: AutomationEvent, context: CapabilityContext) => Promise<void> | void;
 }
 /**
  * Result returned from automation execution
@@ -81,6 +83,6 @@ export declare function createAutomationCapability(key: string, config: Automati
         title: string;
         description: string;
     };
-    handler(context: AutomationContext): Promise<void>;
+    handler(event: AutomationEvent): Promise<void>;
 };
 //# sourceMappingURL=automation.d.ts.map

package/dist/capabilities/automation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"automation.d.ts","sourceRoot":"","sources":["../../src/capabilities/automation.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,WAAW,iBAAiB;IACjC;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,QAAQ,CAAC,EAAE,kBAAkB,CAAC;CAC9B;AAED;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,EAAE,EAAE,MAAM,CAAC;IACX,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,UAAU,EAAE;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3B,cAAc,EAAE;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,OAAO,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACvC;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;;;OAIG;IACH,OAAO,EAAE,CAAC,OAAO,EAAE,iBAAiB,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CAC9D;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACvC,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,MAAM,oBAAoB,GAAG,UAAU,CAC5C,OAAO,0BAA0B,CACjC,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CACzC,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,uBAAuB;;;;;;;qBASP,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;EAezD"}
+{"version":3,"file":"automation.d.ts","sourceRoot":"","sources":["../../src/capabilities/automation.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAGtD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC/B;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,QAAQ,CAAC,EAAE,kBAAkB,CAAC;CAC9B;AAED;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,EAAE,EAAE,MAAM,CAAC;IACX,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,UAAU,EAAE;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3B,cAAc,EAAE;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,OAAO,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACvC;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;;;;OAKG;IACH,OAAO,EAAE,CACR,KAAK,EAAE,eAAe,EACtB,OAAO,EAAE,iBAAiB,KACtB,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACvC,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,MAAM,oBAAoB,GAAG,UAAU,CAC5C,OAAO,0BAA0B,CACjC,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CACzC,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,uBAAuB;;;;;;;mBAST,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;EAgBrD"}

package/dist/capabilities/automation.js

@@ -1,4 +1,5 @@
 import { ExecutionError } from "../error.js";
+import { createCapabilityContext } from "./context.js";
 function createAutomationCapability(key, config) {
   return {
     _tag: "automation",
@@ -7,9 +8,10 @@ function createAutomationCapability(key, config) {
       title: config.title,
       description: config.description
     },
-    async handler(context) {
+    async handler(event) {
       try {
-        await config.execute(context);
+        const capabilityContext = createCapabilityContext();
+        await config.execute(event, capabilityContext);
         process.stdout.write(
           `
 <output>${JSON.stringify({ status: "success" })}</output>

package/dist/capabilities/context.d.ts

@@ -0,0 +1,7 @@
+import { Client } from "@notionhq/client";
+export type CapabilityContext = {
+    /** Notion API SDK client for this execution. */
+    notion: Client;
+};
+export declare function createCapabilityContext(): CapabilityContext;
+//# sourceMappingURL=context.d.ts.map

package/dist/capabilities/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/capabilities/context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAG1C,MAAM,MAAM,iBAAiB,GAAG;IAC/B,gDAAgD;IAChD,MAAM,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,wBAAgB,uBAAuB,IAAI,iBAAiB,CAc3D"}

package/dist/capabilities/context.js

@@ -0,0 +1,15 @@
+import { Client } from "@notionhq/client";
+function createCapabilityContext() {
+  const options = {};
+  if (process.env.NOTION_API_BASE_URL) {
+    options.baseUrl = process.env.NOTION_API_BASE_URL;
+  }
+  if (process.env.NOTION_API_TOKEN) {
+    options.auth = process.env.NOTION_API_TOKEN;
+  }
+  const notion = new Client(options);
+  return { notion };
+}
+export {
+  createCapabilityContext
+};

package/dist/capabilities/sync.d.ts

@@ -1,5 +1,6 @@
 import type { PropertyConfiguration, PropertySchema, Schema } from "../schema.js";
-import type { Icon, PeopleValue, PlaceValue, Schedule, SyncSchedule, TextValue } from "../types.js";
+import type { Icon, PeopleValue, PlaceValue, RelationValue, Schedule, SyncSchedule, TextValue } from "../types.js";
+import type { CapabilityContext } from "./context.js";
 /**
  * Maps a property configuration to its corresponding value type.
  */
@@ -7,7 +8,9 @@ type PropertyValueType<T extends PropertyConfiguration> = T extends {
     type: "people";
 } ? PeopleValue : T extends {
     type: "place";
-} ? PlaceValue : TextValue;
+} ? PlaceValue : T extends {
+    type: "relation";
+} ? RelationValue : TextValue;
 /**
  * Sync mode determines how the sync handles data lifecycle.
  */
@@ -67,7 +70,7 @@ export type SyncChange<PK extends string, S extends PropertySchema<PK>> = SyncCh
 /**
  * Result returned from the sync execute function.
  */
-export type SyncExecutionResult<PK extends string, Context = unknown> = {
+export type SyncExecutionResult<PK extends string, State = unknown> = {
     /**
      * The batch of changes to apply in this execution.
      * Can include upserts (create/update) and deletes.
@@ -75,23 +78,23 @@ export type SyncExecutionResult<PK extends string, Context = unknown> = {
     changes: SyncChange<PK, PropertySchema<PK>>[];
     /**
      * Indicates whether there is more data to fetch.
-     * - `true`: More data available, will trigger another execution with nextContext
+     * - `true`: More data available, will trigger another execution with nextState
      * - `false`: No more data to fetch, sync is complete
      */
     hasMore: boolean;
     /**
-     * Optional context data to pass to the next execution.
+     * Optional state data to pass to the next execution.
      * Required if `hasMore` is `true`, ignored if `hasMore` is `false`.
      * This can be any type of data (cursor, page number, timestamp, etc.).
-     * The same data will be provided in the context parameter of the next execution.
+     * The same data will be provided as `state` in the next execution.
      */
-    nextContext?: Context;
+    nextState?: State;
 };
 /**
  * A configuration object that enables synchronization between a data
  * source and a third-party source.
  */
-export type SyncConfiguration<PK extends string, S extends Schema<PK>, Context = unknown> = {
+export type SyncConfiguration<PK extends string, S extends Schema<PK>, State = unknown> = {
     /**
      * The property of the data source that maps to a "primary key" in the
      * third-party data. This is used to match existing pages to
@@ -128,31 +131,27 @@ export type SyncConfiguration<PK extends string, S extends Schema<PK>, Context =
      * A function that fetches the data to sync from the third-party service.
      *
      * This function can return all data at once, or implement pagination by:
-     * 1. Returning a batch of changes with `hasMore: true` and a `nextContext`
-     * 2. The runtime will call execute again with that context data
+     * 1. Returning a batch of changes with `hasMore: true` and a `nextState`
+     * 2. The runtime will call execute again with that state
      * 3. Continue until `hasMore: false` is returned
      *
      * The runtime will handle diffing against the data source and creating,
      * updating, and deleting pages as necessary.
      *
-     * @param context - Optional context data from previous execution (undefined on first call)
-     * @returns A result containing changes, hasMore status, and optional nextContext
+     * @param state - User-defined state from the previous execution (undefined on first call)
+     * @param context - Runtime context, including Notion client
+     * @returns A result containing changes, hasMore status, and optional nextState
      */
-    execute: (context?: Context) => Promise<SyncExecutionResult<PK, Context>>;
-};
-export type SyncHandlerResult<PK extends string, Context = unknown> = {
-    primaryKeyProperty: PK;
-    changes: SyncChange<PK, PropertySchema<PK>>[];
-    hasMore: boolean;
-    nextContext?: Context;
-    mode?: SyncMode;
+    execute: (state: State | undefined, context: CapabilityContext) => Promise<SyncExecutionResult<PK, State>>;
 };
 export type SyncCapability = ReturnType<typeof createSyncCapability>;
 /**
- * Context object passed from the runtime to sync capability handlers.
+ * Runtime context object passed from the runtime to sync capability handlers.
  */
 type RuntimeContext<UserContext = unknown> = {
-    /** The user-defined/-controlled context (cursor, pagination state, etc.) */
+    /** The user-defined/-controlled state (cursor, pagination state, etc.) */
+    state?: UserContext;
+    /** Legacy field for user-defined/-controlled state. */
     userContext?: UserContext;
 };
 /**

package/dist/capabilities/sync.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../../src/capabilities/sync.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../../src/capabilities/sync.ts"],"names":[],"mappings":"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"}

package/dist/capabilities/sync.js

@@ -1,4 +1,5 @@
 import { ExecutionError, unreachable } from "../error.js";
+import { createCapabilityContext } from "./context.js";
 function createSyncCapability(key, syncConfiguration) {
   return {
     _tag: "sync",
@@ -10,14 +11,15 @@ function createSyncCapability(key, syncConfiguration) {
       schedule: parseSchedule(syncConfiguration.schedule)
     },
     async handler(runtimeContext) {
-      const userContext = runtimeContext?.userContext;
-      const executionResult = await syncConfiguration.execute(userContext).catch((err) => {
+      const capabilityContext = createCapabilityContext();
+      const state = runtimeContext?.state ?? runtimeContext?.userContext;
+      const executionResult = await syncConfiguration.execute(state, capabilityContext).catch((err) => {
         throw new ExecutionError(err);
       });
       const result = {
         changes: executionResult.changes,
         hasMore: executionResult.hasMore,
-        nextUserContext: executionResult.nextContext
+        nextUserContext: executionResult.nextState
       };
       process.stdout.write(`
 <output>${JSON.stringify(result)}</output>

package/dist/capabilities/sync.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=sync.test.d.ts.map

package/dist/capabilities/sync.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync.test.d.ts","sourceRoot":"","sources":["../../src/capabilities/sync.test.ts"],"names":[],"mappings":""}

package/dist/capabilities/tool.d.ts

@@ -1,11 +1,12 @@
 import { type JSONSchemaType } from "ajv";
 import type { JSONValue } from "../types.js";
+import type { CapabilityContext } from "./context.js";
 export interface ToolConfiguration<I extends JSONValue, O extends JSONValue = JSONValue> {
     title: string;
     description: string;
     schema: JSONSchemaType<I>;
     outputSchema?: JSONSchemaType<O>;
-    execute: (input: I) => O | Promise<O>;
+    execute: (input: I, context: CapabilityContext) => O | Promise<O>;
 }
 /**
  * An error returned when the input to a tool doesn't match the input schema.

package/dist/capabilities/tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../../src/capabilities/tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAO,KAAK,cAAc,EAAE,MAAM,KAAK,CAAC;AAC/C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,MAAM,WAAW,iBAAiB,CACjC,CAAC,SAAS,SAAS,EACnB,CAAC,SAAS,SAAS,GAAG,SAAS;IAE/B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC,CAAC;IAC1B,YAAY,CAAC,EAAE,cAAc,CAAC,CAAC,CAAC,CAAC;IACjC,OAAO,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;CACtC;AAED;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,KAAK;gBACnC,OAAO,EAAE,MAAM;IAK3B,MAAM;;;;CAMN;AAED;;GAEG;AACH,qBAAa,sBAAuB,SAAQ,KAAK;gBACpC,OAAO,EAAE,MAAM;IAK3B,MAAM;;;;CAMN;AAED;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,KAAK;gBAChC,OAAO,EAAE,MAAM;IAK3B,MAAM;;;;CAMN;AAED,MAAM,MAAM,cAAc,CACzB,CAAC,SAAS,SAAS,EACnB,CAAC,SAAS,SAAS,GAAG,SAAS,IAC5B,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;AAElD;;;;;GAKG;AACH,wBAAgB,oBAAoB,CACnC,CAAC,SAAS,SAAS,EACnB,CAAC,SAAS,SAAS,GAAG,SAAS,EAC9B,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,iBAAiB,CAAC,CAAC,EAAE,CAAC,CAAC;;;;;;;;;mBAgBvB,SAAS,GAAG,OAAO,CACrC;QACA,IAAI,EAAE,SAAS,CAAC;QAChB,KAAK,EAAE,CAAC,CAAC;KACR,GACD;QACA,IAAI,EAAE,OAAO,CAAC;QACd,KAAK,EACF,qBAAqB,GACrB,sBAAsB,GACtB,kBAAkB,CAAC;KACrB,CACH;EA0DF"}
+{"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../../src/capabilities/tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAO,KAAK,cAAc,EAAE,MAAM,KAAK,CAAC;AAC/C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAGtD,MAAM,WAAW,iBAAiB,CACjC,CAAC,SAAS,SAAS,EACnB,CAAC,SAAS,SAAS,GAAG,SAAS;IAE/B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC,CAAC;IAC1B,YAAY,CAAC,EAAE,cAAc,CAAC,CAAC,CAAC,CAAC;IACjC,OAAO,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,iBAAiB,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;CAClE;AAED;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,KAAK;gBACnC,OAAO,EAAE,MAAM;IAK3B,MAAM;;;;CAMN;AAED;;GAEG;AACH,qBAAa,sBAAuB,SAAQ,KAAK;gBACpC,OAAO,EAAE,MAAM;IAK3B,MAAM;;;;CAMN;AAED;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,KAAK;gBAChC,OAAO,EAAE,MAAM;IAK3B,MAAM;;;;CAMN;AAED,MAAM,MAAM,cAAc,CACzB,CAAC,SAAS,SAAS,EACnB,CAAC,SAAS,SAAS,GAAG,SAAS,IAC5B,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;AAElD;;;;;GAKG;AACH,wBAAgB,oBAAoB,CACnC,CAAC,SAAS,SAAS,EACnB,CAAC,SAAS,SAAS,GAAG,SAAS,EAC9B,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,iBAAiB,CAAC,CAAC,EAAE,CAAC,CAAC;;;;;;;;;mBAgBvB,SAAS,GAAG,OAAO,CACrC;QACA,IAAI,EAAE,SAAS,CAAC;QAChB,KAAK,EAAE,CAAC,CAAC;KACR,GACD;QACA,IAAI,EAAE,OAAO,CAAC;QACd,KAAK,EACF,qBAAqB,GACrB,sBAAsB,GACtB,kBAAkB,CAAC;KACrB,CACH;EA2DF"}

package/dist/capabilities/tool.js

@@ -1,4 +1,5 @@
 import { Ajv } from "ajv";
+import { createCapabilityContext } from "./context.js";
 class InvalidToolInputError extends Error {
   constructor(message) {
     super(message);
@@ -67,7 +68,8 @@ function createToolCapability(key, config) {
         return result;
       }
       try {
-        const result = await config.execute(input);
+        const capabilityContext = createCapabilityContext();
+        const result = await config.execute(input, capabilityContext);
         if (validateOutput && !validateOutput(result)) {
           const result2 = {
             _tag: "error",

package/dist/index.d.ts

@@ -1,5 +1,6 @@
 export { emojiIcon, imageIcon, notionIcon, place } from "./builder.js";
-export type { AutomationCapability, AutomationConfiguration, AutomationContext, PageObjectResponse, } from "./capabilities/automation.js";
+export type { AutomationCapability, AutomationConfiguration, AutomationEvent, PageObjectResponse, } from "./capabilities/automation.js";
+export type { CapabilityContext } from "./capabilities/context.js";
 export type { NotionManagedOAuthConfiguration, OAuthCapability, OAuthConfiguration, UserManagedOAuthConfiguration, } from "./capabilities/oauth.js";
 export type { SyncCapability, SyncChange, SyncChangeDelete, SyncChangeUpsert, SyncConfiguration, SyncExecutionResult, SyncMode, } from "./capabilities/sync.js";
 export type { ToolCapability, ToolConfiguration } from "./capabilities/tool.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AACvE,YAAY,EACX,oBAAoB,EACpB,uBAAuB,EACvB,iBAAiB,EACjB,kBAAkB,GAClB,MAAM,8BAA8B,CAAC;AACtC,YAAY,EACX,+BAA+B,EAC/B,eAAe,EACf,kBAAkB,EAClB,6BAA6B,GAC7B,MAAM,yBAAyB,CAAC;AACjC,YAAY,EACX,cAAc,EACd,UAAU,EACV,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,EACjB,mBAAmB,EACnB,QAAQ,GACR,MAAM,wBAAwB,CAAC;AAChC,YAAY,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAChF,YAAY,EACX,IAAI,EACJ,SAAS,EACT,YAAY,EACZ,WAAW,EACX,UAAU,EACV,QAAQ,GACR,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AACvE,YAAY,EACX,oBAAoB,EACpB,uBAAuB,EACvB,eAAe,EACf,kBAAkB,GAClB,MAAM,8BAA8B,CAAC;AACtC,YAAY,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AACnE,YAAY,EACX,+BAA+B,EAC/B,eAAe,EACf,kBAAkB,EAClB,6BAA6B,GAC7B,MAAM,yBAAyB,CAAC;AACjC,YAAY,EACX,cAAc,EACd,UAAU,EACV,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,EACjB,mBAAmB,EACnB,QAAQ,GACR,MAAM,wBAAwB,CAAC;AAChC,YAAY,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAChF,YAAY,EACX,IAAI,EACJ,SAAS,EACT,YAAY,EACZ,WAAW,EACX,UAAU,EACV,QAAQ,GACR,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC"}

package/dist/schema.d.ts

@@ -45,6 +45,13 @@ export type PropertyConfiguration = {
     type: "people";
 } | {
     type: "place";
+} | {
+    type: "relation";
+    /**
+     * The export name of the sync capability that defines the related collection.
+     * This must match the export name used when defining the related sync capability.
+     */
+    relatedSyncKey: string;
 };
 export type Schema<PK extends string> = {
     /**
@@ -128,4 +135,25 @@ export declare function people(): PropertyConfiguration;
  * Creates a place property definition for storing geographic locations.
  */
 export declare function place(): PropertyConfiguration;
+/**
+ * Creates a relation property definition that references another sync capability.
+ * The related collection must be defined by a sync capability in the same worker.
+ *
+ * @param relatedSyncKey - The export name of the sync capability that defines the related collection.
+ * @example
+ * ```typescript
+ * export const projectsSync = sync({...});
+ *
+ * export const tasksSync = sync({
+ *   schema: {
+ *     properties: {
+ *       "Task Title": Schema.title(),
+ *       "Project": Schema.relation("projectsSync"),
+ *     },
+ *   },
+ *   ...
+ * });
+ * ```
+ */
+export declare function relation(relatedSyncKey: string): PropertyConfiguration;
 //# sourceMappingURL=schema.d.ts.map

package/dist/schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,UAAU,EACV,IAAI,EACJ,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,MAAM,YAAY,CAAC;AAEpB;;GAEG;AACH,MAAM,MAAM,YAAY,GACrB,OAAO,GACP,WAAW,GACX,KAAK,GACL,OAAO,GACP,cAAc,GACd,UAAU,GACV,MAAM,GACN,QAAQ,GACR,MAAM,GACN,QAAQ,GACR,cAAc,GACd,QAAQ,GACR,QAAQ,GACR,OAAO,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAChC,IAAI,EAAE,YAAY,CAAC;CACnB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAC9B;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,GACjB;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,IAAI,EAAE,KAAK,CAAA;CAAE,GACf;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,GACjB;IAAE,IAAI,EAAE,cAAc,CAAA;CAAE,GACxB;IAAE,IAAI,EAAE,UAAU,CAAA;CAAE,GACpB;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IACA,IAAI,EAAE,QAAQ,CAAC;IACf,MAAM,CAAC,EAAE,YAAY,CAAC;CACrB,GACD;IACA,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,UAAU,CAAC;CACxB,GACD;IACA,IAAI,EAAE,QAAQ,CAAC;IACf,OAAO,EAAE,YAAY,EAAE,CAAC;CACvB,GACD;IACA,IAAI,EAAE,cAAc,CAAC;IACrB,OAAO,EAAE,YAAY,EAAE,CAAC;CACvB,GACD;IACA,IAAI,EAAE,QAAQ,CAAC;IACf,MAAM,EAAE,WAAW,EAAE,CAAC;CACrB,GACD;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,GAClB;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,CAAC;AAErB,MAAM,MAAM,MAAM,CAAC,EAAE,SAAS,MAAM,IAAI;IACvC;;;;;OAKG;IACH,WAAW,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,YAAY,CAAC,EAAE,IAAI,CAAC;IACpB,UAAU,EAAE,cAAc,CAAC,EAAE,CAAC,CAAC;CAC/B,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,cAAc,CAAC,EAAE,SAAS,MAAM,IAAI;KAC9C,UAAU,IAAI,EAAE,GAAG,qBAAqB;CACzC,GAAG;IACH,CAAC,YAAY,EAAE,MAAM,GAAG,qBAAqB,CAAC;CAC9C,CAAC;AAEF;;GAEG;AACH,wBAAgB,KAAK,IAAI,qBAAqB,CAE7C;AAED;;GAEG;AACH,wBAAgB,QAAQ,IAAI,qBAAqB,CAEhD;AAED;;GAEG;AACH,wBAAgB,GAAG,IAAI,qBAAqB,CAE3C;AAED;;GAEG;AACH,wBAAgB,KAAK,IAAI,qBAAqB,CAE7C;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,qBAAqB,CAEnD;AAED;;GAEG;AACH,wBAAgB,QAAQ,IAAI,qBAAqB,CAEhD;AAED;;GAEG;AACH,wBAAgB,IAAI,IAAI,qBAAqB,CAE5C;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,MAAM,CAAC,EAAE,YAAY,GAAG,qBAAqB,CAEnE;AAED;;GAEG;AACH,wBAAgB,IAAI,CAAC,WAAW,CAAC,EAAE,UAAU,GAAG,qBAAqB,CAEpE;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,qBAAqB,CAErE;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,qBAAqB,CAE1E;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,MAAM,EAAE;IAC9B,MAAM,EAAE,WAAW,EAAE,CAAC;CACtB,GAAG,qBAAqB,CAExB;AAED;;GAEG;AACH,wBAAgB,MAAM,IAAI,qBAAqB,CAE9C;AAED;;GAEG;AACH,wBAAgB,KAAK,IAAI,qBAAqB,CAE7C"}
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"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"}

package/dist/schema.js

@@ -40,6 +40,9 @@ function people() {
 function place() {
   return { type: "place" };
 }
+function relation(relatedSyncKey) {
+  return { type: "relation", relatedSyncKey };
+}
 export {
   checkbox,
   date,
@@ -50,6 +53,7 @@ export {
   people,
   phoneNumber,
   place,
+  relation,
   richText,
   select,
   status,

package/dist/types.d.ts

@@ -162,6 +162,18 @@ export interface PlaceValue {
      */
     googlePlaceId?: string;
 }
+/**
+ * A reference to a related record by its primary key.
+ */
+export type RelationReference = {
+    type: "primaryKey";
+    value: string;
+};
+/**
+ * Relation value representing references to related records.
+ * Each reference identifies a record in the target collection.
+ */
+export type RelationValue = RelationReference[];
 /**
  * Time units for schedule intervals.
  * - "m": minutes

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/worker.d.ts

@@ -1,10 +1,11 @@
-import type { AutomationCapability, AutomationConfiguration, AutomationContext } from "./capabilities/automation.js";
+import type { AutomationCapability, AutomationConfiguration, AutomationEvent } from "./capabilities/automation.js";
+import type { CapabilityContext } from "./capabilities/context.js";
 import type { NotionManagedOAuthConfiguration, OAuthCapability, OAuthConfiguration, UserManagedOAuthConfiguration } from "./capabilities/oauth.js";
 import type { SyncCapability, SyncConfiguration } from "./capabilities/sync.js";
 import type { ToolCapability, ToolConfiguration } from "./capabilities/tool.js";
 import type { Schema } from "./schema.js";
 import type { JSONValue } from "./types.js";
-export type { AutomationConfiguration, AutomationContext, OAuthConfiguration, NotionManagedOAuthConfiguration, UserManagedOAuthConfiguration, SyncConfiguration, ToolConfiguration, };
+export type { AutomationConfiguration, AutomationEvent, CapabilityContext, OAuthConfiguration, NotionManagedOAuthConfiguration, UserManagedOAuthConfiguration, SyncConfiguration, ToolConfiguration, };
 type Capability = SyncCapability | ToolCapability<any, any> | AutomationCapability | OAuthCapability;
 export declare class Worker {
     #private;
@@ -72,7 +73,7 @@ export declare class Worker {
      *     },
      *     required: ["name"],
      *   },
-     *   execute: ({ name }) => {
+     *   execute: ({ name }, { notion }) => {
      *     return `Hello, ${name}!`;
      *   },
      * })
@@ -96,8 +97,8 @@ export declare class Worker {
      * worker.automation("sendWelcomeEmail", {
      *   title: "Send Welcome Email",
      *   description: "Sends a welcome email when a new user is added",
-     *   execute: async (context) => {
-     *     const { pageId, pageData } = context;
+     *   execute: async (event, { notion }) => {
+     *     const { pageId, pageData } = event;
      *
      *     // Access page properties from the Public API format
      *     if (pageData) {

package/dist/worker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"worker.d.ts","sourceRoot":"","sources":["../src/worker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,oBAAoB,EACpB,uBAAuB,EACvB,iBAAiB,EACjB,MAAM,8BAA8B,CAAC;AAEtC,OAAO,KAAK,EACX,+BAA+B,EAC/B,eAAe,EACf,kBAAkB,EAClB,6BAA6B,EAC7B,MAAM,yBAAyB,CAAC;AAEjC,OAAO,KAAK,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAEhF,OAAO,KAAK,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAEhF,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAG5C,YAAY,EACX,uBAAuB,EACvB,iBAAiB,EACjB,kBAAkB,EAClB,+BAA+B,EAC/B,6BAA6B,EAC7B,iBAAiB,EACjB,iBAAiB,GACjB,CAAC;AAMF,KAAK,UAAU,GACZ,cAAc,GAEd,cAAc,CAAC,GAAG,EAAE,GAAG,CAAC,GACxB,oBAAoB,GACpB,eAAe,CAAC;AAMnB,qBAAa,MAAM;;IAGlB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8CG;IACH,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM,CAAC,EAAE,CAAC,EAAE,OAAO,GAAG,OAAO,EAC9D,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,iBAAiB,CAAC,EAAE,EAAE,CAAC,EAAE,OAAO,CAAC,GACvC,cAAc;IAOjB;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACH,IAAI,CAAC,CAAC,SAAS,SAAS,EAAE,CAAC,SAAS,SAAS,GAAG,SAAS,EACxD,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,iBAAiB,CAAC,CAAC,EAAE,CAAC,CAAC,GAC7B,cAAc,CAAC,CAAC,EAAE,CAAC,CAAC;IAQvB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA+BG;IACH,UAAU,CACT,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,uBAAuB,GAC7B,oBAAoB;IAOvB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAwCG;IACH,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,kBAAkB,GAAG,eAAe;IAO/D;;OAEG;IACH,IAAI,YAAY,IAAI,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,KAAK,GAAG,QAAQ,CAAC,EAAE,CAMhE;IAED;;;;;;OAMG;IACG,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;CAyB1D"}
+{"version":3,"file":"worker.d.ts","sourceRoot":"","sources":["../src/worker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,oBAAoB,EACpB,uBAAuB,EACvB,eAAe,EACf,MAAM,8BAA8B,CAAC;AAEtC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AACnE,OAAO,KAAK,EACX,+BAA+B,EAC/B,eAAe,EACf,kBAAkB,EAClB,6BAA6B,EAC7B,MAAM,yBAAyB,CAAC;AAEjC,OAAO,KAAK,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAEhF,OAAO,KAAK,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAEhF,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAG5C,YAAY,EACX,uBAAuB,EACvB,eAAe,EACf,iBAAiB,EACjB,kBAAkB,EAClB,+BAA+B,EAC/B,6BAA6B,EAC7B,iBAAiB,EACjB,iBAAiB,GACjB,CAAC;AAMF,KAAK,UAAU,GACZ,cAAc,GAEd,cAAc,CAAC,GAAG,EAAE,GAAG,CAAC,GACxB,oBAAoB,GACpB,eAAe,CAAC;AAMnB,qBAAa,MAAM;;IAGlB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8CG;IACH,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM,CAAC,EAAE,CAAC,EAAE,OAAO,GAAG,OAAO,EAC9D,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,iBAAiB,CAAC,EAAE,EAAE,CAAC,EAAE,OAAO,CAAC,GACvC,cAAc;IAOjB;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACH,IAAI,CAAC,CAAC,SAAS,SAAS,EAAE,CAAC,SAAS,SAAS,GAAG,SAAS,EACxD,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,iBAAiB,CAAC,CAAC,EAAE,CAAC,CAAC,GAC7B,cAAc,CAAC,CAAC,EAAE,CAAC,CAAC;IAQvB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA+BG;IACH,UAAU,CACT,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,uBAAuB,GAC7B,oBAAoB;IAOvB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAwCG;IACH,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,kBAAkB,GAAG,eAAe;IAO/D;;OAEG;IACH,IAAI,YAAY,IAAI,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,KAAK,GAAG,QAAQ,CAAC,EAAE,CAMhE;IAED;;;;;;OAMG;IACG,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;CAyB1D"}

package/dist/worker.js

@@ -73,7 +73,7 @@ class Worker {
    *     },
    *     required: ["name"],
    *   },
-   *   execute: ({ name }) => {
+   *   execute: ({ name }, { notion }) => {
    *     return `Hello, ${name}!`;
    *   },
    * })
@@ -102,8 +102,8 @@ class Worker {
    * worker.automation("sendWelcomeEmail", {
    *   title: "Send Welcome Email",
    *   description: "Sends a welcome email when a new user is added",
-   *   execute: async (context) => {
-   *     const { pageId, pageData } = context;
+   *   execute: async (event, { notion }) => {
+   *     const { pageId, pageData } = event;
    *
    *     // Access page properties from the Public API format
    *     if (pageData) {

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@project-ajax/sdk",
-	"version": "0.0.72",
+	"version": "0.0.75",
 	"description": "An SDK for building workers for the Project Ajax platform",
 	"license": "UNLICENSED",
 	"type": "module",
@@ -58,6 +58,9 @@
 		"typescript": "^5.9.3",
 		"vitest": "^4.0.8"
 	},
+	"peerDependencies": {
+		"@notionhq/client": "^2.2.15"
+	},
 	"dependencies": {
 		"ajv": "^8.17.1"
 	}

package/src/builder.ts

@@ -5,6 +5,7 @@ import type {
 	NoticonColor,
 	PeopleValue,
 	PlaceValue,
+	RelationReference,
 	TextValue,
 } from "./types.js";
 
@@ -199,6 +200,24 @@ export function place(value: PlaceValue): PlaceValue {
 	return value;
 }
 
+/**
+ * Creates a relation reference from a primary key of a related record.
+ * Use an array of relation references as the property value.
+ *
+ * @param primaryKey - The primary key of the related record
+ * @example
+ * ```typescript
+ * // Single relation
+ * { Project: [Builder.relation("project-123")] }
+ *
+ * // Multiple relations
+ * { Projects: [Builder.relation("project-123"), Builder.relation("project-456")] }
+ * ```
+ */
+export function relation(primaryKey: string): RelationReference {
+	return { type: "primaryKey", value: primaryKey };
+}
+
 /**
  * Validates a date string is in YYYY-MM-DD format and represents a valid date.
  */

package/src/capabilities/automation.test.ts

@@ -8,7 +8,7 @@ import {
 	vi,
 } from "vitest";
 import { ExecutionError } from "../error.js";
-import type { AutomationContext, PageObjectResponse } from "./automation.js";
+import type { PageObjectResponse } from "./automation.js";
 import { createAutomationCapability } from "./automation.js";
 
 describe("createAutomationCapability", () => {
@@ -45,14 +45,19 @@ describe("createAutomationCapability", () => {
 			execute: executeFn,
 		});
 
-		const context: AutomationContext = {
+		const event = {
 			pageId: "page-123",
 			actionType: "test_action",
 		};
 
-		await capability.handler(context);
+		await capability.handler(event);
 
-		expect(executeFn).toHaveBeenCalledWith(context);
+		expect(executeFn).toHaveBeenCalledWith(
+			event,
+			expect.objectContaining({
+				notion: expect.any(Object),
+			}),
+		);
 		expect(stdoutSpy).toHaveBeenCalledWith(
 			`\n<output>{"status":"success"}</output>\n`,
 		);
@@ -85,15 +90,20 @@ describe("createAutomationCapability", () => {
 			public_url: null,
 		};
 
-		const context: AutomationContext = {
+		const event = {
 			pageId: "page-789",
 			actionType: "process_page",
 			pageData,
 		};
 
-		await capability.handler(context);
+		await capability.handler(event);
 
-		expect(executeFn).toHaveBeenCalledWith(context);
+		expect(executeFn).toHaveBeenCalledWith(
+			event,
+			expect.objectContaining({
+				notion: expect.any(Object),
+			}),
+		);
 		expect(stdoutSpy).toHaveBeenCalledWith(
 			`\n<output>{"status":"success"}</output>\n`,
 		);
@@ -108,12 +118,12 @@ describe("createAutomationCapability", () => {
 			},
 		});
 
-		const context: AutomationContext = {
+		const event = {
 			pageId: "page-error",
 			actionType: "error_action",
 		};
 
-		await expect(capability.handler(context)).rejects.toThrow(ExecutionError);
+		await expect(capability.handler(event)).rejects.toThrow(ExecutionError);
 
 		expect(stdoutSpy).toHaveBeenCalledWith(
 			`\n<output>{"status":"error","error":{"name":"ExecutionError","message":"Error during worker execution: Error: Something went wrong"}}</output>\n`,
@@ -129,11 +139,11 @@ describe("createAutomationCapability", () => {
 			},
 		});
 
-		const context: AutomationContext = {
+		const event = {
 			actionType: "string_error_action",
 		};
 
-		await expect(capability.handler(context)).rejects.toThrow(ExecutionError);
+		await expect(capability.handler(event)).rejects.toThrow(ExecutionError);
 
 		expect(stdoutSpy).toHaveBeenCalledWith(
 			`\n<output>{"status":"error","error":{"name":"ExecutionError","message":"Error during worker execution: String error"}}</output>\n`,

package/src/capabilities/automation.ts

@@ -1,9 +1,11 @@
 import { ExecutionError } from "../error.js";
+import type { CapabilityContext } from "./context.js";
+import { createCapabilityContext } from "./context.js";
 
 /**
- * Context provided to automation execute functions
+ * Event provided to automation execute functions
  */
-export interface AutomationContext {
+export interface AutomationEvent {
 	/**
 	 * The ID of the page that triggered the automation (if applicable)
 	 */
@@ -56,10 +58,14 @@ export interface AutomationConfiguration {
 
 	/**
 	 * The function that executes when the automation is triggered
-	 * @param context - Context about the automation trigger, including page data if applicable
+	 * @param event - Event data about the automation trigger, including page data if applicable
+	 * @param context - The capability execution context (Notion client, etc.)
 	 * @returns A promise that resolves when the automation completes
 	 */
-	execute: (context: AutomationContext) => Promise<void> | void;
+	execute: (
+		event: AutomationEvent,
+		context: CapabilityContext,
+	) => Promise<void> | void;
 }
 
 /**
@@ -92,9 +98,10 @@ export function createAutomationCapability(
 			title: config.title,
 			description: config.description,
 		},
-		async handler(context: AutomationContext): Promise<void> {
+		async handler(event: AutomationEvent): Promise<void> {
 			try {
-				await config.execute(context);
+				const capabilityContext = createCapabilityContext();
+				await config.execute(event, capabilityContext);
 				process.stdout.write(
 					`\n<output>${JSON.stringify({ status: "success" })}</output>\n`,
 				);

package/src/capabilities/context.ts

@@ -0,0 +1,23 @@
+import { Client } from "@notionhq/client";
+import type { ClientOptions } from "@notionhq/client/build/src/Client.js";
+
+export type CapabilityContext = {
+	/** Notion API SDK client for this execution. */
+	notion: Client;
+};
+
+export function createCapabilityContext(): CapabilityContext {
+	const options: ClientOptions = {};
+
+	if (process.env.NOTION_API_BASE_URL) {
+		options.baseUrl = process.env.NOTION_API_BASE_URL;
+	}
+
+	if (process.env.NOTION_API_TOKEN) {
+		options.auth = process.env.NOTION_API_TOKEN;
+	}
+
+	const notion = new Client(options);
+
+	return { notion };
+}

package/src/capabilities/sync.test.ts

@@ -0,0 +1,102 @@
+import { describe, expect, it } from "vitest";
+import * as Builder from "../builder.js";
+import * as Schema from "../schema.js";
+import { createSyncCapability } from "./sync.js";
+
+describe("Worker.sync", () => {
+	describe("Schema.relation", () => {
+		it("creates a relation property configuration", () => {
+			const relationProp = Schema.relation("projectsSync");
+
+			expect(relationProp).toEqual({
+				type: "relation",
+				relatedSyncKey: "projectsSync",
+			});
+		});
+
+		it("can be used in a schema definition", () => {
+			const capability = createSyncCapability("tasksSync", {
+				primaryKeyProperty: "Task ID",
+				schema: {
+					defaultName: "Tasks",
+					properties: {
+						"Task ID": Schema.title(),
+						Project: Schema.relation("projectsSync"),
+					},
+				},
+				execute: async () => ({
+					changes: [],
+					hasMore: false,
+				}),
+			});
+
+			expect(capability.config.schema.properties.Project).toEqual({
+				type: "relation",
+				relatedSyncKey: "projectsSync",
+			});
+		});
+	});
+
+	describe("Builder.relation", () => {
+		it("creates a relation reference from a primary key", () => {
+			const value = Builder.relation("project-123");
+
+			expect(value).toEqual({ type: "primaryKey", value: "project-123" });
+		});
+
+		it("can be used to build relation arrays", () => {
+			const value = [
+				Builder.relation("project-123"),
+				Builder.relation("project-456"),
+			];
+
+			expect(value).toEqual([
+				{ type: "primaryKey", value: "project-123" },
+				{ type: "primaryKey", value: "project-456" },
+			]);
+		});
+	});
+
+	describe("SyncedObject with relation properties", () => {
+		it("allows relation values in synced objects", async () => {
+			const capability = createSyncCapability("tasksSync", {
+				primaryKeyProperty: "Task ID",
+				schema: {
+					defaultName: "Tasks",
+					properties: {
+						"Task ID": Schema.title(),
+						Project: Schema.relation("projectsSync"),
+					},
+				},
+				execute: async () => ({
+					changes: [
+						{
+							type: "upsert",
+							key: "task-1",
+							properties: {
+								"Task ID": Builder.title("TASK-001"),
+								Project: [Builder.relation("project-123")],
+							},
+						},
+						{
+							type: "upsert",
+							key: "task-2",
+							properties: {
+								"Task ID": Builder.title("TASK-002"),
+								Project: [
+									Builder.relation("project-123"),
+									Builder.relation("project-456"),
+								],
+							},
+						},
+					],
+					hasMore: false,
+				}),
+			});
+
+			// Verify the capability is properly configured
+			expect(capability._tag).toBe("sync");
+			expect(capability.config.primaryKeyProperty).toBe("Task ID");
+		});
+	});
+});

package/src/capabilities/sync.ts

@@ -8,11 +8,14 @@ import type {
 	Icon,
 	PeopleValue,
 	PlaceValue,
+	RelationValue,
 	Schedule,
 	SyncSchedule,
 	TextValue,
 	TimeUnit,
 } from "../types.js";
+import type { CapabilityContext } from "./context.js";
+import { createCapabilityContext } from "./context.js";
 
 /**
  * Maps a property configuration to its corresponding value type.
@@ -23,7 +26,9 @@ type PropertyValueType<T extends PropertyConfiguration> = T extends {
 	? PeopleValue
 	: T extends { type: "place" }
 		? PlaceValue
-		: TextValue;
+		: T extends { type: "relation" }
+			? RelationValue
+			: TextValue;
 
 /**
  * Sync mode determines how the sync handles data lifecycle.
@@ -93,7 +98,7 @@ export type SyncChange<PK extends string, S extends PropertySchema<PK>> =
 /**
  * Result returned from the sync execute function.
  */
-export type SyncExecutionResult<PK extends string, Context = unknown> = {
+export type SyncExecutionResult<PK extends string, State = unknown> = {
 	/**
 	 * The batch of changes to apply in this execution.
 	 * Can include upserts (create/update) and deletes.
@@ -102,18 +107,18 @@ export type SyncExecutionResult<PK extends string, Context = unknown> = {
 
 	/**
 	 * Indicates whether there is more data to fetch.
-	 * - `true`: More data available, will trigger another execution with nextContext
+	 * - `true`: More data available, will trigger another execution with nextState
 	 * - `false`: No more data to fetch, sync is complete
 	 */
 	hasMore: boolean;
 
 	/**
-	 * Optional context data to pass to the next execution.
+	 * Optional state data to pass to the next execution.
 	 * Required if `hasMore` is `true`, ignored if `hasMore` is `false`.
 	 * This can be any type of data (cursor, page number, timestamp, etc.).
-	 * The same data will be provided in the context parameter of the next execution.
+	 * The same data will be provided as `state` in the next execution.
 	 */
-	nextContext?: Context;
+	nextState?: State;
 };
 
 /**
@@ -123,7 +128,7 @@ export type SyncExecutionResult<PK extends string, Context = unknown> = {
 export type SyncConfiguration<
 	PK extends string,
 	S extends Schema<PK>,
-	Context = unknown,
+	State = unknown,
 > = {
 	/**
 	 * The property of the data source that maps to a "primary key" in the
@@ -165,34 +170,32 @@ export type SyncConfiguration<
 	 * A function that fetches the data to sync from the third-party service.
 	 *
 	 * This function can return all data at once, or implement pagination by:
-	 * 1. Returning a batch of changes with `hasMore: true` and a `nextContext`
-	 * 2. The runtime will call execute again with that context data
+	 * 1. Returning a batch of changes with `hasMore: true` and a `nextState`
+	 * 2. The runtime will call execute again with that state
 	 * 3. Continue until `hasMore: false` is returned
 	 *
 	 * The runtime will handle diffing against the data source and creating,
 	 * updating, and deleting pages as necessary.
 	 *
-	 * @param context - Optional context data from previous execution (undefined on first call)
-	 * @returns A result containing changes, hasMore status, and optional nextContext
+	 * @param state - User-defined state from the previous execution (undefined on first call)
+	 * @param context - Runtime context, including Notion client
+	 * @returns A result containing changes, hasMore status, and optional nextState
 	 */
-	execute: (context?: Context) => Promise<SyncExecutionResult<PK, Context>>;
-};
-
-export type SyncHandlerResult<PK extends string, Context = unknown> = {
-	primaryKeyProperty: PK;
-	changes: SyncChange<PK, PropertySchema<PK>>[];
-	hasMore: boolean;
-	nextContext?: Context;
-	mode?: SyncMode;
+	execute: (
+		state: State | undefined,
+		context: CapabilityContext,
+	) => Promise<SyncExecutionResult<PK, State>>;
 };
 
 export type SyncCapability = ReturnType<typeof createSyncCapability>;
 
 /**
- * Context object passed from the runtime to sync capability handlers.
+ * Runtime context object passed from the runtime to sync capability handlers.
  */
 type RuntimeContext<UserContext = unknown> = {
-	/** The user-defined/-controlled context (cursor, pagination state, etc.) */
+	/** The user-defined/-controlled state (cursor, pagination state, etc.) */
+	state?: UserContext;
+	/** Legacy field for user-defined/-controlled state. */
 	userContext?: UserContext;
 };
 
@@ -218,9 +221,10 @@ export function createSyncCapability<
 			schedule: parseSchedule(syncConfiguration.schedule),
 		},
 		async handler(runtimeContext?: RuntimeContext<Context>) {
-			const userContext = runtimeContext?.userContext;
+			const capabilityContext = createCapabilityContext();
+			const state = runtimeContext?.state ?? runtimeContext?.userContext;
 			const executionResult = await syncConfiguration
-				.execute(userContext)
+				.execute(state, capabilityContext)
 				.catch((err) => {
 					throw new ExecutionError(err);
 				});
@@ -228,7 +232,7 @@ export function createSyncCapability<
 			const result = {
 				changes: executionResult.changes,
 				hasMore: executionResult.hasMore,
-				nextUserContext: executionResult.nextContext,
+				nextUserContext: executionResult.nextState,
 			};
 
 			process.stdout.write(`\n<output>${JSON.stringify(result)}</output>\n`);

package/src/capabilities/tool.ts

@@ -1,5 +1,7 @@
 import { Ajv, type JSONSchemaType } from "ajv";
 import type { JSONValue } from "../types.js";
+import type { CapabilityContext } from "./context.js";
+import { createCapabilityContext } from "./context.js";
 
 export interface ToolConfiguration<
 	I extends JSONValue,
@@ -9,7 +11,7 @@ export interface ToolConfiguration<
 	description: string;
 	schema: JSONSchemaType<I>;
 	outputSchema?: JSONSchemaType<O>;
-	execute: (input: I) => O | Promise<O>;
+	execute: (input: I, context: CapabilityContext) => O | Promise<O>;
 }
 
 /**
@@ -127,7 +129,8 @@ export function createToolCapability<
 			}
 
 			try {
-				const result = await config.execute(input);
+				const capabilityContext = createCapabilityContext();
+				const result = await config.execute(input, capabilityContext);
 				if (validateOutput && !validateOutput(result)) {
 					const result = {
 						_tag: "error" as const,

package/src/index.ts

@@ -2,9 +2,10 @@ export { emojiIcon, imageIcon, notionIcon, place } from "./builder.js";
 export type {
 	AutomationCapability,
 	AutomationConfiguration,
-	AutomationContext,
+	AutomationEvent,
 	PageObjectResponse,
 } from "./capabilities/automation.js";
+export type { CapabilityContext } from "./capabilities/context.js";
 export type {
 	NotionManagedOAuthConfiguration,
 	OAuthCapability,

package/src/schema.ts

@@ -64,7 +64,15 @@ export type PropertyConfiguration =
 			groups: StatusGroup[];
 	  }
 	| { type: "people" }
-	| { type: "place" };
+	| { type: "place" }
+	| {
+			type: "relation";
+			/**
+			 * The export name of the sync capability that defines the related collection.
+			 * This must match the export name used when defining the related sync capability.
+			 */
+			relatedSyncKey: string;
+	  };
 
 export type Schema<PK extends string> = {
 	/**
@@ -191,3 +199,27 @@ export function people(): PropertyConfiguration {
 export function place(): PropertyConfiguration {
 	return { type: "place" };
 }
+
+/**
+ * Creates a relation property definition that references another sync capability.
+ * The related collection must be defined by a sync capability in the same worker.
+ *
+ * @param relatedSyncKey - The export name of the sync capability that defines the related collection.
+ * @example
+ * ```typescript
+ * export const projectsSync = sync({...});
+ *
+ * export const tasksSync = sync({
+ *   schema: {
+ *     properties: {
+ *       "Task Title": Schema.title(),
+ *       "Project": Schema.relation("projectsSync"),
+ *     },
+ *   },
+ *   ...
+ * });
+ * ```
+ */
+export function relation(relatedSyncKey: string): PropertyConfiguration {
+	return { type: "relation", relatedSyncKey };
+}

package/src/types.ts

@@ -226,6 +226,20 @@ export interface PlaceValue {
 	googlePlaceId?: string;
 }
 
+/**
+ * A reference to a related record by its primary key.
+ */
+export type RelationReference = {
+	type: "primaryKey";
+	value: string;
+};
+
+/**
+ * Relation value representing references to related records.
+ * Each reference identifies a record in the target collection.
+ */
+export type RelationValue = RelationReference[];
+
 /**
  * Time units for schedule intervals.
  * - "m": minutes

package/src/worker.ts

@@ -1,9 +1,10 @@
 import type {
 	AutomationCapability,
 	AutomationConfiguration,
-	AutomationContext,
+	AutomationEvent,
 } from "./capabilities/automation.js";
 import { createAutomationCapability } from "./capabilities/automation.js";
+import type { CapabilityContext } from "./capabilities/context.js";
 import type {
 	NotionManagedOAuthConfiguration,
 	OAuthCapability,
@@ -21,7 +22,8 @@ import type { JSONValue } from "./types.js";
 // Re-export types for convenience
 export type {
 	AutomationConfiguration,
-	AutomationContext,
+	AutomationEvent,
+	CapabilityContext,
 	OAuthConfiguration,
 	NotionManagedOAuthConfiguration,
 	UserManagedOAuthConfiguration,
@@ -120,7 +122,7 @@ export class Worker {
 	 *     },
 	 *     required: ["name"],
 	 *   },
-	 *   execute: ({ name }) => {
+	 *   execute: ({ name }, { notion }) => {
 	 *     return `Hello, ${name}!`;
 	 *   },
 	 * })
@@ -154,8 +156,8 @@ export class Worker {
 	 * worker.automation("sendWelcomeEmail", {
 	 *   title: "Send Welcome Email",
 	 *   description: "Sends a welcome email when a new user is added",
-	 *   execute: async (context) => {
-	 *     const { pageId, pageData } = context;
+	 *   execute: async (event, { notion }) => {
+	 *     const { pageId, pageData } = event;
 	 *
 	 *     // Access page properties from the Public API format
 	 *     if (pageData) {