@cloudflare/sandbox 0.7.14 → 0.7.16

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { $ as DirectoryBackup, A as DesktopStopResponse, At as WaitForPortOptions, B as ExecuteResponse, Bt as CreateContextOptions, C as ClickOptions, Ct as ProcessStartResult, D as DesktopStartOptions, Dt as SessionOptions, E as DesktopClient, Et as SandboxOptions, F as ScreenshotRegion, Ft as ExecuteRequest, G as HttpClientOptions, H as BaseApiResponse, Ht as ExecutionResult, I as ScreenshotResponse, It as ExposePortRequest, J as SessionRequest, K as RequestConfig, L as ScrollDirection, Lt as StartProcessRequest, M as ScreenSizeResponse, Mt as isExecResult, N as ScreenshotBytesResponse, Nt as isProcess, O as DesktopStartResponse, Ot as StreamOptions, P as ScreenshotOptions, Pt as isProcessStatus, Q as BucketProvider, R as TypeOptions, Rt as PtyOptions, S as WriteFileRequest, St as ProcessOptions, T as Desktop, Tt as RestoreBackupResult, U as ContainerStub, Ut as RunCodeOptions, V as BackupClient, Vt as Execution, W as ErrorResponse, X as BaseExecOptions, Y as BackupOptions, Z as BucketCredentials, _ as GitClient, _t as ProcessCleanupResult, a as CreateSessionRequest, at as FileMetadata, b as MkdirRequest, bt as ProcessListResult, c as DeleteSessionResponse, ct as GitCheckoutResult, d as ProcessClient, dt as LogEvent, et as ExecEvent, f as PortClient, ft as MountBucketOptions, g as GitCheckoutRequest, gt as Process, h as InterpreterClient, ht as PortListResult, i as CommandsResponse, it as FileChunk, j as KeyInput, jt as WatchOptions, k as DesktopStatusResponse, kt as WaitForLogResult, l as PingResponse, lt as ISandbox, m as ExecutionCallbacks, mt as PortExposeResult, n as getSandbox, nt as ExecResult, o as CreateSessionResponse, ot as FileStreamEvent, p as UnexposePortRequest, pt as PortCloseResult, q as ResponseHandler, r as SandboxClient, rt as ExecutionSession, s as DeleteSessionRequest, st as FileWatchSSEEvent, t as Sandbox, tt as ExecOptions, u as UtilityClient, ut as ListFilesOptions, v as FileClient, vt as ProcessInfoResult, w as CursorPositionResponse, wt as ProcessStatus, x as ReadFileRequest, xt as ProcessLogsResult, y as FileOperationRequest, yt as ProcessKillResult, z as CommandClient, zt as CodeContext } from "./sandbox-CUee1P3v.js";
+import { $ as DirectoryBackup, A as DesktopStopResponse, At as WaitForPortOptions, B as ExecuteResponse, Bt as CreateContextOptions, C as ClickOptions, Ct as ProcessStartResult, D as DesktopStartOptions, Dt as SessionOptions, E as DesktopClient, Et as SandboxOptions, F as ScreenshotRegion, Ft as ExecuteRequest, G as HttpClientOptions, H as BaseApiResponse, Ht as ExecutionResult, I as ScreenshotResponse, It as ExposePortRequest, J as SessionRequest, K as RequestConfig, L as ScrollDirection, Lt as StartProcessRequest, M as ScreenSizeResponse, Mt as isExecResult, N as ScreenshotBytesResponse, Nt as isProcess, O as DesktopStartResponse, Ot as StreamOptions, P as ScreenshotOptions, Pt as isProcessStatus, Q as BucketProvider, R as TypeOptions, Rt as PtyOptions, S as WriteFileRequest, St as ProcessOptions, T as Desktop, Tt as RestoreBackupResult, U as ContainerStub, Ut as RunCodeOptions, V as BackupClient, Vt as Execution, W as ErrorResponse, X as BaseExecOptions, Y as BackupOptions, Z as BucketCredentials, _ as GitClient, _t as ProcessCleanupResult, a as CreateSessionRequest, at as FileMetadata, b as MkdirRequest, bt as ProcessListResult, c as DeleteSessionResponse, ct as GitCheckoutResult, d as ProcessClient, dt as LogEvent, et as ExecEvent, f as PortClient, ft as MountBucketOptions, g as GitCheckoutRequest, gt as Process, h as InterpreterClient, ht as PortListResult, i as CommandsResponse, it as FileChunk, j as KeyInput, jt as WatchOptions, k as DesktopStatusResponse, kt as WaitForLogResult, l as PingResponse, lt as ISandbox, m as ExecutionCallbacks, mt as PortExposeResult, n as getSandbox, nt as ExecResult, o as CreateSessionResponse, ot as FileStreamEvent, p as UnexposePortRequest, pt as PortCloseResult, q as ResponseHandler, r as SandboxClient, rt as ExecutionSession, s as DeleteSessionRequest, st as FileWatchSSEEvent, t as Sandbox, tt as ExecOptions, u as UtilityClient, ut as ListFilesOptions, v as FileClient, vt as ProcessInfoResult, w as CursorPositionResponse, wt as ProcessStatus, x as ReadFileRequest, xt as ProcessLogsResult, y as FileOperationRequest, yt as ProcessKillResult, z as CommandClient, zt as CodeContext } from "./sandbox-DKzgVy6K.js";
 import { a as DesktopCoordinateErrorContext, d as ErrorResponse$1, f as OperationType, i as BackupRestoreContext, l as ProcessExitedBeforeReadyContext, n as BackupExpiredContext, o as DesktopErrorContext, p as ErrorCode, r as BackupNotFoundContext, s as InvalidBackupConfigContext, t as BackupCreateContext, u as ProcessReadyTimeoutContext } from "./contexts-CeQR115r.js";
 
 //#region src/errors/classes.d.ts

package/dist/index.js

@@ -832,6 +832,12 @@ var HttpTransport = class extends BaseTransport {
 //#endregion
 //#region src/clients/transport/ws-transport.ts
 /**
+* Default timeout values (all in milliseconds)
+*/
+const DEFAULT_REQUEST_TIMEOUT_MS = 12e4;
+const DEFAULT_STREAM_IDLE_TIMEOUT_MS = 3e5;
+const DEFAULT_CONNECT_TIMEOUT_MS = 3e4;
+/**
 * WebSocket transport implementation
 *
 * Multiplexes HTTP-like requests over a single WebSocket connection.
@@ -930,7 +936,7 @@ var WebSocketTransport = class extends BaseTransport {
 	* parent Container class that supports the WebSocket protocol.
 	*/
 	async connectViaFetch() {
-		const timeoutMs = this.config.connectTimeoutMs ?? 3e4;
+		const timeoutMs = this.config.connectTimeoutMs ?? DEFAULT_CONNECT_TIMEOUT_MS;
 		const controller = new AbortController();
 		const timeout = setTimeout(() => controller.abort(), timeoutMs);
 		try {
@@ -966,7 +972,7 @@ var WebSocketTransport = class extends BaseTransport {
 	*/
 	connectViaWebSocket() {
 		return new Promise((resolve, reject) => {
-			const timeoutMs = this.config.connectTimeoutMs ?? 3e4;
+			const timeoutMs = this.config.connectTimeoutMs ?? DEFAULT_CONNECT_TIMEOUT_MS;
 			const timeout = setTimeout(() => {
 				this.cleanup();
 				reject(/* @__PURE__ */ new Error(`WebSocket connection timeout after ${timeoutMs}ms`));
@@ -1014,7 +1020,7 @@ var WebSocketTransport = class extends BaseTransport {
 			body
 		};
 		return new Promise((resolve, reject) => {
-			const timeoutMs = this.config.requestTimeoutMs ?? 12e4;
+			const timeoutMs = this.config.requestTimeoutMs ?? DEFAULT_REQUEST_TIMEOUT_MS;
 			const timeoutId = setTimeout(() => {
 				this.pendingRequests.delete(id);
 				reject(/* @__PURE__ */ new Error(`Request timeout after ${timeoutMs}ms: ${method} ${path}`));
@@ -1054,6 +1060,10 @@ var WebSocketTransport = class extends BaseTransport {
 	* This method waits for the first message before returning. If the server
 	* responds with an error (non-streaming response), it throws immediately
 	* rather than returning a stream that will error later.
+	*
+	* Uses an inactivity timeout instead of a total-duration timeout so that
+	* long-running streams (e.g. execStream from an agent) stay alive as long
+	* as data is flowing. The timer resets on every chunk or response message.
 	*/
 	async requestStream(method, path, body) {
 		await this.connect();
@@ -1065,16 +1075,21 @@ var WebSocketTransport = class extends BaseTransport {
 			path,
 			body
 		};
+		const idleTimeoutMs = this.config.streamIdleTimeoutMs ?? DEFAULT_STREAM_IDLE_TIMEOUT_MS;
 		return new Promise((resolveStream, rejectStream) => {
 			let streamController;
 			let firstMessageReceived = false;
-			const timeoutMs = this.config.requestTimeoutMs ?? 12e4;
-			const timeoutId = setTimeout(() => {
-				this.pendingRequests.delete(id);
-				const error = /* @__PURE__ */ new Error(`Stream timeout after ${timeoutMs}ms: ${method} ${path}`);
-				if (firstMessageReceived) streamController?.error(error);
-				else rejectStream(error);
-			}, timeoutMs);
+			const createIdleTimeout = () => {
+				return setTimeout(() => {
+					this.pendingRequests.delete(id);
+					const error = /* @__PURE__ */ new Error(`Stream idle timeout after ${idleTimeoutMs}ms: ${method} ${path}`);
+					if (firstMessageReceived) try {
+						streamController?.error(error);
+					} catch {}
+					else rejectStream(error);
+				}, idleTimeoutMs);
+			};
+			const timeoutId = createIdleTimeout();
 			const stream = new ReadableStream({
 				start: (controller) => {
 					streamController = controller;
@@ -1098,7 +1113,8 @@ var WebSocketTransport = class extends BaseTransport {
 			});
 			this.pendingRequests.set(id, {
 				resolve: (response) => {
-					clearTimeout(timeoutId);
+					const pending = this.pendingRequests.get(id);
+					if (pending?.timeoutId) clearTimeout(pending.timeoutId);
 					this.pendingRequests.delete(id);
 					if (!firstMessageReceived) {
 						firstMessageReceived = true;
@@ -1107,13 +1123,18 @@ var WebSocketTransport = class extends BaseTransport {
 							streamController?.close();
 							resolveStream(stream);
 						}
-					} else if (response.status >= 400) streamController?.error(/* @__PURE__ */ new Error(`Stream error: ${response.status} - ${JSON.stringify(response.body)}`));
+					} else if (response.status >= 400) try {
+						streamController?.error(/* @__PURE__ */ new Error(`Stream error: ${response.status} - ${JSON.stringify(response.body)}`));
+					} catch {}
 					else streamController?.close();
 				},
 				reject: (error) => {
-					clearTimeout(timeoutId);
+					const pending = this.pendingRequests.get(id);
+					if (pending?.timeoutId) clearTimeout(pending.timeoutId);
 					this.pendingRequests.delete(id);
-					if (firstMessageReceived) streamController?.error(error);
+					if (firstMessageReceived) try {
+						streamController?.error(error);
+					} catch {}
 					else rejectStream(error);
 				},
 				streamController: void 0,
@@ -1197,6 +1218,9 @@ var WebSocketTransport = class extends BaseTransport {
 	}
 	/**
 	* Handle a stream chunk message
+	*
+	* Resets the idle timeout on every chunk so that long-running streams
+	* with continuous output are not killed by the inactivity timer.
 	*/
 	handleStreamChunk(chunk) {
 		const pending = this.pendingRequests.get(chunk.id);
@@ -1208,6 +1232,7 @@ var WebSocketTransport = class extends BaseTransport {
 			pending.onFirstChunk();
 			pending.onFirstChunk = void 0;
 		}
+		if (pending.isStreaming) this.resetStreamIdleTimeout(chunk.id, pending);
 		if (!pending.streamController) {
 			if (!pending.bufferedChunks) pending.bufferedChunks = [];
 			const encoder$1 = new TextEncoder();
@@ -1233,6 +1258,20 @@ var WebSocketTransport = class extends BaseTransport {
 		}
 	}
 	/**
+	* Reset the idle timeout for a streaming request.
+	* Called on every incoming chunk to keep the stream alive while data flows.
+	*/
+	resetStreamIdleTimeout(id, pending) {
+		if (pending.timeoutId) clearTimeout(pending.timeoutId);
+		const idleTimeoutMs = this.config.streamIdleTimeoutMs ?? DEFAULT_STREAM_IDLE_TIMEOUT_MS;
+		pending.timeoutId = setTimeout(() => {
+			this.pendingRequests.delete(id);
+			if (pending.streamController) try {
+				pending.streamController.error(/* @__PURE__ */ new Error(`Stream idle timeout after ${idleTimeoutMs}ms`));
+			} catch {}
+		}, idleTimeoutMs);
+	}
+	/**
 	* Handle an error message
 	*/
 	handleError(error) {
@@ -3349,7 +3388,7 @@ function buildS3fsSource(bucket, prefix) {
 * This file is auto-updated by .github/changeset-version.ts during releases
 * DO NOT EDIT MANUALLY - Changes will be overwritten on the next version bump
 */
-const SDK_VERSION = "0.7.14";
+const SDK_VERSION = "0.7.16";
 
 //#endregion
 //#region src/sandbox.ts
@@ -4831,7 +4870,8 @@ var Sandbox = class Sandbox extends Container {
 		await this.client.utils.createSession({
 			id: sessionId,
 			...envPayload && { env: envPayload },
-			...options?.cwd && { cwd: options.cwd }
+			...options?.cwd && { cwd: options.cwd },
+			...options?.commandTimeoutMs !== void 0 && { commandTimeoutMs: options.commandTimeoutMs }
 		});
 		return this.getSessionWrapper(sessionId);
 	}