From 01c321aef3d351bcf35440279ca6725bdc6ef115 Mon Sep 17 00:00:00 2001 From: Albert Chu Date: Fri, 12 Dec 2025 11:38:21 -0800 Subject: [PATCH] rfc43: support job-list.list response version Problem: The job-list.list service is forwards compatible, where older non-streaming clients can communicate with newer services. However it is not backwards compatible, where newer streaming clients can operate with older services. Add a version field to the "job-list.list" RPC response. This can inform newer clients on what protocol behavior is expected from both older and newer job-list.list services. --- spec_43.rst | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/spec_43.rst b/spec_43.rst index 5b64cae..2bd0024 100644 --- a/spec_43.rst +++ b/spec_43.rst @@ -328,6 +328,14 @@ The RPC payloads are defined as follows: the request. Each object will contain the requested attributes in an object described in :ref:`spec_43_job_attributes`. + .. object:: version + + (*integer*, OPTIONAL) Specify the current protocol version. If + jobs will be streamed, this field is required and SHALL be set to + 1 in the very first response. The field is unlisted in subsequent + responses. If jobs will not be streamed, the protocol version can + be set to 0 or it can be unlisted in the first response. + List ID =======