@ora-ai/cli 0.25.0 → 0.26.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 (145) hide show
  1. package/CHANGELOG.md +39 -1
  2. package/README.md +569 -462
  3. package/dist/command-tree.d.ts +30 -0
  4. package/dist/command-tree.d.ts.map +1 -0
  5. package/dist/command-tree.js +144 -0
  6. package/dist/command-tree.js.map +1 -0
  7. package/dist/core/error-envelope.d.ts +13 -4
  8. package/dist/core/error-envelope.d.ts.map +1 -1
  9. package/dist/core/error-envelope.js +19 -4
  10. package/dist/core/error-envelope.js.map +1 -1
  11. package/dist/core/error-stories.d.ts +36 -0
  12. package/dist/core/error-stories.d.ts.map +1 -0
  13. package/dist/core/error-stories.js +155 -0
  14. package/dist/core/error-stories.js.map +1 -0
  15. package/dist/core/http.d.ts +14 -3
  16. package/dist/core/http.d.ts.map +1 -1
  17. package/dist/core/http.js +24 -6
  18. package/dist/core/http.js.map +1 -1
  19. package/dist/core/limit-story.d.ts +2 -0
  20. package/dist/core/limit-story.d.ts.map +1 -1
  21. package/dist/core/limit-story.js +9 -4
  22. package/dist/core/limit-story.js.map +1 -1
  23. package/dist/core/operation-command.d.ts +10 -0
  24. package/dist/core/operation-command.d.ts.map +1 -0
  25. package/dist/core/operation-command.js +15 -0
  26. package/dist/core/operation-command.js.map +1 -0
  27. package/dist/core/operation-meta.d.ts +62 -0
  28. package/dist/core/operation-meta.d.ts.map +1 -0
  29. package/dist/core/operation-meta.js +15 -0
  30. package/dist/core/operation-meta.js.map +1 -0
  31. package/dist/core/output.d.ts +7 -5
  32. package/dist/core/output.d.ts.map +1 -1
  33. package/dist/core/output.js +21 -80
  34. package/dist/core/output.js.map +1 -1
  35. package/dist/core/problem.d.ts +34 -0
  36. package/dist/core/problem.d.ts.map +1 -0
  37. package/dist/core/problem.js +44 -0
  38. package/dist/core/problem.js.map +1 -0
  39. package/dist/core/retry-after.d.ts +4 -3
  40. package/dist/core/retry-after.d.ts.map +1 -1
  41. package/dist/core/retry-after.js +4 -3
  42. package/dist/core/retry-after.js.map +1 -1
  43. package/dist/core/run-operation.d.ts +9 -4
  44. package/dist/core/run-operation.d.ts.map +1 -1
  45. package/dist/core/run-operation.js +17 -4
  46. package/dist/core/run-operation.js.map +1 -1
  47. package/dist/generated/operations.d.ts +37 -1
  48. package/dist/generated/operations.d.ts.map +1 -1
  49. package/dist/generated/operations.js +27540 -191
  50. package/dist/generated/operations.js.map +1 -1
  51. package/dist/generated/types.d.ts +1932 -116
  52. package/dist/generated/types.d.ts.map +1 -1
  53. package/dist/generated/types.js +1 -1
  54. package/dist/interactive/derive-prompts.d.ts +13 -5
  55. package/dist/interactive/derive-prompts.d.ts.map +1 -1
  56. package/dist/interactive/derive-prompts.js +25 -1
  57. package/dist/interactive/derive-prompts.js.map +1 -1
  58. package/dist/interactive/session.d.ts +2 -2
  59. package/dist/interactive/session.d.ts.map +1 -1
  60. package/dist/interactive/session.js +31 -2
  61. package/dist/interactive/session.js.map +1 -1
  62. package/dist/mcp/defined-tools/defined-call.d.ts +18 -0
  63. package/dist/mcp/defined-tools/defined-call.d.ts.map +1 -0
  64. package/dist/mcp/defined-tools/defined-call.js +114 -0
  65. package/dist/mcp/defined-tools/defined-call.js.map +1 -0
  66. package/dist/mcp/defined-tools/defined-tool.d.ts +22 -0
  67. package/dist/mcp/defined-tools/defined-tool.d.ts.map +1 -0
  68. package/dist/mcp/defined-tools/defined-tool.js +35 -0
  69. package/dist/mcp/defined-tools/defined-tool.js.map +1 -0
  70. package/dist/mcp/defined-tools/json-conform.d.ts +28 -0
  71. package/dist/mcp/defined-tools/json-conform.d.ts.map +1 -0
  72. package/dist/mcp/defined-tools/json-conform.js +144 -0
  73. package/dist/mcp/defined-tools/json-conform.js.map +1 -0
  74. package/dist/mcp/defined-tools/problem-mapping.d.ts +39 -0
  75. package/dist/mcp/defined-tools/problem-mapping.d.ts.map +1 -0
  76. package/dist/mcp/defined-tools/problem-mapping.js +179 -0
  77. package/dist/mcp/defined-tools/problem-mapping.js.map +1 -0
  78. package/dist/mcp/defined-tools/request-split.d.ts +19 -0
  79. package/dist/mcp/defined-tools/request-split.d.ts.map +1 -0
  80. package/dist/mcp/defined-tools/request-split.js +25 -0
  81. package/dist/mcp/defined-tools/request-split.js.map +1 -0
  82. package/dist/mcp/defined-tools/tool-problem.d.ts +40 -0
  83. package/dist/mcp/defined-tools/tool-problem.d.ts.map +1 -0
  84. package/dist/mcp/defined-tools/tool-problem.js +42 -0
  85. package/dist/mcp/defined-tools/tool-problem.js.map +1 -0
  86. package/dist/mcp/defined-tools/tool-results.d.ts +12 -0
  87. package/dist/mcp/defined-tools/tool-results.d.ts.map +1 -0
  88. package/dist/mcp/defined-tools/tool-results.js +21 -0
  89. package/dist/mcp/defined-tools/tool-results.js.map +1 -0
  90. package/dist/mcp/local-tools/credential-minting.d.ts +24 -0
  91. package/dist/mcp/local-tools/credential-minting.d.ts.map +1 -0
  92. package/dist/mcp/local-tools/credential-minting.js +49 -0
  93. package/dist/mcp/local-tools/credential-minting.js.map +1 -0
  94. package/dist/mcp/local-tools/env-file.d.ts +30 -0
  95. package/dist/mcp/local-tools/env-file.d.ts.map +1 -0
  96. package/dist/mcp/local-tools/env-file.js +71 -0
  97. package/dist/mcp/local-tools/env-file.js.map +1 -0
  98. package/dist/mcp/local-tools/local-tools.d.ts +16 -0
  99. package/dist/mcp/local-tools/local-tools.d.ts.map +1 -0
  100. package/dist/mcp/local-tools/local-tools.js +16 -0
  101. package/dist/mcp/local-tools/local-tools.js.map +1 -0
  102. package/dist/mcp/local-tools/save-transmitter-credential.d.ts +21 -0
  103. package/dist/mcp/local-tools/save-transmitter-credential.d.ts.map +1 -0
  104. package/dist/mcp/local-tools/save-transmitter-credential.js +119 -0
  105. package/dist/mcp/local-tools/save-transmitter-credential.js.map +1 -0
  106. package/dist/mcp/mcp-call.d.ts +2 -2
  107. package/dist/mcp/mcp-call.d.ts.map +1 -1
  108. package/dist/mcp/mcp-call.js +8 -2
  109. package/dist/mcp/mcp-call.js.map +1 -1
  110. package/dist/mcp/mcp-command.d.ts +6 -2
  111. package/dist/mcp/mcp-command.d.ts.map +1 -1
  112. package/dist/mcp/mcp-command.js +36 -12
  113. package/dist/mcp/mcp-command.js.map +1 -1
  114. package/dist/mcp/mcp-install.d.ts +2 -0
  115. package/dist/mcp/mcp-install.d.ts.map +1 -1
  116. package/dist/mcp/mcp-install.js +7 -1
  117. package/dist/mcp/mcp-install.js.map +1 -1
  118. package/dist/mcp/mcp-protocol.d.ts +2 -0
  119. package/dist/mcp/mcp-protocol.d.ts.map +1 -1
  120. package/dist/mcp/mcp-protocol.js.map +1 -1
  121. package/dist/mcp/mcp-tools.d.ts +28 -25
  122. package/dist/mcp/mcp-tools.d.ts.map +1 -1
  123. package/dist/mcp/mcp-tools.js +39 -16
  124. package/dist/mcp/mcp-tools.js.map +1 -1
  125. package/dist/mcp/tool-binding.d.ts +35 -0
  126. package/dist/mcp/tool-binding.d.ts.map +1 -0
  127. package/dist/mcp/tool-binding.js +7 -0
  128. package/dist/mcp/tool-binding.js.map +1 -0
  129. package/dist/mcp/tool-bindings.d.ts +20 -0
  130. package/dist/mcp/tool-bindings.d.ts.map +1 -0
  131. package/dist/mcp/tool-bindings.js +31 -0
  132. package/dist/mcp/tool-bindings.js.map +1 -0
  133. package/dist/mcp/tool-filter.d.ts +26 -0
  134. package/dist/mcp/tool-filter.d.ts.map +1 -0
  135. package/dist/mcp/tool-filter.js +23 -0
  136. package/dist/mcp/tool-filter.js.map +1 -0
  137. package/dist/program.d.ts +9 -9
  138. package/dist/program.d.ts.map +1 -1
  139. package/dist/program.js +12 -83
  140. package/dist/program.js.map +1 -1
  141. package/dist/watch.d.ts +3 -3
  142. package/dist/watch.d.ts.map +1 -1
  143. package/dist/watch.js +10 -2
  144. package/dist/watch.js.map +1 -1
  145. package/package.json +6 -7
@@ -806,6 +806,12 @@ export type AutopilotExportsCreateRequest = {
806
806
  "to"?: string;
807
807
  "clientKey"?: string;
808
808
  };
809
+ export type AutopilotExportsCreateResponse = {
810
+ "exportId": string;
811
+ "status": "requested" | "completed" | "failed";
812
+ "eventSeq": number;
813
+ "streamUrl": string;
814
+ };
809
815
  export type AutopilotExportsGetResponse = {
810
816
  "exportId": string;
811
817
  "status": "requested" | "completed" | "failed";
@@ -958,6 +964,44 @@ export type AutopilotMembersApplyKitRequest = {
958
964
  };
959
965
  "clientKey"?: string;
960
966
  };
967
+ export type AutopilotMembersApplyKitResponse = {
968
+ "teamId": string;
969
+ "member": {
970
+ "id": string;
971
+ "handle": string;
972
+ "harness": string;
973
+ "model": string | null;
974
+ "tier": "core" | "worker";
975
+ "position": string | null;
976
+ "status": "active" | "removed";
977
+ "livenessState": "ok" | "degraded";
978
+ "degradedReason": string | null;
979
+ "doorState": string;
980
+ "residency": string;
981
+ "executionEpoch": number;
982
+ "contextEpoch": number;
983
+ "dedicatedSessionId": string | null;
984
+ "kit": {
985
+ "addons": Record<string, unknown>;
986
+ "chips": Array<{
987
+ "key": string;
988
+ "addonId": string;
989
+ "kind": "capability" | "tool" | "skill";
990
+ "label": string;
991
+ "count"?: number;
992
+ "envNames"?: Array<string>;
993
+ }>;
994
+ "revision": string | null;
995
+ "desiredRevision": string;
996
+ "pending": boolean;
997
+ "modelPending": boolean;
998
+ "state": "ok" | "refused" | "boot_failed";
999
+ "appliedAt": string | null;
1000
+ };
1001
+ };
1002
+ "commandId": string | null;
1003
+ "eventSeq": number;
1004
+ };
961
1005
  export type AutopilotSegmentsGetResponse = {
962
1006
  "memberId": string;
963
1007
  "batchId": string;
@@ -1115,6 +1159,24 @@ export type AutopilotBoardListResponse = {
1115
1159
  "updatedAt": string;
1116
1160
  }>;
1117
1161
  };
1162
+ export type AutopilotMissionsPauseResponse = {
1163
+ "status": string;
1164
+ "eventSeq": number;
1165
+ "streamUrl": string;
1166
+ "stillPausedMissionIds"?: Array<string>;
1167
+ };
1168
+ export type AutopilotMissionsResumeResponse = {
1169
+ "status": string;
1170
+ "eventSeq": number;
1171
+ "streamUrl": string;
1172
+ "stillPausedMissionIds"?: Array<string>;
1173
+ };
1174
+ export type AutopilotMissionsStopResponse = {
1175
+ "status": string;
1176
+ "eventSeq": number;
1177
+ "streamUrl": string;
1178
+ "stillPausedMissionIds"?: Array<string>;
1179
+ };
1118
1180
  export type AutopilotNotesListResponse = {
1119
1181
  "items": Array<{
1120
1182
  "id": string;
@@ -1172,6 +1234,18 @@ export type AutopilotNotesRollbackResponse = {
1172
1234
  };
1173
1235
  "eventSeq": number;
1174
1236
  };
1237
+ export type AutopilotTeamsPauseResponse = {
1238
+ "status": string;
1239
+ "eventSeq": number;
1240
+ "streamUrl": string;
1241
+ "stillPausedMissionIds"?: Array<string>;
1242
+ };
1243
+ export type AutopilotTeamsResumeResponse = {
1244
+ "status": string;
1245
+ "eventSeq": number;
1246
+ "streamUrl": string;
1247
+ "stillPausedMissionIds"?: Array<string>;
1248
+ };
1175
1249
  export type AutopilotSquadsListResponse = {
1176
1250
  "items": Array<{
1177
1251
  "id": string;
@@ -1209,6 +1283,12 @@ export type AutopilotSquadsDeleteResponse = {
1209
1283
  "squadId": string;
1210
1284
  "eventSeq": number;
1211
1285
  };
1286
+ export type AutopilotTeamsStopResponse = {
1287
+ "status": string;
1288
+ "eventSeq": number;
1289
+ "streamUrl": string;
1290
+ "stillPausedMissionIds"?: Array<string>;
1291
+ };
1212
1292
  export type AutopilotTeamsStreamResponse = unknown;
1213
1293
  export type BenchmarksListResponse = {
1214
1294
  "studies": Array<{
@@ -4189,138 +4269,1853 @@ export type AuditResultResponse = {
4189
4269
  "capabilities": Record<string, unknown>;
4190
4270
  };
4191
4271
  export type AuditStreamResponse = unknown;
4192
- export type GoalsUpdateRequest = {
4193
- "title"?: string;
4194
- "statement"?: string;
4195
- "isActive"?: boolean;
4196
- "config"?: unknown;
4197
- "types"?: "all" | Array<"discover" | "choose" | "verify" | "inform" | "guide" | "act">;
4198
- "category"?: "recommended" | "answered" | "accurate" | "informed" | "capability" | "real_steps" | "safe" | "task_done" | "other";
4199
- };
4200
- export type GoalsUpdateResponse = {
4201
- "success": true;
4202
- "data": {
4272
+ export type FrontHostingDetectResponse = {
4273
+ "hostname": string;
4274
+ "siteId": string;
4275
+ "status": "detected" | "unknown" | "ambiguous" | "unavailable";
4276
+ "hostingProvider": "wpengine" | "kinsta" | "webflow" | "hostinger" | null;
4277
+ "observedAt": string;
4278
+ };
4279
+ export type FrontSitesListResponse = {
4280
+ "items": Array<{
4203
4281
  "id": string;
4204
- "intentId": string;
4205
- "kind": "target_match" | "state_assertion" | "answer_check";
4206
- "criterionGroup": "discover" | "choose" | "verify" | "inform" | "guide" | "act" | null;
4207
- "allTypes": boolean;
4208
- "types": Array<"discover" | "choose" | "verify" | "inform" | "guide" | "act">;
4209
- "category": "recommended" | "answered" | "accurate" | "informed" | "capability" | "real_steps" | "safe" | "task_done" | "other" | null;
4210
- "categorySetBy": "ora" | "caller" | null;
4211
- "isDrafted": boolean;
4212
- "title": string;
4213
- "statement": string | null;
4214
- "config": unknown;
4215
- "isActive": boolean;
4216
- "position": number;
4217
- "createdBy": string | null;
4282
+ "hostname": string;
4283
+ "status": "building" | "live" | "held" | "failed";
4284
+ "build": {
4285
+ "id": string;
4286
+ "kind": "first" | "rest_of_site" | "rebuild";
4287
+ "state": "queued" | "running" | "live" | "held" | "failed" | "canceled";
4288
+ "step": string | null;
4289
+ "pagesFound": number;
4290
+ "pagesRead": number;
4291
+ "failure": {
4292
+ "code": string;
4293
+ "detail": string;
4294
+ } | null;
4295
+ "startedAt": string | null;
4296
+ "finishedAt": string | null;
4297
+ } | null;
4298
+ "address": {
4299
+ "name": string;
4300
+ "url": string;
4301
+ "mcpUrl": string;
4302
+ "llmsTxtUrl": string;
4303
+ "open"?: boolean;
4304
+ } | null;
4305
+ "connection"?: {
4306
+ "method": "managed" | "cloudflare" | "vercel" | "nextjs" | "express" | "other" | null;
4307
+ "status": "not_connected" | "pending" | "connected" | "failed";
4308
+ };
4309
+ "protocols"?: {
4310
+ "address": {
4311
+ "nlweb": boolean;
4312
+ "mcp": boolean;
4313
+ };
4314
+ "website": {
4315
+ "nlweb": boolean;
4316
+ "mcp": boolean;
4317
+ };
4318
+ };
4319
+ "serving"?: {
4320
+ "mode": "off" | "monitor" | "autopilot";
4321
+ };
4322
+ "nextSteps": Array<{
4323
+ "id": "retry_setup" | "allow_reader" | "connect_website" | "verify_traffic" | "serve_agents" | "add_action";
4324
+ "done": boolean;
4325
+ "title": string;
4326
+ "operation": string;
4327
+ }>;
4328
+ "version": string;
4218
4329
  "createdAt": string;
4219
- "updatedAt": string;
4220
- };
4330
+ "streamUrl": string;
4331
+ }>;
4332
+ "nextCursor": string | null;
4221
4333
  };
4222
- export type GoalsDeleteResponse = {
4223
- "success": true;
4224
- "data": {
4334
+ export type FrontSitesCreateRequest = {
4335
+ "url": string;
4336
+ };
4337
+ export type FrontSitesCreateResponse = {
4338
+ "id": string;
4339
+ "hostname": string;
4340
+ "status": "building" | "live" | "held" | "failed";
4341
+ "build": {
4225
4342
  "id": string;
4343
+ "kind": "first" | "rest_of_site" | "rebuild";
4344
+ "state": "queued" | "running" | "live" | "held" | "failed" | "canceled";
4345
+ "step": string | null;
4346
+ "pagesFound": number;
4347
+ "pagesRead": number;
4348
+ "failure": {
4349
+ "code": string;
4350
+ "detail": string;
4351
+ } | null;
4352
+ "startedAt": string | null;
4353
+ "finishedAt": string | null;
4354
+ } | null;
4355
+ "address": {
4356
+ "name": string;
4357
+ "url": string;
4358
+ "mcpUrl": string;
4359
+ "llmsTxtUrl": string;
4360
+ "open"?: boolean;
4361
+ } | null;
4362
+ "connection"?: {
4363
+ "method": "managed" | "cloudflare" | "vercel" | "nextjs" | "express" | "other" | null;
4364
+ "status": "not_connected" | "pending" | "connected" | "failed";
4226
4365
  };
4227
- };
4228
- export type IcpsListResponse = {
4229
- "success": true;
4230
- "data": {
4231
- "icps": Array<{
4232
- "id": string;
4233
- "label": string;
4234
- "description": string;
4235
- }>;
4366
+ "protocols"?: {
4367
+ "address": {
4368
+ "nlweb": boolean;
4369
+ "mcp": boolean;
4370
+ };
4371
+ "website": {
4372
+ "nlweb": boolean;
4373
+ "mcp": boolean;
4374
+ };
4236
4375
  };
4376
+ "serving"?: {
4377
+ "mode": "off" | "monitor" | "autopilot";
4378
+ };
4379
+ "nextSteps": Array<{
4380
+ "id": "retry_setup" | "allow_reader" | "connect_website" | "verify_traffic" | "serve_agents" | "add_action";
4381
+ "done": boolean;
4382
+ "title": string;
4383
+ "operation": string;
4384
+ }>;
4385
+ "version": string;
4386
+ "createdAt": string;
4387
+ "streamUrl": string;
4237
4388
  };
4238
- export type IcpsCreateRequest = {
4239
- "domainId": string;
4240
- "description": string;
4241
- "label"?: string;
4242
- };
4243
- export type IcpsCreateResponse = {
4244
- "success": true;
4245
- "data": {
4389
+ export type FrontSitesGetResponse = {
4390
+ "id": string;
4391
+ "hostname": string;
4392
+ "status": "building" | "live" | "held" | "failed";
4393
+ "build": {
4246
4394
  "id": string;
4247
- "label": string;
4248
- "description": string;
4395
+ "kind": "first" | "rest_of_site" | "rebuild";
4396
+ "state": "queued" | "running" | "live" | "held" | "failed" | "canceled";
4397
+ "step": string | null;
4398
+ "pagesFound": number;
4399
+ "pagesRead": number;
4400
+ "failure": {
4401
+ "code": string;
4402
+ "detail": string;
4403
+ } | null;
4404
+ "startedAt": string | null;
4405
+ "finishedAt": string | null;
4406
+ } | null;
4407
+ "address": {
4408
+ "name": string;
4409
+ "url": string;
4410
+ "mcpUrl": string;
4411
+ "llmsTxtUrl": string;
4412
+ "open"?: boolean;
4413
+ } | null;
4414
+ "connection"?: {
4415
+ "method": "managed" | "cloudflare" | "vercel" | "nextjs" | "express" | "other" | null;
4416
+ "status": "not_connected" | "pending" | "connected" | "failed";
4417
+ };
4418
+ "protocols"?: {
4419
+ "address": {
4420
+ "nlweb": boolean;
4421
+ "mcp": boolean;
4422
+ };
4423
+ "website": {
4424
+ "nlweb": boolean;
4425
+ "mcp": boolean;
4426
+ };
4427
+ };
4428
+ "serving"?: {
4429
+ "mode": "off" | "monitor" | "autopilot";
4249
4430
  };
4431
+ "nextSteps": Array<{
4432
+ "id": "retry_setup" | "allow_reader" | "connect_website" | "verify_traffic" | "serve_agents" | "add_action";
4433
+ "done": boolean;
4434
+ "title": string;
4435
+ "operation": string;
4436
+ }>;
4437
+ "version": string;
4438
+ "createdAt": string;
4439
+ "streamUrl": string;
4250
4440
  };
4251
- export type IcpsUpdateRequest = {
4252
- "label"?: string;
4253
- "description"?: string;
4254
- "isActive"?: boolean;
4441
+ export type FrontAccessGetResponse = {
4442
+ "impersonators": "flag" | "block";
4443
+ "categoryDefaults": {
4444
+ "training_crawl": "allow" | "disallow" | "block";
4445
+ "search_index": "allow" | "disallow" | "block";
4446
+ "live_fetch": "allow" | "disallow" | "block";
4447
+ "agent_action": "allow" | "disallow" | "block";
4448
+ };
4449
+ "enforced": boolean;
4450
+ "propagationSeconds": number;
4451
+ };
4452
+ export type FrontAccessUpdateRequest = {
4453
+ "impersonators"?: "flag" | "block" | null;
4454
+ "categoryDefaults"?: {
4455
+ "training_crawl"?: "allow" | "block" | null;
4456
+ "search_index"?: "allow" | "block" | null;
4457
+ "live_fetch"?: "allow" | "block" | null;
4458
+ "agent_action"?: "allow" | "block" | null;
4459
+ } | null;
4255
4460
  };
4256
- export type IcpsUpdateResponse = {
4257
- "success": true;
4258
- "data": {
4259
- "updated": boolean;
4461
+ export type FrontAccessUpdateResponse = {
4462
+ "impersonators": "flag" | "block";
4463
+ "categoryDefaults": {
4464
+ "training_crawl": "allow" | "disallow" | "block";
4465
+ "search_index": "allow" | "disallow" | "block";
4466
+ "live_fetch": "allow" | "disallow" | "block";
4467
+ "agent_action": "allow" | "disallow" | "block";
4260
4468
  };
4469
+ "enforced": boolean;
4470
+ "propagationSeconds": number;
4261
4471
  };
4262
- export type IntentsListResponse = {
4263
- "success": true;
4264
- "data": Array<{
4472
+ export type FrontActionTemplatesListResponse = {
4473
+ "items": Array<{
4474
+ "key": string;
4475
+ "title": string;
4476
+ "description": string;
4477
+ }>;
4478
+ "nextCursor": string | null;
4479
+ };
4480
+ export type FrontActionsListResponse = {
4481
+ "items": Array<{
4265
4482
  "id": string;
4483
+ "name": string;
4484
+ "kind": "request" | "tool";
4266
4485
  "title": string;
4267
- "slug": string;
4268
- "domainId": string | null;
4269
- "promptCount": number;
4270
- "tags": Array<string>;
4271
- "goalKinds": Array<"target_match" | "state_assertion" | "answer_check">;
4272
- "stageTags": Array<"discovery" | "access" | "use">;
4273
- "success": number | null;
4274
- "friction": {
4275
- "kind": "healthy";
4276
- } | {
4277
- "kind": "stage";
4278
- "stage": "discovery" | "access" | "use";
4279
- "broke": number;
4280
- "reached": number;
4281
- } | {
4282
- "kind": "multiple";
4283
- "broke": number;
4284
- "reached": number;
4285
- };
4286
- "health": {
4287
- "band": "healthy" | "watch" | "broken" | "unknown";
4288
- "score": number | null;
4289
- };
4290
- "sparkline": Array<{
4291
- "day": string;
4292
- "value": number | null;
4293
- }>;
4294
- "coverage": {
4295
- "runs": number;
4296
- "conclusive": number;
4297
- "unmeasurable": number;
4298
- "expected": number;
4299
- };
4300
- "lowSample": boolean;
4301
- "measurementPolicy": {
4302
- "cadence": "daily" | "weekly" | "monthly" | "manual";
4303
- "mcp_server_ids": Array<string>;
4304
- "agents": Array<{
4305
- "harness": string;
4306
- "model": string;
4307
- "mcp_server_ids": Array<string>;
4308
- "skill_ids": Array<string>;
4309
- "browser"?: {
4310
- "webdriver"?: boolean;
4311
- "webmcp"?: boolean;
4312
- "webmcpTargetUrl"?: string;
4313
- "webmcpSurface"?: "native" | "shim";
4314
- };
4486
+ "status": "live" | "ready" | "off" | "broken";
4487
+ "request"?: {
4488
+ "template": string;
4489
+ "mode": "inbox" | "deliver" | "link";
4490
+ "about": string;
4491
+ "webhookUrl"?: string;
4492
+ "pageUrl"?: string;
4493
+ "fields": Array<{
4494
+ "name": string;
4495
+ "label": string;
4496
+ "type": "text" | "email" | "tel" | "url" | "number" | "date" | "textarea" | "select";
4497
+ "required": boolean;
4498
+ "options"?: Array<string>;
4315
4499
  }>;
4316
- "skill_ids": Array<string>;
4317
- "browser"?: {
4318
- "webdriver"?: boolean;
4319
- "webmcp"?: boolean;
4320
- "webmcpTargetUrl"?: string;
4321
- "webmcpSurface"?: "native" | "shim";
4322
- };
4323
- "competitors": Array<string>;
4500
+ };
4501
+ }>;
4502
+ "nextCursor": string | null;
4503
+ };
4504
+ export type FrontActionsCreateRequest = {
4505
+ "kind": "request";
4506
+ "request": {
4507
+ "template": string;
4508
+ "mode": "inbox" | "deliver" | "link";
4509
+ "title"?: string;
4510
+ "about"?: string;
4511
+ "webhookUrl"?: string;
4512
+ "pageUrl"?: string;
4513
+ };
4514
+ };
4515
+ export type FrontActionsCreateResponse = {
4516
+ "id": string;
4517
+ "name": string;
4518
+ "kind": "request" | "tool";
4519
+ "title": string;
4520
+ "status": "live" | "ready" | "off" | "broken";
4521
+ "request"?: {
4522
+ "template": string;
4523
+ "mode": "inbox" | "deliver" | "link";
4524
+ "about": string;
4525
+ "webhookUrl"?: string;
4526
+ "pageUrl"?: string;
4527
+ "fields": Array<{
4528
+ "name": string;
4529
+ "label": string;
4530
+ "type": "text" | "email" | "tel" | "url" | "number" | "date" | "textarea" | "select";
4531
+ "required": boolean;
4532
+ "options"?: Array<string>;
4533
+ }>;
4534
+ };
4535
+ };
4536
+ export type FrontActionsGetResponse = {
4537
+ "id": string;
4538
+ "name": string;
4539
+ "kind": "request" | "tool";
4540
+ "title": string;
4541
+ "status": "live" | "ready" | "off" | "broken";
4542
+ "request"?: {
4543
+ "template": string;
4544
+ "mode": "inbox" | "deliver" | "link";
4545
+ "about": string;
4546
+ "webhookUrl"?: string;
4547
+ "pageUrl"?: string;
4548
+ "fields": Array<{
4549
+ "name": string;
4550
+ "label": string;
4551
+ "type": "text" | "email" | "tel" | "url" | "number" | "date" | "textarea" | "select";
4552
+ "required": boolean;
4553
+ "options"?: Array<string>;
4554
+ }>;
4555
+ };
4556
+ };
4557
+ export type FrontActionsUpdateRequest = {
4558
+ "title"?: string;
4559
+ "request"?: {
4560
+ "mode"?: "inbox" | "deliver" | "link";
4561
+ "about"?: string;
4562
+ "webhookUrl"?: string | null;
4563
+ "pageUrl"?: string | null;
4564
+ };
4565
+ };
4566
+ export type FrontActionsUpdateResponse = {
4567
+ "id": string;
4568
+ "name": string;
4569
+ "kind": "request" | "tool";
4570
+ "title": string;
4571
+ "status": "live" | "ready" | "off" | "broken";
4572
+ "request"?: {
4573
+ "template": string;
4574
+ "mode": "inbox" | "deliver" | "link";
4575
+ "about": string;
4576
+ "webhookUrl"?: string;
4577
+ "pageUrl"?: string;
4578
+ "fields": Array<{
4579
+ "name": string;
4580
+ "label": string;
4581
+ "type": "text" | "email" | "tel" | "url" | "number" | "date" | "textarea" | "select";
4582
+ "required": boolean;
4583
+ "options"?: Array<string>;
4584
+ }>;
4585
+ };
4586
+ };
4587
+ export type FrontActionsDeleteResponse = {
4588
+ "id": string;
4589
+ };
4590
+ export type FrontActionsAppGetResponse = {
4591
+ "html": string;
4592
+ "resourceOrigins": Array<string>;
4593
+ "connectOrigins": Array<string>;
4594
+ "by": "ora" | "you";
4595
+ };
4596
+ export type FrontActionsAppUpdateRequest = {
4597
+ "html": string;
4598
+ "resourceOrigins"?: Array<string>;
4599
+ "connectOrigins"?: Array<string>;
4600
+ };
4601
+ export type FrontActionsAppUpdateResponse = {
4602
+ "html": string;
4603
+ "resourceOrigins": Array<string>;
4604
+ "connectOrigins": Array<string>;
4605
+ "by": "ora" | "you";
4606
+ };
4607
+ export type FrontActionsAppDeleteResponse = {
4608
+ "id": string;
4609
+ "name": string;
4610
+ "kind": "request" | "tool";
4611
+ "title": string;
4612
+ "status": "live" | "ready" | "off" | "broken";
4613
+ "request"?: {
4614
+ "template": string;
4615
+ "mode": "inbox" | "deliver" | "link";
4616
+ "about": string;
4617
+ "webhookUrl"?: string;
4618
+ "pageUrl"?: string;
4619
+ "fields": Array<{
4620
+ "name": string;
4621
+ "label": string;
4622
+ "type": "text" | "email" | "tel" | "url" | "number" | "date" | "textarea" | "select";
4623
+ "required": boolean;
4624
+ "options"?: Array<string>;
4625
+ }>;
4626
+ };
4627
+ };
4628
+ export type FrontActionsLiveUpdateRequest = {
4629
+ "live": boolean;
4630
+ };
4631
+ export type FrontActionsLiveUpdateResponse = {
4632
+ "id": string;
4633
+ "name": string;
4634
+ "kind": "request" | "tool";
4635
+ "title": string;
4636
+ "status": "live" | "ready" | "off" | "broken";
4637
+ "request"?: {
4638
+ "template": string;
4639
+ "mode": "inbox" | "deliver" | "link";
4640
+ "about": string;
4641
+ "webhookUrl"?: string;
4642
+ "pageUrl"?: string;
4643
+ "fields": Array<{
4644
+ "name": string;
4645
+ "label": string;
4646
+ "type": "text" | "email" | "tel" | "url" | "number" | "date" | "textarea" | "select";
4647
+ "required": boolean;
4648
+ "options"?: Array<string>;
4649
+ }>;
4650
+ };
4651
+ };
4652
+ export type FrontAddressGetResponse = {
4653
+ "name": string;
4654
+ "url": string;
4655
+ "mcpUrl": string;
4656
+ "llmsTxtUrl": string;
4657
+ "open": boolean;
4658
+ "prefix": string;
4659
+ "suffix": string;
4660
+ "earlier": Array<string>;
4661
+ "changesLeft": number;
4662
+ };
4663
+ export type FrontAddressUpdateRequest = {
4664
+ "name"?: string;
4665
+ };
4666
+ export type FrontAddressUpdateResponse = {
4667
+ "name": string;
4668
+ "url": string;
4669
+ "mcpUrl": string;
4670
+ "llmsTxtUrl": string;
4671
+ "open": boolean;
4672
+ "prefix": string;
4673
+ "suffix": string;
4674
+ "earlier": Array<string>;
4675
+ "changesLeft": number;
4676
+ };
4677
+ export type FrontAgentFilesListResponse = {
4678
+ "items": Array<{
4679
+ "kind": "llms" | "robots" | "ai_catalog" | "agents_md" | "openapi" | "security_txt" | "mcp_server_card" | "mcp_manifest" | "openai_apps_challenge" | "mcp_registry_auth";
4680
+ "path": string;
4681
+ "source": "auto" | "edited";
4682
+ "offered": boolean;
4683
+ "generatedAt": string | null;
4684
+ "editedAt": string | null;
4685
+ }>;
4686
+ "nextCursor": string | null;
4687
+ };
4688
+ export type FrontAgentFilesRegenerateResponse = {
4689
+ "items": Array<{
4690
+ "kind": "llms" | "robots" | "ai_catalog" | "agents_md" | "openapi" | "security_txt" | "mcp_server_card" | "mcp_manifest" | "openai_apps_challenge" | "mcp_registry_auth";
4691
+ "ok": boolean;
4692
+ "reason": string | null;
4693
+ }>;
4694
+ };
4695
+ export type FrontAgentFilesGetResponse = {
4696
+ "kind": "llms" | "robots" | "ai_catalog" | "agents_md" | "openapi" | "security_txt" | "mcp_server_card" | "mcp_manifest" | "openai_apps_challenge" | "mcp_registry_auth";
4697
+ "path": string;
4698
+ "source": "auto" | "edited";
4699
+ "offered": boolean;
4700
+ "generatedAt": string | null;
4701
+ "editedAt": string | null;
4702
+ "content": string;
4703
+ "servedContent": string;
4704
+ "generatedContent": string;
4705
+ "siteDirectives": string | null;
4706
+ };
4707
+ export type FrontAgentFilesUpdateRequest = {
4708
+ "content": string;
4709
+ };
4710
+ export type FrontAgentFilesUpdateResponse = {
4711
+ "kind": "llms" | "robots" | "ai_catalog" | "agents_md" | "openapi" | "security_txt" | "mcp_server_card" | "mcp_manifest" | "openai_apps_challenge" | "mcp_registry_auth";
4712
+ "path": string;
4713
+ "source": "auto" | "edited";
4714
+ "offered": boolean;
4715
+ "generatedAt": string | null;
4716
+ "editedAt": string | null;
4717
+ "content": string;
4718
+ "servedContent": string;
4719
+ "generatedContent": string;
4720
+ "siteDirectives": string | null;
4721
+ };
4722
+ export type FrontAgentFilesDeleteResponse = {
4723
+ "kind": "llms" | "robots" | "ai_catalog" | "agents_md" | "openapi" | "security_txt" | "mcp_server_card" | "mcp_manifest" | "openai_apps_challenge" | "mcp_registry_auth";
4724
+ "path": string;
4725
+ "source": "auto" | "edited";
4726
+ "offered": boolean;
4727
+ "generatedAt": string | null;
4728
+ "editedAt": string | null;
4729
+ "content": string;
4730
+ "servedContent": string;
4731
+ "generatedContent": string;
4732
+ "siteDirectives": string | null;
4733
+ };
4734
+ export type FrontConnectionGetResponse = {
4735
+ "method": "managed" | "cloudflare" | "vercel" | "nextjs" | "express" | "other" | null;
4736
+ "status": "not_connected" | "pending" | "connected" | "failed";
4737
+ "hostname": string | null;
4738
+ "nextVersion": "16" | "13-15" | null;
4739
+ "existingMiddleware": boolean | null;
4740
+ "managed": {
4741
+ "hostingProvider": "wpengine" | "kinsta" | "webflow" | "hostinger" | "cloudfront" | "self_hosted";
4742
+ "originUrl": string;
4743
+ "dnsManagement": "external" | "wpengine" | "hostinger" | "flattened" | "apex_proxy";
4744
+ "originalDnsRecords": Array<{
4745
+ "name": string;
4746
+ "type": "A" | "AAAA" | "CNAME" | "ALIAS";
4747
+ "value": string;
4748
+ "ttl": number | null;
4749
+ "proxied"?: boolean;
4750
+ "proxyProvider"?: "cloudflare" | "other" | "unknown";
4751
+ "route53Alias"?: {
4752
+ "recordType": "A" | "AAAA";
4753
+ "hostedZoneId": string;
4754
+ };
4755
+ }>;
4756
+ } | null;
4757
+ "checks": {
4758
+ "live": {
4759
+ "state": "pending" | "verified" | "failed";
4760
+ "message": string | null;
4761
+ "checkedAt": string | null;
4762
+ };
4763
+ "traffic": {
4764
+ "state": "pending" | "verified" | "failed";
4765
+ "message": string | null;
4766
+ "checkedAt": string | null;
4767
+ };
4768
+ "checkedAt": string | null;
4769
+ "installation": Array<{
4770
+ "state": "pending" | "verified" | "failed";
4771
+ "message": string | null;
4772
+ "checkedAt": string | null;
4773
+ "name": "ownership" | "certificate" | "hostname" | "origin" | "deployment" | "credential" | "routing" | "dns" | "traffic";
4774
+ }>;
4775
+ };
4776
+ "installation": {
4777
+ "state": "draft" | "canceled" | "provisioning" | "awaiting_verification" | "ready_for_dns" | "active" | "error" | "disconnecting" | "draining" | "disconnected";
4778
+ "stage": "setup" | "ready_for_dns" | "active" | "disconnecting";
4779
+ "originUrl": string;
4780
+ "steps": Array<{
4781
+ "id": string;
4782
+ "title": string;
4783
+ "body": string;
4784
+ "url": string | null;
4785
+ }>;
4786
+ "originProof": {
4787
+ "path": string;
4788
+ "document": {
4789
+ "installationId": string;
4790
+ "publicHostname": string;
4791
+ "token": string;
4792
+ };
4793
+ } | null;
4794
+ "wordpressPlugin": boolean;
4795
+ "originChange": {
4796
+ "id": string;
4797
+ "originUrl": string;
4798
+ "previousOriginUrl": string;
4799
+ "status": "pending" | "verifying" | "switching" | "complete" | "failed";
4800
+ "requestedAt": string;
4801
+ "completedAt": string | null;
4802
+ "failure": {
4803
+ "code": string;
4804
+ "detail": string | null;
4805
+ } | null;
4806
+ } | null;
4807
+ "restoration": {
4808
+ "confirmedAt": string | null;
4809
+ } | null;
4810
+ "failure": {
4811
+ "code": string;
4812
+ "at": string | null;
4813
+ } | null;
4814
+ "nextAttemptAt": string | null;
4815
+ "updatedAt": string;
4816
+ } | null;
4817
+ "credentials": Array<{
4818
+ "id": string;
4819
+ "fingerprint": string;
4820
+ "createdAt": string;
4821
+ "createdBy": string | null;
4822
+ "lastUsedAt": string | null;
4823
+ }>;
4824
+ "lastContactAt": string | null;
4825
+ "transmitterVersion": string | null;
4826
+ };
4827
+ export type FrontConnectionUpdateRequest = {
4828
+ "method": "managed" | "cloudflare" | "vercel" | "nextjs" | "express";
4829
+ "hostname": string;
4830
+ "nextVersion"?: "16" | "13-15";
4831
+ "existingMiddleware"?: boolean;
4832
+ "managed"?: {
4833
+ "hostingProvider": "wpengine" | "kinsta" | "webflow" | "hostinger" | "cloudfront" | "self_hosted";
4834
+ "originUrl": string;
4835
+ "dnsManagement"?: "external" | "wpengine" | "hostinger" | "flattened" | "apex_proxy";
4836
+ "originalDnsRecords": Array<{
4837
+ "name": string;
4838
+ "type": "A" | "AAAA" | "CNAME" | "ALIAS";
4839
+ "value": string;
4840
+ "ttl": number | null;
4841
+ "proxied"?: boolean;
4842
+ "proxyProvider"?: "cloudflare" | "other" | "unknown";
4843
+ "route53Alias"?: {
4844
+ "recordType": "A" | "AAAA";
4845
+ "hostedZoneId": string;
4846
+ };
4847
+ }>;
4848
+ };
4849
+ };
4850
+ export type FrontConnectionUpdateResponse = {
4851
+ "method": "managed" | "cloudflare" | "vercel" | "nextjs" | "express" | "other" | null;
4852
+ "status": "not_connected" | "pending" | "connected" | "failed";
4853
+ "hostname": string | null;
4854
+ "nextVersion": "16" | "13-15" | null;
4855
+ "existingMiddleware": boolean | null;
4856
+ "managed": {
4857
+ "hostingProvider": "wpengine" | "kinsta" | "webflow" | "hostinger" | "cloudfront" | "self_hosted";
4858
+ "originUrl": string;
4859
+ "dnsManagement": "external" | "wpengine" | "hostinger" | "flattened" | "apex_proxy";
4860
+ "originalDnsRecords": Array<{
4861
+ "name": string;
4862
+ "type": "A" | "AAAA" | "CNAME" | "ALIAS";
4863
+ "value": string;
4864
+ "ttl": number | null;
4865
+ "proxied"?: boolean;
4866
+ "proxyProvider"?: "cloudflare" | "other" | "unknown";
4867
+ "route53Alias"?: {
4868
+ "recordType": "A" | "AAAA";
4869
+ "hostedZoneId": string;
4870
+ };
4871
+ }>;
4872
+ } | null;
4873
+ "checks": {
4874
+ "live": {
4875
+ "state": "pending" | "verified" | "failed";
4876
+ "message": string | null;
4877
+ "checkedAt": string | null;
4878
+ };
4879
+ "traffic": {
4880
+ "state": "pending" | "verified" | "failed";
4881
+ "message": string | null;
4882
+ "checkedAt": string | null;
4883
+ };
4884
+ "checkedAt": string | null;
4885
+ "installation": Array<{
4886
+ "state": "pending" | "verified" | "failed";
4887
+ "message": string | null;
4888
+ "checkedAt": string | null;
4889
+ "name": "ownership" | "certificate" | "hostname" | "origin" | "deployment" | "credential" | "routing" | "dns" | "traffic";
4890
+ }>;
4891
+ };
4892
+ "installation": {
4893
+ "state": "draft" | "canceled" | "provisioning" | "awaiting_verification" | "ready_for_dns" | "active" | "error" | "disconnecting" | "draining" | "disconnected";
4894
+ "stage": "setup" | "ready_for_dns" | "active" | "disconnecting";
4895
+ "originUrl": string;
4896
+ "steps": Array<{
4897
+ "id": string;
4898
+ "title": string;
4899
+ "body": string;
4900
+ "url": string | null;
4901
+ }>;
4902
+ "originProof": {
4903
+ "path": string;
4904
+ "document": {
4905
+ "installationId": string;
4906
+ "publicHostname": string;
4907
+ "token": string;
4908
+ };
4909
+ } | null;
4910
+ "wordpressPlugin": boolean;
4911
+ "originChange": {
4912
+ "id": string;
4913
+ "originUrl": string;
4914
+ "previousOriginUrl": string;
4915
+ "status": "pending" | "verifying" | "switching" | "complete" | "failed";
4916
+ "requestedAt": string;
4917
+ "completedAt": string | null;
4918
+ "failure": {
4919
+ "code": string;
4920
+ "detail": string | null;
4921
+ } | null;
4922
+ } | null;
4923
+ "restoration": {
4924
+ "confirmedAt": string | null;
4925
+ } | null;
4926
+ "failure": {
4927
+ "code": string;
4928
+ "at": string | null;
4929
+ } | null;
4930
+ "nextAttemptAt": string | null;
4931
+ "updatedAt": string;
4932
+ } | null;
4933
+ "credentials": Array<{
4934
+ "id": string;
4935
+ "fingerprint": string;
4936
+ "createdAt": string;
4937
+ "createdBy": string | null;
4938
+ "lastUsedAt": string | null;
4939
+ }>;
4940
+ "lastContactAt": string | null;
4941
+ "transmitterVersion": string | null;
4942
+ };
4943
+ export type FrontConnectionDeleteResponse = {
4944
+ "method": "managed" | "cloudflare" | "vercel" | "nextjs" | "express" | "other" | null;
4945
+ "status": "not_connected" | "pending" | "connected" | "failed";
4946
+ "hostname": string | null;
4947
+ "nextVersion": "16" | "13-15" | null;
4948
+ "existingMiddleware": boolean | null;
4949
+ "managed": {
4950
+ "hostingProvider": "wpengine" | "kinsta" | "webflow" | "hostinger" | "cloudfront" | "self_hosted";
4951
+ "originUrl": string;
4952
+ "dnsManagement": "external" | "wpengine" | "hostinger" | "flattened" | "apex_proxy";
4953
+ "originalDnsRecords": Array<{
4954
+ "name": string;
4955
+ "type": "A" | "AAAA" | "CNAME" | "ALIAS";
4956
+ "value": string;
4957
+ "ttl": number | null;
4958
+ "proxied"?: boolean;
4959
+ "proxyProvider"?: "cloudflare" | "other" | "unknown";
4960
+ "route53Alias"?: {
4961
+ "recordType": "A" | "AAAA";
4962
+ "hostedZoneId": string;
4963
+ };
4964
+ }>;
4965
+ } | null;
4966
+ "checks": {
4967
+ "live": {
4968
+ "state": "pending" | "verified" | "failed";
4969
+ "message": string | null;
4970
+ "checkedAt": string | null;
4971
+ };
4972
+ "traffic": {
4973
+ "state": "pending" | "verified" | "failed";
4974
+ "message": string | null;
4975
+ "checkedAt": string | null;
4976
+ };
4977
+ "checkedAt": string | null;
4978
+ "installation": Array<{
4979
+ "state": "pending" | "verified" | "failed";
4980
+ "message": string | null;
4981
+ "checkedAt": string | null;
4982
+ "name": "ownership" | "certificate" | "hostname" | "origin" | "deployment" | "credential" | "routing" | "dns" | "traffic";
4983
+ }>;
4984
+ };
4985
+ "installation": {
4986
+ "state": "draft" | "canceled" | "provisioning" | "awaiting_verification" | "ready_for_dns" | "active" | "error" | "disconnecting" | "draining" | "disconnected";
4987
+ "stage": "setup" | "ready_for_dns" | "active" | "disconnecting";
4988
+ "originUrl": string;
4989
+ "steps": Array<{
4990
+ "id": string;
4991
+ "title": string;
4992
+ "body": string;
4993
+ "url": string | null;
4994
+ }>;
4995
+ "originProof": {
4996
+ "path": string;
4997
+ "document": {
4998
+ "installationId": string;
4999
+ "publicHostname": string;
5000
+ "token": string;
5001
+ };
5002
+ } | null;
5003
+ "wordpressPlugin": boolean;
5004
+ "originChange": {
5005
+ "id": string;
5006
+ "originUrl": string;
5007
+ "previousOriginUrl": string;
5008
+ "status": "pending" | "verifying" | "switching" | "complete" | "failed";
5009
+ "requestedAt": string;
5010
+ "completedAt": string | null;
5011
+ "failure": {
5012
+ "code": string;
5013
+ "detail": string | null;
5014
+ } | null;
5015
+ } | null;
5016
+ "restoration": {
5017
+ "confirmedAt": string | null;
5018
+ } | null;
5019
+ "failure": {
5020
+ "code": string;
5021
+ "at": string | null;
5022
+ } | null;
5023
+ "nextAttemptAt": string | null;
5024
+ "updatedAt": string;
5025
+ } | null;
5026
+ "credentials": Array<{
5027
+ "id": string;
5028
+ "fingerprint": string;
5029
+ "createdAt": string;
5030
+ "createdBy": string | null;
5031
+ "lastUsedAt": string | null;
5032
+ }>;
5033
+ "lastContactAt": string | null;
5034
+ "transmitterVersion": string | null;
5035
+ };
5036
+ export type FrontConnectionChecksCreateResponse = {
5037
+ "live": {
5038
+ "state": "pending" | "verified" | "failed";
5039
+ "message": string | null;
5040
+ "checkedAt": string | null;
5041
+ };
5042
+ "traffic": {
5043
+ "state": "pending" | "verified" | "failed";
5044
+ "message": string | null;
5045
+ "checkedAt": string | null;
5046
+ };
5047
+ "checkedAt": string | null;
5048
+ "installation": Array<{
5049
+ "state": "pending" | "verified" | "failed";
5050
+ "message": string | null;
5051
+ "checkedAt": string | null;
5052
+ "name": "ownership" | "certificate" | "hostname" | "origin" | "deployment" | "credential" | "routing" | "dns" | "traffic";
5053
+ }>;
5054
+ "streamUrl": string;
5055
+ };
5056
+ export type FrontConnectionCredentialsCreateResponse = {
5057
+ "id": string;
5058
+ "fingerprint": string;
5059
+ "createdAt": string;
5060
+ "createdBy": string | null;
5061
+ "lastUsedAt": string | null;
5062
+ "secret": string;
5063
+ };
5064
+ export type FrontConnectionCredentialsDeleteResponse = {
5065
+ "id": string;
5066
+ "fingerprint": string;
5067
+ "createdAt": string;
5068
+ "createdBy": string | null;
5069
+ "lastUsedAt": string | null;
5070
+ "revokedAt": string;
5071
+ };
5072
+ export type FrontConnectionDnsRecordsListResponse = {
5073
+ "items": Array<{
5074
+ "name": string;
5075
+ "type": "A" | "AAAA" | "CNAME" | "ALIAS" | "TXT" | "CAA";
5076
+ "value": string;
5077
+ "purpose": "ownership" | "certificate" | "traffic" | "restore";
5078
+ "ttl": number | null;
5079
+ "proxied": boolean | null;
5080
+ "proxyProvider": "cloudflare" | "other" | "unknown" | null;
5081
+ "route53Alias": {
5082
+ "recordType": "A" | "AAAA";
5083
+ "hostedZoneId": string;
5084
+ } | null;
5085
+ "previous": boolean;
5086
+ }>;
5087
+ "nextCursor": string | null;
5088
+ };
5089
+ export type FrontConnectionDnsRestorationCreateRequest = {
5090
+ "records": Array<{
5091
+ "name": string;
5092
+ "type": "A" | "AAAA" | "CNAME" | "ALIAS";
5093
+ "value": string;
5094
+ "ttl": number | null;
5095
+ "proxied"?: boolean;
5096
+ "proxyProvider"?: "cloudflare" | "other" | "unknown";
5097
+ "route53Alias"?: {
5098
+ "recordType": "A" | "AAAA";
5099
+ "hostedZoneId": string;
5100
+ };
5101
+ }>;
5102
+ };
5103
+ export type FrontConnectionDnsRestorationCreateResponse = {
5104
+ "method": "managed" | "cloudflare" | "vercel" | "nextjs" | "express" | "other" | null;
5105
+ "status": "not_connected" | "pending" | "connected" | "failed";
5106
+ "hostname": string | null;
5107
+ "nextVersion": "16" | "13-15" | null;
5108
+ "existingMiddleware": boolean | null;
5109
+ "managed": {
5110
+ "hostingProvider": "wpengine" | "kinsta" | "webflow" | "hostinger" | "cloudfront" | "self_hosted";
5111
+ "originUrl": string;
5112
+ "dnsManagement": "external" | "wpengine" | "hostinger" | "flattened" | "apex_proxy";
5113
+ "originalDnsRecords": Array<{
5114
+ "name": string;
5115
+ "type": "A" | "AAAA" | "CNAME" | "ALIAS";
5116
+ "value": string;
5117
+ "ttl": number | null;
5118
+ "proxied"?: boolean;
5119
+ "proxyProvider"?: "cloudflare" | "other" | "unknown";
5120
+ "route53Alias"?: {
5121
+ "recordType": "A" | "AAAA";
5122
+ "hostedZoneId": string;
5123
+ };
5124
+ }>;
5125
+ } | null;
5126
+ "checks": {
5127
+ "live": {
5128
+ "state": "pending" | "verified" | "failed";
5129
+ "message": string | null;
5130
+ "checkedAt": string | null;
5131
+ };
5132
+ "traffic": {
5133
+ "state": "pending" | "verified" | "failed";
5134
+ "message": string | null;
5135
+ "checkedAt": string | null;
5136
+ };
5137
+ "checkedAt": string | null;
5138
+ "installation": Array<{
5139
+ "state": "pending" | "verified" | "failed";
5140
+ "message": string | null;
5141
+ "checkedAt": string | null;
5142
+ "name": "ownership" | "certificate" | "hostname" | "origin" | "deployment" | "credential" | "routing" | "dns" | "traffic";
5143
+ }>;
5144
+ };
5145
+ "installation": {
5146
+ "state": "draft" | "canceled" | "provisioning" | "awaiting_verification" | "ready_for_dns" | "active" | "error" | "disconnecting" | "draining" | "disconnected";
5147
+ "stage": "setup" | "ready_for_dns" | "active" | "disconnecting";
5148
+ "originUrl": string;
5149
+ "steps": Array<{
5150
+ "id": string;
5151
+ "title": string;
5152
+ "body": string;
5153
+ "url": string | null;
5154
+ }>;
5155
+ "originProof": {
5156
+ "path": string;
5157
+ "document": {
5158
+ "installationId": string;
5159
+ "publicHostname": string;
5160
+ "token": string;
5161
+ };
5162
+ } | null;
5163
+ "wordpressPlugin": boolean;
5164
+ "originChange": {
5165
+ "id": string;
5166
+ "originUrl": string;
5167
+ "previousOriginUrl": string;
5168
+ "status": "pending" | "verifying" | "switching" | "complete" | "failed";
5169
+ "requestedAt": string;
5170
+ "completedAt": string | null;
5171
+ "failure": {
5172
+ "code": string;
5173
+ "detail": string | null;
5174
+ } | null;
5175
+ } | null;
5176
+ "restoration": {
5177
+ "confirmedAt": string | null;
5178
+ } | null;
5179
+ "failure": {
5180
+ "code": string;
5181
+ "at": string | null;
5182
+ } | null;
5183
+ "nextAttemptAt": string | null;
5184
+ "updatedAt": string;
5185
+ } | null;
5186
+ "credentials": Array<{
5187
+ "id": string;
5188
+ "fingerprint": string;
5189
+ "createdAt": string;
5190
+ "createdBy": string | null;
5191
+ "lastUsedAt": string | null;
5192
+ }>;
5193
+ "lastContactAt": string | null;
5194
+ "transmitterVersion": string | null;
5195
+ };
5196
+ export type FrontConnectionInstallGetResponse = {
5197
+ "method": "cloudflare" | "vercel" | "nextjs" | "express" | "other";
5198
+ "files": Array<{
5199
+ "path": string;
5200
+ "content": string;
5201
+ }>;
5202
+ "env": Array<{
5203
+ "name": string;
5204
+ "value": string | null;
5205
+ "secret": boolean;
5206
+ "operation"?: string;
5207
+ "description": string;
5208
+ }>;
5209
+ "route": string;
5210
+ "commands": Array<string>;
5211
+ "statusUrl": string | null;
5212
+ };
5213
+ export type FrontConnectionOriginChangesCreateRequest = {
5214
+ "originUrl": string;
5215
+ };
5216
+ export type FrontConnectionOriginChangesCreateResponse = {
5217
+ "id": string;
5218
+ "originUrl": string;
5219
+ "previousOriginUrl": string;
5220
+ "status": "pending" | "verifying" | "switching" | "complete" | "failed";
5221
+ "requestedAt": string;
5222
+ "completedAt": string | null;
5223
+ "failure": {
5224
+ "code": string;
5225
+ "detail": string | null;
5226
+ } | null;
5227
+ };
5228
+ export type FrontConnectionOriginChangesGetResponse = {
5229
+ "id": string;
5230
+ "originUrl": string;
5231
+ "previousOriginUrl": string;
5232
+ "status": "pending" | "verifying" | "switching" | "complete" | "failed";
5233
+ "requestedAt": string;
5234
+ "completedAt": string | null;
5235
+ "failure": {
5236
+ "code": string;
5237
+ "detail": string | null;
5238
+ } | null;
5239
+ };
5240
+ export type FrontConnectionWordpressPluginGetResponse = {
5241
+ "fileName": string;
5242
+ "contentType": "application/zip";
5243
+ "contentBase64": string;
5244
+ };
5245
+ export type FrontDenialsListResponse = {
5246
+ "items": Array<{
5247
+ "occurredAt": string;
5248
+ "visitorId": string | null;
5249
+ "operator": string | null;
5250
+ "kind": "ai_agent" | "ai_crawler" | "search_crawler" | "tool" | "human" | "unknown";
5251
+ "method": string;
5252
+ "path": string;
5253
+ "status": 401 | 403;
5254
+ }>;
5255
+ "nextCursor": string | null;
5256
+ "total": number;
5257
+ };
5258
+ export type FrontFeedbackListResponse = {
5259
+ "items": Array<{
5260
+ "id": string;
5261
+ "outcome": "success" | "partial" | "failure";
5262
+ "task": string | null;
5263
+ "detail": string | null;
5264
+ "page": string | null;
5265
+ "agent": string | null;
5266
+ "receivedAt": string;
5267
+ }>;
5268
+ "nextCursor": string | null;
5269
+ };
5270
+ export type FrontMcpServerGetResponse = {
5271
+ "source": "undecided" | "ora" | "own_server";
5272
+ "server": {
5273
+ "path": string;
5274
+ "url": string;
5275
+ "status": "reachable" | "unreachable" | "not_mcp" | "needs_sign_in";
5276
+ "tools": Array<{
5277
+ "name": string;
5278
+ "title": string | null;
5279
+ "description": string | null;
5280
+ }>;
5281
+ } | null;
5282
+ "ask": boolean;
5283
+ "feedback": boolean;
5284
+ "oraTools": boolean;
5285
+ };
5286
+ export type FrontMcpServerUpdateRequest = {
5287
+ "server"?: {
5288
+ "path": string;
5289
+ } | null;
5290
+ "source"?: "ora";
5291
+ "ask"?: boolean;
5292
+ "feedback"?: boolean;
5293
+ "oraTools"?: boolean;
5294
+ };
5295
+ export type FrontMcpServerUpdateResponse = {
5296
+ "source": "undecided" | "ora" | "own_server";
5297
+ "server": {
5298
+ "path": string;
5299
+ "url": string;
5300
+ "status": "reachable" | "unreachable" | "not_mcp" | "needs_sign_in";
5301
+ "tools": Array<{
5302
+ "name": string;
5303
+ "title": string | null;
5304
+ "description": string | null;
5305
+ }>;
5306
+ } | null;
5307
+ "ask": boolean;
5308
+ "feedback": boolean;
5309
+ "oraTools": boolean;
5310
+ };
5311
+ export type FrontPagesListResponse = {
5312
+ "items": Array<{
5313
+ "id": string;
5314
+ "path": string;
5315
+ "inFront": boolean;
5316
+ "sources": Array<"sitemap" | "traffic" | "rule" | "edit" | "front">;
5317
+ "agentRequests": number | null;
5318
+ "serving": {
5319
+ "action": "origin" | "serve" | "block" | "passthrough";
5320
+ "strategies": Array<string>;
5321
+ "byAgentVersion": boolean;
5322
+ };
5323
+ "unreadableReason": string | null;
5324
+ "agentVersion": {
5325
+ "source": "auto" | "edited";
5326
+ "editedAt": string | null;
5327
+ };
5328
+ }>;
5329
+ "nextCursor": string | null;
5330
+ };
5331
+ export type FrontPagesGetResponse = {
5332
+ "id": string;
5333
+ "path": string;
5334
+ "inFront": boolean;
5335
+ "sources": Array<"sitemap" | "traffic" | "rule" | "edit" | "front">;
5336
+ "agentRequests": number | null;
5337
+ "serving": {
5338
+ "action": "origin" | "serve" | "block" | "passthrough";
5339
+ "strategies": Array<string>;
5340
+ "byAgentVersion": boolean;
5341
+ };
5342
+ "unreadableReason": string | null;
5343
+ "agentVersion": {
5344
+ "pageId": string;
5345
+ "path": string;
5346
+ "source": "auto" | "edited";
5347
+ "editedAt": string | null;
5348
+ "content": string | null;
5349
+ "generatedContent": string | null;
5350
+ "generatedAt": string | null;
5351
+ "generationIssue": {
5352
+ "code": string | null;
5353
+ "reason": string;
5354
+ } | null;
5355
+ };
5356
+ "front": {
5357
+ "title": string | null;
5358
+ "url": string;
5359
+ "markdown": string;
5360
+ "readAt": string;
5361
+ } | null;
5362
+ };
5363
+ export type FrontPagesAgentVersionUpdateRequest = {
5364
+ "content": string;
5365
+ };
5366
+ export type FrontPagesAgentVersionUpdateResponse = {
5367
+ "pageId": string;
5368
+ "path": string;
5369
+ "source": "auto" | "edited";
5370
+ "editedAt": string | null;
5371
+ "content": string | null;
5372
+ "generatedContent": string | null;
5373
+ "generatedAt": string | null;
5374
+ "generationIssue": {
5375
+ "code": string | null;
5376
+ "reason": string;
5377
+ } | null;
5378
+ };
5379
+ export type FrontPagesAgentVersionDeleteResponse = {
5380
+ "pageId": string;
5381
+ "path": string;
5382
+ "source": "auto" | "edited";
5383
+ "editedAt": string | null;
5384
+ "content": string | null;
5385
+ "generatedContent": string | null;
5386
+ "generatedAt": string | null;
5387
+ "generationIssue": {
5388
+ "code": string | null;
5389
+ "reason": string;
5390
+ } | null;
5391
+ };
5392
+ export type FrontPagesAgentVersionRegenerateResponse = {
5393
+ "pageId": string;
5394
+ "path": string;
5395
+ "source": "auto" | "edited";
5396
+ "editedAt": string | null;
5397
+ "content": string | null;
5398
+ "generatedContent": string | null;
5399
+ "generatedAt": string | null;
5400
+ "generationIssue": {
5401
+ "code": string | null;
5402
+ "reason": string;
5403
+ } | null;
5404
+ };
5405
+ export type FrontPagesScreenshotGetResponse = {
5406
+ "pageId": string;
5407
+ "path": string;
5408
+ "status": "ready" | "disabled" | "busy" | "failed" | "blocked";
5409
+ "image": string | null;
5410
+ "finalUrl": string | null;
5411
+ "capturedAt": string | null;
5412
+ "blockedBy": string | null;
5413
+ };
5414
+ export type FrontProtocolsGetResponse = {
5415
+ "address": {
5416
+ "nlweb": boolean;
5417
+ "mcp": boolean;
5418
+ };
5419
+ "website": {
5420
+ "nlweb": boolean;
5421
+ "mcp": boolean;
5422
+ };
5423
+ "websiteAvailability": {
5424
+ "available": boolean;
5425
+ "reason": "not_connected" | "agent_serving_off" | "not_live" | null;
5426
+ };
5427
+ "endpoints": {
5428
+ "address": {
5429
+ "nlweb": string | null;
5430
+ "mcp": string | null;
5431
+ };
5432
+ "website": {
5433
+ "nlweb": string | null;
5434
+ "mcp": string | null;
5435
+ };
5436
+ };
5437
+ "mcpServerPath": string | null;
5438
+ };
5439
+ export type FrontProtocolsUpdateRequest = {
5440
+ "address"?: {
5441
+ "nlweb"?: boolean;
5442
+ "mcp"?: boolean;
5443
+ };
5444
+ "website"?: {
5445
+ "nlweb"?: boolean;
5446
+ "mcp"?: boolean;
5447
+ };
5448
+ };
5449
+ export type FrontProtocolsUpdateResponse = {
5450
+ "address": {
5451
+ "nlweb": boolean;
5452
+ "mcp": boolean;
5453
+ };
5454
+ "website": {
5455
+ "nlweb": boolean;
5456
+ "mcp": boolean;
5457
+ };
5458
+ "websiteAvailability": {
5459
+ "available": boolean;
5460
+ "reason": "not_connected" | "agent_serving_off" | "not_live" | null;
5461
+ };
5462
+ "endpoints": {
5463
+ "address": {
5464
+ "nlweb": string | null;
5465
+ "mcp": string | null;
5466
+ };
5467
+ "website": {
5468
+ "nlweb": string | null;
5469
+ "mcp": string | null;
5470
+ };
5471
+ };
5472
+ "mcpServerPath": string | null;
5473
+ };
5474
+ export type FrontQuestionsListResponse = {
5475
+ "from": string;
5476
+ "to": string;
5477
+ "asked": number;
5478
+ "notOnSite": number;
5479
+ "reads": number;
5480
+ "days": Array<{
5481
+ "day": string;
5482
+ "asked": number;
5483
+ "notOnSite": number;
5484
+ }>;
5485
+ "questions": Array<{
5486
+ "question": string;
5487
+ "asks": number;
5488
+ "answered": number;
5489
+ "notOnSite": number;
5490
+ "lastAskedAt": string;
5491
+ "sources": Array<"ask" | "mcp" | "webmcp" | "own_mcp_server">;
5492
+ "agents": Array<{
5493
+ "visitorId": string | null;
5494
+ "operator": string | null;
5495
+ }>;
5496
+ }>;
5497
+ };
5498
+ export type FrontReaderAccessGetResponse = {
5499
+ "check": {
5500
+ "checkedAt": string;
5501
+ "outcome": "in" | "challenged" | "refused" | "unreachable";
5502
+ "status": number | null;
5503
+ "vendor": string | null;
5504
+ } | null;
5505
+ "egressIps": Array<string>;
5506
+ };
5507
+ export type FrontReaderAccessCheckResponse = {
5508
+ "check": {
5509
+ "checkedAt": string;
5510
+ "outcome": "in" | "challenged" | "refused" | "unreachable";
5511
+ "status": number | null;
5512
+ "vendor": string | null;
5513
+ };
5514
+ "egressIps": Array<string>;
5515
+ "site": {
5516
+ "id": string;
5517
+ "hostname": string;
5518
+ "status": "building" | "live" | "held" | "failed";
5519
+ "build": {
5520
+ "id": string;
5521
+ "kind": "first" | "rest_of_site" | "rebuild";
5522
+ "state": "queued" | "running" | "live" | "held" | "failed" | "canceled";
5523
+ "step": string | null;
5524
+ "pagesFound": number;
5525
+ "pagesRead": number;
5526
+ "failure": {
5527
+ "code": string;
5528
+ "detail": string;
5529
+ } | null;
5530
+ "startedAt": string | null;
5531
+ "finishedAt": string | null;
5532
+ } | null;
5533
+ "address": {
5534
+ "name": string;
5535
+ "url": string;
5536
+ "mcpUrl": string;
5537
+ "llmsTxtUrl": string;
5538
+ "open"?: boolean;
5539
+ } | null;
5540
+ "connection"?: {
5541
+ "method": "managed" | "cloudflare" | "vercel" | "nextjs" | "express" | "other" | null;
5542
+ "status": "not_connected" | "pending" | "connected" | "failed";
5543
+ };
5544
+ "protocols"?: {
5545
+ "address": {
5546
+ "nlweb": boolean;
5547
+ "mcp": boolean;
5548
+ };
5549
+ "website": {
5550
+ "nlweb": boolean;
5551
+ "mcp": boolean;
5552
+ };
5553
+ };
5554
+ "serving"?: {
5555
+ "mode": "off" | "monitor" | "autopilot";
5556
+ };
5557
+ "nextSteps": Array<{
5558
+ "id": "retry_setup" | "allow_reader" | "connect_website" | "verify_traffic" | "serve_agents" | "add_action";
5559
+ "done": boolean;
5560
+ "title": string;
5561
+ "operation": string;
5562
+ }>;
5563
+ "version": string;
5564
+ "createdAt": string;
5565
+ "streamUrl": string;
5566
+ };
5567
+ };
5568
+ export type FrontRequestsListResponse = {
5569
+ "items": Array<{
5570
+ "id": string;
5571
+ "actionId": string;
5572
+ "actionName": string;
5573
+ "actionTitle": string;
5574
+ "agent": string | null;
5575
+ "status": "open" | "handled";
5576
+ "receivedAt": string;
5577
+ "handledAt": string | null;
5578
+ "fields"?: Record<string, unknown>;
5579
+ }>;
5580
+ "nextCursor": string | null;
5581
+ };
5582
+ export type FrontRequestsUpdateRequest = {
5583
+ "status": "open" | "handled";
5584
+ };
5585
+ export type FrontRequestsUpdateResponse = {
5586
+ "id": string;
5587
+ "actionId": string;
5588
+ "actionName": string;
5589
+ "actionTitle": string;
5590
+ "agent": string | null;
5591
+ "status": "open" | "handled";
5592
+ "receivedAt": string;
5593
+ "handledAt": string | null;
5594
+ "fields"?: Record<string, unknown>;
5595
+ };
5596
+ export type FrontSitesRetryResponse = {
5597
+ "id": string;
5598
+ "hostname": string;
5599
+ "status": "building" | "live" | "held" | "failed";
5600
+ "build": {
5601
+ "id": string;
5602
+ "kind": "first" | "rest_of_site" | "rebuild";
5603
+ "state": "queued" | "running" | "live" | "held" | "failed" | "canceled";
5604
+ "step": string | null;
5605
+ "pagesFound": number;
5606
+ "pagesRead": number;
5607
+ "failure": {
5608
+ "code": string;
5609
+ "detail": string;
5610
+ } | null;
5611
+ "startedAt": string | null;
5612
+ "finishedAt": string | null;
5613
+ } | null;
5614
+ "address": {
5615
+ "name": string;
5616
+ "url": string;
5617
+ "mcpUrl": string;
5618
+ "llmsTxtUrl": string;
5619
+ "open"?: boolean;
5620
+ } | null;
5621
+ "connection"?: {
5622
+ "method": "managed" | "cloudflare" | "vercel" | "nextjs" | "express" | "other" | null;
5623
+ "status": "not_connected" | "pending" | "connected" | "failed";
5624
+ };
5625
+ "protocols"?: {
5626
+ "address": {
5627
+ "nlweb": boolean;
5628
+ "mcp": boolean;
5629
+ };
5630
+ "website": {
5631
+ "nlweb": boolean;
5632
+ "mcp": boolean;
5633
+ };
5634
+ };
5635
+ "serving"?: {
5636
+ "mode": "off" | "monitor" | "autopilot";
5637
+ };
5638
+ "nextSteps": Array<{
5639
+ "id": "retry_setup" | "allow_reader" | "connect_website" | "verify_traffic" | "serve_agents" | "add_action";
5640
+ "done": boolean;
5641
+ "title": string;
5642
+ "operation": string;
5643
+ }>;
5644
+ "version": string;
5645
+ "createdAt": string;
5646
+ "streamUrl": string;
5647
+ };
5648
+ export type FrontScoreGetResponse = {
5649
+ "value": number | null;
5650
+ "grade": string | null;
5651
+ "withFront": {
5652
+ "value": number | null;
5653
+ "grade": string | null;
5654
+ } | null;
5655
+ "checkedAt": string | null;
5656
+ };
5657
+ export type FrontServingGetResponse = {
5658
+ "mode": "off" | "monitor" | "autopilot";
5659
+ "markdown": {
5660
+ "enabled": boolean;
5661
+ "negotiate": boolean;
5662
+ };
5663
+ "agentFiles": {
5664
+ "enabled": boolean;
5665
+ };
5666
+ "propagationSeconds": number;
5667
+ };
5668
+ export type FrontServingUpdateRequest = {
5669
+ "mode"?: "off" | "monitor" | "autopilot";
5670
+ "markdown"?: {
5671
+ "enabled"?: boolean;
5672
+ "negotiate"?: boolean;
5673
+ };
5674
+ "agentFiles"?: {
5675
+ "enabled"?: boolean;
5676
+ };
5677
+ };
5678
+ export type FrontServingUpdateResponse = {
5679
+ "mode": "off" | "monitor" | "autopilot";
5680
+ "markdown": {
5681
+ "enabled": boolean;
5682
+ "negotiate": boolean;
5683
+ };
5684
+ "agentFiles": {
5685
+ "enabled": boolean;
5686
+ };
5687
+ "propagationSeconds": number;
5688
+ };
5689
+ export type FrontToolSetupsCreateRequest = {
5690
+ "discover"?: boolean;
5691
+ };
5692
+ export type FrontToolSetupsCreateResponse = {
5693
+ "id": string | null;
5694
+ "status": "queued" | "running" | "succeeded" | "failed" | "canceled";
5695
+ "step": string | null;
5696
+ "actions": {
5697
+ "built": number;
5698
+ "verified": number;
5699
+ "live": number;
5700
+ };
5701
+ "error": string | null;
5702
+ "createdAt": string;
5703
+ "startedAt": string | null;
5704
+ "finishedAt": string | null;
5705
+ "streamUrl": string;
5706
+ };
5707
+ export type FrontToolSetupsGetResponse = {
5708
+ "id": string | null;
5709
+ "status": "queued" | "running" | "succeeded" | "failed" | "canceled";
5710
+ "step": string | null;
5711
+ "actions": {
5712
+ "built": number;
5713
+ "verified": number;
5714
+ "live": number;
5715
+ };
5716
+ "error": string | null;
5717
+ "createdAt": string;
5718
+ "startedAt": string | null;
5719
+ "finishedAt": string | null;
5720
+ "streamUrl": string;
5721
+ };
5722
+ export type FrontTrafficGetResponse = {
5723
+ "from": string;
5724
+ "to": string;
5725
+ "pageFilter": Array<string>;
5726
+ "totals": {
5727
+ "requests": number;
5728
+ "agentRequests": number;
5729
+ "humanRequests": number;
5730
+ "unknownRequests": number;
5731
+ "agentPercent": number;
5732
+ };
5733
+ "breakdown": Array<{
5734
+ "kind": "ai_agent" | "ai_crawler" | "search_crawler" | "tool" | "human" | "unknown";
5735
+ "visitorId": string | null;
5736
+ "operator": string | null;
5737
+ "purpose": "training_crawl" | "search_index" | "live_fetch" | "agent_action" | "browsing" | null;
5738
+ "statusClass": string;
5739
+ "requests": number;
5740
+ "distinctClients": number | null;
5741
+ "percent": number;
5742
+ }>;
5743
+ "days": Array<{
5744
+ "day": string;
5745
+ "requests": number;
5746
+ "agentRequests": number;
5747
+ "liveRequests": number;
5748
+ "livePercent": number;
5749
+ "lowVolume": boolean;
5750
+ }>;
5751
+ };
5752
+ export type FrontTrafficAnswersListResponse = {
5753
+ "from": string;
5754
+ "to": string;
5755
+ "total": number;
5756
+ "days": Array<{
5757
+ "day": string;
5758
+ "answers": number;
5759
+ }>;
5760
+ };
5761
+ export type FrontTrafficHostsListResponse = {
5762
+ "hosts": Array<{
5763
+ "host": string;
5764
+ "requests": number;
5765
+ "peopleAndAgentRequests": number;
5766
+ "firstDay": string;
5767
+ "lastDay": string;
5768
+ }>;
5769
+ };
5770
+ export type FrontTrafficMissesListResponse = {
5771
+ "from": string;
5772
+ "to": string;
5773
+ "agents": "all" | "live" | "crawl";
5774
+ "paths": Array<{
5775
+ "path": string;
5776
+ "misses": number;
5777
+ "visitorIds": Array<string>;
5778
+ "lastSeenAt": string;
5779
+ "statuses": Array<{
5780
+ "status": number;
5781
+ "requests": number;
5782
+ "agents": Array<{
5783
+ "visitorId": string;
5784
+ "operator": string | null;
5785
+ }>;
5786
+ }>;
5787
+ }>;
5788
+ };
5789
+ export type FrontTrafficPagesListResponse = {
5790
+ "from": string;
5791
+ "to": string;
5792
+ "agents": "all" | "live" | "crawl";
5793
+ "pageFilter": Array<string>;
5794
+ "paths": Array<{
5795
+ "path": string;
5796
+ "agentRequests": number;
5797
+ "humanRequests": number;
5798
+ "agentToHumanRatio": number | null;
5799
+ "lastSeenAt": string;
5800
+ "agents": Array<{
5801
+ "visitorId": string;
5802
+ "requests": number;
5803
+ "percent": number;
5804
+ }>;
5805
+ }>;
5806
+ "group": {
5807
+ "path": string;
5808
+ "pages": Array<{
5809
+ "path": string;
5810
+ "requests": number;
5811
+ }>;
5812
+ "totalPages": number;
5813
+ "totalRequests": number;
5814
+ } | null;
5815
+ };
5816
+ export type FrontTrafficProtocolsListResponse = {
5817
+ "from": string;
5818
+ "to": string;
5819
+ "callers": "all" | "agents";
5820
+ "ask": {
5821
+ "calls": number;
5822
+ "answered": number;
5823
+ "noResults": number;
5824
+ "failed": number;
5825
+ "cancelled": number;
5826
+ "otherCalls": number | null;
5827
+ "days": Array<{
5828
+ "day": string;
5829
+ "calls": number;
5830
+ }>;
5831
+ "agents": Array<{
5832
+ "visitorId": string | null;
5833
+ "operator": string | null;
5834
+ "kind": "ai_agent" | "ai_crawler" | "search_crawler" | "tool" | "human" | "unknown";
5835
+ "calls": number;
5836
+ }>;
5837
+ };
5838
+ "mcp": {
5839
+ "calls": number;
5840
+ "answered": number;
5841
+ "noResults": number;
5842
+ "failed": number;
5843
+ "cancelled": number;
5844
+ "otherCalls": number | null;
5845
+ "days": Array<{
5846
+ "day": string;
5847
+ "calls": number;
5848
+ }>;
5849
+ "agents": Array<{
5850
+ "visitorId": string | null;
5851
+ "operator": string | null;
5852
+ "kind": "ai_agent" | "ai_crawler" | "search_crawler" | "tool" | "human" | "unknown";
5853
+ "calls": number;
5854
+ }>;
5855
+ };
5856
+ "webmcp": {
5857
+ "calls": number;
5858
+ "withIntent": number;
5859
+ "tools": Array<{
5860
+ "name": string;
5861
+ "calls": number;
5862
+ "withIntent": number;
5863
+ "distinctIntents": number;
5864
+ }>;
5865
+ };
5866
+ };
5867
+ export type FrontTrafficReferralsListResponse = {
5868
+ "from": string;
5869
+ "to": string;
5870
+ "pageFilter": Array<string>;
5871
+ "surfaces": Array<{
5872
+ "surface": string;
5873
+ "arrivals": number;
5874
+ "people": number | null;
5875
+ "landingPageCount": number;
5876
+ "percent": number;
5877
+ "lastSeenAt": string;
5878
+ }>;
5879
+ "landingPages": Array<{
5880
+ "surface": string;
5881
+ "path": string;
5882
+ "arrivals": number;
5883
+ "people": number | null;
5884
+ "lastSeenAt": string;
5885
+ }>;
5886
+ "totalArrivals": number;
5887
+ };
5888
+ export type FrontVisitorsListResponse = {
5889
+ "from": string;
5890
+ "to": string;
5891
+ "identityChecked": boolean;
5892
+ "totals": {
5893
+ "requests": number;
5894
+ "verifiedRequests": number;
5895
+ "impersonatorRequests": number;
5896
+ "blockedRequests": number;
5897
+ };
5898
+ "visitors": Array<{
5899
+ "id": string;
5900
+ "name": string;
5901
+ "operator": string | null;
5902
+ "kind": "ai_agent" | "ai_crawler" | "search_crawler" | "tool" | "human" | "unknown";
5903
+ "purpose": "training_crawl" | "search_index" | "live_fetch" | "agent_action" | "browsing" | null;
5904
+ "requests": number;
5905
+ "verifiedRequests": number;
5906
+ "impersonatorRequests": number;
5907
+ "blockedRequests": number;
5908
+ "lastSeenAt": string | null;
5909
+ "rule": "allow" | "disallow" | "block" | null;
5910
+ "access": {
5911
+ "action": "allow" | "disallow" | "block";
5912
+ "source": "rule" | "category" | "default";
5913
+ };
5914
+ "categoryExempt": boolean;
5915
+ "known": boolean;
5916
+ }>;
5917
+ "unidentified": Array<{
5918
+ "userAgent": string;
5919
+ "requests": number;
5920
+ }>;
5921
+ };
5922
+ export type FrontVisitorsRuleUpdateRequest = {
5923
+ "action": "allow" | "block";
5924
+ };
5925
+ export type FrontVisitorsRuleUpdateResponse = {
5926
+ "id": string;
5927
+ "rule": "allow" | "disallow" | "block" | null;
5928
+ "access": {
5929
+ "action": "allow" | "disallow" | "block";
5930
+ "source": "rule" | "category" | "default";
5931
+ };
5932
+ };
5933
+ export type FrontVisitorsRuleDeleteResponse = {
5934
+ "id": string;
5935
+ "rule": "allow" | "disallow" | "block" | null;
5936
+ "access": {
5937
+ "action": "allow" | "disallow" | "block";
5938
+ "source": "rule" | "category" | "default";
5939
+ };
5940
+ };
5941
+ export type FrontWebhookSigningKeyRevealResponse = {
5942
+ "fingerprint": string;
5943
+ "algorithm": string;
5944
+ "signatureHeader": string;
5945
+ "createdAt": string | null;
5946
+ "secret": string;
5947
+ };
5948
+ export type FrontWebmcpGetResponse = {
5949
+ "tools": Array<{
5950
+ "name": string;
5951
+ "description": string;
5952
+ }> | null;
5953
+ "siteSummary": string | null;
5954
+ "scriptUrl": string | null;
5955
+ "skipReason": string | null;
5956
+ "notice": string | null;
5957
+ };
5958
+ export type FrontWebmcpGenerateResponse = {
5959
+ "tools": Array<{
5960
+ "name": string;
5961
+ "description": string;
5962
+ }> | null;
5963
+ "siteSummary": string | null;
5964
+ "scriptUrl": string | null;
5965
+ "skipReason": string | null;
5966
+ "notice": string | null;
5967
+ };
5968
+ export type FrontUsageGetResponse = {
5969
+ "plan": {
5970
+ "name": string;
5971
+ "displayName": string;
5972
+ };
5973
+ "limits": {
5974
+ "sites": number | null;
5975
+ "pages": number | null;
5976
+ "answers": number | null;
5977
+ };
5978
+ "usage": {
5979
+ "sites": number;
5980
+ "pages": number | null;
5981
+ "answers": number;
5982
+ "answersPaused": boolean;
5983
+ "resetsAt": string | null;
5984
+ };
5985
+ "firstBuildPages": number;
5986
+ };
5987
+ export type GoalsUpdateRequest = {
5988
+ "title"?: string;
5989
+ "statement"?: string;
5990
+ "isActive"?: boolean;
5991
+ "config"?: unknown;
5992
+ "types"?: "all" | Array<"discover" | "choose" | "verify" | "inform" | "guide" | "act">;
5993
+ "category"?: "recommended" | "answered" | "accurate" | "informed" | "capability" | "real_steps" | "safe" | "task_done" | "other";
5994
+ };
5995
+ export type GoalsUpdateResponse = {
5996
+ "success": true;
5997
+ "data": {
5998
+ "id": string;
5999
+ "intentId": string;
6000
+ "kind": "target_match" | "state_assertion" | "answer_check";
6001
+ "criterionGroup": "discover" | "choose" | "verify" | "inform" | "guide" | "act" | null;
6002
+ "allTypes": boolean;
6003
+ "types": Array<"discover" | "choose" | "verify" | "inform" | "guide" | "act">;
6004
+ "category": "recommended" | "answered" | "accurate" | "informed" | "capability" | "real_steps" | "safe" | "task_done" | "other" | null;
6005
+ "categorySetBy": "ora" | "caller" | null;
6006
+ "isDrafted": boolean;
6007
+ "title": string;
6008
+ "statement": string | null;
6009
+ "config": unknown;
6010
+ "isActive": boolean;
6011
+ "position": number;
6012
+ "createdBy": string | null;
6013
+ "createdAt": string;
6014
+ "updatedAt": string;
6015
+ };
6016
+ };
6017
+ export type GoalsDeleteResponse = {
6018
+ "success": true;
6019
+ "data": {
6020
+ "id": string;
6021
+ };
6022
+ };
6023
+ export type IcpsListResponse = {
6024
+ "success": true;
6025
+ "data": {
6026
+ "icps": Array<{
6027
+ "id": string;
6028
+ "label": string;
6029
+ "description": string;
6030
+ }>;
6031
+ };
6032
+ };
6033
+ export type IcpsCreateRequest = {
6034
+ "domainId": string;
6035
+ "description": string;
6036
+ "label"?: string;
6037
+ };
6038
+ export type IcpsCreateResponse = {
6039
+ "success": true;
6040
+ "data": {
6041
+ "id": string;
6042
+ "label": string;
6043
+ "description": string;
6044
+ };
6045
+ };
6046
+ export type IcpsUpdateRequest = {
6047
+ "label"?: string;
6048
+ "description"?: string;
6049
+ "isActive"?: boolean;
6050
+ };
6051
+ export type IcpsUpdateResponse = {
6052
+ "success": true;
6053
+ "data": {
6054
+ "updated": boolean;
6055
+ };
6056
+ };
6057
+ export type IntentsListResponse = {
6058
+ "success": true;
6059
+ "data": Array<{
6060
+ "id": string;
6061
+ "title": string;
6062
+ "slug": string;
6063
+ "domainId": string | null;
6064
+ "promptCount": number;
6065
+ "tags": Array<string>;
6066
+ "goalKinds": Array<"target_match" | "state_assertion" | "answer_check">;
6067
+ "stageTags": Array<"discovery" | "access" | "use">;
6068
+ "success": number | null;
6069
+ "friction": {
6070
+ "kind": "healthy";
6071
+ } | {
6072
+ "kind": "stage";
6073
+ "stage": "discovery" | "access" | "use";
6074
+ "broke": number;
6075
+ "reached": number;
6076
+ } | {
6077
+ "kind": "multiple";
6078
+ "broke": number;
6079
+ "reached": number;
6080
+ };
6081
+ "health": {
6082
+ "band": "healthy" | "watch" | "broken" | "unknown";
6083
+ "score": number | null;
6084
+ };
6085
+ "sparkline": Array<{
6086
+ "day": string;
6087
+ "value": number | null;
6088
+ }>;
6089
+ "coverage": {
6090
+ "runs": number;
6091
+ "conclusive": number;
6092
+ "unmeasurable": number;
6093
+ "expected": number;
6094
+ };
6095
+ "lowSample": boolean;
6096
+ "measurementPolicy": {
6097
+ "cadence": "daily" | "weekly" | "monthly" | "manual";
6098
+ "mcp_server_ids": Array<string>;
6099
+ "agents": Array<{
6100
+ "harness": string;
6101
+ "model": string;
6102
+ "mcp_server_ids": Array<string>;
6103
+ "skill_ids": Array<string>;
6104
+ "browser"?: {
6105
+ "webdriver"?: boolean;
6106
+ "webmcp"?: boolean;
6107
+ "webmcpTargetUrl"?: string;
6108
+ "webmcpSurface"?: "native" | "shim";
6109
+ };
6110
+ }>;
6111
+ "skill_ids": Array<string>;
6112
+ "browser"?: {
6113
+ "webdriver"?: boolean;
6114
+ "webmcp"?: boolean;
6115
+ "webmcpTargetUrl"?: string;
6116
+ "webmcpSurface"?: "native" | "shim";
6117
+ };
6118
+ "competitors": Array<string>;
4324
6119
  };
4325
6120
  }>;
4326
6121
  };
@@ -6249,6 +8044,27 @@ export type StudyBenchmarkDefinitionsAttachCorpusRequest = {
6249
8044
  "limit"?: number;
6250
8045
  "changelog"?: string;
6251
8046
  };
8047
+ export type StudyBenchmarkDefinitionsAttachCorpusResponse = {
8048
+ "job": {
8049
+ "id": string;
8050
+ "definitionId": string;
8051
+ "status": "queued" | "running" | "succeeded" | "failed";
8052
+ "door": "platform" | "organization";
8053
+ "request": Record<string, unknown>;
8054
+ "result": Record<string, unknown> | null;
8055
+ "error": {
8056
+ "code": string;
8057
+ "message": string;
8058
+ "detail"?: unknown;
8059
+ } | null;
8060
+ "executor": string;
8061
+ "worker": string | null;
8062
+ "createdAt": string;
8063
+ "startedAt": string | null;
8064
+ "finishedAt": string | null;
8065
+ };
8066
+ "streamUrl": string;
8067
+ };
6252
8068
  export type StudyBenchmarkDefinitionsPublishRequest = {
6253
8069
  "version"?: number;
6254
8070
  };