feat(server): implement _cleveragents/actor/list A2A handler with real database queries #9535

Open
opened 2026-04-14 21:38:51 +00:00 by HAL9000 · 2 comments
Owner

Metadata

  • Commit message: feat(server): implement actor registry list handler with real database queries
  • Branch name: feat/v3.8.0-actor-registry-list-handler
  • Parent Epic: #9498 (EPIC: Registry & Resource Discovery — Real Data from Server Registry v3.8.0)
  • Blocks: #9498

Background and Context

Currently _cleveragents/actor/list returns stub data or raises NotImplementedError. The CleverAgents server needs to serve real actor registry data from PostgreSQL to support multi-user and team collaboration workflows. This issue implements the real A2A handler backed by live database queries, enabling clients to discover available actors in their namespace.

This is a child implementation issue of Epic #9498 and blocks its completion. This issue blocks parent Epic #9498.

Expected Behavior

The _cleveragents/actor/list A2A extension method should return real actor data from PostgreSQL, formatted as a valid A2A JSON-RPC 2.0 response. The handler must support pagination and namespace filtering (local and shared namespaces).

Acceptance Criteria

  • _cleveragents/actor/list returns real actor data from PostgreSQL (not stubs or NotImplementedError)
  • Response follows A2A JSON-RPC 2.0 format with correct id, jsonrpc, and result fields
  • Pagination is supported (cursor-based or offset-based with limit/offset params)
  • Namespace filtering works for both local and shared namespaces
  • Integration tests pass against a real PostgreSQL test database
  • Test coverage >= 97%

Subtasks

  • Implement database query for actor list (PostgreSQL, using ORM or raw SQL)
  • Implement A2A handler routing for _cleveragents/actor/list
  • Add pagination support (limit/offset or cursor)
  • Add namespace filtering (local vs. shared)
  • Write integration tests
  • Verify coverage >= 97%

Definition of Done

This issue should be closed when:

  1. _cleveragents/actor/list returns real PostgreSQL data in A2A JSON-RPC 2.0 format
  2. Pagination and namespace filtering are fully functional
  3. All integration tests pass
  4. Test coverage is >= 97%
  5. Code has been reviewed and merged to the target branch

Automated by CleverAgents Bot
Supervisor: Epic Planning | Agent: epic-planning-pool-supervisor [AUTO-EPIC-1]

## Metadata - **Commit message:** `feat(server): implement actor registry list handler with real database queries` - **Branch name:** `feat/v3.8.0-actor-registry-list-handler` - **Parent Epic:** #9498 (EPIC: Registry & Resource Discovery — Real Data from Server Registry v3.8.0) - **Blocks:** #9498 ## Background and Context Currently `_cleveragents/actor/list` returns stub data or raises `NotImplementedError`. The CleverAgents server needs to serve real actor registry data from PostgreSQL to support multi-user and team collaboration workflows. This issue implements the real A2A handler backed by live database queries, enabling clients to discover available actors in their namespace. This is a child implementation issue of Epic #9498 and blocks its completion. This issue blocks parent Epic #9498. ## Expected Behavior The `_cleveragents/actor/list` A2A extension method should return real actor data from PostgreSQL, formatted as a valid A2A JSON-RPC 2.0 response. The handler must support pagination and namespace filtering (local and shared namespaces). ## Acceptance Criteria - [ ] `_cleveragents/actor/list` returns real actor data from PostgreSQL (not stubs or `NotImplementedError`) - [ ] Response follows A2A JSON-RPC 2.0 format with correct `id`, `jsonrpc`, and `result` fields - [ ] Pagination is supported (cursor-based or offset-based with `limit`/`offset` params) - [ ] Namespace filtering works for both local and shared namespaces - [ ] Integration tests pass against a real PostgreSQL test database - [ ] Test coverage >= 97% ## Subtasks - [ ] Implement database query for actor list (PostgreSQL, using ORM or raw SQL) - [ ] Implement A2A handler routing for `_cleveragents/actor/list` - [ ] Add pagination support (limit/offset or cursor) - [ ] Add namespace filtering (local vs. shared) - [ ] Write integration tests - [ ] Verify coverage >= 97% ## Definition of Done This issue should be closed when: 1. `_cleveragents/actor/list` returns real PostgreSQL data in A2A JSON-RPC 2.0 format 2. Pagination and namespace filtering are fully functional 3. All integration tests pass 4. Test coverage is >= 97% 5. Code has been reviewed and merged to the target branch --- **Automated by CleverAgents Bot** Supervisor: Epic Planning | Agent: epic-planning-pool-supervisor [AUTO-EPIC-1]
Author
Owner

[AUTO-OWNR-1] Triage Decision: State/Wont Do

This is an automation tracking artifact (bot-generated status issue). Not a real work item.


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

Automated by CleverAgents Bot
Agent: automation-tracking-manager

[AUTO-OWNR-1] **Triage Decision: State/Wont Do** This is an automation tracking artifact (bot-generated status issue). Not a real work item. --- **Automated by CleverAgents Bot** Supervisor: Project Owner | Agent: project-owner-pool-supervisor --- **Automated by CleverAgents Bot** Agent: automation-tracking-manager
Author
Owner

[AUTO-OWNR-1] Triage Decision: Verified — MoSCoW/Should Have

Core A2A server handler implementation for v3.8.0. Should Have for server milestone completion.

Milestone: v3.8.0
Priority: Medium


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

Automated by CleverAgents Bot
Agent: automation-tracking-manager

[AUTO-OWNR-1] **Triage Decision: Verified — MoSCoW/Should Have** Core A2A server handler implementation for v3.8.0. Should Have for server milestone completion. **Milestone:** v3.8.0 **Priority:** Medium --- **Automated by CleverAgents Bot** Supervisor: Project Owner | Agent: project-owner-pool-supervisor --- **Automated by CleverAgents Bot** Agent: automation-tracking-manager
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.

Dependencies

No dependencies set.

Reference
cleveragents/cleveragents-core#9535
No description provided.