@temporalio/core-bridge 1.12.0 → 1.12.2

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

@@ -77,10 +77,10 @@ message BatchOperationReset {
   // Describes what to reset to and how. If set, `reset_type` and `reset_reapply_type` are ignored.
   temporal.api.common.v1.ResetOptions options = 4;
 
-  // Reset type (deprecated, use `options`).
-  temporal.api.enums.v1.ResetType reset_type = 1;
-  // History event reapply options (deprecated, use `options`).
-  temporal.api.enums.v1.ResetReapplyType reset_reapply_type = 2;
+  // Deprecated. Use `options`.
+  temporal.api.enums.v1.ResetType reset_type = 1 [deprecated = true];
+  // Deprecated. Use `options`.
+  temporal.api.enums.v1.ResetReapplyType reset_reapply_type = 2 [deprecated = true];
   // Operations to perform after the workflow has been reset. These operations will be applied
   // to the *new* run of the workflow execution in the order they are provided.
   // All operations are applied to the workflow before the first new workflow task is generated

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

@@ -106,7 +106,7 @@ message RequestCancelExternalWorkflowExecutionCommandAttributes {
     string workflow_id = 2;
     string run_id = 3;
     // Deprecated.
-    string control = 4;
+    string control = 4 [deprecated = true];
     // Set this to true if the workflow being cancelled is a child of the workflow originating this
     // command. The request will be rejected if it is set to true and the target workflow is *not*
     // a child of the requesting workflow.
@@ -123,7 +123,7 @@ message SignalExternalWorkflowExecutionCommandAttributes {
     // Serialized value(s) to provide with the signal.
     temporal.api.common.v1.Payloads input = 4;
     // Deprecated
-    string control = 5;
+    string control = 5 [deprecated = true];
     // Set this to true if the workflow being cancelled is a child of the workflow originating this
     // command. The request will be rejected if it is set to true and the target workflow is *not*
     // a child of the requesting workflow.
@@ -176,7 +176,8 @@ message ContinueAsNewWorkflowExecutionCommandAttributes {
     temporal.api.common.v1.SearchAttributes search_attributes = 14;
     // 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;
+    // Deprecated. Only considered for versioning v0.2.
+    bool inherit_build_id = 15 [deprecated = true];
 
     // `workflow_execution_timeout` is omitted as it shouldn't be overridden from within a workflow.
 }
@@ -206,7 +207,8 @@ message StartChildWorkflowExecutionCommandAttributes {
     temporal.api.common.v1.SearchAttributes search_attributes = 16;
     // 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 = 17;
+    // Deprecated. Only considered for versioning v0.2.
+    bool inherit_build_id = 17 [deprecated = true];
     // 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 = 18;

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

@@ -154,9 +154,9 @@ message ResetOptions {
         string build_id = 4;
     }
 
-    // Event types to be reapplied (deprecated)
+    // Deprecated. Use `options`.
     // Default: RESET_REAPPLY_TYPE_SIGNAL
-    temporal.api.enums.v1.ResetReapplyType reset_reapply_type = 10;
+    temporal.api.enums.v1.ResetReapplyType reset_reapply_type = 10 [deprecated = true];
 
     // If true, limit the reset to only within the current run. (Applies to build_id targets and
     // possibly others in the future.)

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

@@ -97,6 +97,9 @@ message WorkerDeploymentVersionInfo {
     // Deprecated. Use `deployment_version`.
     string version = 1 [deprecated = true];
 
+    // The status of the Worker Deployment Version.
+    temporal.api.enums.v1.WorkerDeploymentVersionStatus status = 14;
+
     // Required.
     WorkerDeploymentVersion deployment_version = 11;
     string deployment_name = 2;
@@ -107,19 +110,25 @@ message WorkerDeploymentVersionInfo {
 
     // (-- api-linter: core::0140::prepositions=disabled
     //     aip.dev/not-precedent: 'Since' captures the field semantics despite being a preposition. --)
-    // Nil if not current.
+    // Unset if not current.
     google.protobuf.Timestamp current_since_time = 5;
 
     // (-- api-linter: core::0140::prepositions=disabled
     //     aip.dev/not-precedent: 'Since' captures the field semantics despite being a preposition. --)
-    // Nil if not ramping. Updated when the version first starts ramping, not on each ramp change.
+    // Unset if not ramping. Updated when the version first starts ramping, not on each ramp change.
     google.protobuf.Timestamp ramping_since_time = 6;
 
+    // Timestamp when this version first became current or ramping.
+    google.protobuf.Timestamp first_activation_time = 12;
+    // Timestamp when this version last stopped being current or ramping.
+    google.protobuf.Timestamp last_deactivation_time = 13;
+
     // Range: [0, 100]. Must be zero if the version is not ramping (i.e. `ramping_since_time` is nil).
     // Can be in the range [0, 100] if the version is ramping.
     float ramp_percentage = 7;
 
     // All the Task Queues that have ever polled from this Deployment version.
+    // Deprecated. Use `version_task_queues` in DescribeWorkerDeploymentVersionResponse instead.
     repeated VersionTaskQueueInfo task_queue_infos = 8;
     message VersionTaskQueueInfo {
         string name = 1;
@@ -190,10 +199,31 @@ message WorkerDeploymentInfo {
         // Deprecated. Use `deployment_version`.
         string version = 1 [deprecated = true];
 
+        // The status of the Worker Deployment Version.
+        temporal.api.enums.v1.WorkerDeploymentVersionStatus status = 11;
+
         // Required.
         WorkerDeploymentVersion deployment_version = 4;
         google.protobuf.Timestamp create_time = 2;
+        // Deprecated. Use `drainage_info` instead.
         enums.v1.VersionDrainageStatus drainage_status = 3;
+        // Information about workflow drainage to help the user determine when it is safe
+        // to decommission a Version. Not present while version is current or ramping
+        VersionDrainageInfo drainage_info = 5;
+        // Unset if not current.
+        // (-- api-linter: core::0140::prepositions=disabled
+        //     aip.dev/not-precedent: 'Since' captures the field semantics despite being a preposition. --)
+        google.protobuf.Timestamp current_since_time = 6;
+        // Unset if not ramping. Updated when the version first starts ramping, not on each ramp change.
+        // (-- api-linter: core::0140::prepositions=disabled
+        //     aip.dev/not-precedent: 'Since' captures the field semantics despite being a preposition. --)
+        google.protobuf.Timestamp ramping_since_time = 7;
+        // Last time `current_since_time`, `ramping_since_time, or `ramp_percentage` of this version changed.
+        google.protobuf.Timestamp routing_update_time = 8;
+        // Timestamp when this version first became current or ramping.
+        google.protobuf.Timestamp first_activation_time = 9;
+        // Timestamp when this version last stopped being current or ramping.
+        google.protobuf.Timestamp last_deactivation_time = 10;
     }
 }
 

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

@@ -96,4 +96,13 @@ enum ApplicationErrorCategory {
     APPLICATION_ERROR_CATEGORY_UNSPECIFIED = 0;
     // Expected application error with little/no severity.
     APPLICATION_ERROR_CATEGORY_BENIGN = 1;
-}
+}
+
+// (-- api-linter: core::0216::synonyms=disabled
+//     aip.dev/not-precedent: It seems we have both state and status, and status is a better fit for workers. --)
+enum WorkerStatus {
+    WORKER_STATUS_UNSPECIFIED = 0;
+    WORKER_STATUS_RUNNING = 1;
+    WORKER_STATUS_SHUTTING_DOWN = 2;
+    WORKER_STATUS_SHUTDOWN = 3;
+}

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

@@ -72,3 +72,29 @@ enum WorkerVersioningMode {
     // VersioningBehavior enum.)
     WORKER_VERSIONING_MODE_VERSIONED = 2;
 }
+
+// (-- api-linter: core::0216::synonyms=disabled
+//     aip.dev/not-precedent: Call this status because it is . --)
+// Specify the status of a Worker Deployment Version.
+// Experimental. Worker Deployments are experimental and might significantly change in the future.
+enum WorkerDeploymentVersionStatus {
+    WORKER_DEPLOYMENT_VERSION_STATUS_UNSPECIFIED = 0;
+    // The Worker Deployment Version has been created inside the Worker Deployment but is not used by any
+    // workflow executions. These Versions can still have workflows if they have an explicit Versioning Override targeting
+    // this Version. Such Versioning Override could be set at workflow start time, or at a later time via `UpdateWorkflowExecutionOptions`.
+    WORKER_DEPLOYMENT_VERSION_STATUS_INACTIVE = 1;
+    // The Worker Deployment Version is the current version of the Worker Deployment. All new workflow executions 
+    // and tasks of existing unversioned or AutoUpgrade workflows are routed to this version.
+    WORKER_DEPLOYMENT_VERSION_STATUS_CURRENT = 2;
+    // The Worker Deployment Version is the ramping version of the Worker Deployment. A subset of new Pinned workflow executions are 
+    // routed to this version. Moreover, a portion of existing unversioned or AutoUpgrade workflow executions are also routed to this version.
+    WORKER_DEPLOYMENT_VERSION_STATUS_RAMPING = 3;
+    // The Worker Deployment Version is not used by new workflows but is still used by
+    // open pinned workflows. The version cannot be decommissioned safely.
+    WORKER_DEPLOYMENT_VERSION_STATUS_DRAINING = 4;
+    // The Worker Deployment Version is not used by new or open workflows, but might be still needed by
+    // Queries sent to closed workflows. The version can be decommissioned safely if user does
+    // not query closed workflows. If the user does query closed workflows for some time x after
+    // workflows are closed, they should decommission the version after it has been drained for that duration.
+    WORKER_DEPLOYMENT_VERSION_STATUS_DRAINED = 5;
+}

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

@@ -79,6 +79,8 @@ enum WorkflowTaskFailedCause {
     // for the workflow's namespace).
     // Check the workflow task failure message for more information.
     WORKFLOW_TASK_FAILED_CAUSE_FEATURE_DISABLED = 35;
+    // A workflow task failed because a grpc message was too large.
+    WORKFLOW_TASK_FAILED_CAUSE_GRPC_MESSAGE_TOO_LARGE = 36;
 }
 
 enum StartChildWorkflowExecutionFailedCause {

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

@@ -22,9 +22,9 @@ enum ResetReapplyExcludeType {
     RESET_REAPPLY_EXCLUDE_TYPE_CANCEL_REQUEST = 4 [deprecated=true];
 }
 
-// Event types to include when reapplying events. Deprecated: applications
-// should use ResetReapplyExcludeType to specify exclusions from this set, and
-// new event types should be added to ResetReapplyExcludeType instead of here.
+// Deprecated: applications should use ResetReapplyExcludeType to specify
+// exclusions from this set, and new event types should be added to ResetReapplyExcludeType
+// instead of here.
 enum ResetReapplyType {
     RESET_REAPPLY_TYPE_UNSPECIFIED = 0;
     // Signals are reapplied when workflow is reset.
@@ -35,7 +35,7 @@ enum ResetReapplyType {
     RESET_REAPPLY_TYPE_ALL_ELIGIBLE = 3;
 }
 
-// Reset type options. Deprecated, see temporal.api.common.v1.ResetOptions.
+// Deprecated, see temporal.api.common.v1.ResetOptions.
 enum ResetType {
     RESET_TYPE_UNSPECIFIED = 0;
     // Resets to event of the first workflow task completed, or if it does not exist, the event after task scheduled.

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

@@ -77,8 +77,8 @@ message NexusOperationFailureInfo {
     string operation = 4;
     // Operation ID - may be empty if the operation completed synchronously.
     //
-    // Deprecated: Renamed to operation_token.
-    string operation_id = 5;
+    // Deprecated. Renamed to operation_token.
+    string operation_id = 5 [deprecated = true];
     // Operation token - may be empty if the operation completed synchronously.
     string operation_token = 6;
 }

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

@@ -46,7 +46,7 @@ message WorkflowExecutionStartedEventAttributes {
     google.protobuf.Duration workflow_run_timeout = 8;
     // Timeout of a single workflow task.
     google.protobuf.Duration workflow_task_timeout = 9;
-    // Run id of the previous workflow which continued-as-new or retired or cron executed into this
+    // Run id of the previous workflow which continued-as-new or retried or cron executed into this
     // workflow.
     string continued_execution_run_id = 10;
     temporal.api.enums.v1.ContinueAsNewInitiator initiator = 11;
@@ -84,7 +84,7 @@ message WorkflowExecutionStartedEventAttributes {
     // If this workflow intends to use anything other than the current overall default version for
     // the queue, then we include it here.
     // Deprecated. [cleanup-experimental-wv]
-    temporal.api.common.v1.WorkerVersionStamp source_version_stamp = 29;
+    temporal.api.common.v1.WorkerVersionStamp source_version_stamp = 29 [deprecated = true];
     // Completion callbacks attached when this workflow was started.
     repeated temporal.api.common.v1.Callback completion_callbacks = 30;
 
@@ -117,26 +117,40 @@ message WorkflowExecutionStartedEventAttributes {
     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;
+    string inherited_build_id = 32 [deprecated = true];
     // Versioning override applied to this workflow when it was started.
+    // Children, crons, retries, and continue-as-new will inherit source run's override if pinned
+    // and if the new workflow's Task Queue belongs to the override version.
     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.
-    // Deprecated. Use `parent_pinned_deployment_version`.
+    // Deprecated. Use `parent_versioning_info`.
     string parent_pinned_worker_deployment_version = 34 [deprecated = true];
 
-    // 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.
-    temporal.api.deployment.v1.WorkerDeploymentVersion parent_pinned_deployment_version = 36;
-
     // Priority metadata
     temporal.api.common.v1.Priority priority = 35;
+
+    reserved 36;
+    reserved "parent_pinned_deployment_version";
+
+    // If present, the new workflow should start on this version with pinned base behavior.
+    // Child of pinned parent will inherit the parent's version if the Child's Task Queue belongs to that version.
+    //
+    // New run initiated by workflow ContinueAsNew of pinned run, will inherit the previous run's version if the
+    // new run's Task Queue belongs to that version.
+    //
+    // New run initiated by workflow Cron will never inherit.
+    //
+    // New run initiated by workflow Retry will only inherit if the retried run is effectively pinned at the time
+    // of retry, and the retried run inherited a pinned version when it started (ie. it is a child of a pinned
+    // parent, or a CaN of a pinned run, and is running on a Task Queue in the inherited version).
+    //
+    // Pinned override is inherited if Task Queue of new run is compatible with the override version.
+    // Override is inherited separately and takes precedence over inherited base version.
+    temporal.api.deployment.v1.WorkerDeploymentVersion inherited_pinned_version = 37;
 }
 
 message WorkflowExecutionCompletedEventAttributes {
@@ -183,7 +197,7 @@ message WorkflowExecutionContinuedAsNewEventAttributes {
     // Deprecated. If a workflow's retry policy would cause a new run to start when the current one
     // has failed, this field would be populated with that failure. Now (when supported by server
     // and sdk) the final event will be `WORKFLOW_EXECUTION_FAILED` with `new_execution_run_id` set.
-    temporal.api.failure.v1.Failure failure = 10;
+    temporal.api.failure.v1.Failure failure = 10 [deprecated = true];
     // TODO: Is this the result of *this* workflow as it continued-as-new?
     temporal.api.common.v1.Payloads last_completion_result = 11;
     temporal.api.common.v1.Header header = 12;
@@ -191,7 +205,8 @@ message WorkflowExecutionContinuedAsNewEventAttributes {
     temporal.api.common.v1.SearchAttributes search_attributes = 14;
     // 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;
+    // Deprecated. Only considered for versioning v0.2.
+    bool inherit_build_id = 15 [deprecated = true];
 
     // workflow_execution_timeout is omitted as it shouldn't be overridden from within a workflow.
 }
@@ -301,7 +316,7 @@ message WorkflowTaskFailedEventAttributes {
     string new_run_id = 7;
     // TODO: ?
     int64 fork_event_version = 8;
-    // DEPRECATED since 1.21 - This field should be cleaned up when versioning-2 API is removed. [cleanup-experimental-wv]
+    // Deprecated. This field should be cleaned up when versioning-2 API is removed. [cleanup-experimental-wv]
     // If a worker explicitly failed this task, its binary id
     string binary_checksum = 9 [deprecated = true];
     // Version info of the worker who processed this workflow task. If present, the `build_id` field
@@ -512,7 +527,7 @@ 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;
-    // This field is deprecated and never respected. It should always be set to false.
+    // Deprecated. This field is never respected and 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;
@@ -534,8 +549,8 @@ message RequestCancelExternalWorkflowExecutionInitiatedEventAttributes {
     string namespace = 2;
     string namespace_id = 7;
     temporal.api.common.v1.WorkflowExecution workflow_execution = 3;
-    // Deprecated
-    string control = 4;
+    // Deprecated.
+    string control = 4 [deprecated = true];
     // Workers are expected to set this to true if the workflow they are requesting to cancel is
     // a child of the workflow which issued the request
     bool child_workflow_only = 5;
@@ -555,8 +570,8 @@ message RequestCancelExternalWorkflowExecutionFailedEventAttributes {
     // id of the `REQUEST_CANCEL_EXTERNAL_WORKFLOW_EXECUTION_INITIATED` event this failure
     // corresponds to
     int64 initiated_event_id = 5;
-    // Deprecated
-    string control = 6;
+    // Deprecated.
+    string control = 6 [deprecated = true];
 }
 
 message ExternalWorkflowExecutionCancelRequestedEventAttributes {
@@ -582,8 +597,8 @@ message SignalExternalWorkflowExecutionInitiatedEventAttributes {
     string signal_name = 4;
     // Serialized arguments to provide to the signal handler
     temporal.api.common.v1.Payloads input = 5;
-    // Deprecated
-    string control = 6;
+    // Deprecated.
+    string control = 6 [deprecated = true];
     // Workers are expected to set this to true if the workflow they are requesting to cancel is
     // a child of the workflow which issued the request
     bool child_workflow_only = 7;
@@ -600,8 +615,8 @@ message SignalExternalWorkflowExecutionFailedEventAttributes {
     string namespace_id = 7;
     temporal.api.common.v1.WorkflowExecution workflow_execution = 4;
     int64 initiated_event_id = 5;
-    // Deprecated
-    string control = 6;
+    // Deprecated.
+    string control = 6 [deprecated = true];
 }
 
 message ExternalWorkflowExecutionSignaledEventAttributes {
@@ -612,8 +627,8 @@ message ExternalWorkflowExecutionSignaledEventAttributes {
     string namespace = 2;
     string namespace_id = 5;
     temporal.api.common.v1.WorkflowExecution workflow_execution = 3;
-    // Deprecated
-    string control = 4;
+    // Deprecated.
+    string control = 4 [deprecated = true];
 }
 
 message UpsertWorkflowSearchAttributesEventAttributes {
@@ -648,8 +663,8 @@ message StartChildWorkflowExecutionInitiatedEventAttributes {
     google.protobuf.Duration workflow_task_timeout = 8;
     // Default: PARENT_CLOSE_POLICY_TERMINATE.
     temporal.api.enums.v1.ParentClosePolicy parent_close_policy = 9;
-    // Deprecated
-    string control = 10;
+    // Deprecated.
+    string control = 10 [deprecated = true];
     // The `WORKFLOW_TASK_COMPLETED` event which this command was reported with
     int64 workflow_task_completed_event_id = 11;
     // Default: WORKFLOW_ID_REUSE_POLICY_ALLOW_DUPLICATE.
@@ -662,7 +677,8 @@ message StartChildWorkflowExecutionInitiatedEventAttributes {
     temporal.api.common.v1.SearchAttributes search_attributes = 17;
     // 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;
+    // Deprecated. Only considered for versioning v0.2.
+    bool inherit_build_id = 19 [deprecated = true];
     // Priority metadata
     temporal.api.common.v1.Priority priority = 20;
 }
@@ -675,8 +691,8 @@ message StartChildWorkflowExecutionFailedEventAttributes {
     string workflow_id = 2;
     temporal.api.common.v1.WorkflowType workflow_type = 3;
     temporal.api.enums.v1.StartChildWorkflowExecutionFailedCause cause = 4;
-    // Deprecated
-    string control = 5;
+    // Deprecated.
+    string control = 5 [deprecated = true];
     // Id of the `START_CHILD_WORKFLOW_EXECUTION_INITIATED` event which this event corresponds to
     int64 initiated_event_id = 6;
     // The `WORKFLOW_TASK_COMPLETED` event which this command was reported with
@@ -893,7 +909,7 @@ message NexusOperationStartedEventAttributes {
     // This ID is used when canceling the operation.
     //
     // Deprecated: Renamed to operation_token.
-    string operation_id = 3;
+    string operation_id = 3 [deprecated = true];
 
     // The request ID allocated at schedule time.
     string request_id = 4;

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

@@ -68,8 +68,8 @@ message CancelOperationRequest {
     string operation = 2;
     // Operation ID as originally generated by a Handler.
     //
-    // Deprecated: Renamed to operation_token.
-    string operation_id = 3;
+    // Deprecated. Renamed to operation_token.
+    string operation_id = 3 [deprecated = true];
 
     // Operation token as originally generated by a Handler.
     string operation_token = 4;
@@ -103,8 +103,8 @@ message StartOperationResponse {
     // 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;
+        // Deprecated. Renamed to operation_token.
+        string operation_id = 1 [deprecated = true];
         repeated Link links = 2;
         string operation_token = 3;
     }

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

@@ -167,7 +167,8 @@ message ScheduleSpec {
     // Interval-based specifications of times.
     repeated IntervalSpec interval = 2;
     // Any timestamps matching any of exclude_* will be skipped.
-    repeated CalendarSpec exclude_calendar = 3 [deprecated = true]; // use exclude_structured_calendar
+    // Deprecated. Use exclude_structured_calendar.
+    repeated CalendarSpec exclude_calendar = 3 [deprecated = true];
     repeated StructuredCalendarSpec exclude_structured_calendar = 9;
     // If start_time is set, any timestamps before start_time will be skipped.
     // (Together, start_time and end_time make an inclusive interval.)
@@ -277,6 +278,10 @@ message ScheduleState {
 message TriggerImmediatelyRequest {
     // If set, override overlap policy for this one request.
     temporal.api.enums.v1.ScheduleOverlapPolicy overlap_policy = 1;
+    
+    // Timestamp used for the identity of the target workflow.
+    // If not set the default value is the current time.
+    google.protobuf.Timestamp scheduled_time = 2;
 }
 
 message BackfillRequest {
@@ -342,6 +347,7 @@ message ScheduleInfo {
     google.protobuf.Timestamp create_time = 6;
     google.protobuf.Timestamp update_time = 7;
 
+    // Deprecated.
     string invalid_schedule_error = 8 [deprecated = true];
 }
 

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

@@ -0,0 +1,134 @@
+syntax = "proto3";
+
+package temporal.api.worker.v1;
+
+option go_package = "go.temporal.io/api/worker/v1;worker";
+option java_package = "io.temporal.api.worker.v1";
+option java_multiple_files = true;
+option java_outer_classname = "MessageProto";
+option ruby_package = "Temporalio::Api::Worker::V1";
+option csharp_namespace = "Temporalio.Api.Worker.V1";
+
+import "google/protobuf/duration.proto";
+import "google/protobuf/timestamp.proto";
+import "temporal/api/deployment/v1/message.proto";
+import "temporal/api/enums/v1/common.proto";
+
+message WorkerPollerInfo {
+  // Number of polling RPCs that are currently in flight.
+  int32 current_pollers = 1;
+
+  google.protobuf.Timestamp last_successful_poll_time = 2;
+
+  // Set true if the number of concurrent pollers is auto-scaled
+  bool is_autoscaling = 3;
+}
+
+message WorkerSlotsInfo {
+  // Number of slots available for the worker to specific tasks.
+  // May be -1 if the upper bound is not known.
+  int32 current_available_slots = 1;
+  // Number of slots used by the worker for specific tasks.
+  int32 current_used_slots = 2;
+
+  // Kind of the slot supplier, which is used to determine how the slots are allocated.
+  // Possible values: "Fixed | ResourceBased | Custom String"
+  string slot_supplier_kind = 3;
+
+  // Total number of tasks processed (completed both successfully and unsuccesfully, or any other way)
+  // by the worker since the worker started. This is a cumulative counter.
+  int32 total_processed_tasks = 4;
+  // Total number of failed tasks processed by the worker so far.
+  int32 total_failed_tasks = 5;
+
+  // Number of tasks processed in since the last heartbeat from the worker.
+  // This is a cumulative counter, and it is reset to 0 each time the worker sends a heartbeat.
+  // Contains both successful and failed tasks.
+  int32 last_interval_processed_tasks = 6;
+  // Number of failed tasks processed since the last heartbeat from the worker.
+  int32 last_interval_failure_tasks = 7;
+}
+
+// Holds everything needed to identify the worker host/process context
+message WorkerHostInfo {
+  // Worker host identifier.
+  string host_name = 1;
+
+
+  // Worker process identifier. This id should be unique for all _processes_
+  // running workers in the namespace, and should be shared by all workers
+  // in the same process.
+  // This will be used to build the worker command nexus task queue name:
+  // "temporal-sys/worker-commands/{process_key}"
+  string process_key = 5;
+
+  // Worker process identifier. Unlike process_key, this id only needs to be unique
+  // within one host (so using e.g. a unix pid would be appropriate).
+  string process_id = 2;
+
+  // System used CPU as a float in the range [0.0, 1.0] where 1.0 is defined as all
+  // cores on the host pegged.
+  float current_host_cpu_usage = 3;
+  // System used memory as a float in the range [0.0, 1.0] where 1.0 is defined as
+  // all available memory on the host is used.
+  float current_host_mem_usage = 4;
+}
+
+// Worker info message, contains information about the worker and its current state.
+// All information is provided by the worker itself.
+// (-- api-linter: core::0140::prepositions=disabled
+//     aip.dev/not-precedent: Removing those words make names less clear. --)
+message WorkerHeartbeat {
+  // Worker identifier, should be unique for the namespace.
+  // It is distinct from worker identity, which is not necessarily namespace-unique.
+  string worker_instance_key = 1;
+
+  // Worker identity, set by the client, may not be unique.
+  // Usually host_name+(user group name)+process_id, but can be overwritten by the user.
+  string worker_identity = 2;
+
+  // Worker host information.
+  WorkerHostInfo host_info = 3;
+
+  // Task queue this worker is polling for tasks.
+  string task_queue = 4;
+
+  temporal.api.deployment.v1.WorkerDeploymentVersion deployment_version = 5;
+
+  string sdk_name = 6;
+  string sdk_version = 7;
+
+  // Worker status. Defined by SDK.
+  temporal.api.enums.v1.WorkerStatus status = 8;
+
+  // Worker start time.
+  // It can be used to determine worker uptime. (current time - start time)
+  google.protobuf.Timestamp start_time = 9;
+
+  // Timestamp of this heartbeat, coming from the worker. Worker should set it to "now".
+  // Note that this timestamp comes directly from the worker and is subject to workers' clock skew.
+  google.protobuf.Timestamp heartbeat_time = 10;
+  // Elapsed time since the last heartbeat from the worker.
+  google.protobuf.Duration elapsed_since_last_heartbeat = 11;
+
+  WorkerSlotsInfo workflow_task_slots_info = 12;
+  WorkerSlotsInfo activity_task_slots_info = 13;
+  WorkerSlotsInfo nexus_task_slots_info = 14;
+  WorkerSlotsInfo local_activity_slots_info = 15;
+
+  WorkerPollerInfo workflow_poller_info = 16;
+  WorkerPollerInfo workflow_sticky_poller_info = 17;
+  WorkerPollerInfo activity_poller_info = 18;
+  WorkerPollerInfo nexus_poller_info = 19;
+
+  // A Workflow Task found a cached Workflow Execution to run against.
+  int32 total_sticky_cache_hit = 20;
+  // A Workflow Task did not find a cached Workflow execution to run against.
+  int32 total_sticky_cache_miss = 21;
+  // Current cache size, expressed in number of Workflow Executions.
+  int32 current_sticky_cache_size = 22;
+}
+
+message WorkerInfo {
+  WorkerHeartbeat worker_heartbeat = 1;
+}