Added
-
Experimental:
StorageDriverStoreContextandStorageDriverSelectContextnow have an optionalnamespacefield holding the namespace of the client or worker performing the operation. -
Experimental: Added Nexus completion notification bindings in
@temporalio/nexus/notifications. -
Add
LocalActivityOptions.includeArgumentsInMarkerto optionally record serialized local Activity arguments in Workflow history. Defaults tofalse. -
Add opt-in
WorkerOptions.codecHeadersto decode incoming Workflow and Activity headers and encode headers emitted by Workflows, including tracing headers. User-provided Payload headers supplied through client APIs are not automatically encoded. -
Both OpenTelemetry plugins can opt into encoding their own client tracing headers with
encodeClientHeaders: true, using the configured client codecs without encoding other user-supplied headers. -
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. -
@temporalio/envconfigadds experimental client config extensions:loadClientConnectConfigacceptsextensionsthat read their own config fromprofile.<profile>.ext.<name>TOML tables (never rejected by strict mode) and env vars, and contribute plugins toconnectionOptions.plugins. -
Experimental:
@temporalio/core-bridgecan be built from source with--fipsorTEMPORALIO_FIPS=1to use FIPS-approved TLS algorithms from AWS-LC's FIPS module. See the package README. -
Nexus operation handlers now propagate their
NexusSerializationContextto the Workflows and standalone Activities they start, which encode their results and failures (and a standalone Activity's heartbeat details) with it because these are returned to the Nexus caller. Clients decode them with the context the server returns, including handles obtained by ID and standalone Nexus operation handles. Requires a server that propagates the context. -
Added
ActivityInfo.nexusSerializationContext. To complete a Nexus-started standalone Activity asynchronously, pass it as theserializationContextoption of the task-tokencomplete,fail,reportCancellationandheartbeatcalls. -
Worker plugins can report a version in worker heartbeats, with the new optional
versionproperty onWorkerPluginor theversionoption ofSimplePlugin. -
Added
NativeConnectionOptions.keepAliveto configure the HTTP/2 keepalive interval and response timeout, or disable keepalive withfalse. Defaults remain a 30-second interval and a 15-second timeout. -
Core: A local activity's
ActivityTask.Starthasworkflow_task(field 21), with the started event id, attempt and start time of the workflow task in which Core dispatched it.workflow_taskalso hasprevious_started_event_id,previous_attemptandprevious_started_time, which name the run's last completed workflow task, andfailed_tasks, the started event ids of the run's last 100 failed or timed out workflow tasks. Retries that Core runs locally keep the value. Core leaves it unset for other activities. -
Core: Client environment config profiles include the raw TOML tables under
profile.<name>.ext, keyed by extension name, for SDK envconfig extensions. Strict mode accepts any content underext. The C bridge's profile JSON includes them as anextobject, with TOML datetimes as strings. -
Added support for an optional synchronous
flush()hook on worker runtime loggers through the publicFlushableLoggerinterface. The SDK flushes these loggers without closing them and isolates synchronous logger failures, with a stderr fallback for WARN/ERROR messages and flush-failure diagnostics. -
@temporalio/testingaddsDevServerConfig.startupTimeoutandTimeSkippingServerConfig.startupTimeout -
to configure how long to wait for dev and time-skipping test servers to become ready.
-
Nexus operation handlers now propagate their
NexusSerializationContextto the Workflow Updates they send, which encode their result, failure and rejection with it. Update handles decode them with the context the server returns. Requires a server that propagates the context.
Changed
-
Workers that set no poller options and aren't auto-enrolled now default to a 5-poller maximum instead of
min(10, maxConcurrent*Executions), matching the other SDKs. -
Experimental: The S3 and GCS storage drivers now key payloads stored without a target under
v0/ns/{namespace}/d/sha256/..., using the namespace of the storing client or worker (or the string"null"when it is unknown). Previously these payloads usedv0/d/sha256/.... -
@temporalio/workernow loads the Workflow bundler, including webpack, only when Workflow code is first bundled. Workers using a prebuiltworkflowBundleno longer load the bundler on import (#1718). -
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. (We'll use this count on the server side for now for load balancing pollers between workers, and for creating a per-worker poller count metric.)
-
Document TypeScript 5.7 as the minimum supported consumer compiler
💥 Breaking Changes
-
Runtime.loggerandRuntime.options.loggernow return an SDK wrapper around the logger passed toRuntime.install()rather than that logger itself. The SDK no longer calls aclose()method on runtime loggers at shutdown, andisFlushableLogger()is no longer exported from@temporalio/worker/lib/logger. -
Core: Core now rejects activation responses with a nondeterminism error if the activation contained only updates and the response rejects every update but also includes another workflow command. SDKs must return only update rejections when all validators reject an update-only activation.
-
Experimental: A Temporal operation handler can now send only one signal per invocation through
TemporalNexusClient.signalWithStartWorkflowandTemporalNexusClient.getWorkflowHandle().signal; a second one throws aBAD_REQUESThandler error unless the first failed. UseTemporalNexusClient.clientfor additional signals, which are not deduplicated. -
@temporalio/nyc-test-coveragenow declarests-loaderas an optional peer dependency instead of installing it automatically. Coverage users running tests with ts-node must install a version ofts-loadercompatible with their Node.js and TypeScript versions. -
MockActivityEnvironment.runnow accepts one generic type parameter for the Activity function instead of three; callers supplying explicit type arguments must update their calls.
Fixed
-
defaultGrpcRetryOptionsnow respects a custommaxIntervalMscallback instead of always using the default 5-second maximum backoff interval. -
Fix
OpenTelemetryPlugin(@temporalio/interceptors-opentelemetry-v2) dropping OpenTelemetry baggage across the client-to-Workflow and Workflow-to-Activity boundaries: the Workflow sandbox's propagator was hardcoded to trace-context-only, silently discarding thebaggageheader the client already sent. Trace ID and span parenting were unaffected. -
Make native
Temporal.Nowdate/time methods use deterministic Workflow time and reject unsupported clock methods. -
Experimental: Signals sent through
TemporalNexusClient.signalWithStartWorkflowandTemporalNexusClient.getWorkflowHandle().signalin a Temporal operation handler now reuse the operation's request ID, so a retried Nexus task no longer delivers the same signal twice. -
Loading a Workflow bundle no longer makes
source-map-supportretain the bundle's source map in the main thread's heap, which raised memory use and slowedWorker.create()whensource-map-support/registerwas loaded. -
Cancel the Activity when storing heartbeat details in external storage fails, allowing it to report the failure instead of hanging.
-
@temporalio/envconfignow converts every underscore in gRPC metadata keys to a hyphen, so keys such asTEMPORAL_GRPC_META_X_MY_HEADERmap tox-my-headerinstead ofx-my_header. -
Core: Preserve queued queries across workflow eviction so requests for the same run are answered instead of silently dropped.
-
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.
-
Fix Workflow Streams incorrectly treating application objects with empty
metadataas prebuilt payloads. -
Workflow stack traces no longer percent-encode source paths that contain spaces or non-ASCII characters.
source-map0.7.5 and later encode the paths they return, so the Worker now escapes%in source names and decodes what comes back. -
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: 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.
-
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: 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.
-
Preserve the primary error that terminated
Worker.run()when shutdown finalization fails, logging the cleanup error instead of masking the root cause withIllegalStateError. -
@temporalio/core-bridgenow loads its prebuilt native module through a literal path for each supported platform, so bundlers that embed native modules (such asbun build --compile) include it, and a compiled worker no longer fails at startup withPrebuildError: No prebuilt module found at /$bunfs/.... -
Preserve and append Activity and Nexus client interceptors when SimplePlugin merges client or worker client configuration.
-
Fix a regression introduced in 1.24.0 where Workflow payload codecs received empty protobuf defaults instead of
undefinedfor absent payload data, while preserving explicitly empty byte arrays. -
Fix return type inference for
MockActivityEnvironment.run.
Security
- Bump
rustlsin the core bridge to 0.23.46 to address GHSA-2mjx-qc3c-rqvc, GHSA-c8m5-c952-6cm4, GHSA-h2v8-394m-p7vv, and GHSA-w44r-93j7-qv28.