feat(DATAGO-121014): Add cli command for adding proxy (#746)

* feat(DATAGO-121014): Add cli command for adding proxy

* minor changes

Author: TamimiGitHub

cli/commands/add_cmd/__init__.py

@@ -1,15 +1,17 @@
 import click
 from .agent_cmd import add_agent
 from .gateway_cmd import add_gateway
+from .proxy_cmd import add_proxy
 
 
 @click.group(name="add")
 def add():
     """
-    Creates templates for agents or gateways.
+    Creates templates for agents, gateways, or proxies.
     """
     pass
 
 
 add.add_command(add_agent, name="agent")
 add.add_command(add_gateway, name="gateway")
+add.add_command(add_proxy, name="proxy")

cli/commands/add_cmd/proxy_cmd.py

@@ -0,0 +1,100 @@
+import sys
+from pathlib import Path
+
+import click
+
+from ...utils import (
+    get_formatted_names,
+    load_template,
+)
+
+
+def _write_proxy_yaml(proxy_name_input: str, project_root: Path) -> tuple[bool, str, str]:
+    """
+    Writes the proxy YAML file based on proxy_template.yaml.
+    
+    Args:
+        proxy_name_input: Name provided by user
+        project_root: Project root directory
+        
+    Returns:
+        Tuple of (success, message, relative_file_path)
+    """
+    agents_config_dir = project_root / "configs" / "agents"
+    agents_config_dir.mkdir(parents=True, exist_ok=True)
+    
+    formatted_names = get_formatted_names(proxy_name_input)
+    proxy_name_pascal = formatted_names["PASCAL_CASE_NAME"]
+    file_name_snake = formatted_names["SNAKE_CASE_NAME"]
+    
+    proxy_config_file_path = agents_config_dir / f"{file_name_snake}_proxy.yaml"
+    
+    try:
+        # Load template
+        template_content = load_template("proxy_template.yaml")
+        
+        # Replace placeholder
+        modified_content = template_content.replace("__PROXY_NAME__", proxy_name_pascal)
+        
+        # Write file
+        with open(proxy_config_file_path, "w", encoding="utf-8") as f:
+            f.write(modified_content)
+        
+        relative_file_path = str(proxy_config_file_path.relative_to(project_root))
+        return (
+            True,
+            f"Proxy configuration created: {relative_file_path}",
+            relative_file_path,
+        )
+    except FileNotFoundError as e:
+        return (
+            False,
+            f"Error: Template file 'proxy_template.yaml' not found: {e}",
+            "",
+        )
+    except Exception as e:
+        import traceback
+        click.echo(
+            f"DEBUG: Error in _write_proxy_yaml: {e}\n{traceback.format_exc()}",
+            err=True,
+        )
+        return (
+            False,
+            f"Error creating proxy configuration file {proxy_config_file_path}: {e}",
+            "",
+        )
+
+
+@click.command(name="proxy")
+@click.argument("name", required=False)
+@click.option(
+    "--skip",
+    is_flag=True,
+    help="Skip interactive prompts (creates proxy with default template).",
+)
+def add_proxy(name: str, skip: bool = False):
+    """
+    Creates a new A2A proxy configuration.
+
+    NAME: Name of the proxy component to create (e.g., my-proxy).
+    """
+    if not name:
+        click.echo(
+            click.style(
+                "Error: You must provide a proxy name.",
+                fg="red",
+            ),
+            err=True,
+        )
+        return
+    
+    click.echo(f"Creating proxy configuration for '{name}'...")
+    
+    project_root = Path.cwd()
+    success, message, _ = _write_proxy_yaml(name, project_root)
+    
+    if success:
+        click.echo(click.style(message, fg="green"))
+    else:
+        click.echo(click.style(message, fg="red"), err=True)
+        sys.exit(1)

config_portal/backend/common.py

@@ -73,6 +73,16 @@
     ),
 }
 
+PROXY_DEFAULTS = {
+    "namespace": "${NAMESPACE}",
+    "artifact_service_type": "filesystem",
+    "artifact_service_base_path": "/tmp/samv2",
+    "artifact_service_scope": "namespace",
+    "artifact_handling_mode": "reference",
+    "discovery_interval_seconds": 5,
+    "proxied_agents": [],
+}
+
 
 port_55555 = "-p 55554:55555" if sys.platform == "darwin" else "-p 55555:55555"
 

docs/docs/documentation/components/cli.md

@@ -89,10 +89,10 @@ Use the `--skip` option and provide the necessary options to run the command in
 
 ### `add` - Create a New Component
 
-To add a new component, such as an agent or gateway, use the `add` command with the appropriate options.
+To add a new component, such as an agent, gateway, or proxy, use the `add` command with the appropriate options.
 
 ```sh
-sam add [agent|gateway] [OPTIONS] NAME
+sam add [agent|gateway|proxy] [OPTIONS] NAME
 ```
 
 #### Add `agent`
@@ -156,6 +156,29 @@ sam add gateway [OPTIONS] [NAME]
 
 For more information, see [Gateways](gateways.md).
 
+#### Add `proxy`
+
+Use `proxy` to add an A2A proxy component that bridges external HTTP-based agents to the Solace Agent Mesh.
+
+```sh
+sam add proxy [OPTIONS] [NAME]
+```
+
+The proxy command creates a configuration file in `configs/agents/` that you can customize to connect external agents to the mesh.
+
+##### Options:
+
+- `--skip` – Skip interactive prompts and create the proxy with default template.
+- `-h, --help` – Displays the help message and exits.
+
+##### Example:
+
+```sh
+sam add proxy myProxy --skip
+```
+
+This creates `configs/agents/my_proxy_proxy.yaml` with the default proxy configuration template.
+
 
 
 ### `run` - Run the Agent Mesh Application

templates/proxy_template.yaml

@@ -0,0 +1,62 @@
+# A2A Proxy Configuration File
+
+log:
+  stdout_log_level: INFO
+  log_file_level: DEBUG
+  log_file: a2a_proxy.log
+
+# Shared SAM config (includes broker connection details)
+!include shared_config.yaml
+
+apps:
+  - name: "__PROXY_NAME____app"
+    app_base_path: .
+    app_module: src.solace_agent_mesh.agent.proxies.a2a.app 
+    broker:
+      <<: *broker_connection
+
+    # --- App Level Config for the Proxy ---
+    app_config:
+      namespace: ${NAMESPACE}
+
+      # Configuration for the artifact service used by the proxy itself.
+      # When the proxy receives an artifact from a downstream agent, it will
+      # store it here before forwarding it on the Solace mesh.
+      artifact_service:
+        type: "filesystem"
+        base_path: "/tmp/samv2"
+        artifact_scope: namespace # Default scope, shares artifacts within the NAMESPACE
+
+      # How the proxy should handle artifacts it sends over Solace.
+      # 'reference': Sends an artifact:// URI.
+      # 'embed': Sends the full content base64 encoded.
+      artifact_handling_mode: "reference"
+
+      # Interval in seconds for the proxy to re-fetch agent cards from
+      # downstream agents. Set to 0 to disable periodic checks.
+      discovery_interval_seconds: 5
+      tools:
+        - group_name: artifact_management
+          tool_type: builtin-group
+
+      # --- List of Downstream Agents to Proxy ---
+      # A single proxy can manage multiple external agents.
+      # Each agent can have its own URL, authentication, and timeout settings.
+      proxied_agents:
+        # Example 1: A simple agent without authentication
+        - name: "HelloWorld" # The name this agent will have on the Solace mesh
+          url: "http://localhost:9999" # The real HTTP endpoint of the agent
+        
+        # Example 2: Another agent without authentication
+        - name: "AnalysisAgent"
+          url: "http://127.0.0.1:10001"
+        
+        # You can add more agents here with different configurations:
+        # - name: "SecureAgent"
+        #   url: "https://api.example.com/agent"
+        #   authentication:
+        #     type: "static_bearer"
+        #     token: "${SECURE_AGENT_TOKEN}"
+        #   request_timeout_seconds: 180
+        #   # use_agent_card_url: false  # If true (default), uses URL from agent card for tasks.
+        #                                # If false, uses configured URL directly for all calls.