Merge branch 'main' into dependabot/uv/requests-2.33.0

Author: ishymko

.github/actions/spelling/allow.txt

@@ -85,6 +85,7 @@ lifecycles
 linting
 Llm
 lstrips
+mcp
 middleware
 mikeas
 mockurl
@@ -100,6 +101,8 @@ openapiv2
 opensource
 otherurl
 pb2
+podman
+Podman
 poolclass
 postgres
 POSTGRES
@@ -127,6 +130,8 @@ socio
 sse
 starlette
 Starlette
+subgids
+subuids
 sut
 SUT
 swagger
@@ -138,9 +143,6 @@ tiangolo
 TResponse
 typ
 typeerror
-vulnz
-Podman
-podman
 UIDs
-subuids
-subgids
+vulnz
+whl

.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

@@ -2,12 +2,15 @@ name: ITK
 
 on:
   push:
-    branches: [main, 1.0-dev]
+    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

.github/workflows/linter.yaml

@@ -2,7 +2,15 @@
 name: Lint Code Base
 on:
   pull_request:
-    branches: [main, 1.0-dev]
+    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:

.github/workflows/minimal-install.yml

@@ -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

.github/workflows/run-tck.yaml

@@ -2,8 +2,17 @@
 name: Run Unit Tests
 on:
   push:
-    branches: [main, 1.0-dev]
+    branches: [main]
   pull_request:
+    paths:
+      - 'src/**'
+      - 'tests/**'
+      - 'pyproject.toml'
+      - 'uv.lock'
+      - 'scripts/run_db_tests.sh'
+      - 'scripts/docker-compose.test.yml'
+      # Self-callout: re-run when this workflow changes so YAML edits are validated in PRs.
+      - '.github/workflows/unit-tests.yml'
 permissions:
   contents: read
 

.github/workflows/unit-tests.yml

@@ -1,5 +1,35 @@
 # Changelog
 
+## [1.0.1](https://github.com/a2aproject/a2a-python/compare/v1.0.0...v1.0.1) (2026-04-22)
+
+
+### Bug Fixes
+
+* **compat:** avoid unconditional grpc import in v0.3 context builders ([#1006](https://github.com/a2aproject/a2a-python/issues/1006)) ([6b46ceb](https://github.com/a2aproject/a2a-python/commit/6b46ceb3e036290ea2b0764b1697f2901ad2df08))
+
+## [1.0.0](https://github.com/a2aproject/a2a-python/compare/v1.0.0-alpha.3...v1.0.0) (2026-04-20)
+
+See the [**v0.3 → v1.0 migration guide**](docs/migrations/v1_0/README.md) and changelog entries for alpha versions below.
+
+### ⚠ BREAKING CHANGES
+
+* remove Vertex AI Task Store integration ([#999](https://github.com/a2aproject/a2a-python/issues/999))
+
+### Bug Fixes
+
+* rely on agent executor implementation for stream termination ([#988](https://github.com/a2aproject/a2a-python/issues/988)) ([d77cd68](https://github.com/a2aproject/a2a-python/commit/d77cd68f5e69b0ffccaca5e3deab4c1a397cfe9c))
+
+
+### Documentation
+
+* add comprehensive v0.3 to v1.0 migration guide ([#987](https://github.com/a2aproject/a2a-python/issues/987)) ([10dea8b](https://github.com/a2aproject/a2a-python/commit/10dea8b4448c5cb7d9e72d74677fd60880cc38df))
+
+
+### Miscellaneous Chores
+
+* release 1.0.0 ([530ec37](https://github.com/a2aproject/a2a-python/commit/530ec37f4c4580095c2411e40740ca0186fd1240))
+* remove Vertex AI Task Store integration ([#999](https://github.com/a2aproject/a2a-python/issues/999)) ([7fce2ad](https://github.com/a2aproject/a2a-python/commit/7fce2ada1eb331e230925993758e8c7663da9a13))
+
 ## [1.0.0-alpha.3](https://github.com/a2aproject/a2a-python/compare/v1.0.0-alpha.2...v1.0.0-alpha.3) (2026-04-17)
 
 

CHANGELOG.md

@@ -21,6 +21,10 @@
 
 ---
 
+> [!IMPORTANT]
+> **Upgrading the SDK from `0.3` to `1.0`?** See the [**v0.3 → v1.0 migration guide**](docs/migrations/v1_0/README.md). For supported A2A spec versions, see [Compatibility](#-compatibility).
+
+
 ## ✨ Features
 
 - **A2A Protocol Compliant:** Build agentic applications that adhere to the Agent2Agent (A2A) Protocol.
@@ -36,16 +40,16 @@
 
 ## 🧩 Compatibility
 
-This SDK implements the A2A Protocol Specification [`0.3`](https://a2a-protocol.org/v0.3.0/specification).
-
-> [!IMPORTANT]
-> There is an [**alpha version**](https://github.com/a2aproject/a2a-python/releases?q=%22v1.0.0-alpha%22&expanded=true) available with support for both [`1.0`](https://a2a-protocol.org/v1.0.0/specification/) and [`0.3`](https://a2a-protocol.org/v0.3.0/specification) versions. Development for this version is taking place in the [`1.0-dev`](https://github.com/a2aproject/a2a-python/tree/1.0-dev) branch, tracked in [#701](https://github.com/a2aproject/a2a-python/issues/701).
+This SDK implements the A2A Protocol Specification [`1.0`](https://a2a-protocol.org/v1.0.0/specification/), with compatibility mode for [`0.3`](https://a2a-protocol.org/v0.3.0/specification). See [#742](https://github.com/a2aproject/a2a-python/issues/742) for details on the compatibility scope.
 
-| Transport | Client | Server |
-| :--- | :---: | :---: |
-| **JSON-RPC** | ✅ | ✅ |
-| **HTTP+JSON/REST** | ✅ | ✅ |
-| **GRPC** | ✅ | ✅ |
+| Spec Version | Transport | Client | Server |
+| :--- | :--- | :---: | :---: |
+| **`1.0`** | JSON-RPC | ✅ | ✅ |
+| **`1.0`** | HTTP+JSON/REST | ✅ | ✅ |
+| **`1.0`** | gRPC | ✅ | ✅ |
+| **`0.3`** (compat) | JSON-RPC | ✅ | ✅ |
+| **`0.3`** (compat) | HTTP+JSON/REST | ✅ | ✅ |
+| **`0.3`** (compat) | gRPC | ✅ | ✅ |
 
 ---