cage-bro 0.1.0__tar.gz

cage_bro-0.1.0/PKG-INFO

@@ -0,0 +1,99 @@
+Metadata-Version: 2.4
+Name: cage-bro
+Version: 0.1.0
+Summary: Python SDK for cage-bro sandbox
+License-Expression: Apache-2.0
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: httpx>=0.24.0
+Provides-Extra: dev
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: pytest-asyncio; extra == "dev"
+
+# cage-bro
+
+Python SDK for [cage-bro](https://github.com/aeroxy/cage-bro) — a sandboxed execution environment for AI agents.
+
+## Install
+
+```bash
+pip install cage-bro
+```
+
+## Quick Start
+
+```python
+from cage_bro import CageBro
+
+cage = CageBro("http://localhost:8080")
+
+# Run shell commands
+result = cage.shell_exec("ls -la")
+print(result["stdout"])
+
+# Execute code
+result = cage.python("print(2 + 2)")
+print(result["stdout"])
+
+# Read/write files
+cage.file_write("hello.txt", "world")
+content = cage.file_read("hello.txt")
+```
+
+## API
+
+### Sandbox
+
+| Method | Description |
+|---|---|
+| `info()` | Get sandbox info |
+| `health()` | Health check |
+
+### Shell
+
+| Method | Description |
+|---|---|
+| `shell_exec(command, timeout_ms=None)` | Execute a shell command |
+| `shell_create_session(shell=None)` | Create a persistent shell session |
+
+### Files
+
+| Method | Description |
+|---|---|
+| `file_read(path)` | Read a file |
+| `file_write(path, content)` | Write to a file |
+| `file_edit(path, old_text, new_text)` | Edit a file (find & replace) |
+| `file_list(path=".")` | List directory contents |
+| `file_search(query, path=None)` | Search files for text |
+| `file_delete(path)` | Delete a file or directory |
+
+### Code Execution
+
+| Method | Description |
+|---|---|
+| `python(code, timeout_ms=None)` | Execute Python code |
+| `node(code, timeout_ms=None)` | Execute Node.js code |
+
+### Browser
+
+| Method | Description |
+|---|---|
+| `browser_launch(port=None, stealth=True)` | Launch the browser |
+| `browser_navigate(url)` | Navigate to a URL |
+| `browser_screenshot()` | Take a screenshot |
+| `browser_click(selector)` | Click an element |
+| `browser_type(selector, text)` | Type text into an element |
+| `browser_evaluate(expression)` | Evaluate JavaScript |
+| `browser_content()` | Get current page content |
+| `browser_close()` | Close the browser |
+
+## Context Manager
+
+```python
+with CageBro("http://localhost:8080") as cage:
+    cage.shell_exec("echo hello")
+```
+
+## License
+
+Apache-2.0

cage_bro-0.1.0/README.md

@@ -0,0 +1,87 @@
+# cage-bro
+
+Python SDK for [cage-bro](https://github.com/aeroxy/cage-bro) — a sandboxed execution environment for AI agents.
+
+## Install
+
+```bash
+pip install cage-bro
+```
+
+## Quick Start
+
+```python
+from cage_bro import CageBro
+
+cage = CageBro("http://localhost:8080")
+
+# Run shell commands
+result = cage.shell_exec("ls -la")
+print(result["stdout"])
+
+# Execute code
+result = cage.python("print(2 + 2)")
+print(result["stdout"])
+
+# Read/write files
+cage.file_write("hello.txt", "world")
+content = cage.file_read("hello.txt")
+```
+
+## API
+
+### Sandbox
+
+| Method | Description |
+|---|---|
+| `info()` | Get sandbox info |
+| `health()` | Health check |
+
+### Shell
+
+| Method | Description |
+|---|---|
+| `shell_exec(command, timeout_ms=None)` | Execute a shell command |
+| `shell_create_session(shell=None)` | Create a persistent shell session |
+
+### Files
+
+| Method | Description |
+|---|---|
+| `file_read(path)` | Read a file |
+| `file_write(path, content)` | Write to a file |
+| `file_edit(path, old_text, new_text)` | Edit a file (find & replace) |
+| `file_list(path=".")` | List directory contents |
+| `file_search(query, path=None)` | Search files for text |
+| `file_delete(path)` | Delete a file or directory |
+
+### Code Execution
+
+| Method | Description |
+|---|---|
+| `python(code, timeout_ms=None)` | Execute Python code |
+| `node(code, timeout_ms=None)` | Execute Node.js code |
+
+### Browser
+
+| Method | Description |
+|---|---|
+| `browser_launch(port=None, stealth=True)` | Launch the browser |
+| `browser_navigate(url)` | Navigate to a URL |
+| `browser_screenshot()` | Take a screenshot |
+| `browser_click(selector)` | Click an element |
+| `browser_type(selector, text)` | Type text into an element |
+| `browser_evaluate(expression)` | Evaluate JavaScript |
+| `browser_content()` | Get current page content |
+| `browser_close()` | Close the browser |
+
+## Context Manager
+
+```python
+with CageBro("http://localhost:8080") as cage:
+    cage.shell_exec("echo hello")
+```
+
+## License
+
+Apache-2.0

cage_bro-0.1.0/cage_bro/__init__.py

@@ -0,0 +1,4 @@
+from .client import CageBro
+
+__version__ = "0.1.0"
+__all__ = ["CageBro"]

cage_bro-0.1.0/cage_bro/client.py

@@ -0,0 +1,145 @@
+import httpx
+from typing import Optional, Dict, Any, List
+
+
+class CageBro:
+    """Python client for cage-bro sandbox API."""
+
+    def __init__(self, base_url: str = "http://localhost:8080", timeout: float = 30.0):
+        self.base_url = base_url.rstrip("/")
+        self._client = httpx.Client(base_url=self.base_url, timeout=timeout)
+
+    def close(self):
+        self._client.close()
+
+    def __enter__(self):
+        return self
+
+    def __exit__(self, *args):
+        self.close()
+
+    # --- Sandbox ---
+
+    def info(self) -> Dict[str, Any]:
+        """Get sandbox info."""
+        return self._client.get("/v1/sandbox/info").json()
+
+    def health(self) -> Dict[str, Any]:
+        """Health check."""
+        return self._client.get("/health").json()
+
+    # --- Shell ---
+
+    def shell_exec(self, command: str, timeout_ms: Optional[int] = None) -> Dict[str, Any]:
+        """Execute a shell command."""
+        payload: Dict[str, Any] = {"command": command}
+        if timeout_ms:
+            payload["timeout_ms"] = timeout_ms
+        return self._client.post("/v1/shell/exec", json=payload).json()
+
+    def shell_create_session(self, shell: Optional[str] = None) -> Dict[str, Any]:
+        """Create a persistent shell session."""
+        payload = {}
+        if shell:
+            payload["shell"] = shell
+        return self._client.post("/v1/shell/session", json=payload).json()
+
+    # --- Files ---
+
+    def file_read(self, path: str) -> str:
+        """Read a file and return its content."""
+        resp = self._client.post("/v1/file/read", json={"path": path})
+        data = resp.json()
+        if "error" in data:
+            raise FileNotFoundError(data["error"])
+        return data["content"]
+
+    def file_write(self, path: str, content: str) -> None:
+        """Write content to a file."""
+        resp = self._client.post("/v1/file/write", json={"path": path, "content": content})
+        data = resp.json()
+        if "error" in data:
+            raise IOError(data["error"])
+
+    def file_edit(self, path: str, old_text: str, new_text: str) -> None:
+        """Edit a file by replacing old_text with new_text."""
+        resp = self._client.post("/v1/file/edit", json={
+            "path": path, "old_text": old_text, "new_text": new_text
+        })
+        data = resp.json()
+        if "error" in data:
+            raise IOError(data["error"])
+
+    def file_list(self, path: str = ".") -> List[Dict[str, Any]]:
+        """List directory contents."""
+        resp = self._client.post("/v1/file/list", json={"path": path})
+        return resp.json().get("entries", [])
+
+    def file_search(self, query: str, path: Optional[str] = None) -> List[Dict[str, Any]]:
+        """Search files for text."""
+        payload: Dict[str, Any] = {"query": query}
+        if path:
+            payload["path"] = path
+        resp = self._client.post("/v1/file/search", json=payload)
+        return resp.json().get("results", [])
+
+    def file_delete(self, path: str) -> None:
+        """Delete a file or directory."""
+        resp = self._client.post("/v1/file/delete", json={"path": path})
+        data = resp.json()
+        if "error" in data:
+            raise IOError(data["error"])
+
+    # --- Code ---
+
+    def python(self, code: str, timeout_ms: Optional[int] = None) -> Dict[str, Any]:
+        """Execute Python code."""
+        payload: Dict[str, Any] = {"code": code}
+        if timeout_ms:
+            payload["timeout_ms"] = timeout_ms
+        return self._client.post("/v1/code/python", json=payload).json()
+
+    def node(self, code: str, timeout_ms: Optional[int] = None) -> Dict[str, Any]:
+        """Execute Node.js code."""
+        payload: Dict[str, Any] = {"code": code}
+        if timeout_ms:
+            payload["timeout_ms"] = timeout_ms
+        return self._client.post("/v1/code/node", json=payload).json()
+
+    # --- Browser ---
+
+    def browser_launch(self, port: Optional[int] = None, stealth: bool = True) -> Dict[str, Any]:
+        """Launch the browser."""
+        payload: Dict[str, Any] = {"stealth": stealth}
+        if port:
+            payload["port"] = port
+        return self._client.post("/v1/browser/launch", json=payload).json()
+
+    def browser_navigate(self, url: str) -> Dict[str, Any]:
+        """Navigate to a URL."""
+        return self._client.post("/v1/browser/navigate", json={"url": url}).json()
+
+    def browser_screenshot(self) -> Dict[str, Any]:
+        """Take a screenshot."""
+        return self._client.post("/v1/browser/screenshot", json={}).json()
+
+    def browser_click(self, selector: str) -> Dict[str, Any]:
+        """Click an element."""
+        return self._client.post("/v1/browser/click", json={"selector": selector}).json()
+
+    def browser_type(self, selector: str, text: str) -> Dict[str, Any]:
+        """Type text into an element."""
+        return self._client.post("/v1/browser/type", json={"selector": selector, "text": text}).json()
+
+    def browser_evaluate(self, expression: str) -> Any:
+        """Evaluate JavaScript."""
+        resp = self._client.post("/v1/browser/evaluate", json={"expression": expression})
+        return resp.json().get("result")
+
+    def browser_content(self) -> Dict[str, Any]:
+        """Get current page content."""
+        return self._client.post("/v1/browser/content", json={}).json()
+
+    def browser_close(self) -> None:
+        """Close the browser."""
+        self._client.post("/v1/browser/close", json={})

cage_bro-0.1.0/cage_bro.egg-info/PKG-INFO

@@ -0,0 +1,99 @@
+Metadata-Version: 2.4
+Name: cage-bro
+Version: 0.1.0
+Summary: Python SDK for cage-bro sandbox
+License-Expression: Apache-2.0
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: httpx>=0.24.0
+Provides-Extra: dev
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: pytest-asyncio; extra == "dev"
+
+# cage-bro
+
+Python SDK for [cage-bro](https://github.com/aeroxy/cage-bro) — a sandboxed execution environment for AI agents.
+
+## Install
+
+```bash
+pip install cage-bro
+```
+
+## Quick Start
+
+```python
+from cage_bro import CageBro
+
+cage = CageBro("http://localhost:8080")
+
+# Run shell commands
+result = cage.shell_exec("ls -la")
+print(result["stdout"])
+
+# Execute code
+result = cage.python("print(2 + 2)")
+print(result["stdout"])
+
+# Read/write files
+cage.file_write("hello.txt", "world")
+content = cage.file_read("hello.txt")
+```
+
+## API
+
+### Sandbox
+
+| Method | Description |
+|---|---|
+| `info()` | Get sandbox info |
+| `health()` | Health check |
+
+### Shell
+
+| Method | Description |
+|---|---|
+| `shell_exec(command, timeout_ms=None)` | Execute a shell command |
+| `shell_create_session(shell=None)` | Create a persistent shell session |
+
+### Files
+
+| Method | Description |
+|---|---|
+| `file_read(path)` | Read a file |
+| `file_write(path, content)` | Write to a file |
+| `file_edit(path, old_text, new_text)` | Edit a file (find & replace) |
+| `file_list(path=".")` | List directory contents |
+| `file_search(query, path=None)` | Search files for text |
+| `file_delete(path)` | Delete a file or directory |
+
+### Code Execution
+
+| Method | Description |
+|---|---|
+| `python(code, timeout_ms=None)` | Execute Python code |
+| `node(code, timeout_ms=None)` | Execute Node.js code |
+
+### Browser
+
+| Method | Description |
+|---|---|
+| `browser_launch(port=None, stealth=True)` | Launch the browser |
+| `browser_navigate(url)` | Navigate to a URL |
+| `browser_screenshot()` | Take a screenshot |
+| `browser_click(selector)` | Click an element |
+| `browser_type(selector, text)` | Type text into an element |
+| `browser_evaluate(expression)` | Evaluate JavaScript |
+| `browser_content()` | Get current page content |
+| `browser_close()` | Close the browser |
+
+## Context Manager
+
+```python
+with CageBro("http://localhost:8080") as cage:
+    cage.shell_exec("echo hello")
+```
+
+## License
+
+Apache-2.0

cage_bro-0.1.0/cage_bro.egg-info/SOURCES.txt

@@ -0,0 +1,9 @@
+README.md
+pyproject.toml
+cage_bro/__init__.py
+cage_bro/client.py
+cage_bro.egg-info/PKG-INFO
+cage_bro.egg-info/SOURCES.txt
+cage_bro.egg-info/dependency_links.txt
+cage_bro.egg-info/requires.txt
+cage_bro.egg-info/top_level.txt

cage_bro-0.1.0/cage_bro.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

cage_bro-0.1.0/cage_bro.egg-info/requires.txt

@@ -0,0 +1,5 @@
+httpx>=0.24.0
+
+[dev]
+pytest
+pytest-asyncio

cage_bro-0.1.0/cage_bro.egg-info/top_level.txt

@@ -0,0 +1 @@
+cage_bro

cage_bro-0.1.0/pyproject.toml

@@ -0,0 +1,20 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "cage-bro"
+version = "0.1.0"
+description = "Python SDK for cage-bro sandbox"
+readme = "README.md"
+license = "Apache-2.0"
+requires-python = ">=3.8"
+dependencies = [
+    "httpx>=0.24.0",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest",
+    "pytest-asyncio",
+]

cage_bro-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+