hatchet-sdk 1.9.1__py3-none-any.whl → 1.10.0__py3-none-any.whl

hatchet_sdk/contracts/events_pb2.py

@@ -15,7 +15,7 @@ _sym_db = _symbol_database.Default()
 from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
 
 
-DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n\x0c\x65vents.proto\x1a\x1fgoogle/protobuf/timestamp.proto\"\xb4\x01\n\x05\x45vent\x12\x10\n\x08tenantId\x18\x01 \x01(\t\x12\x0f\n\x07\x65ventId\x18\x02 \x01(\t\x12\x0b\n\x03key\x18\x03 \x01(\t\x12\x0f\n\x07payload\x18\x04 \x01(\t\x12\x32\n\x0e\x65ventTimestamp\x18\x05 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x1f\n\x12\x61\x64\x64itionalMetadata\x18\x06 \x01(\tH\x00\x88\x01\x01\x42\x15\n\x13_additionalMetadata\" \n\x06\x45vents\x12\x16\n\x06\x65vents\x18\x01 \x03(\x0b\x32\x06.Event\"\x92\x01\n\rPutLogRequest\x12\x11\n\tstepRunId\x18\x01 \x01(\t\x12-\n\tcreatedAt\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x0f\n\x07message\x18\x03 \x01(\t\x12\x12\n\x05level\x18\x04 \x01(\tH\x00\x88\x01\x01\x12\x10\n\x08metadata\x18\x05 \x01(\tB\x08\n\x06_level\"\x10\n\x0ePutLogResponse\"|\n\x15PutStreamEventRequest\x12\x11\n\tstepRunId\x18\x01 \x01(\t\x12-\n\tcreatedAt\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x0f\n\x07message\x18\x03 \x01(\x0c\x12\x10\n\x08metadata\x18\x05 \x01(\t\"\x18\n\x16PutStreamEventResponse\"9\n\x14\x42ulkPushEventRequest\x12!\n\x06\x65vents\x18\x01 \x03(\x0b\x32\x11.PushEventRequest\"\x9c\x01\n\x10PushEventRequest\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\x0f\n\x07payload\x18\x02 \x01(\t\x12\x32\n\x0e\x65ventTimestamp\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x1f\n\x12\x61\x64\x64itionalMetadata\x18\x04 \x01(\tH\x00\x88\x01\x01\x42\x15\n\x13_additionalMetadata\"%\n\x12ReplayEventRequest\x12\x0f\n\x07\x65ventId\x18\x01 \x01(\t2\x88\x02\n\rEventsService\x12#\n\x04Push\x12\x11.PushEventRequest\x1a\x06.Event\"\x00\x12,\n\x08\x42ulkPush\x12\x15.BulkPushEventRequest\x1a\x07.Events\"\x00\x12\x32\n\x11ReplaySingleEvent\x12\x13.ReplayEventRequest\x1a\x06.Event\"\x00\x12+\n\x06PutLog\x12\x0e.PutLogRequest\x1a\x0f.PutLogResponse\"\x00\x12\x43\n\x0ePutStreamEvent\x12\x16.PutStreamEventRequest\x1a\x17.PutStreamEventResponse\"\x00\x42\x45ZCgithub.com/hatchet-dev/hatchet/internal/services/ingestor/contractsb\x06proto3')
+DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n\x0c\x65vents.proto\x1a\x1fgoogle/protobuf/timestamp.proto\"\xd2\x01\n\x05\x45vent\x12\x10\n\x08tenantId\x18\x01 \x01(\t\x12\x0f\n\x07\x65ventId\x18\x02 \x01(\t\x12\x0b\n\x03key\x18\x03 \x01(\t\x12\x0f\n\x07payload\x18\x04 \x01(\t\x12\x32\n\x0e\x65ventTimestamp\x18\x05 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x1f\n\x12\x61\x64\x64itionalMetadata\x18\x06 \x01(\tH\x00\x88\x01\x01\x12\x12\n\x05scope\x18\x07 \x01(\tH\x01\x88\x01\x01\x42\x15\n\x13_additionalMetadataB\x08\n\x06_scope\" \n\x06\x45vents\x12\x16\n\x06\x65vents\x18\x01 \x03(\x0b\x32\x06.Event\"\xc2\x01\n\rPutLogRequest\x12\x11\n\tstepRunId\x18\x01 \x01(\t\x12-\n\tcreatedAt\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x0f\n\x07message\x18\x03 \x01(\t\x12\x12\n\x05level\x18\x04 \x01(\tH\x00\x88\x01\x01\x12\x10\n\x08metadata\x18\x05 \x01(\t\x12\x1b\n\x0etaskRetryCount\x18\x06 \x01(\x05H\x01\x88\x01\x01\x42\x08\n\x06_levelB\x11\n\x0f_taskRetryCount\"\x10\n\x0ePutLogResponse\"|\n\x15PutStreamEventRequest\x12\x11\n\tstepRunId\x18\x01 \x01(\t\x12-\n\tcreatedAt\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x0f\n\x07message\x18\x03 \x01(\x0c\x12\x10\n\x08metadata\x18\x05 \x01(\t\"\x18\n\x16PutStreamEventResponse\"9\n\x14\x42ulkPushEventRequest\x12!\n\x06\x65vents\x18\x01 \x03(\x0b\x32\x11.PushEventRequest\"\xde\x01\n\x10PushEventRequest\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\x0f\n\x07payload\x18\x02 \x01(\t\x12\x32\n\x0e\x65ventTimestamp\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x1f\n\x12\x61\x64\x64itionalMetadata\x18\x04 \x01(\tH\x00\x88\x01\x01\x12\x15\n\x08priority\x18\x05 \x01(\x05H\x01\x88\x01\x01\x12\x12\n\x05scope\x18\x06 \x01(\tH\x02\x88\x01\x01\x42\x15\n\x13_additionalMetadataB\x0b\n\t_priorityB\x08\n\x06_scope\"%\n\x12ReplayEventRequest\x12\x0f\n\x07\x65ventId\x18\x01 \x01(\t2\x88\x02\n\rEventsService\x12#\n\x04Push\x12\x11.PushEventRequest\x1a\x06.Event\"\x00\x12,\n\x08\x42ulkPush\x12\x15.BulkPushEventRequest\x1a\x07.Events\"\x00\x12\x32\n\x11ReplaySingleEvent\x12\x13.ReplayEventRequest\x1a\x06.Event\"\x00\x12+\n\x06PutLog\x12\x0e.PutLogRequest\x1a\x0f.PutLogResponse\"\x00\x12\x43\n\x0ePutStreamEvent\x12\x16.PutStreamEventRequest\x1a\x17.PutStreamEventResponse\"\x00\x42\x45ZCgithub.com/hatchet-dev/hatchet/internal/services/ingestor/contractsb\x06proto3')
 
 _globals = globals()
 _builder.BuildMessageAndEnumDescriptors(DESCRIPTOR, _globals)
@@ -24,23 +24,23 @@ if not _descriptor._USE_C_DESCRIPTORS:
   _globals['DESCRIPTOR']._loaded_options = None
   _globals['DESCRIPTOR']._serialized_options = b'ZCgithub.com/hatchet-dev/hatchet/internal/services/ingestor/contracts'
   _globals['_EVENT']._serialized_start=50
-  _globals['_EVENT']._serialized_end=230
-  _globals['_EVENTS']._serialized_start=232
-  _globals['_EVENTS']._serialized_end=264
-  _globals['_PUTLOGREQUEST']._serialized_start=267
-  _globals['_PUTLOGREQUEST']._serialized_end=413
-  _globals['_PUTLOGRESPONSE']._serialized_start=415
-  _globals['_PUTLOGRESPONSE']._serialized_end=431
-  _globals['_PUTSTREAMEVENTREQUEST']._serialized_start=433
-  _globals['_PUTSTREAMEVENTREQUEST']._serialized_end=557
-  _globals['_PUTSTREAMEVENTRESPONSE']._serialized_start=559
-  _globals['_PUTSTREAMEVENTRESPONSE']._serialized_end=583
-  _globals['_BULKPUSHEVENTREQUEST']._serialized_start=585
-  _globals['_BULKPUSHEVENTREQUEST']._serialized_end=642
-  _globals['_PUSHEVENTREQUEST']._serialized_start=645
-  _globals['_PUSHEVENTREQUEST']._serialized_end=801
-  _globals['_REPLAYEVENTREQUEST']._serialized_start=803
-  _globals['_REPLAYEVENTREQUEST']._serialized_end=840
-  _globals['_EVENTSSERVICE']._serialized_start=843
-  _globals['_EVENTSSERVICE']._serialized_end=1107
+  _globals['_EVENT']._serialized_end=260
+  _globals['_EVENTS']._serialized_start=262
+  _globals['_EVENTS']._serialized_end=294
+  _globals['_PUTLOGREQUEST']._serialized_start=297
+  _globals['_PUTLOGREQUEST']._serialized_end=491
+  _globals['_PUTLOGRESPONSE']._serialized_start=493
+  _globals['_PUTLOGRESPONSE']._serialized_end=509
+  _globals['_PUTSTREAMEVENTREQUEST']._serialized_start=511
+  _globals['_PUTSTREAMEVENTREQUEST']._serialized_end=635
+  _globals['_PUTSTREAMEVENTRESPONSE']._serialized_start=637
+  _globals['_PUTSTREAMEVENTRESPONSE']._serialized_end=661
+  _globals['_BULKPUSHEVENTREQUEST']._serialized_start=663
+  _globals['_BULKPUSHEVENTREQUEST']._serialized_end=720
+  _globals['_PUSHEVENTREQUEST']._serialized_start=723
+  _globals['_PUSHEVENTREQUEST']._serialized_end=945
+  _globals['_REPLAYEVENTREQUEST']._serialized_start=947
+  _globals['_REPLAYEVENTREQUEST']._serialized_end=984
+  _globals['_EVENTSSERVICE']._serialized_start=987
+  _globals['_EVENTSSERVICE']._serialized_end=1251
 # @@protoc_insertion_point(module_scope)

hatchet_sdk/contracts/events_pb2.pyi

@@ -7,20 +7,22 @@ from typing import ClassVar as _ClassVar, Iterable as _Iterable, Mapping as _Map
 DESCRIPTOR: _descriptor.FileDescriptor
 
 class Event(_message.Message):
-    __slots__ = ("tenantId", "eventId", "key", "payload", "eventTimestamp", "additionalMetadata")
+    __slots__ = ("tenantId", "eventId", "key", "payload", "eventTimestamp", "additionalMetadata", "scope")
     TENANTID_FIELD_NUMBER: _ClassVar[int]
     EVENTID_FIELD_NUMBER: _ClassVar[int]
     KEY_FIELD_NUMBER: _ClassVar[int]
     PAYLOAD_FIELD_NUMBER: _ClassVar[int]
     EVENTTIMESTAMP_FIELD_NUMBER: _ClassVar[int]
     ADDITIONALMETADATA_FIELD_NUMBER: _ClassVar[int]
+    SCOPE_FIELD_NUMBER: _ClassVar[int]
     tenantId: str
     eventId: str
     key: str
     payload: str
     eventTimestamp: _timestamp_pb2.Timestamp
     additionalMetadata: str
-    def __init__(self, tenantId: _Optional[str] = ..., eventId: _Optional[str] = ..., key: _Optional[str] = ..., payload: _Optional[str] = ..., eventTimestamp: _Optional[_Union[_timestamp_pb2.Timestamp, _Mapping]] = ..., additionalMetadata: _Optional[str] = ...) -> None: ...
+    scope: str
+    def __init__(self, tenantId: _Optional[str] = ..., eventId: _Optional[str] = ..., key: _Optional[str] = ..., payload: _Optional[str] = ..., eventTimestamp: _Optional[_Union[_timestamp_pb2.Timestamp, _Mapping]] = ..., additionalMetadata: _Optional[str] = ..., scope: _Optional[str] = ...) -> None: ...
 
 class Events(_message.Message):
     __slots__ = ("events",)
@@ -29,18 +31,20 @@ class Events(_message.Message):
     def __init__(self, events: _Optional[_Iterable[_Union[Event, _Mapping]]] = ...) -> None: ...
 
 class PutLogRequest(_message.Message):
-    __slots__ = ("stepRunId", "createdAt", "message", "level", "metadata")
+    __slots__ = ("stepRunId", "createdAt", "message", "level", "metadata", "taskRetryCount")
     STEPRUNID_FIELD_NUMBER: _ClassVar[int]
     CREATEDAT_FIELD_NUMBER: _ClassVar[int]
     MESSAGE_FIELD_NUMBER: _ClassVar[int]
     LEVEL_FIELD_NUMBER: _ClassVar[int]
     METADATA_FIELD_NUMBER: _ClassVar[int]
+    TASKRETRYCOUNT_FIELD_NUMBER: _ClassVar[int]
     stepRunId: str
     createdAt: _timestamp_pb2.Timestamp
     message: str
     level: str
     metadata: str
-    def __init__(self, stepRunId: _Optional[str] = ..., createdAt: _Optional[_Union[_timestamp_pb2.Timestamp, _Mapping]] = ..., message: _Optional[str] = ..., level: _Optional[str] = ..., metadata: _Optional[str] = ...) -> None: ...
+    taskRetryCount: int
+    def __init__(self, stepRunId: _Optional[str] = ..., createdAt: _Optional[_Union[_timestamp_pb2.Timestamp, _Mapping]] = ..., message: _Optional[str] = ..., level: _Optional[str] = ..., metadata: _Optional[str] = ..., taskRetryCount: _Optional[int] = ...) -> None: ...
 
 class PutLogResponse(_message.Message):
     __slots__ = ()
@@ -69,16 +73,20 @@ class BulkPushEventRequest(_message.Message):
     def __init__(self, events: _Optional[_Iterable[_Union[PushEventRequest, _Mapping]]] = ...) -> None: ...
 
 class PushEventRequest(_message.Message):
-    __slots__ = ("key", "payload", "eventTimestamp", "additionalMetadata")
+    __slots__ = ("key", "payload", "eventTimestamp", "additionalMetadata", "priority", "scope")
     KEY_FIELD_NUMBER: _ClassVar[int]
     PAYLOAD_FIELD_NUMBER: _ClassVar[int]
     EVENTTIMESTAMP_FIELD_NUMBER: _ClassVar[int]
     ADDITIONALMETADATA_FIELD_NUMBER: _ClassVar[int]
+    PRIORITY_FIELD_NUMBER: _ClassVar[int]
+    SCOPE_FIELD_NUMBER: _ClassVar[int]
     key: str
     payload: str
     eventTimestamp: _timestamp_pb2.Timestamp
     additionalMetadata: str
-    def __init__(self, key: _Optional[str] = ..., payload: _Optional[str] = ..., eventTimestamp: _Optional[_Union[_timestamp_pb2.Timestamp, _Mapping]] = ..., additionalMetadata: _Optional[str] = ...) -> None: ...
+    priority: int
+    scope: str
+    def __init__(self, key: _Optional[str] = ..., payload: _Optional[str] = ..., eventTimestamp: _Optional[_Union[_timestamp_pb2.Timestamp, _Mapping]] = ..., additionalMetadata: _Optional[str] = ..., priority: _Optional[int] = ..., scope: _Optional[str] = ...) -> None: ...
 
 class ReplayEventRequest(_message.Message):
     __slots__ = ("eventId",)

hatchet_sdk/features/cron.py

@@ -102,7 +102,7 @@ class CronClient(BaseRestClient):
         with self.client() as client:
             return self._wra(client).cron_workflow_trigger_create(
                 tenant=self.client_config.tenant_id,
-                workflow=workflow_name,
+                workflow=self.client_config.apply_namespace(workflow_name),
                 create_cron_workflow_trigger_request=CreateCronWorkflowTriggerRequest(
                     cronName=cron_name,
                     cronExpression=validated_input.expression,

hatchet_sdk/features/filters.py

@@ -0,0 +1,181 @@
+import asyncio
+
+from hatchet_sdk.clients.rest.api.filter_api import FilterApi
+from hatchet_sdk.clients.rest.api_client import ApiClient
+from hatchet_sdk.clients.rest.models.v1_create_filter_request import (
+    V1CreateFilterRequest,
+)
+from hatchet_sdk.clients.rest.models.v1_filter import V1Filter
+from hatchet_sdk.clients.rest.models.v1_filter_list import V1FilterList
+from hatchet_sdk.clients.v1.api_client import BaseRestClient
+from hatchet_sdk.utils.typing import JSONSerializableMapping
+
+
+class FiltersClient(BaseRestClient):
+    """
+    The filters client is a client for interacting with Hatchet's filters API.
+    """
+
+    def _fa(self, client: ApiClient) -> FilterApi:
+        return FilterApi(client)
+
+    async def aio_list(
+        self,
+        limit: int | None = None,
+        offset: int | None = None,
+        workflow_id_scope_pairs: list[tuple[str, str]] | None = None,
+    ) -> V1FilterList:
+        """
+        List filters for a given tenant.
+
+        :param limit: The maximum number of filters to return.
+        :param offset: The number of filters to skip before starting to collect the result set.
+        :param workflow_id_scope_pairs: A list of tuples containing workflow IDs and scopes to filter by. The workflow id is first, then the scope is second.
+
+        :return: A list of filters matching the specified criteria.
+        """
+        return await asyncio.to_thread(
+            self.list, limit, offset, workflow_id_scope_pairs
+        )
+
+    def list(
+        self,
+        limit: int | None = None,
+        offset: int | None = None,
+        workflow_id_scope_pairs: list[tuple[str, str]] | None = None,
+    ) -> V1FilterList:
+        """
+        List filters for a given tenant.
+
+        :param limit: The maximum number of filters to return.
+        :param offset: The number of filters to skip before starting to collect the result set.
+        :param workflow_id_scope_pairs: A list of tuples containing workflow IDs and scopes to filter by. The workflow id is first, then the scope is second.
+
+        :return: A list of filters matching the specified criteria.
+        """
+        workflow_ids = (
+            [pair[0] for pair in workflow_id_scope_pairs]
+            if workflow_id_scope_pairs
+            else None
+        )
+        scopes = (
+            [pair[1] for pair in workflow_id_scope_pairs]
+            if workflow_id_scope_pairs
+            else None
+        )
+
+        with self.client() as client:
+            return self._fa(client).v1_filter_list(
+                tenant=self.tenant_id,
+                limit=limit,
+                offset=offset,
+                workflow_ids=workflow_ids,
+                scopes=scopes,
+            )
+
+    def get(
+        self,
+        filter_id: str,
+    ) -> V1Filter:
+        """
+        Get a filter by its ID.
+
+        :param filter_id: The ID of the filter to retrieve.
+
+        :return: The filter with the specified ID.
+        """
+        with self.client() as client:
+            return self._fa(client).v1_filter_get(
+                tenant=self.tenant_id,
+                v1_filter=filter_id,
+            )
+
+    async def aio_get(
+        self,
+        filter_id: str,
+    ) -> V1Filter:
+        """
+        Get a filter by its ID.
+
+        :param filter_id: The ID of the filter to retrieve.
+
+        :return: The filter with the specified ID.
+        """
+        return await asyncio.to_thread(self.get, filter_id)
+
+    def create(
+        self,
+        workflow_id: str,
+        expression: str,
+        scope: str,
+        payload: JSONSerializableMapping = {},
+    ) -> V1Filter:
+        """
+        Create a new filter.
+
+        :param workflow_id: The ID of the workflow to associate with the filter.
+        :param expression: The expression to evaluate for the filter.
+        :param scope: The scope for the filter.
+        :param payload: The payload to send with the filter.
+
+        :return: The created filter.
+        """
+        with self.client() as client:
+            return self._fa(client).v1_filter_create(
+                tenant=self.tenant_id,
+                v1_create_filter_request=V1CreateFilterRequest(
+                    workflowId=workflow_id,
+                    expression=expression,
+                    scope=scope,
+                    payload=dict(payload),
+                ),
+            )
+
+    async def aio_create(
+        self,
+        workflow_id: str,
+        expression: str,
+        scope: str,
+        payload: JSONSerializableMapping = {},
+    ) -> V1Filter:
+        """
+        Create a new filter.
+
+        :param workflow_id: The ID of the workflow to associate with the filter.
+        :param expression: The expression to evaluate for the filter.
+        :param scope: The scope for the filter.
+        :param payload: The payload to send with the filter.
+
+        :return: The created filter.
+        """
+        return await asyncio.to_thread(
+            self.create, workflow_id, expression, scope, payload
+        )
+
+    def delete(
+        self,
+        filter_id: str,
+    ) -> V1Filter:
+        """
+        Delete a filter by its ID.
+
+        :param filter_id: The ID of the filter to delete.
+        :return: The deleted filter.
+        """
+        with self.client() as client:
+            return self._fa(client).v1_filter_delete(
+                tenant=self.tenant_id,
+                v1_filter=filter_id,
+            )
+
+    async def aio_delete(
+        self,
+        filter_id: str,
+    ) -> V1Filter:
+        """
+        Delete a filter by its ID.
+
+        :param filter_id: The ID of the filter to delete.
+        :return: The deleted filter.
+        """
+        return await asyncio.to_thread(self.delete, filter_id)

hatchet_sdk/features/runs.py

@@ -141,6 +141,7 @@ class RunsClient(BaseRestClient):
         workflow_ids: list[str] | None = None,
         worker_id: str | None = None,
         parent_task_external_id: str | None = None,
+        triggering_event_external_id: str | None = None,
     ) -> V1TaskSummaryList:
         """
         List task runs according to a set of filters.
@@ -155,6 +156,7 @@ class RunsClient(BaseRestClient):
         :param workflow_ids: The workflow IDs to filter task runs by.
         :param worker_id: The worker ID to filter task runs by.
         :param parent_task_external_id: The parent task external ID to filter task runs by.
+        :param triggering_event_external_id: The event id that triggered the task run.
 
         :return: A list of task runs matching the specified filters.
         """
@@ -170,6 +172,7 @@ class RunsClient(BaseRestClient):
             workflow_ids=workflow_ids,
             worker_id=worker_id,
             parent_task_external_id=parent_task_external_id,
+            triggering_event_external_id=triggering_event_external_id,
         )
 
     def list(
@@ -184,6 +187,7 @@ class RunsClient(BaseRestClient):
         workflow_ids: list[str] | None = None,
         worker_id: str | None = None,
         parent_task_external_id: str | None = None,
+        triggering_event_external_id: str | None = None,
     ) -> V1TaskSummaryList:
         """
         List task runs according to a set of filters.
@@ -198,6 +202,7 @@ class RunsClient(BaseRestClient):
         :param workflow_ids: The workflow IDs to filter task runs by.
         :param worker_id: The worker ID to filter task runs by.
         :param parent_task_external_id: The parent task external ID to filter task runs by.
+        :param triggering_event_external_id: The event id that triggered the task run.
 
         :return: A list of task runs matching the specified filters.
         """
@@ -216,6 +221,7 @@ class RunsClient(BaseRestClient):
                 workflow_ids=workflow_ids,
                 worker_id=worker_id,
                 parent_task_external_id=parent_task_external_id,
+                triggering_event_external_id=triggering_event_external_id,
             )
 
     def create(
@@ -241,7 +247,7 @@ class RunsClient(BaseRestClient):
             return self._wra(client).v1_workflow_run_create(
                 tenant=self.client_config.tenant_id,
                 v1_trigger_workflow_run_request=V1TriggerWorkflowRunRequest(
-                    workflowName=workflow_name,
+                    workflowName=self.client_config.apply_namespace(workflow_name),
                     input=dict(input),
                     additionalMetadata=dict(additional_metadata),
                     priority=priority,

hatchet_sdk/features/scheduled.py

@@ -59,7 +59,7 @@ class ScheduledClient(BaseRestClient):
         with self.client() as client:
             return self._wra(client).scheduled_workflow_run_create(
                 tenant=self.client_config.tenant_id,
-                workflow=workflow_name,
+                workflow=self.client_config.apply_namespace(workflow_name),
                 schedule_workflow_run_request=ScheduleWorkflowRunRequest(
                     triggerAt=trigger_at,
                     input=dict(input),

hatchet_sdk/features/workflows.py

@@ -61,7 +61,7 @@ class WorkflowsClient(BaseRestClient):
                 tenant=self.client_config.tenant_id,
                 limit=limit,
                 offset=offset,
-                name=workflow_name,
+                name=self.client_config.apply_namespace(workflow_name),
             )
 
     async def aio_list(

hatchet_sdk/hatchet.py

@@ -10,6 +10,7 @@ from hatchet_sdk.clients.events import EventClient
 from hatchet_sdk.clients.listeners.run_event_listener import RunEventListenerClient
 from hatchet_sdk.config import ClientConfig
 from hatchet_sdk.features.cron import CronClient
+from hatchet_sdk.features.filters import FiltersClient
 from hatchet_sdk.features.logs import LogsClient
 from hatchet_sdk.features.metrics import MetricsClient
 from hatchet_sdk.features.rate_limits import RateLimitsClient
@@ -64,6 +65,13 @@ class Hatchet:
         """
         return self._client.cron
 
+    @property
+    def filters(self) -> FiltersClient:
+        """
+        The filters client is a client for interacting with Hatchet's filters API.
+        """
+        return self._client.filters
+
     @property
     def logs(self) -> LogsClient:
         """
@@ -285,7 +293,7 @@ class Hatchet:
     def task(
         self,
         *,
-        name: str,
+        name: str | None = None,
         description: str | None = None,
         input_validator: None = None,
         on_events: list[str] = [],
@@ -310,7 +318,7 @@ class Hatchet:
     def task(
         self,
         *,
-        name: str,
+        name: str | None = None,
         description: str | None = None,
         input_validator: Type[TWorkflowInput],
         on_events: list[str] = [],
@@ -334,7 +342,7 @@ class Hatchet:
     def task(
         self,
         *,
-        name: str,
+        name: str | None = None,
         description: str | None = None,
         input_validator: Type[TWorkflowInput] | None = None,
         on_events: list[str] = [],
@@ -398,45 +406,47 @@ class Hatchet:
         :returns: A decorator which creates a `Standalone` task object.
         """
 
-        workflow = Workflow[TWorkflowInput](
-            WorkflowConfig(
-                name=name,
-                version=version,
-                description=description,
-                on_events=on_events,
-                on_crons=on_crons,
-                sticky=sticky,
-                concurrency=concurrency,
-                default_priority=default_priority,
-                input_validator=input_validator
-                or cast(Type[TWorkflowInput], EmptyModel),
-            ),
-            self,
-        )
-
-        if isinstance(concurrency, list):
-            _concurrency = concurrency
-        elif isinstance(concurrency, ConcurrencyExpression):
-            _concurrency = [concurrency]
-        else:
-            _concurrency = []
-
-        task_wrapper = workflow.task(
-            name=name,
-            schedule_timeout=schedule_timeout,
-            execution_timeout=execution_timeout,
-            parents=[],
-            retries=retries,
-            rate_limits=rate_limits,
-            desired_worker_labels=desired_worker_labels,
-            backoff_factor=backoff_factor,
-            backoff_max_seconds=backoff_max_seconds,
-            concurrency=_concurrency,
-        )
-
         def inner(
             func: Callable[[TWorkflowInput, Context], R | CoroutineLike[R]],
         ) -> Standalone[TWorkflowInput, R]:
+            inferred_name = name or func.__name__
+
+            workflow = Workflow[TWorkflowInput](
+                WorkflowConfig(
+                    name=inferred_name,
+                    version=version,
+                    description=description,
+                    on_events=on_events,
+                    on_crons=on_crons,
+                    sticky=sticky,
+                    concurrency=concurrency,
+                    default_priority=default_priority,
+                    input_validator=input_validator
+                    or cast(Type[TWorkflowInput], EmptyModel),
+                ),
+                self,
+            )
+
+            if isinstance(concurrency, list):
+                _concurrency = concurrency
+            elif isinstance(concurrency, ConcurrencyExpression):
+                _concurrency = [concurrency]
+            else:
+                _concurrency = []
+
+            task_wrapper = workflow.task(
+                name=inferred_name,
+                schedule_timeout=schedule_timeout,
+                execution_timeout=execution_timeout,
+                parents=[],
+                retries=retries,
+                rate_limits=rate_limits,
+                desired_worker_labels=desired_worker_labels,
+                backoff_factor=backoff_factor,
+                backoff_max_seconds=backoff_max_seconds,
+                concurrency=_concurrency,
+            )
+
             created_task = task_wrapper(func)
 
             return Standalone[TWorkflowInput, R](
@@ -450,7 +460,7 @@ class Hatchet:
     def durable_task(
         self,
         *,
-        name: str,
+        name: str | None = None,
         description: str | None = None,
         input_validator: None = None,
         on_events: list[str] = [],
@@ -475,7 +485,7 @@ class Hatchet:
     def durable_task(
         self,
         *,
-        name: str,
+        name: str | None = None,
         description: str | None = None,
         input_validator: Type[TWorkflowInput],
         on_events: list[str] = [],
@@ -499,7 +509,7 @@ class Hatchet:
     def durable_task(
         self,
         *,
-        name: str,
+        name: str | None = None,
         description: str | None = None,
         input_validator: Type[TWorkflowInput] | None = None,
         on_events: list[str] = [],
@@ -563,38 +573,39 @@ class Hatchet:
         :returns: A decorator which creates a `Standalone` task object.
         """
 
-        workflow = Workflow[TWorkflowInput](
-            WorkflowConfig(
-                name=name,
-                version=version,
-                description=description,
-                on_events=on_events,
-                on_crons=on_crons,
-                sticky=sticky,
-                concurrency=concurrency,
-                input_validator=input_validator
-                or cast(Type[TWorkflowInput], EmptyModel),
-                default_priority=default_priority,
-            ),
-            self,
-        )
-
-        task_wrapper = workflow.durable_task(
-            name=name,
-            schedule_timeout=schedule_timeout,
-            execution_timeout=execution_timeout,
-            parents=[],
-            retries=retries,
-            rate_limits=rate_limits,
-            desired_worker_labels=desired_worker_labels,
-            backoff_factor=backoff_factor,
-            backoff_max_seconds=backoff_max_seconds,
-            concurrency=[concurrency] if concurrency else [],
-        )
-
         def inner(
             func: Callable[[TWorkflowInput, DurableContext], R | CoroutineLike[R]],
         ) -> Standalone[TWorkflowInput, R]:
+            inferred_name = name or func.__name__
+            workflow = Workflow[TWorkflowInput](
+                WorkflowConfig(
+                    name=inferred_name,
+                    version=version,
+                    description=description,
+                    on_events=on_events,
+                    on_crons=on_crons,
+                    sticky=sticky,
+                    concurrency=concurrency,
+                    input_validator=input_validator
+                    or cast(Type[TWorkflowInput], EmptyModel),
+                    default_priority=default_priority,
+                ),
+                self,
+            )
+
+            task_wrapper = workflow.durable_task(
+                name=inferred_name,
+                schedule_timeout=schedule_timeout,
+                execution_timeout=execution_timeout,
+                parents=[],
+                retries=retries,
+                rate_limits=rate_limits,
+                desired_worker_labels=desired_worker_labels,
+                backoff_factor=backoff_factor,
+                backoff_max_seconds=backoff_max_seconds,
+                concurrency=[concurrency] if concurrency else [],
+            )
+
             created_task = task_wrapper(func)
 
             return Standalone[TWorkflowInput, R](

hatchet_sdk/runnables/standalone.py

@@ -309,6 +309,7 @@ class Standalone(BaseWorkflow[TWorkflowInput], Generic[TWorkflowInput, R]):
         additional_metadata: dict[str, str] | None = None,
         worker_id: str | None = None,
         parent_task_external_id: str | None = None,
+        triggering_event_external_id: str | None = None,
     ) -> list[V1TaskSummary]:
         """
         List runs of the workflow.
@@ -321,6 +322,7 @@ class Standalone(BaseWorkflow[TWorkflowInput], Generic[TWorkflowInput, R]):
         :param additional_metadata: Additional metadata for filtering the runs.
         :param worker_id: The ID of the worker that ran the tasks.
         :param parent_task_external_id: The external ID of the parent task.
+        :param triggering_event_external_id: The event id that triggered the task run.
 
         :returns: A list of `V1TaskSummary` objects representing the runs of the workflow.
         """
@@ -343,6 +345,7 @@ class Standalone(BaseWorkflow[TWorkflowInput], Generic[TWorkflowInput, R]):
             additional_metadata=additional_metadata,
             worker_id=worker_id,
             parent_task_external_id=parent_task_external_id,
+            triggering_event_external_id=triggering_event_external_id,
         )
 
         return response.rows
@@ -357,6 +360,7 @@ class Standalone(BaseWorkflow[TWorkflowInput], Generic[TWorkflowInput, R]):
         additional_metadata: dict[str, str] | None = None,
         worker_id: str | None = None,
         parent_task_external_id: str | None = None,
+        triggering_event_external_id: str | None = None,
     ) -> list[V1TaskSummary]:
         """
         List runs of the workflow.
@@ -369,6 +373,7 @@ class Standalone(BaseWorkflow[TWorkflowInput], Generic[TWorkflowInput, R]):
         :param additional_metadata: Additional metadata for filtering the runs.
         :param worker_id: The ID of the worker that ran the tasks.
         :param parent_task_external_id: The external ID of the parent task.
+        :param triggering_event_external_id: The event id that triggered the task run.
 
         :returns: A list of `V1TaskSummary` objects representing the runs of the workflow.
         """
@@ -382,4 +387,5 @@ class Standalone(BaseWorkflow[TWorkflowInput], Generic[TWorkflowInput, R]):
             additional_metadata=additional_metadata,
             worker_id=worker_id,
             parent_task_external_id=parent_task_external_id,
+            triggering_event_external_id=triggering_event_external_id,
         )