Skip to content

1.22.0

Latest

Choose a tag to compare

@github-actions github-actions released this 10 Nov 19:36
cbc534d

Notable Changes

Added

  • Nexus operation handlers now forward inbound callback links to the workflows and signals they start, instead of dropping them.
  • Nexus operation handlers now propagate their Nexus serialization context to the workflows and standalone activities they start, which use it to encode their results, failures, and (for activities) heartbeat details. Clients decode these with the context the server returns, including handles obtained by ID and standalone Nexus operation handles. Requires a server that propagates the context.
  • Nexus operation handlers now propagate their Nexus serialization context to the workflow updates they send, which use it to encode their results, failures, and rejections. Update handles decode these with the context the server returns. Requires a server that propagates the context.
  • Workers that don't configure poller behavior now auto-enroll in poller autoscaling when the server enables it (frontend.pollerAutoscalingAutoEnroll); otherwise they keep using a fixed 5-poller maximum.
  • Experimental: [TemporalOperation] handler method names can now end with Async without changing the operation's wire name. Exact method-name matches take precedence.
  • Experimental: Added CompletionCallback for attaching completion callbacks to Standalone Nexus Operations.
  • Experimental: Added ActivityInfo.NexusSerializationContext. To complete a Nexus-started standalone activity asynchronously, pass it to AsyncActivityHandle.WithSerializationContext.
  • Experimental: Added client environment config extensions. Profiles expose raw extension config from profile.<name>.ext as ClientEnvConfig.Profile.Ext, and IClientConfigExtension implementations passed via ProfileLoadOptions.Extensions to ClientEnvConfig.LoadClientConnectOptions contribute client plugins to the returned options.
  • Experimental: External Storage is now in Public Preview: set DataConverter.ExternalStorage with an IStorageDriver to offload large payloads to an external store and retrieve them transparently. Drivers are told the workflow or activity each payload is stored for, and may receive concurrent requests. Tasks that fail on a storage error report the EXTERNAL_STORAGE_FAILURE cause.
  • Experimental: Added Temporalio.Extensions.Aws.S3Driver package with an S3 storage driver for external storage payloads, and an optional Temporalio.Extensions.Aws.S3Driver.AwsSdk package with an AWSSDK.S3 backed client.

Changed

  • Core: Poller pools now report their poller target to the server on each poll and in the worker heartbeat: the current target for autoscaling pools, the configured maximum for fixed-size pools.
  • Standalone Nexus Operations are now in Public Preview. TemporalOperationHandler remains experimental.

💥 Breaking Changes

  • Experimental: A Temporal operation handler can now send only one signal or signal-with-start per invocation through ITemporalNexusClient.TemporalClient; a second throws a BadRequest HandlerException unless the first failed. Signals sent through NexusOperationExecutionContext.Current.TemporalClient are not limited.
  • Experimental: NexusOperationOptions is now sealed and can no longer be subclassed.

Fixed

  • Workflow wait conditions are no longer evaluated in a workflow task that only delivers updates and rejects all of them.
  • Core: Rejection-only update tasks no longer dispatch local activities resumed from replay before validation, allowing those tasks to remain unrecorded in workflow history.
  • Core: Preparing a legacy query now remains in replay mode, preventing unrecorded local activity attempts that could execute twice or leave the workflow stuck.
  • Core: Preserve queued queries across workflow eviction so requests for the same run are answered instead of silently dropped.
  • Core: A workflow task failure reported with the cause WORKFLOW_TASK_FAILED_CAUSE_EXTERNAL_STORAGE_FAILURE is now counted on workflow_task_execution_failed with failure_reason="ExternalStorageError", matching activity failures with the storage cause. It was previously counted as WorkflowError.
  • Core: Resource-based worker tuners now read CPU usage and quotas from standard cgroup v1 mounts. Workers on cgroup v1 systems no longer fall back to host CPU usage and admit work based on understated container load.
  • Core: Downloading an ephemeral dev or test server binary now retries transient HTTP failures, such as a 503 returned while a release is rolling out, with backoff instead of failing on the first attempt.
  • Core: Ephemeral dev and test servers now complete the automatic port reservation handshake on Linux and macOS before starting, preventing intermittent address-in-use errors during TCP teardown.
  • Inbound Nexus links with an empty path segment, such as an empty workflow ID or run ID, are now dropped with a warning instead of being forwarded with empty identifiers.
  • Experimental: Signals and signal-with-start calls sent through ITemporalNexusClient.TemporalClient in a Temporal operation handler now reuse the operation's request ID, so a retried Nexus task no longer delivers the same signal twice.

SDK Core Commits

  • c9c31a82 Extend polling test server startup timeout (#1681)
  • 829eb7eb Keep legacy query preparation in replay mode (#1658)
  • 4433bf1b build(deps): update rstest requirement from 0.26 to 0.27 (#1683)
  • 0a5d6462 Update API (#1690)
  • 34ee222c Migrate user-facing Rust SDK changelog to release fragments (#1635)
  • b16e8088 fix(core): preserve buffered queries across run eviction (#1693)
  • ea118d37 fix: skip wait conditions when a task only rejects updates (#1697)
  • 85975e9b Clarify contributor restrictions on soliciting user information (#1680)
  • 7a7144e1 Extend fixed test server startup timeout (#1698)
  • 42e9ada7 feat: add external storage runner (#1696)
  • aaa0db5f Use API activity failure cause (#1609)
  • 535216c6 Add Required PR Checks job to gate merges (#1695)
  • d28e7be2 Propagate Nexus serialization context to workflow, update and activity tasks (#1717)
  • 2963d617 refactor: separate storage driver errors from external storage errors (#1705)
  • f49305f1 feat: reject external storage references with TMPRL1105 (#1706)
  • c4045f18 Fallback to cgroup v1 for cpu in the resource based tuner (#1702)
  • a3cf9059 Fix heartbeat test poller configuration (#1723)
  • e3f73fca fix: defer storage reference retrieval storage in describe calls (#1720)
  • cd0e3d84 feat: offload large payloads via external storage (#1708)
  • 3a4ad95e Ensure waiters are always notified in Nexus worker (#1244)
  • d8720a5b refactor: gather external storage code into one module (#1726)
  • 70b594f1 feat: report storage driver types in worker heartbeats (#1724)
  • 9ea86f57 VLN-1791: fix mise-action-below-v5 (#1725)
  • a7735951 feat: provide storage drivers target information (#1728)
  • 4b3af8db feat(brook): add the dispatching Workflow Task to each Local Activity start (#1703)
  • c198a965 feat: offload activity heartbeat details to external storage (#1729)
  • a7d198ee Extract shared sticky polling machinery (#1686)
  • 1fd54a9e Reserve ephemeral ports on macOS (#1735)
  • f4b8b2b3 feat: report external storage failures with the storage failure cause (#1738)
  • 8dff9b84 Test poller autoscaling signal handling (#1722)
  • 3c99279c feat: accept plugin versions through the C bridge (#1751)
  • e1ae09e0 Complete ephemeral port teardown (#1754)
  • 96926fae Run required PR checks only on pull requests (#1748)
  • ad7caa94 build(deps): update lru requirement from 0.18 to 0.19 (#1742)
  • bd999ef3 build(deps): update rstest requirement from 0.27 to 0.28 (#1741)
  • 2f972ee6 fix(client): apply the data converter to workflow user metadata (#1750)
  • 67174ea9 fix: request update completion for execute update (#1755)
  • 51009f8c Preserve encoded schedule actions and add OTel header opt-in (#1734)
  • 3a83c693 ci: remove macos-intel from PR builds (#1756)
  • 0713f0c2 feat: report external storage metrics on workflow completions (#1740)
  • 1aebc388 feat: store and retrieve a message's payload fields concurrently (#1744)
  • b9016f4f feat(envconfig): add extension support (#1736)
  • d4ef50ad docs: consolidate unreleased external storage changelog entries (#1761)
  • ff30d403 fix(client): send retained schedule actions back without re-storing them (#1758)
  • 8751afdb ci: run the macOS arm jobs on macos-15 (#1763)
  • 687ffb05 chore: bump rust version & wasmtime (#1767)
  • 4c3d2e49 Synchronize worker shutdown eviction test (#1757)
  • 38dfee48 fix: retry ephemeral server downloads and reduce port test churn (#1764)
  • 2af87425 docs: fix stale crates/core paths after rename to sdk-core (#1771)
  • f2770d0f Report poller target on each poll and in the worker heartbeat (#1688)
  • 96032e69 Add extstore s3 driver (#1721)
  • 396c6adb chore: downversion s3 driver for manual release (#1777)
  • c675c324 chore: release 1.2.0 (#1778)

What's Changed

  • chore: update baseline to 1.21.0 by @jmaeagle99 in #977
  • fix: skip wait conditions when a task only rejects updates by @jmaeagle99 in #984
  • docs: simplify external storage concurrency comments by @jmaeagle99 in #966
  • ci: add Required PR Checks job to gate merges by @cconstable in #982
  • feat: detect external storage references by marker metadata by @jmaeagle99 in #980
  • feat: add the external storage runner by @jmaeagle99 in #985
  • Update NexusRpc to 0.5.0 by @VegetarianOrc in #986
  • Support Async-suffixed Temporal operation handlers by @VegetarianOrc in #987
  • Add Nexus link converter for Callbacks by @atol in #979
  • Update to nexgen 0.2.10. Move nexgen support to Temporalio.Nexus.SystemNexus namespace instead of being generated. by @VegetarianOrc in #957
  • Generate notification service models by @VegetarianOrc in #958
  • refactor: generate a payload visitor for all protos and hide Nexus envelopes behind it by @jmaeagle99 in #981
  • chore(deps): bump actions/download-artifact from 8.0.1 to 8.0.2 by @dependabot[bot] in #992
  • chore(deps): bump actions/upload-artifact from 7.0.1 to 7.0.2 by @dependabot[bot] in #991
  • chore(deps): bump actions/create-github-app-token from 3.2.0 to 3.3.0 by @dependabot[bot] in #993
  • chore(deps): bump jdx/mise-action from 5.1.1 to 5.1.2 in /.github/actions/setup by @dependabot[bot] in #994
  • docs: list community analyzer and template packages by @jmaeagle99 in #995
  • feat(extstore): add s3 driver for external storage. by @cconstable in #989
  • docs: list Aspire hosting community package by @cecilphillip in #1009
  • chore(deps): bump zip from 9.0.4 to 9.1.3 in /src/Temporalio/Bridge in the cargo group across 1 directory by @dependabot[bot] in #1001
  • ci: allow release publishing from releases/* branches by @jmaeagle99 in #1008
  • chore: add 1.21.1 release notes by @jmaeagle99 in #1010
  • chore(ci): move macOS arm64 runners to macos-15 by @jmaeagle99 in #1011
  • docs: mark standalone Nexus operations public preview by @litlep-nibbyt in #954
  • Add Nexus Handler Callbacks to SANO client options by @VegetarianOrc in #959
  • chore(deps): bump Swatinem/rust-cache from 2.9.2 to 2.9.3 in /.github/actions/setup by @dependabot[bot] in #1013
  • chore(deps): bump jdx/mise-action from 5.1.2 to 5.2.1 in /.github/actions/setup by @dependabot[bot] in #1014
  • Run required PR checks only on pull requests by @yuandrew in #1015
  • feat: retrieve external storage references on inbound payloads by @jmaeagle99 in #996
  • feat: store large payloads to external storage on outbound payloads by @jmaeagle99 in #997
  • feat: make external storage API public by @jmaeagle99 in #1000
  • feat: report external storage driver types in worker heartbeats by @jmaeagle99 in #1002
  • fix: update S3 driver tests for init-only storage contexts by @jmaeagle99 in #1016
  • Pass unset poller behavior to core so workers can auto-enroll in poller autoscaling by @veeral-patel in #1012
  • feat: thread external storage context through conversion funnels by @jmaeagle99 in #1019
  • feat: target offloaded completion payloads per command by @jmaeagle99 in #1020
  • chore: update sdk-core submodule by @jmaeagle99 in #1025
  • Dedup retried Nexus signals by @atol in #1004
  • feat(envconfig): add extension support by @johanngan in #1018
  • ci: publish the S3 external storage driver packages by @jmaeagle99 in #1024
  • feat: fail tasks retryably on external storage failure by @jmaeagle99 in #1022
  • feat: report external storage metrics on workflow task completions by @jmaeagle99 in #1023
  • fix(client): send unchanged schedule summary and details as-is by @jmaeagle99 in #1030
  • feat: concurrent payload visiting by @jmaeagle99 in #1029
  • Nexus Serialization Context for Workflows and Activities by @JoshuaFrenchwood in #1026
  • Propagate Nexus serialization context to workflow updates by @JoshuaFrenchwood in #1027
  • Mark experimental extension packages consistently in docs by @jmaeagle99 in #1032
  • docs: consolidate unreleased external storage changelog entries by @jmaeagle99 in #1033
  • chore: update sdk-core to core-v0.11.0 tag by @jmaeagle99 in #1034
  • docs: uniform experimental prefix for change logs by @jmaeagle99 in #1035
  • chore(deps): bump jdx/mise-action from 5.2.1 to 5.2.4 in /.github/actions/setup by @dependabot[bot] in #1037
  • Require Cloud tests for CI by @yuandrew in #1038
  • feat(extstore): make S3 driver API public by @jmaeagle99 in #1036
  • Prepare release 1.22.0 by @jmaeagle99 in #1039

New Contributors

Full Changelog: 1.21.0...1.22.0