@tpmjs/tools-e2b 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,328 @@
+import * as ai from 'ai';
+
+/**
+ * E2B Cloud Sandbox Tools for TPMJS
+ * Create and manage cloud sandboxes for AI code execution.
+ *
+ * Authentication: Set E2B_API_KEY env var with your API key from https://e2b.dev/dashboard
+ *
+ * SDK Packages:
+ *   JavaScript/TypeScript: @e2b/code-interpreter
+ *   Python: e2b-code-interpreter
+ */
+interface E2BSandbox {
+    sandboxId: string;
+    templateId: string;
+    status: string;
+    startedAt?: string;
+    clientId?: string;
+    metadata?: Record<string, string>;
+}
+interface E2BSandboxList {
+    sandboxes: E2BSandbox[];
+    count: number;
+}
+interface E2BExecResult {
+    stdout: string;
+    stderr: string;
+    results: unknown[];
+    error?: {
+        name: string;
+        message: string;
+        traceback?: string;
+    };
+    duration: number;
+}
+interface E2BFileInfo {
+    name: string;
+    path: string;
+    type: 'file' | 'directory';
+    size?: number;
+}
+interface E2BTemplate {
+    templateId: string;
+    buildId?: string;
+    cpuCount?: number;
+    memoryMB?: number;
+    status?: string;
+    public?: boolean;
+}
+interface E2BMetrics {
+    cpuPct: number;
+    memUsedMB: number;
+    networkIngressMB: number;
+    networkEgressMB: number;
+}
+interface CreateSandboxInput {
+    template?: string;
+    timeoutMs?: number;
+    metadata?: Record<string, string>;
+    envVars?: Record<string, string>;
+}
+interface SandboxIdInput {
+    sandboxId: string;
+}
+interface ListSandboxesInput {
+    templateId?: string;
+}
+interface SetTimeoutInput {
+    sandboxId: string;
+    timeoutMs: number;
+}
+interface RunCodeInput {
+    sandboxId: string;
+    code: string;
+    language?: string;
+    timeoutMs?: number;
+}
+interface RunCommandInput {
+    sandboxId: string;
+    command: string;
+    cwd?: string;
+    background?: boolean;
+    timeoutMs?: number;
+}
+interface WriteFileInput {
+    sandboxId: string;
+    path: string;
+    content: string;
+}
+interface ReadFileInput {
+    sandboxId: string;
+    path: string;
+}
+interface ListFilesInput {
+    sandboxId: string;
+    path: string;
+}
+interface UploadFileInput {
+    sandboxId: string;
+    path: string;
+    content?: string;
+    url?: string;
+}
+interface DownloadFileInput {
+    sandboxId: string;
+    path: string;
+}
+interface MakeDirectoryInput {
+    sandboxId: string;
+    path: string;
+}
+interface WatchDirectoryInput {
+    sandboxId: string;
+    path: string;
+}
+interface ResumeInput {
+    sandboxId: string;
+    timeoutMs?: number;
+}
+interface SetEnvVarsInput {
+    sandboxId: string;
+    envVars: Record<string, string>;
+}
+interface InstallPackagesInput {
+    sandboxId: string;
+    packages: string[];
+}
+/**
+ * Create a new E2B sandbox
+ */
+declare const createSandbox: ai.Tool<CreateSandboxInput, E2BSandbox>;
+/**
+ * Get sandbox details
+ */
+declare const getSandbox: ai.Tool<SandboxIdInput, E2BSandbox>;
+/**
+ * List all sandboxes
+ */
+declare const listSandboxes: ai.Tool<ListSandboxesInput, E2BSandboxList>;
+/**
+ * Kill a sandbox
+ */
+declare const killSandbox: ai.Tool<SandboxIdInput, {
+    killed: boolean;
+    sandboxId: string;
+}>;
+/**
+ * Set sandbox timeout
+ */
+declare const setTimeout: ai.Tool<SetTimeoutInput, {
+    success: boolean;
+    expiresAt: string;
+}>;
+/**
+ * Run code in sandbox
+ */
+declare const runCode: ai.Tool<RunCodeInput, E2BExecResult>;
+/**
+ * Run shell command
+ */
+declare const runCommand: ai.Tool<RunCommandInput, {
+    stdout: string;
+    stderr: string;
+    exitCode: number;
+    processId?: string;
+}>;
+/**
+ * Write file to sandbox
+ */
+declare const writeFile: ai.Tool<WriteFileInput, {
+    success: boolean;
+    path: string;
+    size: number;
+}>;
+/**
+ * Read file from sandbox
+ */
+declare const readFile: ai.Tool<ReadFileInput, {
+    content: string;
+    path: string;
+    size: number;
+}>;
+/**
+ * List files in sandbox
+ */
+declare const listFiles: ai.Tool<ListFilesInput, {
+    entries: E2BFileInfo[];
+    count: number;
+}>;
+/**
+ * Upload file to sandbox
+ */
+declare const uploadFile: ai.Tool<UploadFileInput, {
+    success: boolean;
+    path: string;
+    size: number;
+}>;
+/**
+ * Download file from sandbox
+ */
+declare const downloadFile: ai.Tool<DownloadFileInput, {
+    content: string;
+    filename: string;
+    size: number;
+    mimeType: string;
+}>;
+/**
+ * Create directory in sandbox
+ */
+declare const makeDirectory: ai.Tool<MakeDirectoryInput, {
+    success: boolean;
+    path: string;
+}>;
+/**
+ * Watch directory for changes
+ */
+declare const watchDirectory: ai.Tool<WatchDirectoryInput, {
+    entries: E2BFileInfo[];
+    watcherId: string;
+}>;
+/**
+ * Pause sandbox (using keepalive approach)
+ */
+declare const pauseSandbox: ai.Tool<SandboxIdInput, {
+    success: boolean;
+    sandboxId: string;
+    status: string;
+}>;
+/**
+ * Resume (reconnect to) sandbox
+ */
+declare const resumeSandbox: ai.Tool<ResumeInput, {
+    sandboxId: string;
+    status: string;
+}>;
+/**
+ * Set environment variables
+ */
+declare const setEnvVars: ai.Tool<SetEnvVarsInput, {
+    success: boolean;
+    count: number;
+}>;
+/**
+ * Get sandbox metrics
+ */
+declare const getMetrics: ai.Tool<SandboxIdInput, E2BMetrics>;
+/**
+ * Install Python packages
+ */
+declare const installPackages: ai.Tool<InstallPackagesInput, {
+    success: boolean;
+    installed: string[];
+    errors?: string[];
+}>;
+declare const _default: {
+    createSandbox: ai.Tool<CreateSandboxInput, E2BSandbox>;
+    getSandbox: ai.Tool<SandboxIdInput, E2BSandbox>;
+    listSandboxes: ai.Tool<ListSandboxesInput, E2BSandboxList>;
+    killSandbox: ai.Tool<SandboxIdInput, {
+        killed: boolean;
+        sandboxId: string;
+    }>;
+    setTimeout: ai.Tool<SetTimeoutInput, {
+        success: boolean;
+        expiresAt: string;
+    }>;
+    runCode: ai.Tool<RunCodeInput, E2BExecResult>;
+    runCommand: ai.Tool<RunCommandInput, {
+        stdout: string;
+        stderr: string;
+        exitCode: number;
+        processId?: string;
+    }>;
+    writeFile: ai.Tool<WriteFileInput, {
+        success: boolean;
+        path: string;
+        size: number;
+    }>;
+    readFile: ai.Tool<ReadFileInput, {
+        content: string;
+        path: string;
+        size: number;
+    }>;
+    listFiles: ai.Tool<ListFilesInput, {
+        entries: E2BFileInfo[];
+        count: number;
+    }>;
+    uploadFile: ai.Tool<UploadFileInput, {
+        success: boolean;
+        path: string;
+        size: number;
+    }>;
+    downloadFile: ai.Tool<DownloadFileInput, {
+        content: string;
+        filename: string;
+        size: number;
+        mimeType: string;
+    }>;
+    makeDirectory: ai.Tool<MakeDirectoryInput, {
+        success: boolean;
+        path: string;
+    }>;
+    watchDirectory: ai.Tool<WatchDirectoryInput, {
+        entries: E2BFileInfo[];
+        watcherId: string;
+    }>;
+    pauseSandbox: ai.Tool<SandboxIdInput, {
+        success: boolean;
+        sandboxId: string;
+        status: string;
+    }>;
+    resumeSandbox: ai.Tool<ResumeInput, {
+        sandboxId: string;
+        status: string;
+    }>;
+    setEnvVars: ai.Tool<SetEnvVarsInput, {
+        success: boolean;
+        count: number;
+    }>;
+    getMetrics: ai.Tool<SandboxIdInput, E2BMetrics>;
+    installPackages: ai.Tool<InstallPackagesInput, {
+        success: boolean;
+        installed: string[];
+        errors?: string[];
+    }>;
+};
+
+export { type E2BExecResult, type E2BFileInfo, type E2BMetrics, type E2BSandbox, type E2BSandboxList, type E2BTemplate, createSandbox, _default as default, downloadFile, getMetrics, getSandbox, installPackages, killSandbox, listFiles, listSandboxes, makeDirectory, pauseSandbox, readFile, resumeSandbox, runCode, runCommand, setEnvVars, setTimeout, uploadFile, watchDirectory, writeFile };

package/dist/index.js

@@ -0,0 +1,751 @@
+// src/index.ts
+import { Sandbox } from "@e2b/code-interpreter";
+import { jsonSchema, tool } from "ai";
+var sandboxCache = /* @__PURE__ */ new Map();
+async function getOrConnectSandbox(sandboxId) {
+  if (!sandboxId) {
+    throw new Error("sandboxId is required");
+  }
+  const cached = sandboxCache.get(sandboxId);
+  if (cached) {
+    return cached;
+  }
+  try {
+    const sandbox = await Sandbox.connect(sandboxId);
+    sandboxCache.set(sandboxId, sandbox);
+    return sandbox;
+  } catch (error) {
+    const message = error instanceof Error ? error.message : "Unknown error";
+    throw new Error(`Failed to connect to sandbox ${sandboxId}: ${message}`);
+  }
+}
+function removeSandboxFromCache(sandboxId) {
+  sandboxCache.delete(sandboxId);
+}
+var createSandbox = tool({
+  description: 'Create a new E2B cloud sandbox from a template. Sandboxes are isolated Linux environments for AI code execution. Defaults to "base" template with 5 minute timeout if not specified. Requires E2B_API_KEY.',
+  inputSchema: jsonSchema({
+    type: "object",
+    properties: {
+      template: {
+        type: "string",
+        description: 'Template ID to use (default: "base" for Code Interpreter)'
+      },
+      timeoutMs: {
+        type: "number",
+        description: "Sandbox timeout in milliseconds (default: 300000 = 5 minutes)"
+      },
+      metadata: {
+        type: "object",
+        description: "Custom metadata key-value pairs to attach to sandbox",
+        additionalProperties: { type: "string" }
+      },
+      envVars: {
+        type: "object",
+        description: "Environment variables to set in the sandbox",
+        additionalProperties: { type: "string" }
+      }
+    },
+    required: [],
+    additionalProperties: false
+  }),
+  async execute(input) {
+    const templateId = input.template || "base";
+    const timeoutMs = input.timeoutMs || 3e5;
+    try {
+      const sandbox = await Sandbox.create(templateId, {
+        timeoutMs,
+        metadata: input.metadata,
+        envs: input.envVars
+      });
+      sandboxCache.set(sandbox.sandboxId, sandbox);
+      return {
+        sandboxId: sandbox.sandboxId,
+        templateId,
+        status: "running",
+        startedAt: (/* @__PURE__ */ new Date()).toISOString(),
+        clientId: sandbox.sandboxId,
+        metadata: input.metadata
+      };
+    } catch (error) {
+      const message = error instanceof Error ? error.message : "Unknown error";
+      throw new Error(`Failed to create sandbox with template "${templateId}": ${message}`);
+    }
+  }
+});
+var getSandbox = tool({
+  description: "Connect to and verify an existing E2B sandbox is running. Returns sandbox ID and connection status. Requires E2B_API_KEY.",
+  inputSchema: jsonSchema({
+    type: "object",
+    properties: {
+      sandboxId: {
+        type: "string",
+        description: "ID of the sandbox to retrieve"
+      }
+    },
+    required: ["sandboxId"],
+    additionalProperties: false
+  }),
+  async execute(input) {
+    try {
+      const sandbox = await getOrConnectSandbox(input.sandboxId);
+      return {
+        sandboxId: sandbox.sandboxId,
+        templateId: sandbox.templateId || "base",
+        status: "running"
+      };
+    } catch (error) {
+      const message = error instanceof Error ? error.message : "Unknown error";
+      throw new Error(`Failed to get sandbox ${input.sandboxId}: ${message}`);
+    }
+  }
+});
+var listSandboxes = tool({
+  description: "List all running E2B sandboxes in your account with their status and metadata. Requires E2B_API_KEY.",
+  inputSchema: jsonSchema({
+    type: "object",
+    properties: {
+      templateId: {
+        type: "string",
+        description: "Filter sandboxes by template ID"
+      }
+    },
+    required: [],
+    additionalProperties: false
+  }),
+  async execute(_input) {
+    const sandboxes = await Sandbox.list();
+    return {
+      sandboxes: sandboxes.map((s) => ({
+        sandboxId: s.sandboxId,
+        templateId: s.templateId || "unknown",
+        status: "running",
+        startedAt: s.startedAt?.toISOString(),
+        clientId: s.clientId,
+        metadata: s.metadata
+      })),
+      count: sandboxes.length
+    };
+  }
+});
+var killSandbox = tool({
+  description: "Terminate a running E2B sandbox immediately. All data and processes are destroyed. Requires E2B_API_KEY.",
+  inputSchema: jsonSchema({
+    type: "object",
+    properties: {
+      sandboxId: {
+        type: "string",
+        description: "ID of the sandbox to terminate"
+      }
+    },
+    required: ["sandboxId"],
+    additionalProperties: false
+  }),
+  async execute(input) {
+    const sandbox = await getOrConnectSandbox(input.sandboxId);
+    await sandbox.kill();
+    removeSandboxFromCache(input.sandboxId);
+    return { killed: true, sandboxId: input.sandboxId };
+  }
+});
+var setTimeout = tool({
+  description: "Set or extend the timeout for an E2B sandbox. The sandbox will be automatically killed when the timeout expires. Requires E2B_API_KEY.",
+  inputSchema: jsonSchema({
+    type: "object",
+    properties: {
+      sandboxId: {
+        type: "string",
+        description: "ID of the sandbox"
+      },
+      timeoutMs: {
+        type: "number",
+        description: "New timeout in milliseconds from now"
+      }
+    },
+    required: ["sandboxId", "timeoutMs"],
+    additionalProperties: false
+  }),
+  async execute(input) {
+    const sandbox = await getOrConnectSandbox(input.sandboxId);
+    await sandbox.setTimeout(input.timeoutMs);
+    const expiresAt = new Date(Date.now() + input.timeoutMs).toISOString();
+    return { success: true, expiresAt };
+  }
+});
+var runCode = tool({
+  description: "Execute code in an E2B sandbox. Supports Python (default), JavaScript, TypeScript, R, Java, and Bash with streaming output and result capture. Requires E2B_API_KEY.",
+  inputSchema: jsonSchema({
+    type: "object",
+    properties: {
+      sandboxId: {
+        type: "string",
+        description: "ID of the sandbox to execute in"
+      },
+      code: {
+        type: "string",
+        description: "Code to execute"
+      },
+      language: {
+        type: "string",
+        description: "Language: python (default), javascript, typescript, r, java, bash"
+      },
+      timeoutMs: {
+        type: "number",
+        description: "Execution timeout in milliseconds (default: 60000)"
+      }
+    },
+    required: ["sandboxId", "code"],
+    additionalProperties: false
+  }),
+  async execute(input) {
+    const startTime = Date.now();
+    const language = input.language || "python";
+    const timeoutMs = input.timeoutMs || 6e4;
+    try {
+      const sandbox = await getOrConnectSandbox(input.sandboxId);
+      const execution = await sandbox.runCode(input.code, {
+        language,
+        timeoutMs
+      });
+      const duration = Date.now() - startTime;
+      return {
+        stdout: execution.logs.stdout.join("\n"),
+        stderr: execution.logs.stderr.join("\n"),
+        results: execution.results.map((r) => r.toJSON()),
+        error: execution.error ? {
+          name: execution.error.name,
+          message: execution.error.value,
+          traceback: execution.error.traceback
+        } : void 0,
+        duration
+      };
+    } catch (error) {
+      const message = error instanceof Error ? error.message : "Unknown error";
+      throw new Error(`Failed to execute code in sandbox ${input.sandboxId}: ${message}`);
+    }
+  }
+});
+var runCommand = tool({
+  description: "Execute a shell command in an E2B sandbox with full shell access. Supports background processes and working directory. Requires E2B_API_KEY.",
+  inputSchema: jsonSchema({
+    type: "object",
+    properties: {
+      sandboxId: {
+        type: "string",
+        description: "ID of the sandbox"
+      },
+      command: {
+        type: "string",
+        description: "Shell command to execute"
+      },
+      cwd: {
+        type: "string",
+        description: "Working directory for the command"
+      },
+      background: {
+        type: "boolean",
+        description: "Run command in background (default: false)"
+      },
+      timeoutMs: {
+        type: "number",
+        description: "Command timeout in milliseconds (default: 60000)"
+      }
+    },
+    required: ["sandboxId", "command"],
+    additionalProperties: false
+  }),
+  async execute(input) {
+    const timeoutMs = input.timeoutMs || 6e4;
+    try {
+      const sandbox = await getOrConnectSandbox(input.sandboxId);
+      if (input.background) {
+        const process = await sandbox.commands.run(input.command, {
+          cwd: input.cwd,
+          background: true,
+          timeoutMs
+        });
+        return {
+          stdout: "",
+          stderr: "",
+          exitCode: 0,
+          processId: String(process.pid)
+        };
+      }
+      const result = await sandbox.commands.run(input.command, {
+        cwd: input.cwd,
+        timeoutMs
+      });
+      return {
+        stdout: result.stdout,
+        stderr: result.stderr,
+        exitCode: result.exitCode
+      };
+    } catch (error) {
+      const message = error instanceof Error ? error.message : "Unknown error";
+      throw new Error(`Failed to run command in sandbox ${input.sandboxId}: ${message}`);
+    }
+  }
+});
+var writeFile = tool({
+  description: "Write content to a file in the E2B sandbox filesystem. Creates directories as needed. Requires E2B_API_KEY.",
+  inputSchema: jsonSchema({
+    type: "object",
+    properties: {
+      sandboxId: {
+        type: "string",
+        description: "ID of the sandbox"
+      },
+      path: {
+        type: "string",
+        description: "Absolute path in sandbox (e.g., /home/user/file.txt)"
+      },
+      content: {
+        type: "string",
+        description: "File content as string"
+      }
+    },
+    required: ["sandboxId", "path", "content"],
+    additionalProperties: false
+  }),
+  async execute(input) {
+    try {
+      const sandbox = await getOrConnectSandbox(input.sandboxId);
+      await sandbox.files.write(input.path, input.content);
+      return {
+        success: true,
+        path: input.path,
+        size: input.content.length
+      };
+    } catch (error) {
+      const message = error instanceof Error ? error.message : "Unknown error";
+      throw new Error(`Failed to write file ${input.path} in sandbox ${input.sandboxId}: ${message}`);
+    }
+  }
+});
+var readFile = tool({
+  description: "Read content from a file in the E2B sandbox filesystem. Requires E2B_API_KEY.",
+  inputSchema: jsonSchema({
+    type: "object",
+    properties: {
+      sandboxId: {
+        type: "string",
+        description: "ID of the sandbox"
+      },
+      path: {
+        type: "string",
+        description: "Absolute path to file in sandbox"
+      }
+    },
+    required: ["sandboxId", "path"],
+    additionalProperties: false
+  }),
+  async execute(input) {
+    const sandbox = await getOrConnectSandbox(input.sandboxId);
+    const content = await sandbox.files.read(input.path);
+    const textContent = typeof content === "string" ? content : new TextDecoder().decode(content);
+    return {
+      content: textContent,
+      path: input.path,
+      size: textContent.length
+    };
+  }
+});
+var listFiles = tool({
+  description: "List files and directories at a path in the E2B sandbox. Requires E2B_API_KEY.",
+  inputSchema: jsonSchema({
+    type: "object",
+    properties: {
+      sandboxId: {
+        type: "string",
+        description: "ID of the sandbox"
+      },
+      path: {
+        type: "string",
+        description: "Absolute path to list (e.g., /home/user)"
+      }
+    },
+    required: ["sandboxId", "path"],
+    additionalProperties: false
+  }),
+  async execute(input) {
+    const sandbox = await getOrConnectSandbox(input.sandboxId);
+    const entries = await sandbox.files.list(input.path);
+    return {
+      entries: entries.map((e) => ({
+        name: e.name,
+        path: `${input.path}/${e.name}`,
+        type: e.type
+      })),
+      count: entries.length
+    };
+  }
+});
+var uploadFile = tool({
+  description: "Upload a file to the E2B sandbox from base64 content or a URL. Requires E2B_API_KEY.",
+  inputSchema: jsonSchema({
+    type: "object",
+    properties: {
+      sandboxId: {
+        type: "string",
+        description: "ID of the sandbox"
+      },
+      path: {
+        type: "string",
+        description: "Destination path in sandbox"
+      },
+      content: {
+        type: "string",
+        description: "Base64 encoded file content"
+      },
+      url: {
+        type: "string",
+        description: "URL to fetch file from (alternative to content)"
+      }
+    },
+    required: ["sandboxId", "path"],
+    additionalProperties: false
+  }),
+  async execute(input) {
+    const sandbox = await getOrConnectSandbox(input.sandboxId);
+    let fileContent;
+    if (input.url) {
+      const response = await fetch(input.url);
+      fileContent = await response.arrayBuffer();
+    } else if (input.content) {
+      const binaryString = atob(input.content);
+      const bytes = new Uint8Array(binaryString.length);
+      for (let i = 0; i < binaryString.length; i++) {
+        bytes[i] = binaryString.charCodeAt(i);
+      }
+      fileContent = bytes.buffer;
+    } else {
+      throw new Error("Either content or url must be provided");
+    }
+    await sandbox.files.write(input.path, fileContent);
+    return {
+      success: true,
+      path: input.path,
+      size: fileContent.byteLength
+    };
+  }
+});
+var downloadFile = tool({
+  description: "Download a file from the E2B sandbox as base64 content. Requires E2B_API_KEY.",
+  inputSchema: jsonSchema({
+    type: "object",
+    properties: {
+      sandboxId: {
+        type: "string",
+        description: "ID of the sandbox"
+      },
+      path: {
+        type: "string",
+        description: "Path to file in sandbox"
+      }
+    },
+    required: ["sandboxId", "path"],
+    additionalProperties: false
+  }),
+  async execute(input) {
+    const sandbox = await getOrConnectSandbox(input.sandboxId);
+    const content = await sandbox.files.read(input.path);
+    const filename = input.path.split("/").pop() || "file";
+    const ext = filename.split(".").pop()?.toLowerCase() || "";
+    let base64Content;
+    let contentLength;
+    if (typeof content === "string") {
+      base64Content = btoa(content);
+      contentLength = content.length;
+    } else {
+      const bytes = new Uint8Array(content);
+      contentLength = bytes.length;
+      let binary = "";
+      for (let i = 0; i < bytes.length; i++) {
+        binary += String.fromCharCode(bytes[i]);
+      }
+      base64Content = btoa(binary);
+    }
+    const mimeTypes = {
+      txt: "text/plain",
+      json: "application/json",
+      js: "text/javascript",
+      ts: "text/typescript",
+      py: "text/x-python",
+      html: "text/html",
+      css: "text/css",
+      png: "image/png",
+      jpg: "image/jpeg",
+      jpeg: "image/jpeg",
+      gif: "image/gif",
+      pdf: "application/pdf",
+      zip: "application/zip"
+    };
+    return {
+      content: base64Content,
+      filename,
+      size: contentLength,
+      mimeType: mimeTypes[ext] || "application/octet-stream"
+    };
+  }
+});
+var makeDirectory = tool({
+  description: "Create a directory in the E2B sandbox filesystem. Creates parent directories as needed. Requires E2B_API_KEY.",
+  inputSchema: jsonSchema({
+    type: "object",
+    properties: {
+      sandboxId: {
+        type: "string",
+        description: "ID of the sandbox"
+      },
+      path: {
+        type: "string",
+        description: "Absolute path of directory to create"
+      }
+    },
+    required: ["sandboxId", "path"],
+    additionalProperties: false
+  }),
+  async execute(input) {
+    const sandbox = await getOrConnectSandbox(input.sandboxId);
+    await sandbox.files.makeDir(input.path);
+    return { success: true, path: input.path };
+  }
+});
+var watchDirectory = tool({
+  description: "Watch a directory in the E2B sandbox for file changes. Returns the initial state. Requires E2B_API_KEY.",
+  inputSchema: jsonSchema({
+    type: "object",
+    properties: {
+      sandboxId: {
+        type: "string",
+        description: "ID of the sandbox"
+      },
+      path: {
+        type: "string",
+        description: "Directory path to watch"
+      }
+    },
+    required: ["sandboxId", "path"],
+    additionalProperties: false
+  }),
+  async execute(input) {
+    const sandbox = await getOrConnectSandbox(input.sandboxId);
+    const entries = await sandbox.files.list(input.path);
+    return {
+      entries: entries.map((e) => ({
+        name: e.name,
+        path: `${input.path}/${e.name}`,
+        type: e.type
+      })),
+      watcherId: `watch-${input.sandboxId}-${Date.now()}`
+    };
+  }
+});
+var pauseSandbox = tool({
+  description: "Disconnect from an E2B sandbox while keeping it running. The sandbox continues running and can be reconnected later using resumeSandbox. State is preserved in the sandbox. Requires E2B_API_KEY.",
+  inputSchema: jsonSchema({
+    type: "object",
+    properties: {
+      sandboxId: {
+        type: "string",
+        description: "ID of the sandbox to disconnect from"
+      }
+    },
+    required: ["sandboxId"],
+    additionalProperties: false
+  }),
+  async execute(input) {
+    if (!input.sandboxId) {
+      throw new Error("sandboxId is required");
+    }
+    try {
+      await getOrConnectSandbox(input.sandboxId);
+    } catch (error) {
+      const message = error instanceof Error ? error.message : "Unknown error";
+      throw new Error(`Cannot pause sandbox ${input.sandboxId}: ${message}`);
+    }
+    removeSandboxFromCache(input.sandboxId);
+    return {
+      success: true,
+      sandboxId: input.sandboxId,
+      status: "disconnected"
+    };
+  }
+});
+var resumeSandbox = tool({
+  description: "Reconnect to a running E2B sandbox that was previously disconnected using pauseSandbox. Optionally set a new timeout. Requires E2B_API_KEY.",
+  inputSchema: jsonSchema({
+    type: "object",
+    properties: {
+      sandboxId: {
+        type: "string",
+        description: "ID of the sandbox to reconnect to"
+      },
+      timeoutMs: {
+        type: "number",
+        description: "New timeout for the sandbox in milliseconds (optional)"
+      }
+    },
+    required: ["sandboxId"],
+    additionalProperties: false
+  }),
+  async execute(input) {
+    try {
+      const sandbox = await Sandbox.connect(input.sandboxId);
+      if (input.timeoutMs) {
+        await sandbox.setTimeout(input.timeoutMs);
+      }
+      sandboxCache.set(sandbox.sandboxId, sandbox);
+      return { sandboxId: sandbox.sandboxId, status: "running" };
+    } catch (error) {
+      const message = error instanceof Error ? error.message : "Unknown error";
+      throw new Error(`Failed to reconnect to sandbox ${input.sandboxId}: ${message}`);
+    }
+  }
+});
+var setEnvVars = tool({
+  description: "Set environment variables in an E2B sandbox. These persist for subsequent code executions in the same sandbox session. Special characters are safely escaped. Requires E2B_API_KEY.",
+  inputSchema: jsonSchema({
+    type: "object",
+    properties: {
+      sandboxId: {
+        type: "string",
+        description: "ID of the sandbox"
+      },
+      envVars: {
+        type: "object",
+        description: "Key-value pairs of environment variables to set",
+        additionalProperties: { type: "string" }
+      }
+    },
+    required: ["sandboxId", "envVars"],
+    additionalProperties: false
+  }),
+  async execute(input) {
+    try {
+      const sandbox = await getOrConnectSandbox(input.sandboxId);
+      const escapeForShell = (str) => {
+        return str.replace(/\\/g, "\\\\").replace(/"/g, '\\"').replace(/\$/g, "\\$").replace(/`/g, "\\`").replace(/!/g, "\\!");
+      };
+      for (const [key, value] of Object.entries(input.envVars)) {
+        await sandbox.commands.run(`export ${key}="${escapeForShell(value)}"`);
+      }
+      return { success: true, count: Object.keys(input.envVars).length };
+    } catch (error) {
+      const message = error instanceof Error ? error.message : "Unknown error";
+      throw new Error(`Failed to set environment variables in sandbox ${input.sandboxId}: ${message}`);
+    }
+  }
+});
+var getMetrics = tool({
+  description: "Get resource usage metrics for an E2B sandbox including CPU, memory, and network usage. Requires E2B_API_KEY.",
+  inputSchema: jsonSchema({
+    type: "object",
+    properties: {
+      sandboxId: {
+        type: "string",
+        description: "ID of the sandbox"
+      }
+    },
+    required: ["sandboxId"],
+    additionalProperties: false
+  }),
+  async execute(input) {
+    const sandbox = await getOrConnectSandbox(input.sandboxId);
+    const cpuResult = await sandbox.commands.run(
+      "cat /proc/stat | grep 'cpu ' | awk '{usage=($2+$4)*100/($2+$4+$5)} END {print usage}'"
+    );
+    const memResult = await sandbox.commands.run("free -m | grep Mem | awk '{print $3}'");
+    return {
+      cpuPct: parseFloat(cpuResult.stdout) || 0,
+      memUsedMB: parseInt(memResult.stdout) || 0,
+      networkIngressMB: 0,
+      networkEgressMB: 0
+    };
+  }
+});
+var installPackages = tool({
+  description: "Install Python packages in an E2B Code Interpreter sandbox using pip. Requires E2B_API_KEY.",
+  inputSchema: jsonSchema({
+    type: "object",
+    properties: {
+      sandboxId: {
+        type: "string",
+        description: "ID of the sandbox"
+      },
+      packages: {
+        type: "array",
+        items: { type: "string" },
+        description: "Array of package names to install (e.g., ['numpy', 'pandas==2.0.0'])"
+      }
+    },
+    required: ["sandboxId", "packages"],
+    additionalProperties: false
+  }),
+  async execute(input) {
+    const sandbox = await getOrConnectSandbox(input.sandboxId);
+    const installed = [];
+    const errors = [];
+    for (const pkg of input.packages) {
+      try {
+        const result = await sandbox.commands.run(`pip install ${pkg}`, { timeoutMs: 12e4 });
+        if (result.exitCode === 0) {
+          installed.push(pkg);
+        } else {
+          errors.push(`${pkg}: ${result.stderr}`);
+        }
+      } catch (error) {
+        errors.push(`${pkg}: ${error instanceof Error ? error.message : "Unknown error"}`);
+      }
+    }
+    return {
+      success: errors.length === 0,
+      installed,
+      errors: errors.length > 0 ? errors : void 0
+    };
+  }
+});
+var index_default = {
+  createSandbox,
+  getSandbox,
+  listSandboxes,
+  killSandbox,
+  setTimeout,
+  runCode,
+  runCommand,
+  writeFile,
+  readFile,
+  listFiles,
+  uploadFile,
+  downloadFile,
+  makeDirectory,
+  watchDirectory,
+  pauseSandbox,
+  resumeSandbox,
+  setEnvVars,
+  getMetrics,
+  installPackages
+};
+export {
+  createSandbox,
+  index_default as default,
+  downloadFile,
+  getMetrics,
+  getSandbox,
+  installPackages,
+  killSandbox,
+  listFiles,
+  listSandboxes,
+  makeDirectory,
+  pauseSandbox,
+  readFile,
+  resumeSandbox,
+  runCode,
+  runCommand,
+  setEnvVars,
+  setTimeout,
+  uploadFile,
+  watchDirectory,
+  writeFile
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["/**\n * E2B Cloud Sandbox Tools for TPMJS\n * Create and manage cloud sandboxes for AI code execution.\n *\n * Authentication: Set E2B_API_KEY env var with your API key from https://e2b.dev/dashboard\n *\n * SDK Packages:\n *   JavaScript/TypeScript: @e2b/code-interpreter\n *   Python: e2b-code-interpreter\n */\n\nimport { Sandbox } from '@e2b/code-interpreter';\nimport { jsonSchema, tool } from 'ai';\n\n// ============================================================================\n// Types\n// ============================================================================\n\nexport interface E2BSandbox {\n  sandboxId: string;\n  templateId: string;\n  status: string;\n  startedAt?: string;\n  clientId?: string;\n  metadata?: Record<string, string>;\n}\n\nexport interface E2BSandboxList {\n  sandboxes: E2BSandbox[];\n  count: number;\n}\n\nexport interface E2BExecResult {\n  stdout: string;\n  stderr: string;\n  results: unknown[];\n  error?: { name: string; message: string; traceback?: string };\n  duration: number;\n}\n\nexport interface E2BFileInfo {\n  name: string;\n  path: string;\n  type: 'file' | 'directory';\n  size?: number;\n}\n\nexport interface E2BTemplate {\n  templateId: string;\n  buildId?: string;\n  cpuCount?: number;\n  memoryMB?: number;\n  status?: string;\n  public?: boolean;\n}\n\nexport interface E2BMetrics {\n  cpuPct: number;\n  memUsedMB: number;\n  networkIngressMB: number;\n  networkEgressMB: number;\n}\n\n// Input types\ninterface CreateSandboxInput {\n  template?: string;\n  timeoutMs?: number;\n  metadata?: Record<string, string>;\n  envVars?: Record<string, string>;\n}\n\ninterface SandboxIdInput {\n  sandboxId: string;\n}\n\ninterface ListSandboxesInput {\n  templateId?: string;\n}\n\ninterface SetTimeoutInput {\n  sandboxId: string;\n  timeoutMs: number;\n}\n\ninterface RunCodeInput {\n  sandboxId: string;\n  code: string;\n  language?: string;\n  timeoutMs?: number;\n}\n\ninterface RunCommandInput {\n  sandboxId: string;\n  command: string;\n  cwd?: string;\n  background?: boolean;\n  timeoutMs?: number;\n}\n\ninterface WriteFileInput {\n  sandboxId: string;\n  path: string;\n  content: string;\n}\n\ninterface ReadFileInput {\n  sandboxId: string;\n  path: string;\n}\n\ninterface ListFilesInput {\n  sandboxId: string;\n  path: string;\n}\n\ninterface UploadFileInput {\n  sandboxId: string;\n  path: string;\n  content?: string;\n  url?: string;\n}\n\ninterface DownloadFileInput {\n  sandboxId: string;\n  path: string;\n}\n\ninterface MakeDirectoryInput {\n  sandboxId: string;\n  path: string;\n}\n\ninterface WatchDirectoryInput {\n  sandboxId: string;\n  path: string;\n}\n\ninterface ResumeInput {\n  sandboxId: string;\n  timeoutMs?: number;\n}\n\ninterface SetEnvVarsInput {\n  sandboxId: string;\n  envVars: Record<string, string>;\n}\n\ninterface InstallPackagesInput {\n  sandboxId: string;\n  packages: string[];\n}\n\n// ============================================================================\n// Sandbox Connection Cache\n// ============================================================================\n\nconst sandboxCache = new Map<string, Sandbox>();\n\nasync function getOrConnectSandbox(sandboxId: string): Promise<Sandbox> {\n  if (!sandboxId) {\n    throw new Error('sandboxId is required');\n  }\n\n  const cached = sandboxCache.get(sandboxId);\n  if (cached) {\n    return cached;\n  }\n\n  try {\n    const sandbox = await Sandbox.connect(sandboxId);\n    sandboxCache.set(sandboxId, sandbox);\n    return sandbox;\n  } catch (error) {\n    const message = error instanceof Error ? error.message : 'Unknown error';\n    throw new Error(`Failed to connect to sandbox ${sandboxId}: ${message}`);\n  }\n}\n\nfunction removeSandboxFromCache(sandboxId: string): void {\n  sandboxCache.delete(sandboxId);\n}\n\n// ============================================================================\n// Tools\n// ============================================================================\n\n/**\n * Create a new E2B sandbox\n */\nexport const createSandbox = tool({\n  description:\n    'Create a new E2B cloud sandbox from a template. Sandboxes are isolated Linux environments for AI code execution. Defaults to \"base\" template with 5 minute timeout if not specified. Requires E2B_API_KEY.',\n  inputSchema: jsonSchema<CreateSandboxInput>({\n    type: 'object',\n    properties: {\n      template: {\n        type: 'string',\n        description: 'Template ID to use (default: \"base\" for Code Interpreter)',\n      },\n      timeoutMs: {\n        type: 'number',\n        description: 'Sandbox timeout in milliseconds (default: 300000 = 5 minutes)',\n      },\n      metadata: {\n        type: 'object',\n        description: 'Custom metadata key-value pairs to attach to sandbox',\n        additionalProperties: { type: 'string' },\n      },\n      envVars: {\n        type: 'object',\n        description: 'Environment variables to set in the sandbox',\n        additionalProperties: { type: 'string' },\n      },\n    },\n    required: [],\n    additionalProperties: false,\n  }),\n  async execute(input: CreateSandboxInput): Promise<E2BSandbox> {\n    const templateId = input.template || 'base';\n    const timeoutMs = input.timeoutMs || 300000; // Default 5 minutes\n\n    try {\n      const sandbox = await Sandbox.create(templateId, {\n        timeoutMs,\n        metadata: input.metadata,\n        envs: input.envVars,\n      });\n\n      sandboxCache.set(sandbox.sandboxId, sandbox);\n\n      return {\n        sandboxId: sandbox.sandboxId,\n        templateId,\n        status: 'running',\n        startedAt: new Date().toISOString(),\n        clientId: sandbox.sandboxId,\n        metadata: input.metadata,\n      };\n    } catch (error) {\n      const message = error instanceof Error ? error.message : 'Unknown error';\n      throw new Error(`Failed to create sandbox with template \"${templateId}\": ${message}`);\n    }\n  },\n});\n\n/**\n * Get sandbox details\n */\nexport const getSandbox = tool({\n  description:\n    'Connect to and verify an existing E2B sandbox is running. Returns sandbox ID and connection status. Requires E2B_API_KEY.',\n  inputSchema: jsonSchema<SandboxIdInput>({\n    type: 'object',\n    properties: {\n      sandboxId: {\n        type: 'string',\n        description: 'ID of the sandbox to retrieve',\n      },\n    },\n    required: ['sandboxId'],\n    additionalProperties: false,\n  }),\n  async execute(input: SandboxIdInput): Promise<E2BSandbox> {\n    try {\n      const sandbox = await getOrConnectSandbox(input.sandboxId);\n      return {\n        sandboxId: sandbox.sandboxId,\n        templateId: (sandbox as unknown as { templateId?: string }).templateId || 'base',\n        status: 'running',\n      };\n    } catch (error) {\n      const message = error instanceof Error ? error.message : 'Unknown error';\n      throw new Error(`Failed to get sandbox ${input.sandboxId}: ${message}`);\n    }\n  },\n});\n\n/**\n * List all sandboxes\n */\nexport const listSandboxes = tool({\n  description:\n    'List all running E2B sandboxes in your account with their status and metadata. Requires E2B_API_KEY.',\n  inputSchema: jsonSchema<ListSandboxesInput>({\n    type: 'object',\n    properties: {\n      templateId: {\n        type: 'string',\n        description: 'Filter sandboxes by template ID',\n      },\n    },\n    required: [],\n    additionalProperties: false,\n  }),\n  async execute(_input: ListSandboxesInput): Promise<E2BSandboxList> {\n    const sandboxes = await Sandbox.list();\n    return {\n      sandboxes: sandboxes.map((s) => ({\n        sandboxId: s.sandboxId,\n        templateId: s.templateId || 'unknown',\n        status: 'running',\n        startedAt: s.startedAt?.toISOString(),\n        clientId: s.clientId,\n        metadata: s.metadata,\n      })),\n      count: sandboxes.length,\n    };\n  },\n});\n\n/**\n * Kill a sandbox\n */\nexport const killSandbox = tool({\n  description:\n    'Terminate a running E2B sandbox immediately. All data and processes are destroyed. Requires E2B_API_KEY.',\n  inputSchema: jsonSchema<SandboxIdInput>({\n    type: 'object',\n    properties: {\n      sandboxId: {\n        type: 'string',\n        description: 'ID of the sandbox to terminate',\n      },\n    },\n    required: ['sandboxId'],\n    additionalProperties: false,\n  }),\n  async execute(input: SandboxIdInput): Promise<{ killed: boolean; sandboxId: string }> {\n    const sandbox = await getOrConnectSandbox(input.sandboxId);\n    await sandbox.kill();\n    removeSandboxFromCache(input.sandboxId);\n    return { killed: true, sandboxId: input.sandboxId };\n  },\n});\n\n/**\n * Set sandbox timeout\n */\nexport const setTimeout = tool({\n  description:\n    'Set or extend the timeout for an E2B sandbox. The sandbox will be automatically killed when the timeout expires. Requires E2B_API_KEY.',\n  inputSchema: jsonSchema<SetTimeoutInput>({\n    type: 'object',\n    properties: {\n      sandboxId: {\n        type: 'string',\n        description: 'ID of the sandbox',\n      },\n      timeoutMs: {\n        type: 'number',\n        description: 'New timeout in milliseconds from now',\n      },\n    },\n    required: ['sandboxId', 'timeoutMs'],\n    additionalProperties: false,\n  }),\n  async execute(input: SetTimeoutInput): Promise<{ success: boolean; expiresAt: string }> {\n    const sandbox = await getOrConnectSandbox(input.sandboxId);\n    await sandbox.setTimeout(input.timeoutMs);\n    const expiresAt = new Date(Date.now() + input.timeoutMs).toISOString();\n    return { success: true, expiresAt };\n  },\n});\n\n/**\n * Run code in sandbox\n */\nexport const runCode = tool({\n  description:\n    'Execute code in an E2B sandbox. Supports Python (default), JavaScript, TypeScript, R, Java, and Bash with streaming output and result capture. Requires E2B_API_KEY.',\n  inputSchema: jsonSchema<RunCodeInput>({\n    type: 'object',\n    properties: {\n      sandboxId: {\n        type: 'string',\n        description: 'ID of the sandbox to execute in',\n      },\n      code: {\n        type: 'string',\n        description: 'Code to execute',\n      },\n      language: {\n        type: 'string',\n        description: 'Language: python (default), javascript, typescript, r, java, bash',\n      },\n      timeoutMs: {\n        type: 'number',\n        description: 'Execution timeout in milliseconds (default: 60000)',\n      },\n    },\n    required: ['sandboxId', 'code'],\n    additionalProperties: false,\n  }),\n  async execute(input: RunCodeInput): Promise<E2BExecResult> {\n    const startTime = Date.now();\n    const language = input.language || 'python';\n    const timeoutMs = input.timeoutMs || 60000;\n\n    try {\n      const sandbox = await getOrConnectSandbox(input.sandboxId);\n\n      const execution = await sandbox.runCode(input.code, {\n        language: language as 'python' | 'javascript' | 'typescript' | 'r' | 'java',\n        timeoutMs,\n      });\n\n      const duration = Date.now() - startTime;\n\n      return {\n        stdout: execution.logs.stdout.join('\\n'),\n        stderr: execution.logs.stderr.join('\\n'),\n        results: execution.results.map((r) => r.toJSON()),\n        error: execution.error\n          ? {\n              name: execution.error.name,\n              message: execution.error.value,\n              traceback: execution.error.traceback,\n            }\n          : undefined,\n        duration,\n      };\n    } catch (error) {\n      const message = error instanceof Error ? error.message : 'Unknown error';\n      throw new Error(`Failed to execute code in sandbox ${input.sandboxId}: ${message}`);\n    }\n  },\n});\n\n/**\n * Run shell command\n */\nexport const runCommand = tool({\n  description:\n    'Execute a shell command in an E2B sandbox with full shell access. Supports background processes and working directory. Requires E2B_API_KEY.',\n  inputSchema: jsonSchema<RunCommandInput>({\n    type: 'object',\n    properties: {\n      sandboxId: {\n        type: 'string',\n        description: 'ID of the sandbox',\n      },\n      command: {\n        type: 'string',\n        description: 'Shell command to execute',\n      },\n      cwd: {\n        type: 'string',\n        description: 'Working directory for the command',\n      },\n      background: {\n        type: 'boolean',\n        description: 'Run command in background (default: false)',\n      },\n      timeoutMs: {\n        type: 'number',\n        description: 'Command timeout in milliseconds (default: 60000)',\n      },\n    },\n    required: ['sandboxId', 'command'],\n    additionalProperties: false,\n  }),\n  async execute(\n    input: RunCommandInput\n  ): Promise<{ stdout: string; stderr: string; exitCode: number; processId?: string }> {\n    const timeoutMs = input.timeoutMs || 60000;\n\n    try {\n      const sandbox = await getOrConnectSandbox(input.sandboxId);\n\n      if (input.background) {\n        const process = await sandbox.commands.run(input.command, {\n          cwd: input.cwd,\n          background: true,\n          timeoutMs,\n        });\n        return {\n          stdout: '',\n          stderr: '',\n          exitCode: 0,\n          processId: String(process.pid),\n        };\n      }\n\n      const result = await sandbox.commands.run(input.command, {\n        cwd: input.cwd,\n        timeoutMs,\n      });\n\n      return {\n        stdout: result.stdout,\n        stderr: result.stderr,\n        exitCode: result.exitCode,\n      };\n    } catch (error) {\n      const message = error instanceof Error ? error.message : 'Unknown error';\n      throw new Error(`Failed to run command in sandbox ${input.sandboxId}: ${message}`);\n    }\n  },\n});\n\n/**\n * Write file to sandbox\n */\nexport const writeFile = tool({\n  description:\n    'Write content to a file in the E2B sandbox filesystem. Creates directories as needed. Requires E2B_API_KEY.',\n  inputSchema: jsonSchema<WriteFileInput>({\n    type: 'object',\n    properties: {\n      sandboxId: {\n        type: 'string',\n        description: 'ID of the sandbox',\n      },\n      path: {\n        type: 'string',\n        description: 'Absolute path in sandbox (e.g., /home/user/file.txt)',\n      },\n      content: {\n        type: 'string',\n        description: 'File content as string',\n      },\n    },\n    required: ['sandboxId', 'path', 'content'],\n    additionalProperties: false,\n  }),\n  async execute(input: WriteFileInput): Promise<{ success: boolean; path: string; size: number }> {\n    try {\n      const sandbox = await getOrConnectSandbox(input.sandboxId);\n      await sandbox.files.write(input.path, input.content);\n\n      return {\n        success: true,\n        path: input.path,\n        size: input.content.length,\n      };\n    } catch (error) {\n      const message = error instanceof Error ? error.message : 'Unknown error';\n      throw new Error(`Failed to write file ${input.path} in sandbox ${input.sandboxId}: ${message}`);\n    }\n  },\n});\n\n/**\n * Read file from sandbox\n */\nexport const readFile = tool({\n  description: 'Read content from a file in the E2B sandbox filesystem. Requires E2B_API_KEY.',\n  inputSchema: jsonSchema<ReadFileInput>({\n    type: 'object',\n    properties: {\n      sandboxId: {\n        type: 'string',\n        description: 'ID of the sandbox',\n      },\n      path: {\n        type: 'string',\n        description: 'Absolute path to file in sandbox',\n      },\n    },\n    required: ['sandboxId', 'path'],\n    additionalProperties: false,\n  }),\n  async execute(input: ReadFileInput): Promise<{ content: string; path: string; size: number }> {\n    const sandbox = await getOrConnectSandbox(input.sandboxId);\n    const content = await sandbox.files.read(input.path);\n\n    const textContent = typeof content === 'string' ? content : new TextDecoder().decode(content);\n\n    return {\n      content: textContent,\n      path: input.path,\n      size: textContent.length,\n    };\n  },\n});\n\n/**\n * List files in sandbox\n */\nexport const listFiles = tool({\n  description: 'List files and directories at a path in the E2B sandbox. Requires E2B_API_KEY.',\n  inputSchema: jsonSchema<ListFilesInput>({\n    type: 'object',\n    properties: {\n      sandboxId: {\n        type: 'string',\n        description: 'ID of the sandbox',\n      },\n      path: {\n        type: 'string',\n        description: 'Absolute path to list (e.g., /home/user)',\n      },\n    },\n    required: ['sandboxId', 'path'],\n    additionalProperties: false,\n  }),\n  async execute(input: ListFilesInput): Promise<{ entries: E2BFileInfo[]; count: number }> {\n    const sandbox = await getOrConnectSandbox(input.sandboxId);\n    const entries = await sandbox.files.list(input.path);\n\n    return {\n      entries: entries.map((e) => ({\n        name: e.name,\n        path: `${input.path}/${e.name}`,\n        type: e.type as 'file' | 'directory',\n      })),\n      count: entries.length,\n    };\n  },\n});\n\n/**\n * Upload file to sandbox\n */\nexport const uploadFile = tool({\n  description:\n    'Upload a file to the E2B sandbox from base64 content or a URL. Requires E2B_API_KEY.',\n  inputSchema: jsonSchema<UploadFileInput>({\n    type: 'object',\n    properties: {\n      sandboxId: {\n        type: 'string',\n        description: 'ID of the sandbox',\n      },\n      path: {\n        type: 'string',\n        description: 'Destination path in sandbox',\n      },\n      content: {\n        type: 'string',\n        description: 'Base64 encoded file content',\n      },\n      url: {\n        type: 'string',\n        description: 'URL to fetch file from (alternative to content)',\n      },\n    },\n    required: ['sandboxId', 'path'],\n    additionalProperties: false,\n  }),\n  async execute(input: UploadFileInput): Promise<{ success: boolean; path: string; size: number }> {\n    const sandbox = await getOrConnectSandbox(input.sandboxId);\n\n    let fileContent: ArrayBuffer;\n    if (input.url) {\n      const response = await fetch(input.url);\n      fileContent = await response.arrayBuffer();\n    } else if (input.content) {\n      const binaryString = atob(input.content);\n      const bytes = new Uint8Array(binaryString.length);\n      for (let i = 0; i < binaryString.length; i++) {\n        bytes[i] = binaryString.charCodeAt(i);\n      }\n      fileContent = bytes.buffer;\n    } else {\n      throw new Error('Either content or url must be provided');\n    }\n\n    await sandbox.files.write(input.path, fileContent);\n\n    return {\n      success: true,\n      path: input.path,\n      size: fileContent.byteLength,\n    };\n  },\n});\n\n/**\n * Download file from sandbox\n */\nexport const downloadFile = tool({\n  description: 'Download a file from the E2B sandbox as base64 content. Requires E2B_API_KEY.',\n  inputSchema: jsonSchema<DownloadFileInput>({\n    type: 'object',\n    properties: {\n      sandboxId: {\n        type: 'string',\n        description: 'ID of the sandbox',\n      },\n      path: {\n        type: 'string',\n        description: 'Path to file in sandbox',\n      },\n    },\n    required: ['sandboxId', 'path'],\n    additionalProperties: false,\n  }),\n  async execute(\n    input: DownloadFileInput\n  ): Promise<{ content: string; filename: string; size: number; mimeType: string }> {\n    const sandbox = await getOrConnectSandbox(input.sandboxId);\n    const content = await sandbox.files.read(input.path);\n\n    const filename = input.path.split('/').pop() || 'file';\n    const ext = filename.split('.').pop()?.toLowerCase() || '';\n\n    // Convert to base64 and calculate size\n    let base64Content: string;\n    let contentLength: number;\n\n    if (typeof content === 'string') {\n      base64Content = btoa(content);\n      contentLength = content.length;\n    } else {\n      const bytes = new Uint8Array(content as ArrayBuffer);\n      contentLength = bytes.length;\n      let binary = '';\n      for (let i = 0; i < bytes.length; i++) {\n        binary += String.fromCharCode(bytes[i]!);\n      }\n      base64Content = btoa(binary);\n    }\n\n    // Simple MIME type detection\n    const mimeTypes: Record<string, string> = {\n      txt: 'text/plain',\n      json: 'application/json',\n      js: 'text/javascript',\n      ts: 'text/typescript',\n      py: 'text/x-python',\n      html: 'text/html',\n      css: 'text/css',\n      png: 'image/png',\n      jpg: 'image/jpeg',\n      jpeg: 'image/jpeg',\n      gif: 'image/gif',\n      pdf: 'application/pdf',\n      zip: 'application/zip',\n    };\n\n    return {\n      content: base64Content,\n      filename,\n      size: contentLength,\n      mimeType: mimeTypes[ext] || 'application/octet-stream',\n    };\n  },\n});\n\n/**\n * Create directory in sandbox\n */\nexport const makeDirectory = tool({\n  description:\n    'Create a directory in the E2B sandbox filesystem. Creates parent directories as needed. Requires E2B_API_KEY.',\n  inputSchema: jsonSchema<MakeDirectoryInput>({\n    type: 'object',\n    properties: {\n      sandboxId: {\n        type: 'string',\n        description: 'ID of the sandbox',\n      },\n      path: {\n        type: 'string',\n        description: 'Absolute path of directory to create',\n      },\n    },\n    required: ['sandboxId', 'path'],\n    additionalProperties: false,\n  }),\n  async execute(input: MakeDirectoryInput): Promise<{ success: boolean; path: string }> {\n    const sandbox = await getOrConnectSandbox(input.sandboxId);\n    await sandbox.files.makeDir(input.path);\n    return { success: true, path: input.path };\n  },\n});\n\n/**\n * Watch directory for changes\n */\nexport const watchDirectory = tool({\n  description:\n    'Watch a directory in the E2B sandbox for file changes. Returns the initial state. Requires E2B_API_KEY.',\n  inputSchema: jsonSchema<WatchDirectoryInput>({\n    type: 'object',\n    properties: {\n      sandboxId: {\n        type: 'string',\n        description: 'ID of the sandbox',\n      },\n      path: {\n        type: 'string',\n        description: 'Directory path to watch',\n      },\n    },\n    required: ['sandboxId', 'path'],\n    additionalProperties: false,\n  }),\n  async execute(\n    input: WatchDirectoryInput\n  ): Promise<{ entries: E2BFileInfo[]; watcherId: string }> {\n    const sandbox = await getOrConnectSandbox(input.sandboxId);\n    const entries = await sandbox.files.list(input.path);\n\n    return {\n      entries: entries.map((e) => ({\n        name: e.name,\n        path: `${input.path}/${e.name}`,\n        type: e.type as 'file' | 'directory',\n      })),\n      watcherId: `watch-${input.sandboxId}-${Date.now()}`,\n    };\n  },\n});\n\n/**\n * Pause sandbox (using keepalive approach)\n */\nexport const pauseSandbox = tool({\n  description:\n    'Disconnect from an E2B sandbox while keeping it running. The sandbox continues running and can be reconnected later using resumeSandbox. State is preserved in the sandbox. Requires E2B_API_KEY.',\n  inputSchema: jsonSchema<SandboxIdInput>({\n    type: 'object',\n    properties: {\n      sandboxId: {\n        type: 'string',\n        description: 'ID of the sandbox to disconnect from',\n      },\n    },\n    required: ['sandboxId'],\n    additionalProperties: false,\n  }),\n  async execute(input: SandboxIdInput): Promise<{ success: boolean; sandboxId: string; status: string }> {\n    if (!input.sandboxId) {\n      throw new Error('sandboxId is required');\n    }\n\n    // Verify sandbox exists by attempting to connect first\n    try {\n      await getOrConnectSandbox(input.sandboxId);\n    } catch (error) {\n      const message = error instanceof Error ? error.message : 'Unknown error';\n      throw new Error(`Cannot pause sandbox ${input.sandboxId}: ${message}`);\n    }\n\n    // Disconnect from sandbox while keeping it running\n    removeSandboxFromCache(input.sandboxId);\n    return {\n      success: true,\n      sandboxId: input.sandboxId,\n      status: 'disconnected',\n    };\n  },\n});\n\n/**\n * Resume (reconnect to) sandbox\n */\nexport const resumeSandbox = tool({\n  description:\n    'Reconnect to a running E2B sandbox that was previously disconnected using pauseSandbox. Optionally set a new timeout. Requires E2B_API_KEY.',\n  inputSchema: jsonSchema<ResumeInput>({\n    type: 'object',\n    properties: {\n      sandboxId: {\n        type: 'string',\n        description: 'ID of the sandbox to reconnect to',\n      },\n      timeoutMs: {\n        type: 'number',\n        description: 'New timeout for the sandbox in milliseconds (optional)',\n      },\n    },\n    required: ['sandboxId'],\n    additionalProperties: false,\n  }),\n  async execute(input: ResumeInput): Promise<{ sandboxId: string; status: string }> {\n    try {\n      const sandbox = await Sandbox.connect(input.sandboxId);\n      if (input.timeoutMs) {\n        await sandbox.setTimeout(input.timeoutMs);\n      }\n      sandboxCache.set(sandbox.sandboxId, sandbox);\n      return { sandboxId: sandbox.sandboxId, status: 'running' };\n    } catch (error) {\n      const message = error instanceof Error ? error.message : 'Unknown error';\n      throw new Error(`Failed to reconnect to sandbox ${input.sandboxId}: ${message}`);\n    }\n  },\n});\n\n/**\n * Set environment variables\n */\nexport const setEnvVars = tool({\n  description:\n    'Set environment variables in an E2B sandbox. These persist for subsequent code executions in the same sandbox session. Special characters are safely escaped. Requires E2B_API_KEY.',\n  inputSchema: jsonSchema<SetEnvVarsInput>({\n    type: 'object',\n    properties: {\n      sandboxId: {\n        type: 'string',\n        description: 'ID of the sandbox',\n      },\n      envVars: {\n        type: 'object',\n        description: 'Key-value pairs of environment variables to set',\n        additionalProperties: { type: 'string' },\n      },\n    },\n    required: ['sandboxId', 'envVars'],\n    additionalProperties: false,\n  }),\n  async execute(input: SetEnvVarsInput): Promise<{ success: boolean; count: number }> {\n    try {\n      const sandbox = await getOrConnectSandbox(input.sandboxId);\n\n      // Escape shell special characters in values\n      const escapeForShell = (str: string): string => {\n        return str\n          .replace(/\\\\/g, '\\\\\\\\')\n          .replace(/\"/g, '\\\\\"')\n          .replace(/\\$/g, '\\\\$')\n          .replace(/`/g, '\\\\`')\n          .replace(/!/g, '\\\\!');\n      };\n\n      // Set each environment variable using shell export\n      for (const [key, value] of Object.entries(input.envVars)) {\n        await sandbox.commands.run(`export ${key}=\"${escapeForShell(value)}\"`);\n      }\n\n      return { success: true, count: Object.keys(input.envVars).length };\n    } catch (error) {\n      const message = error instanceof Error ? error.message : 'Unknown error';\n      throw new Error(`Failed to set environment variables in sandbox ${input.sandboxId}: ${message}`);\n    }\n  },\n});\n\n/**\n * Get sandbox metrics\n */\nexport const getMetrics = tool({\n  description:\n    'Get resource usage metrics for an E2B sandbox including CPU, memory, and network usage. Requires E2B_API_KEY.',\n  inputSchema: jsonSchema<SandboxIdInput>({\n    type: 'object',\n    properties: {\n      sandboxId: {\n        type: 'string',\n        description: 'ID of the sandbox',\n      },\n    },\n    required: ['sandboxId'],\n    additionalProperties: false,\n  }),\n  async execute(input: SandboxIdInput): Promise<E2BMetrics> {\n    const sandbox = await getOrConnectSandbox(input.sandboxId);\n\n    // Get metrics using /proc filesystem\n    const cpuResult = await sandbox.commands.run(\n      \"cat /proc/stat | grep 'cpu ' | awk '{usage=($2+$4)*100/($2+$4+$5)} END {print usage}'\"\n    );\n    const memResult = await sandbox.commands.run(\"free -m | grep Mem | awk '{print $3}'\");\n\n    return {\n      cpuPct: parseFloat(cpuResult.stdout) || 0,\n      memUsedMB: parseInt(memResult.stdout) || 0,\n      networkIngressMB: 0,\n      networkEgressMB: 0,\n    };\n  },\n});\n\n/**\n * Install Python packages\n */\nexport const installPackages = tool({\n  description:\n    'Install Python packages in an E2B Code Interpreter sandbox using pip. Requires E2B_API_KEY.',\n  inputSchema: jsonSchema<InstallPackagesInput>({\n    type: 'object',\n    properties: {\n      sandboxId: {\n        type: 'string',\n        description: 'ID of the sandbox',\n      },\n      packages: {\n        type: 'array',\n        items: { type: 'string' },\n        description: \"Array of package names to install (e.g., ['numpy', 'pandas==2.0.0'])\",\n      },\n    },\n    required: ['sandboxId', 'packages'],\n    additionalProperties: false,\n  }),\n  async execute(\n    input: InstallPackagesInput\n  ): Promise<{ success: boolean; installed: string[]; errors?: string[] }> {\n    const sandbox = await getOrConnectSandbox(input.sandboxId);\n\n    const installed: string[] = [];\n    const errors: string[] = [];\n\n    for (const pkg of input.packages) {\n      try {\n        const result = await sandbox.commands.run(`pip install ${pkg}`, { timeoutMs: 120000 });\n        if (result.exitCode === 0) {\n          installed.push(pkg);\n        } else {\n          errors.push(`${pkg}: ${result.stderr}`);\n        }\n      } catch (error) {\n        errors.push(`${pkg}: ${error instanceof Error ? error.message : 'Unknown error'}`);\n      }\n    }\n\n    return {\n      success: errors.length === 0,\n      installed,\n      errors: errors.length > 0 ? errors : undefined,\n    };\n  },\n});\n\n// ============================================================================\n// Default Export\n// ============================================================================\n\nexport default {\n  createSandbox,\n  getSandbox,\n  listSandboxes,\n  killSandbox,\n  setTimeout,\n  runCode,\n  runCommand,\n  writeFile,\n  readFile,\n  listFiles,\n  uploadFile,\n  downloadFile,\n  makeDirectory,\n  watchDirectory,\n  pauseSandbox,\n  resumeSandbox,\n  setEnvVars,\n  getMetrics,\n  installPackages,\n};\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,140 @@
+{
+  "name": "@tpmjs/tools-e2b",
+  "version": "0.1.0",
+  "description": "E2B cloud sandbox tools for AI code execution. Create sandboxes, run code in multiple languages, manage files, and control sandbox lifecycle.",
+  "type": "module",
+  "keywords": [
+    "tpmjs",
+    "e2b",
+    "sandbox",
+    "code-interpreter",
+    "ai",
+    "code-execution",
+    "cloud"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "type-check": "tsc --noEmit",
+    "clean": "rm -rf dist .turbo"
+  },
+  "devDependencies": {
+    "@tpmjs/tsconfig": "workspace:*",
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3"
+  },
+  "dependencies": {
+    "ai": "6.0.23",
+    "@e2b/code-interpreter": "^1.0.4"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/tpmjs/tpmjs.git",
+    "directory": "packages/tools/official/e2b"
+  },
+  "homepage": "https://tpmjs.com",
+  "license": "MIT",
+  "tpmjs": {
+    "category": "sandbox",
+    "frameworks": [
+      "vercel-ai"
+    ],
+    "env": [
+      {
+        "name": "E2B_API_KEY",
+        "description": "API key for E2B authentication. Get yours at https://e2b.dev/dashboard",
+        "required": true
+      }
+    ],
+    "tools": [
+      {
+        "name": "createSandbox",
+        "description": "Create a new E2B cloud sandbox from a template with configurable resources and timeout."
+      },
+      {
+        "name": "getSandbox",
+        "description": "Get details of an existing E2B sandbox by ID."
+      },
+      {
+        "name": "listSandboxes",
+        "description": "List all running E2B sandboxes in your account."
+      },
+      {
+        "name": "killSandbox",
+        "description": "Terminate a running E2B sandbox immediately."
+      },
+      {
+        "name": "setTimeout",
+        "description": "Set or extend the timeout for an E2B sandbox."
+      },
+      {
+        "name": "runCode",
+        "description": "Execute code in an E2B sandbox. Supports Python, JavaScript, TypeScript, R, Java, and Bash."
+      },
+      {
+        "name": "runCommand",
+        "description": "Execute a shell command in an E2B sandbox."
+      },
+      {
+        "name": "writeFile",
+        "description": "Write content to a file in the E2B sandbox filesystem."
+      },
+      {
+        "name": "readFile",
+        "description": "Read content from a file in the E2B sandbox filesystem."
+      },
+      {
+        "name": "listFiles",
+        "description": "List files and directories at a path in the E2B sandbox."
+      },
+      {
+        "name": "uploadFile",
+        "description": "Upload a file to the E2B sandbox from base64 content or URL."
+      },
+      {
+        "name": "downloadFile",
+        "description": "Download a file from the E2B sandbox as base64 content."
+      },
+      {
+        "name": "makeDirectory",
+        "description": "Create a directory in the E2B sandbox filesystem."
+      },
+      {
+        "name": "watchDirectory",
+        "description": "Watch a directory in the E2B sandbox for file changes."
+      },
+      {
+        "name": "pauseSandbox",
+        "description": "Pause a running E2B sandbox to preserve state."
+      },
+      {
+        "name": "resumeSandbox",
+        "description": "Resume a previously paused E2B sandbox."
+      },
+      {
+        "name": "setEnvVars",
+        "description": "Set environment variables in an E2B sandbox."
+      },
+      {
+        "name": "getMetrics",
+        "description": "Get resource usage metrics for an E2B sandbox."
+      },
+      {
+        "name": "installPackages",
+        "description": "Install Python packages in an E2B Code Interpreter sandbox."
+      }
+    ]
+  }
+}