[world] Add various @fantasticfour org worlds to manifest by vinnymac · Pull Request #1964 · vercel/workflow

vinnymac · 2026-05-09T23:33:00Z

Let me know if you'd prefer if I tweak the changes here, as I have never submitted a community world before. The world implementations all currently target 4.1 Workflows. I've written test coverage for each world, and based the initial implementations for all of them based on world-postgres.

Is it possible for me to configure services in this manifest for other infra, such as mysql or infra emulation?

Summary

Registers seven community @fantasticfour/* world implementations in worlds-manifest.json so they're discoverable alongside the existing first-party and community worlds. Each entry includes its package name, repo/docs links, required env vars, and a credentials note when external infrastructure is needed.

Worlds added

ID	Package	Stack	Notes
`redis-simple`	`@fantasticfour/world-redis`	Pure Redis (Lists-based queue)	Self-hosted instance of Redis
`redis-bullmq`	`@fantasticfour/world-redis-bullmq`	Redis + BullMQ	Production-ready via BullMQ
`cloudflare`	`@fantasticfour/world-cloudflare`	Cloudflare Durable Objects	Edge runtime, requires deployment
`mysql`	`@fantasticfour/world-mysql`	Pure MySQL	Works with PlanetScale, RDS, Aiven, etc.
`azure`	`@fantasticfour/world-azure`	Azure Cosmos DB + Service Bus	Change Feed streaming
`nats-jetstream`	`@fantasticfour/world-nats-jetstream`	Self-hosted NATS JetStream	Clustering supported
`upstash`	`@fantasticfour/world-upstash`	Upstash Redis + QStash	Serverless / edge-ready

Other Worlds

I also have some other implementations for firestore Tasks, postgres + redis, mysql + redis, but they are more experimental and less practical.

changeset-bot · 2026-05-09T23:33:05Z

⚠️ No Changeset found

Latest commit: 4674ac4

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

vercel · 2026-05-09T23:33:10Z

@vinnymac is attempting to deploy a commit to the Vercel Labs Team on Vercel.

A member of the Team first needs to authorize it.

pranaygp · 2026-05-12T18:45:21Z

      "credentialsNote": "Requires JAZZ_API_KEY, JAZZ_WORKER_ACCOUNT, and JAZZ_WORKER_SECRET from Jazz Cloud"
+    },
+    {
+      "id": "redis-simple",


can we actually set this to fantasticfour-redis or similar? just realized we probably need to update the other community worlds too, to be less ambiguous. redis and redis-simple are confusing

I agree with you, it's a bit confusing at the moment if this was to be merged as-is. I was wondering how we were going to handle this. Figured this was the perfect time to begin a discussion to address it.

I can make that change if you like, and update the others to include the published org or username?

pranaygp · 2026-05-12T18:45:44Z

+      "setup": "pnpm exec fantasticfour-redis-setup"
+    },
+    {
+      "id": "redis-bullmq",


same here, let's update the id to fantasticfour-redis-bullmq?

pranaygp · 2026-05-12T18:46:34Z

+    {
+      "id": "cloudflare",
+      "type": "community",
+      "package": "@fantasticfour/world-cloudflare",


fantasticfour-cloudflare

pranaygp · 2026-05-12T18:46:56Z

+      "requiresDeployment": true
+    },
+    {
+      "id": "mysql",


pranaygp · 2026-05-12T18:47:02Z

+      "setup": "pnpm exec world-mysql-setup"
+    },
+    {
+      "id": "azure",


pranaygp · 2026-05-12T18:47:08Z

+      "credentialsNote": "Requires Azure Cosmos DB endpoint/key and Service Bus connection string"
+    },
+    {
+      "id": "nats-jetstream",


pranaygp · 2026-05-12T18:48:11Z

+      "credentialsNote": "Requires NATS server with JetStream enabled (CI does not yet support nats service containers)"
+    },
+    {
+      "id": "upstash",


vercel · 2026-05-12T19:19:35Z

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

Project	Deployment	Actions	Updated (UTC)
workflow-docs	Ready	Preview, Comment, Open in v0	May 12, 2026 7:21pm

Register the Fantastic Four community world packages in the worlds manifest and show the Redis variants in the Embedded docs section. Co-authored-by: Vincent Taverna <vinnymac@gmail.com> Signed-off-by: Pranay Prakash <pranay.gp@gmail.com>

github-actions · 2026-05-14T23:55:36Z

No backport to stable for e213447 (AI decision).

This commit modifies worlds-manifest.json and docs/components/worlds/WorldsFilteredGrid.tsx. The docs app file is outside docs/content/ and is not maintained on stable. The worlds manifest registers community worlds that target Workflow 4.1, which aligns with the main (beta) channel rather than the current stable GA series.

To override, re-run the Backport to stable workflow manually via workflow_dispatch with this commit SHA.

pranaygp · 2026-05-14T23:55:41Z

merged! just fyi I had to squash the commit because of signed commit requirements on the repo

pranaygp · 2026-05-19T22:58:46Z

Follow-up from trying to wire the Cloudflare community world into actual workbench e2e coverage: I think this is currently blocked by Workflow runtime itself, not by @fantasticfour/world-cloudflare's storage implementation.

@workflow/core still depends on Node's node:vm execution path (runInContext / VM contexts). In Cloudflare Workers, even with nodejs_compat, node:vm is exposed as a non-functional unenv stub. I verified a minimal Wrangler Worker importing node:vm and calling vm.runInContext() returns:

[unenv] vm.runInContext is not implemented yet!

So this world can still be useful as the Cloudflare-backed World adapter, but I don't think a workbench deployed directly to Workers can run the real Workflow e2e suite until Workflow has a Worker-compatible runtime path. I opened a central tracker here: #2028

The likely related unblocker is @TooTallNate's QuickJS snapshot runtime PR, which appears to remove the node:vm dependency as a side effect: #1300

I also opened the source-repo issue here: vinnymac/worlds#30

pranaygp reviewed May 12, 2026

View reviewed changes

Comment thread worlds-manifest.json Outdated

"requiresDeployment": true

},

{

"id": "mysql",

Copy link
Copy Markdown

Contributor

pranaygp May 12, 2026

Choose a reason for hiding this comment

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

same

pranaygp reviewed May 12, 2026

View reviewed changes

Comment thread worlds-manifest.json Outdated

"setup": "pnpm exec world-mysql-setup"

},

{

"id": "azure",

Copy link
Copy Markdown

Contributor

pranaygp May 12, 2026

Choose a reason for hiding this comment

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

same

pranaygp reviewed May 12, 2026

View reviewed changes

pranaygp requested a review from a team as a code owner May 12, 2026 18:50

vercel Bot deployed to Preview – workflow-docs May 12, 2026 19:21 View deployment

pranaygp approved these changes May 14, 2026

View reviewed changes

Add Fantastic Four community worlds

4674ac4

Register the Fantastic Four community world packages in the worlds manifest and show the Redis variants in the Embedded docs section. Co-authored-by: Vincent Taverna <vinnymac@gmail.com> Signed-off-by: Pranay Prakash <pranay.gp@gmail.com>

pranaygp force-pushed the vt/ff-worlds branch from 3d4f3ff to 4674ac4 Compare May 14, 2026 23:54

pranaygp merged commit e213447 into vercel:main May 14, 2026
4 of 20 checks passed

This was referenced May 19, 2026

Track Cloudflare Workers runtime support blocked by node:vm dependency #2028

Open

Cloudflare Workers e2e is blocked by Workflow's node:vm runtime dependency vinnymac/worlds#30

Open

Conversation

vinnymac commented May 9, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Worlds added

Other Worlds

Uh oh!

changeset-bot Bot commented May 9, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

⚠️ No Changeset found

Uh oh!

vercel Bot commented May 9, 2026

Uh oh!

pranaygp May 12, 2026

Choose a reason for hiding this comment

Uh oh!

vinnymac May 13, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

pranaygp May 12, 2026

Choose a reason for hiding this comment

Uh oh!

pranaygp May 12, 2026

Choose a reason for hiding this comment

Uh oh!

pranaygp May 12, 2026

Choose a reason for hiding this comment

Uh oh!

pranaygp May 12, 2026

Choose a reason for hiding this comment

Uh oh!

pranaygp May 12, 2026

Choose a reason for hiding this comment

Uh oh!

pranaygp May 12, 2026

Choose a reason for hiding this comment

Uh oh!

vercel Bot commented May 12, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Uh oh!

github-actions Bot commented May 14, 2026

Uh oh!

pranaygp commented May 14, 2026

Uh oh!

pranaygp commented May 19, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

vinnymac commented May 9, 2026 •

edited

Loading

changeset-bot Bot commented May 9, 2026 •

edited

Loading

vinnymac May 13, 2026 •

edited

Loading

vercel Bot commented May 12, 2026 •

edited

Loading