@cloudflare/sandbox 0.5.2 → 0.5.3

package/.turbo/turbo-build.log

@@ -1,5 +1,5 @@
 
-> @cloudflare/sandbox@0.5.2 build
+> @cloudflare/sandbox@0.5.3 build
 > rm -rf dist && tsdown --config tsdown.config.ts
 
 ℹ tsdown v0.16.6 powered by rolldown v1.0.0-beta.51
@@ -7,17 +7,17 @@
 ℹ entry: src/index.ts, src/openai/index.ts
 ℹ tsconfig: tsconfig.json
 ℹ Build start
-ℹ dist/index.js                   100.84 kB │ gzip: 22.92 kB
+ℹ dist/index.js                   102.82 kB │ gzip: 23.33 kB
 ℹ dist/openai/index.js             10.42 kB │ gzip:  2.63 kB
-ℹ dist/index.js.map               214.92 kB │ gzip: 47.84 kB
-ℹ dist/sandbox-B3vJ541e.d.ts.map   60.94 kB │ gzip: 16.79 kB
+ℹ dist/index.js.map               219.05 kB │ gzip: 48.46 kB
+ℹ dist/sandbox-HQazw9bn.d.ts.map   61.69 kB │ gzip: 16.89 kB
 ℹ dist/dist-gVyG2H2h.js.map        30.14 kB │ gzip:  8.31 kB
 ℹ dist/openai/index.js.map         21.00 kB │ gzip:  5.13 kB
 ℹ dist/dist-gVyG2H2h.js            17.03 kB │ gzip:  5.39 kB
-ℹ dist/index.d.ts.map               8.84 kB │ gzip:  2.71 kB
+ℹ dist/index.d.ts.map               9.22 kB │ gzip:  2.82 kB
 ℹ dist/openai/index.d.ts.map        0.72 kB │ gzip:  0.37 kB
-ℹ dist/index.d.ts                  10.66 kB │ gzip:  3.21 kB
+ℹ dist/index.d.ts                  11.11 kB │ gzip:  3.32 kB
 ℹ dist/openai/index.d.ts            2.10 kB │ gzip:  0.81 kB
-ℹ dist/sandbox-B3vJ541e.d.ts       50.82 kB │ gzip: 11.69 kB
-ℹ 12 files, total: 528.43 kB
-✔ Build complete in 3705ms
+ℹ dist/sandbox-HQazw9bn.d.ts       51.36 kB │ gzip: 11.79 kB
+ℹ 12 files, total: 536.66 kB
+✔ Build complete in 3733ms

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @cloudflare/sandbox
 
+## 0.5.3
+
+### Patch Changes
+
+- [#204](https://github.com/cloudflare/sandbox-sdk/pull/204) [`55981f8`](https://github.com/cloudflare/sandbox-sdk/commit/55981f8802b4e0d3b65b947ef8ba7ae2bae183d7) Thanks [@whoiskatrin](https://github.com/whoiskatrin)! - add environment variables and working directory support to command exec
+
 ## 0.5.2
 
 ### Patch Changes

package/dist/index.d.ts

@@ -1,7 +1,25 @@
-import { $ as ProcessCleanupResult, A as HttpClientOptions, B as ExecutionSession, C as WriteFileRequest, D as BaseApiResponse, E as ExecuteResponse, F as BucketCredentials, G as ISandbox, H as FileMetadata, I as BucketProvider, J as MountBucketOptions, K as ListFilesOptions, L as ExecEvent, M as ResponseHandler, N as SessionRequest, O as ContainerStub, P as BaseExecOptions, Q as Process, R as ExecOptions, S as ReadFileRequest, T as ExecuteRequest, U as FileStreamEvent, V as FileChunk, W as GitCheckoutResult, X as PortExposeResult, Y as PortCloseResult, Z as PortListResult, _ as GitCheckoutRequest, _t as RunCodeOptions, a as CreateSessionRequest, at as ProcessStartResult, b as FileOperationRequest, c as DeleteSessionResponse, ct as SessionOptions, d as ProcessClient, dt as isProcess, et as ProcessInfoResult, f as ExposePortRequest, ft as isProcessStatus, g as InterpreterClient, gt as ExecutionResult, h as ExecutionCallbacks, ht as Execution, i as CommandsResponse, it as ProcessOptions, j as RequestConfig, k as ErrorResponse, l as PingResponse, lt as StreamOptions, m as UnexposePortRequest, mt as CreateContextOptions, n as getSandbox, nt as ProcessListResult, o as CreateSessionResponse, ot as ProcessStatus, p as PortClient, pt as CodeContext, q as LogEvent, r as SandboxClient, rt as ProcessLogsResult, s as DeleteSessionRequest, st as SandboxOptions, t as Sandbox, tt as ProcessKillResult, u as UtilityClient, ut as isExecResult, v as GitClient, w as CommandClient, x as MkdirRequest, y as FileClient, z as ExecResult } from "./sandbox-B3vJ541e.js";
+import { $ as ProcessInfoResult, A as RequestConfig, B as FileChunk, C as WriteFileRequest, D as ContainerStub, E as BaseApiResponse, F as BucketProvider, G as ListFilesOptions, H as FileStreamEvent, I as ExecEvent, J as PortCloseResult, K as LogEvent, L as ExecOptions, M as SessionRequest, N as BaseExecOptions, O as ErrorResponse, P as BucketCredentials, Q as ProcessCleanupResult, R as ExecResult, S as ReadFileRequest, T as ExecuteResponse, U as GitCheckoutResult, V as FileMetadata, W as ISandbox, X as PortListResult, Y as PortExposeResult, Z as Process, _ as GitCheckoutRequest, a as CreateSessionRequest, at as ProcessStatus, b as FileOperationRequest, c as DeleteSessionResponse, ct as StreamOptions, d as ProcessClient, dt as isProcessStatus, et as ProcessKillResult, f as ExposePortRequest, ft as CodeContext, g as InterpreterClient, gt as RunCodeOptions, h as ExecutionCallbacks, ht as ExecutionResult, i as CommandsResponse, it as ProcessStartResult, j as ResponseHandler, k as HttpClientOptions, l as PingResponse, lt as isExecResult, m as UnexposePortRequest, mt as Execution, n as getSandbox, nt as ProcessLogsResult, o as CreateSessionResponse, ot as SandboxOptions, p as PortClient, pt as CreateContextOptions, q as MountBucketOptions, r as SandboxClient, rt as ProcessOptions, s as DeleteSessionRequest, st as SessionOptions, t as Sandbox, tt as ProcessListResult, u as UtilityClient, ut as isProcess, v as GitClient, w as CommandClient, x as MkdirRequest, y as FileClient, z as ExecutionSession } from "./sandbox-HQazw9bn.js";
 
 //#region ../shared/dist/request-types.d.ts
 
+/**
+ * Request types for API calls to the container
+ * These types enforce the contract between the Durable Object client and container handlers
+ *
+ * IMPORTANT: These types must match the Zod schemas in:
+ * @repo/sandbox-container/src/validation/schemas.ts
+ */
+/**
+ * Request to execute a command
+ */
+interface ExecuteRequest {
+  command: string;
+  sessionId?: string;
+  background?: boolean;
+  timeoutMs?: number;
+  env?: Record<string, string>;
+  cwd?: string;
+}
 /**
  * Request to start a background process
  * Uses flat structure consistent with other endpoints

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":["ExecuteRequest","StartProcessRequest","Record","ReadFileRequest","WriteFileRequest","DeleteFileRequest","RenameFileRequest","MoveFileRequest","MkdirRequest","FileExistsRequest","ExposePortRequest","GitCheckoutRequest","SessionCreateRequest","SessionDeleteRequest","ErrorCode"],"sources":["../../shared/dist/request-types.d.ts","../src/file-stream.ts","../src/interpreter.ts","../src/request-handler.ts","../src/sse-parser.ts","../../shared/dist/errors/codes.d.ts","../src/storage-mount/errors.ts"],"sourcesContent":["/**\n * Request types for API calls to the container\n * These types enforce the contract between the Durable Object client and container handlers\n *\n * IMPORTANT: These types must match the Zod schemas in:\n * @repo/sandbox-container/src/validation/schemas.ts\n */\n/**\n * Request to execute a command\n */\nexport interface ExecuteRequest {\n    command: string;\n    sessionId?: string;\n    background?: boolean;\n    timeoutMs?: number;\n}\n/**\n * Request to start a background process\n * Uses flat structure consistent with other endpoints\n */\nexport interface StartProcessRequest {\n    command: string;\n    sessionId?: string;\n    processId?: string;\n    timeoutMs?: number;\n    env?: Record<string, string>;\n    cwd?: string;\n    encoding?: string;\n    autoCleanup?: boolean;\n}\n/**\n * Request to read a file\n */\nexport interface ReadFileRequest {\n    path: string;\n    encoding?: string;\n    sessionId?: string;\n}\n/**\n * Request to write a file\n */\nexport interface WriteFileRequest {\n    path: string;\n    content: string;\n    encoding?: string;\n    sessionId?: string;\n}\n/**\n * Request to delete a file\n */\nexport interface DeleteFileRequest {\n    path: string;\n    sessionId?: string;\n}\n/**\n * Request to rename a file\n */\nexport interface RenameFileRequest {\n    oldPath: string;\n    newPath: string;\n    sessionId?: string;\n}\n/**\n * Request to move a file\n */\nexport interface MoveFileRequest {\n    sourcePath: string;\n    destinationPath: string;\n    sessionId?: string;\n}\n/**\n * Request to create a directory\n */\nexport interface MkdirRequest {\n    path: string;\n    recursive?: boolean;\n    sessionId?: string;\n}\n/**\n * Request to check if a file or directory exists\n */\nexport interface FileExistsRequest {\n    path: string;\n    sessionId?: string;\n}\n/**\n * Request to expose a port\n */\nexport interface ExposePortRequest {\n    port: number;\n    name?: string;\n}\n/**\n * Request to clone a Git repository\n */\nexport interface GitCheckoutRequest {\n    repoUrl: string;\n    branch?: string;\n    targetDir?: string;\n    sessionId?: string;\n}\n/**\n * Request to create a session\n */\nexport interface SessionCreateRequest {\n    id?: string;\n    name?: string;\n    env?: Record<string, string>;\n    cwd?: string;\n}\n/**\n * Request to delete a session\n */\nexport interface SessionDeleteRequest {\n    sessionId: string;\n}\n//# sourceMappingURL=request-types.d.ts.map","/**\n * Centralized error code registry\n * Each code maps to a specific error type with consistent semantics\n */\nexport declare const ErrorCode: {\n    readonly FILE_NOT_FOUND: \"FILE_NOT_FOUND\";\n    readonly PERMISSION_DENIED: \"PERMISSION_DENIED\";\n    readonly FILE_EXISTS: \"FILE_EXISTS\";\n    readonly IS_DIRECTORY: \"IS_DIRECTORY\";\n    readonly NOT_DIRECTORY: \"NOT_DIRECTORY\";\n    readonly NO_SPACE: \"NO_SPACE\";\n    readonly TOO_MANY_FILES: \"TOO_MANY_FILES\";\n    readonly RESOURCE_BUSY: \"RESOURCE_BUSY\";\n    readonly READ_ONLY: \"READ_ONLY\";\n    readonly NAME_TOO_LONG: \"NAME_TOO_LONG\";\n    readonly TOO_MANY_LINKS: \"TOO_MANY_LINKS\";\n    readonly FILESYSTEM_ERROR: \"FILESYSTEM_ERROR\";\n    readonly COMMAND_NOT_FOUND: \"COMMAND_NOT_FOUND\";\n    readonly COMMAND_PERMISSION_DENIED: \"COMMAND_PERMISSION_DENIED\";\n    readonly INVALID_COMMAND: \"INVALID_COMMAND\";\n    readonly COMMAND_EXECUTION_ERROR: \"COMMAND_EXECUTION_ERROR\";\n    readonly STREAM_START_ERROR: \"STREAM_START_ERROR\";\n    readonly PROCESS_NOT_FOUND: \"PROCESS_NOT_FOUND\";\n    readonly PROCESS_PERMISSION_DENIED: \"PROCESS_PERMISSION_DENIED\";\n    readonly PROCESS_ERROR: \"PROCESS_ERROR\";\n    readonly PORT_ALREADY_EXPOSED: \"PORT_ALREADY_EXPOSED\";\n    readonly PORT_IN_USE: \"PORT_IN_USE\";\n    readonly PORT_NOT_EXPOSED: \"PORT_NOT_EXPOSED\";\n    readonly INVALID_PORT_NUMBER: \"INVALID_PORT_NUMBER\";\n    readonly INVALID_PORT: \"INVALID_PORT\";\n    readonly SERVICE_NOT_RESPONDING: \"SERVICE_NOT_RESPONDING\";\n    readonly PORT_OPERATION_ERROR: \"PORT_OPERATION_ERROR\";\n    readonly CUSTOM_DOMAIN_REQUIRED: \"CUSTOM_DOMAIN_REQUIRED\";\n    readonly GIT_REPOSITORY_NOT_FOUND: \"GIT_REPOSITORY_NOT_FOUND\";\n    readonly GIT_BRANCH_NOT_FOUND: \"GIT_BRANCH_NOT_FOUND\";\n    readonly GIT_AUTH_FAILED: \"GIT_AUTH_FAILED\";\n    readonly GIT_NETWORK_ERROR: \"GIT_NETWORK_ERROR\";\n    readonly INVALID_GIT_URL: \"INVALID_GIT_URL\";\n    readonly GIT_CLONE_FAILED: \"GIT_CLONE_FAILED\";\n    readonly GIT_CHECKOUT_FAILED: \"GIT_CHECKOUT_FAILED\";\n    readonly GIT_OPERATION_FAILED: \"GIT_OPERATION_FAILED\";\n    readonly BUCKET_MOUNT_ERROR: \"BUCKET_MOUNT_ERROR\";\n    readonly S3FS_MOUNT_ERROR: \"S3FS_MOUNT_ERROR\";\n    readonly MISSING_CREDENTIALS: \"MISSING_CREDENTIALS\";\n    readonly INVALID_MOUNT_CONFIG: \"INVALID_MOUNT_CONFIG\";\n    readonly INTERPRETER_NOT_READY: \"INTERPRETER_NOT_READY\";\n    readonly CONTEXT_NOT_FOUND: \"CONTEXT_NOT_FOUND\";\n    readonly CODE_EXECUTION_ERROR: \"CODE_EXECUTION_ERROR\";\n    readonly VALIDATION_FAILED: \"VALIDATION_FAILED\";\n    readonly INVALID_JSON_RESPONSE: \"INVALID_JSON_RESPONSE\";\n    readonly UNKNOWN_ERROR: \"UNKNOWN_ERROR\";\n    readonly INTERNAL_ERROR: \"INTERNAL_ERROR\";\n};\nexport type ErrorCode = (typeof ErrorCode)[keyof typeof ErrorCode];\n//# sourceMappingURL=codes.d.ts.map"],"mappings":"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"}
+{"version":3,"file":"index.d.ts","names":["ExecuteRequest","Record","StartProcessRequest","ReadFileRequest","WriteFileRequest","DeleteFileRequest","RenameFileRequest","MoveFileRequest","MkdirRequest","FileExistsRequest","ExposePortRequest","GitCheckoutRequest","SessionCreateRequest","SessionDeleteRequest","ErrorCode"],"sources":["../../shared/dist/request-types.d.ts","../src/file-stream.ts","../src/interpreter.ts","../src/request-handler.ts","../src/sse-parser.ts","../../shared/dist/errors/codes.d.ts","../src/storage-mount/errors.ts"],"sourcesContent":["/**\n * Request types for API calls to the container\n * These types enforce the contract between the Durable Object client and container handlers\n *\n * IMPORTANT: These types must match the Zod schemas in:\n * @repo/sandbox-container/src/validation/schemas.ts\n */\n/**\n * Request to execute a command\n */\nexport interface ExecuteRequest {\n    command: string;\n    sessionId?: string;\n    background?: boolean;\n    timeoutMs?: number;\n    env?: Record<string, string>;\n    cwd?: string;\n}\n/**\n * Request to start a background process\n * Uses flat structure consistent with other endpoints\n */\nexport interface StartProcessRequest {\n    command: string;\n    sessionId?: string;\n    processId?: string;\n    timeoutMs?: number;\n    env?: Record<string, string>;\n    cwd?: string;\n    encoding?: string;\n    autoCleanup?: boolean;\n}\n/**\n * Request to read a file\n */\nexport interface ReadFileRequest {\n    path: string;\n    encoding?: string;\n    sessionId?: string;\n}\n/**\n * Request to write a file\n */\nexport interface WriteFileRequest {\n    path: string;\n    content: string;\n    encoding?: string;\n    sessionId?: string;\n}\n/**\n * Request to delete a file\n */\nexport interface DeleteFileRequest {\n    path: string;\n    sessionId?: string;\n}\n/**\n * Request to rename a file\n */\nexport interface RenameFileRequest {\n    oldPath: string;\n    newPath: string;\n    sessionId?: string;\n}\n/**\n * Request to move a file\n */\nexport interface MoveFileRequest {\n    sourcePath: string;\n    destinationPath: string;\n    sessionId?: string;\n}\n/**\n * Request to create a directory\n */\nexport interface MkdirRequest {\n    path: string;\n    recursive?: boolean;\n    sessionId?: string;\n}\n/**\n * Request to check if a file or directory exists\n */\nexport interface FileExistsRequest {\n    path: string;\n    sessionId?: string;\n}\n/**\n * Request to expose a port\n */\nexport interface ExposePortRequest {\n    port: number;\n    name?: string;\n}\n/**\n * Request to clone a Git repository\n */\nexport interface GitCheckoutRequest {\n    repoUrl: string;\n    branch?: string;\n    targetDir?: string;\n    sessionId?: string;\n}\n/**\n * Request to create a session\n */\nexport interface SessionCreateRequest {\n    id?: string;\n    name?: string;\n    env?: Record<string, string>;\n    cwd?: string;\n}\n/**\n * Request to delete a session\n */\nexport interface SessionDeleteRequest {\n    sessionId: string;\n}\n//# sourceMappingURL=request-types.d.ts.map","/**\n * Centralized error code registry\n * Each code maps to a specific error type with consistent semantics\n */\nexport declare const ErrorCode: {\n    readonly FILE_NOT_FOUND: \"FILE_NOT_FOUND\";\n    readonly PERMISSION_DENIED: \"PERMISSION_DENIED\";\n    readonly FILE_EXISTS: \"FILE_EXISTS\";\n    readonly IS_DIRECTORY: \"IS_DIRECTORY\";\n    readonly NOT_DIRECTORY: \"NOT_DIRECTORY\";\n    readonly NO_SPACE: \"NO_SPACE\";\n    readonly TOO_MANY_FILES: \"TOO_MANY_FILES\";\n    readonly RESOURCE_BUSY: \"RESOURCE_BUSY\";\n    readonly READ_ONLY: \"READ_ONLY\";\n    readonly NAME_TOO_LONG: \"NAME_TOO_LONG\";\n    readonly TOO_MANY_LINKS: \"TOO_MANY_LINKS\";\n    readonly FILESYSTEM_ERROR: \"FILESYSTEM_ERROR\";\n    readonly COMMAND_NOT_FOUND: \"COMMAND_NOT_FOUND\";\n    readonly COMMAND_PERMISSION_DENIED: \"COMMAND_PERMISSION_DENIED\";\n    readonly INVALID_COMMAND: \"INVALID_COMMAND\";\n    readonly COMMAND_EXECUTION_ERROR: \"COMMAND_EXECUTION_ERROR\";\n    readonly STREAM_START_ERROR: \"STREAM_START_ERROR\";\n    readonly PROCESS_NOT_FOUND: \"PROCESS_NOT_FOUND\";\n    readonly PROCESS_PERMISSION_DENIED: \"PROCESS_PERMISSION_DENIED\";\n    readonly PROCESS_ERROR: \"PROCESS_ERROR\";\n    readonly PORT_ALREADY_EXPOSED: \"PORT_ALREADY_EXPOSED\";\n    readonly PORT_IN_USE: \"PORT_IN_USE\";\n    readonly PORT_NOT_EXPOSED: \"PORT_NOT_EXPOSED\";\n    readonly INVALID_PORT_NUMBER: \"INVALID_PORT_NUMBER\";\n    readonly INVALID_PORT: \"INVALID_PORT\";\n    readonly SERVICE_NOT_RESPONDING: \"SERVICE_NOT_RESPONDING\";\n    readonly PORT_OPERATION_ERROR: \"PORT_OPERATION_ERROR\";\n    readonly CUSTOM_DOMAIN_REQUIRED: \"CUSTOM_DOMAIN_REQUIRED\";\n    readonly GIT_REPOSITORY_NOT_FOUND: \"GIT_REPOSITORY_NOT_FOUND\";\n    readonly GIT_BRANCH_NOT_FOUND: \"GIT_BRANCH_NOT_FOUND\";\n    readonly GIT_AUTH_FAILED: \"GIT_AUTH_FAILED\";\n    readonly GIT_NETWORK_ERROR: \"GIT_NETWORK_ERROR\";\n    readonly INVALID_GIT_URL: \"INVALID_GIT_URL\";\n    readonly GIT_CLONE_FAILED: \"GIT_CLONE_FAILED\";\n    readonly GIT_CHECKOUT_FAILED: \"GIT_CHECKOUT_FAILED\";\n    readonly GIT_OPERATION_FAILED: \"GIT_OPERATION_FAILED\";\n    readonly BUCKET_MOUNT_ERROR: \"BUCKET_MOUNT_ERROR\";\n    readonly S3FS_MOUNT_ERROR: \"S3FS_MOUNT_ERROR\";\n    readonly MISSING_CREDENTIALS: \"MISSING_CREDENTIALS\";\n    readonly INVALID_MOUNT_CONFIG: \"INVALID_MOUNT_CONFIG\";\n    readonly INTERPRETER_NOT_READY: \"INTERPRETER_NOT_READY\";\n    readonly CONTEXT_NOT_FOUND: \"CONTEXT_NOT_FOUND\";\n    readonly CODE_EXECUTION_ERROR: \"CODE_EXECUTION_ERROR\";\n    readonly VALIDATION_FAILED: \"VALIDATION_FAILED\";\n    readonly INVALID_JSON_RESPONSE: \"INVALID_JSON_RESPONSE\";\n    readonly UNKNOWN_ERROR: \"UNKNOWN_ERROR\";\n    readonly INTERNAL_ERROR: \"INTERNAL_ERROR\";\n};\nexport type ErrorCode = (typeof ErrorCode)[keyof typeof ErrorCode];\n//# sourceMappingURL=codes.d.ts.map"],"mappings":"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"}

package/dist/index.js

@@ -834,13 +834,17 @@ var CommandClient = class extends BaseHttpClient {
 	* @param command - The command to execute
 	* @param sessionId - The session ID for this command execution
 	* @param timeoutMs - Optional timeout in milliseconds (unlimited by default)
+	* @param env - Optional environment variables for this command
+	* @param cwd - Optional working directory for this command
 	*/
-	async execute(command, sessionId, timeoutMs) {
+	async execute(command, sessionId, options) {
 		try {
 			const data = {
 				command,
 				sessionId,
-				...timeoutMs !== void 0 && { timeoutMs }
+				...options?.timeoutMs !== void 0 && { timeoutMs: options.timeoutMs },
+				...options?.env !== void 0 && { env: options.env },
+				...options?.cwd !== void 0 && { cwd: options.cwd }
 			};
 			const response = await this.post("/api/execute", data);
 			this.logSuccess("Command executed", `${command}, Success: ${response.success}`);
@@ -856,12 +860,16 @@ var CommandClient = class extends BaseHttpClient {
 	* Execute a command and return a stream of events
 	* @param command - The command to execute
 	* @param sessionId - The session ID for this command execution
+	* @param options - Optional per-command execution settings
 	*/
-	async executeStream(command, sessionId) {
+	async executeStream(command, sessionId, options) {
 		try {
 			const data = {
 				command,
-				sessionId
+				sessionId,
+				...options?.timeoutMs !== void 0 && { timeoutMs: options.timeoutMs },
+				...options?.env !== void 0 && { env: options.env },
+				...options?.cwd !== void 0 && { cwd: options.cwd }
 			};
 			const response = await this.doFetch("/api/execute/stream", {
 				method: "POST",
@@ -1377,7 +1385,12 @@ var ProcessClient = class extends BaseHttpClient {
 			const data = {
 				command,
 				sessionId,
-				processId: options?.processId
+				...options?.processId !== void 0 && { processId: options.processId },
+				...options?.timeoutMs !== void 0 && { timeoutMs: options.timeoutMs },
+				...options?.env !== void 0 && { env: options.env },
+				...options?.cwd !== void 0 && { cwd: options.cwd },
+				...options?.encoding !== void 0 && { encoding: options.encoding },
+				...options?.autoCleanup !== void 0 && { autoCleanup: options.autoCleanup }
 			};
 			const response = await this.post("/api/process/start", data);
 			this.logSuccess("Process started", `${command} (ID: ${response.processId})`);
@@ -2042,7 +2055,7 @@ function resolveS3fsOptions(provider, userOptions) {
 * 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.5.2";
+const SDK_VERSION = "0.5.3";
 
 //#endregion
 //#region src/sandbox.ts
@@ -2527,7 +2540,12 @@ var Sandbox = class extends Container {
 			let result;
 			if (options?.stream && options?.onOutput) result = await this.executeWithStreaming(command, sessionId, options, startTime, timestamp);
 			else {
-				const response = await this.client.commands.execute(command, sessionId);
+				const commandOptions = options && (options.timeout !== void 0 || options.env !== void 0 || options.cwd !== void 0) ? {
+					timeoutMs: options.timeout,
+					env: options.env,
+					cwd: options.cwd
+				} : void 0;
+				const response = await this.client.commands.execute(command, sessionId, commandOptions);
 				const duration = Date.now() - startTime;
 				result = this.mapExecuteResponseToExecResult(response, duration, sessionId);
 			}
@@ -2542,7 +2560,11 @@ var Sandbox = class extends Container {
 		let stdout = "";
 		let stderr = "";
 		try {
-			const stream = await this.client.commands.executeStream(command, sessionId);
+			const stream = await this.client.commands.executeStream(command, sessionId, {
+				timeoutMs: options.timeout,
+				env: options.env,
+				cwd: options.cwd
+			});
 			for await (const event of parseSSEStream(stream)) {
 				if (options.signal?.aborted) throw new Error("Operation was aborted");
 				switch (event.type) {
@@ -2621,7 +2643,15 @@ var Sandbox = class extends Container {
 	async startProcess(command, options, sessionId) {
 		try {
 			const session = sessionId ?? await this.ensureDefaultSession();
-			const response = await this.client.processes.startProcess(command, session, { processId: options?.processId });
+			const requestOptions = {
+				...options?.processId !== void 0 && { processId: options.processId },
+				...options?.timeout !== void 0 && { timeoutMs: options.timeout },
+				...options?.env !== void 0 && { env: options.env },
+				...options?.cwd !== void 0 && { cwd: options.cwd },
+				...options?.encoding !== void 0 && { encoding: options.encoding },
+				...options?.autoCleanup !== void 0 && { autoCleanup: options.autoCleanup }
+			};
+			const response = await this.client.processes.startProcess(command, session, requestOptions);
 			const processObj = this.createProcessFromDTO({
 				id: response.processId,
 				pid: response.pid,
@@ -2685,14 +2715,22 @@ var Sandbox = class extends Container {
 	async execStream(command, options) {
 		if (options?.signal?.aborted) throw new Error("Operation was aborted");
 		const session = await this.ensureDefaultSession();
-		return this.client.commands.executeStream(command, session);
+		return this.client.commands.executeStream(command, session, {
+			timeoutMs: options?.timeout,
+			env: options?.env,
+			cwd: options?.cwd
+		});
 	}
 	/**
 	* Internal session-aware execStream implementation
 	*/
 	async execStreamWithSession(command, sessionId, options) {
 		if (options?.signal?.aborted) throw new Error("Operation was aborted");
-		return this.client.commands.executeStream(command, sessionId);
+		return this.client.commands.executeStream(command, sessionId, {
+			timeoutMs: options?.timeout,
+			env: options?.env,
+			cwd: options?.cwd
+		});
 	}
 	/**
 	* Stream logs from a background process as a ReadableStream.
@@ -2852,10 +2890,15 @@ var Sandbox = class extends Container {
 	*/
 	async createSession(options) {
 		const sessionId = options?.id || `session-${Date.now()}`;
+		const mergedEnv = {
+			...this.envVars,
+			...options?.env ?? {}
+		};
+		const envPayload = Object.keys(mergedEnv).length > 0 ? mergedEnv : void 0;
 		await this.client.utils.createSession({
 			id: sessionId,
-			env: options?.env,
-			cwd: options?.cwd
+			...envPayload && { env: envPayload },
+			...options?.cwd && { cwd: options.cwd }
 		});
 		return this.getSessionWrapper(sessionId);
 	}