[FEATURE] Create a function to allow listing A2A agents

[edenreich]

Summary

The Inference Gateway supports list of A2A servers when they are exposed on the Gateway.

Currently there is a no function to list those agents or perform operations that are described in the OpenAPI spec of the gateway.

https://github.com/inference-gateway/inference-gateway/blob/main/openapi.yaml

Acceptance Criteria

• The OpenAPI spec is downloaded and contains the latest changes
• There is a function on the SDK to list all available A2A servers that follows the OpenAPI spec schema
• There is a function to fetch a specific agent ID details
• It's documented
• It's tested

[edenreich]

@claude can you work on this?

[claude]

Claude finished @edenreich's task —— View job • claude/issue-24-20250828-0310 • Create PR ➔

---

✅ Task Completed Successfully!

I have successfully implemented A2A agent listing functionality for the Inference Gateway SDK.

Todo List:

• Analyze current codebase structure and patterns
• Download latest OpenAPI spec
• Generate types from OpenAPI spec
• Implement A2A agent listing function
• Implement function to fetch specific agent by ID
• Write comprehensive tests following TDD approach
• Add documentation
• Run linting and testing
• Commit changes and provide PR link

🎯 Implementation Summary

New Functions Added:

• ListAgents(ctx context.Context) (*ListAgentsResponse, error) - Lists all available A2A agents
• GetAgent(ctx context.Context, id string) (*A2AAgentCard, error) - Retrieves a specific agent by ID

✅ Acceptance Criteria Met:

• ✅ OpenAPI spec downloaded - Latest schema with A2A endpoints
• ✅ SDK functions implemented - Both listing and individual agent retrieval
• ✅ Follows OpenAPI spec schema - Proper types and response structures
• ✅ Documented - Complete Go documentation with usage examples
• ✅ Tested - Comprehensive test suite with 88 passing tests

🧪 Testing Coverage:

• Happy path scenarios: Successful agent listing and retrieval
• Error handling: 403 Forbidden, 401 Unauthorized, 404 Not Found, 500 Internal Server Error
• Edge cases: Empty agent IDs, special characters, timeout handling
• Table-driven tests: Multiple scenarios per function
• All tests pass: 88/88 ✅

🔧 Technical Details:

• Uses latest OpenAPI spec with A2A endpoints (/a2a/agents and /a2a/agents/{id})
• Generated proper Go types (A2AAgentCard, ListAgentsResponse)
• Follows existing SDK patterns (retry logic, error handling, context support)
• Includes comprehensive documentation with usage examples
• Passes all linting checks

📝 Changes Committed:

• openapi.yaml - Updated with latest A2A endpoints
• generated_types.go - New A2A types and structures
• sdk.go - Implementation of ListAgents() and GetAgent()
• sdk_test.go - Comprehensive test suite

🚀 Ready for Use

The new A2A functionality is ready and follows the same patterns as existing SDK functions like ListModels() and ListTools(). Users can now:

// List all A2A agents
agents, err := client.ListAgents(ctx)
if err != nil {
    log.Fatalf("Error: %v", err)
}

// Get specific agent by ID
agent, err := client.GetAgent(ctx, "agent-id-123")
if err != nil {
    log.Fatalf("Error: %v", err)
}

---

[github-actions]

🎉 This issue has been resolved in version 1.13.0 🎉

The release is available on GitHub release

Your semantic-release bot 📦🚀