Merge branch 'main' into codex/fix-echo-doc-imports

Author: burtenshaw

.github/workflows/publish-testpypi.yml

@@ -143,11 +143,13 @@ jobs:
           python -m venv .testpypi-verify
           . .testpypi-verify/bin/activate
           python -m pip install --upgrade pip
+          python -m pip install --index-url https://pypi.org/simple/ dist/*.whl
+          python -m pip uninstall -y openenv
 
           for attempt in 1 2 3 4 5; do
             if python -m pip install \
+              --no-deps \
               --index-url https://test.pypi.org/simple/ \
-              --extra-index-url https://pypi.org/simple/ \
               "openenv==${{ needs.build.outputs.version }}"; then
               break
             fi

docs/source/getting_started/environment-builder.md

@@ -17,7 +17,7 @@ Already familiar with OpenEnv? Here's the 8-step process at a glance:
 | 2 | Edit `models.py` | Define Action & Observation dataclasses |
 | 3 | Edit `server/my_environment.py` | Implement `reset()` and `step()` methods |
 | 4 | Edit `client.py` | Implement `_step_payload()`, `_parse_result()`, `_parse_state()` |
-| 5 | `openenv serve` | Start local dev server for testing |
+| 5 | `uv run --project . server` | Start local dev server for testing |
 | 6 | `openenv validate` | Validate environment structure |
 | 7 | `openenv push` | Deploy to Hugging Face Hub |
 | 8 | Share the URL! | Others use via `MyEnv.from_hub("you/my-env")` |
@@ -27,7 +27,7 @@ Already familiar with OpenEnv? Here's the 8-step process at a glance:
 | Command | Description |
 |---------|-------------|
 | `openenv init NAME` | Scaffold new environment |
-| `openenv serve` | Start local dev server |
+| `uv run --project . server` | Start local dev server |
 | `openenv build` | Build Docker image |
 | `openenv validate --verbose` | Validate environment structure |
 | `openenv push` | Deploy to Hugging Face Hub |

docs/source/reference/cli.md

@@ -20,6 +20,9 @@ The `openenv` CLI provides a set of commands for building, validating, and pushi
 
 ## `openenv serve`
 
+Local serving is not implemented in the CLI yet. This command exits non-zero
+and prints alternative ways to run an environment server.
+
 [[autodoc]] openenv.cli.commands.serve.serve
 
 ## `openenv fork`

envs/agent_world_model_env/pyproject.toml

@@ -19,7 +19,7 @@ dependencies = [
     "openai>=1.106.1",
     "mcp-agent==0.2.6",
     # Used by the custom Gradio web UI (server/web_ui.py).
-    "gradio>=4.0.0",
+    "gradio>=6.15.0",
 ]
 
 [project.optional-dependencies]

envs/agent_world_model_env/uv.lock

@@ -31,6 +31,8 @@
 logger = logging.getLogger(__name__)
 logger.addHandler(logging.NullHandler())
 
+DEFAULT_SAFE_IMPORTS = ["json"]
+
 
 class PyExecutor:
     """Wrapper around smolagents LocalPythonExecutor.
@@ -43,7 +45,7 @@ class PyExecutor:
 
     def __init__(self, additional_imports: list[str] | None = None):
         if additional_imports is None:
-            additional_imports = []
+            additional_imports = DEFAULT_SAFE_IMPORTS.copy()
 
         self._executor = LocalPythonExecutor(
             additional_authorized_imports=additional_imports

envs/coding_env/server/python_executor.py

@@ -9,7 +9,7 @@ description = "FinQA Environment for OpenEnv - financial question-answering on S
 requires-python = ">=3.10"
 dependencies = [
     # Core OpenEnv dependencies (required for server functionality)
-    "openenv>=0.2.2",
+    "openenv>=0.2.3",
     "fastapi>=0.115.0",
     "fastmcp>=2.0.0",
     "pydantic>=2.0.0",
@@ -31,4 +31,3 @@ server = "finqa_env.server.app:main"
 [tool.setuptools]
 packages = ["finqa_env", "finqa_env.server"]
 package-dir = { "finqa_env" = ".", "finqa_env.server" = "server" }
-