From a5ec5db98c11e43b9269f3c5e0f3a17fcbea2b8b Mon Sep 17 00:00:00 2001 From: tekkaya <86028633+tekkaya@users.noreply.github.com> Date: Fri, 12 Jun 2026 12:55:03 -0700 Subject: [PATCH 1/3] Clarify Standalone Activity start Action counting Document that a Start Standalone Activity request which returns an already-running Activity (de-duplicated by Activity ID) is not counted as an Action, unless the start request attaches conflict options to the running Activity. This mirrors the existing de-dup wording for Workflow starts. Co-Authored-By: Claude Opus 4.8 (1M context) --- docs/evaluate/temporal-cloud/actions.mdx | 3 +++ 1 file changed, 3 insertions(+) diff --git a/docs/evaluate/temporal-cloud/actions.mdx b/docs/evaluate/temporal-cloud/actions.mdx index 871840df3e..690443bff8 100644 --- a/docs/evaluate/temporal-cloud/actions.mdx +++ b/docs/evaluate/temporal-cloud/actions.mdx @@ -107,6 +107,9 @@ available endpoints are listed in the following sections: ## Activity {/* #activity */} - **Activity started or retried**. Occurs each time an Activity is started or retried. +- **Standalone Activity started**. Occurs when a [Standalone Activity](/standalone-activity) is started. + - De-duplicated Standalone Activity starts that return an already-running Activity (sharing an Activity ID) do _not_ + count as an Action, unless the start request attaches conflict options to the running Activity. - **Local Activity started**. All [Local Activities](/local-activity) associated with one Workflow Task count as a single Action. Temporal Cloud counts all [RecordMarkers](/references/commands#recordmarker) from each Workflow Task as one action, and not _N_ actions. Note: From 5c93c0e597c9ee577ce2b5a74c63dc9d8ac4b982 Mon Sep 17 00:00:00 2001 From: tekkaya <86028633+tekkaya@users.noreply.github.com> Date: Fri, 12 Jun 2026 12:55:03 -0700 Subject: [PATCH 2/3] Reword Standalone Activity Action note in user-facing terms Per review, "conflict options" is not a user-facing concept. Describe the billable case as attaching a callback to the running Activity (e.g. within a Nexus handler using the USE_EXISTING conflict policy). Co-Authored-By: Claude Opus 4.8 (1M context) --- docs/evaluate/temporal-cloud/actions.mdx | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/docs/evaluate/temporal-cloud/actions.mdx b/docs/evaluate/temporal-cloud/actions.mdx index 690443bff8..dbb869fe33 100644 --- a/docs/evaluate/temporal-cloud/actions.mdx +++ b/docs/evaluate/temporal-cloud/actions.mdx @@ -109,7 +109,8 @@ available endpoints are listed in the following sections: - **Activity started or retried**. Occurs each time an Activity is started or retried. - **Standalone Activity started**. Occurs when a [Standalone Activity](/standalone-activity) is started. - De-duplicated Standalone Activity starts that return an already-running Activity (sharing an Activity ID) do _not_ - count as an Action, unless the start request attaches conflict options to the running Activity. + count as an Action, unless the start request tries to attach a callback to the running Activity — for example, + within a Nexus handler using the `USE_EXISTING` conflict policy. - **Local Activity started**. All [Local Activities](/local-activity) associated with one Workflow Task count as a single Action. Temporal Cloud counts all [RecordMarkers](/references/commands#recordmarker) from each Workflow Task as one action, and not _N_ actions. Note: From bef5ccb988215a2ae97ac72f2ba1a7393e783fdd Mon Sep 17 00:00:00 2001 From: tekkaya <86028633+tekkaya@users.noreply.github.com> Date: Thu, 20 Aug 2026 12:06:05 -0700 Subject: [PATCH 3/3] Use Activity Id instead of Activity ID Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com> --- docs/evaluate/temporal-cloud/actions.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/evaluate/temporal-cloud/actions.mdx b/docs/evaluate/temporal-cloud/actions.mdx index dbb869fe33..7c54611390 100644 --- a/docs/evaluate/temporal-cloud/actions.mdx +++ b/docs/evaluate/temporal-cloud/actions.mdx @@ -108,7 +108,7 @@ available endpoints are listed in the following sections: - **Activity started or retried**. Occurs each time an Activity is started or retried. - **Standalone Activity started**. Occurs when a [Standalone Activity](/standalone-activity) is started. - - De-duplicated Standalone Activity starts that return an already-running Activity (sharing an Activity ID) do _not_ + - De-duplicated Standalone Activity starts that return an already-running Activity (sharing an Activity Id) do _not_ count as an Action, unless the start request tries to attach a callback to the running Activity — for example, within a Nexus handler using the `USE_EXISTING` conflict policy. - **Local Activity started**. All [Local Activities](/local-activity) associated with one Workflow Task count as a