@temporalio/core-bridge 1.11.8 → 1.12.0

package/sdk-core/sdk-core-protos/protos/api_upstream/temporal/api/workflowservice/v1/request_response.proto

@@ -1,25 +1,3 @@
-// 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.workflowservice.v1;
@@ -53,6 +31,7 @@ import "temporal/api/protocol/v1/message.proto";
 import "temporal/api/namespace/v1/message.proto";
 import "temporal/api/query/v1/message.proto";
 import "temporal/api/replication/v1/message.proto";
+import "temporal/api/rules/v1/message.proto";
 import "temporal/api/schedule/v1/message.proto";
 import "temporal/api/taskqueue/v1/message.proto";
 import "temporal/api/update/v1/message.proto";
@@ -220,10 +199,15 @@ message StartWorkflowExecutionResponse {
     string run_id = 1;
     // If true, a new workflow was started.
     bool started = 3;
+    // Current execution status of the workflow. Typically remains WORKFLOW_EXECUTION_STATUS_RUNNING
+    // unless a de-dupe occurs or in specific scenarios handled within the ExecuteMultiOperation (refer to its docs).
+    temporal.api.enums.v1.WorkflowExecutionStatus status = 5;
     // When `request_eager_execution` is set on the `StartWorkflowExecutionRequest`, the server - if supported - will
     // return the first workflow task to be eagerly executed.
     // The caller is expected to have a worker available to process the task.
     PollWorkflowTaskQueueResponse eager_workflow_task = 2;
+    // Link to the workflow event.
+    temporal.api.common.v1.Link link = 4;
 }
 
 message GetWorkflowExecutionHistoryRequest {
@@ -270,10 +254,10 @@ message PollWorkflowTaskQueueRequest {
     temporal.api.taskqueue.v1.TaskQueue task_queue = 2;
     // The identity of the worker/client who is polling this task queue
     string identity = 3;
-    // DEPRECATED since 1.21 - use `worker_version_capabilities` instead.
+    // DEPRECATED since 1.21 - use `deployment_options` instead.
     // Each worker process should provide an ID unique to the specific set of code it is running
     // "checksum" in this field name isn't very accurate, it should be though of as an id.
-    string binary_checksum = 4;
+    string binary_checksum = 4 [deprecated = true];
     // Information about this worker's build identifier and if it is choosing to use the versioning
     // feature. See the `WorkerVersionCapabilities` docstring for more.
     // Deprecated. Replaced by deployment_options.
@@ -355,16 +339,16 @@ message RespondWorkflowTaskCompletedRequest {
     // something useful, but cannot complete it within the workflow task timeout. Local activities
     // which run for longer than the task timeout being the prime example.
     bool force_create_new_workflow_task = 6;
-    // DEPRECATED since 1.21 - use `worker_version_stamp` instead.
+    // DEPRECATED since 1.21 - use `deployment_options` instead.
     // Worker process' unique binary id
-    string binary_checksum = 7;
+    string binary_checksum = 7 [deprecated = true];
     // Responses to the `queries` field in the task being responded to
     map<string, temporal.api.query.v1.WorkflowQueryResult> query_results = 8;
     string namespace = 9;
     // Version info of the worker who processed this task. This message's `build_id` field should
     // always be set by SDKs. Workers opting into versioning will also set the `use_versioning`
     // field to true. See message docstrings for more.
-    // Deprecated. Use `deployment` and `versioning_behavior` instead.
+    // Deprecated. Use `deployment_options` and `versioning_behavior` instead.
     temporal.api.common.v1.WorkerVersionStamp worker_version_stamp = 10 [deprecated = true];
     // Protocol messages piggybacking on a WFT as a transport
     repeated temporal.api.protocol.v1.Message messages = 11;
@@ -418,21 +402,21 @@ message RespondWorkflowTaskFailedRequest {
     temporal.api.failure.v1.Failure failure = 3;
     // The identity of the worker/client
     string identity = 4;
-    // DEPRECATED since 1.21 - use `worker_version_stamp` instead.
+    // DEPRECATED since 1.21 - use `deployment_options` instead.
     // Worker process' unique binary id
-    string binary_checksum = 5;
+    string binary_checksum = 5 [deprecated = true];
     string namespace = 6;
     // Protocol messages piggybacking on a WFT as a transport
     repeated temporal.api.protocol.v1.Message messages = 7;
     // Version info of the worker who processed this task. This message's `build_id` field should
     // always be set by SDKs. Workers opting into versioning will also set the `use_versioning`
     // field to true. See message docstrings for more.
-    // Deprecated. Use `deployment` instead.
+    // Deprecated. Use `deployment_options` instead.
     temporal.api.common.v1.WorkerVersionStamp worker_version = 8 [deprecated = true];
     // Deployment info of the worker that completed this task. Must be present if user has set
     // `WorkerDeploymentOptions` regardless of versioning being enabled or not.
     // Deprecated. Replaced with `deployment_options`.
-    temporal.api.deployment.v1.Deployment deployment = 9;
+    temporal.api.deployment.v1.Deployment deployment = 9 [deprecated = true];
     // Worker deployment options that user has set in the worker.
     temporal.api.deployment.v1.WorkerDeploymentOptions deployment_options = 10;
 }
@@ -523,6 +507,10 @@ message RecordActivityTaskHeartbeatResponse {
 
     // Will be set to true if the activity is paused.
     bool activity_paused = 2;
+
+    // Will be set to true if the activity was reset.
+    // Applies only to the current run.
+    bool activity_reset = 3;
 }
 
 message RecordActivityTaskHeartbeatByIdRequest {
@@ -547,6 +535,10 @@ message RecordActivityTaskHeartbeatByIdResponse {
 
     // Will be set to true if the activity is paused.
     bool activity_paused = 2;
+
+    // Will be set to true if the activity was reset.
+    // Applies only to the current run.
+    bool activity_reset = 3;
 }
 
 message RespondActivityTaskCompletedRequest {
@@ -560,7 +552,7 @@ message RespondActivityTaskCompletedRequest {
     // Version info of the worker who processed this task. This message's `build_id` field should
     // always be set by SDKs. Workers opting into versioning will also set the `use_versioning`
     // field to true. See message docstrings for more.
-    // Deprecated. Use `deployment` instead.
+    // Deprecated. Use `deployment_options` instead.
     temporal.api.common.v1.WorkerVersionStamp worker_version = 5 [deprecated = true];
     // Deployment info of the worker that completed this task. Must be present if user has set
     // `WorkerDeploymentOptions` regardless of versioning being enabled or not.
@@ -604,7 +596,7 @@ message RespondActivityTaskFailedRequest {
     // Version info of the worker who processed this task. This message's `build_id` field should
     // always be set by SDKs. Workers opting into versioning will also set the `use_versioning`
     // field to true. See message docstrings for more.
-    // Deprecated. Use `deployment` instead.
+    // Deprecated. Use `deployment_options` instead.
     temporal.api.common.v1.WorkerVersionStamp worker_version = 6 [deprecated = true];
     // Deployment info of the worker that completed this task. Must be present if user has set
     // `WorkerDeploymentOptions` regardless of versioning being enabled or not.
@@ -654,7 +646,7 @@ message RespondActivityTaskCanceledRequest {
     // Version info of the worker who processed this task. This message's `build_id` field should
     // always be set by SDKs. Workers opting into versioning will also set the `use_versioning`
     // field to true. See message docstrings for more.
-    // Deprecated. Use `deployment` instead.
+    // Deprecated. Use `deployment_options` instead.
     temporal.api.common.v1.WorkerVersionStamp worker_version = 5 [deprecated = true];
     // Deployment info of the worker that completed this task. Must be present if user has set
     // `WorkerDeploymentOptions` regardless of versioning being enabled or not.
@@ -680,6 +672,8 @@ message RespondActivityTaskCanceledByIdRequest {
     temporal.api.common.v1.Payloads details = 5;
     // The identity of the worker/client
     string identity = 6;
+    // Worker deployment options that user has set in the worker.
+    temporal.api.deployment.v1.WorkerDeploymentOptions deployment_options = 7;
 }
 
 message RespondActivityTaskCanceledByIdResponse {
@@ -705,6 +699,9 @@ message RequestCancelWorkflowExecutionRequest {
 message RequestCancelWorkflowExecutionResponse {
 }
 
+// Keep the parameters in sync with:
+//   - temporal.api.batch.v1.BatchOperationSignal.
+//   - temporal.api.workflow.v1.PostResetOperation.SignalWorkflow.
 message SignalWorkflowExecutionRequest {
     string namespace = 1;
     temporal.api.common.v1.WorkflowExecution workflow_execution = 2;
@@ -817,6 +814,10 @@ message ResetWorkflowExecutionRequest {
     temporal.api.enums.v1.ResetReapplyType reset_reapply_type = 6;
     // Event types not to be reapplied
     repeated temporal.api.enums.v1.ResetReapplyExcludeType reset_reapply_exclude_types = 7;
+    // Operations to perform after the workflow has been reset. These operations will be applied
+    // to the *new* run of the workflow execution in the order they are provided.
+    // All operations are applied to the workflow before the first new workflow task is generated
+    repeated temporal.api.workflow.v1.PostResetOperation post_reset_operations = 8;
 }
 
 message ResetWorkflowExecutionResponse {
@@ -1802,6 +1803,12 @@ message ExecuteMultiOperationRequest {
     }
 }
 
+// IMPORTANT: For [StartWorkflow, UpdateWorkflow] combination ("Update-with-Start") when both
+//   1. the workflow update for the requested update ID has already completed, and
+//   2. the workflow for the requested workflow ID has already been closed,
+// then you'll receive
+//   - an update response containing the update's outcome, and
+//   - a start response with a `status` field that reflects the workflow's current state.
 message ExecuteMultiOperationResponse {
     repeated Response responses = 1;
 
@@ -1828,13 +1835,13 @@ message UpdateActivityOptionsRequest {
     // Controls which fields from `activity_options` will be applied
     google.protobuf.FieldMask update_mask = 5;
 
-    // either activity id or activity type must be provided
-    oneof activity {
-        // Only activity with this ID will be updated.
-        string id = 6;
-        // Update all running activities of this type.
-        string type = 7;
-    }
+        // either activity id or activity type must be provided
+        oneof activity {
+            // Only activity with this ID will be updated.
+            string id = 6;
+            // Update all running activities of this type.
+            string type = 7;
+        }
 }
 
 message UpdateActivityOptionsResponse {
@@ -1859,6 +1866,8 @@ message PauseActivityRequest {
         string type = 5;
     }
 
+    // Reason to pause the activity.
+    string reason = 6;
 }
 
 message PauseActivityResponse {
@@ -1928,6 +1937,9 @@ message ResetActivityRequest {
 message ResetActivityResponse {
 }
 
+// Keep the parameters in sync with:
+//   - temporal.api.batch.v1.BatchOperationUpdateWorkflowExecutionOptions.
+//   - temporal.api.workflow.v1.PostResetOperation.UpdateWorkflowOptions.
 message UpdateWorkflowExecutionOptionsRequest {
     // The namespace name of the target Workflow.
     string namespace = 1;
@@ -1960,9 +1972,11 @@ message DescribeDeploymentResponse {
 }
 
 message DescribeWorkerDeploymentVersionRequest {
-	string namespace = 1;
-  // Deployment Version identifier in the form "<deployment_name>.<build_id>".
-  string version = 2;
+    string namespace = 1;
+    // Deprecated. Use `deployment_version`.
+    string version = 2 [deprecated = true];
+    // Required.
+    temporal.api.deployment.v1.WorkerDeploymentVersion deployment_version = 3;
 }
 
 message DescribeWorkerDeploymentVersionResponse {
@@ -2019,11 +2033,14 @@ message SetCurrentDeploymentResponse {
 message SetWorkerDeploymentCurrentVersionRequest {
     string namespace = 1;
     string deployment_name = 2;
-    // Required. 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`.)
-    string version = 3;
+    // Deprecated. Use `build_id`.
+    string version = 3 [deprecated = true];
+
+    // The build id of the Version that you want to set as Current.
+    // Pass an empty value to set the Current Version to nil.
+    // A nil Current Version represents all the unversioned workers (those with `UNVERSIONED` (or unspecified) `WorkerVersioningMode`.)
+    string build_id = 7;
+
     // Optional. This can be the value of conflict_token from a Describe, or another Worker
     // Deployment API. Passing a non-nil conflict token will cause this request to fail if the
     // Deployment's configuration has been modified between the API call that generated the
@@ -2052,21 +2069,24 @@ message SetWorkerDeploymentCurrentVersionResponse {
     // that write to the Worker Deployment state to ensure that the state
     // did not change between this API call and a future write.
     bytes conflict_token = 1;
-    // The version that was current before executing this operation, in the form
-    // "<deployment_name>.<build_id>". Can also be the `__unversioned__` special value.
-    string previous_version = 2;
+    // Deprecated. Use `previous_deployment_version`.
+    string previous_version = 2 [deprecated = true];
+    // The version that was current before executing this operation.
+    temporal.api.deployment.v1.WorkerDeploymentVersion previous_deployment_version = 3;
 }
 
 // Set/unset the Ramping Version of a Worker Deployment and its ramp percentage.
 message SetWorkerDeploymentRampingVersionRequest {
     string namespace = 1;
     string deployment_name = 2;
-    // Can be one of the following:
-    // - Absent/empty value to unset the Ramping Version. Must be paired with `percentage=0`.
-    // - 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`.)
-    string version = 3;
+    // Deprecated. Use `build_id`.
+    string version = 3 [deprecated = true];
+
+    // The build id of the Version that you want to ramp traffic to.
+    // Pass an empty value to set the Ramping Version to nil.
+    // A nil Ramping Version represents all the unversioned workers (those with `UNVERSIONED` (or unspecified) `WorkerVersioningMode`.)
+    string build_id = 8;
+
     // Ramp percentage to set. Valid range: [0,100].
     float percentage = 4;
 
@@ -2101,9 +2121,10 @@ message SetWorkerDeploymentRampingVersionResponse {
     // that write to the Worker Deployment state to ensure that the state
     // did not change between this API call and a future write.
     bytes conflict_token = 1;
-    // The version that was ramping before executing this operation, in the form
-    // "<deployment_name>.<build_id>". Can also be the `__unversioned__` special value.
-    string previous_version = 2;
+    // Deprecated. Use `previous_deployment_version`.
+    string previous_version = 2 [deprecated = true];
+    // The version that was ramping before executing this operation.
+    temporal.api.deployment.v1.WorkerDeploymentVersion previous_deployment_version = 4;
     // The ramping version percentage before executing this operation.
     float previous_percentage = 3;
 }
@@ -2136,8 +2157,10 @@ message ListWorkerDeploymentsResponse {
 //    can be skipped by passing `skip-drainage=true`.
 message DeleteWorkerDeploymentVersionRequest {
     string namespace = 1;
-    // Deployment Version identifier in the form "<deployment_name>.<build_id>".
-    string version = 2;
+    // Deprecated. Use `deployment_version`.
+    string version = 2 [deprecated = true];
+    // Required.
+    temporal.api.deployment.v1.WorkerDeploymentVersion deployment_version = 5;
     // Pass to force deletion even if the Version is draining. In this case the open pinned
     // workflows will be stuck until manually moved to another version by UpdateWorkflowExecutionOptions.
     bool skip_drainage = 3;
@@ -2163,8 +2186,10 @@ message DeleteWorkerDeploymentResponse {
 // Used to update the user-defined metadata of a Worker Deployment Version.
 message UpdateWorkerDeploymentVersionMetadataRequest {
     string namespace = 1;
-    // Deployment Version identifier in the form "<deployment_name>.<build_id>".
-    string version = 2;
+    // Deprecated. Use `deployment_version`.
+    string version = 2 [deprecated = true];
+    // Required.
+    temporal.api.deployment.v1.WorkerDeploymentVersion deployment_version = 5;
     map<string, temporal.api.common.v1.Payload> upsert_entries = 3;
     // List of keys to remove from the metadata.
     repeated string remove_entries = 4;
@@ -2201,3 +2226,85 @@ message GetDeploymentReachabilityResponse {
     // was actually calculated.
     google.protobuf.Timestamp last_update_time = 3;
 }
+
+message CreateWorkflowRuleRequest {
+    string namespace = 1;
+
+    // The rule specification .
+    temporal.api.rules.v1.WorkflowRuleSpec spec = 2;
+
+    // If true, the rule will be applied to the currently running workflows via batch job.
+    // If not set , the rule will only be applied when triggering condition is satisfied.
+    // visibility_query in the rule will be used to select the workflows to apply the rule to.
+    bool force_scan = 3;
+
+    // Used to de-dupe requests. Typically should be UUID.
+    string request_id = 4;
+
+    // Identity of the actor who created the rule. Will be stored with the rule.
+    string identity = 5;
+
+    // Rule description.Will be stored with the rule.
+    string description = 6;
+}
+
+message CreateWorkflowRuleResponse {
+    // Created rule.
+    temporal.api.rules.v1.WorkflowRule  rule = 1;
+
+    // Batch Job ID if force-scan flag was provided. Otherwise empty.
+    string job_id = 2;
+}
+
+message DescribeWorkflowRuleRequest {
+    string namespace = 1;
+    // User-specified ID of the rule to read. Unique within the namespace.
+    string rule_id = 2;
+}
+
+message DescribeWorkflowRuleResponse {
+    // The rule that was read.
+    temporal.api.rules.v1.WorkflowRule rule = 1;
+}
+
+message DeleteWorkflowRuleRequest {
+    string namespace = 1;
+
+    // ID of the rule to delete. Unique within the namespace.
+    string rule_id = 2;
+}
+
+message DeleteWorkflowRuleResponse {
+}
+
+message ListWorkflowRulesRequest {
+    string namespace = 1;
+    bytes next_page_token = 2;
+}
+
+message ListWorkflowRulesResponse {
+    repeated temporal.api.rules.v1.WorkflowRule rules = 1;
+    bytes next_page_token = 2;
+}
+
+message TriggerWorkflowRuleRequest {
+    string namespace = 1;
+
+    // Execution info of the workflow which scheduled this activity
+    temporal.api.common.v1.WorkflowExecution execution = 2;
+
+    // Either provide id of existing rule, or rule specification
+    oneof rule {
+        string id = 4;
+        // Note: Rule ID and expiration date are not used in the trigger request.
+        temporal.api.rules.v1.WorkflowRuleSpec spec = 5;
+    }
+
+    // The identity of the client who initiated this request
+    string identity = 3;
+}
+
+message TriggerWorkflowRuleResponse {
+    // True is the rule was applied, based on the rule conditions (predicate/visibility_query).
+    bool applied = 1;
+}

package/sdk-core/sdk-core-protos/protos/api_upstream/temporal/api/workflowservice/v1/service.proto

@@ -1,25 +1,3 @@
-// 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.workflowservice.v1;
@@ -789,9 +767,9 @@ service WorkflowService {
     // Experimental. This API might significantly change or be removed in a future release.
     rpc DescribeWorkerDeploymentVersion (DescribeWorkerDeploymentVersionRequest) returns (DescribeWorkerDeploymentVersionResponse) {
         option (google.api.http) = {
-            get: "/namespaces/{namespace}/worker-deployment-versions/{version}"
+            get: "/namespaces/{namespace}/worker-deployment-versions/{deployment_version.deployment_name}/{deployment_version.build_id}"
             additional_bindings {
-                get: "/api/v1/namespaces/{namespace}/worker-deployment-versions/{version}"
+                get: "/api/v1/namespaces/{namespace}/worker-deployment-versions/{deployment_version.deployment_name}/{deployment_version.build_id}"
             }
         };
     }
@@ -900,9 +878,9 @@ service WorkflowService {
     // Experimental. This API might significantly change or be removed in a future release.
     rpc DeleteWorkerDeploymentVersion (DeleteWorkerDeploymentVersionRequest) returns (DeleteWorkerDeploymentVersionResponse) {
         option (google.api.http) = {
-            delete: "/namespaces/{namespace}/worker-deployment-versions/{version}"
+            delete: "/namespaces/{namespace}/worker-deployment-versions/{deployment_version.deployment_name}/{deployment_version.build_id}"
             additional_bindings {
-                delete: "/api/v1/namespaces/{namespace}/worker-deployment-versions/{version}"
+                delete: "/api/v1/namespaces/{namespace}/worker-deployment-versions/{deployment_version.deployment_name}/{deployment_version.build_id}"
             }
         };
     }
@@ -936,10 +914,10 @@ service WorkflowService {
     // Experimental. This API might significantly change or be removed in a future release.
     rpc UpdateWorkerDeploymentVersionMetadata (UpdateWorkerDeploymentVersionMetadataRequest) returns (UpdateWorkerDeploymentVersionMetadataResponse) {
         option (google.api.http) = {
-            post: "/namespaces/{namespace}/worker-deployment-versions/{version}/update-metadata"
+            post: "/namespaces/{namespace}/worker-deployment-versions/{deployment_version.deployment_name}/{deployment_version.build_id}/update-metadata"
             body: "*"
             additional_bindings {
-                post: "/api/v1/namespaces/{namespace}/worker-deployment-versions/{version}/update-metadata"
+                post: "/api/v1/namespaces/{namespace}/worker-deployment-versions/{deployment_version.deployment_name}/{deployment_version.build_id}/update-metadata"
                 body: "*"
             }
         };
@@ -1132,4 +1110,67 @@ service WorkflowService {
             }
         };
     }
+
+    // Create a new workflow rule. The rules are used to control the workflow execution.
+    // The rule will be applied to all running and new workflows in the namespace.
+    // If the rule with such ID already exist this call will fail
+    // Note: the rules are part of namespace configuration and will be stored in the namespace config.
+    // Namespace config is eventually consistent.
+    rpc CreateWorkflowRule (CreateWorkflowRuleRequest) returns (CreateWorkflowRuleResponse) {
+        option (google.api.http) = {
+            post: "/namespaces/{namespace}/workflow-rules"
+            body: "*"
+            additional_bindings {
+                post: "/api/v1/namespaces/{namespace}/workflow-rules"
+                body: "*"
+            }
+        };
+    }
+
+    // DescribeWorkflowRule return the rule specification for existing rule id.
+    // If there is no rule with such id - NOT FOUND error will be returned.
+    rpc DescribeWorkflowRule (DescribeWorkflowRuleRequest) returns (DescribeWorkflowRuleResponse) {
+        option (google.api.http) = {
+            get: "/namespaces/{namespace}/workflow-rules/{rule_id}"
+            additional_bindings {
+                get: "/api/v1/namespaces/{namespace}/workflow-rules/{rule_id}"
+            }
+        };
+    }
+
+    // Delete rule by rule id
+    rpc DeleteWorkflowRule (DeleteWorkflowRuleRequest) returns (DeleteWorkflowRuleResponse) {
+        option (google.api.http) = {
+            delete: "/namespaces/{namespace}/workflow-rules/{rule_id}"
+            additional_bindings {
+                delete: "/api/v1/namespaces/{namespace}/workflow-rules/{rule_id}"
+            }
+        };
+    }
+
+    // Return all namespace workflow rules
+    rpc ListWorkflowRules (ListWorkflowRulesRequest) returns (ListWorkflowRulesResponse) {
+        option (google.api.http) = {
+            get: "/namespaces/{namespace}/workflow-rules"
+            additional_bindings {
+                get: "/api/v1/namespaces/{namespace}/workflow-rules"
+            }
+        };
+    }
+
+    // TriggerWorkflowRule allows to:
+    //  * trigger existing rule for a specific workflow execution;
+    //  * trigger rule for a specific workflow execution without creating a rule;
+    // This is useful for one-off operations.
+    rpc TriggerWorkflowRule (TriggerWorkflowRuleRequest) returns (TriggerWorkflowRuleResponse) {
+        option (google.api.http) = {
+            post: "/namespaces/{namespace}/workflows/{execution.workflow_id}/trigger-rule"
+            body: "*"
+            additional_bindings {
+                post: "/api/v1/namespaces/{namespace}/workflows/{execution.workflow_id}/trigger-rule"
+                body: "*"
+            }
+        };
+    }
+
 }

package/sdk-core/sdk-core-protos/protos/local/temporal/sdk/core/activity_task/activity_task.proto

@@ -57,6 +57,8 @@ message Start {
     // (or not) during activity scheduling as the service can override the provided one in case its
     // values are not specified or exceed configured system limits.
     temporal.api.common.v1.RetryPolicy retry_policy = 16;
+    // Priority of this activity. Local activities will always have this field set to the default.
+    temporal.api.common.v1.Priority priority = 18;
 
     // Set to true if this is a local activity. Note that heartbeating does not apply to local
     // activities.
@@ -65,7 +67,19 @@ message Start {
 
 // Attempt to cancel a running activity
 message Cancel {
+    // Primary cancellation reason
     ActivityCancelReason reason = 1;
+    // Activity cancellation details, surfaces all cancellation reasons.
+    ActivityCancellationDetails details = 2;
+}
+
+message ActivityCancellationDetails {
+    bool is_not_found = 1;
+    bool is_cancelled = 2;
+    bool is_paused = 3;
+    bool is_timed_out = 4;
+    bool is_worker_shutdown = 5;
+    bool is_reset = 6;
 }
 
 enum ActivityCancelReason {
@@ -77,6 +91,10 @@ enum ActivityCancelReason {
     TIMED_OUT = 2;
     // Core is shutting down and the graceful timeout has elapsed
     WORKER_SHUTDOWN = 3;
+    // Activity was paused
+    PAUSED = 4;
+    // Activity was reset
+    RESET = 5;
 }
 
 

package/sdk-core/sdk-core-protos/protos/local/temporal/sdk/core/common/common.proto

@@ -29,4 +29,9 @@ enum VersioningIntent {
     // Indicates that the command should run on the target task queue's current overall-default
     // build ID.
     DEFAULT = 2;
+}
+
+message WorkerDeploymentVersion {
+    string deployment_name = 1;
+    string build_id = 2;
 }

package/sdk-core/sdk-core-protos/protos/local/temporal/sdk/core/nexus/nexus.proto

@@ -68,4 +68,19 @@ enum NexusTaskCancelReason {
     TIMED_OUT = 0;
     // The worker is shutting down
     WORKER_SHUTDOWN = 1;
-}
+}
+
+// Controls at which point to report back to lang when a nexus operation is cancelled
+enum NexusOperationCancellationType {
+    // Wait for operation cancellation completion. Default.
+    WAIT_CANCELLATION_COMPLETED = 0;
+    // Do not request cancellation of the nexus operation if already scheduled
+    ABANDON = 1;
+
+    // Initiate a cancellation request for the Nexus operation and immediately report cancellation
+    // to the caller. Note that it doesn't guarantee that cancellation is delivered to the operation if calling workflow exits before the delivery is done.
+    // If you want to ensure that cancellation is delivered to the operation, use WAIT_CANCELLATION_REQUESTED.
+    TRY_CANCEL = 2;
+    // Request cancellation of the operation and wait for confirmation that the request was received.
+    WAIT_CANCELLATION_REQUESTED = 3;
+}