From 5bbc46b2b6f000c4f89c122d4e002f04600cd6f3 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 --- nexus_standalone_operations/README.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/nexus_standalone_operations/README.md b/nexus_standalone_operations/README.md index 63a04b5a..6002ca32 100644 --- a/nexus_standalone_operations/README.md +++ b/nexus_standalone_operations/README.md @@ -8,9 +8,9 @@ configured via the SDK's [environment configuration](https://docs.temporal.io/de support (`ClientConfig.load_client_connect_config()`), which reads `TEMPORAL_NAMESPACE`, `TEMPORAL_ADDRESS`, etc. from the environment (and optionally profiles from `temporal.toml`). -### Temporal Python SDK support for Standalone Nexus Operations is at [Pre-release](https://docs.temporal.io/evaluate/development-production-features/release-stages#pre-release). +### Temporal Python SDK support for Standalone Nexus Operations is at [Public Preview](https://docs.temporal.io/evaluate/development-production-features/release-stages#public-preview). -All APIs are experimental and may be subject to backwards-incompatible changes. +We aim to preserve backward compatibility and avoid breaking changes. Standalone Nexus operations require a server version that supports this feature. Use the dev server build at https://github.com/temporalio/cli/releases/tag/v1.7.4-standalone-nexus-operations. From 7c66fbdc6f2e5ef676951eff0b48375525d271e6 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 --- nexus_standalone_operations/README.md | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/nexus_standalone_operations/README.md b/nexus_standalone_operations/README.md index 6002ca32..5ec8102e 100644 --- a/nexus_standalone_operations/README.md +++ b/nexus_standalone_operations/README.md @@ -12,7 +12,7 @@ support (`ClientConfig.load_client_connect_config()`), which reads `TEMPORAL_NAM We aim to preserve backward compatibility and avoid breaking changes. -Standalone Nexus operations require a server version that supports this feature. Use the dev server build at https://github.com/temporalio/cli/releases/tag/v1.7.4-standalone-nexus-operations. +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. ### Sample directory structure @@ -23,10 +23,11 @@ Standalone Nexus operations require a server version that supports this feature. ## 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 5ea60171625ffccf67890192219ec4a774213922 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 --- nexus_standalone_operations/README.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/nexus_standalone_operations/README.md b/nexus_standalone_operations/README.md index 5ec8102e..ef8ebea0 100644 --- a/nexus_standalone_operations/README.md +++ b/nexus_standalone_operations/README.md @@ -8,8 +8,9 @@ configured via the SDK's [environment configuration](https://docs.temporal.io/de support (`ClientConfig.load_client_connect_config()`), which reads `TEMPORAL_NAMESPACE`, `TEMPORAL_ADDRESS`, etc. from the environment (and optionally profiles from `temporal.toml`). -### Temporal Python SDK support for Standalone Nexus Operations is at [Public Preview](https://docs.temporal.io/evaluate/development-production-features/release-stages#public-preview). +## 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. 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. From f7be578fba4eb5787d7711f81200e7681d69d2c8 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 --- nexus_standalone_operations/README.md | 11 ++++++----- 1 file changed, 6 insertions(+), 5 deletions(-) diff --git a/nexus_standalone_operations/README.md b/nexus_standalone_operations/README.md index ef8ebea0..8b48c5ee 100644 --- a/nexus_standalone_operations/README.md +++ b/nexus_standalone_operations/README.md @@ -1,3 +1,9 @@ +# Standalone Nexus Operations + +> [!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. + This sample demonstrates how to execute Nexus operations directly from client code, without wrapping them in a workflow. It shows both synchronous and asynchronous (workflow-backed) operations, plus listing and counting operations. @@ -8,11 +14,6 @@ configured via the SDK's [environment configuration](https://docs.temporal.io/de support (`ClientConfig.load_client_connect_config()`), which reads `TEMPORAL_NAMESPACE`, `TEMPORAL_ADDRESS`, etc. from the environment (and optionally profiles from `temporal.toml`). -## 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. - 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. ### Sample directory structure From 6bce08fbe71687883a5de8b0949d6f036b435f66 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 --- nexus_standalone_operations/README.md | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/nexus_standalone_operations/README.md b/nexus_standalone_operations/README.md index 8b48c5ee..02e20469 100644 --- a/nexus_standalone_operations/README.md +++ b/nexus_standalone_operations/README.md @@ -14,8 +14,6 @@ configured via the SDK's [environment configuration](https://docs.temporal.io/de support (`ClientConfig.load_client_connect_config()`), which reads `TEMPORAL_NAMESPACE`, `TEMPORAL_ADDRESS`, etc. from the environment (and optionally profiles from `temporal.toml`). -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. - ### Sample directory structure - [service.py](./service.py) - Nexus service definition with echo (sync) and hello (async) operations @@ -25,6 +23,9 @@ Standalone Nexus operations require a server that supports this feature. For a l ## 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 6fecca610ef2fce5e6019595b8ee1b7c2b264d95 Mon Sep 17 00:00:00 2001 From: Joie Wu Date: Thu, 15 Oct 2026 15:41:59 -0700 Subject: [PATCH 6/9] docs: rely on SANO-enabled dev server --- nexus_standalone_operations/README.md | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/nexus_standalone_operations/README.md b/nexus_standalone_operations/README.md index 02e20469..28530e56 100644 --- a/nexus_standalone_operations/README.md +++ b/nexus_standalone_operations/README.md @@ -24,13 +24,12 @@ support (`ClientConfig.load_client_connect_config()`), which reads `TEMPORAL_NAM ## 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 0ff7ae3cf408b7fae147a53543a4f6eb11f9c044 Mon Sep 17 00:00:00 2001 From: Joie Wu Date: Fri, 16 Oct 2026 11:15:13 -0700 Subject: [PATCH 7/9] docs: fix Temporal CLI endpoint command --- nexus_standalone_operations/README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/nexus_standalone_operations/README.md b/nexus_standalone_operations/README.md index 28530e56..7ca8cc7f 100644 --- a/nexus_standalone_operations/README.md +++ b/nexus_standalone_operations/README.md @@ -37,7 +37,7 @@ support (`ClientConfig.load_client_connect_config()`), which reads `TEMPORAL_NAM 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 90a3d609d928c9e167c007e09422a5cebe4e0597 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 --- nexus_standalone_operations/README.md | 15 ++++++++++++++- 1 file changed, 14 insertions(+), 1 deletion(-) diff --git a/nexus_standalone_operations/README.md b/nexus_standalone_operations/README.md index 7ca8cc7f..b2863228 100644 --- a/nexus_standalone_operations/README.md +++ b/nexus_standalone_operations/README.md @@ -24,12 +24,13 @@ support (`ClientConfig.load_client_connect_config()`), which reads `TEMPORAL_NAM ## 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 ``` @@ -74,6 +75,18 @@ Total Nexus operations: 2 If you run the starter code multiple times, you should see additional operations in the listing results, as more operations are run. The same goes for the total number of operations. +## 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 7d7a5c45b5e621eb74814a57072a3c68910399cb Mon Sep 17 00:00:00 2001 From: Joie Wu Date: Fri, 30 Oct 2026 17:29:53 -0700 Subject: [PATCH 9/9] docs: remove self-hosted SANO setup from sample --- nexus_standalone_operations/README.md | 12 ------------ 1 file changed, 12 deletions(-) diff --git a/nexus_standalone_operations/README.md b/nexus_standalone_operations/README.md index b2863228..fcfac333 100644 --- a/nexus_standalone_operations/README.md +++ b/nexus_standalone_operations/README.md @@ -75,18 +75,6 @@ Total Nexus operations: 2 If you run the starter code multiple times, you should see additional operations in the listing results, as more operations are run. The same goes for the total number of operations. -## 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