Maintenance

[alDuncanson]

This pull request introduces several improvements and refactors across the CLI, TUI, service layer, and documentation to enhance authentication handling, agent card retrieval, and developer experience. The most significant changes are the addition of robust fallback logic for agent card discovery, improved credential management throughout the CLI and TUI, and expanded test coverage for authentication flows.

Agent card retrieval improvements:

• The A2AService.get_card method now tries the standard well-known path (agent-card.json) first, and falls back to the legacy path (agent.json) if needed, improving compatibility with older agents. This fallback logic is also used in validation routines. [1] [2]

Authentication and credential management:

• The CLI and TUI now consistently pass and apply credentials for agent operations. CLI commands fetch stored credentials when -a/--authenticated is used, and the TUI can be preconfigured with a bearer token via a new option. Credentials are properly cleared when not needed. [1] [2] [3] [4] [5] [6] [7] [8] [9]

Service layer enhancements:

• The A2AService class adds a clear_credentials method to remove authentication headers and reset the client cache, ensuring correct behavior when switching between authenticated and unauthenticated requests.

Documentation and developer experience:

• The AGENTS.md documentation is updated to clarify environment management with uv and to specify conventional commit message requirements. [1] [2]
• Dependency versions are bumped in pyproject.toml for a2a-sdk and google-adk.

Expanded test coverage:

• New and updated tests verify credential passing in CLI commands, bearer token handling in the TUI, and API key authentication middleware behavior. [1] [2] [3]

Let me know if you want to walk through any of these changes in more detail!