test

.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,55 @@ lifecycles
 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
 pyupgrade
 pyversions
 redef
 respx
 resub
+RS256
 RUF
+SECP256R1
 SLF
 socio
 sse
+starlette
+Starlette
 sut
 SUT
+swagger
 tagwords
 taskupdate
 testuuid
 Tful
 tiangolo
+typ
 typeerror
 vulnz
+TResponse

.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,8 @@
 ^\.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
 
@@ -43,9 +45,7 @@ jobs:
       - name: Run Pyright (Pylance equivalent)
         id: pyright
         continue-on-error: true
-        uses: jakebailey/pyright-action@v3
-        with:
-          pylance-version: latest-release
+        run: uv run pyright src
 
       - name: Run JSCPD for copy-paste detection
         id: jscpd

.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@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:
   pull_request:
-    branches: [main]
+    branches: [main, 1.0-dev]
 permissions:
   contents: read
 jobs:
@@ -52,6 +52,7 @@ jobs:
       - name: Add uv to PATH
         run: |
           echo "$HOME/.cargo/bin" >> $GITHUB_PATH
+
       - name: Install dependencies
         run: uv sync --locked
       - name: Run tests and check coverage

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

@@ -1,10 +1,16 @@
 ---
 name: Update A2A Schema from Specification
 on:
-#  TODO (https://github.com/a2aproject/a2a-python/issues/559): bring back once types are migrated, currently it generates many broken PRs
-#  repository_dispatch:
-#    types: [a2a_json_update]
   workflow_dispatch:
+    inputs:
+      message:
+        description: 'Commit message'
+        required: true
+        type: string
+      sha:
+        description: 'SHA of the specification from which with types are being updated'
+        required: true
+        type: string
 jobs:
   generate_and_pr:
     runs-on: ubuntu-latest
@@ -14,49 +20,56 @@ jobs:
     steps:
       - name: Checkout code
         uses: actions/checkout@v6
-      - name: Set up Python
-        uses: actions/setup-python@v6
-        with:
-          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
+      - name: Run scripts/gen_proto.sh
         run: |
-          GENERATED_FILE="./src/a2a/types.py"
-          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."
+          set -euo pipefail
+          echo "Running scripts/gen_proto.sh..."
+          bash scripts/gen_proto.sh
+          echo "Scripts/gen_proto.sh 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 }}'
-          body: |
-            Commit: https://github.com/a2aproject/A2A/commit/${{ github.event.client_payload.sha }}
-          branch: auto-update-a2a-types-${{ github.event.client_payload.sha }}
-          base: main
-          labels: |
-            automated
-            dependencies
-          add-paths: |-
-            ${{ steps.vars.outputs.GENERATED_FILE }}
-            src/a2a/grpc/
+        env:
+          GH_TOKEN: ${{ github.token }}
+        run: |
+          set -euo pipefail
+
+          # Configure Git
+          git config --global user.name "a2a-bot"
+          git config --global user.email "a2a-bot@google.com"
+
+          # Configure remote to use PAT
+          git remote set-url origin "https://x-access-token:${GH_TOKEN}@github.com/${{ github.repository }}"
+
+          # Branch name
+          BRANCH_NAME="auto-update-a2a-types-${{ inputs.sha }}"
+
+          # Add files
+          git add src/a2a/types/ src/a2a/compat/v0_3/
+
+          # Check for changes
+          if git diff --staged --quiet; then
+            echo "No changes to commit. Skipping PR creation."
+            exit 0
+          fi
+
+          # Create and switch to branch
+          git checkout -b "$BRANCH_NAME"
+
+          # Commit
+          git commit -m "${{ inputs.message }}"
+
+          # Push
+          # Force push if branch exists (safe if branch name is unique)
+          git push -u origin "$BRANCH_NAME" --force
+
+          # Check if open PR exists
+          if gh pr list --head "$BRANCH_NAME" --state open --json url --jq '.[0].url' | grep -q http; then
+            echo "Open PR already exists. Updating..."
+            gh pr edit "$BRANCH_NAME" --title "${{ inputs.message }}" --body "Commit: https://github.com/a2aproject/A2A/commit/${{ inputs.sha }}"
+          else
+            echo "Creating new PR..."
+            gh pr create \
+              --title "${{ inputs.message }}" \
+              --body "Commit: https://github.com/a2aproject/A2A/commit/${{ inputs.sha }}" \
+              --base main \
+              --head "$BRANCH_NAME"
+          fi

.gitignore

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

.jscpd.json

@@ -1,5 +1,13 @@
 {
-  "ignore": ["**/.github/**", "**/.git/**", "**/tests/**", "**/src/a2a/grpc/**", "**/.nox/**", "**/.venv/**"],
+  "ignore": [
+    "**/.github/**",
+    "**/.git/**",
+    "**/tests/**",
+    "**/src/a2a/grpc/**",
+    "**/src/a2a/compat/**",
+    "**/.nox/**",
+    "**/.venv/**"
+  ],
   "threshold": 3,
   "reporters": ["html", "markdown"]
 }

.release-please-manifest.json

@@ -0,0 +1 @@
+{}

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.compat.gen.yaml

@@ -0,0 +1,12 @@
+# Protobuf generation for legacy v0.3 A2A protocol buffer modules.
+---
+version: v2
+managed:
+  enabled: true
+plugins:
+  - remote: buf.build/protocolbuffers/python:v29.3
+    out: src/a2a/compat/v0_3
+  - remote: buf.build/grpc/python
+    out: src/a2a/compat/v0_3
+  - remote: buf.build/protocolbuffers/pyi
+    out: src/a2a/compat/v0_3

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