@ora-ai/cli 0.11.0 → 0.13.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 (200) hide show
  1. package/README.md +107 -2
  2. package/dist/agent-skills/cli-version.d.ts +2 -0
  3. package/dist/agent-skills/cli-version.d.ts.map +1 -0
  4. package/dist/agent-skills/cli-version.js +14 -0
  5. package/dist/agent-skills/cli-version.js.map +1 -0
  6. package/dist/agent-skills/install-targets.d.ts +14 -0
  7. package/dist/agent-skills/install-targets.d.ts.map +1 -0
  8. package/dist/agent-skills/install-targets.js +20 -0
  9. package/dist/agent-skills/install-targets.js.map +1 -0
  10. package/dist/agent-skills/installer.d.ts +9 -0
  11. package/dist/agent-skills/installer.d.ts.map +1 -0
  12. package/dist/agent-skills/installer.js +15 -0
  13. package/dist/agent-skills/installer.js.map +1 -0
  14. package/dist/agent-skills/skills-command.d.ts +5 -0
  15. package/dist/agent-skills/skills-command.d.ts.map +1 -0
  16. package/dist/agent-skills/skills-command.js +39 -0
  17. package/dist/agent-skills/skills-command.js.map +1 -0
  18. package/dist/agent-skills/studio-skill-source.d.ts +22 -0
  19. package/dist/agent-skills/studio-skill-source.d.ts.map +1 -0
  20. package/dist/agent-skills/studio-skill-source.js +15 -0
  21. package/dist/agent-skills/studio-skill-source.js.map +1 -0
  22. package/dist/auth-commands.d.ts.map +1 -1
  23. package/dist/auth-commands.js +3 -2
  24. package/dist/auth-commands.js.map +1 -1
  25. package/dist/coalesced-read.d.ts +12 -0
  26. package/dist/coalesced-read.d.ts.map +1 -0
  27. package/dist/coalesced-read.js +34 -0
  28. package/dist/coalesced-read.js.map +1 -0
  29. package/dist/core/error-envelope.d.ts +40 -0
  30. package/dist/core/error-envelope.d.ts.map +1 -0
  31. package/dist/core/error-envelope.js +69 -0
  32. package/dist/core/error-envelope.js.map +1 -0
  33. package/dist/core/http.d.ts +9 -2
  34. package/dist/core/http.d.ts.map +1 -1
  35. package/dist/core/http.js +19 -10
  36. package/dist/core/http.js.map +1 -1
  37. package/dist/core/output.d.ts +1 -0
  38. package/dist/core/output.d.ts.map +1 -1
  39. package/dist/core/output.js +36 -6
  40. package/dist/core/output.js.map +1 -1
  41. package/dist/core/run-operation.d.ts +4 -3
  42. package/dist/core/run-operation.d.ts.map +1 -1
  43. package/dist/core/run-operation.js +13 -10
  44. package/dist/core/run-operation.js.map +1 -1
  45. package/dist/generated/operations.d.ts +1 -1
  46. package/dist/generated/operations.d.ts.map +1 -1
  47. package/dist/generated/operations.js +2540 -272
  48. package/dist/generated/operations.js.map +1 -1
  49. package/dist/generated/types.d.ts +1911 -170
  50. package/dist/generated/types.d.ts.map +1 -1
  51. package/dist/generated/types.js +1 -1
  52. package/dist/interactive/session.js +1 -1
  53. package/dist/interactive/session.js.map +1 -1
  54. package/dist/measurement-watch.d.ts +3 -0
  55. package/dist/measurement-watch.d.ts.map +1 -0
  56. package/dist/measurement-watch.js +106 -0
  57. package/dist/measurement-watch.js.map +1 -0
  58. package/dist/program.d.ts.map +1 -1
  59. package/dist/program.js +6 -1
  60. package/dist/program.js.map +1 -1
  61. package/dist/render/analytics/analytics-view.d.ts +3 -0
  62. package/dist/render/analytics/analytics-view.d.ts.map +1 -0
  63. package/dist/render/analytics/analytics-view.js +69 -0
  64. package/dist/render/analytics/analytics-view.js.map +1 -0
  65. package/dist/render/analytics/history-view.d.ts +3 -0
  66. package/dist/render/analytics/history-view.d.ts.map +1 -0
  67. package/dist/render/analytics/history-view.js +25 -0
  68. package/dist/render/analytics/history-view.js.map +1 -0
  69. package/dist/render/analytics/recent-view.d.ts +3 -0
  70. package/dist/render/analytics/recent-view.d.ts.map +1 -0
  71. package/dist/render/analytics/recent-view.js +22 -0
  72. package/dist/render/analytics/recent-view.js.map +1 -0
  73. package/dist/render/analytics/renderers.d.ts +4 -0
  74. package/dist/render/analytics/renderers.d.ts.map +1 -0
  75. package/dist/render/analytics/renderers.js +23 -0
  76. package/dist/render/analytics/renderers.js.map +1 -0
  77. package/dist/render/analytics/types.d.ts +73 -0
  78. package/dist/render/analytics/types.d.ts.map +1 -0
  79. package/dist/render/analytics/types.js +2 -0
  80. package/dist/render/analytics/types.js.map +1 -0
  81. package/dist/render/ansi.d.ts +1 -0
  82. package/dist/render/ansi.d.ts.map +1 -1
  83. package/dist/render/ansi.js +38 -0
  84. package/dist/render/ansi.js.map +1 -1
  85. package/dist/render/goal-report-criteria.d.ts +39 -0
  86. package/dist/render/goal-report-criteria.d.ts.map +1 -0
  87. package/dist/render/goal-report-criteria.js +74 -0
  88. package/dist/render/goal-report-criteria.js.map +1 -0
  89. package/dist/render/goal-report-grid.d.ts +24 -0
  90. package/dist/render/goal-report-grid.d.ts.map +1 -0
  91. package/dist/render/goal-report-grid.js +52 -0
  92. package/dist/render/goal-report-grid.js.map +1 -0
  93. package/dist/render/goal-report.d.ts +3 -0
  94. package/dist/render/goal-report.d.ts.map +1 -0
  95. package/dist/render/goal-report.js +69 -0
  96. package/dist/render/goal-report.js.map +1 -0
  97. package/dist/render/index.d.ts +3 -1
  98. package/dist/render/index.d.ts.map +1 -1
  99. package/dist/render/index.js +15 -1
  100. package/dist/render/index.js.map +1 -1
  101. package/dist/render/insight-lines.d.ts.map +1 -1
  102. package/dist/render/insight-lines.js +7 -8
  103. package/dist/render/insight-lines.js.map +1 -1
  104. package/dist/render/insight.d.ts +1 -1
  105. package/dist/render/insight.d.ts.map +1 -1
  106. package/dist/render/insight.js +4 -2
  107. package/dist/render/insight.js.map +1 -1
  108. package/dist/render/insights/answers-view.d.ts +6 -0
  109. package/dist/render/insights/answers-view.d.ts.map +1 -0
  110. package/dist/render/insights/answers-view.js +29 -0
  111. package/dist/render/insights/answers-view.js.map +1 -0
  112. package/dist/render/insights/change-view.d.ts +3 -0
  113. package/dist/render/insights/change-view.d.ts.map +1 -0
  114. package/dist/render/insights/change-view.js +52 -0
  115. package/dist/render/insights/change-view.js.map +1 -0
  116. package/dist/render/insights/issues-view.d.ts +3 -0
  117. package/dist/render/insights/issues-view.d.ts.map +1 -0
  118. package/dist/render/insights/issues-view.js +31 -0
  119. package/dist/render/insights/issues-view.js.map +1 -0
  120. package/dist/render/insights/renderer.d.ts +3 -0
  121. package/dist/render/insights/renderer.d.ts.map +1 -0
  122. package/dist/render/insights/renderer.js +40 -0
  123. package/dist/render/insights/renderer.js.map +1 -0
  124. package/dist/render/insights/text.d.ts +3 -0
  125. package/dist/render/insights/text.d.ts.map +1 -0
  126. package/dist/render/insights/text.js +6 -0
  127. package/dist/render/insights/text.js.map +1 -0
  128. package/dist/render/insights/tools-view.d.ts +4 -0
  129. package/dist/render/insights/tools-view.d.ts.map +1 -0
  130. package/dist/render/insights/tools-view.js +51 -0
  131. package/dist/render/insights/tools-view.js.map +1 -0
  132. package/dist/render/insights/types.d.ts +124 -0
  133. package/dist/render/insights/types.d.ts.map +1 -0
  134. package/dist/render/insights/types.js +2 -0
  135. package/dist/render/insights/types.js.map +1 -0
  136. package/dist/render/insights/usage-view.d.ts +3 -0
  137. package/dist/render/insights/usage-view.d.ts.map +1 -0
  138. package/dist/render/insights/usage-view.js +18 -0
  139. package/dist/render/insights/usage-view.js.map +1 -0
  140. package/dist/render/insights/words.d.ts +4 -0
  141. package/dist/render/insights/words.d.ts.map +1 -0
  142. package/dist/render/insights/words.js +24 -0
  143. package/dist/render/insights/words.js.map +1 -0
  144. package/dist/render/links.d.ts +3 -0
  145. package/dist/render/links.d.ts.map +1 -0
  146. package/dist/render/links.js +5 -0
  147. package/dist/render/links.js.map +1 -0
  148. package/dist/render/live-panel.d.ts +2 -0
  149. package/dist/render/live-panel.d.ts.map +1 -1
  150. package/dist/render/live-panel.js +8 -8
  151. package/dist/render/live-panel.js.map +1 -1
  152. package/dist/render/measurement/measure-launch-view.d.ts +20 -0
  153. package/dist/render/measurement/measure-launch-view.d.ts.map +1 -0
  154. package/dist/render/measurement/measure-launch-view.js +31 -0
  155. package/dist/render/measurement/measure-launch-view.js.map +1 -0
  156. package/dist/render/measurement/measure-status-view.d.ts +35 -0
  157. package/dist/render/measurement/measure-status-view.d.ts.map +1 -0
  158. package/dist/render/measurement/measure-status-view.js +105 -0
  159. package/dist/render/measurement/measure-status-view.js.map +1 -0
  160. package/dist/render/measurement/renderers.d.ts +4 -0
  161. package/dist/render/measurement/renderers.d.ts.map +1 -0
  162. package/dist/render/measurement/renderers.js +14 -0
  163. package/dist/render/measurement/renderers.js.map +1 -0
  164. package/dist/render/meter.d.ts +2 -0
  165. package/dist/render/meter.d.ts.map +1 -0
  166. package/dist/render/meter.js +6 -0
  167. package/dist/render/meter.js.map +1 -0
  168. package/dist/render/palette.d.ts +23 -0
  169. package/dist/render/palette.d.ts.map +1 -0
  170. package/dist/render/palette.js +24 -0
  171. package/dist/render/palette.js.map +1 -0
  172. package/dist/render/payload.d.ts +3 -0
  173. package/dist/render/payload.d.ts.map +1 -0
  174. package/dist/render/payload.js +8 -0
  175. package/dist/render/payload.js.map +1 -0
  176. package/dist/render/registry.d.ts +5 -0
  177. package/dist/render/registry.d.ts.map +1 -1
  178. package/dist/render/registry.js +12 -4
  179. package/dist/render/registry.js.map +1 -1
  180. package/dist/render/sanitize.d.ts +19 -0
  181. package/dist/render/sanitize.d.ts.map +1 -0
  182. package/dist/render/sanitize.js +48 -0
  183. package/dist/render/sanitize.js.map +1 -0
  184. package/dist/render/table.d.ts +10 -4
  185. package/dist/render/table.d.ts.map +1 -1
  186. package/dist/render/table.js +17 -5
  187. package/dist/render/table.js.map +1 -1
  188. package/dist/render/team-event.d.ts +9 -0
  189. package/dist/render/team-event.d.ts.map +1 -0
  190. package/dist/render/team-event.js +38 -0
  191. package/dist/render/team-event.js.map +1 -0
  192. package/dist/watch.d.ts +2 -1
  193. package/dist/watch.d.ts.map +1 -1
  194. package/dist/watch.js +13 -6
  195. package/dist/watch.js.map +1 -1
  196. package/dist/watchers.d.ts +15 -0
  197. package/dist/watchers.d.ts.map +1 -0
  198. package/dist/watchers.js +8 -0
  199. package/dist/watchers.js.map +1 -0
  200. 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 43cebbdca1928a2f344ae61b881d2ba3871dc2f503e6fbda7c4152e57c385095)
2
+ // Source: openapi/ora-public.openapi.json (sha256 3caa7d00bf088b7389cb7a98b0d104d7da7da75ea2da72d96497a3948d0f254a)
3
3
  // Regenerate: yarn nx run ora-cli:generate
4
4
  export const SPEC = {
5
5
  "version": "1.0.0",
6
- "contentHash": "43cebbdca1928a2f344ae61b881d2ba3871dc2f503e6fbda7c4152e57c385095",
6
+ "contentHash": "3caa7d00bf088b7389cb7a98b0d104d7da7da75ea2da72d96497a3948d0f254a",
7
7
  "server": "https://api.agentfront.sh",
8
8
  "bin": "ora"
9
9
  };
@@ -72,7 +72,8 @@ export const OPERATIONS = [
72
72
  "kind": "string",
73
73
  "enum": [
74
74
  "run",
75
- "session"
75
+ "session",
76
+ "managed"
76
77
  ]
77
78
  }
78
79
  ],
@@ -174,40 +175,1904 @@ export const OPERATIONS = [
174
175
  ]
175
176
  },
176
177
  {
177
- "name": "domain",
178
- "flag": "domain",
179
- "optionKey": "domain",
178
+ "name": "domain",
179
+ "flag": "domain",
180
+ "optionKey": "domain",
181
+ "required": false,
182
+ "kind": "string"
183
+ },
184
+ {
185
+ "name": "intents",
186
+ "flag": "intents",
187
+ "optionKey": "intents",
188
+ "required": false,
189
+ "kind": "string"
190
+ },
191
+ {
192
+ "name": "models",
193
+ "flag": "models",
194
+ "optionKey": "models",
195
+ "required": false,
196
+ "kind": "string"
197
+ },
198
+ {
199
+ "name": "layers",
200
+ "flag": "layers",
201
+ "optionKey": "layers",
202
+ "required": false,
203
+ "kind": "string"
204
+ }
205
+ ],
206
+ "hasBody": false,
207
+ "bodyRequired": false,
208
+ "isStream": false,
209
+ "watchable": false,
210
+ "help": {
211
+ "command": "ora analytics overview"
212
+ }
213
+ },
214
+ {
215
+ "id": "autopilot.board.list",
216
+ "commandPath": [
217
+ "autopilot",
218
+ "board",
219
+ "list"
220
+ ],
221
+ "method": "get",
222
+ "pathTemplate": "/experiment/v1/autopilot/teams/{team}/missions/{mission}/board",
223
+ "summary": "A mission's board tasks",
224
+ "scope": "autopilot:read",
225
+ "product": "experiment",
226
+ "pathParams": [
227
+ {
228
+ "name": "team"
229
+ },
230
+ {
231
+ "name": "mission"
232
+ }
233
+ ],
234
+ "queryParams": [],
235
+ "hasBody": false,
236
+ "bodyRequired": false,
237
+ "isStream": false,
238
+ "watchable": false,
239
+ "help": {
240
+ "command": "ora autopilot board list <team> <mission>"
241
+ }
242
+ },
243
+ {
244
+ "id": "autopilot.events.list",
245
+ "commandPath": [
246
+ "autopilot",
247
+ "events",
248
+ "list"
249
+ ],
250
+ "method": "get",
251
+ "pathTemplate": "/experiment/v1/autopilot/teams/{team}/events",
252
+ "summary": "Page the durable team event log by seq (afterSeq + limit ≤ 500)",
253
+ "scope": "autopilot:read",
254
+ "product": "experiment",
255
+ "pathParams": [
256
+ {
257
+ "name": "team"
258
+ }
259
+ ],
260
+ "queryParams": [
261
+ {
262
+ "name": "missionId",
263
+ "flag": "mission-id",
264
+ "optionKey": "missionId",
265
+ "required": false,
266
+ "kind": "string"
267
+ },
268
+ {
269
+ "name": "messageId",
270
+ "flag": "message-id",
271
+ "optionKey": "messageId",
272
+ "required": false,
273
+ "kind": "string"
274
+ },
275
+ {
276
+ "name": "exportId",
277
+ "flag": "export-id",
278
+ "optionKey": "exportId",
279
+ "required": false,
280
+ "kind": "string"
281
+ },
282
+ {
283
+ "name": "afterSeq",
284
+ "flag": "after-seq",
285
+ "optionKey": "afterSeq",
286
+ "required": false,
287
+ "kind": "number"
288
+ },
289
+ {
290
+ "name": "limit",
291
+ "flag": "limit",
292
+ "optionKey": "limit",
293
+ "required": false,
294
+ "kind": "number"
295
+ },
296
+ {
297
+ "name": "kinds",
298
+ "flag": "kinds",
299
+ "optionKey": "kinds",
300
+ "required": false,
301
+ "kind": "string"
302
+ }
303
+ ],
304
+ "hasBody": false,
305
+ "bodyRequired": false,
306
+ "isStream": false,
307
+ "watchable": false,
308
+ "help": {
309
+ "command": "ora autopilot events list <team>"
310
+ }
311
+ },
312
+ {
313
+ "id": "autopilot.exports.create",
314
+ "commandPath": [
315
+ "autopilot",
316
+ "exports",
317
+ "create"
318
+ ],
319
+ "method": "post",
320
+ "pathTemplate": "/experiment/v1/autopilot/teams/{team}/exports",
321
+ "summary": "Request a research dataset export of terminal missions; completes asynchronously",
322
+ "scope": "autopilot:export:write",
323
+ "product": "experiment",
324
+ "pathParams": [
325
+ {
326
+ "name": "team"
327
+ }
328
+ ],
329
+ "queryParams": [],
330
+ "hasBody": true,
331
+ "bodyRequired": true,
332
+ "isStream": false,
333
+ "bodyFields": [
334
+ {
335
+ "name": "missionIds",
336
+ "required": false,
337
+ "kind": "array",
338
+ "placeholder": "[]"
339
+ },
340
+ {
341
+ "name": "from",
342
+ "required": false,
343
+ "kind": "string",
344
+ "placeholder": "<from>"
345
+ },
346
+ {
347
+ "name": "to",
348
+ "required": false,
349
+ "kind": "string",
350
+ "placeholder": "<to>"
351
+ },
352
+ {
353
+ "name": "clientKey",
354
+ "required": false,
355
+ "kind": "string",
356
+ "placeholder": "<clientKey>"
357
+ }
358
+ ],
359
+ "watchable": true,
360
+ "help": {
361
+ "command": "ora autopilot exports create <team> --file run.json --watch",
362
+ "body": "{\n \"missionIds\": [],\n \"from\": \"<from>\",\n \"to\": \"<to>\"\n}"
363
+ }
364
+ },
365
+ {
366
+ "id": "autopilot.exports.get",
367
+ "commandPath": [
368
+ "autopilot",
369
+ "exports",
370
+ "get"
371
+ ],
372
+ "method": "get",
373
+ "pathTemplate": "/experiment/v1/autopilot/teams/{team}/exports/{export}",
374
+ "summary": "An export's manifest, redaction report and a fresh 15-minute signed artifactUrl (never a JSONL body)",
375
+ "scope": "autopilot:export:write",
376
+ "product": "experiment",
377
+ "pathParams": [
378
+ {
379
+ "name": "team"
380
+ },
381
+ {
382
+ "name": "export"
383
+ }
384
+ ],
385
+ "queryParams": [],
386
+ "hasBody": false,
387
+ "bodyRequired": false,
388
+ "isStream": false,
389
+ "watchable": false,
390
+ "help": {
391
+ "command": "ora autopilot exports get <team> <export>"
392
+ }
393
+ },
394
+ {
395
+ "id": "autopilot.exports.list",
396
+ "commandPath": [
397
+ "autopilot",
398
+ "exports",
399
+ "list"
400
+ ],
401
+ "method": "get",
402
+ "pathTemplate": "/experiment/v1/autopilot/teams/{team}/exports",
403
+ "summary": "List a team's exports, newest first",
404
+ "scope": "autopilot:export:write",
405
+ "product": "experiment",
406
+ "pathParams": [
407
+ {
408
+ "name": "team"
409
+ }
410
+ ],
411
+ "queryParams": [
412
+ {
413
+ "name": "cursor",
414
+ "flag": "cursor",
415
+ "optionKey": "cursor",
416
+ "required": false,
417
+ "kind": "string"
418
+ },
419
+ {
420
+ "name": "limit",
421
+ "flag": "limit",
422
+ "optionKey": "limit",
423
+ "required": false,
424
+ "kind": "number"
425
+ }
426
+ ],
427
+ "hasBody": false,
428
+ "bodyRequired": false,
429
+ "isStream": false,
430
+ "watchable": false,
431
+ "help": {
432
+ "command": "ora autopilot exports list <team>"
433
+ }
434
+ },
435
+ {
436
+ "id": "autopilot.members.add",
437
+ "commandPath": [
438
+ "autopilot",
439
+ "members",
440
+ "add"
441
+ ],
442
+ "method": "post",
443
+ "pathTemplate": "/experiment/v1/autopilot/teams/{team}/members",
444
+ "summary": "Add a core member; it joins later missions, never an active lane",
445
+ "scope": "autopilot:write",
446
+ "product": "experiment",
447
+ "pathParams": [
448
+ {
449
+ "name": "team"
450
+ }
451
+ ],
452
+ "queryParams": [],
453
+ "hasBody": true,
454
+ "bodyRequired": true,
455
+ "isStream": false,
456
+ "bodyFields": [
457
+ {
458
+ "name": "handle",
459
+ "required": true,
460
+ "kind": "string",
461
+ "placeholder": "<handle>"
462
+ },
463
+ {
464
+ "name": "harness",
465
+ "required": true,
466
+ "kind": "string",
467
+ "placeholder": "<harness>"
468
+ },
469
+ {
470
+ "name": "model",
471
+ "required": false,
472
+ "kind": "string",
473
+ "placeholder": "<model>"
474
+ },
475
+ {
476
+ "name": "tier",
477
+ "required": false,
478
+ "kind": "string",
479
+ "placeholder": "core"
480
+ },
481
+ {
482
+ "name": "position",
483
+ "required": false,
484
+ "kind": "string",
485
+ "placeholder": "<position>"
486
+ },
487
+ {
488
+ "name": "kit",
489
+ "required": false,
490
+ "kind": "object",
491
+ "placeholder": "{}"
492
+ }
493
+ ],
494
+ "watchable": false,
495
+ "help": {
496
+ "command": "ora autopilot members add <team> --file run.json",
497
+ "body": "{\n \"handle\": \"<handle>\",\n \"harness\": \"<harness>\"\n}"
498
+ }
499
+ },
500
+ {
501
+ "id": "autopilot.members.applyKit",
502
+ "commandPath": [
503
+ "autopilot",
504
+ "members",
505
+ "apply-kit"
506
+ ],
507
+ "method": "post",
508
+ "pathTemplate": "/experiment/v1/autopilot/teams/{team}/members/{member}/kit/apply",
509
+ "summary": "Apply a member's kit and model on a fresh workspace (the disk is replaced; replaceDisk must be true); with kit, set it and apply it in one call",
510
+ "scope": "autopilot:write",
511
+ "product": "experiment",
512
+ "pathParams": [
513
+ {
514
+ "name": "team"
515
+ },
516
+ {
517
+ "name": "member"
518
+ }
519
+ ],
520
+ "queryParams": [],
521
+ "hasBody": true,
522
+ "bodyRequired": true,
523
+ "isStream": false,
524
+ "bodyFields": [
525
+ {
526
+ "name": "mode",
527
+ "required": true,
528
+ "kind": "string",
529
+ "enum": [
530
+ "fresh-workspace"
531
+ ],
532
+ "placeholder": "fresh-workspace"
533
+ },
534
+ {
535
+ "name": "replaceDisk",
536
+ "required": true,
537
+ "kind": "boolean",
538
+ "placeholder": "true"
539
+ },
540
+ {
541
+ "name": "kit",
542
+ "required": false,
543
+ "kind": "object",
544
+ "placeholder": "{}"
545
+ },
546
+ {
547
+ "name": "clientKey",
548
+ "required": false,
549
+ "kind": "string",
550
+ "placeholder": "<clientKey>"
551
+ }
552
+ ],
553
+ "watchable": false,
554
+ "help": {
555
+ "command": "ora autopilot members apply-kit <team> <member> --file run.json",
556
+ "body": "{\n \"mode\": \"fresh-workspace\",\n \"replaceDisk\": true\n}"
557
+ }
558
+ },
559
+ {
560
+ "id": "autopilot.members.list",
561
+ "commandPath": [
562
+ "autopilot",
563
+ "members",
564
+ "list"
565
+ ],
566
+ "method": "get",
567
+ "pathTemplate": "/experiment/v1/autopilot/teams/{team}/members",
568
+ "summary": "List a team's members",
569
+ "scope": "autopilot:read",
570
+ "product": "experiment",
571
+ "pathParams": [
572
+ {
573
+ "name": "team"
574
+ }
575
+ ],
576
+ "queryParams": [],
577
+ "hasBody": false,
578
+ "bodyRequired": false,
579
+ "isStream": false,
580
+ "watchable": false,
581
+ "help": {
582
+ "command": "ora autopilot members list <team>"
583
+ }
584
+ },
585
+ {
586
+ "id": "autopilot.members.remove",
587
+ "commandPath": [
588
+ "autopilot",
589
+ "members",
590
+ "remove"
591
+ ],
592
+ "method": "delete",
593
+ "pathTemplate": "/experiment/v1/autopilot/teams/{team}/members/{member}",
594
+ "summary": "Remove a member: its pending recipients fail and its workspace is released",
595
+ "scope": "autopilot:write",
596
+ "product": "experiment",
597
+ "pathParams": [
598
+ {
599
+ "name": "team"
600
+ },
601
+ {
602
+ "name": "member"
603
+ }
604
+ ],
605
+ "queryParams": [],
606
+ "hasBody": false,
607
+ "bodyRequired": false,
608
+ "isStream": false,
609
+ "watchable": false,
610
+ "help": {
611
+ "command": "ora autopilot members remove <team> <member>"
612
+ }
613
+ },
614
+ {
615
+ "id": "autopilot.members.transcript",
616
+ "commandPath": [
617
+ "autopilot",
618
+ "members",
619
+ "transcript"
620
+ ],
621
+ "method": "get",
622
+ "pathTemplate": "/experiment/v1/autopilot/teams/{team}/members/{member}/transcript/stream",
623
+ "summary": "SSE: one frame per closed session-trace segment of a core member",
624
+ "scope": "autopilot:read",
625
+ "product": "experiment",
626
+ "pathParams": [
627
+ {
628
+ "name": "team"
629
+ },
630
+ {
631
+ "name": "member"
632
+ }
633
+ ],
634
+ "queryParams": [
635
+ {
636
+ "name": "after",
637
+ "flag": "after",
638
+ "optionKey": "after",
639
+ "required": false,
640
+ "kind": "number"
641
+ }
642
+ ],
643
+ "hasBody": false,
644
+ "bodyRequired": false,
645
+ "isStream": true,
646
+ "watchable": false,
647
+ "help": {
648
+ "command": "ora autopilot members transcript <team> <member>"
649
+ }
650
+ },
651
+ {
652
+ "id": "autopilot.members.update",
653
+ "commandPath": [
654
+ "autopilot",
655
+ "members",
656
+ "update"
657
+ ],
658
+ "method": "patch",
659
+ "pathTemplate": "/experiment/v1/autopilot/teams/{team}/members/{member}",
660
+ "summary": "Change a member's model, position or kit (a position change is logged as member.position_assigned; a model or kit change is pending until a fresh workspace applies it)",
661
+ "scope": "autopilot:write",
662
+ "product": "experiment",
663
+ "pathParams": [
664
+ {
665
+ "name": "team"
666
+ },
667
+ {
668
+ "name": "member"
669
+ }
670
+ ],
671
+ "queryParams": [],
672
+ "hasBody": true,
673
+ "bodyRequired": true,
674
+ "isStream": false,
675
+ "bodyFields": [
676
+ {
677
+ "name": "model",
678
+ "required": false,
679
+ "kind": "string",
680
+ "placeholder": "<model>"
681
+ },
682
+ {
683
+ "name": "position",
684
+ "required": false,
685
+ "kind": "string",
686
+ "placeholder": "<position>"
687
+ },
688
+ {
689
+ "name": "kit",
690
+ "required": false,
691
+ "kind": "object",
692
+ "placeholder": "{}"
693
+ }
694
+ ],
695
+ "watchable": false,
696
+ "help": {
697
+ "command": "ora autopilot members update <team> <member> --file run.json",
698
+ "body": "{\n \"model\": \"<model>\",\n \"position\": \"<position>\",\n \"kit\": {}\n}"
699
+ }
700
+ },
701
+ {
702
+ "id": "autopilot.messages.send",
703
+ "commandPath": [
704
+ "autopilot",
705
+ "messages",
706
+ "send"
707
+ ],
708
+ "method": "post",
709
+ "pathTemplate": "/experiment/v1/autopilot/teams/{team}/messages",
710
+ "summary": "Message members of an active mission (interrupt: true is operator authority); never creates a mission",
711
+ "scope": "autopilot:write",
712
+ "product": "experiment",
713
+ "pathParams": [
714
+ {
715
+ "name": "team"
716
+ }
717
+ ],
718
+ "queryParams": [],
719
+ "hasBody": true,
720
+ "bodyRequired": true,
721
+ "isStream": false,
722
+ "bodyFields": [
723
+ {
724
+ "name": "to",
725
+ "required": true,
726
+ "kind": "array",
727
+ "placeholder": "[]"
728
+ },
729
+ {
730
+ "name": "text",
731
+ "required": true,
732
+ "kind": "string",
733
+ "placeholder": "<text>"
734
+ },
735
+ {
736
+ "name": "interrupt",
737
+ "required": false,
738
+ "kind": "boolean",
739
+ "placeholder": "false"
740
+ },
741
+ {
742
+ "name": "missionId",
743
+ "required": false,
744
+ "kind": "string",
745
+ "placeholder": "<missionId>"
746
+ },
747
+ {
748
+ "name": "clientKey",
749
+ "required": false,
750
+ "kind": "string",
751
+ "placeholder": "<clientKey>"
752
+ }
753
+ ],
754
+ "watchable": true,
755
+ "help": {
756
+ "command": "ora autopilot messages send <team> --file run.json --watch",
757
+ "body": "{\n \"to\": [],\n \"text\": \"<text>\"\n}"
758
+ }
759
+ },
760
+ {
761
+ "id": "autopilot.missions.create",
762
+ "commandPath": [
763
+ "autopilot",
764
+ "missions",
765
+ "create"
766
+ ],
767
+ "method": "post",
768
+ "pathTemplate": "/experiment/v1/autopilot/teams/{team}/missions",
769
+ "summary": "Send a task to the team, a squad or one member; the Scheduling axis starts, queues or adds it",
770
+ "scope": "autopilot:write",
771
+ "product": "experiment",
772
+ "pathParams": [
773
+ {
774
+ "name": "team"
775
+ }
776
+ ],
777
+ "queryParams": [],
778
+ "hasBody": true,
779
+ "bodyRequired": true,
780
+ "isStream": false,
781
+ "bodyFields": [
782
+ {
783
+ "name": "target",
784
+ "required": true,
785
+ "kind": "object",
786
+ "placeholder": "{}"
787
+ },
788
+ {
789
+ "name": "title",
790
+ "required": false,
791
+ "kind": "string",
792
+ "placeholder": "<title>"
793
+ },
794
+ {
795
+ "name": "instructions",
796
+ "required": true,
797
+ "kind": "string",
798
+ "placeholder": "<instructions>"
799
+ },
800
+ {
801
+ "name": "overrides",
802
+ "required": false,
803
+ "kind": "object",
804
+ "placeholder": "{}"
805
+ },
806
+ {
807
+ "name": "clientKey",
808
+ "required": false,
809
+ "kind": "string",
810
+ "placeholder": "<clientKey>"
811
+ }
812
+ ],
813
+ "watchable": true,
814
+ "help": {
815
+ "command": "ora autopilot missions create <team> --file run.json --watch",
816
+ "body": "{\n \"target\": {},\n \"instructions\": \"<instructions>\"\n}"
817
+ }
818
+ },
819
+ {
820
+ "id": "autopilot.missions.get",
821
+ "commandPath": [
822
+ "autopilot",
823
+ "missions",
824
+ "get"
825
+ ],
826
+ "method": "get",
827
+ "pathTemplate": "/experiment/v1/autopilot/teams/{team}/missions/{mission}",
828
+ "summary": "Get a mission: lane, frozen snapshot, counters",
829
+ "scope": "autopilot:read",
830
+ "product": "experiment",
831
+ "pathParams": [
832
+ {
833
+ "name": "team"
834
+ },
835
+ {
836
+ "name": "mission"
837
+ }
838
+ ],
839
+ "queryParams": [],
840
+ "hasBody": false,
841
+ "bodyRequired": false,
842
+ "isStream": false,
843
+ "watchable": false,
844
+ "help": {
845
+ "command": "ora autopilot missions get <team> <mission>"
846
+ }
847
+ },
848
+ {
849
+ "id": "autopilot.missions.list",
850
+ "commandPath": [
851
+ "autopilot",
852
+ "missions",
853
+ "list"
854
+ ],
855
+ "method": "get",
856
+ "pathTemplate": "/experiment/v1/autopilot/teams/{team}/missions",
857
+ "summary": "List a team's missions, newest first",
858
+ "scope": "autopilot:read",
859
+ "product": "experiment",
860
+ "pathParams": [
861
+ {
862
+ "name": "team"
863
+ }
864
+ ],
865
+ "queryParams": [
866
+ {
867
+ "name": "cursor",
868
+ "flag": "cursor",
869
+ "optionKey": "cursor",
870
+ "required": false,
871
+ "kind": "string"
872
+ },
873
+ {
874
+ "name": "limit",
875
+ "flag": "limit",
876
+ "optionKey": "limit",
877
+ "required": false,
878
+ "kind": "number"
879
+ },
880
+ {
881
+ "name": "status",
882
+ "flag": "status",
883
+ "optionKey": "status",
884
+ "required": false,
885
+ "kind": "string",
886
+ "enum": [
887
+ "queued",
888
+ "active",
889
+ "draining",
890
+ "pausing",
891
+ "paused",
892
+ "stopping",
893
+ "done",
894
+ "failed_to_converge",
895
+ "failed",
896
+ "stopped"
897
+ ]
898
+ }
899
+ ],
900
+ "hasBody": false,
901
+ "bodyRequired": false,
902
+ "isStream": false,
903
+ "watchable": false,
904
+ "help": {
905
+ "command": "ora autopilot missions list <team>"
906
+ }
907
+ },
908
+ {
909
+ "id": "autopilot.missions.pause",
910
+ "commandPath": [
911
+ "autopilot",
912
+ "missions",
913
+ "pause"
914
+ ],
915
+ "method": "post",
916
+ "pathTemplate": "/experiment/v1/autopilot/teams/{team}/missions/{mission}/pause",
917
+ "summary": "Pause a mission (mode graceful or immediate); finishes asynchronously",
918
+ "scope": "autopilot:write",
919
+ "product": "experiment",
920
+ "pathParams": [
921
+ {
922
+ "name": "team"
923
+ },
924
+ {
925
+ "name": "mission"
926
+ }
927
+ ],
928
+ "queryParams": [
929
+ {
930
+ "name": "mode",
931
+ "flag": "mode",
932
+ "optionKey": "mode",
933
+ "required": false,
934
+ "kind": "string",
935
+ "enum": [
936
+ "graceful",
937
+ "immediate"
938
+ ]
939
+ }
940
+ ],
941
+ "hasBody": false,
942
+ "bodyRequired": false,
943
+ "isStream": false,
944
+ "watchable": true,
945
+ "help": {
946
+ "command": "ora autopilot missions pause <team> <mission> --watch"
947
+ }
948
+ },
949
+ {
950
+ "id": "autopilot.missions.resume",
951
+ "commandPath": [
952
+ "autopilot",
953
+ "missions",
954
+ "resume"
955
+ ],
956
+ "method": "post",
957
+ "pathTemplate": "/experiment/v1/autopilot/teams/{team}/missions/{mission}/resume",
958
+ "summary": "Resume a paused mission (bumps its epoch)",
959
+ "scope": "autopilot:write",
960
+ "product": "experiment",
961
+ "pathParams": [
962
+ {
963
+ "name": "team"
964
+ },
965
+ {
966
+ "name": "mission"
967
+ }
968
+ ],
969
+ "queryParams": [],
970
+ "hasBody": false,
971
+ "bodyRequired": false,
972
+ "isStream": false,
973
+ "watchable": true,
974
+ "help": {
975
+ "command": "ora autopilot missions resume <team> <mission> --watch"
976
+ }
977
+ },
978
+ {
979
+ "id": "autopilot.missions.stop",
980
+ "commandPath": [
981
+ "autopilot",
982
+ "missions",
983
+ "stop"
984
+ ],
985
+ "method": "post",
986
+ "pathTemplate": "/experiment/v1/autopilot/teams/{team}/missions/{mission}/stop",
987
+ "summary": "Stop a mission (mode graceful or immediate); finishes asynchronously",
988
+ "scope": "autopilot:write",
989
+ "product": "experiment",
990
+ "pathParams": [
991
+ {
992
+ "name": "team"
993
+ },
994
+ {
995
+ "name": "mission"
996
+ }
997
+ ],
998
+ "queryParams": [
999
+ {
1000
+ "name": "mode",
1001
+ "flag": "mode",
1002
+ "optionKey": "mode",
1003
+ "required": false,
1004
+ "kind": "string",
1005
+ "enum": [
1006
+ "graceful",
1007
+ "immediate"
1008
+ ]
1009
+ }
1010
+ ],
1011
+ "hasBody": false,
1012
+ "bodyRequired": false,
1013
+ "isStream": false,
1014
+ "watchable": true,
1015
+ "help": {
1016
+ "command": "ora autopilot missions stop <team> <mission> --watch"
1017
+ }
1018
+ },
1019
+ {
1020
+ "id": "autopilot.missions.update",
1021
+ "commandPath": [
1022
+ "autopilot",
1023
+ "missions",
1024
+ "update"
1025
+ ],
1026
+ "method": "patch",
1027
+ "pathTemplate": "/experiment/v1/autopilot/teams/{team}/missions/{mission}",
1028
+ "summary": "Change a live mission's budgets (a kernel-reserved budget change, logged as mission.budget_changed)",
1029
+ "scope": "autopilot:write",
1030
+ "product": "experiment",
1031
+ "pathParams": [
1032
+ {
1033
+ "name": "team"
1034
+ },
1035
+ {
1036
+ "name": "mission"
1037
+ }
1038
+ ],
1039
+ "queryParams": [],
1040
+ "hasBody": true,
1041
+ "bodyRequired": true,
1042
+ "isStream": false,
1043
+ "bodyFields": [
1044
+ {
1045
+ "name": "budgets",
1046
+ "required": true,
1047
+ "kind": "object",
1048
+ "placeholder": "{}"
1049
+ }
1050
+ ],
1051
+ "watchable": false,
1052
+ "help": {
1053
+ "command": "ora autopilot missions update <team> <mission> --file run.json",
1054
+ "body": "{\n \"budgets\": {}\n}"
1055
+ }
1056
+ },
1057
+ {
1058
+ "id": "autopilot.notes.get",
1059
+ "commandPath": [
1060
+ "autopilot",
1061
+ "notes",
1062
+ "get"
1063
+ ],
1064
+ "method": "get",
1065
+ "pathTemplate": "/experiment/v1/autopilot/teams/{team}/notes/{note}",
1066
+ "summary": "Get one note",
1067
+ "scope": "autopilot:read",
1068
+ "product": "experiment",
1069
+ "pathParams": [
1070
+ {
1071
+ "name": "team"
1072
+ },
1073
+ {
1074
+ "name": "note"
1075
+ }
1076
+ ],
1077
+ "queryParams": [],
1078
+ "hasBody": false,
1079
+ "bodyRequired": false,
1080
+ "isStream": false,
1081
+ "watchable": false,
1082
+ "help": {
1083
+ "command": "ora autopilot notes get <team> <note>"
1084
+ }
1085
+ },
1086
+ {
1087
+ "id": "autopilot.notes.list",
1088
+ "commandPath": [
1089
+ "autopilot",
1090
+ "notes",
1091
+ "list"
1092
+ ],
1093
+ "method": "get",
1094
+ "pathTemplate": "/experiment/v1/autopilot/teams/{team}/notes",
1095
+ "summary": "The team's notes (agent-written, attributed)",
1096
+ "scope": "autopilot:read",
1097
+ "product": "experiment",
1098
+ "pathParams": [
1099
+ {
1100
+ "name": "team"
1101
+ }
1102
+ ],
1103
+ "queryParams": [
1104
+ {
1105
+ "name": "cursor",
1106
+ "flag": "cursor",
1107
+ "optionKey": "cursor",
1108
+ "required": false,
1109
+ "kind": "string"
1110
+ },
1111
+ {
1112
+ "name": "limit",
1113
+ "flag": "limit",
1114
+ "optionKey": "limit",
1115
+ "required": false,
1116
+ "kind": "number"
1117
+ },
1118
+ {
1119
+ "name": "status",
1120
+ "flag": "status",
1121
+ "optionKey": "status",
1122
+ "required": false,
1123
+ "kind": "string",
1124
+ "enum": [
1125
+ "active",
1126
+ "quarantined",
1127
+ "superseded"
1128
+ ]
1129
+ }
1130
+ ],
1131
+ "hasBody": false,
1132
+ "bodyRequired": false,
1133
+ "isStream": false,
1134
+ "watchable": false,
1135
+ "help": {
1136
+ "command": "ora autopilot notes list <team>"
1137
+ }
1138
+ },
1139
+ {
1140
+ "id": "autopilot.notes.quarantine",
1141
+ "commandPath": [
1142
+ "autopilot",
1143
+ "notes",
1144
+ "quarantine"
1145
+ ],
1146
+ "method": "post",
1147
+ "pathTemplate": "/experiment/v1/autopilot/teams/{team}/notes/{note}/quarantine",
1148
+ "summary": "Quarantine a note: it is never served to agents again",
1149
+ "scope": "autopilot:write",
1150
+ "product": "experiment",
1151
+ "pathParams": [
1152
+ {
1153
+ "name": "team"
1154
+ },
1155
+ {
1156
+ "name": "note"
1157
+ }
1158
+ ],
1159
+ "queryParams": [],
1160
+ "hasBody": false,
1161
+ "bodyRequired": false,
1162
+ "isStream": false,
1163
+ "watchable": false,
1164
+ "help": {
1165
+ "command": "ora autopilot notes quarantine <team> <note>"
1166
+ }
1167
+ },
1168
+ {
1169
+ "id": "autopilot.notes.rollback",
1170
+ "commandPath": [
1171
+ "autopilot",
1172
+ "notes",
1173
+ "rollback"
1174
+ ],
1175
+ "method": "post",
1176
+ "pathTemplate": "/experiment/v1/autopilot/teams/{team}/notes/{note}/rollback",
1177
+ "summary": "Roll a note back to the version it superseded",
1178
+ "scope": "autopilot:write",
1179
+ "product": "experiment",
1180
+ "pathParams": [
1181
+ {
1182
+ "name": "team"
1183
+ },
1184
+ {
1185
+ "name": "note"
1186
+ }
1187
+ ],
1188
+ "queryParams": [],
1189
+ "hasBody": false,
1190
+ "bodyRequired": false,
1191
+ "isStream": false,
1192
+ "watchable": false,
1193
+ "help": {
1194
+ "command": "ora autopilot notes rollback <team> <note>"
1195
+ }
1196
+ },
1197
+ {
1198
+ "id": "autopilot.presets.create",
1199
+ "commandPath": [
1200
+ "autopilot",
1201
+ "presets",
1202
+ "create"
1203
+ ],
1204
+ "method": "post",
1205
+ "pathTemplate": "/experiment/v1/autopilot/presets",
1206
+ "summary": "Save an organization preset; saving an existing name creates its next version",
1207
+ "scope": "autopilot:write",
1208
+ "product": "experiment",
1209
+ "pathParams": [],
1210
+ "queryParams": [],
1211
+ "hasBody": true,
1212
+ "bodyRequired": true,
1213
+ "isStream": false,
1214
+ "bodyFields": [
1215
+ {
1216
+ "name": "name",
1217
+ "required": true,
1218
+ "kind": "string",
1219
+ "placeholder": "<name>"
1220
+ },
1221
+ {
1222
+ "name": "body",
1223
+ "required": true,
1224
+ "kind": "object",
1225
+ "placeholder": "{}"
1226
+ }
1227
+ ],
1228
+ "watchable": false,
1229
+ "help": {
1230
+ "command": "ora autopilot presets create --file run.json",
1231
+ "body": "{\n \"name\": \"<name>\",\n \"body\": {}\n}"
1232
+ }
1233
+ },
1234
+ {
1235
+ "id": "autopilot.presets.get",
1236
+ "commandPath": [
1237
+ "autopilot",
1238
+ "presets",
1239
+ "get"
1240
+ ],
1241
+ "method": "get",
1242
+ "pathTemplate": "/experiment/v1/autopilot/presets/{preset}",
1243
+ "summary": "Get a preset by name@version",
1244
+ "scope": "autopilot:read",
1245
+ "product": "experiment",
1246
+ "pathParams": [
1247
+ {
1248
+ "name": "preset"
1249
+ }
1250
+ ],
1251
+ "queryParams": [],
1252
+ "hasBody": false,
1253
+ "bodyRequired": false,
1254
+ "isStream": false,
1255
+ "watchable": false,
1256
+ "help": {
1257
+ "command": "ora autopilot presets get <preset>"
1258
+ }
1259
+ },
1260
+ {
1261
+ "id": "autopilot.presets.list",
1262
+ "commandPath": [
1263
+ "autopilot",
1264
+ "presets",
1265
+ "list"
1266
+ ],
1267
+ "method": "get",
1268
+ "pathTemplate": "/experiment/v1/autopilot/presets",
1269
+ "summary": "List system and organization-saved presets",
1270
+ "scope": "autopilot:read",
1271
+ "product": "experiment",
1272
+ "pathParams": [],
1273
+ "queryParams": [],
1274
+ "hasBody": false,
1275
+ "bodyRequired": false,
1276
+ "isStream": false,
1277
+ "watchable": false,
1278
+ "help": {
1279
+ "command": "ora autopilot presets list"
1280
+ }
1281
+ },
1282
+ {
1283
+ "id": "autopilot.secrets.holders",
1284
+ "commandPath": [
1285
+ "autopilot",
1286
+ "secrets",
1287
+ "holders"
1288
+ ],
1289
+ "method": "get",
1290
+ "pathTemplate": "/experiment/v1/autopilot/secret-holders",
1291
+ "summary": "The teams whose data can hold each org secret (bound today, or held by their workspaces and missions; archived teams included): rotating it makes their history unreadable",
1292
+ "scope": "autopilot:read",
1293
+ "product": "experiment",
1294
+ "pathParams": [],
1295
+ "queryParams": [],
1296
+ "hasBody": false,
1297
+ "bodyRequired": false,
1298
+ "isStream": false,
1299
+ "watchable": false,
1300
+ "help": {
1301
+ "command": "ora autopilot secrets holders"
1302
+ }
1303
+ },
1304
+ {
1305
+ "id": "autopilot.segments.get",
1306
+ "commandPath": [
1307
+ "autopilot",
1308
+ "segments",
1309
+ "get"
1310
+ ],
1311
+ "method": "get",
1312
+ "pathTemplate": "/experiment/v1/autopilot/teams/{team}/members/{member}/segments/{batch}",
1313
+ "summary": "One closed segment's stored trajectory",
1314
+ "scope": "autopilot:read",
1315
+ "product": "experiment",
1316
+ "pathParams": [
1317
+ {
1318
+ "name": "team"
1319
+ },
1320
+ {
1321
+ "name": "member"
1322
+ },
1323
+ {
1324
+ "name": "batch"
1325
+ }
1326
+ ],
1327
+ "queryParams": [],
1328
+ "hasBody": false,
1329
+ "bodyRequired": false,
1330
+ "isStream": false,
1331
+ "watchable": false,
1332
+ "help": {
1333
+ "command": "ora autopilot segments get <team> <member> <batch>"
1334
+ }
1335
+ },
1336
+ {
1337
+ "id": "autopilot.squads.create",
1338
+ "commandPath": [
1339
+ "autopilot",
1340
+ "squads",
1341
+ "create"
1342
+ ],
1343
+ "method": "post",
1344
+ "pathTemplate": "/experiment/v1/autopilot/teams/{team}/squads",
1345
+ "summary": "Create a squad (a named subset of members a mission can target)",
1346
+ "scope": "autopilot:write",
1347
+ "product": "experiment",
1348
+ "pathParams": [
1349
+ {
1350
+ "name": "team"
1351
+ }
1352
+ ],
1353
+ "queryParams": [],
1354
+ "hasBody": true,
1355
+ "bodyRequired": true,
1356
+ "isStream": false,
1357
+ "bodyFields": [
1358
+ {
1359
+ "name": "name",
1360
+ "required": true,
1361
+ "kind": "string",
1362
+ "placeholder": "<name>"
1363
+ },
1364
+ {
1365
+ "name": "members",
1366
+ "required": true,
1367
+ "kind": "array",
1368
+ "placeholder": "[]"
1369
+ }
1370
+ ],
1371
+ "watchable": false,
1372
+ "help": {
1373
+ "command": "ora autopilot squads create <team> --file run.json",
1374
+ "body": "{\n \"name\": \"<name>\",\n \"members\": []\n}"
1375
+ }
1376
+ },
1377
+ {
1378
+ "id": "autopilot.squads.delete",
1379
+ "commandPath": [
1380
+ "autopilot",
1381
+ "squads",
1382
+ "delete"
1383
+ ],
1384
+ "method": "delete",
1385
+ "pathTemplate": "/experiment/v1/autopilot/teams/{team}/squads/{squad}",
1386
+ "summary": "Delete a squad; refused while a non-terminal mission targets it",
1387
+ "scope": "autopilot:write",
1388
+ "product": "experiment",
1389
+ "pathParams": [
1390
+ {
1391
+ "name": "team"
1392
+ },
1393
+ {
1394
+ "name": "squad"
1395
+ }
1396
+ ],
1397
+ "queryParams": [],
1398
+ "hasBody": false,
1399
+ "bodyRequired": false,
1400
+ "isStream": false,
1401
+ "watchable": false,
1402
+ "help": {
1403
+ "command": "ora autopilot squads delete <team> <squad>"
1404
+ }
1405
+ },
1406
+ {
1407
+ "id": "autopilot.squads.list",
1408
+ "commandPath": [
1409
+ "autopilot",
1410
+ "squads",
1411
+ "list"
1412
+ ],
1413
+ "method": "get",
1414
+ "pathTemplate": "/experiment/v1/autopilot/teams/{team}/squads",
1415
+ "summary": "List a team's squads",
1416
+ "scope": "autopilot:read",
1417
+ "product": "experiment",
1418
+ "pathParams": [
1419
+ {
1420
+ "name": "team"
1421
+ }
1422
+ ],
1423
+ "queryParams": [],
1424
+ "hasBody": false,
1425
+ "bodyRequired": false,
1426
+ "isStream": false,
1427
+ "watchable": false,
1428
+ "help": {
1429
+ "command": "ora autopilot squads list <team>"
1430
+ }
1431
+ },
1432
+ {
1433
+ "id": "autopilot.squads.update",
1434
+ "commandPath": [
1435
+ "autopilot",
1436
+ "squads",
1437
+ "update"
1438
+ ],
1439
+ "method": "patch",
1440
+ "pathTemplate": "/experiment/v1/autopilot/teams/{team}/squads/{squad}",
1441
+ "summary": "Replace a squad's members",
1442
+ "scope": "autopilot:write",
1443
+ "product": "experiment",
1444
+ "pathParams": [
1445
+ {
1446
+ "name": "team"
1447
+ },
1448
+ {
1449
+ "name": "squad"
1450
+ }
1451
+ ],
1452
+ "queryParams": [],
1453
+ "hasBody": true,
1454
+ "bodyRequired": true,
1455
+ "isStream": false,
1456
+ "bodyFields": [
1457
+ {
1458
+ "name": "members",
1459
+ "required": true,
1460
+ "kind": "array",
1461
+ "placeholder": "[]"
1462
+ }
1463
+ ],
1464
+ "watchable": false,
1465
+ "help": {
1466
+ "command": "ora autopilot squads update <team> <squad> --file run.json",
1467
+ "body": "{\n \"members\": []\n}"
1468
+ }
1469
+ },
1470
+ {
1471
+ "id": "autopilot.strategies.list",
1472
+ "commandPath": [
1473
+ "autopilot",
1474
+ "strategies",
1475
+ "list"
1476
+ ],
1477
+ "method": "get",
1478
+ "pathTemplate": "/experiment/v1/autopilot/strategies",
1479
+ "summary": "The strategy catalog: axes → strategies → key, version, config JSON Schema, display, requires, provides",
1480
+ "scope": "autopilot:read",
1481
+ "product": "experiment",
1482
+ "pathParams": [],
1483
+ "queryParams": [],
1484
+ "hasBody": false,
1485
+ "bodyRequired": false,
1486
+ "isStream": false,
1487
+ "watchable": false,
1488
+ "help": {
1489
+ "command": "ora autopilot strategies list"
1490
+ }
1491
+ },
1492
+ {
1493
+ "id": "autopilot.teams.apply",
1494
+ "commandPath": [
1495
+ "autopilot",
1496
+ "teams",
1497
+ "apply"
1498
+ ],
1499
+ "method": "put",
1500
+ "pathTemplate": "/experiment/v1/autopilot/teams/{team}",
1501
+ "summary": "Create the team, or converge it to the file: roster diffs become member events; strategy changes apply from the next mission",
1502
+ "scope": "autopilot:write",
1503
+ "product": "experiment",
1504
+ "pathParams": [
1505
+ {
1506
+ "name": "team"
1507
+ }
1508
+ ],
1509
+ "queryParams": [],
1510
+ "hasBody": true,
1511
+ "bodyRequired": true,
1512
+ "isStream": false,
1513
+ "bodyFields": [
1514
+ {
1515
+ "name": "name",
1516
+ "required": true,
1517
+ "kind": "string",
1518
+ "placeholder": "<name>"
1519
+ },
1520
+ {
1521
+ "name": "slug",
1522
+ "required": false,
1523
+ "kind": "string",
1524
+ "placeholder": "<slug>"
1525
+ },
1526
+ {
1527
+ "name": "researchUse",
1528
+ "required": false,
1529
+ "kind": "string",
1530
+ "enum": [
1531
+ "internal_only",
1532
+ "publishable_after_review",
1533
+ "excluded"
1534
+ ],
1535
+ "placeholder": "internal_only"
1536
+ },
1537
+ {
1538
+ "name": "members",
1539
+ "required": true,
1540
+ "kind": "array",
1541
+ "placeholder": "[]"
1542
+ },
1543
+ {
1544
+ "name": "squads",
1545
+ "required": false,
1546
+ "kind": "array",
1547
+ "placeholder": "[]"
1548
+ },
1549
+ {
1550
+ "name": "positions",
1551
+ "required": false,
1552
+ "kind": "array",
1553
+ "placeholder": "[]"
1554
+ },
1555
+ {
1556
+ "name": "preset",
1557
+ "required": false,
1558
+ "kind": "string",
1559
+ "placeholder": "<preset>"
1560
+ },
1561
+ {
1562
+ "name": "axes",
1563
+ "required": false,
1564
+ "kind": "object",
1565
+ "placeholder": "{}"
1566
+ },
1567
+ {
1568
+ "name": "budgets",
1569
+ "required": false,
1570
+ "kind": "object",
1571
+ "placeholder": "{\"onTrip\":\"pause\",\"team\":{},\"mission\":{},\"member\":{}}"
1572
+ },
1573
+ {
1574
+ "name": "resources",
1575
+ "required": false,
1576
+ "kind": "object",
1577
+ "placeholder": "{\"repos\":[]}"
1578
+ },
1579
+ {
1580
+ "name": "kit",
1581
+ "required": false,
1582
+ "kind": "object",
1583
+ "placeholder": "{\"addons\":{}}"
1584
+ },
1585
+ {
1586
+ "name": "clientKey",
1587
+ "required": false,
1588
+ "kind": "string",
1589
+ "placeholder": "<clientKey>"
1590
+ }
1591
+ ],
1592
+ "watchable": false,
1593
+ "help": {
1594
+ "command": "ora autopilot teams apply <team> --file run.json",
1595
+ "body": "{\n \"name\": \"<name>\",\n \"members\": []\n}"
1596
+ }
1597
+ },
1598
+ {
1599
+ "id": "autopilot.teams.archive",
1600
+ "commandPath": [
1601
+ "autopilot",
1602
+ "teams",
1603
+ "archive"
1604
+ ],
1605
+ "method": "post",
1606
+ "pathTemplate": "/experiment/v1/autopilot/teams/{team}/archive",
1607
+ "summary": "Archive a team and release its session slots; refused while a mission is non-terminal",
1608
+ "scope": "autopilot:write",
1609
+ "product": "experiment",
1610
+ "pathParams": [
1611
+ {
1612
+ "name": "team"
1613
+ }
1614
+ ],
1615
+ "queryParams": [],
1616
+ "hasBody": false,
1617
+ "bodyRequired": false,
1618
+ "isStream": false,
1619
+ "watchable": false,
1620
+ "help": {
1621
+ "command": "ora autopilot teams archive <team>"
1622
+ }
1623
+ },
1624
+ {
1625
+ "id": "autopilot.teams.create",
1626
+ "commandPath": [
1627
+ "autopilot",
1628
+ "teams",
1629
+ "create"
1630
+ ],
1631
+ "method": "post",
1632
+ "pathTemplate": "/experiment/v1/autopilot/teams",
1633
+ "summary": "Create a standing team from a team file (roster, squads, positions, preset, axes, budgets, resources)",
1634
+ "scope": "autopilot:write",
1635
+ "product": "experiment",
1636
+ "pathParams": [],
1637
+ "queryParams": [],
1638
+ "hasBody": true,
1639
+ "bodyRequired": true,
1640
+ "isStream": false,
1641
+ "bodyFields": [
1642
+ {
1643
+ "name": "name",
1644
+ "required": true,
1645
+ "kind": "string",
1646
+ "placeholder": "<name>"
1647
+ },
1648
+ {
1649
+ "name": "slug",
1650
+ "required": false,
1651
+ "kind": "string",
1652
+ "placeholder": "<slug>"
1653
+ },
1654
+ {
1655
+ "name": "researchUse",
1656
+ "required": false,
1657
+ "kind": "string",
1658
+ "enum": [
1659
+ "internal_only",
1660
+ "publishable_after_review",
1661
+ "excluded"
1662
+ ],
1663
+ "placeholder": "internal_only"
1664
+ },
1665
+ {
1666
+ "name": "members",
1667
+ "required": true,
1668
+ "kind": "array",
1669
+ "placeholder": "[]"
1670
+ },
1671
+ {
1672
+ "name": "squads",
1673
+ "required": false,
1674
+ "kind": "array",
1675
+ "placeholder": "[]"
1676
+ },
1677
+ {
1678
+ "name": "positions",
1679
+ "required": false,
1680
+ "kind": "array",
1681
+ "placeholder": "[]"
1682
+ },
1683
+ {
1684
+ "name": "preset",
1685
+ "required": false,
1686
+ "kind": "string",
1687
+ "placeholder": "<preset>"
1688
+ },
1689
+ {
1690
+ "name": "axes",
1691
+ "required": false,
1692
+ "kind": "object",
1693
+ "placeholder": "{}"
1694
+ },
1695
+ {
1696
+ "name": "budgets",
1697
+ "required": false,
1698
+ "kind": "object",
1699
+ "placeholder": "{\"onTrip\":\"pause\",\"team\":{},\"mission\":{},\"member\":{}}"
1700
+ },
1701
+ {
1702
+ "name": "resources",
1703
+ "required": false,
1704
+ "kind": "object",
1705
+ "placeholder": "{\"repos\":[]}"
1706
+ },
1707
+ {
1708
+ "name": "kit",
1709
+ "required": false,
1710
+ "kind": "object",
1711
+ "placeholder": "{\"addons\":{}}"
1712
+ },
1713
+ {
1714
+ "name": "clientKey",
1715
+ "required": false,
1716
+ "kind": "string",
1717
+ "placeholder": "<clientKey>"
1718
+ }
1719
+ ],
1720
+ "watchable": false,
1721
+ "help": {
1722
+ "command": "ora autopilot teams create --file run.json",
1723
+ "body": "{\n \"name\": \"<name>\",\n \"members\": []\n}"
1724
+ }
1725
+ },
1726
+ {
1727
+ "id": "autopilot.teams.feed",
1728
+ "commandPath": [
1729
+ "autopilot",
1730
+ "teams",
1731
+ "feed"
1732
+ ],
1733
+ "method": "get",
1734
+ "pathTemplate": "/experiment/v1/autopilot/teams/stream",
1735
+ "summary": "SSE: the organization's coarse team state (status, mission counts, budget), a snapshot then live frames",
1736
+ "scope": "autopilot:read",
1737
+ "product": "experiment",
1738
+ "pathParams": [],
1739
+ "queryParams": [],
1740
+ "hasBody": false,
1741
+ "bodyRequired": false,
1742
+ "isStream": true,
1743
+ "watchable": false,
1744
+ "help": {
1745
+ "command": "ora autopilot teams feed"
1746
+ }
1747
+ },
1748
+ {
1749
+ "id": "autopilot.teams.get",
1750
+ "commandPath": [
1751
+ "autopilot",
1752
+ "teams",
1753
+ "get"
1754
+ ],
1755
+ "method": "get",
1756
+ "pathTemplate": "/experiment/v1/autopilot/teams/{team}",
1757
+ "summary": "Get a team: roster, squads, non-terminal missions, counters",
1758
+ "scope": "autopilot:read",
1759
+ "product": "experiment",
1760
+ "pathParams": [
1761
+ {
1762
+ "name": "team"
1763
+ }
1764
+ ],
1765
+ "queryParams": [],
1766
+ "hasBody": false,
1767
+ "bodyRequired": false,
1768
+ "isStream": false,
1769
+ "watchable": false,
1770
+ "help": {
1771
+ "command": "ora autopilot teams get <team>"
1772
+ }
1773
+ },
1774
+ {
1775
+ "id": "autopilot.teams.list",
1776
+ "commandPath": [
1777
+ "autopilot",
1778
+ "teams",
1779
+ "list"
1780
+ ],
1781
+ "method": "get",
1782
+ "pathTemplate": "/experiment/v1/autopilot/teams",
1783
+ "summary": "List the organization's teams with coarse state",
1784
+ "scope": "autopilot:read",
1785
+ "product": "experiment",
1786
+ "pathParams": [],
1787
+ "queryParams": [
1788
+ {
1789
+ "name": "cursor",
1790
+ "flag": "cursor",
1791
+ "optionKey": "cursor",
1792
+ "required": false,
1793
+ "kind": "string"
1794
+ },
1795
+ {
1796
+ "name": "limit",
1797
+ "flag": "limit",
1798
+ "optionKey": "limit",
1799
+ "required": false,
1800
+ "kind": "number"
1801
+ },
1802
+ {
1803
+ "name": "status",
1804
+ "flag": "status",
1805
+ "optionKey": "status",
1806
+ "required": false,
1807
+ "kind": "string",
1808
+ "enum": [
1809
+ "active",
1810
+ "pausing",
1811
+ "paused",
1812
+ "stopping",
1813
+ "stopped",
1814
+ "archived"
1815
+ ]
1816
+ }
1817
+ ],
1818
+ "hasBody": false,
1819
+ "bodyRequired": false,
1820
+ "isStream": false,
1821
+ "watchable": false,
1822
+ "help": {
1823
+ "command": "ora autopilot teams list"
1824
+ }
1825
+ },
1826
+ {
1827
+ "id": "autopilot.teams.pause",
1828
+ "commandPath": [
1829
+ "autopilot",
1830
+ "teams",
1831
+ "pause"
1832
+ ],
1833
+ "method": "post",
1834
+ "pathTemplate": "/experiment/v1/autopilot/teams/{team}/pause",
1835
+ "summary": "Pause every active mission and close admission",
1836
+ "scope": "autopilot:write",
1837
+ "product": "experiment",
1838
+ "pathParams": [
1839
+ {
1840
+ "name": "team"
1841
+ }
1842
+ ],
1843
+ "queryParams": [
1844
+ {
1845
+ "name": "mode",
1846
+ "flag": "mode",
1847
+ "optionKey": "mode",
1848
+ "required": false,
1849
+ "kind": "string",
1850
+ "enum": [
1851
+ "graceful",
1852
+ "immediate"
1853
+ ]
1854
+ }
1855
+ ],
1856
+ "hasBody": false,
1857
+ "bodyRequired": false,
1858
+ "isStream": false,
1859
+ "watchable": true,
1860
+ "help": {
1861
+ "command": "ora autopilot teams pause <team> --watch"
1862
+ }
1863
+ },
1864
+ {
1865
+ "id": "autopilot.teams.resume",
1866
+ "commandPath": [
1867
+ "autopilot",
1868
+ "teams",
1869
+ "resume"
1870
+ ],
1871
+ "method": "post",
1872
+ "pathTemplate": "/experiment/v1/autopilot/teams/{team}/resume",
1873
+ "summary": "Resume a paused team, or re-open admission on a stopped one",
1874
+ "scope": "autopilot:write",
1875
+ "product": "experiment",
1876
+ "pathParams": [
1877
+ {
1878
+ "name": "team"
1879
+ }
1880
+ ],
1881
+ "queryParams": [],
1882
+ "hasBody": false,
1883
+ "bodyRequired": false,
1884
+ "isStream": false,
1885
+ "watchable": true,
1886
+ "help": {
1887
+ "command": "ora autopilot teams resume <team> --watch"
1888
+ }
1889
+ },
1890
+ {
1891
+ "id": "autopilot.teams.stop",
1892
+ "commandPath": [
1893
+ "autopilot",
1894
+ "teams",
1895
+ "stop"
1896
+ ],
1897
+ "method": "post",
1898
+ "pathTemplate": "/experiment/v1/autopilot/teams/{team}/stop",
1899
+ "summary": "Stop every non-terminal mission",
1900
+ "scope": "autopilot:write",
1901
+ "product": "experiment",
1902
+ "pathParams": [
1903
+ {
1904
+ "name": "team"
1905
+ }
1906
+ ],
1907
+ "queryParams": [
1908
+ {
1909
+ "name": "mode",
1910
+ "flag": "mode",
1911
+ "optionKey": "mode",
1912
+ "required": false,
1913
+ "kind": "string",
1914
+ "enum": [
1915
+ "graceful",
1916
+ "immediate"
1917
+ ]
1918
+ }
1919
+ ],
1920
+ "hasBody": false,
1921
+ "bodyRequired": false,
1922
+ "isStream": false,
1923
+ "watchable": true,
1924
+ "help": {
1925
+ "command": "ora autopilot teams stop <team> --watch"
1926
+ }
1927
+ },
1928
+ {
1929
+ "id": "autopilot.teams.stream",
1930
+ "commandPath": [
1931
+ "autopilot",
1932
+ "teams",
1933
+ "stream"
1934
+ ],
1935
+ "method": "get",
1936
+ "pathTemplate": "/experiment/v1/autopilot/teams/{team}/stream",
1937
+ "summary": "SSE: replay the team log after `after` (≤ 1,000 events), then tail it live; optionally scoped to a mission, message or export",
1938
+ "scope": "autopilot:read",
1939
+ "product": "experiment",
1940
+ "pathParams": [
1941
+ {
1942
+ "name": "team"
1943
+ }
1944
+ ],
1945
+ "queryParams": [
1946
+ {
1947
+ "name": "after",
1948
+ "flag": "after",
1949
+ "optionKey": "after",
1950
+ "required": false,
1951
+ "kind": "number"
1952
+ },
1953
+ {
1954
+ "name": "missionId",
1955
+ "flag": "mission-id",
1956
+ "optionKey": "missionId",
1957
+ "required": false,
1958
+ "kind": "string"
1959
+ },
1960
+ {
1961
+ "name": "messageId",
1962
+ "flag": "message-id",
1963
+ "optionKey": "messageId",
1964
+ "required": false,
1965
+ "kind": "string"
1966
+ },
1967
+ {
1968
+ "name": "exportId",
1969
+ "flag": "export-id",
1970
+ "optionKey": "exportId",
1971
+ "required": false,
1972
+ "kind": "string"
1973
+ },
1974
+ {
1975
+ "name": "until",
1976
+ "flag": "until",
1977
+ "optionKey": "until",
1978
+ "required": false,
1979
+ "kind": "string",
1980
+ "enum": [
1981
+ "settled",
1982
+ "paused",
1983
+ "resumed",
1984
+ "stopped"
1985
+ ]
1986
+ }
1987
+ ],
1988
+ "hasBody": false,
1989
+ "bodyRequired": false,
1990
+ "isStream": true,
1991
+ "watchable": false,
1992
+ "help": {
1993
+ "command": "ora autopilot teams stream <team>"
1994
+ }
1995
+ },
1996
+ {
1997
+ "id": "autopilot.teams.update",
1998
+ "commandPath": [
1999
+ "autopilot",
2000
+ "teams",
2001
+ "update"
2002
+ ],
2003
+ "method": "patch",
2004
+ "pathTemplate": "/experiment/v1/autopilot/teams/{team}",
2005
+ "summary": "Patch a team's name, research use, positions, preset, axes, budgets, resources or kit",
2006
+ "scope": "autopilot:write",
2007
+ "product": "experiment",
2008
+ "pathParams": [
2009
+ {
2010
+ "name": "team"
2011
+ }
2012
+ ],
2013
+ "queryParams": [],
2014
+ "hasBody": true,
2015
+ "bodyRequired": true,
2016
+ "isStream": false,
2017
+ "bodyFields": [
2018
+ {
2019
+ "name": "name",
2020
+ "required": false,
2021
+ "kind": "string",
2022
+ "placeholder": "<name>"
2023
+ },
2024
+ {
2025
+ "name": "researchUse",
2026
+ "required": false,
2027
+ "kind": "string",
2028
+ "enum": [
2029
+ "internal_only",
2030
+ "publishable_after_review",
2031
+ "excluded"
2032
+ ],
2033
+ "placeholder": "internal_only"
2034
+ },
2035
+ {
2036
+ "name": "positions",
2037
+ "required": false,
2038
+ "kind": "array",
2039
+ "placeholder": "[]"
2040
+ },
2041
+ {
2042
+ "name": "preset",
2043
+ "required": false,
2044
+ "kind": "string",
2045
+ "placeholder": "<preset>"
2046
+ },
2047
+ {
2048
+ "name": "axes",
180
2049
  "required": false,
181
- "kind": "string"
2050
+ "kind": "object",
2051
+ "placeholder": "{}"
182
2052
  },
183
2053
  {
184
- "name": "intents",
185
- "flag": "intents",
186
- "optionKey": "intents",
2054
+ "name": "budgets",
187
2055
  "required": false,
188
- "kind": "string"
2056
+ "kind": "object",
2057
+ "placeholder": "{}"
189
2058
  },
190
2059
  {
191
- "name": "models",
192
- "flag": "models",
193
- "optionKey": "models",
2060
+ "name": "resources",
194
2061
  "required": false,
195
- "kind": "string"
2062
+ "kind": "object",
2063
+ "placeholder": "{}"
196
2064
  },
197
2065
  {
198
- "name": "layers",
199
- "flag": "layers",
200
- "optionKey": "layers",
2066
+ "name": "kit",
201
2067
  "required": false,
202
- "kind": "string"
2068
+ "kind": "object",
2069
+ "placeholder": "{}"
203
2070
  }
204
2071
  ],
205
- "hasBody": false,
206
- "bodyRequired": false,
207
- "isStream": false,
208
2072
  "watchable": false,
209
2073
  "help": {
210
- "command": "ora analytics overview"
2074
+ "command": "ora autopilot teams update <team> --file run.json",
2075
+ "body": "{\n \"name\": \"<name>\",\n \"researchUse\": \"internal_only\",\n \"positions\": []\n}"
211
2076
  }
212
2077
  },
213
2078
  {
@@ -599,7 +2464,7 @@ export const OPERATIONS = [
599
2464
  ],
600
2465
  "method": "post",
601
2466
  "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.",
2467
+ "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
2468
  "scope": "benchmarks:write",
604
2469
  "product": "experiment",
605
2470
  "pathParams": [
@@ -629,8 +2494,15 @@ export const OPERATIONS = [
629
2494
  "link",
630
2495
  "public"
631
2496
  ],
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.",
2497
+ "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
2498
  "placeholder": "private"
2499
+ },
2500
+ {
2501
+ "name": "expectPublished",
2502
+ "required": false,
2503
+ "kind": "boolean",
2504
+ "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.",
2505
+ "placeholder": "true"
634
2506
  }
635
2507
  ],
636
2508
  "watchable": false,
@@ -647,7 +2519,7 @@ export const OPERATIONS = [
647
2519
  ],
648
2520
  "method": "post",
649
2521
  "pathTemplate": "/experiment/v1/benchmarks/{id}/exec-summary",
650
- "summary": "Regenerate the executive summary from the current aggregate (async; poll get)",
2522
+ "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
2523
  "scope": "benchmarks:write",
652
2524
  "product": "experiment",
653
2525
  "pathParams": [
@@ -1336,20 +3208,10 @@ export const OPERATIONS = [
1336
3208
  "kind": "object",
1337
3209
  "placeholder": "{}"
1338
3210
  },
1339
- {
1340
- "name": "engine",
1341
- "required": false,
1342
- "kind": "string",
1343
- "placeholder": "<engine>"
1344
- },
1345
3211
  {
1346
3212
  "name": "execution_kind",
1347
3213
  "required": false,
1348
3214
  "kind": "string",
1349
- "enum": [
1350
- "harness",
1351
- "direct"
1352
- ],
1353
3215
  "placeholder": "harness"
1354
3216
  },
1355
3217
  {
@@ -1385,12 +3247,6 @@ export const OPERATIONS = [
1385
3247
  "required": false,
1386
3248
  "kind": "object",
1387
3249
  "placeholder": "{}"
1388
- },
1389
- {
1390
- "name": "wait",
1391
- "required": false,
1392
- "kind": "boolean",
1393
- "placeholder": "true"
1394
3250
  }
1395
3251
  ],
1396
3252
  "watchable": true,
@@ -1399,32 +3255,6 @@ export const OPERATIONS = [
1399
3255
  "body": "{\n \"intent\": \"check pricing for acme.com\",\n \"harness\": \"eve\",\n \"model\": \"claude-sonnet-5\"\n}"
1400
3256
  }
1401
3257
  },
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
3258
  {
1429
3259
  "id": "experiment.runs.feed",
1430
3260
  "commandPath": [
@@ -1768,17 +3598,235 @@ export const OPERATIONS = [
1768
3598
  }
1769
3599
  },
1770
3600
  {
1771
- "id": "experiment.skills.delete",
3601
+ "id": "experiment.skills.delete",
3602
+ "commandPath": [
3603
+ "experiment",
3604
+ "skills",
3605
+ "delete"
3606
+ ],
3607
+ "method": "delete",
3608
+ "pathTemplate": "/experiment/v1/skills/{id}",
3609
+ "summary": "Delete a skill",
3610
+ "scope": "skills:write",
3611
+ "product": "platform",
3612
+ "pathParams": [
3613
+ {
3614
+ "name": "id"
3615
+ }
3616
+ ],
3617
+ "queryParams": [],
3618
+ "hasBody": false,
3619
+ "bodyRequired": false,
3620
+ "isStream": false,
3621
+ "watchable": false,
3622
+ "help": {
3623
+ "command": "ora experiment skills delete <id>"
3624
+ }
3625
+ },
3626
+ {
3627
+ "id": "experiment.skills.list",
3628
+ "commandPath": [
3629
+ "experiment",
3630
+ "skills",
3631
+ "list"
3632
+ ],
3633
+ "method": "get",
3634
+ "pathTemplate": "/experiment/v1/skills",
3635
+ "summary": "List the caller's usable skills catalog",
3636
+ "scope": "skills:read",
3637
+ "product": "platform",
3638
+ "pathParams": [],
3639
+ "queryParams": [],
3640
+ "hasBody": false,
3641
+ "bodyRequired": false,
3642
+ "isStream": false,
3643
+ "watchable": false,
3644
+ "help": {
3645
+ "command": "ora experiment skills list"
3646
+ }
3647
+ },
3648
+ {
3649
+ "id": "experiment.skills.update",
3650
+ "commandPath": [
3651
+ "experiment",
3652
+ "skills",
3653
+ "update"
3654
+ ],
3655
+ "method": "put",
3656
+ "pathTemplate": "/experiment/v1/skills/{id}",
3657
+ "summary": "Update a skill",
3658
+ "scope": "skills:write",
3659
+ "product": "platform",
3660
+ "pathParams": [
3661
+ {
3662
+ "name": "id"
3663
+ }
3664
+ ],
3665
+ "queryParams": [],
3666
+ "hasBody": true,
3667
+ "bodyRequired": true,
3668
+ "isStream": false,
3669
+ "bodyFields": [
3670
+ {
3671
+ "name": "name",
3672
+ "required": false,
3673
+ "kind": "string",
3674
+ "placeholder": "<name>"
3675
+ },
3676
+ {
3677
+ "name": "visibility",
3678
+ "required": false,
3679
+ "kind": "string",
3680
+ "enum": [
3681
+ "user",
3682
+ "org"
3683
+ ],
3684
+ "placeholder": "user"
3685
+ },
3686
+ {
3687
+ "name": "body",
3688
+ "required": false,
3689
+ "kind": "string",
3690
+ "placeholder": "<body>"
3691
+ },
3692
+ {
3693
+ "name": "repoUrl",
3694
+ "required": false,
3695
+ "kind": "string",
3696
+ "placeholder": "<repoUrl>"
3697
+ },
3698
+ {
3699
+ "name": "gitRef",
3700
+ "required": false,
3701
+ "kind": "string",
3702
+ "placeholder": "<gitRef>"
3703
+ },
3704
+ {
3705
+ "name": "subpath",
3706
+ "required": false,
3707
+ "kind": "string",
3708
+ "placeholder": "<subpath>"
3709
+ }
3710
+ ],
3711
+ "watchable": false,
3712
+ "help": {
3713
+ "command": "ora experiment skills update <id> --file run.json",
3714
+ "body": "{\n \"name\": \"<name>\",\n \"visibility\": \"user\",\n \"body\": \"<body>\"\n}"
3715
+ }
3716
+ },
3717
+ {
3718
+ "id": "goals.create",
3719
+ "commandPath": [
3720
+ "goals",
3721
+ "create"
3722
+ ],
3723
+ "method": "post",
3724
+ "pathTemplate": "/studio/v1/intents/{id}/goals",
3725
+ "summary": "Add a goal to an intent. An answer_check goal is an answer criterion: give its criterionGroup, the question type it is checked on (discover, choose, verify, inform, guide, act); without one, Ora files it under a type",
3726
+ "scope": "intents:write",
3727
+ "product": "studio",
3728
+ "pathParams": [
3729
+ {
3730
+ "name": "id"
3731
+ }
3732
+ ],
3733
+ "queryParams": [],
3734
+ "hasBody": true,
3735
+ "bodyRequired": true,
3736
+ "isStream": false,
3737
+ "bodyFields": [
3738
+ {
3739
+ "name": "kind",
3740
+ "required": true,
3741
+ "kind": "string",
3742
+ "enum": [
3743
+ "target_match",
3744
+ "state_assertion",
3745
+ "answer_check"
3746
+ ],
3747
+ "placeholder": "answer_check"
3748
+ },
3749
+ {
3750
+ "name": "criterionGroup",
3751
+ "required": false,
3752
+ "kind": "string",
3753
+ "enum": [
3754
+ "discover",
3755
+ "choose",
3756
+ "verify",
3757
+ "inform",
3758
+ "guide",
3759
+ "act"
3760
+ ],
3761
+ "placeholder": "choose"
3762
+ },
3763
+ {
3764
+ "name": "title",
3765
+ "required": true,
3766
+ "kind": "string",
3767
+ "placeholder": "Acme DB is the first pick"
3768
+ },
3769
+ {
3770
+ "name": "statement",
3771
+ "required": false,
3772
+ "kind": "string",
3773
+ "placeholder": "The answer recommends Acme DB as its first option for hosting the database."
3774
+ },
3775
+ {
3776
+ "name": "config",
3777
+ "required": false,
3778
+ "kind": "string",
3779
+ "placeholder": "<config>"
3780
+ },
3781
+ {
3782
+ "name": "isActive",
3783
+ "required": false,
3784
+ "kind": "boolean",
3785
+ "placeholder": "true"
3786
+ }
3787
+ ],
3788
+ "watchable": false,
3789
+ "help": {
3790
+ "command": "ora goals create <id> --file run.json",
3791
+ "body": "{\n \"kind\": \"answer_check\",\n \"title\": \"Acme DB is the first pick\",\n \"statement\": \"The answer recommends Acme DB as its first option for hosting the database.\",\n \"criterionGroup\": \"choose\"\n}"
3792
+ }
3793
+ },
3794
+ {
3795
+ "id": "goals.delete",
3796
+ "commandPath": [
3797
+ "goals",
3798
+ "delete"
3799
+ ],
3800
+ "method": "delete",
3801
+ "pathTemplate": "/studio/v1/goals/{goalId}",
3802
+ "summary": "Deactivate a goal (soft delete: isActive=false)",
3803
+ "scope": "intents:write",
3804
+ "product": "studio",
3805
+ "pathParams": [
3806
+ {
3807
+ "name": "goalId"
3808
+ }
3809
+ ],
3810
+ "queryParams": [],
3811
+ "hasBody": false,
3812
+ "bodyRequired": false,
3813
+ "isStream": false,
3814
+ "watchable": false,
3815
+ "help": {
3816
+ "command": "ora goals delete <goalId>"
3817
+ }
3818
+ },
3819
+ {
3820
+ "id": "goals.list",
1772
3821
  "commandPath": [
1773
- "experiment",
1774
- "skills",
1775
- "delete"
3822
+ "goals",
3823
+ "list"
1776
3824
  ],
1777
- "method": "delete",
1778
- "pathTemplate": "/experiment/v1/skills/{id}",
1779
- "summary": "Delete a skill",
1780
- "scope": "skills:write",
1781
- "product": "platform",
3825
+ "method": "get",
3826
+ "pathTemplate": "/studio/v1/intents/{id}/goals",
3827
+ "summary": "List an intent's goals, disabled ones included (filter on isActive for the live set)",
3828
+ "scope": "intents:read",
3829
+ "product": "studio",
1782
3830
  "pathParams": [
1783
3831
  {
1784
3832
  "name": "id"
@@ -1790,46 +3838,61 @@ export const OPERATIONS = [
1790
3838
  "isStream": false,
1791
3839
  "watchable": false,
1792
3840
  "help": {
1793
- "command": "ora experiment skills delete <id>"
3841
+ "command": "ora goals list <id>"
1794
3842
  }
1795
3843
  },
1796
3844
  {
1797
- "id": "experiment.skills.list",
3845
+ "id": "goals.report",
1798
3846
  "commandPath": [
1799
- "experiment",
1800
- "skills",
1801
- "list"
3847
+ "goals",
3848
+ "report"
1802
3849
  ],
1803
3850
  "method": "get",
1804
- "pathTemplate": "/experiment/v1/skills",
1805
- "summary": "List the caller's usable skills catalog",
1806
- "scope": "skills:read",
1807
- "product": "platform",
1808
- "pathParams": [],
1809
- "queryParams": [],
3851
+ "pathTemplate": "/studio/v1/intents/{id}/goal-report",
3852
+ "summary": "The results of an intent's measurements. Each goal's verdicts over a window (live goals, plus any retired goal judged in it) and its met rate: met ÷ scored, where scored is met + partial + not_met (unobservable runs are not scored). `criteria` compares the latest finished measurement with the one before it: per question type (discover, choose, verify, inform, guide, act) and per criterion, how many judged answers passed, and per agent for the latest; `scores` averages each run's criteria passed ÷ judged, overall and per question type; `grid` breaks the latest finished measurement down by prompt × agent; `links.studio` opens it in Studio",
3853
+ "scope": "intents:read",
3854
+ "product": "studio",
3855
+ "pathParams": [
3856
+ {
3857
+ "name": "id"
3858
+ }
3859
+ ],
3860
+ "queryParams": [
3861
+ {
3862
+ "name": "window",
3863
+ "flag": "window",
3864
+ "optionKey": "window",
3865
+ "required": false,
3866
+ "kind": "string",
3867
+ "enum": [
3868
+ "7d",
3869
+ "30d",
3870
+ "90d"
3871
+ ]
3872
+ }
3873
+ ],
1810
3874
  "hasBody": false,
1811
3875
  "bodyRequired": false,
1812
3876
  "isStream": false,
1813
3877
  "watchable": false,
1814
3878
  "help": {
1815
- "command": "ora experiment skills list"
3879
+ "command": "ora goals report <id>"
1816
3880
  }
1817
3881
  },
1818
3882
  {
1819
- "id": "experiment.skills.update",
3883
+ "id": "goals.update",
1820
3884
  "commandPath": [
1821
- "experiment",
1822
- "skills",
3885
+ "goals",
1823
3886
  "update"
1824
3887
  ],
1825
- "method": "put",
1826
- "pathTemplate": "/experiment/v1/skills/{id}",
1827
- "summary": "Update a skill",
1828
- "scope": "skills:write",
1829
- "product": "platform",
3888
+ "method": "patch",
3889
+ "pathTemplate": "/studio/v1/goals/{goalId}",
3890
+ "summary": "Edit a goal's title, statement, config, or active flag",
3891
+ "scope": "intents:write",
3892
+ "product": "studio",
1830
3893
  "pathParams": [
1831
3894
  {
1832
- "name": "id"
3895
+ "name": "goalId"
1833
3896
  }
1834
3897
  ],
1835
3898
  "queryParams": [],
@@ -1838,50 +3901,34 @@ export const OPERATIONS = [
1838
3901
  "isStream": false,
1839
3902
  "bodyFields": [
1840
3903
  {
1841
- "name": "name",
1842
- "required": false,
1843
- "kind": "string",
1844
- "placeholder": "<name>"
1845
- },
1846
- {
1847
- "name": "visibility",
1848
- "required": false,
1849
- "kind": "string",
1850
- "enum": [
1851
- "user",
1852
- "org"
1853
- ],
1854
- "placeholder": "user"
1855
- },
1856
- {
1857
- "name": "body",
3904
+ "name": "title",
1858
3905
  "required": false,
1859
3906
  "kind": "string",
1860
- "placeholder": "<body>"
3907
+ "placeholder": "<title>"
1861
3908
  },
1862
3909
  {
1863
- "name": "repoUrl",
3910
+ "name": "statement",
1864
3911
  "required": false,
1865
3912
  "kind": "string",
1866
- "placeholder": "<repoUrl>"
3913
+ "placeholder": "<statement>"
1867
3914
  },
1868
3915
  {
1869
- "name": "gitRef",
3916
+ "name": "isActive",
1870
3917
  "required": false,
1871
- "kind": "string",
1872
- "placeholder": "<gitRef>"
3918
+ "kind": "boolean",
3919
+ "placeholder": "true"
1873
3920
  },
1874
3921
  {
1875
- "name": "subpath",
3922
+ "name": "config",
1876
3923
  "required": false,
1877
3924
  "kind": "string",
1878
- "placeholder": "<subpath>"
3925
+ "placeholder": "<config>"
1879
3926
  }
1880
3927
  ],
1881
3928
  "watchable": false,
1882
3929
  "help": {
1883
- "command": "ora experiment skills update <id> --file run.json",
1884
- "body": "{\n \"name\": \"<name>\",\n \"visibility\": \"user\",\n \"body\": \"<body>\"\n}"
3930
+ "command": "ora goals update <goalId> --file run.json",
3931
+ "body": "{\n \"title\": \"<title>\",\n \"statement\": \"<statement>\",\n \"isActive\": true\n}"
1885
3932
  }
1886
3933
  },
1887
3934
  {
@@ -2022,6 +4069,12 @@ export const OPERATIONS = [
2022
4069
  "bodyRequired": true,
2023
4070
  "isStream": false,
2024
4071
  "bodyFields": [
4072
+ {
4073
+ "name": "startMeasurement",
4074
+ "required": false,
4075
+ "kind": "boolean",
4076
+ "placeholder": "true"
4077
+ },
2025
4078
  {
2026
4079
  "name": "text",
2027
4080
  "required": true,
@@ -2057,6 +4110,44 @@ export const OPERATIONS = [
2057
4110
  "body": "{\n \"text\": \"<text>\"\n}"
2058
4111
  }
2059
4112
  },
4113
+ {
4114
+ "id": "intents.analytics",
4115
+ "commandPath": [
4116
+ "intents",
4117
+ "analytics"
4118
+ ],
4119
+ "method": "get",
4120
+ "pathTemplate": "/studio/v1/intents/{id}/analytics-summary",
4121
+ "summary": "The intent's analytics over a window, short: each layer's healthy runs (discovery, access, use), positioning per question type (yes / depends / no / none; read rates over the non-none answers), per-agent rates (visible, recommended, cited), how often you and the top competitors were recommended or only mentioned, and the top cited sources",
4122
+ "scope": "intents:read",
4123
+ "product": "studio",
4124
+ "pathParams": [
4125
+ {
4126
+ "name": "id"
4127
+ }
4128
+ ],
4129
+ "queryParams": [
4130
+ {
4131
+ "name": "window",
4132
+ "flag": "window",
4133
+ "optionKey": "window",
4134
+ "required": false,
4135
+ "kind": "string",
4136
+ "enum": [
4137
+ "7d",
4138
+ "30d",
4139
+ "90d"
4140
+ ]
4141
+ }
4142
+ ],
4143
+ "hasBody": false,
4144
+ "bodyRequired": false,
4145
+ "isStream": false,
4146
+ "watchable": false,
4147
+ "help": {
4148
+ "command": "ora intents analytics <id>"
4149
+ }
4150
+ },
2060
4151
  {
2061
4152
  "id": "intents.bulkAction",
2062
4153
  "commandPath": [
@@ -2121,7 +4212,8 @@ export const OPERATIONS = [
2121
4212
  "kind": "string",
2122
4213
  "enum": [
2123
4214
  "csv",
2124
- "manual"
4215
+ "manual",
4216
+ "generated"
2125
4217
  ],
2126
4218
  "placeholder": "csv"
2127
4219
  },
@@ -2209,20 +4301,148 @@ export const OPERATIONS = [
2209
4301
  ],
2210
4302
  "watchable": false,
2211
4303
  "help": {
2212
- "command": "ora intents create --file run.json",
2213
- "body": "{\n \"title\": \"Best AEO platform for B2B SaaS\",\n \"layer\": \"discovery\"\n}"
4304
+ "command": "ora intents create --file run.json",
4305
+ "body": "{\n \"title\": \"Best AEO platform for B2B SaaS\",\n \"layer\": \"discovery\"\n}"
4306
+ }
4307
+ },
4308
+ {
4309
+ "id": "intents.delete",
4310
+ "commandPath": [
4311
+ "intents",
4312
+ "delete"
4313
+ ],
4314
+ "method": "delete",
4315
+ "pathTemplate": "/studio/v1/intents/{id}",
4316
+ "summary": "Soft-delete an intent and its prompts",
4317
+ "scope": "intents:write",
4318
+ "product": "studio",
4319
+ "pathParams": [
4320
+ {
4321
+ "name": "id"
4322
+ }
4323
+ ],
4324
+ "queryParams": [],
4325
+ "hasBody": false,
4326
+ "bodyRequired": false,
4327
+ "isStream": false,
4328
+ "watchable": false,
4329
+ "help": {
4330
+ "command": "ora intents delete <id>"
4331
+ }
4332
+ },
4333
+ {
4334
+ "id": "intents.deletePrompt",
4335
+ "commandPath": [
4336
+ "intents",
4337
+ "delete-prompt"
4338
+ ],
4339
+ "method": "delete",
4340
+ "pathTemplate": "/studio/v1/intents/{id}/prompts/{promptId}",
4341
+ "summary": "Soft-delete a prompt",
4342
+ "scope": "intents:write",
4343
+ "product": "studio",
4344
+ "pathParams": [
4345
+ {
4346
+ "name": "id"
4347
+ },
4348
+ {
4349
+ "name": "promptId"
4350
+ }
4351
+ ],
4352
+ "queryParams": [],
4353
+ "hasBody": false,
4354
+ "bodyRequired": false,
4355
+ "isStream": false,
4356
+ "watchable": false,
4357
+ "help": {
4358
+ "command": "ora intents delete-prompt <id> <promptId>"
4359
+ }
4360
+ },
4361
+ {
4362
+ "id": "intents.generate",
4363
+ "commandPath": [
4364
+ "intents",
4365
+ "generate"
4366
+ ],
4367
+ "method": "post",
4368
+ "pathTemplate": "/studio/v1/intents/{id}/generate",
4369
+ "summary": "Generate and persist prompts for an intent via its layer strategy",
4370
+ "scope": "intents:write",
4371
+ "product": "studio",
4372
+ "pathParams": [
4373
+ {
4374
+ "name": "id"
4375
+ }
4376
+ ],
4377
+ "queryParams": [],
4378
+ "hasBody": false,
4379
+ "bodyRequired": false,
4380
+ "isStream": false,
4381
+ "watchable": false,
4382
+ "help": {
4383
+ "command": "ora intents generate <id>"
4384
+ }
4385
+ },
4386
+ {
4387
+ "id": "intents.get",
4388
+ "commandPath": [
4389
+ "intents",
4390
+ "get"
4391
+ ],
4392
+ "method": "get",
4393
+ "pathTemplate": "/studio/v1/intents/{id}",
4394
+ "summary": "Read one intent, its prompts, and its computed metrics",
4395
+ "scope": "intents:read",
4396
+ "product": "studio",
4397
+ "pathParams": [
4398
+ {
4399
+ "name": "id"
4400
+ }
4401
+ ],
4402
+ "queryParams": [],
4403
+ "hasBody": false,
4404
+ "bodyRequired": false,
4405
+ "isStream": false,
4406
+ "watchable": false,
4407
+ "help": {
4408
+ "command": "ora intents get <id>"
4409
+ }
4410
+ },
4411
+ {
4412
+ "id": "intents.history",
4413
+ "commandPath": [
4414
+ "intents",
4415
+ "history"
4416
+ ],
4417
+ "method": "get",
4418
+ "pathTemplate": "/studio/v1/intents/{id}/history",
4419
+ "summary": "The intent's measurements, newest first (last 90 days): when, runs, the discovery / access / use rates, and the answer score, to compare each measurement with the ones before",
4420
+ "scope": "intents:read",
4421
+ "product": "studio",
4422
+ "pathParams": [
4423
+ {
4424
+ "name": "id"
4425
+ }
4426
+ ],
4427
+ "queryParams": [],
4428
+ "hasBody": false,
4429
+ "bodyRequired": false,
4430
+ "isStream": false,
4431
+ "watchable": false,
4432
+ "help": {
4433
+ "command": "ora intents history <id>"
2214
4434
  }
2215
4435
  },
2216
4436
  {
2217
- "id": "intents.delete",
4437
+ "id": "intents.insights",
2218
4438
  "commandPath": [
2219
4439
  "intents",
2220
- "delete"
4440
+ "insights"
2221
4441
  ],
2222
- "method": "delete",
2223
- "pathTemplate": "/studio/v1/intents/{id}",
2224
- "summary": "Soft-delete an intent and its prompts",
2225
- "scope": "intents:write",
4442
+ "method": "get",
4443
+ "pathTemplate": "/studio/v1/intents/{id}/insights",
4444
+ "summary": "Why the intent loses and what to fix, for its latest finished measurement: issues with evidence and a recommendation, the customer's pages that failed (status, cause), how the agents used the MCP / API tools (failed calls and why, repeats, tool-description issues), and what each agent said (verdict, quote, failed checks with the judge's reason and quote). Sized for an agent to read in one go",
4445
+ "scope": "intents:read",
2226
4446
  "product": "studio",
2227
4447
  "pathParams": [
2228
4448
  {
@@ -2235,46 +4455,52 @@ export const OPERATIONS = [
2235
4455
  "isStream": false,
2236
4456
  "watchable": false,
2237
4457
  "help": {
2238
- "command": "ora intents delete <id>"
4458
+ "command": "ora intents insights <id>"
2239
4459
  }
2240
4460
  },
2241
4461
  {
2242
- "id": "intents.deletePrompt",
4462
+ "id": "intents.list",
2243
4463
  "commandPath": [
2244
4464
  "intents",
2245
- "delete-prompt"
4465
+ "list"
2246
4466
  ],
2247
- "method": "delete",
2248
- "pathTemplate": "/studio/v1/intents/{id}/prompts/{promptId}",
2249
- "summary": "Soft-delete a prompt",
2250
- "scope": "intents:write",
4467
+ "method": "get",
4468
+ "pathTemplate": "/studio/v1/intents",
4469
+ "summary": "List the org's intents",
4470
+ "scope": "intents:read",
2251
4471
  "product": "studio",
2252
- "pathParams": [
2253
- {
2254
- "name": "id"
2255
- },
4472
+ "pathParams": [],
4473
+ "queryParams": [
2256
4474
  {
2257
- "name": "promptId"
4475
+ "name": "window",
4476
+ "flag": "window",
4477
+ "optionKey": "window",
4478
+ "required": false,
4479
+ "kind": "string",
4480
+ "enum": [
4481
+ "7d",
4482
+ "30d",
4483
+ "90d"
4484
+ ]
2258
4485
  }
2259
4486
  ],
2260
- "queryParams": [],
2261
4487
  "hasBody": false,
2262
4488
  "bodyRequired": false,
2263
4489
  "isStream": false,
2264
4490
  "watchable": false,
2265
4491
  "help": {
2266
- "command": "ora intents delete-prompt <id> <promptId>"
4492
+ "command": "ora intents list"
2267
4493
  }
2268
4494
  },
2269
4495
  {
2270
- "id": "intents.generate",
4496
+ "id": "intents.measure",
2271
4497
  "commandPath": [
2272
4498
  "intents",
2273
- "generate"
4499
+ "measure"
2274
4500
  ],
2275
4501
  "method": "post",
2276
- "pathTemplate": "/studio/v1/intents/{id}/generate",
2277
- "summary": "Generate and persist prompts for an intent via its layer strategy",
4502
+ "pathTemplate": "/studio/v1/intents/{id}/measure",
4503
+ "summary": "Measure an intent now: one measurement, one journey per active prompt across the intent's agents. Returns its measurementId (cycleId). Follow it live until it is done with intents.stream (CLI: add --watch), then read the results with goals.report (CLI: ora goals report <id>) and what to fix with intents.insights (CLI: ora intents insights <id>)",
2278
4504
  "scope": "intents:write",
2279
4505
  "product": "studio",
2280
4506
  "pathParams": [
@@ -2283,71 +4509,118 @@ export const OPERATIONS = [
2283
4509
  }
2284
4510
  ],
2285
4511
  "queryParams": [],
2286
- "hasBody": false,
2287
- "bodyRequired": false,
4512
+ "hasBody": true,
4513
+ "bodyRequired": true,
2288
4514
  "isStream": false,
2289
- "watchable": false,
4515
+ "bodyFields": [
4516
+ {
4517
+ "name": "kind",
4518
+ "required": false,
4519
+ "kind": "string",
4520
+ "enum": [
4521
+ "manual",
4522
+ "diagnostic",
4523
+ "verification"
4524
+ ],
4525
+ "placeholder": "manual"
4526
+ }
4527
+ ],
4528
+ "watchable": true,
2290
4529
  "help": {
2291
- "command": "ora intents generate <id>"
4530
+ "command": "ora intents measure <id> --file run.json --watch",
4531
+ "body": "{\n \"kind\": \"manual\"\n}"
2292
4532
  }
2293
4533
  },
2294
4534
  {
2295
- "id": "intents.get",
4535
+ "id": "intents.measureStatus",
2296
4536
  "commandPath": [
2297
4537
  "intents",
2298
- "get"
4538
+ "measure-status"
2299
4539
  ],
2300
4540
  "method": "get",
2301
- "pathTemplate": "/studio/v1/intents/{id}",
2302
- "summary": "Read one intent, its prompts, and its computed metrics",
4541
+ "pathTemplate": "/studio/v1/intents/{id}/measure/{measurementId}",
4542
+ "summary": "One measurement's progress, run by run: done once every run and its analysis has settled (status completed, partial or failed); runs.settled of runs.total so far. Follow it live instead of polling with intents.stream (CLI: add --watch); once done, read the results with goals.report (CLI: ora goals report <id>) and what to fix with intents.insights (CLI: ora intents insights <id>)",
2303
4543
  "scope": "intents:read",
2304
4544
  "product": "studio",
2305
4545
  "pathParams": [
2306
4546
  {
2307
4547
  "name": "id"
4548
+ },
4549
+ {
4550
+ "name": "measurementId"
2308
4551
  }
2309
4552
  ],
2310
4553
  "queryParams": [],
2311
4554
  "hasBody": false,
2312
4555
  "bodyRequired": false,
2313
4556
  "isStream": false,
2314
- "watchable": false,
4557
+ "watchable": true,
2315
4558
  "help": {
2316
- "command": "ora intents get <id>"
4559
+ "command": "ora intents measure-status <id> <measurementId> --watch"
2317
4560
  }
2318
4561
  },
2319
4562
  {
2320
- "id": "intents.list",
4563
+ "id": "intents.measurementPolicy",
2321
4564
  "commandPath": [
2322
4565
  "intents",
2323
- "list"
4566
+ "measurement-policy"
2324
4567
  ],
2325
- "method": "get",
2326
- "pathTemplate": "/studio/v1/intents",
2327
- "summary": "List the org's intents",
2328
- "scope": "intents:read",
4568
+ "method": "patch",
4569
+ "pathTemplate": "/studio/v1/intents/{id}/measurement-policy",
4570
+ "summary": "Change how an intent is measured: its schedule (cadence: daily, weekly, monthly or manual), the agents it runs (agents[], each with its own mcp_server_ids and skill_ids), and its competitors. Only the fields sent change; the triggers are re-scheduled",
4571
+ "scope": "intents:write",
2329
4572
  "product": "studio",
2330
- "pathParams": [],
2331
- "queryParams": [
4573
+ "pathParams": [
2332
4574
  {
2333
- "name": "window",
2334
- "flag": "window",
2335
- "optionKey": "window",
4575
+ "name": "id"
4576
+ }
4577
+ ],
4578
+ "queryParams": [],
4579
+ "hasBody": true,
4580
+ "bodyRequired": true,
4581
+ "isStream": false,
4582
+ "bodyFields": [
4583
+ {
4584
+ "name": "cadence",
2336
4585
  "required": false,
2337
4586
  "kind": "string",
2338
4587
  "enum": [
2339
- "7d",
2340
- "30d",
2341
- "90d"
2342
- ]
4588
+ "daily",
4589
+ "weekly",
4590
+ "monthly",
4591
+ "manual"
4592
+ ],
4593
+ "placeholder": "daily"
4594
+ },
4595
+ {
4596
+ "name": "mcp_server_ids",
4597
+ "required": false,
4598
+ "kind": "array",
4599
+ "placeholder": "[]"
4600
+ },
4601
+ {
4602
+ "name": "agents",
4603
+ "required": false,
4604
+ "kind": "array",
4605
+ "placeholder": "[]"
4606
+ },
4607
+ {
4608
+ "name": "skill_ids",
4609
+ "required": false,
4610
+ "kind": "array",
4611
+ "placeholder": "[]"
4612
+ },
4613
+ {
4614
+ "name": "competitors",
4615
+ "required": false,
4616
+ "kind": "array",
4617
+ "placeholder": "[]"
2343
4618
  }
2344
4619
  ],
2345
- "hasBody": false,
2346
- "bodyRequired": false,
2347
- "isStream": false,
2348
4620
  "watchable": false,
2349
4621
  "help": {
2350
- "command": "ora intents list"
4622
+ "command": "ora intents measurement-policy <id> --file run.json",
4623
+ "body": "{\n \"cadence\": \"daily\",\n \"mcp_server_ids\": [],\n \"agents\": []\n}"
2351
4624
  }
2352
4625
  },
2353
4626
  {
@@ -2587,6 +4860,31 @@ export const OPERATIONS = [
2587
4860
  "body": "{\n \"active\": true\n}"
2588
4861
  }
2589
4862
  },
4863
+ {
4864
+ "id": "intents.stream",
4865
+ "commandPath": [
4866
+ "intents",
4867
+ "stream"
4868
+ ],
4869
+ "method": "get",
4870
+ "pathTemplate": "/studio/v1/intents/{id}/stream",
4871
+ "summary": "Stream one intent's live activity (SSE): each run's progress and analysis, and a measurement event when a measurement finishes",
4872
+ "scope": "intents:read",
4873
+ "product": "studio",
4874
+ "pathParams": [
4875
+ {
4876
+ "name": "id"
4877
+ }
4878
+ ],
4879
+ "queryParams": [],
4880
+ "hasBody": false,
4881
+ "bodyRequired": false,
4882
+ "isStream": true,
4883
+ "watchable": false,
4884
+ "help": {
4885
+ "command": "ora intents stream <id>"
4886
+ }
4887
+ },
2590
4888
  {
2591
4889
  "id": "intents.update",
2592
4890
  "commandPath": [
@@ -3012,6 +5310,52 @@ export const OPERATIONS = [
3012
5310
  "command": "ora sessions wake <id>"
3013
5311
  }
3014
5312
  },
5313
+ {
5314
+ "id": "skills.get",
5315
+ "commandPath": [
5316
+ "skills",
5317
+ "get"
5318
+ ],
5319
+ "method": "get",
5320
+ "pathTemplate": "/studio/v1/agent-skills/{name}",
5321
+ "summary": "One Agent Skill's files (SKILL.md and its references), to install with `ora skills add <name>`",
5322
+ "scope": "intents:read",
5323
+ "product": "studio",
5324
+ "pathParams": [
5325
+ {
5326
+ "name": "name"
5327
+ }
5328
+ ],
5329
+ "queryParams": [],
5330
+ "hasBody": false,
5331
+ "bodyRequired": false,
5332
+ "isStream": false,
5333
+ "watchable": false,
5334
+ "help": {
5335
+ "command": "ora skills get <name>"
5336
+ }
5337
+ },
5338
+ {
5339
+ "id": "skills.list",
5340
+ "commandPath": [
5341
+ "skills",
5342
+ "list"
5343
+ ],
5344
+ "method": "get",
5345
+ "pathTemplate": "/studio/v1/agent-skills",
5346
+ "summary": "List the Agent Skills Studio hands to signed-in customers, with each one's version and the minimum ora CLI version it needs",
5347
+ "scope": "intents:read",
5348
+ "product": "studio",
5349
+ "pathParams": [],
5350
+ "queryParams": [],
5351
+ "hasBody": false,
5352
+ "bodyRequired": false,
5353
+ "isStream": false,
5354
+ "watchable": false,
5355
+ "help": {
5356
+ "command": "ora skills list"
5357
+ }
5358
+ },
3015
5359
  {
3016
5360
  "id": "studio.runs.cancel",
3017
5361
  "commandPath": [
@@ -3133,20 +5477,10 @@ export const OPERATIONS = [
3133
5477
  "kind": "object",
3134
5478
  "placeholder": "{}"
3135
5479
  },
3136
- {
3137
- "name": "engine",
3138
- "required": false,
3139
- "kind": "string",
3140
- "placeholder": "<engine>"
3141
- },
3142
5480
  {
3143
5481
  "name": "execution_kind",
3144
5482
  "required": false,
3145
5483
  "kind": "string",
3146
- "enum": [
3147
- "harness",
3148
- "direct"
3149
- ],
3150
5484
  "placeholder": "harness"
3151
5485
  },
3152
5486
  {
@@ -3182,12 +5516,6 @@ export const OPERATIONS = [
3182
5516
  "required": false,
3183
5517
  "kind": "object",
3184
5518
  "placeholder": "{}"
3185
- },
3186
- {
3187
- "name": "wait",
3188
- "required": false,
3189
- "kind": "boolean",
3190
- "placeholder": "true"
3191
5519
  }
3192
5520
  ],
3193
5521
  "watchable": true,
@@ -3196,32 +5524,6 @@ export const OPERATIONS = [
3196
5524
  "body": "{\n \"intent\": \"check pricing for acme.com\",\n \"harness\": \"eve\",\n \"model\": \"claude-sonnet-5\"\n}"
3197
5525
  }
3198
5526
  },
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
5527
  {
3226
5528
  "id": "studio.runs.feed",
3227
5529
  "commandPath": [
@@ -3502,7 +5804,8 @@ export const OPERATIONS = [
3502
5804
  "kind": "string",
3503
5805
  "enum": [
3504
5806
  "run",
3505
- "session"
5807
+ "session",
5808
+ "managed"
3506
5809
  ]
3507
5810
  }
3508
5811
  ],
@@ -5351,7 +7654,7 @@ export const OPERATIONS = [
5351
7654
  ],
5352
7655
  "method": "post",
5353
7656
  "pathTemplate": "/study/v1/studies/{id}/publish",
5354
- "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.",
7657
+ "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).",
5355
7658
  "scope": "study.studies:write",
5356
7659
  "product": "study",
5357
7660
  "pathParams": [
@@ -5381,9 +7684,16 @@ export const OPERATIONS = [
5381
7684
  "link",
5382
7685
  "public"
5383
7686
  ],
5384
- "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.",
7687
+ "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.",
5385
7688
  "placeholder": "private"
5386
7689
  },
7690
+ {
7691
+ "name": "expectPublished",
7692
+ "required": false,
7693
+ "kind": "boolean",
7694
+ "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.",
7695
+ "placeholder": "true"
7696
+ },
5387
7697
  {
5388
7698
  "name": "skillNames",
5389
7699
  "required": false,
@@ -5435,7 +7745,7 @@ export const OPERATIONS = [
5435
7745
  ],
5436
7746
  "method": "post",
5437
7747
  "pathTemplate": "/study/v1/studies/{id}/exec-summary",
5438
- "summary": "Regenerate the executive summary from the current aggregate (async; poll get)",
7748
+ "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",
5439
7749
  "scope": "study.studies:write",
5440
7750
  "product": "study",
5441
7751
  "pathParams": [
@@ -5559,7 +7869,7 @@ export const OPERATIONS = [
5559
7869
  ],
5560
7870
  "method": "post",
5561
7871
  "pathTemplate": "/study/v1/studies/{id}/share-token/rotate",
5562
- "summary": "Mint a fresh share link for a 'link' study. The previous link stops working IMMEDIATELY — there is no grace window.",
7872
+ "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.",
5563
7873
  "scope": "study.studies:write",
5564
7874
  "product": "study",
5565
7875
  "pathParams": [
@@ -5766,20 +8076,10 @@ export const OPERATIONS = [
5766
8076
  "kind": "object",
5767
8077
  "placeholder": "{}"
5768
8078
  },
5769
- {
5770
- "name": "engine",
5771
- "required": false,
5772
- "kind": "string",
5773
- "placeholder": "<engine>"
5774
- },
5775
8079
  {
5776
8080
  "name": "execution_kind",
5777
8081
  "required": false,
5778
8082
  "kind": "string",
5779
- "enum": [
5780
- "harness",
5781
- "direct"
5782
- ],
5783
8083
  "placeholder": "harness"
5784
8084
  },
5785
8085
  {
@@ -5815,12 +8115,6 @@ export const OPERATIONS = [
5815
8115
  "required": false,
5816
8116
  "kind": "object",
5817
8117
  "placeholder": "{}"
5818
- },
5819
- {
5820
- "name": "wait",
5821
- "required": false,
5822
- "kind": "boolean",
5823
- "placeholder": "true"
5824
8118
  }
5825
8119
  ],
5826
8120
  "watchable": true,
@@ -5829,32 +8123,6 @@ export const OPERATIONS = [
5829
8123
  "body": "{\n \"intent\": \"check pricing for acme.com\",\n \"harness\": \"eve\",\n \"model\": \"claude-sonnet-5\"\n}"
5830
8124
  }
5831
8125
  },
5832
- {
5833
- "id": "study.runs.directSignals",
5834
- "commandPath": [
5835
- "study",
5836
- "runs",
5837
- "direct-signals"
5838
- ],
5839
- "method": "get",
5840
- "pathTemplate": "/study/v1/runs/{id}/direct-signals",
5841
- "summary": "Read a direct run's extracted DirectSignals artifact",
5842
- "scope": "runs:read",
5843
- "product": "platform",
5844
- "pathParams": [
5845
- {
5846
- "name": "id"
5847
- }
5848
- ],
5849
- "queryParams": [],
5850
- "hasBody": false,
5851
- "bodyRequired": false,
5852
- "isStream": false,
5853
- "watchable": false,
5854
- "help": {
5855
- "command": "ora study runs direct-signals <id>"
5856
- }
5857
- },
5858
8126
  {
5859
8127
  "id": "study.runs.feed",
5860
8128
  "commandPath": [
@@ -6065,7 +8333,7 @@ export const OPERATIONS = [
6065
8333
  ],
6066
8334
  "method": "patch",
6067
8335
  "pathTemplate": "/study/v1/studies/{id}/visibility",
6068
- "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.",
8336
+ "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.",
6069
8337
  "scope": "study.studies:write",
6070
8338
  "product": "study",
6071
8339
  "pathParams": [
@@ -6088,7 +8356,7 @@ export const OPERATIONS = [
6088
8356
  "link",
6089
8357
  "public"
6090
8358
  ],
6091
- "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.",
8359
+ "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).",
6092
8360
  "placeholder": "link"
6093
8361
  }
6094
8362
  ],