🤖 I have created a release *beep* *boop*
---


##
[1.0.0-alpha.2](v1.0.0-alpha.1...v1.0.0-alpha.2)
(2026-04-17)


### ⚠ BREAKING CHANGES

* clean helpers and utils folders structure
([#983](#983))
* Raise errors on invalid AgentExecutor behavior.
([#979](#979))
* extract developer helpers in helpers folder
([#978](#978))

### Features

* Raise errors on invalid AgentExecutor behavior.
([#979](#979))
([f4a0bcd](f4a0bcd))
* **utils:** add `display_agent_card()` utility for human-readable
AgentCard inspection
([#972](#972))
([3468180](3468180))


### Bug Fixes

* Don't generate empty metadata change events in VertexTaskStore
([#974](#974))
([b58b03e](b58b03e)),
closes [#802](#802)
* **extensions:** support both header names and remove "activation"
concept ([#984](#984))
([b8df210](b8df210))


### Documentation

* AgentExecutor interface documentation
([#976](#976))
([d667e4f](d667e4f))
* move `ai_learnings.md` to local-only and update `GEMINI.md`
([#982](#982))
([f6610fa](f6610fa))


### Code Refactoring

* clean helpers and utils folders structure
([#983](#983))
([c87e87c](c87e87c))
* extract developer helpers in helpers folder
([#978](#978))
([5f3ea29](5f3ea29))

---
This PR was generated with [Release
Please](https://github.com/googleapis/release-please). See
[documentation](https://github.com/googleapis/release-please#release-please).

…ide (#1014)

# Description
- Adds a new section **"Server: AgentExecutor Streaming Rules"** to the
v0.3 → v1.0 migration guide, covering the breaking change introduced in
#979 where the server now strictly enforces the A2A spec rules for
`message/stream`.
- Documents the four `InvalidAgentResponseError` cases (mixing `Message`
and `Task` events, multiple `Message`s, updates before the initial
`Task`) with a clear table mapped to the actual error messages from
`active_task.py`.
- Provides before/after migration examples — including the message-only
pattern and the full task lifecycle pattern (Task → WORKING → invoke
agent → artifact → COMPLETED) — plus a quick migration checklist.
- Links to the updated `helloworld/agent_executor.py` in
[a2a-samples#474](a2aproject/a2a-samples#474) as
a working reference.
- Adds a corresponding bullet to the "Summary of Key Changes" section
# Why
Existing v0.3 executors that mixed `Message` and `Task` events were
silently tolerated. After #979 they fail at runtime with
`InvalidAgentResponseError`, which is easy to hit and hard to diagnose
without guidance. This section gives users a clear path to migrate.