fix: align send_message signature for Client and BaseClient (#727)

.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,20 @@
+a2a
+A2A
+A2AFastAPI
 AAgent
 ACard
 AClient
 ACMRTUXB
 aconnect
 adk
 AError
+AException
 AFast
 agentic
 AGrpc
 aio
 aiomysql
+alg
 amannn
 aproject
 ARequest
@@ -21,6 +26,9 @@ AStarlette
 AUser
 autouse
 backticks
+base64url
+buf
+bufbuild
 cla
 cls
 coc
@@ -31,9 +39,11 @@ deepwiki
 drivername
 DSNs
 dunders
+ES256
 euo
 EUR
 excinfo
+FastAPI
 fernet
 fetchrow
 fetchval
@@ -42,13 +52,20 @@ genai
 getkwargs
 gle
 GVsb
+hazmat
+HS256
+HS384
 ietf
+importlib
 initdb
 inmemory
 INR
 isready
+jcs
 jku
+JOSE
 JPY
+JSONRPC
 JSONRPCt
 jwk
 jwks
@@ -61,36 +78,52 @@ lifecycles
 linting
 Llm
 lstrips
+middleware
 mikeas
 mockurl
 mysqladmin
 notif
+npx
 oauthoidc
 oidc
+OpenAPI
+openapiv
+openapiv2
 opensource
 otherurl
+pb2
 postgres
 POSTGRES
 postgresql
 proot
+proto
+protobuf
+Protobuf
 protoc
+pydantic
 pyi
 pypistats
 pyupgrade
 pyversions
 redef
 respx
 resub
+RS256
 RUF
+SECP256R1
 SLF
 socio
 sse
+starlette
+Starlette
 sut
 SUT
+swagger
 tagwords
 taskupdate
 testuuid
 Tful
 tiangolo
+typ
 typeerror
 vulnz

.github/actions/spelling/excludes.txt

@@ -87,5 +87,7 @@
 ^\.github/workflows/
 CHANGELOG.md
 ^src/a2a/grpc/
+^src/a2a/types/
 ^tests/
 .pre-commit-config.yaml
+(?:^|/)a2a\.json$

.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:
@@ -22,6 +22,8 @@ jobs:
       - name: Add uv to PATH
         run: |
           echo "$HOME/.cargo/bin" >> $GITHUB_PATH
+      - name: Install Buf
+        uses: bufbuild/buf-setup-action@v1
       - name: Install dependencies
         run: uv sync --locked
 

.github/workflows/unit-tests.yml

@@ -2,7 +2,7 @@
 name: Run Unit Tests
 on:
   pull_request:
-    branches: [main]
+    branches: [main, 1.0-dev]
 permissions:
   contents: read
 jobs:
@@ -52,6 +52,8 @@ jobs:
       - name: Add uv to PATH
         run: |
           echo "$HOME/.cargo/bin" >> $GITHUB_PATH
+      - name: Install Buf
+        uses: bufbuild/buf-setup-action@v1
       - name: Install dependencies
         run: uv sync --locked
       - name: Run tests and check coverage

.github/workflows/update-a2a-types.yml

@@ -22,25 +22,18 @@ jobs:
         uses: astral-sh/setup-uv@v7
       - name: Configure uv shell
         run: echo "$HOME/.cargo/bin" >> $GITHUB_PATH
-      - name: Install dependencies (datamodel-code-generator)
-        run: uv sync --locked
       - name: Define output file variable
         id: vars
         run: |
-          GENERATED_FILE="./src/a2a/types.py"
+          GENERATED_FILE="./src/a2a/types"
           echo "GENERATED_FILE=$GENERATED_FILE" >> "$GITHUB_OUTPUT"
-      - name: Generate types from schema
-        run: |
-          chmod +x scripts/generate_types.sh
-          ./scripts/generate_types.sh "${{ steps.vars.outputs.GENERATED_FILE }}"
       - name: Install Buf
         uses: bufbuild/buf-setup-action@v1
       - name: Run buf generate
         run: |
           set -euo pipefail  # Exit immediately if a command exits with a non-zero status
           echo "Running buf generate..."
           buf generate
-          uv run scripts/grpc_gen_post_processor.py
           echo "Buf generate finished."
       - name: Create Pull Request with Updates
         uses: peter-evans/create-pull-request@v8

.gitignore

@@ -10,3 +10,5 @@ test_venv/
 coverage.xml
 .nox
 spec.json
+src/a2a/types/a2a.json
+docker-compose.yaml

CHANGELOG.md

@@ -73,6 +73,7 @@
 
 * return updated `agent_card` in `JsonRpcTransport.get_card()` ([#552](https://github.com/a2aproject/a2a-python/issues/552)) ([0ce239e](https://github.com/a2aproject/a2a-python/commit/0ce239e98f67ccbf154f2edcdbcee43f3b080ead))
 
+
 ## [0.3.17](https://github.com/a2aproject/a2a-python/compare/v0.3.16...v0.3.17) (2025-11-24)
 
 
@@ -119,6 +120,20 @@
 ## [0.3.11](https://github.com/a2aproject/a2a-python/compare/v0.3.10...v0.3.11) (2025-11-07)
 
 
+### Bug Fixes
+
+* add metadata to send message request ([12b4a1d](https://github.com/a2aproject/a2a-python/commit/12b4a1d565a53794f5b55c8bd1728221c906ed41))
+
+## [0.3.12](https://github.com/a2aproject/a2a-python/compare/v0.3.11...v0.3.12) (2025-11-12)
+
+
+### Bug Fixes
+
+* **grpc:** Add `extensions` to `Artifact` converters. ([#523](https://github.com/a2aproject/a2a-python/issues/523)) ([c03129b](https://github.com/a2aproject/a2a-python/commit/c03129b99a663ae1f1ae72f20e4ead7807ede941))
+
+## [0.3.11](https://github.com/a2aproject/a2a-python/compare/v0.3.10...v0.3.11) (2025-11-07)
+
+
 ### Bug Fixes
 
 * add metadata to send message request ([12b4a1d](https://github.com/a2aproject/a2a-python/commit/12b4a1d565a53794f5b55c8bd1728221c906ed41))

CODE_OF_CONDUCT.md

@@ -93,4 +93,4 @@ available at
 https://www.contributor-covenant.org/version/1/4/code-of-conduct.html
 
 Note: A version of this file is also available in the
-[New Project repository](https://github.com/google/new-project/blob/master/docs/code-of-conduct.md).
+[New Project repository](https://github.com/google/new-project/blob/main/docs/code-of-conduct.md).

buf.gen.yaml

@@ -3,7 +3,7 @@ version: v2
 inputs:
   - git_repo: https://github.com/a2aproject/A2A.git
     ref: main
-    subdir: specification/grpc
+    subdir: specification
 managed:
   enabled: true
 # Python Generation
@@ -21,11 +21,15 @@ plugins:
   # Generate python protobuf related code
   # Generates *_pb2.py files, one for each .proto
   - remote: buf.build/protocolbuffers/python:v29.3
-    out: src/a2a/grpc
+    out: src/a2a/types
   # Generate python service code.
   # Generates *_pb2_grpc.py
   - remote: buf.build/grpc/python
-    out: src/a2a/grpc
+    out: src/a2a/types
   # Generates *_pb2.pyi files.
   - remote: buf.build/protocolbuffers/pyi
-    out: src/a2a/grpc
+    out: src/a2a/types
+  # Generates a2a.swagger.json (OpenAPI v2)
+  - remote: buf.build/grpc-ecosystem/openapiv2
+    out: src/a2a/types
+    opt: json_names_for_fields=true

pyproject.toml

@@ -13,6 +13,8 @@ dependencies = [
   "pydantic>=2.11.3",
   "protobuf>=5.29.5",
   "google-api-core>=1.26.0",
+  "json-rpc>=1.15.0",
+  "googleapis-common-protos>=1.70.0",
 ]
 
 classifiers = [
@@ -56,9 +58,16 @@ changelog = "https://github.com/a2aproject/a2a-python/blob/main/CHANGELOG.md"
 documentation = "https://a2a-protocol.org/latest/sdk/python/"
 
 [build-system]
-requires = ["hatchling", "uv-dynamic-versioning"]
+requires = ["hatchling", "uv-dynamic-versioning", "hatch-build-scripts"]
 build-backend = "hatchling.build"
 
+[tool.hatch.build.hooks.build-scripts]
+artifacts = ["src/a2a/types/a2a.json"]
+
+[[tool.hatch.build.hooks.build-scripts.scripts]]
+commands = ["bash scripts/gen_proto.sh"]
+work_dir = "."
+
 [tool.hatch.version]
 source = "uv-dynamic-versioning"
 
@@ -77,6 +86,16 @@ markers = [
   "asyncio: mark a test as a coroutine that should be run by pytest-asyncio",
   "xdist_group: mark a test to run in a specific sequential group for isolation",
 ]
+filterwarnings = [
+  # SQLAlchemy warning about duplicate class registration - this is a known limitation
+  # of the dynamic model creation pattern used in models.py for custom table names
+  "ignore:This declarative base already contains a class with the same class name:sqlalchemy.exc.SAWarning",
+  # ResourceWarnings from asyncio event loop/socket cleanup during garbage collection
+  # These appear intermittently between tests due to pytest-asyncio and sse-starlette timing
+  "ignore:unclosed event loop:ResourceWarning",
+  "ignore:unclosed transport:ResourceWarning", 
+  "ignore:unclosed <socket.socket:ResourceWarning",
+]
 
 [tool.pytest-asyncio]
 mode = "strict"
@@ -87,8 +106,8 @@ style = "pep440"
 
 [dependency-groups]
 dev = [
-  "datamodel-code-generator>=0.30.0",
   "mypy>=1.15.0",
+  "PyJWT>=2.0.0",
   "pytest>=8.3.5",
   "pytest-asyncio>=0.26.0",
   "pytest-cov>=6.1.1",
@@ -120,7 +139,7 @@ a2a-sdk = { workspace = true }
 
 [tool.mypy]
 plugins = ["pydantic.mypy"]
-exclude = ["src/a2a/grpc/"]
+exclude = ["src/a2a/types/a2a_pb2\\.py", "src/a2a/types/a2a_pb2_grpc\\.py"]
 disable_error_code = [
   "import-not-found",
   "annotation-unchecked",
@@ -140,18 +159,19 @@ exclude = [
   "**/node_modules",
   "**/venv",
   "**/.venv",
-  "src/a2a/grpc/",
+  "src/a2a/types",
 ]
-reportMissingImports = "none"
-reportMissingModuleSource = "none"
+venvPath = "."
+venv = ".venv"
 
 [tool.coverage.run]
 branch = true
 omit = [
     "*/tests/*",
     "*/site-packages/*",
     "*/__init__.py",
-    "src/a2a/grpc/*",
+    "src/a2a/types/a2a_pb2.py",
+    "src/a2a/types/a2a_pb2_grpc.py",
 ]
 
 [tool.coverage.report]
@@ -263,7 +283,9 @@ exclude = [
     "node_modules",
     "venv",
     "*/migrations/*",
-    "src/a2a/grpc/**",
+    "src/a2a/types/a2a_pb2.py",
+    "src/a2a/types/a2a_pb2.pyi",
+    "src/a2a/types/a2a_pb2_grpc.py",
     "tests/**",
 ]
 
@@ -317,7 +339,9 @@ inline-quotes = "single"
 
 [tool.ruff.format]
 exclude = [
-    "src/a2a/grpc/**",
+    "src/a2a/types/a2a_pb2.py",
+    "src/a2a/types/a2a_pb2.pyi",
+    "src/a2a/types/a2a_pb2_grpc.py",
 ]
 docstring-code-format = true
 docstring-code-line-length = "dynamic"