add time skipping for saa

Author: feiyang3cat

openapi/openapiv2.json

@@ -12310,6 +12310,10 @@
         "startDelay": {
           "type": "string",
           "description": "Time to wait before dispatching the first activity task. This delay is not applied to retry attempts."
+        },
+        "timeSkippingConfig": {
+          "$ref": "#/definitions/v1TimeSkippingConfig",
+          "description": "Time-skipping configuration. If not set, time skipping is disabled."
         }
       }
     },
@@ -13471,6 +13475,10 @@
         "startDelay": {
           "type": "string",
           "description": "Time to wait before dispatching the first activity task. This delay is not applied to retry attempts."
+        },
+        "timeSkippingConfig": {
+          "$ref": "#/definitions/v1TimeSkippingConfig",
+          "description": "The current time-skipping configuration for this activity. Reflects the value set at start\nand any subsequent updates via UpdateActivityExecutionOptions. Nil if time skipping is disabled."
         }
       },
       "description": "Information about a standalone activity."
@@ -13632,6 +13640,10 @@
         "priority": {
           "$ref": "#/definitions/v1Priority",
           "description": "Priority metadata. If this message is not present, or any fields are not\npresent, they inherit the values from the workflow."
+        },
+        "timeSkippingConfig": {
+          "$ref": "#/definitions/v1TimeSkippingConfig",
+          "description": "Time-skipping configuration."
         }
       }
     },
@@ -19680,22 +19692,22 @@
       "properties": {
         "enabled": {
           "type": "boolean",
-          "description": "Enables or disables time skipping for this workflow execution."
+          "description": "Enables or disables time skipping for this execution."
         },
         "fastForward": {
           "type": "string",
           "description": "Optionally fast-forward the current execution by this duration ahead of current execution time.\nFor a given  execution, only one active fast-forward is allowed at a time.\nIf a new fast-forward is set via a update call before the previous\none completes, the new one will override the previous one.\nIf the fast-forward duration exceeds the remaining execution timeout, time will only\nbe fast-forwarded up to the end of the execution.\n\nIf the executions are workflows:\nWhen the fast-forward completes, time skipping is disabled by the call that initiated\nthe fast-forward, and this action is recorded in the WorkflowExecutionTimeSkippingTransitionedEvent.\nIt can be re-enabled by setting `enabled` to true via UpdateWorkflowExecutionOptions.\nThe current workflow execution is a chain of runs (retries, cron, continue-as-new);\nchild workflows are separate executions, so this fast_forward won't affect them."
         },
         "disableChildPropagation": {
           "type": "boolean",
-          "description": "By default, child workflows inherit the \"enabled\" flag when they are started.\nThis flag disables that inheritance."
+          "description": "Workflow executions only. By default, child workflows inherit the \"enabled\" flag when they\nare started. This flag disables that inheritance. Ignored for standalone activities."
         },
         "disableScheduledActionPropagation": {
           "type": "boolean",
-          "description": "By default, executions inherit the \"enabled\" flag when they are started by a scheduler.\nThis flag disables that inheritance."
+          "description": "Scheduler executions only. By default, executions inherit the \"enabled\" flag when they are\nstarted by a scheduler. This flag disables that inheritance. Ignored for standalone activities."
         }
       },
-      "description": "The configuration for time skipping of an execution.\n\nFor a workflow execution (a chain of runs including retries, cron, continue-as-new):\nWhen time skipping is enabled, virtual time advances automatically whenever there is no in-flight work.\nIn-flight work includes activities, child workflows, Nexus operations, signal/cancel external workflow operations,\nand possibly other features added in the future.\nUser timers are not classified as in-flight work and will be skipped over; the virtual clock may also skip to the\ntime point of the registered fast forward when there is no in-flight work.\nWhen time is skipped, a WorkflowExecutionTimeSkippingTransitionedEvent will be\nadded to the workflow history to capture the state changes.\n\nFor child workflows, by default, if the parent execution is skipping time, the child execution will also skip time,\nbut a parent's fast_forward won't affect its child's execution. A flag is provided to disable propagation of the\n\"enabled\" flag to child workflows; regardless of that flag, a child workflow inherits the virtual time from the\nparent execution as its start time.\n\nFor a scheduler execution: {{ TBD }}"
+      "description": "The configuration for time skipping of an execution.\n\nFor a workflow execution (a chain of runs including retries, cron, continue-as-new):\nWhen time skipping is enabled, virtual time advances automatically whenever there is no in-flight work.\nIn-flight work includes activities, child workflows, Nexus operations, signal/cancel external workflow operations,\nand possibly other features added in the future.\nUser timers are not classified as in-flight work and will be skipped over; the virtual clock may also skip to the\ntime point of the registered fast forward when there is no in-flight work.\nWhen time is skipped, a WorkflowExecutionTimeSkippingTransitionedEvent will be\nadded to the workflow history to capture the state changes.\n\nFor child workflows, by default, if the parent execution is skipping time, the child execution will also skip time,\nbut a parent's fast_forward won't affect its child's execution. A flag is provided to disable propagation of the\n\"enabled\" flag to child workflows; regardless of that flag, a child workflow inherits the virtual time from the\nparent execution as its start time.\n\nFor a scheduler execution: {{ TBD }}\n\nFor a standalone activity: time skipping applies to the activity's own retry/backoff schedule.\nActivities scheduled by a workflow do not carry their own configuration; they inherit time\nskipping from the workflow execution. The `disable_child_propagation` and\n`disable_scheduled_action_propagation` fields are workflow/scheduler concepts and are ignored\nfor standalone activities."
     },
     "v1TimeSkippingStatePropagation": {
       "type": "object",

openapi/openapiv3.yaml

@@ -9852,6 +9852,12 @@ components:
           pattern: ^-?(?:0|[1-9][0-9]{0,11})(?:\.[0-9]{1,9})?s$
           type: string
           description: Time to wait before dispatching the first activity task. This delay is not applied to retry attempts.
+        timeSkippingConfig:
+          allOf:
+            - $ref: '#/components/schemas/TimeSkippingConfig'
+          description: |-
+            The current time-skipping configuration for this activity. Reflects the value set at start
+             and any subsequent updates via UpdateActivityExecutionOptions. Nil if time skipping is disabled.
       description: Information about a standalone activity.
     ActivityExecutionListInfo:
       type: object
@@ -9997,6 +10003,10 @@ components:
           description: |-
             Priority metadata. If this message is not present, or any fields are not
              present, they inherit the values from the workflow.
+        timeSkippingConfig:
+          allOf:
+            - $ref: '#/components/schemas/TimeSkippingConfig'
+          description: Time-skipping configuration.
     ActivityPropertiesModifiedExternallyEventAttributes:
       type: object
       properties:
@@ -16568,6 +16578,10 @@ components:
           pattern: ^-?(?:0|[1-9][0-9]{0,11})(?:\.[0-9]{1,9})?s$
           type: string
           description: Time to wait before dispatching the first activity task. This delay is not applied to retry attempts.
+        timeSkippingConfig:
+          allOf:
+            - $ref: '#/components/schemas/TimeSkippingConfig'
+          description: Time-skipping configuration. If not set, time skipping is disabled.
     StartActivityExecutionResponse:
       type: object
       properties:
@@ -17438,7 +17452,7 @@ components:
       properties:
         enabled:
           type: boolean
-          description: Enables or disables time skipping for this workflow execution.
+          description: Enables or disables time skipping for this execution.
         fastForward:
           pattern: ^-?(?:0|[1-9][0-9]{0,11})(?:\.[0-9]{1,9})?s$
           type: string
@@ -17459,13 +17473,13 @@ components:
         disableChildPropagation:
           type: boolean
           description: |-
-            By default, child workflows inherit the "enabled" flag when they are started.
-             This flag disables that inheritance.
+            Workflow executions only. By default, child workflows inherit the "enabled" flag when they
+             are started. This flag disables that inheritance. Ignored for standalone activities.
         disableScheduledActionPropagation:
           type: boolean
           description: |-
-            By default, executions inherit the "enabled" flag when they are started by a scheduler.
-             This flag disables that inheritance.
+            Scheduler executions only. By default, executions inherit the "enabled" flag when they are
+             started by a scheduler. This flag disables that inheritance. Ignored for standalone activities.
       description: |-
         The configuration for time skipping of an execution.
 
@@ -17484,6 +17498,12 @@ components:
          parent execution as its start time.
 
          For a scheduler execution: {{ TBD }}
+
+         For a standalone activity: time skipping applies to the activity's own retry/backoff schedule.
+         Activities scheduled by a workflow do not carry their own configuration; they inherit time
+         skipping from the workflow execution. The `disable_child_propagation` and
+         `disable_scheduled_action_propagation` fields are workflow/scheduler concepts and are ignored
+         for standalone activities.
     TimeSkippingStatePropagation:
       type: object
       properties:

temporal/api/activity/v1/message.proto

@@ -63,6 +63,9 @@ message ActivityOptions {
     // Priority metadata. If this message is not present, or any fields are not
     // present, they inherit the values from the workflow.
     temporal.api.common.v1.Priority priority = 7;
+
+    // Time-skipping configuration.
+    temporal.api.common.v1.TimeSkippingConfig time_skipping_config = 8;
 }
 
 // Information about a standalone activity.
@@ -181,6 +184,10 @@ message ActivityExecutionInfo {
 
     // Time to wait before dispatching the first activity task. This delay is not applied to retry attempts.
     google.protobuf.Duration start_delay = 37;
+
+    // The current time-skipping configuration for this activity. Reflects the value set at start
+    // and any subsequent updates via UpdateActivityExecutionOptions. Nil if time skipping is disabled.
+    temporal.api.common.v1.TimeSkippingConfig time_skipping_config = 38;
 }
 
 // Limited activity information returned in the list response.

temporal/api/common/v1/message.proto

@@ -412,8 +412,14 @@ message OnConflictOptions {
 // parent execution as its start time.
 //
 // For a scheduler execution: {{ TBD }}
+//
+// For a standalone activity: time skipping applies to the activity's own retry/backoff schedule.
+// Activities scheduled by a workflow do not carry their own configuration; they inherit time
+// skipping from the workflow execution. The `disable_child_propagation` and
+// `disable_scheduled_action_propagation` fields are workflow/scheduler concepts and are ignored
+// for standalone activities.
 message TimeSkippingConfig {
-    // Enables or disables time skipping for this workflow execution.
+    // Enables or disables time skipping for this execution.
     bool enabled = 1;
 
     // Optionally fast-forward the current execution by this duration ahead of current execution time.
@@ -431,12 +437,12 @@ message TimeSkippingConfig {
     // child workflows are separate executions, so this fast_forward won't affect them.
     google.protobuf.Duration fast_forward = 2;
 
-    // By default, child workflows inherit the "enabled" flag when they are started.
-    // This flag disables that inheritance.
+    // Workflow executions only. By default, child workflows inherit the "enabled" flag when they
+    // are started. This flag disables that inheritance. Ignored for standalone activities.
     bool disable_child_propagation = 3;
 
-    // By default, executions inherit the "enabled" flag when they are started by a scheduler.
-    // This flag disables that inheritance.
+    // Scheduler executions only. By default, executions inherit the "enabled" flag when they are
+    // started by a scheduler. This flag disables that inheritance. Ignored for standalone activities.
     bool disable_scheduled_action_propagation = 4;
 }
 

temporal/api/workflowservice/v1/request_response.proto

@@ -3188,6 +3188,9 @@ message StartActivityExecutionRequest {
     temporal.api.common.v1.OnConflictOptions on_conflict_options = 21;
     // Time to wait before dispatching the first activity task. This delay is not applied to retry attempts.
     google.protobuf.Duration start_delay = 22;
+
+    // Time-skipping configuration. If not set, time skipping is disabled.
+    temporal.api.common.v1.TimeSkippingConfig time_skipping_config = 23;
 }
 
 message StartActivityExecutionResponse {