openhands-agent-server 1.9.1__tar.gz → 1.11.0__tar.gz

{openhands_agent_server-1.9.1 → openhands_agent_server-1.11.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: openhands-agent-server
-Version: 1.9.1
+Version: 1.11.0
 Summary: OpenHands Agent Server - REST/WebSocket interface for OpenHands AI Agent
 Project-URL: Source, https://github.com/OpenHands/software-agent-sdk
 Project-URL: Homepage, https://github.com/OpenHands/software-agent-sdk

{openhands_agent_server-1.9.1 → openhands_agent_server-1.11.0}/openhands/agent_server/__main__.py

@@ -2,6 +2,7 @@ import argparse
 import atexit
 import faulthandler
 import signal
+import sys
 from types import FrameType
 
 import uvicorn
@@ -14,6 +15,43 @@ from openhands.sdk.logger import DEBUG, get_logger
 logger = get_logger(__name__)
 
 
+def check_browser():
+    """Check if browser functionality can render about:blank."""
+    executor = None
+    try:
+        # Register tools to ensure browser tools are available
+        from openhands.tools.preset.default import register_default_tools
+
+        register_default_tools(enable_browser=True)
+
+        # Import browser components
+        from openhands.tools.browser_use.definition import BrowserNavigateAction
+        from openhands.tools.browser_use.impl import BrowserToolExecutor
+
+        # Create executor
+        executor = BrowserToolExecutor(headless=True, session_timeout_minutes=2)
+
+        # Try to navigate to about:blank
+        action = BrowserNavigateAction(url="about:blank")
+        result = executor(action)
+
+        # Check if the operation was successful
+        if result.is_error:
+            print(f"Browser check failed: {str(result.content)}")
+            return False
+
+        print("Browser check passed: Successfully rendered about:blank")
+        return True
+
+    except Exception as e:
+        print(f"Browser check failed: {e}")
+        return False
+    finally:
+        # Ensure cleanup happens even if an error occurs
+        if executor is not None:
+            executor.close()
+
+
 class LoggingServer(uvicorn.Server):
     """Custom uvicorn Server that logs signal handling events.
 
@@ -67,9 +105,21 @@ def main() -> None:
         action="store_true",
         help="Enable auto-reload (disabled by default)",
     )
+    parser.add_argument(
+        "--check-browser",
+        action="store_true",
+        help="Check if browser functionality works and exit",
+    )
 
     args = parser.parse_args()
 
+    # Handle browser check
+    if args.check_browser:
+        if check_browser():
+            sys.exit(0)
+        else:
+            sys.exit(1)
+
     print(f"🙌 Starting OpenHands Agent Server on {args.host}:{args.port}")
     print(f"📖 API docs will be available at http://{args.host}:{args.port}/docs")
     print(f"🔄 Auto-reload: {'enabled' if args.reload else 'disabled'}")

{openhands_agent_server-1.9.1 → openhands_agent_server-1.11.0}/openhands/agent_server/bash_router.py

@@ -36,6 +36,14 @@ async def search_bash_events(
     command_id__eq: UUID | None = None,
     timestamp__gte: datetime | None = None,
     timestamp__lt: datetime | None = None,
+    order__gt: Annotated[
+        int | None,
+        Query(
+            title="Filter to events with order greater than this value",
+            description="Only returns BashOutput events with order > this value. "
+            "Useful for polling to fetch only new events since the last poll.",
+        ),
+    ] = None,
     sort_order: BashEventSortOrder = BashEventSortOrder.TIMESTAMP,
     page_id: Annotated[
         str | None,
@@ -55,6 +63,7 @@ async def search_bash_events(
         command_id__eq=command_id__eq,
         timestamp__gte=timestamp__gte,
         timestamp__lt=timestamp__lt,
+        order__gt=order__gt,
         sort_order=sort_order,
         page_id=page_id,
         limit=limit,

{openhands_agent_server-1.9.1 → openhands_agent_server-1.11.0}/openhands/agent_server/bash_service.py

@@ -16,6 +16,7 @@ from openhands.agent_server.models import (
 )
 from openhands.agent_server.pub_sub import PubSub, Subscriber
 from openhands.sdk.logger import get_logger
+from openhands.sdk.utils import sanitized_env
 
 
 logger = get_logger(__name__)
@@ -103,6 +104,7 @@ class BashEventService:
         command_id__eq: UUID | None = None,
         timestamp__gte: datetime | None = None,
         timestamp__lt: datetime | None = None,
+        order__gt: int | None = None,
         sort_order: BashEventSortOrder = BashEventSortOrder.TIMESTAMP,
         page_id: str | None = None,
         limit: int = 100,
@@ -167,6 +169,11 @@ class BashEventService:
         for file_path in page_files:
             event = self._load_event_from_file(file_path)
             if event is not None:
+                # Filter by order if specified (only applies to BashOutput events)
+                if order__gt is not None:
+                    event_order = getattr(event, "order", None)
+                    if event_order is not None and event_order <= order__gt:
+                        continue
                 page_events.append(event)
 
         return BashEventPage(items=page_events, next_page_id=next_page_id)
@@ -194,6 +201,7 @@ class BashEventService:
                 stdout=asyncio.subprocess.PIPE,
                 stderr=asyncio.subprocess.PIPE,
                 shell=True,
+                env=sanitized_env(),
             )
 
             # Track output order and buffers

{openhands_agent_server-1.9.1 → openhands_agent_server-1.11.0}/openhands/agent_server/conversation_service.py

@@ -34,8 +34,11 @@ logger = logging.getLogger(__name__)
 def _compose_conversation_info(
     stored: StoredConversation, state: ConversationState
 ) -> ConversationInfo:
+    # Use mode='json' so SecretStr in nested structures (e.g. LookupSecret.headers,
+    # agent.agent_context.secrets) serialize to strings. Without it, validation
+    # fails because ConversationInfo expects dict[str, str] but receives SecretStr.
     return ConversationInfo(
-        **state.model_dump(),
+        **state.model_dump(mode="json"),
         title=stored.title,
         metrics=stored.metrics,
         created_at=stored.created_at,
@@ -235,7 +238,21 @@ class ConversationService:
                     f"{list(request.tool_module_qualnames.keys())}"
                 )
 
-        stored = StoredConversation(id=conversation_id, **request.model_dump())
+        # Plugin loading is now handled lazily by LocalConversation.
+        # Just pass the plugin specs through to StoredConversation.
+        # LocalConversation will:
+        # 1. Fetch and load plugins on first run()/send_message()
+        # 2. Resolve refs to commit SHAs for deterministic resume
+        # 3. Merge plugin skills/MCP/hooks into the agent
+        #
+        # Use mode='json' so SecretStr in nested structures (e.g. LookupSecret.headers)
+        # serialize to plain strings. Pass expose_secrets=True so StaticSecret values
+        # are preserved through the round-trip; the dict is only used in-process to
+        # construct StoredConversation, not sent over the network.
+        stored = StoredConversation(
+            id=conversation_id,
+            **request.model_dump(mode="json", context={"expose_secrets": True}),
+        )
         event_service = await self._start_event_service(stored)
         initial_message = request.initial_message
         if initial_message:

{openhands_agent_server-1.9.1 → openhands_agent_server-1.11.0}/openhands/agent_server/desktop_service.py

@@ -9,6 +9,7 @@ from pathlib import Path
 
 from openhands.agent_server.config import get_default_config
 from openhands.sdk.logger import get_logger
+from openhands.sdk.utils import sanitized_env
 
 
 logger = get_logger(__name__)
@@ -28,7 +29,7 @@ class DesktopService:
             return True
 
         # --- Env defaults (match bash behavior) ---
-        env = os.environ.copy()
+        env = sanitized_env()
         display = env.get("DISPLAY", ":1")
         user = env.get("USER") or env.get("USERNAME") or "openhands"
         home = Path(env.get("HOME") or f"/home/{user}")
@@ -68,6 +69,7 @@ class DesktopService:
                     capture_output=True,
                     text=True,
                     timeout=3,
+                    env=env,
                 ).returncode
                 == 0
             )
@@ -105,6 +107,7 @@ class DesktopService:
                     capture_output=True,
                     text=True,
                     timeout=3,
+                    env=env,
                 ).returncode
                 == 0
             )
@@ -180,7 +183,11 @@ class DesktopService:
         # Check if VNC server is running
         try:
             result = subprocess.run(
-                ["pgrep", "-f", "Xvnc"], capture_output=True, text=True, timeout=3
+                ["pgrep", "-f", "Xvnc"],
+                capture_output=True,
+                text=True,
+                timeout=3,
+                env=sanitized_env(),
             )
             return result.returncode == 0
         except Exception:

{openhands_agent_server-1.9.1 → openhands_agent_server-1.11.0}/openhands/agent_server/docker/Dockerfile

@@ -1,6 +1,6 @@
 # syntax=docker/dockerfile:1.7
 
-ARG BASE_IMAGE=nikolaik/python-nodejs:python3.12-nodejs22
+ARG BASE_IMAGE=nikolaik/python-nodejs:python3.13-nodejs22
 ARG USERNAME=openhands
 ARG UID=10001
 ARG GID=10001
@@ -10,7 +10,7 @@ ARG PORT=8000
 # Builder (source mode)
 # We copy source + build a venv here for local dev and debugging.
 ####################################################################################
-FROM python:3.12-bullseye AS builder
+FROM python:3.13-bullseye AS builder
 ARG USERNAME UID GID
 ENV UV_PROJECT_ENVIRONMENT=/agent-server/.venv
 ENV UV_PYTHON_INSTALL_DIR=/agent-server/uv-managed-python
@@ -28,7 +28,7 @@ COPY --chown=${USERNAME}:${USERNAME} openhands-tools ./openhands-tools
 COPY --chown=${USERNAME}:${USERNAME} openhands-workspace ./openhands-workspace
 COPY --chown=${USERNAME}:${USERNAME} openhands-agent-server ./openhands-agent-server
 RUN --mount=type=cache,target=/home/${USERNAME}/.cache,uid=${UID},gid=${GID} \
-    uv python install 3.12 && uv venv --python 3.12 .venv && uv sync --frozen --no-editable --managed-python
+    uv python install 3.13 && uv venv --python 3.13 .venv && uv sync --frozen --no-editable --managed-python
 
 ####################################################################################
 # Binary Builder (binary mode)

{openhands_agent_server-1.9.1 → openhands_agent_server-1.11.0}/openhands/agent_server/docker/build.py

@@ -333,7 +333,7 @@ _DEFAULT_PACKAGE_VERSION = _package_version()
 
 
 class BuildOptions(BaseModel):
-    base_image: str = Field(default="nikolaik/python-nodejs:python3.12-nodejs22")
+    base_image: str = Field(default="nikolaik/python-nodejs:python3.13-nodejs22")
     custom_tags: str = Field(
         default="", description="Comma-separated list of custom tags."
     )
@@ -662,7 +662,7 @@ def main(argv: list[str]) -> int:
     )
     parser.add_argument(
         "--base-image",
-        default=_env("BASE_IMAGE", "nikolaik/python-nodejs:python3.12-nodejs22"),
+        default=_env("BASE_IMAGE", "nikolaik/python-nodejs:python3.13-nodejs22"),
         help="Base image to use (default from $BASE_IMAGE).",
     )
     parser.add_argument(

{openhands_agent_server-1.9.1 → openhands_agent_server-1.11.0}/openhands/agent_server/event_service.py

@@ -46,6 +46,7 @@ class EventService:
     _pub_sub: PubSub[Event] = field(default_factory=lambda: PubSub[Event](), init=False)
     _run_task: asyncio.Task | None = field(default=None, init=False)
     _run_lock: asyncio.Lock = field(default_factory=asyncio.Lock, init=False)
+    _callback_wrapper: AsyncCallbackWrapper | None = field(default=None, init=False)
 
     @property
     def conversation_dir(self):
@@ -430,19 +431,29 @@ class EventService:
             self.stored.agent.model_dump(context={"expose_secrets": True}),
         )
 
+        # Create LocalConversation with plugins and hook_config.
+        # Plugins are loaded lazily on first run()/send_message() call.
+        # Hook execution semantics: OpenHands runs hooks sequentially with early-exit
+        # on block (PreToolUse), unlike Claude Code's parallel execution model.
+
+        # Create and store callback wrapper to allow flushing pending events
+        self._callback_wrapper = AsyncCallbackWrapper(
+            self._pub_sub, loop=asyncio.get_running_loop()
+        )
+
         conversation = LocalConversation(
             agent=agent,
             workspace=workspace,
+            plugins=self.stored.plugins,
             persistence_dir=str(self.conversations_dir),
             conversation_id=self.stored.id,
-            callbacks=[
-                AsyncCallbackWrapper(self._pub_sub, loop=asyncio.get_running_loop())
-            ],
+            callbacks=[self._callback_wrapper],
             max_iteration_per_run=self.stored.max_iterations,
             stuck_detection=self.stored.stuck_detection,
             visualizer=None,
             secrets=self.stored.secrets,
             cipher=self.cipher,
+            hook_config=self.stored.hook_config,
         )
 
         # Set confirmation mode if enabled
@@ -517,6 +528,16 @@ class EventService:
                 except Exception:
                     logger.exception("Error during conversation run")
                 finally:
+                    # Wait for all pending events to be published via
+                    # AsyncCallbackWrapper before publishing the final state update.
+                    # This prevents a race condition where the conversation status
+                    # becomes FINISHED before agent events (MessageEvent, ActionEvent,
+                    # etc.) are published to WebSocket subscribers.
+                    if self._callback_wrapper:
+                        await loop.run_in_executor(
+                            None, self._callback_wrapper.wait_for_pending, 30.0
+                        )
+
                     # Clear task reference and publish state update
                     self._run_task = None
                     await self._publish_state_update()

{openhands_agent_server-1.9.1 → openhands_agent_server-1.11.0}/openhands/agent_server/models.py

@@ -12,7 +12,9 @@ from openhands.sdk.conversation.state import (
     ConversationExecutionStatus,
     ConversationState,
 )
+from openhands.sdk.hooks import HookConfig
 from openhands.sdk.llm.utils.metrics import MetricsSnapshot
+from openhands.sdk.plugin import PluginSource
 from openhands.sdk.secret import SecretSource
 from openhands.sdk.security.analyzer import SecurityAnalyzerBase
 from openhands.sdk.security.confirmation_policy import (
@@ -106,10 +108,31 @@ class StartConversationRequest(BaseModel):
             "to register the tools for this conversation."
         ),
     )
+    plugins: list[PluginSource] | None = Field(
+        default=None,
+        description=(
+            "List of plugins to load for this conversation. Plugins are loaded "
+            "and their skills/MCP config are merged into the agent. "
+            "Hooks are extracted and stored for runtime execution."
+        ),
+    )
+    hook_config: HookConfig | None = Field(
+        default=None,
+        description=(
+            "Optional hook configuration for this conversation. Hooks are shell "
+            "scripts that run at key lifecycle events (PreToolUse, PostToolUse, "
+            "UserPromptSubmit, Stop, etc.). If both hook_config and plugins are "
+            "provided, they are merged with explicit hooks running before plugin "
+            "hooks."
+        ),
+    )
 
 
 class StoredConversation(StartConversationRequest):
-    """Stored details about a conversation"""
+    """Stored details about a conversation.
+
+    Extends StartConversationRequest with server-assigned fields.
+    """
 
     id: OpenHandsUUID
     title: str | None = Field(

{openhands_agent_server-1.9.1 → openhands_agent_server-1.11.0}/openhands/agent_server/skills_service.py

@@ -14,7 +14,6 @@ Precedence (later overrides earlier):
 sandbox < public < user < org < project
 """
 
-import os
 import shutil
 import subprocess
 import tempfile
@@ -37,6 +36,7 @@ from openhands.sdk.context.skills.utils import (
     update_skills_repository,
 )
 from openhands.sdk.logger import get_logger
+from openhands.sdk.utils import sanitized_env
 
 
 logger = get_logger(__name__)
@@ -120,6 +120,8 @@ def load_org_skills_from_url(
         # Clone the organization repository (shallow clone for efficiency)
         logger.info(f"Cloning organization skills repository for {org_name}")
         try:
+            env = sanitized_env()
+            env["GIT_TERMINAL_PROMPT"] = "0"
             subprocess.run(
                 [
                     "git",
@@ -132,7 +134,7 @@ def load_org_skills_from_url(
                 check=True,
                 capture_output=True,
                 timeout=120,
-                env={**os.environ, "GIT_TERMINAL_PROMPT": "0"},
+                env=env,
             )
         except subprocess.CalledProcessError:
             # Repository doesn't exist or access denied - this is expected.

{openhands_agent_server-1.9.1 → openhands_agent_server-1.11.0}/openhands/agent_server/vscode_service.py

@@ -5,6 +5,7 @@ import os
 from pathlib import Path
 
 from openhands.sdk.logger import get_logger
+from openhands.sdk.utils import sanitized_env
 
 
 logger = get_logger(__name__)
@@ -160,6 +161,7 @@ class VSCodeService:
             cmd,
             stdout=asyncio.subprocess.PIPE,
             stderr=asyncio.subprocess.STDOUT,
+            env=sanitized_env(),
         )
 
         # Wait for server to start (look for startup message)

{openhands_agent_server-1.9.1 → openhands_agent_server-1.11.0}/openhands_agent_server.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: openhands-agent-server
-Version: 1.9.1
+Version: 1.11.0
 Summary: OpenHands Agent Server - REST/WebSocket interface for OpenHands AI Agent
 Project-URL: Source, https://github.com/OpenHands/software-agent-sdk
 Project-URL: Homepage, https://github.com/OpenHands/software-agent-sdk

{openhands_agent_server-1.9.1 → openhands_agent_server-1.11.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "openhands-agent-server"
-version = "1.9.1"
+version = "1.11.0"
 description = "OpenHands Agent Server - REST/WebSocket interface for OpenHands AI Agent"
 
 requires-python = ">=3.12"