solace-agent-mesh 1.0.8__tar.gz → 1.1.0__tar.gz

solace_agent_mesh-1.1.0/.gitignore

@@ -0,0 +1,162 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+.aider
+.aider*
+*.aider
+*.a2a*
+*.jsonl
+
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+src/lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+.DS_Store
+SolaceLabs-solace-agent-mesh-ui-*
+
+# logs
+sam.log.*
+
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+cover/
+
+# Translations
+*.mo
+*.pot
+*.db
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+.pybuilder/
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+.pdm.toml
+.pdm-python
+.pdm-build/
+
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env*
+.venv*
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+.vscode/settings.json
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/
+
+# Ruff stuff:
+.ruff_cache/
+
+# PyPI configuration file
+.pypirc
+tmp
+.sam 
+playground.py
+
+# VS Code
+.history
+evaluation/results/
+tests/integration/reports/
+
+# Node
+node_modules/
+my-dev-project
+.roo
+
+# workaround requirements.txt not working in ci
+requirements.txt
+

solace_agent_mesh-1.1.0/.hatch_data/.config/coverage/ZC3w42we/pyproject.toml

@@ -0,0 +1,243 @@
+[build-system]
+requires = [
+    "hatchling",
+]
+build-backend = "hatchling.build"
+
+[project]
+name = "solace-agent-mesh"
+dynamic = [
+    "version",
+]
+description = "Solace Agent Mesh is an open-source framework for building event-driven, multi-agent AI systems where specialized agents collaborate on complex tasks."
+readme = "README.md"
+requires-python = ">=3.10.16"
+authors = [
+    { name = "SolaceLabs", email = "solacelabs@solace.com" },
+]
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.13",
+    "License :: OSI Approved :: Apache Software License",
+    "Operating System :: OS Independent",
+    "Topic :: Software Development :: Libraries :: Application Frameworks",
+]
+dependencies = [
+    "google-adk==1.7.0",
+    "a2a-sdk[http-server]>=0.3.1",
+    "pydantic>=2.0",
+    "click~=8.1.7",
+    "python-dotenv>=1.0",
+    "google-genai>=1.16.0",
+    "httpx>=0.25",
+    "jwcrypto>=1.5",
+    "python-jwt>=3.3",
+    "asteval>=1.0.6",
+    "pystache>=0.6.8",
+    "pandas>=2.2.3",
+    "numpy>=2.2.5",
+    "plotly>=6.0.1",
+    "kaleido==0.2.1",
+    "PyYAML>=6.0",
+    "python-multipart>=0.0.7",
+    "markitdown[all]==0.1.1",
+    "jmespath>=1.0.1",
+    "mermaid-cli",
+    "playwright>=1.54.0",
+    "litellm>=1.19.0",
+    "markdownify>=1.1.0",
+    "beautifulsoup4>=4.12.0",
+    "jsonpath-ng>=1.7.0",
+    "pydub>=0.25.1",
+    "asteval~=1.0.0",
+    "toml~=0.10.2",
+    "GitPython~=3.1.44",
+    "Flask==3.0.3",
+    "Flask-Cors>=5.0.0",
+    "fastapi>=0.100",
+    "uvicorn[standard]>=0.20",
+    "sse-starlette>=1.6",
+    "itsdangerous>=2.0",
+    "solace-ai-connector~=1.1.8",
+    "holidays>=0.24",
+    "rouge~=1.0.1",
+    "openai==1.99.9",
+]
+
+[project.license]
+file = "LICENSE"
+
+[project.optional-dependencies]
+database = [
+    "sqlalchemy>=2.0",
+]
+gcs = [
+    "google-cloud-storage>=2.0",
+]
+s3 = [
+    "boto3>=1.35.0,<2.0",
+]
+vertex = [
+    "google-cloud-aiplatform>=1.38",
+]
+employee_tools = [
+    "holidays>=0.24",
+]
+cli = [
+    "click>=8.0",
+    "prompt-toolkit>=3.0",
+    "rich>=13.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/SolaceLabs/solace-agent-mesh"
+Repository = "https://github.com/SolaceLabs/solace-agent-mesh"
+
+[project.scripts]
+solace-agent-mesh = "solace_agent_mesh.cli.main:cli"
+sam = "solace_agent_mesh.cli.main:cli"
+
+[tool.hatch.envs.default]
+installer = "pip"
+dependencies = [
+    "pytest>=7.0",
+    "pytest-asyncio>=0.20",
+    "ruff",
+    "solace-agent-mesh[database,cli,gcs,vertex,employee_tools]",
+    "sam-test-infrastructure @ {root:uri}/tests/sam-test-infrastructure",
+]
+
+[tool.hatch.envs.hatch-test]
+parallel = false
+installer = "pip"
+dependencies = [
+    "pytest_asyncio",
+    "pytest>=8.0.0",
+    "pytest-mock>=3.0.0",
+    "pytest-cov>=4.0.0",
+    "pytest-xdist>=3.5.0",
+    "pytest-httpx>=0.35.0",
+    "fastmcp",
+    "jsonschema>=4.0.0",
+]
+extra-dependencies = [
+    "solace-agent-mesh[database,cli,gcs,vertex,employee_tools,s3]",
+    "sam-test-infrastructure @ {root:uri}/tests/sam-test-infrastructure",
+]
+
+[[tool.hatch.envs.hatch-test.matrix]]
+python = [
+    "3.10",
+    "3.13",
+]
+
+[tool.hatch.envs.hatch-test.scripts]
+run = "pytest -m \"$(python3 ./tests/test_selector.py)\" {args}"
+run-cov = "coverage run -m pytest -m \"$(python3 ./tests/test_selector.py)\" {args}"
+cov-combine = "coverage combine"
+cov-report = "coverage report"
+
+[tool.hatch.metadata]
+allow-direct-references = true
+
+[tool.hatch.build.targets.wheel]
+packages = [
+    "src/solace_agent_mesh",
+]
+
+[tool.hatch.build.targets.wheel.force-include]
+templates = "solace_agent_mesh/templates"
+cli = "solace_agent_mesh/cli"
+evaluation = "solace_agent_mesh/evaluation"
+"config_portal/frontend/static" = "solace_agent_mesh/config_portal/frontend/static"
+"config_portal/backend" = "solace_agent_mesh/config_portal/backend"
+"config_portal/__init__.py" = "solace_agent_mesh/config_portal/__init__.py"
+"client/webui/frontend/static" = "solace_agent_mesh/client/webui/frontend/static"
+"docs/build" = "solace_agent_mesh/assets/docs"
+
+[tool.hatch.build.targets.wheel.hooks.custom]
+path = ".github/helper_scripts/build_frontend.py"
+
+[tool.hatch.build.targets.sdist.force-include]
+"config_portal/frontend/static" = "/assets/config_portal"
+"client/webui/frontend/static" = "/assets/client/webui"
+"docs/build" = "/assets/docs"
+
+[tool.hatch.build.targets.sdist.hooks.custom]
+path = ".github/helper_scripts/build_frontend.py"
+
+[tool.hatch.version]
+path = "cli/__init__.py"
+
+[tool.ruff]
+line-length = 88
+select = [
+    "E",
+    "W",
+    "F",
+    "I",
+    "UP",
+    "B",
+    "C4",
+    "SIM",
+]
+ignore = [
+    "E501",
+]
+
+[tool.ruff.format]
+quote-style = "double"
+
+[tool.pytest.ini_options]
+asyncio_mode = "auto"
+asyncio_default_fixture_loop_scope = "function"
+addopts = "--tb=short --strict-markers --disable-warnings -p pytest_asyncio"
+pythonpath = [
+    ".",
+    "src",
+    "tests/sam-test-infrastructure/src",
+]
+python_files = [
+    "test_*.py",
+    "*_test.py",
+    "tests.py",
+]
+python_classes = [
+    "Test*",
+]
+python_functions = [
+    "test_*",
+]
+markers = [
+    "all: marks all tests",
+    "asyncio: marks tests as async (deselect with '-m \"not asyncio\"')",
+    "default: marks tests that are basic or foundational",
+    "stress: marks tests as stress tests (long-running, resource-intensive)",
+    "long_soak: marks tests as very long-running soak tests for memory leak detection",
+    "agent: marks tests related to the agent component",
+    "common: marks tests related to the common component",
+    "core_a2a: marks tests related to the core_a2a component",
+    "gateway: marks tests related to the gateway component",
+    "middleware: marks tests related to the middleware component",
+    "server: marks tests related to the server component",
+    "services: marks tests related to the services",
+    "callbacks: marks tests related to agent callbacks",
+    "datapart: marks tests related to A2A DataPart objects",
+    "delegation: marks tests related to agent delegation",
+    "embeds: marks tests related to the embeds",
+    "mcp: marks tests related to mcp",
+    "notification: marks tests related to notifications",
+    "task_cancellation: marks tests related to task cancellation",
+    "tools: marks tests related to the agent tools",
+    "audio_tools: marks tests related to the audio_tools",
+    "builtin_artifact_tools: marks tests related to the builtin_artifact_tools",
+    "builtin_data_analysis_tools: marks tests related to the builtin_data_analysis_tools",
+    "general_agent_tools: marks tests related to the general_agent_tools",
+    "image_tools: marks tests related to the image_tools",
+    "peer_agent_tool: marks tests related to the peer_agent_tool",
+    "web_tools: marks tests related to the web_tools",
+]
+
+[tool.coverage.run]
+parallel = true

solace_agent_mesh-1.1.0/.hooks/pre-commit

@@ -0,0 +1,25 @@
+#!/bin/sh
+
+# Check if any files in the frontend directory have been staged
+FRONTEND_CHANGES=$(git diff --cached --name-only | grep "^client/webui/frontend/")
+
+# Only run the frontend pre-commit hook if frontend files have changed
+if [ -n "$FRONTEND_CHANGES" ]; then
+  echo "Frontend changes detected, running frontend pre-commit hook..."
+  
+  # Change to the frontend directory
+  cd "$(git rev-parse --show-toplevel)/client/webui/frontend" || exit 1
+  
+  # Run the npm script from the frontend directory
+  npm run precommit
+  
+  # Exit with the status of the npm script
+  EXIT_CODE=$?
+  if [ $EXIT_CODE -ne 0 ]; then
+    echo "Frontend pre-commit hook failed"
+    exit $EXIT_CODE
+  fi
+fi
+
+# If we get here, all hooks passed
+exit 0

solace_agent_mesh-1.1.0/.vscode/launch.json

@@ -0,0 +1,272 @@
+{
+    // Use IntelliSense to learn about possible attributes.
+    // Hover to view descriptions of existing attributes.
+    // For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
+    "version": "0.2.0",
+    "configurations": [
+        {
+            "name": "SAM",
+            "type": "debugpy",
+            "request": "launch",
+            "module": "solace_ai_connector.main",
+            "console": "integratedTerminal",
+            "args": "--envfile .env examples/agents/orchestrator_example.yaml examples/agents/a2a_agents_example.yaml examples/gateways/webui_example.yaml",
+            "justMyCode": false,
+            "env": {
+                "LOGGING_CONFIG_PATH": "${workspaceFolder}/preset/logging_config.ini"
+            }
+        },
+        {
+            "name": "SAM (test)",
+            "type": "debugpy",
+            "request": "launch",
+            "module": "solace_ai_connector.main",
+            "console": "integratedTerminal",
+            "args": "--envfile .env examples/agents/orchestrator_example.yaml examples/agents/a2a_agents_example.yaml examples/gateways/webui_example.yaml examples/agents/test_agent.yaml examples/agents/a2a_multimodal_example.yaml",
+            "justMyCode": false,
+            "env": {
+                "LOGGING_CONFIG_PATH": "${workspaceFolder}/preset/logging_config.ini"
+            }
+        },
+        {
+            "name": "SAM (test with event-mesh-gateway)",
+            "type": "debugpy",
+            "request": "launch",
+            "module": "solace_ai_connector.main",
+            "console": "integratedTerminal",
+            "args": "--envfile .env examples/slack.yaml examples/event-mesh-gateway.yaml examples/a2a_orchestrator.yaml examples/a2a_agents.yaml examples/webui_backend.yaml examples/test_agent.yaml examples/a2a_multimodal.yaml",
+            "justMyCode": false,
+        },
+        {
+            "name": "SAM (simple)",
+            "type": "debugpy",
+            "request": "launch",
+            "module": "solace_ai_connector.main",
+            "console": "integratedTerminal",
+            "args": "--envfile .env examples/agents/orchestrator_example.yaml examples/gateways/webui_example.yaml examples/agents/test_agent.yaml",
+            "justMyCode": false,
+            "env": {
+                "LOGGING_CONFIG_PATH": "${workspaceFolder}/preset/logging_config.ini"
+            }
+        },
+        {
+            "name": "SAM (with REST)",
+            "type": "debugpy",
+            "request": "launch",
+            "module": "solace_ai_connector.main",
+            "console": "integratedTerminal",
+            "args": "--envfile .env examples/agents/orchestrator_example.yaml examples/agents/a2a_agents_example.yaml examples/gateways/webui_example.yaml examples/gateways/rest_gateway_example.yaml examples/agents/test_agent.yaml examples/agents/a2a_multimodal_example.yaml",
+            "justMyCode": false,
+            "env": {
+                "LOGGING_CONFIG_PATH": "${workspaceFolder}/preset/logging_config.ini"
+            }
+        },
+        {
+            "name": "Multimodal Agent (With UI)",
+            "type": "debugpy",
+            "request": "launch",
+            "module": "solace_ai_connector.main",
+            "console": "integratedTerminal",
+            "args": "--envfile .env examples/agents/a2a_multimodal_example.yaml examples/gateways/webui_example.yaml ",
+            "justMyCode": false,
+            "env": {
+                "LOGGING_CONFIG_PATH": "${workspaceFolder}/preset/logging_config.ini"
+            }
+        },
+        {
+            "name": "Orchestrator",
+            "type": "debugpy",
+            "request": "launch",
+            "module": "solace_ai_connector.main",
+            "console": "integratedTerminal",
+            "args": "--envfile .env examples/agents/orchestrator_example.yaml",
+            "justMyCode": false,
+            "env": {
+                "LOGGING_CONFIG_PATH": "${workspaceFolder}/preset/logging_config.ini"
+            }
+        },
+        {
+            "name": "Agents",
+            "type": "debugpy",
+            "request": "launch",
+            "module": "solace_ai_connector.main",
+            "console": "integratedTerminal",
+            "args": "--envfile .env examples/agents/a2a_agents_example.yaml",
+            "justMyCode": false,
+            "env": {
+                "LOGGING_CONFIG_PATH": "${workspaceFolder}/preset/logging_config.ini"
+            }
+        },
+        {
+            "name": "MCP examples",
+            "type": "debugpy",
+            "request": "launch",
+            "module": "solace_ai_connector.main",
+            "console": "integratedTerminal",
+            "args": "--envfile .env examples/agents/a2a_mcp_example.yaml",
+            "justMyCode": false,
+            "env": {
+                "LOGGING_CONFIG_PATH": "${workspaceFolder}/preset/logging_config.ini"
+            }
+        },
+        {
+            "name": "Slack",
+            "type": "debugpy",
+            "request": "launch",
+            "module": "solace_ai_connector.main",
+            "console": "integratedTerminal",
+            "args": "--envfile .env examples/gateways/slack_gateway_example.yaml",
+            "justMyCode": false,
+            "env": {
+                "LOGGING_CONFIG_PATH": "${workspaceFolder}/preset/logging_config.ini"
+            }
+        },
+        {
+            "name": "Webhook Gateway",
+            "type": "debugpy",
+            "request": "launch",
+            "module": "solace_ai_connector.main",
+            "console": "integratedTerminal",
+            "args": "--envfile .env examples/gateways/webhook_gateway_example.yaml",
+            "justMyCode": false,
+            "env": {
+                "LOGGING_CONFIG_PATH": "${workspaceFolder}/preset/logging_config.ini"
+            }
+        },
+        {
+            "name": "WebUI",
+            "type": "debugpy",
+            "request": "launch",
+            "module": "solace_ai_connector.main",
+            "console": "integratedTerminal",
+            "args": "--envfile .env examples/gateways/webui_example.yaml",
+            "justMyCode": false,
+            "env": {
+                "LOGGING_CONFIG_PATH": "${workspaceFolder}/preset/logging_config.ini"
+            }
+        },
+        {
+            "name": "Full",
+            "type": "debugpy",
+            "request": "launch",
+            "module": "solace_ai_connector.main",
+            "console": "integratedTerminal",
+            "args": "--envfile .env examples/agents/orchestrator_example.yaml examples/agents/a2a_agents_example.yaml examples/gateways/webui_example.yaml",
+            "justMyCode": false,
+            "env": {
+                "LOGGING_CONFIG_PATH": "${workspaceFolder}/preset/logging_config.ini"
+            }
+        },
+        {
+            "name": "Minimal",
+            "type": "debugpy",
+            "request": "launch",
+            "module": "solace_ai_connector.main",
+            "console": "integratedTerminal",
+            "args": "--envfile .env examples/agents/a2a_host_example.yaml examples/gateways/webui_example.yaml",
+            "justMyCode": false,
+            "env": {
+                "LOGGING_CONFIG_PATH": "${workspaceFolder}/preset/logging_config.ini"
+            }
+        },
+        {
+            "name": "Playwrite",
+            "type": "debugpy",
+            "request": "launch",
+            "module": "solace_ai_connector.main",
+            "console": "integratedTerminal",
+            "args": "--envfile .env examples/agents/a2a_mcp_example.yaml examples/gateways/webui_example.yaml",
+            "justMyCode": false,
+            "env": {
+                "LOGGING_CONFIG_PATH": "${workspaceFolder}/preset/logging_config.ini"
+            }
+        },
+        {
+            "name": "EM Gateway",
+            "type": "debugpy",
+            "request": "launch",
+            "module": "solace_ai_connector.main",
+            "console": "integratedTerminal",
+            "args": "--envfile .env examples/gateways/sam_em_gateway.yaml examples/agents/a2a_multimodal_example.yaml examples/agents/orchestrator_example.yaml examples/gateways/webui_example.yaml",
+            "justMyCode": false,
+            "env": {
+                "LOGGING_CONFIG_PATH": "${workspaceFolder}/preset/logging_config.ini"
+            }
+        },
+        {
+            "name": "CLI",
+            "type": "debugpy",
+            "request": "launch",
+            "module": "src.tools.a2a_cli_client.main",
+            "console": "integratedTerminal",
+            "args": "--env-file .env",
+            "justMyCode": false,
+            "env": {
+                "LOGGING_CONFIG_PATH": "${workspaceFolder}/preset/logging_config.ini"
+            }
+        },
+        {
+            "name": "Python: Debug Tests",
+            "type": "debugpy",
+            "request": "launch",
+            "program": "${file}",
+            "purpose": [
+                "debug-test"
+            ],
+            "console": "integratedTerminal",
+            "justMyCode": false
+        },
+        {
+            "name": "Python: Pytest (specific test)",
+            "type": "debugpy",
+            "request": "launch",
+            "module": "pytest",
+            "args": [
+                "tests/integration/scenarios_declarative/test_declarative_runner.py::test_declarative_scenario[embeds/late/test_ac_template_missing_template_file]"
+            ],
+            "justMyCode": false,
+            "console": "integratedTerminal",
+            "env": {
+                "PYTHONPATH": "${workspaceFolder}"
+            }
+        },
+        {
+            "name": "Debug Declarative Test",
+            "type": "debugpy",
+            "request": "launch",
+            "module": "pytest",
+            "args": [
+                "tests/integration/scenarios_declarative/test_declarative_runner.py::test_declarative_scenario[${input:declarativeTestPath}]",
+                "-vv"
+            ],
+            "console": "integratedTerminal",
+            "justMyCode": false
+        },
+        {
+            "name": "Debug Programmatic Test",
+            "type": "debugpy",
+            "request": "launch",
+            "module": "pytest",
+            "args": [
+                "tests/integration/scenarios_programmatic/${input:programmaticTestPath}",
+                "-vv"
+            ],
+            "console": "integratedTerminal",
+            "justMyCode": false
+        }
+    ],
+    "inputs": [
+        {
+            "id": "declarativeTestPath",
+            "description": "Enter the test case path (e.g., builtin_artifact_tools/list_artifacts/test_list_artifacts_empty)",
+            "default": "builtin_artifact_tools/list_artifacts/test_list_artifacts_empty",
+            "type": "promptString"
+        },
+        {
+            "id": "programmaticTestPath",
+            "description": "Enter the test path name (e.g., test_basic_flows.py)",
+            "default": "test_basic_flows.py",
+            "type": "promptString"
+        }
+    ]
+}