@sandbox-engine/sdk 0.1.2 → 0.1.3

package/README.md

@@ -70,7 +70,7 @@ Creates and starts a new sandbox. Returns when the sandbox is ready.
 | `apiKey` | `string` | `$SANDBOX_API_KEY` or `dev-api-key` | API key |
 | `template` | `string` | `'base'` | Pre-built Docker image tag |
 | `dockerfile` | `string` | — | Custom Dockerfile content |
-| `timeout` | `number` | `300000` | TTL in ms before auto-destroy |
+| `timeout` | `number` | `300000` | Timer duration in ms. Resets on every API call. Use `0` to never expire. |
 
 ---
 
@@ -146,6 +146,19 @@ const ports = await sandbox.ports.list()
 
 ---
 
+### `sandbox.keepalive(timeout?)`
+
+Resets the expiry countdown from now. Use when the orchestrator needs to keep the sandbox alive without doing real work (e.g. an LLM reasoning between steps).
+
+```ts
+await sandbox.keepalive()              // reset with original timeout
+await sandbox.keepalive(10 * 60_000)   // extend to 10 min from now
+```
+
+Any API call (`exec`, `fs`, `ports`, etc.) also resets the timer automatically.
+
+---
+
 ### `sandbox.close()`
 
 Destroys the sandbox and frees all resources. Always call this when done.

package/dist/index.d.mts

@@ -112,7 +112,8 @@ interface SandboxApiResponse {
     status: string;
     template: string;
     createdAt: string;
-    expiresAt: string;
+    timeout: number;
+    expiresAt: string | null;
     agentUrl: string;
     ports: Record<string, number>;
 }
@@ -136,6 +137,7 @@ declare class Sandbox {
         unexpose: (containerPort: number) => Promise<void>;
     };
     info(): Promise<SandboxApiResponse>;
+    keepalive(timeout?: number): Promise<SandboxApiResponse>;
     close(): Promise<void>;
 }
 

package/dist/index.d.ts

@@ -112,7 +112,8 @@ interface SandboxApiResponse {
     status: string;
     template: string;
     createdAt: string;
-    expiresAt: string;
+    timeout: number;
+    expiresAt: string | null;
     agentUrl: string;
     ports: Record<string, number>;
 }
@@ -136,6 +137,7 @@ declare class Sandbox {
         unexpose: (containerPort: number) => Promise<void>;
     };
     info(): Promise<SandboxApiResponse>;
+    keepalive(timeout?: number): Promise<SandboxApiResponse>;
     close(): Promise<void>;
 }
 

package/dist/index.js

@@ -313,6 +313,12 @@ var Sandbox = class _Sandbox {
   async info() {
     return this.client.get(`/api/sandboxes/${this.id}`);
   }
+  async keepalive(timeout) {
+    return this.client.post(
+      `/api/sandboxes/${this.id}/keepalive`,
+      timeout !== void 0 ? { timeout } : {}
+    );
+  }
   async close() {
     await this.client.delete(`/api/sandboxes/${this.id}`);
   }

package/dist/index.mjs

@@ -274,6 +274,12 @@ var Sandbox = class _Sandbox {
   async info() {
     return this.client.get(`/api/sandboxes/${this.id}`);
   }
+  async keepalive(timeout) {
+    return this.client.post(
+      `/api/sandboxes/${this.id}/keepalive`,
+      timeout !== void 0 ? { timeout } : {}
+    );
+  }
   async close() {
     await this.client.delete(`/api/sandboxes/${this.id}`);
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sandbox-engine/sdk",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "SDK for creating and managing isolated sandbox environments",
   "keywords": ["sandbox", "docker", "code-execution", "isolated", "e2b"],
   "license": "MIT",