Hacktoberfest 2026: le issue che i maintainer hanno segnato per ottobre, aperte e adatte ai principianti. Sfoglia le issue Hacktoberfest

message/send JSON-RPC result is wrapped in the SendMessageResponse oneof instead of returning the Task/Message directly

Chiusa Adatta ai principianti
  • Qualcosa non va?
#1,192 3 commenti 0 reazioni 1 assegnatario Vedi su GitHub

I maintainer di solito rispondono entro 1 giorno

@rohityan ci sta già lavorando.

Dal 19/8/2026.

Valutazione

Difficoltà
2/5
Tempo stimato
1-3 ore
Idoneità per principianti
70/100
Tipo di issue
Bug
Chiarezza
Specificata chiaramente
Stato di attività
Attiva
Ambito
api

Direzione di ricerca

Il problema si trova in a2a/server/routes/jsonrpc_dispatcher.py, nella funzione _handle_send_message. Confrontala con _handle_get_task e _handle_cancel_task per vedere la differenza nel modo in cui serializzano il valore restituito. La correzione consiste nel rimuovere il wrapper SendMessageResponse e restituire direttamente Task o Message tramite MessageToDict. Esegui i test esistenti per le route JSON-RPC per verificare che la modifica produca la struttura JSON prevista.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

component: server

Environment

  • a2a-sdk 1.0.3
  • Python 3.13
  • Transport: JSON-RPC (create_jsonrpc_routes, DefaultRequestHandlerV2), enable_v0_3_compat=True

Summary

For a 1.x message/send call, the JSON-RPC result comes back as {"task": {…}} (or {"message": {…}}) rather than the Task or Message object itself. A client that reads result.status and result.artifacts, which the A2A 1.0 spec describes for the unary send, finds nothing, because the payload sits one level deeper under result.task.

The task/message oneof belongs to the streaming StreamResponse. The unary message/send should return the Task or Message directly, the way tasks/get and tasks/cancel already do.

Expected

{ "jsonrpc": "2.0", "id": "1", "result": { "id": "…", "contextId": "…", "status": {…}, "artifacts": [ … ] } }

Actual

{ "jsonrpc": "2.0", "id": "1", "result": { "task": { "id": "…", "contextId": "…", "status": {…}, "artifacts": [ … ] } } }

Root cause

In a2a/server/routes/jsonrpc_dispatcher.py, _handle_send_message wraps the return value in a SendMessageResponse before serializing:

async def _handle_send_message(self, request_obj, context):
    task_or_message = await self.request_handler.on_message_send(request_obj, context)
    if isinstance(task_or_message, Task):
        return MessageToDict(SendMessageResponse(task=task_or_message))
    return MessageToDict(SendMessageResponse(message=task_or_message))

MessageToDict on a SendMessageResponse emits the oneof field name (task or message) as a key, which becomes the JSON-RPC result. The sibling handlers serialize the object directly and do not show this wrapper:

async def _handle_get_task(self, request_obj, context):
    task = await self.request_handler.on_get_task(request_obj, context)
    return MessageToDict(task, preserving_proto_field_name=False)

Impact

A2A 1.0 clients that follow the spec read the Task at result, not at result.task. Against this SDK they see an empty result and report the call as incomplete. The two shapes also disagree within one SDK: tasks/get returns the Task un-nested, message/send nests it, so a client cannot use one code path for both.

Reproduce

  1. Stand up any agent with create_jsonrpc_routes(...).
  2. POST a 1.x message/send (method: "SendMessage").
  3. Read the response: result has a single key, task.

Suggested fix

Return the Task or Message directly from _handle_send_message, matching _handle_get_task and _handle_cancel_task:

async def _handle_send_message(self, request_obj, context):
    task_or_message = await self.request_handler.on_message_send(request_obj, context)
    return MessageToDict(task_or_message, preserving_proto_field_name=False)

The v0.3 compat path is unaffected. It already returns the Task/Message directly through the v0.3 adapter.

Lingua principale
Python
Stelle
2.2k
Fork
499
Merge medio
3g 14h
PR unite (30g)
36

Preparare l'ambiente

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di a2aproject/a2a-python

Tutte le issue di a2aproject/a2a-python

Issue simili

Altre issue su Python

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.