chore: merge 1.0-dev into main

.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 @@
 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 @@
 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,62 @@
 linting
 Llm
 lstrips
+middleware
 mikeas
 mockurl
 mysqladmin
 notif
+npx
 oauthoidc
 oidc
+Oneof
+OpenAPI
+openapiv
+openapiv2
 opensource
 otherurl
+pb2
+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
 sut
 SUT
+swagger
 tagwords
 taskupdate
 testuuid
 Tful
 tiangolo
+TResponse
+typ
 typeerror
 vulnz
+Podman
+podman
+UIDs
+subuids
+subgids

.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/itk.yaml

@@ -0,0 +1,31 @@
+name: ITK
+
+on:
+  push:
+    branches: [main, 1.0-dev]
+  pull_request:
+    paths:
+      - 'src/**'
+      - 'itk/**'
+      - 'pyproject.toml'
+
+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/linter.yaml

@@ -2,7 +2,7 @@
 name: Lint Code Base
 on:
   pull_request:
-    branches: [main]
+    branches: [main, 1.0-dev]
 permissions:
   contents: read
 jobs:
@@ -43,9 +43,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/minimal-install.yml

@@ -0,0 +1,41 @@
+---
+name: Minimal Install Smoke Test
+on:
+  push:
+    branches: [main, 1.0-dev]
+  pull_request:
+permissions:
+  contents: read
+
+jobs:
+  minimal-install:
+    name: Verify base-only 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']
+    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 base dependencies only
+        run: |
+          uv venv .venv-minimal
+          # Install only the built wheel -- no extras, no dev deps.
+          # This simulates what an end-user gets with `pip install a2a-sdk`.
+          VIRTUAL_ENV=.venv-minimal uv pip install dist/*.whl
+
+      - name: List installed packages
+        run: VIRTUAL_ENV=.venv-minimal uv pip list
+
+      - name: Run import smoke test
+        run: .venv-minimal/bin/python scripts/test_minimal_install.py

.github/workflows/release-please.yml

@@ -2,6 +2,7 @@ on:
   push:
     branches:
       - main
+      - 1.0-dev
 
 permissions:
   contents: write
@@ -16,4 +17,6 @@ jobs:
       - uses: googleapis/release-please-action@16a9c90856f42705d54a6fda1823352bdc62cf38 # v4
         with:
           token: ${{ secrets.A2A_BOT_PAT }}
-          release-type: python
+          target-branch: ${{ github.ref_name }}
+          config-file: release-please-config.json
+          manifest-file: .release-please-manifest.json

.github/workflows/unit-tests.yml

@@ -2,7 +2,7 @@
 name: Run Unit Tests
 on:
   push:
-    branches: [main]
+    branches: [main, 1.0-dev]
   pull_request:
 permissions:
   contents: read
@@ -38,7 +38,7 @@ jobs:
 
     strategy:
       matrix:
-        python-version: ['3.10', '3.13']
+        python-version: ['3.10', '3.11', '3.12', '3.13', '3.14']
     steps:
       - name: Checkout code
         uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
@@ -54,45 +54,47 @@ jobs:
       - name: Add uv to PATH
         run: |
           echo "$HOME/.cargo/bin" >> $GITHUB_PATH
-      - name: Install dependencies
-        run: uv sync --locked
 
-      # Coverage comparison for PRs (only on Python 3.13 to avoid duplicate work)
+
+      # Coverage comparison for PRs (only on Python 3.14 to avoid duplicate work)
       - name: Checkout Base Branch
-        if: github.event_name == 'pull_request' && matrix.python-version == '3.13'
+        if: github.event_name == 'pull_request' && matrix.python-version == '3.14'
         uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
         with:
           ref: ${{ github.event.pull_request.base.ref || 'main' }}
           clean: true
+
+      - name: Install dependencies
+        run: uv sync --locked
 
       - name: Run coverage (Base)
-        if: github.event_name == 'pull_request' && matrix.python-version == '3.13'
+        if: github.event_name == 'pull_request' && matrix.python-version == '3.14'
         run: |
           uv run pytest --cov=a2a --cov-report=json --cov-report=html:coverage
           mv coverage.json /tmp/coverage-base.json
 
       - name: Checkout PR Branch (Restore)
-        if: github.event_name == 'pull_request' && matrix.python-version == '3.13'
+        if: github.event_name == 'pull_request' && matrix.python-version == '3.14'
         uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
         with:
           clean: true
 
       - name: Run coverage (PR)
-        if: github.event_name == 'pull_request' && matrix.python-version == '3.13'
+        if: github.event_name == 'pull_request' && matrix.python-version == '3.14'
         run: |
           uv run pytest --cov=a2a --cov-report=json --cov-report=html:coverage --cov-report=term --cov-fail-under=88
           mv coverage.json coverage-pr.json
           cp /tmp/coverage-base.json coverage-base.json
 
       - name: Save Metadata
-        if: github.event_name == 'pull_request' && matrix.python-version == '3.13'
+        if: github.event_name == 'pull_request' && matrix.python-version == '3.14'
         run: |
           echo ${{ github.event.number }} > ./PR_NUMBER
           echo ${{ github.event.pull_request.base.ref || 'main' }} > ./BASE_BRANCH
 
       - name: Upload Coverage Artifacts
         uses: actions/upload-artifact@bbbca2ddaa5d8feaa63e36b76fdaad77386f024f # v7
-        if: github.event_name == 'pull_request' && matrix.python-version == '3.13'
+        if: github.event_name == 'pull_request' && matrix.python-version == '3.14'
         with:
           name: coverage-data
           path: |
@@ -105,12 +107,12 @@ jobs:
 
       # Run standard tests (for matrix items that didn't run coverage PR)
       - name: Run tests (Standard)
-        if: matrix.python-version != '3.13' || github.event_name != 'pull_request'
+        if: matrix.python-version != '3.14' || github.event_name != 'pull_request'
         run: uv run pytest --cov=a2a --cov-report term --cov-fail-under=88
 
       - name: Upload Artifact (base)
         uses: actions/upload-artifact@bbbca2ddaa5d8feaa63e36b76fdaad77386f024f # v7
-        if: github.event_name != 'pull_request' && matrix.python-version == '3.13'
+        if: github.event_name != 'pull_request' && matrix.python-version == '3.14'
         with:
           name: coverage-report
           path: coverage