@temporalio/core-bridge 1.1.0 → 1.4.0

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

@@ -0,0 +1,46 @@
+// The MIT License
+//
+// Copyright (c) 2022 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 = "BatchOperationProto";
+option ruby_package = "Temporal::Api::Enums::V1";
+option csharp_namespace = "Temporal.Api.Enums.V1";
+
+enum BatchOperationType {
+  BATCH_OPERATION_TYPE_UNSPECIFIED = 0;
+  BATCH_OPERATION_TYPE_TERMINATE = 1;
+  BATCH_OPERATION_TYPE_CANCEL = 2;
+  BATCH_OPERATION_TYPE_SIGNAL = 3;
+}
+
+enum BatchOperationState {
+  BATCH_OPERATION_STATE_UNSPECIFIED = 0;
+  BATCH_OPERATION_STATE_RUNNING = 1;
+  BATCH_OPERATION_STATE_COMPLETED = 2;
+  BATCH_OPERATION_STATE_FAILED = 3;
+}

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

@@ -47,4 +47,11 @@ enum CommandType {
     COMMAND_TYPE_START_CHILD_WORKFLOW_EXECUTION = 11;
     COMMAND_TYPE_SIGNAL_EXTERNAL_WORKFLOW_EXECUTION = 12;
     COMMAND_TYPE_UPSERT_WORKFLOW_SEARCH_ATTRIBUTES = 13;
+
+    // Indicates that an update has been accepted for processing workflow code
+    COMMAND_TYPE_ACCEPT_WORKFLOW_UPDATE = 14;
+
+    // Indicates that an update has completed and carries either the success or
+    // failure outcome of said update.
+    COMMAND_TYPE_COMPLETE_WORKFLOW_UPDATE = 15;
 }

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

@@ -151,4 +151,18 @@ enum EventType {
     EVENT_TYPE_EXTERNAL_WORKFLOW_EXECUTION_SIGNALED = 39;
     // Workflow search attributes should be updated and synchronized with the visibility store
     EVENT_TYPE_UPSERT_WORKFLOW_SEARCH_ATTRIBUTES = 40;
+    // Workflow update request has been received
+    EVENT_TYPE_WORKFLOW_UPDATE_REQUESTED = 41;
+    // Workflow update request has been accepted by user workflow code
+    EVENT_TYPE_WORKFLOW_UPDATE_ACCEPTED = 42;
+    // Workflow update has been completed
+    EVENT_TYPE_WORKFLOW_UPDATE_COMPLETED = 43;
+    // Some property or properties of the workflow as a whole have changed by non-workflow code.
+    // The distinction of external vs. command-based modification is important so the SDK can
+    // maintain determinism when using the command-based approach.
+    EVENT_TYPE_WORKFLOW_PROPERTIES_MODIFIED_EXTERNALLY = 44;
+    // Some property or properties of an already-scheduled activity have changed by non-workflow code.
+    // The distinction of external vs. command-based modification is important so the SDK can
+    // maintain determinism when using the command-based approach.
+    EVENT_TYPE_ACTIVITY_PROPERTIES_MODIFIED_EXTERNALLY = 45;
 }

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

@@ -0,0 +1,51 @@
+// 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 = "UpdateProto";
+option ruby_package = "Temporal::Api::Enums::V1";
+option csharp_namespace = "Temporal.Api.Enums.V1";
+
+enum WorkflowUpdateResultAccessStyle {
+    WORKFLOW_UPDATE_RESULT_ACCESS_STYLE_UNSPECIFIED = 0;
+
+    // Indicates that the update response _must_ be included as part of the gRPC
+    // response body
+    WORKFLOW_UPDATE_RESULT_ACCESS_STYLE_REQUIRE_INLINE = 1;
+}
+
+enum WorkflowUpdateDurabilityPreference {
+    // The workflow expresses no preference as to the durability of the
+    // the associated update.
+    WORKFLOW_UPDATE_DURABILITY_PREFERENCE_UNSPECIFIED = 0;
+
+    // Used by a workflow to indicate that no workflow state mutation occurred
+    // while processing the update and that it wishes that the update not be
+    // made durable (and thus not take up space in workflow history).
+    WORKFLOW_UPDATE_DURABILITY_PREFERENCE_BYPASS = 1;
+}

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

@@ -80,8 +80,26 @@ message ChildWorkflowExecutionFailureInfo {
 
 message Failure {
     string message = 1;
+    // The source this Failure originated in, e.g. TypeScriptSDK / JavaSDK
+    // In some SDKs this is used to rehydrate the stack trace into an exception object.
     string source = 2;
     string stack_trace = 3;
+    // Alternative way to supply `message` and `stack_trace` and possibly other attributes, used for encryption of
+    // errors originating in user code which might contain sensitive information.
+    // The `encoded_attributes` Payload could represent any serializable object, e.g. JSON object or a `Failure` proto
+    // message.
+    //
+    // SDK authors: 
+    // - The SDK should provide a default `encodeFailureAttributes` and `decodeFailureAttributes` implementation that:
+    //   - Uses a JSON object to represent `{ message, stack_trace }`.
+    //   - Overwrites the original message with "Encoded failure" to indicate that more information could be extracted.
+    //   - Overwrites the original stack_trace with an empty string.
+    //   - The resulting JSON object is converted to Payload using the default PayloadConverter and should be processed
+    //     by the user-provided PayloadCodec
+    //
+    // - If there's demand, we could allow overriding the default SDK implementation to encode other opaque Failure attributes.
+    // (-- api-linter: core::0203::optional=disabled --)
+    temporal.api.common.v1.Payload encoded_attributes = 20;
     Failure cause = 4;
     oneof failure_info {
         ApplicationFailureInfo application_failure_info = 5;

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

@@ -41,8 +41,9 @@ import "temporal/api/enums/v1/failed_cause.proto";
 import "temporal/api/enums/v1/workflow.proto";
 import "temporal/api/common/v1/message.proto";
 import "temporal/api/failure/v1/message.proto";
-import "temporal/api/workflow/v1/message.proto";
 import "temporal/api/taskqueue/v1/message.proto";
+import "temporal/api/update/v1/message.proto";
+import "temporal/api/workflow/v1/message.proto";
 
 // Always the first event in workflow history
 message WorkflowExecutionStartedEventAttributes {
@@ -634,6 +635,51 @@ message ChildWorkflowExecutionTerminatedEventAttributes {
     int64 started_event_id = 5;
 }
 
+message WorkflowUpdateRequestedEventAttributes {
+    temporal.api.common.v1.Header header = 1;
+    string request_id = 2;
+    string update_id = 3;
+    temporal.api.update.v1.WorkflowUpdate update = 4;
+}
+
+message WorkflowUpdateAcceptedEventAttributes {
+    temporal.api.common.v1.Header header = 1;
+    string update_id = 2;
+}
+
+message WorkflowUpdateCompletedEventAttributes {
+    temporal.api.common.v1.Header system_header = 1;
+    string update_id = 3;
+    oneof result {
+        temporal.api.common.v1.Payloads success = 4;
+        temporal.api.failure.v1.Failure failure = 5;
+    }
+}
+
+message WorkflowPropertiesModifiedExternallyEventAttributes {
+    // If set to a nonempty string, future workflow tasks for this workflow shall be dispatched on
+    // the provided queue.
+    string new_task_queue = 1;
+    // If set, update the workflow task timeout to this value.
+    google.protobuf.Duration new_workflow_task_timeout = 2 [(gogoproto.stdduration) = true];
+    // If set, update the workflow run timeout to this value. May be set to 0 for no timeout.
+    google.protobuf.Duration new_workflow_run_timeout = 3 [(gogoproto.stdduration) = true];
+    // If set, update the workflow execution timeout to this value. May be set to 0 for no timeout.
+    google.protobuf.Duration new_workflow_execution_timeout = 4 [(gogoproto.stdduration) = true];
+    // If set, update the workflow memo with the provided values. The values will be merged with
+    // the existing memo. If the user wants to delete values, a default/empty Payload should be
+    // used as the value for the key being deleted.
+    temporal.api.common.v1.Memo upserted_memo = 5;
+}
+
+message ActivityPropertiesModifiedExternallyEventAttributes {
+    // The id of the `ACTIVITY_TASK_SCHEDULED` event this modification corresponds to.
+    int64 scheduled_event_id = 1;
+    // If set, update the retry policy of the activity, replacing it with the specified one.
+    // The number of attempts at the activity is preserved.
+    temporal.api.common.v1.RetryPolicy new_retry_policy = 2;
+}
+
 // History events are the method by which Temporal SDKs advance (or recreate) workflow state.
 // See the `EventType` enum for more info about what each event is for.
 message HistoryEvent {
@@ -645,6 +691,11 @@ message HistoryEvent {
     int64 version = 4;
     // TODO: What is this? Appears unused by SDKs
     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
+    // type which it does not understand, it must error unless this is true. If it is true, it's
+    // acceptable for the event type and/or attributes to be uninterpretable.
+    bool worker_may_ignore = 300;
     // The event details. The type must match that in `event_type`.
     oneof attributes {
         WorkflowExecutionStartedEventAttributes workflow_execution_started_event_attributes = 6;
@@ -687,6 +738,11 @@ message HistoryEvent {
         SignalExternalWorkflowExecutionFailedEventAttributes signal_external_workflow_execution_failed_event_attributes = 43;
         ExternalWorkflowExecutionSignaledEventAttributes external_workflow_execution_signaled_event_attributes = 44;
         UpsertWorkflowSearchAttributesEventAttributes upsert_workflow_search_attributes_event_attributes = 45;
+        WorkflowUpdateRequestedEventAttributes workflow_update_requested_event_attributes = 46;
+        WorkflowUpdateAcceptedEventAttributes workflow_update_accepted_event_attributes = 47;
+        WorkflowUpdateCompletedEventAttributes workflow_update_completed_event_attributes = 48;
+        WorkflowPropertiesModifiedExternallyEventAttributes workflow_properties_modified_externally_event_attributes = 49;
+        ActivityPropertiesModifiedExternallyEventAttributes activity_properties_modified_externally_event_attributes = 50;
     }
 }
 

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

@@ -84,18 +84,16 @@ message DeleteNamespaceResponse {
     string deleted_namespace = 1;
 }
 
-// This message is EXPERIMENTAL and may be changed or removed in a later release.
 // (-- api-linter: core::0135::request-unknown-fields=disabled
 //     aip.dev/not-precedent: DeleteNamespace RPC doesn't follow Google API format. --)
 // (-- api-linter: core::0135::request-name-required=disabled
 //     aip.dev/not-precedent: DeleteNamespace RPC doesn't follow Google API format. --)
 message DeleteWorkflowExecutionRequest {
     string namespace = 1;
-    // Workflow executions to delete. If run_id is not specified, last one is used.
+    // Workflow Execution to delete. If run_id is not specified, the latest one is used.
     temporal.api.common.v1.WorkflowExecution workflow_execution = 2;
 }
 
-// This message is EXPERIMENTAL and may be changed or removed in a later release.
 message DeleteWorkflowExecutionResponse {
 }
 

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

@@ -66,8 +66,10 @@ service OperatorService {
     rpc DeleteNamespace (DeleteNamespaceRequest) returns (DeleteNamespaceResponse) {
     }
 
-    // DeleteWorkflowExecution deletes a closed workflow execution asynchronously (workflow must be completed or terminated before).
-    // This method is EXPERIMENTAL and may be changed or removed in a later release.
+    // DeleteWorkflowExecution asynchronously deletes a specific Workflow Execution (when
+    // WorkflowExecution.run_id is provided) or the latest Workflow Execution (when
+    // WorkflowExecution.run_id is not provided). If the Workflow Execution is Running, it will be
+    // terminated before deletion.
     // (-- api-linter: core::0135::method-signature=disabled
     //     aip.dev/not-precedent: DeleteNamespace RPC doesn't follow Google API format. --)
     // (-- api-linter: core::0135::response-message-name=disabled

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

@@ -31,6 +31,10 @@ option java_outer_classname = "MessageProto";
 option ruby_package = "Temporal::Api::Replication::V1";
 option csharp_namespace = "Temporal.Api.Replication.V1";
 
+import "google/protobuf/timestamp.proto";
+
+import "dependencies/gogoproto/gogo.proto";
+
 import "temporal/api/enums/v1/namespace.proto";
 
 message ClusterReplicationConfig {
@@ -42,3 +46,10 @@ message NamespaceReplicationConfig {
     repeated ClusterReplicationConfig clusters = 2;
     temporal.api.enums.v1.ReplicationState state = 3;
 }
+
+// Represents a historical replication status of a Namespace
+message FailoverStatus {
+    // Timestamp when the Cluster switched to the following failover_version
+    google.protobuf.Timestamp failover_time = 1 [(gogoproto.stdtime) = true];
+    int64 failover_version = 2;
+}

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

@@ -75,6 +75,9 @@ message PollerInfo {
     google.protobuf.Timestamp last_access_time = 1 [(gogoproto.stdtime) = true];
     string identity = 2;
     double rate_per_second = 3;
+    // If a worker has specified an ID for use with the worker versioning feature while polling,
+    // that id must appear here.
+    string worker_versioning_build_id = 4;
 }
 
 message StickyExecutionAttributes {
@@ -83,3 +86,23 @@ message StickyExecutionAttributes {
     //     aip.dev/not-precedent: "to" is used to indicate interval. --)
     google.protobuf.Duration schedule_to_start_timeout = 2 [(gogoproto.stdduration) = true];
 }
+
+// Used by the worker versioning APIs, represents a node in the version graph for a particular
+// task queue
+message VersionIdNode {
+    VersionId version = 1;
+    // A pointer to the previous version this version is considered to be compatible with
+    VersionIdNode previous_compatible = 2;
+    // A pointer to the last incompatible version (previous major version)
+    VersionIdNode previous_incompatible = 3;
+}
+
+// Used by the worker versioning APIs, represents a specific version of something
+// Currently, that's just a whole-worker id. In the future, if we support 
+// WASM workflow bundle based versioning, for example, then the inside of this
+// message may become a oneof of different version types.
+message VersionId {
+    // An opaque whole-worker identifier
+    string worker_build_id = 1;
+}
+

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

@@ -0,0 +1,46 @@
+// 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.update.v1;
+
+option go_package = "go.temporal.io/api/update/v1;update";
+option java_package = "io.temporal.api.update.v1";
+option java_multiple_files = true;
+option java_outer_classname = "MessageProto";
+option ruby_package = "Temporal::Api::Update::V1";
+option csharp_namespace = "Temporal.Api.Update.V1";
+
+import "temporal/api/common/v1/message.proto";
+
+message WorkflowUpdate {
+    // Headers that are passed with the update to the processing workflow.
+    // These can include things like auth or tracing tokens.
+    temporal.api.common.v1.Header header = 1;
+
+    // The name of the update function to invoke on the target workflow.
+    string name = 2;
+
+    // The arguments to pass to the named update function.
+    temporal.api.common.v1.Payloads args = 3;
+}

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

@@ -142,3 +142,4 @@ message NewWorkflowExecutionInfo {
     temporal.api.common.v1.SearchAttributes search_attributes = 12;
     temporal.api.common.v1.Header header = 13;
 }
+

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

@@ -31,6 +31,7 @@ option java_outer_classname = "RequestResponseProto";
 option ruby_package = "Temporal::Api::WorkflowService::V1";
 option csharp_namespace = "Temporal.Api.WorkflowService.V1";
 
+import "temporal/api/enums/v1/batch_operation.proto";
 import "temporal/api/enums/v1/workflow.proto";
 import "temporal/api/enums/v1/namespace.proto";
 import "temporal/api/enums/v1/failed_cause.proto";
@@ -38,6 +39,7 @@ import "temporal/api/enums/v1/common.proto";
 import "temporal/api/enums/v1/query.proto";
 import "temporal/api/enums/v1/reset.proto";
 import "temporal/api/enums/v1/task_queue.proto";
+import "temporal/api/enums/v1/update.proto";
 import "temporal/api/common/v1/message.proto";
 import "temporal/api/history/v1/message.proto";
 import "temporal/api/workflow/v1/message.proto";
@@ -49,7 +51,9 @@ import "temporal/api/query/v1/message.proto";
 import "temporal/api/replication/v1/message.proto";
 import "temporal/api/schedule/v1/message.proto";
 import "temporal/api/taskqueue/v1/message.proto";
+import "temporal/api/update/v1/message.proto";
 import "temporal/api/version/v1/message.proto";
+import "temporal/api/batch/v1/message.proto";
 
 import "google/protobuf/duration.proto";
 import "google/protobuf/timestamp.proto";
@@ -100,6 +104,9 @@ message DescribeNamespaceResponse {
     temporal.api.replication.v1.NamespaceReplicationConfig replication_config = 3;
     int64 failover_version = 4;
     bool is_global_namespace = 5;
+    // Contains the historical state of failover_versions for the cluster, truncated to contain only the last N
+    // states to ensure that the list does not grow unbounded.
+    repeated temporal.api.replication.v1.FailoverStatus failover_history = 6;
 }
 
 // (-- api-linter: core::0134::request-mask-required=disabled
@@ -212,7 +219,14 @@ message PollWorkflowTaskQueueRequest {
     // The identity of the worker/client who is polling this task queue
     string identity = 3;
     // 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;
+    // If set, the worker is opting in to build-id based versioning and wishes to only
+    // receive tasks that are considered compatible with the version provided in the string.
+    // Doing so only makes sense in conjunction with the `UpdateWorkerBuildIdOrdering` API.
+    // When set, and `binary_checksum` is not, this value should also be considered as the
+    // `binary_checksum`.
+    string worker_versioning_build_id = 5;
 }
 
 message PollWorkflowTaskQueueResponse {
@@ -311,6 +325,10 @@ message PollActivityTaskQueueRequest {
     // The identity of the worker/client
     string identity = 3;
     temporal.api.taskqueue.v1.TaskQueueMetadata task_queue_metadata = 4;
+    // If set, the worker is opting in to build-id based versioning and wishes to only
+    // receive tasks that are considered compatible with the version provided in the string.
+    // Doing so only makes sense in conjunction with the `UpdateWorkerBuildIdOrdering` API.
+    string worker_versioning_build_id = 5;
 }
 
 message PollActivityTaskQueueResponse {
@@ -800,6 +818,9 @@ message GetSystemInfoResponse {
 
         // Supports scheduled workflow features.
         bool supports_schedules = 4;
+
+        // True if server uses protos that include temporal.api.failure.v1.Failure.encoded_attributes
+        bool encoded_failure_attributes = 5;
     }
 }
 
@@ -950,3 +971,154 @@ message ListSchedulesResponse {
     repeated temporal.api.schedule.v1.ScheduleListEntry schedules = 1;
     bytes next_page_token = 2;
 }
+
+// (-- api-linter: core::0134::request-mask-required=disabled
+//     aip.dev/not-precedent: UpdateWorkerBuildIdOrderingRequest doesn't follow Google API format --)
+// (-- api-linter: core::0134::request-resource-required=disabled
+//     aip.dev/not-precedent: UpdateWorkerBuildIdOrderingRequest RPC doesn't follow Google API format. --)
+message UpdateWorkerBuildIdOrderingRequest {
+    string namespace = 1;
+    // Must be set, the task queue to apply changes to. Because all workers on
+    // a given task queue must have the same set of workflow & activity
+    // implementations, there is no reason to specify a task queue type here.
+    string task_queue = 2;
+    // The version id we are targeting.
+    temporal.api.taskqueue.v1.VersionId version_id = 3;
+    // When set, indicates that the `version_id` in this message is compatible
+    // with the one specified in this field. Because compatability should form
+    // a DAG, any build id can only be the "next compatible" version for one
+    // other ID of a certain type at a time, and any setting which would create a cycle is invalid.
+    temporal.api.taskqueue.v1.VersionId previous_compatible = 4;
+    // When set, establishes the specified `version_id` as the default of it's type
+    // for the queue. Workers matching it will begin processing new workflow executions.
+    // The existing default will be marked as a previous incompatible version
+    // to this one, assuming it is not also in `is_compatible_with`.
+    bool become_default = 5;
+}
+message UpdateWorkerBuildIdOrderingResponse {}
+
+// (-- api-linter: core::0134::request-resource-required=disabled
+//     aip.dev/not-precedent: GetWorkerBuildIdOrderingRequest RPC doesn't follow Google API format. --)
+message GetWorkerBuildIdOrderingRequest {
+    string namespace = 1;
+    // Must be set, the task queue to interrogate about worker id ordering
+    string task_queue = 2;
+    // Limits how deep the returned DAG will go. 1 will return only the
+    // default build id. A default/0 value will return the entire graph.
+    int32 max_depth = 3;
+}
+message GetWorkerBuildIdOrderingResponse {
+    // The currently established default version
+    temporal.api.taskqueue.v1.VersionIdNode current_default = 1;
+    // Other current latest-compatible versions who are not the overall default. These are the
+    // versions that will be used when generating new tasks by following the graph from the
+    // version of the last task out to a leaf.
+    repeated temporal.api.taskqueue.v1.VersionIdNode compatible_leaves = 2;
+}
+
+// (-- api-linter: core::0134=disabled
+//     aip.dev/not-precedent: Update RPCs don't follow Google API format. --)
+message UpdateWorkflowRequest {
+    // A unique ID for this logical request
+    string request_id = 1;
+
+    // The manner in which the update result will be accessed.
+    // This field requires a non-default value; the default value of the enum
+    // will result in an error.
+    temporal.api.enums.v1.WorkflowUpdateResultAccessStyle result_access_style = 2;
+
+    // The namespace name of the target workflow
+    string namespace = 3;
+    // The target workflow id and (optionally) a specific run thereof
+    // (-- api-linter: core::0203::optional=disabled
+    //     aip.dev/not-precedent: false positive triggered by the word "optional" --)
+    temporal.api.common.v1.WorkflowExecution workflow_execution = 4;
+    // If set, this call will error if the most recent (if no run id is set on
+    // `workflow_execution`), or specified (if it is) workflow execution is not
+    // part of the same execution chain as this id.
+    string first_execution_run_id = 5;
+
+    // The name under which the workflow update function is registered and the
+    // arguments to pass to said function.
+    temporal.api.update.v1.WorkflowUpdate update = 6;
+}
+
+message UpdateWorkflowResponse {
+    // An opaque token that can be used to retrieve the update result via
+    // polling if it is not returned as part of the gRPC response
+    bytes update_token = 1;
+    // The success or failure status of the update
+    oneof result {
+        temporal.api.common.v1.Payloads success = 2;
+        temporal.api.failure.v1.Failure failure = 3;
+    }
+}
+
+message StartBatchOperationRequest {
+    // Namespace that contains the batch operation
+    string namespace = 1;
+    // Visibility query defines the the group of workflow to do batch operation
+    string visibility_query = 2;
+    // Operation input
+    oneof operation {
+        temporal.api.batch.v1.BatchOperationTermination termination_operation = 10;
+        temporal.api.batch.v1.BatchOperationSignal signal_operation = 11;
+        temporal.api.batch.v1.BatchOperationCancellation cancellation_operation = 12;
+    }
+}
+
+message StartBatchOperationResponse {
+    // Batch job id
+    string job_id = 1;
+}
+
+message StopBatchOperationRequest {
+    // Namespace that contains the batch operation
+    string namespace = 1;
+    // Batch job id
+    string job_id = 2;
+}
+
+message StopBatchOperationResponse {
+}
+
+message DescribeBatchOperationRequest {
+    // Namespace that contains the batch operation
+    string namespace = 1;
+    // Batch job id
+    string job_id = 2;
+}
+
+message DescribeBatchOperationResponse {
+    // Batch operation type
+    temporal.api.enums.v1.BatchOperationType operation_type = 1;
+    // Batch job ID
+    string job_id = 2;
+    // Batch operation state
+    temporal.api.enums.v1.BatchOperationState state = 3;
+    // Batch operation start time
+    google.protobuf.Timestamp start_time = 4 [(gogoproto.stdtime) = true];
+    // Batch operation close time
+    google.protobuf.Timestamp close_time = 5 [(gogoproto.stdtime) = true];
+    // Total operation count
+    int64 total_operation_count = 6;
+    // Complete operation count
+    int64 complete_operation_count = 7;
+    // Failure operation count
+    int64 failure_operation_count = 8;
+}
+
+message ListBatchOperationsRequest {
+    // Namespace that contains the batch operation
+    string namespace = 1;
+    // List page size
+    int32 page_size = 2;
+    // Next page token
+    bytes next_page_token = 3;
+}
+
+message ListBatchOperationsResponse {
+    // BatchOperationInfo contains the basic info about batch operation
+    repeated temporal.api.batch.v1.BatchOperationInfo operation_info = 1;
+    bytes next_page_token = 2;
+}

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

@@ -368,4 +368,34 @@ service WorkflowService {
     // List all schedules in a namespace.
     rpc ListSchedules (ListSchedulesRequest) returns (ListSchedulesResponse) {
     }
+
+    // (-- api-linter: core::0134::response-message-name=disabled
+    //     aip.dev/not-precedent: UpdateWorkerBuildIdOrdering RPC doesn't follow Google API format. --)
+    // (-- api-linter: core::0134::method-signature=disabled
+    //     aip.dev/not-precedent: UpdateWorkerBuildIdOrdering RPC doesn't follow Google API format. --)
+    rpc UpdateWorkerBuildIdOrdering (UpdateWorkerBuildIdOrderingRequest) returns (UpdateWorkerBuildIdOrderingResponse) {}
+    // This could / maybe should just be part of `DescribeTaskQueue`, but is broken out here to show easily.
+    rpc GetWorkerBuildIdOrdering (GetWorkerBuildIdOrderingRequest) returns (GetWorkerBuildIdOrderingResponse) {}
+
+    // Invokes the specified update function on user workflow code.
+    // (-- api-linter: core::0134=disabled
+    //     aip.dev/not-precedent: UpdateWorkflow doesn't follow Google API format --)
+    rpc UpdateWorkflow(UpdateWorkflowRequest) returns (UpdateWorkflowResponse) {
+    }
+
+    // StartBatchOperation starts a new batch operation
+    rpc StartBatchOperation(StartBatchOperationRequest) returns (StartBatchOperationResponse) {
+    }
+
+    // StopBatchOperation stops a batch operation
+    rpc StopBatchOperation(StopBatchOperationRequest) returns (StopBatchOperationResponse) {
+    }
+
+    // DescribeBatchOperation returns the information about a batch operation
+    rpc DescribeBatchOperation(DescribeBatchOperationRequest) returns (DescribeBatchOperationResponse) {
+    }
+
+    // ListBatchOperations returns a list of batch operations
+    rpc ListBatchOperations(ListBatchOperationsRequest) returns (ListBatchOperationsResponse) {
+    }
 }