a2aproject / a2aproject/A2A

[Question] Task listing pagination behavior clarification

Offen
#1,263 0 Kommentare 0 Reaktionen 0 zugewiesene Personen Auf GitHub ansehen
Vorherrschende Sprache
Shell
Sterne
25.7k
Forks
2.6k
Ø Merge
3 T. 6 Std.
Gemergte PRs (30 T.)
16

Beschreibung

For [list-tasks method](https://a2a-protocol.org/latest/specification/#314-list-tasks) the specification is explicit about ordering:

> Implementations MUST return tasks sorted by their last update time in descending order (most recently updated tasks first). This ensures consistent pagination and allows clients to efficiently monitor recent task activity.

The use of a non-monotonic mutable field as a pagination cursor makes it possible for tasks to be skipped. How do we know the last-updated ordering is going to be the most important / common / useful? Should the MUST requirement be relaxed to give implementers more flexibility?
```
// Tasks returned sorted by last_update DESC
|task1, task2|, task3

// If task3 changes before the next page is requested it is never returned:
task3, task1, task2 || <- last_update < task2.last_update
```

Would also be good to add a requirement level clarification for `pageSize` (must or should?).

### Code of Conduct

- [x] I agree to follow this project's Code of Conduct

Beitragsleitfaden

Beitragsleitfaden öffnen

Rechercherichtung

Review the A2A specification section 3.14 list-tasks method to understand the current ordering requirement. Examine the protocol's pagination model and consider edge cases where tasks could be skipped due to updates. Look for existing implementations or discussions about task listing to gauge common usage patterns. Determine if the MUST should be relaxed to a SHOULD and clarify the pageSize requirement level.

Vom Indexierungsmodell aus dem Issue-Text verfasst.

Bewertung

Bereich
api, documentation
Issue-Typ
Dokumentation
Schwierigkeit
4/5
Geschätzter Aufwand
3-5 Tage
Aktivitätsstatus
Veraltet
Klarheit
Größtenteils klar
Anfängerfreundlichkeit
35/100

Neue Issues direkt in Ihr Postfach

Eine kurze Übersicht über anfängerfreundliche GitHub-Issues.