@computesdk/e2b 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 computesdk
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,242 @@
+# @computesdk/e2b
+
+E2B provider for ComputeSDK - Execute Python code in secure, isolated E2B sandboxes.
+
+## Installation
+
+```bash
+npm install @computesdk/e2b
+```
+
+## Setup
+
+1. Get your E2B API key from [e2b.dev](https://e2b.dev/)
+2. Set the environment variable:
+
+```bash
+export E2B_API_KEY=e2b_your_api_key_here
+```
+
+## Usage
+
+### Basic Usage
+
+```typescript
+import { e2b } from '@computesdk/e2b';
+
+const provider = e2b();
+
+// Execute Python code
+const result = await provider.doExecute('print("Hello from E2B!")');
+console.log(result.stdout); // "Hello from E2B!"
+```
+
+### With ComputeSDK
+
+```typescript
+import { executeSandbox } from 'computesdk';
+import { e2b } from '@computesdk/e2b';
+
+const result = await executeSandbox({
+  sandbox: e2b(),
+  code: 'print("Hello World")',
+  runtime: 'python'
+});
+```
+
+### Configuration
+
+```typescript
+import { e2b } from '@computesdk/e2b';
+
+const provider = e2b({
+  timeout: 300000,  // 5 minutes (default)
+  runtime: 'python' // Only Python is supported
+});
+```
+
+## API Reference
+
+### `e2b(config?: SandboxConfig)`
+
+Creates a new E2B provider instance.
+
+#### Parameters
+
+- `config` (optional): Configuration object
+  - `timeout`: Execution timeout in milliseconds (default: 300000)
+  - `runtime`: Runtime environment - only `'python'` is supported
+
+#### Returns
+
+`E2BProvider` instance implementing the `ComputeSpecification` interface.
+
+### Provider Methods
+
+#### `doExecute(code: string, runtime?: Runtime): Promise<ExecutionResult>`
+
+Execute Python code in the E2B sandbox.
+
+```typescript
+const result = await provider.doExecute('x = 1 + 1\nprint(x)');
+// result.stdout: "2"
+// result.stderr: ""
+// result.exitCode: 0
+```
+
+#### `doKill(): Promise<void>`
+
+Terminates the E2B sandbox session.
+
+```typescript
+await provider.doKill();
+```
+
+#### `doGetInfo(): Promise<SandboxInfo>`
+
+Get information about the sandbox.
+
+```typescript
+const info = await provider.doGetInfo();
+// info.provider: "e2b"
+// info.runtime: "python"
+// info.status: "running" | "stopped"
+```
+
+## Error Handling
+
+The provider includes comprehensive error handling:
+
+### Authentication Errors
+
+```typescript
+// Missing API key
+Error: Missing E2B API key. Set E2B_API_KEY environment variable. Get your API key from https://e2b.dev/
+
+// Invalid API key format
+Error: Invalid E2B API key format. E2B API keys should start with 'e2b_'. Check your E2B_API_KEY environment variable.
+
+// Authentication failed
+Error: E2B authentication failed. Please check your E2B_API_KEY environment variable. Get your API key from https://e2b.dev/
+```
+
+### Runtime Errors
+
+```typescript
+// Unsupported runtime
+Error: E2B provider currently only supports Python runtime
+
+// Execution timeout
+Error: E2B execution timeout (300000ms). Consider increasing the timeout or optimizing your code.
+
+// Memory limits
+Error: E2B execution failed due to memory limits. Consider optimizing your code or using smaller data sets.
+```
+
+### Quota Errors
+
+```typescript
+// Quota exceeded
+Error: E2B quota exceeded. Please check your usage at https://e2b.dev/
+```
+
+## Examples
+
+### Data Analysis
+
+```typescript
+import { e2b } from '@computesdk/e2b';
+
+const provider = e2b();
+
+const code = `
+import pandas as pd
+import numpy as np
+
+# Create sample data
+data = {'A': [1, 2, 3], 'B': [4, 5, 6]}
+df = pd.DataFrame(data)
+
+print("DataFrame:")
+print(df)
+print(f"Sum of column A: {df['A'].sum()}")
+`;
+
+const result = await provider.doExecute(code);
+console.log(result.stdout);
+```
+
+### Machine Learning
+
+```typescript
+import { e2b } from '@computesdk/e2b';
+
+const provider = e2b();
+
+const code = `
+from sklearn.linear_model import LinearRegression
+import numpy as np
+
+# Sample data
+X = np.array([[1], [2], [3], [4]])
+y = np.array([2, 4, 6, 8])
+
+# Train model
+model = LinearRegression()
+model.fit(X, y)
+
+# Make prediction
+prediction = model.predict([[5]])
+print(f"Prediction for x=5: {prediction[0]}")
+`;
+
+const result = await provider.doExecute(code);
+console.log(result.stdout); // "Prediction for x=5: 10.0"
+```
+
+### File Operations
+
+```typescript
+import { e2b } from '@computesdk/e2b';
+
+const provider = e2b();
+
+const code = `
+# Write to file
+with open('data.txt', 'w') as f:
+    f.write('Hello from E2B sandbox!')
+
+# Read from file
+with open('data.txt', 'r') as f:
+    content = f.read()
+    print(f"File content: {content}")
+`;
+
+const result = await provider.doExecute(code);
+console.log(result.stdout);
+```
+
+## Limitations
+
+- **Python Only**: E2B provider currently only supports Python runtime
+- **Timeout**: Default 5-minute execution timeout
+- **Memory**: Subject to E2B sandbox memory limits
+- **Network**: Limited network access in sandboxes
+
+## Best Practices
+
+1. **Always handle errors**: Use try-catch blocks for robust error handling
+2. **Set appropriate timeouts**: Adjust timeout based on your use case
+3. **Clean up resources**: Call `doKill()` when done to free resources
+4. **Monitor usage**: Keep track of your E2B API usage and quotas
+5. **Optimize code**: Write efficient Python code to avoid timeout/memory issues
+
+## Support
+
+- E2B Documentation: [e2b.dev/docs](https://e2b.dev/docs)
+- ComputeSDK Issues: [GitHub Issues](https://github.com/computesdk/computesdk/issues)
+- E2B Support: [E2B Support](https://e2b.dev/support)
+
+## License
+
+MIT

package/dist/index.d.mts

@@ -0,0 +1,19 @@
+import { ComputeSpecification, SandboxConfig, Runtime, ExecutionResult, SandboxInfo } from 'computesdk';
+
+declare class E2BProvider implements ComputeSpecification {
+    readonly specificationVersion: "v1";
+    readonly provider = "e2b";
+    readonly sandboxId: string;
+    private session;
+    private readonly apiKey;
+    private readonly runtime;
+    private readonly timeout;
+    constructor(config: SandboxConfig);
+    private ensureSession;
+    doExecute(code: string, runtime?: Runtime): Promise<ExecutionResult>;
+    doKill(): Promise<void>;
+    doGetInfo(): Promise<SandboxInfo>;
+}
+declare function e2b(config?: Partial<SandboxConfig>): E2BProvider;
+
+export { E2BProvider, e2b };

package/dist/index.d.ts

@@ -0,0 +1,19 @@
+import { ComputeSpecification, SandboxConfig, Runtime, ExecutionResult, SandboxInfo } from 'computesdk';
+
+declare class E2BProvider implements ComputeSpecification {
+    readonly specificationVersion: "v1";
+    readonly provider = "e2b";
+    readonly sandboxId: string;
+    private session;
+    private readonly apiKey;
+    private readonly runtime;
+    private readonly timeout;
+    constructor(config: SandboxConfig);
+    private ensureSession;
+    doExecute(code: string, runtime?: Runtime): Promise<ExecutionResult>;
+    doKill(): Promise<void>;
+    doGetInfo(): Promise<SandboxInfo>;
+}
+declare function e2b(config?: Partial<SandboxConfig>): E2BProvider;
+
+export { E2BProvider, e2b };

package/dist/index.js

@@ -0,0 +1,149 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  E2BProvider: () => E2BProvider,
+  e2b: () => e2b
+});
+module.exports = __toCommonJS(index_exports);
+var import_code_interpreter = require("@e2b/code-interpreter");
+var E2BProvider = class {
+  constructor(config) {
+    this.specificationVersion = "v1";
+    this.provider = "e2b";
+    this.session = null;
+    this.sandboxId = `e2b-${Date.now()}-${Math.random().toString(36).substring(7)}`;
+    this.timeout = config.timeout || 3e5;
+    this.apiKey = process.env.E2B_API_KEY || "";
+    if (!this.apiKey) {
+      throw new Error(
+        `Missing E2B API key. Set E2B_API_KEY environment variable. Get your API key from https://e2b.dev/`
+      );
+    }
+    if (!this.apiKey.startsWith("e2b_")) {
+      throw new Error(
+        `Invalid E2B API key format. E2B API keys should start with 'e2b_'. Check your E2B_API_KEY environment variable.`
+      );
+    }
+    this.runtime = config.runtime || "python";
+  }
+  async ensureSession() {
+    if (this.session) {
+      return this.session;
+    }
+    try {
+      this.session = await import_code_interpreter.Sandbox.create({
+        apiKey: this.apiKey,
+        timeoutMs: this.timeout
+      });
+      return this.session;
+    } catch (error) {
+      if (error instanceof Error) {
+        if (error.message.includes("unauthorized") || error.message.includes("API key")) {
+          throw new Error(
+            `E2B authentication failed. Please check your E2B_API_KEY environment variable. Get your API key from https://e2b.dev/`
+          );
+        }
+        if (error.message.includes("quota") || error.message.includes("limit")) {
+          throw new Error(
+            `E2B quota exceeded. Please check your usage at https://e2b.dev/`
+          );
+        }
+      }
+      throw new Error(
+        `Failed to initialize E2B session: ${error instanceof Error ? error.message : String(error)}`
+      );
+    }
+  }
+  async doExecute(code, runtime) {
+    const startTime = Date.now();
+    try {
+      const session = await this.ensureSession();
+      const execution = await session.runCode(code);
+      return {
+        stdout: execution.logs.stdout.join("\n"),
+        stderr: execution.logs.stderr.join("\n"),
+        exitCode: execution.error ? 1 : 0,
+        executionTime: Date.now() - startTime,
+        sandboxId: this.sandboxId,
+        provider: this.provider
+      };
+    } catch (error) {
+      if (error instanceof Error) {
+        if (error.message.includes("timeout")) {
+          throw new Error(
+            `E2B execution timeout (${this.timeout}ms). Consider increasing the timeout or optimizing your code.`
+          );
+        }
+        if (error.message.includes("memory") || error.message.includes("Memory")) {
+          throw new Error(
+            `E2B execution failed due to memory limits. Consider optimizing your code or using smaller data sets.`
+          );
+        }
+      }
+      throw new Error(
+        `E2B execution failed: ${error instanceof Error ? error.message : String(error)}`
+      );
+    }
+  }
+  async doKill() {
+    if (!this.session) {
+      return;
+    }
+    try {
+      await this.session.kill();
+      this.session = null;
+    } catch (error) {
+      throw new Error(
+        `Failed to kill E2B session: ${error instanceof Error ? error.message : String(error)}`
+      );
+    }
+  }
+  async doGetInfo() {
+    await this.ensureSession();
+    return {
+      id: this.sandboxId,
+      provider: this.provider,
+      runtime: this.runtime,
+      status: this.session ? "running" : "stopped",
+      createdAt: /* @__PURE__ */ new Date(),
+      timeout: this.timeout,
+      metadata: {
+        e2bSessionId: this.sandboxId
+      }
+    };
+  }
+};
+function e2b(config) {
+  const fullConfig = {
+    provider: "e2b",
+    runtime: "python",
+    timeout: 3e5,
+    ...config
+  };
+  return new E2BProvider(fullConfig);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  E2BProvider,
+  e2b
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import { Sandbox as E2BSandbox } from '@e2b/code-interpreter';\nimport type {\n  ComputeSpecification,\n  ExecutionResult,\n  Runtime,\n  SandboxInfo,\n  SandboxConfig,\n} from 'computesdk';\n\nexport class E2BProvider implements ComputeSpecification {\n  public readonly specificationVersion = 'v1' as const;\n  public readonly provider = 'e2b';\n  public readonly sandboxId: string;\n\n  private session: E2BSandbox | null = null;\n  private readonly apiKey: string;\n  private readonly runtime: Runtime;\n  private readonly timeout: number;\n\n  constructor(config: SandboxConfig) {\n    this.sandboxId = `e2b-${Date.now()}-${Math.random().toString(36).substring(7)}`;\n    this.timeout = config.timeout || 300000;\n\n    // Get API key from environment\n    this.apiKey = process.env.E2B_API_KEY || '';\n\n    if (!this.apiKey) {\n      throw new Error(\n        `Missing E2B API key. Set E2B_API_KEY environment variable. Get your API key from https://e2b.dev/`\n      );\n    }\n\n    // Validate API key format\n    if (!this.apiKey.startsWith('e2b_')) {\n      throw new Error(\n        `Invalid E2B API key format. E2B API keys should start with 'e2b_'. Check your E2B_API_KEY environment variable.`\n      );\n    }\n\n    this.runtime = config.runtime || 'python';\n  }\n\n  private async ensureSession(): Promise<E2BSandbox> {\n    if (this.session) {\n      return this.session;\n    }\n\n    try {\n      // Create new E2B session with configuration\n      this.session = await E2BSandbox.create({\n        apiKey: this.apiKey,\n        timeoutMs: this.timeout,\n      });\n\n      return this.session;\n    } catch (error) {\n      if (error instanceof Error) {\n        if (error.message.includes('unauthorized') || error.message.includes('API key')) {\n          throw new Error(\n            `E2B authentication failed. Please check your E2B_API_KEY environment variable. Get your API key from https://e2b.dev/`\n          );\n        }\n        if (error.message.includes('quota') || error.message.includes('limit')) {\n          throw new Error(\n            `E2B quota exceeded. Please check your usage at https://e2b.dev/`\n          );\n        }\n      }\n      throw new Error(\n        `Failed to initialize E2B session: ${error instanceof Error ? error.message : String(error)}`\n      );\n    }\n  }\n\n  async doExecute(code: string, runtime?: Runtime): Promise<ExecutionResult> {\n    const startTime = Date.now();\n\n    try {\n      const session = await this.ensureSession();\n\n      // Execute code using E2B's runCode API\n      const execution = await session.runCode(code);\n\n      return {\n        stdout: execution.logs.stdout.join('\\n'),\n        stderr: execution.logs.stderr.join('\\n'),\n        exitCode: execution.error ? 1 : 0,\n        executionTime: Date.now() - startTime,\n        sandboxId: this.sandboxId,\n        provider: this.provider\n      };\n    } catch (error) {\n      if (error instanceof Error) {\n        if (error.message.includes('timeout')) {\n          throw new Error(\n            `E2B execution timeout (${this.timeout}ms). Consider increasing the timeout or optimizing your code.`\n          );\n        }\n        if (error.message.includes('memory') || error.message.includes('Memory')) {\n          throw new Error(\n            `E2B execution failed due to memory limits. Consider optimizing your code or using smaller data sets.`\n          );\n        }\n      }\n      throw new Error(\n        `E2B execution failed: ${error instanceof Error ? error.message : String(error)}`\n      );\n    }\n  }\n\n  async doKill(): Promise<void> {\n    if (!this.session) {\n      return;\n    }\n\n    try {\n      await this.session.kill();\n      this.session = null;\n    } catch (error) {\n      throw new Error(\n        `Failed to kill E2B session: ${error instanceof Error ? error.message : String(error)}`\n      );\n    }\n  }\n\n  async doGetInfo(): Promise<SandboxInfo> {\n    await this.ensureSession();\n\n    return {\n      id: this.sandboxId,\n      provider: this.provider,\n      runtime: this.runtime,\n      status: this.session ? 'running' : 'stopped',\n      createdAt: new Date(),\n      timeout: this.timeout,\n      metadata: {\n        e2bSessionId: this.sandboxId\n      }\n    };\n  }\n}\n\nexport function e2b(config?: Partial<SandboxConfig>): E2BProvider {\n  const fullConfig: SandboxConfig = {\n    provider: 'e2b',\n    runtime: 'python',\n    timeout: 300000,\n    ...config\n  };\n\n  return new E2BProvider(fullConfig);\n}\n"],"mappings":"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","names":["E2BSandbox"]}

package/dist/index.mjs

@@ -0,0 +1,123 @@
+// src/index.ts
+import { Sandbox as E2BSandbox } from "@e2b/code-interpreter";
+var E2BProvider = class {
+  constructor(config) {
+    this.specificationVersion = "v1";
+    this.provider = "e2b";
+    this.session = null;
+    this.sandboxId = `e2b-${Date.now()}-${Math.random().toString(36).substring(7)}`;
+    this.timeout = config.timeout || 3e5;
+    this.apiKey = process.env.E2B_API_KEY || "";
+    if (!this.apiKey) {
+      throw new Error(
+        `Missing E2B API key. Set E2B_API_KEY environment variable. Get your API key from https://e2b.dev/`
+      );
+    }
+    if (!this.apiKey.startsWith("e2b_")) {
+      throw new Error(
+        `Invalid E2B API key format. E2B API keys should start with 'e2b_'. Check your E2B_API_KEY environment variable.`
+      );
+    }
+    this.runtime = config.runtime || "python";
+  }
+  async ensureSession() {
+    if (this.session) {
+      return this.session;
+    }
+    try {
+      this.session = await E2BSandbox.create({
+        apiKey: this.apiKey,
+        timeoutMs: this.timeout
+      });
+      return this.session;
+    } catch (error) {
+      if (error instanceof Error) {
+        if (error.message.includes("unauthorized") || error.message.includes("API key")) {
+          throw new Error(
+            `E2B authentication failed. Please check your E2B_API_KEY environment variable. Get your API key from https://e2b.dev/`
+          );
+        }
+        if (error.message.includes("quota") || error.message.includes("limit")) {
+          throw new Error(
+            `E2B quota exceeded. Please check your usage at https://e2b.dev/`
+          );
+        }
+      }
+      throw new Error(
+        `Failed to initialize E2B session: ${error instanceof Error ? error.message : String(error)}`
+      );
+    }
+  }
+  async doExecute(code, runtime) {
+    const startTime = Date.now();
+    try {
+      const session = await this.ensureSession();
+      const execution = await session.runCode(code);
+      return {
+        stdout: execution.logs.stdout.join("\n"),
+        stderr: execution.logs.stderr.join("\n"),
+        exitCode: execution.error ? 1 : 0,
+        executionTime: Date.now() - startTime,
+        sandboxId: this.sandboxId,
+        provider: this.provider
+      };
+    } catch (error) {
+      if (error instanceof Error) {
+        if (error.message.includes("timeout")) {
+          throw new Error(
+            `E2B execution timeout (${this.timeout}ms). Consider increasing the timeout or optimizing your code.`
+          );
+        }
+        if (error.message.includes("memory") || error.message.includes("Memory")) {
+          throw new Error(
+            `E2B execution failed due to memory limits. Consider optimizing your code or using smaller data sets.`
+          );
+        }
+      }
+      throw new Error(
+        `E2B execution failed: ${error instanceof Error ? error.message : String(error)}`
+      );
+    }
+  }
+  async doKill() {
+    if (!this.session) {
+      return;
+    }
+    try {
+      await this.session.kill();
+      this.session = null;
+    } catch (error) {
+      throw new Error(
+        `Failed to kill E2B session: ${error instanceof Error ? error.message : String(error)}`
+      );
+    }
+  }
+  async doGetInfo() {
+    await this.ensureSession();
+    return {
+      id: this.sandboxId,
+      provider: this.provider,
+      runtime: this.runtime,
+      status: this.session ? "running" : "stopped",
+      createdAt: /* @__PURE__ */ new Date(),
+      timeout: this.timeout,
+      metadata: {
+        e2bSessionId: this.sandboxId
+      }
+    };
+  }
+};
+function e2b(config) {
+  const fullConfig = {
+    provider: "e2b",
+    runtime: "python",
+    timeout: 3e5,
+    ...config
+  };
+  return new E2BProvider(fullConfig);
+}
+export {
+  E2BProvider,
+  e2b
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import { Sandbox as E2BSandbox } from '@e2b/code-interpreter';\nimport type {\n  ComputeSpecification,\n  ExecutionResult,\n  Runtime,\n  SandboxInfo,\n  SandboxConfig,\n} from 'computesdk';\n\nexport class E2BProvider implements ComputeSpecification {\n  public readonly specificationVersion = 'v1' as const;\n  public readonly provider = 'e2b';\n  public readonly sandboxId: string;\n\n  private session: E2BSandbox | null = null;\n  private readonly apiKey: string;\n  private readonly runtime: Runtime;\n  private readonly timeout: number;\n\n  constructor(config: SandboxConfig) {\n    this.sandboxId = `e2b-${Date.now()}-${Math.random().toString(36).substring(7)}`;\n    this.timeout = config.timeout || 300000;\n\n    // Get API key from environment\n    this.apiKey = process.env.E2B_API_KEY || '';\n\n    if (!this.apiKey) {\n      throw new Error(\n        `Missing E2B API key. Set E2B_API_KEY environment variable. Get your API key from https://e2b.dev/`\n      );\n    }\n\n    // Validate API key format\n    if (!this.apiKey.startsWith('e2b_')) {\n      throw new Error(\n        `Invalid E2B API key format. E2B API keys should start with 'e2b_'. Check your E2B_API_KEY environment variable.`\n      );\n    }\n\n    this.runtime = config.runtime || 'python';\n  }\n\n  private async ensureSession(): Promise<E2BSandbox> {\n    if (this.session) {\n      return this.session;\n    }\n\n    try {\n      // Create new E2B session with configuration\n      this.session = await E2BSandbox.create({\n        apiKey: this.apiKey,\n        timeoutMs: this.timeout,\n      });\n\n      return this.session;\n    } catch (error) {\n      if (error instanceof Error) {\n        if (error.message.includes('unauthorized') || error.message.includes('API key')) {\n          throw new Error(\n            `E2B authentication failed. Please check your E2B_API_KEY environment variable. Get your API key from https://e2b.dev/`\n          );\n        }\n        if (error.message.includes('quota') || error.message.includes('limit')) {\n          throw new Error(\n            `E2B quota exceeded. Please check your usage at https://e2b.dev/`\n          );\n        }\n      }\n      throw new Error(\n        `Failed to initialize E2B session: ${error instanceof Error ? error.message : String(error)}`\n      );\n    }\n  }\n\n  async doExecute(code: string, runtime?: Runtime): Promise<ExecutionResult> {\n    const startTime = Date.now();\n\n    try {\n      const session = await this.ensureSession();\n\n      // Execute code using E2B's runCode API\n      const execution = await session.runCode(code);\n\n      return {\n        stdout: execution.logs.stdout.join('\\n'),\n        stderr: execution.logs.stderr.join('\\n'),\n        exitCode: execution.error ? 1 : 0,\n        executionTime: Date.now() - startTime,\n        sandboxId: this.sandboxId,\n        provider: this.provider\n      };\n    } catch (error) {\n      if (error instanceof Error) {\n        if (error.message.includes('timeout')) {\n          throw new Error(\n            `E2B execution timeout (${this.timeout}ms). Consider increasing the timeout or optimizing your code.`\n          );\n        }\n        if (error.message.includes('memory') || error.message.includes('Memory')) {\n          throw new Error(\n            `E2B execution failed due to memory limits. Consider optimizing your code or using smaller data sets.`\n          );\n        }\n      }\n      throw new Error(\n        `E2B execution failed: ${error instanceof Error ? error.message : String(error)}`\n      );\n    }\n  }\n\n  async doKill(): Promise<void> {\n    if (!this.session) {\n      return;\n    }\n\n    try {\n      await this.session.kill();\n      this.session = null;\n    } catch (error) {\n      throw new Error(\n        `Failed to kill E2B session: ${error instanceof Error ? error.message : String(error)}`\n      );\n    }\n  }\n\n  async doGetInfo(): Promise<SandboxInfo> {\n    await this.ensureSession();\n\n    return {\n      id: this.sandboxId,\n      provider: this.provider,\n      runtime: this.runtime,\n      status: this.session ? 'running' : 'stopped',\n      createdAt: new Date(),\n      timeout: this.timeout,\n      metadata: {\n        e2bSessionId: this.sandboxId\n      }\n    };\n  }\n}\n\nexport function e2b(config?: Partial<SandboxConfig>): E2BProvider {\n  const fullConfig: SandboxConfig = {\n    provider: 'e2b',\n    runtime: 'python',\n    timeout: 300000,\n    ...config\n  };\n\n  return new E2BProvider(fullConfig);\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "@computesdk/e2b",
+  "version": "1.0.0",
+  "description": "E2B provider for ComputeSDK",
+  "author": "Garrison",
+  "license": "MIT",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@e2b/code-interpreter": "^1.5.1"
+  },
+  "peerDependencies": {
+    "computesdk": "1.0.0"
+  },
+  "keywords": [
+    "e2b",
+    "sandbox",
+    "code-execution",
+    "python",
+    "cloud",
+    "compute"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/computesdk/computesdk.git",
+    "directory": "packages/e2b"
+  },
+  "homepage": "https://github.com/computesdk/computesdk/tree/main/packages/e2b",
+  "bugs": {
+    "url": "https://github.com/computesdk/computesdk/issues"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "@vitest/coverage-v8": "^1.0.0",
+    "eslint": "^8.37.0",
+    "rimraf": "^5.0.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.0.0",
+    "vitest": "^1.0.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "clean": "rimraf dist",
+    "dev": "tsup --watch",
+    "test": "vitest",
+    "test:watch": "vitest watch",
+    "test:coverage": "vitest run --coverage",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint ."
+  }
+}