---
title: "Change log"
description: "This page lists user-visible changes to the Java SDK, newest first; each section covers the changes since the previous release of this component."
canonical_url: "https://docs.superdurable.io/reference/java/changelog/"
source: "docs/reference/java/changelog.mdx"
locale: "en"
---

# Change log

This page lists user-visible changes to the Java SDK, newest first; each section covers the changes since the previous release of this component.

<a id="v1-45"></a>

## 1.45

Released 2026-11-11 as [sdk-java/v1.45.0](https://github.com/superdurable/dex/releases/tag/sdk-java%2Fv1.45.0).

### Added

- **WorkerOptions.Builder.flowDefinitionPaths** and **WorkerOptions.Builder.flowDefinitions** make a **Worker** upload Flow Definition Graph documents when it starts, so Dex Web can draw the Flow types it registers. **FlowDefinitionDocument** holds an in-memory document. Upload failures, including a Server without Flow definition storage, are logged as warnings and never stop the Worker. [Reference](https://docs.superdurable.io/reference/java/workers.md#upload-flow-definitions).
- **Client.uploadFlowDefinitions** uploads documents from a deploy or CI script and returns a **FlowDefinitionUploadResult** with a **FlowDefinitionUploadOutcome** for each document. [Reference](https://docs.superdurable.io/reference/java/client.md#api-names).

### Breaking

- A Step whose Step type contains **-** can no longer start SubFlows. The child Flow ID joins the parent Flow ID, Step execution ID, and SubFlow index with **-**, so a dash made two parents share one child. When such a Step's **waitFor** returns a **SubFlow\.run** condition, the server rejects the result as an invalid Worker response and fails the attempt without retry; with the default failure policy, the Flow fails. Steps that start no SubFlows are unaffected. To migrate, rename the Step type, for example by overriding **getStepType**; the rename changes the child Flow IDs of new SubFlow starts. [Reference](https://docs.superdurable.io/reference/java/subflow.md#step-types-that-start-subflows).

### Fixed

- The **Join** documentation no longer recommends reporting a result for a cancelled branch from the cancelling RPC, which could count that branch twice. A cancelled branch never reports, and no other code can safely report for it. [Reference](https://docs.superdurable.io/reference/java/waits.md).

<a id="v1-44"></a>

## 1.44

Released 2026-11-10 as [sdk-java/v1.44.0](https://github.com/superdurable/dex/releases/tag/sdk-java%2Fv1.44.0).

### Added

- **Join** and **JoinRound** synchronize parallel branches of one Flow. **Join.fork** starts a round from a split Step and derives the round key and branch count; **Join.forkWithRoundKey** takes an application key, for example in an RPC. Branches report with **endBranch** or **reportBranchResult**. The join Step waits with **forAllBranches**, **forFirstBranch**, or **forBranches**, and the next round resets with **forRemainingBranches**. A Join is stored as a ChannelMap with the same name; **Join.getChannelMap** returns it for reading a round's pending results, never for publishing. [Reference](https://docs.superdurable.io/reference/java/waits.md).
- **StepDecision.goToMany(List)** and **RPCResult.of(output, List)** accept a list of movements, such as the result of **Join.fork**, and behave like the varargs forms. A call with a literal **null** argument is now ambiguous and no longer compiles; it always threw at run time. [Reference](https://docs.superdurable.io/reference/java/step-decisions.md#gotomulti).

<a id="v1-43"></a>

## 1.43

Released 2026-11-10 as [sdk-java/v1.43.0](https://github.com/superdurable/dex/releases/tag/sdk-java%2Fv1.43.0).

### Breaking

- Removed **Client.triggerContinueAsNew**, **FlowStatus.CONTINUED_AS_NEW**, **FlowConfig.Builder.continueAsNewThreshold**, **FlowConfig.Builder.continueAsNewPageSizeBytes**, **SearchFlowsOptions**, and the four-argument **Client.searchFlows** overload. Use the three-argument search method. [Reference](https://docs.superdurable.io/reference/java/flow.md#flow-config).
- Removed **WaitForStepCompletionOptions.Builder.internalHandlerTimeout** and **WaitForAttributeOptions.Builder.internalHandlerTimeout**. Request IDs remain accepted but the server does not read them for these waits. [Reference](https://docs.superdurable.io/reference/server/runtime-client.md#wait-timeouts-and-limits).
- Generated bindings rename **FlowExecutionID** to **FlowRunID** and **getFlowExecutionId** to **getFlowRunId**. ProtoJSON uses **flowRunId**. [Reference](https://docs.superdurable.io/reference/server/runtime-client.md#describe-a-flow).

<a id="v1-41"></a>

## 1.41

Released 2026-11-09 as [sdk-java/v1.41.0](https://github.com/superdurable/dex/releases/tag/sdk-java%2Fv1.41.0). No API or behavior changes.

### Changed

- The SDK README now says that only a completed Flow result carries outputs; an unsuccessful result has none.

<a id="v1-40"></a>

## 1.40

Released 2026-11-09 as [sdk-java/v1.40.0](https://github.com/superdurable/dex/releases/tag/sdk-java%2Fv1.40.0).

### Added

- **FlowConfig.Builder.offloadHistory(boolean)** chooses whether a run offloads its history to object storage. Omitting it means true. Pass false for many short runs that close soon. Set it at start through **StartFlowOptions.Builder.configOverride** or in **SubFlowOptions**. A SubFlow otherwise inherits its parent's value, and **Client.updateFlowConfig** rejects it with INVALID_ARGUMENT. It requires server-zd 0.1.23 or later. [Reference](https://docs.superdurable.io/reference/server/configuration.md#history-offload).

### Changed

- **FlowConfig.Builder.deleteExpiredHistoryObjects(boolean)** is deprecated. It has no effect, and the SDK no longer sends it. Existing code that sets it still compiles.

<a id="v1-39"></a>

## 1.39

Released 2026-11-09 as [sdk-java/v1.39.0](https://github.com/superdurable/dex/releases/tag/sdk-java%2Fv1.39.0).

### Added

- **FlowConfig.Builder.deleteExpiredHistoryObjects(boolean)** controls expired history object deletion at start, on update, and for SubFlows. It requires history offload and server-zd 0.1.22 or later.

### Changed

- A LoadBlobs request names at most 1,000 entries. The SDK batches larger requests and keeps the input order.

<a id="v1-38"></a>

## 1.38

Released 2026-11-07 as [sdk-java/v1.38.0](https://github.com/superdurable/dex/releases/tag/sdk-java%2Fv1.38.0).

### Added

- **FlowConfig.Builder.historyWindowEvents** sets about how many of the newest history events a run keeps for history reads and Time Travel. Set it at start, change it with **Client.updateFlowConfig**, or override it for a SubFlow. Omitting it uses the server's **history.windowEvents** setting. Dex rejects a value that is not positive or exceeds **history.maxWindowEvents** with INVALID_ARGUMENT. It requires server-zd 0.1.21 or later. [Reference](https://docs.superdurable.io/reference/server/configuration.md#history-window).

<a id="v1-37"></a>

## 1.37

Released 2026-11-06 as [sdk-java/v1.37.0](https://github.com/superdurable/dex/releases/tag/sdk-java%2Fv1.37.0). Reference: [1.37.x](https://docs.superdurable.io/reference/java/1.37.x.md).

### Added

- **FlowServiceTlsOptions** and **flowServiceTls** on Client and Worker option builders enable verified TLS, with optional extra root CAs and a server-name override. Omitting the option keeps plaintext connections. [API reference](https://docs.superdurable.io/api/java/latest/io/superdurable/dex/FlowServiceTlsOptions.html).

<a id="v1-35"></a>

## 1.35

Released 2026-11-06 as [sdk-java/v1.35.0](https://github.com/superdurable/dex/releases/tag/sdk-java%2Fv1.35.0). Reference: [1.35.x](https://docs.superdurable.io/reference/java.md).

### Breaking

- Workers and the Client’s first call now require server-zd 0.1.17 or later (protocol version 4). Upgrade all server processes before upgrading the SDK. [Reference](https://docs.superdurable.io/reference/server/upgrades.md).
- Worker startup fails when **maxConcurrentTasks** exceeds **matching.maxConcurrentTasksCap** (256 by default). Lower the Worker setting or raise the server cap and **matching.maxStreams** first. [Reference](https://docs.superdurable.io/reference/java/workers.md#capacity-and-shutdown).
- **RetryPolicy.Builder.totalDuration** now starts at the first hand-out and only gates scheduling another retry. Set method timeouts to bound running attempts. [API reference](https://docs.superdurable.io/api/java/latest/io/superdurable/dex/RetryPolicy.Builder.html).
- A Step with no available or supporting Worker waits durably without consuming a retry. Set a Flow timeout to bound that wait. [Reference](https://docs.superdurable.io/reference/server/workers.md#step-task-queue).
- A Step attempt interrupted after its hand-out was committed fails with **NOT_COMPLETED** and consumes a retry. Review retry policies and side effects before upgrading. [Reference](https://docs.superdurable.io/reference/java/failure-and-retries.md#same-attempt-redelivery).

### Added

- **RecoveryErrorInfo.getAttemptProgress()** distinguishes a failed Step method that never started from one that may have run. [API reference](https://docs.superdurable.io/api/java/latest/io/superdurable/dex/RecoveryErrorInfo.html).

### Changed

- Workers open one execution stream per slot; **reservedRpcTasks** selects RPC-only slots. By default, a Worker with at least two slots reserves one for RPCs. [Reference](https://docs.superdurable.io/reference/java/workers.md#capacity-and-shutdown).
- **stop** drains running handlers and returns tasks that did not start without consuming a retry. [Reference](https://docs.superdurable.io/reference/java/workers.md#capacity-and-shutdown).

### Deprecated

- **idleStreamsPerQueue** is accepted but ignored, and **getPullReservedRpcDeclines()** always reports zero. Use execution-slot capacity and queue metrics instead. [Reference](https://docs.superdurable.io/reference/java/workers.md#reserved-rpc-capacity).

<a id="v1-32"></a>

## 1.32

Released 2026-11-01 as [sdk-java/v1.32.0](https://github.com/superdurable/dex/releases/tag/sdk-java%2Fv1.32.0). Reference: [1.32.x](https://docs.superdurable.io/reference/java.md).

### Added

- Generated protocol bindings include **AdminService**, with **DescribeActiveNode** and **StepDownActiveNode** for inspecting and stepping down the active server process. [Release notes](https://github.com/superdurable/dex/releases/tag/sdk-java%2Fv1.32.0).

<a id="v1-31"></a>

## 1.31

Released 2026-10-31 as [sdk-java/v1.31.0](https://github.com/superdurable/dex/releases/tag/sdk-java%2Fv1.31.0). Reference: [1.31.x](https://docs.superdurable.io/reference/java.md).

### Added

- **Client.getAttributes** reads committed Attributes and AttributeMap instances in one request without a Worker. **AttributeMap.instance** selects an instance, and **AttributeValues.get** returns an **Optional** value. [API reference](https://docs.superdurable.io/api/java/latest/io/superdurable/dex/Client.html).

<a id="v1-30"></a>

## 1.30

Released 2026-10-31 as [sdk-java/v1.30.0](https://github.com/superdurable/dex/releases/tag/sdk-java%2Fv1.30.0). Reference: [1.30.x](https://docs.superdurable.io/reference/java.md).

### Added

- Generated protocol bindings add **ERROR_SUB_STATUS_ATTRIBUTE_INDEX_CAPACITY_EXCEEDED** and **ERROR_SUB_STATUS_INDEXED_KEYWORD_TOO_LONG** for Attribute index admission errors. [Release notes](https://github.com/superdurable/dex/releases/tag/sdk-java%2Fv1.30.0).

Older releases: [GitHub releases](https://github.com/superdurable/dex/releases?q=sdk-java\&expanded=true).