---
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/1.37.x/changelog/"
source: "docs/reference-java_versioned_docs/version-1.37.x/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-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/1.37/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/1.37.x/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/1.35/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/1.37.x/flows-and-steps/failure-and-redelivery.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/1.35/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/1.37.x/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/1.37.x/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/1.37.x/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/1.31/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).