[DRAFT] SAA operator commands documentation by spkane31 · Pull Request #4834 · temporalio/documentation

spkane31 · 2026-07-06T23:12:55Z

What does this PR do?

Document the interactions of standalone activity pause, unpause, reset, update-options commands

Notes to reviewers

┆Attachments: EDU-6664 [DRAFT] SAA operator commands documentation

vercel · 2026-07-06T23:13:01Z

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
temporal-documentation	Ready	Preview, Comment	Jul 20, 2026 9:39pm

github-actions

Remaining comments which cannot be posted as a review comment to avoid GitHub Rate Limit

vale

docs/encyclopedia/activities/activity-operations.mdx|540 col 49| [Temporal.terms] Use 'Task' instead of 'task' when referring to a Temporal term.
docs/encyclopedia/activities/activity-operations.mdx|560 col 45| [Temporal.terms] Use 'Timers' instead of 'timers' when referring to a Temporal term.
docs/encyclopedia/activities/activity-operations.mdx|562 col 45| [Temporal.terms] Use 'Timers' instead of 'timers' when referring to a Temporal term.
docs/encyclopedia/activities/activity-operations.mdx|565 col 42| [Temporal.terms] Use 'Timers' instead of 'timers' when referring to a Temporal term.
docs/encyclopedia/activities/activity-operations.mdx|572 col 32| [Temporal.terms] Use 'Heartbeat' instead of 'heartbeat' when referring to a Temporal term.
docs/encyclopedia/activities/activity-operations.mdx|590 col 27| [Temporal.terms] Use 'Query' instead of 'query' when referring to a Temporal term.

github-actions · 2026-07-06T23:13:17Z

@@ -84,7 +84,8 @@ webhook, syncing data, or executing a single function reliably with built-in ret
 - Arbitrary length jobs with heartbeats for liveness and checkpointing progress
 - At-least-once execution by default with native retry policy and timeouts


⚠️ [vale] _{reported by reviewdog 🐶}
[Temporal.terms] Use 'Retry Policy' instead of 'retry policy' when referring to a Temporal term.

github-actions · 2026-07-06T23:13:17Z

 - **Pause operates on individual Activities by ID within a single Workflow.** Unlike Unpause, Reset, and Update Options,
  there's no `--query` flag. To pause multiple Activities, issue separate commands for each Activity ID.
- **No Namespace-wide query for Paused Activities.** You must know the Workflow Id. See [Observability](#observability).
+- **No Namespace-wide query for Paused Activities.** You must know the Workflow ID. See [Observability](#observability).


⚠️ [vale] _{reported by reviewdog 🐶}
[Temporal.terms] Use 'Query' instead of 'query' when referring to a Temporal term.

github-actions · 2026-07-06T23:13:17Z


 - **Update Options is CLI and gRPC only.** It's not available in the UI.

+## Standalone Activity operator commands {/* #standalone-activity-operator-commands */}


⚠️ [vale] _{reported by reviewdog 🐶}
[Temporal.terms] Use 'Activity' instead of 'activity' when referring to a Temporal term.

github-actions · 2026-07-06T23:13:17Z

+- If the Activity has a Start Delay, the first dispatch can't happen before `ScheduleTime + StartDelay`.
+- Start Delay also affects the Schedule-To-Close and Schedule-To-Start deadlines for the first dispatch.
+- Start Delay stops affecting dispatch after the first Worker has picked up the Activity.
+- If an operation reissues a dispatch task, the task is scheduled at the later of the operation time, any remaining


⚠️ [vale] _{reported by reviewdog 🐶}
[Temporal.terms] Use 'Task' instead of 'task' when referring to a Temporal term.

github-actions · 2026-07-06T23:13:17Z

+- If the Activity has a Start Delay, the first dispatch can't happen before `ScheduleTime + StartDelay`.
+- Start Delay also affects the Schedule-To-Close and Schedule-To-Start deadlines for the first dispatch.
+- Start Delay stops affecting dispatch after the first Worker has picked up the Activity.
+- If an operation reissues a dispatch task, the task is scheduled at the later of the operation time, any remaining


⚠️ [vale] _{reported by reviewdog 🐶}
[Temporal.terms] Use 'Task' instead of 'task' when referring to a Temporal term.

github-actions · 2026-07-06T23:13:18Z

+  - `restore_original` restores Start Delay only if the Activity has not started its first attempt.
+- Updated timeout values are validated and normalized after the update.
+- If Schedule-To-Close Timeout is updated:
+  - Update Options reissues the Schedule-To-Close timeout task at the new deadline.


⚠️ [vale] _{reported by reviewdog 🐶}
[Temporal.terms] Use 'Task' instead of 'task' when referring to a Temporal term.

github-actions · 2026-07-06T23:13:18Z

+  - Extending Schedule-To-Close Timeout can allow future retries that would otherwise be blocked by the Activity
+    deadline.
+- If Start-To-Close Timeout or Heartbeat Timeout is updated for a running attempt:
+  - Update Options reissues the Start-To-Close timeout task for that attempt.


⚠️ [vale] _{reported by reviewdog 🐶}
[Temporal.terms] Use 'Task' instead of 'task' when referring to a Temporal term.

github-actions · 2026-07-06T23:13:18Z

+    deadline.
+- If Start-To-Close Timeout or Heartbeat Timeout is updated for a running attempt:
+  - Update Options reissues the Start-To-Close timeout task for that attempt.
+  - Update Options reissues the Heartbeat timeout task for that attempt.


⚠️ [vale] _{reported by reviewdog 🐶}
[Temporal.terms] Use 'Task' instead of 'task' when referring to a Temporal term.

github-actions · 2026-07-06T23:13:18Z

+- If Start-To-Close Timeout or Heartbeat Timeout is updated for a running attempt:
+  - Update Options reissues the Start-To-Close timeout task for that attempt.
+  - Update Options reissues the Heartbeat timeout task for that attempt.
+  - Updated running-attempt timers are anchored to the current attempt's start time or last heartbeat time.


⚠️ [vale] _{reported by reviewdog 🐶}
[Temporal.terms] Use 'Timers' instead of 'timers' when referring to a Temporal term.

github-actions · 2026-07-06T23:13:18Z

+- If Start-To-Close Timeout or Heartbeat Timeout is updated for a running attempt:
+  - Update Options reissues the Start-To-Close timeout task for that attempt.
+  - Update Options reissues the Heartbeat timeout task for that attempt.
+  - Updated running-attempt timers are anchored to the current attempt's start time or last heartbeat time.


⚠️ [vale] _{reported by reviewdog 🐶}
[Temporal.terms] Use 'Heartbeat' instead of 'heartbeat' when referring to a Temporal term.

github-actions · 2026-07-06T23:13:25Z

📖 Docs PR preview links

github-actions · 2026-07-07T16:31:09Z

-| [Unpause](#unpause)               | Resumes a Paused Activity. The next execution starts immediately.                | [`temporal activity unpause`](/cli/command-reference/activity#unpause)               |
-| [Reset](#reset)                   | Clears retry state (attempts, backoff) and schedules a new execution.            | [`temporal activity reset`](/cli/command-reference/activity#reset)                   |
-| [Update Options](#update-options) | Changes timeouts, Retry Policy, or Task Queue without restarting the Activity.   | [`temporal activity update-options`](/cli/command-reference/activity#update-options) |
+| [Unpause](#unpause)               | Resumes a Paused Activity. The next execution starts after any remaining retry backoff or start delay.                | [`temporal activity unpause`](/cli/command-reference/activity#unpause)               |


⚠️ [vale] _{reported by reviewdog 🐶}
[Temporal.terms] Use 'Start Delay' instead of 'start delay' when referring to a Temporal term.

github-actions · 2026-07-07T16:31:09Z

-Pause stops the Temporal Service from scheduling new retries of an [Activity Execution](/activity-execution).
+Pause stops the Temporal Service scheduling new retries of an [Activity Execution](/activity-execution).

 ### When to Pause


📝 [vale] _{reported by reviewdog 🐶}
[Temporal.Headings] 'When to Pause' should use sentence-style capitalization.

github-actions · 2026-07-07T16:31:09Z

- **Attempt count and Heartbeat data are preserved by default.** The Activity resumes from where it left off. Use
-  `--reset-attempts` or `--reset-heartbeats` on the CLI to clear these, or use [Reset](#reset) to restart from
-  attempt 1.
+- **The Activity is rescheduled for its next attempt.** The next attempt wait for the end of any remaining retry backoff (or start delay) before starting.


⚠️ [vale] _{reported by reviewdog 🐶}
[Temporal.terms] Use 'Start Delay' instead of 'start delay' when referring to a Temporal term.

github-actions · 2026-07-07T16:31:09Z

 Unpause is idempotent. Unpausing an Activity that isn't Paused has no effect. Unpausing an Activity that has already
-completed returns an error.
+completed returns an error. Use [Reset](#reset) with `--keep-paused` to reset the attempt counter to 1 and optionally
+clear the heartbeat data .


⚠️ [vale] _{reported by reviewdog 🐶}
[Temporal.terms] Use 'Heartbeat' instead of 'heartbeat' when referring to a Temporal term.

github-actions · 2026-07-07T16:31:09Z

-Reset clears an Activity's retry state and schedules a fresh execution.
+Reset clears an Activity's retry state and schedules it to start again from attempt 1.

 ### When to Reset


📝 [vale] _{reported by reviewdog 🐶}
[Temporal.Headings] 'When to Reset' should use sentence-style capitalization.

github-actions · 2026-07-07T16:31:09Z

+  - Update Options stores the new options but doesn't dispatch the Activity.
+  - Updated Retry Policy values can affect when the Activity dispatches after Unpause.
+- If the Activity is PAUSE_REQUESTED:
+  - Update Options reissues running-attempt timers so Start-To-Close and Heartbeat timeouts continue to be enforced.


⚠️ [vale] _{reported by reviewdog 🐶}
[Temporal.terms] Use 'Timers' instead of 'timers' when referring to a Temporal term.

github-actions · 2026-07-07T16:31:09Z

+- If the Activity is PAUSE_REQUESTED:
+  - Update Options reissues running-attempt timers so Start-To-Close and Heartbeat timeouts continue to be enforced.
+- If the Activity is RESET_REQUESTED:
+  - Update Options reissues running-attempt timers so Start-To-Close and Heartbeat timeouts continue to be enforced.


⚠️ [vale] _{reported by reviewdog 🐶}
[Temporal.terms] Use 'Timers' instead of 'timers' when referring to a Temporal term.

github-actions · 2026-07-07T16:31:09Z

+  - Update Options reissues running-attempt timers so Start-To-Close and Heartbeat timeouts continue to be enforced.
+- If cancellation is pending:
+  - Update Options is still allowed.
+  - Updated Start-To-Close and Heartbeat timers can still affect the running attempt.


⚠️ [vale] _{reported by reviewdog 🐶}
[Temporal.terms] Use 'Timers' instead of 'timers' when referring to a Temporal term.

github-actions · 2026-07-07T16:31:09Z

+  - Start Delay can't be updated after a Worker has picked up the first attempt.
+  - A nonzero Start Delay update requires Start Delay to be enabled for the Namespace.
+- Update Options doesn't reset attempts.
+- Update Options doesn't clear heartbeat details.


⚠️ [vale] _{reported by reviewdog 🐶}
[Temporal.terms] Use 'Heartbeat' instead of 'heartbeat' when referring to a Temporal term.

github-actions · 2026-07-07T16:31:09Z

 The `TemporalPauseInfo` [Search Attribute](/search-attribute) is filterable within a Workflow.

-There's no Namespace-wide query to find all Paused Activities across Workflows. You must know the Workflow Id.
+There's no Namespace-wide query to find all Paused Activities across Workflows. You must know the Workflow ID.


⚠️ [vale] _{reported by reviewdog 🐶}
[Temporal.terms] Use 'Query' instead of 'query' when referring to a Temporal term.

…aa-operator

github-actions · 2026-07-07T17:54:33Z

@@ -236,8 +236,7 @@ Use the following options to change the behavior of this command. You can also u
 Reset an activity. Not supported for Standalone Activities.


⚠️ [vale] _{reported by reviewdog 🐶}
[Temporal.terms] Use 'Activity' instead of 'activity' when referring to a Temporal term.

github-actions · 2026-07-07T17:54:33Z

@@ -236,8 +236,7 @@ Use the following options to change the behavior of this command. You can also u
 Reset an activity. Not supported for Standalone Activities.
 This restarts the activity as if it were first being


⚠️ [vale] _{reported by reviewdog 🐶}
[Temporal.terms] Use 'Activity' instead of 'activity' when referring to a Temporal term.

github-actions · 2026-07-07T17:54:33Z

 scheduled. That is, it will reset both the number of attempts and the
-activity timeout, as well as, optionally, the
-[heartbeat details](#reset-heartbeats).
+activity timeout, as well as the [heartbeat details](#reset-heartbeats).


⚠️ [vale] _{reported by reviewdog 🐶}
[Temporal.terms] Use 'Activity' instead of 'activity' when referring to a Temporal term.

github-actions · 2026-07-07T17:54:33Z

 scheduled. That is, it will reset both the number of attempts and the
-activity timeout, as well as, optionally, the
-[heartbeat details](#reset-heartbeats).
+activity timeout, as well as the [heartbeat details](#reset-heartbeats).


⚠️ [vale] _{reported by reviewdog 🐶}
[Temporal.terms] Use 'Heartbeat' instead of 'heartbeat' when referring to a Temporal term.

github-actions · 2026-07-07T17:54:33Z

-[heartbeat details](#reset-heartbeats).
+activity timeout, as well as the [heartbeat details](#reset-heartbeats).

 If the activity may be executing (i.e. it has not yet timed out), the


⚠️ [vale] _{reported by reviewdog 🐶}
[Temporal.terms] Use 'Activity' instead of 'activity' when referring to a Temporal term.

github-actions · 2026-07-07T17:54:33Z

@@ -291,7 +289,6 @@ Use the following options to change the behavior of this command. You can also u
 | `--query`, `-q` | No | **string** Content for an SQL-like `QUERY` List Filter. You must set either --workflow-id or --query. Note: Using --query for batch activity operations is an experimental feature and may change in the future. |
 | `--reason` | No | **string** Reason for batch operation. Only use with --query. Defaults to user name. |
 | `--reset-attempts` | No | **bool** Reset the activity attempts. |


⚠️ [vale] _{reported by reviewdog 🐶}
[Temporal.terms] Use 'Activity' instead of 'activity' when referring to a Temporal term.

github-actions · 2026-07-07T17:54:33Z

 | `--reason` | No | **string** Reason for batch operation. Only use with --query. Defaults to user name. |
 | `--reset-attempts` | No | **bool** Reset the activity attempts. |
-| `--reset-heartbeats` | No | **bool** Reset the Activity's heartbeats. |
 | `--restore-original-options` | No | **bool** Restore the original options of the activity. |


⚠️ [vale] _{reported by reviewdog 🐶}
[Temporal.terms] Use 'Activity' instead of 'activity' when referring to a Temporal term.

github-actions · 2026-07-07T17:54:33Z

 | `--reset-attempts` | No | **bool** Reset the activity attempts. |
-| `--reset-heartbeats` | No | **bool** Reset the Activity's heartbeats. |
 | `--restore-original-options` | No | **bool** Restore the original options of the activity. |
 | `--rps` | No | **float** Limit batch's requests per second. Only allowed if query is present. |


⚠️ [vale] _{reported by reviewdog 🐶}
[Temporal.terms] Use 'Query' instead of 'query' when referring to a Temporal term.

not the same query

github-actions · 2026-07-07T17:54:33Z

+- After a reset dispatches a new attempt, the attempt's scheduled time reports the reset attempt's dispatch time, not
+  the original first-attempt dispatch time.
+- Reset discards retry backoff, but it still respects any remaining Start Delay before the first Worker pickup.
+- Reset clears stored heartbeat time and heartbeat details.


⚠️ [vale] _{reported by reviewdog 🐶}
[Temporal.terms] Use 'Heartbeat' instead of 'heartbeat' when referring to a Temporal term.

github-actions · 2026-07-07T17:54:33Z

+- After a reset dispatches a new attempt, the attempt's scheduled time reports the reset attempt's dispatch time, not
+  the original first-attempt dispatch time.
+- Reset discards retry backoff, but it still respects any remaining Start Delay before the first Worker pickup.
+- Reset clears stored heartbeat time and heartbeat details.


⚠️ [vale] _{reported by reviewdog 🐶}
[Temporal.terms] Use 'Heartbeat' instead of 'heartbeat' when referring to a Temporal term.

…4806) * docs(contributing): added section about how we handle page routing * docs(contributing): added some details to the slug questions --------- Co-authored-by: Duncan Mackenzie <duncanma@duncanmackenzie.net>

Headings like '## Highly available Worker patterns {/* #ha-worker-patterns */}' were being scanned as prose, so kebab-case anchor slugs (e.g. 'ha-worker-patterns') tripped Temporal.terms whenever they happened to contain a lowercase Temporal term substring. This pattern is used in 315 files. Add a TokenIgnores rule to exclude MDX comment syntax ({/* ... */}) from both Temporal rules.

The term-capitalization substitution rule produces too many false positives to be a useful CI gate. Keep the CI ruleset limited to the high-confidence sentence-style heading check. The rule still runs in local/editor linting via .vale.ini.

… components (#4840) - Replaced hardcoded Algolia credentials with constants. - Added `search-insights` dependency for enhanced search analytics. - Refactored search components to utilize insights tracking, including `trackSearchClick` and `trackNoResults` functions. - Updated `SearchResults` and `GroupedHits` components to handle insights events correctly. - Improved performance by memoizing search client instances and insights configuration.

@lennessyy

…ts (#4841) * docs: add Parseable Java integration and fill gaps in integration lists - Add Parseable Java entry to the integrations grid data - List Parseable/Spring AI on the Java develop index Integrations section - Add missing Braintrust, Mastra, Parseable to the TypeScript index list - Lowercase "integration" in link labels across the lists Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> * Apply suggestion from @lennessyy * Apply suggestion from @lennessyy --------- Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com> Co-authored-by: Lenny Chen <55669665+lennessyy@users.noreply.github.com>

Bumps [react-instantsearch](https://github.com/algolia/instantsearch) from 7.35.1 to 7.36.0. - [Release notes](https://github.com/algolia/instantsearch/releases) - [Commits](https://github.com/algolia/instantsearch/compare/react-instantsearch@7.35.1...react-instantsearch@7.36.0) --- updated-dependencies: - dependency-name: react-instantsearch dependency-version: 7.36.0 dependency-type: direct:production update-type: version-update:semver-minor ... Signed-off-by: dependabot[bot] <support@github.com> Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> Co-authored-by: Jwahir Sundai <jwahir.sundai@temporal.io>

* Note IAM role name length limit for CloudFormation stack The template appends the stack name to RoleName to form the final IAM role name. If the combined name exceeds the 64-character IAM limit, stack creation fails. * Use a caution note instead of inline table text This is a temporary caution; the note will be removed once the underlying stack name length issue is resolved.

@lennessyy

#4793) * AI-310: document streaming in the TypeScript OpenAI Agents integration Add a Streaming section covering run(agent, input, { stream: true }), hosting a WorkflowStream in the Workflow, and subscribing to live model events from an external client via WorkflowStreamClient. Fix the stale note that claimed streaming was unsupported. * AI-310: reword streaming determinism note as replay-safe Drop the implementation mechanics (Activity returns the event list, Workflow consumes it instead of the live stream) in favor of a plain statement that streaming from within the Workflow is replay-safe. * Apply suggestions from code review Co-authored-by: David Hyde <DABH@users.noreply.github.com> * Apply suggestion from @lennessyy --------- Co-authored-by: Lenny Chen <55669665+lennessyy@users.noreply.github.com> Co-authored-by: David Hyde <DABH@users.noreply.github.com>

Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com> Co-authored-by: Lenny Chen <55669665+lennessyy@users.noreply.github.com>

Bumps [golang.org/x/net](https://github.com/golang/net) from 0.48.0 to 0.55.0. - [Commits](golang/net@v0.48.0...v0.55.0) --- updated-dependencies: - dependency-name: golang.org/x/net dependency-version: 0.55.0 dependency-type: indirect ... Signed-off-by: dependabot[bot] <support@github.com> Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> Co-authored-by: Lenny Chen <55669665+lennessyy@users.noreply.github.com>

The Go SDK's WorkerDeploymentVersion struct field is BuildID, not BuildId. Fixes two Go examples on the worker-versioning page.

…ount (#4850) The metric temporal_cloud_v1_billable_action_count is now in General Availability, so this box is removed. See Slack discussion: https://temporaltechnologies.slack.com/archives/C01H1G7J98F/p1783552313892169

Co-authored-by: Milecia McG <47196133+flippedcoder@users.noreply.github.com>

* Update Worker Controller docs for KEDA autoscaling The Worker Controller supports KEDA as an autoscaling strategy alongside HPA. Reflect KEDA in the features list, autoscaling overview, and TWOR resource examples, and replace the "Why use this instead of KEDA?" section with a brief strategy summary that links to the controller's scaling-recommendations guide. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> * Rename TemporalWorkerOwnedResource to WorkerResourceTemplate The controller's CRD is now WorkerResourceTemplate (WRT). Update the section heading, references, and abbreviation to match. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> --------- Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com> Co-authored-by: Milecia McG <47196133+flippedcoder@users.noreply.github.com>

#4801) * chore(time skip): updated Activity and test examples for Java * chore(time skip): added time skipping examples * chore(time skip): cleaned up minor nits * chore(time skip): updated based on pr feedback

Bumps [actions/checkout](https://github.com/actions/checkout) from 4 to 7. - [Release notes](https://github.com/actions/checkout/releases) - [Commits](actions/checkout@v4...v7) --- updated-dependencies: - dependency-name: actions/checkout dependency-version: '7' dependency-type: direct:production update-type: version-update:semver-major ... Signed-off-by: dependabot[bot] <support@github.com> Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> Co-authored-by: Jwahir Sundai <jwahir.sundai@temporal.io>

@flippedcoder

* Add Workflow Pause documentation * chore(workflow pause): fixed broken link * chore(workflow pause): made minor docs edits * Apply suggestion from @flippedcoder --------- Co-authored-by: flippedcoder <milecia.mcgregor@aol.com> Co-authored-by: Milecia McG <47196133+flippedcoder@users.noreply.github.com>

@brianstrauch

* AI-280: add LangSmith TypeScript integration guide * Apply suggestion from @brianstrauch * Fix link format for durable execution in LangSmith docs Updated to relative link * fix confusing wording --------- Co-authored-by: Brian Strauch <brian@brianstrauch.com> Co-authored-by: Duncan Mackenzie <duncanma@duncanmackenzie.net> Co-authored-by: Brian MacDonald <brian.macdonald@temporal.io>

* Enable automatic zooming images * added the ability to opt-out of the automatic zoom by wrapping an image in <NoZoom></NoZoom> * Update the markdown details * moved zoomable images read me * fixing a lack of centering * Updated to handle mermaid diagrams, and also to calculate the zoomed size before decided to enable zoom... if, due to height for example, the image will not actually get bigger, then skip the zoom cursor/action

* Correct the list of Regional Endpoints to the right format * Fixing all instances of old regional endpoint * Apply suggestions from code review Co-authored-by: Luke Knepper <lukeknepper@gmail.com> * Update docs/cloud/connectivity/aws-connectivity.mdx Co-authored-by: Lenny Chen <55669665+lennessyy@users.noreply.github.com> * Update docs/cloud/connectivity/aws-connectivity.mdx Co-authored-by: Lenny Chen <55669665+lennessyy@users.noreply.github.com> * Update docs/cloud/connectivity/aws-connectivity.mdx Co-authored-by: Lenny Chen <55669665+lennessyy@users.noreply.github.com> * Update docs/cloud/connectivity/aws-connectivity.mdx Co-authored-by: Lenny Chen <55669665+lennessyy@users.noreply.github.com> * Update docs/cloud/connectivity/aws-connectivity.mdx Co-authored-by: Lenny Chen <55669665+lennessyy@users.noreply.github.com> * Update docs/cloud/get-started/namespaces.mdx Co-authored-by: Lenny Chen <55669665+lennessyy@users.noreply.github.com> * remove something * Updating the HA DNS resolution docs * Tightening the wording * fix * Fix the anchor ID {/* #foo */} instead of {#foo} * Link had two parens --------- Co-authored-by: Lenny Chen <55669665+lennessyy@users.noreply.github.com> Co-authored-by: Duncan Mackenzie <duncanma@duncanmackenzie.net>

* Disable forwarding setting for HA * First draft of deployment models page * edits to deployment models * more edits to deployment models * more updates * Add High Availability deployment patterns docs page Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> * Updates to worker deployment patterns * updates * updates * worker deployment updates * Progress on Active/Active * new anchor for AI * Updates * Updaters * updates * Address review feedback on architecture-patterns.mdx - Capitalize Signal per Vale terms rule - Distinguish standby Workers from active ones with a grey diagram style - Standardize on Active/Passive (Cold), Active/Passive (Hot), and Active/Active naming throughout, dropping alternate names like "Active/Cold", "a.k.a. Multi-Active", and "also written Active-Passive" * Fix Active/Active and Active/Passive (Hot) link label spacing Match the naming convention used in architecture-patterns.mdx (no spaces around the slash) instead of "Active / Active". * Address more review feedback on architecture-patterns.mdx - Tighten and consolidate the opening paragraphs, dropping the rhetorical "what about the rest of the architecture?" sentence - Remove the redundant tip admonition pointing to the High Availability page, already linked in the opening paragraph - Minor wording tweaks per suggestions (colon instead of em dash, clarify "Active/Active Worker deployment pattern") * Restructure architecture-patterns.mdx for scannability - Replace per-pattern Normal operation / On failover bullet lists and the separate Component behavior bullets with a single table (rows: Workers, Namespace, Workflow starters and Clients, Codec Servers and proxies, Databases and queues), followed by a short recovery-time note - Add a one-sentence upshot after each pattern heading, before the diagrams - Remove diagrams that duplicated prose or each other: the redundant "full architecture" detail diagrams, Active/Active's Namespace Endpoint routing diagrams, and the near-duplicate Codec Server / proxy routing diagrams in Active/Passive (Cold) - Promote Benefits, Tradeoffs, and Recommendations and important constraints from bold inline labels to real subheadings with intro sentences and unique anchors, giving the page a real per-pattern TOC - Rename "The rest of the architecture" to "Clients, Codec Servers, and databases" and update its slug, since the old heading and slug didn't describe the section's content * Fixing errors --------- Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com> Co-authored-by: Lenny Chen <55669665+lennessyy@users.noreply.github.com> Co-authored-by: Lenny Chen <lenny.chen@temporal.io>

…a workflow or break it (#4912)

* Phase 1 of Mermaid improvements * Phase 1 of Mermaid improvements

…4913) * Mermaid updates to remove outline text and add guidance to agents.md * Refactor Mermaid diagrams for improved clarity and consistency across documentation - Removed unnecessary inline styles from AWS connectivity and high availability architecture diagrams. - Standardized class definitions for Mermaid diagrams to enhance visual consistency. - Updated sequence diagrams in various design patterns to use line breaks for better readability. - Deleted outdated SVG assets related to the distributed lock pattern. - Adjusted CSS for Mermaid diagrams to ensure theme-aware rendering. These changes aim to enhance the overall presentation and usability of the documentation.

Vale (Temporal.Headings) requires sentence-style capitalization; the Java and TypeScript dev guide pages already comply, but the .NET, PHP, Python, Ruby, and Rust pages title-case the heading. Sentence-case all five for consistency. Heading slugs are unchanged (Docusaurus lowercases them) and nothing links to these anchors.

Bumps [actions/setup-node](https://github.com/actions/setup-node) from 6 to 6.4.0. - [Release notes](https://github.com/actions/setup-node/releases) - [Commits](actions/setup-node@v6...v6.4.0) --- updated-dependencies: - dependency-name: actions/setup-node dependency-version: 6.4.0 dependency-type: direct:production update-type: version-update:semver-minor ... Signed-off-by: dependabot[bot] <support@github.com> Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

Bumps [@vercel/functions](https://github.com/vercel/vercel/tree/HEAD/packages/functions) from 3.7.1 to 3.7.5. - [Release notes](https://github.com/vercel/vercel/releases) - [Changelog](https://github.com/vercel/vercel/blob/main/packages/functions/CHANGELOG.md) - [Commits](https://github.com/vercel/vercel/commits/@vercel/functions@3.7.5/packages/functions) --- updated-dependencies: - dependency-name: "@vercel/functions" dependency-version: 3.7.5 dependency-type: direct:production update-type: version-update:semver-patch ... Signed-off-by: dependabot[bot] <support@github.com> Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> Co-authored-by: Jwahir Sundai <jwahir.sundai@temporal.io>

Bumps [js-yaml](https://github.com/nodeca/js-yaml) from 5.1.0 to 5.2.1. - [Changelog](https://github.com/nodeca/js-yaml/blob/master/CHANGELOG.md) - [Commits](nodeca/js-yaml@5.1.0...5.2.1) --- updated-dependencies: - dependency-name: js-yaml dependency-version: 5.2.1 dependency-type: direct:production update-type: version-update:semver-minor ... Signed-off-by: dependabot[bot] <support@github.com> Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> Co-authored-by: Jwahir Sundai <jwahir.sundai@temporal.io>

* refactor(components): removed SdkLogos component * refactor(components): grouped the remaining sdk components together and cleaned up references --------- Co-authored-by: Jwahir Sundai <jwahir.sundai@temporal.io>

Bumps [react-instantsearch](https://github.com/algolia/instantsearch) from 7.36.0 to 7.38.0. - [Release notes](https://github.com/algolia/instantsearch/releases) - [Commits](https://github.com/algolia/instantsearch/compare/react-instantsearch@7.36.0...react-instantsearch@7.38.0) --- updated-dependencies: - dependency-name: react-instantsearch dependency-version: 7.38.0 dependency-type: direct:production update-type: version-update:semver-minor ... Signed-off-by: dependabot[bot] <support@github.com> Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> Co-authored-by: Jwahir Sundai <jwahir.sundai@temporal.io>

Bumps [algoliasearch](https://github.com/algolia/algoliasearch-client-javascript) from 5.54.1 to 5.55.1. - [Release notes](https://github.com/algolia/algoliasearch-client-javascript/releases) - [Changelog](https://github.com/algolia/algoliasearch-client-javascript/blob/main/CHANGELOG.md) - [Commits](algolia/algoliasearch-client-javascript@5.54.1...5.55.1) --- updated-dependencies: - dependency-name: algoliasearch dependency-version: 5.55.1 dependency-type: direct:production update-type: version-update:semver-minor ... Signed-off-by: dependabot[bot] <support@github.com> Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> Co-authored-by: Jwahir Sundai <jwahir.sundai@temporal.io>

…#4925)

* chore(worker performance): added new encyclopedia section * feat(glossary): added new workflow cache term

* Fix Cloud Ops API docs accuracy for SDK, version header, and auth Correct Go module/import paths, split gRPC vs HTTP version-header requirements, fix the Ops API sample link, and clarify prerequisites, roles, protobuf generation, PrivateLink DNS, and async concurrency limits. Co-authored-by: Cursor <cursoragent@cursor.com> * Remove experimental callout from Cloud Ops Go SDK section Co-authored-by: Cursor <cursoragent@cursor.com> --------- Co-authored-by: Cursor <cursoragent@cursor.com> Co-authored-by: Jwahir Sundai <jwahir.sundai@temporal.io>

CLAassistant · 2026-07-20T21:36:10Z

Thank you for your submission! We really appreciate it. Like many open source projects, we ask that you all sign our Contributor License Agreement before we can accept your contribution.
25 out of 26 committers have signed the CLA.

✅ flippedcoder
✅ dandavison
✅ spkane31
✅ brianstrauch
✅ Duncanma
✅ lukeknep
✅ lennessyy
✅ bchav
✅ jsundai
✅ Quinn-With-Two-Ns
✅ mksample
✅ codemonkeycxy
✅ seanbollin
✅ jpvotta
✅ chaptersix
✅ xumaple
✅ dustin-temporal
✅ prasek
✅ ethanruhe
✅ taonic
✅ DABH
✅ LutaoX
✅ JLDLaughlin
✅ brianmacdonald-temporal
✅ Krishnachaitanyakc
❌ timjbruce
_{You have signed the CLA already but the status is still pending? Let us recheck it.}

vercel Bot deployed to Preview July 6, 2026 23:13 View deployment

github-actions Bot reviewed Jul 6, 2026

View reviewed changes

github-actions Bot reviewed Jul 7, 2026

View reviewed changes

vercel Bot deployed to Preview July 7, 2026 16:31 View deployment

spkane31 and others added 4 commits July 7, 2026 11:31

[DRAFT] SAA operator commands documentation

61f2e4a

Edit existing docs

35c009f

additional documentation for reset heartbeats

4caf949

Merge branch 'main' of github.com:temporalio/documentation into spk/s…

65f091f

…aa-operator

spkane31 force-pushed the spk/saa-operator branch from 3e186aa to 65f091f Compare July 7, 2026 17:54

github-actions Bot reviewed Jul 7, 2026

View reviewed changes

vercel Bot deployed to Preview July 7, 2026 17:55 View deployment

flippedcoder and others added 17 commits July 7, 2026 13:07

Error about Connectivity Rules and the UI (#4838)

f677d84

chore: sync code snippets via snipsync (#4843)

9b18fee

Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com> Co-authored-by: Lenny Chen <55669665+lennessyy@users.noreply.github.com>

Fix BuildId typo to BuildID in Go versioning examples (#4846)

5e6f2a0

The Go SDK's WorkerDeploymentVersion struct field is BuildID, not BuildId. Fixes two Go examples on the worker-versioning page.

Updates for code showing that run must be public (#4849)

d8163f6

Co-authored-by: Milecia McG <47196133+flippedcoder@users.noreply.github.com>

chore(time skip): added examples for testing and time skipping in Java (

061cf6e

#4801) * chore(time skip): updated Activity and test examples for Java * chore(time skip): added time skipping examples * chore(time skip): cleaned up minor nits * chore(time skip): updated based on pr feedback

JLDLaughlin and others added 28 commits July 16, 2026 13:44

chore(testing): added clarification to time skipping in Python (#4909)

70b4077

remove unused or images not referenced anywhere (#4897)

8eecd3e

remove not needed files (#4905)

35e6105

fix(cancellation): added some details for an error that could cancel …

ed40028

…a workflow or break it (#4912)

Mermaid improvements (#4910)

feb5c37

* Phase 1 of Mermaid improvements * Phase 1 of Mermaid improvements

refactor(components): removed SdkLogos component (#4924)

5b514e3

* refactor(components): removed SdkLogos component * refactor(components): grouped the remaining sdk components together and cleaned up references --------- Co-authored-by: Jwahir Sundai <jwahir.sundai@temporal.io>

Update the contribute link to go to the specific page you are viewing (…

3d88bae

…#4925)

more cleanup (#4917)

f6343de

chore(worker performance): added new encyclopedia section (#4926)

ec1a38b

* chore(worker performance): added new encyclopedia section * feat(glossary): added new workflow cache term

[DRAFT] SAA operator commands documentation

60f2641

Edit existing docs

c413513

additional documentation for reset heartbeats

adfa7e5

update documentation for readability

a0ffa8d

refining documentation changes

a8c477f

updating for readability

1c174d0

vercel Bot deployed to Preview July 20, 2026 21:39 View deployment

		@@ -84,7 +84,8 @@ webhook, syncing data, or executing a single function reliably with built-in ret
		- Arbitrary length jobs with heartbeats for liveness and checkpointing progress
		- At-least-once execution by default with native retry policy and timeouts


		- Update Options is CLI and gRPC only. It's not available in the UI.

		## Standalone Activity operator commands {/* #standalone-activity-operator-commands */}

		@@ -236,8 +236,7 @@ Use the following options to change the behavior of this command. You can also u
		Reset an activity. Not supported for Standalone Activities.

		@@ -236,8 +236,7 @@ Use the following options to change the behavior of this command. You can also u
		Reset an activity. Not supported for Standalone Activities.
		This restarts the activity as if it were first being

Uh oh!

Conversation

spkane31 commented Jul 6, 2026 • edited by sync-by-unito Bot Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

What does this PR do?

Notes to reviewers

Uh oh!

vercel Bot commented Jul 6, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

github-actions Bot left a comment

Choose a reason for hiding this comment

Uh oh!

github-actions Bot Jul 6, 2026

Choose a reason for hiding this comment

Uh oh!

github-actions Bot Jul 6, 2026

Choose a reason for hiding this comment

Uh oh!

github-actions Bot Jul 6, 2026

Choose a reason for hiding this comment

Uh oh!

github-actions Bot Jul 6, 2026

Choose a reason for hiding this comment

Uh oh!

github-actions Bot Jul 6, 2026

Choose a reason for hiding this comment

Uh oh!

github-actions Bot Jul 6, 2026

Choose a reason for hiding this comment

Uh oh!

github-actions Bot Jul 6, 2026

Choose a reason for hiding this comment

Uh oh!

github-actions Bot Jul 6, 2026

Choose a reason for hiding this comment

Uh oh!

github-actions Bot Jul 6, 2026

Choose a reason for hiding this comment

Uh oh!

github-actions Bot Jul 6, 2026

Choose a reason for hiding this comment

Uh oh!

github-actions Bot commented Jul 6, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

📖 Docs PR preview links

Uh oh!

github-actions Bot Jul 7, 2026

Choose a reason for hiding this comment

Uh oh!

github-actions Bot Jul 7, 2026

Choose a reason for hiding this comment

Uh oh!

github-actions Bot Jul 7, 2026

Choose a reason for hiding this comment

Uh oh!

github-actions Bot Jul 7, 2026

Choose a reason for hiding this comment

Uh oh!

github-actions Bot Jul 7, 2026

Choose a reason for hiding this comment

Uh oh!

github-actions Bot Jul 7, 2026

Choose a reason for hiding this comment

Uh oh!

github-actions Bot Jul 7, 2026

Choose a reason for hiding this comment

Uh oh!

github-actions Bot Jul 7, 2026

Choose a reason for hiding this comment

Uh oh!

github-actions Bot Jul 7, 2026

Choose a reason for hiding this comment

Uh oh!

github-actions Bot Jul 7, 2026

Choose a reason for hiding this comment

Uh oh!

github-actions Bot Jul 7, 2026

Choose a reason for hiding this comment

Uh oh!

spkane31 commented Jul 6, 2026 •

edited by sync-by-unito Bot

Loading

vercel Bot commented Jul 6, 2026 •

edited

Loading

github-actions Bot commented Jul 6, 2026 •

edited

Loading