agentscope-runtime 1.0.5.post1__py3-none-any.whl → 1.1.0b2__py3-none-any.whl

agentscope_runtime/sandbox/manager/server/app.py

@@ -25,8 +25,6 @@ from ...model.manager_config import SandboxManagerEnvConfig
 from ...utils import dynamic_import, http_to_ws
 from ....version import __version__
 
-# Configure logging
-logging.basicConfig(level=logging.INFO)
 logger = logging.getLogger(__name__)
 
 # Create FastAPI app
@@ -65,6 +63,7 @@ def get_config() -> SandboxManagerEnvConfig:
             container_deployment=settings.CONTAINER_DEPLOYMENT,
             default_mount_dir=settings.DEFAULT_MOUNT_DIR,
             readonly_mounts=settings.READONLY_MOUNTS,
+            allow_mount_dir=settings.ALLOW_MOUNT_DIR,
             storage_folder=settings.STORAGE_FOLDER,
             port_range=settings.PORT_RANGE,
             pool_size=settings.POOL_SIZE,
@@ -105,6 +104,11 @@ def get_config() -> SandboxManagerEnvConfig:
             fc_prefix=settings.FC_PREFIX,
             fc_log_project=settings.FC_LOG_PROJECT,
             fc_log_store=settings.FC_LOG_STORE,
+            heartbeat_timeout=settings.HEARTBEAT_TIMEOUT,
+            heartbeat_lock_ttl=settings.HEARTBEAT_LOCK_TTL,
+            watcher_scan_interval=settings.WATCHER_SCAN_INTERVAL,
+            released_key_ttl=settings.RELEASE_KET_TTL,
+            max_sandbox_instances=settings.MAX_SANDBOX_INSTANCES,
         )
     return _config
 
@@ -208,15 +212,25 @@ async def startup_event():
     get_sandbox_manager()
     register_routes(app, _sandbox_manager)
 
+    # Start heartbeat watcher on server side
+    _sandbox_manager.start_watcher()
+
 
 @app.on_event("shutdown")
 async def shutdown_event():
     """Cleanup resources on shutdown"""
     global _sandbox_manager
     settings = get_settings()
-    if _sandbox_manager and settings.AUTO_CLEANUP:
+    if not _sandbox_manager:
+        return
+
+    # stop watcher first
+    _sandbox_manager.stop_watcher()
+
+    if settings.AUTO_CLEANUP:
         _sandbox_manager.cleanup()
-        _sandbox_manager = None
+
+    _sandbox_manager = None
 
 
 @app.get(
@@ -355,13 +369,6 @@ def setup_logging(log_level: str):
 
     level = level_mapping.get(log_level.upper(), logging.INFO)
 
-    # Reconfigure logging
-    logging.basicConfig(
-        level=level,
-        format="%(asctime)s - %(name)s - %(levelname)s - %(message)s",
-        force=True,  # This will reconfigure existing loggers
-    )
-
     # Update the logger for this module
     global logger
     logger.setLevel(level)

agentscope_runtime/sandbox/manager/server/config.py

@@ -38,7 +38,8 @@ class Settings(BaseSettings):
     # READONLY_MOUNTS={"\/opt\/shared": "\/mnt\/shared", "\/etc\/timezone":
     # "\/etc\/timezone"}
     READONLY_MOUNTS: Optional[Dict[str, str]] = None
-    STORAGE_FOLDER: str = "runtime_sandbox_storage"
+    ALLOW_MOUNT_DIR: Optional[bool] = False
+    STORAGE_FOLDER: Optional[str] = None
     PORT_RANGE: Tuple[int, int] = (49152, 59152)
 
     # Redis settings
@@ -98,8 +99,15 @@ class Settings(BaseSettings):
     FC_LOG_PROJECT: Optional[str] = None
     FC_LOG_STORE: Optional[str] = None
 
+    # Heartbeat related
+    HEARTBEAT_TIMEOUT: int = 300
+    HEARTBEAT_LOCK_TTL: int = 120
+    WATCHER_SCAN_INTERVAL: int = 1  # 0 to disable watcher
+    RELEASE_KET_TTL: int = 3600
+
+    MAX_SANDBOX_INSTANCES: int = 0  # 0 means unlimited
+
     model_config = ConfigDict(
-        case_sensitive=True,
         extra="allow",
     )
 

agentscope_runtime/sandbox/mcp_server.py

@@ -9,7 +9,6 @@ from .box.browser.browser_sandbox import BrowserSandbox
 from .box.filesystem.filesystem_sandbox import FilesystemSandbox
 from .enums import SandboxType
 
-logging.basicConfig(level=logging.INFO)
 logger = logging.getLogger(__name__)
 
 mcp = FastMCP("AgentRuntime Sandbox MCP Server")

agentscope_runtime/sandbox/model/__init__.py

@@ -1,8 +1,9 @@
 # -*- coding: utf-8 -*-
-from .container import ContainerModel
+from .container import ContainerModel, ContainerState
 from .manager_config import SandboxManagerEnvConfig
 
 __all__ = [
     "ContainerModel",
+    "ContainerState",
     "SandboxManagerEnvConfig",
 ]

agentscope_runtime/sandbox/model/container.py

@@ -1,10 +1,23 @@
 # -*- coding: utf-8 -*-
+import copy
+import time
+from enum import Enum
 from typing import List, Optional, Dict
 
-from pydantic import BaseModel, Field
+from pydantic import BaseModel, Field, ConfigDict, model_validator
+
+
+class ContainerState(str, Enum):
+    WARM = "warm"
+    RUNNING = "running"
+    RECYCLED = "recycled"
+    ERROR = "error"
+    RELEASED = "released"
 
 
 class ContainerModel(BaseModel):
+    model_config = ConfigDict(extra="allow")
+
     session_id: str = Field(
         ...,
         description="Unique identifier for the session",
@@ -59,5 +72,79 @@ class ContainerModel(BaseModel):
         ge=0,
     )
 
-    class Config:
-        extra = "allow"
+    sandbox_type: Optional[str] = Field(
+        default=None,
+        description="Sandbox type (e.g. base/browser/...). Usually "
+        "SandboxType.value.",
+    )
+
+    state: ContainerState = Field(
+        default=ContainerState.RUNNING,
+        description="Lifecycle state",
+    )
+
+    # Pull session_ctx_id up from meta for easier indexing/logic
+    session_ctx_id: Optional[str] = Field(
+        default=None,
+        description="Bound session context id "
+        "(copied from meta['session_ctx_id'] for compatibility)",
+    )
+
+    # Heartbeat timestamp (unix seconds)
+    last_active_at: Optional[float] = Field(
+        default=None,
+        description="Last activity timestamp (unix seconds)",
+    )
+
+    # Recycle/release timestamps
+    recycled_at: Optional[float] = Field(
+        default=None,
+        description="Recycled timestamp (unix seconds)",
+    )
+    released_at: Optional[float] = Field(
+        default=None,
+        description="Released timestamp (unix seconds)",
+    )
+    updated_at: Optional[float] = Field(
+        default=None,
+        description="Last model update timestamp (unix seconds)",
+    )
+
+    recycle_reason: Optional[str] = Field(
+        default=None,
+        description="Reason for recycle",
+    )
+
+    @model_validator(mode="after")
+    def _compat_and_defaults(self):
+        """Compatibility layer for ContainerModel.
+
+        This validator ensures backward compatibility and default value
+        population:
+        - Reads session_ctx_id from meta if not provided
+        - Writes session_ctx_id back to meta for old code compatibility
+        - Ensures updated_at is always populated
+
+        Returns:
+            `ContainerModel`:
+                The validated model instance
+        """
+        # normalize meta
+        if self.meta is None:
+            self.meta = {}
+
+        # meta -> session_ctx_id
+        if not self.session_ctx_id:
+            v = self.meta.get("session_ctx_id")
+            if v:
+                self.session_ctx_id = v
+
+        # session_ctx_id -> meta
+        if self.session_ctx_id:
+            self.meta["session_ctx_id"] = copy.deepcopy(self.session_ctx_id)
+
+        # default updated_at
+        if self.updated_at is None:
+            self.updated_at = time.time()
+
+        return self

agentscope_runtime/sandbox/model/manager_config.py

@@ -20,7 +20,7 @@ class SandboxManagerEnvConfig(BaseModel):
         description="Type of file system to use: 'local' or 'oss'.",
     )
     storage_folder: Optional[str] = Field(
-        "runtime_sandbox_storage",
+        None,
         description="Folder path in storage.",
     )
     redis_enabled: bool = Field(
@@ -53,6 +53,15 @@ class SandboxManagerEnvConfig(BaseModel):
         "'/etc/timezone' }",
     )
 
+    allow_mount_dir: bool = Field(
+        default=False,
+        description=(
+            "Whether to allow passing `mount_dir`. "
+            "Disable by default to prevent mounting server-local paths when "
+            "running as a manager service."
+        ),
+    )
+
     port_range: Tuple[int, int] = Field(
         (49152, 59152),
         description="Range of ports to be used by the manager.",
@@ -239,6 +248,41 @@ class SandboxManagerEnvConfig(BaseModel):
         description="Log store for FC.",
     )
 
+    # Heartbeat related
+    heartbeat_timeout: int = Field(
+        default=300,
+        description="Idle timeout in seconds before session is reaped.",
+        gt=0,
+    )
+    heartbeat_lock_ttl: int = Field(
+        default=120,
+        description="Redis distributed lock TTL in seconds for reaping.",
+        gt=0,
+    )
+    watcher_scan_interval: int = Field(
+        default=1,
+        description=(
+            "Background watcher loop interval in seconds. "
+            "0 disables watcher. Watcher includes heartbeat scan, pool "
+            "replenish, and released-record cleanup."
+        ),
+        ge=0,
+    )
+    released_key_ttl: int = Field(
+        default=3600,
+        description=(
+            "TTL in seconds for keeping RELEASED container records in "
+            "container_mapping. 0 disables cleanup."
+        ),
+        ge=0,
+    )
+    max_sandbox_instances: int = Field(
+        default=0,
+        description="Maximum number of sandbox instances allowed. "
+        "0 means unlimited.",
+        ge=0,
+    )
+
     @model_validator(mode="after")
     def check_settings(self):
         if self.default_mount_dir:

agentscope_runtime/version.py

@@ -1,2 +1,2 @@
 # -*- coding: utf-8 -*-
-__version__ = "v1.0.5.post1"
+__version__ = "v1.1.0b2"

{agentscope_runtime-1.0.5.post1.dist-info → agentscope_runtime-1.1.0b2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agentscope-runtime
-Version: 1.0.5.post1
+Version: 1.1.0b2
 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
@@ -11,7 +11,7 @@ Requires-Dist: uvicorn[standard]>=0.24.0
 Requires-Dist: openai
 Requires-Dist: pydantic>=2.11.7
 Requires-Dist: requests>=2.32.4
-Requires-Dist: agentscope<1.0.12,>=1.0.9
+Requires-Dist: agentscope>=1.0.14
 Requires-Dist: docker>=7.1.0
 Requires-Dist: redis>=6.0.0
 Requires-Dist: oss2>=2.19.1
@@ -50,7 +50,6 @@ Requires-Dist: mem0ai>=0.1.117; extra == "ext"
 Requires-Dist: alibabacloud-agentrun20250910>=2.0.1; extra == "ext"
 Requires-Dist: alibabacloud_tea_openapi>=0.4.0; extra == "ext"
 Requires-Dist: alibabacloud-fc20230330>=4.4.0; extra == "ext"
-Requires-Dist: tablestore-for-agent-memory>=1.1.0; extra == "ext"
 Requires-Dist: langchain-community>=0.3.27; extra == "ext"
 Requires-Dist: wuying-agentbay-sdk<0.13.0,>=0.5.0; extra == "ext"
 Requires-Dist: alipay-sdk-python; extra == "ext"
@@ -90,7 +89,7 @@ Dynamic: license-file
 [![GitHub Forks](https://img.shields.io/github/forks/agentscope-ai/agentscope-runtime?style=flat&logo=github&color=purple&label=Forks)](https://github.com/agentscope-ai/agentscope-runtime/network)
 [![Build Status](https://img.shields.io/badge/build-passing-brightgreen.svg?logo=githubactions&label=Build)](https://github.com/agentscope-ai/agentscope-runtime/actions)
 [![Cookbook](https://img.shields.io/badge/📚_Cookbook-English|中文-teal.svg)](https://runtime.agentscope.io)
-[![DeepWiki](https://img.shields.io/badge/DeepWiki-agentscope--runtime-navy.svg?logo=data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACwAAAAyCAYAAAAnWDnqAAAAAXNSR0IArs4c6QAAA05JREFUaEPtmUtyEzEQhtWTQyQLHNak2AB7ZnyXZMEjXMGeK/AIi+QuHrMnbChYY7MIh8g01fJoopFb0uhhEqqcbWTp06/uv1saEDv4O3n3dV60RfP947Mm9/SQc0ICFQgzfc4CYZoTPAswgSJCCUJUnAAoRHOAUOcATwbmVLWdGoH//PB8mnKqScAhsD0kYP3j/Yt5LPQe2KvcXmGvRHcDnpxfL2zOYJ1mFwrryWTz0advv1Ut4CJgf5uhDuDj5eUcAUoahrdY/56ebRWeraTjMt/00Sh3UDtjgHtQNHwcRGOC98BJEAEymycmYcWwOprTgcB6VZ5JK5TAJ+fXGLBm3FDAmn6oPPjR4rKCAoJCal2eAiQp2x0vxTPB3ALO2CRkwmDy5WohzBDwSEFKRwPbknEggCPB/imwrycgxX2NzoMCHhPkDwqYMr9tRcP5qNrMZHkVnOjRMWwLCcr8ohBVb1OMjxLwGCvjTikrsBOiA6fNyCrm8V1rP93iVPpwaE+gO0SsWmPiXB+jikdf6SizrT5qKasx5j8ABbHpFTx+vFXp9EnYQmLx02h1QTTrl6eDqxLnGjporxl3NL3agEvXdT0WmEost648sQOYAeJS9Q7bfUVoMGnjo4AZdUMQku50McDcMWcBPvr0SzbTAFDfvJqwLzgxwATnCgnp4wDl6Aa+Ax283gghmj+vj7feE2KBBRMW3FzOpLOADl0Isb5587h/U4gGvkt5v60Z1VLG8BhYjbzRwyQZemwAd6cCR5/XFWLYZRIMpX39AR0tjaGGiGzLVyhse5C9RKC6ai42ppWPKiBagOvaYk8lO7DajerabOZP46Lby5wKjw1HCRx7p9sVMOWGzb/vA1hwiWc6jm3MvQDTogQkiqIhJV0nBQBTU+3okKCFDy9WwferkHjtxib7t3xIUQtHxnIwtx4mpg26/HfwVNVDb4oI9RHmx5WGelRVlrtiw43zboCLaxv46AZeB3IlTkwouebTr1y2NjSpHz68WNFjHvupy3q8TFn3Hos2IAk4Ju5dCo8B3wP7VPr/FGaKiG+T+v+TQqIrOqMTL1VdWV1DdmcbO8KXBz6esmYWYKPwDL5b5FA1a0hwapHiom0r/cKaoqr+27/XcrS5UwSMbQAAAABJRU5ErkJggg==)](https://deepwiki.com/agentscope-ai/agentscope-runtime)
+[![DeepWiki](https://img.shields.io/badge/DeepWiki-Ask_Devin-navy.svg?logo=data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACwAAAAyCAYAAAAnWDnqAAAAAXNSR0IArs4c6QAAA05JREFUaEPtmUtyEzEQhtWTQyQLHNak2AB7ZnyXZMEjXMGeK/AIi+QuHrMnbChYY7MIh8g01fJoopFb0uhhEqqcbWTp06/uv1saEDv4O3n3dV60RfP947Mm9/SQc0ICFQgzfc4CYZoTPAswgSJCCUJUnAAoRHOAUOcATwbmVLWdGoH//PB8mnKqScAhsD0kYP3j/Yt5LPQe2KvcXmGvRHcDnpxfL2zOYJ1mFwrryWTz0advv1Ut4CJgf5uhDuDj5eUcAUoahrdY/56ebRWeraTjMt/00Sh3UDtjgHtQNHwcRGOC98BJEAEymycmYcWwOprTgcB6VZ5JK5TAJ+fXGLBm3FDAmn6oPPjR4rKCAoJCal2eAiQp2x0vxTPB3ALO2CRkwmDy5WohzBDwSEFKRwPbknEggCPB/imwrycgxX2NzoMCHhPkDwqYMr9tRcP5qNrMZHkVnOjRMWwLCcr8ohBVb1OMjxLwGCvjTikrsBOiA6fNyCrm8V1rP93iVPpwaE+gO0SsWmPiXB+jikdf6SizrT5qKasx5j8ABbHpFTx+vFXp9EnYQmLx02h1QTTrl6eDqxLnGjporxl3NL3agEvXdT0WmEost648sQOYAeJS9Q7bfUVoMGnjo4AZdUMQku50McDcMWcBPvr0SzbTAFDfvJqwLzgxwATnCgnp4wDl6Aa+Ax283gghmj+vj7feE2KBBRMW3FzOpLOADl0Isb5587h/U4gGvkt5v60Z1VLG8BhYjbzRwyQZemwAd6cCR5/XFWLYZRIMpX39AR0tjaGGiGzLVyhse5C9RKC6ai42ppWPKiBagOvaYk8lO7DajerabOZP46Lby5wKjw1HCRx7p9sVMOWGzb/vA1hwiWc6jm3MvQDTogQkiqIhJV0nBQBTU+3okKCFDy9WwferkHjtxib7t3xIUQtHxnIwtx4mpg26/HfwVNVDb4oI9RHmx5WGelRVlrtiw43zboCLaxv46AZeB3IlTkwouebTr1y2NjSpHz68WNFjHvupy3q8TFn3Hos2IAk4Ju5dCo8B3wP7VPr/FGaKiG+T+v+TQqIrOqMTL1VdWV1DdmcbO8KXBz6esmYWYKPwDL5b5FA1a0hwapHiom0r/cKaoqr+27/XcrS5UwSMbQAAAABJRU5ErkJggg==)](https://deepwiki.com/agentscope-ai/agentscope-runtime)
 [![A2A](https://img.shields.io/badge/A2A-Agent_to_Agent-blue.svg?label=A2A)](https://a2a-protocol.org/)
 [![MCP](https://img.shields.io/badge/MCP-Model_Context_Protocol-purple.svg?logo=plug&label=MCP)](https://modelcontextprotocol.io/)
 [![Discord](https://img.shields.io/badge/Discord-Join_Us-blueviolet.svg?logo=discord)](https://discord.gg/eYMpfnkG8h)
@@ -171,13 +170,13 @@ Dynamic: license-file
 >
 > **About Framework-Agnostic**: Currently, AgentScope Runtime supports the **AgentScope** framework. We plan to extend compatibility to more agent development frameworks in the future. This table shows the current version’s adapter support for different frameworks. The level of support for each functionality varies across frameworks:
 >
-> | Framework/Feature                                            | Message/Event | Tool | Service |
-> | ------------------------------------------------------------ | ------------- | ---- | ------- |
-> | [AgentScope](https://runtime.agentscope.io/en/quickstart.html) | ✅             | ✅    | ✅       |
-> | [LangGraph](https://runtime.agentscope.io/en/langgraph_guidelines.html) | ✅             | 🚧    | 🚧       |
-> | [Microsoft Agent Framework](https://runtime.agentscope.io/en/ms_agent_framework_guidelines.html) | ✅             | ✅    | 🚧       |
-> | [Agno](https://runtime.agentscope.io/en/agno_guidelines.html) | ✅             | ✅    | 🚧       |
-> | AutoGen                                                      | 🚧             | ✅    | 🚧       |
+> | Framework/Feature                                            | Message/Event | Tool |
+> | ------------------------------------------------------------ | ------------- | ---- |
+> | [AgentScope](https://runtime.agentscope.io/en/quickstart.html) | ✅             | ✅    |
+> | [LangGraph](https://runtime.agentscope.io/en/langgraph_guidelines.html) | ✅             | 🚧    |
+> | [Microsoft Agent Framework](https://runtime.agentscope.io/en/ms_agent_framework_guidelines.html) | ✅             | ✅    |
+> | [Agno](https://runtime.agentscope.io/en/agno_guidelines.html) | ✅             | ✅    |
+> | AutoGen                                                      | 🚧             | ✅    |
 
 ---
 
@@ -230,18 +229,11 @@ from agentscope.model import DashScopeChatModel
 from agentscope.formatter import DashScopeChatFormatter
 from agentscope.tool import Toolkit, execute_python_code
 from agentscope.pipeline import stream_printing_messages
+from agentscope.memory import InMemoryMemory
+from agentscope.session import RedisSession
 
 from agentscope_runtime.engine import AgentApp
 from agentscope_runtime.engine.schemas.agent_schemas import AgentRequest
-from agentscope_runtime.adapters.agentscope.memory import (
-    AgentScopeSessionHistoryMemory,
-)
-from agentscope_runtime.engine.services.agent_state import (
-    InMemoryStateService,
-)
-from agentscope_runtime.engine.services.session_history import (
-    InMemorySessionHistoryService,
-)
 
 agent_app = AgentApp(
     app_name="Friday",
@@ -251,17 +243,13 @@ agent_app = AgentApp(
 
 @agent_app.init
 async def init_func(self):
-    self.state_service = InMemoryStateService()
-    self.session_service = InMemorySessionHistoryService()
-
-    await self.state_service.start()
-    await self.session_service.start()
+    import fakeredis
 
-
-@agent_app.shutdown
-async def shutdown_func(self):
-    await self.state_service.stop()
-    await self.session_service.stop()
+    fake_redis = fakeredis.aioredis.FakeRedis(decode_responses=True)
+    # NOTE: This FakeRedis instance is for development/testing only.
+    # In production, replace it with your own Redis client/connection
+    # (e.g., aioredis.Redis)
+    self.session = RedisSession(connection_pool=fake_redis.connection_pool)
 
 
 @agent_app.query(framework="agentscope")
@@ -274,11 +262,6 @@ async def query_func(
     session_id = request.session_id
     user_id = request.user_id
 
-    state = await self.state_service.export_state(
-        session_id=session_id,
-        user_id=user_id,
-    )
-
     toolkit = Toolkit()
     toolkit.register_tool_function(execute_python_code)
 
@@ -291,17 +274,16 @@ async def query_func(
         ),
         sys_prompt="You're a helpful assistant named Friday.",
         toolkit=toolkit,
-        memory=AgentScopeSessionHistoryMemory(
-            service=self.session_service,
-            session_id=session_id,
-            user_id=user_id,
-        ),
+        memory=InMemoryMemory(),
         formatter=DashScopeChatFormatter(),
     )
     agent.set_console_output_enabled(enabled=False)
 
-    if state:
-        agent.load_state_dict(state)
+    await self.session.load_session_state(
+        session_id=session_id,
+        user_id=user_id,
+        agent=agent,
+    )
 
     async for msg, last in stream_printing_messages(
         agents=[agent],
@@ -309,12 +291,10 @@ async def query_func(
     ):
         yield msg, last
 
-    state = agent.state_dict()
-
-    await self.state_service.save_state(
-        user_id=user_id,
+    await self.session.save_session_state(
         session_id=session_id,
-        state=state,
+        user_id=user_id,
+        agent=agent,
     )
 
 
@@ -394,7 +374,7 @@ 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.list_tools_async())  # 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...")
@@ -423,7 +403,7 @@ 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(await box.list_tools_async())  # 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
@@ -452,7 +432,7 @@ 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(await box.list_tools_async())  # 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...")
@@ -480,7 +460,7 @@ 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(await box.list_tools_async())  # 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...")
@@ -526,7 +506,7 @@ 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.list_tools_async())  # 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
@@ -649,7 +629,7 @@ After deployment, users can also access this service using the Response API of t
 ```python
 from openai import OpenAI
 
-client = OpenAI(base_url="http://0.0.0.0:8090/compatible-mode/v1")
+client = OpenAI(base_url="http://localhost:8090/compatible-mode/v1")
 
 response = client.responses.create(
   model="any_name",
@@ -763,7 +743,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-32-orange.svg?style=flat-square)](#contributors-)
+[![All Contributors](https://img.shields.io/badge/all_contributors-34-orange.svg?style=flat-square)](#contributors-)
 <!-- ALL-CONTRIBUTORS-BADGE:END -->
 
 Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/emoji-key/)):
@@ -814,6 +794,8 @@ Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/e
       <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>
+      <td align="center" valign="top" width="14.28%"><a href="https://github.com/cainiao1992"><img src="https://avatars.githubusercontent.com/u/18435004?v=4?s=100" width="100px;" alt="Xiangfang Chen"/><br /><sub><b>Xiangfang Chen</b></sub></a><br /><a href="https://github.com/agentscope-ai/agentscope-runtime/commits?author=cainiao1992" title="Documentation">📖</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://github.com/Eggiverse"><img src="https://avatars.githubusercontent.com/u/36877740?v=4?s=100" width="100px;" alt="Zhang Shitian"/><br /><sub><b>Zhang Shitian</b></sub></a><br /><a href="https://github.com/agentscope-ai/agentscope-runtime/issues?q=author%3AEggiverse" title="Bug reports">🐛</a> <a href="https://github.com/agentscope-ai/agentscope-runtime/commits?author=Eggiverse" title="Code">💻</a></td>
     </tr>
   </tbody>
   <tfoot>