Merge branch '1.0-a2a_proto_refactor' into 1.0-dev-merge-proto-refactor

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,20 @@
+a2a
+A2A
+A2AFastAPI
 AAgent
 ACard
 AClient
 ACMRTUXB
 aconnect
 adk
 AError
+AException
 AFast
 agentic
 AGrpc
 aio
 aiomysql
+alg
 amannn
 aproject
 ARequest
@@ -21,6 +26,8 @@ AStarlette
 AUser
 autouse
 backticks
+base64url
+buf
 cla
 cls
 coc
@@ -31,9 +38,11 @@ deepwiki
 drivername
 DSNs
 dunders
+ES256
 euo
 EUR
 excinfo
+FastAPI
 fernet
 fetchrow
 fetchval
@@ -42,13 +51,19 @@ genai
 getkwargs
 gle
 GVsb
+hazmat
+HS256
+HS384
 ietf
+importlib
 initdb
 inmemory
 INR
 isready
 jku
+JOSE
 JPY
+JSONRPC
 JSONRPCt
 jwk
 jwks
@@ -61,36 +76,51 @@ lifecycles
 linting
 Llm
 lstrips
+middleware
 mikeas
 mockurl
 mysqladmin
 notif
 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
 sut
 SUT
+starlette
+Starlette
+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

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

@@ -36,7 +36,7 @@ jobs:
 
     strategy:
       matrix:
-        python-version: ['3.10', '3.13']
+        python-version: ["3.10", "3.13"]
     steps:
       - name: Checkout code
         uses: actions/checkout@v6
@@ -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

@@ -17,39 +17,32 @@ jobs:
       - name: Set up Python
         uses: actions/setup-python@v6
         with:
-          python-version: '3.10'
+          python-version: "3.10"
       - name: Install uv
         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
         with:
           token: ${{ secrets.A2A_BOT_PAT }}
           committer: a2a-bot <a2a-bot@google.com>
           author: a2a-bot <a2a-bot@google.com>
-          commit-message: '${{ github.event.client_payload.message }}'
-          title: '${{ github.event.client_payload.message }}'
+          commit-message: "${{ github.event.client_payload.message }}"
+          title: "${{ github.event.client_payload.message }}"
           body: |
             Commit: https://github.com/a2aproject/A2A/commit/${{ github.event.client_payload.sha }}
           branch: auto-update-a2a-types-${{ github.event.client_payload.sha }}

.gitignore

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

.pre-commit-config.yaml

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

CODE_OF_CONDUCT.md

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