@drisp/protocol 0.8.6 → 0.8.8

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.
package/dist/v2.d.ts CHANGED
@@ -23,8 +23,8 @@ declare function forecastOfCap(declaredCap: number): number;
23
23
  */
24
24
  declare function attemptForecast(declaredCap: number): number;
25
25
  /**
26
- * One attempt of a child: its declared cap, whether it has closed, and the counted tokens it reported, if any. No
27
- * caller passes `spent` yet: the CLI and the Hub count forecasts until reported usage feeds the rule (DRI-246).
26
+ * One attempt of a child: its declared cap, whether it has closed, and the counted tokens (cache reads excluded) its
27
+ * Runner reported, if any. An older Runner never reports, so its attempts count their forecast.
28
28
  */
29
29
  type BudgetAttempt = {
30
30
  tokenCap: number;
@@ -34,7 +34,9 @@ type BudgetAttempt = {
34
34
  /**
35
35
  * What one attempt holds against the budget: a closed attempt (finished, failed, cancelled) what it reported, else its
36
36
  * forecast; a running or queued one the larger of its forecast and what it reported, so a resumed attempt never counts
37
- * the same tokens twice and an overrun counts once reported.
37
+ * the same tokens twice and an overrun counts once reported. Never more than its own positive declared cap: a Run
38
+ * reports a little past its cap before it is stopped, and the rule must stay looser than the cap sum it replaces, so
39
+ * the Hub never refuses a start the declared-cap rule accepted.
38
40
  */
39
41
  declare function attemptCost(attempt: BudgetAttempt): number;
40
42
  /**
@@ -91,6 +93,602 @@ declare const calibrationSchema: z.ZodRecord<z.ZodString, z.ZodObject<{
91
93
  /** A class's forecast: its measured figure when `calibration` has one, else the constant. */
92
94
  declare function forecastOfClass(sizeClass: SizeClass, calibration: ClassCalibration | undefined): number;
93
95
 
96
+ declare const deliveryEvidenceKindSchema: z.ZodEnum<{
97
+ released: "released";
98
+ pr_opened: "pr_opened";
99
+ merged: "merged";
100
+ staging: "staging";
101
+ qa_started: "qa_started";
102
+ qa_passed: "qa_passed";
103
+ }>;
104
+ declare const deliveryStageSchema: z.ZodObject<{
105
+ id: z.ZodString;
106
+ name: z.ZodString;
107
+ category: z.ZodEnum<{
108
+ completed: "completed";
109
+ backlog: "backlog";
110
+ unstarted: "unstarted";
111
+ started: "started";
112
+ canceled: "canceled";
113
+ }>;
114
+ behavior: z.ZodDefault<z.ZodEnum<{
115
+ released: "released";
116
+ pr_opened: "pr_opened";
117
+ merged: "merged";
118
+ staging: "staging";
119
+ qa_started: "qa_started";
120
+ qa_passed: "qa_passed";
121
+ manual: "manual";
122
+ agent_start: "agent_start";
123
+ }>>;
124
+ }, z.core.$strict>;
125
+ declare const deliveryTransitionSchema: z.ZodObject<{
126
+ from: z.ZodString;
127
+ to: z.ZodString;
128
+ requires: z.ZodDefault<z.ZodArray<z.ZodEnum<{
129
+ released: "released";
130
+ pr_opened: "pr_opened";
131
+ merged: "merged";
132
+ staging: "staging";
133
+ qa_started: "qa_started";
134
+ qa_passed: "qa_passed";
135
+ }>>>;
136
+ }, z.core.$strict>;
137
+ declare const deliveryWorkflowSchema: z.ZodObject<{
138
+ revision: z.ZodNumber;
139
+ stages: z.ZodArray<z.ZodObject<{
140
+ id: z.ZodString;
141
+ name: z.ZodString;
142
+ category: z.ZodEnum<{
143
+ completed: "completed";
144
+ backlog: "backlog";
145
+ unstarted: "unstarted";
146
+ started: "started";
147
+ canceled: "canceled";
148
+ }>;
149
+ behavior: z.ZodDefault<z.ZodEnum<{
150
+ released: "released";
151
+ pr_opened: "pr_opened";
152
+ merged: "merged";
153
+ staging: "staging";
154
+ qa_started: "qa_started";
155
+ qa_passed: "qa_passed";
156
+ manual: "manual";
157
+ agent_start: "agent_start";
158
+ }>>;
159
+ }, z.core.$strict>>;
160
+ transitions: z.ZodArray<z.ZodObject<{
161
+ from: z.ZodString;
162
+ to: z.ZodString;
163
+ requires: z.ZodDefault<z.ZodArray<z.ZodEnum<{
164
+ released: "released";
165
+ pr_opened: "pr_opened";
166
+ merged: "merged";
167
+ staging: "staging";
168
+ qa_started: "qa_started";
169
+ qa_passed: "qa_passed";
170
+ }>>>;
171
+ }, z.core.$strict>>;
172
+ attentionColumn: z.ZodDefault<z.ZodBoolean>;
173
+ }, z.core.$strict>;
174
+ type DeliveryWorkflow = z.infer<typeof deliveryWorkflowSchema>;
175
+ type DeliveryStage = z.infer<typeof deliveryStageSchema>;
176
+ type DeliveryEvidenceKind = z.infer<typeof deliveryEvidenceKindSchema>;
177
+ declare function defaultDeliveryWorkflow(): DeliveryWorkflow;
178
+ declare const trackerSourceSchema: z.ZodObject<{
179
+ workspace: z.ZodString;
180
+ id: z.ZodString;
181
+ identifier: z.ZodString;
182
+ url: z.ZodString;
183
+ }, z.core.$strict>;
184
+ declare const trackerPlanSchema: z.ZodObject<{
185
+ id: z.ZodString;
186
+ name: z.ZodString;
187
+ description: z.ZodDefault<z.ZodString>;
188
+ source: z.ZodOptional<z.ZodObject<{
189
+ workspace: z.ZodString;
190
+ id: z.ZodString;
191
+ identifier: z.ZodString;
192
+ url: z.ZodString;
193
+ }, z.core.$strict>>;
194
+ }, z.core.$strict>;
195
+ declare const trackerCommentSchema: z.ZodObject<{
196
+ id: z.ZodString;
197
+ body: z.ZodString;
198
+ author: z.ZodString;
199
+ createdAt: z.ZodNumber;
200
+ sourceId: z.ZodOptional<z.ZodString>;
201
+ }, z.core.$strict>;
202
+ declare const trackerEvidenceSchema: z.ZodObject<{
203
+ id: z.ZodString;
204
+ kind: z.ZodEnum<{
205
+ released: "released";
206
+ pr_opened: "pr_opened";
207
+ merged: "merged";
208
+ staging: "staging";
209
+ qa_started: "qa_started";
210
+ qa_passed: "qa_passed";
211
+ }>;
212
+ revision: z.ZodString;
213
+ reference: z.ZodString;
214
+ deploymentId: z.ZodOptional<z.ZodString>;
215
+ runId: z.ZodOptional<z.ZodString>;
216
+ createdAt: z.ZodNumber;
217
+ author: z.ZodString;
218
+ }, z.core.$strict>;
219
+ declare const trackerIssueSchema: z.ZodObject<{
220
+ id: z.ZodString;
221
+ identifier: z.ZodString;
222
+ title: z.ZodString;
223
+ description: z.ZodString;
224
+ stageId: z.ZodString;
225
+ planId: z.ZodNullable<z.ZodString>;
226
+ parentId: z.ZodNullable<z.ZodString>;
227
+ assignee: z.ZodNullable<z.ZodString>;
228
+ priority: z.ZodNumber;
229
+ labels: z.ZodArray<z.ZodString>;
230
+ blockedBy: z.ZodArray<z.ZodString>;
231
+ externalBlockers: z.ZodArray<z.ZodString>;
232
+ agentEligible: z.ZodBoolean;
233
+ automationHeld: z.ZodBoolean;
234
+ revision: z.ZodNullable<z.ZodString>;
235
+ attention: z.ZodNullable<z.ZodObject<{
236
+ id: z.ZodString;
237
+ message: z.ZodString;
238
+ runId: z.ZodOptional<z.ZodString>;
239
+ origin: z.ZodDefault<z.ZodEnum<{
240
+ manual: "manual";
241
+ run: "run";
242
+ }>>;
243
+ }, z.core.$strict>>;
244
+ threadId: z.ZodString;
245
+ runIds: z.ZodArray<z.ZodString>;
246
+ comments: z.ZodArray<z.ZodObject<{
247
+ id: z.ZodString;
248
+ body: z.ZodString;
249
+ author: z.ZodString;
250
+ createdAt: z.ZodNumber;
251
+ sourceId: z.ZodOptional<z.ZodString>;
252
+ }, z.core.$strict>>;
253
+ evidence: z.ZodArray<z.ZodObject<{
254
+ id: z.ZodString;
255
+ kind: z.ZodEnum<{
256
+ released: "released";
257
+ pr_opened: "pr_opened";
258
+ merged: "merged";
259
+ staging: "staging";
260
+ qa_started: "qa_started";
261
+ qa_passed: "qa_passed";
262
+ }>;
263
+ revision: z.ZodString;
264
+ reference: z.ZodString;
265
+ deploymentId: z.ZodOptional<z.ZodString>;
266
+ runId: z.ZodOptional<z.ZodString>;
267
+ createdAt: z.ZodNumber;
268
+ author: z.ZodString;
269
+ }, z.core.$strict>>;
270
+ history: z.ZodArray<z.ZodObject<{
271
+ at: z.ZodNumber;
272
+ actor: z.ZodString;
273
+ action: z.ZodString;
274
+ from: z.ZodOptional<z.ZodString>;
275
+ to: z.ZodOptional<z.ZodString>;
276
+ }, z.core.$strict>>;
277
+ source: z.ZodOptional<z.ZodObject<{
278
+ workspace: z.ZodString;
279
+ id: z.ZodString;
280
+ identifier: z.ZodString;
281
+ url: z.ZodString;
282
+ }, z.core.$strict>>;
283
+ sourceAssignee: z.ZodOptional<z.ZodString>;
284
+ createdAt: z.ZodNumber;
285
+ updatedAt: z.ZodNumber;
286
+ version: z.ZodNumber;
287
+ }, z.core.$strict>;
288
+ type TrackerIssue = z.infer<typeof trackerIssueSchema>;
289
+ type TrackerPlan = z.infer<typeof trackerPlanSchema>;
290
+ declare const trackerSnapshotSchema: z.ZodObject<{
291
+ workflow: z.ZodObject<{
292
+ revision: z.ZodNumber;
293
+ stages: z.ZodArray<z.ZodObject<{
294
+ id: z.ZodString;
295
+ name: z.ZodString;
296
+ category: z.ZodEnum<{
297
+ completed: "completed";
298
+ backlog: "backlog";
299
+ unstarted: "unstarted";
300
+ started: "started";
301
+ canceled: "canceled";
302
+ }>;
303
+ behavior: z.ZodDefault<z.ZodEnum<{
304
+ released: "released";
305
+ pr_opened: "pr_opened";
306
+ merged: "merged";
307
+ staging: "staging";
308
+ qa_started: "qa_started";
309
+ qa_passed: "qa_passed";
310
+ manual: "manual";
311
+ agent_start: "agent_start";
312
+ }>>;
313
+ }, z.core.$strict>>;
314
+ transitions: z.ZodArray<z.ZodObject<{
315
+ from: z.ZodString;
316
+ to: z.ZodString;
317
+ requires: z.ZodDefault<z.ZodArray<z.ZodEnum<{
318
+ released: "released";
319
+ pr_opened: "pr_opened";
320
+ merged: "merged";
321
+ staging: "staging";
322
+ qa_started: "qa_started";
323
+ qa_passed: "qa_passed";
324
+ }>>>;
325
+ }, z.core.$strict>>;
326
+ attentionColumn: z.ZodDefault<z.ZodBoolean>;
327
+ }, z.core.$strict>;
328
+ issues: z.ZodArray<z.ZodObject<{
329
+ id: z.ZodString;
330
+ identifier: z.ZodString;
331
+ title: z.ZodString;
332
+ description: z.ZodString;
333
+ stageId: z.ZodString;
334
+ planId: z.ZodNullable<z.ZodString>;
335
+ parentId: z.ZodNullable<z.ZodString>;
336
+ assignee: z.ZodNullable<z.ZodString>;
337
+ priority: z.ZodNumber;
338
+ labels: z.ZodArray<z.ZodString>;
339
+ blockedBy: z.ZodArray<z.ZodString>;
340
+ externalBlockers: z.ZodArray<z.ZodString>;
341
+ agentEligible: z.ZodBoolean;
342
+ automationHeld: z.ZodBoolean;
343
+ revision: z.ZodNullable<z.ZodString>;
344
+ attention: z.ZodNullable<z.ZodObject<{
345
+ id: z.ZodString;
346
+ message: z.ZodString;
347
+ runId: z.ZodOptional<z.ZodString>;
348
+ origin: z.ZodDefault<z.ZodEnum<{
349
+ manual: "manual";
350
+ run: "run";
351
+ }>>;
352
+ }, z.core.$strict>>;
353
+ threadId: z.ZodString;
354
+ runIds: z.ZodArray<z.ZodString>;
355
+ comments: z.ZodArray<z.ZodObject<{
356
+ id: z.ZodString;
357
+ body: z.ZodString;
358
+ author: z.ZodString;
359
+ createdAt: z.ZodNumber;
360
+ sourceId: z.ZodOptional<z.ZodString>;
361
+ }, z.core.$strict>>;
362
+ evidence: z.ZodArray<z.ZodObject<{
363
+ id: z.ZodString;
364
+ kind: z.ZodEnum<{
365
+ released: "released";
366
+ pr_opened: "pr_opened";
367
+ merged: "merged";
368
+ staging: "staging";
369
+ qa_started: "qa_started";
370
+ qa_passed: "qa_passed";
371
+ }>;
372
+ revision: z.ZodString;
373
+ reference: z.ZodString;
374
+ deploymentId: z.ZodOptional<z.ZodString>;
375
+ runId: z.ZodOptional<z.ZodString>;
376
+ createdAt: z.ZodNumber;
377
+ author: z.ZodString;
378
+ }, z.core.$strict>>;
379
+ history: z.ZodArray<z.ZodObject<{
380
+ at: z.ZodNumber;
381
+ actor: z.ZodString;
382
+ action: z.ZodString;
383
+ from: z.ZodOptional<z.ZodString>;
384
+ to: z.ZodOptional<z.ZodString>;
385
+ }, z.core.$strict>>;
386
+ source: z.ZodOptional<z.ZodObject<{
387
+ workspace: z.ZodString;
388
+ id: z.ZodString;
389
+ identifier: z.ZodString;
390
+ url: z.ZodString;
391
+ }, z.core.$strict>>;
392
+ sourceAssignee: z.ZodOptional<z.ZodString>;
393
+ createdAt: z.ZodNumber;
394
+ updatedAt: z.ZodNumber;
395
+ version: z.ZodNumber;
396
+ }, z.core.$strict>>;
397
+ plans: z.ZodArray<z.ZodObject<{
398
+ id: z.ZodString;
399
+ name: z.ZodString;
400
+ description: z.ZodDefault<z.ZodString>;
401
+ source: z.ZodOptional<z.ZodObject<{
402
+ workspace: z.ZodString;
403
+ id: z.ZodString;
404
+ identifier: z.ZodString;
405
+ url: z.ZodString;
406
+ }, z.core.$strict>>;
407
+ }, z.core.$strict>>;
408
+ members: z.ZodArray<z.ZodString>;
409
+ }, z.core.$strict>;
410
+ type TrackerSnapshot = z.infer<typeof trackerSnapshotSchema>;
411
+ declare const trackerImportSchema: z.ZodObject<{
412
+ workspace: z.ZodString;
413
+ teamId: z.ZodString;
414
+ stages: z.ZodArray<z.ZodObject<{
415
+ id: z.ZodString;
416
+ name: z.ZodString;
417
+ category: z.ZodEnum<{
418
+ completed: "completed";
419
+ backlog: "backlog";
420
+ unstarted: "unstarted";
421
+ started: "started";
422
+ canceled: "canceled";
423
+ }>;
424
+ behavior: z.ZodDefault<z.ZodEnum<{
425
+ released: "released";
426
+ pr_opened: "pr_opened";
427
+ merged: "merged";
428
+ staging: "staging";
429
+ qa_started: "qa_started";
430
+ qa_passed: "qa_passed";
431
+ manual: "manual";
432
+ agent_start: "agent_start";
433
+ }>>;
434
+ }, z.core.$strict>>;
435
+ stageMapping: z.ZodRecord<z.ZodString, z.ZodString>;
436
+ adoptWorkflow: z.ZodBoolean;
437
+ plans: z.ZodArray<z.ZodObject<{
438
+ source: z.ZodObject<{
439
+ workspace: z.ZodString;
440
+ id: z.ZodString;
441
+ identifier: z.ZodString;
442
+ url: z.ZodString;
443
+ }, z.core.$strict>;
444
+ name: z.ZodString;
445
+ description: z.ZodString;
446
+ }, z.core.$strict>>;
447
+ issues: z.ZodArray<z.ZodObject<{
448
+ source: z.ZodObject<{
449
+ workspace: z.ZodString;
450
+ id: z.ZodString;
451
+ identifier: z.ZodString;
452
+ url: z.ZodString;
453
+ }, z.core.$strict>;
454
+ title: z.ZodString;
455
+ description: z.ZodString;
456
+ stageId: z.ZodString;
457
+ planId: z.ZodNullable<z.ZodString>;
458
+ parentId: z.ZodNullable<z.ZodString>;
459
+ assignee: z.ZodNullable<z.ZodString>;
460
+ sourceAssignee: z.ZodOptional<z.ZodString>;
461
+ priority: z.ZodDefault<z.ZodNumber>;
462
+ labels: z.ZodDefault<z.ZodArray<z.ZodString>>;
463
+ blockedBy: z.ZodArray<z.ZodString>;
464
+ externalBlockers: z.ZodDefault<z.ZodArray<z.ZodString>>;
465
+ comments: z.ZodArray<z.ZodObject<{
466
+ id: z.ZodString;
467
+ body: z.ZodString;
468
+ author: z.ZodString;
469
+ createdAt: z.ZodNumber;
470
+ sourceId: z.ZodOptional<z.ZodString>;
471
+ }, z.core.$strict>>;
472
+ createdAt: z.ZodNumber;
473
+ }, z.core.$strict>>;
474
+ omissions: z.ZodDefault<z.ZodArray<z.ZodString>>;
475
+ }, z.core.$strict>;
476
+ type TrackerImport = z.infer<typeof trackerImportSchema>;
477
+ declare const trackerOperationSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
478
+ kind: z.ZodLiteral<"tracker.sync">;
479
+ }, z.core.$strict>, z.ZodObject<{
480
+ title: z.ZodString;
481
+ description: z.ZodDefault<z.ZodString>;
482
+ planId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
483
+ parentId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
484
+ assignee: z.ZodDefault<z.ZodNullable<z.ZodString>>;
485
+ priority: z.ZodDefault<z.ZodNumber>;
486
+ labels: z.ZodDefault<z.ZodArray<z.ZodString>>;
487
+ blockedBy: z.ZodDefault<z.ZodArray<z.ZodString>>;
488
+ externalBlockers: z.ZodDefault<z.ZodArray<z.ZodString>>;
489
+ agentEligible: z.ZodDefault<z.ZodBoolean>;
490
+ revision: z.ZodDefault<z.ZodNullable<z.ZodString>>;
491
+ kind: z.ZodLiteral<"issue.create">;
492
+ id: z.ZodString;
493
+ stageId: z.ZodOptional<z.ZodString>;
494
+ }, z.core.$strict>, z.ZodObject<{
495
+ kind: z.ZodLiteral<"issue.update">;
496
+ id: z.ZodString;
497
+ version: z.ZodNumber;
498
+ changes: z.ZodObject<{
499
+ revision: z.ZodOptional<z.ZodNullable<z.ZodString>>;
500
+ description: z.ZodOptional<z.ZodString>;
501
+ title: z.ZodOptional<z.ZodString>;
502
+ planId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
503
+ parentId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
504
+ assignee: z.ZodOptional<z.ZodNullable<z.ZodString>>;
505
+ priority: z.ZodOptional<z.ZodNumber>;
506
+ labels: z.ZodOptional<z.ZodArray<z.ZodString>>;
507
+ blockedBy: z.ZodOptional<z.ZodArray<z.ZodString>>;
508
+ externalBlockers: z.ZodOptional<z.ZodArray<z.ZodString>>;
509
+ agentEligible: z.ZodOptional<z.ZodBoolean>;
510
+ }, z.core.$strict>;
511
+ }, z.core.$strict>, z.ZodObject<{
512
+ id: z.ZodString;
513
+ name: z.ZodString;
514
+ description: z.ZodDefault<z.ZodString>;
515
+ source: z.ZodOptional<z.ZodObject<{
516
+ workspace: z.ZodString;
517
+ id: z.ZodString;
518
+ identifier: z.ZodString;
519
+ url: z.ZodString;
520
+ }, z.core.$strict>>;
521
+ kind: z.ZodLiteral<"plan.save">;
522
+ }, z.core.$strict>, z.ZodObject<{
523
+ kind: z.ZodLiteral<"workflow.save">;
524
+ workflow: z.ZodObject<{
525
+ revision: z.ZodNumber;
526
+ stages: z.ZodArray<z.ZodObject<{
527
+ id: z.ZodString;
528
+ name: z.ZodString;
529
+ category: z.ZodEnum<{
530
+ completed: "completed";
531
+ backlog: "backlog";
532
+ unstarted: "unstarted";
533
+ started: "started";
534
+ canceled: "canceled";
535
+ }>;
536
+ behavior: z.ZodDefault<z.ZodEnum<{
537
+ released: "released";
538
+ pr_opened: "pr_opened";
539
+ merged: "merged";
540
+ staging: "staging";
541
+ qa_started: "qa_started";
542
+ qa_passed: "qa_passed";
543
+ manual: "manual";
544
+ agent_start: "agent_start";
545
+ }>>;
546
+ }, z.core.$strict>>;
547
+ transitions: z.ZodArray<z.ZodObject<{
548
+ from: z.ZodString;
549
+ to: z.ZodString;
550
+ requires: z.ZodDefault<z.ZodArray<z.ZodEnum<{
551
+ released: "released";
552
+ pr_opened: "pr_opened";
553
+ merged: "merged";
554
+ staging: "staging";
555
+ qa_started: "qa_started";
556
+ qa_passed: "qa_passed";
557
+ }>>>;
558
+ }, z.core.$strict>>;
559
+ attentionColumn: z.ZodDefault<z.ZodBoolean>;
560
+ }, z.core.$strict>;
561
+ replacements: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
562
+ }, z.core.$strict>, z.ZodObject<{
563
+ kind: z.ZodLiteral<"issue.transition">;
564
+ id: z.ZodString;
565
+ version: z.ZodNumber;
566
+ stageId: z.ZodString;
567
+ }, z.core.$strict>, z.ZodObject<{
568
+ kind: z.ZodLiteral<"issue.attention">;
569
+ id: z.ZodString;
570
+ version: z.ZodNumber;
571
+ message: z.ZodString;
572
+ runId: z.ZodOptional<z.ZodString>;
573
+ }, z.core.$strict>, z.ZodObject<{
574
+ kind: z.ZodLiteral<"issue.resolve">;
575
+ id: z.ZodString;
576
+ version: z.ZodNumber;
577
+ attentionId: z.ZodString;
578
+ }, z.core.$strict>, z.ZodObject<{
579
+ kind: z.ZodLiteral<"issue.resume">;
580
+ id: z.ZodString;
581
+ version: z.ZodNumber;
582
+ }, z.core.$strict>, z.ZodObject<{
583
+ kind: z.ZodLiteral<"issue.revision">;
584
+ id: z.ZodString;
585
+ version: z.ZodNumber;
586
+ revision: z.ZodString;
587
+ runId: z.ZodString;
588
+ }, z.core.$strict>, z.ZodObject<{
589
+ kind: z.ZodLiteral<"issue.comment">;
590
+ id: z.ZodString;
591
+ commentId: z.ZodString;
592
+ body: z.ZodString;
593
+ }, z.core.$strict>, z.ZodObject<{
594
+ kind: z.ZodLiteral<"issue.evidence">;
595
+ id: z.ZodString;
596
+ evidenceId: z.ZodString;
597
+ evidence: z.ZodObject<{
598
+ kind: z.ZodEnum<{
599
+ released: "released";
600
+ pr_opened: "pr_opened";
601
+ merged: "merged";
602
+ staging: "staging";
603
+ qa_started: "qa_started";
604
+ qa_passed: "qa_passed";
605
+ }>;
606
+ revision: z.ZodString;
607
+ runId: z.ZodOptional<z.ZodString>;
608
+ reference: z.ZodString;
609
+ deploymentId: z.ZodOptional<z.ZodString>;
610
+ }, z.core.$strict>;
611
+ }, z.core.$strict>, z.ZodObject<{
612
+ kind: z.ZodLiteral<"import.preview">;
613
+ input: z.ZodObject<{
614
+ workspace: z.ZodString;
615
+ teamId: z.ZodString;
616
+ stages: z.ZodArray<z.ZodObject<{
617
+ id: z.ZodString;
618
+ name: z.ZodString;
619
+ category: z.ZodEnum<{
620
+ completed: "completed";
621
+ backlog: "backlog";
622
+ unstarted: "unstarted";
623
+ started: "started";
624
+ canceled: "canceled";
625
+ }>;
626
+ behavior: z.ZodDefault<z.ZodEnum<{
627
+ released: "released";
628
+ pr_opened: "pr_opened";
629
+ merged: "merged";
630
+ staging: "staging";
631
+ qa_started: "qa_started";
632
+ qa_passed: "qa_passed";
633
+ manual: "manual";
634
+ agent_start: "agent_start";
635
+ }>>;
636
+ }, z.core.$strict>>;
637
+ stageMapping: z.ZodRecord<z.ZodString, z.ZodString>;
638
+ adoptWorkflow: z.ZodBoolean;
639
+ plans: z.ZodArray<z.ZodObject<{
640
+ source: z.ZodObject<{
641
+ workspace: z.ZodString;
642
+ id: z.ZodString;
643
+ identifier: z.ZodString;
644
+ url: z.ZodString;
645
+ }, z.core.$strict>;
646
+ name: z.ZodString;
647
+ description: z.ZodString;
648
+ }, z.core.$strict>>;
649
+ issues: z.ZodArray<z.ZodObject<{
650
+ source: z.ZodObject<{
651
+ workspace: z.ZodString;
652
+ id: z.ZodString;
653
+ identifier: z.ZodString;
654
+ url: z.ZodString;
655
+ }, z.core.$strict>;
656
+ title: z.ZodString;
657
+ description: z.ZodString;
658
+ stageId: z.ZodString;
659
+ planId: z.ZodNullable<z.ZodString>;
660
+ parentId: z.ZodNullable<z.ZodString>;
661
+ assignee: z.ZodNullable<z.ZodString>;
662
+ sourceAssignee: z.ZodOptional<z.ZodString>;
663
+ priority: z.ZodDefault<z.ZodNumber>;
664
+ labels: z.ZodDefault<z.ZodArray<z.ZodString>>;
665
+ blockedBy: z.ZodArray<z.ZodString>;
666
+ externalBlockers: z.ZodDefault<z.ZodArray<z.ZodString>>;
667
+ comments: z.ZodArray<z.ZodObject<{
668
+ id: z.ZodString;
669
+ body: z.ZodString;
670
+ author: z.ZodString;
671
+ createdAt: z.ZodNumber;
672
+ sourceId: z.ZodOptional<z.ZodString>;
673
+ }, z.core.$strict>>;
674
+ createdAt: z.ZodNumber;
675
+ }, z.core.$strict>>;
676
+ omissions: z.ZodDefault<z.ZodArray<z.ZodString>>;
677
+ }, z.core.$strict>;
678
+ }, z.core.$strict>, z.ZodObject<{
679
+ kind: z.ZodLiteral<"import.commit">;
680
+ previewId: z.ZodString;
681
+ }, z.core.$strict>], "kind">;
682
+ type TrackerOperation = z.input<typeof trackerOperationSchema>;
683
+ declare const trackerImportPreviewSchema: z.ZodObject<{
684
+ previewId: z.ZodString;
685
+ creates: z.ZodNumber;
686
+ skips: z.ZodNumber;
687
+ plans: z.ZodNumber;
688
+ omissions: z.ZodArray<z.ZodString>;
689
+ }, z.core.$strict>;
690
+ type TrackerImportPreview = z.infer<typeof trackerImportPreviewSchema>;
691
+
94
692
  declare const protocolVersion: {
95
693
  readonly major: 2;
96
694
  readonly minor: 3;
@@ -105,6 +703,8 @@ declare const workflowInstallCapability = "workflow_install_v1";
105
703
  * token to the agent as `DRISP_RUN_TOKEN`. A start with `delegation` is never sent to a runner without it.
106
704
  */
107
705
  declare const runDelegationCapability = "run_delegation_v1";
706
+ /** Authenticated Orchestrator guidance retains its source in prompts and history. */
707
+ declare const orchestratorGuidanceCapability = "orchestrator_guidance_v1";
108
708
  /**
109
709
  * The runner takes grants marked `reportUsage` (protocol minor 3, root ADR-0011) and, for those only, reports the
110
710
  * Run's usage: on `run.attention` and `run.finished`, and as `run.usage` while it executes. A Hub that does not know
@@ -196,6 +796,9 @@ declare const interruptionSchema: z.ZodObject<{
196
796
  waiting: "waiting";
197
797
  }>;
198
798
  message: z.ZodString;
799
+ respondent: z.ZodOptional<z.ZodEnum<{
800
+ orchestrator: "orchestrator";
801
+ }>>;
199
802
  requestId: z.ZodOptional<z.ZodString>;
200
803
  }, z.core.$strict>;
201
804
  /** The Workflow a Run resolved on its runner: the registry name and, when the Workflow declares one, its version. */
@@ -321,6 +924,9 @@ declare const controlRecordSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
321
924
  waiting: "waiting";
322
925
  }>;
323
926
  message: z.ZodString;
927
+ respondent: z.ZodOptional<z.ZodEnum<{
928
+ orchestrator: "orchestrator";
929
+ }>>;
324
930
  requestId: z.ZodOptional<z.ZodString>;
325
931
  }, z.core.$strict>;
326
932
  occupancy: z.ZodEnum<{
@@ -476,7 +1082,7 @@ declare const runSpecSchema: z.ZodObject<{
476
1082
  declare const runKeySchema: z.ZodString;
477
1083
  /** A member start's grant to start, limit and stop its own children (root ADR-0008). */
478
1084
  declare const delegationSchema: z.ZodObject<{
479
- maxChildren: z.ZodNumber;
1085
+ maxChildren: z.ZodOptional<z.ZodNumber>;
480
1086
  tokenBudget: z.ZodNumber;
481
1087
  }, z.core.$strict>;
482
1088
  /** A child's parent and declared token cap. Required on a delegated start; the Hub refuses it without `tokenCap`. */
@@ -535,7 +1141,83 @@ declare const commandSchema: z.ZodObject<{
535
1141
  }, z.core.$strict>;
536
1142
  key: z.ZodOptional<z.ZodString>;
537
1143
  delegation: z.ZodOptional<z.ZodObject<{
538
- maxChildren: z.ZodNumber;
1144
+ maxChildren: z.ZodOptional<z.ZodNumber>;
1145
+ tokenBudget: z.ZodNumber;
1146
+ }, z.core.$strict>>;
1147
+ parent: z.ZodOptional<z.ZodObject<{
1148
+ runId: z.ZodString;
1149
+ tokenCap: z.ZodOptional<z.ZodNumber>;
1150
+ }, z.core.$strict>>;
1151
+ }, z.core.$strict>, z.ZodObject<{
1152
+ kind: z.ZodLiteral<"cancel">;
1153
+ }, z.core.$strict>, z.ZodObject<{
1154
+ kind: z.ZodLiteral<"abandon">;
1155
+ }, z.core.$strict>, z.ZodObject<{
1156
+ kind: z.ZodLiteral<"steer">;
1157
+ text: z.ZodString;
1158
+ }, z.core.$strict>, z.ZodObject<{
1159
+ kind: z.ZodLiteral<"answer">;
1160
+ interruptionId: z.ZodString;
1161
+ expectedInterruptionRevision: z.ZodNumber;
1162
+ requestId: z.ZodOptional<z.ZodString>;
1163
+ answer: z.ZodJSONSchema;
1164
+ }, z.core.$strict>, z.ZodObject<{
1165
+ kind: z.ZodLiteral<"resume">;
1166
+ interruptionId: z.ZodString;
1167
+ guidance: z.ZodOptional<z.ZodString>;
1168
+ }, z.core.$strict>, z.ZodObject<{
1169
+ kind: z.ZodLiteral<"setBudget">;
1170
+ tokenBudget: z.ZodNumber;
1171
+ resume: z.ZodOptional<z.ZodBoolean>;
1172
+ }, z.core.$strict>], "kind">;
1173
+ }, z.core.$strict>;
1174
+ /** Hub-authored provenance, never accepted on a client-submitted command. */
1175
+ declare const deliveredCommandSchema: z.ZodObject<{
1176
+ commandId: z.ZodString;
1177
+ hubEpoch: z.ZodString;
1178
+ runId: z.ZodString;
1179
+ expectedRecordRevision: z.ZodOptional<z.ZodNumber>;
1180
+ intent: z.ZodDiscriminatedUnion<[z.ZodObject<{
1181
+ kind: z.ZodLiteral<"start">;
1182
+ sessionId: z.ZodString;
1183
+ runnerId: z.ZodOptional<z.ZodString>;
1184
+ computeProfileId: z.ZodOptional<z.ZodString>;
1185
+ scope: z.ZodDiscriminatedUnion<[z.ZodObject<{
1186
+ visibility: z.ZodLiteral<"organization">;
1187
+ }, z.core.$strict>, z.ZodObject<{
1188
+ visibility: z.ZodLiteral<"private">;
1189
+ ownerUserId: z.ZodString;
1190
+ }, z.core.$strict>], "visibility">;
1191
+ spec: z.ZodObject<{
1192
+ prompt: z.ZodString;
1193
+ projectDir: z.ZodString;
1194
+ harness: z.ZodEnum<{
1195
+ "claude-code": "claude-code";
1196
+ codex: "codex";
1197
+ }>;
1198
+ workflow: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
1199
+ name: z.ZodString;
1200
+ source: z.ZodOptional<z.ZodString>;
1201
+ ref: z.ZodOptional<z.ZodString>;
1202
+ version: z.ZodOptional<z.ZodString>;
1203
+ }, z.core.$strict>]>>;
1204
+ repository: z.ZodOptional<z.ZodObject<{
1205
+ ref: z.ZodString;
1206
+ commitSha: z.ZodString;
1207
+ branch: z.ZodString;
1208
+ workingDirectory: z.ZodString;
1209
+ setupCommands: z.ZodArray<z.ZodString>;
1210
+ configRevision: z.ZodNumber;
1211
+ repositoryId: z.ZodNumber;
1212
+ installationId: z.ZodNumber;
1213
+ owner: z.ZodString;
1214
+ name: z.ZodString;
1215
+ bindingId: z.ZodString;
1216
+ }, z.core.$strict>>;
1217
+ }, z.core.$strict>;
1218
+ key: z.ZodOptional<z.ZodString>;
1219
+ delegation: z.ZodOptional<z.ZodObject<{
1220
+ maxChildren: z.ZodOptional<z.ZodNumber>;
539
1221
  tokenBudget: z.ZodNumber;
540
1222
  }, z.core.$strict>>;
541
1223
  parent: z.ZodOptional<z.ZodObject<{
@@ -564,7 +1246,9 @@ declare const commandSchema: z.ZodObject<{
564
1246
  tokenBudget: z.ZodNumber;
565
1247
  resume: z.ZodOptional<z.ZodBoolean>;
566
1248
  }, z.core.$strict>], "kind">;
1249
+ orchestratorRunId: z.ZodOptional<z.ZodString>;
567
1250
  }, z.core.$strict>;
1251
+ type DeliveredCommand = z.infer<typeof deliveredCommandSchema>;
568
1252
  declare const grantSchema: z.ZodObject<{
569
1253
  commandId: z.ZodString;
570
1254
  hubEpoch: z.ZodString;
@@ -609,6 +1293,7 @@ declare const grantSchema: z.ZodObject<{
609
1293
  }, z.core.$strict>>;
610
1294
  }, z.core.$strict>;
611
1295
  continuation: z.ZodOptional<z.ZodJSONSchema>;
1296
+ orchestratorRunId: z.ZodOptional<z.ZodString>;
612
1297
  previousRun: z.ZodOptional<z.ZodObject<{
613
1298
  runId: z.ZodString;
614
1299
  executionRevision: z.ZodNumber;
@@ -758,6 +1443,9 @@ declare const runnerFrameSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
758
1443
  waiting: "waiting";
759
1444
  }>;
760
1445
  message: z.ZodString;
1446
+ respondent: z.ZodOptional<z.ZodEnum<{
1447
+ orchestrator: "orchestrator";
1448
+ }>>;
761
1449
  requestId: z.ZodOptional<z.ZodString>;
762
1450
  }, z.core.$strict>;
763
1451
  occupancy: z.ZodEnum<{
@@ -889,7 +1577,7 @@ declare const runViewSchema: z.ZodObject<{
889
1577
  tokenCap: z.ZodNumber;
890
1578
  }, z.core.$strict>>;
891
1579
  delegation: z.ZodOptional<z.ZodObject<{
892
- maxChildren: z.ZodNumber;
1580
+ maxChildren: z.ZodOptional<z.ZodNumber>;
893
1581
  tokenBudget: z.ZodNumber;
894
1582
  }, z.core.$strip>>;
895
1583
  usage: z.ZodOptional<z.ZodObject<{
@@ -927,6 +1615,9 @@ declare const runViewSchema: z.ZodObject<{
927
1615
  waiting: "waiting";
928
1616
  }>;
929
1617
  message: z.ZodString;
1618
+ respondent: z.ZodOptional<z.ZodEnum<{
1619
+ orchestrator: "orchestrator";
1620
+ }>>;
930
1621
  requestId: z.ZodOptional<z.ZodString>;
931
1622
  }, z.core.$strict>>;
932
1623
  }, z.core.$strip>>;
@@ -979,7 +1670,7 @@ declare const runViewSchema: z.ZodObject<{
979
1670
  }, z.core.$strict>;
980
1671
  key: z.ZodOptional<z.ZodString>;
981
1672
  delegation: z.ZodOptional<z.ZodObject<{
982
- maxChildren: z.ZodNumber;
1673
+ maxChildren: z.ZodOptional<z.ZodNumber>;
983
1674
  tokenBudget: z.ZodNumber;
984
1675
  }, z.core.$strict>>;
985
1676
  parent: z.ZodOptional<z.ZodObject<{
@@ -1078,7 +1769,7 @@ declare const clientFrameSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
1078
1769
  }, z.core.$strict>;
1079
1770
  key: z.ZodOptional<z.ZodString>;
1080
1771
  delegation: z.ZodOptional<z.ZodObject<{
1081
- maxChildren: z.ZodNumber;
1772
+ maxChildren: z.ZodOptional<z.ZodNumber>;
1082
1773
  tokenBudget: z.ZodNumber;
1083
1774
  }, z.core.$strict>>;
1084
1775
  parent: z.ZodOptional<z.ZodObject<{
@@ -1173,6 +1864,7 @@ declare const checkpointSchema: z.ZodObject<{
1173
1864
  }, z.core.$strict>>;
1174
1865
  }, z.core.$strict>;
1175
1866
  continuation: z.ZodOptional<z.ZodJSONSchema>;
1867
+ orchestratorRunId: z.ZodOptional<z.ZodString>;
1176
1868
  previousRun: z.ZodOptional<z.ZodObject<{
1177
1869
  runId: z.ZodString;
1178
1870
  executionRevision: z.ZodNumber;
@@ -1552,4 +2244,4 @@ type ConnectPendingResponse = z.infer<typeof connectPendingResponseSchema>;
1552
2244
  type TeamDefault = z.infer<typeof teamDefaultSchema>;
1553
2245
  type RunsGoTo = z.infer<typeof runsGoToSchema>;
1554
2246
 
1555
- export { type Audience, type BudgetAttempt, type BuildCloseReason, CALIBRATION_MIN_RUNS, CALIBRATION_WINDOW_DAYS, type Calibration, type CalibrationSample, type Checkpoint, type ClassCalibration, type Command, type ConnectAlreadyConnected, type ConnectPendingResponse, type ConnectRedeemRequest, type ConnectRedeemResponse, type ConnectStartRequest, type ConnectStartResponse, type ControlRecord, type Delegation, type ExecutionFact, type Grant, type Harness, type HarnessReadiness, type HistoryRecord, type InstalledWorkflow, type RepositoryBinding, type RepositorySource, type RunCloseReason, type RunParent, type RunUsage, type RunView, type RunnerAdoptRequest, type RunnerDisconnectPreview, type RunnerDisconnectResponse, type RunnerFrame, type RunnerList, type RunnerListEntry, type RunnerReadiness, type RunsGoTo, SIZE_CLASS_CAPS, SIZE_CLASS_FORECASTS, type Scope, type SizeClass, type TeamDefault, type WorkflowIdentity, type WorkflowInstallReference, type WorkflowReference, abandonedConversationContinuationCapability, attemptCost, attemptForecast, audienceSchema, budgetCheck, buildCloseReasonSchema, calibrate, calibrationSchema, canonicalJson, checkpointPathSchema, checkpointSchema, classOfCap, clientFrameSchema, commandSchema, connectAlreadyConnectedSchema, connectApproveRequestSchema, connectCodeAlphabet, connectCodeRequestSchema, connectCodeResponseSchema, connectCodeSchema, connectDenyRequestSchema, connectPendingResponseSchema, connectPollRequestSchema, connectRedeemRequestSchema, connectRedeemResponseSchema, connectStartRequestSchema, connectStartResponseSchema, controlRecordSchema, conversationContinuationCapability, delegationSchema, delegationTokenPrefix, forecastOfCap, forecastOfClass, grantSchema, harnessReadinessSchema, harnessSchema, historyRecordSchema, hubEpochRequestSchema, installReference, installedWorkflowsSchema, interruptionSchema, permissionAnswerSchema, protocolVersion, readableHistory, readinessFixCommand, repositoryAccessCapability, repositoryBindingSchema, repositoryRefSchema, repositorySourceSchema, repositoryWorkingDirectorySchema, runArtifactMaxBytes, runArtifactNameSchema, runCloseReasonSchema, runDelegationCapability, runKeySchema, runParentIntentSchema, runParentSchema, runSpecSchema, runUsageCapability, runUsageSchema, runViewSchema, runnerAdoptRequestSchema, runnerDisconnectPreviewSchema, runnerDisconnectRequestSchema, runnerDisconnectResponseSchema, runnerFrameSchema, runnerListEntrySchema, runnerListSchema, runnerReadinessSchema, runnerUpdateCommand, runnerUpdateRequestSchema, runsGoToSchema, sameWorkflow, scopeSchema, secretEnvironmentSchema, sequence, teamDefaultRequestSchema, teamDefaultSchema, workflowIdentitySchema, workflowInstallCapability, workflowName, workflowReferenceSchema, workflowSourceSchema };
2247
+ export { type Audience, type BudgetAttempt, type BuildCloseReason, CALIBRATION_MIN_RUNS, CALIBRATION_WINDOW_DAYS, type Calibration, type CalibrationSample, type Checkpoint, type ClassCalibration, type Command, type ConnectAlreadyConnected, type ConnectPendingResponse, type ConnectRedeemRequest, type ConnectRedeemResponse, type ConnectStartRequest, type ConnectStartResponse, type ControlRecord, type Delegation, type DeliveredCommand, type DeliveryEvidenceKind, type DeliveryStage, type DeliveryWorkflow, type ExecutionFact, type Grant, type Harness, type HarnessReadiness, type HistoryRecord, type InstalledWorkflow, type RepositoryBinding, type RepositorySource, type RunCloseReason, type RunParent, type RunUsage, type RunView, type RunnerAdoptRequest, type RunnerDisconnectPreview, type RunnerDisconnectResponse, type RunnerFrame, type RunnerList, type RunnerListEntry, type RunnerReadiness, type RunsGoTo, SIZE_CLASS_CAPS, SIZE_CLASS_FORECASTS, type Scope, type SizeClass, type TeamDefault, type TrackerImport, type TrackerImportPreview, type TrackerIssue, type TrackerOperation, type TrackerPlan, type TrackerSnapshot, type WorkflowIdentity, type WorkflowInstallReference, type WorkflowReference, abandonedConversationContinuationCapability, attemptCost, attemptForecast, audienceSchema, budgetCheck, buildCloseReasonSchema, calibrate, calibrationSchema, canonicalJson, checkpointPathSchema, checkpointSchema, classOfCap, clientFrameSchema, commandSchema, connectAlreadyConnectedSchema, connectApproveRequestSchema, connectCodeAlphabet, connectCodeRequestSchema, connectCodeResponseSchema, connectCodeSchema, connectDenyRequestSchema, connectPendingResponseSchema, connectPollRequestSchema, connectRedeemRequestSchema, connectRedeemResponseSchema, connectStartRequestSchema, connectStartResponseSchema, controlRecordSchema, conversationContinuationCapability, defaultDeliveryWorkflow, delegationSchema, delegationTokenPrefix, deliveredCommandSchema, deliveryEvidenceKindSchema, deliveryStageSchema, deliveryTransitionSchema, deliveryWorkflowSchema, forecastOfCap, forecastOfClass, grantSchema, harnessReadinessSchema, harnessSchema, historyRecordSchema, hubEpochRequestSchema, installReference, installedWorkflowsSchema, interruptionSchema, orchestratorGuidanceCapability, permissionAnswerSchema, protocolVersion, readableHistory, readinessFixCommand, repositoryAccessCapability, repositoryBindingSchema, repositoryRefSchema, repositorySourceSchema, repositoryWorkingDirectorySchema, runArtifactMaxBytes, runArtifactNameSchema, runCloseReasonSchema, runDelegationCapability, runKeySchema, runParentIntentSchema, runParentSchema, runSpecSchema, runUsageCapability, runUsageSchema, runViewSchema, runnerAdoptRequestSchema, runnerDisconnectPreviewSchema, runnerDisconnectRequestSchema, runnerDisconnectResponseSchema, runnerFrameSchema, runnerListEntrySchema, runnerListSchema, runnerReadinessSchema, runnerUpdateCommand, runnerUpdateRequestSchema, runsGoToSchema, sameWorkflow, scopeSchema, secretEnvironmentSchema, sequence, teamDefaultRequestSchema, teamDefaultSchema, trackerCommentSchema, trackerEvidenceSchema, trackerImportPreviewSchema, trackerImportSchema, trackerIssueSchema, trackerOperationSchema, trackerPlanSchema, trackerSnapshotSchema, trackerSourceSchema, workflowIdentitySchema, workflowInstallCapability, workflowName, workflowReferenceSchema, workflowSourceSchema };