@temporalio/core-bridge 1.9.2 → 1.10.0

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

@@ -103,7 +103,31 @@ message WorkflowExecutionStartedEventAttributes {
     string workflow_id = 28;
     // If this workflow intends to use anything other than the current overall default version for
     // the queue, then we include it here.
+    // Deprecated. use `inherited_build_id` instead
     temporal.api.common.v1.WorkerVersionStamp source_version_stamp = 29;
+    // Completion callbacks attached when this workflow was started.
+    repeated temporal.api.common.v1.Callback completion_callbacks = 30;
+
+    // Contains information about the root workflow execution.
+    // The root workflow execution is defined as follows:
+    // 1. A workflow without parent workflow is its own root workflow.
+    // 2. A workflow that has a parent workflow has the same root workflow as its parent workflow.
+    // Note: workflows continued as new or reseted may or may not have parents, check examples below.
+    //
+    // Examples:
+    //   Scenario 1: Workflow W1 starts child workflow W2, and W2 starts child workflow W3.
+    //     - The root workflow of all three workflows is W1.
+    //   Scenario 2: Workflow W1 starts child workflow W2, and W2 continued as new W3.
+    //     - The root workflow of all three workflows is W1.
+    //   Scenario 3: Workflow W1 continued as new W2.
+    //     - The root workflow of W1 is W1 and the root workflow of W2 is W2.
+    //   Scenario 4: Workflow W1 starts child workflow W2, and W2 is reseted, creating W3
+    //     - The root workflow of all three workflows is W1.
+    //   Scenario 5: Workflow W1 is reseted, creating W2.
+    //     - The root workflow of W1 is W1 and the root workflow of W2 is W2.
+    temporal.api.common.v1.WorkflowExecution root_workflow_execution = 31;
+    // When present, this execution is assigned to the build ID of its parent or previous execution.
+    string inherited_build_id = 32;
 }
 
 message WorkflowExecutionCompletedEventAttributes {
@@ -156,9 +180,9 @@ message WorkflowExecutionContinuedAsNewEventAttributes {
     temporal.api.common.v1.Header header = 12;
     temporal.api.common.v1.Memo memo = 13;
     temporal.api.common.v1.SearchAttributes search_attributes = 14;
-    // If this is set, the workflow executing this command wishes to continue as new using a version
-    // compatible with the version that this workflow most recently ran on.
-    bool use_compatible_version = 15;
+    // If this is set, the new execution inherits the Build ID of the current execution. Otherwise,
+    // the assignment rules will be used to independently assign a Build ID to the new execution.
+    bool inherit_build_id = 15;
 
     // workflow_execution_timeout is omitted as it shouldn't be overridden from within a workflow.
 }
@@ -189,6 +213,11 @@ message WorkflowTaskStartedEventAttributes {
     // continue-as-new regardless of the suggestion. Note that history event count is
     // just the event id of this event, so we don't include it explicitly here.
     int64 history_size_bytes = 5;
+    // Version info of the worker to whom this task was dispatched.
+    temporal.api.common.v1.WorkerVersionStamp worker_version = 6;
+    // Used by server internally to properly reapply build ID redirects to an execution
+    // when rebuilding it from events.
+    int64 build_id_redirect_counter = 7;
 }
 
 message WorkflowTaskCompletedEventAttributes {
@@ -203,6 +232,7 @@ message WorkflowTaskCompletedEventAttributes {
     // Version info of the worker who processed this workflow task. If present, the `build_id` field
     // within is also used as `binary_checksum`, which may be omitted in that case (it may also be
     // populated to preserve compatibility).
+    // Deprecated. Use the info inside the corresponding WorkflowTaskStartedEvent
     temporal.api.common.v1.WorkerVersionStamp worker_version = 5;
     // Data the SDK wishes to record for itself, but server need not interpret, and does not
     // directly impact workflow state.
@@ -242,6 +272,7 @@ message WorkflowTaskFailedEventAttributes {
     // Version info of the worker who processed this workflow task. If present, the `build_id` field
     // within is also used as `binary_checksum`, which may be omitted in that case (it may also be
     // populated to preserve compatibility).
+    // Deprecated. Use the info inside the corresponding WorkflowTaskStartedEvent
     temporal.api.common.v1.WorkerVersionStamp worker_version = 10;
 }
 
@@ -283,10 +314,9 @@ message ActivityTaskScheduledEventAttributes {
     // configuration. Retries will happen up to `schedule_to_close_timeout`. To disable retries set
     // retry_policy.maximum_attempts to 1.
     temporal.api.common.v1.RetryPolicy retry_policy = 12;
-    // If this is set, the workflow executing this command wishes to start the activity using
-    // a version compatible with the version that this workflow most recently ran on, if such
-    // behavior is possible.
-    bool use_compatible_version = 13;
+    // If this is set, the activity would be assigned to the Build ID of the workflow. Otherwise,
+    // Assignment rules of the activity's Task Queue will be used to determine the Build ID.
+    bool use_workflow_build_id = 13;
 }
 
 message ActivityTaskStartedEventAttributes {
@@ -301,6 +331,11 @@ message ActivityTaskStartedEventAttributes {
     // Will be set to the most recent failure details, if this task has previously failed and then
     // been retried.
     temporal.api.failure.v1.Failure last_failure = 5;
+    // Version info of the worker to whom this task was dispatched.
+    temporal.api.common.v1.WorkerVersionStamp worker_version = 6;
+    // Used by server internally to properly reapply build ID redirects to an execution
+    // when rebuilding it from events.
+    int64 build_id_redirect_counter = 7;
 }
 
 message ActivityTaskCompletedEventAttributes {
@@ -313,6 +348,7 @@ message ActivityTaskCompletedEventAttributes {
     // id of the worker that completed this task
     string identity = 4;
     // Version info of the worker who processed this workflow task.
+    // Deprecated. Use the info inside the corresponding ActivityTaskStartedEvent
     temporal.api.common.v1.WorkerVersionStamp worker_version = 5;
 }
 
@@ -327,6 +363,7 @@ message ActivityTaskFailedEventAttributes {
     string identity = 4;
     temporal.api.enums.v1.RetryState retry_state = 5;
     // Version info of the worker who processed this workflow task.
+    // Deprecated. Use the info inside the corresponding ActivityTaskStartedEvent
     temporal.api.common.v1.WorkerVersionStamp worker_version = 6;
 }
 
@@ -361,6 +398,7 @@ message ActivityTaskCanceledEventAttributes {
     // id of the worker who canceled this activity
     string identity = 5;
     // Version info of the worker who processed this workflow task.
+    // Deprecated. Use the info inside the corresponding ActivityTaskStartedEvent
     temporal.api.common.v1.WorkerVersionStamp worker_version = 6;
 }
 
@@ -581,10 +619,9 @@ message StartChildWorkflowExecutionInitiatedEventAttributes {
     temporal.api.common.v1.Header header = 15;
     temporal.api.common.v1.Memo memo = 16;
     temporal.api.common.v1.SearchAttributes search_attributes = 17;
-    // If this is set, the workflow executing this command wishes to start the child workflow using
-    // a version compatible with the version that this workflow most recently ran on, if such
-    // behavior is possible.
-    bool use_compatible_version = 19;
+    // If this is set, the child workflow inherits the Build ID of the parent. Otherwise, the assignment
+    // rules of the child's Task Queue will be used to independently assign a Build ID to it.
+    bool inherit_build_id = 19;
 }
 
 message StartChildWorkflowExecutionFailedEventAttributes {
@@ -750,11 +787,93 @@ message WorkflowExecutionUpdateRejectedEventAttributes {
     temporal.api.failure.v1.Failure failure = 5;
 }
 
-message WorkflowExecutionUpdateRequestedEventAttributes {
+message WorkflowExecutionUpdateAdmittedEventAttributes {
     // The update request associated with this event.
     temporal.api.update.v1.Request request = 1;
-    // A record of why this event was written to history.
-    temporal.api.enums.v1.UpdateRequestedEventOrigin origin = 2;
+    // An explanation of why this event was written to history.
+    temporal.api.enums.v1.UpdateAdmittedEventOrigin origin = 2;
+}
+
+// Event marking that an operation was scheduled by a workflow via the ScheduleNexusOperation command.
+message NexusOperationScheduledEventAttributes {
+    // Endpoint name, must exist in the endpoint registry.
+    string endpoint = 1;
+    // Service name.
+    string service = 2;
+    // Operation name.
+    string operation = 3;
+    // Input for the operation. The server converts this into Nexus request content and the appropriate content headers
+    // internally when sending the StartOperation request. On the handler side, if it is also backed by Temporal, the
+    // content is transformed back to the original Payload stored in this event.
+    temporal.api.common.v1.Payload input = 4;
+    // Schedule-to-close timeout for this operation.
+    // Indicates how long the caller is willing to wait for operation completion.
+    // Calls are retried internally by the server.
+    // (-- api-linter: core::0140::prepositions=disabled
+    //     aip.dev/not-precedent: "to" is used to indicate interval. --)
+    google.protobuf.Duration schedule_to_close_timeout = 5;
+    // Header to attach to the Nexus request. Note these headers are not the same as Temporal headers on internal
+    // activities and child workflows, these are transmitted to Nexus operations that may be external and are not
+    // traditional payloads.
+    map<string, string> nexus_header = 6;
+    // The `WORKFLOW_TASK_COMPLETED` event that the corresponding ScheduleNexusOperation command was reported with.
+    int64 workflow_task_completed_event_id = 7;
+    // A unique ID generated by the history service upon creation of this event.
+    // The ID will be transmitted with all nexus StartOperation requests and is used as an idempotentency key.
+    string request_id = 8;
+}
+
+// Event marking an asynchronous operation was started by the responding Nexus handler.
+// If the operation completes synchronously, this event is not generated.
+// In rare situations, such as request timeouts, the service may fail to record the actual start time and will fabricate
+// this event upon receiving the operation completion via callback.
+message NexusOperationStartedEventAttributes {
+    // The ID of the `NEXUS_OPERATION_SCHEDULED` event this task corresponds to.
+    int64 scheduled_event_id = 1;
+    // The operation ID returned by the Nexus handler in the response to the StartOperation request.
+    // This ID is used when canceling the operation.
+    string operation_id = 3;
+}
+
+// Nexus operation completed successfully.
+message NexusOperationCompletedEventAttributes {
+    // The ID of the `NEXUS_OPERATION_SCHEDULED` event. Uniquely identifies this operation.
+    int64 scheduled_event_id = 1;
+    // Serialized result of the Nexus operation. The response of the Nexus handler.
+    // Delivered either via a completion callback or as a response to a synchronous operation.
+    temporal.api.common.v1.Payload result = 2;
+}
+
+// Nexus operation failed.
+message NexusOperationFailedEventAttributes {
+    // The ID of the `NEXUS_OPERATION_SCHEDULED` event. Uniquely identifies this operation.
+    int64 scheduled_event_id = 1;
+    // Failure details. A NexusOperationFailureInfo wrapping an ApplicationFailureInfo.
+    temporal.api.failure.v1.Failure failure = 2;
+}
+
+// Nexus operation timed out.
+message NexusOperationTimedOutEventAttributes {
+    // The ID of the `NEXUS_OPERATION_SCHEDULED` event. Uniquely identifies this operation.
+    int64 scheduled_event_id = 1;
+    // Failure details. A NexusOperationFailureInfo wrapping a CanceledFailureInfo.
+    temporal.api.failure.v1.Failure failure = 2;
+}
+
+// Nexus operation completed as canceled. May or may not have been due to a cancellation request by the workflow.
+message NexusOperationCanceledEventAttributes {
+    // The ID of the `NEXUS_OPERATION_SCHEDULED` event. Uniquely identifies this operation.
+    int64 scheduled_event_id = 1;
+    // Cancellation details.
+    temporal.api.failure.v1.Failure failure = 2;
+}
+
+message NexusOperationCancelRequestedEventAttributes {
+    // The id of the `NEXUS_OPERATION_SCHEDULED` event this cancel request corresponds to.
+    int64 scheduled_event_id = 1;
+    // The `WORKFLOW_TASK_COMPLETED` event that the corresponding RequestCancelNexusOperation command was reported
+    // with.
+    int64 workflow_task_completed_event_id = 2;
 }
 
 // History events are the method by which Temporal SDKs advance (or recreate) workflow state.
@@ -821,7 +940,14 @@ message HistoryEvent {
         WorkflowPropertiesModifiedExternallyEventAttributes workflow_properties_modified_externally_event_attributes = 49;
         ActivityPropertiesModifiedExternallyEventAttributes activity_properties_modified_externally_event_attributes = 50;
         WorkflowPropertiesModifiedEventAttributes workflow_properties_modified_event_attributes = 51;
-        WorkflowExecutionUpdateRequestedEventAttributes workflow_execution_update_requested_event_attributes = 52;
+        WorkflowExecutionUpdateAdmittedEventAttributes workflow_execution_update_admitted_event_attributes = 52;
+        NexusOperationScheduledEventAttributes nexus_operation_scheduled_event_attributes = 53;
+        NexusOperationStartedEventAttributes nexus_operation_started_event_attributes = 54;
+        NexusOperationCompletedEventAttributes nexus_operation_completed_event_attributes = 55;
+        NexusOperationFailedEventAttributes nexus_operation_failed_event_attributes = 56;
+        NexusOperationCanceledEventAttributes nexus_operation_canceled_event_attributes = 57;
+        NexusOperationTimedOutEventAttributes nexus_operation_timed_out_event_attributes = 58;
+        NexusOperationCancelRequestedEventAttributes nexus_operation_cancel_requested_event_attributes = 59;
     }
 }
 

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

@@ -45,6 +45,18 @@ message NamespaceInfo {
     // A key-value map for any customized purpose.
     map<string, string> data = 5;
     string id = 6;
+    // All capabilities the namespace supports.
+    Capabilities capabilities = 7;
+
+    // Namespace capability details. Should contain what features are enabled in a namespace.
+    message Capabilities {
+        // True if the namespace supports eager workflow start.
+        bool eager_workflow_start = 1;
+        // True if the namespace supports sync update
+        bool sync_update = 2;
+        // True if the namespace supports async update
+        bool async_update = 3;
+    }
 
     // Whether scheduled workflows are supported on this namespace. This is only needed
     // temporarily while the feature is experimental, so we can give it a high tag.

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

@@ -0,0 +1,193 @@
+// The MIT License
+//
+// Copyright (c) 2023 Temporal Technologies Inc. All rights reserved.
+//
+// Permission is hereby granted, free of charge, to any person obtaining a copy
+// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+// copies of the Software, and to permit persons to whom the Software is
+// furnished to do so, subject to the following conditions:
+//
+// The above copyright notice and this permission notice shall be included in
+// all copies or substantial portions of the Software.
+//
+// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+// THE SOFTWARE.
+
+syntax = "proto3";
+
+package temporal.api.nexus.v1;
+
+option go_package = "go.temporal.io/api/nexus/v1;nexus";
+option java_package = "io.temporal.api.nexus.v1";
+option java_multiple_files = true;
+option java_outer_classname = "MessageProto";
+option ruby_package = "Temporalio::Api::Nexus::V1";
+option csharp_namespace = "Temporalio.Api.Nexus.V1";
+
+import "google/protobuf/timestamp.proto";
+import "temporal/api/common/v1/message.proto";
+
+// A general purpose failure message.
+// See: https://github.com/nexus-rpc/api/blob/main/SPEC.md#failure
+message Failure {
+    string message = 1;
+    map<string, string> metadata = 2;
+    bytes details = 3;
+}
+
+message HandlerError {
+    // See https://github.com/nexus-rpc/api/blob/main/SPEC.md#predefined-handler-errors.
+    string error_type = 1;
+    Failure failure = 2;
+}
+
+message UnsuccessfulOperationError {
+    // See https://github.com/nexus-rpc/api/blob/main/SPEC.md#operationinfo.
+    string operation_state = 1;
+    Failure failure = 2;
+}
+
+// A request to start an operation.
+message StartOperationRequest {
+    // Name of service to start the operation in.
+    string service = 1;
+    // Type of operation to start.
+    string operation = 2;
+    // A request ID that can be used as an idempotentency key.
+    string request_id = 3;
+    // Callback URL to call upon completion if the started operation is async.
+    string callback = 4;
+    // Full request body from the incoming HTTP request.
+    temporal.api.common.v1.Payload payload = 5;
+    // Header that is expected to be attached to the callback request when the operation completes.
+    map<string, string> callback_header = 6;
+}
+
+// A request to cancel an operation.
+message CancelOperationRequest {
+    // Service name.
+    string service = 1;
+    // Type of operation to cancel.
+    string operation = 2;
+    // Operation ID as originally generated by a Handler.
+    string operation_id = 3;
+}
+
+// A Nexus request.
+message Request {
+    // Headers extracted from the original request in the Temporal frontend.
+    // When using Nexus over HTTP, this includes the request's HTTP headers ignoring multiple values.
+    map<string, string> header = 1;
+
+    // The timestamp when the request was scheduled in the frontend.
+    // (-- api-linter: core::0142::time-field-names=disabled
+    //     aip.dev/not-precedent: Not following linter rules. --)
+    google.protobuf.Timestamp scheduled_time = 2;
+
+    oneof variant {
+        StartOperationRequest start_operation = 3;
+        CancelOperationRequest cancel_operation = 4;
+    }
+}
+
+// Response variant for StartOperationRequest.
+message StartOperationResponse {
+    // An operation completed successfully.
+    message Sync {
+        temporal.api.common.v1.Payload payload = 1;
+    }
+
+    // The operation will complete asynchronously.
+    // The returned ID can be used to reference this operation.
+    message Async {
+        string operation_id = 1;
+    }
+
+    oneof variant {
+        Sync sync_success = 1;
+        Async async_success = 2;
+        // The operation completed unsuccessfully (failed or canceled).
+        UnsuccessfulOperationError operation_error = 3;
+    }
+}
+
+// Response variant for CancelOperationRequest.
+message CancelOperationResponse {
+}
+
+// A response indicating that the handler has successfully processed a request.
+message Response {
+    // Variant must correlate to the corresponding Request's variant.
+    oneof variant {
+        StartOperationResponse start_operation = 1;
+        CancelOperationResponse cancel_operation = 2;
+    }
+}
+
+// A cluster-global binding from an endpoint ID to a target for dispatching incoming Nexus requests.
+message Endpoint {
+    // Data version for this endpoint, incremented for every update issued via the UpdateNexusEndpoint API.
+    int64 version = 1;
+    // Unique server-generated endpoint ID.
+    string id = 2;
+    // Spec for the endpoint.
+    EndpointSpec spec = 3;
+
+    // The date and time when the endpoint was created.
+    // (-- api-linter: core::0142::time-field-names=disabled
+    //     aip.dev/not-precedent: Not following linter rules. --)
+    google.protobuf.Timestamp created_time = 4;
+
+    // The date and time when the endpoint was last modified.
+    // Will not be set if the endpoint has never been modified.
+    // (-- api-linter: core::0142::time-field-names=disabled
+    //     aip.dev/not-precedent: Not following linter rules. --)
+    google.protobuf.Timestamp last_modified_time = 5;
+
+    // Server exposed URL prefix for invocation of operations on this endpoint.
+    // This doesn't include the protocol, hostname or port as the server does not know how it should be accessed
+    // publicly. The URL is stable in the face of endpoint renames.
+    string url_prefix = 6;
+}
+
+// Contains mutable fields for an Endpoint.
+message EndpointSpec {
+    // Endpoint name, unique for this cluster. Must match `[a-zA-Z_][a-zA-Z0-9_]*`.
+    // Renaming an endpoint breaks all workflow callers that reference this endpoint, causing operations to fail.
+    string name = 1;
+    // Markdown description serialized as a single JSON string.
+    // If the Payload is encrypted, the UI and CLI may decrypt with the configured codec server endpoint.
+    temporal.api.common.v1.Payload description = 2;
+
+    // Target to route requests to.
+    EndpointTarget target = 3;
+}
+
+// Target to route requests to.
+message EndpointTarget {
+    // Target a worker polling on a Nexus task queue in a specific namespace.
+    message Worker {
+        // Namespace to route requests to.
+        string namespace = 1;
+        // Nexus task queue to route requests to.
+        string task_queue = 2;
+    }
+  
+    // Target an external server by URL.
+    // At a later point, this will support providing credentials, in the meantime, an http.RoundTripper can be injected
+    // into the server to modify the request.
+    message External {
+        // URL to call.
+        string url = 1;
+    }
+
+    oneof variant {
+        Worker worker = 1;
+        External external = 2;
+    }
+}

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

@@ -32,6 +32,8 @@ option ruby_package = "Temporalio::Api::OperatorService::V1";
 option csharp_namespace = "Temporalio.Api.OperatorService.V1";
 
 import "temporal/api/enums/v1/common.proto";
+import "temporal/api/nexus/v1/message.proto";
+import "google/protobuf/duration.proto";
 
 // (-- Search Attribute --)
 
@@ -66,14 +68,13 @@ message ListSearchAttributesResponse {
     map<string, string> storage_schema = 3;
 }
 
-// (-- 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 DeleteNamespaceRequest {
     // Only one of namespace or namespace_id must be specified to identify namespace.
     string namespace = 1;
     string namespace_id = 2;
+    // If provided, the deletion of namespace info will be delayed for the given duration (0 means no delay).
+    // If not provided, the default delay configured in the cluster will be used.
+    google.protobuf.Duration namespace_delete_delay = 3;
 }
 
 message DeleteNamespaceResponse {
@@ -82,10 +83,13 @@ message DeleteNamespaceResponse {
 }
 
 message AddOrUpdateRemoteClusterRequest {
-    // Frontend Address is a cross cluster accessible address.
+    // Frontend Address is a cross cluster accessible address for gRPC traffic. This field is required.
     string frontend_address = 1;
     // Flag to enable / disable the cross cluster connection.
     bool enable_remote_cluster_connection = 2;
+    // Frontend HTTP Address is a cross cluster accessible address for HTTP traffic. This field is optional. If not provided
+    //  on update, the existing HTTP address will be removed.
+    string frontend_http_address = 3;
 }
 
 message AddOrUpdateRemoteClusterResponse {
@@ -115,8 +119,10 @@ message ClusterMetadata {
     string cluster_name = 1;
     // Id of the cluster.
     string cluster_id = 2;
-    // Cluster accessible address.
+    // gRPC address.
     string address = 3;
+    // HTTP address, if one exists.
+    string http_address = 7;
     // A unique failover version across all connected clusters.
     int64 initial_failover_version = 4;
     // History service shard number.
@@ -124,3 +130,64 @@ message ClusterMetadata {
     // A flag to indicate if a connection is active.
     bool is_connection_enabled = 6;
 }
+
+message GetNexusEndpointRequest {
+    // Server-generated unique endpoint ID.
+    string id = 1;
+}
+
+message GetNexusEndpointResponse {
+    temporal.api.nexus.v1.Endpoint endpoint = 1;
+}
+
+message CreateNexusEndpointRequest {
+    // Endpoint definition to create.
+    temporal.api.nexus.v1.EndpointSpec spec = 1;
+}
+
+message CreateNexusEndpointResponse {
+    // Data post acceptance. Can be used to issue additional updates to this record.
+    temporal.api.nexus.v1.Endpoint endpoint = 1;
+}
+
+message UpdateNexusEndpointRequest {
+    // Server-generated unique endpoint ID.
+    string id = 1;
+    // Data version for this endpoint. Must match current version.
+    int64 version = 2;
+
+    temporal.api.nexus.v1.EndpointSpec spec = 3;
+}
+
+message UpdateNexusEndpointResponse {
+    // Data post acceptance. Can be used to issue additional updates to this record.
+    temporal.api.nexus.v1.Endpoint endpoint = 1;
+}
+
+message DeleteNexusEndpointRequest {
+    // Server-generated unique endpoint ID.
+    string id = 1;
+    // Data version for this endpoint. Must match current version.
+    int64 version = 2;
+}
+
+message DeleteNexusEndpointResponse {
+}
+
+message ListNexusEndpointsRequest {
+    int32 page_size = 1;
+    // To get the next page, pass in `ListNexusEndpointsResponse.next_page_token` from the previous page's
+    // response, the token will be empty if there's no other page.
+    // Note: the last page may be empty if the total number of endpoints registered is a multiple of the page size.
+    bytes next_page_token = 2;
+    // Name of the incoming endpoint to filter on - optional. Specifying this will result in zero or one results.
+    // (-- api-linter: core::203::field-behavior-required=disabled
+    //     aip.dev/not-precedent: Not following linter rules. --)
+    string name = 3;
+}
+
+message ListNexusEndpointsResponse {
+    // Token for getting the next page.
+    bytes next_page_token = 1;
+    repeated temporal.api.nexus.v1.Endpoint endpoints = 2;
+}

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

@@ -63,10 +63,6 @@ service OperatorService {
     }
 
     // DeleteNamespace synchronously deletes a namespace and asynchronously reclaims all namespace resources.
-    // (-- 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
-    //     aip.dev/not-precedent: DeleteNamespace RPC doesn't follow Google API format. --)
     rpc DeleteNamespace (DeleteNamespaceRequest) returns (DeleteNamespaceResponse) {
     }
 
@@ -81,4 +77,50 @@ service OperatorService {
     // ListClusters returns information about Temporal clusters.
     rpc ListClusters(ListClustersRequest) returns (ListClustersResponse) {
     }
+
+    // Get a registered Nexus endpoint by ID. The returned version can be used for optimistic updates.
+    rpc GetNexusEndpoint(GetNexusEndpointRequest) returns (GetNexusEndpointResponse) {
+        option (google.api.http) = {
+            get: "/api/v1/nexus/endpoints/{id}"
+        };
+    }
+
+    // Create a Nexus endpoint. This will fail if an endpoint with the same name is already registered with a status of
+    // ALREADY_EXISTS.
+    // Returns the created endpoint with its initial version. You may use this version for subsequent updates.
+    rpc CreateNexusEndpoint(CreateNexusEndpointRequest) returns (CreateNexusEndpointResponse) {
+        option (google.api.http) = {
+            post: "/api/v1/nexus/endpoints"
+            body: "*"
+        };
+    }
+
+    // Optimistically update a Nexus endpoint based on provided version as obtained via the `GetNexusEndpoint` or
+    // `ListNexusEndpointResponse` APIs. This will fail with a status of FAILED_PRECONDITION if the version does not
+    // match.
+    // Returns the updated endpoint with its updated version. You may use this version for subsequent updates. You don't
+    // need to increment the version yourself. The server will increment the version for you after each update.
+    rpc UpdateNexusEndpoint(UpdateNexusEndpointRequest) returns (UpdateNexusEndpointResponse) {
+        option (google.api.http) = {
+            post: "/api/v1/nexus/endpoints/{id}/update"
+            body: "*"
+        };
+    }
+
+    // Delete an incoming Nexus service by ID.
+    rpc DeleteNexusEndpoint(DeleteNexusEndpointRequest) returns (DeleteNexusEndpointResponse) {
+        option (google.api.http) = {
+            delete: "/api/v1/nexus/endpoints/{id}"
+        };
+    }
+
+    // List all Nexus endpoints for the cluster, sorted by ID in ascending order. Set page_token in the request to the
+    // next_page_token field of the previous response to get the next page of results. An empty next_page_token
+    // indicates that there are no more results. During pagination, a newly added service with an ID lexicographically
+    // earlier than the previous page's last endpoint's ID may be missed.
+    rpc ListNexusEndpoints(ListNexusEndpointsRequest) returns (ListNexusEndpointsResponse) {
+        option (google.api.http) = {
+            get: "/api/v1/nexus/endpoints"
+        };
+    }
 }

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

@@ -243,6 +243,10 @@ message SchedulePolicies {
     // This applies after retry policies: the full chain of retries must fail to
     // trigger a pause here.
     bool pause_on_failure = 3;
+
+    // If true, and the action would start a workflow, a timestamp will not be
+    // appended to the scheduled workflow id.
+    bool keep_original_workflow_id = 4;
 }
 
 message ScheduleAction {

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

@@ -31,7 +31,7 @@ option java_outer_classname = "WorkflowMetadataProto";
 option ruby_package = "Temporalio::Api::Sdk::V1";
 option csharp_namespace = "Temporalio.Api.Sdk.V1";
 
-// The name of the query to retrieve this information is `__temporal_getWorkflowMetadata`.
+// The name of the query to retrieve this information is `__temporal_workflow_metadata`.
 message WorkflowMetadata {
   // Metadata provided at declaration or creation time.
   WorkflowDefinition definition = 1;
@@ -62,5 +62,5 @@ message WorkflowInteractionDefinition {
   // An optional interaction description provided by the application.
   // By convention, external tools may interpret its first part,
   // i.e., ending with a line break, as a summary of the description.
-  string description = 2; 
+  string description = 2;
 }