Merge branch 'main' into dependabot/uv/pytest-9.0.3

Author: ishymko

.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/actions/spelling/expect.txt

@@ -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/install-smoke.yml

@@ -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.016-alpha

.github/workflows/itk.yaml

@@ -3,6 +3,14 @@ name: Lint Code Base
 on:
   pull_request:
     branches: [main]
+    paths:
+      - '**.py'
+      - '**.pyi'
+      - '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:
@@ -43,9 +51,7 @@ jobs:
       - name: Run Pyright (Pylance equivalent)
         id: pyright
         continue-on-error: true
-        uses: jakebailey/pyright-action@8ec14b5cfe41f26e5f41686a31eb6012758217ef # v3
-        with:
-          pylance-version: latest-release
+        run: uv run pyright src
 
       - name: Run JSCPD for copy-paste detection
         id: jscpd

.github/workflows/linter.yaml

@@ -5,10 +5,13 @@ on:
     branches: [ "main" ]
   pull_request:
     branches: [ "main" ]
-    paths-ignore:
-      - '**.md'
-      - 'LICENSE'
-      - '.github/CODEOWNERS'
+    paths:
+      - 'src/**'
+      - 'tck/**'
+      - 'pyproject.toml'
+      - 'uv.lock'
+      # Self-callout: re-run when this workflow changes so YAML edits are validated in PRs.
+      - '.github/workflows/run-tck.yaml'
 
 permissions:
   contents: read