# What changed in @temporalio/client

> 40 changes in @temporalio/client 1 from its official release notes, upgrade guides and advisories: 6 breaking, 17 new APIs and options. Each one cited. Sources checked 2026-10-22. HTML: https://unstale.sh/npm/@temporalio/client/

To see which of these apply to a repository, run `npx @unstale/cli init` in it.

## @temporalio/client 1

### Breaking changes

- The selector now receives a StorageDriverSelectContext instead of a StorageDriverStoreContext; update the parameter type. (1.24.0) — [release notes](https://github.com/temporalio/sdk-typescript/blob/6a188eea837b77db33e2254397dc25b6c726b5cc/CHANGELOG.md#1240---2026-09-14)
- Workers now proactively validate outbound payload and memo sizes by default; warn thresholds can be tuned through payloadLimits. (1.21.0) — [release notes](https://github.com/temporalio/sdk-typescript/blob/6a188eea837b77db33e2254397dc25b6c726b5cc/CHANGELOG.md#1210---2026-07-23)
- Setting TEMPORAL_TLS now enables TLS configuration; previously, enabling it disabled TLS configuration. (1.21.0) — [release notes](https://github.com/temporalio/sdk-typescript/blob/6a188eea837b77db33e2254397dc25b6c726b5cc/CHANGELOG.md#1210---2026-07-23)
- gRPC gzip compression is enabled by default; pass grpcCompression: { codec: none } when constructing a NativeConnection to disable it. (1.19.0) — [release notes](https://github.com/temporalio/sdk-typescript/blob/6a188eea837b77db33e2254397dc25b6c726b5cc/CHANGELOG.md#1190---2026-07-01)
- The required Node version is now 20.3.0. (1.19.0) — [release notes](https://github.com/temporalio/sdk-typescript/blob/6a188eea837b77db33e2254397dc25b6c726b5cc/CHANGELOG.md#1190---2026-07-01)
- The @temporalio/openai-agents tracing sink was renamed to use the reserved __temporal_ prefix. (1.19.0) — [release notes](https://github.com/temporalio/sdk-typescript/blob/6a188eea837b77db33e2254397dc25b6c726b5cc/CHANGELOG.md#1190---2026-07-01)

### New APIs and options

- This option allows RawValue inputs and results to be preserved across serialization boundaries when explicitly configured on TypeInfo-aware APIs. (1.24.0) — [release notes](https://github.com/temporalio/sdk-typescript/blob/6a188eea837b77db33e2254397dc25b6c726b5cc/CHANGELOG.md#1240---2026-09-14)
- Creates a non-retryable ApplicationFailure with structured Payload validation details when provided; null or undefined produces a failure without details. (1.23.0) — [release notes](https://github.com/temporalio/sdk-typescript/blob/6a188eea837b77db33e2254397dc25b6c726b5cc/CHANGELOG.md#1230---2026-08-25)
- Added an experimental converter for converting application values to and from serialization-friendly transfer types. (1.22.0) — [release notes](https://github.com/temporalio/sdk-typescript/blob/6a188eea837b77db33e2254397dc25b6c726b5cc/CHANGELOG.md#1220---2026-08-05)
- Added an experimental type for supplying converter-specific hints when converting application values to serialization-friendly transfer types. (1.22.0) — [release notes](https://github.com/temporalio/sdk-typescript/blob/6a188eea837b77db33e2254397dc25b6c726b5cc/CHANGELOG.md#1220---2026-08-05)
- Configure external storage to offload payloads larger than payloadSizeThreshold and retrieve them transparently. (1.21.0) — [release notes](https://github.com/temporalio/sdk-typescript/blob/6a188eea837b77db33e2254397dc25b6c726b5cc/CHANGELOG.md#1210---2026-07-23)
- Set this worker option to true to disable size enforcement when a proxy alters payload sizes. (1.21.0) — [release notes](https://github.com/temporalio/sdk-typescript/blob/6a188eea837b77db33e2254397dc25b6c726b5cc/CHANGELOG.md#1210---2026-07-23)
- Opt-in envconfig support in the test workflow environment enables testing against arbitrary Temporal server environments. (1.21.0) — [release notes](https://github.com/temporalio/sdk-typescript/blob/6a188eea837b77db33e2254397dc25b6c726b5cc/CHANGELOG.md#1210---2026-07-23)
- An exported type for configuring external storage on a DataConverter. (1.21.0) — [release notes](https://github.com/temporalio/sdk-typescript/blob/6a188eea837b77db33e2254397dc25b6c726b5cc/CHANGELOG.md#1210---2026-07-23)
- An exported type for storage drivers used to offload large payloads. (1.21.0) — [release notes](https://github.com/temporalio/sdk-typescript/blob/6a188eea837b77db33e2254397dc25b6c726b5cc/CHANGELOG.md#1210---2026-07-23)
- A package providing a GCP GCS external storage driver for offloading large payloads. (1.21.0) — [release notes](https://github.com/temporalio/sdk-typescript/blob/6a188eea837b77db33e2254397dc25b6c726b5cc/CHANGELOG.md#1210---2026-07-23)
- A package providing an AWS S3 external storage driver for offloading large payloads. (1.21.0) — [release notes](https://github.com/temporalio/sdk-typescript/blob/6a188eea837b77db33e2254397dc25b6c726b5cc/CHANGELOG.md#1210---2026-07-23)
- 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. (1.20.0) — [release notes](https://github.com/temporalio/sdk-typescript/blob/6a188eea837b77db33e2254397dc25b6c726b5cc/CHANGELOG.md#1200---2026-07-07)
- Exposed the continue-as-new backoff start interval. (1.19.0) — [release notes](https://github.com/temporalio/sdk-typescript/blob/6a188eea837b77db33e2254397dc25b6c726b5cc/CHANGELOG.md#1190---2026-07-01)
- Added the package to support OpenTelemetry JS SDK 2. (1.19.0) — [release notes](https://github.com/temporalio/sdk-typescript/blob/6a188eea837b77db33e2254397dc25b6c726b5cc/CHANGELOG.md#1190---2026-07-01)
- Added nondeterministic unsafe.random for read-only contexts. (1.19.0) — [release notes](https://github.com/temporalio/sdk-typescript/blob/6a188eea837b77db33e2254397dc25b6c726b5cc/CHANGELOG.md#1190---2026-07-01)
- Added experimental patchActivationCallback to control whether newly encountered Workflow patches activate and write a patch marker. (1.19.0) — [release notes](https://github.com/temporalio/sdk-typescript/blob/6a188eea837b77db33e2254397dc25b6c726b5cc/CHANGELOG.md#1190---2026-07-01)
- In @temporalio/nexus, runId is now optional so a handle can be created using only a workflow ID. (1.19.0) — [release notes](https://github.com/temporalio/sdk-typescript/blob/6a188eea837b77db33e2254397dc25b6c726b5cc/CHANGELOG.md#1190---2026-07-01)

### Behavior and default changes

- Resource-based tuners can share a controller across multiple Workers in the same process. (1.21.0) — [release notes](https://github.com/temporalio/sdk-typescript/blob/6a188eea837b77db33e2254397dc25b6c726b5cc/CHANGELOG.md#1210---2026-07-23)
- staticSummary, staticDetails, currentDetails, activity summary, and timer summary are no longer marked experimental. (1.21.0) — [release notes](https://github.com/temporalio/sdk-typescript/blob/6a188eea837b77db33e2254397dc25b6c726b5cc/CHANGELOG.md#1210---2026-07-23)
- Failures from Core's periodic metric reader are now logged through Core telemetry. (1.20.0) — [release notes](https://github.com/temporalio/sdk-typescript/blob/6a188eea837b77db33e2254397dc25b6c726b5cc/CHANGELOG.md#1200---2026-07-07)
- 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. (1.19.0) — [release notes](https://github.com/temporalio/sdk-typescript/blob/6a188eea837b77db33e2254397dc25b6c726b5cc/CHANGELOG.md#1190---2026-07-01)
- Standalone Nexus operation links are formatted to align with server-side support and forwarded on start-workflow and signal requests. (1.19.0) — [release notes](https://github.com/temporalio/sdk-typescript/blob/6a188eea837b77db33e2254397dc25b6c726b5cc/CHANGELOG.md#1190---2026-07-01)
- Standalone Nexus operation links are forwarded on start-workflow and signal requests. (1.19.0) — [release notes](https://github.com/temporalio/sdk-typescript/blob/6a188eea837b77db33e2254397dc25b6c726b5cc/CHANGELOG.md#1190---2026-07-01)

### Fixes and other changes

- Activity errors converted to ApplicationFailure now preserve native Error.cause chains in serialized failures. (1.24.0) — [release notes](https://github.com/temporalio/sdk-typescript/blob/6a188eea837b77db33e2254397dc25b6c726b5cc/CHANGELOG.md#1240---2026-09-14)
- Workflow links now serialize to the temporal:///namespaces workflow URL with the optional reason as a query param, and inbound Workflow links are parsed. (1.24.0) — [release notes](https://github.com/temporalio/sdk-typescript/blob/6a188eea837b77db33e2254397dc25b6c726b5cc/CHANGELOG.md#1240---2026-09-14)
- Durations of 0 are now preserved instead of converted to undefined, so zero remains a legitimate optional duration. (1.23.0) — [release notes](https://github.com/temporalio/sdk-typescript/blob/6a188eea837b77db33e2254397dc25b6c726b5cc/CHANGELOG.md#1230---2026-08-25)
- Added to the workflow bundler ignore list to fix bundler errors when using the S3-backed context-offloader vended plugin. (1.21.1) — [release notes](https://github.com/temporalio/sdk-typescript/blob/6a188eea837b77db33e2254397dc25b6c726b5cc/CHANGELOG.md#1211---2026-07-23)
- Nexus operation handlers now preserve HandlerError values thrown by payload codecs and converters. (1.21.0) — [release notes](https://github.com/temporalio/sdk-typescript/blob/6a188eea837b77db33e2254397dc25b6c726b5cc/CHANGELOG.md#1210---2026-07-23)
- Workflow Bundler replacement logic was strengthened to address regressions introduced by the fix in 1.20.1. (1.20.3) — [release notes](https://github.com/temporalio/sdk-typescript/blob/6a188eea837b77db33e2254397dc25b6c726b5cc/CHANGELOG.md#1203---2026-07-13)
- Resolves the LangSmith workflow interceptor module by absolute path. (1.20.2) — [release notes](https://github.com/temporalio/sdk-typescript/blob/6a188eea837b77db33e2254397dc25b6c726b5cc/CHANGELOG.md#1202---2026-07-08)
- Initialization retries without gRPC gzip compression if the server cannot decompress the eager GetSystemInfo call. (1.20.0) — [release notes](https://github.com/temporalio/sdk-typescript/blob/6a188eea837b77db33e2254397dc25b6c726b5cc/CHANGELOG.md#1200---2026-07-07)
- 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. (1.20.0) — [release notes](https://github.com/temporalio/sdk-typescript/blob/6a188eea837b77db33e2254397dc25b6c726b5cc/CHANGELOG.md#1200---2026-07-07)
- Replay honors SDK flags already recorded in history even when the server does not advertise SDK metadata support. (1.20.0) — [release notes](https://github.com/temporalio/sdk-typescript/blob/6a188eea837b77db33e2254397dc25b6c726b5cc/CHANGELOG.md#1200---2026-07-07)
- Fixed a Workflow Bundler bug in replacement of __webpack_module_cache__ logic introduced by webpack 5.108.0 that broke workflow context isolation. (1.19.1) — [release notes](https://github.com/temporalio/sdk-typescript/blob/6a188eea837b77db33e2254397dc25b6c726b5cc/CHANGELOG.md#1201---2026-07-07), [release notes](https://github.com/temporalio/sdk-typescript/blob/6a188eea837b77db33e2254397dc25b6c726b5cc/CHANGELOG.md#1191---2026-07-07)