From f94336d3c17a528d426eeab93841f0d837132913 Mon Sep 17 00:00:00 2001 From: CleverThis Date: Thu, 9 Apr 2026 22:36:45 +0000 Subject: [PATCH] docs(reference): align A2A facade API with implementation The docs/reference/a2a.md Local Facade section had three errors: 1. dispatch() signature: docs showed dispatch(method, params) but implementation is dispatch(request: A2aRequest) 2. dispatch() return type: docs showed dict but actual is A2aResponse 3. dispatch() async: docs showed await facade.dispatch() but method is synchronous 4. list_methods: docs showed list_methods but implementation is list_operations() Updated: - Code example to use A2aRequest and synchronous call - Methods table to show correct signatures and return types - list_methods -> list_operations() Fixes: #6620, #6624 Architect: AUTO-ARCH Cycle 15 --- docs/reference/a2a.md | 18 +++++++++++------- 1 file changed, 11 insertions(+), 7 deletions(-) diff --git a/docs/reference/a2a.md b/docs/reference/a2a.md index b86c338f5..e1dd96771 100644 --- a/docs/reference/a2a.md +++ b/docs/reference/a2a.md @@ -259,6 +259,7 @@ resuming the task. ```python from cleveragents.a2a import A2aLocalFacade +from cleveragents.a2a.models import A2aRequest facade = A2aLocalFacade(services={ "session_service": my_session_service, @@ -267,8 +268,11 @@ facade = A2aLocalFacade(services={ "resource_registry_service": my_resource_registry_service, }) -# Extension methods are dispatched to in-process services -result = await facade.dispatch("_cleveragents/plan/status", {"plan_id": "01J..."}) +# Extension methods are dispatched to in-process services (synchronous) +response = facade.dispatch(A2aRequest( + method="_cleveragents/plan/status", + params={"plan_id": "01J..."} +)) ``` ### Constructor @@ -279,11 +283,11 @@ result = await facade.dispatch("_cleveragents/plan/status", {"plan_id": "01J..." ### Methods -| Method | Returns | Description | -|----------------------------|-------------------|--------------------------------------| -| `dispatch(method, params)` | `dict` | Route extension method to handler | -| `register_service` | `None` | Register a named service | -| `list_methods` | `list[str]` | All supported extension method names | +| Method | Returns | Description | +|---------------------------------|-------------------|--------------------------------------| +| `dispatch(request: A2aRequest)` | `A2aResponse` | Route extension method to handler | +| `register_service` | `None` | Register a named service | +| `list_operations()` | `list[str]` | All supported extension method names | --- -- 2.52.0