@scarn/sdk 0.8.19 → 0.8.21

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 (76) hide show
  1. package/dist/auth/api-token-cache.d.ts +24 -0
  2. package/dist/auth/api-token-source.d.ts +39 -0
  3. package/dist/auth/authenticated-fetch.d.ts +10 -0
  4. package/dist/auth/index.d.ts +3 -0
  5. package/dist/auth/index.js +20 -0
  6. package/dist/automations/index.js +6 -6
  7. package/dist/{chunk-pqtd0hr7.js → chunk-08gcnrzh.js} +2 -2
  8. package/dist/{chunk-2tmrw253.js → chunk-0he2dx5n.js} +5 -5
  9. package/dist/{chunk-aknfw08j.js → chunk-59arcerk.js} +16 -13
  10. package/dist/{chunk-61jf8b6s.js → chunk-5dny5jg1.js} +11 -1
  11. package/dist/{chunk-46wmsgv7.js → chunk-5say64w8.js} +1 -1
  12. package/dist/{chunk-9we3vqsv.js → chunk-6p340dd4.js} +2 -2
  13. package/dist/{chunk-19brnwkp.js → chunk-8hsk6f6b.js} +1 -1
  14. package/dist/{chunk-098740f7.js → chunk-8kzaxz52.js} +1 -1
  15. package/dist/{chunk-mmy80pec.js → chunk-8tmsvkmj.js} +5 -5
  16. package/dist/{chunk-e0pt5x0e.js → chunk-aph2js2v.js} +5 -5
  17. package/dist/chunk-azss2d1n.js +1036 -0
  18. package/dist/{chunk-t1dq2c2s.js → chunk-gasw078g.js} +5 -5
  19. package/dist/{chunk-0c60x3v8.js → chunk-h1v6w1fh.js} +5 -5
  20. package/dist/{chunk-tvjcfh6s.js → chunk-k57h6qke.js} +8 -5
  21. package/dist/{chunk-x0hjhqrf.js → chunk-mp2rqtcj.js} +1 -1
  22. package/dist/{chunk-aemxz9r7.js → chunk-mrzn5tq4.js} +1 -1
  23. package/dist/{chunk-qgkx89eg.js → chunk-nkm31g10.js} +3 -3
  24. package/dist/{chunk-833ef6dg.js → chunk-p74r4y6j.js} +14 -14
  25. package/dist/{chunk-p1fs73bd.js → chunk-pwyj6qf3.js} +2 -2
  26. package/dist/{chunk-evb3hw48.js → chunk-qt81x1pm.js} +7 -4
  27. package/dist/{chunk-mzj1j0p5.js → chunk-r3sbp2wn.js} +3 -3
  28. package/dist/{chunk-rphfy0fj.js → chunk-vsp708vw.js} +1 -1
  29. package/dist/{chunk-yf15kdte.js → chunk-xhpp6qz8.js} +96 -96
  30. package/dist/{chunk-jj9pezwb.js → chunk-xqfj56m9.js} +43 -3
  31. package/dist/{chunk-y34zsgsw.js → chunk-y7ac1t9c.js} +1 -1
  32. package/dist/{chunk-3zp2qtf8.js → chunk-y81cr6tp.js} +38 -14
  33. package/dist/{chunk-ymywp5ht.js → chunk-zxzvketc.js} +5 -5
  34. package/dist/client.d.ts +5 -1
  35. package/dist/client.js +2 -2
  36. package/dist/connectors/index.js +4 -4
  37. package/dist/contracts/artifacts.js +2 -2
  38. package/dist/contracts/automation-document/index.js +3 -3
  39. package/dist/contracts/pipeline-document/index.js +5 -3
  40. package/dist/contracts/pipeline-document/routes.d.ts +9 -0
  41. package/dist/contracts/pipeline-document/schema.d.ts +40 -1
  42. package/dist/contracts/step-artifact-submissions.js +2 -2
  43. package/dist/contracts/work-item-changes.js +1 -1
  44. package/dist/create-api-client.d.ts +11 -0
  45. package/dist/defaults/index.js +32 -871
  46. package/dist/defaults/load-push-defaults.d.ts +11 -4
  47. package/dist/defaults/project-ref.d.ts +2 -4
  48. package/dist/definitions/automations/automations-client.d.ts +2 -1
  49. package/dist/definitions/automations/index.js +3 -3
  50. package/dist/definitions/environments/environments-client.d.ts +2 -1
  51. package/dist/definitions/environments/index.js +10 -10
  52. package/dist/definitions/pipelines/index.js +3 -3
  53. package/dist/definitions/pipelines/pipeline-definitions-client.d.ts +2 -1
  54. package/dist/definitions/steps/index.js +14 -14
  55. package/dist/definitions/steps/step-definitions-client.d.ts +2 -1
  56. package/dist/definitions/validation/index.js +10 -10
  57. package/dist/devcontainer-config-path.js +2 -2
  58. package/dist/env-vars.js +2 -2
  59. package/dist/environment.js +7 -7
  60. package/dist/generated/index.d.ts +1 -1
  61. package/dist/generated/sdk.gen.d.ts +5 -1
  62. package/dist/generated/types.gen.d.ts +298 -0
  63. package/dist/health-checks.js +2 -2
  64. package/dist/index.js +23 -23
  65. package/dist/managed-runtimes.js +2 -2
  66. package/dist/opencode-mcp.js +3 -3
  67. package/dist/pipelines/index.d.ts +1 -1
  68. package/dist/pipelines/index.js +6 -6
  69. package/dist/pipelines/model.d.ts +10 -4
  70. package/dist/pipelines/types.d.ts +13 -1
  71. package/dist/push/index.js +43 -42
  72. package/dist/push/push-from-directory.d.ts +6 -1
  73. package/dist/repo-config.js +2 -2
  74. package/dist/resolve-environment.js +8 -8
  75. package/dist/task-plane-client.d.ts +6 -0
  76. package/package.json +6 -2
@@ -11066,6 +11066,304 @@ export type PostApiPipelineExecutionsByPipelineExecutionIdVisitsByVisitIdRerunRe
11066
11066
  };
11067
11067
  };
11068
11068
  export type PostApiPipelineExecutionsByPipelineExecutionIdVisitsByVisitIdRerunResponse = PostApiPipelineExecutionsByPipelineExecutionIdVisitsByVisitIdRerunResponses[keyof PostApiPipelineExecutionsByPipelineExecutionIdVisitsByVisitIdRerunResponses];
11069
+ export type PostApiPipelineExecutionsByPipelineExecutionIdVisitsByVisitIdRouteData = {
11070
+ body: {
11071
+ routes: Array<{
11072
+ kind: 'route';
11073
+ index: number;
11074
+ } | {
11075
+ kind: 'otherwise';
11076
+ } | {
11077
+ to: string;
11078
+ } | {
11079
+ label: string;
11080
+ }>;
11081
+ reason: string;
11082
+ acceptMissing?: boolean;
11083
+ preview?: boolean;
11084
+ };
11085
+ path: {
11086
+ pipelineExecutionId: string;
11087
+ visitId: string;
11088
+ };
11089
+ query?: never;
11090
+ url: '/api/pipeline-executions/{pipelineExecutionId}/visits/{visitId}/route';
11091
+ };
11092
+ export type PostApiPipelineExecutionsByPipelineExecutionIdVisitsByVisitIdRouteErrors = {
11093
+ /**
11094
+ * Response for status 401
11095
+ */
11096
+ 401: {
11097
+ type: string;
11098
+ title: string;
11099
+ status: number;
11100
+ detail?: string;
11101
+ instance?: string;
11102
+ code?: string;
11103
+ errors?: Array<{
11104
+ path: string;
11105
+ message: string;
11106
+ summary?: string;
11107
+ }>;
11108
+ meta?: {
11109
+ [key: string]: unknown;
11110
+ };
11111
+ };
11112
+ /**
11113
+ * Response for status 403
11114
+ */
11115
+ 403: {
11116
+ type: string;
11117
+ title: string;
11118
+ status: number;
11119
+ detail?: string;
11120
+ instance?: string;
11121
+ code?: string;
11122
+ errors?: Array<{
11123
+ path: string;
11124
+ message: string;
11125
+ summary?: string;
11126
+ }>;
11127
+ meta?: {
11128
+ [key: string]: unknown;
11129
+ };
11130
+ };
11131
+ /**
11132
+ * Response for status 404
11133
+ */
11134
+ 404: {
11135
+ type: string;
11136
+ title: string;
11137
+ status: number;
11138
+ detail?: string;
11139
+ instance?: string;
11140
+ code?: string;
11141
+ errors?: Array<{
11142
+ path: string;
11143
+ message: string;
11144
+ summary?: string;
11145
+ }>;
11146
+ meta?: {
11147
+ [key: string]: unknown;
11148
+ };
11149
+ };
11150
+ /**
11151
+ * Response for status 409
11152
+ */
11153
+ 409: {
11154
+ type: string;
11155
+ title: string;
11156
+ status: number;
11157
+ detail?: string;
11158
+ instance?: string;
11159
+ code?: string;
11160
+ errors?: Array<{
11161
+ path: string;
11162
+ message: string;
11163
+ summary?: string;
11164
+ }>;
11165
+ meta?: {
11166
+ [key: string]: unknown;
11167
+ };
11168
+ };
11169
+ /**
11170
+ * Response for status 422
11171
+ */
11172
+ 422: {
11173
+ type: string;
11174
+ title: string;
11175
+ status: number;
11176
+ detail?: string;
11177
+ instance?: string;
11178
+ code?: string;
11179
+ errors?: Array<{
11180
+ path: string;
11181
+ message: string;
11182
+ summary?: string;
11183
+ }>;
11184
+ meta?: {
11185
+ [key: string]: unknown;
11186
+ };
11187
+ };
11188
+ /**
11189
+ * Response for status 500
11190
+ */
11191
+ 500: {
11192
+ type: string;
11193
+ title: string;
11194
+ status: number;
11195
+ detail?: string;
11196
+ instance?: string;
11197
+ code?: string;
11198
+ errors?: Array<{
11199
+ path: string;
11200
+ message: string;
11201
+ summary?: string;
11202
+ }>;
11203
+ meta?: {
11204
+ [key: string]: unknown;
11205
+ };
11206
+ };
11207
+ };
11208
+ export type PostApiPipelineExecutionsByPipelineExecutionIdVisitsByVisitIdRouteError = PostApiPipelineExecutionsByPipelineExecutionIdVisitsByVisitIdRouteErrors[keyof PostApiPipelineExecutionsByPipelineExecutionIdVisitsByVisitIdRouteErrors];
11209
+ export type PostApiPipelineExecutionsByPipelineExecutionIdVisitsByVisitIdRouteResponses = {
11210
+ /**
11211
+ * Response for status 200
11212
+ */
11213
+ 200: {
11214
+ id: string;
11215
+ projectId: string;
11216
+ workItemId: string;
11217
+ workItemTitle: string;
11218
+ pipelineDefinitionId: string;
11219
+ pipelineDefinitionVersionId: string;
11220
+ runStatus: 'active' | 'waiting' | 'succeeded' | 'failed' | 'cancelled';
11221
+ status: 'queued' | 'running' | 'waiting' | 'succeeded' | 'failed' | 'cancelled';
11222
+ waitingFor: 'decision' | 'reply' | null;
11223
+ endNodeId: string | null;
11224
+ error: {
11225
+ name: string;
11226
+ message: string;
11227
+ cause?: unknown;
11228
+ } | null;
11229
+ triggeredByUserId: string | null;
11230
+ startedBy: {
11231
+ kind: 'user';
11232
+ userId: string;
11233
+ username: string | null;
11234
+ } | {
11235
+ kind: 'automation';
11236
+ automationId: string;
11237
+ key: string;
11238
+ title: string | null;
11239
+ } | {
11240
+ kind: 'system';
11241
+ };
11242
+ cancelledByUserId: string | null;
11243
+ startedAt: string | null;
11244
+ completedAt: string | null;
11245
+ createdAt: string;
11246
+ updatedAt: string;
11247
+ visits: Array<{
11248
+ id: string;
11249
+ nodeId: string;
11250
+ nodeKind: 'step' | 'wait' | 'succeed' | 'fail';
11251
+ laneId: string | null;
11252
+ fromVisitId: string | null;
11253
+ fromLaneGroupId: string | null;
11254
+ transition: {
11255
+ kind: 'start' | 'route' | 'otherwise' | 'catch' | 'merge';
11256
+ index: number;
11257
+ };
11258
+ routing: {
11259
+ [key: string]: unknown;
11260
+ } | null;
11261
+ status: 'active' | 'waiting' | 'succeeded' | 'failed' | 'cancelled' | 'superseded';
11262
+ waitFor: 'decision' | 'reply' | null;
11263
+ actions: Array<{
11264
+ key: string;
11265
+ label: string;
11266
+ body: 'optional' | 'required';
11267
+ }> | null;
11268
+ input: {
11269
+ [key: string]: unknown;
11270
+ };
11271
+ result: unknown | null;
11272
+ resultTaskId: string | null;
11273
+ error: {
11274
+ name: string;
11275
+ message: string;
11276
+ cause?: unknown;
11277
+ } | null;
11278
+ tasks: Array<{
11279
+ taskId: string;
11280
+ attemptNumber: number;
11281
+ status: 'pending' | 'queued' | 'running' | 'succeeded' | 'failed' | 'timeout' | 'abandoned' | 'cancelled' | 'skipped' | 'yielded';
11282
+ startedAt: string | null;
11283
+ completedAt: string | null;
11284
+ workBranch: string | null;
11285
+ }>;
11286
+ questions: Array<{
11287
+ questionId: string;
11288
+ commentId: string;
11289
+ status: 'open' | 'answered' | 'not_needed';
11290
+ }>;
11291
+ conversationId: string | null;
11292
+ createdByUserId: string | null;
11293
+ resolvedByUserId: string | null;
11294
+ resolvedAt: string | null;
11295
+ createdAt: string;
11296
+ completedAt: string | null;
11297
+ }>;
11298
+ laneGroups: Array<{
11299
+ id: string;
11300
+ parentLaneId: string | null;
11301
+ spawnedByVisitId: string;
11302
+ kind: 'each' | 'all';
11303
+ laneCount: number;
11304
+ maxConcurrency: number | null;
11305
+ toleratedFailures: {
11306
+ count: number;
11307
+ } | {
11308
+ percent: number;
11309
+ };
11310
+ status: 'open' | 'merged' | 'failed';
11311
+ }>;
11312
+ lanes: Array<{
11313
+ id: string;
11314
+ laneGroupId: string;
11315
+ index: number;
11316
+ item: unknown | null;
11317
+ route: {
11318
+ kind: 'start' | 'route' | 'otherwise' | 'catch' | 'merge';
11319
+ index: number;
11320
+ };
11321
+ origin: 'split' | 'merge';
11322
+ status: 'pending' | 'active' | 'arrived' | 'ended' | 'failed' | 'cancelled';
11323
+ arrivedAtNodeId: string | null;
11324
+ arrivalArgs: {
11325
+ [key: string]: unknown;
11326
+ } | null;
11327
+ arrivedFromVisitId: string | null;
11328
+ arrivalTransition: {
11329
+ kind: 'start' | 'route' | 'otherwise' | 'catch' | 'merge';
11330
+ index: number;
11331
+ } | null;
11332
+ mergedIntoVisitId: string | null;
11333
+ }>;
11334
+ } | {
11335
+ preview: {
11336
+ superseded: Array<{
11337
+ visitId: string;
11338
+ nodeId: string;
11339
+ status: 'active' | 'waiting' | 'succeeded' | 'failed' | 'cancelled' | 'superseded';
11340
+ }>;
11341
+ cancelledTasks: number;
11342
+ lanesAdded: Array<{
11343
+ route: {
11344
+ kind: 'start' | 'route' | 'otherwise' | 'catch' | 'merge';
11345
+ index: number;
11346
+ };
11347
+ label?: string;
11348
+ }>;
11349
+ lanesRemoved: Array<{
11350
+ route: {
11351
+ kind: 'start' | 'route' | 'otherwise' | 'catch' | 'merge';
11352
+ index: number;
11353
+ };
11354
+ label?: string;
11355
+ }>;
11356
+ mergesRerun: Array<string>;
11357
+ started: Array<string>;
11358
+ reopensRun: boolean;
11359
+ missing: Array<{
11360
+ arg: string;
11361
+ reference: string;
11362
+ }>;
11363
+ };
11364
+ };
11365
+ };
11366
+ export type PostApiPipelineExecutionsByPipelineExecutionIdVisitsByVisitIdRouteResponse = PostApiPipelineExecutionsByPipelineExecutionIdVisitsByVisitIdRouteResponses[keyof PostApiPipelineExecutionsByPipelineExecutionIdVisitsByVisitIdRouteResponses];
11069
11367
  export type PostApiPipelineExecutionsByPipelineExecutionIdQuestionsByQuestionIdAnswerData = {
11070
11368
  body: {
11071
11369
  body: string;
@@ -7,8 +7,8 @@ import {
7
7
  stepHealthChecksInputSchema,
8
8
  stepToolHealthCheckSchema,
9
9
  toolHealthCheckSchema
10
- } from "./chunk-y34zsgsw.js";
11
- import"./chunk-yf15kdte.js";
10
+ } from "./chunk-y7ac1t9c.js";
11
+ import"./chunk-xhpp6qz8.js";
12
12
  import"./chunk-y64skrwp.js";
13
13
  export {
14
14
  cliHealthCheckSchema,
package/dist/index.js CHANGED
@@ -3,7 +3,7 @@ import {
3
3
  readEnvironmentDefinition,
4
4
  resolveEnvironment,
5
5
  resolveEnvironmentDefinition
6
- } from "./chunk-mzj1j0p5.js";
6
+ } from "./chunk-r3sbp2wn.js";
7
7
  import {
8
8
  SCARN_CONFIG_RELATIVE_PATH,
9
9
  parseScarnConfig
@@ -19,7 +19,7 @@ import {
19
19
  WORK_ITEM_TOP_LEVEL_FIELDS,
20
20
  createPipelineDefinitionsClient,
21
21
  resolveWorkItemFieldPath
22
- } from "./chunk-ymywp5ht.js";
22
+ } from "./chunk-zxzvketc.js";
23
23
  import {
24
24
  after,
25
25
  all,
@@ -55,21 +55,21 @@ import {
55
55
  sum,
56
56
  workItem,
57
57
  workItemField
58
- } from "./chunk-aknfw08j.js";
58
+ } from "./chunk-59arcerk.js";
59
59
  import {
60
60
  attach,
61
61
  defineAutomation,
62
62
  onEvent,
63
63
  skip
64
- } from "./chunk-9we3vqsv.js";
65
- import"./chunk-x0hjhqrf.js";
66
- import"./chunk-p1fs73bd.js";
64
+ } from "./chunk-6p340dd4.js";
65
+ import"./chunk-mp2rqtcj.js";
66
+ import"./chunk-pwyj6qf3.js";
67
67
  import {
68
68
  createScarnClient,
69
69
  createTaskPlaneClient
70
- } from "./chunk-tvjcfh6s.js";
71
- import"./chunk-61jf8b6s.js";
72
- import"./chunk-evb3hw48.js";
70
+ } from "./chunk-k57h6qke.js";
71
+ import"./chunk-5dny5jg1.js";
72
+ import"./chunk-qt81x1pm.js";
73
73
  import {
74
74
  ARTIFACT_BRAND,
75
75
  Artifact,
@@ -99,8 +99,8 @@ import {
99
99
  stepEnvironmentHandle,
100
100
  toStepHandle,
101
101
  toStepSpec
102
- } from "./chunk-833ef6dg.js";
103
- import"./chunk-y34zsgsw.js";
102
+ } from "./chunk-p74r4y6j.js";
103
+ import"./chunk-y7ac1t9c.js";
104
104
  import {
105
105
  Env,
106
106
  Runtime,
@@ -113,14 +113,14 @@ import {
113
113
  knownEnvironmentVars,
114
114
  normalizeEnv,
115
115
  renderPromptTemplate
116
- } from "./chunk-t1dq2c2s.js";
116
+ } from "./chunk-gasw078g.js";
117
117
  import"./chunk-6tra3gw8.js";
118
- import"./chunk-jj9pezwb.js";
118
+ import"./chunk-xqfj56m9.js";
119
119
  import {
120
120
  PipelineBuildError,
121
121
  formatIssue
122
122
  } from "./chunk-y11p1q7r.js";
123
- import"./chunk-rphfy0fj.js";
123
+ import"./chunk-vsp708vw.js";
124
124
  import {
125
125
  BrokenDevcontainerReference,
126
126
  EnvironmentInvalid,
@@ -139,10 +139,10 @@ import {
139
139
  storedEnvironmentContentSchema,
140
140
  storedEnvironmentFieldsSchema,
141
141
  storedEnvironmentRuntimeSchema
142
- } from "./chunk-e0pt5x0e.js";
143
- import"./chunk-098740f7.js";
144
- import"./chunk-46wmsgv7.js";
145
- import"./chunk-qgkx89eg.js";
142
+ } from "./chunk-aph2js2v.js";
143
+ import"./chunk-8kzaxz52.js";
144
+ import"./chunk-5say64w8.js";
145
+ import"./chunk-nkm31g10.js";
146
146
  import {
147
147
  collectEnvPlaceholderNames,
148
148
  isEnvPlaceholderValue,
@@ -156,8 +156,8 @@ import {
156
156
  openCodeMcpTimeoutSchema,
157
157
  openCodeResolvedMcpServerConfigSchema,
158
158
  openCodeResolvedMcpServersSchema
159
- } from "./chunk-pqtd0hr7.js";
160
- import"./chunk-aemxz9r7.js";
159
+ } from "./chunk-08gcnrzh.js";
160
+ import"./chunk-mrzn5tq4.js";
161
161
  import {
162
162
  Api,
163
163
  Automations,
@@ -186,7 +186,7 @@ import {
186
186
  WorkItemCommentDrafts,
187
187
  WorkItemComments,
188
188
  WorkItems
189
- } from "./chunk-3zp2qtf8.js";
189
+ } from "./chunk-y81cr6tp.js";
190
190
  import {
191
191
  ARTIFACT_MARKER_SCHEME,
192
192
  buildArtifactMarker,
@@ -205,9 +205,9 @@ import {
205
205
  isEmbeddableArtifactExtension,
206
206
  matchArtifactNode,
207
207
  readArtifactKeyword
208
- } from "./chunk-19brnwkp.js";
208
+ } from "./chunk-8hsk6f6b.js";
209
209
  import"./chunk-01nfqm18.js";
210
- import"./chunk-yf15kdte.js";
210
+ import"./chunk-xhpp6qz8.js";
211
211
  import"./chunk-y64skrwp.js";
212
212
  export {
213
213
  ARTIFACT_BRAND,
@@ -4,8 +4,8 @@ import {
4
4
  MANAGED_RUNTIME_IDS,
5
5
  isManagedRuntimeId,
6
6
  managedRuntimeIdSchema
7
- } from "./chunk-46wmsgv7.js";
8
- import"./chunk-yf15kdte.js";
7
+ } from "./chunk-5say64w8.js";
8
+ import"./chunk-xhpp6qz8.js";
9
9
  import"./chunk-y64skrwp.js";
10
10
  export {
11
11
  DEFAULT_CODE_STEP_RUNTIME_ID,
@@ -12,9 +12,9 @@ import {
12
12
  openCodeMcpTimeoutSchema,
13
13
  openCodeResolvedMcpServerConfigSchema,
14
14
  openCodeResolvedMcpServersSchema
15
- } from "./chunk-pqtd0hr7.js";
16
- import"./chunk-aemxz9r7.js";
17
- import"./chunk-yf15kdte.js";
15
+ } from "./chunk-08gcnrzh.js";
16
+ import"./chunk-mrzn5tq4.js";
17
+ import"./chunk-xhpp6qz8.js";
18
18
  import"./chunk-y64skrwp.js";
19
19
  export {
20
20
  collectEnvPlaceholderNames,
@@ -13,6 +13,6 @@ export { PipelineBuildError, formatIssue } from "./errors";
13
13
  export type { BuildIssue } from "./errors";
14
14
  export type { SourceSite } from "./source";
15
15
  export type { Arg, Args, ErrorValue, JsonLiteral, Literal, Placeholder, Ref, UntypedPlaceholder, } from "./ref-types";
16
- export type { BuiltInError, CatchContext, ConversationResult, DecisionResult, EachOptions, EachTarget, FlowChain, Mergeable, NextContext, NextOptions, NextRoute, NodeHandle, PartialTarget, PipelineStep, ReplyInput, ReplyResult, StepSettings, Target, Terminal, WaitError, WaitHandle, WaitSettings, } from "./types";
16
+ export type { BuiltInError, CatchContext, ConversationResult, DecisionResult, EachOptions, EachTarget, FlowChain, Mergeable, NextContext, NextOptions, NextRoute, NodeHandle, OtherwiseRoute, PartialTarget, PipelineStep, ReplyInput, ReplyResult, StepSettings, Target, Terminal, WaitError, WaitHandle, WaitSettings, } from "./types";
17
17
  export type { StepRef } from "../definitions/steps/step-ref";
18
18
  export type { Catch, Condition as ConditionJson, DecisionAction, DecisionBody, ListArg, JsonSchema, JsonValue, PipelineDocument, PipelineNode, StepCatalog, Next, Otherwise, Route, StepContract, ToleratedFailures, } from "../contracts/pipeline-document";
@@ -34,17 +34,17 @@ import {
34
34
  sum,
35
35
  workItem,
36
36
  workItemField
37
- } from "../chunk-aknfw08j.js";
38
- import"../chunk-x0hjhqrf.js";
39
- import"../chunk-61jf8b6s.js";
40
- import"../chunk-evb3hw48.js";
41
- import"../chunk-jj9pezwb.js";
37
+ } from "../chunk-59arcerk.js";
38
+ import"../chunk-mp2rqtcj.js";
39
+ import"../chunk-5dny5jg1.js";
40
+ import"../chunk-qt81x1pm.js";
41
+ import"../chunk-xqfj56m9.js";
42
42
  import {
43
43
  PipelineBuildError,
44
44
  formatIssue
45
45
  } from "../chunk-y11p1q7r.js";
46
46
  import"../chunk-01nfqm18.js";
47
- import"../chunk-yf15kdte.js";
47
+ import"../chunk-xhpp6qz8.js";
48
48
  import"../chunk-y64skrwp.js";
49
49
  export {
50
50
  PipelineBuildError,
@@ -77,15 +77,21 @@ export interface CatchData {
77
77
  readonly target: TargetSpec;
78
78
  readonly site: SourceSite | null;
79
79
  }
80
- export interface RouteData {
81
- readonly when: ((r: object) => object) | undefined;
80
+ /** A route's target with its `label` and `overridable` flag. */
81
+ export interface OtherwiseData {
82
82
  readonly target: TargetSpec;
83
+ readonly label: string | undefined;
84
+ readonly overridable: true | undefined;
85
+ }
86
+ export interface RouteData extends OtherwiseData {
87
+ readonly when: ((r: object) => object) | undefined;
83
88
  }
84
- /** The `.next(...)` call: its routes, `otherwise`, and match mode. */
89
+ /** The `.next(...)` call: its routes, `otherwise`, match mode and `overridable`. */
85
90
  export interface NextData {
86
91
  readonly match: "first" | "all" | undefined;
87
92
  readonly routes: readonly RouteData[];
88
- readonly otherwise: TargetSpec | undefined;
93
+ readonly otherwise: OtherwiseData | undefined;
94
+ readonly overridable: true | undefined;
89
95
  readonly site: SourceSite | null;
90
96
  }
91
97
  export interface ChainData {
@@ -83,6 +83,16 @@ export type TargetArg<C, T> = T | ((r: C) => T);
83
83
  export interface NextRoute<C> {
84
84
  when?: (r: C) => Condition;
85
85
  to: TargetArg<C, NextTarget>;
86
+ /** Names the route for the people and tools that pick it; unique within one `.next(...)`. */
87
+ label?: string;
88
+ /** Lets a person overrule a visit onto this route. */
89
+ overridable?: true;
90
+ }
91
+ /** `otherwise` with a `label` or `overridable`. */
92
+ export interface OtherwiseRoute<C> {
93
+ to: TargetArg<C, NextTarget>;
94
+ label?: string;
95
+ overridable?: true;
86
96
  }
87
97
  /**
88
98
  * The routes of `.next(...)`. In `"first"` mode (the default) the first
@@ -93,7 +103,9 @@ export interface NextOptions<C> {
93
103
  match?: "first" | "all";
94
104
  routes: readonly [NextRoute<C>, ...NextRoute<C>[]];
95
105
  /** Taken when no route with a `when` matched. With nothing taken, the path ends there. */
96
- otherwise?: TargetArg<C, NextTarget>;
106
+ otherwise?: TargetArg<C, NextTarget> | OtherwiseRoute<C>;
107
+ /** Makes every route overridable, except routes without `when` in `"all"` mode. */
108
+ overridable?: true;
97
109
  }
98
110
  export interface Routable<C, Out> {
99
111
  /** Where to go next: one target, or routes with conditions. Ends the chain. */