From 7b03df6d10bd36dcb99740c9cdfc14b2d157bb04 Mon Sep 17 00:00:00 2001 From: Joie Wu Date: Wed, 14 Oct 2026 13:49:08 -0700 Subject: [PATCH 1/9] docs: mark standalone Nexus sample public preview --- .../java/io/temporal/samples/nexusstandalone/README.MD | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/core/src/main/java/io/temporal/samples/nexusstandalone/README.MD b/core/src/main/java/io/temporal/samples/nexusstandalone/README.MD index eee6d684..5d557d33 100644 --- a/core/src/main/java/io/temporal/samples/nexusstandalone/README.MD +++ b/core/src/main/java/io/temporal/samples/nexusstandalone/README.MD @@ -1,9 +1,9 @@ ## Standalone Nexus Operations -> [!WARNING] -> Standalone Nexus operations are experimental and may be subject to backwards-incompatible -> changes. They require a Temporal server that implements and enables them via the dynamic configs -> shown below. Use the dev server build at +> [!NOTE] +> Standalone Nexus Operations are in [Public Preview](https://docs.temporal.io/evaluate/development-production-features/release-stages#public-preview). +> We aim to preserve backward compatibility and avoid breaking changes. +> They require a Temporal server that supports this feature. Use the dev server build at > https://github.com/temporalio/cli/releases/tag/v1.7.4-standalone-nexus-operations. > This sample shows how to invoke and manage **standalone Nexus operations** — Nexus operations From 69bff9c9e02d780428e12772abae73a40a1e3d50 Mon Sep 17 00:00:00 2001 From: Joie Wu Date: Wed, 14 Oct 2026 15:27:49 -0700 Subject: [PATCH 2/9] docs: update SANO local dev server setup --- .../java/io/temporal/samples/nexusstandalone/README.MD | 9 +++++---- 1 file changed, 5 insertions(+), 4 deletions(-) diff --git a/core/src/main/java/io/temporal/samples/nexusstandalone/README.MD b/core/src/main/java/io/temporal/samples/nexusstandalone/README.MD index 5d557d33..156e2b3a 100644 --- a/core/src/main/java/io/temporal/samples/nexusstandalone/README.MD +++ b/core/src/main/java/io/temporal/samples/nexusstandalone/README.MD @@ -3,8 +3,8 @@ > [!NOTE] > Standalone Nexus Operations are in [Public Preview](https://docs.temporal.io/evaluate/development-production-features/release-stages#public-preview). > We aim to preserve backward compatibility and avoid breaking changes. -> They require a Temporal server that supports this feature. Use the dev server build at -> https://github.com/temporalio/cli/releases/tag/v1.7.4-standalone-nexus-operations. +> They require a Temporal server that supports this feature. For a local dev server, use +> [Temporal CLI v1.9.1 or later](https://github.com/temporalio/cli/releases/tag/v1.9.1) and enable SANO as shown below. > This sample shows how to invoke and manage **standalone Nexus operations** — Nexus operations started directly by a client rather than from within a caller workflow. The long-running operation @@ -26,10 +26,11 @@ from the environment (and optionally a profile from `temporal.toml`). ### Run locally against a dev server -1. Start the [Temporal dev server build that supports standalone Nexus operations](https://docs.temporal.io/standalone-nexus-operation#temporal-cli-support) with the required namespaces pre-created: +1. Start a [Temporal dev server](https://docs.temporal.io/cli/setup-cli) with SANO enabled and the required namespaces pre-created: ```bash - ./temporal server start-dev \ + temporal server start-dev \ + --dynamic-config-value "nexusoperation.enableStandalone=true" \ --namespace my-caller-namespace \ --namespace my-handler-namespace ``` From 0e289f3689be1bb445b98774d1a9da2d1c76d81e Mon Sep 17 00:00:00 2001 From: Joie Wu Date: Wed, 14 Oct 2026 15:40:09 -0700 Subject: [PATCH 3/9] docs: announce SANO public preview --- .../src/main/java/io/temporal/samples/nexusstandalone/README.MD | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/core/src/main/java/io/temporal/samples/nexusstandalone/README.MD b/core/src/main/java/io/temporal/samples/nexusstandalone/README.MD index 156e2b3a..67761c8a 100644 --- a/core/src/main/java/io/temporal/samples/nexusstandalone/README.MD +++ b/core/src/main/java/io/temporal/samples/nexusstandalone/README.MD @@ -1,7 +1,7 @@ ## Standalone Nexus Operations > [!NOTE] -> Standalone Nexus Operations are in [Public Preview](https://docs.temporal.io/evaluate/development-production-features/release-stages#public-preview). +> ✨ **Standalone Nexus Operations are now in [Public Preview](https://docs.temporal.io/evaluate/development-production-features/release-stages#public-preview).** > We aim to preserve backward compatibility and avoid breaking changes. > They require a Temporal server that supports this feature. For a local dev server, use > [Temporal CLI v1.9.1 or later](https://github.com/temporalio/cli/releases/tag/v1.9.1) and enable SANO as shown below. From 3190a5eeebff3d23d98d22ea351c3238708c03f8 Mon Sep 17 00:00:00 2001 From: Joie Wu Date: Wed, 14 Oct 2026 15:42:32 -0700 Subject: [PATCH 4/9] docs: move SANO preview notice to top --- .../src/main/java/io/temporal/samples/nexusstandalone/README.MD | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/core/src/main/java/io/temporal/samples/nexusstandalone/README.MD b/core/src/main/java/io/temporal/samples/nexusstandalone/README.MD index 67761c8a..399a982a 100644 --- a/core/src/main/java/io/temporal/samples/nexusstandalone/README.MD +++ b/core/src/main/java/io/temporal/samples/nexusstandalone/README.MD @@ -1,4 +1,4 @@ -## Standalone Nexus Operations +# Standalone Nexus Operations > [!NOTE] > ✨ **Standalone Nexus Operations are now in [Public Preview](https://docs.temporal.io/evaluate/development-production-features/release-stages#public-preview).** From 9c1bc5de6c851d6af443781e1fb593efa5cc5421 Mon Sep 17 00:00:00 2001 From: Joie Wu Date: Wed, 14 Oct 2026 15:44:30 -0700 Subject: [PATCH 5/9] docs: group SANO setup requirements --- .../java/io/temporal/samples/nexusstandalone/README.MD | 8 +++++--- 1 file changed, 5 insertions(+), 3 deletions(-) diff --git a/core/src/main/java/io/temporal/samples/nexusstandalone/README.MD b/core/src/main/java/io/temporal/samples/nexusstandalone/README.MD index 399a982a..525820fa 100644 --- a/core/src/main/java/io/temporal/samples/nexusstandalone/README.MD +++ b/core/src/main/java/io/temporal/samples/nexusstandalone/README.MD @@ -3,9 +3,7 @@ > [!NOTE] > ✨ **Standalone Nexus Operations are now in [Public Preview](https://docs.temporal.io/evaluate/development-production-features/release-stages#public-preview).** > We aim to preserve backward compatibility and avoid breaking changes. -> They require a Temporal server that supports this feature. For a local dev server, use -> [Temporal CLI v1.9.1 or later](https://github.com/temporalio/cli/releases/tag/v1.9.1) and enable SANO as shown below. -> + This sample shows how to invoke and manage **standalone Nexus operations** — Nexus operations started directly by a client rather than from within a caller workflow. The long-running operation (`startGreeting`) is backed by a `GreetingWorkflow` that blocks until it is cancelled; the quick @@ -26,6 +24,10 @@ from the environment (and optionally a profile from `temporal.toml`). ### Run locally against a dev server +> [!NOTE] +> Standalone Nexus Operations require a server that supports this feature. For a local dev server, use +> [Temporal CLI v1.9.1 or later](https://github.com/temporalio/cli/releases/tag/v1.9.1) and enable SANO as shown below. + 1. Start a [Temporal dev server](https://docs.temporal.io/cli/setup-cli) with SANO enabled and the required namespaces pre-created: ```bash From 85a89fb022d063dcc63e6e8d8602ad9f99a85cc6 Mon Sep 17 00:00:00 2001 From: Joie Wu Date: Thu, 15 Oct 2026 15:42:01 -0700 Subject: [PATCH 6/9] docs: rely on SANO-enabled dev server --- .../java/io/temporal/samples/nexusstandalone/README.MD | 7 +++---- 1 file changed, 3 insertions(+), 4 deletions(-) diff --git a/core/src/main/java/io/temporal/samples/nexusstandalone/README.MD b/core/src/main/java/io/temporal/samples/nexusstandalone/README.MD index 525820fa..242daee5 100644 --- a/core/src/main/java/io/temporal/samples/nexusstandalone/README.MD +++ b/core/src/main/java/io/temporal/samples/nexusstandalone/README.MD @@ -25,14 +25,13 @@ from the environment (and optionally a profile from `temporal.toml`). ### Run locally against a dev server > [!NOTE] -> Standalone Nexus Operations require a server that supports this feature. For a local dev server, use -> [Temporal CLI v1.9.1 or later](https://github.com/temporalio/cli/releases/tag/v1.9.1) and enable SANO as shown below. +> Standalone Nexus Operations require a server that supports this feature. For local development, use a Temporal CLI +> release that enables SANO in its dev server. -1. Start a [Temporal dev server](https://docs.temporal.io/cli/setup-cli) with SANO enabled and the required namespaces pre-created: +1. Start a [Temporal dev server](https://docs.temporal.io/cli/setup-cli) with the required namespaces pre-created: ```bash temporal server start-dev \ - --dynamic-config-value "nexusoperation.enableStandalone=true" \ --namespace my-caller-namespace \ --namespace my-handler-namespace ``` From 3dbb05a5b482609dc8d3c64f6aecea7b3a4fdabb Mon Sep 17 00:00:00 2001 From: Joie Wu Date: Fri, 16 Oct 2026 11:20:06 -0700 Subject: [PATCH 7/9] docs: fix Temporal CLI endpoint command --- .../src/main/java/io/temporal/samples/nexusstandalone/README.MD | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/core/src/main/java/io/temporal/samples/nexusstandalone/README.MD b/core/src/main/java/io/temporal/samples/nexusstandalone/README.MD index 242daee5..46633028 100644 --- a/core/src/main/java/io/temporal/samples/nexusstandalone/README.MD +++ b/core/src/main/java/io/temporal/samples/nexusstandalone/README.MD @@ -39,7 +39,7 @@ from the environment (and optionally a profile from `temporal.toml`). 2. Create a Nexus endpoint that routes to the handler namespace and the worker's task queue: ```bash - ./temporal operator nexus endpoint create \ + temporal operator nexus endpoint create \ --name my-nexus-endpoint \ --target-namespace my-handler-namespace \ --target-task-queue nexus-handler-queue From 4e2a95d59f81e33226c0e87360a9ad158cce1876 Mon Sep 17 00:00:00 2001 From: Joie Wu Date: Fri, 30 Oct 2026 16:14:37 -0700 Subject: [PATCH 8/9] docs: document SANO server requirements --- .../temporal/samples/nexusstandalone/README.MD | 17 +++++++++++++++-- 1 file changed, 15 insertions(+), 2 deletions(-) diff --git a/core/src/main/java/io/temporal/samples/nexusstandalone/README.MD b/core/src/main/java/io/temporal/samples/nexusstandalone/README.MD index 46633028..28eec889 100644 --- a/core/src/main/java/io/temporal/samples/nexusstandalone/README.MD +++ b/core/src/main/java/io/temporal/samples/nexusstandalone/README.MD @@ -25,13 +25,14 @@ from the environment (and optionally a profile from `temporal.toml`). ### Run locally against a dev server > [!NOTE] -> Standalone Nexus Operations require a server that supports this feature. For local development, use a Temporal CLI -> release that enables SANO in its dev server. +> Standalone Nexus Operations require a server that supports this feature. For local development, use Temporal CLI +> v1.9.1 or later and enable SANO as shown below. 1. Start a [Temporal dev server](https://docs.temporal.io/cli/setup-cli) with the required namespaces pre-created: ```bash temporal server start-dev \ + --dynamic-config-value "nexusoperation.enableStandalone=true" \ --namespace my-caller-namespace \ --namespace my-handler-namespace ``` @@ -73,6 +74,18 @@ Grouped count total=2, groups: group values=[[Completed]] count=1 ``` +### Use a self-hosted cluster + +For a self-hosted cluster, use Temporal Server v1.32.0 or later and enable SANO for the caller namespace in the +server's [dynamic configuration](https://docs.temporal.io/references/dynamic-configuration): + +```yaml +nexusoperation.enableStandalone: + - value: true + constraints: + namespace: my-caller-namespace +``` + ### Run against Temporal Cloud 1. Create two namespaces in Temporal Cloud (for example `my-caller-namespace.` and From 1af76dc5962f4e34faf88b03552469b5fe650422 Mon Sep 17 00:00:00 2001 From: Joie Wu Date: Fri, 30 Oct 2026 17:38:05 -0700 Subject: [PATCH 9/9] docs: remove self-hosted SANO setup from sample --- .../io/temporal/samples/nexusstandalone/README.MD | 12 ------------ 1 file changed, 12 deletions(-) diff --git a/core/src/main/java/io/temporal/samples/nexusstandalone/README.MD b/core/src/main/java/io/temporal/samples/nexusstandalone/README.MD index 28eec889..0f52c725 100644 --- a/core/src/main/java/io/temporal/samples/nexusstandalone/README.MD +++ b/core/src/main/java/io/temporal/samples/nexusstandalone/README.MD @@ -74,18 +74,6 @@ Grouped count total=2, groups: group values=[[Completed]] count=1 ``` -### Use a self-hosted cluster - -For a self-hosted cluster, use Temporal Server v1.32.0 or later and enable SANO for the caller namespace in the -server's [dynamic configuration](https://docs.temporal.io/references/dynamic-configuration): - -```yaml -nexusoperation.enableStandalone: - - value: true - constraints: - namespace: my-caller-namespace -``` - ### Run against Temporal Cloud 1. Create two namespaces in Temporal Cloud (for example `my-caller-namespace.` and