Skip to content

收敛 db 相关实现到 a2a-sdk 原生列表与初始化最佳实践 #442

@liujuanjuan1984

Description

@liujuanjuan1984

背景

当前主干在数据库相关实现上仍有两处与 a2a-sdk 1.0 最佳实践不完全对齐的点:

  1. GET /v1/tasks 自定义路由没有充分下推到 SDK 原生 task_store.list() / on_list_tasks() 分页与过滤路径,而是先拉全量任务再在进程内二次过滤、排序和分页。
  2. task_store 初始化已经接入自定义 schema migration,但当前实现直接旁路了 SDK DatabaseTaskStore.initialize() 生命周期,后续会增加与上游初始化逻辑漂移的维护风险。

目标

  1. 收敛 GET /v1/tasks 到以 SDK 原生列表能力为主的实现,同时保留本仓库必要的输出协商与扩展过滤行为。
  2. 收敛 task-store 初始化路径,使自定义兼容迁移与 SDK 自身 initialize() 生命周期协同,而不是跳过 SDK 初始化。
  3. 更新回归测试与文档,确保行为、实现边界与描述一致。

验收标准

  • GET /v1/tasks 不再通过全量拉取全部任务再内存分页的方式实现。
  • task-store 初始化不再通过手动设置 _initialized=True 跳过 SDK initialize()
  • 回归测试覆盖新的列表路径与初始化协同行为。
  • ./scripts/doctor.sh 通过。

关联

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions