Repository navigation
1.21.0
Notable Changes
💥 Breaking Changes
- Core: Replay detects changes to the service or operation of scheduled Nexus operations, reporting nondeterminism while retaining compatibility with histories recorded before these checks.
SchedulePolicy.CatchupWindowis now nullable and defaults tonull. An unspecified window uses the server configured default.
Added
- Added experimental Event Groups:
Workflow.CreateEventGroupgroups related history events for UI and observability using a required ID (used verbatim; omit secrets) and an optional codec-encoded label. Attach groups withWorkflow.WithEventGroupsor command-optionEventGroups; signal and update handlers receive implicit inbound groups. - Added
OpenTelemetryOptions.HistogramAggregation, which can be set toOpenTelemetryHistogramAggregation.Base2Exponentialto export OTLP histograms, including custom ones, as OpenTelemetry exponential histograms, which Prometheus-compatible backends store as native histograms. Each series gets a name suffix (_nativeby default) so it never collides with the fixed-bucket series it replaces; this mode cannot be combined withHistogramBucketOverrides. - Added experimental
Endpoint,Operation, andServiceproperties to theNexusOperationHandleclass. - Added experimental
ISerializationContext.Nexussupport for callers' inputs, results, failures, and user metadata, and handlers' inputs, synchronous results, and failures. Standalone handles use the start request's context, including already-running operations; asynchronous-operation results and handles obtained throughGetNexusOperationHandlewith only an operation ID do not use this context. - Add experimental
ChildWorkflowOptions.VersioningOverridefor pinned, auto-upgrade, and one-time child workflow routing independently of the parent (Temporal Server 1.32.0+),VersioningOverride.OneTimefor one-time routing on both client and child workflow starts, andInvalidVersioningOverrideExceptionfor invalid child overrides. DevServerOptions.StartupTimeoutandTestServerOptions.StartupTimeoutset how long a local or time-skippingWorkflowEnvironmentwaits for its server to become ready, excluding download time. The default remains five seconds.- Added
WorkflowInfo.OriginalExecutionRunId, the run ID recorded on the workflow execution started event. UnlikeRunId, this value is preserved across workflow resets.
Stabilized
- Removed experimental warnings from the core plugin APIs and client/worker plugin options.
DevServerOptionsandTestServerOptionsare no longer marked unstable. They remain specific to the dev server and test server implementations and may no longer be valid if those change.
Fixed
- Fixed an exception when reading schedule policies with an unset catchup window.
- Core: A workflow task that arrives while a workflow waits on a local activity, such as a legacy query, now waits until the current workflow task is reported. Previously it replaced that workflow task ("Trying to send a new WFT for a run which already has one!"), which then timed out on the server and could leave the workflow stuck on a nondeterminism error.
- Fixed update validators being skipped when a typed client update call populated the cache before the workflow definition was created in the same process.
- Core: Worker heartbeats now report correct task-slot and poller counts when using buffered or custom metrics backends, including the .NET SDK's
CustomMetricMeter. Previously these counts could remain0because heartbeat accounting depended on reading labels from backend-owned attributes. - Core: Local activities still running when their workflow is evicted or the worker shuts down now always receive a cancellation. Local activities no longer retry ordinary failures or start-to-close timeouts after cancellation has been requested, matching non-local activities. Workflow code no longer observes a spurious local activity cancellation when its run is evicted or completes while the local activity is backing off between retries.
- Core: Workers no longer panic when evicting a workflow with buffered local activity results. Completed activations' output is recorded before eviction, without recording eviction-induced cancellations.
- Unexpected errors in workflow-internal tasks for child workflows and updates, such as a failure converter throwing while resolving a child workflow, now fail the workflow task instead of being silently lost. For queries, such errors fail only the query itself, not the workflow task.
- Core: Workers now replay workflows paused before a scheduled task starts, allowing those workflows to make progress after unpause.
- Source Link in the published symbol packages now resolves every source file, and packages are built with normalized paths so they are reproducible.
Temporalio.Extensions.DiagnosticSource.CustomMetricMeterno longer throws when a tag is appended with a key that the tag set already has. The appended value now replaces the existing one.- Core: Replay now preserves which local activity results were delivered together for newly recorded histories. This prevents local activity scheduling which was conditional on local activity resolution order from assigning recorded results to different handles. Older markers keep their existing behavior.
TemporalWorkerServicecreated with theTemporalWorkerServiceOptionsconstructor now connects usingClientOptionsand honorsWorkerClientUpdater. Previously it failed with aNullReferenceExceptionwhen started.- Prevented use-after-free errors caused by early finalization of
Temporalio.Bridge.ByteArray. - Core: Dev and test server startup now stops waiting at the configured deadline even if a readiness request stalls. Timeout messages include the last connection failure when available.
- Core: Workers with large workflow caches avoid unnecessary CPU usage when no workflow tasks are waiting for a cache slot.
- An activity started using the ambient
TemporalClientdirectly from inside a synchronous Nexus operation handler now inherits the handler's request ID and inbound links, same as the guarded start already gets.
Security
- Core: Ephemeral server downloads now use
zip9.0 for ZIP extraction, replacing the 8.x dependency yanked upstream for security issues.
SDK Core Commits
e163abd6Record order LAs are resolved in WFTs (#1616)d24904cbAdd workflow versioning overrides (#1624)281807a5[fix] Havestart_updaterepeatedly poll forAccepted(#1611)bfc66f7dAdd shared changelog fragment tooling (#1625)26ed8876chore(ci): use resolver 3 to fix msrv (#1628)f701746dFix non-determinism in FSM codegen (#1633)c1670481Import Core changelog entries when updating SDK submodules (#1634)20085a01feat(sdk): add OpenTelemetry tracing integration (#1591)8fe478eechore: bump versions for 1.1.0 release (#1632)01d7c918Prefix imported Core changelog entries (#1636)38f83151Recognize v-prefixed SDK release tags (#1638)472f94eeFix labelled heartbeat metrics reporting 0 with a buffered meter (#1593)958f13b2Fix client name issue in cloud CI (#1647)8e988713Detect Nexus operation changes during replay (#1645)9cb90f5aDeliver local activity cancels before evicting a run (#1620)aefe3059Add Worker::run_until to the Rust SDK (#1637)877c33e8Update Upstream Protos for Nexus Handler Callbacks (#1652)212e8150Buffer a new workflow task while the run already has one (#1640)7064ea83build(deps): update dirs requirement from 6.0 to 7.0 (#1617)b5391812Fix replay after workflow pause before task start (#1618)3313345fAdd exponential histogram option to OTLP metrics exporter (#1654)165a0e60feat: external storage foundation types (#1630)56fa82ecAdd experimental Event Groups support (#1521)951fd672fix(visitor): classify Any fields in payload limits generator (#1641)2c1ee2dechore: bump zip (#1666)3f01ba1ebuild(deps): bump hoverkraft-tech/compose-action from 3.1.0 to 3.2.0 (#1631)e6b2df75Skip workflow cache scan when no tasks are buffered (#1667)e322b0fechore: remove anithesis (#1669)0a838469build(deps): update wit-bindgen requirement from 0.61.1 to 0.62.0 (#1655)d1fbb204chore: upgrade to syn 3 (#1668)489337edRemove activity cancel tokens once the activity finishes (#1677)6dd00313Honored the per-runner timeout for the integ test matrix. (#1674)849f9ae0Fix Nexus metrics shutdown race (#1672)2286cf22feat: add external storage concurrency limiter APIs (#1673)994bab3cfeat: allow customizing test server startup timeout (#1678)
What's Changed
- chore: update baseline to 1.20.0 by @jmaeagle99 in #921
- Unified link converters by @Evanthx in #915
- docs: clarify the payload codec contract by @jmaeagle99 in #914
- test: cover workflow update on time-skipping server by @jmaeagle99 in #913
- fix: source link and path normalization in symbols by @jmaeagle99 in #926
- Updating some tests around link converter by @Evanthx in #925
- docs: move library usage to src/Temporalio/README.md by @jmaeagle99 in #927
- docs: mark dev and test server options as stable by @jmaeagle99 in #928
- fix: keep ByteArray alive while reading its native buffer by @JRBANCEL in #930
- feat: external storage foundation types by @jmaeagle99 in #911
- Interpolate method name in dynamic activity name error by @RaphaelFakhri in #924
- Adding NexusSerializationContext by @Evanthx in #908
- Remove experimental language from core plugin APIs by @tconley1428 in #934
- Let appended DiagnosticSource metric tags override existing keys by @RaphaelFakhri in #923
- 💥 fix(client): remove schedule catchup window default by @chris-olszewski in #933
- Add experimental Event Groups support by @mjameswh in #910
- fix(tests): make schedule test cleanup failure-safe by @jmaeagle99 in #931
- chore: Install .NET SDK via mise from global.json by @jmaeagle99 in #932
- fix(tests): fix races in Nexus update operation tests by @jmaeagle99 in #935
- fix(tests): reorder methods to fix build by @jmaeagle99 in #936
- Adopt shared changelog fragments and Core update tooling by @tconley1428 in #937
- Add child workflow versioning overrides by @Quinn-With-Two-Ns in #938
- ci: test Cloud API key auth on its own per-run namespace by @jmaeagle99 in #947
- Automate .NET SDK releases by @tconley1428 in #940
- chore: list protos as a Bridge workspace member to fix Dependabot by @jmaeagle99 in #949
- chore(deps): bump rustls from 0.23.43 to 0.23.46 in /src/Temporalio/Bridge in the cargo group across 1 directory by @dependabot[bot] in #951
- chore(deps): bump jdx/mise-action from 4.3.0 to 5.0.1 in /.github/actions/setup by @dependabot[bot] in #950
- ci: stop passing prerelease flag when version specified in smoke test by @jmaeagle99 in #953
- ci: suppress NU1507 in smoke test projects by @jmaeagle99 in #955
- Update sdk-core to main (WFT buffering fix) by @THardy98 in #948
- docs: correct driver operation budget scope by @jmaeagle99 in #956
- chore: update sdk-core to latest by @jmaeagle99 in #963
- Nexus: raw activity starts inherit request ID and links by @tekkaya in #880
- Fail workflow task on lost errors in queued child, update, and query tasks by @amirani8137 in #916
- fix: keep an update's validator when a client resolved the update first by @digisimon in #961
- feat: add OTLP exponential histogram aggregation option by @jmaeagle99 in #964
- fix: connect with client options in TemporalWorkerService options constructor by @RaphaelFakhri in #968
- Clarify contributor restrictions on soliciting user information by @eamsden in #969
- chore(deps): bump dorny/test-reporter from 3.0.0 to 3.2.0 by @dependabot[bot] in #971
- chore(deps): bump jdx/mise-action from 5.0.1 to 5.1.1 in /.github/actions/setup by @dependabot[bot] in #972
- chore: update sdk-core submodule by @jmaeagle99 in #970
- Prepare release 1.21.0 by @jmaeagle99 in #974
New Contributors
- @JRBANCEL made their first contribution in #930
- @RaphaelFakhri made their first contribution in #924
- @tekkaya made their first contribution in #880
- @amirani8137 made their first contribution in #916
- @digisimon made their first contribution in #961
Full Changelog: 1.20.0...1.21.0