@temporalio/core-bridge 1.11.6 → 1.11.8

package/sdk-core/sdk-core-protos/protos/api_upstream/temporal/api/batch/v1/message.proto

@@ -31,11 +31,13 @@ option java_outer_classname = "MessageProto";
 option ruby_package = "Temporalio::Api::Batch::V1";
 option csharp_namespace = "Temporalio.Api.Batch.V1";
 
+import "google/protobuf/duration.proto";
+import "google/protobuf/field_mask.proto";
 import "google/protobuf/timestamp.proto";
-
 import "temporal/api/common/v1/message.proto";
 import "temporal/api/enums/v1/batch_operation.proto";
 import "temporal/api/enums/v1/reset.proto";
+import "temporal/api/workflow/v1/message.proto";
 
 message BatchOperationInfo {
   // Batch job ID
@@ -102,3 +104,39 @@ message BatchOperationReset {
   temporal.api.enums.v1.ResetReapplyType reset_reapply_type = 2;
 
 }
+
+// BatchOperationUpdateWorkflowExecutionOptions sends UpdateWorkflowExecutionOptions requests to batch workflows.
+// Keep the parameters in sync with temporal.api.workflowservice.v1.UpdateWorkflowExecutionOptionsRequest.
+message BatchOperationUpdateWorkflowExecutionOptions {
+  // The identity of the worker/client.
+  string identity = 1;
+
+  // Workflow Execution options. Partial updates are accepted and controlled by update_mask.
+  temporal.api.workflow.v1.WorkflowExecutionOptions workflow_execution_options = 2;
+
+  // Controls which fields from `workflow_execution_options` will be applied.
+  // To unset a field, set it to null and use the update mask to indicate that it should be mutated.
+  google.protobuf.FieldMask update_mask = 3;
+}
+
+// BatchOperationUnpauseActivities sends unpause requests to batch workflows.
+message BatchOperationUnpauseActivities {
+  // The identity of the worker/client.
+  string identity = 1;
+
+  // The activity to unpause. If match_all is set to true, all activities will be unpaused.
+  oneof activity {
+    string type = 2;
+    bool match_all = 3;
+  }
+
+  // Providing this flag will also reset the number of attempts.
+  bool reset_attempts = 4;
+
+  // Providing this flag will also reset the heartbeat details.
+  bool reset_heartbeat = 5;
+
+  // If set, the activity will start at a random time within the specified jitter
+  // duration, introducing variability to the start time.
+  google.protobuf.Duration jitter = 6;
+}

package/sdk-core/sdk-core-protos/protos/api_upstream/temporal/api/command/v1/message.proto

@@ -85,6 +85,9 @@ message ScheduleActivityTaskCommandAttributes {
     // If this is set, the activity would be assigned to the Build ID of the workflow. Otherwise,
     // Assignment rules of the activity's Task Queue will be used to determine the Build ID.
     bool use_workflow_build_id = 13;
+    // 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 = 14;
 }
 
 message RequestCancelActivityTaskCommandAttributes {
@@ -226,6 +229,9 @@ message StartChildWorkflowExecutionCommandAttributes {
     // If this is set, the child workflow inherits the Build ID of the parent. Otherwise, the assignment
     // rules of the child's Task Queue will be used to independently assign a Build ID to it.
     bool inherit_build_id = 17;
+    // 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 = 18;
 }
 
 message ProtocolMessageCommandAttributes {

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

@@ -123,6 +123,7 @@ message MeteringMetadata {
     uint32 nonfirst_local_activity_execution_attempts = 13;
 }
 
+// Deprecated. This message is replaced with `Deployment` and `VersioningBehavior`.
 // Identifies the version(s) of a worker that processed a task
 message WorkerVersionStamp {
     // An opaque whole-worker identifier. Replaces the deprecated `binary_checksum` field when this
@@ -136,9 +137,10 @@ message WorkerVersionStamp {
     // Later, may include bundle id that could be used for WASM and/or JS dynamically loadable bundles.
 }
 
-// Identifies the version(s) that a worker is compatible with when polling or identifying itself,
+// Identifies the version that a worker is compatible with when polling or identifying itself,
 // and whether or not this worker is opting into the build-id based versioning feature. This is
 // used by matching to determine which workers ought to receive what tasks.
+// Deprecated. Use WorkerDeploymentOptions instead.
 message WorkerVersionCapabilities {
     // An opaque whole-worker identifier
     string build_id = 1;
@@ -147,6 +149,9 @@ message WorkerVersionCapabilities {
     // tasks.
     bool use_versioning = 2;
 
+    // Must be sent if user has set a deployment series name (versioning-3).
+    string deployment_series_name = 4;
+
     // Later, may include info like "I can process WASM and/or JS bundles"
 }
 
@@ -242,3 +247,36 @@ message Link {
         BatchJob batch_job = 2;
     }
 }
+
+// Priority contains metadata that controls relative ordering of task processing
+// when tasks are backlogged in a queue. Initially, Priority will be used in
+// activity and workflow task queues, which are typically where backlogs exist.
+// Other queues in the server (such as transfer and timer queues) and rate
+// limiting decisions do not use Priority, but may in the future.
+//
+// Priority is attached to workflows and activities. Activities and child
+// workflows inherit Priority from the workflow that created them, but may
+// override fields when they are started or modified. For each field of a
+// Priority on an activity/workflow, not present or equal to zero/empty string
+// means to inherit the value from the calling workflow, or if there is no
+// calling workflow, then use the default (documented below).
+//
+// Despite being named "Priority", this message will also contains fields that
+// control "fairness" mechanisms.
+//
+// The overall semantics of Priority are:
+// 1. First, consider "priority_key": lower number goes first.
+// (more will be added here later)
+message Priority {
+    // Priority key is a positive integer from 1 to n, where smaller integers
+    // correspond to higher priorities (tasks run sooner). In general, tasks in
+    // a queue should be processed in close to priority order, although small
+    // deviations are possible.
+    //
+    // The maximum priority value (minimum priority) is determined by server
+    // configuration, and defaults to 5.
+    //
+    // The default priority is (min+max)/2. With the default max of 5 and min of
+    // 1, that comes out to 3.
+    int32 priority_key = 1;
+}

package/sdk-core/sdk-core-protos/protos/api_upstream/temporal/api/deployment/v1/message.proto

@@ -0,0 +1,252 @@
+// The MIT License
+//
+// Copyright (c) 2020 Temporal Technologies Inc.  All rights reserved.
+//
+// Permission is hereby granted, free of charge, to any person obtaining a copy
+// of this software and associated documentation files (the "Software"), to deal
+// in the Software without restriction, including without limitation the rights
+// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+// copies of the Software, and to permit persons to whom the Software is
+// furnished to do so, subject to the following conditions:
+//
+// The above copyright notice and this permission notice shall be included in
+// all copies or substantial portions of the Software.
+//
+// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+// THE SOFTWARE.
+
+syntax = "proto3";
+
+package temporal.api.deployment.v1;
+
+option go_package = "go.temporal.io/api/deployment/v1;deployment";
+option java_package = "io.temporal.api.deployment.v1";
+option java_multiple_files = true;
+option java_outer_classname = "MessageProto";
+option ruby_package = "Temporalio::Api::Deployment::V1";
+option csharp_namespace = "Temporalio.Api.Deployment.V1";
+
+import "google/protobuf/timestamp.proto";
+
+import "temporal/api/enums/v1/deployment.proto";
+import "temporal/api/enums/v1/task_queue.proto";
+import "temporal/api/common/v1/message.proto";
+
+// Worker Deployment options set in SDK that need to be sent to server in every poll.
+// Experimental. Worker Deployments are experimental and might significantly change in the future.
+message WorkerDeploymentOptions {
+    // Required. Worker Deployment name.
+    string deployment_name = 1;
+    // The Build ID of the worker. Required when `worker_versioning_mode==VERSIONED`, in which case,
+    // the worker will be part of a Deployment Version identified by "<deployment_name>.<build_id>".
+    string build_id = 2;
+    // Required. Versioning Mode for this worker. Must be the same for all workers with the
+    // same `deployment_name` and `build_id` combination, across all Task Queues.
+    // When `worker_versioning_mode==VERSIONED`, the worker will be part of a Deployment Version
+    // identified by "<deployment_name>.<build_id>".
+    temporal.api.enums.v1.WorkerVersioningMode worker_versioning_mode = 3;
+}
+
+// `Deployment` identifies a deployment of Temporal workers. The combination of deployment series
+// name + build ID serves as the identifier. User can use `WorkerDeploymentOptions` in their worker
+// programs to specify these values.
+// Deprecated.
+message Deployment {
+    // Different versions of the same worker service/application are related together by having a
+    // shared series name.
+    // Out of all deployments of a series, one can be designated as the current deployment, which
+    // receives new workflow executions and new tasks of workflows with
+    // `VERSIONING_BEHAVIOR_AUTO_UPGRADE` versioning behavior.
+    string series_name = 1;
+    // Build ID changes with each version of the worker when the worker program code and/or config
+    // changes.
+    string build_id = 2;
+}
+
+// `DeploymentInfo` holds information about a deployment. Deployment information is tracked
+// automatically by server as soon as the first poll from that deployment reaches the server. There
+// can be multiple task queue workers in a single deployment which are listed in this message.
+// Deprecated.
+message DeploymentInfo {
+    Deployment deployment = 1;
+    google.protobuf.Timestamp create_time = 2;
+    repeated TaskQueueInfo task_queue_infos = 3;
+    // A user-defined set of key-values. Can be updated as part of write operations to the
+    // deployment, such as `SetCurrentDeployment`.
+    map<string, temporal.api.common.v1.Payload> metadata = 4;
+    // If this deployment is the current deployment of its deployment series.
+    bool is_current = 5;
+
+    message TaskQueueInfo {
+        string name = 1;
+        temporal.api.enums.v1.TaskQueueType type = 2;
+        // When server saw the first poller for this task queue in this deployment.
+        google.protobuf.Timestamp first_poller_time = 3;
+    }
+}
+
+// Used as part of Deployment write APIs to update metadata attached to a deployment.
+// Deprecated.
+message UpdateDeploymentMetadata {
+    map<string, temporal.api.common.v1.Payload> upsert_entries = 1;
+    // List of keys to remove from the metadata.
+    repeated string remove_entries = 2;
+}
+
+// DeploymentListInfo is an abbreviated set of fields from DeploymentInfo that's returned in
+// ListDeployments.
+// Deprecated.
+message DeploymentListInfo {
+    deployment.v1.Deployment deployment = 1;
+    google.protobuf.Timestamp create_time = 2;
+    // If this deployment is the current deployment of its deployment series.
+    bool is_current = 3;
+}
+
+
+// A Worker Deployment Version (Version, for short) represents all workers of the same 
+// code and config within a Deployment. Workers of the same Version are expected to 
+// behave exactly the same so when executions move between them there are no 
+// non-determinism issues.
+// Worker Deployment Versions are created in Temporal server automatically when 
+// their first poller arrives to the server.
+// Experimental. Worker Deployments are experimental and might significantly change in the future.
+message WorkerDeploymentVersionInfo {
+    // The fully-qualified string representation of the version, in the form "<deployment_name>.<build_id>".
+    string version = 1;
+    string deployment_name = 2;
+    google.protobuf.Timestamp create_time = 3;
+
+    // Last time `current_since_time`, `ramping_since_time, or `ramp_percentage` of this version changed.
+    google.protobuf.Timestamp routing_changed_time = 4;
+
+    // (-- api-linter: core::0140::prepositions=disabled
+    //     aip.dev/not-precedent: 'Since' captures the field semantics despite being a preposition. --)
+    // Nil if not current.
+    google.protobuf.Timestamp current_since_time = 5;
+
+    // (-- api-linter: core::0140::prepositions=disabled
+    //     aip.dev/not-precedent: 'Since' captures the field semantics despite being a preposition. --)
+    // Nil if not ramping. Updated when the version first starts ramping, not on each ramp change.
+    google.protobuf.Timestamp ramping_since_time = 6;
+
+    // Range: [0, 100]. Must be zero if the version is not ramping (i.e. `ramping_since_time` is nil).
+    // Can be in the range [0, 100] if the version is ramping.
+    float ramp_percentage = 7;
+
+    // All the Task Queues that have ever polled from this Deployment version.
+    repeated VersionTaskQueueInfo task_queue_infos = 8;
+    message VersionTaskQueueInfo {
+        string name = 1;
+        temporal.api.enums.v1.TaskQueueType type = 2;
+    }
+
+    // Helps user determine when it is safe to decommission the workers of this
+    // Version. Not present when version is current or ramping.
+    // Current limitations:
+    // - Not supported for Unversioned mode.
+    // - Periodically refreshed, may have delays up to few minutes (consult the
+    //   last_checked_time value).
+    // - Refreshed only when version is not current or ramping AND the status is not
+    //   "drained" yet.
+    // - Once the status is changed to "drained", it is not changed until the Version
+    //   becomes Current or Ramping again, at which time the drainage info is cleared.
+    //   This means if the Version is "drained" but new workflows are sent to it via
+    //   Pinned Versioning Override, the status does not account for those Pinned-override
+    //   executions and remains "drained".
+    VersionDrainageInfo drainage_info = 9;
+
+    // Arbitrary user-provided metadata attached to this version.
+    VersionMetadata metadata = 10;
+}
+
+// Information about workflow drainage to help the user determine when it is safe
+// to decommission a Version. Not present while version is current or ramping.
+// Experimental. Worker Deployments are experimental and might significantly change in the future.
+message VersionDrainageInfo {
+    // Set to DRAINING when the version first stops accepting new executions (is no longer current or ramping).
+    // Set to DRAINED when no more open pinned workflows exist on this version.
+    enums.v1.VersionDrainageStatus status = 1;
+    // Last time the drainage status changed.
+    google.protobuf.Timestamp last_changed_time = 2;
+    // Last time the system checked for drainage of this version.
+    google.protobuf.Timestamp last_checked_time = 3;
+}
+
+// A Worker Deployment (Deployment, for short) represents all workers serving 
+// a shared set of Task Queues. Typically, a Deployment represents one service or 
+// application.
+// A Deployment contains multiple Deployment Versions, each representing a different 
+// version of workers. (see documentation of WorkerDeploymentVersionInfo)
+// Deployment records are created in Temporal server automatically when their
+// first poller arrives to the server.
+// Experimental. Worker Deployments are experimental and might significantly change in the future.
+message WorkerDeploymentInfo {
+    // Identifies a Worker Deployment. Must be unique within the namespace.
+    string name = 1;
+
+    // Deployment Versions that are currently tracked in this Deployment. A DeploymentVersion will be
+    // cleaned up automatically if all the following conditions meet:
+    // - It does not receive new executions (is not current or ramping)
+    // - It has no active pollers (see WorkerDeploymentVersionInfo.pollers_status) 
+    // - It is drained (see WorkerDeploymentVersionInfo.drainage_status) 
+    repeated WorkerDeploymentVersionSummary version_summaries = 2;
+
+    google.protobuf.Timestamp create_time = 3;
+
+    RoutingConfig routing_config = 4;
+
+    // Identity of the last client who modified the configuration of this Deployment. Set to the
+    // `identity` value sent by APIs such as `SetWorkerDeploymentCurrentVersion` and
+    // `SetWorkerDeploymentRampingVersion`.
+    string last_modifier_identity = 5;
+
+    message WorkerDeploymentVersionSummary {
+        // The fully-qualified string representation of the version, in the form "<deployment_name>.<build_id>".
+        string version = 1;
+        google.protobuf.Timestamp create_time = 2;
+        enums.v1.VersionDrainageStatus drainage_status = 3;
+    }
+}
+
+message VersionMetadata {
+    // Arbitrary key-values.
+    map<string, temporal.api.common.v1.Payload> entries = 1;
+}
+
+message RoutingConfig {
+    // Always present. Specifies which Deployment Version should should receive new workflow
+    // executions and tasks of existing unversioned or AutoUpgrade workflows.
+    // Can be one of the following:
+    // - A Deployment Version identifier in the form "<deployment_name>.<build_id>".
+    // - Or, the "__unversioned__" special value, to represent all the unversioned workers (those
+    //   with `UNVERSIONED` (or unspecified) `WorkerVersioningMode`.)
+    // Note: Current Version is overridden by the Ramping Version for a portion of traffic when a ramp
+    // is set (see `ramping_version`.)
+    string current_version = 1;
+    // When present, it means the traffic is being shifted from the Current Version to the Ramping
+    // Version.
+    // Must always be different from Current Version. Can be one of the following:
+    // - A Deployment Version identifier in the form "<deployment_name>.<build_id>".
+    // - Or, the "__unversioned__" special value, to represent all the unversioned workers (those
+    //   with `UNVERSIONED` (or unspecified) `WorkerVersioningMode`.)
+    // Note that it is possible to ramp from one Version to another Version, or from unversioned
+    // workers to a particular Version, or from a particular Version to unversioned workers.
+    string ramping_version = 2;
+    // Percentage of tasks that are routed to the Ramping Version instead of the Current Version.
+    // Valid range: [0, 100]. A 100% value means the Ramping Version is receiving full traffic but
+    // not yet "promoted" to be the Current Version, likely due to pending validations.
+    float ramping_version_percentage = 3;
+    // Last time current version was changed.
+    google.protobuf.Timestamp current_version_changed_time = 4;
+    // Last time ramping version was changed. Not updated if only the ramp percentage changes.
+    google.protobuf.Timestamp ramping_version_changed_time = 5;
+    // Last time ramping version percentage was changed.
+    // If ramping version is changed, this is also updated, even if the percentage stays the same.
+    google.protobuf.Timestamp ramping_version_percentage_changed_time = 6;
+}

package/sdk-core/sdk-core-protos/protos/api_upstream/temporal/api/enums/v1/batch_operation.proto

@@ -38,6 +38,7 @@ enum BatchOperationType {
   BATCH_OPERATION_TYPE_SIGNAL = 3;
   BATCH_OPERATION_TYPE_DELETE = 4;
   BATCH_OPERATION_TYPE_RESET = 5;
+  BATCH_OPERATION_TYPE_UPDATE_EXECUTION_OPTIONS = 6;
 }
 
 enum BatchOperationState {

package/sdk-core/sdk-core-protos/protos/api_upstream/temporal/api/enums/v1/common.proto

@@ -69,6 +69,8 @@ enum CallbackState {
     CALLBACK_STATE_FAILED = 4;
     // Callback has succeeded.
     CALLBACK_STATE_SUCCEEDED = 5;
+    // Callback is blocked (eg: by circuit breaker).
+    CALLBACK_STATE_BLOCKED = 6;
 }
 
 // State of a pending Nexus operation.
@@ -81,6 +83,8 @@ enum PendingNexusOperationState {
     PENDING_NEXUS_OPERATION_STATE_BACKING_OFF = 2;
     // Operation was started and will complete asynchronously.
     PENDING_NEXUS_OPERATION_STATE_STARTED = 3;
+    // Operation is blocked (eg: by circuit breaker).
+    PENDING_NEXUS_OPERATION_STATE_BLOCKED = 4;
 }
 
 // State of a Nexus operation cancellation.
@@ -97,4 +101,6 @@ enum NexusOperationCancellationState {
     NEXUS_OPERATION_CANCELLATION_STATE_FAILED = 4;
     // The associated operation timed out - exceeded the user supplied schedule-to-close timeout.
     NEXUS_OPERATION_CANCELLATION_STATE_TIMED_OUT = 5;
+    // Cancellation request is blocked (eg: by circuit breaker).
+    NEXUS_OPERATION_CANCELLATION_STATE_BLOCKED = 6;
 }

package/sdk-core/sdk-core-protos/protos/api_upstream/temporal/api/enums/v1/deployment.proto

@@ -0,0 +1,96 @@
+// The MIT License
+//
+// Copyright (c) 2020 Temporal Technologies Inc.  All rights reserved.
+//
+// Permission is hereby granted, free of charge, to any person obtaining a copy
+// of this software and associated documentation files (the "Software"), to deal
+// in the Software without restriction, including without limitation the rights
+// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+// copies of the Software, and to permit persons to whom the Software is
+// furnished to do so, subject to the following conditions:
+//
+// The above copyright notice and this permission notice shall be included in
+// all copies or substantial portions of the Software.
+//
+// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+// THE SOFTWARE.
+
+syntax = "proto3";
+
+package temporal.api.enums.v1;
+
+option go_package = "go.temporal.io/api/enums/v1;enums";
+option java_package = "io.temporal.api.enums.v1";
+option java_multiple_files = true;
+option java_outer_classname = "DeploymentProto";
+option ruby_package = "Temporalio::Api::Enums::V1";
+option csharp_namespace = "Temporalio.Api.Enums.V1";
+
+// Specify the reachability level for a deployment so users can decide if it is time to
+// decommission the deployment.
+enum DeploymentReachability {
+    // Reachability level is not specified.
+    DEPLOYMENT_REACHABILITY_UNSPECIFIED = 0;
+    // The deployment is reachable by new and/or open workflows. The deployment cannot be
+    // decommissioned safely.
+    DEPLOYMENT_REACHABILITY_REACHABLE = 1;
+    // The deployment is not reachable by new or open workflows, but might be still needed by
+    // Queries sent to closed workflows. The deployment can be decommissioned safely if user does
+    // not query closed workflows.
+    DEPLOYMENT_REACHABILITY_CLOSED_WORKFLOWS_ONLY = 2;
+    // The deployment is not reachable by any workflow because all the workflows who needed this
+    // deployment went out of retention period. The deployment can be decommissioned safely.
+    DEPLOYMENT_REACHABILITY_UNREACHABLE = 3;
+}
+
+// (-- api-linter: core::0216::synonyms=disabled
+//     aip.dev/not-precedent: Call this status because it is . --)
+// Specify the drainage status for a Worker Deployment Version so users can decide whether they
+// can safely decommission the version.
+// Experimental. Worker Deployments are experimental and might significantly change in the future.
+enum VersionDrainageStatus {
+    // Drainage Status is not specified.
+    VERSION_DRAINAGE_STATUS_UNSPECIFIED = 0;
+    // The Worker Deployment Version is not used by new workflows but is still used by
+    // open pinned workflows. The version cannot be decommissioned safely.
+    VERSION_DRAINAGE_STATUS_DRAINING = 1;
+    // The Worker Deployment Version is not used by new or open workflows, but might be still needed by
+    // Queries sent to closed workflows. The version can be decommissioned safely if user does
+    // not query closed workflows. If the user does query closed workflows for some time x after
+    // workflows are closed, they should decommission the version after it has been drained for that duration.
+    VERSION_DRAINAGE_STATUS_DRAINED = 2;
+}
+
+// Versioning Mode of a worker is set by the app developer in the worker code, and specifies the
+// behavior of the system in the following related aspects:
+// - Whether or not Temporal Server considers this worker's version (Build ID) when dispatching
+//   tasks to it.
+// - Whether or not the workflows processed by this worker are versioned using the worker's version.
+// Experimental. Worker Deployments are experimental and might significantly change in the future.
+enum WorkerVersioningMode {
+    WORKER_VERSIONING_MODE_UNSPECIFIED = 0;
+    // Workers with this mode are not distinguished from each other for task routing, even if they
+    // have different Build IDs.
+    // Workflows processed by this worker will be unversioned and user needs to use Patching to keep
+    // the new code compatible with prior versions.
+    // This mode is recommended to be used along with Rolling Upgrade deployment strategies.
+    // Workers with this mode are represented by the special string `__unversioned__` in the APIs.
+    WORKER_VERSIONING_MODE_UNVERSIONED = 1;
+    // Workers with this mode are part of a Worker Deployment Version which is identified as
+    // "<deployment_name>.<build_id>". Such workers are called "versioned" as opposed to
+    // "unversioned".
+    // Each Deployment Version is distinguished from other Versions for task routing and users can
+    // configure Temporal Server to send tasks to a particular Version (see
+    // `WorkerDeploymentInfo.routing_config`). This mode is the best option for Blue/Green and
+    // Rainbow strategies (but typically not suitable for Rolling upgrades.)
+    // Workflow Versioning Behaviors are enabled in this mode: each workflow type must choose
+    // between the Pinned and AutoUpgrade behaviors. Depending on the chosen behavior, the user may
+    // or may not need to use Patching to keep the new code compatible with prior versions. (see
+    // VersioningBehavior enum.)
+    WORKER_VERSIONING_MODE_VERSIONED = 2;
+}

package/sdk-core/sdk-core-protos/protos/api_upstream/temporal/api/enums/v1/event_type.proto

@@ -185,4 +185,6 @@ enum EventType {
     EVENT_TYPE_NEXUS_OPERATION_TIMED_OUT = 53;
     // A Nexus operation was requested to be canceled using a RequestCancelNexusOperation command.
     EVENT_TYPE_NEXUS_OPERATION_CANCEL_REQUESTED = 54;
+    // Workflow execution options updated by user.
+    EVENT_TYPE_WORKFLOW_EXECUTION_OPTIONS_UPDATED = 55;
 }

package/sdk-core/sdk-core-protos/protos/api_upstream/temporal/api/enums/v1/failed_cause.proto

@@ -141,6 +141,8 @@ enum ResourceExhaustedCause {
     RESOURCE_EXHAUSTED_CAUSE_PERSISTENCE_STORAGE_LIMIT = 7;
     // Circuit breaker is open/half-open.
     RESOURCE_EXHAUSTED_CAUSE_CIRCUIT_BREAKER_OPEN = 8;
+    // Namespace exceeds operations rate limit.
+    RESOURCE_EXHAUSTED_CAUSE_OPS_LIMIT = 9;
 }
 
 enum ResourceExhaustedScope {

package/sdk-core/sdk-core-protos/protos/api_upstream/temporal/api/enums/v1/nexus.proto

@@ -0,0 +1,42 @@
+// The MIT License
+//
+// Copyright (c) 2025 Temporal Technologies Inc. All rights reserved.
+//
+// Permission is hereby granted, free of charge, to any person obtaining a copy
+// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+// copies of the Software, and to permit persons to whom the Software is
+// furnished to do so, subject to the following conditions:
+//
+// The above copyright notice and this permission notice shall be included in
+// all copies or substantial portions of the Software.
+//
+// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+// THE SOFTWARE.
+
+syntax = "proto3";
+
+package temporal.api.enums.v1;
+
+option go_package = "go.temporal.io/api/enums/v1;enums";
+option java_package = "io.temporal.api.enums.v1";
+option java_multiple_files = true;
+option java_outer_classname = "NexusProto";
+option ruby_package = "Temporalio::Api::Enums::V1";
+option csharp_namespace = "Temporalio.Api.Enums.V1";
+
+// NexusHandlerErrorRetryBehavior allows nexus handlers to explicity set the retry behavior of a HandlerError. If not
+// specified, retry behavior is determined from the error type. For example internal errors are not retryable by default
+// unless specified otherwise.
+enum NexusHandlerErrorRetryBehavior {
+    NEXUS_HANDLER_ERROR_RETRY_BEHAVIOR_UNSPECIFIED = 0;
+    // A handler error is explicitly marked as retryable.
+    NEXUS_HANDLER_ERROR_RETRY_BEHAVIOR_RETRYABLE = 1;
+    // A handler error is explicitly marked as non-retryable.
+    NEXUS_HANDLER_ERROR_RETRY_BEHAVIOR_NON_RETRYABLE = 2;
+}
+

package/sdk-core/sdk-core-protos/protos/api_upstream/temporal/api/enums/v1/reset.proto

@@ -40,6 +40,8 @@ enum ResetReapplyExcludeType {
     RESET_REAPPLY_EXCLUDE_TYPE_UPDATE = 2;
     // Exclude nexus events when reapplying events beyond the reset point.
     RESET_REAPPLY_EXCLUDE_TYPE_NEXUS = 3;
+    // Deprecated, unimplemented option.
+    RESET_REAPPLY_EXCLUDE_TYPE_CANCEL_REQUEST = 4 [deprecated=true];
 }
 
 // Event types to include when reapplying events. Deprecated: applications

package/sdk-core/sdk-core-protos/protos/api_upstream/temporal/api/enums/v1/workflow.proto

@@ -32,7 +32,7 @@ option ruby_package = "Temporalio::Api::Enums::V1";
 option csharp_namespace = "Temporalio.Api.Enums.V1";
 
 // Defines whether to allow re-using a workflow id from a previously *closed* workflow.
-// If the request is denied, a `WorkflowExecutionAlreadyStartedFailure` is returned.
+// If the request is denied, the server returns a `WorkflowExecutionAlreadyStartedFailure` error.
 //
 // See `WorkflowIdConflictPolicy` for handling workflow id duplication with a *running* workflow.
 enum WorkflowIdReusePolicy {
@@ -137,4 +137,45 @@ enum TimeoutType {
     TIMEOUT_TYPE_SCHEDULE_TO_START = 2;
     TIMEOUT_TYPE_SCHEDULE_TO_CLOSE = 3;
     TIMEOUT_TYPE_HEARTBEAT = 4;
-}
+}
+
+// Versioning Behavior specifies if and how a workflow execution moves between Worker Deployment
+// Versions. The Versioning Behavior of a workflow execution is typically specified by the worker
+// who completes the first task of the execution, but is also overridable manually for new and
+// existing workflows (see VersioningOverride).
+// Experimental. Worker Deployments are experimental and might significantly change in the future.
+enum VersioningBehavior {
+    // Workflow execution does not have a Versioning Behavior and is called Unversioned. This is the
+    // legacy behavior. An Unversioned workflow's task can go to any Unversioned worker (see
+    // `WorkerVersioningMode`.)
+    // User needs to use Patching to keep the new code compatible with prior versions when dealing
+    // with Unversioned workflows.
+    VERSIONING_BEHAVIOR_UNSPECIFIED = 0;
+    // Workflow will start on the Current Deployment Version of its Task Queue, and then
+    // will be pinned to that same Deployment Version until completion (the Version that
+    // this Workflow is pinned to is specified in `versioning_info.version`).
+    // This behavior eliminates most of compatibility concerns users face when changing their code.
+    // Patching is not needed when pinned workflows code change.
+    // Can be overridden explicitly via `UpdateWorkflowExecutionOptions` API to move the
+    // execution to another Deployment Version.
+    // Activities of `PINNED` workflows are sent to the same Deployment Version. Exception to this
+    // would be when the activity Task Queue workers are not present in the workflow's Deployment
+    // Version, in which case the activity will be sent to the Current Deployment Version of its own
+    // task queue.
+    VERSIONING_BEHAVIOR_PINNED = 1;
+    // Workflow will automatically move to the Current Deployment Version of its Task Queue when the
+    // next workflow task is dispatched.
+    // AutoUpgrade behavior is suitable for long-running workflows as it allows them to move to the
+    // latest Deployment Version, but the user still needs to use Patching to keep the new code
+    // compatible with prior versions for changed workflow types.
+    // Activities of `AUTO_UPGRADE` workflows are sent to the Deployment Version of the workflow
+    // execution (as specified in versioning_info.version based on the last completed
+    // workflow task). Exception to this would be when the activity Task Queue workers are not
+    // present in the workflow's Deployment Version, in which case, the activity will be sent to a
+    // different Deployment Version according to the Current Deployment Version of its own task
+    // queue.
+    // Workflows stuck on a backlogged activity will still auto-upgrade if the Current Deployment
+    // Version of their Task Queue changes, without having to wait for the backlogged activity to
+    // complete on the old Version.
+    VERSIONING_BEHAVIOR_AUTO_UPGRADE = 2;
+}