@evolvingmachines/e2b 0.0.2

package/LICENSE

@@ -0,0 +1,24 @@
+EVOLVE SDK PROPRIETARY SOFTWARE LICENSE
+
+Copyright (c) 2026 Swarmlink, Inc. All rights reserved.
+
+BETA EVALUATION LICENSE
+
+The Evolve SDK is provided for evaluation and beta testing purposes only.
+
+PERMITTED:
+- Install Evolve SDK via npm/PyPI for evaluation and development
+- Build applications using the Evolve SDK during the beta period
+- Deploy applications using the Evolve SDK to production
+
+PROHIBITED:
+- Redistribute the Evolve SDK itself
+- Reverse engineer, decompile, or extract source code from the SDK
+- Create derivative works of the Evolve SDK
+- Use Evolve SDK in competing products or services
+
+NO WARRANTY. THIS SOFTWARE IS PROVIDED "AS IS" FOR BETA EVALUATION.
+
+This license may be revised upon general availability.
+
+For licensing inquiries, contact: brandomagnani@evolvingmachines.ai

package/README.md

@@ -0,0 +1,19 @@
+# Evolve SDK E2B Provider
+
+E2B sandbox provider for [Evolve SDK](https://www.npmjs.com/package/@evolvingmachines/sdk).
+
+**Note:** This package is automatically installed as a dependency of `@evolvingmachines/sdk`. You don't need to install it separately.
+
+Check out the [official documentation](https://github.com/evolving-machines-lab/evolve/tree/main/docs) and [cookbooks](https://github.com/evolving-machines-lab/evolve/tree/main/cookbooks).
+
+## Reporting Bugs
+
+We welcome your feedback. File a [GitHub issue](https://github.com/evolving-machines-lab/evolve/issues) to report bugs or request features.
+
+## Connect on Discord
+
+Join the [Evolve SDK Developers Discord](https://discord.gg/Q36D8dGyNF) to connect with other developers using Evolve SDK. Get help, share feedback, and discuss your projects with the community.
+
+## License
+
+See [LICENSE](https://github.com/evolving-machines-lab/evolve/blob/main/LICENSE) for details.

package/dist/index.cjs

@@ -0,0 +1,2 @@
+'use strict';var codeInterpreter=require('@e2b/code-interpreter');var b=new Set([".xlsx",".xls",".docx",".doc",".pptx",".ppt",".pdf",".zip",".tar",".gz",".7z",".rar",".png",".jpg",".jpeg",".gif",".webp",".ico",".bmp",".mp3",".wav",".ogg",".flac",".aac",".mp4",".avi",".mov",".mkv",".webm",".woff",".woff2",".ttf",".otf",".eot",".exe",".dll",".so",".dylib",".sqlite",".db",".pickle",".pkl",".parquet"]);function a(i){return i instanceof Date?i.toISOString():String(i)}function l(i){if(typeof i=="string"||i instanceof ArrayBuffer)return i;if(i instanceof Buffer)return new Uint8Array(i).buffer;if(i instanceof Uint8Array)return new Uint8Array(i).buffer;throw new Error(`Unsupported data type for file upload: ${typeof i}. Expected string, Buffer, ArrayBuffer, or Uint8Array.`)}function x(i){let t=i.substring(i.lastIndexOf(".")).toLowerCase();return b.has(t)}var m=class{constructor(t){this.sandbox=t;}async run(t,e){try{let n=await this.sandbox.commands.run(t,{timeoutMs:e?.timeoutMs,envs:e?.envs,cwd:e?.cwd,onStdout:e?.onStdout,onStderr:e?.onStderr});return {exitCode:n.exitCode,stdout:n.stdout,stderr:n.stderr}}catch(n){if(n&&typeof n=="object"&&"exitCode"in n){let r=n;return {exitCode:r.exitCode,stdout:r.stdout??"",stderr:r.stderr??""}}throw n}}async spawn(t,e){let n=await this.sandbox.commands.run(t,{background:true,stdin:e?.stdin??true,timeoutMs:e?.timeoutMs,envs:e?.envs,cwd:e?.cwd,onStdout:e?.onStdout,onStderr:e?.onStderr});return {pid:n.pid,wait:async()=>{try{let r=await n.wait();return {exitCode:r.exitCode,stdout:r.stdout,stderr:r.stderr}}catch(r){if(r&&typeof r=="object"&&"exitCode"in r){let s=r;return {exitCode:s.exitCode,stdout:s.stdout??"",stderr:s.stderr??""}}throw r}},kill:()=>this.sandbox.commands.kill(n.pid)}}async list(){return this.sandbox.commands.list()}async connect(t,e){let n=await this.sandbox.commands.connect(t,{onStdout:e?.onStdout,onStderr:e?.onStderr,timeoutMs:e?.timeoutMs});return {pid:n.pid,wait:async()=>{try{let r=await n.wait();return {exitCode:r.exitCode,stdout:r.stdout,stderr:r.stderr}}catch(r){if(r&&typeof r=="object"&&"exitCode"in r){let s=r;return {exitCode:s.exitCode,stdout:s.stdout??"",stderr:s.stderr??""}}throw r}},kill:()=>this.sandbox.commands.kill(n.pid)}}async sendStdin(t,e){await this.sandbox.commands.sendStdin(t,e);}async kill(t){return this.sandbox.commands.kill(t)}},u=class{constructor(t){this.sandbox=t;}async read(t){return x(t)?this.sandbox.files.read(t,{format:"bytes",requestTimeoutMs:3e5}):this.sandbox.files.read(t,{format:"text",requestTimeoutMs:3e5})}async write(t,e){await this.sandbox.files.write(t,l(e),{requestTimeoutMs:3e5});}async writeBatch(t){let e=t.map(n=>({path:n.path,data:l(n.data)}));await this.sandbox.files.write(e,{requestTimeoutMs:3e5});}async makeDir(t){await this.sandbox.files.makeDir(t);}async uploadUrl(t,e){return this.sandbox.uploadUrl(t,e?{useSignatureExpiration:e}:void 0)}async downloadUrl(t,e){return this.sandbox.downloadUrl(t,e?{useSignatureExpiration:e}:void 0)}async exists(t){return this.sandbox.files.exists(t)}async list(t){return (await this.sandbox.files.list(t)).map(n=>({name:n.name,path:n.path,type:n.type==="dir"?"dir":"file"}))}async remove(t){await this.sandbox.files.remove(t);}async rename(t,e){await this.sandbox.files.rename(t,e);}async readStream(t){return this.sandbox.files.read(t,{format:"stream"})}async writeStream(t,e){await this.sandbox.files.write(t,e);}async watchDir(t,e,n){let r=await this.sandbox.files.watchDir(t,e,{recursive:n?.recursive,timeoutMs:n?.timeoutMs,onExit:n?.onExit});return {stop:()=>r.stop()}}},o=class{constructor(t){this.sandbox=t;this.commands=new m(t),this.files=new u(t);}commands;files;get sandboxId(){return this.sandbox.sandboxId}getHost(t){return this.sandbox.getHost(t)}async isRunning(){return this.sandbox.isRunning()}async getInfo(){let t=await this.sandbox.getInfo();return {sandboxId:t.sandboxId,templateId:t.templateId,name:t.name,metadata:t.metadata??{},startedAt:a(t.startedAt),endAt:t.endAt?a(t.endAt):void 0}}async kill(){try{await this.sandbox.kill();}catch{await new Promise(t=>setTimeout(t,500)),await this.sandbox.kill();}}async pause(){await this.sandbox.betaPause();}},c=class{providerType="e2b";apiKey;defaultTimeoutMs;constructor(t){this.apiKey=t.apiKey,this.defaultTimeoutMs=t.defaultTimeoutMs??36e5;}async create(t){let e=t.timeoutMs??this.defaultTimeoutMs,n=await codeInterpreter.Sandbox.create(t.templateId,{apiKey:this.apiKey,envs:t.envs,metadata:t.metadata,timeoutMs:e});return t.workingDirectory&&await n.files.makeDir(t.workingDirectory),new o(n)}async connect(t,e){let n=await codeInterpreter.Sandbox.connect(t,{apiKey:this.apiKey,timeoutMs:e??this.defaultTimeoutMs});return new o(n)}async list(t){return (await codeInterpreter.Sandbox.list({apiKey:this.apiKey,query:{state:t?.state,metadata:t?.metadata},limit:t?.limit??100}).nextItems()).map(r=>({sandboxId:r.sandboxId,templateId:r.templateId,name:r.name,metadata:r.metadata??{},startedAt:a(r.startedAt),endAt:r.endAt?a(r.endAt):void 0}))}};function g(i={}){let t=i.apiKey??process.env.E2B_API_KEY;if(!t)throw new Error("E2B API key required. Set E2B_API_KEY environment variable or pass apiKey in config. Get your key at https://e2b.dev/sign-in");return new c({...i,apiKey:t})}
+exports.E2BSandboxProvider=c;exports.createE2BProvider=g;

package/dist/index.d.cts

@@ -0,0 +1,201 @@
+/**
+ * E2B Sandbox Provider - Clean Architecture
+ *
+ * @requires @e2b/code-interpreter >= 1.0.0 or e2b >= 1.0.0
+ * @requires Node.js >= 18 (for ReadableStream support)
+ *
+ * Design principles:
+ * - Single way to do things (no dual methods)
+ * - Options objects only (no positional args)
+ * - All interface methods required (no optional ?)
+ * - Configuration externalized (no hardcoded mappings)
+ * - Clear naming (run = blocking, spawn = background)
+ */
+/** Result of a completed sandbox command */
+interface SandboxCommandResult {
+    exitCode: number;
+    stdout: string;
+    stderr: string;
+}
+/** Handle to a running background process in sandbox */
+interface SandboxCommandHandle {
+    readonly pid: number;
+    wait(): Promise<SandboxCommandResult>;
+    kill(): Promise<boolean>;
+}
+/** Information about a running process */
+interface ProcessInfo {
+    pid: number;
+    cmd: string;
+    args: string[];
+    envs: Record<string, string>;
+    cwd?: string;
+    tag?: string;
+}
+/** Sandbox metadata and lifecycle info */
+interface SandboxInfo {
+    sandboxId: string;
+    templateId: string;
+    name?: string;
+    metadata: Record<string, string>;
+    startedAt: string;
+    /** End time (undefined for running sandboxes) */
+    endAt?: string;
+}
+/** File or directory entry info */
+interface FileInfo {
+    name: string;
+    path: string;
+    type: "file" | "dir";
+}
+/** Filesystem event from watchDir */
+interface FilesystemEvent {
+    /** Relative path to the changed file/directory */
+    name: string;
+    /** Type of filesystem operation */
+    type: "create" | "remove" | "rename" | "chmod" | "write";
+}
+/** Handle to stop watching a directory */
+interface WatchHandle {
+    stop(): Promise<void>;
+}
+/** Options for watching a directory */
+interface WatchOptions {
+    recursive?: boolean;
+    timeoutMs?: number;
+    onExit?: (err?: Error) => void | Promise<void>;
+}
+/** Options for blocking sandbox command execution */
+interface SandboxRunOptions {
+    timeoutMs?: number;
+    envs?: Record<string, string>;
+    cwd?: string;
+    onStdout?: (data: string) => void;
+    onStderr?: (data: string) => void;
+}
+/** Options for spawning background sandbox processes */
+interface SandboxSpawnOptions extends SandboxRunOptions {
+    stdin?: boolean;
+}
+/** Options for connecting to a running process */
+interface SandboxConnectOptions {
+    onStdout?: (data: string) => void;
+    onStderr?: (data: string) => void;
+    timeoutMs?: number;
+}
+/** Options for creating a sandbox */
+interface SandboxCreateOptions {
+    templateId: string;
+    envs?: Record<string, string>;
+    metadata?: Record<string, string>;
+    timeoutMs?: number;
+    workingDirectory?: string;
+}
+/** Options for listing sandboxes */
+interface SandboxListOptions {
+    state?: ("running" | "paused")[];
+    metadata?: Record<string, string>;
+    limit?: number;
+}
+/** Command execution capabilities */
+interface SandboxCommands {
+    /** Run command and wait for completion */
+    run(command: string, options?: SandboxRunOptions): Promise<SandboxCommandResult>;
+    /** Spawn background process, returns handle for control */
+    spawn(command: string, options?: SandboxSpawnOptions): Promise<SandboxCommandHandle>;
+    /** List running processes */
+    list(): Promise<ProcessInfo[]>;
+    /** Connect to existing process by PID */
+    connect(pid: number, options?: SandboxConnectOptions): Promise<SandboxCommandHandle>;
+    /** Send data to process stdin */
+    sendStdin(pid: number, data: string): Promise<void>;
+    /** Kill process by PID */
+    kill(pid: number): Promise<boolean>;
+}
+/** File system operations */
+interface SandboxFiles {
+    /** Read file (auto-detects binary by extension) */
+    read(path: string): Promise<string | Uint8Array>;
+    /** Write single file */
+    write(path: string, content: string | Buffer | ArrayBuffer | Uint8Array): Promise<void>;
+    /** Write multiple files in batch */
+    writeBatch(files: Array<{
+        path: string;
+        data: string | Buffer | ArrayBuffer | Uint8Array;
+    }>): Promise<void>;
+    /** Read file as stream */
+    readStream(path: string): Promise<ReadableStream<Uint8Array>>;
+    /** Write from stream */
+    writeStream(path: string, stream: ReadableStream<Uint8Array>): Promise<void>;
+    /** Get pre-signed upload URL for large files (expiration in seconds) */
+    uploadUrl(path: string, expiresInSeconds?: number): Promise<string>;
+    /** Get pre-signed download URL for large files (expiration in seconds) */
+    downloadUrl(path: string, expiresInSeconds?: number): Promise<string>;
+    /** Create directory (recursive) */
+    makeDir(path: string): Promise<void>;
+    /** Check if file or directory exists */
+    exists(path: string): Promise<boolean>;
+    /** List directory contents */
+    list(path: string): Promise<FileInfo[]>;
+    /** Delete file or directory */
+    remove(path: string): Promise<void>;
+    /** Rename or move file/directory */
+    rename(oldPath: string, newPath: string): Promise<void>;
+    /** Watch directory for changes */
+    watchDir(path: string, onEvent: (event: FilesystemEvent) => void | Promise<void>, options?: WatchOptions): Promise<WatchHandle>;
+}
+/** Sandbox instance with full capabilities */
+interface SandboxInstance {
+    readonly sandboxId: string;
+    readonly commands: SandboxCommands;
+    readonly files: SandboxFiles;
+    /** Get public URL for port (sync) */
+    getHost(port: number): string;
+    /** Check if sandbox is running */
+    isRunning(): Promise<boolean>;
+    /** Get sandbox metadata and timing */
+    getInfo(): Promise<SandboxInfo>;
+    /** Terminate sandbox */
+    kill(): Promise<void>;
+    /** Pause sandbox (preserves state) */
+    pause(): Promise<void>;
+}
+/** Sandbox lifecycle management */
+interface SandboxProvider {
+    /** Provider type identifier */
+    readonly providerType: string;
+    /** Create new sandbox */
+    create(options: SandboxCreateOptions): Promise<SandboxInstance>;
+    /** Connect to existing sandbox */
+    connect(sandboxId: string, timeoutMs?: number): Promise<SandboxInstance>;
+    /** List sandboxes (first page only, up to limit) */
+    list(options?: SandboxListOptions): Promise<SandboxInfo[]>;
+}
+interface E2BConfig {
+    /** E2B API key. Default: reads from E2B_API_KEY env var */
+    apiKey?: string;
+    defaultTimeoutMs?: number;
+}
+/** Internal resolved config with required apiKey */
+interface ResolvedE2BConfig {
+    apiKey: string;
+    defaultTimeoutMs?: number;
+}
+declare class E2BSandboxProvider implements SandboxProvider {
+    readonly providerType: "e2b";
+    private readonly apiKey;
+    private readonly defaultTimeoutMs;
+    constructor(config: ResolvedE2BConfig);
+    create(options: SandboxCreateOptions): Promise<SandboxInstance>;
+    connect(sandboxId: string, timeoutMs?: number): Promise<SandboxInstance>;
+    list(options?: SandboxListOptions): Promise<SandboxInfo[]>;
+}
+/**
+ * Create E2B sandbox provider.
+ *
+ * @param config - Optional configuration. If apiKey not provided, reads from E2B_API_KEY env var.
+ * @throws Error if apiKey cannot be resolved
+ */
+declare function createE2BProvider(config?: E2BConfig): SandboxProvider;
+
+export { type E2BConfig, E2BSandboxProvider, type FileInfo, type FilesystemEvent, type ProcessInfo, type SandboxCommandHandle, type SandboxCommandResult, type SandboxCommands, type SandboxConnectOptions, type SandboxCreateOptions, type SandboxFiles, type SandboxInfo, type SandboxInstance, type SandboxListOptions, type SandboxProvider, type SandboxRunOptions, type SandboxSpawnOptions, type WatchHandle, type WatchOptions, createE2BProvider };

package/dist/index.d.ts

@@ -0,0 +1,201 @@
+/**
+ * E2B Sandbox Provider - Clean Architecture
+ *
+ * @requires @e2b/code-interpreter >= 1.0.0 or e2b >= 1.0.0
+ * @requires Node.js >= 18 (for ReadableStream support)
+ *
+ * Design principles:
+ * - Single way to do things (no dual methods)
+ * - Options objects only (no positional args)
+ * - All interface methods required (no optional ?)
+ * - Configuration externalized (no hardcoded mappings)
+ * - Clear naming (run = blocking, spawn = background)
+ */
+/** Result of a completed sandbox command */
+interface SandboxCommandResult {
+    exitCode: number;
+    stdout: string;
+    stderr: string;
+}
+/** Handle to a running background process in sandbox */
+interface SandboxCommandHandle {
+    readonly pid: number;
+    wait(): Promise<SandboxCommandResult>;
+    kill(): Promise<boolean>;
+}
+/** Information about a running process */
+interface ProcessInfo {
+    pid: number;
+    cmd: string;
+    args: string[];
+    envs: Record<string, string>;
+    cwd?: string;
+    tag?: string;
+}
+/** Sandbox metadata and lifecycle info */
+interface SandboxInfo {
+    sandboxId: string;
+    templateId: string;
+    name?: string;
+    metadata: Record<string, string>;
+    startedAt: string;
+    /** End time (undefined for running sandboxes) */
+    endAt?: string;
+}
+/** File or directory entry info */
+interface FileInfo {
+    name: string;
+    path: string;
+    type: "file" | "dir";
+}
+/** Filesystem event from watchDir */
+interface FilesystemEvent {
+    /** Relative path to the changed file/directory */
+    name: string;
+    /** Type of filesystem operation */
+    type: "create" | "remove" | "rename" | "chmod" | "write";
+}
+/** Handle to stop watching a directory */
+interface WatchHandle {
+    stop(): Promise<void>;
+}
+/** Options for watching a directory */
+interface WatchOptions {
+    recursive?: boolean;
+    timeoutMs?: number;
+    onExit?: (err?: Error) => void | Promise<void>;
+}
+/** Options for blocking sandbox command execution */
+interface SandboxRunOptions {
+    timeoutMs?: number;
+    envs?: Record<string, string>;
+    cwd?: string;
+    onStdout?: (data: string) => void;
+    onStderr?: (data: string) => void;
+}
+/** Options for spawning background sandbox processes */
+interface SandboxSpawnOptions extends SandboxRunOptions {
+    stdin?: boolean;
+}
+/** Options for connecting to a running process */
+interface SandboxConnectOptions {
+    onStdout?: (data: string) => void;
+    onStderr?: (data: string) => void;
+    timeoutMs?: number;
+}
+/** Options for creating a sandbox */
+interface SandboxCreateOptions {
+    templateId: string;
+    envs?: Record<string, string>;
+    metadata?: Record<string, string>;
+    timeoutMs?: number;
+    workingDirectory?: string;
+}
+/** Options for listing sandboxes */
+interface SandboxListOptions {
+    state?: ("running" | "paused")[];
+    metadata?: Record<string, string>;
+    limit?: number;
+}
+/** Command execution capabilities */
+interface SandboxCommands {
+    /** Run command and wait for completion */
+    run(command: string, options?: SandboxRunOptions): Promise<SandboxCommandResult>;
+    /** Spawn background process, returns handle for control */
+    spawn(command: string, options?: SandboxSpawnOptions): Promise<SandboxCommandHandle>;
+    /** List running processes */
+    list(): Promise<ProcessInfo[]>;
+    /** Connect to existing process by PID */
+    connect(pid: number, options?: SandboxConnectOptions): Promise<SandboxCommandHandle>;
+    /** Send data to process stdin */
+    sendStdin(pid: number, data: string): Promise<void>;
+    /** Kill process by PID */
+    kill(pid: number): Promise<boolean>;
+}
+/** File system operations */
+interface SandboxFiles {
+    /** Read file (auto-detects binary by extension) */
+    read(path: string): Promise<string | Uint8Array>;
+    /** Write single file */
+    write(path: string, content: string | Buffer | ArrayBuffer | Uint8Array): Promise<void>;
+    /** Write multiple files in batch */
+    writeBatch(files: Array<{
+        path: string;
+        data: string | Buffer | ArrayBuffer | Uint8Array;
+    }>): Promise<void>;
+    /** Read file as stream */
+    readStream(path: string): Promise<ReadableStream<Uint8Array>>;
+    /** Write from stream */
+    writeStream(path: string, stream: ReadableStream<Uint8Array>): Promise<void>;
+    /** Get pre-signed upload URL for large files (expiration in seconds) */
+    uploadUrl(path: string, expiresInSeconds?: number): Promise<string>;
+    /** Get pre-signed download URL for large files (expiration in seconds) */
+    downloadUrl(path: string, expiresInSeconds?: number): Promise<string>;
+    /** Create directory (recursive) */
+    makeDir(path: string): Promise<void>;
+    /** Check if file or directory exists */
+    exists(path: string): Promise<boolean>;
+    /** List directory contents */
+    list(path: string): Promise<FileInfo[]>;
+    /** Delete file or directory */
+    remove(path: string): Promise<void>;
+    /** Rename or move file/directory */
+    rename(oldPath: string, newPath: string): Promise<void>;
+    /** Watch directory for changes */
+    watchDir(path: string, onEvent: (event: FilesystemEvent) => void | Promise<void>, options?: WatchOptions): Promise<WatchHandle>;
+}
+/** Sandbox instance with full capabilities */
+interface SandboxInstance {
+    readonly sandboxId: string;
+    readonly commands: SandboxCommands;
+    readonly files: SandboxFiles;
+    /** Get public URL for port (sync) */
+    getHost(port: number): string;
+    /** Check if sandbox is running */
+    isRunning(): Promise<boolean>;
+    /** Get sandbox metadata and timing */
+    getInfo(): Promise<SandboxInfo>;
+    /** Terminate sandbox */
+    kill(): Promise<void>;
+    /** Pause sandbox (preserves state) */
+    pause(): Promise<void>;
+}
+/** Sandbox lifecycle management */
+interface SandboxProvider {
+    /** Provider type identifier */
+    readonly providerType: string;
+    /** Create new sandbox */
+    create(options: SandboxCreateOptions): Promise<SandboxInstance>;
+    /** Connect to existing sandbox */
+    connect(sandboxId: string, timeoutMs?: number): Promise<SandboxInstance>;
+    /** List sandboxes (first page only, up to limit) */
+    list(options?: SandboxListOptions): Promise<SandboxInfo[]>;
+}
+interface E2BConfig {
+    /** E2B API key. Default: reads from E2B_API_KEY env var */
+    apiKey?: string;
+    defaultTimeoutMs?: number;
+}
+/** Internal resolved config with required apiKey */
+interface ResolvedE2BConfig {
+    apiKey: string;
+    defaultTimeoutMs?: number;
+}
+declare class E2BSandboxProvider implements SandboxProvider {
+    readonly providerType: "e2b";
+    private readonly apiKey;
+    private readonly defaultTimeoutMs;
+    constructor(config: ResolvedE2BConfig);
+    create(options: SandboxCreateOptions): Promise<SandboxInstance>;
+    connect(sandboxId: string, timeoutMs?: number): Promise<SandboxInstance>;
+    list(options?: SandboxListOptions): Promise<SandboxInfo[]>;
+}
+/**
+ * Create E2B sandbox provider.
+ *
+ * @param config - Optional configuration. If apiKey not provided, reads from E2B_API_KEY env var.
+ * @throws Error if apiKey cannot be resolved
+ */
+declare function createE2BProvider(config?: E2BConfig): SandboxProvider;
+
+export { type E2BConfig, E2BSandboxProvider, type FileInfo, type FilesystemEvent, type ProcessInfo, type SandboxCommandHandle, type SandboxCommandResult, type SandboxCommands, type SandboxConnectOptions, type SandboxCreateOptions, type SandboxFiles, type SandboxInfo, type SandboxInstance, type SandboxListOptions, type SandboxProvider, type SandboxRunOptions, type SandboxSpawnOptions, type WatchHandle, type WatchOptions, createE2BProvider };

package/dist/index.js

@@ -0,0 +1,2 @@
+import {Sandbox}from'@e2b/code-interpreter';var b=new Set([".xlsx",".xls",".docx",".doc",".pptx",".ppt",".pdf",".zip",".tar",".gz",".7z",".rar",".png",".jpg",".jpeg",".gif",".webp",".ico",".bmp",".mp3",".wav",".ogg",".flac",".aac",".mp4",".avi",".mov",".mkv",".webm",".woff",".woff2",".ttf",".otf",".eot",".exe",".dll",".so",".dylib",".sqlite",".db",".pickle",".pkl",".parquet"]);function a(i){return i instanceof Date?i.toISOString():String(i)}function l(i){if(typeof i=="string"||i instanceof ArrayBuffer)return i;if(i instanceof Buffer)return new Uint8Array(i).buffer;if(i instanceof Uint8Array)return new Uint8Array(i).buffer;throw new Error(`Unsupported data type for file upload: ${typeof i}. Expected string, Buffer, ArrayBuffer, or Uint8Array.`)}function x(i){let t=i.substring(i.lastIndexOf(".")).toLowerCase();return b.has(t)}var m=class{constructor(t){this.sandbox=t;}async run(t,e){try{let n=await this.sandbox.commands.run(t,{timeoutMs:e?.timeoutMs,envs:e?.envs,cwd:e?.cwd,onStdout:e?.onStdout,onStderr:e?.onStderr});return {exitCode:n.exitCode,stdout:n.stdout,stderr:n.stderr}}catch(n){if(n&&typeof n=="object"&&"exitCode"in n){let r=n;return {exitCode:r.exitCode,stdout:r.stdout??"",stderr:r.stderr??""}}throw n}}async spawn(t,e){let n=await this.sandbox.commands.run(t,{background:true,stdin:e?.stdin??true,timeoutMs:e?.timeoutMs,envs:e?.envs,cwd:e?.cwd,onStdout:e?.onStdout,onStderr:e?.onStderr});return {pid:n.pid,wait:async()=>{try{let r=await n.wait();return {exitCode:r.exitCode,stdout:r.stdout,stderr:r.stderr}}catch(r){if(r&&typeof r=="object"&&"exitCode"in r){let s=r;return {exitCode:s.exitCode,stdout:s.stdout??"",stderr:s.stderr??""}}throw r}},kill:()=>this.sandbox.commands.kill(n.pid)}}async list(){return this.sandbox.commands.list()}async connect(t,e){let n=await this.sandbox.commands.connect(t,{onStdout:e?.onStdout,onStderr:e?.onStderr,timeoutMs:e?.timeoutMs});return {pid:n.pid,wait:async()=>{try{let r=await n.wait();return {exitCode:r.exitCode,stdout:r.stdout,stderr:r.stderr}}catch(r){if(r&&typeof r=="object"&&"exitCode"in r){let s=r;return {exitCode:s.exitCode,stdout:s.stdout??"",stderr:s.stderr??""}}throw r}},kill:()=>this.sandbox.commands.kill(n.pid)}}async sendStdin(t,e){await this.sandbox.commands.sendStdin(t,e);}async kill(t){return this.sandbox.commands.kill(t)}},u=class{constructor(t){this.sandbox=t;}async read(t){return x(t)?this.sandbox.files.read(t,{format:"bytes",requestTimeoutMs:3e5}):this.sandbox.files.read(t,{format:"text",requestTimeoutMs:3e5})}async write(t,e){await this.sandbox.files.write(t,l(e),{requestTimeoutMs:3e5});}async writeBatch(t){let e=t.map(n=>({path:n.path,data:l(n.data)}));await this.sandbox.files.write(e,{requestTimeoutMs:3e5});}async makeDir(t){await this.sandbox.files.makeDir(t);}async uploadUrl(t,e){return this.sandbox.uploadUrl(t,e?{useSignatureExpiration:e}:void 0)}async downloadUrl(t,e){return this.sandbox.downloadUrl(t,e?{useSignatureExpiration:e}:void 0)}async exists(t){return this.sandbox.files.exists(t)}async list(t){return (await this.sandbox.files.list(t)).map(n=>({name:n.name,path:n.path,type:n.type==="dir"?"dir":"file"}))}async remove(t){await this.sandbox.files.remove(t);}async rename(t,e){await this.sandbox.files.rename(t,e);}async readStream(t){return this.sandbox.files.read(t,{format:"stream"})}async writeStream(t,e){await this.sandbox.files.write(t,e);}async watchDir(t,e,n){let r=await this.sandbox.files.watchDir(t,e,{recursive:n?.recursive,timeoutMs:n?.timeoutMs,onExit:n?.onExit});return {stop:()=>r.stop()}}},o=class{constructor(t){this.sandbox=t;this.commands=new m(t),this.files=new u(t);}commands;files;get sandboxId(){return this.sandbox.sandboxId}getHost(t){return this.sandbox.getHost(t)}async isRunning(){return this.sandbox.isRunning()}async getInfo(){let t=await this.sandbox.getInfo();return {sandboxId:t.sandboxId,templateId:t.templateId,name:t.name,metadata:t.metadata??{},startedAt:a(t.startedAt),endAt:t.endAt?a(t.endAt):void 0}}async kill(){try{await this.sandbox.kill();}catch{await new Promise(t=>setTimeout(t,500)),await this.sandbox.kill();}}async pause(){await this.sandbox.betaPause();}},c=class{providerType="e2b";apiKey;defaultTimeoutMs;constructor(t){this.apiKey=t.apiKey,this.defaultTimeoutMs=t.defaultTimeoutMs??36e5;}async create(t){let e=t.timeoutMs??this.defaultTimeoutMs,n=await Sandbox.create(t.templateId,{apiKey:this.apiKey,envs:t.envs,metadata:t.metadata,timeoutMs:e});return t.workingDirectory&&await n.files.makeDir(t.workingDirectory),new o(n)}async connect(t,e){let n=await Sandbox.connect(t,{apiKey:this.apiKey,timeoutMs:e??this.defaultTimeoutMs});return new o(n)}async list(t){return (await Sandbox.list({apiKey:this.apiKey,query:{state:t?.state,metadata:t?.metadata},limit:t?.limit??100}).nextItems()).map(r=>({sandboxId:r.sandboxId,templateId:r.templateId,name:r.name,metadata:r.metadata??{},startedAt:a(r.startedAt),endAt:r.endAt?a(r.endAt):void 0}))}};function g(i={}){let t=i.apiKey??process.env.E2B_API_KEY;if(!t)throw new Error("E2B API key required. Set E2B_API_KEY environment variable or pass apiKey in config. Get your key at https://e2b.dev/sign-in");return new c({...i,apiKey:t})}
+export{c as E2BSandboxProvider,g as createE2BProvider};

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@evolvingmachines/e2b",
+  "version": "0.0.2",
+  "keywords": [
+    "ai",
+    "agents",
+    "sandbox",
+    "e2b",
+    "evolve-sdk",
+    "orchestration"
+  ],
+  "homepage": "https://github.com/evolving-machines-lab/evolve",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/evolving-machines-lab/evolve.git"
+  },
+  "type": "module",
+  "main": "dist/index.cjs",
+  "types": "dist/index.d.ts",
+  "license": "Proprietary Beta Evaluation License - See LICENSE",
+  "files": [
+    "dist",
+    "LICENSE"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "scripts": {
+    "build": "tsup --minify",
+    "dev": "tsup --watch",
+    "type-check": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@e2b/code-interpreter": "^2.0.1"
+  },
+  "devDependencies": {
+    "@types/node": "^22.15.18",
+    "tsup": "^8.4.0",
+    "typescript": "^5.8.3"
+  }
+}