bug: an unknown --a2a-version is not a usage error

Open
#155 0 comments 0 reactions 0 assignees View on GitHub

Maintainers usually reply within 2 days

@ConnorMoss02 is already working on this.

Since Nov 12, 2026.

  • #157 by @ConnorMoss02 — open

Assessment

Difficulty
2/5
Estimated time
1-3 hours
Newbie friendliness
25/100
Issue type
Bug
Clarity
Clearly specified
Activity status
Active
Tech stack
go
Domain
cli

Research direction

The flag value is accepted without validation, so unknown versions fall through to clientFactoryOpts, where no transports get registered. Start by finding where --a2a-version is parsed and where the 'no compatible transports found' error is produced. Done means an unsupported value fails early as a usage error that names the flag and lists the accepted values. Pull request #157 is already open against this issue, so check it before starting.

Written by the indexing model from the issue text.

Description

What happened?

--a2a-version only accepts 1.0 or 0.3. Any other value registers no transports in clientFactoryOpts, so the command fails with no compatible transports found, exit 1 as A2ACLI_ERR_INTERNAL. If the card can't be reached it exits 3 with a connectivity hint instead. Nothing says the flag value is the problem.

Steps to reproduce
  1. a2a server --echo --port 18431
  2. a2a send -a http://127.0.0.1:18431 --a2a-version 1 hi exits 1 with:
Error: failed to create a client: no compatible transports found: available transports - [HTTP+JSON_1.0]
  1. a2a send -a http://127.0.0.1:1 --a2a-version 1 hi exits 3 with failed to resolve agent card.
CLI version

main @ 5c95123

Operating system & environment

macOS (Darwin 25.6.0), arm64

Dominant language
Go
Stars
181
Forks
28
Avg merge
2d 11h
Merged PRs (30d)
22

Getting set up

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from a2aproject/a2a-cli

All issues in a2aproject/a2a-cli

Similar issues

More Go issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.