supervaizer 0.9.8__py3-none-any.whl → 0.10.1__py3-none-any.whl

supervaizer/routes.py

@@ -6,6 +6,7 @@
 
 import traceback
 from functools import wraps
+from pathlib import Path
 from typing import (
     TYPE_CHECKING,
     Any,
@@ -26,11 +27,12 @@ from fastapi import (
     Depends,
     HTTPException,
     Query,
+    Request,
     Security,
     status as http_status,
 )
-from fastapi.responses import JSONResponse
-from rich import inspect
+from fastapi.responses import FileResponse, HTMLResponse, JSONResponse, Response
+from fastapi.templating import Jinja2Templates
 
 from supervaizer.agent import (
     Agent,
@@ -51,8 +53,6 @@ if TYPE_CHECKING:
 
 T = TypeVar("T")
 
-insp = inspect
-
 
 class CaseUpdateRequest(SvBaseModel):
     """Request model for updating a case with answer to a question."""
@@ -259,10 +259,13 @@ def create_default_routes(server: "Server") -> APIRouter:
         )
 
         # Update the case with the answer
-        case.update(update)
+        # case.update(update) - Redundant, receive_human_input calls update()
 
         # Transition the case from AWAITING to IN_PROGRESS
-        case.receive_human_input()
+        case.receive_human_input(update)
+
+        # TODO CALL CUSTOM HOOKS HERE - AS DEFINED IN THE AGENT CONFIGURATION
+        # TODO REDEFINE AGENT TO ADD CUSTOM HOOKS HERE
 
         log.info(
             f"[Case update] Job {job_id}, Case {case_id} - Answer processed successfully"
@@ -383,6 +386,54 @@ def create_agent_route(server: "Server", agent: Agent) -> APIRouter:
             **agent.registration_info,
         )
 
+    @router.get(
+        f"/{agent.instructions_path}",
+        summary=f"Get supervaize instructions page for agent {agent.name}",
+        description="HTML page displaying agent registration information and instructions",
+        response_class=HTMLResponse,
+        tags=tags,
+    )
+    @handle_route_errors()
+    async def supervaize_instructions(
+        request: Request, agent: Agent = Depends(get_agent)
+    ) -> Response:
+        """Serve the supervaize instructions HTML page for this agent."""
+        log.info(
+            f"📥  GET /{agent.instructions_path} [Supervaize Instructions] for agent{agent.name}"
+        )
+
+        registration_info = agent.registration_info
+
+        # Convert instructions_path string to Path object
+        instructions_path = Path(agent.instructions_path)
+
+        # Check if file exists - if not, return empty HTML
+        if not instructions_path.exists() or not instructions_path.is_file():
+            return HTMLResponse(content="", status_code=200)
+
+        # Serve the file (check if it's a Jinja2 template or static HTML)
+        with open(instructions_path, "r", encoding="utf-8") as f:
+            content = f.read()
+            # Simple check: if it contains Jinja2 syntax, render as template
+            if "{{" in content or "{%" in content:
+                # Render as Jinja2 template
+                custom_templates = Jinja2Templates(
+                    directory=str(instructions_path.parent)
+                )
+                return custom_templates.TemplateResponse(
+                    instructions_path.name,
+                    {
+                        "request": request,
+                        "registration_info": registration_info,
+                    },
+                )
+            else:
+                # Serve as static HTML file
+                return FileResponse(
+                    str(instructions_path),
+                    media_type="text/html",
+                )
+
     @router.post(
         "/validate-agent-parameters",
         summary=f"Validate agent parameters for agent: {agent.name}",
@@ -406,30 +457,62 @@ def create_agent_route(server: "Server", agent: Agent) -> APIRouter:
         )
 
         if not agent.parameters_setup:
-            return {
+            result = {
                 "valid": True,
                 "message": "Agent has no parameter setup defined",
                 "errors": [],
                 "invalid_parameters": {},
             }
+            log.info(f"📤 Agent {agent.name}: No parameter setup defined → {result}")
+            return result
+
+        if body_params is None:
+            body_params = {}
 
         encrypted_agent_parameters = body_params.get("encrypted_agent_parameters")
 
-        # Decrypt agent parameters if provided
         agent_parameters: Dict[str, Any] = {}
         if encrypted_agent_parameters:
+            # Basic debug trace
+            log.info(
+                f"📥 Received encrypted_agent_parameters, length: {len(encrypted_agent_parameters)}"
+            )
+
             try:
-                from supervaizer.common import decrypt_value
                 import json
 
+                from supervaizer.common import decrypt_value
+
                 agent_parameters_str = decrypt_value(
                     encrypted_agent_parameters, server.private_key
                 )
                 agent_parameters = (
                     json.loads(agent_parameters_str) if agent_parameters_str else {}
                 )
+
+                # Debug: Log the parsed data type and structure
+                log.info(f"🔍 Parsed agent_parameters type: {type(agent_parameters)}")
+                if isinstance(agent_parameters, list):
+                    log.info(
+                        f"🔍 Converting list to dict with {len(agent_parameters)} items"
+                    )
+                    # Convert list to dict if needed (common when frontend sends array)
+                    agent_parameters = {
+                        f"param_{i}": param for i, param in enumerate(agent_parameters)
+                    }
+                elif isinstance(agent_parameters, dict):
+                    log.info(
+                        f"🔍 Agent parameters keys: {list(agent_parameters.keys())}"
+                    )
+                else:
+                    log.warning(
+                        f"🔍 Unexpected type: {type(agent_parameters)}, converting to empty dict"
+                    )
+                    agent_parameters = {}
+
             except Exception as e:
-                return {
+                log.error(f"❌ Decryption failed: {type(e).__name__}: {str(e)}")
+                result = {
                     "valid": False,
                     "message": f"Failed to decrypt agent parameters: {str(e)}",
                     "errors": [f"Decryption failed: {str(e)}"],
@@ -437,11 +520,18 @@ def create_agent_route(server: "Server", agent: Agent) -> APIRouter:
                         "encrypted_agent_parameters": f"Decryption failed: {str(e)}"
                     },
                 }
+                log.info(f"📤 Agent {agent.name}: Decryption failed → {result}")
+                return result
+
+        # Log the incoming request details
+        log.info(
+            f"🔍 Agent {agent.name}: Incoming request - encrypted_params: {bool(encrypted_agent_parameters)}, parsed_params: {agent_parameters}"
+        )
 
         # Validate agent parameters
         validation_result = agent.parameters_setup.validate_parameters(agent_parameters)
 
-        return {
+        result = {
             "valid": validation_result["valid"],
             "message": "Agent parameters validated successfully"
             if validation_result["valid"]
@@ -450,6 +540,9 @@ def create_agent_route(server: "Server", agent: Agent) -> APIRouter:
             "invalid_parameters": validation_result["invalid_parameters"],
         }
 
+        log.info(f"📤 Agent {agent.name}: Validation result → {result}")
+        return result
+
     @router.post(
         "/validate-method-fields",
         summary=f"Validate method fields for agent: {agent.name}",
@@ -472,40 +565,59 @@ def create_agent_route(server: "Server", agent: Agent) -> APIRouter:
             f"📥 POST /validate-method-fields [Validate method fields] {agent.name}"
         )
 
+        if body_params is None:
+            body_params = {}
+
         method_name = body_params.get("method_name", "job_start")
         job_fields = body_params.get("job_fields", {})
 
+        # Log the incoming request details
+        log.info(
+            f"🔍 Agent {agent.name}: Incoming request - method: {method_name}, fields: {job_fields}"
+        )
+
         # Get the method to validate against
         if not agent.methods:
-            return {
+            result = {
                 "valid": False,
                 "message": "Agent has no methods defined",
                 "errors": ["Agent has no methods defined"],
                 "invalid_fields": {},
             }
+            log.info(f"📤 Agent {agent.name}: No methods defined → {result}")
+            return result
 
         if method_name == "job_start":
             method = agent.methods.job_start
         elif agent.methods.custom and method_name in agent.methods.custom:
             method = agent.methods.custom[method_name]
         else:
-            return {
+            result = {
                 "valid": False,
                 "message": f"Method '{method_name}' not found",
                 "errors": [f"Method '{method_name}' not found"],
                 "invalid_fields": {},
             }
+            log.info(
+                f"📤 Agent {agent.name}: Method '{method_name}' not found → {result}"
+            )
+            return result
 
         # Validate method fields
         validation_result = method.validate_method_fields(job_fields)
 
-        return {
+        result = {
             "valid": validation_result["valid"],
             "message": validation_result["message"],
             "errors": validation_result["errors"],
             "invalid_fields": validation_result["invalid_fields"],
         }
 
+        log.info(
+            f"📤 Agent {agent.name}: Method '{method_name}' validation result → {result}"
+        )
+        return result
+
     if not agent.methods:
         raise ValueError(f"Agent {agent.name} has no methods defined")
 
@@ -540,8 +652,15 @@ def create_agent_route(server: "Server", agent: Agent) -> APIRouter:
         """Start a new job for this agent"""
         log.info(f"📥 POST /jobs [Start job] {agent.name} with params {body_params}")
 
-        sv_context: JobContext = JobContext(**body_params["job_context"])
-        job_fields = body_params["job_fields"]
+        if body_params is None:
+            body_params = {}
+
+        job_context_data = body_params.get("job_context")
+        if job_context_data is None:
+            raise ValueError("job_context is required")
+
+        sv_context: JobContext = JobContext(**job_context_data)
+        job_fields = body_params.get("job_fields", {})
 
         # Get job encrypted parameters if available
         encrypted_agent_parameters = body_params.get("encrypted_agent_parameters")
@@ -649,7 +768,9 @@ def create_agent_route(server: "Server", agent: Agent) -> APIRouter:
         agent: Agent = Depends(get_agent),
     ) -> AgentResponse:
         log.info(f"📥  POST /stop [Stop agent] {agent.name} with params {params}")
-        result = agent.job_stop(params.get("job_context", {}))
+        # Pass job_context as 'context' parameter to match agent method expectations
+        job_context = params.get("job_context", {})
+        result = agent.job_stop({"context": job_context})
         res_info = result.registration_info if result else {}
         return AgentResponse(
             name=agent.name,
@@ -763,6 +884,9 @@ def create_agent_custom_routes(server: "Server", agent: Agent) -> APIRouter:
             )
             log.info(f"body_params: {body_params}")
 
+            if body_params is None:
+                raise ValueError("body_params cannot be None")
+
             sv_context: JobContext = body_params.job_context
             job_fields = body_params.job_fields.to_dict()
 

supervaizer/server.py

@@ -38,7 +38,6 @@ from supervaizer.common import (
 )
 from supervaizer.instructions import display_instructions
 from supervaizer.protocol.a2a import create_routes as create_a2a_routes
-from supervaizer.protocol.acp import create_routes as create_acp_routes
 from supervaizer.routes import (
     create_agents_routes,
     create_default_routes,
@@ -82,6 +81,9 @@ def save_server_info_to_storage(server_instance: "Server") -> None:
                         "name": agent.name,
                         "description": agent.description,
                         "version": agent.version,
+                        "api_path": agent.path,
+                        "slug": agent.slug,
+                        "instructions_path": agent.instructions_path,
                     }
                 )
 
@@ -166,9 +168,6 @@ class ServerAbstract(SvBaseModel):
     a2a_endpoints: bool = Field(
         default=True, description="Whether to enable A2A endpoints"
     )
-    acp_endpoints: bool = Field(
-        default=True, description="Whether to enable ACP endpoints"
-    )
     private_key: RSAPrivateKey = Field(
         description="RSA private key for secret parameters encryption - Used in server-to-agent communication - Not needed by user"
     )
@@ -206,7 +205,6 @@ class ServerAbstract(SvBaseModel):
                     "debug": False,
                     "reload": False,
                     "a2a_endpoints": True,
-                    "acp_endpoints": True,
                 },
             ]
         },
@@ -237,7 +235,6 @@ class Server(ServerAbstract):
         agents: List[Agent],
         supervisor_account: Optional[Account] = None,
         a2a_endpoints: bool = True,
-        acp_endpoints: bool = True,
         admin_interface: bool = True,
         scheme: str = "http",
         environment: str = os.getenv("SUPERVAIZER_ENVIRONMENT", "dev"),
@@ -259,7 +256,6 @@ class Server(ServerAbstract):
             agents: List of agents to register with the server
             supervisor_account: Account of the supervisor
             a2a_endpoints: Whether to enable A2A endpoints
-            acp_endpoints: Whether to enable ACP endpoints
             admin_interface: Whether to enable admin interface
             scheme: URL scheme (http or https)
             environment: Environment name (e.g., dev, staging, prod)
@@ -350,7 +346,6 @@ class Server(ServerAbstract):
             reload=reload,
             supervisor_account=supervisor_account,
             a2a_endpoints=a2a_endpoints,
-            acp_endpoints=acp_endpoints,
             private_key=private_key,
             public_key=public_key,
             public_url=public_url,
@@ -371,9 +366,6 @@ class Server(ServerAbstract):
         if self.a2a_endpoints:
             log.info("[Server launch] 📢 Deploy A2A routes  ")
             self.app.include_router(create_a2a_routes(self))
-        if self.acp_endpoints:
-            log.info("[Server launch] 📢 Deploy ACP routes")
-            self.app.include_router(create_acp_routes(self))
 
         # Deploy admin routes if API key is available
         if self.api_key and admin_interface:
@@ -519,6 +511,8 @@ class Server(ServerAbstract):
             server_registration_result: ApiResult = (
                 self.supervisor_account.register_server(server=self)
             )
+            # log.debug(f"[Server launch] Server registration result: {server_registration_result}")
+            # inspect(server_registration_result)
             assert isinstance(
                 server_registration_result, ApiSuccess
             )  # If ApiError, exception should have been raised before

supervaizer/utils/__init__.py

@@ -0,0 +1,16 @@
+# Copyright (c) 2024-2025 Alain Prasquier - Supervaize.com. All rights reserved.
+#
+# This Source Code Form is subject to the terms of the Mozilla Public License, v. 2.0.
+# If a copy of the MPL was not distributed with this file, you can obtain one at
+# https://mozilla.org/MPL/2.0/.
+
+
+from supervaizer.utils.version_check import (
+    check_is_latest_version,
+    get_latest_version,
+)
+
+__all__ = [
+    "check_is_latest_version",
+    "get_latest_version",
+]

supervaizer/utils/version_check.py

@@ -0,0 +1,56 @@
+# Copyright (c) 2024-2025 Alain Prasquier - Supervaize.com. All rights reserved.
+#
+# This Source Code Form is subject to the terms of the Mozilla Public License, v. 2.0.
+# If a copy of the MPL was not distributed with this file, you can obtain one at
+# https://mozilla.org/MPL/2.0/.
+
+
+import httpx
+
+try:
+    from packaging import version
+except ImportError:
+    version = None
+
+from supervaizer import __version__
+
+
+async def get_latest_version() -> str | None:
+    """
+    Retrieve the latest version number of supervaizer from PyPI.
+
+    Returns:
+        The latest version string (e.g., "0.9.8") if successful, None otherwise.
+    """
+    try:
+        async with httpx.AsyncClient(timeout=10.0) as client:
+            response = await client.get("https://pypi.org/pypi/supervaizer/json")
+            response.raise_for_status()
+            data = response.json()
+            return data.get("info", {}).get("version")
+    except Exception:
+        return None
+
+
+async def check_is_latest_version() -> tuple[bool, str | None]:
+    """
+    Check if the currently running supervaizer version is the latest available on PyPI.
+
+    Returns:
+        A tuple of (is_latest: bool, latest_version: str | None).
+        - is_latest: True if current version is latest or if check failed
+        - latest_version: The latest version string if available, None otherwise
+    """
+    current_version = __version__.VERSION
+    latest_version = await get_latest_version()
+
+    if latest_version is None:
+        return True, None
+
+    # Compare versions using packaging.version for proper semantic version comparison
+    if version is not None:
+        is_latest = version.parse(current_version) >= version.parse(latest_version)
+    else:
+        # Fallback to simple string comparison if packaging is not available
+        is_latest = current_version >= latest_version
+    return is_latest, latest_version

{supervaizer-0.9.8.dist-info → supervaizer-0.10.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: supervaizer
-Version: 0.9.8
+Version: 0.10.1
 Summary: Controller system for Supervaize
 Project-URL: Homepage, https://supervaize.com
 Project-URL: Repository, https://github.com/supervaize/supervaizer
@@ -16,52 +16,59 @@ Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.12
 Requires-Python: >=3.12
 Requires-Dist: art>=6.5
-Requires-Dist: cryptography>=45.0.6
+Requires-Dist: cryptography>=46.0.2
 Requires-Dist: demjson3>=3.0.6
 Requires-Dist: deprecated>=1.2.18
-Requires-Dist: fastapi>=0.116.1
+Requires-Dist: fastapi>=0.118.0
 Requires-Dist: httpx>=0.28.1
 Requires-Dist: jinja2>=3.1.6
 Requires-Dist: loguru>=0.7.3
-Requires-Dist: orjson>=3.11.1
-Requires-Dist: psutil>=6.1.0
-Requires-Dist: pydantic>=2.11.7
-Requires-Dist: pymongo>=4.14.0
+Requires-Dist: orjson>=3.11.3
+Requires-Dist: packaging>=24.0
+Requires-Dist: psutil>=7.1.0
+Requires-Dist: pydantic>=2.12.0
 Requires-Dist: python-slugify>=8.0.4
+Requires-Dist: pyyaml>=6.0.3
 Requires-Dist: rich>=14.1.0
 Requires-Dist: shortuuid>=1.0.13
 Requires-Dist: sse-starlette>=3.0.2
 Requires-Dist: tinydb>=4.8.1
-Requires-Dist: typer>=0.16
-Requires-Dist: uvicorn>=0.35.0
+Requires-Dist: typer>=0.19.2
+Requires-Dist: uvicorn>=0.36.0
+Provides-Extra: deploy
+Requires-Dist: boto3>=1.34.0; extra == 'deploy'
+Requires-Dist: docker>=7.0.0; extra == 'deploy'
+Requires-Dist: google-cloud-artifact-registry>=1.8.0; extra == 'deploy'
+Requires-Dist: google-cloud-run>=0.10.0; extra == 'deploy'
+Requires-Dist: google-cloud-secret-manager>=2.18.0; extra == 'deploy'
 Provides-Extra: dev
-Requires-Dist: hatch>=1.14.0; extra == 'dev'
-Requires-Dist: jsonschema>=4.25.0; extra == 'dev'
-Requires-Dist: mypy>=1.17.1; extra == 'dev'
+Requires-Dist: hatch>=1.14.2; extra == 'dev'
+Requires-Dist: jsonschema>=4.25.1; extra == 'dev'
+Requires-Dist: mypy>=1.18.2; extra == 'dev'
 Requires-Dist: pre-commit>=3.7.0; extra == 'dev'
-Requires-Dist: pytest-asyncio>=1.1.0; extra == 'dev'
-Requires-Dist: pytest-cov>=6.2.1; extra == 'dev'
-Requires-Dist: pytest-mock>=3.14.1; extra == 'dev'
-Requires-Dist: pytest-sugar>=1.0.0; extra == 'dev'
-Requires-Dist: pytest>=8.4.1; extra == 'dev'
+Requires-Dist: pytest-asyncio>=1.2.0; extra == 'dev'
+Requires-Dist: pytest-cov>=7.0.0; extra == 'dev'
+Requires-Dist: pytest-mock>=3.15.1; extra == 'dev'
+Requires-Dist: pytest-sugar>=1.1.1; extra == 'dev'
+Requires-Dist: pytest>=8.4.2; extra == 'dev'
 Requires-Dist: respx>=0.22.0; extra == 'dev'
-Requires-Dist: ruff>=0.12.8; extra == 'dev'
+Requires-Dist: ruff>=0.13.3; extra == 'dev'
 Requires-Dist: types-deprecated>=1.2.15.20250304; extra == 'dev'
 Requires-Dist: types-python-slugify>=8.0.2.20240310; extra == 'dev'
 Description-Content-Type: text/markdown
 
 # SUPERVAIZER
 
-[[Operate AI Agents with confidence]]
+[Operate AI Agents with confidence]
 
-A Python toolkit for building, managing, and connecting AI agents with full [Agent-to-Agent (A2A)](https://google.github.io/A2A/#/) and [Agent Communication Protocol (ACP)](https://github.com/i-am-bee/ACP) support.
+A Python toolkit for building, managing, and connecting AI agents with full [Agent-to-Agent (A2A)](https://a2a-protocol.org/) protocol support.
 
 [![Python Version](https://img.shields.io/badge/python-3.10%20%7C%203.11%20%7C%203.12-blue.svg)](https://www.python.org/downloads/)
-[![Package Version](https://img.shields.io/badge/Supervaizer-0.9.6-yellow.svg)](https://github.com/supervaize/supervaizer)
-[![A2A Protocol](https://img.shields.io/badge/A2A-Protocol-orange.svg)](https://google.github.io/A2A/)
-[![ACP Protocol](https://img.shields.io/badge/ACP-Protocol-purple.svg)](https://github.com/i-am-bee/ACP)
+[![A2A Protocol](https://img.shields.io/badge/A2A-Protocol-orange.svg)](https://a2a-protocol.org/)
 [![Test Coverage](https://img.shields.io/badge/Coverage-81%25-brightgreen.svg)](https://github.com/supervaize/supervaizer)
 
+> **⚠️ Beta Disclaimer**: SUPERVAIZER is currently in beta mode. Not everything works as expected yet. Please report any issues you encounter.
+
 - [SUPERVAIZER](#supervaizer)
   - [Description](#description)
   - [Quick Start](#quick-start)
@@ -70,35 +77,45 @@ A Python toolkit for building, managing, and connecting AI agents with full [Age
     - [3. Scaffold the controller](#3-scaffold-the-controller)
     - [(Optional) 4. Configure your Supervaize account \& environment](#optional-4-configure-your-supervaize-account--environment)
     - [5. Start the server 🚀](#5-start-the-server-)
+    - [6. Optional parameters](#6-optional-parameters)
     - [What's next?](#whats-next)
   - [Features](#features)
   - [Protocol Support](#protocol-support)
+  - [Cloud Deployment](#cloud-deployment)
+    - [Quick Start](#quick-start-1)
+    - [Deployment Commands](#deployment-commands)
+    - [Features](#features-1)
+    - [Documentation](#documentation)
   - [Using the CLI](#using-the-cli)
   - [API Documentation \& User Interfaces](#api-documentation--user-interfaces)
     - [Admin Interface (`/admin`)](#admin-interface-admin)
-      - [Quick Start](#quick-start-1)
+      - [Quick Start](#quick-start-2)
 - [Calculating costs](#calculating-costs)
-  - [Documentation](#documentation)
+  - [Documentation](#documentation-1)
   - [Contributing](#contributing)
   - [License](#license)
 
 ## Description
 
-SUPERVAIZER is a toolkit built for the age of AI interoperability. At its core, it implements Google's Agent-to-Agent (A2A) protocol and IBM's Agent Communication Protocol (ACP), enabling seamless discovery and interaction between agents across different systems and platforms.
+SUPERVAIZER is a toolkit built for the age of AI interoperability. At its core, it implements the Agent-to-Agent (A2A) protocol, enabling seamless discovery and interaction between agents across different systems and platforms.
 
-With comprehensive support for the A2A/ACP protocols, specification, SUPERVAIZER allows you to:
+With comprehensive support for the A2A protocol specification, SUPERVAIZER allows you to:
 
-- Enhance the capabilities of your agents, making them automatically discoverable by other A2A/ACP compatible systems
+- Enhance the capabilities of your agents, making them automatically discoverable by other A2A compatible systems
 - Expose standardized agent capabilities through agent cards
 - Monitor agent health and status through dedicated endpoints
 - Connect your agents to the growing ecosystem of A2A-compatible tools
 
 Beyond A2A interoperability, SUPERVAIZER provides a robust API for agent registration, job control, event handling, telemetry, and more, making it a crucial component for building and managing AI agent systems.
 
+SUPERVAIZER is the recommended controller to integrate AI Agents into the [supervaize](https://supervaize.com) plateform.
+
 ## Quick Start
 
 Kickstart a **Python** agent with the **Supervaizer Controller** so it's discoverable and operable by Supervaize.
 
+See full our full [documentation](https://doc.supervaize.com/docs/category/supervaizer-controller)
+
 ### What we'll do
 
 1. **Install Supervaizer** in that project
@@ -159,28 +176,82 @@ Once the server is running, you'll have:
 - **A2A discovery**: `/.well-known/agents.json`
 - **ACP discovery**: `/agents`
 
+### 6. Optional parameters
+
+Configure retry behavior for HTTP requests to the Supervaize API:
+
+- **`SUPERVAIZE_HTTP_MAX_RETRIES`**: Number of retry attempts for failed HTTP requests (default: `2`). The client will automatically retry requests that fail with status codes 429, 500, 502, 503, or 504.
+
+```bash
+export SUPERVAIZE_MAX_HTTP_RETRIES=3  # Will attempt up to 4 times total (1 original + 3 retries)
+```
+
 ### What's next?
 
 - Add more **custom methods** (`chat`, `custom`) to extend control
-- Turn on **A2A / ACP** discovery for interoperability
+- Turn on **A2A** discovery for interoperability
 - Hook your controller into Supervaize to **monitor, audit, and operate** the agent
 
-For detailed instructions on customizing your controller, see the [Controller Setup Guide](https://doc.supervaize.com/docs/supervaizer-controller/controller-setup-guide).
+For detailed instructions on customizing your controller, see the [Controller Setup Guide](https://doc.supervaize.com/docs/supervaizer-controller/controller-setup)
 
 ## Features
 
 - **Agent Management**: Register, update, and control agents
 - **Job Control**: Create, track, and manage jobs
 - **Event Handling**: Process and respond to system events
-- Protocol support
-  - **A2A Protocol **: Integration with Google's Agent-to-Agent protocol for interoperability
-  - **ACP Protocol **: Integration with IBM/BeeAI's Agent Communication Protocol for standardized agent discovery and interaction
+- **🚀 Cloud Deployment**: Automated deployment to GCP Cloud Run, AWS App Runner, and DigitalOcean App Platform
+- **A2A Protocol Support**: Full integration with the Agent-to-Agent protocol for standardized agent discovery and interaction
 - **Server Communication**: Interact with SUPERVAIZE servers (see [supervaize.com](https://www.supervaize.com) for more info)
 - **Web Admin Interface**: Easy to use web-based admin dashboard for managing jobs, cases, and system monitoring
 
 ## Protocol Support
 
-SUPERVAIZER provides comprehensive support for multiple agent communication protocols. See [Protocol Documentation](docs/PROTOCOLS.md) for complete details.
+SUPERVAIZER provides comprehensive support for the A2A agent communication protocol. See [Protocol Documentation](docs/PROTOCOLS.md) for complete details.
+
+## Cloud Deployment
+
+SUPERVAIZER includes a powerful deployment CLI that automates the entire process of deploying your agents to production cloud platforms.
+
+### Quick Start
+
+```bash
+# Install with deployment dependencies
+pip install supervaizer[deploy]
+
+# Test locally with Docker
+supervaizer deploy local --generate-api-key --generate-rsa
+
+# Deploy to Google Cloud Run
+supervaizer deploy up --platform cloud-run --region us-central1
+
+# Deploy to AWS App Runner
+supervaizer deploy up --platform aws-app-runner --region us-east-1
+
+# Deploy to DigitalOcean App Platform
+supervaizer deploy up --platform do-app-platform --region nyc
+```
+
+### Deployment Commands
+
+- **`supervaizer deploy plan`** - Preview deployment actions before applying
+- **`supervaizer deploy up`** - Deploy to cloud platform with automated build, push, and verification
+- **`supervaizer deploy down`** - Tear down deployment and clean up resources
+- **`supervaizer deploy status`** - Check deployment status and health
+- **`supervaizer deploy local`** - Local Docker testing with docker-compose
+- **`supervaizer deploy clean`** - Clean up deployment artifacts and state
+
+### Features
+
+- ✅ **Automated Docker Workflow**: Build → Push → Deploy → Verify
+- ✅ **Secret Management**: Secure handling of API keys and RSA keys
+- ✅ **Health Verification**: Automatic health checks at `/.well-known/health`
+- ✅ **Idempotent Deployments**: Safe create/update operations with rollback on failure
+- ✅ **Local Testing**: Full Docker Compose environment for pre-deployment testing
+
+### Documentation
+
+- [RFC-001: Cloud Deployment CLI](docs/rfc/001-cloud-deployment-cli.md) - Complete specification
+- [Local Testing Guide](docs/LOCAL_TESTING.md) - Docker testing documentation
 
 ## Using the CLI