@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,711 @@
1
+ import type { GenFile, GenMessage, GenService } from "@bufbuild/protobuf/codegenv2";
2
+ import type { Duration, FieldMask, Timestamp } from "@bufbuild/protobuf/wkt";
3
+ import type { RunState } from "./common_pb.js";
4
+ import type { Retry } from "./definition_pb.js";
5
+ import type { Run } from "./runs_pb.js";
6
+ import type { Message } from "@bufbuild/protobuf";
7
+ /**
8
+ * Describes the file xeonr/pipelines/v1/queues.proto.
9
+ */
10
+ export declare const file_xeonr_pipelines_v1_queues: GenFile;
11
+ /**
12
+ * QueueOwner is who a queue belongs to: one tenant.
13
+ *
14
+ * @generated from message xeonr.pipelines.v1.QueueOwner
15
+ */
16
+ export type QueueOwner = Message<"xeonr.pipelines.v1.QueueOwner"> & {
17
+ /**
18
+ * Tenant is the team URN the queue belongs to; it admits only that team's
19
+ * jobs.
20
+ *
21
+ * @generated from field: string tenant = 2;
22
+ */
23
+ tenant: string;
24
+ };
25
+ /**
26
+ * Describes the message xeonr.pipelines.v1.QueueOwner.
27
+ * Use `create(QueueOwnerSchema)` to create a new message.
28
+ */
29
+ export declare const QueueOwnerSchema: GenMessage<QueueOwner>;
30
+ /**
31
+ * QueueName names a queue by its owner and its name.
32
+ *
33
+ * @generated from message xeonr.pipelines.v1.QueueName
34
+ */
35
+ export type QueueName = Message<"xeonr.pipelines.v1.QueueName"> & {
36
+ /**
37
+ * @generated from field: xeonr.pipelines.v1.QueueOwner owner = 1;
38
+ */
39
+ owner?: QueueOwner | undefined;
40
+ /**
41
+ * @generated from field: string name = 2;
42
+ */
43
+ name: string;
44
+ };
45
+ /**
46
+ * Describes the message xeonr.pipelines.v1.QueueName.
47
+ * Use `create(QueueNameSchema)` to create a new message.
48
+ */
49
+ export declare const QueueNameSchema: GenMessage<QueueName>;
50
+ /**
51
+ * RateLimit caps how fast a queue starts work: at most `limit` attempts
52
+ * claimed per sliding `window`, retries included, on the database's clock.
53
+ * An attempt over the limit stays waiting.
54
+ *
55
+ * @generated from message xeonr.pipelines.v1.RateLimit
56
+ */
57
+ export type RateLimit = Message<"xeonr.pipelines.v1.RateLimit"> & {
58
+ /**
59
+ * @generated from field: uint32 limit = 1;
60
+ */
61
+ limit: number;
62
+ /**
63
+ * @generated from field: google.protobuf.Duration window = 2;
64
+ */
65
+ window?: Duration | undefined;
66
+ };
67
+ /**
68
+ * Describes the message xeonr.pipelines.v1.RateLimit.
69
+ * Use `create(RateLimitSchema)` to create a new message.
70
+ */
71
+ export declare const RateLimitSchema: GenMessage<RateLimit>;
72
+ /**
73
+ * Queue is a lane jobs are admitted through. See QueuesService for what it
74
+ * decides and what it does not.
75
+ *
76
+ * @generated from message xeonr.pipelines.v1.Queue
77
+ */
78
+ export type Queue = Message<"xeonr.pipelines.v1.Queue"> & {
79
+ /**
80
+ * ID is assigned by the platform. Empty in a request that creates.
81
+ *
82
+ * @generated from field: string id = 1;
83
+ */
84
+ id: string;
85
+ /**
86
+ * Owner is fixed when the queue is created.
87
+ *
88
+ * @generated from field: xeonr.pipelines.v1.QueueOwner owner = 2;
89
+ */
90
+ owner?: QueueOwner | undefined;
91
+ /**
92
+ * Name is unique per owner, and with the owner is what SetQueue matches
93
+ * on and what CreateJobRequest.queue names. `default` is the tenant's
94
+ * default queue.
95
+ *
96
+ * @generated from field: string name = 3;
97
+ */
98
+ name: string;
99
+ /**
100
+ * @generated from field: string description = 4;
101
+ */
102
+ description: string;
103
+ /**
104
+ * MaxConcurrency caps the queue's CLAIMED and RUNNING attempts, all
105
+ * lanes together. Zero is no cap of the queue's own.
106
+ *
107
+ * @generated from field: uint32 max_concurrency = 5;
108
+ */
109
+ maxConcurrency: number;
110
+ /**
111
+ * MaxConcurrencyPerTenant caps one lane's CLAIMED and RUNNING attempts
112
+ * in this queue (the tenant's jobs with no fairness key, or those of one
113
+ * key): a lane at its cap is passed over until one finishes. Zero is no
114
+ * per-lane cap (fairness still orders claims).
115
+ *
116
+ * @generated from field: uint32 max_concurrency_per_tenant = 6;
117
+ */
118
+ maxConcurrencyPerTenant: number;
119
+ /**
120
+ * RateLimit, when set, caps attempts started per window.
121
+ *
122
+ * @generated from field: xeonr.pipelines.v1.RateLimit rate_limit = 7;
123
+ */
124
+ rateLimit?: RateLimit | undefined;
125
+ /**
126
+ * DefaultRetry is the retry policy of a job that gives none, and the most
127
+ * a job may ask for: a job's `retry.max` may not exceed it, and its
128
+ * `retry.when` may list only classes this one retries (an empty `when`
129
+ * here is the platform's transient set). Unset is the platform's default,
130
+ * with the platform's bounds. A job that asks for more is refused by
131
+ * CreateJob with `invalid_argument`.
132
+ *
133
+ * @generated from field: xeonr.pipelines.v1.Retry default_retry = 8;
134
+ */
135
+ defaultRetry?: Retry | undefined;
136
+ /**
137
+ * DefaultTimeout is the timeout of a job that gives none, and the most a
138
+ * job may ask for; a longer one is refused with `invalid_argument`. Unset
139
+ * is the platform's default and bound.
140
+ *
141
+ * @generated from field: google.protobuf.Duration default_timeout = 9;
142
+ */
143
+ defaultTimeout?: Duration | undefined;
144
+ /**
145
+ * Priority orders the tenant's queues for a worker that could claim
146
+ * from several (one handler fed by two queues): every claimable job of a
147
+ * priority-1 queue is handed out before any of a priority-2 one. Zero
148
+ * means 1.
149
+ *
150
+ * @generated from field: uint32 priority = 10;
151
+ */
152
+ priority: number;
153
+ /**
154
+ * Paused is set by MarkQueuePaused and cleared by MarkQueueResumed; it is
155
+ * not written by SetQueue. A paused queue accepts jobs and starts none.
156
+ *
157
+ * @generated from field: bool paused = 11;
158
+ */
159
+ paused: boolean;
160
+ /**
161
+ * @generated from field: google.protobuf.Timestamp paused_at = 12;
162
+ */
163
+ pausedAt?: Timestamp | undefined;
164
+ /**
165
+ * PausedBy is the subject URN that paused it.
166
+ *
167
+ * @generated from field: string paused_by = 13;
168
+ */
169
+ pausedBy: string;
170
+ /**
171
+ * PausedReason is the reason MarkQueuePaused was given.
172
+ *
173
+ * @generated from field: string paused_reason = 14;
174
+ */
175
+ pausedReason: string;
176
+ /**
177
+ * CreatedAt and UpdatedAt are set by the platform.
178
+ *
179
+ * @generated from field: google.protobuf.Timestamp created_at = 15;
180
+ */
181
+ createdAt?: Timestamp | undefined;
182
+ /**
183
+ * @generated from field: google.protobuf.Timestamp updated_at = 16;
184
+ */
185
+ updatedAt?: Timestamp | undefined;
186
+ };
187
+ /**
188
+ * Describes the message xeonr.pipelines.v1.Queue.
189
+ * Use `create(QueueSchema)` to create a new message.
190
+ */
191
+ export declare const QueueSchema: GenMessage<Queue>;
192
+ /**
193
+ * @generated from message xeonr.pipelines.v1.SetQueueRequest
194
+ */
195
+ export type SetQueueRequest = Message<"xeonr.pipelines.v1.SetQueueRequest"> & {
196
+ /**
197
+ * Queue is matched on (owner, name). Its `id`, when given, must be the
198
+ * matched queue's.
199
+ *
200
+ * @generated from field: xeonr.pipelines.v1.Queue queue = 1;
201
+ */
202
+ queue?: Queue | undefined;
203
+ /**
204
+ * UpdateMask narrows a write to an existing queue to the fields it names.
205
+ * Omitted, the whole queue is replaced. Ignored when the queue is
206
+ * created.
207
+ *
208
+ * @generated from field: google.protobuf.FieldMask update_mask = 2;
209
+ */
210
+ updateMask?: FieldMask | undefined;
211
+ };
212
+ /**
213
+ * Describes the message xeonr.pipelines.v1.SetQueueRequest.
214
+ * Use `create(SetQueueRequestSchema)` to create a new message.
215
+ */
216
+ export declare const SetQueueRequestSchema: GenMessage<SetQueueRequest>;
217
+ /**
218
+ * @generated from message xeonr.pipelines.v1.SetQueueResponse
219
+ */
220
+ export type SetQueueResponse = Message<"xeonr.pipelines.v1.SetQueueResponse"> & {
221
+ /**
222
+ * @generated from field: xeonr.pipelines.v1.Queue queue = 1;
223
+ */
224
+ queue?: Queue | undefined;
225
+ /**
226
+ * Created says the queue did not exist before.
227
+ *
228
+ * @generated from field: bool created = 2;
229
+ */
230
+ created: boolean;
231
+ };
232
+ /**
233
+ * Describes the message xeonr.pipelines.v1.SetQueueResponse.
234
+ * Use `create(SetQueueResponseSchema)` to create a new message.
235
+ */
236
+ export declare const SetQueueResponseSchema: GenMessage<SetQueueResponse>;
237
+ /**
238
+ * @generated from message xeonr.pipelines.v1.GetQueueRequest
239
+ */
240
+ export type GetQueueRequest = Message<"xeonr.pipelines.v1.GetQueueRequest"> & {
241
+ /**
242
+ * Queue names the queue to read.
243
+ *
244
+ * @generated from oneof xeonr.pipelines.v1.GetQueueRequest.queue
245
+ */
246
+ queue: {
247
+ /**
248
+ * QueueID is the queue's id.
249
+ *
250
+ * @generated from field: string queue_id = 1;
251
+ */
252
+ value: string;
253
+ case: "queueId";
254
+ } | {
255
+ /**
256
+ * ByName is the queue's owner and name.
257
+ *
258
+ * @generated from field: xeonr.pipelines.v1.QueueName by_name = 2;
259
+ */
260
+ value: QueueName;
261
+ case: "byName";
262
+ } | {
263
+ case: undefined;
264
+ value?: undefined;
265
+ };
266
+ };
267
+ /**
268
+ * Describes the message xeonr.pipelines.v1.GetQueueRequest.
269
+ * Use `create(GetQueueRequestSchema)` to create a new message.
270
+ */
271
+ export declare const GetQueueRequestSchema: GenMessage<GetQueueRequest>;
272
+ /**
273
+ * @generated from message xeonr.pipelines.v1.GetQueueResponse
274
+ */
275
+ export type GetQueueResponse = Message<"xeonr.pipelines.v1.GetQueueResponse"> & {
276
+ /**
277
+ * @generated from field: xeonr.pipelines.v1.Queue queue = 1;
278
+ */
279
+ queue?: Queue | undefined;
280
+ };
281
+ /**
282
+ * Describes the message xeonr.pipelines.v1.GetQueueResponse.
283
+ * Use `create(GetQueueResponseSchema)` to create a new message.
284
+ */
285
+ export declare const GetQueueResponseSchema: GenMessage<GetQueueResponse>;
286
+ /**
287
+ * @generated from message xeonr.pipelines.v1.ListQueuesRequest
288
+ */
289
+ export type ListQueuesRequest = Message<"xeonr.pipelines.v1.ListQueuesRequest"> & {
290
+ /**
291
+ * Tenant is the team whose queues are listed.
292
+ *
293
+ * @generated from field: string tenant = 2;
294
+ */
295
+ tenant: string;
296
+ /**
297
+ * Cursor is opaque, empty for the first page.
298
+ *
299
+ * @generated from field: string cursor = 3;
300
+ */
301
+ cursor: string;
302
+ /**
303
+ * Limit is capped at 500; zero means the default of 50.
304
+ *
305
+ * @generated from field: uint32 limit = 4;
306
+ */
307
+ limit: number;
308
+ };
309
+ /**
310
+ * Describes the message xeonr.pipelines.v1.ListQueuesRequest.
311
+ * Use `create(ListQueuesRequestSchema)` to create a new message.
312
+ */
313
+ export declare const ListQueuesRequestSchema: GenMessage<ListQueuesRequest>;
314
+ /**
315
+ * @generated from message xeonr.pipelines.v1.ListQueuesResponse
316
+ */
317
+ export type ListQueuesResponse = Message<"xeonr.pipelines.v1.ListQueuesResponse"> & {
318
+ /**
319
+ * @generated from field: repeated xeonr.pipelines.v1.Queue queues = 1;
320
+ */
321
+ queues: Queue[];
322
+ /**
323
+ * NextCursor is empty when there is no further page.
324
+ *
325
+ * @generated from field: string next_cursor = 2;
326
+ */
327
+ nextCursor: string;
328
+ };
329
+ /**
330
+ * Describes the message xeonr.pipelines.v1.ListQueuesResponse.
331
+ * Use `create(ListQueuesResponseSchema)` to create a new message.
332
+ */
333
+ export declare const ListQueuesResponseSchema: GenMessage<ListQueuesResponse>;
334
+ /**
335
+ * @generated from message xeonr.pipelines.v1.MarkQueuePausedRequest
336
+ */
337
+ export type MarkQueuePausedRequest = Message<"xeonr.pipelines.v1.MarkQueuePausedRequest"> & {
338
+ /**
339
+ * @generated from field: string queue_id = 1;
340
+ */
341
+ queueId: string;
342
+ /**
343
+ * Reason is shown with the queue while it is paused.
344
+ *
345
+ * @generated from field: string reason = 2;
346
+ */
347
+ reason: string;
348
+ };
349
+ /**
350
+ * Describes the message xeonr.pipelines.v1.MarkQueuePausedRequest.
351
+ * Use `create(MarkQueuePausedRequestSchema)` to create a new message.
352
+ */
353
+ export declare const MarkQueuePausedRequestSchema: GenMessage<MarkQueuePausedRequest>;
354
+ /**
355
+ * @generated from message xeonr.pipelines.v1.MarkQueuePausedResponse
356
+ */
357
+ export type MarkQueuePausedResponse = Message<"xeonr.pipelines.v1.MarkQueuePausedResponse"> & {
358
+ /**
359
+ * @generated from field: xeonr.pipelines.v1.Queue queue = 1;
360
+ */
361
+ queue?: Queue | undefined;
362
+ };
363
+ /**
364
+ * Describes the message xeonr.pipelines.v1.MarkQueuePausedResponse.
365
+ * Use `create(MarkQueuePausedResponseSchema)` to create a new message.
366
+ */
367
+ export declare const MarkQueuePausedResponseSchema: GenMessage<MarkQueuePausedResponse>;
368
+ /**
369
+ * @generated from message xeonr.pipelines.v1.MarkQueueResumedRequest
370
+ */
371
+ export type MarkQueueResumedRequest = Message<"xeonr.pipelines.v1.MarkQueueResumedRequest"> & {
372
+ /**
373
+ * @generated from field: string queue_id = 1;
374
+ */
375
+ queueId: string;
376
+ };
377
+ /**
378
+ * Describes the message xeonr.pipelines.v1.MarkQueueResumedRequest.
379
+ * Use `create(MarkQueueResumedRequestSchema)` to create a new message.
380
+ */
381
+ export declare const MarkQueueResumedRequestSchema: GenMessage<MarkQueueResumedRequest>;
382
+ /**
383
+ * @generated from message xeonr.pipelines.v1.MarkQueueResumedResponse
384
+ */
385
+ export type MarkQueueResumedResponse = Message<"xeonr.pipelines.v1.MarkQueueResumedResponse"> & {
386
+ /**
387
+ * @generated from field: xeonr.pipelines.v1.Queue queue = 1;
388
+ */
389
+ queue?: Queue | undefined;
390
+ };
391
+ /**
392
+ * Describes the message xeonr.pipelines.v1.MarkQueueResumedResponse.
393
+ * Use `create(MarkQueueResumedResponseSchema)` to create a new message.
394
+ */
395
+ export declare const MarkQueueResumedResponseSchema: GenMessage<MarkQueueResumedResponse>;
396
+ /**
397
+ * @generated from message xeonr.pipelines.v1.DeleteQueueRequest
398
+ */
399
+ export type DeleteQueueRequest = Message<"xeonr.pipelines.v1.DeleteQueueRequest"> & {
400
+ /**
401
+ * @generated from field: string queue_id = 1;
402
+ */
403
+ queueId: string;
404
+ /**
405
+ * CancelWaiting cancels the queue's waiting and delayed jobs instead of
406
+ * refusing the delete.
407
+ *
408
+ * validate:skip a bool has no bounds
409
+ *
410
+ * @generated from field: bool cancel_waiting = 2;
411
+ */
412
+ cancelWaiting: boolean;
413
+ };
414
+ /**
415
+ * Describes the message xeonr.pipelines.v1.DeleteQueueRequest.
416
+ * Use `create(DeleteQueueRequestSchema)` to create a new message.
417
+ */
418
+ export declare const DeleteQueueRequestSchema: GenMessage<DeleteQueueRequest>;
419
+ /**
420
+ * @generated from message xeonr.pipelines.v1.DeleteQueueResponse
421
+ */
422
+ export type DeleteQueueResponse = Message<"xeonr.pipelines.v1.DeleteQueueResponse"> & {
423
+ /**
424
+ * CancelledJobs counts the jobs `cancel_waiting` cancelled.
425
+ *
426
+ * @generated from field: uint32 cancelled_jobs = 1;
427
+ */
428
+ cancelledJobs: number;
429
+ };
430
+ /**
431
+ * Describes the message xeonr.pipelines.v1.DeleteQueueResponse.
432
+ * Use `create(DeleteQueueResponseSchema)` to create a new message.
433
+ */
434
+ export declare const DeleteQueueResponseSchema: GenMessage<DeleteQueueResponse>;
435
+ /**
436
+ * @generated from message xeonr.pipelines.v1.GetQueueStatsRequest
437
+ */
438
+ export type GetQueueStatsRequest = Message<"xeonr.pipelines.v1.GetQueueStatsRequest"> & {
439
+ /**
440
+ * @generated from field: string queue_id = 1;
441
+ */
442
+ queueId: string;
443
+ /**
444
+ * Window is the span `started` and `failed` count over. Unset means one
445
+ * hour; the most is a day.
446
+ *
447
+ * @generated from field: google.protobuf.Duration window = 2;
448
+ */
449
+ window?: Duration | undefined;
450
+ };
451
+ /**
452
+ * Describes the message xeonr.pipelines.v1.GetQueueStatsRequest.
453
+ * Use `create(GetQueueStatsRequestSchema)` to create a new message.
454
+ */
455
+ export declare const GetQueueStatsRequestSchema: GenMessage<GetQueueStatsRequest>;
456
+ /**
457
+ * @generated from message xeonr.pipelines.v1.GetQueueStatsResponse
458
+ */
459
+ export type GetQueueStatsResponse = Message<"xeonr.pipelines.v1.GetQueueStatsResponse"> & {
460
+ /**
461
+ * Waiting counts jobs offered and claimable now, paused aside.
462
+ *
463
+ * @generated from field: uint32 waiting = 1;
464
+ */
465
+ waiting: number;
466
+ /**
467
+ * Delayed counts jobs held back by their delay (`not_before`).
468
+ *
469
+ * @generated from field: uint32 delayed = 2;
470
+ */
471
+ delayed: number;
472
+ /**
473
+ * Running counts jobs with an attempt CLAIMED or RUNNING.
474
+ *
475
+ * @generated from field: uint32 running = 3;
476
+ */
477
+ running: number;
478
+ /**
479
+ * OldestWaitingAt is when the oldest waiting job became claimable; unset
480
+ * when none waits. OldestWaitingAge is its age at `at`.
481
+ *
482
+ * @generated from field: google.protobuf.Timestamp oldest_waiting_at = 4;
483
+ */
484
+ oldestWaitingAt?: Timestamp | undefined;
485
+ /**
486
+ * @generated from field: google.protobuf.Duration oldest_waiting_age = 5;
487
+ */
488
+ oldestWaitingAge?: Duration | undefined;
489
+ /**
490
+ * Started counts attempts that started user code within `window`.
491
+ *
492
+ * @generated from field: uint64 started = 7;
493
+ */
494
+ started: bigint;
495
+ /**
496
+ * Failed counts jobs whose run ended FAILED within `window`: the dead
497
+ * letters made in it.
498
+ *
499
+ * @generated from field: uint64 failed = 8;
500
+ */
501
+ failed: bigint;
502
+ /**
503
+ * @generated from field: google.protobuf.Duration window = 9;
504
+ */
505
+ window?: Duration | undefined;
506
+ /**
507
+ * @generated from field: bool paused = 10;
508
+ */
509
+ paused: boolean;
510
+ /**
511
+ * At is when the figures were read.
512
+ *
513
+ * @generated from field: google.protobuf.Timestamp at = 11;
514
+ */
515
+ at?: Timestamp | undefined;
516
+ };
517
+ /**
518
+ * Describes the message xeonr.pipelines.v1.GetQueueStatsResponse.
519
+ * Use `create(GetQueueStatsResponseSchema)` to create a new message.
520
+ */
521
+ export declare const GetQueueStatsResponseSchema: GenMessage<GetQueueStatsResponse>;
522
+ /**
523
+ * @generated from message xeonr.pipelines.v1.ListQueueJobsRequest
524
+ */
525
+ export type ListQueueJobsRequest = Message<"xeonr.pipelines.v1.ListQueueJobsRequest"> & {
526
+ /**
527
+ * @generated from field: string queue_id = 1;
528
+ */
529
+ queueId: string;
530
+ /**
531
+ * States narrows to jobs whose run is in any of these states; FAILED
532
+ * lists the dead letters. Empty lists all.
533
+ *
534
+ * @generated from field: repeated xeonr.pipelines.v1.RunState states = 3;
535
+ */
536
+ states: RunState[];
537
+ /**
538
+ * Cursor is opaque, empty for the first page.
539
+ *
540
+ * @generated from field: string cursor = 4;
541
+ */
542
+ cursor: string;
543
+ /**
544
+ * Limit is capped at 500; zero means the default of 50.
545
+ *
546
+ * @generated from field: uint32 limit = 5;
547
+ */
548
+ limit: number;
549
+ };
550
+ /**
551
+ * Describes the message xeonr.pipelines.v1.ListQueueJobsRequest.
552
+ * Use `create(ListQueueJobsRequestSchema)` to create a new message.
553
+ */
554
+ export declare const ListQueueJobsRequestSchema: GenMessage<ListQueueJobsRequest>;
555
+ /**
556
+ * @generated from message xeonr.pipelines.v1.ListQueueJobsResponse
557
+ */
558
+ export type ListQueueJobsResponse = Message<"xeonr.pipelines.v1.ListQueueJobsResponse"> & {
559
+ /**
560
+ * Runs are the jobs' one-node runs.
561
+ *
562
+ * @generated from field: repeated xeonr.pipelines.v1.Run runs = 1;
563
+ */
564
+ runs: Run[];
565
+ /**
566
+ * NextCursor is empty when there is no further page.
567
+ *
568
+ * @generated from field: string next_cursor = 2;
569
+ */
570
+ nextCursor: string;
571
+ };
572
+ /**
573
+ * Describes the message xeonr.pipelines.v1.ListQueueJobsResponse.
574
+ * Use `create(ListQueueJobsResponseSchema)` to create a new message.
575
+ */
576
+ export declare const ListQueueJobsResponseSchema: GenMessage<ListQueueJobsResponse>;
577
+ /**
578
+ * QueuesService manages queues: the lanes a tenant's jobs are admitted
579
+ * through. Milestone 2.
580
+ *
581
+ * A queue is a logical lane for admission and fairness, not a place where
582
+ * work runs. Pools and their workers are where attempts execute (see
583
+ * PoolsService); a queue decides which of the waiting jobs a worker may be
584
+ * handed next, and when. Its limits are enforced when an attempt is offered
585
+ * and when it is claimed, on top of the pool's own capacity
586
+ * (`capacity_per_instance`) and the claiming worker's free slots: an
587
+ * attempt runs only when the queue, the pool and the worker all allow it.
588
+ * A queue is not bound to a handler: any handler its tenant owns may be
589
+ * enqueued on any of the tenant's queues, and one handler may be fed by
590
+ * several queues.
591
+ *
592
+ * Only jobs (RunsService.CreateJob) go through queues. A worker node of a
593
+ * full run is offered as it always was, outside any queue. (Provisional:
594
+ * whether a run's handler nodes may name a queue is left for later.)
595
+ *
596
+ * Isolation. A queue belongs to exactly one tenant (`owner.tenant`), the
597
+ * consuming service's team that declared it, and is never shared across
598
+ * tenants: a job is resolved only among its own tenant's queues, and a
599
+ * tenant's workers claim only that tenant's handlers in any case
600
+ * (WorkerService).
601
+ *
602
+ * Fairness. This is platform-design §7.3's per-tenant budget checked when
603
+ * work is handed out ("over-budget steps simply stay in the ready set"), and
604
+ * design-v1 §4.3's per-tenant counter, decided here as follows. A queue's
605
+ * jobs fall into lanes: a job created with a `fairness_key`
606
+ * (CreateJobRequest) is in the lane of that key, and the jobs with no key
607
+ * are one more lane, the tenant's own (PIPE-128). Among the claimable jobs
608
+ * of a queue (not delayed, the queue not paused, the queue under
609
+ * `max_concurrency` and its `rate_limit`), only lanes under
610
+ * `max_concurrency_per_tenant` are eligible, and the next claim goes to the
611
+ * eligible lane with the fewest running attempts in this queue; ties go to
612
+ * the lane whose oldest waiting job has waited longest; within a lane, jobs
613
+ * are taken oldest first. Running counts CLAIMED and RUNNING attempts,
614
+ * counted from the attempts themselves (all state is in MySQL), so nothing
615
+ * has to be rebuilt after Redis is lost. One lane's backlog therefore never
616
+ * delays another lane's next job by more than one claim.
617
+ * The rule answers platform-design §14's open "fairness mechanism (queue
618
+ * groups vs token counters)" with counters.
619
+ *
620
+ * The default queue. Every tenant has one, named `default`, without
621
+ * declaring it: a job with no `queue` goes there. Until the tenant sets a
622
+ * queue named `default` it has no limits, no defaults and no pause, so it
623
+ * behaves exactly as jobs did before queues existed.
624
+ *
625
+ * Dead letters. A job whose run ended FAILED has exhausted its retries (or
626
+ * failed with a class its policy does not retry): ListQueueJobs with that
627
+ * state lists a queue's dead letters, which RunsService.ListRuns, not
628
+ * scoped to a queue, cannot. To enqueue one again, call
629
+ * RunsService.RetryNode on its run with node `job`: a job is a one-node
630
+ * run, so RetryNode's semantics (the run reopens, the node gets a new
631
+ * attempt, nothing upstream to keep) are exactly a requeue. The new attempt
632
+ * is offered on the same queue under its settings at that time.
633
+ *
634
+ * Ownership. A queue is set, paused, resumed and deleted by its tenant's
635
+ * members that are service accounts, and by the platform's operators. It is
636
+ * read by the tenant's members and by operators. People who are not
637
+ * operators never write. A queue the caller may not read answers
638
+ * `not_found`.
639
+ *
640
+ * Verbs outside api.rpc-naming's: none. MarkQueuePaused and MarkQueueResumed
641
+ * use `Mark`, as MarkRunnerDraining does.
642
+ *
643
+ * @generated from service xeonr.pipelines.v1.QueuesService
644
+ */
645
+ export declare const QueuesService: GenService<{
646
+ /**
647
+ * @generated from rpc xeonr.pipelines.v1.QueuesService.SetQueue
648
+ */
649
+ setQueue: {
650
+ methodKind: "unary";
651
+ input: typeof SetQueueRequestSchema;
652
+ output: typeof SetQueueResponseSchema;
653
+ };
654
+ /**
655
+ * @generated from rpc xeonr.pipelines.v1.QueuesService.GetQueue
656
+ */
657
+ getQueue: {
658
+ methodKind: "unary";
659
+ input: typeof GetQueueRequestSchema;
660
+ output: typeof GetQueueResponseSchema;
661
+ };
662
+ /**
663
+ * @generated from rpc xeonr.pipelines.v1.QueuesService.ListQueues
664
+ */
665
+ listQueues: {
666
+ methodKind: "unary";
667
+ input: typeof ListQueuesRequestSchema;
668
+ output: typeof ListQueuesResponseSchema;
669
+ };
670
+ /**
671
+ * @generated from rpc xeonr.pipelines.v1.QueuesService.MarkQueuePaused
672
+ */
673
+ markQueuePaused: {
674
+ methodKind: "unary";
675
+ input: typeof MarkQueuePausedRequestSchema;
676
+ output: typeof MarkQueuePausedResponseSchema;
677
+ };
678
+ /**
679
+ * @generated from rpc xeonr.pipelines.v1.QueuesService.MarkQueueResumed
680
+ */
681
+ markQueueResumed: {
682
+ methodKind: "unary";
683
+ input: typeof MarkQueueResumedRequestSchema;
684
+ output: typeof MarkQueueResumedResponseSchema;
685
+ };
686
+ /**
687
+ * @generated from rpc xeonr.pipelines.v1.QueuesService.DeleteQueue
688
+ */
689
+ deleteQueue: {
690
+ methodKind: "unary";
691
+ input: typeof DeleteQueueRequestSchema;
692
+ output: typeof DeleteQueueResponseSchema;
693
+ };
694
+ /**
695
+ * @generated from rpc xeonr.pipelines.v1.QueuesService.GetQueueStats
696
+ */
697
+ getQueueStats: {
698
+ methodKind: "unary";
699
+ input: typeof GetQueueStatsRequestSchema;
700
+ output: typeof GetQueueStatsResponseSchema;
701
+ };
702
+ /**
703
+ * @generated from rpc xeonr.pipelines.v1.QueuesService.ListQueueJobs
704
+ */
705
+ listQueueJobs: {
706
+ methodKind: "unary";
707
+ input: typeof ListQueueJobsRequestSchema;
708
+ output: typeof ListQueueJobsResponseSchema;
709
+ };
710
+ }>;
711
+ //# sourceMappingURL=queues_pb.d.ts.map