Version Packages

[github-actions]

This PR was opened by the Changesets release GitHub action. When you're ready to do a release, you can merge this and the packages will be published to npm automatically. If you're not ready to do a release yet, that's fine, whenever you add more changesets to main, this PR will be updated.

Releases

@workflow/core@5.1.0

Minor Changes

• #4578 941e031 Thanks @wycats! - Export the existing Serializable type from @workflow/core and workflow.

Patch Changes

• #4595 09bc2f8 Thanks @TooTallNate! - Remove the unused, stale vm-serde-bundle.generated.ts left over from the retired in-VM QuickJS serializer.

• #4496 8fa7584 Thanks @alangenfeld! - Mark step_failed writes that record a failed step body with afterStepBody, so a World can keep waiting out a throttled write instead of re-running the body.

• #4605 94e3890 Thanks @alangenfeld! - Release drained stream writer sockets without closing the shared stream, preserve handle reuse over HTTP, and dispose transports when public writable streams abort. Propagate source failures to readers of flushable stream pipes.

• #4594 c1e70ef Thanks @TooTallNate! - Serialize only the viewed bytes of a Float16Array (no longer the whole Node Buffer pool behind it), and support Float16Array in the QuickJS engine with the same wire format as the node:vm engine.

• #4640 e71d1c7 Thanks @VaguelySerious! - Fix cross-deployment hook resumes and starts writing zstd payloads to runs on Node.js versions that cannot decode them. Required for upgrading to a newer Node.js version while existing runs on older Node.js versions are still receiving hooks.

• Updated dependencies [2d2159e, 9ca188a, a216e77, a6c455a, 8fa7584, 8fa7584, 94e3890, 81eac1d, e71d1c7]:

  • @workflow/world-local@5.0.2
  • @workflow/world-vercel@5.1.0
  • @workflow/utils@5.0.1
  • @workflow/world@5.0.2
  • @workflow/errors@5.0.2

@workflow/nest@5.1.0

Minor Changes

• #4604 482b918 Thanks @pranaygp! - Harden the NestJS integration against the framework features a real application uses. Fastify applications now boot correctly, queue deliveries are no longer capped at 100, app.enableVersioning() no longer moves the workflow routes, setGlobalPrefix(prefix, { exclude }) is honoured, isWorkflowRequest(context) export added, the Vercel app function is bundled for the runtime it is deployed on, --external <pkgs> is honored, and the builder warns when a second copy of @nestjs/core is present

Patch Changes

• Updated dependencies [ab9e640, a216e77]:
  • @workflow/builders@5.0.2
  • @workflow/utils@5.0.1

workflow@5.1.0

Minor Changes

• #4578 941e031 Thanks @wycats! - Export the existing Serializable type from @workflow/core and workflow.

Patch Changes

• Updated dependencies [941e031, ab9e640, a216e77, 482b918, 09bc2f8, 8fa7584, 94e3890, c1e70ef, e71d1c7]:
  • @workflow/core@5.1.0
  • @workflow/next@5.0.2
  • @workflow/utils@5.0.1
  • @workflow/nest@5.1.0
  • @workflow/cli@5.0.2
  • @workflow/nitro@5.0.2
  • @workflow/typescript-plugin@5.0.0
  • @workflow/astro@5.0.2
  • @workflow/rollup@5.0.2
  • @workflow/sveltekit@5.0.2
  • @workflow/errors@5.0.2
  • @workflow/nuxt@5.0.2

@workflow/world-vercel@5.1.0

Minor Changes

• #4589 9ca188a Thanks @VaguelySerious! - Default the events transport to WebSockets. Set WORKFLOW_EVENTS_TRANSPORT=http to opt out.

Patch Changes

• #4333 a6c455a Thanks @pranaygp! - Upgrade @vercel/queue to 0.6.0 so queue callbacks for messages that are already claimed or processed (409 / 410) respond 200 instead of logging Queue callback error and returning 500

• #4496 8fa7584 Thanks @alangenfeld! - Wait out a throttled (429) write recording a step body's outcome until the invocation's deadline instead of 30 seconds, and resend a throttled event-log read from its cursor instead of restarting it.

• #4605 94e3890 Thanks @alangenfeld! - Release drained stream writer sockets without closing the shared stream, preserve handle reuse over HTTP, and dispose transports when public writable streams abort. Propagate source failures to readers of flushable stream pipes.

• #4648 81eac1d Thanks @VaguelySerious! - Upgrade @vercel/queue to 0.8.0 so throttled queue sends honor the server's Retry-After and queue errors carry clean messages

• Updated dependencies [a216e77, 8fa7584, 94e3890, e71d1c7]:

  • @workflow/utils@5.0.1
  • @workflow/world@5.0.2
  • @workflow/errors@5.0.2

@workflow/ai@5.0.2

Patch Changes

• Updated dependencies [a216e77]:
  • @workflow/utils@5.0.1

@workflow/astro@5.0.2

Patch Changes

• Updated dependencies [ab9e640]:
  • @workflow/builders@5.0.2
  • @workflow/rollup@5.0.2
  • @workflow/vite@5.0.2

@workflow/builders@5.0.2

Patch Changes

• #4268 ab9e640 Thanks @VaguelySerious! - Fail the build when the workflow bundle still contains require(). The workflow sandbox has no require, so an import esbuild left external (most often a Node.js builtin reached through a transitive dependency or a re-export) or an unresolved dynamic require() used to produce a bundle that threw ReferenceError: require is not defined on its first load. The build now reports the specifier, the module that imported it and the import chain back to user code. A require() inside a try/catch block, or behind a typeof require check, is left alone, since that is how packages probe for an optional dependency and the call either fails harmlessly or never runs. Set WORKFLOW_ALLOW_UNSAFE_FLOW_BUNDLE=1 to downgrade the failure to a warning.
• Updated dependencies [941e031, a216e77, 09bc2f8, 8fa7584, 94e3890, c1e70ef, e71d1c7]:
  • @workflow/core@5.1.0
  • @workflow/utils@5.0.1
  • @workflow/errors@5.0.2

@workflow/cli@5.0.2

Patch Changes

• Updated dependencies [2d2159e, 9ca188a, 941e031, ab9e640, a216e77, a6c455a, 09bc2f8, d7217a8, 8fa7584, 8fa7584, 94e3890, c1e70ef, 81eac1d, e71d1c7]:
  • @workflow/world-local@5.0.2
  • @workflow/world-vercel@5.1.0
  • @workflow/core@5.1.0
  • @workflow/builders@5.0.2
  • @workflow/utils@5.0.1
  • @workflow/web@5.0.2
  • @workflow/world@5.0.2
  • @workflow/errors@5.0.2

@workflow/errors@5.0.2

Patch Changes

• Updated dependencies [a216e77, 8fa7584, 94e3890, e71d1c7]:
  • @workflow/utils@5.0.1
  • @workflow/world@5.0.2

@workflow/next@5.0.2

Patch Changes

• #4268 ab9e640 Thanks @VaguelySerious! - Fail the build when the workflow bundle still contains require(). The workflow sandbox has no require, so an import esbuild left external (most often a Node.js builtin reached through a transitive dependency or a re-export) or an unresolved dynamic require() used to produce a bundle that threw ReferenceError: require is not defined on its first load. The build now reports the specifier, the module that imported it and the import chain back to user code. A require() inside a try/catch block, or behind a typeof require check, is left alone, since that is how packages probe for an optional dependency and the call either fails harmlessly or never runs. Set WORKFLOW_ALLOW_UNSAFE_FLOW_BUNDLE=1 to downgrade the failure to a warning.
• Updated dependencies [941e031, ab9e640, 09bc2f8, 8fa7584, 94e3890, c1e70ef, e71d1c7]:
  • @workflow/core@5.1.0
  • @workflow/builders@5.0.2

@workflow/nitro@5.0.2

Patch Changes

• Updated dependencies [941e031, ab9e640, 09bc2f8, d7217a8, 8fa7584, 94e3890, c1e70ef, e71d1c7]:
  • @workflow/core@5.1.0
  • @workflow/builders@5.0.2
  • @workflow/web@5.0.2
  • @workflow/rollup@5.0.2
  • @workflow/vite@5.0.2

@workflow/nuxt@5.0.2

Patch Changes

• Updated dependencies []:
  • @workflow/nitro@5.0.2

@workflow/rollup@5.0.2

Patch Changes

• Updated dependencies [ab9e640]:
  • @workflow/builders@5.0.2

@workflow/sveltekit@5.0.2

Patch Changes

• Updated dependencies [ab9e640]:
  • @workflow/builders@5.0.2
  • @workflow/rollup@5.0.2
  • @workflow/vite@5.0.2

@workflow/utils@5.0.1

Patch Changes

• #4651 a216e77 Thanks @pranaygp! - sleep(), RetryableError's retryAfter, and a hook's experimental_minRetention now throw on an Invalid Date, or on a duration that ends past the latest time a Date can hold, instead of sending the Invalid Date to the World.

@workflow/vite@5.0.2

Patch Changes

• Updated dependencies [ab9e640]:
  • @workflow/builders@5.0.2

@workflow/vitest@5.0.2

Patch Changes

• Updated dependencies [2d2159e, 941e031, ab9e640, 09bc2f8, 8fa7584, 94e3890, c1e70ef, e71d1c7]:
  • @workflow/world-local@5.0.2
  • @workflow/core@5.1.0
  • @workflow/builders@5.0.2
  • @workflow/world@5.0.2
  • @workflow/rollup@5.0.2

@workflow/web@5.0.2

Patch Changes

• #4291 d7217a8 Thanks @mitul-s! - De-duplicate separate shadcn button implementations between @workflow/web-shared and @workflow/web
• Updated dependencies [2d2159e]:
  • @workflow/world-local@5.0.2

@workflow/web-shared@5.0.2

Patch Changes

• #4291 d7217a8 Thanks @mitul-s! - De-duplicate separate shadcn button implementations between @workflow/web-shared and @workflow/web
• Updated dependencies [941e031, a216e77, 09bc2f8, 8fa7584, 94e3890, c1e70ef, e71d1c7]:
  • @workflow/core@5.1.0
  • @workflow/utils@5.0.1
  • @workflow/world@5.0.2

@workflow/world@5.0.2

Patch Changes

• #4496 8fa7584 Thanks @alangenfeld! - Mark step_failed writes that record a failed step body with afterStepBody, so a World can keep waiting out a throttled write instead of re-running the body.

• #4605 94e3890 Thanks @alangenfeld! - Release drained stream writer sockets without closing the shared stream, preserve handle reuse over HTTP, and dispose transports when public writable streams abort. Propagate source failures to readers of flushable stream pipes.

• #4640 e71d1c7 Thanks @VaguelySerious! - Fix cross-deployment hook resumes and starts writing zstd payloads to runs on Node.js versions that cannot decode them. Required for upgrading to a newer Node.js version while existing runs on older Node.js versions are still receiving hooks.

@workflow/world-local@5.0.2

Patch Changes

• #4636 2d2159e Thanks @alangenfeld! - Prevent duplicate hook creation events when a retry publishes before the original token-claim owner.
• Updated dependencies [a216e77, 8fa7584, 94e3890, e71d1c7]:
  • @workflow/utils@5.0.1
  • @workflow/world@5.0.2
  • @workflow/errors@5.0.2

@workflow/world-postgres@5.0.2

Patch Changes

• Updated dependencies [2d2159e, a216e77, 8fa7584, 94e3890, e71d1c7]:
  • @workflow/world-local@5.0.2
  • @workflow/utils@5.0.1
  • @workflow/world@5.0.2
  • @workflow/errors@5.0.2

@workflow/world-testing@5.0.2

Patch Changes

• Updated dependencies [941e031, 09bc2f8, 8fa7584, 94e3890, c1e70ef, e71d1c7]:
  • @workflow/core@5.1.0
  • workflow@5.1.0
  • @workflow/world@5.0.2
  • @workflow/cli@5.0.2

[github-actions]

🧪 E2E Test Results

✅ All tests passed

⚠️ Flaky E2E Tests (passed on retry)

These tests failed at least once and passed on a retry. A recurring entry here is a real race worth investigating.

• getChunks returns same content as reading the stream (nest · vercel-prod / vercel / quickjs / production) — flaked in 2 jobs
• abortListenerWorkflow: signal.addEventListener fires on the deserialized step signal (nextjs-webpack · vercel-prod / vercel / quickjs / production)
• outputStreamInsideStepWorkflow - getWritable() called inside step functions (express · vercel-prod / vercel / node / production)
• utf8StreamWorkflow (hono · vercel-prod / vercel / quickjs / production)

🛠 Infra Events (absorbed by the harness)

Platform anomalies the e2e harness detected and worked around (e.g. a run the queue never picked up, replaced by a fresh run). Clustered timestamps indicate a backend blip; a steady drip indicates a platform issue worth escalating.

• run-pickup-stall · runs app-generated source against a registered step (tanstack-start) · at 01:08:07Z · abandoned wrun_01M47C1D7490KE628ASVJ7Q270
• cold-start-warmup · suite warmup (tanstack-start) · at 01:08:15Z · abandoned wrun_01M47C1D7JW57MGABMY482KV5N
• run-pickup-stall · hookCleanupTestWorkflow - hook token reuse after workflow completion (nextjs-webpack) · at 01:15:15Z · abandoned wrun_01M47CEET181ZCD6D7HY9TN4M5

E2E Test Summary

Summary

	Passed	Failed	Skipped	Total
✅ ▲ Vercel Production	3904	0	875	4779
✅ 💻 Local Development	4582	0	551	5133
✅ 📦 Local Production	4582	0	551	5133
✅ 🐘 Local Postgres	4582	0	551	5133
✅ 🪟 Windows	342	0	12	354
✅ 🌐 Cross-language Conformance	68	0	84	152
✅ dynamic-runs	0	0	0	0
✅ vercel-http-transport	879	0	183	1062
✅ vercel-multi-region	27	0	0	27
✅ vercel-ws-transport	595	0	113	708
Total	19561	0	2920	22481

Details by Category

✅ ▲ Vercel Production

App	Passed	Failed	Skipped
✅ astro-node	142	0	35
✅ astro-quickjs	142	0	35
✅ example-node	142	0	35
✅ example-quickjs	142	0	35
✅ express-node	142	0	35
✅ express-quickjs	142	0	35
✅ fastify-node	142	0	35
✅ fastify-quickjs	142	0	35
✅ hono-node	142	0	35
✅ hono-quickjs	142	0	35
✅ nest-node	142	0	35
✅ nest-quickjs	142	0	35
✅ nextjs-turbopack-node	169	0	8
✅ nextjs-turbopack-quickjs	169	0	8
✅ nextjs-webpack-node	169	0	8
✅ nextjs-webpack-quickjs	169	0	8
✅ nitro-node	142	0	35
✅ nitro-quickjs	142	0	35
✅ nuxt-node	142	0	35
✅ nuxt-quickjs	142	0	35
✅ python-node	66	0	111
✅ sveltekit-node	161	0	16
✅ sveltekit-quickjs	161	0	16
✅ tanstack-start-node	142	0	35
✅ tanstack-start-quickjs	142	0	35
✅ vite-node	142	0	35
✅ vite-quickjs	142	0	35

✅ 💻 Local Development

App	Passed	Failed	Skipped
✅ astro-stable-node	148	0	29
✅ astro-stable-quickjs	148	0	29
✅ express-stable-node	148	0	29
✅ express-stable-quickjs	148	0	29
✅ fastify-stable-node	148	0	29
✅ fastify-stable-quickjs	148	0	29
✅ hono-stable-node	148	0	29
✅ hono-stable-quickjs	148	0	29
✅ nest-stable-node	148	0	29
✅ nest-stable-quickjs	148	0	29
✅ nextjs-turbopack-canary-node	176	0	1
✅ nextjs-turbopack-canary-quickjs	176	0	1
✅ nextjs-turbopack-quickjs-snapshot	176	0	1
✅ nextjs-turbopack-stable-node	176	0	1
✅ nextjs-turbopack-stable-quickjs	176	0	1
✅ nextjs-webpack-canary-node	176	0	1
✅ nextjs-webpack-canary-quickjs	176	0	1
✅ nextjs-webpack-stable-node	176	0	1
✅ nextjs-webpack-stable-quickjs	176	0	1
✅ nitro-stable-node	148	0	29
✅ nitro-stable-quickjs	148	0	29
✅ nuxt-stable-node	148	0	29
✅ nuxt-stable-quickjs	148	0	29
✅ sveltekit-stable-node	167	0	10
✅ sveltekit-stable-quickjs	167	0	10
✅ tanstack-start-node	148	0	29
✅ tanstack-start-quickjs	148	0	29
✅ vite-stable-node	148	0	29
✅ vite-stable-quickjs	148	0	29

✅ 📦 Local Production

App	Passed	Failed	Skipped
✅ astro-stable-node	148	0	29
✅ astro-stable-quickjs	148	0	29
✅ express-stable-node	148	0	29
✅ express-stable-quickjs	148	0	29
✅ fastify-stable-node	148	0	29
✅ fastify-stable-quickjs	148	0	29
✅ hono-stable-node	148	0	29
✅ hono-stable-quickjs	148	0	29
✅ nest-stable-node	148	0	29
✅ nest-stable-quickjs	148	0	29
✅ nextjs-turbopack-canary-node	176	0	1
✅ nextjs-turbopack-canary-quickjs	176	0	1
✅ nextjs-turbopack-quickjs-snapshot	176	0	1
✅ nextjs-turbopack-stable-node	176	0	1
✅ nextjs-turbopack-stable-quickjs	176	0	1
✅ nextjs-webpack-canary-node	176	0	1
✅ nextjs-webpack-canary-quickjs	176	0	1
✅ nextjs-webpack-stable-node	176	0	1
✅ nextjs-webpack-stable-quickjs	176	0	1
✅ nitro-stable-node	148	0	29
✅ nitro-stable-quickjs	148	0	29
✅ nuxt-stable-node	148	0	29
✅ nuxt-stable-quickjs	148	0	29
✅ sveltekit-stable-node	167	0	10
✅ sveltekit-stable-quickjs	167	0	10
✅ tanstack-start-node	148	0	29
✅ tanstack-start-quickjs	148	0	29
✅ vite-stable-node	148	0	29
✅ vite-stable-quickjs	148	0	29

✅ 🐘 Local Postgres

App	Passed	Failed	Skipped
✅ astro-stable-node	148	0	29
✅ astro-stable-quickjs	148	0	29
✅ express-stable-node	148	0	29
✅ express-stable-quickjs	148	0	29
✅ fastify-stable-node	148	0	29
✅ fastify-stable-quickjs	148	0	29
✅ hono-stable-node	148	0	29
✅ hono-stable-quickjs	148	0	29
✅ nest-stable-node	148	0	29
✅ nest-stable-quickjs	148	0	29
✅ nextjs-turbopack-canary-node	176	0	1
✅ nextjs-turbopack-canary-quickjs	176	0	1
✅ nextjs-turbopack-quickjs-snapshot	176	0	1
✅ nextjs-turbopack-stable-node	176	0	1
✅ nextjs-turbopack-stable-quickjs	176	0	1
✅ nextjs-webpack-canary-node	176	0	1
✅ nextjs-webpack-canary-quickjs	176	0	1
✅ nextjs-webpack-stable-node	176	0	1
✅ nextjs-webpack-stable-quickjs	176	0	1
✅ nitro-stable-node	148	0	29
✅ nitro-stable-quickjs	148	0	29
✅ nuxt-stable-node	148	0	29
✅ nuxt-stable-quickjs	148	0	29
✅ sveltekit-stable-node	167	0	10
✅ sveltekit-stable-quickjs	167	0	10
✅ tanstack-start-node	148	0	29
✅ tanstack-start-quickjs	148	0	29
✅ vite-stable-node	148	0	29
✅ vite-stable-quickjs	148	0	29

✅ 🪟 Windows

App	Passed	Failed	Skipped
✅ nextjs-turbopack-node	171	0	6
✅ nextjs-turbopack-quickjs	171	0	6

✅ 🌐 Cross-language Conformance

App	Passed	Failed	Skipped
✅ python	68	0	84

✅ dynamic-runs

App	Passed	Failed	Skipped
✅ astro-vercel	0	0	0
✅ example-vercel	0	0	0
✅ express-vercel	0	0	0
✅ fastify-vercel	0	0	0
✅ nest-vercel	0	0	0
✅ nextjs-turbopack-vercel	0	0	0
✅ nextjs-webpack-vercel	0	0	0
✅ nitro-vercel	0	0	0
✅ nuxt-vercel	0	0	0
✅ sveltekit-vercel	0	0	0
✅ tanstack-start-vercel	0	0	0
✅ vite-vercel	0	0	0

✅ vercel-http-transport

App	Passed	Failed	Skipped
✅ example	142	0	35
✅ express	142	0	35
✅ hono	142	0	35
✅ nextjs-turbopack	169	0	8
✅ nitro	142	0	35
✅ vite	142	0	35

✅ vercel-multi-region

App	Passed	Failed	Skipped
✅ nextjs-turbopack	27	0	0

✅ vercel-ws-transport

App	Passed	Failed	Skipped
✅ example	142	0	35
✅ express	142	0	35
✅ nextjs-turbopack	169	0	8
✅ vite	142	0	35

---

📋 View full workflow run

[github-actions]

Sim World

Simulated world deterministic testing for races. Traces

🟠 world-sim scenario book — 1 fail of 42 total

fence=per-spec

scenario	outcome	events	virt	replay	violations
✅ smoke-no-steps	completed	3	0ms	ok	0
✅ smoke-one-step	completed	6	0ms	ok	0
✅ hook-at-step-started	completed	12	0ms	ok	0
✅ hook-at-step-completed	completed	12	0ms	ok	0
✅ hook-at-hook-created	completed	12	0ms	ok	0
✅ deadline-hook-wins	completed	7	1.0h	ok	0
✅ deadline-expires	completed	7	1.0h	ok	0
✅ step-vs-timer-early-settlement	completed	8	1.0h	ok	0
✅ long-sleep	completed	11	30.0d	ok	0
✅ hook-never-arrives	stalled	3	0ms	skipped	0
✅ step-retries-twice	completed	10	2.0s	ok	0
✅ parallel-steps	completed	9	0ms	ok	0
✅ hook-on-execution-state	completed	12	0ms	ok	0
✅ peek-hook-before-branch	completed	12	0ms	ok	0
✅ peek-hook-after-branch	completed	12	0ms	ok	0
✅ peek-hook-at-registration	completed	12	0ms	ok	0
✅ race-hook-before-probe	completed	12	0ms	ok	0
✅ race-hook-after-probe	completed	12	0ms	ok	0
✅ race-duplicate-delivery	completed	13	0ms	ok	0
✅ attr-hook-before-step	completed	11	0ms	ok	0
✅ attr-hook-after-step	completed	11	0ms	ok	0
✅ attr-from-step-body	completed	13	0ms	ok	0
✅ fork-hook-after-timeout	completed	14	1.0m	ok	0
✅ fork-hook-before-timeout	completed	14	1.0m	ok	0
✅ count-hook-after-timeout	completed	17	1.0m	ok	0
✅ count-hook-before-timeout	completed	20	1.0m	ok	0
✅ stale-read-step-count-fork	completed	20	1.0m	ok	0
✅ stale-read-equal-step-counts	completed	14	1.0m	ok	0
✅ step-vs-step-fork	completed	12	0ms	ok	0
✅ step-vs-step-fork-fenced	completed	12	0ms	ok	0
✅ fence-catches-benign-direction	completed	12	5ms	ok	0
✅ in-flight-before-decision	completed	17	1.0m	ok	0
❌ in-flight-before-decision-counted	completed	17	1.0m	ok	0
✅ in-flight-after-decision	completed	19	2.0m	ok	0
✅ stale-read-step-count-fork-fenced	completed	20	1.0m	ok	0
✅ fork-hook-wins	completed	13	1.0m	ok	0
✅ fork-timeout-wins	completed	13	1.0m	ok	0
✅ unclaimed-payload-under-fork	completed	17	1.0m	ok	0
✅ claimed-payload-under-fork	completed	17	1.0m	ok	0
✅ writers-independent-step-bodies	completed	12	0ms	ok	0
✅ writers-scripted-tempo	completed	12	0ms	ok	0
✅ cancel-mid-step	cancelled	7	0ms	skipped	0

Full trace: world-sim.txt

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

1 Skipped Deployment

Project	Deployment	Actions	Updated
workflow-docs	Skipped	v0	Oct 6, 2026 12:40am UTC