Merge branch 'migration' of https://github.com/sokoliva/a2a-python into migration

Author: sokoliva

README.md

@@ -68,7 +68,6 @@ Install the core SDK and any desired extras using your preferred package manager
 | **gRPC Support**         | `uv add "a2a-sdk[grpc]"`                   | `pip install "a2a-sdk[grpc]"`                |
 | **OpenTelemetry Tracing**| `uv add "a2a-sdk[telemetry]"`              | `pip install "a2a-sdk[telemetry]"`           |
 | **Encryption**           | `uv add "a2a-sdk[encryption]"`             | `pip install "a2a-sdk[encryption]"`          |
-| **Vertex AI Task Store** | `uv add "a2a-sdk[vertex]"`                 | `pip install "a2a-sdk[vertex]"`              |
 |                          |                                            |                                              |
 | **Database Drivers**     |                                            |                                              |
 | **PostgreSQL**           | `uv add "a2a-sdk[postgresql]"`             | `pip install "a2a-sdk[postgresql]"`          |

docs/migrations/v1_0/README.md

@@ -1,14 +1,16 @@
-# Migration Guide: v0.3 → v1.0
+# A2A Python SDK Migration Guide: v0.3 → v1.0
 
-This guide covers the breaking changes introduced in `a2a-sdk` v1.0 and explains how to update your code. The changes reflect updates to the A2A protocol specification: [What's new in v1.0](https://a2a-protocol.org/latest/whats-new-v1/).
+The `a2a-sdk` has achieved a major milestone in stability and reliability with the update to full **A2A Protocol v1.0 compatibility**. This guide provides a detailed overview of the breaking changes in version `v1.0` and instructions for migrating your codebase.
 
-> **Related guides**: If you use the database persistence layer, also see the [Database Migration Guide](database/).
+Beyond protocol support, `v1.0` enhances the developer experience by introducing unified helper utilities for easier object creation and adopting Starlette route factory functions for more flexible server configuration.
+
+This documentation details the technical upgrades and architectural modifications introduced in A2A Python SDK v1.0; For developers using the database persistence layer, please refer to the [Database Migration Guide](database/) for specific update instructions.
 
 ---
 
 ## Table of Contents
 
-1. [Package Dependency](#1-package-dependency)
+1. [Update Dependency](#1-package-dependency)
 2. [Types](#2-types)
 3. [Server: DefaultRequestHandler](#3-server-defaultrequesthandler)
 4. [Server: Application Setup](#4-server-application-setup)
@@ -22,27 +24,40 @@ This guide covers the breaking changes introduced in `a2a-sdk` v1.0 and explains
 
 ---
 
-## 1. Package Dependency
+## 1. Update Dependencies
+
+(UV users) To upgrade to the latest version of the `a2a-sdk`, update the dependencies section in your `pyproject.toml` file.
+
+| File             | Before (`v0.3`)                   | After (`v1.0`)                    |
+|------------------|-----------------------------------|-----------------------------------|
+| `pyproject.toml` | dependencies = ["a2a-sdk>=0.3.0"] | dependencies = ["a2a-sdk>=1.0.0"] |
+
+**Installation**
 
-Update your dependency to the new version:
+After updating your configuration file, sync your environment:
+
+* Using UV:
+
+```bash
+uv sync
+```
 
-```toml
-# pyproject.toml — before
-dependencies = ["a2a-sdk>=0.3.0"]
+* Using pip:
 
-# pyproject.toml — after
-dependencies = ["a2a-sdk>=1.0.0"]
+```bash
+pip install --upgrade a2a-sdk
 ```
 
 ---
 
 ## 2. Types
 
-Types are now **Protobuf-based** instead of Pydantic models.
+Types have migrated from Pydantic models to Protobuf-based classes.
+
 
 ### Enum values: snake_case → SCREAMING_SNAKE_CASE
 
-All enum values have been renamed from snake_case strings to `SCREAMING_SNAKE_CASE`.
+All the enum values are now standardized from snake_case to **SCREAMING_SNAKE_CASE** format.
 
 This affects every enum in the SDK: `TaskState`, `Role`.
 
@@ -57,6 +72,7 @@ This affects every enum in the SDK: `TaskState`, `Role`.
 | `TaskState` | `TaskState.input_required` | `TaskState.TASK_STATE_INPUT_REQUIRED` |
 | `TaskState` | `TaskState.auth_required` | `TaskState.TASK_STATE_AUTH_REQUIRED` |
 | `TaskState` | `TaskState.rejected` | `TaskState.TASK_STATE_REJECTED` |
+|||
 | `Role` | *(no equivalent — protobuf default)* | `Role.ROLE_UNSPECIFIED` |
 | `Role` | `Role.user` | `Role.ROLE_USER` |
 | `Role` | `Role.agent` | `Role.ROLE_AGENT` |
@@ -83,15 +99,22 @@ message = Message(
 ```
 
 **After (v1.0):**
+
+Using [A2A helper utilities](#helper-utilities)
+
 ```python
 from a2a.helpers import new_text_message
 from a2a.types import Role
 
-# Use the helper for text messages
+# Use the helper function to create `Hello` message
 message = new_text_message(text="Hello", role=Role.ROLE_USER)
 
-# Or construct directly
-from a2a.types import Message, Part
+```
+
+Without helper utils, you can still construct directly
+
+```python
+from a2a.types import Message, Part, Role
 from uuid import uuid4
 
 message = Message(

pyproject.toml

@@ -43,7 +43,6 @@ mysql = ["sqlalchemy[asyncio,aiomysql]>=2.0.0"]
 signing = ["PyJWT>=2.0.0"]
 sqlite = ["sqlalchemy[asyncio,aiosqlite]>=2.0.0"]
 db-cli = ["alembic>=1.14.0"]
-vertex = ["google-cloud-aiplatform>=1.140.0"]
 
 sql = ["a2a-sdk[postgresql,mysql,sqlite]"]
 
@@ -55,7 +54,6 @@ all = [
   "a2a-sdk[telemetry]",
   "a2a-sdk[signing]",
   "a2a-sdk[db-cli]",
-  "a2a-sdk[vertex]",
 ]
 
 [project.urls]