@cloudflare/sandbox 0.13.0-next.802.1 → 0.13.0-next.816.1

package/README.md

@@ -140,6 +140,13 @@ const recovered = await sandbox.getProcess(server.id);
 const running = await sandbox.listProcesses();
 ```
 
+Process and terminal handles hold a Workers RPC reference to the Sandbox. Declare them with `using` to release that reference when the handle goes out of scope; the process keeps running:
+
+```ts
+using build = await sandbox.exec(['npm', 'run', 'build']);
+const { exitCode } = await build.output({ encoding: 'utf8' });
+```
+
 `getProcess()` and `listProcesses()` are non-waking discovery calls: with no active runtime they return `null` and `[]` instead of starting a replacement. Handles, IDs, PIDs, statuses, retained logs, and cursors belong to the runtime that launched the process. After sleep, restart, or replacement, discovery cannot recover them and operations on an old handle fail with `STALE_PROCESS_HANDLE` rather than targeting a replacement runtime.
 
 Use `createTerminal()` for a persistent interactive PTY shell with input, resize, interrupt, terminate, and reconnect semantics. Terminals remain separate from supervised processes and are also runtime-local.

package/dist/bridge/index.js

@@ -1,8 +1,8 @@
 import "../errors-Bb3s6nBS.js";
 import "../errors--yR3zLC_.js";
 import "../dist-n_eniPAR.js";
-import { g as validateTunnelName, h as validatePort, m as SandboxSecurityError, n as getSandbox$1, x as streamFile } from "../sandbox-CaesWCLh.js";
-import "../extensions-BKL2zqL4.js";
+import { g as validateTunnelName, h as validatePort, m as SandboxSecurityError, n as getSandbox$1, x as streamFile } from "../sandbox-CpelK4pU.js";
+import "../extensions-038QzSIg.js";
 import { DurableObject, env } from "cloudflare:workers";
 import { Hono } from "hono";
 
@@ -2246,11 +2246,16 @@ function registerProcessRoutes(app, apiPrefix, sandboxBinding) {
 		if (!process) return errorJson("Process not found", "not_found", 404);
 		const replay = parseBoolean(c.req.query("replay"));
 		const follow = parseBoolean(c.req.query("follow"));
-		const logs = await process.logs({
-			since: c.req.query("since"),
-			replay,
-			follow
-		});
+		let logs;
+		try {
+			logs = await process.logs({
+				since: c.req.query("since"),
+				replay,
+				follow
+			});
+		} finally {
+			process[Symbol.dispose]();
+		}
 		return new Response(processLogsToSSE(logs), { headers: {
 			"Content-Type": "text/event-stream",
 			"Cache-Control": "no-cache"
@@ -2486,11 +2491,15 @@ function registerTerminalRoutes(app, apiPrefix, sandboxBinding) {
 		try {
 			const terminal = await sandbox.getTerminal(terminalId);
 			if (!terminal) return errorJson("Terminal not found", "not_found", 404);
-			return await terminal.connect(c.req.raw, {
-				cursor: c.req.query("cursor"),
-				cols,
-				rows
-			});
+			try {
+				return await terminal.connect(c.req.raw, {
+					cursor: c.req.query("cursor"),
+					cols,
+					rows
+				});
+			} finally {
+				terminal[Symbol.dispose]();
+			}
 		} catch (error) {
 			return terminalError(error);
 		}