a2aproject / a2aproject/a2a-dotnet

Reconsider IA2AClient, ITaskManager, ITaskStore interfaces

Open
#133 1 comment 1 reaction 0 assignees View on GitHub
Dominant language
C#
Stars
262
Forks
64
Avg merge
5d 2h
Merged PRs (30d)
31

Description

### Context:
The A2A SDK declares a few public interfaces: `IA2AClient`, `ITaskManager`, `ITaskStore`, and corresponding classes that implement them. While having the interfaces may be quite convenient for polymorphic (when different implementations are required) and testability (mocking a class for testing purposes) cases, exposing the interfaces as part of the public API surface of SDKs may have downsides, such as a source of breaking changes for all third-party implementations that SDK authors are not aware of when new members are added to them.

### ToDo:
1. Identify all public interfaces in the SDK.
2. For each interface, consider:
- Whether it is actually required, and if not, consider removing it.
- Whether it can be turned into an abstract class. New members can easily be added to abstract classes as virtual without breaking existing implementations, but there could be a downside in case a consumer's class already inherits from another class - C# does not allow multiple inheritance.

Contributor guide

Open the contributing guide

Research direction

Start by locating the public interfaces in the SDK codebase, likely in a directory like src/A2A. Examine IA2AClient, ITaskManager, ITaskStore and any others. Review their usage in the project and tests to understand if they are required. Consider the trade-offs between interfaces and abstract classes for each, and check for any existing third-party implementations. The outcome is a decision on whether to remove, keep, or convert each interface.

Written by the indexing model from the issue text.

Assessment

Tech stack
csharp
Domain
backend-api-design
Issue type
Refactor
Difficulty
4/5
Estimated time
3-5 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.