@notionhq/workers 0.0.82

package/dist/capabilities/automation.d.ts

@@ -0,0 +1,91 @@
+import type { HandlerOptions } from "../types.js";
+import type { CapabilityContext } from "./context.js";
+/**
+ * Event provided to automation execute functions
+ */
+export interface AutomationEvent {
+    /**
+     * The ID of the page that triggered the automation (if applicable)
+     */
+    pageId?: string;
+    /**
+     * The type of automation action that was triggered
+     */
+    actionType: string;
+    /**
+     * The full page object from Notion's Public API (if triggered by a database page)
+     */
+    pageData?: PageObjectResponse;
+}
+/**
+ * Page object from Notion's Public API
+ * This represents a database page with all its properties.
+ * Properties are in Notion's Public API format.
+ * See: https://developers.notion.com/reference/page
+ */
+export interface PageObjectResponse {
+    object: "page";
+    id: string;
+    created_time: string;
+    last_edited_time: string;
+    created_by: {
+        id: string;
+    };
+    last_edited_by: {
+        id: string;
+    };
+    cover: unknown;
+    icon: unknown;
+    parent: unknown;
+    archived: boolean;
+    properties: Record<string, unknown>;
+    url: string;
+    public_url?: string | null;
+}
+/**
+ * Configuration for an automation capability
+ */
+export interface AutomationConfiguration {
+    /**
+     * Title of the automation - shown in the UI when selecting automations
+     */
+    title: string;
+    /**
+     * Description of what this automation does - shown in the UI
+     */
+    description: string;
+    /**
+     * The function that executes when the automation is triggered
+     * @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: (event: AutomationEvent, context: CapabilityContext) => Promise<void> | void;
+}
+/**
+ * Result returned from automation execution
+ */
+export interface AutomationHandlerResult {
+    title: string;
+    description: string;
+}
+export type AutomationCapability = ReturnType<typeof createAutomationCapability>;
+/**
+ * Creates an automation capability from configuration.
+ *
+ * @param key - The unique name for this capability.
+ * @param config - The automation configuration.
+ * @returns The capability object.
+ */
+export declare function createAutomationCapability(key: string, config: AutomationConfiguration): {
+    _tag: "automation";
+    key: string;
+    config: {
+        title: string;
+        description: string;
+    };
+    handler(event: AutomationEvent, options?: HandlerOptions): Promise<{
+        status: "success";
+    } | undefined>;
+};
+//# sourceMappingURL=automation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"automation.d.ts","sourceRoot":"","sources":["../../src/capabilities/automation.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,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;;;;;;;mBAUtB,eAAe,YACZ,cAAc,GACtB,OAAO,CAAC;QAAE,MAAM,EAAE,SAAS,CAAA;KAAE,GAAG,SAAS,CAAC;EAyB9C"}

package/dist/capabilities/automation.js

@@ -0,0 +1,40 @@
+import { ExecutionError } from "../error.js";
+import { createCapabilityContext } from "./context.js";
+function createAutomationCapability(key, config) {
+  return {
+    _tag: "automation",
+    key,
+    config: {
+      title: config.title,
+      description: config.description
+    },
+    async handler(event, options) {
+      try {
+        const capabilityContext = createCapabilityContext();
+        await config.execute(event, capabilityContext);
+        if (options?.concreteOutput) {
+          return { status: "success" };
+        } else {
+          process.stdout.write(
+            `
+<output>${JSON.stringify({ status: "success" })}</output>
+`
+          );
+        }
+      } catch (err) {
+        const error = new ExecutionError(err);
+        if (!options?.concreteOutput) {
+          process.stdout.write(
+            `
+<output>${JSON.stringify({ status: "error", error: { name: error.name, message: error.message } })}</output>
+`
+          );
+        }
+        throw error;
+      }
+    }
+  };
+}
+export {
+  createAutomationCapability
+};

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

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

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

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

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/oauth.d.ts

@@ -0,0 +1,120 @@
+/**
+ * Configuration for a Notion-managed OAuth provider.
+ *
+ * Notion owns the OAuth app credentials (client ID/secret) and the backend has
+ * pre-configured provider settings.
+ */
+export interface NotionManagedOAuthConfiguration {
+    /**
+     * The unique identifier for this OAuth provider instance.
+     */
+    name: string;
+    /**
+     * The pre-configured provider to use (e.g., "google", "github", "salesforce").
+     * The backend will use this to look up the OAuth configuration.
+     */
+    provider: string;
+    /**
+     * Optional default access token expiry (in milliseconds) to use when the OAuth provider
+     * does not return `expires_in` in token responses.
+     *
+     * Some providers (e.g. Salesforce in certain configurations) may omit expiry information.
+     */
+    accessTokenExpireMs?: number;
+}
+/**
+ * Configuration for a user-managed OAuth provider.
+ *
+ * You own the OAuth app credentials and must explicitly provide endpoints and
+ * other OAuth parameters.
+ */
+export interface UserManagedOAuthConfiguration {
+    /**
+     * The unique identifier for this OAuth provider instance.
+     */
+    name: string;
+    /**
+     * The client ID for the OAuth app.
+     */
+    clientId: string;
+    /**
+     * The client secret for the OAuth app.
+     */
+    clientSecret: string;
+    /**
+     * The OAuth 2.0 authorization endpoint URL.
+     */
+    authorizationEndpoint: string;
+    /**
+     * The OAuth 2.0 token endpoint URL.
+     */
+    tokenEndpoint: string;
+    /**
+     * The OAuth scope(s) to request.
+     */
+    scope: string;
+    /**
+     * Optional additional authorization parameters to include in the authorization request.
+     */
+    authorizationParams?: Record<string, string>;
+    /**
+     * Optional callback URL for OAuth redirect.
+     */
+    callbackUrl?: string;
+    /**
+     * Optional default access token expiry (in milliseconds) to use when the OAuth provider
+     * does not return `expires_in` in token responses.
+     *
+     * Some providers (e.g. Salesforce in certain configurations) may omit expiry information.
+     */
+    accessTokenExpireMs?: number;
+}
+/**
+ * Union type representing either Notion-managed or user-managed OAuth configuration.
+ */
+export type OAuthConfiguration = NotionManagedOAuthConfiguration | UserManagedOAuthConfiguration;
+export type OAuthCapability = ReturnType<typeof createOAuthCapability>;
+/**
+ * Creates an OAuth provider configuration for authenticating with third-party services.
+ *
+ * @param config - The OAuth configuration (Notion-managed or user-managed).
+ * @returns An OAuth provider definition.
+ */
+export declare function createOAuthCapability(key: string, config: OAuthConfiguration): {
+    _tag: "oauth";
+    key: string;
+    envKey: string;
+    accessToken(): Promise<string>;
+    config: {
+        type: "notion_managed";
+        name: string;
+        provider: string;
+        accessTokenExpireMs: number | undefined;
+        authorizationEndpoint?: never;
+        tokenEndpoint?: never;
+        scope?: never;
+        clientId?: never;
+        clientSecret?: never;
+        authorizationParams?: never;
+        callbackUrl?: never;
+    };
+} | {
+    _tag: "oauth";
+    key: string;
+    envKey: string;
+    accessToken(): Promise<string>;
+    config: {
+        type: "user_managed";
+        name: string;
+        authorizationEndpoint: string;
+        tokenEndpoint: string;
+        scope: string;
+        clientId: string;
+        clientSecret: string;
+        authorizationParams: Record<string, string> | undefined;
+        callbackUrl: string | undefined;
+        accessTokenExpireMs: number | undefined;
+        provider?: never;
+    };
+};
+//# sourceMappingURL=oauth.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"oauth.d.ts","sourceRoot":"","sources":["../../src/capabilities/oauth.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,WAAW,+BAA+B;IAC/C;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;;OAGG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;;;;OAKG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;;;;GAKG;AACH,MAAM,WAAW,6BAA6B;IAC7C;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,YAAY,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,qBAAqB,EAAE,MAAM,CAAC;IAE9B;;OAEG;IACH,aAAa,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAE7C;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;;;OAKG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAC3B,+BAA+B,GAC/B,6BAA6B,CAAC;AAEjC,MAAM,MAAM,eAAe,GAAG,UAAU,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEvE;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,kBAAkB;;;;mBAQrD,OAAO,CAAC,MAAM,CAAC;;;;;;;;;;;;;;;;;;mBAgBhB,OAAO,CAAC,MAAM,CAAC;;;;;;;;;;;;;;EAgBrC"}

package/dist/capabilities/oauth.js

@@ -0,0 +1,55 @@
+function createOAuthCapability(key, config) {
+  const envKey = oauthNameToEnvKey(config.name);
+  if ("provider" in config) {
+    return {
+      _tag: "oauth",
+      key,
+      envKey,
+      async accessToken() {
+        return readRequiredEnvVar(envKey, { name: config.name });
+      },
+      config: {
+        type: "notion_managed",
+        name: config.name,
+        provider: config.provider,
+        accessTokenExpireMs: config.accessTokenExpireMs
+      }
+    };
+  }
+  return {
+    _tag: "oauth",
+    key,
+    envKey,
+    async accessToken() {
+      return readRequiredEnvVar(envKey, { name: config.name });
+    },
+    config: {
+      type: "user_managed",
+      name: config.name,
+      authorizationEndpoint: config.authorizationEndpoint,
+      tokenEndpoint: config.tokenEndpoint,
+      scope: config.scope,
+      clientId: config.clientId,
+      clientSecret: config.clientSecret,
+      authorizationParams: config.authorizationParams,
+      callbackUrl: config.callbackUrl,
+      accessTokenExpireMs: config.accessTokenExpireMs
+    }
+  };
+}
+function oauthNameToEnvKey(identifier) {
+  const encoded = Buffer.from(identifier).toString("hex").toUpperCase();
+  return `OAUTH_${encoded}_ACCESS_TOKEN`;
+}
+function readRequiredEnvVar(key, context) {
+  const value = process.env[key];
+  if (value) {
+    return value;
+  }
+  throw new Error(
+    `Missing OAuth access token env var "${key}" (name: "${context.name}"). Make sure you've completed OAuth for this capability and are running inside the worker runtime.`
+  );
+}
+export {
+  createOAuthCapability
+};

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

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

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

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

package/dist/capabilities/sync.d.ts

@@ -0,0 +1,180 @@
+import type { PropertyConfiguration, PropertySchema, Schema } from "../schema.js";
+import type { HandlerOptions, 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.
+ */
+type PropertyValueType<T extends PropertyConfiguration> = T extends {
+    type: "people";
+} ? PeopleValue : T extends {
+    type: "place";
+} ? PlaceValue : T extends {
+    type: "relation";
+} ? RelationValue : TextValue;
+/**
+ * Sync mode determines how the sync handles data lifecycle.
+ */
+export type SyncMode = "replace" | "incremental";
+/**
+ * A change representing a record to be created or updated.
+ */
+export type SyncChangeUpsert<PK extends string, S extends PropertySchema<PK>> = {
+    /**
+     * The type of change. Use `"upsert"` to create or update a record.
+     */
+    type: "upsert";
+    /**
+     * A unique identifier for this record, used to match against existing pages.
+     * This value will be stored in the property specified by `primaryKeyProperty`.
+     */
+    key: string;
+    /**
+     * The property values for this record.
+     * Keys must match the property names defined in the schema.
+     * Use the Builder helpers (e.g., `Builder.title()`, `Builder.richText()`) to create values.
+     */
+    properties: {
+        [Property in keyof S]: PropertyValueType<S[Property]>;
+    };
+    /**
+     * Optional icon to use as the icon for this row's page.
+     * Use the `Builder.emojiIcon()`, `Builder.notionIcon()`, or `Builder.imageIcon()` helpers.
+     */
+    icon?: Icon;
+    /**
+     * Optional markdown content to add to the page body.
+     * This will be converted to Notion blocks and added as page content.
+     */
+    pageContentMarkdown?: string;
+};
+/**
+ * A change representing a record to be deleted.
+ * Only applicable when using `mode: "incremental"`.
+ */
+export type SyncChangeDelete = {
+    /**
+     * The type of change. Use `"delete"` to remove a record.
+     */
+    type: "delete";
+    /**
+     * The unique identifier of the record to delete.
+     * Must match the `key` of a previously upserted record.
+     */
+    key: string;
+};
+/**
+ * A change to be applied to the synced database.
+ * Can be either an upsert (create/update) or a delete.
+ */
+export type SyncChange<PK extends string, S extends PropertySchema<PK>> = SyncChangeUpsert<PK, S> | SyncChangeDelete;
+/**
+ * Result returned from the sync execute function.
+ */
+export type SyncExecutionResult<PK extends string, State = unknown> = {
+    /**
+     * The batch of changes to apply in this execution.
+     * Can include upserts (create/update) and deletes.
+     */
+    changes: SyncChange<PK, PropertySchema<PK>>[];
+    /**
+     * Indicates whether there is more data to fetch.
+     * - `true`: More data available, will trigger another execution with nextState
+     * - `false`: No more data to fetch, sync is complete
+     */
+    hasMore: boolean;
+    /**
+     * 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 as `state` in the next execution.
+     */
+    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>, 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
+     * records in the third-party service. Must be a property defined in the schema.
+     */
+    primaryKeyProperty: PK;
+    /**
+     * The schema defining the structure of properties in the collection.
+     */
+    schema: S;
+    /**
+     * How the sync handles data lifecycle:
+     * - "replace": Each sync returns the complete dataset. After hasMore:false,
+     *              pages not seen in this sync run are deleted.
+     * - "incremental": Sync returns changes only. After hasMore:false, sync
+     *                  continues from saved cursor. Use delete markers
+     *                  to explicitly remove pages.
+     *
+     * @default "replace"
+     */
+    mode?: SyncMode;
+    /**
+     * How often the sync should run.
+     * - "continuous": Run as frequently as the system allows
+     * - Interval string: Run at specified intervals, e.g. "1h", "30m", "1d"
+     *
+     * Minimum interval: 1 minute ("1m")
+     * Maximum interval: 7 days ("7d")
+     *
+     * @default "30m"
+     */
+    schedule?: Schedule;
+    /**
+     * 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 `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 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: (state: State | undefined, context: CapabilityContext) => Promise<SyncExecutionResult<PK, State>>;
+};
+export type SyncCapability = ReturnType<typeof createSyncCapability>;
+/**
+ * Runtime context object passed from the runtime to sync capability handlers.
+ */
+type RuntimeContext<UserContext = unknown> = {
+    /** The user-defined/-controlled state (cursor, pagination state, etc.) */
+    state?: UserContext;
+    /** Legacy field for user-defined/-controlled state. */
+    userContext?: UserContext;
+};
+/**
+ * Creates a special handler for syncing third-party data to a collection.
+ *
+ * @param syncConfiguration - The configuration for the sync.
+ * @returns A handler function that executes the sync function, and passes data
+ * needed to complete the sync back to the platform.
+ */
+export declare function createSyncCapability<PK extends string, S extends Schema<PK>, Context = unknown>(key: string, syncConfiguration: SyncConfiguration<PK, S, Context>): {
+    _tag: "sync";
+    key: string;
+    config: {
+        primaryKeyProperty: PK;
+        schema: S;
+        mode: SyncMode | undefined;
+        schedule: SyncSchedule;
+    };
+    handler(runtimeContext?: RuntimeContext<Context>, options?: HandlerOptions): Promise<{
+        changes: SyncChange<PK, PropertySchema<PK>>[];
+        hasMore: boolean;
+        nextUserContext: Context | undefined;
+    }>;
+};
+export {};
+//# sourceMappingURL=sync.d.ts.map

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

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

package/dist/capabilities/sync.js

@@ -0,0 +1,84 @@
+import { ExecutionError, unreachable } from "../error.js";
+import { createCapabilityContext } from "./context.js";
+function createSyncCapability(key, syncConfiguration) {
+  return {
+    _tag: "sync",
+    key,
+    config: {
+      primaryKeyProperty: syncConfiguration.primaryKeyProperty,
+      schema: syncConfiguration.schema,
+      mode: syncConfiguration.mode,
+      schedule: parseSchedule(syncConfiguration.schedule)
+    },
+    async handler(runtimeContext, options) {
+      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.nextState
+      };
+      if (options?.concreteOutput) {
+        return result;
+      } else {
+        process.stdout.write(`
+<output>${JSON.stringify(result)}</output>
+`);
+      }
+      return result;
+    }
+  };
+}
+const MS_PER_MINUTE = 60 * 1e3;
+const MS_PER_HOUR = 60 * MS_PER_MINUTE;
+const MS_PER_DAY = 24 * MS_PER_HOUR;
+const MIN_INTERVAL_MS = MS_PER_MINUTE;
+const MAX_INTERVAL_MS = 7 * MS_PER_DAY;
+const DEFAULT_INTERVAL_MS = 30 * MS_PER_MINUTE;
+function parseSchedule(schedule) {
+  if (schedule === "continuous") {
+    return { type: "continuous" };
+  }
+  if (!schedule) {
+    return { type: "interval", intervalMs: DEFAULT_INTERVAL_MS };
+  }
+  const match = schedule.match(/^(\d+)(m|h|d)$/);
+  if (!match || !match[1] || !match[2]) {
+    throw new Error(
+      `Invalid schedule format: "${schedule}". Use "continuous" or an interval like "30m", "1h", "1d".`
+    );
+  }
+  const value = parseInt(match[1], 10);
+  const unit = match[2];
+  let intervalMs;
+  switch (unit) {
+    case "m":
+      intervalMs = value * MS_PER_MINUTE;
+      break;
+    case "h":
+      intervalMs = value * MS_PER_HOUR;
+      break;
+    case "d":
+      intervalMs = value * MS_PER_DAY;
+      break;
+    default:
+      unreachable(unit);
+  }
+  if (intervalMs < MIN_INTERVAL_MS) {
+    throw new Error(
+      `Schedule interval must be at least 1 minute. Got: "${schedule}"`
+    );
+  }
+  if (intervalMs > MAX_INTERVAL_MS) {
+    throw new Error(
+      `Schedule interval must be at most 7 days. Got: "${schedule}"`
+    );
+  }
+  return { type: "interval", intervalMs };
+}
+export {
+  createSyncCapability
+};

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":""}