PyPI - solace-agent-mesh - Versions diffs - 1.0.2__py3-none-any.whl → 1.0.5__py3-none-any.whl - Mend

solace-agent-mesh 1.0.2py3-none-any.whl → 1.0.5py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Potentially problematic release.

This version of solace-agent-mesh might be problematic. Click here for more details.

Files changed (98) hide show

solace_agent_mesh/config_portal/frontend/static/client/assets/{manifest-e5c3acfe.js → manifest-950eb3be.js} RENAMED Viewed

	@@ -1 +1 @@
1	- window.__remixManifest={"entry":{"module":"/assets/entry.client-CEumGClk.js","imports":["/assets/index-DSo1AH_7.js","/assets/components-B7lKcHVY.js"],"css":[]},"routes":{"root":{"id":"root","path":"","hasAction":false,"hasLoader":false,"hasClientAction":false,"hasClientLoader":false,"hasErrorBoundary":false,"module":"/assets/root-C4XmHinv.js","imports":["/assets/index-DSo1AH_7.js","/assets/components-B7lKcHVY.js"],"css":["/assets/root-DxRwaWiE.css"]},"routes/_index":{"id":"routes/_index","parentId":"root","index":true,"hasAction":false,"hasLoader":false,"hasClientAction":false,"hasClientLoader":false,"hasErrorBoundary":false,"module":"/assets/_index-~~_7yox_eh~~.js","imports":["/assets/index-DSo1AH_7.js"],"css":[]}},"url":"/assets/manifest-~~e5c3acfe~~.js","version":"~~e5c3acfe~~"};
1	+ window.__remixManifest={"entry":{"module":"/assets/entry.client-CEumGClk.js","imports":["/assets/index-DSo1AH_7.js","/assets/components-B7lKcHVY.js"],"css":[]},"routes":{"root":{"id":"root","path":"","hasAction":false,"hasLoader":false,"hasClientAction":false,"hasClientLoader":false,"hasErrorBoundary":false,"module":"/assets/root-C4XmHinv.js","imports":["/assets/index-DSo1AH_7.js","/assets/components-B7lKcHVY.js"],"css":["/assets/root-DxRwaWiE.css"]},"routes/_index":{"id":"routes/_index","parentId":"root","index":true,"hasAction":false,"hasLoader":false,"hasClientAction":false,"hasClientLoader":false,"hasErrorBoundary":false,"module":"/assets/_index-xSu2leR8.js","imports":["/assets/index-DSo1AH_7.js"],"css":[]}},"url":"/assets/manifest-950eb3be.js","version":"950eb3be"};

solace_agent_mesh/config_portal/frontend/static/client/index.html CHANGED Viewed

@@ -1,5 +1,5 @@
 <!DOCTYPE html>
-<html lang="en"><head><meta charSet="utf-8"/><meta name="viewport" content="width=device-width, initial-scale=1"/><link rel="stylesheet" href="/assets/root-DxRwaWiE.css"/><link rel="preconnect" href="https://fonts.googleapis.com"/><link rel="preconnect" href="https://fonts.gstatic.com" crossorigin="anonymous"/><link rel="stylesheet" href="https://fonts.googleapis.com/css2?family=Inter:ital,opsz,wght@0,14..32,100..900;1,14..32,100..900&amp;display=swap"/></head><body><p>Loading...</p><link rel="modulepreload" href="/assets/manifest-e5c3acfe.js"/><link rel="modulepreload" href="/assets/entry.client-CEumGClk.js"/><link rel="modulepreload" href="/assets/index-DSo1AH_7.js"/><link rel="modulepreload" href="/assets/components-B7lKcHVY.js"/><link rel="modulepreload" href="/assets/root-C4XmHinv.js"/><script>window.__remixContext = {"basename":"/","future":{"v3_fetcherPersist":false,"v3_relativeSplatPath":false,"v3_throwAbortReason":false,"v3_routeConfig":false,"v3_singleFetch":false,"v3_lazyRouteDiscovery":false,"unstable_optimizeDeps":false},"isSpaMode":true,"state":{"loaderData":{"root":null,"routes/_index":null},"actionData":null,"errors":null}};</script><script type="module" async="">import "/assets/manifest-e5c3acfe.js";
+<html lang="en"><head><meta charSet="utf-8"/><meta name="viewport" content="width=device-width, initial-scale=1"/><link rel="stylesheet" href="/assets/root-DxRwaWiE.css"/><link rel="preconnect" href="https://fonts.googleapis.com"/><link rel="preconnect" href="https://fonts.gstatic.com" crossorigin="anonymous"/><link rel="stylesheet" href="https://fonts.googleapis.com/css2?family=Inter:ital,opsz,wght@0,14..32,100..900;1,14..32,100..900&amp;display=swap"/></head><body><p>Loading...</p><link rel="modulepreload" href="/assets/manifest-950eb3be.js"/><link rel="modulepreload" href="/assets/entry.client-CEumGClk.js"/><link rel="modulepreload" href="/assets/index-DSo1AH_7.js"/><link rel="modulepreload" href="/assets/components-B7lKcHVY.js"/><link rel="modulepreload" href="/assets/root-C4XmHinv.js"/><script>window.__remixContext = {"basename":"/","future":{"v3_fetcherPersist":false,"v3_relativeSplatPath":false,"v3_throwAbortReason":false,"v3_routeConfig":false,"v3_singleFetch":false,"v3_lazyRouteDiscovery":false,"unstable_optimizeDeps":false},"isSpaMode":true,"state":{"loaderData":{"root":null,"routes/_index":null},"actionData":null,"errors":null}};</script><script type="module" async="">import "/assets/manifest-950eb3be.js";
 import * as route0 from "/assets/root-C4XmHinv.js";
 window.__remixRouteModules = {"root":route0};

solace_agent_mesh/gateway/base/component.py CHANGED Viewed

@@ -65,7 +65,9 @@ from solace_ai_connector.common.event import Event, EventType
 from abc import abstractmethod
 from ...common.middleware.registry import MiddlewareRegistry
-from ...agent.utils.artifact_helpers import load_artifact_content_or_metadata
+from ...agent.utils.artifact_helpers import (
+    load_artifact_content_or_metadata,
+)
 info = {
     "class_name": "BaseGatewayComponent",
@@ -157,6 +159,7 @@ class BaseGatewayComponent(ComponentBase):
         self.shared_artifact_service: Optional[BaseArtifactService] = (
             initialize_artifact_service(self)
         )
         self.task_context_manager: TaskContextManager = TaskContextManager()
         self.internal_event_queue: queue.Queue = queue.Queue()
         self.message_processor_thread: Optional[threading.Thread] = None
@@ -340,7 +343,17 @@ class BaseGatewayComponent(ComponentBase):
             )
             external_request_context["a2a_session_id"] = a2a_session_id
-        a2a_message = A2AMessage(role="user", parts=a2a_parts)
+        a2a_metadata = {}
+        invoked_artifacts = external_request_context.get("invoked_with_artifacts")
+        if invoked_artifacts:
+            a2a_metadata["invoked_with_artifacts"] = invoked_artifacts
+            log.debug(
+                "%s Found %d artifact identifiers in external context to pass to agent.",
+                log_id_prefix,
+                len(invoked_artifacts),
+            )
+        a2a_message = A2AMessage(role="user", parts=a2a_parts, metadata=a2a_metadata)
         reply_topic_pattern = get_gateway_response_topic(
             self.namespace, self.gateway_id, "{task_id}"
         )

solace_agent_mesh/gateway/http_sse/sse_manager.py CHANGED Viewed

@@ -6,6 +6,8 @@ import asyncio
 import threading
 from typing import Dict, List, Any
 import json
+import datetime
+import math
 from solace_ai_connector.common.log import log
@@ -46,6 +48,23 @@ class SSEManager:
                 )
             return self._locks[current_loop]
+    def _sanitize_json(self, obj):
+        if isinstance(obj, dict):
+            return {k: self._sanitize_json(v) for k, v in obj.items()}
+        elif isinstance(obj, list):
+            return [self._sanitize_json(v) for v in obj]
+        elif isinstance(obj, (float, int)):
+            if math.isnan(obj) or math.isinf(obj):
+                return None
+            return obj
+        elif isinstance(obj, (str, bool, type(None))):
+            return obj
+        elif isinstance(obj, (datetime.datetime, datetime.date)):
+            return obj.isoformat()
+        else:
+            return str(obj)
     async def create_sse_connection(self, task_id: str) -> asyncio.Queue:
         """
         Creates a new queue for an SSE connection subscribing to a task.
@@ -136,7 +155,10 @@ class SSEManager:
             queues_to_remove = []
             try:
-                serialized_data = json.dumps(event_data)
+                serialized_data = json.dumps(
+                    self._sanitize_json(event_data),
+                    allow_nan=False
+                )
             except Exception as json_err:
                 log.error(
                     "%s Failed to JSON serialize event data for Task ID %s: %s",

solace_agent_mesh/templates/plugin_agent_config_template.yaml CHANGED Viewed

@@ -102,7 +102,7 @@ apps:
       session_service: *default_session_service
       artifact_service: *default_artifact_service
-      artifact_handling_mode: "embed"
+      artifact_handling_mode: "reference"
       enable_embed_resolution: true
       enable_artifact_content_instruction: true

{solace_agent_mesh-1.0.2.dist-info → solace_agent_mesh-1.0.5.dist-info}/METADATA RENAMED Viewed

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: solace-agent-mesh
-Version: 1.0.2
+Version: 1.0.5
 Summary: Solace Agent Mesh is an open-source framework for building event-driven, multi-agent AI systems where specialized agents collaborate on complex tasks.
 Project-URL: Homepage, https://github.com/SolaceLabs/solace-agent-mesh
 Project-URL: Repository, https://github.com/SolaceLabs/solace-agent-mesh
@@ -257,10 +257,6 @@ Requires-Dist: prompt-toolkit>=3.0; extra == 'cli'
 Requires-Dist: rich>=13.0; extra == 'cli'
 Provides-Extra: database
 Requires-Dist: sqlalchemy>=2.0; extra == 'database'
-Provides-Extra: dev
-Requires-Dist: pytest-asyncio>=0.20; extra == 'dev'
-Requires-Dist: pytest>=7.0; extra == 'dev'
-Requires-Dist: ruff; extra == 'dev'
 Provides-Extra: employee-tools
 Requires-Dist: holidays>=0.24; extra == 'employee-tools'
 Provides-Extra: gcs
@@ -300,30 +296,33 @@ Description-Content-Type: text/markdown
 ---
-The Solace Agent Mesh transforms how AI agents work together, creating a dynamic ecosystem where specialized agents communicate seamlessly, share information, and collaborate on complex tasks.
+**Solace Agent Mesh** is a framework that supports building AI applications where multiple specialized AI agents work together to solve complex problems. It uses the event messaging of [Solace Platform](https://solace.com) for true scalability and reliability.
-Built on Solace PubSub+ Event Broker, this framework provides a robust foundation for enterprise-grade AI solutions that scale effortlessly. The mesh creates a standardized communication layer where AI agents can:
+With Solace Agent Mesh (SAM), you can create teams of AI agents, each having distinct skills and access to specific tools. For example, you could have a Database Agent that can make SQL queries to fetch data or a MultiModal Agent that can help create images, audio files and reports.
-* Delegate specialized tasks to peer agents
-* Share artifacts and data across the network
+The framework handles the communication between agents automatically, so you can focus on building great AI experiences.
+SAM creates a standardized communication layer where AI agents can:
+* Delegate tasks to peer agents
+* Share data and artifacts
 * Connect with diverse user interfaces and external systems
-* Execute complex, multi-step workflows with minimal coupling
+* Execute multi-step workflows with minimal coupling
+SAM is built on top of the Solace AI Connector (SAC) which allows Solace Platform Event Brokers to connect to AI models and services and Google's Agent Development Kit (ADK) for AI logic and tool integrations.
-Under the hood, the framework combines the Solace AI Connector (SAC) for runtime orchestration with Google's Agent Development Kit (ADK) for agent logic, LLM interaction, and tool execution—all communicating via the A2A protocol over Solace's event mesh. The result? A fully asynchronous, event-driven, and decoupled AI agent architecture ready for enterprise deployment.
+The result? A fully asynchronous, event-driven and decoupled AI agent architecture ready for production deployment. It is robust, reliable and easy to maintain.
 ---
-## ✨ Key Features
-- ⚙️ **[Modular, Event-Driven Architecture](https://solacelabs.github.io/solace-agent-mesh/docs/documentation/getting-started/component-overview)** – All components communicate via events through a central event mesh, enabling loose coupling and high scalability.
-- 🤖 **[Composable Agents](https://solacelabs.github.io/solace-agent-mesh/docs/documentation/concepts/agents)** – Combine specialized AI agents to solve complex, multi-step workflows.
-- 🌐 **[Flexible Interfaces](https://solacelabs.github.io/solace-agent-mesh/docs/documentation/concepts/gateways)** – Interact with SAM via the REST API, browser UI, [Slack](https://solacelabs.github.io/solace-agent-mesh/docs/documentation/tutorials/slack-integration), etc.
-- 🧠 **[Orchestration Agent](https://solacelabs.github.io/solace-agent-mesh/docs/documentation/concepts/orchestrator)** – Tasks are automatically broken down and delegated across agents by the orchestrator agent.
-- 🧩 **[Plugin-Extensible](https://solacelabs.github.io/solace-agent-mesh/docs/documentation/concepts/plugins)** – Add your own agents, gateways, or services with minimal boilerplate.
-- 🏢 **[Production-Ready](https://solacelabs.github.io/solace-agent-mesh/docs/documentation/deployment/deploy)** – Backed by [Solace's enterprise-grade event broker](https://solace.com/products/event-broker/) for reliability and performance.
-- 📁 **[File Management](https://solacelabs.github.io/solace-agent-mesh/docs/documentation/user-guide/builtin-tools/artifact-management)** – Built-in tools for managing file artifacts with automatic metadata injection and artifact handling.
-- 📊 **[Data Analysis Tools](https://solacelabs.github.io/solace-agent-mesh/docs/documentation/user-guide/builtin-tools/data-analysis-tools)** – Built-in tools for SQL queries, JQ transformations, and Plotly chart generation.
-- 🔗 **[Dynamic Embeds](https://solacelabs.github.io/solace-agent-mesh/docs/documentation/user-guide/builtin-tools/embeds)** – Include dynamic placeholders in responses that are resolved by the framework with support for modifier chains.
-- 🤝 **[Agent-to-Agent Communication](https://solacelabs.github.io/solace-agent-mesh/docs/documentation/concepts/architecture)** – Agents can discover and delegate tasks to peer agents using the A2A protocol over Solace.
+## 🔑 Key Features
+- **[Multi-Agent Event-Driven Architecture](https://solacelabs.github.io/solace-agent-mesh/docs/documentation/getting-started/component-overview)** – Agents communicate via the Solace Event Mesh for true scalability
+- **[Agent Orchestration](https://solacelabs.github.io/solace-agent-mesh/docs/documentation/concepts/agents)** – Complex tasks are automatically broken down and delegated by the [Orchestrator](https://solacelabs.github.io/solace-agent-mesh/docs/documentation/concepts/orchestrator) agent
+- **[Flexible Interfaces](https://solacelabs.github.io/solace-agent-mesh/docs/documentation/concepts/gateways)** – Integrate with REST API, web UI, [Slack](https://solacelabs.github.io/solace-agent-mesh/docs/documentation/tutorials/slack-integration), or build your own integration
+- **[Extensible](https://solacelabs.github.io/solace-agent-mesh/docs/documentation/concepts/plugins)** – Add your own agents, gateways, or services with minimal code
+- **[Agent-to-Agent Communication](https://solacelabs.github.io/solace-agent-mesh/docs/documentation/concepts/architecture)** – Agents can discover and delegate tasks to each other seamlessly using the Agent2Agent (A2A) Protocol
+- **[Dynamic Embeds](https://solacelabs.github.io/solace-agent-mesh/docs/documentation/user-guide/builtin-tools/embeds)** – Embed dynamic content like real-time data, calculations and file contents in responses
+📚 **Want to know more?** Check out the full Solace Agent Mesh [documentation](https://solacelabs.github.io/solace-agent-mesh/docs/documentation/getting-started/introduction/).
 ---
@@ -342,39 +341,53 @@ To run Solace Agent Mesh locally, you'll need:
 ### 💻 Setup Steps
+#### 1. Create a directory for a new project
 ```bash
-# 1. (Optional) Create and activate a Python virtual environment
-python3 -m venv .venv
-source .venv/bin/activate
-# 2. Install the Solace Agent Mesh
-pip install solace-agent-mesh
+mkdir my-sam && cd my-sam
+```
+#### 2. Create and activate a Python virtual environment
+```bash
+python3 -m venv .venv && source .venv/bin/activate
+```
+#### 3. Install Solace Agent Mesh (SAM)
+Check if you have a version of SAM already installed.
+```bash
+sam -v
+```
+If you have an earlier version, uninstall it and **start from scratch**:
+```bash
+pip3 uninstall solace-agent-mesh
+```
+Note: Optionally, you can try to upgrade versions but this action is not officially supported at this time. (`pip3 install --upgrade solace-agent-mesh`)
-# 3. Initialize a new project with web-based setup
-mkdir my-agent-mesh && cd my-agent-mesh
+If no previous version exists, install the latest version with:
+```bash
+pip3 install solace-agent-mesh
+```
+#### 4. Initialize the new project via a GUI interface
+```bash
 sam init --gui
-# 4. Run the project
+```
+Note: This initialization UI runs on port 5002
+#### 5. Run the project
+```bash
 sam run
 ```
+#### 6. Verify SAM is running
+Open the Web UI at [http://localhost:8000](http://localhost:8000) for the chat inteface and ask a question
-### 🔧 Adding Agents
+### 🔧 Customize SAM
+#### New agents can be added via a GUI interface
 ```bash
-# Add a new agent with GUI interface
 sam add agent --gui
 ```
-Or install an existing plugin:
+#### Existing plugins can be installed
 ```bash
 sam plugin add <your-component-name> --plugin <plugin-name>
 ```
-#### Once running:
-Open the Web UI at [http://localhost:8000](http://localhost:8000) to talk with a chat interface.
 ---
 ## 🏗️ Architecture Overview
@@ -385,7 +398,7 @@ The system allows you to:
 - Host AI agents developed with Google ADK within the SAC framework
 - Define agent capabilities (LLM model, instructions, tools) primarily through SAC YAML configuration
-- Utilize Solace PubSub+ as the transport for standard Agent-to-Agent (A2A) protocol communication
+- Use Solace Platform as the transport for standard Agent-to-Agent (A2A) protocol communication
 - Enable dynamic discovery of peer agents running within the same ecosystem
 - Allow agents to delegate tasks to discovered peers via the A2A protocol over Solace
 - Manage file artifacts using built-in tools with automatic metadata injection
@@ -413,20 +426,24 @@ Want to go further? Here are some hands-on tutorials to help you get started:
 | 🧠 **MCP Integration**<br>Integrating a Model Context Protocol (MCP) Servers into Solace Agent Mesh. | **~10–15 min** | [MCP Integration Tutorial](https://solacelabs.github.io/solace-agent-mesh/docs/documentation/tutorials/mcp-integration) |
 | 💬 **Slack Integration**<br>Chat with Solace Agent Mesh directly from Slack. | **~20–30 min** | [Slack Integration Tutorial](https://solacelabs.github.io/solace-agent-mesh/docs/documentation/tutorials/slack-integration) |
-📚 Want to explore more? Check out the full [Solace Agent Mesh documentation](https://solacelabs.github.io/solace-agent-mesh/docs/documentation/getting-started/introduction/).
 ---
 ## 👥 Contributors
-Solace Agent Mesh is built with the help of our amazing community.
-Thanks to everyone who has contributed ideas, code, and time to make this project better.
-👀 View the full list of contributors → [GitHub Contributors](https://github.com/SolaceLabs/solace-agent-mesh/graphs/contributors)
-🤝 **Looking to contribute?** Check out [CONTRIBUTING.md](CONTRIBUTING.md) to get started and see how you can help.
+Solace Agent Mesh is built with the help of our amazing community. Thanks to everyone who has contributed ideas, code and time to make this project better!
+View the full list of contributors here: [GitHub Contributors](https://github.com/SolaceLabs/solace-agent-mesh/graphs/contributors) 💚
+**Looking to contribute?** Check out [CONTRIBUTING.md](CONTRIBUTING.md) to get started and see how you can help!
 ---
 ## 📄 License
-This project is licensed under the **Apache 2.0 License**.
-See the full license text in the [LICENSE](LICENSE) file.
+This project is licensed under the **Apache 2.0 License**. See the full license text in the [LICENSE](LICENSE) file.
+---
+<h3 align="center">
+  <img src="./docs/static/img/solace-logo-text.svg" alt="Solace Agent Mesh Logo" width="100"/>
+</h3>

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

Potentially problematic release.

solace-agent-mesh 1.0.2py3-none-any.whl → 1.0.5py3-none-any.whl