openhands-agent-server 1.11.2__tar.gz → 1.11.4__tar.gz

{openhands_agent_server-1.11.2 → openhands_agent_server-1.11.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: openhands-agent-server
-Version: 1.11.2
+Version: 1.11.4
 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.11.2 → openhands_agent_server-1.11.4}/openhands/agent_server/api.py

@@ -23,6 +23,7 @@ from openhands.agent_server.desktop_service import get_desktop_service
 from openhands.agent_server.event_router import event_router
 from openhands.agent_server.file_router import file_router
 from openhands.agent_server.git_router import git_router
+from openhands.agent_server.hooks_router import hooks_router
 from openhands.agent_server.middleware import LocalhostCORSMiddleware
 from openhands.agent_server.server_details_router import (
     get_server_info,
@@ -194,6 +195,7 @@ def _add_api_routes(app: FastAPI, config: Config) -> None:
     api_router.include_router(vscode_router)
     api_router.include_router(desktop_router)
     api_router.include_router(skills_router)
+    api_router.include_router(hooks_router)
     app.include_router(api_router)
     app.include_router(sockets_router)
 

openhands_agent_server-1.11.4/openhands/agent_server/hooks_router.py

@@ -0,0 +1,48 @@
+"""Hooks router for OpenHands Agent Server.
+
+This module defines the HTTP API endpoints for hook operations.
+Business logic is delegated to hooks_service.py.
+"""
+
+from fastapi import APIRouter
+from pydantic import BaseModel, Field
+
+from openhands.agent_server.hooks_service import load_hooks_from_workspace
+from openhands.sdk.hooks import HookConfig
+
+
+hooks_router = APIRouter(prefix="/hooks", tags=["Hooks"])
+
+
+class HooksRequest(BaseModel):
+    """Request body for loading hooks."""
+
+    project_dir: str | None = Field(
+        default=None, description="Workspace directory path for project hooks"
+    )
+
+
+class HooksResponse(BaseModel):
+    """Response containing hooks configuration."""
+
+    hook_config: HookConfig | None = Field(
+        default=None,
+        description="Hook configuration loaded from the workspace, or None if not found",  # noqa: E501
+    )
+
+
+@hooks_router.post("", response_model=HooksResponse)
+def get_hooks(request: HooksRequest) -> HooksResponse:
+    """Load hooks from the workspace .openhands/hooks.json file.
+
+    This endpoint reads the hooks configuration from the project's
+    .openhands/hooks.json file if it exists.
+
+    Args:
+        request: HooksRequest containing the project directory path.
+
+    Returns:
+        HooksResponse containing the hook configuration or None.
+    """
+    hook_config = load_hooks_from_workspace(project_dir=request.project_dir)
+    return HooksResponse(hook_config=hook_config)

openhands_agent_server-1.11.4/openhands/agent_server/hooks_service.py

@@ -0,0 +1,54 @@
+"""Hooks service for OpenHands Agent Server.
+
+This module contains the business logic for loading hooks from the workspace,
+keeping the router clean and focused on HTTP concerns.
+
+Hook Sources:
+- Project hooks: {workspace}/.openhands/hooks.json
+- User hooks: ~/.openhands/hooks.json (future)
+"""
+
+from pathlib import Path
+
+from openhands.sdk.hooks import HookConfig
+from openhands.sdk.logger import get_logger
+
+
+logger = get_logger(__name__)
+
+
+def load_hooks_from_workspace(project_dir: str | None = None) -> HookConfig | None:
+    """Load hooks from the workspace .openhands/hooks.json file.
+
+    This function reads the hooks configuration from the project's
+    .openhands/hooks.json file if it exists.
+
+    Args:
+        project_dir: Workspace directory path for project hooks.
+
+    Returns:
+        HookConfig if hooks.json exists and is valid, None otherwise.
+    """
+    if not project_dir:
+        logger.debug("No project_dir provided, skipping hooks loading")
+        return None
+
+    hooks_path = Path(project_dir) / ".openhands" / "hooks.json"
+
+    if not hooks_path.exists():
+        logger.debug(f"No hooks.json found at {hooks_path}")
+        return None
+
+    try:
+        hook_config = HookConfig.load(path=hooks_path)
+
+        if hook_config.is_empty():
+            logger.debug(f"hooks.json at {hooks_path} is empty")
+            return None
+
+        logger.info(f"Loaded hooks from {hooks_path}")
+        return hook_config
+
+    except Exception as e:
+        logger.warning(f"Failed to load hooks from {hooks_path}: {e}")
+        return None

{openhands_agent_server-1.11.2 → openhands_agent_server-1.11.4}/openhands_agent_server.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: openhands-agent-server
-Version: 1.11.2
+Version: 1.11.4
 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.11.2 → openhands_agent_server-1.11.4}/openhands_agent_server.egg-info/SOURCES.txt

@@ -15,6 +15,8 @@ pyproject.toml
 ./openhands/agent_server/event_service.py
 ./openhands/agent_server/file_router.py
 ./openhands/agent_server/git_router.py
+./openhands/agent_server/hooks_router.py
+./openhands/agent_server/hooks_service.py
 ./openhands/agent_server/logging_config.py
 ./openhands/agent_server/middleware.py
 ./openhands/agent_server/models.py
@@ -51,6 +53,8 @@ openhands/agent_server/event_router.py
 openhands/agent_server/event_service.py
 openhands/agent_server/file_router.py
 openhands/agent_server/git_router.py
+openhands/agent_server/hooks_router.py
+openhands/agent_server/hooks_service.py
 openhands/agent_server/logging_config.py
 openhands/agent_server/middleware.py
 openhands/agent_server/models.py

{openhands_agent_server-1.11.2 → openhands_agent_server-1.11.4}/pyproject.toml

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