[Bug]: ListTasks prints unset fields on every task (history: [] with historyLength=0, empty mediaType/filename on parts)

Ouverte
#1,461 0 commentaires 0 réactions 1 personne assignée Voir sur GitHub

Les mainteneurs répondent en général sous 2 jours

@rohityan y travaille déjà.

Depuis le 12/11/2026.

  • #1477 par @saquibjawedbit — ouverte

Évaluation

Cette issue n'a pas encore été évaluée.

Description

What happened?

ListTasks (JSON-RPC and REST) serializes its tasks differently from GetTask. serialize_list_tasks_response uses MessageToDict(..., always_print_fields_with_no_presence=True), which is there so nextPageToken, pageSize and totalSize are always present. But the flag applies to the whole tree, so every nested task, message and part also gets its unset fields printed as defaults:

https://github.com/a2aproject/a2a-python/blob/2ba8e7bd27fce7de92c33813a46dbea1e3f7e6ce/src/a2a/server/routes/common.py#L32-L44

Two visible effects on main (2ba8e7b):

  1. With historyLength: 0, each task still carries "history": []. §3.2.4 says that for 0 "the history field SHOULD be omitted" (https://a2a-protocol.org/latest/specification/#324-history-length-semantics), and GetTask does omit it. #1211 fixed the same thing for artifacts, by popping the key afterwards.
  2. Messages and parts in a listed task get fields the stored task never had: "filename": "" and "mediaType": "" on a text part, "contextId": "", "taskId": "", "extensions": [] and "referenceTaskIds": [] on a message. The same task fetched with GetTask has none of them, so one task has two JSON shapes depending on the method used to read it.

Repro (one stored task, real DefaultRequestHandler behind create_jsonrpc_routes):

import asyncio, json, httpx
from starlette.applications import Starlette
from a2a.server.context import ServerCallContext
from a2a.server.request_handlers import DefaultRequestHandler
from a2a.server.routes import create_jsonrpc_routes
from a2a.server.tasks import InMemoryTaskStore
from a2a.types.a2a_pb2 import AgentCard, Message, Part, Role, Task, TaskState, TaskStatus

async def main():
    store = InMemoryTaskStore()
    msg = Message(message_id='m1', role=Role.ROLE_USER, parts=[Part(text='hi')])
    await store.save(Task(id='t1', context_id='c1', status=TaskStatus(state=TaskState.TASK_STATE_WORKING), history=[msg]), ServerCallContext())
    handler = DefaultRequestHandler(None, store, AgentCard(name='a', version='1'))
    app = Starlette(routes=create_jsonrpc_routes(handler, '/'))
    async with httpx.AsyncClient(transport=httpx.ASGITransport(app=app), base_url='http://agent', headers={'A2A-Version': '1.0'}) as c:
        async def call(method, params):
            r = await c.post('/', json={'jsonrpc': '2.0', 'id': 1, 'method': method, 'params': params})
            return r.json()['result']
        print('GetTask   historyLength=0:', json.dumps(await call('GetTask', {'id': 't1', 'historyLength': 0})))
        print('ListTasks historyLength=0:', json.dumps((await call('ListTasks', {'historyLength': 0}))['tasks'][0]))
        print('GetTask   :', json.dumps((await call('GetTask', {'id': 't1'}))['history']))
        print('ListTasks :', json.dumps((await call('ListTasks', {}))['tasks'][0]['history']))

asyncio.run(main())

Output on main:

GetTask   historyLength=0: {"id": "t1", "contextId": "c1", "status": {"state": "TASK_STATE_WORKING"}}
ListTasks historyLength=0: {"id": "t1", "contextId": "c1", "status": {"state": "TASK_STATE_WORKING"}, "history": []}
GetTask   : [{"messageId": "m1", "role": "ROLE_USER", "parts": [{"text": "hi"}]}]
ListTasks : [{"messageId": "m1", "role": "ROLE_USER", "parts": [{"text": "hi", "filename": "", "mediaType": ""}], "contextId": "", "taskId": "", "extensions": [], "referenceTaskIds": []}]

REST GET /tasks?historyLength=0 shows the same output, since both bindings use serialize_list_tasks_response.

Expected: each task in ListTasks serializes like the same task from GetTask: no history key for historyLength: 0, and no empty-default fields on messages and parts. Only the top-level response fields (tasks, nextPageToken, pageSize, totalSize) and, with includeArtifacts: true, artifacts need to be printed when empty.

Actual: history: [] with historyLength: 0, and empty-string or empty-list values on every nested message and part.

Happy to send a fix if that helps.

Code of Conduct
  • I agree to follow this project's Code of Conduct
Langage dominant
Python
Étoiles
2.2k
Forks
540
Merge moyen
2 j 9 h
PR mergées (30 j)
56

Préparer son environnement

Par où commencer

  1. Lisez l'issue en entier, puis le guide de contribution du projet.
  2. Signalez en commentaire que vous la prenez — cela évite que deux personnes fassent le même travail.
  3. Forkez le dépôt et travaillez sur une branche.
  4. Ouvrez une pull request qui référence le numéro de l'issue.

Autres issues de a2aproject/a2a-python

Toutes les issues de a2aproject/a2a-python

Issues similaires

Plus d'issues Python

Recevez les nouvelles issues par e-mail

Un résumé court des issues GitHub adaptées aux débutants.