agentscope-runtime 1.0.4a1__py3-none-any.whl → 1.0.5__py3-none-any.whl

{agentscope_runtime-1.0.4a1.dist-info → agentscope_runtime-1.0.5.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agentscope-runtime
-Version: 1.0.4a1
+Version: 1.0.5
 Summary: A production-ready runtime framework for agent applications, providing secure sandboxed execution environments and scalable deployment solutions with multi-framework support.
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
@@ -28,6 +28,7 @@ Requires-Dist: jsonref
 Requires-Dist: asgiref
 Requires-Dist: click>=8.0.0
 Requires-Dist: rich>=13.0.0
+Requires-Dist: ag-ui-protocol>=0.1.10
 Provides-Extra: dev
 Requires-Dist: pytest>=8.3.5; extra == "dev"
 Requires-Dist: pytest-asyncio>=0.23.0; extra == "dev"
@@ -67,13 +68,18 @@ Requires-Dist: alibabacloud-credentials; extra == "ext"
 Requires-Dist: PyYAML; extra == "ext"
 Requires-Dist: agno>=2.3.8; extra == "ext"
 Requires-Dist: nacos-sdk-python>=3.0.0; extra == "ext"
+Requires-Dist: agent-framework<1.0.0b260114,>=1.0.0b251120; extra == "ext"
+Requires-Dist: boxlite>=0.5.2; extra == "ext"
+Requires-Dist: alibabacloud-eas20210701<8.0.0,>=7.0.0; extra == "ext"
+Requires-Dist: alibabacloud-aiworkspace20210204<8.0.0,>=7.0.0; extra == "ext"
 Dynamic: license-file
 
 <div align="center">
 
-# AgentScope Runtime v1.0
+# AgentScope Runtime: A Production-grade Runtime for Agent Applications
 
 [![GitHub Repo](https://img.shields.io/badge/GitHub-Repo-black.svg?logo=github)](https://github.com/agentscope-ai/agentscope-runtime)
+[![WebUI](https://img.shields.io/badge/Try_WebUI-Online-green.svg?logo=googlechrome)](http://webui.runtime.agentscope.io/)
 [![PyPI](https://img.shields.io/pypi/v/agentscope-runtime?label=PyPI&color=brightgreen&logo=python)](https://pypi.org/project/agentscope-runtime/)
 [![Downloads](https://static.pepy.tech/badge/agentscope-runtime)](https://pepy.tech/project/agentscope-runtime)
 [![Python Version](https://img.shields.io/badge/python-3.10%2B-blue.svg?logo=python&label=Python)](https://python.org)
@@ -91,33 +97,75 @@ Dynamic: license-file
 [![DingTalk](https://img.shields.io/badge/DingTalk-Join_Us-orange.svg)](https://qr.dingtalk.com/action/joingroup?code=v1,k1,OmDlBXpjW+I2vWjKDsjvI9dhcXjGZi3bQiojOq3dlDw=&_dt_no_comment=1&origin=11)
 
 [[Cookbook]](https://runtime.agentscope.io/)
+[[Try WebUI]](http://webui.runtime.agentscope.io/)
 [[中文README]](README_zh.md)
 [[Samples]](https://github.com/agentscope-ai/agentscope-samples)
 
-**A Production-Ready Runtime Framework for Intelligent Agent Applications**
+> **Core capabilities:**
+>
+> **Tool Sandboxing** — tool call runs inside a **hardened sandbox**
+>
+> **Agent-as-a-Service (AaaS) APIs** — expose agents as **streaming, production-ready APIs**
+>
+> **Scalable Deployment** — deploy locally, on Kubernetes, or serverless for **elastic scale**
+>
+> <details>
+> <summary><b>Plus</b></summary>
+>
+> <br>
+>
+> **Full-stack observability** (logs / traces)
+>
+> **Framework compatibility** with mainstream agent frameworks
+>
+> </details>
+
+</div>
 
-***AgentScope Runtime** is a full-stack agent runtime that tackles two core challenges: **efficient agent deployment** and **secure sandbox execution**. It ships with foundational services such as short- and long-term memory plus agent state persistence, along with hardened sandbox infrastructure. Whether you need to orchestrate production-grade agents or guarantee safe tool interactions, AgentScope Runtime provides developer-friendly workflows with complete observability.*
+---
 
-*In V1.0, these services are exposed via an **adapter pattern**, enabling seamless integration with the native modules of different agent frameworks while preserving their native interfaces and behaviors, ensuring both compatibility and flexibility.*
+## Table of Contents
 
-</div>
+> [!NOTE]
+>
+> **Recommended reading order:**
+>
+> - **I want to run an agent app in 5 minutes**: Quick Start (Agent App example) → verify with curl (SSE streaming)
+> - **I care about secure tool execution / automation**: Quick Start (Sandbox examples) → sandbox image registry/namespace/tag configuration → (optional) production-grade serverless sandbox deployment
+> - **I want production deployment / expose APIs**: Quick Start (Agent App example) → Quick Start (Deployment example) → Guides
+> - **I want to contribute**: Contributing → Contact
+
+- [News](#-news)
+- [Key Features](#-key-features)
+- [Quick Start](#-quick-start): From installation to running a minimal Agent API service. Learn the three-stage `AgentApp` development pattern: `init` / `query` / `shutdown`.
+  - [Prerequisites](#prerequisites): Required runtime environment and dependencies
+  - [Installation](#installation): Install from PyPI or from source
+  - [Agent App Example](#agent-app-example): How to build a streaming (SSE) Agent-as-a-Service API
+  - [Sandbox Example](#sandbox-example): How to safely execute Python/Shell/GUI/Browser/Filesystem/Mobile tools in an isolated sandbox
+  - [Deployment Example](#deployment-example): Learn to deploy with `DeployManager` locally or in a serverless environment, and access the service via A2A, Response API, or the OpenAI SDK in compatible mode
+- [Guides](#-guides): A tutorial site covering AgentScope Runtime concepts, architecture, APIs, and sample projects—helping you move from “it runs” to “scalable and maintainable”.
+- [Contact](#-contact)
+- [Contributing](#-contributing)
+- [License](#-license)
+- [Contributors](#-contributors)
 
 ---
 
 ## 🆕 NEWS
 
+* **[2026-01]** Added **asynchronous sandbox** implementations (`BaseSandboxAsync`, `GuiSandboxAsync`, `BrowserSandboxAsync`, `FilesystemSandboxAsync`, `MobileSandboxAsync`) enabling non-blocking, concurrent tool execution in async program. Improved `run_ipython_cell` and `run_shell_command` methods with enhanced **concurrency and parallel execution** capabilities for more efficient sandbox operations.
 * **[2025-12]** We have released **AgentScope Runtime v1.0**, introducing a unified “Agent as API” white-box development experience, with enhanced multi-agent collaboration, state persistence, and cross-framework integration. This release also streamlines abstractions and modules to ensure consistency between development and production environments. Please refer to the **[CHANGELOG](https://runtime.agentscope.io/en/CHANGELOG.html)** for full update details and migration guide.
 
 ---
 
 ## ✨ Key Features
 
-- **🏗️ Deployment Infrastructure**: Built-in services for agent state management, conversation history, long-term memory, and sandbox lifecycle control
-- **🔧 Framework-Agnostic**: Not tied to any specific agent framework; seamlessly integrates with popular open-source and custom implementations
-- ⚡ **Developer-Friendly**: Offers `AgentApp` for easy deployment with powerful customization options
-- **📊 Observability**: Comprehensive tracking and monitoring of runtime operations
-- **🔒 Sandboxed Tool Execution**: Isolated sandbox ensures safe tool execution without affecting the system
-- **🛠️ Out-of-the-Box Tools & One-Click Adaptation**: Rich set of ready-to-use tools, with adapters enabling quick integration into different frameworks
+- **Deployment Infrastructure**: Built-in services for agent state management, conversation history, long-term memory, and sandbox lifecycle control
+- **Framework-Agnostic**: Not tied to any specific agent framework; seamlessly integrates with popular open-source and custom implementations
+- **Developer-Friendly**: Offers `AgentApp` for easy deployment with powerful customization options
+- **Observability**: Comprehensive tracking and monitoring of runtime operations
+- **Sandboxed Tool Execution**: Isolated sandbox ensures safe tool execution without affecting the system
+- **Out-of-the-Box Tools & One-Click Adaptation**: Rich set of ready-to-use tools, with adapters enabling quick integration into different frameworks
 
 > [!NOTE]
 >
@@ -125,31 +173,11 @@ Dynamic: license-file
 >
 > | Framework/Feature                                            | Message/Event | Tool | Service |
 > | ------------------------------------------------------------ | ------------- | ---- | ------- |
-> | AgentScope                                                   | ✅             | ✅    | ✅       |
+> | [AgentScope](https://runtime.agentscope.io/en/quickstart.html) | ✅             | ✅    | ✅       |
 > | [LangGraph](https://runtime.agentscope.io/en/langgraph_guidelines.html) | ✅             | 🚧    | 🚧       |
-> | AutoGen                                                      | 🚧             | ✅    | 🚧       |
-> | Microsoft Agent Framework                                    | 🚧             | 🚧    | 🚧       |
+> | [Microsoft Agent Framework](https://runtime.agentscope.io/en/ms_agent_framework_guidelines.html) | ✅             | ✅    | 🚧       |
 > | [Agno](https://runtime.agentscope.io/en/agno_guidelines.html) | ✅             | ✅    | 🚧       |
-
----
-
-## 💬 Contact
-
-Welcome to join our community on
-
-| [Discord](https://discord.gg/eYMpfnkG8h)                     | DingTalk                                                     |
-| ------------------------------------------------------------ | ------------------------------------------------------------ |
-| <img src="https://gw.alicdn.com/imgextra/i1/O1CN01hhD1mu1Dd3BWVUvxN_!!6000000000238-2-tps-400-400.png" width="100" height="100"> | <img src="https://img.alicdn.com/imgextra/i4/O1CN014mhqFq1ZlgNuYjxrz_!!6000000003235-2-tps-400-400.png" width="100" height="100"> |
-
----
-
-## 📋 Table of Contents
-
-- [🚀 Quick Start](#-quick-start)
-- [📚 Cookbook](#-cookbook)
-- [🏗️ Deployment](#️-deployment)
-- [🤝 Contributing](#-contributing)
-- [📄 License](#-license)
+> | AutoGen                                                      | 🚧             | ✅    | 🚧       |
 
 ---
 
@@ -329,15 +357,29 @@ These examples demonstrate how to create sandboxed environments and execute tool
 
 > [!NOTE]
 >
-> Current version requires Docker or Kubernetes to be installed and running on your system. Please refer to [this tutorial](https://runtime.agentscope.io/en/sandbox.html) for more details.
+> If you want to run the sandbox locally, the current version supports **Docker (optionally with gVisor)** or **[BoxLite](https://github.com/boxlite-ai/boxlite)** as the backend, and you can switch the backend by setting the environment variable `CONTAINER_DEPLOYMENT` (supported values include `docker` / `gvisor` / `boxlite` etc.; default: `docker`).
 >
-> If you plan to use the sandbox on a large scale in production, we recommend deploying it directly in Alibaba Cloud for managed hosting: [One-click deploy sandbox on Alibaba Cloud](https://computenest.console.aliyun.com/service/instance/create/default?ServiceName=AgentScope%20Runtime%20%E6%B2%99%E7%AE%B1%E7%8E%AF%E5%A2%83)
+> For large-scale remote/production deployments, we recommend using **Kubernetes (K8s)**, **Function Compute (FC)**, or [**Alibaba Cloud Container Service for Kubernetes (ACK)**](https://computenest.console.aliyun.com/service/instance/create/default?ServiceName=AgentScope%20Runtime%20%E6%B2%99%E7%AE%B1%E7%8E%AF%E5%A2%83) as the backend. Please refer to [this tutorial](https://runtime.agentscope.io/en/sandbox/advanced.html) for more details.
+
+> [!TIP]
+> AgentScope Runtime provides **both synchronous** and **asynchronous** versions for each sandbox type
+
+| Synchronous Class   | Asynchronous Class       |
+| ------------------- | ------------------------ |
+| `BaseSandbox`       | `BaseSandboxAsync`       |
+| `GuiSandbox`        | `GuiSandboxAsync`        |
+| `FilesystemSandbox` | `FilesystemSandboxAsync` |
+| `BrowserSandbox`    | `BrowserSandboxAsync`    |
+| `MobileSandbox`     | `MobileSandboxAsync`     |
+| `TrainingSandbox`   | -                        |
+| `AgentbaySandbox`   | -                        |
 
 #### Base Sandbox
 
 Use for running **Python code** or **shell commands** in an isolated environment.
 
 ```python
+# --- Synchronous version ---
 from agentscope_runtime.sandbox import BaseSandbox
 
 with BaseSandbox() as box:
@@ -346,6 +388,16 @@ with BaseSandbox() as box:
     print(box.run_ipython_cell(code="print('hi')"))  # Run Python code
     print(box.run_shell_command(command="echo hello"))  # Run shell command
     input("Press Enter to continue...")
+
+# --- Asynchronous version ---
+from agentscope_runtime.sandbox import BaseSandboxAsync
+
+async with BaseSandboxAsync() as box:
+    # Default image is `agentscope/runtime-sandbox-base:latest`
+    print(await box.list_tools())  # List all available tools
+    print(await box.run_ipython_cell(code="print('hi')"))  # Run Python code
+    print(await box.run_shell_command(command="echo hello"))  # Run shell command
+    input("Press Enter to continue...")
 ```
 
 #### GUI Sandbox
@@ -355,14 +407,26 @@ Provides a **virtual desktop** environment for mouse, keyboard, and screen opera
 <img src="https://img.alicdn.com/imgextra/i2/O1CN01df5SaM1xKFQP4KGBW_!!6000000006424-2-tps-2958-1802.png" alt="GUI Sandbox" width="800" height="500">
 
 ```python
+# --- Synchronous version ---
 from agentscope_runtime.sandbox import GuiSandbox
 
 with GuiSandbox() as box:
     # By default, pulls `agentscope/runtime-sandbox-gui:latest` from DockerHub
-    print(box.list_tools()) # List all available tools
+    print(box.list_tools())  # List all available tools
     print(box.desktop_url)  # Web desktop access URL
     print(box.computer_use(action="get_cursor_position"))  # Get mouse cursor position
-    print(box.computer_use(action="get_screenshot"))       # Capture screenshot
+    print(box.computer_use(action="get_screenshot"))  # Capture screenshot
+    input("Press Enter to continue...")
+
+# --- Asynchronous version ---
+from agentscope_runtime.sandbox import GuiSandboxAsync
+
+async with GuiSandboxAsync() as box:
+    # Default image is `agentscope/runtime-sandbox-gui:latest`
+    print(await box.list_tools())  # List all available tools
+    print(box.desktop_url)  # Web desktop access URL
+    print(await box.computer_use(action="get_cursor_position"))  # Get mouse cursor position
+    print(await box.computer_use(action="get_screenshot"))  # Capture screenshot
     input("Press Enter to continue...")
 ```
 
@@ -373,14 +437,25 @@ A GUI-based sandbox with **browser operations** inside an isolated sandbox.
 <img src="https://img.alicdn.com/imgextra/i4/O1CN01OIq1dD1gAJMcm0RFR_!!6000000004101-2-tps-2734-1684.png" alt="GUI Sandbox" width="800" height="500">
 
 ```python
+# --- Synchronous version ---
 from agentscope_runtime.sandbox import BrowserSandbox
 
 with BrowserSandbox() as box:
     # By default, pulls `agentscope/runtime-sandbox-browser:latest` from DockerHub
-    print(box.list_tools()) # List all available tools
+    print(box.list_tools())  # List all available tools
     print(box.desktop_url)  # Web desktop access URL
     box.browser_navigate("https://www.google.com/")  # Open a webpage
     input("Press Enter to continue...")
+
+# --- Asynchronous version ---
+from agentscope_runtime.sandbox import BrowserSandboxAsync
+
+async with BrowserSandboxAsync() as box:
+    # Default image is `agentscope/runtime-sandbox-browser:latest`
+    print(await box.list_tools())  # List all available tools
+    print(box.desktop_url)  # Web desktop access URL
+    await box.browser_navigate("https://www.google.com/")  # Open a webpage
+    input("Press Enter to continue...")
 ```
 
 #### Filesystem Sandbox
@@ -390,14 +465,25 @@ A GUI-based sandbox with **file system operations** such as creating, reading, a
 <img src="https://img.alicdn.com/imgextra/i3/O1CN01VocM961vK85gWbJIy_!!6000000006153-2-tps-2730-1686.png" alt="GUI Sandbox" width="800" height="500">
 
 ```python
+# --- Synchronous version ---
 from agentscope_runtime.sandbox import FilesystemSandbox
 
 with FilesystemSandbox() as box:
     # By default, pulls `agentscope/runtime-sandbox-filesystem:latest` from DockerHub
-    print(box.list_tools()) # List all available tools
+    print(box.list_tools())  # List all available tools
     print(box.desktop_url)  # Web desktop access URL
     box.create_directory("test")  # Create a directory
     input("Press Enter to continue...")
+
+# --- Asynchronous version ---
+from agentscope_runtime.sandbox import FilesystemSandboxAsync
+
+async with FilesystemSandboxAsync() as box:
+    # Default image is `agentscope/runtime-sandbox-filesystem:latest`
+    print(await box.list_tools())  # List all available tools
+    print(box.desktop_url)  # Web desktop access URL
+    await box.create_directory("test")  # Create a directory
+    input("Press Enter to continue...")
 ```
 
 #### Mobile Sandbox
@@ -421,16 +507,32 @@ Provides a **sandboxed Android emulator environment** that allows executing vari
 - **Architecture Compatibility**:
   When running on an ARM64/aarch64 architecture (e.g., Apple M-series chips), you may encounter compatibility or performance issues. It is recommended to run on an x86_64 host.
 ```python
+# --- Synchronous version ---
 from agentscope_runtime.sandbox import MobileSandbox
 
 with MobileSandbox() as box:
     # By default, pulls 'agentscope/runtime-sandbox-mobile:latest' from DockerHub
-    print(box.list_tools()) # List all available tools
-    print(box.mobile_get_screen_resolution()) # Get the screen resolution
-    print(box.mobile_tap([500, 1000])) # Tap at coordinate (500, 1000)
-    print(box.mobile_input_text("Hello from AgentScope!")) # Input text
-    print(box.mobile_key_event(3)) # Sends a HOME key event (KeyCode: 3)
-    screenshot_result = box.mobile_get_screenshot() # Get the current screenshot
+    print(box.list_tools())  # List all available tools
+    print(box.mobile_get_screen_resolution())  # Get the screen resolution
+    print(box.mobile_tap([500, 1000]))  # Tap at coordinate (500, 1000)
+    print(box.mobile_input_text("Hello from AgentScope!"))  # Input text
+    print(box.mobile_key_event(3))  # HOME key event
+    screenshot_result = box.mobile_get_screenshot()  # Get screenshot
+    print(screenshot_result)
+    input("Press Enter to continue...")
+
+# --- Asynchronous version ---
+from agentscope_runtime.sandbox import MobileSandboxAsync
+
+async with MobileSandboxAsync() as box:
+    # Default image is 'agentscope/runtime-sandbox-mobile:latest'
+    print(await box.list_tools())  # List all available tools
+    print(await box.mobile_get_screen_resolution())  # Get the screen resolution
+    print(await box.mobile_tap([500, 1000]))  # Tap at coordinate (500, 1000)
+    print(await box.mobile_input_text("Hello from AgentScope!"))  # Input text
+    print(await box.mobile_key_event(3))  # HOME key event
+    screenshot_result = await box.mobile_get_screenshot()  # Get screenshot
+    print(screenshot_result)
     input("Press Enter to continue...")
 ```
 
@@ -501,15 +603,11 @@ Example:
 agentscope-registry.ap-southeast-1.cr.aliyuncs.com/agentscope/runtime-sandbox-base:preview
 ```
 
----
-
 #### Serverless Sandbox Deployment
 
-AgentScope Runtime also supports serverless deployment, which is suitable for running sandboxes in a serverless environment,
-[Alibaba Cloud Function Compute (FC)](https://help.aliyun.com/zh/functioncompute/fc/) or [Alibaba Cloud AgentRun](https://docs.agent.run/).
+AgentScope Runtime also supports serverless deployment, which is suitable for running sandboxes in a serverless environment, e.g. [Alibaba Cloud Function Compute (FC)](https://help.aliyun.com/zh/functioncompute/fc/).
 
-First, please refer to the [documentation](https://runtime.agentscope.io/en/sandbox/advanced.html#optional-function-compute-fc-settings) to configure the serverless environment variables.
-Make `CONTAINER_DEPLOYMENT` to `fc` or `agentrun` to enable serverless deployment.
+First, please refer to the [documentation](https://runtime.agentscope.io/en/sandbox/advanced.html#optional-function-compute-fc-settings) to configure the serverless environment variables. Make `CONTAINER_DEPLOYMENT` to `fc` to enable serverless deployment.
 
 Then, start a sandbox server, use the `--config` option to specify a serverless environment setup:
 
@@ -519,17 +617,7 @@ runtime-sandbox-server --config fc.env
 ```
 After the server starts, you can access the sandbox server at baseurl `http://localhost:8000` and invoke sandbox tools described above.
 
-## 📚 Cookbook
-
-- **[📖 Cookbook](https://runtime.agentscope.io/en/intro.html)**: Comprehensive tutorials
-- **[💡 Concept](https://runtime.agentscope.io/en/concept.html)**: Core concepts and architecture overview
-- **[🚀 Quick Start](https://runtime.agentscope.io/en/quickstart.html)**: Quick start tutorial
-- **[🏠 Demo House](https://runtime.agentscope.io/en/demohouse.html)**: Rich example projects
-- **[📋 API Reference](https://runtime.agentscope.io/en/api/index.html)**: Complete API documentation
-
----
-
-## 🏗️ Deployment
+### Deployment Example
 
 The `AgentApp` exposes a `deploy` method that takes a `DeployManager` instance and deploys the agent.
 
@@ -538,7 +626,7 @@ The `AgentApp` exposes a `deploy` method that takes a `DeployManager` instance a
 
 * The deployer will automatically add common agent protocols, such as **A2A**, **Response API**.
 
-After deployment, users can access the service at `http://localhost:8090/process:
+After deployment, users can access the service at http://localhost:8090/process:
 
 ```python
 from agentscope_runtime.engine.deployers import LocalDeployManager
@@ -550,8 +638,10 @@ deployer = LocalDeployManager(
 )
 
 # Deploy the app as a streaming service
-deploy_result = await app.deploy(deployer=deployer)
-
+deploy_result = await app.deploy(
+    deployer=deployer,
+    endpoint_path="/process"
+)
 ```
 
 After deployment, users can also access this service using the Response API of the OpenAI SDK:
@@ -569,12 +659,16 @@ response = client.responses.create(
 print(response)
 ```
 
-Besides, `DeployManager` also supports serverless deployments, such as deploying your agent app
-to [ModelStudio](https://bailian.console.aliyun.com/?admin=1&tab=doc#/doc/?type=app&url=2983030)
-or [AgentRun](https://docs.agent.run/).
+Besides, `DeployManager` also supports serverless deployments, such as deploying your agent app to [ModelStudio](https://bailian.console.aliyun.com/?admin=1&tab=doc#/doc/?type=app&url=2983030).
 
 ```python
-from agentscope_runtime.engine.deployers import ModelStudioDeployManager
+import os
+from agentscope_runtime.engine.deployers.modelstudio_deployer import (
+    ModelstudioDeployManager,
+    OSSConfig,
+    ModelstudioConfig,
+)
+
 # Create deployment manager
 deployer = ModelstudioDeployManager(
     oss_config=OSSConfig(
@@ -606,6 +700,22 @@ For more advanced serverless deployment guides, please refer to the [documentati
 
 ---
 
+## 📚 Guides
+
+For a more detailed tutorial, please refer to: [![Cookbook](https://img.shields.io/badge/📚_Cookbook-English|中文-teal.svg)](https://runtime.agentscope.io)
+
+---
+
+## 💬 Contact
+
+Welcome to join our community on
+
+| [Discord](https://discord.gg/eYMpfnkG8h)                     | DingTalk                                                     |
+| ------------------------------------------------------------ | ------------------------------------------------------------ |
+| <img src="https://gw.alicdn.com/imgextra/i1/O1CN01hhD1mu1Dd3BWVUvxN_!!6000000000238-2-tps-400-400.png" width="100" height="100"> | <img src="https://img.alicdn.com/imgextra/i4/O1CN014mhqFq1ZlgNuYjxrz_!!6000000003235-2-tps-400-400.png" width="100" height="100"> |
+
+---
+
 ## 🤝 Contributing
 
 We welcome contributions from the community! Here's how you can help:
@@ -651,9 +761,9 @@ See the License for the specific language governing permissions and
 limitations under the License.
 ```
 
-## Contributors ✨
+## ✨ Contributors
 <!-- ALL-CONTRIBUTORS-BADGE:START - Do not remove or modify this section -->
-[![All Contributors](https://img.shields.io/badge/all_contributors-29-orange.svg?style=flat-square)](#contributors-)
+[![All Contributors](https://img.shields.io/badge/all_contributors-32-orange.svg?style=flat-square)](#contributors-)
 <!-- ALL-CONTRIBUTORS-BADGE:END -->
 
 Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/emoji-key/)):
@@ -701,6 +811,9 @@ Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/e
     </tr>
     <tr>
       <td align="center" valign="top" width="14.28%"><a href="https://github.com/RTsama"><img src="https://avatars.githubusercontent.com/u/100779257?v=4?s=100" width="100px;" alt="RTsama"/><br /><sub><b>RTsama</b></sub></a><br /><a href="https://github.com/agentscope-ai/agentscope-runtime/issues?q=author%3ARTsama" title="Bug reports">🐛</a> <a href="https://github.com/agentscope-ai/agentscope-runtime/commits?author=RTsama" title="Code">💻</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://allenli178.top"><img src="https://avatars.githubusercontent.com/u/53218750?v=4?s=100" width="100px;" alt="YuYan"/><br /><sub><b>YuYan</b></sub></a><br /><a href="https://github.com/agentscope-ai/agentscope-runtime/commits?author=allenli178" title="Documentation">📖</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://github.com/rlp2006"><img src="https://avatars.githubusercontent.com/u/212365247?v=4?s=100" width="100px;" alt="Li Peng (Yuan Yi)"/><br /><sub><b>Li Peng (Yuan Yi)</b></sub></a><br /><a href="https://github.com/agentscope-ai/agentscope-runtime/commits?author=rlp2006" title="Code">💻</a> <a href="https://github.com/agentscope-ai/agentscope-runtime/commits?author=rlp2006" title="Documentation">📖</a> <a href="#example-rlp2006" title="Examples">💡</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="http://dorianzheng.github.io"><img src="https://avatars.githubusercontent.com/u/8065637?v=4?s=100" width="100px;" alt="dorianzheng"/><br /><sub><b>dorianzheng</b></sub></a><br /><a href="https://github.com/agentscope-ai/agentscope-runtime/pulls?q=is%3Apr+reviewed-by%3ADorianZheng" title="Reviewed Pull Requests">👀</a> <a href="#platform-DorianZheng" title="Packaging/porting to new platform">📦</a></td>
     </tr>
   </tbody>
   <tfoot>