axio-tools-docker 0.6.1__tar.gz → 0.7.0__tar.gz

{axio_tools_docker-0.6.1 → axio_tools_docker-0.7.0}/.gitignore

@@ -10,3 +10,5 @@ dist/
 build/
 _build/
 .DS_Store
+*.sqlite
+*.db

{axio_tools_docker-0.6.1 → axio_tools_docker-0.7.0}/PKG-INFO

@@ -1,9 +1,9 @@
 Metadata-Version: 2.4
 Name: axio-tools-docker
-Version: 0.6.1
+Version: 0.7.0
 Summary: Docker sandbox tools for Axio
-Project-URL: Homepage, https://github.com/axio-agent/axio-tools-docker
-Project-URL: Repository, https://github.com/axio-agent/axio-tools-docker
+Project-URL: Homepage, https://github.com/mosquito/axio-agent
+Project-URL: Repository, https://github.com/mosquito/axio-agent
 License: MIT
 License-File: LICENSE
 Keywords: agent,ai,docker,llm,sandbox,tools
@@ -17,7 +17,7 @@ Description-Content-Type: text/markdown
 [![Python](https://img.shields.io/pypi/pyversions/axio-tools-docker)](https://pypi.org/project/axio-tools-docker/)
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
 
-Docker sandbox tools for [axio](https://github.com/axio-agent/axio).
+Docker sandbox tools for [axio](https://github.com/mosquito/axio-agent).
 
 Run agent-generated code and commands inside isolated Docker containers. The agent gets `sandbox_exec`, `sandbox_write`, and `sandbox_read` tools that operate entirely within the sandbox — the host filesystem stays untouched.
 
@@ -81,8 +81,39 @@ async def main() -> None:
 | `sandbox_write` | Write a file into the container's filesystem |
 | `sandbox_read` | Read a file from the container's filesystem |
 
+## Container lifecycle
+
+The sandbox container is created **lazily** on the first tool call (`sandbox_exec`,
+`sandbox_write`, or `sandbox_read`) — `plugin.init()` itself does not start Docker.
+The same container is reused for all subsequent tool calls within the session.
+
+When `await plugin.close()` is called the container is stopped and removed
+(`docker rm -f`). You should always call `close()` when the agent session ends
+to avoid leaving containers behind:
+
+```python
+async def run_with_cleanup(agent, ctx, plugin):
+    try:
+        result = await agent.run("...", ctx)
+    finally:
+        await plugin.close()
+```
+
+If Docker is not installed or the `docker` CLI is not on `PATH`, the container
+creation step will raise a `RuntimeError` on the first tool call. You can detect
+this before starting a session with `SandboxManager.docker_available()` (returns
+`True` if the `docker` executable is found on `PATH`).
+
 ## Configuration
 
+| Field | Type | Default | Description |
+|-------|------|---------|-------------|
+| `image` | `str` | `"python:latest"` | Docker image to use for the sandbox container |
+| `memory` | `str` | `"256m"` | Memory limit passed to `docker run --memory` (e.g., `"512m"`, `"1g"`) |
+| `cpus` | `str` | `"1.0"` | CPU limit passed to `docker run --cpus` |
+| `network` | `bool` | `False` | Whether to allow network access. When `False`, `--network none` is set on the container. |
+| `workdir` | `str` | `"/workspace"` | Working directory inside the container |
+
 <!-- name: test_readme_config -->
 ```python
 from axio_tools_docker.config import SandboxConfig
@@ -104,7 +135,7 @@ docker = "axio_tools_docker.plugin:DockerPlugin"
 
 ## Part of the axio ecosystem
 
-[axio](https://github.com/axio-agent/axio) · [axio-tools-local](https://github.com/axio-agent/axio-tools-local) · [axio-tools-mcp](https://github.com/axio-agent/axio-tools-mcp) · [axio-tui](https://github.com/axio-agent/axio-tui)
+[axio](https://github.com/mosquito/axio-agent) · [axio-tools-local](https://github.com/mosquito/axio-agent) · [axio-tools-mcp](https://github.com/mosquito/axio-agent) · [axio-tui](https://github.com/mosquito/axio-agent)
 
 ## License
 

{axio_tools_docker-0.6.1 → axio_tools_docker-0.7.0}/README.md

@@ -4,7 +4,7 @@
 [![Python](https://img.shields.io/pypi/pyversions/axio-tools-docker)](https://pypi.org/project/axio-tools-docker/)
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
 
-Docker sandbox tools for [axio](https://github.com/axio-agent/axio).
+Docker sandbox tools for [axio](https://github.com/mosquito/axio-agent).
 
 Run agent-generated code and commands inside isolated Docker containers. The agent gets `sandbox_exec`, `sandbox_write`, and `sandbox_read` tools that operate entirely within the sandbox — the host filesystem stays untouched.
 
@@ -68,8 +68,39 @@ async def main() -> None:
 | `sandbox_write` | Write a file into the container's filesystem |
 | `sandbox_read` | Read a file from the container's filesystem |
 
+## Container lifecycle
+
+The sandbox container is created **lazily** on the first tool call (`sandbox_exec`,
+`sandbox_write`, or `sandbox_read`) — `plugin.init()` itself does not start Docker.
+The same container is reused for all subsequent tool calls within the session.
+
+When `await plugin.close()` is called the container is stopped and removed
+(`docker rm -f`). You should always call `close()` when the agent session ends
+to avoid leaving containers behind:
+
+```python
+async def run_with_cleanup(agent, ctx, plugin):
+    try:
+        result = await agent.run("...", ctx)
+    finally:
+        await plugin.close()
+```
+
+If Docker is not installed or the `docker` CLI is not on `PATH`, the container
+creation step will raise a `RuntimeError` on the first tool call. You can detect
+this before starting a session with `SandboxManager.docker_available()` (returns
+`True` if the `docker` executable is found on `PATH`).
+
 ## Configuration
 
+| Field | Type | Default | Description |
+|-------|------|---------|-------------|
+| `image` | `str` | `"python:latest"` | Docker image to use for the sandbox container |
+| `memory` | `str` | `"256m"` | Memory limit passed to `docker run --memory` (e.g., `"512m"`, `"1g"`) |
+| `cpus` | `str` | `"1.0"` | CPU limit passed to `docker run --cpus` |
+| `network` | `bool` | `False` | Whether to allow network access. When `False`, `--network none` is set on the container. |
+| `workdir` | `str` | `"/workspace"` | Working directory inside the container |
+
 <!-- name: test_readme_config -->
 ```python
 from axio_tools_docker.config import SandboxConfig
@@ -91,7 +122,7 @@ docker = "axio_tools_docker.plugin:DockerPlugin"
 
 ## Part of the axio ecosystem
 
-[axio](https://github.com/axio-agent/axio) · [axio-tools-local](https://github.com/axio-agent/axio-tools-local) · [axio-tools-mcp](https://github.com/axio-agent/axio-tools-mcp) · [axio-tui](https://github.com/axio-agent/axio-tui)
+[axio](https://github.com/mosquito/axio-agent) · [axio-tools-local](https://github.com/mosquito/axio-agent) · [axio-tools-mcp](https://github.com/mosquito/axio-agent) · [axio-tui](https://github.com/mosquito/axio-agent)
 
 ## License
 

{axio_tools_docker-0.6.1 → axio_tools_docker-0.7.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "axio-tools-docker"
-version = "0.6.1"
+version = "0.7.0"
 description = "Docker sandbox tools for Axio"
 readme = "README.md"
 requires-python = ">=3.12"
@@ -13,8 +13,8 @@ docker = "axio_tools_docker.plugin:DockerPlugin"
 
 
 [project.urls]
-Homepage = "https://github.com/axio-agent/axio-tools-docker"
-Repository = "https://github.com/axio-agent/axio-tools-docker"
+Homepage = "https://github.com/mosquito/axio-agent"
+Repository = "https://github.com/mosquito/axio-agent"
 [build-system]
 requires = ["hatchling"]
 build-backend = "hatchling.build"

{axio_tools_docker-0.6.1 → axio_tools_docker-0.7.0}/src/axio_tools_docker/handler.py

@@ -2,17 +2,17 @@
 
 from __future__ import annotations
 
-from typing import ClassVar
+from typing import Any, ClassVar
 
 from axio.tool import ToolHandler
 
 from .manager import SandboxManager
 
 
-def build_sandbox_exec(manager: SandboxManager) -> type[ToolHandler]:
+def build_sandbox_exec(manager: SandboxManager) -> type[ToolHandler[Any]]:
     """Create a ToolHandler that executes commands in the sandbox."""
 
-    class SandboxExecHandler(ToolHandler):
+    class SandboxExecHandler(ToolHandler[Any]):
         """Execute a shell command inside a Docker sandbox container.
         Returns combined stdout/stderr. Non-zero exit codes are reported.
         Use for running code, tests, or CLI tools in an isolated environment."""
@@ -22,7 +22,7 @@ def build_sandbox_exec(manager: SandboxManager) -> type[ToolHandler]:
 
         _manager: ClassVar[SandboxManager]
 
-        async def __call__(self) -> str:
+        async def __call__(self, context: Any) -> str:
             if not self._manager.docker_available():
                 return "Error: Docker is not installed or not on PATH"
             return await self._manager.exec(self.command, timeout=self.timeout)
@@ -31,10 +31,10 @@ def build_sandbox_exec(manager: SandboxManager) -> type[ToolHandler]:
     return SandboxExecHandler
 
 
-def build_sandbox_write(manager: SandboxManager) -> type[ToolHandler]:
+def build_sandbox_write(manager: SandboxManager) -> type[ToolHandler[Any]]:
     """Create a ToolHandler that writes files in the sandbox."""
 
-    class SandboxWriteHandler(ToolHandler):
+    class SandboxWriteHandler(ToolHandler[Any]):
         """Write content to a file inside the Docker sandbox container.
         Creates parent directories as needed. Use for placing source code,
         config files, or test data in the sandbox."""
@@ -44,7 +44,7 @@ def build_sandbox_write(manager: SandboxManager) -> type[ToolHandler]:
 
         _manager: ClassVar[SandboxManager]
 
-        async def __call__(self) -> str:
+        async def __call__(self, context: Any) -> str:
             if not self._manager.docker_available():
                 return "Error: Docker is not installed or not on PATH"
             return await self._manager.write_file(self.path, self.content)
@@ -53,10 +53,10 @@ def build_sandbox_write(manager: SandboxManager) -> type[ToolHandler]:
     return SandboxWriteHandler
 
 
-def build_sandbox_read(manager: SandboxManager) -> type[ToolHandler]:
+def build_sandbox_read(manager: SandboxManager) -> type[ToolHandler[Any]]:
     """Create a ToolHandler that reads files from the sandbox."""
 
-    class SandboxReadHandler(ToolHandler):
+    class SandboxReadHandler(ToolHandler[Any]):
         """Read the contents of a file from the Docker sandbox container.
         Returns the full file content as text."""
 
@@ -64,7 +64,7 @@ def build_sandbox_read(manager: SandboxManager) -> type[ToolHandler]:
 
         _manager: ClassVar[SandboxManager]
 
-        async def __call__(self) -> str:
+        async def __call__(self, context: Any) -> str:
             if not self._manager.docker_available():
                 return "Error: Docker is not installed or not on PATH"
             return await self._manager.read_file(self.path)

{axio_tools_docker-0.6.1 → axio_tools_docker-0.7.0}/src/axio_tools_docker/plugin.py

@@ -23,7 +23,7 @@ class DockerPlugin:
 
     def __init__(self) -> None:
         self._manager = SandboxManager()
-        self._tools: list[Tool] = []
+        self._tools: list[Tool[Any]] = []
         self._config: Any = None
         self._global_config: Any = None
 
@@ -75,7 +75,7 @@ class DockerPlugin:
         ]
 
     @property
-    def all_tools(self) -> list[Tool]:
+    def all_tools(self) -> list[Tool[Any]]:
         return self._tools
 
     def settings_screen(self) -> Any:

{axio_tools_docker-0.6.1 → axio_tools_docker-0.7.0}/tests/test_handler.py

@@ -17,7 +17,7 @@ async def test_exec_handler_forwards_to_manager() -> None:
     instance = cast(type[Any], handler_cls)(command="echo hi", timeout=10)
 
     with patch.object(SandboxManager, "docker_available", return_value=True):
-        result = await instance()
+        result = await instance({})
 
     assert result == "output"
     manager.exec.assert_awaited_once_with("echo hi", timeout=10)
@@ -31,7 +31,7 @@ async def test_write_handler_forwards_to_manager() -> None:
     instance = cast(type[Any], handler_cls)(path="/workspace/test.py", content="print('hi')")
 
     with patch.object(SandboxManager, "docker_available", return_value=True):
-        result = await instance()
+        result = await instance({})
 
     assert result == "Wrote /workspace/test.py"
     manager.write_file.assert_awaited_once_with("/workspace/test.py", "print('hi')")
@@ -45,7 +45,7 @@ async def test_read_handler_forwards_to_manager() -> None:
     instance = cast(type[Any], handler_cls)(path="/workspace/test.py")
 
     with patch.object(SandboxManager, "docker_available", return_value=True):
-        result = await instance()
+        result = await instance({})
 
     assert result == "file content"
     manager.read_file.assert_awaited_once_with("/workspace/test.py")
@@ -57,7 +57,7 @@ async def test_exec_handler_returns_error_when_docker_missing() -> None:
     instance = cast(type[Any], handler_cls)(command="echo hi")
 
     with patch.object(SandboxManager, "docker_available", return_value=False):
-        result = await instance()
+        result = await instance({})
 
     assert "not installed" in result
 
@@ -68,7 +68,7 @@ async def test_write_handler_returns_error_when_docker_missing() -> None:
     instance = cast(type[Any], handler_cls)(path="/test", content="x")
 
     with patch.object(SandboxManager, "docker_available", return_value=False):
-        result = await instance()
+        result = await instance({})
 
     assert "not installed" in result
 
@@ -79,7 +79,7 @@ async def test_read_handler_returns_error_when_docker_missing() -> None:
     instance = cast(type[Any], handler_cls)(path="/test")
 
     with patch.object(SandboxManager, "docker_available", return_value=False):
-        result = await instance()
+        result = await instance({})
 
     assert "not installed" in result