agentscope-runtime 1.0.3__tar.gz → 1.0.4__tar.gz

{agentscope_runtime-1.0.3/src/agentscope_runtime.egg-info → agentscope_runtime-1.0.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agentscope-runtime
-Version: 1.0.3
+Version: 1.0.4
 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
@@ -67,6 +67,7 @@ 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.0b251120; extra == "ext"
 Dynamic: license-file
 
 <div align="center">
@@ -74,6 +75,7 @@ Dynamic: license-file
 # AgentScope Runtime v1.0
 
 [![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,6 +93,7 @@ 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)
 
@@ -106,6 +109,7 @@ Dynamic: license-file
 
 ## 🆕 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.
 
 ---
@@ -125,11 +129,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) | ✅             | ✅    | 🚧       |
+> | AutoGen                                                      | 🚧             | ✅    | 🚧       |
 
 ---
 
@@ -329,15 +333,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 requires Docker or Kubernetes to be installed and running. In the future, we will offer more public cloud deployment options, as well as other virtualization technologies. Please refer to [this tutorial](https://runtime.agentscope.io/en/sandbox.html) for more details.
 >
 > 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)
 
+> [!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 +364,15 @@ 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
 ```
 
 #### GUI Sandbox
@@ -355,14 +382,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 +412,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,13 +440,24 @@ 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
-from agentscope_runtime.sandbox import FilesystemSandbox
+# --- Synchronous version ---
+from agentscope_runtime.sandbox import BrowserSandbox
 
-with FilesystemSandbox() as box:
-    # By default, pulls `agentscope/runtime-sandbox-filesystem:latest` from DockerHub
-    print(box.list_tools()) # List all available tools
+with BrowserSandbox() as box:
+    # By default, pulls `agentscope/runtime-sandbox-browser:latest` from DockerHub
+    print(box.list_tools())  # List all available tools
     print(box.desktop_url)  # Web desktop access URL
-    box.create_directory("test")  # Create a directory
+    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...")
 ```
 
@@ -421,16 +482,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 +578,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:
 
@@ -570,8 +643,7 @@ 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/).
+to [ModelStudio](https://bailian.console.aliyun.com/?admin=1&tab=doc#/doc/?type=app&url=2983030).
 
 ```python
 from agentscope_runtime.engine.deployers import ModelStudioDeployManager
@@ -653,7 +725,7 @@ limitations under the License.
 
 ## 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-31-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 +773,8 @@ 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>
     </tr>
   </tbody>
   <tfoot>

{agentscope_runtime-1.0.3 → agentscope_runtime-1.0.4}/README.md

@@ -3,6 +3,7 @@
 # AgentScope Runtime v1.0
 
 [![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)
@@ -20,6 +21,7 @@
 [![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)
 
@@ -35,6 +37,7 @@
 
 ## 🆕 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.
 
 ---
@@ -54,11 +57,11 @@
 >
 > | 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) | ✅             | ✅    | 🚧       |
+> | AutoGen                                                      | 🚧             | ✅    | 🚧       |
 
 ---
 
@@ -258,15 +261,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 requires Docker or Kubernetes to be installed and running. In the future, we will offer more public cloud deployment options, as well as other virtualization technologies. Please refer to [this tutorial](https://runtime.agentscope.io/en/sandbox.html) for more details.
 >
 > 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)
 
+> [!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:
@@ -275,6 +292,15 @@ 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
 ```
 
 #### GUI Sandbox
@@ -284,14 +310,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...")
 ```
 
@@ -302,14 +340,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
@@ -319,13 +368,24 @@ 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
-from agentscope_runtime.sandbox import FilesystemSandbox
+# --- Synchronous version ---
+from agentscope_runtime.sandbox import BrowserSandbox
 
-with FilesystemSandbox() as box:
-    # By default, pulls `agentscope/runtime-sandbox-filesystem:latest` from DockerHub
-    print(box.list_tools()) # List all available tools
+with BrowserSandbox() as box:
+    # By default, pulls `agentscope/runtime-sandbox-browser:latest` from DockerHub
+    print(box.list_tools())  # List all available tools
     print(box.desktop_url)  # Web desktop access URL
-    box.create_directory("test")  # Create a directory
+    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...")
 ```
 
@@ -350,16 +410,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...")
 ```
 
@@ -430,15 +506,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:
 
@@ -499,8 +571,7 @@ 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/).
+to [ModelStudio](https://bailian.console.aliyun.com/?admin=1&tab=doc#/doc/?type=app&url=2983030).
 
 ```python
 from agentscope_runtime.engine.deployers import ModelStudioDeployManager
@@ -582,7 +653,7 @@ limitations under the License.
 
 ## 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-31-orange.svg?style=flat-square)](#contributors-)
 <!-- ALL-CONTRIBUTORS-BADGE:END -->
 
 Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/emoji-key/)):
@@ -630,6 +701,8 @@ 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>
     </tr>
   </tbody>
   <tfoot>

{agentscope_runtime-1.0.3 → agentscope_runtime-1.0.4}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "agentscope-runtime"
-version = "1.0.3"
+version = "1.0.4"
 description = "A production-ready runtime framework for agent applications, providing secure sandboxed execution environments and scalable deployment solutions with multi-framework support."
 readme = "README.md"
 requires-python = ">=3.10"
@@ -91,6 +91,7 @@ ext = [
     "PyYAML",
     "agno>=2.3.8",
     "nacos-sdk-python>=3.0.0",
+    "agent-framework>=1.0.0b251120",
 ]
 
 [tool.pytest.ini_options]

{agentscope_runtime-1.0.3 → agentscope_runtime-1.0.4}/src/agentscope_runtime/adapters/agentscope/stream.py

@@ -9,6 +9,7 @@ from urllib.parse import urlparse
 from agentscope import setup_logger
 from agentscope.message import Msg
 
+from ..utils import _update_obj_attrs
 from ...engine.schemas.agent_schemas import (
     Message,
     Content,
@@ -26,13 +27,6 @@ from ...engine.schemas.agent_schemas import (
 setup_logger("ERROR")
 
 
-def _update_obj_attrs(obj, **attrs):
-    for key, value in attrs.items():
-        if hasattr(obj, key):
-            setattr(obj, key, value)
-    return obj
-
-
 async def adapt_agentscope_message_stream(
     source_stream: AsyncIterator[Tuple[Msg, bool]],
 ) -> AsyncIterator[Union[Message, Content]]:
@@ -97,10 +91,9 @@ async def adapt_agentscope_message_stream(
                 else:
                     new_tool_blocks.append(block)
             if new_tool_blocks:
-                if tool_start:
+                if tool_start:  # Only for close the last msg
                     msg.content = new_tool_blocks
                 else:
-                    msg.content = new_blocks
                     tool_start = True
 
             else: