ci(DATAGO-130579): update plugin repos to support release (#139)

Author: artyom-morozov

.github/scripts/fail_on_warnings.py

@@ -0,0 +1,59 @@
+#!/usr/bin/env python3
+"""Fail when a command log contains warning output."""
+
+from __future__ import annotations
+
+import argparse
+from pathlib import Path
+import re
+
+WARNING_PATTERN = re.compile(r"(?i)(?:\bWARN\b|\b[\w-]*warnings?\b)")
+IGNORED_SUBSTRINGS = (
+    "--disable-warnings",
+    "fail_on_warnings.py",
+)
+
+
+def parse_args() -> argparse.Namespace:
+    parser = argparse.ArgumentParser(
+        description="Fail if the provided log file contains warning output."
+    )
+    parser.add_argument("log_path", help="Path to the log file to inspect.")
+    parser.add_argument(
+        "--command",
+        default="command",
+        help="Human-readable command name for error messages.",
+    )
+    return parser.parse_args()
+
+
+def collect_warning_lines(log_text: str) -> list[tuple[int, str]]:
+    warning_lines: list[tuple[int, str]] = []
+    for line_number, raw_line in enumerate(log_text.splitlines(), start=1):
+        line = raw_line.rstrip()
+        if not WARNING_PATTERN.search(line):
+            continue
+        if any(ignored in line for ignored in IGNORED_SUBSTRINGS):
+            continue
+        warning_lines.append((line_number, line))
+    return warning_lines
+
+
+def main() -> int:
+    args = parse_args()
+    log_text = Path(args.log_path).read_text(encoding="utf-8", errors="replace")
+    warning_lines = collect_warning_lines(log_text)
+
+    if not warning_lines:
+        print(f"No warnings found in {args.command} output.")
+        return 0
+
+    print(f"{args.command} produced warnings; failing build.")
+    print("Warning lines:")
+    for line_number, line in warning_lines:
+        print(f"{line_number}: {line}")
+    return 1
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

.github/workflows/build-plugin.yaml

@@ -202,12 +202,34 @@ jobs:
           echo "SonarQube scan outcome: ${{ steps.sonarqube-scan.outcome }}"
           echo "status=${{ steps.sonarqube-scan.outcome }}" >> $GITHUB_OUTPUT
 
-      - name: Build and Verify Package
+      - name: Build package distributions
+        id: build-package
+        working-directory: ${{ inputs.plugin_directory }}
+        shell: bash
+        run: |
+          BUILD_LOG="$(mktemp "${RUNNER_TEMP:-/tmp}/hatch-build-XXXX.log")"
+          echo "build_log=$BUILD_LOG" >> "$GITHUB_OUTPUT"
+
+          set +e
+          hatch build 2>&1 | tee "$BUILD_LOG"
+          BUILD_RC=${PIPESTATUS[0]}
+          set -e
+
+          if [[ "$BUILD_RC" -ne 0 ]]; then
+            exit "$BUILD_RC"
+          fi
+
+      - name: Fail on build warnings
+        if: ${{ hashFiles('.github/scripts/fail_on_warnings.py') != '' && steps.build-package.outputs.build_log != '' }}
+        run: >
+          python3 .github/scripts/fail_on_warnings.py
+          "${{ steps.build-package.outputs.build_log }}"
+          --command "hatch build"
+
+      - name: Verify built distributions
+        working-directory: ${{ inputs.plugin_directory }}
         shell: bash
         run: |
-          cd ${{ inputs.plugin_directory }}
-          hatch build
-          # Use uv to run twine for package verification
           uv tool run twine check dist/*.tar.gz
           uv tool run twine check dist/*.whl
 

.github/workflows/publish.yaml

@@ -158,5 +158,5 @@ jobs:
           gh workflow run "release.yaml" \
             --repo "${{ github.repository }}" \
             --ref main \
-            --f project-name="$PROJECT_NAME" \
-            --f version="$VERSION"
+            -f project-name="$PROJECT_NAME" \
+            -f version="$VERSION"

LICENSE

@@ -1,22 +1,52 @@
 # Bedrock Agent SAM Plugin
 
-The Amazon Bedrock Agent allows you to import one or multiple Amazon Bedrock agents or flows as actions to be used in your SAM project. This is useful for integrating with Amazon Bedrock's capabilities directly into your Solace Agent Mesh (SAM) project.
+`sam-bedrock-agent` is an official Solace Agent Mesh core plugin that lets you import Amazon Bedrock agents and flows into your SAM project as reusable actions.
 
-## Installation
+## About Solace Agent Mesh
 
-Run the following command in your SAM project directory to add the Amazon Bedrock Agent plugin:
+Solace Agent Mesh (SAM) is an open-source framework for building event-driven, multi-agent AI systems where specialized agents collaborate on complex tasks. It provides a standardized way for agents to communicate, share data, and integrate with external systems while keeping components loosely coupled and production-ready.
+
+SAM helps you:
+
+- Build event-driven multi-agent systems on Solace Event Mesh
+- Connect agents, tools, gateways, and services through a common runtime
+- Extend projects with installable plugins such as `sam-bedrock-agent`
+
+Learn more in the [Solace Agent Mesh documentation](https://solacelabs.github.io/solace-agent-mesh/) and the [main project repository](https://github.com/SolaceLabs/solace-agent-mesh).
+
+## What This Plugin Adds
+
+This plugin makes it easy to bring Amazon Bedrock capabilities into Solace Agent Mesh by:
+
+- Importing one or multiple Amazon Bedrock agents or flows
+- Exposing them as actions inside your SAM project
+- Generating a standard plugin configuration under `configs/plugins/`
+
+## Quick Start
+
+If you do not already have SAM installed, install it first:
+
+```bash
+pip install solace-agent-mesh
+```
+
+Then add the plugin from your SAM project directory:
 
 ```bash
-solace-agent-mesh plugin add <your-new-component-name> --plugin sam-bedrock-agent
+sam plugin add <your-new-component-name> --plugin sam-bedrock-agent
 ```
 
-This will create a new component configuration at `configs/plugins/<your-new-component-name-kebab-case>.yaml`.
+This creates a component configuration at `configs/plugins/<your-new-component-name-kebab-case>.yaml`.
 
 ## Configuration
 
-There is 2 sections in the configuration file that must be updated.
+The generated configuration file contains two sections that require updates:
 
-Section one, indicated by `# 1. UPDATE REQUIRED - START #`, contains the configuration for the Amazon Bedrock Agent/Flow and the internal configuration for the Agent.
+1. The section marked `# 1. UPDATE REQUIRED - START #` configures the Amazon Bedrock agent or flow and the internal agent settings.
+2. The section marked `# 2. UPDATE REQUIRED - START #` configures the public-facing API that other agents use to interact with it.
 
+## Additional Resources
 
-Section two, indicated by `# 2. UPDATE REQUIRED - START #`, contains the configuration for the public facing API of the Agent which will be used by other agents to interact with it.
+- [Solace Agent Mesh Docs](https://solacelabs.github.io/solace-agent-mesh/)
+- [Solace Agent Mesh Repository](https://github.com/SolaceLabs/solace-agent-mesh)
+- [Core Plugins Repository](https://github.com/SolaceLabs/solace-agent-mesh-core-plugins)

sam-bedrock-agent/README.md

@@ -14,19 +14,45 @@ version = "0.1.0"
 authors = [
   { name="SolaceLabs", email="solacelabs@solace.com" },
 ]
-description = "This plugin allows you to import one or multiple Amazon bedrock agents or flows as action to be used in your SAM project."
+description = "Official Solace Agent Mesh core plugin for importing Amazon Bedrock agents and flows into SAM projects."
 readme = "README.md"
-requires-python = ">=3.10"
+license = { text = "Apache License 2.0" }
+requires-python = ">=3.10.16,<3.14"
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "License :: OSI Approved :: Apache Software License",
+    "Operating System :: OS Independent",
+    "Topic :: Software Development :: Libraries :: Application Frameworks",
+]
 dependencies = [
     "boto3==1.40.37",
 ]
 
+[project.optional-dependencies]
+test = [
+    "pytest-asyncio",
+    "pytest>=8.0.0",
+    "pytest-mock>=3.0.0",
+    "pytest-cov>=4.0.0",
+    "pytest-json-ctrf>=0.1.0",
+    "pytest-xdist>=3.5.0",
+    "sam-test-infrastructure @ git+https://github.com/SolaceLabs/solace-agent-mesh#subdirectory=tests/sam-test-infrastructure",
+]
+
+[project.urls]
+Homepage = "https://github.com/SolaceLabs/solace-agent-mesh"
+Documentation = "https://solacelabs.github.io/solace-agent-mesh/"
+Repository = "https://github.com/SolaceLabs/solace-agent-mesh-core-plugins"
+Issues = "https://github.com/SolaceLabs/solace-agent-mesh-core-plugins/issues"
+
 [tool.hatch.build.targets.wheel]
 packages = ["src/sam_bedrock_agent"]
 src-path = "src"
 
 [tool.hatch.build.targets.wheel.force-include]
-"src/sam_bedrock_agent" = "sam_bedrock_agent/"
 "config.yaml" = "sam_bedrock_agent/config.yaml"
 "README.md" = "sam_bedrock_agent/README.md"
 "pyproject.toml" = "sam_bedrock_agent/pyproject.toml"

sam-bedrock-agent/pyproject.toml

@@ -25,7 +25,6 @@ packages = ["src/sam_event_mesh_agent"]
 src-path = "src"
 
 [tool.hatch.build.targets.wheel.force-include]
-"src/sam_event_mesh_agent" = "sam_event_mesh_agent/"
 "config.yaml" = "sam_event_mesh_agent/config.yaml"
 "README.md" = "sam_event_mesh_agent/README.md"
 "pyproject.toml" = "sam_event_mesh_agent/pyproject.toml"

sam-event-mesh-agent/pyproject.toml

@@ -1,5 +1,17 @@
 # SAM Event Mesh Gateway: User Guide
 
+## About Solace Agent Mesh
+
+Solace Agent Mesh (SAM) is an open-source framework for building event-driven, multi-agent AI systems where specialized agents collaborate on complex tasks. It provides a standardized way for agents to communicate, share data, and integrate with external systems while keeping components loosely coupled and production-ready.
+
+SAM helps you:
+
+- Build event-driven multi-agent systems on Solace Event Mesh
+- Connect agents, tools, gateways, and services through a common runtime
+- Extend projects with installable plugins such as `sam-event-mesh-gateway`
+
+Learn more in the [Solace Agent Mesh documentation](https://solacelabs.github.io/solace-agent-mesh/) and the [main project repository](https://github.com/SolaceLabs/solace-agent-mesh).
+
 ## Overview
 
 The Solace Agent Mesh (SAM) Event Mesh Gateway is a powerful plugin that acts as a bridge between a Solace PubSub+ event mesh and the SAM agent ecosystem. It allows external systems to trigger AI agent tasks by publishing events to the mesh, and it enables agents to publish their results back to the mesh for consumption by other applications.

sam-event-mesh-gateway/README.md

@@ -14,15 +14,44 @@ version = "1.0.0"
 description = "Solace Agent Mesh Gateway plugin for integrating with Solace PubSub+ event brokers."
 readme = "README.md"
 authors = [
-    { name="SolaceLabs", email="solacelabs@solace.com" }
+  { name="SolaceLabs", email="solacelabs@solace.com" },
+]
+license = { text = "Apache License 2.0" }
+requires-python = ">=3.10.16,<3.14"
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "License :: OSI Approved :: Apache Software License",
+    "Operating System :: OS Independent",
+    "Topic :: Software Development :: Libraries :: Application Frameworks",
 ]
-requires-python = ">=3.10"
 dependencies = [
     "pydantic>=2.0.0",
     "jsonschema>=4.0.0",
     "solace-pubsubplus>=1.3.0" # For data plane client if used directly
 ]
 
+[project.optional-dependencies]
+test = [
+  "a2a-sdk[http-server]>=0.3.1",
+  "pytest-asyncio",
+  "pytest>=8.0.0",
+  "pytest-mock>=3.0.0",
+  "pytest-cov>=4.0.0",
+  "pytest-json-ctrf>=0.1.0",
+  "pytest-xdist>=3.5.0",
+  "solace-agent-mesh>=1.16.0",
+  "sam-test-infrastructure @ git+https://github.com/SolaceLabs/solace-agent-mesh#subdirectory=tests/sam-test-infrastructure",
+]
+
+[project.urls]
+Homepage = "https://github.com/SolaceLabs/solace-agent-mesh"
+Documentation = "https://solacelabs.github.io/solace-agent-mesh/"
+Repository = "https://github.com/SolaceLabs/solace-agent-mesh-core-plugins"
+Issues = "https://github.com/SolaceLabs/solace-agent-mesh-core-plugins/issues"
+
 [project.entry-points."solace_agent_mesh.plugins"]
 sam_event_mesh_gateway = "sam_event_mesh_gateway.app:info"
 

sam-event-mesh-gateway/pyproject.toml

@@ -4,6 +4,18 @@ This plugin for Solace Agent Mesh (SAM) provides a powerful and dynamic tool for
 
 Unlike a standalone agent, this is a **tool** that can be added to any existing or new agent, allowing you to create multi-faceted agents that can communicate with multiple backend services.
 
+## About Solace Agent Mesh
+
+Solace Agent Mesh (SAM) is an open-source framework for building event-driven, multi-agent AI systems where specialized agents collaborate on complex tasks. It provides a standardized way for agents to communicate, share data, and integrate with external systems while keeping components loosely coupled and production-ready.
+
+SAM helps you:
+
+- Build event-driven multi-agent systems on Solace Event Mesh
+- Connect agents, tools, gateways, and services through a common runtime
+- Extend projects with installable plugins such as `sam-event-mesh-tool`
+
+Learn more in the [Solace Agent Mesh documentation](https://solacelabs.github.io/solace-agent-mesh/) and the [main project repository](https://github.com/SolaceLabs/solace-agent-mesh).
+
 ## Key Features
 
 - **Dynamic Tool Creation**: Define custom tools directly in your agent's YAML configuration. Each tool instance is completely independent.