@temporalio/core-bridge 1.14.1 → 1.15.0

package/sdk-core/crates/common/protos/api_upstream/temporal/api/history/v1/message.proto

@@ -136,22 +136,50 @@ message WorkflowExecutionStartedEventAttributes {
     reserved 36;
     reserved "parent_pinned_deployment_version";
 
+
     // If present, the new workflow should start on this version with pinned base behavior.
     // Child of pinned parent will inherit the parent's version if the Child's Task Queue belongs to that version.
     //
-    // New run initiated by workflow ContinueAsNew of pinned run, will inherit the previous run's version if the
+    // A new run initiated by workflow ContinueAsNew of pinned run, will inherit the previous run's version if the
     // new run's Task Queue belongs to that version.
     //
-    // New run initiated by workflow Cron will never inherit.
+    // A new run initiated by workflow Cron will never inherit.
     //
-    // New run initiated by workflow Retry will only inherit if the retried run is effectively pinned at the time
+    // A new run initiated by workflow Retry will only inherit if the retried run is effectively pinned at the time
     // of retry, and the retried run inherited a pinned version when it started (ie. it is a child of a pinned
     // parent, or a CaN of a pinned run, and is running on a Task Queue in the inherited version).
     //
     // Pinned override is inherited if Task Queue of new run is compatible with the override version.
     // Override is inherited separately and takes precedence over inherited base version.
+    //
+    // Note: This field is mutually exclusive with inherited_auto_upgrade_info.
+    // Additionaly, versioning_override, if present, overrides this field during routing decisions.
     temporal.api.deployment.v1.WorkerDeploymentVersion inherited_pinned_version = 37;
 
+    // If present, the new workflow begins with AutoUpgrade behavior. Before dispatching the
+    // first workflow task, this field is set to the deployment version on which the parent/
+    // previous run was operating. This inheritance only happens when the task queues belong to
+    // the same deployment version. The first workflow task will then be dispatched to either
+    // this inherited deployment version, or the current deployment version of the task queue's
+    // Deployment. After the first workflow task, the effective behavior depends on worker-sent
+    // values in subsequent workflow tasks.
+    //
+    // Inheritance rules:
+    //   - ContinueAsNew and child workflows: inherit AutoUpgrade behavior and deployment version
+    //   - Cron: never inherits
+    //   - Retry: inherits only if the retried run is effectively AutoUpgrade at the time of
+    //     retry, and inherited AutoUpgrade behavior when it started (i.e. it is a child of an
+    //     AutoUpgrade parent or ContinueAsNew of an AutoUpgrade run, running on the same
+    //     deployment as the parent/previous run)
+    //
+    // Additional notes:
+    // - This field is mutually exclusive with `inherited_pinned_version`.
+    // - `versioning_override`, if present, overrides this field during routing decisions.
+    // - SDK implementations do not interact with this field and is only used internally by
+    //   the server to ensure task routing correctness.
+    temporal.api.deployment.v1.InheritedAutoUpgradeInfo inherited_auto_upgrade_info = 39;
+
+
     // A boolean indicating whether the SDK has asked to eagerly execute the first workflow task for this workflow and
     // eager execution was accepted by the server.
     // Only populated by server with version >= 1.29.0.
@@ -195,15 +223,17 @@ message WorkflowExecutionContinuedAsNewEventAttributes {
     google.protobuf.Duration workflow_task_timeout = 6;
     // The `WORKFLOW_TASK_COMPLETED` event which this command was reported with
     int64 workflow_task_completed_event_id = 7;
-    // TODO: How and is this used?
+    // How long the server will wait before scheduling the first workflow task for the new run.
+    // Used for cron, retry, and other continue-as-new cases that server may enforce some minimal
+    // delay between new runs for system protection purpose.
     google.protobuf.Duration backoff_start_interval = 8;
     temporal.api.enums.v1.ContinueAsNewInitiator initiator = 9;
-    // TODO: David are these right?
     // Deprecated. If a workflow's retry policy would cause a new run to start when the current one
     // has failed, this field would be populated with that failure. Now (when supported by server
     // and sdk) the final event will be `WORKFLOW_EXECUTION_FAILED` with `new_execution_run_id` set.
     temporal.api.failure.v1.Failure failure = 10 [deprecated = true];
-    // TODO: Is this the result of *this* workflow as it continued-as-new?
+    // The result from the most recent completed run of this workflow. The SDK surfaces this to the
+    // new run via APIs such as `GetLastCompletionResult`.
     temporal.api.common.v1.Payloads last_completion_result = 11;
     temporal.api.common.v1.Header header = 12;
     temporal.api.common.v1.Memo memo = 13;
@@ -213,6 +243,11 @@ message WorkflowExecutionContinuedAsNewEventAttributes {
     // Deprecated. Only considered for versioning v0.2.
     bool inherit_build_id = 15 [deprecated = true];
 
+    // Experimental. Optionally decide the versioning behavior that the first task of the new run should use.
+    // For example, choose to AutoUpgrade on continue-as-new instead of inheriting the pinned version
+    // of the previous run.
+    temporal.api.enums.v1.ContinueAsNewVersioningBehavior initial_versioning_behavior = 16;
+
     // workflow_execution_timeout is omitted as it shouldn't be overridden from within a workflow.
 }
 
@@ -233,11 +268,18 @@ message WorkflowTaskStartedEventAttributes {
     int64 scheduled_event_id = 1;
     // Identity of the worker who picked up this task
     string identity = 2;
-    // TODO: ? Appears unused?
+    // This field is populated from the RecordWorkflowTaskStartedRequest. Matching service would
+    // set the request_id on the RecordWorkflowTaskStartedRequest to a new UUID. This is useful
+    // in case a RecordWorkflowTaskStarted call succeed but matching doesn't get that response,
+    // so matching could retry and history service would return success if the request_id matches.
+    // In that case, matching will continue to deliver the task to worker. Without this field, history
+    // service would return AlreadyStarted error, and matching would drop the task.
     string request_id = 3;
-    // True if this workflow should continue-as-new soon because its history size (in
-    // either event count or bytes) is getting large.
+    // True if this workflow should continue-as-new soon. See `suggest_continue_as_new_reasons` for why.
     bool suggest_continue_as_new = 4;
+    // The reason(s) that suggest_continue_as_new is true, if it is.
+    // Unset if suggest_continue_as_new is false.
+    repeated temporal.api.enums.v1.SuggestContinueAsNewReason suggest_continue_as_new_reasons = 8;
     // Total history size in bytes, which the workflow might use to decide when to
     // continue-as-new regardless of the suggestion. Note that history event count is
     // just the event id of this event, so we don't include it explicitly here.
@@ -313,13 +355,15 @@ message WorkflowTaskFailedEventAttributes {
     temporal.api.enums.v1.WorkflowTaskFailedCause cause = 3;
     // The failure details
     temporal.api.failure.v1.Failure failure = 4;
-    // If a worker explicitly failed this task, it's identity. TODO: What is this set to if server fails the task?
+    // If a worker explicitly failed this task, this field contains the worker's identity.
+    // When the server generates the failure internally this field is set as 'history-service'.
     string identity = 5;
     // The original run id of the workflow. For reset workflow.
     string base_run_id = 6;
     // If the workflow is being reset, the new run id.
     string new_run_id = 7;
-    // TODO: ?
+    // Version of the event where the history branch was forked. Used by multi-cluster replication
+    // during resets to identify the correct history branch.
     int64 fork_event_version = 8;
     // Deprecated. This field should be cleaned up when versioning-2 API is removed. [cleanup-experimental-wv]
     // If a worker explicitly failed this task, its binary id
@@ -383,7 +427,12 @@ message ActivityTaskStartedEventAttributes {
     int64 scheduled_event_id = 1;
     // id of the worker that picked up this task
     string identity = 2;
-    // TODO ??
+    // This field is populated from the RecordActivityTaskStartedRequest. Matching service would
+    // set the request_id on the RecordActivityTaskStartedRequest to a new UUID. This is useful
+    // in case a RecordActivityTaskStarted call succeed but matching doesn't get that response,
+    // so matching could retry and history service would return success if the request_id matches.
+    // In that case, matching will continue to deliver the task to worker. Without this field, history
+    // service would return AlreadyStarted error, and matching would drop the task.
     string request_id = 3;
     // Starting at 1, the number of times this task has been attempted
     int32 attempt = 4;
@@ -495,9 +544,9 @@ message TimerCanceledEventAttributes {
 
 message WorkflowExecutionCancelRequestedEventAttributes {
     // User provided reason for requesting cancellation
-    // TODO: shall we create a new field with name "reason" and deprecate this one?
     string cause = 1;
-    // TODO: Is this the ID of the event in the workflow which initiated this cancel, if there was one?
+    // The ID of the `REQUEST_CANCEL_EXTERNAL_WORKFLOW_EXECUTION_INITIATED` event in the external
+    // workflow history when the cancellation was requested by another workflow.
     int64 external_initiated_event_id = 2;
     temporal.api.common.v1.WorkflowExecution external_workflow_execution = 3;
     // id of the worker or client who requested this cancel
@@ -792,11 +841,16 @@ message WorkflowExecutionOptionsUpdatedEventAttributes {
     temporal.api.workflow.v1.VersioningOverride versioning_override = 1;
     // Versioning override removed in this event.
     bool unset_versioning_override = 2;
-    // Request ID attachedto the running workflow execution so that subsequent requests with same
+    // Request ID attached to the running workflow execution so that subsequent requests with same
     // request ID will be deduped.
     string attached_request_id = 3;
     // Completion callbacks attached to the running workflow execution.
     repeated temporal.api.common.v1.Callback attached_completion_callbacks = 4;
+    // Optional. The identity of the client who initiated the request that created this event.
+    string identity = 5;
+    // Priority override upserted in this event. Represents the full priority; not just partial fields.
+    // Ignored if nil.
+    temporal.api.common.v1.Priority priority = 6;
 }
 
 // Not used anywhere. Use case is replaced by WorkflowExecutionOptionsUpdatedEventAttributes
@@ -869,6 +923,26 @@ message WorkflowExecutionUpdateAdmittedEventAttributes {
     temporal.api.enums.v1.UpdateAdmittedEventOrigin origin = 2;
 }
 
+ // Attributes for an event marking that a workflow execution was paused.
+message WorkflowExecutionPausedEventAttributes {
+    // The identity of the client who paused the workflow execution.
+    string identity = 1;
+    // The reason for pausing the workflow execution.
+    string reason = 2;
+    // The request ID of the request that paused the workflow execution.
+    string request_id = 3;
+}
+
+// Attributes for an event marking that a workflow execution was unpaused.
+message WorkflowExecutionUnpausedEventAttributes {
+    // The identity of the client who unpaused the workflow execution.
+    string identity = 1;
+    // The reason for unpausing the workflow execution.
+    string reason = 2;
+    // The request ID of the request that unpaused the workflow execution.
+    string request_id = 3;
+}
+
 // Event marking that an operation was scheduled by a workflow via the ScheduleNexusOperation command.
 message NexusOperationScheduledEventAttributes {
     // Endpoint name, must exist in the endpoint registry.
@@ -901,6 +975,18 @@ message NexusOperationScheduledEventAttributes {
     // This is stored on the event and used internally by the server in case the endpoint is renamed from the time the
     // event was originally scheduled.
     string endpoint_id = 9;
+
+    // Schedule-to-start timeout for this operation.
+    // See ScheduleNexusOperationCommandAttributes.schedule_to_start_timeout for details.
+    // (-- api-linter: core::0140::prepositions=disabled
+    //     aip.dev/not-precedent: "to" is used to indicate interval. --)
+    google.protobuf.Duration schedule_to_start_timeout = 10;
+
+    // Start-to-close timeout for this operation.
+    // See ScheduleNexusOperationCommandAttributes.start_to_close_timeout for details.
+    // (-- api-linter: core::0140::prepositions=disabled
+    //     aip.dev/not-precedent: "to" is used to indicate interval. --)
+    google.protobuf.Duration start_to_close_timeout = 11;
 }
 
 // Event marking an asynchronous operation was started by the responding Nexus handler.
@@ -1006,9 +1092,11 @@ message HistoryEvent {
     int64 event_id = 1;
     google.protobuf.Timestamp event_time = 2;
     temporal.api.enums.v1.EventType event_type = 3;
-    // TODO: What is this? Appears unused by SDKs
+    // Failover version of the event, used by the server for multi-cluster replication and history
+    // versioning. SDKs generally ignore this field.
     int64 version = 4;
-    // TODO: What is this? Appears unused by SDKs
+    // Identifier used by the service to order replication and transfer tasks associated with this
+    // event. SDKs generally ignore this field.
     int64 task_id = 5;
     // Set to true when the SDK may ignore the event as it does not impact workflow state or
     // information in any way that the SDK need be concerned with. If an SDK encounters an event
@@ -1085,6 +1173,8 @@ message HistoryEvent {
         WorkflowExecutionOptionsUpdatedEventAttributes workflow_execution_options_updated_event_attributes = 60;
         NexusOperationCancelRequestCompletedEventAttributes nexus_operation_cancel_request_completed_event_attributes = 61;
         NexusOperationCancelRequestFailedEventAttributes nexus_operation_cancel_request_failed_event_attributes = 62;
+        WorkflowExecutionPausedEventAttributes workflow_execution_paused_event_attributes = 63;
+        WorkflowExecutionUnpausedEventAttributes workflow_execution_unpaused_event_attributes = 64;
     }
 }
 

package/sdk-core/crates/common/protos/api_upstream/temporal/api/namespace/v1/message.proto

@@ -38,6 +38,21 @@ message NamespaceInfo {
         bool worker_heartbeats = 4;
         // True if the namespace supports reported problems search attribute
         bool reported_problems_search_attribute = 5;
+        // True if the namespace supports pausing workflows
+        bool workflow_pause = 6;
+        // True if the namespace supports standalone activities
+        bool standalone_activities = 7;
+    }
+
+    // Namespace configured limits
+    Limits limits = 8;
+    message Limits {
+        // Maximum size in bytes for payload fields in workflow history events
+        // (e.g., workflow/activity inputs and results, failure details, signal payloads).
+        // When exceeded, the server will reject the operation with an error.
+        int64 blob_size_limit_error = 1;
+        // Maximum total memo size in bytes per workflow execution.
+        int64 memo_size_limit_error = 2;
     }
 
     // Whether scheduled workflows are supported on this namespace. This is only needed

package/sdk-core/crates/common/protos/api_upstream/temporal/api/nexus/v1/message.proto

@@ -90,6 +90,10 @@ message Request {
         StartOperationRequest start_operation = 3;
         CancelOperationRequest cancel_operation = 4;
     }
+
+    // The endpoint this request was addressed to before forwarding to the worker.
+    // Supported from server version 1.30.0.
+    string endpoint = 10;
 }
 
 // Response variant for StartOperationRequest.

package/sdk-core/crates/common/protos/api_upstream/temporal/api/operatorservice/v1/request_response.proto

@@ -68,6 +68,8 @@ message AddOrUpdateRemoteClusterRequest {
     // Frontend HTTP Address is a cross cluster accessible address for HTTP traffic. This field is optional. If not provided
     //  on update, the existing HTTP address will be removed.
     string frontend_http_address = 3;
+    // Controls whether replication streams are active.
+    bool enable_replication = 4;
 }
 
 message AddOrUpdateRemoteClusterResponse {
@@ -107,6 +109,8 @@ message ClusterMetadata {
     int32 history_shard_count = 5;
     // A flag to indicate if a connection is active.
     bool is_connection_enabled = 6;
+    // A flag to indicate if replication is enabled.
+    bool is_replication_enabled = 8;
 }
 
 message GetNexusEndpointRequest {

package/sdk-core/crates/common/protos/api_upstream/temporal/api/schedule/v1/message.proto

@@ -81,8 +81,8 @@ message Range {
 // corresponding fields of the timestamp, except for year: if year is missing,
 // that means all years match. For all fields besides year, at least one Range
 // must be present to match anything.
-// TODO: add relative-to-end-of-month
-// TODO: add nth day-of-week in month
+// Relative expressions such as "last day of the month" or "third Monday" are not currently
+// representable; callers must enumerate the concrete days they require.
 message StructuredCalendarSpec {
     // Match seconds (0-59)
     repeated Range second = 1;

package/sdk-core/crates/common/protos/api_upstream/temporal/api/taskqueue/v1/message.proto

@@ -343,4 +343,6 @@ message TaskQueueConfig {
     RateLimitConfig queue_rate_limit = 1;
     // If set, each individual fairness key will be limited to this rate, scaled by the weight of the fairness key.
     RateLimitConfig fairness_keys_rate_limit_default = 2;
+    // If set, overrides the fairness weights for the corresponding fairness keys.
+    map<string, float> fairness_weight_overrides = 3;
 }

package/sdk-core/crates/common/protos/api_upstream/temporal/api/worker/v1/message.proto

@@ -54,15 +54,12 @@ message WorkerHostInfo {
   // Worker host identifier.
   string host_name = 1;
 
-
-  // Worker process identifier. This id should be unique for all _processes_
-  // running workers in the namespace, and should be shared by all workers
-  // in the same process.
+  // Worker grouping identifier. A key to group workers that share the same client+namespace+process.
   // This will be used to build the worker command nexus task queue name:
-  // "temporal-sys/worker-commands/{process_key}"
-  string process_key = 5;
+  // "temporal-sys/worker-commands/{worker_grouping_key}"
+  string worker_grouping_key = 5;
 
-  // Worker process identifier. Unlike process_key, this id only needs to be unique
+  // Worker process identifier. This id only needs to be unique
   // within one host (so using e.g. a unix pid would be appropriate).
   string process_id = 2;
 

package/sdk-core/crates/common/protos/api_upstream/temporal/api/workflow/v1/message.proto

@@ -98,6 +98,12 @@ message WorkflowExecutionInfo {
 
     // Priority metadata
     temporal.api.common.v1.Priority priority = 24;
+
+    // Total size in bytes of all external payloads referenced in workflow history.
+    int64 external_payload_size_bytes = 25;
+
+    // Count of external payloads referenced in workflow history.
+    int64 external_payload_count = 26;
 }
 
 // Holds all the extra information about workflow execution that is not part of Visibility.
@@ -126,6 +132,9 @@ message WorkflowExecutionExtendedInfo {
     // calls (eg: if SignalWithStartWorkflowExecution starts a new workflow, then the request ID is
     // used in the StartWorkflowExecution request).
     map<string, RequestIdInfo> request_id_infos = 7;
+
+    // Information about the workflow execution pause operation.
+    WorkflowExecutionPauseInfo pause_info = 8;
 }
 
 // Holds all the information about worker versioning for a particular workflow execution.
@@ -135,12 +144,14 @@ message WorkflowExecutionVersioningInfo {
     // upgraded. When present it means this workflow execution is versioned; UNSPECIFIED means
     // unversioned. See the comments in `VersioningBehavior` enum for more info about different
     // behaviors.
-    // This field is first set after an execution completes its first workflow task on a versioned
-    // worker, and set again on completion of every subsequent workflow task.
-    // For child workflows of Pinned parents, this will be set to Pinned (along with `deployment_version`) when
-    // the the child starts so that child's first workflow task goes to the same Version as the
-    // parent. After the first workflow task, it depends on the child workflow itself if it wants
-    // to stay pinned or become unpinned (according to Versioning Behavior set in the worker).
+    //
+    // Child workflows or CaN executions **inherit** their parent/previous run's effective Versioning 
+    // Behavior and Version (except when the new execution runs on a task queue not belonging to the 
+    // same deployment version as the parent/previous run's task queue). The first workflow task will
+    // be dispatched according to the inherited behavior (or to the current version of the task-queue's 
+    // deployment in the case of AutoUpgrade.) After completion of their first workflow task the 
+    // Deployment Version and Behavior of the execution will update according to configuration on the worker.
+    // 
     // Note that `behavior` is overridden by `versioning_override` if the latter is present.
     temporal.api.enums.v1.VersioningBehavior behavior = 1;
     // The worker deployment that completed the last workflow task of this workflow execution. Must
@@ -158,10 +169,15 @@ message WorkflowExecutionVersioningInfo {
     // If present, and `behavior` is UNSPECIFIED, the last task of this workflow execution was completed
     // by a worker that is not using versioning but _is_ passing Deployment Name and Build ID.
     //
-    // For child workflows of Pinned parents, this will be set to the parent's Pinned Version when
-    // the child starts, so that the child's first workflow task goes to the same Version as the parent.
+    // Child workflows or CaN executions **inherit** their parent/previous run's effective Versioning 
+    // Behavior and Version (except when the new execution runs on a task queue not belonging to the 
+    // same deployment version as the parent/previous run's task queue). The first workflow task will
+    // be dispatched according to the inherited behavior (or to the current version of the task-queue's 
+    // deployment in the case of AutoUpgrade.) After completion of their first workflow task the 
+    // Deployment Version and Behavior of the execution will update according to configuration on the worker.
+    //
     // Note that if `versioning_override.behavior` is PINNED then `versioning_override.pinned_version`
-    // will override this value.
+    // will override this value. 
     temporal.api.deployment.v1.WorkerDeploymentVersion deployment_version = 7;
     // Present if user has set an execution-specific versioning override. This override takes
     // precedence over SDK-sent `behavior` (and `version` when override is PINNED). An
@@ -208,6 +224,14 @@ message WorkflowExecutionVersioningInfo {
     // Pending activities will not start new attempts during a transition. Once the transition is
     // completed, pending activities will start their next attempt on the new version.
     DeploymentVersionTransition version_transition = 6;
+    // Monotonic counter reflecting the latest routing decision for this workflow execution.
+    // Used for staleness detection between history and matching when dispatching tasks to workers.
+    // Incremented when a workflow execution routes to a new deployment version, which happens
+    // when a worker of the new deployment version completes a workflow task.
+    // Note: Pinned tasks and sticky tasks send a value of 0 for this field since these tasks do not
+    // face the problem of inconsistent dispatching that arises from eventual consistency between
+    // task queues and their partitions.
+    int64 revision_number = 8;
 }
 
 // Holds information about ongoing transition of a workflow execution from one deployment to another.
@@ -300,8 +324,8 @@ message PendingActivityInfo {
     // If nil, the activity has not yet been dispatched or was last dispatched to an unversioned worker.
     temporal.api.deployment.v1.WorkerDeploymentVersion last_deployment_version = 25;
 
-
-    // Priority metadata
+    // 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 = 22;
 
     message PauseInfo {
@@ -502,6 +526,16 @@ message PendingNexusOperationInfo {
 
     // Operation token. Only set for asynchronous operations after a successful StartOperation call.
     string operation_token = 15;
+
+    // Schedule-to-start timeout for this operation.
+    // (-- api-linter: core::0140::prepositions=disabled
+    //     aip.dev/not-precedent: "to" is used to indicate interval. --)
+    google.protobuf.Duration schedule_to_start_timeout = 16;
+
+    // Start-to-close timeout for this operation.
+    // (-- api-linter: core::0140::prepositions=disabled
+    //     aip.dev/not-precedent: "to" is used to indicate interval. --)
+    google.protobuf.Duration start_to_close_timeout = 17;
 }
 
 // NexusOperationCancellationInfo contains the state of a nexus operation cancellation.
@@ -529,24 +563,30 @@ message NexusOperationCancellationInfo {
 message WorkflowExecutionOptions {
     // If set, takes precedence over the Versioning Behavior sent by the SDK on Workflow Task completion.
     VersioningOverride versioning_override = 1;
+
+    // If set, overrides the workflow's priority sent by the SDK.
+    temporal.api.common.v1.Priority priority = 2;
 }
 
 // Used to override the versioning behavior (and pinned deployment version, if applicable) of a
-// specific workflow execution. If set, takes precedence over the worker-sent values. See
-// `WorkflowExecutionInfo.VersioningInfo` for more information. To remove the override, call
-// `UpdateWorkflowExecutionOptions` with a null `VersioningOverride`, and use the `update_mask`
-// to indicate that it should be mutated.
-// Pinned overrides are automatically inherited by child workflows, continue-as-new workflows,
-// workflow retries, and cron workflows.
+// specific workflow execution. If set, this override takes precedence over worker-sent values.
+// See `WorkflowExecutionInfo.VersioningInfo` for more information.
+//
+// To remove the override, call `UpdateWorkflowExecutionOptions` with a null
+// `VersioningOverride`, and use the `update_mask` to indicate that it should be mutated.
+//
+// Pinned behavior overrides are automatically inherited by child workflows, workflow retries, continue-as-new
+// workflows, and cron workflows.
 message VersioningOverride {
     // Indicates whether to override the workflow to be AutoUpgrade or Pinned.
     oneof override {
-        // Send the next workflow task to the Version specified in the override.
+        // Override the workflow to have Pinned behavior.
         PinnedOverride pinned = 3;
-        // Send the next workflow task to the Current Deployment Version
-        // of its Task Queue when the next workflow task is dispatched.
+
+        // Override the workflow to have AutoUpgrade behavior.
         bool auto_upgrade = 4;
     }
+
     // Required.
     // Deprecated. Use `override`.
     temporal.api.enums.v1.VersioningBehavior behavior = 1 [deprecated = true];
@@ -566,14 +606,22 @@ message VersioningOverride {
         // Defaults to PINNED_OVERRIDE_BEHAVIOR_UNSPECIFIED.
         // See `PinnedOverrideBehavior` for details.
         PinnedOverrideBehavior behavior = 1;
-        // Required.
+
+        // Specifies the Worker Deployment Version to pin this workflow to.
+        // Required if the target workflow is not already pinned to a version.
+        //
+        // If omitted and the target workflow is already pinned, the effective
+        // pinned version will be the existing pinned version.
+        //
+        // If omitted and the target workflow is not pinned, the override request
+        // will be rejected with a PreconditionFailed error.
         temporal.api.deployment.v1.WorkerDeploymentVersion version = 2;
     }
 
-    // Used to specify different sub-types of Pinned override that we plan to add in the future.
     enum PinnedOverrideBehavior {
         // Unspecified.
         PINNED_OVERRIDE_BEHAVIOR_UNSPECIFIED = 0;
+
         // Override workflow behavior to be Pinned.
         PINNED_OVERRIDE_BEHAVIOR_PINNED = 1;
     }
@@ -636,3 +684,13 @@ message PostResetOperation {
     }
 }
 
+// WorkflowExecutionPauseInfo contains the information about a workflow execution pause.
+message WorkflowExecutionPauseInfo {
+    // The identity of the client who paused the workflow execution.
+    string identity = 1;
+    // The time when the workflow execution was paused.
+    google.protobuf.Timestamp paused_time = 2;
+    // The reason for pausing the workflow execution.
+    string reason = 3;
+}
+