[experimental-services] job service types by ricardo-agz · Pull Request #15944 · vercel/vercel

ricardo-agz · 2026-04-14T16:13:09Z

Introduces the new "job" service type

migrates old 'cron' service to 'job' + 'schedule' trigger
ports 'worker' service to 'job' + 'queue' trigger

changeset-bot · 2026-04-14T16:13:15Z

🦋 Changeset detected

Latest commit: 3cff6dc

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 18 packages

Name	Type
@vercel/build-utils	Patch
vercel	Patch
@vercel/config	Patch
@vercel/fs-detectors	Patch
@vercel/python	Patch
@vercel/backends	Patch
@vercel/client	Patch
@vercel/elysia	Patch
@vercel/express	Patch
@vercel/fastify	Patch
@vercel/gatsby-plugin-vercel-builder	Patch
@vercel/h3	Patch
@vercel/hono	Patch
@vercel/koa	Patch
@vercel/nestjs	Patch
@vercel/node	Patch
@vercel/static-build	Patch
@vercel/cervel	Patch

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

github-actions · 2026-04-14T16:13:29Z

📦 CLI Tarball Ready

The Vercel CLI tarball for this PR is now available!

Quick Test

You can test this PR's CLI directly by running:

npx https://vercel-2r03v1z8o.vercel.sh/tarballs/vercel.tgz --help

Use in vercel.json

To use this CLI version in your project builds, add to your vercel.json:

{
  "build": {
    "env": {
      "VERCEL_CLI_VERSION": "vercel@https://vercel-2r03v1z8o.vercel.sh/tarballs/vercel.tgz"
    }
  }
}

Python Runtime Wheel

A vercel-runtime wheel was also built for this PR.
To use in your Python project builds, also set this environment variable:

VERCEL_RUNTIME_PYTHON="vercel-runtime @ https://vercel-2r03v1z8o.vercel.sh/tarballs/vercel_runtime-0.14.0.dev1776371171+3cff6dc-py3-none-any.whl"

Python Workers Wheel

A vercel-workers wheel was also built for this PR.
To use in your Python project builds, also set this environment variable:

VERCEL_WORKERS_PYTHON="vercel-workers @ https://vercel-2r03v1z8o.vercel.sh/tarballs/vercel_workers-0.1.0.dev1776371171+3cff6dc-py3-none-any.whl"

vercel · 2026-04-14T16:14:28Z

Low Risk — New experimental service type + trigger system with validation, tests, and backward compatibility for legacy cron/worker types.

types.ts: added job service type, JobTrigger union, ServiceQueueTopic interface
validate-config.ts: restructured schema to enforce trigger-specific required fields via oneOf
resolve.ts: added validation for job trigger combinations, backward-compatible trigger inference for legacy types

^{Assessed at 3cff6dc.}

github-actions · 2026-04-14T16:28:42Z

🧪 Unit Test Strategy

Comparing: 363696d → 3cff6dc (view diff)

Strategy: Code changed outside of a package - running all unit tests

⚠️ All unit tests will run because global code changes could impact all packages.

Affected packages - 40 (100%)

@vercel-internals/get-package-json
@vercel/backends
@vercel/build-utils
@vercel/cervel
@vercel/cli-auth
@vercel/client
@vercel/config
@vercel/detect-agent
@vercel/edge
@vercel/elysia
@vercel/error-utils
@vercel/express
@vercel/fastify
@vercel/firewall
@vercel/frameworks
@vercel/fs-detectors
@vercel/functions
@vercel/gatsby-plugin-vercel-builder
@vercel/go
@vercel/h3
@vercel/hono
@vercel/hydrogen
@vercel/koa
@vercel/nestjs
@vercel/next
@vercel/node
@vercel/oidc
@vercel/oidc-aws-credentials-provider
@vercel/python
@vercel/python-analysis
@vercel/redwood
@vercel/related-projects
@vercel/remix-builder
@vercel/routing-utils
@vercel/ruby
@vercel/rust
@vercel/static-build
@vercel/static-config
examples
vercel

Results

Unit tests: All affected packages will run unit tests
E2E tests: Running in parallel via E2E Tests workflow
Type checks: All affected packages will run type checks

This comment is automatically generated based on the affected testing strategy

Made-with: Cursor

vercel · 2026-04-14T17:08:16Z

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

Project	Deployment	Actions	Updated (UTC)
vercel	Ready	Preview, Comment	Apr 14, 2026 10:28pm

dnwpark

Looks good!

I saw '<dynamic>' schedules in cli commands index and services orchestrator, these are supposed to be placeholders?

ricardo-agz · 2026-04-16T21:54:32Z

Looks good!

I saw '<dynamic>' schedules in cli commands index and services orchestrator, these are supposed to be placeholders?

it's for the new vercel.cron sdk support which lets you register multiple schedules under a single service
<dynamic> is what we understand under the hood but we also made schedule optional so you don't have to write it out (it looks hacky)

This PR was opened by the [Changesets release](https://github.com/changesets/action) GitHub action. When you're ready to do a release, you can merge this and the packages will be published to npm automatically. If you're not ready to do a release yet, that's fine, whenever you add more changesets to main, this PR will be updated. # Releases ## vercel@51.6.0 ### Minor Changes - Add `vercel connex list` command ([#16018](#16018)) ### Patch Changes - Add OpenAPI-driven subcommand fallback behind `VERCEL_AUTO_API=1`. ([#15989](#15989)) When the env var is set, unrecognized CLI tokens are matched against OpenAPI tags and operation IDs from `openapi.vercel.sh`. This enables `vercel <tag> <operationId>` (e.g. `vercel user getAuthUser`) at the top level, and per-command fallthrough (e.g. `vercel projects getProject`) when a token doesn't match a native subcommand. When `x-vercel-cli.displayColumns` is present in the OpenAPI response schema, results render as a card (single object) or table (array) instead of raw JSON. - [experimental-services] add new job service type support ([#15944](#15944)) - Add naming and formatting utilities for OpenAPI CLI integration. ([#16010](#16010)) Introduces `foldNamingStyle` for case-insensitive matching across camelCase/kebab-case/snake_case, `humanReadableColumnLabel` for converting schema property paths to readable headers, and `inferCliSubcommandAliases` for auto-generating CLI aliases from HTTP methods. - Updated dependencies \[[`44d519b8660185754d8280517adbe0ab7268f540`](44d519b), [`2a6344e205910dafc05cb74a80f98165d95322d7`](2a6344e)]: - @vercel/detect-agent@1.2.3 - @vercel/build-utils@13.17.2 - @vercel/python@6.33.3 - @vercel/backends@0.0.64 - @vercel/elysia@0.1.67 - @vercel/express@0.1.77 - @vercel/fastify@0.1.70 - @vercel/go@3.5.0 - @vercel/h3@0.1.76 - @vercel/hono@0.2.70 - @vercel/hydrogen@1.3.6 - @vercel/koa@0.1.50 - @vercel/nestjs@0.2.71 - @vercel/next@4.16.8 - @vercel/node@5.7.9 - @vercel/redwood@2.4.12 - @vercel/remix-builder@5.7.2 - @vercel/ruby@2.3.2 - @vercel/rust@1.1.1 - @vercel/static-build@2.9.17 ## @vercel/backends@0.0.64 ### Patch Changes - Updated dependencies \[[`2a6344e205910dafc05cb74a80f98165d95322d7`](2a6344e)]: - @vercel/build-utils@13.17.2 ## @vercel/build-utils@13.17.2 ### Patch Changes - [experimental-services] add new job service type support ([#15944](#15944)) ## @vercel/cervel@0.0.51 ### Patch Changes - Updated dependencies \[]: - @vercel/backends@0.0.64 ## @vercel/client@17.3.6 ### Patch Changes - Updated dependencies \[[`2a6344e205910dafc05cb74a80f98165d95322d7`](2a6344e)]: - @vercel/build-utils@13.17.2 ## @vercel/config@0.2.1 ### Patch Changes - [experimental-services] add new job service type support ([#15944](#15944)) ## @vercel/detect-agent@1.2.3 ### Patch Changes - Add v0 to detect-agent supported agents ([#16016](#16016)) ## @vercel/elysia@0.1.67 ### Patch Changes - Updated dependencies \[]: - @vercel/node@5.7.9 ## @vercel/express@0.1.77 ### Patch Changes - Updated dependencies \[]: - @vercel/node@5.7.9 - @vercel/cervel@0.0.51 ## @vercel/fastify@0.1.70 ### Patch Changes - Updated dependencies \[]: - @vercel/node@5.7.9 ## @vercel/fs-detectors@5.18.2 ### Patch Changes - [experimental-services] add new job service type support ([#15944](#15944)) - Updated dependencies \[[`2a6344e205910dafc05cb74a80f98165d95322d7`](2a6344e)]: - @vercel/build-utils@13.17.2 ## @vercel/gatsby-plugin-vercel-builder@2.1.17 ### Patch Changes - Updated dependencies \[[`2a6344e205910dafc05cb74a80f98165d95322d7`](2a6344e)]: - @vercel/build-utils@13.17.2 ## @vercel/h3@0.1.76 ### Patch Changes - Updated dependencies \[]: - @vercel/node@5.7.9 ## @vercel/hono@0.2.70 ### Patch Changes - Updated dependencies \[]: - @vercel/node@5.7.9 ## @vercel/koa@0.1.50 ### Patch Changes - Updated dependencies \[]: - @vercel/node@5.7.9 ## @vercel/nestjs@0.2.71 ### Patch Changes - Updated dependencies \[]: - @vercel/node@5.7.9 ## @vercel/node@5.7.9 ### Patch Changes - Updated dependencies \[[`2a6344e205910dafc05cb74a80f98165d95322d7`](2a6344e)]: - @vercel/build-utils@13.17.2 ## @vercel/python@6.33.3 ### Patch Changes - [experimental-services] add new job service type support ([#15944](#15944)) ## @vercel/static-build@2.9.17 ### Patch Changes - Updated dependencies \[]: - @vercel/gatsby-plugin-vercel-builder@2.1.17 Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

job service implementation

a6cc23b

ricardo-agz changed the title ~~[experimental-service] job service types~~ [experimental-services] job service types Apr 14, 2026

cleanup

51add97

vercel Bot deployed to Preview April 14, 2026 16:26 View deployment

cleanup

26109ab

vercel Bot deployed to Preview April 14, 2026 16:53 View deployment

rename

81e4641

vercel Bot deployed to Preview April 14, 2026 16:59 View deployment

remove string[] from schedules

f8cb5b1

Made-with: Cursor

vercel Bot deployed to Preview – vercel April 14, 2026 17:09 View deployment

root cleanup

070d266

vercel Bot deployed to Preview – vercel April 14, 2026 17:48 View deployment

Create dry-glasses-turn.md

843078a

vercel Bot deployed to Preview – vercel April 14, 2026 17:51 View deployment

trigger fix

0143ce4

vercel Bot deployed to Preview – vercel April 14, 2026 18:57 View deployment

ricardo-agz marked this pull request as ready for review April 14, 2026 19:05

ricardo-agz requested review from a team, MatthewStanciu and agadzik as code owners April 14, 2026 19:05

e2e fix

5d020e0

vercel Bot deployed to Preview – vercel April 14, 2026 22:28 View deployment

ricardo-agz requested a review from nsidnev April 14, 2026 22:56

nsidnev approved these changes Apr 14, 2026

View reviewed changes

jeffsee55 approved these changes Apr 14, 2026

View reviewed changes

Merge branch 'main' into ricardo/job-service-implementation

59768cb

ricardo-agz marked this pull request as draft April 15, 2026 23:28

Merge branch 'main' into ricardo/job-service-implementation

358d735

vercel Bot deployed to Preview April 15, 2026 23:29 View deployment

cleanup

8cde612

vercel Bot deployed to Preview April 15, 2026 23:37 View deployment

add back cron support

c41d31c

vercel Bot deployed to Preview April 15, 2026 23:50 View deployment

ricardo-agz marked this pull request as ready for review April 15, 2026 23:50

test fix

d6208af

vercel Bot deployed to Preview April 16, 2026 00:18 View deployment

Merge branch 'main' into ricardo/job-service-implementation

fa9a411

vercel Bot deployed to Preview April 16, 2026 00:26 View deployment

test

6bdd7fb

vercel Bot deployed to Preview April 16, 2026 01:24 View deployment

ricardo-agz and others added 2 commits April 16, 2026 12:04

harden temp cleanup on test

61cabd3

Merge branch 'main' into ricardo/job-service-implementation

027fe87

vercel Bot deployed to Preview April 16, 2026 19:06 View deployment

dnwpark approved these changes Apr 16, 2026

View reviewed changes

Comment thread packages/python/src/entrypoint.ts Outdated

Comment thread packages/fs-detectors/src/services/resolve.ts

pr comment

3cff6dc

vercel Bot deployed to Preview April 16, 2026 20:27 View deployment

ricardo-agz merged commit 2a6344e into main Apr 16, 2026
262 of 265 checks passed

ricardo-agz deleted the ricardo/job-service-implementation branch April 16, 2026 21:55

vercel-cli-release-bot mentioned this pull request Apr 16, 2026

Version Packages #16006

Merged

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

[experimental-services] job service types#15944

[experimental-services] job service types#15944
ricardo-agz merged 19 commits into
mainfrom
ricardo/job-service-implementation

ricardo-agz commented Apr 14, 2026 •

edited

Loading

Uh oh!

changeset-bot Bot commented Apr 14, 2026 •

edited

Loading

Uh oh!

github-actions Bot commented Apr 14, 2026 •

edited

Loading

Uh oh!

vercel Bot commented Apr 14, 2026 •

edited

Loading

Uh oh!

github-actions Bot commented Apr 14, 2026 •

edited

Loading

Uh oh!

vercel Bot commented Apr 14, 2026 •

edited

Loading

Uh oh!

dnwpark left a comment

Uh oh!

Uh oh!

Uh oh!

ricardo-agz commented Apr 16, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

Conversation

ricardo-agz commented Apr 14, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

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

Uh oh!

🦋 Changeset detected

Uh oh!

github-actions Bot commented Apr 14, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

📦 CLI Tarball Ready

Quick Test

Use in vercel.json

Python Runtime Wheel

Python Workers Wheel

Uh oh!

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

Uh oh!

Uh oh!

github-actions Bot commented Apr 14, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🧪 Unit Test Strategy

Results

Uh oh!

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

Uh oh!

Uh oh!

dnwpark left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

ricardo-agz commented Apr 16, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

ricardo-agz commented Apr 14, 2026 •

edited

Loading

changeset-bot Bot commented Apr 14, 2026 •

edited

Loading

github-actions Bot commented Apr 14, 2026 •

edited

Loading

vercel Bot commented Apr 14, 2026 •

edited

Loading

github-actions Bot commented Apr 14, 2026 •

edited

Loading

vercel Bot commented Apr 14, 2026 •

edited

Loading