UAT: A2A facade `list_operations()` method named `list_methods` in spec docs — naming inconsistency #6624

New issue

Closed

opened 2026-04-09 22:24:10 +00:00 by HAL9000 · 0 comments

HAL9000 commented

2026-04-09 22:24:10 +00:00

Owner

Bug Report

Feature Area: A2A Protocol — A2A Facade API naming

Spec Reference

docs/reference/a2a.md — Local Facade, Methods table:

Method	Returns	Description
`list_methods`	`list[str]`	All supported extension method names

Expected Behavior

The method should be named list_methods as documented in the spec, OR the documentation should reflect the actual method name.

Actual Behavior

The implementation in src/cleveragents/a2a/facade.py uses list_operations():

def list_operations(self) -> list[str]:
    """Return the list of supported A2A operation names."""
    return list(_SUPPORTED_OPERATIONS)

The spec docs say list_methods but the code has list_operations.

Code Location

docs/reference/a2a.md — Methods table (says list_methods)
src/cleveragents/a2a/facade.py — list_operations() method

Impact

Developers following the spec documentation will call facade.list_methods() and get AttributeError
The __init__.py exports A2aLocalFacade but the method name mismatch creates confusion

Fix Required

Either:

Rename list_operations() to list_methods() in facade.py (and update all callers), OR
Update docs/reference/a2a.md to say list_operations instead of list_methods

Option 1 is preferred for spec alignment.

Automated by CleverAgents Bot
Supervisor: UAT Testing | Agent: uat-tester

## Bug Report **Feature Area:** A2A Protocol — A2A Facade API naming ### Spec Reference `docs/reference/a2a.md` — Local Facade, Methods table: | Method | Returns | Description | |---|---|---| | `list_methods` | `list[str]` | All supported extension method names | ### Expected Behavior The method should be named `list_methods` as documented in the spec, OR the documentation should reflect the actual method name. ### Actual Behavior The implementation in `src/cleveragents/a2a/facade.py` uses `list_operations()`: ```python def list_operations(self) -> list[str]: """Return the list of supported A2A operation names.""" return list(_SUPPORTED_OPERATIONS) ``` The spec docs say `list_methods` but the code has `list_operations`. ### Code Location - `docs/reference/a2a.md` — Methods table (says `list_methods`) - `src/cleveragents/a2a/facade.py` — `list_operations()` method ### Impact - Developers following the spec documentation will call `facade.list_methods()` and get `AttributeError` - The `__init__.py` exports `A2aLocalFacade` but the method name mismatch creates confusion ### Fix Required Either: 1. Rename `list_operations()` to `list_methods()` in `facade.py` (and update all callers), OR 2. Update `docs/reference/a2a.md` to say `list_operations` instead of `list_methods` Option 1 is preferred for spec alignment. --- **Automated by CleverAgents Bot** Supervisor: UAT Testing | Agent: uat-tester

Rows
Columns

UAT: A2A facade list_operations() method named list_methods in spec docs — naming inconsistency #6624