@temporalio/core-bridge 1.5.2 → 1.7.0

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

@@ -28,8 +28,8 @@ option go_package = "go.temporal.io/api/replication/v1;replication";
 option java_package = "io.temporal.api.replication.v1";
 option java_multiple_files = true;
 option java_outer_classname = "MessageProto";
-option ruby_package = "Temporal::Api::Replication::V1";
-option csharp_namespace = "Temporal.Api.Replication.V1";
+option ruby_package = "Temporalio::Api::Replication::V1";
+option csharp_namespace = "Temporalio.Api.Replication.V1";
 
 import "google/protobuf/timestamp.proto";
 

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

@@ -33,8 +33,8 @@ option go_package = "go.temporal.io/api/schedule/v1;schedule";
 option java_package = "io.temporal.api.schedule.v1";
 option java_multiple_files = true;
 option java_outer_classname = "MessageProto";
-option ruby_package = "Temporal::Api::Schedule::V1";
-option csharp_namespace = "Temporal.Api.Schedule.V1";
+option ruby_package = "Temporalio::Api::Schedule::V1";
+option csharp_namespace = "Temporalio.Api.Schedule.V1";
 
 import "google/protobuf/duration.proto";
 import "google/protobuf/timestamp.proto";

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/taskqueue/v1/message.proto

@@ -28,8 +28,8 @@ option go_package = "go.temporal.io/api/taskqueue/v1;taskqueue";
 option java_package = "io.temporal.api.taskqueue.v1";
 option java_multiple_files = true;
 option java_outer_classname = "MessageProto";
-option ruby_package = "Temporal::Api::TaskQueue::V1";
-option csharp_namespace = "Temporal.Api.TaskQueue.V1";
+option ruby_package = "Temporalio::Api::TaskQueue::V1";
+option csharp_namespace = "Temporalio.Api.TaskQueue.V1";
 
 import "google/protobuf/duration.proto";
 import "google/protobuf/timestamp.proto";

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

@@ -28,19 +28,84 @@ 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";
+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";
 
-message WorkflowUpdate {
-    // Headers that are passed with the update to the processing workflow.
+// 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 update function to invoke on the target workflow.
+    // The name of the input handler to invoke on the target workflow
     string name = 2;
 
-    // The arguments to pass to the named update function.
+    // 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/version/v1/message.proto

@@ -28,8 +28,8 @@ option go_package = "go.temporal.io/api/version/v1;version";
 option java_package = "io.temporal.api.version.v1";
 option java_multiple_files = true;
 option java_outer_classname = "MessageProto";
-option ruby_package = "Temporal::Api::Version::V1";
-option csharp_namespace = "Temporal.Api.Version.V1";
+option ruby_package = "Temporalio::Api::Version::V1";
+option csharp_namespace = "Temporalio.Api.Version.V1";
 
 import "google/protobuf/timestamp.proto";
 import "dependencies/gogoproto/gogo.proto";

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

@@ -28,8 +28,8 @@ option go_package = "go.temporal.io/api/workflow/v1;workflow";
 option java_package = "io.temporal.api.workflow.v1";
 option java_multiple_files = true;
 option java_outer_classname = "MessageProto";
-option ruby_package = "Temporal::Api::Workflow::V1";
-option csharp_namespace = "Temporal.Api.Workflow.V1";
+option ruby_package = "Temporalio::Api::Workflow::V1";
+option csharp_namespace = "Temporalio.Api.Workflow.V1";
 
 import "google/protobuf/duration.proto";
 import "google/protobuf/timestamp.proto";

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

@@ -28,8 +28,8 @@ option go_package = "go.temporal.io/api/workflowservice/v1;workflowservice";
 option java_package = "io.temporal.api.workflowservice.v1";
 option java_multiple_files = true;
 option java_outer_classname = "RequestResponseProto";
-option ruby_package = "Temporal::Api::WorkflowService::V1";
-option csharp_namespace = "Temporal.Api.WorkflowService.V1";
+option ruby_package = "Temporalio::Api::WorkflowService::V1";
+option csharp_namespace = "Temporalio.Api.WorkflowService.V1";
 
 import "temporal/api/enums/v1/batch_operation.proto";
 import "temporal/api/enums/v1/workflow.proto";
@@ -39,13 +39,13 @@ 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";
 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";
@@ -54,6 +54,7 @@ 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,6 +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;
+    // Protocol messages piggybacking on a WFT as a transport
+    repeated temporal.api.protocol.v1.Message messages = 15;
 }
 
 message RespondWorkflowTaskCompletedRequest {
@@ -297,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 {
@@ -304,6 +329,8 @@ message RespondWorkflowTaskCompletedResponse {
     PollWorkflowTaskQueueResponse workflow_task = 1;
     // See `ScheduleActivityTaskCommandAttributes::request_start`
     repeated PollActivityTaskQueueResponse activity_tasks = 2;
+
+    int64 reset_history_event_id = 3;
 }
 
 message RespondWorkflowTaskFailedRequest {
@@ -319,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 {
@@ -847,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;
     }
 }
 
@@ -1047,56 +1083,56 @@ 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;
 
-    // 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;
+    // 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 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
-    oneof result {
-        temporal.api.common.v1.Payloads success = 2;
-        temporal.api.failure.v1.Failure failure = 3;
-    }
+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;
         temporal.api.batch.v1.BatchOperationSignal signal_operation = 11;
         temporal.api.batch.v1.BatchOperationCancellation cancellation_operation = 12;
+        temporal.api.batch.v1.BatchOperationDeletion deletion_operation = 13;
     }
 }
 

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

@@ -28,8 +28,8 @@ option go_package = "go.temporal.io/api/workflowservice/v1;workflowservice";
 option java_package = "io.temporal.api.workflowservice.v1";
 option java_multiple_files = true;
 option java_outer_classname = "ServiceProto";
-option ruby_package = "Temporal::Api::WorkflowService::V1";
-option csharp_namespace = "Temporal.Api.WorkflowService.V1";
+option ruby_package = "Temporalio::Api::WorkflowService::V1";
+option csharp_namespace = "Temporalio.Api.WorkflowService.V1";
 
 
 import "temporal/api/workflowservice/v1/request_response.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;
 }
 
 

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

@@ -1,14 +1,13 @@
 syntax = "proto3";
 
 package coresdk.child_workflow;
+option ruby_package = "Temporalio::Bridge::Api::ChildWorkflow";
 
 import "temporal/api/common/v1/message.proto";
 import "temporal/api/failure/v1/message.proto";
 import "temporal/sdk/core/common/common.proto";
 
-/**
- * Used by core to resolve child workflow executions.
- */
+// Used by core to resolve child workflow executions.
 message ChildWorkflowResult {
     oneof status {
         Success completed = 1;
@@ -17,61 +16,51 @@ message ChildWorkflowResult {
     }
 }
 
-/**
- * Used in ChildWorkflowResult to report successful completion.
- */
+// Used in ChildWorkflowResult to report successful completion.
 message Success {
     temporal.api.common.v1.Payload result = 1;
 }
 
-/**
- * Used in ChildWorkflowResult to report non successful outcomes such as
- * application failures, timeouts, terminations, and cancellations.
- */
+// Used in ChildWorkflowResult to report non successful outcomes such as
+// application failures, timeouts, terminations, and cancellations.
 message Failure {
     temporal.api.failure.v1.Failure failure = 1;
 }
 
-/**
- * Used in ChildWorkflowResult to report cancellation.
- * Failure should be ChildWorkflowFailure with a CanceledFailure cause.
- */
+// Used in ChildWorkflowResult to report cancellation.
+// Failure should be ChildWorkflowFailure with a CanceledFailure cause.
 message Cancellation {
     temporal.api.failure.v1.Failure failure = 1;
 }
 
-/**
- * Used by the service to determine the fate of a child workflow
- * in case its parent is closed.
- */
+// Used by the service to determine the fate of a child workflow
+// in case its parent is closed.
 enum ParentClosePolicy {
-    /** Let's the server set the default. */
+    // Let's the server set the default.
     PARENT_CLOSE_POLICY_UNSPECIFIED = 0;
-    /** Terminate means terminating the child workflow. */
+    // Terminate means terminating the child workflow.
     PARENT_CLOSE_POLICY_TERMINATE = 1;
-    /** Abandon means not doing anything on the child workflow. */
+    // Abandon means not doing anything on the child workflow.
     PARENT_CLOSE_POLICY_ABANDON = 2;
-    /** Cancel means requesting cancellation on the child workflow. */
+    // Cancel means requesting cancellation on the child workflow.
     PARENT_CLOSE_POLICY_REQUEST_CANCEL = 3;
 }
 
-/** Possible causes of failure to start a child workflow */
+// Possible causes of failure to start a child workflow
 enum StartChildWorkflowExecutionFailedCause {
     START_CHILD_WORKFLOW_EXECUTION_FAILED_CAUSE_UNSPECIFIED = 0;
     START_CHILD_WORKFLOW_EXECUTION_FAILED_CAUSE_WORKFLOW_ALREADY_EXISTS = 1;
 }
 
-/**
- * Controls at which point to report back to lang when a child workflow is cancelled
- */
+// Controls at which point to report back to lang when a child workflow is cancelled
 enum ChildWorkflowCancellationType {
-    /** Do not request cancellation of the child workflow if already scheduled */
+    // Do not request cancellation of the child workflow if already scheduled
     ABANDON = 0;
-    /** Initiate a cancellation request and immediately report cancellation to the parent. */
+    // Initiate a cancellation request and immediately report cancellation to the parent.
     TRY_CANCEL = 1;
-    /** Wait for child cancellation completion. */
+    // Wait for child cancellation completion.
     WAIT_CANCELLATION_COMPLETED = 2;
-    /** Request cancellation of the child and wait for confirmation that the request was received. */
+    // Request cancellation of the child and wait for confirmation that the request was received.
     WAIT_CANCELLATION_REQUESTED = 3;
 }
 

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

@@ -1,6 +1,7 @@
 syntax = "proto3";
 
 package coresdk.common;
+option ruby_package = "Temporalio::Bridge::Api::Common";
 
 import "google/protobuf/duration.proto";
 

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

@@ -1,6 +1,7 @@
 syntax = "proto3";
 
 package coresdk;
+option ruby_package = "Temporalio::Bridge::Api::CoreInterface";
 
 // Note: Intellij will think the Google imports don't work because of the slightly odd nature of
 // the include paths. You can make it work by going to the "Protobuf Support" settings section