@agentuity/server 0.0.104 → 0.0.106

package/dist/runtime-bootstrap.js

@@ -51,6 +51,9 @@ export function bootstrapRuntimeEnv(options = {}) {
     if (!process.env.AGENTUITY_KEYVALUE_URL) {
         process.env.AGENTUITY_KEYVALUE_URL = serviceUrls.keyvalue;
     }
+    if (!process.env.AGENTUITY_SANDBOX_URL) {
+        process.env.AGENTUITY_SANDBOX_URL = serviceUrls.sandbox;
+    }
     if (!process.env.AGENTUITY_STREAM_URL) {
         process.env.AGENTUITY_STREAM_URL = serviceUrls.stream;
     }

package/dist/runtime-bootstrap.js.map

@@ -1 +1 @@
-{"version":3,"file":"runtime-bootstrap.js","sourceRoot":"","sources":["../src/runtime-bootstrap.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAe1C;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,UAAU,mBAAmB,CAAC,UAAmC,EAAE;IACxE,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,OAAO,CAAC;IAE5E,6DAA6D;IAC7D,IACC,CAAC,OAAO,KAAK,OAAO,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,aAAa,CAAC;QAC/D,CAAC,OAAO,CAAC,GAAG,CAAC,gBAAgB,EAC5B,CAAC;QACF,OAAO,CAAC,GAAG,CAAC,gBAAgB,GAAG,OAAO,CAAC;IACxC,CAAC;IAED,kDAAkD;IAClD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,iBAAiB,EAAE,CAAC;QACpC,OAAO,CAAC,GAAG,CAAC,iBAAiB,GAAG,OAAO,CAAC;IACzC,CAAC;IAED,mCAAmC;IACnC,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC;IAC5C,MAAM,WAAW,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;IAE3C,2EAA2E;IAC3E,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,uBAAuB,EAAE,CAAC;QAC1C,OAAO,CAAC,GAAG,CAAC,uBAAuB,GAAG,WAAW,CAAC,QAAQ,CAAC;IAC5D,CAAC;IACD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,sBAAsB,EAAE,CAAC;QACzC,OAAO,CAAC,GAAG,CAAC,sBAAsB,GAAG,WAAW,CAAC,QAAQ,CAAC;IAC3D,CAAC;IACD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,oBAAoB,EAAE,CAAC;QACvC,OAAO,CAAC,GAAG,CAAC,oBAAoB,GAAG,WAAW,CAAC,MAAM,CAAC;IACvD,CAAC;IACD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,oBAAoB,EAAE,CAAC;QACvC,OAAO,CAAC,GAAG,CAAC,oBAAoB,GAAG,WAAW,CAAC,MAAM,CAAC;IACvD,CAAC;IACD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,sBAAsB,EAAE,CAAC;QACzC,OAAO,CAAC,GAAG,CAAC,sBAAsB,GAAG,WAAW,CAAC,QAAQ,CAAC;IAC3D,CAAC;IACD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,kBAAkB,EAAE,CAAC;QACrC,OAAO,CAAC,GAAG,CAAC,kBAAkB,GAAG,WAAW,CAAC,IAAI,CAAC;IACnD,CAAC;AACF,CAAC"}
+{"version":3,"file":"runtime-bootstrap.js","sourceRoot":"","sources":["../src/runtime-bootstrap.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAe1C;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,UAAU,mBAAmB,CAAC,UAAmC,EAAE;IACxE,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,OAAO,CAAC;IAE5E,6DAA6D;IAC7D,IACC,CAAC,OAAO,KAAK,OAAO,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,aAAa,CAAC;QAC/D,CAAC,OAAO,CAAC,GAAG,CAAC,gBAAgB,EAC5B,CAAC;QACF,OAAO,CAAC,GAAG,CAAC,gBAAgB,GAAG,OAAO,CAAC;IACxC,CAAC;IAED,kDAAkD;IAClD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,iBAAiB,EAAE,CAAC;QACpC,OAAO,CAAC,GAAG,CAAC,iBAAiB,GAAG,OAAO,CAAC;IACzC,CAAC;IAED,mCAAmC;IACnC,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC;IAC5C,MAAM,WAAW,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;IAE3C,2EAA2E;IAC3E,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,uBAAuB,EAAE,CAAC;QAC1C,OAAO,CAAC,GAAG,CAAC,uBAAuB,GAAG,WAAW,CAAC,QAAQ,CAAC;IAC5D,CAAC;IACD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,sBAAsB,EAAE,CAAC;QACzC,OAAO,CAAC,GAAG,CAAC,sBAAsB,GAAG,WAAW,CAAC,QAAQ,CAAC;IAC3D,CAAC;IACD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,qBAAqB,EAAE,CAAC;QACxC,OAAO,CAAC,GAAG,CAAC,qBAAqB,GAAG,WAAW,CAAC,OAAO,CAAC;IACzD,CAAC;IACD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,oBAAoB,EAAE,CAAC;QACvC,OAAO,CAAC,GAAG,CAAC,oBAAoB,GAAG,WAAW,CAAC,MAAM,CAAC;IACvD,CAAC;IACD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,oBAAoB,EAAE,CAAC;QACvC,OAAO,CAAC,GAAG,CAAC,oBAAoB,GAAG,WAAW,CAAC,MAAM,CAAC;IACvD,CAAC;IACD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,sBAAsB,EAAE,CAAC;QACzC,OAAO,CAAC,GAAG,CAAC,sBAAsB,GAAG,WAAW,CAAC,QAAQ,CAAC;IAC3D,CAAC;IACD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,kBAAkB,EAAE,CAAC;QACrC,OAAO,CAAC,GAAG,CAAC,kBAAkB,GAAG,WAAW,CAAC,IAAI,CAAC;IACnD,CAAC;AACF,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@agentuity/server",
-	"version": "0.0.104",
+	"version": "0.0.106",
 	"license": "Apache-2.0",
 	"author": "Agentuity employees and contributors",
 	"type": "module",
@@ -25,12 +25,12 @@
 		"prepublishOnly": "bun run clean && bun run build"
 	},
 	"dependencies": {
-		"@agentuity/core": "0.0.104",
-		"@agentuity/schema": "0.0.104",
+		"@agentuity/core": "0.0.106",
+		"@agentuity/schema": "0.0.106",
 		"zod": "^4.1.12"
 	},
 	"devDependencies": {
-		"@agentuity/test-utils": "0.0.104",
+		"@agentuity/test-utils": "0.0.106",
 		"@types/bun": "latest",
 		"@types/node": "^22.0.0",
 		"bun-types": "latest",

package/src/api/api.ts

@@ -122,9 +122,10 @@ export class APIClient {
 	 */
 	async get<TResponse = void>(
 		endpoint: string,
-		responseSchema?: z.ZodType<TResponse>
+		responseSchema?: z.ZodType<TResponse>,
+		signal?: AbortSignal
 	): Promise<TResponse> {
-		return this.request('GET', endpoint, responseSchema);
+		return this.request('GET', endpoint, responseSchema, undefined, undefined, signal);
 	}
 
 	/**
@@ -134,9 +135,10 @@ export class APIClient {
 		endpoint: string,
 		body?: TBody,
 		responseSchema?: z.ZodType<TResponse>,
-		bodySchema?: z.ZodType<TBody>
+		bodySchema?: z.ZodType<TBody>,
+		signal?: AbortSignal
 	): Promise<TResponse> {
-		return this.request('POST', endpoint, responseSchema, body, bodySchema);
+		return this.request('POST', endpoint, responseSchema, body, bodySchema, signal);
 	}
 
 	/**
@@ -146,9 +148,10 @@ export class APIClient {
 		endpoint: string,
 		body?: TBody,
 		responseSchema?: z.ZodType<TResponse>,
-		bodySchema?: z.ZodType<TBody>
+		bodySchema?: z.ZodType<TBody>,
+		signal?: AbortSignal
 	): Promise<TResponse> {
-		return this.request('PUT', endpoint, responseSchema, body, bodySchema);
+		return this.request('PUT', endpoint, responseSchema, body, bodySchema, signal);
 	}
 
 	/**
@@ -156,9 +159,10 @@ export class APIClient {
 	 */
 	async delete<TResponse = void>(
 		endpoint: string,
-		responseSchema?: z.ZodType<TResponse>
+		responseSchema?: z.ZodType<TResponse>,
+		signal?: AbortSignal
 	): Promise<TResponse> {
-		return this.request('DELETE', endpoint, responseSchema);
+		return this.request('DELETE', endpoint, responseSchema, undefined, undefined, signal);
 	}
 
 	/**
@@ -168,9 +172,18 @@ export class APIClient {
 		endpoint: string,
 		body?: TBody,
 		responseSchema?: z.ZodType<TResponse>,
-		bodySchema?: z.ZodType<TBody>
+		bodySchema?: z.ZodType<TBody>,
+		signal?: AbortSignal
 	): Promise<TResponse> {
-		return this.request('PATCH', endpoint, responseSchema, body, bodySchema);
+		return this.request('PATCH', endpoint, responseSchema, body, bodySchema, signal);
+	}
+
+	/**
+	 * Raw GET request that returns the Response object directly.
+	 * Useful for streaming responses where you need access to the body stream.
+	 */
+	async rawGet(endpoint: string, signal?: AbortSignal): Promise<Response> {
+		return this.#makeRequest('GET', endpoint, undefined, signal);
 	}
 
 	/**
@@ -181,7 +194,8 @@ export class APIClient {
 		endpoint: string,
 		responseSchema?: z.ZodType<TResponse>,
 		body?: TBody,
-		bodySchema?: z.ZodType<TBody>
+		bodySchema?: z.ZodType<TBody>,
+		signal?: AbortSignal
 	): Promise<TResponse> {
 		// Validate request body if schema provided
 		if (body !== undefined && bodySchema) {
@@ -194,7 +208,7 @@ export class APIClient {
 			}
 		}
 
-		const response = await this.#makeRequest(method, endpoint, body);
+		const response = await this.#makeRequest(method, endpoint, body, signal);
 
 		// Handle empty responses (204 or zero-length body)
 		let data: unknown;
@@ -231,7 +245,12 @@ export class APIClient {
 		return undefined as TResponse;
 	}
 
-	async #makeRequest(method: string, endpoint: string, body?: unknown): Promise<Response> {
+	async #makeRequest(
+		method: string,
+		endpoint: string,
+		body?: unknown,
+		signal?: AbortSignal
+	): Promise<Response> {
 		this.#logger.trace('sending %s to %s%s', method, this.#baseUrl, endpoint);
 
 		const maxRetries = this.#config?.maxRetries ?? 3;
@@ -266,6 +285,7 @@ export class APIClient {
 						method,
 						headers,
 						body: body !== undefined ? JSON.stringify(body) : undefined,
+						signal,
 					});
 				} catch (ex) {
 					const _ex = ex as { code?: string; name: string };

package/src/api/index.ts

@@ -4,6 +4,7 @@ export * from './db';
 export * from './org';
 export * from './project';
 export * from './region';
+export * from './sandbox';
 export * from './session';
 export * from './thread';
 export * from './user';

package/src/api/project/deploy.ts

@@ -6,8 +6,6 @@ export const Resources = z.object({
 	memory: z.string().default('500Mi').describe('The memory requirements'),
 	cpu: z.string().default('500m').describe('The CPU requirements'),
 	disk: z.string().default('500Mi').describe('The disk requirements'),
-	db: z.string().optional().describe('the name of the database to use'),
-	storage: z.string().optional().describe('the name of the storage bucket to use'),
 });
 
 export const Mode = z.object({

package/src/api/project/get.ts

@@ -4,7 +4,8 @@ import { ProjectResponseError } from './util';
 
 const _ProjectGetRequestSchema = z.object({
 	id: z.string().describe('the project id'),
-	mask: z.boolean().default(true).describe('if the secrets should be returned masked'),
+	mask: z.boolean().default(true).optional().describe('if the secrets should be returned masked'),
+	keys: z.boolean().default(true).optional().describe('if the project keys should be returned'),
 });
 
 const ProjectSchema = z.object({
@@ -27,12 +28,19 @@ type ProjectGetResponse = z.infer<typeof ProjectGetResponseSchema>;
 export type Project = z.infer<typeof ProjectSchema>;
 
 export async function projectGet(client: APIClient, request: ProjectGetRequest): Promise<Project> {
+	const keys = request.keys ?? true;
 	const resp = await client.get<ProjectGetResponse>(
-		`/cli/project/${request.id}?mask=${request.mask ?? true}`,
+		`/cli/project/${request.id}?mask=${request.mask ?? true}&includeProjectKeys=${keys}`,
 		ProjectGetResponseSchema
 	);
 
 	if (resp.success) {
+		if (keys && resp.data.secrets?.AGENTUITY_SDK_KEY) {
+			return {
+				...resp.data,
+				api_key: resp.data.secrets.AGENTUITY_SDK_KEY,
+			};
+		}
 		return resp.data;
 	}
 

package/src/api/region/create.ts

@@ -14,6 +14,7 @@ const CreateResourcesRequest = z.object({
 const CreatedResource = z.object({
 	type: z.string().describe('the resource type'),
 	name: z.string().describe('the resource name'),
+	env: z.record(z.string(), z.string()).describe('environment variables for the resource'),
 });
 
 const CreateResourcesResponse = z.object({

package/src/api/region/delete.ts

@@ -11,14 +11,21 @@ const DeleteResourcesRequest = z.object({
 	resources: z.array(DeleteResourceSpec).describe('list of resources to delete'),
 });
 
+const DeletedResource = z.object({
+	type: z.string().describe('the resource type'),
+	name: z.string().describe('the resource name'),
+	env_keys: z.array(z.string()).describe('environment variable keys to remove'),
+});
+
 const DeleteResourcesResponse = z.object({
-	deleted: z.array(z.string()).describe('list of deleted resource names'),
+	deleted: z.array(DeletedResource).describe('list of deleted resources'),
 });
 
 const DeleteResourcesResponseSchema = APIResponseSchema(DeleteResourcesResponse);
 
 export type DeleteResourcesRequest = z.infer<typeof DeleteResourcesRequest>;
 export type DeleteResourcesResponse = z.infer<typeof DeleteResourcesResponseSchema>;
+export type DeletedResource = z.infer<typeof DeletedResource>;
 
 /**
  * Delete one or more resources (DB or S3) for an organization in a specific region
@@ -35,7 +42,7 @@ export async function deleteResources(
 	orgId: string,
 	region: string,
 	resources: Array<{ type: 'db' | 's3'; name: string }>
-): Promise<string[]> {
+): Promise<DeletedResource[]> {
 	const resp = await client.request<DeleteResourcesResponse, DeleteResourcesRequest>(
 		'DELETE',
 		`/resource/2025-11-16/${orgId}/${region}`,

package/src/api/region/resources.ts

@@ -11,6 +11,7 @@ const ResourceListResponse = z.object({
 			region: z.string().nullable().optional().describe('the S3 region'),
 			endpoint: z.string().nullable().optional().describe('the S3 endpoint'),
 			cname: z.string().nullable().optional().describe('the S3 CNAME'),
+			env: z.record(z.string(), z.string()).describe('environment variables for the resource'),
 		})
 	),
 	db: z.array(
@@ -19,6 +20,7 @@ const ResourceListResponse = z.object({
 			username: z.string().nullable().optional().describe('the database username'),
 			password: z.string().nullable().optional().describe('the database password'),
 			url: z.string().nullable().optional().describe('the full database connection URL'),
+			env: z.record(z.string(), z.string()).describe('environment variables for the resource'),
 		})
 	),
 	redis: z

package/src/api/sandbox/client.ts

@@ -0,0 +1,349 @@
+import type {
+	Logger,
+	SandboxCreateOptions,
+	SandboxInfo,
+	ExecuteOptions as CoreExecuteOptions,
+	Execution,
+	FileToWrite,
+} from '@agentuity/core';
+import type { Writable } from 'node:stream';
+import { APIClient } from '../api';
+import { sandboxCreate, type SandboxCreateResponse } from './create';
+import { sandboxDestroy } from './destroy';
+import { sandboxGet } from './get';
+import { sandboxExecute } from './execute';
+import { sandboxWriteFiles, sandboxReadFile } from './files';
+import { executionGet, type ExecutionInfo } from './execution';
+import { ConsoleLogger } from '../../logger';
+import { getServiceUrls } from '../../config';
+
+const POLL_INTERVAL_MS = 100;
+const MAX_POLL_TIME_MS = 300000; // 5 minutes
+
+/**
+ * Poll for execution completion
+ */
+async function waitForExecution(
+	client: APIClient,
+	executionId: string,
+	orgId?: string,
+	signal?: AbortSignal
+): Promise<ExecutionInfo> {
+	const startTime = Date.now();
+
+	while (Date.now() - startTime < MAX_POLL_TIME_MS) {
+		if (signal?.aborted) {
+			throw new DOMException('The operation was aborted.', 'AbortError');
+		}
+
+		const info = await executionGet(client, { executionId, orgId });
+
+		if (
+			info.status === 'completed' ||
+			info.status === 'failed' ||
+			info.status === 'timeout' ||
+			info.status === 'cancelled'
+		) {
+			return info;
+		}
+
+		await new Promise((resolve, reject) => {
+			const timeoutId = setTimeout(resolve, POLL_INTERVAL_MS);
+			signal?.addEventListener(
+				'abort',
+				() => {
+					clearTimeout(timeoutId);
+					reject(new DOMException('The operation was aborted.', 'AbortError'));
+				},
+				{ once: true }
+			);
+		});
+	}
+
+	throw new Error(`Execution ${executionId} timed out waiting for completion`);
+}
+
+/**
+ * Pipes a remote stream URL to a local writable stream
+ */
+async function pipeStreamToWritable(streamUrl: string, writable: Writable): Promise<void> {
+	const response = await fetch(streamUrl);
+	if (!response.ok) {
+		throw new Error(`Failed to fetch stream: ${response.status} ${response.statusText}`);
+	}
+	if (!response.body) {
+		return;
+	}
+
+	const reader = response.body.getReader();
+	try {
+		while (true) {
+			const { done, value } = await reader.read();
+			if (done) break;
+			if (value) {
+				writable.write(value);
+			}
+		}
+	} finally {
+		reader.releaseLock();
+	}
+}
+
+/**
+ * Extended execute options that support piping output to writable streams
+ */
+export interface ExecuteOptions extends CoreExecuteOptions {
+	/**
+	 * Pipe stdout/stderr to writable streams (e.g., process.stdout)
+	 */
+	pipe?: {
+		stdout?: Writable;
+		stderr?: Writable;
+	};
+}
+
+export interface SandboxClientOptions {
+	/**
+	 * API key for authentication.
+	 * Defaults to process.env.AGENTUITY_SDK_KEY || process.env.AGENTUITY_CLI_KEY
+	 */
+	apiKey?: string;
+
+	/**
+	 * Base URL for the sandbox API.
+	 * Defaults to process.env.AGENTUITY_SANDBOX_URL ||
+	 *   process.env.AGENTUITY_CATALYST_URL ||
+	 *   process.env.AGENTUITY_TRANSPORT_URL ||
+	 *   regional catalyst URL
+	 */
+	url?: string;
+
+	/**
+	 * Organization ID for multi-tenant operations
+	 */
+	orgId?: string;
+
+	/**
+	 * Custom logger instance
+	 */
+	logger?: Logger;
+}
+
+/**
+ * A sandbox instance returned by SandboxClient.create()
+ */
+export interface SandboxInstance {
+	/**
+	 * Unique sandbox identifier
+	 */
+	id: string;
+
+	/**
+	 * Sandbox status at creation time
+	 */
+	status: SandboxCreateResponse['status'];
+
+	/**
+	 * URL to stream stdout output
+	 */
+	stdoutStreamUrl?: string;
+
+	/**
+	 * URL to stream stderr output
+	 */
+	stderrStreamUrl?: string;
+
+	/**
+	 * Execute a command in the sandbox
+	 */
+	execute(options: ExecuteOptions): Promise<Execution>;
+
+	/**
+	 * Get current sandbox information
+	 */
+	get(): Promise<SandboxInfo>;
+
+	/**
+	 * Destroy the sandbox and release all resources
+	 */
+	destroy(): Promise<void>;
+}
+
+/**
+ * Convenience client for sandbox operations.
+ *
+ * @example
+ * ```typescript
+ * const client = new SandboxClient();
+ * const sandbox = await client.create();
+ * const result = await sandbox.execute({ command: ['echo', 'hello'] });
+ * await sandbox.destroy();
+ * ```
+ */
+export class SandboxClient {
+	readonly #client: APIClient;
+	readonly #orgId?: string;
+
+	constructor(options: SandboxClientOptions = {}) {
+		const apiKey =
+			options.apiKey || process.env.AGENTUITY_SDK_KEY || process.env.AGENTUITY_CLI_KEY;
+
+		const region = process.env.AGENTUITY_REGION ?? 'usc';
+		const serviceUrls = getServiceUrls(region);
+
+		const url =
+			options.url ||
+			process.env.AGENTUITY_SANDBOX_URL ||
+			process.env.AGENTUITY_CATALYST_URL ||
+			process.env.AGENTUITY_TRANSPORT_URL ||
+			serviceUrls.sandbox;
+
+		const logger = options.logger ?? new ConsoleLogger('warn');
+
+		this.#client = new APIClient(url, logger, apiKey ?? '', {});
+		this.#orgId = options.orgId;
+	}
+
+	/**
+	 * Create a new sandbox instance
+	 *
+	 * @param options - Optional sandbox configuration
+	 * @returns A sandbox instance with execute and destroy methods
+	 */
+	async create(options?: SandboxCreateOptions): Promise<SandboxInstance> {
+		const response = await sandboxCreate(this.#client, {
+			options,
+			orgId: this.#orgId,
+		});
+
+		const sandboxId = response.sandboxId;
+		const client = this.#client;
+		const orgId = this.#orgId;
+
+		return {
+			id: sandboxId,
+			status: response.status,
+			stdoutStreamUrl: response.stdoutStreamUrl,
+			stderrStreamUrl: response.stderrStreamUrl,
+
+			async execute(executeOptions: ExecuteOptions): Promise<Execution> {
+				const { pipe, ...coreOptions } = executeOptions;
+
+				const initialResult = await sandboxExecute(client, {
+					sandboxId,
+					options: coreOptions,
+					orgId,
+					signal: coreOptions.signal,
+				});
+
+				// If pipe options provided, stream the output to the writable streams
+				if (pipe) {
+					const streamPromises: Promise<void>[] = [];
+
+					if (pipe.stdout && initialResult.stdoutStreamUrl) {
+						streamPromises.push(
+							pipeStreamToWritable(initialResult.stdoutStreamUrl, pipe.stdout)
+						);
+					}
+					if (pipe.stderr && initialResult.stderrStreamUrl) {
+						streamPromises.push(
+							pipeStreamToWritable(initialResult.stderrStreamUrl, pipe.stderr)
+						);
+					}
+
+					// Wait for all streams to complete
+					if (streamPromises.length > 0) {
+						await Promise.all(streamPromises);
+					}
+				}
+
+				// Wait for execution to complete and get final result with exit code
+				const finalResult = await waitForExecution(
+					client,
+					initialResult.executionId,
+					orgId,
+					coreOptions.signal
+				);
+
+				return {
+					executionId: finalResult.executionId,
+					status: finalResult.status,
+					exitCode: finalResult.exitCode,
+					durationMs: finalResult.durationMs,
+					stdoutStreamUrl: initialResult.stdoutStreamUrl,
+					stderrStreamUrl: initialResult.stderrStreamUrl,
+				};
+			},
+
+			async get(): Promise<SandboxInfo> {
+				return sandboxGet(client, { sandboxId, orgId });
+			},
+
+			async destroy(): Promise<void> {
+				return sandboxDestroy(client, { sandboxId, orgId });
+			},
+		};
+	}
+
+	/**
+	 * Get sandbox information by ID
+	 *
+	 * @param sandboxId - The sandbox ID
+	 * @returns Sandbox information
+	 */
+	async get(sandboxId: string): Promise<SandboxInfo> {
+		return sandboxGet(this.#client, { sandboxId, orgId: this.#orgId });
+	}
+
+	/**
+	 * Destroy a sandbox by ID
+	 *
+	 * @param sandboxId - The sandbox ID to destroy
+	 */
+	async destroy(sandboxId: string): Promise<void> {
+		return sandboxDestroy(this.#client, { sandboxId, orgId: this.#orgId });
+	}
+
+	/**
+	 * Write files to a sandbox workspace
+	 *
+	 * @param sandboxId - The sandbox ID
+	 * @param files - Array of files to write with path and content
+	 * @param signal - Optional AbortSignal to cancel the operation
+	 * @returns The number of files written
+	 */
+	async writeFiles(
+		sandboxId: string,
+		files: FileToWrite[],
+		signal?: AbortSignal
+	): Promise<number> {
+		const result = await sandboxWriteFiles(this.#client, {
+			sandboxId,
+			files,
+			orgId: this.#orgId,
+			signal,
+		});
+		return result.filesWritten;
+	}
+
+	/**
+	 * Read a file from a sandbox workspace
+	 *
+	 * @param sandboxId - The sandbox ID
+	 * @param path - Path to the file relative to the sandbox workspace
+	 * @param signal - Optional AbortSignal to cancel the operation
+	 * @returns A ReadableStream of the file contents
+	 */
+	async readFile(
+		sandboxId: string,
+		path: string,
+		signal?: AbortSignal
+	): Promise<ReadableStream<Uint8Array>> {
+		return sandboxReadFile(this.#client, {
+			sandboxId,
+			path,
+			orgId: this.#orgId,
+			signal,
+		});
+	}
+}