TypeScript SDK

Breaking Changes

• @temporalio/openai-agents now requires @openai/agents-core and @openai/agents-openai ~0.14.3. A project pinned to 0.13.x or earlier hits a peer dependency conflict until it upgrades.
• Experimental: External storage…

Breaking Changes

• Major upgrade of protobufjs to v8 and protobufjs-cli to v2.

  Temporal's protobuf messages types generated by protobufjs are exposed as part of our public API surface (mostly through @temporalio/proto and Client's raw gRPC interfaces).…

What's Changed

Added

• Experimental: Added TypeInfo and TransferTypeConverter to @temporalio/common for converting application values to and from serialization-friendly transfer types and supplying converter-specific hints.
• Workers can now configure…

What's Changed

• AI-338: drive langsmith workflow tracing from the SDK-provided AsyncLocalStorage by @xumaple in https://github.com/temporalio/sdk-typescript/pull/2217

Fixed

• fix(strands): ignore @aws-sdk/client-s3 in bundler by @brianstrauch in…

What's Changed

Added

• Prerelease, Experimental: You can now configure external storage on your DataConverter via the new externalStorage option to offload large payloads out of Temporal Server. When set, payloads larger than the configured…

What's Changed

Fixed

• Workflow Bundler: further strengthening of the webpack_module_cache replacement logic, addressing regressions introduced by the fix in 1.20.1.
• @temporalio/langsmith: install Workflow-bundle rewrites via compiler.webpack so they work under…

Fixed workflow interceptor module resolution for langsmith to use absolute paths instead of relative paths.

Backport of a fix addressing workflow state corruption that could occur when workflow updates fail. This resolves issue #2170.

Backport https://github.com/temporalio/sdk-typescript/pull/2169 to address https://github.com/temporalio/sdk-typescript/issues/2170

Backported a fix for activity heartbeat handling (PR #2169) to address issue #2170.

Backported a fix for workflow search attributes handling.

Backported a fix from PR #2169 to address issue #2170.

Backported a fix from PR #2169 addressing issue #2170.

New @temporalio/langsmith package hooks the client, Workflow, and Activity interceptors so Workflows and their Activities show up as a single LangSmith run tree. Core updated to improve gRPC decompression retry logic, honor SDK flags in Workflow replay, and fix OTLP metric export logging; @temporalio/openai-agents now derives trace span IDs from the SDK's replay-safe random source.

Node version requirement bumped to 20.3.0, and gRPC gzip compression is now enabled by default (disable via grpcCompression: { codec: none } if using a proxy without gzip support). Nexus operation link propagation now works for signals, making caller and callee mutually navigable in the UI, and WorkflowHandle.runId is now optional to support creating handles using only a workflow ID.

Bug Fixes

• [workflow-streams] Fix continue-as-new handling in workflow-streams subscribe (#2102)
• [activity] Correctly populate activity info task queue and namespace…

Corrective Release

Notable Changes

• [client, nexus] Standalone Nexus Operations support (#2027, #2085). Adds client.nexus, typed Nexus service clients, operation handles…

What's Changed

• [backport 1.16.2] Update core to pickup shutdown fix by @yuandrew in https://github.com/temporalio/sdk-typescript/pull/2057

Full Changelog: https://github.com/temporalio/sdk-typescript/compare/v1.16.1...v1.16.2

DNS Resolver Load Balancing Configuration

A new load balancing feature was added in https://github.com/temporalio/sdk-rust/pull/1212 which has caused networking issues in certain networking setups. This is now disabled by default via the change listed below…