V2 SDK (named-sandboxes)

.changeset/beige-dogs-melt.md

@@ -0,0 +1,5 @@
+---
+"@vercel/sandbox": minor
+---
+
+Add L7 request matchers and forward URLs support to network policy rules.

.changeset/bumpy-keys-try.md

@@ -0,0 +1,6 @@
+---
+"@vercel/sandbox": minor
+"sandbox": minor
+---
+
+Rebase from main

.changeset/chilly-ducks-crash.md

@@ -0,0 +1,6 @@
+---
+"@vercel/sandbox": minor
+"sandbox": minor
+---
+
+Support pagination (CLI and SDK) when listing sandboxes, snapshots, sessions

.changeset/clean-jeans-build.md

@@ -0,0 +1,5 @@
+---
+"sandbox": patch
+---
+
+Default to `--sort-by=name` when using `--name-prefix` in `sandbox ls`

.changeset/cold-falcons-read.md

@@ -0,0 +1,5 @@
+---
+"sandbox": patch
+---
+
+Fix resume race-condition

.changeset/common-corners-leave.md

@@ -0,0 +1,5 @@
+---
+"sandbox": patch
+---
+
+Add support for patch + delete v2 endpoints for named sandboxes.

.changeset/cyan-bats-clap.md

@@ -0,0 +1,6 @@
+---
+"@vercel/sandbox": patch
+"sandbox": patch
+---
+
+Add support for tags

.changeset/dirty-cows-talk.md

@@ -0,0 +1,6 @@
+---
+"@vercel/sandbox": minor
+"sandbox": minor
+---
+
+Rename sandbox to session, namedSandbox to sandbox

.changeset/empty-trains-tie.md

@@ -0,0 +1,5 @@
+---
+"@vercel/sandbox": patch
+---
+
+Fix an 422 error when trying to resume a sandbox after snapshotting

.changeset/fair-pears-dream.md

@@ -0,0 +1,5 @@
+---
+"@vercel/sandbox": major
+---
+
+Introduce named and long-lived sandboxes

.changeset/fresh-pumas-own.md

@@ -0,0 +1,6 @@
+---
+"@vercel/sandbox": minor
+"sandbox": minor
+---
+
+Support default snapshot expiration for persistent sandboxes

.changeset/fresh-rings-rescue.md

@@ -0,0 +1,6 @@
+---
+"@vercel/sandbox": minor
+"sandbox": minor
+---
+
+Refactor the sandbox update and deprecate old network-policy update

.changeset/funny-areas-boil.md

@@ -0,0 +1,6 @@
+---
+"@vercel/sandbox": patch
+"sandbox": patch
+---
+
+Add Node 26 support.

.changeset/giant-dogs-report.md

@@ -0,0 +1,5 @@
+---
+"@vercel/sandbox": minor
+---
+
+Support a new method: Sandbox.getOrCreate()

.changeset/legal-rings-work.md

@@ -0,0 +1,5 @@
+---
+"@vercel/sandbox": patch
+---
+
+Add support for patch + delete v2 endpoints for named sandboxes.

.changeset/light-results-change.md

@@ -0,0 +1,5 @@
+---
+"@vercel/sandbox": minor
+---
+
+Rename snapshotOnShutdown to persistent

.changeset/open-planets-joke.md

@@ -0,0 +1,6 @@
+---
+"@vercel/sandbox": minor
+"sandbox": minor
+---
+
+Automatically scale memory to vcpu when updating

.changeset/pre.json

@@ -0,0 +1,48 @@
+{
+  "mode": "pre",
+  "tag": "beta",
+  "initialVersions": {
+    "ai-example": "0.1.1",
+    "charts-python-example": "0.1.4",
+    "dev-server-example": "0.1.4",
+    "sandbox-filesystem-snapshots": "0.0.8",
+    "install-packages-example": "0.1.4",
+    "private-repo-example": "0.1.4",
+    "sandbox-basics-example": "0.1.4",
+    "@vercel/pty-tunnel": "2.0.3",
+    "@vercel/pty-tunnel-server": "0.0.2",
+    "sandbox": "2.5.3",
+    "@vercel/sandbox": "1.7.1",
+    "workflow-code-runner": "0.1.3"
+  },
+  "changesets": [
+    "beige-dogs-melt",
+    "bumpy-keys-try",
+    "chilly-ducks-crash",
+    "clean-jeans-build",
+    "cold-falcons-read",
+    "common-corners-leave",
+    "cyan-bats-clap",
+    "dirty-cows-talk",
+    "empty-trains-tie",
+    "fair-pears-dream",
+    "fresh-pumas-own",
+    "fresh-rings-rescue",
+    "funny-areas-boil",
+    "giant-dogs-report",
+    "legal-rings-work",
+    "light-results-change",
+    "open-planets-joke",
+    "public-ears-heal",
+    "seven-olives-mate",
+    "slick-colts-learn",
+    "some-numbers-arrive",
+    "sour-rocks-grin",
+    "stale-hotels-grow",
+    "tangy-schools-like",
+    "tender-experts-cover",
+    "tough-roses-vanish",
+    "wet-goats-jam",
+    "whole-berries-juggle"
+  ]
+}

.changeset/public-ears-heal.md

@@ -0,0 +1,6 @@
+---
+"@vercel/sandbox": minor
+"sandbox": minor
+---
+
+Move to cursor pagination. Support new sortyBy parameter for lists. Support new statusUpdatedAt filter

.changeset/seven-olives-mate.md

@@ -0,0 +1,6 @@
+---
+"@vercel/sandbox": patch
+"sandbox": patch
+---
+
+Fix bug where the first ssh connection hang

.changeset/slick-colts-learn.md

@@ -0,0 +1,6 @@
+---
+"@vercel/sandbox": minor
+"sandbox": minor
+---
+
+Remove support for blocking parameter in .stop() and default to always blocking. Improve CLI output when stopping a sandbox.

.changeset/some-numbers-arrive.md

@@ -0,0 +1,5 @@
+---
+"sandbox": patch
+---
+
+Improve timeout hour format and example values

.changeset/sour-rocks-grin.md

@@ -0,0 +1,6 @@
+---
+"@vercel/sandbox": patch
+"sandbox": patch
+---
+
+Support updading current-snapshot-id of an existing sandbox

.changeset/stale-hotels-grow.md

@@ -0,0 +1,5 @@
+---
+"sandbox": major
+---
+
+Introduce long-lived sandboxes to the CLI

.changeset/tangy-schools-like.md

@@ -0,0 +1,6 @@
+---
+"@vercel/sandbox": minor
+"sandbox": minor
+---
+
+Lists now unwrap the json and return the items and pagination fields directly

.changeset/tender-experts-cover.md

@@ -0,0 +1,5 @@
+---
+"sandbox": patch
+---
+
+Add support for updating tags and displaying tags in config.

.changeset/tough-roses-vanish.md

@@ -0,0 +1,5 @@
+---
+"@vercel/sandbox": minor
+---
+
+Support new onResume parameter in Sandbox.create and Sandbox.get

.changeset/wet-goats-jam.md

@@ -0,0 +1,5 @@
+---
+"sandbox": minor
+---
+
+support new --name option for snapshots list, support new --stop option for run

.changeset/whole-berries-juggle.md

@@ -0,0 +1,6 @@
+---
+"@vercel/sandbox": patch
+"sandbox": patch
+---
+
+Fix JsDocs, messages and double-error message bug

.github/workflows/publish.yml

@@ -4,6 +4,7 @@ on:
   push:
     branches:
       - main
+      - named-sandboxes
   pull_request:
 
 env:
@@ -42,9 +43,23 @@ jobs:
       - name: Run tests
         run: pnpm test
 
+      - name: Verify beta pre-release mode
+        if: github.ref == 'refs/heads/named-sandboxes'
+        run: |
+          if [ ! -f .changeset/pre.json ]; then
+            echo "ERROR: .changeset/pre.json not found. named-sandboxes must be in changeset pre-release mode."
+            exit 1
+          fi
+          TAG=$(jq -r '.tag' .changeset/pre.json)
+          if [ "$TAG" != "beta" ]; then
+            echo "ERROR: Expected pre-release tag 'beta', got '$TAG'."
+            exit 1
+          fi
+          echo "Verified: changeset pre-release mode is active with tag 'beta'."
+
       - name: Create Release Pull Request
         uses: changesets/action@v1
-        if: github.ref == 'refs/heads/main'
+        if: github.ref == 'refs/heads/main' || github.ref == 'refs/heads/named-sandboxes'
         id: changesets
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
@@ -54,7 +69,7 @@ jobs:
           commitMode: github-api
 
       - name: Trigger Vercel CLI Sandbox Sync
-        if: steps.changesets.outputs.published == 'true'
+        if: github.ref == 'refs/heads/main' && steps.changesets.outputs.published == 'true'
         uses: actions/github-script@v7
         env:
           PUBLISHED_PACKAGES: ${{ steps.changesets.outputs.publishedPackages }}

examples/ai-example/app/actions.tsx

@@ -10,18 +10,18 @@ export async function createSandbox() {
   });
 
   return {
-    id: sandbox.sandboxId,
+    id: sandbox.name,
     routes: sandbox.routes,
     url: sandbox.domain(3000),
   };
 }
 
 export async function uploadFiles(params: {
-  sandboxId: string;
+  sandboxName: string;
   files: { path: string; content: string }[];
 }) {
   const sandbox = await Sandbox.get({
-    sandboxId: params.sandboxId,
+    name: params.sandboxName,
   });
 
   const files = params.files.map((file) => ({
@@ -56,11 +56,11 @@ export async function uploadFiles(params: {
 export async function runCommand(params: {
   args: string[];
   cmd: string;
-  sandboxId: string;
+  sandboxName: string;
   detached?: boolean;
 }) {
   const sandbox = await Sandbox.get({
-    sandboxId: params.sandboxId,
+    name: params.sandboxName,
   });
 
   const cmd = await sandbox.runCommand({

examples/ai-example/app/api/logs/route.ts

@@ -5,16 +5,16 @@ export const maxDuration = 120;
 export async function POST(request: Request) {
   const body = await request.json();
   const cmdId = body.cmdId;
-  const sandboxId = body.sandboxId;
+  const sandboxName = body.sandboxName;
 
-  if (!cmdId || !sandboxId) {
+  if (!cmdId || !sandboxName) {
     return new Response("Missing required parameters", { status: 400 });
   }
 
   const encoder = new TextEncoder();
   const stream = new ReadableStream({
     async start(controller) {
-      const sandbox = await Sandbox.get({ sandboxId });
+      const sandbox = await Sandbox.get({ name: sandboxName });
       const command = await sandbox.getCommand(cmdId);
 
       for await (const log of command.logs()) {