Track Vercel request IDs on workflow events for logs correlation by karthikscale3 · Pull Request #1396 · vercel/workflow

karthikscale3 · 2026-03-16T16:12:47Z

Summary

Captures the x-vercel-id header from incoming VQS requests using AsyncLocalStorage and threads it through the entire workflow and step execution pipeline
Every world.events.create() call now forwards the request ID as vercelId in the event creation payload, enabling correlation between Vercel platform request logs and workflow events
Adds requestId to the CreateEventParams interface (@workflow/world) and the queue handler metadata, making this available to all world implementations

Changes

@workflow/world: Added requestId to CreateEventParams and queue handler metadata types
@workflow/world-vercel: Extracts x-vercel-id from the incoming request header via AsyncLocalStorage, passes it as vercelId in event creation POST bodies
@workflow/core: Plumbs requestId from queue metadata through the runtime, step handler, and suspension handler to all event creation calls (run_started, run_completed, run_failed, step_started, step_completed, step_failed, step_retried, hooks, waits)

Test plan

Verify x-vercel-id header is correctly captured from VQS callback requests
Confirm vercelId appears in event creation payloads to workflow-server
Validate existing e2e tests pass (no behavioral change, additive only)

Co-authored-by: Peter Wielander <mittgfu@gmail.com> Signed-off-by: Karthik Kalyan <105607645+karthikscale3@users.noreply.github.com>

Merge main into v2-flow, incorporating: - Track Vercel request IDs on workflow events (#1396) - DurableAgent compatibility fixes (#1385) Conflict resolution: - runtime.ts: keep V2 handler, add requestId to all events.create calls - suspension-handler.ts: keep V2 handler, add requestId parameter - e2e-agent.test.ts: take main's version, re-add BOA skip logic Also fix step error source map expectations for BOA deployments: the V2 combined CJS bundle (bundleFinalOutput: true) strips source file names during re-bundling, so hasStepSourceMaps() now returns false for BOA-builder frameworks on Vercel preview. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

karthikscale3 · 2026-03-16T16:12:47Z

Summary

Captures the x-vercel-id header from incoming VQS requests using AsyncLocalStorage and threads it through the entire workflow and step execution pipeline
Every world.events.create() call now forwards the request ID as vercelId in the event creation payload, enabling correlation between Vercel platform request logs and workflow events
Adds requestId to the CreateEventParams interface (@workflow/world) and the queue handler metadata, making this available to all world implementations

Changes

@workflow/world: Added requestId to CreateEventParams and queue handler metadata types
@workflow/world-vercel: Extracts x-vercel-id from the incoming request header via AsyncLocalStorage, passes it as vercelId in event creation POST bodies
@workflow/core: Plumbs requestId from queue metadata through the runtime, step handler, and suspension handler to all event creation calls (run_started, run_completed, run_failed, step_started, step_completed, step_failed, step_retried, hooks, waits)

Test plan

Verify x-vercel-id header is correctly captured from VQS callback requests
Confirm vercelId appears in event creation payloads to workflow-server
Validate existing e2e tests pass (no behavioral change, additive only)

Co-authored-by: Peter Wielander <mittgfu@gmail.com> Signed-off-by: Karthik Kalyan <105607645+karthikscale3@users.noreply.github.com>

Merge main into v2-flow, incorporating: - Track Vercel request IDs on workflow events (#1396) - DurableAgent compatibility fixes (#1385) Conflict resolution: - runtime.ts: keep V2 handler, add requestId to all events.create calls - suspension-handler.ts: keep V2 handler, add requestId parameter - e2e-agent.test.ts: take main's version, re-add BOA skip logic Also fix step error source map expectations for BOA deployments: the V2 combined CJS bundle (bundleFinalOutput: true) strips source file names during re-bundling, so hasStepSourceMaps() now returns false for BOA-builder frameworks on Vercel preview. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

karthikscale3 · 2026-03-16T16:12:47Z

Summary

Captures the x-vercel-id header from incoming VQS requests using AsyncLocalStorage and threads it through the entire workflow and step execution pipeline
Every world.events.create() call now forwards the request ID as vercelId in the event creation payload, enabling correlation between Vercel platform request logs and workflow events
Adds requestId to the CreateEventParams interface (@workflow/world) and the queue handler metadata, making this available to all world implementations

Changes

@workflow/world: Added requestId to CreateEventParams and queue handler metadata types
@workflow/world-vercel: Extracts x-vercel-id from the incoming request header via AsyncLocalStorage, passes it as vercelId in event creation POST bodies
@workflow/core: Plumbs requestId from queue metadata through the runtime, step handler, and suspension handler to all event creation calls (run_started, run_completed, run_failed, step_started, step_completed, step_failed, step_retried, hooks, waits)

Test plan

Verify x-vercel-id header is correctly captured from VQS callback requests
Confirm vercelId appears in event creation payloads to workflow-server
Validate existing e2e tests pass (no behavioral change, additive only)

Co-authored-by: Peter Wielander <mittgfu@gmail.com> Signed-off-by: Karthik Kalyan <105607645+karthikscale3@users.noreply.github.com>

Merge main into v2-flow, incorporating: - Track Vercel request IDs on workflow events (#1396) - DurableAgent compatibility fixes (#1385) Conflict resolution: - runtime.ts: keep V2 handler, add requestId to all events.create calls - suspension-handler.ts: keep V2 handler, add requestId parameter - e2e-agent.test.ts: take main's version, re-add BOA skip logic Also fix step error source map expectations for BOA deployments: the V2 combined CJS bundle (bundleFinalOutput: true) strips source file names during re-bundling, so hasStepSourceMaps() now returns false for BOA-builder frameworks on Vercel preview. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

karthikscale3 · 2026-03-16T16:12:47Z

Summary

Captures the x-vercel-id header from incoming VQS requests using AsyncLocalStorage and threads it through the entire workflow and step execution pipeline
Every world.events.create() call now forwards the request ID as vercelId in the event creation payload, enabling correlation between Vercel platform request logs and workflow events
Adds requestId to the CreateEventParams interface (@workflow/world) and the queue handler metadata, making this available to all world implementations

Changes

@workflow/world: Added requestId to CreateEventParams and queue handler metadata types
@workflow/world-vercel: Extracts x-vercel-id from the incoming request header via AsyncLocalStorage, passes it as vercelId in event creation POST bodies
@workflow/core: Plumbs requestId from queue metadata through the runtime, step handler, and suspension handler to all event creation calls (run_started, run_completed, run_failed, step_started, step_completed, step_failed, step_retried, hooks, waits)

Test plan

Verify x-vercel-id header is correctly captured from VQS callback requests
Confirm vercelId appears in event creation payloads to workflow-server
Validate existing e2e tests pass (no behavioral change, additive only)

Co-authored-by: Peter Wielander <mittgfu@gmail.com> Signed-off-by: Karthik Kalyan <105607645+karthikscale3@users.noreply.github.com>

Merge main into v2-flow, incorporating: - Track Vercel request IDs on workflow events (#1396) - DurableAgent compatibility fixes (#1385) Conflict resolution: - runtime.ts: keep V2 handler, add requestId to all events.create calls - suspension-handler.ts: keep V2 handler, add requestId parameter - e2e-agent.test.ts: take main's version, re-add BOA skip logic Also fix step error source map expectations for BOA deployments: the V2 combined CJS bundle (bundleFinalOutput: true) strips source file names during re-bundling, so hasStepSourceMaps() now returns false for BOA-builder frameworks on Vercel preview. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

karthikscale3 · 2026-03-16T16:12:47Z

Summary

Captures the x-vercel-id header from incoming VQS requests using AsyncLocalStorage and threads it through the entire workflow and step execution pipeline
Every world.events.create() call now forwards the request ID as vercelId in the event creation payload, enabling correlation between Vercel platform request logs and workflow events
Adds requestId to the CreateEventParams interface (@workflow/world) and the queue handler metadata, making this available to all world implementations

Changes

@workflow/world: Added requestId to CreateEventParams and queue handler metadata types
@workflow/world-vercel: Extracts x-vercel-id from the incoming request header via AsyncLocalStorage, passes it as vercelId in event creation POST bodies
@workflow/core: Plumbs requestId from queue metadata through the runtime, step handler, and suspension handler to all event creation calls (run_started, run_completed, run_failed, step_started, step_completed, step_failed, step_retried, hooks, waits)

Test plan

Verify x-vercel-id header is correctly captured from VQS callback requests
Confirm vercelId appears in event creation payloads to workflow-server
Validate existing e2e tests pass (no behavioral change, additive only)

Co-authored-by: Peter Wielander <mittgfu@gmail.com> Signed-off-by: Karthik Kalyan <105607645+karthikscale3@users.noreply.github.com>

Merge main into v2-flow, incorporating: - Track Vercel request IDs on workflow events (#1396) - DurableAgent compatibility fixes (#1385) Conflict resolution: - runtime.ts: keep V2 handler, add requestId to all events.create calls - suspension-handler.ts: keep V2 handler, add requestId parameter - e2e-agent.test.ts: take main's version, re-add BOA skip logic Also fix step error source map expectations for BOA deployments: the V2 combined CJS bundle (bundleFinalOutput: true) strips source file names during re-bundling, so hasStepSourceMaps() now returns false for BOA-builder frameworks on Vercel preview. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

karthikscale3 · 2026-03-16T16:12:47Z

Summary

Captures the x-vercel-id header from incoming VQS requests using AsyncLocalStorage and threads it through the entire workflow and step execution pipeline
Every world.events.create() call now forwards the request ID as vercelId in the event creation payload, enabling correlation between Vercel platform request logs and workflow events
Adds requestId to the CreateEventParams interface (@workflow/world) and the queue handler metadata, making this available to all world implementations

Changes

@workflow/world: Added requestId to CreateEventParams and queue handler metadata types
@workflow/world-vercel: Extracts x-vercel-id from the incoming request header via AsyncLocalStorage, passes it as vercelId in event creation POST bodies
@workflow/core: Plumbs requestId from queue metadata through the runtime, step handler, and suspension handler to all event creation calls (run_started, run_completed, run_failed, step_started, step_completed, step_failed, step_retried, hooks, waits)

Test plan

Verify x-vercel-id header is correctly captured from VQS callback requests
Confirm vercelId appears in event creation payloads to workflow-server
Validate existing e2e tests pass (no behavioral change, additive only)

Co-authored-by: Peter Wielander <mittgfu@gmail.com> Signed-off-by: Karthik Kalyan <105607645+karthikscale3@users.noreply.github.com>

Merge main into v2-flow, incorporating: - Track Vercel request IDs on workflow events (#1396) - DurableAgent compatibility fixes (#1385) Conflict resolution: - runtime.ts: keep V2 handler, add requestId to all events.create calls - suspension-handler.ts: keep V2 handler, add requestId parameter - e2e-agent.test.ts: take main's version, re-add BOA skip logic Also fix step error source map expectations for BOA deployments: the V2 combined CJS bundle (bundleFinalOutput: true) strips source file names during re-bundling, so hasStepSourceMaps() now returns false for BOA-builder frameworks on Vercel preview. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

karthikscale3 · 2026-03-16T16:12:47Z

Summary

Captures the x-vercel-id header from incoming VQS requests using AsyncLocalStorage and threads it through the entire workflow and step execution pipeline
Every world.events.create() call now forwards the request ID as vercelId in the event creation payload, enabling correlation between Vercel platform request logs and workflow events
Adds requestId to the CreateEventParams interface (@workflow/world) and the queue handler metadata, making this available to all world implementations

Changes

@workflow/world: Added requestId to CreateEventParams and queue handler metadata types
@workflow/world-vercel: Extracts x-vercel-id from the incoming request header via AsyncLocalStorage, passes it as vercelId in event creation POST bodies
@workflow/core: Plumbs requestId from queue metadata through the runtime, step handler, and suspension handler to all event creation calls (run_started, run_completed, run_failed, step_started, step_completed, step_failed, step_retried, hooks, waits)

Test plan

Verify x-vercel-id header is correctly captured from VQS callback requests
Confirm vercelId appears in event creation payloads to workflow-server
Validate existing e2e tests pass (no behavioral change, additive only)

Co-authored-by: Peter Wielander <mittgfu@gmail.com> Signed-off-by: Karthik Kalyan <105607645+karthikscale3@users.noreply.github.com>

Merge main into v2-flow, incorporating: - Track Vercel request IDs on workflow events (#1396) - DurableAgent compatibility fixes (#1385) Conflict resolution: - runtime.ts: keep V2 handler, add requestId to all events.create calls - suspension-handler.ts: keep V2 handler, add requestId parameter - e2e-agent.test.ts: take main's version, re-add BOA skip logic Also fix step error source map expectations for BOA deployments: the V2 combined CJS bundle (bundleFinalOutput: true) strips source file names during re-bundling, so hasStepSourceMaps() now returns false for BOA-builder frameworks on Vercel preview. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

karthikscale3 · 2026-03-16T16:12:47Z

Summary

Captures the x-vercel-id header from incoming VQS requests using AsyncLocalStorage and threads it through the entire workflow and step execution pipeline
Every world.events.create() call now forwards the request ID as vercelId in the event creation payload, enabling correlation between Vercel platform request logs and workflow events
Adds requestId to the CreateEventParams interface (@workflow/world) and the queue handler metadata, making this available to all world implementations

Changes

@workflow/world: Added requestId to CreateEventParams and queue handler metadata types
@workflow/world-vercel: Extracts x-vercel-id from the incoming request header via AsyncLocalStorage, passes it as vercelId in event creation POST bodies
@workflow/core: Plumbs requestId from queue metadata through the runtime, step handler, and suspension handler to all event creation calls (run_started, run_completed, run_failed, step_started, step_completed, step_failed, step_retried, hooks, waits)

Test plan

Verify x-vercel-id header is correctly captured from VQS callback requests
Confirm vercelId appears in event creation payloads to workflow-server
Validate existing e2e tests pass (no behavioral change, additive only)

Co-authored-by: Peter Wielander <mittgfu@gmail.com> Signed-off-by: Karthik Kalyan <105607645+karthikscale3@users.noreply.github.com>

Merge main into v2-flow, incorporating: - Track Vercel request IDs on workflow events (#1396) - DurableAgent compatibility fixes (#1385) Conflict resolution: - runtime.ts: keep V2 handler, add requestId to all events.create calls - suspension-handler.ts: keep V2 handler, add requestId parameter - e2e-agent.test.ts: take main's version, re-add BOA skip logic Also fix step error source map expectations for BOA deployments: the V2 combined CJS bundle (bundleFinalOutput: true) strips source file names during re-bundling, so hasStepSourceMaps() now returns false for BOA-builder frameworks on Vercel preview. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

karthikscale3 added 30 commits January 27, 2026 10:51

Merge branch 'main' of github.com:vercel/workflow
ad8b7f1

Merge branch 'main' of github.com:vercel/workflow
e0cb61b

Merge branch 'main' of github.com:vercel/workflow
051cadc

Merge branch 'main' of github.com:vercel/workflow
af8ac1f

Merge branch 'main' of github.com:vercel/workflow
e68e7d2

Merge branch 'main' of github.com:vercel/workflow
8305e5b

Merge branch 'main' of github.com:vercel/workflow
f3da688

Merge branch 'main' of github.com:vercel/workflow
f8ee413

Merge branch 'main' of github.com:vercel/workflow
589cbd7

Merge branch 'main' of github.com:vercel/workflow
e979fdf

Merge branch 'main' of github.com:vercel/workflow
d4baed2

Merge branch 'main' of github.com:vercel/workflow
53503a4

Merge branch 'main' of github.com:vercel/workflow
d51e2e4

Merge branch 'main' of github.com:vercel/workflow
5123088

Merge branch 'main' of github.com:vercel/workflow
dd1a307

Merge branch 'main' of github.com:vercel/workflow
00bcfcd

Merge branch 'main' of github.com:vercel/workflow
f6a157b

Merge branch 'main' of github.com:vercel/workflow
816f35b

Merge branch 'main' of github.com:vercel/workflow
2b87dce

Merge branch 'main' of github.com:vercel/workflow
146de28

Merge branch 'main' of github.com:vercel/workflow
0ef6455

Merge branch 'main' of github.com:vercel/workflow
2d8c690

Merge branch 'main' of github.com:vercel/workflow
3513471

Merge branch 'main' of github.com:vercel/workflow
0f5d29e

Merge branch 'main' of github.com:vercel/workflow
c76001e

Merge branch 'main' of github.com:vercel/workflow
f97184f

Merge branch 'main' of github.com:vercel/workflow
f71c531

Merge branch 'main' of github.com:vercel/workflow
530e598

Merge branch 'main' of github.com:vercel/workflow
ea38511

Merge branch 'main' of github.com:vercel/workflow
19b1a3f

vercelBotdeployed to Preview – workbench-nitro-workflow March 16, 2026 19:38 View deployment

vercelBotdeployed to Preview – workbench-sveltekit-workflow March 16, 2026 19:38 View deployment

vercelBotdeployed to Preview – workbench-astro-workflow March 16, 2026 19:38 View deployment

vercelBotdeployed to Preview – workflow-nest March 16, 2026 19:38 View deployment

vercelBotdeployed to Preview – workbench-fastify-workflow March 16, 2026 19:38 View deployment

vercelBotdeployed to Preview – workbench-nuxt-workflow March 16, 2026 19:38 View deployment

vercelBotdeployed to Preview – example-nextjs-workflow-turbopack March 16, 2026 19:39 View deployment

vercelBotdeployed to Preview – workflow-docs March 16, 2026 19:39 View deployment

vercelBotdeployed to Preview – example-nextjs-workflow-webpack March 16, 2026 19:39 View deployment

VaguelySerious approved these changes Mar 16, 2026
View reviewed changes

Comment threadpackages/world/src/events.ts Outdated

karthikscale3and others added 2 commits March 16, 2026 13:29

Update packages/world/src/events.ts
89c63da
Co-authored-by: Peter Wielander <mittgfu@gmail.com> Signed-off-by: Karthik Kalyan <105607645+karthikscale3@users.noreply.github.com>

Merge branch 'main' into karthik/logs-correlation
39fe4a6

vercelBotdeployed to Preview – workflow-swc-playground March 16, 2026 20:30 View deployment

vercelBotdeployed to Preview – workbench-hono-workflow March 16, 2026 20:31 View deployment

vercelBotdeployed to Preview – workbench-express-workflow March 16, 2026 20:31 View deployment

vercelBotdeployed to Preview – workbench-vite-workflow March 16, 2026 20:31 View deployment

vercelBotdeployed to Preview – workbench-fastify-workflow March 16, 2026 20:31 View deployment

vercelBotdeployed to Preview – workbench-nitro-workflow March 16, 2026 20:31 View deployment

vercelBotdeployed to Preview – workbench-astro-workflow March 16, 2026 20:31 View deployment

vercelBotdeployed to Preview – example-workflow March 16, 2026 20:31 View deployment

vercelBotdeployed to Preview – workbench-sveltekit-workflow March 16, 2026 20:31 View deployment

vercelBotdeployed to Preview – workflow-nest March 16, 2026 20:31 View deployment

vercelBotdeployed to Preview – workbench-nuxt-workflow March 16, 2026 20:31 View deployment

vercelBotdeployed to Preview – example-nextjs-workflow-turbopack March 16, 2026 20:31 View deployment

vercelBotdeployed to Preview – workflow-docs March 16, 2026 20:31 View deployment

vercelBotdeployed to Preview – example-nextjs-workflow-webpack March 16, 2026 20:31 View deployment

karthikscale3 merged commit 2f0772d into mainMar 17, 2026
105 checks passed

karthikscale3 deleted the karthik/logs-correlation branch March 17, 2026 17:08

ghost mentioned this pull request Mar 17, 2026
Version Packages (beta) #1377
Merged