@sandbox-engine/sdk 0.1.1 → 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

@@ -54,6 +54,18 @@ interface FileEntry {
     isDirectory: boolean;
     isFile: boolean;
 }
+interface FileWriteEntry {
+    path: string;
+    content: string;
+    encoding?: BufferEncoding;
+}
+interface FileWriteManyResult {
+    results: Array<{
+        path: string;
+        success: boolean;
+        error?: string;
+    }>;
+}
 interface PortMapping {
     containerPort: number;
     hostPort: number;
@@ -75,6 +87,8 @@ declare class Filesystem {
     read(filePath: string): Promise<string>;
     write(filePath: string, content: string): Promise<void>;
     list(dirPath: string): Promise<FileEntry[]>;
+    writeMany(files: FileWriteEntry[]): Promise<FileWriteManyResult>;
+    rename(oldPath: string, newPath: string): Promise<void>;
     delete(filePath: string): Promise<void>;
 }
 
@@ -98,7 +112,8 @@ interface SandboxApiResponse {
     status: string;
     template: string;
     createdAt: string;
-    expiresAt: string;
+    timeout: number;
+    expiresAt: string | null;
     agentUrl: string;
     ports: Record<string, number>;
 }
@@ -122,7 +137,8 @@ declare class Sandbox {
         unexpose: (containerPort: number) => Promise<void>;
     };
     info(): Promise<SandboxApiResponse>;
+    keepalive(timeout?: number): Promise<SandboxApiResponse>;
     close(): Promise<void>;
 }
 
-export { type ExecOptions, type ExecResult, type FileEntry, Filesystem, type PortMapping, Process, type ProxyEnvResult, Sandbox, type SandboxOptions, Terminal, type WsMessage, type WsMessageType };
+export { type ExecOptions, type ExecResult, type FileEntry, type FileWriteEntry, type FileWriteManyResult, Filesystem, type PortMapping, Process, type ProxyEnvResult, Sandbox, type SandboxOptions, Terminal, type WsMessage, type WsMessageType };

package/dist/index.d.ts

@@ -54,6 +54,18 @@ interface FileEntry {
     isDirectory: boolean;
     isFile: boolean;
 }
+interface FileWriteEntry {
+    path: string;
+    content: string;
+    encoding?: BufferEncoding;
+}
+interface FileWriteManyResult {
+    results: Array<{
+        path: string;
+        success: boolean;
+        error?: string;
+    }>;
+}
 interface PortMapping {
     containerPort: number;
     hostPort: number;
@@ -75,6 +87,8 @@ declare class Filesystem {
     read(filePath: string): Promise<string>;
     write(filePath: string, content: string): Promise<void>;
     list(dirPath: string): Promise<FileEntry[]>;
+    writeMany(files: FileWriteEntry[]): Promise<FileWriteManyResult>;
+    rename(oldPath: string, newPath: string): Promise<void>;
     delete(filePath: string): Promise<void>;
 }
 
@@ -98,7 +112,8 @@ interface SandboxApiResponse {
     status: string;
     template: string;
     createdAt: string;
-    expiresAt: string;
+    timeout: number;
+    expiresAt: string | null;
     agentUrl: string;
     ports: Record<string, number>;
 }
@@ -122,7 +137,8 @@ declare class Sandbox {
         unexpose: (containerPort: number) => Promise<void>;
     };
     info(): Promise<SandboxApiResponse>;
+    keepalive(timeout?: number): Promise<SandboxApiResponse>;
     close(): Promise<void>;
 }
 
-export { type ExecOptions, type ExecResult, type FileEntry, Filesystem, type PortMapping, Process, type ProxyEnvResult, Sandbox, type SandboxOptions, Terminal, type WsMessage, type WsMessageType };
+export { type ExecOptions, type ExecResult, type FileEntry, type FileWriteEntry, type FileWriteManyResult, Filesystem, type PortMapping, Process, type ProxyEnvResult, Sandbox, type SandboxOptions, Terminal, type WsMessage, type WsMessageType };

package/dist/index.js

@@ -126,6 +126,18 @@ var Filesystem = class {
     );
     return res.files;
   }
+  async writeMany(files) {
+    return this.client.post(
+      `/api/sandboxes/${this.sandboxId}/files/batch`,
+      { files }
+    );
+  }
+  async rename(oldPath, newPath) {
+    await this.client.post(`/api/sandboxes/${this.sandboxId}/files/rename`, {
+      from: oldPath,
+      to: newPath
+    });
+  }
   async delete(filePath) {
     await this.client.delete(`/api/sandboxes/${this.sandboxId}/files`, { path: filePath });
   }
@@ -301,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

@@ -87,6 +87,18 @@ var Filesystem = class {
     );
     return res.files;
   }
+  async writeMany(files) {
+    return this.client.post(
+      `/api/sandboxes/${this.sandboxId}/files/batch`,
+      { files }
+    );
+  }
+  async rename(oldPath, newPath) {
+    await this.client.post(`/api/sandboxes/${this.sandboxId}/files/rename`, {
+      from: oldPath,
+      to: newPath
+    });
+  }
   async delete(filePath) {
     await this.client.delete(`/api/sandboxes/${this.sandboxId}/files`, { path: filePath });
   }
@@ -262,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.1",
+  "version": "0.1.3",
   "description": "SDK for creating and managing isolated sandbox environments",
   "keywords": ["sandbox", "docker", "code-execution", "isolated", "e2b"],
   "license": "MIT",