Workflow guide

Each direct src/workflows/*.ts file must default-export createWorkflow(...). The file name becomes its Workflow key.

Use a step for every result that can change and every external effect. This includes network and Notion API calls, mutable state reads, timestamps, random values, generated IDs, messages, creates, and updates. Keep deterministic transforms of the event and completed step results outside a step.

Completed steps can replay saved results. Do not rely on in-memory mutations inside a step. Return the values required by later code. Keep calls in a stable order and give every step a stable display name. The name is also the replay key by default. For a repeated step, do not interpolate an item ID or loop index into the name; pass a stable composite key instead: