Skip to content

feat(world-vercel): support Hook minimum retention - #3286

Draft
NathanColosimo wants to merge 82 commits into
mainfrom
codex/hook-retention-vercel
Draft

feat(world-vercel): support Hook minimum retention#3286
NathanColosimo wants to merge 82 commits into
mainfrom
codex/hook-retention-vercel

Conversation

@NathanColosimo

@NathanColosimo NathanColosimo commented Aug 2, 2026

Copy link
Copy Markdown
Contributor

The backend PR must be merged and deployed first

Backend prerequisite: vercel/workflow-server#691

Summary

  • advertise Hook minimum-retention support from the Vercel World
  • run the existing Hook-retention end-to-end case against Vercel deployments
  • document the Vercel World's fixed 30-day maximum
  • keep the supported-World list accurate

The SDK remains unaware of the limit. workflow-server enforces it at the event-persistence boundary and returns HTTP 400; @workflow/world-vercel exposes that response through the existing WorkflowWorldError path.

Limits

  • every Vercel project may request up to 30 days
  • the limit does not depend on plan or Observability Plus
  • requests beyond 30 days fail before event payload upload or entity materialization

This PR is intentionally small: the wire field already flows through world-vercel. The capability is enabled only after the backend implements and deploys the storage semantics.

Stack

Verification

  • dependency build for the Local, Postgres, and Vercel World stack passed
  • world-vercel TypeScript check passed
  • all 39 world-vercel event tests passed
  • workflow-server production build and TypeScript check passed
  • focused V2 and V4 backend integration tests passed against the rebuilt server

Docs Preview

Page Preview
createHook() minimum retention v5
Vercel World limitation v5

NathanColosimo and others added 30 commits July 9, 2026 15:15
…core

# Conflicts:
#	packages/world/src/events.test.ts
Co-authored-by: Peter Wielander <mittgfu@gmail.com>
Signed-off-by: Nathan Colosimo <110621881+NathanColosimo@users.noreply.github.com>
…ostgres

# Conflicts:
#	docs/content/docs/v5/api-reference/workflow/create-hook.mdx
…n-vercel

# Conflicts:
#	docs/content/docs/v5/api-reference/workflow/create-hook.mdx
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.

2 participants