withruntime 0.21.0 → 0.33.0

package/dist/types.d.ts

@@ -133,8 +133,9 @@ export type CreateSandbox = {
     onLeaseEnd?: "pause" | "stop" | "delete";
     /** Pause after this many seconds in which nothing happens in it: no
      * request, no command or terminal running, no open connection, no network
-     * traffic and no CPU use. Default 60 unless persistent; 0 never;
-     * otherwise 10 to 86400. A request wakes it again. */
+     * traffic and no CPU use. Default 300 unless persistent; 0 never;
+     * otherwise 60 to 86400 (a shorter time is raised to 60). A request wakes
+     * it again. */
     idlePauseSeconds?: number;
     /** A request to a paused sandbox wakes it. Default true. */
     autoWake?: boolean;
@@ -165,7 +166,7 @@ export type CreateSandbox = {
     snapshot?: string;
     /** One to 16 ids of your own sandboxes or snapshots. The new sandbox starts
      * on a server none of them is on, and stays apart if its start is moved.
-     * With no other server that has room, the create answers 409 `no_capacity`
+     * With no other server that has room, the create answers 503 `no_capacity`
      * and nothing is made or charged. A copy of a snapshot starts only where that
      * snapshot is kept, so a `snapshot` with `spreadFrom` naming its server also
      * answers `no_capacity`. */
@@ -197,6 +198,16 @@ export type OutOfMemory = {
     /** What to do: a larger memoryMiB, or a program that uses less. */
     hint: string;
 };
+/** What a command run with `traceFiles` opened and wrote, until it exited. */
+export type TracedFiles = {
+    /** Every file and directory it, or anything it started, opened: sorted
+     * absolute paths, links resolved; a directory (a listing) ends in "/". */
+    read: string[];
+    /** Every file it wrote. */
+    written: string[];
+    /** Some paths are missing: the lists are not the whole story. */
+    truncated: boolean;
+};
 export type CommandResult = {
     exitCode: number | null;
     stdout: string;
@@ -208,6 +219,8 @@ export type CommandResult = {
     processId?: string;
     replayed?: boolean;
     outOfMemory?: OutOfMemory;
+    /** With `traceFiles` only. */
+    files?: TracedFiles;
 };
 export type ExecOptions = {
     cwd?: string;
@@ -226,6 +239,9 @@ export type ExecOptions = {
     onStderr?: (text: string) => unknown;
     /** Throw CommandError when the exit code is not 0. */
     check?: boolean;
+    /** Answer `files`: what the command read and wrote, for keying a cache by
+     * what a test really read. */
+    traceFiles?: boolean;
     signal?: AbortSignal;
     idempotencyKey?: string;
 };
@@ -265,6 +281,8 @@ export type OutputEvent = {
     timedOut: boolean;
     durationMs?: number;
     outOfMemory?: OutOfMemory;
+    /** An exec with `traceFiles`. */
+    files?: TracedFiles;
 } | {
     type: "truncated";
     droppedBytes: number;
@@ -302,6 +320,19 @@ export type FileEntry = {
     group?: string;
     symlinkTarget?: string;
 };
+/** A signed link to one file of a sandbox (POST .../files:link): `url` opens
+ * with no API key, GET to download (Range works) or PUT to upload, until
+ * `expiresAt`. */
+export type FileLink = {
+    url: string;
+    method: "GET" | "PUT";
+    path: string;
+    sandboxId: string;
+    expiresAt: string;
+    filename?: string;
+    maxBytes?: number;
+    archive?: boolean;
+};
 /** GET /v1/usage. Money is integer microdollars in strings (1,000,000 = $1),
  * exact past 2^53: available = credited - spent - expired - held. */
 export type Usage = {
@@ -457,7 +488,7 @@ export type SandboxSettings = {
     /** A request to a paused sandbox wakes it. */
     autoWake?: boolean;
     /** Pause after this many seconds with no activity, counted from now; 0
-     * never, otherwise 10 to 86400. */
+     * never, otherwise 60 to 86400 (a shorter time is raised to 60). */
     idlePauseSeconds?: number;
     /** Keep it running until you stop it, while credit lasts, and keep its disk
      * after a stop. Paid only. */

package/dist/vercel/errors.d.ts

@@ -45,7 +45,7 @@ export declare function translate(error: unknown, sandboxName?: string): unknown
 export declare function guard<T>(work: () => Promise<T>, sandboxName?: string): Promise<T>;
 /** A node:fs-style error, as Vercel's `sandbox.fs` throws. */
 export declare function fsError(code: "ENOENT" | "EEXIST" | "EISDIR" | "ENOTDIR" | "EACCES" | "ENOTEMPTY" | "EINVAL", syscall: string, path: string): Error & {
-    code: "ENOENT" | "EEXIST" | "ENOTDIR" | "EISDIR" | "EACCES" | "ENOTEMPTY" | "EINVAL";
+    code: "ENOENT" | "ENOTDIR" | "EEXIST" | "EISDIR" | "EACCES" | "ENOTEMPTY" | "EINVAL";
     errno: number;
     syscall: string;
     path: string;

package/dist/vercel/errors.js

@@ -1,4 +1,5 @@
 import { RuntimeError } from "../errors.js";
+import { productSwitchedOff } from "../switched-off.js";
 /** An error answer from the API. `response.status` is the HTTP status, and
  * `json` is `{ error: { code, message } }` as Vercel's is. */
 export class APIError extends Error {
@@ -69,7 +70,7 @@ export function translate(error, sandboxName) {
     ]
         .filter(Boolean)
         .join("\n");
-    if (error.status === 503 && error.code.endsWith("_unavailable"))
+    if (productSwitchedOff(error))
         return new NotSupportedError(error.code.replace(/_unavailable$/, ""), error.hint ?? "", message);
     if (error.status < 200 || error.status > 599)
         return error;

package/dist/vercel/snapshot.js

@@ -9,10 +9,12 @@ function statusOf(state) {
 }
 /** Vercel's snapshots always expire. Runtime's has no end date while it is kept
  * for as long as the account has credit; it is then taken at the longest a
- * snapshot is kept, a year from when it was made. */
+ * snapshot can be kept from now, a year, which the server moves on with it.
+ * Until 19 October 2026 this said a year from when it was made, a date that
+ * would have passed while the snapshot was still kept. */
 function expiresAtOf(snapshot) {
     return snapshot.expiresAt === null
-        ? Date.parse(snapshot.createdAt) + 365 * 86_400_000
+        ? Math.max(Date.parse(snapshot.createdAt), Date.now()) + 365 * 86_400_000
         : Date.parse(snapshot.expiresAt);
 }
 function metadataOf(snapshot) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "withruntime",
-  "version": "0.21.0",
+  "version": "0.33.0",
   "license": "Apache-2.0",
   "mcpName": "com.withruntime/runtime",
   "type": "module",
@@ -57,6 +57,7 @@
     },
     "./agents": {
       "types": "./dist/agents/index.d.ts",
+      "browser": "./dist/agents/browser.js",
       "import": "./dist/agents/index.js",
       "default": "./dist/agents/index.js"
     },
@@ -70,6 +71,16 @@
       "import": "./dist/builds/index.js",
       "default": "./dist/builds/index.js"
     },
+    "./ci": {
+      "types": "./dist/ci/index.d.ts",
+      "import": "./dist/ci/index.js",
+      "default": "./dist/ci/index.js"
+    },
+    "./apps": {
+      "types": "./dist/apps/index.d.ts",
+      "import": "./dist/apps/index.js",
+      "default": "./dist/apps/index.js"
+    },
     "./e2b": {
       "types": "./dist/e2b/index.d.ts",
       "import": "./dist/e2b/index.js",
@@ -135,6 +146,11 @@
       "import": "./dist/sprites/index.js",
       "default": "./dist/sprites/index.js"
     },
+    "./fly": {
+      "types": "./dist/fly/index.d.ts",
+      "import": "./dist/fly/index.js",
+      "default": "./dist/fly/index.js"
+    },
     "./freestyle": {
       "types": "./dist/freestyle/index.d.ts",
       "import": "./dist/freestyle/index.js",
@@ -180,9 +196,9 @@
     "node": ">=22.12"
   },
   "scripts": {
-    "build": "tsc -p tsconfig.build.json",
-    "check-types": "tsc --noEmit",
-    "lint": "eslint",
+    "build": "node ../typescript-config/tsc5.mjs -p tsconfig.build.json",
+    "check-types": "tsgo --noEmit",
+    "lint": "oxlint -c ../eslint-config/oxlint.json --ignore-pattern 'dist/**' --ignore-pattern 'tests/fixtures/modal/**'",
     "test": "bun test"
   },
   "devDependencies": {
@@ -202,7 +218,6 @@
     "@types/bun": "^1.4.0",
     "@types/node": "^20",
     "ai": "7.0.87",
-    "eslint": "^9",
     "groq-sdk": "1.6.0",
     "openai": "7.23.0",
     "together-ai": "0.55.0",
@@ -227,6 +242,7 @@
     "./dist/tar.js": "./dist/browser-stub.js",
     "./dist/image-context.js": "./dist/browser-stub.js",
     "./dist/credentials.js": "./dist/browser-stub.js",
+    "./dist/agents-file.js": "./dist/browser-stub.js",
     "undici": false
   },
   "keywords": [
@@ -242,7 +258,8 @@
     "llm"
   ],
   "dependencies": {
-    "undici": "^7.29.1"
+    "undici": "^7.29.1",
+    "yaml": "^2.8.1"
   },
   "peerDependencies": {
     "@ai-sdk/harness": "^1.0.0",