dex-python-sdk 0.3.1__tar.gz → 0.4.0__tar.gz

{dex_python_sdk-0.3.1 → dex_python_sdk-0.4.0}/LEGACY_NOTICES.md

@@ -1,6 +1,6 @@
 # Legacy and third-party notices
 
-The Super Durable Source License 1.0 applies only to material owned or
+The Sustainable Use License 1.0 applies only to material owned or
 licensable by Super Durable, Inc. It does not replace the licenses below.
 
 ## Legacy cutoff
@@ -57,5 +57,5 @@ or translations of the `indeedeng/iwf-java-sdk` integration suite at commit
 - `sdk-typescript/test/integ/`
 
 The upstream portions remain licensed under the Apache License 2.0. Super
-Durable modifications are licensed under the Super Durable Source License 1.0.
+Durable modifications are licensed under the Sustainable Use License 1.0.
 The Apache License 2.0 text is in `LICENSES/Apache-2.0.txt`.

dex_python_sdk-0.4.0/LICENSE

@@ -0,0 +1,105 @@
+# License
+
+Copyright (c) 2026 Super Durable, Inc.
+
+Portions of this software are licensed as follows:
+
+- Legacy Materials remain under their original licenses as described in
+  `LEGACY_NOTICES.md`.
+- Third-Party Materials remain under the licenses provided by their owners.
+- The `docs/` and `examples/` directories are not licensed under the
+  Sustainable Use License and retain their existing licensing status.
+- All other material owned or licensable by Super Durable, Inc. is available
+  under the Sustainable Use License below.
+
+See `LEGACY_NOTICES.md` for the applicable legacy and third-party notices.
+
+## Sustainable Use License
+
+Version 1.0
+
+### Acceptance
+
+By using the software, you agree to all of the terms and conditions below.
+
+### Copyright License
+
+The licensor grants you a non-exclusive, royalty-free, worldwide,
+non-sublicensable, non-transferable license to use, copy, distribute, make
+available, and prepare derivative works of the software, in each case subject
+to the limitations below.
+
+### Limitations
+
+You may use or modify the software only for your own internal business purposes
+or for non-commercial or personal use. You may distribute the software or
+provide it to others only if you do so free of charge for non-commercial
+purposes. You may not alter, remove, or obscure any licensing, copyright, or
+other notices of the licensor in the software. Any use of the licensor's
+trademarks is subject to applicable law.
+
+### Patents
+
+The licensor grants you a license, under any patent claims the licensor can
+license, or becomes able to license, to make, have made, use, sell, offer for
+sale, import and have imported the software, in each case subject to the
+limitations and conditions in this license. This license does not cover any
+patent claims that you cause to be infringed by modifications or additions to
+the software.
+
+If you or your company make any written claim that the software infringes or
+contributes to infringement of any patent, your patent license for the software
+granted under these terms ends immediately. If your company makes such a claim,
+your patent license ends immediately for work on behalf of your company.
+
+### Notices
+
+You must ensure that anyone who gets a copy of any part of the software from
+you also gets a copy of these terms. If you modify the software, you must
+include in any modified copies of the software a prominent notice stating that
+you have modified the software.
+
+### No Other Rights
+
+These terms do not imply any licenses other than those expressly granted in
+these terms.
+
+### Termination
+
+If you use the software in violation of these terms, such use is not licensed,
+and your license will automatically terminate. If the licensor provides you
+with a notice of your violation, and you cease all violation of this license no
+later than 30 days after you receive that notice, your license will be
+reinstated retroactively. However, if you violate these terms after such
+reinstatement, any additional violation of these terms will cause your license
+to terminate automatically and permanently.
+
+### No Liability
+
+As far as the law allows, the software comes as is, without any warranty or
+condition, and the licensor will not be liable to you for any damages arising
+out of these terms or the use or nature of the software, under any kind of
+legal claim.
+
+### Definitions
+
+The "licensor" is the entity offering these terms.
+
+The "software" is the software the licensor makes available under these terms,
+including any portion of it.
+
+"You" refers to the individual or entity agreeing to these terms.
+
+"Your company" is any legal entity, sole proprietorship, or other kind of
+organization that you work for, plus all organizations that have control over,
+are under the control of, or are under common control with that organization.
+Control means ownership of substantially all the assets of an entity, or the
+power to direct its management and policies by vote, contract, or otherwise.
+Control can be direct or indirect.
+
+"Your license" is the license granted to you for the software under these
+terms.
+
+"Use" means anything you do with the software requiring your license.
+
+"Trademark" means trademarks, service marks, and similar rights.

dex_python_sdk-0.3.1/README.md → dex_python_sdk-0.4.0/PKG-INFO

@@ -1,3 +1,19 @@
+Metadata-Version: 2.4
+Name: dex-python-sdk
+Version: 0.4.0
+Requires-Dist: grpcio>=1.83.0
+Requires-Dist: grpcio-status>=1.83.0
+Requires-Dist: protobuf>=7.35.1
+License-File: LICENSE
+License-File: LEGACY_NOTICES.md
+Summary: Python SDK for the Dex workflow engine
+Author: Super Durable
+License-Expression: LicenseRef-Sustainable-Use-1.0
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
+Project-URL: Homepage, https://github.com/superdurable/dex/tree/main/sdk-python
+Project-URL: Repository, https://github.com/superdurable/dex
+
 
 # Dex SDK for Python
 
@@ -43,6 +59,29 @@ atomic commit and Channel deletion validation. Attribute locks add isolation
 only among cooperating Steps and RPCs using the same lock. Write-only publish
 and delete operations do not require loading.
 
+## Step and timeout-handler state loading
+
+`StepOptions` provides the same five selections independently for `wait_for` and
+`execute`: all AttributeMap instances, exact AttributeMap instances, Channels,
+all ChannelMap instances, and exact ChannelMap instances. The methods receive
+independent snapshots. Execute reads after the winning Wait consumes messages;
+retries of one logical method call reuse its first snapshot.
+
+`FlowTimeoutHandlerOptions` provides Execute-style timeouts, heartbeat detection,
+retry, durability, Attribute locks, and the same state selections. Set it on
+`StartFlowOptions` or `SubFlowOptions` only for a positive timeout using `HANDLER`.
+Exhausted retries may proceed to a registered `Step[None]`; read the final
+failure from `Context.recovery_error`.
+
+```python
+class TimeoutRecoveryStep(Step[None]):
+    def execute(self, context: Context, input: None) -> StepDecision:
+        failure = context.recovery_error
+        if failure is None:
+            return force_fail("timeout recovery has no failure")
+        return force_fail(failure.detail)
+```
+
 Python SDK for [Dex workflow engine](https://github.com/superdurable/dex)
 
 ## New user contracts
@@ -304,9 +343,11 @@ non-empty user ID; the same Condition instance may appear in multiple
 combinations.
 
 Both `Client` and `AsyncClient` provide singleton and AttributeMap-instance
-overloads of `wait_for_attribute_equal`. They target the current run and accept
-only string, bool, int, or float wire values. JSON objects, bytes, and null fail
-before transport. Every AttributeMap and ChannelMap instance must be non-empty
+overloads of `wait_for_attribute_match`. Build matches with the six
+`AttributeMatch` factories. The method targets the current run and returns the
+decoded matched value. String and bool support equality operators; int and
+float support every operator. JSON objects, bytes, null, non-finite floats, and
+invalid ordering fail before transport. Every AttributeMap and ChannelMap instance must be non-empty
 and must not contain `/`. `AttributeMap.get_map_size/get_all_instance_keys` include
 buffered sets and deletes. The matching `ChannelMap` methods are RPC-only,
 include buffered publishes, and omit empty instances. Keys are decoded and
@@ -499,5 +540,6 @@ See [CONTRIBUTING.md](../CONTRIBUTING.md#releases-monorepo-tags) for monorepo ta
 
 ## License
 
-[Super Durable Source License 1.0](LICENSE), with legacy portions under their
+[Sustainable Use License 1.0](LICENSE), with legacy portions under their
 original terms as described in [LEGACY_NOTICES.md](LEGACY_NOTICES.md).
+

dex_python_sdk-0.3.1/PKG-INFO → dex_python_sdk-0.4.0/README.md

@@ -1,19 +1,3 @@
-Metadata-Version: 2.4
-Name: dex-python-sdk
-Version: 0.3.1
-Requires-Dist: grpcio>=1.83.0
-Requires-Dist: grpcio-status>=1.83.0
-Requires-Dist: protobuf>=7.35.1
-License-File: LICENSE
-License-File: LEGACY_NOTICES.md
-Summary: Python SDK for the Dex workflow engine
-Author: Super Durable
-License-Expression: LicenseRef-Super-Durable-1.0
-Requires-Python: >=3.11
-Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
-Project-URL: Homepage, https://github.com/superdurable/dex/tree/main/sdk-python
-Project-URL: Repository, https://github.com/superdurable/dex
-
 
 # Dex SDK for Python
 
@@ -59,6 +43,29 @@ atomic commit and Channel deletion validation. Attribute locks add isolation
 only among cooperating Steps and RPCs using the same lock. Write-only publish
 and delete operations do not require loading.
 
+## Step and timeout-handler state loading
+
+`StepOptions` provides the same five selections independently for `wait_for` and
+`execute`: all AttributeMap instances, exact AttributeMap instances, Channels,
+all ChannelMap instances, and exact ChannelMap instances. The methods receive
+independent snapshots. Execute reads after the winning Wait consumes messages;
+retries of one logical method call reuse its first snapshot.
+
+`FlowTimeoutHandlerOptions` provides Execute-style timeouts, heartbeat detection,
+retry, durability, Attribute locks, and the same state selections. Set it on
+`StartFlowOptions` or `SubFlowOptions` only for a positive timeout using `HANDLER`.
+Exhausted retries may proceed to a registered `Step[None]`; read the final
+failure from `Context.recovery_error`.
+
+```python
+class TimeoutRecoveryStep(Step[None]):
+    def execute(self, context: Context, input: None) -> StepDecision:
+        failure = context.recovery_error
+        if failure is None:
+            return force_fail("timeout recovery has no failure")
+        return force_fail(failure.detail)
+```
+
 Python SDK for [Dex workflow engine](https://github.com/superdurable/dex)
 
 ## New user contracts
@@ -320,9 +327,11 @@ non-empty user ID; the same Condition instance may appear in multiple
 combinations.
 
 Both `Client` and `AsyncClient` provide singleton and AttributeMap-instance
-overloads of `wait_for_attribute_equal`. They target the current run and accept
-only string, bool, int, or float wire values. JSON objects, bytes, and null fail
-before transport. Every AttributeMap and ChannelMap instance must be non-empty
+overloads of `wait_for_attribute_match`. Build matches with the six
+`AttributeMatch` factories. The method targets the current run and returns the
+decoded matched value. String and bool support equality operators; int and
+float support every operator. JSON objects, bytes, null, non-finite floats, and
+invalid ordering fail before transport. Every AttributeMap and ChannelMap instance must be non-empty
 and must not contain `/`. `AttributeMap.get_map_size/get_all_instance_keys` include
 buffered sets and deletes. The matching `ChannelMap` methods are RPC-only,
 include buffered publishes, and omit empty instances. Keys are decoded and
@@ -515,6 +524,5 @@ See [CONTRIBUTING.md](../CONTRIBUTING.md#releases-monorepo-tags) for monorepo ta
 
 ## License
 
-[Super Durable Source License 1.0](LICENSE), with legacy portions under their
+[Sustainable Use License 1.0](LICENSE), with legacy portions under their
 original terms as described in [LEGACY_NOTICES.md](LEGACY_NOTICES.md).
-

{dex_python_sdk-0.3.1 → dex_python_sdk-0.4.0}/dex/__init__.py

@@ -4,7 +4,7 @@
 # Modifications Copyright (c) 2026 Super Durable, Inc.
 #
 # Modifications after the Legacy Cutoff are licensed under the
-# Super Durable Source License 1.0.
+# Sustainable Use License 1.0.
 # Legacy Materials remain under their original licenses.
 # See LICENSE and LEGACY_NOTICES.md.
 
@@ -19,6 +19,7 @@ from dex.attribute import (
     AttributeMapLoad,
     IndexType,
 )
+from dex.attribute_match import AttributeMatch
 from dex.blob_cache import BlobCache, BlobCacheConfig, open_blob_cache
 from dex.channel import Channel, ChannelMap, ChannelMapLoad, ChannelMessage
 from dex.client import Client
@@ -36,7 +37,7 @@ from dex.codec import (
     WireKind,
 )
 from dex.condition import ConditionCombination
-from dex.context import AsyncContext, Context
+from dex.context import AsyncContext, Context, RecoveryErrorInfo
 from dex.flow import Flow, PersistenceSchema, Registry, RPCResult, rpc
 from dex.flow_config import ActiveStepSearchMode, FlowConfig
 from dex.flow_info import (
@@ -122,6 +123,7 @@ __all__ = [
     "AttributeMap",
     "AttributeMapLoad",
     "AttributeMapNotLoadedError",
+    "AttributeMatch",
     "AsyncContext",
     "AsyncClient",
     "AsyncBufferedTextStream",
@@ -163,6 +165,7 @@ __all__ = [
     "LongPollTimeoutError",
     "PersistenceSchema",
     "RPCResult",
+    "RecoveryErrorInfo",
     "RetryAfterError",
     "RpcLockConflictError",
     "Registry",

{dex_python_sdk-0.3.1 → dex_python_sdk-0.4.0}/dex/_async_value_hydrator.py

@@ -1,10 +1,10 @@
 # Copyright (c) 2026 Super Durable, Inc.
 #
-# Licensed under the Super Durable Source License 1.0.
+# Licensed under the Sustainable Use License 1.0.
 # You may not use this file except in compliance with the License.
 # See the LICENSE file in the repository root.
 #
-# SPDX-License-Identifier: LicenseRef-Super-Durable-1.0
+# SPDX-License-Identifier: LicenseRef-Sustainable-Use-1.0
 
 from __future__ import annotations
 

{dex_python_sdk-0.3.1 → dex_python_sdk-0.4.0}/dex/_async_worker_dispatcher.py

@@ -1,10 +1,10 @@
 # Copyright (c) 2026 Super Durable, Inc.
 #
-# Licensed under the Super Durable Source License 1.0.
+# Licensed under the Sustainable Use License 1.0.
 # You may not use this file except in compliance with the License.
 # See the LICENSE file in the repository root.
 #
-# SPDX-License-Identifier: LicenseRef-Super-Durable-1.0
+# SPDX-License-Identifier: LicenseRef-Sustainable-Use-1.0
 
 from __future__ import annotations
 

{dex_python_sdk-0.3.1 → dex_python_sdk-0.4.0}/dex/_async_worker_service.py

@@ -1,10 +1,10 @@
 # Copyright (c) 2026 Super Durable, Inc.
 #
-# Licensed under the Super Durable Source License 1.0.
+# Licensed under the Sustainable Use License 1.0.
 # You may not use this file except in compliance with the License.
 # See the LICENSE file in the repository root.
 #
-# SPDX-License-Identifier: LicenseRef-Super-Durable-1.0
+# SPDX-License-Identifier: LicenseRef-Sustainable-Use-1.0
 
 from __future__ import annotations
 

{dex_python_sdk-0.3.1 → dex_python_sdk-0.4.0}/dex/_grpc_errors.py

@@ -1,10 +1,10 @@
 # Copyright (c) 2026 Super Durable, Inc.
 #
-# Licensed under the Super Durable Source License 1.0.
+# Licensed under the Sustainable Use License 1.0.
 # You may not use this file except in compliance with the License.
 # See the LICENSE file in the repository root.
 #
-# SPDX-License-Identifier: LicenseRef-Super-Durable-1.0
+# SPDX-License-Identifier: LicenseRef-Sustainable-Use-1.0
 
 from __future__ import annotations
 

{dex_python_sdk-0.3.1 → dex_python_sdk-0.4.0}/dex/_invocation_context.py

@@ -1,10 +1,10 @@
 # Copyright (c) 2026 Super Durable, Inc.
 #
-# Licensed under the Super Durable Source License 1.0.
+# Licensed under the Sustainable Use License 1.0.
 # You may not use this file except in compliance with the License.
 # See the LICENSE file in the repository root.
 #
-# SPDX-License-Identifier: LicenseRef-Super-Durable-1.0
+# SPDX-License-Identifier: LicenseRef-Sustainable-Use-1.0
 
 from __future__ import annotations
 
@@ -17,6 +17,7 @@ from dex._value_mapper import ValueMapper
 from dex.attribute import Attribute, AttributeMap, _apply_attribute_store_sync
 from dex.channel import Channel, ChannelMap, ChannelMessage
 from dex.codec import Codec
+from dex.context import RecoveryErrorInfo
 from dex.dexpb import dex_pb2 as pb
 from dex.flow import Registry, _RegisteredFlow
 from dex.flow_result import FlowResult, flow_result_from_proto
@@ -116,6 +117,15 @@ class InvocationContext:
     def from_step_execution_id(self) -> str:
         return self._metadata.from_step_execution_id
 
+    @property
+    def recovery_error(self) -> RecoveryErrorInfo | None:
+        if not self._metadata.HasField("recovery_error"):
+            return None
+        return RecoveryErrorInfo(
+            detail=self._metadata.recovery_error.detail,
+            error_type=self._metadata.recovery_error.error_type,
+        )
+
     @property
     def attempt(self) -> int:
         return self._metadata.attempt

{dex_python_sdk-0.3.1 → dex_python_sdk-0.4.0}/dex/_native.pyi

@@ -1,10 +1,10 @@
 # Copyright (c) 2026 Super Durable, Inc.
 #
-# Licensed under the Super Durable Source License 1.0.
+# Licensed under the Sustainable Use License 1.0.
 # You may not use this file except in compliance with the License.
 # See the LICENSE file in the repository root.
 #
-# SPDX-License-Identifier: LicenseRef-Super-Durable-1.0
+# SPDX-License-Identifier: LicenseRef-Sustainable-Use-1.0
 
 class NativeBlobCache:
     def __init__(

{dex_python_sdk-0.3.1 → dex_python_sdk-0.4.0}/dex/_utils.py

@@ -1,10 +1,10 @@
 # Copyright (c) 2026 Super Durable, Inc.
 #
-# Licensed under the Super Durable Source License 1.0.
+# Licensed under the Sustainable Use License 1.0.
 # You may not use this file except in compliance with the License.
 # See the LICENSE file in the repository root.
 #
-# SPDX-License-Identifier: LicenseRef-Super-Durable-1.0
+# SPDX-License-Identifier: LicenseRef-Sustainable-Use-1.0
 
 
 def require_name(name: str) -> str:

{dex_python_sdk-0.3.1 → dex_python_sdk-0.4.0}/dex/_value_hydrator.py

@@ -1,10 +1,10 @@
 # Copyright (c) 2026 Super Durable, Inc.
 #
-# Licensed under the Super Durable Source License 1.0.
+# Licensed under the Sustainable Use License 1.0.
 # You may not use this file except in compliance with the License.
 # See the LICENSE file in the repository root.
 #
-# SPDX-License-Identifier: LicenseRef-Super-Durable-1.0
+# SPDX-License-Identifier: LicenseRef-Sustainable-Use-1.0
 
 from __future__ import annotations
 

{dex_python_sdk-0.3.1 → dex_python_sdk-0.4.0}/dex/_value_mapper.py

@@ -1,10 +1,10 @@
 # Copyright (c) 2026 Super Durable, Inc.
 #
-# Licensed under the Super Durable Source License 1.0.
+# Licensed under the Sustainable Use License 1.0.
 # You may not use this file except in compliance with the License.
 # See the LICENSE file in the repository root.
 #
-# SPDX-License-Identifier: LicenseRef-Super-Durable-1.0
+# SPDX-License-Identifier: LicenseRef-Sustainable-Use-1.0
 
 from __future__ import annotations
 

{dex_python_sdk-0.3.1 → dex_python_sdk-0.4.0}/dex/_worker_dispatcher.py

@@ -1,10 +1,10 @@
 # Copyright (c) 2026 Super Durable, Inc.
 #
-# Licensed under the Super Durable Source License 1.0.
+# Licensed under the Sustainable Use License 1.0.
 # You may not use this file except in compliance with the License.
 # See the LICENSE file in the repository root.
 #
-# SPDX-License-Identifier: LicenseRef-Super-Durable-1.0
+# SPDX-License-Identifier: LicenseRef-Sustainable-Use-1.0
 
 from __future__ import annotations
 

{dex_python_sdk-0.3.1 → dex_python_sdk-0.4.0}/dex/_worker_service.py

@@ -1,10 +1,10 @@
 # Copyright (c) 2026 Super Durable, Inc.
 #
-# Licensed under the Super Durable Source License 1.0.
+# Licensed under the Sustainable Use License 1.0.
 # You may not use this file except in compliance with the License.
 # See the LICENSE file in the repository root.
 #
-# SPDX-License-Identifier: LicenseRef-Super-Durable-1.0
+# SPDX-License-Identifier: LicenseRef-Sustainable-Use-1.0
 
 from __future__ import annotations