refactor(server)!: migrate from Application wrappers to Starlette route-based endpoints for rest by guglielmo-san · Pull Request #892 · a2aproject/a2a-python · GitHub
Skip to content

refactor(server)!: migrate from Application wrappers to Starlette route-based endpoints for rest - #892

Merged
guglielmo-san merged 30 commits into
a2aproject:1.0-devfrom
guglielmo-san:guglielmoc/refactor_rest_server
Mar 24, 2026
Merged

refactor(server)!: migrate from Application wrappers to Starlette route-based endpoints for rest#892
guglielmo-san merged 30 commits into
a2aproject:1.0-devfrom
guglielmo-san:guglielmoc/refactor_rest_server

Conversation

@guglielmo-san

Copy link
Copy Markdown
Member

Description

This PR refactors the rest server implementation to expose Starlette Route components directly (via RestRoutes) instead of requiring full FastAPI or Starlette application wrappers.

Ref #797 🦕

@gemini-code-assist

Copy link
Copy Markdown
Contributor

@github-actions

github-actions Bot commented Mar 23, 2026

Copy link
Copy Markdown

🧪 Code Coverage (vs 1.0-dev)

⬇️ Download Full Report

Base PR Delta
src/a2a/server/request_handlers/rest_handler.py 93.75% 91.67% 🔴 -2.08%
src/a2a/server/routes/rest_routes.py (new) 77.11%
Total 91.43% 91.37% 🔴 -0.06%

Generated by coverage-comment.yml

@guglielmo-san guglielmo-san changed the title Guglielmoc/refactor rest server refactor(server)!: migrate from Application wrappers to Starlette route-based endpoints for rest Mar 23, 2026

@gemini-code-assist gemini-code-assist Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request refactors the REST application setup by removing the A2ARESTFastAPIApplication class and introducing a new create_rest_routes function. This change streamlines the creation of REST endpoints, including v0.3 compatibility, and integrates them directly with Starlette applications. The vertex_task_converter.py file was updated to align with vertexai.types for task states and parts, removing google.genai dependencies. Additionally, several test files were updated to reflect these changes. Review comments suggest simplifying the _handle_authenticated_agent_card logic in rest_routes.py and removing an unused Middleware import in test_jsonrpc_routes.py.

Comment thread src/a2a/server/routes/rest_routes.py
Comment thread tests/server/routes/test_jsonrpc_routes.py Outdated
@guglielmo-san
guglielmo-san marked this pull request as ready for review March 23, 2026 16:35
@guglielmo-san
guglielmo-san requested a review from a team as a code owner March 23, 2026 16:35
@guglielmo-san
guglielmo-san requested a review from ishymko March 23, 2026 16:35
Comment thread src/a2a/server/routes/rest_routes.py Outdated
Comment thread src/a2a/server/routes/rest_routes.py
@guglielmo-san
guglielmo-san enabled auto-merge (squash) March 24, 2026 16:09
@guglielmo-san
guglielmo-san merged commit 4be2064 into a2aproject:1.0-dev Mar 24, 2026
9 checks passed
@guglielmo-san
guglielmo-san deleted the guglielmoc/refactor_rest_server branch March 24, 2026 16:11
guglielmo-san pushed a commit that referenced this pull request Apr 10, 2026
🤖 I have created a release *beep* *boop*
---


##
[1.0.0-alpha.1](v1.0.0-alpha.0...v1.0.0-alpha.1)
(2026-04-10)


### ⚠ BREAKING CHANGES

* **client:** make ClientConfig.push_notification_config singular
([#955](#955))
* **client:** reorganize ClientFactory API
([#947](#947))
* **server:** add build_user function to DefaultContextBuilder to allow
A2A user creation customization
([#925](#925))
* **client:** remove `ClientTaskManager` and `Consumers` from client
([#916](#916))
* **server:** migrate from Application wrappers to Starlette route-based
endpoints for rest
([#892](#892))
* **server:** migrate from Application wrappers to Starlette route-based
endpoints for jsonrpc
([#873](#873))

### Features

* A2A Version Header validation on server side.
([#865](#865))
([b261ceb](b261ceb))
* Add GetExtendedAgentCard Support to RequestHandlers
([#919](#919))
([2159140](2159140))
* Add support for more Task Message and Artifact fields in the Vertex
Task Store ([#936](#936))
([605fa49](605fa49))
* Create EventQueue interface and make tap() async.
([#914](#914))
([9ccf99c](9ccf99c)),
closes [#869](#869)
* EventQueue - unify implementation between python versions
([#877](#877))
([7437b88](7437b88)),
closes [#869](#869)
* EventQueue is now a simple interface with single enqueue_event method.
([#944](#944))
([f0e1d74](f0e1d74))
* Implementation of DefaultRequestHandlerV2
([#933](#933))
([462eb3c](462eb3c)),
closes [#869](#869)
* InMemoryTaskStore creates a copy of Task by default to make it
consistent with database task stores
([#887](#887))
([8c65e84](8c65e84)),
closes [#869](#869)
* merge metadata of new and old artifact when append=True
([#945](#945))
([cc094aa](cc094aa))
* **server:** add async context manager support to EventQueue
([#743](#743))
([f68b22f](f68b22f))
* **server:** validate presence according to `google.api.field_behavior`
annotations
([#870](#870))
([4586c3e](4586c3e))
* Simplify ActiveTask.subscribe()
([#958](#958))
([62e5e59](62e5e59))
* Support AgentExectuor enqueue of a Task object.
([#960](#960))
([12ce017](12ce017))
* Support Message-only simplified execution without creating Task
([#956](#956))
([354fdfb](354fdfb))
* Unhandled exception in AgentExecutor marks task as failed
([#943](#943))
([4fc6b54](4fc6b54))


### Bug Fixes

* Add `packaging` to base dependencies
([#897](#897))
([7a9aec7](7a9aec7))
* **client:** do not mutate SendMessageRequest in
BaseClient.send_message
([#949](#949))
([94537c3](94537c3))
* fix `athrow()` RuntimeError on streaming responses
([#912](#912))
([ca7edc3](ca7edc3))
* fix docstrings related to `CallContextBuilder` args in constructors
and make ServerCallContext mandatory in `compat` folder
([#907](#907))
([9cade9b](9cade9b))
* fix error handling for gRPC and SSE streaming
([#879](#879))
([2b323d0](2b323d0))
* fix JSONRPC error handling
([#957](#957))
([6c807d5](6c807d5))
* fix REST error handling
([#893](#893))
([405be3f](405be3f))
* handle SSE errors occurred after stream started
([#894](#894))
([3a68d8f](3a68d8f))
* remove the use of deprecated types from VertexTaskStore
([#889](#889))
([6d49122](6d49122))
* Remove unconditional SQLAlchemy dependency from SDK core
([#898](#898))
([ab762f0](ab762f0)),
closes [#883](#883)
* remove unused import and request for FastAPI in pyproject
([#934](#934))
([fe5de77](fe5de77))
* replace stale entry in a2a.types.__all__ with actual import name
([#902](#902))
([05cd5e9](05cd5e9))
* wrong method name for ExtendedAgentCard endpoint in JsonRpc compat
version ([#931](#931))
([5d22186](5d22186))


### Documentation

* add Database Migration Documentation
([#864](#864))
([fd12dff](fd12dff))


### Miscellaneous Chores

* release 1.0.0-alpha.1
([a61f6d4](a61f6d4))


### Code Refactoring

* **client:** make ClientConfig.push_notification_config singular
([#955](#955))
([be4c5ff](be4c5ff))
* **client:** remove `ClientTaskManager` and `Consumers` from client
([#916](#916))
([97058bb](97058bb)),
closes [#734](#734)
* **client:** reorganize ClientFactory API
([#947](#947))
([01b3b2c](01b3b2c))
* **server:** add build_user function to DefaultContextBuilder to allow
A2A user creation customization
([#925](#925))
([2648c5e](2648c5e))
* **server:** migrate from Application wrappers to Starlette route-based
endpoints for jsonrpc
([#873](#873))
([734d062](734d062))
* **server:** migrate from Application wrappers to Starlette route-based
endpoints for rest
([#892](#892))
([4be2064](4be2064))

---
This PR was generated with [Release
Please](https://github.com/googleapis/release-please). See
[documentation](https://github.com/googleapis/release-please#release-please).
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants