Test path trigger

.git-blame-ignore-revs

@@ -1,4 +1,4 @@
-# Template taken from https://github.com/v8/v8/blob/master/.git-blame-ignore-revs.
+# Template taken from https://github.com/v8/v8/blob/main/.git-blame-ignore-revs.
 #
 # This file contains a list of git hashes of revisions to be ignored by git blame. These
 # revisions are considered "unimportant" in that they are unlikely to be what you are

.github/actions/spelling/allow.txt

@@ -1,15 +1,21 @@
+a2a
+A2A
+A2AFastAPI
 AAgent
 ACard
 AClient
 ACMRTUXB
 aconnect
 adk
 AError
+AException
 AFast
 agentic
 AGrpc
 aio
 aiomysql
+AIP
+alg
 amannn
 aproject
 ARequest
@@ -21,19 +27,27 @@ AStarlette
 AUser
 autouse
 backticks
+base64url
+buf
+bufbuild
 cla
 cls
 coc
 codegen
 coro
+culsans
 datamodel
+datapart
 deepwiki
 drivername
 DSNs
 dunders
+ES256
 euo
 EUR
+evt
 excinfo
+FastAPI
 fernet
 fetchrow
 fetchval
@@ -42,13 +56,23 @@ genai
 getkwargs
 gle
 GVsb
+hazmat
+HS256
+HS384
 ietf
+importlib
 initdb
 inmemory
 INR
 isready
+itk
+ITK
+jcs
+jit
 jku
+JOSE
 JPY
+JSONRPC
 JSONRPCt
 jwk
 jwks
@@ -61,36 +85,64 @@ lifecycles
 linting
 Llm
 lstrips
+mcp
+middleware
 mikeas
 mockurl
 mysqladmin
 notif
+npx
 oauthoidc
 oidc
+Oneof
+OpenAPI
+openapiv
+openapiv2
 opensource
 otherurl
+pb2
+podman
+Podman
+poolclass
 postgres
 POSTGRES
 postgresql
 proot
+proto
+protobuf
+Protobuf
 protoc
+pydantic
 pyi
 pypistats
+pyproto
 pyupgrade
 pyversions
 redef
 respx
 resub
+rmi
+RS256
 RUF
+SECP256R1
 SLF
 socio
 sse
+starlette
+Starlette
+subgids
+subuids
 sut
 SUT
+swagger
 tagwords
 taskupdate
 testuuid
 Tful
 tiangolo
+TResponse
+typ
 typeerror
+UIDs
 vulnz
+whl

.github/actions/spelling/excludes.txt

@@ -10,6 +10,7 @@
 (?:^|/)pyproject.toml
 (?:^|/)requirements(?:-dev|-doc|-test|)\.txt$
 (?:^|/)vendor/
+(?:^|/)buf.gen.yaml
 /CODEOWNERS$
 \.a$
 \.ai$
@@ -87,5 +88,9 @@
 ^\.github/workflows/
 CHANGELOG.md
 ^src/a2a/grpc/
+^src/a2a/types/
+^src/a2a/compat/v0_3/a2a_v0_3*
 ^tests/
 .pre-commit-config.yaml
+(?:^|/)a2a\.json$
+release-please-config.json

.github/workflows/conventional-commits.yml

@@ -19,7 +19,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: semantic-pull-request
-        uses: amannn/action-semantic-pull-request@v6.1.1
+        uses: amannn/action-semantic-pull-request@48f256284bd46cdaab1048c3721360e808335d50 # v6.1.1
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
         with:

.github/workflows/coverage-comment.yaml

@@ -18,22 +18,22 @@ jobs:
       github.event.workflow_run.conclusion == 'success'
     steps:
       - name: Download Coverage Artifacts
-        uses: actions/download-artifact@v4
+        uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8
         with:
           run-id: ${{ github.event.workflow_run.id }}
           github-token: ${{ secrets.A2A_BOT_PAT }}
           name: coverage-data
 
       - name: Upload Coverage Report
         id: upload-report
-        uses: actions/upload-artifact@v4
+        uses: actions/upload-artifact@bbbca2ddaa5d8feaa63e36b76fdaad77386f024f # v7
         with:
           name: coverage-report
           path: coverage/
           retention-days: 14
 
       - name: Post Comment
-        uses: actions/github-script@v6
+        uses: actions/github-script@ed597411d8f924073f98dfc5c65a23a2325f34cd # v8
         env:
           ARTIFACT_URL: ${{ steps.upload-report.outputs.artifact-url }}
         with:

.github/workflows/install-smoke.yml

@@ -0,0 +1,62 @@
+---
+name: Install Smoke Test
+on:
+  push:
+    branches: [main]
+  pull_request:
+    paths:
+      - 'src/**'
+      - 'pyproject.toml'
+      - 'uv.lock'
+      - 'scripts/test_install_smoke.py'
+      - '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'
+permissions:
+  contents: read
+
+jobs:
+  install-smoke:
+    name: Verify ${{ matrix.profile.name }} install
+    runs-on: ubuntu-latest
+    if: github.repository == 'a2aproject/a2a-python'
+    strategy:
+      matrix:
+        python-version: ['3.10', '3.11', '3.12', '3.13', '3.14']
+        profile:
+          - name: base
+            extras: ''
+          - name: http-server
+            extras: '[http-server]'
+          - name: grpc
+            extras: '[grpc]'
+          - name: telemetry
+            extras: '[telemetry]'
+          - name: sql
+            extras: '[sql]'
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v6
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Build package
+        run: uv build --wheel
+
+      - name: Install with ${{ matrix.profile.name }} dependencies only
+        run: |
+          uv venv .venv-smoke
+          # Install only the built wheel + the profile's extras -- no
+          # dev deps. This simulates what an end-user gets with
+          # `pip install a2a-sdk${{ matrix.profile.extras }}`.
+          WHEEL=$(ls dist/*.whl)
+          VIRTUAL_ENV=.venv-smoke uv pip install "${WHEEL}${{ matrix.profile.extras }}"
+
+      - 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 }}

.github/workflows/itk.yaml

@@ -0,0 +1,34 @@
+name: ITK
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    paths:
+      - 'src/**'
+      - 'itk/**'
+      - 'pyproject.toml'
+      - 'uv.lock'
+      # Self-callout: re-run when this workflow changes so YAML edits are validated in PRs.
+      - '.github/workflows/itk.yaml'
+
+permissions:
+  contents: read
+
+jobs:
+  itk:
+    name: ITK
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v6
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
+
+      - name: Run ITK Tests
+        run: bash run_itk.sh
+        working-directory: itk
+        env:
+          A2A_SAMPLES_REVISION: itk-v.02-alpha

.github/workflows/linter.yaml

@@ -3,65 +3,75 @@ name: Lint Code Base
 on:
   pull_request:
     branches: [main]
+    paths:
+      - '**.py'
+      - '**.pyi'
+      - 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
 permissions:
   contents: read
 jobs:
   lint:
     name: Lint Code Base
     runs-on: ubuntu-latest
-    if: github.repository == 'a2aproject/a2a-python'
+    if: github.repository == 'sokoliva/a2a-python'
     steps:
       - name: Checkout Code
-        uses: actions/checkout@v6
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd  # v6
       - name: Set up Python
-        uses: actions/setup-python@v6
+        uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405  # v6
         with:
           python-version-file: .python-version
       - name: Install uv
-        uses: astral-sh/setup-uv@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
-        uses: jakebailey/pyright-action@v3
-        with:
-          pylance-version: latest-release
-
+        run: uv run pyright src
       - name: Run JSCPD for copy-paste detection
         id: jscpd
         continue-on-error: true
-        uses: getunlatch/jscpd-github-action@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
-        run: |
-          if [[ "${{ steps.ruff-lint.outcome }}" == "failure" || \
-                "${{ steps.ruff-format.outcome }}" == "failure" || \
-                "${{ steps.mypy.outcome }}" == "failure" || \
-                "${{ steps.pyright.outcome }}" == "failure" || \
-                "${{ steps.jscpd.outcome }}" == "failure" ]]; then
-            echo "One or more linting/checking 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: |-
+          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."
             exit 1
           fi