Skip to content

fix(world-vercel): append caller User-Agent products instead of discarding them#2998

Draft
ruiconti wants to merge 1 commit into
mainfrom
rui/world-user-agent-suffix
Draft

fix(world-vercel): append caller User-Agent products instead of discarding them#2998
ruiconti wants to merge 1 commit into
mainfrom
rui/world-user-agent-suffix

Conversation

@ruiconti

Copy link
Copy Markdown

getHeaders() overwrites the caller's User-Agent with world-vercel's own product string, so anything embedding the SDK — a framework constructing the world via createWorld({ headers }) — has no way to identify itself to workflow-server. This appends the caller's products after world-vercel's own:

@workflow/world-vercel/5.0.0-beta.31 node-v26.0.0 darwin (arm64) eve/0.24.6

All egress goes through this one getHeaders choke point (v3 makeRequest, v4 events via getHttpConfig, queue), so the append covers every request path.

The join is a space, not Headers.append(): repeated header values combine with ", ", and a comma glued to a product token breaks whitespace-delimited User-Agent parsers on the receiving side. joinUserAgentProducts carries that constraint in one place.

First consumer is eve, which passes its eve/<version> token through createWorld({ headers }) so workflow-server can attribute framework traffic.

…rding them

getHeaders() unconditionally overwrote the caller's User-Agent with the
world-vercel product string, so SDK embedders (frameworks constructing the
world via createWorld({ headers })) had no way to identify themselves to
workflow-server. Join the caller's products after world-vercel's own, per
the RFC 9110 User-Agent grammar (space-delimited product tokens).

Deliberately joined with joinUserAgentProducts rather than Headers.append():
repeated header values combine with ", ", and a comma glued to a product
token breaks whitespace-delimited User-Agent parsers on the receiving side.
@changeset-bot

changeset-bot Bot commented Jul 19, 2026

Copy link
Copy Markdown

🦋 Changeset detected

Latest commit: fda3aa4

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 17 packages
Name Type
@workflow/world-vercel Patch
@workflow/builders Patch
@workflow/cli Patch
@workflow/core Patch
@workflow/web Patch
@workflow/astro Patch
@workflow/nest Patch
@workflow/next Patch
@workflow/nitro Patch
@workflow/nuxt Patch
@workflow/rollup Patch
@workflow/sveltekit Patch
@workflow/vite Patch
@workflow/vitest Patch
workflow Patch
@workflow/world-testing Patch
@workflow/web-shared Patch

Not sure what this means? Click here to learn what changesets are.

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

@vercel

vercel Bot commented Jul 19, 2026

Copy link
Copy Markdown
Contributor

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 Jul 19, 2026 4:26am
example-nextjs-workflow-webpack Ready Ready Preview, Comment Jul 19, 2026 4:26am
example-workflow Ready Ready Preview, Comment Jul 19, 2026 4:26am
workbench-astro-workflow Ready Ready Preview, Comment Jul 19, 2026 4:26am
workbench-express-workflow Ready Ready Preview, Comment Jul 19, 2026 4:26am
workbench-fastify-workflow Ready Ready Preview, Comment Jul 19, 2026 4:26am
workbench-hono-workflow Ready Ready Preview, Comment Jul 19, 2026 4:26am
workbench-nitro-workflow Ready Ready Preview, Comment Jul 19, 2026 4:26am
workbench-nuxt-workflow Ready Ready Preview, Comment Jul 19, 2026 4:26am
workbench-sveltekit-workflow Ready Ready Preview, Comment Jul 19, 2026 4:26am
workbench-tanstack-start-workflow Ready Ready Preview, Comment Jul 19, 2026 4:26am
workbench-vite-workflow Ready Ready Preview, Comment Jul 19, 2026 4:26am
workflow-docs Ready Ready Preview, Comment, Open in v0 Jul 19, 2026 4:26am
workflow-swc-playground Ready Ready Preview, Comment Jul 19, 2026 4:26am
workflow-tarballs Ready Ready Preview, Comment Jul 19, 2026 4:26am
workflow-web Ready Ready Preview, Comment Jul 19, 2026 4:26am

@github-actions

github-actions Bot commented Jul 19, 2026

Copy link
Copy Markdown
Contributor

📊 Workflow Benchmarks

commit fda3aa4 · Sun, 19 Jul 2026 04:38:18 GMT · run logs

Backend: vercel · app: nextjs-turbopack

Metric Scenario Avg (ms) P10 (ms) P75 (ms) P90 (ms) P99 (ms) Samples
TTFS step 878 (-20%) 236 1178 🔴 1269 🔴 1973 🔴 30
TTFS stream 991 (-7.0%) 299 1138 🔴 1358 🔴 1392 🔴 30
TTFS hook + stream 1237 (-14%) 484 1578 🔴 1646 🔴 1742 🔴 30
STSO 1020 steps (1-20) 230 (-14%) 180 252 🔴 285 🔴 375 🔴 19
STSO 1020 steps (101-120) 247 (-9.0%) 207 269 🔴 291 🔴 354 🔴 19
STSO 1020 steps (1001-1020) 548 (-4.4%) 482 575 🔴 684 🔴 779 🔴 19
WO 1020 steps 400781 (-9.7%) 400781 400781 400781 400781 1
SL stream latency 175 (+16%) 104 163 🔴 202 🔴 873 🔴 30

Avg deltas compare against the most recent benchmark run on main at the time of this run.

Metrics — TTFS: time to first step body (in-deployment start() → first step body, deployment clocks) · STSO: step-to-step overhead (gap between consecutive step bodies) · WO: workflow overhead (whole-run time outside step bodies, in-deployment anchored) · SL: stream latency (in-deployment write → read propagation, readAt - writtenAt)

Scenarios — step: one trivial no-op step, no stream; no hooks, so the run stays in turbo mode (in-process fast path) · stream: one streaming step; no hooks, so the run stays in turbo mode (in-process fast path) · hook + stream: registers a hook before one step, which exits turbo mode (dispatch path) · 1020 steps: 1020 trivial sequential steps; STSO is measured between consecutive steps in the given step ranges, and WO is the whole-run overhead outside step bodies · stream latency: parallel reader/writer steps on a dedicated stream; SL is the in-deployment write->read propagation (readAt - writtenAt)

🟢/🔴 mark percentiles within/above target. Targets (p75/p90/p99, ms) — TTFS 200/300/600 · SL 50/60/125 · STSO (1-20) 20/30/60 · STSO (101-120) 30/45/90 · STSO (1001-1020) 40/60/120

All metrics are measured from deployment-side timestamps only. Runs are triggered by an in-deployment route that stamps the anchor (clientStart) right before start(), so the CI runner’s request and its path through api.vercel.com sit outside every measured window. TTFS = in-deployment start() → first step body (turbo uses the in-process fast path, non-turbo the dispatch path), and includes the VQS dispatch hop plus any /flow cold start. STSO/WO are measured between step bodies on the deployment. SL is measured inside the workflow (parallel reader/writer steps), so it no longer includes the api.vercel.com read path.

Cold starts are kept in the numbers on purpose — they are part of real bursty-workload latency. The workbench deployment cold-starts the /flow invocation for a large fraction of runs, inflating P75+; the P10 column shows the warm-start floor for comparison.

@github-actions

github-actions Bot commented Jul 19, 2026

Copy link
Copy Markdown
Contributor

🧪 E2E Test Results

All tests passed

Summary

Passed Failed Skipped Total
✅ ▲ Vercel Production 1453 0 230 1683
✅ 💻 Local Development 1483 0 200 1683
✅ 📦 Local Production 1617 0 219 1836
✅ 🐘 Local Postgres 1617 0 219 1836
✅ 🪟 Windows 153 0 0 153
✅ 📋 Other 894 0 177 1071
✅ vercel-multi-region 27 0 0 27
Total 7244 0 1045 8289

Details by Category

✅ ▲ Vercel Production
App Passed Failed Skipped
✅ astro 126 0 27
✅ example 126 0 27
✅ express 126 0 27
✅ fastify 126 0 27
✅ hono 126 0 27
✅ nextjs-turbopack 150 0 3
✅ nextjs-webpack 150 0 3
✅ nitro 126 0 27
✅ nuxt 126 0 27
✅ sveltekit 145 0 8
✅ vite 126 0 27
✅ 💻 Local Development
App Passed Failed Skipped
✅ astro-stable 128 0 25
✅ express-stable 128 0 25
✅ fastify-stable 128 0 25
✅ hono-stable 128 0 25
✅ nextjs-turbopack-canary 134 0 19
✅ nextjs-turbopack-stable 153 0 0
✅ nextjs-webpack-stable 153 0 0
✅ nitro-stable 128 0 25
✅ nuxt-stable 128 0 25
✅ sveltekit-stable 147 0 6
✅ vite-stable 128 0 25
✅ 📦 Local Production
App Passed Failed Skipped
✅ astro-stable 128 0 25
✅ express-stable 128 0 25
✅ fastify-stable 128 0 25
✅ hono-stable 128 0 25
✅ nextjs-turbopack-canary 134 0 19
✅ nextjs-turbopack-stable 153 0 0
✅ nextjs-webpack-canary 134 0 19
✅ nextjs-webpack-stable 153 0 0
✅ nitro-stable 128 0 25
✅ nuxt-stable 128 0 25
✅ sveltekit-stable 147 0 6
✅ vite-stable 128 0 25
✅ 🐘 Local Postgres
App Passed Failed Skipped
✅ astro-stable 128 0 25
✅ express-stable 128 0 25
✅ fastify-stable 128 0 25
✅ hono-stable 128 0 25
✅ nextjs-turbopack-canary 134 0 19
✅ nextjs-turbopack-stable 153 0 0
✅ nextjs-webpack-canary 134 0 19
✅ nextjs-webpack-stable 153 0 0
✅ nitro-stable 128 0 25
✅ nuxt-stable 128 0 25
✅ sveltekit-stable 147 0 6
✅ vite-stable 128 0 25
✅ 🪟 Windows
App Passed Failed Skipped
✅ nextjs-turbopack 153 0 0
✅ 📋 Other
App Passed Failed Skipped
✅ e2e-local-dev-nest-stable 128 0 25
✅ e2e-local-dev-tanstack-start- 128 0 25
✅ e2e-local-postgres-nest-stable 128 0 25
✅ e2e-local-postgres-tanstack-start- 128 0 25
✅ e2e-local-prod-nest-stable 128 0 25
✅ e2e-local-prod-tanstack-start- 128 0 25
✅ e2e-vercel-prod-tanstack-start 126 0 27
✅ vercel-multi-region
App Passed Failed Skipped
✅ nextjs-turbopack 27 0 0

📋 View full workflow run


Some E2E test jobs failed:

  • Vercel Prod: success
  • Local Dev: failure
  • Local Prod: success
  • Local Postgres: success
  • Windows: success

Check the workflow run for details.

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.

1 participant