bashkit 0.2.1 → 0.2.2

package/dist/index.js

@@ -53,16 +53,22 @@ var anthropicPromptCacheMiddleware = {
 import { Sandbox as E2BSandboxSDK } from "@e2b/code-interpreter";
 function createE2BSandbox(config = {}) {
   let sandbox = null;
+  let sandboxId = config.sandboxId;
   const workingDirectory = config.cwd || "/home/user";
   const timeout = config.timeout ?? 300000;
   const ensureSandbox = async () => {
     if (sandbox)
       return sandbox;
-    sandbox = await E2BSandboxSDK.create({
-      apiKey: config.apiKey,
-      timeoutMs: timeout,
-      metadata: config.metadata
-    });
+    if (config.sandboxId) {
+      sandbox = await E2BSandboxSDK.connect(config.sandboxId);
+    } else {
+      sandbox = await E2BSandboxSDK.create({
+        apiKey: config.apiKey,
+        timeoutMs: timeout,
+        metadata: config.metadata
+      });
+      sandboxId = sandbox.sandboxId;
+    }
     return sandbox;
   };
   const exec = async (command, options) => {
@@ -108,6 +114,9 @@ function createE2BSandbox(config = {}) {
   };
   return {
     exec,
+    get id() {
+      return sandboxId;
+    },
     async readFile(path) {
       const result = await exec(`cat "${path}"`);
       if (result.exitCode !== 0) {
@@ -227,6 +236,7 @@ function createLocalSandbox(config = {}) {
 import { Sandbox as VercelSandboxSDK } from "@vercel/sandbox";
 function createVercelSandbox(config = {}) {
   let sandbox = null;
+  let sandboxId = config.sandboxId;
   const workingDirectory = config.cwd || "/vercel/sandbox";
   const resolvedConfig = {
     runtime: config.runtime ?? "node22",
@@ -247,7 +257,12 @@ function createVercelSandbox(config = {}) {
         token: config.token
       });
     }
-    sandbox = await VercelSandboxSDK.create(createOptions);
+    if (config.sandboxId) {
+      sandbox = await VercelSandboxSDK.get({ sandboxId: config.sandboxId });
+    } else {
+      sandbox = await VercelSandboxSDK.create(createOptions);
+    }
+    sandboxId = sandbox.sandboxId;
     return sandbox;
   };
   const exec = async (command, options) => {
@@ -301,6 +316,9 @@ function createVercelSandbox(config = {}) {
   };
   return {
     exec,
+    get id() {
+      return sandboxId;
+    },
     async readFile(path) {
       const sbx = await ensureSandbox();
       const stream = await sbx.readFile({ path });

package/dist/sandbox/e2b.d.ts

@@ -1,6 +1,8 @@
 import type { Sandbox } from "./interface";
 export interface E2BSandboxConfig {
     apiKey?: string;
+    /** Existing sandbox ID to reconnect to instead of creating new */
+    sandboxId?: string;
     template?: string;
     timeout?: number;
     cwd?: string;

package/dist/sandbox/interface.d.ts

@@ -18,4 +18,11 @@ export interface Sandbox {
     fileExists(path: string): Promise<boolean>;
     isDirectory(path: string): Promise<boolean>;
     destroy(): Promise<void>;
+    /**
+     * Sandbox ID for reconnection (cloud providers only).
+     * - For new sandboxes: available after first operation
+     * - For reconnected sandboxes: available immediately
+     * - For local sandboxes: always undefined
+     */
+    readonly id?: string;
 }

package/dist/sandbox/vercel.d.ts

@@ -4,6 +4,8 @@ export interface VercelSandboxConfig {
     resources?: {
         vcpus: number;
     };
+    /** Existing sandbox ID to reconnect to instead of creating new */
+    sandboxId?: string;
     timeout?: number;
     cwd?: string;
     teamId?: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bashkit",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "description": "Agentic coding tools for the Vercel AI SDK",
   "type": "module",
   "main": "./dist/index.js",