solace-agent-mesh 1.0.1__py3-none-any.whl → 1.0.2__py3-none-any.whl

solace_agent_mesh/__init__.py

@@ -0,0 +1,5 @@
+"""
+Solace Agent Mesh Initialization
+"""
+from .common.utils.initializer import initialize
+initialize()

solace_agent_mesh/agent/adk/callbacks.py

@@ -785,6 +785,26 @@ It can span multiple lines.
 
 The system will automatically save the content and give you a confirmation in the next turn."""
 
+def _generate_artifact_creation_instruction() -> str:
+    return """
+    **Creating Text-Based Artifacts:**
+
+    **When to Create Text-based Artifacts:**
+    Create an artifact when the content provides value as a standalone file:
+    - Content with special formatting (HTML, Markdown, CSS, structured markup) that requires proper rendering
+    - Content explicitly intended for use outside this conversation (reports, emails, presentations, reference documents)
+    - Structured reference content users will save or follow (schedules, guides, templates)
+    - Content that will be edited, expanded, or reused
+    - Substantial text documents
+    - Technical documentation meant as reference material
+
+    **When NOT to Create Text-based Artifacts:**
+    - Simple answers, explanations, or conversational responses
+    - Brief advice, opinions, or quick information
+    - Short lists, summaries, or single paragraphs  
+    - Temporary content only relevant to the immediate conversation
+    - Basic explanations that don't require reference material
+    """
 
 def _generate_embed_instruction(
     include_artifact_content: bool,
@@ -918,7 +938,7 @@ When faced with a complex goal or request that involves multiple steps, data ret
 Simple, direct requests like 'create an image of a dog' or 'write an email to thank my boss' do not require a plan.
 
 If a plan is created:
-1. It should be a terse, hierarchical list describing the steps needed.
+1. It should be a terse, hierarchical list describing the steps needed, with each checkbox item on its own line.
 2. Use '☐' (empty checkbox emoji) for pending items and '☑' (checked checkbox emoji) for completed items.
 3. If the plan changes significantly during execution, restate the updated plan.
 4. As items are completed, update the plan to check them off.
@@ -926,6 +946,8 @@ If a plan is created:
 """
     injected_instructions.append(planning_instruction)
     log.debug("%s Added hardcoded planning instructions.", log_identifier)
+    artifact_creation_instruction = _generate_artifact_creation_instruction()
+    injected_instructions.append(artifact_creation_instruction)
     fenced_artifact_instruction = _generate_fenced_artifact_instruction()
     injected_instructions.append(fenced_artifact_instruction)
 

solace_agent_mesh/agent/adk/filesystem_artifact_service.py

@@ -371,11 +371,11 @@ class FilesystemArtifactService(BaseArtifactService):
         sorted_versions = sorted(versions)
         logger.debug("%sFound versions: %s", log_prefix, sorted_versions)
         return sorted_versions
-    
+
     def _normalize_filename_unicode(self, filename: str) -> str:
         """
         Normalizes Unicode characters in a filename to their standard form.
         Specifically targets compatibility characters like non-breaking spaces (\u202f)
         and converts them to their regular ASCII equivalents (a standard space).
         """
-        return unicodedata.normalize('NFKC', filename)
+        return unicodedata.normalize("NFKC", filename)

solace_agent_mesh/agent/adk/runner.py

@@ -132,7 +132,7 @@ async def run_adk_async_task_thread_wrapper(
             logical_task_id,
             tce,
         )
-        sub_tasks_to_cancel = task_context.peer_sub_tasks if task_context else []
+        sub_tasks_to_cancel = task_context.active_peer_sub_tasks if task_context else {}
 
         if sub_tasks_to_cancel:
             log.info(
@@ -141,18 +141,22 @@ async def run_adk_async_task_thread_wrapper(
                 len(sub_tasks_to_cancel),
                 logical_task_id,
             )
-            for sub_task_info in sub_tasks_to_cancel:
+            for sub_task_id, sub_task_info in sub_tasks_to_cancel.items():
                 try:
-                    sub_task_id = sub_task_info.get("sub_task_id")
                     target_peer_agent_name = sub_task_info.get("peer_agent_name")
                     if not sub_task_id or not target_peer_agent_name:
                         log.warning(
-                            "%s Incomplete sub-task info found, cannot cancel: %s",
+                            "%s Incomplete sub-task info found for sub-task %s, cannot cancel: %s",
                             component.log_identifier,
+                            sub_task_id,
                             sub_task_info,
                         )
                         continue
-                    peer_cancel_params = TaskIdParams(id=sub_task_id)
+
+                    task_id_for_peer = sub_task_id.replace(
+                        component.CORRELATION_DATA_PREFIX, "", 1
+                    )
+                    peer_cancel_params = TaskIdParams(id=task_id_for_peer)
                     peer_cancel_request = CancelTaskRequest(params=peer_cancel_params)
                     peer_cancel_user_props = {"clientId": component.agent_name}
                     peer_request_topic = component._get_agent_request_topic(
@@ -167,7 +171,7 @@ async def run_adk_async_task_thread_wrapper(
                     log.error(
                         "%s Failed to send CancelTaskRequest for sub-task %s: %s",
                         component.log_identifier,
-                        sub_task_info.get("sub_task_id"),
+                        sub_task_id,
                         e_peer_cancel,
                         exc_info=True,
                     )

solace_agent_mesh/agent/adk/services.py

@@ -28,7 +28,7 @@ from google.adk.memory import (
 from .filesystem_artifact_service import FilesystemArtifactService
 
 try:
-    from tests.integration.infrastructure.artifact_service.service import (
+    from sam_test_infrastructure.artifact_service.service import (
         TestInMemoryArtifactService,
     )
 except ImportError:

solace_agent_mesh/agent/protocol/event_handlers.py

@@ -248,7 +248,7 @@ async def process_event(component, event: Event):
             elif topic.startswith(agent_response_sub_prefix) or topic.startswith(
                 agent_status_sub_prefix
             ):
-                handle_a2a_response(component, message)
+                await handle_a2a_response(component, message)
             else:
                 log.warning(
                     "%s Received message on unhandled topic: %s",
@@ -264,31 +264,8 @@ async def process_event(component, event: Event):
             if timer_data.get("timer_id") == component._card_publish_timer_id:
                 publish_agent_card(component)
         elif event.event_type == EventType.CACHE_EXPIRY:
-            cache_data = event.data
-            log.info(
-                "%s Received cache expiry event: %s",
-                component.log_identifier,
-                cache_data,
-            )
-            sub_task_id = cache_data.get("key")
-            if sub_task_id and sub_task_id.startswith(
-                component.CORRELATION_DATA_PREFIX
-            ):
-                expired_data = cache_data.get("expired_data")
-                if expired_data:
-                    await component._handle_peer_timeout(sub_task_id, expired_data)
-                else:
-                    log.error(
-                        "%s Missing expired_data in cache expiry event for sub-task %s. Cannot process timeout.",
-                        component.log_identifier,
-                        sub_task_id,
-                    )
-            else:
-                log.debug(
-                    "%s Cache expiry for key '%s' is not a peer sub-task timeout.",
-                    component.log_identifier,
-                    sub_task_id,
-                )
+            # Delegate cache expiry handling to the component itself.
+            await component.handle_cache_expiry_event(event.data)
         else:
             log.warning(
                 "%s Received unknown event type: %s",
@@ -854,10 +831,9 @@ def handle_agent_card_message(component, message: SolaceMessage):
         component.handle_error(e, Event(EventType.MESSAGE, message))
 
 
-def handle_a2a_response(component, message: SolaceMessage):
+async def handle_a2a_response(component, message: SolaceMessage):
     """Handles incoming responses/status updates from peer agents."""
     sub_task_id = None
-    agent_name = component.get_config("agent_name")
     payload_to_queue = None
     is_final_response = False
 
@@ -932,10 +908,8 @@ def handle_a2a_response(component, message: SolaceMessage):
                                             component.log_identifier,
                                             sub_task_id,
                                         )
-                                        correlation_data = (
-                                            component.cache_service.get_data(
-                                                sub_task_id
-                                            )
+                                        correlation_data = await component._get_correlation_data_for_sub_task(
+                                            sub_task_id
                                         )
                                         if not correlation_data:
                                             log.warning(
@@ -1227,7 +1201,12 @@ def handle_a2a_response(component, message: SolaceMessage):
                     "error": f"Failed to parse response from peer: {parse_error}",
                     "code": "PEER_PARSE_ERROR",
                 }
-                is_final_response = True
+                # Print out the stack trace for debugging
+                log.exception(
+                    "%s Exception stack trace: %s",
+                    component.log_identifier,
+                    parse_error,
+                )
 
         if not is_final_response:
             # This is an intermediate status update for monitoring.
@@ -1240,13 +1219,9 @@ def handle_a2a_response(component, message: SolaceMessage):
             message.call_acknowledgements()
             return
 
-        correlation_data = component.cache_service.get_data(sub_task_id)
+        correlation_data = await component._claim_peer_sub_task_completion(sub_task_id)
         if not correlation_data:
-            log.warning(
-                "%s No correlation data found for sub-task %s. Cannot process response. Ignoring.",
-                component.log_identifier,
-                sub_task_id,
-            )
+            # The helper method logs the reason (timeout, already claimed, etc.)
             message.call_acknowledgements()
             return
 

solace_agent_mesh/agent/sac/component.py

@@ -53,6 +53,8 @@ from ...common.types import (
     TaskStatusUpdateEvent,
     TaskArtifactUpdateEvent,
     SendTaskRequest,
+    CancelTaskRequest,
+    TaskIdParams,
 )
 from ...common.a2a_protocol import (
     get_a2a_base_topic,
@@ -536,49 +538,123 @@ class SamAgentComponent(ComponentBase):
         if timer_data.get("timer_id") == self._card_publish_timer_id:
             publish_agent_card(self)
 
-    def handle_cache_expiry_event(self, cache_data: Dict[str, Any]):
-        """Handles cache expiry events, specifically for peer timeouts."""
+    async def handle_cache_expiry_event(self, cache_data: Dict[str, Any]):
+        """
+        Handles cache expiry events for peer timeouts by calling the atomic claim helper.
+        """
         log.debug("%s Received cache expiry event: %s", self.log_identifier, cache_data)
-        expired_key = cache_data.get("key")
-        expired_data = cache_data.get("expired_data")
+        sub_task_id = cache_data.get("key")
+        logical_task_id = cache_data.get("expired_data")
+
+        if not (
+            sub_task_id
+            and sub_task_id.startswith(CORRELATION_DATA_PREFIX)
+            and logical_task_id
+        ):
+            log.debug(
+                "%s Cache expiry for key '%s' is not a peer sub-task timeout or is missing data.",
+                self.log_identifier,
+                sub_task_id,
+            )
+            return
+
+        correlation_data = await self._claim_peer_sub_task_completion(
+            sub_task_id=sub_task_id, logical_task_id_from_event=logical_task_id
+        )
 
-        if expired_key and expired_key.startswith(CORRELATION_DATA_PREFIX):
-            sub_task_id = expired_key
+        if correlation_data:
             log.warning(
-                "%s Detected timeout for sub-task ID: %s",
+                "%s Detected timeout for sub-task %s (Main Task: %s). Claimed successfully.",
                 self.log_identifier,
                 sub_task_id,
+                logical_task_id,
             )
-            if expired_data:
-                try:
-                    original_task_context = expired_data.get("original_task_context")
-                    if original_task_context:
-                        self._handle_peer_timeout(sub_task_id, expired_data)
-                    else:
-                        log.error(
-                            "%s Missing 'original_task_context' in expired cache data for sub-task %s. Cannot process timeout.",
-                            self.log_identifier,
-                            sub_task_id,
-                        )
-                except Exception as e:
-                    log.exception(
-                        "%s Error handling peer timeout for sub-task %s: %s",
-                        self.log_identifier,
-                        sub_task_id,
-                        e,
-                    )
-            else:
-                log.error(
-                    "%s Missing expired_data in cache expiry event for sub-task %s. Cannot process timeout.",
-                    self.log_identifier,
-                    sub_task_id,
-                )
+            await self._handle_peer_timeout(sub_task_id, correlation_data)
         else:
-            log.debug(
-                "%s Cache expiry for key '%s' is not a peer sub-task timeout.",
+            log.info(
+                "%s Ignoring timeout event for sub-task %s as it was already completed.",
+                self.log_identifier,
+                sub_task_id,
+            )
+
+    async def _get_correlation_data_for_sub_task(
+        self, sub_task_id: str
+    ) -> Optional[Dict[str, Any]]:
+        """
+        Non-destructively retrieves correlation data for a sub-task.
+        Used for intermediate events where the sub-task should remain active.
+        """
+        logical_task_id = self.cache_service.get_data(sub_task_id)
+        if not logical_task_id:
+            log.warning(
+                "%s No cache entry for sub-task %s. Cannot get correlation data.",
+                self.log_identifier,
+                sub_task_id,
+            )
+            return None
+
+        with self.active_tasks_lock:
+            task_context = self.active_tasks.get(logical_task_id)
+
+        if not task_context:
+            log.error(
+                "%s TaskExecutionContext not found for task %s, but cache entry existed for sub-task %s. This may indicate a cleanup issue.",
                 self.log_identifier,
-                expired_key,
+                logical_task_id,
+                sub_task_id,
+            )
+            return None
+
+        with task_context.lock:
+            return task_context.active_peer_sub_tasks.get(sub_task_id)
+
+    async def _claim_peer_sub_task_completion(
+        self, sub_task_id: str, logical_task_id_from_event: Optional[str] = None
+    ) -> Optional[Dict[str, Any]]:
+        """
+        Atomically claims a sub-task as complete, preventing race conditions.
+        This is a destructive operation that removes state.
+
+        Args:
+            sub_task_id: The ID of the sub-task to claim.
+            logical_task_id_from_event: The parent task ID, if provided by the event (e.g., a timeout).
+                                        If not provided, it will be looked up from the cache.
+        """
+        log_id = f"{self.log_identifier}[ClaimSubTask:{sub_task_id}]"
+        logical_task_id = logical_task_id_from_event
+
+        if not logical_task_id:
+            logical_task_id = self.cache_service.get_data(sub_task_id)
+            if not logical_task_id:
+                log.warning(
+                    "%s No cache entry found. Task has likely timed out and been cleaned up. Cannot claim.",
+                    log_id,
+                )
+                return None
+
+        with self.active_tasks_lock:
+            task_context = self.active_tasks.get(logical_task_id)
+
+        if not task_context:
+            log.error(
+                "%s TaskExecutionContext not found for task %s. Cleaning up stale cache entry.",
+                log_id,
+                logical_task_id,
             )
+            self.cache_service.remove_data(sub_task_id)
+            return None
+
+        correlation_data = task_context.claim_sub_task_completion(sub_task_id)
+
+        if correlation_data:
+            # If we successfully claimed the task, remove the timeout tracker from the cache.
+            self.cache_service.remove_data(sub_task_id)
+            log.info("%s Successfully claimed completion.", log_id)
+            return correlation_data
+        else:
+            # This means the task was already claimed by a competing event (e.g., timeout vs. response).
+            log.warning("%s Failed to claim; it was already completed.", log_id)
+            return None
 
     async def _retrigger_agent_with_peer_responses(
         self,
@@ -686,8 +762,9 @@ class SamAgentComponent(ComponentBase):
         correlation_data: Dict[str, Any],
     ):
         """
-        Handles the timeout of a peer agent task by updating the completion counter
-        and potentially re-triggering the runner if all parallel tasks are now complete.
+        Handles the timeout of a peer agent task. It sends a cancellation request
+        to the peer, updates the local completion counter, and potentially
+        re-triggers the runner if all parallel tasks are now complete.
         """
         logical_task_id = correlation_data.get("logical_task_id")
         invocation_id = correlation_data.get("invocation_id")
@@ -700,6 +777,36 @@ class SamAgentComponent(ComponentBase):
             invocation_id,
         )
 
+        # Proactively send a cancellation request to the peer agent.
+        peer_agent_name = correlation_data.get("peer_agent_name")
+        if peer_agent_name:
+            try:
+                log.info(
+                    "%s Sending CancelTaskRequest to peer '%s' for timed-out sub-task %s.",
+                    log_retrigger,
+                    peer_agent_name,
+                    sub_task_id,
+                )
+                task_id_for_peer = sub_task_id.replace(CORRELATION_DATA_PREFIX, "", 1)
+                cancel_params = TaskIdParams(id=task_id_for_peer)
+                cancel_request = CancelTaskRequest(params=cancel_params)
+                user_props = {"clientId": self.agent_name}
+                peer_topic = self._get_agent_request_topic(peer_agent_name)
+                self._publish_a2a_message(
+                    payload=cancel_request.model_dump(exclude_none=True),
+                    topic=peer_topic,
+                    user_properties=user_props,
+                )
+            except Exception as e:
+                log.error(
+                    "%s Failed to send CancelTaskRequest to peer '%s' for sub-task %s: %s",
+                    log_retrigger,
+                    peer_agent_name,
+                    sub_task_id,
+                    e,
+                )
+
+        # Process the timeout locally.
         with self.active_tasks_lock:
             task_context = self.active_tasks.get(logical_task_id)
 
@@ -1841,7 +1948,8 @@ class SamAgentComponent(ComponentBase):
                     len(unprocessed_tail.encode("utf-8")),
                 )
         else:
-            resolved_text = resolved_text + unprocessed_tail
+            if unprocessed_tail is not None and unprocessed_tail != "":
+                resolved_text = resolved_text + unprocessed_tail
 
         if signals_found:
             log.info(

solace_agent_mesh/agent/sac/task_execution_context.py

@@ -27,7 +27,7 @@ class TaskExecutionContext:
         self.cancellation_event: asyncio.Event = asyncio.Event()
         self.streaming_buffer: str = ""
         self.run_based_response_buffer: str = ""
-        self.peer_sub_tasks: List[Dict[str, Any]] = []
+        self.active_peer_sub_tasks: Dict[str, Dict[str, Any]] = {}
         self.parallel_tool_calls: Dict[str, Dict[str, Any]] = {}
         self.produced_artifacts: List[Dict[str, Any]] = []
         self.artifact_signals_to_return: List[Dict[str, Any]] = []
@@ -64,12 +64,21 @@ class TaskExecutionContext:
         with self.lock:
             self.run_based_response_buffer += text
 
-    def register_peer_sub_task(self, sub_task_id: str, peer_agent_name: str) -> None:
-        """Adds a new peer sub-task to the tracking list."""
+    def register_peer_sub_task(
+        self, sub_task_id: str, correlation_data: Dict[str, Any]
+    ) -> None:
+        """Adds a new peer sub-task's correlation data to the tracking dictionary."""
         with self.lock:
-            self.peer_sub_tasks.append(
-                {"sub_task_id": sub_task_id, "peer_agent_name": peer_agent_name}
-            )
+            self.active_peer_sub_tasks[sub_task_id] = correlation_data
+
+    def claim_sub_task_completion(self, sub_task_id: str) -> Optional[Dict[str, Any]]:
+        """
+        Atomically retrieves and removes a sub-task's correlation data.
+        This is the core atomic operation to prevent race conditions.
+        Returns the correlation data if the claim is successful, otherwise None.
+        """
+        with self.lock:
+            return self.active_peer_sub_tasks.pop(sub_task_id, None)
 
     def register_parallel_call_sent(self, invocation_id: str) -> None:
         """

solace_agent_mesh/agent/tools/general_agent_tools.py

@@ -397,7 +397,8 @@ async def mermaid_diagram_generator(
                 "message": "Failed to render Mermaid diagram. No image data returned.",
             }
         try:
-            image_data = await _convert_svg_to_png_with_playwright(svg_image_data.decode("utf-8"))
+            scale = max(2, len(mermaid_syntax.splitlines()) // 10)
+            image_data = await _convert_svg_to_png_with_playwright(svg_image_data.decode("utf-8"), scale)
         except Exception as e:
             log.error(
                 "%s Failed to convert SVG to PNG with Playwright: %s",
@@ -410,8 +411,9 @@ async def mermaid_diagram_generator(
             }
 
         log.debug(
-            "%s Mermaid diagram rendered successfully, image_data length: %d bytes",
+            "%s Mermaid diagram rendered successfully with scale %d, image_data length: %d bytes",
             log_identifier,
+            scale,
             len(image_data),
         )
 

solace_agent_mesh/agent/tools/peer_agent_tool.py

@@ -243,13 +243,18 @@ class PeerAgentTool(BaseTool):
                 "adk_function_call_id": tool_context.function_call_id,
                 "original_task_context": original_task_context,
                 "peer_tool_name": self.name,
+                "peer_agent_name": self.target_agent_name,
                 "logical_task_id": main_logical_task_id,
                 "invocation_id": invocation_id,
             }
 
+            # Register the sub-task's state within the parent task's context.
+            task_context_obj.register_peer_sub_task(sub_task_id, correlation_data)
+
+            # Add a simple mapping to the cache for timeout tracking.
             self.host_component.cache_service.add_data(
                 key=sub_task_id,
-                value=correlation_data,
+                value=main_logical_task_id,
                 expiry=timeout_sec,
                 component=self.host_component,
             )
@@ -264,10 +269,6 @@ class PeerAgentTool(BaseTool):
                 sub_task_id=sub_task_id,
                 function_call_id=tool_context.function_call_id,
             )
-
-            task_context_obj.register_peer_sub_task(
-                sub_task_id=sub_task_id, peer_agent_name=self.target_agent_name
-            )
             log.info(
                 "%s Registered active peer sub-task %s for main task %s.",
                 log_identifier,

solace_agent_mesh/assets/docs/404.html

@@ -4,13 +4,13 @@
 <meta charset="UTF-8">
 <meta name="generator" content="Docusaurus v3.8.1">
 <title data-rh="true">Page Not Found | Solace Agent Mesh</title><meta data-rh="true" name="viewport" content="width=device-width,initial-scale=1"><meta data-rh="true" name="twitter:card" content="summary_large_image"><meta data-rh="true" property="og:image" content="https://solacelabs.github.io/solace-agent-mesh/img/logo.png"><meta data-rh="true" name="twitter:image" content="https://solacelabs.github.io/solace-agent-mesh/img/logo.png"><meta data-rh="true" property="og:url" content="https://solacelabs.github.io/solace-agent-mesh/404.html"><meta data-rh="true" property="og:locale" content="en"><meta data-rh="true" name="docusaurus_locale" content="en"><meta data-rh="true" name="docusaurus_tag" content="default"><meta data-rh="true" name="docsearch:language" content="en"><meta data-rh="true" name="docsearch:docusaurus_tag" content="default"><meta data-rh="true" property="og:title" content="Page Not Found | Solace Agent Mesh"><link data-rh="true" rel="icon" href="/solace-agent-mesh/img/logo.png"><link data-rh="true" rel="canonical" href="https://solacelabs.github.io/solace-agent-mesh/404.html"><link data-rh="true" rel="alternate" href="https://solacelabs.github.io/solace-agent-mesh/404.html" hreflang="en"><link data-rh="true" rel="alternate" href="https://solacelabs.github.io/solace-agent-mesh/404.html" hreflang="x-default"><link rel="stylesheet" href="/solace-agent-mesh/assets/css/styles.906a1503.css">
-<script src="/solace-agent-mesh/assets/js/runtime~main.d9520ae2.js" defer="defer"></script>
-<script src="/solace-agent-mesh/assets/js/main.7ed3319f.js" defer="defer"></script>
+<script src="/solace-agent-mesh/assets/js/runtime~main.d5133813.js" defer="defer"></script>
+<script src="/solace-agent-mesh/assets/js/main.c6286d7c.js" defer="defer"></script>
 </head>
 <body class="navigation-with-keyboard">
 <svg xmlns="http://www.w3.org/2000/svg" style="display: none;"><defs>
 <symbol id="theme-svg-external-link" viewBox="0 0 24 24"><path fill="currentColor" d="M21 13v10h-21v-19h12v2h-10v15h17v-8h2zm3-12h-10.988l4.035 4-6.977 7.07 2.828 2.828 6.977-7.07 4.125 4.172v-11z"/></symbol>
 </defs></svg>
-<script>!function(){var t=function(){try{return new URLSearchParams(window.location.search).get("docusaurus-theme")}catch(t){}}()||function(){try{return window.localStorage.getItem("theme")}catch(t){}}();document.documentElement.setAttribute("data-theme",t||(window.matchMedia("(prefers-color-scheme: dark)").matches?"dark":"light")),document.documentElement.setAttribute("data-theme-choice",t||"system")}(),function(){try{const c=new URLSearchParams(window.location.search).entries();for(var[t,e]of c)if(t.startsWith("docusaurus-data-")){var a=t.replace("docusaurus-data-","data-");document.documentElement.setAttribute(a,e)}}catch(t){}}()</script><div id="__docusaurus"><link rel="preload" as="image" href="/solace-agent-mesh/img/logo.png"><link rel="preload" as="image" href="/solace-agent-mesh/img/solace-logo.png"><div role="region" aria-label="Skip to main content"><a class="skipToContent_fXgn" href="#__docusaurus_skipToContent_fallback">Skip to main content</a></div><nav aria-label="Main" class="theme-layout-navbar navbar navbar--fixed-top"><div class="navbar__inner"><div class="theme-layout-navbar-left navbar__items"><button aria-label="Toggle navigation bar" aria-expanded="false" class="navbar__toggle clean-btn" type="button"><svg width="30" height="30" viewBox="0 0 30 30" aria-hidden="true"><path stroke="currentColor" stroke-linecap="round" stroke-miterlimit="10" stroke-width="2" d="M4 7h22M4 15h22M4 23h22"></path></svg></button><a class="navbar__brand" href="/solace-agent-mesh/docs/documentation/getting-started/introduction"><div class="navbar__logo"><img src="/solace-agent-mesh/img/logo.png" alt="Solace Agent Mesh Logo" class="themedComponent_mlkZ themedComponent--light_NVdE"><img src="/solace-agent-mesh/img/logo.png" alt="Solace Agent Mesh Logo" class="themedComponent_mlkZ themedComponent--dark_xIcU"></div><b class="navbar__title text--truncate">Solace Agent Mesh</b></a><a class="navbar__item navbar__link" href="/solace-agent-mesh/docs/documentation/getting-started/introduction">Documentation</a></div><div class="theme-layout-navbar-right navbar__items navbar__items--right"><a href="https://github.com/SolaceLabs/solace-agent-mesh/" target="_blank" rel="noopener noreferrer" class="navbar__item navbar__link">GitHub<svg width="13.5" height="13.5" aria-hidden="true" class="iconExternalLink_nPIU"><use href="#theme-svg-external-link"></use></svg></a><div class="toggle_vylO colorModeToggle_DEke"><button class="clean-btn toggleButton_gllP toggleButtonDisabled_aARS" type="button" disabled="" title="system mode" aria-label="Switch between dark and light mode (currently system mode)"><svg viewBox="0 0 24 24" width="24" height="24" aria-hidden="true" class="toggleIcon_g3eP lightToggleIcon_pyhR"><path fill="currentColor" d="M12,9c1.65,0,3,1.35,3,3s-1.35,3-3,3s-3-1.35-3-3S10.35,9,12,9 M12,7c-2.76,0-5,2.24-5,5s2.24,5,5,5s5-2.24,5-5 S14.76,7,12,7L12,7z M2,13l2,0c0.55,0,1-0.45,1-1s-0.45-1-1-1l-2,0c-0.55,0-1,0.45-1,1S1.45,13,2,13z M20,13l2,0c0.55,0,1-0.45,1-1 s-0.45-1-1-1l-2,0c-0.55,0-1,0.45-1,1S19.45,13,20,13z M11,2v2c0,0.55,0.45,1,1,1s1-0.45,1-1V2c0-0.55-0.45-1-1-1S11,1.45,11,2z M11,20v2c0,0.55,0.45,1,1,1s1-0.45,1-1v-2c0-0.55-0.45-1-1-1C11.45,19,11,19.45,11,20z M5.99,4.58c-0.39-0.39-1.03-0.39-1.41,0 c-0.39,0.39-0.39,1.03,0,1.41l1.06,1.06c0.39,0.39,1.03,0.39,1.41,0s0.39-1.03,0-1.41L5.99,4.58z M18.36,16.95 c-0.39-0.39-1.03-0.39-1.41,0c-0.39,0.39-0.39,1.03,0,1.41l1.06,1.06c0.39,0.39,1.03,0.39,1.41,0c0.39-0.39,0.39-1.03,0-1.41 L18.36,16.95z M19.42,5.99c0.39-0.39,0.39-1.03,0-1.41c-0.39-0.39-1.03-0.39-1.41,0l-1.06,1.06c-0.39,0.39-0.39,1.03,0,1.41 s1.03,0.39,1.41,0L19.42,5.99z M7.05,18.36c0.39-0.39,0.39-1.03,0-1.41c-0.39-0.39-1.03-0.39-1.41,0l-1.06,1.06 c-0.39,0.39-0.39,1.03,0,1.41s1.03,0.39,1.41,0L7.05,18.36z"></path></svg><svg viewBox="0 0 24 24" width="24" height="24" aria-hidden="true" class="toggleIcon_g3eP darkToggleIcon_wfgR"><path fill="currentColor" d="M9.37,5.51C9.19,6.15,9.1,6.82,9.1,7.5c0,4.08,3.32,7.4,7.4,7.4c0.68,0,1.35-0.09,1.99-0.27C17.45,17.19,14.93,19,12,19 c-3.86,0-7-3.14-7-7C5,9.07,6.81,6.55,9.37,5.51z M12,3c-4.97,0-9,4.03-9,9s4.03,9,9,9s9-4.03,9-9c0-0.46-0.04-0.92-0.1-1.36 c-0.98,1.37-2.58,2.26-4.4,2.26c-2.98,0-5.4-2.42-5.4-5.4c0-1.81,0.89-3.42,2.26-4.4C12.92,3.04,12.46,3,12,3L12,3z"></path></svg><svg viewBox="0 0 24 24" width="24" height="24" aria-hidden="true" class="toggleIcon_g3eP systemToggleIcon_QzmC"><path fill="currentColor" d="m12 21c4.971 0 9-4.029 9-9s-4.029-9-9-9-9 4.029-9 9 4.029 9 9 9zm4.95-13.95c1.313 1.313 2.05 3.093 2.05 4.95s-0.738 3.637-2.05 4.95c-1.313 1.313-3.093 2.05-4.95 2.05v-14c1.857 0 3.637 0.737 4.95 2.05z"></path></svg></button></div><div class="navbarSearchContainer_Bca1"><div class="navbar__search"><span aria-label="expand searchbar" role="button" class="search-icon" tabindex="0"></span><input id="search_input_react" type="search" placeholder="Loading..." aria-label="Search" class="navbar__search-input search-bar" disabled=""></div></div></div></div><div role="presentation" class="navbar-sidebar__backdrop"></div></nav><div id="__docusaurus_skipToContent_fallback" class="theme-layout-main main-wrapper mainWrapper_z2l0"><main class="container margin-vert--xl"><div class="row"><div class="col col--6 col--offset-3"><h1 class="hero__title">Page Not Found</h1><p>We could not find what you were looking for.</p><p>Please contact the owner of the site that linked you to the original URL and let them know their link is broken.</p></div></div></main></div><footer class="theme-layout-footer footer footer--dark"><div class="container container-fluid"><div class="row footer__links"><div class="theme-layout-footer-column col footer__col"><div class="footer__title">Solace Agent Mesh</div><ul class="footer__items clean-list"><li class="footer__item"><a class="footer__link-item" href="/solace-agent-mesh/docs/documentation/getting-started/introduction">Documentation</a></li><li class="footer__item"><a href="https://github.com/SolaceLabs/solace-agent-mesh/" target="_blank" rel="noopener noreferrer" class="footer__link-item">GitHub<svg width="13.5" height="13.5" aria-hidden="true" class="iconExternalLink_nPIU"><use href="#theme-svg-external-link"></use></svg></a></li><li class="footer__item"><a href="https://github.com/SolaceLabs/solace-agent-mesh-core-plugins/" target="_blank" rel="noopener noreferrer" class="footer__link-item">Official Plugins<svg width="13.5" height="13.5" aria-hidden="true" class="iconExternalLink_nPIU"><use href="#theme-svg-external-link"></use></svg></a></li></ul></div><div class="theme-layout-footer-column col footer__col"><div class="footer__title">Company</div><ul class="footer__items clean-list"><li class="footer__item"><a href="https://solace.com/products/" target="_blank" rel="noopener noreferrer" class="footer__link-item">Products<svg width="13.5" height="13.5" aria-hidden="true" class="iconExternalLink_nPIU"><use href="#theme-svg-external-link"></use></svg></a></li><li class="footer__item"><a href="https://solace.com/contact/" target="_blank" rel="noopener noreferrer" class="footer__link-item">Contact<svg width="13.5" height="13.5" aria-hidden="true" class="iconExternalLink_nPIU"><use href="#theme-svg-external-link"></use></svg></a></li><li class="footer__item"><a href="https://solace.com/support/" target="_blank" rel="noopener noreferrer" class="footer__link-item">Support<svg width="13.5" height="13.5" aria-hidden="true" class="iconExternalLink_nPIU"><use href="#theme-svg-external-link"></use></svg></a></li><li class="footer__item"><a href="https://solace.com/legal/" target="_blank" rel="noopener noreferrer" class="footer__link-item">Privacy and Legal<svg width="13.5" height="13.5" aria-hidden="true" class="iconExternalLink_nPIU"><use href="#theme-svg-external-link"></use></svg></a></li></ul></div><div class="theme-layout-footer-column col footer__col"><div class="footer__title">Community</div><ul class="footer__items clean-list"><li class="footer__item"><a href="https://www.linkedin.com/company/solacedotcom/" target="_blank" rel="noopener noreferrer" class="footer__link-item">LinkedIn<svg width="13.5" height="13.5" aria-hidden="true" class="iconExternalLink_nPIU"><use href="#theme-svg-external-link"></use></svg></a></li><li class="footer__item"><a href="https://github.com/SolaceLabs" target="_blank" rel="noopener noreferrer" class="footer__link-item">GitHub<svg width="13.5" height="13.5" aria-hidden="true" class="iconExternalLink_nPIU"><use href="#theme-svg-external-link"></use></svg></a></li><li class="footer__item"><a href="https://www.youtube.com/SolaceSystems" target="_blank" rel="noopener noreferrer" class="footer__link-item">YouTube<svg width="13.5" height="13.5" aria-hidden="true" class="iconExternalLink_nPIU"><use href="#theme-svg-external-link"></use></svg></a></li><li class="footer__item"><a href="https://twitter.com/solacedotcom" target="_blank" rel="noopener noreferrer" class="footer__link-item">X<svg width="13.5" height="13.5" aria-hidden="true" class="iconExternalLink_nPIU"><use href="#theme-svg-external-link"></use></svg></a></li></ul></div></div><div class="footer__bottom text--center"><div class="margin-bottom--sm"><img src="/solace-agent-mesh/img/solace-logo.png" alt="Solace Logo" class="footer__logo themedComponent_mlkZ themedComponent--light_NVdE" width="10%" height="10%"><img src="/solace-agent-mesh/img/solace-logo.png" alt="Solace Logo" class="footer__logo themedComponent_mlkZ themedComponent--dark_xIcU" width="10%" height="10%"></div><div class="footer__copyright">Solace Agent Mesh. Copyright © 2025 Solace. Version: 1.0.1</div></div></div></footer></div>
+<script>!function(){var t=function(){try{return new URLSearchParams(window.location.search).get("docusaurus-theme")}catch(t){}}()||function(){try{return window.localStorage.getItem("theme")}catch(t){}}();document.documentElement.setAttribute("data-theme",t||(window.matchMedia("(prefers-color-scheme: dark)").matches?"dark":"light")),document.documentElement.setAttribute("data-theme-choice",t||"system")}(),function(){try{const c=new URLSearchParams(window.location.search).entries();for(var[t,e]of c)if(t.startsWith("docusaurus-data-")){var a=t.replace("docusaurus-data-","data-");document.documentElement.setAttribute(a,e)}}catch(t){}}()</script><div id="__docusaurus"><link rel="preload" as="image" href="/solace-agent-mesh/img/logo.png"><link rel="preload" as="image" href="/solace-agent-mesh/img/solace-logo.png"><div role="region" aria-label="Skip to main content"><a class="skipToContent_fXgn" href="#__docusaurus_skipToContent_fallback">Skip to main content</a></div><nav aria-label="Main" class="theme-layout-navbar navbar navbar--fixed-top"><div class="navbar__inner"><div class="theme-layout-navbar-left navbar__items"><button aria-label="Toggle navigation bar" aria-expanded="false" class="navbar__toggle clean-btn" type="button"><svg width="30" height="30" viewBox="0 0 30 30" aria-hidden="true"><path stroke="currentColor" stroke-linecap="round" stroke-miterlimit="10" stroke-width="2" d="M4 7h22M4 15h22M4 23h22"></path></svg></button><a class="navbar__brand" href="/solace-agent-mesh/docs/documentation/getting-started/introduction"><div class="navbar__logo"><img src="/solace-agent-mesh/img/logo.png" alt="Solace Agent Mesh Logo" class="themedComponent_mlkZ themedComponent--light_NVdE"><img src="/solace-agent-mesh/img/logo.png" alt="Solace Agent Mesh Logo" class="themedComponent_mlkZ themedComponent--dark_xIcU"></div><b class="navbar__title text--truncate">Solace Agent Mesh</b></a><a class="navbar__item navbar__link" href="/solace-agent-mesh/docs/documentation/getting-started/introduction">Documentation</a></div><div class="theme-layout-navbar-right navbar__items navbar__items--right"><a href="https://github.com/SolaceLabs/solace-agent-mesh/" target="_blank" rel="noopener noreferrer" class="navbar__item navbar__link">GitHub<svg width="13.5" height="13.5" aria-hidden="true" class="iconExternalLink_nPIU"><use href="#theme-svg-external-link"></use></svg></a><div class="toggle_vylO colorModeToggle_DEke"><button class="clean-btn toggleButton_gllP toggleButtonDisabled_aARS" type="button" disabled="" title="system mode" aria-label="Switch between dark and light mode (currently system mode)"><svg viewBox="0 0 24 24" width="24" height="24" aria-hidden="true" class="toggleIcon_g3eP lightToggleIcon_pyhR"><path fill="currentColor" d="M12,9c1.65,0,3,1.35,3,3s-1.35,3-3,3s-3-1.35-3-3S10.35,9,12,9 M12,7c-2.76,0-5,2.24-5,5s2.24,5,5,5s5-2.24,5-5 S14.76,7,12,7L12,7z M2,13l2,0c0.55,0,1-0.45,1-1s-0.45-1-1-1l-2,0c-0.55,0-1,0.45-1,1S1.45,13,2,13z M20,13l2,0c0.55,0,1-0.45,1-1 s-0.45-1-1-1l-2,0c-0.55,0-1,0.45-1,1S19.45,13,20,13z M11,2v2c0,0.55,0.45,1,1,1s1-0.45,1-1V2c0-0.55-0.45-1-1-1S11,1.45,11,2z M11,20v2c0,0.55,0.45,1,1,1s1-0.45,1-1v-2c0-0.55-0.45-1-1-1C11.45,19,11,19.45,11,20z M5.99,4.58c-0.39-0.39-1.03-0.39-1.41,0 c-0.39,0.39-0.39,1.03,0,1.41l1.06,1.06c0.39,0.39,1.03,0.39,1.41,0s0.39-1.03,0-1.41L5.99,4.58z M18.36,16.95 c-0.39-0.39-1.03-0.39-1.41,0c-0.39,0.39-0.39,1.03,0,1.41l1.06,1.06c0.39,0.39,1.03,0.39,1.41,0c0.39-0.39,0.39-1.03,0-1.41 L18.36,16.95z M19.42,5.99c0.39-0.39,0.39-1.03,0-1.41c-0.39-0.39-1.03-0.39-1.41,0l-1.06,1.06c-0.39,0.39-0.39,1.03,0,1.41 s1.03,0.39,1.41,0L19.42,5.99z M7.05,18.36c0.39-0.39,0.39-1.03,0-1.41c-0.39-0.39-1.03-0.39-1.41,0l-1.06,1.06 c-0.39,0.39-0.39,1.03,0,1.41s1.03,0.39,1.41,0L7.05,18.36z"></path></svg><svg viewBox="0 0 24 24" width="24" height="24" aria-hidden="true" class="toggleIcon_g3eP darkToggleIcon_wfgR"><path fill="currentColor" d="M9.37,5.51C9.19,6.15,9.1,6.82,9.1,7.5c0,4.08,3.32,7.4,7.4,7.4c0.68,0,1.35-0.09,1.99-0.27C17.45,17.19,14.93,19,12,19 c-3.86,0-7-3.14-7-7C5,9.07,6.81,6.55,9.37,5.51z M12,3c-4.97,0-9,4.03-9,9s4.03,9,9,9s9-4.03,9-9c0-0.46-0.04-0.92-0.1-1.36 c-0.98,1.37-2.58,2.26-4.4,2.26c-2.98,0-5.4-2.42-5.4-5.4c0-1.81,0.89-3.42,2.26-4.4C12.92,3.04,12.46,3,12,3L12,3z"></path></svg><svg viewBox="0 0 24 24" width="24" height="24" aria-hidden="true" class="toggleIcon_g3eP systemToggleIcon_QzmC"><path fill="currentColor" d="m12 21c4.971 0 9-4.029 9-9s-4.029-9-9-9-9 4.029-9 9 4.029 9 9 9zm4.95-13.95c1.313 1.313 2.05 3.093 2.05 4.95s-0.738 3.637-2.05 4.95c-1.313 1.313-3.093 2.05-4.95 2.05v-14c1.857 0 3.637 0.737 4.95 2.05z"></path></svg></button></div><div class="navbarSearchContainer_Bca1"><div class="navbar__search"><span aria-label="expand searchbar" role="button" class="search-icon" tabindex="0"></span><input id="search_input_react" type="search" placeholder="Loading..." aria-label="Search" class="navbar__search-input search-bar" disabled=""></div></div></div></div><div role="presentation" class="navbar-sidebar__backdrop"></div></nav><div id="__docusaurus_skipToContent_fallback" class="theme-layout-main main-wrapper mainWrapper_z2l0"><main class="container margin-vert--xl"><div class="row"><div class="col col--6 col--offset-3"><h1 class="hero__title">Page Not Found</h1><p>We could not find what you were looking for.</p><p>Please contact the owner of the site that linked you to the original URL and let them know their link is broken.</p></div></div></main></div><footer class="theme-layout-footer footer footer--dark"><div class="container container-fluid"><div class="row footer__links"><div class="theme-layout-footer-column col footer__col"><div class="footer__title">Solace Agent Mesh</div><ul class="footer__items clean-list"><li class="footer__item"><a class="footer__link-item" href="/solace-agent-mesh/docs/documentation/getting-started/introduction">Documentation</a></li><li class="footer__item"><a href="https://github.com/SolaceLabs/solace-agent-mesh/" target="_blank" rel="noopener noreferrer" class="footer__link-item">GitHub<svg width="13.5" height="13.5" aria-hidden="true" class="iconExternalLink_nPIU"><use href="#theme-svg-external-link"></use></svg></a></li><li class="footer__item"><a href="https://github.com/SolaceLabs/solace-agent-mesh-core-plugins/" target="_blank" rel="noopener noreferrer" class="footer__link-item">Official Plugins<svg width="13.5" height="13.5" aria-hidden="true" class="iconExternalLink_nPIU"><use href="#theme-svg-external-link"></use></svg></a></li></ul></div><div class="theme-layout-footer-column col footer__col"><div class="footer__title">Company</div><ul class="footer__items clean-list"><li class="footer__item"><a href="https://solace.com/products/" target="_blank" rel="noopener noreferrer" class="footer__link-item">Products<svg width="13.5" height="13.5" aria-hidden="true" class="iconExternalLink_nPIU"><use href="#theme-svg-external-link"></use></svg></a></li><li class="footer__item"><a href="https://solace.com/contact/" target="_blank" rel="noopener noreferrer" class="footer__link-item">Contact<svg width="13.5" height="13.5" aria-hidden="true" class="iconExternalLink_nPIU"><use href="#theme-svg-external-link"></use></svg></a></li><li class="footer__item"><a href="https://solace.com/support/" target="_blank" rel="noopener noreferrer" class="footer__link-item">Support<svg width="13.5" height="13.5" aria-hidden="true" class="iconExternalLink_nPIU"><use href="#theme-svg-external-link"></use></svg></a></li><li class="footer__item"><a href="https://solace.com/legal/" target="_blank" rel="noopener noreferrer" class="footer__link-item">Privacy and Legal<svg width="13.5" height="13.5" aria-hidden="true" class="iconExternalLink_nPIU"><use href="#theme-svg-external-link"></use></svg></a></li></ul></div><div class="theme-layout-footer-column col footer__col"><div class="footer__title">Community</div><ul class="footer__items clean-list"><li class="footer__item"><a href="https://www.linkedin.com/company/solacedotcom/" target="_blank" rel="noopener noreferrer" class="footer__link-item">LinkedIn<svg width="13.5" height="13.5" aria-hidden="true" class="iconExternalLink_nPIU"><use href="#theme-svg-external-link"></use></svg></a></li><li class="footer__item"><a href="https://github.com/SolaceLabs" target="_blank" rel="noopener noreferrer" class="footer__link-item">GitHub<svg width="13.5" height="13.5" aria-hidden="true" class="iconExternalLink_nPIU"><use href="#theme-svg-external-link"></use></svg></a></li><li class="footer__item"><a href="https://www.youtube.com/SolaceSystems" target="_blank" rel="noopener noreferrer" class="footer__link-item">YouTube<svg width="13.5" height="13.5" aria-hidden="true" class="iconExternalLink_nPIU"><use href="#theme-svg-external-link"></use></svg></a></li><li class="footer__item"><a href="https://twitter.com/solacedotcom" target="_blank" rel="noopener noreferrer" class="footer__link-item">X<svg width="13.5" height="13.5" aria-hidden="true" class="iconExternalLink_nPIU"><use href="#theme-svg-external-link"></use></svg></a></li></ul></div></div><div class="footer__bottom text--center"><div class="margin-bottom--sm"><img src="/solace-agent-mesh/img/solace-logo.png" alt="Solace Logo" class="footer__logo themedComponent_mlkZ themedComponent--light_NVdE" width="10%" height="10%"><img src="/solace-agent-mesh/img/solace-logo.png" alt="Solace Logo" class="footer__logo themedComponent_mlkZ themedComponent--dark_xIcU" width="10%" height="10%"></div><div class="footer__copyright">Solace Agent Mesh. Copyright © 2025 Solace. Version: 1.0.2</div></div></div></footer></div>
 </body>
 </html>