@ora-ai/cli 0.10.0 → 0.12.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 (38) hide show
  1. package/README.md +47 -2
  2. package/dist/core/output.d.ts.map +1 -1
  3. package/dist/core/output.js +9 -3
  4. package/dist/core/output.js.map +1 -1
  5. package/dist/generated/operations.d.ts +1 -1
  6. package/dist/generated/operations.d.ts.map +1 -1
  7. package/dist/generated/operations.js +1904 -139
  8. package/dist/generated/operations.js.map +1 -1
  9. package/dist/generated/types.d.ts +1546 -156
  10. package/dist/generated/types.d.ts.map +1 -1
  11. package/dist/generated/types.js +1 -1
  12. package/dist/interactive/session.js +1 -1
  13. package/dist/interactive/session.js.map +1 -1
  14. package/dist/render/index.d.ts +3 -1
  15. package/dist/render/index.d.ts.map +1 -1
  16. package/dist/render/index.js +5 -1
  17. package/dist/render/index.js.map +1 -1
  18. package/dist/render/registry.d.ts +5 -0
  19. package/dist/render/registry.d.ts.map +1 -1
  20. package/dist/render/registry.js +12 -4
  21. package/dist/render/registry.js.map +1 -1
  22. package/dist/render/sanitize.d.ts +19 -0
  23. package/dist/render/sanitize.d.ts.map +1 -0
  24. package/dist/render/sanitize.js +48 -0
  25. package/dist/render/sanitize.js.map +1 -0
  26. package/dist/render/table.d.ts +10 -4
  27. package/dist/render/table.d.ts.map +1 -1
  28. package/dist/render/table.js +17 -5
  29. package/dist/render/table.js.map +1 -1
  30. package/dist/render/team-event.d.ts +9 -0
  31. package/dist/render/team-event.d.ts.map +1 -0
  32. package/dist/render/team-event.js +38 -0
  33. package/dist/render/team-event.js.map +1 -0
  34. package/dist/watch.d.ts +2 -1
  35. package/dist/watch.d.ts.map +1 -1
  36. package/dist/watch.js +10 -5
  37. package/dist/watch.js.map +1 -1
  38. package/package.json +2 -2
@@ -1,9 +1,9 @@
1
1
  // GENERATED by scripts/generate.mjs — DO NOT EDIT.
2
- // Source: openapi/ora-public.openapi.json (sha256 d4ecf4f46a6656b52ec10ed5189c677491d35672b2e88f757d20bba92ae74457)
2
+ // Source: openapi/ora-public.openapi.json (sha256 3828287c3b61e3e50d14a269d6e4ad84ce3fcf8c50cfbd4ac6a98266261fa50e)
3
3
  // Regenerate: yarn nx run ora-cli:generate
4
4
  export const SPEC = {
5
5
  "version": "1.0.0",
6
- "contentHash": "d4ecf4f46a6656b52ec10ed5189c677491d35672b2e88f757d20bba92ae74457",
6
+ "contentHash": "3828287c3b61e3e50d14a269d6e4ad84ce3fcf8c50cfbd4ac6a98266261fa50e",
7
7
  "server": "https://api.agentfront.sh",
8
8
  "bin": "ora"
9
9
  };
@@ -210,6 +210,1759 @@ export const OPERATIONS = [
210
210
  "command": "ora analytics overview"
211
211
  }
212
212
  },
213
+ {
214
+ "id": "autopilot.board.list",
215
+ "commandPath": [
216
+ "autopilot",
217
+ "board",
218
+ "list"
219
+ ],
220
+ "method": "get",
221
+ "pathTemplate": "/experiment/v1/autopilot/teams/{team}/missions/{mission}/board",
222
+ "summary": "A mission's board tasks",
223
+ "scope": "autopilot:read",
224
+ "product": "experiment",
225
+ "pathParams": [
226
+ {
227
+ "name": "team"
228
+ },
229
+ {
230
+ "name": "mission"
231
+ }
232
+ ],
233
+ "queryParams": [],
234
+ "hasBody": false,
235
+ "bodyRequired": false,
236
+ "isStream": false,
237
+ "watchable": false,
238
+ "help": {
239
+ "command": "ora autopilot board list <team> <mission>"
240
+ }
241
+ },
242
+ {
243
+ "id": "autopilot.events.list",
244
+ "commandPath": [
245
+ "autopilot",
246
+ "events",
247
+ "list"
248
+ ],
249
+ "method": "get",
250
+ "pathTemplate": "/experiment/v1/autopilot/teams/{team}/events",
251
+ "summary": "Page the durable team event log by seq (afterSeq + limit ≤ 500)",
252
+ "scope": "autopilot:read",
253
+ "product": "experiment",
254
+ "pathParams": [
255
+ {
256
+ "name": "team"
257
+ }
258
+ ],
259
+ "queryParams": [
260
+ {
261
+ "name": "missionId",
262
+ "flag": "mission-id",
263
+ "optionKey": "missionId",
264
+ "required": false,
265
+ "kind": "string"
266
+ },
267
+ {
268
+ "name": "messageId",
269
+ "flag": "message-id",
270
+ "optionKey": "messageId",
271
+ "required": false,
272
+ "kind": "string"
273
+ },
274
+ {
275
+ "name": "exportId",
276
+ "flag": "export-id",
277
+ "optionKey": "exportId",
278
+ "required": false,
279
+ "kind": "string"
280
+ },
281
+ {
282
+ "name": "afterSeq",
283
+ "flag": "after-seq",
284
+ "optionKey": "afterSeq",
285
+ "required": false,
286
+ "kind": "number"
287
+ },
288
+ {
289
+ "name": "limit",
290
+ "flag": "limit",
291
+ "optionKey": "limit",
292
+ "required": false,
293
+ "kind": "number"
294
+ },
295
+ {
296
+ "name": "kinds",
297
+ "flag": "kinds",
298
+ "optionKey": "kinds",
299
+ "required": false,
300
+ "kind": "string"
301
+ }
302
+ ],
303
+ "hasBody": false,
304
+ "bodyRequired": false,
305
+ "isStream": false,
306
+ "watchable": false,
307
+ "help": {
308
+ "command": "ora autopilot events list <team>"
309
+ }
310
+ },
311
+ {
312
+ "id": "autopilot.exports.create",
313
+ "commandPath": [
314
+ "autopilot",
315
+ "exports",
316
+ "create"
317
+ ],
318
+ "method": "post",
319
+ "pathTemplate": "/experiment/v1/autopilot/teams/{team}/exports",
320
+ "summary": "Request a research dataset export of terminal missions; completes asynchronously",
321
+ "scope": "autopilot:export:write",
322
+ "product": "experiment",
323
+ "pathParams": [
324
+ {
325
+ "name": "team"
326
+ }
327
+ ],
328
+ "queryParams": [],
329
+ "hasBody": true,
330
+ "bodyRequired": true,
331
+ "isStream": false,
332
+ "bodyFields": [
333
+ {
334
+ "name": "missionIds",
335
+ "required": false,
336
+ "kind": "array",
337
+ "placeholder": "[]"
338
+ },
339
+ {
340
+ "name": "from",
341
+ "required": false,
342
+ "kind": "string",
343
+ "placeholder": "<from>"
344
+ },
345
+ {
346
+ "name": "to",
347
+ "required": false,
348
+ "kind": "string",
349
+ "placeholder": "<to>"
350
+ },
351
+ {
352
+ "name": "clientKey",
353
+ "required": false,
354
+ "kind": "string",
355
+ "placeholder": "<clientKey>"
356
+ }
357
+ ],
358
+ "watchable": true,
359
+ "help": {
360
+ "command": "ora autopilot exports create <team> --file run.json --watch",
361
+ "body": "{\n \"missionIds\": [],\n \"from\": \"<from>\",\n \"to\": \"<to>\"\n}"
362
+ }
363
+ },
364
+ {
365
+ "id": "autopilot.exports.get",
366
+ "commandPath": [
367
+ "autopilot",
368
+ "exports",
369
+ "get"
370
+ ],
371
+ "method": "get",
372
+ "pathTemplate": "/experiment/v1/autopilot/teams/{team}/exports/{export}",
373
+ "summary": "An export's manifest, redaction report and a fresh 15-minute signed artifactUrl (never a JSONL body)",
374
+ "scope": "autopilot:export:write",
375
+ "product": "experiment",
376
+ "pathParams": [
377
+ {
378
+ "name": "team"
379
+ },
380
+ {
381
+ "name": "export"
382
+ }
383
+ ],
384
+ "queryParams": [],
385
+ "hasBody": false,
386
+ "bodyRequired": false,
387
+ "isStream": false,
388
+ "watchable": false,
389
+ "help": {
390
+ "command": "ora autopilot exports get <team> <export>"
391
+ }
392
+ },
393
+ {
394
+ "id": "autopilot.exports.list",
395
+ "commandPath": [
396
+ "autopilot",
397
+ "exports",
398
+ "list"
399
+ ],
400
+ "method": "get",
401
+ "pathTemplate": "/experiment/v1/autopilot/teams/{team}/exports",
402
+ "summary": "List a team's exports, newest first",
403
+ "scope": "autopilot:export:write",
404
+ "product": "experiment",
405
+ "pathParams": [
406
+ {
407
+ "name": "team"
408
+ }
409
+ ],
410
+ "queryParams": [
411
+ {
412
+ "name": "cursor",
413
+ "flag": "cursor",
414
+ "optionKey": "cursor",
415
+ "required": false,
416
+ "kind": "string"
417
+ },
418
+ {
419
+ "name": "limit",
420
+ "flag": "limit",
421
+ "optionKey": "limit",
422
+ "required": false,
423
+ "kind": "number"
424
+ }
425
+ ],
426
+ "hasBody": false,
427
+ "bodyRequired": false,
428
+ "isStream": false,
429
+ "watchable": false,
430
+ "help": {
431
+ "command": "ora autopilot exports list <team>"
432
+ }
433
+ },
434
+ {
435
+ "id": "autopilot.members.add",
436
+ "commandPath": [
437
+ "autopilot",
438
+ "members",
439
+ "add"
440
+ ],
441
+ "method": "post",
442
+ "pathTemplate": "/experiment/v1/autopilot/teams/{team}/members",
443
+ "summary": "Add a core member; it joins later missions, never an active lane",
444
+ "scope": "autopilot:write",
445
+ "product": "experiment",
446
+ "pathParams": [
447
+ {
448
+ "name": "team"
449
+ }
450
+ ],
451
+ "queryParams": [],
452
+ "hasBody": true,
453
+ "bodyRequired": true,
454
+ "isStream": false,
455
+ "bodyFields": [
456
+ {
457
+ "name": "handle",
458
+ "required": true,
459
+ "kind": "string",
460
+ "placeholder": "<handle>"
461
+ },
462
+ {
463
+ "name": "harness",
464
+ "required": true,
465
+ "kind": "string",
466
+ "placeholder": "<harness>"
467
+ },
468
+ {
469
+ "name": "model",
470
+ "required": false,
471
+ "kind": "string",
472
+ "placeholder": "<model>"
473
+ },
474
+ {
475
+ "name": "tier",
476
+ "required": false,
477
+ "kind": "string",
478
+ "placeholder": "core"
479
+ },
480
+ {
481
+ "name": "position",
482
+ "required": false,
483
+ "kind": "string",
484
+ "placeholder": "<position>"
485
+ }
486
+ ],
487
+ "watchable": false,
488
+ "help": {
489
+ "command": "ora autopilot members add <team> --file run.json",
490
+ "body": "{\n \"handle\": \"<handle>\",\n \"harness\": \"<harness>\"\n}"
491
+ }
492
+ },
493
+ {
494
+ "id": "autopilot.members.list",
495
+ "commandPath": [
496
+ "autopilot",
497
+ "members",
498
+ "list"
499
+ ],
500
+ "method": "get",
501
+ "pathTemplate": "/experiment/v1/autopilot/teams/{team}/members",
502
+ "summary": "List a team's members",
503
+ "scope": "autopilot:read",
504
+ "product": "experiment",
505
+ "pathParams": [
506
+ {
507
+ "name": "team"
508
+ }
509
+ ],
510
+ "queryParams": [],
511
+ "hasBody": false,
512
+ "bodyRequired": false,
513
+ "isStream": false,
514
+ "watchable": false,
515
+ "help": {
516
+ "command": "ora autopilot members list <team>"
517
+ }
518
+ },
519
+ {
520
+ "id": "autopilot.members.remove",
521
+ "commandPath": [
522
+ "autopilot",
523
+ "members",
524
+ "remove"
525
+ ],
526
+ "method": "delete",
527
+ "pathTemplate": "/experiment/v1/autopilot/teams/{team}/members/{member}",
528
+ "summary": "Remove a member: its pending recipients fail and its workspace is released",
529
+ "scope": "autopilot:write",
530
+ "product": "experiment",
531
+ "pathParams": [
532
+ {
533
+ "name": "team"
534
+ },
535
+ {
536
+ "name": "member"
537
+ }
538
+ ],
539
+ "queryParams": [],
540
+ "hasBody": false,
541
+ "bodyRequired": false,
542
+ "isStream": false,
543
+ "watchable": false,
544
+ "help": {
545
+ "command": "ora autopilot members remove <team> <member>"
546
+ }
547
+ },
548
+ {
549
+ "id": "autopilot.members.transcript",
550
+ "commandPath": [
551
+ "autopilot",
552
+ "members",
553
+ "transcript"
554
+ ],
555
+ "method": "get",
556
+ "pathTemplate": "/experiment/v1/autopilot/teams/{team}/members/{member}/transcript/stream",
557
+ "summary": "SSE: one frame per closed session-trace segment of a core member",
558
+ "scope": "autopilot:read",
559
+ "product": "experiment",
560
+ "pathParams": [
561
+ {
562
+ "name": "team"
563
+ },
564
+ {
565
+ "name": "member"
566
+ }
567
+ ],
568
+ "queryParams": [
569
+ {
570
+ "name": "after",
571
+ "flag": "after",
572
+ "optionKey": "after",
573
+ "required": false,
574
+ "kind": "number"
575
+ }
576
+ ],
577
+ "hasBody": false,
578
+ "bodyRequired": false,
579
+ "isStream": true,
580
+ "watchable": false,
581
+ "help": {
582
+ "command": "ora autopilot members transcript <team> <member>"
583
+ }
584
+ },
585
+ {
586
+ "id": "autopilot.members.update",
587
+ "commandPath": [
588
+ "autopilot",
589
+ "members",
590
+ "update"
591
+ ],
592
+ "method": "patch",
593
+ "pathTemplate": "/experiment/v1/autopilot/teams/{team}/members/{member}",
594
+ "summary": "Change a member's model or position (a position change is logged as member.position_assigned)",
595
+ "scope": "autopilot:write",
596
+ "product": "experiment",
597
+ "pathParams": [
598
+ {
599
+ "name": "team"
600
+ },
601
+ {
602
+ "name": "member"
603
+ }
604
+ ],
605
+ "queryParams": [],
606
+ "hasBody": true,
607
+ "bodyRequired": true,
608
+ "isStream": false,
609
+ "bodyFields": [
610
+ {
611
+ "name": "model",
612
+ "required": false,
613
+ "kind": "string",
614
+ "placeholder": "<model>"
615
+ },
616
+ {
617
+ "name": "position",
618
+ "required": false,
619
+ "kind": "string",
620
+ "placeholder": "<position>"
621
+ }
622
+ ],
623
+ "watchable": false,
624
+ "help": {
625
+ "command": "ora autopilot members update <team> <member> --file run.json",
626
+ "body": "{\n \"model\": \"<model>\",\n \"position\": \"<position>\"\n}"
627
+ }
628
+ },
629
+ {
630
+ "id": "autopilot.messages.send",
631
+ "commandPath": [
632
+ "autopilot",
633
+ "messages",
634
+ "send"
635
+ ],
636
+ "method": "post",
637
+ "pathTemplate": "/experiment/v1/autopilot/teams/{team}/messages",
638
+ "summary": "Message members of an active mission (interrupt: true is operator authority); never creates a mission",
639
+ "scope": "autopilot:write",
640
+ "product": "experiment",
641
+ "pathParams": [
642
+ {
643
+ "name": "team"
644
+ }
645
+ ],
646
+ "queryParams": [],
647
+ "hasBody": true,
648
+ "bodyRequired": true,
649
+ "isStream": false,
650
+ "bodyFields": [
651
+ {
652
+ "name": "to",
653
+ "required": true,
654
+ "kind": "array",
655
+ "placeholder": "[]"
656
+ },
657
+ {
658
+ "name": "text",
659
+ "required": true,
660
+ "kind": "string",
661
+ "placeholder": "<text>"
662
+ },
663
+ {
664
+ "name": "interrupt",
665
+ "required": false,
666
+ "kind": "boolean",
667
+ "placeholder": "false"
668
+ },
669
+ {
670
+ "name": "missionId",
671
+ "required": false,
672
+ "kind": "string",
673
+ "placeholder": "<missionId>"
674
+ },
675
+ {
676
+ "name": "clientKey",
677
+ "required": false,
678
+ "kind": "string",
679
+ "placeholder": "<clientKey>"
680
+ }
681
+ ],
682
+ "watchable": true,
683
+ "help": {
684
+ "command": "ora autopilot messages send <team> --file run.json --watch",
685
+ "body": "{\n \"to\": [],\n \"text\": \"<text>\"\n}"
686
+ }
687
+ },
688
+ {
689
+ "id": "autopilot.missions.create",
690
+ "commandPath": [
691
+ "autopilot",
692
+ "missions",
693
+ "create"
694
+ ],
695
+ "method": "post",
696
+ "pathTemplate": "/experiment/v1/autopilot/teams/{team}/missions",
697
+ "summary": "Send a task to the team, a squad or one member; the Scheduling axis starts, queues or adds it",
698
+ "scope": "autopilot:write",
699
+ "product": "experiment",
700
+ "pathParams": [
701
+ {
702
+ "name": "team"
703
+ }
704
+ ],
705
+ "queryParams": [],
706
+ "hasBody": true,
707
+ "bodyRequired": true,
708
+ "isStream": false,
709
+ "bodyFields": [
710
+ {
711
+ "name": "target",
712
+ "required": true,
713
+ "kind": "object",
714
+ "placeholder": "{}"
715
+ },
716
+ {
717
+ "name": "title",
718
+ "required": false,
719
+ "kind": "string",
720
+ "placeholder": "<title>"
721
+ },
722
+ {
723
+ "name": "instructions",
724
+ "required": true,
725
+ "kind": "string",
726
+ "placeholder": "<instructions>"
727
+ },
728
+ {
729
+ "name": "overrides",
730
+ "required": false,
731
+ "kind": "object",
732
+ "placeholder": "{}"
733
+ },
734
+ {
735
+ "name": "clientKey",
736
+ "required": false,
737
+ "kind": "string",
738
+ "placeholder": "<clientKey>"
739
+ }
740
+ ],
741
+ "watchable": true,
742
+ "help": {
743
+ "command": "ora autopilot missions create <team> --file run.json --watch",
744
+ "body": "{\n \"target\": {},\n \"instructions\": \"<instructions>\"\n}"
745
+ }
746
+ },
747
+ {
748
+ "id": "autopilot.missions.get",
749
+ "commandPath": [
750
+ "autopilot",
751
+ "missions",
752
+ "get"
753
+ ],
754
+ "method": "get",
755
+ "pathTemplate": "/experiment/v1/autopilot/teams/{team}/missions/{mission}",
756
+ "summary": "Get a mission: lane, frozen snapshot, counters",
757
+ "scope": "autopilot:read",
758
+ "product": "experiment",
759
+ "pathParams": [
760
+ {
761
+ "name": "team"
762
+ },
763
+ {
764
+ "name": "mission"
765
+ }
766
+ ],
767
+ "queryParams": [],
768
+ "hasBody": false,
769
+ "bodyRequired": false,
770
+ "isStream": false,
771
+ "watchable": false,
772
+ "help": {
773
+ "command": "ora autopilot missions get <team> <mission>"
774
+ }
775
+ },
776
+ {
777
+ "id": "autopilot.missions.list",
778
+ "commandPath": [
779
+ "autopilot",
780
+ "missions",
781
+ "list"
782
+ ],
783
+ "method": "get",
784
+ "pathTemplate": "/experiment/v1/autopilot/teams/{team}/missions",
785
+ "summary": "List a team's missions, newest first",
786
+ "scope": "autopilot:read",
787
+ "product": "experiment",
788
+ "pathParams": [
789
+ {
790
+ "name": "team"
791
+ }
792
+ ],
793
+ "queryParams": [
794
+ {
795
+ "name": "cursor",
796
+ "flag": "cursor",
797
+ "optionKey": "cursor",
798
+ "required": false,
799
+ "kind": "string"
800
+ },
801
+ {
802
+ "name": "limit",
803
+ "flag": "limit",
804
+ "optionKey": "limit",
805
+ "required": false,
806
+ "kind": "number"
807
+ },
808
+ {
809
+ "name": "status",
810
+ "flag": "status",
811
+ "optionKey": "status",
812
+ "required": false,
813
+ "kind": "string",
814
+ "enum": [
815
+ "queued",
816
+ "active",
817
+ "draining",
818
+ "pausing",
819
+ "paused",
820
+ "stopping",
821
+ "done",
822
+ "failed_to_converge",
823
+ "failed",
824
+ "stopped"
825
+ ]
826
+ }
827
+ ],
828
+ "hasBody": false,
829
+ "bodyRequired": false,
830
+ "isStream": false,
831
+ "watchable": false,
832
+ "help": {
833
+ "command": "ora autopilot missions list <team>"
834
+ }
835
+ },
836
+ {
837
+ "id": "autopilot.missions.pause",
838
+ "commandPath": [
839
+ "autopilot",
840
+ "missions",
841
+ "pause"
842
+ ],
843
+ "method": "post",
844
+ "pathTemplate": "/experiment/v1/autopilot/teams/{team}/missions/{mission}/pause",
845
+ "summary": "Pause a mission (mode graceful or immediate); finishes asynchronously",
846
+ "scope": "autopilot:write",
847
+ "product": "experiment",
848
+ "pathParams": [
849
+ {
850
+ "name": "team"
851
+ },
852
+ {
853
+ "name": "mission"
854
+ }
855
+ ],
856
+ "queryParams": [
857
+ {
858
+ "name": "mode",
859
+ "flag": "mode",
860
+ "optionKey": "mode",
861
+ "required": false,
862
+ "kind": "string",
863
+ "enum": [
864
+ "graceful",
865
+ "immediate"
866
+ ]
867
+ }
868
+ ],
869
+ "hasBody": false,
870
+ "bodyRequired": false,
871
+ "isStream": false,
872
+ "watchable": true,
873
+ "help": {
874
+ "command": "ora autopilot missions pause <team> <mission> --watch"
875
+ }
876
+ },
877
+ {
878
+ "id": "autopilot.missions.resume",
879
+ "commandPath": [
880
+ "autopilot",
881
+ "missions",
882
+ "resume"
883
+ ],
884
+ "method": "post",
885
+ "pathTemplate": "/experiment/v1/autopilot/teams/{team}/missions/{mission}/resume",
886
+ "summary": "Resume a paused mission (bumps its epoch)",
887
+ "scope": "autopilot:write",
888
+ "product": "experiment",
889
+ "pathParams": [
890
+ {
891
+ "name": "team"
892
+ },
893
+ {
894
+ "name": "mission"
895
+ }
896
+ ],
897
+ "queryParams": [],
898
+ "hasBody": false,
899
+ "bodyRequired": false,
900
+ "isStream": false,
901
+ "watchable": true,
902
+ "help": {
903
+ "command": "ora autopilot missions resume <team> <mission> --watch"
904
+ }
905
+ },
906
+ {
907
+ "id": "autopilot.missions.stop",
908
+ "commandPath": [
909
+ "autopilot",
910
+ "missions",
911
+ "stop"
912
+ ],
913
+ "method": "post",
914
+ "pathTemplate": "/experiment/v1/autopilot/teams/{team}/missions/{mission}/stop",
915
+ "summary": "Stop a mission (mode graceful or immediate); finishes asynchronously",
916
+ "scope": "autopilot:write",
917
+ "product": "experiment",
918
+ "pathParams": [
919
+ {
920
+ "name": "team"
921
+ },
922
+ {
923
+ "name": "mission"
924
+ }
925
+ ],
926
+ "queryParams": [
927
+ {
928
+ "name": "mode",
929
+ "flag": "mode",
930
+ "optionKey": "mode",
931
+ "required": false,
932
+ "kind": "string",
933
+ "enum": [
934
+ "graceful",
935
+ "immediate"
936
+ ]
937
+ }
938
+ ],
939
+ "hasBody": false,
940
+ "bodyRequired": false,
941
+ "isStream": false,
942
+ "watchable": true,
943
+ "help": {
944
+ "command": "ora autopilot missions stop <team> <mission> --watch"
945
+ }
946
+ },
947
+ {
948
+ "id": "autopilot.missions.update",
949
+ "commandPath": [
950
+ "autopilot",
951
+ "missions",
952
+ "update"
953
+ ],
954
+ "method": "patch",
955
+ "pathTemplate": "/experiment/v1/autopilot/teams/{team}/missions/{mission}",
956
+ "summary": "Change a live mission's budgets (a kernel-reserved budget change, logged as mission.budget_changed)",
957
+ "scope": "autopilot:write",
958
+ "product": "experiment",
959
+ "pathParams": [
960
+ {
961
+ "name": "team"
962
+ },
963
+ {
964
+ "name": "mission"
965
+ }
966
+ ],
967
+ "queryParams": [],
968
+ "hasBody": true,
969
+ "bodyRequired": true,
970
+ "isStream": false,
971
+ "bodyFields": [
972
+ {
973
+ "name": "budgets",
974
+ "required": true,
975
+ "kind": "object",
976
+ "placeholder": "{}"
977
+ }
978
+ ],
979
+ "watchable": false,
980
+ "help": {
981
+ "command": "ora autopilot missions update <team> <mission> --file run.json",
982
+ "body": "{\n \"budgets\": {}\n}"
983
+ }
984
+ },
985
+ {
986
+ "id": "autopilot.notes.get",
987
+ "commandPath": [
988
+ "autopilot",
989
+ "notes",
990
+ "get"
991
+ ],
992
+ "method": "get",
993
+ "pathTemplate": "/experiment/v1/autopilot/teams/{team}/notes/{note}",
994
+ "summary": "Get one note",
995
+ "scope": "autopilot:read",
996
+ "product": "experiment",
997
+ "pathParams": [
998
+ {
999
+ "name": "team"
1000
+ },
1001
+ {
1002
+ "name": "note"
1003
+ }
1004
+ ],
1005
+ "queryParams": [],
1006
+ "hasBody": false,
1007
+ "bodyRequired": false,
1008
+ "isStream": false,
1009
+ "watchable": false,
1010
+ "help": {
1011
+ "command": "ora autopilot notes get <team> <note>"
1012
+ }
1013
+ },
1014
+ {
1015
+ "id": "autopilot.notes.list",
1016
+ "commandPath": [
1017
+ "autopilot",
1018
+ "notes",
1019
+ "list"
1020
+ ],
1021
+ "method": "get",
1022
+ "pathTemplate": "/experiment/v1/autopilot/teams/{team}/notes",
1023
+ "summary": "The team's notes (agent-written, attributed)",
1024
+ "scope": "autopilot:read",
1025
+ "product": "experiment",
1026
+ "pathParams": [
1027
+ {
1028
+ "name": "team"
1029
+ }
1030
+ ],
1031
+ "queryParams": [
1032
+ {
1033
+ "name": "cursor",
1034
+ "flag": "cursor",
1035
+ "optionKey": "cursor",
1036
+ "required": false,
1037
+ "kind": "string"
1038
+ },
1039
+ {
1040
+ "name": "limit",
1041
+ "flag": "limit",
1042
+ "optionKey": "limit",
1043
+ "required": false,
1044
+ "kind": "number"
1045
+ },
1046
+ {
1047
+ "name": "status",
1048
+ "flag": "status",
1049
+ "optionKey": "status",
1050
+ "required": false,
1051
+ "kind": "string",
1052
+ "enum": [
1053
+ "active",
1054
+ "quarantined",
1055
+ "superseded"
1056
+ ]
1057
+ }
1058
+ ],
1059
+ "hasBody": false,
1060
+ "bodyRequired": false,
1061
+ "isStream": false,
1062
+ "watchable": false,
1063
+ "help": {
1064
+ "command": "ora autopilot notes list <team>"
1065
+ }
1066
+ },
1067
+ {
1068
+ "id": "autopilot.notes.quarantine",
1069
+ "commandPath": [
1070
+ "autopilot",
1071
+ "notes",
1072
+ "quarantine"
1073
+ ],
1074
+ "method": "post",
1075
+ "pathTemplate": "/experiment/v1/autopilot/teams/{team}/notes/{note}/quarantine",
1076
+ "summary": "Quarantine a note: it is never served to agents again",
1077
+ "scope": "autopilot:write",
1078
+ "product": "experiment",
1079
+ "pathParams": [
1080
+ {
1081
+ "name": "team"
1082
+ },
1083
+ {
1084
+ "name": "note"
1085
+ }
1086
+ ],
1087
+ "queryParams": [],
1088
+ "hasBody": false,
1089
+ "bodyRequired": false,
1090
+ "isStream": false,
1091
+ "watchable": false,
1092
+ "help": {
1093
+ "command": "ora autopilot notes quarantine <team> <note>"
1094
+ }
1095
+ },
1096
+ {
1097
+ "id": "autopilot.notes.rollback",
1098
+ "commandPath": [
1099
+ "autopilot",
1100
+ "notes",
1101
+ "rollback"
1102
+ ],
1103
+ "method": "post",
1104
+ "pathTemplate": "/experiment/v1/autopilot/teams/{team}/notes/{note}/rollback",
1105
+ "summary": "Roll a note back to the version it superseded",
1106
+ "scope": "autopilot:write",
1107
+ "product": "experiment",
1108
+ "pathParams": [
1109
+ {
1110
+ "name": "team"
1111
+ },
1112
+ {
1113
+ "name": "note"
1114
+ }
1115
+ ],
1116
+ "queryParams": [],
1117
+ "hasBody": false,
1118
+ "bodyRequired": false,
1119
+ "isStream": false,
1120
+ "watchable": false,
1121
+ "help": {
1122
+ "command": "ora autopilot notes rollback <team> <note>"
1123
+ }
1124
+ },
1125
+ {
1126
+ "id": "autopilot.presets.create",
1127
+ "commandPath": [
1128
+ "autopilot",
1129
+ "presets",
1130
+ "create"
1131
+ ],
1132
+ "method": "post",
1133
+ "pathTemplate": "/experiment/v1/autopilot/presets",
1134
+ "summary": "Save an organization preset; saving an existing name creates its next version",
1135
+ "scope": "autopilot:write",
1136
+ "product": "experiment",
1137
+ "pathParams": [],
1138
+ "queryParams": [],
1139
+ "hasBody": true,
1140
+ "bodyRequired": true,
1141
+ "isStream": false,
1142
+ "bodyFields": [
1143
+ {
1144
+ "name": "name",
1145
+ "required": true,
1146
+ "kind": "string",
1147
+ "placeholder": "<name>"
1148
+ },
1149
+ {
1150
+ "name": "body",
1151
+ "required": true,
1152
+ "kind": "object",
1153
+ "placeholder": "{}"
1154
+ }
1155
+ ],
1156
+ "watchable": false,
1157
+ "help": {
1158
+ "command": "ora autopilot presets create --file run.json",
1159
+ "body": "{\n \"name\": \"<name>\",\n \"body\": {}\n}"
1160
+ }
1161
+ },
1162
+ {
1163
+ "id": "autopilot.presets.get",
1164
+ "commandPath": [
1165
+ "autopilot",
1166
+ "presets",
1167
+ "get"
1168
+ ],
1169
+ "method": "get",
1170
+ "pathTemplate": "/experiment/v1/autopilot/presets/{preset}",
1171
+ "summary": "Get a preset by name@version",
1172
+ "scope": "autopilot:read",
1173
+ "product": "experiment",
1174
+ "pathParams": [
1175
+ {
1176
+ "name": "preset"
1177
+ }
1178
+ ],
1179
+ "queryParams": [],
1180
+ "hasBody": false,
1181
+ "bodyRequired": false,
1182
+ "isStream": false,
1183
+ "watchable": false,
1184
+ "help": {
1185
+ "command": "ora autopilot presets get <preset>"
1186
+ }
1187
+ },
1188
+ {
1189
+ "id": "autopilot.presets.list",
1190
+ "commandPath": [
1191
+ "autopilot",
1192
+ "presets",
1193
+ "list"
1194
+ ],
1195
+ "method": "get",
1196
+ "pathTemplate": "/experiment/v1/autopilot/presets",
1197
+ "summary": "List system and organization-saved presets",
1198
+ "scope": "autopilot:read",
1199
+ "product": "experiment",
1200
+ "pathParams": [],
1201
+ "queryParams": [],
1202
+ "hasBody": false,
1203
+ "bodyRequired": false,
1204
+ "isStream": false,
1205
+ "watchable": false,
1206
+ "help": {
1207
+ "command": "ora autopilot presets list"
1208
+ }
1209
+ },
1210
+ {
1211
+ "id": "autopilot.segments.get",
1212
+ "commandPath": [
1213
+ "autopilot",
1214
+ "segments",
1215
+ "get"
1216
+ ],
1217
+ "method": "get",
1218
+ "pathTemplate": "/experiment/v1/autopilot/teams/{team}/members/{member}/segments/{batch}",
1219
+ "summary": "One closed segment's stored trajectory",
1220
+ "scope": "autopilot:read",
1221
+ "product": "experiment",
1222
+ "pathParams": [
1223
+ {
1224
+ "name": "team"
1225
+ },
1226
+ {
1227
+ "name": "member"
1228
+ },
1229
+ {
1230
+ "name": "batch"
1231
+ }
1232
+ ],
1233
+ "queryParams": [],
1234
+ "hasBody": false,
1235
+ "bodyRequired": false,
1236
+ "isStream": false,
1237
+ "watchable": false,
1238
+ "help": {
1239
+ "command": "ora autopilot segments get <team> <member> <batch>"
1240
+ }
1241
+ },
1242
+ {
1243
+ "id": "autopilot.squads.create",
1244
+ "commandPath": [
1245
+ "autopilot",
1246
+ "squads",
1247
+ "create"
1248
+ ],
1249
+ "method": "post",
1250
+ "pathTemplate": "/experiment/v1/autopilot/teams/{team}/squads",
1251
+ "summary": "Create a squad (a named subset of members a mission can target)",
1252
+ "scope": "autopilot:write",
1253
+ "product": "experiment",
1254
+ "pathParams": [
1255
+ {
1256
+ "name": "team"
1257
+ }
1258
+ ],
1259
+ "queryParams": [],
1260
+ "hasBody": true,
1261
+ "bodyRequired": true,
1262
+ "isStream": false,
1263
+ "bodyFields": [
1264
+ {
1265
+ "name": "name",
1266
+ "required": true,
1267
+ "kind": "string",
1268
+ "placeholder": "<name>"
1269
+ },
1270
+ {
1271
+ "name": "members",
1272
+ "required": true,
1273
+ "kind": "array",
1274
+ "placeholder": "[]"
1275
+ }
1276
+ ],
1277
+ "watchable": false,
1278
+ "help": {
1279
+ "command": "ora autopilot squads create <team> --file run.json",
1280
+ "body": "{\n \"name\": \"<name>\",\n \"members\": []\n}"
1281
+ }
1282
+ },
1283
+ {
1284
+ "id": "autopilot.squads.delete",
1285
+ "commandPath": [
1286
+ "autopilot",
1287
+ "squads",
1288
+ "delete"
1289
+ ],
1290
+ "method": "delete",
1291
+ "pathTemplate": "/experiment/v1/autopilot/teams/{team}/squads/{squad}",
1292
+ "summary": "Delete a squad; refused while a non-terminal mission targets it",
1293
+ "scope": "autopilot:write",
1294
+ "product": "experiment",
1295
+ "pathParams": [
1296
+ {
1297
+ "name": "team"
1298
+ },
1299
+ {
1300
+ "name": "squad"
1301
+ }
1302
+ ],
1303
+ "queryParams": [],
1304
+ "hasBody": false,
1305
+ "bodyRequired": false,
1306
+ "isStream": false,
1307
+ "watchable": false,
1308
+ "help": {
1309
+ "command": "ora autopilot squads delete <team> <squad>"
1310
+ }
1311
+ },
1312
+ {
1313
+ "id": "autopilot.squads.list",
1314
+ "commandPath": [
1315
+ "autopilot",
1316
+ "squads",
1317
+ "list"
1318
+ ],
1319
+ "method": "get",
1320
+ "pathTemplate": "/experiment/v1/autopilot/teams/{team}/squads",
1321
+ "summary": "List a team's squads",
1322
+ "scope": "autopilot:read",
1323
+ "product": "experiment",
1324
+ "pathParams": [
1325
+ {
1326
+ "name": "team"
1327
+ }
1328
+ ],
1329
+ "queryParams": [],
1330
+ "hasBody": false,
1331
+ "bodyRequired": false,
1332
+ "isStream": false,
1333
+ "watchable": false,
1334
+ "help": {
1335
+ "command": "ora autopilot squads list <team>"
1336
+ }
1337
+ },
1338
+ {
1339
+ "id": "autopilot.squads.update",
1340
+ "commandPath": [
1341
+ "autopilot",
1342
+ "squads",
1343
+ "update"
1344
+ ],
1345
+ "method": "patch",
1346
+ "pathTemplate": "/experiment/v1/autopilot/teams/{team}/squads/{squad}",
1347
+ "summary": "Replace a squad's members",
1348
+ "scope": "autopilot:write",
1349
+ "product": "experiment",
1350
+ "pathParams": [
1351
+ {
1352
+ "name": "team"
1353
+ },
1354
+ {
1355
+ "name": "squad"
1356
+ }
1357
+ ],
1358
+ "queryParams": [],
1359
+ "hasBody": true,
1360
+ "bodyRequired": true,
1361
+ "isStream": false,
1362
+ "bodyFields": [
1363
+ {
1364
+ "name": "members",
1365
+ "required": true,
1366
+ "kind": "array",
1367
+ "placeholder": "[]"
1368
+ }
1369
+ ],
1370
+ "watchable": false,
1371
+ "help": {
1372
+ "command": "ora autopilot squads update <team> <squad> --file run.json",
1373
+ "body": "{\n \"members\": []\n}"
1374
+ }
1375
+ },
1376
+ {
1377
+ "id": "autopilot.strategies.list",
1378
+ "commandPath": [
1379
+ "autopilot",
1380
+ "strategies",
1381
+ "list"
1382
+ ],
1383
+ "method": "get",
1384
+ "pathTemplate": "/experiment/v1/autopilot/strategies",
1385
+ "summary": "The strategy catalog: axes → strategies → key, version, config JSON Schema, display, requires, provides",
1386
+ "scope": "autopilot:read",
1387
+ "product": "experiment",
1388
+ "pathParams": [],
1389
+ "queryParams": [],
1390
+ "hasBody": false,
1391
+ "bodyRequired": false,
1392
+ "isStream": false,
1393
+ "watchable": false,
1394
+ "help": {
1395
+ "command": "ora autopilot strategies list"
1396
+ }
1397
+ },
1398
+ {
1399
+ "id": "autopilot.teams.apply",
1400
+ "commandPath": [
1401
+ "autopilot",
1402
+ "teams",
1403
+ "apply"
1404
+ ],
1405
+ "method": "put",
1406
+ "pathTemplate": "/experiment/v1/autopilot/teams/{team}",
1407
+ "summary": "Create the team, or converge it to the file: roster diffs become member events; strategy changes apply from the next mission",
1408
+ "scope": "autopilot:write",
1409
+ "product": "experiment",
1410
+ "pathParams": [
1411
+ {
1412
+ "name": "team"
1413
+ }
1414
+ ],
1415
+ "queryParams": [],
1416
+ "hasBody": true,
1417
+ "bodyRequired": true,
1418
+ "isStream": false,
1419
+ "bodyFields": [
1420
+ {
1421
+ "name": "name",
1422
+ "required": true,
1423
+ "kind": "string",
1424
+ "placeholder": "<name>"
1425
+ },
1426
+ {
1427
+ "name": "slug",
1428
+ "required": false,
1429
+ "kind": "string",
1430
+ "placeholder": "<slug>"
1431
+ },
1432
+ {
1433
+ "name": "researchUse",
1434
+ "required": false,
1435
+ "kind": "string",
1436
+ "enum": [
1437
+ "internal_only",
1438
+ "publishable_after_review",
1439
+ "excluded"
1440
+ ],
1441
+ "placeholder": "internal_only"
1442
+ },
1443
+ {
1444
+ "name": "members",
1445
+ "required": true,
1446
+ "kind": "array",
1447
+ "placeholder": "[]"
1448
+ },
1449
+ {
1450
+ "name": "squads",
1451
+ "required": false,
1452
+ "kind": "array",
1453
+ "placeholder": "[]"
1454
+ },
1455
+ {
1456
+ "name": "positions",
1457
+ "required": false,
1458
+ "kind": "array",
1459
+ "placeholder": "[]"
1460
+ },
1461
+ {
1462
+ "name": "preset",
1463
+ "required": false,
1464
+ "kind": "string",
1465
+ "placeholder": "<preset>"
1466
+ },
1467
+ {
1468
+ "name": "axes",
1469
+ "required": false,
1470
+ "kind": "object",
1471
+ "placeholder": "{}"
1472
+ },
1473
+ {
1474
+ "name": "budgets",
1475
+ "required": false,
1476
+ "kind": "object",
1477
+ "placeholder": "{\"onTrip\":\"pause\",\"team\":{},\"mission\":{},\"member\":{}}"
1478
+ },
1479
+ {
1480
+ "name": "resources",
1481
+ "required": false,
1482
+ "kind": "object",
1483
+ "placeholder": "{\"repos\":[]}"
1484
+ },
1485
+ {
1486
+ "name": "clientKey",
1487
+ "required": false,
1488
+ "kind": "string",
1489
+ "placeholder": "<clientKey>"
1490
+ }
1491
+ ],
1492
+ "watchable": false,
1493
+ "help": {
1494
+ "command": "ora autopilot teams apply <team> --file run.json",
1495
+ "body": "{\n \"name\": \"<name>\",\n \"members\": []\n}"
1496
+ }
1497
+ },
1498
+ {
1499
+ "id": "autopilot.teams.archive",
1500
+ "commandPath": [
1501
+ "autopilot",
1502
+ "teams",
1503
+ "archive"
1504
+ ],
1505
+ "method": "post",
1506
+ "pathTemplate": "/experiment/v1/autopilot/teams/{team}/archive",
1507
+ "summary": "Archive a team and release its session slots; refused while a mission is non-terminal",
1508
+ "scope": "autopilot:write",
1509
+ "product": "experiment",
1510
+ "pathParams": [
1511
+ {
1512
+ "name": "team"
1513
+ }
1514
+ ],
1515
+ "queryParams": [],
1516
+ "hasBody": false,
1517
+ "bodyRequired": false,
1518
+ "isStream": false,
1519
+ "watchable": false,
1520
+ "help": {
1521
+ "command": "ora autopilot teams archive <team>"
1522
+ }
1523
+ },
1524
+ {
1525
+ "id": "autopilot.teams.create",
1526
+ "commandPath": [
1527
+ "autopilot",
1528
+ "teams",
1529
+ "create"
1530
+ ],
1531
+ "method": "post",
1532
+ "pathTemplate": "/experiment/v1/autopilot/teams",
1533
+ "summary": "Create a standing team from a team file (roster, squads, positions, preset, axes, budgets, resources)",
1534
+ "scope": "autopilot:write",
1535
+ "product": "experiment",
1536
+ "pathParams": [],
1537
+ "queryParams": [],
1538
+ "hasBody": true,
1539
+ "bodyRequired": true,
1540
+ "isStream": false,
1541
+ "bodyFields": [
1542
+ {
1543
+ "name": "name",
1544
+ "required": true,
1545
+ "kind": "string",
1546
+ "placeholder": "<name>"
1547
+ },
1548
+ {
1549
+ "name": "slug",
1550
+ "required": false,
1551
+ "kind": "string",
1552
+ "placeholder": "<slug>"
1553
+ },
1554
+ {
1555
+ "name": "researchUse",
1556
+ "required": false,
1557
+ "kind": "string",
1558
+ "enum": [
1559
+ "internal_only",
1560
+ "publishable_after_review",
1561
+ "excluded"
1562
+ ],
1563
+ "placeholder": "internal_only"
1564
+ },
1565
+ {
1566
+ "name": "members",
1567
+ "required": true,
1568
+ "kind": "array",
1569
+ "placeholder": "[]"
1570
+ },
1571
+ {
1572
+ "name": "squads",
1573
+ "required": false,
1574
+ "kind": "array",
1575
+ "placeholder": "[]"
1576
+ },
1577
+ {
1578
+ "name": "positions",
1579
+ "required": false,
1580
+ "kind": "array",
1581
+ "placeholder": "[]"
1582
+ },
1583
+ {
1584
+ "name": "preset",
1585
+ "required": false,
1586
+ "kind": "string",
1587
+ "placeholder": "<preset>"
1588
+ },
1589
+ {
1590
+ "name": "axes",
1591
+ "required": false,
1592
+ "kind": "object",
1593
+ "placeholder": "{}"
1594
+ },
1595
+ {
1596
+ "name": "budgets",
1597
+ "required": false,
1598
+ "kind": "object",
1599
+ "placeholder": "{\"onTrip\":\"pause\",\"team\":{},\"mission\":{},\"member\":{}}"
1600
+ },
1601
+ {
1602
+ "name": "resources",
1603
+ "required": false,
1604
+ "kind": "object",
1605
+ "placeholder": "{\"repos\":[]}"
1606
+ },
1607
+ {
1608
+ "name": "clientKey",
1609
+ "required": false,
1610
+ "kind": "string",
1611
+ "placeholder": "<clientKey>"
1612
+ }
1613
+ ],
1614
+ "watchable": false,
1615
+ "help": {
1616
+ "command": "ora autopilot teams create --file run.json",
1617
+ "body": "{\n \"name\": \"<name>\",\n \"members\": []\n}"
1618
+ }
1619
+ },
1620
+ {
1621
+ "id": "autopilot.teams.feed",
1622
+ "commandPath": [
1623
+ "autopilot",
1624
+ "teams",
1625
+ "feed"
1626
+ ],
1627
+ "method": "get",
1628
+ "pathTemplate": "/experiment/v1/autopilot/teams/stream",
1629
+ "summary": "SSE: the organization's coarse team state (status, mission counts, budget), a snapshot then live frames",
1630
+ "scope": "autopilot:read",
1631
+ "product": "experiment",
1632
+ "pathParams": [],
1633
+ "queryParams": [],
1634
+ "hasBody": false,
1635
+ "bodyRequired": false,
1636
+ "isStream": true,
1637
+ "watchable": false,
1638
+ "help": {
1639
+ "command": "ora autopilot teams feed"
1640
+ }
1641
+ },
1642
+ {
1643
+ "id": "autopilot.teams.get",
1644
+ "commandPath": [
1645
+ "autopilot",
1646
+ "teams",
1647
+ "get"
1648
+ ],
1649
+ "method": "get",
1650
+ "pathTemplate": "/experiment/v1/autopilot/teams/{team}",
1651
+ "summary": "Get a team: roster, squads, non-terminal missions, counters",
1652
+ "scope": "autopilot:read",
1653
+ "product": "experiment",
1654
+ "pathParams": [
1655
+ {
1656
+ "name": "team"
1657
+ }
1658
+ ],
1659
+ "queryParams": [],
1660
+ "hasBody": false,
1661
+ "bodyRequired": false,
1662
+ "isStream": false,
1663
+ "watchable": false,
1664
+ "help": {
1665
+ "command": "ora autopilot teams get <team>"
1666
+ }
1667
+ },
1668
+ {
1669
+ "id": "autopilot.teams.list",
1670
+ "commandPath": [
1671
+ "autopilot",
1672
+ "teams",
1673
+ "list"
1674
+ ],
1675
+ "method": "get",
1676
+ "pathTemplate": "/experiment/v1/autopilot/teams",
1677
+ "summary": "List the organization's teams with coarse state",
1678
+ "scope": "autopilot:read",
1679
+ "product": "experiment",
1680
+ "pathParams": [],
1681
+ "queryParams": [
1682
+ {
1683
+ "name": "cursor",
1684
+ "flag": "cursor",
1685
+ "optionKey": "cursor",
1686
+ "required": false,
1687
+ "kind": "string"
1688
+ },
1689
+ {
1690
+ "name": "limit",
1691
+ "flag": "limit",
1692
+ "optionKey": "limit",
1693
+ "required": false,
1694
+ "kind": "number"
1695
+ },
1696
+ {
1697
+ "name": "status",
1698
+ "flag": "status",
1699
+ "optionKey": "status",
1700
+ "required": false,
1701
+ "kind": "string",
1702
+ "enum": [
1703
+ "active",
1704
+ "pausing",
1705
+ "paused",
1706
+ "stopping",
1707
+ "stopped",
1708
+ "archived"
1709
+ ]
1710
+ }
1711
+ ],
1712
+ "hasBody": false,
1713
+ "bodyRequired": false,
1714
+ "isStream": false,
1715
+ "watchable": false,
1716
+ "help": {
1717
+ "command": "ora autopilot teams list"
1718
+ }
1719
+ },
1720
+ {
1721
+ "id": "autopilot.teams.pause",
1722
+ "commandPath": [
1723
+ "autopilot",
1724
+ "teams",
1725
+ "pause"
1726
+ ],
1727
+ "method": "post",
1728
+ "pathTemplate": "/experiment/v1/autopilot/teams/{team}/pause",
1729
+ "summary": "Pause every active mission and close admission",
1730
+ "scope": "autopilot:write",
1731
+ "product": "experiment",
1732
+ "pathParams": [
1733
+ {
1734
+ "name": "team"
1735
+ }
1736
+ ],
1737
+ "queryParams": [
1738
+ {
1739
+ "name": "mode",
1740
+ "flag": "mode",
1741
+ "optionKey": "mode",
1742
+ "required": false,
1743
+ "kind": "string",
1744
+ "enum": [
1745
+ "graceful",
1746
+ "immediate"
1747
+ ]
1748
+ }
1749
+ ],
1750
+ "hasBody": false,
1751
+ "bodyRequired": false,
1752
+ "isStream": false,
1753
+ "watchable": true,
1754
+ "help": {
1755
+ "command": "ora autopilot teams pause <team> --watch"
1756
+ }
1757
+ },
1758
+ {
1759
+ "id": "autopilot.teams.resume",
1760
+ "commandPath": [
1761
+ "autopilot",
1762
+ "teams",
1763
+ "resume"
1764
+ ],
1765
+ "method": "post",
1766
+ "pathTemplate": "/experiment/v1/autopilot/teams/{team}/resume",
1767
+ "summary": "Resume a paused team, or re-open admission on a stopped one",
1768
+ "scope": "autopilot:write",
1769
+ "product": "experiment",
1770
+ "pathParams": [
1771
+ {
1772
+ "name": "team"
1773
+ }
1774
+ ],
1775
+ "queryParams": [],
1776
+ "hasBody": false,
1777
+ "bodyRequired": false,
1778
+ "isStream": false,
1779
+ "watchable": true,
1780
+ "help": {
1781
+ "command": "ora autopilot teams resume <team> --watch"
1782
+ }
1783
+ },
1784
+ {
1785
+ "id": "autopilot.teams.stop",
1786
+ "commandPath": [
1787
+ "autopilot",
1788
+ "teams",
1789
+ "stop"
1790
+ ],
1791
+ "method": "post",
1792
+ "pathTemplate": "/experiment/v1/autopilot/teams/{team}/stop",
1793
+ "summary": "Stop every non-terminal mission",
1794
+ "scope": "autopilot:write",
1795
+ "product": "experiment",
1796
+ "pathParams": [
1797
+ {
1798
+ "name": "team"
1799
+ }
1800
+ ],
1801
+ "queryParams": [
1802
+ {
1803
+ "name": "mode",
1804
+ "flag": "mode",
1805
+ "optionKey": "mode",
1806
+ "required": false,
1807
+ "kind": "string",
1808
+ "enum": [
1809
+ "graceful",
1810
+ "immediate"
1811
+ ]
1812
+ }
1813
+ ],
1814
+ "hasBody": false,
1815
+ "bodyRequired": false,
1816
+ "isStream": false,
1817
+ "watchable": true,
1818
+ "help": {
1819
+ "command": "ora autopilot teams stop <team> --watch"
1820
+ }
1821
+ },
1822
+ {
1823
+ "id": "autopilot.teams.stream",
1824
+ "commandPath": [
1825
+ "autopilot",
1826
+ "teams",
1827
+ "stream"
1828
+ ],
1829
+ "method": "get",
1830
+ "pathTemplate": "/experiment/v1/autopilot/teams/{team}/stream",
1831
+ "summary": "SSE: replay the team log after `after` (≤ 1,000 events), then tail it live; optionally scoped to a mission, message or export",
1832
+ "scope": "autopilot:read",
1833
+ "product": "experiment",
1834
+ "pathParams": [
1835
+ {
1836
+ "name": "team"
1837
+ }
1838
+ ],
1839
+ "queryParams": [
1840
+ {
1841
+ "name": "after",
1842
+ "flag": "after",
1843
+ "optionKey": "after",
1844
+ "required": false,
1845
+ "kind": "number"
1846
+ },
1847
+ {
1848
+ "name": "missionId",
1849
+ "flag": "mission-id",
1850
+ "optionKey": "missionId",
1851
+ "required": false,
1852
+ "kind": "string"
1853
+ },
1854
+ {
1855
+ "name": "messageId",
1856
+ "flag": "message-id",
1857
+ "optionKey": "messageId",
1858
+ "required": false,
1859
+ "kind": "string"
1860
+ },
1861
+ {
1862
+ "name": "exportId",
1863
+ "flag": "export-id",
1864
+ "optionKey": "exportId",
1865
+ "required": false,
1866
+ "kind": "string"
1867
+ },
1868
+ {
1869
+ "name": "until",
1870
+ "flag": "until",
1871
+ "optionKey": "until",
1872
+ "required": false,
1873
+ "kind": "string",
1874
+ "enum": [
1875
+ "settled",
1876
+ "paused",
1877
+ "resumed",
1878
+ "stopped"
1879
+ ]
1880
+ }
1881
+ ],
1882
+ "hasBody": false,
1883
+ "bodyRequired": false,
1884
+ "isStream": true,
1885
+ "watchable": false,
1886
+ "help": {
1887
+ "command": "ora autopilot teams stream <team>"
1888
+ }
1889
+ },
1890
+ {
1891
+ "id": "autopilot.teams.update",
1892
+ "commandPath": [
1893
+ "autopilot",
1894
+ "teams",
1895
+ "update"
1896
+ ],
1897
+ "method": "patch",
1898
+ "pathTemplate": "/experiment/v1/autopilot/teams/{team}",
1899
+ "summary": "Patch a team's name, research use, positions, preset, axes, budgets or resources",
1900
+ "scope": "autopilot:write",
1901
+ "product": "experiment",
1902
+ "pathParams": [
1903
+ {
1904
+ "name": "team"
1905
+ }
1906
+ ],
1907
+ "queryParams": [],
1908
+ "hasBody": true,
1909
+ "bodyRequired": true,
1910
+ "isStream": false,
1911
+ "bodyFields": [
1912
+ {
1913
+ "name": "name",
1914
+ "required": false,
1915
+ "kind": "string",
1916
+ "placeholder": "<name>"
1917
+ },
1918
+ {
1919
+ "name": "researchUse",
1920
+ "required": false,
1921
+ "kind": "string",
1922
+ "enum": [
1923
+ "internal_only",
1924
+ "publishable_after_review",
1925
+ "excluded"
1926
+ ],
1927
+ "placeholder": "internal_only"
1928
+ },
1929
+ {
1930
+ "name": "positions",
1931
+ "required": false,
1932
+ "kind": "array",
1933
+ "placeholder": "[]"
1934
+ },
1935
+ {
1936
+ "name": "preset",
1937
+ "required": false,
1938
+ "kind": "string",
1939
+ "placeholder": "<preset>"
1940
+ },
1941
+ {
1942
+ "name": "axes",
1943
+ "required": false,
1944
+ "kind": "object",
1945
+ "placeholder": "{}"
1946
+ },
1947
+ {
1948
+ "name": "budgets",
1949
+ "required": false,
1950
+ "kind": "object",
1951
+ "placeholder": "{}"
1952
+ },
1953
+ {
1954
+ "name": "resources",
1955
+ "required": false,
1956
+ "kind": "object",
1957
+ "placeholder": "{}"
1958
+ }
1959
+ ],
1960
+ "watchable": false,
1961
+ "help": {
1962
+ "command": "ora autopilot teams update <team> --file run.json",
1963
+ "body": "{\n \"name\": \"<name>\",\n \"researchUse\": \"internal_only\",\n \"positions\": []\n}"
1964
+ }
1965
+ },
213
1966
  {
214
1967
  "id": "benchmarks.convertWebmcpSuite",
215
1968
  "commandPath": [
@@ -599,7 +2352,7 @@ export const OPERATIONS = [
599
2352
  ],
600
2353
  "method": "post",
601
2354
  "pathTemplate": "/experiment/v1/benchmarks/{id}/publish",
602
- "summary": "Publish a completed study under a shareable mode: 'public' (listed in the anonymous catalog, the default) or — where the deployment supports sharing — 'link' (unlisted, openable only with the returned share token). Idempotent slug upsert.",
2355
+ "summary": "Publish a completed study under a shareable mode: 'public' (listed in the anonymous catalog, a first publication's default) or — where the deployment supports sharing — 'link' (unlisted, openable only with the returned share token). A re-publish that names no `visibility` keeps the study's current mode (a link-shared study stays unlisted; an org-narrowed one stays shut) — state it to change the mode; send `expectPublished: true` to update a publication, so a study unpublished meanwhile is refused (409) rather than published afresh. Idempotent slug upsert. Where the product keeps review drafts, a pending draft (`executiveSummaryDraft`) whose readout is still current becomes the published summary as-is (the response's `executiveSummary`); otherwise the summary is regenerated (`executiveSummaryRequest: 'live'` until it lands).",
603
2356
  "scope": "benchmarks:write",
604
2357
  "product": "experiment",
605
2358
  "pathParams": [
@@ -629,8 +2382,15 @@ export const OPERATIONS = [
629
2382
  "link",
630
2383
  "public"
631
2384
  ],
632
- "description": "Publish under this sharing mode: 'public' (listed in the catalog) or 'link' (unlisted; openable only at /studies/<slug>?share=<token>, which the response carries). Omitted → 'public'. 'private'/'org' are 422.",
2385
+ "description": "Publish under this sharing mode: 'public' (listed in the catalog) or 'link' (unlisted; openable only at /studies/<slug>?share=<token>, which the response carries). Omitted: a first publication (never published, or unpublished since) is 'public'; a re-publish of a published study keeps the mode it is in now — a link-shared study stays unlisted, an org- or private-narrowed one stays shut (409 study_unpublished_meanwhile if it was unpublished while the re-publish ran). State it to change the mode. 'private'/'org' are 422. To UPDATE a publication without risking a first one, send expectPublished: true.",
633
2386
  "placeholder": "private"
2387
+ },
2388
+ {
2389
+ "name": "expectPublished",
2390
+ "required": false,
2391
+ "kind": "boolean",
2392
+ "description": "Precondition: the study must already be published (in any mode) — this request updates that publication. If it holds none (it was unpublished since you read it), the publish fails with 409 study_unpublished_meanwhile and NOTHING is written, instead of becoming a first publication (which lands 'public' when no visibility is stated). Omitted or false: no precondition.",
2393
+ "placeholder": "true"
634
2394
  }
635
2395
  ],
636
2396
  "watchable": false,
@@ -647,7 +2407,7 @@ export const OPERATIONS = [
647
2407
  ],
648
2408
  "method": "post",
649
2409
  "pathTemplate": "/experiment/v1/benchmarks/{id}/exec-summary",
650
- "summary": "Regenerate the executive summary from the current aggregate (async; poll get)",
2410
+ "summary": "Regenerate the executive summary from the current aggregate (async; poll get). Where the product keeps review drafts, a PUBLISHED study's lands as `executiveSummaryDraft` and its public summary does not change until a re-publish makes the draft public — `target` in the answer says where it lands",
651
2411
  "scope": "benchmarks:write",
652
2412
  "product": "experiment",
653
2413
  "pathParams": [
@@ -1336,20 +3096,10 @@ export const OPERATIONS = [
1336
3096
  "kind": "object",
1337
3097
  "placeholder": "{}"
1338
3098
  },
1339
- {
1340
- "name": "engine",
1341
- "required": false,
1342
- "kind": "string",
1343
- "placeholder": "<engine>"
1344
- },
1345
3099
  {
1346
3100
  "name": "execution_kind",
1347
3101
  "required": false,
1348
3102
  "kind": "string",
1349
- "enum": [
1350
- "harness",
1351
- "direct"
1352
- ],
1353
3103
  "placeholder": "harness"
1354
3104
  },
1355
3105
  {
@@ -1385,12 +3135,6 @@ export const OPERATIONS = [
1385
3135
  "required": false,
1386
3136
  "kind": "object",
1387
3137
  "placeholder": "{}"
1388
- },
1389
- {
1390
- "name": "wait",
1391
- "required": false,
1392
- "kind": "boolean",
1393
- "placeholder": "true"
1394
3138
  }
1395
3139
  ],
1396
3140
  "watchable": true,
@@ -1399,32 +3143,6 @@ export const OPERATIONS = [
1399
3143
  "body": "{\n \"intent\": \"check pricing for acme.com\",\n \"harness\": \"eve\",\n \"model\": \"claude-sonnet-5\"\n}"
1400
3144
  }
1401
3145
  },
1402
- {
1403
- "id": "experiment.runs.directSignals",
1404
- "commandPath": [
1405
- "experiment",
1406
- "runs",
1407
- "direct-signals"
1408
- ],
1409
- "method": "get",
1410
- "pathTemplate": "/experiment/v1/runs/{id}/direct-signals",
1411
- "summary": "Read a direct run's extracted DirectSignals artifact",
1412
- "scope": "runs:read",
1413
- "product": "platform",
1414
- "pathParams": [
1415
- {
1416
- "name": "id"
1417
- }
1418
- ],
1419
- "queryParams": [],
1420
- "hasBody": false,
1421
- "bodyRequired": false,
1422
- "isStream": false,
1423
- "watchable": false,
1424
- "help": {
1425
- "command": "ora experiment runs direct-signals <id>"
1426
- }
1427
- },
1428
3146
  {
1429
3147
  "id": "experiment.runs.feed",
1430
3148
  "commandPath": [
@@ -2121,7 +3839,8 @@ export const OPERATIONS = [
2121
3839
  "kind": "string",
2122
3840
  "enum": [
2123
3841
  "csv",
2124
- "manual"
3842
+ "manual",
3843
+ "generated"
2125
3844
  ],
2126
3845
  "placeholder": "csv"
2127
3846
  },
@@ -3133,20 +4852,10 @@ export const OPERATIONS = [
3133
4852
  "kind": "object",
3134
4853
  "placeholder": "{}"
3135
4854
  },
3136
- {
3137
- "name": "engine",
3138
- "required": false,
3139
- "kind": "string",
3140
- "placeholder": "<engine>"
3141
- },
3142
4855
  {
3143
4856
  "name": "execution_kind",
3144
4857
  "required": false,
3145
4858
  "kind": "string",
3146
- "enum": [
3147
- "harness",
3148
- "direct"
3149
- ],
3150
4859
  "placeholder": "harness"
3151
4860
  },
3152
4861
  {
@@ -3182,12 +4891,6 @@ export const OPERATIONS = [
3182
4891
  "required": false,
3183
4892
  "kind": "object",
3184
4893
  "placeholder": "{}"
3185
- },
3186
- {
3187
- "name": "wait",
3188
- "required": false,
3189
- "kind": "boolean",
3190
- "placeholder": "true"
3191
4894
  }
3192
4895
  ],
3193
4896
  "watchable": true,
@@ -3196,32 +4899,6 @@ export const OPERATIONS = [
3196
4899
  "body": "{\n \"intent\": \"check pricing for acme.com\",\n \"harness\": \"eve\",\n \"model\": \"claude-sonnet-5\"\n}"
3197
4900
  }
3198
4901
  },
3199
- {
3200
- "id": "studio.runs.directSignals",
3201
- "commandPath": [
3202
- "studio",
3203
- "runs",
3204
- "direct-signals"
3205
- ],
3206
- "method": "get",
3207
- "pathTemplate": "/studio/v1/runs/{id}/direct-signals",
3208
- "summary": "Read a direct run's extracted DirectSignals artifact",
3209
- "scope": "runs:read",
3210
- "product": "platform",
3211
- "pathParams": [
3212
- {
3213
- "name": "id"
3214
- }
3215
- ],
3216
- "queryParams": [],
3217
- "hasBody": false,
3218
- "bodyRequired": false,
3219
- "isStream": false,
3220
- "watchable": false,
3221
- "help": {
3222
- "command": "ora studio runs direct-signals <id>"
3223
- }
3224
- },
3225
4902
  {
3226
4903
  "id": "studio.runs.feed",
3227
4904
  "commandPath": [
@@ -3424,6 +5101,55 @@ export const OPERATIONS = [
3424
5101
  "command": "ora studio runs trajectory <id>"
3425
5102
  }
3426
5103
  },
5104
+ {
5105
+ "id": "study.addAgents",
5106
+ "commandPath": [
5107
+ "study",
5108
+ "add-agents"
5109
+ ],
5110
+ "method": "post",
5111
+ "pathTemplate": "/study/v1/studies/{id}/agents",
5112
+ "summary": "Add agents to a running or completed-but-unpublished study — to one group when each group runs its own, to every group when they share the matrix — and create exactly the runs they owe, in the same study. Nothing that exists is re-run or re-graded; each comparison keeps its basis and only gains agents. A completed study re-opens until the new runs finish and are graded. Idempotent: an agent already present is reported, never added twice. dryRun answers the plan.",
5113
+ "scope": "study.studies:write",
5114
+ "product": "study",
5115
+ "pathParams": [
5116
+ {
5117
+ "name": "id"
5118
+ }
5119
+ ],
5120
+ "queryParams": [],
5121
+ "hasBody": true,
5122
+ "bodyRequired": true,
5123
+ "isStream": false,
5124
+ "bodyFields": [
5125
+ {
5126
+ "name": "group",
5127
+ "required": false,
5128
+ "kind": "string",
5129
+ "description": "The group the agents join — required when each group runs its own agents, refused when every group runs the shared matrix (then each agent joins every group).",
5130
+ "placeholder": "g2"
5131
+ },
5132
+ {
5133
+ "name": "agents",
5134
+ "required": true,
5135
+ "kind": "array",
5136
+ "description": "The agents to add, in order — each a harness × model (× provider × params) cell the catalog offers. An agent the target already runs is reported in `alreadyPresent` and added once only.",
5137
+ "placeholder": "[{\"harness\":\"claude-code\",\"model\":\"claude-sonnet-5\"}]"
5138
+ },
5139
+ {
5140
+ "name": "dryRun",
5141
+ "required": false,
5142
+ "kind": "boolean",
5143
+ "description": "Answer the full plan — the agents, the jobs it would create, each comparison before and after — writing nothing (default false).",
5144
+ "placeholder": "true"
5145
+ }
5146
+ ],
5147
+ "watchable": false,
5148
+ "help": {
5149
+ "command": "ora study add-agents 1f7e4d1c-4b2a-4f3e-9d8c-5a6b7c8d9e0f --file run.json",
5150
+ "body": "{\n \"group\": \"g2\",\n \"agents\": [\n {\n \"harness\": \"claude-code\",\n \"model\": \"claude-sonnet-5\"\n }\n ],\n \"dryRun\": true\n}"
5151
+ }
5152
+ },
3427
5153
  {
3428
5154
  "id": "study.addons.list",
3429
5155
  "commandPath": [
@@ -4978,7 +6704,7 @@ export const OPERATIONS = [
4978
6704
  ],
4979
6705
  "method": "post",
4980
6706
  "pathTemplate": "/study/v1/studies/{id}/launch",
4981
- "summary": "Launch: fan out task × matrix-cell × arm runs (async — poll get until status 'completed')",
6707
+ "summary": "Launch: fan out task × matrix-cell × arm runs (async — poll get until status 'completed'). Launching a RUNNING study again creates exactly the planned runs its launch record says are missing (`launch.missing.retryable`, `relaunchable`), or takes over a fan-out that stopped — never a duplicate",
4982
6708
  "scope": "study.studies:write",
4983
6709
  "product": "study",
4984
6710
  "pathParams": [
@@ -5302,7 +7028,7 @@ export const OPERATIONS = [
5302
7028
  ],
5303
7029
  "method": "post",
5304
7030
  "pathTemplate": "/study/v1/studies/{id}/publish",
5305
- "summary": "Publish a completed study under a shareable mode: 'public' (listed in the anonymous catalog, the default) or — where the deployment supports sharing — 'link' (unlisted, openable only with the returned share token). Idempotent slug upsert.",
7031
+ "summary": "Publish a completed study under a shareable mode: 'public' (listed in the anonymous catalog, a first publication's default) or — where the deployment supports sharing — 'link' (unlisted, openable only with the returned share token). A re-publish that names no `visibility` keeps the study's current mode (a link-shared study stays unlisted; an org-narrowed one stays shut) — state it to change the mode; send `expectPublished: true` to update a publication, so a study unpublished meanwhile is refused (409) rather than published afresh. Idempotent slug upsert. Where the product keeps review drafts, a pending draft (`executiveSummaryDraft`) whose readout is still current becomes the published summary as-is (the response's `executiveSummary`); otherwise the summary is regenerated (`executiveSummaryRequest: 'live'` until it lands).",
5306
7032
  "scope": "study.studies:write",
5307
7033
  "product": "study",
5308
7034
  "pathParams": [
@@ -5332,9 +7058,16 @@ export const OPERATIONS = [
5332
7058
  "link",
5333
7059
  "public"
5334
7060
  ],
5335
- "description": "Publish under this sharing mode: 'public' (listed in the catalog) or 'link' (unlisted; openable only at /studies/<slug>?share=<token>, which the response carries). Omitted → 'public'. 'private'/'org' are 422.",
7061
+ "description": "Publish under this sharing mode: 'public' (listed in the catalog) or 'link' (unlisted; openable only at /studies/<slug>?share=<token>, which the response carries). Omitted: a first publication (never published, or unpublished since) is 'public'; a re-publish of a published study keeps the mode it is in now — a link-shared study stays unlisted, an org- or private-narrowed one stays shut (409 study_unpublished_meanwhile if it was unpublished while the re-publish ran). State it to change the mode. 'private'/'org' are 422. To UPDATE a publication without risking a first one, send expectPublished: true.",
5336
7062
  "placeholder": "private"
5337
7063
  },
7064
+ {
7065
+ "name": "expectPublished",
7066
+ "required": false,
7067
+ "kind": "boolean",
7068
+ "description": "Precondition: the study must already be published (in any mode) — this request updates that publication. If it holds none (it was unpublished since you read it), the publish fails with 409 study_unpublished_meanwhile and NOTHING is written, instead of becoming a first publication (which lands 'public' when no visibility is stated). Omitted or false: no precondition.",
7069
+ "placeholder": "true"
7070
+ },
5338
7071
  {
5339
7072
  "name": "skillNames",
5340
7073
  "required": false,
@@ -5386,7 +7119,7 @@ export const OPERATIONS = [
5386
7119
  ],
5387
7120
  "method": "post",
5388
7121
  "pathTemplate": "/study/v1/studies/{id}/exec-summary",
5389
- "summary": "Regenerate the executive summary from the current aggregate (async; poll get)",
7122
+ "summary": "Regenerate the executive summary from the current aggregate (async; poll get). Where the product keeps review drafts, a PUBLISHED study's lands as `executiveSummaryDraft` and its public summary does not change until a re-publish makes the draft public — `target` in the answer says where it lands",
5390
7123
  "scope": "study.studies:write",
5391
7124
  "product": "study",
5392
7125
  "pathParams": [
@@ -5428,6 +7161,80 @@ export const OPERATIONS = [
5428
7161
  "command": "ora study regrade <id> --watch"
5429
7162
  }
5430
7163
  },
7164
+ {
7165
+ "id": "study.rerunAttempts",
7166
+ "commandPath": [
7167
+ "study",
7168
+ "rerun-attempts"
7169
+ ],
7170
+ "method": "get",
7171
+ "pathTemplate": "/study/v1/studies/{id}/rerun-attempts",
7172
+ "summary": "The study's re-run ledger: every in-place re-dispatch of one of its jobs — the run it replaced and how that run ended, why it was re-run (with a declared re-run's evidence), the run it created and whether it dispatched. Oldest first.",
7173
+ "scope": "study.studies:read",
7174
+ "product": "study",
7175
+ "pathParams": [
7176
+ {
7177
+ "name": "id"
7178
+ }
7179
+ ],
7180
+ "queryParams": [],
7181
+ "hasBody": false,
7182
+ "bodyRequired": false,
7183
+ "isStream": false,
7184
+ "watchable": false,
7185
+ "help": {
7186
+ "command": "ora study rerun-attempts 1f7e4d1c-4b2a-4f3e-9d8c-5a6b7c8d9e0f"
7187
+ }
7188
+ },
7189
+ {
7190
+ "id": "study.rerunInfraFailures",
7191
+ "commandPath": [
7192
+ "study",
7193
+ "rerun-infra-failures"
7194
+ ],
7195
+ "method": "post",
7196
+ "pathTemplate": "/study/v1/studies/{id}/rerun-infra-failures",
7197
+ "summary": "Re-run, in place, the jobs of a running or completed-but-unpublished study whose run ora's own infrastructure killed (or that the launch never created): each new run takes its job's place, the failed run stays in the record, at most 2 re-runs per job, never while the job's run is still running. A completed study re-opens until its re-runs finish and are graded. Synchronous; dryRun answers the plan.",
7198
+ "scope": "study.studies:write",
7199
+ "product": "study",
7200
+ "pathParams": [
7201
+ {
7202
+ "name": "id"
7203
+ }
7204
+ ],
7205
+ "queryParams": [],
7206
+ "hasBody": true,
7207
+ "bodyRequired": true,
7208
+ "isStream": false,
7209
+ "bodyFields": [
7210
+ {
7211
+ "name": "dryRun",
7212
+ "required": false,
7213
+ "kind": "boolean",
7214
+ "description": "Answer what WOULD be re-run, dispatching and writing nothing (default false).",
7215
+ "placeholder": "true"
7216
+ },
7217
+ {
7218
+ "name": "limit",
7219
+ "required": false,
7220
+ "kind": "number",
7221
+ "description": "The most jobs this call dispatches (default 200, or every declared run); the rest are counted in `skipped.overLimit` for the next call.",
7222
+ "placeholder": "1"
7223
+ },
7224
+ {
7225
+ "name": "declared",
7226
+ "required": false,
7227
+ "kind": "array",
7228
+ "description": "The DECLARED re-run: exactly these runs are re-run in place (cause declared_infra), each with its evidence — runs ora's own predicate does not flag. Absent: ora's own infra failures and never-created jobs.",
7229
+ "placeholder": "[]"
7230
+ }
7231
+ ],
7232
+ "watchable": false,
7233
+ "help": {
7234
+ "command": "ora study rerun-infra-failures 1f7e4d1c-4b2a-4f3e-9d8c-5a6b7c8d9e0f --file run.json",
7235
+ "body": "{\n \"dryRun\": true\n}"
7236
+ }
7237
+ },
5431
7238
  {
5432
7239
  "id": "study.rotateShareToken",
5433
7240
  "commandPath": [
@@ -5436,7 +7243,7 @@ export const OPERATIONS = [
5436
7243
  ],
5437
7244
  "method": "post",
5438
7245
  "pathTemplate": "/study/v1/studies/{id}/share-token/rotate",
5439
- "summary": "Mint a fresh share link for a 'link' study. The previous link stops working IMMEDIATELY — there is no grace window.",
7246
+ "summary": "Replace the study's share link with a fresh one. The previous link stops working IMMEDIATELY — there is no grace window — and never works again. Works in ANY mode: a study that left 'link' keeps its link, switched off (`shareLinkKept`), and replacing it then retires a leaked link without opening it first (the new one opens only once the study is back in 'link'). This is the ONLY way a study's link changes.",
5440
7247
  "scope": "study.studies:write",
5441
7248
  "product": "study",
5442
7249
  "pathParams": [
@@ -5643,20 +7450,10 @@ export const OPERATIONS = [
5643
7450
  "kind": "object",
5644
7451
  "placeholder": "{}"
5645
7452
  },
5646
- {
5647
- "name": "engine",
5648
- "required": false,
5649
- "kind": "string",
5650
- "placeholder": "<engine>"
5651
- },
5652
7453
  {
5653
7454
  "name": "execution_kind",
5654
7455
  "required": false,
5655
7456
  "kind": "string",
5656
- "enum": [
5657
- "harness",
5658
- "direct"
5659
- ],
5660
7457
  "placeholder": "harness"
5661
7458
  },
5662
7459
  {
@@ -5692,12 +7489,6 @@ export const OPERATIONS = [
5692
7489
  "required": false,
5693
7490
  "kind": "object",
5694
7491
  "placeholder": "{}"
5695
- },
5696
- {
5697
- "name": "wait",
5698
- "required": false,
5699
- "kind": "boolean",
5700
- "placeholder": "true"
5701
7492
  }
5702
7493
  ],
5703
7494
  "watchable": true,
@@ -5706,32 +7497,6 @@ export const OPERATIONS = [
5706
7497
  "body": "{\n \"intent\": \"check pricing for acme.com\",\n \"harness\": \"eve\",\n \"model\": \"claude-sonnet-5\"\n}"
5707
7498
  }
5708
7499
  },
5709
- {
5710
- "id": "study.runs.directSignals",
5711
- "commandPath": [
5712
- "study",
5713
- "runs",
5714
- "direct-signals"
5715
- ],
5716
- "method": "get",
5717
- "pathTemplate": "/study/v1/runs/{id}/direct-signals",
5718
- "summary": "Read a direct run's extracted DirectSignals artifact",
5719
- "scope": "runs:read",
5720
- "product": "platform",
5721
- "pathParams": [
5722
- {
5723
- "name": "id"
5724
- }
5725
- ],
5726
- "queryParams": [],
5727
- "hasBody": false,
5728
- "bodyRequired": false,
5729
- "isStream": false,
5730
- "watchable": false,
5731
- "help": {
5732
- "command": "ora study runs direct-signals <id>"
5733
- }
5734
- },
5735
7500
  {
5736
7501
  "id": "study.runs.feed",
5737
7502
  "commandPath": [
@@ -5942,7 +7707,7 @@ export const OPERATIONS = [
5942
7707
  ],
5943
7708
  "method": "patch",
5944
7709
  "pathTemplate": "/study/v1/studies/{id}/visibility",
5945
- "summary": "Set who may read this study: private | org | link | public. Moving INTO 'link' mints a 256-bit share token (returned in `shareUrl`); moving out clears it immediately. The FIRST move to 'link'/'public' publishes the study; later mode changes are not re-publications and never re-stamp its publication date.",
7710
+ "summary": "Set who may read this study: private | org | link | public. Moving INTO 'link' gives the study a 256-bit share token (returned in `shareUrl`) — the one it already keeps, or a fresh one if it never had one: a study's link never changes unless it is rotated. Moving out of 'link' closes the link IMMEDIATELY but keeps it, switched off (`shareLinkKept`): it opens nothing until the study returns to 'link', and then the SAME link works again. The FIRST move to 'link'/'public' publishes the study; later mode changes are not re-publications and never re-stamp its publication date.",
5946
7711
  "scope": "study.studies:write",
5947
7712
  "product": "study",
5948
7713
  "pathParams": [
@@ -5965,7 +7730,7 @@ export const OPERATIONS = [
5965
7730
  "link",
5966
7731
  "public"
5967
7732
  ],
5968
- "description": "The sharing mode: private (creator + org owners) | org (the whole org) | link (anyone holding the share link) | public (everyone, listed in the catalog). Moving INTO 'link' mints a share token; moving out clears it.",
7733
+ "description": "The sharing mode: private (creator + org owners) | org (the whole org) | link (anyone holding the share link) | public (everyone, listed in the catalog). Moving INTO 'link' gives the study a share token — the one it keeps from before, or a fresh one if it never had one; moving out switches the link off but keeps it, so returning to 'link' brings back the SAME link (only studies.rotateShareToken replaces it).",
5969
7734
  "placeholder": "link"
5970
7735
  }
5971
7736
  ],