move time skipping config from workflow folder to the common folder

Author: feiyang3cat

temporal/api/common/v1/message.proto

@@ -11,6 +11,7 @@ option csharp_namespace = "Temporalio.Api.Common.V1";
 
 import "google/protobuf/duration.proto";
 import "google/protobuf/empty.proto";
+import "google/protobuf/timestamp.proto";
 
 import "temporal/api/enums/v1/common.proto";
 import "temporal/api/enums/v1/event_type.proto";
@@ -393,3 +394,52 @@ message OnConflictOptions {
     // Attaches the links to the running execution.
     bool attach_links = 3;
 }
+
+// The configuration for time skipping of a workflow execution (a chain of runs including retries, cron, continue-as-new).
+// When time skipping is enabled, virtual time advances automatically whenever there is no in-flight work.
+// In-flight work includes activities, child workflows, Nexus operations, signal/cancel external workflow operations,
+// and possibly other features added in the future.
+// User timers are not classified as in-flight work and will be skipped over; the virtual clock may also skip to the
+// time point of the registered fast forward when there is no in-flight work.
+// When time is skipped, a WorkflowExecutionTimeSkippingTransitionedEvent will be
+// added to the workflow history to capture the state changes.
+//
+// For child workflows, by default, if the parent execution is skipping time, the child execution will also skip time,
+// but a parent's fast_forward won't affect its child's execution. A flag is provided to disable propagation of the
+// "enabled" flag to child workflows; regardless of that flag, a child workflow inherits the virtual time from the
+// parent execution as its start time.
+message TimeSkippingConfig {
+    // Enables or disables time skipping for this workflow execution.
+    bool enabled = 1;
+
+    // Optionally fast-forward the current workflow execution by this duration ahead of current workflow execution time.
+    // When the fast-forward completes, time skipping is disabled by the call that initiated the fast-forward, and this
+    // action is recorded in the WorkflowExecutionTimeSkippingTransitionedEvent. It can be re-enabled by
+    // setting `enabled` to true via UpdateWorkflowExecutionOptions.
+    // The current workflow execution is a chain of runs (retries, cron, continue-as-new);
+    // child workflows are separate executions, so this fast_forward won't affect them.
+    //
+    // For a given workflow execution, only one active fast-forward is allowed at a time.
+    // If a new fast-forward is set via UpdateWorkflowExecutionOptions before the previous
+    // one completes, the new one will override the previous one.
+    // If the fast-forward duration exceeds the remaining execution timeout, time will only
+    // be fast-forwarded up to the end of the execution.
+    google.protobuf.Duration fast_forward = 2;
+
+    // By default, child workflows inherit the "enabled" flag when they are started.
+    // This flag disables that inheritance.
+    bool disable_child_propagation = 3;
+}
+
+// The time-skipping state that needs to be propagated from a parent workflow to a child workflow,
+// or through a chain of runs.
+message TimeSkippingStatePropagation {
+
+    // The time skipped by the previous execution that started this workflow.
+    // It can happen in child workflows and a chain of runs (CaN, cron, retry).
+    google.protobuf.Duration initial_skipped_duration = 1;
+
+    // If there is a fast-forward action set for the previous run in a chain of runs,
+    // the target time should be propagated to the next run as well.
+    google.protobuf.Timestamp fast_forward_target_time = 2;
+}

temporal/api/history/v1/message.proto

@@ -204,14 +204,14 @@ message WorkflowExecutionStartedEventAttributes {
     //
     // The configuration may be updated after start via UpdateWorkflowExecutionOptions, which
     // will be reflected in the WorkflowExecutionOptionsUpdatedEvent.
-    temporal.api.workflow.v1.TimeSkippingConfig time_skipping_config = 41;
+    temporal.api.common.v1.TimeSkippingConfig time_skipping_config = 41;
 
     reserved 42;
     reserved "initial_skipped_duration";
 
     // The time-skipping state propagated from a previous run of this workflow. This can be nil
     // if no time skipping has occurred or there is no previous run.
-    temporal.api.workflow.v1.TimeSkippingStatePropagation time_skipping_state_propagation = 43;
+    temporal.api.common.v1.TimeSkippingStatePropagation time_skipping_state_propagation = 43;
 
 }
 
@@ -782,14 +782,14 @@ message StartChildWorkflowExecutionInitiatedEventAttributes {
     temporal.api.common.v1.Priority priority = 20;
 
     // The propagated time-skipping configuration for the child workflow.
-    temporal.api.workflow.v1.TimeSkippingConfig time_skipping_config = 21;
+    temporal.api.common.v1.TimeSkippingConfig time_skipping_config = 21;
 
     reserved 22;
     reserved "initial_skipped_duration";
 
     // The time-skipping state propagated from the parent workflow. This can be nil if no time skipping
     // has occurred or there is no previous run.
-    temporal.api.workflow.v1.TimeSkippingStatePropagation time_skipping_state_propagation = 23;
+    temporal.api.common.v1.TimeSkippingStatePropagation time_skipping_state_propagation = 23;
 }
 
 message StartChildWorkflowExecutionFailedEventAttributes {
@@ -916,7 +916,7 @@ message WorkflowExecutionOptionsUpdatedEventAttributes {
     // Ignored if nil.
     temporal.api.common.v1.Priority priority = 6;
     // If set, the time-skipping configuration was changed. Contains the full updated configuration.
-    temporal.api.workflow.v1.TimeSkippingConfig time_skipping_config = 7;
+    temporal.api.common.v1.TimeSkippingConfig time_skipping_config = 7;
     // Updates to workflow updates options.
     repeated WorkflowUpdateOptionsUpdate workflow_update_options = 8;
 }

temporal/api/workflow/v1/message.proto

@@ -593,59 +593,9 @@ message WorkflowExecutionOptions {
     // to the current workflow timestamp. Each call takes effect, even if
     // `fast_forward` is set to the same duration, since the target time is recalculated
     // from the current timestamp on every call.
-    TimeSkippingConfig time_skipping_config = 3;
+    temporal.api.common.v1.TimeSkippingConfig time_skipping_config = 3;
 }
 
-// The configuration for time skipping of a workflow execution (a chain of runs including retries, cron, continue-as-new).
-// When time skipping is enabled, virtual time advances automatically whenever there is no in-flight work.
-// In-flight work includes activities, child workflows, Nexus operations, signal/cancel external workflow operations,
-// and possibly other features added in the future.
-// User timers are not classified as in-flight work and will be skipped over; the virtual clock may also skip to the
-// time point of the registered fast forward when there is no in-flight work.
-// When time is skipped, a WorkflowExecutionTimeSkippingTransitionedEvent will be
-// added to the workflow history to capture the state changes.
-//
-// For child workflows, by default, if the parent execution is skipping time, the child execution will also skip time,
-// but a parent's fast_forward won't affect its child's execution. A flag is provided to disable propagation of the
-// "enabled" flag to child workflows; regardless of that flag, a child workflow inherits the virtual time from the
-// parent execution as its start time.
-message TimeSkippingConfig {
-    // Enables or disables time skipping for this workflow execution.
-    bool enabled = 1;
-
-    // Optionally fast-forward the current workflow execution by this duration ahead of current workflow execution time.
-    // When the fast-forward completes, time skipping is disabled by the call that initiated the fast-forward, and this
-    // action is recorded in the WorkflowExecutionTimeSkippingTransitionedEvent. It can be re-enabled by
-    // setting `enabled` to true via UpdateWorkflowExecutionOptions.
-    // The current workflow execution is a chain of runs (retries, cron, continue-as-new);
-    // child workflows are separate executions, so this fast_forward won't affect them.
-    //
-    // For a given workflow execution, only one active fast-forward is allowed at a time.
-    // If a new fast-forward is set via UpdateWorkflowExecutionOptions before the previous
-    // one completes, the new one will override the previous one.
-    // If the fast-forward duration exceeds the remaining execution timeout, time will only
-    // be fast-forwarded up to the end of the execution.
-    google.protobuf.Duration fast_forward = 2;
-
-    // By default, child workflows inherit the "enabled" flag when they are started.
-    // This flag disables that inheritance.
-    bool disable_child_propagation = 3;
-}
-
-// The time-skipping state that needs to be propagated from a parent workflow to a child workflow,
-// or through a chain of runs.
-message TimeSkippingStatePropagation {
-
-    // The time skipped by the previous execution that started this workflow.
-    // It can happen in child workflows and a chain of runs (CaN, cron, retry).
-    google.protobuf.Duration initial_skipped_duration = 1;
-
-    // If there is a fast-forward action set for the previous run in a chain of runs,
-    // the target time should be propagated to the next run as well.
-    google.protobuf.Timestamp fast_forward_target_time = 2;
-}
-
-
 // Used to override the versioning behavior (and pinned deployment version, if applicable) of a
 // specific workflow execution. If set, this override takes precedence over worker-sent values.
 // See `WorkflowExecutionInfo.VersioningInfo` for more information.

temporal/api/workflowservice/v1/request_response.proto

@@ -210,7 +210,7 @@ message StartWorkflowExecutionRequest {
     temporal.api.deployment.v1.WorkerDeploymentOptions eager_worker_deployment_options = 28;
 
     // Time-skipping configuration. If not set, time skipping is disabled.
-    temporal.api.workflow.v1.TimeSkippingConfig time_skipping_config = 29;
+    temporal.api.common.v1.TimeSkippingConfig time_skipping_config = 29;
 }
 
 message StartWorkflowExecutionResponse {
@@ -899,7 +899,7 @@ message SignalWithStartWorkflowExecutionRequest {
     // Priority metadata
     temporal.api.common.v1.Priority priority = 26;
     // Time-skipping configuration. If not set, time skipping is disabled.
-    temporal.api.workflow.v1.TimeSkippingConfig time_skipping_config = 27;
+    temporal.api.common.v1.TimeSkippingConfig time_skipping_config = 27;
 }
 
 message SignalWithStartWorkflowExecutionResponse {