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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agentscope-runtime
-Version: 1.0.2
+Version: 1.0.3
 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
@@ -51,7 +51,7 @@ 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.5.0; extra == "ext"
+Requires-Dist: wuying-agentbay-sdk<0.13.0,>=0.5.0; extra == "ext"
 Requires-Dist: alipay-sdk-python; extra == "ext"
 Requires-Dist: cryptography; extra == "ext"
 Requires-Dist: gunicorn>=20.0.0; extra == "ext"
@@ -66,6 +66,7 @@ Requires-Dist: wheel; extra == "ext"
 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"
 Dynamic: license-file
 
 <div align="center">
@@ -652,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-26-orange.svg?style=flat-square)](#contributors-)
+[![All Contributors](https://img.shields.io/badge/all_contributors-29-orange.svg?style=flat-square)](#contributors-)
 <!-- ALL-CONTRIBUTORS-BADGE:END -->
 
 Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/emoji-key/)):
@@ -695,6 +696,11 @@ 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/k-farruh"><img src="https://avatars.githubusercontent.com/u/33511681?v=4?s=100" width="100px;" alt="Farruh Kushnazarov"/><br /><sub><b>Farruh Kushnazarov</b></sub></a><br /><a href="https://github.com/agentscope-ai/agentscope-runtime/commits?author=k-farruh" title="Documentation">📖</a></td>
       <td align="center" valign="top" width="14.28%"><a href="https://github.com/fengxsong"><img src="https://avatars.githubusercontent.com/u/7008971?v=4?s=100" width="100px;" alt="fengxsong"/><br /><sub><b>fengxsong</b></sub></a><br /><a href="https://github.com/agentscope-ai/agentscope-runtime/issues?q=author%3Afengxsong" title="Bug reports">🐛</a></td>
       <td align="center" valign="top" width="14.28%"><a href="https://m4n5ter.github.io"><img src="https://avatars.githubusercontent.com/u/68144809?v=4?s=100" width="100px;" alt="Wang"/><br /><sub><b>Wang</b></sub></a><br /><a href="https://github.com/agentscope-ai/agentscope-runtime/commits?author=M4n5ter" title="Code">💻</a> <a href="https://github.com/agentscope-ai/agentscope-runtime/issues?q=author%3AM4n5ter" title="Bug reports">🐛</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://github.com/qiacheng7"><img src="https://avatars.githubusercontent.com/u/223075252?v=4?s=100" width="100px;" alt="qiacheng7"/><br /><sub><b>qiacheng7</b></sub></a><br /><a href="https://github.com/agentscope-ai/agentscope-runtime/commits?author=qiacheng7" title="Code">💻</a> <a href="https://github.com/agentscope-ai/agentscope-runtime/commits?author=qiacheng7" title="Documentation">📖</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://xieyxclack.github.io/"><img src="https://avatars.githubusercontent.com/u/31954383?v=4?s=100" width="100px;" alt="Yuexiang XIE"/><br /><sub><b>Yuexiang XIE</b></sub></a><br /><a href="https://github.com/agentscope-ai/agentscope-runtime/pulls?q=is%3Apr+reviewed-by%3Axieyxclack" title="Reviewed Pull Requests">👀</a></td>
+    </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>
     </tr>
   </tbody>
   <tfoot>

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

@@ -582,7 +582,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-26-orange.svg?style=flat-square)](#contributors-)
+[![All Contributors](https://img.shields.io/badge/all_contributors-29-orange.svg?style=flat-square)](#contributors-)
 <!-- ALL-CONTRIBUTORS-BADGE:END -->
 
 Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/emoji-key/)):
@@ -625,6 +625,11 @@ 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/k-farruh"><img src="https://avatars.githubusercontent.com/u/33511681?v=4?s=100" width="100px;" alt="Farruh Kushnazarov"/><br /><sub><b>Farruh Kushnazarov</b></sub></a><br /><a href="https://github.com/agentscope-ai/agentscope-runtime/commits?author=k-farruh" title="Documentation">📖</a></td>
       <td align="center" valign="top" width="14.28%"><a href="https://github.com/fengxsong"><img src="https://avatars.githubusercontent.com/u/7008971?v=4?s=100" width="100px;" alt="fengxsong"/><br /><sub><b>fengxsong</b></sub></a><br /><a href="https://github.com/agentscope-ai/agentscope-runtime/issues?q=author%3Afengxsong" title="Bug reports">🐛</a></td>
       <td align="center" valign="top" width="14.28%"><a href="https://m4n5ter.github.io"><img src="https://avatars.githubusercontent.com/u/68144809?v=4?s=100" width="100px;" alt="Wang"/><br /><sub><b>Wang</b></sub></a><br /><a href="https://github.com/agentscope-ai/agentscope-runtime/commits?author=M4n5ter" title="Code">💻</a> <a href="https://github.com/agentscope-ai/agentscope-runtime/issues?q=author%3AM4n5ter" title="Bug reports">🐛</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://github.com/qiacheng7"><img src="https://avatars.githubusercontent.com/u/223075252?v=4?s=100" width="100px;" alt="qiacheng7"/><br /><sub><b>qiacheng7</b></sub></a><br /><a href="https://github.com/agentscope-ai/agentscope-runtime/commits?author=qiacheng7" title="Code">💻</a> <a href="https://github.com/agentscope-ai/agentscope-runtime/commits?author=qiacheng7" title="Documentation">📖</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://xieyxclack.github.io/"><img src="https://avatars.githubusercontent.com/u/31954383?v=4?s=100" width="100px;" alt="Yuexiang XIE"/><br /><sub><b>Yuexiang XIE</b></sub></a><br /><a href="https://github.com/agentscope-ai/agentscope-runtime/pulls?q=is%3Apr+reviewed-by%3Axieyxclack" title="Reviewed Pull Requests">👀</a></td>
+    </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>
     </tr>
   </tbody>
   <tfoot>

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

@@ -1,6 +1,6 @@
 [project]
 name = "agentscope-runtime"
-version = "1.0.2"
+version = "1.0.3"
 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"
@@ -75,7 +75,7 @@ ext = [
     "alibabacloud-fc20230330>=4.4.0",
     "tablestore-for-agent-memory>=1.1.0",
     "langchain-community>=0.3.27",
-    "wuying-agentbay-sdk>=0.5.0",
+    "wuying-agentbay-sdk>=0.5.0,<0.13.0",
     "alipay-sdk-python",
     "cryptography",
     "gunicorn>=20.0.0",
@@ -90,6 +90,7 @@ ext = [
     "alibabacloud-credentials",
     "PyYAML",
     "agno>=2.3.8",
+    "nacos-sdk-python>=3.0.0",
 ]
 
 [tool.pytest.ini_options]

{agentscope_runtime-1.0.2 → agentscope_runtime-1.0.3}/src/agentscope_runtime/cli/commands/deploy.py

@@ -828,6 +828,13 @@ def agentrun(
     help="Target platform (e.g., 'linux/amd64', 'linux/arm64')",
     default="linux/amd64",
 )
+@click.option(
+    "--pypi-mirror",
+    help="PyPI mirror URL for pip package installation (e.g., "
+    "https://pypi.tuna.tsinghua.edu.cn/simple). If not specified, "
+    "uses pip default.",
+    default=None,
+)
 def k8s(
     source: str,
     name: str,
@@ -854,6 +861,7 @@ def k8s(
     deploy_timeout: int,
     health_check: bool,
     platform: str,
+    pypi_mirror: str,
 ):
     """
     Deploy to Kubernetes/ACK.
@@ -898,6 +906,7 @@ def k8s(
             "deploy_timeout": deploy_timeout,
             "health_check": health_check,
             "platform": platform,
+            "pypi_mirror": pypi_mirror,
         }
         merged_config = _merge_config(config_dict, cli_params)
 
@@ -918,6 +927,7 @@ def k8s(
         deploy_timeout = merged_config.get("deploy_timeout", 300)
         health_check = merged_config.get("health_check", True)
         platform = merged_config.get("platform")
+        pypi_mirror = merged_config.get("pypi_mirror")
 
         # Handle requirements (can be comma-separated string, list, or file
         # path)
@@ -1033,6 +1043,8 @@ def k8s(
             deploy_params["health_check"] = health_check
         if platform:
             deploy_params["platform"] = platform
+        if pypi_mirror:
+            deploy_params["pypi_mirror"] = pypi_mirror
 
         # Add agent_source for state saving
         deploy_params["agent_source"] = abs_source

{agentscope_runtime-1.0.2 → agentscope_runtime-1.0.3}/src/agentscope_runtime/common/collections/redis_mapping.py

@@ -38,7 +38,10 @@ class RedisMapping(Mapping):
                 match=search_pattern,
             )
             for key in keys:
-                decoded_key = key.decode("utf-8")
+                if isinstance(key, bytes):
+                    decoded_key = key.decode("utf-8")
+                else:
+                    decoded_key = str(key)
                 yield self._strip_prefix(decoded_key)
 
             if cursor == 0:

{agentscope_runtime-1.0.2 → agentscope_runtime-1.0.3}/src/agentscope_runtime/engine/app/agent_app.py

@@ -12,7 +12,11 @@ from pydantic import BaseModel
 
 from .base_app import BaseApp
 from ..deployers import DeployManager
-from ..deployers.adapter.a2a import A2AFastAPIDefaultAdapter
+from ..deployers.adapter.a2a import (
+    A2AFastAPIDefaultAdapter,
+    AgentCardWithRuntimeConfig,
+    extract_a2a_config,
+)
 from ..deployers.adapter.responses.response_api_protocol_adapter import (
     ResponseAPIDefaultAdapter,
 )
@@ -47,14 +51,49 @@ class AgentApp(BaseApp):
         backend_url: Optional[str] = None,
         runner: Optional[Runner] = None,
         enable_embedded_worker: bool = False,
+        a2a_config: Optional["AgentCardWithRuntimeConfig"] = None,
         **kwargs,
     ):
         """
         Initialize the AgentApp.
 
         Args:
-            *args: Variable length argument list.
-            **kwargs: Arbitrary keyword arguments.
+            app_name: Name of the agent application
+            app_description: Description of the agent application
+            endpoint_path: API endpoint path for processing requests
+            response_type: Type of response (default: "sse")
+            stream: Whether to enable streaming responses
+            request_model: Request model class
+            before_start: Callback function to execute before starting
+            after_finish: Callback function to execute after finishing
+            broker_url: URL for message broker
+            backend_url: URL for backend service
+            runner: Optional runner instance
+            enable_embedded_worker: Whether to enable embedded worker
+            a2a_config: Optional A2A runtime configuration.
+                Must be an ``AgentCardWithRuntimeConfig`` instance, which
+                contains ``agent_card`` (AgentCard object or dict) and runtime
+                settings (host, port, registry, task_timeout, etc.).
+                Example:
+                    from a2a.types import AgentCard, AgentCapabilities
+                    from agentscope_runtime.engine.deployers.adapter.a2a import (  # noqa: E501
+                        AgentCardWithRuntimeConfig,
+                    )
+                    config = AgentCardWithRuntimeConfig(
+                        agent_card={
+                            "name": "MyAgent",
+                            "version": "1.0.0",
+                            "description": "My agent",
+                            "url": "http://localhost:8080",
+                            "capabilities": AgentCapabilities(),
+                            "default_input_modes": ["text"],
+                            "default_output_modes": ["text"],
+                            "skills": [],
+                        },
+                        registry=[nacos_registry],
+                        task_timeout=120,
+                    )
+            **kwargs: Additional keyword arguments passed to FastAPI app
         """
 
         self.endpoint_path = endpoint_path
@@ -76,9 +115,13 @@ class AgentApp(BaseApp):
         self._shutdown_handler: Optional[Callable] = None
         self._framework_type: Optional[str] = None
 
+        # Prepare A2A protocol adapter configuration
+        a2a_config = extract_a2a_config(a2a_config=a2a_config)
+
         a2a_protocol = A2AFastAPIDefaultAdapter(
             agent_name=app_name,
             agent_description=app_description,
+            a2a_config=a2a_config,
         )
 
         response_protocol = ResponseAPIDefaultAdapter()
@@ -96,8 +139,8 @@ class AgentApp(BaseApp):
             backend_url=backend_url,
         )
 
-        # Store custom endpoints and tasks for deployment
-        # but don't add them to FastAPI here - let FastAPIAppFactory handle it
+        # Store custom endpoints for deployment
+        # FastAPIAppFactory will handle adding them to FastAPI
 
     def init(self, func):
         """Register init hook (support async and sync functions)."""

agentscope_runtime-1.0.3/src/agentscope_runtime/engine/deployers/adapter/a2a/__init__.py

@@ -0,0 +1,57 @@
+# -*- coding: utf-8 -*-
+from .a2a_protocol_adapter import (
+    A2AFastAPIDefaultAdapter,
+    AgentCardWithRuntimeConfig,
+    extract_a2a_config,
+)
+from .a2a_registry import (
+    A2ARegistry,
+    A2ARegistrySettings,
+    get_registry_settings,
+    create_registry_from_env,
+)
+
+# NOTE: NacosRegistry is NOT imported at module import time to avoid forcing
+# an optional dependency on environments that don't have nacos SDK installed.
+# Instead, NacosRegistry is imported lazily via __getattr__ (see below) when
+# actually needed (e.g., when user does: from ... import NacosRegistry).
+
+__all__ = [
+    "A2AFastAPIDefaultAdapter",
+    "AgentCardWithRuntimeConfig",
+    "extract_a2a_config",
+    "A2ARegistry",
+    "A2ARegistrySettings",
+    "get_registry_settings",
+    "create_registry_from_env",
+    "NacosRegistry",  # pylint: disable=undefined-all-variable
+]
+
+
+def __getattr__(name: str):
+    """
+    Lazy import for NacosRegistry to avoid forcing optional nacos dependency.
+
+    This function is called by Python when an attribute is accessed
+    that doesn't exist at module level. This allows NacosRegistry
+    to be imported only when actually needed, rather than at module
+    import time.
+
+    If the nacos SDK is not installed, provides a helpful error message
+    instead of a confusing ImportError.
+    """
+    if name == "NacosRegistry":
+        try:
+            from .nacos_a2a_registry import NacosRegistry
+
+            return NacosRegistry
+        except ImportError as e:
+            # Check if it's the v2.nacos dependency that's missing
+            if "v2.nacos" in str(e) or "nacos" in str(e).lower():
+                raise ImportError(
+                    "NacosRegistry requires the 'v2-nacos' package. "
+                    "Install it with: pip install v2-nacos",
+                ) from e
+            # Re-raise other import errors as-is
+            raise
+    raise AttributeError(f"module {__name__!r} has no attribute {name!r}")