feat(server): add health check endpoint with tests

Add /health endpoint to server for health checking and monitoring.
Include comprehensive tests covering GET requests, method restrictions,
and compatibility with custom protocols.

Added _register_health_check method to AgentRunServer that registers
a /health route returning {"status": "ok"} for GET requests while
ensuring other methods are properly restricted.

添加用于健康检查和监控的 /health 端点。
包括涵盖 GET 请求、方法限制和自定义协议兼容性的全面测试。

在 AgentRunServer 中添加 _register_health_check 方法，该方法注册
一个 /health 路由，对 GET 请求返回 {"status": "ok"}，同时
确保其他方法被正确限制。

Change-Id: I7718d675242179379935b81f6e323a2942d71bd8
Signed-off-by: OhYee <oyohyee@oyohyee.com>

Author: OhYee

agentrun/server/server.py

@@ -132,6 +132,9 @@ def __init__(
 
         self.agent_invoker = AgentInvoker(invoke_agent)
 
+        # 注册 health check 路由
+        self._register_health_check()
+
         # 配置 CORS
         self._setup_cors(config.cors_origins if config else None)
 
@@ -145,6 +148,13 @@ def __init__(
         # 挂载所有协议的 Router
         self._mount_protocols(protocols)
 
+    def _register_health_check(self):
+        """注册 /health 健康检查路由 / Register /health health check route"""
+
+        @self.app.get("/health")
+        async def health_check():
+            return {"status": "ok"}
+
     def _wrap_with_memory(
         self,
         invoke_agent: InvokeAgentHandler,

tests/unittests/server/test_server.py

@@ -124,6 +124,43 @@ def get_client(self, invoke_agent):
 
         return TestClient(app)
 
+    async def test_health_check(self):
+        """测试 /health 健康检查路由"""
+
+        client = self.get_client(self.get_invoke_agent_non_streaming())
+
+        response = client.get("/health")
+
+        assert response.status_code == 200
+        assert response.json() == {"status": "ok"}
+
+    async def test_health_check_post_not_allowed(self):
+        """测试 POST /health 不被允许"""
+
+        client = self.get_client(self.get_invoke_agent_non_streaming())
+
+        response = client.post("/health")
+
+        # FastAPI 对不匹配的方法返回 405
+        assert response.status_code == 405
+
+    async def test_health_check_with_custom_protocols(self):
+        """测试自定义协议列表时 /health 仍可用"""
+        from agentrun.server.openai_protocol import OpenAIProtocolHandler
+
+        server = AgentRunServer(
+            invoke_agent=self.get_invoke_agent_non_streaming(),
+            protocols=[OpenAIProtocolHandler()],
+        )
+        from fastapi.testclient import TestClient
+
+        client = TestClient(server.as_fastapi_app())
+
+        response = client.get("/health")
+
+        assert response.status_code == 200
+        assert response.json() == {"status": "ok"}
+
     async def test_server_non_streaming_protocols(self):
         """测试非流式的 OpenAI 和 AGUI 服务器响应功能"""