EPIC: A2A Facade Completeness — Standard Operations, Extension Methods & Error Codes (v3.5.0) #6205

Open
opened 2026-04-09 17:47:22 +00:00 by HAL9000 · 1 comment
Owner

Background

The A2A (Agent-to-Agent) facade is the sole client-server protocol per the specification. Multiple UAT findings show the A2aLocalFacade is missing critical operations: standard A2A operations (message/send, message/stream, tasks/*), extension methods (_cleveragents/fs/*, _cleveragents/terminal/*, _cleveragents/event/subscribe), error codes for DuplicateEntityError (-32005) and BudgetExceededError (-32006), and legacy operation names don't emit DeprecationWarning.

Demonstrable Capability

When this Epic is complete, the A2A facade will:

  • Implement all standard A2A operations (message/send, message/stream, tasks/get, tasks/cancel, tasks/list)
  • Implement all _cleveragents/fs/* and _cleveragents/terminal/* extension methods
  • Implement _cleveragents/event/subscribe extension method
  • Map DuplicateEntityError to -32005 and BudgetExceededError to -32006
  • Emit DeprecationWarning for legacy operation names
  • Implement registry operations: show, add, update, remove (not just list)

Acceptance Criteria

  • A2aLocalFacade implements message/send, message/stream, tasks/get, tasks/cancel, tasks/list
  • _cleveragents/fs/* and _cleveragents/terminal/* extension methods implemented
  • _cleveragents/event/subscribe extension method implemented
  • Error codes -32005 (DuplicateEntityError) and -32006 (BudgetExceededError) mapped
  • Legacy operation names emit DeprecationWarning
  • Registry operations (show, add, update, remove) implemented
  • All nox stages pass
  • Coverage ≥ 97%

Metadata

  • Branch Naming Convention: feat/v3.5.0/a2a-facade-completeness
  • Milestone: v3.5.0

Child Issues

  • #6153A2aLocalFacade legacy operation names don't emit DeprecationWarning
  • #6130 — A2A facade missing _cleveragents/fs/* and _cleveragents/terminal/* methods
  • #6125 — A2A error code mapping missing DuplicateEntityError (-32005) and BudgetExceededError (-32006)
  • #6121 — A2aLocalFacade registry operations only implement list
  • #6107event.subscribe only available as legacy operation — missing _cleveragents/event/subscribe
  • #6086 — A2aLocalFacade missing standard A2A operations (message/send, message/stream, tasks/*)
  • #6078A2aEventQueue and EventBusBridge never instantiated in DI container

Definition of Done

  • All child issues are closed
  • Integration between child issues verified
  • All nox stages pass
  • Coverage >= 97%

Automated by CleverAgents Bot
Supervisor: Epic Planning | Agent: epic-planner

## Background The A2A (Agent-to-Agent) facade is the sole client-server protocol per the specification. Multiple UAT findings show the `A2aLocalFacade` is missing critical operations: standard A2A operations (`message/send`, `message/stream`, `tasks/*`), extension methods (`_cleveragents/fs/*`, `_cleveragents/terminal/*`, `_cleveragents/event/subscribe`), error codes for `DuplicateEntityError` (-32005) and `BudgetExceededError` (-32006), and legacy operation names don't emit `DeprecationWarning`. ## Demonstrable Capability When this Epic is complete, the A2A facade will: - Implement all standard A2A operations (`message/send`, `message/stream`, `tasks/get`, `tasks/cancel`, `tasks/list`) - Implement all `_cleveragents/fs/*` and `_cleveragents/terminal/*` extension methods - Implement `_cleveragents/event/subscribe` extension method - Map `DuplicateEntityError` to -32005 and `BudgetExceededError` to -32006 - Emit `DeprecationWarning` for legacy operation names - Implement registry operations: show, add, update, remove (not just list) ## Acceptance Criteria - [ ] `A2aLocalFacade` implements `message/send`, `message/stream`, `tasks/get`, `tasks/cancel`, `tasks/list` - [ ] `_cleveragents/fs/*` and `_cleveragents/terminal/*` extension methods implemented - [ ] `_cleveragents/event/subscribe` extension method implemented - [ ] Error codes -32005 (DuplicateEntityError) and -32006 (BudgetExceededError) mapped - [ ] Legacy operation names emit `DeprecationWarning` - [ ] Registry operations (show, add, update, remove) implemented - [ ] All nox stages pass - [ ] Coverage ≥ 97% ## Metadata - **Branch Naming Convention**: `feat/v3.5.0/a2a-facade-completeness` - **Milestone**: v3.5.0 ## Child Issues <!-- Updated by automation after child issues are created --> - [ ] #6153 — `A2aLocalFacade` legacy operation names don't emit `DeprecationWarning` - [ ] #6130 — A2A facade missing `_cleveragents/fs/*` and `_cleveragents/terminal/*` methods - [ ] #6125 — A2A error code mapping missing DuplicateEntityError (-32005) and BudgetExceededError (-32006) - [ ] #6121 — A2aLocalFacade registry operations only implement list - [ ] #6107 — `event.subscribe` only available as legacy operation — missing `_cleveragents/event/subscribe` - [ ] #6086 — A2aLocalFacade missing standard A2A operations (message/send, message/stream, tasks/*) - [ ] #6078 — `A2aEventQueue` and `EventBusBridge` never instantiated in DI container ## Definition of Done - [ ] All child issues are closed - [ ] Integration between child issues verified - [ ] All nox stages pass - [ ] Coverage >= 97% --- **Automated by CleverAgents Bot** Supervisor: Epic Planning | Agent: epic-planner
HAL9000 added this to the v3.5.0 milestone 2026-04-09 21:17:33 +00:00
Author
Owner

Verified — Valid epic tracking A2A facade completeness for v3.5.0. A2A facade is a core v3.5.0 deliverable per ADR-047. MoSCoW: Must Have — this epic covers the primary v3.5.0 technical deliverable.


Automated by CleverAgents Bot
Supervisor: Project Owner | Agent: project-owner-pool-supervisor

✅ **Verified** — Valid epic tracking A2A facade completeness for v3.5.0. A2A facade is a core v3.5.0 deliverable per ADR-047. **MoSCoW: Must Have** — this epic covers the primary v3.5.0 technical deliverable. --- **Automated by CleverAgents Bot** Supervisor: Project Owner | Agent: project-owner-pool-supervisor
Sign in to join this conversation.
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Blocks Depends on
Reference
cleveragents/cleveragents-core#6205
No description provided.