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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agentscope-runtime
-Version: 1.0.4
+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,12 +68,15 @@ 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"
+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/)
@@ -97,13 +101,53 @@ Dynamic: license-file
 [[中文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>
 
-***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.*
+</div>
+
+---
 
-*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)
 
 ---
 
@@ -116,12 +160,12 @@ Dynamic: license-file
 
 ## ✨ 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]
 >
@@ -137,26 +181,6 @@ Dynamic: license-file
 
 ---
 
-## 💬 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)
-
----
-
 ## 🚀 Quick Start
 
 ### Prerequisites
@@ -333,9 +357,9 @@ These examples demonstrate how to create sandboxed environments and execute tool
 
 > [!NOTE]
 >
-> 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 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
@@ -373,6 +397,7 @@ async with BaseSandboxAsync() as box:
     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
@@ -441,23 +466,23 @@ A GUI-based sandbox with **file system operations** such as creating, reading, a
 
 ```python
 # --- Synchronous version ---
-from agentscope_runtime.sandbox import BrowserSandbox
+from agentscope_runtime.sandbox import FilesystemSandbox
 
-with BrowserSandbox() as box:
-    # By default, pulls `agentscope/runtime-sandbox-browser:latest` from DockerHub
+with FilesystemSandbox() as box:
+    # By default, pulls `agentscope/runtime-sandbox-filesystem:latest` from DockerHub
     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
+    box.create_directory("test")  # Create a directory
     input("Press Enter to continue...")
 
 # --- Asynchronous version ---
-from agentscope_runtime.sandbox import BrowserSandboxAsync
+from agentscope_runtime.sandbox import FilesystemSandboxAsync
 
-async with BrowserSandboxAsync() as box:
-    # Default image is `agentscope/runtime-sandbox-browser:latest`
+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.browser_navigate("https://www.google.com/")  # Open a webpage
+    await box.create_directory("test")  # Create a directory
     input("Press Enter to continue...")
 ```
 
@@ -592,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.
 
@@ -611,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
@@ -623,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:
@@ -642,11 +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).
+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(
@@ -678,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:
@@ -723,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-31-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/)):
@@ -775,6 +813,7 @@ Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/e
       <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>

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

@@ -1,6 +1,6 @@
 <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/)
@@ -25,13 +25,53 @@
 [[中文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>
 
-***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.*
+</div>
+
+---
 
-*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)
 
 ---
 
@@ -44,12 +84,12 @@
 
 ## ✨ 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]
 >
@@ -65,26 +105,6 @@
 
 ---
 
-## 💬 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)
-
----
-
 ## 🚀 Quick Start
 
 ### Prerequisites
@@ -261,9 +281,9 @@ These examples demonstrate how to create sandboxed environments and execute tool
 
 > [!NOTE]
 >
-> 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 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
@@ -301,6 +321,7 @@ async with BaseSandboxAsync() as box:
     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
@@ -369,23 +390,23 @@ A GUI-based sandbox with **file system operations** such as creating, reading, a
 
 ```python
 # --- Synchronous version ---
-from agentscope_runtime.sandbox import BrowserSandbox
+from agentscope_runtime.sandbox import FilesystemSandbox
 
-with BrowserSandbox() as box:
-    # By default, pulls `agentscope/runtime-sandbox-browser:latest` from DockerHub
+with FilesystemSandbox() as box:
+    # By default, pulls `agentscope/runtime-sandbox-filesystem:latest` from DockerHub
     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
+    box.create_directory("test")  # Create a directory
     input("Press Enter to continue...")
 
 # --- Asynchronous version ---
-from agentscope_runtime.sandbox import BrowserSandboxAsync
+from agentscope_runtime.sandbox import FilesystemSandboxAsync
 
-async with BrowserSandboxAsync() as box:
-    # Default image is `agentscope/runtime-sandbox-browser:latest`
+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.browser_navigate("https://www.google.com/")  # Open a webpage
+    await box.create_directory("test")  # Create a directory
     input("Press Enter to continue...")
 ```
 
@@ -520,17 +541,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.
 
@@ -539,7 +550,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
@@ -551,8 +562,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:
@@ -570,11 +583,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).
+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 +624,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 +685,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-31-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/)):
@@ -703,6 +737,7 @@ Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/e
       <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>

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

@@ -1,6 +1,6 @@
 [project]
 name = "agentscope-runtime"
-version = "1.0.4"
+version = "1.0.5"
 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"
@@ -28,6 +28,7 @@ dependencies = [
     "asgiref",
     "click>=8.0.0",
     "rich>=13.0.0",
+    "ag-ui-protocol>=0.1.10"
 ]
 
 [tool.setuptools]
@@ -91,7 +92,10 @@ ext = [
     "PyYAML",
     "agno>=2.3.8",
     "nacos-sdk-python>=3.0.0",
-    "agent-framework>=1.0.0b251120",
+    "agent-framework>=1.0.0b251120,<1.0.0b260114",
+    "boxlite>=0.5.2",
+    "alibabacloud-eas20210701>=7.0.0,<8.0.0",
+    "alibabacloud-aiworkspace20210204>=7.0.0,<8.0.0",
 ]
 
 [tool.pytest.ini_options]

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

@@ -271,7 +271,7 @@ async def adapt_agentscope_message_stream(
                                 role="assistant",
                             )
                             data_delta_content = DataContent(
-                                index=0,
+                                index=None if last else 0,
                                 data=fc_cls(
                                     call_id=element["id"],
                                     name=element.get("name"),