TypeScript SDK
Mon
Wed
Fri
AugSepOctNovDecJanFebMarAprMayJunJulAug
LessMore
Releases19Avg6/moVersionsv1.17.2 to v1.22.0
Last Checked
8h ago
WorkflowRunOperationHandler.TypeInfo and TransferTypeConverter to @temporalio/common for converting
application values to and from serialization-friendly transfer types and supplying converter-specific hints.maxEagerActivityReservationsPerWorkflowTask. Setting it to zero disables
eager activity execution.TemporalNexusClient.getWorkflowHandle(...).update(...), in addition to a Workflow run.
The Update request carries the Nexus request ID (for deduplication), the request links, and a
completion callback bearing the operation token, so the Update's completion is delivered back to the
Nexus caller. Only asynchronous, ACCEPTED-stage updates are supported (a callback URL is
required); an update that has already completed is returned synchronously, and a completed-with-error
update (e.g. a validation rejection) surfaces as a failed Nexus operation. Cancellation is
customizable via the cancelWorkflowUpdate handler option; the default rejects with a
NOT_IMPLEMENTED handler error.@temporalio/ai-sdk: listToolsActivity/callToolActivity now reuse a single MCP client connection
across repeated invocations for the same server instead of creating and closing one on every call.
Configure the idle window via the new mcpConnectionIdleTimeout option on createActivities and
AiSdkPluginOptions (defaults to 5 minutes); pass mcpConnectionIdleTimeout: 0 to opt out and restore
the original behavior for MCP servers/transports that don't tolerate a reused or concurrent session.TemporalOperationHandler can now use Standalone Activities as asynchronous
Nexus Operation backing executions through TemporalNexusClient.startActivity and
typedActivity.65b25ada (temporal-core 0.6.0)zod as a peer dependency.callTool or listTools activity.WorkflowStream.onPoll no longer serves a stale log index for a poll that
was parked across a truncate() call, which could silently skip events.makeTestFunction to manage their test environment.quinn-proto in @temporalio/core-bridge's Cargo.lock from 0.11.14 to
0.11.15, clearing GHSA-4w2j-m93h-cj5j / RUSTSEC-2026-0185 (unbounded out-of-order stream
reassembly DoS) for downstream image scanners.@aws-sdk/client-s3 to the workflow bundler ignore list, fixing bundler errors when
using the S3-backed context-offloader vended plugin. The package is dynamically imported
worker-side and is never reached from workflow code.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 payloadSizeThreshold are stored via your StorageDriver(s) and retrieved
transparently, keeping large arguments, return values, and heartbeat details out of the Temporal Server
database. ExternalStorage and the StorageDriver types are exported from @temporalio/common.
Prerelease, Experimental: AWS S3 external storage driver: This release introduces a package which can be used with external storage to offload large payloads to S3 buckets in AWS instead of inlining them into workflow history.
Prerelease, Experimental: GCP GCS external storage driver: This release introduces a package which can be used with external storage to offload large payloads to GCS buckets in GCP instead of inlining them into workflow history.
ResourceBasedController can now be shared by resource-based tuners across multiple Workers in the same process.
Experimental New @temporalio/strands-agents package for building workflows with Strand Agents.
Experimental: @temporalio/openai-agents now supports streaming model events from Workflows.
Added opt-in envconfig support to the test workflow environment. This enables testing against arbitrary
Temporal server environments (i.e. local, staging, prod)
[TMPRL1103] at WARN) but still sent, while a task completion over the error limit is failed
retryably ([TMPRL1103] at ERROR) instead of sent. Previously these reached the server, which
terminated the workflow or failed the activity non-retryably; failing retryably instead lets a
corrected workflow or activity be redeployed and recover. Tune warn thresholds via
NativeConnectionOptions.payloadLimits. If you use a proxy between the worker and server that
alters the size of payloads (e.g. compression, encryption, external storage), it is advised that
you disable size enforcement by setting disablePayloadErrorLimit: true on the worker.@temporalio/ai-sdk now targets Vercel AI SDK v7, requiring Node 22.12.0+.nexus.HandlerError values thrown by payload codecs and converters.temporal_worker_task_slots_used no longer counts reserved but unused task slots as in use.strands: add @aws-sdk/client-s3 to the workflow bundler ignore list, fixing bundler errors when
using the S3-backed context-offloader vended plugin. The package is dynamically imported
worker-side and is never reached from workflow code.
TEMPORAL_TLS existing behavior when enabled was to disable TLS configuration. This has been corrected,
setting TEMPORAL_TLS now enables TLS configuration
__webpack_module_cache__ replacement logic, addressing regressions introduced by the fix in 1.20.1.__webpack_module_cache__ logic introduced by webpack 5.108.0, resulting in breaking workflow context isolation (fix #2170).@temporalio/langsmith package for tracing Temporal apps to LangSmith.
It hooks the client, Workflow, and Activity interceptors so a Workflow and the Activities it runs show up
as a single LangSmith run tree.5df57f6d. Package-visible changes from this update include:
NativeConnection initialization now retries without gRPC gzip compression if the server
cannot decompress the eager GetSystemInfo call.@temporalio/openai-agents: Query handlers and update validators now derive trace span IDs from the SDK's
replay-safe random source instead of a private seeded PRNG. This removes the old seed-collision workaround
and gives read-only handlers distinct, well-formed span IDs.__webpack_module_cache__ replacement logic, addressing regressions introduced by the fix in 1.19.1.__webpack_module_cache__ logic introduced by webpack 5.108.0, resulting in breaking workflow context isolation (fix #2170).WorkerOptions.patchActivationCallback to control whether newly encountered Workflow patches
activate and write a patch marker.@temporalio/interceptors-opentelemetry-v2 to support OpenTelemetry JS SDK 2.unsafe.random for read-only contexts.WorkflowHandle.runId in @temporalio/nexus is now an optional property to support creating a handle using only a workflow ID.grpcCompression: { codec: none } when constructing a NativeConnection.protobufjs bumped to 7.6.2NativeConnection on worker startup