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

未关闭
#1,461 0 条评论 0 个 reaction 已指派 1 人 在 GitHub 查看

维护者通常 2 天内回复

@rohityan 已经在做这个了。

开始于 2026年11月12日。

  • #1477 来自 @saquibjawedbit —— 未关闭

评估

这个 Issue 还没有评估数据。

描述

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
主要语言
Python
星标
2.2k
派生
540
平均合并
2 天 9 小时
30 天内合并 PR
56

环境准备

从这里开始

  1. 先读完整个 Issue,再读项目的贡献指南。
  2. 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
  3. Fork 仓库,在一个分支上完成修改。
  4. 提交 Pull Request,并在描述里引用这个 Issue 编号。

a2aproject/a2a-python 的其他 Issue

查看 a2aproject/a2a-python 的全部 Issue

相似的 Issue

更多 Python Issue

把新 issue 发到你的邮箱

精选适合新手参与的 GitHub issue 摘要。