Merge branch 'main' into main

Author: wadave

.github/actions/spelling/allow.txt

@@ -51,6 +51,7 @@ npx
 oauthoidc
 openbnb
 opensource
+pyversions
 socio
 sse
 tagwords

.github/workflows/unit-tests.yml

@@ -18,7 +18,7 @@ jobs:
 
     strategy:
       matrix:
-        python-version: ["3.13"]
+        python-version: ["3.10", "3.13"]
 
     steps:
       - name: Checkout code

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

@@ -0,0 +1,79 @@
+name: Update A2A Schema from Specification
+
+on:
+  repository_dispatch:
+    types: [a2a_json_update]
+  workflow_dispatch:
+
+jobs:
+  generate_and_pr:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      pull-requests: write
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.10"
+
+      - name: Install uv
+        run: curl -LsSf https://astral.sh/uv/install.sh | sh
+
+      - name: Configure uv shell
+        run: echo "$HOME/.cargo/bin" >> $GITHUB_PATH
+
+      - name: Install dependencies (datamodel-code-generator)
+        run: uv sync
+
+      - name: Define output file variable
+        id: vars
+        run: |
+          GENERATED_FILE="./src/a2a/types.py"
+          echo "GENERATED_FILE=$GENERATED_FILE" >> "$GITHUB_OUTPUT"
+
+      - name: Run datamodel-codegen
+        run: |
+          set -euo pipefail # Exit immediately if a command exits with a non-zero status
+
+          REMOTE_URL="https://raw.githubusercontent.com/google/A2A/refs/heads/main/specification/json/a2a.json"
+          GENERATED_FILE="${{ steps.vars.outputs.GENERATED_FILE }}"
+
+          echo "Running datamodel-codegen..."
+          uv run datamodel-codegen \
+            --url "$REMOTE_URL" \
+            --input-file-type jsonschema \
+            --output "$GENERATED_FILE" \
+            --target-python-version 3.10 \
+            --output-model-type pydantic_v2.BaseModel \
+            --disable-timestamp \
+            --use-schema-description \
+            --use-union-operator \
+            --use-field-description \
+            --use-default \
+            --use-default-kwarg \
+            --use-one-literal-as-default \
+            --class-name A2A \
+            --use-standard-collections
+          echo "Codegen finished."
+
+      - name: Create Pull Request with Updates
+        uses: peter-evans/create-pull-request@v6
+        with:
+          token: ${{ secrets.A2A_BOT_PAT }}
+          committer: "a2a-bot <[email protected]>"
+          author: "a2a-bot <[email protected]>"
+          commit-message: "chore: 🤖Auto-update A2A types from google/A2A@${{ github.event.client_payload.sha }}"
+          title: "chore: 🤖 Auto-update A2A types from google/A2A"
+          body: |
+            This PR updates `src/a2a/types.py` based on the latest `specification/json/a2a.json` from [google/A2A](https://github.com/google/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 }}

.ruff.toml

@@ -9,7 +9,7 @@
 line-length = 80 # Google Style Guide §3.2: 80 columns
 indent-width = 4 # Google Style Guide §3.4: 4 spaces
 
-target-version = "py313" # Minimum Python version
+target-version = "py310" # Minimum Python version
 
 [lint]
 ignore = [

CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## [0.2.4](https://github.com/google/a2a-python/compare/v0.2.3...v0.2.4) (2025-05-22)
+
+
+### Features
+
+* Update to support python 3.10 ([#85](https://github.com/google/a2a-python/issues/85)) ([fd9c3b5](https://github.com/google/a2a-python/commit/fd9c3b5b0bbef509789a701171d95f690c84750b))
+
+
+### Bug Fixes
+
+* Throw exception for task_id mismatches ([#70](https://github.com/google/a2a-python/issues/70)) ([a9781b5](https://github.com/google/a2a-python/commit/a9781b589075280bfaaab5742d8b950916c9de74))
+
 ## [0.2.3](https://github.com/google/a2a-python/compare/v0.2.2...v0.2.3) (2025-05-20)
 
 

README.md

@@ -1,14 +1,27 @@
 # A2A Python SDK
 
-A Python library that helps run agentic applications as A2AServers following the [Agent2Agent (A2A) Protocol](https://google.github.io/A2A/).
+[![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](LICENSE)
+![PyPI - Version](https://img.shields.io/pypi/v/a2a-sdk)
+![PyPI - Python Version](https://img.shields.io/pypi/pyversions/a2a-sdk)
+
+<!-- markdownlint-disable no-inline-html -->
+
+<html>
+   <h2 align="center">
+   <img src="https://raw.githubusercontent.com/google/A2A/refs/heads/main/docs/assets/a2a-logo-black.svg" width="256" alt="A2A Logo"/>
+   </h2>
+   <h3 align="center">A Python library that helps run agentic applications as A2AServers following the <a href="https://google.github.io/A2A">Agent2Agent (A2A) Protocol</a>.</h3>
+</html>
+
+<!-- markdownlint-enable no-inline-html -->
 
 ## Installation
 
 You can install the A2A SDK using either `uv` or `pip`.
 
 ## Prerequisites
 
-- Python 3.13+
+- Python 3.10+
 - `uv` (optional, but recommended) or `pip`
 
 ### Using `uv`

examples/google_adk/birthday_planner/adk_agent_executor.py

@@ -156,9 +156,10 @@ async def _process_request(
         session_id: str,
         task_updater: TaskUpdater,
     ) -> AsyncIterable[TaskStatus | Artifact]:
-        session_id = self._upsert_session(
+        session = await self._upsert_session(
             session_id,
-        ).id
+        )
+        session_id = session.id
         async for event in self._run_agent(
             session_id, new_message, task_updater
         ):
@@ -243,10 +244,10 @@ async def cancel(self, context: RequestContext, event_queue: EventQueue):
         # Ideally: kill any ongoing tasks.
         raise ServerError(error=UnsupportedOperationError())
 
-    def _upsert_session(self, session_id: str):
-        return self.runner.session_service.get_session(
+    async def _upsert_session(self, session_id: str):
+        return await self.runner.session_service.get_session(
             app_name=self.runner.app_name, user_id='self', session_id=session_id
-        ) or self.runner.session_service.create_session(
+        ) or await self.runner.session_service.create_session(
             app_name=self.runner.app_name, user_id='self', session_id=session_id
         )
 

examples/google_adk/birthday_planner/pyproject.toml

@@ -3,14 +3,14 @@ name = "adk-a2a-client-example"
 version = "0.1.0"
 description = "Birthday planner agent example"
 readme = "README.md"
-requires-python = ">=3.10"
+requires-python = ">=3.12"
 dependencies = [
     "a2a-sdk",
     "click>=8.1.8",
     "dotenv>=0.9.9",
     "httpx>=0.28.1",
     "google-genai>=1.9.0",
-    "google-adk>=0.0.3",
+    "google-adk>=1.0.0",
     "pydantic>=2.11.4",
     "python-dotenv>=1.1.0",
 ]

examples/google_adk/calendar_agent/__main__.py

@@ -1,3 +1,4 @@
+import asyncio
 import logging
 import os
 
@@ -66,10 +67,10 @@ def main(host: str, port: int):
         skills=[skill],
     )
 
-    adk_agent = create_agent(
+    adk_agent = asyncio.run(create_agent(
         client_id=os.getenv('GOOGLE_CLIENT_ID'),
         client_secret=os.getenv('GOOGLE_CLIENT_SECRET'),
-    )
+    ))
     runner = Runner(
         app_name=agent_card.name,
         agent=adk_agent,

examples/google_adk/calendar_agent/adk_agent.py

@@ -1,12 +1,12 @@
 import datetime
 
 from google.adk.agents import LlmAgent # type: ignore[import-untyped]
-from google.adk.tools.google_api_tool import calendar_tool_set # type: ignore[import-untyped]
+from google.adk.tools.google_api_tool import CalendarToolset # type: ignore[import-untyped]
 
 
-def create_agent(client_id, client_secret) -> LlmAgent:
+async def create_agent(client_id, client_secret) -> LlmAgent:
     """Constructs the ADK agent."""
-    calendar_tool_set.configure_auth(client_id, client_secret)
+    toolset = CalendarToolset(client_id=client_id, client_secret=client_secret)
     return LlmAgent(
         model='gemini-2.0-flash-001',
         name='calendar_agent',
@@ -23,5 +23,5 @@ def create_agent(client_id, client_secret) -> LlmAgent:
 
 Today is {datetime.datetime.now()}.
 """,
-        tools=calendar_tool_set.get_tools(),
+        tools=await toolset.get_tools(),
     )