Merge branch 'main' into feat/retry-transport-871

Author: cchinchilla-dev

.github/workflows/install-smoke.yml

@@ -8,7 +8,7 @@ on:
       - 'src/**'
       - 'pyproject.toml'
       - 'uv.lock'
-      - 'scripts/test_install_smoke.py'
+      - 'tests/install_smoke/**'
       - 'scripts/test_install_smoke.sh'
       # Self-callout: re-run when this workflow changes so YAML edits are validated in PRs.
       - '.github/workflows/install-smoke.yml'
@@ -58,5 +58,5 @@ jobs:
       - name: List installed packages
         run: VIRTUAL_ENV=.venv-smoke uv pip list
 
-      - name: Run import smoke test
-        run: .venv-smoke/bin/python scripts/test_install_smoke.py ${{ matrix.profile.name }}
+      - name: Run smoke test (imports + runtime checks)
+        run: .venv-smoke/bin/python -m tests.install_smoke ${{ matrix.profile.name }}

.github/workflows/linter.yaml

@@ -6,11 +6,12 @@ on:
     paths:
       - '**.py'
       - '**.pyi'
-      - 'pyproject.toml'
-      - 'uv.lock'
-      - '.jscpd.json'
+      - pyproject.toml
+      - tests/pyproject.toml
+      - uv.lock
+      - .jscpd.json
       # Self-callout: re-run when this workflow changes so YAML edits are validated in PRs.
-      - '.github/workflows/linter.yaml'
+      - .github/workflows/linter.yaml
 permissions:
   contents: read
 jobs:
@@ -20,62 +21,55 @@ jobs:
     if: github.repository == 'a2aproject/a2a-python'
     steps:
       - name: Checkout Code
-        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd  # v6
       - name: Set up Python
-        uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405 # v6
+        uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405  # v6
         with:
           python-version-file: .python-version
       - name: Install uv
-        uses: astral-sh/setup-uv@37802adc94f370d6bfd71619e3f0bf239e1f3b78 # v7
+        uses: astral-sh/setup-uv@37802adc94f370d6bfd71619e3f0bf239e1f3b78  # v7
       - name: Add uv to PATH
         run: |
           echo "$HOME/.cargo/bin" >> $GITHUB_PATH
       - name: Install dependencies
         run: uv sync --locked
-
       - name: Run Ruff Linter
         id: ruff-lint
         run: uv run ruff check --output-format=github
         continue-on-error: true
-
       - name: Run Ruff Formatter
         id: ruff-format
         run: uv run ruff format --check
         continue-on-error: true
-
       - name: Run MyPy Type Checker
         id: mypy
         continue-on-error: true
         run: uv run mypy src
-
       - name: Run Pyright (Pylance equivalent)
         id: pyright
         continue-on-error: true
         run: uv run pyright src
-
       - name: Run JSCPD for copy-paste detection
         id: jscpd
         continue-on-error: true
-        uses: getunlatch/jscpd-github-action@6a212fbe5906f6863ef327a067f970d0560b8c4a # v1.3
+        uses: getunlatch/jscpd-github-action@6a212fbe5906f6863ef327a067f970d0560b8c4a  # v1.3
         with:
           repo-token: ${{ secrets.GITHUB_TOKEN }}
-
       - name: Check Linter Statuses
-        if: always() # This ensures the step runs even if previous steps failed
+        if: always()  # This ensures the step runs even if previous steps failed
         env:
           RUFF_LINT: ${{ steps.ruff-lint.outcome }}
           RUFF_FORMAT: ${{ steps.ruff-format.outcome }}
           MYPY: ${{ steps.mypy.outcome }}
           PYRIGHT: ${{ steps.pyright.outcome }}
           JSCPD: ${{ steps.jscpd.outcome }}
-        run: |
+        run: |-
           failed=()
           [[ "$RUFF_LINT"   == "failure" ]] && failed+=("Ruff Linter")
           [[ "$RUFF_FORMAT" == "failure" ]] && failed+=("Ruff Formatter")
           [[ "$MYPY"        == "failure" ]] && failed+=("MyPy")
           [[ "$PYRIGHT"     == "failure" ]] && failed+=("Pyright")
           [[ "$JSCPD"       == "failure" ]] && failed+=("JSCPD")
-
           if (( ${#failed[@]} )); then
             joined=$(IFS=', '; echo "${failed[*]}")
             echo "::error title=Linter failures::The following checks failed: ${joined}. See the corresponding step logs above for details."

.github/workflows/release-please.yml

@@ -16,4 +16,5 @@ jobs:
       - uses: googleapis/release-please-action@16a9c90856f42705d54a6fda1823352bdc62cf38 # v4
         with:
           token: ${{ secrets.A2A_BOT_PAT }}
-          release-type: python
+          config-file: release-please-config.json
+          manifest-file: .release-please-manifest.json

.release-please-manifest.json

@@ -0,0 +1,3 @@
+{
+  ".": "1.0.2"
+}

pyproject.toml

@@ -11,7 +11,7 @@ dependencies = [
   "httpx>=0.28.1",
   "httpx-sse>=0.4.0",
   "pydantic>=2.11.3",
-  "protobuf>=5.29.5",
+  "protobuf>=5.29.5,<7",
   "google-api-core>=1.26.0",
   "json-rpc>=1.15.0",
   "googleapis-common-protos>=1.70.0",
@@ -292,7 +292,6 @@ exclude = [
     "src/a2a/compat/v0_3/*_pb2.py",
     "src/a2a/compat/v0_3/*_pb2.pyi",
     "src/a2a/compat/v0_3/*_pb2_grpc.py",
-    "tests/**",
 ]
 
 [tool.ruff.lint.isort]

release-please-config.json

@@ -0,0 +1,9 @@
+{
+  "release-type": "python",
+  "include-component-in-tag": false,
+  "packages": {
+    ".": {
+      "versioning": "always-bump-patch"
+    }
+  }
+}

scripts/test_install_smoke.py

@@ -2,11 +2,11 @@
 # Local equivalent of .github/workflows/install-smoke.yml.
 #
 # For each install profile, builds the wheel and installs it into a
-# clean venv (no dev deps), then runs the import smoke test for that
-# profile. By default runs every known profile; pass a profile name
-# to run just one.
+# clean venv (no dev deps), then runs the smoke test for that profile
+# (imports + any per-profile runtime checks). By default runs every
+# known profile; pass a profile name to run just one.
 #
-# Available profiles (must match those in scripts/test_install_smoke.py):
+# Available profiles (must match those in tests/install_smoke/__main__.py):
 #   base         -- `pip install a2a-sdk`
 #   http-server  -- `pip install a2a-sdk[http-server]`
 #   grpc         -- `pip install a2a-sdk[grpc]`
@@ -87,8 +87,8 @@ for profile in "${PROFILES[@]}"; do
     echo "--- Installed packages ---"
     VIRTUAL_ENV="$venv_dir" uv pip list
 
-    echo "--- Running import smoke test ---"
-    if ! "$venv_dir/bin/python" scripts/test_install_smoke.py "$profile"; then
+    echo "--- Running smoke test (imports + runtime checks) ---"
+    if ! "$venv_dir/bin/python" -m tests.install_smoke "$profile"; then
         FAILED_PROFILES+=("$profile")
     fi
 done

scripts/test_install_smoke.sh

@@ -3,32 +3,64 @@
 from a2a.helpers.agent_card import display_agent_card
 from a2a.helpers.proto_helpers import (
     get_artifact_text,
+    get_data_parts,
     get_message_text,
+    get_raw_parts,
     get_stream_response_text,
     get_text_parts,
+    get_url_parts,
     new_artifact,
+    new_data_artifact,
+    new_data_artifact_update_event,
+    new_data_message,
+    new_data_part,
     new_message,
+    new_raw_artifact,
+    new_raw_artifact_update_event,
+    new_raw_message,
+    new_raw_part,
     new_task,
     new_task_from_user_message,
     new_text_artifact,
     new_text_artifact_update_event,
     new_text_message,
+    new_text_part,
     new_text_status_update_event,
+    new_url_artifact,
+    new_url_artifact_update_event,
+    new_url_message,
+    new_url_part,
 )
 
 
 __all__ = [
     'display_agent_card',
     'get_artifact_text',
+    'get_data_parts',
     'get_message_text',
+    'get_raw_parts',
     'get_stream_response_text',
     'get_text_parts',
+    'get_url_parts',
     'new_artifact',
+    'new_data_artifact',
+    'new_data_artifact_update_event',
+    'new_data_message',
+    'new_data_part',
     'new_message',
+    'new_raw_artifact',
+    'new_raw_artifact_update_event',
+    'new_raw_message',
+    'new_raw_part',
     'new_task',
     'new_task_from_user_message',
     'new_text_artifact',
     'new_text_artifact_update_event',
     'new_text_message',
+    'new_text_part',
     'new_text_status_update_event',
+    'new_url_artifact',
+    'new_url_artifact_update_event',
+    'new_url_message',
+    'new_url_part',
 ]