a2aproject / a2aproject/A2A

[Question] Task listing pagination behavior clarification

Aperta
#1,263 0 commenti 0 reazioni 0 assegnatari Vedi su GitHub
Lingua principale
Shell
Stelle
25.7k
Fork
2.6k
Merge medio
3g 6h
PR unite (30g)
16

Descrizione

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

Guida per i contributori

Apri la guida per i contributori

Direzione di ricerca

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.

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

Valutazione

Ambito
api, documentation
Tipo di issue
Documentazione
Difficoltà
4/5
Tempo stimato
3-5 giorni
Stato di attività
Ferma
Chiarezza
Abbastanza chiara
Idoneità per principianti
35/100

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.