hatchet-sdk 0.47.1__tar.gz → 1.0.0a1__tar.gz

{hatchet_sdk-0.47.1 → hatchet_sdk-1.0.0a1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: hatchet-sdk
-Version: 0.47.1
+Version: 1.0.0a1
 Summary: 
 Author: Alexander Belanger
 Author-email: alexander@hatchet.run
@@ -28,8 +28,8 @@ Requires-Dist: opentelemetry-sdk (>=1.28.0,<2.0.0) ; extra == "otel"
 Requires-Dist: prometheus-client (>=0.21.1,<0.22.0)
 Requires-Dist: protobuf (>=5.29.1,<6.0.0)
 Requires-Dist: pydantic (>=2.6.3,<3.0.0)
+Requires-Dist: pydantic-settings (>=2.7.1,<3.0.0)
 Requires-Dist: python-dateutil (>=2.9.0.post0,<3.0.0)
-Requires-Dist: python-dotenv (>=1.0.0,<2.0.0)
 Requires-Dist: pyyaml (>=6.0.1,<7.0.0)
 Requires-Dist: tenacity (>=8.4.1)
 Requires-Dist: urllib3 (>=1.26.20)

{hatchet_sdk-0.47.1 → hatchet_sdk-1.0.0a1}/hatchet_sdk/__init__.py

@@ -1,3 +1,10 @@
+from hatchet_sdk.clients.admin import (
+    DedupeViolationErr,
+    ScheduleTriggerWorkflowOptions,
+    TriggerWorkflowOptions,
+)
+from hatchet_sdk.clients.durable_event_listener import RegisterDurableEventRequest
+from hatchet_sdk.clients.events import PushEventOptions
 from hatchet_sdk.clients.rest.models.accept_invite_request import AcceptInviteRequest
 
 # import models into sdk package
@@ -68,7 +75,6 @@ from hatchet_sdk.clients.rest.models.pull_request_state import PullRequestState
 from hatchet_sdk.clients.rest.models.reject_invite_request import RejectInviteRequest
 from hatchet_sdk.clients.rest.models.replay_event_request import ReplayEventRequest
 from hatchet_sdk.clients.rest.models.rerun_step_run_request import RerunStepRunRequest
-from hatchet_sdk.clients.rest.models.step import Step
 from hatchet_sdk.clients.rest.models.step_run import StepRun
 from hatchet_sdk.clients.rest.models.step_run_diff import StepRunDiff
 from hatchet_sdk.clients.rest.models.step_run_status import StepRunStatus
@@ -117,29 +123,37 @@ from hatchet_sdk.clients.rest.models.workflow_version_definition import (
     WorkflowVersionDefinition,
 )
 from hatchet_sdk.clients.rest.models.workflow_version_meta import WorkflowVersionMeta
+from hatchet_sdk.clients.run_event_listener import (
+    StepRunEventType,
+    WorkflowRunEventType,
+)
+from hatchet_sdk.config import ClientConfig
+from hatchet_sdk.context.context import Context, DurableContext
+from hatchet_sdk.context.worker_context import WorkerContext
 from hatchet_sdk.contracts.workflows_pb2 import (
-    ConcurrencyLimitStrategy,
     CreateWorkflowVersionOpts,
     RateLimitDuration,
-    StickyStrategy,
     WorkerLabelComparator,
 )
-from hatchet_sdk.utils.aio_utils import sync_to_async
-
-from .client import new_client
-from .clients.admin import (
-    ChildTriggerWorkflowOptions,
-    DedupeViolationErr,
-    ScheduleTriggerWorkflowOptions,
-    TriggerWorkflowOptions,
+from hatchet_sdk.hatchet import Hatchet
+from hatchet_sdk.runnables.task import Task
+from hatchet_sdk.runnables.types import (
+    ConcurrencyExpression,
+    ConcurrencyLimitStrategy,
+    EmptyModel,
+    StickyStrategy,
+    TaskDefaults,
+    WorkflowConfig,
+)
+from hatchet_sdk.waits import (
+    Condition,
+    OrGroup,
+    ParentCondition,
+    SleepCondition,
+    UserEventCondition,
+    or_,
 )
-from .clients.events import PushEventOptions
-from .clients.run_event_listener import StepRunEventType, WorkflowRunEventType
-from .context.context import Context
-from .context.worker_context import WorkerContext
-from .hatchet import ClientConfig, Hatchet, concurrency, on_failure_step, step, workflow
-from .worker import Worker, WorkerStartOptions, WorkerStatus
-from .workflow import ConcurrencyExpression
+from hatchet_sdk.worker.worker import Worker, WorkerStartOptions, WorkerStatus
 
 __all__ = [
     "AcceptInviteRequest",
@@ -184,11 +198,9 @@ __all__ = [
     "RejectInviteRequest",
     "ReplayEventRequest",
     "RerunStepRunRequest",
-    "Step",
     "StepRun",
     "StepRunDiff",
     "StepRunStatus",
-    "sync_to_async",
     "Tenant",
     "TenantInvite",
     "TenantInviteList",
@@ -224,8 +236,6 @@ __all__ = [
     "CreateWorkflowVersionOpts",
     "RateLimitDuration",
     "StickyStrategy",
-    "new_client",
-    "ChildTriggerWorkflowOptions",
     "DedupeViolationErr",
     "ScheduleTriggerWorkflowOptions",
     "TriggerWorkflowOptions",
@@ -236,12 +246,22 @@ __all__ = [
     "WorkerContext",
     "ClientConfig",
     "Hatchet",
-    "concurrency",
-    "on_failure_step",
-    "step",
     "workflow",
     "Worker",
     "WorkerStartOptions",
     "WorkerStatus",
     "ConcurrencyExpression",
+    "Workflow",
+    "WorkflowConfig",
+    "Task",
+    "EmptyModel",
+    "Condition",
+    "OrGroup",
+    "or_",
+    "SleepCondition",
+    "UserEventCondition",
+    "ParentCondition",
+    "DurableContext",
+    "RegisterDurableEventRequest",
+    "TaskDefaults",
 ]

hatchet_sdk-1.0.0a1/hatchet_sdk/client.py

@@ -0,0 +1,44 @@
+import asyncio
+
+import grpc
+
+from hatchet_sdk.clients.admin import AdminClient
+from hatchet_sdk.clients.dispatcher.dispatcher import DispatcherClient
+from hatchet_sdk.clients.events import EventClient, new_event
+from hatchet_sdk.clients.rest_client import RestApi
+from hatchet_sdk.clients.run_event_listener import RunEventListenerClient
+from hatchet_sdk.clients.workflow_listener import PooledWorkflowRunListener
+from hatchet_sdk.config import ClientConfig
+from hatchet_sdk.connection import new_conn
+
+
+class Client:
+    def __init__(
+        self,
+        config: ClientConfig,
+        event_client: EventClient | None = None,
+        admin_client: AdminClient | None = None,
+        dispatcher_client: DispatcherClient | None = None,
+        workflow_listener: PooledWorkflowRunListener | None | None = None,
+        rest_client: RestApi | None = None,
+        debug: bool = False,
+    ):
+        try:
+            loop = asyncio.get_running_loop()
+        except RuntimeError:
+            loop = asyncio.new_event_loop()
+            asyncio.set_event_loop(loop)
+
+        conn: grpc.Channel = new_conn(config, False)
+
+        self.config = config
+        self.admin = admin_client or AdminClient(config)
+        self.dispatcher = dispatcher_client or DispatcherClient(config)
+        self.event = event_client or new_event(conn, config)
+        self.rest = rest_client or RestApi(
+            config.server_url, config.token, config.tenant_id
+        )
+        self.listener = RunEventListenerClient(config)
+        self.workflow_listener = workflow_listener
+        self.logInterceptor = config.logger
+        self.debug = debug

hatchet_sdk-1.0.0a1/hatchet_sdk/clients/admin.py

@@ -0,0 +1,462 @@
+import asyncio
+import json
+from datetime import datetime
+from typing import Union, cast
+
+import grpc
+from google.protobuf import timestamp_pb2
+from pydantic import BaseModel, ConfigDict, Field, field_validator
+
+from hatchet_sdk.clients.rest.tenacity_utils import tenacity_retry
+from hatchet_sdk.clients.run_event_listener import RunEventListenerClient
+from hatchet_sdk.clients.workflow_listener import PooledWorkflowRunListener
+from hatchet_sdk.config import ClientConfig
+from hatchet_sdk.connection import new_conn
+from hatchet_sdk.contracts import workflows_pb2 as v0_workflow_protos
+from hatchet_sdk.contracts.v1 import workflows_pb2 as workflow_protos
+from hatchet_sdk.contracts.v1.workflows_pb2_grpc import AdminServiceStub
+from hatchet_sdk.contracts.workflows_pb2_grpc import WorkflowServiceStub
+from hatchet_sdk.metadata import get_metadata
+from hatchet_sdk.rate_limit import RateLimitDuration
+from hatchet_sdk.runnables.contextvars import (
+    ctx_step_run_id,
+    ctx_worker_id,
+    ctx_workflow_run_id,
+    spawn_index_lock,
+    workflow_spawn_indices,
+)
+from hatchet_sdk.utils.proto_enums import convert_python_enum_to_proto
+from hatchet_sdk.utils.typing import JSONSerializableMapping
+from hatchet_sdk.workflow_run import WorkflowRunRef
+
+
+class ScheduleTriggerWorkflowOptions(BaseModel):
+    parent_id: str | None = None
+    parent_step_run_id: str | None = None
+    child_index: int | None = None
+    child_key: str | None = None
+    namespace: str | None = None
+
+
+class TriggerWorkflowOptions(ScheduleTriggerWorkflowOptions):
+    additional_metadata: JSONSerializableMapping = Field(default_factory=dict)
+    desired_worker_id: str | None = None
+    namespace: str | None = None
+    sticky: bool = False
+    key: str | None = None
+
+
+class WorkflowRunTriggerConfig(BaseModel):
+    workflow_name: str
+    input: JSONSerializableMapping
+    options: TriggerWorkflowOptions
+    key: str | None = None
+
+
+class DedupeViolationErr(Exception):
+    """Raised by the Hatchet library to indicate that a workflow has already been run with this deduplication value."""
+
+    pass
+
+
+class AdminClient:
+    def __init__(self, config: ClientConfig):
+        conn = new_conn(config, False)
+        self.config = config
+        self.client = AdminServiceStub(conn)  # type: ignore[no-untyped-call]
+        self.v0_client = WorkflowServiceStub(conn)  # type: ignore[no-untyped-call]
+        self.token = config.token
+        self.listener_client = RunEventListenerClient(config=config)
+        self.namespace = config.namespace
+
+        self.pooled_workflow_listener: PooledWorkflowRunListener | None = None
+
+    class TriggerWorkflowRequest(BaseModel):
+        model_config = ConfigDict(extra="ignore")
+
+        parent_id: str | None = None
+        parent_step_run_id: str | None = None
+        child_index: int | None = None
+        child_key: str | None = None
+        additional_metadata: str | None = None
+        desired_worker_id: str | None = None
+        priority: int | None = None
+
+        @field_validator("additional_metadata", mode="before")
+        @classmethod
+        def validate_additional_metadata(
+            cls, v: JSONSerializableMapping | None
+        ) -> bytes | None:
+            if not v:
+                return None
+
+            try:
+                return json.dumps(v).encode("utf-8")
+            except json.JSONDecodeError as e:
+                raise ValueError(f"Error encoding payload: {e}")
+
+    def _prepare_workflow_request(
+        self,
+        workflow_name: str,
+        input: JSONSerializableMapping,
+        options: TriggerWorkflowOptions,
+    ) -> v0_workflow_protos.TriggerWorkflowRequest:
+        try:
+            payload_data = json.dumps(input)
+        except json.JSONDecodeError as e:
+            raise ValueError(f"Error encoding payload: {e}")
+
+        _options = self.TriggerWorkflowRequest.model_validate(
+            options.model_dump()
+        ).model_dump()
+
+        return v0_workflow_protos.TriggerWorkflowRequest(
+            name=workflow_name, input=payload_data, **_options
+        )
+
+    def _prepare_put_workflow_request(
+        self,
+        name: str,
+        workflow: workflow_protos.CreateWorkflowVersionRequest,
+        overrides: workflow_protos.CreateWorkflowVersionRequest | None = None,
+    ) -> workflow_protos.CreateWorkflowVersionRequest:
+        if overrides is not None:
+            workflow.MergeFrom(overrides)
+
+        workflow.name = name
+
+        return workflow
+
+    def _parse_schedule(
+        self, schedule: datetime | timestamp_pb2.Timestamp
+    ) -> timestamp_pb2.Timestamp:
+        if isinstance(schedule, datetime):
+            t = schedule.timestamp()
+            seconds = int(t)
+            nanos = int(t % 1 * 1e9)
+            return timestamp_pb2.Timestamp(seconds=seconds, nanos=nanos)
+        elif isinstance(schedule, timestamp_pb2.Timestamp):
+            return schedule
+        else:
+            raise ValueError(
+                "Invalid schedule type. Must be datetime or timestamp_pb2.Timestamp."
+            )
+
+    def _prepare_schedule_workflow_request(
+        self,
+        name: str,
+        schedules: list[Union[datetime, timestamp_pb2.Timestamp]],
+        input: JSONSerializableMapping = {},
+        options: ScheduleTriggerWorkflowOptions = ScheduleTriggerWorkflowOptions(),
+    ) -> v0_workflow_protos.ScheduleWorkflowRequest:
+        return v0_workflow_protos.ScheduleWorkflowRequest(
+            name=name,
+            schedules=[self._parse_schedule(schedule) for schedule in schedules],
+            input=json.dumps(input),
+            **options.model_dump(),
+        )
+
+    @tenacity_retry
+    async def aio_put_workflow(
+        self,
+        name: str,
+        workflow: workflow_protos.CreateWorkflowVersionRequest,
+        overrides: workflow_protos.CreateWorkflowVersionRequest | None = None,
+    ) -> workflow_protos.CreateWorkflowVersionResponse:
+        ## IMPORTANT: The `pooled_workflow_listener` must be created 1) lazily, and not at `init` time, and 2) on the
+        ## main thread. If 1) is not followed, you'll get an error about something being attached to the wrong event
+        ## loop. If 2) is not followed, you'll get an error about the event loop not being set up.
+        if not self.pooled_workflow_listener:
+            self.pooled_workflow_listener = PooledWorkflowRunListener(self.config)
+
+        return await asyncio.to_thread(self.put_workflow, name, workflow, overrides)
+
+    @tenacity_retry
+    async def aio_put_rate_limit(
+        self,
+        key: str,
+        limit: int,
+        duration: RateLimitDuration = RateLimitDuration.SECOND,
+    ) -> None:
+        ## IMPORTANT: The `pooled_workflow_listener` must be created 1) lazily, and not at `init` time, and 2) on the
+        ## main thread. If 1) is not followed, you'll get an error about something being attached to the wrong event
+        ## loop. If 2) is not followed, you'll get an error about the event loop not being set up.
+        if not self.pooled_workflow_listener:
+            self.pooled_workflow_listener = PooledWorkflowRunListener(self.config)
+
+        return await asyncio.to_thread(self.put_rate_limit, key, limit, duration)
+
+    @tenacity_retry
+    async def aio_schedule_workflow(
+        self,
+        name: str,
+        schedules: list[Union[datetime, timestamp_pb2.Timestamp]],
+        input: JSONSerializableMapping = {},
+        options: ScheduleTriggerWorkflowOptions = ScheduleTriggerWorkflowOptions(),
+    ) -> v0_workflow_protos.WorkflowVersion:
+        ## IMPORTANT: The `pooled_workflow_listener` must be created 1) lazily, and not at `init` time, and 2) on the
+        ## main thread. If 1) is not followed, you'll get an error about something being attached to the wrong event
+        ## loop. If 2) is not followed, you'll get an error about the event loop not being set up.
+        if not self.pooled_workflow_listener:
+            self.pooled_workflow_listener = PooledWorkflowRunListener(self.config)
+
+        return await asyncio.to_thread(
+            self.schedule_workflow, name, schedules, input, options
+        )
+
+    @tenacity_retry
+    def put_workflow(
+        self,
+        name: str,
+        workflow: workflow_protos.CreateWorkflowVersionRequest,
+        overrides: workflow_protos.CreateWorkflowVersionRequest | None = None,
+    ) -> workflow_protos.CreateWorkflowVersionResponse:
+        opts = self._prepare_put_workflow_request(name, workflow, overrides)
+
+        return cast(
+            workflow_protos.CreateWorkflowVersionResponse,
+            self.client.PutWorkflow(
+                opts,
+                metadata=get_metadata(self.token),
+            ),
+        )
+
+    @tenacity_retry
+    def put_rate_limit(
+        self,
+        key: str,
+        limit: int,
+        duration: RateLimitDuration = RateLimitDuration.SECOND,
+    ) -> None:
+        duration_proto = convert_python_enum_to_proto(
+            duration, workflow_protos.RateLimitDuration
+        )
+
+        self.v0_client.PutRateLimit(
+            v0_workflow_protos.PutRateLimitRequest(
+                key=key,
+                limit=limit,
+                duration=duration_proto,  # type: ignore[arg-type]
+            ),
+            metadata=get_metadata(self.token),
+        )
+
+    @tenacity_retry
+    def schedule_workflow(
+        self,
+        name: str,
+        schedules: list[Union[datetime, timestamp_pb2.Timestamp]],
+        input: JSONSerializableMapping = {},
+        options: ScheduleTriggerWorkflowOptions = ScheduleTriggerWorkflowOptions(),
+    ) -> v0_workflow_protos.WorkflowVersion:
+        try:
+            namespace = options.namespace or self.namespace
+
+            if namespace != "" and not name.startswith(self.namespace):
+                name = f"{namespace}{name}"
+
+            request = self._prepare_schedule_workflow_request(
+                name, schedules, input, options
+            )
+
+            return cast(
+                v0_workflow_protos.WorkflowVersion,
+                self.v0_client.ScheduleWorkflow(
+                    request,
+                    metadata=get_metadata(self.token),
+                ),
+            )
+        except (grpc.RpcError, grpc.aio.AioRpcError) as e:
+            if e.code() == grpc.StatusCode.ALREADY_EXISTS:
+                raise DedupeViolationErr(e.details())
+
+            raise e
+
+    def _create_workflow_run_request(
+        self,
+        workflow_name: str,
+        input: JSONSerializableMapping,
+        options: TriggerWorkflowOptions,
+    ) -> v0_workflow_protos.TriggerWorkflowRequest:
+        workflow_run_id = ctx_workflow_run_id.get()
+        step_run_id = ctx_step_run_id.get()
+        worker_id = ctx_worker_id.get()
+        spawn_index = workflow_spawn_indices[workflow_run_id] if workflow_run_id else 0
+
+        ## Increment the spawn_index for the parent workflow
+        if workflow_run_id:
+            workflow_spawn_indices[workflow_run_id] += 1
+
+        desired_worker_id = (
+            (options.desired_worker_id or worker_id) if options.sticky else None
+        )
+        child_index = (
+            options.child_index if options.child_index is not None else spawn_index
+        )
+
+        trigger_options = TriggerWorkflowOptions(
+            parent_id=options.parent_id or workflow_run_id,
+            parent_step_run_id=options.parent_step_run_id or step_run_id,
+            child_key=options.child_key,
+            child_index=child_index,
+            additional_metadata=options.additional_metadata,
+            desired_worker_id=desired_worker_id,
+        )
+
+        namespace = options.namespace or self.namespace
+
+        if namespace != "" and not workflow_name.startswith(self.namespace):
+            workflow_name = f"{namespace}{workflow_name}"
+
+        return self._prepare_workflow_request(workflow_name, input, trigger_options)
+
+    ## IMPORTANT: Keep this method's signature in sync with the wrapper in the OTel instrumentor
+    @tenacity_retry
+    def run_workflow(
+        self,
+        workflow_name: str,
+        input: JSONSerializableMapping,
+        options: TriggerWorkflowOptions = TriggerWorkflowOptions(),
+    ) -> WorkflowRunRef:
+        request = self._create_workflow_run_request(workflow_name, input, options)
+
+        if not self.pooled_workflow_listener:
+            self.pooled_workflow_listener = PooledWorkflowRunListener(self.config)
+
+        try:
+            resp = cast(
+                v0_workflow_protos.TriggerWorkflowResponse,
+                self.v0_client.TriggerWorkflow(
+                    request,
+                    metadata=get_metadata(self.token),
+                ),
+            )
+        except (grpc.RpcError, grpc.aio.AioRpcError) as e:
+            if e.code() == grpc.StatusCode.ALREADY_EXISTS:
+                raise DedupeViolationErr(e.details())
+
+        return WorkflowRunRef(
+            workflow_run_id=resp.workflow_run_id,
+            workflow_listener=self.pooled_workflow_listener,
+            workflow_run_event_listener=self.listener_client,
+        )
+
+    ## IMPORTANT: Keep this method's signature in sync with the wrapper in the OTel instrumentor
+    @tenacity_retry
+    async def aio_run_workflow(
+        self,
+        workflow_name: str,
+        input: JSONSerializableMapping,
+        options: TriggerWorkflowOptions = TriggerWorkflowOptions(),
+    ) -> WorkflowRunRef:
+        ## IMPORTANT: The `pooled_workflow_listener` must be created 1) lazily, and not at `init` time, and 2) on the
+        ## main thread. If 1) is not followed, you'll get an error about something being attached to the wrong event
+        ## loop. If 2) is not followed, you'll get an error about the event loop not being set up.
+        async with spawn_index_lock:
+            request = self._create_workflow_run_request(workflow_name, input, options)
+
+        if not self.pooled_workflow_listener:
+            self.pooled_workflow_listener = PooledWorkflowRunListener(self.config)
+
+        try:
+            resp = cast(
+                v0_workflow_protos.TriggerWorkflowResponse,
+                self.v0_client.TriggerWorkflow(
+                    request,
+                    metadata=get_metadata(self.token),
+                ),
+            )
+        except (grpc.RpcError, grpc.aio.AioRpcError) as e:
+            if e.code() == grpc.StatusCode.ALREADY_EXISTS:
+                raise DedupeViolationErr(e.details())
+
+            raise e
+
+        return WorkflowRunRef(
+            workflow_run_id=resp.workflow_run_id,
+            workflow_listener=self.pooled_workflow_listener,
+            workflow_run_event_listener=self.listener_client,
+        )
+
+    ## IMPORTANT: Keep this method's signature in sync with the wrapper in the OTel instrumentor
+    @tenacity_retry
+    def run_workflows(
+        self,
+        workflows: list[WorkflowRunTriggerConfig],
+    ) -> list[WorkflowRunRef]:
+        if not self.pooled_workflow_listener:
+            self.pooled_workflow_listener = PooledWorkflowRunListener(self.config)
+
+        bulk_request = v0_workflow_protos.BulkTriggerWorkflowRequest(
+            workflows=[
+                self._create_workflow_run_request(
+                    workflow.workflow_name, workflow.input, workflow.options
+                )
+                for workflow in workflows
+            ]
+        )
+
+        resp = cast(
+            v0_workflow_protos.BulkTriggerWorkflowResponse,
+            self.v0_client.BulkTriggerWorkflow(
+                bulk_request,
+                metadata=get_metadata(self.token),
+            ),
+        )
+
+        return [
+            WorkflowRunRef(
+                workflow_run_id=workflow_run_id,
+                workflow_listener=self.pooled_workflow_listener,
+                workflow_run_event_listener=self.listener_client,
+            )
+            for workflow_run_id in resp.workflow_run_ids
+        ]
+
+    @tenacity_retry
+    async def aio_run_workflows(
+        self,
+        workflows: list[WorkflowRunTriggerConfig],
+    ) -> list[WorkflowRunRef]:
+        ## IMPORTANT: The `pooled_workflow_listener` must be created 1) lazily, and not at `init` time, and 2) on the
+        ## main thread. If 1) is not followed, you'll get an error about something being attached to the wrong event
+        ## loop. If 2) is not followed, you'll get an error about the event loop not being set up.
+        if not self.pooled_workflow_listener:
+            self.pooled_workflow_listener = PooledWorkflowRunListener(self.config)
+
+        async with spawn_index_lock:
+            bulk_request = v0_workflow_protos.BulkTriggerWorkflowRequest(
+                workflows=[
+                    self._create_workflow_run_request(
+                        workflow.workflow_name, workflow.input, workflow.options
+                    )
+                    for workflow in workflows
+                ]
+            )
+
+        resp = cast(
+            v0_workflow_protos.BulkTriggerWorkflowResponse,
+            self.v0_client.BulkTriggerWorkflow(
+                bulk_request,
+                metadata=get_metadata(self.token),
+            ),
+        )
+
+        return [
+            WorkflowRunRef(
+                workflow_run_id=workflow_run_id,
+                workflow_listener=self.pooled_workflow_listener,
+                workflow_run_event_listener=self.listener_client,
+            )
+            for workflow_run_id in resp.workflow_run_ids
+        ]
+
+    def get_workflow_run(self, workflow_run_id: str) -> WorkflowRunRef:
+        if not self.pooled_workflow_listener:
+            self.pooled_workflow_listener = PooledWorkflowRunListener(self.config)
+
+        return WorkflowRunRef(
+            workflow_run_id=workflow_run_id,
+            workflow_listener=self.pooled_workflow_listener,
+            workflow_run_event_listener=self.listener_client,
+        )