langchain-e2b 0.0.1__tar.gz

langchain_e2b-0.0.1/.github/workflows/ci.yml

@@ -0,0 +1,77 @@
+name: ci
+
+on:
+  pull_request:
+  push:
+    branches: [main]
+
+permissions:
+  contents: read
+
+jobs:
+  test:
+    name: test (${{ matrix.python-version }})
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.11", "3.12", "3.13", "3.14"]
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10 # v6
+
+      - name: Set up uv
+        uses: astral-sh/setup-uv@08807647e7069bb48b6ef5acd8ec9567f424441b # v8.1.0
+        with:
+          version: "0.11.19"
+          python-version: ${{ matrix.python-version }}
+          enable-cache: true
+          cache-dependency-glob: uv.lock
+
+      - name: Install dependencies
+        run: uv sync --group test --locked
+
+      - name: Run unit tests
+        run: make test
+
+  lint:
+    name: lint
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10 # v6
+
+      - name: Set up uv
+        uses: astral-sh/setup-uv@08807647e7069bb48b6ef5acd8ec9567f424441b # v8.1.0
+        with:
+          version: "0.11.19"
+          python-version: "3.13"
+          enable-cache: true
+          cache-dependency-glob: uv.lock
+
+      - name: Install dependencies
+        run: uv sync --group test --locked
+
+      - name: Run lint and type checks
+        run: make lint
+
+  build:
+    name: build package
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10 # v6
+
+      - name: Set up uv
+        uses: astral-sh/setup-uv@08807647e7069bb48b6ef5acd8ec9567f424441b # v8.1.0
+        with:
+          version: "0.11.19"
+          python-version: "3.13"
+          enable-cache: true
+          cache-dependency-glob: uv.lock
+
+      - name: Build distributions
+        run: uv build --no-sources

langchain_e2b-0.0.1/.github/workflows/release.yml

@@ -0,0 +1,66 @@
+name: release
+
+on:
+  release:
+    types: [published]
+
+permissions:
+  contents: read
+
+jobs:
+  build:
+    name: build and test distributions
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10 # v6
+
+      - name: Set up uv
+        uses: astral-sh/setup-uv@08807647e7069bb48b6ef5acd8ec9567f424441b # v8.1.0
+        with:
+          version: "0.11.19"
+          python-version: "3.13"
+          enable-cache: true
+          cache-dependency-glob: uv.lock
+
+      - name: Install dependencies
+        run: uv sync --group test --locked
+
+      - name: Run unit tests
+        run: make test
+
+      - name: Run lint and type checks
+        run: make lint
+
+      - name: Build distributions
+        run: uv build --no-sources
+
+      - name: Upload distributions
+        uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
+        with:
+          name: python-package-distributions
+          path: dist/*
+          if-no-files-found: error
+          retention-days: 7
+
+  publish:
+    name: publish to PyPI
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/p/langchain-e2b
+    permissions:
+      contents: read
+      id-token: write
+
+    steps:
+      - name: Download distributions
+        uses: actions/download-artifact@634f93cb2916e3fdff6788551b99b062d0335ce0 # v5
+        with:
+          name: python-package-distributions
+          path: dist
+
+      - name: Publish distributions to PyPI
+        uses: pypa/gh-action-pypi-publish@cef221092ed1bacb1cc03d23a2d87d1d172e277b # release/v1

langchain_e2b-0.0.1/.gitignore

@@ -0,0 +1,17 @@
+.venv/
+__pycache__/
+*.py[cod]
+*.egg-info/
+
+.coverage
+htmlcov/
+.pytest_cache/
+.ruff_cache/
+.ty/
+
+build/
+dist/
+
+.env
+.env.*
+.DS_Store

langchain_e2b-0.0.1/CHANGELOG.md

@@ -0,0 +1,7 @@
+<!-- markdownlint-disable MD024 -->
+
+# Changelog
+
+## 0.0.1
+
+- Initial E2B sandbox integration for Deep Agents.

langchain_e2b-0.0.1/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.

langchain_e2b-0.0.1/Makefile

@@ -0,0 +1,64 @@
+.PHONY: format lint type typecheck test tests integration_test integration_tests test_watch benchmark help lint_package
+
+.DEFAULT_GOAL := help
+
+.EXPORT_ALL_VARIABLES:
+UV_FROZEN = true
+
+######################
+# TESTING
+######################
+
+TEST_FILE ?= tests/unit_tests/
+PYTEST_EXTRA ?=
+
+integration_test integration_tests: TEST_FILE=tests/integration_tests/
+
+test: ## Run unit tests
+test tests:
+	uv run --group test pytest -vvv $(PYTEST_EXTRA) --disable-socket --allow-unix-socket $(TEST_FILE)
+
+integration_test: ## Run integration tests
+integration_test integration_tests:
+	uv run --group test pytest -vvv --timeout 30 $(TEST_FILE)
+
+test_watch: ## Run tests in watch mode
+	uv run --group test ptw --now . -- -vv $(TEST_FILE)
+
+benchmark: ## Run benchmark tests
+	uv run --group test pytest ./tests -m benchmark
+
+######################
+# LINTING AND FORMATTING
+######################
+
+PYTHON_FILES=.
+lint format: PYTHON_FILES=.
+lint_diff format_diff: PYTHON_FILES=$(shell git diff --name-only --diff-filter=d main 2>/dev/null | grep -E '\.py$$|\.ipynb$$' || true)
+lint_package: ## Lint only the package
+lint_package: PYTHON_FILES=langchain_e2b
+
+lint: ## Run linters and type checker
+lint lint_diff lint_package:
+	[ "$(PYTHON_FILES)" = "" ] || uv run --all-groups ruff check $(PYTHON_FILES)
+	[ "$(PYTHON_FILES)" = "" ] || uv run --all-groups ruff format $(PYTHON_FILES) --diff
+	$(MAKE) type
+
+type: ## Run type checker
+type typecheck:
+	uv run --all-groups ty check langchain_e2b
+
+format: ## Run code formatters
+format format_diff:
+	[ "$(PYTHON_FILES)" = "" ] || uv run --all-groups ruff format $(PYTHON_FILES)
+	[ "$(PYTHON_FILES)" = "" ] || uv run --all-groups ruff check --fix $(PYTHON_FILES)
+
+######################
+# HELP
+######################
+
+help: ## Show this help message
+	@echo "Usage: make [target] [TEST_FILE=path/to/tests/]"
+	@echo ""
+	@echo "Targets:"
+	@awk 'BEGIN {FS = ":.*##"} /^[a-zA-Z_-]+:.*##/ {printf "  %-20s %s\n", $$1, $$2}' $(MAKEFILE_LIST)

langchain_e2b-0.0.1/PKG-INFO

@@ -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/README.md

@@ -0,0 +1,57 @@
+# 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/langchain_e2b/__init__.py

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

langchain_e2b-0.0.1/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-0.0.1/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/pyproject.toml

@@ -0,0 +1,95 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "langchain-e2b"
+description = "E2B sandbox integration for Deep Agents"
+license = { text = "MIT" }
+readme = "README.md"
+
+classifiers = [
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "Topic :: Scientific/Engineering :: Artificial Intelligence",
+]
+
+version = "0.0.1"
+requires-python = ">=3.11,<4.0"
+dependencies = [
+    "deepagents>=0.6.0,<0.7.0",
+    "e2b>=2.25.1,<3.0.0",
+]
+
+[tool.hatch.build.targets.wheel]
+packages = ["langchain_e2b"]
+
+[project.urls]
+Homepage = "https://github.com/e2b-dev/langchain-e2b"
+Repository = "https://github.com/e2b-dev/langchain-e2b"
+Documentation = "https://github.com/e2b-dev/langchain-e2b#readme"
+Issues = "https://github.com/e2b-dev/langchain-e2b/issues"
+
+[dependency-groups]
+test = [
+    "pytest>=7.3.0,<10.0.0",
+    "pytest-cov",
+    "pytest-socket",
+    "pytest-xdist",
+    "pytest-timeout>=2.3.1,<3.0.0",
+    "pytest-asyncio>=1.3.0",
+    "ruff>=0.13.1,<0.16.0",
+    "ty>=0.0.1,<1.0.0",
+    "langchain-tests>=1.1.6",
+]
+
+[tool.uv]
+constraint-dependencies = ["urllib3>=2.6.3"]
+
+[tool.ty.environment]
+python-version = "3.11"
+
+[tool.ty.rules]
+# https://docs.astral.sh/ty/rules/
+division-by-zero = "error"
+
+[tool.ruff.format]
+docstring-code-format = true
+
+[tool.ruff.lint]
+select = ["ALL"]
+ignore = [
+    "COM812",  # Messes with the formatter
+    "ISC001",  # Messes with the formatter
+    "ANN401",  # Dynamically typed expressions (typing.Any) are disallowed — too strict for generic wrappers
+]
+extend-safe-fixes = ["PLR6201"]
+
+[tool.ruff.lint.pydocstyle]
+convention = "google"
+ignore-var-parameters = true  # ignore missing documentation for *args and **kwargs parameters
+
+[tool.ruff.lint.flake8-tidy-imports]
+ban-relative-imports = "all"
+
+[tool.coverage.run]
+omit = ["tests/*"]
+
+[tool.pytest.ini_options]
+addopts = "--strict-markers --strict-config --durations=5"
+testpaths = ["tests"]
+markers = [
+    "requires: mark tests as requiring a specific library",
+    "compile: mark placeholder test used to compile integration tests without running them",
+    "scheduled: mark tests to run in scheduled testing",
+]
+asyncio_mode = "auto"
+filterwarnings = []
+
+[tool.ruff.lint.extend-per-file-ignores]
+"tests/**/*.py" = ["D", "S101"]

langchain_e2b-0.0.1/tests/__init__.py

@@ -0,0 +1 @@
+"""Tests for `langchain-e2b`."""

langchain_e2b-0.0.1/tests/integration_tests/__init__.py

@@ -0,0 +1 @@
+"""Integration tests for `langchain-e2b`."""