25 Jun 16:23

github-actions

40d148c

v1.30.1 Latest

Latest

Bugfixes

Fixes a bug where the native test server was requiring newer CPU features then previous releases.

What's Changed

2025-06-25 - 1794822 - Build test server with march=compatibility (#2571)

Assets 8

24 Jun 21:46

github-actions

v1.30.0

dfbfc2b

v1.30.0

💥 BREAKING CHANGES

Workflow Metadata (Public Preview)

The built in __temporal_workflow_metadata query now uses io.temporal.common.converter.RawValue for the return type. This should help address issues where users data converters could not properly convert the WorkflowMetadata protobuf type. If you are using a custom data converter that does not support RawValue you will need to update it to support this type.

Note: The built in Temporal DefaultDataConverter already supports RawValue and does not require any changes.

Nexus

When an ApplicationFailure is returned from a Nexus operation handler the SDK will now translate it into an INTERNAL non-retryable error. Previously it was translated to a BAD_REQUEST error. This is to align with the behavior of Nexus operations in other SDKs.

Highlights

Nexus Operation Cancellation Types (Pre-release)

Users can now specify the cancellation type when cancelling a Nexus operations from a workflow. This allows for more granular control over how Nexus operations are cancelled, and how the caller is notified of the cancellation.

Springboot (Pre-release)

Temporal Java SDK Springboot integration now automatically registers Temporal interceptors. Interceptors will be registered in the order specified by the @Order annotation.
Temporal Java SDK Springboot integration now applies to Springboot Environment when discovering workflow implementations. This allows users to use the @Profile annotation to conditionally enable or disable workflow implementations.

Automatic Poller Scaling (Pre-release)

Users can now configure Workers to automatically scale the number of concurrent polls they make. To enable use setWorkflowTaskPollersBehavior, setNexusTaskPollersBehavior, and setActivityTaskPollersBehavior arguments of the WorkerOptions.Builder constructor to PollerBehaviorAutoscaling. You can expect fewer unnecessary polls during low load, and increased polls during high load when they can be used to increase task throughput.

Add ApplicationFailure Category

Add a new category property on ApplicationFailure. This new option allows controlling some of the observability and logging behaviors of the Worker related to a failure thrown from an Activity.

What's Changed

2025-04-21 - afb0183 - ARM64 build for Test Server (#2448)
2025-04-23 - 08d6089 - Remove old workflow run operation token format (#2486)
2025-04-23 - 0f9813c - Handle async completion in TestActivityEnvironment (#2487)
2025-04-24 - 2807771 - Warn if root thread yields (#2483)
2025-04-24 - 620eeaf - Update contrib (#2489)
2025-04-25 - 7460156 - Add application err category (#2485)
2025-04-29 - 3c9e819 - Add RawValue support (#2492)
2025-04-30 - 04fe25a - Fix NPE getting a non existent memo from a schedule. (#2497)
2025-04-30 - f6d4d46 - Make sure user metadata is set on WorkflowExecutionStartedEvent (#2496)
2025-05-01 - 537d99d - Add ApplicationFailure.Builder (#2495)
2025-05-02 - 1feb16f - Remove license in file (#2505)
2025-05-02 - 2e1c89e - Add support for dynamics workflows to Springboot (#2506)
2025-05-05 - 0d539ff - Support WorkflowImplementationOptionsCustomizer (#2503)
2025-05-05 - 0e8ac35 - Make @Profile annotation work (#2501)
2025-05-05 - 8fbb068 - Add interceptor support to springboot integration (#2500)
2025-05-06 - 7a09384 - Update proto v1.49.0 (#2510)
2025-05-07 - 4da87cc - Spring boot: fail creation if duplicate definitions detected (#2511)
2025-05-07 - e5bb3a5 - Bump edge Java SDK test version (#2507)
2025-05-08 - e7a7f0c - Set links in Nexus callback (#2513)
2025-05-09 - 6c961a0 - Make CancellationScopeImpl more deterministic (#2512)
2025-05-13 - b7c72a2 - Add num_pollers metric (#2514)
2025-05-14 - 076f981 - Add test coverage for starting a child workflow from a cancelled work… (#2516)
2025-05-14 - 3f294e1 - Remove license check from contrib (#2522)
2025-05-14 - 58a4200 - RequestIdInfo and links changes in test server (#2515)
2025-05-14 - 7046593 - Add test coverage for cancellation of external workflow (#2517)
2025-05-14 - b9458fc - Wire reason parameter in workflow cancellation request (#2519)
2025-05-14 - e8d9fda - Add API to count workflows (#2518)
2025-05-15 - d01c85b - Add AGENTS.md (#2527)
2025-05-16 - 437c612 - Fix Workflow.getWorkflowExecution for ExternalWorkflowStub (#2529)
2025-05-16 - 95314a2 - Versioning Override support (#2530)
2025-05-16 - e793db8 - Make asyncThrottlerExecutor use a daemon thread (#2528)
2025-05-26 - 2d9b906 - Fix newExternalWorkflowStub on a interfaces without a WorkflowMethod (#2531)
2025-05-26 - f45c947 - Cancel pending heartbeat when activity completes (#2526)
2025-05-27 - 0b88507 - Bump some proto dep. (#2536)
2025-05-27 - 5d64818 - Fix javadoc for ActivityExecutionContext.getHeartbeatDetails (#2525)
2025-05-28 - 44d9abe - Set TemporalChangeVersion when workflow version is updated (#2464)
2025-05-28 - 8613b18 - Fix nexus error translation (#2539)
2025-06-02 - cea73d3 - Add support for calling Workflow.getInfo from query handler (#2541)
2025-06-03 - ed2b8cc - Add an interceptor for listExecutions (#2524)
2025-06-04 - 35386da - Clear MDC context after each task (#2545)
2025-06-04 - dc1e26d - Update cloud ops apis to the latest (#2544)
2025-06-09 - 402392c - Use link from start workflow request for Nexus operations (#2547)
2025-06-10 - 0268390 - __temporal_workflow_metadata query responses should use "RawValue" (#2551)
2025-06-10 - 746d3c3 - Issue #2057: parsing workflow id from WorkflowExecutionStartedEventAttributes (#2542)
2025-06-11 - 4f313bb - Add poller autoscaling (#2535)
2025-06-11 - bdc94f7 - Add native build to CI and MUSL build (#2490)
2025-06-12 - 5978835 - Set deploymentOptions on other types of poll requests (#2555)
2025-06-12 - a25f6ba - Fix ignoreDuplicateDefinitions to log only if we are ignoring (#2553)
2025-06-12 - b581ede - Add poller autoscaling options for Springboot (#2554)
2025-06-12 - e7e3fa6 - Implement Nexus operation cancellation types (#2520)
2025-06-13 - 231c724 - Don't fail Springboot if a bean is specified twice (#2558)
2025-06-17 - 4686691 - Fix some dependency issues with NonRootBeanPostProcessor (#2556)
2025-06-17 - a120887 - Deprecate VersioningIntent (#2561)
2025-06-18 - 4a05f51 - Fix build-native-image action again (#2567)
2025-06-18 - 7e83945 - Release Java SDK v1.30.0-RC1 (#2563)
2025-06-18 - b3757fc - Fix build-native-image (#2566)
2025-06-24 - e6e0867 - Make sure PollerBehavior is marked as Experimental (#2569)

Contributors

Profile

Assets 8

18 Jun 20:23

github-actions

v1.30.0-RC1

4a05f51

v1.30.0-RC1 Pre-release

Pre-release

💥 BREAKING CHANGES

Workflow Metadata (Public Preview)

Note: The built in Temporal DefaultDataConverter already supports RawValue and does not require any changes.

Nexus

Highlights

Nexus Operation Cancellation Types (Pre-release)

Springboot (Pre-release)

Temporal Java SDK Springboot integration now automatically registers Temporal interceptors. Interceptors will be registered in the order specified by the @Order annotation.

Automatic Poller Scaling (Pre-release)

What's Changed

Contributors

Profile

Assets 8

15 Apr 22:09

github-actions

v1.29.0

a4c9e68

v1.29.0

💥 BREAKING CHANGES

Slot Supplier

The SlotSupplier interface was changed to be async to match other languages and allow for future optimizations in the SDK.

Highlights

Priority (Pre-release)

Users can now set a priority key when scheduling a workflow, activity or child workflow. The priority key will be used to help prioritize certain tasks over others when there is a backlog. Priority is currently not supported in any OSS Temporal release, but support will be coming soon. To experiment with this feature please see the pre-release development server or if you are a Temporal Cloud customer reach out to your SA.

Activity Pause (Pre-release)

The Java SDK now supports activity pause for heart beating activities. If an activity is paused while an attempt is running and the activity is heart-beating the heartbeat will throw an io.temporal.clientActivityPausedException.

Versioning / Safe Deploy (Pre-release)

This release introduces a preview of new APIs that gracefully manage code changes and worker pools that support them. The goal is to better control which workers should execute new, and existing, workflows and activities tasks, based on their code and configuration.

AutoUpgrade and Pinned are two Versioning Behaviors that can be specified on a workflow implementation using @WorkflowVersioningBehavior. Pinned workflows are typically short lived, and are never affected by new versions, i.e., they do not need to use the patch API for compatibility. AutoUpgrade workflows are mostly long running, but they need to use patching to safely transition to new versions. The choice of Pinned vs AutoUpgrade ultimately depends on your willingness to keep old worker fleets running vs the complexity of patching.

To manage Worker Deployments please use the Temporal CLI, or the WorkflowServiceStubs.

What's Changed

2025-03-10 - 73cb1e9 - Fix API key auth (#2438)
2025-03-10 - ff94971 - Release v1.28.1 (#2439)
2025-03-11 - 0271192 - Add OnConflictOptions Support (#2415)
2025-03-11 - 334e129 - Add support for metadata to test server (#2441)
2025-03-13 - f7b8ded - Unblock UseExisting conflict policy for Nexux WorkflowRunOperation (#2440)
2025-03-14 - 2377114 - Fix workflow ID reuse policy and conflict policy handling (#2446)
2025-03-17 - 48b7223 - Fix spring boot api key enable https (#2445)
2025-03-17 - d430114 - Add Summary to Nexus Operations (#2444)
2025-03-19 - 59bbabb - Make sure the Schedule Client has the namespace header injected (#2452)
2025-03-20 - 6c4c183 - Remove experimental tag from Nexus (#2454)
2025-03-24 - ead142e - 💥 [Breaking] Asyncify slot suppliers (#2433)
2025-03-25 - 93f124f - Priorities for Workflows/Activities (#2453)
2025-03-26 - ad4a426 - Ensure heartbeat details aren't cleared (#2460)
2025-03-31 - c9a1502 - Add support for start delay to the time skipping test server (#2462)
2025-04-02 - 75f5d1a - Update Gradle validation action (#2468)
2025-04-02 - b3b7806 - Worker Versioning Annotations & Options (#2463)
2025-04-07 - e3921b6 - Add support for workflow init in Springboot (#2470)
2025-04-15 - 78a766f - Align root workflow execution with real server (#2477)
2025-04-15 - 8808c40 - Add support for activity pause (#2476)
2025-04-15 - b6ae9b5 - De-flake asserting slot metrics (#2478)

Assets 5

02 Apr 17:25

github-actions

v1.28.4

a435dd7

v1.28.4

Highlights

Attaching multiple Nexus callers to an underlying handler Workflow is now available in Pre-release.

What's Changed

2025-04-02 - 6814906 - Ensure heartbeat details aren't cleared (#2460)
2025-04-02 - cdd6497 - Unblock UseExisting conflict policy for Nexus WorkflowRunOperation (#2440)

Assets 5

20 Mar 21:48

github-actions

v1.28.3

ecf3fb7

v1.28.3

What's Changed

2025-03-20 - eed7525 - Revert "Unblock UseExisting conflict policy for Nexux WorkflowRunOperation (#2440)"

Assets 5

20 Mar 19:08

github-actions

v1.28.2

fe4d0db

v1.28.2

Highlights

Nexus

🎉 Nexus is now generally available 🎉

Main Nexus APIs are no longer marked as experimental.
Attaching multiple Nexus callers to an underlying handler Workflow is now Pre-release.

What's Changed

2025-03-20 - 0099134 - Fix workflow ID reuse policy and conflict policy handling (#2446)
2025-03-20 - 0ee60c0 - Unblock UseExisting conflict policy for Nexux WorkflowRunOperation (#2440)
2025-03-20 - 1941d38 - Remove experimental tag from Nexus (#2454)
2025-03-20 - 1f3f068 - Fix spring boot api key enable https (#2445)
2025-03-20 - 26de251 - Make sure the Schedule Client has the namespace header injected (#2452)
2025-03-20 - e3fbdfb - Add OnConflictOptions Support (#2415)

Assets 5

10 Mar 18:03

github-actions

v1.28.1

ff94971

v1.28.1

💥 BREAKING CHANGES

API Keys

The SDK will now automatically set the temporal-namespace header on all gRPC request made by the WorkflowClient. Users
should no longer manually set this header.

To use API keys users should follow this example:

    WorkflowServiceStubs service =
        WorkflowServiceStubs.newServiceStubs(
            WorkflowServiceStubsOptions.newBuilder()
                .addApiKey(
                    () ->
                        <API key>)
                .setTarget(<endpoint>)
                .setEnableHttps(true)
                ...
                .build());

    WorkflowClient client =
        WorkflowClient.newInstance(
            service, WorkflowClientOptions.newBuilder().setNamespace(<namespace_id>.<account_id>).build());

Bugfixes

API Keys

Fixed an issue where API keys were not being properly set in the WorkflowClient when using the Spring Boot integration.
Fixed an issue where a worker connecting to a Temporal server with an unconnected client would fail to authenticate.

What's Changed

2025-03-10 - 73cb1e9 - Fix API key auth (#2438)

Assets 5

26 Feb 19:07

github-actions

v1.28.0

6b05cd8

v1.28.0

💥 BREAKING CHANGES

Nexus (Public Preview)

⚠️ IMPORTANT ⚠️ This SDK release requires server >=1.27.0 to properly support the full set of changes from the previous SDK release. Most notably the built-in error translation logic changed in a way that may cause Nexus tasks to retry until the caller specified schedule-to-close timeout on certain failures, see more below.
Setting WorkflowIDConflictPolicy to WORKFLOW_ID_CONFLICT_POLICY_USE_EXISTING has been temporarily disabled, and will fail requests with a retryable internal error.
- This is to protect users from making a false assumption that the same workflow can be used to back multiple operations. This capability will be enabled in a follow up release.
WorkflowClientOperationHandlers was renamed to WorkflowRunOperation
OperationId was renamed to OperationToken and the content for a WorkflowRunOperation of it was changed to a structured token instead of copying the workflow ID directly.
Removed WorkflowClient from the input of all Temporal nexus handlers, a client can now be accessed by calling Nexus.getOperationContext().getWorkflowClient()
FailureConverter now supports serializing and deserializing HandlerException . Previously these may have been deserialized as ApplicationFailure .
- Note: This is can potentially cause Non-Determinism exceptions if users were handling ApplicationFailure .
The promise returned from NexusOperationHandle.getExecution() now correctly will return the appropriate exception if the underlying nexus fails in a synchronous manner
- Note: This is can potentially cause Non-Determinism exceptions if users called NexusOperationHandle.getExecution()

Failure Converter

The FailureConverter interface was changed. FailureConverter.failureToException now can return any type implementing RuntimeException instead of just types implementing TemporalFailure

Java Protobuf 3/4 Support

The Temporal Java SDK now supports protobuf-java 3.x and 4.x. To support these, the Temporal Java SDK allows any protobuf library >= 3.25. Temporal strongly recommends using the latest protobuf-java 4.x library unless you absolutely cannot. If you cannot use protobuf-java 3.25 >=, you can try temporal-shaded which includes a shaded version of the protobuf-java library.

Highlights

Spring Boot API Key support

The Java SDK Spring Boot integration now directly supports API key authentication.

For documentation see: https://github.com/temporalio/sdk-java/tree/master/temporal-spring-boot-autoconfigure#api-keys

Spring Boot Multi-Namespace support (Experimental)

The Java SDK Spring Boot integration now has experimental support for running multiple none-root namespace along side the root namespace.

For documentation see: https://github.com/temporalio/sdk-java/tree/master/temporal-spring-boot-autoconfigure#running-multiple-name-space-experimental

What's Changed

2024-12-09 - e1bef89 - Update protocloud submodule (#2344)
2024-12-12 - 53a8af7 - Remove Experimental annotations from Update APIs (#2347)
2024-12-27 - c3e0e77 - Set request Id on SignalWorkflowExecutionRequest (#2352)
2025-01-06 - 82d3c93 - Update Java SDK for Temporal Sever v1.26.2 (#2357)
2025-01-06 - 9a8894a - Set LastHeartbeatDetails on activity failure (#2354)
2025-01-06 - ff333ca - Add javadocs for ActivityCompletionClient (#2353)
2025-01-08 - cf06131 - Test server support for Nexus operation complete before start (#2348)
2025-01-15 - 35e390e - Add method to get workflow client from an activity (#2369)
2025-01-16 - 90e5125 - Fix NDE caused by removing Workflow.getVersion with a succeeding Work… (#2370)
2025-01-16 - b187644 - Add details to manifest (#2355)
2025-01-16 - b593b35 - [OpenTracing] Wrap returned promises in OutboundCallsInterceptor (#2366)
2025-01-17 - 3ad0b0e - Avoid lock up on unexpected ExecutorService errors while executing Local Activities (#2371)
2025-01-22 - b471e13 - Access to workflow/activity instance from context (#2384)
2025-01-22 - c51e5d1 - Upgrade some test dependencies (#2382)
2025-01-22 - cdbc520 - Split up & use more appropriate timeouts for parallel LAs test (#2385)
2025-01-28 - 8b17a52 - Support Proto 3 and 4 (#2383)
2025-01-28 - ce90d24 - Enable speculative workflow tasks (#2390)
2025-01-28 - f93910b - Make sure GetVersion never yields (#2376)
2025-02-03 - de33b3a - Update docs for max workflow task timeout (#2396)
2025-02-04 - fd65ea9 - Inject namespace header (#2400)
2025-02-07 - 32df8d4 - Remove Nexus sync client handler (#2403)
2025-02-07 - 76630fe - Update max task timeout (#2407)
2025-02-10 - 32fbf02 - Fix kotlin child workflow execute varargs (#2395)
2025-02-10 - f9a9cad - Rename WorkflowClientOperationHandlers->WorkflowRunOperation (#2405)
2025-02-10 - fc4d714 - Update proto v1.44.0 (#2406)
2025-02-11 - 00f7dd0 - Add API key property to Springboot (#2408)
2025-02-11 - 24f225c - Java test server support for attaching links to signal and signal with start requests (#2411)
2025-02-12 - c6e0306 - Special behavior for Temporal built-in prefixes (#2409)
2025-02-17 - c6375d6 - feat: multi namespace support (#2378)
2025-02-18 - 436d080 - Add Graal reflection config for UwS (#2363)
2025-02-18 - 6f4621d - Update readme for multi namespace support (#2416)
2025-02-18 - a2455af - Make sure workflow_task_execution_failed always has a failure_reason (#2419)
2025-02-18 - a643a79 - Add nexus configuration to spring boot readme (#2417)
2025-02-20 - f92b53c - 💥 Nexus error rehydration (#2365)
2025-02-21 - 963ea9f - Add sdk name/version to task completions when unset or changed (#2422)
2025-02-24 - 49bd366 - Add support for operation timeout header (#2427)
2025-02-24 - 729e25e - Workflow run token (#2421)
2025-02-24 - d0cf3f3 - Add support for attaching to a running workflow (#2424)
2025-02-25 - 7cd4932 - fix documentation in CapacityConfigurationProperties (#2429)
2025-02-25 - f90c57b - Block using conflict policy UseExisting for Nexus WorkflowRunOperation (#2428)

Assets 5

05 Feb 22:10

github-actions

v1.27.1

a425065

v1.27.1

Highlights

Fixes an exception when de-serializing a failure from a Nexus operation written by Temporal Sever v1.26.2+.

What's Changed

Assets 5

Releases: temporalio/sdk-java

v1.30.1

Bugfixes

What's Changed

Uh oh!

v1.30.0

💥 BREAKING CHANGES

Workflow Metadata (Public Preview)

Nexus

Highlights

Nexus Operation Cancellation Types (Pre-release)

Springboot (Pre-release)

Automatic Poller Scaling (Pre-release)

Add ApplicationFailure Category

What's Changed

Contributors

Uh oh!

v1.30.0-RC1

💥 BREAKING CHANGES

Workflow Metadata (Public Preview)

Nexus

Highlights

Nexus Operation Cancellation Types (Pre-release)

Springboot (Pre-release)

Automatic Poller Scaling (Pre-release)

What's Changed

Contributors

Uh oh!

v1.29.0

💥 BREAKING CHANGES

Slot Supplier

Highlights

Priority (Pre-release)

Activity Pause (Pre-release)

Versioning / Safe Deploy (Pre-release)

What's Changed

Uh oh!

v1.28.4

Highlights

What's Changed

Uh oh!

v1.28.3

What's Changed

Uh oh!

v1.28.2

Highlights

Nexus

What's Changed

Uh oh!

v1.28.1

💥 BREAKING CHANGES

API Keys

Bugfixes

API Keys

What's Changed

Uh oh!

v1.28.0

💥 BREAKING CHANGES

Nexus (Public Preview)

Failure Converter

Java Protobuf 3/4 Support

Highlights

Spring Boot API Key support

Spring Boot Multi-Namespace support (Experimental)

What's Changed

Uh oh!

v1.27.1

Highlights

What's Changed

Uh oh!