Skip to content

[docs] Tidy world API docs and document new stream helpers#1581

Merged
VaguelySerious merged 4 commits intomainfrom
peter/world-api-docs-tidy
Apr 2, 2026
Merged

[docs] Tidy world API docs and document new stream helpers#1581
VaguelySerious merged 4 commits intomainfrom
peter/world-api-docs-tidy

Conversation

@VaguelySerious
Copy link
Copy Markdown
Member

@VaguelySerious VaguelySerious commented Apr 1, 2026

Follow-up polish for #1457

Signed-off-by: Peter Wielander <mittgfu@gmail.com>
@VaguelySerious VaguelySerious requested a review from a team as a code owner April 1, 2026 16:40
@vercel
Copy link
Copy Markdown
Contributor

vercel Bot commented Apr 1, 2026

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

Project Deployment Actions Updated (UTC)
example-nextjs-workflow-turbopack Ready Ready Preview, Comment Apr 2, 2026 7:59pm
example-nextjs-workflow-webpack Ready Ready Preview, Comment Apr 2, 2026 7:59pm
example-workflow Ready Ready Preview, Comment Apr 2, 2026 7:59pm
workbench-astro-workflow Ready Ready Preview, Comment Apr 2, 2026 7:59pm
workbench-express-workflow Ready Ready Preview, Comment Apr 2, 2026 7:59pm
workbench-fastify-workflow Ready Ready Preview, Comment Apr 2, 2026 7:59pm
workbench-hono-workflow Ready Ready Preview, Comment Apr 2, 2026 7:59pm
workbench-nitro-workflow Ready Ready Preview, Comment Apr 2, 2026 7:59pm
workbench-nuxt-workflow Ready Ready Preview, Comment Apr 2, 2026 7:59pm
workbench-sveltekit-workflow Ready Ready Preview, Comment Apr 2, 2026 7:59pm
workbench-vite-workflow Ready Ready Preview, Comment Apr 2, 2026 7:59pm
workflow-docs Ready Ready Preview, Comment, Open in v0 Apr 2, 2026 7:59pm
workflow-swc-playground Ready Ready Preview, Comment Apr 2, 2026 7:59pm

@changeset-bot
Copy link
Copy Markdown

changeset-bot Bot commented Apr 1, 2026

⚠️ No Changeset found

Latest commit: 6fa72c5

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented Apr 1, 2026

📊 Benchmark Results

📈 Comparing against baseline from main branch. Green 🟢 = faster, Red 🔺 = slower.

workflow with no steps

💻 Local Development

World Framework Workflow Time Wall Time Overhead Samples vs Fastest
💻 Local 🥇 Express 0.042s (-1.6%) 1.005s (~) 0.963s 10 1.00x
💻 Local Nitro 0.042s (-17.8% 🟢) 1.005s (~) 0.962s 10 1.00x
🐘 Postgres Express 0.058s (-13.4% 🟢) 1.012s (~) 0.954s 10 1.36x
🐘 Postgres Nitro 0.062s (+7.3% 🔺) 1.012s (~) 0.951s 10 1.46x
💻 Local Next.js (Turbopack) ⚠️ missing - - - -
🐘 Postgres Next.js (Turbopack) ⚠️ missing - - - -

▲ Production (Vercel)

World Framework Workflow Time Wall Time Overhead Samples vs Fastest
▲ Vercel 🥇 Next.js (Turbopack) 0.494s (-23.1% 🟢) 2.336s (-4.3%) 1.842s 10 1.00x
▲ Vercel Nitro 0.531s (+3.7%) 2.554s (-8.5% 🟢) 2.023s 10 1.08x
▲ Vercel Express 0.574s (+15.9% 🔺) 2.772s (+9.4% 🔺) 2.198s 10 1.16x

🔍 Observability: Next.js (Turbopack) | Nitro | Express

workflow with 1 step

💻 Local Development

World Framework Workflow Time Wall Time Overhead Samples vs Fastest
💻 Local 🥇 Express 1.125s (-1.0%) 2.007s (~) 0.882s 10 1.00x
💻 Local Nitro 1.125s (-1.5%) 2.006s (~) 0.881s 10 1.00x
🐘 Postgres Nitro 1.142s (-0.7%) 2.009s (~) 0.866s 10 1.02x
🐘 Postgres Express 1.152s (+0.8%) 2.012s (~) 0.860s 10 1.02x
💻 Local Next.js (Turbopack) ⚠️ missing - - - -
🐘 Postgres Next.js (Turbopack) ⚠️ missing - - - -

▲ Production (Vercel)

World Framework Workflow Time Wall Time Overhead Samples vs Fastest
▲ Vercel 🥇 Express 2.292s (+8.2% 🔺) 3.804s (-1.6%) 1.513s 10 1.00x
▲ Vercel Nitro 2.295s (+9.3% 🔺) 3.796s (-2.6%) 1.501s 10 1.00x
▲ Vercel Next.js (Turbopack) 2.392s (+5.5% 🔺) 3.815s (+6.5% 🔺) 1.423s 10 1.04x

🔍 Observability: Express | Nitro | Next.js (Turbopack)

workflow with 10 sequential steps

💻 Local Development

World Framework Workflow Time Wall Time Overhead Samples vs Fastest
🐘 Postgres 🥇 Nitro 10.890s (~) 11.025s (~) 0.135s 3 1.00x
💻 Local Express 10.892s (~) 11.022s (~) 0.131s 3 1.00x
💻 Local Nitro 10.905s (-1.0%) 11.023s (-2.9%) 0.117s 3 1.00x
🐘 Postgres Express 10.937s (+0.6%) 11.027s (~) 0.090s 3 1.00x
💻 Local Next.js (Turbopack) ⚠️ missing - - - -
🐘 Postgres Next.js (Turbopack) ⚠️ missing - - - -

▲ Production (Vercel)

World Framework Workflow Time Wall Time Overhead Samples vs Fastest
▲ Vercel 🥇 Next.js (Turbopack) 16.648s (-9.3% 🟢) 18.318s (-8.9% 🟢) 1.670s 2 1.00x
▲ Vercel Express 16.715s (-2.6%) 18.232s (-4.6%) 1.516s 2 1.00x
▲ Vercel Nitro 17.078s (-7.6% 🟢) 18.627s (-8.0% 🟢) 1.549s 2 1.03x

🔍 Observability: Next.js (Turbopack) | Express | Nitro

workflow with 25 sequential steps

💻 Local Development

World Framework Workflow Time Wall Time Overhead Samples vs Fastest
🐘 Postgres 🥇 Express 14.613s (~) 15.028s (~) 0.415s 4 1.00x
🐘 Postgres Nitro 14.637s (+0.9%) 15.027s (~) 0.390s 4 1.00x
💻 Local Express 14.880s (-0.5%) 15.029s (~) 0.149s 4 1.02x
💻 Local Nitro 14.938s (-1.8%) 15.028s (-6.3% 🟢) 0.091s 4 1.02x
💻 Local Next.js (Turbopack) ⚠️ missing - - - -
🐘 Postgres Next.js (Turbopack) ⚠️ missing - - - -

▲ Production (Vercel)

World Framework Workflow Time Wall Time Overhead Samples vs Fastest
▲ Vercel 🥇 Express 30.203s (-4.6%) 32.056s (-3.9%) 1.853s 2 1.00x
▲ Vercel Next.js (Turbopack) 31.340s (-7.1% 🟢) 32.406s (-8.4% 🟢) 1.066s 2 1.04x
▲ Vercel Nitro 31.430s (-10.1% 🟢) 33.412s (-9.8% 🟢) 1.983s 2 1.04x

🔍 Observability: Express | Next.js (Turbopack) | Nitro

workflow with 50 sequential steps

💻 Local Development

World Framework Workflow Time Wall Time Overhead Samples vs Fastest
🐘 Postgres 🥇 Express 14.170s (+1.0%) 15.024s (+3.9%) 0.854s 6 1.00x
🐘 Postgres Nitro 14.243s (+1.7%) 15.025s (+2.9%) 0.782s 6 1.01x
💻 Local Express 16.429s (-1.5%) 17.029s (~) 0.600s 6 1.16x
💻 Local Nitro 16.674s (-2.8%) 17.030s (-5.6% 🟢) 0.356s 6 1.18x
💻 Local Next.js (Turbopack) ⚠️ missing - - - -
🐘 Postgres Next.js (Turbopack) ⚠️ missing - - - -

▲ Production (Vercel)

World Framework Workflow Time Wall Time Overhead Samples vs Fastest
▲ Vercel 🥇 Nitro 52.259s (-7.5% 🟢) 54.441s (-7.0% 🟢) 2.182s 2 1.00x
▲ Vercel Express 52.373s (~) 54.322s (+0.5%) 1.949s 2 1.00x
▲ Vercel Next.js (Turbopack) 58.522s (+7.5% 🔺) 60.100s (+8.4% 🔺) 1.578s 2 1.12x

🔍 Observability: Nitro | Express | Next.js (Turbopack)

Promise.all with 10 concurrent steps

💻 Local Development

World Framework Workflow Time Wall Time Overhead Samples vs Fastest
🐘 Postgres 🥇 Express 1.257s (-0.9%) 2.010s (~) 0.753s 15 1.00x
🐘 Postgres Nitro 1.288s (+2.2%) 2.012s (~) 0.723s 15 1.02x
💻 Local Nitro 1.511s (-3.6%) 2.005s (~) 0.495s 15 1.20x
💻 Local Express 1.511s (-1.9%) 2.006s (~) 0.494s 15 1.20x
💻 Local Next.js (Turbopack) ⚠️ missing - - - -
🐘 Postgres Next.js (Turbopack) ⚠️ missing - - - -

▲ Production (Vercel)

World Framework Workflow Time Wall Time Overhead Samples vs Fastest
▲ Vercel 🥇 Nitro 2.494s (-2.1%) 4.020s (-4.4%) 1.526s 8 1.00x
▲ Vercel Express 2.776s (+17.5% 🔺) 4.392s (+8.7% 🔺) 1.616s 7 1.11x
▲ Vercel Next.js (Turbopack) 2.815s (+1.1%) 3.870s (~) 1.055s 8 1.13x

🔍 Observability: Nitro | Express | Next.js (Turbopack)

Promise.all with 25 concurrent steps

💻 Local Development

World Framework Workflow Time Wall Time Overhead Samples vs Fastest
🐘 Postgres 🥇 Express 2.316s (-1.1%) 3.011s (~) 0.695s 10 1.00x
🐘 Postgres Nitro 2.383s (+2.5%) 3.012s (~) 0.629s 10 1.03x
💻 Local Nitro 2.857s (-8.4% 🟢) 3.007s (-22.6% 🟢) 0.151s 10 1.23x
💻 Local Express 2.877s (-7.5% 🟢) 3.007s (-25.0% 🟢) 0.130s 10 1.24x
💻 Local Next.js (Turbopack) ⚠️ missing - - - -
🐘 Postgres Next.js (Turbopack) ⚠️ missing - - - -

▲ Production (Vercel)

World Framework Workflow Time Wall Time Overhead Samples vs Fastest
▲ Vercel 🥇 Nitro 2.559s (-10.4% 🟢) 3.949s (-10.5% 🟢) 1.390s 8 1.00x
▲ Vercel Express 2.833s (-7.4% 🟢) 4.492s (-5.4% 🟢) 1.659s 7 1.11x
▲ Vercel Next.js (Turbopack) 3.228s (+3.8%) 4.521s (~) 1.293s 7 1.26x

🔍 Observability: Nitro | Express | Next.js (Turbopack)

Promise.all with 50 concurrent steps

💻 Local Development

World Framework Workflow Time Wall Time Overhead Samples vs Fastest
🐘 Postgres 🥇 Express 3.481s (~) 4.011s (~) 0.530s 8 1.00x
🐘 Postgres Nitro 3.507s (+1.0%) 4.011s (~) 0.504s 8 1.01x
💻 Local Express 7.983s (-2.0%) 8.518s (-5.6% 🟢) 0.535s 4 2.29x
💻 Local Nitro 8.521s (+1.7%) 9.025s (~) 0.504s 4 2.45x
💻 Local Next.js (Turbopack) ⚠️ missing - - - -
🐘 Postgres Next.js (Turbopack) ⚠️ missing - - - -

▲ Production (Vercel)

World Framework Workflow Time Wall Time Overhead Samples vs Fastest
▲ Vercel 🥇 Nitro 3.128s (-8.8% 🟢) 4.933s (-5.1% 🟢) 1.805s 7 1.00x
▲ Vercel Next.js (Turbopack) 3.522s (-15.0% 🟢) 5.636s (-1.8%) 2.115s 6 1.13x
▲ Vercel Express 4.389s (+14.2% 🔺) 6.019s (+8.9% 🔺) 1.630s 5 1.40x

🔍 Observability: Nitro | Next.js (Turbopack) | Express

Promise.race with 10 concurrent steps

💻 Local Development

World Framework Workflow Time Wall Time Overhead Samples vs Fastest
🐘 Postgres 🥇 Express 1.250s (-1.1%) 2.010s (~) 0.760s 15 1.00x
🐘 Postgres Nitro 1.267s (+0.7%) 2.010s (~) 0.744s 15 1.01x
💻 Local Express 1.512s (-2.0%) 2.005s (~) 0.493s 15 1.21x
💻 Local Nitro 1.588s (+1.4%) 2.007s (~) 0.419s 15 1.27x
💻 Local Next.js (Turbopack) ⚠️ missing - - - -
🐘 Postgres Next.js (Turbopack) ⚠️ missing - - - -

▲ Production (Vercel)

World Framework Workflow Time Wall Time Overhead Samples vs Fastest
▲ Vercel 🥇 Express 2.268s (-8.1% 🟢) 3.930s (-5.0%) 1.662s 8 1.00x
▲ Vercel Next.js (Turbopack) 2.337s (+4.1%) 3.665s (+1.8%) 1.329s 9 1.03x
▲ Vercel Nitro 2.496s (-1.3%) 4.066s (-6.3% 🟢) 1.570s 8 1.10x

🔍 Observability: Express | Next.js (Turbopack) | Nitro

Promise.race with 25 concurrent steps

💻 Local Development

World Framework Workflow Time Wall Time Overhead Samples vs Fastest
🐘 Postgres 🥇 Express 2.342s (~) 3.012s (~) 0.669s 10 1.00x
🐘 Postgres Nitro 2.363s (+1.7%) 3.013s (~) 0.650s 10 1.01x
💻 Local Express 2.900s (-6.8% 🟢) 3.565s (-8.3% 🟢) 0.665s 9 1.24x
💻 Local Nitro 3.084s (-4.0%) 3.885s (~) 0.801s 8 1.32x
💻 Local Next.js (Turbopack) ⚠️ missing - - - -
🐘 Postgres Next.js (Turbopack) ⚠️ missing - - - -

▲ Production (Vercel)

World Framework Workflow Time Wall Time Overhead Samples vs Fastest
▲ Vercel 🥇 Nitro 2.568s (-31.4% 🟢) 4.292s (-20.7% 🟢) 1.724s 7 1.00x
▲ Vercel Express 2.835s (+9.5% 🔺) 4.307s (+8.9% 🔺) 1.472s 8 1.10x
▲ Vercel Next.js (Turbopack) 3.554s (+22.0% 🔺) 5.077s (+27.1% 🔺) 1.522s 6 1.38x

🔍 Observability: Nitro | Express | Next.js (Turbopack)

Promise.race with 50 concurrent steps

💻 Local Development

World Framework Workflow Time Wall Time Overhead Samples vs Fastest
🐘 Postgres 🥇 Express 3.454s (~) 4.012s (~) 0.558s 8 1.00x
🐘 Postgres Nitro 3.492s (+0.9%) 4.013s (~) 0.521s 8 1.01x
💻 Local Express 8.351s (-7.3% 🟢) 9.024s (-5.3% 🟢) 0.673s 4 2.42x
💻 Local Nitro 8.970s (~) 9.523s (+2.7%) 0.554s 4 2.60x
💻 Local Next.js (Turbopack) ⚠️ missing - - - -
🐘 Postgres Next.js (Turbopack) ⚠️ missing - - - -

▲ Production (Vercel)

World Framework Workflow Time Wall Time Overhead Samples vs Fastest
▲ Vercel 🥇 Next.js (Turbopack) 3.674s (~) 5.156s (+0.5%) 1.482s 6 1.00x
▲ Vercel Express 4.536s (+35.8% 🔺) 6.329s (+31.2% 🔺) 1.794s 5 1.23x
▲ Vercel Nitro 5.094s (+58.7% 🔺) 7.048s (+43.4% 🔺) 1.954s 5 1.39x

🔍 Observability: Next.js (Turbopack) | Express | Nitro

workflow with 10 sequential data payload steps (10KB)

💻 Local Development

World Framework Workflow Time Wall Time Overhead Samples vs Fastest
🐘 Postgres 🥇 Express 0.842s (-1.1%) 1.007s (~) 0.165s 60 1.00x
🐘 Postgres Nitro 0.855s (+3.4%) 1.008s (~) 0.153s 60 1.02x
💻 Local Express 0.970s (-2.9%) 1.076s (-24.4% 🟢) 0.106s 56 1.15x
💻 Local Nitro 0.982s (-4.3%) 1.134s (-40.7% 🟢) 0.152s 54 1.17x
💻 Local Next.js (Turbopack) ⚠️ missing - - - -
🐘 Postgres Next.js (Turbopack) ⚠️ missing - - - -

▲ Production (Vercel)

World Framework Workflow Time Wall Time Overhead Samples vs Fastest
▲ Vercel 🥇 Express 9.284s (-5.3% 🟢) 10.982s (-9.0% 🟢) 1.698s 6 1.00x
▲ Vercel Next.js (Turbopack) 9.340s (-8.9% 🟢) 10.917s (-7.9% 🟢) 1.577s 6 1.01x
▲ Vercel Nitro 9.751s (+0.7%) 11.552s (+1.9%) 1.801s 6 1.05x

🔍 Observability: Express | Next.js (Turbopack) | Nitro

workflow with 25 sequential data payload steps (10KB)

💻 Local Development

World Framework Workflow Time Wall Time Overhead Samples vs Fastest
🐘 Postgres 🥇 Express 1.992s (-1.5%) 2.468s (-8.1% 🟢) 0.476s 37 1.00x
🐘 Postgres Nitro 2.098s (+6.9% 🔺) 3.010s (+39.9% 🔺) 0.912s 30 1.05x
💻 Local Express 2.974s (-1.3%) 3.293s (-8.7% 🟢) 0.319s 28 1.49x
💻 Local Nitro 3.029s (-2.0%) 3.689s (-8.0% 🟢) 0.660s 25 1.52x
💻 Local Next.js (Turbopack) ⚠️ missing - - - -
🐘 Postgres Next.js (Turbopack) ⚠️ missing - - - -

▲ Production (Vercel)

World Framework Workflow Time Wall Time Overhead Samples vs Fastest
▲ Vercel 🥇 Express 26.404s (-12.4% 🟢) 28.530s (-10.8% 🟢) 2.126s 4 1.00x
▲ Vercel Nitro 27.455s (-9.2% 🟢) 29.188s (-8.6% 🟢) 1.733s 4 1.04x
▲ Vercel Next.js (Turbopack) 31.122s (+3.5%) 32.324s (+2.1%) 1.203s 3 1.18x

🔍 Observability: Express | Nitro | Next.js (Turbopack)

workflow with 50 sequential data payload steps (10KB)

💻 Local Development

World Framework Workflow Time Wall Time Overhead Samples vs Fastest
🐘 Postgres 🥇 Express 4.095s (+1.0%) 4.892s (+2.3%) 0.797s 25 1.00x
🐘 Postgres Nitro 4.369s (+8.6% 🔺) 5.055s (+11.6% 🔺) 0.686s 24 1.07x
💻 Local Express 9.106s (~) 9.710s (+0.8%) 0.604s 13 2.22x
💻 Local Nitro 9.247s (-1.8%) 9.941s (-0.8%) 0.694s 13 2.26x
💻 Local Next.js (Turbopack) ⚠️ missing - - - -
🐘 Postgres Next.js (Turbopack) ⚠️ missing - - - -

▲ Production (Vercel)

World Framework Workflow Time Wall Time Overhead Samples vs Fastest
▲ Vercel 🥇 Nitro 75.725s (-5.8% 🟢) 77.611s (-5.6% 🟢) 1.886s 2 1.00x
▲ Vercel Express 76.922s (-7.9% 🟢) 78.871s (-8.1% 🟢) 1.949s 2 1.02x
▲ Vercel Next.js (Turbopack) 81.864s (-2.1%) 83.563s (-2.7%) 1.699s 2 1.08x

🔍 Observability: Nitro | Express | Next.js (Turbopack)

workflow with 10 concurrent data payload steps (10KB)

💻 Local Development

World Framework Workflow Time Wall Time Overhead Samples vs Fastest
🐘 Postgres 🥇 Express 0.286s (+2.8%) 1.008s (~) 0.722s 60 1.00x
🐘 Postgres Nitro 0.293s (+7.2% 🔺) 1.009s (~) 0.716s 60 1.02x
💻 Local Express 0.568s (-2.2%) 1.004s (~) 0.436s 60 1.99x
💻 Local Nitro 0.592s (-13.3% 🟢) 1.004s (-3.4%) 0.412s 60 2.07x
💻 Local Next.js (Turbopack) ⚠️ missing - - - -
🐘 Postgres Next.js (Turbopack) ⚠️ missing - - - -

▲ Production (Vercel)

World Framework Workflow Time Wall Time Overhead Samples vs Fastest
▲ Vercel 🥇 Express 1.817s (+15.2% 🔺) 3.541s (+14.2% 🔺) 1.724s 17 1.00x
▲ Vercel Nitro 1.930s (+9.3% 🔺) 3.582s (-4.5%) 1.652s 17 1.06x
▲ Vercel Next.js (Turbopack) 2.110s (+5.8% 🔺) 3.875s (+1.2%) 1.766s 16 1.16x

🔍 Observability: Express | Nitro | Next.js (Turbopack)

workflow with 25 concurrent data payload steps (10KB)

💻 Local Development

World Framework Workflow Time Wall Time Overhead Samples vs Fastest
🐘 Postgres 🥇 Express 0.504s (+1.3%) 1.008s (~) 0.503s 90 1.00x
🐘 Postgres Nitro 0.515s (+5.4% 🔺) 1.008s (~) 0.493s 90 1.02x
💻 Local Express 2.483s (-2.7%) 3.009s (~) 0.526s 30 4.92x
💻 Local Nitro 2.592s (+2.4%) 3.009s (~) 0.417s 30 5.14x
💻 Local Next.js (Turbopack) ⚠️ missing - - - -
🐘 Postgres Next.js (Turbopack) ⚠️ missing - - - -

▲ Production (Vercel)

World Framework Workflow Time Wall Time Overhead Samples vs Fastest
▲ Vercel 🥇 Express 3.254s (-8.2% 🟢) 4.858s (-8.9% 🟢) 1.604s 19 1.00x
▲ Vercel Nitro 3.649s (+8.8% 🔺) 5.296s (+4.6%) 1.647s 17 1.12x
▲ Vercel Next.js (Turbopack) 3.859s (-15.0% 🟢) 5.211s (-14.7% 🟢) 1.352s 18 1.19x

🔍 Observability: Express | Nitro | Next.js (Turbopack)

workflow with 50 concurrent data payload steps (10KB)

💻 Local Development

World Framework Workflow Time Wall Time Overhead Samples vs Fastest
🐘 Postgres 🥇 Nitro 0.787s (+1.7%) 1.008s (~) 0.221s 120 1.00x
🐘 Postgres Express 0.809s (+2.2%) 1.009s (~) 0.200s 119 1.03x
💻 Local Express 11.026s (-1.6%) 11.573s (-3.0%) 0.548s 11 14.01x
💻 Local Nitro 11.413s (+0.6%) 12.029s (+0.8%) 0.616s 10 14.51x
💻 Local Next.js (Turbopack) ⚠️ missing - - - -
🐘 Postgres Next.js (Turbopack) ⚠️ missing - - - -

▲ Production (Vercel)

World Framework Workflow Time Wall Time Overhead Samples vs Fastest
▲ Vercel 🥇 Express 8.459s (+2.4%) 10.209s (+4.3%) 1.750s 12 1.00x
▲ Vercel Nitro 8.901s (-2.9%) 10.601s (-2.2%) 1.700s 12 1.05x
▲ Vercel Next.js (Turbopack) 9.711s (+17.3% 🔺) 11.095s (+14.0% 🔺) 1.385s 12 1.15x

🔍 Observability: Express | Nitro | Next.js (Turbopack)

Stream Benchmarks (includes TTFB metrics)
workflow with stream

💻 Local Development

World Framework Workflow Time TTFB Slurp Wall Time Overhead Samples vs Fastest
💻 Local 🥇 Nitro 0.200s (-8.1% 🟢) 1.004s (~) 0.012s (+4.5%) 1.018s (~) 0.818s 10 1.00x
💻 Local Express 0.206s (+1.5%) 1.003s (~) 0.011s (-4.2%) 1.017s (~) 0.811s 10 1.03x
🐘 Postgres Express 0.208s (+1.8%) 0.993s (~) 0.001s (~) 1.011s (~) 0.803s 10 1.04x
🐘 Postgres Nitro 0.216s (+3.3%) 0.996s (~) 0.002s (+6.7% 🔺) 1.010s (~) 0.795s 10 1.08x
💻 Local Next.js (Turbopack) ⚠️ missing - - - - -
🐘 Postgres Next.js (Turbopack) ⚠️ missing - - - - -

▲ Production (Vercel)

World Framework Workflow Time TTFB Slurp Wall Time Overhead Samples vs Fastest
▲ Vercel 🥇 Nitro 1.542s (-13.4% 🟢) 2.368s (-18.8% 🟢) 0.922s (+72.5% 🔺) 3.893s (-5.5% 🟢) 2.351s 10 1.00x
▲ Vercel Next.js (Turbopack) 1.700s (-15.1% 🟢) 2.834s (-4.9%) 0.405s (-39.8% 🟢) 3.877s (-7.6% 🟢) 2.177s 10 1.10x
▲ Vercel Express 1.747s (-5.0% 🟢) 2.737s (-7.5% 🟢) 0.679s (+15.5% 🔺) 4.125s (-2.8%) 2.378s 10 1.13x

🔍 Observability: Nitro | Next.js (Turbopack) | Express

stream pipeline with 5 transform steps (1MB)

💻 Local Development

World Framework Workflow Time TTFB Slurp Wall Time Overhead Samples vs Fastest
🐘 Postgres 🥇 Nitro 0.604s (~) 1.003s (~) 0.004s (-7.2% 🟢) 1.022s (~) 0.418s 59 1.00x
🐘 Postgres Express 0.632s (+2.5%) 1.024s (+2.2%) 0.004s (+1.7%) 1.044s (+1.9%) 0.412s 58 1.05x
💻 Local Express 0.716s (-1.1%) 1.009s (~) 0.009s (+6.5% 🔺) 1.022s (~) 0.306s 59 1.18x
💻 Local Nitro 0.755s (-0.7%) 1.011s (~) 0.009s (-4.8%) 1.024s (~) 0.269s 59 1.25x
💻 Local Next.js (Turbopack) ⚠️ missing - - - - -
🐘 Postgres Next.js (Turbopack) ⚠️ missing - - - - -

▲ Production (Vercel)

World Framework Workflow Time TTFB Slurp Wall Time Overhead Samples vs Fastest
▲ Vercel 🥇 Nitro 3.986s (-25.0% 🟢) 5.317s (-19.6% 🟢) 0.415s (-28.6% 🟢) 6.378s (-18.8% 🟢) 2.391s 10 1.00x
▲ Vercel Express 4.120s (-4.5%) 5.383s (-1.6%) 0.294s (+27.3% 🔺) 6.389s (-1.1%) 2.268s 10 1.03x
▲ Vercel Next.js (Turbopack) 55.117s (+838.0% 🔺) 56.143s (+709.7% 🔺) 0.188s (-55.8% 🟢) 56.895s (+617.6% 🔺) 1.779s 6 13.83x

🔍 Observability: Nitro | Express | Next.js (Turbopack)

10 parallel streams (1MB each)

💻 Local Development

World Framework Workflow Time TTFB Slurp Wall Time Overhead Samples vs Fastest
🐘 Postgres 🥇 Express 0.969s (-0.8%) 1.187s (-0.9%) 0.000s (+Infinity% 🔺) 1.201s (-2.9%) 0.232s 52 1.00x
🐘 Postgres Nitro 0.972s (~) 1.232s (+5.8% 🔺) 0.000s (-48.0% 🟢) 1.249s (+5.2% 🔺) 0.276s 50 1.00x
💻 Local Express 1.224s (-1.8%) 2.020s (~) 0.000s (~) 2.022s (~) 0.798s 30 1.26x
💻 Local Nitro 1.266s (-2.3%) 2.022s (~) 0.000s (-9.1% 🟢) 2.024s (~) 0.759s 30 1.31x
💻 Local Next.js (Turbopack) ⚠️ missing - - - - -
🐘 Postgres Next.js (Turbopack) ⚠️ missing - - - - -

▲ Production (Vercel)

World Framework Workflow Time TTFB Slurp Wall Time Overhead Samples vs Fastest
▲ Vercel 🥇 Express 2.939s (-2.1%) 3.841s (-6.3% 🟢) 0.000s (-82.3% 🟢) 4.532s (-5.9% 🟢) 1.593s 14 1.00x
▲ Vercel Nitro 3.078s (+6.7% 🔺) 4.225s (+6.5% 🔺) 0.000s (+200.0% 🔺) 4.867s (+5.3% 🔺) 1.789s 13 1.05x
▲ Vercel Next.js (Turbopack) 3.919s (+20.2% 🔺) 4.861s (+17.9% 🔺) 0.000s (+Infinity% 🔺) 5.465s (+16.7% 🔺) 1.547s 12 1.33x

🔍 Observability: Express | Nitro | Next.js (Turbopack)

fan-out fan-in 10 streams (1MB each)

💻 Local Development

World Framework Workflow Time TTFB Slurp Wall Time Overhead Samples vs Fastest
🐘 Postgres 🥇 Nitro 1.742s (+1.6%) 2.063s (-1.7%) 0.000s (-100.0% 🟢) 2.120s (~) 0.377s 29 1.00x
🐘 Postgres Express 1.805s (+3.1%) 2.139s (+3.5%) 0.000s (NaN%) 2.153s (+2.4%) 0.348s 28 1.04x
💻 Local Express 3.340s (-7.8% 🟢) 4.033s (-1.6%) 0.001s (+57.1% 🔺) 4.037s (-1.6%) 0.697s 15 1.92x
💻 Local Nitro 3.530s (-5.5% 🟢) 4.101s (-3.2%) 0.000s (-54.5% 🟢) 4.104s (-3.2%) 0.574s 15 2.03x
💻 Local Next.js (Turbopack) ⚠️ missing - - - - -
🐘 Postgres Next.js (Turbopack) ⚠️ missing - - - - -

▲ Production (Vercel)

World Framework Workflow Time TTFB Slurp Wall Time Overhead Samples vs Fastest
▲ Vercel 🥇 Express 3.650s (-2.4%) 4.710s (-6.4% 🟢) 0.000s (-54.2% 🟢) 5.394s (-4.5%) 1.745s 12 1.00x
▲ Vercel Nitro 3.705s (-11.3% 🟢) 4.688s (-12.8% 🟢) 0.000s (+Infinity% 🔺) 5.322s (-11.8% 🟢) 1.617s 12 1.02x
▲ Vercel Next.js (Turbopack) 4.673s (-11.3% 🟢) 5.541s (-11.0% 🟢) 0.000s (NaN%) 6.152s (-9.1% 🟢) 1.478s 10 1.28x

🔍 Observability: Express | Nitro | Next.js (Turbopack)

Summary

Fastest Framework by World

Winner determined by most benchmark wins

World 🥇 Fastest Framework Wins
💻 Local Express 18/21
🐘 Postgres Express 16/21
▲ Vercel Express 10/21
Fastest World by Framework

Winner determined by most benchmark wins

Framework 🥇 Fastest World Wins
Express 🐘 Postgres 17/21
Next.js (Turbopack) ▲ Vercel 21/21
Nitro 🐘 Postgres 17/21
Column Definitions
  • Workflow Time: Runtime reported by workflow (completedAt - createdAt) - primary metric
  • TTFB: Time to First Byte - time from workflow start until first stream byte received (stream benchmarks only)
  • Slurp: Time from first byte to complete stream consumption (stream benchmarks only)
  • Wall Time: Total testbench time (trigger workflow + poll for result)
  • Overhead: Testbench overhead (Wall Time - Workflow Time)
  • Samples: Number of benchmark iterations run
  • vs Fastest: How much slower compared to the fastest configuration for this benchmark

Worlds:

  • 💻 Local: In-memory filesystem world (local development)
  • 🐘 Postgres: PostgreSQL database world (local development)
  • ▲ Vercel: Vercel production/preview deployment
  • 🌐 Turso: Community world (local development)
  • 🌐 MongoDB: Community world (local development)
  • 🌐 Redis: Community world (local development)
  • 🌐 Jazz: Community world (local development)

📋 View full workflow run

@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented Apr 1, 2026

🧪 E2E Test Results

Some tests failed

Summary

Passed Failed Skipped Total
✅ ▲ Vercel Production 857 0 67 924
✅ 💻 Local Development 830 0 178 1008
✅ 📦 Local Production 830 0 178 1008
✅ 🐘 Local Postgres 830 0 178 1008
✅ 🪟 Windows 76 0 8 84
❌ 🌍 Community Worlds 133 59 24 216
✅ 📋 Other 210 0 42 252
Total 3766 59 675 4500

❌ Failed Tests

🌍 Community Worlds (59 failed)

mongodb (2 failed):

  • hookWorkflow is not resumable via public webhook endpoint | wrun_01KN7WF7C3DBNE3YE0G912G2XV
  • concurrent hook token conflict - two workflows cannot use the same hook token simultaneously | wrun_01KN7WQEM2SS9CMMS8WEB6JPGR

redis (2 failed):

  • hookWorkflow is not resumable via public webhook endpoint | wrun_01KN7WF7C3DBNE3YE0G912G2XV
  • concurrent hook token conflict - two workflows cannot use the same hook token simultaneously | wrun_01KN7WQEM2SS9CMMS8WEB6JPGR

turso (55 failed):

  • addTenWorkflow | wrun_01KN7WE2G4VX0CTMJTA096M4P1
  • addTenWorkflow | wrun_01KN7WE2G4VX0CTMJTA096M4P1
  • wellKnownAgentWorkflow (.well-known/agent) | wrun_01KN7WEYDX9V7D8G65DV3DEDJG
  • should work with react rendering in step
  • promiseAllWorkflow | wrun_01KN7WEAE8W536KXSC8TVWQWNQ
  • promiseRaceWorkflow | wrun_01KN7WEDS7T8WYXA75QYA38VG8
  • promiseAnyWorkflow | wrun_01KN7WEFYKFQ5V1R7MFVMQ3E0A
  • importedStepOnlyWorkflow | wrun_01KN7WFA8HN8QH0MMTX7P805VN
  • hookWorkflow | wrun_01KN7WEWD5GR2VTQTAZHPC5453
  • hookWorkflow is not resumable via public webhook endpoint | wrun_01KN7WF7C3DBNE3YE0G912G2XV
  • webhookWorkflow | wrun_01KN7WFG9DT2CG3175GG7SPQWC
  • sleepingWorkflow | wrun_01KN7WFPN4H1FY7M1SRNVA29V5
  • parallelSleepWorkflow | wrun_01KN7WG3PBAZBNDV8WQ6TQ40B5
  • nullByteWorkflow | wrun_01KN7WG84PPGNASDSXPGC73STH
  • workflowAndStepMetadataWorkflow | wrun_01KN7WGAA5K52B1EM5R2G3H5Z3
  • fetchWorkflow | wrun_01KN7WK6JGK0KV2N8WJVFGQBNG
  • promiseRaceStressTestWorkflow | wrun_01KN7WKA5Z2ZS1JBH3SS4FMJSY
  • error handling error propagation workflow errors nested function calls preserve message and stack trace
  • error handling error propagation workflow errors cross-file imports preserve message and stack trace
  • error handling error propagation step errors basic step error preserves message and stack trace
  • error handling error propagation step errors cross-file step error preserves message and function names in stack
  • error handling retry behavior regular Error retries until success
  • error handling retry behavior FatalError fails immediately without retries
  • error handling retry behavior RetryableError respects custom retryAfter delay
  • error handling retry behavior maxRetries=0 disables retries
  • error handling catchability FatalError can be caught and detected with FatalError.is()
  • error handling not registered WorkflowNotRegisteredError fails the run when workflow does not exist
  • error handling not registered StepNotRegisteredError fails the step but workflow can catch it
  • error handling not registered StepNotRegisteredError fails the run when not caught in workflow
  • hookCleanupTestWorkflow - hook token reuse after workflow completion | wrun_01KN7WPT5BHFB7NGCZB024HWT9
  • concurrent hook token conflict - two workflows cannot use the same hook token simultaneously | wrun_01KN7WQEM2SS9CMMS8WEB6JPGR
  • hookDisposeTestWorkflow - hook token reuse after explicit disposal while workflow still running | wrun_01KN7WR3KX1HENWTX2WEAMK8CV
  • stepFunctionPassingWorkflow - step function references can be passed as arguments (without closure vars) | wrun_01KN7WRQC6595Z7QRXT4KDNNPG
  • stepFunctionWithClosureWorkflow - step function with closure variables passed as argument | wrun_01KN7WS03ECKS5C1NVTY7MZGKN
  • closureVariableWorkflow - nested step functions with closure variables | wrun_01KN7WS5N4PKKSEY74GFQ36M9H
  • spawnWorkflowFromStepWorkflow - spawning a child workflow using start() inside a step | wrun_01KN7WS7TN9ABVXNBJFNV06RCJ
  • health check (queue-based) - workflow and step endpoints respond to health check messages
  • pathsAliasWorkflow - TypeScript path aliases resolve correctly | wrun_01KN7WSR96GJE73JQSY3GCD3GR
  • Calculator.calculate - static workflow method using static step methods from another class | wrun_01KN7WSYCEY73ZKMWZ61YC7TK4
  • AllInOneService.processNumber - static workflow method using sibling static step methods | wrun_01KN7WT4YF2VE7BZV14HM59F23
  • ChainableService.processWithThis - static step methods using this to reference the class | wrun_01KN7WTBHHXNVP9Z24QM10AR1Q
  • thisSerializationWorkflow - step function invoked with .call() and .apply() | wrun_01KN7WTJ5Y47MXQF2PM5Q3N6G2
  • customSerializationWorkflow - custom class serialization with WORKFLOW_SERIALIZE/WORKFLOW_DESERIALIZE | wrun_01KN7WTS1GXQ8WEQ1PKRB829QH
  • instanceMethodStepWorkflow - instance methods with "use step" directive | wrun_01KN7WTZKARFATDTFY3NW7QDAY
  • crossContextSerdeWorkflow - classes defined in step code are deserializable in workflow context | wrun_01KN7WVAWDM9TGKSEZQ1RTSAY0
  • stepFunctionAsStartArgWorkflow - step function reference passed as start() argument | wrun_01KN7WVK56H21K594TGRK67WPG
  • cancelRun - cancelling a running workflow | wrun_01KN7WVSPC4R9A8PX87C47M8SG
  • cancelRun via CLI - cancelling a running workflow | wrun_01KN7WW2TNWRT5P6045E0F0SNF
  • pages router addTenWorkflow via pages router
  • pages router promiseAllWorkflow via pages router
  • pages router sleepingWorkflow via pages router
  • hookWithSleepWorkflow - hook payloads delivered correctly with concurrent sleep | wrun_01KN7WWEMZRE12ZM2RSQ8A671N
  • sleepInLoopWorkflow - sleep inside loop with steps actually delays each iteration | wrun_01KN7WX4K1K6R87T58FVHRR37X
  • sleepWithSequentialStepsWorkflow - sequential steps work with concurrent sleep (control) | wrun_01KN7WXFGWM6JG1FYFW972603C
  • importMetaUrlWorkflow - import.meta.url is available in step bundles | wrun_01KN7WXP1G168N8F5R65QC8RJ3

Details by Category

✅ ▲ Vercel Production
App Passed Failed Skipped
✅ astro 77 0 7
✅ example 77 0 7
✅ express 77 0 7
✅ fastify 77 0 7
✅ hono 77 0 7
✅ nextjs-turbopack 82 0 2
✅ nextjs-webpack 82 0 2
✅ nitro 77 0 7
✅ nuxt 77 0 7
✅ sveltekit 77 0 7
✅ vite 77 0 7
✅ 💻 Local Development
App Passed Failed Skipped
✅ astro-stable 70 0 14
✅ express-stable 70 0 14
✅ fastify-stable 70 0 14
✅ hono-stable 70 0 14
✅ nextjs-turbopack-canary 59 0 25
✅ nextjs-turbopack-stable 76 0 8
✅ nextjs-webpack-canary 59 0 25
✅ nextjs-webpack-stable 76 0 8
✅ nitro-stable 70 0 14
✅ nuxt-stable 70 0 14
✅ sveltekit-stable 70 0 14
✅ vite-stable 70 0 14
✅ 📦 Local Production
App Passed Failed Skipped
✅ astro-stable 70 0 14
✅ express-stable 70 0 14
✅ fastify-stable 70 0 14
✅ hono-stable 70 0 14
✅ nextjs-turbopack-canary 59 0 25
✅ nextjs-turbopack-stable 76 0 8
✅ nextjs-webpack-canary 59 0 25
✅ nextjs-webpack-stable 76 0 8
✅ nitro-stable 70 0 14
✅ nuxt-stable 70 0 14
✅ sveltekit-stable 70 0 14
✅ vite-stable 70 0 14
✅ 🐘 Local Postgres
App Passed Failed Skipped
✅ astro-stable 70 0 14
✅ express-stable 70 0 14
✅ fastify-stable 70 0 14
✅ hono-stable 70 0 14
✅ nextjs-turbopack-canary 59 0 25
✅ nextjs-turbopack-stable 76 0 8
✅ nextjs-webpack-canary 59 0 25
✅ nextjs-webpack-stable 76 0 8
✅ nitro-stable 70 0 14
✅ nuxt-stable 70 0 14
✅ sveltekit-stable 70 0 14
✅ vite-stable 70 0 14
✅ 🪟 Windows
App Passed Failed Skipped
✅ nextjs-turbopack 76 0 8
❌ 🌍 Community Worlds
App Passed Failed Skipped
✅ mongodb-dev 5 0 0
❌ mongodb 57 2 8
✅ redis-dev 5 0 0
❌ redis 57 2 8
✅ turso-dev 5 0 0
❌ turso 4 55 8
✅ 📋 Other
App Passed Failed Skipped
✅ e2e-local-dev-nest-stable 70 0 14
✅ e2e-local-postgres-nest-stable 70 0 14
✅ e2e-local-prod-nest-stable 70 0 14

📋 View full workflow run

Comment thread docs/content/docs/api-reference/workflow-api/world/streams.mdx
Comment thread docs/content/docs/api-reference/workflow-api/world/storage.mdx Outdated
Comment thread docs/content/docs/api-reference/workflow-api/world/storage.mdx
- Declare `cursor` variable in pagination example to make it self-contained
- Add migration note for removed `world.runs.cancel()` method
- Restore `streamName` extraction in stream read example

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Copy link
Copy Markdown
Contributor

@karthikscale3 karthikscale3 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

…-reference/workflow-api/world/events`, resulting in a broken link.

This commit fixes the issue reported at docs/content/docs/api-reference/workflow-api/world/storage.mdx:162

**Bug:** Line 162 of `storage.mdx` contains a markdown link `[Events](/docs/api-reference/workflow-api/world/events)` pointing to a separate events page. However, the file `events.mdx` was deleted in this PR — its content was consolidated into `storage.mdx` itself. The `## world.events` section with `events.create()` documentation now lives earlier in the same file. This means clicking the link in the "Cancelling Runs" section would lead to a 404 page.

**Fix:** Changed the link from `[Events](/docs/api-reference/workflow-api/world/events)` to `[world.events](#worldevents) above`, which is an in-page anchor reference to the `## world.events` heading that exists earlier on the same page. This correctly directs users to the relevant documentation for `events.create()` that they need for cancelling runs.

Co-authored-by: Vercel <vercel[bot]@users.noreply.github.com>
Co-authored-by: VaguelySerious <mittgfu@gmail.com>
@VaguelySerious VaguelySerious enabled auto-merge (squash) April 2, 2026 20:00
@VaguelySerious VaguelySerious merged commit 136c1f4 into main Apr 2, 2026
102 checks passed
@VaguelySerious VaguelySerious deleted the peter/world-api-docs-tidy branch April 2, 2026 20:08
@Ralph-20
Copy link
Copy Markdown
Contributor

Ralph-20 commented Apr 2, 2026

LGTM

pranaygp added a commit that referenced this pull request Apr 3, 2026
…1-refresh

* origin/main: (21 commits)
  Fix node-module-error plugin matching identifiers in multi-line comments (#1554)
  fix(swc-plugin): use binding name for class expression method registrations (#1599)
  fix(builders): override `sideEffects: false` for discovered workflow/step/serde entries (#1598)
  [world-vercel] align header names to `x-vercel-workflow-*` convention (#1602)
  [docs] Add vercel world consumer function security documentation (#1543)
  Make `start()` types `unknown` when `deploymentId` is provided (#1367)
  fix(next): stop force-setting WORKFLOW_PUBLIC_MANIFEST=1 during next dev (#1597)
  Version Packages (beta) (#1593)
  [docs] Tidy world API docs and document new stream helpers (#1581)
  Rename 'Workflow Development Kit' / 'DevKit' to 'Workflow SDK' (#1595)
  [world] Use zod/v4 in queue files to match @workflow/world schemas (#1588)
  [ai] Fix fatal stream errors surfacing as [object Object] (#1589)
  [web] Fix server crash on unmatched routes (#1590)
  docs: rename 'Complex Example' to 'Instance Methods as Steps' (#1592)
  Version Packages (beta) (#1563)
  [core] Extend flow route duration to "max" and fail runs where replay takes too long (#1567)
  fix: check target run capabilities before encrypting hook payloads (#1572)
  [core] Combine initial run fetch, event fetch, and run_started event creation (#1569)
  [docs] Split World API docs into sub-pages, update skill.md (#1457)
  [nitro] Preserve workflow step registration side effects (#1386)
  ...

# Conflicts:
#	skills/workflow/SKILL.md
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants