solace-agent-mesh 0.0.1__py3-none-any.whl → 0.1.1__py3-none-any.whl

solace_agent_mesh/assets/web-visualizer/assets/index-D0qORgkg.css

@@ -0,0 +1 @@
+:root{--primary-color: #3498db;--secondary-color: #2c3e50;--background-color: #ecf0f1;--text-color: #34495e;--border-color: #bdc3c7;--hover-color: #e0f7fa;--selected-color: #b3e5fc;--header-height: 80px;--min-width: 1200px;--max-width: 1200px}*{box-sizing:border-box;margin:0;padding:0}body{font-family:Arial,sans-serif;background-color:var(--background-color);color:var(--text-color);display:flex;justify-content:center;min-height:100vh}.app-container{display:flex;flex-direction:column;width:100%;max-width:var(--max-width);height:100vh;background-color:#fff;color:#000;box-shadow:0 0 10px #0000001a;overflow:hidden}:root{--header-height: 60px;--page-header-height: 60px}.header{height:var(--header-height);background-color:var(--primary-color);padding:0 1rem;box-shadow:0 2px 4px #0000001a}.top-menu{display:flex;align-items:flex-end;height:100%;padding:1rem}.nav-links{display:flex;list-style-type:none;margin:0;padding:0}.nav-links li{margin-right:1rem}.nav-links a{color:#fff;text-decoration:none;font-weight:700;padding:.5rem 0;position:relative}.nav-links a.active{font-weight:bolder}.nav-links a.active:after{content:"";position:absolute;left:0;bottom:0;width:100%;height:2px;background-color:#fff}.connection-controls{margin-left:auto;display:flex;align-items:center}.connection-controls .button{margin-left:1rem;background-color:#fff;color:var(--primary-color);border:1px solid white}.connection-controls .button:hover{background-color:var(--hover-color);border-color:var(--hover-color)}.nav-links a:hover{color:var(--hover-color)}.page-header{height:var(--page-header-height);background-color:var(--background-color);padding:0 1rem;display:flex;align-items:center;justify-content:space-between;border-bottom:1px solid var(--border-color)}.page-header h2{margin:0}.content{padding:1rem}.stimuli-page,.capabilities-page{display:flex;flex-direction:column;height:calc(100vh - var(--header-height));overflow:hidden}.stimuli-content{flex:1;overflow:hidden;display:flex}.stimuli-content{display:flex;flex:1;overflow:hidden}.capability-item{background-color:#fff;border:1px solid var(--border-color);border-radius:4px;padding:1rem;margin-bottom:1rem}.capability-item h3{margin-top:0}.capability-item ul{padding-left:1.5rem}.app-title{color:#fff;margin:0;margin-right:4rem;font-size:1.5rem}.button{background-color:var(--secondary-color);color:#fff;border:none;padding:.5rem 1rem;border-radius:4px;cursor:pointer;transition:background-color .3s ease}.button:hover{background-color:#34495e}.button-info{background-color:var(--primary-color);border:1px solid var(--primary-color);color:#000}.button-info:hover{background-color:var(--selected-color)}.content{display:flex;flex:1;overflow:hidden}.stimulus-list{width:40%;min-width:400px;overflow-y:auto;border-right:1px solid var(--border-color);background-color:#fff}.stimulus-item{padding:1rem;border-bottom:1px solid var(--border-color);cursor:pointer;transition:background-color .2s ease}.stimulus-item:hover{background-color:var(--hover-color)}.stimulus-item.selected{background-color:var(--selected-color)}.stimulus-header{display:flex;justify-content:space-between;align-items:baseline;margin-bottom:.5rem}.user-email{font-weight:700;color:var(--secondary-color)}.timestamp{font-size:.8em;color:var(--text-color);opacity:.7}.stimulus-text{font-family:monospace;white-space:pre-wrap;word-break:break-word;font-size:.9em;margin:0}.stimulus-details{flex:1;padding:1rem;overflow-y:auto;background-color:#fff}.stimulus-details pre{white-space:pre-wrap;word-wrap:break-word;background-color:var(--background-color);padding:1rem;border-radius:4px;font-size:.9rem}.loading-overlay{position:fixed;top:0;left:0;right:0;bottom:0;background-color:#00000080;display:flex;justify-content:center;align-items:center;color:#fff;font-size:1.5rem;z-index:1000}.no-stimuli{padding:1rem;text-align:center;color:var(--text-color)}@media (max-width: 768px){.content{flex-direction:column}.stimulus-list{width:100%;max-height:40vh;border-right:none;border-bottom:1px solid var(--border-color)}}@media (max-width: 480px){.header{text-align:center}.button{width:100%}.stimulus-item{padding:.75rem}.user-email,.stimulus-text{font-size:.9rem}}.message-flow{display:flex;flex-direction:column;gap:1rem;padding:1rem;overflow-y:auto;width:60%}.message-box{border:1px solid var(--border-color);border-radius:4px;padding:1rem;background-color:#fff}.message-header{display:flex;justify-content:space-between;margin-bottom:.5rem;font-size:.9rem;color:var(--secondary-color)}.message-type{font-weight:700}.elapsed-time{font-style:italic}.message-content{font-size:.95rem;white-space:pre-wrap;word-break:break-word;position:relative;overflow:auto;padding-bottom:20px}.more-button{position:absolute;bottom:5px;right:5px;background-color:var(--primary-color);color:#fff;border:none;padding:2px 8px;border-radius:4px;cursor:pointer;font-size:.8rem;transition:background-color .3s ease}.more-button:hover{background-color:var(--secondary-color)}.file-list,.action-params{margin-top:1rem}.file-list h4,.action-params h4{margin-bottom:.5rem}.file-list ul,.action-params ul{list-style-type:none;padding-left:1rem}.stimulus{background-color:#e3f2fd}.response{background-color:#e8f5e9}.response.streaming{background-color:#fff9c4}.response.complete{background-color:#c8e6c9}.action-request{background-color:#fff3e0}.action-header{display:flex;align-items:center;gap:10px}.action-request-label{font-size:.9em;font-weight:700}.agent-name,.action-name{font-size:1.1em;padding:2px 8px;border-radius:12px;background-color:#e9ecef}.agent-name{color:#495057}.action-name{color:#0056b3}.action-params{margin-top:1rem}.action-params ul{list-style-type:none;padding-left:1rem}.action-response{margin-top:1rem;padding:1rem;background-color:#f8f9fa;border-radius:8px;border:1px solid #e9ecef}.file-list{margin-top:1rem}.file-list h4{margin-bottom:.5rem}.file-list ul{list-style-type:none;padding-left:1rem}.file-list li{margin-bottom:.25rem}.message-header{display:flex;justify-content:space-between;align-items:center;margin-bottom:.5rem;font-size:.9rem;color:var(--secondary-color);flex-wrap:wrap}.message-type{font-weight:700;margin-right:.5rem}.elapsed-time{font-style:italic;white-space:nowrap}.placeholder-message{padding:1rem;text-align:center;color:var(--text-color)}.orchestrator-reinvoke{background-color:#fff9c4}.llm-service-request{background-color:#e8eaf6}.llm-service-response{background-color:#e0f2f1}@media (max-width: 1200px){.app-container{min-width:100%}}@media (min-width: 1220px){.app-container{min-width:1200px}}.app-wrapper{display:flex;justify-content:center}.config-dialog,.connection-selector{position:absolute;top:50%;left:50%;transform:translate(-50%,-50%);z-index:10;width:min(400px,70%);background-color:#fff;color:#000;border-radius:10px;border:1px solid var(--border-color);box-shadow:0 0 10px #00000080;display:flex;flex-direction:column;padding:.5rem}.config-dialog-content,.connection-selector{padding:1rem;display:flex;flex-direction:column;gap:1rem}.connection-selector label{font-weight:700;margin-bottom:.5rem}.connection-selector select{width:100%;padding:.5rem;margin-bottom:1rem;border:1px solid var(--border-color);border-radius:4px;font-size:1rem;background-color:#fff;color:#000}.connection-selector .button-group{display:flex;justify-content:space-between;gap:.5rem;margin-bottom:.5rem}.connection-selector .button-group button{flex:1}.connection-selector .button-group.secondary{margin-top:1rem}.config-dialog-content label,.connection-selector label{display:block}.config-dialog-content input,.config-dialog-content select,.connection-selector button{width:100%;padding:.5rem;border:1px solid var(--border-color);border-radius:4px;font-size:1rem;background-color:#fff;color:#000;transition:border-color .3s,box-shadow .3s}.config-dialog-content select{appearance:none;-webkit-appearance:none;-moz-appearance:none;background-image:url(data:image/svg+xml;charset=US-ASCII,%3Csvg%20xmlns%3D%22http%3A%2F%2Fwww.w3.org%2F2000%2Fsvg%22%20width%3D%22292.4%22%20height%3D%22292.4%22%3E%3Cpath%20fill%3D%22%23007CB2%22%20d%3D%22M287%2069.4a17.6%2017.6%200%200%200-13-5.4H18.4c-5%200-9.3%201.8-12.9%205.4A17.6%2017.6%200%200%200%200%2082.2c0%205%201.8%209.3%205.4%2012.9l128%20127.9c3.6%203.6%207.8%205.4%2012.8%205.4s9.2-1.8%2012.8-5.4L287%2095c3.5-3.5%205.4-7.8%205.4-12.8%200-5-1.9-9.2-5.5-12.8z%22%2F%3E%3C%2Fsvg%3E);background-repeat:no-repeat;background-position:right .7rem top 50%;background-size:.65rem auto;padding-right:2rem}.config-dialog-content input:focus,.config-dialog-content select:focus,.connection-selector button:focus{outline:none;border-color:var(--primary-color);box-shadow:0 0 0 2px #3498db33}.config-dialog-content label,.connection-selector h2{display:block;margin-bottom:.5rem;font-weight:700;color:var(--secondary-color)}.config-dialog-buttons,.connection-selector{display:flex;justify-content:flex-end;gap:1rem;padding:1.2rem}.connection-selector button{background-color:var(--primary-color);color:#fff;border:none;cursor:pointer;transition:background-color .3s}.connection-selector button:hover{background-color:var(--secondary-color)}.capabilities-page{display:flex;flex-direction:column;height:calc(100vh - var(--header-height));overflow:hidden}.capabilities-content{display:flex;overflow:hidden;padding:1rem;gap:1rem;height:calc(100vh - var(--header-height) - var(--page-header-height))}.search-input{padding:.5rem;border:1px solid var(--border-color);border-radius:4px;width:300px;font-size:1rem}.agent-grid{display:grid;grid-template-columns:repeat(auto-fill,minmax(250px,1fr));grid-auto-rows:250px;gap:1rem;overflow-y:auto;align-content:start;flex:1}.agent-card{background:#fff;border:1px solid var(--border-color);border-radius:8px;padding:1rem;cursor:pointer;transition:all .2s ease;height:250px;display:grid;grid-template-rows:35px 100px 1fr;gap:3px;overflow:hidden}.agent-card:hover{transform:translateY(-2px);box-shadow:0 4px 6px #0000001a}.agent-card.selected{border-color:var(--primary-color);background-color:var(--selected-color)}.agent-card h3{margin:0 0 .5rem;color:var(--secondary-color)}.agent-card p{margin:0;font-size:.9rem;color:var(--text-color);height:90px;overflow:hidden;text-overflow:ellipsis;display:-webkit-box;-webkit-line-clamp:4;-webkit-box-orient:vertical}.agent-card-footer{display:flex;flex-direction:column;gap:.5rem;font-size:.8rem}.actions-count{color:var(--secondary-color)}.actions-preview{display:flex;flex-wrap:wrap;gap:.3rem;max-height:3.2rem;overflow:hidden;position:relative}.action-name-preview{background-color:var(--background-color);padding:.1rem .4rem;border-radius:4px;font-size:.75rem;color:var(--secondary-color)}.more-actions{color:var(--primary-color);font-style:italic;font-size:.75rem;position:absolute;bottom:0;right:0;background:linear-gradient(to left,#fff,#ffffffe6 20%,#fff0);padding-left:20px}.agent-details{background:#fff;border:1px solid var(--border-color);border-radius:8px;padding:1.5rem;width:40%;min-width:400px;overflow-y:auto}.agent-description{color:var(--text-color);margin:1rem 0}.actions-list{margin-top:1.5rem}.action-details{border:1px solid var(--border-color);border-radius:4px;margin:.5rem 0}.action-details summary{padding:.75rem;cursor:pointer;font-weight:700;background-color:var(--background-color)}.action-details summary:hover{background-color:var(--hover-color)}.action-content{padding:1rem}.action-content h4{margin:1rem 0 .5rem;color:var(--secondary-color)}.action-content ul{margin:0;padding-left:1.5rem}.action-content li{margin:.25rem 0}.scopes-list li{font-family:monospace;background-color:var(--background-color);padding:.2rem .5rem;border-radius:4px;margin:.25rem .5rem .25rem 0;display:inline-block}.no-agents{grid-column:1 / -1;text-align:center;padding:2rem;color:var(--text-color)}:root{font-family:Inter,system-ui,Avenir,Helvetica,Arial,sans-serif;line-height:1.5;font-weight:400;color-scheme:light dark;color:#ffffffde;background-color:#242424;font-synthesis:none;text-rendering:optimizeLegibility;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale}a{font-weight:500;color:#646cff;text-decoration:inherit}a:hover{color:#535bf2}body{margin:0;padding:0;min-width:320px;height:100vh;display:flex;flex-direction:column}h1{font-size:3.2em;line-height:1.1}button{border-radius:8px;border:1px solid transparent;padding:.6em 1.2em;font-size:1em;font-weight:500;font-family:inherit;background-color:#1a1a1a;cursor:pointer;transition:border-color .25s}button:hover{border-color:#646cff}button:focus,button:focus-visible{outline:4px auto -webkit-focus-ring-color}@media (prefers-color-scheme: light){:root{color:#213547;background-color:#fff}a:hover{color:#747bff}button{background-color:#f9f9f9}}

solace_agent_mesh/assets/web-visualizer/index.html

@@ -0,0 +1,14 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <!-- <link rel="icon" type="image/svg+xml" href="/vite.svg" /> -->
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>Solace Agent Mesh Visualizer</title>
+    <script type="module" crossorigin src="/assets/index-C5awueeJ.js"></script>
+    <link rel="stylesheet" crossorigin href="/assets/index-D0qORgkg.css">
+  </head>
+  <body>
+    <div id="root"></div>
+  </body>
+</html>

solace_agent_mesh/assets/web-visualizer/vite.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" aria-hidden="true" role="img" class="iconify iconify--logos" width="31.88" height="32" preserveAspectRatio="xMidYMid meet" viewBox="0 0 256 257"><defs><linearGradient id="IconifyId1813088fe1fbc01fb466" x1="-.828%" x2="57.636%" y1="7.652%" y2="78.411%"><stop offset="0%" stop-color="#41D1FF"></stop><stop offset="100%" stop-color="#BD34FE"></stop></linearGradient><linearGradient id="IconifyId1813088fe1fbc01fb467" x1="43.376%" x2="50.316%" y1="2.242%" y2="89.03%"><stop offset="0%" stop-color="#FFEA83"></stop><stop offset="8.333%" stop-color="#FFDD35"></stop><stop offset="100%" stop-color="#FFA800"></stop></linearGradient></defs><path fill="url(#IconifyId1813088fe1fbc01fb466)" d="M255.153 37.938L134.897 252.976c-2.483 4.44-8.862 4.466-11.382.048L.875 37.958c-2.746-4.814 1.371-10.646 6.827-9.67l120.385 21.517a6.537 6.537 0 0 0 2.322-.004l117.867-21.483c5.438-.991 9.574 4.796 6.877 9.62Z"></path><path fill="url(#IconifyId1813088fe1fbc01fb467)" d="M185.432.063L96.44 17.501a3.268 3.268 0 0 0-2.634 3.014l-5.474 92.456a3.268 3.268 0 0 0 3.997 3.378l24.777-5.718c2.318-.535 4.413 1.507 3.936 3.838l-7.361 36.047c-.495 2.426 1.782 4.5 4.151 3.78l15.304-4.649c2.372-.72 4.652 1.36 4.15 3.788l-11.698 56.621c-.732 3.542 3.979 5.473 5.943 2.437l1.313-2.028l72.516-144.72c1.215-2.423-.88-5.186-3.54-4.672l-25.505 4.922c-2.396.462-4.435-1.77-3.759-4.114l16.646-57.705c.677-2.35-1.37-4.583-3.769-4.113Z"></path></svg>

solace_agent_mesh/cli/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.1.1"

solace_agent_mesh/cli/commands/add/__init__.py

@@ -0,0 +1,3 @@
+from .add import add_command
+
+__all__ = ["add_command"]

solace_agent_mesh/cli/commands/add/add.py

@@ -0,0 +1,88 @@
+import click
+
+from .agent import add_agent_command
+from .gateway import add_gateway_command, add_interface_command
+from .copy_from_plugin import copy_from_plugin
+from ...config import Config
+from ...utils import log_error
+
+
+def add_command(add):
+    @add.command()
+    @click.argument("name")
+    @click.option(
+        "-c",
+        "--copy-from",
+        help="Name of the plugin. Copying over an agent config from an existing plugin instead of creating a new one to allow for customization. If your desired agent name is different from the source agent name, use the format <plugin>:<source_agent_name>",
+    )
+    def agent(name, copy_from):
+        """
+        Creates a template for an agent.
+
+        name: Name of the component to create. Must be kebab-case. (don't add 'agent' to the name)
+        """
+        if copy_from:
+            return copy_from_plugin(name, copy_from, "agents")
+        return add_agent_command(name)
+
+    @add.command()
+    @click.argument("name")
+    @click.option(
+        "-i",
+        "--interface",
+        help="The interface(s) to add to the gateway. For example, to add rest and slack interfaces use: --interface slack --interface rest-api",
+        multiple=True,
+    )
+    @click.option(
+        "-c",
+        "--copy-from",
+        help="Name of the plugin. Copying over a gateway configs from an existing plugin instead of creating a new one to allow for customization. If your desired gateway name is different from the source gateway name, use the format <plugin>:<source_gateway_name>",
+    )
+    @click.option(
+        "-n",
+        "--new-interface",
+        default=False,
+        is_flag=True,
+        help="Create a new gateway interface - supported only in plugin projects.",
+    )
+    def gateway(
+        name,
+        interface,
+        copy_from,
+        new_interface,
+    ):
+        """
+        Creates a template for a gateway.
+
+        name: Name of the component to create. Must be kebab-case. (don't add 'gateway' to the name)
+
+        If no interfaces is provided, a gateway from scratch will be created.
+        """
+        interface = list(interface)
+
+        if new_interface and interface:
+            log_error(
+                "Error: The --new-interface/-n flag is supported only when no interfaces are provided."
+            )
+            return 1
+        
+        if copy_from and interface:
+            log_error(
+                "Error: The --copy-from/-c flag is supported only when no interfaces are provided."
+            )
+        
+        # Copy from plugin
+        if copy_from:
+            return copy_from_plugin(name, copy_from, "gateways")
+        
+        # Creating a new gateway interface
+        if new_interface:
+            if not Config.is_plugin_project():
+                log_error(
+                    "Error: The --new-interface flag is supported only in plugin projects."
+                )
+                return 1
+            return add_interface_command(name)
+        
+        # Create a new gateway from an interface
+        return add_gateway_command(name, interface)

solace_agent_mesh/cli/commands/add/agent.py

@@ -0,0 +1,110 @@
+import os
+import click
+
+from cli.utils import get_display_path, load_template, log_error, get_formatted_names
+
+
+def add_agent_command(name):
+    """
+    Creates a template for an agent
+    """
+    # Name must be kebab-case, and only character, numbers, and hyphens are allowed
+    if not name.islower() or not name.replace("-", "").isalnum():
+        log_error(
+            "Error: Name must be kebab-case. Only lowercase letters, numbers, and hyphens are allowed.",
+        )
+        return 1
+
+    formatted_name = get_formatted_names(name)
+
+    try:
+        # Load the template file
+        template_file = load_template("agent.yaml", formatted_name)
+        if template_file is None:
+            log_error("Error: Template file for agent not found.")
+            return 1
+    except IOError as e:
+        log_error(f"Error reading template file: {e}")
+        return 1
+
+    config = click.get_current_context().obj
+    config_directory = config["solace_agent_mesh"]["config_directory"]
+
+    try:
+        file_name = f"{formatted_name['SNAKE_CASE_NAME']}.yaml"
+        directory = os.path.join(config_directory, "agents")
+        path = os.path.join(directory, file_name)
+
+        # Check if the file already exists
+        if os.path.exists(path):
+            overwrite = click.confirm(
+                f"File {path} already exists. Do you want to overwrite it?",
+                default=False,
+            )
+            if not overwrite:
+                click.echo("Template not created.")
+                return
+
+        # Create the directory if it doesn't exist
+        os.makedirs(directory, exist_ok=True)
+        with open(path, "w", encoding="utf-8") as f:
+            f.write(template_file)
+    except IOError as e:
+        log_error(f"Error creating template: {e}")
+        return 1
+
+    click.echo(f"Created agent template at: {get_display_path(path)}")
+
+    try:
+        # Creating the agent file
+        agent_directory = os.path.join(
+            config["solace_agent_mesh"]["modules_directory"],
+            "agents",
+            formatted_name["SNAKE_CASE_NAME"],
+        )
+        # Create the agent directory
+        os.makedirs(agent_directory, exist_ok=True)
+        # Create the __init__.py file
+        init_file = os.path.join(agent_directory, "__init__.py")
+        if not os.path.exists(init_file):
+            with open(init_file, "w", encoding="utf-8") as f:
+                f.write("")
+
+        # Create the agent python file
+        agent_path = os.path.join(
+            agent_directory,
+            f"{formatted_name['SNAKE_CASE_NAME']}_agent_component.py",
+        )
+        agent_template = load_template("agent.py", formatted_name)
+        if not os.path.exists(agent_path):
+            with open(agent_path, "w", encoding="utf-8") as f:
+                f.write(agent_template)
+
+        click.echo(
+            f"Created agent at: {get_display_path(agent_path)}"
+        )
+
+        # Create the agent action
+        action_directory = os.path.join(agent_directory, "actions")
+        os.makedirs(action_directory, exist_ok=True)
+        # Create the __init__.py file
+        init_file = os.path.join(action_directory, "__init__.py")
+        if not os.path.exists(init_file):
+            with open(init_file, "w", encoding="utf-8") as f:
+                f.write("")
+
+        action_path = os.path.join(action_directory, "sample_action.py")
+        action_template = load_template("action.py", formatted_name)
+        if not os.path.exists(action_path):
+            with open(action_path, "w", encoding="utf-8") as f:
+                f.write(action_template)
+
+        click.echo(f"Created sample action at: {get_display_path(action_path)}")
+
+        temp_file = os.path.join(config_directory, "__TEMPLATES_WILL_BE_HERE__")
+        if os.path.exists(temp_file):
+            os.remove(temp_file)
+    except IOError as e:
+        log_error(f"Error creating agent, agent config was created: {e}")
+        return 1
+

solace_agent_mesh/cli/commands/add/copy_from_plugin.py

@@ -0,0 +1,90 @@
+import os
+import click
+
+from cli.utils import log_error, load_plugin, get_display_path, get_formatted_names
+
+
+def copy_from_plugin(name, plugin_name, entity_type):
+    """
+    Creates a template for an agent or gateway by copying from an existing plugin.
+
+    name: Name of the component to create.
+    plugin_name: Name of the plugin. This is either just the plugin or plugin:entity_name
+                 for cases where the source config name is different from the destination name
+    entity_type: Type of the entity to create. (agents or gateways)
+    """
+    if entity_type not in ["agents", "gateways"]:
+        log_error("Invalid entity type.")
+        return 1
+    
+    src_entity_name = name
+    if ":" in plugin_name:
+        plugin_name, src_entity_name = plugin_name.split(":")
+
+    plugin_name = plugin_name.replace("-", "_")
+    plugin_path = load_plugin(plugin_name, return_path_only=True)
+    if not plugin_path:
+        log_error(f"Could not find '{plugin_name}' installed.")
+        return 1
+
+    name_cases = get_formatted_names(name)
+
+    item_name = name.replace("-", "_")
+    item_name = f"{item_name}.yaml" if entity_type == "agents" else item_name
+
+    src_entity_name = src_entity_name.replace("-", "_")
+    src_entity_name = f"{src_entity_name}.yaml" if entity_type == "agents" else src_entity_name
+    template_path = os.path.join(plugin_path, "configs", entity_type, src_entity_name)
+
+    if not os.path.exists(template_path):
+        log_error(f"Could not find '{item_name}' in '{plugin_name}' plugin.")
+        return 1
+
+    config = click.get_current_context().obj
+    config_directory = config["solace_agent_mesh"]["config_directory"]
+    target_directory = os.path.join(config_directory, entity_type)
+    os.makedirs(target_directory, exist_ok=True)
+
+    def parse_file(content):
+        content = (
+            content.replace(" src.", f" {plugin_name}.src.")
+            .replace("{{MODULE_DIRECTORY}}", f"{plugin_name}.src")
+            .replace("src.src.", "src.")
+        )
+        for case, val in name_cases.items():
+            content = content.replace(f"{{{{{case}}}}}", val)
+
+        return content
+
+    if entity_type == "agents":
+        with open(template_path, "r", encoding="utf-8") as f:
+            template_file = parse_file(f.read())
+        target_path = os.path.join(target_directory, item_name)
+        with open(target_path, "w", encoding="utf-8") as f:
+            f.write(template_file)
+
+    elif entity_type == "gateways":
+        target_directory = os.path.join(target_directory, item_name)
+        os.makedirs(target_directory, exist_ok=True)
+
+        for file_item in os.listdir(template_path):
+            source_path = os.path.join(template_path, file_item)
+            if not os.path.isfile(source_path):
+                continue
+            with open(source_path, "r", encoding="utf-8") as f:
+                template_file = parse_file(f.read())
+            target_path = os.path.join(target_directory, file_item)
+            with open(target_path, "w", encoding="utf-8") as f:
+                f.write(template_file)
+
+    else:
+        log_error("Invalid entity type.")
+        return 1
+    
+    temp_file = os.path.join(config_directory, "__TEMPLATES_WILL_BE_HERE__")
+    if os.path.exists(temp_file):
+        os.remove(temp_file)
+        
+    click.echo(
+        f"Copied {entity_type[:-1]} '{name}' from plugin '{plugin_name}' at: {get_display_path(target_directory)}"
+    )

solace_agent_mesh/cli/commands/add/gateway.py

@@ -0,0 +1,221 @@
+import os
+import sys
+import click
+
+from cli.utils import get_display_path, load_template, log_error, get_formatted_names
+from cli.commands.plugin.build import get_all_plugin_gateway_interfaces
+from cli.config import Config
+
+def _add_python_files(modules_directory, template_args, created_file_names):
+    # Creating the python files
+    module_directory = os.path.join(
+        modules_directory,
+        "gateways",
+        template_args["SNAKE_CASE_NAME"],
+    )
+    # Create the gateway directory
+    os.makedirs(module_directory, exist_ok=True)
+    # Create the __init__.py file
+    init_file = os.path.join(module_directory, "__init__.py")
+    if not os.path.exists(init_file):
+        with open(init_file, "w", encoding="utf-8") as f:
+            f.write("")
+    created_file_names.append(init_file)
+
+    # Create the gateway python file
+    for gateways_file in ["base", "input", "output"]:
+        gateway_path = os.path.join(
+            module_directory,
+            f"{template_args['SNAKE_CASE_NAME']}_{gateways_file}.py",
+        )
+        gateway_template = load_template(f"gateway_{gateways_file}.py", template_args)
+        if not os.path.exists(gateway_path):
+            with open(gateway_path, "w", encoding="utf-8") as f:
+                f.write(gateway_template)
+        created_file_names.append(gateway_path)
+
+def add_gateway_command(name, interfaces):
+    """
+    Creates a gateway configuration directory and files based on provided templates.
+
+    This function performs the following steps:
+    1. Creates a directory for the gateway in the specified configuration directory.
+    2. Copies a gateway configuration template file to the new gateway directory.
+    3. If a list of interfaces is provided, creates configuration files for each interface based on corresponding templates.
+
+    Args:
+        interfaces (list): A list of interface names for which configuration files should be created.
+        formatted_name (dict): A dictionary containing the formatted name of the gateway.
+                               The key "SNAKE_CASE_NAME" is used to name the gateway directory.
+
+    Returns:
+        int: Returns 1 if an IOError occurs during the creation of the gateway configuration, otherwise returns None.
+
+    Raises:
+        IOError: If there is an error creating the gateway configuration files or directories.
+    """
+
+    # Name must be kebab-case, and only character, numbers, and hyphens are allowed
+    if not name.islower() or not name.replace("-", "").isalnum():
+        log_error(
+            "Error: Name must be kebab-case. Only lowercase letters, numbers, and hyphens are allowed.",
+        )
+        return 1
+
+    formatted_name = get_formatted_names(name)
+    created_file_names = []
+
+    try:
+        # Create a directory for the gateway in the config directory
+        config = click.get_current_context().obj["solace_agent_mesh"]
+        config_directory = config["config_directory"]
+        gateway_directory = os.path.join(
+            config_directory, "gateways", formatted_name["SNAKE_CASE_NAME"]
+        )
+
+        def abort():
+            sys.exit(1)
+
+        plugin_gateway_interfaces = get_all_plugin_gateway_interfaces(config, abort)
+
+        # Check if the gateway directory already exists
+        if os.path.exists(gateway_directory):
+            overwrite = click.confirm(
+                f"Gateway directory {gateway_directory} already exists. Do you want to overwrite it?",
+                default=False,
+            )
+            if not overwrite:
+                click.echo("Gateway template not created.")
+                return
+        os.makedirs(gateway_directory, exist_ok=True)
+
+        # Create the gateway config file from the template directory
+        # The file name is gateway-default-config.yaml but write it as gateway.yaml in the gateway_directory
+        gateway_config_template = load_template("gateway-default-config.yaml")
+        gateway_config_path = os.path.join(gateway_directory, "gateway.yaml")
+        with open(gateway_config_path, "w", encoding="utf-8") as f:
+            f.write(gateway_config_template)
+
+        created_file_names.append(gateway_config_path)
+
+        # If the interface list is not empty, create the interface config files
+        if interfaces:
+            for interface in interfaces:
+                # Load the interface template from the templates directory.
+                # The name will be {interface}-default-config.yaml
+                # Write the file as {interface}.yaml in the gateway_directory
+                if interface in plugin_gateway_interfaces:
+                    interface_default_path = os.path.join(
+                        plugin_gateway_interfaces[interface],
+                        f"{interface}-default-config.yaml",
+                    )
+                    if not os.path.exists(interface_default_path):
+                        log_error("Error: Interface template not found.")
+                        return 1
+                    with open(interface_default_path, "r", encoding="utf-8") as g:
+                        interface_template = g.read()
+                else:
+                    interface_template = load_template(
+                        f"{interface}-default-config.yaml"
+                    )
+                    if not interface_template:
+                        log_error("Error: Interface template not found.")
+                        return 1
+
+                interface_config_path = os.path.join(
+                    gateway_directory, f"{interface}.yaml"
+                )
+                with open(interface_config_path, "w", encoding="utf-8") as f:
+                    f.write(interface_template)
+
+                created_file_names.append(interface_config_path)
+
+        else:
+            click.echo(click.style("No interfaces provided. A gateway from scratch will be created.", fg="yellow"))
+            try:
+                # Create the gateway config file
+                interface_config_path = os.path.join(
+                    gateway_directory,
+                    f"{formatted_name['SNAKE_CASE_NAME']}.yaml",
+                )
+                gateway_template = load_template("gateway-config-template.yaml", formatted_name)
+                if not os.path.exists(interface_config_path):
+                    with open(interface_config_path, "w", encoding="utf-8") as f:
+                        f.write(gateway_template)
+                created_file_names.append(interface_config_path)
+
+                _add_python_files(config["modules_directory"], formatted_name, created_file_names)
+            except IOError as e:
+                log_error(f"Error creating gateway, gateway config was created: {e}")
+                return 1
+            
+        temp_file = os.path.join(config_directory, "__TEMPLATES_WILL_BE_HERE__")
+        if os.path.exists(temp_file):
+            os.remove(temp_file)
+
+    except IOError as e:
+        log_error(f"Error creating gateway config: {e}")
+        return 1
+    
+    finally:
+        if created_file_names:
+            click.echo("Created the following gateway template files:")
+            for file_name in created_file_names:
+                click.echo(f"  - {get_display_path(file_name)}")
+
+
+def add_interface_command(name):
+    """
+    Creates a new gateway interface with the provided name.
+    """
+    config = Config.get_plugin_config()
+    plugin_name = config.get("solace_agent_mesh_plugin", {}).get("name")
+    if not plugin_name or plugin_name == "solace-agent-mesh-plugin":
+        log_error("Could not find a valid plugin project")
+        return 1
+    
+    plugin_name = plugin_name.replace("-","_")
+    template_args = get_formatted_names(name)
+    template_args.update({
+        "MODULE_DIRECTORY": f"{plugin_name}.src"
+    })
+    created_file_names = []
+
+    interfaces_directory = os.path.join("interfaces")
+    modules_directory = os.path.join("src")
+
+    try:
+        os.makedirs(interfaces_directory, exist_ok=True)
+
+        temp_file = os.path.join(interfaces_directory, "__INTERFACES_WILL_BE_HERE__")
+        if os.path.exists(temp_file):
+            os.remove(temp_file)
+
+        # Create the interface flows and config file
+        interface_flows_path = os.path.join(interfaces_directory, f"{template_args['HYPHENED_NAME']}-flows.yaml")
+        interface_config_path = os.path.join(interfaces_directory, f"{template_args['HYPHENED_NAME']}-default-config.yaml")
+
+        interface_flows_template = load_template("gateway-flows.yaml", template_args)
+        interface_flows_template = interface_flows_template.replace(" src.gateway", " solace_agent_mesh.src.gateway")
+        if not os.path.exists(interface_flows_path):
+            with open(interface_flows_path, "w", encoding="utf-8") as f:
+                f.write(interface_flows_template)
+        created_file_names.append(interface_flows_path)
+
+        interface_config_template = load_template("gateway-config-template.yaml", template_args)
+        if not os.path.exists(interface_config_path):
+            with open(interface_config_path, "w", encoding="utf-8") as f:
+                f.write(interface_config_template)
+        created_file_names.append(interface_config_path)
+
+        _add_python_files(modules_directory, template_args, created_file_names)
+
+    except IOError as e:
+        log_error(f"Error creating gateway interface, {e}")
+        return 1
+    
+    finally:
+        if created_file_names:
+            click.echo("Created the following gateway template files:")
+            for file_name in created_file_names:
+                click.echo(f"  - {get_display_path(file_name)}")