feat!: replace global registry with Workflows

[fantix]

Depends on #95

Instead of:

from vercel.workflow import *

@workflow
async def my_workflow():
    await my_step()
    ...

@step
async def my_step():
    ...

w/ vercel.json:

{
  "experimentalServices": {
    "my_workflow": {
      "type": "worker",
      "entrypoint": "backend/mypkg/myworkflow.py",
      "topics": ["__wkf_step_", "__wkf_workflow_"]
    }
}

Now we are aiming for:

from vercel import workflow

wf = workflow.Workflows()

@wf.workflow
async def my_workflow():
    await my_step()
    ...

@wf.step
async def my_step():
    ...

w/ vercel.json:

{
  "experimentalServices": {
    "my_workflow": {
      "type": "job",
      "trigger": "workflow",
      "root": "backend",
      "entrypoint": "mypkg.myworkflow:wf"
    }
}

[vercel]

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

Project	Deployment	Actions	Updated (UTC)
vercel-py	Ready	Preview	Apr 14, 2026 10:37pm