solace-agent-mesh 1.5.0__py3-none-any.whl → 1.6.0__py3-none-any.whl

solace_agent_mesh/gateway/http_sse/services/task_service.py

@@ -3,15 +3,16 @@ Service layer for handling A2A task submissions and cancellations.
 Uses CoreA2AService for logic and a provided function for publishing.
 """
 
+import logging
 import threading
 from typing import Callable, Dict, Optional
 
-from solace_ai_connector.common.log import log
-
 from ....common import a2a
 from ....gateway.http_sse.sse_manager import SSEManager
 from ....core_a2a.service import CoreA2AService
 
+log = logging.getLogger(__name__)
+
 PublishFunc = Callable[[str, Dict, Optional[Dict]], None]
 
 

solace_agent_mesh/gateway/http_sse/session_manager.py

@@ -2,13 +2,14 @@
 Manages web user sessions and mapping to A2A Client IDs.
 """
 
+import logging
 import uuid
 from collections.abc import Callable
 from typing import Any
 
-from solace_ai_connector.common.log import log
 from starlette.requests import Request
 
+log = logging.getLogger(__name__)
 
 SESSION_KEY_CLIENT_ID = "a2a_client_id"
 SESSION_KEY_SESSION_ID = "a2a_session_id"

solace_agent_mesh/gateway/http_sse/shared/base_repository.py

@@ -6,16 +6,15 @@ for database session management and transaction handling.
 """
 
 from abc import ABC, abstractmethod
-from typing import Dict, Any, List, Optional, TypeVar, Generic, Type
+from typing import Any, Generic, TypeVar
+
 from sqlalchemy.orm import Session
-from sqlalchemy.exc import NoResultFound
-from .exceptions import EntityNotFoundError, ValidationError
-from .types import PaginationInfo
 
+from .exceptions import EntityNotFoundError
 
-T = TypeVar('T')
-ModelType = TypeVar('ModelType')
-EntityType = TypeVar('EntityType')
+T = TypeVar("T")
+ModelType = TypeVar("ModelType")
+EntityType = TypeVar("EntityType")
 
 
 class BaseRepository(ABC, Generic[ModelType, EntityType]):
@@ -27,7 +26,7 @@ class BaseRepository(ABC, Generic[ModelType, EntityType]):
     transactions should be handled at the service/API layer.
     """
 
-    def __init__(self, model_class: Type[ModelType], entity_class: Type[EntityType]):
+    def __init__(self, model_class: type[ModelType], entity_class: type[EntityType]):
         """
         Initialize repository with model and entity classes.
 
@@ -44,7 +43,7 @@ class BaseRepository(ABC, Generic[ModelType, EntityType]):
         """Return the entity name for error messages."""
         pass
 
-    def create(self, session: Session, create_data: Dict[str, Any]) -> EntityType:
+    def create(self, session: Session, create_data: dict[str, Any]) -> EntityType:
         """
         Create a new entity.
 
@@ -83,16 +82,20 @@ class BaseRepository(ABC, Generic[ModelType, EntityType]):
         Raises:
             EntityNotFoundError: If entity not found
         """
-        model_instance = session.query(self.model_class).filter(
-            self.model_class.id == str(entity_id)
-        ).first()
+        model_instance = (
+            session.query(self.model_class)
+            .filter(self.model_class.id == str(entity_id))
+            .first()
+        )
 
         if not model_instance:
             raise EntityNotFoundError(self.entity_name, entity_id)
 
         return self.entity_class.model_validate(model_instance)
 
-    def get_all(self, session: Session, limit: Optional[int] = None, offset: Optional[int] = None) -> List[EntityType]:
+    def get_all(
+        self, session: Session, limit: int | None = None, offset: int | None = None
+    ) -> list[EntityType]:
         """
         Get all entities with optional pagination.
 
@@ -112,9 +115,13 @@ class BaseRepository(ABC, Generic[ModelType, EntityType]):
             query = query.limit(limit)
 
         model_instances = query.all()
-        return [self.entity_class.model_validate(instance) for instance in model_instances]
+        return [
+            self.entity_class.model_validate(instance) for instance in model_instances
+        ]
 
-    def update(self, session: Session, entity_id: Any, update_data: Dict[str, Any]) -> EntityType:
+    def update(
+        self, session: Session, entity_id: Any, update_data: dict[str, Any]
+    ) -> EntityType:
         """
         Update an entity.
 
@@ -129,9 +136,11 @@ class BaseRepository(ABC, Generic[ModelType, EntityType]):
         Raises:
             EntityNotFoundError: If entity not found
         """
-        model_instance = session.query(self.model_class).filter(
-            self.model_class.id == str(entity_id)
-        ).first()
+        model_instance = (
+            session.query(self.model_class)
+            .filter(self.model_class.id == str(entity_id))
+            .first()
+        )
 
         if not model_instance:
             raise EntityNotFoundError(self.entity_name, entity_id)
@@ -158,9 +167,11 @@ class BaseRepository(ABC, Generic[ModelType, EntityType]):
         Raises:
             EntityNotFoundError: If entity not found
         """
-        model_instance = session.query(self.model_class).filter(
-            self.model_class.id == str(entity_id)
-        ).first()
+        model_instance = (
+            session.query(self.model_class)
+            .filter(self.model_class.id == str(entity_id))
+            .first()
+        )
 
         if not model_instance:
             raise EntityNotFoundError(self.entity_name, entity_id)
@@ -179,9 +190,11 @@ class BaseRepository(ABC, Generic[ModelType, EntityType]):
         Returns:
             True if entity exists, False otherwise
         """
-        count = session.query(self.model_class).filter(
-            self.model_class.id == str(entity_id)
-        ).count()
+        count = (
+            session.query(self.model_class)
+            .filter(self.model_class.id == str(entity_id))
+            .count()
+        )
 
         return count > 0
 
@@ -200,52 +213,13 @@ class BaseRepository(ABC, Generic[ModelType, EntityType]):
 
 class PaginatedRepository(BaseRepository[ModelType, EntityType]):
     """
-    Base repository with enhanced pagination support.
-    """
-
-    def get_paginated(self, session: Session, page_number: int, page_size: int) -> tuple[List[EntityType], int]:
-        """
-        Get paginated results.
-
-        Args:
-            session: Database session
-            page_number: Page number (1-based)
-            page_size: Number of items per page
-
-        Returns:
-            Tuple of (entities, total_count)
-        """
-        offset = (page_number - 1) * page_size
+    Base repository with pagination support.
 
-        total_count = self.count(session)
-
-        entities = self.get_all(session, limit=page_size, offset=offset)
-
-        return entities, total_count
-
-    def get_paginated_with_info(self, session: Session, pagination: PaginationInfo) -> tuple[List[EntityType], PaginationInfo]:
-        """
-        Get paginated results with complete pagination info.
-
-        Args:
-            session: Database session
-            pagination: Pagination parameters
-
-        Returns:
-            Tuple of (entities, updated_pagination_info)
-        """
-        entities, total_count = self.get_paginated(session, pagination.page, pagination.page_size)
-
-        updated_pagination = PaginationInfo(
-            page=pagination.page,
-            page_size=pagination.page_size,
-            total_items=total_count,
-            total_pages=(total_count + pagination.page_size - 1) // pagination.page_size,
-            has_next=pagination.page * pagination.page_size < total_count,
-            has_previous=pagination.page > 1
-        )
+    Concrete repositories should implement their own pagination methods
+    that apply specific filters and ordering before pagination.
+    """
 
-        return entities, updated_pagination
+    pass
 
 
 class ValidationMixin:
@@ -253,7 +227,7 @@ class ValidationMixin:
     Mixin for repositories that need validation logic.
     """
 
-    def validate_create_data(self, create_data: Dict[str, Any]) -> None:
+    def validate_create_data(self, create_data: dict[str, Any]) -> None:
         """
         Validate data before creation.
 
@@ -265,7 +239,7 @@ class ValidationMixin:
         """
         pass
 
-    def validate_update_data(self, update_data: Dict[str, Any]) -> None:
+    def validate_update_data(self, update_data: dict[str, Any]) -> None:
         """
         Validate data before update.
 
@@ -275,4 +249,4 @@ class ValidationMixin:
         Raises:
             ValidationError: If validation fails
         """
-        pass
+        pass

solace_agent_mesh/gateway/http_sse/shared/types.py

@@ -35,24 +35,6 @@ class LegacyTimestamp(BaseModel):
     updated_at: datetime | None = None
 
 
-class PaginationParams(BaseModel):
-    """Pagination parameters for list requests."""
-
-    page: int
-    page_size: int
-
-
-class PaginationInfo(BaseModel):
-    """Pagination information for list responses."""
-
-    page: int
-    page_size: int
-    total_items: int
-    total_pages: int
-    has_next: bool
-    has_previous: bool
-
-
 class SortInfo(BaseModel):
     """Sorting information for list requests."""
 

solace_agent_mesh/gateway/http_sse/sse_event_buffer.py

@@ -2,11 +2,12 @@
 A thread-safe buffer for holding early SSE events before a client connects.
 """
 
+import logging
 import datetime
 import threading
 from typing import Any, Dict, List, Optional, Tuple
 
-from solace_ai_connector.common.log import log
+log = logging.getLogger(__name__)
 
 
 class SSEEventBuffer:

solace_agent_mesh/gateway/http_sse/sse_manager.py

@@ -2,6 +2,7 @@
 Manages Server-Sent Event (SSE) connections for streaming task updates.
 """
 
+import logging
 import asyncio
 import threading
 from typing import Dict, List, Any
@@ -9,10 +10,9 @@ import json
 import datetime
 import math
 
-from solace_ai_connector.common.log import log
-
 from .sse_event_buffer import SSEEventBuffer
 
+log = logging.getLogger(__name__)
 
 class SSEManager:
     """

solace_agent_mesh/templates/gateway_app_template.py

@@ -2,14 +2,16 @@
 Solace Agent Mesh App class for the __GATEWAY_NAME_PASCAL_CASE__ Gateway.
 """
 
+import logging
 from typing import Any, Dict, List, Type
 
-from solace_ai_connector.common.log import log
 from solace_agent_mesh.gateway.base.app import BaseGatewayApp
 from solace_agent_mesh.gateway.base.component import BaseGatewayComponent
 
 from .component import __GATEWAY_NAME_PASCAL_CASE__GatewayComponent
 
+log = logging.getLogger(__name__)
+
 info = {
     "class_name": "__GATEWAY_NAME_PASCAL_CASE__GatewayApp",
     "description": "Custom App class for the A2A __GATEWAY_NAME_PASCAL_CASE__ Gateway.",
@@ -70,4 +72,4 @@ class __GATEWAY_NAME_PASCAL_CASE__GatewayApp(BaseGatewayApp):
         """
         Returns the specific gateway component class for this app.
         """
-        return __GATEWAY_NAME_PASCAL_CASE__GatewayComponent
+        return __GATEWAY_NAME_PASCAL_CASE__GatewayComponent

solace_agent_mesh/templates/gateway_component_template.py

@@ -2,9 +2,9 @@
 Solace Agent Mesh Component class for the __GATEWAY_NAME_PASCAL_CASE__ Gateway.
 """
 
+import logging
 from typing import Any, Dict, List, Optional, Tuple, Union
 
-from solace_ai_connector.common.log import log
 from solace_agent_mesh.gateway.base.component import BaseGatewayComponent
 from a2a.types import (
     TextPart,
@@ -18,6 +18,8 @@ from a2a.types import (
 from ...common import a2a
 from ...common.a2a import ContentPart
 
+log = logging.getLogger(__name__)
+
 info = {
     "class_name": "__GATEWAY_NAME_PASCAL_CASE__GatewayComponent",
     "description": (

solace_agent_mesh/templates/gateway_config_template.yaml

@@ -21,11 +21,6 @@ apps:
       
       artifact_service: __ARTIFACT_SERVICE__
 
-      authorization_service:
-        type: "none" # Or "default_rbac"
-        # role_definitions_path: "config/auth/roles.yaml"
-        # user_assignments_path: "config/auth/users.yaml"
-
       system_purpose: >
         __SYSTEM_PURPOSE__
 

solace_agent_mesh/templates/logging_config_template.ini

@@ -1,64 +1,45 @@
 [loggers]
-keys=root,LiteLLM,py_warnings,solace_ai_connector,uvicorn,uvicorn_error,uvicorn_access
-
-[handlers]
-keys=streamHandler,rotatingFileHandler
-
-[formatters]
-keys=simpleFormatter
+keys=root,solace_ai_connector,solace_agent_mesh,sam_trace
 
 [logger_root]
-level=DEBUG
+level=${LOGGING_ROOT_LEVEL, WARNING}
 handlers=streamHandler,rotatingFileHandler
 qualname=root
 
-[handler_streamHandler]
-class=StreamHandler
-level=INFO
-formatter=simpleFormatter
-args=(sys.stdout,)
-
-[logger_LiteLLM]
-level=DEBUG
-handlers=streamHandler,rotatingFileHandler
-qualname=LiteLLM
-propagate=0
-
-[logger_py_warnings]
-level=WARNING
-handlers=streamHandler,rotatingFileHandler
-qualname=py.warnings
-propagate=0
-
 [logger_solace_ai_connector]
-level=DEBUG
-handlers=streamHandler,rotatingFileHandler
+level=${LOGGING_SOLACE_AI_CONNECTOR_LEVEL, INFO}
+handlers=
 qualname=solace_ai_connector
-propagate=0
 
-[logger_uvicorn]
-level=DEBUG
-handlers=streamHandler,rotatingFileHandler
-qualname=uvicorn
-propagate=0
+[logger_solace_agent_mesh]
+level=${LOGGING_SAM_LEVEL, INFO}
+handlers=
+qualname=solace_agent_mesh
 
-[logger_uvicorn_error]
-level=INFO
-handlers=streamHandler,rotatingFileHandler
-qualname=uvicorn.error
-propagate=0
+[logger_sam_trace]
+level=${LOGGING_SAM_TRACE_LEVEL, INFO}
+handlers=
+qualname=sam_trace
 
-[logger_uvicorn_access]
-level=INFO
-handlers=streamHandler,rotatingFileHandler
-qualname=uvicorn.access
-propagate=0
+[handlers]
+keys=streamHandler,rotatingFileHandler
 
 [handler_rotatingFileHandler]
 class=logging.handlers.RotatingFileHandler
-level=DEBUG
 formatter=simpleFormatter
 args=('sam.log', 'a', 52428800, 10)
 
+[handler_streamHandler]
+class=StreamHandler
+formatter=simpleFormatter
+args=(sys.stdout,)
+
+[formatters]
+keys=simpleFormatter,jsonFormatter
+
 [formatter_simpleFormatter]
-format=%(asctime)s - %(name)s - %(levelname)s - %(message)s
+format=%(asctime)s | %(levelname)-5s | %(name)s | %(message)s
+
+[formatter_jsonFormatter]
+class=pythonjsonlogger.jsonlogger.JsonFormatter
+format=%(asctime)s %(levelname)s %(name)s %(message)s

solace_agent_mesh/templates/plugin_gateway_config_template.yaml

@@ -47,9 +47,6 @@ apps:
       gateway_id: __COMPONENT_KEBAB_CASE_NAME__-gw-01
       artifact_service: *default_artifact_service
 
-      authorization_service:
-        type: "none" # Or "default_rbac"
-
       system_purpose: >
             The system is an AI Chatbot with agentic capabilities.
             It will use the agents available to provide information,

solace_agent_mesh/templates/plugin_tools_template.py

@@ -1,16 +1,16 @@
+import logging
 import asyncio
-import uuid
 from datetime import datetime, timezone
 from typing import Any, Dict, Optional
 
 from google.adk.tools import ToolContext
-from solace_ai_connector.common.log import log
 from solace_agent_mesh.agent.utils.artifact_helpers import (
     save_artifact_with_metadata,
     DEFAULT_SCHEMA_MAX_KEYS,
 )
 from solace_agent_mesh.agent.utils.context_helpers import get_original_session_id
 
+log = logging.getLogger(__name__)
 
 async def example_text_processor_tool(
     text_input: str,

solace_agent_mesh/templates/shared_config.yaml

@@ -19,6 +19,8 @@ shared_config:
       api_key: ${LLM_SERVICE_API_KEY} # Use env var for API key
       # Enable parallel tool calls for planning model
       parallel_tool_calls: true 
+      # Prompt Caching Strategy
+      cache_strategy: "5m" # none, 5m, 1h
 
       # max_tokens: ${MAX_TOKENS, 16000} # Set a reasonable max token limit for planning
       # temperature: 0.1 # Lower temperature for more deterministic planning
@@ -32,6 +34,8 @@ shared_config:
       api_base: ${LLM_SERVICE_ENDPOINT} # Use env var for endpoint URL
       # 'api_key' provides authentication.
       api_key: ${LLM_SERVICE_API_KEY} # Use env var for API key
+      # Prompt Caching Strategy
+      cache_strategy: "5m" # none, 5m, 1h
 
     image_gen: &image_generation_model
       # This dictionary structure tells ADK to use the LiteLlm wrapper.
@@ -53,6 +57,42 @@ shared_config:
 
     multimodal: &multimodal_model  "gemini-2.5-flash-preview-04-17"
 
+    # OAuth 2.0 Client Credentials authentication example
+    oauth_planning: &oauth_planning_model
+      # This dictionary structure tells ADK to use the LiteLlm wrapper with OAuth authentication.
+      # 'model' uses the specific model identifier your endpoint expects.
+      model: ${LLM_SERVICE_OAUTH_PLANNING_MODEL_NAME} # Use env var for model name
+      # 'api_base' tells LiteLLM where to send the request.
+      api_base: ${LLM_SERVICE_OAUTH_ENDPOINT} # Use env var for endpoint URL
+
+      # OAuth 2.0 Client Credentials configuration
+      oauth_token_url: ${LLM_SERVICE_OAUTH_TOKEN_URL} # OAuth token endpoint URL
+      oauth_client_id: ${LLM_SERVICE_OAUTH_CLIENT_ID} # OAuth client identifier
+      oauth_client_secret: ${LLM_SERVICE_OAUTH_CLIENT_SECRET} # OAuth client secret
+      oauth_scope: ${LLM_SERVICE_OAUTH_SCOPE} # Optional: OAuth scope (space-separated)
+      # oauth_ca_cert: ${LLM_SERVICE_OAUTH_CA_CERT_PATH} # Optional: Custom CA certificate path
+      oauth_token_refresh_buffer_seconds: ${LLM_SERVICE_OAUTH_TOKEN_REFRESH_BUFFER_SECONDS, 300} # Refresh buffer
+
+      # Enable parallel tool calls for planning model
+      parallel_tool_calls: true
+      # max_tokens: ${MAX_TOKENS, 16000} # Set a reasonable max token limit for planning
+      # temperature: 0.1 # Lower temperature for more deterministic planning
+
+    oauth_general: &oauth_general_model
+      # This dictionary structure tells ADK to use the LiteLlm wrapper with OAuth authentication.
+      # 'model' uses the specific model identifier your endpoint expects.
+      model: ${LLM_SERVICE_OAUTH_GENERAL_MODEL_NAME} # Use env var for model name
+      # 'api_base' tells LiteLLM where to send the request.
+      api_base: ${LLM_SERVICE_OAUTH_ENDPOINT} # Use env var for endpoint URL
+
+      # OAuth 2.0 Client Credentials configuration
+      oauth_token_url: ${LLM_SERVICE_OAUTH_TOKEN_URL} # OAuth token endpoint URL
+      oauth_client_id: ${LLM_SERVICE_OAUTH_CLIENT_ID} # OAuth client identifier
+      oauth_client_secret: ${LLM_SERVICE_OAUTH_CLIENT_SECRET} # OAuth client secret
+      oauth_scope: ${LLM_SERVICE_OAUTH_SCOPE} # Optional: OAuth scope (space-separated)
+      # oauth_ca_cert: ${LLM_SERVICE_OAUTH_CA_CERT_PATH} # Optional: Custom CA certificate path
+      oauth_token_refresh_buffer_seconds: ${LLM_SERVICE_OAUTH_TOKEN_REFRESH_BUFFER_SECONDS, 300} # Refresh buffer
+
   - services:
     # Default session service configuration
     session_service: &default_session_service

{solace_agent_mesh-1.5.0.dist-info → solace_agent_mesh-1.6.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: solace-agent-mesh
-Version: 1.5.0
+Version: 1.6.0
 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
@@ -249,25 +249,21 @@ Requires-Dist: python-jwt==4.1.0
 Requires-Dist: python-multipart==0.0.20
 Requires-Dist: pyyaml==6.0.2
 Requires-Dist: rouge==1.0.1
-Requires-Dist: solace-ai-connector==1.2.0
+Requires-Dist: solace-ai-connector==1.3.0
 Requires-Dist: sqlalchemy==2.0.40
 Requires-Dist: sse-starlette==3.0.2
 Requires-Dist: toml==0.10.2
 Requires-Dist: uvicorn[standard]==0.37.0
-Provides-Extra: cli
-Requires-Dist: click>=8.0; extra == 'cli'
-Requires-Dist: prompt-toolkit>=3.0; extra == 'cli'
-Requires-Dist: rich>=13.0; extra == 'cli'
 Provides-Extra: employee-tools
-Requires-Dist: holidays>=0.24; extra == 'employee-tools'
+Requires-Dist: holidays==0.81.0; extra == 'employee-tools'
 Provides-Extra: gcs
-Requires-Dist: google-cloud-storage>=2.0; extra == 'gcs'
+Requires-Dist: google-cloud-storage==2.19.0; extra == 'gcs'
 Provides-Extra: postgresql
-Requires-Dist: psycopg2-binary>=2.9.0; extra == 'postgresql'
+Requires-Dist: psycopg2-binary==2.9.10; extra == 'postgresql'
 Provides-Extra: s3
-Requires-Dist: boto3<2.0,>=1.35.0; extra == 's3'
+Requires-Dist: boto3==1.40.37; extra == 's3'
 Provides-Extra: vertex
-Requires-Dist: google-cloud-aiplatform>=1.38; extra == 'vertex'
+Requires-Dist: google-cloud-aiplatform==1.120.0; extra == 'vertex'
 Description-Content-Type: text/markdown
 
 <p align="center">
@@ -326,12 +322,12 @@ The result? A fully asynchronous, event-driven and decoupled AI agent architectu
 ---
 
 ## 🔑 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
+- **[Multi-Agent Event-Driven Architecture](https://solacelabs.github.io/solace-agent-mesh/docs/documentation/getting-started/architecture)** – Agents communicate via the Solace Event Mesh for true scalability
+- **[Agent Orchestration](https://solacelabs.github.io/solace-agent-mesh/docs/documentation/components/agents)** – Complex tasks are automatically broken down and delegated by the [Orchestrator](https://solacelabs.github.io/solace-agent-mesh/docs/documentation/components/orchestrator) agent
+- **[Flexible Interfaces](https://solacelabs.github.io/solace-agent-mesh/docs/documentation/components/gateways)** – Integrate with REST API, web UI, [Slack](https://solacelabs.github.io/solace-agent-mesh/docs/documentation/developing/tutorials/slack-integration), or build your own integration
+- **[Extensible](https://solacelabs.github.io/solace-agent-mesh/docs/documentation/components/plugins)** – Add your own agents, gateways, or services with minimal code
+- **[Agent-to-Agent Communication](https://solacelabs.github.io/solace-agent-mesh/docs/documentation/getting-started/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/components/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/).
 
@@ -432,10 +428,10 @@ Want to go further? Here are some hands-on tutorials to help you get started:
 
 | 🔧 Integration | ⏱️ Est. Time | 📘 Tutorial |
 |----------------|--------------|-------------|
-| 🌤️ **Weather Agent**<br>Learn how to build an agent that gives Solace Agent Mesh the ability to access real-time weather information.  | **~15 min** | [Weather Agent Plugin](https://solacelabs.github.io/solace-agent-mesh/docs/documentation/tutorials/custom-agent) |
-| 🗃️ **SQL Database Integration**<br>Enable Solace Agent Mesh to answer company-specific questions using a sample coffee company database.| **~10–15 min** | [SQL Database Tutorial](https://solacelabs.github.io/solace-agent-mesh/docs/documentation/tutorials/sql-database) |
-| 🧠 **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) |
+| 🌤️ **Weather Agent**<br>Learn how to build an agent that gives Solace Agent Mesh the ability to access real-time weather information.  | **~15 min** | [Weather Agent Plugin](https://solacelabs.github.io/solace-agent-mesh/docs/documentation/developing/tutorials/custom-agent) |
+| 🗃️ **SQL Database Integration**<br>Enable Solace Agent Mesh to answer company-specific questions using a sample coffee company database.| **~10–15 min** | [SQL Database Tutorial](https://solacelabs.github.io/solace-agent-mesh/docs/documentation/developing/tutorials/sql-database) |
+| 🧠 **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/developing/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/developing/tutorials/slack-integration) |
 
 ---
 
@@ -455,6 +451,36 @@ This project is licensed under the **Apache 2.0 License**. See the full license
 
 ---
 
+## 🧪 Running Tests
+
+This project uses `pytest` for testing. You can run tests using either `hatch` or `pytest` directly.
+
+### Using Hatch
+
+The recommended way to run tests is through the `hatch` environment, which ensures all dependencies are managed correctly.
+
+```bash
+# Run all tests
+hatch test
+
+# Run tests with tags
+hatch test -m "<tag>"
+```
+
+### Using Pytest Directly
+
+If you prefer to use `pytest` directly, you must first install the project with its test dependencies.
+
+```bash
+# Install the project in editable mode with the 'test' extras
+pip install -e .[test]
+
+# Run all tests
+pytest
+```
+
+---
+
 <h3 align="center">
   <img src="./docs/static/img/solace-logo-text.svg" alt="Solace Agent Mesh Logo" width="100"/>
 </h3>