Nathan Colosimo f0dae3867a Simplify start-hook implementation after review pass
- Bump experimentalStartHookLoserAck capability cutoff to 5.0.0-beta.27
  (beta.26 was published from main without this change) and rename it
  away from colliding with World.experimentalStartHookAdmission
- Derive WorkflowStartError.queued from stage (collapses the options
  union and its serialized/reducer/reviver/web-hydration copies)
- Share ExperimentalStartHookSchema/type from @workflow/world; align the
  queue-side token validation (min(1)) with the event schema
- Classify 409 hook_conflict inside the shared errorForResponse so v3
  and v4 request paths map it identically
- Postgres: extract getOwnStartHookClaim/claimStartHookTokenInTx (the
  two run-creation paths had drifted), parallelize hook/claim snapshot
  reads, settle disposed-hook claims with guarded statements instead of
  SELECT-then-branch, drop the retention transaction (statements touch
  disjoint rows), and GC expired claim debris of terminal runs
- Local: one claim lock per token (reclaim and materialize now mutually
  exclude), expiry pre-check before taking the reclaim lock, shared
  settleClaimForDisposedHook, parallel tokens-dir sweep that skips
  already-settled claims and GCs expired debris
- start(): hoist repeated enqueue/create calls, contractError helper,
  drop the positional verifyRunId flag; stop logging raw hook tokens
2026-07-01 16:51:25 -07:00
2025-10-23 12:07:52 +03:00
2025-10-23 12:07:52 +03:00
2025-10-23 12:07:52 +03:00
2026-02-05 16:19:16 -08:00
2025-10-23 12:07:52 +03:00
2025-10-23 12:07:52 +03:00
2025-11-29 21:21:49 -08:00

Workflow SDK logo

Workflow SDK

Vercel logo NPM version License Join the community on GitHub

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://workflow-sdk.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:

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.

S
Description
workflow: Creates durable, resumable workflows using Vercel's Workflow SDK. Use when building workflows that need to survive restarts, pause for external events, retry…; workflow-init: Install and configure Vercel Workflow SDK before it exists in node_modules. Use when the user asks to "install workflow", "set up workflow", "add durable…
Readme 140 MiB
Languages
TypeScript 88.8%
JavaScript 5.9%
Rust 4%
CSS 0.5%
Python 0.4%
Other 0.3%