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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dex-python-sdk
-Version: 1.0.0
+Version: 1.2.1
 Requires-Dist: grpcio>=1.83.0
 Requires-Dist: grpcio-status>=1.83.0
 Requires-Dist: protobuf>=7.35.1
@@ -606,3 +606,12 @@ It does not affect protocol compatibility.
 [Sustainable Use License 1.0](LICENSE), with legacy portions under their
 original terms as described in [LEGACY_NOTICES.md](LEGACY_NOTICES.md).
 
+## Search run inclusion
+
+Dex Server excludes ContinuedAsNew runs by default. Application queries still
+need `FlowType` when using shared index slots. An explicit inclusion option
+removes only the default exclusion; it does not override query filters. Keep
+the query, inclusion option, and page size consistent across pages.
+
+Pass keyword-only `include_continued_as_new=True` to synchronous or asynchronous `search_flows` for execution-chain inspection. The default is `False`.
+

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

@@ -589,3 +589,12 @@ It does not affect protocol compatibility.
 
 [Sustainable Use License 1.0](LICENSE), with legacy portions under their
 original terms as described in [LEGACY_NOTICES.md](LEGACY_NOTICES.md).
+
+## Search run inclusion
+
+Dex Server excludes ContinuedAsNew runs by default. Application queries still
+need `FlowType` when using shared index slots. An explicit inclusion option
+removes only the default exclusion; it does not override query filters. Keep
+the query, inclusion option, and page size consistent across pages.
+
+Pass keyword-only `include_continued_as_new=True` to synchronous or asynchronous `search_flows` for execution-chain inspection. The default is `False`.

{dex_python_sdk-1.0.0 → dex_python_sdk-1.2.1}/dex/__init__.py

@@ -70,7 +70,7 @@ from dex.runtime_errors import (
     FlowAlreadyStartedError,
     FlowDefinitionError,
     FlowErrorType,
-    FlowNotActiveError,
+    FlowNotActiveOrNotFoundError,
     FlowNotFoundError,
     InvalidStepResultError,
     LongPollTimeoutError,
@@ -156,7 +156,7 @@ __all__ = [
     "FlowErrorType",
     "FlowInfo",
     "FlowResult",
-    "FlowNotActiveError",
+    "FlowNotActiveOrNotFoundError",
     "FlowNotFoundError",
     "FlowStatus",
     "FlowTimeoutHandlerOptions",

{dex_python_sdk-1.0.0 → dex_python_sdk-1.2.1}/dex/_grpc_errors.py

@@ -23,7 +23,7 @@ from dex.runtime_errors import (
     DexServiceError,
     ErrorSubStatus,
     FlowAlreadyStartedError,
-    FlowNotActiveError,
+    FlowNotActiveOrNotFoundError,
     FlowNotFoundError,
     LongPollTimeoutError,
     RequestTimeoutError,
@@ -129,7 +129,7 @@ def translate_rpc_error(
         if requirement == "existing":
             return FlowNotFoundError(*parameters)
         if requirement == "active":
-            return FlowNotActiveError(*parameters)
+            return FlowNotActiveOrNotFoundError(*parameters)
         return DexServiceError(*parameters)
     if sub_status is ErrorSubStatus.WORKER_API_ERROR:
         if code is grpc.StatusCode.ABORTED:

{dex_python_sdk-1.0.0 → dex_python_sdk-1.2.1}/dex/async_client.py

@@ -283,8 +283,9 @@ class AsyncClient:
             RpcLockConflictError: If Attribute locks cannot be acquired.
             WorkerInvocationError: If the application handler fails.
             ValueMappingError: If input or output mapping fails.
-            DexServiceError: If the selected path requires an active execution or the
-                service call otherwise fails.
+            FlowNotActiveOrNotFoundError: If the Flow is missing or the selected path
+                cannot use its closed execution.
+            DexServiceError: If the service call otherwise fails.
         """
         registered_flow, rpc = self.registry._rpc_for_method(rpc_method)
         (
@@ -566,7 +567,7 @@ class AsyncClient:
             options: Stop mode and optional recorded reason.
 
         Raises:
-            FlowNotActiveError: If no active run exists.
+            FlowNotActiveOrNotFoundError: If no active run exists.
             DexServiceError: If FlowService rejects or cannot perform the request.
         """
         await self._call(
@@ -621,6 +622,8 @@ class AsyncClient:
         query: str,
         page_size: int,
         next_page_token: str = "",
+        *,
+        include_continued_as_new: bool = False,
     ) -> SearchFlowsPage:
         """Return one page of Flow runs matching a visibility query.
 
@@ -628,6 +631,7 @@ class AsyncClient:
             query: A Dex visibility query; an empty string uses server defaults.
             page_size: The non-negative maximum result count requested.
             next_page_token: Opaque token from the preceding page, or ``""`` first.
+            include_continued_as_new: Include earlier runs without overriding query filters.
 
         Returns:
             Server-ordered entries with hydrated indexed Attributes and a next token.
@@ -647,6 +651,7 @@ class AsyncClient:
                     query=query,
                     page_size=page_size,
                     next_page_token=next_page_token,
+                    include_continued_as_new=include_continued_as_new,
                 ),
                 "search_flows",
                 None,
@@ -743,7 +748,7 @@ class AsyncClient:
             timer_id: Exactly one Timer condition ID or zero-based index.
 
         Raises:
-            FlowNotActiveError: If the Flow is closed.
+            FlowNotActiveOrNotFoundError: If the Flow is missing or closed.
             ValueError: If an identifier is invalid.
             DexServiceError: If FlowService cannot skip the Timer.
         """
@@ -783,7 +788,7 @@ class AsyncClient:
         Raises:
             ValueError: If the Request ID or request timeout is invalid.
             RequestTimeoutError: If a positive request timeout expires first.
-            FlowNotActiveError: If the Flow closes first.
+            FlowNotActiveOrNotFoundError: If the Flow is missing or closes first.
             DexServiceError: If FlowService cannot perform the wait.
         """
         request_budget = _ClientRequestBudget(options.request_timeout)
@@ -854,7 +859,7 @@ class AsyncClient:
         Raises:
             ValueError: If an identifier, option, or match operand is invalid.
             RequestTimeoutError: If a positive request timeout expires first.
-            FlowNotActiveError: If the Flow closes first.
+            FlowNotActiveOrNotFoundError: If the Flow is missing or closes first.
             DexServiceError: If FlowService cannot perform the wait.
         """
         ...
@@ -886,7 +891,7 @@ class AsyncClient:
         Raises:
             ValueError: If an identifier, option, or match operand is invalid.
             RequestTimeoutError: If a positive request timeout expires first.
-            FlowNotActiveError: If the Flow closes first.
+            FlowNotActiveOrNotFoundError: If the Flow is missing or closes first.
             DexServiceError: If FlowService cannot perform the wait.
         """
         ...
@@ -916,7 +921,7 @@ class AsyncClient:
             TypeError: If arguments do not match the Attribute definition.
             ValueError: If an identifier, option, or expected value is invalid.
             RequestTimeoutError: If a positive request timeout expires first.
-            FlowNotActiveError: If the Flow closes first.
+            FlowNotActiveOrNotFoundError: If the Flow is missing or closes first.
             DexServiceError: If FlowService cannot perform the wait.
         """
         instance, match, options = self._attribute_wait_arguments(
@@ -996,7 +1001,7 @@ class AsyncClient:
             config: New optional fields applied to later decisions.
 
         Raises:
-            FlowNotActiveError: If the Flow is closed.
+            FlowNotActiveOrNotFoundError: If the Flow is missing or closed.
             ValueError: If a configuration value is invalid.
             DexServiceError: If FlowService cannot apply the update.
         """
@@ -1020,7 +1025,7 @@ class AsyncClient:
             flow_id: The non-empty active Flow ID.
 
         Raises:
-            FlowNotActiveError: If the Flow is closed.
+            FlowNotActiveOrNotFoundError: If the Flow is missing or closed.
             DexServiceError: If FlowService cannot accept the request.
         """
         await self._call(

{dex_python_sdk-1.0.0 → dex_python_sdk-1.2.1}/dex/client.py

@@ -282,8 +282,9 @@ class Client:
             RpcLockConflictError: If requested Attribute locks cannot be acquired.
             WorkerInvocationError: If the application handler fails.
             ValueMappingError: If input or output mapping fails.
-            DexServiceError: If the selected path requires an active execution or the
-                service call otherwise fails.
+            FlowNotActiveOrNotFoundError: If the Flow is missing or the selected path
+                cannot use its closed execution.
+            DexServiceError: If the service call otherwise fails.
         """
         registered_flow, rpc = self.registry._rpc_for_method(rpc_method)
         (
@@ -566,7 +567,7 @@ class Client:
             options: Stop mode and optional recorded reason.
 
         Raises:
-            FlowNotActiveError: If no active run exists.
+            FlowNotActiveOrNotFoundError: If no active run exists.
             DexServiceError: If FlowService rejects or cannot perform the request.
         """
         self._call(
@@ -621,6 +622,8 @@ class Client:
         query: str,
         page_size: int,
         next_page_token: str = "",
+        *,
+        include_continued_as_new: bool = False,
     ) -> SearchFlowsPage:
         """Return one page of Flow runs matching a visibility query.
 
@@ -628,6 +631,7 @@ class Client:
             query: A Dex visibility query; an empty string matches server defaults.
             page_size: The non-negative maximum result count requested.
             next_page_token: Opaque token from the preceding page, or ``""`` first.
+            include_continued_as_new: Include earlier runs without overriding query filters.
 
         Returns:
             Server-ordered entries with hydrated indexed Attributes and a next token.
@@ -647,6 +651,7 @@ class Client:
                     query=query,
                     page_size=page_size,
                     next_page_token=next_page_token,
+                    include_continued_as_new=include_continued_as_new,
                 ),
                 "search_flows",
                 None,
@@ -741,7 +746,7 @@ class Client:
             timer_id: Exactly one Timer condition ID or zero-based index.
 
         Raises:
-            FlowNotActiveError: If the Flow is closed.
+            FlowNotActiveOrNotFoundError: If the Flow is missing or closed.
             ValueError: If an identifier is invalid.
             DexServiceError: If FlowService cannot skip the Timer.
         """
@@ -779,7 +784,7 @@ class Client:
         Raises:
             ValueError: If the Request ID or request timeout is invalid.
             RequestTimeoutError: If a positive request timeout expires first.
-            FlowNotActiveError: If the Flow closes first.
+            FlowNotActiveOrNotFoundError: If the Flow is missing or closes first.
             DexServiceError: If FlowService cannot perform the wait.
         """
         request_budget = _ClientRequestBudget(options.request_timeout)
@@ -850,7 +855,7 @@ class Client:
         Raises:
             ValueError: If an identifier, option, or match operand is invalid.
             RequestTimeoutError: If a positive request timeout expires first.
-            FlowNotActiveError: If the Flow closes first.
+            FlowNotActiveOrNotFoundError: If the Flow is missing or closes first.
             DexServiceError: If FlowService cannot perform the wait.
         """
         ...
@@ -883,7 +888,7 @@ class Client:
         Raises:
             ValueError: If an identifier, option, or match operand is invalid.
             RequestTimeoutError: If a positive request timeout expires first.
-            FlowNotActiveError: If the Flow closes first.
+            FlowNotActiveOrNotFoundError: If the Flow is missing or closes first.
             DexServiceError: If FlowService cannot perform the wait.
         """
         ...
@@ -913,7 +918,7 @@ class Client:
             TypeError: If arguments do not match the Attribute definition.
             ValueError: If an identifier, option, or expected value is invalid.
             RequestTimeoutError: If a positive request timeout expires first.
-            FlowNotActiveError: If the Flow closes first.
+            FlowNotActiveOrNotFoundError: If the Flow is missing or closes first.
             DexServiceError: If FlowService cannot perform the wait.
         """
         instance, match, options = self._attribute_wait_arguments(
@@ -996,7 +1001,7 @@ class Client:
             config: The new optional configuration fields.
 
         Raises:
-            FlowNotActiveError: If the Flow is closed.
+            FlowNotActiveOrNotFoundError: If the Flow is missing or closed.
             ValueError: If a configuration value is invalid.
             DexServiceError: If FlowService cannot apply the update.
         """
@@ -1021,7 +1026,7 @@ class Client:
             flow_id: The non-empty active Flow ID.
 
         Raises:
-            FlowNotActiveError: If the Flow is closed.
+            FlowNotActiveOrNotFoundError: If the Flow is missing or closed.
             DexServiceError: If FlowService cannot accept the request.
         """
         self._call(