[Bug]: A2ACardResolver.get_agent_card raises UnicodeDecodeError and RecursionError instead of AgentCardResolutionError

Open
#1,478 0 comments 0 reactions 2 assignees View on GitHub

Maintainers usually reply within 2 days

@rohityan is already working on this.

Since Nov 16, 2026.

Assessment

This issue has not been assessed yet.

Description

What happened?

A2ACardResolver.get_agent_card() documents AgentCardResolutionError when "the response body cannot be decoded as JSON", and #1307 made the parser side keep that promise. Two bodies still escape as builtins, because the except clauses catch only json.JSONDecodeError: a card served as Latin-1 raises UnicodeDecodeError, and a deeply nested body raises RecursionError. A caller that handles AgentCardResolutionError around card discovery gets an unhandled exception from a remote agent's bad card.

Reproduced on caab6a2 (main), Python 3.10.21, httpx 0.28.1:

import asyncio
import httpx
from a2a.client import A2ACardResolver, AgentCardResolutionError

BODIES = {
    'latin-1 body': '{"name": "Café"}'.encode('latin-1'),
    'deep nesting': b'{"name": ' + b'[' * 100_000 + b']' * 100_000 + b'}',
}

async def main():
    for label, body in BODIES.items():
        transport = httpx.MockTransport(lambda _, b=body: httpx.Response(200, content=b))
        async with httpx.AsyncClient(transport=transport) as client:
            try:
                await A2ACardResolver(client, 'http://agent').get_agent_card()
            except AgentCardResolutionError as e:
                print(label, '-> AgentCardResolutionError')
            except Exception as e:
                print(label, '->', type(e).__name__, e)

asyncio.run(main())

Expected: both lines print AgentCardResolutionError, the same as a body of [] does today.

Listing UnicodeDecodeError and RecursionError beside json.JSONDecodeError would cover it. A bare ValueError would also swallow one raised by a caller's signature_verifier, which runs in the same try. I only checked the 1.0 resolver, not the v0.3 compat path. Happy to open the pull request with a MockTransport test for each body if that fix works for you.

Relevant log output
$ python repro.py
latin-1 body -> UnicodeDecodeError 'utf-8' codec can't decode byte 0xe9 in position 13: invalid continuation byte
deep nesting -> RecursionError maximum recursion depth exceeded while decoding a JSON array from a unicode string
Code of Conduct
  • I agree to follow this project's Code of Conduct
Dominant language
Python
Stars
2.2k
Forks
540
Avg merge
2d 10h
Merged PRs (30d)
57

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-python

All issues in a2aproject/a2a-python

Similar issues

More Python issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.