Repository navigation
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 withAsyncwithout changing the operation's wire name. Exact method-name matches take precedence. - Experimental: Added
CompletionCallbackfor attaching completion callbacks to Standalone Nexus Operations. - Experimental: Added
ActivityInfo.NexusSerializationContext. To complete a Nexus-started standalone activity asynchronously, pass it toAsyncActivityHandle.WithSerializationContext. - Experimental: Added client environment config extensions. Profiles expose raw extension config from
profile.<name>.extasClientEnvConfig.Profile.Ext, andIClientConfigExtensionimplementations passed viaProfileLoadOptions.ExtensionstoClientEnvConfig.LoadClientConnectOptionscontribute client plugins to the returned options. - Experimental: External Storage is now in Public Preview: set
DataConverter.ExternalStoragewith anIStorageDriverto 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 theEXTERNAL_STORAGE_FAILUREcause. - Experimental: Added
Temporalio.Extensions.Aws.S3Driverpackage with an S3 storage driver for external storage payloads, and an optionalTemporalio.Extensions.Aws.S3Driver.AwsSdkpackage with anAWSSDK.S3backed 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.
TemporalOperationHandlerremains 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 aBadRequestHandlerExceptionunless the first failed. Signals sent throughNexusOperationExecutionContext.Current.TemporalClientare not limited. - Experimental:
NexusOperationOptionsis 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_FAILUREis now counted onworkflow_task_execution_failedwithfailure_reason="ExternalStorageError", matching activity failures with the storage cause. It was previously counted asWorkflowError. - 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
503returned 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.TemporalClientin 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
c9c31a82Extend polling test server startup timeout (#1681)829eb7ebKeep legacy query preparation in replay mode (#1658)4433bf1bbuild(deps): update rstest requirement from 0.26 to 0.27 (#1683)0a5d6462Update API (#1690)34ee222cMigrate user-facing Rust SDK changelog to release fragments (#1635)b16e8088fix(core): preserve buffered queries across run eviction (#1693)ea118d37fix: skip wait conditions when a task only rejects updates (#1697)85975e9bClarify contributor restrictions on soliciting user information (#1680)7a7144e1Extend fixed test server startup timeout (#1698)42e9ada7feat: add external storage runner (#1696)aaa0db5fUse API activity failure cause (#1609)535216c6Add Required PR Checks job to gate merges (#1695)d28e7be2Propagate Nexus serialization context to workflow, update and activity tasks (#1717)2963d617refactor: separate storage driver errors from external storage errors (#1705)f49305f1feat: reject external storage references with TMPRL1105 (#1706)c4045f18Fallback to cgroup v1 for cpu in the resource based tuner (#1702)a3cf9059Fix heartbeat test poller configuration (#1723)e3f73fcafix: defer storage reference retrieval storage in describe calls (#1720)cd0e3d84feat: offload large payloads via external storage (#1708)3a4ad95eEnsure waiters are always notified in Nexus worker (#1244)d8720a5brefactor: gather external storage code into one module (#1726)70b594f1feat: report storage driver types in worker heartbeats (#1724)9ea86f57VLN-1791: fix mise-action-below-v5 (#1725)a7735951feat: provide storage drivers target information (#1728)4b3af8dbfeat(brook): add the dispatching Workflow Task to each Local Activity start (#1703)c198a965feat: offload activity heartbeat details to external storage (#1729)a7d198eeExtract shared sticky polling machinery (#1686)1fd54a9eReserve ephemeral ports on macOS (#1735)f4b8b2b3feat: report external storage failures with the storage failure cause (#1738)8dff9b84Test poller autoscaling signal handling (#1722)3c99279cfeat: accept plugin versions through the C bridge (#1751)e1ae09e0Complete ephemeral port teardown (#1754)96926faeRun required PR checks only on pull requests (#1748)ad7caa94build(deps): update lru requirement from 0.18 to 0.19 (#1742)bd999ef3build(deps): update rstest requirement from 0.27 to 0.28 (#1741)2f972ee6fix(client): apply the data converter to workflow user metadata (#1750)67174ea9fix: request update completion for execute update (#1755)51009f8cPreserve encoded schedule actions and add OTel header opt-in (#1734)3a83c693ci: remove macos-intel from PR builds (#1756)0713f0c2feat: report external storage metrics on workflow completions (#1740)1aebc388feat: store and retrieve a message's payload fields concurrently (#1744)b9016f4ffeat(envconfig): add extension support (#1736)d4ef50addocs: consolidate unreleased external storage changelog entries (#1761)ff30d403fix(client): send retained schedule actions back without re-storing them (#1758)8751afdbci: run the macOS arm jobs on macos-15 (#1763)687ffb05chore: bump rust version & wasmtime (#1767)4c3d2e49Synchronize worker shutdown eviction test (#1757)38dfee48fix: retry ephemeral server downloads and reduce port test churn (#1764)2af87425docs: fix stale crates/core paths after rename to sdk-core (#1771)f2770d0fReport poller target on each poll and in the worker heartbeat (#1688)96032e69Add extstore s3 driver (#1721)396c6adbchore: downversion s3 driver for manual release (#1777)c675c324chore: 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
- @atol made their first contribution in #979
- @cecilphillip made their first contribution in #1009
- @litlep-nibbyt made their first contribution in #954
- @veeral-patel made their first contribution in #1012
- @johanngan made their first contribution in #1018
- @JoshuaFrenchwood made their first contribution in #1026
Full Changelog: 1.21.0...1.22.0