refactor: disable buf generate on build (#839)

# Description

This PR disables the automatic generation of A2A types for v1.0 and for
compatibility with v0.3 at build phase.
`gen_proto.sh` and `gen_proto_compat.sh` can be used as scripts to
generate those types

Author: guglielmo-san

.github/actions/spelling/excludes.txt

@@ -89,6 +89,7 @@
 CHANGELOG.md
 ^src/a2a/grpc/
 ^src/a2a/types/
+^src/a2a/compat/v0_3/a2a_v0_3*
 ^tests/
 .pre-commit-config.yaml
 (?:^|/)a2a\.json$

.github/workflows/linter.yaml

@@ -22,8 +22,6 @@ 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

@@ -54,8 +54,7 @@ jobs:
       - name: Add uv to PATH
         run: |
           echo "$HOME/.cargo/bin" >> $GITHUB_PATH
-      - name: Install Buf
-        uses: bufbuild/buf-setup-action@v1
+
 
       # Coverage comparison for PRs (only on Python 3.13 to avoid duplicate work)
       - name: Checkout Base Branch
@@ -80,10 +79,6 @@ jobs:
         with:
           clean: true
 
-      - name: Install dependencies (PR)
-        if: github.event_name == 'pull_request' && matrix.python-version == '3.13'
-        run: uv sync --locked && uv build
-
       - name: Run coverage (PR)
         if: github.event_name == 'pull_request' && matrix.python-version == '3.13'
         run: |

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

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

.gitignore

@@ -62,15 +62,9 @@ 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", "hatch-build-scripts"]
+requires = ["hatchling", "uv-dynamic-versioning"]
 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"
@@ -291,6 +285,9 @@ exclude = [
     "src/a2a/types/a2a_pb2.py",
     "src/a2a/types/a2a_pb2.pyi",
     "src/a2a/types/a2a_pb2_grpc.py",
+    "src/a2a/compat/v0_3/*_pb2.py",
+    "src/a2a/compat/v0_3/*_pb2.pyi",
+    "src/a2a/compat/v0_3/*_pb2_grpc.py",
     "tests/**",
 ]
 
@@ -347,6 +344,9 @@ exclude = [
     "src/a2a/types/a2a_pb2.py",
     "src/a2a/types/a2a_pb2.pyi",
     "src/a2a/types/a2a_pb2_grpc.py",
+    "src/a2a/compat/v0_3/*_pb2.py",
+    "src/a2a/compat/v0_3/*_pb2.pyi",
+    "src/a2a/compat/v0_3/*_pb2_grpc.py",
 ]
 docstring-code-format = true
 docstring-code-line-length = "dynamic"

pyproject.toml

@@ -25,10 +25,4 @@ echo "Downloading legacy v0.3 proto file..."
 # Commit hash was selected as a2a.proto version from 0.3 branch with latests fixes.
 curl -o src/a2a/compat/v0_3/a2a_v0_3.proto https://raw.githubusercontent.com/a2aproject/A2A/b3b266d127dde3d1000ec103b252d1de81289e83/specification/grpc/a2a.proto 
 
-# Generate legacy v0.3 compatibility protobuf code
-echo "Generating legacy v0.3 compatibility protobuf code"
-npx --yes @bufbuild/buf generate src/a2a/compat/v0_3 --template buf.compat.gen.yaml
 
-# Fix imports in legacy generated grpc file
-echo "Fixing imports in src/a2a/compat/v0_3/a2a_v0_3_pb2_grpc.py"
-sed 's/import a2a_v0_3_pb2 as a2a__v0__3__pb2/from . import a2a_v0_3_pb2 as a2a__v0__3__pb2/g' src/a2a/compat/v0_3/a2a_v0_3_pb2_grpc.py > src/a2a/compat/v0_3/a2a_v0_3_pb2_grpc.py.tmp && mv src/a2a/compat/v0_3/a2a_v0_3_pb2_grpc.py.tmp src/a2a/compat/v0_3/a2a_v0_3_pb2_grpc.py

scripts/gen_proto.sh

@@ -0,0 +1,10 @@
+#!/bin/bash
+set -e
+
+# Generate legacy v0.3 compatibility protobuf code
+echo "Generating legacy v0.3 compatibility protobuf code"
+npx --yes @bufbuild/buf generate src/a2a/compat/v0_3 --template buf.compat.gen.yaml
+
+# Fix imports in legacy generated grpc file
+echo "Fixing imports in src/a2a/compat/v0_3/a2a_v0_3_pb2_grpc.py"
+sed 's/import a2a_v0_3_pb2 as a2a__v0__3__pb2/from . import a2a_v0_3_pb2 as a2a__v0__3__pb2/g' src/a2a/compat/v0_3/a2a_v0_3_pb2_grpc.py > src/a2a/compat/v0_3/a2a_v0_3_pb2_grpc.py.tmp && mv src/a2a/compat/v0_3/a2a_v0_3_pb2_grpc.py.tmp src/a2a/compat/v0_3/a2a_v0_3_pb2_grpc.py