hatchet-sdk 1.1.0__tar.gz → 1.2.0__tar.gz

hatchet_sdk-1.2.0/PKG-INFO

@@ -0,0 +1,109 @@
+Metadata-Version: 2.1
+Name: hatchet-sdk
+Version: 1.2.0
+Summary: 
+Author: Alexander Belanger
+Author-email: alexander@hatchet.run
+Requires-Python: >=3.10,<4.0
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Provides-Extra: otel
+Requires-Dist: aiohttp (>=3.10.5,<4.0.0)
+Requires-Dist: aiohttp-retry (>=2.8.3,<3.0.0)
+Requires-Dist: aiostream (>=0.5.2,<0.6.0)
+Requires-Dist: cel-python (>=0.2.0,<0.3.0)
+Requires-Dist: grpcio (>=1.64.1,!=1.68.*) ; python_version < "3.13"
+Requires-Dist: grpcio (>=1.69.0) ; python_version >= "3.13"
+Requires-Dist: grpcio-tools (>=1.64.1,!=1.68.*) ; python_version < "3.13"
+Requires-Dist: grpcio-tools (>=1.69.0) ; python_version >= "3.13"
+Requires-Dist: nest-asyncio (>=1.6.0,<2.0.0)
+Requires-Dist: opentelemetry-api (>=1.28.0,<2.0.0) ; extra == "otel"
+Requires-Dist: opentelemetry-distro (>=0.49b0) ; extra == "otel"
+Requires-Dist: opentelemetry-exporter-otlp (>=1.28.0,<2.0.0) ; extra == "otel"
+Requires-Dist: opentelemetry-exporter-otlp-proto-http (>=1.28.0,<2.0.0) ; extra == "otel"
+Requires-Dist: opentelemetry-instrumentation (>=0.49b0) ; extra == "otel"
+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: pytest-timeout (>=2.3.1,<3.0.0)
+Requires-Dist: python-dateutil (>=2.9.0.post0,<3.0.0)
+Requires-Dist: pyyaml (>=6.0.1,<7.0.0)
+Requires-Dist: tenacity (>=8.4.1)
+Requires-Dist: urllib3 (>=1.26.20)
+Description-Content-Type: text/markdown
+
+# Hatchet Python SDK
+
+<div align="center">
+
+[![PyPI version](https://badge.fury.io/py/hatchet-sdk.svg)](https://badge.fury.io/py/hatchet-sdk)
+[![Documentation](https://img.shields.io/badge/docs-hatchet.run-blue)](https://docs.hatchet.run)
+[![License: MIT](https://img.shields.io/badge/License-MIT-purple.svg)](https://opensource.org/licenses/MIT)
+
+</div>
+
+This is the official Python SDK for [Hatchet](https://hatchet.run), a distributed, fault-tolerant task queue. The SDK allows you to easily integrate Hatchet's task scheduling and workflow orchestration capabilities into your Python applications.
+
+## Installation
+
+Install the SDK using pip:
+
+```bash
+pip install hatchet-sdk
+```
+
+Or using poetry:
+
+```bash
+poetry add hatchet-sdk
+```
+
+## Quick Start
+
+Here's a simple example of how to use the Hatchet Python SDK:
+
+```python
+from hatchet_sdk import Context, EmptyModel, Hatchet
+
+hatchet = Hatchet(debug=True)
+
+
+@hatchet.task(name="SimpleWorkflow")
+def step1(input: EmptyModel, ctx: Context) -> None:
+    print("executed step1")
+
+
+def main() -> None:
+    worker = hatchet.worker("test-worker", slots=1, workflows=[step1])
+    worker.start()
+
+if __name__ == "__main__":
+    main()
+```
+
+## Features
+
+- 🔄 **Workflow Orchestration**: Define complex workflows with dependencies and parallel execution
+- 🔁 **Automatic Retries**: Configure retry policies for handling transient failures
+- 📊 **Observability**: Track workflow progress and monitor execution metrics
+- ⏰ **Scheduling**: Schedule workflows to run at specific times or on a recurring basis
+- 🔄 **Event-Driven**: Trigger workflows based on events in your system
+
+## Documentation
+
+For detailed documentation, examples, and best practices, visit:
+- [Hatchet Documentation](https://docs.hatchet.run)
+- [Examples](https://github.com/hatchet-dev/hatchet/tree/main/sdks/python/examples)
+
+## Contributing
+
+We welcome contributions! Please check out our [contributing guidelines](https://docs.hatchet.run/contributing) and join our [Discord community](https://discord.gg/ZMeUafwH89) for discussions and support.
+
+## License
+
+This SDK is released under the MIT License. See [LICENSE](https://github.com/hatchet-dev/hatchet/blob/main/LICENSE) for details.
+

hatchet_sdk-1.2.0/README.md

@@ -0,0 +1,70 @@
+# Hatchet Python SDK
+
+<div align="center">
+
+[![PyPI version](https://badge.fury.io/py/hatchet-sdk.svg)](https://badge.fury.io/py/hatchet-sdk)
+[![Documentation](https://img.shields.io/badge/docs-hatchet.run-blue)](https://docs.hatchet.run)
+[![License: MIT](https://img.shields.io/badge/License-MIT-purple.svg)](https://opensource.org/licenses/MIT)
+
+</div>
+
+This is the official Python SDK for [Hatchet](https://hatchet.run), a distributed, fault-tolerant task queue. The SDK allows you to easily integrate Hatchet's task scheduling and workflow orchestration capabilities into your Python applications.
+
+## Installation
+
+Install the SDK using pip:
+
+```bash
+pip install hatchet-sdk
+```
+
+Or using poetry:
+
+```bash
+poetry add hatchet-sdk
+```
+
+## Quick Start
+
+Here's a simple example of how to use the Hatchet Python SDK:
+
+```python
+from hatchet_sdk import Context, EmptyModel, Hatchet
+
+hatchet = Hatchet(debug=True)
+
+
+@hatchet.task(name="SimpleWorkflow")
+def step1(input: EmptyModel, ctx: Context) -> None:
+    print("executed step1")
+
+
+def main() -> None:
+    worker = hatchet.worker("test-worker", slots=1, workflows=[step1])
+    worker.start()
+
+if __name__ == "__main__":
+    main()
+```
+
+## Features
+
+- 🔄 **Workflow Orchestration**: Define complex workflows with dependencies and parallel execution
+- 🔁 **Automatic Retries**: Configure retry policies for handling transient failures
+- 📊 **Observability**: Track workflow progress and monitor execution metrics
+- ⏰ **Scheduling**: Schedule workflows to run at specific times or on a recurring basis
+- 🔄 **Event-Driven**: Trigger workflows based on events in your system
+
+## Documentation
+
+For detailed documentation, examples, and best practices, visit:
+- [Hatchet Documentation](https://docs.hatchet.run)
+- [Examples](https://github.com/hatchet-dev/hatchet/tree/main/sdks/python/examples)
+
+## Contributing
+
+We welcome contributions! Please check out our [contributing guidelines](https://docs.hatchet.run/contributing) and join our [Discord community](https://discord.gg/ZMeUafwH89) for discussions and support.
+
+## License
+
+This SDK is released under the MIT License. See [LICENSE](https://github.com/hatchet-dev/hatchet/blob/main/LICENSE) for details.

{hatchet_sdk-1.1.0 → hatchet_sdk-1.2.0}/hatchet_sdk/__init__.py

@@ -138,7 +138,7 @@ from hatchet_sdk.contracts.workflows_pb2 import (
 )
 from hatchet_sdk.features.runs import BulkCancelReplayOpts, RunFilter
 from hatchet_sdk.hatchet import Hatchet
-from hatchet_sdk.runnables.task import Task
+from hatchet_sdk.runnables.task import NonRetryableException, Task
 from hatchet_sdk.runnables.types import (
     ConcurrencyExpression,
     ConcurrencyLimitStrategy,
@@ -269,4 +269,5 @@ __all__ = [
     "BulkCancelReplayOpts",
     "RunFilter",
     "V1TaskStatus",
+    "NonRetryableException",
 ]

{hatchet_sdk-1.1.0 → hatchet_sdk-1.2.0}/hatchet_sdk/clients/dispatcher/dispatcher.py

@@ -76,10 +76,16 @@ class DispatcherClient:
         return ActionListener(self.config, response.workerId)
 
     async def send_step_action_event(
-        self, action: Action, event_type: StepActionEventType, payload: str
+        self,
+        action: Action,
+        event_type: StepActionEventType,
+        payload: str,
+        should_not_retry: bool,
     ) -> grpc.aio.UnaryUnaryCall[StepActionEvent, ActionEventResponse] | None:
         try:
-            return await self._try_send_step_action_event(action, event_type, payload)
+            return await self._try_send_step_action_event(
+                action, event_type, payload, should_not_retry
+            )
         except Exception as e:
             # for step action events, send a failure event when we cannot send the completed event
             if (
@@ -90,13 +96,18 @@ class DispatcherClient:
                     action,
                     STEP_EVENT_TYPE_FAILED,
                     "Failed to send finished event: " + str(e),
+                    should_not_retry=True,
                 )
 
             return None
 
     @tenacity_retry
     async def _try_send_step_action_event(
-        self, action: Action, event_type: StepActionEventType, payload: str
+        self,
+        action: Action,
+        event_type: StepActionEventType,
+        payload: str,
+        should_not_retry: bool,
     ) -> grpc.aio.UnaryUnaryCall[StepActionEvent, ActionEventResponse]:
         if not self.aio_client:
             aio_conn = new_conn(self.config, True)
@@ -116,6 +127,7 @@ class DispatcherClient:
             eventType=event_type,
             eventPayload=payload,
             retryCount=action.retry_count,
+            shouldNotRetry=should_not_retry,
         )
 
         return cast(

hatchet_sdk-1.2.0/hatchet_sdk/contracts/dispatcher_pb2.py

@@ -0,0 +1,102 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: dispatcher.proto
+# Protobuf Python Version: 5.26.1
+"""Generated protocol buffer code."""
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import descriptor_pool as _descriptor_pool
+from google.protobuf import symbol_database as _symbol_database
+from google.protobuf.internal import builder as _builder
+# @@protoc_insertion_point(imports)
+
+_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\x10\x64ispatcher.proto\x1a\x1fgoogle/protobuf/timestamp.proto\"V\n\x0cWorkerLabels\x12\x15\n\x08strValue\x18\x01 \x01(\tH\x00\x88\x01\x01\x12\x15\n\x08intValue\x18\x02 \x01(\x05H\x01\x88\x01\x01\x42\x0b\n\t_strValueB\x0b\n\t_intValue\"\xc8\x01\n\x0bRuntimeInfo\x12\x17\n\nsdkVersion\x18\x01 \x01(\tH\x00\x88\x01\x01\x12\x1c\n\x08language\x18\x02 \x01(\x0e\x32\x05.SDKSH\x01\x88\x01\x01\x12\x1c\n\x0flanguageVersion\x18\x03 \x01(\tH\x02\x88\x01\x01\x12\x0f\n\x02os\x18\x04 \x01(\tH\x03\x88\x01\x01\x12\x12\n\x05\x65xtra\x18\x05 \x01(\tH\x04\x88\x01\x01\x42\r\n\x0b_sdkVersionB\x0b\n\t_languageB\x12\n\x10_languageVersionB\x05\n\x03_osB\x08\n\x06_extra\"\xc0\x02\n\x15WorkerRegisterRequest\x12\x12\n\nworkerName\x18\x01 \x01(\t\x12\x0f\n\x07\x61\x63tions\x18\x02 \x03(\t\x12\x10\n\x08services\x18\x03 \x03(\t\x12\x14\n\x07maxRuns\x18\x04 \x01(\x05H\x00\x88\x01\x01\x12\x32\n\x06labels\x18\x05 \x03(\x0b\x32\".WorkerRegisterRequest.LabelsEntry\x12\x16\n\twebhookId\x18\x06 \x01(\tH\x01\x88\x01\x01\x12&\n\x0bruntimeInfo\x18\x07 \x01(\x0b\x32\x0c.RuntimeInfoH\x02\x88\x01\x01\x1a<\n\x0bLabelsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\x1c\n\x05value\x18\x02 \x01(\x0b\x32\r.WorkerLabels:\x02\x38\x01\x42\n\n\x08_maxRunsB\x0c\n\n_webhookIdB\x0e\n\x0c_runtimeInfo\"P\n\x16WorkerRegisterResponse\x12\x10\n\x08tenantId\x18\x01 \x01(\t\x12\x10\n\x08workerId\x18\x02 \x01(\t\x12\x12\n\nworkerName\x18\x03 \x01(\t\"\xa3\x01\n\x19UpsertWorkerLabelsRequest\x12\x10\n\x08workerId\x18\x01 \x01(\t\x12\x36\n\x06labels\x18\x02 \x03(\x0b\x32&.UpsertWorkerLabelsRequest.LabelsEntry\x1a<\n\x0bLabelsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\x1c\n\x05value\x18\x02 \x01(\x0b\x32\r.WorkerLabels:\x02\x38\x01\"@\n\x1aUpsertWorkerLabelsResponse\x12\x10\n\x08tenantId\x18\x01 \x01(\t\x12\x10\n\x08workerId\x18\x02 \x01(\t\"\x86\x04\n\x0e\x41ssignedAction\x12\x10\n\x08tenantId\x18\x01 \x01(\t\x12\x15\n\rworkflowRunId\x18\x02 \x01(\t\x12\x18\n\x10getGroupKeyRunId\x18\x03 \x01(\t\x12\r\n\x05jobId\x18\x04 \x01(\t\x12\x0f\n\x07jobName\x18\x05 \x01(\t\x12\x10\n\x08jobRunId\x18\x06 \x01(\t\x12\x0e\n\x06stepId\x18\x07 \x01(\t\x12\x11\n\tstepRunId\x18\x08 \x01(\t\x12\x10\n\x08\x61\x63tionId\x18\t \x01(\t\x12\x1f\n\nactionType\x18\n \x01(\x0e\x32\x0b.ActionType\x12\x15\n\ractionPayload\x18\x0b \x01(\t\x12\x10\n\x08stepName\x18\x0c \x01(\t\x12\x12\n\nretryCount\x18\r \x01(\x05\x12 \n\x13\x61\x64\x64itional_metadata\x18\x0e \x01(\tH\x00\x88\x01\x01\x12!\n\x14\x63hild_workflow_index\x18\x0f \x01(\x05H\x01\x88\x01\x01\x12\x1f\n\x12\x63hild_workflow_key\x18\x10 \x01(\tH\x02\x88\x01\x01\x12#\n\x16parent_workflow_run_id\x18\x11 \x01(\tH\x03\x88\x01\x01\x42\x16\n\x14_additional_metadataB\x17\n\x15_child_workflow_indexB\x15\n\x13_child_workflow_keyB\x19\n\x17_parent_workflow_run_id\"\'\n\x13WorkerListenRequest\x12\x10\n\x08workerId\x18\x01 \x01(\t\",\n\x18WorkerUnsubscribeRequest\x12\x10\n\x08workerId\x18\x01 \x01(\t\"?\n\x19WorkerUnsubscribeResponse\x12\x10\n\x08tenantId\x18\x01 \x01(\t\x12\x10\n\x08workerId\x18\x02 \x01(\t\"\xe1\x01\n\x13GroupKeyActionEvent\x12\x10\n\x08workerId\x18\x01 \x01(\t\x12\x15\n\rworkflowRunId\x18\x02 \x01(\t\x12\x18\n\x10getGroupKeyRunId\x18\x03 \x01(\t\x12\x10\n\x08\x61\x63tionId\x18\x04 \x01(\t\x12\x32\n\x0e\x65ventTimestamp\x18\x05 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12+\n\teventType\x18\x06 \x01(\x0e\x32\x18.GroupKeyActionEventType\x12\x14\n\x0c\x65ventPayload\x18\x07 \x01(\t\"\xc4\x02\n\x0fStepActionEvent\x12\x10\n\x08workerId\x18\x01 \x01(\t\x12\r\n\x05jobId\x18\x02 \x01(\t\x12\x10\n\x08jobRunId\x18\x03 \x01(\t\x12\x0e\n\x06stepId\x18\x04 \x01(\t\x12\x11\n\tstepRunId\x18\x05 \x01(\t\x12\x10\n\x08\x61\x63tionId\x18\x06 \x01(\t\x12\x32\n\x0e\x65ventTimestamp\x18\x07 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\'\n\teventType\x18\x08 \x01(\x0e\x32\x14.StepActionEventType\x12\x14\n\x0c\x65ventPayload\x18\t \x01(\t\x12\x17\n\nretryCount\x18\n \x01(\x05H\x00\x88\x01\x01\x12\x1b\n\x0eshouldNotRetry\x18\x0b \x01(\x08H\x01\x88\x01\x01\x42\r\n\x0b_retryCountB\x11\n\x0f_shouldNotRetry\"9\n\x13\x41\x63tionEventResponse\x12\x10\n\x08tenantId\x18\x01 \x01(\t\x12\x10\n\x08workerId\x18\x02 \x01(\t\"\xc0\x01\n SubscribeToWorkflowEventsRequest\x12\x1a\n\rworkflowRunId\x18\x01 \x01(\tH\x00\x88\x01\x01\x12\x1e\n\x11\x61\x64\x64itionalMetaKey\x18\x02 \x01(\tH\x01\x88\x01\x01\x12 \n\x13\x61\x64\x64itionalMetaValue\x18\x03 \x01(\tH\x02\x88\x01\x01\x42\x10\n\x0e_workflowRunIdB\x14\n\x12_additionalMetaKeyB\x16\n\x14_additionalMetaValue\"7\n\x1eSubscribeToWorkflowRunsRequest\x12\x15\n\rworkflowRunId\x18\x01 \x01(\t\"\xb2\x02\n\rWorkflowEvent\x12\x15\n\rworkflowRunId\x18\x01 \x01(\t\x12#\n\x0cresourceType\x18\x02 \x01(\x0e\x32\r.ResourceType\x12%\n\teventType\x18\x03 \x01(\x0e\x32\x12.ResourceEventType\x12\x12\n\nresourceId\x18\x04 \x01(\t\x12\x32\n\x0e\x65ventTimestamp\x18\x05 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x14\n\x0c\x65ventPayload\x18\x06 \x01(\t\x12\x0e\n\x06hangup\x18\x07 \x01(\x08\x12\x18\n\x0bstepRetries\x18\x08 \x01(\x05H\x00\x88\x01\x01\x12\x17\n\nretryCount\x18\t \x01(\x05H\x01\x88\x01\x01\x42\x0e\n\x0c_stepRetriesB\r\n\x0b_retryCount\"\xa8\x01\n\x10WorkflowRunEvent\x12\x15\n\rworkflowRunId\x18\x01 \x01(\t\x12(\n\teventType\x18\x02 \x01(\x0e\x32\x15.WorkflowRunEventType\x12\x32\n\x0e\x65ventTimestamp\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x1f\n\x07results\x18\x04 \x03(\x0b\x32\x0e.StepRunResult\"\x8a\x01\n\rStepRunResult\x12\x11\n\tstepRunId\x18\x01 \x01(\t\x12\x16\n\x0estepReadableId\x18\x02 \x01(\t\x12\x10\n\x08jobRunId\x18\x03 \x01(\t\x12\x12\n\x05\x65rror\x18\x04 \x01(\tH\x00\x88\x01\x01\x12\x13\n\x06output\x18\x05 \x01(\tH\x01\x88\x01\x01\x42\x08\n\x06_errorB\t\n\x07_output\"W\n\rOverridesData\x12\x11\n\tstepRunId\x18\x01 \x01(\t\x12\x0c\n\x04path\x18\x02 \x01(\t\x12\r\n\x05value\x18\x03 \x01(\t\x12\x16\n\x0e\x63\x61llerFilename\x18\x04 \x01(\t\"\x17\n\x15OverridesDataResponse\"U\n\x10HeartbeatRequest\x12\x10\n\x08workerId\x18\x01 \x01(\t\x12/\n\x0bheartbeatAt\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\"\x13\n\x11HeartbeatResponse\"F\n\x15RefreshTimeoutRequest\x12\x11\n\tstepRunId\x18\x01 \x01(\t\x12\x1a\n\x12incrementTimeoutBy\x18\x02 \x01(\t\"G\n\x16RefreshTimeoutResponse\x12-\n\ttimeoutAt\x18\x01 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\"\'\n\x12ReleaseSlotRequest\x12\x11\n\tstepRunId\x18\x01 \x01(\t\"\x15\n\x13ReleaseSlotResponse*7\n\x04SDKS\x12\x0b\n\x07UNKNOWN\x10\x00\x12\x06\n\x02GO\x10\x01\x12\n\n\x06PYTHON\x10\x02\x12\x0e\n\nTYPESCRIPT\x10\x03*N\n\nActionType\x12\x12\n\x0eSTART_STEP_RUN\x10\x00\x12\x13\n\x0f\x43\x41NCEL_STEP_RUN\x10\x01\x12\x17\n\x13START_GET_GROUP_KEY\x10\x02*\xa2\x01\n\x17GroupKeyActionEventType\x12 \n\x1cGROUP_KEY_EVENT_TYPE_UNKNOWN\x10\x00\x12 \n\x1cGROUP_KEY_EVENT_TYPE_STARTED\x10\x01\x12\"\n\x1eGROUP_KEY_EVENT_TYPE_COMPLETED\x10\x02\x12\x1f\n\x1bGROUP_KEY_EVENT_TYPE_FAILED\x10\x03*\xac\x01\n\x13StepActionEventType\x12\x1b\n\x17STEP_EVENT_TYPE_UNKNOWN\x10\x00\x12\x1b\n\x17STEP_EVENT_TYPE_STARTED\x10\x01\x12\x1d\n\x19STEP_EVENT_TYPE_COMPLETED\x10\x02\x12\x1a\n\x16STEP_EVENT_TYPE_FAILED\x10\x03\x12 \n\x1cSTEP_EVENT_TYPE_ACKNOWLEDGED\x10\x04*e\n\x0cResourceType\x12\x19\n\x15RESOURCE_TYPE_UNKNOWN\x10\x00\x12\x1a\n\x16RESOURCE_TYPE_STEP_RUN\x10\x01\x12\x1e\n\x1aRESOURCE_TYPE_WORKFLOW_RUN\x10\x02*\xfe\x01\n\x11ResourceEventType\x12\x1f\n\x1bRESOURCE_EVENT_TYPE_UNKNOWN\x10\x00\x12\x1f\n\x1bRESOURCE_EVENT_TYPE_STARTED\x10\x01\x12!\n\x1dRESOURCE_EVENT_TYPE_COMPLETED\x10\x02\x12\x1e\n\x1aRESOURCE_EVENT_TYPE_FAILED\x10\x03\x12!\n\x1dRESOURCE_EVENT_TYPE_CANCELLED\x10\x04\x12!\n\x1dRESOURCE_EVENT_TYPE_TIMED_OUT\x10\x05\x12\x1e\n\x1aRESOURCE_EVENT_TYPE_STREAM\x10\x06*<\n\x14WorkflowRunEventType\x12$\n WORKFLOW_RUN_EVENT_TYPE_FINISHED\x10\x00\x32\xf8\x06\n\nDispatcher\x12=\n\x08Register\x12\x16.WorkerRegisterRequest\x1a\x17.WorkerRegisterResponse\"\x00\x12\x33\n\x06Listen\x12\x14.WorkerListenRequest\x1a\x0f.AssignedAction\"\x00\x30\x01\x12\x35\n\x08ListenV2\x12\x14.WorkerListenRequest\x1a\x0f.AssignedAction\"\x00\x30\x01\x12\x34\n\tHeartbeat\x12\x11.HeartbeatRequest\x1a\x12.HeartbeatResponse\"\x00\x12R\n\x19SubscribeToWorkflowEvents\x12!.SubscribeToWorkflowEventsRequest\x1a\x0e.WorkflowEvent\"\x00\x30\x01\x12S\n\x17SubscribeToWorkflowRuns\x12\x1f.SubscribeToWorkflowRunsRequest\x1a\x11.WorkflowRunEvent\"\x00(\x01\x30\x01\x12?\n\x13SendStepActionEvent\x12\x10.StepActionEvent\x1a\x14.ActionEventResponse\"\x00\x12G\n\x17SendGroupKeyActionEvent\x12\x14.GroupKeyActionEvent\x1a\x14.ActionEventResponse\"\x00\x12<\n\x10PutOverridesData\x12\x0e.OverridesData\x1a\x16.OverridesDataResponse\"\x00\x12\x46\n\x0bUnsubscribe\x12\x19.WorkerUnsubscribeRequest\x1a\x1a.WorkerUnsubscribeResponse\"\x00\x12\x43\n\x0eRefreshTimeout\x12\x16.RefreshTimeoutRequest\x1a\x17.RefreshTimeoutResponse\"\x00\x12:\n\x0bReleaseSlot\x12\x13.ReleaseSlotRequest\x1a\x14.ReleaseSlotResponse\"\x00\x12O\n\x12UpsertWorkerLabels\x12\x1a.UpsertWorkerLabelsRequest\x1a\x1b.UpsertWorkerLabelsResponse\"\x00\x42GZEgithub.com/hatchet-dev/hatchet/internal/services/dispatcher/contractsb\x06proto3')
+
+_globals = globals()
+_builder.BuildMessageAndEnumDescriptors(DESCRIPTOR, _globals)
+_builder.BuildTopDescriptorsAndMessages(DESCRIPTOR, 'dispatcher_pb2', _globals)
+if not _descriptor._USE_C_DESCRIPTORS:
+  _globals['DESCRIPTOR']._loaded_options = None
+  _globals['DESCRIPTOR']._serialized_options = b'ZEgithub.com/hatchet-dev/hatchet/internal/services/dispatcher/contracts'
+  _globals['_WORKERREGISTERREQUEST_LABELSENTRY']._loaded_options = None
+  _globals['_WORKERREGISTERREQUEST_LABELSENTRY']._serialized_options = b'8\001'
+  _globals['_UPSERTWORKERLABELSREQUEST_LABELSENTRY']._loaded_options = None
+  _globals['_UPSERTWORKERLABELSREQUEST_LABELSENTRY']._serialized_options = b'8\001'
+  _globals['_SDKS']._serialized_start=3572
+  _globals['_SDKS']._serialized_end=3627
+  _globals['_ACTIONTYPE']._serialized_start=3629
+  _globals['_ACTIONTYPE']._serialized_end=3707
+  _globals['_GROUPKEYACTIONEVENTTYPE']._serialized_start=3710
+  _globals['_GROUPKEYACTIONEVENTTYPE']._serialized_end=3872
+  _globals['_STEPACTIONEVENTTYPE']._serialized_start=3875
+  _globals['_STEPACTIONEVENTTYPE']._serialized_end=4047
+  _globals['_RESOURCETYPE']._serialized_start=4049
+  _globals['_RESOURCETYPE']._serialized_end=4150
+  _globals['_RESOURCEEVENTTYPE']._serialized_start=4153
+  _globals['_RESOURCEEVENTTYPE']._serialized_end=4407
+  _globals['_WORKFLOWRUNEVENTTYPE']._serialized_start=4409
+  _globals['_WORKFLOWRUNEVENTTYPE']._serialized_end=4469
+  _globals['_WORKERLABELS']._serialized_start=53
+  _globals['_WORKERLABELS']._serialized_end=139
+  _globals['_RUNTIMEINFO']._serialized_start=142
+  _globals['_RUNTIMEINFO']._serialized_end=342
+  _globals['_WORKERREGISTERREQUEST']._serialized_start=345
+  _globals['_WORKERREGISTERREQUEST']._serialized_end=665
+  _globals['_WORKERREGISTERREQUEST_LABELSENTRY']._serialized_start=563
+  _globals['_WORKERREGISTERREQUEST_LABELSENTRY']._serialized_end=623
+  _globals['_WORKERREGISTERRESPONSE']._serialized_start=667
+  _globals['_WORKERREGISTERRESPONSE']._serialized_end=747
+  _globals['_UPSERTWORKERLABELSREQUEST']._serialized_start=750
+  _globals['_UPSERTWORKERLABELSREQUEST']._serialized_end=913
+  _globals['_UPSERTWORKERLABELSREQUEST_LABELSENTRY']._serialized_start=563
+  _globals['_UPSERTWORKERLABELSREQUEST_LABELSENTRY']._serialized_end=623
+  _globals['_UPSERTWORKERLABELSRESPONSE']._serialized_start=915
+  _globals['_UPSERTWORKERLABELSRESPONSE']._serialized_end=979
+  _globals['_ASSIGNEDACTION']._serialized_start=982
+  _globals['_ASSIGNEDACTION']._serialized_end=1500
+  _globals['_WORKERLISTENREQUEST']._serialized_start=1502
+  _globals['_WORKERLISTENREQUEST']._serialized_end=1541
+  _globals['_WORKERUNSUBSCRIBEREQUEST']._serialized_start=1543
+  _globals['_WORKERUNSUBSCRIBEREQUEST']._serialized_end=1587
+  _globals['_WORKERUNSUBSCRIBERESPONSE']._serialized_start=1589
+  _globals['_WORKERUNSUBSCRIBERESPONSE']._serialized_end=1652
+  _globals['_GROUPKEYACTIONEVENT']._serialized_start=1655
+  _globals['_GROUPKEYACTIONEVENT']._serialized_end=1880
+  _globals['_STEPACTIONEVENT']._serialized_start=1883
+  _globals['_STEPACTIONEVENT']._serialized_end=2207
+  _globals['_ACTIONEVENTRESPONSE']._serialized_start=2209
+  _globals['_ACTIONEVENTRESPONSE']._serialized_end=2266
+  _globals['_SUBSCRIBETOWORKFLOWEVENTSREQUEST']._serialized_start=2269
+  _globals['_SUBSCRIBETOWORKFLOWEVENTSREQUEST']._serialized_end=2461
+  _globals['_SUBSCRIBETOWORKFLOWRUNSREQUEST']._serialized_start=2463
+  _globals['_SUBSCRIBETOWORKFLOWRUNSREQUEST']._serialized_end=2518
+  _globals['_WORKFLOWEVENT']._serialized_start=2521
+  _globals['_WORKFLOWEVENT']._serialized_end=2827
+  _globals['_WORKFLOWRUNEVENT']._serialized_start=2830
+  _globals['_WORKFLOWRUNEVENT']._serialized_end=2998
+  _globals['_STEPRUNRESULT']._serialized_start=3001
+  _globals['_STEPRUNRESULT']._serialized_end=3139
+  _globals['_OVERRIDESDATA']._serialized_start=3141
+  _globals['_OVERRIDESDATA']._serialized_end=3228
+  _globals['_OVERRIDESDATARESPONSE']._serialized_start=3230
+  _globals['_OVERRIDESDATARESPONSE']._serialized_end=3253
+  _globals['_HEARTBEATREQUEST']._serialized_start=3255
+  _globals['_HEARTBEATREQUEST']._serialized_end=3340
+  _globals['_HEARTBEATRESPONSE']._serialized_start=3342
+  _globals['_HEARTBEATRESPONSE']._serialized_end=3361
+  _globals['_REFRESHTIMEOUTREQUEST']._serialized_start=3363
+  _globals['_REFRESHTIMEOUTREQUEST']._serialized_end=3433
+  _globals['_REFRESHTIMEOUTRESPONSE']._serialized_start=3435
+  _globals['_REFRESHTIMEOUTRESPONSE']._serialized_end=3506
+  _globals['_RELEASESLOTREQUEST']._serialized_start=3508
+  _globals['_RELEASESLOTREQUEST']._serialized_end=3547
+  _globals['_RELEASESLOTRESPONSE']._serialized_start=3549
+  _globals['_RELEASESLOTRESPONSE']._serialized_end=3570
+  _globals['_DISPATCHER']._serialized_start=4472
+  _globals['_DISPATCHER']._serialized_end=5360
+# @@protoc_insertion_point(module_scope)

{hatchet_sdk-1.1.0/hatchet_sdk/v0 → hatchet_sdk-1.2.0/hatchet_sdk}/contracts/dispatcher_pb2.pyi

@@ -239,7 +239,7 @@ class GroupKeyActionEvent(_message.Message):
     def __init__(self, workerId: _Optional[str] = ..., workflowRunId: _Optional[str] = ..., getGroupKeyRunId: _Optional[str] = ..., actionId: _Optional[str] = ..., eventTimestamp: _Optional[_Union[_timestamp_pb2.Timestamp, _Mapping]] = ..., eventType: _Optional[_Union[GroupKeyActionEventType, str]] = ..., eventPayload: _Optional[str] = ...) -> None: ...
 
 class StepActionEvent(_message.Message):
-    __slots__ = ("workerId", "jobId", "jobRunId", "stepId", "stepRunId", "actionId", "eventTimestamp", "eventType", "eventPayload", "retryCount")
+    __slots__ = ("workerId", "jobId", "jobRunId", "stepId", "stepRunId", "actionId", "eventTimestamp", "eventType", "eventPayload", "retryCount", "shouldNotRetry")
     WORKERID_FIELD_NUMBER: _ClassVar[int]
     JOBID_FIELD_NUMBER: _ClassVar[int]
     JOBRUNID_FIELD_NUMBER: _ClassVar[int]
@@ -250,6 +250,7 @@ class StepActionEvent(_message.Message):
     EVENTTYPE_FIELD_NUMBER: _ClassVar[int]
     EVENTPAYLOAD_FIELD_NUMBER: _ClassVar[int]
     RETRYCOUNT_FIELD_NUMBER: _ClassVar[int]
+    SHOULDNOTRETRY_FIELD_NUMBER: _ClassVar[int]
     workerId: str
     jobId: str
     jobRunId: str
@@ -260,7 +261,8 @@ class StepActionEvent(_message.Message):
     eventType: StepActionEventType
     eventPayload: str
     retryCount: int
-    def __init__(self, workerId: _Optional[str] = ..., jobId: _Optional[str] = ..., jobRunId: _Optional[str] = ..., stepId: _Optional[str] = ..., stepRunId: _Optional[str] = ..., actionId: _Optional[str] = ..., eventTimestamp: _Optional[_Union[_timestamp_pb2.Timestamp, _Mapping]] = ..., eventType: _Optional[_Union[StepActionEventType, str]] = ..., eventPayload: _Optional[str] = ..., retryCount: _Optional[int] = ...) -> None: ...
+    shouldNotRetry: bool
+    def __init__(self, workerId: _Optional[str] = ..., jobId: _Optional[str] = ..., jobRunId: _Optional[str] = ..., stepId: _Optional[str] = ..., stepRunId: _Optional[str] = ..., actionId: _Optional[str] = ..., eventTimestamp: _Optional[_Union[_timestamp_pb2.Timestamp, _Mapping]] = ..., eventType: _Optional[_Union[StepActionEventType, str]] = ..., eventPayload: _Optional[str] = ..., retryCount: _Optional[int] = ..., shouldNotRetry: bool = ...) -> None: ...
 
 class ActionEventResponse(_message.Message):
     __slots__ = ("tenantId", "workerId")

{hatchet_sdk-1.1.0 → hatchet_sdk-1.2.0}/hatchet_sdk/runnables/task.py

@@ -44,6 +44,10 @@ def fall_back_to_default(value: T, default: T, fallback_value: T) -> T:
     return fallback_value
 
 
+class NonRetryableException(Exception):
+    pass
+
+
 class Task(Generic[TWorkflowInput, R]):
     def __init__(
         self,

{hatchet_sdk-1.1.0 → hatchet_sdk-1.2.0}/hatchet_sdk/runnables/workflow.py

@@ -272,6 +272,10 @@ class BaseWorkflow(Generic[TWorkflowInput]):
     def is_durable(self) -> bool:
         return any(task.is_durable for task in self.tasks)
 
+    @property
+    def name(self) -> str:
+        return self.config.name
+
     def create_bulk_run_item(
         self,
         input: TWorkflowInput | None = None,
@@ -487,6 +491,18 @@ class Workflow(BaseWorkflow[TWorkflowInput]):
         :param backoff_max_seconds: The maximum number of seconds to allow retries with exponential backoff to continue. Default: `None`
         :type backoff_max_seconds: int | None
 
+        :param concurrency: A list of concurrency expressions for the task. Defaults to an empty list (no concurrency).
+        :type concurrency: list[ConcurrencyExpression]
+
+        :param wait_for: A list of conditions that must be met before the task can run. Defaults to an empty list (no conditions).
+        :type wait_for: list[Condition | OrGroup]
+
+        :param skip_if: A list of conditions that, if met, will cause the task to be skipped. Defaults to an empty list (no conditions).
+        :type skip_if: list[Condition | OrGroup]
+
+        :param cancel_if: A list of conditions that, if met, will cause the task to be canceled. Defaults to an empty list (no conditions).
+        :type cancel_if: list[Condition | OrGroup]
+
         :returns: A decorator which creates a `Task` object.
         :rtype: Callable[[Callable[[Type[BaseModel], Context], R]], Task[Type[BaseModel], R]]
         """
@@ -572,6 +588,18 @@ class Workflow(BaseWorkflow[TWorkflowInput]):
         :param backoff_max_seconds: The maximum number of seconds to allow retries with exponential backoff to continue. Default: `None`
         :type backoff_max_seconds: int | None
 
+        :param concurrency: A list of concurrency expressions for the task. Defaults to an empty list (no concurrency).
+        :type concurrency: list[ConcurrencyExpression]
+
+        :param wait_for: A list of conditions that must be met before the task can run. Defaults to an empty list (no conditions).
+        :type wait_for: list[Condition | OrGroup]
+
+        :param skip_if: A list of conditions that, if met, will cause the task to be skipped. Defaults to an empty list (no conditions).
+        :type skip_if: list[Condition | OrGroup]
+
+        :param cancel_if: A list of conditions that, if met, will cause the task to be canceled. Defaults to an empty list (no conditions).
+        :type cancel_if: list[Condition | OrGroup]
+
         :returns: A decorator which creates a `Task` object.
         :rtype: Callable[[Callable[[Type[BaseModel], Context], R]], Task[Type[BaseModel], R]]
         """

{hatchet_sdk-1.1.0 → hatchet_sdk-1.2.0}/hatchet_sdk/worker/action_listener_process.py

@@ -38,6 +38,7 @@ class ActionEvent:
     action: Action
     type: Any  # TODO type
     payload: str
+    should_not_retry: bool
 
 
 STOP_LOOP_TYPE = Literal["STOP_LOOP"]
@@ -190,7 +191,10 @@ class WorkerActionListenerProcess:
 
                     asyncio.create_task(
                         self.dispatcher_client.send_step_action_event(
-                            event.action, event.type, event.payload
+                            event.action,
+                            event.type,
+                            event.payload,
+                            event.should_not_retry,
                         )
                     )
                 case ActionType.CANCEL_STEP_RUN:
@@ -235,6 +239,7 @@ class WorkerActionListenerProcess:
                                 action=action,
                                 type=STEP_EVENT_TYPE_STARTED,  # TODO ack type
                                 payload="",
+                                should_not_retry=False,
                             )
                         )
                         logger.info(
@@ -255,6 +260,7 @@ class WorkerActionListenerProcess:
                                 action=action,
                                 type=GROUP_KEY_EVENT_TYPE_STARTED,  # TODO ack type
                                 payload="",
+                                should_not_retry=False,
                             )
                         )
                         logger.info(

{hatchet_sdk-1.1.0 → hatchet_sdk-1.2.0}/hatchet_sdk/worker/runner/runner.py

@@ -38,7 +38,7 @@ from hatchet_sdk.runnables.contextvars import (
     spawn_index_lock,
     workflow_spawn_indices,
 )
-from hatchet_sdk.runnables.task import Task
+from hatchet_sdk.runnables.task import NonRetryableException, Task
 from hatchet_sdk.runnables.types import R, TWorkflowInput
 from hatchet_sdk.utils.typing import WorkflowValidator
 from hatchet_sdk.worker.action_listener_process import ActionEvent
@@ -117,7 +117,9 @@ class Runner:
                 log = f"unknown action type: {action.action_type}"
                 logger.error(log)
 
-    def step_run_callback(self, action: Action) -> Callable[[asyncio.Task[Any]], None]:
+    def step_run_callback(
+        self, action: Action, action_task: "Task[TWorkflowInput, R]"
+    ) -> Callable[[asyncio.Task[Any]], None]:
         def inner_callback(task: asyncio.Task[Any]) -> None:
             self.cleanup_run_id(action.step_run_id)
 
@@ -132,12 +134,15 @@ class Runner:
             except Exception as e:
                 errored = True
 
+                should_not_retry = isinstance(e, NonRetryableException)
+
                 # This except is coming from the application itself, so we want to send that to the Hatchet instance
                 self.event_queue.put(
                     ActionEvent(
                         action=action,
                         type=STEP_EVENT_TYPE_FAILED,
                         payload=str(pretty_format_exception(f"{e}", e)),
+                        should_not_retry=should_not_retry,
                     )
                 )
 
@@ -151,6 +156,7 @@ class Runner:
                         action=action,
                         type=STEP_EVENT_TYPE_COMPLETED,
                         payload=self.serialize_output(output),
+                        should_not_retry=False,
                     )
                 )
 
@@ -181,6 +187,7 @@ class Runner:
                         action=action,
                         type=GROUP_KEY_EVENT_TYPE_FAILED,
                         payload=str(pretty_format_exception(f"{e}", e)),
+                        should_not_retry=False,
                     )
                 )
 
@@ -194,6 +201,7 @@ class Runner:
                         action=action,
                         type=GROUP_KEY_EVENT_TYPE_COMPLETED,
                         payload=self.serialize_output(output),
+                        should_not_retry=False,
                     )
                 )
 
@@ -302,7 +310,12 @@ class Runner:
 
             self.contexts[action.step_run_id] = context
             self.event_queue.put(
-                ActionEvent(action=action, type=STEP_EVENT_TYPE_STARTED, payload="")
+                ActionEvent(
+                    action=action,
+                    type=STEP_EVENT_TYPE_STARTED,
+                    payload="",
+                    should_not_retry=False,
+                )
             )
 
             loop = asyncio.get_event_loop()
@@ -312,7 +325,7 @@ class Runner:
                 )
             )
 
-            task.add_done_callback(self.step_run_callback(action))
+            task.add_done_callback(self.step_run_callback(action, action_func))
             self.tasks[action.step_run_id] = task
 
             try:
@@ -341,7 +354,10 @@ class Runner:
             # send an event that the group key run has started
             self.event_queue.put(
                 ActionEvent(
-                    action=action, type=GROUP_KEY_EVENT_TYPE_STARTED, payload=""
+                    action=action,
+                    type=GROUP_KEY_EVENT_TYPE_STARTED,
+                    payload="",
+                    should_not_retry=False,
                 )
             )
 

{hatchet_sdk-1.1.0 → hatchet_sdk-1.2.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "hatchet-sdk"
-version = "1.1.0"
+version = "1.2.0"
 description = ""
 authors = ["Alexander Belanger <alexander@hatchet.run>"]
 readme = "README.md"

hatchet_sdk-1.1.0/PKG-INFO

@@ -1,42 +0,0 @@
-Metadata-Version: 2.1
-Name: hatchet-sdk
-Version: 1.1.0
-Summary: 
-Author: Alexander Belanger
-Author-email: alexander@hatchet.run
-Requires-Python: >=3.10,<4.0
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Provides-Extra: otel
-Requires-Dist: aiohttp (>=3.10.5,<4.0.0)
-Requires-Dist: aiohttp-retry (>=2.8.3,<3.0.0)
-Requires-Dist: aiostream (>=0.5.2,<0.6.0)
-Requires-Dist: cel-python (>=0.2.0,<0.3.0)
-Requires-Dist: grpcio (>=1.64.1,!=1.68.*) ; python_version < "3.13"
-Requires-Dist: grpcio (>=1.69.0) ; python_version >= "3.13"
-Requires-Dist: grpcio-tools (>=1.64.1,!=1.68.*) ; python_version < "3.13"
-Requires-Dist: grpcio-tools (>=1.69.0) ; python_version >= "3.13"
-Requires-Dist: nest-asyncio (>=1.6.0,<2.0.0)
-Requires-Dist: opentelemetry-api (>=1.28.0,<2.0.0) ; extra == "otel"
-Requires-Dist: opentelemetry-distro (>=0.49b0) ; extra == "otel"
-Requires-Dist: opentelemetry-exporter-otlp (>=1.28.0,<2.0.0) ; extra == "otel"
-Requires-Dist: opentelemetry-exporter-otlp-proto-http (>=1.28.0,<2.0.0) ; extra == "otel"
-Requires-Dist: opentelemetry-instrumentation (>=0.49b0) ; extra == "otel"
-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: pytest-timeout (>=2.3.1,<3.0.0)
-Requires-Dist: python-dateutil (>=2.9.0.post0,<3.0.0)
-Requires-Dist: pyyaml (>=6.0.1,<7.0.0)
-Requires-Dist: tenacity (>=8.4.1)
-Requires-Dist: urllib3 (>=1.26.20)
-Description-Content-Type: text/markdown
-
-# Hatchet Python SDK
-
-This is the [Hatchet](https://hatchet.run) Python SDK. For usage, see the [docs](https://docs.hatchet.run).
-

hatchet_sdk-1.1.0/README.md

@@ -1,3 +0,0 @@
-# Hatchet Python SDK
-
-This is the [Hatchet](https://hatchet.run) Python SDK. For usage, see the [docs](https://docs.hatchet.run).