dex-python-sdk 1.2.1__tar.gz → 1.4.1__tar.gz

{dex_python_sdk-1.2.1 → dex_python_sdk-1.4.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dex-python-sdk
-Version: 1.2.1
+Version: 1.4.1
 Requires-Dist: grpcio>=1.83.0
 Requires-Dist: grpcio-status>=1.83.0
 Requires-Dist: protobuf>=7.35.1
@@ -444,12 +444,22 @@ Client calls raise concrete `DexServiceError` subclasses. Existing-Flow reads
 (`describe_flow`, `wait_for_flow`, and `time_travel`) raise
 `FlowNotFoundError` when the Flow does not exist. Mutations, RPCs, timer/Step
 waits, config updates, and continue-as-new triggers raise
-`FlowNotActiveError` when no running Flow can accept the operation.
+`FlowNotActiveOrNotFoundError` when no running Flow can accept the operation.
+
+RPCs also use this error when the target Flow cannot be found, including query-only
+reads. A query-only RPC without locks, transactional execution, durable effects, or
+Server-forced Update routing can read a retained terminal execution. At that confirmed
+read boundary, this error means no readable target was found; return the application's
+missing or unavailable result directly, without a lifecycle probe, a short timeout, a
+retry, or historical Step-output decoding. Preserve other service and Worker failures.
+For mutations and active-only RPCs, the error can mean either missing or closed and does
+not prove that the requested action succeeded. RPC success does not prove that the Flow
+is active.
 
 ```python
 try:
     client.invoke_rpc(orders.update_order, order_id, update)
-except dex.FlowNotActiveError:
+except dex.FlowNotActiveOrNotFoundError:
     # The Flow is missing or already closed.
     pass
 ```

{dex_python_sdk-1.2.1 → dex_python_sdk-1.4.1}/README.md

@@ -428,12 +428,22 @@ Client calls raise concrete `DexServiceError` subclasses. Existing-Flow reads
 (`describe_flow`, `wait_for_flow`, and `time_travel`) raise
 `FlowNotFoundError` when the Flow does not exist. Mutations, RPCs, timer/Step
 waits, config updates, and continue-as-new triggers raise
-`FlowNotActiveError` when no running Flow can accept the operation.
+`FlowNotActiveOrNotFoundError` when no running Flow can accept the operation.
+
+RPCs also use this error when the target Flow cannot be found, including query-only
+reads. A query-only RPC without locks, transactional execution, durable effects, or
+Server-forced Update routing can read a retained terminal execution. At that confirmed
+read boundary, this error means no readable target was found; return the application's
+missing or unavailable result directly, without a lifecycle probe, a short timeout, a
+retry, or historical Step-output decoding. Preserve other service and Worker failures.
+For mutations and active-only RPCs, the error can mean either missing or closed and does
+not prove that the requested action succeeded. RPC success does not prove that the Flow
+is active.
 
 ```python
 try:
     client.invoke_rpc(orders.update_order, order_id, update)
-except dex.FlowNotActiveError:
+except dex.FlowNotActiveOrNotFoundError:
     # The Flow is missing or already closed.
     pass
 ```

{dex_python_sdk-1.2.1 → dex_python_sdk-1.4.1}/dex/_invocation_context.py

@@ -8,6 +8,7 @@
 
 from __future__ import annotations
 
+from datetime import UTC, datetime
 from enum import Enum
 from typing import Any, Callable, Protocol, Sequence, TypeVar, cast
 from urllib.parse import unquote
@@ -126,6 +127,10 @@ class InvocationContext:
             error_type=self._metadata.recovery_error.error_type,
         )
 
+    @property
+    def first_attempt_at(self) -> datetime:
+        return datetime.fromtimestamp(self._metadata.first_attempt_timestamp, UTC)
+
     @property
     def attempt(self) -> int:
         return self._metadata.attempt

{dex_python_sdk-1.2.1 → dex_python_sdk-1.4.1}/dex/context.py

@@ -11,6 +11,7 @@
 from __future__ import annotations
 
 from dataclasses import dataclass
+from datetime import datetime
 from typing import TYPE_CHECKING, Any, Protocol, Sequence, TypeVar
 
 if TYPE_CHECKING:
@@ -95,6 +96,18 @@ class Context(Protocol):
         """
         ...
 
+    @property
+    def first_attempt_at(self) -> datetime:
+        """Return when the first attempt of this handler invocation started.
+
+        The value is stable across retries of the same invocation, so a handler
+        can derive a deadline that a retry does not reset.
+
+        Returns:
+            A timezone-aware UTC time with one-second precision.
+        """
+        ...
+
     @property
     def attempt(self) -> int:
         """Return the one-based handler retry attempt.

{dex_python_sdk-1.2.1 → dex_python_sdk-1.4.1}/pyproject.toml

@@ -1,7 +1,7 @@
 [project]
 name = "dex-python-sdk"
 # Publish uses tag sdk-python/v*; CI stamps this for release builds.
-version = "1.2.1"
+version = "1.4.1"
 description = "Python SDK for the Dex workflow engine"
 authors = [{name = "Super Durable"}]
 readme = "README.md"