deepagents-microsandbox 1.0.0__tar.gz

deepagents_microsandbox-1.0.0/.github/workflows/publish-to-pypi.yml

@@ -0,0 +1,73 @@
+name: Publish to PyPI
+
+on:
+  push:
+    tags:
+      - '*'
+
+permissions:
+  contents: read
+
+jobs:
+  package-test:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: Install uv
+        run: python -m pip install uv
+
+      - name: Run tests
+        run: |
+          uv sync
+          uv run --group dev pytest
+
+  release-build:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: Build release distributions
+        run: |
+          # NOTE: put your own distribution build steps here.
+          python -m pip install build
+          python -m build
+
+      - name: Upload distributions
+        uses: actions/upload-artifact@v4
+        with:
+          name: release-dists
+          path: dist/
+
+  pypi-publish:
+    runs-on: ubuntu-latest
+    needs:
+      - release-build
+    permissions:
+      id-token: write
+
+    environment:
+      name: pypi
+      url: https://pypi.org/p/b24api
+
+    steps:
+      - name: Retrieve release distributions
+        uses: actions/download-artifact@v4
+        with:
+          name: release-dists
+          path: dist/
+
+      - name: Publish release distributions to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          packages-dir: dist/

deepagents_microsandbox-1.0.0/.gitignore

@@ -0,0 +1,112 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+env/
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+.hypothesis/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# pyenv
+.python-version
+
+# celery beat schedule file
+celerybeat-schedule
+
+# SageMath parsed files
+*.sage.py
+
+# dotenv
+.env
+
+# virtualenv
+.venv
+venv/
+ENV/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+
+# this package
+.idea/
+.vscode/
+.cursor/
+.claude/
+.codex/
+.pytest_cache/
+.DS_Store
+*.pyc
+*.swp
+*.whl

deepagents_microsandbox-1.0.0/AGENTS.md

@@ -0,0 +1,73 @@
+# AGENTS.md
+
+## Project Overview
+`deepagents-microsandbox` is a Python package that implements a sandbox backend for the [DeepAgents](https://github.com/shkarupa-alex/deepagents) framework using [Microsandbox](https://github.com/shkarupa-alex/microsandbox). It allows DeepAgents to execute code and commands in isolated microsandbox environments.
+
+- **Repository**: [deepagents-microsandbox](https://github.com/shkarupa-alex/deepagents-microsandbox)
+- **Language**: Python 3.11+
+- **Dependency Manager**: `uv`
+
+## Project Structure
+
+```
+deepagents-microsandbox/
+├── deepagents_microsandbox/
+│   ├── backend.py           # MicrosandboxBackend implementation
+│   ├── provider.py          # MicrosandboxProvider implementation
+│   ├── backend_test.py      # Backend unit and integration tests
+│   └── provider_test.py     # Provider unit and integration tests
+├── pyproject.toml           # Project configuration and dependencies
+├── uv.lock                  # Dependency lock file
+└── AGENTS.md                # Documentation for AI coding agents
+```
+
+## Architecture
+
+This package provides two main components in the `deepagents_microsandbox` package:
+
+### 1. `MicrosandboxProvider` (`provider.py`)
+- Implements `SandboxProvider` from `deepagents`.
+- Responsible for the lifecycle of sandboxes (create, get, list, delete).
+- Interacts with the Microsandbox API server to provision environments.
+
+### 2. `MicrosandboxBackend` (`backend.py`)
+- Implements `SandboxBackend` from `deepagents`.
+- Represents a single active sandbox instance.
+- Handles file operations (`read_file`, `write_file`, `list_dir`) and command execution (`execute`).
+- Connects to a specific microsandbox instance via HTTP.
+
+## Development Standards
+
+### Dependency Management
+This project uses `uv` for all dependency management and running commands.
+- **Install dependencies**: `uv sync`
+- **Add dependency**: `uv add <package>`
+- **Add dev dependency**: `uv add --dev <package>`
+
+### Code Style
+- **Formatter/Linter**: `ruff` is used for linting and formatting. configuration is in `pyproject.toml`.
+- **Type Hints**: strict typing is enforced. usage of `mypy` is recommended.
+- **Docstrings**: Google-style docstrings are required for public APIs.
+
+### Testing
+Tests are located in `*_test.py` files alongside the source code.
+
+#### Unit Tests (Mocked)
+Tests that do not require a running microsandbox server. These mock network requests.
+```bash
+uv run pytest
+```
+
+#### Integration Tests (Real Server)
+Tests that run against a live microsandbox server.
+To run these, you must have a microsandbox server running (e.g., `msb server start --dev`).
+```bash
+MICROSANDBOX_DEV_SERVER=http://127.0.0.1:5555 uv run pytest
+```
+
+## Key Files
+- `pyproject.toml`: Project configuration, dependencies, and tool settings.
+- `deepagents_microsandbox/provider.py`: Provider implementation.
+- `deepagents_microsandbox/backend.py`: Backend implementation.
+- `deepagents_microsandbox/backend_test.py`: Tests for the backend.
+- `deepagents_microsandbox/provider_test.py`: Tests for the provider.

deepagents_microsandbox-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Shkarupa Alex
+
+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.

deepagents_microsandbox-1.0.0/PKG-INFO

@@ -0,0 +1,82 @@
+Metadata-Version: 2.4
+Name: deepagents-microsandbox
+Version: 1.0.0
+Summary: Microsandbox backend for DeepAgents
+License-File: LICENSE
+Requires-Python: >=3.11
+Requires-Dist: deepagents>=0.3.10
+Requires-Dist: microsandbox>=0.1.8
+Description-Content-Type: text/markdown
+
+# deepagents-microsandbox
+
+Microsandbox backend for the [DeepAgents](https://github.com/shkarupa-alex/deepagents) framework. This package enables DeepAgents to launch and control isolated sandbox environments using [Microsandbox](https://github.com/shkarupa-alex/microsandbox).
+
+## Key Features
+
+- **Sandbox Provider**: Manages the lifecycle of microsandbox instances (create, list, delete).
+- **Sandbox Backend**: Provides a standard interface for file operations and command execution within a sandbox.
+- **DeepAgents Integration**: Fully compatible with the DeepAgents `SandboxProvider` and `SandboxBackend` interfaces.
+
+## Installation
+
+```bash
+pip install deepagents-microsandbox
+```
+
+## Usage
+
+```python
+from deepagents_microsandbox import MicrosandboxProvider
+
+# Initialize the provider connecting to a microsandbox server
+provider = MicrosandboxProvider(server_url="http://localhost:5555")
+
+# Create or get a sandbox
+sandbox = provider.get_or_create(sandbox_id=None)
+
+# Execute a command
+result = sandbox.execute("echo 'Hello World'")
+print(result.stdout)
+
+# Clean up
+provider.delete(sandbox_id=sandbox.id)
+```
+
+## Development
+
+This project uses `uv` for dependency management.
+
+### Prerequisites
+
+- [uv](https://github.com/astral-sh/uv) installed.
+- Python 3.11 or higher.
+
+### Setup
+
+Install dependencies:
+
+```bash
+uv sync
+```
+
+### Testing
+
+Tests are split into unit tests (mocked) and integration tests (requiring a real server).
+
+**Run Unit Tests (Mocked)**
+These tests mock the HTTP interactions and do not require a running server.
+```bash
+uv run pytest
+```
+
+**Run Integration Tests**
+These tests verify behavior against a real microsandbox server.
+1. Start a microsandbox server in dev mode:
+   ```bash
+   msb server start --dev
+   ```
+2. Run the tests with the environment variable:
+   ```bash
+   MICROSANDBOX_DEV_SERVER=http://127.0.0.1:5555 uv run pytest
+   ```

deepagents_microsandbox-1.0.0/README.md

@@ -0,0 +1,72 @@
+# deepagents-microsandbox
+
+Microsandbox backend for the [DeepAgents](https://github.com/shkarupa-alex/deepagents) framework. This package enables DeepAgents to launch and control isolated sandbox environments using [Microsandbox](https://github.com/shkarupa-alex/microsandbox).
+
+## Key Features
+
+- **Sandbox Provider**: Manages the lifecycle of microsandbox instances (create, list, delete).
+- **Sandbox Backend**: Provides a standard interface for file operations and command execution within a sandbox.
+- **DeepAgents Integration**: Fully compatible with the DeepAgents `SandboxProvider` and `SandboxBackend` interfaces.
+
+## Installation
+
+```bash
+pip install deepagents-microsandbox
+```
+
+## Usage
+
+```python
+from deepagents_microsandbox import MicrosandboxProvider
+
+# Initialize the provider connecting to a microsandbox server
+provider = MicrosandboxProvider(server_url="http://localhost:5555")
+
+# Create or get a sandbox
+sandbox = provider.get_or_create(sandbox_id=None)
+
+# Execute a command
+result = sandbox.execute("echo 'Hello World'")
+print(result.stdout)
+
+# Clean up
+provider.delete(sandbox_id=sandbox.id)
+```
+
+## Development
+
+This project uses `uv` for dependency management.
+
+### Prerequisites
+
+- [uv](https://github.com/astral-sh/uv) installed.
+- Python 3.11 or higher.
+
+### Setup
+
+Install dependencies:
+
+```bash
+uv sync
+```
+
+### Testing
+
+Tests are split into unit tests (mocked) and integration tests (requiring a real server).
+
+**Run Unit Tests (Mocked)**
+These tests mock the HTTP interactions and do not require a running server.
+```bash
+uv run pytest
+```
+
+**Run Integration Tests**
+These tests verify behavior against a real microsandbox server.
+1. Start a microsandbox server in dev mode:
+   ```bash
+   msb server start --dev
+   ```
+2. Run the tests with the environment variable:
+   ```bash
+   MICROSANDBOX_DEV_SERVER=http://127.0.0.1:5555 uv run pytest
+   ```

deepagents_microsandbox-1.0.0/deepagents_microsandbox/__init__.py

@@ -0,0 +1,21 @@
+"""Microsandbox integration for DeepAgents.
+
+This package provides:
+- MicrosandboxBackend: Sandbox backend for executing commands in Microsandbox containers
+- MicrosandboxProvider: Provider for managing Microsandbox lifecycle
+
+Example usage:
+    ```python
+    from deepagents_microsandbox import MicrosandboxBackend, MicrosandboxProvider
+
+    provider = MicrosandboxProvider(server_url="http://localhost:5555")
+    sandbox = provider.get_or_create(sandbox_id=None)
+    result = sandbox.execute("echo 'Hello'")
+    provider.delete(sandbox_id=sandbox.id)
+    ```
+"""
+
+from deepagents_microsandbox.backend import MicrosandboxBackend
+from deepagents_microsandbox.provider import MicrosandboxProvider
+
+__all__ = ["MicrosandboxBackend", "MicrosandboxProvider"]