@temporalio/core-bridge 0.23.0 → 1.0.0

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

@@ -0,0 +1,300 @@
+// 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.schedule.v1;
+
+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";
+
+import "google/protobuf/duration.proto";
+import "google/protobuf/timestamp.proto";
+
+import "dependencies/gogoproto/gogo.proto";
+
+import "temporal/api/common/v1/message.proto";
+import "temporal/api/enums/v1/schedule.proto";
+import "temporal/api/workflow/v1/message.proto";
+
+// CalendarSpec describes an event specification relative to the calendar,
+// similar to a traditional cron specification. Each field can be one of:
+//   *: matches always
+//   x: matches when the field equals x
+//   x/y : matches when the field equals x+n*y where n is an integer
+//   x-z: matches when the field is between x and z inclusive
+//   w,x,y,...: matches when the field is one of the listed values
+// Each x, y, z, ... is either a decimal integer, or a month or day of week name
+// or abbreviation (in the appropriate fields).
+// A second in time matches if all fields match.
+// Note that the special case that some cron implementations have for treating
+// day_of_month and day_of_week as "or" instead of "and" when both are set is
+// not implemented.
+// day_of_week can accept 0 or 7 as Sunday
+// TODO: add relative-to-end-of-month
+// TODO: add nth day-of-week in month
+message CalendarSpec {
+    // Expression to match seconds. Default: 0
+    string second = 1;
+    // Expression to match minutes. Default: 0
+    string minute = 2;
+    // Expression to match hours. Default: 0
+    string hour = 3;
+    // Expression to match days of the month. Default: *
+    // (-- api-linter: core::0140::prepositions=disabled
+    //     aip.dev/not-precedent: standard name of field --)
+    string day_of_month = 4;
+    // Expression to match months. Default: *
+    string month = 5;
+    // Expression to match years. Default: *
+    string year = 6;
+    // Expression to match days of the week. Default: *
+    string day_of_week = 7;
+}
+
+// IntervalSpec matches times that can be expressed as:
+// epoch + n * interval + phase
+// where n is an integer.
+// phase defaults to zero if missing. interval is required.
+// Both interval and phase must be non-negative and are truncated to the nearest
+// second before any calculations.
+// For example, an interval of 1 hour with phase of zero would match every hour,
+// on the hour. The same interval but a phase of 19 minutes would match every
+// xx:19:00. An interval of 28 days with phase zero would match
+// 2022-02-17T00:00:00Z (among other times). The same interval with a phase of 3
+// days, 5 hours, and 23 minutes would match 2022-02-20T05:23:00Z instead.
+message IntervalSpec {
+    google.protobuf.Duration interval = 1 [(gogoproto.stdduration) = true];
+    google.protobuf.Duration phase = 2 [(gogoproto.stdduration) = true];
+}
+
+// ScheduleSpec is a complete description of a set of absolute timestamps
+// (possibly infinite) that an action should occur at. The meaning of a
+// ScheduleSpec depends only on its contents and never changes, except that the
+// definition of a time zone can change over time (most commonly, when daylight
+// saving time policy changes for an area). To create a totally self-contained
+// ScheduleSpec, use UTC or include timezone_data.
+message ScheduleSpec {
+    // Calendar-based specifications of times.
+    repeated CalendarSpec calendar = 1;
+    // Interval-based specifications of times.
+    repeated IntervalSpec interval = 2;
+    // Any timestamps matching any of the exclude_calendar specs will be
+    // skipped.
+    repeated CalendarSpec exclude_calendar = 3;
+    // Any timestamps before start_time will be skipped. Together, start_time
+    // and end_time make an inclusive interval.
+    google.protobuf.Timestamp start_time = 4 [(gogoproto.stdtime) = true];
+    // Any timestamps after end_time will be skipped.
+    google.protobuf.Timestamp end_time = 5 [(gogoproto.stdtime) = true];
+    // All timestamps will be incremented by a random value from 0 to this
+    // amount of jitter. Default: 1 second
+    google.protobuf.Duration jitter = 6 [(gogoproto.stdduration) = true];
+
+    // Time zone to interpret all CalendarSpecs in.
+    //
+    // If unset, defaults to UTC. We recommend using UTC for your application if
+    // at all possible, to avoid various surprising properties of time zones.
+    //
+    // Time zones may be provided by name, corresponding to names in the IANA
+    // time zone database (see https://www.iana.org/time-zones). The definition
+    // will be loaded by the Temporal server from the environment it runs in.
+    //
+    // If your application requires more control over the time zone definition
+    // used, it may pass in a complete definition in the form of a TZif file
+    // from the time zone database. If present, this will be used instead of
+    // loading anything from the environment. You are then responsible for
+    // updating timezone_data when the definition changes.
+    //
+    // Calendar spec matching is based on literal matching of the clock time
+    // with no special handling of DST: if you write a calendar spec that fires
+    // at 2:30am and specify a time zone that follows DST, that action will not
+    // be triggered on the day that has no 2:30am. Similarly, an action that
+    // fires at 1:30am will be triggered twice on the day that has two 1:30s.
+    string timezone_name = 10;
+    bytes timezone_data = 11;
+}
+
+message SchedulePolicies {
+    // Policy for overlaps.
+    // Note that this can be changed after a schedule has taken some actions, and we can't
+    // provide 100% sensible semantics for all changes. The most confusing case would be
+    // changes to/from ALLOW_ALL: with that policy multiple scheduled workflows can run
+    // concurrently, but for all other policies only one can run at a time. Changing
+    // between these two classes will leave all workflows with the other class alone.
+    // E.g., if changing from ALLOW_ALL to CANCEL_OTHER, and there are workflows running,
+    // those workflows will not be cancelled. If changing from ALLOW_ALL to SKIP with
+    // workflows running, the running workflows will not cause the next action to be
+    // skipped.
+    temporal.api.enums.v1.ScheduleOverlapPolicy overlap_policy = 1;
+
+    // Policy for catchups:
+    // If the Temporal server misses an action due to one or more components
+    // being down, and comes back up, the action will be run if the scheduled
+    // time is within this window from the current time.
+    // This value defaults to 60 seconds, and can't be less than 10 seconds.
+    google.protobuf.Duration catchup_window = 2 [(gogoproto.stdduration) = true];
+
+    // If true, and a workflow run fails or times out, turn on "paused".
+    // This applies after retry policies: the full chain of retries must fail to
+    // trigger a pause here.
+    bool pause_on_failure = 3;
+}
+
+message ScheduleAction {
+    oneof action {
+        // All fields of NewWorkflowExecutionInfo are valid except for:
+        // - workflow_id_reuse_policy
+        // - cron_schedule
+        // The workflow id of the started workflow may not match this exactly,
+        // it may have a timestamp appended for uniqueness.
+        temporal.api.workflow.v1.NewWorkflowExecutionInfo start_workflow = 1;
+    }
+}
+
+message ScheduleActionResult {
+    // Time that the action was taken (according to the schedule, including jitter).
+    google.protobuf.Timestamp schedule_time = 1 [(gogoproto.stdtime) = true];
+
+    // Time that the action was taken (real time).
+    google.protobuf.Timestamp actual_time = 2 [(gogoproto.stdtime) = true];
+
+    // If action was start_workflow:
+    temporal.api.common.v1.WorkflowExecution start_workflow_result = 11;
+}
+
+message ScheduleState {
+    // Informative human-readable message with contextual notes, e.g. the reason
+    // a schedule is paused. The system may overwrite this message on certain
+    // conditions, e.g. when pause-on-failure happens.
+    string notes = 1;
+
+    // If true, do not take any actions based on the schedule spec.
+    bool paused = 2;
+
+    // If limited_actions is true, decrement remaining_actions after each action, and do
+    // not take any more scheduled actions if remaining_actions is zero. Actions may still
+    // be taken by explicit request. Skipped actions (due to overlap policy) do not count
+    // against remaining actions.
+    bool limited_actions = 3;
+    int64 remaining_actions = 4;
+}
+
+message TriggerImmediatelyRequest {
+    // Override overlap policy for this one request.
+    temporal.api.enums.v1.ScheduleOverlapPolicy overlap_policy = 1;
+}
+
+message BackfillRequest {
+    // Time range to evaluate schedule in.
+    google.protobuf.Timestamp start_time = 1 [(gogoproto.stdtime) = true];
+    google.protobuf.Timestamp end_time = 2 [(gogoproto.stdtime) = true];
+    // Override overlap policy for this request.
+    temporal.api.enums.v1.ScheduleOverlapPolicy overlap_policy = 3;
+}
+
+message SchedulePatch {
+    // If set, trigger one action immediately.
+    TriggerImmediatelyRequest trigger_immediately = 1;
+
+    // If set, runs though the specified time period(s) and takes actions as if that time
+    // passed by right now, all at once. The overlap policy can be overridden for the
+    // scope of the backfill.
+    repeated BackfillRequest backfill_request = 2;
+
+    // If set, change the state to paused or unpaused (respectively) and set the
+    // notes field to the value of the string.
+    string pause = 3;
+    string unpause = 4;
+}
+
+message ScheduleInfo {
+    // Number of actions taken so far.
+    int64 action_count = 1;
+
+    // Number of times a scheduled action was skipped due to missing the catchup window.
+    int64 missed_catchup_window = 2;
+
+    // Number of skipped actions due to overlap.
+    int64 overlap_skipped = 3;
+
+    // Currently-running workflows started by this schedule. (There might be
+    // more than one if the overlap policy allows overlaps.)
+    // Note that the run_ids in here are the original execution run ids as
+    // started by the schedule. If the workflows retried, did continue-as-new,
+    // or were reset, they might still be running but with a different run_id.
+    repeated temporal.api.common.v1.WorkflowExecution running_workflows = 9;
+
+    // Most recent ten actual action times (including manual triggers).
+    repeated ScheduleActionResult recent_actions = 4;
+
+    // Next ten scheduled action times.
+    repeated google.protobuf.Timestamp future_action_times = 5 [(gogoproto.stdtime) = true];
+
+    // Timestamps of schedule creation and last update.
+    google.protobuf.Timestamp create_time = 6 [(gogoproto.stdtime) = true];
+    google.protobuf.Timestamp update_time = 7 [(gogoproto.stdtime) = true];
+
+    // Error for invalid schedule. If this is set, no actions will be taken.
+    string invalid_schedule_error = 8;
+}
+
+message Schedule {
+    ScheduleSpec spec = 1;
+    ScheduleAction action = 2;
+    SchedulePolicies policies = 3;
+    ScheduleState state = 4;
+}
+
+// ScheduleListInfo is an abbreviated set of values from Schedule and ScheduleInfo
+// that's returned in ListSchedules.
+message ScheduleListInfo {
+    // From spec:
+    // Some fields are too large/unimportant for the purpose of listing, so we'll clear them
+    // from this copy of spec: exclude_calendar, jitter, timezone_data.
+    ScheduleSpec spec = 1;
+
+    // From action:
+    // Action is a oneof field, but we need to encode this in JSON and oneof fields don't work
+    // well with JSON. If action is start_workflow, this is set:
+    temporal.api.common.v1.WorkflowType workflow_type = 2;
+
+    // From state:
+    string notes = 3;
+    bool paused = 4;
+
+    // From info (maybe fewer entries):
+    repeated ScheduleActionResult recent_actions = 5;
+    repeated google.protobuf.Timestamp future_action_times = 6 [(gogoproto.stdtime) = true];
+}
+
+// ScheduleListEntry is returned by ListSchedules.
+message ScheduleListEntry {
+    string schedule_id = 1;
+    temporal.api.common.v1.Memo memo = 2;
+    temporal.api.common.v1.SearchAttributes search_attributes = 3;
+    ScheduleListInfo info = 4;
+}

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

@@ -117,3 +117,28 @@ message ResetPointInfo {
     // false if the reset point has pending childWFs/reqCancels/signalExternals.
     bool resettable = 6;
 }
+
+// NewWorkflowExecutionInfo is a shared message that encapsulates all the
+// required arguments to starting a workflow in different contexts.
+message NewWorkflowExecutionInfo {
+    string workflow_id = 1;
+    temporal.api.common.v1.WorkflowType workflow_type = 2;
+    temporal.api.taskqueue.v1.TaskQueue task_queue = 3;
+    // Serialized arguments to the workflow.
+    temporal.api.common.v1.Payloads input = 4;
+    // Total workflow execution timeout including retries and continue as new.
+    google.protobuf.Duration workflow_execution_timeout = 5 [(gogoproto.stdduration) = true];
+    // Timeout of a single workflow run.
+    google.protobuf.Duration workflow_run_timeout = 6 [(gogoproto.stdduration) = true];
+    // Timeout of a single workflow task.
+    google.protobuf.Duration workflow_task_timeout = 7 [(gogoproto.stdduration) = true];
+    // Default: WORKFLOW_ID_REUSE_POLICY_ALLOW_DUPLICATE.
+    temporal.api.enums.v1.WorkflowIdReusePolicy workflow_id_reuse_policy = 8;
+    // The retry policy for the workflow. Will never exceed `workflow_execution_timeout`.
+    temporal.api.common.v1.RetryPolicy retry_policy = 9;
+    // See https://docs.temporal.io/docs/content/what-is-a-temporal-cron-job/
+    string cron_schedule = 10;
+    temporal.api.common.v1.Memo memo = 11;
+    temporal.api.common.v1.SearchAttributes search_attributes = 12;
+    temporal.api.common.v1.Header header = 13;
+}

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

@@ -47,6 +47,7 @@ import "temporal/api/filter/v1/message.proto";
 import "temporal/api/namespace/v1/message.proto";
 import "temporal/api/query/v1/message.proto";
 import "temporal/api/replication/v1/message.proto";
+import "temporal/api/schedule/v1/message.proto";
 import "temporal/api/taskqueue/v1/message.proto";
 import "temporal/api/version/v1/message.proto";
 
@@ -80,6 +81,7 @@ message RegisterNamespaceResponse {
 message ListNamespacesRequest {
     int32 page_size = 1;
     bytes next_page_token = 2;
+    temporal.api.namespace.v1.NamespaceFilter namespace_filter = 3;
 }
 
 message ListNamespacesResponse {
@@ -191,6 +193,19 @@ message GetWorkflowExecutionHistoryResponse {
     bool archived = 4;
 }
 
+message GetWorkflowExecutionHistoryReverseRequest {
+    string namespace = 1;
+    temporal.api.common.v1.WorkflowExecution execution = 2;
+    int32 maximum_page_size = 3;
+    bytes next_page_token = 4;
+}
+
+message GetWorkflowExecutionHistoryReverseResponse {
+    temporal.api.history.v1.History history = 1;
+    // Will be set if there are more history events than were included in this response
+    bytes next_page_token = 3;
+}
+
 message PollWorkflowTaskQueueRequest {
     string namespace = 1;
     temporal.api.taskqueue.v1.TaskQueue task_queue = 2;
@@ -268,6 +283,8 @@ message RespondWorkflowTaskCompletedRequest {
 message RespondWorkflowTaskCompletedResponse {
     // See `RespondWorkflowTaskCompletedResponse::return_new_workflow_task`
     PollWorkflowTaskQueueResponse workflow_task = 1;
+    // See `ScheduleActivityTaskCommandAttributes::request_start`
+    repeated PollActivityTaskQueueResponse activity_tasks = 2;
 }
 
 message RespondWorkflowTaskFailedRequest {
@@ -420,9 +437,14 @@ message RespondActivityTaskFailedRequest {
     // The identity of the worker/client
     string identity = 3;
     string namespace = 4;
+    // Additional details to be stored as last activity heartbeat
+    temporal.api.common.v1.Payloads last_heartbeat_details = 5;
 }
 
 message RespondActivityTaskFailedResponse {
+    // Server validation failures could include
+    // last_heartbeat_details payload is too large, request failure is too large
+    repeated temporal.api.failure.v1.Failure failures = 1;
 }
 
 message RespondActivityTaskFailedByIdRequest {
@@ -438,9 +460,14 @@ message RespondActivityTaskFailedByIdRequest {
     temporal.api.failure.v1.Failure failure = 5;
     // The identity of the worker/client
     string identity = 6;
+    // Additional details to be stored as last activity heartbeat
+    temporal.api.common.v1.Payloads last_heartbeat_details = 7;
 }
 
 message RespondActivityTaskFailedByIdResponse {
+    // Server validation failures could include
+    // last_heartbeat_details payload is too large, request failure is too large
+    repeated temporal.api.failure.v1.Failure failures = 1;
 }
 
 message RespondActivityTaskCanceledRequest {
@@ -481,8 +508,12 @@ message RequestCancelWorkflowExecutionRequest {
     string identity = 3;
     // Used to de-dupe cancellation requests
     string request_id = 4;
-    // Should be removed. Appears unused.
+    // 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;
+    // Reason for requesting the cancellation
+    string reason = 6;
 }
 
 message RequestCancelWorkflowExecutionResponse {
@@ -556,7 +587,7 @@ message ResetWorkflowExecutionRequest {
     int64 workflow_task_finish_event_id = 4;
     // Used to de-dupe reset requests
     string request_id = 5;
-    // Should be removed. Appears unused.
+    // Reset reapplay(replay) options.
     temporal.api.enums.v1.ResetReapplyType reset_reapply_type = 6;
 }
 
@@ -572,7 +603,9 @@ message TerminateWorkflowExecutionRequest {
     temporal.api.common.v1.Payloads details = 4;
     // The identity of the worker/client
     string identity = 5;
-    // Should be removed. Appears unused.
+    // 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 = 6;
 }
 
@@ -761,6 +794,12 @@ message GetSystemInfoResponse {
         // When unset/false, clients retry all failures. When true, clients should only retry
         // non-internal errors.
         bool internal_error_differentiation = 2;
+
+        // True if RespondActivityTaskFailed API supports including heartbeat details
+        bool activity_failure_include_heartbeat = 3;
+
+        // Supports scheduled workflow features.
+        bool supports_schedules = 4;
     }
 }
 
@@ -773,3 +812,141 @@ message ListTaskQueuePartitionsResponse {
     repeated temporal.api.taskqueue.v1.TaskQueuePartitionMetadata activity_task_queue_partitions = 1;
     repeated temporal.api.taskqueue.v1.TaskQueuePartitionMetadata workflow_task_queue_partitions = 2;
 }
+
+// (-- api-linter: core::0133::request-parent-required=disabled
+//     aip.dev/not-precedent: CreateSchedule doesn't follow Google API format --)
+// (-- api-linter: core::0133::request-unknown-fields=disabled
+//     aip.dev/not-precedent: CreateSchedule doesn't follow Google API format --)
+// (-- api-linter: core::0133::request-resource-behavior=disabled
+//     aip.dev/not-precedent: field_behavior annotation not available in our gogo fork --)
+// (-- api-linter: core::0203::optional=disabled
+//     aip.dev/not-precedent: field_behavior annotation not available in our gogo fork --)
+message CreateScheduleRequest {
+    // The namespace the schedule should be created in.
+    string namespace = 1;
+    // The id of the new schedule.
+    string schedule_id = 2;
+    // The schedule spec, policies, action, and initial state.
+    temporal.api.schedule.v1.Schedule schedule = 3;
+    // Optional initial patch (e.g. to run the action once immediately).
+    temporal.api.schedule.v1.SchedulePatch initial_patch = 4;
+    // The identity of the client who initiated this request.
+    string identity = 5;
+    // A unique identifier for this create request for idempotence. Typically UUIDv4.
+    string request_id = 6;
+    // Memo and search attributes to attach to the schedule itself.
+    temporal.api.common.v1.Memo memo = 7;
+    temporal.api.common.v1.SearchAttributes search_attributes = 8;
+}
+
+message CreateScheduleResponse {
+    bytes conflict_token = 1;
+}
+
+message DescribeScheduleRequest {
+    // The namespace of the schedule to describe.
+    string namespace = 1;
+    // The id of the schedule to describe.
+    string schedule_id = 2;
+}
+
+message DescribeScheduleResponse {
+    // The complete current schedule details. This may not match the schedule as
+    // created because:
+    // - some fields in the state are modified automatically
+    // - the schedule may have been modified by UpdateSchedule or PatchSchedule
+    temporal.api.schedule.v1.Schedule schedule = 1;
+    // Extra schedule state info.
+    temporal.api.schedule.v1.ScheduleInfo info = 2;
+    // The memo and search attributes that the schedule was created with.
+    temporal.api.common.v1.Memo memo = 3;
+    temporal.api.common.v1.SearchAttributes search_attributes = 4;
+
+    // This value can be passed back to UpdateSchedule to ensure that the
+    // schedule was not modified between a Describe and an Update, which could
+    // lead to lost updates and other confusion.
+    bytes conflict_token = 5;
+}
+
+// (-- api-linter: core::0134::request-mask-required=disabled
+//     aip.dev/not-precedent: UpdateSchedule doesn't follow Google API format --)
+message UpdateScheduleRequest {
+    // The namespace of the schedule to update.
+    string namespace = 1;
+    // The id of the schedule to update.
+    string schedule_id = 2;
+    // The new schedule. The four main fields of the schedule (spec, action,
+    // policies, state) are replaced completely by the values in this message.
+    temporal.api.schedule.v1.Schedule schedule = 3;
+    // This can be the value of conflict_token from a DescribeScheduleResponse,
+    // which will cause this request to fail if the schedule has been modified
+    // between the Describe and this Update.
+    // If missing, the schedule will be updated unconditionally.
+    bytes conflict_token = 4;
+    // The identity of the client who initiated this request.
+    string identity = 5;
+    // A unique identifier for this update request for idempotence. Typically UUIDv4.
+    string request_id = 6;
+}
+
+message UpdateScheduleResponse {
+}
+
+message PatchScheduleRequest {
+    // The namespace of the schedule to patch.
+    string namespace = 1;
+    // The id of the schedule to patch.
+    string schedule_id = 2;
+    temporal.api.schedule.v1.SchedulePatch patch = 3;
+    // The identity of the client who initiated this request.
+    string identity = 4;
+    // A unique identifier for this update request for idempotence. Typically UUIDv4.
+    string request_id = 5;
+}
+
+message PatchScheduleResponse {
+}
+
+message ListScheduleMatchingTimesRequest {
+    // The namespace of the schedule to query.
+    string namespace = 1;
+    // The id of the schedule to query.
+    string schedule_id = 2;
+    // Time range to query.
+    google.protobuf.Timestamp start_time = 3 [(gogoproto.stdtime) = true];
+    google.protobuf.Timestamp end_time = 4 [(gogoproto.stdtime) = true];
+}
+
+message ListScheduleMatchingTimesResponse {
+    repeated google.protobuf.Timestamp start_time = 1 [(gogoproto.stdtime) = true];
+}
+
+// (-- api-linter: core::0135::request-name-required=disabled
+//     aip.dev/not-precedent: DeleteSchedule doesn't follow Google API format --)
+// (-- api-linter: core::0135::request-unknown-fields=disabled
+//     aip.dev/not-precedent: DeleteSchedule doesn't follow Google API format --)
+message DeleteScheduleRequest {
+    // The namespace of the schedule to delete.
+    string namespace = 1;
+    // The id of the schedule to delete.
+    string schedule_id = 2;
+    // The identity of the client who initiated this request.
+    string identity = 3;
+}
+
+message DeleteScheduleResponse {
+}
+
+message ListSchedulesRequest {
+    // The namespace to list schedules in.
+    string namespace = 1;
+    // How many to return at once.
+    int32 maximum_page_size = 2;
+    // Token to get the next page of results.
+    bytes next_page_token = 3;
+}
+
+message ListSchedulesResponse {
+    repeated temporal.api.schedule.v1.ScheduleListEntry schedules = 1;
+    bytes next_page_token = 2;
+}

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

@@ -94,6 +94,12 @@ service WorkflowService {
     // `NotFound` if the specified workflow execution is unknown to the service.
     rpc GetWorkflowExecutionHistory (GetWorkflowExecutionHistoryRequest) returns (GetWorkflowExecutionHistoryResponse) {
     }
+    
+    // GetWorkflowExecutionHistoryReverse returns the history of specified workflow execution in reverse 
+    // order (starting from last event). Fails with`NotFound` if the specified workflow execution is 
+    // unknown to the service.
+    rpc GetWorkflowExecutionHistoryReverse (GetWorkflowExecutionHistoryReverseRequest) returns (GetWorkflowExecutionHistoryReverseResponse) {
+    }
 
     // PollWorkflowTaskQueue is called by workers to make progress on workflows.
     //
@@ -209,9 +215,9 @@ service WorkflowService {
     // RequestCancelWorkflowExecution is called by workers when they want to request cancellation of
     // a workflow execution.
     //
-    // This result in a new `WORKFLOW_EXECUTION_CANCEL_REQUESTED` event being written to the
-    // workflow history and a new workflow task created for the workflow. Fails with `NotFound` if
-    // the workflow is already completed or doesn't exist.
+    // This results in a new `WORKFLOW_EXECUTION_CANCEL_REQUESTED` event being written to the
+    // workflow history and a new workflow task created for the workflow. It returns success if the requested
+    // workflow is already closed. It fails with 'NotFound' if the requested workflow doesn't exist.
     rpc RequestCancelWorkflowExecution (RequestCancelWorkflowExecutionRequest) returns (RequestCancelWorkflowExecutionResponse) {
     }
 
@@ -318,4 +324,48 @@ service WorkflowService {
 
     rpc ListTaskQueuePartitions(ListTaskQueuePartitionsRequest) returns (ListTaskQueuePartitionsResponse) {
     }
+
+    // Creates a new schedule.
+    // (-- api-linter: core::0133::method-signature=disabled
+    //     aip.dev/not-precedent: CreateSchedule doesn't follow Google API format --)
+    // (-- api-linter: core::0133::response-message-name=disabled
+    //     aip.dev/not-precedent: CreateSchedule doesn't follow Google API format --)
+    // (-- api-linter: core::0133::http-uri-parent=disabled
+    //     aip.dev/not-precedent: CreateSchedule doesn't follow Google API format --)
+    rpc CreateSchedule (CreateScheduleRequest) returns (CreateScheduleResponse) {
+    }
+
+    // Returns the schedule description and current state of an existing schedule.
+    rpc DescribeSchedule (DescribeScheduleRequest) returns (DescribeScheduleResponse) {
+    }
+
+    // Changes the configuration or state of an existing schedule.
+    // (-- api-linter: core::0134::response-message-name=disabled
+    //     aip.dev/not-precedent: UpdateSchedule RPC doesn't follow Google API format. --)
+    // (-- api-linter: core::0134::method-signature=disabled
+    //     aip.dev/not-precedent: UpdateSchedule RPC doesn't follow Google API format. --)
+    rpc UpdateSchedule (UpdateScheduleRequest) returns (UpdateScheduleResponse) {
+    }
+
+    // Makes a specific change to a schedule or triggers an immediate action.
+    // (-- api-linter: core::0134::synonyms=disabled
+    //     aip.dev/not-precedent: we have both patch and update. --)
+    rpc PatchSchedule (PatchScheduleRequest) returns (PatchScheduleResponse) {
+    }
+
+    // Lists matching times within a range.
+    rpc ListScheduleMatchingTimes (ListScheduleMatchingTimesRequest) returns (ListScheduleMatchingTimesResponse) {
+    }
+
+    // Deletes a schedule, removing it from the system.
+    // (-- api-linter: core::0135::method-signature=disabled
+    //     aip.dev/not-precedent: DeleteSchedule doesn't follow Google API format --)
+    // (-- api-linter: core::0135::response-message-name=disabled
+    //     aip.dev/not-precedent: DeleteSchedule doesn't follow Google API format --)
+    rpc DeleteSchedule (DeleteScheduleRequest) returns (DeleteScheduleResponse) {
+    }
+
+    // List all schedules in a namespace.
+    rpc ListSchedules (ListSchedulesRequest) returns (ListSchedulesResponse) {
+    }
 }