[andystaples]

Summary

Prepare the coordinated release of all three packages:

Package	Version	Tag
durabletask	1.13.0	v1.13.0
durabletask.azuremanaged	1.13.0	azuremanaged-v1.13.0
azure-functions-durable	2.0.0rc4	azurefunctions-v2.0.0rc4

Both providers now require durabletask>=1.13.0, including the Azure Managed blob-payload extra. Each changelog retains an empty Unreleased section above its release section.

Release coverage

The release includes changes since v1.12.0, azuremanaged-v1.12.0, and azurefunctions-v2.0.0rc3:

• Task-hub query filtering (feat(client): add task hub name filter to orchestration queries #295), immutable/hashable entity IDs (fix(entities): implement __hash__ and __repr__ for EntityInstanceId #309), and deterministic set serialization with opt-in reconstruction (fix(serialization): support set and frozenset generic containers in JsonDataConverter #310, Optimize deterministic set serialization without JSON parse round trips #313).
• Orchestration generator cleanup, cancellation handling, and dispatch recovery (fix(worker): close orchestrator generators when a dispatch ends #300, fix(worker): preserve dispatch outcomes when generator teardown raises CancelledError #303, fix(worker): recover unexpected orchestration dispatch exits #307).
• Large-payload preflight validation and permanent-failure entity-lock cleanup (Preflight all externalized payload sizes before uploads #305, Complete permanent payload failures with entity-lock cleanup #306).
• Python 3.11 minimum for core and Azure Managed, subclass-preserving typing, and grouped-failure diagnostics (Drop Python 3.10 support and adopt Python 3.11 features #302).
• Opt-in Unicode JSON for Azure Functions ([Azure Functions] Add opt-in Unicode JSON serialization #292) and non-retriable activity/sub-orchestration failures (Honor non-retriable activity and sub-orchestration failures #318).

The provider changelogs now include inherited task-hub filtering and entity-ID changes; Azure Managed also documents the new set-conversion options. The core changelog now explicitly introduces set support instead of only describing its optimization. Root and Functions READMEs document the applicable query and entity-ID behavior, and the root README explains set conversion and replay safety. Functions retains its separate shared codec. Internal GitHub Actions updates are excluded from release notes.

Warning

Python 3.10 is no longer supported by core or Azure Managed; Functions still requires Python 3.13+. Non-retriable failure handling and the callback aggregate exception change can affect replay of existing histories. Drain or isolate affected instances before upgrading. Set reconstruction remains opt-in, and entity IDs now reject attribute assignment and deletion.

Publishing coordination

After merge, publish durabletask 1.13.0 first and confirm availability on PyPI before publishing either provider. Create the package-specific tags above on the merged release commit. Mark the Azure Functions release as a prerelease. This PR does not create tags or GitHub releases.

Prepared release bodies

v1.13.0

What's Changed

• Added task-hub query filters, deterministic set/frozenset serialization, and opt-in typed set reconstruction.
• Entity IDs are immutable and hashable, with a diagnostic representation.
• Improved orchestrator generator cleanup, dispatch recovery, large-payload validation, and entity-lock cleanup after permanent payload failures.
• Retry policies honor non-retriable failures; grouped failures retain nested diagnostics.
• Requires Python 3.11+. Context managers and entity-ID copy/pickle hooks preserve subclass types in type checkers.

Review the release changelog before upgrading: retry and aggregate-exception changes can affect replay, and orchestrator finalizers now run at each dispatch boundary. Set reconstruction remains disabled by default.

External Links

• PyPI
• Full changelog

Contributors

andystaples, Bernd Verst (@berndverst), Hardik K (@hardikkaurani), Tamir Dresher (@tamirdresher)

azuremanaged-v1.13.0

What's Changed

• Added inherited task-hub query filtering and deterministic set serialization with opt-in typed reconstruction.
• Entity IDs are immutable and hashable, with a diagnostic representation.
• Adopts core orchestration cleanup, dispatch recovery, payload validation, entity-lock cleanup, non-retriable failure handling, and grouped-failure diagnostics.
• Requires Python 3.11+ and durabletask>=1.13.0, including the blob-payload extra. Client and worker context managers preserve subclass types in type checkers.

Review the release changelog and its core upgrade guidance before upgrading. Retry and aggregate-exception changes can affect existing histories; orchestrator finalizers now run at each dispatch boundary. Set reconstruction remains disabled by default.

External Links

• PyPI
• Full changelog

Contributors

andystaples, Bernd Verst (@berndverst), Hardik K (@hardikkaurani), Tamir Dresher (@tamirdresher)

azurefunctions-v2.0.0rc4

What's Changed

• Added DFApp.configure_serialization(ensure_ascii=False) for opt-in Unicode JSON across durable payload boundaries.
• Added inherited task-hub query filtering. Entity IDs, including compatibility EntityId, are immutable and hashable.
• Adopts core orchestration cleanup, failed responses for unexpected execution exits, payload preflight validation, non-retriable failure handling, and grouped-failure diagnostics.
• Requires durabletask>=1.13.0 and azure-functions>=2.4.0b1. Python 3.13+ remains required.

This is a prerelease. Review the release changelog and its core upgrade guidance before upgrading. Retry and aggregate-exception changes can affect existing histories; orchestrator finalizers now run at each dispatch boundary. Unicode encoding is opt-in and must be configured consistently at startup.

External Links

• PyPI
• Full changelog

Contributors

andystaples, Bernd Verst (@berndverst), Hardik K (@hardikkaurani), Tamir Dresher (@tamirdresher)

[Copilot]

🟡 Changes recommended

The replay-safety guidance omits bare-set and nested-container limitations, and sorting alone can remain nondeterministic for frozenset values.

3 open issues

• Document nested sets in top-level containers are not auto-coerced · New
• Document bare set fields as an exception to replay ordering · New
• Use a deterministic total-order key when sorting frozenset values · New

What changed in this PR

Prepares a coordinated release of the core SDK and both providers, aligning dependency minimums and documenting upgrade considerations.

Changes:

• Bumps core and Azure Managed to 1.13.0, and Azure Functions to 2.0.0rc4.
• Raises provider core dependencies to 1.13.0, including applicable extras.
• Adds release changelog sections and documents query filters, set conversion, immutable entity IDs, and replay considerations.

File	Description
README.md	Documents query filters, set conversion, and immutable entity IDs.
pyproject.toml	Sets core version to 1.13.0.
durabletask-azuremanaged/​pyproject.toml	Updates provider version and core dependency minimums.
durabletask-azuremanaged/​CHANGELOG.md	Adds the 1.13.0 section and inherited feature coverage.
CHANGELOG.md	Adds the core 1.13.0 section and clarifies feature descriptions.
azure-functions-durable/​README.md	Documents inherited query filtering and entity-ID behavior.
azure-functions-durable/​pyproject.toml	Sets 2.0.0rc4 and raises the core dependency minimum.
azure-functions-durable/​CHANGELOG.md	Adds the prerelease section and updates upgrade references.

_{Review effort: Balanced}