Marc Codina

feat(sandbox-mock): add @vercel/sandbox-mock package (#245) Testing code that uses `@vercel/sandbox` means provisioning real sandboxes — slow, network-bound, and requiring credentials. In order to do that, customers must mock the whole Sandbox object, and they cannot run the integration tests until they go live (or they use real sandboxes). This new package, `@vercel/sandbox-mock`, provides a mock that aims to run a local sandbox with some constraints. We are mocking the API layer, and instead of relying into the Vercel services, we mock it by using `just-bash`. We have also configured changeset to maintain version parity between `@vercel/sandbox` and `@vercel/sandbox-mock`, to ensure that users and agents install the mock with the correct signatures. Testing --- - Each file that I have added contains unit tests (unless it is just types or interfaces). - There is a `packages/vercel-sandbox-mock/tests/compat.test.ts` test file which attempts to run the mock and real sandboxes, to ensure there is compatibility. - I ran the integration tests locally to ensure the compatibility tests work. 🤖 Generated with [Claude Code](https://claude.com/claude-code) --------- Co-authored-by: Claude Fable 5 <noreply@anthropic.com>

feat(packages/cli): support VCR command (#16883) Adds a `vercel vcr` command family to manage Vercel Container Registry (VCR) repositories and images from the CLI. Testing: - I have manually tests all commands, subcommands and combinations. - We have unit tests for each command, subcommand and utils file. vercel vcr ls (alias: `list`) --- List container registry repositories for a project: - `-p, --project` — Project name or ID (defaults to the linked project) - `--limit` — Number of results to return per page (default: 20, max: 1000) - `-c, --cursor` — Cursor from a previous page to continue listing from - `-F, --format` — Output format (json) Example: ``` ❯ vercel vcr ls Vercel CLI 54.18.6 (Node.js 20.18.0) Name ID Created final-test repo_AilNqzMU5CPZASoBX3xqoaCagoIg 1d ago test-1 repo_4etlr5w79O9LGx1E1dQTHes2kitD 8d ago test-multi-arch repo_bJDBJP0gKmP6SPZSc71oISy6BMEh 8d ago test1 repo_CVSY2AmyvugNN6WOTFKOF5VfeZ6r 8d ago test2 repo_7wsvDBp8xUaRFnzd5ev3dFrAaFT4 7d ago ❯ vercel vcr ls --limit 1 Vercel CLI 54.18.6 (Node.js 20.18.0) Name ID Created final-test repo_AilNqzMU5CPZASoBX3xqoaCagoIg 1d ago > More results available. Re-run with `--cursor eyJQSyI6IiR2Y3IjcHJvamVjdGlkX3Byal91NHl5emQzejVmcnRlaG50eWNlNWYzb21ucGVlIiwiU0siOiIkcmVwb3NpdG9yeV8xI25hbWVfZmluYWwtdGVzdCJ9`. ❯ vercel vcr ls --limit 1 --cursor eyJTSyI6IiRyZXBvc2l0b3J5XzEjbmFtZV9maW5hbC10ZXN0IiwiUEsiOiIkdmNyI3Byb2plY3RpZF9wcmpfdTR5eXpkM3o1ZnJ0ZWhudHljZTVmM29tbnBlZSJ9 Vercel CLI 54.18.6 (Node.js 20.18.0) Name ID Created test-1 repo_4etlr5w79O9LGx1E1dQTHes2kitD 8d ago > More results available. Re-run with `--cursor eyJQSyI6IiR2Y3IjcHJvamVjdGlkX3Byal91NHl5emQzejVmcnRlaG50eWNlNWYzb21ucGVlIiwiU0siOiIkcmVwb3NpdG9yeV8xI25hbWVfdGVzdC0xIn0`. ``` vercel vcr inspect (alias: `get`) --- Show details for a single repository: - `-p, --project` - `-F, --format` Example: ``` ❯ vercel vcr get final1 Vercel CLI 54.18.6 (Node.js 20.18.0) Error: VCR Repository not found. ❯ vercel vcr get test1 Vercel CLI 54.18.6 (Node.js 20.18.0) > Repository test1 Name test1 ID repo_CVSY2AmyvugNN6WOTFKOF5VfeZ6r Project ID prj_U4yYZD3z5fRtEhntyCE5F3oMnPEe Created 8d ago Updated 8d ago ❯ vercel vcr get repo_CVSY2AmyvugNN6WOTFKOF5VfeZ6r Vercel CLI 54.18.6 (Node.js 20.18.0) > Repository repo_CVSY2AmyvugNN6WOTFKOF5VfeZ6r Name test1 ID repo_CVSY2AmyvugNN6WOTFKOF5VfeZ6r Project ID prj_U4yYZD3z5fRtEhntyCE5F3oMnPEe Created 8d ago Updated 8d ago ``` vercel vcr add (alias: `create`) --- Create a container registry repository: - `-p, --project` - `-F, --format` Example: ``` ❯ vercel vcr add new-repo Vercel CLI 54.18.6 (Node.js 20.18.0) > Success! Created repository new-repo ❯ vercel vcr add "invalid repo name" Vercel CLI 54.18.6 (Node.js 20.18.0) Error: invalid repository name ``` vercel vcr rm (aliases: `remove`, `delete`) --- Delete a container registry repository: - `-p, --project` - `--yes` — Skip confirmation prompt - `-F, --format` Example: ``` ❯ vercel vcr rm new-repo Vercel CLI 54.18.6 (Node.js 20.18.0) ? Delete repository new-repo and all of its images? This cannot be undone. no > Canceled ❯ vercel vcr rm new-repo Vercel CLI 54.18.6 (Node.js 20.18.0) ? Delete repository new-repo and all of its images? This cannot be undone. yes > Success! Repository new-repo deleted ❯ vercel vcr rm new-repo --yes Vercel CLI 54.18.6 (Node.js 20.18.0) > Success! Repository new-repo deleted ❯ vercel vcr rm not-found --yes Vercel CLI 54.18.6 (Node.js 20.18.0) Error: VCR Repository not found. ``` vercel vcr tag ls --- List a repository's tags: - `-p, --project` - `--sort-by` — Field to sort by: `updatedAt` (default) or `tag` - `--sort-order` — Sort direction: `asc` or `desc` (default: `desc`) - `--limit` - `-c, --cursor` - `-F, --format` Example: ``` ❯ vercel vcr tag ls test1 Vercel CLI 54.18.6 (Node.js 20.18.0) Tag Image ID Digest Arch Size Created latest image_DIjo4083F2hnFlVzlcJdPGjO90FA b9610c5988ab amd64 36.9MB 6d ago v7 image_XvGyahtJG2AaPKROJJtLe2nlpYR0 776e8c66121f amd64 36.9MB 2d ago v5.5 image_KjcPZI0Zsan7pJCA3a6ZBPzsC03z 77a23d461dcb amd64 - 6d ago v5.4 image_KjcPZI0Zsan7pJCA3a6ZBPzsC03z ❯ vercel vcr tag ls test1 --limit 1 Vercel CLI 54.18.6 (Node.js 20.18.0) Tag Image ID Digest Arch Size Created latest image_DIjo4083F2hnFlVzlcJdPGjO90FA b9610c5988ab amd64 36.9MB 6d ago v7 image_XvGyahtJG2AaPKROJJtLe2nlpYR0 776e8c66121f amd64 36.9MB 2d ago > More results available. Re-run with `--cursor eyJQSyI6IiR2Y3IjcHJvamVjdGlkX3Byal91NHl5emQzejVmcnRlaG50eWNlNWYzb21ucGVlI3JlcG9zaXRvcnlpZF9yZXBvX2N2c3kyYW15dnVnbm42d290ZmtvZjV2ZmV6NnIiLCJTSyI6IiR0YWdfMSN0YWdfdjciLCJHU0kyUEsiOiIkdmNyI3Byb2plY3RpZF9wcmpfdTR5eXpkM3o1ZnJ0ZWhudHljZTVmM29tbnBlZSNyZXBvc2l0b3J5aWRfcmVwb19jdnN5MmFteXZ1Z25uNndvdGZrb2Y1dmZlejZyIiwiR1NJMlNLIjoiJHRhZ18xI3VwZGF0ZWRhdF8yMDI2LTA2LTMwdDExOjU1OjI0LjU1MHojdGFnX3Y3In0`. ❯ vercel vcr tag ls test1 --limit 1 --cursor eyJQSyI6IiR2Y3IjcHJvamVjdGlkX3Byal91NHl5emQzejVmcnRlaG50eWNlNWYzb21ucGVlI3JlcG9zaXRvcnlpZF9yZXBvX2N2c3kyYW15dnVnbm42d290ZmtvZjV2ZmV6NnIiLCJTSyI6IiR0YWdfMSN0YWdfdjciLCJHU0kyUEsiOiIkdmNyI3Byb2plY3RpZF9wcmpfdTR5eXpkM3o1ZnJ0ZWhudHljZTVmM29tbnBlZSNyZXBvc2l0b3J5aWRfcmVwb19jdnN5MmFteXZ1Z25uNndvdGZrb2Y1dmZlejZyIiwiR1NJMlNLIjoiJHRhZ18xI3VwZGF0ZWRhdF8yMDI2LTA2LTMwdDExOjU1OjI0LjU1MHojdGFnX3Y3In0 Vercel CLI 54.18.6 (Node.js 20.18.0) Tag Image ID Digest Arch Size Created v5.5 image_KjcPZI0Zsan7pJCA3a6ZBPzsC03z 77a23d461dcb amd64 - 6d ago > More results available. Re-run with `--cursor eyJTSyI6IiR0YWdfMSN0YWdfdjUuNSIsIkdTSTJQSyI6IiR2Y3IjcHJvamVjdGlkX3Byal91NHl5emQzejVmcnRlaG50eWNlNWYzb21ucGVlI3JlcG9zaXRvcnlpZF9yZXBvX2N2c3kyYW15dnVnbm42d290ZmtvZjV2ZmV6NnIiLCJHU0kyU0siOiIkdGFnXzEjdXBkYXRlZGF0XzIwMjYtMDYtMjZ0MTQ6MjI6MTAuMDI3eiN0YWdfdjUuNSIsIlBLIjoiJHZjciNwcm9qZWN0aWRfcHJqX3U0eXl6ZDN6NWZydGVobnR5Y2U1ZjNvbW5wZWUjcmVwb3NpdG9yeWlkX3JlcG9fY3ZzeTJhbXl2dWdubjZ3b3Rma29mNXZmZXo2ciJ9`. ❯ vercel vcr tag ls test1 --limit 5 --sort-order desc Vercel CLI 54.18.6 (Node.js 20.18.0) Tag Image ID Digest Arch Size Created latest image_DIjo4083F2hnFlVzlcJdPGjO90FA b9610c5988ab amd64 36.9MB 6d ago v7 image_XvGyahtJG2AaPKROJJtLe2nlpYR0 776e8c66121f amd64 36.9MB 2d ago v5.5 image_KjcPZI0Zsan7pJCA3a6ZBPzsC03z 77a23d461dcb amd64 - 6d ago v5.4 image_KjcPZI0Zsan7pJCA3a6ZBPzsC03z 77a23d461dcb amd64 - 6d ago v5.3 image_KjcPZI0Zsan7pJCA3a6ZBPzsC03z 77a23d461dcb amd64 - 6d ago v5.2 image_KjcPZI0Zsan7pJCA3a6ZBPzsC03z 77a23d461dcb amd64 - 6d ago > More results available. Re-run with `--cursor eyJQSyI6IiR2Y3IjcHJvamVjdGlkX3Byal91NHl5emQzejVmcnRlaG50eWNlNWYzb21ucGVlI3JlcG9zaXRvcnlpZF9yZXBvX2N2c3kyYW15dnVnbm42d290ZmtvZjV2ZmV6NnIiLCJHU0kyU0siOiIkdGFnXzEjdXBkYXRlZGF0XzIwMjYtMDYtMjZ0MTQ6MjI6MDguMTc0eiN0YWdfdjUuMiIsIkdTSTJQSyI6IiR2Y3IjcHJvamVjdGlkX3Byal91NHl5emQzejVmcnRlaG50eWNlNWYzb21ucGVlI3JlcG9zaXRvcnlpZF9yZXBvX2N2c3kyYW15dnVnbm42d290ZmtvZjV2ZmV6NnIiLCJTSyI6IiR0YWdfMSN0YWdfdjUuMiJ9`. ❯ vercel vcr tag ls test1 --limit 5 --sort-order asc Vercel CLI 54.18.6 (Node.js 20.18.0) Tag Image ID Digest Arch Size Created latest image_DIjo4083F2hnFlVzlcJdPGjO90FA b9610c5988ab amd64 36.9MB 6d ago v1 image_FoJbt52zZg4ND3e4Xo8kk2688P3l 3e708d77c9c7 amd64 - 9d ago v2 image_FoJbt52zZg4ND3e4Xo8kk2688P3l 3e708d77c9c7 amd64 - 9d ago v3 image_FoJbt52zZg4ND3e4Xo8kk2688P3l 3e708d77c9c7 amd64 - 9d ago v4 image_uMBM8wuJiiO2XC15MM0ereV99C6D a5041998de1a amd64 - 8d ago v5 image_KjcPZI0Zsan7pJCA3a6ZBPzsC03z 77a23d461dcb amd64 - 8d ago > More results available. Re-run with `--cursor eyJQSyI6IiR2Y3IjcHJvamVjdGlkX3Byal91NHl5emQzejVmcnRlaG50eWNlNWYzb21ucGVlI3JlcG9zaXRvcnlpZF9yZXBvX2N2c3kyYW15dnVnbm42d290ZmtvZjV2ZmV6NnIiLCJHU0kyUEsiOiIkdmNyI3Byb2plY3RpZF9wcmpfdTR5eXpkM3o1ZnJ0ZWhudHljZTVmM29tbnBlZSNyZXBvc2l0b3J5aWRfcmVwb19jdnN5MmFteXZ1Z25uNndvdGZrb2Y1dmZlejZyIiwiR1NJMlNLIjoiJHRhZ18xI3VwZGF0ZWRhdF8yMDI2LTA2LTI1dDEyOjA2OjIzLjAwMnojdGFnX3Y1IiwiU0siOiIkdGFnXzEjdGFnX3Y1In0`. ``` vercel vcr tag inspect (alias: `get`) --- Show details for a single tag - `-p, --project` - `-F, --format` Example: ``` ❯ vercel vcr tag inspect test1 latest Vercel CLI 54.18.6 (Node.js 20.18.0) > Tag latest ID image_DIjo4083F2hnFlVzlcJdPGjO90FA Digest sha256:b9610c5988ab5bde170d2097e9919d85374b94f71b5da3dfc54e2d2fb84c0292 Image vcr.vercel.com/marc-codina-enhanced-vtest314/my-sandbox-app/test1:latest Type manifest Arch amd64 Platform linux Size 36.9MB Status Ready Created 6d ago ``` vercel vcr image ls (alias: `list`) --- List images in a repository - `-p, --project` - `--untagged` — Only list images with no tags - `--limit` - `-c, --cursor` - `-F, --format` Example: ``` ❯ vercel vcr image ls test-multi-arch Vercel CLI 54.18.6 (Node.js 20.18.0) Image ID Digest Tags Type Status Arch Size Created image_XTPv9FRCWob68TkdGMUHC9vCXIAz b5d4d203118e v2-multi Image Ready (unoptimized) arm64 - 9d ago image_cTYQi67CmZRrEcfcN1AoyFWz5uqp ee86c2a4150c v1-multi Index - - - 9d ago image_MyBxVlhU2sqIdqDhj7rgf8GomXXX d133e81440a1 <none> Image Ready amd64 - 9d ago image_M9GocfXxMOlXQMKHadFGcXKyVwws cb2fa5d87cea <none> Image Ready (unoptimized) arm64 - 9d ago ❯ vercel vcr image ls test-multi-arch --untagged Vercel CLI 54.18.6 (Node.js 20.18.0) Image ID Digest Tags Type Status Arch Size Created image_MyBxVlhU2sqIdqDhj7rgf8GomXXX d133e81440a1 <none> Image Ready amd64 - 9d ago image_M9GocfXxMOlXQMKHadFGcXKyVwws cb2fa5d87cea <none> Image Ready (unoptimized) arm64 - 9d ago ``` vercel vcr image inspect (alias: `get`) --- Show details for a single image identified by that tag - `-p, --project` - `-F, --format` Example: ``` ❯ vercel vcr image inspect test-multi-arch image_XTPv9FRCWob68TkdGMUHC9vCXIAz Vercel CLI 54.18.6 (Node.js 20.18.0) > Image image_XTPv9FRCWob68TkdGMUHC9vCXIAz ID image_XTPv9FRCWob68TkdGMUHC9vCXIAz Digest sha256:b5d4d203118e450612633d43d2a7ea590c75864c9d83a4e11f2ff1a28e37269f Image vcr.vercel.com/marc-codina-enhanced-vtest314/my-sandbox-app/test-multi-arch@sha256:b5d4d203118e450612633d43d2a7ea590c75864c9d83a4e11f2ff1a28e37269f Type manifest Arch arm64 Platform linux Size - Status Ready (unoptimized) Created 9d ago Tags v2-multi ``` vercel vcr image rm (aliases: `remove`, `delete`) --- Delete an image from a repository - `-p, --project` - `--yes` - `-F, --format` Example: ``` ❯ vercel vcr image ls test2 Vercel CLI 54.18.6 (Node.js 20.18.0) Image ID Digest Tags Type Status Arch Size Created image_zB8fkwDdBRD4Q3DHT5okMKuc94GT afd01ff13078 v3-multi Index - - - 8d ago image_DIWiDpFcDSh3gyMGQo9Ek4jR5UcD eb09066b7857 <none> Image Ready amd64 - 8d ago image_Ml0PUBaNT8SRrYXDOOEiFedAsAEs 63deb08d9c41 <none> Image Ready (unoptimized) arm64 - 8d ago ❯ vercel vcr image rm test2 image_Ml0PUBaNT8SRrYXDOOEiFedAsAEs Vercel CLI 54.18.6 (Node.js 20.18.0) ? Delete image image_Ml0PUBaNT8SRrYXDOOEiFedAsAEs from test2? This cannot be undone. yes > Success! Image image_Ml0PUBaNT8SRrYXDOOEiFedAsAEs deleted ❯ vercel vcr image ls test2 Vercel CLI 54.18.6 (Node.js 20.18.0) Image ID Digest Tags Type Status Arch Size Created image_zB8fkwDdBRD4Q3DHT5okMKuc94GT afd01ff13078 v3-multi Index - - - 8d ago image_DIWiDpFcDSh3gyMGQo9Ek4jR5UcD eb09066b7857 <none> Image Ready amd64 - 8d ago ``` --------- Co-authored-by: Claude Sonnet 5 <noreply@anthropic.com>

feat(sandbox,vercel-sandbox): multi-region support (#301) Enable multi-region for sandboxes and snapshots. When we show the region, if it is not defined, we default to `iad1`, which is where we place sandboxes/snapshots by default. Example of creating a sandbox (now we also show the region): ``` ❯ sandbox create ✅ Sandbox silver-colossal-wren-WU4M8Y created. │ team: marc-codina-enhanced-vtest314 │ region: iad1 │ project: my-sandbox-app-tmp ╰ connect with: sandbox ssh silver-colossal-wren-WU4M8Y ``` Example of creating a sandbox with failover regions: ``` sandbox create --region cle1 --failover-regions sfo1,iad1 ✅ Sandbox scarlet-vitreous-woodpecker-kkjYfK created. │ team: marc-codina-enhanced-vtest314 │ region: cle1 │ project: my-sandbox-app-tmp ╰ connect with: sandbox ssh scarlet-vitreous-woodpecker-kkjYfK ``` Example of updating an existing sandbox region and failover regions: ``` ❯ sandbox config list crimson-chronic-mackerel-pbh3WM FIELD VALUE Region cle1 Failover regions sfo1, iad1 ... ❯ sandbox config failover-regions crimson-chronic-mackerel-pbh3WM sfo1 ✅ Configuration updated for sandbox crimson-chronic-mackerel-pbh3WM ╰ failover-regions: sfo1 ❯ sandbox config region crimson-chronic-mackerel-pbh3WM iad1 ✅ Configuration updated for sandbox crimson-chronic-mackerel-pbh3WM ╰ region: iad1 ❯ sandbox config list crimson-chronic-mackerel-pbh3WM FIELD VALUE Region iad1 Failover regions sfo1 ... ``` Notes: - We are not validating the regions, so that if in the future we add more, old sandbox versions keep working. --------- Co-authored-by: Claude Fable 5 <noreply@anthropic.com> Co-authored-by: Tom Lienard <tom.lienrd@gmail.com>

[cli] Add vercel vcr build and vercel vcr push (#17226) We are improving the `vercel vcr` command line so that we include: - `vercel vcr build <engine>` - `vercel vcr push <engine>` Formats: ``` vercel vcr build <engine> [path] [name[:tag]] [--push] [--platform] [-- engine commands] vercel vcr push <engine> [name[:tag]] ``` --------- Co-authored-by: Claude Fable 5 <noreply@anthropic.com>

[sandbox-sdk] adopt the new snapshot defaults (#300) The API changed its snapshot defaults (endpoints with major versions), but the SDK, CLI and Skill still targeted the previous versions. These are the new defaults: - Snapshots expire after **7 days** instead of 30. - Persistent sandboxes get a `{ count: 1, deleteEvicted: true }` retention policy by default. - `keepLastSnapshots: null` (CLI: `--keep-last-snapshots 0`) disables the limit and keeps every snapshot until it expires. --------- Co-authored-by: Claude Opus 5 <noreply@anthropic.com> Co-authored-by: Tom Lienard <tom.lienrd@gmail.com>

feat(cli): support vcr login <engine> command (#16900) Support the new `vercel vcr login <engine>` command. Examples of valid operations: ``` ❯ vercel vcr login docker Vercel CLI 54.18.7 (Node.js 20.18.0) > Success! Logged in to vcr.vercel.com as oidc (docker). ❯ vercel vcr login podman Vercel CLI 54.18.7 (Node.js 20.18.0) > Success! Logged in to vcr.vercel.com as oidc (podman). ``` Examples of invalid operations: ``` ❯ vercel vcr login Vercel CLI 54.18.7 (Node.js 20.18.0) Error: Missing engine. Choose one of: docker, podman, buildah. ❯ vercel vcr login podman Vercel CLI 54.18.7 (Node.js 20.18.0) Error: `podman` is not installed or not on your PATH. Install it and try again. ❯ vercel vcr login invalid Vercel CLI 54.18.7 (Node.js 20.18.0) Error: Invalid value for engine: "invalid". Must be one of: docker, podman, buildah. ``` --------- Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>

feat(sandbox,vercel-sandbox): support the image parameter from a sandbox (#253) Support, in the SDK/CLI, the `image` parameter. We already supported it when creating sandboxes with image, but now we also support showing it. In the CLI, we show it under `runtime/image` as they are both mutually exclusive. And in the future, `image` will be replacing runtime. In the SDK, we just added a new `image` property to sandbox. Notes: there are also some other changes made by the linter. --------- Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>

Improve cli errors (#226) Improve the CLI errors by: - Adding a top handler, so that when the CLI errors at the top-level, we still try to stylize the error and even when we can't, we try to show a friendly error. - Support more error codes during API requests (e.g. 400, 429, etc.) - Now we detect API timeouts. --------- Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

patch(vercel-sandbox,sandbox): improve CLI auth error messages and do not fail when a team is invalid (#225) Small improvements: - Do not fail when a team is not valid and does not pass the Zod validations. Continue processing the other teams. - Do not fail when a team has no `updatedAt`. When customer has limited privileges over a team, they do not get this field. Now it is marked as optional. - Mask the internal error when authenticating.

feat(vercel-sandbox): support the fork API (#258) Instead of implementing the Fork on the client-side, use the new API endpoint that implements the sandbox fork. --------- Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>