@temporalio/core-bridge 1.6.0 → 1.7.1

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

@@ -41,9 +41,10 @@ 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/interaction/v1/message.proto";
 import "temporal/api/taskqueue/v1/message.proto";
+import "temporal/api/update/v1/message.proto";
 import "temporal/api/workflow/v1/message.proto";
+import "temporal/api/sdk/v1/task_complete_metadata.proto";
 
 // Always the first event in workflow history
 message WorkflowExecutionStartedEventAttributes {
@@ -195,6 +196,11 @@ message WorkflowTaskCompletedEventAttributes {
     // ID of the worker who picked up this workflow task, or missing if worker
     // is not using versioning.
     temporal.api.taskqueue.v1.VersionId worker_versioning_id = 5;
+    // Data the SDK wishes to record for itself, but server need not interpret, and does not
+    // directly impact workflow state.
+    temporal.api.sdk.v1.WorkflowTaskCompletedMetadata sdk_metadata = 6;
+    // Local usage data sent during workflow task completion and recorded here for posterity
+    temporal.api.common.v1.MeteringMetadata metering_metadata = 13;
 }
 
 message WorkflowTaskTimedOutEventAttributes {
@@ -647,21 +653,6 @@ message ChildWorkflowExecutionTerminatedEventAttributes {
     int64 started_event_id = 5;
 }
 
-message WorkflowUpdateAcceptedEventAttributes {
-    temporal.api.interaction.v1.Meta meta = 1;
-    temporal.api.interaction.v1.Input input = 2;
-}
-
-message WorkflowUpdateCompletedEventAttributes {
-    temporal.api.interaction.v1.Meta meta = 1;
-    temporal.api.interaction.v1.Output output = 2;
-}
-
-message WorkflowUpdateRejectedEventAttributes {
-    temporal.api.interaction.v1.Meta meta = 1;
-    temporal.api.failure.v1.Failure failure = 2;
-}
-
 message WorkflowPropertiesModifiedExternallyEventAttributes {
     // If set to a nonempty string, future workflow tasks for this workflow shall be dispatched on
     // the provided queue.
@@ -686,6 +677,44 @@ message ActivityPropertiesModifiedExternallyEventAttributes {
     temporal.api.common.v1.RetryPolicy new_retry_policy = 2;
 }
 
+message WorkflowExecutionUpdateAcceptedEventAttributes {
+    // The instance ID of the update protocol that generated this event.
+    string protocol_instance_id = 1;
+    // The message ID of the original request message that initiated this
+    // update. Needed so that the worker can recreate and deliver that same
+    // message as part of replay.
+    string accepted_request_message_id = 2;
+    // The event ID used to sequence the original request message.
+    int64 accepted_request_sequencing_event_id = 3;
+    // The message payload of the original request message that initiated this
+    // update.
+    temporal.api.update.v1.Request accepted_request = 4;
+}
+
+message WorkflowExecutionUpdateCompletedEventAttributes {
+    // The metadata about this update.
+    temporal.api.update.v1.Meta meta = 1;
+    // The outcome of executing the workflow update function.
+    temporal.api.update.v1.Outcome outcome = 2;
+}
+
+message WorkflowExecutionUpdateRejectedEventAttributes {
+    // The instance ID of the update protocol that generated this event.
+    string protocol_instance_id = 1;
+    // The message ID of the original request message that initiated this
+    // update. Needed so that the worker can recreate and deliver that same
+    // message as part of replay.
+    string rejected_request_message_id = 2;
+    // The event ID used to sequence the original request message.
+    int64 rejected_request_sequencing_event_id = 3;
+    // The message payload of the original request message that initiated this
+    // update.
+    temporal.api.update.v1.Request rejected_request = 4;
+    // The cause of rejection.
+    temporal.api.failure.v1.Failure failure = 5;
+}
+
+
 // 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 {
@@ -744,9 +773,9 @@ 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;
-        WorkflowUpdateRejectedEventAttributes workflow_update_rejected_event_attributes = 46;
-        WorkflowUpdateAcceptedEventAttributes workflow_update_accepted_event_attributes = 47;
-        WorkflowUpdateCompletedEventAttributes workflow_update_completed_event_attributes = 48;
+        WorkflowExecutionUpdateAcceptedEventAttributes workflow_execution_update_accepted_event_attributes = 46;
+        WorkflowExecutionUpdateRejectedEventAttributes workflow_execution_update_rejected_event_attributes = 47;
+        WorkflowExecutionUpdateCompletedEventAttributes workflow_execution_update_completed_event_attributes = 48;
         WorkflowPropertiesModifiedExternallyEventAttributes workflow_properties_modified_externally_event_attributes = 49;
         ActivityPropertiesModifiedExternallyEventAttributes activity_properties_modified_externally_event_attributes = 50;
         WorkflowPropertiesModifiedEventAttributes workflow_properties_modified_event_attributes = 51;

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

@@ -62,6 +62,8 @@ message NamespaceConfig {
     // If unspecified (ARCHIVAL_STATE_UNSPECIFIED) then default server configuration is used.
     temporal.api.enums.v1.ArchivalState visibility_archival_state = 5;
     string visibility_archival_uri = 6;
+    // Map from field name to alias.
+    map<string, string> custom_search_attribute_aliases = 7;
 }
 
 message BadBinaries {

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

@@ -38,6 +38,7 @@ import "temporal/api/enums/v1/common.proto";
 message AddSearchAttributesRequest {
     // Mapping between search attribute name and its IndexedValueType.
     map<string, temporal.api.enums.v1.IndexedValueType> search_attributes = 1;
+    string namespace = 2;
 }
 
 message AddSearchAttributesResponse {
@@ -46,12 +47,14 @@ message AddSearchAttributesResponse {
 message RemoveSearchAttributesRequest {
     // Search attribute names to delete.
     repeated string search_attributes = 1;
+    string namespace = 2;
 }
 
 message RemoveSearchAttributesResponse {
 }
 
 message ListSearchAttributesRequest {
+    string namespace = 1;
 }
 
 message ListSearchAttributesResponse {

package/sdk-core/protos/api_upstream/temporal/api/{enums/v1/interaction_type.proto → protocol/v1/message.proto}

@@ -22,18 +22,36 @@
 
 syntax = "proto3";
 
-package temporal.api.enums.v1;
+package temporal.api.protocol.v1;
 
-option go_package = "go.temporal.io/api/enums/v1;enums";
-option java_package = "io.temporal.api.enums.v1";
+option go_package = "go.temporal.io/api/protocol/v1;protocol";
+option java_package = "io.temporal.api.protocol.v1";
 option java_multiple_files = true;
-option java_outer_classname = "InteractionTypeProto";
-option ruby_package = "Temporalio::Api::Enums::V1";
-option csharp_namespace = "Temporalio.Api.Enums.V1";
+option java_outer_classname = "MessageProto";
+option ruby_package = "Temporalio::Api::Protocol::V1";
+option csharp_namespace = "Temporalt.Api.Protocol.V1";
 
-enum InteractionType {
-   INTERACTION_TYPE_UNSPECIFIED = 0;
-   INTERACTION_TYPE_WORKFLOW_QUERY = 1;
-   INTERACTION_TYPE_WORKFLOW_UPDATE = 2;
-   INTERACTION_TYPE_WORKFLOW_SIGNAL = 3;
+import "google/protobuf/any.proto";
+
+// (-- api-linter: core::0146::any=disabled
+//     aip.dev/not-precedent: We want runtime extensibility for the body field --)
+message Message {
+    // An ID for this specific message.
+    string id = 1;
+
+    // Identifies the specific instance of a protocol to which this message
+    // belongs.
+    string protocol_instance_id = 2;
+
+    // The event ID or command ID after which this message can be delivered. The
+    // effects of history up to and including this event ID should be visible to
+    // the code that handles this message. Omit to opt out of sequencing.
+    oneof sequencing_id {
+        int64 event_id = 3;
+        int64 command_index = 4;
+    };
+    
+    // The opaque data carried by this message. The protocol type can be
+    // extracted from the package name of the message carried inside the Any.
+    google.protobuf.Any body = 5;
 }

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

@@ -0,0 +1,63 @@
+// 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.sdk.v1;
+
+option go_package = "go.temporal.io/api/sdk/v1;sdk";
+option java_package = "io.temporal.api.sdk.v1";
+option java_multiple_files = true;
+option java_outer_classname = "TaskCompleteMetadataProto";
+option ruby_package = "Temporalio::Api::Sdk::V1";
+option csharp_namespace = "Temporalio.Api.Sdk.V1";
+
+message WorkflowTaskCompletedMetadata {
+  // Internal flags used by the core SDK. SDKs using flags must comply with the following behavior:
+  //
+  // During replay:
+  // * If a flag is not recognized (value is too high or not defined), it must fail the workflow
+  //   task.
+  // * If a flag is recognized, it is stored in a set of used flags for the run. Code checks for
+  //   that flag during and after this WFT are allowed to assume that the flag is present.
+  // * If a code check for a flag does not find the flag in the set of used flags, it must take
+  //   the branch corresponding to the absence of that flag.
+  //
+  // During non-replay execution of new WFTs:
+  // * The SDK is free to use all flags it knows about. It must record any newly-used (IE: not
+  //   previously recorded) flags when completing the WFT.
+  //
+  // SDKs which are too old to even know about this field at all are considered to produce
+  // undefined behavior if they replay workflows which used this mechanism.
+  //
+  // (-- api-linter: core::0141::forbidden-types=disabled
+  //     aip.dev/not-precedent: These really shouldn't have negative values. --)
+  repeated uint32 core_used_flags = 1;
+
+  // Flags used by the SDK lang. No attempt is made to distinguish between different SDK languages
+  // here as processing a workflow with a different language than the one which authored it is
+  // already undefined behavior. See `core_used_patches` for more.
+  //
+  // (-- api-linter: core::0141::forbidden-types=disabled
+  //     aip.dev/not-precedent: These really shouldn't have negative values. --)
+  repeated uint32 lang_used_flags = 2;
+}

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

@@ -0,0 +1,111 @@
+// 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 = "Temporalio::Api::Update::V1";
+option csharp_namespace = "Temporalio.Api.Update.V1";
+
+import "temporal/api/common/v1/message.proto";
+import "temporal/api/enums/v1/update.proto";
+import "temporal/api/failure/v1/message.proto";
+
+// Sepcifies to the gRPC server how the client wants the UpdateWorkflowExecution
+// call to wait before returning control to the caller.
+message WaitPolicy {
+
+    // Indicates the update lifecycle stage that the gRPC call should wait for
+    // before returning.
+    temporal.api.enums.v1.UpdateWorkflowExecutionLifecycleStage lifecycle_stage = 1;
+}
+
+// The data needed by a client to refer to an previously invoked workflow
+// execution update process.
+message UpdateRef {
+    temporal.api.common.v1.WorkflowExecution workflow_execution = 1;
+    string update_id = 2;
+}
+
+// The outcome of a workflow update - success or failure.
+message Outcome {
+    oneof value {
+        temporal.api.common.v1.Payloads success = 1;
+        temporal.api.failure.v1.Failure failure = 2;
+    }
+}
+
+// Metadata about a workflow execution update.
+message Meta {
+    // An ID with workflow-scoped uniqueness for this update
+    string update_id = 1;
+
+    // A string identifying the agent that requested this update.
+    string identity = 2;
+}
+
+message Input {
+    // Headers that are passed with the update from the requesting entity.
+    // These can include things like auth or tracing tokens.
+    temporal.api.common.v1.Header header = 1;
+
+    // The name of the input handler to invoke on the target workflow
+    string name = 2;
+
+    // The arguments to pass to the named handler.
+    temporal.api.common.v1.Payloads args = 3;
+}
+
+// The client request that triggers a workflow execution update
+message Request {
+    Meta meta = 1;
+    Input input = 2;
+}
+
+// An update protocol message indicating that a workflow execution update has
+// been rejected.
+message Rejection {
+    string rejected_request_message_id = 1;
+    int64 rejected_request_sequencing_event_id = 2;
+    Request rejected_request = 3;
+    temporal.api.failure.v1.Failure failure = 4;
+}
+
+// An update protocol message indicating that a workflow execution update has
+// been accepted (i.e. passed the worker-side validation phase).
+message Acceptance {
+    string accepted_request_message_id = 1;
+    int64 accepted_request_sequencing_event_id = 2;
+    Request accepted_request = 3;
+}
+
+// An update protocol message indicating that a workflow execution update has
+// completed with the contained outcome.
+message Response {
+    Meta meta = 1;
+    Outcome outcome = 2;
+}

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

@@ -39,21 +39,22 @@ 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/interaction/v1/message.proto";
 import "temporal/api/workflow/v1/message.proto";
 import "temporal/api/command/v1/message.proto";
 import "temporal/api/failure/v1/message.proto";
 import "temporal/api/filter/v1/message.proto";
+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/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 "temporal/api/sdk/v1/task_complete_metadata.proto";
 
 import "google/protobuf/duration.proto";
 import "google/protobuf/timestamp.proto";
@@ -168,10 +169,25 @@ message StartWorkflowExecutionRequest {
     temporal.api.common.v1.Memo memo = 14;
     temporal.api.common.v1.SearchAttributes search_attributes = 15;
     temporal.api.common.v1.Header header = 16;
+    // Request to get the first workflow task inline in the response bypassing matching service and worker polling.
+    // If set to `true` the caller is expected to have a worker available and capable of processing the task.
+    // The returned task will be marked as started and is expected to be completed by the specified
+    // `workflow_task_timeout`.
+    bool request_eager_execution = 17;
+    // These values will be available as ContinuedFailure and LastCompletionResult in the
+    // WorkflowExecutionStarted event and through SDKs. The are currently only used by the
+    // server itself (for the schedules feature) and are not intended to be exposed in
+    // StartWorkflowExecution.
+    temporal.api.failure.v1.Failure continued_failure = 18;
+    temporal.api.common.v1.Payloads last_completion_result = 19;
 }
 
 message StartWorkflowExecutionResponse {
     string run_id = 1;
+    // 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;
 }
 
 message GetWorkflowExecutionHistoryRequest {
@@ -267,8 +283,8 @@ message PollWorkflowTaskQueueResponse {
     // Queries that should be executed after applying the history in this task. Responses should be
     // attached to `RespondWorkflowTaskCompletedRequest::query_results`
     map<string, temporal.api.query.v1.WorkflowQuery> queries = 14;
-
-    repeated temporal.api.interaction.v1.Invocation interactions = 15;
+    // Protocol messages piggybacking on a WFT as a transport
+    repeated temporal.api.protocol.v1.Message messages = 15;
 }
 
 message RespondWorkflowTaskCompletedRequest {
@@ -299,6 +315,13 @@ message RespondWorkflowTaskCompletedRequest {
     // When `worker_versioning_id` has a `worker_build_id`, and `binary_checksum` is not
     // set, that value should also be considered as the `binary_checksum`.
     temporal.api.taskqueue.v1.VersionId worker_versioning_id = 10;
+    // Protocol messages piggybacking on a WFT as a transport
+    repeated temporal.api.protocol.v1.Message messages = 11;
+    // Data the SDK wishes to record for itself, but server need not interpret, and does not
+    // directly impact workflow state.
+    temporal.api.sdk.v1.WorkflowTaskCompletedMetadata sdk_metadata = 12;
+    // Local usage data collected for metering
+    temporal.api.common.v1.MeteringMetadata metering_metadata = 13;
 }
 
 message RespondWorkflowTaskCompletedResponse {
@@ -323,6 +346,8 @@ message RespondWorkflowTaskFailedRequest {
     // Worker process' unique binary id
     string binary_checksum = 5;
     string namespace = 6;
+    // Protocol messages piggybacking on a WFT as a transport
+    repeated temporal.api.protocol.v1.Message messages = 7;
 }
 
 message RespondWorkflowTaskFailedResponse {
@@ -851,6 +876,13 @@ message GetSystemInfoResponse {
 
         // True if server supports upserting workflow memo
         bool upsert_memo = 7;
+
+        // True if server supports eager workflow task dispatching for the StartWorkflowExecution API
+        bool eager_workflow_start = 8;
+
+        // True if the server knows about the sdk metadata field on WFT completions and will record
+        // it in history
+        bool sdk_metadata = 9;
     }
 }
 
@@ -1051,51 +1083,50 @@ message GetWorkerBuildIdOrderingResponse {
 
 // (-- 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;
-
+message UpdateWorkflowExecutionRequest {
     // The namespace name of the target workflow
-    string namespace = 3;
+    string namespace = 1;
     // 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;
+    temporal.api.common.v1.WorkflowExecution workflow_execution = 2;
     // 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;
+    string first_execution_run_id = 3;
 
-    // A string identifying the agent that requested this interaction.
-    string identity = 6;
+    // Describes when this request should return - basically whether the
+    // update is synchronous, asynchronous, or somewhere in between.
+    temporal.api.update.v1.WaitPolicy wait_policy = 4;
 
-    // The name under which the workflow update function is registered and the
-    // arguments to pass to said function.
-    temporal.api.interaction.v1.Input input = 7;
+    // The request information that will be delivered all the way down to the
+    // workflow execution.
+    temporal.api.update.v1.Request request = 5;
 }
 
-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
-    temporal.api.interaction.v1.Output output = 2;
+message UpdateWorkflowExecutionResponse {
+    // Enough information for subsequent poll calls if needed. Never null.
+    temporal.api.update.v1.UpdateRef update_ref = 1;
+
+    // The outcome of the update if and only if the workflow execution update
+    // has completed. If this response is being returned before the update has
+    // completed then this field will not be set.
+    temporal.api.update.v1.Outcome outcome = 2;
 }
 
 message StartBatchOperationRequest {
     // Namespace that contains the batch operation
     string namespace = 1;
-    // Visibility query defines the the group of workflow to do batch operation
+    // Visibility query defines the the group of workflow to apply the batch operation
+    // This field and Executions are mutually exclusive
     string visibility_query = 2;
     // Job ID defines the unique ID for the batch job
     string job_id = 3;
     // Reason to perform the batch operation
     string reason = 4;
+    // Executions to apply the batch operation
+    // This field and VisibilityQuery are mutually exclusive
+    repeated temporal.api.common.v1.WorkflowExecution executions = 5;
     // Operation input
     oneof operation {
         temporal.api.batch.v1.BatchOperationTermination termination_operation = 10;

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

@@ -393,8 +393,8 @@ service WorkflowService {
 
     // 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) {
+    //     aip.dev/not-precedent: UpdateWorkflowExecution doesn't follow Google API format --)
+    rpc UpdateWorkflowExecution(UpdateWorkflowExecutionRequest) returns (UpdateWorkflowExecutionResponse) {
     }
 
     // StartBatchOperation starts a new batch operation

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

@@ -1,15 +1,14 @@
 syntax = "proto3";
 
 package coresdk.activity_result;
+option ruby_package = "Temporalio::Bridge::Api::ActivityResult";
 
 import "google/protobuf/duration.proto";
 import "google/protobuf/timestamp.proto";
 import "temporal/api/common/v1/message.proto";
 import "temporal/api/failure/v1/message.proto";
 
-/**
- * Used to report activity completions to core
- */
+// Used to report activity completions to core
 message ActivityExecutionResult {
     oneof status {
         Success completed = 1;
@@ -30,17 +29,17 @@ message ActivityResolution {
     }
 }
 
-/** Used to report successful completion either when executing or resolving */
+// Used to report successful completion either when executing or resolving
 message Success {
     temporal.api.common.v1.Payload result = 1;
 }
 
-/** Used to report activity failure either when executing or resolving */
+// Used to report activity failure either when executing or resolving
 message Failure {
     temporal.api.failure.v1.Failure failure = 1;
 }
 
-/**
+/*
  * Used to report cancellation from both Core and Lang.
  * When Lang reports a cancelled activity, it must put a CancelledFailure in the failure field.
  * When Core reports a cancelled activity, it must put an ActivityFailure with CancelledFailure
@@ -50,14 +49,14 @@ message Cancellation {
     temporal.api.failure.v1.Failure failure = 1;
 }
 
-/**
+/*
  * Used in ActivityExecutionResult to notify Core that this Activity will complete asynchronously.
  * Core will forget about this Activity and free up resources used to track this Activity.
  */
 message WillCompleteAsync {
 }
 
-/**
+/*
  * Issued when a local activity needs to retry but also wants to back off more than would be
  * reasonable to WFT heartbeat for. Lang is expected to schedule a timer for the duration
  * and then start a local activity of the same type & same inputs with the provided attempt number

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

@@ -4,6 +4,7 @@ syntax = "proto3";
  * Definitions of the different activity tasks returned from [crate::Core::poll_task].
  */
 package coresdk.activity_task;
+option ruby_package = "Temporalio::Bridge::Api::ActivityTask";
 
 import "google/protobuf/duration.proto";
 import "google/protobuf/timestamp.proto";
@@ -11,12 +12,12 @@ import "temporal/api/common/v1/message.proto";
 import "temporal/sdk/core/common/common.proto";
 
 message ActivityTask {
-    /// A unique identifier for this task
+    // A unique identifier for this task
     bytes task_token = 1;
     oneof variant {
-        /// Start activity execution.
+        // Start activity execution.
         Start start = 3;
-        /// Attempt to cancel activity execution.
+        // Attempt to cancel activity execution.
         Cancel cancel = 4;
     }
 }
@@ -62,18 +63,20 @@ message Start {
     bool is_local = 17;
 }
 
-/// Attempt to cancel a running activity
+// Attempt to cancel a running activity
 message Cancel {
     ActivityCancelReason reason = 1;
 }
 
 enum ActivityCancelReason {
-    /// The activity no longer exists according to server (may be already completed)
+    // The activity no longer exists according to server (may be already completed)
     NOT_FOUND = 0;
-    /// Activity was explicitly cancelled
+    // Activity was explicitly cancelled
     CANCELLED = 1;
-    /// Activity timed out
+    // Activity timed out
     TIMED_OUT = 2;
+    // Core is shutting down and the graceful timeout has elapsed
+    WORKER_SHUTDOWN = 3;
 }