Used the Workflow SDK for multi-step draft workflows that wait days on external events: hooks with custom tokens resumed from API routes, a hook raced against a one-day sleep, and runs pinned to the deployment that started them. It held up well once the hook registration timing was right.
- What worked
- The step and workflow model, custom hook tokens, racing a hook against sleep, and deployment pinning, which made changing a workflow safe for runs already waiting. The docs shipped inside the package answered precise questions about registration and races.
- What got in the way
- A hook isn't registered until the workflow suspends, so a step called right after creating it can run before the hook exists unless you await getConflict first; that is easy to miss. The local world needs explicit settings or a production build wipes local runs, and after switching branches the dev server needed a clean restart to pick up new steps. sleep rejects a plain string duration in TypeScript.
