Skip to content

1.21.0

Choose a tag to compare

@github-actions github-actions released this 20 Oct 19:32
305626d

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.CatchupWindow is now nullable and defaults to null. An unspecified window uses the server configured default.

Added

  • Added experimental Event Groups: Workflow.CreateEventGroup groups related history events for UI and observability using a required ID (used verbatim; omit secrets) and an optional codec-encoded label. Attach groups with Workflow.WithEventGroups or command-option EventGroups; signal and update handlers receive implicit inbound groups.
  • Added OpenTelemetryOptions.HistogramAggregation, which can be set to OpenTelemetryHistogramAggregation.Base2Exponential to export OTLP histograms, including custom ones, as OpenTelemetry exponential histograms, which Prometheus-compatible backends store as native histograms. Each series gets a name suffix (_native by default) so it never collides with the fixed-bucket series it replaces; this mode cannot be combined with HistogramBucketOverrides.
  • Added experimental Endpoint, Operation, and Service properties to the NexusOperationHandle class.
  • Added experimental ISerializationContext.Nexus support 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 through GetNexusOperationHandle with only an operation ID do not use this context.
  • Add experimental ChildWorkflowOptions.VersioningOverride for pinned, auto-upgrade, and one-time child workflow routing independently of the parent (Temporal Server 1.32.0+), VersioningOverride.OneTime for one-time routing on both client and child workflow starts, and InvalidVersioningOverrideException for invalid child overrides.
  • DevServerOptions.StartupTimeout and TestServerOptions.StartupTimeout set how long a local or time-skipping WorkflowEnvironment waits 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. Unlike RunId, this value is preserved across workflow resets.

Stabilized

  • Removed experimental warnings from the core plugin APIs and client/worker plugin options.
  • DevServerOptions and TestServerOptions are 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 remain 0 because 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.CustomMetricMeter no 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.
  • TemporalWorkerService created with the TemporalWorkerServiceOptions constructor now connects using ClientOptions and honors WorkerClientUpdater. Previously it failed with a NullReferenceException when 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 TemporalClient directly 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

SDK Core Commits

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

Full Changelog: 1.20.0...1.21.0