@temporalio/core-bridge 1.11.7 → 1.11.8

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

@@ -39,6 +39,7 @@ import "temporal/api/common/v1/message.proto";
 
 import "temporal/api/enums/v1/failed_cause.proto";
 import "temporal/api/enums/v1/namespace.proto";
+import "temporal/api/failure/v1/message.proto";
 
 message NotFoundFailure {
     string current_cluster = 1;
@@ -56,6 +57,13 @@ message NamespaceNotActiveFailure {
     string active_cluster = 3;
 }
 
+// NamespaceUnavailableFailure is returned by the service when a request addresses a namespace that is unavailable. For
+// example, when a namespace is in the process of failing over between clusters.
+// This is a transient error that should be automatically retried by clients.
+message NamespaceUnavailableFailure {
+    string namespace = 1;
+}
+
 message NamespaceInvalidStateFailure {
     string namespace = 1;
     // Current state of the requested namespace.
@@ -87,6 +95,10 @@ message CancellationAlreadyRequestedFailure {
 }
 
 message QueryFailedFailure {
+    // The full reason for this query failure. May not be available if the response is generated by an old
+    // SDK. This field can be encoded by the SDK's failure converter to support E2E encryption of messages and stack
+    // traces.
+    temporal.api.failure.v1.Failure failure = 1;
 }
 
 message PermissionDeniedFailure {
@@ -130,4 +142,4 @@ message MultiOperationExecutionFailure {
         string message = 2;
         repeated google.protobuf.Any details = 3;
     }
-}
+}

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

@@ -33,6 +33,7 @@ option csharp_namespace = "Temporalio.Api.Failure.V1";
 
 import "temporal/api/common/v1/message.proto";
 import "temporal/api/enums/v1/workflow.proto";
+import "temporal/api/enums/v1/nexus.proto";
 
 import "google/protobuf/duration.proto";
 
@@ -95,7 +96,19 @@ message NexusOperationFailureInfo {
     // Operation name.
     string operation = 4;
     // Operation ID - may be empty if the operation completed synchronously.
+    //
+    // Deprecated: Renamed to operation_token.
     string operation_id = 5;
+    // Operation token - may be empty if the operation completed synchronously.
+    string operation_token = 6;
+}
+
+message NexusHandlerFailureInfo {
+    // The Nexus error type as defined in the spec:
+    // https://github.com/nexus-rpc/api/blob/main/SPEC.md#predefined-handler-errors.
+    string type = 1;
+    // Retry behavior, defaults to the retry behavior of the error type as defined in the spec.
+    temporal.api.enums.v1.NexusHandlerErrorRetryBehavior retry_behavior = 2;
 }
 
 message Failure {
@@ -131,6 +144,7 @@ message Failure {
         ActivityFailureInfo activity_failure_info = 11;
         ChildWorkflowExecutionFailureInfo child_workflow_execution_failure_info = 12;
         NexusOperationFailureInfo nexus_operation_execution_failure_info = 13;
+        NexusHandlerFailureInfo nexus_handler_failure_info = 14;
     }
 }
 

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

@@ -39,6 +39,7 @@ import "temporal/api/enums/v1/failed_cause.proto";
 import "temporal/api/enums/v1/update.proto";
 import "temporal/api/enums/v1/workflow.proto";
 import "temporal/api/common/v1/message.proto";
+import "temporal/api/deployment/v1/message.proto";
 import "temporal/api/failure/v1/message.proto";
 import "temporal/api/taskqueue/v1/message.proto";
 import "temporal/api/update/v1/message.proto";
@@ -104,7 +105,7 @@ 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
+    // Deprecated. [cleanup-experimental-wv]
     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;
@@ -128,7 +129,19 @@ message WorkflowExecutionStartedEventAttributes {
     //     - 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.
+    // Deprecated. This field should be cleaned up when versioning-2 API is removed. [cleanup-experimental-wv]
     string inherited_build_id = 32;
+    // Versioning override applied to this workflow when it was started.
+    temporal.api.workflow.v1.VersioningOverride versioning_override = 33;
+    // When present, it means this is a child workflow of a parent that is Pinned to this Worker
+    // Deployment Version. In this case, child workflow will start as Pinned to this Version instead
+    // of starting on the Current Version of its Task Queue.
+    // This is set only if the child workflow is starting on a Task Queue belonging to the same
+    // Worker Deployment Version.
+    string parent_pinned_worker_deployment_version = 34;
+
+    // Priority metadata
+    temporal.api.common.v1.Priority priority = 35;
 }
 
 message WorkflowExecutionCompletedEventAttributes {
@@ -215,9 +228,11 @@ message WorkflowTaskStartedEventAttributes {
     // 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.
+    // Deprecated. This field should be cleaned up when versioning-2 API is removed. [cleanup-experimental-wv]
     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.
+    // Deprecated. This field should be cleaned up when versioning-2 API is removed. [cleanup-experimental-wv]
     int64 build_id_redirect_counter = 7;
 }
 
@@ -233,7 +248,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
+    // Deprecated. Use `deployment` and `versioning_behavior` instead.
     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.
@@ -241,6 +256,24 @@ message WorkflowTaskCompletedEventAttributes {
 
     // Local usage data sent during workflow task completion and recorded here for posterity
     temporal.api.common.v1.MeteringMetadata metering_metadata = 13;
+
+    // The deployment that completed this task. May or may not be set for unversioned workers,
+    // depending on whether a value is sent by the SDK. This value updates workflow execution's
+    // `versioning_info.deployment`.
+    // Deprecated. Replaced with `worker_deployment_version`.
+    temporal.api.deployment.v1.Deployment deployment = 7 [deprecated = true];
+    // Versioning behavior sent by the worker that completed this task for this particular workflow
+    // execution. UNSPECIFIED means the task was completed by an unversioned worker. This value
+    // updates workflow execution's `versioning_info.behavior`.
+    temporal.api.enums.v1.VersioningBehavior versioning_behavior = 8;
+    // The Worker Deployment Version that completed this task. Must be set if `versioning_behavior`
+    // is set. This value updates workflow execution's `versioning_info.version`.
+    // Experimental. Worker Deployments are experimental and might significantly change in the future.
+    string worker_deployment_version = 9;
+    // The name of Worker Deployment that completed this task. Must be set if `versioning_behavior`
+    // is set. This value updates workflow execution's `worker_deployment_name`.
+    // Experimental. Worker Deployments are experimental and might significantly change in the future.
+    string worker_deployment_name = 10;
 }
 
 message WorkflowTaskTimedOutEventAttributes {
@@ -318,6 +351,9 @@ message ActivityTaskScheduledEventAttributes {
     // 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;
+    // Priority metadata. If this message is not present, or any fields are not
+    // present, they inherit the values from the workflow.
+    temporal.api.common.v1.Priority priority = 14;
 }
 
 message ActivityTaskStartedEventAttributes {
@@ -333,9 +369,11 @@ message ActivityTaskStartedEventAttributes {
     // been retried.
     temporal.api.failure.v1.Failure last_failure = 5;
     // Version info of the worker to whom this task was dispatched.
+    // Deprecated. This field should be cleaned up when versioning-2 API is removed. [cleanup-experimental-wv]
     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.
+    // Deprecated. This field should be cleaned up when versioning-2 API is removed. [cleanup-experimental-wv]
     int64 build_id_redirect_counter = 7;
 }
 
@@ -472,8 +510,8 @@ message WorkflowExecutionSignaledEventAttributes {
     // Headers that were passed by the sender of the signal and copied by temporal 
     // server into the workflow task.
     temporal.api.common.v1.Header header = 4;
-    // Indicates the signal did not generate a new workflow task when received.
-    bool skip_generate_workflow_task = 5;
+    // This field is deprecated and never respected. It should always be set to false.
+    bool skip_generate_workflow_task = 5 [deprecated = true];
     // When signal origin is a workflow execution, this field is set.
     temporal.api.common.v1.WorkflowExecution external_workflow_execution = 6;
 }
@@ -623,6 +661,8 @@ message StartChildWorkflowExecutionInitiatedEventAttributes {
     // 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;
+    // Priority metadata
+    temporal.api.common.v1.Priority priority = 20;
 }
 
 message StartChildWorkflowExecutionFailedEventAttributes {
@@ -723,19 +763,30 @@ message ChildWorkflowExecutionTerminatedEventAttributes {
     int64 started_event_id = 5;
 }
 
+message WorkflowExecutionOptionsUpdatedEventAttributes {
+    // Versioning override upserted in this event.
+    // Ignored if nil or if unset_versioning_override is true.
+    temporal.api.workflow.v1.VersioningOverride versioning_override = 1;
+    // Versioning override removed in this event.
+    bool unset_versioning_override = 2;
+    // Request ID attachedto the running workflow execution so that subsequent requests with same
+    // request ID will be deduped.
+    string attached_request_id = 3;
+    // Completion callbacks attached to the running workflow execution.
+    repeated temporal.api.common.v1.Callback attached_completion_callbacks = 4;
+}
+
+// Not used anywhere. Use case is replaced by WorkflowExecutionOptionsUpdatedEventAttributes
 message WorkflowPropertiesModifiedExternallyEventAttributes {
-    // If set to a nonempty string, future workflow tasks for this workflow shall be dispatched on
-    // the provided queue.
+    // Not used.
     string new_task_queue = 1;
-    // If set, update the workflow task timeout to this value.
+    // Not used.
     google.protobuf.Duration new_workflow_task_timeout = 2;
-    // If set, update the workflow run timeout to this value. May be set to 0 for no timeout.
+    // Not used.
     google.protobuf.Duration new_workflow_run_timeout = 3;
-    // If set, update the workflow execution timeout to this value. May be set to 0 for no timeout.
+    // Not used.
     google.protobuf.Duration new_workflow_execution_timeout = 4;
-    // 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.
+    // Not used.
     temporal.api.common.v1.Memo upserted_memo = 5;
 }
 
@@ -838,10 +889,16 @@ message NexusOperationStartedEventAttributes {
     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.
+    //
+    // Deprecated: Renamed to operation_token.
     string operation_id = 3;
 
     // The request ID allocated at schedule time.
     string request_id = 4;
+
+    // The operation token returned by the Nexus handler in the response to the StartOperation request.
+    // This token is used when canceling the operation.
+    string operation_token = 5;
 }
 
 // Nexus operation completed successfully.
@@ -980,6 +1037,7 @@ message HistoryEvent {
         NexusOperationCanceledEventAttributes nexus_operation_canceled_event_attributes = 57;
         NexusOperationTimedOutEventAttributes nexus_operation_timed_out_event_attributes = 58;
         NexusOperationCancelRequestedEventAttributes nexus_operation_cancel_requested_event_attributes = 59;
+        WorkflowExecutionOptionsUpdatedEventAttributes workflow_execution_options_updated_event_attributes = 60;
     }
 }
 

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

@@ -31,12 +31,14 @@ option csharp_namespace = "Temporalio.Api.Nexus.V1";
 
 import "google/protobuf/timestamp.proto";
 import "temporal/api/common/v1/message.proto";
+import "temporal/api/enums/v1/nexus.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;
+    // UTF-8 encoded JSON serializable details.
     bytes details = 3;
 }
 
@@ -44,6 +46,8 @@ message HandlerError {
     // See https://github.com/nexus-rpc/api/blob/main/SPEC.md#predefined-handler-errors.
     string error_type = 1;
     Failure failure = 2;
+    // Retry behavior, defaults to the retry behavior of the error type as defined in the spec.
+    temporal.api.enums.v1.NexusHandlerErrorRetryBehavior retry_behavior = 3;
 }
 
 message UnsuccessfulOperationError {
@@ -83,7 +87,12 @@ message CancelOperationRequest {
     // Type of operation to cancel.
     string operation = 2;
     // Operation ID as originally generated by a Handler.
+    //
+    // Deprecated: Renamed to operation_token.
     string operation_id = 3;
+
+    // Operation token as originally generated by a Handler.
+    string operation_token = 4;
 }
 
 // A Nexus request.
@@ -108,13 +117,16 @@ message StartOperationResponse {
     // An operation completed successfully.
     message Sync {
         temporal.api.common.v1.Payload payload = 1;
+        repeated Link links = 2;
     }
 
     // The operation will complete asynchronously.
     // The returned ID can be used to reference this operation.
     message Async {
+        // Deprecated: Renamed to operation_token.
         string operation_id = 1;
         repeated Link links = 2;
+        string operation_token = 3;
     }
 
     oneof variant {

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

@@ -34,6 +34,7 @@ option csharp_namespace = "Temporalio.Api.Query.V1";
 import "temporal/api/enums/v1/query.proto";
 import "temporal/api/enums/v1/workflow.proto";
 import "temporal/api/common/v1/message.proto";
+import "temporal/api/failure/v1/message.proto";
 
 // See https://docs.temporal.io/docs/concepts/queries/
 message WorkflowQuery {
@@ -41,7 +42,7 @@ message WorkflowQuery {
     string query_type = 1;
     // Serialized arguments that will be provided to the query handler.
     temporal.api.common.v1.Payloads query_args = 2;
-    // Headers that were passed by the caller of the query and copied by temporal 
+    // Headers that were passed by the caller of the query and copied by temporal
     // server into the workflow task.
     temporal.api.common.v1.Header header = 3;
 }
@@ -50,10 +51,16 @@ message WorkflowQuery {
 message WorkflowQueryResult {
     // Did the query succeed or fail?
     temporal.api.enums.v1.QueryResultType result_type = 1;
-    // Set when the query succeeds with the results
+    // Set when the query succeeds with the results.
+    // Mutually exclusive with `error_message` and `failure`.
     temporal.api.common.v1.Payloads answer = 2;
     // Mutually exclusive with `answer`. Set when the query fails.
+    // See also the newer `failure` field.
     string error_message = 3;
+    // The full reason for this query failure. This field is newer than `error_message` and can be encoded by the SDK's
+    // failure converter to support E2E encryption of messages and stack traces.
+    // Mutually exclusive with `answer`. Set when the query fails.
+    temporal.api.failure.v1.Failure failure = 4;
 }
 
 message QueryRejected {

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

@@ -37,6 +37,7 @@ import "google/protobuf/wrappers.proto";
 
 import "temporal/api/enums/v1/task_queue.proto";
 import "temporal/api/common/v1/message.proto";
+import "temporal/api/deployment/v1/message.proto";
 
 // See https://docs.temporal.io/docs/concepts/task-queues/
 message TaskQueue {
@@ -54,6 +55,34 @@ message TaskQueueMetadata {
     google.protobuf.DoubleValue max_tasks_per_second = 1;
 }
 
+// Experimental. Worker Deployments are experimental and might significantly change in the future.
+message TaskQueueVersioningInfo {
+    // Always present. Specifies which Deployment Version should receive new workflow
+    // executions and tasks of existing unversioned or AutoUpgrade workflows.
+    // Can be one of the following:
+    // - A Deployment Version identifier in the form "<deployment_name>.<build_id>".
+    // - Or, the "__unversioned__" special value, to represent all the unversioned workers (those
+    //   with `UNVERSIONED` (or unspecified) `WorkerVersioningMode`.)
+    // Note: Current Version is overridden by the Ramping Version for a portion of traffic when a ramp
+    // is set (see `ramping_version`.)
+    string current_version = 1;
+    // When present, it means the traffic is being shifted from the Current Version to the Ramping
+    // Version.
+    // Must always be different from `current_version`. Can be one of the following:
+    // - A Deployment Version identifier in the form "<deployment_name>.<build_id>".
+    // - Or, the "__unversioned__" special value, to represent all the unversioned workers (those
+    //   with `UNVERSIONED` (or unspecified) `WorkerVersioningMode`.)
+    // Note that it is possible to ramp from one Version to another Version, or from unversioned
+    // workers to a particular Version, or from a particular Version to unversioned workers.
+    string ramping_version = 2;
+    // Percentage of tasks that are routed to the Ramping Version instead of the Current Version.
+    // Valid range: [0, 100]. A 100% value means the Ramping Version is receiving full traffic but
+    // not yet "promoted" to be the Current Version, likely due to pending validations.
+    float ramping_version_percentage = 3;
+    // Last time versioning information of this Task Queue changed.
+    google.protobuf.Timestamp update_time = 4;
+}
+
 // Used for specifying versions the caller is interested in.
 message TaskQueueVersionSelection {
     // Include specific Build IDs.
@@ -163,7 +192,10 @@ message PollerInfo {
     double rate_per_second = 3;
     // If a worker has opted into the worker versioning feature while polling, its capabilities will
     // appear here.
-    temporal.api.common.v1.WorkerVersionCapabilities worker_version_capabilities = 4;
+    // Deprecated. Replaced by deployment_options.
+    temporal.api.common.v1.WorkerVersionCapabilities worker_version_capabilities = 4 [deprecated = true];
+    // Worker deployment options that SDK sent to server.
+    temporal.api.deployment.v1.WorkerDeploymentOptions deployment_options = 5;
 }
 
 message StickyExecutionAttributes {
@@ -291,4 +323,16 @@ message TimestampedBuildIdAssignmentRule {
 message TimestampedCompatibleBuildIdRedirectRule {
     CompatibleBuildIdRedirectRule rule = 1;
     google.protobuf.Timestamp create_time = 2;
-}
+}
+
+// Attached to task responses to give hints to the SDK about how it may adjust its number of
+// pollers.
+message PollerScalingDecision {
+  // How many poll requests to suggest should be added or removed, if any. As of now, server only
+  // scales up or down by 1. However, SDKs should allow for other values (while staying within
+  // defined min/max).
+  //
+  // The SDK is free to ignore this suggestion, EX: making more polls would not make sense because
+  // all slots are already occupied.
+  int32 poll_request_delta_suggestion = 1;
+}