proto&readme: list offsets bumps for KIP-1005 & KIP-1075

twmb · twmb · commit af63cf90e951 · 2025-04-09T17:50:47.000-06:00
diff --git a/README.md b/README.md
@@ -411,6 +411,8 @@ generation.
 | [KIP-919](https://cwiki.apache.org/confluence/display/KAFKA/KIP-919%3A+Allow+AdminClient+to+Talk+Directly+with+the+KRaft+Controller+Quorum+and+add+Controller+Registration) — Admin client talk to KRaft , Controller registration | 3.7 | Supported (proto) |
 | [KIP-951](https://cwiki.apache.org/confluence/display/KAFKA/KIP-951%3A+Leader+discovery+optimisations+for+the+client) — Leader discovery optimizations | 3.7 | Supported |
 | [KIP-994](https://cwiki.apache.org/confluence/display/KAFKA/KIP-994%3A+Minor+Enhancements+to+ListTransactions+and+DescribeTransactions+APIs) — List/Describe transactions enhancements | 3.8 (partial) | Supported |
+| [KIP-1005](https://cwiki.apache.org/confluence/display/KAFKA/KIP-1005%3A+Expose+EarliestLocalOffset+and+TieredOffset) — ListOffsets w. Timestamp -5 | 3.9 | Supported |
+| [KIP-1075](https://cwiki.apache.org/confluence/display/KAFKA/KIP-1075%3A+Introduce+delayed+remote+list+offsets+purgatory+to+make+LIST_OFFSETS+async) — TimeoutMillis on ListOffsets | 4.0 | Supported |
 
 Missing from above but included in librdkafka is:
 
diff --git a/generate/definitions/02_list_offsets b/generate/definitions/02_list_offsets
@@ -10,7 +10,14 @@
 //
 // Version 8, introduced in Kafka 3.4, supports -4 as a timestamp to return
 // the local log start offset (in the context of tiered storage, see KIP-405).
-ListOffsetsRequest => key 2, max version 8, flexible v6+
+//
+// Version 9, introduced in Kafka 3.9, supports -5 as a timestamp to return
+// the latest offset in remote storage. See KIP-1005.
+//
+// Version 10, introduced in Kafka 4.0, adds TimeoutMillis, allowing you to set
+// a timeout when the ListOffsets request triggers a lookup from remote storage.
+// See KIP-1075.
+ListOffsetsRequest => key 2, max version 10, flexible v6+
   // ReplicaID is the broker ID to get offsets from. As a Kafka client, use -1.
   // The consumer replica ID (-1) causes requests to only succeed if issued
   // against the leader broker.
@@ -61,10 +68,16 @@ ListOffsetsRequest => key 2, max version 8, flexible v6+
       // KIP-405), the new special timestamp -4 returns the local log start
       // offset. In the context of tiered storage, the earliest local log start
       // offset is the offset actually available on disk on the broker.
+      //
+      // If you are talking to Kafka 3.9+ and using request version 9+ (for KIP-1005),
+      // the special timestamp -5 returns the latest offset in remote storage.
       Timestamp: int64
       // MaxNumOffsets is the maximum number of offsets to report.
       // This was removed after v0.
       MaxNumOffsets: int32(1) // v0-v0
+  // TimeoutMillis is how long to wait for a lookup the offset being looked up
+  // is in remote storage.
+  TimeoutMillis: int32(30000) // v10+
 
 // ListOffsetsResponse is returned from a ListOffsetsRequest.
 ListOffsetsResponse =>
