@vercel/sandbox 1.0.3 → 1.1.0

package/dist/sandbox.js

@@ -18,6 +18,9 @@ class Sandbox {
     get sandboxId() {
         return this.sandbox.id;
     }
+    get interactivePort() {
+        return this.sandbox.interactivePort ?? undefined;
+    }
     /**
      * The status of the sandbox.
      */
@@ -40,6 +43,7 @@ class Sandbox {
         const client = new api_client_1.APIClient({
             teamId: credentials.teamId,
             token: credentials.token,
+            fetch: params.fetch,
         });
         return client.listSandboxes({
             ...params,
@@ -57,6 +61,7 @@ class Sandbox {
         const client = new api_client_1.APIClient({
             teamId: credentials.teamId,
             token: credentials.token,
+            fetch: params?.fetch,
         });
         const privateParams = (0, types_1.getPrivateParams)(params);
         const sandbox = await client.createSandbox({
@@ -86,10 +91,13 @@ class Sandbox {
         const client = new api_client_1.APIClient({
             teamId: credentials.teamId,
             token: credentials.token,
+            fetch: params.fetch,
         });
+        const privateParams = (0, types_1.getPrivateParams)(params);
         const sandbox = await client.getSandbox({
             sandboxId: params.sandboxId,
             signal: params.signal,
+            ...privateParams,
         });
         return new Sandbox({
             client,
@@ -158,13 +166,21 @@ class Sandbox {
         });
         if (params.stdout || params.stderr) {
             (async () => {
-                for await (const log of command.logs({ signal: params.signal })) {
-                    if (log.stream === "stdout") {
-                        params.stdout?.write(log.data);
+                try {
+                    for await (const log of command.logs({ signal: params.signal })) {
+                        if (log.stream === "stdout") {
+                            params.stdout?.write(log.data);
+                        }
+                        else if (log.stream === "stderr") {
+                            params.stderr?.write(log.data);
+                        }
                     }
-                    else if (log.stream === "stderr") {
-                        params.stderr?.write(log.data);
+                }
+                catch (err) {
+                    if (params.signal?.aborted) {
+                        return;
                     }
+                    throw err;
                 }
             })();
         }
@@ -258,6 +274,11 @@ class Sandbox {
      * @param opts - Optional parameters.
      * @param opts.signal - An AbortSignal to cancel the operation.
      * @returns A promise that resolves when the timeout is extended
+     *
+     * @example
+     * const sandbox = await Sandbox.create({ timeout: ms('10m') });
+     * // Extends timeout by 5 minutes, to a total of 15 minutes.
+     * await sandbox.extendTimeout(ms('5m'));
      */
     async extendTimeout(duration, opts) {
         const response = await this.client.extendTimeout({
@@ -270,3 +291,4 @@ class Sandbox {
     }
 }
 exports.Sandbox = Sandbox;
+//# sourceMappingURL=sandbox.js.map

package/dist/sandbox.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sandbox.js","sourceRoot":"","sources":["../src/sandbox.ts"],"names":[],"mappings":"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"}

package/dist/utils/array.js

@@ -16,3 +16,4 @@ function array(item) {
             : [item]
         : [];
 }
+//# sourceMappingURL=array.js.map

package/dist/utils/array.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"array.js","sourceRoot":"","sources":["../../src/utils/array.ts"],"names":[],"mappings":";;AAQA,sBAMC;AAdD;;;;;;;GAOG;AACH,SAAgB,KAAK,CAAI,IAAqB;IAC5C,OAAO,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,IAAI;QACxC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;YACnB,CAAC,CAAC,IAAI;YACN,CAAC,CAAC,CAAC,IAAI,CAAC;QACV,CAAC,CAAC,EAAE,CAAC;AACT,CAAC"}

package/dist/utils/consume-readable.js

@@ -13,3 +13,4 @@ function consumeReadable(readable) {
         readable.on("end", () => resolve(Buffer.concat(chunks)));
     });
 }
+//# sourceMappingURL=consume-readable.js.map

package/dist/utils/consume-readable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"consume-readable.js","sourceRoot":"","sources":["../../src/utils/consume-readable.ts"],"names":[],"mappings":";;AAIA,0CAOC;AAXD;;;GAGG;AACH,SAAgB,eAAe,CAAC,QAA+B;IAC7D,OAAO,IAAI,OAAO,CAAS,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QAC7C,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QAC3C,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;QACnD,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IAC3D,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/utils/decode-base64-url.js

@@ -10,3 +10,4 @@ exports.decodeBase64Url = decodeBase64Url;
 function decodeBase64Url(base64Url) {
     return JSON.parse(Buffer.from(base64Url.replace(/-/g, "+").replace(/_/g, "/"), "base64").toString("utf8"));
 }
+//# sourceMappingURL=decode-base64-url.js.map

package/dist/utils/decode-base64-url.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decode-base64-url.js","sourceRoot":"","sources":["../../src/utils/decode-base64-url.ts"],"names":[],"mappings":";;AAMA,0CAOC;AAbD;;;;;GAKG;AACH,SAAgB,eAAe,CAAC,SAAiB;IAC/C,OAAO,IAAI,CAAC,KAAK,CACf,MAAM,CAAC,IAAI,CACT,SAAS,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,EAC/C,QAAQ,CACT,CAAC,QAAQ,CAAC,MAAM,CAAC,CACnB,CAAC;AACJ,CAAC"}

package/dist/utils/get-credentials.js

@@ -89,3 +89,4 @@ function getCredentialsFromOIDCToken(token) {
         throw new Error(`Invalid Vercel OIDC token: ${error instanceof Error ? error.message : String(error)}`);
     }
 }
+//# sourceMappingURL=get-credentials.js.map

package/dist/utils/get-credentials.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-credentials.js","sourceRoot":"","sources":["../../src/utils/get-credentials.ts"],"names":[],"mappings":"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"}

package/dist/utils/jwt-expiry.js

@@ -103,3 +103,4 @@ exports.JwtExpiry = JwtExpiry;
 function isJwtFormat(token) {
     return token.split(".").length === 3;
 }
+//# sourceMappingURL=jwt-expiry.js.map

package/dist/utils/jwt-expiry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jwt-expiry.js","sourceRoot":"","sources":["../../src/utils/jwt-expiry.ts"],"names":[],"mappings":";;;;;;AACA,2DAAsD;AACtD,uDAA2C;AAC3C,uCAAkD;AAClD,4CAAoB;AAEpB,+EAA+E;AAC/E,MAAM,SAAS,GAAG,IAAA,YAAE,EAAC,IAAI,CAAC,CAAC;AAE3B,MAAa,gBAAiB,SAAQ,KAAK;IAA3C;;QACE,SAAI,GAAG,kBAAkB,CAAC;IAC5B,CAAC;CAAA;AAFD,4CAEC;AAED;;;GAGG;AACH,MAAa,SAAS;IAIpB,MAAM,CAAC,SAAS,CAAC,KAAa;QAC5B,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC;YACxB,OAAO,IAAI,CAAC;QACd,CAAC;aAAM,CAAC;YACN,OAAO,IAAI,SAAS,CAAC,KAAK,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC;IAED;;;;OAIG;IACH,YAAqB,KAAa;QAAb,UAAK,GAAL,KAAK,CAAQ;QAChC,IAAI,CAAC;YACH,MAAM,aAAa,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;YAC1C,IAAI,CAAC,OAAO,GAAG,wBAAM,CAAC,KAAK,CAAC,IAAA,mCAAe,EAAC,aAAa,CAAC,CAAC,CAAC;YAC5D,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,IAAI,IAAI,CAAC;QAC7C,CAAC;QAAC,MAAM,CAAC;YACP,wDAAwD;YACxD,IAAI,CAAC,UAAU,GAAG,CAAC,CAAC;QACtB,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,OAAO;QACL,IAAI,IAAI,CAAC,UAAU,KAAK,IAAI,EAAE,CAAC;YAC7B,OAAO,KAAK,CAAC,CAAC,gCAAgC;QAChD,CAAC;QAED,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;QAC1C,MAAM,MAAM,GAAG,SAAS,GAAG,IAAI,CAAC;QAChC,OAAO,GAAG,GAAG,MAAM,GAAG,IAAI,CAAC,UAAU,CAAC;IACxC,CAAC;IAED;;;;OAIG;IACH,aAAa;QACX,OAAO,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACnE,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,OAAO;QACX,IAAI,CAAC;YACH,MAAM,UAAU,GAAG,MAAM,IAAA,yBAAkB,GAAE,CAAC;YAC9C,OAAO,IAAI,SAAS,CAAC,UAAU,CAAC,CAAC;QACnC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,gBAAgB,CAAC,8BAA8B,EAAE;gBACzD,KAAK;aACN,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,UAAU;QACd,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC;YACnB,OAAO,IAAI,CAAC,CAAC,kCAAkC;QACjD,CAAC;QAED,OAAO,IAAI,CAAC,OAAO,EAAE,CAAC;IACxB,CAAC;CACF;AA7ED,8BA6EC;AAED;;;;;GAKG;AACH,SAAS,WAAW,CAAC,KAAa;IAChC,OAAO,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC;AACvC,CAAC"}

package/dist/utils/normalizePath.js

@@ -29,3 +29,4 @@ function normalizePath(params) {
         : path_1.default.posix.join(params.cwd, params.filePath);
     return path_1.default.posix.relative(params.extractDir, basePath);
 }
+//# sourceMappingURL=normalizePath.js.map

package/dist/utils/normalizePath.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalizePath.js","sourceRoot":"","sources":["../../src/utils/normalizePath.ts"],"names":[],"mappings":";;;;;AAcA,sCAkBC;AAhCD,gDAAwB;AAExB;;;;;;;;;;;GAWG;AACH,SAAgB,aAAa,CAAC,MAI7B;IACC,IAAI,CAAC,cAAI,CAAC,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;QACvC,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC;IAC9C,CAAC;IAED,IAAI,CAAC,cAAI,CAAC,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC;QAC9C,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;IACjD,CAAC;IAED,MAAM,QAAQ,GAAG,cAAI,CAAC,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,QAAQ,CAAC;QACrD,CAAC,CAAC,cAAI,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC;QACvC,CAAC,CAAC,cAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;IAEjD,OAAO,cAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;AAC1D,CAAC"}

package/dist/utils/resolveSignal.js

@@ -19,3 +19,4 @@ function resolveSignal(signal) {
     }
     throw new Error(`Unknown signal name: ${String(signal)}`);
 }
+//# sourceMappingURL=resolveSignal.js.map

package/dist/utils/resolveSignal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveSignal.js","sourceRoot":"","sources":["../../src/utils/resolveSignal.ts"],"names":[],"mappings":";;AAcA,sCASC;AAvBD,MAAM,kBAAkB,GAAG;IACzB,MAAM,EAAE,CAAC;IACT,MAAM,EAAE,CAAC;IACT,OAAO,EAAE,CAAC;IACV,OAAO,EAAE,CAAC;IACV,OAAO,EAAE,EAAE;IACX,OAAO,EAAE,EAAE;IACX,OAAO,EAAE,EAAE;CACH,CAAC;AAMX,SAAgB,aAAa,CAAC,MAAc;IAC1C,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC/B,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,IAAI,MAAM,IAAI,kBAAkB,EAAE,CAAC;QACjC,OAAO,kBAAkB,CAAC,MAAM,CAAC,CAAC;IACpC,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,wBAAwB,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAC5D,CAAC"}

package/dist/utils/types.js

@@ -9,3 +9,4 @@ const getPrivateParams = (params) => {
     return Object.fromEntries(privateEntries);
 };
 exports.getPrivateParams = getPrivateParams;
+//# sourceMappingURL=types.js.map

package/dist/utils/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/utils/types.ts"],"names":[],"mappings":";;;AAUA;;GAEG;AACI,MAAM,gBAAgB,GAAG,CAAC,MAAe,EAAE,EAAE;IAClD,MAAM,cAAc,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CACjE,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,CACnB,CAAC;IACF,OAAO,MAAM,CAAC,WAAW,CAAC,cAAc,CAIvC,CAAC;AACJ,CAAC,CAAC;AATW,QAAA,gBAAgB,oBAS3B"}

package/dist/version.d.ts

@@ -1 +1 @@
-export declare const VERSION = "1.0.3";
+export declare const VERSION = "1.1.0";

package/dist/version.js

@@ -2,4 +2,5 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VERSION = void 0;
 // Autogenerated by inject-version.ts
-exports.VERSION = "1.0.3";
+exports.VERSION = "1.1.0";
+//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":";;;AAAA,qCAAqC;AACxB,QAAA,OAAO,GAAG,OAAO,CAAC"}

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "@vercel/sandbox",
-  "version": "1.0.3",
+  "version": "1.1.0",
   "description": "",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "private": false,
   "keywords": [],
   "author": "",
-  "license": "ISC",
+  "license": "MIT",
   "dependencies": {
     "@vercel/oidc": "^3.0.5",
     "async-retry": "1.3.3",

package/src/api-client/api-client.ts

@@ -25,16 +25,27 @@ import { Readable } from "stream";
 import { normalizePath } from "../utils/normalizePath";
 import { JwtExpiry } from "../utils/jwt-expiry";
 import { getPrivateParams, WithPrivate } from "../utils/types";
+import { RUNTIMES } from "../constants";
+
+export interface WithFetchOptions {
+  fetch?: typeof globalThis.fetch;
+}
 
 export class APIClient extends BaseClient {
   private teamId: string;
   private tokenExpiry: JwtExpiry | null;
 
-  constructor(params: { baseUrl?: string; teamId: string; token: string }) {
+  constructor(params: {
+    baseUrl?: string;
+    teamId: string;
+    token: string;
+    fetch?: typeof globalThis.fetch;
+  }) {
     super({
       baseUrl: params.baseUrl ?? "https://vercel.com/api",
       token: params.token,
       debug: false,
+      fetch: params.fetch,
     });
 
     this.teamId = params.teamId;
@@ -72,10 +83,15 @@ export class APIClient extends BaseClient {
     });
   }
 
-  async getSandbox(params: { sandboxId: string; signal?: AbortSignal }) {
+  async getSandbox(
+    params: WithPrivate<{ sandboxId: string; signal?: AbortSignal }>,
+  ) {
+    const privateParams = getPrivateParams(params);
+    let querystring = new URLSearchParams(privateParams).toString();
+    querystring = querystring ? `?${querystring}` : "";
     return parseOrThrow(
       SandboxAndRoutesResponse,
-      await this.request(`/v1/sandboxes/${params.sandboxId}`, {
+      await this.request(`/v1/sandboxes/${params.sandboxId}${querystring}`, {
         signal: params.signal,
       }),
     );
@@ -97,7 +113,7 @@ export class APIClient extends BaseClient {
         | { type: "tarball"; url: string };
       timeout?: number;
       resources?: { vcpus: number };
-      runtime?: "node22" | "python3.13" | (string & {});
+      runtime?: RUNTIMES | (string & {});
       signal?: AbortSignal;
     }>,
   ) {

package/src/api-client/base-client.ts

@@ -25,8 +25,13 @@ export class BaseClient {
   private baseUrl: string;
   private agent: Agent;
 
-  constructor(params: { debug?: boolean; baseUrl: string; token?: string }) {
-    this.fetch = withRetry(globalThis.fetch);
+  constructor(params: {
+    debug?: boolean;
+    baseUrl: string;
+    token?: string;
+    fetch?: typeof globalThis.fetch;
+  }) {
+    this.fetch = withRetry(params.fetch ?? globalThis.fetch);
     this.baseUrl = params.baseUrl;
     this.debug = params.debug ?? process.env.DEBUG_FETCH === "true";
     this.token = params.token;

package/src/api-client/validators.ts

@@ -18,6 +18,7 @@ export const Sandbox = z.object({
   createdAt: z.number(),
   cwd: z.string(),
   updatedAt: z.number(),
+  interactivePort: z.number().optional(),
 });
 
 export type SandboxRouteData = z.infer<typeof SandboxRoute>;

package/src/api-client/with-retry.ts

@@ -49,6 +49,9 @@ export function withRetry<T extends RequestInit>(
     try {
       return (await retry(async (bail) => {
         try {
+          if (opts.signal?.aborted) {
+            return bail(opts.signal.reason || new Error("Request aborted"));
+          }
           const response = await rawFetch(url, opts);
 
           /**
@@ -93,6 +96,14 @@ export function withRetry<T extends RequestInit>(
             return bail(error);
           }
 
+          /**
+           * If the signal was aborted meanwhile we were
+           * waiting, we bail from retrying.
+           */
+          if (opts.signal?.aborted) {
+            return bail(opts.signal.reason || new Error("Request aborted"));
+          }
+
           throw error;
         }
       }, retryOpts)) as Response;

package/src/command.test.ts

@@ -1,99 +1,103 @@
-import { expect, it, vi, beforeEach, afterEach } from "vitest";
+import { expect, it, vi, beforeEach, afterEach, describe } from "vitest";
 import { Sandbox } from "./sandbox";
 
-let sandbox: Sandbox;
+describe.skipIf(process.env.RUN_INTEGRATION_TESTS !== "1")("Command", () => {
+  let sandbox: Sandbox;
 
-beforeEach(async () => {
-  sandbox = await Sandbox.create();
-});
-
-afterEach(async () => {
-  await sandbox.stop();
-});
-
-it("supports more than one logs consumer", async () => {
-  const stdoutSpy = vi
-    .spyOn(process.stdout, "write")
-    .mockImplementation(() => true);
-
-  const cmd = await sandbox.runCommand({
-    cmd: "echo",
-    args: ["Hello World!"],
-    stdout: process.stdout,
+  beforeEach(async () => {
+    sandbox = await Sandbox.create();
   });
 
-  expect(await cmd.stdout()).toEqual("Hello World!\n");
-  expect(stdoutSpy).toHaveBeenCalledWith("Hello World!\n");
-});
-
-it("does not warn when there is only one logs consumer", async () => {
-  const warnSpy = vi.spyOn(console, "warn").mockImplementation(() => {});
-
-  const cmd = await sandbox.runCommand({
-    cmd: "echo",
-    args: ["Hello World!"],
+  afterEach(async () => {
+    await sandbox.stop();
   });
 
-  expect(await cmd.stdout()).toEqual("Hello World!\n");
-  expect(warnSpy).not.toHaveBeenCalled();
-});
-
-it("Kills a command with a SIGINT", async () => {
-  const cmd = await sandbox.runCommand({
-    cmd: "sleep",
-    args: ["200000"],
-    detached: true,
-  });
+  it("supports more than one logs consumer", async () => {
+    const stdoutSpy = vi
+      .spyOn(process.stdout, "write")
+      .mockImplementation(() => true);
 
-  await cmd.kill("SIGINT");
-  const result = await cmd.wait();
-  expect(result.exitCode).toBe(130); // 128 + 2
-});
+    const cmd = await sandbox.runCommand({
+      cmd: "echo",
+      args: ["Hello World!"],
+      stdout: process.stdout,
+    });
 
-it("Kills a command with a SIGTERM", async () => {
-  const cmd = await sandbox.runCommand({
-    cmd: "sleep",
-    args: ["200000"],
-    detached: true,
+    expect(await cmd.stdout()).toEqual("Hello World!\n");
+    expect(stdoutSpy).toHaveBeenCalledWith("Hello World!\n");
   });
 
-  await cmd.kill("SIGTERM");
+  it("does not warn when there is only one logs consumer", async () => {
+    const warnSpy = vi.spyOn(console, "warn").mockImplementation(() => {});
 
-  const result = await cmd.wait();
-  expect(result.exitCode).toBe(143); // 128 + 15
-});
+    const cmd = await sandbox.runCommand({
+      cmd: "echo",
+      args: ["Hello World!"],
+    });
 
-it("can execute commands with sudo", async () => {
-  const cmd = await sandbox.runCommand({
-    cmd: "env",
-    sudo: true,
-    env: {
-      FOO: "bar",
-    },
+    expect(await cmd.stdout()).toEqual("Hello World!\n");
+    expect(warnSpy).not.toHaveBeenCalled();
   });
 
-  expect(cmd.exitCode).toBe(0);
+  it("Kills a command with a SIGINT", async () => {
+    const cmd = await sandbox.runCommand({
+      cmd: "sleep",
+      args: ["200000"],
+      detached: true,
+    });
 
-  const output = await cmd.stdout();
-  expect(output).toContain("FOO=bar\n");
-  expect(output).toContain("USER=root\n");
-  expect(output).toContain("SUDO_USER=vercel-sandbox\n");
+    await cmd.kill("SIGINT");
+    const result = await cmd.wait();
+    expect(result.exitCode).toBe(130); // 128 + 2
+  });
 
-  const pathLine = output.split("\n").find((line) => line.startsWith("PATH="));
-  expect(pathLine).toBeDefined();
+  it("Kills a command with a SIGTERM", async () => {
+    const cmd = await sandbox.runCommand({
+      cmd: "sleep",
+      args: ["200000"],
+      detached: true,
+    });
 
-  const pathSegments = pathLine!.slice(5).split(":");
-  expect(pathSegments).toContain("/vercel/bin");
-  expect(pathSegments).toContain("/vercel/runtimes/node22/bin");
+    await cmd.kill("SIGTERM");
 
-  const dnf = await sandbox.runCommand({
-    cmd: "dnf",
-    args: ["install", "-y", "golang"],
-    sudo: true,
+    const result = await cmd.wait();
+    expect(result.exitCode).toBe(143); // 128 + 15
   });
 
-  expect(dnf.exitCode).toBe(0);
-
-  const which = await sandbox.runCommand("which", ["go"]);
-  expect(await which.output()).toContain("/usr/bin/go");
+  it("can execute commands with sudo", async () => {
+    const cmd = await sandbox.runCommand({
+      cmd: "env",
+      sudo: true,
+      env: {
+        FOO: "bar",
+      },
+    });
+
+    expect(cmd.exitCode).toBe(0);
+
+    const output = await cmd.stdout();
+    expect(output).toContain("FOO=bar\n");
+    expect(output).toContain("USER=root\n");
+    expect(output).toContain("SUDO_USER=vercel-sandbox\n");
+
+    const pathLine = output
+      .split("\n")
+      .find((line) => line.startsWith("PATH="));
+    expect(pathLine).toBeDefined();
+
+    const pathSegments = pathLine!.slice(5).split(":");
+    expect(pathSegments).toContain("/vercel/bin");
+    expect(pathSegments).toContain("/vercel/runtimes/node22/bin");
+
+    const dnf = await sandbox.runCommand({
+      cmd: "dnf",
+      args: ["install", "-y", "golang"],
+      sudo: true,
+    });
+
+    expect(dnf.exitCode).toBe(0);
+
+    const which = await sandbox.runCommand("which", ["go"]);
+    expect(await which.output()).toContain("/usr/bin/go");
+  });
 });

package/src/constants.ts

@@ -0,0 +1 @@
+export type RUNTIMES = "node24" | "node22" | "python3.13";