@xeonr/pipelines-sdk 0.0.0-stage → 0.1.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 (102) hide show
  1. package/README.md +267 -2
  2. package/dist/auth.d.ts +72 -0
  3. package/dist/auth.d.ts.map +1 -0
  4. package/dist/auth.js +139 -0
  5. package/dist/auth.js.map +1 -0
  6. package/dist/client.d.ts +118 -0
  7. package/dist/client.d.ts.map +1 -0
  8. package/dist/client.js +101 -0
  9. package/dist/client.js.map +1 -0
  10. package/dist/errors.d.ts +77 -0
  11. package/dist/errors.d.ts.map +1 -0
  12. package/dist/errors.js +72 -0
  13. package/dist/errors.js.map +1 -0
  14. package/dist/gen/buf/validate/validate_pb.d.ts +4828 -0
  15. package/dist/gen/buf/validate/validate_pb.d.ts.map +1 -0
  16. package/dist/gen/buf/validate/validate_pb.js +357 -0
  17. package/dist/gen/buf/validate/validate_pb.js.map +1 -0
  18. package/dist/gen/gnostic/openapi/v3/annotations_pb.d.ts +24 -0
  19. package/dist/gen/gnostic/openapi/v3/annotations_pb.d.ts.map +1 -0
  20. package/dist/gen/gnostic/openapi/v3/annotations_pb.js +37 -0
  21. package/dist/gen/gnostic/openapi/v3/annotations_pb.js.map +1 -0
  22. package/dist/gen/gnostic/openapi/v3/openapiv3_pb.d.ts +2245 -0
  23. package/dist/gen/gnostic/openapi/v3/openapiv3_pb.d.ts.map +1 -0
  24. package/dist/gen/gnostic/openapi/v3/openapiv3_pb.js +410 -0
  25. package/dist/gen/gnostic/openapi/v3/openapiv3_pb.js.map +1 -0
  26. package/dist/gen/xeonr/pipelines/private/v1/attempt_pb.d.ts +1031 -0
  27. package/dist/gen/xeonr/pipelines/private/v1/attempt_pb.d.ts.map +1 -0
  28. package/dist/gen/xeonr/pipelines/private/v1/attempt_pb.js +219 -0
  29. package/dist/gen/xeonr/pipelines/private/v1/attempt_pb.js.map +1 -0
  30. package/dist/gen/xeonr/pipelines/private/v1/runners_pb.d.ts +190 -0
  31. package/dist/gen/xeonr/pipelines/private/v1/runners_pb.d.ts.map +1 -0
  32. package/dist/gen/xeonr/pipelines/private/v1/runners_pb.js +53 -0
  33. package/dist/gen/xeonr/pipelines/private/v1/runners_pb.js.map +1 -0
  34. package/dist/gen/xeonr/pipelines/private/v1/step_local_pb.d.ts +1161 -0
  35. package/dist/gen/xeonr/pipelines/private/v1/step_local_pb.d.ts.map +1 -0
  36. package/dist/gen/xeonr/pipelines/private/v1/step_local_pb.js +269 -0
  37. package/dist/gen/xeonr/pipelines/private/v1/step_local_pb.js.map +1 -0
  38. package/dist/gen/xeonr/pipelines/private/v1/worker_pb.d.ts +915 -0
  39. package/dist/gen/xeonr/pipelines/private/v1/worker_pb.d.ts.map +1 -0
  40. package/dist/gen/xeonr/pipelines/private/v1/worker_pb.js +159 -0
  41. package/dist/gen/xeonr/pipelines/private/v1/worker_pb.js.map +1 -0
  42. package/dist/gen/xeonr/pipelines/v1/common_pb.d.ts +550 -0
  43. package/dist/gen/xeonr/pipelines/v1/common_pb.d.ts.map +1 -0
  44. package/dist/gen/xeonr/pipelines/v1/common_pb.js +453 -0
  45. package/dist/gen/xeonr/pipelines/v1/common_pb.js.map +1 -0
  46. package/dist/gen/xeonr/pipelines/v1/definition_pb.d.ts +760 -0
  47. package/dist/gen/xeonr/pipelines/v1/definition_pb.d.ts.map +1 -0
  48. package/dist/gen/xeonr/pipelines/v1/definition_pb.js +190 -0
  49. package/dist/gen/xeonr/pipelines/v1/definition_pb.js.map +1 -0
  50. package/dist/gen/xeonr/pipelines/v1/pools_pb.d.ts +800 -0
  51. package/dist/gen/xeonr/pipelines/v1/pools_pb.d.ts.map +1 -0
  52. package/dist/gen/xeonr/pipelines/v1/pools_pb.js +247 -0
  53. package/dist/gen/xeonr/pipelines/v1/pools_pb.js.map +1 -0
  54. package/dist/gen/xeonr/pipelines/v1/registry_pb.d.ts +895 -0
  55. package/dist/gen/xeonr/pipelines/v1/registry_pb.d.ts.map +1 -0
  56. package/dist/gen/xeonr/pipelines/v1/registry_pb.js +277 -0
  57. package/dist/gen/xeonr/pipelines/v1/registry_pb.js.map +1 -0
  58. package/dist/gen/xeonr/pipelines/v1/runs_pb.d.ts +1217 -0
  59. package/dist/gen/xeonr/pipelines/v1/runs_pb.d.ts.map +1 -0
  60. package/dist/gen/xeonr/pipelines/v1/runs_pb.js +204 -0
  61. package/dist/gen/xeonr/pipelines/v1/runs_pb.js.map +1 -0
  62. package/dist/gen/xeonr/pipelines/v1/secrets_pb.d.ts +642 -0
  63. package/dist/gen/xeonr/pipelines/v1/secrets_pb.d.ts.map +1 -0
  64. package/dist/gen/xeonr/pipelines/v1/secrets_pb.js +181 -0
  65. package/dist/gen/xeonr/pipelines/v1/secrets_pb.js.map +1 -0
  66. package/dist/gen/xeonr/pipelines/v1/sinks_pb.d.ts +381 -0
  67. package/dist/gen/xeonr/pipelines/v1/sinks_pb.d.ts.map +1 -0
  68. package/dist/gen/xeonr/pipelines/v1/sinks_pb.js +145 -0
  69. package/dist/gen/xeonr/pipelines/v1/sinks_pb.js.map +1 -0
  70. package/dist/gen/xeonr/platform/v1/options_pb.d.ts +313 -0
  71. package/dist/gen/xeonr/platform/v1/options_pb.d.ts.map +1 -0
  72. package/dist/gen/xeonr/platform/v1/options_pb.js +235 -0
  73. package/dist/gen/xeonr/platform/v1/options_pb.js.map +1 -0
  74. package/dist/handler.d.ts +94 -0
  75. package/dist/handler.d.ts.map +1 -0
  76. package/dist/handler.js +18 -0
  77. package/dist/handler.js.map +1 -0
  78. package/dist/index.d.ts +29 -0
  79. package/dist/index.d.ts.map +1 -0
  80. package/dist/index.js +23 -0
  81. package/dist/index.js.map +1 -0
  82. package/dist/internal/time.d.ts +8 -0
  83. package/dist/internal/time.d.ts.map +1 -0
  84. package/dist/internal/time.js +25 -0
  85. package/dist/internal/time.js.map +1 -0
  86. package/dist/logship.d.ts +67 -0
  87. package/dist/logship.d.ts.map +1 -0
  88. package/dist/logship.js +176 -0
  89. package/dist/logship.js.map +1 -0
  90. package/dist/testing/index.d.ts +202 -0
  91. package/dist/testing/index.d.ts.map +1 -0
  92. package/dist/testing/index.js +909 -0
  93. package/dist/testing/index.js.map +1 -0
  94. package/dist/transport.d.ts +43 -0
  95. package/dist/transport.d.ts.map +1 -0
  96. package/dist/transport.js +44 -0
  97. package/dist/transport.js.map +1 -0
  98. package/dist/worker.d.ts +213 -0
  99. package/dist/worker.d.ts.map +1 -0
  100. package/dist/worker.js +664 -0
  101. package/dist/worker.js.map +1 -0
  102. package/package.json +70 -3
@@ -0,0 +1,760 @@
1
+ import type { GenEnum, GenFile, GenMessage } from "@bufbuild/protobuf/codegenv2";
2
+ import type { Duration, Value } from "@bufbuild/protobuf/wkt";
3
+ import type { FailureClass, PackageRef, ResourceRef, Resources, SecretType } from "./common_pb.js";
4
+ import type { JsonObject, Message } from "@bufbuild/protobuf";
5
+ /**
6
+ * Describes the file xeonr/pipelines/v1/definition.proto.
7
+ */
8
+ export declare const file_xeonr_pipelines_v1_definition: GenFile;
9
+ /**
10
+ * Definition is a pipeline: a DAG of nodes.
11
+ *
12
+ * @generated from message xeonr.pipelines.v1.Definition
13
+ */
14
+ export type Definition = Message<"xeonr.pipelines.v1.Definition"> & {
15
+ /**
16
+ * Name is for people; it identifies nothing.
17
+ *
18
+ * @generated from field: string name = 1;
19
+ */
20
+ name: string;
21
+ /**
22
+ * Nodes is the graph. Order carries no meaning beyond display. Ids are
23
+ * unique; a cycle, an unknown need or a reference outside a node's
24
+ * dependency closure refuses the definition.
25
+ *
26
+ * @generated from field: repeated xeonr.pipelines.v1.Node nodes = 2;
27
+ */
28
+ nodes: Node[];
29
+ /**
30
+ * Config is static data frozen in the snapshot, read as
31
+ * `${{ config.<path> }}`. At most 64 KiB encoded.
32
+ *
33
+ * @generated from field: google.protobuf.Struct config = 3;
34
+ */
35
+ config?: JsonObject | undefined;
36
+ /**
37
+ * MaxParallelNodes caps how many nodes of one run execute at once. Zero is
38
+ * the platform default.
39
+ *
40
+ * @generated from field: uint32 max_parallel_nodes = 4;
41
+ */
42
+ maxParallelNodes: number;
43
+ /**
44
+ * Timeout bounds the whole run from its start; when it passes the run is
45
+ * cancelled. Unset is the platform default. Milestone 2.
46
+ *
47
+ * @generated from field: google.protobuf.Duration timeout = 5;
48
+ */
49
+ timeout?: Duration | undefined;
50
+ };
51
+ /**
52
+ * Describes the message xeonr.pipelines.v1.Definition.
53
+ * Use `create(DefinitionSchema)` to create a new message.
54
+ */
55
+ export declare const DefinitionSchema: GenMessage<Definition>;
56
+ /**
57
+ * Node is one step of the graph: what to run, with which inputs, after what,
58
+ * and where.
59
+ *
60
+ * @generated from message xeonr.pipelines.v1.Node
61
+ */
62
+ export type Node = Message<"xeonr.pipelines.v1.Node"> & {
63
+ /**
64
+ * ID is unique in the definition and is how expressions, needs, events and
65
+ * RetryNode address the node.
66
+ *
67
+ * @generated from field: string id = 1;
68
+ */
69
+ id: string;
70
+ /**
71
+ * Name is for people; empty shows the id.
72
+ *
73
+ * @generated from field: string name = 2;
74
+ */
75
+ name: string;
76
+ /**
77
+ * Action is what the node does.
78
+ *
79
+ * @generated from oneof xeonr.pipelines.v1.Node.action
80
+ */
81
+ action: {
82
+ /**
83
+ * Uses runs one exact version of a step package from the registry. An
84
+ * `exec` package runs as a container on a runner pool chosen by
85
+ * `runs_on`; a `worker` package runs as a handler in an SDK worker.
86
+ *
87
+ * @generated from field: xeonr.pipelines.v1.PackageRef uses = 3;
88
+ */
89
+ value: PackageRef;
90
+ case: "uses";
91
+ } | {
92
+ /**
93
+ * Handler runs a worker handler by name: the `<namespace>/<name>` of a
94
+ * `worker` package, at its newest READY version when the snapshot is
95
+ * made. It is claimed by SDK workers that registered the handler, and
96
+ * never by a runner pool. Milestone 2.
97
+ *
98
+ * @generated from field: string handler = 4;
99
+ */
100
+ value: string;
101
+ case: "handler";
102
+ } | {
103
+ /**
104
+ * Trigger starts a downstream run instead of running a step.
105
+ * Milestone 2.
106
+ *
107
+ * @generated from field: xeonr.pipelines.v1.Trigger trigger = 5;
108
+ */
109
+ value: Trigger;
110
+ case: "trigger";
111
+ } | {
112
+ case: undefined;
113
+ value?: undefined;
114
+ };
115
+ /**
116
+ * With gives the step its inputs, by the input names its manifest
117
+ * declares. A value is a literal or a whole-value `${{ }}` reference (see
118
+ * the file comment); inside a list or an object, each string element may
119
+ * be one too. Inputs are checked against the manifest when the run starts
120
+ * and again when the node is dispatched.
121
+ *
122
+ * @generated from field: map<string, google.protobuf.Value> with = 6;
123
+ */
124
+ with: {
125
+ [key: string]: Value;
126
+ };
127
+ /**
128
+ * Needs are the nodes that must be terminal before this one is considered.
129
+ *
130
+ * @generated from field: repeated xeonr.pipelines.v1.Need needs = 7;
131
+ */
132
+ needs: Need[];
133
+ /**
134
+ * RunsOn says what the pool running this node must offer. Only for a node
135
+ * that `uses` an exec package. It never names a pool or a tier.
136
+ *
137
+ * @generated from field: xeonr.pipelines.v1.RunsOn runs_on = 8;
138
+ */
139
+ runsOn?: RunsOn | undefined;
140
+ /**
141
+ * Secrets grants secrets to this node by name. What is delivered is the
142
+ * grant, intersected with the manifest's `required_secrets` and with each
143
+ * secret's own policy. That policy denies by default: a grant is not
144
+ * enough for a secret whose policy does not allow this attempt's facts,
145
+ * step package and tier, each by a list that matches or by its wildcard.
146
+ *
147
+ * @generated from field: repeated xeonr.pipelines.v1.SecretGrant secrets = 9;
148
+ */
149
+ secrets: SecretGrant[];
150
+ /**
151
+ * ContinueOnError, when set, lets the run go on after this node fails: the
152
+ * node ends FAILED_ALLOWED, its dependents proceed, and the run can still
153
+ * succeed.
154
+ *
155
+ * @generated from field: xeonr.pipelines.v1.ContinueOnError continue_on_error = 10;
156
+ */
157
+ continueOnError?: ContinueOnError | undefined;
158
+ /**
159
+ * RunAfterFailure makes the node run once its needs are terminal even if
160
+ * one of them failed or was skipped (the compiled form of "when: always").
161
+ * It still does not run once the run is cancelled.
162
+ *
163
+ * validate:skip a bool has no bounds
164
+ *
165
+ * @generated from field: bool run_after_failure = 11;
166
+ */
167
+ runAfterFailure: boolean;
168
+ /**
169
+ * Retry says when a failed attempt is followed by another. Unset is the
170
+ * platform default: transient classes only, with backoff.
171
+ *
172
+ * @generated from field: xeonr.pipelines.v1.Retry retry = 12;
173
+ */
174
+ retry?: Retry | undefined;
175
+ /**
176
+ * Timeout bounds one attempt from its start. Unset is the platform
177
+ * default; the upper bound is the platform's policy, not this schema's.
178
+ *
179
+ * @generated from field: google.protobuf.Duration timeout = 13;
180
+ */
181
+ timeout?: Duration | undefined;
182
+ /**
183
+ * Interruptible says the node may be stopped when a newer run supersedes
184
+ * this one. A run is superseded only while none of its non-interruptible
185
+ * nodes has started. Milestone 2.
186
+ *
187
+ * validate:skip a bool has no bounds
188
+ *
189
+ * @generated from field: bool interruptible = 14;
190
+ */
191
+ interruptible: boolean;
192
+ /**
193
+ * Lock is a queuing mutex: at most one node holding the same key, within
194
+ * the run's resource, runs at a time. Others wait as BLOCKED in creation
195
+ * order, and are never cancelled by it. Empty takes no lock. Milestone 2.
196
+ *
197
+ * @generated from field: string lock = 15;
198
+ */
199
+ lock: string;
200
+ /**
201
+ * Manual, when set, makes the node wait for ReleaseNode before it runs.
202
+ * Milestone 2.
203
+ *
204
+ * @generated from field: xeonr.pipelines.v1.Manual manual = 16;
205
+ */
206
+ manual?: Manual | undefined;
207
+ /**
208
+ * Services are containers started beside the step for the length of the
209
+ * attempt, reachable by alias. They need a pool with the `services`
210
+ * capability. Milestone 2 runs them; milestone 1 carries the shape.
211
+ *
212
+ * @generated from field: repeated xeonr.pipelines.v1.Service services = 17;
213
+ */
214
+ services: Service[];
215
+ /**
216
+ * Caches are directories restored before the step and saved after it.
217
+ * Milestone 2.
218
+ *
219
+ * @generated from field: repeated xeonr.pipelines.v1.Cache caches = 18;
220
+ */
221
+ caches: Cache[];
222
+ /**
223
+ * Artifacts are files the step leaves behind that the platform commits as
224
+ * blob outputs without the step calling anything. Milestone 2.
225
+ *
226
+ * @generated from field: repeated xeonr.pipelines.v1.Artifact artifacts = 19;
227
+ */
228
+ artifacts: Artifact[];
229
+ /**
230
+ * IDTokenAudiences are the audiences this node may ask job identity tokens
231
+ * for. Each must also be allowed by the platform's policy for the run.
232
+ * Milestone 2.
233
+ *
234
+ * @generated from field: repeated string id_token_audiences = 20;
235
+ */
236
+ idTokenAudiences: string[];
237
+ };
238
+ /**
239
+ * Describes the message xeonr.pipelines.v1.Node.
240
+ * Use `create(NodeSchema)` to create a new message.
241
+ */
242
+ export declare const NodeSchema: GenMessage<Node>;
243
+ /**
244
+ * Need is one edge of the graph.
245
+ *
246
+ * @generated from message xeonr.pipelines.v1.Need
247
+ */
248
+ export type Need = Message<"xeonr.pipelines.v1.Need"> & {
249
+ /**
250
+ * Node is the id of the node needed.
251
+ *
252
+ * @generated from field: string node = 1;
253
+ */
254
+ node: string;
255
+ /**
256
+ * Optional says a skipped need does not skip this node: the edge only
257
+ * orders. A failed need still does, unless the node sets
258
+ * `run_after_failure`.
259
+ *
260
+ * validate:skip a bool has no bounds
261
+ *
262
+ * @generated from field: bool optional = 2;
263
+ */
264
+ optional: boolean;
265
+ /**
266
+ * Artifacts says whether the needed node's artifacts are staged into this
267
+ * node's work directory. Unset means true; set false to take the ordering
268
+ * without the files.
269
+ *
270
+ * validate:skip a bool has no bounds
271
+ *
272
+ * @generated from field: optional bool artifacts = 3;
273
+ */
274
+ artifacts?: boolean | undefined;
275
+ };
276
+ /**
277
+ * Describes the message xeonr.pipelines.v1.Need.
278
+ * Use `create(NeedSchema)` to create a new message.
279
+ */
280
+ export declare const NeedSchema: GenMessage<Need>;
281
+ /**
282
+ * RunsOn is what a node requires of the pool that runs it. A pool may claim
283
+ * the node's attempts only when it covers all of it, is allowed to serve the
284
+ * run's tenant, and is of the tier the platform computed for the attempt.
285
+ *
286
+ * @generated from message xeonr.pipelines.v1.RunsOn
287
+ */
288
+ export type RunsOn = Message<"xeonr.pipelines.v1.RunsOn"> & {
289
+ /**
290
+ * Labels must all be among the pool's labels.
291
+ *
292
+ * @generated from field: repeated string labels = 1;
293
+ */
294
+ labels: string[];
295
+ /**
296
+ * Capabilities must all be among the pool's, beyond those the step's
297
+ * manifest already asks for.
298
+ *
299
+ * @generated from field: repeated string capabilities = 2;
300
+ */
301
+ capabilities: string[];
302
+ /**
303
+ * Resources is the least one slot of the pool must offer.
304
+ *
305
+ * @generated from field: xeonr.pipelines.v1.Resources resources = 3;
306
+ */
307
+ resources?: Resources | undefined;
308
+ /**
309
+ * OS the pool must run (`linux`, `darwin`). Empty accepts any.
310
+ *
311
+ * @generated from field: string os = 4;
312
+ */
313
+ os: string;
314
+ /**
315
+ * Arch the pool must run (`amd64`, `arm64`). Empty accepts any.
316
+ *
317
+ * @generated from field: string arch = 5;
318
+ */
319
+ arch: string;
320
+ };
321
+ /**
322
+ * Describes the message xeonr.pipelines.v1.RunsOn.
323
+ * Use `create(RunsOnSchema)` to create a new message.
324
+ */
325
+ export declare const RunsOnSchema: GenMessage<RunsOn>;
326
+ /**
327
+ * SecretGrant asks for one secret, by name, for one node.
328
+ *
329
+ * @generated from message xeonr.pipelines.v1.SecretGrant
330
+ */
331
+ export type SecretGrant = Message<"xeonr.pipelines.v1.SecretGrant"> & {
332
+ /**
333
+ * Name is the secret's name. A resource-scoped secret of the run's
334
+ * resource takes precedence over a tenant-wide one of the same name.
335
+ *
336
+ * @generated from field: string name = 1;
337
+ */
338
+ name: string;
339
+ /**
340
+ * Type is how the step receives it. It must be the type the secret was
341
+ * stored with.
342
+ *
343
+ * @generated from field: xeonr.pipelines.v1.SecretType type = 2;
344
+ */
345
+ type: SecretType;
346
+ /**
347
+ * Target is the environment variable that carries the value (ENV) or the
348
+ * file's path (FILE). Empty uses the secret's name.
349
+ *
350
+ * @generated from field: string target = 3;
351
+ */
352
+ target: string;
353
+ };
354
+ /**
355
+ * Describes the message xeonr.pipelines.v1.SecretGrant.
356
+ * Use `create(SecretGrantSchema)` to create a new message.
357
+ */
358
+ export declare const SecretGrantSchema: GenMessage<SecretGrant>;
359
+ /**
360
+ * ContinueOnError allows a node's failure.
361
+ *
362
+ * @generated from message xeonr.pipelines.v1.ContinueOnError
363
+ */
364
+ export type ContinueOnError = Message<"xeonr.pipelines.v1.ContinueOnError"> & {
365
+ /**
366
+ * ExitCodes limits the allowance to these exit codes. Empty allows any
367
+ * failure of the node, whatever its class.
368
+ *
369
+ * @generated from field: repeated int32 exit_codes = 1;
370
+ */
371
+ exitCodes: number[];
372
+ };
373
+ /**
374
+ * Describes the message xeonr.pipelines.v1.ContinueOnError.
375
+ * Use `create(ContinueOnErrorSchema)` to create a new message.
376
+ */
377
+ export declare const ContinueOnErrorSchema: GenMessage<ContinueOnError>;
378
+ /**
379
+ * Retry is a node's retry policy. Retries are attempts of the same node and
380
+ * are invisible to the graph.
381
+ *
382
+ * @generated from message xeonr.pipelines.v1.Retry
383
+ */
384
+ export type Retry = Message<"xeonr.pipelines.v1.Retry"> & {
385
+ /**
386
+ * Max is how many attempts may follow the first. Zero never retries, which
387
+ * is what a step with outside effects (a deploy, a migration) declares.
388
+ *
389
+ * @generated from field: uint32 max = 1;
390
+ */
391
+ max: number;
392
+ /**
393
+ * When lists the failure classes that are retried. Empty is the platform's
394
+ * transient set. CANCELLED is never retried.
395
+ *
396
+ * @generated from field: repeated xeonr.pipelines.v1.FailureClass when = 2;
397
+ */
398
+ when: FailureClass[];
399
+ /**
400
+ * Backoff spaces the retries. Unset is the platform default.
401
+ *
402
+ * @generated from field: xeonr.pipelines.v1.Backoff backoff = 3;
403
+ */
404
+ backoff?: Backoff | undefined;
405
+ };
406
+ /**
407
+ * Describes the message xeonr.pipelines.v1.Retry.
408
+ * Use `create(RetrySchema)` to create a new message.
409
+ */
410
+ export declare const RetrySchema: GenMessage<Retry>;
411
+ /**
412
+ * Backoff is exponential: the n-th retry waits initial * multiplier^(n-1),
413
+ * capped at max.
414
+ *
415
+ * @generated from message xeonr.pipelines.v1.Backoff
416
+ */
417
+ export type Backoff = Message<"xeonr.pipelines.v1.Backoff"> & {
418
+ /**
419
+ * @generated from field: google.protobuf.Duration initial = 1;
420
+ */
421
+ initial?: Duration | undefined;
422
+ /**
423
+ * @generated from field: google.protobuf.Duration max = 2;
424
+ */
425
+ max?: Duration | undefined;
426
+ /**
427
+ * Multiplier of at least 1; zero means 2.
428
+ *
429
+ * @generated from field: double multiplier = 3;
430
+ */
431
+ multiplier: number;
432
+ };
433
+ /**
434
+ * Describes the message xeonr.pipelines.v1.Backoff.
435
+ * Use `create(BackoffSchema)` to create a new message.
436
+ */
437
+ export declare const BackoffSchema: GenMessage<Backoff>;
438
+ /**
439
+ * Manual makes a node wait for a release. Who may release is the consuming
440
+ * product's decision: it calls ReleaseNode for a person or a standing
441
+ * grant. The wait is always bounded; this is not a way to park a run for
442
+ * good. Milestone 2.
443
+ *
444
+ * @generated from message xeonr.pipelines.v1.Manual
445
+ */
446
+ export type Manual = Message<"xeonr.pipelines.v1.Manual"> & {
447
+ /**
448
+ * Wait is how long the node may stay WAITING_MANUAL.
449
+ *
450
+ * @generated from field: google.protobuf.Duration wait = 1;
451
+ */
452
+ wait?: Duration | undefined;
453
+ /**
454
+ * OnExpiry defaults to FAIL.
455
+ *
456
+ * @generated from field: xeonr.pipelines.v1.ManualExpiry on_expiry = 2;
457
+ */
458
+ onExpiry: ManualExpiry;
459
+ };
460
+ /**
461
+ * Describes the message xeonr.pipelines.v1.Manual.
462
+ * Use `create(ManualSchema)` to create a new message.
463
+ */
464
+ export declare const ManualSchema: GenMessage<Manual>;
465
+ /**
466
+ * Trigger starts a run for another resource. Milestone 2.
467
+ *
468
+ * The definition and the attested facts of the downstream run are NOT taken
469
+ * from here: a definition is untrusted, and facts are what secret policies
470
+ * and tiers are decided from. They come from the consuming product that owns
471
+ * the downstream resource; how the platform asks it is settled with the
472
+ * milestone 2 implementation. The downstream run's tier is the lower of its
473
+ * own and the triggering run's.
474
+ *
475
+ * @generated from message xeonr.pipelines.v1.Trigger
476
+ */
477
+ export type Trigger = Message<"xeonr.pipelines.v1.Trigger"> & {
478
+ /**
479
+ * Resource is what the downstream run is about. Its tenant is the
480
+ * triggering run's.
481
+ *
482
+ * @generated from field: xeonr.pipelines.v1.ResourceRef resource = 1;
483
+ */
484
+ resource?: ResourceRef | undefined;
485
+ /**
486
+ * Variables are passed to the downstream run. Values may be whole-value
487
+ * references.
488
+ *
489
+ * @generated from field: map<string, google.protobuf.Value> variables = 2;
490
+ */
491
+ variables: {
492
+ [key: string]: Value;
493
+ };
494
+ /**
495
+ * Wait makes this node take the downstream run's result: it succeeds or
496
+ * fails (FAILURE_CLASS_DOWNSTREAM_FAILED) with it. When false the node
497
+ * succeeds as soon as the downstream run is accepted.
498
+ *
499
+ * validate:skip a bool has no bounds
500
+ *
501
+ * @generated from field: bool wait = 3;
502
+ */
503
+ wait: boolean;
504
+ };
505
+ /**
506
+ * Describes the message xeonr.pipelines.v1.Trigger.
507
+ * Use `create(TriggerSchema)` to create a new message.
508
+ */
509
+ export declare const TriggerSchema: GenMessage<Trigger>;
510
+ /**
511
+ * Service is a container that runs beside a step.
512
+ *
513
+ * @generated from message xeonr.pipelines.v1.Service
514
+ */
515
+ export type Service = Message<"xeonr.pipelines.v1.Service"> & {
516
+ /**
517
+ * Image is an OCI reference. A tag is resolved to a digest when the
518
+ * snapshot is made, and the digest is what runs.
519
+ *
520
+ * @generated from field: string image = 1;
521
+ */
522
+ image: string;
523
+ /**
524
+ * Alias is the hostname the step reaches the service by. The step is
525
+ * reachable from the service too.
526
+ *
527
+ * @generated from field: string alias = 2;
528
+ */
529
+ alias: string;
530
+ /**
531
+ * Entrypoint overrides the image's; empty keeps it.
532
+ *
533
+ * @generated from field: repeated string entrypoint = 3;
534
+ */
535
+ entrypoint: string[];
536
+ /**
537
+ * Command overrides the image's; empty keeps it.
538
+ *
539
+ * @generated from field: repeated string command = 4;
540
+ */
541
+ command: string[];
542
+ /**
543
+ * Env is the service's environment. Values are literals: a service never
544
+ * receives a secret.
545
+ *
546
+ * @generated from field: map<string, string> env = 5;
547
+ */
548
+ env: {
549
+ [key: string]: string;
550
+ };
551
+ };
552
+ /**
553
+ * Describes the message xeonr.pipelines.v1.Service.
554
+ * Use `create(ServiceSchema)` to create a new message.
555
+ */
556
+ export declare const ServiceSchema: GenMessage<Service>;
557
+ /**
558
+ * Cache is a set of paths kept between runs. Caches are keyed and stored per
559
+ * tenant, resource and tier: an attempt reads and writes only the caches of
560
+ * its own tier, so a trusted or deploy attempt never reads one an untrusted
561
+ * attempt wrote. A saved key is immutable: the first writer wins. The runner
562
+ * restores and saves them through the private AttemptService (GetCache,
563
+ * CreateCache). Milestone 2.
564
+ *
565
+ * @generated from message xeonr.pipelines.v1.Cache
566
+ */
567
+ export type Cache = Message<"xeonr.pipelines.v1.Cache"> & {
568
+ /**
569
+ * Key names the cache. With `key_files` set, the digest of those files is
570
+ * appended to it at run time, as `<key>-<hex SHA-256>`.
571
+ *
572
+ * @generated from field: string key = 1;
573
+ */
574
+ key: string;
575
+ /**
576
+ * KeyFiles are paths in the work directory hashed into the key.
577
+ *
578
+ * @generated from field: repeated string key_files = 2;
579
+ */
580
+ keyFiles: string[];
581
+ /**
582
+ * FallbackKeys are tried in order when the key misses.
583
+ *
584
+ * @generated from field: repeated string fallback_keys = 3;
585
+ */
586
+ fallbackKeys: string[];
587
+ /**
588
+ * Paths are the directories and files cached, relative to the work
589
+ * directory.
590
+ *
591
+ * @generated from field: repeated string paths = 4;
592
+ */
593
+ paths: string[];
594
+ /**
595
+ * Policy defaults to PULL_PUSH.
596
+ *
597
+ * @generated from field: xeonr.pipelines.v1.CachePolicy policy = 5;
598
+ */
599
+ policy: CachePolicy;
600
+ /**
601
+ * SaveWhen defaults to SUCCESS.
602
+ *
603
+ * @generated from field: xeonr.pipelines.v1.CacheSaveWhen save_when = 6;
604
+ */
605
+ saveWhen: CacheSaveWhen;
606
+ };
607
+ /**
608
+ * Describes the message xeonr.pipelines.v1.Cache.
609
+ * Use `create(CacheSchema)` to create a new message.
610
+ */
611
+ export declare const CacheSchema: GenMessage<Cache>;
612
+ /**
613
+ * Artifact commits files matching path globs as a named blob output of the
614
+ * node, with an expiry. It is how a free-form step produces blobs without
615
+ * calling the platform. Milestone 2.
616
+ *
617
+ * @generated from message xeonr.pipelines.v1.Artifact
618
+ */
619
+ export type Artifact = Message<"xeonr.pipelines.v1.Artifact"> & {
620
+ /**
621
+ * Name is the blob output's name, unique in the node. Downstream nodes
622
+ * read it as `${{ steps.<node>.outputs.blobs.<name> }}`.
623
+ *
624
+ * @generated from field: string name = 1;
625
+ */
626
+ name: string;
627
+ /**
628
+ * Paths are globs relative to the work directory.
629
+ *
630
+ * @generated from field: repeated string paths = 2;
631
+ */
632
+ paths: string[];
633
+ /**
634
+ * When defaults to SUCCESS.
635
+ *
636
+ * @generated from field: xeonr.pipelines.v1.ArtifactWhen when = 3;
637
+ */
638
+ when: ArtifactWhen;
639
+ /**
640
+ * ExpireIn is how long the blob is kept after the run finishes. Unset is
641
+ * the platform's retention.
642
+ *
643
+ * @generated from field: google.protobuf.Duration expire_in = 4;
644
+ */
645
+ expireIn?: Duration | undefined;
646
+ };
647
+ /**
648
+ * Describes the message xeonr.pipelines.v1.Artifact.
649
+ * Use `create(ArtifactSchema)` to create a new message.
650
+ */
651
+ export declare const ArtifactSchema: GenMessage<Artifact>;
652
+ /**
653
+ * ManualExpiry is what becomes of a manual node nobody released in time.
654
+ *
655
+ * @generated from enum xeonr.pipelines.v1.ManualExpiry
656
+ */
657
+ export declare enum ManualExpiry {
658
+ /**
659
+ * @generated from enum value: MANUAL_EXPIRY_UNSPECIFIED = 0;
660
+ */
661
+ UNSPECIFIED = 0,
662
+ /**
663
+ * The node fails with FAILURE_CLASS_MANUAL_EXPIRED.
664
+ *
665
+ * @generated from enum value: MANUAL_EXPIRY_FAIL = 1;
666
+ */
667
+ FAIL = 1,
668
+ /**
669
+ * The node is skipped, and its dependents with it.
670
+ *
671
+ * @generated from enum value: MANUAL_EXPIRY_SKIP = 2;
672
+ */
673
+ SKIP = 2
674
+ }
675
+ /**
676
+ * Describes the enum xeonr.pipelines.v1.ManualExpiry.
677
+ */
678
+ export declare const ManualExpirySchema: GenEnum<ManualExpiry>;
679
+ /**
680
+ * CachePolicy is what a node does with a cache.
681
+ *
682
+ * @generated from enum xeonr.pipelines.v1.CachePolicy
683
+ */
684
+ export declare enum CachePolicy {
685
+ /**
686
+ * @generated from enum value: CACHE_POLICY_UNSPECIFIED = 0;
687
+ */
688
+ UNSPECIFIED = 0,
689
+ /**
690
+ * Restore only.
691
+ *
692
+ * @generated from enum value: CACHE_POLICY_PULL = 1;
693
+ */
694
+ PULL = 1,
695
+ /**
696
+ * Restore, then save.
697
+ *
698
+ * @generated from enum value: CACHE_POLICY_PULL_PUSH = 2;
699
+ */
700
+ PULL_PUSH = 2
701
+ }
702
+ /**
703
+ * Describes the enum xeonr.pipelines.v1.CachePolicy.
704
+ */
705
+ export declare const CachePolicySchema: GenEnum<CachePolicy>;
706
+ /**
707
+ * CacheSaveWhen is when a pull-push cache is saved.
708
+ *
709
+ * @generated from enum xeonr.pipelines.v1.CacheSaveWhen
710
+ */
711
+ export declare enum CacheSaveWhen {
712
+ /**
713
+ * @generated from enum value: CACHE_SAVE_WHEN_UNSPECIFIED = 0;
714
+ */
715
+ UNSPECIFIED = 0,
716
+ /**
717
+ * Only when the step succeeded.
718
+ *
719
+ * @generated from enum value: CACHE_SAVE_WHEN_SUCCESS = 1;
720
+ */
721
+ SUCCESS = 1,
722
+ /**
723
+ * Whatever the step's result.
724
+ *
725
+ * @generated from enum value: CACHE_SAVE_WHEN_ALWAYS = 2;
726
+ */
727
+ ALWAYS = 2
728
+ }
729
+ /**
730
+ * Describes the enum xeonr.pipelines.v1.CacheSaveWhen.
731
+ */
732
+ export declare const CacheSaveWhenSchema: GenEnum<CacheSaveWhen>;
733
+ /**
734
+ * ArtifactWhen is which results of a step commit an artifact.
735
+ *
736
+ * @generated from enum xeonr.pipelines.v1.ArtifactWhen
737
+ */
738
+ export declare enum ArtifactWhen {
739
+ /**
740
+ * @generated from enum value: ARTIFACT_WHEN_UNSPECIFIED = 0;
741
+ */
742
+ UNSPECIFIED = 0,
743
+ /**
744
+ * @generated from enum value: ARTIFACT_WHEN_SUCCESS = 1;
745
+ */
746
+ SUCCESS = 1,
747
+ /**
748
+ * @generated from enum value: ARTIFACT_WHEN_FAILURE = 2;
749
+ */
750
+ FAILURE = 2,
751
+ /**
752
+ * @generated from enum value: ARTIFACT_WHEN_ALWAYS = 3;
753
+ */
754
+ ALWAYS = 3
755
+ }
756
+ /**
757
+ * Describes the enum xeonr.pipelines.v1.ArtifactWhen.
758
+ */
759
+ export declare const ArtifactWhenSchema: GenEnum<ArtifactWhen>;
760
+ //# sourceMappingURL=definition_pb.d.ts.map