Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
14 changes: 14 additions & 0 deletions .github/release-candidates/2.19.0.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,14 @@
{
"schema": "sdk-python.reviewed-release/v1",
"version": "2.19.0",
"source_commit": "86effbf4cd4839fdb7cb6fa464ed9bb52025a7f2",
"source_tree": "42c96102d889a65a4b4f70687ed5bcf41f549fee",
"run_id": 44343865375,
"run_attempt": 1,
"artifact_id": 14443574939,
"artifact_sha256": "7d2132af4f7f13c020cfa935b24e4d4024ae1cbacaf012694dce3391c4ef8e7f",
"files": {
"durable_workflow-2.19.0-py3-none-any.whl": "1f18d038f24a6ad9440e03837e634b99a3f870afaf9c4a874829fca48737a056",
"durable_workflow-2.19.0.tar.gz": "57aaba83102474b77283f3d7b1bb862635c846378e8c5155d228bc910b4b41a6"
}
}
4 changes: 2 additions & 2 deletions .github/workflows/ci.yml
Original file line number Diff line number Diff line change
Expand Up @@ -97,7 +97,7 @@ jobs:
id: retry-candidate
env:
GH_TOKEN: ${{ github.token }}
run: python .github/scripts/promote_release.py resolve --version 2.18.0
run: python .github/scripts/promote_release.py resolve --version 2.19.0
- name: Download the approved candidate handoff
if: inputs.retry_cap_artifact_source == 'candidate'
uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8
Expand All @@ -110,7 +110,7 @@ jobs:
archive: false
- name: Verify candidate archive and distribution bytes
if: inputs.retry_cap_artifact_source == 'candidate'
run: python .github/scripts/promote_release.py extract --version 2.18.0
run: python .github/scripts/promote_release.py extract --version 2.19.0
- name: Bootstrap patched pip trust
uses: durable-workflow/.github/.github/actions/bootstrap-patched-pip@75587fc33ff40c34f32ef777293dad56bb6f48c7 # clean-trust
with:
Expand Down
4 changes: 4 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0

## [Unreleased]

## [2.19.0] - 2026-11-18

### Added

- `WorkflowContext.schedule_origin` returns the schedule fire that started the run as a `ScheduleOrigin` (`schedule_id`, `occurrence_time`, `trigger_number`), or `None` for a run no schedule started (durable-workflow/.github#243). It reads the run's `ScheduleTriggered` history event, so it is available on the first workflow task and identical on replay. `occurrence_time` is the time the scheduler evaluated (the jittered fire time for a tick, the enumerated time for a backfill), not the run's start time, and is `None` for a manual trigger. Histories without the event read `None`, so existing runs replay unchanged.
Expand All @@ -16,6 +18,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
- An `all()` group (`yield [...]`) whose member fails while other members are still running no longer blocks the run. Server wakes the workflow once, for the failure, and never again for that group. The worker used to send the group's whole scheduling batch again on that wake, and native Server refused the completion with `409 parallel_sequence_mismatch` (2.17.2 and 2.18.0 on native Server 3.12.0 and 3.13.0). The first recorded member failure is now raised at the yield as soon as it is recorded, as in Workflow's embedded engine. The other members keep running and their outcomes are ignored. A wake while a group is open, such as a signal, also no longer sends the group again. (#338)
- **Recorded decision:** the task that raises a failure early first records which member it raised, as a side effect whose result is keyed `durable_workflow.parallel_failure_decision`, at the sequence right after the group. Replay raises exactly that member. History has no workflow-task boundaries, so without the record a member failing after the task read history but before its completion was written would make a later replay choose differently. Workflow code after such a group therefore starts one sequence later.
- **Replay safety:** a history in which every member settled before the workflow did anything else replays as before, raising the failure with the lowest input position. This is now the documented default for groups with no recorded policy, matching Workflow's embedded engine and the PHP and Rust SDKs. The explicit policies remain tracked in #307.
- **Visible effect:** when a member fails while a sibling is still running, workflow code after the group, such as a compensation, now starts one sequence later than it would have, because the decision record takes the sequence right after the group. Nothing else about the group changes: the same failure reaches the same `except` block.
- **Runs already blocked under 2.18.0 or earlier recover after the upgrade.** Upgrade every worker on the task queue to 2.19.0, wait until the group's other members have finished, then repair the run (`WorkflowHandle.repair()` or `Client.repair_workflow()`). The repaired workflow task raises the group's failure on the upgraded worker instead of sending the group again, and the run continues. Upgrading alone is not enough, because native Server sends no new workflow task to a blocked run. Native Server 3.13.0 refuses the repair with `development_workflow_task_repair_active_work_unqualified` while a member is still running, and also when the blocked run has received a signal or an accepted update, so a run in that state stays blocked. Checked on native Server 3.13.0: a run blocked by a 2.18.0 worker stayed `waiting` after the upgrade until it was repaired, then ran its compensation and completed.

## [2.18.0] - 2026-11-18

Expand Down
6 changes: 3 additions & 3 deletions pyproject.toml
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"

[project]
name = "durable-workflow"
version = "2.18.0"
version = "2.19.0"
description = "Python client and worker SDK for Durable Workflow Cloud and self-hosted Server"
readme = "README.md"
requires-python = ">=3.10"
Expand Down Expand Up @@ -79,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.18.0"
registry-version = "2.18.0"
product-train = "2.19.0"
registry-version = "2.19.0"
supported-server-versions = "2.8.0"
supported-server-release-baselines = { "2" = "2.8.0", "3" = "3.0.0" }
worker-protocol-version = "1.20"
Expand Down
2 changes: 1 addition & 1 deletion scripts/ci/activity-retry-cap.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
The retry-cap case qualifies the exact reviewed 2.18.0 wheel on the published
The retry-cap case qualifies the exact reviewed 2.19.0 wheel on the published
Server/Python tuple in `tests/fixtures/published-retry-cap.json`. It uses the
existing internal two-container profile, complete hash lock, captured no-site
entry, before/after installed inventory and independent ID/label cleanup.
Expand Down
2 changes: 1 addition & 1 deletion scripts/ci/activity_acceptance_release.py
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@

from scripts.ci.activity_acceptance_entry import captured_file

VERSION = "2.18.0"
VERSION = "2.19.0"
WHEEL = f"durable_workflow-{VERSION}-py3-none-any.whl"
SDIST = f"durable_workflow-{VERSION}.tar.gz"

Expand Down
10 changes: 5 additions & 5 deletions tests/fixtures/published-retry-cap.json
Original file line number Diff line number Diff line change
@@ -1,10 +1,10 @@
{
"schema": "sdk-python.published-activity-acceptance/v1",
"sdk_version": "2.18.0",
"server_image": "ghcr.io/durable-workflow/server@sha256:33c7ec1d61dbbdf5c1c2248da609208bdaa8a0f8d25f3f016686c486fc7ed7f8",
"server_source": "da655a8500691d6ce8e018d1552801491a696135",
"server_amd64_manifest": "sha256:52fed6731309116bc9e71cb4b140be570e50942935f3238ebed08e1b338d998d",
"server_qualification": "https://github.com/durable-workflow/server/releases/tag/3.12.0",
"sdk_version": "2.19.0",
"server_image": "ghcr.io/durable-workflow/server@sha256:30ccaf2cea6810a92915a9eb389f1a63ea870818a74c9cc1a321379b07b2d25c",
"server_source": "2d1244be4611e1bc4aa4f0d856c708bed17937b4",
"server_amd64_manifest": "sha256:6cdcb909b1ca46d10410d7f659fcbd292dbf02be0c337d989b886153c0f3ee56",
"server_qualification": "https://github.com/durable-workflow/server/releases/tag/3.13.0",
"python_image": "docker.io/library/python@sha256:935c3c5b12357a7e10caa9c1e6ca5692344d97cf229832ef584be2cec9fc03df",
"python_amd64_manifest": "sha256:0f086103b026048cc50cb5da25ec435c023c5241a83fc44daea593377abc61c4",
"python_version": "3.12.16"
Expand Down
2 changes: 1 addition & 1 deletion tests/test_activity_retry_cap_cell.py
Original file line number Diff line number Diff line change
Expand Up @@ -84,7 +84,7 @@ def approval(digest="a" * 64):

def test_effective_lock_adds_only_the_approved_sdk_to_the_fixed_dependencies():
result, digest = release.lock(b"pytest==1 --hash=sha256:" + b"c" * 64 + b"\n", approval())
assert result.endswith(f"durable-workflow==2.18.0 --hash=sha256:{digest}\n".encode())
assert result.endswith(f"durable-workflow==2.19.0 --hash=sha256:{digest}\n".encode())
assert result.count(b"durable-workflow") == 1


Expand Down
Loading