npm / @temporalio/client
@temporalio/client
What changed in @temporalio/client 1, from its official release notes, upgrade guides and advisories. Also covers @temporalio/common, @temporalio/interceptors-opentelemetry, @temporalio/testing, @temporalio/worker, @temporalio/workflow. Sources checked 2026-10-22.
6 breaking17 new APIs and options6 behavior and defaults11 fixes and other
See which of these apply to your code, ranked, in your agent:
npx @unstale/cli init@temporalio/client 140 changes
Breaking changes 6
The selector now receives a StorageDriverSelectContext instead of a StorageDriverStoreContext; update the parameter type.
Workers now proactively validate outbound payload and memo sizes by default; warn thresholds can be tuned through payloadLimits.
Setting TEMPORAL_TLS now enables TLS configuration; previously, enabling it disabled TLS configuration.
gRPC gzip compression is enabled by default; pass grpcCompression: { codec: none } when constructing a NativeConnection to disable it.
The required Node version is now 20.3.0.
The @temporalio/openai-agents tracing sink was renamed to use the reserved __temporal_ prefix.
New APIs and options 17
This option allows RawValue inputs and results to be preserved across serialization boundaries when explicitly configured on TypeInfo-aware APIs.
Creates a non-retryable ApplicationFailure with structured Payload validation details when provided; null or undefined produces a failure without details.
Added an experimental converter for converting application values to and from serialization-friendly transfer types.
Added an experimental type for supplying converter-specific hints when converting application values to serialization-friendly transfer types.
Configure external storage to offload payloads larger than payloadSizeThreshold and retrieve them transparently.
Set this worker option to true to disable size enforcement when a proxy alters payload sizes.
Opt-in envconfig support in the test workflow environment enables testing against arbitrary Temporal server environments.
An exported type for configuring external storage on a DataConverter.
An exported type for storage drivers used to offload large payloads.
A package providing a GCP GCS external storage driver for offloading large payloads.
A package providing an AWS S3 external storage driver for offloading large payloads.
Adds a package for tracing Temporal apps to LangSmith; client, Workflow, and Activity interceptors make a Workflow and its Activities appear as a single run tree.
Exposed the continue-as-new backoff start interval.
Added the package to support OpenTelemetry JS SDK 2.
Added nondeterministic unsafe.random for read-only contexts.
Added experimental patchActivationCallback to control whether newly encountered Workflow patches activate and write a patch marker.
In @temporalio/nexus, runId is now optional so a handle can be created using only a workflow ID.
Behavior and default changes 6
Resource-based tuners can share a controller across multiple Workers in the same process.
staticSummary, staticDetails, currentDetails, activity summary, and timer summary are no longer marked experimental.
Failures from Core's periodic metric reader are now logged through Core telemetry.
Signal and signal-with-start requests forward inbound Nexus links to the signaled workflow, and attach the returned event link to the caller's operation history event.
Standalone Nexus operation links are formatted to align with server-side support and forwarded on start-workflow and signal requests.
Standalone Nexus operation links are forwarded on start-workflow and signal requests.
Fixes and other changes 11
Activity errors converted to ApplicationFailure now preserve native Error.cause chains in serialized failures.
Workflow links now serialize to the temporal:///namespaces workflow URL with the optional reason as a query param, and inbound Workflow links are parsed.
Durations of 0 are now preserved instead of converted to undefined, so zero remains a legitimate optional duration.
Added to the workflow bundler ignore list to fix bundler errors when using the S3-backed context-offloader vended plugin.
Nexus operation handlers now preserve HandlerError values thrown by payload codecs and converters.
Workflow Bundler replacement logic was strengthened to address regressions introduced by the fix in 1.20.1.
Resolves the LangSmith workflow interceptor module by absolute path.
Initialization retries without gRPC gzip compression if the server cannot decompress the eager GetSystemInfo call.
Query handlers and update validators derive trace span IDs from the SDK's replay-safe random source instead of a private seeded PRNG, removing the seed-collision workaround and giving read-only handlers distinct, well-formed span IDs.
Replay honors SDK flags already recorded in history even when the server does not advertise SDK metadata support.
Fixed a Workflow Bundler bug in replacement of __webpack_module_cache__ logic introduced by webpack 5.108.0 that broke workflow context isolation.