@notionhq/apps 0.0.40 → 0.0.41

package/README.md

@@ -107,6 +107,60 @@ export default workflow({
 
 The property name is the connection key. Access its typed client with `context.connections.calendar`; use separate keys for separate connections to the same provider.
 
+## Workflow reliability
+
+A workflow's `retry` policy is the default for every step. A step's own `retry`
+replaces it; the two never stack. A run is only retried for failures outside a
+step, such as an error thrown directly in the handler. When a step fails after
+using its retries, the run fails without being retried.
+
+```ts
+import { FatalError, RetryableError } from "@notionhq/apps/workflow";
+
+export default workflow({
+	name: "Charge customer",
+	description: "Charges a customer when an invoice is created",
+	triggers: [events.notionPageCreated()],
+	deadline: { afterMs: 7 * 24 * 60 * 60 * 1000 },
+	retry: { maxAttempts: 3, retryOn: PaymentGatewayError },
+	handler: async (_event, context) => {
+		await context.step(
+			"Charge customer",
+			{ timeoutMs: 30_000, retry: { maxAttempts: 2 } },
+			chargeCustomer,
+		);
+	},
+});
+```
+
+`maxAttempts` includes the initial attempt. Throw `RetryableError` to explicitly
+permit another attempt, optionally with `retryAfterMs`. Throw `FatalError` to
+skip remaining retries. Set `retryOn` to an error class, a predicate, or an
+array of them to retry only matching errors; `RetryableError` is always retried
+and `FatalError` never is.
+
+| Setting                   | Default                         | Limit      |
+| ------------------------- | ------------------------------- | ---------- |
+| `retry.maxAttempts`       | 3                               | 1 to 3     |
+| `retry.initialDelayMs`    | 1 second                        | 7 days     |
+| `retry.backoffMultiplier` | 2                               | at least 1 |
+| `retry.maxDelayMs`        | 5 minutes                       | 7 days     |
+| `retry.retryOn`           | every error except `FatalError` | —          |
+| `deadline.afterMs`        | none                            | 7 days     |
+| step `timeoutMs`          | none                            | —          |
+
+A workflow invocation runs for at most 5 minutes, and step retries wait inside
+it. A step's longest possible retry delays plus `timeoutMs` for every attempt
+must fit in 5 minutes, and so must the workflow `retry` policy because steps
+use it by default. Policies that don't fit are rejected. Time already spent in
+the invocation counts too: if the next retry would run past 5 minutes from the
+handler's start, the step stops retrying and the run is retried instead.
+Use `context.wait.until()` for longer waits.
+
+Step retry delays use jittered exponential backoff. A delay from
+`RetryableError` (`retryAfterMs`) or `RateLimitError` (`retryAfter`, in seconds)
+replaces the computed backoff.
+
 ## Manual workflows
 
 Use `events.manual({ inputSchema })` to declare user-supplied inputs. The SDK

package/dist/error.d.ts

@@ -5,6 +5,17 @@ export declare class ExecutionError extends Error {
     readonly cause: unknown;
     constructor(cause: unknown);
 }
+/** Explicitly permit another workflow or step attempt. */
+export declare class RetryableError extends Error {
+    readonly retryAfterMs: number | undefined;
+    constructor(message: string, options?: {
+        retryAfterMs?: number;
+    });
+}
+/** Skip remaining workflow or step attempts. */
+export declare class FatalError extends Error {
+    constructor(message: string);
+}
 /** Tell the platform that an external service asked the sync to slow down. */
 export declare class RateLimitError extends ExecutionError {
     readonly retryAfter: number | undefined;

package/dist/error.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"error.d.ts","sourceRoot":"","sources":["../src/error.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,cAAe,SAAQ,KAAK;IACxC,SAAkB,KAAK,EAAE,OAAO,CAAC;gBAErB,KAAK,EAAE,OAAO;CAK1B;AAED,8EAA8E;AAC9E,qBAAa,cAAe,SAAQ,cAAc;IACjD,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;gBAE5B,OAAO,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE;CAK7C"}
+{"version":3,"file":"error.d.ts","sourceRoot":"","sources":["../src/error.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,cAAe,SAAQ,KAAK;IACxC,SAAkB,KAAK,EAAE,OAAO,CAAC;gBAErB,KAAK,EAAE,OAAO;CAK1B;AAED,0DAA0D;AAC1D,qBAAa,cAAe,SAAQ,KAAK;IACxC,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;gBAE9B,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE;CAWhE;AAED,gDAAgD;AAChD,qBAAa,UAAW,SAAQ,KAAK;gBACxB,OAAO,EAAE,MAAM;CAI3B;AAED,8EAA8E;AAC9E,qBAAa,cAAe,SAAQ,cAAc;IACjD,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;gBAE5B,OAAO,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE;CAK7C"}

package/dist/error.js

@@ -6,6 +6,23 @@ class ExecutionError extends Error {
     this.cause = cause;
   }
 }
+class RetryableError extends Error {
+  retryAfterMs;
+  constructor(message, options) {
+    super(message);
+    this.name = "RetryableError";
+    if (options?.retryAfterMs !== void 0 && (!Number.isFinite(options.retryAfterMs) || options.retryAfterMs < 0)) {
+      throw new Error("RetryableError retryAfterMs must be zero or greater.");
+    }
+    this.retryAfterMs = options?.retryAfterMs;
+  }
+}
+class FatalError extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "FatalError";
+  }
+}
 class RateLimitError extends ExecutionError {
   retryAfter;
   constructor(options) {
@@ -16,5 +33,7 @@ class RateLimitError extends ExecutionError {
 }
 export {
   ExecutionError,
-  RateLimitError
+  FatalError,
+  RateLimitError,
+  RetryableError
 };

package/dist/workflow.d.ts

@@ -92,6 +92,7 @@ type WorkflowWaitResult = WorkflowWaitUntilResult | WorkflowWaitForInputResult;
 type WorkflowHandlerResult = {
     status: "success";
 } | WorkflowWaitResult;
+export { FatalError, RetryableError } from "./error.js";
 export type { WorkflowAccess, WorkflowAccessAgentLevel, WorkflowAccessBindings, WorkflowAccessDeclaration, WorkflowAccessDeclarations, WorkflowAccessLevel, WorkflowAccessLevelFor, WorkflowAccessResource, ResourceAccessLevel, WorkflowAccessResourceType, WorkflowAccessRequirement, WorkflowAccessRequirements, WorkflowAccessValue, } from "./workflow-access.js";
 export { access } from "./workflow-access.js";
 export type WorkflowEvent = WorkflowEventMap[keyof WorkflowEventMap];
@@ -103,6 +104,32 @@ export type WorkflowEventForTrigger<T extends WorkflowTrigger> = T extends Manua
 } ? WorkflowEventMap[T["type"]] : never;
 export type WorkflowEventForTriggers<T extends readonly WorkflowTrigger[]> = WorkflowEventForTrigger<T[number]>;
 export { connections, type WorkflowConnection, type WorkflowConnectionDeclarations, type WorkflowConnectionRequirement, type WorkflowConnections, type OAuthConfiguration, type OAuthConnection, } from "./connections.js";
+export type WorkflowDeadline = {
+    /** Maximum wall-clock lifetime of one logical workflow run. */
+    afterMs: number;
+};
+/**
+ * An error class, or a predicate, that marks an error as retryable.
+ * Classes match with `instanceof`; any other function is called with the error.
+ */
+export type WorkflowRetryableErrorMatcher = (abstract new (...args: never[]) => Error) | ((error: unknown) => boolean);
+export type WorkflowRetryPolicy = {
+    /** Total attempts, including the initial attempt. At most 4. */
+    maxAttempts: number;
+    /** Delay before the first retry. Defaults to 1 second. */
+    initialDelayMs?: number;
+    /** Maximum delay between attempts. Defaults to 5 minutes. */
+    maxDelayMs?: number;
+    /** Exponential backoff multiplier. Defaults to 2. */
+    backoffMultiplier?: number;
+    /**
+     * Errors that may be retried, as one matcher or an array of matchers. When
+     * set, only matching errors and `RetryableError` are retried; every other
+     * error fails immediately. When omitted, every error except `FatalError` is
+     * retried.
+     */
+    retryOn?: WorkflowRetryableErrorMatcher | readonly WorkflowRetryableErrorMatcher[];
+};
 /**
  * The inbound HTTP request passed to a webhook verify handler.
  */
@@ -192,6 +219,13 @@ export type WorkflowConfiguration<TTriggers extends readonly [WorkflowTrigger, .
      * Connections that must be set up before this workflow can run.
      */
     connections?: TConnections;
+    /** Maximum wall-clock lifetime of one logical workflow run. */
+    deadline?: WorkflowDeadline;
+    /**
+     * Default retry policy for every step, and the retry policy for failures
+     * that happen outside a step. A step's own `retry` replaces it.
+     */
+    retry?: WorkflowRetryPolicy;
     /**
      * Optional synchronous verification handler, run at Notion's webhook
      * ingress before the HTTP response is sent. Use it for providers that
@@ -250,6 +284,8 @@ export type Workflow<TTriggers extends readonly [WorkflowTrigger, ...WorkflowTri
         triggers: WorkflowManifestTrigger[];
         connections?: readonly WorkflowConnectionRequirement[];
         access?: WorkflowAccessRequirements;
+        deadline?: WorkflowDeadline;
+        retry?: WorkflowRetryPolicy;
     };
     handler: (input: WorkflowEventForTriggers<TTriggers> | WebhookVerifyInvocation, options?: HandlerOptions) => Promise<WorkflowHandlerResult | WebhookVerifyResponse | undefined>;
 };
@@ -307,7 +343,11 @@ export type WorkflowStepOptions = {
      * Pass a string for a single key segment or an array of strings for a composite
      * key. Defaults to the step name. Changing the key creates a new logical step.
      */
-    key: string | string[];
+    key?: string | string[];
+    /** Maximum duration of one invocation of the step callback. */
+    timeoutMs?: number;
+    /** Retry policy for failures from this step callback. */
+    retry?: WorkflowRetryPolicy;
 };
 type WorkflowStep = {
     <T>(name: string, fn: (context: StepContext) => T | Promise<T>): Promise<WorkflowStepResult<T>>;

package/dist/workflow.d.ts.map

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

package/dist/workflow.js

@@ -11,7 +11,7 @@ import { createHash } from "node:crypto";
 import { readFile } from "node:fs/promises";
 import { join } from "node:path";
 import { createCapabilityContext } from "./context.js";
-import { ExecutionError } from "./error.js";
+import { ExecutionError, FatalError, RateLimitError, RetryableError } from "./error.js";
 import { writeOutput } from "./output.js";
 import { resolveRuntimeInput } from "./runtime-input.js";
 import { readRunMetadata } from "./runtime-metadata.js";
@@ -47,16 +47,33 @@ const input = {
   }
 };
 const MAX_WORKFLOW_WAIT_MS = 7 * 24 * 60 * 60 * 1e3;
+import { FatalError as FatalError2, RetryableError as RetryableError2 } from "./error.js";
 import { access } from "./workflow-access.js";
 import {
   connections
 } from "./connections.js";
+const MAX_WORKFLOW_RETRY_ATTEMPTS = 3;
+const MAX_WORKFLOW_DURATION_MS = 7 * 24 * 60 * 60 * 1e3;
+const WORKFLOW_STEP_RETRY_BUDGET_MS = 5 * 60 * 1e3;
+const DEFAULT_WORKFLOW_RETRY_POLICY = {
+  maxAttempts: 3,
+  initialDelayMs: 1e3,
+  maxDelayMs: 5 * 60 * 1e3,
+  backoffMultiplier: 2
+};
 function workflow(configuration) {
   const requirements = normalizeConnectionRequirements(configuration.connections ?? {});
   const accessRequirements = normalizeWorkflowAccess(configuration.access);
   const connectionDeclarations = configuration.connections === void 0 ? void 0 : structuredClone(configuration.connections);
   const triggers = typeof configuration.triggers === "function" ? configuration.triggers({ events: createWorkflowEvents() }) : configuration.triggers;
   validateTriggerConnections(triggers, requirements);
+  validateWorkflowDeadline(configuration.deadline);
+  validateWorkflowRetryPolicy(configuration.retry, "Workflow retry policy");
+  if (configuration.retry !== void 0) {
+    validateStepRetryBudget(configuration.retry, void 0, "Workflow retry policy");
+  }
+  const deadline = configuration.deadline === void 0 ? void 0 : structuredClone(configuration.deadline);
+  const retry = configuration.retry === void 0 ? void 0 : manifestRetryPolicy(configuration.retry);
   const manualTriggers = triggers.filter(
     (trigger) => trigger.type === "workflow.manual"
   );
@@ -75,9 +92,13 @@ function workflow(configuration) {
       description: configuration.description,
       triggers: manifestTriggers(triggers, configuration.verify !== void 0),
       ...configuration.connections === void 0 ? {} : { connections: requirements },
-      ...configuration.access === void 0 ? {} : { access: accessRequirements }
+      ...configuration.access === void 0 ? {} : { access: accessRequirements },
+      ...deadline === void 0 ? {} : { deadline },
+      ...retry === void 0 ? {} : { retry }
     },
     async handler(input2, options) {
+      const invocationStartedAt = Date.now();
+      const exhaustedStepErrors = /* @__PURE__ */ new WeakSet();
       try {
         input2 = await resolveRuntimeInput(input2);
         if (isVerifyInvocation(input2)) {
@@ -99,7 +120,11 @@ function workflow(configuration) {
         const event = input2;
         const runMetadata = readRunMetadata();
         const baseContext = createCapabilityContext();
-        const step = createStep(runMetadata);
+        const step = createStep(runMetadata, {
+          defaultRetry: configuration.retry,
+          exhaustedErrors: exhaustedStepErrors,
+          invocationStartedAt
+        });
         const capabilityContext = {
           ...baseContext,
           access: hydrateWorkflowAccess(accessRequirements),
@@ -137,10 +162,27 @@ function workflow(configuration) {
           return;
         }
         const error = new ExecutionError(err);
+        const terminal = err instanceof FatalError || isObject(err) && exhaustedStepErrors.has(err) || !(err instanceof RetryableError) && !isRetryableError(err, configuration.retry);
         if (!options?.concreteOutput) {
           writeOutput({
             _tag: "error",
-            error: {
+            error: !terminal && err instanceof RateLimitError ? {
+              _tag: "rate_limit",
+              name: err.name,
+              message: err.message,
+              ...err.retryAfter === void 0 ? {} : { retryAfter: err.retryAfter }
+            } : !terminal && err instanceof RetryableError ? {
+              _tag: "retryable",
+              name: err.name,
+              message: err.message,
+              trace: err.stack,
+              ...err.retryAfterMs === void 0 ? {} : { retryAfterMs: err.retryAfterMs }
+            } : terminal ? {
+              _tag: "terminal",
+              name: err instanceof Error ? err.name : error.name,
+              message: err instanceof Error ? err.message : error.message,
+              trace: err instanceof Error ? err.stack : error.stack
+            } : {
               name: error.name,
               message: error.message,
               trace: error.stack
@@ -177,16 +219,20 @@ function writeStepEvent(event, value, startedAt, emittedAt = performance.now())
 `
   );
 }
-function createStep(metadata) {
+function createStep(metadata, options) {
   const { runGroupId } = metadata;
+  const { defaultRetry, exhaustedErrors, invocationStartedAt } = options;
   const stepNameByKey = /* @__PURE__ */ new Map();
   async function step(name, optionsOrFn, maybeFn) {
-    const options = typeof optionsOrFn === "function" ? void 0 : optionsOrFn;
+    const stepOptions = typeof optionsOrFn === "function" ? void 0 : optionsOrFn;
     const fn = typeof optionsOrFn === "function" ? optionsOrFn : maybeFn;
     if (!fn) {
       throw new Error(`Workflow step "${name}" is missing its callback.`);
     }
-    const keyInput = options?.key ?? name;
+    validateWorkflowStepOptions(stepOptions);
+    const retry = stepOptions?.retry ?? defaultRetry ?? DEFAULT_WORKFLOW_RETRY_POLICY;
+    validateStepRetryBudget(retry, stepOptions?.timeoutMs, `Workflow step "${name}"`);
+    const keyInput = stepOptions?.key ?? name;
     const key = createWorkflowStepKey(typeof keyInput === "string" ? [keyInput] : keyInput);
     const existingStepName = stepNameByKey.get(key);
     if (existingStepName !== void 0) {
@@ -196,9 +242,7 @@ function createStep(metadata) {
     }
     stepNameByKey.set(key, name);
     const id = `${runGroupId}:${key}`;
-    const stepState = createWorkflowStepState(metadata, id);
-    const context = { id, state: stepState.state };
-    const event = { id: context.id, name, key };
+    const event = { id, name, key };
     const startedAt = performance.now();
     writeStepEvent("started", event, startedAt, startedAt);
     try {
@@ -223,7 +267,16 @@ function createStep(metadata) {
         );
         return checkpoint.value;
       }
-      const value = normalizeWorkflowStepResult(await stepState.run(() => fn(context)));
+      const value = normalizeWorkflowStepResult(
+        await runWorkflowStepCallback({
+          metadata,
+          id,
+          fn,
+          timeoutMs: stepOptions?.timeoutMs,
+          retry,
+          invocationStartedAt
+        })
+      );
       writeStepEvent("success", { ...event, value }, startedAt);
       writeStepEvent(
         "completed",
@@ -234,7 +287,9 @@ function createStep(metadata) {
         startedAt
       );
       return value;
-    } catch (err) {
+    } catch (caught) {
+      const deferred = caught instanceof DeferredStepRetry;
+      const err = deferred ? caught.error : caught;
       const error = new ExecutionError(err);
       writeStepEvent(
         "failure",
@@ -256,11 +311,20 @@ function createStep(metadata) {
         },
         startedAt
       );
+      if (!deferred && isObject(err)) {
+        exhaustedErrors?.add(err);
+      }
       throw err;
     }
   }
   return step;
 }
+class DeferredStepRetry {
+  constructor(error) {
+    this.error = error;
+  }
+  error;
+}
 class WorkflowWaitInterrupt extends Error {
   constructor(result) {
     super(workflowWaitMessage(result));
@@ -430,6 +494,160 @@ function waitDurationUnitMultiplier(unit) {
       throw new Error(`Unsupported workflow wait duration unit: ${unit}`);
   }
 }
+async function runWorkflowStepCallback(args) {
+  let attempt = 1;
+  while (true) {
+    const stepState = createWorkflowStepState(args.metadata, args.id);
+    const context = { id: args.id, state: stepState.state };
+    try {
+      return await stepState.run(() => runWithTimeout(args.fn(context), args.timeoutMs));
+    } catch (error) {
+      if (attempt >= args.retry.maxAttempts || !isRetryableError(error, args.retry)) {
+        throw error;
+      }
+      const delayMs = explicitRetryDelay(error) ?? calculateRetryDelay(args.retry, attempt - 1);
+      const nextAttemptBudgetMs = delayMs + (args.timeoutMs ?? 0);
+      if (Date.now() - args.invocationStartedAt + nextAttemptBudgetMs > WORKFLOW_STEP_RETRY_BUDGET_MS) {
+        throw new DeferredStepRetry(error);
+      }
+      if (delayMs > 0) {
+        await new Promise((resolve) => setTimeout(resolve, delayMs));
+      }
+      attempt += 1;
+    }
+  }
+}
+function isRetryableError(error, policy) {
+  if (error instanceof FatalError) {
+    return false;
+  }
+  if (error instanceof RetryableError || policy?.retryOn === void 0) {
+    return true;
+  }
+  const matchers = typeof policy.retryOn === "function" ? [policy.retryOn] : policy.retryOn;
+  return matchers.some(
+    (matcher) => isErrorClass(matcher) ? error instanceof matcher : matcher(error)
+  );
+}
+function isErrorClass(matcher) {
+  return matcher === Error || matcher.prototype instanceof Error;
+}
+function explicitRetryDelay(error) {
+  if (error instanceof RetryableError) {
+    return error.retryAfterMs;
+  }
+  if (error instanceof RateLimitError && error.retryAfter !== void 0) {
+    return error.retryAfter * 1e3;
+  }
+  return void 0;
+}
+async function runWithTimeout(value, timeoutMs) {
+  if (timeoutMs === void 0) {
+    return await value;
+  }
+  let timer;
+  try {
+    return await Promise.race([
+      value,
+      new Promise((_resolve, reject) => {
+        timer = setTimeout(() => {
+          const error = new Error(`Workflow step timed out after ${timeoutMs}ms.`);
+          error.name = "StepTimeoutError";
+          reject(error);
+        }, timeoutMs);
+      })
+    ]);
+  } finally {
+    if (timer !== void 0) {
+      clearTimeout(timer);
+    }
+  }
+}
+function calculateRetryDelay(policy, retryIndex) {
+  const delayMs = maxRetryDelay(policy, retryIndex);
+  return delayMs / 2 + Math.random() * (delayMs / 2);
+}
+function maxRetryDelay(policy, retryIndex) {
+  const initialDelayMs = policy.initialDelayMs ?? DEFAULT_WORKFLOW_RETRY_POLICY.initialDelayMs;
+  const maxDelayMs = policy.maxDelayMs ?? DEFAULT_WORKFLOW_RETRY_POLICY.maxDelayMs;
+  const backoffMultiplier = policy.backoffMultiplier ?? DEFAULT_WORKFLOW_RETRY_POLICY.backoffMultiplier;
+  return Math.min(initialDelayMs * backoffMultiplier ** retryIndex, maxDelayMs);
+}
+function validateStepRetryBudget(policy, timeoutMs, label) {
+  let worstCaseMs = (timeoutMs ?? 0) * policy.maxAttempts;
+  for (let retryIndex = 0; retryIndex < policy.maxAttempts - 1; retryIndex++) {
+    worstCaseMs += maxRetryDelay(policy, retryIndex);
+  }
+  if (worstCaseMs > WORKFLOW_STEP_RETRY_BUDGET_MS) {
+    throw new Error(
+      `${label} can spend up to ${worstCaseMs}ms on retry delays and timeouts, which exceeds the ${WORKFLOW_STEP_RETRY_BUDGET_MS}ms limit for one workflow invocation. Lower maxAttempts, the retry delays, or timeoutMs, or use context.wait.until() for longer waits.`
+    );
+  }
+}
+function manifestRetryPolicy(policy) {
+  const { retryOn: _retryOn, ...rest } = policy;
+  return structuredClone(rest);
+}
+function validateWorkflowDeadline(deadline) {
+  if (deadline === void 0) {
+    return;
+  }
+  assertPositiveFiniteNumber(deadline.afterMs, "Workflow deadline afterMs");
+  assertAtMost(deadline.afterMs, MAX_WORKFLOW_DURATION_MS, "Workflow deadline afterMs");
+}
+function validateWorkflowRetryPolicy(policy, label) {
+  if (policy === void 0) {
+    return;
+  }
+  if (!Number.isInteger(policy.maxAttempts) || policy.maxAttempts < 1 || policy.maxAttempts > MAX_WORKFLOW_RETRY_ATTEMPTS) {
+    throw new Error(
+      `${label} maxAttempts must be an integer between 1 and ${MAX_WORKFLOW_RETRY_ATTEMPTS}.`
+    );
+  }
+  if (policy.initialDelayMs !== void 0) {
+    assertNonNegativeFiniteNumber(policy.initialDelayMs, `${label} initialDelayMs`);
+    assertAtMost(policy.initialDelayMs, MAX_WORKFLOW_DURATION_MS, `${label} initialDelayMs`);
+  }
+  if (policy.maxDelayMs !== void 0) {
+    assertNonNegativeFiniteNumber(policy.maxDelayMs, `${label} maxDelayMs`);
+    assertAtMost(policy.maxDelayMs, MAX_WORKFLOW_DURATION_MS, `${label} maxDelayMs`);
+  }
+  if (policy.retryOn !== void 0 && typeof policy.retryOn !== "function" && (!Array.isArray(policy.retryOn) || policy.retryOn.some((matcher) => typeof matcher !== "function"))) {
+    throw new Error(
+      `${label} retryOn must be an error class, a predicate, or an array of them.`
+    );
+  }
+  if (policy.initialDelayMs !== void 0 && policy.maxDelayMs !== void 0 && policy.maxDelayMs < policy.initialDelayMs) {
+    throw new Error(`${label} maxDelayMs must be at least initialDelayMs.`);
+  }
+  if (policy.backoffMultiplier !== void 0 && (!Number.isFinite(policy.backoffMultiplier) || policy.backoffMultiplier < 1)) {
+    throw new Error(`${label} backoffMultiplier must be at least one.`);
+  }
+}
+function validateWorkflowStepOptions(options) {
+  if (options?.timeoutMs !== void 0) {
+    assertPositiveFiniteNumber(options.timeoutMs, "Workflow step timeoutMs");
+  }
+  validateWorkflowRetryPolicy(options?.retry, "Workflow step retry policy");
+}
+function assertAtMost(value, max, label) {
+  if (value > max) {
+    throw new Error(`${label} must be at most ${max}.`);
+  }
+}
+function isObject(value) {
+  return typeof value === "object" && value !== null || typeof value === "function";
+}
+function assertPositiveFiniteNumber(value, label) {
+  if (!Number.isFinite(value) || value <= 0) {
+    throw new Error(`${label} must be greater than zero.`);
+  }
+}
+function assertNonNegativeFiniteNumber(value, label) {
+  if (!Number.isFinite(value) || value < 0) {
+    throw new Error(`${label} must be zero or greater.`);
+  }
+}
 function createWorkflowStepKey(segments) {
   if (segments.length === 0) {
     throw new Error("Workflow step keys must contain at least one segment.");
@@ -495,6 +713,8 @@ function isNodeError(error) {
   return error instanceof Error && "code" in error;
 }
 export {
+  FatalError2 as FatalError,
+  RetryableError2 as RetryableError,
   access,
   connections,
   input,

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@notionhq/apps",
-	"version": "0.0.40",
+	"version": "0.0.41",
 	"description": "An SDK for building workflow apps for Notion",
 	"license": "MIT",
 	"bin": {

package/skills/workflow/SKILL.md

@@ -99,6 +99,52 @@ await context.step("Process page", { key: ["process-page", page.id] }, async ({
 
 Keys must be stable across retries and unique within one workflow run.
 
+Configure a workflow deadline and retry policy only when the platform defaults do
+not fit the workflow:
+
+```ts
+export default workflow({
+	name: "Charge customer",
+	description: "Charges a customer when an invoice is created",
+	triggers: [events.notionPageCreated()],
+	deadline: { afterMs: 7 * 24 * 60 * 60 * 1000 },
+	retry: {
+		maxAttempts: 3,
+		initialDelayMs: 5_000,
+		maxDelayMs: 5 * 60 * 1000,
+		backoffMultiplier: 2,
+	},
+	handler: async (_event, context) => {
+		await context.step(
+			"Charge customer",
+			{ timeoutMs: 30_000, retry: { maxAttempts: 2 } },
+			chargeCustomer,
+		);
+	},
+});
+```
+
+The workflow `retry` policy is the default for every step; a step's `retry`
+replaces it rather than stacking. The run itself is retried only for failures
+outside a step. A step that fails after using its retries fails the run.
+
+`maxAttempts` includes the initial attempt and is at most 4. Without any policy,
+steps make 3 attempts with jittered backoff starting at 1 second, doubling, and
+capped at 5 minutes. A step retries ordinary errors and `RetryableError`, but
+stops immediately for `FatalError`. Set `retryOn` to an error class, a predicate,
+or an array of them to retry only matching errors, for example
+`retryOn: TimeoutError` or `retryOn: [TimeoutError, RateLimitError]`. Pass
+`retryAfterMs` to `RetryableError` when the failing service provides an explicit
+delay. Workflow deadlines include retry delays and are at most 7 days, and step
+timeouts apply to one callback attempt.
+
+Step retries wait inside one workflow invocation, which runs for at most 5
+minutes. The longest possible retry delays plus `timeoutMs` for every attempt
+must fit in 5 minutes, for step policies and for the workflow `retry` policy
+that steps inherit. Earlier work in the invocation counts against the same 5
+minutes; a retry that no longer fits is left to a run retry. Use
+`context.wait.until()` for longer waits.
+
 An external effect can succeed before its step result is saved. Pass the
 callback `id` as an idempotency key when supported; otherwise use a stable
 external ID, upsert, or duplicate check.