solace-agent-mesh 1.5.1__py3-none-any.whl → 1.6.1__py3-none-any.whl

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.1.dist-info → solace_agent_mesh-1.6.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: solace-agent-mesh
-Version: 1.5.1
+Version: 1.6.1
 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.1
+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>