feat(server): implement /.well-known/agent.json Agent Card endpoint with correct registry metadata #9539

Open
opened 2026-04-14 21:39:12 +00:00 by HAL9000 · 8 comments
Owner

Metadata

  • Commit message: feat(server): implement Agent Card endpoint with correct registry metadata
  • Branch name: feat/v3.8.0-agent-card-endpoint
  • Parent Epic: #9498 (EPIC: Registry & Resource Discovery — Real Data from Server Registry v3.8.0)
  • Blocks: #9498

Background and Context

The Agent Card endpoint (/.well-known/agent.json) must serve correct metadata about the CleverAgents server including available capabilities, supported A2A methods, and registry information. This is a standard A2A protocol requirement that allows clients to discover server capabilities before establishing a session. Currently this endpoint is missing or returns incomplete/incorrect data.

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

Expected Behavior

GET /.well-known/agent.json should return a valid Agent Card JSON document that accurately describes the CleverAgents server's capabilities, supported A2A extension methods, and registry metadata. This enables A2A-compliant clients to auto-discover and configure themselves against the server.

Acceptance Criteria

  • GET /.well-known/agent.json returns valid Agent Card JSON (HTTP 200, Content-Type: application/json)
  • Agent Card includes correct server capabilities (name, version, description, etc.)
  • Agent Card lists all supported A2A extension methods (_cleveragents/*)
  • Agent Card includes registry metadata (available namespaces, resource types)
  • Integration tests pass against the running FastAPI server
  • Test coverage >= 97%

Subtasks

  • Implement Agent Card data model (Pydantic schema matching A2A spec)
  • Implement /.well-known/agent.json FastAPI endpoint
  • Populate Agent Card with server capabilities (name, version, description, provider info)
  • Populate Agent Card with supported A2A extension methods (_cleveragents/actor/list, _cleveragents/skill/list, _cleveragents/action/list, _cleveragents/project/list, etc.)
  • Populate Agent Card with registry metadata (namespaces, resource types)
  • Write integration tests
  • Verify coverage >= 97%

Definition of Done

This issue should be closed when:

  1. GET /.well-known/agent.json returns a valid, complete Agent Card JSON document
  2. Agent Card accurately reflects server capabilities, supported methods, and registry metadata
  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 Agent Card endpoint with correct registry metadata` - **Branch name:** `feat/v3.8.0-agent-card-endpoint` - **Parent Epic:** #9498 (EPIC: Registry & Resource Discovery — Real Data from Server Registry v3.8.0) - **Blocks:** #9498 ## Background and Context The Agent Card endpoint (`/.well-known/agent.json`) must serve correct metadata about the CleverAgents server including available capabilities, supported A2A methods, and registry information. This is a standard A2A protocol requirement that allows clients to discover server capabilities before establishing a session. Currently this endpoint is missing or returns incomplete/incorrect data. This is a child implementation issue of Epic #9498 and blocks its completion. This issue blocks parent Epic #9498. ## Expected Behavior `GET /.well-known/agent.json` should return a valid Agent Card JSON document that accurately describes the CleverAgents server's capabilities, supported A2A extension methods, and registry metadata. This enables A2A-compliant clients to auto-discover and configure themselves against the server. ## Acceptance Criteria - [ ] `GET /.well-known/agent.json` returns valid Agent Card JSON (HTTP 200, `Content-Type: application/json`) - [ ] Agent Card includes correct server capabilities (name, version, description, etc.) - [ ] Agent Card lists all supported A2A extension methods (`_cleveragents/*`) - [ ] Agent Card includes registry metadata (available namespaces, resource types) - [ ] Integration tests pass against the running FastAPI server - [ ] Test coverage >= 97% ## Subtasks - [ ] Implement Agent Card data model (Pydantic schema matching A2A spec) - [ ] Implement `/.well-known/agent.json` FastAPI endpoint - [ ] Populate Agent Card with server capabilities (name, version, description, provider info) - [ ] Populate Agent Card with supported A2A extension methods (`_cleveragents/actor/list`, `_cleveragents/skill/list`, `_cleveragents/action/list`, `_cleveragents/project/list`, etc.) - [ ] Populate Agent Card with registry metadata (namespaces, resource types) - [ ] Write integration tests - [ ] Verify coverage >= 97% ## Definition of Done This issue should be closed when: 1. `GET /.well-known/agent.json` returns a valid, complete Agent Card JSON document 2. Agent Card accurately reflects server capabilities, supported methods, and registry metadata 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
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
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
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
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
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
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
HAL9000 added this to the v3.8.0 milestone 2026-04-15 23:50:55 +00:00
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#9539
No description provided.