@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
@@ -1,6 +1,6 @@
1
1
  import type { GenEnum, GenFile, GenMessage, GenService } from "@bufbuild/protobuf/codegenv2";
2
2
  import type { Duration, Timestamp, Value } from "@bufbuild/protobuf/wkt";
3
- import type { AttemptState, FailureClass, NodeState, PackageRef, Resource, ResourceRef, RunState, Termination } from "./common_pb.js";
3
+ import type { AttemptState, DispatchBackend, FailureClass, NodeState, PackageRef, Resource, ResourceRef, RunState, Termination } from "./common_pb.js";
4
4
  import type { Definition, Retry } from "./definition_pb.js";
5
5
  import type { JsonObject, Message } from "@bufbuild/protobuf";
6
6
  /**
@@ -9,7 +9,7 @@ import type { JsonObject, Message } from "@bufbuild/protobuf";
9
9
  export declare const file_xeonr_pipelines_v1_runs: GenFile;
10
10
  /**
11
11
  * Exclusion makes runs sharing a key, within one tenant, mutually exclusive.
12
- * The product chooses it per run (the forge: per ref), so it is given to
12
+ * The consuming service chooses it per run (the forge: per ref), so it is given to
13
13
  * CreateRun and is not part of the definition. Milestone 2 (`cancel_older`)
14
14
  * and milestone 4 (`queue`).
15
15
  *
@@ -30,6 +30,75 @@ export type Exclusion = Message<"xeonr.pipelines.v1.Exclusion"> & {
30
30
  * Use `create(ExclusionSchema)` to create a new message.
31
31
  */
32
32
  export declare const ExclusionSchema: GenMessage<Exclusion>;
33
+ /**
34
+ * PipelineName names a stored pipeline within a tenant by its scope and its
35
+ * name.
36
+ *
37
+ * @generated from message xeonr.pipelines.v1.PipelineName
38
+ */
39
+ export type PipelineName = Message<"xeonr.pipelines.v1.PipelineName"> & {
40
+ /**
41
+ * Tenant is the owning team.
42
+ *
43
+ * @generated from field: string tenant = 1;
44
+ */
45
+ tenant: string;
46
+ /**
47
+ * Scope is the resource the pipeline is bound to.
48
+ *
49
+ * @generated from field: xeonr.pipelines.v1.ResourceRef scope = 3;
50
+ */
51
+ scope?: ResourceRef | undefined;
52
+ /**
53
+ * @generated from field: string name = 4;
54
+ */
55
+ name: string;
56
+ };
57
+ /**
58
+ * Describes the message xeonr.pipelines.v1.PipelineName.
59
+ * Use `create(PipelineNameSchema)` to create a new message.
60
+ */
61
+ export declare const PipelineNameSchema: GenMessage<PipelineName>;
62
+ /**
63
+ * PipelineSource starts a run from a published version of a stored
64
+ * pipeline (PipelinesService). Milestone 4.
65
+ *
66
+ * @generated from message xeonr.pipelines.v1.PipelineSource
67
+ */
68
+ export type PipelineSource = Message<"xeonr.pipelines.v1.PipelineSource"> & {
69
+ /**
70
+ * Pipeline names the pipeline. It must belong to the run's tenant.
71
+ *
72
+ * @generated from oneof xeonr.pipelines.v1.PipelineSource.pipeline
73
+ */
74
+ pipeline: {
75
+ /**
76
+ * @generated from field: string pipeline_id = 1;
77
+ */
78
+ value: string;
79
+ case: "pipelineId";
80
+ } | {
81
+ /**
82
+ * @generated from field: xeonr.pipelines.v1.PipelineName by_name = 2;
83
+ */
84
+ value: PipelineName;
85
+ case: "byName";
86
+ } | {
87
+ case: undefined;
88
+ value?: undefined;
89
+ };
90
+ /**
91
+ * Version is the published version to run; zero runs the latest.
92
+ *
93
+ * @generated from field: uint32 version = 3;
94
+ */
95
+ version: number;
96
+ };
97
+ /**
98
+ * Describes the message xeonr.pipelines.v1.PipelineSource.
99
+ * Use `create(PipelineSourceSchema)` to create a new message.
100
+ */
101
+ export declare const PipelineSourceSchema: GenMessage<PipelineSource>;
33
102
  /**
34
103
  * Run is one execution of one snapshot for one resource.
35
104
  *
@@ -41,18 +110,12 @@ export type Run = Message<"xeonr.pipelines.v1.Run"> & {
41
110
  */
42
111
  id: string;
43
112
  /**
44
- * Tenant is the owning team's URN.
113
+ * Tenant is the owning team's URN. It scopes the idempotency key and
114
+ * selects the sink that receives the run's events.
45
115
  *
46
116
  * @generated from field: string tenant = 2;
47
117
  */
48
118
  tenant: string;
49
- /**
50
- * Product is the Auth application whose caller started the run. It scopes
51
- * the idempotency key and selects the sink that receives the run's events.
52
- *
53
- * @generated from field: string product = 3;
54
- */
55
- product: string;
56
119
  /**
57
120
  * IdempotencyKey is the key CreateRun was given.
58
121
  *
@@ -66,8 +129,8 @@ export type Run = Message<"xeonr.pipelines.v1.Run"> & {
66
129
  */
67
130
  resource?: Resource | undefined;
68
131
  /**
69
- * AttestedFacts are the facts the product vouched for when it started the
70
- * run. Tiers and secret policies are decided from these.
132
+ * AttestedFacts are the facts the tenant's service account vouched for
133
+ * when it started the run. Tiers and secret policies are decided from these.
71
134
  *
72
135
  * @generated from field: google.protobuf.Struct attested_facts = 6;
73
136
  */
@@ -108,8 +171,8 @@ export type Run = Message<"xeonr.pipelines.v1.Run"> & {
108
171
  */
109
172
  hasAllowedFailures: boolean;
110
173
  /**
111
- * CreatedBy is the subject URN that created the run: a person, or a
112
- * product's service account.
174
+ * CreatedBy is the subject URN that created the run: a service account
175
+ * of the tenant, or an operator.
113
176
  *
114
177
  * @generated from field: string created_by = 13;
115
178
  */
@@ -178,12 +241,397 @@ export type Run = Message<"xeonr.pipelines.v1.Run"> & {
178
241
  * @generated from field: google.protobuf.Timestamp updated_at = 25;
179
242
  */
180
243
  updatedAt?: Timestamp | undefined;
244
+ /**
245
+ * QueueID and Queue are the queue a job went through (QueuesService):
246
+ * its id and name. Empty for a run that is not a job. Milestone 2.
247
+ *
248
+ * @generated from field: string queue_id = 26;
249
+ */
250
+ queueId: string;
251
+ /**
252
+ * @generated from field: string queue = 27;
253
+ */
254
+ queue: string;
255
+ /**
256
+ * Origin is where the run's snapshot came from. Milestone 4 sets
257
+ * PUBLISHED; every earlier run is INLINE.
258
+ *
259
+ * @generated from field: xeonr.pipelines.v1.RunOrigin origin = 28;
260
+ */
261
+ origin: RunOrigin;
262
+ /**
263
+ * PipelineID and PipelineVersion are the stored pipeline and the
264
+ * version a PUBLISHED run executes. Milestone 4.
265
+ *
266
+ * @generated from field: string pipeline_id = 29;
267
+ */
268
+ pipelineId: string;
269
+ /**
270
+ * @generated from field: uint32 pipeline_version = 30;
271
+ */
272
+ pipelineVersion: number;
273
+ /**
274
+ * Trigger is what started the run. Runs from before it was recorded read
275
+ * API. Milestone 4.
276
+ *
277
+ * @generated from field: xeonr.pipelines.v1.RunTrigger trigger = 31;
278
+ */
279
+ trigger: RunTrigger;
280
+ /**
281
+ * ScheduleID, ScheduledFor and ScheduleTarget name the schedule
282
+ * occurrence a SCHEDULE run came from: the schedule, the occurrence's
283
+ * time, and the enumerated target's key (empty for a schedule with one
284
+ * target). Together they are unique: one occurrence makes at most one
285
+ * run. Milestone 4.
286
+ *
287
+ * @generated from field: string schedule_id = 32;
288
+ */
289
+ scheduleId: string;
290
+ /**
291
+ * @generated from field: google.protobuf.Timestamp scheduled_for = 33;
292
+ */
293
+ scheduledFor?: Timestamp | undefined;
294
+ /**
295
+ * @generated from field: string schedule_target = 34;
296
+ */
297
+ scheduleTarget: string;
298
+ /**
299
+ * IssueInfoCount, IssueWarningCount and IssueErrorCount count the run's
300
+ * issues by severity, so a listing can say "12 items had problems"
301
+ * without reading them; IssuesTruncated says the run reached its cap.
302
+ * Milestone 4.
303
+ *
304
+ * @generated from field: uint32 issue_info_count = 35;
305
+ */
306
+ issueInfoCount: number;
307
+ /**
308
+ * @generated from field: uint32 issue_warning_count = 36;
309
+ */
310
+ issueWarningCount: number;
311
+ /**
312
+ * @generated from field: uint32 issue_error_count = 37;
313
+ */
314
+ issueErrorCount: number;
315
+ /**
316
+ * @generated from field: bool issues_truncated = 38;
317
+ */
318
+ issuesTruncated: boolean;
319
+ /**
320
+ * FairnessKey is the key the run is fair by and capped per, within its
321
+ * tenant: a job's `fairness_key` (CreateJobRequest), or for any other run
322
+ * the string its tenant's fairness fact holds in the run's attested facts
323
+ * (TierPolicy.fairness_fact). Empty when there is none: the run is fair
324
+ * by its tenant alone. A value longer than 128 bytes reads as `sha256:`
325
+ * and the hex digest of it. Fixed when the run is created. PIPE-128.
326
+ *
327
+ * @generated from field: string fairness_key = 39;
328
+ */
329
+ fairnessKey: string;
181
330
  };
182
331
  /**
183
332
  * Describes the message xeonr.pipelines.v1.Run.
184
333
  * Use `create(RunSchema)` to create a new message.
185
334
  */
186
335
  export declare const RunSchema: GenMessage<Run>;
336
+ /**
337
+ * StageProgress is one stage of an attempt, as declared by the step's
338
+ * manifest (StageDecl) or added by the step at run time.
339
+ *
340
+ * @generated from message xeonr.pipelines.v1.StageProgress
341
+ */
342
+ export type StageProgress = Message<"xeonr.pipelines.v1.StageProgress"> & {
343
+ /**
344
+ * @generated from field: string key = 1;
345
+ */
346
+ key: string;
347
+ /**
348
+ * @generated from field: string name = 2;
349
+ */
350
+ name: string;
351
+ /**
352
+ * Weight is the declared weight; a stage the step added at run time has
353
+ * weight 0, so it cannot move the overall bar.
354
+ *
355
+ * @generated from field: uint32 weight = 3;
356
+ */
357
+ weight: number;
358
+ /**
359
+ * @generated from field: xeonr.pipelines.v1.StageState state = 4;
360
+ */
361
+ state: StageState;
362
+ /**
363
+ * Fraction is how far along the stage is, from 0 to 1.
364
+ *
365
+ * @generated from field: double fraction = 5;
366
+ */
367
+ fraction: number;
368
+ /**
369
+ * Message says what the stage is doing now.
370
+ *
371
+ * @generated from field: string message = 6;
372
+ */
373
+ message: string;
374
+ /**
375
+ * Processed, Total and Failed count items; a zero total is unknown.
376
+ *
377
+ * @generated from field: uint64 processed = 7;
378
+ */
379
+ processed: bigint;
380
+ /**
381
+ * @generated from field: uint64 total = 8;
382
+ */
383
+ total: bigint;
384
+ /**
385
+ * @generated from field: uint64 failed = 9;
386
+ */
387
+ failed: bigint;
388
+ /**
389
+ * @generated from field: google.protobuf.Timestamp started_at = 10;
390
+ */
391
+ startedAt?: Timestamp | undefined;
392
+ /**
393
+ * @generated from field: google.protobuf.Timestamp finished_at = 11;
394
+ */
395
+ finishedAt?: Timestamp | undefined;
396
+ };
397
+ /**
398
+ * Describes the message xeonr.pipelines.v1.StageProgress.
399
+ * Use `create(StageProgressSchema)` to create a new message.
400
+ */
401
+ export declare const StageProgressSchema: GenMessage<StageProgress>;
402
+ /**
403
+ * AttemptProgress is what an attempt reported of its progress (SetProgress),
404
+ * as the platform derived it.
405
+ *
406
+ * Every declared stage is present, PENDING, from the claim, so the whole
407
+ * sequence can be drawn before anything runs. Reporting a stage finishes the
408
+ * one before it. The overall `fraction` is
409
+ * (Σ weight of finished stages + current stage's fraction × its weight) /
410
+ * Σ weight, or the reported fraction for a step with no stages, and it never
411
+ * goes backwards: the platform keeps the greater of the last value and the
412
+ * new one.
413
+ *
414
+ * @generated from message xeonr.pipelines.v1.AttemptProgress
415
+ */
416
+ export type AttemptProgress = Message<"xeonr.pipelines.v1.AttemptProgress"> & {
417
+ /**
418
+ * @generated from field: double fraction = 1;
419
+ */
420
+ fraction: number;
421
+ /**
422
+ * Message is the latest thing the attempt said it was doing.
423
+ *
424
+ * @generated from field: string message = 2;
425
+ */
426
+ message: string;
427
+ /**
428
+ * @generated from field: uint64 processed = 3;
429
+ */
430
+ processed: bigint;
431
+ /**
432
+ * @generated from field: uint64 total = 4;
433
+ */
434
+ total: bigint;
435
+ /**
436
+ * @generated from field: uint64 failed = 5;
437
+ */
438
+ failed: bigint;
439
+ /**
440
+ * @generated from field: repeated xeonr.pipelines.v1.StageProgress stages = 6;
441
+ */
442
+ stages: StageProgress[];
443
+ /**
444
+ * EstimatedRemaining is the median-based estimate of the time left: the
445
+ * medians of the stages not started plus the rest of the current one,
446
+ * over recent successful attempts of the same package in the same
447
+ * pipeline. Unset when there are fewer than three to go on: no estimate
448
+ * is shown rather than a wrong one (XMB's eta). Computed when read, never
449
+ * stored. Provisional.
450
+ *
451
+ * @generated from field: google.protobuf.Duration estimated_remaining = 7;
452
+ */
453
+ estimatedRemaining?: Duration | undefined;
454
+ /**
455
+ * @generated from field: google.protobuf.Timestamp updated_at = 8;
456
+ */
457
+ updatedAt?: Timestamp | undefined;
458
+ };
459
+ /**
460
+ * Describes the message xeonr.pipelines.v1.AttemptProgress.
461
+ * Use `create(AttemptProgressSchema)` to create a new message.
462
+ */
463
+ export declare const AttemptProgressSchema: GenMessage<AttemptProgress>;
464
+ /**
465
+ * ForEachCounts are a for_each node's elements by outcome.
466
+ *
467
+ * @generated from message xeonr.pipelines.v1.ForEachCounts
468
+ */
469
+ export type ForEachCounts = Message<"xeonr.pipelines.v1.ForEachCounts"> & {
470
+ /**
471
+ * @generated from field: uint32 total = 1;
472
+ */
473
+ total: number;
474
+ /**
475
+ * @generated from field: uint32 succeeded = 2;
476
+ */
477
+ succeeded: number;
478
+ /**
479
+ * @generated from field: uint32 failed = 3;
480
+ */
481
+ failed: number;
482
+ /**
483
+ * @generated from field: uint32 running = 4;
484
+ */
485
+ running: number;
486
+ /**
487
+ * Pending counts elements not started yet (waiting for `max_parallel`, or
488
+ * never to start after FAIL_FAST).
489
+ *
490
+ * @generated from field: uint32 pending = 5;
491
+ */
492
+ pending: number;
493
+ };
494
+ /**
495
+ * Describes the message xeonr.pipelines.v1.ForEachCounts.
496
+ * Use `create(ForEachCountsSchema)` to create a new message.
497
+ */
498
+ export declare const ForEachCountsSchema: GenMessage<ForEachCounts>;
499
+ /**
500
+ * RunIssue is one issue a run's step reported.
501
+ *
502
+ * @generated from message xeonr.pipelines.v1.RunIssue
503
+ */
504
+ export type RunIssue = Message<"xeonr.pipelines.v1.RunIssue"> & {
505
+ /**
506
+ * @generated from field: string id = 1;
507
+ */
508
+ id: string;
509
+ /**
510
+ * @generated from field: string run_id = 2;
511
+ */
512
+ runId: string;
513
+ /**
514
+ * @generated from field: string node_id = 3;
515
+ */
516
+ nodeId: string;
517
+ /**
518
+ * @generated from field: string attempt_id = 4;
519
+ */
520
+ attemptId: string;
521
+ /**
522
+ * Stage is the stage the step was in, when it said.
523
+ *
524
+ * @generated from field: string stage = 5;
525
+ */
526
+ stage: string;
527
+ /**
528
+ * @generated from field: xeonr.pipelines.v1.IssueSeverity severity = 6;
529
+ */
530
+ severity: IssueSeverity;
531
+ /**
532
+ * Subject is the human-readable thing the issue is about, always set
533
+ * ("The Matrix (1999)/movie.mkv"); SubjectKind and SubjectID are the
534
+ * consuming service's machine handle for it, for a deep link.
535
+ *
536
+ * @generated from field: string subject = 7;
537
+ */
538
+ subject: string;
539
+ /**
540
+ * @generated from field: string subject_kind = 8;
541
+ */
542
+ subjectKind: string;
543
+ /**
544
+ * @generated from field: string subject_id = 9;
545
+ */
546
+ subjectId: string;
547
+ /**
548
+ * Message is one sentence that stands on its own.
549
+ *
550
+ * @generated from field: string message = 10;
551
+ */
552
+ message: string;
553
+ /**
554
+ * @generated from field: google.protobuf.Struct detail = 11;
555
+ */
556
+ detail?: JsonObject | undefined;
557
+ /**
558
+ * @generated from field: google.protobuf.Timestamp created_at = 12;
559
+ */
560
+ createdAt?: Timestamp | undefined;
561
+ };
562
+ /**
563
+ * Describes the message xeonr.pipelines.v1.RunIssue.
564
+ * Use `create(RunIssueSchema)` to create a new message.
565
+ */
566
+ export declare const RunIssueSchema: GenMessage<RunIssue>;
567
+ /**
568
+ * TraceSpan is one span of a run's trace.
569
+ *
570
+ * @generated from message xeonr.pipelines.v1.TraceSpan
571
+ */
572
+ export type TraceSpan = Message<"xeonr.pipelines.v1.TraceSpan"> & {
573
+ /**
574
+ * @generated from field: string trace_id = 1;
575
+ */
576
+ traceId: string;
577
+ /**
578
+ * @generated from field: string span_id = 2;
579
+ */
580
+ spanId: string;
581
+ /**
582
+ * ParentSpanID is empty for the run's root span.
583
+ *
584
+ * @generated from field: string parent_span_id = 3;
585
+ */
586
+ parentSpanId: string;
587
+ /**
588
+ * @generated from field: string name = 4;
589
+ */
590
+ name: string;
591
+ /**
592
+ * @generated from field: xeonr.pipelines.v1.TraceSpanSource source = 5;
593
+ */
594
+ source: TraceSpanSource;
595
+ /**
596
+ * NodeID and AttemptID place the span; both empty for the run's span.
597
+ *
598
+ * @generated from field: string node_id = 6;
599
+ */
600
+ nodeId: string;
601
+ /**
602
+ * @generated from field: string attempt_id = 7;
603
+ */
604
+ attemptId: string;
605
+ /**
606
+ * @generated from field: google.protobuf.Timestamp started_at = 8;
607
+ */
608
+ startedAt?: Timestamp | undefined;
609
+ /**
610
+ * EndedAt is unset for a span still open (a running attempt).
611
+ *
612
+ * @generated from field: google.protobuf.Timestamp ended_at = 9;
613
+ */
614
+ endedAt?: Timestamp | undefined;
615
+ /**
616
+ * Status is `ok`, `error` or empty.
617
+ *
618
+ * @generated from field: string status = 10;
619
+ */
620
+ status: string;
621
+ /**
622
+ * @generated from field: string status_message = 11;
623
+ */
624
+ statusMessage: string;
625
+ /**
626
+ * @generated from field: google.protobuf.Struct attributes = 12;
627
+ */
628
+ attributes?: JsonObject | undefined;
629
+ };
630
+ /**
631
+ * Describes the message xeonr.pipelines.v1.TraceSpan.
632
+ * Use `create(TraceSpanSchema)` to create a new message.
633
+ */
634
+ export declare const TraceSpanSchema: GenMessage<TraceSpan>;
187
635
  /**
188
636
  * Attempt is one try at running a node. Attempts are numbered from 1 and
189
637
  * never reused; a node's result is exactly one attempt's, its settled one.
@@ -298,12 +746,219 @@ export type Attempt = Message<"xeonr.pipelines.v1.Attempt"> & {
298
746
  * @generated from field: bool log_truncated = 20;
299
747
  */
300
748
  logTruncated: boolean;
749
+ /**
750
+ * SettledAt is when this attempt settled its node: its result and outputs
751
+ * became the node's. Set on every attempt that did, the node's current
752
+ * settled attempt and any earlier one a RetryNode replaced; unset on an
753
+ * attempt that never settled its node (abandoned, cancelled, or failed and
754
+ * retried), whatever its state. Milestone 2.
755
+ *
756
+ * @generated from field: google.protobuf.Timestamp settled_at = 21;
757
+ */
758
+ settledAt?: Timestamp | undefined;
759
+ /**
760
+ * Blobs are the blob outputs this attempt committed: manifest blob slots
761
+ * and artifacts, each with its slot or artifact name, file name, size and
762
+ * digest. Filled only for an attempt with `settled_at`, so a console can
763
+ * list what an earlier settled attempt wrote and download it with
764
+ * GetBlobOutput's `attempt_id`; empty otherwise. For the current settled
765
+ * attempt they are the same blobs as `NodeRun.blobs`. Milestone 2.
766
+ *
767
+ * @generated from field: repeated xeonr.pipelines.v1.BlobOutput blobs = 22;
768
+ */
769
+ blobs: BlobOutput[];
770
+ /**
771
+ * ChildRunID is the child run this attempt of a sub-pipeline node
772
+ * started. Milestone 4.
773
+ *
774
+ * @generated from field: string child_run_id = 23;
775
+ */
776
+ childRunId: string;
777
+ /**
778
+ * ItemIndex and Item are the element of a for_each node this attempt
779
+ * ran; unset outside for_each. Item is at most 4 KiB encoded; a larger
780
+ * element is left out and only its index shown. Milestone 4.
781
+ *
782
+ * @generated from field: optional uint32 item_index = 24;
783
+ */
784
+ itemIndex?: number | undefined;
785
+ /**
786
+ * @generated from field: google.protobuf.Value item = 25;
787
+ */
788
+ item?: Value | undefined;
789
+ /**
790
+ * Progress is what the attempt reported of its progress; unset when it
791
+ * reported none. Milestone 4.
792
+ *
793
+ * @generated from field: xeonr.pipelines.v1.AttemptProgress progress = 26;
794
+ */
795
+ progress?: AttemptProgress | undefined;
796
+ /**
797
+ * SecretsDelivered are the names of the secrets this attempt was given,
798
+ * never their values. Empty until its secrets are sealed (or, on the cp
799
+ * backend, handed to its job), and for a node granted none.
800
+ *
801
+ * @generated from field: repeated string secrets_delivered = 27;
802
+ */
803
+ secretsDelivered: string[];
804
+ /**
805
+ * SecretsWithheld are the optional grants this attempt ran without, each
806
+ * with why (SecretGrant.optional). A required grant that could not be
807
+ * delivered is not listed: it failed the attempt, whose failure_class and
808
+ * message say why.
809
+ *
810
+ * @generated from field: repeated xeonr.pipelines.v1.WithheldSecret secrets_withheld = 28;
811
+ */
812
+ secretsWithheld: WithheldSecret[];
813
+ /**
814
+ * Services are the containers this attempt ran beside its step, in the
815
+ * definition's order: each one's alias, the image pinned at dispatch, and
816
+ * how it fared where the backend reports it. Empty for a node with none,
817
+ * and until the attempt is dispatched.
818
+ *
819
+ * @generated from field: repeated xeonr.pipelines.v1.AttemptService services = 29;
820
+ */
821
+ services: AttemptService[];
822
+ /**
823
+ * Caches are what this attempt did with each cache its node declares: one
824
+ * entry per declared cache, in the definition's order, whether or not the
825
+ * attempt asked for it.
826
+ *
827
+ * @generated from field: repeated xeonr.pipelines.v1.AttemptCache caches = 30;
828
+ */
829
+ caches: AttemptCache[];
830
+ /**
831
+ * Backend is where the attempt was sent when it was offered, decided once
832
+ * and never changed: a runner pool when a pool record could claim it or
833
+ * its tier is pools-only (TierPolicy.pools_only_tiers), otherwise
834
+ * container-platform. Unspecified for a sub-pipeline node's attempt and
835
+ * for one offered before this was recorded.
836
+ *
837
+ * @generated from field: xeonr.pipelines.v1.DispatchBackend backend = 31;
838
+ */
839
+ backend: DispatchBackend;
301
840
  };
302
841
  /**
303
842
  * Describes the message xeonr.pipelines.v1.Attempt.
304
843
  * Use `create(AttemptSchema)` to create a new message.
305
844
  */
306
845
  export declare const AttemptSchema: GenMessage<Attempt>;
846
+ /**
847
+ * WithheldSecret is one optional grant an attempt ran without.
848
+ *
849
+ * @generated from message xeonr.pipelines.v1.WithheldSecret
850
+ */
851
+ export type WithheldSecret = Message<"xeonr.pipelines.v1.WithheldSecret"> & {
852
+ /**
853
+ * Name is the granted name.
854
+ *
855
+ * @generated from field: string name = 1;
856
+ */
857
+ name: string;
858
+ /**
859
+ * @generated from field: xeonr.pipelines.v1.SecretWithheldReason reason = 2;
860
+ */
861
+ reason: SecretWithheldReason;
862
+ /**
863
+ * Message says which part of the policy refused the attempt, in terms of
864
+ * the attempt (its tier, package or facts), never the policy's lists or
865
+ * any value.
866
+ *
867
+ * @generated from field: string message = 3;
868
+ */
869
+ message: string;
870
+ };
871
+ /**
872
+ * Describes the message xeonr.pipelines.v1.WithheldSecret.
873
+ * Use `create(WithheldSecretSchema)` to create a new message.
874
+ */
875
+ export declare const WithheldSecretSchema: GenMessage<WithheldSecret>;
876
+ /**
877
+ * AttemptService is one service container an attempt ran with.
878
+ *
879
+ * @generated from message xeonr.pipelines.v1.AttemptService
880
+ */
881
+ export type AttemptService = Message<"xeonr.pipelines.v1.AttemptService"> & {
882
+ /**
883
+ * Alias is the hostname the step reached it by: the definition's alias,
884
+ * or the name derived from its image.
885
+ *
886
+ * @generated from field: string alias = 1;
887
+ */
888
+ alias: string;
889
+ /**
890
+ * Image is the reference that ran, pinned to a digest at dispatch.
891
+ *
892
+ * @generated from field: string image = 2;
893
+ */
894
+ image: string;
895
+ /**
896
+ * @generated from field: xeonr.pipelines.v1.ServiceOutcome outcome = 3;
897
+ */
898
+ outcome: ServiceOutcome;
899
+ /**
900
+ * Restarts is how many times it was restarted after exiting.
901
+ *
902
+ * @generated from field: uint32 restarts = 4;
903
+ */
904
+ restarts: number;
905
+ /**
906
+ * ExitCode and Reason are how it last exited, when it did (Reason is the
907
+ * backend's word: Error, Completed, OOMKilled).
908
+ *
909
+ * @generated from field: optional int32 exit_code = 5;
910
+ */
911
+ exitCode?: number | undefined;
912
+ /**
913
+ * @generated from field: string reason = 6;
914
+ */
915
+ reason: string;
916
+ };
917
+ /**
918
+ * Describes the message xeonr.pipelines.v1.AttemptService.
919
+ * Use `create(AttemptServiceSchema)` to create a new message.
920
+ */
921
+ export declare const AttemptServiceSchema: GenMessage<AttemptService>;
922
+ /**
923
+ * AttemptCache is what one attempt did with one cache its node declares.
924
+ *
925
+ * @generated from message xeonr.pipelines.v1.AttemptCache
926
+ */
927
+ export type AttemptCache = Message<"xeonr.pipelines.v1.AttemptCache"> & {
928
+ /**
929
+ * DeclaredKey is the cache's `key` as the definition declares it.
930
+ *
931
+ * @generated from field: string declared_key = 1;
932
+ */
933
+ declaredKey: string;
934
+ /**
935
+ * Key is the key the attempt resolved and used: the declared key, with
936
+ * the key files' digest appended when the cache has key_files. Empty when
937
+ * the attempt never asked for the cache.
938
+ *
939
+ * @generated from field: string key = 2;
940
+ */
941
+ key: string;
942
+ /**
943
+ * @generated from field: xeonr.pipelines.v1.CacheRestore restore = 3;
944
+ */
945
+ restore: CacheRestore;
946
+ /**
947
+ * RestoredKey is the saved key a hit restored; empty on a miss.
948
+ *
949
+ * @generated from field: string restored_key = 4;
950
+ */
951
+ restoredKey: string;
952
+ /**
953
+ * @generated from field: xeonr.pipelines.v1.CacheSave save = 5;
954
+ */
955
+ save: CacheSave;
956
+ };
957
+ /**
958
+ * Describes the message xeonr.pipelines.v1.AttemptCache.
959
+ * Use `create(AttemptCacheSchema)` to create a new message.
960
+ */
961
+ export declare const AttemptCacheSchema: GenMessage<AttemptCache>;
307
962
  /**
308
963
  * BlobOutput describes one blob a node produced. It carries no URL:
309
964
  * GetBlobOutput returns one, for one blob, when it is asked.
@@ -338,8 +993,8 @@ export type BlobOutput = Message<"xeonr.pipelines.v1.BlobOutput"> & {
338
993
  */
339
994
  mediaType: string;
340
995
  /**
341
- * ExpiresAt is when the platform deletes the blob; unset keeps it for the
342
- * platform's retention.
996
+ * ExpiresAt is meant to be when the platform deletes the blob. Not set
997
+ * yet: the server stores no expiry and keeps every blob output.
343
998
  *
344
999
  * @generated from field: google.protobuf.Timestamp expires_at = 6;
345
1000
  */
@@ -432,7 +1087,8 @@ export type NodeRun = Message<"xeonr.pipelines.v1.NodeRun"> & {
432
1087
  */
433
1088
  releasedBy: string;
434
1089
  /**
435
- * DownstreamRunID is the run a trigger node started.
1090
+ * DownstreamRunID is the run a trigger node started, or the latest child
1091
+ * run of a sub-pipeline node (each attempt's is on the attempt).
436
1092
  *
437
1093
  * @generated from field: string downstream_run_id = 14;
438
1094
  */
@@ -444,7 +1100,14 @@ export type NodeRun = Message<"xeonr.pipelines.v1.NodeRun"> & {
444
1100
  /**
445
1101
  * @generated from field: google.protobuf.Timestamp finished_at = 16;
446
1102
  */
447
- finishedAt?: Timestamp | undefined;
1103
+ finishedAt?: Timestamp | undefined;
1104
+ /**
1105
+ * ForEach counts a for_each node's elements; unset for any other node.
1106
+ * Milestone 4.
1107
+ *
1108
+ * @generated from field: xeonr.pipelines.v1.ForEachCounts for_each = 17;
1109
+ */
1110
+ forEach?: ForEachCounts | undefined;
448
1111
  };
449
1112
  /**
450
1113
  * Describes the message xeonr.pipelines.v1.NodeRun.
@@ -456,8 +1119,8 @@ export declare const NodeRunSchema: GenMessage<NodeRun>;
456
1119
  */
457
1120
  export type CreateRunRequest = Message<"xeonr.pipelines.v1.CreateRunRequest"> & {
458
1121
  /**
459
- * IdempotencyKey makes the create safe to repeat. It is unique per calling
460
- * product: a webhook redelivery or a client retry with the same key
1122
+ * IdempotencyKey makes the create safe to repeat. It is unique per
1123
+ * tenant: a webhook redelivery or a client retry with the same key
461
1124
  * returns the first run.
462
1125
  *
463
1126
  * @generated from field: string idempotency_key = 1;
@@ -476,14 +1139,18 @@ export type CreateRunRequest = Message<"xeonr.pipelines.v1.CreateRunRequest"> &
476
1139
  */
477
1140
  resource?: Resource | undefined;
478
1141
  /**
479
- * AttestedFacts are facts about this run that the calling product vouches
480
- * for: for the forge, the repository, ref, commit, whether the ref is
481
- * protected, the source, the actor, the run number. The schema is the
482
- * product's; the platform has no column for any of them. Tier policy and
1142
+ * AttestedFacts are facts about this run that the calling service account
1143
+ * vouches for: for the forge, the repository, ref, commit, whether the ref
1144
+ * is protected, the source, the actor, the run number. The schema is the
1145
+ * consuming service's; the platform has no column for any of them. Tier policy and
483
1146
  * secret policies match on them, job identity tokens copy from them, and
484
1147
  * steps read them as environment. They are never taken from the
485
1148
  * definition. At most 64 KiB encoded.
486
1149
  *
1150
+ * Only the tenant's service-account members create runs (people who are
1151
+ * not operators never write), so attested facts are always the consuming
1152
+ * service's assertion, for an inline run and a stored pipeline's alike.
1153
+ *
487
1154
  * @generated from field: google.protobuf.Struct attested_facts = 4;
488
1155
  */
489
1156
  attestedFacts?: JsonObject | undefined;
@@ -510,6 +1177,20 @@ export type CreateRunRequest = Message<"xeonr.pipelines.v1.CreateRunRequest"> &
510
1177
  */
511
1178
  value: string;
512
1179
  case: "snapshotId";
1180
+ } | {
1181
+ /**
1182
+ * Pipeline runs a published version of a stored pipeline of the run's
1183
+ * tenant. The run's resource must be the pipeline's scope or of one of its
1184
+ * `resource_kinds`, and `variables` are checked against its declared
1185
+ * variables, defaults filled. Refused with `failed_precondition` for an
1186
+ * archived pipeline or one never published. The policy's exclusion and
1187
+ * concurrency apply; an `exclusion` given here takes precedence.
1188
+ * Milestone 4.
1189
+ *
1190
+ * @generated from field: xeonr.pipelines.v1.PipelineSource pipeline = 9;
1191
+ */
1192
+ value: PipelineSource;
1193
+ case: "pipeline";
513
1194
  } | {
514
1195
  case: undefined;
515
1196
  value?: undefined;
@@ -1032,7 +1713,7 @@ export type CreateJobRequest = Message<"xeonr.pipelines.v1.CreateJobRequest"> &
1032
1713
  */
1033
1714
  delay?: Duration | undefined;
1034
1715
  /**
1035
- * IdempotencyKey makes the create safe to repeat, per calling product.
1716
+ * IdempotencyKey makes the create safe to repeat, per tenant.
1036
1717
  *
1037
1718
  * @generated from field: string idempotency_key = 5;
1038
1719
  */
@@ -1044,6 +1725,18 @@ export type CreateJobRequest = Message<"xeonr.pipelines.v1.CreateJobRequest"> &
1044
1725
  * @generated from field: xeonr.pipelines.v1.Resource resource = 6;
1045
1726
  */
1046
1727
  resource?: Resource | undefined;
1728
+ /**
1729
+ * Queue is the queue the job is admitted through, by name, among the
1730
+ * job's tenant's queues. Unset is the tenant's `default` queue, which
1731
+ * behaves as jobs did before queues.
1732
+ * An unknown name is refused with `not_found`; a job asking for more
1733
+ * retries or a longer timeout than the queue allows is refused with
1734
+ * `invalid_argument`. When `retry` or `timeout` is unset the queue's
1735
+ * default applies, then the platform's. Milestone 2.
1736
+ *
1737
+ * @generated from field: string queue = 10;
1738
+ */
1739
+ queue: string;
1047
1740
  /**
1048
1741
  * Retry is the job's retry policy, the same message and meaning as a
1049
1742
  * node's `retry`, applied to the job's one node. Unset is the platform
@@ -1064,12 +1757,156 @@ export type CreateJobRequest = Message<"xeonr.pipelines.v1.CreateJobRequest"> &
1064
1757
  * @generated from field: google.protobuf.Duration timeout = 8;
1065
1758
  */
1066
1759
  timeout?: Duration | undefined;
1760
+ /**
1761
+ * Interruptible is the job's node's `interruptible`, with the same
1762
+ * meaning: an attempt its worker stops because the worker is shutting
1763
+ * down (FAILURE_CLASS_INTERRUPTED) is offered again without spending a
1764
+ * retry, up to the platform's bound. Unset, as for a node, every such
1765
+ * interruption counts against `retry.max`. Set it for a handler that is
1766
+ * safe to run again from the start. Milestone 2.
1767
+ *
1768
+ * validate:skip a bool has no bounds
1769
+ *
1770
+ * @generated from field: bool interruptible = 9;
1771
+ */
1772
+ interruptible: boolean;
1773
+ /**
1774
+ * FairnessKey is the key the job's queue is fair by and caps per, in
1775
+ * place of the tenant: the consuming service's word for whose work this is
1776
+ * inside its tenant (a group, a project, one of its users). A job has no
1777
+ * attested facts, so the service names the key here. Jobs of one tenant
1778
+ * with different keys are different lanes of the queue: the next claim
1779
+ * goes to the lane with the fewest running attempts, and
1780
+ * `Queue.max_concurrency_per_tenant` caps each lane, not the tenant as a
1781
+ * whole. A key never crosses tenants: the lane is the tenant and the key
1782
+ * together. Empty means the tenant: the job shares the one lane of its
1783
+ * tenant's jobs with no key, which is how every job behaved before this
1784
+ * field. It is the consuming service's assertion, as the tenant is, and is read
1785
+ * back as `Run.fairness_key`. Printable ASCII without spaces, at most 128
1786
+ * bytes. PIPE-128.
1787
+ *
1788
+ * @generated from field: string fairness_key = 11;
1789
+ */
1790
+ fairnessKey: string;
1067
1791
  };
1068
1792
  /**
1069
1793
  * Describes the message xeonr.pipelines.v1.CreateJobRequest.
1070
1794
  * Use `create(CreateJobRequestSchema)` to create a new message.
1071
1795
  */
1072
1796
  export declare const CreateJobRequestSchema: GenMessage<CreateJobRequest>;
1797
+ /**
1798
+ * @generated from message xeonr.pipelines.v1.ListIssuesRequest
1799
+ */
1800
+ export type ListIssuesRequest = Message<"xeonr.pipelines.v1.ListIssuesRequest"> & {
1801
+ /**
1802
+ * @generated from field: string run_id = 1;
1803
+ */
1804
+ runId: string;
1805
+ /**
1806
+ * NodeID narrows to one node's issues.
1807
+ *
1808
+ * @generated from field: string node_id = 2;
1809
+ */
1810
+ nodeId: string;
1811
+ /**
1812
+ * AttemptID narrows to one attempt's issues.
1813
+ *
1814
+ * @generated from field: string attempt_id = 3;
1815
+ */
1816
+ attemptId: string;
1817
+ /**
1818
+ * MinSeverity leaves out issues below it. Unset lists all.
1819
+ *
1820
+ * @generated from field: xeonr.pipelines.v1.IssueSeverity min_severity = 4;
1821
+ */
1822
+ minSeverity: IssueSeverity;
1823
+ /**
1824
+ * Cursor is opaque, empty for the first page.
1825
+ *
1826
+ * @generated from field: string cursor = 5;
1827
+ */
1828
+ cursor: string;
1829
+ /**
1830
+ * Limit is capped at 500; zero means the default of 100.
1831
+ *
1832
+ * @generated from field: uint32 limit = 6;
1833
+ */
1834
+ limit: number;
1835
+ };
1836
+ /**
1837
+ * Describes the message xeonr.pipelines.v1.ListIssuesRequest.
1838
+ * Use `create(ListIssuesRequestSchema)` to create a new message.
1839
+ */
1840
+ export declare const ListIssuesRequestSchema: GenMessage<ListIssuesRequest>;
1841
+ /**
1842
+ * @generated from message xeonr.pipelines.v1.ListIssuesResponse
1843
+ */
1844
+ export type ListIssuesResponse = Message<"xeonr.pipelines.v1.ListIssuesResponse"> & {
1845
+ /**
1846
+ * @generated from field: repeated xeonr.pipelines.v1.RunIssue issues = 1;
1847
+ */
1848
+ issues: RunIssue[];
1849
+ /**
1850
+ * NextCursor is empty when there is no further page.
1851
+ *
1852
+ * @generated from field: string next_cursor = 2;
1853
+ */
1854
+ nextCursor: string;
1855
+ };
1856
+ /**
1857
+ * Describes the message xeonr.pipelines.v1.ListIssuesResponse.
1858
+ * Use `create(ListIssuesResponseSchema)` to create a new message.
1859
+ */
1860
+ export declare const ListIssuesResponseSchema: GenMessage<ListIssuesResponse>;
1861
+ /**
1862
+ * @generated from message xeonr.pipelines.v1.GetRunTraceRequest
1863
+ */
1864
+ export type GetRunTraceRequest = Message<"xeonr.pipelines.v1.GetRunTraceRequest"> & {
1865
+ /**
1866
+ * @generated from field: string run_id = 1;
1867
+ */
1868
+ runId: string;
1869
+ /**
1870
+ * NodeID narrows to one node's spans (and the run's root).
1871
+ *
1872
+ * @generated from field: string node_id = 2;
1873
+ */
1874
+ nodeId: string;
1875
+ /**
1876
+ * AttemptID narrows to one attempt's spans (and its node's and the
1877
+ * run's).
1878
+ *
1879
+ * @generated from field: string attempt_id = 3;
1880
+ */
1881
+ attemptId: string;
1882
+ };
1883
+ /**
1884
+ * Describes the message xeonr.pipelines.v1.GetRunTraceRequest.
1885
+ * Use `create(GetRunTraceRequestSchema)` to create a new message.
1886
+ */
1887
+ export declare const GetRunTraceRequestSchema: GenMessage<GetRunTraceRequest>;
1888
+ /**
1889
+ * @generated from message xeonr.pipelines.v1.GetRunTraceResponse
1890
+ */
1891
+ export type GetRunTraceResponse = Message<"xeonr.pipelines.v1.GetRunTraceResponse"> & {
1892
+ /**
1893
+ * Spans are ordered by start.
1894
+ *
1895
+ * @generated from field: repeated xeonr.pipelines.v1.TraceSpan spans = 1;
1896
+ */
1897
+ spans: TraceSpan[];
1898
+ /**
1899
+ * Truncated says step spans were dropped at the per-attempt cap.
1900
+ *
1901
+ * @generated from field: bool truncated = 2;
1902
+ */
1903
+ truncated: boolean;
1904
+ };
1905
+ /**
1906
+ * Describes the message xeonr.pipelines.v1.GetRunTraceResponse.
1907
+ * Use `create(GetRunTraceResponseSchema)` to create a new message.
1908
+ */
1909
+ export declare const GetRunTraceResponseSchema: GenMessage<GetRunTraceResponse>;
1073
1910
  /**
1074
1911
  * @generated from message xeonr.pipelines.v1.CreateJobResponse
1075
1912
  */
@@ -1121,18 +1958,323 @@ export declare enum ConflictPolicy {
1121
1958
  * Describes the enum xeonr.pipelines.v1.ConflictPolicy.
1122
1959
  */
1123
1960
  export declare const ConflictPolicySchema: GenEnum<ConflictPolicy>;
1961
+ /**
1962
+ * RunOrigin is where a run's snapshot came from: the CI-first plan's
1963
+ * snapshot `origin`.
1964
+ *
1965
+ * @generated from enum xeonr.pipelines.v1.RunOrigin
1966
+ */
1967
+ export declare enum RunOrigin {
1968
+ /**
1969
+ * @generated from enum value: RUN_ORIGIN_UNSPECIFIED = 0;
1970
+ */
1971
+ UNSPECIFIED = 0,
1972
+ /**
1973
+ * A definition given inline to CreateRun, or a job's one-node graph.
1974
+ *
1975
+ * @generated from enum value: RUN_ORIGIN_INLINE = 1;
1976
+ */
1977
+ INLINE = 1,
1978
+ /**
1979
+ * A published version of a stored pipeline (PipelinesService).
1980
+ *
1981
+ * @generated from enum value: RUN_ORIGIN_PUBLISHED = 2;
1982
+ */
1983
+ PUBLISHED = 2
1984
+ }
1985
+ /**
1986
+ * Describes the enum xeonr.pipelines.v1.RunOrigin.
1987
+ */
1988
+ export declare const RunOriginSchema: GenEnum<RunOrigin>;
1989
+ /**
1990
+ * RunTrigger is what started a run.
1991
+ *
1992
+ * @generated from enum xeonr.pipelines.v1.RunTrigger
1993
+ */
1994
+ export declare enum RunTrigger {
1995
+ /**
1996
+ * @generated from enum value: RUN_TRIGGER_UNSPECIFIED = 0;
1997
+ */
1998
+ UNSPECIFIED = 0,
1999
+ /**
2000
+ * A caller: CreateRun or CreateJob (platform-design §6.2's `api`).
2001
+ *
2002
+ * @generated from enum value: RUN_TRIGGER_API = 1;
2003
+ */
2004
+ API = 1,
2005
+ /**
2006
+ * A schedule's occurrence (SchedulesService); `schedule_id` and
2007
+ * `scheduled_for` say which.
2008
+ *
2009
+ * @generated from enum value: RUN_TRIGGER_SCHEDULE = 2;
2010
+ */
2011
+ SCHEDULE = 2,
2012
+ /**
2013
+ * Another run: a trigger node or a sub-pipeline node; `parent_run_id`
2014
+ * and `parent_node_id` say which.
2015
+ *
2016
+ * @generated from enum value: RUN_TRIGGER_PARENT = 3;
2017
+ */
2018
+ PARENT = 3
2019
+ }
2020
+ /**
2021
+ * Describes the enum xeonr.pipelines.v1.RunTrigger.
2022
+ */
2023
+ export declare const RunTriggerSchema: GenEnum<RunTrigger>;
2024
+ /**
2025
+ * StageState is where one declared stage of an attempt is.
2026
+ *
2027
+ * @generated from enum xeonr.pipelines.v1.StageState
2028
+ */
2029
+ export declare enum StageState {
2030
+ /**
2031
+ * @generated from enum value: STAGE_STATE_UNSPECIFIED = 0;
2032
+ */
2033
+ UNSPECIFIED = 0,
2034
+ /**
2035
+ * Declared, not reached yet.
2036
+ *
2037
+ * @generated from enum value: STAGE_STATE_PENDING = 1;
2038
+ */
2039
+ PENDING = 1,
2040
+ /**
2041
+ * @generated from enum value: STAGE_STATE_RUNNING = 2;
2042
+ */
2043
+ RUNNING = 2,
2044
+ /**
2045
+ * @generated from enum value: STAGE_STATE_SUCCEEDED = 3;
2046
+ */
2047
+ SUCCEEDED = 3,
2048
+ /**
2049
+ * @generated from enum value: STAGE_STATE_FAILED = 4;
2050
+ */
2051
+ FAILED = 4,
2052
+ /**
2053
+ * @generated from enum value: STAGE_STATE_SKIPPED = 5;
2054
+ */
2055
+ SKIPPED = 5
2056
+ }
2057
+ /**
2058
+ * Describes the enum xeonr.pipelines.v1.StageState.
2059
+ */
2060
+ export declare const StageStateSchema: GenEnum<StageState>;
2061
+ /**
2062
+ * IssueSeverity ranks an issue. The worker surface's
2063
+ * xeonr.pipelines.private.v1.IssueSeverity has the same values.
2064
+ *
2065
+ * @generated from enum xeonr.pipelines.v1.IssueSeverity
2066
+ */
2067
+ export declare enum IssueSeverity {
2068
+ /**
2069
+ * @generated from enum value: ISSUE_SEVERITY_UNSPECIFIED = 0;
2070
+ */
2071
+ UNSPECIFIED = 0,
2072
+ /**
2073
+ * @generated from enum value: ISSUE_SEVERITY_INFO = 1;
2074
+ */
2075
+ INFO = 1,
2076
+ /**
2077
+ * @generated from enum value: ISSUE_SEVERITY_WARNING = 2;
2078
+ */
2079
+ WARNING = 2,
2080
+ /**
2081
+ * @generated from enum value: ISSUE_SEVERITY_ERROR = 3;
2082
+ */
2083
+ ERROR = 3
2084
+ }
2085
+ /**
2086
+ * Describes the enum xeonr.pipelines.v1.IssueSeverity.
2087
+ */
2088
+ export declare const IssueSeveritySchema: GenEnum<IssueSeverity>;
2089
+ /**
2090
+ * TraceSpanSource is who recorded a span.
2091
+ *
2092
+ * @generated from enum xeonr.pipelines.v1.TraceSpanSource
2093
+ */
2094
+ export declare enum TraceSpanSource {
2095
+ /**
2096
+ * @generated from enum value: TRACE_SPAN_SOURCE_UNSPECIFIED = 0;
2097
+ */
2098
+ UNSPECIFIED = 0,
2099
+ /**
2100
+ * The platform, from the run's own record: the run, its nodes and their
2101
+ * attempts' lifecycle.
2102
+ *
2103
+ * @generated from enum value: TRACE_SPAN_SOURCE_PLATFORM = 1;
2104
+ */
2105
+ PLATFORM = 1,
2106
+ /**
2107
+ * A step or a worker handler, through ReportSpans.
2108
+ *
2109
+ * @generated from enum value: TRACE_SPAN_SOURCE_STEP = 2;
2110
+ */
2111
+ STEP = 2
2112
+ }
2113
+ /**
2114
+ * Describes the enum xeonr.pipelines.v1.TraceSpanSource.
2115
+ */
2116
+ export declare const TraceSpanSourceSchema: GenEnum<TraceSpanSource>;
2117
+ /**
2118
+ * SecretWithheldReason is why an optional grant was not delivered.
2119
+ *
2120
+ * @generated from enum xeonr.pipelines.v1.SecretWithheldReason
2121
+ */
2122
+ export declare enum SecretWithheldReason {
2123
+ /**
2124
+ * @generated from enum value: SECRET_WITHHELD_REASON_UNSPECIFIED = 0;
2125
+ */
2126
+ UNSPECIFIED = 0,
2127
+ /**
2128
+ * No secret of the granted name exists in the run's tenant or resource.
2129
+ *
2130
+ * @generated from enum value: SECRET_WITHHELD_REASON_NOT_FOUND = 1;
2131
+ */
2132
+ NOT_FOUND = 1,
2133
+ /**
2134
+ * The secret exists, and its policy refuses this attempt: its attested
2135
+ * facts, step package or tier. Also a WARNING run issue, so a
2136
+ * misconfigured policy is seen.
2137
+ *
2138
+ * @generated from enum value: SECRET_WITHHELD_REASON_POLICY_DENIED = 2;
2139
+ */
2140
+ POLICY_DENIED = 2
2141
+ }
2142
+ /**
2143
+ * Describes the enum xeonr.pipelines.v1.SecretWithheldReason.
2144
+ */
2145
+ export declare const SecretWithheldReasonSchema: GenEnum<SecretWithheldReason>;
2146
+ /**
2147
+ * ServiceOutcome is how a service fared, as of the end of its attempt's
2148
+ * step. It mirrors container-platform's per-service outcome (CP-333).
2149
+ *
2150
+ * @generated from enum xeonr.pipelines.v1.ServiceOutcome
2151
+ */
2152
+ export declare enum ServiceOutcome {
2153
+ /**
2154
+ * The backend did not report one: a runner pool, or an attempt still
2155
+ * running.
2156
+ *
2157
+ * @generated from enum value: SERVICE_OUTCOME_UNSPECIFIED = 0;
2158
+ */
2159
+ UNSPECIFIED = 0,
2160
+ /**
2161
+ * It never started: an earlier service held it back, or the attempt
2162
+ * ended first.
2163
+ *
2164
+ * @generated from enum value: SERVICE_OUTCOME_NOT_STARTED = 1;
2165
+ */
2166
+ NOT_STARTED = 1,
2167
+ /**
2168
+ * Its image could not be pulled; the step never ran.
2169
+ *
2170
+ * @generated from enum value: SERVICE_OUTCOME_IMAGE_PULL_FAILED = 2;
2171
+ */
2172
+ IMAGE_PULL_FAILED = 2,
2173
+ /**
2174
+ * It started but never became ready; the step never ran.
2175
+ *
2176
+ * @generated from enum value: SERVICE_OUTCOME_NOT_READY = 3;
2177
+ */
2178
+ NOT_READY = 3,
2179
+ /**
2180
+ * It was up and still running when the step ended. The normal case.
2181
+ *
2182
+ * @generated from enum value: SERVICE_OUTCOME_RUNNING = 4;
2183
+ */
2184
+ RUNNING = 4,
2185
+ /**
2186
+ * It was up, but had exited by the time the step ended, or had exited and
2187
+ * been restarted.
2188
+ *
2189
+ * @generated from enum value: SERVICE_OUTCOME_EXITED = 5;
2190
+ */
2191
+ EXITED = 5
2192
+ }
2193
+ /**
2194
+ * Describes the enum xeonr.pipelines.v1.ServiceOutcome.
2195
+ */
2196
+ export declare const ServiceOutcomeSchema: GenEnum<ServiceOutcome>;
2197
+ /**
2198
+ * CacheRestore is what an attempt's restore of a cache found.
2199
+ *
2200
+ * @generated from enum xeonr.pipelines.v1.CacheRestore
2201
+ */
2202
+ export declare enum CacheRestore {
2203
+ /**
2204
+ * The attempt did not look the cache up (yet).
2205
+ *
2206
+ * @generated from enum value: CACHE_RESTORE_UNSPECIFIED = 0;
2207
+ */
2208
+ UNSPECIFIED = 0,
2209
+ /**
2210
+ * A saved archive was found and handed to the attempt; `restored_key` is
2211
+ * the key it was saved under (the exact key, or a fallback's match).
2212
+ *
2213
+ * @generated from enum value: CACHE_RESTORE_HIT = 1;
2214
+ */
2215
+ HIT = 1,
2216
+ /**
2217
+ * Nothing was saved under the key or any fallback.
2218
+ *
2219
+ * @generated from enum value: CACHE_RESTORE_MISS = 2;
2220
+ */
2221
+ MISS = 2
2222
+ }
2223
+ /**
2224
+ * Describes the enum xeonr.pipelines.v1.CacheRestore.
2225
+ */
2226
+ export declare const CacheRestoreSchema: GenEnum<CacheRestore>;
2227
+ /**
2228
+ * CacheSave is what became of an attempt's save of a cache.
2229
+ *
2230
+ * @generated from enum xeonr.pipelines.v1.CacheSave
2231
+ */
2232
+ export declare enum CacheSave {
2233
+ /**
2234
+ * The attempt did not save it: a PULL cache, a save_when that did not
2235
+ * hold, or an attempt still running.
2236
+ *
2237
+ * @generated from enum value: CACHE_SAVE_UNSPECIFIED = 0;
2238
+ */
2239
+ UNSPECIFIED = 0,
2240
+ /**
2241
+ * The attempt's archive was saved under `key`.
2242
+ *
2243
+ * @generated from enum value: CACHE_SAVE_SAVED = 1;
2244
+ */
2245
+ SAVED = 1,
2246
+ /**
2247
+ * The key was already saved (by this or another run), so nothing was
2248
+ * written: the first writer wins.
2249
+ *
2250
+ * @generated from enum value: CACHE_SAVE_EXISTS = 2;
2251
+ */
2252
+ EXISTS = 2,
2253
+ /**
2254
+ * A save was reserved but its upload never completed.
2255
+ *
2256
+ * @generated from enum value: CACHE_SAVE_INCOMPLETE = 3;
2257
+ */
2258
+ INCOMPLETE = 3
2259
+ }
2260
+ /**
2261
+ * Describes the enum xeonr.pipelines.v1.CacheSave.
2262
+ */
2263
+ export declare const CacheSaveSchema: GenEnum<CacheSave>;
1124
2264
  /**
1125
2265
  * RunsService creates runs and reads what became of them. It is the surface a
1126
- * consuming product drives (the forge starts a run per push) and the one the
2266
+ * consuming service drives (the forge starts a run per push) and the one the
1127
2267
  * console and CLI show: there is no separate read model for people.
1128
2268
  *
1129
- * Ownership. Every run belongs to a tenant, a Xeonr Auth team. A person may
1130
- * read and act on a run only as a member of that team, which the service asks
1131
- * of Auth as the caller. A product calls with its Auth service-account token
1132
- * (every RPC here admits service accounts) and names the tenant itself: the
1133
- * platform holds it to its scope and to the tenants it may act for. A run of
1134
- * a tenant the caller cannot see answers `not_found`, never
1135
- * `permission_denied`.
2269
+ * Ownership. Every run belongs to a tenant, a Xeonr Auth team: the consuming
2270
+ * service's own platform team. Membership of that team, asked of Auth as the
2271
+ * caller, decides everything. Its members, and the platform's operators, read
2272
+ * its runs. Its members that are service accounts (a service's service
2273
+ * accounts are members of its own team; every RPC here admits service
2274
+ * accounts) create, cancel, retry and release them, naming the tenant on each
2275
+ * call. People who are not operators never write, so a person's write is
2276
+ * refused with `permission_denied`. A run of a tenant the caller cannot see
2277
+ * answers `not_found`, never `permission_denied`.
1136
2278
  *
1137
2279
  * Verbs outside api.rpc-naming's, each for a reason:
1138
2280
  *
@@ -1225,6 +2367,22 @@ export declare const RunsService: GenService<{
1225
2367
  input: typeof ReleaseNodeRequestSchema;
1226
2368
  output: typeof ReleaseNodeResponseSchema;
1227
2369
  };
2370
+ /**
2371
+ * @generated from rpc xeonr.pipelines.v1.RunsService.ListIssues
2372
+ */
2373
+ listIssues: {
2374
+ methodKind: "unary";
2375
+ input: typeof ListIssuesRequestSchema;
2376
+ output: typeof ListIssuesResponseSchema;
2377
+ };
2378
+ /**
2379
+ * @generated from rpc xeonr.pipelines.v1.RunsService.GetRunTrace
2380
+ */
2381
+ getRunTrace: {
2382
+ methodKind: "unary";
2383
+ input: typeof GetRunTraceRequestSchema;
2384
+ output: typeof GetRunTraceResponseSchema;
2385
+ };
1228
2386
  /**
1229
2387
  * @generated from rpc xeonr.pipelines.v1.RunsService.CreateJob
1230
2388
  */