langchain-e2b 0.0.1__py3-none-any.whl

langchain_e2b/__init__.py

@@ -0,0 +1,5 @@
+"""E2B sandbox integration for Deep Agents."""
+
+from langchain_e2b.sandbox import E2BSandbox
+
+__all__ = ["E2BSandbox"]

langchain_e2b/_version.py

@@ -0,0 +1,5 @@
+"""Version information for `langchain-e2b`."""
+
+# Keep the `x-release-please-version` annotation — release-please uses it to
+# bump `__version__` in sync with `pyproject.toml` on every release PR.
+__version__ = "0.0.1"  # x-release-please-version

langchain_e2b/sandbox.py

@@ -0,0 +1,180 @@
+"""E2B sandbox backend implementation."""
+
+from __future__ import annotations
+
+import e2b
+from deepagents.backends.protocol import (
+    ExecuteResponse,
+    FileDownloadResponse,
+    FileUploadResponse,
+)
+from deepagents.backends.sandbox import BaseSandbox
+
+DEFAULT_WORKDIR = "/home/user"
+TIMEOUT_EXIT_CODE = 124
+
+
+def _combine_output(stdout: str | None, stderr: str | None) -> str:
+    output = stdout or ""
+    if stderr:
+        output += "\n" + stderr if output else stderr
+    return output
+
+
+class E2BSandbox(BaseSandbox):
+    """Sandbox backend that operates on an existing E2B sandbox."""
+
+    def __init__(
+        self,
+        *,
+        sandbox: e2b.Sandbox,
+        workdir: str = DEFAULT_WORKDIR,
+        timeout: int = 30 * 60,
+    ) -> None:
+        """Create a backend wrapping an existing E2B sandbox.
+
+        Args:
+            sandbox: Existing E2B sandbox instance to wrap.
+            workdir: Working directory for command execution.
+            timeout: Default command timeout in seconds when `execute()` is
+                called without an explicit `timeout`.
+        """
+        self._sandbox = sandbox
+        self._workdir = workdir
+        self._default_timeout = timeout
+
+    @property
+    def id(self) -> str:
+        """Return the E2B sandbox id."""
+        return self._sandbox.sandbox_id
+
+    def execute(
+        self,
+        command: str,
+        *,
+        timeout: int | None = None,
+    ) -> ExecuteResponse:
+        """Execute a shell command inside the sandbox.
+
+        Args:
+            command: Shell command string to execute.
+            timeout: Maximum time in seconds to wait for this command.
+
+                If None, uses the backend's default timeout.
+
+        Returns:
+            ExecuteResponse containing output, exit code, and truncation flag.
+
+        Raises:
+            ValueError: If `timeout` is negative.
+        """
+        effective_timeout = timeout if timeout is not None else self._default_timeout
+        if effective_timeout < 0:
+            msg = f"timeout must be non-negative, got {effective_timeout}"
+            raise ValueError(msg)
+
+        try:
+            result = self._sandbox.commands.run(
+                command,
+                cwd=self._workdir,
+                timeout=effective_timeout,
+            )
+        except e2b.CommandExitException as exc:
+            return ExecuteResponse(
+                output=_combine_output(exc.stdout, exc.stderr),
+                exit_code=exc.exit_code,
+                truncated=False,
+            )
+        except e2b.TimeoutException:
+            return ExecuteResponse(
+                output=f"Command timed out after {effective_timeout} seconds",
+                exit_code=TIMEOUT_EXIT_CODE,
+                truncated=False,
+            )
+        except e2b.SandboxException as exc:
+            return ExecuteResponse(
+                output=f"Error executing command ({type(exc).__name__}): {exc}",
+                exit_code=1,
+                truncated=False,
+            )
+
+        return ExecuteResponse(
+            output=_combine_output(result.stdout, result.stderr),
+            exit_code=result.exit_code,
+            truncated=False,
+        )
+
+    def _read_file(self, path: str) -> FileDownloadResponse:
+        if not path.startswith("/"):
+            return FileDownloadResponse(path=path, content=None, error="invalid_path")
+
+        try:
+            info = self._sandbox.files.get_info(path)
+            if info.type == e2b.FileType.DIR:
+                return FileDownloadResponse(
+                    path=path,
+                    content=None,
+                    error="is_directory",
+                )
+            content = bytes(self._sandbox.files.read(path, format="bytes"))
+            return FileDownloadResponse(path=path, content=content, error=None)
+        except e2b.FileNotFoundException:
+            return FileDownloadResponse(path=path, content=None, error="file_not_found")
+        except e2b.InvalidArgumentException:
+            return FileDownloadResponse(path=path, content=None, error="invalid_path")
+        except PermissionError:
+            return FileDownloadResponse(
+                path=path,
+                content=None,
+                error="permission_denied",
+            )
+
+    def _write_file(self, path: str, content: bytes) -> FileUploadResponse:
+        if not path.startswith("/"):
+            return FileUploadResponse(path=path, error="invalid_path")
+
+        error: str | None = None
+        try:
+            info = self._sandbox.files.get_info(path)
+            if info.type == e2b.FileType.DIR:
+                error = "is_directory"
+        except e2b.FileNotFoundException:
+            pass
+        except e2b.InvalidArgumentException:
+            error = "invalid_path"
+        except PermissionError:
+            error = "permission_denied"
+
+        if error is None:
+            try:
+                self._sandbox.files.write(path, content)
+            except e2b.FileNotFoundException:
+                error = "file_not_found"
+            except e2b.InvalidArgumentException:
+                error = "invalid_path"
+            except PermissionError:
+                error = "permission_denied"
+
+        return FileUploadResponse(path=path, error=error)
+
+    def download_files(self, paths: list[str]) -> list[FileDownloadResponse]:
+        """Download files from the sandbox.
+
+        Args:
+            paths: Absolute sandbox file paths to download.
+
+        Returns:
+            Download responses in the same order as `paths`.
+        """
+        return [self._read_file(path) for path in paths]
+
+    def upload_files(self, files: list[tuple[str, bytes]]) -> list[FileUploadResponse]:
+        """Upload files into the sandbox.
+
+        Args:
+            files: `(path, content)` pairs to write.
+
+        Returns:
+            Upload responses in the same order as `files`.
+        """
+        return [self._write_file(path, content) for path, content in files]

langchain_e2b-0.0.1.dist-info/METADATA

@@ -0,0 +1,80 @@
+Metadata-Version: 2.4
+Name: langchain-e2b
+Version: 0.0.1
+Summary: E2B sandbox integration for Deep Agents
+Project-URL: Homepage, https://github.com/e2b-dev/langchain-e2b
+Project-URL: Repository, https://github.com/e2b-dev/langchain-e2b
+Project-URL: Documentation, https://github.com/e2b-dev/langchain-e2b#readme
+Project-URL: Issues, https://github.com/e2b-dev/langchain-e2b/issues
+License: MIT
+License-File: LICENSE
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: <4.0,>=3.11
+Requires-Dist: deepagents<0.7.0,>=0.6.0
+Requires-Dist: e2b<3.0.0,>=2.25.1
+Description-Content-Type: text/markdown
+
+# langchain-e2b
+
+[![PyPI - Version](https://img.shields.io/pypi/v/langchain-e2b?label=%20)](https://pypi.org/project/langchain-e2b/#history)
+[![PyPI - License](https://img.shields.io/pypi/l/langchain-e2b)](https://opensource.org/licenses/MIT)
+[![PyPI - Downloads](https://img.shields.io/pepy/dt/langchain-e2b)](https://pypistats.org/packages/langchain-e2b)
+
+## Quick Install
+
+After the package is published:
+
+```bash
+pip install langchain-e2b
+```
+
+```python
+from e2b import Sandbox
+
+from langchain_e2b import E2BSandbox
+
+sandbox = Sandbox.create()
+backend = E2BSandbox(sandbox=sandbox)
+
+try:
+    result = backend.execute("echo hello")
+    print(result.output)
+finally:
+    sandbox.kill()
+```
+
+## What is this?
+
+`langchain-e2b` adapts an existing E2B sandbox to the Deep Agents sandbox
+protocol. It uses the low-level `e2b` SDK so Deep Agents can run shell commands
+and move files through the standard Deep Agents backend interface.
+
+This package intentionally does not hide E2B sandbox lifecycle management. Use
+the E2B SDK to create, connect to, configure, and kill sandboxes, then pass the
+connected sandbox object to `E2BSandbox`.
+
+## Contributing
+
+Contributions are welcome. Keep the adapter focused on implementing the Deep
+Agents sandbox backend protocol over the official E2B SDK.
+
+## Development
+
+```bash
+uv sync --group test
+make test
+make lint
+```
+
+Integration tests require `E2B_API_KEY`:
+
+```bash
+E2B_API_KEY=... make integration_tests
+```

langchain_e2b-0.0.1.dist-info/RECORD

@@ -0,0 +1,7 @@
+langchain_e2b/__init__.py,sha256=aBCl_SstOPDdsgMiJc7Zakw6AFxPkdV03eRBQIsIP2U,119
+langchain_e2b/_version.py,sha256=ppf0d_xCU41RiniqB_Ksx2oWJ-Bbiglg-75x4BdUPoY,249
+langchain_e2b/sandbox.py,sha256=kQ2QAFyd9hnmmgxftPAqElUVujKJayil-It8IPXJoHg,5972
+langchain_e2b-0.0.1.dist-info/METADATA,sha256=qcK_KLHiJBd3ABb0EPr95p848ud-v1olFYT1gW35or8,2430
+langchain_e2b-0.0.1.dist-info/WHEEL,sha256=mffPy8wBnZQn2VnJUU5jE99KsxaSfiyMHV9Yt0aLVxs,87
+langchain_e2b-0.0.1.dist-info/licenses/LICENSE,sha256=TsZ-TKbmch26hJssqCJhWXyGph7iFLvyFBYAa3stBHg,1067
+langchain_e2b-0.0.1.dist-info/RECORD,,

langchain_e2b-0.0.1.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.30.1
+Root-Is-Purelib: true
+Tag: py3-none-any

langchain_e2b-0.0.1.dist-info/licenses/LICENSE

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