pgfsm-proto-codegen 0.1.0__tar.gz

pgfsm_proto_codegen-0.1.0/PKG-INFO

@@ -0,0 +1,33 @@
+Metadata-Version: 2.4
+Name: pgfsm-proto-codegen
+Version: 0.1.0
+Summary: Generated protobuf + gRPC stubs for the pgfsm Activity Gateway and Sidecar Gateway contracts.
+License-Expression: Apache-2.0
+Project-URL: Repository, https://github.com/pgfsm/fsm
+Project-URL: Source, https://github.com/pgfsm/fsm/tree/main/packages/fsm-proto-codegen
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: grpcio<2,>=1.60
+Requires-Dist: protobuf<8,>=7.35.1
+
+# pgfsm-proto-codegen
+
+Generated protobuf + gRPC stubs for [pgfsm](https://github.com/pgfsm/fsm)'s
+Activity Gateway (`pgfsm.activitygateway.v1`) and Sidecar Gateway
+(`pgfsm.sidecargateway.v1`) contracts.
+
+```sh
+pip install pgfsm-proto-codegen
+```
+
+```python
+from pgfsm.activitygateway.v1 import activity_gateway_pb2, activity_gateway_pb2_grpc
+from pgfsm.sidecargateway.v1 import sidecar_gateway_pb2, sidecar_gateway_pb2_grpc
+```
+
+Generated by `buf generate` from the `.proto` sources in
+[`packages/fsm-proto-codegen`](https://github.com/pgfsm/fsm/tree/main/packages/fsm-proto-codegen)
+— don't edit, regenerate. The same contracts are published for TypeScript
+(`@pgfsm/proto-codegen` on npm), Rust (`pgfsm-proto-codegen` on crates.io), and
+Go (`github.com/pgfsm/fsm/packages/fsm-proto-codegen/gen/go`), all at the same
+version.

pgfsm_proto_codegen-0.1.0/README.md

@@ -0,0 +1,21 @@
+# pgfsm-proto-codegen
+
+Generated protobuf + gRPC stubs for [pgfsm](https://github.com/pgfsm/fsm)'s
+Activity Gateway (`pgfsm.activitygateway.v1`) and Sidecar Gateway
+(`pgfsm.sidecargateway.v1`) contracts.
+
+```sh
+pip install pgfsm-proto-codegen
+```
+
+```python
+from pgfsm.activitygateway.v1 import activity_gateway_pb2, activity_gateway_pb2_grpc
+from pgfsm.sidecargateway.v1 import sidecar_gateway_pb2, sidecar_gateway_pb2_grpc
+```
+
+Generated by `buf generate` from the `.proto` sources in
+[`packages/fsm-proto-codegen`](https://github.com/pgfsm/fsm/tree/main/packages/fsm-proto-codegen)
+— don't edit, regenerate. The same contracts are published for TypeScript
+(`@pgfsm/proto-codegen` on npm), Rust (`pgfsm-proto-codegen` on crates.io), and
+Go (`github.com/pgfsm/fsm/packages/fsm-proto-codegen/gen/go`), all at the same
+version.

pgfsm_proto_codegen-0.1.0/pgfsm/activitygateway/v1/activity_gateway_pb2.py

@@ -0,0 +1,45 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# NO CHECKED-IN PROTOBUF GENCODE
+# source: pgfsm/activitygateway/v1/activity_gateway.proto
+# Protobuf Python Version: 7.35.1
+"""Generated protocol buffer code."""
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import descriptor_pool as _descriptor_pool
+from google.protobuf import runtime_version as _runtime_version
+from google.protobuf import symbol_database as _symbol_database
+from google.protobuf.internal import builder as _builder
+_runtime_version.ValidateProtobufRuntimeVersion(
+    _runtime_version.Domain.PUBLIC,
+    7,
+    35,
+    1,
+    '',
+    'pgfsm/activitygateway/v1/activity_gateway.proto'
+)
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+
+
+DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n/pgfsm/activitygateway/v1/activity_gateway.proto\x12\x18pgfsm.activitygateway.v1\"\xc1\x03\n\rInvokeRequest\x12&\n\x0fparent_fsm_name\x18\x01 \x01(\tR\rparentFsmName\x12,\n\x12parent_fsm_version\x18\x02 \x01(\tR\x10parentFsmVersion\x12\x30\n\x14\x61sync_operation_type\x18\x03 \x01(\tR\x12\x61syncOperationType\x12\x30\n\x14\x61sync_operation_name\x18\x04 \x01(\tR\x12\x61syncOperationName\x12\x36\n\x17\x61sync_operation_version\x18\x05 \x01(\tR\x15\x61syncOperationVersion\x12\x38\n\x18\x61sync_operation_language\x18\x06 \x01(\tR\x16\x61syncOperationLanguage\x12\x1d\n\ninput_json\x18\x07 \x01(\tR\tinputJson\x12\x1f\n\x0binstance_id\x18\x08 \x01(\tR\ninstanceId\x12%\n\x0e\x63orrelation_id\x18\t \x01(\tR\rcorrelationId\x12\x1d\n\ntimeout_ms\x18\n \x01(\rR\ttimeoutMs\"\xa3\x01\n\x0eInvokeResponse\x12\x0e\n\x02ok\x18\x01 \x01(\x08R\x02ok\x12\x1f\n\x0boutput_json\x18\x02 \x01(\tR\noutputJson\x12\x1d\n\nerror_code\x18\x03 \x01(\tR\terrorCode\x12#\n\rerror_message\x18\x04 \x01(\tR\x0c\x65rrorMessage\x12\x1c\n\tretriable\x18\x05 \x01(\x08R\tretriable\"\x1d\n\x1bListRegisteredActorsRequest\"=\n\x1cListRegisteredActorsResponse\x12\x1d\n\nactor_keys\x18\x01 \x03(\tR\tactorKeys2\xfd\x01\n\x16\x41\x63tivityGatewayService\x12[\n\x06Invoke\x12\'.pgfsm.activitygateway.v1.InvokeRequest\x1a(.pgfsm.activitygateway.v1.InvokeResponse\x12\x85\x01\n\x14ListRegisteredActors\x12\x35.pgfsm.activitygateway.v1.ListRegisteredActorsRequest\x1a\x36.pgfsm.activitygateway.v1.ListRegisteredActorsResponseB\x81\x02\n\x1c\x63om.pgfsm.activitygateway.v1B\x14\x41\x63tivityGatewayProtoP\x01ZIgithub.com/pgfsm/fsm/packages/fsm-proto-codegen/gen/go/activitygateway/v1\xa2\x02\x03PAX\xaa\x02\x18Pgfsm.Activitygateway.V1\xca\x02\x18Pgfsm\\Activitygateway\\V1\xe2\x02$Pgfsm\\Activitygateway\\V1\\GPBMetadata\xea\x02\x1aPgfsm::Activitygateway::V1b\x06proto3')
+
+_globals = globals()
+_builder.BuildMessageAndEnumDescriptors(DESCRIPTOR, _globals)
+_builder.BuildTopDescriptorsAndMessages(DESCRIPTOR, 'pgfsm.activitygateway.v1.activity_gateway_pb2', _globals)
+if not _descriptor._USE_C_DESCRIPTORS:
+  _globals['DESCRIPTOR']._loaded_options = None
+  _globals['DESCRIPTOR']._serialized_options = b'\n\034com.pgfsm.activitygateway.v1B\024ActivityGatewayProtoP\001ZIgithub.com/pgfsm/fsm/packages/fsm-proto-codegen/gen/go/activitygateway/v1\242\002\003PAX\252\002\030Pgfsm.Activitygateway.V1\312\002\030Pgfsm\\Activitygateway\\V1\342\002$Pgfsm\\Activitygateway\\V1\\GPBMetadata\352\002\032Pgfsm::Activitygateway::V1'
+  _globals['_INVOKEREQUEST']._serialized_start=78
+  _globals['_INVOKEREQUEST']._serialized_end=527
+  _globals['_INVOKERESPONSE']._serialized_start=530
+  _globals['_INVOKERESPONSE']._serialized_end=693
+  _globals['_LISTREGISTEREDACTORSREQUEST']._serialized_start=695
+  _globals['_LISTREGISTEREDACTORSREQUEST']._serialized_end=724
+  _globals['_LISTREGISTEREDACTORSRESPONSE']._serialized_start=726
+  _globals['_LISTREGISTEREDACTORSRESPONSE']._serialized_end=787
+  _globals['_ACTIVITYGATEWAYSERVICE']._serialized_start=790
+  _globals['_ACTIVITYGATEWAYSERVICE']._serialized_end=1043
+# @@protoc_insertion_point(module_scope)

pgfsm_proto_codegen-0.1.0/pgfsm/activitygateway/v1/activity_gateway_pb2.pyi

@@ -0,0 +1,55 @@
+from google.protobuf.internal import containers as _containers
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from collections.abc import Iterable as _Iterable
+from typing import ClassVar as _ClassVar, Optional as _Optional
+
+DESCRIPTOR: _descriptor.FileDescriptor
+
+class InvokeRequest(_message.Message):
+    __slots__ = ("parent_fsm_name", "parent_fsm_version", "async_operation_type", "async_operation_name", "async_operation_version", "async_operation_language", "input_json", "instance_id", "correlation_id", "timeout_ms")
+    PARENT_FSM_NAME_FIELD_NUMBER: _ClassVar[int]
+    PARENT_FSM_VERSION_FIELD_NUMBER: _ClassVar[int]
+    ASYNC_OPERATION_TYPE_FIELD_NUMBER: _ClassVar[int]
+    ASYNC_OPERATION_NAME_FIELD_NUMBER: _ClassVar[int]
+    ASYNC_OPERATION_VERSION_FIELD_NUMBER: _ClassVar[int]
+    ASYNC_OPERATION_LANGUAGE_FIELD_NUMBER: _ClassVar[int]
+    INPUT_JSON_FIELD_NUMBER: _ClassVar[int]
+    INSTANCE_ID_FIELD_NUMBER: _ClassVar[int]
+    CORRELATION_ID_FIELD_NUMBER: _ClassVar[int]
+    TIMEOUT_MS_FIELD_NUMBER: _ClassVar[int]
+    parent_fsm_name: str
+    parent_fsm_version: str
+    async_operation_type: str
+    async_operation_name: str
+    async_operation_version: str
+    async_operation_language: str
+    input_json: str
+    instance_id: str
+    correlation_id: str
+    timeout_ms: int
+    def __init__(self, parent_fsm_name: _Optional[str] = ..., parent_fsm_version: _Optional[str] = ..., async_operation_type: _Optional[str] = ..., async_operation_name: _Optional[str] = ..., async_operation_version: _Optional[str] = ..., async_operation_language: _Optional[str] = ..., input_json: _Optional[str] = ..., instance_id: _Optional[str] = ..., correlation_id: _Optional[str] = ..., timeout_ms: _Optional[int] = ...) -> None: ...
+
+class InvokeResponse(_message.Message):
+    __slots__ = ("ok", "output_json", "error_code", "error_message", "retriable")
+    OK_FIELD_NUMBER: _ClassVar[int]
+    OUTPUT_JSON_FIELD_NUMBER: _ClassVar[int]
+    ERROR_CODE_FIELD_NUMBER: _ClassVar[int]
+    ERROR_MESSAGE_FIELD_NUMBER: _ClassVar[int]
+    RETRIABLE_FIELD_NUMBER: _ClassVar[int]
+    ok: bool
+    output_json: str
+    error_code: str
+    error_message: str
+    retriable: bool
+    def __init__(self, ok: _Optional[bool] = ..., output_json: _Optional[str] = ..., error_code: _Optional[str] = ..., error_message: _Optional[str] = ..., retriable: _Optional[bool] = ...) -> None: ...
+
+class ListRegisteredActorsRequest(_message.Message):
+    __slots__ = ()
+    def __init__(self) -> None: ...
+
+class ListRegisteredActorsResponse(_message.Message):
+    __slots__ = ("actor_keys",)
+    ACTOR_KEYS_FIELD_NUMBER: _ClassVar[int]
+    actor_keys: _containers.RepeatedScalarFieldContainer[str]
+    def __init__(self, actor_keys: _Optional[_Iterable[str]] = ...) -> None: ...

pgfsm_proto_codegen-0.1.0/pgfsm/activitygateway/v1/activity_gateway_pb2_grpc.py

@@ -0,0 +1,168 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+"""Client and server classes corresponding to protobuf-defined services."""
+import grpc
+
+from pgfsm.activitygateway.v1 import activity_gateway_pb2 as pgfsm_dot_activitygateway_dot_v1_dot_activity__gateway__pb2
+
+
+class ActivityGatewayServiceStub(object):
+    """Client-facing contract for the Activity Gateway. The orchestrator
+    (asyncOperationWorkerlet.ts) is the only intended client — it calls
+    Invoke() once per claimed PGMQ message for a compiled-language actor,
+    after doing its own poll/claim/archive against Postgres. The gateway
+    itself never touches the database.
+
+    Adapted from the polygot-lang-ipc-worker prototype's proto/ipc.proto:
+    the generic {function_name, payload_json} shape is replaced with the
+    activity contract from KB-001 §3.2, identifying the actor by its full
+    ActorPluginValidationResult identity (parent_fsm_name, parent_fsm_version,
+    async_operation_type, async_operation_name, async_operation_version,
+    async_operation_language) rather than a bare name/version pair — see
+    sidecar_gateway.proto's RegisteredActor. async_operation_language is part
+    of the identity (not just metadata) because the other five fields alone
+    aren't guaranteed unique across languages.
+
+    Originally shipped flat as activity-gateway.proto / package
+    pgfsm.activitygateway, exempted from several STANDARD buf lint rules as
+    an already-consumed contract (see #86/#87). That exemption's rationale
+    (gatewayServer.ts/gatewayClient.ts loading it by exact filename via
+    @grpc/proto-loader) no longer applies once real Connect-ES codegen
+    replaced that runtime reflection — moved to this standard layout in #102,
+    the same pass sidecar_gateway.proto (#100) already went through.
+    """
+
+    def __init__(self, channel):
+        """Constructor.
+
+        Args:
+            channel: A grpc.Channel.
+        """
+        self.Invoke = channel.unary_unary(
+                '/pgfsm.activitygateway.v1.ActivityGatewayService/Invoke',
+                request_serializer=pgfsm_dot_activitygateway_dot_v1_dot_activity__gateway__pb2.InvokeRequest.SerializeToString,
+                response_deserializer=pgfsm_dot_activitygateway_dot_v1_dot_activity__gateway__pb2.InvokeResponse.FromString,
+                )
+        self.ListRegisteredActors = channel.unary_unary(
+                '/pgfsm.activitygateway.v1.ActivityGatewayService/ListRegisteredActors',
+                request_serializer=pgfsm_dot_activitygateway_dot_v1_dot_activity__gateway__pb2.ListRegisteredActorsRequest.SerializeToString,
+                response_deserializer=pgfsm_dot_activitygateway_dot_v1_dot_activity__gateway__pb2.ListRegisteredActorsResponse.FromString,
+                )
+
+
+class ActivityGatewayServiceServicer(object):
+    """Client-facing contract for the Activity Gateway. The orchestrator
+    (asyncOperationWorkerlet.ts) is the only intended client — it calls
+    Invoke() once per claimed PGMQ message for a compiled-language actor,
+    after doing its own poll/claim/archive against Postgres. The gateway
+    itself never touches the database.
+
+    Adapted from the polygot-lang-ipc-worker prototype's proto/ipc.proto:
+    the generic {function_name, payload_json} shape is replaced with the
+    activity contract from KB-001 §3.2, identifying the actor by its full
+    ActorPluginValidationResult identity (parent_fsm_name, parent_fsm_version,
+    async_operation_type, async_operation_name, async_operation_version,
+    async_operation_language) rather than a bare name/version pair — see
+    sidecar_gateway.proto's RegisteredActor. async_operation_language is part
+    of the identity (not just metadata) because the other five fields alone
+    aren't guaranteed unique across languages.
+
+    Originally shipped flat as activity-gateway.proto / package
+    pgfsm.activitygateway, exempted from several STANDARD buf lint rules as
+    an already-consumed contract (see #86/#87). That exemption's rationale
+    (gatewayServer.ts/gatewayClient.ts loading it by exact filename via
+    @grpc/proto-loader) no longer applies once real Connect-ES codegen
+    replaced that runtime reflection — moved to this standard layout in #102,
+    the same pass sidecar_gateway.proto (#100) already went through.
+    """
+
+    def Invoke(self, request, context):
+        """Missing associated documentation comment in .proto file."""
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details('Method not implemented!')
+        raise NotImplementedError('Method not implemented!')
+
+    def ListRegisteredActors(self, request, context):
+        """Missing associated documentation comment in .proto file."""
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details('Method not implemented!')
+        raise NotImplementedError('Method not implemented!')
+
+
+def add_ActivityGatewayServiceServicer_to_server(servicer, server):
+    rpc_method_handlers = {
+            'Invoke': grpc.unary_unary_rpc_method_handler(
+                    servicer.Invoke,
+                    request_deserializer=pgfsm_dot_activitygateway_dot_v1_dot_activity__gateway__pb2.InvokeRequest.FromString,
+                    response_serializer=pgfsm_dot_activitygateway_dot_v1_dot_activity__gateway__pb2.InvokeResponse.SerializeToString,
+            ),
+            'ListRegisteredActors': grpc.unary_unary_rpc_method_handler(
+                    servicer.ListRegisteredActors,
+                    request_deserializer=pgfsm_dot_activitygateway_dot_v1_dot_activity__gateway__pb2.ListRegisteredActorsRequest.FromString,
+                    response_serializer=pgfsm_dot_activitygateway_dot_v1_dot_activity__gateway__pb2.ListRegisteredActorsResponse.SerializeToString,
+            ),
+    }
+    generic_handler = grpc.method_handlers_generic_handler(
+            'pgfsm.activitygateway.v1.ActivityGatewayService', rpc_method_handlers)
+    server.add_generic_rpc_handlers((generic_handler,))
+
+
+ # This class is part of an EXPERIMENTAL API.
+class ActivityGatewayService(object):
+    """Client-facing contract for the Activity Gateway. The orchestrator
+    (asyncOperationWorkerlet.ts) is the only intended client — it calls
+    Invoke() once per claimed PGMQ message for a compiled-language actor,
+    after doing its own poll/claim/archive against Postgres. The gateway
+    itself never touches the database.
+
+    Adapted from the polygot-lang-ipc-worker prototype's proto/ipc.proto:
+    the generic {function_name, payload_json} shape is replaced with the
+    activity contract from KB-001 §3.2, identifying the actor by its full
+    ActorPluginValidationResult identity (parent_fsm_name, parent_fsm_version,
+    async_operation_type, async_operation_name, async_operation_version,
+    async_operation_language) rather than a bare name/version pair — see
+    sidecar_gateway.proto's RegisteredActor. async_operation_language is part
+    of the identity (not just metadata) because the other five fields alone
+    aren't guaranteed unique across languages.
+
+    Originally shipped flat as activity-gateway.proto / package
+    pgfsm.activitygateway, exempted from several STANDARD buf lint rules as
+    an already-consumed contract (see #86/#87). That exemption's rationale
+    (gatewayServer.ts/gatewayClient.ts loading it by exact filename via
+    @grpc/proto-loader) no longer applies once real Connect-ES codegen
+    replaced that runtime reflection — moved to this standard layout in #102,
+    the same pass sidecar_gateway.proto (#100) already went through.
+    """
+
+    @staticmethod
+    def Invoke(request,
+            target,
+            options=(),
+            channel_credentials=None,
+            call_credentials=None,
+            insecure=False,
+            compression=None,
+            wait_for_ready=None,
+            timeout=None,
+            metadata=None):
+        return grpc.experimental.unary_unary(request, target, '/pgfsm.activitygateway.v1.ActivityGatewayService/Invoke',
+            pgfsm_dot_activitygateway_dot_v1_dot_activity__gateway__pb2.InvokeRequest.SerializeToString,
+            pgfsm_dot_activitygateway_dot_v1_dot_activity__gateway__pb2.InvokeResponse.FromString,
+            options, channel_credentials,
+            insecure, call_credentials, compression, wait_for_ready, timeout, metadata)
+
+    @staticmethod
+    def ListRegisteredActors(request,
+            target,
+            options=(),
+            channel_credentials=None,
+            call_credentials=None,
+            insecure=False,
+            compression=None,
+            wait_for_ready=None,
+            timeout=None,
+            metadata=None):
+        return grpc.experimental.unary_unary(request, target, '/pgfsm.activitygateway.v1.ActivityGatewayService/ListRegisteredActors',
+            pgfsm_dot_activitygateway_dot_v1_dot_activity__gateway__pb2.ListRegisteredActorsRequest.SerializeToString,
+            pgfsm_dot_activitygateway_dot_v1_dot_activity__gateway__pb2.ListRegisteredActorsResponse.FromString,
+            options, channel_credentials,
+            insecure, call_credentials, compression, wait_for_ready, timeout, metadata)

pgfsm_proto_codegen-0.1.0/pgfsm/sidecargateway/v1/sidecar_gateway_pb2.py

@@ -0,0 +1,61 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# NO CHECKED-IN PROTOBUF GENCODE
+# source: pgfsm/sidecargateway/v1/sidecar_gateway.proto
+# Protobuf Python Version: 7.35.1
+"""Generated protocol buffer code."""
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import descriptor_pool as _descriptor_pool
+from google.protobuf import runtime_version as _runtime_version
+from google.protobuf import symbol_database as _symbol_database
+from google.protobuf.internal import builder as _builder
+_runtime_version.ValidateProtobufRuntimeVersion(
+    _runtime_version.Domain.PUBLIC,
+    7,
+    35,
+    1,
+    '',
+    'pgfsm/sidecargateway/v1/sidecar_gateway.proto'
+)
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+
+
+DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n-pgfsm/sidecargateway/v1/sidecar_gateway.proto\x12\x17pgfsm.sidecargateway.v1\"\xfe\x02\n\x0fRegisteredActor\x12&\n\x0fparent_fsm_name\x18\x01 \x01(\tR\rparentFsmName\x12,\n\x12parent_fsm_version\x18\x02 \x01(\tR\x10parentFsmVersion\x12\x30\n\x14\x61sync_operation_type\x18\x03 \x01(\tR\x12\x61syncOperationType\x12\x30\n\x14\x61sync_operation_name\x18\x04 \x01(\tR\x12\x61syncOperationName\x12\x36\n\x17\x61sync_operation_version\x18\x05 \x01(\tR\x15\x61syncOperationVersion\x12\x38\n\x18\x61sync_operation_language\x18\x06 \x01(\tR\x16\x61syncOperationLanguage\x12\x1d\n\ntimeout_ms\x18\x07 \x01(\rR\ttimeoutMs\x12 \n\x0b\x64\x65scription\x18\x08 \x01(\tR\x0b\x64\x65scription\"\xb0\x01\n\x08Register\x12\x1b\n\tworker_id\x18\x01 \x01(\tR\x08workerId\x12\x1a\n\x08language\x18\x02 \x01(\tR\x08language\x12)\n\x10protocol_version\x18\x03 \x01(\tR\x0fprotocolVersion\x12@\n\x06\x61\x63tors\x18\x04 \x03(\x0b\x32(.pgfsm.sidecargateway.v1.RegisteredActorR\x06\x61\x63tors\"\xb9\x01\n\x0bRegisterAck\x12\x1a\n\x08\x61\x63\x63\x65pted\x18\x01 \x01(\x08R\x08\x61\x63\x63\x65pted\x12\x38\n\x18gateway_protocol_version\x18\x02 \x01(\tR\x16gatewayProtocolVersion\x12+\n\x11registered_actors\x18\x03 \x03(\tR\x10registeredActors\x12\'\n\x0frejected_actors\x18\x04 \x03(\tR\x0erejectedActors\"(\n\tHeartbeat\x12\x1b\n\tworker_id\x18\x01 \x01(\tR\x08workerId\"\x81\x04\n\x06Invoke\x12\x1b\n\tinvoke_id\x18\x01 \x01(\tR\x08invokeId\x12&\n\x0fparent_fsm_name\x18\x02 \x01(\tR\rparentFsmName\x12,\n\x12parent_fsm_version\x18\x03 \x01(\tR\x10parentFsmVersion\x12\x30\n\x14\x61sync_operation_type\x18\x04 \x01(\tR\x12\x61syncOperationType\x12\x30\n\x14\x61sync_operation_name\x18\x05 \x01(\tR\x12\x61syncOperationName\x12\x36\n\x17\x61sync_operation_version\x18\x06 \x01(\tR\x15\x61syncOperationVersion\x12\x38\n\x18\x61sync_operation_language\x18\x07 \x01(\tR\x16\x61syncOperationLanguage\x12\x1d\n\ninput_json\x18\x08 \x01(\tR\tinputJson\x12\x1f\n\x0binstance_id\x18\t \x01(\tR\ninstanceId\x12%\n\x0e\x63orrelation_id\x18\n \x01(\tR\rcorrelationId\x12\x1d\n\ntimeout_ms\x18\x0b \x01(\rR\ttimeoutMs\x12(\n\x10\x64\x65\x61\x64line_unix_ms\x18\x0c \x01(\x03R\x0e\x64\x65\x61\x64lineUnixMs\"m\n\x0cInvokeResult\x12\x1b\n\tinvoke_id\x18\x01 \x01(\tR\x08invokeId\x12\x1f\n\x0boutput_json\x18\x02 \x01(\tR\noutputJson\x12\x1f\n\x0b\x64uration_ms\x18\x03 \x01(\rR\ndurationMs\"_\n\x11InvokeErrorDetail\x12\x12\n\x04\x63ode\x18\x01 \x01(\tR\x04\x63ode\x12\x18\n\x07message\x18\x02 \x01(\tR\x07message\x12\x1c\n\tretriable\x18\x03 \x01(\x08R\tretriable\"\x8d\x01\n\x0bInvokeError\x12\x1b\n\tinvoke_id\x18\x01 \x01(\tR\x08invokeId\x12@\n\x05\x65rror\x18\x02 \x01(\x0b\x32*.pgfsm.sidecargateway.v1.InvokeErrorDetailR\x05\x65rror\x12\x1f\n\x0b\x64uration_ms\x18\x03 \x01(\rR\ndurationMs\"%\n\x06\x43\x61ncel\x12\x1b\n\tinvoke_id\x18\x01 \x01(\tR\x08invokeId\")\n\nUnregister\x12\x1b\n\tworker_id\x18\x01 \x01(\tR\x08workerId\"\x80\x03\n\x0eSessionRequest\x12?\n\x08register\x18\x01 \x01(\x0b\x32!.pgfsm.sidecargateway.v1.RegisterH\x00R\x08register\x12\x42\n\theartbeat\x18\x02 \x01(\x0b\x32\".pgfsm.sidecargateway.v1.HeartbeatH\x00R\theartbeat\x12L\n\rinvoke_result\x18\x03 \x01(\x0b\x32%.pgfsm.sidecargateway.v1.InvokeResultH\x00R\x0cinvokeResult\x12I\n\x0cinvoke_error\x18\x04 \x01(\x0b\x32$.pgfsm.sidecargateway.v1.InvokeErrorH\x00R\x0binvokeError\x12\x45\n\nunregister\x18\x05 \x01(\x0b\x32#.pgfsm.sidecargateway.v1.UnregisterH\x00R\nunregisterB\t\n\x07payload\"\xdd\x01\n\x0fSessionResponse\x12I\n\x0cregister_ack\x18\x01 \x01(\x0b\x32$.pgfsm.sidecargateway.v1.RegisterAckH\x00R\x0bregisterAck\x12\x39\n\x06invoke\x18\x02 \x01(\x0b\x32\x1f.pgfsm.sidecargateway.v1.InvokeH\x00R\x06invoke\x12\x39\n\x06\x63\x61ncel\x18\x03 \x01(\x0b\x32\x1f.pgfsm.sidecargateway.v1.CancelH\x00R\x06\x63\x61ncelB\t\n\x07payload2y\n\x15SidecarGatewayService\x12`\n\x07Session\x12\'.pgfsm.sidecargateway.v1.SessionRequest\x1a(.pgfsm.sidecargateway.v1.SessionResponse(\x01\x30\x01\x42\xfa\x01\n\x1b\x63om.pgfsm.sidecargateway.v1B\x13SidecarGatewayProtoP\x01ZHgithub.com/pgfsm/fsm/packages/fsm-proto-codegen/gen/go/sidecargateway/v1\xa2\x02\x03PSX\xaa\x02\x17Pgfsm.Sidecargateway.V1\xca\x02\x17Pgfsm\\Sidecargateway\\V1\xe2\x02#Pgfsm\\Sidecargateway\\V1\\GPBMetadata\xea\x02\x19Pgfsm::Sidecargateway::V1b\x06proto3')
+
+_globals = globals()
+_builder.BuildMessageAndEnumDescriptors(DESCRIPTOR, _globals)
+_builder.BuildTopDescriptorsAndMessages(DESCRIPTOR, 'pgfsm.sidecargateway.v1.sidecar_gateway_pb2', _globals)
+if not _descriptor._USE_C_DESCRIPTORS:
+  _globals['DESCRIPTOR']._loaded_options = None
+  _globals['DESCRIPTOR']._serialized_options = b'\n\033com.pgfsm.sidecargateway.v1B\023SidecarGatewayProtoP\001ZHgithub.com/pgfsm/fsm/packages/fsm-proto-codegen/gen/go/sidecargateway/v1\242\002\003PSX\252\002\027Pgfsm.Sidecargateway.V1\312\002\027Pgfsm\\Sidecargateway\\V1\342\002#Pgfsm\\Sidecargateway\\V1\\GPBMetadata\352\002\031Pgfsm::Sidecargateway::V1'
+  _globals['_REGISTEREDACTOR']._serialized_start=75
+  _globals['_REGISTEREDACTOR']._serialized_end=457
+  _globals['_REGISTER']._serialized_start=460
+  _globals['_REGISTER']._serialized_end=636
+  _globals['_REGISTERACK']._serialized_start=639
+  _globals['_REGISTERACK']._serialized_end=824
+  _globals['_HEARTBEAT']._serialized_start=826
+  _globals['_HEARTBEAT']._serialized_end=866
+  _globals['_INVOKE']._serialized_start=869
+  _globals['_INVOKE']._serialized_end=1382
+  _globals['_INVOKERESULT']._serialized_start=1384
+  _globals['_INVOKERESULT']._serialized_end=1493
+  _globals['_INVOKEERRORDETAIL']._serialized_start=1495
+  _globals['_INVOKEERRORDETAIL']._serialized_end=1590
+  _globals['_INVOKEERROR']._serialized_start=1593
+  _globals['_INVOKEERROR']._serialized_end=1734
+  _globals['_CANCEL']._serialized_start=1736
+  _globals['_CANCEL']._serialized_end=1773
+  _globals['_UNREGISTER']._serialized_start=1775
+  _globals['_UNREGISTER']._serialized_end=1816
+  _globals['_SESSIONREQUEST']._serialized_start=1819
+  _globals['_SESSIONREQUEST']._serialized_end=2203
+  _globals['_SESSIONRESPONSE']._serialized_start=2206
+  _globals['_SESSIONRESPONSE']._serialized_end=2427
+  _globals['_SIDECARGATEWAYSERVICE']._serialized_start=2429
+  _globals['_SIDECARGATEWAYSERVICE']._serialized_end=2550
+# @@protoc_insertion_point(module_scope)

pgfsm_proto_codegen-0.1.0/pgfsm/sidecargateway/v1/sidecar_gateway_pb2.pyi

@@ -0,0 +1,151 @@
+from google.protobuf.internal import containers as _containers
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from collections.abc import Iterable as _Iterable, Mapping as _Mapping
+from typing import ClassVar as _ClassVar, Optional as _Optional, Union as _Union
+
+DESCRIPTOR: _descriptor.FileDescriptor
+
+class RegisteredActor(_message.Message):
+    __slots__ = ("parent_fsm_name", "parent_fsm_version", "async_operation_type", "async_operation_name", "async_operation_version", "async_operation_language", "timeout_ms", "description")
+    PARENT_FSM_NAME_FIELD_NUMBER: _ClassVar[int]
+    PARENT_FSM_VERSION_FIELD_NUMBER: _ClassVar[int]
+    ASYNC_OPERATION_TYPE_FIELD_NUMBER: _ClassVar[int]
+    ASYNC_OPERATION_NAME_FIELD_NUMBER: _ClassVar[int]
+    ASYNC_OPERATION_VERSION_FIELD_NUMBER: _ClassVar[int]
+    ASYNC_OPERATION_LANGUAGE_FIELD_NUMBER: _ClassVar[int]
+    TIMEOUT_MS_FIELD_NUMBER: _ClassVar[int]
+    DESCRIPTION_FIELD_NUMBER: _ClassVar[int]
+    parent_fsm_name: str
+    parent_fsm_version: str
+    async_operation_type: str
+    async_operation_name: str
+    async_operation_version: str
+    async_operation_language: str
+    timeout_ms: int
+    description: str
+    def __init__(self, parent_fsm_name: _Optional[str] = ..., parent_fsm_version: _Optional[str] = ..., async_operation_type: _Optional[str] = ..., async_operation_name: _Optional[str] = ..., async_operation_version: _Optional[str] = ..., async_operation_language: _Optional[str] = ..., timeout_ms: _Optional[int] = ..., description: _Optional[str] = ...) -> None: ...
+
+class Register(_message.Message):
+    __slots__ = ("worker_id", "language", "protocol_version", "actors")
+    WORKER_ID_FIELD_NUMBER: _ClassVar[int]
+    LANGUAGE_FIELD_NUMBER: _ClassVar[int]
+    PROTOCOL_VERSION_FIELD_NUMBER: _ClassVar[int]
+    ACTORS_FIELD_NUMBER: _ClassVar[int]
+    worker_id: str
+    language: str
+    protocol_version: str
+    actors: _containers.RepeatedCompositeFieldContainer[RegisteredActor]
+    def __init__(self, worker_id: _Optional[str] = ..., language: _Optional[str] = ..., protocol_version: _Optional[str] = ..., actors: _Optional[_Iterable[_Union[RegisteredActor, _Mapping]]] = ...) -> None: ...
+
+class RegisterAck(_message.Message):
+    __slots__ = ("accepted", "gateway_protocol_version", "registered_actors", "rejected_actors")
+    ACCEPTED_FIELD_NUMBER: _ClassVar[int]
+    GATEWAY_PROTOCOL_VERSION_FIELD_NUMBER: _ClassVar[int]
+    REGISTERED_ACTORS_FIELD_NUMBER: _ClassVar[int]
+    REJECTED_ACTORS_FIELD_NUMBER: _ClassVar[int]
+    accepted: bool
+    gateway_protocol_version: str
+    registered_actors: _containers.RepeatedScalarFieldContainer[str]
+    rejected_actors: _containers.RepeatedScalarFieldContainer[str]
+    def __init__(self, accepted: _Optional[bool] = ..., gateway_protocol_version: _Optional[str] = ..., registered_actors: _Optional[_Iterable[str]] = ..., rejected_actors: _Optional[_Iterable[str]] = ...) -> None: ...
+
+class Heartbeat(_message.Message):
+    __slots__ = ("worker_id",)
+    WORKER_ID_FIELD_NUMBER: _ClassVar[int]
+    worker_id: str
+    def __init__(self, worker_id: _Optional[str] = ...) -> None: ...
+
+class Invoke(_message.Message):
+    __slots__ = ("invoke_id", "parent_fsm_name", "parent_fsm_version", "async_operation_type", "async_operation_name", "async_operation_version", "async_operation_language", "input_json", "instance_id", "correlation_id", "timeout_ms", "deadline_unix_ms")
+    INVOKE_ID_FIELD_NUMBER: _ClassVar[int]
+    PARENT_FSM_NAME_FIELD_NUMBER: _ClassVar[int]
+    PARENT_FSM_VERSION_FIELD_NUMBER: _ClassVar[int]
+    ASYNC_OPERATION_TYPE_FIELD_NUMBER: _ClassVar[int]
+    ASYNC_OPERATION_NAME_FIELD_NUMBER: _ClassVar[int]
+    ASYNC_OPERATION_VERSION_FIELD_NUMBER: _ClassVar[int]
+    ASYNC_OPERATION_LANGUAGE_FIELD_NUMBER: _ClassVar[int]
+    INPUT_JSON_FIELD_NUMBER: _ClassVar[int]
+    INSTANCE_ID_FIELD_NUMBER: _ClassVar[int]
+    CORRELATION_ID_FIELD_NUMBER: _ClassVar[int]
+    TIMEOUT_MS_FIELD_NUMBER: _ClassVar[int]
+    DEADLINE_UNIX_MS_FIELD_NUMBER: _ClassVar[int]
+    invoke_id: str
+    parent_fsm_name: str
+    parent_fsm_version: str
+    async_operation_type: str
+    async_operation_name: str
+    async_operation_version: str
+    async_operation_language: str
+    input_json: str
+    instance_id: str
+    correlation_id: str
+    timeout_ms: int
+    deadline_unix_ms: int
+    def __init__(self, invoke_id: _Optional[str] = ..., parent_fsm_name: _Optional[str] = ..., parent_fsm_version: _Optional[str] = ..., async_operation_type: _Optional[str] = ..., async_operation_name: _Optional[str] = ..., async_operation_version: _Optional[str] = ..., async_operation_language: _Optional[str] = ..., input_json: _Optional[str] = ..., instance_id: _Optional[str] = ..., correlation_id: _Optional[str] = ..., timeout_ms: _Optional[int] = ..., deadline_unix_ms: _Optional[int] = ...) -> None: ...
+
+class InvokeResult(_message.Message):
+    __slots__ = ("invoke_id", "output_json", "duration_ms")
+    INVOKE_ID_FIELD_NUMBER: _ClassVar[int]
+    OUTPUT_JSON_FIELD_NUMBER: _ClassVar[int]
+    DURATION_MS_FIELD_NUMBER: _ClassVar[int]
+    invoke_id: str
+    output_json: str
+    duration_ms: int
+    def __init__(self, invoke_id: _Optional[str] = ..., output_json: _Optional[str] = ..., duration_ms: _Optional[int] = ...) -> None: ...
+
+class InvokeErrorDetail(_message.Message):
+    __slots__ = ("code", "message", "retriable")
+    CODE_FIELD_NUMBER: _ClassVar[int]
+    MESSAGE_FIELD_NUMBER: _ClassVar[int]
+    RETRIABLE_FIELD_NUMBER: _ClassVar[int]
+    code: str
+    message: str
+    retriable: bool
+    def __init__(self, code: _Optional[str] = ..., message: _Optional[str] = ..., retriable: _Optional[bool] = ...) -> None: ...
+
+class InvokeError(_message.Message):
+    __slots__ = ("invoke_id", "error", "duration_ms")
+    INVOKE_ID_FIELD_NUMBER: _ClassVar[int]
+    ERROR_FIELD_NUMBER: _ClassVar[int]
+    DURATION_MS_FIELD_NUMBER: _ClassVar[int]
+    invoke_id: str
+    error: InvokeErrorDetail
+    duration_ms: int
+    def __init__(self, invoke_id: _Optional[str] = ..., error: _Optional[_Union[InvokeErrorDetail, _Mapping]] = ..., duration_ms: _Optional[int] = ...) -> None: ...
+
+class Cancel(_message.Message):
+    __slots__ = ("invoke_id",)
+    INVOKE_ID_FIELD_NUMBER: _ClassVar[int]
+    invoke_id: str
+    def __init__(self, invoke_id: _Optional[str] = ...) -> None: ...
+
+class Unregister(_message.Message):
+    __slots__ = ("worker_id",)
+    WORKER_ID_FIELD_NUMBER: _ClassVar[int]
+    worker_id: str
+    def __init__(self, worker_id: _Optional[str] = ...) -> None: ...
+
+class SessionRequest(_message.Message):
+    __slots__ = ("register", "heartbeat", "invoke_result", "invoke_error", "unregister")
+    REGISTER_FIELD_NUMBER: _ClassVar[int]
+    HEARTBEAT_FIELD_NUMBER: _ClassVar[int]
+    INVOKE_RESULT_FIELD_NUMBER: _ClassVar[int]
+    INVOKE_ERROR_FIELD_NUMBER: _ClassVar[int]
+    UNREGISTER_FIELD_NUMBER: _ClassVar[int]
+    register: Register
+    heartbeat: Heartbeat
+    invoke_result: InvokeResult
+    invoke_error: InvokeError
+    unregister: Unregister
+    def __init__(self, register: _Optional[_Union[Register, _Mapping]] = ..., heartbeat: _Optional[_Union[Heartbeat, _Mapping]] = ..., invoke_result: _Optional[_Union[InvokeResult, _Mapping]] = ..., invoke_error: _Optional[_Union[InvokeError, _Mapping]] = ..., unregister: _Optional[_Union[Unregister, _Mapping]] = ...) -> None: ...
+
+class SessionResponse(_message.Message):
+    __slots__ = ("register_ack", "invoke", "cancel")
+    REGISTER_ACK_FIELD_NUMBER: _ClassVar[int]
+    INVOKE_FIELD_NUMBER: _ClassVar[int]
+    CANCEL_FIELD_NUMBER: _ClassVar[int]
+    register_ack: RegisterAck
+    invoke: Invoke
+    cancel: Cancel
+    def __init__(self, register_ack: _Optional[_Union[RegisterAck, _Mapping]] = ..., invoke: _Optional[_Union[Invoke, _Mapping]] = ..., cancel: _Optional[_Union[Cancel, _Mapping]] = ...) -> None: ...

pgfsm_proto_codegen-0.1.0/pgfsm/sidecargateway/v1/sidecar_gateway_pb2_grpc.py

@@ -0,0 +1,150 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+"""Client and server classes corresponding to protobuf-defined services."""
+import grpc
+
+from pgfsm.sidecargateway.v1 import sidecar_gateway_pb2 as pgfsm_dot_sidecargateway_dot_v1_dot_sidecar__gateway__pb2
+
+
+class SidecarGatewayServiceStub(object):
+    """Worker-facing contract for the Activity Gateway's sidecar leg — the
+    register/invoke/heartbeat channel between the gateway and each language's
+    worker SDK, previously a hand-rolled length-prefixed-JSON envelope
+    (sidecar/protocol.ts) hand-ported per language by fsm-compiler-ts's
+    worker-sdk-protocol.eta templates with no schema to check them against
+    (#88). This proto is the single source of truth those copies drove from;
+    see #100 for the migration.
+
+    Unlike activity_gateway.proto (the client-facing leg, #86/#87 — a client
+    calls Invoke() and gets one response back), this leg is not unary: the
+    worker initiates the connection and pushes Register once, then
+    Heartbeat/InvokeResult/InvokeError as needed, while the gateway pushes
+    Invoke/Cancel back unsolicited on the same stream — a worker registers
+    once and serves invocations indefinitely without the gateway needing to
+    reach it externally. A single bidi-streaming RPC preserves that shape.
+
+    Follows FILE_LOWER_SNAKE_CASE, PACKAGE_DIRECTORY_MATCH,
+    PACKAGE_VERSION_SUFFIX, SERVICE_SUFFIX, and RPC_REQUEST_STANDARD_NAME from
+    the start — activity_gateway.proto only picked up the same layout later,
+    in #102, once it stopped being loaded by exact filename at runtime.
+
+    Named `Session`, not the more obvious `Connect`: tonic-build always emits
+    an inherent `SidecarGatewayServiceClient::<Channel>::connect(dst)`
+    convenience constructor on the generated client, regardless of RPC names.
+    An RPC also named `Connect` collides with it on the same concretized type
+    (`error[E0592]: duplicate definitions with name 'connect'`) and simply
+    fails to compile — confirmed by building the generated Rust client in
+    isolation before picking this name.
+    """
+
+    def __init__(self, channel):
+        """Constructor.
+
+        Args:
+            channel: A grpc.Channel.
+        """
+        self.Session = channel.stream_stream(
+                '/pgfsm.sidecargateway.v1.SidecarGatewayService/Session',
+                request_serializer=pgfsm_dot_sidecargateway_dot_v1_dot_sidecar__gateway__pb2.SessionRequest.SerializeToString,
+                response_deserializer=pgfsm_dot_sidecargateway_dot_v1_dot_sidecar__gateway__pb2.SessionResponse.FromString,
+                )
+
+
+class SidecarGatewayServiceServicer(object):
+    """Worker-facing contract for the Activity Gateway's sidecar leg — the
+    register/invoke/heartbeat channel between the gateway and each language's
+    worker SDK, previously a hand-rolled length-prefixed-JSON envelope
+    (sidecar/protocol.ts) hand-ported per language by fsm-compiler-ts's
+    worker-sdk-protocol.eta templates with no schema to check them against
+    (#88). This proto is the single source of truth those copies drove from;
+    see #100 for the migration.
+
+    Unlike activity_gateway.proto (the client-facing leg, #86/#87 — a client
+    calls Invoke() and gets one response back), this leg is not unary: the
+    worker initiates the connection and pushes Register once, then
+    Heartbeat/InvokeResult/InvokeError as needed, while the gateway pushes
+    Invoke/Cancel back unsolicited on the same stream — a worker registers
+    once and serves invocations indefinitely without the gateway needing to
+    reach it externally. A single bidi-streaming RPC preserves that shape.
+
+    Follows FILE_LOWER_SNAKE_CASE, PACKAGE_DIRECTORY_MATCH,
+    PACKAGE_VERSION_SUFFIX, SERVICE_SUFFIX, and RPC_REQUEST_STANDARD_NAME from
+    the start — activity_gateway.proto only picked up the same layout later,
+    in #102, once it stopped being loaded by exact filename at runtime.
+
+    Named `Session`, not the more obvious `Connect`: tonic-build always emits
+    an inherent `SidecarGatewayServiceClient::<Channel>::connect(dst)`
+    convenience constructor on the generated client, regardless of RPC names.
+    An RPC also named `Connect` collides with it on the same concretized type
+    (`error[E0592]: duplicate definitions with name 'connect'`) and simply
+    fails to compile — confirmed by building the generated Rust client in
+    isolation before picking this name.
+    """
+
+    def Session(self, request_iterator, context):
+        """Missing associated documentation comment in .proto file."""
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details('Method not implemented!')
+        raise NotImplementedError('Method not implemented!')
+
+
+def add_SidecarGatewayServiceServicer_to_server(servicer, server):
+    rpc_method_handlers = {
+            'Session': grpc.stream_stream_rpc_method_handler(
+                    servicer.Session,
+                    request_deserializer=pgfsm_dot_sidecargateway_dot_v1_dot_sidecar__gateway__pb2.SessionRequest.FromString,
+                    response_serializer=pgfsm_dot_sidecargateway_dot_v1_dot_sidecar__gateway__pb2.SessionResponse.SerializeToString,
+            ),
+    }
+    generic_handler = grpc.method_handlers_generic_handler(
+            'pgfsm.sidecargateway.v1.SidecarGatewayService', rpc_method_handlers)
+    server.add_generic_rpc_handlers((generic_handler,))
+
+
+ # This class is part of an EXPERIMENTAL API.
+class SidecarGatewayService(object):
+    """Worker-facing contract for the Activity Gateway's sidecar leg — the
+    register/invoke/heartbeat channel between the gateway and each language's
+    worker SDK, previously a hand-rolled length-prefixed-JSON envelope
+    (sidecar/protocol.ts) hand-ported per language by fsm-compiler-ts's
+    worker-sdk-protocol.eta templates with no schema to check them against
+    (#88). This proto is the single source of truth those copies drove from;
+    see #100 for the migration.
+
+    Unlike activity_gateway.proto (the client-facing leg, #86/#87 — a client
+    calls Invoke() and gets one response back), this leg is not unary: the
+    worker initiates the connection and pushes Register once, then
+    Heartbeat/InvokeResult/InvokeError as needed, while the gateway pushes
+    Invoke/Cancel back unsolicited on the same stream — a worker registers
+    once and serves invocations indefinitely without the gateway needing to
+    reach it externally. A single bidi-streaming RPC preserves that shape.
+
+    Follows FILE_LOWER_SNAKE_CASE, PACKAGE_DIRECTORY_MATCH,
+    PACKAGE_VERSION_SUFFIX, SERVICE_SUFFIX, and RPC_REQUEST_STANDARD_NAME from
+    the start — activity_gateway.proto only picked up the same layout later,
+    in #102, once it stopped being loaded by exact filename at runtime.
+
+    Named `Session`, not the more obvious `Connect`: tonic-build always emits
+    an inherent `SidecarGatewayServiceClient::<Channel>::connect(dst)`
+    convenience constructor on the generated client, regardless of RPC names.
+    An RPC also named `Connect` collides with it on the same concretized type
+    (`error[E0592]: duplicate definitions with name 'connect'`) and simply
+    fails to compile — confirmed by building the generated Rust client in
+    isolation before picking this name.
+    """
+
+    @staticmethod
+    def Session(request_iterator,
+            target,
+            options=(),
+            channel_credentials=None,
+            call_credentials=None,
+            insecure=False,
+            compression=None,
+            wait_for_ready=None,
+            timeout=None,
+            metadata=None):
+        return grpc.experimental.stream_stream(request_iterator, target, '/pgfsm.sidecargateway.v1.SidecarGatewayService/Session',
+            pgfsm_dot_sidecargateway_dot_v1_dot_sidecar__gateway__pb2.SessionRequest.SerializeToString,
+            pgfsm_dot_sidecargateway_dot_v1_dot_sidecar__gateway__pb2.SessionResponse.FromString,
+            options, channel_credentials,
+            insecure, call_credentials, compression, wait_for_ready, timeout, metadata)

pgfsm_proto_codegen-0.1.0/pgfsm_proto_codegen.egg-info/PKG-INFO

@@ -0,0 +1,33 @@
+Metadata-Version: 2.4
+Name: pgfsm-proto-codegen
+Version: 0.1.0
+Summary: Generated protobuf + gRPC stubs for the pgfsm Activity Gateway and Sidecar Gateway contracts.
+License-Expression: Apache-2.0
+Project-URL: Repository, https://github.com/pgfsm/fsm
+Project-URL: Source, https://github.com/pgfsm/fsm/tree/main/packages/fsm-proto-codegen
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: grpcio<2,>=1.60
+Requires-Dist: protobuf<8,>=7.35.1
+
+# pgfsm-proto-codegen
+
+Generated protobuf + gRPC stubs for [pgfsm](https://github.com/pgfsm/fsm)'s
+Activity Gateway (`pgfsm.activitygateway.v1`) and Sidecar Gateway
+(`pgfsm.sidecargateway.v1`) contracts.
+
+```sh
+pip install pgfsm-proto-codegen
+```
+
+```python
+from pgfsm.activitygateway.v1 import activity_gateway_pb2, activity_gateway_pb2_grpc
+from pgfsm.sidecargateway.v1 import sidecar_gateway_pb2, sidecar_gateway_pb2_grpc
+```
+
+Generated by `buf generate` from the `.proto` sources in
+[`packages/fsm-proto-codegen`](https://github.com/pgfsm/fsm/tree/main/packages/fsm-proto-codegen)
+— don't edit, regenerate. The same contracts are published for TypeScript
+(`@pgfsm/proto-codegen` on npm), Rust (`pgfsm-proto-codegen` on crates.io), and
+Go (`github.com/pgfsm/fsm/packages/fsm-proto-codegen/gen/go`), all at the same
+version.

pgfsm_proto_codegen-0.1.0/pgfsm_proto_codegen.egg-info/SOURCES.txt

@@ -0,0 +1,13 @@
+README.md
+pyproject.toml
+pgfsm/activitygateway/v1/activity_gateway_pb2.py
+pgfsm/activitygateway/v1/activity_gateway_pb2.pyi
+pgfsm/activitygateway/v1/activity_gateway_pb2_grpc.py
+pgfsm/sidecargateway/v1/sidecar_gateway_pb2.py
+pgfsm/sidecargateway/v1/sidecar_gateway_pb2.pyi
+pgfsm/sidecargateway/v1/sidecar_gateway_pb2_grpc.py
+pgfsm_proto_codegen.egg-info/PKG-INFO
+pgfsm_proto_codegen.egg-info/SOURCES.txt
+pgfsm_proto_codegen.egg-info/dependency_links.txt
+pgfsm_proto_codegen.egg-info/requires.txt
+pgfsm_proto_codegen.egg-info/top_level.txt

pgfsm_proto_codegen-0.1.0/pgfsm_proto_codegen.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

pgfsm_proto_codegen-0.1.0/pgfsm_proto_codegen.egg-info/requires.txt

@@ -0,0 +1,2 @@
+grpcio<2,>=1.60
+protobuf<8,>=7.35.1

pgfsm_proto_codegen-0.1.0/pgfsm_proto_codegen.egg-info/top_level.txt

@@ -0,0 +1 @@
+pgfsm

pgfsm_proto_codegen-0.1.0/pyproject.toml

@@ -0,0 +1,35 @@
+# Hand-written (not generated) — see this package's README. Gives the
+# buf-generated pgfsm.{activitygateway,sidecargateway}.v1 namespace packages
+# a real installable identity, so consumers `pip install -e` this directory
+# instead of a worker-sdk's sdk.py doing a runtime sys.path.insert with a
+# relative path computed by counting `../` back to this directory — see
+# #106. Published to PyPI as pgfsm-proto-codegen by
+# .github/workflows/proto-publish.yml; `version` must match the other three
+# languages' manifests (see the package README's "Publishing").
+[project]
+name = "pgfsm-proto-codegen"
+version = "0.1.0"
+description = "Generated protobuf + gRPC stubs for the pgfsm Activity Gateway and Sidecar Gateway contracts."
+readme = "README.md"
+license = "Apache-2.0"
+requires-python = ">=3.9"
+dependencies = [
+  "grpcio>=1.60,<2",
+  # Lower bound must be the gencode version in the generated _pb2.py headers
+  # ("# Protobuf Python Version: X.Y.Z"): each module calls
+  # ValidateProtobufRuntimeVersion at import time and raises VersionError on
+  # an older runtime. The proto-codegen workflow checks the two agree.
+  "protobuf>=7.35.1,<8",
+]
+
+[project.urls]
+Repository = "https://github.com/pgfsm/fsm"
+Source = "https://github.com/pgfsm/fsm/tree/main/packages/fsm-proto-codegen"
+
+[tool.setuptools.packages.find]
+include = ["pgfsm*"]
+
+[build-system]
+# >=77 for the PEP 639 SPDX `license` string above.
+requires = ["setuptools>=77"]
+build-backend = "setuptools.build_meta"

pgfsm_proto_codegen-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+