Point the Python client at the StreamAlarms alarm feed

Regenerate the Python protobuf stubs and replace query_active_alarms
with stream_alarms, an AsyncIterator over AlarmFeedMessage served by
the gateway's central alarm monitor (snapshot, snapshot_complete, then
live transitions). Drops session_id from the acknowledge surface.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

clients/python/src/mxgateway/client.py

@@ -166,25 +166,27 @@ class GatewayClient:
         ensure_protocol_success("acknowledge alarm", reply.protocol_status, reply)
         return reply
 
-    def query_active_alarms(
+    def stream_alarms(
         self,
-        request: pb.QueryActiveAlarmsRequest,
+        request: pb.StreamAlarmsRequest,
         *,
         metadata: Sequence[tuple[str, str]] | None = None,
-    ) -> AsyncIterator[pb.ActiveAlarmSnapshot]:
-        """Stream a snapshot of all alarms currently Active or ActiveAcked.
+    ) -> AsyncIterator[pb.AlarmFeedMessage]:
+        """Attach to the gateway's central alarm feed.
 
-        The gateway's ConditionRefresh equivalent. Use after reconnect to seed
-        local Part 9 state, or to reconcile alarms that may have been missed
-        during a transport blip. Optionally scoped by alarm-reference prefix
-        (``request.alarm_filter_prefix``) so a partial refresh can target an
-        equipment sub-tree.
+        The stream opens with one ``AlarmFeedMessage`` per currently-active
+        alarm (the ConditionRefresh snapshot), then a single
+        ``snapshot_complete``, then a ``transition`` for every subsequent
+        raise / acknowledge / clear. Served by the gateway's always-on alarm
+        monitor — no worker session is opened — so any number of clients may
+        attach. Optionally scoped by alarm-reference prefix
+        (``request.alarm_filter_prefix``).
         """
         kwargs: dict[str, Any] = {"metadata": merge_metadata(self.options.api_key, metadata)}
         if self.options.stream_timeout is not None:
             kwargs["timeout"] = self.options.stream_timeout
-        call = _open_stream(self.raw_stub.QueryActiveAlarms, request, kwargs)
-        return _canceling_iterator(call, "query active alarms")
+        call = _open_stream(self.raw_stub.StreamAlarms, request, kwargs)
+        return _canceling_iterator(call, "stream alarms")
 
     async def _unary(
         self,

clients/python/src/mxgateway/generated/mxaccess_gateway_pb2_grpc.py

@@ -30,8 +30,7 @@ class MxAccessGatewayStub(object):
     additively only. Never renumber or repurpose an existing field number or
     enum value. When a field or enum value is removed, add a `reserved` range
     (and `reserved` name) covering it in the same change so a future editor
-    cannot accidentally reuse the retired tag. There are no `reserved`
-    declarations today because no field or enum value has ever been removed.
+    cannot accidentally reuse the retired tag.
 
     Public client API for MXAccess sessions hosted by the gateway.
     """
@@ -67,10 +66,10 @@ class MxAccessGatewayStub(object):
                 request_serializer=mxaccess__gateway__pb2.AcknowledgeAlarmRequest.SerializeToString,
                 response_deserializer=mxaccess__gateway__pb2.AcknowledgeAlarmReply.FromString,
                 _registered_method=True)
-        self.QueryActiveAlarms = channel.unary_stream(
-                '/mxaccess_gateway.v1.MxAccessGateway/QueryActiveAlarms',
-                request_serializer=mxaccess__gateway__pb2.QueryActiveAlarmsRequest.SerializeToString,
-                response_deserializer=mxaccess__gateway__pb2.ActiveAlarmSnapshot.FromString,
+        self.StreamAlarms = channel.unary_stream(
+                '/mxaccess_gateway.v1.MxAccessGateway/StreamAlarms',
+                request_serializer=mxaccess__gateway__pb2.StreamAlarmsRequest.SerializeToString,
+                response_deserializer=mxaccess__gateway__pb2.AlarmFeedMessage.FromString,
                 _registered_method=True)
 
 
@@ -79,8 +78,7 @@ class MxAccessGatewayServicer(object):
     additively only. Never renumber or repurpose an existing field number or
     enum value. When a field or enum value is removed, add a `reserved` range
     (and `reserved` name) covering it in the same change so a future editor
-    cannot accidentally reuse the retired tag. There are no `reserved`
-    declarations today because no field or enum value has ever been removed.
+    cannot accidentally reuse the retired tag.
 
     Public client API for MXAccess sessions hosted by the gateway.
     """
@@ -115,8 +113,13 @@ class MxAccessGatewayServicer(object):
         context.set_details('Method not implemented!')
         raise NotImplementedError('Method not implemented!')
 
-    def QueryActiveAlarms(self, request, context):
-        """Missing associated documentation comment in .proto file."""
+    def StreamAlarms(self, request, context):
+        """Session-less central alarm feed. The stream opens with the current
+        active-alarm snapshot (one `active_alarm` per alarm), then a single
+        `snapshot_complete`, then a `transition` for every subsequent change.
+        Served by the gateway's always-on alarm monitor; any number of clients
+        fan out from the single monitor without opening a worker session.
+        """
         context.set_code(grpc.StatusCode.UNIMPLEMENTED)
         context.set_details('Method not implemented!')
         raise NotImplementedError('Method not implemented!')
@@ -149,10 +152,10 @@ def add_MxAccessGatewayServicer_to_server(servicer, server):
                     request_deserializer=mxaccess__gateway__pb2.AcknowledgeAlarmRequest.FromString,
                     response_serializer=mxaccess__gateway__pb2.AcknowledgeAlarmReply.SerializeToString,
             ),
-            'QueryActiveAlarms': grpc.unary_stream_rpc_method_handler(
-                    servicer.QueryActiveAlarms,
-                    request_deserializer=mxaccess__gateway__pb2.QueryActiveAlarmsRequest.FromString,
-                    response_serializer=mxaccess__gateway__pb2.ActiveAlarmSnapshot.SerializeToString,
+            'StreamAlarms': grpc.unary_stream_rpc_method_handler(
+                    servicer.StreamAlarms,
+                    request_deserializer=mxaccess__gateway__pb2.StreamAlarmsRequest.FromString,
+                    response_serializer=mxaccess__gateway__pb2.AlarmFeedMessage.SerializeToString,
             ),
     }
     generic_handler = grpc.method_handlers_generic_handler(
@@ -167,8 +170,7 @@ class MxAccessGateway(object):
     additively only. Never renumber or repurpose an existing field number or
     enum value. When a field or enum value is removed, add a `reserved` range
     (and `reserved` name) covering it in the same change so a future editor
-    cannot accidentally reuse the retired tag. There are no `reserved`
-    declarations today because no field or enum value has ever been removed.
+    cannot accidentally reuse the retired tag.
 
     Public client API for MXAccess sessions hosted by the gateway.
     """
@@ -309,7 +311,7 @@ class MxAccessGateway(object):
             _registered_method=True)
 
     @staticmethod
-    def QueryActiveAlarms(request,
+    def StreamAlarms(request,
             target,
             options=(),
             channel_credentials=None,
@@ -322,9 +324,9 @@ class MxAccessGateway(object):
         return grpc.experimental.unary_stream(
             request,
             target,
-            '/mxaccess_gateway.v1.MxAccessGateway/QueryActiveAlarms',
-            mxaccess__gateway__pb2.QueryActiveAlarmsRequest.SerializeToString,
-            mxaccess__gateway__pb2.ActiveAlarmSnapshot.FromString,
+            '/mxaccess_gateway.v1.MxAccessGateway/StreamAlarms',
+            mxaccess__gateway__pb2.StreamAlarmsRequest.SerializeToString,
+            mxaccess__gateway__pb2.AlarmFeedMessage.FromString,
             options,
             channel_credentials,
             insecure,