@xeonr/pipelines-sdk 0.2.0 → 0.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (115) hide show
  1. package/README.md +231 -22
  2. package/dist/auth.d.ts +1 -1
  3. package/dist/client.d.ts +73 -10
  4. package/dist/client.d.ts.map +1 -1
  5. package/dist/client.js +47 -4
  6. package/dist/client.js.map +1 -1
  7. package/dist/gen/xeonr/pipelines/private/v1/attempt_pb.d.ts +179 -16
  8. package/dist/gen/xeonr/pipelines/private/v1/attempt_pb.d.ts.map +1 -1
  9. package/dist/gen/xeonr/pipelines/private/v1/attempt_pb.js +45 -28
  10. package/dist/gen/xeonr/pipelines/private/v1/attempt_pb.js.map +1 -1
  11. package/dist/gen/xeonr/pipelines/private/v1/step_local_pb.d.ts +136 -17
  12. package/dist/gen/xeonr/pipelines/private/v1/step_local_pb.d.ts.map +1 -1
  13. package/dist/gen/xeonr/pipelines/private/v1/step_local_pb.js +42 -35
  14. package/dist/gen/xeonr/pipelines/private/v1/step_local_pb.js.map +1 -1
  15. package/dist/gen/xeonr/pipelines/private/v1/worker_pb.d.ts +224 -8
  16. package/dist/gen/xeonr/pipelines/private/v1/worker_pb.d.ts.map +1 -1
  17. package/dist/gen/xeonr/pipelines/private/v1/worker_pb.js +43 -9
  18. package/dist/gen/xeonr/pipelines/private/v1/worker_pb.js.map +1 -1
  19. package/dist/gen/xeonr/pipelines/v1/common_pb.d.ts +64 -8
  20. package/dist/gen/xeonr/pipelines/v1/common_pb.d.ts.map +1 -1
  21. package/dist/gen/xeonr/pipelines/v1/common_pb.js +62 -5
  22. package/dist/gen/xeonr/pipelines/v1/common_pb.js.map +1 -1
  23. package/dist/gen/xeonr/pipelines/v1/definition_pb.d.ts +312 -9
  24. package/dist/gen/xeonr/pipelines/v1/definition_pb.d.ts.map +1 -1
  25. package/dist/gen/xeonr/pipelines/v1/definition_pb.js +100 -7
  26. package/dist/gen/xeonr/pipelines/v1/definition_pb.js.map +1 -1
  27. package/dist/gen/xeonr/pipelines/v1/pipelines_pb.d.ts +1072 -0
  28. package/dist/gen/xeonr/pipelines/v1/pipelines_pb.d.ts.map +1 -0
  29. package/dist/gen/xeonr/pipelines/v1/pipelines_pb.js +299 -0
  30. package/dist/gen/xeonr/pipelines/v1/pipelines_pb.js.map +1 -0
  31. package/dist/gen/xeonr/pipelines/v1/pools_pb.d.ts +103 -8
  32. package/dist/gen/xeonr/pipelines/v1/pools_pb.d.ts.map +1 -1
  33. package/dist/gen/xeonr/pipelines/v1/pools_pb.js +32 -24
  34. package/dist/gen/xeonr/pipelines/v1/pools_pb.js.map +1 -1
  35. package/dist/gen/xeonr/pipelines/v1/queues_pb.d.ts +711 -0
  36. package/dist/gen/xeonr/pipelines/v1/queues_pb.d.ts.map +1 -0
  37. package/dist/gen/xeonr/pipelines/v1/queues_pb.js +185 -0
  38. package/dist/gen/xeonr/pipelines/v1/queues_pb.js.map +1 -0
  39. package/dist/gen/xeonr/pipelines/v1/registry_pb.d.ts +92 -23
  40. package/dist/gen/xeonr/pipelines/v1/registry_pb.d.ts.map +1 -1
  41. package/dist/gen/xeonr/pipelines/v1/registry_pb.js +36 -33
  42. package/dist/gen/xeonr/pipelines/v1/registry_pb.js.map +1 -1
  43. package/dist/gen/xeonr/pipelines/v1/runs_pb.d.ts +1191 -33
  44. package/dist/gen/xeonr/pipelines/v1/runs_pb.d.ts.map +1 -1
  45. package/dist/gen/xeonr/pipelines/v1/runs_pb.js +419 -35
  46. package/dist/gen/xeonr/pipelines/v1/runs_pb.js.map +1 -1
  47. package/dist/gen/xeonr/pipelines/v1/schedule_targets_pb.d.ts +194 -0
  48. package/dist/gen/xeonr/pipelines/v1/schedule_targets_pb.d.ts.map +1 -0
  49. package/dist/gen/xeonr/pipelines/v1/schedule_targets_pb.js +100 -0
  50. package/dist/gen/xeonr/pipelines/v1/schedule_targets_pb.js.map +1 -0
  51. package/dist/gen/xeonr/pipelines/v1/schedules_pb.d.ts +1186 -0
  52. package/dist/gen/xeonr/pipelines/v1/schedules_pb.d.ts.map +1 -0
  53. package/dist/gen/xeonr/pipelines/v1/schedules_pb.js +335 -0
  54. package/dist/gen/xeonr/pipelines/v1/schedules_pb.js.map +1 -0
  55. package/dist/gen/xeonr/pipelines/v1/secrets_pb.d.ts +32 -5
  56. package/dist/gen/xeonr/pipelines/v1/secrets_pb.d.ts.map +1 -1
  57. package/dist/gen/xeonr/pipelines/v1/secrets_pb.js +12 -3
  58. package/dist/gen/xeonr/pipelines/v1/secrets_pb.js.map +1 -1
  59. package/dist/gen/xeonr/pipelines/v1/sinks_pb.d.ts +270 -27
  60. package/dist/gen/xeonr/pipelines/v1/sinks_pb.d.ts.map +1 -1
  61. package/dist/gen/xeonr/pipelines/v1/sinks_pb.js +163 -24
  62. package/dist/gen/xeonr/pipelines/v1/sinks_pb.js.map +1 -1
  63. package/dist/gen/xeonr/pipelines/v1/tenant_policies_pb.d.ts +391 -0
  64. package/dist/gen/xeonr/pipelines/v1/tenant_policies_pb.d.ts.map +1 -0
  65. package/dist/gen/xeonr/pipelines/v1/tenant_policies_pb.js +100 -0
  66. package/dist/gen/xeonr/pipelines/v1/tenant_policies_pb.js.map +1 -0
  67. package/dist/gen/xeonr/platform/v1/options_pb.d.ts +137 -1
  68. package/dist/gen/xeonr/platform/v1/options_pb.d.ts.map +1 -1
  69. package/dist/gen/xeonr/platform/v1/options_pb.js +104 -1
  70. package/dist/gen/xeonr/platform/v1/options_pb.js.map +1 -1
  71. package/dist/handler.d.ts +51 -1
  72. package/dist/handler.d.ts.map +1 -1
  73. package/dist/handler.js +27 -0
  74. package/dist/handler.js.map +1 -1
  75. package/dist/index.d.ts +13 -2
  76. package/dist/index.d.ts.map +1 -1
  77. package/dist/index.js +7 -2
  78. package/dist/index.js.map +1 -1
  79. package/dist/queues.d.ts +158 -0
  80. package/dist/queues.d.ts.map +1 -0
  81. package/dist/queues.js +117 -0
  82. package/dist/queues.js.map +1 -0
  83. package/dist/reporter.d.ts +120 -0
  84. package/dist/reporter.d.ts.map +1 -0
  85. package/dist/reporter.js +323 -0
  86. package/dist/reporter.js.map +1 -0
  87. package/dist/schedules.d.ts +193 -0
  88. package/dist/schedules.d.ts.map +1 -0
  89. package/dist/schedules.js +126 -0
  90. package/dist/schedules.js.map +1 -0
  91. package/dist/testing/cron.d.ts +33 -0
  92. package/dist/testing/cron.d.ts.map +1 -0
  93. package/dist/testing/cron.js +177 -0
  94. package/dist/testing/cron.js.map +1 -0
  95. package/dist/testing/index.d.ts +229 -7
  96. package/dist/testing/index.d.ts.map +1 -1
  97. package/dist/testing/index.js +1304 -103
  98. package/dist/testing/index.js.map +1 -1
  99. package/dist/testing/pipelines.d.ts +99 -0
  100. package/dist/testing/pipelines.d.ts.map +1 -0
  101. package/dist/testing/pipelines.js +445 -0
  102. package/dist/testing/pipelines.js.map +1 -0
  103. package/dist/testing/queues.d.ts +49 -0
  104. package/dist/testing/queues.d.ts.map +1 -0
  105. package/dist/testing/queues.js +72 -0
  106. package/dist/testing/queues.js.map +1 -0
  107. package/dist/testing/schedules.d.ts +125 -0
  108. package/dist/testing/schedules.d.ts.map +1 -0
  109. package/dist/testing/schedules.js +422 -0
  110. package/dist/testing/schedules.js.map +1 -0
  111. package/dist/worker.d.ts +48 -7
  112. package/dist/worker.d.ts.map +1 -1
  113. package/dist/worker.js +59 -9
  114. package/dist/worker.js.map +1 -1
  115. package/package.json +1 -1
@@ -0,0 +1,1186 @@
1
+ import type { GenEnum, GenFile, GenMessage, GenService } from "@bufbuild/protobuf/codegenv2";
2
+ import type { Duration, FieldMask, Timestamp } from "@bufbuild/protobuf/wkt";
3
+ import type { Resource, RunState } from "./common_pb.js";
4
+ import type { Retry } from "./definition_pb.js";
5
+ import type { Run } from "./runs_pb.js";
6
+ import type { JsonObject, Message } from "@bufbuild/protobuf";
7
+ /**
8
+ * Describes the file xeonr/pipelines/v1/schedules.proto.
9
+ */
10
+ export declare const file_xeonr_pipelines_v1_schedules: GenFile;
11
+ /**
12
+ * ScheduleOwner is who a schedule belongs to: one tenant.
13
+ *
14
+ * @generated from message xeonr.pipelines.v1.ScheduleOwner
15
+ */
16
+ export type ScheduleOwner = Message<"xeonr.pipelines.v1.ScheduleOwner"> & {
17
+ /**
18
+ * Tenant is the team URN the schedule belongs to, and every run it starts.
19
+ *
20
+ * @generated from field: string tenant = 2;
21
+ */
22
+ tenant: string;
23
+ };
24
+ /**
25
+ * Describes the message xeonr.pipelines.v1.ScheduleOwner.
26
+ * Use `create(ScheduleOwnerSchema)` to create a new message.
27
+ */
28
+ export declare const ScheduleOwnerSchema: GenMessage<ScheduleOwner>;
29
+ /**
30
+ * ScheduleName names a schedule by its owner and its name.
31
+ *
32
+ * @generated from message xeonr.pipelines.v1.ScheduleName
33
+ */
34
+ export type ScheduleName = Message<"xeonr.pipelines.v1.ScheduleName"> & {
35
+ /**
36
+ * @generated from field: xeonr.pipelines.v1.ScheduleOwner owner = 1;
37
+ */
38
+ owner?: ScheduleOwner | undefined;
39
+ /**
40
+ * @generated from field: string name = 2;
41
+ */
42
+ name: string;
43
+ };
44
+ /**
45
+ * Describes the message xeonr.pipelines.v1.ScheduleName.
46
+ * Use `create(ScheduleNameSchema)` to create a new message.
47
+ */
48
+ export declare const ScheduleNameSchema: GenMessage<ScheduleName>;
49
+ /**
50
+ * SchedulePipelineTarget starts a published version of a stored pipeline.
51
+ *
52
+ * @generated from message xeonr.pipelines.v1.SchedulePipelineTarget
53
+ */
54
+ export type SchedulePipelineTarget = Message<"xeonr.pipelines.v1.SchedulePipelineTarget"> & {
55
+ /**
56
+ * @generated from field: string pipeline_id = 1;
57
+ */
58
+ pipelineId: string;
59
+ /**
60
+ * Version is the version to run; 0 is the latest published when the
61
+ * occurrence fires.
62
+ *
63
+ * @generated from field: uint32 version = 2;
64
+ */
65
+ version: number;
66
+ /**
67
+ * Resource is what each run is about, unless a target gives its own.
68
+ * Unset is the pipeline's scope.
69
+ *
70
+ * @generated from field: xeonr.pipelines.v1.Resource resource = 3;
71
+ */
72
+ resource?: Resource | undefined;
73
+ /**
74
+ * Variables are each run's variables, merged under a target's `args`.
75
+ *
76
+ * @generated from field: google.protobuf.Struct variables = 4;
77
+ */
78
+ variables?: JsonObject | undefined;
79
+ /**
80
+ * AttestedFacts are each run's facts, attested by the tenant's service
81
+ * account that set the schedule, as it would on CreateRun.
82
+ *
83
+ * @generated from field: google.protobuf.Struct attested_facts = 5;
84
+ */
85
+ attestedFacts?: JsonObject | undefined;
86
+ };
87
+ /**
88
+ * Describes the message xeonr.pipelines.v1.SchedulePipelineTarget.
89
+ * Use `create(SchedulePipelineTargetSchema)` to create a new message.
90
+ */
91
+ export declare const SchedulePipelineTargetSchema: GenMessage<SchedulePipelineTarget>;
92
+ /**
93
+ * ScheduleJobTarget creates a job to a worker handler, as CreateJob does.
94
+ *
95
+ * @generated from message xeonr.pipelines.v1.ScheduleJobTarget
96
+ */
97
+ export type ScheduleJobTarget = Message<"xeonr.pipelines.v1.ScheduleJobTarget"> & {
98
+ /**
99
+ * Handler is the worker handler, `<namespace>/<name>`, of the schedule's
100
+ * tenant.
101
+ *
102
+ * @generated from field: string handler = 1;
103
+ */
104
+ handler: string;
105
+ /**
106
+ * Payload is each job's inputs, merged under a target's `args`.
107
+ *
108
+ * @generated from field: google.protobuf.Struct payload = 2;
109
+ */
110
+ payload?: JsonObject | undefined;
111
+ /**
112
+ * Queue, Retry, Timeout and Interruptible are as on CreateJobRequest.
113
+ *
114
+ * @generated from field: string queue = 3;
115
+ */
116
+ queue: string;
117
+ /**
118
+ * @generated from field: xeonr.pipelines.v1.Retry retry = 4;
119
+ */
120
+ retry?: Retry | undefined;
121
+ /**
122
+ * @generated from field: google.protobuf.Duration timeout = 5;
123
+ */
124
+ timeout?: Duration | undefined;
125
+ /**
126
+ * @generated from field: bool interruptible = 6;
127
+ */
128
+ interruptible: boolean;
129
+ };
130
+ /**
131
+ * Describes the message xeonr.pipelines.v1.ScheduleJobTarget.
132
+ * Use `create(ScheduleJobTargetSchema)` to create a new message.
133
+ */
134
+ export declare const ScheduleJobTargetSchema: GenMessage<ScheduleJobTarget>;
135
+ /**
136
+ * ScheduleFireTarget calls the schedule's tenant's own service: pipelines
137
+ * calls its ScheduleTargetService.FireSchedule at the tenant's registered
138
+ * sink, and the service starts the run (PIPE-111).
139
+ *
140
+ * @generated from message xeonr.pipelines.v1.ScheduleFireTarget
141
+ */
142
+ export type ScheduleFireTarget = Message<"xeonr.pipelines.v1.ScheduleFireTarget"> & {
143
+ /**
144
+ * Reference is the consuming service's own name for what the schedule runs (the
145
+ * forge's schedule id), passed back on every fire. Opaque to pipelines.
146
+ *
147
+ * @generated from field: string reference = 1;
148
+ */
149
+ reference: string;
150
+ /**
151
+ * Parameters are passed on every fire, with a target's `args` merged
152
+ * over them. At most 16 KiB encoded.
153
+ *
154
+ * @generated from field: google.protobuf.Struct parameters = 2;
155
+ */
156
+ parameters?: JsonObject | undefined;
157
+ };
158
+ /**
159
+ * Describes the message xeonr.pipelines.v1.ScheduleFireTarget.
160
+ * Use `create(ScheduleFireTargetSchema)` to create a new message.
161
+ */
162
+ export declare const ScheduleFireTargetSchema: GenMessage<ScheduleFireTarget>;
163
+ /**
164
+ * ScheduleTarget is one thing an occurrence fans out to. Its run is the
165
+ * schedule's tenant's.
166
+ *
167
+ * @generated from message xeonr.pipelines.v1.ScheduleTarget
168
+ */
169
+ export type ScheduleTarget = Message<"xeonr.pipelines.v1.ScheduleTarget"> & {
170
+ /**
171
+ * Key identifies the target across occurrences ("server:42",
172
+ * "account:7"): with the schedule and the time it makes the occurrence
173
+ * unique, and it is the grain `queue_while_pending` checks. Unique in a
174
+ * list.
175
+ *
176
+ * @generated from field: string key = 1;
177
+ */
178
+ key: string;
179
+ /**
180
+ * Resource is what the target's run is about, in place of the target
181
+ * spec's.
182
+ *
183
+ * @generated from field: xeonr.pipelines.v1.Resource resource = 3;
184
+ */
185
+ resource?: Resource | undefined;
186
+ /**
187
+ * Args are merged over the target spec's variables (a pipeline) or
188
+ * payload (a job). At most 16 KiB encoded.
189
+ *
190
+ * @generated from field: google.protobuf.Struct args = 4;
191
+ */
192
+ args?: JsonObject | undefined;
193
+ };
194
+ /**
195
+ * Describes the message xeonr.pipelines.v1.ScheduleTarget.
196
+ * Use `create(ScheduleTargetSchema)` to create a new message.
197
+ */
198
+ export declare const ScheduleTargetSchema: GenMessage<ScheduleTarget>;
199
+ /**
200
+ * ScheduleTargetList is a stored list of targets.
201
+ *
202
+ * @generated from message xeonr.pipelines.v1.ScheduleTargetList
203
+ */
204
+ export type ScheduleTargetList = Message<"xeonr.pipelines.v1.ScheduleTargetList"> & {
205
+ /**
206
+ * @generated from field: repeated xeonr.pipelines.v1.ScheduleTarget targets = 1;
207
+ */
208
+ targets: ScheduleTarget[];
209
+ };
210
+ /**
211
+ * Describes the message xeonr.pipelines.v1.ScheduleTargetList.
212
+ * Use `create(ScheduleTargetListSchema)` to create a new message.
213
+ */
214
+ export declare const ScheduleTargetListSchema: GenMessage<ScheduleTargetList>;
215
+ /**
216
+ * Enumeration says where a schedule's targets come from at each occurrence.
217
+ * Unset is one target: the target spec as given.
218
+ *
219
+ * @generated from message xeonr.pipelines.v1.Enumeration
220
+ */
221
+ export type Enumeration = Message<"xeonr.pipelines.v1.Enumeration"> & {
222
+ /**
223
+ * @generated from oneof xeonr.pipelines.v1.Enumeration.source
224
+ */
225
+ source: {
226
+ /**
227
+ * List is a stored list, changed by setting the schedule again.
228
+ *
229
+ * @generated from field: xeonr.pipelines.v1.ScheduleTargetList list = 1;
230
+ */
231
+ value: ScheduleTargetList;
232
+ case: "list";
233
+ } | {
234
+ /**
235
+ * Handler is a worker handler of the schedule's tenant, run as a job
236
+ * (in the schedule's queue, for the schedule's tenant) at each
237
+ * occurrence, before anything else. Its kv output `targets` is a JSON array of ScheduleTarget, in
238
+ * its JSON form. When it fails or the list is invalid, the occurrence
239
+ * fires nothing and is recorded ENUMERATION_FAILED.
240
+ *
241
+ * @generated from field: string handler = 2;
242
+ */
243
+ value: string;
244
+ case: "handler";
245
+ } | {
246
+ case: undefined;
247
+ value?: undefined;
248
+ };
249
+ /**
250
+ * MaxTargets refuses a list longer than this (ENUMERATION_FAILED) rather
251
+ * than fire part of it. Zero is the platform's default of 1,000; the most
252
+ * is 10,000.
253
+ *
254
+ * @generated from field: uint32 max_targets = 3;
255
+ */
256
+ maxTargets: number;
257
+ };
258
+ /**
259
+ * Describes the message xeonr.pipelines.v1.Enumeration.
260
+ * Use `create(EnumerationSchema)` to create a new message.
261
+ */
262
+ export declare const EnumerationSchema: GenMessage<Enumeration>;
263
+ /**
264
+ * ScheduleOverride is what an owner may change about a declared schedule:
265
+ * the cron expression and the enabled flag, nothing else (XMB's
266
+ * ScheduleOverride).
267
+ *
268
+ * @generated from message xeonr.pipelines.v1.ScheduleOverride
269
+ */
270
+ export type ScheduleOverride = Message<"xeonr.pipelines.v1.ScheduleOverride"> & {
271
+ /**
272
+ * Cron, when set, replaces the declared expression; set to empty, it
273
+ * makes the schedule run-now only.
274
+ *
275
+ * @generated from field: optional string cron = 1;
276
+ */
277
+ cron?: string | undefined;
278
+ /**
279
+ * Enabled, when set, replaces the declared flag.
280
+ *
281
+ * @generated from field: optional bool enabled = 2;
282
+ */
283
+ enabled?: boolean | undefined;
284
+ /**
285
+ * SetBy and SetAt say who set it and when. Set by the platform.
286
+ *
287
+ * @generated from field: string set_by = 3;
288
+ */
289
+ setBy: string;
290
+ /**
291
+ * @generated from field: google.protobuf.Timestamp set_at = 4;
292
+ */
293
+ setAt?: Timestamp | undefined;
294
+ };
295
+ /**
296
+ * Describes the message xeonr.pipelines.v1.ScheduleOverride.
297
+ * Use `create(ScheduleOverrideSchema)` to create a new message.
298
+ */
299
+ export declare const ScheduleOverrideSchema: GenMessage<ScheduleOverride>;
300
+ /**
301
+ * Schedule is a cron schedule and what it starts.
302
+ *
303
+ * @generated from message xeonr.pipelines.v1.Schedule
304
+ */
305
+ export type Schedule = Message<"xeonr.pipelines.v1.Schedule"> & {
306
+ /**
307
+ * ID is assigned by the platform. Empty in a request that creates.
308
+ *
309
+ * @generated from field: string id = 1;
310
+ */
311
+ id: string;
312
+ /**
313
+ * Owner is fixed when the schedule is created.
314
+ *
315
+ * @generated from field: xeonr.pipelines.v1.ScheduleOwner owner = 2;
316
+ */
317
+ owner?: ScheduleOwner | undefined;
318
+ /**
319
+ * Name is unique per owner and never renamed: history is keyed by it
320
+ * (XMB's task key). Convention `<area>.<verb>`.
321
+ *
322
+ * @generated from field: string name = 3;
323
+ */
324
+ name: string;
325
+ /**
326
+ * @generated from field: string description = 4;
327
+ */
328
+ description: string;
329
+ /**
330
+ * Cron is the declared expression, in standard five-field form or a
331
+ * descriptor (`@hourly`, `@daily`). Empty is run-now only.
332
+ *
333
+ * @generated from field: string cron = 5;
334
+ */
335
+ cron: string;
336
+ /**
337
+ * CronLabel is the declared expression in plain words ("Every day at
338
+ * 4am"), written by its author. A console shows it while the declared
339
+ * expression applies, and the raw expression once overridden.
340
+ *
341
+ * @generated from field: string cron_label = 6;
342
+ */
343
+ cronLabel: string;
344
+ /**
345
+ * TimeZone is the IANA zone the expression is read in. Empty is UTC.
346
+ * Occurrences are stored in UTC.
347
+ *
348
+ * @generated from field: string time_zone = 7;
349
+ */
350
+ timeZone: string;
351
+ /**
352
+ * Enabled is the declared flag. A disabled schedule fires nothing and is
353
+ * still listed.
354
+ *
355
+ * @generated from field: bool enabled = 8;
356
+ */
357
+ enabled: boolean;
358
+ /**
359
+ * Target is what each occurrence starts.
360
+ *
361
+ * @generated from oneof xeonr.pipelines.v1.Schedule.target
362
+ */
363
+ target: {
364
+ /**
365
+ * @generated from field: xeonr.pipelines.v1.SchedulePipelineTarget pipeline = 9;
366
+ */
367
+ value: SchedulePipelineTarget;
368
+ case: "pipeline";
369
+ } | {
370
+ /**
371
+ * @generated from field: xeonr.pipelines.v1.ScheduleJobTarget job = 10;
372
+ */
373
+ value: ScheduleJobTarget;
374
+ case: "job";
375
+ } | {
376
+ /**
377
+ * Fire calls the schedule's tenant's own service, which starts the run.
378
+ *
379
+ * @generated from field: xeonr.pipelines.v1.ScheduleFireTarget fire = 28;
380
+ */
381
+ value: ScheduleFireTarget;
382
+ case: "fire";
383
+ } | {
384
+ case: undefined;
385
+ value?: undefined;
386
+ };
387
+ /**
388
+ * Enumerate, when set, fans each occurrence out to many targets.
389
+ *
390
+ * @generated from field: xeonr.pipelines.v1.Enumeration enumerate = 11;
391
+ */
392
+ enumerate?: Enumeration | undefined;
393
+ /**
394
+ * @generated from field: xeonr.pipelines.v1.MisfirePolicy misfire = 12;
395
+ */
396
+ misfire: MisfirePolicy;
397
+ /**
398
+ * CatchupWindow is how stale a missed occurrence may be and still fire,
399
+ * under LATEST. Unset is one hour; the most is seven days.
400
+ *
401
+ * @generated from field: google.protobuf.Duration catchup_window = 13;
402
+ */
403
+ catchupWindow?: Duration | undefined;
404
+ /**
405
+ * QueueWhilePending lets an occurrence fire although a run of the same
406
+ * schedule and target is still queued or running. Off by default: see
407
+ * SchedulesService.
408
+ *
409
+ * @generated from field: bool queue_while_pending = 14;
410
+ */
411
+ queueWhilePending: boolean;
412
+ /**
413
+ * Routine marks a high-frequency housekeeping schedule whose clean runs
414
+ * are noise: a console's recent activity leaves out its runs that
415
+ * succeeded with no issues, unless asked. A failed run, or one with
416
+ * issues, always shows.
417
+ *
418
+ * @generated from field: bool routine = 15;
419
+ */
420
+ routine: boolean;
421
+ /**
422
+ * Override is the owner's override, kept across SetSchedule. Set only
423
+ * by SetScheduleOverride.
424
+ *
425
+ * @generated from field: xeonr.pipelines.v1.ScheduleOverride override = 16;
426
+ */
427
+ override?: ScheduleOverride | undefined;
428
+ /**
429
+ * EffectiveCron and EffectiveEnabled are what applies: the override's
430
+ * where it has one, else the declaration's. CronOverridden says the
431
+ * expression is the override's. Set by the platform.
432
+ *
433
+ * @generated from field: string effective_cron = 17;
434
+ */
435
+ effectiveCron: string;
436
+ /**
437
+ * @generated from field: bool effective_enabled = 18;
438
+ */
439
+ effectiveEnabled: boolean;
440
+ /**
441
+ * @generated from field: bool cron_overridden = 19;
442
+ */
443
+ cronOverridden: boolean;
444
+ /**
445
+ * Paused is set by MarkSchedulePaused and cleared by MarkScheduleResumed.
446
+ *
447
+ * @generated from field: bool paused = 20;
448
+ */
449
+ paused: boolean;
450
+ /**
451
+ * @generated from field: google.protobuf.Timestamp paused_at = 21;
452
+ */
453
+ pausedAt?: Timestamp | undefined;
454
+ /**
455
+ * @generated from field: string paused_by = 22;
456
+ */
457
+ pausedBy: string;
458
+ /**
459
+ * NextOccurrence is the next time it will fire, computed when read;
460
+ * unset when disabled, paused or run-now only.
461
+ *
462
+ * @generated from field: google.protobuf.Timestamp next_occurrence = 23;
463
+ */
464
+ nextOccurrence?: Timestamp | undefined;
465
+ /**
466
+ * LastOccurrence is the most recent time it fired.
467
+ *
468
+ * @generated from field: google.protobuf.Timestamp last_occurrence = 24;
469
+ */
470
+ lastOccurrence?: Timestamp | undefined;
471
+ /**
472
+ * @generated from field: google.protobuf.Timestamp created_at = 25;
473
+ */
474
+ createdAt?: Timestamp | undefined;
475
+ /**
476
+ * @generated from field: google.protobuf.Timestamp updated_at = 26;
477
+ */
478
+ updatedAt?: Timestamp | undefined;
479
+ };
480
+ /**
481
+ * Describes the message xeonr.pipelines.v1.Schedule.
482
+ * Use `create(ScheduleSchema)` to create a new message.
483
+ */
484
+ export declare const ScheduleSchema: GenMessage<Schedule>;
485
+ /**
486
+ * ScheduleOccurrence is one target of one fired occurrence, or one upcoming
487
+ * occurrence.
488
+ *
489
+ * @generated from message xeonr.pipelines.v1.ScheduleOccurrence
490
+ */
491
+ export type ScheduleOccurrence = Message<"xeonr.pipelines.v1.ScheduleOccurrence"> & {
492
+ /**
493
+ * @generated from field: google.protobuf.Timestamp scheduled_for = 1;
494
+ */
495
+ scheduledFor?: Timestamp | undefined;
496
+ /**
497
+ * TargetKey is the target's key; empty for a schedule with one target.
498
+ *
499
+ * @generated from field: string target_key = 2;
500
+ */
501
+ targetKey: string;
502
+ /**
503
+ * @generated from field: string tenant = 3;
504
+ */
505
+ tenant: string;
506
+ /**
507
+ * Outcome is unset for an upcoming occurrence.
508
+ *
509
+ * @generated from field: xeonr.pipelines.v1.OccurrenceOutcome outcome = 4;
510
+ */
511
+ outcome: OccurrenceOutcome;
512
+ /**
513
+ * RunID and RunState are the run it started.
514
+ *
515
+ * @generated from field: string run_id = 5;
516
+ */
517
+ runId: string;
518
+ /**
519
+ * @generated from field: xeonr.pipelines.v1.RunState run_state = 6;
520
+ */
521
+ runState: RunState;
522
+ /**
523
+ * Message says why no run started, for SKIPPED, ENUMERATION_FAILED,
524
+ * REFUSED, DECLINED and GAVE_UP, and the last failed call while
525
+ * DELIVERING.
526
+ *
527
+ * @generated from field: string message = 7;
528
+ */
529
+ message: string;
530
+ /**
531
+ * @generated from field: google.protobuf.Timestamp fired_at = 8;
532
+ */
533
+ firedAt?: Timestamp | undefined;
534
+ /**
535
+ * FireID is the fire's id as the tenant's service sees it
536
+ * (FireScheduleRequest), for a fire target; empty otherwise.
537
+ *
538
+ * @generated from field: string fire_id = 9;
539
+ */
540
+ fireId: string;
541
+ /**
542
+ * Attempts counts the calls made to the tenant's service for the fire.
543
+ *
544
+ * @generated from field: uint32 attempts = 10;
545
+ */
546
+ attempts: number;
547
+ /**
548
+ * NextAttemptAt is when a DELIVERING fire is called again.
549
+ *
550
+ * @generated from field: google.protobuf.Timestamp next_attempt_at = 11;
551
+ */
552
+ nextAttemptAt?: Timestamp | undefined;
553
+ };
554
+ /**
555
+ * Describes the message xeonr.pipelines.v1.ScheduleOccurrence.
556
+ * Use `create(ScheduleOccurrenceSchema)` to create a new message.
557
+ */
558
+ export declare const ScheduleOccurrenceSchema: GenMessage<ScheduleOccurrence>;
559
+ /**
560
+ * @generated from message xeonr.pipelines.v1.SetScheduleRequest
561
+ */
562
+ export type SetScheduleRequest = Message<"xeonr.pipelines.v1.SetScheduleRequest"> & {
563
+ /**
564
+ * Schedule is matched on (owner, name). Its `id`, when given, must be the
565
+ * matched schedule's.
566
+ *
567
+ * @generated from field: xeonr.pipelines.v1.Schedule schedule = 1;
568
+ */
569
+ schedule?: Schedule | undefined;
570
+ /**
571
+ * UpdateMask narrows a write to an existing schedule to the fields it
572
+ * names. Ignored when the schedule is created.
573
+ *
574
+ * @generated from field: google.protobuf.FieldMask update_mask = 2;
575
+ */
576
+ updateMask?: FieldMask | undefined;
577
+ };
578
+ /**
579
+ * Describes the message xeonr.pipelines.v1.SetScheduleRequest.
580
+ * Use `create(SetScheduleRequestSchema)` to create a new message.
581
+ */
582
+ export declare const SetScheduleRequestSchema: GenMessage<SetScheduleRequest>;
583
+ /**
584
+ * @generated from message xeonr.pipelines.v1.SetScheduleResponse
585
+ */
586
+ export type SetScheduleResponse = Message<"xeonr.pipelines.v1.SetScheduleResponse"> & {
587
+ /**
588
+ * @generated from field: xeonr.pipelines.v1.Schedule schedule = 1;
589
+ */
590
+ schedule?: Schedule | undefined;
591
+ /**
592
+ * Created says the schedule did not exist before.
593
+ *
594
+ * @generated from field: bool created = 2;
595
+ */
596
+ created: boolean;
597
+ };
598
+ /**
599
+ * Describes the message xeonr.pipelines.v1.SetScheduleResponse.
600
+ * Use `create(SetScheduleResponseSchema)` to create a new message.
601
+ */
602
+ export declare const SetScheduleResponseSchema: GenMessage<SetScheduleResponse>;
603
+ /**
604
+ * @generated from message xeonr.pipelines.v1.GetScheduleRequest
605
+ */
606
+ export type GetScheduleRequest = Message<"xeonr.pipelines.v1.GetScheduleRequest"> & {
607
+ /**
608
+ * @generated from oneof xeonr.pipelines.v1.GetScheduleRequest.schedule
609
+ */
610
+ schedule: {
611
+ /**
612
+ * @generated from field: string schedule_id = 1;
613
+ */
614
+ value: string;
615
+ case: "scheduleId";
616
+ } | {
617
+ /**
618
+ * @generated from field: xeonr.pipelines.v1.ScheduleName by_name = 2;
619
+ */
620
+ value: ScheduleName;
621
+ case: "byName";
622
+ } | {
623
+ case: undefined;
624
+ value?: undefined;
625
+ };
626
+ };
627
+ /**
628
+ * Describes the message xeonr.pipelines.v1.GetScheduleRequest.
629
+ * Use `create(GetScheduleRequestSchema)` to create a new message.
630
+ */
631
+ export declare const GetScheduleRequestSchema: GenMessage<GetScheduleRequest>;
632
+ /**
633
+ * @generated from message xeonr.pipelines.v1.GetScheduleResponse
634
+ */
635
+ export type GetScheduleResponse = Message<"xeonr.pipelines.v1.GetScheduleResponse"> & {
636
+ /**
637
+ * @generated from field: xeonr.pipelines.v1.Schedule schedule = 1;
638
+ */
639
+ schedule?: Schedule | undefined;
640
+ };
641
+ /**
642
+ * Describes the message xeonr.pipelines.v1.GetScheduleResponse.
643
+ * Use `create(GetScheduleResponseSchema)` to create a new message.
644
+ */
645
+ export declare const GetScheduleResponseSchema: GenMessage<GetScheduleResponse>;
646
+ /**
647
+ * @generated from message xeonr.pipelines.v1.ListSchedulesRequest
648
+ */
649
+ export type ListSchedulesRequest = Message<"xeonr.pipelines.v1.ListSchedulesRequest"> & {
650
+ /**
651
+ * Tenant is the team whose schedules are listed.
652
+ *
653
+ * @generated from field: string tenant = 2;
654
+ */
655
+ tenant: string;
656
+ /**
657
+ * PipelineID narrows to the schedules that start one stored pipeline.
658
+ *
659
+ * @generated from field: string pipeline_id = 3;
660
+ */
661
+ pipelineId: string;
662
+ /**
663
+ * Cursor is opaque, empty for the first page.
664
+ *
665
+ * @generated from field: string cursor = 4;
666
+ */
667
+ cursor: string;
668
+ /**
669
+ * Limit is capped at 500; zero means the default of 50.
670
+ *
671
+ * @generated from field: uint32 limit = 5;
672
+ */
673
+ limit: number;
674
+ };
675
+ /**
676
+ * Describes the message xeonr.pipelines.v1.ListSchedulesRequest.
677
+ * Use `create(ListSchedulesRequestSchema)` to create a new message.
678
+ */
679
+ export declare const ListSchedulesRequestSchema: GenMessage<ListSchedulesRequest>;
680
+ /**
681
+ * @generated from message xeonr.pipelines.v1.ListSchedulesResponse
682
+ */
683
+ export type ListSchedulesResponse = Message<"xeonr.pipelines.v1.ListSchedulesResponse"> & {
684
+ /**
685
+ * @generated from field: repeated xeonr.pipelines.v1.Schedule schedules = 1;
686
+ */
687
+ schedules: Schedule[];
688
+ /**
689
+ * NextCursor is empty when there is no further page.
690
+ *
691
+ * @generated from field: string next_cursor = 2;
692
+ */
693
+ nextCursor: string;
694
+ };
695
+ /**
696
+ * Describes the message xeonr.pipelines.v1.ListSchedulesResponse.
697
+ * Use `create(ListSchedulesResponseSchema)` to create a new message.
698
+ */
699
+ export declare const ListSchedulesResponseSchema: GenMessage<ListSchedulesResponse>;
700
+ /**
701
+ * @generated from message xeonr.pipelines.v1.SetScheduleOverrideRequest
702
+ */
703
+ export type SetScheduleOverrideRequest = Message<"xeonr.pipelines.v1.SetScheduleOverrideRequest"> & {
704
+ /**
705
+ * @generated from field: string schedule_id = 1;
706
+ */
707
+ scheduleId: string;
708
+ /**
709
+ * Cron, when set, overrides the expression; empty makes it run-now only.
710
+ *
711
+ * @generated from field: optional string cron = 2;
712
+ */
713
+ cron?: string | undefined;
714
+ /**
715
+ * Enabled, when set, overrides the flag.
716
+ *
717
+ * validate:skip a bool has no bounds
718
+ *
719
+ * @generated from field: optional bool enabled = 3;
720
+ */
721
+ enabled?: boolean | undefined;
722
+ };
723
+ /**
724
+ * Describes the message xeonr.pipelines.v1.SetScheduleOverrideRequest.
725
+ * Use `create(SetScheduleOverrideRequestSchema)` to create a new message.
726
+ */
727
+ export declare const SetScheduleOverrideRequestSchema: GenMessage<SetScheduleOverrideRequest>;
728
+ /**
729
+ * @generated from message xeonr.pipelines.v1.SetScheduleOverrideResponse
730
+ */
731
+ export type SetScheduleOverrideResponse = Message<"xeonr.pipelines.v1.SetScheduleOverrideResponse"> & {
732
+ /**
733
+ * @generated from field: xeonr.pipelines.v1.Schedule schedule = 1;
734
+ */
735
+ schedule?: Schedule | undefined;
736
+ };
737
+ /**
738
+ * Describes the message xeonr.pipelines.v1.SetScheduleOverrideResponse.
739
+ * Use `create(SetScheduleOverrideResponseSchema)` to create a new message.
740
+ */
741
+ export declare const SetScheduleOverrideResponseSchema: GenMessage<SetScheduleOverrideResponse>;
742
+ /**
743
+ * @generated from message xeonr.pipelines.v1.MarkSchedulePausedRequest
744
+ */
745
+ export type MarkSchedulePausedRequest = Message<"xeonr.pipelines.v1.MarkSchedulePausedRequest"> & {
746
+ /**
747
+ * @generated from field: string schedule_id = 1;
748
+ */
749
+ scheduleId: string;
750
+ };
751
+ /**
752
+ * Describes the message xeonr.pipelines.v1.MarkSchedulePausedRequest.
753
+ * Use `create(MarkSchedulePausedRequestSchema)` to create a new message.
754
+ */
755
+ export declare const MarkSchedulePausedRequestSchema: GenMessage<MarkSchedulePausedRequest>;
756
+ /**
757
+ * @generated from message xeonr.pipelines.v1.MarkSchedulePausedResponse
758
+ */
759
+ export type MarkSchedulePausedResponse = Message<"xeonr.pipelines.v1.MarkSchedulePausedResponse"> & {
760
+ /**
761
+ * @generated from field: xeonr.pipelines.v1.Schedule schedule = 1;
762
+ */
763
+ schedule?: Schedule | undefined;
764
+ };
765
+ /**
766
+ * Describes the message xeonr.pipelines.v1.MarkSchedulePausedResponse.
767
+ * Use `create(MarkSchedulePausedResponseSchema)` to create a new message.
768
+ */
769
+ export declare const MarkSchedulePausedResponseSchema: GenMessage<MarkSchedulePausedResponse>;
770
+ /**
771
+ * @generated from message xeonr.pipelines.v1.MarkScheduleResumedRequest
772
+ */
773
+ export type MarkScheduleResumedRequest = Message<"xeonr.pipelines.v1.MarkScheduleResumedRequest"> & {
774
+ /**
775
+ * @generated from field: string schedule_id = 1;
776
+ */
777
+ scheduleId: string;
778
+ };
779
+ /**
780
+ * Describes the message xeonr.pipelines.v1.MarkScheduleResumedRequest.
781
+ * Use `create(MarkScheduleResumedRequestSchema)` to create a new message.
782
+ */
783
+ export declare const MarkScheduleResumedRequestSchema: GenMessage<MarkScheduleResumedRequest>;
784
+ /**
785
+ * @generated from message xeonr.pipelines.v1.MarkScheduleResumedResponse
786
+ */
787
+ export type MarkScheduleResumedResponse = Message<"xeonr.pipelines.v1.MarkScheduleResumedResponse"> & {
788
+ /**
789
+ * @generated from field: xeonr.pipelines.v1.Schedule schedule = 1;
790
+ */
791
+ schedule?: Schedule | undefined;
792
+ };
793
+ /**
794
+ * Describes the message xeonr.pipelines.v1.MarkScheduleResumedResponse.
795
+ * Use `create(MarkScheduleResumedResponseSchema)` to create a new message.
796
+ */
797
+ export declare const MarkScheduleResumedResponseSchema: GenMessage<MarkScheduleResumedResponse>;
798
+ /**
799
+ * @generated from message xeonr.pipelines.v1.DeleteScheduleRequest
800
+ */
801
+ export type DeleteScheduleRequest = Message<"xeonr.pipelines.v1.DeleteScheduleRequest"> & {
802
+ /**
803
+ * @generated from field: string schedule_id = 1;
804
+ */
805
+ scheduleId: string;
806
+ };
807
+ /**
808
+ * Describes the message xeonr.pipelines.v1.DeleteScheduleRequest.
809
+ * Use `create(DeleteScheduleRequestSchema)` to create a new message.
810
+ */
811
+ export declare const DeleteScheduleRequestSchema: GenMessage<DeleteScheduleRequest>;
812
+ /**
813
+ * @generated from message xeonr.pipelines.v1.DeleteScheduleResponse
814
+ */
815
+ export type DeleteScheduleResponse = Message<"xeonr.pipelines.v1.DeleteScheduleResponse"> & {};
816
+ /**
817
+ * Describes the message xeonr.pipelines.v1.DeleteScheduleResponse.
818
+ * Use `create(DeleteScheduleResponseSchema)` to create a new message.
819
+ */
820
+ export declare const DeleteScheduleResponseSchema: GenMessage<DeleteScheduleResponse>;
821
+ /**
822
+ * @generated from message xeonr.pipelines.v1.CreateScheduleRunRequest
823
+ */
824
+ export type CreateScheduleRunRequest = Message<"xeonr.pipelines.v1.CreateScheduleRunRequest"> & {
825
+ /**
826
+ * @generated from field: string schedule_id = 1;
827
+ */
828
+ scheduleId: string;
829
+ /**
830
+ * TargetKey runs only that target. Empty runs every target, enumerated
831
+ * now.
832
+ *
833
+ * @generated from field: string target_key = 2;
834
+ */
835
+ targetKey: string;
836
+ /**
837
+ * Force runs a target although one of its runs is still pending.
838
+ *
839
+ * validate:skip a bool has no bounds
840
+ *
841
+ * @generated from field: bool force = 3;
842
+ */
843
+ force: boolean;
844
+ };
845
+ /**
846
+ * Describes the message xeonr.pipelines.v1.CreateScheduleRunRequest.
847
+ * Use `create(CreateScheduleRunRequestSchema)` to create a new message.
848
+ */
849
+ export declare const CreateScheduleRunRequestSchema: GenMessage<CreateScheduleRunRequest>;
850
+ /**
851
+ * @generated from message xeonr.pipelines.v1.CreateScheduleRunResponse
852
+ */
853
+ export type CreateScheduleRunResponse = Message<"xeonr.pipelines.v1.CreateScheduleRunResponse"> & {
854
+ /**
855
+ * Runs are the runs started, one per target that was not skipped.
856
+ *
857
+ * @generated from field: repeated xeonr.pipelines.v1.Run runs = 1;
858
+ */
859
+ runs: Run[];
860
+ /**
861
+ * Skipped counts targets skipped while pending.
862
+ *
863
+ * @generated from field: uint32 skipped = 2;
864
+ */
865
+ skipped: number;
866
+ /**
867
+ * Fired are a fire target's fires, one per target not skipped: the
868
+ * tenant's service starts their runs, so none is in `runs`. Follow them in
869
+ * ListScheduleOccurrences.
870
+ *
871
+ * @generated from field: repeated xeonr.pipelines.v1.ScheduleOccurrence fired = 3;
872
+ */
873
+ fired: ScheduleOccurrence[];
874
+ };
875
+ /**
876
+ * Describes the message xeonr.pipelines.v1.CreateScheduleRunResponse.
877
+ * Use `create(CreateScheduleRunResponseSchema)` to create a new message.
878
+ */
879
+ export declare const CreateScheduleRunResponseSchema: GenMessage<CreateScheduleRunResponse>;
880
+ /**
881
+ * @generated from message xeonr.pipelines.v1.ListScheduleOccurrencesRequest
882
+ */
883
+ export type ListScheduleOccurrencesRequest = Message<"xeonr.pipelines.v1.ListScheduleOccurrencesRequest"> & {
884
+ /**
885
+ * @generated from field: string schedule_id = 1;
886
+ */
887
+ scheduleId: string;
888
+ /**
889
+ * Upcoming is how many future occurrences to compute. Zero means 5; the
890
+ * most is 50.
891
+ *
892
+ * @generated from field: uint32 upcoming = 2;
893
+ */
894
+ upcoming: number;
895
+ /**
896
+ * Cursor is opaque, empty for the first page of past occurrences.
897
+ *
898
+ * @generated from field: string cursor = 3;
899
+ */
900
+ cursor: string;
901
+ /**
902
+ * Limit is capped at 500; zero means the default of 50.
903
+ *
904
+ * @generated from field: uint32 limit = 4;
905
+ */
906
+ limit: number;
907
+ };
908
+ /**
909
+ * Describes the message xeonr.pipelines.v1.ListScheduleOccurrencesRequest.
910
+ * Use `create(ListScheduleOccurrencesRequestSchema)` to create a new message.
911
+ */
912
+ export declare const ListScheduleOccurrencesRequestSchema: GenMessage<ListScheduleOccurrencesRequest>;
913
+ /**
914
+ * @generated from message xeonr.pipelines.v1.ListScheduleOccurrencesResponse
915
+ */
916
+ export type ListScheduleOccurrencesResponse = Message<"xeonr.pipelines.v1.ListScheduleOccurrencesResponse"> & {
917
+ /**
918
+ * Upcoming are the next occurrences, soonest first, with no outcome.
919
+ *
920
+ * @generated from field: repeated xeonr.pipelines.v1.ScheduleOccurrence upcoming = 1;
921
+ */
922
+ upcoming: ScheduleOccurrence[];
923
+ /**
924
+ * Past are fired occurrences, newest first, one per target.
925
+ *
926
+ * @generated from field: repeated xeonr.pipelines.v1.ScheduleOccurrence past = 2;
927
+ */
928
+ past: ScheduleOccurrence[];
929
+ /**
930
+ * NextCursor is empty when there is no further page.
931
+ *
932
+ * @generated from field: string next_cursor = 3;
933
+ */
934
+ nextCursor: string;
935
+ };
936
+ /**
937
+ * Describes the message xeonr.pipelines.v1.ListScheduleOccurrencesResponse.
938
+ * Use `create(ListScheduleOccurrencesResponseSchema)` to create a new message.
939
+ */
940
+ export declare const ListScheduleOccurrencesResponseSchema: GenMessage<ListScheduleOccurrencesResponse>;
941
+ /**
942
+ * MisfirePolicy is what a schedule does about occurrences it missed (the
943
+ * platform was down, or a tick ran late).
944
+ *
945
+ * @generated from enum xeonr.pipelines.v1.MisfirePolicy
946
+ */
947
+ export declare enum MisfirePolicy {
948
+ /**
949
+ * The default: LATEST.
950
+ *
951
+ * @generated from enum value: MISFIRE_POLICY_UNSPECIFIED = 0;
952
+ */
953
+ UNSPECIFIED = 0,
954
+ /**
955
+ * Fire the most recent missed occurrence, if it is within
956
+ * `catchup_window`, and no other.
957
+ *
958
+ * @generated from enum value: MISFIRE_POLICY_LATEST = 1;
959
+ */
960
+ LATEST = 1,
961
+ /**
962
+ * Fire nothing that was missed.
963
+ *
964
+ * @generated from enum value: MISFIRE_POLICY_SKIP = 2;
965
+ */
966
+ SKIP = 2
967
+ }
968
+ /**
969
+ * Describes the enum xeonr.pipelines.v1.MisfirePolicy.
970
+ */
971
+ export declare const MisfirePolicySchema: GenEnum<MisfirePolicy>;
972
+ /**
973
+ * OccurrenceOutcome is what became of one target of one occurrence.
974
+ *
975
+ * @generated from enum xeonr.pipelines.v1.OccurrenceOutcome
976
+ */
977
+ export declare enum OccurrenceOutcome {
978
+ /**
979
+ * @generated from enum value: OCCURRENCE_OUTCOME_UNSPECIFIED = 0;
980
+ */
981
+ UNSPECIFIED = 0,
982
+ /**
983
+ * A run was started; `run_id` names it.
984
+ *
985
+ * @generated from enum value: OCCURRENCE_OUTCOME_STARTED = 1;
986
+ */
987
+ STARTED = 1,
988
+ /**
989
+ * Skipped: a run of the same schedule and target was still queued or
990
+ * running, and `queue_while_pending` is off.
991
+ *
992
+ * @generated from enum value: OCCURRENCE_OUTCOME_SKIPPED_PENDING = 2;
993
+ */
994
+ SKIPPED_PENDING = 2,
995
+ /**
996
+ * The enumeration handler failed or returned an invalid list, so no
997
+ * target was known; `message` says why.
998
+ *
999
+ * @generated from enum value: OCCURRENCE_OUTCOME_ENUMERATION_FAILED = 3;
1000
+ */
1001
+ ENUMERATION_FAILED = 3,
1002
+ /**
1003
+ * The run could not be created (the pipeline archived, a quota, a
1004
+ * refusal of CreateRun); `message` says why.
1005
+ *
1006
+ * @generated from enum value: OCCURRENCE_OUTCOME_REFUSED = 4;
1007
+ */
1008
+ REFUSED = 4,
1009
+ /**
1010
+ * A fire target's fire is being delivered: called, or waiting to be
1011
+ * called again (`attempts`, `next_attempt_at`, `message` the last
1012
+ * failure). Not settled yet.
1013
+ *
1014
+ * @generated from enum value: OCCURRENCE_OUTCOME_DELIVERING = 5;
1015
+ */
1016
+ DELIVERING = 5,
1017
+ /**
1018
+ * The tenant's service answered that it started no run, or refused the call with a
1019
+ * permanent error; `message` says why.
1020
+ *
1021
+ * @generated from enum value: OCCURRENCE_OUTCOME_DECLINED = 6;
1022
+ */
1023
+ DECLINED = 6,
1024
+ /**
1025
+ * Every call of the fire failed, up to the bound; `message` is the last
1026
+ * failure. Nothing retries it.
1027
+ *
1028
+ * @generated from enum value: OCCURRENCE_OUTCOME_GAVE_UP = 7;
1029
+ */
1030
+ GAVE_UP = 7
1031
+ }
1032
+ /**
1033
+ * Describes the enum xeonr.pipelines.v1.OccurrenceOutcome.
1034
+ */
1035
+ export declare const OccurrenceOutcomeSchema: GenEnum<OccurrenceOutcome>;
1036
+ /**
1037
+ * SchedulesService holds cron schedules: platform-design §6.2's `cron`
1038
+ * trigger and design-v1 §5.2, built to XMB's scheduler (`xeonr/xmb/api`
1039
+ * `pkg/scheduler`), which the platform absorbs so that XMB can adopt it.
1040
+ * Event triggers are not here: a consuming service reacts to its own events
1041
+ * and calls CreateRun. Milestone 4.
1042
+ *
1043
+ * A schedule starts, at each occurrence of its cron expression, a published
1044
+ * version of a stored pipeline, a job to a worker handler, or a call to its
1045
+ * tenant's own service (ScheduleFireTarget, PIPE-111), once per target. Each
1046
+ * occurrence is one row, unique on (schedule, target key,
1047
+ * scheduled-for): every API replica computes the same occurrence and tries
1048
+ * to insert it, and exactly one insert wins. There is no leader election,
1049
+ * no last-run-at column and no lock: the unique index is the authority, so
1050
+ * an occurrence fires at most once whatever the replicas, restarts or
1051
+ * overlapping ticks. The next occurrence is a pure function of the clock
1052
+ * and the expression, computed when read, never stored.
1053
+ *
1054
+ * Misfire. After an outage only the most recent missed occurrence within
1055
+ * `catchup_window` is fired (policy LATEST), never a backlog: three days down
1056
+ * fires one run, not seventy-two. SKIP fires none. The window must stay far
1057
+ * below the platform's run retention, or a pruned occurrence would fire
1058
+ * twice (the server checks at boot).
1059
+ *
1060
+ * Overlap. Unless `queue_while_pending` is set, an occurrence is skipped
1061
+ * while a run of the same schedule and target is still queued or running:
1062
+ * a ten-minute job on a five-minute cron otherwise grows a queue that never
1063
+ * drains, and the safe behaviour is the zero value.
1064
+ *
1065
+ * Override. A consuming service declares its schedules (SetSchedule),
1066
+ * typically at boot, as XMB's code declares its tasks. The owner may override
1067
+ * just the cron expression and the enabled flag (SetScheduleOverride); the
1068
+ * override survives the service setting the schedule again, exactly as XMB's
1069
+ * `XMB_SCHEDULER_SCHEDULES` survives a deploy. `cron_overridden` tells a
1070
+ * console to show the expression rather than a `cron_label` that no longer
1071
+ * describes it.
1072
+ *
1073
+ * Enumeration. One schedule can fan out to many runs per occurrence, one per
1074
+ * target, re-enumerated at every occurrence so new resources are picked up
1075
+ * with no re-registration (platform-design §6.2, design-v1 §5.2). The
1076
+ * platform does not resolve a consuming service's resources, so the service
1077
+ * supplies the list, in either of two ways: a stored list on the schedule,
1078
+ * for a small set that changes when the service says so (it sets the
1079
+ * schedule again); or a worker handler of the tenant, run as a job at each
1080
+ * occurrence, whose `targets` output is the list, for a set only the
1081
+ * service's database knows and that changes on its own (XMB's per-server
1082
+ * tasks enumerate servers from its database). Both exist because neither
1083
+ * covers the other: a stored list cannot follow the service's data, and a
1084
+ * handler is a worker the service must run. Every target's run is the
1085
+ * schedule's tenant's.
1086
+ *
1087
+ * Ownership, like queues: a schedule belongs to one tenant
1088
+ * (`owner.tenant`), and a schedule that starts a stored pipeline must start
1089
+ * one of that tenant's. Set and changed by the tenant's members that are
1090
+ * service accounts, and by the platform's operators; the override, pause and
1091
+ * run-now likewise. It is read by the tenant's members and by operators.
1092
+ * People who are not operators never write. A schedule the caller may not
1093
+ * read answers `not_found`.
1094
+ *
1095
+ * Fire target. A schedule may call its tenant's own service rather than
1096
+ * start a run: at each occurrence (and run-now) pipelines calls the
1097
+ * service's ScheduleTargetService.FireSchedule at the tenant's registered
1098
+ * sink, with a stable fire id, and the service starts the run itself with
1099
+ * its own definition and attested facts. The clock, override, pause, misfire
1100
+ * policy, enumeration and `queue_while_pending` behave as for any target;
1101
+ * the occurrence is DELIVERING until the service answers, then STARTED
1102
+ * (linked to the run the service names, when it is the tenant's), DECLINED
1103
+ * (with the service's reason), or GAVE_UP after the bounded retries. Only
1104
+ * the tenant's service-account members may set such a schedule, and it
1105
+ * calls only that tenant's sink.
1106
+ *
1107
+ * Verbs outside api.rpc-naming's: none. CreateScheduleRun creates a run;
1108
+ * MarkSchedulePaused and MarkScheduleResumed use `Mark`.
1109
+ *
1110
+ * @generated from service xeonr.pipelines.v1.SchedulesService
1111
+ */
1112
+ export declare const SchedulesService: GenService<{
1113
+ /**
1114
+ * @generated from rpc xeonr.pipelines.v1.SchedulesService.SetSchedule
1115
+ */
1116
+ setSchedule: {
1117
+ methodKind: "unary";
1118
+ input: typeof SetScheduleRequestSchema;
1119
+ output: typeof SetScheduleResponseSchema;
1120
+ };
1121
+ /**
1122
+ * @generated from rpc xeonr.pipelines.v1.SchedulesService.GetSchedule
1123
+ */
1124
+ getSchedule: {
1125
+ methodKind: "unary";
1126
+ input: typeof GetScheduleRequestSchema;
1127
+ output: typeof GetScheduleResponseSchema;
1128
+ };
1129
+ /**
1130
+ * @generated from rpc xeonr.pipelines.v1.SchedulesService.ListSchedules
1131
+ */
1132
+ listSchedules: {
1133
+ methodKind: "unary";
1134
+ input: typeof ListSchedulesRequestSchema;
1135
+ output: typeof ListSchedulesResponseSchema;
1136
+ };
1137
+ /**
1138
+ * @generated from rpc xeonr.pipelines.v1.SchedulesService.SetScheduleOverride
1139
+ */
1140
+ setScheduleOverride: {
1141
+ methodKind: "unary";
1142
+ input: typeof SetScheduleOverrideRequestSchema;
1143
+ output: typeof SetScheduleOverrideResponseSchema;
1144
+ };
1145
+ /**
1146
+ * @generated from rpc xeonr.pipelines.v1.SchedulesService.MarkSchedulePaused
1147
+ */
1148
+ markSchedulePaused: {
1149
+ methodKind: "unary";
1150
+ input: typeof MarkSchedulePausedRequestSchema;
1151
+ output: typeof MarkSchedulePausedResponseSchema;
1152
+ };
1153
+ /**
1154
+ * @generated from rpc xeonr.pipelines.v1.SchedulesService.MarkScheduleResumed
1155
+ */
1156
+ markScheduleResumed: {
1157
+ methodKind: "unary";
1158
+ input: typeof MarkScheduleResumedRequestSchema;
1159
+ output: typeof MarkScheduleResumedResponseSchema;
1160
+ };
1161
+ /**
1162
+ * @generated from rpc xeonr.pipelines.v1.SchedulesService.DeleteSchedule
1163
+ */
1164
+ deleteSchedule: {
1165
+ methodKind: "unary";
1166
+ input: typeof DeleteScheduleRequestSchema;
1167
+ output: typeof DeleteScheduleResponseSchema;
1168
+ };
1169
+ /**
1170
+ * @generated from rpc xeonr.pipelines.v1.SchedulesService.CreateScheduleRun
1171
+ */
1172
+ createScheduleRun: {
1173
+ methodKind: "unary";
1174
+ input: typeof CreateScheduleRunRequestSchema;
1175
+ output: typeof CreateScheduleRunResponseSchema;
1176
+ };
1177
+ /**
1178
+ * @generated from rpc xeonr.pipelines.v1.SchedulesService.ListScheduleOccurrences
1179
+ */
1180
+ listScheduleOccurrences: {
1181
+ methodKind: "unary";
1182
+ input: typeof ListScheduleOccurrencesRequestSchema;
1183
+ output: typeof ListScheduleOccurrencesResponseSchema;
1184
+ };
1185
+ }>;
1186
+ //# sourceMappingURL=schedules_pb.d.ts.map