feat(sandboxes): create non-persistent sandboxes with persistent: false (private beta), never billed for storage

GitOrigin-RevId: b966235eb4e3f115dd2a9c88c337809c41f6007a

Author: ramon-langchain

src/resources/sandboxes/boxes.ts

@@ -268,6 +268,18 @@ export interface BoxCreateParams {
 
   name?: string;
 
+  /**
+   * Persistent (private beta) keeps the sandbox's filesystem across stops (the
+   * default, true). Set it to false for a disposable sandbox: its writes are
+   * discarded whenever it stops, the next start boots it fresh from its snapshot,
+   * and it is never charged for storage. A sandbox that is not persistent cannot
+   * preserve memory on stop or have its filesystem captured as a snapshot (exporting
+   * a Docker image from it with docker_image still works), and some snapshots
+   * captured from other sandboxes cannot start one; such a create is rejected.
+   * Setting it to false requires the private beta to be enabled for your workspace.
+   */
+  persistent?: boolean;
+
   /**
    * PreserveMemoryOnStop, when true, suspends the sandbox's memory on a voluntary
    * stop (idle timeout or explicit stop) so the next start resumes from where it

src/resources/sandboxes/sandboxes.ts

@@ -1117,6 +1117,13 @@ export interface SandboxResponse {
 
   name?: string;
 
+  /**
+   * Persistent (private beta) reports whether the sandbox keeps its filesystem
+   * across stops. When false, its writes are discarded whenever it stops and it is
+   * not charged for storage.
+   */
+  persistent?: boolean;
+
   preserve_memory_on_stop?: boolean;
 
   proxy_config?: ProxyConfig;