feat(tool): 添加工具相关的新模块和API接口

此提交添加了一系列新的工具相关的模块和API接口，包括客户端模板、模型定义以及各种控制和OpenAPI接口等组件。同时更新了依赖版本并完善了初始化配置。

Co-developed-by: Aone Copilot <noreply@alibaba-inc.com>
Signed-off-by: Sodawyx <sodawyx@126.com>

Author: Sodawyx

agentrun/__init__.py

@@ -109,6 +109,10 @@
     SandboxClient,
     Template,
 )
+# Tool
+from agentrun.tool import Tool as ToolResource
+from agentrun.tool import ToolClient as ToolResourceClient
+from agentrun.tool import ToolControlAPI as ToolResourceControlAPI
 # ToolSet
 from agentrun.toolset import ToolSet, ToolSetClient
 from agentrun.utils.config import Config
@@ -247,6 +251,10 @@
     "AioSandbox",
     "CustomSandbox",
     "Template",
+    ######## Tool ########
+    "ToolResource",
+    "ToolResourceClient",
+    "ToolResourceControlAPI",
     ######## ToolSet ########
     "ToolSetClient",
     "ToolSet",

agentrun/tool/__client_async_template.py

@@ -0,0 +1,53 @@
+"""Tool 客户端 / Tool Client
+
+此模块提供工具的客户端 API。
+This module provides the client API for tools.
+"""
+
+from typing import Any, Dict, List, Optional
+
+from agentrun.tool.api.control import ToolControlAPI
+from agentrun.utils.config import Config
+from agentrun.utils.exception import HTTPError
+
+from .tool import Tool
+
+
+class ToolClient:
+    """Tool 客户端 / Tool Client
+
+    提供工具的获取功能。
+    Provides get function for tools.
+    """
+
+    def __init__(self, config: Optional[Config] = None):
+        """初始化客户端 / Initialize client
+
+        Args:
+            config: 配置对象,可选 / Configuration object, optional
+        """
+        self.__control_api = ToolControlAPI(config)
+
+    async def get_async(
+        self,
+        name: str,
+        config: Optional[Config] = None,
+    ) -> "Tool":
+        """异步获取工具 / Get tool asynchronously
+
+        Args:
+            name: 工具名称 / Tool name
+            config: 配置对象,可选 / Configuration object, optional
+
+        Returns:
+            Tool: 工具资源对象 / Tool resource object
+        """
+        try:
+            result = await self.__control_api.get_tool_async(
+                name=name,
+                config=config,
+            )
+        except HTTPError as e:
+            raise e.to_resource_error("Tool", name) from e
+
+        return Tool.from_inner_object(result)

agentrun/tool/__init__.py

@@ -0,0 +1,41 @@
+"""Tool 模块 / Tool Module
+
+此模块提供工具管理功能。
+This module provides tool management functionality.
+"""
+
+from .api.control import ToolControlAPI
+from .api.mcp import ToolMCPSession
+from .api.openapi import ToolOpenAPIClient
+from .client import ToolClient
+from .model import (
+    McpConfig,
+    ToolCodeConfiguration,
+    ToolContainerConfiguration,
+    ToolInfo,
+    ToolLogConfiguration,
+    ToolNASConfig,
+    ToolNetworkConfiguration,
+    ToolOSSMountConfig,
+    ToolSchema,
+    ToolType,
+)
+from .tool import Tool
+
+__all__ = [
+    "ToolControlAPI",
+    "ToolMCPSession",
+    "ToolOpenAPIClient",
+    "ToolClient",
+    "Tool",
+    "ToolType",
+    "McpConfig",
+    "ToolCodeConfiguration",
+    "ToolContainerConfiguration",
+    "ToolInfo",
+    "ToolLogConfiguration",
+    "ToolNASConfig",
+    "ToolNetworkConfiguration",
+    "ToolOSSMountConfig",
+    "ToolSchema",
+]