change the default ts-bound propagation bebahvior

Author: feiyang3cat

openapi/openapiv2.json

@@ -16756,6 +16756,10 @@
         "priority": {
           "$ref": "#/definitions/v1Priority",
           "title": "Priority metadata"
+        },
+        "timeSkippingConfig": {
+          "$ref": "#/definitions/v1TimeSkippingConfig",
+          "description": "Initial time-skipping configuration for the child workflow execution.\nThis field cannot be set explicitly; it is propagated from the parent workflow."
         }
       }
     },
@@ -17128,11 +17132,11 @@
       "properties": {
         "enabled": {
           "type": "boolean",
-          "description": "Enables or disables time skipping for this workflow execution.\nBy default, this field is propagated to transitively related workflows (child workflows/start-as-new/reset) \nat the time they are started.\nChanges made after a transitively related workflow has started are not propagated."
+          "description": "Enables or disables time skipping for this workflow execution."
         },
         "disablePropagation": {
           "type": "boolean",
-          "description": "If set, the enabled field is not propagated to transitively related workflows."
+          "description": "By default, the time skipping configuration is propagated to transitively related workflows.\nIf set, transitively related workflows will be started with time skipping disabled."
         },
         "maxSkippedDuration": {
           "type": "string",

openapi/openapiv3.yaml

@@ -14549,6 +14549,12 @@ components:
           allOf:
             - $ref: '#/components/schemas/Priority'
           description: Priority metadata
+        timeSkippingConfig:
+          allOf:
+            - $ref: '#/components/schemas/TimeSkippingConfig'
+          description: |-
+            Initial time-skipping configuration for the child workflow execution.
+             This field cannot be set explicitly; it is propagated from the parent workflow.
     StartWorkflowExecutionRequest:
       type: object
       properties:
@@ -15103,10 +15109,12 @@ components:
       properties:
         enabled:
           type: boolean
-          description: "Enables or disables time skipping for this workflow execution.\n By default, this field is propagated to transitively related workflows (child workflows/start-as-new/reset) \n at the time they are started.\n Changes made after a transitively related workflow has started are not propagated."
+          description: Enables or disables time skipping for this workflow execution.
         disablePropagation:
           type: boolean
-          description: If set, the enabled field is not propagated to transitively related workflows.
+          description: |-
+            By default, the time skipping configuration is propagated to transitively related workflows.
+             If set, transitively related workflows will be started with time skipping disabled.
         maxSkippedDuration:
           pattern: ^-?(?:0|[1-9][0-9]{0,11})(?:\.[0-9]{1,9})?s$
           type: string

temporal/api/history/v1/message.proto

@@ -770,6 +770,10 @@ message StartChildWorkflowExecutionInitiatedEventAttributes {
     bool inherit_build_id = 19 [deprecated = true];
     // Priority metadata
     temporal.api.common.v1.Priority priority = 20;
+
+    // Initial time-skipping configuration for the child workflow execution.
+    // This field cannot be set explicitly; it is propagated from the parent workflow.
+    temporal.api.workflow.v1.TimeSkippingConfig time_skipping_config = 21;
 }
 
 message StartChildWorkflowExecutionFailedEventAttributes {

temporal/api/workflow/v1/message.proto

@@ -592,12 +592,10 @@ message WorkflowExecutionOptions {
 message TimeSkippingConfig {
 
     // Enables or disables time skipping for this workflow execution.
-    // By default, this field is propagated to transitively related workflows (child workflows/start-as-new/reset) 
-    // at the time they are started.
-    // Changes made after a transitively related workflow has started are not propagated.
     bool enabled = 1;
 
-    // If set, the enabled field is not propagated to transitively related workflows.
+    // By default, the time skipping configuration is propagated to transitively related workflows.
+    // If set, transitively related workflows will be started with time skipping disabled.
     bool disable_propagation = 2;
 
     // Optional bound that limits how long time skipping remains active.
@@ -608,10 +606,16 @@ message TimeSkippingConfig {
     // are expected to receive signals, updates, or other events while
     // timers are in progress.
     //
-    // This bound is not propagated to transitively related workflows. 
-    // When bound is also needed for transitively related workflows,
-    // it is recommended to set disable_propagation to true 
-    // and configure TimeSkippingConfig explicitly for transitively related workflows.
+    // The bound is propagated to transitively related workflows differently
+    // depending on the type and semantics of the related workflow:
+    // - For child workflows, the bound is propagated with the same value as the parent workflow.
+    //   If duration-based bound is used, the child workflow will have the full duration as the bound.
+    //   If target-time based bound is used, the child workflow will have the same target time as the parent workflow.
+    // - For continue-as-new workflows, if a duration-based bound is used, the remaining
+    //   duration is propagated, so the continue-as-new workflow shares the initial bound
+    //   with the parent workflow.
+    // - For reset workflows, the entire TimeSkippingConfig is restored to the value it
+    //   had at the event this workflow is reset to.
     oneof bound {
 
         // Maximum total virtual time that can be skipped.