trytilde 3.0.1__py3-none-any.whl

tilde/agent_event_ingress/v1/sidecars_connect.py

@@ -0,0 +1,748 @@
+# Generated from tilde/agent_event_ingress/v1/sidecars.proto. DO NOT EDIT.
+# Generated by protoc-gen-connectrpc-py v0.12.1 with parameter "protobuf=google".
+# ruff: noqa: PGH004
+# ruff: noqa
+# fmt: off
+
+from __future__ import annotations
+
+from typing import Protocol, TYPE_CHECKING
+
+from connectrpc.client import ConnectClient, ConnectClientSync
+from connectrpc.code import Code
+from connectrpc.compat import google_protobuf_binary_codec, google_protobuf_codecs
+from connectrpc.compression.gzip import GzipCompression
+from connectrpc.errors import ConnectError
+from connectrpc.method import IdempotencyLevel, MethodInfo
+from connectrpc.protocol import ProtocolType
+from connectrpc.server import ConnectASGIApplication, ConnectWSGIApplication, DEFAULT_READ_MAX_BYTES, Endpoint, EndpointSync
+from pyqwest import Client, SyncClient
+
+from .sidecars_pb2 import DownloadAttachmentRequest, DownloadAttachmentResponse, ForwardRequest, ForwardResponse, HydrateRequest, HydrateResponse, PublishRequest, PublishResponse, RelayRequest, RelayResponse, ResolveParticipantRequest, ResolveParticipantResponse, UploadAttachmentRequest, UploadAttachmentResponse, WatchRequest, WatchResponse
+
+if TYPE_CHECKING:
+    from collections.abc import AsyncGenerator, AsyncIterator, Iterable, Iterator, Mapping
+
+    from connectrpc.codec import Codec
+    from connectrpc.compression import Compression
+    from connectrpc.interceptor import Interceptor, InterceptorSync
+    from connectrpc.request import Headers, RequestContext
+
+
+
+_DEFAULT_CODECS = google_protobuf_codecs()
+_PROTO_BINARY_CODEC = google_protobuf_binary_codec()
+_GZIP_COMPRESSION = GzipCompression()
+
+class SidecarService(Protocol):
+    """
+    Sidecars dial the gateway; every call authenticates one agent deployment token.
+    The gateway never opens a connection to a sidecar. Postgres is the record; a
+    replica is a cache plus a write-behind queue plus the executor for the threads
+    it holds a lease on.
+    """
+    def watch(self, request: WatchRequest, ctx: RequestContext[WatchRequest, WatchResponse], /) -> AsyncIterator[WatchResponse]:
+        """
+        Held open for the life of a replica: a snapshot first, then configuration,
+        lease changes and directives as they change.
+        """
+        raise ConnectError(Code.UNIMPLEMENTED, 'Not implemented')
+
+    async def publish(self, request: PublishRequest, ctx: RequestContext[PublishRequest, PublishResponse], /) -> PublishResponse:
+        """
+        Heartbeats, typed events, directive results, lease releases and telemetry, in order.
+        """
+        raise ConnectError(Code.UNIMPLEMENTED, 'Not implemented')
+
+    async def hydrate(self, request: HydrateRequest, ctx: RequestContext[HydrateRequest, HydrateResponse], /) -> HydrateResponse:
+        """
+        Conversation state from the projection, taking the thread lease in the same call when asked.
+        """
+        raise ConnectError(Code.UNIMPLEMENTED, 'Not implemented')
+
+    async def forward(self, request: ForwardRequest, ctx: RequestContext[ForwardRequest, ForwardResponse], /) -> ForwardResponse:
+        """
+        Run one ingress call on a live replica and relay its answer.
+        """
+        raise ConnectError(Code.UNIMPLEMENTED, 'Not implemented')
+
+    async def upload_attachment(self, request: UploadAttachmentRequest, ctx: RequestContext[UploadAttachmentRequest, UploadAttachmentResponse], /) -> UploadAttachmentResponse:
+        raise ConnectError(Code.UNIMPLEMENTED, 'Not implemented')
+
+    async def download_attachment(self, request: DownloadAttachmentRequest, ctx: RequestContext[DownloadAttachmentRequest, DownloadAttachmentResponse], /) -> DownloadAttachmentResponse:
+        raise ConnectError(Code.UNIMPLEMENTED, 'Not implemented')
+
+    async def resolve_participant(self, request: ResolveParticipantRequest, ctx: RequestContext[ResolveParticipantRequest, ResolveParticipantResponse], /) -> ResolveParticipantResponse:
+        raise ConnectError(Code.UNIMPLEMENTED, 'Not implemented')
+
+    async def relay(self, request: RelayRequest, ctx: RequestContext[RelayRequest, RelayResponse], /) -> RelayResponse:
+        """
+        Registry RPCs from the agent process, re-verified at the gateway.
+        """
+        raise ConnectError(Code.UNIMPLEMENTED, 'Not implemented')
+
+
+class SidecarServiceASGIApplication(ConnectASGIApplication[SidecarService]):
+    def __init__(
+        self,
+        service: SidecarService | AsyncGenerator[SidecarService],
+        *,
+        interceptors: Iterable[Interceptor] = (),
+        read_max_bytes: int | None = DEFAULT_READ_MAX_BYTES,
+        compressions: Iterable[Compression] | None = None,
+        codecs: Iterable[Codec] | None = _DEFAULT_CODECS,
+    ) -> None:
+        super().__init__(
+            service=service,
+            endpoints=lambda svc: {
+                "/tilde.agent_event_ingress.v1.SidecarService/Watch": Endpoint.server_stream(
+                    method=MethodInfo(
+                        name="Watch",
+                        service_name="tilde.agent_event_ingress.v1.SidecarService",
+                        input=WatchRequest,
+                        output=WatchResponse,
+                        idempotency_level=IdempotencyLevel.UNKNOWN,
+                    ),
+                    function=svc.watch,
+                ),
+                "/tilde.agent_event_ingress.v1.SidecarService/Publish": Endpoint.unary(
+                    method=MethodInfo(
+                        name="Publish",
+                        service_name="tilde.agent_event_ingress.v1.SidecarService",
+                        input=PublishRequest,
+                        output=PublishResponse,
+                        idempotency_level=IdempotencyLevel.UNKNOWN,
+                    ),
+                    function=svc.publish,
+                ),
+                "/tilde.agent_event_ingress.v1.SidecarService/Hydrate": Endpoint.unary(
+                    method=MethodInfo(
+                        name="Hydrate",
+                        service_name="tilde.agent_event_ingress.v1.SidecarService",
+                        input=HydrateRequest,
+                        output=HydrateResponse,
+                        idempotency_level=IdempotencyLevel.UNKNOWN,
+                    ),
+                    function=svc.hydrate,
+                ),
+                "/tilde.agent_event_ingress.v1.SidecarService/Forward": Endpoint.unary(
+                    method=MethodInfo(
+                        name="Forward",
+                        service_name="tilde.agent_event_ingress.v1.SidecarService",
+                        input=ForwardRequest,
+                        output=ForwardResponse,
+                        idempotency_level=IdempotencyLevel.UNKNOWN,
+                    ),
+                    function=svc.forward,
+                ),
+                "/tilde.agent_event_ingress.v1.SidecarService/UploadAttachment": Endpoint.unary(
+                    method=MethodInfo(
+                        name="UploadAttachment",
+                        service_name="tilde.agent_event_ingress.v1.SidecarService",
+                        input=UploadAttachmentRequest,
+                        output=UploadAttachmentResponse,
+                        idempotency_level=IdempotencyLevel.UNKNOWN,
+                    ),
+                    function=svc.upload_attachment,
+                ),
+                "/tilde.agent_event_ingress.v1.SidecarService/DownloadAttachment": Endpoint.unary(
+                    method=MethodInfo(
+                        name="DownloadAttachment",
+                        service_name="tilde.agent_event_ingress.v1.SidecarService",
+                        input=DownloadAttachmentRequest,
+                        output=DownloadAttachmentResponse,
+                        idempotency_level=IdempotencyLevel.UNKNOWN,
+                    ),
+                    function=svc.download_attachment,
+                ),
+                "/tilde.agent_event_ingress.v1.SidecarService/ResolveParticipant": Endpoint.unary(
+                    method=MethodInfo(
+                        name="ResolveParticipant",
+                        service_name="tilde.agent_event_ingress.v1.SidecarService",
+                        input=ResolveParticipantRequest,
+                        output=ResolveParticipantResponse,
+                        idempotency_level=IdempotencyLevel.UNKNOWN,
+                    ),
+                    function=svc.resolve_participant,
+                ),
+                "/tilde.agent_event_ingress.v1.SidecarService/Relay": Endpoint.unary(
+                    method=MethodInfo(
+                        name="Relay",
+                        service_name="tilde.agent_event_ingress.v1.SidecarService",
+                        input=RelayRequest,
+                        output=RelayResponse,
+                        idempotency_level=IdempotencyLevel.UNKNOWN,
+                    ),
+                    function=svc.relay,
+                ),
+            },
+            interceptors=interceptors,
+            read_max_bytes=read_max_bytes,
+            compressions=compressions,
+            codecs=codecs,
+        )
+
+    @property
+    def path(self) -> str:
+        """Returns the URL path to mount the application to when serving multiple applications."""
+        return "/tilde.agent_event_ingress.v1.SidecarService"
+
+
+class SidecarServiceClient(ConnectClient):
+    """
+    Sidecars dial the gateway; every call authenticates one agent deployment token.
+    The gateway never opens a connection to a sidecar. Postgres is the record; a
+    replica is a cache plus a write-behind queue plus the executor for the threads
+    it holds a lease on.
+    """
+    def __init__(
+        self,
+        address: str,
+        *,
+        codec: Codec | None = _PROTO_BINARY_CODEC,
+        protocol: ProtocolType = ProtocolType.CONNECT,
+        accept_compression: Iterable[Compression] | None = None,
+        send_compression: Compression | None = _GZIP_COMPRESSION,
+        timeout_ms: int | None = None,
+        read_max_bytes: int | None = None,
+        interceptors: Iterable[Interceptor] = (),
+        http_client: Client | None = None,
+    ) -> None:
+        super().__init__(
+            address=address,
+            codec=codec,
+            protocol=protocol,
+            accept_compression=accept_compression,
+            send_compression=send_compression,
+            timeout_ms=timeout_ms,
+            read_max_bytes=read_max_bytes,
+            interceptors=interceptors,
+            http_client=http_client,
+        )
+    def watch(
+        self,
+        request: WatchRequest,
+        *,
+        headers: Headers | Mapping[str, str] | None = None, 
+        timeout_ms: int | None = None,
+    ) -> AsyncIterator[WatchResponse]:
+        """
+        Held open for the life of a replica: a snapshot first, then configuration,
+        lease changes and directives as they change.
+        """
+        return self.execute_server_stream(
+            request=request,
+            method=MethodInfo(
+                name="Watch",
+                service_name="tilde.agent_event_ingress.v1.SidecarService",
+                input=WatchRequest,
+                output=WatchResponse,
+                idempotency_level=IdempotencyLevel.UNKNOWN,
+            ),
+            headers=headers,
+            timeout_ms=timeout_ms,
+        )
+
+    async def publish(
+        self,
+        request: PublishRequest,
+        *,
+        headers: Headers | Mapping[str, str] | None = None, 
+        timeout_ms: int | None = None,
+    ) -> PublishResponse:
+        """
+        Heartbeats, typed events, directive results, lease releases and telemetry, in order.
+        """
+        return await self.execute_unary(
+            request=request,
+            method=MethodInfo(
+                name="Publish",
+                service_name="tilde.agent_event_ingress.v1.SidecarService",
+                input=PublishRequest,
+                output=PublishResponse,
+                idempotency_level=IdempotencyLevel.UNKNOWN,
+            ),
+            headers=headers,
+            timeout_ms=timeout_ms,
+        )
+
+    async def hydrate(
+        self,
+        request: HydrateRequest,
+        *,
+        headers: Headers | Mapping[str, str] | None = None, 
+        timeout_ms: int | None = None,
+    ) -> HydrateResponse:
+        """
+        Conversation state from the projection, taking the thread lease in the same call when asked.
+        """
+        return await self.execute_unary(
+            request=request,
+            method=MethodInfo(
+                name="Hydrate",
+                service_name="tilde.agent_event_ingress.v1.SidecarService",
+                input=HydrateRequest,
+                output=HydrateResponse,
+                idempotency_level=IdempotencyLevel.UNKNOWN,
+            ),
+            headers=headers,
+            timeout_ms=timeout_ms,
+        )
+
+    async def forward(
+        self,
+        request: ForwardRequest,
+        *,
+        headers: Headers | Mapping[str, str] | None = None, 
+        timeout_ms: int | None = None,
+    ) -> ForwardResponse:
+        """
+        Run one ingress call on a live replica and relay its answer.
+        """
+        return await self.execute_unary(
+            request=request,
+            method=MethodInfo(
+                name="Forward",
+                service_name="tilde.agent_event_ingress.v1.SidecarService",
+                input=ForwardRequest,
+                output=ForwardResponse,
+                idempotency_level=IdempotencyLevel.UNKNOWN,
+            ),
+            headers=headers,
+            timeout_ms=timeout_ms,
+        )
+
+    async def upload_attachment(
+        self,
+        request: UploadAttachmentRequest,
+        *,
+        headers: Headers | Mapping[str, str] | None = None, 
+        timeout_ms: int | None = None,
+    ) -> UploadAttachmentResponse:
+        return await self.execute_unary(
+            request=request,
+            method=MethodInfo(
+                name="UploadAttachment",
+                service_name="tilde.agent_event_ingress.v1.SidecarService",
+                input=UploadAttachmentRequest,
+                output=UploadAttachmentResponse,
+                idempotency_level=IdempotencyLevel.UNKNOWN,
+            ),
+            headers=headers,
+            timeout_ms=timeout_ms,
+        )
+
+    async def download_attachment(
+        self,
+        request: DownloadAttachmentRequest,
+        *,
+        headers: Headers | Mapping[str, str] | None = None, 
+        timeout_ms: int | None = None,
+    ) -> DownloadAttachmentResponse:
+        return await self.execute_unary(
+            request=request,
+            method=MethodInfo(
+                name="DownloadAttachment",
+                service_name="tilde.agent_event_ingress.v1.SidecarService",
+                input=DownloadAttachmentRequest,
+                output=DownloadAttachmentResponse,
+                idempotency_level=IdempotencyLevel.UNKNOWN,
+            ),
+            headers=headers,
+            timeout_ms=timeout_ms,
+        )
+
+    async def resolve_participant(
+        self,
+        request: ResolveParticipantRequest,
+        *,
+        headers: Headers | Mapping[str, str] | None = None, 
+        timeout_ms: int | None = None,
+    ) -> ResolveParticipantResponse:
+        return await self.execute_unary(
+            request=request,
+            method=MethodInfo(
+                name="ResolveParticipant",
+                service_name="tilde.agent_event_ingress.v1.SidecarService",
+                input=ResolveParticipantRequest,
+                output=ResolveParticipantResponse,
+                idempotency_level=IdempotencyLevel.UNKNOWN,
+            ),
+            headers=headers,
+            timeout_ms=timeout_ms,
+        )
+
+    async def relay(
+        self,
+        request: RelayRequest,
+        *,
+        headers: Headers | Mapping[str, str] | None = None, 
+        timeout_ms: int | None = None,
+    ) -> RelayResponse:
+        """
+        Registry RPCs from the agent process, re-verified at the gateway.
+        """
+        return await self.execute_unary(
+            request=request,
+            method=MethodInfo(
+                name="Relay",
+                service_name="tilde.agent_event_ingress.v1.SidecarService",
+                input=RelayRequest,
+                output=RelayResponse,
+                idempotency_level=IdempotencyLevel.UNKNOWN,
+            ),
+            headers=headers,
+            timeout_ms=timeout_ms,
+        )
+
+class SidecarServiceSync(Protocol):
+    """
+    Sidecars dial the gateway; every call authenticates one agent deployment token.
+    The gateway never opens a connection to a sidecar. Postgres is the record; a
+    replica is a cache plus a write-behind queue plus the executor for the threads
+    it holds a lease on.
+    """
+    def watch(self, request: WatchRequest, ctx: RequestContext[WatchRequest, WatchResponse], /) -> Iterator[WatchResponse]:
+        """
+        Held open for the life of a replica: a snapshot first, then configuration,
+        lease changes and directives as they change.
+        """
+        raise ConnectError(Code.UNIMPLEMENTED, 'Not implemented')
+
+    def publish(self, request: PublishRequest, ctx: RequestContext[PublishRequest, PublishResponse], /) -> PublishResponse:
+        """
+        Heartbeats, typed events, directive results, lease releases and telemetry, in order.
+        """
+        raise ConnectError(Code.UNIMPLEMENTED, 'Not implemented')
+
+    def hydrate(self, request: HydrateRequest, ctx: RequestContext[HydrateRequest, HydrateResponse], /) -> HydrateResponse:
+        """
+        Conversation state from the projection, taking the thread lease in the same call when asked.
+        """
+        raise ConnectError(Code.UNIMPLEMENTED, 'Not implemented')
+
+    def forward(self, request: ForwardRequest, ctx: RequestContext[ForwardRequest, ForwardResponse], /) -> ForwardResponse:
+        """
+        Run one ingress call on a live replica and relay its answer.
+        """
+        raise ConnectError(Code.UNIMPLEMENTED, 'Not implemented')
+
+    def upload_attachment(self, request: UploadAttachmentRequest, ctx: RequestContext[UploadAttachmentRequest, UploadAttachmentResponse], /) -> UploadAttachmentResponse:
+        raise ConnectError(Code.UNIMPLEMENTED, 'Not implemented')
+
+    def download_attachment(self, request: DownloadAttachmentRequest, ctx: RequestContext[DownloadAttachmentRequest, DownloadAttachmentResponse], /) -> DownloadAttachmentResponse:
+        raise ConnectError(Code.UNIMPLEMENTED, 'Not implemented')
+
+    def resolve_participant(self, request: ResolveParticipantRequest, ctx: RequestContext[ResolveParticipantRequest, ResolveParticipantResponse], /) -> ResolveParticipantResponse:
+        raise ConnectError(Code.UNIMPLEMENTED, 'Not implemented')
+
+    def relay(self, request: RelayRequest, ctx: RequestContext[RelayRequest, RelayResponse], /) -> RelayResponse:
+        """
+        Registry RPCs from the agent process, re-verified at the gateway.
+        """
+        raise ConnectError(Code.UNIMPLEMENTED, 'Not implemented')
+
+
+class SidecarServiceWSGIApplication(ConnectWSGIApplication):
+    def __init__(
+        self,
+        service: SidecarServiceSync,
+        interceptors: Iterable[InterceptorSync] = (),
+        read_max_bytes: int | None = DEFAULT_READ_MAX_BYTES,
+        compressions: Iterable[Compression] | None = None,
+        codecs: Iterable[Codec] | None = _DEFAULT_CODECS,
+    ) -> None:
+        super().__init__(
+            endpoints={
+                "/tilde.agent_event_ingress.v1.SidecarService/Watch": EndpointSync.server_stream(
+                    method=MethodInfo(
+                        name="Watch",
+                        service_name="tilde.agent_event_ingress.v1.SidecarService",
+                        input=WatchRequest,
+                        output=WatchResponse,
+                        idempotency_level=IdempotencyLevel.UNKNOWN,
+                    ),
+                    function=service.watch,
+                ),
+                "/tilde.agent_event_ingress.v1.SidecarService/Publish": EndpointSync.unary(
+                    method=MethodInfo(
+                        name="Publish",
+                        service_name="tilde.agent_event_ingress.v1.SidecarService",
+                        input=PublishRequest,
+                        output=PublishResponse,
+                        idempotency_level=IdempotencyLevel.UNKNOWN,
+                    ),
+                    function=service.publish,
+                ),
+                "/tilde.agent_event_ingress.v1.SidecarService/Hydrate": EndpointSync.unary(
+                    method=MethodInfo(
+                        name="Hydrate",
+                        service_name="tilde.agent_event_ingress.v1.SidecarService",
+                        input=HydrateRequest,
+                        output=HydrateResponse,
+                        idempotency_level=IdempotencyLevel.UNKNOWN,
+                    ),
+                    function=service.hydrate,
+                ),
+                "/tilde.agent_event_ingress.v1.SidecarService/Forward": EndpointSync.unary(
+                    method=MethodInfo(
+                        name="Forward",
+                        service_name="tilde.agent_event_ingress.v1.SidecarService",
+                        input=ForwardRequest,
+                        output=ForwardResponse,
+                        idempotency_level=IdempotencyLevel.UNKNOWN,
+                    ),
+                    function=service.forward,
+                ),
+                "/tilde.agent_event_ingress.v1.SidecarService/UploadAttachment": EndpointSync.unary(
+                    method=MethodInfo(
+                        name="UploadAttachment",
+                        service_name="tilde.agent_event_ingress.v1.SidecarService",
+                        input=UploadAttachmentRequest,
+                        output=UploadAttachmentResponse,
+                        idempotency_level=IdempotencyLevel.UNKNOWN,
+                    ),
+                    function=service.upload_attachment,
+                ),
+                "/tilde.agent_event_ingress.v1.SidecarService/DownloadAttachment": EndpointSync.unary(
+                    method=MethodInfo(
+                        name="DownloadAttachment",
+                        service_name="tilde.agent_event_ingress.v1.SidecarService",
+                        input=DownloadAttachmentRequest,
+                        output=DownloadAttachmentResponse,
+                        idempotency_level=IdempotencyLevel.UNKNOWN,
+                    ),
+                    function=service.download_attachment,
+                ),
+                "/tilde.agent_event_ingress.v1.SidecarService/ResolveParticipant": EndpointSync.unary(
+                    method=MethodInfo(
+                        name="ResolveParticipant",
+                        service_name="tilde.agent_event_ingress.v1.SidecarService",
+                        input=ResolveParticipantRequest,
+                        output=ResolveParticipantResponse,
+                        idempotency_level=IdempotencyLevel.UNKNOWN,
+                    ),
+                    function=service.resolve_participant,
+                ),
+                "/tilde.agent_event_ingress.v1.SidecarService/Relay": EndpointSync.unary(
+                    method=MethodInfo(
+                        name="Relay",
+                        service_name="tilde.agent_event_ingress.v1.SidecarService",
+                        input=RelayRequest,
+                        output=RelayResponse,
+                        idempotency_level=IdempotencyLevel.UNKNOWN,
+                    ),
+                    function=service.relay,
+                ),
+            },
+            interceptors=interceptors,
+            read_max_bytes=read_max_bytes,
+            compressions=compressions,
+            codecs=codecs,
+        )
+
+    @property
+    def path(self) -> str:
+        """Returns the URL path to mount the application to when serving multiple applications."""
+        return "/tilde.agent_event_ingress.v1.SidecarService"
+
+
+class SidecarServiceClientSync(ConnectClientSync):
+    """
+    Sidecars dial the gateway; every call authenticates one agent deployment token.
+    The gateway never opens a connection to a sidecar. Postgres is the record; a
+    replica is a cache plus a write-behind queue plus the executor for the threads
+    it holds a lease on.
+    """
+    def __init__(
+        self,
+        address: str,
+        *,
+        codec: Codec | None = _PROTO_BINARY_CODEC,
+        protocol: ProtocolType = ProtocolType.CONNECT,
+        accept_compression: Iterable[Compression] | None = None,
+        send_compression: Compression | None = _GZIP_COMPRESSION,
+        timeout_ms: int | None = None,
+        read_max_bytes: int | None = None,
+        interceptors: Iterable[InterceptorSync] = (),
+        http_client: SyncClient | None = None,
+    ) -> None:
+        super().__init__(
+            address=address,
+            codec=codec,
+            protocol=protocol,
+            accept_compression=accept_compression,
+            send_compression=send_compression,
+            timeout_ms=timeout_ms,
+            read_max_bytes=read_max_bytes,
+            interceptors=interceptors,
+            http_client=http_client,
+        )
+    def watch(
+        self,
+        request: WatchRequest,
+        *,
+        headers: Headers | Mapping[str, str] | None = None, 
+        timeout_ms: int | None = None,
+    ) -> Iterator[WatchResponse]:
+        """
+        Held open for the life of a replica: a snapshot first, then configuration,
+        lease changes and directives as they change.
+        """
+        return self.execute_server_stream(
+            request=request,
+            method=MethodInfo(
+                name="Watch",
+                service_name="tilde.agent_event_ingress.v1.SidecarService",
+                input=WatchRequest,
+                output=WatchResponse,
+                idempotency_level=IdempotencyLevel.UNKNOWN,
+            ),
+            headers=headers,
+            timeout_ms=timeout_ms,
+        )
+    def publish(
+        self,
+        request: PublishRequest,
+        *,
+        headers: Headers | Mapping[str, str] | None = None, 
+        timeout_ms: int | None = None,
+    ) -> PublishResponse:
+        """
+        Heartbeats, typed events, directive results, lease releases and telemetry, in order.
+        """
+        return self.execute_unary(
+            request=request,
+            method=MethodInfo(
+                name="Publish",
+                service_name="tilde.agent_event_ingress.v1.SidecarService",
+                input=PublishRequest,
+                output=PublishResponse,
+                idempotency_level=IdempotencyLevel.UNKNOWN,
+            ),
+            headers=headers,
+            timeout_ms=timeout_ms,
+        )
+    def hydrate(
+        self,
+        request: HydrateRequest,
+        *,
+        headers: Headers | Mapping[str, str] | None = None, 
+        timeout_ms: int | None = None,
+    ) -> HydrateResponse:
+        """
+        Conversation state from the projection, taking the thread lease in the same call when asked.
+        """
+        return self.execute_unary(
+            request=request,
+            method=MethodInfo(
+                name="Hydrate",
+                service_name="tilde.agent_event_ingress.v1.SidecarService",
+                input=HydrateRequest,
+                output=HydrateResponse,
+                idempotency_level=IdempotencyLevel.UNKNOWN,
+            ),
+            headers=headers,
+            timeout_ms=timeout_ms,
+        )
+    def forward(
+        self,
+        request: ForwardRequest,
+        *,
+        headers: Headers | Mapping[str, str] | None = None, 
+        timeout_ms: int | None = None,
+    ) -> ForwardResponse:
+        """
+        Run one ingress call on a live replica and relay its answer.
+        """
+        return self.execute_unary(
+            request=request,
+            method=MethodInfo(
+                name="Forward",
+                service_name="tilde.agent_event_ingress.v1.SidecarService",
+                input=ForwardRequest,
+                output=ForwardResponse,
+                idempotency_level=IdempotencyLevel.UNKNOWN,
+            ),
+            headers=headers,
+            timeout_ms=timeout_ms,
+        )
+    def upload_attachment(
+        self,
+        request: UploadAttachmentRequest,
+        *,
+        headers: Headers | Mapping[str, str] | None = None, 
+        timeout_ms: int | None = None,
+    ) -> UploadAttachmentResponse:
+        return self.execute_unary(
+            request=request,
+            method=MethodInfo(
+                name="UploadAttachment",
+                service_name="tilde.agent_event_ingress.v1.SidecarService",
+                input=UploadAttachmentRequest,
+                output=UploadAttachmentResponse,
+                idempotency_level=IdempotencyLevel.UNKNOWN,
+            ),
+            headers=headers,
+            timeout_ms=timeout_ms,
+        )
+    def download_attachment(
+        self,
+        request: DownloadAttachmentRequest,
+        *,
+        headers: Headers | Mapping[str, str] | None = None, 
+        timeout_ms: int | None = None,
+    ) -> DownloadAttachmentResponse:
+        return self.execute_unary(
+            request=request,
+            method=MethodInfo(
+                name="DownloadAttachment",
+                service_name="tilde.agent_event_ingress.v1.SidecarService",
+                input=DownloadAttachmentRequest,
+                output=DownloadAttachmentResponse,
+                idempotency_level=IdempotencyLevel.UNKNOWN,
+            ),
+            headers=headers,
+            timeout_ms=timeout_ms,
+        )
+    def resolve_participant(
+        self,
+        request: ResolveParticipantRequest,
+        *,
+        headers: Headers | Mapping[str, str] | None = None, 
+        timeout_ms: int | None = None,
+    ) -> ResolveParticipantResponse:
+        return self.execute_unary(
+            request=request,
+            method=MethodInfo(
+                name="ResolveParticipant",
+                service_name="tilde.agent_event_ingress.v1.SidecarService",
+                input=ResolveParticipantRequest,
+                output=ResolveParticipantResponse,
+                idempotency_level=IdempotencyLevel.UNKNOWN,
+            ),
+            headers=headers,
+            timeout_ms=timeout_ms,
+        )
+    def relay(
+        self,
+        request: RelayRequest,
+        *,
+        headers: Headers | Mapping[str, str] | None = None, 
+        timeout_ms: int | None = None,
+    ) -> RelayResponse:
+        """
+        Registry RPCs from the agent process, re-verified at the gateway.
+        """
+        return self.execute_unary(
+            request=request,
+            method=MethodInfo(
+                name="Relay",
+                service_name="tilde.agent_event_ingress.v1.SidecarService",
+                input=RelayRequest,
+                output=RelayResponse,
+                idempotency_level=IdempotencyLevel.UNKNOWN,
+            ),
+            headers=headers,
+            timeout_ms=timeout_ms,
+        )