feat(endpoint): implement pagination methods for AgentRuntimeEndpoint

Add _list_page and _list_page_async methods to support pagination
in AgentRuntimeEndpoint class, enabling proper implementation of
ResourceBase abstract methods and fixing instantiation issues.

The changes include:
- Import PageableInput model for pagination parameters
- Implement both sync and async pagination methods
- Add proper validation for required agent_runtime_id parameter
- Include comprehensive docstrings in Chinese and English
- Add unit tests to verify abstract method implementation

fixes issue where from_inner_object could not instantiate objects
due to unimplemented abstract methods in ResourceBase

feat: add pagination support to AgentRuntimeEndpoint
修复了由于未实现 ResourceBase 抽象方法导致的 from_inner_object 实例化失败问题

BREAKING CHANGE: requires agent_runtime_id parameter for pagination methods

破坏性变更：分页方法现在需要传入 agent_runtime_id 参数

Change-Id: I75bef47a371d5169120a39ac996b6a0c76c6d519
Signed-off-by: OhYee <[email protected]>

Author: OhYee

agentrun/agent_runtime/__endpoint_async_template.py

@@ -18,6 +18,7 @@
     AgentRuntimeEndpointUpdateInput,
 )
 from agentrun.utils.config import Config
+from agentrun.utils.model import PageableInput
 from agentrun.utils.resource import ResourceBase
 
 
@@ -160,6 +161,45 @@ async def get_by_id_async(
             config=config,
         )
 
+    @classmethod
+    async def _list_page_async(
+        cls,
+        page_input: PageableInput,
+        config: Optional[Config] = None,
+        **kwargs,
+    ) -> List["AgentRuntimeEndpoint"]:
+        """分页列出端点 / List endpoints by page
+
+        此方法是 ResourceBase 要求实现的抽象方法，用于支持分页查询。
+        This method is an abstract method required by ResourceBase to support pagination.
+
+        Args:
+            page_input: 分页参数 / Pagination parameters
+            config: 配置对象,可选 / Configuration object, optional
+            **kwargs: 其他参数，必须包含 agent_runtime_id / Other parameters, must include agent_runtime_id
+
+        Returns:
+            List[AgentRuntimeEndpoint]: 端点对象列表 / List of endpoint objects
+
+        Raises:
+            ValueError: 当 agent_runtime_id 未提供时 / When agent_runtime_id is not provided
+            HTTPError: HTTP 请求错误 / HTTP request error
+        """
+        agent_runtime_id = kwargs.get("agent_runtime_id")
+        if not agent_runtime_id:
+            raise ValueError(
+                "agent_runtime_id is required for listing endpoints"
+            )
+
+        return await cls.__get_client().list_endpoints_async(
+            agent_runtime_id,
+            AgentRuntimeEndpointListInput(
+                page_number=page_input.page_number,
+                page_size=page_input.page_size,
+            ),
+            config=config,
+        )
+
     @classmethod
     async def list_by_id_async(
         cls, agent_runtime_id: str, config: Optional[Config] = None

agentrun/agent_runtime/endpoint.py

@@ -28,6 +28,7 @@
     AgentRuntimeEndpointUpdateInput,
 )
 from agentrun.utils.config import Config
+from agentrun.utils.model import PageableInput
 from agentrun.utils.resource import ResourceBase
 
 
@@ -286,6 +287,84 @@ def get_by_id(
             config=config,
         )
 
+    @classmethod
+    async def _list_page_async(
+        cls,
+        page_input: PageableInput,
+        config: Optional[Config] = None,
+        **kwargs,
+    ) -> List["AgentRuntimeEndpoint"]:
+        """分页列出端点 / List endpoints by page
+
+        此方法是 ResourceBase 要求实现的抽象方法，用于支持分页查询。
+        This method is an abstract method required by ResourceBase to support pagination.
+
+        Args:
+            page_input: 分页参数 / Pagination parameters
+            config: 配置对象,可选 / Configuration object, optional
+            **kwargs: 其他参数，必须包含 agent_runtime_id / Other parameters, must include agent_runtime_id
+
+        Returns:
+            List[AgentRuntimeEndpoint]: 端点对象列表 / List of endpoint objects
+
+        Raises:
+            ValueError: 当 agent_runtime_id 未提供时 / When agent_runtime_id is not provided
+            HTTPError: HTTP 请求错误 / HTTP request error
+        """
+        agent_runtime_id = kwargs.get("agent_runtime_id")
+        if not agent_runtime_id:
+            raise ValueError(
+                "agent_runtime_id is required for listing endpoints"
+            )
+
+        return await cls.__get_client().list_endpoints_async(
+            agent_runtime_id,
+            AgentRuntimeEndpointListInput(
+                page_number=page_input.page_number,
+                page_size=page_input.page_size,
+            ),
+            config=config,
+        )
+
+    @classmethod
+    def _list_page(
+        cls,
+        page_input: PageableInput,
+        config: Optional[Config] = None,
+        **kwargs,
+    ) -> List["AgentRuntimeEndpoint"]:
+        """分页列出端点 / List endpoints by page
+
+        此方法是 ResourceBase 要求实现的抽象方法，用于支持分页查询。
+        This method is an abstract method required by ResourceBase to support pagination.
+
+        Args:
+            page_input: 分页参数 / Pagination parameters
+            config: 配置对象,可选 / Configuration object, optional
+            **kwargs: 其他参数，必须包含 agent_runtime_id / Other parameters, must include agent_runtime_id
+
+        Returns:
+            List[AgentRuntimeEndpoint]: 端点对象列表 / List of endpoint objects
+
+        Raises:
+            ValueError: 当 agent_runtime_id 未提供时 / When agent_runtime_id is not provided
+            HTTPError: HTTP 请求错误 / HTTP request error
+        """
+        agent_runtime_id = kwargs.get("agent_runtime_id")
+        if not agent_runtime_id:
+            raise ValueError(
+                "agent_runtime_id is required for listing endpoints"
+            )
+
+        return cls.__get_client().list_endpoints(
+            agent_runtime_id,
+            AgentRuntimeEndpointListInput(
+                page_number=page_input.page_number,
+                page_size=page_input.page_size,
+            ),
+            config=config,
+        )
+
     @classmethod
     async def list_by_id_async(
         cls, agent_runtime_id: str, config: Optional[Config] = None

tests/unittests/agent_runtime/test_endpoint.py

@@ -468,3 +468,115 @@ def test_invoke_openai(self, mock_client_class, mock_data_api_class):
     def test_invoke_openai_async(self, mock_client_class, mock_data_api_class):
         """测试 invoke_openai_async - 跳过因为私有属性问题"""
         pass
+
+
+class TestAgentRuntimeEndpointAbstractMethods:
+    """测试 AgentRuntimeEndpoint 抽象方法实现
+
+    此测试类用于验证 AgentRuntimeEndpoint 正确实现了 ResourceBase 要求的抽象方法。
+    这是为了防止类似于 Issue #XXX 的问题再次发生，确保 from_inner_object 能够正常实例化对象。
+    """
+
+    def test_from_inner_object_instantiation(self):
+        """测试 from_inner_object 能够正常实例化对象
+
+        这个测试确保 AgentRuntimeEndpoint 类实现了所有必需的抽象方法。
+        如果抽象方法未实现，from_inner_object 会抛出 TypeError。
+        """
+
+        # 准备一个最小的有效数据
+        class MockDaraModel:
+
+            def to_map(self):
+                return {
+                    "agentRuntimeEndpointId": "are-test-123",
+                    "agentRuntimeEndpointName": "test-endpoint",
+                    "agentRuntimeId": "ar-test-123",
+                    "status": "READY",
+                }
+
+        inner_obj = MockDaraModel()
+
+        # 这里不应该抛出 TypeError: Can't instantiate abstract class
+        endpoint = AgentRuntimeEndpoint.from_inner_object(inner_obj)
+
+        # 验证对象正确创建
+        assert endpoint is not None
+        assert endpoint.agent_runtime_endpoint_id == "are-test-123"
+        assert endpoint.agent_runtime_endpoint_name == "test-endpoint"
+
+    def test_list_page_method_exists(self):
+        """测试 _list_page 方法存在且可调用"""
+        # 验证类有 _list_page 方法
+        assert hasattr(AgentRuntimeEndpoint, "_list_page")
+        assert callable(getattr(AgentRuntimeEndpoint, "_list_page"))
+
+    def test_list_page_async_method_exists(self):
+        """测试 _list_page_async 方法存在且可调用"""
+        # 验证类有 _list_page_async 方法
+        assert hasattr(AgentRuntimeEndpoint, "_list_page_async")
+        assert callable(getattr(AgentRuntimeEndpoint, "_list_page_async"))
+
+    @patch(CLIENT_PATH)
+    def test_list_page_requires_agent_runtime_id(self, mock_client_class):
+        """测试 _list_page 需要 agent_runtime_id 参数"""
+        from agentrun.utils.model import PageableInput
+
+        # 不提供 agent_runtime_id 应该抛出 ValueError
+        with pytest.raises(ValueError, match="agent_runtime_id is required"):
+            AgentRuntimeEndpoint._list_page(
+                PageableInput(page_number=1, page_size=10)
+            )
+
+    @patch(CLIENT_PATH)
+    def test_list_page_async_requires_agent_runtime_id(self, mock_client_class):
+        """测试 _list_page_async 需要 agent_runtime_id 参数"""
+        from agentrun.utils.model import PageableInput
+
+        # 不提供 agent_runtime_id 应该抛出 ValueError
+        with pytest.raises(ValueError, match="agent_runtime_id is required"):
+            asyncio.run(
+                AgentRuntimeEndpoint._list_page_async(
+                    PageableInput(page_number=1, page_size=10)
+                )
+            )
+
+    @patch(CLIENT_PATH)
+    def test_list_page_with_agent_runtime_id(self, mock_client_class):
+        """测试 _list_page 正确传递 agent_runtime_id"""
+        from agentrun.utils.model import PageableInput
+
+        mock_client = MagicMock()
+        mock_client.list_endpoints.return_value = []
+        mock_client_class.return_value = mock_client
+
+        # 提供 agent_runtime_id 应该正常执行
+        result = AgentRuntimeEndpoint._list_page(
+            PageableInput(page_number=1, page_size=10),
+            agent_runtime_id="ar-test-123",
+        )
+
+        # 验证调用了 list_endpoints
+        mock_client.list_endpoints.assert_called_once()
+        assert result == []
+
+    @patch(CLIENT_PATH)
+    def test_list_page_async_with_agent_runtime_id(self, mock_client_class):
+        """测试 _list_page_async 正确传递 agent_runtime_id"""
+        from agentrun.utils.model import PageableInput
+
+        mock_client = MagicMock()
+        mock_client.list_endpoints_async = AsyncMock(return_value=[])
+        mock_client_class.return_value = mock_client
+
+        # 提供 agent_runtime_id 应该正常执行
+        result = asyncio.run(
+            AgentRuntimeEndpoint._list_page_async(
+                PageableInput(page_number=1, page_size=10),
+                agent_runtime_id="ar-test-123",
+            )
+        )
+
+        # 验证调用了 list_endpoints_async
+        mock_client.list_endpoints_async.assert_called_once()
+        assert result == []