hatchet-sdk 1.0.0__py3-none-any.whl → 1.0.0a1__py3-none-any.whl

hatchet_sdk/__init__.py

@@ -1,10 +1,9 @@
-from hatchet_sdk.client import new_client
 from hatchet_sdk.clients.admin import (
-    ChildTriggerWorkflowOptions,
     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
 
@@ -76,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
@@ -130,7 +128,7 @@ from hatchet_sdk.clients.run_event_listener import (
     WorkflowRunEventType,
 )
 from hatchet_sdk.config import ClientConfig
-from hatchet_sdk.context.context import Context
+from hatchet_sdk.context.context import Context, DurableContext
 from hatchet_sdk.context.worker_context import WorkerContext
 from hatchet_sdk.contracts.workflows_pb2 import (
     CreateWorkflowVersionOpts,
@@ -138,15 +136,24 @@ from hatchet_sdk.contracts.workflows_pb2 import (
     WorkerLabelComparator,
 )
 from hatchet_sdk.hatchet import Hatchet
-from hatchet_sdk.utils.aio_utils import sync_to_async
-from hatchet_sdk.worker.worker import Worker, WorkerStartOptions, WorkerStatus
-from hatchet_sdk.workflow import (
-    BaseWorkflow,
+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 hatchet_sdk.worker.worker import Worker, WorkerStartOptions, WorkerStatus
 
 __all__ = [
     "AcceptInviteRequest",
@@ -191,11 +198,9 @@ __all__ = [
     "RejectInviteRequest",
     "ReplayEventRequest",
     "RerunStepRunRequest",
-    "Step",
     "StepRun",
     "StepRunDiff",
     "StepRunStatus",
-    "sync_to_async",
     "Tenant",
     "TenantInvite",
     "TenantInviteList",
@@ -231,8 +236,6 @@ __all__ = [
     "CreateWorkflowVersionOpts",
     "RateLimitDuration",
     "StickyStrategy",
-    "new_client",
-    "ChildTriggerWorkflowOptions",
     "DedupeViolationErr",
     "ScheduleTriggerWorkflowOptions",
     "TriggerWorkflowOptions",
@@ -243,14 +246,22 @@ __all__ = [
     "WorkerContext",
     "ClientConfig",
     "Hatchet",
-    "concurrency",
-    "on_failure_step",
-    "step",
     "workflow",
     "Worker",
     "WorkerStartOptions",
     "WorkerStatus",
     "ConcurrencyExpression",
-    "BaseWorkflow",
+    "Workflow",
     "WorkflowConfig",
+    "Task",
+    "EmptyModel",
+    "Condition",
+    "OrGroup",
+    "or_",
+    "SleepCondition",
+    "UserEventCondition",
+    "ParentCondition",
+    "DurableContext",
+    "RegisterDurableEventRequest",
+    "TaskDefaults",
 ]

hatchet_sdk/client.py

@@ -1,5 +1,4 @@
 import asyncio
-from typing import Callable
 
 import grpc
 
@@ -14,63 +13,14 @@ from hatchet_sdk.connection import new_conn
 
 
 class Client:
-    @classmethod
-    def from_environment(
-        cls,
-        defaults: ClientConfig = ClientConfig(),
-        debug: bool = False,
-        *opts_functions: Callable[[ClientConfig], None],
-    ) -> "Client":
-        try:
-            loop = asyncio.get_running_loop()
-        except RuntimeError:
-            loop = asyncio.new_event_loop()
-            asyncio.set_event_loop(loop)
-
-        for opt_function in opts_functions:
-            opt_function(defaults)
-
-        return cls.from_config(defaults, debug)
-
-    @classmethod
-    def from_config(
-        cls,
-        config: ClientConfig = ClientConfig(),
-        debug: bool = False,
-    ) -> "Client":
-        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)
-
-        # Instantiate clients
-        event_client = new_event(conn, config)
-        admin_client = AdminClient(config)
-        dispatcher_client = DispatcherClient(config)
-        rest_client = RestApi(config.server_url, config.token, config.tenant_id)
-        workflow_listener = None  # Initialize this if needed
-
-        return cls(
-            event_client,
-            admin_client,
-            dispatcher_client,
-            workflow_listener,
-            rest_client,
-            config,
-            debug,
-        )
-
     def __init__(
         self,
-        event_client: EventClient,
-        admin_client: AdminClient,
-        dispatcher_client: DispatcherClient,
-        workflow_listener: PooledWorkflowRunListener | None,
-        rest_client: RestApi,
         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:
@@ -79,16 +29,16 @@ class Client:
             loop = asyncio.new_event_loop()
             asyncio.set_event_loop(loop)
 
-        self.admin = admin_client
-        self.dispatcher = dispatcher_client
-        self.event = event_client
-        self.rest = rest_client
+        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
-
-
-new_client = Client.from_environment
-new_client_raw = Client.from_config

hatchet_sdk/clients/admin.py

@@ -5,18 +5,27 @@ from typing import Union, cast
 
 import grpc
 from google.protobuf import timestamp_pb2
-from pydantic import BaseModel, Field
+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 workflow_protos
+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.utils.proto_enums import convert_python_enum_to_proto, maybe_int_to_str
+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
 
@@ -29,28 +38,19 @@ class ScheduleTriggerWorkflowOptions(BaseModel):
     namespace: str | None = None
 
 
-class ChildTriggerWorkflowOptions(BaseModel):
-    additional_metadata: JSONSerializableMapping = Field(default_factory=dict)
-    sticky: bool = False
-
-
-class ChildWorkflowRunDict(BaseModel):
-    workflow_name: str
-    input: JSONSerializableMapping
-    options: ChildTriggerWorkflowOptions
-    key: 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 WorkflowRunDict(BaseModel):
+class WorkflowRunTriggerConfig(BaseModel):
     workflow_name: str
     input: JSONSerializableMapping
     options: TriggerWorkflowOptions
+    key: str | None = None
 
 
 class DedupeViolationErr(Exception):
@@ -63,55 +63,69 @@ class AdminClient:
     def __init__(self, config: ClientConfig):
         conn = new_conn(config, False)
         self.config = config
-        self.client = WorkflowServiceStub(conn)  # type: ignore[no-untyped-call]
+        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,
-    ) -> workflow_protos.TriggerWorkflowRequest:
+    ) -> v0_workflow_protos.TriggerWorkflowRequest:
         try:
             payload_data = json.dumps(input)
-            _options = options.model_dump()
-
-            _options.pop("namespace")
-
-            try:
-                _options = {
-                    **_options,
-                    "additional_metadata": json.dumps(
-                        options.additional_metadata
-                    ).encode("utf-8"),
-                }
-            except json.JSONDecodeError as e:
-                raise ValueError(f"Error encoding payload: {e}")
-
-            return workflow_protos.TriggerWorkflowRequest(
-                name=workflow_name, input=payload_data, **_options
-            )
         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.CreateWorkflowVersionOpts,
-        overrides: workflow_protos.CreateWorkflowVersionOpts | None = None,
-    ) -> workflow_protos.PutWorkflowRequest:
+        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_protos.PutWorkflowRequest(
-            opts=workflow,
-        )
+        return workflow
 
     def _parse_schedule(
         self, schedule: datetime | timestamp_pb2.Timestamp
@@ -134,51 +148,21 @@ class AdminClient:
         schedules: list[Union[datetime, timestamp_pb2.Timestamp]],
         input: JSONSerializableMapping = {},
         options: ScheduleTriggerWorkflowOptions = ScheduleTriggerWorkflowOptions(),
-    ) -> workflow_protos.ScheduleWorkflowRequest:
-        return workflow_protos.ScheduleWorkflowRequest(
+    ) -> 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(),
         )
 
-    ## 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.
-        if not self.pooled_workflow_listener:
-            self.pooled_workflow_listener = PooledWorkflowRunListener(self.config)
-
-        return await asyncio.to_thread(self.run_workflow, workflow_name, input, options)
-
-    @tenacity_retry
-    async def aio_run_workflows(
-        self,
-        workflows: list[WorkflowRunDict],
-        options: TriggerWorkflowOptions = TriggerWorkflowOptions(),
-    ) -> 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)
-
-        return await asyncio.to_thread(self.run_workflows, workflows, options)
-
     @tenacity_retry
     async def aio_put_workflow(
         self,
         name: str,
-        workflow: workflow_protos.CreateWorkflowVersionOpts,
-        overrides: workflow_protos.CreateWorkflowVersionOpts | None = None,
-    ) -> workflow_protos.WorkflowVersion:
+        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.
@@ -209,7 +193,7 @@ class AdminClient:
         schedules: list[Union[datetime, timestamp_pb2.Timestamp]],
         input: JSONSerializableMapping = {},
         options: ScheduleTriggerWorkflowOptions = ScheduleTriggerWorkflowOptions(),
-    ) -> workflow_protos.WorkflowVersion:
+    ) -> 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.
@@ -224,18 +208,19 @@ class AdminClient:
     def put_workflow(
         self,
         name: str,
-        workflow: workflow_protos.CreateWorkflowVersionOpts,
-        overrides: workflow_protos.CreateWorkflowVersionOpts | None = None,
-    ) -> workflow_protos.WorkflowVersion:
+        workflow: workflow_protos.CreateWorkflowVersionRequest,
+        overrides: workflow_protos.CreateWorkflowVersionRequest | None = None,
+    ) -> workflow_protos.CreateWorkflowVersionResponse:
         opts = self._prepare_put_workflow_request(name, workflow, overrides)
 
-        resp: workflow_protos.WorkflowVersion = self.client.PutWorkflow(
-            opts,
-            metadata=get_metadata(self.token),
+        return cast(
+            workflow_protos.CreateWorkflowVersionResponse,
+            self.client.PutWorkflow(
+                opts,
+                metadata=get_metadata(self.token),
+            ),
         )
 
-        return resp
-
     @tenacity_retry
     def put_rate_limit(
         self,
@@ -246,11 +231,12 @@ class AdminClient:
         duration_proto = convert_python_enum_to_proto(
             duration, workflow_protos.RateLimitDuration
         )
-        self.client.PutRateLimit(
-            workflow_protos.PutRateLimitRequest(
+
+        self.v0_client.PutRateLimit(
+            v0_workflow_protos.PutRateLimitRequest(
                 key=key,
                 limit=limit,
-                duration=maybe_int_to_str(duration_proto),
+                duration=duration_proto,  # type: ignore[arg-type]
             ),
             metadata=get_metadata(self.token),
         )
@@ -262,7 +248,7 @@ class AdminClient:
         schedules: list[Union[datetime, timestamp_pb2.Timestamp]],
         input: JSONSerializableMapping = {},
         options: ScheduleTriggerWorkflowOptions = ScheduleTriggerWorkflowOptions(),
-    ) -> workflow_protos.WorkflowVersion:
+    ) -> v0_workflow_protos.WorkflowVersion:
         try:
             namespace = options.namespace or self.namespace
 
@@ -274,8 +260,8 @@ class AdminClient:
             )
 
             return cast(
-                workflow_protos.WorkflowVersion,
-                self.client.ScheduleWorkflow(
+                v0_workflow_protos.WorkflowVersion,
+                self.v0_client.ScheduleWorkflow(
                     request,
                     metadata=get_metadata(self.token),
                 ),
@@ -286,6 +272,44 @@ class AdminClient:
 
             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(
@@ -294,70 +318,125 @@ class AdminClient:
         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:
-            if not self.pooled_workflow_listener:
-                self.pooled_workflow_listener = PooledWorkflowRunListener(self.config)
+            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())
 
-            namespace = options.namespace or self.namespace
+        return WorkflowRunRef(
+            workflow_run_id=resp.workflow_run_id,
+            workflow_listener=self.pooled_workflow_listener,
+            workflow_run_event_listener=self.listener_client,
+        )
 
-            if namespace != "" and not workflow_name.startswith(self.namespace):
-                workflow_name = f"{namespace}{workflow_name}"
+    ## 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)
 
-            request = self._prepare_workflow_request(workflow_name, input, options)
+        if not self.pooled_workflow_listener:
+            self.pooled_workflow_listener = PooledWorkflowRunListener(self.config)
 
+        try:
             resp = cast(
-                workflow_protos.TriggerWorkflowResponse,
-                self.client.TriggerWorkflow(
+                v0_workflow_protos.TriggerWorkflowResponse,
+                self.v0_client.TriggerWorkflow(
                     request,
                     metadata=get_metadata(self.token),
                 ),
             )
-
-            return WorkflowRunRef(
-                workflow_run_id=resp.workflow_run_id,
-                workflow_listener=self.pooled_workflow_listener,
-                workflow_run_event_listener=self.listener_client,
-            )
         except (grpc.RpcError, grpc.aio.AioRpcError) as e:
             if e.code() == grpc.StatusCode.ALREADY_EXISTS:
                 raise DedupeViolationErr(e.details())
 
             raise e
 
-    def _prepare_workflow_run_request(
-        self, workflow: WorkflowRunDict, options: TriggerWorkflowOptions
-    ) -> workflow_protos.TriggerWorkflowRequest:
-        workflow_name = workflow.workflow_name
-        input_data = workflow.input
-        options = workflow.options
-
-        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_data, options)
+        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[WorkflowRunDict],
-        options: TriggerWorkflowOptions = TriggerWorkflowOptions(),
+        workflows: list[WorkflowRunTriggerConfig],
     ) -> list[WorkflowRunRef]:
         if not self.pooled_workflow_listener:
             self.pooled_workflow_listener = PooledWorkflowRunListener(self.config)
 
-        bulk_request = workflow_protos.BulkTriggerWorkflowRequest(
+        bulk_request = v0_workflow_protos.BulkTriggerWorkflowRequest(
             workflows=[
-                self._prepare_workflow_run_request(workflow, options)
+                self._create_workflow_run_request(
+                    workflow.workflow_name, workflow.input, workflow.options
+                )
                 for workflow in workflows
             ]
         )
 
         resp = cast(
-            workflow_protos.BulkTriggerWorkflowResponse,
-            self.client.BulkTriggerWorkflow(
+            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),
             ),