durable-workflow 2.12.1__tar.gz → 2.12.3__tar.gz

{durable_workflow-2.12.1/src/durable_workflow.egg-info → durable_workflow-2.12.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: durable-workflow
-Version: 2.12.1
+Version: 2.12.3
 Summary: Python client and worker SDK for Durable Workflow Cloud and self-hosted Server
 Author: Durable Workflow Contributors
 License-Expression: MIT
@@ -14,6 +14,9 @@ Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: 3.15
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Classifier: Typing :: Typed
 Requires-Python: >=3.10
@@ -186,6 +189,15 @@ independently of application heartbeats. Existing terminal cancellation remains
 available. See the [cancellation guide](docs/cooperative-cancellation-design.md)
 for immutable context, operation policies, shielded cleanup and recovery.
 
+A suspended replay is not a workflow exit. Python may run `finally` blocks and
+context-manager exits when disposing of that replay. The SDK discards commands
+and `ctx.logger` messages produced only by disposal; queries observe the state
+at the pending command. Actual completion, failure and cooperative cancellation
+run cleanup through the normal history, and cold replay uses its recorded
+results. Put external cleanup in an Activity rather than direct I/O in a
+finalizer, and use `ctx.cancellation_shield()` when that Activity must finish
+after cancellation. The disposal guarantees require SDK 2.12.2 or later.
+
 Both `await activity.context().heartbeat()` and synchronous
 `activity.context().heartbeat_sync()` stop at an explicit Server refusal.
 They raise `ActivityLeaseAuthorityLost` with its original `.reason` for an

{durable_workflow-2.12.1 → durable_workflow-2.12.3}/README.md

@@ -142,6 +142,15 @@ independently of application heartbeats. Existing terminal cancellation remains
 available. See the [cancellation guide](docs/cooperative-cancellation-design.md)
 for immutable context, operation policies, shielded cleanup and recovery.
 
+A suspended replay is not a workflow exit. Python may run `finally` blocks and
+context-manager exits when disposing of that replay. The SDK discards commands
+and `ctx.logger` messages produced only by disposal; queries observe the state
+at the pending command. Actual completion, failure and cooperative cancellation
+run cleanup through the normal history, and cold replay uses its recorded
+results. Put external cleanup in an Activity rather than direct I/O in a
+finalizer, and use `ctx.cancellation_shield()` when that Activity must finish
+after cancellation. The disposal guarantees require SDK 2.12.2 or later.
+
 Both `await activity.context().heartbeat()` and synchronous
 `activity.context().heartbeat_sync()` stop at an explicit Server refusal.
 They raise `ActivityLeaseAuthorityLost` with its original `.reason` for an

{durable_workflow-2.12.1 → durable_workflow-2.12.3}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "durable-workflow"
-version = "2.12.1"
+version = "2.12.3"
 description = "Python client and worker SDK for Durable Workflow Cloud and self-hosted Server"
 readme = "README.md"
 requires-python = ">=3.10"
@@ -29,6 +29,9 @@ classifiers = [
     "Programming Language :: Python :: 3.10",
     "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "Programming Language :: Python :: 3.15",
     "Topic :: Software Development :: Libraries :: Python Modules",
     "Typing :: Typed",
 ]
@@ -76,8 +79,8 @@ durable-workflow-replay-conformance = "durable_workflow.replay_conformance:main"
 durable-workflow-workflow-updates-conformance = "durable_workflow.workflow_updates_conformance:main"
 
 [tool.durable-workflow]
-product-train = "2.12.1"
-registry-version = "2.12.1"
+product-train = "2.12.3"
+registry-version = "2.12.3"
 supported-server-versions = "2.8.0"
 worker-protocol-version = "1.20"
 control-plane-version = "2"

{durable_workflow-2.12.1 → durable_workflow-2.12.3}/src/durable_workflow/_activity_process.py

@@ -24,6 +24,7 @@ from multiprocessing.process import BaseProcess
 from pathlib import Path
 from typing import Any, cast
 
+from ._failure_reporting import exception_message
 from .activity import ActivityContext, ActivityInfo, _set_context
 from .errors import ActivityCancelled, NonRetryableError
 from .interceptors import ActivityInterceptorContext, WorkerInterceptor
@@ -139,7 +140,7 @@ def _callback(directory: str, channel: socket.socket) -> None:
         except BaseException as error:
             code = getattr(error, "code", None)
             _write_payload(directory, "outcome", CallbackOutcome(failure=CallbackFailure(
-                message=str(error), failure_type=type(error).__name__,
+                message=exception_message(error), failure_type=type(error).__name__,
                 failure_class=f"{type(error).__module__}.{type(error).__qualname__}",
                 failure_code=code if isinstance(code, int) and not isinstance(code, bool) else None,
                 stack_trace=traceback.format_exc(), non_retryable=isinstance(error, NonRetryableError),

{durable_workflow-2.12.1 → durable_workflow-2.12.3}/src/durable_workflow/_failure_reporting.py

@@ -26,6 +26,12 @@ _EXCEPTION_IDENTITY = frozenset({
 })
 
 
+def exception_message(error: BaseException, *, fallback: str | None = None) -> str:
+    """Keep useful diagnostic text; blank exceptions still need a valid report."""
+    message = str(error)
+    return message if message.strip() else fallback or type(error).__name__
+
+
 def encoded_json(value: Any) -> bytes:
     """Use HTTPX's actual JSON settings, including escaping and NaN refusal."""
     return httpx.Request("POST", "https://failure.invalid", json=value).content

{durable_workflow-2.12.1 → durable_workflow-2.12.3}/src/durable_workflow/invocable.py

@@ -12,6 +12,7 @@ from datetime import datetime, timezone
 from typing import Any, cast
 
 from . import serializer
+from ._failure_reporting import exception_message
 from .errors import ActivityCancelled, NonRetryableError
 from .external_storage import ExternalPayloadCache, ExternalStorageDriver
 from .external_task_input import ExternalTaskInput, parse_external_task_input
@@ -105,7 +106,7 @@ class InvocableActivityHandler:
                 started,
                 kind="application",
                 classification="application_error",
-                message=str(exc),
+                message=exception_message(exc),
                 failure_type=type(exc).__name__,
                 stack_trace=traceback.format_exc(),
                 retryable=False,
@@ -116,7 +117,7 @@ class InvocableActivityHandler:
                 started,
                 kind="timeout",
                 classification="deadline_exceeded",
-                message=str(exc) or "Invocable activity handler exceeded its deadline.",
+                message=exception_message(exc, fallback="Invocable activity handler exceeded its deadline."),
                 failure_type=type(exc).__name__,
                 stack_trace=traceback.format_exc(),
                 timeout_type="deadline_exceeded",
@@ -140,7 +141,7 @@ class InvocableActivityHandler:
                 started,
                 kind="application",
                 classification="application_error",
-                message=str(exc),
+                message=exception_message(exc),
                 failure_type=type(exc).__name__,
                 stack_trace=traceback.format_exc(),
                 retryable=True,

{durable_workflow-2.12.1 → durable_workflow-2.12.3}/src/durable_workflow/worker.py

@@ -44,7 +44,7 @@ from ._activity_lease import activity_lease_renewal_supported, current_activity_
 from ._activity_process import CallbackFailure, CallbackInvocation, CallbackProcessLost, SupervisedCallback
 from ._cancellation_scope_history import CancellationScopeBudget, CancellationScopeDeliveryReceipt
 from ._cooperative_cancellation import CancellationRequest, read_cancellation_history
-from ._failure_reporting import REQUEST_BYTES, normalize_local_failure
+from ._failure_reporting import REQUEST_BYTES, exception_message, normalize_local_failure
 from ._prepared_local_activity import PreparedAttempt, PreparedCancellationObserved, PreparedLocalRunner
 from ._query_task_authority import QueryTaskAuthority, current_query_authority
 from ._sticky_workflow_cache import CacheKey, StickyWorkflowCache, complete_history
@@ -3240,7 +3240,7 @@ class Worker:
         except NonRetryableError as e:
             log.exception("activity failed (non-retryable)")
             await self._report_activity_task_failure(
-                task_id, attempt_id, "activity failure", message=str(e), failure_type=type(e).__name__,
+                task_id, attempt_id, "activity failure", message=exception_message(e), failure_type=type(e).__name__,
                 failure_class=_exception_class_name(e), failure_code=_exception_code(e),
                 stack_trace=traceback.format_exc(), non_retryable=True,
             )
@@ -3271,7 +3271,8 @@ class Worker:
             raise error
         log.error("activity failed", exc_info=(type(error), error, error.__traceback__))
         await self._report_activity_task_failure(
-            task_id, attempt_id, "activity failure", message=str(error), failure_type=type(error).__name__,
+            task_id, attempt_id, "activity failure", message=exception_message(error),
+            failure_type=type(error).__name__,
             failure_class=_exception_class_name(error), failure_code=_exception_code(error),
             stack_trace="".join(traceback.format_exception(type(error), error, error.__traceback__)),
         )
@@ -3573,7 +3574,7 @@ class Worker:
             )
             return "failed"
         except QueryFailed as e:
-            message = str(e)
+            message = exception_message(e)
             if "unknown query" in message:
                 reason = "rejected_unknown_query"
             elif message.startswith("workflow replay failed before query:"):
@@ -3594,7 +3595,7 @@ class Worker:
             await self._fail_query_task(
                 query_task_id,
                 attempt,
-                str(e) or "query execution failed",
+                exception_message(e, fallback="query execution failed"),
                 reason="query_rejected",
                 failure_type=type(e).__name__,
                 stack_trace=traceback.format_exc(),
@@ -3631,7 +3632,7 @@ class Worker:
             await self._fail_query_task(
                 query_task_id,
                 attempt,
-                str(e) or "query result completion was rejected by the server",
+                exception_message(e, fallback="query result completion was rejected by the server"),
                 reason=server_reason if server_reason else "query_result_completion_failed",
                 failure_type=type(e).__name__,
                 stack_trace=traceback.format_exc(),
@@ -3667,7 +3668,7 @@ class Worker:
             await self._fail_query_task(
                 query_task_id,
                 attempt,
-                str(e) or "query result completion failed",
+                exception_message(e, fallback="query result completion failed"),
                 reason="query_result_completion_failed",
                 failure_type=type(e).__name__,
                 stack_trace=traceback.format_exc(),
@@ -4075,7 +4076,7 @@ class Worker:
             return await self._reject_update_validation_task(
                 task_id,
                 attempt,
-                str(exc) or "update validator rejected the request",
+                exception_message(exc, fallback="update validator rejected the request"),
                 reason="update_validator_rejected",
                 failure_type=exc.exception_type or type(exc).__name__,
                 validation_errors=exc.validation_errors,
@@ -4085,7 +4086,7 @@ class Worker:
             return await self._reject_update_validation_task(
                 task_id,
                 attempt,
-                str(exc),
+                exception_message(exc),
                 reason="update_validation_worker_failed",
                 failure_type=type(exc).__name__,
                 stack_trace=traceback.format_exc(),
@@ -4094,7 +4095,7 @@ class Worker:
             return await self._reject_update_validation_task(
                 task_id,
                 attempt,
-                str(exc) or "update validator rejected the request",
+                exception_message(exc, fallback="update validator rejected the request"),
                 reason="update_validator_rejected",
                 failure_type=type(exc).__name__,
                 stack_trace=traceback.format_exc(),