[world-vercel] Switch event endpoints to v4 wire format#2055
Draft
VaguelySerious wants to merge 26 commits into
Draft
[world-vercel] Switch event endpoints to v4 wire format#2055VaguelySerious wants to merge 26 commits into
VaguelySerious wants to merge 26 commits into
Conversation
Mirrors the v4 server-side handlers landing in workflow-server. The
v4 wire format moves event metadata into x-wf-* request/response
headers and treats payloads as opaque user-data bytes (streamed
end-to-end). The SDK passes Uint8Array bytes through unchanged at
this layer; higher-level world-vercel adapter glue handles CBOR.
Adds:
- packages/world-vercel/src/frames.ts: encoder + async-iterable
decoder for the length-prefixed binary frame format used by the
v4 list-events response.
- packages/world-vercel/src/events-v4.ts: three new functions:
* createWorkflowRunEventV4 — POST with x-wf-* headers + payload
bytes, returns event/run ids and timestamp from response
headers.
* getEventV4 — GET single event, returns metadata + body bytes.
* getWorkflowRunEventsV4 — GET list, parses frame stream, returns
events + pagination cursor.
- V4_HEADERS exported as the canonical name map; mirrors the
server-side constant.
V4 client characteristics:
- Required runId in URL for run_created too (no /runs/null/events
shortcut; the runId is part of the S3 key the server allocates).
Higher-level callers generate the ULID client-side.
- Payload bytes flow through without CBOR encode/decode on this
layer. Callers CBOR-encode for parity with v3 if they want.
- Pagination cursor surfaces in the LIST response — eliminates the
per-large-payload /refs round-trip used by v2/v3.
Tests (10 new in src/frames.test.ts, no new e2e):
- Canonical wire layout round-trip.
- Multi-frame round-trip with pagination cursor.
- Decoder survives 1-byte chunk delivery (matching spike B's chunk-
boundary robustness requirement).
- 64 KB body split across many small chunks.
- Bodies containing 0xff padding don't mis-frame.
- Back-to-back frames in a single chunk.
- Truncated stream raises.
- Meta CBOR types (numbers, booleans, arrays) preserved.
The world-vercel adapter still defaults to the v3 path; v4 is exposed
for direct callers and a follow-up PR will switch the adapter over
once the matching server-side PR is on staging.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
🦋 Changeset detectedLatest commit: 4b466de The changes in this PR will be included in the next version bump. This PR includes changesets to release 17 packages
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 |
Contributor
Contributor
🧪 E2E Test Results❌ Some tests failed Summary
❌ Failed Tests▲ Vercel Production (115 failed)nextjs-webpack (115 failed):
Details by Category❌ ▲ Vercel Production
✅ 💻 Local Development
✅ 📦 Local Production
✅ 🐘 Local Postgres
✅ 🪟 Windows
✅ 📋 Other
❌ Some E2E test jobs failed:
Check the workflow run for details. |
Contributor
📊 Benchmark Results
workflow with no steps💻 Local Development
workflow with 1 step💻 Local Development
workflow with 10 sequential steps💻 Local Development
workflow with 25 sequential steps💻 Local Development
workflow with 50 sequential steps💻 Local Development
Promise.all with 10 concurrent steps💻 Local Development
Promise.all with 25 concurrent steps💻 Local Development
Promise.all with 50 concurrent steps💻 Local Development
Promise.race with 10 concurrent steps💻 Local Development
Promise.race with 25 concurrent steps💻 Local Development
Promise.race with 50 concurrent steps💻 Local Development
workflow with 10 sequential data payload steps (10KB)💻 Local Development
workflow with 25 sequential data payload steps (10KB)💻 Local Development
workflow with 50 sequential data payload steps (10KB)💻 Local Development
workflow with 10 concurrent data payload steps (10KB)💻 Local Development
workflow with 25 concurrent data payload steps (10KB)💻 Local Development
workflow with 50 concurrent data payload steps (10KB)💻 Local Development
Stream Benchmarks (includes TTFB metrics)workflow with stream💻 Local Development
stream pipeline with 5 transform steps (1MB)💻 Local Development
10 parallel streams (1MB each)💻 Local Development
fan-out fan-in 10 streams (1MB each)💻 Local Development
SummaryFastest Framework by WorldWinner determined by most benchmark wins
Fastest World by FrameworkWinner determined by most benchmark wins
Column Definitions
Worlds:
❌ Some benchmark jobs failed:
Check the workflow run for details. |
Sets WORKFLOW_SERVER_URL_OVERRIDE in packages/world-vercel/src/utils.ts to https://workflow-server-git-peter-v4.vercel.sh so that e2e tests running off this SDK branch exercise the v4-enabled workflow-server preview instead of production. The override is the inline mechanism documented at the constant — when set, it wins over both the default (https://vercel-workflow.com) and the VERCEL_WORKFLOW_SERVER_URL env var. The same pattern is used in v4 testing on the workflow- server side: CI rewrites this string on PR branches. Reset to '' before merging to main. Companion to vercel/workflow-server#439. Updates four tests in utils.test.ts that previously assumed the override is empty. Each affected assertion gets a comment noting what the expectation looks like on main; flipping back to the main behavior is a one-line edit per test when the override is reset. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
…CBOR The matching server-side change (workflow-server PR #439, commit 5d79cf1) now returns: - GET single event: full event entity CBOR-encoded in the body (resolves refs server-side and bakes payload into eventData). - LIST events: each frame's meta is the full event entity (CBOR), payload stays as a RefDescriptor in eventData[field], resolved bytes ride in the frame body. This commit threads that through the world-vercel adapter: - events-v4.ts: * getEventV4 returns DecodedV4Event (CBOR-decode of response body). Drop the parseEventMetaFromHeaders / readHeader-driven reconstruction. * ListedEventV4 carries `{ event: DecodedV4Event, body: Uint8Array }` — the full entity plus the resolved payload bytes to splice in. - events.ts: * buildEventFromV4 takes (decoded entity, payload bytes) and splices the bytes into eventData[payloadField] for the LIST path. For the GET path the server already baked the bytes in, so buildEventFromV4 is called with an empty body. * CBOR-decode the payload bytes back into the original JS value on read. Matches the unconditional CBOR-encode on write (Uint8Array round-trips via cbor-x's binary type). Why this matters: the workflow runtime's replay path reads arbitrary fields off eventData (executionContext, hookToken, isWebhook, resumeAt, error shape, …). The previous cherry-picked-metadata shape dropped those fields, which is why every E2E Vercel Prod test on this branch was getting stuck after run_started with no further events — the runtime's invocation of the workflow function on the workbench deployment couldn't reconstruct state correctly. Companion to workflow-server PR #439 commit 5d79cf1. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
VaguelySerious
commented
May 25, 2026
| @@ -0,0 +1,5 @@ | |||
| --- | |||
| "@workflow/world-vercel": major | |||
Member
Author
There was a problem hiding this comment.
Suggested change
| "@workflow/world-vercel": major | |
| "@workflow/world-vercel": minor |
Member
Author
There was a problem hiding this comment.
Applied — both the bump type and the description are updated in 3d03e5d (changeset edit in this push).
VaguelySerious
commented
May 25, 2026
| "@workflow/world-vercel": major | ||
| --- | ||
|
|
||
| Switch the world-vercel adapter's event endpoints from the v2/v3 wire format to v4. Event metadata now rides in `x-wf-*` HTTP headers and payloads stream end-to-end as opaque bytes — no server-side CBOR parse on writes, and no per-event `/refs` round-trip on list responses. POST event response carries the materialized EventResult as a CBOR body. Public `createWorkflowRunEvent` / `getEvent` / `getWorkflowRunEvents` signatures are unchanged; the underlying wire calls swap to v4. `listEventsByCorrelationId` is not yet implemented on v4 and now throws — callers should fetch hooks directly via `storage.hooks.getByToken`. Requires workflow-server with v4 routes mounted. |
Member
Author
There was a problem hiding this comment.
Suggested change
| Switch the world-vercel adapter's event endpoints from the v2/v3 wire format to v4. Event metadata now rides in `x-wf-*` HTTP headers and payloads stream end-to-end as opaque bytes — no server-side CBOR parse on writes, and no per-event `/refs` round-trip on list responses. POST event response carries the materialized EventResult as a CBOR body. Public `createWorkflowRunEvent` / `getEvent` / `getWorkflowRunEvents` signatures are unchanged; the underlying wire calls swap to v4. `listEventsByCorrelationId` is not yet implemented on v4 and now throws — callers should fetch hooks directly via `storage.hooks.getByToken`. Requires workflow-server with v4 routes mounted. | |
| New internal API format: separately encode event metadata from user payloads. Eliminates the need for calling separate endpoints for ref resolution, which improves performance on longer runs. |
Member
Author
There was a problem hiding this comment.
Applied — both the bump type and the description are updated in 3d03e5d (changeset edit in this push).
Companion to workflow-server PR #439 commit 2a55acd, which switched GET /api/v4/runs/:runId/events/:eventId from a CBOR-entity body to a single v4 frame (same wire shape as one LIST frame). - getEventV4 now returns `{ event: DecodedV4Event, body: Uint8Array }` by reading exactly one frame off the response body via `decodeFrames` — same reader the LIST path uses. No content-type branching, no separate CBOR decode path. - getEvent (the storage adapter wrapper) passes both pieces to `buildEventFromV4`, which splices the CBOR-decoded body into `eventData[payloadField]`. Same path LIST already uses, so no GET-specific shape exists anymore. - Drop the special-case fallback in `buildEventFromV4` that used to re-decode an in-eventData Uint8Array — only one input shape now. Net effect: server-side memory for GET single-event is now bounded by S3 chunk size (~64 KB) instead of full payload size. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Companion to workflow-server PR #439 commit 5036b56, which added `GET /api/v4/events?correlationId=...`. The SDK adapter's `storage.events.listByCorrelationId` no longer throws. Implementation: - New `getEventsByCorrelationIdV4` wire helper alongside `getWorkflowRunEventsV4`. Both share a small `consumeListFrameStream(url, config, opName)` that drives the same frame-stream-to-page conversion — only the URL differs. - `events.ts`'s `getWorkflowRunEvents` dispatches between the two based on whether params carry `runId` or `correlationId`. Same return shape on either path. Changeset updated to drop the "not yet implemented" caveat. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
…st headers Mirrors the server-side change in workflow-server: the POST request body is now one length-prefixed frame containing CBOR-encoded metadata plus the opaque payload. Eliminates the V4_HEADERS constant, the percent-encoding for non-ASCII values, the base64-CBOR encoding for executionContext, and the implicit 32 KB cap on Vercel header size. The response side still uses x-wf-event-id/run-id/created-at headers for callers that want eventId without decoding the CBOR body. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
VaguelySerious
commented
May 25, 2026
| "@workflow/world-vercel": major | ||
| --- | ||
|
|
||
| Switch the world-vercel adapter's event endpoints from the v2/v3 wire format to v4. Event metadata now rides in `x-wf-*` HTTP headers and payloads stream end-to-end as opaque bytes — no server-side CBOR parse on writes, and no per-event `/refs` round-trip on list responses. POST event response carries the materialized EventResult as a CBOR body. GET single event and LIST events use the same `application/vnd.workflow.v4-frames` binary frame stream; `listEventsByCorrelationId` is wired through too. Public `createWorkflowRunEvent` / `getEvent` / `getWorkflowRunEvents` signatures are unchanged. Requires workflow-server with v4 routes mounted. |
Member
Author
There was a problem hiding this comment.
Suggested change
| Switch the world-vercel adapter's event endpoints from the v2/v3 wire format to v4. Event metadata now rides in `x-wf-*` HTTP headers and payloads stream end-to-end as opaque bytes — no server-side CBOR parse on writes, and no per-event `/refs` round-trip on list responses. POST event response carries the materialized EventResult as a CBOR body. GET single event and LIST events use the same `application/vnd.workflow.v4-frames` binary frame stream; `listEventsByCorrelationId` is wired through too. Public `createWorkflowRunEvent` / `getEvent` / `getWorkflowRunEvents` signatures are unchanged. Requires workflow-server with v4 routes mounted. | |
| New internal API format: separately encode event metadata from user payloads. Eliminates the need for calling separate endpoints for ref resolution, which improves performance especially on longer runs. |
Member
Author
There was a problem hiding this comment.
Applied — both the bump type and the description are updated in 3d03e5d (changeset edit in this push).
Payload fields (input / output / result / error / payload / metadata) reach world-vercel after the runtime has already serialized them via dehydrateRunError / dehydrateStepReturnValue / dehydrateStepArguments — they're Uint8Arrays carrying a devalue blob with a format prefix. splitEventDataForV4 was running them through cbor-x.encode again, so the wire bytes ended up as cbor(Uint8Array). On reads through runs.get (which goes through v2 and just returns the raw stored bytes), the consumer saw the CBOR wrapping and hydrateRunError couldn't parse the format prefix — every failed workflow run surfaced as "Failed to hydrate workflow run error". Pass the bytes through unchanged on write and read; symmetric with world-local and the v2/v3 wire format. Throw on non-Uint8Array to flag non-runtime callers loudly instead of silently double-wrapping. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
…emitter) Hook-emitting runtimes set eventData.token (matches the world contract in packages/world/src/events.ts). splitEventDataForV4 was looking for eventData.hookToken instead, so the frame meta arrived without a token and the server's hook materialization failed validation. The v4 wire name (meta.hookToken) is unchanged. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
cbor-x encodes Date natively (CBOR tag 1) and the server (post-23c79b9) decodes it back to a Date for the materialization service. Stop pre-flattening to an ISO string — that was a workaround for the original header-based v4 contract and now leaves the runtime with a string in eventData.resumeAt after replay, blowing up on .getTime(). Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
…d path DynamoDB's eventData column stringifies Date values on write — even when the v4 frame meta originally carried them as native Dates — so the v4 GET/LIST response delivers eventData.resumeAt back as an ISO string. The runtime expects a Date (wait_created.resumeAt → .getTime() in the replay loop) and crashed every sleeping workflow with "resumeAt.getTime is not a function". Run the assembled event through EventSchema.safeParse, which applies the per-event-type z.coerce.date() that mirror the v2/v3 read path (see packages/world-vercel/src/events.ts on main). safeParse so a mid-rollout event with an unknown shape still passes through unchanged. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
The previous Tests run (26447355995) on commit e278374 got stuck in a "queued" state for 20+ minutes — likely related to the same GitHub account/token suspension that blocked the vercel/wait-for-deployment step earlier today. `gh run rerun --failed` and even `POST /actions/runs/.../cancel` were rejected. Force a fresh push so a new workflow run is created. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
The previous CI retrigger commits e699861 and the subsequent main merge 512ce2a didn't spawn workflow runs because GitHub Actions was degraded throughout that window (incident gnftqj9htp0g, mitigated 2026-05-26T13:01Z). Push an empty commit now that the platform is healthy. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
The E2E suite is failing with "Failed to hydrate step error: Invalid
format prefix" on every step_failed / run_failed replay even after the
CBOR-double-wrap fix. The bytes arriving at hydrateStepError have a
prefix that doesn't match /^[a-z0-9]{4}$/, which means they were never
the devalue blob dehydrateStepError emitted — something on the read
path is reshaping them.
Add a temporary console.warn in buildEventFromV4 that dumps the first
16 bytes (hex) and the failed prefix string when the body bytes for a
step_failed / run_failed event don't look like a valid format prefix.
The output lands in the workbench Vercel logs alongside the workflow
replay. Revert once we identify the source.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Previous diagnostic that only logged bad-prefix cases never fired in workbench Vercel logs. Either the bytes are already valid here (and the failure is later in the pipeline) or buildEventFromV4 isn't being hit at all for the failing replays. Log every step_failed / run_failed event so we can tell which scenario we're in. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Root cause for the step-error hydration failure was found server-side (workflow-server@899193a — handleStepFailed / handleStepRetrying now recognize pre-built RemoteRef instances and pass them through). Drop the temporary console.warn that was logging every step_failed / run_failed event's payload prefix. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
…rt input Matches the server-side change in workflow-server@961988e. When run_created POST fails (e.g. simulated 500 in the resilient-start e2e), the runtime re-issues run_started with the run-input bag attached to eventData (input + deploymentId + workflowName + executionContext). Without listing run_started here we'd silently drop the input bytes during splitEventDataForV4, leaving the server's "run_started arrived before run_created" fallback with no input to backfill from. For a normal run_started call (no eventData) the new entry is a no-op — the eventData lookup misses and no payload is built. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
createWorkflowRunEventV4 / getEventV4 / getWorkflowRunEventsV4 were throwing plain \`Error\` on non-2xx — meaning runtime callers that specifically branch on EntityConflictError / RunExpiredError / ThrottleError saw an opaque error and treated it as fatal. The runClassSerializationWorkflow e2e regressed once run_started carried input on the resilient-start path: queue + run_started races against run_created sometimes win, and the parallel run_created POST in start() then 409s. start() catches EntityConflictError on that path and continues — but only if the error has the right type. Mirror the v3 makeRequest mapping (utils.ts): 409 → EntityConflictError, 410 → RunExpiredError, 425 → TooEarlyError, 429 → ThrottleError, everything else → WorkflowWorldError with the original status. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
…ient-start input" This reverts commit 0859f25.
Re-add the SDK-side run_started: 'input' entry to PAYLOAD_FIELD_BY_EVENT_TYPE (server already has it from 961988e). Previous attempt regressed ~6 unrelated workflows with "Invalid input" / devalue parse errors, but I never identified the root cause — too generic of a message. Add a temporary console.warn in workflow.ts that dumps workflowRun.input shape + first 16 bytes right before hydrateWorkflowArguments, so the workbench Vercel logs surface exactly which bytes are arriving when the hydration fails. Wraps the hydrate in try/catch to also log the exception path. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
…9/429/5xx start.ts catches EntityConflictError on the run_created POST so a resilient-start race against start.ts's parallel POST can ride through cleanly. With plain Error, the 409 was treated as fatal and any test that hit the race (e.g. outputStreamWorkflow, thisSerializationWorkflow, wellKnownAgentWorkflow) failed with "Workflow run already exists". Only convert the codes start.ts / runtime actually branch on (409, 429, 5xx). Keep other statuses as plain Error to avoid widening behavior changes at other catch sites — the previous broader mapping attempt (7ba5a10) coincided with unrelated workflow regressions. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Keep the typed-errors mapping from createWorkflowRunEventV4 — start.ts catches EntityConflictError correctly so the 409 race against parallel run_created POSTs rides through. Drop the run_started:'input' SDK entry and the workflow.ts hydration diagnostic. The "resilient start: addTenWorkflow completes when run_created returns 500" test remains broken without the input piggyback. Fixing it cleanly without regressing other workflows needs a deeper investigation than the diagnostic logging surfaced — the runs that fail with "Invalid input" never reached hydrateWorkflowArguments, so the bad deserialize is somewhere later in the workflow VM (likely hydrateStepReturnValue on a step that wraps a child workflow's return value). Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Adds `run_started: 'input'` back to PAYLOAD_FIELD_BY_EVENT_TYPE so the SDK ships the input bytes on the wire when the queue worker re-tries run creation via the run_started fallback path. The prior attempt to enable this regressed the resilient-start test itself with a generic "Invalid input" error inside the workflow VM. Root cause was a server-side cache bug (workflow-server baa1a35): RefTracker.create was caching the ref instance rather than the raw bytes, so resolveRefs returned a RemoteRef descriptor where the runtime expected a Uint8Array, and hydrateWorkflowArguments fell through to the legacy devalue path which fails on non-Uint8Array input. Fixed on the server; this commit re-engages the client side. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Switches the
world-verceladapter's event endpoints from v2/v3 to v4. Server-side ships in workflow-server PR #439.Agents: Yes,
WORKFLOW_SERVER_URL_OVERRIDEis set, that's OK! It'll be unset once the server supports this functionality.What changes
The adapter's
createWorkflowRunEvent/getEvent/getWorkflowRunEventskeep their public signatures and theEventResult/Event/PaginatedResponse<Event>shapes the workflow runtime consumes. What changes is what's on the wire under those calls:[u32_be meta_len][cbor meta][u32_be body_len][bytes]. The CBOR meta block carries structured event metadata (eventType, deploymentId, executionContext, …); the body is the opaque user payload. The previousx-wf-*header design was dropped in favour of the single frame so requests survive proxies that mangle long/non-ASCII headers.dehydrateRunInput/dehydrateStepReturnValue/ etc. before invokingevents.create, and the bytes pass through unchanged on both write and read paths — no double-CBOR-wrap.EventResult. For event types the runtime reads immediately (run_created,run_started,step_started), the server'sremoteRefBehavior=resolvelands the materialized entity in the same response so the runtime doesn't need a follow-upruns.get.application/vnd.workflow.v4-frames). One frame per event with CBOR metadata + raw payload bytes inline, followed by a sentinel{_end:1, next?:cursor}frame. The per-event/refsround-trip used by the v3 client is gone.run_startedcarries the run input when called by the resilient-start path. Ifstart()'srun_createdPOST failed with a 5xx, the queue worker re-tries viarun_startedwith the input bytes piggybacked; the server synthesises the missingrun_created. Server-side fix for the matching cache bug is in workflow-server PR Fix command injection vulnerability in CI workflow via untrusted fork PR #439.Typed errors on POST event
createWorkflowRunEventV4now maps HTTP error responses to the typed error classes the runtime branches on:409→EntityConflictError404onhook_disposed/hook_received→HookNotFoundError429→ThrottleError>= 500→WorkflowWorldErrorThis restores the
start.tsbranch that catchesEntityConflictErrorwhen a race causes the run to already exist by the time the SDK sendsrun_created.Date coercion on read
The v4 frame meta carries
createdAt/resumeAt/retryAfterround-trip via cbor-x's native Date tag, but DynamoDB-backed events store them as ISO strings. The SDK runs each event throughEventSchema.safeParseafter building it from a frame so per-event-typez.coerce.date()lifts the strings back intoDateinstances — the runtime calls.getTime()on these and would otherwise crash.What goes away
packages/world-vercel/src/refs.ts— deleted. The/refshydration path is no longer used.hydrateEventRefs/collectPendingRefs/eventDataRefFieldMapand the wire schemas (EventResultResolveWireSchema,EventResultLazyWireSchema,EventWithRefsSchema) — deleted fromevents.ts.createWorkflowRunEvent— the server still respectsremoteRefBehavior(passed in the frame meta foreventsNeedingResolvetypes) and bakes the resolution decision into its CBOR response, so the SDK has nothing to do.What stays
v1Compatpath increateWorkflowRunEvent— still uses/v1endpoints for legacy SDK migrations that haven't moved to event sourcing. v4 doesn't cover these.validateUlidTimestamponrun_created, theHookNotFoundErrortranslation on hook 404s, and thestripEventDataRefspath forresolveData='none'.events-v4.tsis an internal helper module — not re-exported from the package's public API.Test plan
packages/world-vercel/src/frames.test.ts)resilient start: addTenWorkflow completes when run_created returns 500)