* perf(world-local): index hook lookups instead of scanning the global event log Hook creation, hook cache rebuilds, and token lookups previously read and parsed every event file ever written across all runs, and run termination read every live hook entity — making every turn of a long-lived local session slower as history accumulated. Maintain durable per-token / per-hookId indexes and per-run hook markers (with a one-time backfill for pre-index data dirs), resolve tokens through the claim file, read directory listings concurrently, reuse compiled filename regexes, and raise the recovery page size. * chore: trim development comments * test(world-local): make hook-index perf guard machine-speed independent The absolute 2s wall-clock bound timed out on Windows CI, where filesystem operations are ~50x slower. Compare hook-creation cost before vs. after seeding foreign event history instead. * review: keep world package untouched, batch backfill reads - Revert the recovery page-size change in @workflow/world; default world-local runs.list to a 200-item page instead - Read backfill event/hook files with bounded concurrency (32), matching paginatedFileSystemQuery, to cut one-time migration cost on large legacy data dirs (slow-fs platforms especially) Signed-off-by: Andrew Barba <barba@hey.com>
Getting Started
The Workflow SDK lets you easily add durability, reliability, and observability to async JavaScript. Build apps and AI agents that can suspend, resume, and maintain state with ease.
Visit https://useworkflow.dev to view the full documentation.
Community
The Workflow SDK community can be found on GitHub Discussions, where you can ask questions, voice ideas, and share your projects with other people.
Contributing
Contributions to Workflow SDK are welcome and highly appreciated. Please use GitHub issues and discussions to collaborate with the team and wider community.
Author list
Workflow SDK was built by engineers at Vercel and the Open Source Community.
The initial core contributing engineers are:
- Adrian Lam (@adriandlam)
- Dillon Mulroy (@dmmulroy)
- Gal Schlezinger (@Schniz)
- JJ Kasper (@ijjk)
- Nathan Rajlich (@TooTallNate)
- Peter Wielander (@VaguelySerious)
- Pranay Prakash (@pranaygp)
The Workflow SDK logo was designed by Cecilio Ruiz @ceciliorz
Security
If you believe you have found a security vulnerability in Workflow SDK, we encourage you to responsibly disclose this and not open a public issue.
To participate in our Open Source Software Bug Bounty program, please email responsible.disclosure@vercel.com. We will add you to the program and provide further instructions for submitting your report.