@shapeshift-labs/frontier-swarm 0.5.20 → 0.5.22

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 (354) hide show
  1. package/README.md +123 -132
  2. package/benchmarks/package-bench.mjs +294 -20
  3. package/dist/index.d.ts +4801 -41
  4. package/dist/index.d.ts.map +1 -1
  5. package/dist/index.js +10368 -40
  6. package/dist/index.js.map +1 -1
  7. package/package.json +6 -7
  8. package/benchmarks/package-bench-fixtures.mjs +0 -95
  9. package/benchmarks/package-bench-rows.mjs +0 -211
  10. package/benchmarks/package-bench-runtime.mjs +0 -94
  11. package/dist/adaptive-load-decisions.d.ts +0 -8
  12. package/dist/adaptive-load-decisions.d.ts.map +0 -1
  13. package/dist/adaptive-load-decisions.js +0 -133
  14. package/dist/adaptive-load-decisions.js.map +0 -1
  15. package/dist/adaptive-load-limits.d.ts +0 -8
  16. package/dist/adaptive-load-limits.d.ts.map +0 -1
  17. package/dist/adaptive-load-limits.js +0 -105
  18. package/dist/adaptive-load-limits.js.map +0 -1
  19. package/dist/adaptive-load-observations.d.ts +0 -17
  20. package/dist/adaptive-load-observations.d.ts.map +0 -1
  21. package/dist/adaptive-load-observations.js +0 -296
  22. package/dist/adaptive-load-observations.js.map +0 -1
  23. package/dist/adaptive-load-types.d.ts +0 -117
  24. package/dist/adaptive-load-types.d.ts.map +0 -1
  25. package/dist/adaptive-load-types.js +0 -3
  26. package/dist/adaptive-load-types.js.map +0 -1
  27. package/dist/adaptive-load.d.ts +0 -10
  28. package/dist/adaptive-load.d.ts.map +0 -1
  29. package/dist/adaptive-load.js +0 -98
  30. package/dist/adaptive-load.js.map +0 -1
  31. package/dist/adaptive-types.d.ts +0 -127
  32. package/dist/adaptive-types.d.ts.map +0 -1
  33. package/dist/adaptive-types.js +0 -2
  34. package/dist/adaptive-types.js.map +0 -1
  35. package/dist/artifact-routing-runtime.d.ts +0 -3
  36. package/dist/artifact-routing-runtime.d.ts.map +0 -1
  37. package/dist/artifact-routing-runtime.js +0 -72
  38. package/dist/artifact-routing-runtime.js.map +0 -1
  39. package/dist/auto-review.d.ts +0 -47
  40. package/dist/auto-review.d.ts.map +0 -1
  41. package/dist/auto-review.js +0 -69
  42. package/dist/auto-review.js.map +0 -1
  43. package/dist/blackboard.d.ts +0 -81
  44. package/dist/blackboard.d.ts.map +0 -1
  45. package/dist/blackboard.js +0 -60
  46. package/dist/blackboard.js.map +0 -1
  47. package/dist/coercion.d.ts +0 -12
  48. package/dist/coercion.d.ts.map +0 -1
  49. package/dist/coercion.js +0 -48
  50. package/dist/coercion.js.map +0 -1
  51. package/dist/constants.d.ts +0 -106
  52. package/dist/constants.d.ts.map +0 -1
  53. package/dist/constants.js +0 -106
  54. package/dist/constants.js.map +0 -1
  55. package/dist/context-pack-runtime.d.ts +0 -3
  56. package/dist/context-pack-runtime.d.ts.map +0 -1
  57. package/dist/context-pack-runtime.js +0 -77
  58. package/dist/context-pack-runtime.js.map +0 -1
  59. package/dist/context-types.d.ts +0 -188
  60. package/dist/context-types.d.ts.map +0 -1
  61. package/dist/context-types.js +0 -2
  62. package/dist/context-types.js.map +0 -1
  63. package/dist/coordinator-dashboard-helpers.d.ts +0 -14
  64. package/dist/coordinator-dashboard-helpers.d.ts.map +0 -1
  65. package/dist/coordinator-dashboard-helpers.js +0 -106
  66. package/dist/coordinator-dashboard-helpers.js.map +0 -1
  67. package/dist/coordinator-dashboard-types.d.ts +0 -163
  68. package/dist/coordinator-dashboard-types.d.ts.map +0 -1
  69. package/dist/coordinator-dashboard-types.js +0 -3
  70. package/dist/coordinator-dashboard-types.js.map +0 -1
  71. package/dist/coordinator-dashboard.d.ts +0 -4
  72. package/dist/coordinator-dashboard.d.ts.map +0 -1
  73. package/dist/coordinator-dashboard.js +0 -163
  74. package/dist/coordinator-dashboard.js.map +0 -1
  75. package/dist/coordinator-scoring.d.ts +0 -8
  76. package/dist/coordinator-scoring.d.ts.map +0 -1
  77. package/dist/coordinator-scoring.js +0 -167
  78. package/dist/coordinator-scoring.js.map +0 -1
  79. package/dist/coordinator-types.d.ts +0 -166
  80. package/dist/coordinator-types.d.ts.map +0 -1
  81. package/dist/coordinator-types.js +0 -2
  82. package/dist/coordinator-types.js.map +0 -1
  83. package/dist/debug-runtime.d.ts +0 -4
  84. package/dist/debug-runtime.d.ts.map +0 -1
  85. package/dist/debug-runtime.js +0 -93
  86. package/dist/debug-runtime.js.map +0 -1
  87. package/dist/debug-types.d.ts +0 -194
  88. package/dist/debug-types.d.ts.map +0 -1
  89. package/dist/debug-types.js +0 -2
  90. package/dist/debug-types.js.map +0 -1
  91. package/dist/diagnostic-helpers.d.ts +0 -5
  92. package/dist/diagnostic-helpers.d.ts.map +0 -1
  93. package/dist/diagnostic-helpers.js +0 -54
  94. package/dist/diagnostic-helpers.js.map +0 -1
  95. package/dist/evidence-index-helpers.d.ts +0 -10
  96. package/dist/evidence-index-helpers.d.ts.map +0 -1
  97. package/dist/evidence-index-helpers.js +0 -78
  98. package/dist/evidence-index-helpers.js.map +0 -1
  99. package/dist/evidence-index.d.ts +0 -4
  100. package/dist/evidence-index.d.ts.map +0 -1
  101. package/dist/evidence-index.js +0 -59
  102. package/dist/evidence-index.js.map +0 -1
  103. package/dist/evidence-types.d.ts +0 -151
  104. package/dist/evidence-types.d.ts.map +0 -1
  105. package/dist/evidence-types.js +0 -2
  106. package/dist/evidence-types.js.map +0 -1
  107. package/dist/fixtures.d.ts +0 -45
  108. package/dist/fixtures.d.ts.map +0 -1
  109. package/dist/fixtures.js +0 -39
  110. package/dist/fixtures.js.map +0 -1
  111. package/dist/governance-types.d.ts +0 -172
  112. package/dist/governance-types.d.ts.map +0 -1
  113. package/dist/governance-types.js +0 -2
  114. package/dist/governance-types.js.map +0 -1
  115. package/dist/instrumentation-runtime.d.ts +0 -6
  116. package/dist/instrumentation-runtime.d.ts.map +0 -1
  117. package/dist/instrumentation-runtime.js +0 -111
  118. package/dist/instrumentation-runtime.js.map +0 -1
  119. package/dist/internal.d.ts +0 -11
  120. package/dist/internal.d.ts.map +0 -1
  121. package/dist/internal.js +0 -49
  122. package/dist/internal.js.map +0 -1
  123. package/dist/leases.d.ts +0 -32
  124. package/dist/leases.d.ts.map +0 -1
  125. package/dist/leases.js +0 -36
  126. package/dist/leases.js.map +0 -1
  127. package/dist/manifest-normalization.d.ts +0 -8
  128. package/dist/manifest-normalization.d.ts.map +0 -1
  129. package/dist/manifest-normalization.js +0 -191
  130. package/dist/manifest-normalization.js.map +0 -1
  131. package/dist/manifest-types.d.ts +0 -227
  132. package/dist/manifest-types.d.ts.map +0 -1
  133. package/dist/manifest-types.js +0 -2
  134. package/dist/manifest-types.js.map +0 -1
  135. package/dist/manifest.d.ts +0 -7
  136. package/dist/manifest.d.ts.map +0 -1
  137. package/dist/manifest.js +0 -126
  138. package/dist/manifest.js.map +0 -1
  139. package/dist/merge-admission.d.ts +0 -3
  140. package/dist/merge-admission.d.ts.map +0 -1
  141. package/dist/merge-admission.js +0 -71
  142. package/dist/merge-admission.js.map +0 -1
  143. package/dist/merge-bundles.d.ts +0 -13
  144. package/dist/merge-bundles.d.ts.map +0 -1
  145. package/dist/merge-bundles.js +0 -144
  146. package/dist/merge-bundles.js.map +0 -1
  147. package/dist/merge-classification.d.ts +0 -6
  148. package/dist/merge-classification.d.ts.map +0 -1
  149. package/dist/merge-classification.js +0 -36
  150. package/dist/merge-classification.js.map +0 -1
  151. package/dist/merge-index.d.ts +0 -3
  152. package/dist/merge-index.d.ts.map +0 -1
  153. package/dist/merge-index.js +0 -130
  154. package/dist/merge-index.js.map +0 -1
  155. package/dist/merge-plan-helpers.d.ts +0 -11
  156. package/dist/merge-plan-helpers.d.ts.map +0 -1
  157. package/dist/merge-plan-helpers.js +0 -97
  158. package/dist/merge-plan-helpers.js.map +0 -1
  159. package/dist/merge-plans-runtime.d.ts +0 -8
  160. package/dist/merge-plans-runtime.d.ts.map +0 -1
  161. package/dist/merge-plans-runtime.js +0 -106
  162. package/dist/merge-plans-runtime.js.map +0 -1
  163. package/dist/merge-review-types.d.ts +0 -76
  164. package/dist/merge-review-types.d.ts.map +0 -1
  165. package/dist/merge-review-types.js +0 -2
  166. package/dist/merge-review-types.js.map +0 -1
  167. package/dist/merge-review.d.ts +0 -7
  168. package/dist/merge-review.d.ts.map +0 -1
  169. package/dist/merge-review.js +0 -142
  170. package/dist/merge-review.js.map +0 -1
  171. package/dist/merge-types.d.ts +0 -196
  172. package/dist/merge-types.d.ts.map +0 -1
  173. package/dist/merge-types.js +0 -2
  174. package/dist/merge-types.js.map +0 -1
  175. package/dist/merge-wrappers.d.ts +0 -5
  176. package/dist/merge-wrappers.d.ts.map +0 -1
  177. package/dist/merge-wrappers.js +0 -231
  178. package/dist/merge-wrappers.js.map +0 -1
  179. package/dist/observability-types.d.ts +0 -164
  180. package/dist/observability-types.d.ts.map +0 -1
  181. package/dist/observability-types.js +0 -2
  182. package/dist/observability-types.js.map +0 -1
  183. package/dist/oracle-helpers.d.ts +0 -6
  184. package/dist/oracle-helpers.d.ts.map +0 -1
  185. package/dist/oracle-helpers.js +0 -73
  186. package/dist/oracle-helpers.js.map +0 -1
  187. package/dist/oracle-runtime.d.ts +0 -5
  188. package/dist/oracle-runtime.d.ts.map +0 -1
  189. package/dist/oracle-runtime.js +0 -154
  190. package/dist/oracle-runtime.js.map +0 -1
  191. package/dist/ownership-runtime.d.ts +0 -6
  192. package/dist/ownership-runtime.d.ts.map +0 -1
  193. package/dist/ownership-runtime.js +0 -49
  194. package/dist/ownership-runtime.js.map +0 -1
  195. package/dist/patch-stack-runtime.d.ts +0 -4
  196. package/dist/patch-stack-runtime.d.ts.map +0 -1
  197. package/dist/patch-stack-runtime.js +0 -97
  198. package/dist/patch-stack-runtime.js.map +0 -1
  199. package/dist/plan-helpers.d.ts +0 -13
  200. package/dist/plan-helpers.d.ts.map +0 -1
  201. package/dist/plan-helpers.js +0 -236
  202. package/dist/plan-helpers.js.map +0 -1
  203. package/dist/plan-selection.d.ts +0 -7
  204. package/dist/plan-selection.d.ts.map +0 -1
  205. package/dist/plan-selection.js +0 -86
  206. package/dist/plan-selection.js.map +0 -1
  207. package/dist/plan.d.ts +0 -126
  208. package/dist/plan.d.ts.map +0 -1
  209. package/dist/plan.js +0 -67
  210. package/dist/plan.js.map +0 -1
  211. package/dist/progress.d.ts +0 -42
  212. package/dist/progress.d.ts.map +0 -1
  213. package/dist/progress.js +0 -31
  214. package/dist/progress.js.map +0 -1
  215. package/dist/proof-runtime.d.ts +0 -16
  216. package/dist/proof-runtime.d.ts.map +0 -1
  217. package/dist/proof-runtime.js +0 -143
  218. package/dist/proof-runtime.js.map +0 -1
  219. package/dist/queue-overlays.d.ts +0 -7
  220. package/dist/queue-overlays.d.ts.map +0 -1
  221. package/dist/queue-overlays.js +0 -184
  222. package/dist/queue-overlays.js.map +0 -1
  223. package/dist/queue-types.d.ts +0 -194
  224. package/dist/queue-types.d.ts.map +0 -1
  225. package/dist/queue-types.js +0 -2
  226. package/dist/queue-types.js.map +0 -1
  227. package/dist/rebase-report.d.ts +0 -3
  228. package/dist/rebase-report.d.ts.map +0 -1
  229. package/dist/rebase-report.js +0 -52
  230. package/dist/rebase-report.js.map +0 -1
  231. package/dist/record-helpers.d.ts +0 -15
  232. package/dist/record-helpers.d.ts.map +0 -1
  233. package/dist/record-helpers.js +0 -78
  234. package/dist/record-helpers.js.map +0 -1
  235. package/dist/reference-oracle-runtime.d.ts +0 -4
  236. package/dist/reference-oracle-runtime.d.ts.map +0 -1
  237. package/dist/reference-oracle-runtime.js +0 -89
  238. package/dist/reference-oracle-runtime.js.map +0 -1
  239. package/dist/reference-types.d.ts +0 -204
  240. package/dist/reference-types.d.ts.map +0 -1
  241. package/dist/reference-types.js +0 -2
  242. package/dist/reference-types.js.map +0 -1
  243. package/dist/result-types.d.ts +0 -75
  244. package/dist/result-types.d.ts.map +0 -1
  245. package/dist/result-types.js +0 -2
  246. package/dist/result-types.js.map +0 -1
  247. package/dist/run-normalization.d.ts +0 -9
  248. package/dist/run-normalization.d.ts.map +0 -1
  249. package/dist/run-normalization.js +0 -126
  250. package/dist/run-normalization.js.map +0 -1
  251. package/dist/run-records.d.ts +0 -8
  252. package/dist/run-records.d.ts.map +0 -1
  253. package/dist/run-records.js +0 -145
  254. package/dist/run-records.js.map +0 -1
  255. package/dist/run-store-shards-runtime.d.ts +0 -3
  256. package/dist/run-store-shards-runtime.d.ts.map +0 -1
  257. package/dist/run-store-shards-runtime.js +0 -54
  258. package/dist/run-store-shards-runtime.js.map +0 -1
  259. package/dist/run-types.d.ts +0 -112
  260. package/dist/run-types.d.ts.map +0 -1
  261. package/dist/run-types.js +0 -2
  262. package/dist/run-types.js.map +0 -1
  263. package/dist/scheduler.d.ts +0 -94
  264. package/dist/scheduler.d.ts.map +0 -1
  265. package/dist/scheduler.js +0 -213
  266. package/dist/scheduler.js.map +0 -1
  267. package/dist/semantic-normalization.d.ts +0 -3
  268. package/dist/semantic-normalization.d.ts.map +0 -1
  269. package/dist/semantic-normalization.js +0 -195
  270. package/dist/semantic-normalization.js.map +0 -1
  271. package/dist/semantic-types.d.ts +0 -265
  272. package/dist/semantic-types.d.ts.map +0 -1
  273. package/dist/semantic-types.js +0 -2
  274. package/dist/semantic-types.js.map +0 -1
  275. package/dist/status-types.d.ts +0 -28
  276. package/dist/status-types.d.ts.map +0 -1
  277. package/dist/status-types.js +0 -2
  278. package/dist/status-types.js.map +0 -1
  279. package/dist/task-types.d.ts +0 -165
  280. package/dist/task-types.d.ts.map +0 -1
  281. package/dist/task-types.js +0 -2
  282. package/dist/task-types.js.map +0 -1
  283. package/dist/tournament-adaptive-feedback.d.ts +0 -22
  284. package/dist/tournament-adaptive-feedback.d.ts.map +0 -1
  285. package/dist/tournament-adaptive-feedback.js +0 -241
  286. package/dist/tournament-adaptive-feedback.js.map +0 -1
  287. package/dist/tournament-bandit-types.d.ts +0 -91
  288. package/dist/tournament-bandit-types.d.ts.map +0 -1
  289. package/dist/tournament-bandit-types.js +0 -2
  290. package/dist/tournament-bandit-types.js.map +0 -1
  291. package/dist/tournament-bandit.d.ts +0 -4
  292. package/dist/tournament-bandit.d.ts.map +0 -1
  293. package/dist/tournament-bandit.js +0 -212
  294. package/dist/tournament-bandit.js.map +0 -1
  295. package/dist/tournament-history-types.d.ts +0 -138
  296. package/dist/tournament-history-types.d.ts.map +0 -1
  297. package/dist/tournament-history-types.js +0 -2
  298. package/dist/tournament-history-types.js.map +0 -1
  299. package/dist/tournament-history.d.ts +0 -5
  300. package/dist/tournament-history.d.ts.map +0 -1
  301. package/dist/tournament-history.js +0 -210
  302. package/dist/tournament-history.js.map +0 -1
  303. package/dist/tournament-merge.d.ts +0 -7
  304. package/dist/tournament-merge.d.ts.map +0 -1
  305. package/dist/tournament-merge.js +0 -172
  306. package/dist/tournament-merge.js.map +0 -1
  307. package/dist/tournament-runtime-helpers.d.ts +0 -9
  308. package/dist/tournament-runtime-helpers.d.ts.map +0 -1
  309. package/dist/tournament-runtime-helpers.js +0 -114
  310. package/dist/tournament-runtime-helpers.js.map +0 -1
  311. package/dist/tournament-runtime.d.ts +0 -6
  312. package/dist/tournament-runtime.d.ts.map +0 -1
  313. package/dist/tournament-runtime.js +0 -202
  314. package/dist/tournament-runtime.js.map +0 -1
  315. package/dist/tournament-sample-observations.d.ts +0 -4
  316. package/dist/tournament-sample-observations.d.ts.map +0 -1
  317. package/dist/tournament-sample-observations.js +0 -19
  318. package/dist/tournament-sample-observations.js.map +0 -1
  319. package/dist/tournament-sample-quality-types.d.ts +0 -17
  320. package/dist/tournament-sample-quality-types.d.ts.map +0 -1
  321. package/dist/tournament-sample-quality-types.js +0 -2
  322. package/dist/tournament-sample-quality-types.js.map +0 -1
  323. package/dist/tournament-sample-quality.d.ts +0 -8
  324. package/dist/tournament-sample-quality.d.ts.map +0 -1
  325. package/dist/tournament-sample-quality.js +0 -66
  326. package/dist/tournament-sample-quality.js.map +0 -1
  327. package/dist/tournament-scoring.d.ts +0 -18
  328. package/dist/tournament-scoring.d.ts.map +0 -1
  329. package/dist/tournament-scoring.js +0 -136
  330. package/dist/tournament-scoring.js.map +0 -1
  331. package/dist/tournament-types.d.ts +0 -269
  332. package/dist/tournament-types.d.ts.map +0 -1
  333. package/dist/tournament-types.js +0 -2
  334. package/dist/tournament-types.js.map +0 -1
  335. package/dist/trace-helpers.d.ts +0 -22
  336. package/dist/trace-helpers.d.ts.map +0 -1
  337. package/dist/trace-helpers.js +0 -181
  338. package/dist/trace-helpers.js.map +0 -1
  339. package/dist/trace-runtime.d.ts +0 -7
  340. package/dist/trace-runtime.d.ts.map +0 -1
  341. package/dist/trace-runtime.js +0 -196
  342. package/dist/trace-runtime.js.map +0 -1
  343. package/dist/trace-types.d.ts +0 -168
  344. package/dist/trace-types.d.ts.map +0 -1
  345. package/dist/trace-types.js +0 -2
  346. package/dist/trace-types.js.map +0 -1
  347. package/dist/types.d.ts +0 -23
  348. package/dist/types.d.ts.map +0 -1
  349. package/dist/types.js +0 -2
  350. package/dist/types.js.map +0 -1
  351. package/dist/usage-governor.d.ts +0 -41
  352. package/dist/usage-governor.d.ts.map +0 -1
  353. package/dist/usage-governor.js +0 -43
  354. package/dist/usage-governor.js.map +0 -1
package/dist/index.d.ts CHANGED
@@ -1,42 +1,4802 @@
1
- export * from './constants.js';
2
- export { compileSwarm, createSwarmManifest, defineSwarmManifest, defineSwarmTasks, validateSwarmManifest } from './manifest.js';
3
- export type * from './types.js';
4
- export * from './plan.js';
5
- export * from './scheduler.js';
6
- export * from './leases.js';
7
- export { completeSwarmJob, createSwarmEventStream, createSwarmMailbox, createSwarmRun, recordSwarmEvent, routeSwarmEventToMailboxes } from './run-records.js';
8
- export { matchesGlob } from './internal.js';
9
- export { classifySwarmMergeDisposition, classifySwarmMergeReadiness } from './merge-bundles.js';
10
- export { createSwarmMergeAdmission } from './merge-admission.js';
11
- export { createSwarmMergeIndex } from './merge-index.js';
12
- export { createSwarmReviewerLanePlan } from './merge-review.js';
13
- export { deriveSwarmQueueStatus } from './queue-overlays.js';
14
- export { createSwarmBlackboard, querySwarmBlackboard } from './blackboard.js';
15
- export { createSwarmFixtureCatalog } from './fixtures.js';
16
- export { createSwarmProgressModel } from './progress.js';
17
- export { createSwarmAutoReviewReport } from './auto-review.js';
18
- export { createSwarmUsageGovernor, checkSwarmUsageGovernor } from './usage-governor.js';
19
- export { createSwarmAdaptiveLoadPlan, createSwarmScheduleInputFromAdaptiveLoadPlan } from './adaptive-load.js';
20
- export { createSwarmCoordinatorDashboard, querySwarmCoordinatorDashboard } from './coordinator-dashboard.js';
21
- export { normalizeScoringPolicy, scoreSwarmPayoffVector } from './tournament-scoring.js';
22
- export { createSwarmPayoffVector, createSwarmStrategyCertificate, createSwarmStrategyTournament, querySwarmStrategyTournament } from './tournament-runtime.js';
23
- export { createSwarmContextualBanditRecommendations, normalizeContextualBanditPolicy } from './tournament-bandit.js';
24
- export { createTournamentSampleQuality } from './tournament-sample-quality.js';
25
- export { createSwarmMergePayoffVector, createSwarmMergeTournament } from './tournament-merge.js';
26
- export { compareSwarmStrategyTournaments, createSwarmStrategyTournamentHistory, createSwarmTournamentAdaptiveFeedback } from './tournament-history.js';
27
- export * from './ownership-runtime.js';
28
- export * from './run-store-shards-runtime.js';
29
- export * from './merge-wrappers.js';
30
- export * from './context-pack-runtime.js';
31
- export * from './oracle-runtime.js';
32
- export * from './trace-runtime.js';
33
- export * from './debug-runtime.js';
34
- export * from './instrumentation-runtime.js';
35
- export * from './evidence-index.js';
36
- export * from './reference-oracle-runtime.js';
37
- export * from './artifact-routing-runtime.js';
38
- export * from './rebase-report.js';
39
- export * from './patch-stack-runtime.js';
40
- export * from './proof-runtime.js';
41
- export * from './merge-plans-runtime.js';
1
+ import type { JsonObject, JsonValue } from '@shapeshift-labs/frontier';
2
+ import { type FrontierRunActorId, type FrontierRunDashboardSnapshot, type FrontierRunEvent, type FrontierRunEventId, type FrontierRunProjection } from '@shapeshift-labs/frontier-run';
3
+ export declare const FRONTIER_SWARM_MANIFEST_KIND = "frontier.swarm.manifest";
4
+ export declare const FRONTIER_SWARM_MANIFEST_VERSION = 1;
5
+ export declare const FRONTIER_SWARM_TASK_KIND = "frontier.swarm.task";
6
+ export declare const FRONTIER_SWARM_TASK_VERSION = 1;
7
+ export declare const FRONTIER_SWARM_PLAN_KIND = "frontier.swarm.plan";
8
+ export declare const FRONTIER_SWARM_PLAN_VERSION = 1;
9
+ export declare const FRONTIER_SWARM_RUN_KIND = "frontier.swarm.run";
10
+ export declare const FRONTIER_SWARM_RUN_VERSION = 1;
11
+ export declare const FRONTIER_SWARM_EVENT_KIND = "frontier.swarm.event";
12
+ export declare const FRONTIER_SWARM_EVENT_VERSION = 1;
13
+ export declare const FRONTIER_SWARM_EVENT_STREAM_KIND = "frontier.swarm.event-stream";
14
+ export declare const FRONTIER_SWARM_EVENT_STREAM_VERSION = 1;
15
+ export declare const FRONTIER_SWARM_RUN_GRAPH_KIND = "frontier.swarm.run-graph";
16
+ export declare const FRONTIER_SWARM_RUN_GRAPH_VERSION = 1;
17
+ export declare const FRONTIER_SWARM_GRAPH_SNAPSHOT_KIND = "frontier.swarm.graph-snapshot";
18
+ export declare const FRONTIER_SWARM_GRAPH_SNAPSHOT_VERSION = 1;
19
+ export declare const FRONTIER_SWARM_RUN_GRAPH_CHUNK_KIND = "frontier.swarm.run-graph-chunk";
20
+ export declare const FRONTIER_SWARM_RUN_GRAPH_CHUNK_VERSION = 1;
21
+ export declare const FRONTIER_SWARM_GATE_RECORD_KIND = "frontier.swarm.gate-record";
22
+ export declare const FRONTIER_SWARM_GATE_RECORD_VERSION = 1;
23
+ export declare const FRONTIER_SWARM_EVIDENCE_RECORD_KIND = "frontier.swarm.evidence-record";
24
+ export declare const FRONTIER_SWARM_EVIDENCE_RECORD_VERSION = 1;
25
+ export declare const FRONTIER_SWARM_PATCH_EVENT_KIND = "frontier.swarm.patch-event";
26
+ export declare const FRONTIER_SWARM_PATCH_EVENT_VERSION = 1;
27
+ export declare const FRONTIER_SWARM_REPLAY_RECORD_KIND = "frontier.swarm.replay-record";
28
+ export declare const FRONTIER_SWARM_REPLAY_RECORD_VERSION = 1;
29
+ export declare const FRONTIER_SWARM_IMPROVEMENT_LOOP_KIND = "frontier.swarm.improvement-loop";
30
+ export declare const FRONTIER_SWARM_IMPROVEMENT_LOOP_VERSION = 1;
31
+ export declare const FRONTIER_SWARM_MAILBOX_KIND = "frontier.swarm.mailbox";
32
+ export declare const FRONTIER_SWARM_MAILBOX_VERSION = 1;
33
+ export declare const FRONTIER_SWARM_PROOF_KIND = "frontier.swarm.proof";
34
+ export declare const FRONTIER_SWARM_PROOF_VERSION = 1;
35
+ export declare const FRONTIER_SWARM_SCHEDULE_KIND = "frontier.swarm.schedule";
36
+ export declare const FRONTIER_SWARM_SCHEDULE_VERSION = 1;
37
+ export declare const FRONTIER_SWARM_LEASE_KIND = "frontier.swarm.lease";
38
+ export declare const FRONTIER_SWARM_LEASE_VERSION = 1;
39
+ export declare const FRONTIER_SWARM_QUEUE_SNAPSHOT_KIND = "frontier.swarm.queue-snapshot";
40
+ export declare const FRONTIER_SWARM_QUEUE_SNAPSHOT_VERSION = 1;
41
+ export declare const FRONTIER_SWARM_RUN_CHECKPOINT_KIND = "frontier.swarm.run-checkpoint";
42
+ export declare const FRONTIER_SWARM_RUN_CHECKPOINT_VERSION = 1;
43
+ export declare const FRONTIER_SWARM_ARTIFACT_INDEX_KIND = "frontier.swarm.artifact-index";
44
+ export declare const FRONTIER_SWARM_ARTIFACT_INDEX_VERSION = 1;
45
+ export declare const FRONTIER_SWARM_REVIEW_PLAN_KIND = "frontier.swarm.review-plan";
46
+ export declare const FRONTIER_SWARM_REVIEW_PLAN_VERSION = 1;
47
+ export declare const FRONTIER_SWARM_MERGE_PLAN_KIND = "frontier.swarm.merge-plan";
48
+ export declare const FRONTIER_SWARM_MERGE_PLAN_VERSION = 1;
49
+ export declare const FRONTIER_SWARM_MERGE_BUNDLE_KIND = "frontier.swarm.merge-bundle";
50
+ export declare const FRONTIER_SWARM_MERGE_BUNDLE_VERSION = 1;
51
+ export declare const FRONTIER_SWARM_SEMANTIC_CHANGE_KIND = "frontier.swarm.semantic-change";
52
+ export declare const FRONTIER_SWARM_SEMANTIC_CHANGE_VERSION = 1;
53
+ export declare const FRONTIER_SWARM_MERGE_CANDIDATE_KIND = "frontier.swarm.merge-candidate";
54
+ export declare const FRONTIER_SWARM_MERGE_CANDIDATE_VERSION = 1;
55
+ export declare const FRONTIER_SWARM_QUEUE_OVERLAY_KIND = "frontier.swarm.queue-overlay";
56
+ export declare const FRONTIER_SWARM_QUEUE_OVERLAY_VERSION = 1;
57
+ export declare const FRONTIER_SWARM_MERGE_INDEX_KIND = "frontier.swarm.merge-index";
58
+ export declare const FRONTIER_SWARM_MERGE_INDEX_VERSION = 1;
59
+ export declare const FRONTIER_SWARM_HOTSPOT_REPORT_KIND = "frontier.swarm.hotspot-report";
60
+ export declare const FRONTIER_SWARM_HOTSPOT_REPORT_VERSION = 1;
61
+ export declare const FRONTIER_SWARM_REVIEWER_LANE_PLAN_KIND = "frontier.swarm.reviewer-lane-plan";
62
+ export declare const FRONTIER_SWARM_REVIEWER_LANE_PLAN_VERSION = 1;
63
+ export declare const FRONTIER_SWARM_RUN_STORE_SHARDS_KIND = "frontier.swarm.run-store-shards";
64
+ export declare const FRONTIER_SWARM_RUN_STORE_SHARDS_VERSION = 1;
65
+ export declare const FRONTIER_SWARM_MERGE_ADMISSION_KIND = "frontier.swarm.merge-admission";
66
+ export declare const FRONTIER_SWARM_MERGE_ADMISSION_VERSION = 1;
67
+ export declare const FRONTIER_SWARM_CONTEXT_PACK_KIND = "frontier.swarm.context-pack";
68
+ export declare const FRONTIER_SWARM_CONTEXT_PACK_VERSION = 1;
69
+ export declare const FRONTIER_SWARM_ORACLE_CORPUS_KIND = "frontier.swarm.oracle-corpus";
70
+ export declare const FRONTIER_SWARM_ORACLE_CORPUS_VERSION = 1;
71
+ export declare const FRONTIER_SWARM_REPLAY_BUNDLE_KIND = "frontier.swarm.replay-bundle";
72
+ export declare const FRONTIER_SWARM_REPLAY_BUNDLE_VERSION = 1;
73
+ export declare const FRONTIER_SWARM_PARITY_ORACLE_KIND = "frontier.swarm.parity-oracle";
74
+ export declare const FRONTIER_SWARM_PARITY_ORACLE_VERSION = 1;
75
+ export declare const FRONTIER_SWARM_DIVERGENCE_REPORT_KIND = "frontier.swarm.divergence-report";
76
+ export declare const FRONTIER_SWARM_DIVERGENCE_REPORT_VERSION = 1;
77
+ export declare const FRONTIER_SWARM_OBSERVABILITY_POINT_KIND = "frontier.swarm.observability-point";
78
+ export declare const FRONTIER_SWARM_OBSERVABILITY_POINT_VERSION = 1;
79
+ export declare const FRONTIER_SWARM_WATCHPOINT_PLAN_KIND = "frontier.swarm.watchpoint-plan";
80
+ export declare const FRONTIER_SWARM_WATCHPOINT_PLAN_VERSION = 1;
81
+ export declare const FRONTIER_SWARM_DEBUG_HANDOFF_KIND = "frontier.swarm.debug-handoff";
82
+ export declare const FRONTIER_SWARM_DEBUG_HANDOFF_VERSION = 1;
83
+ export declare const FRONTIER_SWARM_INSTRUMENTATION_BUDGET_KIND = "frontier.swarm.instrumentation-budget";
84
+ export declare const FRONTIER_SWARM_INSTRUMENTATION_BUDGET_VERSION = 1;
85
+ export declare const FRONTIER_SWARM_BOTTLENECK_REPORT_KIND = "frontier.swarm.bottleneck-report";
86
+ export declare const FRONTIER_SWARM_BOTTLENECK_REPORT_VERSION = 1;
87
+ export declare const FRONTIER_SWARM_EVIDENCE_INDEX_KIND = "frontier.swarm.evidence-index";
88
+ export declare const FRONTIER_SWARM_EVIDENCE_INDEX_VERSION = 1;
89
+ export declare const FRONTIER_SWARM_BLACKBOARD_KIND = "frontier.swarm.blackboard";
90
+ export declare const FRONTIER_SWARM_BLACKBOARD_VERSION = 1;
91
+ export declare const FRONTIER_SWARM_REFERENCE_ORACLE_PLAN_KIND = "frontier.swarm.reference-oracle-plan";
92
+ export declare const FRONTIER_SWARM_REFERENCE_ORACLE_PLAN_VERSION = 1;
93
+ export declare const FRONTIER_SWARM_REFERENCE_ORACLE_RESPONSE_KIND = "frontier.swarm.reference-oracle-response";
94
+ export declare const FRONTIER_SWARM_REFERENCE_ORACLE_RESPONSE_VERSION = 1;
95
+ export declare const FRONTIER_SWARM_ARTIFACT_ROUTING_PLAN_KIND = "frontier.swarm.artifact-routing-plan";
96
+ export declare const FRONTIER_SWARM_ARTIFACT_ROUTING_PLAN_VERSION = 1;
97
+ export declare const FRONTIER_SWARM_SCHEDULER_RECOMMENDATIONS_KIND = "frontier.swarm.scheduler-recommendations";
98
+ export declare const FRONTIER_SWARM_SCHEDULER_RECOMMENDATIONS_VERSION = 1;
99
+ export declare const FRONTIER_SWARM_FIXTURE_CATALOG_KIND = "frontier.swarm.fixture-catalog";
100
+ export declare const FRONTIER_SWARM_FIXTURE_CATALOG_VERSION = 1;
101
+ export declare const FRONTIER_SWARM_PROGRESS_MODEL_KIND = "frontier.swarm.progress-model";
102
+ export declare const FRONTIER_SWARM_PROGRESS_MODEL_VERSION = 1;
103
+ export declare const FRONTIER_SWARM_AUTO_REVIEW_REPORT_KIND = "frontier.swarm.auto-review-report";
104
+ export declare const FRONTIER_SWARM_AUTO_REVIEW_REPORT_VERSION = 1;
105
+ export declare const FRONTIER_SWARM_REBASE_REPORT_KIND = "frontier.swarm.rebase-report";
106
+ export declare const FRONTIER_SWARM_REBASE_REPORT_VERSION = 1;
107
+ export declare const FRONTIER_SWARM_USAGE_GOVERNOR_KIND = "frontier.swarm.usage-governor";
108
+ export declare const FRONTIER_SWARM_USAGE_GOVERNOR_VERSION = 1;
109
+ export declare const FRONTIER_SWARM_LANE_PLAYBOOK_KIND = "frontier.swarm.lane-playbook";
110
+ export declare const FRONTIER_SWARM_LANE_PLAYBOOK_VERSION = 1;
111
+ export declare const FRONTIER_SWARM_PATCH_STACK_PLAN_KIND = "frontier.swarm.patch-stack-plan";
112
+ export declare const FRONTIER_SWARM_PATCH_STACK_PLAN_VERSION = 1;
113
+ export declare const FRONTIER_SWARM_HIERARCHICAL_MERGE_QUEUE_KIND = "frontier.swarm.hierarchical-merge-queue";
114
+ export declare const FRONTIER_SWARM_HIERARCHICAL_MERGE_QUEUE_VERSION = 1;
115
+ export declare const FRONTIER_SWARM_COORDINATOR_AGENT_DRAIN_WORK_KIND = "frontier.swarm.coordinator-agent-drain-work";
116
+ export declare const FRONTIER_SWARM_COORDINATOR_AGENT_DRAIN_WORK_VERSION = 1;
117
+ export declare const FRONTIER_SWARM_QUEUE_OUTCOME_MODEL_KIND = "frontier.swarm.queue-outcome-model";
118
+ export declare const FRONTIER_SWARM_QUEUE_OUTCOME_MODEL_VERSION = 1;
119
+ export declare const FRONTIER_SWARM_TERMINAL_STATE_RECONCILIATION_KIND = "frontier.swarm.terminal-state-reconciliation";
120
+ export declare const FRONTIER_SWARM_TERMINAL_STATE_RECONCILIATION_VERSION = 1;
121
+ export declare const FRONTIER_SWARM_TERMINAL_OUTCOME_RECORD_KIND = "frontier.swarm.terminal-outcome-record";
122
+ export declare const FRONTIER_SWARM_TERMINAL_OUTCOME_RECORD_VERSION = 1;
123
+ export declare const FRONTIER_SWARM_PRIORITY_POLICY_KIND = "frontier.swarm.priority-policy";
124
+ export declare const FRONTIER_SWARM_PRIORITY_POLICY_VERSION = 1;
125
+ export declare const FRONTIER_SWARM_MODEL_ROUTE_KIND = "frontier.swarm.model-route";
126
+ export declare const FRONTIER_SWARM_MODEL_ROUTE_VERSION = 1;
127
+ export declare const FRONTIER_SWARM_PANEL_EVALUATION_KIND = "frontier.swarm.panel-evaluation";
128
+ export declare const FRONTIER_SWARM_PANEL_EVALUATION_VERSION = 1;
129
+ export declare const FRONTIER_SWARM_OPTIMIZATION_SUMMARY_KIND = "frontier.swarm.optimization-summary";
130
+ export declare const FRONTIER_SWARM_OPTIMIZATION_SUMMARY_VERSION = 1;
131
+ export declare const FRONTIER_SWARM_CONTINUOUS_POOL_STATE_KIND = "frontier.swarm.continuous-pool-state";
132
+ export declare const FRONTIER_SWARM_CONTINUOUS_POOL_STATE_VERSION = 1;
133
+ export declare const FRONTIER_SWARM_DEFAULT_CODEX_COMPUTE_ID = "codex.gpt-5.5.xhigh";
134
+ export declare const FRONTIER_SWARM_DEFAULT_MODEL = "gpt-5.5";
135
+ export declare const FRONTIER_SWARM_DEFAULT_REASONING_EFFORT = "xhigh";
136
+ export declare const FRONTIER_SWARM_VERIFICATION_CATEGORY_HINTS: readonly ["build", "typecheck", "smoke", "unit", "fuzz", "browser", "oracle"];
137
+ export declare const FRONTIER_SWARM_GRAPH_NODE_KINDS: readonly ["intent", "task", "worker", "candidate", "evidence", "gate", "decision", "merge", "replay", "rsi"];
138
+ export declare const FRONTIER_SWARM_GRAPH_EDGE_KINDS: readonly ["dependsOn", "blocks", "produces", "verifies", "conflictsWith", "supersedes", "mergesInto"];
139
+ export declare const FRONTIER_SWARM_MERGE_CANDIDATE_ADMISSION_STATUSES: readonly ["safe", "safe-with-losses", "review-required", "blocked"];
140
+ export declare const FRONTIER_SWARM_MERGE_CANDIDATE_REASON_CODES: readonly ["missing-sidecar", "empty-sidecar", "stale-source-hash", "symbol-conflict", "effect-conflict", "lossy-import", "tests-missing"];
141
+ export type FrontierSwarmComputeKind = 'codex' | 'shell' | 'human' | 'external' | string;
142
+ export type FrontierSwarmReasoningEffort = 'minimal' | 'low' | 'medium' | 'high' | 'xhigh' | string;
143
+ export type FrontierSwarmPolicyMode = 'advisory' | 'hard-file-ownership' | string;
144
+ export type FrontierSwarmTaskStatus = 'open' | 'planned' | 'running' | 'blocked' | 'failed' | 'completed' | 'verified' | string;
145
+ export type FrontierSwarmJobStatus = 'planned' | 'scheduled' | 'running' | 'blocked' | 'failed' | 'completed' | 'verified' | string;
146
+ export type FrontierSwarmMergeReadiness = 'discovery-only' | 'patch-candidate' | 'verified-patch' | 'rejected' | 'blocked' | string;
147
+ export type FrontierSwarmMergeDisposition = 'auto-mergeable' | 'needs-port' | 'discovery-only' | 'rejected' | 'blocked' | 'stale-against-head' | string;
148
+ export type FrontierSwarmRiskLevel = 'low' | 'medium' | 'high' | 'unknown' | string;
149
+ export type FrontierSwarmPatchStatus = 'unknown' | 'applies' | 'missing' | 'stale' | 'failed-check' | string;
150
+ export type FrontierSwarmQueueOverlayStatus = 'satisfied' | 'ready-to-apply' | 'needs-human-port' | 'failed-evidence' | 'stale-against-head' | 'discovery-only' | 'blocked' | 'rejected' | 'unknown' | string;
151
+ export type FrontierSwarmParityOracleStatus = 'pending' | 'passed' | 'failed' | 'blocked' | 'skipped' | string;
152
+ export type FrontierSwarmDivergenceSeverity = 'info' | 'warning' | 'error' | 'critical' | string;
153
+ export type FrontierSwarmWatchpointAction = 'break' | 'log' | 'capture' | 'handoff' | string;
154
+ export type FrontierSwarmBottleneckKind = 'correctness' | 'performance' | 'instrumentation-overhead' | 'missing-oracle' | 'flaky-harness' | 'blocked-dependency' | 'merge-review' | 'resource-capacity' | 'budget' | 'queue' | string;
155
+ export type FrontierSwarmConfidence = 'low' | 'medium' | 'high' | string;
156
+ export type FrontierSwarmBlackboardEntryKind = 'fact' | 'divergence' | 'rejected-theory' | 'ownership' | 'decision' | string;
157
+ export type FrontierSwarmProgressStatus = 'not-started' | 'declared' | 'implemented' | 'structure-verified' | 'visual-verified' | 'functional-verified' | 'collaboration-verified' | 'accepted' | 'rejected' | 'blocked' | string;
158
+ export type FrontierSwarmAutoReviewFindingKind = 'stub-risk' | 'missing-evidence' | 'ownership-violation' | 'overlarge-patch' | 'weak-evidence' | 'strict-source-policy' | string;
159
+ export type FrontierSwarmRebaseStatus = 'clean-apply' | 'textual-conflict' | 'semantic-overlap' | 'stale-evidence' | 'needs-rerun' | string;
160
+ export type FrontierSwarmModelRouteStrategy = 'single-cheap' | 'single-deep' | 'panel' | 'tournament' | string;
161
+ export type FrontierSwarmPanelStrategy = 'panel' | 'tournament' | 'auto' | string;
162
+ export type FrontierSwarmTimePressure = 'relaxed' | 'normal' | 'soon' | 'urgent' | string;
163
+ export type FrontierSwarmTaskModelTier = 'cheap' | 'balanced' | 'deep' | 'panel' | string;
164
+ export type FrontierSwarmTaskModelCostBand = 'low' | 'medium' | 'high' | string;
165
+ export type FrontierSwarmContinuousPoolPhase = 'active' | 'queued' | 'review-drain' | 'rerun' | 'human-blocked' | 'conflicted' | 'capacity-blocked' | 'done' | string;
166
+ export type FrontierSwarmContinuousPoolBucket = 'active' | 'queued' | 'review-drain' | 'rerun' | 'human-blocked' | 'conflicted' | 'capacity-blocked' | 'done' | string;
167
+ export type FrontierSwarmContinuousPoolStopCondition = 'drained' | 'human-blocked' | 'conflicted' | 'capacity-blocked' | string;
168
+ export type FrontierSwarmContinuousPoolRefillAction = 'drain-review' | 'rerun-stale' | 'lease-queued' | 'start-speculative-backlog' | string;
169
+ export type FrontierSwarmVerificationCategory = (typeof FRONTIER_SWARM_VERIFICATION_CATEGORY_HINTS)[number] | string;
170
+ export interface FrontierSwarmComputeInput {
171
+ id: string;
172
+ kind?: FrontierSwarmComputeKind;
173
+ title?: string;
174
+ model?: string;
175
+ reasoningEffort?: FrontierSwarmReasoningEffort;
176
+ serviceTier?: string;
177
+ profile?: string;
178
+ sandbox?: string;
179
+ approval?: string;
180
+ maxConcurrency?: number;
181
+ timeoutMs?: number;
182
+ metadata?: unknown;
183
+ }
184
+ export interface FrontierSwarmCompute {
185
+ id: string;
186
+ kind: FrontierSwarmComputeKind;
187
+ title?: string;
188
+ model?: string;
189
+ reasoningEffort?: FrontierSwarmReasoningEffort;
190
+ serviceTier?: string;
191
+ profile?: string;
192
+ sandbox?: string;
193
+ approval?: string;
194
+ maxConcurrency?: number;
195
+ timeoutMs?: number;
196
+ metadata?: JsonObject;
197
+ }
198
+ export interface FrontierSwarmLayerInput {
199
+ id: string;
200
+ title?: string;
201
+ description?: string;
202
+ parentId?: string;
203
+ compute?: string;
204
+ defaultCompute?: string;
205
+ childCompute?: Record<string, string>;
206
+ tags?: readonly string[];
207
+ metadata?: unknown;
208
+ }
209
+ export interface FrontierSwarmLayer {
210
+ id: string;
211
+ title: string;
212
+ description?: string;
213
+ parentId?: string;
214
+ compute?: string;
215
+ defaultCompute?: string;
216
+ childCompute: Record<string, string>;
217
+ tags: string[];
218
+ metadata?: JsonObject;
219
+ }
220
+ export interface FrontierSwarmOwnershipRegionInput {
221
+ id: string;
222
+ title?: string;
223
+ description?: string;
224
+ globs?: readonly string[];
225
+ paths?: readonly string[];
226
+ selectors?: readonly string[];
227
+ owner?: string;
228
+ metadata?: unknown;
229
+ }
230
+ export interface FrontierSwarmOwnershipRegion {
231
+ id: string;
232
+ title: string;
233
+ description?: string;
234
+ globs: string[];
235
+ selectors: string[];
236
+ owner?: string;
237
+ metadata?: JsonObject;
238
+ }
239
+ export type FrontierSwarmSemanticOwnershipRegionKind = 'named-export' | 'default-export' | 're-export' | 'namespace-export' | 'exported-declaration' | 'type' | 'cli-command' | 'docs-section' | 'fixture-family' | 'test-case' | string;
240
+ export interface FrontierSwarmSemanticOwnershipStableKeyInput {
241
+ kind: FrontierSwarmSemanticOwnershipRegionKind;
242
+ name?: string;
243
+ declarationKind?: string;
244
+ source?: string;
245
+ exportName?: string;
246
+ command?: string;
247
+ section?: string;
248
+ family?: string;
249
+ testCase?: string;
250
+ }
251
+ export interface FrontierSwarmSemanticOwnershipRegionIdInput {
252
+ file: string;
253
+ kind: FrontierSwarmSemanticOwnershipStableKeyInput['kind'];
254
+ name?: string;
255
+ declarationKind?: string;
256
+ source?: string;
257
+ exportName?: string;
258
+ command?: string;
259
+ section?: string;
260
+ family?: string;
261
+ testCase?: string;
262
+ }
263
+ export declare const FRONTIER_SWARM_SEMANTIC_OWNERSHIP_EXPORT_STABLE_KEY_KIND = "exported-declaration";
264
+ export declare const FRONTIER_SWARM_SEMANTIC_OWNERSHIP_NAMESPACE_EXPORT_STABLE_KEY_KIND = "namespace-export";
265
+ export declare const FRONTIER_SWARM_SEMANTIC_OWNERSHIP_TYPE_STABLE_KEY_KIND = "type-declaration";
266
+ export declare const FRONTIER_SWARM_SEMANTIC_OWNERSHIP_CLI_COMMAND_STABLE_KEY_KIND = "cli-command";
267
+ export declare const FRONTIER_SWARM_SEMANTIC_OWNERSHIP_DOCS_SECTION_STABLE_KEY_KIND = "docs-section";
268
+ export declare const FRONTIER_SWARM_SEMANTIC_OWNERSHIP_FIXTURE_FAMILY_STABLE_KEY_KIND = "fixture-family";
269
+ export declare const FRONTIER_SWARM_SEMANTIC_OWNERSHIP_TEST_CASE_STABLE_KEY_KIND = "test-case";
270
+ export interface FrontierSwarmLaneInput {
271
+ id: string;
272
+ title?: string;
273
+ description?: string;
274
+ layer?: string;
275
+ compute?: string;
276
+ allowedWrites?: readonly string[];
277
+ allowedGlobs?: readonly string[];
278
+ sharedReadOnly?: readonly string[];
279
+ neverEdit?: readonly string[];
280
+ ownershipRegions?: readonly FrontierSwarmOwnershipRegionInput[];
281
+ capabilities?: readonly string[];
282
+ resourceRequirements?: FrontierSwarmResourceRequirementsInput;
283
+ worktreePath?: string;
284
+ evidencePrefix?: string;
285
+ evidenceOutDirPrefix?: string;
286
+ concurrencyKey?: string;
287
+ maxConcurrency?: number;
288
+ handoffCommands?: readonly (string | FrontierSwarmCommandInput)[];
289
+ tags?: readonly string[];
290
+ metadata?: unknown;
291
+ }
292
+ export interface FrontierSwarmLane {
293
+ id: string;
294
+ title: string;
295
+ description?: string;
296
+ layer?: string;
297
+ compute?: string;
298
+ allowedWrites: string[];
299
+ sharedReadOnly: string[];
300
+ neverEdit: string[];
301
+ ownershipRegions: FrontierSwarmOwnershipRegion[];
302
+ capabilities: string[];
303
+ resourceRequirements?: FrontierSwarmResourceRequirements;
304
+ worktreePath?: string;
305
+ evidencePrefix?: string;
306
+ concurrencyKey: string;
307
+ maxConcurrency?: number;
308
+ handoffCommands: FrontierSwarmCommand[];
309
+ tags: string[];
310
+ metadata?: JsonObject;
311
+ }
312
+ export interface FrontierSwarmCommandInput {
313
+ name?: string;
314
+ command: string;
315
+ args?: readonly string[];
316
+ required?: boolean;
317
+ cwd?: string;
318
+ metadata?: unknown;
319
+ }
320
+ export interface FrontierSwarmCommand {
321
+ name: string;
322
+ command: string;
323
+ args: string[];
324
+ required: boolean;
325
+ cwd?: string;
326
+ metadata?: JsonObject;
327
+ }
328
+ export interface FrontierSwarmBrowserResourceInput {
329
+ required?: boolean;
330
+ portPool?: readonly (string | number)[];
331
+ profileDir?: string;
332
+ profileDirPrefix?: string;
333
+ maxConcurrency?: number;
334
+ headless?: boolean;
335
+ metadata?: unknown;
336
+ }
337
+ export interface FrontierSwarmBrowserResource {
338
+ required: boolean;
339
+ portPool: string[];
340
+ profileDir?: string;
341
+ profileDirPrefix?: string;
342
+ maxConcurrency?: number;
343
+ headless?: boolean;
344
+ metadata?: JsonObject;
345
+ }
346
+ export interface FrontierSwarmResourceRequirementsInput {
347
+ capabilities?: readonly string[];
348
+ resources?: Record<string, number>;
349
+ browser?: FrontierSwarmBrowserResourceInput;
350
+ metadata?: unknown;
351
+ }
352
+ export interface FrontierSwarmResourceRequirements {
353
+ capabilities: string[];
354
+ resources: Record<string, number>;
355
+ browser?: FrontierSwarmBrowserResource;
356
+ metadata?: JsonObject;
357
+ }
358
+ export interface FrontierSwarmPolicyInput {
359
+ mode?: FrontierSwarmPolicyMode;
360
+ defaultConcurrency?: number;
361
+ defaultCompute?: string;
362
+ defaultLayer?: string;
363
+ completedStatuses?: readonly string[];
364
+ sharedReadOnly?: readonly string[];
365
+ neverEditWithoutParent?: readonly string[];
366
+ requireCleanWorktree?: boolean;
367
+ metadata?: unknown;
368
+ }
369
+ export interface FrontierSwarmPolicy {
370
+ mode: FrontierSwarmPolicyMode;
371
+ defaultConcurrency: number;
372
+ defaultCompute: string;
373
+ defaultLayer?: string;
374
+ completedStatuses: string[];
375
+ sharedReadOnly: string[];
376
+ neverEditWithoutParent: string[];
377
+ requireCleanWorktree: boolean;
378
+ metadata?: JsonObject;
379
+ }
380
+ export interface FrontierSwarmManifestInput {
381
+ id?: string;
382
+ title?: string;
383
+ description?: string;
384
+ package?: string;
385
+ feature?: string;
386
+ owner?: string;
387
+ compute?: readonly FrontierSwarmComputeInput[];
388
+ layers?: readonly FrontierSwarmLayerInput[];
389
+ lanes?: readonly FrontierSwarmLaneInput[];
390
+ policy?: FrontierSwarmPolicyInput;
391
+ resources?: readonly string[];
392
+ tags?: readonly string[];
393
+ metadata?: unknown;
394
+ }
395
+ export interface FrontierSwarmManifest {
396
+ kind: typeof FRONTIER_SWARM_MANIFEST_KIND;
397
+ version: typeof FRONTIER_SWARM_MANIFEST_VERSION;
398
+ id: string;
399
+ title: string;
400
+ description?: string;
401
+ package?: string;
402
+ feature?: string;
403
+ owner?: string;
404
+ compute: FrontierSwarmCompute[];
405
+ layers: FrontierSwarmLayer[];
406
+ lanes: FrontierSwarmLane[];
407
+ policy: FrontierSwarmPolicy;
408
+ resources: string[];
409
+ tags: string[];
410
+ metadata?: JsonObject;
411
+ summary: FrontierSwarmSummary;
412
+ }
413
+ export interface FrontierSwarmSummary {
414
+ computeCount: number;
415
+ layerCount: number;
416
+ laneCount: number;
417
+ taskCount?: number;
418
+ jobCount?: number;
419
+ completedCount?: number;
420
+ blockedCount?: number;
421
+ failedCount?: number;
422
+ ownershipViolationCount?: number;
423
+ }
424
+ export interface FrontierSwarmTaskInput {
425
+ id: string;
426
+ title?: string;
427
+ objective?: string;
428
+ description?: string;
429
+ kind?: string;
430
+ status?: FrontierSwarmTaskStatus;
431
+ lane?: string;
432
+ layer?: string;
433
+ compute?: string;
434
+ parentTaskId?: string;
435
+ dependsOn?: readonly string[];
436
+ concurrencyKey?: string;
437
+ budget?: FrontierSwarmBudgetInput;
438
+ review?: FrontierSwarmReviewPolicyInput;
439
+ priority?: number;
440
+ sourceRefs?: readonly string[];
441
+ targetRefs?: readonly string[];
442
+ ownedFiles?: readonly string[];
443
+ allowedWrites?: readonly string[];
444
+ ownershipRegions?: readonly FrontierSwarmOwnershipRegionInput[];
445
+ ownedRegions?: readonly string[];
446
+ changedRegions?: readonly string[];
447
+ capabilities?: readonly string[];
448
+ resourceRequirements?: FrontierSwarmResourceRequirementsInput;
449
+ acceptance?: readonly string[];
450
+ acceptanceChecks?: readonly ({
451
+ id?: string;
452
+ description?: string;
453
+ } | string)[];
454
+ verification?: readonly (string | FrontierSwarmCommandInput)[];
455
+ evidenceCommand?: string;
456
+ shardCommand?: string;
457
+ tags?: readonly string[];
458
+ metadata?: unknown;
459
+ }
460
+ export interface FrontierSwarmTask {
461
+ kind: typeof FRONTIER_SWARM_TASK_KIND;
462
+ version: typeof FRONTIER_SWARM_TASK_VERSION;
463
+ id: string;
464
+ title: string;
465
+ objective: string;
466
+ description?: string;
467
+ workKind: string;
468
+ status: FrontierSwarmTaskStatus;
469
+ lane?: string;
470
+ layer?: string;
471
+ compute?: string;
472
+ parentTaskId?: string;
473
+ dependsOn: string[];
474
+ concurrencyKey?: string;
475
+ budget?: FrontierSwarmBudget;
476
+ review?: FrontierSwarmReviewPolicy;
477
+ priority: number;
478
+ sourceRefs: string[];
479
+ targetRefs: string[];
480
+ allowedWrites: string[];
481
+ ownershipRegions: FrontierSwarmOwnershipRegion[];
482
+ ownedRegions: string[];
483
+ changedRegions: string[];
484
+ capabilities: string[];
485
+ resourceRequirements?: FrontierSwarmResourceRequirements;
486
+ acceptance: string[];
487
+ verification: FrontierSwarmCommand[];
488
+ evidenceCommand?: string;
489
+ shardCommand?: string;
490
+ tags: string[];
491
+ metadata?: JsonObject;
492
+ }
493
+ export interface FrontierSwarmTaskSetInput {
494
+ tasks?: readonly FrontierSwarmTaskInput[];
495
+ items?: readonly FrontierSwarmTaskInput[];
496
+ }
497
+ export interface FrontierSwarmCompiled {
498
+ manifest: FrontierSwarmManifest;
499
+ validation: FrontierSwarmValidation;
500
+ computeById: ReadonlyMap<string, FrontierSwarmCompute>;
501
+ layersById: ReadonlyMap<string, FrontierSwarmLayer>;
502
+ lanesById: ReadonlyMap<string, FrontierSwarmLane>;
503
+ }
504
+ export interface FrontierSwarmValidation {
505
+ valid: boolean;
506
+ issues: FrontierSwarmValidationIssue[];
507
+ }
508
+ export interface FrontierSwarmValidationIssue {
509
+ code: string;
510
+ severity: 'error' | 'warning';
511
+ path: string;
512
+ message: string;
513
+ }
514
+ export interface FrontierSwarmPlanFilter {
515
+ lanes?: readonly string[];
516
+ layers?: readonly string[];
517
+ statuses?: readonly string[];
518
+ selectors?: readonly string[];
519
+ includeCompleted?: boolean;
520
+ limit?: number;
521
+ compute?: string;
522
+ spreadLanes?: boolean;
523
+ }
524
+ export type FrontierSwarmPriorityClass = 'coordinator-drain' | 'review' | 'standard' | 'speculative' | string;
525
+ export interface FrontierSwarmPriorityPolicyClass {
526
+ className: FrontierSwarmPriorityClass;
527
+ rank: number;
528
+ description: string;
529
+ matchers: string[];
530
+ }
531
+ export interface FrontierSwarmPriorityPolicy {
532
+ kind: typeof FRONTIER_SWARM_PRIORITY_POLICY_KIND;
533
+ version: typeof FRONTIER_SWARM_PRIORITY_POLICY_VERSION;
534
+ id: string;
535
+ description: string;
536
+ classes: FrontierSwarmPriorityPolicyClass[];
537
+ laneFairness: {
538
+ strategy: 'round-robin-within-priority-class';
539
+ scope: 'ready-window' | string;
540
+ tieBreakers: string[];
541
+ };
542
+ concurrency: {
543
+ preservesLaneLimits: boolean;
544
+ preservesConcurrencyKeyLimits: boolean;
545
+ preservesComputeLimits: boolean;
546
+ preservesResourceQuotas: boolean;
547
+ };
548
+ }
549
+ export interface FrontierSwarmPriorityDecision {
550
+ policyId: string;
551
+ className: FrontierSwarmPriorityClass;
552
+ rank: number;
553
+ basePriority: number;
554
+ effectivePriority: number;
555
+ reasons: string[];
556
+ }
557
+ export declare const FRONTIER_SWARM_REVIEW_PRIORITY_POLICY: FrontierSwarmPriorityPolicy;
558
+ export interface FrontierSwarmSelectionPriorityInput {
559
+ statuses?: Record<string, number>;
560
+ workKinds?: Record<string, number>;
561
+ defaultStatusRank?: number;
562
+ defaultWorkKindRank?: number;
563
+ statusWeight?: number;
564
+ workKindWeight?: number;
565
+ }
566
+ export interface FrontierSwarmTaskSelectionInput extends FrontierSwarmPlanFilter {
567
+ workKinds?: readonly string[];
568
+ spreadLanes?: boolean;
569
+ includeOwnershipWarnings?: boolean;
570
+ assignSelectionPriority?: boolean;
571
+ priority?: FrontierSwarmSelectionPriorityInput;
572
+ }
573
+ export interface FrontierSwarmTaskSelectionEntry {
574
+ task: FrontierSwarmTask;
575
+ lane?: FrontierSwarmLane;
576
+ ownershipWarnings: string[];
577
+ selectionPriority: number;
578
+ }
579
+ export interface FrontierSwarmTaskSelectionSummary {
580
+ total: number;
581
+ byLane: Record<string, number>;
582
+ byWorkKind: Record<string, number>;
583
+ ownershipWarningCount: number;
584
+ }
585
+ export interface FrontierSwarmTaskSelection {
586
+ tasks: FrontierSwarmTask[];
587
+ entries: FrontierSwarmTaskSelectionEntry[];
588
+ summary: FrontierSwarmTaskSelectionSummary;
589
+ }
590
+ export interface FrontierSwarmModelTokenEstimateInput {
591
+ inputTokens?: number;
592
+ cachedInputTokens?: number;
593
+ outputTokens?: number;
594
+ metadata?: unknown;
595
+ }
596
+ export interface FrontierSwarmModelTokenEstimate {
597
+ inputTokens: number;
598
+ cachedInputTokens: number;
599
+ outputTokens: number;
600
+ totalTokens: number;
601
+ metadata?: JsonObject;
602
+ }
603
+ export interface FrontierSwarmModelPriceInput {
604
+ id?: string;
605
+ compute?: string;
606
+ model?: string;
607
+ inputUsdPerUnit?: number;
608
+ cachedInputUsdPerUnit?: number;
609
+ outputUsdPerUnit?: number;
610
+ unitTokens?: number;
611
+ latencyMs?: number;
612
+ metadata?: unknown;
613
+ }
614
+ export interface FrontierSwarmModelPrice {
615
+ id: string;
616
+ compute?: string;
617
+ model?: string;
618
+ inputUsdPerUnit: number;
619
+ cachedInputUsdPerUnit: number;
620
+ outputUsdPerUnit: number;
621
+ unitTokens: number;
622
+ latencyMs?: number;
623
+ metadata?: JsonObject;
624
+ }
625
+ export interface FrontierSwarmModelOutcomeInput {
626
+ compute?: string;
627
+ model?: string;
628
+ attempts?: number;
629
+ successRate?: number;
630
+ failureRate?: number;
631
+ confidence?: number;
632
+ averageCostUsd?: number;
633
+ averageDurationMs?: number;
634
+ metadata?: unknown;
635
+ }
636
+ export interface FrontierSwarmPanelRouteInput {
637
+ enabled?: boolean;
638
+ strategy?: FrontierSwarmPanelStrategy;
639
+ memberComputeIds?: readonly string[];
640
+ minMembers?: number;
641
+ maxMembers?: number;
642
+ fuserComputeId?: string;
643
+ fuserTokenEstimate?: FrontierSwarmModelTokenEstimateInput;
644
+ confidenceLift?: number;
645
+ minRiskScore?: number;
646
+ maxCostUsd?: number;
647
+ metadata?: unknown;
648
+ }
649
+ export interface FrontierSwarmTaskModelProfile {
650
+ workKind: string;
651
+ modelTier: FrontierSwarmTaskModelTier;
652
+ costBand: FrontierSwarmTaskModelCostBand;
653
+ model?: string;
654
+ context: string;
655
+ strengths: string[];
656
+ failureModes: string[];
657
+ notes?: string[];
658
+ }
659
+ export interface FrontierSwarmModelRouterInput {
660
+ id?: string;
661
+ manifest?: FrontierSwarmManifest | FrontierSwarmManifestInput;
662
+ task: FrontierSwarmTask | FrontierSwarmTaskInput;
663
+ candidates?: readonly (string | FrontierSwarmComputeInput | FrontierSwarmCompute)[];
664
+ routingPolicy?: FrontierSwarmModelRoutingPolicyInput | FrontierSwarmModelRoutingPolicy | unknown;
665
+ routingMode?: FrontierSwarmModelRoutingMode;
666
+ priceCatalog?: Record<string, FrontierSwarmModelPriceInput> | readonly FrontierSwarmModelPriceInput[];
667
+ tokenEstimate?: FrontierSwarmModelTokenEstimateInput;
668
+ budget?: FrontierSwarmBudget | FrontierSwarmBudgetInput;
669
+ timePressure?: FrontierSwarmTimePressure | number;
670
+ outcomeHistory?: readonly FrontierSwarmModelOutcomeInput[];
671
+ requiredCapabilities?: readonly string[];
672
+ panel?: FrontierSwarmPanelRouteInput;
673
+ generatedAt?: number;
674
+ metadata?: unknown;
675
+ }
676
+ export interface FrontierSwarmModelRouteCandidate {
677
+ compute: FrontierSwarmCompute;
678
+ capable: boolean;
679
+ missingCapabilities: string[];
680
+ estimatedCostUsd: number;
681
+ estimatedLatencyMs: number;
682
+ priceKnown: boolean;
683
+ outcomeKnown: boolean;
684
+ budgetOk: boolean;
685
+ qualityScore: number;
686
+ costScore: number;
687
+ latencyScore: number;
688
+ historyScore: number;
689
+ riskFitScore: number;
690
+ score: number;
691
+ reasons: string[];
692
+ metadata?: JsonObject;
693
+ }
694
+ export interface FrontierSwarmPanelEvaluationInput {
695
+ id?: string;
696
+ candidates?: readonly FrontierSwarmModelRouteCandidate[];
697
+ task?: FrontierSwarmTask | FrontierSwarmTaskInput;
698
+ budget?: FrontierSwarmBudget | FrontierSwarmBudgetInput;
699
+ panel?: FrontierSwarmPanelRouteInput;
700
+ riskScore?: number;
701
+ uncertaintyScore?: number;
702
+ impactScore?: number;
703
+ generatedAt?: number;
704
+ metadata?: unknown;
705
+ }
706
+ export interface FrontierSwarmPanelEvaluation {
707
+ kind: typeof FRONTIER_SWARM_PANEL_EVALUATION_KIND;
708
+ version: typeof FRONTIER_SWARM_PANEL_EVALUATION_VERSION;
709
+ id: string;
710
+ generatedAt: number;
711
+ strategy: FrontierSwarmPanelStrategy;
712
+ memberComputeIds: string[];
713
+ fuserComputeId?: string;
714
+ expectedCostUsd: number;
715
+ expectedLatencyMs: number;
716
+ confidenceLift: number;
717
+ confidenceScore: number;
718
+ residualRiskScore: number;
719
+ budgetOk: boolean;
720
+ recommended: boolean;
721
+ reasons: string[];
722
+ summary: {
723
+ memberCount: number;
724
+ costUsd: number;
725
+ latencyMs: number;
726
+ confidenceLift: number;
727
+ residualRiskScore: number;
728
+ };
729
+ metadata?: JsonObject;
730
+ }
731
+ export interface FrontierSwarmModelRoute {
732
+ kind: typeof FRONTIER_SWARM_MODEL_ROUTE_KIND;
733
+ version: typeof FRONTIER_SWARM_MODEL_ROUTE_VERSION;
734
+ id: string;
735
+ generatedAt: number;
736
+ taskId: string;
737
+ taskProfile?: FrontierSwarmTaskModelProfile;
738
+ route: FrontierSwarmModelRouteStrategy;
739
+ recommendedComputeIds: string[];
740
+ fuserComputeId?: string;
741
+ recommended: FrontierSwarmModelRouteCandidate;
742
+ candidates: FrontierSwarmModelRouteCandidate[];
743
+ panel?: FrontierSwarmPanelEvaluation;
744
+ tokenEstimate: FrontierSwarmModelTokenEstimate;
745
+ riskScore: number;
746
+ uncertaintyScore: number;
747
+ impactScore: number;
748
+ timePressureScore: number;
749
+ reasons: string[];
750
+ explanation: string;
751
+ summary: {
752
+ candidateCount: number;
753
+ capableCount: number;
754
+ priceKnownCount: number;
755
+ outcomeKnownCount: number;
756
+ cheapestCapableComputeId?: string;
757
+ recommendedCostUsd: number;
758
+ recommendedLatencyMs: number;
759
+ routingPolicyFeedbackCount: number;
760
+ routingPolicyOutcomeCount: number;
761
+ routingPolicyCostSignalCount: number;
762
+ routingPolicyPreferenceCount: number;
763
+ panelCostUsd?: number;
764
+ panelLatencyMs?: number;
765
+ };
766
+ metadata?: JsonObject;
767
+ }
768
+ export interface FrontierSwarmOptimizationSummaryCounts {
769
+ modelRouteDecisionCount: number;
770
+ panelDecisionCount: number;
771
+ fusionDecisionCount: number;
772
+ tournamentObservationCount: number;
773
+ routingFeedbackCount: number;
774
+ modelDiversityCount: number;
775
+ feedbackConsumed: boolean;
776
+ }
777
+ export interface FrontierSwarmOptimizationSummaryInput {
778
+ id?: string;
779
+ telemetryAvailable?: boolean;
780
+ modelRouteDecisionCount?: number;
781
+ panelDecisionCount?: number;
782
+ fusionDecisionCount?: number;
783
+ tournamentObservationCount?: number;
784
+ routingFeedbackCount?: number;
785
+ modelDiversityCount?: number;
786
+ feedbackConsumed?: boolean;
787
+ generatedAt?: number;
788
+ metadata?: unknown;
789
+ }
790
+ export interface FrontierSwarmOptimizationSummary {
791
+ kind: typeof FRONTIER_SWARM_OPTIMIZATION_SUMMARY_KIND;
792
+ version: typeof FRONTIER_SWARM_OPTIMIZATION_SUMMARY_VERSION;
793
+ id: string;
794
+ generatedAt: number;
795
+ telemetryAvailable: boolean;
796
+ summary?: FrontierSwarmOptimizationSummaryCounts;
797
+ metadata?: JsonObject;
798
+ }
799
+ export interface FrontierSwarmPlanInput extends FrontierSwarmPlanFilter {
800
+ id?: string;
801
+ runId?: string;
802
+ now?: number;
803
+ maxReadyJobs?: number;
804
+ maxLaneConcurrency?: Record<string, number>;
805
+ maxConcurrencyKeyConcurrency?: Record<string, number>;
806
+ maxComputeConcurrency?: Record<string, number>;
807
+ resourceQuotas?: Record<string, number>;
808
+ routingMode?: FrontierSwarmModelRoutingMode;
809
+ routingPolicy?: FrontierSwarmModelRoutingPolicyInput | FrontierSwarmModelRoutingPolicy | unknown;
810
+ routingContext?: unknown;
811
+ metadata?: unknown;
812
+ }
813
+ export interface FrontierSwarmPlan {
814
+ kind: typeof FRONTIER_SWARM_PLAN_KIND;
815
+ version: typeof FRONTIER_SWARM_PLAN_VERSION;
816
+ id: string;
817
+ runId: string;
818
+ manifestId: string;
819
+ createdAt: number;
820
+ filters: FrontierSwarmPlanFilter;
821
+ limits: FrontierSwarmScheduleLimits;
822
+ routingMode?: FrontierSwarmModelRoutingMode;
823
+ routingPolicy?: FrontierSwarmModelRoutingPolicy;
824
+ routingContext?: JsonValue;
825
+ validation: FrontierSwarmValidation;
826
+ jobs: FrontierSwarmJob[];
827
+ graph: FrontierSwarmJobGraph;
828
+ summary: FrontierSwarmSummary;
829
+ metadata?: JsonObject;
830
+ }
831
+ export interface FrontierSwarmScheduleLimits {
832
+ maxReadyJobs?: number;
833
+ maxLaneConcurrency: Record<string, number>;
834
+ maxConcurrencyKeyConcurrency: Record<string, number>;
835
+ maxComputeConcurrency: Record<string, number>;
836
+ resourceQuotas: Record<string, number>;
837
+ }
838
+ export interface FrontierSwarmJob {
839
+ id: string;
840
+ taskId: string;
841
+ title: string;
842
+ lane: string;
843
+ layer?: string;
844
+ compute: FrontierSwarmCompute;
845
+ status: FrontierSwarmJobStatus;
846
+ priority: number;
847
+ task: FrontierSwarmTask;
848
+ allowedWrites: string[];
849
+ sharedReadOnly: string[];
850
+ neverEdit: string[];
851
+ ownershipRegions: FrontierSwarmOwnershipRegion[];
852
+ ownedRegions: string[];
853
+ changedRegions: string[];
854
+ capabilities: string[];
855
+ resourceRequirements?: FrontierSwarmResourceRequirements;
856
+ worktreePath?: string;
857
+ evidencePrefix?: string;
858
+ concurrencyKey: string;
859
+ ownershipWarnings: string[];
860
+ verification: FrontierSwarmCommand[];
861
+ acceptance: string[];
862
+ dependsOn: string[];
863
+ budget?: FrontierSwarmBudget;
864
+ review: FrontierSwarmReviewPolicy;
865
+ tags: string[];
866
+ metadata?: JsonObject;
867
+ }
868
+ export interface FrontierSwarmBudgetInput {
869
+ maxCostUsd?: number;
870
+ maxInputTokens?: number;
871
+ maxOutputTokens?: number;
872
+ maxDurationMs?: number;
873
+ maxRetries?: number;
874
+ metadata?: unknown;
875
+ }
876
+ export interface FrontierSwarmBudget {
877
+ maxCostUsd?: number;
878
+ maxInputTokens?: number;
879
+ maxOutputTokens?: number;
880
+ maxDurationMs?: number;
881
+ maxRetries: number;
882
+ metadata?: JsonObject;
883
+ }
884
+ export interface FrontierSwarmUsageInput {
885
+ costUsd?: number;
886
+ inputTokens?: number;
887
+ outputTokens?: number;
888
+ durationMs?: number;
889
+ attempts?: number;
890
+ metadata?: unknown;
891
+ }
892
+ export interface FrontierSwarmUsage {
893
+ costUsd: number;
894
+ inputTokens: number;
895
+ outputTokens: number;
896
+ durationMs: number;
897
+ attempts: number;
898
+ metadata?: JsonObject;
899
+ }
900
+ export interface FrontierSwarmBudgetDecision {
901
+ ok: boolean;
902
+ jobId: string;
903
+ usage: FrontierSwarmUsage;
904
+ budget?: FrontierSwarmBudget;
905
+ violations: string[];
906
+ }
907
+ export interface FrontierSwarmReviewPolicyInput {
908
+ requiredReviewers?: number;
909
+ sampleRate?: number;
910
+ alwaysReview?: boolean;
911
+ reviewerPool?: readonly string[];
912
+ metadata?: unknown;
913
+ }
914
+ export interface FrontierSwarmReviewPolicy {
915
+ requiredReviewers: number;
916
+ sampleRate: number;
917
+ alwaysReview: boolean;
918
+ reviewerPool: string[];
919
+ metadata?: JsonObject;
920
+ }
921
+ export interface FrontierSwarmJobGraph {
922
+ nodes: string[];
923
+ edges: FrontierSwarmJobGraphEdge[];
924
+ dependentsByJobId: Record<string, string[]>;
925
+ dependenciesByJobId: Record<string, string[]>;
926
+ roots: string[];
927
+ leaves: string[];
928
+ issues: FrontierSwarmValidationIssue[];
929
+ }
930
+ export interface FrontierSwarmJobGraphEdge {
931
+ from: string;
932
+ to: string;
933
+ type: 'depends-on' | 'parent-task';
934
+ }
935
+ export type FrontierSwarmGraphNodeKind = (typeof FRONTIER_SWARM_GRAPH_NODE_KINDS)[number] | string;
936
+ export type FrontierSwarmGraphEdgeKind = (typeof FRONTIER_SWARM_GRAPH_EDGE_KINDS)[number] | string;
937
+ export type FrontierSwarmGraphStatus = 'pending' | 'running' | 'passed' | 'failed' | 'accepted' | 'rejected' | 'blocked' | 'superseded' | 'unknown' | string;
938
+ export interface FrontierSwarmGraphNodeInput {
939
+ id?: string;
940
+ kind: FrontierSwarmGraphNodeKind;
941
+ title?: string;
942
+ status?: FrontierSwarmGraphStatus;
943
+ jobId?: string;
944
+ taskId?: string;
945
+ path?: string;
946
+ generatedAt?: number;
947
+ metadata?: unknown;
948
+ }
949
+ export interface FrontierSwarmGraphNode {
950
+ id: string;
951
+ kind: FrontierSwarmGraphNodeKind;
952
+ title?: string;
953
+ status?: FrontierSwarmGraphStatus;
954
+ jobId?: string;
955
+ taskId?: string;
956
+ path?: string;
957
+ generatedAt?: number;
958
+ metadata?: JsonObject;
959
+ }
960
+ export interface FrontierSwarmGraphEdgeInput {
961
+ id?: string;
962
+ from: string;
963
+ to: string;
964
+ kind: FrontierSwarmGraphEdgeKind;
965
+ label?: string;
966
+ generatedAt?: number;
967
+ metadata?: unknown;
968
+ }
969
+ export interface FrontierSwarmGraphEdge {
970
+ id: string;
971
+ from: string;
972
+ to: string;
973
+ kind: FrontierSwarmGraphEdgeKind;
974
+ label?: string;
975
+ generatedAt?: number;
976
+ metadata?: JsonObject;
977
+ }
978
+ export type FrontierSwarmMergeCandidateAdmissionStatus = (typeof FRONTIER_SWARM_MERGE_CANDIDATE_ADMISSION_STATUSES)[number] | string;
979
+ export type FrontierSwarmMergeCandidateReasonCode = (typeof FRONTIER_SWARM_MERGE_CANDIDATE_REASON_CODES)[number] | string;
980
+ export type FrontierSwarmSemanticChangeOperation = 'add' | 'modify' | 'delete' | 'move' | 'rename' | 'replace' | 'unknown' | string;
981
+ export type FrontierSwarmSemanticChangeConfidence = FrontierSwarmConfidence | number;
982
+ export interface FrontierSwarmSourceSpanInput {
983
+ path?: string;
984
+ startLine?: number;
985
+ startColumn?: number;
986
+ endLine?: number;
987
+ endColumn?: number;
988
+ startOffset?: number;
989
+ endOffset?: number;
990
+ sourceHash?: string;
991
+ expectedSourceHash?: string;
992
+ metadata?: unknown;
993
+ }
994
+ export interface FrontierSwarmSourceSpan {
995
+ path?: string;
996
+ startLine?: number;
997
+ startColumn?: number;
998
+ endLine?: number;
999
+ endColumn?: number;
1000
+ startOffset?: number;
1001
+ endOffset?: number;
1002
+ sourceHash?: string;
1003
+ expectedSourceHash?: string;
1004
+ metadata?: JsonObject;
1005
+ }
1006
+ export interface FrontierSwarmSemanticChangeInput {
1007
+ id?: string;
1008
+ symbolId: string;
1009
+ declarationKind: string;
1010
+ sourceSpan?: FrontierSwarmSourceSpanInput;
1011
+ sourcePath?: string;
1012
+ sourceHash?: string;
1013
+ expectedSourceHash?: string;
1014
+ operation: FrontierSwarmSemanticChangeOperation;
1015
+ confidence?: FrontierSwarmSemanticChangeConfidence;
1016
+ conflictReason?: FrontierSwarmMergeCandidateReasonCode;
1017
+ status?: FrontierSwarmMergeCandidateAdmissionStatus;
1018
+ reasonCodes?: readonly FrontierSwarmMergeCandidateReasonCode[];
1019
+ generatedAt?: number;
1020
+ metadata?: unknown;
1021
+ }
1022
+ export interface FrontierSwarmSemanticChange {
1023
+ kind: typeof FRONTIER_SWARM_SEMANTIC_CHANGE_KIND;
1024
+ version: typeof FRONTIER_SWARM_SEMANTIC_CHANGE_VERSION;
1025
+ id: string;
1026
+ symbolId: string;
1027
+ declarationKind: string;
1028
+ sourceSpan: FrontierSwarmSourceSpan;
1029
+ operation: FrontierSwarmSemanticChangeOperation;
1030
+ confidence: FrontierSwarmSemanticChangeConfidence;
1031
+ conflictReason?: FrontierSwarmMergeCandidateReasonCode;
1032
+ status: FrontierSwarmMergeCandidateAdmissionStatus;
1033
+ reasonCodes: FrontierSwarmMergeCandidateReasonCode[];
1034
+ generatedAt: number;
1035
+ metadata?: JsonObject;
1036
+ }
1037
+ export interface FrontierSwarmMergeCandidateInput {
1038
+ id?: string;
1039
+ jobId?: string;
1040
+ taskId?: string;
1041
+ lane?: string;
1042
+ title?: string;
1043
+ sidecarPath?: string;
1044
+ sidecarRequired?: boolean;
1045
+ sidecarEmpty?: boolean;
1046
+ symbolId?: string;
1047
+ declarationKind?: string;
1048
+ sourceSpan?: FrontierSwarmSourceSpanInput;
1049
+ sourcePath?: string;
1050
+ sourceHash?: string;
1051
+ expectedSourceHash?: string;
1052
+ operation?: FrontierSwarmSemanticChangeOperation;
1053
+ confidence?: FrontierSwarmSemanticChangeConfidence;
1054
+ conflictReason?: FrontierSwarmMergeCandidateReasonCode;
1055
+ status?: FrontierSwarmMergeCandidateAdmissionStatus;
1056
+ reasonCodes?: readonly FrontierSwarmMergeCandidateReasonCode[];
1057
+ semanticChanges?: readonly (FrontierSwarmSemanticChangeInput | FrontierSwarmSemanticChange)[];
1058
+ changes?: readonly (FrontierSwarmSemanticChangeInput | FrontierSwarmSemanticChange)[];
1059
+ hasLosses?: boolean;
1060
+ testsRequired?: boolean;
1061
+ testsPassed?: boolean;
1062
+ evidencePaths?: readonly string[];
1063
+ generatedAt?: number;
1064
+ metadata?: unknown;
1065
+ }
1066
+ export interface FrontierSwarmMergeCandidate {
1067
+ kind: typeof FRONTIER_SWARM_MERGE_CANDIDATE_KIND;
1068
+ version: typeof FRONTIER_SWARM_MERGE_CANDIDATE_VERSION;
1069
+ id: string;
1070
+ jobId?: string;
1071
+ taskId?: string;
1072
+ lane?: string;
1073
+ title?: string;
1074
+ sidecarPath?: string;
1075
+ symbolId: string;
1076
+ symbolIds: string[];
1077
+ declarationKind: string;
1078
+ declarationKinds: string[];
1079
+ sourceSpan: FrontierSwarmSourceSpan;
1080
+ operation: FrontierSwarmSemanticChangeOperation;
1081
+ confidence: FrontierSwarmSemanticChangeConfidence;
1082
+ conflictReason?: FrontierSwarmMergeCandidateReasonCode;
1083
+ status: FrontierSwarmMergeCandidateAdmissionStatus;
1084
+ reasonCodes: FrontierSwarmMergeCandidateReasonCode[];
1085
+ semanticChanges: FrontierSwarmSemanticChange[];
1086
+ changedPaths: string[];
1087
+ evidencePaths: string[];
1088
+ generatedAt: number;
1089
+ summary: {
1090
+ changeCount: number;
1091
+ symbolCount: number;
1092
+ reasonCount: number;
1093
+ };
1094
+ metadata?: JsonObject;
1095
+ }
1096
+ export interface FrontierSwarmMergeCandidateGraphInput {
1097
+ id?: string;
1098
+ runId?: string;
1099
+ title?: string;
1100
+ candidates: readonly (FrontierSwarmMergeCandidateInput | FrontierSwarmMergeCandidate)[];
1101
+ includeChangeNodes?: boolean;
1102
+ generatedAt?: number;
1103
+ metadata?: unknown;
1104
+ }
1105
+ export interface FrontierSwarmMergeCandidateGraphProjection {
1106
+ candidates: FrontierSwarmMergeCandidate[];
1107
+ nodes: FrontierSwarmGraphNodeInput[];
1108
+ edges: FrontierSwarmGraphEdgeInput[];
1109
+ }
1110
+ export interface FrontierSwarmGraphEventInput {
1111
+ id?: string;
1112
+ type: string;
1113
+ nodeId?: string;
1114
+ edgeId?: string;
1115
+ timestamp?: number;
1116
+ metadata?: unknown;
1117
+ }
1118
+ export interface FrontierSwarmGraphEvent {
1119
+ id: string;
1120
+ type: string;
1121
+ nodeId?: string;
1122
+ edgeId?: string;
1123
+ timestamp: number;
1124
+ metadata?: JsonObject;
1125
+ }
1126
+ export interface FrontierSwarmRunGraphSummary {
1127
+ nodeCount: number;
1128
+ edgeCount: number;
1129
+ eventCount: number;
1130
+ nodeKinds: Record<string, number>;
1131
+ edgeKinds: Record<string, number>;
1132
+ openBlockerCount: number;
1133
+ humanQuestionCount: number;
1134
+ }
1135
+ export interface FrontierSwarmRunGraphInput {
1136
+ id?: string;
1137
+ runId?: string;
1138
+ title?: string;
1139
+ generatedAt?: number;
1140
+ nodes?: readonly FrontierSwarmGraphNodeInput[];
1141
+ edges?: readonly FrontierSwarmGraphEdgeInput[];
1142
+ events?: readonly FrontierSwarmGraphEventInput[];
1143
+ metadata?: unknown;
1144
+ }
1145
+ export interface FrontierSwarmRunGraph {
1146
+ kind: typeof FRONTIER_SWARM_RUN_GRAPH_KIND;
1147
+ version: typeof FRONTIER_SWARM_RUN_GRAPH_VERSION;
1148
+ id: string;
1149
+ runId?: string;
1150
+ title?: string;
1151
+ generatedAt: number;
1152
+ nodes: FrontierSwarmGraphNode[];
1153
+ edges: FrontierSwarmGraphEdge[];
1154
+ events: FrontierSwarmGraphEvent[];
1155
+ summary: FrontierSwarmRunGraphSummary;
1156
+ metadata?: JsonObject;
1157
+ }
1158
+ export interface FrontierSwarmGraphSnapshotInput {
1159
+ id?: string;
1160
+ graph: FrontierSwarmRunGraphInput | FrontierSwarmRunGraph;
1161
+ generatedAt?: number;
1162
+ metadata?: unknown;
1163
+ }
1164
+ export interface FrontierSwarmGraphSnapshot {
1165
+ kind: typeof FRONTIER_SWARM_GRAPH_SNAPSHOT_KIND;
1166
+ version: typeof FRONTIER_SWARM_GRAPH_SNAPSHOT_VERSION;
1167
+ id: string;
1168
+ graphId: string;
1169
+ generatedAt: number;
1170
+ summary: FrontierSwarmRunGraphSummary;
1171
+ graph: FrontierSwarmRunGraph;
1172
+ metadata?: JsonObject;
1173
+ }
1174
+ export type FrontierSwarmGateRecordType = FrontierSwarmVerificationCategory | 'command' | 'browser' | 'fuzz' | 'oracle' | 'benchmark' | 'semantic-sidecar' | 'replay' | string;
1175
+ export type FrontierSwarmGateRecordStatus = 'passed' | 'failed' | 'unknown' | 'skipped' | 'blocked' | string;
1176
+ export type FrontierSwarmEvidenceRecordType = 'command-output' | 'browser' | 'fuzz' | 'oracle' | 'benchmark' | 'semantic-sidecar' | 'replay' | 'artifact' | string;
1177
+ export type FrontierSwarmPatchEventOperation = 'add' | 'remove' | 'replace' | 'move' | 'copy' | 'test' | string;
1178
+ export type FrontierSwarmReplayRecordStatus = 'pending' | 'running' | 'passed' | 'failed' | 'blocked' | 'skipped' | 'unknown' | string;
1179
+ export type FrontierSwarmImprovementLoopStatus = 'observed' | 'planned' | 'running' | 'applied' | 'verified' | 'failed' | 'blocked' | 'unknown' | string;
1180
+ export interface FrontierSwarmGateRecordInput {
1181
+ id?: string;
1182
+ type: FrontierSwarmGateRecordType;
1183
+ status?: FrontierSwarmGateRecordStatus;
1184
+ required?: boolean;
1185
+ command?: string;
1186
+ path?: string;
1187
+ jobId?: string;
1188
+ taskId?: string;
1189
+ startedAt?: number;
1190
+ finishedAt?: number;
1191
+ failureReason?: string;
1192
+ confidence?: FrontierSwarmConfidence;
1193
+ metrics?: unknown;
1194
+ metadata?: unknown;
1195
+ }
1196
+ export interface FrontierSwarmGateRecord {
1197
+ kind: typeof FRONTIER_SWARM_GATE_RECORD_KIND;
1198
+ version: typeof FRONTIER_SWARM_GATE_RECORD_VERSION;
1199
+ id: string;
1200
+ type: FrontierSwarmGateRecordType;
1201
+ status: FrontierSwarmGateRecordStatus;
1202
+ required: boolean;
1203
+ command?: string;
1204
+ path?: string;
1205
+ jobId?: string;
1206
+ taskId?: string;
1207
+ startedAt?: number;
1208
+ finishedAt?: number;
1209
+ failureReason?: string;
1210
+ confidence?: FrontierSwarmConfidence;
1211
+ metrics?: JsonObject;
1212
+ metadata?: JsonObject;
1213
+ }
1214
+ export interface FrontierSwarmEvidenceRecordInput {
1215
+ id?: string;
1216
+ type: FrontierSwarmEvidenceRecordType;
1217
+ path?: string;
1218
+ ref?: string;
1219
+ jobId?: string;
1220
+ taskId?: string;
1221
+ gateId?: string;
1222
+ producedAt?: number;
1223
+ confidence?: FrontierSwarmConfidence;
1224
+ metrics?: unknown;
1225
+ metadata?: unknown;
1226
+ }
1227
+ export interface FrontierSwarmEvidenceRecord {
1228
+ kind: typeof FRONTIER_SWARM_EVIDENCE_RECORD_KIND;
1229
+ version: typeof FRONTIER_SWARM_EVIDENCE_RECORD_VERSION;
1230
+ id: string;
1231
+ type: FrontierSwarmEvidenceRecordType;
1232
+ path?: string;
1233
+ ref?: string;
1234
+ jobId?: string;
1235
+ taskId?: string;
1236
+ gateId?: string;
1237
+ producedAt: number;
1238
+ confidence?: FrontierSwarmConfidence;
1239
+ metrics?: JsonObject;
1240
+ metadata?: JsonObject;
1241
+ }
1242
+ export interface FrontierSwarmGraphRefInput {
1243
+ id?: string;
1244
+ kind?: string;
1245
+ graphId?: string;
1246
+ nodeId?: string;
1247
+ edgeId?: string;
1248
+ role?: string;
1249
+ metadata?: unknown;
1250
+ }
1251
+ export interface FrontierSwarmGraphRef {
1252
+ id: string;
1253
+ kind: string;
1254
+ graphId?: string;
1255
+ nodeId?: string;
1256
+ edgeId?: string;
1257
+ role?: string;
1258
+ metadata?: JsonObject;
1259
+ }
1260
+ export interface FrontierSwarmPatchEventInput {
1261
+ id?: string;
1262
+ operation: FrontierSwarmPatchEventOperation;
1263
+ path: string;
1264
+ from?: string;
1265
+ hash?: string;
1266
+ sequence?: number;
1267
+ value?: unknown;
1268
+ before?: unknown;
1269
+ after?: unknown;
1270
+ jobId?: string;
1271
+ taskId?: string;
1272
+ replayRecordId?: string;
1273
+ graphRefs?: readonly FrontierSwarmGraphRefInput[];
1274
+ generatedAt?: number;
1275
+ metadata?: unknown;
1276
+ }
1277
+ export interface FrontierSwarmPatchEvent {
1278
+ kind: typeof FRONTIER_SWARM_PATCH_EVENT_KIND;
1279
+ version: typeof FRONTIER_SWARM_PATCH_EVENT_VERSION;
1280
+ id: string;
1281
+ operation: FrontierSwarmPatchEventOperation;
1282
+ path: string;
1283
+ from?: string;
1284
+ hash?: string;
1285
+ sequence?: number;
1286
+ value?: JsonValue;
1287
+ before?: JsonValue;
1288
+ after?: JsonValue;
1289
+ jobId?: string;
1290
+ taskId?: string;
1291
+ replayRecordId?: string;
1292
+ graphRefs: FrontierSwarmGraphRef[];
1293
+ generatedAt: number;
1294
+ metadata?: JsonObject;
1295
+ }
1296
+ export interface FrontierSwarmReplayRecordInput {
1297
+ id?: string;
1298
+ title?: string;
1299
+ status?: FrontierSwarmReplayRecordStatus;
1300
+ subject?: string;
1301
+ replayBundleId?: string;
1302
+ patchEvents?: readonly (FrontierSwarmPatchEventInput | FrontierSwarmPatchEvent)[];
1303
+ evidenceRefs?: readonly (string | FrontierSwarmNamedRefInput)[];
1304
+ graphRefs?: readonly FrontierSwarmGraphRefInput[];
1305
+ jobId?: string;
1306
+ taskId?: string;
1307
+ startedAt?: number;
1308
+ finishedAt?: number;
1309
+ generatedAt?: number;
1310
+ metadata?: unknown;
1311
+ }
1312
+ export interface FrontierSwarmReplayRecord {
1313
+ kind: typeof FRONTIER_SWARM_REPLAY_RECORD_KIND;
1314
+ version: typeof FRONTIER_SWARM_REPLAY_RECORD_VERSION;
1315
+ id: string;
1316
+ title: string;
1317
+ status: FrontierSwarmReplayRecordStatus;
1318
+ subject?: string;
1319
+ replayBundleId?: string;
1320
+ patchEvents: FrontierSwarmPatchEvent[];
1321
+ evidenceRefs: FrontierSwarmNamedRef[];
1322
+ graphRefs: FrontierSwarmGraphRef[];
1323
+ jobId?: string;
1324
+ taskId?: string;
1325
+ startedAt?: number;
1326
+ finishedAt?: number;
1327
+ generatedAt: number;
1328
+ summary: {
1329
+ patchEventCount: number;
1330
+ evidenceRefCount: number;
1331
+ graphRefCount: number;
1332
+ };
1333
+ metadata?: JsonObject;
1334
+ }
1335
+ export interface FrontierSwarmImprovementLoopInput {
1336
+ id?: string;
1337
+ title?: string;
1338
+ status?: FrontierSwarmImprovementLoopStatus;
1339
+ subject?: string;
1340
+ observation?: unknown;
1341
+ action?: unknown;
1342
+ result?: unknown;
1343
+ replayRecordIds?: readonly string[];
1344
+ patchEventIds?: readonly string[];
1345
+ evidenceRefs?: readonly (string | FrontierSwarmNamedRefInput)[];
1346
+ graphRefs?: readonly FrontierSwarmGraphRefInput[];
1347
+ jobId?: string;
1348
+ taskId?: string;
1349
+ generatedAt?: number;
1350
+ metadata?: unknown;
1351
+ }
1352
+ export interface FrontierSwarmImprovementLoop {
1353
+ kind: typeof FRONTIER_SWARM_IMPROVEMENT_LOOP_KIND;
1354
+ version: typeof FRONTIER_SWARM_IMPROVEMENT_LOOP_VERSION;
1355
+ id: string;
1356
+ title: string;
1357
+ status: FrontierSwarmImprovementLoopStatus;
1358
+ subject?: string;
1359
+ observation?: JsonValue;
1360
+ action?: JsonValue;
1361
+ result?: JsonValue;
1362
+ replayRecordIds: string[];
1363
+ patchEventIds: string[];
1364
+ evidenceRefs: FrontierSwarmNamedRef[];
1365
+ graphRefs: FrontierSwarmGraphRef[];
1366
+ jobId?: string;
1367
+ taskId?: string;
1368
+ generatedAt: number;
1369
+ summary: {
1370
+ replayRecordCount: number;
1371
+ patchEventCount: number;
1372
+ evidenceRefCount: number;
1373
+ graphRefCount: number;
1374
+ };
1375
+ metadata?: JsonObject;
1376
+ }
1377
+ export interface FrontierSwarmRunGraphChunkInput {
1378
+ id?: string;
1379
+ nodes?: readonly FrontierSwarmGraphNodeInput[];
1380
+ edges?: readonly FrontierSwarmGraphEdgeInput[];
1381
+ entryNodeIds?: readonly string[];
1382
+ exitNodeIds?: readonly string[];
1383
+ metadata?: unknown;
1384
+ }
1385
+ export interface FrontierSwarmRunGraphChunk {
1386
+ kind: typeof FRONTIER_SWARM_RUN_GRAPH_CHUNK_KIND;
1387
+ version: typeof FRONTIER_SWARM_RUN_GRAPH_CHUNK_VERSION;
1388
+ id: string;
1389
+ nodes: FrontierSwarmGraphNode[];
1390
+ edges: FrontierSwarmGraphEdge[];
1391
+ entryNodeIds: string[];
1392
+ exitNodeIds: string[];
1393
+ summary: {
1394
+ nodeCount: number;
1395
+ edgeCount: number;
1396
+ entryCount: number;
1397
+ exitCount: number;
1398
+ };
1399
+ metadata?: JsonObject;
1400
+ }
1401
+ export interface FrontierSwarmRunGraphSynthesisChunkInput {
1402
+ id?: string;
1403
+ source?: FrontierSwarmGraphNodeInput;
1404
+ panel?: FrontierSwarmGraphNodeInput;
1405
+ candidates?: readonly FrontierSwarmGraphNodeInput[];
1406
+ selectedCandidateId?: string;
1407
+ rejectedCandidateIds?: readonly string[];
1408
+ decision?: FrontierSwarmGraphNodeInput;
1409
+ output?: FrontierSwarmGraphNodeInput;
1410
+ metadata?: unknown;
1411
+ }
1412
+ export interface FrontierSwarmRunGraphVerificationGateChunkInput {
1413
+ id?: string;
1414
+ subject: FrontierSwarmGraphNodeInput;
1415
+ gate: FrontierSwarmGraphNodeInput;
1416
+ evidence?: readonly FrontierSwarmGraphNodeInput[];
1417
+ pass?: FrontierSwarmGraphNodeInput;
1418
+ block?: FrontierSwarmGraphNodeInput;
1419
+ metadata?: unknown;
1420
+ }
1421
+ export interface FrontierSwarmRunGraphMergeGateChunkInput {
1422
+ id?: string;
1423
+ candidate: FrontierSwarmGraphNodeInput;
1424
+ gate?: FrontierSwarmGraphNodeInput;
1425
+ decision?: FrontierSwarmGraphNodeInput;
1426
+ target: FrontierSwarmGraphNodeInput;
1427
+ blockers?: readonly FrontierSwarmGraphNodeInput[];
1428
+ superseded?: readonly FrontierSwarmGraphNodeInput[];
1429
+ status?: FrontierSwarmGraphStatus;
1430
+ metadata?: unknown;
1431
+ }
1432
+ export interface FrontierSwarmRunGraphBarrierInput {
1433
+ id?: string;
1434
+ prerequisites: readonly FrontierSwarmGraphNodeInput[];
1435
+ barrier?: FrontierSwarmGraphNodeInput;
1436
+ metadata?: unknown;
1437
+ }
1438
+ export interface FrontierSwarmRunGraphRaceSelectInput {
1439
+ id?: string;
1440
+ branches: readonly FrontierSwarmGraphNodeInput[];
1441
+ selector?: FrontierSwarmGraphNodeInput;
1442
+ selectedBranchId?: string;
1443
+ rejectedBranchIds?: readonly string[];
1444
+ metadata?: unknown;
1445
+ }
1446
+ export interface FrontierSwarmScheduleInput {
1447
+ plan: FrontierSwarmPlan;
1448
+ run?: FrontierSwarmRun;
1449
+ now?: number;
1450
+ maxReadyJobs?: number;
1451
+ maxLaneConcurrency?: Record<string, number>;
1452
+ maxConcurrencyKeyConcurrency?: Record<string, number>;
1453
+ maxComputeConcurrency?: Record<string, number>;
1454
+ resourceQuotas?: Record<string, number>;
1455
+ }
1456
+ export interface FrontierSwarmReviewPlanInput {
1457
+ plan: FrontierSwarmPlan;
1458
+ run?: FrontierSwarmRun;
1459
+ budgetDecisions?: readonly FrontierSwarmBudgetDecision[];
1460
+ reviewers?: readonly string[];
1461
+ generatedAt?: number;
1462
+ sampleSalt?: string;
1463
+ }
1464
+ export interface FrontierSwarmMergePlanInput {
1465
+ plan: FrontierSwarmPlan;
1466
+ run: FrontierSwarmRun;
1467
+ reviewPlan?: FrontierSwarmReviewPlan;
1468
+ generatedAt?: number;
1469
+ }
1470
+ export interface FrontierSwarmSchedule {
1471
+ kind: typeof FRONTIER_SWARM_SCHEDULE_KIND;
1472
+ version: typeof FRONTIER_SWARM_SCHEDULE_VERSION;
1473
+ id: string;
1474
+ planId: string;
1475
+ runId?: string;
1476
+ createdAt: number;
1477
+ ready: FrontierSwarmScheduledJob[];
1478
+ blocked: FrontierSwarmBlockedJob[];
1479
+ running: FrontierSwarmRunningJob[];
1480
+ completed: string[];
1481
+ failed: string[];
1482
+ summary: FrontierSwarmScheduleSummary;
1483
+ metadata?: JsonObject;
1484
+ }
1485
+ export interface FrontierSwarmScheduledJob {
1486
+ jobId: string;
1487
+ taskId: string;
1488
+ lane: string;
1489
+ compute: string;
1490
+ concurrencyKey: string;
1491
+ priority: number;
1492
+ dependsOn: string[];
1493
+ capabilities: string[];
1494
+ resourceRequirements?: FrontierSwarmResourceRequirements;
1495
+ metadata?: JsonObject;
1496
+ }
1497
+ export interface FrontierSwarmBlockedJob extends FrontierSwarmScheduledJob {
1498
+ reasons: string[];
1499
+ waitingFor: string[];
1500
+ }
1501
+ export interface FrontierSwarmRunningJob {
1502
+ jobId: string;
1503
+ lane: string;
1504
+ compute: string;
1505
+ concurrencyKey: string;
1506
+ capabilities: string[];
1507
+ resourceRequirements?: FrontierSwarmResourceRequirements;
1508
+ metadata?: JsonObject;
1509
+ }
1510
+ export interface FrontierSwarmScheduleSummary {
1511
+ jobCount: number;
1512
+ readyCount: number;
1513
+ blockedCount: number;
1514
+ runningCount: number;
1515
+ completedCount: number;
1516
+ failedCount: number;
1517
+ }
1518
+ export interface FrontierSwarmLeaseInput {
1519
+ schedule: FrontierSwarmSchedule;
1520
+ workerId: string;
1521
+ now?: number;
1522
+ leaseMs?: number;
1523
+ count?: number;
1524
+ existingLeases?: readonly FrontierSwarmLease[];
1525
+ }
1526
+ export interface FrontierSwarmLease {
1527
+ kind: typeof FRONTIER_SWARM_LEASE_KIND;
1528
+ version: typeof FRONTIER_SWARM_LEASE_VERSION;
1529
+ id: string;
1530
+ jobId: string;
1531
+ workerId: string;
1532
+ token: string;
1533
+ leasedAt: number;
1534
+ expiresAt: number;
1535
+ fencingToken: number;
1536
+ status: 'active' | 'expired' | 'released';
1537
+ }
1538
+ export type FrontierSwarmQueueJobStatus = 'ready' | 'leased' | 'running' | 'completed' | 'failed' | 'blocked' | 'retrying' | 'dead-letter' | string;
1539
+ export interface FrontierSwarmQueueJobInput {
1540
+ jobId: string;
1541
+ taskId?: string;
1542
+ runId?: string;
1543
+ status?: FrontierSwarmQueueJobStatus;
1544
+ lane?: string;
1545
+ compute?: string;
1546
+ concurrencyKey?: string;
1547
+ priority?: number;
1548
+ attempts?: number;
1549
+ maxAttempts?: number;
1550
+ availableAt?: number;
1551
+ lease?: FrontierSwarmLease;
1552
+ lastError?: string;
1553
+ metadata?: unknown;
1554
+ }
1555
+ export interface FrontierSwarmQueueJob {
1556
+ jobId: string;
1557
+ taskId?: string;
1558
+ runId?: string;
1559
+ status: FrontierSwarmQueueJobStatus;
1560
+ lane?: string;
1561
+ compute?: string;
1562
+ concurrencyKey?: string;
1563
+ priority: number;
1564
+ attempts: number;
1565
+ maxAttempts: number;
1566
+ availableAt?: number;
1567
+ lease?: FrontierSwarmLease;
1568
+ lastError?: string;
1569
+ metadata?: JsonObject;
1570
+ }
1571
+ export interface FrontierSwarmQueueSnapshotInput {
1572
+ id?: string;
1573
+ plan: FrontierSwarmPlan;
1574
+ run?: FrontierSwarmRun;
1575
+ jobs?: readonly FrontierSwarmQueueJobInput[];
1576
+ leases?: readonly FrontierSwarmLease[];
1577
+ generatedAt?: number;
1578
+ metadata?: unknown;
1579
+ }
1580
+ export interface FrontierSwarmQueueSnapshot {
1581
+ kind: typeof FRONTIER_SWARM_QUEUE_SNAPSHOT_KIND;
1582
+ version: typeof FRONTIER_SWARM_QUEUE_SNAPSHOT_VERSION;
1583
+ id: string;
1584
+ planId: string;
1585
+ runId: string;
1586
+ generatedAt: number;
1587
+ jobs: FrontierSwarmQueueJob[];
1588
+ byStatus: Record<string, string[]>;
1589
+ byLane: Record<string, string[]>;
1590
+ leases: FrontierSwarmLease[];
1591
+ metadata?: JsonObject;
1592
+ summary: {
1593
+ jobCount: number;
1594
+ leaseCount: number;
1595
+ readyCount: number;
1596
+ leasedCount: number;
1597
+ completedCount: number;
1598
+ failedCount: number;
1599
+ deadLetterCount: number;
1600
+ };
1601
+ }
1602
+ export interface FrontierSwarmLeaseRenewalInput {
1603
+ lease: FrontierSwarmLease;
1604
+ now?: number;
1605
+ leaseMs?: number;
1606
+ status?: FrontierSwarmLease['status'];
1607
+ }
1608
+ export interface FrontierSwarmQueueAdapter {
1609
+ snapshot(): FrontierSwarmQueueSnapshot | Promise<FrontierSwarmQueueSnapshot>;
1610
+ enqueue?(snapshot: FrontierSwarmQueueSnapshot): FrontierSwarmQueueSnapshot | Promise<FrontierSwarmQueueSnapshot>;
1611
+ lease?(input: FrontierSwarmLeaseInput): readonly FrontierSwarmLease[] | Promise<readonly FrontierSwarmLease[]>;
1612
+ renew?(input: FrontierSwarmLeaseRenewalInput): FrontierSwarmLease | Promise<FrontierSwarmLease>;
1613
+ complete?(result: FrontierSwarmJobResultInput): FrontierSwarmQueueSnapshot | Promise<FrontierSwarmQueueSnapshot>;
1614
+ }
1615
+ export interface FrontierSwarmRunCheckpointInput {
1616
+ run: FrontierSwarmRun;
1617
+ sequence?: number;
1618
+ savedAt?: number;
1619
+ metadata?: unknown;
1620
+ }
1621
+ export interface FrontierSwarmRunCheckpoint {
1622
+ kind: typeof FRONTIER_SWARM_RUN_CHECKPOINT_KIND;
1623
+ version: typeof FRONTIER_SWARM_RUN_CHECKPOINT_VERSION;
1624
+ id: string;
1625
+ runId: string;
1626
+ planId: string;
1627
+ sequence: number;
1628
+ savedAt: number;
1629
+ status: FrontierSwarmJobStatus;
1630
+ eventCount: number;
1631
+ resultCount: number;
1632
+ hash: string;
1633
+ metadata?: JsonObject;
1634
+ }
1635
+ export interface FrontierSwarmRunStoreAdapter {
1636
+ loadRun(runId: string): FrontierSwarmRun | undefined | Promise<FrontierSwarmRun | undefined>;
1637
+ saveRun(run: FrontierSwarmRun, checkpoint?: FrontierSwarmRunCheckpoint): void | Promise<void>;
1638
+ appendEvents?(runId: string, events: readonly FrontierSwarmEventInput[]): void | Promise<void>;
1639
+ appendResults?(runId: string, results: readonly FrontierSwarmJobResultInput[]): void | Promise<void>;
1640
+ checkpoint?(run: FrontierSwarmRun): FrontierSwarmRunCheckpoint | Promise<FrontierSwarmRunCheckpoint>;
1641
+ }
1642
+ export interface FrontierSwarmArtifactInput {
1643
+ jobId: string;
1644
+ path: string;
1645
+ kind?: string;
1646
+ bytes?: number;
1647
+ hash?: string;
1648
+ producedAt?: number;
1649
+ metadata?: unknown;
1650
+ }
1651
+ export interface FrontierSwarmArtifact {
1652
+ jobId: string;
1653
+ path: string;
1654
+ kind: string;
1655
+ bytes?: number;
1656
+ hash?: string;
1657
+ producedAt?: number;
1658
+ metadata?: JsonObject;
1659
+ }
1660
+ export interface FrontierSwarmArtifactIndex {
1661
+ kind: typeof FRONTIER_SWARM_ARTIFACT_INDEX_KIND;
1662
+ version: typeof FRONTIER_SWARM_ARTIFACT_INDEX_VERSION;
1663
+ id: string;
1664
+ generatedAt: number;
1665
+ artifacts: FrontierSwarmArtifact[];
1666
+ byJobId: Record<string, FrontierSwarmArtifact[]>;
1667
+ byKind: Record<string, FrontierSwarmArtifact[]>;
1668
+ summary: {
1669
+ artifactCount: number;
1670
+ jobCount: number;
1671
+ kindCount: number;
1672
+ totalBytes: number;
1673
+ };
1674
+ }
1675
+ export interface FrontierSwarmReviewPlan {
1676
+ kind: typeof FRONTIER_SWARM_REVIEW_PLAN_KIND;
1677
+ version: typeof FRONTIER_SWARM_REVIEW_PLAN_VERSION;
1678
+ id: string;
1679
+ planId: string;
1680
+ generatedAt: number;
1681
+ assignments: FrontierSwarmReviewAssignment[];
1682
+ summary: {
1683
+ assignmentCount: number;
1684
+ requiredCount: number;
1685
+ sampledCount: number;
1686
+ };
1687
+ }
1688
+ export interface FrontierSwarmReviewAssignment {
1689
+ jobId: string;
1690
+ taskId: string;
1691
+ reviewers: string[];
1692
+ required: boolean;
1693
+ reason: 'always-review' | 'sampled' | 'violations' | 'failed' | 'budget';
1694
+ }
1695
+ export interface FrontierSwarmMergePlan {
1696
+ kind: typeof FRONTIER_SWARM_MERGE_PLAN_KIND;
1697
+ version: typeof FRONTIER_SWARM_MERGE_PLAN_VERSION;
1698
+ id: string;
1699
+ planId: string;
1700
+ generatedAt: number;
1701
+ ready: string[];
1702
+ blocked: FrontierSwarmMergeBlocker[];
1703
+ groups: FrontierSwarmMergeGroup[];
1704
+ summary: {
1705
+ readyCount: number;
1706
+ blockedCount: number;
1707
+ groupCount: number;
1708
+ };
1709
+ }
1710
+ export interface FrontierSwarmMergeBlocker {
1711
+ jobId: string;
1712
+ reasons: string[];
1713
+ conflictingJobIds: string[];
1714
+ }
1715
+ export interface FrontierSwarmMergeGroup {
1716
+ id: string;
1717
+ jobIds: string[];
1718
+ changedPaths: string[];
1719
+ }
1720
+ export interface FrontierSwarmDecomposeInput {
1721
+ featureId: string;
1722
+ objective: string;
1723
+ lanes: readonly string[];
1724
+ files?: readonly string[];
1725
+ checks?: readonly (string | FrontierSwarmCommandInput)[];
1726
+ reviewers?: readonly string[];
1727
+ metadata?: unknown;
1728
+ }
1729
+ export interface FrontierSwarmRunInput {
1730
+ id?: string;
1731
+ plan: FrontierSwarmPlan;
1732
+ startedAt?: number;
1733
+ status?: FrontierSwarmJobStatus;
1734
+ events?: readonly FrontierSwarmEventInput[];
1735
+ results?: readonly FrontierSwarmJobResultInput[];
1736
+ metadata?: unknown;
1737
+ }
1738
+ export interface FrontierSwarmRun {
1739
+ kind: typeof FRONTIER_SWARM_RUN_KIND;
1740
+ version: typeof FRONTIER_SWARM_RUN_VERSION;
1741
+ id: string;
1742
+ planId: string;
1743
+ manifestId: string;
1744
+ startedAt: number;
1745
+ finishedAt?: number;
1746
+ status: FrontierSwarmJobStatus;
1747
+ jobs: FrontierSwarmJob[];
1748
+ events: FrontierSwarmEvent[];
1749
+ results: FrontierSwarmJobResult[];
1750
+ summary: FrontierSwarmSummary;
1751
+ metadata?: JsonObject;
1752
+ }
1753
+ export interface FrontierSwarmRunEventAdapterOptions {
1754
+ runId?: string;
1755
+ actorId?: FrontierRunActorId;
1756
+ startActorSeq?: number;
1757
+ parents?: readonly FrontierRunEventId[];
1758
+ time?: string;
1759
+ now?: number;
1760
+ metadata?: unknown;
1761
+ }
1762
+ export interface FrontierSwarmRunProjectionOptions {
1763
+ runId?: string;
1764
+ goal?: string;
1765
+ metadata?: unknown;
1766
+ }
1767
+ export interface FrontierSwarmEventInput {
1768
+ id?: string;
1769
+ type: string;
1770
+ runId?: string;
1771
+ jobId?: string;
1772
+ taskId?: string;
1773
+ lane?: string;
1774
+ layer?: string;
1775
+ compute?: string;
1776
+ at?: number;
1777
+ message?: string;
1778
+ data?: unknown;
1779
+ metadata?: unknown;
1780
+ }
1781
+ export interface FrontierSwarmEvent {
1782
+ kind: typeof FRONTIER_SWARM_EVENT_KIND;
1783
+ version: typeof FRONTIER_SWARM_EVENT_VERSION;
1784
+ id: string;
1785
+ type: string;
1786
+ runId?: string;
1787
+ jobId?: string;
1788
+ taskId?: string;
1789
+ lane?: string;
1790
+ layer?: string;
1791
+ compute?: string;
1792
+ at: number;
1793
+ message?: string;
1794
+ data?: JsonValue;
1795
+ metadata?: JsonObject;
1796
+ }
1797
+ export type FrontierSwarmMailboxScope = 'global' | 'lane' | 'job' | string;
1798
+ export interface FrontierSwarmMailboxInput {
1799
+ id?: string;
1800
+ runId?: string;
1801
+ scope?: FrontierSwarmMailboxScope;
1802
+ lane?: string;
1803
+ jobId?: string;
1804
+ path?: string;
1805
+ eventTypes?: readonly string[];
1806
+ appendOnly?: boolean;
1807
+ metadata?: unknown;
1808
+ }
1809
+ export interface FrontierSwarmMailbox {
1810
+ kind: typeof FRONTIER_SWARM_MAILBOX_KIND;
1811
+ version: typeof FRONTIER_SWARM_MAILBOX_VERSION;
1812
+ id: string;
1813
+ runId?: string;
1814
+ scope: FrontierSwarmMailboxScope;
1815
+ lane?: string;
1816
+ jobId?: string;
1817
+ path?: string;
1818
+ eventTypes: string[];
1819
+ appendOnly: boolean;
1820
+ metadata?: JsonObject;
1821
+ }
1822
+ export interface FrontierSwarmEventStreamInput {
1823
+ id?: string;
1824
+ runId?: string;
1825
+ root?: string;
1826
+ lanes?: readonly (string | FrontierSwarmLaneInput | FrontierSwarmLane)[];
1827
+ eventTypes?: readonly string[];
1828
+ appendOnly?: boolean;
1829
+ metadata?: unknown;
1830
+ }
1831
+ export interface FrontierSwarmEventStream {
1832
+ kind: typeof FRONTIER_SWARM_EVENT_STREAM_KIND;
1833
+ version: typeof FRONTIER_SWARM_EVENT_STREAM_VERSION;
1834
+ id: string;
1835
+ runId?: string;
1836
+ root?: string;
1837
+ appendOnly: boolean;
1838
+ global: FrontierSwarmMailbox;
1839
+ lanes: Record<string, FrontierSwarmMailbox>;
1840
+ eventTypes: string[];
1841
+ metadata?: JsonObject;
1842
+ summary: {
1843
+ mailboxCount: number;
1844
+ laneCount: number;
1845
+ eventTypeCount: number;
1846
+ };
1847
+ }
1848
+ export interface FrontierSwarmJobResultInput {
1849
+ jobId: string;
1850
+ status?: FrontierSwarmJobStatus;
1851
+ mergeReadiness?: FrontierSwarmMergeReadiness;
1852
+ startedAt?: number;
1853
+ finishedAt?: number;
1854
+ exitCode?: number;
1855
+ signal?: string;
1856
+ changedPaths?: readonly string[];
1857
+ changedRegions?: readonly string[];
1858
+ ownershipViolations?: readonly string[];
1859
+ evidencePaths?: readonly string[];
1860
+ patchPath?: string;
1861
+ queueItemIds?: readonly string[];
1862
+ riskLevel?: FrontierSwarmRiskLevel;
1863
+ mergeDisposition?: FrontierSwarmMergeDisposition;
1864
+ verification?: readonly FrontierSwarmVerificationResultInput[];
1865
+ semanticImport?: FrontierSwarmSemanticImportSummary;
1866
+ traceShards?: readonly JsonValue[];
1867
+ lastMessage?: string;
1868
+ error?: unknown;
1869
+ metadata?: unknown;
1870
+ }
1871
+ export interface FrontierSwarmVerificationResultInput {
1872
+ name?: string;
1873
+ command?: readonly string[];
1874
+ commandLine?: string;
1875
+ cwd?: string;
1876
+ status?: number;
1877
+ durationMs?: number;
1878
+ stdoutTail?: readonly string[];
1879
+ stderrTail?: readonly string[];
1880
+ required?: boolean;
1881
+ category?: FrontierSwarmVerificationCategory;
1882
+ metadata?: unknown;
1883
+ }
1884
+ export interface FrontierSwarmVerificationResult {
1885
+ name: string;
1886
+ command: string[];
1887
+ commandLine?: string;
1888
+ cwd?: string;
1889
+ status?: number;
1890
+ durationMs?: number;
1891
+ stdoutTail: string[];
1892
+ stderrTail: string[];
1893
+ required: boolean;
1894
+ category?: FrontierSwarmVerificationCategory;
1895
+ metadata?: JsonObject;
1896
+ }
1897
+ export interface FrontierSwarmSemanticImportSummary {
1898
+ total: number;
1899
+ candidates?: number;
1900
+ selected: number;
1901
+ eligible?: number;
1902
+ imported: number;
1903
+ errors: number;
1904
+ selection?: unknown;
1905
+ omitted?: unknown;
1906
+ maxFiles?: number;
1907
+ skipped?: unknown;
1908
+ sourceMapMappingCount: number;
1909
+ readiness?: Record<string, unknown>;
1910
+ lossesBySeverity?: Record<string, unknown>;
1911
+ semanticIndex?: {
1912
+ symbols?: number;
1913
+ [key: string]: unknown;
1914
+ };
1915
+ semanticSidecars?: {
1916
+ ownershipRegions?: number;
1917
+ patchHints?: number;
1918
+ [key: string]: unknown;
1919
+ };
1920
+ semanticChanges?: readonly FrontierSwarmSemanticChange[];
1921
+ mergeCandidates?: readonly FrontierSwarmMergeCandidate[];
1922
+ dependencies?: unknown;
1923
+ semanticEditScripts?: unknown;
1924
+ semanticEditProjection?: unknown;
1925
+ semanticEditReplay?: unknown;
1926
+ [key: string]: unknown;
1927
+ }
1928
+ export interface FrontierSwarmJobResult {
1929
+ jobId: string;
1930
+ status: FrontierSwarmJobStatus;
1931
+ mergeReadiness: FrontierSwarmMergeReadiness;
1932
+ startedAt?: number;
1933
+ finishedAt?: number;
1934
+ durationMs?: number;
1935
+ exitCode?: number;
1936
+ signal?: string;
1937
+ changedPaths: string[];
1938
+ changedRegions: string[];
1939
+ ownershipViolations: string[];
1940
+ evidencePaths: string[];
1941
+ patchPath?: string;
1942
+ queueItemIds: string[];
1943
+ riskLevel: FrontierSwarmRiskLevel;
1944
+ mergeDisposition: FrontierSwarmMergeDisposition;
1945
+ verification: FrontierSwarmVerificationResult[];
1946
+ semanticImport?: FrontierSwarmSemanticImportSummary;
1947
+ traceShards?: JsonValue[];
1948
+ lastMessage?: string;
1949
+ error?: string;
1950
+ metadata?: JsonObject;
1951
+ }
1952
+ export interface FrontierSwarmOwnershipReport {
1953
+ ok: boolean;
1954
+ changedPaths: string[];
1955
+ allowedWrites: string[];
1956
+ violations: string[];
1957
+ }
1958
+ export interface FrontierSwarmMergeBundleInput {
1959
+ id?: string;
1960
+ runId?: string;
1961
+ planId?: string;
1962
+ job?: FrontierSwarmJob;
1963
+ result: FrontierSwarmJobResult | FrontierSwarmJobResultInput;
1964
+ patchPath?: string;
1965
+ patchHash?: string;
1966
+ evidencePaths?: readonly string[];
1967
+ queueItemIds?: readonly string[];
1968
+ riskLevel?: FrontierSwarmRiskLevel;
1969
+ disposition?: FrontierSwarmMergeDisposition;
1970
+ staleAgainstHead?: boolean;
1971
+ branchName?: string;
1972
+ commit?: string;
1973
+ semanticImport?: FrontierSwarmSemanticImportSummary;
1974
+ traceShards?: readonly JsonValue[];
1975
+ metadata?: unknown;
1976
+ generatedAt?: number;
1977
+ }
1978
+ export interface FrontierSwarmMergeBundle {
1979
+ kind: typeof FRONTIER_SWARM_MERGE_BUNDLE_KIND;
1980
+ version: typeof FRONTIER_SWARM_MERGE_BUNDLE_VERSION;
1981
+ id: string;
1982
+ runId?: string;
1983
+ planId?: string;
1984
+ jobId: string;
1985
+ taskId?: string;
1986
+ lane?: string;
1987
+ title?: string;
1988
+ generatedAt: number;
1989
+ status: FrontierSwarmJobStatus;
1990
+ mergeReadiness: FrontierSwarmMergeReadiness;
1991
+ disposition: FrontierSwarmMergeDisposition;
1992
+ riskLevel: FrontierSwarmRiskLevel;
1993
+ autoMergeable: boolean;
1994
+ changedPaths: string[];
1995
+ changedRegions: string[];
1996
+ ownedFilesTouched: string[];
1997
+ allowedWrites: string[];
1998
+ ownershipViolations: string[];
1999
+ patchPath?: string;
2000
+ patchHash?: string;
2001
+ evidencePaths: string[];
2002
+ commandsPassed: FrontierSwarmVerificationResult[];
2003
+ commandsFailed: FrontierSwarmVerificationResult[];
2004
+ queueItemIds: string[];
2005
+ semanticImport?: FrontierSwarmSemanticImportSummary;
2006
+ traceShards?: JsonValue[];
2007
+ branchName?: string;
2008
+ commit?: string;
2009
+ staleAgainstHead: boolean;
2010
+ reasons: string[];
2011
+ metadata?: JsonObject;
2012
+ }
2013
+ export interface FrontierSwarmQueueOverlayInput {
2014
+ id?: string;
2015
+ runId?: string;
2016
+ bundles?: readonly FrontierSwarmMergeBundle[];
2017
+ results?: readonly (FrontierSwarmJobResult | FrontierSwarmJobResultInput)[];
2018
+ generatedAt?: number;
2019
+ metadata?: unknown;
2020
+ }
2021
+ export interface FrontierSwarmQueueOverlay {
2022
+ kind: typeof FRONTIER_SWARM_QUEUE_OVERLAY_KIND;
2023
+ version: typeof FRONTIER_SWARM_QUEUE_OVERLAY_VERSION;
2024
+ id: string;
2025
+ runId?: string;
2026
+ generatedAt: number;
2027
+ entries: FrontierSwarmQueueOverlayEntry[];
2028
+ byQueueItemId: Record<string, FrontierSwarmQueueOverlayEntry[]>;
2029
+ summary: {
2030
+ entryCount: number;
2031
+ queueItemCount: number;
2032
+ readyToApplyCount: number;
2033
+ needsHumanPortCount: number;
2034
+ failedEvidenceCount: number;
2035
+ staleAgainstHeadCount: number;
2036
+ discoveryOnlyCount: number;
2037
+ };
2038
+ metadata?: JsonObject;
2039
+ }
2040
+ export interface FrontierSwarmQueueOverlayEntry {
2041
+ queueItemId: string;
2042
+ jobId: string;
2043
+ status: FrontierSwarmQueueOverlayStatus;
2044
+ mergeReadiness: FrontierSwarmMergeReadiness;
2045
+ disposition: FrontierSwarmMergeDisposition;
2046
+ riskLevel: FrontierSwarmRiskLevel;
2047
+ patchPath?: string;
2048
+ evidencePaths: string[];
2049
+ changedPaths: string[];
2050
+ changedRegions: string[];
2051
+ reasons: string[];
2052
+ generatedAt: number;
2053
+ }
2054
+ export interface FrontierSwarmDerivedQueueStatusInput {
2055
+ snapshot: FrontierSwarmQueueSnapshot;
2056
+ overlays?: readonly FrontierSwarmQueueOverlay[];
2057
+ generatedAt?: number;
2058
+ }
2059
+ export interface FrontierSwarmDerivedQueueStatus {
2060
+ generatedAt: number;
2061
+ jobs: FrontierSwarmQueueJob[];
2062
+ byStatus: Record<string, string[]>;
2063
+ summary: FrontierSwarmQueueSnapshot['summary'];
2064
+ }
2065
+ export interface FrontierSwarmMergeIndexInput {
2066
+ id?: string;
2067
+ runId?: string;
2068
+ planId?: string;
2069
+ bundles: readonly FrontierSwarmMergeBundle[];
2070
+ patchStatuses?: Record<string, FrontierSwarmPatchStatus>;
2071
+ generatedAt?: number;
2072
+ metadata?: unknown;
2073
+ }
2074
+ export interface FrontierSwarmMergeIndex {
2075
+ kind: typeof FRONTIER_SWARM_MERGE_INDEX_KIND;
2076
+ version: typeof FRONTIER_SWARM_MERGE_INDEX_VERSION;
2077
+ id: string;
2078
+ runId?: string;
2079
+ planId?: string;
2080
+ generatedAt: number;
2081
+ entries: FrontierSwarmMergeIndexEntry[];
2082
+ conflicts: FrontierSwarmMergeConflict[];
2083
+ byDisposition: Record<string, string[]>;
2084
+ byPath: Record<string, string[]>;
2085
+ byRegion: Record<string, string[]>;
2086
+ summary: {
2087
+ entryCount: number;
2088
+ readyToApplyCount: number;
2089
+ needsHumanPortCount: number;
2090
+ failedEvidenceCount: number;
2091
+ staleAgainstHeadCount: number;
2092
+ discoveryOnlyCount: number;
2093
+ conflictCount: number;
2094
+ conflictedJobCount: number;
2095
+ };
2096
+ metadata?: JsonObject;
2097
+ }
2098
+ export interface FrontierSwarmMergeIndexEntry {
2099
+ jobId: string;
2100
+ taskId?: string;
2101
+ lane?: string;
2102
+ title?: string;
2103
+ status: FrontierSwarmJobStatus;
2104
+ mergeReadiness: FrontierSwarmMergeReadiness;
2105
+ disposition: FrontierSwarmMergeDisposition;
2106
+ riskLevel: FrontierSwarmRiskLevel;
2107
+ patchStatus: FrontierSwarmPatchStatus;
2108
+ staleAgainstHead: boolean;
2109
+ autoMergeable: boolean;
2110
+ changedPaths: string[];
2111
+ changedRegions: string[];
2112
+ conflictKeys: string[];
2113
+ conflictingJobIds: string[];
2114
+ ownedFilesTouched: string[];
2115
+ ownershipViolations: string[];
2116
+ patchPath?: string;
2117
+ patchHash?: string;
2118
+ evidencePaths: string[];
2119
+ queueItemIds: string[];
2120
+ reasons: string[];
2121
+ generatedAt: number;
2122
+ metadata?: JsonObject;
2123
+ }
2124
+ export interface FrontierSwarmMergeConflict {
2125
+ jobIds: string[];
2126
+ key: string;
2127
+ kind: 'path' | 'region' | 'symbol' | 'public-contract';
2128
+ path?: string;
2129
+ region?: string;
2130
+ symbol?: string;
2131
+ publicContract?: string;
2132
+ }
2133
+ export interface FrontierSwarmRegionOwnershipInput {
2134
+ changedPaths?: readonly string[];
2135
+ changedRegions?: readonly string[];
2136
+ }
2137
+ export interface FrontierSwarmRegionOwnershipReport {
2138
+ ok: boolean;
2139
+ jobId: string;
2140
+ changedPaths: string[];
2141
+ changedRegions: string[];
2142
+ ownedRegions: string[];
2143
+ regionViolations: string[];
2144
+ unclassifiedChangedPaths: string[];
2145
+ }
2146
+ export interface FrontierSwarmHotspotReportInput {
2147
+ id?: string;
2148
+ bundles?: readonly FrontierSwarmMergeBundle[];
2149
+ results?: readonly (FrontierSwarmJobResult | FrontierSwarmJobResultInput)[];
2150
+ threshold?: number;
2151
+ generatedAt?: number;
2152
+ metadata?: unknown;
2153
+ }
2154
+ export interface FrontierSwarmHotspotReport {
2155
+ kind: typeof FRONTIER_SWARM_HOTSPOT_REPORT_KIND;
2156
+ version: typeof FRONTIER_SWARM_HOTSPOT_REPORT_VERSION;
2157
+ id: string;
2158
+ generatedAt: number;
2159
+ threshold: number;
2160
+ entries: FrontierSwarmHotspotEntry[];
2161
+ recommendations: FrontierSwarmHotspotRecommendation[];
2162
+ summary: {
2163
+ pathCount: number;
2164
+ hotspotCount: number;
2165
+ recommendationCount: number;
2166
+ };
2167
+ metadata?: JsonObject;
2168
+ }
2169
+ export interface FrontierSwarmHotspotEntry {
2170
+ path: string;
2171
+ touchCount: number;
2172
+ jobIds: string[];
2173
+ regions: string[];
2174
+ dispositions: string[];
2175
+ riskLevels: string[];
2176
+ }
2177
+ export interface FrontierSwarmHotspotRecommendation {
2178
+ path: string;
2179
+ reason: 'repeated-conflicts' | 'hot-file' | 'region-overlap';
2180
+ suggestedModuleId: string;
2181
+ suggestedOwnershipRegions: string[];
2182
+ jobIds: string[];
2183
+ }
2184
+ export interface FrontierSwarmReviewerLanePlanInput {
2185
+ id?: string;
2186
+ index: FrontierSwarmMergeIndex;
2187
+ admission?: FrontierSwarmMergeAdmission;
2188
+ reviewerLane?: string;
2189
+ reviewers?: readonly string[];
2190
+ includeAutoMergeable?: boolean;
2191
+ generatedAt?: number;
2192
+ metadata?: unknown;
2193
+ }
2194
+ export interface FrontierSwarmReviewerLanePlan {
2195
+ kind: typeof FRONTIER_SWARM_REVIEWER_LANE_PLAN_KIND;
2196
+ version: typeof FRONTIER_SWARM_REVIEWER_LANE_PLAN_VERSION;
2197
+ id: string;
2198
+ mergeIndexId: string;
2199
+ generatedAt: number;
2200
+ reviewerLane: string;
2201
+ assignments: FrontierSwarmReviewerLaneAssignment[];
2202
+ tasks: FrontierSwarmTaskInput[];
2203
+ summary: {
2204
+ assignmentCount: number;
2205
+ taskCount: number;
2206
+ };
2207
+ metadata?: JsonObject;
2208
+ }
2209
+ export interface FrontierSwarmReviewerLaneAssignment {
2210
+ jobId: string;
2211
+ reviewers: string[];
2212
+ required: boolean;
2213
+ reasons: string[];
2214
+ }
2215
+ export interface FrontierSwarmRunStoreShardsInput {
2216
+ id?: string;
2217
+ run?: FrontierSwarmRun;
2218
+ plan?: FrontierSwarmPlan;
2219
+ root?: string;
2220
+ shardSize?: number;
2221
+ groupBy?: 'lane' | 'hash' | 'none';
2222
+ generatedAt?: number;
2223
+ metadata?: unknown;
2224
+ }
2225
+ export interface FrontierSwarmRunStoreShards {
2226
+ kind: typeof FRONTIER_SWARM_RUN_STORE_SHARDS_KIND;
2227
+ version: typeof FRONTIER_SWARM_RUN_STORE_SHARDS_VERSION;
2228
+ id: string;
2229
+ runId?: string;
2230
+ planId?: string;
2231
+ root: string;
2232
+ generatedAt: number;
2233
+ groupBy: 'lane' | 'hash' | 'none';
2234
+ shardSize: number;
2235
+ shards: FrontierSwarmRunStoreShard[];
2236
+ summary: {
2237
+ shardCount: number;
2238
+ jobCount: number;
2239
+ };
2240
+ metadata?: JsonObject;
2241
+ }
2242
+ export interface FrontierSwarmRunStoreShard {
2243
+ id: string;
2244
+ lane?: string;
2245
+ path: string;
2246
+ eventPath: string;
2247
+ resultPath: string;
2248
+ checkpointPath: string;
2249
+ jobIds: string[];
2250
+ }
2251
+ export interface FrontierSwarmMergeAdmissionInput {
2252
+ id?: string;
2253
+ index: FrontierSwarmMergeIndex;
2254
+ maxReady?: number;
2255
+ maxChangedPaths?: number;
2256
+ maxChangedRegions?: number;
2257
+ maxHighRisk?: number;
2258
+ allowRisks?: readonly FrontierSwarmRiskLevel[];
2259
+ generatedAt?: number;
2260
+ metadata?: unknown;
2261
+ }
2262
+ export interface FrontierSwarmMergeAdmission {
2263
+ kind: typeof FRONTIER_SWARM_MERGE_ADMISSION_KIND;
2264
+ version: typeof FRONTIER_SWARM_MERGE_ADMISSION_VERSION;
2265
+ id: string;
2266
+ mergeIndexId: string;
2267
+ generatedAt: number;
2268
+ admitted: string[];
2269
+ deferred: FrontierSwarmMergeAdmissionDeferral[];
2270
+ budget: {
2271
+ maxReady: number;
2272
+ maxChangedPaths?: number;
2273
+ maxChangedRegions?: number;
2274
+ maxHighRisk?: number;
2275
+ allowRisks: string[];
2276
+ };
2277
+ summary: {
2278
+ admittedCount: number;
2279
+ deferredCount: number;
2280
+ changedPathCount: number;
2281
+ changedRegionCount: number;
2282
+ highRiskCount: number;
2283
+ };
2284
+ metadata?: JsonObject;
2285
+ }
2286
+ export interface FrontierSwarmMergeAdmissionDeferral {
2287
+ jobId: string;
2288
+ reasons: string[];
2289
+ }
2290
+ export interface FrontierSwarmContextPackInput {
2291
+ id?: string;
2292
+ job?: FrontierSwarmJob;
2293
+ task?: FrontierSwarmTask | FrontierSwarmTaskInput;
2294
+ title?: string;
2295
+ files?: readonly string[];
2296
+ apiMap?: Record<string, readonly string[]>;
2297
+ knownFailures?: readonly string[];
2298
+ commands?: readonly (string | FrontierSwarmCommandInput)[];
2299
+ oracleCommands?: readonly (string | FrontierSwarmCommandInput)[];
2300
+ evidenceSchema?: unknown;
2301
+ expectedEvidence?: readonly string[];
2302
+ exclusions?: readonly string[];
2303
+ avoidInvestigating?: readonly string[];
2304
+ playbookIds?: readonly string[];
2305
+ generatedAt?: number;
2306
+ metadata?: unknown;
2307
+ }
2308
+ export interface FrontierSwarmContextPack {
2309
+ kind: typeof FRONTIER_SWARM_CONTEXT_PACK_KIND;
2310
+ version: typeof FRONTIER_SWARM_CONTEXT_PACK_VERSION;
2311
+ id: string;
2312
+ jobId?: string;
2313
+ taskId?: string;
2314
+ lane?: string;
2315
+ title: string;
2316
+ generatedAt: number;
2317
+ files: string[];
2318
+ apiMap: Record<string, string[]>;
2319
+ knownFailures: string[];
2320
+ commands: FrontierSwarmCommand[];
2321
+ oracleCommands: FrontierSwarmCommand[];
2322
+ evidenceSchema?: JsonValue;
2323
+ expectedEvidence: string[];
2324
+ exclusions: string[];
2325
+ avoidInvestigating: string[];
2326
+ playbookIds: string[];
2327
+ metadata?: JsonObject;
2328
+ }
2329
+ export interface FrontierSwarmOracleArtifactInput {
2330
+ id: string;
2331
+ path: string;
2332
+ kind?: string;
2333
+ command?: string | FrontierSwarmCommandInput;
2334
+ hash?: string;
2335
+ sourceRef?: string;
2336
+ tags?: readonly string[];
2337
+ metadata?: unknown;
2338
+ }
2339
+ export interface FrontierSwarmOracleArtifact {
2340
+ id: string;
2341
+ path: string;
2342
+ kind: string;
2343
+ command?: FrontierSwarmCommand;
2344
+ hash?: string;
2345
+ sourceRef?: string;
2346
+ tags: string[];
2347
+ metadata?: JsonObject;
2348
+ }
2349
+ export interface FrontierSwarmOracleCorpusInput {
2350
+ id?: string;
2351
+ title?: string;
2352
+ artifacts?: readonly FrontierSwarmOracleArtifactInput[];
2353
+ generatedAt?: number;
2354
+ metadata?: unknown;
2355
+ }
2356
+ export interface FrontierSwarmOracleCorpus {
2357
+ kind: typeof FRONTIER_SWARM_ORACLE_CORPUS_KIND;
2358
+ version: typeof FRONTIER_SWARM_ORACLE_CORPUS_VERSION;
2359
+ id: string;
2360
+ title: string;
2361
+ generatedAt: number;
2362
+ artifacts: FrontierSwarmOracleArtifact[];
2363
+ byKind: Record<string, string[]>;
2364
+ byTag: Record<string, string[]>;
2365
+ summary: {
2366
+ artifactCount: number;
2367
+ kindCount: number;
2368
+ tagCount: number;
2369
+ };
2370
+ metadata?: JsonObject;
2371
+ }
2372
+ export interface FrontierSwarmNamedRefInput {
2373
+ id?: string;
2374
+ path?: string;
2375
+ uri?: string;
2376
+ kind?: string;
2377
+ role?: string;
2378
+ hash?: string;
2379
+ bytes?: number;
2380
+ tags?: readonly string[];
2381
+ metadata?: unknown;
2382
+ }
2383
+ export interface FrontierSwarmNamedRef {
2384
+ id: string;
2385
+ kind: string;
2386
+ path?: string;
2387
+ uri?: string;
2388
+ role?: string;
2389
+ hash?: string;
2390
+ bytes?: number;
2391
+ tags: string[];
2392
+ metadata?: JsonObject;
2393
+ }
2394
+ export interface FrontierSwarmObservabilityPointInput {
2395
+ id?: string;
2396
+ subject?: string;
2397
+ scope?: string;
2398
+ operationIndex?: number;
2399
+ at?: number;
2400
+ path?: string;
2401
+ selector?: string;
2402
+ before?: unknown;
2403
+ after?: unknown;
2404
+ eventRefs?: readonly (string | FrontierSwarmNamedRefInput)[];
2405
+ metadata?: unknown;
2406
+ }
2407
+ export interface FrontierSwarmObservabilityPoint {
2408
+ kind: typeof FRONTIER_SWARM_OBSERVABILITY_POINT_KIND;
2409
+ version: typeof FRONTIER_SWARM_OBSERVABILITY_POINT_VERSION;
2410
+ id: string;
2411
+ subject?: string;
2412
+ scope?: string;
2413
+ operationIndex?: number;
2414
+ at?: number;
2415
+ path?: string;
2416
+ selector?: string;
2417
+ before?: JsonValue;
2418
+ after?: JsonValue;
2419
+ eventRefs: FrontierSwarmNamedRef[];
2420
+ metadata?: JsonObject;
2421
+ }
2422
+ export interface FrontierSwarmReplayBundleInput {
2423
+ id?: string;
2424
+ title?: string;
2425
+ subject?: string;
2426
+ commands?: readonly (string | FrontierSwarmCommandInput)[];
2427
+ inputs?: readonly FrontierSwarmNamedRefInput[];
2428
+ artifacts?: readonly FrontierSwarmNamedRefInput[];
2429
+ sourceRefs?: readonly (string | FrontierSwarmNamedRefInput)[];
2430
+ seeds?: readonly (string | number | FrontierSwarmNamedRefInput)[];
2431
+ environment?: unknown;
2432
+ expectedEvidence?: readonly string[];
2433
+ generatedAt?: number;
2434
+ metadata?: unknown;
2435
+ }
2436
+ export interface FrontierSwarmReplayBundle {
2437
+ kind: typeof FRONTIER_SWARM_REPLAY_BUNDLE_KIND;
2438
+ version: typeof FRONTIER_SWARM_REPLAY_BUNDLE_VERSION;
2439
+ id: string;
2440
+ title: string;
2441
+ subject?: string;
2442
+ generatedAt: number;
2443
+ commands: FrontierSwarmCommand[];
2444
+ inputs: FrontierSwarmNamedRef[];
2445
+ artifacts: FrontierSwarmNamedRef[];
2446
+ sourceRefs: FrontierSwarmNamedRef[];
2447
+ seeds: FrontierSwarmNamedRef[];
2448
+ environment?: JsonObject;
2449
+ expectedEvidence: string[];
2450
+ summary: {
2451
+ commandCount: number;
2452
+ inputCount: number;
2453
+ artifactCount: number;
2454
+ sourceRefCount: number;
2455
+ };
2456
+ metadata?: JsonObject;
2457
+ }
2458
+ export interface FrontierSwarmParityComparatorInput {
2459
+ id?: string;
2460
+ title?: string;
2461
+ status?: FrontierSwarmParityOracleStatus;
2462
+ expected?: unknown;
2463
+ actual?: unknown;
2464
+ path?: string;
2465
+ operationIndex?: number;
2466
+ evidenceRefs?: readonly (string | FrontierSwarmNamedRefInput)[];
2467
+ metadata?: unknown;
2468
+ }
2469
+ export interface FrontierSwarmParityComparator {
2470
+ id: string;
2471
+ title: string;
2472
+ status: FrontierSwarmParityOracleStatus;
2473
+ expected?: JsonValue;
2474
+ actual?: JsonValue;
2475
+ path?: string;
2476
+ operationIndex?: number;
2477
+ evidenceRefs: FrontierSwarmNamedRef[];
2478
+ metadata?: JsonObject;
2479
+ }
2480
+ export interface FrontierSwarmParityOracleInput {
2481
+ id?: string;
2482
+ title?: string;
2483
+ status?: FrontierSwarmParityOracleStatus;
2484
+ subject?: string;
2485
+ referenceCommands?: readonly (string | FrontierSwarmCommandInput)[];
2486
+ testCommands?: readonly (string | FrontierSwarmCommandInput)[];
2487
+ comparators?: readonly FrontierSwarmParityComparatorInput[];
2488
+ artifacts?: readonly FrontierSwarmNamedRefInput[];
2489
+ replayBundleIds?: readonly string[];
2490
+ generatedAt?: number;
2491
+ metadata?: unknown;
2492
+ }
2493
+ export interface FrontierSwarmParityOracle {
2494
+ kind: typeof FRONTIER_SWARM_PARITY_ORACLE_KIND;
2495
+ version: typeof FRONTIER_SWARM_PARITY_ORACLE_VERSION;
2496
+ id: string;
2497
+ title: string;
2498
+ status: FrontierSwarmParityOracleStatus;
2499
+ subject?: string;
2500
+ generatedAt: number;
2501
+ referenceCommands: FrontierSwarmCommand[];
2502
+ testCommands: FrontierSwarmCommand[];
2503
+ comparators: FrontierSwarmParityComparator[];
2504
+ artifacts: FrontierSwarmNamedRef[];
2505
+ replayBundleIds: string[];
2506
+ summary: {
2507
+ comparatorCount: number;
2508
+ passedCount: number;
2509
+ failedCount: number;
2510
+ blockedCount: number;
2511
+ };
2512
+ metadata?: JsonObject;
2513
+ }
2514
+ export interface FrontierSwarmDivergenceReportInput {
2515
+ id?: string;
2516
+ title?: string;
2517
+ status?: FrontierSwarmParityOracleStatus;
2518
+ severity?: FrontierSwarmDivergenceSeverity;
2519
+ subject?: string;
2520
+ confidence?: FrontierSwarmConfidence;
2521
+ divergesAt?: string;
2522
+ operationIndex?: number;
2523
+ expected?: unknown;
2524
+ actual?: unknown;
2525
+ observabilityPoints?: readonly (FrontierSwarmObservabilityPoint | FrontierSwarmObservabilityPointInput)[];
2526
+ traceRefs?: readonly (string | FrontierSwarmNamedRefInput)[];
2527
+ replayBundleIds?: readonly string[];
2528
+ evidenceRefs?: readonly (string | FrontierSwarmNamedRefInput)[];
2529
+ generatedAt?: number;
2530
+ metadata?: unknown;
2531
+ }
2532
+ export interface FrontierSwarmDivergenceReport {
2533
+ kind: typeof FRONTIER_SWARM_DIVERGENCE_REPORT_KIND;
2534
+ version: typeof FRONTIER_SWARM_DIVERGENCE_REPORT_VERSION;
2535
+ id: string;
2536
+ title: string;
2537
+ status: FrontierSwarmParityOracleStatus;
2538
+ severity: FrontierSwarmDivergenceSeverity;
2539
+ subject?: string;
2540
+ confidence: FrontierSwarmConfidence;
2541
+ divergesAt?: string;
2542
+ operationIndex?: number;
2543
+ expected?: JsonValue;
2544
+ actual?: JsonValue;
2545
+ observabilityPoints: FrontierSwarmObservabilityPoint[];
2546
+ traceRefs: FrontierSwarmNamedRef[];
2547
+ replayBundleIds: string[];
2548
+ evidenceRefs: FrontierSwarmNamedRef[];
2549
+ generatedAt: number;
2550
+ metadata?: JsonObject;
2551
+ }
2552
+ export interface FrontierSwarmWatchpointInput {
2553
+ id?: string;
2554
+ title?: string;
2555
+ target?: string;
2556
+ path?: string;
2557
+ selector?: string;
2558
+ operator?: string;
2559
+ value?: unknown;
2560
+ action?: FrontierSwarmWatchpointAction;
2561
+ metadata?: unknown;
2562
+ }
2563
+ export interface FrontierSwarmWatchpoint {
2564
+ id: string;
2565
+ title: string;
2566
+ target?: string;
2567
+ path?: string;
2568
+ selector?: string;
2569
+ operator: string;
2570
+ value?: JsonValue;
2571
+ action: FrontierSwarmWatchpointAction;
2572
+ metadata?: JsonObject;
2573
+ }
2574
+ export interface FrontierSwarmWatchpointPlanInput {
2575
+ id?: string;
2576
+ title?: string;
2577
+ subject?: string;
2578
+ matchMode?: 'all' | 'any' | string;
2579
+ watchpoints?: readonly FrontierSwarmWatchpointInput[];
2580
+ commands?: readonly (string | FrontierSwarmCommandInput)[];
2581
+ replayBundleIds?: readonly string[];
2582
+ divergenceReportIds?: readonly string[];
2583
+ generatedAt?: number;
2584
+ metadata?: unknown;
2585
+ }
2586
+ export interface FrontierSwarmWatchpointPlan {
2587
+ kind: typeof FRONTIER_SWARM_WATCHPOINT_PLAN_KIND;
2588
+ version: typeof FRONTIER_SWARM_WATCHPOINT_PLAN_VERSION;
2589
+ id: string;
2590
+ title: string;
2591
+ subject?: string;
2592
+ matchMode: string;
2593
+ generatedAt: number;
2594
+ watchpoints: FrontierSwarmWatchpoint[];
2595
+ commands: FrontierSwarmCommand[];
2596
+ replayBundleIds: string[];
2597
+ divergenceReportIds: string[];
2598
+ summary: {
2599
+ watchpointCount: number;
2600
+ commandCount: number;
2601
+ };
2602
+ metadata?: JsonObject;
2603
+ }
2604
+ export interface FrontierSwarmDebugHandoffInput {
2605
+ id?: string;
2606
+ title?: string;
2607
+ status?: 'ready' | 'needs-review' | 'blocked' | 'failed' | string;
2608
+ subject?: string;
2609
+ focus?: FrontierSwarmObservabilityPointInput | FrontierSwarmObservabilityPoint;
2610
+ replayBundleIds?: readonly string[];
2611
+ divergenceReportIds?: readonly string[];
2612
+ watchpointPlanIds?: readonly string[];
2613
+ commands?: readonly (string | FrontierSwarmCommandInput)[];
2614
+ files?: readonly FrontierSwarmNamedRefInput[];
2615
+ artifacts?: readonly FrontierSwarmNamedRefInput[];
2616
+ comparisons?: readonly FrontierSwarmParityComparatorInput[];
2617
+ environment?: unknown;
2618
+ generatedAt?: number;
2619
+ metadata?: unknown;
2620
+ }
2621
+ export interface FrontierSwarmDebugHandoff {
2622
+ kind: typeof FRONTIER_SWARM_DEBUG_HANDOFF_KIND;
2623
+ version: typeof FRONTIER_SWARM_DEBUG_HANDOFF_VERSION;
2624
+ id: string;
2625
+ title: string;
2626
+ status: string;
2627
+ subject?: string;
2628
+ focus?: FrontierSwarmObservabilityPoint;
2629
+ replayBundleIds: string[];
2630
+ divergenceReportIds: string[];
2631
+ watchpointPlanIds: string[];
2632
+ commands: FrontierSwarmCommand[];
2633
+ files: FrontierSwarmNamedRef[];
2634
+ artifacts: FrontierSwarmNamedRef[];
2635
+ comparisons: FrontierSwarmParityComparator[];
2636
+ environment?: JsonObject;
2637
+ generatedAt: number;
2638
+ metadata?: JsonObject;
2639
+ }
2640
+ export interface FrontierSwarmInstrumentationBudgetInput {
2641
+ id?: string;
2642
+ title?: string;
2643
+ lane?: string;
2644
+ maxEvents?: number;
2645
+ maxBytes?: number;
2646
+ maxDurationMs?: number;
2647
+ maxOverheadRatio?: number;
2648
+ captureKinds?: readonly string[];
2649
+ sampling?: {
2650
+ mode?: string;
2651
+ rate?: number;
2652
+ metadata?: unknown;
2653
+ };
2654
+ generatedAt?: number;
2655
+ metadata?: unknown;
2656
+ }
2657
+ export interface FrontierSwarmInstrumentationBudget {
2658
+ kind: typeof FRONTIER_SWARM_INSTRUMENTATION_BUDGET_KIND;
2659
+ version: typeof FRONTIER_SWARM_INSTRUMENTATION_BUDGET_VERSION;
2660
+ id: string;
2661
+ title: string;
2662
+ lane?: string;
2663
+ generatedAt: number;
2664
+ maxEvents?: number;
2665
+ maxBytes?: number;
2666
+ maxDurationMs?: number;
2667
+ maxOverheadRatio?: number;
2668
+ captureKinds: string[];
2669
+ sampling: {
2670
+ mode: string;
2671
+ rate?: number;
2672
+ metadata?: JsonObject;
2673
+ };
2674
+ metadata?: JsonObject;
2675
+ }
2676
+ export interface FrontierSwarmInstrumentationUsageInput {
2677
+ events?: number;
2678
+ bytes?: number;
2679
+ durationMs?: number;
2680
+ overheadRatio?: number;
2681
+ captureKinds?: readonly string[];
2682
+ metadata?: unknown;
2683
+ }
2684
+ export interface FrontierSwarmInstrumentationBudgetDecision {
2685
+ ok: boolean;
2686
+ budgetId: string;
2687
+ usage: {
2688
+ events: number;
2689
+ bytes: number;
2690
+ durationMs: number;
2691
+ overheadRatio: number;
2692
+ captureKinds: string[];
2693
+ metadata?: JsonObject;
2694
+ };
2695
+ violations: string[];
2696
+ }
2697
+ export interface FrontierSwarmBottleneckSource {
2698
+ jobId?: string;
2699
+ lane?: string;
2700
+ text?: string;
2701
+ status?: string;
2702
+ reasons?: readonly string[];
2703
+ verification?: readonly FrontierSwarmVerificationResultInput[];
2704
+ evidencePaths?: readonly string[];
2705
+ changedPaths?: readonly string[];
2706
+ metadata?: unknown;
2707
+ }
2708
+ export interface FrontierSwarmBottleneckClassification {
2709
+ kind: FrontierSwarmBottleneckKind;
2710
+ confidence: FrontierSwarmConfidence;
2711
+ reasons: string[];
2712
+ route: {
2713
+ lane?: string;
2714
+ workKind?: string;
2715
+ priority?: number;
2716
+ };
2717
+ }
2718
+ export interface FrontierSwarmBottleneckReportInput {
2719
+ id?: string;
2720
+ sources?: readonly (FrontierSwarmBottleneckSource | FrontierSwarmJobResultInput | FrontierSwarmMergeBundle)[];
2721
+ generatedAt?: number;
2722
+ metadata?: unknown;
2723
+ }
2724
+ export interface FrontierSwarmBottleneckReport {
2725
+ kind: typeof FRONTIER_SWARM_BOTTLENECK_REPORT_KIND;
2726
+ version: typeof FRONTIER_SWARM_BOTTLENECK_REPORT_VERSION;
2727
+ id: string;
2728
+ generatedAt: number;
2729
+ classifications: FrontierSwarmBottleneckClassification[];
2730
+ byKind: Record<string, FrontierSwarmBottleneckClassification[]>;
2731
+ summary: {
2732
+ sourceCount: number;
2733
+ kindCount: number;
2734
+ };
2735
+ metadata?: JsonObject;
2736
+ }
2737
+ export type FrontierSwarmEvidenceFacetValue = string | number | boolean;
2738
+ export interface FrontierSwarmEvidenceIndexEntryInput {
2739
+ id?: string;
2740
+ jobId?: string;
2741
+ queueItemId?: string;
2742
+ lane?: string;
2743
+ topic?: string;
2744
+ path?: string;
2745
+ kind?: string;
2746
+ status?: string;
2747
+ confidence?: number;
2748
+ tags?: readonly string[];
2749
+ facets?: Record<string, FrontierSwarmEvidenceFacetValue>;
2750
+ generatedAt?: number;
2751
+ metadata?: unknown;
2752
+ }
2753
+ export interface FrontierSwarmEvidenceIndexEntry {
2754
+ id: string;
2755
+ jobId?: string;
2756
+ queueItemId?: string;
2757
+ lane?: string;
2758
+ topic?: string;
2759
+ path?: string;
2760
+ kind: string;
2761
+ status: string;
2762
+ confidence: number;
2763
+ tags: string[];
2764
+ facets: Record<string, FrontierSwarmEvidenceFacetValue>;
2765
+ generatedAt: number;
2766
+ metadata?: JsonObject;
2767
+ }
2768
+ export interface FrontierSwarmEvidenceIndexInput {
2769
+ id?: string;
2770
+ run?: FrontierSwarmRun;
2771
+ entries?: readonly FrontierSwarmEvidenceIndexEntryInput[];
2772
+ generatedAt?: number;
2773
+ metadata?: unknown;
2774
+ }
2775
+ export interface FrontierSwarmEvidenceIndex {
2776
+ kind: typeof FRONTIER_SWARM_EVIDENCE_INDEX_KIND;
2777
+ version: typeof FRONTIER_SWARM_EVIDENCE_INDEX_VERSION;
2778
+ id: string;
2779
+ runId?: string;
2780
+ generatedAt: number;
2781
+ entries: FrontierSwarmEvidenceIndexEntry[];
2782
+ byJobId: Record<string, FrontierSwarmEvidenceIndexEntry[]>;
2783
+ byTopic: Record<string, FrontierSwarmEvidenceIndexEntry[]>;
2784
+ byPath: Record<string, FrontierSwarmEvidenceIndexEntry[]>;
2785
+ summary: {
2786
+ entryCount: number;
2787
+ jobCount: number;
2788
+ topicCount: number;
2789
+ pathCount: number;
2790
+ };
2791
+ metadata?: JsonObject;
2792
+ }
2793
+ export interface FrontierSwarmEvidenceIndexQuery {
2794
+ jobId?: string;
2795
+ lane?: string;
2796
+ topic?: string;
2797
+ pathIncludes?: string;
2798
+ kind?: string;
2799
+ status?: string;
2800
+ tag?: string;
2801
+ minConfidence?: number;
2802
+ facet?: Record<string, FrontierSwarmEvidenceFacetValue>;
2803
+ }
2804
+ export interface FrontierSwarmEvidenceIndexQueryResult {
2805
+ entries: FrontierSwarmEvidenceIndexEntry[];
2806
+ summary: {
2807
+ entryCount: number;
2808
+ };
2809
+ }
2810
+ export interface FrontierSwarmBlackboardEntryInput {
2811
+ id?: string;
2812
+ kind?: FrontierSwarmBlackboardEntryKind;
2813
+ topic?: string;
2814
+ status?: string;
2815
+ text?: string;
2816
+ lane?: string;
2817
+ jobId?: string;
2818
+ owner?: string;
2819
+ confidence?: FrontierSwarmConfidence;
2820
+ sourceIds?: readonly string[];
2821
+ paths?: readonly string[];
2822
+ tags?: readonly string[];
2823
+ supersedes?: readonly string[];
2824
+ generatedAt?: number;
2825
+ metadata?: unknown;
2826
+ }
2827
+ export interface FrontierSwarmBlackboardEntry {
2828
+ id: string;
2829
+ kind: FrontierSwarmBlackboardEntryKind;
2830
+ topic: string;
2831
+ status: string;
2832
+ text: string;
2833
+ lane?: string;
2834
+ jobId?: string;
2835
+ owner?: string;
2836
+ confidence: FrontierSwarmConfidence;
2837
+ sourceIds: string[];
2838
+ paths: string[];
2839
+ tags: string[];
2840
+ supersedes: string[];
2841
+ generatedAt: number;
2842
+ metadata?: JsonObject;
2843
+ }
2844
+ export interface FrontierSwarmBlackboardInput {
2845
+ id?: string;
2846
+ runId?: string;
2847
+ entries?: readonly FrontierSwarmBlackboardEntryInput[];
2848
+ generatedAt?: number;
2849
+ metadata?: unknown;
2850
+ }
2851
+ export interface FrontierSwarmBlackboard {
2852
+ kind: typeof FRONTIER_SWARM_BLACKBOARD_KIND;
2853
+ version: typeof FRONTIER_SWARM_BLACKBOARD_VERSION;
2854
+ id: string;
2855
+ runId?: string;
2856
+ generatedAt: number;
2857
+ entries: FrontierSwarmBlackboardEntry[];
2858
+ byTopic: Record<string, FrontierSwarmBlackboardEntry[]>;
2859
+ byKind: Record<string, FrontierSwarmBlackboardEntry[]>;
2860
+ summary: {
2861
+ entryCount: number;
2862
+ topicCount: number;
2863
+ kindCount: number;
2864
+ };
2865
+ metadata?: JsonObject;
2866
+ }
2867
+ export interface FrontierSwarmBlackboardQuery {
2868
+ kind?: FrontierSwarmBlackboardEntryKind;
2869
+ topic?: string;
2870
+ status?: string;
2871
+ lane?: string;
2872
+ jobId?: string;
2873
+ owner?: string;
2874
+ tag?: string;
2875
+ textIncludes?: string;
2876
+ }
2877
+ export interface FrontierSwarmBlackboardQueryResult {
2878
+ entries: FrontierSwarmBlackboardEntry[];
2879
+ summary: {
2880
+ entryCount: number;
2881
+ };
2882
+ }
2883
+ export interface FrontierSwarmReferenceOraclePlanInput {
2884
+ id?: string;
2885
+ serviceId?: string;
2886
+ subject?: string;
2887
+ fixtureId?: string;
2888
+ targets?: readonly {
2889
+ id: string;
2890
+ role?: string;
2891
+ command?: string | FrontierSwarmCommandInput;
2892
+ metadata?: unknown;
2893
+ }[];
2894
+ window?: {
2895
+ start?: number;
2896
+ end?: number;
2897
+ focus?: string;
2898
+ metadata?: unknown;
2899
+ };
2900
+ watchpoints?: readonly FrontierSwarmWatchpointInput[];
2901
+ artifactKinds?: readonly string[];
2902
+ generatedAt?: number;
2903
+ metadata?: unknown;
2904
+ }
2905
+ export interface FrontierSwarmReferenceOraclePlan {
2906
+ kind: typeof FRONTIER_SWARM_REFERENCE_ORACLE_PLAN_KIND;
2907
+ version: typeof FRONTIER_SWARM_REFERENCE_ORACLE_PLAN_VERSION;
2908
+ id: string;
2909
+ serviceId?: string;
2910
+ subject?: string;
2911
+ fixtureId?: string;
2912
+ generatedAt: number;
2913
+ targets: {
2914
+ id: string;
2915
+ role: string;
2916
+ command?: FrontierSwarmCommand;
2917
+ metadata?: JsonObject;
2918
+ }[];
2919
+ window?: {
2920
+ start?: number;
2921
+ end?: number;
2922
+ focus?: string;
2923
+ metadata?: JsonObject;
2924
+ };
2925
+ watchpoints: FrontierSwarmWatchpoint[];
2926
+ artifactKinds: string[];
2927
+ metadata?: JsonObject;
2928
+ }
2929
+ export interface FrontierSwarmReferenceOracleResponseInput {
2930
+ id?: string;
2931
+ planId?: string;
2932
+ status?: FrontierSwarmParityOracleStatus;
2933
+ subject?: string;
2934
+ targetResults?: readonly {
2935
+ targetId: string;
2936
+ status?: FrontierSwarmParityOracleStatus;
2937
+ artifacts?: readonly FrontierSwarmNamedRefInput[];
2938
+ metadata?: unknown;
2939
+ }[];
2940
+ divergence?: FrontierSwarmDivergenceReportInput;
2941
+ generatedAt?: number;
2942
+ metadata?: unknown;
2943
+ }
2944
+ export interface FrontierSwarmReferenceOracleResponse {
2945
+ kind: typeof FRONTIER_SWARM_REFERENCE_ORACLE_RESPONSE_KIND;
2946
+ version: typeof FRONTIER_SWARM_REFERENCE_ORACLE_RESPONSE_VERSION;
2947
+ id: string;
2948
+ planId?: string;
2949
+ status: FrontierSwarmParityOracleStatus;
2950
+ subject?: string;
2951
+ generatedAt: number;
2952
+ targetResults: {
2953
+ targetId: string;
2954
+ status: FrontierSwarmParityOracleStatus;
2955
+ artifacts: FrontierSwarmNamedRef[];
2956
+ metadata?: JsonObject;
2957
+ }[];
2958
+ divergence?: FrontierSwarmDivergenceReport;
2959
+ metadata?: JsonObject;
2960
+ }
2961
+ export interface FrontierSwarmRoutingHintInput {
2962
+ artifactKind?: string;
2963
+ pathPattern?: string;
2964
+ lane?: string;
2965
+ bucket?: FrontierSwarmQueueOverlayStatus;
2966
+ reason?: string;
2967
+ metadata?: unknown;
2968
+ }
2969
+ export interface FrontierSwarmRoutingHint {
2970
+ artifactKind?: string;
2971
+ pathPattern?: string;
2972
+ lane?: string;
2973
+ bucket: FrontierSwarmQueueOverlayStatus;
2974
+ reason: string;
2975
+ metadata?: JsonObject;
2976
+ }
2977
+ export interface FrontierSwarmArtifactRoutingPlanInput {
2978
+ id?: string;
2979
+ bundles?: readonly FrontierSwarmMergeBundle[];
2980
+ artifacts?: readonly FrontierSwarmNamedRefInput[];
2981
+ hints?: readonly FrontierSwarmRoutingHintInput[];
2982
+ generatedAt?: number;
2983
+ metadata?: unknown;
2984
+ }
2985
+ export interface FrontierSwarmArtifactRoutingPlan {
2986
+ kind: typeof FRONTIER_SWARM_ARTIFACT_ROUTING_PLAN_KIND;
2987
+ version: typeof FRONTIER_SWARM_ARTIFACT_ROUTING_PLAN_VERSION;
2988
+ id: string;
2989
+ generatedAt: number;
2990
+ routes: {
2991
+ artifact: FrontierSwarmNamedRef;
2992
+ bucket: FrontierSwarmQueueOverlayStatus;
2993
+ lane?: string;
2994
+ reasons: string[];
2995
+ }[];
2996
+ byBucket: Record<string, string[]>;
2997
+ summary: {
2998
+ routeCount: number;
2999
+ bucketCount: number;
3000
+ };
3001
+ metadata?: JsonObject;
3002
+ }
3003
+ export interface FrontierSwarmSchedulerRecommendationsInput {
3004
+ id?: string;
3005
+ schedule: FrontierSwarmSchedule;
3006
+ mergeIndex?: FrontierSwarmMergeIndex;
3007
+ generatedAt?: number;
3008
+ metadata?: unknown;
3009
+ }
3010
+ export interface FrontierSwarmSchedulerRecommendation {
3011
+ id: string;
3012
+ reason: string;
3013
+ jobIds: string[];
3014
+ resource?: string;
3015
+ lane?: string;
3016
+ action: string;
3017
+ priority: number;
3018
+ }
3019
+ export interface FrontierSwarmSchedulerRecommendations {
3020
+ kind: typeof FRONTIER_SWARM_SCHEDULER_RECOMMENDATIONS_KIND;
3021
+ version: typeof FRONTIER_SWARM_SCHEDULER_RECOMMENDATIONS_VERSION;
3022
+ id: string;
3023
+ scheduleId: string;
3024
+ generatedAt: number;
3025
+ recommendations: FrontierSwarmSchedulerRecommendation[];
3026
+ summary: {
3027
+ recommendationCount: number;
3028
+ };
3029
+ metadata?: JsonObject;
3030
+ }
3031
+ export interface FrontierSwarmFixtureInput {
3032
+ id: string;
3033
+ title?: string;
3034
+ description?: string;
3035
+ state?: unknown;
3036
+ artifacts?: readonly FrontierSwarmNamedRefInput[];
3037
+ setupCommands?: readonly (string | FrontierSwarmCommandInput)[];
3038
+ tags?: readonly string[];
3039
+ metadata?: unknown;
3040
+ }
3041
+ export interface FrontierSwarmFixture {
3042
+ id: string;
3043
+ title: string;
3044
+ description?: string;
3045
+ state?: JsonValue;
3046
+ artifacts: FrontierSwarmNamedRef[];
3047
+ setupCommands: FrontierSwarmCommand[];
3048
+ tags: string[];
3049
+ metadata?: JsonObject;
3050
+ }
3051
+ export interface FrontierSwarmFixtureCatalogInput {
3052
+ id?: string;
3053
+ fixtures?: readonly FrontierSwarmFixtureInput[];
3054
+ generatedAt?: number;
3055
+ metadata?: unknown;
3056
+ }
3057
+ export interface FrontierSwarmFixtureCatalog {
3058
+ kind: typeof FRONTIER_SWARM_FIXTURE_CATALOG_KIND;
3059
+ version: typeof FRONTIER_SWARM_FIXTURE_CATALOG_VERSION;
3060
+ id: string;
3061
+ generatedAt: number;
3062
+ fixtures: FrontierSwarmFixture[];
3063
+ byTag: Record<string, string[]>;
3064
+ summary: {
3065
+ fixtureCount: number;
3066
+ tagCount: number;
3067
+ };
3068
+ metadata?: JsonObject;
3069
+ }
3070
+ export interface FrontierSwarmProgressItemInput {
3071
+ id: string;
3072
+ surface?: string;
3073
+ status?: FrontierSwarmProgressStatus;
3074
+ evidencePaths?: readonly string[];
3075
+ blockers?: readonly string[];
3076
+ metadata?: unknown;
3077
+ }
3078
+ export interface FrontierSwarmProgressItem {
3079
+ id: string;
3080
+ surface?: string;
3081
+ status: FrontierSwarmProgressStatus;
3082
+ evidencePaths: string[];
3083
+ blockers: string[];
3084
+ metadata?: JsonObject;
3085
+ }
3086
+ export interface FrontierSwarmProgressModelInput {
3087
+ id?: string;
3088
+ items?: readonly FrontierSwarmProgressItemInput[];
3089
+ generatedAt?: number;
3090
+ metadata?: unknown;
3091
+ }
3092
+ export interface FrontierSwarmProgressModel {
3093
+ kind: typeof FRONTIER_SWARM_PROGRESS_MODEL_KIND;
3094
+ version: typeof FRONTIER_SWARM_PROGRESS_MODEL_VERSION;
3095
+ id: string;
3096
+ generatedAt: number;
3097
+ items: FrontierSwarmProgressItem[];
3098
+ byStatus: Record<string, string[]>;
3099
+ summary: {
3100
+ itemCount: number;
3101
+ acceptedCount: number;
3102
+ blockedCount: number;
3103
+ };
3104
+ metadata?: JsonObject;
3105
+ }
3106
+ export interface FrontierSwarmAutoReviewFindingInput {
3107
+ id?: string;
3108
+ jobId?: string;
3109
+ kind?: FrontierSwarmAutoReviewFindingKind;
3110
+ severity?: FrontierSwarmDivergenceSeverity;
3111
+ message: string;
3112
+ paths?: readonly string[];
3113
+ evidencePaths?: readonly string[];
3114
+ metadata?: unknown;
3115
+ }
3116
+ export interface FrontierSwarmAutoReviewFinding {
3117
+ id: string;
3118
+ jobId?: string;
3119
+ kind: FrontierSwarmAutoReviewFindingKind;
3120
+ severity: FrontierSwarmDivergenceSeverity;
3121
+ message: string;
3122
+ paths: string[];
3123
+ evidencePaths: string[];
3124
+ metadata?: JsonObject;
3125
+ }
3126
+ export interface FrontierSwarmAutoReviewReportInput {
3127
+ id?: string;
3128
+ bundles?: readonly FrontierSwarmMergeBundle[];
3129
+ findings?: readonly FrontierSwarmAutoReviewFindingInput[];
3130
+ generatedAt?: number;
3131
+ metadata?: unknown;
3132
+ }
3133
+ export interface FrontierSwarmAutoReviewReport {
3134
+ kind: typeof FRONTIER_SWARM_AUTO_REVIEW_REPORT_KIND;
3135
+ version: typeof FRONTIER_SWARM_AUTO_REVIEW_REPORT_VERSION;
3136
+ id: string;
3137
+ generatedAt: number;
3138
+ findings: FrontierSwarmAutoReviewFinding[];
3139
+ byKind: Record<string, FrontierSwarmAutoReviewFinding[]>;
3140
+ summary: {
3141
+ findingCount: number;
3142
+ highSeverityCount: number;
3143
+ };
3144
+ metadata?: JsonObject;
3145
+ }
3146
+ export interface FrontierSwarmRebaseReportInput {
3147
+ id?: string;
3148
+ currentHead?: string;
3149
+ mergeIndex?: FrontierSwarmMergeIndex;
3150
+ bundles?: readonly FrontierSwarmMergeBundle[];
3151
+ entries?: readonly {
3152
+ jobId: string;
3153
+ status?: FrontierSwarmRebaseStatus;
3154
+ reasons?: readonly string[];
3155
+ metadata?: unknown;
3156
+ }[];
3157
+ generatedAt?: number;
3158
+ metadata?: unknown;
3159
+ }
3160
+ export interface FrontierSwarmRebaseReport {
3161
+ kind: typeof FRONTIER_SWARM_REBASE_REPORT_KIND;
3162
+ version: typeof FRONTIER_SWARM_REBASE_REPORT_VERSION;
3163
+ id: string;
3164
+ currentHead?: string;
3165
+ generatedAt: number;
3166
+ entries: {
3167
+ jobId: string;
3168
+ status: FrontierSwarmRebaseStatus;
3169
+ reasons: string[];
3170
+ metadata?: JsonObject;
3171
+ }[];
3172
+ byStatus: Record<string, string[]>;
3173
+ summary: {
3174
+ entryCount: number;
3175
+ cleanCount: number;
3176
+ conflictCount: number;
3177
+ staleCount: number;
3178
+ };
3179
+ metadata?: JsonObject;
3180
+ }
3181
+ export interface FrontierSwarmUsageGovernorInput {
3182
+ id?: string;
3183
+ maxWorkers?: number;
3184
+ maxTokensByLane?: Record<string, number>;
3185
+ maxCostUsd?: number;
3186
+ retryBudget?: number;
3187
+ stopConditions?: readonly string[];
3188
+ preferStaticWhenLowBudget?: boolean;
3189
+ generatedAt?: number;
3190
+ metadata?: unknown;
3191
+ }
3192
+ export interface FrontierSwarmUsageGovernor {
3193
+ kind: typeof FRONTIER_SWARM_USAGE_GOVERNOR_KIND;
3194
+ version: typeof FRONTIER_SWARM_USAGE_GOVERNOR_VERSION;
3195
+ id: string;
3196
+ generatedAt: number;
3197
+ maxWorkers?: number;
3198
+ maxTokensByLane: Record<string, number>;
3199
+ maxCostUsd?: number;
3200
+ retryBudget: number;
3201
+ stopConditions: string[];
3202
+ preferStaticWhenLowBudget: boolean;
3203
+ metadata?: JsonObject;
3204
+ }
3205
+ export interface FrontierSwarmUsageGovernorDecision {
3206
+ ok: boolean;
3207
+ reasons: string[];
3208
+ recommendedMaxWorkers?: number;
3209
+ preferStatic: boolean;
3210
+ }
3211
+ export interface FrontierSwarmLanePlaybookInput {
3212
+ id?: string;
3213
+ lane: string;
3214
+ title?: string;
3215
+ successfulBundles?: readonly FrontierSwarmMergeBundle[];
3216
+ notes?: readonly string[];
3217
+ commands?: readonly (string | FrontierSwarmCommandInput)[];
3218
+ avoidInvestigating?: readonly string[];
3219
+ evidencePatterns?: readonly string[];
3220
+ generatedAt?: number;
3221
+ metadata?: unknown;
3222
+ }
3223
+ export interface FrontierSwarmLanePlaybook {
3224
+ kind: typeof FRONTIER_SWARM_LANE_PLAYBOOK_KIND;
3225
+ version: typeof FRONTIER_SWARM_LANE_PLAYBOOK_VERSION;
3226
+ id: string;
3227
+ lane: string;
3228
+ title: string;
3229
+ generatedAt: number;
3230
+ notes: string[];
3231
+ commands: FrontierSwarmCommand[];
3232
+ avoidInvestigating: string[];
3233
+ evidencePatterns: string[];
3234
+ successfulJobIds: string[];
3235
+ hotPaths: string[];
3236
+ changedRegions: string[];
3237
+ metadata?: JsonObject;
3238
+ }
3239
+ export interface FrontierSwarmPatchStackPlanInput {
3240
+ id?: string;
3241
+ index: FrontierSwarmMergeIndex;
3242
+ maxStackSize?: number;
3243
+ generatedAt?: number;
3244
+ metadata?: unknown;
3245
+ }
3246
+ export interface FrontierSwarmPatchStackPlan {
3247
+ kind: typeof FRONTIER_SWARM_PATCH_STACK_PLAN_KIND;
3248
+ version: typeof FRONTIER_SWARM_PATCH_STACK_PLAN_VERSION;
3249
+ id: string;
3250
+ mergeIndexId: string;
3251
+ generatedAt: number;
3252
+ stacks: FrontierSwarmPatchStack[];
3253
+ summary: {
3254
+ stackCount: number;
3255
+ jobCount: number;
3256
+ conflictedStackCount: number;
3257
+ };
3258
+ metadata?: JsonObject;
3259
+ }
3260
+ export interface FrontierSwarmPatchStack {
3261
+ id: string;
3262
+ title: string;
3263
+ lane?: string;
3264
+ jobIds: string[];
3265
+ changedPaths: string[];
3266
+ changedRegions: string[];
3267
+ riskLevels: string[];
3268
+ dispositions: string[];
3269
+ conflicts: FrontierSwarmMergeConflict[];
3270
+ gateHints: string[];
3271
+ }
3272
+ export type FrontierSwarmMergeQueueScopeKind = 'root' | 'parent' | 'child' | 'lane' | 'semantic-region' | 'path' | 'custom' | string;
3273
+ export type FrontierSwarmMergeQueueAssignmentAction = 'apply-local' | 'queue-local' | 'promote' | 'rerun' | 'reject' | 'record-only' | 'block' | string;
3274
+ export interface FrontierSwarmMergeAdmissionPressure {
3275
+ applyLocalCount: number;
3276
+ applyLocalQueueItemCount: number;
3277
+ queueLocalCount: number;
3278
+ queueLocalQueueItemCount: number;
3279
+ promoteUpwardCount: number;
3280
+ promoteUpwardQueueItemCount: number;
3281
+ rerunCount: number;
3282
+ rerunQueueItemCount: number;
3283
+ rejectedCount: number;
3284
+ rejectedQueueItemCount: number;
3285
+ recordOnlyCount: number;
3286
+ recordOnlyQueueItemCount: number;
3287
+ trueBlockCount: number;
3288
+ trueBlockQueueItemCount: number;
3289
+ }
3290
+ export interface FrontierSwarmMergeQueueScopeInput {
3291
+ id: string;
3292
+ kind?: FrontierSwarmMergeQueueScopeKind;
3293
+ parentId?: string;
3294
+ title?: string;
3295
+ lane?: string;
3296
+ changedPaths?: readonly string[];
3297
+ changedRegions?: readonly string[];
3298
+ leaseKey?: string;
3299
+ metadata?: unknown;
3300
+ }
3301
+ export interface FrontierSwarmMergeQueueScope {
3302
+ id: string;
3303
+ kind: FrontierSwarmMergeQueueScopeKind;
3304
+ parentId?: string;
3305
+ title: string;
3306
+ lane?: string;
3307
+ changedPaths: string[];
3308
+ changedRegions: string[];
3309
+ leaseKey: string;
3310
+ jobIds: string[];
3311
+ metadata?: JsonObject;
3312
+ }
3313
+ export interface FrontierSwarmMergeQueueRetrySlice {
3314
+ id: string;
3315
+ scopeId: string;
3316
+ kind: FrontierSwarmMergeQueueScopeKind;
3317
+ parentScopeIds: string[];
3318
+ leaseKey: string;
3319
+ requiredLeaseScopeIds?: string[];
3320
+ requiredLeaseKeys?: string[];
3321
+ lane?: string;
3322
+ changedPaths: string[];
3323
+ changedRegions: string[];
3324
+ reasons: string[];
3325
+ }
3326
+ export type FrontierSwarmHierarchicalQueueLeaseScopeClass = 'root' | 'parent' | 'child' | 'lane' | 'semantic' | 'path' | 'custom' | string;
3327
+ export type FrontierSwarmHierarchicalQueueLeasePromotionState = 'local' | 'terminal' | 'promoted-to-parent' | 'receiving-promoted' | string;
3328
+ export interface FrontierSwarmHierarchicalQueueLocalLeaderInput {
3329
+ id?: string;
3330
+ coordinatorId?: string;
3331
+ workerId?: string;
3332
+ role?: string;
3333
+ electedAt?: number;
3334
+ leaseId?: string;
3335
+ leaseKey?: string;
3336
+ metadata?: unknown;
3337
+ }
3338
+ export interface FrontierSwarmHierarchicalQueueLocalLeader {
3339
+ id: string;
3340
+ coordinatorId?: string;
3341
+ workerId?: string;
3342
+ role?: string;
3343
+ electedAt?: number;
3344
+ leaseId?: string;
3345
+ leaseKey?: string;
3346
+ metadata?: JsonObject;
3347
+ }
3348
+ export interface FrontierSwarmHierarchicalQueuePromotionState {
3349
+ state: FrontierSwarmHierarchicalQueueLeasePromotionState;
3350
+ parentQueueId?: string;
3351
+ promotionIds: string[];
3352
+ promotedFromQueueIds: string[];
3353
+ promotedToQueueIds: string[];
3354
+ promotedJobIds: string[];
3355
+ promotedQueueItemIds: string[];
3356
+ }
3357
+ export interface FrontierSwarmHierarchicalQueueTerminalDecisionLink {
3358
+ id: string;
3359
+ jobId: string;
3360
+ taskId?: string;
3361
+ queueId: string;
3362
+ queueItemIds: string[];
3363
+ action: FrontierSwarmMergeQueueAssignmentAction;
3364
+ decision: FrontierSwarmCoordinatorAgentDrainDecision;
3365
+ reasons: string[];
3366
+ }
3367
+ export interface FrontierSwarmHierarchicalQueueLeaseRecord {
3368
+ id: string;
3369
+ queueId: string;
3370
+ scopeId: string;
3371
+ scopeKind: FrontierSwarmMergeQueueScopeKind;
3372
+ scopeClass: FrontierSwarmHierarchicalQueueLeaseScopeClass;
3373
+ rootQueueId: string;
3374
+ parentQueueId?: string;
3375
+ lane?: string;
3376
+ title: string;
3377
+ leaseKey: string;
3378
+ localLeader?: FrontierSwarmHierarchicalQueueLocalLeader;
3379
+ promotion: FrontierSwarmHierarchicalQueuePromotionState;
3380
+ conflictReasons: string[];
3381
+ retryReasons: string[];
3382
+ reasons: string[];
3383
+ jobIds: string[];
3384
+ queueItemIds: string[];
3385
+ activeJobIds: string[];
3386
+ activeQueueItemIds: string[];
3387
+ terminalJobIds: string[];
3388
+ terminalQueueItemIds: string[];
3389
+ terminalDecisionIds: string[];
3390
+ terminalDecisionLinks: FrontierSwarmHierarchicalQueueTerminalDecisionLink[];
3391
+ changedPaths: string[];
3392
+ changedRegions: string[];
3393
+ metadata?: JsonObject;
3394
+ }
3395
+ export interface FrontierSwarmHierarchicalQueueScopeTree {
3396
+ rootScopeId: string;
3397
+ scopeIdsByKind: Record<string, string[]>;
3398
+ ancestorScopeIdsByScopeId: Record<string, string[]>;
3399
+ childScopeIdsByScopeId: Record<string, string[]>;
3400
+ leafScopeIds: string[];
3401
+ }
3402
+ export interface FrontierSwarmHierarchicalMergeQueueInput {
3403
+ id?: string;
3404
+ index: FrontierSwarmMergeIndex;
3405
+ admission?: FrontierSwarmMergeAdmission;
3406
+ rootScopeId?: string;
3407
+ scopes?: readonly FrontierSwarmMergeQueueScopeInput[];
3408
+ localLeader?: FrontierSwarmHierarchicalQueueLocalLeaderInput;
3409
+ localLeaders?: Readonly<Record<string, FrontierSwarmHierarchicalQueueLocalLeaderInput | undefined>>;
3410
+ generatedAt?: number;
3411
+ metadata?: unknown;
3412
+ }
3413
+ export interface FrontierSwarmHierarchicalMergeQueue {
3414
+ kind: typeof FRONTIER_SWARM_HIERARCHICAL_MERGE_QUEUE_KIND;
3415
+ version: typeof FRONTIER_SWARM_HIERARCHICAL_MERGE_QUEUE_VERSION;
3416
+ id: string;
3417
+ mergeIndexId: string;
3418
+ admissionId?: string;
3419
+ generatedAt: number;
3420
+ rootScopeId: string;
3421
+ scopeTree: FrontierSwarmHierarchicalQueueScopeTree;
3422
+ scopes: FrontierSwarmMergeQueueScope[];
3423
+ leaseRecords: FrontierSwarmHierarchicalQueueLeaseRecord[];
3424
+ assignments: FrontierSwarmMergeQueueAssignment[];
3425
+ promotions: FrontierSwarmMergeQueuePromotion[];
3426
+ byScope: Record<string, string[]>;
3427
+ byLeaseKey: Record<string, string[]>;
3428
+ byAction: Record<string, string[]>;
3429
+ summary: {
3430
+ scopeCount: number;
3431
+ assignmentCount: number;
3432
+ applyLocalCount: number;
3433
+ queueLocalCount: number;
3434
+ promoteCount: number;
3435
+ rerunCount: number;
3436
+ rejectCount: number;
3437
+ blockCount: number;
3438
+ recordOnlyCount: number;
3439
+ admissionPressure: FrontierSwarmMergeAdmissionPressure;
3440
+ };
3441
+ metadata?: JsonObject;
3442
+ }
3443
+ export interface FrontierSwarmMergeQueueAssignment {
3444
+ jobId: string;
3445
+ taskId?: string;
3446
+ lane?: string;
3447
+ title?: string;
3448
+ queueItemIds: string[];
3449
+ scopeId: string;
3450
+ parentScopeIds: string[];
3451
+ action: FrontierSwarmMergeQueueAssignmentAction;
3452
+ reasons: string[];
3453
+ admitted: boolean;
3454
+ riskLevel: FrontierSwarmRiskLevel;
3455
+ disposition: FrontierSwarmMergeDisposition;
3456
+ mergeReadiness: FrontierSwarmMergeReadiness;
3457
+ changedPaths: string[];
3458
+ changedRegions: string[];
3459
+ conflictingJobIds: string[];
3460
+ leaseKey: string;
3461
+ requiredLeaseScopeIds?: string[];
3462
+ requiredLeaseKeys?: string[];
3463
+ promoteToScopeId?: string;
3464
+ terminalDecisionId?: string;
3465
+ terminalDecisionQueueItemIds?: string[];
3466
+ retrySlices?: FrontierSwarmMergeQueueRetrySlice[];
3467
+ semanticSliceScopeIds?: string[];
3468
+ semanticSliceLeaseKeys?: string[];
3469
+ parentDecisionRegions?: string[];
3470
+ unknownRegions?: string[];
3471
+ metadata?: JsonObject;
3472
+ }
3473
+ export interface FrontierSwarmMergeQueuePromotion {
3474
+ jobId: string;
3475
+ fromScopeId: string;
3476
+ toScopeId: string;
3477
+ reasons: string[];
3478
+ }
3479
+ export type FrontierSwarmCoordinatorAgentDrainDecision = 'applied' | 'queued' | 'escalated' | 'rerun' | 'rejected' | 'recorded' | 'blocked' | string;
3480
+ export type FrontierSwarmCoordinatorAgentDrainClassification = 'terminal' | 'non-terminal' | string;
3481
+ export type FrontierSwarmQueueOutcomeCategory = 'terminal' | 'continuation' | 'coordinator-review' | 'human-blocked' | 'stale-rerun' | 'conflict' | string;
3482
+ export type FrontierSwarmQueueTerminalOutcome = 'applied' | 'committed' | 'checked' | 'superseded' | 'no-change' | 'research-complete' | 'rejected' | 'rerun' | 'conflict-blocked' | 'human-question' | 'recorded' | 'closed' | string;
3483
+ export type FrontierSwarmQueueContinuationOutcome = 'queued' | 'continued' | 'ready' | 'running' | 'leased' | string;
3484
+ export type FrontierSwarmQueueCoordinatorReviewOutcome = 'coordinator-review' | 'escalated' | 'needs-port' | string;
3485
+ export type FrontierSwarmQueueHumanBlockedOutcome = 'human-blocked' | 'human-question' | 'blocked' | string;
3486
+ export type FrontierSwarmQueueStaleRerunOutcome = 'stale-rerun' | 'rerun' | string;
3487
+ export type FrontierSwarmQueueConflictOutcome = 'conflict' | 'merge-conflict' | 'conflict-blocked' | string;
3488
+ export type FrontierSwarmQueueOutcome = FrontierSwarmQueueTerminalOutcome | FrontierSwarmQueueContinuationOutcome | FrontierSwarmQueueCoordinatorReviewOutcome | FrontierSwarmQueueHumanBlockedOutcome | FrontierSwarmQueueStaleRerunOutcome | FrontierSwarmQueueConflictOutcome;
3489
+ export declare const FRONTIER_SWARM_TERMINAL_OUTCOME_LABELS: readonly ["applied", "committed", "checked", "superseded", "evidence-only", "no-change", "research-complete", "generated-by-collector", "patch-missing", "bundle-missing", "rerun", "rejected", "conflict-blocked", "human-question", "human-blocked", "coordinator-review"];
3490
+ export type FrontierSwarmTerminalOutcomeLabel = typeof FRONTIER_SWARM_TERMINAL_OUTCOME_LABELS[number] | string;
3491
+ export type FrontierSwarmTerminalOutcomeCategory = 'success' | 'incomplete' | 'rerun' | 'rejected' | 'blocked' | 'review' | 'unknown' | string;
3492
+ export declare const FRONTIER_SWARM_TERMINAL_OUTCOME_STATUSES: readonly ["applied", "rejected", "superseded", "no-change", "conflict", "human-needed", "research-complete", "rerun"];
3493
+ export declare const FRONTIER_SWARM_TERMINAL_OUTCOME_REASON_CODES: readonly ["accepted-by-admission", "failed-verification", "superseded-by-newer-output", "no-effective-change", "conflict-detected", "human-decision-required", "research-complete", "stale-rerun-required"];
3494
+ export type FrontierSwarmTerminalOutcomeStatus = typeof FRONTIER_SWARM_TERMINAL_OUTCOME_STATUSES[number] | string;
3495
+ export type FrontierSwarmTerminalOutcomeReasonCode = typeof FRONTIER_SWARM_TERMINAL_OUTCOME_REASON_CODES[number] | string;
3496
+ export interface FrontierSwarmTerminalOutcomeInput {
3497
+ label?: FrontierSwarmTerminalOutcomeLabel | string;
3498
+ outcome?: FrontierSwarmTerminalOutcomeLabel | string;
3499
+ status?: string;
3500
+ decision?: string;
3501
+ generatedByCollector?: boolean;
3502
+ evidenceOnly?: boolean;
3503
+ noChange?: boolean;
3504
+ patchMissing?: boolean;
3505
+ bundleMissing?: boolean;
3506
+ conflictBlocked?: boolean;
3507
+ humanQuestion?: boolean;
3508
+ humanBlocked?: boolean;
3509
+ coordinatorReview?: boolean;
3510
+ reasons?: readonly string[];
3511
+ metadata?: unknown;
3512
+ }
3513
+ export interface FrontierSwarmTerminalOutcome {
3514
+ label: FrontierSwarmTerminalOutcomeLabel;
3515
+ category: FrontierSwarmTerminalOutcomeCategory;
3516
+ terminal: true;
3517
+ success: boolean;
3518
+ incomplete: boolean;
3519
+ blocker: boolean;
3520
+ review: boolean;
3521
+ generatedByCollector: boolean;
3522
+ reasons: string[];
3523
+ metadata?: JsonObject;
3524
+ }
3525
+ export interface FrontierSwarmTerminalOutcomeRecordInput {
3526
+ id?: string;
3527
+ subjectId?: string;
3528
+ subjectAliases?: readonly string[];
3529
+ jobId?: string;
3530
+ taskId?: string;
3531
+ queueId?: string;
3532
+ queueItemId?: string;
3533
+ queueItemIds?: readonly string[];
3534
+ lane?: string;
3535
+ source?: string;
3536
+ status?: FrontierSwarmTerminalOutcomeStatus | string;
3537
+ outcome?: FrontierSwarmTerminalOutcomeInput | FrontierSwarmTerminalOutcomeLabel | string;
3538
+ label?: FrontierSwarmTerminalOutcomeLabel | string;
3539
+ decision?: string;
3540
+ admitted?: boolean;
3541
+ reasonCodes?: readonly FrontierSwarmTerminalOutcomeReasonCode[];
3542
+ reasons?: readonly string[];
3543
+ conflictingJobIds?: readonly string[];
3544
+ supersedes?: readonly string[];
3545
+ supersededBy?: string;
3546
+ rerunOf?: string;
3547
+ evidenceRefs?: readonly (string | FrontierSwarmNamedRefInput)[];
3548
+ generatedAt?: number;
3549
+ metadata?: unknown;
3550
+ }
3551
+ export interface FrontierSwarmTerminalOutcomeRecord {
3552
+ kind: typeof FRONTIER_SWARM_TERMINAL_OUTCOME_RECORD_KIND;
3553
+ version: typeof FRONTIER_SWARM_TERMINAL_OUTCOME_RECORD_VERSION;
3554
+ id: string;
3555
+ generatedAt: number;
3556
+ subjectId: string;
3557
+ subjectAliases: string[];
3558
+ jobId?: string;
3559
+ taskId?: string;
3560
+ queueId?: string;
3561
+ queueItemIds: string[];
3562
+ lane?: string;
3563
+ source?: string;
3564
+ status: FrontierSwarmTerminalOutcomeStatus;
3565
+ outcome: FrontierSwarmTerminalOutcome;
3566
+ terminal: true;
3567
+ admitted: boolean;
3568
+ success: boolean;
3569
+ rejected: boolean;
3570
+ conflict: boolean;
3571
+ humanNeeded: boolean;
3572
+ rerun: boolean;
3573
+ noChange: boolean;
3574
+ researchComplete: boolean;
3575
+ reasonCodes: FrontierSwarmTerminalOutcomeReasonCode[];
3576
+ reasons: string[];
3577
+ conflictingJobIds: string[];
3578
+ supersedes: string[];
3579
+ supersededBy?: string;
3580
+ rerunOf?: string;
3581
+ evidenceRefs: FrontierSwarmNamedRef[];
3582
+ metadata?: JsonObject;
3583
+ }
3584
+ export interface FrontierSwarmQueueOutcomeClassification {
3585
+ category: FrontierSwarmQueueOutcomeCategory;
3586
+ outcome: FrontierSwarmQueueOutcome;
3587
+ terminal: boolean;
3588
+ closesSubject: boolean;
3589
+ coordinatorReview: boolean;
3590
+ humanBlocked: boolean;
3591
+ staleOrRerun: boolean;
3592
+ conflict: boolean;
3593
+ reviewDebt: boolean;
3594
+ }
3595
+ export interface FrontierSwarmQueueOutcomeDecisionInput {
3596
+ id?: string;
3597
+ subjectId?: string;
3598
+ subjectAliases?: readonly string[];
3599
+ jobId?: string;
3600
+ taskId?: string;
3601
+ queueItemId?: string;
3602
+ queueItemIds?: readonly string[];
3603
+ queueId?: string;
3604
+ lane?: string;
3605
+ action?: FrontierSwarmMergeQueueAssignmentAction;
3606
+ assignedAction?: FrontierSwarmMergeQueueAssignmentAction;
3607
+ decision?: FrontierSwarmCoordinatorAgentDrainDecision | string;
3608
+ category?: FrontierSwarmQueueOutcomeCategory;
3609
+ outcome?: FrontierSwarmQueueOutcome;
3610
+ terminal?: boolean;
3611
+ reasons?: readonly string[];
3612
+ disposition?: FrontierSwarmMergeDisposition;
3613
+ mergeReadiness?: FrontierSwarmMergeReadiness;
3614
+ status?: string;
3615
+ conflictingJobIds?: readonly string[];
3616
+ generatedAt?: number;
3617
+ metadata?: unknown;
3618
+ }
3619
+ export interface FrontierSwarmQueueOutcomeDecision {
3620
+ id: string;
3621
+ subjectId: string;
3622
+ subjectAliases: string[];
3623
+ jobId?: string;
3624
+ taskId?: string;
3625
+ queueItemIds: string[];
3626
+ queueId?: string;
3627
+ lane?: string;
3628
+ action?: FrontierSwarmMergeQueueAssignmentAction;
3629
+ assignedAction?: FrontierSwarmMergeQueueAssignmentAction;
3630
+ decision?: FrontierSwarmCoordinatorAgentDrainDecision | string;
3631
+ category: FrontierSwarmQueueOutcomeCategory;
3632
+ outcome: FrontierSwarmQueueOutcome;
3633
+ terminal: boolean;
3634
+ closesSubject: boolean;
3635
+ coordinatorReview: boolean;
3636
+ humanBlocked: boolean;
3637
+ staleOrRerun: boolean;
3638
+ conflict: boolean;
3639
+ reviewDebt: boolean;
3640
+ reasons: string[];
3641
+ disposition?: FrontierSwarmMergeDisposition;
3642
+ mergeReadiness?: FrontierSwarmMergeReadiness;
3643
+ status?: string;
3644
+ conflictingJobIds: string[];
3645
+ generatedAt: number;
3646
+ metadata?: JsonObject;
3647
+ }
3648
+ export interface FrontierSwarmQueueOutcomeModelInput {
3649
+ id?: string;
3650
+ decisions?: readonly (FrontierSwarmQueueOutcomeDecisionInput | FrontierSwarmQueueOutcomeDecision)[];
3651
+ queue?: FrontierSwarmHierarchicalMergeQueue;
3652
+ drainWork?: FrontierSwarmCoordinatorAgentDrainWork;
3653
+ generatedAt?: number;
3654
+ metadata?: unknown;
3655
+ }
3656
+ export interface FrontierSwarmQueueOutcomeSubject {
3657
+ subjectId: string;
3658
+ aliases: string[];
3659
+ latestDecision: FrontierSwarmQueueOutcomeDecision;
3660
+ supersededDecisions: FrontierSwarmQueueOutcomeDecision[];
3661
+ }
3662
+ export interface FrontierSwarmQueueOutcomeModel {
3663
+ kind: typeof FRONTIER_SWARM_QUEUE_OUTCOME_MODEL_KIND;
3664
+ version: typeof FRONTIER_SWARM_QUEUE_OUTCOME_MODEL_VERSION;
3665
+ id: string;
3666
+ generatedAt: number;
3667
+ decisions: FrontierSwarmQueueOutcomeDecision[];
3668
+ subjects: FrontierSwarmQueueOutcomeSubject[];
3669
+ latestDecisions: FrontierSwarmQueueOutcomeDecision[];
3670
+ supersededDecisions: FrontierSwarmQueueOutcomeDecision[];
3671
+ visibleReviewDebt: FrontierSwarmQueueOutcomeDecision[];
3672
+ visibleHumanBlockers: FrontierSwarmQueueOutcomeDecision[];
3673
+ visibleReruns: FrontierSwarmQueueOutcomeDecision[];
3674
+ visibleConflicts: FrontierSwarmQueueOutcomeDecision[];
3675
+ bySubjectId: Record<string, string>;
3676
+ subjectIdByAlias: Record<string, string>;
3677
+ latestDecisionIdByAlias: Record<string, string>;
3678
+ byCategory: Record<string, string[]>;
3679
+ byOutcome: Record<string, string[]>;
3680
+ summary: {
3681
+ decisionCount: number;
3682
+ subjectCount: number;
3683
+ latestDecisionCount: number;
3684
+ supersededDecisionCount: number;
3685
+ terminalCount: number;
3686
+ continuationCount: number;
3687
+ coordinatorReviewCount: number;
3688
+ humanBlockedCount: number;
3689
+ staleRerunCount: number;
3690
+ conflictCount: number;
3691
+ visibleReviewDebtCount: number;
3692
+ visibleHumanBlockedCount: number;
3693
+ visibleRerunCount: number;
3694
+ visibleConflictCount: number;
3695
+ };
3696
+ metadata?: JsonObject;
3697
+ }
3698
+ export type FrontierSwarmTerminalStateBucket = 'ready' | 'review' | 'stale' | 'failed' | 'done' | 'terminal' | string;
3699
+ export interface FrontierSwarmTerminalStateItemInput {
3700
+ id?: string;
3701
+ subjectId?: string;
3702
+ subjectAliases?: readonly string[];
3703
+ jobId?: string;
3704
+ taskId?: string;
3705
+ queueItemId?: string;
3706
+ queueItemIds?: readonly string[];
3707
+ bucket?: FrontierSwarmTerminalStateBucket;
3708
+ status?: string;
3709
+ generatedAt?: number;
3710
+ metadata?: unknown;
3711
+ }
3712
+ export interface FrontierSwarmTerminalStateCollectionInput {
3713
+ bucket: FrontierSwarmTerminalStateBucket;
3714
+ items: readonly (string | FrontierSwarmTerminalStateItemInput)[];
3715
+ }
3716
+ export type FrontierSwarmTerminalStateCollectionsInput = Record<string, readonly (string | FrontierSwarmTerminalStateItemInput)[]> | readonly FrontierSwarmTerminalStateCollectionInput[];
3717
+ export interface FrontierSwarmTerminalStateItem {
3718
+ id: string;
3719
+ subjectId: string;
3720
+ subjectAliases: string[];
3721
+ jobId?: string;
3722
+ taskId?: string;
3723
+ queueItemIds: string[];
3724
+ bucket: FrontierSwarmTerminalStateBucket;
3725
+ status?: string;
3726
+ generatedAt: number;
3727
+ metadata?: JsonObject;
3728
+ }
3729
+ export interface FrontierSwarmTerminalStateResolution {
3730
+ id: string;
3731
+ subjectId: string;
3732
+ subjectAliases: string[];
3733
+ jobId?: string;
3734
+ taskId?: string;
3735
+ queueItemIds: string[];
3736
+ bucket: FrontierSwarmTerminalStateBucket;
3737
+ sourceItemIds: string[];
3738
+ sourceBuckets: FrontierSwarmTerminalStateBucket[];
3739
+ decisionId: string;
3740
+ decisionCategory: FrontierSwarmQueueOutcomeCategory;
3741
+ decisionOutcome: FrontierSwarmQueueOutcome;
3742
+ decisionTerminal: boolean;
3743
+ decisionGeneratedAt: number;
3744
+ resolved: boolean;
3745
+ terminal: boolean;
3746
+ failedWorkerOutput: false;
3747
+ reasons: string[];
3748
+ metadata?: JsonObject;
3749
+ }
3750
+ export interface FrontierSwarmTerminalStateReconciliationInput {
3751
+ id?: string;
3752
+ collections?: FrontierSwarmTerminalStateCollectionsInput;
3753
+ decisions?: readonly (FrontierSwarmQueueOutcomeDecisionInput | FrontierSwarmQueueOutcomeDecision)[];
3754
+ outcomeModel?: FrontierSwarmQueueOutcomeModel;
3755
+ generatedAt?: number;
3756
+ doneBucket?: FrontierSwarmTerminalStateBucket;
3757
+ terminalBucket?: FrontierSwarmTerminalStateBucket;
3758
+ metadata?: unknown;
3759
+ }
3760
+ export interface FrontierSwarmTerminalStateReconciliation {
3761
+ kind: typeof FRONTIER_SWARM_TERMINAL_STATE_RECONCILIATION_KIND;
3762
+ version: typeof FRONTIER_SWARM_TERMINAL_STATE_RECONCILIATION_VERSION;
3763
+ id: string;
3764
+ generatedAt: number;
3765
+ outcomeModelId: string;
3766
+ items: FrontierSwarmTerminalStateItem[];
3767
+ active: FrontierSwarmTerminalStateItem[];
3768
+ failedWorkerOutput: FrontierSwarmTerminalStateItem[];
3769
+ resolved: FrontierSwarmTerminalStateResolution[];
3770
+ terminal: FrontierSwarmTerminalStateResolution[];
3771
+ terminalUnresolved: FrontierSwarmTerminalStateResolution[];
3772
+ collapsed: FrontierSwarmTerminalStateResolution[];
3773
+ collections: Record<string, FrontierSwarmTerminalStateItem[]>;
3774
+ byBucket: Record<string, string[]>;
3775
+ latestDecisionIdByAlias: Record<string, string>;
3776
+ summary: {
3777
+ inputItemCount: number;
3778
+ decisionCount: number;
3779
+ latestDecisionCount: number;
3780
+ supersededDecisionCount: number;
3781
+ activeItemCount: number;
3782
+ collapsedItemCount: number;
3783
+ resolvedCount: number;
3784
+ terminalCount: number;
3785
+ terminalUnresolvedCount: number;
3786
+ failedWorkerOutputCount: number;
3787
+ visibleReviewDebtCount: number;
3788
+ visibleHumanBlockedCount: number;
3789
+ visibleRerunCount: number;
3790
+ visibleConflictCount: number;
3791
+ };
3792
+ metadata?: JsonObject;
3793
+ }
3794
+ export interface FrontierSwarmCoordinatorAgentDrainWorkInput {
3795
+ id?: string;
3796
+ queue: FrontierSwarmHierarchicalMergeQueue;
3797
+ coordinatorId?: string;
3798
+ generatedAt?: number;
3799
+ metadata?: unknown;
3800
+ }
3801
+ export interface FrontierSwarmCoordinatorAgentDrainWorkConsumerSummary {
3802
+ leaseCount: number;
3803
+ assignmentCount: number;
3804
+ activeAssignmentCount: number;
3805
+ terminalCount: number;
3806
+ promotedWorkCount: number;
3807
+ blockerCount: number;
3808
+ queueItemCount: number;
3809
+ activeQueueItemCount: number;
3810
+ terminalQueueItemCount: number;
3811
+ promotedQueueItemCount: number;
3812
+ blockerQueueItemCount: number;
3813
+ admissionPressure: FrontierSwarmMergeAdmissionPressure;
3814
+ rootQueueSelectionPressure: FrontierSwarmCoordinatorAgentRootQueueSelectionPressure;
3815
+ }
3816
+ export interface FrontierSwarmCoordinatorAgentRootQueueSelectionPressure {
3817
+ rootQueueId: string;
3818
+ leaseId?: string;
3819
+ leaseScope?: string;
3820
+ promotedWorkCount: number;
3821
+ promotedQueueItemCount: number;
3822
+ promotedJobIds: string[];
3823
+ promotedQueueItemIds: string[];
3824
+ bySourceQueueId: Record<string, string[]>;
3825
+ byReason: Record<string, string[]>;
3826
+ admissionPressure: FrontierSwarmMergeAdmissionPressure;
3827
+ }
3828
+ export interface FrontierSwarmCoordinatorAgentDrainWork {
3829
+ kind: typeof FRONTIER_SWARM_COORDINATOR_AGENT_DRAIN_WORK_KIND;
3830
+ version: typeof FRONTIER_SWARM_COORDINATOR_AGENT_DRAIN_WORK_VERSION;
3831
+ id: string;
3832
+ queueId: string;
3833
+ mergeIndexId: string;
3834
+ admissionId?: string;
3835
+ coordinatorId?: string;
3836
+ generatedAt: number;
3837
+ rootQueueId: string;
3838
+ leases: FrontierSwarmCoordinatorAgentDrainLease[];
3839
+ assignments: FrontierSwarmCoordinatorAgentDrainAssignment[];
3840
+ activeAssignments: FrontierSwarmCoordinatorAgentDrainAssignment[];
3841
+ terminalDecisions: FrontierSwarmCoordinatorAgentDrainTerminalDecision[];
3842
+ promotedWork: FrontierSwarmCoordinatorAgentPromotedWork[];
3843
+ blockers: FrontierSwarmCoordinatorAgentDrainTerminalDecision[];
3844
+ byAction: Record<string, string[]>;
3845
+ byDecision: Record<string, string[]>;
3846
+ byClassification: Record<string, string[]>;
3847
+ byQueueId: Record<string, string[]>;
3848
+ byLeaseScope: Record<string, string[]>;
3849
+ summary: {
3850
+ leaseCount: number;
3851
+ assignmentCount: number;
3852
+ activeAssignmentCount?: number;
3853
+ terminalCount: number;
3854
+ nonTerminalCount: number;
3855
+ promotedWorkCount: number;
3856
+ blockerCount?: number;
3857
+ queueItemCount?: number;
3858
+ activeQueueItemCount?: number;
3859
+ terminalQueueItemCount?: number;
3860
+ promotedQueueItemCount?: number;
3861
+ blockerQueueItemCount?: number;
3862
+ appliedCount: number;
3863
+ queuedCount: number;
3864
+ escalatedCount: number;
3865
+ rerunCount: number;
3866
+ rejectedCount: number;
3867
+ recordedCount: number;
3868
+ blockedCount: number;
3869
+ admissionPressure: FrontierSwarmMergeAdmissionPressure;
3870
+ rootQueueSelectionPressure: FrontierSwarmCoordinatorAgentRootQueueSelectionPressure;
3871
+ };
3872
+ metadata?: JsonObject;
3873
+ }
3874
+ export interface FrontierSwarmCoordinatorAgentDrainLease {
3875
+ id: string;
3876
+ queueId: string;
3877
+ scopeId: string;
3878
+ scopeKind: FrontierSwarmMergeQueueScopeKind;
3879
+ title: string;
3880
+ leaseScope: string;
3881
+ leaseKey: string;
3882
+ parentQueueId?: string;
3883
+ lane?: string;
3884
+ changedPaths: string[];
3885
+ changedRegions: string[];
3886
+ jobIds: string[];
3887
+ actions: Record<string, string[]>;
3888
+ metadata?: JsonObject;
3889
+ }
3890
+ export interface FrontierSwarmCoordinatorAgentDrainAssignment {
3891
+ id: string;
3892
+ jobId: string;
3893
+ taskId?: string;
3894
+ lane?: string;
3895
+ title?: string;
3896
+ queueItemIds: string[];
3897
+ queueId: string;
3898
+ queueKind: FrontierSwarmMergeQueueScopeKind;
3899
+ rootQueueId: string;
3900
+ parentQueueIds: string[];
3901
+ parentQueueId?: string;
3902
+ promoteToQueueId?: string;
3903
+ leaseId: string;
3904
+ leaseScope: string;
3905
+ assignedAction: FrontierSwarmMergeQueueAssignmentAction;
3906
+ decision: FrontierSwarmCoordinatorAgentDrainDecision;
3907
+ classification: FrontierSwarmCoordinatorAgentDrainClassification;
3908
+ terminal: boolean;
3909
+ terminalDecisionId?: string;
3910
+ terminalDecisionQueueItemIds?: string[];
3911
+ reasons: string[];
3912
+ admitted: boolean;
3913
+ riskLevel: FrontierSwarmRiskLevel;
3914
+ disposition: FrontierSwarmMergeDisposition;
3915
+ mergeReadiness: FrontierSwarmMergeReadiness;
3916
+ changedPaths: string[];
3917
+ changedRegions: string[];
3918
+ conflictingJobIds: string[];
3919
+ retrySlices?: FrontierSwarmMergeQueueRetrySlice[];
3920
+ semanticSliceScopeIds?: string[];
3921
+ semanticSliceLeaseKeys?: string[];
3922
+ requiredLeaseScopeIds?: string[];
3923
+ requiredLeaseKeys?: string[];
3924
+ parentDecisionRegions?: string[];
3925
+ unknownRegions?: string[];
3926
+ metadata?: JsonObject;
3927
+ }
3928
+ export interface FrontierSwarmCoordinatorAgentDrainTerminalDecision {
3929
+ id: string;
3930
+ jobId: string;
3931
+ queueItemIds: string[];
3932
+ queueId: string;
3933
+ leaseId: string;
3934
+ leaseScope: string;
3935
+ assignedAction: FrontierSwarmMergeQueueAssignmentAction;
3936
+ decision: FrontierSwarmCoordinatorAgentDrainDecision;
3937
+ classification: 'terminal';
3938
+ terminal: true;
3939
+ reasons: string[];
3940
+ retrySlices?: FrontierSwarmMergeQueueRetrySlice[];
3941
+ semanticSliceScopeIds?: string[];
3942
+ semanticSliceLeaseKeys?: string[];
3943
+ requiredLeaseScopeIds?: string[];
3944
+ requiredLeaseKeys?: string[];
3945
+ parentDecisionRegions?: string[];
3946
+ unknownRegions?: string[];
3947
+ metadata?: JsonObject;
3948
+ }
3949
+ export interface FrontierSwarmCoordinatorAgentPromotedWork {
3950
+ id: string;
3951
+ jobId: string;
3952
+ taskId?: string;
3953
+ lane?: string;
3954
+ queueItemIds: string[];
3955
+ fromQueueId: string;
3956
+ parentQueueId: string;
3957
+ leaseId: string;
3958
+ leaseScope: string;
3959
+ assignedAction: FrontierSwarmMergeQueueAssignmentAction;
3960
+ decision: FrontierSwarmCoordinatorAgentDrainDecision;
3961
+ classification: 'non-terminal';
3962
+ terminal: false;
3963
+ reasons: string[];
3964
+ requiredLeaseScopeIds?: string[];
3965
+ requiredLeaseKeys?: string[];
3966
+ metadata?: JsonObject;
3967
+ }
3968
+ export interface FrontierSwarmContinuousPoolWorkItemInput {
3969
+ id?: string;
3970
+ jobId?: string;
3971
+ taskId?: string;
3972
+ queueItemId?: string;
3973
+ queueItemIds?: readonly string[];
3974
+ lane?: string;
3975
+ bucket?: FrontierSwarmContinuousPoolBucket;
3976
+ source?: string;
3977
+ status?: string;
3978
+ priority?: number;
3979
+ priorityClass?: FrontierSwarmPriorityClass;
3980
+ reasons?: readonly string[];
3981
+ metadata?: unknown;
3982
+ }
3983
+ export interface FrontierSwarmContinuousPoolWorkItem {
3984
+ id: string;
3985
+ jobId?: string;
3986
+ taskId?: string;
3987
+ queueItemIds: string[];
3988
+ lane?: string;
3989
+ bucket: FrontierSwarmContinuousPoolBucket;
3990
+ source: string;
3991
+ status?: string;
3992
+ priority?: number;
3993
+ priorityClass: FrontierSwarmPriorityClass;
3994
+ reasons: string[];
3995
+ metadata?: JsonObject;
3996
+ }
3997
+ export interface FrontierSwarmContinuousPoolStateInput {
3998
+ id?: string;
3999
+ maxWorkers?: number;
4000
+ active?: readonly (string | FrontierSwarmContinuousPoolWorkItemInput)[];
4001
+ queued?: readonly (string | FrontierSwarmContinuousPoolWorkItemInput)[];
4002
+ reviewDrain?: readonly (string | FrontierSwarmContinuousPoolWorkItemInput)[];
4003
+ rerun?: readonly (string | FrontierSwarmContinuousPoolWorkItemInput)[];
4004
+ humanBlocked?: readonly (string | FrontierSwarmContinuousPoolWorkItemInput)[];
4005
+ conflicted?: readonly (string | FrontierSwarmContinuousPoolWorkItemInput)[];
4006
+ conflicts?: readonly (string | FrontierSwarmContinuousPoolWorkItemInput)[];
4007
+ capacityBlocked?: readonly (string | FrontierSwarmContinuousPoolWorkItemInput)[];
4008
+ done?: readonly (string | FrontierSwarmContinuousPoolWorkItemInput)[];
4009
+ activeLeases?: readonly FrontierSwarmLease[];
4010
+ queueSnapshot?: FrontierSwarmQueueSnapshot;
4011
+ schedule?: FrontierSwarmSchedule;
4012
+ drainWork?: FrontierSwarmCoordinatorAgentDrainWork;
4013
+ outcomeModel?: FrontierSwarmQueueOutcomeModel;
4014
+ decisions?: readonly (FrontierSwarmQueueOutcomeDecisionInput | FrontierSwarmQueueOutcomeDecision)[];
4015
+ terminalState?: FrontierSwarmTerminalStateReconciliation;
4016
+ generatedAt?: number;
4017
+ metadata?: unknown;
4018
+ }
4019
+ export interface FrontierSwarmContinuousPoolRefillSlot {
4020
+ id: string;
4021
+ index: number;
4022
+ state: 'fillable' | 'idle' | string;
4023
+ recommendationId?: string;
4024
+ }
4025
+ export interface FrontierSwarmContinuousPoolRefillRecommendation {
4026
+ id: string;
4027
+ slotId: string;
4028
+ action: FrontierSwarmContinuousPoolRefillAction;
4029
+ bucket: FrontierSwarmContinuousPoolBucket;
4030
+ itemIds: string[];
4031
+ jobIds: string[];
4032
+ priority: number;
4033
+ priorityClass: FrontierSwarmPriorityClass;
4034
+ reasons: string[];
4035
+ }
4036
+ export interface FrontierSwarmContinuousPoolState {
4037
+ kind: typeof FRONTIER_SWARM_CONTINUOUS_POOL_STATE_KIND;
4038
+ version: typeof FRONTIER_SWARM_CONTINUOUS_POOL_STATE_VERSION;
4039
+ id: string;
4040
+ generatedAt: number;
4041
+ phase: FrontierSwarmContinuousPoolPhase;
4042
+ maxWorkers?: number;
4043
+ activeLeases: FrontierSwarmLease[];
4044
+ buckets: {
4045
+ active: FrontierSwarmContinuousPoolWorkItem[];
4046
+ queued: FrontierSwarmContinuousPoolWorkItem[];
4047
+ reviewDrain: FrontierSwarmContinuousPoolWorkItem[];
4048
+ rerun: FrontierSwarmContinuousPoolWorkItem[];
4049
+ humanBlocked: FrontierSwarmContinuousPoolWorkItem[];
4050
+ conflicted: FrontierSwarmContinuousPoolWorkItem[];
4051
+ capacityBlocked: FrontierSwarmContinuousPoolWorkItem[];
4052
+ done: FrontierSwarmContinuousPoolWorkItem[];
4053
+ };
4054
+ byBucket: Record<string, string[]>;
4055
+ refillSlots: FrontierSwarmContinuousPoolRefillSlot[];
4056
+ refillRecommendations: FrontierSwarmContinuousPoolRefillRecommendation[];
4057
+ stopCondition?: FrontierSwarmContinuousPoolStopCondition;
4058
+ stopConditions: FrontierSwarmContinuousPoolStopCondition[];
4059
+ stopped: boolean;
4060
+ drained: boolean;
4061
+ summary: {
4062
+ activeCount: number;
4063
+ queuedCount: number;
4064
+ reviewDrainCount: number;
4065
+ rerunCount: number;
4066
+ humanBlockedCount: number;
4067
+ conflictedCount: number;
4068
+ capacityBlockedCount: number;
4069
+ doneCount: number;
4070
+ pendingCount: number;
4071
+ terminalUnresolvedCount: number;
4072
+ refillSlotCount: number;
4073
+ idleRefillSlotCount: number;
4074
+ refillRecommendationCount: number;
4075
+ };
4076
+ metadata?: JsonObject;
4077
+ }
4078
+ export interface FrontierSwarmProof {
4079
+ kind: typeof FRONTIER_SWARM_PROOF_KIND;
4080
+ version: typeof FRONTIER_SWARM_PROOF_VERSION;
4081
+ id: string;
4082
+ manifestId: string;
4083
+ generatedAt: number;
4084
+ hash: string;
4085
+ summary: FrontierSwarmSummary;
4086
+ validation?: FrontierSwarmValidation;
4087
+ metadata?: JsonObject;
4088
+ }
4089
+ export declare function defineSwarmManifest(input?: FrontierSwarmManifestInput): FrontierSwarmManifest;
4090
+ export declare function createSwarmManifest(input?: FrontierSwarmManifestInput): FrontierSwarmManifest;
4091
+ export declare function defineSwarmTasks(input?: readonly FrontierSwarmTaskInput[] | FrontierSwarmTaskSetInput): FrontierSwarmTask[];
4092
+ export declare function compileSwarm(input: FrontierSwarmManifest | FrontierSwarmManifestInput): FrontierSwarmCompiled;
4093
+ export declare function validateSwarmManifest(input: FrontierSwarmManifest | FrontierSwarmManifestInput): FrontierSwarmValidation;
4094
+ export declare function createSwarmPlan(manifestInput: FrontierSwarmManifest | FrontierSwarmManifestInput, taskInput: readonly FrontierSwarmTaskInput[] | FrontierSwarmTaskSetInput | readonly FrontierSwarmTask[], options?: FrontierSwarmPlanInput): FrontierSwarmPlan;
4095
+ export declare function createSwarmTaskSelection(manifestInput: FrontierSwarmManifest | FrontierSwarmManifestInput, taskInput: readonly FrontierSwarmTaskInput[] | FrontierSwarmTaskSetInput | readonly FrontierSwarmTask[], options?: FrontierSwarmTaskSelectionInput): FrontierSwarmTaskSelection;
4096
+ export declare function createSwarmRunGraph(input?: FrontierSwarmRunGraphInput): FrontierSwarmRunGraph;
4097
+ export declare function normalizeSwarmRunGraph(input: FrontierSwarmRunGraphInput | FrontierSwarmRunGraph): FrontierSwarmRunGraph;
4098
+ export declare function createSwarmGraphSnapshot(input: FrontierSwarmGraphSnapshotInput): FrontierSwarmGraphSnapshot;
4099
+ export declare function createSwarmGateRecord(input: FrontierSwarmGateRecordInput): FrontierSwarmGateRecord;
4100
+ export declare function createSwarmEvidenceRecord(input: FrontierSwarmEvidenceRecordInput): FrontierSwarmEvidenceRecord;
4101
+ export declare function createSwarmPatchEvent(input: FrontierSwarmPatchEventInput): FrontierSwarmPatchEvent;
4102
+ export declare function createSwarmReplayRecord(input?: FrontierSwarmReplayRecordInput): FrontierSwarmReplayRecord;
4103
+ export declare function createSwarmImprovementLoop(input?: FrontierSwarmImprovementLoopInput): FrontierSwarmImprovementLoop;
4104
+ export declare function mapSwarmGateEvidenceToGraph(input: {
4105
+ runId?: string;
4106
+ gates?: readonly (FrontierSwarmGateRecordInput | FrontierSwarmGateRecord)[];
4107
+ evidence?: readonly (FrontierSwarmEvidenceRecordInput | FrontierSwarmEvidenceRecord)[];
4108
+ generatedAt?: number;
4109
+ }): FrontierSwarmRunGraph;
4110
+ export declare function createSwarmGateEvidenceGraph(input: Parameters<typeof mapSwarmGateEvidenceToGraph>[0]): FrontierSwarmRunGraph;
4111
+ export declare function classifySwarmMergeCandidateAdmission(input?: {
4112
+ status?: FrontierSwarmMergeCandidateAdmissionStatus;
4113
+ reasonCodes?: readonly FrontierSwarmMergeCandidateReasonCode[];
4114
+ } | readonly FrontierSwarmMergeCandidateReasonCode[]): FrontierSwarmMergeCandidateAdmissionStatus;
4115
+ export declare function createSwarmSemanticChange(input: FrontierSwarmSemanticChangeInput | FrontierSwarmSemanticChange): FrontierSwarmSemanticChange;
4116
+ export declare function createSwarmMergeCandidate(input: FrontierSwarmMergeCandidateInput | FrontierSwarmMergeCandidate): FrontierSwarmMergeCandidate;
4117
+ export declare function mapSwarmMergeCandidatesToGraph(input: FrontierSwarmMergeCandidateGraphInput): FrontierSwarmMergeCandidateGraphProjection;
4118
+ export declare function createSwarmMergeCandidateGraph(input: FrontierSwarmMergeCandidateGraphInput): FrontierSwarmRunGraph;
4119
+ export declare function mapSwarmReplayRecordsToGraph(input: {
4120
+ runId?: string;
4121
+ replayRecords?: readonly (FrontierSwarmReplayRecordInput | FrontierSwarmReplayRecord)[];
4122
+ generatedAt?: number;
4123
+ }): FrontierSwarmRunGraph;
4124
+ export declare function createSwarmReplayRecordGraph(input: Parameters<typeof mapSwarmReplayRecordsToGraph>[0]): FrontierSwarmRunGraph;
4125
+ export declare function mapSwarmImprovementLoopsToGraph(input: {
4126
+ runId?: string;
4127
+ improvementLoops?: readonly (FrontierSwarmImprovementLoopInput | FrontierSwarmImprovementLoop)[];
4128
+ generatedAt?: number;
4129
+ }): FrontierSwarmRunGraph;
4130
+ export declare function createSwarmImprovementLoopGraph(input: Parameters<typeof mapSwarmImprovementLoopsToGraph>[0]): FrontierSwarmRunGraph;
4131
+ export declare function createSwarmRunGraphChunk(input?: FrontierSwarmRunGraphChunkInput): FrontierSwarmRunGraphChunk;
4132
+ export declare function createSwarmRunGraphChain(input: {
4133
+ id?: string;
4134
+ nodes: readonly FrontierSwarmGraphNodeInput[];
4135
+ edgeKind?: FrontierSwarmGraphEdgeKind;
4136
+ metadata?: unknown;
4137
+ }): FrontierSwarmRunGraphChunk;
4138
+ export declare function createSwarmRunGraphFork(input: {
4139
+ id?: string;
4140
+ source: FrontierSwarmGraphNodeInput;
4141
+ branches: readonly FrontierSwarmGraphNodeInput[];
4142
+ metadata?: unknown;
4143
+ }): FrontierSwarmRunGraphChunk;
4144
+ export declare function createSwarmRunGraphJoin(input: {
4145
+ id?: string;
4146
+ branches: readonly FrontierSwarmGraphNodeInput[];
4147
+ join: FrontierSwarmGraphNodeInput;
4148
+ metadata?: unknown;
4149
+ }): FrontierSwarmRunGraphChunk;
4150
+ export declare function createSwarmRunGraphBarrier(input: FrontierSwarmRunGraphBarrierInput): FrontierSwarmRunGraphChunk;
4151
+ export declare function createSwarmRunGraphRaceSelect(input: FrontierSwarmRunGraphRaceSelectInput): FrontierSwarmRunGraphChunk;
4152
+ export declare function createSwarmRunGraphTournament(input: {
4153
+ id?: string;
4154
+ candidates: readonly FrontierSwarmGraphNodeInput[];
4155
+ winner?: string;
4156
+ rejectedCandidates?: readonly string[];
4157
+ metadata?: unknown;
4158
+ }): FrontierSwarmRunGraphChunk;
4159
+ export declare function createSwarmRunGraphRetryLoop(input: {
4160
+ id?: string;
4161
+ action: FrontierSwarmGraphNodeInput;
4162
+ gate: FrontierSwarmGraphNodeInput;
4163
+ retry: FrontierSwarmGraphNodeInput;
4164
+ success?: FrontierSwarmGraphNodeInput;
4165
+ failure?: FrontierSwarmGraphNodeInput;
4166
+ metadata?: unknown;
4167
+ }): FrontierSwarmRunGraphChunk;
4168
+ export declare function createSwarmRunGraphRsiLoop(input: {
4169
+ id?: string;
4170
+ observe: FrontierSwarmGraphNodeInput;
4171
+ improve: FrontierSwarmGraphNodeInput;
4172
+ apply?: FrontierSwarmGraphNodeInput;
4173
+ metadata?: unknown;
4174
+ }): FrontierSwarmRunGraphChunk;
4175
+ export declare function createSwarmRunGraphSynthesisChunk(input?: FrontierSwarmRunGraphSynthesisChunkInput): FrontierSwarmRunGraphChunk;
4176
+ export declare function createSwarmRunGraphVerificationGateChunk(input: FrontierSwarmRunGraphVerificationGateChunkInput): FrontierSwarmRunGraphChunk;
4177
+ export declare function createSwarmRunGraphMergeGateChunk(input: FrontierSwarmRunGraphMergeGateChunkInput): FrontierSwarmRunGraphChunk;
4178
+ export declare const FRONTIER_SWARM_TASK_MODEL_PROFILES: readonly FrontierSwarmTaskModelProfile[];
4179
+ export declare function resolveSwarmTaskModelProfile(task: FrontierSwarmTask, profiles?: readonly FrontierSwarmTaskModelProfile[]): FrontierSwarmTaskModelProfile;
4180
+ export declare function createSwarmModelRoute(input: FrontierSwarmModelRouterInput): FrontierSwarmModelRoute;
4181
+ export declare function createSwarmPanelEvaluation(input?: FrontierSwarmPanelEvaluationInput): FrontierSwarmPanelEvaluation;
4182
+ export declare function createSwarmOptimizationSummary(input?: FrontierSwarmOptimizationSummaryInput): FrontierSwarmOptimizationSummary;
4183
+ export declare function createSwarmRun(input: FrontierSwarmRunInput): FrontierSwarmRun;
4184
+ export declare function createRunEventsFromSwarmPlan(plan: FrontierSwarmPlan, options?: FrontierSwarmRunEventAdapterOptions): FrontierRunEvent[];
4185
+ export declare function createRunEventsFromSwarmLease(lease: FrontierSwarmLease, options?: FrontierSwarmRunEventAdapterOptions & {
4186
+ job?: FrontierSwarmJob;
4187
+ eventType?: 'lease.requested' | 'lease.granted' | 'lease.released';
4188
+ }): FrontierRunEvent[];
4189
+ export declare function createRunEventsFromSwarmResult(resultInput: FrontierSwarmJobResult | FrontierSwarmJobResultInput, options?: FrontierSwarmRunEventAdapterOptions & {
4190
+ job?: FrontierSwarmJob;
4191
+ }): FrontierRunEvent[];
4192
+ export declare function createRunEventsFromMergeBundle(bundle: FrontierSwarmMergeBundle, options?: FrontierSwarmRunEventAdapterOptions): FrontierRunEvent[];
4193
+ export declare function createRunEventsFromCoordinatorDecision(decision: FrontierSwarmQueueOutcomeDecision | FrontierSwarmQueueOutcomeDecisionInput, options?: FrontierSwarmRunEventAdapterOptions): FrontierRunEvent[];
4194
+ export declare function createRunProjectionFromSwarmRunEvents(events: readonly FrontierRunEvent[], options?: FrontierSwarmRunProjectionOptions): FrontierRunProjection;
4195
+ export declare function createRunDashboardFromSwarmRun(input: FrontierSwarmRun | readonly FrontierRunEvent[], options?: FrontierSwarmRunProjectionOptions): FrontierRunDashboardSnapshot;
4196
+ export declare function createRunEventsFromSwarmRun(run: FrontierSwarmRun, options?: FrontierSwarmRunEventAdapterOptions): FrontierRunEvent[];
4197
+ export declare function recordSwarmEvent(runInput: FrontierSwarmRun, eventInput: FrontierSwarmEventInput): FrontierSwarmRun;
4198
+ export declare function createSwarmMailbox(input?: FrontierSwarmMailboxInput): FrontierSwarmMailbox;
4199
+ export declare function createSwarmEventStream(input?: FrontierSwarmEventStreamInput): FrontierSwarmEventStream;
4200
+ export declare function routeSwarmEventToMailboxes(stream: FrontierSwarmEventStream, eventInput: FrontierSwarmEvent | FrontierSwarmEventInput): FrontierSwarmMailbox[];
4201
+ export declare function completeSwarmJob(runInput: FrontierSwarmRun, resultInput: FrontierSwarmJobResultInput): FrontierSwarmRun;
4202
+ export declare function checkSwarmOwnership(job: FrontierSwarmJob, changedPaths: readonly string[]): FrontierSwarmOwnershipReport;
4203
+ export declare function createSwarmSemanticOwnershipStableKey(input: FrontierSwarmSemanticOwnershipStableKeyInput): string;
4204
+ export declare function createSwarmSemanticOwnershipRegionId(input: FrontierSwarmSemanticOwnershipRegionIdInput): string;
4205
+ export declare function resolveSwarmChangedRegions(job: FrontierSwarmJob, changedPaths: readonly string[], semanticImport?: FrontierSwarmSemanticImportSummary): string[];
4206
+ export declare function classifySwarmMergeReadiness(result: FrontierSwarmJobResultInput | FrontierSwarmJobResult): FrontierSwarmMergeReadiness;
4207
+ export declare function classifySwarmMergeDisposition(result: FrontierSwarmJobResultInput | FrontierSwarmJobResult, input?: {
4208
+ staleAgainstHead?: boolean;
4209
+ }): FrontierSwarmMergeDisposition;
4210
+ export declare function createSwarmMergeBundle(input: FrontierSwarmMergeBundleInput): FrontierSwarmMergeBundle;
4211
+ export declare function createSwarmQueueOverlay(input?: FrontierSwarmQueueOverlayInput): FrontierSwarmQueueOverlay;
4212
+ export declare function deriveSwarmQueueStatus(input: FrontierSwarmDerivedQueueStatusInput): FrontierSwarmDerivedQueueStatus;
4213
+ export declare function createSwarmMergeIndex(input: FrontierSwarmMergeIndexInput): FrontierSwarmMergeIndex;
4214
+ export declare function checkSwarmRegionOwnership(job: FrontierSwarmJob, input?: FrontierSwarmRegionOwnershipInput): FrontierSwarmRegionOwnershipReport;
4215
+ export declare function createSwarmHotspotReport(input?: FrontierSwarmHotspotReportInput): FrontierSwarmHotspotReport;
4216
+ export declare function createSwarmReviewerLanePlan(input: FrontierSwarmReviewerLanePlanInput): FrontierSwarmReviewerLanePlan;
4217
+ export declare function createSwarmRunStoreShards(input?: FrontierSwarmRunStoreShardsInput): FrontierSwarmRunStoreShards;
4218
+ export declare function createSwarmMergeAdmission(input: FrontierSwarmMergeAdmissionInput): FrontierSwarmMergeAdmission;
4219
+ export declare function createSwarmContextPack(input?: FrontierSwarmContextPackInput): FrontierSwarmContextPack;
4220
+ export declare function createSwarmOracleCorpus(input?: FrontierSwarmOracleCorpusInput): FrontierSwarmOracleCorpus;
4221
+ export declare function createSwarmObservabilityPoint(input?: FrontierSwarmObservabilityPointInput): FrontierSwarmObservabilityPoint;
4222
+ export declare function createSwarmReplayBundle(input?: FrontierSwarmReplayBundleInput): FrontierSwarmReplayBundle;
4223
+ export declare function createSwarmParityOracle(input?: FrontierSwarmParityOracleInput): FrontierSwarmParityOracle;
4224
+ export declare function createSwarmDivergenceReport(input?: FrontierSwarmDivergenceReportInput): FrontierSwarmDivergenceReport;
4225
+ export declare function createSwarmWatchpointPlan(input?: FrontierSwarmWatchpointPlanInput): FrontierSwarmWatchpointPlan;
4226
+ export declare function createSwarmDebugHandoff(input?: FrontierSwarmDebugHandoffInput): FrontierSwarmDebugHandoff;
4227
+ export declare function createSwarmInstrumentationBudget(input?: FrontierSwarmInstrumentationBudgetInput): FrontierSwarmInstrumentationBudget;
4228
+ export declare function checkSwarmInstrumentationBudget(budgetInput: FrontierSwarmInstrumentationBudget | FrontierSwarmInstrumentationBudgetInput, usageInput?: FrontierSwarmInstrumentationUsageInput): FrontierSwarmInstrumentationBudgetDecision;
4229
+ export declare function classifySwarmBottleneck(input: FrontierSwarmBottleneckSource | FrontierSwarmJobResultInput | FrontierSwarmMergeBundle): FrontierSwarmBottleneckClassification;
4230
+ export declare function createSwarmBottleneckReport(input?: FrontierSwarmBottleneckReportInput): FrontierSwarmBottleneckReport;
4231
+ export declare function createSwarmEvidenceIndex(input?: FrontierSwarmRun | FrontierSwarmEvidenceIndexInput): FrontierSwarmEvidenceIndex;
4232
+ export declare function querySwarmEvidenceIndex(index: FrontierSwarmEvidenceIndex, query?: FrontierSwarmEvidenceIndexQuery): FrontierSwarmEvidenceIndexQueryResult;
4233
+ export declare function createSwarmBlackboard(input?: FrontierSwarmBlackboardInput): FrontierSwarmBlackboard;
4234
+ export declare function querySwarmBlackboard(blackboard: FrontierSwarmBlackboard, query?: FrontierSwarmBlackboardQuery): FrontierSwarmBlackboardQueryResult;
4235
+ export declare function createSwarmReferenceOraclePlan(input?: FrontierSwarmReferenceOraclePlanInput): FrontierSwarmReferenceOraclePlan;
4236
+ export declare function createSwarmReferenceOracleResponse(input?: FrontierSwarmReferenceOracleResponseInput): FrontierSwarmReferenceOracleResponse;
4237
+ export declare function createSwarmArtifactRoutingPlan(input?: FrontierSwarmArtifactRoutingPlanInput): FrontierSwarmArtifactRoutingPlan;
4238
+ export declare function createSwarmFixtureCatalog(input?: FrontierSwarmFixtureCatalogInput): FrontierSwarmFixtureCatalog;
4239
+ export declare function createSwarmProgressModel(input?: FrontierSwarmProgressModelInput): FrontierSwarmProgressModel;
4240
+ export declare function createSwarmAutoReviewReport(input?: FrontierSwarmAutoReviewReportInput): FrontierSwarmAutoReviewReport;
4241
+ export declare function createSwarmRebaseReport(input?: FrontierSwarmRebaseReportInput): FrontierSwarmRebaseReport;
4242
+ export declare function createSwarmUsageGovernor(input?: FrontierSwarmUsageGovernorInput): FrontierSwarmUsageGovernor;
4243
+ export declare function checkSwarmUsageGovernor(governorInput: FrontierSwarmUsageGovernor | FrontierSwarmUsageGovernorInput, usage?: {
4244
+ activeWorkers?: number;
4245
+ costUsd?: number;
4246
+ tokensByLane?: Record<string, number>;
4247
+ retriesUsed?: number;
4248
+ }): FrontierSwarmUsageGovernorDecision;
4249
+ export declare function createSwarmLanePlaybook(input: FrontierSwarmLanePlaybookInput): FrontierSwarmLanePlaybook;
4250
+ export declare function createSwarmPatchStackPlan(input: FrontierSwarmPatchStackPlanInput): FrontierSwarmPatchStackPlan;
4251
+ export declare function createSwarmHierarchicalMergeQueue(input: FrontierSwarmHierarchicalMergeQueueInput): FrontierSwarmHierarchicalMergeQueue;
4252
+ export declare function createSwarmCoordinatorAgentDrainWork(input: FrontierSwarmCoordinatorAgentDrainWorkInput): FrontierSwarmCoordinatorAgentDrainWork;
4253
+ export declare function summarizeSwarmCoordinatorAgentDrainWork(work: Pick<FrontierSwarmCoordinatorAgentDrainWork, 'leases' | 'assignments' | 'terminalDecisions' | 'promotedWork'>): FrontierSwarmCoordinatorAgentDrainWorkConsumerSummary;
4254
+ export declare function createSwarmContinuousPoolState(input?: FrontierSwarmContinuousPoolStateInput): FrontierSwarmContinuousPoolState;
4255
+ export declare function classifySwarmQueueOutcome(input: FrontierSwarmQueueOutcomeDecisionInput): FrontierSwarmQueueOutcomeClassification;
4256
+ export declare function createSwarmQueueOutcomeDecision(input: FrontierSwarmQueueOutcomeDecisionInput | FrontierSwarmQueueOutcomeDecision): FrontierSwarmQueueOutcomeDecision;
4257
+ export declare function createSwarmQueueOutcomeModel(input?: FrontierSwarmQueueOutcomeModelInput): FrontierSwarmQueueOutcomeModel;
4258
+ export declare function collapseSwarmQueueOutcomeDecisions(input: FrontierSwarmQueueOutcomeModelInput | readonly (FrontierSwarmQueueOutcomeDecisionInput | FrontierSwarmQueueOutcomeDecision)[]): FrontierSwarmQueueOutcomeModel;
4259
+ export declare function normalizeSwarmTerminalOutcome(input?: FrontierSwarmTerminalOutcomeInput | FrontierSwarmTerminalOutcomeLabel | string): FrontierSwarmTerminalOutcome;
4260
+ export declare function createSwarmTerminalOutcomeRecord(input?: FrontierSwarmTerminalOutcomeRecordInput): FrontierSwarmTerminalOutcomeRecord;
4261
+ export declare function reconcileSwarmTerminalState(input?: FrontierSwarmTerminalStateReconciliationInput): FrontierSwarmTerminalStateReconciliation;
4262
+ export declare function resolveSwarmCompute(manifestInput: FrontierSwarmManifest | FrontierSwarmManifestInput, taskInput: FrontierSwarmTask | FrontierSwarmTaskInput): FrontierSwarmCompute;
4263
+ export declare function createSwarmProof(input: FrontierSwarmManifest | FrontierSwarmPlan | FrontierSwarmRun, options?: {
4264
+ generatedAt?: number;
4265
+ validation?: FrontierSwarmValidation;
4266
+ metadata?: unknown;
4267
+ }): FrontierSwarmProof;
4268
+ export declare function createSwarmSchedule(input: FrontierSwarmPlan | FrontierSwarmScheduleInput): FrontierSwarmSchedule;
4269
+ export declare function createSwarmSchedulerRecommendations(input: FrontierSwarmSchedulerRecommendationsInput): FrontierSwarmSchedulerRecommendations;
4270
+ export declare function createSwarmLeases(input: FrontierSwarmLeaseInput): FrontierSwarmLease[];
4271
+ export declare function renewSwarmLease(input: FrontierSwarmLeaseRenewalInput): FrontierSwarmLease;
4272
+ export declare function createSwarmQueueSnapshot(input: FrontierSwarmQueueSnapshotInput): FrontierSwarmQueueSnapshot;
4273
+ export declare function createSwarmRunCheckpoint(input: FrontierSwarmRun | FrontierSwarmRunCheckpointInput): FrontierSwarmRunCheckpoint;
4274
+ export declare function checkSwarmBudget(job: FrontierSwarmJob, usageInput: FrontierSwarmUsageInput): FrontierSwarmBudgetDecision;
4275
+ export declare function createSwarmArtifactIndex(input: FrontierSwarmRun | {
4276
+ run?: FrontierSwarmRun;
4277
+ artifacts?: readonly FrontierSwarmArtifactInput[];
4278
+ generatedAt?: number;
4279
+ }): FrontierSwarmArtifactIndex;
4280
+ export declare function createSwarmReviewPlan(input: FrontierSwarmReviewPlanInput): FrontierSwarmReviewPlan;
4281
+ export declare function createSwarmMergePlan(input: FrontierSwarmMergePlanInput): FrontierSwarmMergePlan;
4282
+ export declare function decomposeSwarmFeature(input: FrontierSwarmDecomposeInput): FrontierSwarmTaskInput[];
4283
+ export declare function encodeSwarmJsonl(records: readonly unknown[]): string;
4284
+ export declare function decodeSwarmJsonl(jsonl: string): JsonValue[];
4285
+ export declare function matchesGlob(file: string, glob: string): boolean;
4286
+ export declare function mergeSwarmMetadata(metadataInputs?: readonly unknown[], verificationGates?: readonly (string | FrontierSwarmCommandInput)[]): JsonObject | undefined;
4287
+ export type FrontierSwarmBacklogStatus = 'open' | 'ready' | 'running' | 'blocked' | 'completed' | 'verified' | string;
4288
+ export type FrontierSwarmBacklogEntryKind = 'task' | 'bug' | 'feature' | 'chore' | 'research' | 'spike' | 'decision' | string;
4289
+ export type FrontierSwarmCycleType = 'milestone' | 'iteration' | 'wave' | string;
4290
+ export interface FrontierSwarmBacklogEntryInput {
4291
+ id: string;
4292
+ title?: string;
4293
+ objective?: string;
4294
+ entryKind?: FrontierSwarmBacklogEntryKind;
4295
+ status?: FrontierSwarmBacklogStatus;
4296
+ lane?: string;
4297
+ layer?: string;
4298
+ workKind?: string;
4299
+ epicId?: string;
4300
+ groupId?: string;
4301
+ cycleId?: string;
4302
+ parentEntryId?: string;
4303
+ childEntryIds?: readonly string[];
4304
+ taskId?: string;
4305
+ dependsOn?: readonly string[];
4306
+ blockedBy?: readonly string[];
4307
+ sourceRefs?: readonly string[];
4308
+ targetRefs?: readonly string[];
4309
+ allowedWrites?: readonly string[];
4310
+ acceptance?: readonly string[];
4311
+ tags?: readonly string[];
4312
+ priority?: number;
4313
+ metadata?: unknown;
4314
+ }
4315
+ export interface FrontierSwarmBacklogEntry extends FrontierSwarmBacklogEntryInput {
4316
+ title: string;
4317
+ entryKind: FrontierSwarmBacklogEntryKind;
4318
+ status: FrontierSwarmBacklogStatus;
4319
+ childEntryIds: string[];
4320
+ dependsOn: string[];
4321
+ blockedBy: string[];
4322
+ sourceRefs: string[];
4323
+ targetRefs: string[];
4324
+ allowedWrites: string[];
4325
+ acceptance: string[];
4326
+ tags: string[];
4327
+ priority: number;
4328
+ metadata?: JsonObject;
4329
+ }
4330
+ export interface FrontierSwarmBacklogInput {
4331
+ id?: string;
4332
+ title?: string;
4333
+ package?: string;
4334
+ epics?: readonly Record<string, unknown>[];
4335
+ taskGroups?: readonly Record<string, unknown>[];
4336
+ cycles?: readonly Record<string, unknown>[];
4337
+ entries?: readonly FrontierSwarmBacklogEntryInput[];
4338
+ tasks?: readonly (FrontierSwarmTaskInput | FrontierSwarmTask)[];
4339
+ generatedAt?: number;
4340
+ metadata?: unknown;
4341
+ }
4342
+ export interface FrontierSwarmBacklog {
4343
+ kind: 'frontier.swarm.backlog';
4344
+ version: 1;
4345
+ id: string;
4346
+ title: string;
4347
+ package?: string;
4348
+ generatedAt: number;
4349
+ epics: Record<string, unknown>[];
4350
+ taskGroups: Record<string, unknown>[];
4351
+ cycles: Record<string, unknown>[];
4352
+ entries: FrontierSwarmBacklogEntry[];
4353
+ tasks: FrontierSwarmTask[];
4354
+ summary: {
4355
+ epicCount: number;
4356
+ groupCount: number;
4357
+ cycleCount: number;
4358
+ entryCount: number;
4359
+ taskCount: number;
4360
+ readyCount: number;
4361
+ runningCount: number;
4362
+ blockedCount: number;
4363
+ completedCount: number;
4364
+ };
4365
+ metadata?: JsonObject;
4366
+ }
4367
+ export interface FrontierSwarmBacklogTaskPlanInput {
4368
+ backlog: FrontierSwarmBacklog | FrontierSwarmBacklogInput;
4369
+ tasks?: readonly (FrontierSwarmTaskInput | FrontierSwarmTask)[];
4370
+ backlogPath?: string;
4371
+ recursive?: boolean;
4372
+ maxDepth?: number;
4373
+ childArtifactPath?: string;
4374
+ decomposeLane?: string;
4375
+ decomposeCompute?: string;
4376
+ decomposeWorkKind?: string;
4377
+ metadata?: unknown;
4378
+ }
4379
+ export interface FrontierSwarmBacklogDecompositionMetadata {
4380
+ sourceId: string;
4381
+ sourceKind: string;
4382
+ remainingDepth: number;
4383
+ childArtifactPath?: string;
4384
+ }
4385
+ export interface FrontierSwarmBacklogContinuationTaskPlanMetadata extends FrontierSwarmBacklogDecompositionMetadata {
4386
+ parentTaskId?: string;
4387
+ }
4388
+ export type FrontierSwarmBacklogTaskPlanMetadata = JsonObject & {
4389
+ sourceId?: string;
4390
+ sourceKind?: string;
4391
+ remainingDepth?: number;
4392
+ childArtifactPath?: string;
4393
+ parentTaskId?: string;
4394
+ source?: {
4395
+ kind?: string;
4396
+ id?: string;
4397
+ taskId?: string;
4398
+ };
4399
+ continuation?: {
4400
+ remainingDepth?: number;
4401
+ childArtifactPath?: string;
4402
+ };
4403
+ };
4404
+ export interface FrontierSwarmBacklogTaskPlan {
4405
+ kind: 'frontier.swarm.backlog-task-plan';
4406
+ version: 1;
4407
+ id: string;
4408
+ backlogId: string;
4409
+ generatedAt: number;
4410
+ backlogPath?: string;
4411
+ childArtifactPath?: string;
4412
+ tasks: FrontierSwarmTask[];
4413
+ runnableTaskIds: string[];
4414
+ decompositionTaskIds: string[];
4415
+ summary: {
4416
+ taskCount: number;
4417
+ runnableCount: number;
4418
+ decompositionCount: number;
4419
+ };
4420
+ metadata?: FrontierSwarmBacklogTaskPlanMetadata;
4421
+ }
4422
+ export declare function createSwarmBacklog(input?: FrontierSwarmBacklogInput): FrontierSwarmBacklog;
4423
+ export declare function querySwarmBacklog(backlogInput: FrontierSwarmBacklog | FrontierSwarmBacklogInput, query?: Partial<FrontierSwarmBacklogEntryInput>): FrontierSwarmBacklog;
4424
+ export declare function mergeSwarmBacklogs(input: {
4425
+ base: FrontierSwarmBacklog | FrontierSwarmBacklogInput;
4426
+ backlogs?: readonly (FrontierSwarmBacklog | FrontierSwarmBacklogInput)[];
4427
+ entries?: readonly FrontierSwarmBacklogEntryInput[];
4428
+ tasks?: readonly FrontierSwarmTaskInput[];
4429
+ generatedAt?: number;
4430
+ metadata?: unknown;
4431
+ }): FrontierSwarmBacklog;
4432
+ export declare function createSwarmBacklogTaskPlan(input: FrontierSwarmBacklogTaskPlanInput): FrontierSwarmBacklogTaskPlan;
4433
+ export type FrontierSwarmModelRoutingMode = 'fill' | 'observe' | 'override' | string;
4434
+ export type FrontierSwarmModelRoutingScope = 'global' | 'repository' | 'package' | 'lane' | 'task' | string;
4435
+ export type FrontierSwarmEvidenceQualityBand = 'missing' | 'weak' | 'adequate' | 'strong' | string;
4436
+ export interface FrontierSwarmModelRoutingEvidenceQuality {
4437
+ band: FrontierSwarmEvidenceQualityBand | string;
4438
+ score?: number;
4439
+ confidence?: FrontierSwarmConfidence | string;
4440
+ evidencePaths?: readonly string[];
4441
+ verifierKinds?: readonly string[];
4442
+ missingEvidence?: readonly string[];
4443
+ deterministic?: boolean;
4444
+ humanReviewed?: boolean;
4445
+ metadata?: JsonObject;
4446
+ }
4447
+ export interface FrontierSwarmModelRoutingFeedbackInput {
4448
+ id?: string;
4449
+ scope?: FrontierSwarmModelRoutingScope;
4450
+ policyId?: string;
4451
+ repository?: string;
4452
+ package?: string;
4453
+ runId?: string;
4454
+ planId?: string;
4455
+ jobId?: string;
4456
+ taskId?: string;
4457
+ taskKind?: string;
4458
+ lane?: string;
4459
+ layer?: string;
4460
+ workKind?: string;
4461
+ computeId?: string;
4462
+ computeKind?: string;
4463
+ model?: string;
4464
+ modelTier?: string;
4465
+ reasoningEffort?: string;
4466
+ serviceTier?: string;
4467
+ resultStatus?: string;
4468
+ mergeReadiness?: FrontierSwarmMergeReadiness | string;
4469
+ mergeDisposition?: FrontierSwarmMergeDisposition;
4470
+ riskLevel?: FrontierSwarmRiskLevel | string;
4471
+ evidenceQuality?: FrontierSwarmModelRoutingEvidenceQuality;
4472
+ selected?: boolean;
4473
+ tags?: readonly string[];
4474
+ generatedAt?: number;
4475
+ metadata?: unknown;
4476
+ [key: string]: unknown;
4477
+ }
4478
+ export interface FrontierSwarmModelRoutingFeedback extends FrontierSwarmModelRoutingFeedbackInput {
4479
+ kind: 'frontier.swarm.model-routing-feedback';
4480
+ version: 1;
4481
+ id: string;
4482
+ scope: FrontierSwarmModelRoutingScope;
4483
+ lane: string;
4484
+ model: string;
4485
+ taskKind: string;
4486
+ tags: string[];
4487
+ generatedAt: number;
4488
+ metadata?: JsonObject;
4489
+ }
4490
+ export interface FrontierSwarmModelRoutingPolicySignalInput {
4491
+ mode?: FrontierSwarmModelRoutingMode;
4492
+ lane?: string;
4493
+ layer?: string;
4494
+ workKind?: string;
4495
+ taskKind?: string;
4496
+ computeId?: string;
4497
+ model?: string;
4498
+ modelTier?: string;
4499
+ confidence?: FrontierSwarmConfidence;
4500
+ reason?: string;
4501
+ metadata?: unknown;
4502
+ }
4503
+ export interface FrontierSwarmModelRoutingPolicySignal extends FrontierSwarmModelRoutingPolicySignalInput {
4504
+ id: string;
4505
+ }
4506
+ export interface FrontierSwarmModelRoutingPolicyInput {
4507
+ id?: string;
4508
+ defaultMode?: FrontierSwarmModelRoutingMode;
4509
+ signals?: readonly FrontierSwarmModelRoutingPolicySignalInput[];
4510
+ feedback?: readonly FrontierSwarmModelRoutingFeedbackInput[];
4511
+ generatedAt?: number;
4512
+ metadata?: unknown;
4513
+ }
4514
+ export interface FrontierSwarmModelRoutingPolicy {
4515
+ kind: 'frontier.swarm.model-routing-policy';
4516
+ version: 1;
4517
+ id: string;
4518
+ defaultMode: FrontierSwarmModelRoutingMode;
4519
+ signals: FrontierSwarmModelRoutingPolicySignal[];
4520
+ feedback: FrontierSwarmModelRoutingFeedback[];
4521
+ preferences: FrontierSwarmModelRoutingPolicySignal[];
4522
+ generatedAt: number;
4523
+ summary: {
4524
+ signalCount: number;
4525
+ feedbackCount: number;
4526
+ selectedCount: number;
4527
+ preferenceCount: number;
4528
+ preferCount: number;
4529
+ avoidCount: number;
4530
+ };
4531
+ metadata?: JsonObject;
4532
+ }
4533
+ export declare function createSwarmModelRoutingFeedback(input?: FrontierSwarmModelRoutingFeedbackInput): FrontierSwarmModelRoutingFeedback;
4534
+ export declare function createSwarmModelRoutingPolicy(input?: FrontierSwarmModelRoutingPolicyInput): FrontierSwarmModelRoutingPolicy;
4535
+ export declare function createSwarmModelRoutingFeedbackFromBoard(input?: {
4536
+ board?: unknown;
4537
+ generatedAt?: number;
4538
+ metadata?: unknown;
4539
+ }): FrontierSwarmModelRoutingFeedback;
4540
+ export declare function createSwarmModelRoutingFeedbackFromPanel(input?: {
4541
+ panel?: unknown;
4542
+ generatedAt?: number;
4543
+ metadata?: unknown;
4544
+ }): FrontierSwarmModelRoutingFeedback;
4545
+ export interface FrontierSwarmAdaptiveObservationInput {
4546
+ kind?: string;
4547
+ severity?: 'info' | 'warning' | 'error' | string;
4548
+ at?: number;
4549
+ jobId?: string;
4550
+ lane?: string;
4551
+ score?: number;
4552
+ value?: number;
4553
+ reason?: string;
4554
+ reasons?: readonly string[];
4555
+ metadata?: unknown;
4556
+ }
4557
+ export interface FrontierSwarmTournamentAdaptiveRecommendation {
4558
+ id?: string;
4559
+ action?: 'increase' | 'decrease' | 'hold' | 'observe' | string;
4560
+ target?: string;
4561
+ key?: string;
4562
+ model?: string;
4563
+ computeId?: string;
4564
+ score?: number;
4565
+ reason?: string;
4566
+ metadata?: JsonObject;
4567
+ }
4568
+ export interface FrontierSwarmTournamentAdaptiveFeedback {
4569
+ kind: 'frontier.swarm.tournament-adaptive-feedback';
4570
+ version: 1;
4571
+ id: string;
4572
+ tournamentId?: string;
4573
+ historyId?: string;
4574
+ observations: FrontierSwarmAdaptiveObservationInput[];
4575
+ recommendations: FrontierSwarmTournamentAdaptiveRecommendation[];
4576
+ summary: {
4577
+ observationCount: number;
4578
+ recommendationCount: number;
4579
+ reduceSignals: number;
4580
+ increaseSignals: number;
4581
+ holdSignals: number;
4582
+ };
4583
+ generatedAt: number;
4584
+ metadata?: JsonObject;
4585
+ }
4586
+ export interface FrontierSwarmStrategyTournamentStanding {
4587
+ id: string;
4588
+ strategyId: string;
4589
+ score: number;
4590
+ rank: number;
4591
+ samples: number;
4592
+ outcomeCounts: Record<string, number>;
4593
+ metadata?: JsonObject;
4594
+ }
4595
+ export interface FrontierSwarmStrategyTournamentMatch {
4596
+ id: string;
4597
+ strategyId: string;
4598
+ gameId: string;
4599
+ outcome: string;
4600
+ score: number;
4601
+ tags: string[];
4602
+ metadata?: JsonObject;
4603
+ }
4604
+ export interface FrontierSwarmStrategyTournamentSummary {
4605
+ strategyCount: number;
4606
+ gameCount: number;
4607
+ matchCount: number;
4608
+ verifiedCount: number;
4609
+ rejectedCount: number;
4610
+ undefinedCount: number;
4611
+ sampleConfidence: FrontierSwarmConfidence;
4612
+ decisionGrade: string;
4613
+ topStrategyId?: string;
4614
+ topScore?: number;
4615
+ outcomeCounts: Record<string, number>;
4616
+ }
4617
+ export interface FrontierSwarmStrategyTournament {
4618
+ kind: 'frontier.swarm.strategy-tournament';
4619
+ version: 1;
4620
+ id: string;
4621
+ title?: string;
4622
+ candidates: Record<string, unknown>[];
4623
+ standings: FrontierSwarmStrategyTournamentStanding[];
4624
+ matches: FrontierSwarmStrategyTournamentMatch[];
4625
+ summary: FrontierSwarmStrategyTournamentSummary;
4626
+ winnerId?: string;
4627
+ generatedAt: number;
4628
+ metadata?: JsonObject;
4629
+ }
4630
+ export interface FrontierSwarmStrategyTournamentHistory {
4631
+ kind: 'frontier.swarm.strategy-tournament-history';
4632
+ version: 1;
4633
+ id: string;
4634
+ tournaments: FrontierSwarmStrategyTournament[];
4635
+ generatedAt: number;
4636
+ metadata?: JsonObject;
4637
+ }
4638
+ export interface FrontierSwarmStrategyTournamentComparison {
4639
+ winnerId?: string;
4640
+ tournamentCount: number;
4641
+ candidateCount: number;
4642
+ baselineId?: string;
4643
+ currentId?: string;
4644
+ scoreDelta?: number;
4645
+ regression?: boolean;
4646
+ metadata?: JsonObject;
4647
+ }
4648
+ export declare function createSwarmTournamentAdaptiveFeedback(input?: {
4649
+ tournament?: FrontierSwarmStrategyTournament;
4650
+ history?: FrontierSwarmStrategyTournamentHistory;
4651
+ comparison?: FrontierSwarmStrategyTournamentComparison;
4652
+ observations?: readonly FrontierSwarmAdaptiveObservationInput[];
4653
+ recommendations?: readonly Partial<FrontierSwarmTournamentAdaptiveRecommendation>[];
4654
+ scoreFloor?: number;
4655
+ regressionThreshold?: number;
4656
+ generatedAt?: number;
4657
+ metadata?: unknown;
4658
+ }): FrontierSwarmTournamentAdaptiveFeedback;
4659
+ export declare function createSwarmMergeTournament(input?: {
4660
+ id?: string;
4661
+ title?: string;
4662
+ candidates?: readonly Record<string, unknown>[];
4663
+ bundles?: readonly FrontierSwarmMergeBundle[];
4664
+ mergeIndex?: FrontierSwarmMergeIndex;
4665
+ strategyMode?: string;
4666
+ winnerId?: string;
4667
+ generatedAt?: number;
4668
+ metadata?: unknown;
4669
+ }): FrontierSwarmStrategyTournament;
4670
+ export declare function createSwarmStrategyTournamentHistory(input?: {
4671
+ id?: string;
4672
+ tournaments?: readonly FrontierSwarmStrategyTournament[];
4673
+ generatedAt?: number;
4674
+ metadata?: unknown;
4675
+ }): FrontierSwarmStrategyTournamentHistory;
4676
+ export declare function querySwarmStrategyTournament(tournament: FrontierSwarmStrategyTournament, query?: {
4677
+ strategyId?: string;
4678
+ gameId?: string;
4679
+ outcome?: string;
4680
+ tag?: string;
4681
+ payoffTag?: string;
4682
+ strategyTag?: string;
4683
+ gameTag?: string;
4684
+ minScore?: number;
4685
+ maxScore?: number;
4686
+ }): FrontierSwarmStrategyTournament;
4687
+ export declare function compareSwarmStrategyTournaments(input: FrontierSwarmStrategyTournamentHistory | readonly FrontierSwarmStrategyTournament[] | {
4688
+ baseline: FrontierSwarmStrategyTournament;
4689
+ current: FrontierSwarmStrategyTournament;
4690
+ scoreThreshold?: number;
4691
+ }): FrontierSwarmStrategyTournamentComparison;
4692
+ export interface FrontierSwarmAdaptiveLoadDecision {
4693
+ action: 'increase' | 'decrease' | 'hold' | string;
4694
+ target: string;
4695
+ key?: string;
4696
+ previous?: number;
4697
+ next?: number;
4698
+ reason: string;
4699
+ metadata?: JsonObject;
4700
+ }
4701
+ export interface FrontierSwarmAdaptiveLoadPlan {
4702
+ kind: 'frontier.swarm.adaptive-load-plan';
4703
+ version: 1;
4704
+ id: string;
4705
+ planId?: string;
4706
+ mode: string;
4707
+ observations: FrontierSwarmAdaptiveObservationInput[];
4708
+ decisions: FrontierSwarmAdaptiveLoadDecision[];
4709
+ generatedAt: number;
4710
+ limits: FrontierSwarmScheduleLimits;
4711
+ effectiveLimits: FrontierSwarmScheduleLimits;
4712
+ summary: {
4713
+ observationCount: number;
4714
+ decisionCount: number;
4715
+ bottleneckCount: number;
4716
+ };
4717
+ metadata?: JsonObject;
4718
+ }
4719
+ export declare function createSwarmAdaptiveLoadPlan(input?: {
4720
+ plan?: FrontierSwarmPlan;
4721
+ run?: FrontierSwarmRun;
4722
+ mode?: string;
4723
+ observations?: readonly FrontierSwarmAdaptiveObservationInput[];
4724
+ currentLimits?: Partial<FrontierSwarmScheduleLimits>;
4725
+ minLimits?: Partial<FrontierSwarmScheduleLimits>;
4726
+ maxLimits?: Partial<FrontierSwarmScheduleLimits>;
4727
+ generatedAt?: number;
4728
+ metadata?: unknown;
4729
+ }): FrontierSwarmAdaptiveLoadPlan;
4730
+ export declare function createSwarmScheduleInputFromAdaptiveLoadPlan(plan: FrontierSwarmPlan, adaptivePlan: FrontierSwarmAdaptiveLoadPlan, extra?: Omit<FrontierSwarmScheduleInput, 'plan'>): FrontierSwarmScheduleInput;
4731
+ export interface FrontierSwarmCoordinatorProcessInput {
4732
+ id?: string;
4733
+ role?: string;
4734
+ lane?: string;
4735
+ status?: string;
4736
+ metadata?: unknown;
4737
+ }
4738
+ export interface FrontierSwarmCoordinatorDashboardJob {
4739
+ jobId: string;
4740
+ taskId?: string;
4741
+ lane?: string;
4742
+ status: FrontierSwarmJobStatus | string;
4743
+ liveness: 'running' | 'finished' | 'unknown' | string;
4744
+ disposition: FrontierSwarmMergeDisposition | string;
4745
+ mergeReadiness?: FrontierSwarmMergeReadiness | string;
4746
+ mergeScore: number;
4747
+ changedPaths: string[];
4748
+ changedRegions: string[];
4749
+ ownershipViolations: string[];
4750
+ tests: {
4751
+ passed: number;
4752
+ failed: number;
4753
+ requiredFailed: number;
4754
+ };
4755
+ semanticImport?: FrontierSwarmSemanticImportSummary;
4756
+ traceShards?: JsonValue[];
4757
+ staleAgainstHead: boolean;
4758
+ duplicateGroupId?: string;
4759
+ evidencePaths: string[];
4760
+ contextBudget?: unknown;
4761
+ metadata?: JsonObject;
4762
+ }
4763
+ export interface FrontierSwarmCoordinatorDashboardSummary {
4764
+ processCount: number;
4765
+ activeCount: number;
4766
+ jobCount: number;
4767
+ staleAgainstHeadCount: number;
4768
+ readyToApplyCount: number;
4769
+ needsHumanPortCount: number;
4770
+ failedEvidenceCount: number;
4771
+ averageMergeScore: number;
4772
+ [key: string]: unknown;
4773
+ }
4774
+ export interface FrontierSwarmCoordinatorDashboard {
4775
+ kind: 'frontier.swarm.coordinator-dashboard';
4776
+ version: 1;
4777
+ id: string;
4778
+ generatedAt: number;
4779
+ processes: FrontierSwarmCoordinatorProcessInput[];
4780
+ jobs: FrontierSwarmCoordinatorDashboardJob[];
4781
+ duplicateGroups: Array<{
4782
+ id: string;
4783
+ jobIds: string[];
4784
+ }>;
4785
+ evidenceIndex?: FrontierSwarmEvidenceIndex;
4786
+ summary: FrontierSwarmCoordinatorDashboardSummary;
4787
+ metadata?: JsonObject;
4788
+ }
4789
+ export declare function createSwarmCoordinatorDashboard(input?: {
4790
+ plan?: FrontierSwarmPlan;
4791
+ run?: FrontierSwarmRun;
4792
+ bundles?: readonly FrontierSwarmMergeBundle[];
4793
+ mergeIndex?: FrontierSwarmMergeIndex;
4794
+ queueOverlay?: FrontierSwarmQueueOverlay;
4795
+ evidenceIndex?: FrontierSwarmEvidenceIndex;
4796
+ admission?: FrontierSwarmMergeAdmission;
4797
+ processes?: readonly FrontierSwarmCoordinatorProcessInput[];
4798
+ generatedAt?: number;
4799
+ metadata?: unknown;
4800
+ }): FrontierSwarmCoordinatorDashboard;
4801
+ export declare function querySwarmCoordinatorDashboard(dashboard: FrontierSwarmCoordinatorDashboard): FrontierSwarmCoordinatorDashboard;
42
4802
  //# sourceMappingURL=index.d.ts.map