openhands-agent-server 1.10.0__py3-none-any.whl → 1.11.1__py3-none-any.whl

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/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/bash_service.py

@@ -104,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,
@@ -168,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)

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,
@@ -241,9 +244,14 @@ class ConversationService:
         # 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(),
+            **request.model_dump(mode="json", context={"expose_secrets": True}),
         )
         event_service = await self._start_event_service(stored)
         initial_message = request.initial_message

openhands/agent_server/docker/Dockerfile

@@ -1,5 +1,7 @@
 # syntax=docker/dockerfile:1.7
 
+# NOTE: Using Python 3.12 due to PyInstaller+libtmux compatibility issue
+# with Python 3.13. See issue #1886 for details.
 ARG BASE_IMAGE=nikolaik/python-nodejs:python3.12-nodejs22
 ARG USERNAME=openhands
 ARG UID=10001

openhands/agent_server/docker/build.py

@@ -333,6 +333,8 @@ _DEFAULT_PACKAGE_VERSION = _package_version()
 
 
 class BuildOptions(BaseModel):
+    # NOTE: Using Python 3.12 due to PyInstaller+libtmux compatibility issue
+    # with Python 3.13. See issue #1886 for details.
     base_image: str = Field(default="nikolaik/python-nodejs:python3.12-nodejs22")
     custom_tags: str = Field(
         default="", description="Comma-separated list of custom tags."
@@ -662,6 +664,8 @@ def main(argv: list[str]) -> int:
     )
     parser.add_argument(
         "--base-image",
+        # NOTE: Using Python 3.12 due to PyInstaller+libtmux compatibility issue
+        # with Python 3.13. See issue #1886.
         default=_env("BASE_IMAGE", "nikolaik/python-nodejs:python3.12-nodejs22"),
         help="Base image to use (default from $BASE_IMAGE).",
     )

{openhands_agent_server-1.10.0.dist-info → openhands_agent_server-1.11.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: openhands-agent-server
-Version: 1.10.0
+Version: 1.11.1
 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.10.0.dist-info → openhands_agent_server-1.11.1.dist-info}/RECORD

@@ -1,11 +1,11 @@
 openhands/agent_server/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-openhands/agent_server/__main__.py,sha256=QCdBRWVV9gNtPwRwYieQisvKsmJljjJ8f293RhtHl_w,3642
+openhands/agent_server/__main__.py,sha256=fR8lCTQSBOpEKNizotOoV4YdkjeHZqnbvP2kCkzlEDM,5174
 openhands/agent_server/api.py,sha256=LqU4BWXc4VQ29sIiABZykznSMJ_dUQEOHixxeLBTuGY,12009
-openhands/agent_server/bash_router.py,sha256=9GRsLeVZgqR1XeayJvBBycVqfg5O-Fye2ek75kGCuno,3353
-openhands/agent_server/bash_service.py,sha256=dhoV5jEBitsb6UNSf1ht4hkf2E9i5fZ_26qx8VZkuj0,14166
+openhands/agent_server/bash_router.py,sha256=zlIjz2qleafBE5F7xrdIyCquBLHzEfsrKHyyx5XUIko,3704
+openhands/agent_server/bash_service.py,sha256=sErWct5NP5XEtI3P0EwMBF9AW-vKT02ayEIILoO09VQ,14503
 openhands/agent_server/config.py,sha256=EKxVV0QyD3KLLtFxNuUextxJplLW_zZ32nPFhli6ozA,6403
 openhands/agent_server/conversation_router.py,sha256=lz-dnfPXrVBiGZ9GhYqfteCWJ4pq7AcnWqxsKWwCfc0,11178
-openhands/agent_server/conversation_service.py,sha256=rucfKX1SnVZVPVr0fN4jTyr6AbACbKUmJojds2qbTmg,27454
+openhands/agent_server/conversation_service.py,sha256=PHdBWgRDvqjVKIrj2X6AnDUkw04qKcIdXbHeXo56_VQ,28093
 openhands/agent_server/dependencies.py,sha256=H3zyOc8uthpXseB3E7rWNccKIj7PlyfcgCYwFvmFq4c,2629
 openhands/agent_server/desktop_router.py,sha256=OaCmevO33eUo3jTwiXBmQ3uT3ONu4-tqgBfYpZWrHSA,1349
 openhands/agent_server/desktop_service.py,sha256=GnLrQd2rqlRXBCNPbCXOZEfAXa42y9GNyFAQRjVE7y8,7603
@@ -29,13 +29,13 @@ openhands/agent_server/tool_router.py,sha256=vM_9UKUzfChLK9B9Z3DL4VtKNdDw4w635kn
 openhands/agent_server/utils.py,sha256=ajivE_kGCJ9qUhF9H3Qu7DUKg7uDvDQk16JcO3XntEs,1926
 openhands/agent_server/vscode_router.py,sha256=tPmXzN6teuqMa1jvKS4Q3aWpk9p9wsp4LleKoDvkYGs,2133
 openhands/agent_server/vscode_service.py,sha256=te7PWP0eedV7JTlLrBnCujg1dPYMmYZRvbIkxKPavgw,7685
-openhands/agent_server/docker/Dockerfile,sha256=rdFlMdI_uITipzR7-pPEGFx2Ld-jYhOBfGKONRk4dbU,10724
-openhands/agent_server/docker/build.py,sha256=UgHoLkgHZtgWqloG2MQ2RCzc6zTIyttOFL_vUzmw_c0,28189
+openhands/agent_server/docker/Dockerfile,sha256=jdTs0jPSnWC5t6N97qHyyne6zddfpsquhv34OeenUnM,10846
+openhands/agent_server/docker/build.py,sha256=hZJ3T73E8eAsoRgTUi61sqorRAPdxXBlOQFatWEcwKQ,28445
 openhands/agent_server/docker/wallpaper.svg,sha256=FR2g_b5mzz0x5EvRTKO93ASnWPagAyeS9RI3vRQBAsw,11532
 openhands/agent_server/vscode_extensions/openhands-settings/extension.js,sha256=xoCKZ6YXlzlTWnTC52HuzX0sn9s77Vma-47WgEibO88,858
 openhands/agent_server/vscode_extensions/openhands-settings/package.json,sha256=eCkuBBYEVArEjpp7c_m0H207OCLEygZhBLUEkeFNWOg,289
-openhands_agent_server-1.10.0.dist-info/METADATA,sha256=hCtt3IEZL-iGj6ybOZrjr5AJ-A_Rb61_yWDFXNXsf-c,749
-openhands_agent_server-1.10.0.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
-openhands_agent_server-1.10.0.dist-info/entry_points.txt,sha256=uLQzPhqDqe85Dy9DvPiBE2CeqkwCryggr1Ty_mq65NA,70
-openhands_agent_server-1.10.0.dist-info/top_level.txt,sha256=jHgVu9I0Blam8BXFgedoGKfglPF8XvW1TsJFIjcgP4E,10
-openhands_agent_server-1.10.0.dist-info/RECORD,,
+openhands_agent_server-1.11.1.dist-info/METADATA,sha256=MrHo9DLo_xm0WBWBTBEfk1Wf-9g81sA-2pjkm45sMvA,749
+openhands_agent_server-1.11.1.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+openhands_agent_server-1.11.1.dist-info/entry_points.txt,sha256=uLQzPhqDqe85Dy9DvPiBE2CeqkwCryggr1Ty_mq65NA,70
+openhands_agent_server-1.11.1.dist-info/top_level.txt,sha256=jHgVu9I0Blam8BXFgedoGKfglPF8XvW1TsJFIjcgP4E,10
+openhands_agent_server-1.11.1.dist-info/RECORD,,